@mono-labs/dev 0.1.255 → 0.1.257

package/README.md

@@ -0,0 +1,294 @@
+# @mono-labs/dev
+
+Local development server and WebSocket adapter for mono-labs. Maps Lambda handlers to Express routes, emulates API Gateway WebSocket connections, and provides a Redis caching abstraction.
+
+## Installation
+
+```bash
+yarn add @mono-labs/dev
+```
+
+### Optional Peer Dependencies
+
+```bash
+# For Redis-backed channel store and CacheRelay
+yarn add ioredis
+
+# For API Gateway WebSocket mode (SocketGatewayClient)
+yarn add @aws-sdk/client-apigatewaymanagementapi
+```
+
+## API Reference
+
+### LocalServer
+
+Express-based HTTP server that maps Lambda handlers to local routes.
+
+```typescript
+import { LocalServer } from '@mono-labs/dev'
+
+const server = new LocalServer({ debug: true })
+```
+
+- **`constructor(config?)`** -- Creates a new server. `LocalServerConfig` options: `debug?: boolean`, `useRedis?: boolean`, `redis?: RedisConfig`.
+- **`.app`** -- The underlying `express.Express` instance for custom middleware.
+
+#### `.lambda(path, handler, options?)`
+
+Registers a Lambda handler at the given HTTP path. Supports two event types:
+
+```typescript
+// API Gateway V2 (default)
+server.lambda('/api/*', myApiGatewayHandler)
+server.lambda('/api/*', myApiGatewayHandler, { eventType: 'api-gateway' })
+
+// Application Load Balancer
+server.lambda('/alb/*', myALBHandler, { eventType: 'alb' })
+```
+
+#### `.attachSocket(adapterFn, config?)`
+
+Attaches the WebSocket adapter to the server's HTTP instance:
+
+```typescript
+import { attachSocketAdapter } from '@mono-labs/dev'
+
+const socket = server.attachSocket(attachSocketAdapter, {
+  debug: true,
+  connectHandler: async (connectionId, { token }) => ({
+    response: { statusCode: 200 },
+    userContext: { userId: '123', organizationId: 'org-1' }
+  }),
+  routes: {
+    ping: async (body, ctx) => ({ statusCode: 200, body: 'pong' })
+  }
+})
+```
+
+Returns the same object as `attachSocketAdapter()` (see below).
+
+#### `.listen(port, hostname?)`
+
+Starts the HTTP server:
+
+```typescript
+server.listen(3000)
+```
+
+---
+
+### WebSocket System
+
+#### `attachSocketAdapter(wss, config?)`
+
+Wires a `WebSocketServer` instance with connection tracking, action routing, and event synthesis:
+
+```typescript
+import { WebSocketServer } from 'ws'
+import { attachSocketAdapter } from '@mono-labs/dev'
+
+const wss = new WebSocketServer({ noServer: true })
+const {
+  postToConnection,
+  connectionRegistry,
+  actionRouter,
+  channelStore,
+  socketEmitter,
+  getConnectionId,
+} = attachSocketAdapter(wss, { debug: true })
+```
+
+**`SocketAdapterConfig`** options:
+- `domainName?: string` -- Domain for synthesized events (default: `'localhost'`)
+- `stage?: string` -- Stage for synthesized events (default: `'local'`)
+- `debug?: boolean` -- Enable debug logging
+- `connectHandler?: ConnectHandlerFn` -- Custom $connect handler
+- `disconnectHandler?: DisconnectHandlerFn` -- Custom $disconnect handler
+- `routes?: Record<string, ActionHandler>` -- Action routes
+- `defaultHandler?: ActionHandler` -- Fallback for unmatched actions
+- `channelStore?: ChannelStore` -- Custom channel store implementation
+- `useRedis?: boolean` -- Use Redis-backed channel store
+- `redis?: RedisConfig` -- Redis connection options
+
+#### `ConnectionRegistry`
+
+Tracks WebSocket connections and their user contexts:
+
+```typescript
+registry.register(ws): ConnectionId
+registry.unregister(connectionId): void
+registry.get(connectionId): WebSocket | undefined
+registry.getAll(): ConnectionId[]
+registry.setUserContext(connectionId, ctx): void
+registry.getUserContext(connectionId): WebSocketUserContext | undefined
+registry.getConnectionsByUserId(userId): ConnectionId[]
+registry.getConnectionsByOrgId(orgId): ConnectionId[]
+```
+
+#### `ActionRouter`
+
+Routes incoming WebSocket messages to handlers based on the `action` field:
+
+```typescript
+router.addRoute('chat:send', async (body, ctx) => {
+  return { statusCode: 200, body: 'ok' }
+})
+router.setDefaultHandler(async (body, ctx) => {
+  return { statusCode: 400, body: 'Unknown action' }
+})
+```
+
+**`ActionHandlerContext`**: `{ connectionId, requestContext, postToConnection, userContext }`
+
+#### `SocketGatewayClient`
+
+Dual-mode client for posting messages to WebSocket connections. Accepts either a `ConnectionRegistry` for local mode or a URL string for AWS API Gateway mode:
+
+```typescript
+import { SocketGatewayClient } from '@mono-labs/dev'
+
+// Local mode (uses ConnectionRegistry to find WebSocket instances)
+const localClient = new SocketGatewayClient(connectionRegistry)
+
+// API Gateway mode (uses @aws-sdk/client-apigatewaymanagementapi)
+const awsClient = new SocketGatewayClient('https://abc123.execute-api.us-east-1.amazonaws.com/prod')
+
+await client.postToConnection(connectionId, { message: 'hello' })
+
+// Get a bound function for dependency injection
+const postFn = client.asFunction()
+```
+
+#### `SocketEmitter`
+
+High-level emit API targeting users, orgs, connections, channels, or broadcast:
+
+```typescript
+import type { EmitTarget } from '@mono-labs/dev'
+
+await socketEmitter.emit({ userId: 'user-1' }, { event: 'update' })
+await socketEmitter.emit({ orgId: 'org-1' }, { event: 'notify' })
+await socketEmitter.emit({ connectionId: 'conn-1' }, data)
+await socketEmitter.emit({ channel: 'room-1' }, data)
+await socketEmitter.emit('broadcast', data)
+```
+
+#### `ChannelStore`
+
+Manages pub/sub channel subscriptions. Two implementations:
+
+- **`InMemoryChannelStore`** -- Default. In-memory Maps, no dependencies.
+- **`RedisChannelStore`** -- Redis-backed. Requires `ioredis` peer dependency.
+
+```typescript
+interface ChannelStore {
+  subscribe(connectionId, channel): Promise<void>
+  unsubscribe(connectionId, channel): Promise<void>
+  getSubscribers(channel): Promise<ConnectionId[]>
+  removeAll(connectionId): Promise<void>
+}
+```
+
+---
+
+### CacheRelay
+
+Redis abstraction with namespaced operations. Requires `ioredis` peer dependency.
+
+```typescript
+import { initCacheRelay, getCacheRelay } from '@mono-labs/dev'
+
+// Initialize (defaults to localhost:6379)
+initCacheRelay()
+
+// Or with a connection string (bare hostnames auto-normalized to redis://)
+initCacheRelay('my-redis-host:6379')
+
+// Get the singleton instance
+const cache = getCacheRelay()
+```
+
+**Top-level convenience methods:**
+
+```typescript
+await cache.set('key', { foo: 'bar' }, { ttlSeconds: 300 })
+const value = await cache.get('key')        // string | null
+const parsed = await cache.gett<MyType>('key') // T | null
+await cache.del('key1', 'key2')
+```
+
+**Namespaced operations:**
+
+| Namespace | Operations |
+|-----------|-----------|
+| `cache.strings` | `get`, `set`, `mget`, `mset`, `incr`, `incrby`, `decr`, `decrby`, `append`, `strlen` |
+| `cache.hashes` | `get`, `set`, `getAll`, `del`, `exists`, `keys`, `vals`, `len`, `mset`, `mget`, `incrby` |
+| `cache.lists` | `push`, `lpush`, `pop`, `lpop`, `range`, `len`, `trim`, `index`, `set`, `rem` |
+| `cache.sets` | `add`, `rem`, `members`, `isMember`, `card`, `union`, `inter`, `diff` |
+| `cache.sortedSets` | `add`, `rem`, `range`, `rangeWithScores`, `rangeByScore`, `revRange`, `score`, `rank`, `card`, `incrby`, `remRangeByRank`, `remRangeByScore` |
+| `cache.keys` | `exists`, `expire`, `ttl`, `pttl`, `persist`, `rename`, `type`, `scan` |
+| `cache.pubsub` | `publish`, `subscribe`, `unsubscribe` |
+| `cache.transactions` | `multi`, `exec` |
+| `cache.scripts` | `eval`, `evalsha` |
+| `cache.geo` | `add`, `pos`, `dist`, `radius` |
+| `cache.hyperloglog` | `add`, `count`, `merge` |
+| `cache.bitmaps` | `setbit`, `getbit`, `count`, `op` |
+| `cache.streams` | `add`, `read`, `len`, `range`, `trim` |
+
+Access the raw `ioredis` client via `cache.raw`.
+
+---
+
+## Types
+
+All exported types from `@mono-labs/dev`:
+
+```typescript
+// LocalServer
+type ApiGatewayHandler
+type ALBHandler
+interface LocalServerConfig
+
+// WebSocket
+type ConnectionId
+type PostToConnectionFn
+interface SocketAdapterConfig
+interface RedisConfig
+type ConnectHandlerFn
+type DisconnectHandlerFn
+type ActionHandler
+interface ActionHandlerContext
+interface ActionHandlerResult
+interface LocalRequestContext
+interface WebSocketUserContext
+interface ChannelStore
+type EmitTarget
+
+// CacheRelay
+interface CacheRelay
+interface StringOps
+interface HashOps
+interface ListOps
+interface SetOps
+interface SortedSetOps
+interface KeyOps
+interface PubSubOps
+interface TransactionOps
+interface ScriptOps
+interface GeoOps
+interface HyperLogLogOps
+interface BitmapOps
+interface StreamOps
+```
+
+## Development
+
+Build the dev package:
+
+```bash
+yarn build:dev
+```
+
+This package has no internal `@mono-labs` dependencies -- it is independent in the dependency graph.
+
+See the [Contributing guide](../../CONTRIBUTING.md) for full development setup.

