@rlanz/socket 0.0.1-6 → 0.0.1-8

package/build/{types-DiYaFvgi.d.ts → base_channel-DPOnqned.d.ts}

@@ -72,161 +72,6 @@ declare class PresenceManager {
     getLocalSockets(channel: string): PresenceSocket[];
 }
 
-interface ChannelBroadcaster {
-    to(channel: string): {
-        emit(event: string, data: unknown): void;
-        except(socketId: string): {
-            emit(event: string, data: unknown): void;
-        };
-    };
-}
-/**
- * Error whose message may intentionally be returned to a socket client.
- */
-declare class SocketResponseError extends Error {
-}
-/**
- * Abstract class used to define a channel.
- *
- * @example
- * ```ts
- * export default class ChatChannel extends BaseChannel {
- *   static pattern = 'chat/:roomId'
- *   static middlewares = [
- *     async (ctx, next) => {
- *       // Authorize access to the channel through middleware.
- *       // if (!Room.isMember(ctx.params.roomId, ctx.socket.user.id)) throw new Error('Forbidden')
- *       await next()
- *     },
- *   ]
- * }
- * ```
- *
- * @example With presence and decorated handlers
- * ```ts
- * import { onMessage } from '@rlanz/socket/decorators'
- *
- * export default class ChatChannel extends BaseChannel {
- *   static pattern = 'chat/:roomId'
- *   static options = { presence: true }
- *
- *   static middlewares = [
- *     async (ctx, next) => {
- *       if (!ctx.socket.user.isVerified) throw new Error('Not verified')
- *       await next()
- *     }
- *   ]
- *
- *   @onMessage('chat:send')
- *   async handleSend(socket: AuthenticatedSocket<User>, data: unknown) {
- *     // Handle chat:send event
- *   }
- *
- *   @onMessage('chat:typing')
- *   async handleTyping(socket: AuthenticatedSocket<User>, data: unknown) {
- *     // Handle chat:typing event
- *   }
- * }
- * ```
- */
-declare class BaseChannel<User = unknown, ServerEvents = unknown> {
-    /** Type-only server event declarations consumed by generated browser client types. */
-    readonly $serverEvents: ServerEvents;
-    /**
-     * URL-like channel pattern, for example: 'chat/:roomId'.
-     */
-    static pattern: string;
-    /**
-     * Channel options.
-     */
-    static options?: ChannelOptions;
-    /**
-     * Middlewares to run before subscription.
-     */
-    static middlewares?: Middleware<any>[];
-    /**
-     * Event handler map.
-     * Ex: { 'chat:send': 'handleSend' }
-     */
-    protected handlers: ChannelHandlerMap<User>;
-    /**
-     * Injected socket service.
-     */
-    protected socket: ChannelBroadcaster;
-    /**
-     * Full channel name, for example: 'chat/general'.
-     */
-    protected channelName: string;
-    /**
-     * Parameters extracted from the pattern, for example: { roomId: 'general' }.
-     */
-    protected params: Record<string, string>;
-    /**
-     * Injected presence manager when presence is enabled.
-     */
-    protected presence: PresenceManager;
-    /**
-     * Injects dependencies.
-     */
-    $setContext(socket: ChannelBroadcaster, channelName: string, params: Record<string, string>, presence?: PresenceManager): void;
-    /**
-     * Emits to every channel member.
-     */
-    protected broadcast<K extends unknown extends ServerEvents ? string : keyof ServerEvents & string>(event: K, data: unknown extends ServerEvents ? unknown : ServerEvents[K & keyof ServerEvents]): void;
-    /**
-     * Emits to every channel member except one socket.
-     */
-    protected broadcastExcept<K extends unknown extends ServerEvents ? string : keyof ServerEvents & string>(socketId: string, event: K, data: unknown extends ServerEvents ? unknown : ServerEvents[K & keyof ServerEvents]): void;
-    /**
-     * Runs the middleware chain.
-     *
-     * middleware[0] -> middleware[1] -> ... -> subscribe
-     */
-    $runMiddlewares(ctx: MiddlewareContext<User>): Promise<void>;
-    /**
-     * Returns member information for presence.
-     * Implement when options.presence = true.
-     */
-    getPresenceInfo?(socket: AuthenticatedSocket<User>): PresenceInfo;
-    /**
-     * Hook called when a socket joins the channel.
-     */
-    onJoin?(socket: AuthenticatedSocket<User>, ...params: string[]): Promise<void>;
-    /**
-     * Hook called when a socket leaves the channel.
-     */
-    onLeave?(socket: AuthenticatedSocket<User>, ...params: string[]): Promise<void>;
-    /**
-     * Hook called when a message is received on the channel.
-     * Used as fallback when no event handler matches.
-     */
-    onMessage?(socket: AuthenticatedSocket<User>, event: string, data: unknown): Promise<void>;
-    /**
-     * Hook called when a member joins a presence channel.
-     */
-    onMemberJoin?(socket: AuthenticatedSocket<User>, member: PresenceMember, ...params: string[]): Promise<void>;
-    /**
-     * Hook called when a member leaves a presence channel.
-     */
-    onMemberLeave?(socket: AuthenticatedSocket<User>, member: PresenceMember, ...params: string[]): Promise<void>;
-    /**
-     * Dispatches a message to the matching handler.
-     * Called by SocketService. Do not override.
-     */
-    $handleMessage(socket: AuthenticatedSocket<User>, event: string, data: unknown): Promise<unknown>;
-    /**
-     * Runs the generic join hook. ChannelSubscriptions owns subscription lifecycle.
-     */
-    $handleJoin(socket: AuthenticatedSocket<User>, ...params: string[]): Promise<void>;
-    /**
-     * Runs the generic leave hook. ChannelSubscriptions owns subscription lifecycle.
-     */
-    $handleLeave(socket: AuthenticatedSocket<User>, ...params: string[]): Promise<void>;
-    $getPresenceInfo(socket: AuthenticatedSocket<User>): PresenceInfo;
-}
-/** Constructor for any BaseChannel specialization. */
-type BaseChannelConstructor = typeof BaseChannel<any, any>;
-
 /**
  * Duration can be specified as milliseconds or as a human-readable string.
  */
