@rlanz/socket 0.0.1-3 → 0.0.1-5

package/build/chunk-ANT2E3LT.js

@@ -0,0 +1,136 @@
+import {
+  callClientHandler
+} from "./chunk-SFAY2ZA4.js";
+
+// src/client/framework.ts
+var socketEntries = /* @__PURE__ */ new WeakMap();
+var socketOwners = /* @__PURE__ */ new WeakMap();
+function reportSubscriptionError(error) {
+  queueMicrotask(() => {
+    console.error(error);
+  });
+}
+function attachEvents(entry) {
+  for (const [event, managed] of entry.events) {
+    entry.channel.$listen(event, managed.dispatch);
+  }
+}
+function getEntry(socket, name) {
+  let entries = socketEntries.get(socket);
+  if (!entries) {
+    entries = /* @__PURE__ */ new Map();
+    socketEntries.set(socket, entries);
+  }
+  const channel = socket.channel(name);
+  let entry = entries.get(name);
+  if (!entry || entry.channel !== channel) {
+    entry = {
+      channel,
+      socket,
+      leases: /* @__PURE__ */ new Set(),
+      events: /* @__PURE__ */ new Map(),
+      lifecycle: void 0
+    };
+    entries.set(name, entry);
+  }
+  return entry;
+}
+var ChannelLease = class {
+  entry;
+  #released = false;
+  #listeners = [];
+  constructor(entry) {
+    this.entry = entry;
+  }
+  listen(event, handler) {
+    if (this.#released) return;
+    let managed = this.entry.events.get(event);
+    if (!managed) {
+      const handlers = /* @__PURE__ */ new Set();
+      managed = {
+        handlers,
+        dispatch: (data) => {
+          for (const listener of handlers) callClientHandler(listener, data);
+        }
+      };
+      this.entry.events.set(event, managed);
+      this.entry.channel.$listen(event, managed.dispatch);
+    }
+    const registration = (data) => handler(data);
+    managed.handlers.add(registration);
+    this.#listeners.push({ event, handler: registration });
+  }
+  release() {
+    if (this.#released) return;
+    this.#released = true;
+    for (const { event, handler } of this.#listeners) {
+      const managed = this.entry.events.get(event);
+      managed?.handlers.delete(handler);
+      if (managed?.handlers.size === 0) {
+        this.entry.channel.$stopListening(event, managed.dispatch);
+        this.entry.events.delete(event);
+      }
+    }
+    this.#listeners = [];
+    this.entry.leases.delete(this);
+    queueMicrotask(() => {
+      if (this.entry.leases.size > 0) return;
+      const lifecycle = this.entry.lifecycle;
+      this.entry.lifecycle = void 0;
+      void lifecycle?.release().then(() => {
+        if (this.entry.leases.size > 0 || this.entry.lifecycle) return;
+        const entries = socketEntries.get(this.entry.socket);
+        if (entries?.get(this.entry.channel.name) === this.entry) {
+          entries.delete(this.entry.channel.name);
+        }
+      });
+    });
+  }
+};
+function acquireChannel(socket, name) {
+  const entry = getEntry(socket, name);
+  const lease = new ChannelLease(entry);
+  entry.leases.add(lease);
+  if (!entry.lifecycle) {
+    const lifecycle = entry.channel.$acquire();
+    entry.lifecycle = lifecycle;
+    attachEvents(entry);
+    void lifecycle.ready.then(() => {
+      if (entry.lifecycle === lifecycle) attachEvents(entry);
+    }).catch((error) => {
+      if (entry.lifecycle === lifecycle && entry.leases.size > 0 && entry.socket.connected) {
+        reportSubscriptionError(error);
+      }
+    });
+  }
+  return { channel: entry.channel, lease };
+}
+function acquireSocketOwnership(socket) {
+  let owner = socketOwners.get(socket);
+  if (!owner) {
+    owner = { count: 0, generation: 0 };
+    socketOwners.set(socket, owner);
+    socket.connect().catch(reportSubscriptionError);
+  }
+  owner.count++;
+  owner.generation++;
+  let released = false;
+  return () => {
+    if (released) return;
+    released = true;
+    owner.count--;
+    const generation = ++owner.generation;
+    queueMicrotask(() => {
+      if (owner.count === 0 && owner.generation === generation) {
+        socket.disconnect();
+        socketOwners.delete(socket);
+      }
+    });
+  };
+}
+
+export {
+  acquireChannel,
+  acquireSocketOwnership
+};
+//# sourceMappingURL=chunk-ANT2E3LT.js.map

package/build/chunk-ANT2E3LT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client/framework.ts"],"sourcesContent":["import type { Channel } from './channel.js'\nimport type { Socket } from './socket.js'\nimport type { ChannelContract, ChannelContractFor, EventHandler } from './types.js'\nimport { callClientHandler } from './callback.js'\n\ntype AnySocket = Socket<any>\ntype UnknownContract = ChannelContract<unknown, unknown>\ntype ServerEvents<Contract> =\n  Contract extends ChannelContract<unknown, infer Events> ? Events : unknown\ntype IsUnknown<Value> = unknown extends Value ? true : false\n\nexport type FrameworkChannel<Registry, Name extends string> = string extends Name\n  ? Channel<UnknownContract>\n  : [Registry] extends [never]\n    ? Channel<UnknownContract>\n    : ChannelContractFor<Registry, Name> extends infer Contract\n      ? [Contract] extends [never]\n        ? never\n        : Channel<Contract>\n      : never\n\nexport type FrameworkChannelName<Registry, Name extends string> = Name &\n  (FrameworkChannel<Registry, Name> extends never ? never : unknown)\n\nexport type FrameworkChannelEvent<Registry, Name extends string> =\n  FrameworkChannel<Registry, Name> extends Channel<infer Contract>\n    ? IsUnknown<ServerEvents<Contract>> extends true\n      ? string\n      : Extract<keyof ServerEvents<Contract>, string>\n    : never\n\nexport type FrameworkChannelEventPayload<\n  Registry,\n  Name extends string,\n  Event extends FrameworkChannelEvent<Registry, Name>,\n> =\n  FrameworkChannel<Registry, Name> extends Channel<infer Contract>\n    ? IsUnknown<ServerEvents<Contract>> extends true\n      ? unknown\n      : Event extends keyof ServerEvents<Contract>\n        ? ServerEvents<Contract>[Event]\n        : never\n    : never\n\ninterface ManagedEvent {\n  handlers: Set<EventHandler<any>>\n  dispatch: EventHandler<any>\n}\n\ninterface ManagedEntry {\n  channel: Channel<any>\n  socket: AnySocket\n  leases: Set<ChannelLease>\n  events: Map<string, ManagedEvent>\n  lifecycle: { ready: Promise<Channel<any>>; release: () => Promise<void> } | undefined\n}\n\nconst socketEntries = new WeakMap<AnySocket, Map<string, ManagedEntry>>()\nconst socketOwners = new WeakMap<AnySocket, { count: number; generation: number }>()\n\nfunction reportSubscriptionError(error: unknown): void {\n  queueMicrotask(() => {\n    console.error(error)\n  })\n}\n\nfunction attachEvents(entry: ManagedEntry): void {\n  for (const [event, managed] of entry.events) {\n    entry.channel.$listen(event, managed.dispatch)\n  }\n}\n\nfunction getEntry(socket: AnySocket, name: string): ManagedEntry {\n  let entries = socketEntries.get(socket)\n  if (!entries) {\n    entries = new Map()\n    socketEntries.set(socket, entries)\n  }\n\n  const channel = socket.channel(name)\n  let entry = entries.get(name)\n  if (!entry || entry.channel !== channel) {\n    entry = {\n      channel,\n      socket,\n      leases: new Set(),\n      events: new Map(),\n      lifecycle: undefined,\n    }\n    entries.set(name, entry)\n  }\n\n  return entry\n}\n\nexport class ChannelLease {\n  readonly entry: ManagedEntry\n  #released = false\n  #listeners: Array<{ event: string; handler: EventHandler<any> }> = []\n\n  constructor(entry: ManagedEntry) {\n    this.entry = entry\n  }\n\n  listen(event: string, handler: EventHandler<any>): void {\n    if (this.#released) return\n\n    let managed = this.entry.events.get(event)\n    if (!managed) {\n      const handlers = new Set<EventHandler<any>>()\n      managed = {\n        handlers,\n        dispatch: (data) => {\n          for (const listener of handlers) callClientHandler(listener, data)\n        },\n      }\n      this.entry.events.set(event, managed)\n      this.entry.channel.$listen(event, managed.dispatch)\n    }\n    const registration: EventHandler<any> = (data) => handler(data)\n    managed.handlers.add(registration)\n    this.#listeners.push({ event, handler: registration })\n  }\n\n  release(): void {\n    if (this.#released) return\n    this.#released = true\n\n    for (const { event, handler } of this.#listeners) {\n      const managed = this.entry.events.get(event)\n      managed?.handlers.delete(handler)\n      if (managed?.handlers.size === 0) {\n        this.entry.channel.$stopListening(event, managed.dispatch)\n        this.entry.events.delete(event)\n      }\n    }\n    this.#listeners = []\n    this.entry.leases.delete(this)\n\n    queueMicrotask(() => {\n      if (this.entry.leases.size > 0) return\n      const lifecycle = this.entry.lifecycle\n      this.entry.lifecycle = undefined\n      void lifecycle?.release().then(() => {\n        if (this.entry.leases.size > 0 || this.entry.lifecycle) return\n        const entries = socketEntries.get(this.entry.socket)\n        if (entries?.get(this.entry.channel.name) === this.entry) {\n          entries.delete(this.entry.channel.name)\n        }\n      })\n    })\n  }\n}\n\nexport function acquireChannel<Registry, const Name extends string>(\n  socket: Socket<Registry>,\n  name: FrameworkChannelName<Registry, Name>\n): { channel: FrameworkChannel<Registry, Name>; lease: ChannelLease } {\n  const entry = getEntry(socket, name)\n  const lease = new ChannelLease(entry)\n  entry.leases.add(lease)\n\n  if (!entry.lifecycle) {\n    const lifecycle = entry.channel.$acquire()\n    entry.lifecycle = lifecycle\n    attachEvents(entry)\n    void lifecycle.ready\n      .then(() => {\n        if (entry.lifecycle === lifecycle) attachEvents(entry)\n      })\n      .catch((error) => {\n        if (entry.lifecycle === lifecycle && entry.leases.size > 0 && entry.socket.connected) {\n          reportSubscriptionError(error)\n        }\n      })\n  }\n\n  return { channel: entry.channel as FrameworkChannel<Registry, Name>, lease }\n}\n\n/** Connects an exclusively owned socket and coalesces development-mode remounts. */\nexport function acquireSocketOwnership(socket: AnySocket): () => void {\n  let owner = socketOwners.get(socket)\n  if (!owner) {\n    owner = { count: 0, generation: 0 }\n    socketOwners.set(socket, owner)\n    socket.connect().catch(reportSubscriptionError)\n  }\n  owner.count++\n  owner.generation++\n\n  let released = false\n  return () => {\n    if (released) return\n    released = true\n    owner.count--\n    const generation = ++owner.generation\n    queueMicrotask(() => {\n      if (owner.count === 0 && owner.generation === generation) {\n        socket.disconnect()\n        socketOwners.delete(socket)\n      }\n    })\n  }\n}\n"],"mappings":"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","names":[]}

package/build/chunk-B4Y3TNDI.js

@@ -0,0 +1,159 @@
+// src/fake_socket.ts
+import { AssertionError } from "assert";
+import { isDeepStrictEqual } from "util";
+var SocketFake = class {
+  #emissions = [];
+  #restore;
+  constructor(restore) {
+    this.#restore = restore;
+  }
+  get emissions() {
+    return [...this.#emissions];
+  }
+  record(emission) {
+    this.#emissions.push({
+      ...emission,
+      ..."except" in emission && emission.except ? { except: [...emission.except] } : {}
+    });
+  }
+  dispatch(emission) {
+    this.record(emission);
+  }
+  clear() {
+    this.#emissions = [];
+  }
+  restore() {
+    this.#restore();
+  }
+  [Symbol.dispose]() {
+    this.restore();
+  }
+  assertBroadcasted(event, query) {
+    this.#assertEmitted(
+      (emission) => emission.target === "global" && emission.event === event,
+      query,
+      `Expected socket event "${event}" to have been broadcasted`
+    );
+  }
+  assertNotBroadcasted(event, query) {
+    this.#assertNotEmitted(
+      (emission) => emission.target === "global" && emission.event === event,
+      query,
+      `Expected socket event "${event}" not to have been broadcasted`
+    );
+  }
+  assertEmittedTo(channel, event, query) {
+    this.#assertEmitted(
+      (emission) => emission.target === "channel" && emission.channel === channel && emission.event === event,
+      query,
+      `Expected socket event "${event}" to have been emitted to channel "${channel}"`
+    );
+  }
+  assertNotEmittedTo(channel, event, query) {
+    this.#assertNotEmitted(
+      (emission) => emission.target === "channel" && emission.channel === channel && emission.event === event,
+      query,
+      `Expected socket event "${event}" not to have been emitted to channel "${channel}"`
+    );
+  }
+  assertEmittedToUser(userId, event, query) {
+    this.#assertEmitted(
+      (emission) => emission.target === "user" && emission.userId === userId && emission.event === event,
+      query,
+      `Expected socket event "${event}" to have been emitted to user "${String(userId)}"`
+    );
+  }
+  assertNotEmittedToUser(userId, event, query) {
+    this.#assertNotEmitted(
+      (emission) => emission.target === "user" && emission.userId === userId && emission.event === event,
+      query,
+      `Expected socket event "${event}" not to have been emitted to user "${String(userId)}"`
+    );
+  }
+  assertEmittedCount(count, query) {
+    const actual = this.#matching(query).length;
+    if (actual !== count) {
+      throw new AssertionError({
+        message: `Expected ${count} socket event(s) to have been emitted, but found ${actual}`,
+        actual,
+        expected: count,
+        operator: "strictEqual"
+      });
+    }
+  }
+  assertNothingEmitted() {
+    this.assertEmittedCount(0);
+  }
+  #assertEmitted(predicate, query, message) {
+    const matching = this.#emissions.filter((emission) => {
+      return predicate(emission) && this.#matchesQuery(emission, query);
+    });
+    if (matching.length === 0) {
+      throw new AssertionError({
+        message,
+        actual: this.#emissions,
+        expected: query,
+        operator: "includes"
+      });
+    }
+  }
+  #assertNotEmitted(predicate, query, message) {
+    const matching = this.#emissions.filter((emission) => {
+      return predicate(emission) && this.#matchesQuery(emission, query);
+    });
+    if (matching.length > 0) {
+      throw new AssertionError({
+        message,
+        actual: matching,
+        expected: [],
+        operator: "doesNotInclude"
+      });
+    }
+  }
+  #matching(query) {
+    return this.#emissions.filter((emission) => {
+      if (query?.target && emission.target !== query.target) {
+        return false;
+      }
+      if (query?.event && emission.event !== query.event) {
+        return false;
+      }
+      if (query?.channel && (!("channel" in emission) || emission.channel !== query.channel)) {
+        return false;
+      }
+      if (query?.userId !== void 0 && (!("userId" in emission) || emission.userId !== query.userId)) {
+        return false;
+      }
+      return this.#matchesQuery(emission, query);
+    });
+  }
+  #matchesQuery(emission, query) {
+    if (!query) {
+      return true;
+    }
+    if ("data" in query) {
+      if (typeof query.data === "function") {
+        if (!query.data(emission.data)) {
+          return false;
+        }
+      } else if (!isDeepStrictEqual(emission.data, query.data)) {
+        return false;
+      }
+    }
+    if ("except" in query) {
+      if (typeof query.except === "function") {
+        if (!query.except("except" in emission ? emission.except : void 0)) {
+          return false;
+        }
+      } else if (!isDeepStrictEqual(("except" in emission ? emission.except : void 0) ?? [], query.except)) {
+        return false;
+      }
+    }
+    return true;
+  }
+};
+
+export {
+  SocketFake
+};
+//# sourceMappingURL=chunk-B4Y3TNDI.js.map

