@fluojs/websockets 1.0.0-beta.1

package/dist/cloudflare-workers/cloudflare-workers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare-workers.d.ts","sourceRoot":"","sources":["../../src/cloudflare-workers/cloudflare-workers.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC"}

package/dist/cloudflare-workers/cloudflare-workers.js

@@ -0,0 +1,3 @@
+export * from './cloudflare-workers-module.js';
+export * from './cloudflare-workers-service.js';
+export * from './cloudflare-workers-types.js';

package/dist/cloudflare-workers.d.ts

@@ -0,0 +1,2 @@
+export * from './cloudflare-workers/cloudflare-workers.js';
+//# sourceMappingURL=cloudflare-workers.d.ts.map

package/dist/cloudflare-workers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare-workers.d.ts","sourceRoot":"","sources":["../src/cloudflare-workers.ts"],"names":[],"mappings":"AAAA,cAAc,4CAA4C,CAAC"}

package/dist/cloudflare-workers.js

@@ -0,0 +1 @@
+export * from './cloudflare-workers/cloudflare-workers.js';

package/dist/decorators.d.ts

@@ -0,0 +1,56 @@
+import type { WebSocketEventMap, WebSocketGatewayOptions } from './types.js';
+type StandardClassDecoratorFn = (value: Function, context: ClassDecoratorContext) => void;
+type StandardMethodDecoratorFn = (value: Function, context: ClassMethodDecoratorContext) => void;
+type ClassDecoratorLike = StandardClassDecoratorFn;
+type MethodDecoratorLike = StandardMethodDecoratorFn;
+/**
+ * Marks a class as a WebSocket gateway discovered during module bootstrap.
+ *
+ * @param options Gateway path and optional server-backed listener configuration.
+ * @returns A class decorator that stores gateway metadata for runtime discovery.
+ *
+ * @example
+ * ```ts
+ * import { WebSocketGateway } from '@fluojs/websockets';
+ *
+ * @WebSocketGateway({ path: '/chat' })
+ * class ChatGateway {}
+ * ```
+ *
+ * @remarks
+ * Multiple gateways may share one `path`; handlers run in discovery order.
+ */
+export declare function WebSocketGateway(options?: WebSocketGatewayOptions): ClassDecoratorLike;
+/**
+ * Registers a method as an inbound message handler for a gateway.
+ *
+ * @param event Optional event name filter. When omitted, the runtime treats the handler as a generic message listener.
+ * @returns A method decorator that records message-handler metadata for the gateway.
+ *
+ * @example
+ * ```ts
+ * import { OnMessage } from '@fluojs/websockets';
+ *
+ * class ChatGateway {
+ *   @OnMessage('ping')
+ *   handlePing(payload: unknown) {
+ *     return payload;
+ *   }
+ * }
+ * ```
+ */
+export declare function OnMessage<TEvents extends WebSocketEventMap = WebSocketEventMap, K extends keyof TEvents = keyof TEvents>(event?: K & string): MethodDecoratorLike;
+/**
+ * Registers a method that runs when one client connection is established.
+ *
+ * @returns A method decorator that records a connection lifecycle handler.
+ */
+export declare function OnConnect(): MethodDecoratorLike;
+/**
+ * Registers a method that runs when one client disconnects from the gateway.
+ *
+ * @returns A method decorator that records a disconnection lifecycle handler.
+ */
+export declare function OnDisconnect(): MethodDecoratorLike;
+export {};
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAmC,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAG9G,KAAK,wBAAwB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAC1F,KAAK,yBAAyB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,2BAA2B,KAAK,IAAI,CAAC;AACjG,KAAK,kBAAkB,GAAG,wBAAwB,CAAC;AACnD,KAAK,mBAAmB,GAAG,yBAAyB,CAAC;AA6DrD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,GAAE,uBAA4B,GACpC,kBAAkB,CAMpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CACvB,OAAO,SAAS,iBAAiB,GAAG,iBAAiB,EACrD,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,OAAO,EACvC,KAAK,CAAC,EAAE,CAAC,GAAG,MAAM,GAAG,mBAAmB,CAKzC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,mBAAmB,CAI/C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,mBAAmB,CAIlD"}