@@ -239,6 +84,19 @@ interface SocketTransportConfig {
      * How long to wait for other instances to answer a presence snapshot request.
      */
     presenceTimeout?: Duration;
+    /**
+     * In-memory retry policy for transport publications that fail.
+     *
+     * The queue is enabled and limited to 1000 distinct messages by default.
+     * Set maxSize to null only when an unbounded queue is explicitly desired.
+     */
+    retryQueue?: SocketRetryQueueConfig;
+}
+interface SocketRetryQueueConfig {
+    enabled?: boolean;
+    removeDuplicates?: boolean;
+    maxSize?: number | null;
+    retryInterval?: Duration | false;
 }
 
 /**
@@ -288,14 +146,6 @@ interface AuthenticatedSocket<User = unknown> {
      * Emits an event to this socket.
      */
     emit(event: string, data: unknown): void;
-    /**
-     * Joins the user target used by SocketService.toUser().
-     */
-    joinUserRoom(userId: string | number): Promise<void>;
-    /**
-     * Leaves the current SocketService.toUser() target.
-     */
-    leaveUserRoom(): Promise<void>;
     /**
      * Disconnects the socket.
      */
@@ -314,6 +164,8 @@ interface SocketUpgradeContext {
 }
 type SocketAuthenticationResult<User = unknown> = User | false | null;
 type SocketAuthenticationHandler<User = unknown> = (ctx: SocketUpgradeContext) => SocketAuthenticationResult<User> | Promise<SocketAuthenticationResult<User>>;
+type SocketOriginValues = boolean | string | string[];
+type SocketOriginResolver = (origin: string, httpContext: HttpContext) => SocketOriginValues;
 /**
  * AdonisJS HTTP middleware executed for the WebSocket upgrade request.
  */
