feat(gateway): implement core functionality and command structure for DeployStack Gateway

Lasim · Lasim · commit 4fd03f273f4e · 2025-07-26T15:35:02.000+02:00
diff --git a/package-lock.json b/package-lock.json
diff --git a/services/gateway/README.md b/services/gateway/README.md
@@ -22,13 +22,13 @@ npm install -g @deploystack/gateway
 
 ```bash
 # Login to your DeployStack account
-deploystack-gateway login
+deploystack login
 
 # Start the gateway (runs on localhost:9095 by default)
-deploystack-gateway start
+deploystack start
 
 # Check status
-deploystack-gateway status
+deploystack status
 ```
 
 ## 🧱 How It Works
diff --git a/services/gateway/bin/gateway.js b/services/gateway/bin/gateway.js
@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+require('../dist/index.js');
diff --git a/services/gateway/package.json b/services/gateway/package.json
@@ -3,10 +3,14 @@
   "version": "0.1.0",
   "description": "The local DeployStack Gateway for secure MCP server management.",
   "main": "dist/index.js",
+  "bin": {
+    "deploystack": "bin/gateway.js"
+  },
   "scripts": {
     "build": "tsc",
     "start": "node dist/index.js",
-    "dev": "ts-node-dev --respawn src/index.ts"
+    "dev": "ts-node-dev --respawn src/index.ts",
+    "link": "npm run build && npm link"
   },
   "keywords": [
     "mcp",
@@ -15,7 +19,10 @@
   ],
   "author": "DeployStack",
   "license": "SEE LICENSE IN ../../LICENSE",
