raffel 1.0.9 → 1.0.10-next.22f4d4e

package/dist/channels/history.js

@@ -0,0 +1,78 @@
+/**
+ * Channel History
+ *
+ * Pluggable message history for channel catchup on reconnect.
+ * Stores recent messages per channel in a circular buffer.
+ */
+/**
+ * Create an in-memory history store with circular buffer per channel
+ */
+export function createMemoryHistoryStore(options = {}) {
+    const { maxSize = 100, ttl = 300_000, gcInterval = 30_000, } = options;
+    /** Per-channel circular buffer */
+    const buffers = new Map();
+    // Periodic GC for expired entries
+    const timer = setInterval(() => {
+        const now = Date.now();
+        for (const [channel, entries] of buffers) {
+            const filtered = entries.filter((e) => now - e.timestamp < ttl);
+            if (filtered.length === 0) {
+                buffers.delete(channel);
+            }
+            else if (filtered.length < entries.length) {
+                buffers.set(channel, filtered);
+            }
+        }
+    }, gcInterval);
+    if (timer.unref)
+        timer.unref();
+    return {
+        append(entry) {
+            let buffer = buffers.get(entry.channel);
+            if (!buffer) {
+                buffer = [];
+                buffers.set(entry.channel, buffer);
+            }
+            buffer.push(entry);
+            // Circular: trim to maxSize
+            if (buffer.length > maxSize) {
+                buffers.set(entry.channel, buffer.slice(buffer.length - maxSize));
+            }
+        },
+        getAfterSeq(channel, sinceSeq, epoch, limit) {
+            const buffer = buffers.get(channel);
+            if (!buffer || buffer.length === 0)
+                return [];
+            const now = Date.now();
+            const results = [];
+            for (const entry of buffer) {
+                // Must match epoch
+                if (entry.epoch !== epoch)
+                    continue;
+                // Must be after sinceSeq
+                if (entry.seq <= sinceSeq)
+                    continue;
+                // Must not be expired
+                if (now - entry.timestamp >= ttl)
+                    continue;
+                results.push(entry);
+                if (limit && results.length >= limit)
+                    break;
+            }
+            return results;
+        },
+        trim(channel, trimSize) {
+            const buffer = buffers.get(channel);
+            if (!buffer)
+                return;
+            if (buffer.length > trimSize) {
+                buffers.set(channel, buffer.slice(buffer.length - trimSize));
+            }
+        },
+        dispose() {
+            clearInterval(timer);
+            buffers.clear();
+        },
+    };
+}
+//# sourceMappingURL=history.js.map

package/dist/channels/history.js.map

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

package/dist/channels/index.d.ts

@@ -43,5 +43,13 @@
  */
 export { createChannelManager } from './channel-manager.js';
 export type { SendToSocketFn } from './channel-manager.js';