package/dist/decorators.js

@@ -0,0 +1,115 @@
+import { metadataSymbol } from '@fluojs/core/internal';
+import { webSocketGatewayMetadataSymbol, webSocketHandlerMetadataSymbol } from './metadata.js';
+function getStandardMetadataBag(metadata) {
+  void metadataSymbol;
+  return metadata;
+}
+function normalizeGatewayPath(path) {
+  if (!path || path === '/') {
+    return '/';
+  }
+  const normalized = `/${path.trim().replace(/^\/+/, '').replace(/\/+$/, '')}`;
+  return normalized === '' ? '/' : normalized;
+}
+function defineStandardGatewayMetadata(metadata, options) {
+  const bag = getStandardMetadataBag(metadata);
+  bag[webSocketGatewayMetadataSymbol] = {
+    path: normalizeGatewayPath(options.path),
+    serverBacked: options.serverBacked ? {
+      port: options.serverBacked.port
+    } : undefined
+  };
+}
+function defineStandardHandlerMetadata(metadata, propertyKey, handlerMetadata) {
+  const bag = getStandardMetadataBag(metadata);
+  const current = bag[webSocketHandlerMetadataSymbol];
+  const map = current ?? new Map();
+  map.set(propertyKey, {
+    event: handlerMetadata.event,
+    type: handlerMetadata.type
+  });
+  bag[webSocketHandlerMetadataSymbol] = map;
+}
+function createMethodDecorator(metadata) {
+  const decorator = (_value, context) => {
+    if (context.private) {
+      throw new Error(`@${metadata.type === 'message' ? 'OnMessage' : metadata.type === 'connect' ? 'OnConnect' : 'OnDisconnect'}() cannot be used on private methods.`);
+    }
+    if (context.static) {
+      throw new Error(`@${metadata.type === 'message' ? 'OnMessage' : metadata.type === 'connect' ? 'OnConnect' : 'OnDisconnect'}() cannot be used on static methods.`);
+    }
+    defineStandardHandlerMetadata(context.metadata, context.name, metadata);
+  };
+  return decorator;
+}
+
+/**
+ * Marks a class as a WebSocket gateway discovered during module bootstrap.
+ *
+ * @param options Gateway path and optional server-backed listener configuration.
+ * @returns A class decorator that stores gateway metadata for runtime discovery.
+ *
+ * @example
+ * ```ts
+ * import { WebSocketGateway } from '@fluojs/websockets';
+ *
+ * @WebSocketGateway({ path: '/chat' })
+ * class ChatGateway {}
+ * ```
+ *
+ * @remarks
+ * Multiple gateways may share one `path`; handlers run in discovery order.
+ */
+export function WebSocketGateway(options = {}) {
+  const decorator = (_value, context) => {
+    defineStandardGatewayMetadata(context.metadata, options);
+  };
+  return decorator;
+}
+
+/**
+ * Registers a method as an inbound message handler for a gateway.
+ *
+ * @param event Optional event name filter. When omitted, the runtime treats the handler as a generic message listener.
+ * @returns A method decorator that records message-handler metadata for the gateway.
+ *
+ * @example
+ * ```ts
+ * import { OnMessage } from '@fluojs/websockets';
+ *
+ * class ChatGateway {
+ *   @OnMessage('ping')
+ *   handlePing(payload: unknown) {
+ *     return payload;
+ *   }
+ * }
+ * ```
+ */
+export function OnMessage(event) {
+  return createMethodDecorator({
+    event,
+    type: 'message'
+  });
+}
+
+/**
+ * Registers a method that runs when one client connection is established.
+ *
+ * @returns A method decorator that records a connection lifecycle handler.
+ */
+export function OnConnect() {
+  return createMethodDecorator({
+    type: 'connect'
+  });
+}
+
+/**
+ * Registers a method that runs when one client disconnects from the gateway.
+ *
+ * @returns A method decorator that records a disconnection lifecycle handler.
+ */
+export function OnDisconnect() {
+  return createMethodDecorator({
+    type: 'disconnect'
+  });
+}