-  "dependencies": {},
+  "dependencies": {
+    "commander": "^12.0.0",
+    "chalk": "^4.1.2"
+  },
   "devDependencies": {
     "@types/node": "^24.1.0",
     "ts-node-dev": "^2.0.0",
diff --git a/services/gateway/src/commands/config.ts b/services/gateway/src/commands/config.ts
@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+
+export function registerConfigCommand(program: Command) {
+  program
+    .command('config')
+    .description('Manage local configuration')
+    .action(async () => {
+      console.log(chalk.magenta('hello world from config'));
+    });
+}
diff --git a/services/gateway/src/commands/index.ts b/services/gateway/src/commands/index.ts
@@ -0,0 +1,6 @@
+export { registerLoginCommand } from './login';
+export { registerLogoutCommand } from './logout';
+export { registerStartCommand } from './start';
+export { registerStopCommand } from './stop';
+export { registerStatusCommand } from './status';
+export { registerConfigCommand } from './config';
diff --git a/services/gateway/src/commands/login.ts b/services/gateway/src/commands/login.ts
@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+
+export function registerLoginCommand(program: Command) {
+  program
+    .command('login')
+    .description('Authenticate with DeployStack cloud')
+    .action(async () => {
+      console.log(chalk.green('hello world from login'));
+    });
+}
diff --git a/services/gateway/src/commands/logout.ts b/services/gateway/src/commands/logout.ts
@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+
+export function registerLogoutCommand(program: Command) {
+  program
+    .command('logout')
+    .description('Clear local credentials')
+    .action(async () => {
+      console.log(chalk.yellow('hello world from logout'));
+    });
+}
diff --git a/services/gateway/src/commands/start.ts b/services/gateway/src/commands/start.ts
@@ -0,0 +1,12 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+
+export function registerStartCommand(program: Command) {
+  program
+    .command('start')
+    .description('Start the gateway server')
+    .option('-p, --port <port>', 'Port to run the gateway on', '9095')
+    .action(async (options) => {
+      console.log(chalk.blue(`hello world from start (port: ${options.port})`));
+    });
+}
diff --git a/services/gateway/src/commands/status.ts b/services/gateway/src/commands/status.ts
@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+
+export function registerStatusCommand(program: Command) {
+  program
+    .command('status')
+    .description('Show gateway status')
+    .action(async () => {
+      console.log(chalk.cyan('hello world from status'));
+    });
+}
diff --git a/services/gateway/src/commands/stop.ts b/services/gateway/src/commands/stop.ts
@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+
+export function registerStopCommand(program: Command) {
+  program
+    .command('stop')
+    .description('Stop the gateway server')
+    .action(async () => {
+      console.log(chalk.red('hello world from stop'));
+    });
+}
diff --git a/services/gateway/src/core/auth/client.ts b/services/gateway/src/core/auth/client.ts
@@ -0,0 +1,5 @@
+// OAuth and API client for DeployStack cloud authentication
+// TODO: Implement OAuth flow and API client
+export class AuthClient {
+  // Placeholder for authentication client
+}
diff --git a/services/gateway/src/core/auth/storage.ts b/services/gateway/src/core/auth/storage.ts
@@ -0,0 +1,5 @@
+// Secure credential storage using OS keychain
+// TODO: Implement keytar integration for secure credential storage
+export class CredentialStorage {
+  // Placeholder for secure credential storage
+}
diff --git a/services/gateway/src/core/process/manager.ts b/services/gateway/src/core/process/manager.ts
@@ -0,0 +1,5 @@
+// Process lifecycle management for MCP servers
+// TODO: Implement MCP server process lifecycle management
+export class ProcessManager {
+  // Placeholder for process lifecycle management
+}
diff --git a/services/gateway/src/core/process/spawner.ts b/services/gateway/src/core/process/spawner.ts
@@ -0,0 +1,5 @@
+// Process spawning logic for MCP servers
+// TODO: Implement MCP server process spawning logic
+export class ProcessSpawner {
+  // Placeholder for process spawning logic
+}
diff --git a/services/gateway/src/core/process/stdio.ts b/services/gateway/src/core/process/stdio.ts
@@ -0,0 +1,5 @@
+// Stdio communication handler for MCP servers
+// TODO: Implement stdio communication handler for MCP protocol
+export class StdioHandler {
+  // Placeholder for stdio communication handler
+}
diff --git a/services/gateway/src/core/server/middleware.ts b/services/gateway/src/core/server/middleware.ts
@@ -0,0 +1,5 @@
+// Auth and logging middleware for the HTTP proxy server
+// TODO: Implement authentication and logging middleware
+export class ProxyMiddleware {
+  // Placeholder for proxy middleware
+}
diff --git a/services/gateway/src/core/server/proxy.ts b/services/gateway/src/core/server/proxy.ts
@@ -0,0 +1,5 @@
+// HTTP proxy server for routing MCP requests
+// TODO: Implement HTTP proxy server with request routing logic
+export class ProxyServer {
+  // Placeholder for HTTP proxy server
+}
diff --git a/services/gateway/src/core/sync/cache.ts b/services/gateway/src/core/sync/cache.ts
@@ -0,0 +1,5 @@
+// Local config cache for offline support
+// TODO: Implement local configuration cache
+export class ConfigCache {
+  // Placeholder for local configuration cache
+}
diff --git a/services/gateway/src/core/sync/client.ts b/services/gateway/src/core/sync/client.ts
@@ -0,0 +1,5 @@
+// Cloud API client for configuration synchronization
+// TODO: Implement cloud API client for config sync
+export class SyncClient {
+  // Placeholder for configuration sync client
+}
diff --git a/services/gateway/src/index.ts b/services/gateway/src/index.ts
@@ -1 +1,34 @@
-console.log("Hello, DeployStack Gateway!");
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import {
+  registerLoginCommand,
+  registerLogoutCommand,
+  registerStartCommand,
+  registerStopCommand,
+  registerStatusCommand,
+  registerConfigCommand
+} from './commands';
+
+const program = new Command();
+
+program
+  .name('deploystack')
+  .description('DeployStack Gateway - Local secure proxy for MCP servers')
+  .version('0.1.0');
+
+// Register all commands
+registerLoginCommand(program);
+registerLogoutCommand(program);
+registerStartCommand(program);
+registerStopCommand(program);
+registerStatusCommand(program);
+registerConfigCommand(program);
+
+// Show help if no command is provided
+if (process.argv.length <= 2) {
+  program.help();
+}
+
+program.parse();
diff --git a/services/gateway/src/types/config.ts b/services/gateway/src/types/config.ts
@@ -0,0 +1,26 @@
+// Configuration types
+// TODO: Define configuration types and interfaces
+
+export interface GatewayConfig {
+  port: number;
+  host: string;
+  logLevel: string;
+}
+
+export interface TeamConfig {
+  teamId: string;
+  servers: MCPServerConfig[];
+}
+
+export interface MCPServerConfig {
+  name: string;
+  command: string;
+  args: string[];
+  env?: Record<string, string>;
+}
+
+export interface AuthConfig {
+  accessToken?: string;
+  refreshToken?: string;
+  expiresAt?: number;
+}
diff --git a/services/gateway/src/types/index.ts b/services/gateway/src/types/index.ts
@@ -0,0 +1,4 @@
+// Main type exports for the gateway
+// TODO: Export all type definitions
+export * from './mcp';
+export * from './config';
diff --git a/services/gateway/src/types/mcp.ts b/services/gateway/src/types/mcp.ts
@@ -0,0 +1,17 @@
+// MCP protocol types
+// TODO: Define MCP protocol types and interfaces
+
+export interface MCPServer {
+  name: string;
+  command: string;
+  args: string[];
+  env?: Record<string, string>;
+}
+
+export interface MCPRequest {
+  // Placeholder for MCP request types
+}
+
+export interface MCPResponse {
+  // Placeholder for MCP response types
+}
diff --git a/services/gateway/src/utils/config.ts b/services/gateway/src/utils/config.ts
@@ -0,0 +1,5 @@
+// Configuration management utilities
+// TODO: Implement configuration management
+export class ConfigManager {
+  // Placeholder for configuration management
+}
diff --git a/services/gateway/src/utils/crypto.ts b/services/gateway/src/utils/crypto.ts
@@ -0,0 +1,5 @@
+// Encryption utilities for secure data handling
+// TODO: Implement encryption utilities
+export class CryptoUtils {
+  // Placeholder for encryption utilities
+}
diff --git a/services/gateway/src/utils/errors.ts b/services/gateway/src/utils/errors.ts
@@ -0,0 +1,5 @@
+// Custom error types for the gateway
+// TODO: Implement custom error types and error handling
+export class GatewayError extends Error {
+  // Placeholder for custom error types
+}
diff --git a/services/gateway/src/utils/logger.ts b/services/gateway/src/utils/logger.ts
@@ -0,0 +1,5 @@
+// Centralized logging with chalk for colorful output
+// TODO: Implement centralized logging system
+export class Logger {
+  // Placeholder for logging utilities
+}
diff --git a/services/gateway/src/utils/spinner.ts b/services/gateway/src/utils/spinner.ts
@@ -0,0 +1,5 @@
+// Progress indicators with ora for long-running operations
+// TODO: Implement progress indicators and spinners
+export class Spinner {
+  // Placeholder for spinner utilities
+}

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+#!/usr/bin/env node`
	`2`	`+`
	`3`	`+require('../dist/index.js');`