@rlanz/socket 0.0.1-9 → 0.1.0

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

@@ -3,6 +3,7 @@ import { IncomingMessage } from 'node:http';
 import { MiddlewareAsClass } from '@adonisjs/core/types/http';
 import { HttpContext } from '@adonisjs/core/http';
 import { TransportFactory } from '@boringnode/bus/types/main';
+import './shared_types-B11CaOr5.js';
 
 declare const PRESENCE_DATA_KEY = "__rlanzSocketPresence";
 type PresenceSocketData = Record<string, unknown> & {
@@ -99,26 +100,6 @@ interface SocketRetryQueueConfig {
     retryInterval?: Duration | false;
 }
 
-/**
- * Types shared between the server and the client.
- */
-/**
- * Message sent by the client to a channel.
- */
-interface ChannelMessage {
-    channel: string;
-    event: string;
-    data?: unknown;
-}
-/**
- * Channel handler acknowledgement response.
- */
-interface ChannelAck<T = unknown> {
-    ok: boolean;
-    data?: T;
-    error?: string;
-}
-
 interface RawSocket {
     id: string;
     data: Record<string, unknown>;
@@ -232,10 +213,6 @@ interface MiddlewareConstructor<User = unknown> {
  * Middleware, either a function, an instance, or a container-resolved class.
  */
 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;
 /**
  * Package configuration.
  */
@@ -303,6 +280,11 @@ interface SocketConfig<User = unknown> {
          * Maximum accepted channel name length in characters.
          */
         maxChannelNameLength?: number;
+        /**
+         * Maximum time spent waiting for socket handlers and subscription hooks during shutdown.
+         * Internal socket state is forcibly released after this deadline.
+         */
+        shutdownTimeout?: Duration;
     };
     /**
      * Optional transport used to synchronize broadcasts between SocketService instances.
@@ -491,4 +473,4 @@ interface BaseChannelConstructor {
     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 };
+export { type AuthenticatedSocket as A, BaseChannel as B, type ChannelOptions as C, type Duration as D, type Middleware as M, PresenceManager as P, type RawSocket as R, type SocketAuthenticationHandler as S, type SocketConfig as a, type MiddlewareClass as b, type MiddlewareConstructor as c, type MiddlewareContext as d, type MiddlewareFn as e, type PresenceInfo as f, type PresenceMember as g, type SocketAuthenticationResult as h, type SocketEvents as i, type SocketHealthSnapshot as j, type SocketHttpMiddleware as k, type SocketOriginResolver as l, type SocketOriginValues as m, SocketResponseError as n, type SocketRetryQueueConfig as o, type SocketServiceStatus as p, type SocketTransportConfig as q, type SocketUpgradeContext as r, type BaseChannelConstructor as s, type ChannelMiddlewareRunnerFactory as t, type ChannelMatch as u, type PresenceData as v };

package/build/{chunk-6PJ4ALJD.js → chunk-DM3UQMWW.js}

@@ -3,6 +3,9 @@ import {
 } from "./chunk-E6ILCRL3.js";
 
 // src/bindable_channel_pattern.ts
+function isUnsupportedParameter(segment, final, parameterNames) {
+  return segment.suffix !== "" || !/^[^.:?/*]+$/.test(segment.name) || segment.optional && !final || segment.name === "wildcard" || parameterNames.has(segment.name);
+}
 var BindableChannelPattern = class _BindableChannelPattern extends ChannelPatternSyntax {
   constructor(source) {
     super(source);
@@ -27,8 +30,7 @@ var BindableChannelPattern = class _BindableChannelPattern extends ChannelPatter
         continue;
       }
       if (segment.kind === "parameter") {
-        const unsupportedParameter = segment.suffix !== "" || !/^[^.:?/*]+$/.test(segment.name) || segment.optional && !final || segment.name === "wildcard" || parameterNames.has(segment.name);
-        if (unsupportedParameter) {
+        if (isUnsupportedParameter(segment, final, parameterNames)) {
           bindable = false;
           break;
         }
@@ -112,4 +114,4 @@ var BindableChannelPattern = class _BindableChannelPattern extends ChannelPatter
 export {
   BindableChannelPattern
 };
-//# sourceMappingURL=chunk-6PJ4ALJD.js.map
+//# sourceMappingURL=chunk-DM3UQMWW.js.map

package/build/chunk-DM3UQMWW.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\nfunction isUnsupportedParameter(\n  segment: { readonly name: string; readonly suffix: string; readonly optional: boolean },\n  final: boolean,\n  parameterNames: ReadonlySet<string>\n): boolean {\n  return (\n    segment.suffix !== '' ||\n    !/^[^.:?/*]+$/.test(segment.name) ||\n    (segment.optional && !final) ||\n    segment.name === 'wildcard' ||\n    parameterNames.has(segment.name)\n  )\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        if (isUnsupportedParameter(segment, final, parameterNames)) {\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":[]}