package/dist/deno/deno-module.d.ts

@@ -0,0 +1,15 @@
+import { type ModuleType } from '@fluojs/runtime';
+import type { WebSocketModuleOptions } from './deno-types.js';
+/**
+ * Explicit Deno websocket module entrypoint.
+ */
+export declare class DenoWebSocketModule {
+    /**
+     * Registers the Deno websocket lifecycle service for request-upgrade gateway hosting.
+     *
+     * @param options Websocket gateway runtime options for guards, limits, heartbeat, and shutdown behavior.
+     * @returns A runtime module definition scoped to the Deno websocket adapter.
+     */
+    static forRoot(options?: WebSocketModuleOptions): ModuleType;
+}
+//# sourceMappingURL=deno-module.d.ts.map

package/dist/deno/deno-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deno-module.d.ts","sourceRoot":"","sources":["../../src/deno/deno-module.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIhE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAY9D;;GAEG;AACH,qBAAa,mBAAmB;IAC9B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,sBAA2B,GAAG,UAAU;CAOjE"}

package/dist/deno/deno-module.js

@@ -0,0 +1,27 @@
+import { defineModule } from '@fluojs/runtime';
+import { WEBSOCKET_OPTIONS_INTERNAL } from '../options-token.internal.js';
+import { DenoWebSocketGatewayLifecycleService } from './deno-service.js';
+function createDenoWebSocketProviders(options = {}) {
+  return [{
+    provide: WEBSOCKET_OPTIONS_INTERNAL,
+    useValue: options
+  }, DenoWebSocketGatewayLifecycleService];
+}
+
+/**
+ * Explicit Deno websocket module entrypoint.
+ */
+export class DenoWebSocketModule {
+  /**
+   * Registers the Deno websocket lifecycle service for request-upgrade gateway hosting.
+   *
+   * @param options Websocket gateway runtime options for guards, limits, heartbeat, and shutdown behavior.
+   * @returns A runtime module definition scoped to the Deno websocket adapter.
+   */
+  static forRoot(options = {}) {
+    class DenoWebSocketRuntimeModule extends DenoWebSocketModule {}
+    return defineModule(DenoWebSocketRuntimeModule, {
+      providers: createDenoWebSocketProviders(options)
+    });
+  }
+}

package/dist/deno/deno-service.d.ts