-export { type ChannelType, type ChannelOptions, type ChannelMember, type ChannelState, type ChannelManager, type SubscribeResult, type ClientInfo, type RoomInfo, type GroupInfo, type ChannelLifecycleHooks, type ClientConnectEvent, type ClientDisconnectEvent, type SubscribeMessage, type SubscribedMessage, type UnsubscribeMessage, type UnsubscribedMessage, type PublishMessage, type ChannelEventMessage, type ChannelErrorMessage, type ChannelMessage, isChannelMessage, getChannelType, requiresAuth, } from './types.js';
+export { createMemoryTicketStore, generateTicket } from './ticket-store.js';
+export type { MemoryTicketStoreOptions } from './ticket-store.js';
+export { createMemoryHistoryStore } from './history.js';
+export type { ChannelHistoryEntry, ChannelHistoryPort, MemoryHistoryStoreOptions, } from './history.js';
+export { createMemoryRecoveryStore, generateRecoveryToken } from './recovery.js';
+export type { RecoverableSession, ConnectionRecoveryPort, MemoryRecoveryStoreOptions, } from './recovery.js';
+export { createChannelRestApi } from './rest-api.js';
+export type { ChannelRestApiOptions } from './rest-api.js';
+export { type ChannelType, type ChannelOptions, type ChannelMember, type ChannelState, type ChannelManager, type SubscribeResult, type ClientInfo, type RoomInfo, type GroupInfo, type ChannelLifecycleHooks, type ClientConnectEvent, type ClientDisconnectEvent, type ConnectionTicket, type TicketStore, type WebSocketAuthConfig, type ChannelRateLimits, type BackpressureConfig, type AuthRefreshMessage, type AuthRefreshedMessage, type RecoverMessage, type SubscribeMessage, type SubscribedMessage, type UnsubscribeMessage, type UnsubscribedMessage, type PublishMessage, type ChannelEventMessage, type ChannelErrorMessage, type ChannelMessage, type BatchSubscribeMessage, type BatchSubscribedMessage, type BatchPublishMessage, type TypingMessage, isChannelMessage, isRecoverMessage, getChannelType, requiresAuth, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAG1B,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EAGnB,gBAAgB,EAChB,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAC3E,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AAGjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAA;AACvD,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAChF,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,eAAe,CAAA;AAGtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACpD,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAE1D,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EAGnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EAGnB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EAGxB,KAAK,aAAa,EAGlB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAA"}

package/dist/channels/index.js

@@ -42,7 +42,14 @@
  * ```
  */
 export { createChannelManager } from './channel-manager.js';
+export { createMemoryTicketStore, generateTicket } from './ticket-store.js';
+// History
+export { createMemoryHistoryStore } from './history.js';
+// Recovery
+export { createMemoryRecoveryStore, generateRecoveryToken } from './recovery.js';
+// REST API
+export { createChannelRestApi } from './rest-api.js';
 export { 
 // Helpers
-isChannelMessage, getChannelType, requiresAuth, } from './types.js';
+isChannelMessage, isRecoverMessage, getChannelType, requiresAuth, } from './types.js';
 //# sourceMappingURL=index.js.map

package/dist/channels/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAG3D,OAAO;AAyBL,UAAU;AACV,gBAAgB,EAChB,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAE3D,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAG3E,UAAU;AACV,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAA;AAOvD,WAAW;AACX,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAOhF,WAAW;AACX,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAGpD,OAAO;AAyCL,UAAU;AACV,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAA"}

package/dist/channels/recovery.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Connection State Recovery
+ *
+ * Saves session state on disconnect and restores on reconnect,
+ * allowing clients to recover subscriptions and replay missed messages.
+ */
+/**
+ * Saved session state for recovery
+ */
+export interface RecoverableSession {
+    /** Opaque recovery token given to the client */
+    recoveryToken: string;
+    /** Original socket ID */
+    socketId: string;
+    /** User ID (if authenticated) */
+    userId?: string;
+    /** Channels the client was subscribed to, with last seen seq */
+    channels: {
+        name: string;
+        lastSeq: number;
+    }[];
+    /** Groups the client belonged to */
+    groups: string[];
+    /** Custom metadata */
+    metadata: Record<string, unknown>;
+    /** When this session expires */
+    expiresAt: number;
+}
+/**
+ * Port interface for pluggable recovery storage
+ */
+export interface ConnectionRecoveryPort {
+    /** Save a recoverable session */
+    save(session: RecoverableSession): void;
+    /** Get a session by recovery token */
+    get(recoveryToken: string): RecoverableSession | null;
+    /** Delete a session (consumed or expired) */
+    delete(recoveryToken: string): void;
+}
+export interface MemoryRecoveryStoreOptions {
+    /** TTL in ms for recovery sessions (default: 120000 = 2 minutes) */
+    ttl?: number;
+    /** GC interval in ms (default: 30000) */
+    gcInterval?: number;
+}
+/**
+ * Create an in-memory recovery store with TTL and periodic GC
+ */
+export declare function createMemoryRecoveryStore(options?: MemoryRecoveryStoreOptions): ConnectionRecoveryPort & {
+    dispose(): void;
+    size: number;
+};
+/**
+ * Generate a recovery token
+ */
+export declare function generateRecoveryToken(): string;
+//# sourceMappingURL=recovery.d.ts.map

package/dist/channels/recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../../src/channels/recovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAA;IACrB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gEAAgE;IAChE,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC7C,oCAAoC;IACpC,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,iCAAiC;IACjC,IAAI,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAA;IACvC,sCAAsC;IACtC,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAAA;IACrD,6CAA6C;IAC7C,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CACpC;AAID,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,0BAA+B,GACvC,sBAAsB,GAAG;IAAE,OAAO,IAAI,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAmD5D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}

package/dist/channels/recovery.js

@@ -0,0 +1,58 @@
+/**
+ * Connection State Recovery
+ *
+ * Saves session state on disconnect and restores on reconnect,
+ * allowing clients to recover subscriptions and replay missed messages.
+ */
+import { sid } from '../utils/id/index.js';
+/**
+ * Create an in-memory recovery store with TTL and periodic GC
+ */
+export function createMemoryRecoveryStore(options = {}) {
+    const { ttl = 120_000, gcInterval = 30_000, } = options;
+    const sessions = new Map();
+    // Periodic GC for expired sessions
+    const timer = setInterval(() => {
+        const now = Date.now();
+        for (const [token, session] of sessions) {
+            if (session.expiresAt < now) {
+                sessions.delete(token);
+            }
+        }
+    }, gcInterval);
+    if (timer.unref)
+        timer.unref();
+    return {
+        save(session) {
+            sessions.set(session.recoveryToken, session);
+        },
+        get(recoveryToken) {
+            const session = sessions.get(recoveryToken);
+            if (!session)
+                return null;
+            // Check expiration
+            if (session.expiresAt < Date.now()) {
+                sessions.delete(recoveryToken);
+                return null;
+            }
+            return session;
+        },
+        delete(recoveryToken) {
+            sessions.delete(recoveryToken);
+        },
+        dispose() {
+            clearInterval(timer);
+            sessions.clear();
+        },
+        get size() {
+            return sessions.size;
+        },
+    };
+}
+/**
+ * Generate a recovery token
+ */
+export function generateRecoveryToken() {
+    return `rec_${sid()}`;
+}
+//# sourceMappingURL=recovery.js.map

package/dist/channels/recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.js","sourceRoot":"","sources":["../../src/channels/recovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAA;AA6C1C;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,UAAsC,EAAE;IAExC,MAAM,EACJ,GAAG,GAAG,OAAO,EACb,UAAU,GAAG,MAAM,GACpB,GAAG,OAAO,CAAA;IAEX,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA8B,CAAA;IAEtD,mCAAmC;IACnC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,QAAQ,EAAE,CAAC;YACxC,IAAI,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;gBAC5B,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACxB,CAAC;QACH,CAAC;IACH,CAAC,EAAE,UAAU,CAAC,CAAA;IAEd,IAAI,KAAK,CAAC,KAAK;QAAE,KAAK,CAAC,KAAK,EAAE,CAAA;IAE9B,OAAO;QACL,IAAI,CAAC,OAA2B;YAC9B,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;QAC9C,CAAC;QAED,GAAG,CAAC,aAAqB;YACvB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;YAC3C,IAAI,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAA;YAEzB,mBAAmB;YACnB,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBACnC,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;gBAC9B,OAAO,IAAI,CAAA;YACb,CAAC;YAED,OAAO,OAAO,CAAA;QAChB,CAAC;QAED,MAAM,CAAC,aAAqB;YAC1B,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;QAChC,CAAC;QAED,OAAO;YACL,aAAa,CAAC,KAAK,CAAC,CAAA;YACpB,QAAQ,CAAC,KAAK,EAAE,CAAA;QAClB,CAAC;QAED,IAAI,IAAI;YACN,OAAO,QAAQ,CAAC,IAAI,CAAA;QACtB,CAAC;KACF,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,OAAO,GAAG,EAAE,EAAE,CAAA;AACvB,CAAC"}

package/dist/channels/rest-api.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Channel REST API
+ *
+ * HTTP middleware for server-side channel management.
+ * Allows publishing events, listing channels, and sending
+ * messages to specific clients via HTTP endpoints.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { ChannelManager } from './types.js';
+export interface ChannelRestApiOptions {
+    /** Base path for REST endpoints (default: '/channels') */
+    path?: string;
+    /** API key for authentication */
+    apiKey?: string;
+    /** Custom auth function (overrides apiKey) */
+    auth?: (req: IncomingMessage) => boolean | Promise<boolean>;
+}
+/**
+ * Create HTTP middleware for channel REST API.
+ *
+ * Returns an `HttpMiddleware` compatible with the Raffel adapter layer:
+ * `(req, res) => boolean | Promise<boolean>` — returns true if handled.
+ *
+ * Endpoints:
+ * - POST /<path>/:channel/events — broadcast to channel
+ * - GET  /<path> — list active channels
+ * - GET  /<path>/:channel — channel info
+ * - POST /<path>/clients/:socketId/events — send to specific client
+ * - POST /<path>/broadcast — broadcast to all
+ */
+export declare function createChannelRestApi(manager: ChannelManager, options?: ChannelRestApiOptions): (req: IncomingMessage, res: ServerResponse) => boolean | Promise<boolean>;
+//# sourceMappingURL=rest-api.d.ts.map

package/dist/channels/rest-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-api.d.ts","sourceRoot":"","sources":["../../src/channels/rest-api.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAGhD,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8CAA8C;IAC9C,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC5D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,qBAA0B,GAClC,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CA4M3E"}

package/dist/channels/rest-api.js

@@ -0,0 +1,197 @@
+/**
+ * Channel REST API
+ *
+ * HTTP middleware for server-side channel management.
+ * Allows publishing events, listing channels, and sending
+ * messages to specific clients via HTTP endpoints.
+ */
+import { getChannelType } from './types.js';
+/**
+ * Create HTTP middleware for channel REST API.
+ *
+ * Returns an `HttpMiddleware` compatible with the Raffel adapter layer:
+ * `(req, res) => boolean | Promise<boolean>` — returns true if handled.
+ *
+ * Endpoints:
+ * - POST /<path>/:channel/events — broadcast to channel
+ * - GET  /<path> — list active channels
+ * - GET  /<path>/:channel — channel info
+ * - POST /<path>/clients/:socketId/events — send to specific client
+ * - POST /<path>/broadcast — broadcast to all
+ */
+export function createChannelRestApi(manager, options = {}) {
+    const basePath = (options.path ?? '/channels').replace(/\/+$/, '');
+    /**
+     * Check authorization
+     */
+    async function checkAuth(req, res) {
+        if (options.auth) {
+            const allowed = await options.auth(req);
+            if (!allowed) {
+                sendJson(res, 401, { error: 'Unauthorized' });
+                return false;
+            }
+            return true;
+        }
+        if (options.apiKey) {
+            const auth = req.headers['authorization'];
+            if (auth !== `Bearer ${options.apiKey}`) {
+                sendJson(res, 401, { error: 'Invalid API key' });
+                return false;
+            }
+            return true;
+        }
+        // No auth configured — allow all
+        return true;
+    }
+    function sendJson(res, status, body) {
+        res.writeHead(status, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify(body));
+    }
+    function readBody(req) {
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            req.on('data', (chunk) => chunks.push(chunk));
+            req.on('end', () => {
+                try {
+                    const raw = Buffer.concat(chunks).toString('utf-8');
+                    resolve(raw ? JSON.parse(raw) : {});
+                }
+                catch (err) {
+                    reject(err);
+                }
+            });
+            req.on('error', reject);
+        });
+    }
+    /**
+     * Parse URL pathname and extract route match
+     */
+    function matchRoute(pathname, method) {
+        // Normalize
+        const path = pathname.replace(/\/+$/, '') || '/';
+        // POST /channels/broadcast
+        if (method === 'POST' && path === `${basePath}/broadcast`) {
+            return { route: 'broadcast' };
+        }
+        // POST /channels/clients/:socketId/events
+        const clientEventsMatch = path.match(new RegExp(`^${escapeRegExp(basePath)}/clients/([^/]+)/events$`));
+        if (method === 'POST' && clientEventsMatch) {
+            return { route: 'client-events', socketId: clientEventsMatch[1] };
+        }
+        // POST /channels/:channel/events
+        const channelEventsMatch = path.match(new RegExp(`^${escapeRegExp(basePath)}/([^/]+)/events$`));
+        if (method === 'POST' && channelEventsMatch) {
+            return { route: 'channel-events', channel: decodeURIComponent(channelEventsMatch[1]) };
+        }
+        // GET /channels/:channel
+        const channelInfoMatch = path.match(new RegExp(`^${escapeRegExp(basePath)}/([^/]+)$`));
+        if (method === 'GET' && channelInfoMatch) {
+            // Exclude reserved sub-paths
+            const segment = channelInfoMatch[1];
+            if (segment === 'broadcast' || segment === 'clients') {
+                return null;
+            }
+            return { route: 'channel-info', channel: decodeURIComponent(segment) };
+        }
+        // GET /channels
+        if (method === 'GET' && path === basePath) {
+            return { route: 'list-channels' };
+        }
+        return null;
+    }
+    return async function channelRestApiMiddleware(req, res) {
+        const url = new URL(req.url || '/', 'http://localhost');
+        const method = req.method?.toUpperCase() ?? 'GET';
+        const match = matchRoute(url.pathname, method);
+        if (!match)
+            return false;
+        // Auth check
+        const authed = await checkAuth(req, res);
+        if (!authed)
+            return true; // Already sent 401
+        try {
+            if (match.route === 'list-channels') {
+                const channelNames = manager.getChannels();
+                const result = channelNames.map((name) => ({
+                    name,
+                    type: getChannelType(name),
+                    subscriberCount: manager.getSubscriberCount(name),
+                }));
+                sendJson(res, 200, { channels: result });
+                return true;
+            }
+            if (match.route === 'channel-info') {
+                const name = match.channel;
+                if (!manager.hasChannel(name)) {
+                    sendJson(res, 404, { error: 'Channel not found' });
+                    return true;
+                }
+                const type = getChannelType(name);
+                const info = {
+                    name,
+                    type,
+                    subscriberCount: manager.getSubscriberCount(name),
+                    subscribers: manager.getSubscribers(name),
+                };
+                if (type === 'presence') {
+                    info.members = manager.getMembers(name);
+                }
+                sendJson(res, 200, info);
+                return true;
+            }
+            if (match.route === 'channel-events') {
+                const body = (await readBody(req));
+                const event = body.event;
+                const data = body.data;
+                const except = body.except;
+                if (!event) {
+                    sendJson(res, 400, { error: 'Missing event field' });
+                    return true;
+                }
+                manager.broadcast(match.channel, event, data, except);
+                sendJson(res, 200, { ok: true });
+                return true;
+            }
+            if (match.route === 'client-events') {
+                const body = (await readBody(req));
+                const event = body.event;
+                const data = body.data;
+                if (!event) {
+                    sendJson(res, 400, { error: 'Missing event field' });
+                    return true;
+                }
+                const client = manager.getClient(match.socketId);
+                if (!client) {
+                    sendJson(res, 404, { error: 'Client not found' });
+                    return true;
+                }
+                manager.sendToClient(match.socketId, event, data);
+                sendJson(res, 200, { ok: true });
+                return true;
+            }
+            if (match.route === 'broadcast') {
+                const body = (await readBody(req));
+                const event = body.event;
+                const data = body.data;
+                const except = body.except;
+                if (!event) {
+                    sendJson(res, 400, { error: 'Missing event field' });
+                    return true;
+                }
+                manager.broadcastAll(event, data, except);
+                sendJson(res, 200, { ok: true });
+                return true;
+            }
+        }
+        catch (err) {
+            sendJson(res, 500, { error: 'Internal server error' });
+            return true;
+        }
+        return false;
+    };
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=rest-api.js.map

package/dist/channels/rest-api.js.map

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

package/dist/channels/ticket-store.d.ts

@@ -0,0 +1,25 @@
+/**
+ * In-Memory Ticket Store
+ *
+ * Default implementation of TicketStore for connection ticket auth.
+ * Tickets are single-use, short-lived tokens generated via HTTP
+ * and consumed on WebSocket connect.
+ */
+import type { ConnectionTicket, TicketStore } from './types.js';
+export interface MemoryTicketStoreOptions {
+    /** GC interval in ms (default: 10000) */
+    gcInterval?: number;
+}
+export declare function createMemoryTicketStore(options?: MemoryTicketStoreOptions): TicketStore & {
+    dispose(): void;
+    size: number;
+};
+/**
+ * Helper: generate a ticket for a user
+ */
+export declare function generateTicket(userId: string, options?: {
+    ttl?: number;
+    permissions?: string[];
+    metadata?: Record<string, unknown>;
+}): ConnectionTicket;
+//# sourceMappingURL=ticket-store.d.ts.map

package/dist/channels/ticket-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket-store.d.ts","sourceRoot":"","sources":["../../src/channels/ticket-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE/D,MAAM,WAAW,wBAAwB;IACvC,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,wBAA6B,GACrC,WAAW,GAAG;IAAE,OAAO,IAAI,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAuDjD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IACR,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC,GACA,gBAAgB,CASlB"}

package/dist/channels/ticket-store.js

@@ -0,0 +1,70 @@
+/**
+ * In-Memory Ticket Store
+ *
+ * Default implementation of TicketStore for connection ticket auth.
+ * Tickets are single-use, short-lived tokens generated via HTTP
+ * and consumed on WebSocket connect.
+ */
+import { sid } from '../utils/id/index.js';
+export function createMemoryTicketStore(options = {}) {
+    const { gcInterval = 10_000 } = options;
+    const tickets = new Map();
+    // Periodic GC for expired tickets
+    const timer = setInterval(() => {
+        const now = Date.now();
+        for (const [id, ticket] of tickets) {
+            if (ticket.expiresAt < now || ticket.usedAt) {
+                tickets.delete(id);
+            }
+        }
+    }, gcInterval);
+    if (timer.unref)
+        timer.unref();
+    return {
+        async create(ticket) {
+            tickets.set(ticket.id, { ...ticket });
+        },
+        async consume(ticketId) {
+            const ticket = tickets.get(ticketId);
+            if (!ticket)
+                return null;
+            // Check expiration
+            if (ticket.expiresAt < Date.now()) {
+                tickets.delete(ticketId);
+                return null;
+            }
+            // Check single-use
+            if (ticket.usedAt) {
+                return null;
+            }
+            // Mark as used and return
+            ticket.usedAt = Date.now();
+            tickets.delete(ticketId); // Remove after consumption
+            return ticket;
+        },
+        async revoke(ticketId) {
+            tickets.delete(ticketId);
+        },
+        dispose() {
+            clearInterval(timer);
+            tickets.clear();
+        },
+        get size() {
+            return tickets.size;
+        },
+    };
+}
+/**
+ * Helper: generate a ticket for a user
+ */
+export function generateTicket(userId, options) {
+    const ttl = options?.ttl ?? 30_000;
+    return {
+        id: sid(),
+        userId,
+        permissions: options?.permissions,
+        expiresAt: Date.now() + ttl,
+        metadata: options?.metadata,
+    };
+}
+//# sourceMappingURL=ticket-store.js.map

package/dist/channels/ticket-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket-store.js","sourceRoot":"","sources":["../../src/channels/ticket-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAA;AAQ1C,MAAM,UAAU,uBAAuB,CACrC,UAAoC,EAAE;IAEtC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE,GAAG,OAAO,CAAA;IACvC,MAAM,OAAO,GAAG,IAAI,GAAG,EAA4B,CAAA;IAEnD,kCAAkC;IAClC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACnC,IAAI,MAAM,CAAC,SAAS,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC5C,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YACpB,CAAC;QACH,CAAC;IACH,CAAC,EAAE,UAAU,CAAC,CAAA;IAEd,IAAI,KAAK,CAAC,KAAK;QAAE,KAAK,CAAC,KAAK,EAAE,CAAA;IAE9B,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,MAAwB;YACnC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;QACvC,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,QAAgB;YAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YACpC,IAAI,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAA;YAExB,mBAAmB;YACnB,IAAI,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBAClC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;gBACxB,OAAO,IAAI,CAAA;YACb,CAAC;YAED,mBAAmB;YACnB,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,OAAO,IAAI,CAAA;YACb,CAAC;YAED,0BAA0B;YAC1B,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA,CAAC,2BAA2B;YACpD,OAAO,MAAM,CAAA;QACf,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,QAAgB;YAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QAC1B,CAAC;QAED,OAAO;YACL,aAAa,CAAC,KAAK,CAAC,CAAA;YACpB,OAAO,CAAC,KAAK,EAAE,CAAA;QACjB,CAAC;QAED,IAAI,IAAI;YACN,OAAO,OAAO,CAAC,IAAI,CAAA;QACrB,CAAC;KACF,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,OAIC;IAED,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,MAAM,CAAA;IAClC,OAAO;QACL,EAAE,EAAE,GAAG,EAAE;QACT,MAAM;QACN,WAAW,EAAE,OAAO,EAAE,WAAW;QACjC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG;QAC3B,QAAQ,EAAE,OAAO,EAAE,QAAQ;KAC5B,CAAA;AACH,CAAC"}