aws-apigw-ws-emulator 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 m1heng
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,287 @@
+# AWS WebSocket Gateway Local
+
+A lightweight local emulator for **AWS API Gateway WebSocket** with HTTP integration support.
+
+[![npm version](https://img.shields.io/npm/v/aws-apigw-ws-emulator.svg)](https://www.npmjs.com/package/aws-apigw-ws-emulator)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Why?
+
+AWS API Gateway WebSocket supports HTTP integration, allowing you to route WebSocket events to your HTTP backend. However, there's no good open-source solution for local development:
+
+- **LocalStack**: WebSocket support requires Pro (paid) version
+- **serverless-offline**: Only supports Lambda integration, not HTTP
+
+This tool fills that gap - a simple, standalone emulator that:
+- Accepts WebSocket connections from your frontend
+- Forwards `$connect`, `$disconnect`, `$default` events to your HTTP backend
+- Provides `/@connections/{connectionId}` endpoint for `postToConnection`
+
+## Quick Start
+
+### Using npx (no installation)
+
+```bash
+npx aws-apigw-ws-emulator --backend http://localhost:8080
+```
+
+### Using npm
+
+```bash
+npm install -g aws-apigw-ws-emulator
+aws-apigw-ws-emulator --backend http://localhost:8080
+```
+
+### Using Docker
+
+```bash
+docker run -p 3001:3001 ghcr.io/m1heng/aws-apigw-ws-emulator
+```
+
+## Architecture
+
+```
+┌──────────────┐     WebSocket      ┌─────────────────────┐     HTTP POST      ┌──────────────────┐
+│   Frontend   │◄──────────────────►│  aws-ws-gateway-    │───────────────────►│   Your Backend   │
+│              │  ws://localhost    │  local (:3001)      │                    │   (:8080)        │
+│              │  :3001?token=...   │                     │  /api/.../connect  │                  │
+└──────────────┘                    └──────────┬──────────┘  /api/.../default  └────────┬─────────┘
+       ▲                                       │             /api/.../disconnect        │
+       │                                       │                                        │
+       │                                       │◄───────────────────────────────────────┘
+       │                                       │  POST /@connections/{connectionId}
+       └───────────────────────────────────────┘  (postToConnection)
+```
+
+## Usage
+
+### CLI Options
+
+```bash
+aws-apigw-ws-emulator [options]
+
+Options:
+  -p, --port <port>              WebSocket server port (default: 3001)
+  -s, --stage <stage>            API stage name (default: local)
+  --idle-timeout <seconds>       Idle timeout in seconds (default: 600)
+  --hard-timeout <seconds>       Hard timeout in seconds (default: 7200)
+  -c, --config <file>            Config file (YAML or JSON)
+  -v, --verbose                  Enable verbose logging
+  -h, --help                     Display help
+```
+
+### Config File
+
+Create `gateway.config.yaml`:
+
+```yaml
+port: 3001
+stage: local
+
+routes:
+  $connect:
+    uri: http://localhost:8080/ws/connect
+  $disconnect:
+    uri: http://localhost:8080/ws/disconnect
+  $default:
+    uri: http://localhost:8080/ws/default
+
+idleTimeout: 600
+hardTimeout: 7200
+verbose: false
+```
+
+Run with config:
+
+```bash
+aws-apigw-ws-emulator -c gateway.config.yaml
+```
+
+## Integration Guide
+
+### Backend Requirements
+
+Your backend receives AWS Lambda-style WebSocket events via HTTP POST:
+
+```typescript
+interface AWSWebSocketEvent {
+  requestContext: {
+    routeKey: '$connect' | '$disconnect' | '$default' | string;
+    eventType: 'CONNECT' | 'DISCONNECT' | 'MESSAGE';
+    connectionId: string;
+    connectedAt: number;
+    domainName: string;
+    stage: string;
+    apiId: string;
+    requestId: string;
+    identity: { sourceIp: string; userAgent?: string };
+    // MESSAGE only
+    messageId?: string;
+    // DISCONNECT only
+    disconnectStatusCode?: number;
+    disconnectReason?: string;
+  };
+  headers?: Record<string, string>;
+  queryStringParameters?: Record<string, string> | null;
+  body: string | null;
+  isBase64Encoded: boolean;
+}
+```
+
+Example request to your `$connect` endpoint:
+
+```json
+{
+  "requestContext": {
+    "routeKey": "$connect",
+    "eventType": "CONNECT",
+    "connectionId": "abc123xyz456=",
+    "connectedAt": 1704067200000,
+    "domainName": "localhost:3001",
+    "stage": "local",
+    "apiId": "local",
+    "requestId": "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx",
+    "identity": { "sourceIp": "127.0.0.1", "userAgent": "..." }
+  },
+  "headers": { "origin": "http://localhost:3000", ... },
+  "queryStringParameters": { "token": "xxx", "conversationId": "123" },
+  "body": null,
+  "isBase64Encoded": false
+}
+```
+
+### Sending Messages to Clients (postToConnection)
+
+Use the Management API to send messages back to clients:
+
+```bash
+# Using curl
+curl -X POST http://localhost:3001/@connections/{connectionId} \
+  -H "Content-Type: application/json" \
+  -d '{"type": "message", "data": "Hello!"}'
+```
+
+```java
+// Using AWS SDK (Java)
+ApiGatewayManagementApiClient client = ApiGatewayManagementApiClient.builder()
+    .endpointOverride(URI.create("http://localhost:3001"))
+    .region(Region.US_WEST_1)
+    .credentialsProvider(StaticCredentialsProvider.create(
+        AwsBasicCredentials.create("test", "test")))
+    .build();
+
+client.postToConnection(PostToConnectionRequest.builder()
+    .connectionId(connectionId)
+    .data(SdkBytes.fromUtf8String("{\"message\": \"Hello!\"}"))
+    .build());
+```
+
+```javascript
+// Using AWS SDK (JavaScript)
+const client = new ApiGatewayManagementApiClient({
+  endpoint: 'http://localhost:3001',
+  region: 'us-west-1',
+  credentials: { accessKeyId: 'test', secretAccessKey: 'test' },
+});
+
+await client.send(new PostToConnectionCommand({
+  ConnectionId: connectionId,
+  Data: Buffer.from(JSON.stringify({ message: 'Hello!' })),
+}));
+```
+
+### Frontend Connection
+
+```javascript
+// Same code works for both local and production!
+const wsUrl = process.env.NEXT_PUBLIC_WS_URL; // ws://localhost:3001 or wss://xxx.amazonaws.com
+
+const ws = new WebSocket(`${wsUrl}?token=${token}&conversationId=${conversationId}`);
+
+ws.onmessage = (event) => {
+  console.log('Received:', event.data);
+};
+```
+
+### Environment Configuration
+
+Use the same codebase for local and production:
+
+```yaml
+# application.yml (Spring Boot)
+aws:
+  apigateway:
+    callback: ${AWS_APIGATEWAY_CALLBACK:https://xxx.execute-api.us-west-1.amazonaws.com/prod}
+```
+
+```bash
+# Local development
+AWS_APIGATEWAY_CALLBACK=http://localhost:3001 ./mvnw spring-boot:run
+
+# Production
+AWS_APIGATEWAY_CALLBACK=https://xxx.execute-api.us-west-1.amazonaws.com/prod java -jar app.jar
+```
+
+## API Reference
+
+### Management API
+
+| Method | Path | Description |
+|--------|------|-------------|
+| POST | `/@connections/{connectionId}` | Send message to connection (postToConnection) |
+| GET | `/@connections/{connectionId}` | Get connection info |
+| DELETE | `/@connections/{connectionId}` | Close connection |
+| GET | `/health` | Health check |
+
+### Health Check Response
+
+```json
+{
+  "status": "ok",
+  "connections": 5,
+  "uptime": 3600.123
+}
+```
+
+## Comparison with Alternatives
+
+| Feature | aws-apigw-ws-emulator | LocalStack | serverless-offline |
+|---------|---------------------|------------|-------------------|
+| HTTP Integration | ✅ | ✅ (Pro only) | ❌ |
+| Lambda Integration | ❌ | ✅ | ✅ |
+| Free | ✅ | ❌ ($35/mo) | ✅ |
+| Standalone | ✅ | ✅ | ❌ (needs SF) |
+| postToConnection | ✅ | ✅ | ✅ |
+| Easy Setup | ✅ One command | ⚠️ Complex | ⚠️ Complex |
+
+## Programmatic Usage
+
+```typescript
+import { AWSWebSocketGateway } from 'aws-apigw-ws-emulator';
+
+const gateway = new AWSWebSocketGateway({
+  port: 3001,
+  routes: {
+    $connect: { uri: 'http://localhost:8080/ws/connect' },
+    $disconnect: { uri: 'http://localhost:8080/ws/disconnect' },
+    $default: { uri: 'http://localhost:8080/ws/default' },
+  },
+  verbose: true,
+});
+
+await gateway.start();
+
+// Get connection count
+console.log(`Active connections: ${gateway.getConnectionCount()}`);
+
+// Graceful shutdown
+await gateway.stop();
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const yaml_1 = require("yaml");
+const server_1 = require("./server");
+const types_1 = require("./types");
+const logger_1 = require("./logger");
+const packageJson = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(__dirname, '../package.json'), 'utf-8'));
+const program = new commander_1.Command();
+program
+    .name('aws-apigw-ws-emulator')
+    .description('Local emulator for AWS API Gateway WebSocket with HTTP integration')
+    .version(packageJson.version)
+    .option('-p, --port <port>', 'WebSocket server port', String(types_1.DEFAULT_CONFIG.port))
+    .option('-s, --stage <stage>', 'API stage name', types_1.DEFAULT_CONFIG.stage)
+    .option('--idle-timeout <seconds>', 'Idle timeout in seconds', String(types_1.DEFAULT_CONFIG.idleTimeout))
+    .option('--hard-timeout <seconds>', 'Hard timeout in seconds', String(types_1.DEFAULT_CONFIG.hardTimeout))
+    .option('-c, --config <file>', 'Config file (YAML or JSON)')
+    .option('-v, --verbose', 'Enable verbose logging', false)
+    .action(async (options) => {
+    let fileConfig = {};
+    // Load config file if specified
+    if (options.config && (0, fs_1.existsSync)(options.config)) {
+        try {
+            const content = (0, fs_1.readFileSync)(options.config, 'utf-8');
+            if (options.config.endsWith('.yaml') || options.config.endsWith('.yml')) {
+                fileConfig = (0, yaml_1.parse)(content);
+            }
+            else {
+                fileConfig = JSON.parse(content);
+            }
+            logger_1.logger.info(`Loaded config from ${options.config}`);
+        }
+        catch (error) {
+            logger_1.logger.error(`Failed to load config file: ${error.message}`);
+            process.exit(1);
+        }
+    }
+    // Build final config: defaults <- file <- CLI
+    const finalConfig = {
+        ...types_1.DEFAULT_CONFIG,
+        ...fileConfig,
+    };
+    // CLI overrides (only if explicitly provided)
+    if (options.port !== String(types_1.DEFAULT_CONFIG.port)) {
+        finalConfig.port = parseInt(options.port, 10);
+    }
+    if (options.stage !== types_1.DEFAULT_CONFIG.stage) {
+        finalConfig.stage = options.stage;
+    }
+    if (options.idleTimeout !== String(types_1.DEFAULT_CONFIG.idleTimeout)) {
+        finalConfig.idleTimeout = parseInt(options.idleTimeout, 10);
+    }
+    if (options.hardTimeout !== String(types_1.DEFAULT_CONFIG.hardTimeout)) {
+        finalConfig.hardTimeout = parseInt(options.hardTimeout, 10);
+    }
+    if (options.verbose) {
+        finalConfig.verbose = true;
+    }
+    const gateway = new server_1.AWSWebSocketGateway(finalConfig);
+    // Graceful shutdown
+    const shutdown = async () => {
+        logger_1.logger.info('Shutting down...');
+        await gateway.stop();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    try {
+        await gateway.start();
+    }
+    catch (error) {
+        logger_1.logger.error(`Failed to start server: ${error.message}`);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { AWSWebSocketGateway } from './server';
+export { GatewayConfig, Connection, RouteIntegration, AWSWebSocketEvent, AWSRequestContext, AWSIdentity, DEFAULT_CONFIG, } from './types';
+export { logger, Logger } from './logger';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EACL,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = exports.logger = exports.DEFAULT_CONFIG = exports.AWSWebSocketGateway = void 0;
+// Main exports for programmatic usage
+var server_1 = require("./server");
+Object.defineProperty(exports, "AWSWebSocketGateway", { enumerable: true, get: function () { return server_1.AWSWebSocketGateway; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "DEFAULT_CONFIG", { enumerable: true, get: function () { return types_1.DEFAULT_CONFIG; } });
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_1.logger; } });
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_1.Logger; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,sCAAsC;AACtC,mCAA+C;AAAtC,6GAAA,mBAAmB,OAAA;AAC5B,iCAQiB;AADf,uGAAA,cAAc,OAAA;AAEhB,mCAA0C;AAAjC,gGAAA,MAAM,OAAA;AAAE,gGAAA,MAAM,OAAA"}

package/dist/logger.d.ts

@@ -0,0 +1,18 @@
+export declare class Logger {
+    private verbose;
+    constructor(verbose?: boolean);
+    setVerbose(verbose: boolean): void;
+    info(message: string, ...args: unknown[]): void;
+    success(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    debug(message: string, ...args: unknown[]): void;
+    ws(action: string, connectionId: string, detail?: string): void;
+    http(method: string, path: string, status: number): void;
+    banner(config: {
+        port: number;
+        stage: string;
+    }): void;
+}
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,qBAAa,MAAM;IACjB,OAAO,CAAC,OAAO,CAAU;gBAEb,OAAO,UAAQ;IAI3B,UAAU,CAAC,OAAO,EAAE,OAAO;IAI3B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAIxC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAI3C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAIxC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAIzC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAMzC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAUxD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IASjD,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAa/C;AAED,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/logger.js

@@ -0,0 +1,63 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.Logger = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+class Logger {
+    verbose;
+    constructor(verbose = false) {
+        this.verbose = verbose;
+    }
+    setVerbose(verbose) {
+        this.verbose = verbose;
+    }
+    info(message, ...args) {
+        console.log(chalk_1.default.blue('[INFO]'), message, ...args);
+    }
+    success(message, ...args) {
+        console.log(chalk_1.default.green('[OK]'), message, ...args);
+    }
+    warn(message, ...args) {
+        console.log(chalk_1.default.yellow('[WARN]'), message, ...args);
+    }
+    error(message, ...args) {
+        console.log(chalk_1.default.red('[ERROR]'), message, ...args);
+    }
+    debug(message, ...args) {
+        if (this.verbose) {
+            console.log(chalk_1.default.gray('[DEBUG]'), message, ...args);
+        }
+    }
+    ws(action, connectionId, detail) {
+        const id = chalk_1.default.cyan(connectionId.slice(0, 12));
+        const act = chalk_1.default.magenta(`[${action}]`);
+        if (detail) {
+            console.log(act, id, chalk_1.default.gray(detail));
+        }
+        else {
+            console.log(act, id);
+        }
+    }
+    http(method, path, status) {
+        const statusColor = status < 400 ? chalk_1.default.green : chalk_1.default.red;
+        console.log(chalk_1.default.yellow(`[${method}]`), path, statusColor(status));
+    }
+    banner(config) {
+        console.log('');
+        console.log(chalk_1.default.bold.cyan('╔══════════════════════════════════════════════════════════════╗'));
+        console.log(chalk_1.default.bold.cyan('║') + chalk_1.default.bold.white('       AWS API Gateway WebSocket - Local Emulator            ') + chalk_1.default.bold.cyan('║'));
+        console.log(chalk_1.default.bold.cyan('╠══════════════════════════════════════════════════════════════╣'));
+        console.log(chalk_1.default.bold.cyan('║') + `  WebSocket:     ${chalk_1.default.green(`ws://localhost:${config.port}`)}                      ` + chalk_1.default.bold.cyan('║'));
+        console.log(chalk_1.default.bold.cyan('║') + `  Management:    ${chalk_1.default.green(`http://localhost:${config.port}/@connections/{id}`)} ` + chalk_1.default.bold.cyan('║'));
+        console.log(chalk_1.default.bold.cyan('║') + `  Stage:         ${chalk_1.default.yellow(config.stage)}                                       ` + chalk_1.default.bold.cyan('║'));
+        console.log(chalk_1.default.bold.cyan('╠══════════════════════════════════════════════════════════════╣'));
+        console.log(chalk_1.default.bold.cyan('║') + chalk_1.default.gray('  Connect: ws://localhost:' + config.port + '?token=xxx') + '                  ' + chalk_1.default.bold.cyan('║'));
+        console.log(chalk_1.default.bold.cyan('╚══════════════════════════════════════════════════════════════╝'));
+        console.log('');
+    }
+}
+exports.Logger = Logger;
+exports.logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA0B;AAE1B,MAAa,MAAM;IACT,OAAO,CAAU;IAEzB,YAAY,OAAO,GAAG,KAAK;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,UAAU,CAAC,OAAgB;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,CAAC,OAAe,EAAE,GAAG,IAAe;QACzC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,EAAE,CAAC,MAAc,EAAE,YAAoB,EAAE,MAAe;QACtD,MAAM,EAAE,GAAG,eAAK,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,eAAK,CAAC,OAAO,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC;QACzC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,EAAE,eAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,IAAI,CAAC,MAAc,EAAE,IAAY,EAAE,MAAc;QAC/C,MAAM,WAAW,GAAG,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,eAAK,CAAC,KAAK,CAAC,CAAC,CAAC,eAAK,CAAC,GAAG,CAAC;QAC3D,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAC3B,IAAI,EACJ,WAAW,CAAC,MAAM,CAAC,CACpB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,MAAuC;QAC5C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC,CAAC;QACjG,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,eAAK,CAAC,IAAI,CAAC,KAAK,CAAC,+DAA+D,CAAC,GAAG,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7I,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC,CAAC;QACjG,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,oBAAoB,eAAK,CAAC,KAAK,CAAC,kBAAkB,MAAM,CAAC,IAAI,EAAE,CAAC,wBAAwB,GAAG,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACpJ,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,oBAAoB,eAAK,CAAC,KAAK,CAAC,oBAAoB,MAAM,CAAC,IAAI,oBAAoB,CAAC,GAAG,GAAG,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACnJ,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,oBAAoB,eAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,GAAG,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACnJ,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC,CAAC;QACjG,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,eAAK,CAAC,IAAI,CAAC,4BAA4B,GAAG,MAAM,CAAC,IAAI,GAAG,YAAY,CAAC,GAAG,oBAAoB,GAAG,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACxJ,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC,CAAC;QACjG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;CACF;AAjED,wBAiEC;AAEY,QAAA,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,29 @@
+import { GatewayConfig } from './types';
+export declare class AWSWebSocketGateway {
+    private config;
+    private httpServer;
+    private wss;
+    private connections;
+    private timeoutTimers;
+    constructor(config?: Partial<GatewayConfig>);
+    private handleHttpRequest;
+    private handleManagementApi;
+    private handleConnection;
+    private selectRoute;
+    private buildRequestContext;
+    private buildMultiValueHeaders;
+    private buildLambdaEvent;
+    private formatRequestTime;
+    private callBackend;
+    private getEventType;
+    private setupTimeouts;
+    private resetIdleTimeout;
+    private clearTimeouts;
+    private generateConnectionId;
+    private generateRequestId;
+    private generateMessageId;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getConnectionCount(): number;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,aAAa,EAKd,MAAM,SAAS,CAAC;AAQjB,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,GAAG,CAAkB;IAC7B,OAAO,CAAC,WAAW,CAAsC;IACzD,OAAO,CAAC,aAAa,CAA0C;gBAEnD,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM;IAiB/C,OAAO,CAAC,iBAAiB;IA+BzB,OAAO,CAAC,mBAAmB;IAyE3B,OAAO,CAAC,gBAAgB;IAyFxB,OAAO,CAAC,WAAW;IAiCnB,OAAO,CAAC,mBAAmB;IA0C3B,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,iBAAiB;YA2BX,WAAW;IA0CzB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,iBAAiB;IAQzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBrB,kBAAkB,IAAI,MAAM;CAG7B"}

package/dist/server.js

@@ -0,0 +1,425 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AWSWebSocketGateway = void 0;
+const http_1 = __importDefault(require("http"));
+const url_1 = require("url");
+const ws_1 = require("ws");
+const types_1 = require("./types");
+const logger_1 = require("./logger");
+class AWSWebSocketGateway {
+    config;
+    httpServer;
+    wss;
+    connections = new Map();
+    timeoutTimers = new Map();
+    constructor(config = {}) {
+        this.config = { ...types_1.DEFAULT_CONFIG, ...config };
+        // Set domainName if not specified
+        if (!this.config.domainName) {
+            this.config.domainName = `localhost:${this.config.port}`;
+        }
+        logger_1.logger.setVerbose(this.config.verbose);
+        this.httpServer = http_1.default.createServer(this.handleHttpRequest.bind(this));
+        this.wss = new ws_1.WebSocketServer({ server: this.httpServer });
+        this.wss.on('connection', this.handleConnection.bind(this));
+    }
+    // ============================================================================
+    // HTTP Request Handling (Management API)
+    // ============================================================================
+    handleHttpRequest(req, res) {
+        const url = new url_1.URL(req.url || '/', `http://localhost:${this.config.port}`);
+        const method = req.method || 'GET';
+        // Health check
+        if (method === 'GET' && url.pathname === '/health') {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+                status: 'ok',
+                connections: this.connections.size,
+                uptime: process.uptime(),
+            }));
+            logger_1.logger.http('GET', '/health', 200);
+            return;
+        }
+        // Management API: /@connections/{connectionId}
+        const match = url.pathname.match(/^\/@connections\/(.+)$/);
+        if (match) {
+            const connectionId = decodeURIComponent(match[1]);
+            this.handleManagementApi(method, connectionId, req, res);
+            return;
+        }
+        res.writeHead(404, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ message: 'Not Found' }));
+        logger_1.logger.http(method, url.pathname, 404);
+    }
+    handleManagementApi(method, connectionId, req, res) {
+        const connection = this.connections.get(connectionId);
+        // GET - Get connection info
+        if (method === 'GET') {
+            if (connection) {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({
+                    connectionId,
+                    connectedAt: connection.connectedAt.toISOString(),
+                    lastActiveAt: connection.lastActivityAt.toISOString(),
+                }));
+                logger_1.logger.http('GET', `/@connections/${connectionId}`, 200);
+            }
+            else {
+                res.writeHead(410, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ message: 'Gone', connectionId }));
+                logger_1.logger.http('GET', `/@connections/${connectionId}`, 410);
+            }
+            return;
+        }
+        // DELETE - Close connection
+        if (method === 'DELETE') {
+            if (connection && connection.ws.readyState === ws_1.WebSocket.OPEN) {
+                connection.ws.close(1000, 'Closed by management API');
+                res.writeHead(204);
+                res.end();
+                logger_1.logger.http('DELETE', `/@connections/${connectionId}`, 204);
+            }
+            else {
+                res.writeHead(410, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ message: 'Gone', connectionId }));
+                logger_1.logger.http('DELETE', `/@connections/${connectionId}`, 410);
+            }
+            return;
+        }
+        // POST - Send message (postToConnection)
+        if (method === 'POST') {
+            let body = '';
+            req.on('data', (chunk) => (body += chunk));
+            req.on('end', () => {
+                if (connection && connection.ws.readyState === ws_1.WebSocket.OPEN) {
+                    connection.ws.send(body);
+                    connection.lastActivityAt = new Date();
+                    res.writeHead(200);
+                    res.end();
+                    logger_1.logger.http('POST', `/@connections/${connectionId}`, 200);
+                    logger_1.logger.debug(`Sent ${body.length} bytes to ${connectionId}`);
+                }
+                else {
+                    res.writeHead(410, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ message: 'Gone', connectionId }));
+                    logger_1.logger.http('POST', `/@connections/${connectionId}`, 410);
+                }
+            });
+            return;
+        }
+        res.writeHead(405, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ message: 'Method Not Allowed' }));
+        logger_1.logger.http(method, `/@connections/${connectionId}`, 405);
+    }
+    // ============================================================================
+    // WebSocket Connection Handling
+    // ============================================================================
+    handleConnection(ws, req) {
+        const url = new url_1.URL(req.url || '/', `http://localhost:${this.config.port}`);
+        const connectionId = this.generateConnectionId();
+        // Parse query parameters
+        const queryParams = {};
+        url.searchParams.forEach((value, key) => {
+            queryParams[key] = value;
+        });
+        // Parse headers
+        const headers = {};
+        for (const [key, value] of Object.entries(req.headers)) {
+            if (typeof value === 'string') {
+                headers[key.toLowerCase()] = value;
+            }
+            else if (Array.isArray(value)) {
+                headers[key.toLowerCase()] = value[0];
+            }
+        }
+        // Extract client info
+        const sourceIp = (req.socket.remoteAddress || '127.0.0.1').replace('::ffff:', '');
+        const userAgent = req.headers['user-agent'] || '';
+        const connection = {
+            id: connectionId,
+            ws,
+            connectedAt: new Date(),
+            lastActivityAt: new Date(),
+            queryParams,
+            headers,
+            sourceIp,
+            userAgent,
+        };
+        this.connections.set(connectionId, connection);
+        this.setupTimeouts(connectionId);
+        logger_1.logger.ws('CONNECT', connectionId, `ip: ${sourceIp}`);
+        // Call $connect route
+        this.callBackend('$connect', connection, null).then((success) => {
+            if (!success) {
+                logger_1.logger.warn(`$connect callback failed for ${connectionId}, closing connection`);
+                ws.close(1011, 'Backend connect failed');
+            }
+        });
+        // Handle messages
+        ws.on('message', (data) => {
+            const message = data.toString();
+            connection.lastActivityAt = new Date();
+            this.resetIdleTimeout(connectionId);
+            logger_1.logger.ws('MESSAGE', connectionId, `${message.substring(0, 50)}${message.length > 50 ? '...' : ''}`);
+            // Route selection (P2: custom routes)
+            const routeKey = this.selectRoute(message);
+            this.callBackend(routeKey, connection, message);
+        });
+        // Handle close
+        ws.on('close', (code, reason) => {
+            const reasonStr = reason.toString();
+            logger_1.logger.ws('DISCONNECT', connectionId, `code: ${code}`);
+            this.callBackend('$disconnect', connection, null, {
+                disconnectStatusCode: code,
+                disconnectReason: reasonStr,
+            });
+            this.clearTimeouts(connectionId);
+            this.connections.delete(connectionId);
+        });
+        // Handle error
+        ws.on('error', (error) => {
+            logger_1.logger.error(`WebSocket error for ${connectionId}:`, error.message);
+        });
+    }
+    // ============================================================================
+    // Route Selection (P2)
+    // ============================================================================
+    selectRoute(message) {
+        if (!this.config.routeSelectionExpression) {
+            return '$default';
+        }
+        try {
+            const parsed = JSON.parse(message);
+            const match = this.config.routeSelectionExpression.match(/^\$request\.body\.(.+)$/);
+            if (match) {
+                const path = match[1].split('.');
+                let value = parsed;
+                for (const key of path) {
+                    if (value && typeof value === 'object' && key in value) {
+                        value = value[key];
+                    }
+                    else {
+                        return '$default';
+                    }
+                }
+                if (typeof value === 'string' && this.config.routes[value]) {
+                    return value;
+                }
+            }
+        }
+        catch {
+            // Non-JSON message, use $default
+        }
+        return '$default';
+    }
+    // ============================================================================
+    // AWS Event Building
+    // ============================================================================
+    buildRequestContext(connection, routeKey, eventType, options) {
+        const now = new Date();
+        const requestId = this.generateRequestId();
+        const context = {
+            routeKey,
+            eventType,
+            extendedRequestId: requestId,
+            requestTime: this.formatRequestTime(now),
+            messageDirection: 'IN',
+            stage: this.config.stage,
+            connectedAt: connection.connectedAt.getTime(),
+            requestTimeEpoch: now.getTime(),
+            identity: {
+                sourceIp: connection.sourceIp,
+                userAgent: connection.userAgent,
+            },
+            requestId,
+            domainName: this.config.domainName,
+            connectionId: connection.id,
+            apiId: this.config.apiId,
+        };
+        // MESSAGE-specific fields
+        if (eventType === 'MESSAGE') {
+            context.messageId = options?.messageId || this.generateMessageId();
+        }
+        // DISCONNECT-specific fields
+        if (eventType === 'DISCONNECT' && options) {
+            context.disconnectStatusCode = options.disconnectStatusCode;
+            context.disconnectReason = options.disconnectReason;
+        }
+        return context;
+    }
+    buildMultiValueHeaders(headers) {
+        const result = {};
+        for (const [key, value] of Object.entries(headers)) {
+            result[key] = [value];
+        }
+        return result;
+    }
+    buildLambdaEvent(connection, routeKey, eventType, body, options) {
+        return {
+            requestContext: this.buildRequestContext(connection, routeKey, eventType, options),
+            headers: connection.headers,
+            multiValueHeaders: this.buildMultiValueHeaders(connection.headers),
+            queryStringParameters: Object.keys(connection.queryParams).length > 0 ? connection.queryParams : null,
+            body,
+            isBase64Encoded: false,
+        };
+    }
+    formatRequestTime(date) {
+        const pad = (n) => n.toString().padStart(2, '0');
+        const months = [
+            'Jan',
+            'Feb',
+            'Mar',
+            'Apr',
+            'May',
+            'Jun',
+            'Jul',
+            'Aug',
+            'Sep',
+            'Oct',
+            'Nov',
+            'Dec',
+        ];
+        return (`${pad(date.getUTCDate())}/${months[date.getUTCMonth()]}/${date.getUTCFullYear()}:` +
+            `${pad(date.getUTCHours())}:${pad(date.getUTCMinutes())}:${pad(date.getUTCSeconds())} +0000`);
+    }
+    // ============================================================================
+    // Backend Communication
+    // ============================================================================
+    async callBackend(routeKey, connection, body, disconnectOptions) {
+        // Get event type from route key
+        const eventType = this.getEventType(routeKey);
+        // Get route integration
+        const integration = this.config.routes[routeKey] || this.config.routes['$default'];
+        if (!integration) {
+            logger_1.logger.warn(`No integration found for route: ${routeKey}`);
+            return false;
+        }
+        // Build AWS Lambda event
+        const event = this.buildLambdaEvent(connection, routeKey, eventType, body, disconnectOptions);
+        try {
+            const response = await fetch(integration.uri, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(event),
+            });
+            logger_1.logger.debug(`${routeKey} callback: ${response.status}`);
+            return response.ok;
+        }
+        catch (error) {
+            logger_1.logger.error(`${routeKey} callback failed:`, error.message);
+            return false;
+        }
+    }
+    getEventType(routeKey) {
+        switch (routeKey) {
+            case '$connect':
+                return 'CONNECT';
+            case '$disconnect':
+                return 'DISCONNECT';
+            default:
+                return 'MESSAGE';
+        }
+    }
+    // ============================================================================
+    // Timeout Management
+    // ============================================================================
+    setupTimeouts(connectionId) {
+        this.resetIdleTimeout(connectionId);
+        // Hard timeout
+        const hardTimer = setTimeout(() => {
+            const connection = this.connections.get(connectionId);
+            if (connection) {
+                logger_1.logger.warn(`Hard timeout reached for ${connectionId}`);
+                connection.ws.close(1001, 'Hard timeout');
+            }
+        }, this.config.hardTimeout * 1000);
+        this.timeoutTimers.set(`${connectionId}:hard`, hardTimer);
+    }
+    resetIdleTimeout(connectionId) {
+        const idleKey = `${connectionId}:idle`;
+        const existingTimer = this.timeoutTimers.get(idleKey);
+        if (existingTimer) {
+            clearTimeout(existingTimer);
+        }
+        const idleTimer = setTimeout(() => {
+            const connection = this.connections.get(connectionId);
+            if (connection) {
+                logger_1.logger.warn(`Idle timeout reached for ${connectionId}`);
+                connection.ws.close(1001, 'Idle timeout');
+            }
+        }, this.config.idleTimeout * 1000);
+        this.timeoutTimers.set(idleKey, idleTimer);
+    }
+    clearTimeouts(connectionId) {
+        const idleTimer = this.timeoutTimers.get(`${connectionId}:idle`);
+        const hardTimer = this.timeoutTimers.get(`${connectionId}:hard`);
+        if (idleTimer)
+            clearTimeout(idleTimer);
+        if (hardTimer)
+            clearTimeout(hardTimer);
+        this.timeoutTimers.delete(`${connectionId}:idle`);
+        this.timeoutTimers.delete(`${connectionId}:hard`);
+    }
+    // ============================================================================
+    // ID Generation
+    // ============================================================================
+    generateConnectionId() {
+        const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+        let result = '';
+        for (let i = 0; i < 12; i++) {
+            result += chars.charAt(Math.floor(Math.random() * chars.length));
+        }
+        return result + '=';
+    }
+    generateRequestId() {
+        return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+            const r = (Math.random() * 16) | 0;
+            const v = c === 'x' ? r : (r & 0x3) | 0x8;
+            return v.toString(16);
+        });
+    }
+    generateMessageId() {
+        return this.generateConnectionId();
+    }
+    // ============================================================================
+    // Server Lifecycle
+    // ============================================================================
+    start() {
+        return new Promise((resolve) => {
+            this.httpServer.listen(this.config.port, () => {
+                logger_1.logger.banner({
+                    port: this.config.port,
+                    stage: this.config.stage,
+                });
+                resolve();
+            });
+        });
+    }
+    stop() {
+        return new Promise((resolve) => {
+            this.connections.forEach((connection) => {
+                connection.ws.close(1001, 'Server shutting down');
+            });
+            this.connections.clear();
+            this.timeoutTimers.forEach((timer) => clearTimeout(timer));
+            this.timeoutTimers.clear();
+            this.wss.close(() => {
+                this.httpServer.close(() => {
+                    logger_1.logger.info('Server stopped');
+                    resolve();
+                });
+            });
+        });
+    }
+    getConnectionCount() {
+        return this.connections.size;
+    }
+}
+exports.AWSWebSocketGateway = AWSWebSocketGateway;
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,57 @@
+import { WebSocket } from 'ws';
+export interface AWSIdentity {
+    sourceIp: string;
+    userAgent?: string;
+}
+export interface AWSRequestContext {
+    routeKey: string;
+    eventType: 'CONNECT' | 'DISCONNECT' | 'MESSAGE';
+    extendedRequestId: string;
+    requestTime: string;
+    messageDirection: 'IN';
+    stage: string;
+    connectedAt: number;
+    requestTimeEpoch: number;
+    identity: AWSIdentity;
+    requestId: string;
+    domainName: string;
+    connectionId: string;
+    apiId: string;
+    messageId?: string;
+    disconnectStatusCode?: number;
+    disconnectReason?: string;
+}
+export interface AWSWebSocketEvent {
+    requestContext: AWSRequestContext;
+    headers: Record<string, string>;
+    multiValueHeaders: Record<string, string[]>;
+    queryStringParameters: Record<string, string> | null;
+    body: string | null;
+    isBase64Encoded: boolean;
+}
+export interface RouteIntegration {
+    uri: string;
+}
+export interface GatewayConfig {
+    port: number;
+    stage: string;
+    apiId: string;
+    domainName: string;
+    routeSelectionExpression?: string;
+    routes: Record<string, RouteIntegration>;
+    idleTimeout: number;
+    hardTimeout: number;
+    verbose: boolean;
+}
+export declare const DEFAULT_CONFIG: GatewayConfig;
+export interface Connection {
+    id: string;
+    ws: WebSocket;
+    connectedAt: Date;
+    lastActivityAt: Date;
+    queryParams: Record<string, string>;
+    headers: Record<string, string>;
+    sourceIp: string;
+    userAgent: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAM/B,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;IAChD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IAEd,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,iBAAiB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5C,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACrD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAMD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,cAAc,EAAE,aAa5B,CAAC;AAMF,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,SAAS,CAAC;IACd,WAAW,EAAE,IAAI,CAAC;IAClB,cAAc,EAAE,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = void 0;
+exports.DEFAULT_CONFIG = {
+    port: 3001,
+    stage: 'local',
+    apiId: 'local',
+    domainName: '',
+    routes: {
+        $connect: { uri: 'http://localhost:8080/ws/connect' },
+        $disconnect: { uri: 'http://localhost:8080/ws/disconnect' },
+        $default: { uri: 'http://localhost:8080/ws/default' },
+    },
+    idleTimeout: 600,
+    hardTimeout: 7200,
+    verbose: false,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AA6Da,QAAA,cAAc,GAAkB;IAC3C,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,UAAU,EAAE,EAAE;IACd,MAAM,EAAE;QACN,QAAQ,EAAE,EAAE,GAAG,EAAE,kCAAkC,EAAE;QACrD,WAAW,EAAE,EAAE,GAAG,EAAE,qCAAqC,EAAE;QAC3D,QAAQ,EAAE,EAAE,GAAG,EAAE,kCAAkC,EAAE;KACtD;IACD,WAAW,EAAE,GAAG;IAChB,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,KAAK;CACf,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "aws-apigw-ws-emulator",
+  "version": "0.0.1",
+  "description": "Local emulator for AWS API Gateway WebSocket with HTTP integration support",
+  "keywords": [
+    "aws",
+    "api-gateway",
+    "websocket",
+    "local",
+    "emulator",
+    "mock",
+    "development",
+    "serverless"
+  ],
+  "author": "m1heng",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/m1heng/aws-apigw-ws-emulator"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "aws-apigw-ws-emulator": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "ws": "^8.16.0",
+    "yaml": "^2.3.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@types/ws": "^8.5.10",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/cli.ts",
+    "start": "node dist/cli.js",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}