@@ -0,0 +1,61 @@
+import type { Container } from '@fluojs/di';
+import type { ApplicationLogger, CompiledModule, OnApplicationBootstrap, OnApplicationShutdown, OnModuleDestroy } from '@fluojs/runtime';
+import type { HttpApplicationAdapter } from '@fluojs/http';
+import type { WebSocketRoomService } from '../types.js';
+import type { WebSocketModuleOptions } from './deno-types.js';
+/**
+ * Boots Deno-backed websocket gateways and manages their room lifecycle state.
+ */
+export declare class DenoWebSocketGatewayLifecycleService implements OnApplicationBootstrap, OnApplicationShutdown, OnModuleDestroy, WebSocketRoomService {
+    private readonly runtimeContainer;
+    private readonly compiledModules;
+    private readonly logger;
+    private readonly adapter;
+    private readonly moduleOptions;
+    private pendingUpgradeReservations;
+    private readonly roomSockets;
+    private shutdownPromise;
+    private readonly socketRegistry;
+    private readonly socketRooms;
+    constructor(runtimeContainer: Container, compiledModules: readonly CompiledModule[], logger: ApplicationLogger, adapter: HttpApplicationAdapter, moduleOptions: WebSocketModuleOptions);
+    onApplicationBootstrap(): Promise<void>;
+    private assertNoServerBackedGatewayOptIn;
+    onApplicationShutdown(): Promise<void>;
+    onModuleDestroy(): Promise<void>;
+    private createBinding;
+    private groupDescriptorsByPath;
+    private bindConnectionHandlers;
+    private createConnectionHandlerState;
+    private attachConnectionListeners;
+    private getBufferedMessageCount;
+    private getQueuedMessageCount;
+    private maybeCompactBufferedMessages;
+    private clearBufferedMessages;
+    private maybeCompactQueuedMessages;
+    private clearQueuedMessages;
+    private bufferIncomingMessage;
+    private enqueueMessageDispatch;
+    private drainMessageQueue;
+    private normalizeMessage;
+    private enqueueDisconnectDispatch;
+    private resolveConnectionGateways;
+    private runConnectHandlers;
+    private finalizeConnectionBinding;
+    private replayBufferedConnectionEvents;
+    private findSocketId;
+    private resolveUpgradeRejection;
+    private closeOversizedPayload;
+    private resolveMaxConnectionCount;
+    private resolveReservedConnectionCount;
+    private tryReserveUpgradeSlot;
+    private releaseUpgradeReservation;
+    private resolveMaxPayloadBytes;
+    private shutdown;
+    private runShutdownLifecycle;
+    joinRoom(socketId: string, room: string): void;
+    leaveRoom(socketId: string, room: string): void;
+    broadcastToRoom(room: string, event: string, data: unknown): void;
+    getRooms(socketId: string): ReadonlySet<string>;
+    private unregisterSocket;
+}
+//# sourceMappingURL=deno-service.d.ts.map

package/dist/deno/deno-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deno-service.d.ts","sourceRoot":"","sources":["../../src/deno/deno-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEzI,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAa3D,OAAO,KAAK,EAA8B,oBAAoB,EAA6B,MAAM,aAAa,CAAC;AAC/G,OAAO,KAAK,EAKV,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AAsGzB;;GAEG;AACH,qBACa,oCACX,YAAW,sBAAsB,EAAE,qBAAqB,EAAE,eAAe,EAAE,oBAAoB;IAS7F,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAXhC,OAAO,CAAC,0BAA0B,CAAK;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkC;IAC9D,OAAO,CAAC,eAAe,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0C;IACzE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkC;gBAG3C,gBAAgB,EAAE,SAAS,EAC3B,eAAe,EAAE,SAAS,cAAc,EAAE,EAC1C,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,sBAAsB,EAC/B,aAAa,EAAE,sBAAsB;IAGlD,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB7C,OAAO,CAAC,gCAAgC;IAclC,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAItC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAItC,OAAO,CAAC,aAAa;IAoDrB,OAAO,CAAC,sBAAsB;YAmBhB,sBAAsB;IAgBpC,OAAO,CAAC,4BAA4B;IAqBpC,OAAO,CAAC,yBAAyB;IAwCjC,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,4BAA4B;IASpC,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,0BAA0B;IASlC,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,qBAAqB;IA0C7B,OAAO,CAAC,sBAAsB;YAyDhB,iBAAiB;YAqBjB,gBAAgB;IAQ9B,OAAO,CAAC,yBAAyB;YAsBnB,yBAAyB;YAczB,kBAAkB;YAgBlB,yBAAyB;YAUzB,8BAA8B;IAqB5C,OAAO,CAAC,YAAY;YAUN,uBAAuB;IAmDrC,OAAO,CAAC,qBAAqB;IAmB7B,OAAO,CAAC,yBAAyB;IAUjC,OAAO,CAAC,8BAA8B;IAItC,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,yBAAyB;IAMjC,OAAO,CAAC,sBAAsB;YAUhB,QAAQ;YAUR,oBAAoB;IAWlC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAmB9C,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAc/C,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IA4BjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;IAU/C,OAAO,CAAC,gBAAgB;CAoBzB"}