package/build/chunk-B4Y3TNDI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fake_socket.ts"],"sourcesContent":["import { AssertionError } from 'node:assert'\nimport { isDeepStrictEqual } from 'node:util'\nimport type { SocketEmission, SocketEmissionSink, SocketEmissionTarget } from './broadcasting.js'\n\nexport type SocketFakeTarget = SocketEmissionTarget\nexport type SocketFakeEmission = SocketEmission\n\nexport interface SocketFakeEmissionQuery {\n  data?: unknown | ((data: unknown) => boolean)\n  except?: string[] | ((except: string[] | undefined) => boolean)\n}\n\nexport interface SocketFakeCountQuery extends SocketFakeEmissionQuery {\n  target?: SocketFakeTarget\n  event?: string\n  channel?: string\n  userId?: string | number\n}\n\nexport class SocketFake implements SocketEmissionSink {\n  #emissions: SocketFakeEmission[] = []\n  #restore: () => void\n\n  constructor(restore: () => void) {\n    this.#restore = restore\n  }\n\n  get emissions(): SocketFakeEmission[] {\n    return [...this.#emissions]\n  }\n\n  record(emission: SocketFakeEmission): void {\n    this.#emissions.push({\n      ...emission,\n      ...('except' in emission && emission.except ? { except: [...emission.except] } : {}),\n    })\n  }\n\n  dispatch(emission: SocketFakeEmission): void {\n    this.record(emission)\n  }\n\n  clear(): void {\n    this.#emissions = []\n  }\n\n  restore(): void {\n    this.#restore()\n  }\n\n  [Symbol.dispose](): void {\n    this.restore()\n  }\n\n  assertBroadcasted(event: string, query?: SocketFakeEmissionQuery): void {\n    this.#assertEmitted(\n      (emission) => emission.target === 'global' && emission.event === event,\n      query,\n      `Expected socket event \"${event}\" to have been broadcasted`\n    )\n  }\n\n  assertNotBroadcasted(event: string, query?: SocketFakeEmissionQuery): void {\n    this.#assertNotEmitted(\n      (emission) => emission.target === 'global' && emission.event === event,\n      query,\n      `Expected socket event \"${event}\" not to have been broadcasted`\n    )\n  }\n\n  assertEmittedTo(channel: string, event: string, query?: SocketFakeEmissionQuery): void {\n    this.#assertEmitted(\n      (emission) =>\n        emission.target === 'channel' && emission.channel === channel && emission.event === event,\n      query,\n      `Expected socket event \"${event}\" to have been emitted to channel \"${channel}\"`\n    )\n  }\n\n  assertNotEmittedTo(channel: string, event: string, query?: SocketFakeEmissionQuery): void {\n    this.#assertNotEmitted(\n      (emission) =>\n        emission.target === 'channel' && emission.channel === channel && emission.event === event,\n      query,\n      `Expected socket event \"${event}\" not to have been emitted to channel \"${channel}\"`\n    )\n  }\n\n  assertEmittedToUser(\n    userId: string | number,\n    event: string,\n    query?: SocketFakeEmissionQuery\n  ): void {\n    this.#assertEmitted(\n      (emission) =>\n        emission.target === 'user' && emission.userId === userId && emission.event === event,\n      query,\n      `Expected socket event \"${event}\" to have been emitted to user \"${String(userId)}\"`\n    )\n  }\n\n  assertNotEmittedToUser(\n    userId: string | number,\n    event: string,\n    query?: SocketFakeEmissionQuery\n  ): void {\n    this.#assertNotEmitted(\n      (emission) =>\n        emission.target === 'user' && emission.userId === userId && emission.event === event,\n      query,\n      `Expected socket event \"${event}\" not to have been emitted to user \"${String(userId)}\"`\n    )\n  }\n\n  assertEmittedCount(count: number, query?: SocketFakeCountQuery): void {\n    const actual = this.#matching(query).length\n\n    if (actual !== count) {\n      throw new AssertionError({\n        message: `Expected ${count} socket event(s) to have been emitted, but found ${actual}`,\n        actual,\n        expected: count,\n        operator: 'strictEqual',\n      })\n    }\n  }\n\n  assertNothingEmitted(): void {\n    this.assertEmittedCount(0)\n  }\n\n  #assertEmitted(\n    predicate: (emission: SocketFakeEmission) => boolean,\n    query: SocketFakeEmissionQuery | undefined,\n    message: string\n  ): void {\n    const matching = this.#emissions.filter((emission) => {\n      return predicate(emission) && this.#matchesQuery(emission, query)\n    })\n\n    if (matching.length === 0) {\n      throw new AssertionError({\n        message,\n        actual: this.#emissions,\n        expected: query,\n        operator: 'includes',\n      })\n    }\n  }\n\n  #assertNotEmitted(\n    predicate: (emission: SocketFakeEmission) => boolean,\n    query: SocketFakeEmissionQuery | undefined,\n    message: string\n  ): void {\n    const matching = this.#emissions.filter((emission) => {\n      return predicate(emission) && this.#matchesQuery(emission, query)\n    })\n\n    if (matching.length > 0) {\n      throw new AssertionError({\n        message,\n        actual: matching,\n        expected: [],\n        operator: 'doesNotInclude',\n      })\n    }\n  }\n\n  #matching(query: SocketFakeCountQuery | undefined): SocketFakeEmission[] {\n    return this.#emissions.filter((emission) => {\n      if (query?.target && emission.target !== query.target) {\n        return false\n      }\n\n      if (query?.event && emission.event !== query.event) {\n        return false\n      }\n\n      if (query?.channel && (!('channel' in emission) || emission.channel !== query.channel)) {\n        return false\n      }\n\n      if (\n        query?.userId !== undefined &&\n        (!('userId' in emission) || emission.userId !== query.userId)\n      ) {\n        return false\n      }\n\n      return this.#matchesQuery(emission, query)\n    })\n  }\n\n  #matchesQuery(emission: SocketFakeEmission, query: SocketFakeEmissionQuery | undefined): boolean {\n    if (!query) {\n      return true\n    }\n\n    if ('data' in query) {\n      if (typeof query.data === 'function') {\n        if (!query.data(emission.data)) {\n          return false\n        }\n      } else if (!isDeepStrictEqual(emission.data, query.data)) {\n        return false\n      }\n    }\n\n    if ('except' in query) {\n      if (typeof query.except === 'function') {\n        if (!query.except('except' in emission ? emission.except : undefined)) {\n          return false\n        }\n      } else if (\n        !isDeepStrictEqual(('except' in emission ? emission.except : undefined) ?? [], query.except)\n      ) {\n        return false\n      }\n    }\n\n    return true\n  }\n}\n"],"mappings":"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","names":[]}

package/build/{chunk-GKAD2UOA.js → chunk-D3HUBCBW.js}

@@ -15,4 +15,4 @@ export {
   channelMessageChannel,
   broadcastChannel
 };
-//# sourceMappingURL=chunk-GKAD2UOA.js.map
+//# sourceMappingURL=chunk-D3HUBCBW.js.map

package/build/chunk-D3HUBCBW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tracing_channels.ts"],"sourcesContent":["import diagnostics_channel from 'node:diagnostics_channel'\nimport type {\n  SocketBroadcastMessage,\n  SocketChannelMessage,\n  SocketConnectMessage,\n  SocketDisconnectMessage,\n  SocketSubscribeMessage,\n  SocketUnsubscribeMessage,\n} from './types/tracing_channels.js'\n\nexport const connectChannel = diagnostics_channel.tracingChannel<\n  SocketConnectMessage,\n  SocketConnectMessage\n>('rlanz.socket.connect')\n\nexport const disconnectChannel = diagnostics_channel.tracingChannel<\n  SocketDisconnectMessage,\n  SocketDisconnectMessage\n>('rlanz.socket.disconnect')\n\nexport const subscribeChannel = diagnostics_channel.tracingChannel<\n  SocketSubscribeMessage,\n  SocketSubscribeMessage\n>('rlanz.socket.subscribe')\n\nexport const unsubscribeChannel = diagnostics_channel.tracingChannel<\n  SocketUnsubscribeMessage,\n  SocketUnsubscribeMessage\n>('rlanz.socket.unsubscribe')\n\nexport const channelMessageChannel = diagnostics_channel.tracingChannel<\n  SocketChannelMessage,\n  SocketChannelMessage\n>('rlanz.socket.message')\n\nexport const broadcastChannel = diagnostics_channel.tracingChannel<\n  SocketBroadcastMessage,\n  SocketBroadcastMessage\n>('rlanz.socket.broadcast')\n"],"mappings":";AAAA,OAAO,yBAAyB;AAUzB,IAAM,iBAAiB,oBAAoB,eAGhD,sBAAsB;AAEjB,IAAM,oBAAoB,oBAAoB,eAGnD,yBAAyB;AAEpB,IAAM,mBAAmB,oBAAoB,eAGlD,wBAAwB;AAEnB,IAAM,qBAAqB,oBAAoB,eAGpD,0BAA0B;AAErB,IAAM,wBAAwB,oBAAoB,eAGvD,sBAAsB;AAEjB,IAAM,mBAAmB,oBAAoB,eAGlD,wBAAwB;","names":[]}

package/build/chunk-SFAY2ZA4.js

@@ -0,0 +1,28 @@
+// src/client/callback.ts
+function reportClientError(error) {
+  try {
+    const reportError = globalThis.reportError;
+    if (typeof reportError === "function") {
+      reportError(error);
+    } else {
+      console.error(error);
+    }
+  } catch {
+  }
+}
+function callClientHandler(handler, data) {
+  try {
+    const result = Reflect.apply(handler, void 0, [data]);
+    if (result && typeof result.then === "function") {
+      void Promise.resolve(result).catch(reportClientError);
+    }
+  } catch (error) {
+    reportClientError(error);
+  }
+}
+
+export {
+  reportClientError,
+  callClientHandler
+};
+//# sourceMappingURL=chunk-SFAY2ZA4.js.map

package/build/chunk-SFAY2ZA4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client/callback.ts"],"sourcesContent":["type Callable = (...args: never[]) => unknown\n\nexport function reportClientError(error: unknown): void {\n  try {\n    const reportError = (\n      globalThis as typeof globalThis & { reportError?: (error: unknown) => void }\n    ).reportError\n\n    if (typeof reportError === 'function') {\n      reportError(error)\n    } else {\n      console.error(error)\n    }\n  } catch {\n    // Error reporting must never affect socket state or create another rejected promise.\n  }\n}\n\nexport function callClientHandler(handler: Callable, data?: unknown): void {\n  try {\n    const result = Reflect.apply(handler, undefined, [data])\n    if (result && typeof (result as PromiseLike<unknown>).then === 'function') {\n      void Promise.resolve(result).catch(reportClientError)\n    }\n  } catch (error) {\n    reportClientError(error)\n  }\n}\n"],"mappings":";AAEO,SAAS,kBAAkB,OAAsB;AACtD,MAAI;AACF,UAAM,cACJ,WACA;AAEF,QAAI,OAAO,gBAAgB,YAAY;AACrC,kBAAY,KAAK;AAAA,IACnB,OAAO;AACL,cAAQ,MAAM,KAAK;AAAA,IACrB;AAAA,EACF,QAAQ;AAAA,EAER;AACF;AAEO,SAAS,kBAAkB,SAAmB,MAAsB;AACzE,MAAI;AACF,UAAM,SAAS,QAAQ,MAAM,SAAS,QAAW,CAAC,IAAI,CAAC;AACvD,QAAI,UAAU,OAAQ,OAAgC,SAAS,YAAY;AACzE,WAAK,QAAQ,QAAQ,MAAM,EAAE,MAAM,iBAAiB;AAAA,IACtD;AAAA,EACF,SAAS,OAAO;AACd,sBAAkB,KAAK;AAAA,EACzB;AACF;","names":[]}

package/build/{chunk-XUDFDJME.js → chunk-SHH6U4CI.js}

@@ -1,31 +1,34 @@
 // src/decorators.ts
-var CHANNEL_MESSAGE_HANDLERS = /* @__PURE__ */ Symbol("channel_message_handlers");
+var decoratedHandlers = /* @__PURE__ */ new WeakMap();
 function onMessage(event) {
   return (target, propertyKey, descriptor) => {
     if (typeof descriptor?.value !== "function") {
       throw new Error(`@onMessage("${event}") can only be used on methods`);
     }
-    const ctor = target.constructor;
-    const handlers = ctor[CHANNEL_MESSAGE_HANDLERS] ? [...ctor[CHANNEL_MESSAGE_HANDLERS]] : [];
+    const constructor = target.constructor;
+    const handlers = [...decoratedHandlers.get(constructor) ?? []];
     handlers.push({
       event,
       methodName: propertyKey
     });
-    ctor[CHANNEL_MESSAGE_HANDLERS] = handlers;
+    decoratedHandlers.set(constructor, handlers);
   };
 }
 function getDecoratedChannelHandlers(instance) {
   const constructors = [];
   let proto = Object.getPrototypeOf(instance);
   while (proto && proto !== Object.prototype) {
-    constructors.unshift(proto.constructor);
+    const constructor = Reflect.get(proto, "constructor");
+    if (typeof constructor === "function") {
+      constructors.unshift(constructor);
+    }
     proto = Object.getPrototypeOf(proto);
   }
   const handlers = {};
-  for (const ctor of constructors) {
-    const definitions = ctor[CHANNEL_MESSAGE_HANDLERS] ?? [];
+  for (const constructor of constructors) {
+    const definitions = decoratedHandlers.get(constructor) ?? [];
     for (const definition of definitions) {
-      const handler = instance[definition.methodName];
+      const handler = Reflect.get(instance, definition.methodName);
       if (typeof handler !== "function") {
         continue;
       }
@@ -39,4 +42,4 @@ export {
   onMessage,
   getDecoratedChannelHandlers
 };
-//# sourceMappingURL=chunk-XUDFDJME.js.map
+//# sourceMappingURL=chunk-SHH6U4CI.js.map

package/build/chunk-SHH6U4CI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/decorators.ts"],"sourcesContent":["import type { ChannelHandlerMap } from './types.js'\n\ntype ChannelMessageHandlerDefinition = {\n  event: string\n  methodName: string | symbol\n}\n\nconst decoratedHandlers = new WeakMap<object, ChannelMessageHandlerDefinition[]>()\n\n/**\n * Method decorator used to bind an incoming channel event to a method.\n */\nexport function onMessage<EventName extends string>(event: EventName): MethodDecorator {\n  return (target, propertyKey, descriptor) => {\n    if (typeof descriptor?.value !== 'function') {\n      throw new Error(`@onMessage(\"${event}\") can only be used on methods`)\n    }\n\n    const constructor = target.constructor\n    const handlers = [...(decoratedHandlers.get(constructor) ?? [])]\n\n    handlers.push({\n      event,\n      methodName: propertyKey,\n    })\n\n    decoratedHandlers.set(constructor, handlers)\n  }\n}\n\n/**\n * Resolve decorated handlers for a channel instance, including inherited ones.\n * Child classes override parent handlers when the event name is the same.\n */\nexport function getDecoratedChannelHandlers<User = unknown>(\n  instance: object\n): ChannelHandlerMap<User> {\n  const constructors: object[] = []\n\n  let proto = Object.getPrototypeOf(instance)\n  while (proto && proto !== Object.prototype) {\n    const constructor = Reflect.get(proto, 'constructor')\n    if (typeof constructor === 'function') {\n      constructors.unshift(constructor)\n    }\n    proto = Object.getPrototypeOf(proto)\n  }\n\n  const handlers: Record<string, unknown> = {}\n\n  for (const constructor of constructors) {\n    const definitions = decoratedHandlers.get(constructor) ?? []\n\n    for (const definition of definitions) {\n      const handler = Reflect.get(instance, definition.methodName)\n      if (typeof handler !== 'function') {\n        continue\n      }\n\n      handlers[definition.event] = handler.bind(instance)\n    }\n  }\n\n  return handlers as ChannelHandlerMap<User>\n}\n"],"mappings":";AAOA,IAAM,oBAAoB,oBAAI,QAAmD;AAK1E,SAAS,UAAoC,OAAmC;AACrF,SAAO,CAAC,QAAQ,aAAa,eAAe;AAC1C,QAAI,OAAO,YAAY,UAAU,YAAY;AAC3C,YAAM,IAAI,MAAM,eAAe,KAAK,gCAAgC;AAAA,IACtE;AAEA,UAAM,cAAc,OAAO;AAC3B,UAAM,WAAW,CAAC,GAAI,kBAAkB,IAAI,WAAW,KAAK,CAAC,CAAE;AAE/D,aAAS,KAAK;AAAA,MACZ;AAAA,MACA,YAAY;AAAA,IACd,CAAC;AAED,sBAAkB,IAAI,aAAa,QAAQ;AAAA,EAC7C;AACF;AAMO,SAAS,4BACd,UACyB;AACzB,QAAM,eAAyB,CAAC;AAEhC,MAAI,QAAQ,OAAO,eAAe,QAAQ;AAC1C,SAAO,SAAS,UAAU,OAAO,WAAW;AAC1C,UAAM,cAAc,QAAQ,IAAI,OAAO,aAAa;AACpD,QAAI,OAAO,gBAAgB,YAAY;AACrC,mBAAa,QAAQ,WAAW;AAAA,IAClC;AACA,YAAQ,OAAO,eAAe,KAAK;AAAA,EACrC;AAEA,QAAM,WAAoC,CAAC;AAE3C,aAAW,eAAe,cAAc;AACtC,UAAM,cAAc,kBAAkB,IAAI,WAAW,KAAK,CAAC;AAE3D,eAAW,cAAc,aAAa;AACpC,YAAM,UAAU,QAAQ,IAAI,UAAU,WAAW,UAAU;AAC3D,UAAI,OAAO,YAAY,YAAY;AACjC;AAAA,MACF;AAEA,eAAS,WAAW,KAAK,IAAI,QAAQ,KAAK,QAAQ;AAAA,IACpD;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}