@@ -370,15 +222,20 @@ interface MiddlewareClass<User = unknown> {
     handle: MiddlewareFn<User>;
 }
 /**
- * Middleware, either a function or a class.
+ * Constructor for a middleware resolved through the AdonisJS container.
+ */
+interface MiddlewareConstructor<User = unknown> {
+    new (...args: any[]): MiddlewareClass<User>;
+    readonly prototype: MiddlewareClass<User>;
+}
+/**
+ * Middleware, either a function, an instance, or a container-resolved class.
  */
-type Middleware<User = unknown> = MiddlewareFn<User> | MiddlewareClass<User>;
+type Middleware<User = unknown> = MiddlewareFn<User> | MiddlewareClass<User> | MiddlewareConstructor<User>;
 /** Extracts the server-to-client event map declared by a channel instance. */
 type ChannelServerEventsOf<T> = T extends {
     readonly $serverEvents: infer Events;
 } ? Events : unknown;
-type ChannelHandlerFn<User = unknown> = (socket: AuthenticatedSocket<User>, data: any) => unknown | Promise<unknown>;
-type ChannelHandlerMap<User = unknown> = Record<string, ChannelHandlerFn<User>>;
 /**
  * Package configuration.
  */
@@ -386,10 +243,14 @@ interface SocketConfig<User = unknown> {
     websocket?: {
         path?: string;
         /**
-         * Additional browser origins allowed to open a WebSocket connection.
-         * Same-origin requests and clients without an Origin header are allowed by default.
+         * Browser origin policy for opening a WebSocket connection.
+         *
+         * Uses the same value shapes as the AdonisJS CORS `origin` option. A resolver
+         * receives the request origin and HTTP context and may return any static value.
+         * Same-origin requests are allowed by default when this option is not defined.
+         * Clients without an Origin header are always allowed.
          */
-        allowedOrigins?: string[];
+        origin?: SocketOriginValues | SocketOriginResolver;
         /**
          * HTTP middleware executed only for the WebSocket upgrade request.
          *
@@ -477,4 +338,157 @@ interface SocketEvents<User = unknown> {
     };
 }
 
-export { type AuthenticatedSocket as A, BaseChannel as B, type ChannelHandlerMap as C, type Duration as D, type Middleware as M, PresenceManager as P, type RawSocket as R, type SocketConfig as S, type ChannelServerEventsOf as a, type ChannelAck as b, type ChannelMessage as c, type SocketAuthenticationHandler as d, type BaseChannelConstructor as e, type ChannelHandlerFn as f, type ChannelMatch as g, type ChannelOptions as h, type MiddlewareClass as i, type MiddlewareContext as j, type MiddlewareFn as k, type PresenceInfo as l, type PresenceMember as m, type SocketAuthenticationResult as n, type SocketEvents as o, type SocketHealthSnapshot as p, type SocketHttpMiddleware as q, SocketResponseError as r, type SocketServiceStatus as s, type SocketUpgradeContext as t, type PresenceData as u };
+interface ChannelBroadcaster {
+    to(channel: string): {
+        emit(event: string, data: unknown): void;
+        except(socketId: string): {
+            emit(event: string, data: unknown): void;
+        };
+    };
+}
+type ChannelMiddlewareRunner = <User>(middleware: MiddlewareConstructor<User>, ctx: MiddlewareContext<User>, next: () => Promise<void>) => Promise<void>;
+type ChannelMiddlewareRunnerFactory = () => ChannelMiddlewareRunner;
+/**
+ * Error whose message may intentionally be returned to a socket client.
+ */
+declare class SocketResponseError extends Error {
+}
+/**
+ * Abstract class used to define a channel.
+ *
+ * @example
+ * ```ts
+ * export default class ChatChannel extends BaseChannel {
+ *   static pattern = 'chat/:roomId'
+ *   static middlewares = [
+ *     async (ctx, next) => {
+ *       // Authorize access to the channel through middleware.
+ *       // if (!Room.isMember(ctx.params.roomId, ctx.socket.user.id)) throw new Error('Forbidden')
+ *       await next()
+ *     },
+ *   ]
+ * }
+ * ```
+ *
+ * @example With presence and decorated handlers
+ * ```ts
+ * import { onMessage } from '@rlanz/socket/decorators'
+ *
+ * export default class ChatChannel extends BaseChannel {
+ *   static pattern = 'chat/:roomId'
+ *   static options = { presence: true }
+ *
+ *   static middlewares = [
+ *     async (ctx, next) => {
+ *       if (!ctx.socket.user.isVerified) throw new Error('Not verified')
+ *       await next()
+ *     }
+ *   ]
+ *
+ *   @onMessage('chat:send')
+ *   async handleSend(socket: AuthenticatedSocket<User>, data: unknown) {
+ *     // Handle chat:send event
+ *   }
+ *
+ *   @onMessage('chat:typing')
+ *   async handleTyping(socket: AuthenticatedSocket<User>, data: unknown) {
+ *     // Handle chat:typing event
+ *   }
+ * }
+ * ```
+ */
+declare class BaseChannel<User = unknown, ServerEvents = Record<never, never>> {
+    /** Type-only server event declarations consumed by generated browser client types. */
+    readonly $serverEvents: ServerEvents;
+    /**
+     * URL-like channel pattern, for example: 'chat/:roomId'.
+     */
+    static pattern: string;
+    /**
+     * Channel options.
+     */
+    static options?: ChannelOptions;
+    /**
+     * Middlewares to run before subscription.
+     */
+    static middlewares?: Middleware<any>[];
+    /**
+     * Injected socket service.
+     */
+    protected socket: ChannelBroadcaster;
+    /**
+     * Full channel name, for example: 'chat/general'.
+     */
+    protected channelName: string;
+    /**
+     * Parameters extracted from the pattern, for example: { roomId: 'general' }.
+     */
+    protected params: Record<string, string>;
+    /**
+     * Injected presence manager when presence is enabled.
+     */
+    protected presence: PresenceManager;
+    /**
+     * Injects dependencies.
+     */
+    $setContext(socket: ChannelBroadcaster, channelName: string, params: Record<string, string>, presence?: PresenceManager): void;
+    /**
+     * Emits to every channel member.
+     */
+    protected broadcast<K extends keyof ServerEvents & string>(event: K, data: ServerEvents[K]): void;
+    /**
+     * Emits to every channel member except one socket.
+     */
+    protected broadcastExcept<K extends keyof ServerEvents & string>(socketId: string, event: K, data: ServerEvents[K]): void;
+    /**
+     * Runs the middleware chain.
+     *
+     * middleware[0] -> middleware[1] -> ... -> subscribe
+     */
+    $runMiddlewares(ctx: MiddlewareContext<User>, runClassMiddleware?: ChannelMiddlewareRunner): Promise<void>;
+    /**
+     * Returns member information for presence.
+     * Implement when options.presence = true.
+     */
+    getPresenceInfo?(socket: AuthenticatedSocket<User>): PresenceInfo;
+    /**
+     * Hook called when a socket joins the channel.
+     */
+    onJoin?(socket: AuthenticatedSocket<User>, ...params: string[]): Promise<void>;
+    /**
+     * Hook called when a socket leaves the channel.
+     */
+    onLeave?(socket: AuthenticatedSocket<User>, ...params: string[]): Promise<void>;
+    /**
+     * Hook called when a member joins a presence channel.
+     */
+    onMemberJoin?(socket: AuthenticatedSocket<User>, member: PresenceMember, ...params: string[]): Promise<void>;
+    /**
+     * Hook called when a member leaves a presence channel.
+     */
+    onMemberLeave?(socket: AuthenticatedSocket<User>, member: PresenceMember, ...params: string[]): Promise<void>;
+    /**
+     * Dispatches a message to the matching handler.
+     * Called by SocketService. Do not override.
+     */
+    $handleMessage(socket: AuthenticatedSocket<User>, event: string, data: unknown): Promise<unknown>;
+    /**
+     * Runs the generic join hook. ChannelSubscriptions owns subscription lifecycle.
+     */
+    $handleJoin(socket: AuthenticatedSocket<User>, ...params: string[]): Promise<void>;
+    /**
+     * Runs the generic leave hook. ChannelSubscriptions owns subscription lifecycle.
+     */
+    $handleLeave(socket: AuthenticatedSocket<User>, ...params: string[]): Promise<void>;
+    $getPresenceInfo(socket: AuthenticatedSocket<User>): PresenceInfo;
+}
+/** Constructor for any BaseChannel specialization, including container-injected dependencies. */
+interface BaseChannelConstructor {
+    new (...args: any[]): BaseChannel<any, any>;
+    readonly name: string;
+    pattern: string;
+    options?: ChannelOptions;
+    middlewares?: Middleware<any>[];
+}
+
+export { type AuthenticatedSocket as A, BaseChannel as B, type ChannelServerEventsOf as C, type Duration as D, type Middleware as M, PresenceManager as P, type RawSocket as R, type SocketAuthenticationHandler as S, type ChannelAck as a, type ChannelMessage as b, type SocketConfig as c, type ChannelOptions as d, type MiddlewareClass as e, type MiddlewareConstructor as f, type MiddlewareContext as g, type MiddlewareFn as h, type PresenceInfo as i, type PresenceMember as j, type SocketAuthenticationResult as k, type SocketEvents as l, type SocketHealthSnapshot as m, type SocketHttpMiddleware as n, type SocketOriginResolver as o, type SocketOriginValues as p, SocketResponseError as q, type SocketRetryQueueConfig as r, type SocketServiceStatus as s, type SocketTransportConfig as t, type SocketUpgradeContext as u, type BaseChannelConstructor as v, type ChannelMiddlewareRunnerFactory as w, type ChannelMatch as x, type PresenceData as y };

package/build/chunk-6PJ4ALJD.js

@@ -0,0 +1,115 @@
+import {
+  ChannelPatternSyntax
+} from "./chunk-E6ILCRL3.js";
+
+// src/bindable_channel_pattern.ts
+var BindableChannelPattern = class _BindableChannelPattern extends ChannelPatternSyntax {
+  constructor(source) {
+    super(source);
+    this.source = source;
+    const bindingSegments = [];
+    const parameters = [];
+    const parameterNames = /* @__PURE__ */ new Set();
+    const serializedSegments = [];
+    let bindable = true;
+    if (this.canonicalPattern !== "/" && (this.segments.length === 0 || this.segments.length !== this.canonicalPattern.split("/").length)) {
+      bindable = false;
+    }
+    for (const [index, segment] of this.segments.entries()) {
+      const final = index === this.segments.length - 1;
+      if (segment.kind === "static") {
+        if (segment.value.length === 0 || /[:*?]/.test(segment.value)) {
+          bindable = false;
+          break;
+        }
+        bindingSegments.push({ kind: "static", value: segment.value });
+        serializedSegments.push(segment.value);
+        continue;
+      }
+      if (segment.kind === "parameter") {
+        const unsupportedParameter = segment.suffix !== "" || !/^[^.:?/*]+$/.test(segment.name) || segment.optional && !final || segment.name === "wildcard" || parameterNames.has(segment.name);
+        if (unsupportedParameter) {
+          bindable = false;
+          break;
+        }
+        parameterNames.add(segment.name);
+        parameters.push({ name: segment.name, optional: segment.optional });
+        bindingSegments.push({
+          kind: "parameter",
+          name: segment.name,
+          optional: segment.optional,
+          wildcard: false
+        });
+        serializedSegments.push(`:${segment.name}${segment.optional ? "?" : ""}`);
+        continue;
+      }
+      if (!final || segment.name !== "*" || parameterNames.has("wildcard")) {
+        bindable = false;
+        break;
+      }
+      parameterNames.add("wildcard");
+      parameters.push({ name: "wildcard", optional: false });
+      bindingSegments.push({
+        kind: "parameter",
+        name: "wildcard",
+        optional: false,
+        wildcard: true
+      });
+      serializedSegments.push(segment.name);
+    }
+    if (this.canonicalPattern !== "/" && serializedSegments.join("/") !== this.canonicalPattern) {
+      bindable = false;
+    }
+    this.#bindable = bindable;
+    this.parameters = Object.freeze(parameters.map((parameter) => Object.freeze(parameter)));
+    this.#bindingSegments = Object.freeze(bindingSegments.map((segment) => Object.freeze(segment)));
+    Object.freeze(this);
+  }
+  parameters;
+  #bindable;
+  #bindingSegments;
+  /**
+   * Parse and validate the pattern subset that generated clients can bind.
+   */
+  static parse(value) {
+    const pattern = new _BindableChannelPattern(value);
+    return pattern.#bindable ? pattern : null;
+  }
+  /**
+   * Bind all required parameters and return one concrete channel name.
+   */
+  bind(parameters = {}) {
+    if (this.canonicalPattern === "/") {
+      return "/";
+    }
+    const values = [];
+    for (const segment of this.#bindingSegments) {
+      if (segment.kind === "static") {
+        values.push(segment.value);
+        continue;
+      }
+      const value = Reflect.get(parameters, segment.name);
+      if (value === void 0 && segment.optional) {
+        continue;
+      }
+      if (value === void 0) {
+        const label = segment.wildcard ? "wildcard parameter" : `"${segment.name}" parameter`;
+        throw new Error(`Missing ${label} for channel: ${this.source}`);
+      }
+      if (typeof value !== "string" && typeof value !== "number") {
+        throw new Error(`Invalid "${segment.name}" parameter for channel: ${this.source}`);
+      }
+      const bound = String(value);
+      if (bound.length === 0 || !segment.wildcard && bound.includes("/")) {
+        throw new Error(`Invalid "${segment.name}" parameter for channel: ${this.source}`);
+      }
+      values.push(bound);
+    }
+    return values.join("/") || "/";
+  }
+};
+
+export {
+  BindableChannelPattern
+};
+//# sourceMappingURL=chunk-6PJ4ALJD.js.map

package/build/chunk-6PJ4ALJD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bindable_channel_pattern.ts"],"sourcesContent":["import { ChannelPatternSyntax } from './channel_pattern_syntax.js'\n\nexport interface BindableChannelParameter {\n  readonly name: string\n  readonly optional: boolean\n}\n\ntype BindableChannelSegment =\n  | { readonly kind: 'static'; readonly value: string }\n  | {\n      readonly kind: 'parameter'\n      readonly name: string\n      readonly optional: boolean\n      readonly wildcard: boolean\n    }\n\n/**\n * The deliberately small subset of channel patterns that generated clients can bind.\n * Runtime routing keeps using the complete grammar through ChannelPattern.\n */\nexport class BindableChannelPattern extends ChannelPatternSyntax {\n  readonly parameters: readonly BindableChannelParameter[]\n  readonly #bindable: boolean\n  readonly #bindingSegments: readonly BindableChannelSegment[]\n\n  private constructor(private readonly source: string) {\n    super(source)\n\n    const bindingSegments: BindableChannelSegment[] = []\n    const parameters: BindableChannelParameter[] = []\n    const parameterNames = new Set<string>()\n    const serializedSegments: string[] = []\n    let bindable = true\n\n    // Reject syntax that does not map to one complete segment per slash.\n    if (\n      this.canonicalPattern !== '/' &&\n      (this.segments.length === 0 ||\n        this.segments.length !== this.canonicalPattern.split('/').length)\n    ) {\n      bindable = false\n    }\n\n    for (const [index, segment] of this.segments.entries()) {\n      const final = index === this.segments.length - 1\n\n      if (segment.kind === 'static') {\n        if (segment.value.length === 0 || /[:*?]/.test(segment.value)) {\n          bindable = false\n          break\n        }\n        bindingSegments.push({ kind: 'static', value: segment.value })\n        serializedSegments.push(segment.value)\n        continue\n      }\n\n      if (segment.kind === 'parameter') {\n        // Generated parameters do not support suffixes or intermediate optional values.\n        // The wildcard name is reserved for the final wildcard segment.\n        const unsupportedParameter =\n          segment.suffix !== '' ||\n          !/^[^.:?/*]+$/.test(segment.name) ||\n          (segment.optional && !final) ||\n          segment.name === 'wildcard' ||\n          parameterNames.has(segment.name)\n\n        if (unsupportedParameter) {\n          bindable = false\n          break\n        }\n\n        parameterNames.add(segment.name)\n        parameters.push({ name: segment.name, optional: segment.optional })\n        bindingSegments.push({\n          kind: 'parameter',\n          name: segment.name,\n          optional: segment.optional,\n          wildcard: false,\n        })\n        serializedSegments.push(`:${segment.name}${segment.optional ? '?' : ''}`)\n        continue\n      }\n\n      // A generated wildcard must be the final segment and must use the reserved key.\n      if (!final || segment.name !== '*' || parameterNames.has('wildcard')) {\n        bindable = false\n        break\n      }\n\n      parameterNames.add('wildcard')\n      parameters.push({ name: 'wildcard', optional: false })\n      bindingSegments.push({\n        kind: 'parameter',\n        name: 'wildcard',\n        optional: false,\n        wildcard: true,\n      })\n      serializedSegments.push(segment.name)\n    }\n\n    // Reject syntax that the parser cannot reproduce without a change.\n    if (this.canonicalPattern !== '/' && serializedSegments.join('/') !== this.canonicalPattern) {\n      bindable = false\n    }\n\n    this.#bindable = bindable\n    this.parameters = Object.freeze(parameters.map((parameter) => Object.freeze(parameter)))\n    this.#bindingSegments = Object.freeze(bindingSegments.map((segment) => Object.freeze(segment)))\n    Object.freeze(this)\n  }\n\n  /**\n   * Parse and validate the pattern subset that generated clients can bind.\n   */\n  static parse(value: string): BindableChannelPattern | null {\n    const pattern = new BindableChannelPattern(value)\n    return pattern.#bindable ? pattern : null\n  }\n\n  /**\n   * Bind all required parameters and return one concrete channel name.\n   */\n  bind(parameters: object = {}): string {\n    if (this.canonicalPattern === '/') {\n      return '/'\n    }\n\n    const values: string[] = []\n    for (const segment of this.#bindingSegments) {\n      if (segment.kind === 'static') {\n        values.push(segment.value)\n        continue\n      }\n\n      const value = Reflect.get(parameters, segment.name) as unknown\n\n      // Omit only an optional parameter. All other segments need one value.\n      if (value === undefined && segment.optional) {\n        continue\n      }\n      if (value === undefined) {\n        const label = segment.wildcard ? 'wildcard parameter' : `\"${segment.name}\" parameter`\n        throw new Error(`Missing ${label} for channel: ${this.source}`)\n      }\n      if (typeof value !== 'string' && typeof value !== 'number') {\n        throw new Error(`Invalid \"${segment.name}\" parameter for channel: ${this.source}`)\n      }\n\n      const bound = String(value)\n\n      // An ordinary parameter must stay in one segment. A wildcard can contain slashes.\n      if (bound.length === 0 || (!segment.wildcard && bound.includes('/'))) {\n        throw new Error(`Invalid \"${segment.name}\" parameter for channel: ${this.source}`)\n      }\n      values.push(bound)\n    }\n\n    return values.join('/') || '/'\n  }\n}\n"],"mappings":"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","names":[]}