@rlanz/socket 0.0.1-4 → 0.0.1-6

package/build/chunk-YAX5EHHB.js

@@ -0,0 +1,453 @@
+import {
+  getDecoratedChannelHandlers
+} from "./chunk-SHH6U4CI.js";
+
+// src/base_channel.ts
+var SocketResponseError = class extends Error {
+};
+var MissingPresenceInfoError = class extends SocketResponseError {
+  constructor() {
+    super("Presence channels must implement getPresenceInfo(socket)");
+  }
+};
+var BaseChannel = class {
+  /**
+   * URL-like channel pattern, for example: 'chat/:roomId'.
+   */
+  static pattern;
+  /**
+   * Channel options.
+   */
+  static options;
+  /**
+   * Middlewares to run before subscription.
+   */
+  static middlewares;
+  /**
+   * Event handler map.
+   * Ex: { 'chat:send': 'handleSend' }
+   */
+  handlers = {};
+  /**
+   * Injected socket service.
+   */
+  socket;
+  /**
+   * Full channel name, for example: 'chat/general'.
+   */
+  channelName;
+  /**
+   * Parameters extracted from the pattern, for example: { roomId: 'general' }.
+   */
+  params;
+  /**
+   * Injected presence manager when presence is enabled.
+   */
+  presence;
+  /**
+   * Injects dependencies.
+   */
+  $setContext(socket, channelName, params, presence) {
+    this.socket = socket;
+    this.channelName = channelName;
+    this.params = params;
+    if (presence) {
+      this.presence = presence;
+    }
+  }
+  /**
+   * Emits to every channel member.
+   */
+  broadcast(event, data) {
+    this.socket.to(this.channelName).emit(event, data);
+  }
+  /**
+   * Emits to every channel member except one socket.
+   */
+  broadcastExcept(socketId, event, data) {
+    this.socket.to(this.channelName).except(socketId).emit(event, data);
+  }
+  /**
+   * Runs the middleware chain.
+   *
+   * middleware[0] -> middleware[1] -> ... -> subscribe
+   */
+  async $runMiddlewares(ctx) {
+    const middlewares = this.constructor.middlewares || [];
+    let index = 0;
+    const next = async () => {
+      if (index >= middlewares.length) return;
+      const middleware = middlewares[index++];
+      if (typeof middleware === "function") {
+        await middleware(ctx, next);
+      } else {
+        await middleware.handle(ctx, next);
+      }
+    };
+    await next();
+  }
+  /**
+   * Dispatches a message to the matching handler.
+   * Called by SocketService. Do not override.
+   */
+  async $handleMessage(socket, event, data) {
+    const handlers = {
+      ...this.handlers,
+      ...getDecoratedChannelHandlers(this)
+    };
+    const handler = handlers[event];
+    if (typeof handler === "function") {
+      return Reflect.apply(handler, this, [socket, data]);
+    }
+    return this.onMessage?.(socket, event, data);
+  }
+  /**
+   * Runs the generic join hook. ChannelSubscriptions owns subscription lifecycle.
+   */
+  async $handleJoin(socket, ...params) {
+    await this.onJoin?.(socket, ...params);
+  }
+  /**
+   * Runs the generic leave hook. ChannelSubscriptions owns subscription lifecycle.
+   */
+  async $handleLeave(socket, ...params) {
+    await this.onLeave?.(socket, ...params);
+  }
+  $getPresenceInfo(socket) {
+    if (!this.getPresenceInfo) {
+      throw new MissingPresenceInfoError();
+    }
+    return this.getPresenceInfo(socket);
+  }
+};
+
+// src/channel_pattern.ts
+import { exec, match, parse } from "@poppinss/matchit";
+var ChannelPattern = class _ChannelPattern {
+  constructor(value) {
+    this.value = value;
+    this.route = parse(value);
+    this.score = this.route.map((segment) => {
+      switch (segment.type) {
+        case 0:
+          return 40;
+        case 1:
+          return 30;
+        case 3:
+          return 20;
+        case 2:
+          return 0;
+      }
+    });
+  }
+  route;
+  score;
+  static from(value) {
+    return new _ChannelPattern(value);
+  }
+  match(channelName) {
+    const matched = match(channelName, [this.route]);
+    if (matched.length === 0) {
+      return null;
+    }
+    return Object.fromEntries(
+      Object.entries(exec(channelName, matched, true)).map(([name, value]) => [
+        name,
+        Array.isArray(value) ? value.join("/") : value
+      ])
+    );
+  }
+  /**
+   * Returns the most specific matching candidate. Static segments outrank params,
+   * params outrank optional params, and optional params outrank wildcards.
+   * Insertion order is preserved for ties.
+   */
+  static firstMatch(channelName, candidates) {
+    const sorted = [...candidates].sort((left, right) => {
+      return _ChannelPattern.#compareSpecificity(left.pattern, right.pattern);
+    });
+    const routes = sorted.map((candidate) => candidate.pattern.route);
+    const matched = match(channelName, routes);
+    if (matched.length === 0) {
+      return null;
+    }
+    for (const { pattern, channel } of sorted) {
+      if (pattern.route !== matched) {
+        continue;
+      }
+      const params = pattern.match(channelName);
+      if (params) {
+        return { pattern, channel, params };
+      }
+    }
+    return null;
+  }
+  static #compareSpecificity(left, right) {
+    const length = Math.max(left.score.length, right.score.length);
+    for (let index = 0; index < length; index++) {
+      const scoreDifference = (right.score[index] ?? -1) - (left.score[index] ?? -1);
+      if (scoreDifference !== 0) {
+        return scoreDifference;
+      }
+    }
+    return right.score.length - left.score.length;
+  }
+};
+
+// src/channel_router.ts
+var ChannelRouter = class {
+  /**
+   * Registered channels keyed by their pattern.
+   */
+  #channels = /* @__PURE__ */ new Map();
+  /**
+   * Registers a channel.
+   */
+  register(channel) {
+    const patternValue = channel.pattern;
+    if (!patternValue) {
+      throw new Error(`Channel ${channel.name} must define a static pattern`);
+    }
+    if (this.#channels.has(patternValue)) {
+      throw new Error(`Channel pattern "${patternValue}" is already registered`);
+    }
+    const pattern = ChannelPattern.from(patternValue);
+    this.#channels.set(pattern.value, { pattern, channel });
+  }
+  /**
+   * Matches a channel name against registered patterns.
+   */
+  match(channelName) {
+    const matched = ChannelPattern.firstMatch(channelName, this.#channels.values());
+    if (!matched) {
+      return null;
+    }
+    return {
+      channel: matched.channel,
+      pattern: matched.pattern.value,
+      params: matched.params
+    };
+  }
+  /**
+   * Authorizes a socket before it joins a channel.
+   */
+  async authorize(socket, channelName) {
+    const matched = this.match(channelName);
+    if (!matched) {
+      return {
+        success: false,
+        error: "Channel not found"
+      };
+    }
+    const instance = new matched.channel();
+    const paramValues = Object.values(matched.params);
+    const ctx = {
+      socket,
+      channel: channelName,
+      params: matched.params,
+      presenceData: void 0,
+      setPresenceData(data) {
+        ctx.presenceData = data;
+      }
+    };
+    try {
+      await instance.$runMiddlewares(ctx);
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof SocketResponseError ? error.message : "Authorization failed",
+        cause: error
+      };
+    }
+    return {
+      success: true,
+      instance,
+      params: matched.params,
+      paramValues,
+      presenceData: ctx.presenceData ?? null
+    };
+  }
+  /**
+   * Lists all registered channels.
+   */
+  list() {
+    return [...this.#channels.values()].map(({ pattern, channel }) => ({
+      pattern: pattern.value,
+      name: channel.name,
+      options: channel.options
+    }));
+  }
+  /**
+   * Number of registered channels.
+   */
+  get size() {
+    return this.#channels.size;
+  }
+};
+
+// src/presence_manager.ts
+var PRESENCE_DATA_KEY = "__rlanzSocketPresence";
+var PresenceManager = class {
+  #presence = /* @__PURE__ */ new Map();
+  #fetchSockets = null;
+  /**
+   * Sets the socket fetcher used to build distributed snapshots.
+   */
+  setSocketFetcher(fetchSockets) {
+    this.#fetchSockets = fetchSockets;
+  }
+  /**
+   * Adds a user to a channel.
+   */
+  join(channel, socket, member) {
+    const user = {
+      ...member.data,
+      id: member.id,
+      joinedAt: /* @__PURE__ */ new Date()
+    };
+    const users = this.#presence.get(channel) ?? /* @__PURE__ */ new Map();
+    users.set(socket.id, user);
+    this.#presence.set(channel, users);
+    this.#setSocketPresence(socket, channel, user);
+    return user;
+  }
+  /**
+   * Removes a user from a channel.
+   */
+  leave(channel, socket) {
+    const channelPresence = this.#presence.get(channel);
+    if (channelPresence) {
+      channelPresence.delete(socket.id);
+      if (channelPresence.size === 0) {
+        this.#presence.delete(channel);
+      }
+    }
+    this.#deleteSocketPresence(socket, channel);
+  }
+  /**
+   * Removes a user from every channel.
+   * Returns the list of channels the user left.
+   */
+  leaveAll(socket) {
+    const leftChannels = [];
+    for (const [channel, users] of this.#presence) {
+      if (users.has(socket.id)) {
+        users.delete(socket.id);
+        leftChannels.push(channel);
+        if (users.size === 0) {
+          this.#presence.delete(channel);
+        }
+        this.#deleteSocketPresence(socket, channel);
+      }
+    }
+    return leftChannels;
+  }
+  /**
+   * Gets presence data for a channel.
+   */
+  async snapshot(channel) {
+    if (this.#fetchSockets) {
+      return this.#getFromSockets(channel);
+    }
+    return this.#localSnapshot(channel);
+  }
+  /**
+   * Gets the number of users in a channel.
+   */
+  async count(channel) {
+    return (await this.snapshot(channel)).count;
+  }
+  /**
+   * Checks whether a socket is locally present in a channel.
+   */
+  hasLocal(channel, socketId) {
+    return this.#presence.get(channel)?.has(socketId) || false;
+  }
+  /**
+   * Gets the presence user retained for one local socket.
+   */
+  getLocalUser(channel, socketId) {
+    return this.#presence.get(channel)?.get(socketId);
+  }
+  /**
+   * Lists every local channel where a socket is present.
+   */
+  getLocalChannelsForSocket(socketId) {
+    const channels = [];
+    for (const [channel, users] of this.#presence) {
+      if (users.has(socketId)) {
+        channels.push(channel);
+      }
+    }
+    return channels;
+  }
+  /**
+   * Lists sockets that are locally present in a channel.
+   */
+  getLocalSockets(channel) {
+    const users = this.#presence.get(channel);
+    if (!users) {
+      return [];
+    }
+    return Array.from(users.entries()).map(([socketId, user]) => ({
+      id: socketId,
+      data: {
+        [PRESENCE_DATA_KEY]: {
+          [channel]: user
+        }
+      }
+    }));
+  }
+  #localSnapshot(channel) {
+    return this.#createSnapshot(channel, Array.from(this.#presence.get(channel)?.entries() ?? []));
+  }
+  async #getFromSockets(channel) {
+    const sockets = await this.#fetchSockets(channel);
+    const users = sockets.flatMap((socket) => {
+      const user = socket.data?.[PRESENCE_DATA_KEY]?.[channel];
+      return user ? [[socket.id, user]] : [];
+    });
+    return this.#createSnapshot(channel, users);
+  }
+  #createSnapshot(channel, connections) {
+    const usersById = /* @__PURE__ */ new Map();
+    for (const connection of connections) {
+      const current = usersById.get(connection[1].id);
+      if (!current || this.#compareConnections(connection, current) < 0) {
+        usersById.set(connection[1].id, connection);
+      }
+    }
+    const users = [...usersById.values()].sort((left, right) => this.#compareConnections(left, right)).map(([, user]) => user);
+    return {
+      channel,
+      users,
+      count: users.length
+    };
+  }
+  #compareConnections([leftSocketId, leftUser], [rightSocketId, rightUser]) {
+    const joinedAtDifference = leftUser.joinedAt.getTime() - rightUser.joinedAt.getTime();
+    return joinedAtDifference || leftSocketId.localeCompare(rightSocketId);
+  }
+  #setSocketPresence(socket, channel, user) {
+    socket.data[PRESENCE_DATA_KEY] ??= {};
+    socket.data[PRESENCE_DATA_KEY][channel] = user;
+  }
+  #deleteSocketPresence(socket, channel) {
+    if (!socket.data[PRESENCE_DATA_KEY]) {
+      return;
+    }
+    delete socket.data[PRESENCE_DATA_KEY][channel];
+    if (Object.keys(socket.data[PRESENCE_DATA_KEY]).length === 0) {
+      delete socket.data[PRESENCE_DATA_KEY];
+    }
+  }
+};
+
+export {
+  SocketResponseError,
+  BaseChannel,
+  ChannelRouter,
+  PRESENCE_DATA_KEY,
+  PresenceManager
+};
+//# sourceMappingURL=chunk-YAX5EHHB.js.map