package/dist/cache-relay.d.ts.map

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

package/dist/cache-relay.js

@@ -269,7 +269,9 @@ function buildCacheRelay(redis) {
  * Requires `ioredis` as a peer dependency — throws a clear error if missing.
  */
 function initCacheRelay(connectionString) {
-    const connStr = connectionString ?? 'localhost:6379';
+    const raw = connectionString ?? 'localhost:6379';
+    // Normalize: bare hostname (no port) → hostname:6379
+    const connStr = raw.includes(':') ? raw : `${raw}:6379`;
     // Reuse existing instance when the connection string hasn't changed
     if (_cacheRelay && _currentConnectionString === connStr)
         return _cacheRelay;

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export type { ApiGatewayHandler, ALBHandler, LocalServerConfig } from './local-s
 export { attachSocketAdapter } from './websocket';
 export { ConnectionRegistry } from './websocket/connection-registry';
 export { ActionRouter } from './websocket/action-router';
-export { LocalGatewayClient } from './websocket/local-gateway-client';
+export { SocketGatewayClient } from './websocket/socket-gateway-client';
 export { InMemoryChannelStore, RedisChannelStore } from './websocket/channel-store';
 export { SocketEmitter } from './websocket/socket-emitter';
 export type { ConnectionId, PostToConnectionFn, SocketAdapterConfig, RedisConfig, ConnectHandlerFn, DisconnectHandlerFn, ActionHandler, ActionHandlerContext, ActionHandlerResult, LocalRequestContext, WebSocketUserContext, } from './websocket/types';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAG5F,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AACrE,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC1D,YAAY,EACX,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GACpB,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,YAAY,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAG5D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7D,YAAY,EACX,UAAU,EACV,SAAS,EACT,OAAO,EACP,OAAO,EACP,MAAM,EACN,YAAY,EACZ,MAAM,EACN,SAAS,EACT,cAAc,EACd,SAAS,EACT,MAAM,EACN,cAAc,EACd,SAAS,EACT,SAAS,GACT,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAG5F,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAA;AACvE,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC1D,YAAY,EACX,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GACpB,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,YAAY,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAG5D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7D,YAAY,EACX,UAAU,EACV,SAAS,EACT,OAAO,EACP,OAAO,EACP,MAAM,EACN,YAAY,EACZ,MAAM,EACN,SAAS,EACT,cAAc,EACd,SAAS,EACT,MAAM,EACN,cAAc,EACd,SAAS,EACT,SAAS,GACT,MAAM,eAAe,CAAA"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCacheRelay = exports.initCacheRelay = exports.SocketEmitter = exports.RedisChannelStore = exports.InMemoryChannelStore = exports.LocalGatewayClient = exports.ActionRouter = exports.ConnectionRegistry = exports.attachSocketAdapter = exports.LocalServer = void 0;
+exports.getCacheRelay = exports.initCacheRelay = exports.SocketEmitter = exports.RedisChannelStore = exports.InMemoryChannelStore = exports.SocketGatewayClient = exports.ActionRouter = exports.ConnectionRegistry = exports.attachSocketAdapter = exports.LocalServer = void 0;
 // Core
 var local_server_1 = require("./local-server");
 Object.defineProperty(exports, "LocalServer", { enumerable: true, get: function () { return local_server_1.LocalServer; } });
@@ -11,8 +11,8 @@ var connection_registry_1 = require("./websocket/connection-registry");
 Object.defineProperty(exports, "ConnectionRegistry", { enumerable: true, get: function () { return connection_registry_1.ConnectionRegistry; } });
 var action_router_1 = require("./websocket/action-router");
 Object.defineProperty(exports, "ActionRouter", { enumerable: true, get: function () { return action_router_1.ActionRouter; } });
-var local_gateway_client_1 = require("./websocket/local-gateway-client");
-Object.defineProperty(exports, "LocalGatewayClient", { enumerable: true, get: function () { return local_gateway_client_1.LocalGatewayClient; } });
+var socket_gateway_client_1 = require("./websocket/socket-gateway-client");
+Object.defineProperty(exports, "SocketGatewayClient", { enumerable: true, get: function () { return socket_gateway_client_1.SocketGatewayClient; } });
 var channel_store_1 = require("./websocket/channel-store");
 Object.defineProperty(exports, "InMemoryChannelStore", { enumerable: true, get: function () { return channel_store_1.InMemoryChannelStore; } });
 Object.defineProperty(exports, "RedisChannelStore", { enumerable: true, get: function () { return channel_store_1.RedisChannelStore; } });

package/dist/websocket/index.d.ts

@@ -5,7 +5,7 @@ import { SocketEmitter } from './socket-emitter';
 import type { SocketAdapterConfig } from './types';
 export type { ConnectionId, PostToConnectionFn, SocketAdapterConfig, RedisConfig } from './types';
 export { ConnectionRegistry } from './connection-registry';
-export { LocalGatewayClient } from './local-gateway-client';
+export { SocketGatewayClient } from './socket-gateway-client';
 export { ActionRouter } from './action-router';
 export { InMemoryChannelStore, RedisChannelStore } from './channel-store';
 export type { ChannelStore } from './channel-store';

package/dist/websocket/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/websocket/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,IAAI,CAAA;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAI1D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEhD,OAAO,KAAK,EAAgB,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAEhE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACjG,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACzE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,mBAAmB;;;;;;0BAgJ9D,SAAS;EAEhC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/websocket/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,IAAI,CAAA;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAI1D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEhD,OAAO,KAAK,EAAgB,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAEhE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACjG,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACzE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,mBAAmB;;;;;;0BAgJ9D,SAAS;EAEhC"}

package/dist/websocket/index.js

@@ -1,18 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SocketEmitter = exports.RedisChannelStore = exports.InMemoryChannelStore = exports.ActionRouter = exports.LocalGatewayClient = exports.ConnectionRegistry = void 0;
+exports.SocketEmitter = exports.RedisChannelStore = exports.InMemoryChannelStore = exports.ActionRouter = exports.SocketGatewayClient = exports.ConnectionRegistry = void 0;
 exports.attachSocketAdapter = attachSocketAdapter;
 const action_router_1 = require("./action-router");
 const connection_registry_1 = require("./connection-registry");
 const event_synthesizer_1 = require("./event-synthesizer");
-const local_gateway_client_1 = require("./local-gateway-client");
+const socket_gateway_client_1 = require("./socket-gateway-client");
 const channel_store_1 = require("./channel-store");
 const socket_emitter_1 = require("./socket-emitter");
 const cache_relay_1 = require("../cache-relay");
 var connection_registry_2 = require("./connection-registry");
 Object.defineProperty(exports, "ConnectionRegistry", { enumerable: true, get: function () { return connection_registry_2.ConnectionRegistry; } });
-var local_gateway_client_2 = require("./local-gateway-client");
-Object.defineProperty(exports, "LocalGatewayClient", { enumerable: true, get: function () { return local_gateway_client_2.LocalGatewayClient; } });
+var socket_gateway_client_2 = require("./socket-gateway-client");
+Object.defineProperty(exports, "SocketGatewayClient", { enumerable: true, get: function () { return socket_gateway_client_2.SocketGatewayClient; } });
 var action_router_2 = require("./action-router");
 Object.defineProperty(exports, "ActionRouter", { enumerable: true, get: function () { return action_router_2.ActionRouter; } });
 var channel_store_2 = require("./channel-store");
@@ -30,7 +30,7 @@ function attachSocketAdapter(wss, config) {
     const domainName = config?.domainName ?? 'localhost';
     const stage = config?.stage ?? 'local';
     const connectionRegistry = new connection_registry_1.ConnectionRegistry();
-    const gatewayClient = new local_gateway_client_1.LocalGatewayClient(connectionRegistry);
+    const gatewayClient = new socket_gateway_client_1.SocketGatewayClient(connectionRegistry);
     const postToConnection = gatewayClient.asFunction();
     const actionRouter = new action_router_1.ActionRouter();
     // Create channel store

package/dist/websocket/socket-gateway-client.d.ts

@@ -0,0 +1,20 @@
+import type { ConnectionId, PostToConnectionFn } from './types';
+import type { ConnectionRegistry } from './connection-registry';
+/**
+ * Unified gateway client that auto-detects local vs production mode.
+ *
+ * - Pass a `ConnectionRegistry` → local mode (sends via in-memory WebSocket)
+ * - Pass a URL string → API Gateway mode (sends via AWS SDK PostToConnectionCommand)
+ */
+export declare class SocketGatewayClient {
+    private mode;
+    private registry?;
+    private endpoint?;
+    constructor(backend: ConnectionRegistry | string);
+    postToConnection(connectionId: ConnectionId, data: unknown): Promise<void>;
+    private postLocal;
+    private postApiGateway;
+    /** Returns a bound PostToConnectionFn for dependency injection */
+    asFunction(): PostToConnectionFn;
+}
+//# sourceMappingURL=socket-gateway-client.d.ts.map

package/dist/websocket/socket-gateway-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-gateway-client.d.ts","sourceRoot":"","sources":["../../src/websocket/socket-gateway-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAE/D;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,IAAI,CAAwB;IACpC,OAAO,CAAC,QAAQ,CAAC,CAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,CAAQ;gBAEb,OAAO,EAAE,kBAAkB,GAAG,MAAM;IAU1C,gBAAgB,CAAC,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;YAOlE,SAAS;YAeT,cAAc;IAgC5B,kEAAkE;IAClE,UAAU,IAAI,kBAAkB;CAGhC"}

package/dist/websocket/socket-gateway-client.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SocketGatewayClient = void 0;
+/**
+ * Unified gateway client that auto-detects local vs production mode.
+ *
+ * - Pass a `ConnectionRegistry` → local mode (sends via in-memory WebSocket)
+ * - Pass a URL string → API Gateway mode (sends via AWS SDK PostToConnectionCommand)
+ */
+class SocketGatewayClient {
+    mode;
+    registry;
+    endpoint;
+    constructor(backend) {
+        if (typeof backend === 'string') {
+            this.mode = 'apigateway';
+            this.endpoint = backend;
+        }
+        else {
+            this.mode = 'local';
+            this.registry = backend;
+        }
+    }
+    async postToConnection(connectionId, data) {
+        if (this.mode === 'local') {
+            return this.postLocal(connectionId, data);
+        }
+        return this.postApiGateway(connectionId, data);
+    }
+    async postLocal(connectionId, data) {
+        const { WebSocket } = require('ws');
+        const ws = this.registry.get(connectionId);
+        if (!ws || ws.readyState !== WebSocket.OPEN) {
+            const error = new Error(`GoneException: Connection ${connectionId} is no longer available`);
+            error.statusCode = 410;
+            error.name = 'GoneException';
+            throw error;
+        }
+        const payload = typeof data === 'string' ? data : JSON.stringify(data);
+        ws.send(payload);
+    }
+    async postApiGateway(connectionId, data) {
+        let ApiGatewayManagementApiClient, PostToConnectionCommand;
+        try {
+            const mod = require('@aws-sdk/client-apigatewaymanagementapi');
+            ApiGatewayManagementApiClient = mod.ApiGatewayManagementApiClient;
+            PostToConnectionCommand = mod.PostToConnectionCommand;
+        }
+        catch {
+            throw new Error('API Gateway mode requires "@aws-sdk/client-apigatewaymanagementapi". '
+                + 'Install it with: npm install @aws-sdk/client-apigatewaymanagementapi');
+        }
+        const client = new ApiGatewayManagementApiClient({ endpoint: this.endpoint });
+        const payload = typeof data === 'string' ? data : JSON.stringify(data);
+        try {
+            await client.send(new PostToConnectionCommand({
+                ConnectionId: connectionId,
+                Data: new TextEncoder().encode(payload),
+            }));
+        }
+        catch (err) {
+            if (err.name === 'GoneException' || err.$metadata?.httpStatusCode === 410) {
+                const error = new Error(`GoneException: Connection ${connectionId} is no longer available`);
+                error.statusCode = 410;
+                error.name = 'GoneException';
+                throw error;
+            }
+            throw err;
+        }
+    }
+    /** Returns a bound PostToConnectionFn for dependency injection */
+    asFunction() {
+        return this.postToConnection.bind(this);
+    }
+}
+exports.SocketGatewayClient = SocketGatewayClient;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mono-labs/dev",
-  "version": "0.1.255",
+  "version": "0.1.257",
   "type": "commonjs",
   "description": "Local development server and WebSocket adapter for mono-labs",
   "main": "dist/index.js",
@@ -27,11 +27,15 @@
     "ws": "^8.18.0"
   },
   "peerDependencies": {
-    "ioredis": ">=5.0.0"
+    "ioredis": ">=5.0.0",
+    "@aws-sdk/client-apigatewaymanagementapi": ">=3.0.0"
   },
   "peerDependenciesMeta": {
     "ioredis": {
       "optional": true
+    },
+    "@aws-sdk/client-apigatewaymanagementapi": {
+      "optional": true
     }
   },
   "devDependencies": {

package/src/cache-relay.ts

@@ -452,7 +452,10 @@ function buildCacheRelay(redis: RedisClient): CacheRelay {
  * Requires `ioredis` as a peer dependency — throws a clear error if missing.
  */
 export function initCacheRelay(connectionString?: string): CacheRelay {
-	const connStr = connectionString ?? 'localhost:6379'
+	const raw = connectionString ?? 'localhost:6379'
+
+	// Normalize: bare hostname (no port) → hostname:6379
+	const connStr = raw.includes(':') ? raw : `${raw}:6379`
 
 	// Reuse existing instance when the connection string hasn't changed
 	if (_cacheRelay && _currentConnectionString === connStr) return _cacheRelay

package/src/index.ts

@@ -6,7 +6,7 @@ export type { ApiGatewayHandler, ALBHandler, LocalServerConfig } from './local-s
 export { attachSocketAdapter } from './websocket'
 export { ConnectionRegistry } from './websocket/connection-registry'
 export { ActionRouter } from './websocket/action-router'
-export { LocalGatewayClient } from './websocket/local-gateway-client'
+export { SocketGatewayClient } from './websocket/socket-gateway-client'
 export { InMemoryChannelStore, RedisChannelStore } from './websocket/channel-store'
 export { SocketEmitter } from './websocket/socket-emitter'
 export type {

package/src/websocket/index.ts

@@ -3,7 +3,7 @@ import type { WebSocket, WebSocketServer } from 'ws'
 import { ActionRouter } from './action-router'
 import { ConnectionRegistry } from './connection-registry'
 import { buildRequestContext } from './event-synthesizer'
-import { LocalGatewayClient } from './local-gateway-client'
+import { SocketGatewayClient } from './socket-gateway-client'
 import { InMemoryChannelStore, RedisChannelStore } from './channel-store'
 import { SocketEmitter } from './socket-emitter'
 import { initCacheRelay } from '../cache-relay'
@@ -11,7 +11,7 @@ import type { ConnectionId, SocketAdapterConfig } from './types'
 
 export type { ConnectionId, PostToConnectionFn, SocketAdapterConfig, RedisConfig } from './types'
 export { ConnectionRegistry } from './connection-registry'
-export { LocalGatewayClient } from './local-gateway-client'
+export { SocketGatewayClient } from './socket-gateway-client'
 export { ActionRouter } from './action-router'
 export { InMemoryChannelStore, RedisChannelStore } from './channel-store'
 export type { ChannelStore } from './channel-store'
@@ -29,7 +29,7 @@ export function attachSocketAdapter(wss: WebSocketServer, config?: SocketAdapter
 	const stage = config?.stage ?? 'local'
 
 	const connectionRegistry = new ConnectionRegistry()
-	const gatewayClient = new LocalGatewayClient(connectionRegistry)
+	const gatewayClient = new SocketGatewayClient(connectionRegistry)
 	const postToConnection = gatewayClient.asFunction()
 	const actionRouter = new ActionRouter()
 

package/src/websocket/socket-gateway-client.ts

@@ -0,0 +1,83 @@
+import type { ConnectionId, PostToConnectionFn } from './types'
+import type { ConnectionRegistry } from './connection-registry'
+
+/**
+ * Unified gateway client that auto-detects local vs production mode.
+ *
+ * - Pass a `ConnectionRegistry` → local mode (sends via in-memory WebSocket)
+ * - Pass a URL string → API Gateway mode (sends via AWS SDK PostToConnectionCommand)
+ */
+export class SocketGatewayClient {
+	private mode: 'local' | 'apigateway'
+	private registry?: ConnectionRegistry
+	private endpoint?: string
+
+	constructor(backend: ConnectionRegistry | string) {
+		if (typeof backend === 'string') {
+			this.mode = 'apigateway'
+			this.endpoint = backend
+		} else {
+			this.mode = 'local'
+			this.registry = backend
+		}
+	}
+
+	async postToConnection(connectionId: ConnectionId, data: unknown): Promise<void> {
+		if (this.mode === 'local') {
+			return this.postLocal(connectionId, data)
+		}
+		return this.postApiGateway(connectionId, data)
+	}
+
+	private async postLocal(connectionId: ConnectionId, data: unknown): Promise<void> {
+		const { WebSocket } = require('ws') as typeof import('ws')
+		const ws = this.registry!.get(connectionId)
+
+		if (!ws || ws.readyState !== WebSocket.OPEN) {
+			const error = new Error(`GoneException: Connection ${connectionId} is no longer available`)
+			;(error as any).statusCode = 410
+			;(error as any).name = 'GoneException'
+			throw error
+		}
+
+		const payload = typeof data === 'string' ? data : JSON.stringify(data)
+		ws.send(payload)
+	}
+
+	private async postApiGateway(connectionId: ConnectionId, data: unknown): Promise<void> {
+		let ApiGatewayManagementApiClient: any, PostToConnectionCommand: any
+		try {
+			const mod = require('@aws-sdk/client-apigatewaymanagementapi')
+			ApiGatewayManagementApiClient = mod.ApiGatewayManagementApiClient
+			PostToConnectionCommand = mod.PostToConnectionCommand
+		} catch {
+			throw new Error(
+				'API Gateway mode requires "@aws-sdk/client-apigatewaymanagementapi". '
+				+ 'Install it with: npm install @aws-sdk/client-apigatewaymanagementapi'
+			)
+		}
+
+		const client = new ApiGatewayManagementApiClient({ endpoint: this.endpoint })
+		const payload = typeof data === 'string' ? data : JSON.stringify(data)
+
+		try {
+			await client.send(new PostToConnectionCommand({
+				ConnectionId: connectionId,
+				Data: new TextEncoder().encode(payload),
+			}))
+		} catch (err: any) {
+			if (err.name === 'GoneException' || err.$metadata?.httpStatusCode === 410) {
+				const error = new Error(`GoneException: Connection ${connectionId} is no longer available`)
+				;(error as any).statusCode = 410
+				;(error as any).name = 'GoneException'
+				throw error
+			}
+			throw err
+		}
+	}
+
+	/** Returns a bound PostToConnectionFn for dependency injection */
+	asFunction(): PostToConnectionFn {
+		return this.postToConnection.bind(this)
+	}
+}

package/src/websocket/local-gateway-client.ts

@@ -1,31 +0,0 @@
-import { WebSocket } from 'ws'
-import type { ConnectionRegistry } from './connection-registry'
-import type { ConnectionId, PostToConnectionFn } from './types'
-
-/**
- * Local replacement for @aws-sdk/client-apigatewaymanagementapi.
- * Looks up the WebSocket in ConnectionRegistry and sends data directly.
- */
-export class LocalGatewayClient {
-	constructor(private registry: ConnectionRegistry) {}
-
-	/** Send data to a specific connection. Throws GoneException (410) if not found. */
-	async postToConnection(connectionId: ConnectionId, data: unknown): Promise<void> {
-		const ws = this.registry.get(connectionId)
-
-		if (!ws || ws.readyState !== WebSocket.OPEN) {
-			const error = new Error(`GoneException: Connection ${connectionId} is no longer available`)
-			;(error as any).statusCode = 410
-			;(error as any).name = 'GoneException'
-			throw error
-		}
-
-		const payload = typeof data === 'string' ? data : JSON.stringify(data)
-		ws.send(payload)
-	}
-
-	/** Returns a bound PostToConnectionFn for dependency injection */
-	asFunction(): PostToConnectionFn {
-		return this.postToConnection.bind(this)
-	}
-}