package/build/chunk-YAX5EHHB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/base_channel.ts","../src/channel_pattern.ts","../src/channel_router.ts","../src/presence_manager.ts"],"sourcesContent":["import type {\n  AuthenticatedSocket,\n  ChannelOptions,\n  PresenceInfo,\n  PresenceMember,\n  Middleware,\n  MiddlewareContext,\n  ChannelHandlerMap,\n} from './types.js'\nimport type { PresenceManager } from './presence_manager.js'\nimport { getDecoratedChannelHandlers } from './decorators.js'\n\ninterface ChannelBroadcaster {\n  to(channel: string): {\n    emit(event: string, data: unknown): void\n    except(socketId: string): {\n      emit(event: string, data: unknown): void\n    }\n  }\n}\n\n/**\n * Error whose message may intentionally be returned to a socket client.\n */\nexport class SocketResponseError extends Error {}\n\nexport class MissingPresenceInfoError extends SocketResponseError {\n  constructor() {\n    super('Presence channels must implement getPresenceInfo(socket)')\n  }\n}\n\n/**\n * Abstract class used to define a channel.\n *\n * @example\n * ```ts\n * export default class ChatChannel extends BaseChannel {\n *   static pattern = 'chat/:roomId'\n *   static middlewares = [\n *     async (ctx, next) => {\n *       // Authorize access to the channel through middleware.\n *       // if (!Room.isMember(ctx.params.roomId, ctx.socket.user.id)) throw new Error('Forbidden')\n *       await next()\n *     },\n *   ]\n * }\n * ```\n *\n * @example With presence and decorated handlers\n * ```ts\n * import { onMessage } from '@rlanz/socket/decorators'\n *\n * export default class ChatChannel extends BaseChannel {\n *   static pattern = 'chat/:roomId'\n *   static options = { presence: true }\n *\n *   static middlewares = [\n *     async (ctx, next) => {\n *       if (!ctx.socket.user.isVerified) throw new Error('Not verified')\n *       await next()\n *     }\n *   ]\n *\n *   @onMessage('chat:send')\n *   async handleSend(socket: AuthenticatedSocket<User>, data: unknown) {\n *     // Handle chat:send event\n *   }\n *\n *   @onMessage('chat:typing')\n *   async handleTyping(socket: AuthenticatedSocket<User>, data: unknown) {\n *     // Handle chat:typing event\n *   }\n * }\n * ```\n */\nexport class BaseChannel<User = unknown, ServerEvents = unknown> {\n  /** Type-only server event declarations consumed by generated browser client types. */\n  declare readonly $serverEvents: ServerEvents\n  /**\n   * URL-like channel pattern, for example: 'chat/:roomId'.\n   */\n  static pattern: string\n\n  /**\n   * Channel options.\n   */\n  static options?: ChannelOptions\n\n  /**\n   * Middlewares to run before subscription.\n   */\n  static middlewares?: Middleware<any>[]\n\n  /**\n   * Event handler map.\n   * Ex: { 'chat:send': 'handleSend' }\n   */\n  protected handlers: ChannelHandlerMap<User> = {}\n\n  /**\n   * Injected socket service.\n   */\n  protected socket!: ChannelBroadcaster\n\n  /**\n   * Full channel name, for example: 'chat/general'.\n   */\n  protected channelName!: string\n\n  /**\n   * Parameters extracted from the pattern, for example: { roomId: 'general' }.\n   */\n  protected params!: Record<string, string>\n\n  /**\n   * Injected presence manager when presence is enabled.\n   */\n  protected presence!: PresenceManager\n\n  /**\n   * Injects dependencies.\n   */\n  $setContext(\n    socket: ChannelBroadcaster,\n    channelName: string,\n    params: Record<string, string>,\n    presence?: PresenceManager\n  ): void {\n    this.socket = socket\n    this.channelName = channelName\n    this.params = params\n    if (presence) {\n      this.presence = presence\n    }\n  }\n\n  /**\n   * Emits to every channel member.\n   */\n  protected broadcast<\n    K extends unknown extends ServerEvents ? string : keyof ServerEvents & string,\n  >(\n    event: K,\n    data: unknown extends ServerEvents ? unknown : ServerEvents[K & keyof ServerEvents]\n  ): void {\n    this.socket.to(this.channelName).emit(event, data)\n  }\n\n  /**\n   * Emits to every channel member except one socket.\n   */\n  protected broadcastExcept<\n    K extends unknown extends ServerEvents ? string : keyof ServerEvents & string,\n  >(\n    socketId: string,\n    event: K,\n    data: unknown extends ServerEvents ? unknown : ServerEvents[K & keyof ServerEvents]\n  ): void {\n    this.socket.to(this.channelName).except(socketId).emit(event, data)\n  }\n\n  /**\n   * Runs the middleware chain.\n   *\n   * middleware[0] -> middleware[1] -> ... -> subscribe\n   */\n  async $runMiddlewares(ctx: MiddlewareContext<User>): Promise<void> {\n    const middlewares = (this.constructor as typeof BaseChannel).middlewares || []\n\n    let index = 0\n\n    const next = async (): Promise<void> => {\n      if (index >= middlewares.length) return\n\n      const middleware = middlewares[index++]\n\n      if (typeof middleware === 'function') {\n        await middleware(ctx, next)\n      } else {\n        await middleware.handle(ctx, next)\n      }\n    }\n\n    await next()\n  }\n\n  /**\n   * Returns member information for presence.\n   * Implement when options.presence = true.\n   */\n  getPresenceInfo?(socket: AuthenticatedSocket<User>): PresenceInfo\n\n  /**\n   * Hook called when a socket joins the channel.\n   */\n  onJoin?(socket: AuthenticatedSocket<User>, ...params: string[]): Promise<void>\n\n  /**\n   * Hook called when a socket leaves the channel.\n   */\n  onLeave?(socket: AuthenticatedSocket<User>, ...params: string[]): Promise<void>\n\n  /**\n   * Hook called when a message is received on the channel.\n   * Used as fallback when no event handler matches.\n   */\n  onMessage?(socket: AuthenticatedSocket<User>, event: string, data: unknown): Promise<void>\n\n  /**\n   * Hook called when a member joins a presence channel.\n   */\n  onMemberJoin?(\n    socket: AuthenticatedSocket<User>,\n    member: PresenceMember,\n    ...params: string[]\n  ): Promise<void>\n\n  /**\n   * Hook called when a member leaves a presence channel.\n   */\n  onMemberLeave?(\n    socket: AuthenticatedSocket<User>,\n    member: PresenceMember,\n    ...params: string[]\n  ): Promise<void>\n\n  /**\n   * Dispatches a message to the matching handler.\n   * Called by SocketService. Do not override.\n   */\n  async $handleMessage(\n    socket: AuthenticatedSocket<User>,\n    event: string,\n    data: unknown\n  ): Promise<unknown> {\n    const handlers: Record<string, unknown> = {\n      ...this.handlers,\n      ...getDecoratedChannelHandlers<User>(this),\n    }\n    const handler = handlers[event]\n\n    if (typeof handler === 'function') {\n      return Reflect.apply(handler, this, [socket, data])\n    }\n\n    // Fall back to onMessage when it is defined.\n    return this.onMessage?.(socket, event, data)\n  }\n\n  /**\n   * Runs the generic join hook. ChannelSubscriptions owns subscription lifecycle.\n   */\n  async $handleJoin(socket: AuthenticatedSocket<User>, ...params: string[]): Promise<void> {\n    await this.onJoin?.(socket, ...params)\n  }\n\n  /**\n   * Runs the generic leave hook. ChannelSubscriptions owns subscription lifecycle.\n   */\n  async $handleLeave(socket: AuthenticatedSocket<User>, ...params: string[]): Promise<void> {\n    await this.onLeave?.(socket, ...params)\n  }\n\n  $getPresenceInfo(socket: AuthenticatedSocket<User>): PresenceInfo {\n    if (!this.getPresenceInfo) {\n      throw new MissingPresenceInfoError()\n    }\n\n    return this.getPresenceInfo(socket)\n  }\n}\n\n/** Constructor for any BaseChannel specialization. */\nexport type BaseChannelConstructor = typeof BaseChannel<any, any>\n","import type { BaseChannelConstructor } from './base_channel.js'\nimport { exec, match, parse, type ParsedRoute } from '@poppinss/matchit'\n\ntype MatchParams = Record<string, string>\n\nexport interface ChannelPatternMatch {\n  pattern: ChannelPattern\n  channel: BaseChannelConstructor\n  params: MatchParams\n}\n\ninterface MatchCandidate {\n  pattern: ChannelPattern\n  channel: BaseChannelConstructor\n}\n\nexport class ChannelPattern {\n  readonly route: ParsedRoute\n  readonly score: number[]\n\n  private constructor(readonly value: string) {\n    this.route = parse(value)\n    this.score = this.route.map((segment) => {\n      switch (segment.type) {\n        case 0:\n          return 40\n        case 1:\n          return 30\n        case 3:\n          return 20\n        case 2:\n          return 0\n      }\n    })\n  }\n\n  static from(value: string): ChannelPattern {\n    return new ChannelPattern(value)\n  }\n\n  match(channelName: string): MatchParams | null {\n    const matched = match(channelName, [this.route])\n    if (matched.length === 0) {\n      return null\n    }\n\n    return Object.fromEntries(\n      Object.entries(exec(channelName, matched, true)).map(([name, value]) => [\n        name,\n        Array.isArray(value) ? value.join('/') : value,\n      ])\n    )\n  }\n\n  /**\n   * Returns the most specific matching candidate. Static segments outrank params,\n   * params outrank optional params, and optional params outrank wildcards.\n   * Insertion order is preserved for ties.\n   */\n  static firstMatch(\n    channelName: string,\n    candidates: Iterable<MatchCandidate>\n  ): ChannelPatternMatch | null {\n    const sorted = [...candidates].sort((left, right) => {\n      return ChannelPattern.#compareSpecificity(left.pattern, right.pattern)\n    })\n    const routes = sorted.map((candidate) => candidate.pattern.route)\n    const matched = match(channelName, routes)\n\n    if (matched.length === 0) {\n      return null\n    }\n\n    for (const { pattern, channel } of sorted) {\n      if (pattern.route !== matched) {\n        continue\n      }\n\n      const params = pattern.match(channelName)\n      if (params) {\n        return { pattern, channel, params }\n      }\n    }\n\n    return null\n  }\n\n  static #compareSpecificity(left: ChannelPattern, right: ChannelPattern): number {\n    const length = Math.max(left.score.length, right.score.length)\n\n    for (let index = 0; index < length; index++) {\n      const scoreDifference = (right.score[index] ?? -1) - (left.score[index] ?? -1)\n      if (scoreDifference !== 0) {\n        return scoreDifference\n      }\n    }\n\n    return right.score.length - left.score.length\n  }\n}\n","import {\n  SocketResponseError,\n  type BaseChannel,\n  type BaseChannelConstructor,\n} from './base_channel.js'\nimport { ChannelPattern } from './channel_pattern.js'\nimport type { AuthenticatedSocket, ChannelMatch, MiddlewareContext } from './types.js'\n\ninterface RegisteredChannel {\n  pattern: ChannelPattern\n  channel: BaseChannelConstructor\n}\n\n/**\n * Matches channel names against registered patterns.\n *\n * Pattern: chat/:roomId\n * Channel: chat/general\n *\n * chat / :roomId\n *   |      |\n * chat / general  => { roomId: \"general\" }\n */\nexport class ChannelRouter {\n  /**\n   * Registered channels keyed by their pattern.\n   */\n  #channels = new Map<string, RegisteredChannel>()\n\n  /**\n   * Registers a channel.\n   */\n  register(channel: BaseChannelConstructor): void {\n    const patternValue = channel.pattern\n\n    if (!patternValue) {\n      throw new Error(`Channel ${channel.name} must define a static pattern`)\n    }\n\n    if (this.#channels.has(patternValue)) {\n      throw new Error(`Channel pattern \"${patternValue}\" is already registered`)\n    }\n\n    const pattern = ChannelPattern.from(patternValue)\n\n    this.#channels.set(pattern.value, { pattern, channel })\n  }\n\n  /**\n   * Matches a channel name against registered patterns.\n   */\n  match(channelName: string): ChannelMatch | null {\n    const matched = ChannelPattern.firstMatch(channelName, this.#channels.values())\n\n    if (!matched) {\n      return null\n    }\n\n    return {\n      channel: matched.channel,\n      pattern: matched.pattern.value,\n      params: matched.params,\n    }\n  }\n\n  /**\n   * Authorizes a socket before it joins a channel.\n   */\n  async authorize<User = unknown>(socket: AuthenticatedSocket<User>, channelName: string) {\n    const matched = this.match(channelName)\n\n    if (!matched) {\n      return {\n        success: false,\n        error: 'Channel not found',\n      } as const\n    }\n\n    const instance = new matched.channel() as BaseChannel<User>\n    const paramValues = Object.values(matched.params)\n\n    const ctx: MiddlewareContext<User> = {\n      socket,\n      channel: channelName,\n      params: matched.params,\n      presenceData: undefined,\n      setPresenceData(data) {\n        ctx.presenceData = data\n      },\n    }\n\n    // Run authorization middlewares.\n    try {\n      await instance.$runMiddlewares(ctx)\n    } catch (error) {\n      return {\n        success: false,\n        error: error instanceof SocketResponseError ? error.message : 'Authorization failed',\n        cause: error,\n      } as const\n    }\n\n    return {\n      success: true,\n      instance,\n      params: matched.params,\n      paramValues,\n      presenceData: ctx.presenceData ?? null,\n    } as const\n  }\n\n  /**\n   * Lists all registered channels.\n   */\n  list() {\n    return [...this.#channels.values()].map(({ pattern, channel }) => ({\n      pattern: pattern.value,\n      name: channel.name,\n      options: channel.options,\n    }))\n  }\n\n  /**\n   * Number of registered channels.\n   */\n  get size(): number {\n    return this.#channels.size\n  }\n}\n","import type { PresenceInfo } from './types.js'\n\nexport const PRESENCE_DATA_KEY = '__rlanzSocketPresence'\n\ntype PresenceSocketData = Record<string, unknown> & {\n  [PRESENCE_DATA_KEY]?: Record<string, PresenceUser>\n}\n\nexport interface PresenceUser {\n  id: string\n  joinedAt: Date\n  [key: string]: unknown\n}\n\nexport interface PresenceData {\n  channel: string\n  users: PresenceUser[]\n  count: number\n}\n\nexport interface PresenceSocket {\n  id: string\n  data: PresenceSocketData\n}\n\n/**\n * Tracks user presence in channels.\n *\n * channel -> socketId -> PresenceUser\n */\nexport class PresenceManager {\n  #presence = new Map<string, Map<string, PresenceUser>>()\n  #fetchSockets: ((channel: string) => Promise<PresenceSocket[]>) | null = null\n\n  /**\n   * Sets the socket fetcher used to build distributed snapshots.\n   */\n  setSocketFetcher(fetchSockets: ((channel: string) => Promise<PresenceSocket[]>) | null): void {\n    this.#fetchSockets = fetchSockets\n  }\n\n  /**\n   * Adds a user to a channel.\n   */\n  join(channel: string, socket: PresenceSocket, member: PresenceInfo): PresenceUser {\n    const user = {\n      ...member.data,\n      id: member.id,\n      joinedAt: new Date(),\n    }\n\n    const users = this.#presence.get(channel) ?? new Map()\n    users.set(socket.id, user)\n    this.#presence.set(channel, users)\n    this.#setSocketPresence(socket, channel, user)\n\n    return user\n  }\n\n  /**\n   * Removes a user from a channel.\n   */\n  leave(channel: string, socket: PresenceSocket): void {\n    const channelPresence = this.#presence.get(channel)\n\n    if (channelPresence) {\n      channelPresence.delete(socket.id)\n\n      if (channelPresence.size === 0) {\n        this.#presence.delete(channel)\n      }\n    }\n\n    this.#deleteSocketPresence(socket, channel)\n  }\n\n  /**\n   * Removes a user from every channel.\n   * Returns the list of channels the user left.\n   */\n  leaveAll(socket: PresenceSocket): string[] {\n    const leftChannels: string[] = []\n\n    for (const [channel, users] of this.#presence) {\n      if (users.has(socket.id)) {\n        users.delete(socket.id)\n        leftChannels.push(channel)\n\n        if (users.size === 0) {\n          this.#presence.delete(channel)\n        }\n\n        this.#deleteSocketPresence(socket, channel)\n      }\n    }\n\n    return leftChannels\n  }\n\n  /**\n   * Gets presence data for a channel.\n   */\n  async snapshot(channel: string): Promise<PresenceData> {\n    if (this.#fetchSockets) {\n      return this.#getFromSockets(channel)\n    }\n\n    return this.#localSnapshot(channel)\n  }\n\n  /**\n   * Gets the number of users in a channel.\n   */\n  async count(channel: string): Promise<number> {\n    return (await this.snapshot(channel)).count\n  }\n\n  /**\n   * Checks whether a socket is locally present in a channel.\n   */\n  hasLocal(channel: string, socketId: string): boolean {\n    return this.#presence.get(channel)?.has(socketId) || false\n  }\n\n  /**\n   * Gets the presence user retained for one local socket.\n   */\n  getLocalUser(channel: string, socketId: string): PresenceUser | undefined {\n    return this.#presence.get(channel)?.get(socketId)\n  }\n\n  /**\n   * Lists every local channel where a socket is present.\n   */\n  getLocalChannelsForSocket(socketId: string): string[] {\n    const channels: string[] = []\n\n    for (const [channel, users] of this.#presence) {\n      if (users.has(socketId)) {\n        channels.push(channel)\n      }\n    }\n\n    return channels\n  }\n\n  /**\n   * Lists sockets that are locally present in a channel.\n   */\n  getLocalSockets(channel: string): PresenceSocket[] {\n    const users = this.#presence.get(channel)\n\n    if (!users) {\n      return []\n    }\n\n    return Array.from(users.entries()).map(([socketId, user]) => ({\n      id: socketId,\n      data: {\n        [PRESENCE_DATA_KEY]: {\n          [channel]: user,\n        },\n      },\n    }))\n  }\n\n  #localSnapshot(channel: string): PresenceData {\n    return this.#createSnapshot(channel, Array.from(this.#presence.get(channel)?.entries() ?? []))\n  }\n\n  async #getFromSockets(channel: string): Promise<PresenceData> {\n    const sockets = await this.#fetchSockets!(channel)\n    const users = sockets.flatMap((socket): Array<[string, PresenceUser]> => {\n      const user = socket.data?.[PRESENCE_DATA_KEY]?.[channel]\n      return user ? [[socket.id, user]] : []\n    })\n\n    return this.#createSnapshot(channel, users)\n  }\n\n  #createSnapshot(\n    channel: string,\n    connections: Array<[socketId: string, user: PresenceUser]>\n  ): PresenceData {\n    const usersById = new Map<string, [socketId: string, user: PresenceUser]>()\n\n    for (const connection of connections) {\n      const current = usersById.get(connection[1].id)\n      if (!current || this.#compareConnections(connection, current) < 0) {\n        usersById.set(connection[1].id, connection)\n      }\n    }\n\n    const users = [...usersById.values()]\n      .sort((left, right) => this.#compareConnections(left, right))\n      .map(([, user]) => user)\n\n    return {\n      channel,\n      users,\n      count: users.length,\n    }\n  }\n\n  #compareConnections(\n    [leftSocketId, leftUser]: [string, PresenceUser],\n    [rightSocketId, rightUser]: [string, PresenceUser]\n  ): number {\n    const joinedAtDifference = leftUser.joinedAt.getTime() - rightUser.joinedAt.getTime()\n    return joinedAtDifference || leftSocketId.localeCompare(rightSocketId)\n  }\n\n  #setSocketPresence(socket: PresenceSocket, channel: string, user: PresenceUser): void {\n    socket.data[PRESENCE_DATA_KEY] ??= {}\n    socket.data[PRESENCE_DATA_KEY][channel] = user\n  }\n\n  #deleteSocketPresence(socket: PresenceSocket, channel: string): void {\n    if (!socket.data[PRESENCE_DATA_KEY]) {\n      return\n    }\n\n    delete socket.data[PRESENCE_DATA_KEY][channel]\n\n    if (Object.keys(socket.data[PRESENCE_DATA_KEY]).length === 0) {\n      delete socket.data[PRESENCE_DATA_KEY]\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/build/framework-DuW6zpPk.d.ts

@@ -0,0 +1,14 @@
+import { Channel } from './src/client/index.js';
+import { ChannelContract, ChannelContractFor } from './src/client/types.js';
+
+type UnknownContract = ChannelContract<unknown, unknown>;
+type ServerEvents<Contract> = Contract extends ChannelContract<unknown, infer Events> ? Events : unknown;
+type IsUnknown<Value> = unknown extends Value ? true : false;
+type FrameworkChannelMember<Registry, Name extends string> = string extends Name ? Channel<UnknownContract> : [Registry] extends [never] ? Channel<UnknownContract> : ChannelContractFor<Registry, Name> extends infer Contract ? [Contract] extends [never] ? never : Channel<Contract> : never;
+type FrameworkChannel<Registry, Name extends string> = Name extends unknown ? FrameworkChannelMember<Registry, Name> : never;
+type FrameworkChannelNameValidity<Registry, Name extends string> = Name extends unknown ? FrameworkChannelMember<Registry, Name> extends never ? false : true : never;
+type FrameworkChannelName<Registry, Name extends string> = Name & ([FrameworkChannelNameValidity<Registry, Name>] extends [true] ? unknown : never);
+type FrameworkChannelEvent<Registry, Name extends string> = FrameworkChannel<Registry, Name> extends Channel<infer Contract> ? IsUnknown<ServerEvents<Contract>> extends true ? string : Extract<keyof ServerEvents<Contract>, string> : never;
+type FrameworkChannelEventPayload<Registry, Name extends string, Event extends FrameworkChannelEvent<Registry, Name>> = FrameworkChannel<Registry, Name> extends Channel<infer Contract> ? IsUnknown<ServerEvents<Contract>> extends true ? unknown : Event extends keyof ServerEvents<Contract> ? ServerEvents<Contract>[Event] : never : never;
+
+export type { FrameworkChannelName as F, FrameworkChannel as a, FrameworkChannelEvent as b, FrameworkChannelEventPayload as c };

package/build/index.d.ts

@@ -1,25 +1,19 @@
-export { C as ChannelRouter, S as SocketFake, a as SocketFakeCountQuery, b as SocketFakeEmission, c as SocketFakeEmissionQuery, d as SocketFakeTarget, e as SocketService } from './socket_service-CRmPa74K.js';
-import { S as SocketConfig, a as SocketAuthenticationHandler } from './types-BBLNfcWk.js';
-export { A as AuthenticatedSocket, B as BaseChannel, C as ChannelEventMap, b as ChannelHandlerFn, c as ChannelHandlerMap, d as ChannelMatch, e as ChannelOptions, D as Duration, M as Middleware, f as MiddlewareClass, g as MiddlewareContext, h as MiddlewareFn, P as PresenceManager, i as PresenceMember, R as RawSocket, j as SocketAuthenticationResult, k as SocketEvents, l as SocketHealthSnapshot, m as SocketHttpContextFactory, n as SocketHttpMiddleware, o as SocketServiceStatus, p as SocketUpgradeContext } from './types-BBLNfcWk.js';
+export { C as ChannelRouter } from './socket_service-D3jKrleE.js';
+import { S as SocketConfig, d as SocketAuthenticationHandler } from './types-DiYaFvgi.js';
+export { A as AuthenticatedSocket, B as BaseChannel, e as BaseChannelConstructor, b as ChannelAck, f as ChannelHandlerFn, C as ChannelHandlerMap, g as ChannelMatch, c as ChannelMessage, h as ChannelOptions, a as ChannelServerEventsOf, D as Duration, M as Middleware, i as MiddlewareClass, j as MiddlewareContext, k as MiddlewareFn, l as PresenceInfo, P as PresenceManager, m as PresenceMember, R as RawSocket, n as SocketAuthenticationResult, o as SocketEvents, p as SocketHealthSnapshot, q as SocketHttpMiddleware, r as SocketResponseError, s as SocketServiceStatus, t as SocketUpgradeContext } from './types-DiYaFvgi.js';
 export { SocketHealthCheck } from './src/health_check.js';
-export { C as ChannelAck, a as ChannelMessage } from './shared_types-Dw9AphfO.js';
+export { SocketFake, SocketFakeCountQuery, SocketFakeEmission, SocketFakeEmissionQuery, SocketFakeTarget } from './src/testing.js';
 import 'node:http';
 import '@adonisjs/logger';
 import 'emittery';
 import 'ws';
+import '@adonisjs/core/http';
 import '@adonisjs/core/types/http';
 import '@boringnode/bus/types/main';
 import '@adonisjs/core/health';
 
-declare function defineConfig<User = unknown, HttpContext = unknown, Config extends SocketConfig<User, HttpContext> = SocketConfig<User, HttpContext>>(config: Config): Config;
+declare function defineConfig<User = unknown, Config extends SocketConfig<User> = SocketConfig<User>>(config: Config): Config;
 
-interface AdonisAuthenticator<User> {
-    authenticateUsing(): void | Promise<void>;
-    getUserOrFail(): User;
-}
-interface AdonisAuthHttpContext<User> {
-    auth: AdonisAuthenticator<User>;
-}
-declare function authenticateWithAdonisAuth<User = unknown, HttpContext extends AdonisAuthHttpContext<User> = AdonisAuthHttpContext<User>>(): SocketAuthenticationHandler<User, HttpContext>;
+declare function authenticateWithAdonisAuth<User = unknown>(): SocketAuthenticationHandler<User>;
 
 export { SocketAuthenticationHandler, SocketConfig, authenticateWithAdonisAuth, defineConfig };

package/build/index.js

@@ -2,14 +2,15 @@ import {
   BaseChannel,
   ChannelRouter,
   PresenceManager,
-  SocketFake,
-  SocketService
-} from "./chunk-ILDK672E.js";
-import "./chunk-XUDFDJME.js";
+  SocketResponseError
+} from "./chunk-YAX5EHHB.js";
+import "./chunk-SHH6U4CI.js";
 import {
   SocketHealthCheck
 } from "./chunk-HK7Z65DA.js";
-import "./chunk-GKAD2UOA.js";
+import {
+  SocketFake
+} from "./chunk-B4Y3TNDI.js";
 
 // src/define_config.ts
 function defineConfig(config) {
@@ -19,11 +20,18 @@ function defineConfig(config) {
 // src/adonis_auth.ts
 function authenticateWithAdonisAuth() {
   return async (ctx) => {
-    if (!ctx.httpContext) {
-      throw new Error("Cannot authenticate socket without an AdonisJS HTTP context");
+    const auth = Reflect.get(ctx.httpContext, "auth");
+    if (typeof auth !== "object" || auth === null || typeof Reflect.get(auth, "authenticateUsing") !== "function" || typeof Reflect.get(auth, "getUserOrFail") !== "function") {
+      throw new Error(
+        "AdonisJS Auth must be initialized by websocket middleware before authenticating sockets"
+      );
     }
-    await ctx.httpContext.auth.authenticateUsing();
-    return ctx.httpContext.auth.getUserOrFail();
+    const authenticator = {
+      authenticateUsing: Reflect.get(auth, "authenticateUsing").bind(auth),
+      getUserOrFail: Reflect.get(auth, "getUserOrFail").bind(auth)
+    };
+    await authenticator.authenticateUsing();
+    return authenticator.getUserOrFail();
   };
 }
 export {
@@ -32,7 +40,7 @@ export {
   PresenceManager,
   SocketFake,
   SocketHealthCheck,
-  SocketService,
+  SocketResponseError,
   authenticateWithAdonisAuth,
   defineConfig
 };

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/define_config.ts","../src/adonis_auth.ts"],"sourcesContent":["import type { SocketConfig } from './types.js'\n\nexport function defineConfig<\n  User = unknown,\n  HttpContext = unknown,\n  Config extends SocketConfig<User, HttpContext> = SocketConfig<User, HttpContext>,\n>(config: Config): Config {\n  return config\n}\n","import type { SocketAuthenticationHandler } from './types.js'\n\ninterface AdonisAuthenticator<User> {\n  authenticateUsing(): void | Promise<void>\n  getUserOrFail(): User\n}\n\ninterface AdonisAuthHttpContext<User> {\n  auth: AdonisAuthenticator<User>\n}\n\nexport function authenticateWithAdonisAuth<\n  User = unknown,\n  HttpContext extends AdonisAuthHttpContext<User> = AdonisAuthHttpContext<User>,\n>(): SocketAuthenticationHandler<User, HttpContext> {\n  return async (ctx) => {\n    if (!ctx.httpContext) {\n      throw new Error('Cannot authenticate socket without an AdonisJS HTTP context')\n    }\n\n    await ctx.httpContext.auth.authenticateUsing()\n\n    return ctx.httpContext.auth.getUserOrFail()\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAEO,SAAS,aAId,QAAwB;AACxB,SAAO;AACT;;;ACGO,SAAS,6BAGoC;AAClD,SAAO,OAAO,QAAQ;AACpB,QAAI,CAAC,IAAI,aAAa;AACpB,YAAM,IAAI,MAAM,6DAA6D;AAAA,IAC/E;AAEA,UAAM,IAAI,YAAY,KAAK,kBAAkB;AAE7C,WAAO,IAAI,YAAY,KAAK,cAAc;AAAA,EAC5C;AACF;","names":[]}
+{"version":3,"sources":["../src/define_config.ts","../src/adonis_auth.ts"],"sourcesContent":["import type { SocketConfig } from './types.js'\n\nexport function defineConfig<\n  User = unknown,\n  Config extends SocketConfig<User> = SocketConfig<User>,\n>(config: Config): Config {\n  return config\n}\n","import type { SocketAuthenticationHandler } from './types.js'\n\ninterface AdonisAuthenticator {\n  authenticateUsing: () => unknown\n  getUserOrFail: () => unknown\n}\n\nexport function authenticateWithAdonisAuth<User = unknown>(): SocketAuthenticationHandler<User> {\n  return async (ctx) => {\n    const auth: unknown = Reflect.get(ctx.httpContext, 'auth')\n    if (\n      typeof auth !== 'object' ||\n      auth === null ||\n      typeof Reflect.get(auth, 'authenticateUsing') !== 'function' ||\n      typeof Reflect.get(auth, 'getUserOrFail') !== 'function'\n    ) {\n      throw new Error(\n        'AdonisJS Auth must be initialized by websocket middleware before authenticating sockets'\n      )\n    }\n\n    const authenticator: AdonisAuthenticator = {\n      authenticateUsing: Reflect.get(auth, 'authenticateUsing').bind(auth),\n      getUserOrFail: Reflect.get(auth, 'getUserOrFail').bind(auth),\n    }\n    await authenticator.authenticateUsing()\n\n    // The configured Adonis authenticator owns the application's User type.\n    return authenticator.getUserOrFail() as User\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAEO,SAAS,aAGd,QAAwB;AACxB,SAAO;AACT;;;ACAO,SAAS,6BAAgF;AAC9F,SAAO,OAAO,QAAQ;AACpB,UAAM,OAAgB,QAAQ,IAAI,IAAI,aAAa,MAAM;AACzD,QACE,OAAO,SAAS,YAChB,SAAS,QACT,OAAO,QAAQ,IAAI,MAAM,mBAAmB,MAAM,cAClD,OAAO,QAAQ,IAAI,MAAM,eAAe,MAAM,YAC9C;AACA,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAEA,UAAM,gBAAqC;AAAA,MACzC,mBAAmB,QAAQ,IAAI,MAAM,mBAAmB,EAAE,KAAK,IAAI;AAAA,MACnE,eAAe,QAAQ,IAAI,MAAM,eAAe,EAAE,KAAK,IAAI;AAAA,IAC7D;AACA,UAAM,cAAc,kBAAkB;AAGtC,WAAO,cAAc,cAAc;AAAA,EACrC;AACF;","names":[]}

package/build/providers/socket_provider.d.ts

@@ -1,13 +1,14 @@
 import { ApplicationService } from '@adonisjs/core/types';
-import { e as SocketService, C as ChannelRouter } from '../socket_service-CRmPa74K.js';
-import { P as PresenceManager } from '../types-BBLNfcWk.js';
+import { S as SocketService, C as ChannelRouter } from '../socket_service-D3jKrleE.js';
+import { P as PresenceManager } from '../types-DiYaFvgi.js';
 import 'node:http';
 import '@adonisjs/logger';
 import 'emittery';
 import 'ws';
+import '@adonisjs/core/http';
+import '../src/testing.js';
 import '@adonisjs/core/types/http';
 import '@boringnode/bus/types/main';
-import '../shared_types-Dw9AphfO.js';
 
 declare module '@adonisjs/core/types' {
     interface ContainerBindings {