@sygnl/subscriptions 1.0.0

package/dist/index.cjs

@@ -0,0 +1,247 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  SubscriptionManager: () => SubscriptionManager
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/SubscriptionManager.ts
+var import_talon = require("@sygnl/talon");
+var import_transports = require("@sygnl/talon/transports");
+var SubscriptionManager = class {
+  constructor(options) {
+    this.subscriptions = /* @__PURE__ */ new Map();
+    this.pendingSubscriptions = /* @__PURE__ */ new Map();
+    this.tempIdToServerIdMap = /* @__PURE__ */ new Map();
+    this.errorCallbacks = /* @__PURE__ */ new Set();
+    this.connectCallbacks = /* @__PURE__ */ new Set();
+    this.disconnectCallbacks = /* @__PURE__ */ new Set();
+    this.debug = options.debug ?? false;
+    this.talon = new import_talon.TalonClient({
+      transport: new import_transports.WebSocketTransport({
+        url: options.url,
+        debug: this.debug
+      }),
+      autoConnect: options.autoConnect ?? false,
+      debug: this.debug
+    });
+    this.talon.on("_connected", () => {
+      this.log("Connected via Talon");
+      this.resubscribeAll();
+      this.connectCallbacks.forEach((cb) => cb());
+    });
+    this.talon.on("_disconnected", () => {
+      this.log("Disconnected via Talon");
+      this.disconnectCallbacks.forEach((cb) => cb());
+      for (const sub of this.subscriptions.values()) {
+        sub.active = false;
+      }
+    });
+    this.talon.on("_error", (error) => {
+      this.emitError(error instanceof Error ? error : new Error(String(error)));
+    });
+    this.talon.on("subscribed", (data) => this.handleSubscribed(data));
+    this.talon.on("event", (data) => this.handleEvent(data));
+    this.talon.on("unsubscribed", (data) => this.handleUnsubscribed(data));
+    this.talon.on("error", (data) => this.emitError(new Error(data.error || "Unknown error")));
+  }
+  /**
+   * Connect to WebSocket server (via Talon)
+   */
+  async connect() {
+    return this.talon.connect();
+  }
+  /**
+   * Disconnect from WebSocket server (via Talon)
+   */
+  disconnect() {
+    this.talon.disconnect();
+  }
+  /**
+   * Subscribe to events with optional filters
+   * 
+   * @returns Unsubscribe function
+   */
+  subscribe(callback, options = {}) {
+    const tempId = crypto.randomUUID();
+    this.pendingSubscriptions.set(tempId, {
+      filters: options.filters || {},
+      callback
+    });
+    if (this.talon.connected) {
+      this.sendSubscribeRequest(tempId, options.filters || {});
+    }
+    return () => {
+      this.unsubscribe(tempId);
+    };
+  }
+  /**
+   * Unsubscribe from events
+   */
+  async unsubscribe(tempId) {
+    const serverSubId = this.tempIdToServerIdMap.get(tempId);
+    if (serverSubId) {
+      const sub = this.subscriptions.get(serverSubId);
+      if (sub) {
+        this.log("Unsubscribing:", serverSubId);
+        if (this.talon.connected) {
+          const request = {
+            type: "unsubscribe",
+            subscriptionId: serverSubId
+          };
+          await this.talon.send(request);
+        }
+        this.subscriptions.delete(serverSubId);
+        this.tempIdToServerIdMap.delete(tempId);
+      }
+    }
+    this.pendingSubscriptions.delete(tempId);
+  }
+  /**
+   * Send subscribe request to server (via Talon)
+   */
+  async sendSubscribeRequest(tempId, filters) {
+    if (!this.talon.connected) {
+      this.log("Cannot subscribe: not connected");
+      return;
+    }
+    const request = {
+      type: "subscribe",
+      filters
+    };
+    this.log("Subscribing with filters:", filters);
+    await this.talon.send(request);
+  }
+  /**
+   * Resubscribe to all active subscriptions (after reconnect)
+   */
+  resubscribeAll() {
+    this.log("Resubscribing to", this.pendingSubscriptions.size, "subscriptions");
+    for (const [tempId, { filters, callback }] of this.pendingSubscriptions.entries()) {
+      this.sendSubscribeRequest(tempId, filters);
+    }
+  }
+  /**
+   * Handle subscription confirmation (from Talon)
+   */
+  handleSubscribed(message) {
+    const serverSubId = message.subscriptionId;
+    if (!serverSubId) return;
+    this.log("Subscription confirmed:", serverSubId);
+    const pending = Array.from(this.pendingSubscriptions.entries())[0];
+    if (!pending) return;
+    const [tempId, { filters, callback }] = pending;
+    this.tempIdToServerIdMap.set(tempId, serverSubId);
+    this.subscriptions.set(serverSubId, {
+      id: serverSubId,
+      filters,
+      callback,
+      active: true
+    });
+    this.pendingSubscriptions.delete(tempId);
+  }
+  /**
+   * Handle incoming event (from Talon)
+   */
+  handleEvent(message) {
+    const subId = message.subscriptionId;
+    if (!subId) return;
+    const sub = this.subscriptions.get(subId);
+    if (!sub || !sub.active) {
+      this.log("Received event for unknown/inactive subscription:", subId);
+      return;
+    }
+    try {
+      sub.callback(message.data);
+    } catch (error) {
+      this.log("Error in subscription callback:", error);
+      this.emitError(error instanceof Error ? error : new Error("Callback error"));
+    }
+  }
+  /**
+   * Handle unsubscribe confirmation (from Talon)
+   */
+  handleUnsubscribed(message) {
+    const subId = message.subscriptionId;
+    if (!subId) return;
+    this.log("Unsubscribe confirmed:", subId);
+    this.subscriptions.delete(subId);
+  }
+  /**
+   * Register error callback
+   */
+  onError(callback) {
+    this.errorCallbacks.add(callback);
+    return () => this.errorCallbacks.delete(callback);
+  }
+  /**
+   * Register connect callback
+   */
+  onConnect(callback) {
+    this.connectCallbacks.add(callback);
+    return () => this.connectCallbacks.delete(callback);
+  }
+  /**
+   * Register disconnect callback
+   */
+  onDisconnect(callback) {
+    this.disconnectCallbacks.add(callback);
+    return () => this.disconnectCallbacks.delete(callback);
+  }
+  /**
+   * Emit error to all error callbacks
+   */
+  emitError(error) {
+    this.errorCallbacks.forEach((cb) => {
+      try {
+        cb(error);
+      } catch (err) {
+        this.log("Error in error callback:", err);
+      }
+    });
+  }
+  /**
+   * Check if connected (via Talon)
+   */
+  isConnected() {
+    return this.talon.connected;
+  }
+  /**
+   * Get number of active subscriptions
+   */
+  getSubscriptionCount() {
+    return this.subscriptions.size;
+  }
+  /**
+   * Debug logging
+   */
+  log(...args) {
+    if (this.debug) {
+      console.log("[SubscriptionManager]", ...args);
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SubscriptionManager
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/SubscriptionManager.ts"],"sourcesContent":["/**\n * @sygnl/subscriptions\n * \n * Real-time event subscriptions via WebSocket with filtering and type-safe callbacks.\n * \n * @example\n * ```typescript\n * import { SubscriptionManager } from '@sygnl/subscriptions';\n * \n * const manager = new SubscriptionManager({\n *   url: 'wss://your-worker.workers.dev/subscribe',\n *   autoConnect: true,\n *   debug: true\n * });\n * \n * // Subscribe to purchase events\n * const unsubscribe = manager.subscribe((event) => {\n *   console.log('Purchase:', event);\n * }, {\n *   filters: {\n *     eventTypes: ['purchase']\n *   }\n * });\n * \n * // Later: unsubscribe()\n * ```\n */\n\nexport { SubscriptionManager } from './SubscriptionManager';\nexport type {\n  SubscriptionManagerOptions,\n  SubscriptionOptions,\n  SubscriptionFilter,\n  SubscriptionCallback,\n  ErrorCallback,\n  SubscriptionMessage,\n  SubscriptionRequest,\n  ActiveSubscription,\n} from './types';\n","/**\n * SubscriptionManager - Real-time event subscriptions\n * \n * Built on top of @sygnl/talon for WebSocket management.\n * Provides high-level subscription API with filtering.\n */\n\nimport { TalonClient } from '@sygnl/talon';\nimport { WebSocketTransport } from '@sygnl/talon/transports';\nimport type { AnyEvent } from '@sygnl/event-schema';\n\nimport type {\n  SubscriptionManagerOptions,\n  SubscriptionOptions,\n  SubscriptionFilter,\n  SubscriptionCallback,\n  ErrorCallback,\n  SubscriptionMessage,\n  SubscriptionRequest,\n  ActiveSubscription,\n} from './types';\n\nexport class SubscriptionManager {\n  private talon: TalonClient;\n  private subscriptions: Map<string, ActiveSubscription> = new Map();\n  private pendingSubscriptions: Map<string, {\n    filters: SubscriptionFilter;\n    callback: SubscriptionCallback;\n  }> = new Map();\n  private tempIdToServerIdMap: Map<string, string> = new Map();\n  \n  private debug: boolean;\n  \n  private errorCallbacks: Set<ErrorCallback> = new Set();\n  private connectCallbacks: Set<() => void> = new Set();\n  private disconnectCallbacks: Set<() => void> = new Set();\n\n  constructor(options: SubscriptionManagerOptions) {\n    this.debug = options.debug ?? false;\n\n    // Use Talon for WebSocket management!\n    this.talon = new TalonClient({\n      transport: new WebSocketTransport({\n        url: options.url,\n        debug: this.debug,\n      }),\n      autoConnect: options.autoConnect ?? false,\n      debug: this.debug,\n    });\n\n    // Listen to Talon events\n    this.talon.on('_connected', () => {\n      this.log('Connected via Talon');\n      this.resubscribeAll();\n      this.connectCallbacks.forEach((cb) => cb());\n    });\n\n    this.talon.on('_disconnected', () => {\n      this.log('Disconnected via Talon');\n      this.disconnectCallbacks.forEach((cb) => cb());\n      \n      // Mark all subscriptions as inactive\n      for (const sub of this.subscriptions.values()) {\n        sub.active = false;\n      }\n    });\n\n    this.talon.on('_error', (error: any) => {\n      this.emitError(error instanceof Error ? error : new Error(String(error)));\n    });\n\n    // Listen for subscription-specific messages\n    this.talon.on('subscribed', (data: any) => this.handleSubscribed(data));\n    this.talon.on('event', (data: any) => this.handleEvent(data));\n    this.talon.on('unsubscribed', (data: any) => this.handleUnsubscribed(data));\n    this.talon.on('error', (data: any) => this.emitError(new Error(data.error || 'Unknown error')));\n  }\n\n  /**\n   * Connect to WebSocket server (via Talon)\n   */\n  async connect(): Promise<void> {\n    return this.talon.connect();\n  }\n\n  /**\n   * Disconnect from WebSocket server (via Talon)\n   */\n  disconnect(): void {\n    this.talon.disconnect();\n  }\n\n  /**\n   * Subscribe to events with optional filters\n   * \n   * @returns Unsubscribe function\n   */\n  subscribe<T = any>(\n    callback: SubscriptionCallback<T>,\n    options: SubscriptionOptions = {}\n  ): () => void {\n    const tempId = crypto.randomUUID();\n    \n    // Store as pending until server confirms\n    this.pendingSubscriptions.set(tempId, {\n      filters: options.filters || {},\n      callback,\n    });\n\n    // Send subscribe request if connected (via Talon)\n    if (this.talon.connected) {\n      this.sendSubscribeRequest(tempId, options.filters || {});\n    }\n\n    // Return unsubscribe function\n    return () => {\n      this.unsubscribe(tempId);\n    };\n  }\n\n  /**\n   * Unsubscribe from events\n   */\n  private async unsubscribe(tempId: string): Promise<void> {\n    // Map temp ID to server ID\n    const serverSubId = this.tempIdToServerIdMap.get(tempId);\n    \n    if (serverSubId) {\n      const sub = this.subscriptions.get(serverSubId);\n      \n      if (sub) {\n        this.log('Unsubscribing:', serverSubId);\n        \n        // Send unsubscribe request via Talon\n        if (this.talon.connected) {\n          const request: SubscriptionRequest = {\n            type: 'unsubscribe',\n            subscriptionId: serverSubId,\n          };\n          await this.talon.send(request as any);\n        }\n\n        // Remove from active subscriptions\n        this.subscriptions.delete(serverSubId);\n        this.tempIdToServerIdMap.delete(tempId);\n      }\n    }\n\n    // Also check pending\n    this.pendingSubscriptions.delete(tempId);\n  }\n\n  /**\n   * Send subscribe request to server (via Talon)\n   */\n  private async sendSubscribeRequest(tempId: string, filters: SubscriptionFilter): Promise<void> {\n    if (!this.talon.connected) {\n      this.log('Cannot subscribe: not connected');\n      return;\n    }\n\n    const request: SubscriptionRequest = {\n      type: 'subscribe',\n      filters,\n    };\n\n    this.log('Subscribing with filters:', filters);\n    await this.talon.send(request as any);\n  }\n\n  /**\n   * Resubscribe to all active subscriptions (after reconnect)\n   */\n  private resubscribeAll(): void {\n    this.log('Resubscribing to', this.pendingSubscriptions.size, 'subscriptions');\n\n    for (const [tempId, { filters, callback }] of this.pendingSubscriptions.entries()) {\n      this.sendSubscribeRequest(tempId, filters);\n    }\n  }\n\n  /**\n   * Handle subscription confirmation (from Talon)\n   */\n  private handleSubscribed(message: any): void {\n    const serverSubId = message.subscriptionId;\n    if (!serverSubId) return;\n\n    this.log('Subscription confirmed:', serverSubId);\n\n    // Find the pending subscription\n    const pending = Array.from(this.pendingSubscriptions.entries())[0];\n    if (!pending) return;\n\n    const [tempId, { filters, callback }] = pending;\n\n    // Map temp ID to server ID\n    this.tempIdToServerIdMap.set(tempId, serverSubId);\n\n    // Move from pending to active\n    this.subscriptions.set(serverSubId, {\n      id: serverSubId,\n      filters,\n      callback,\n      active: true,\n    });\n    this.pendingSubscriptions.delete(tempId);\n  }\n\n  /**\n   * Handle incoming event (from Talon)\n   */\n  private handleEvent(message: any): void {\n    const subId = message.subscriptionId;\n    if (!subId) return;\n\n    const sub = this.subscriptions.get(subId);\n    if (!sub || !sub.active) {\n      this.log('Received event for unknown/inactive subscription:', subId);\n      return;\n    }\n\n    // Call the subscription callback\n    try {\n      sub.callback(message.data);\n    } catch (error) {\n      this.log('Error in subscription callback:', error);\n      this.emitError(error instanceof Error ? error : new Error('Callback error'));\n    }\n  }\n\n  /**\n   * Handle unsubscribe confirmation (from Talon)\n   */\n  private handleUnsubscribed(message: any): void {\n    const subId = message.subscriptionId;\n    if (!subId) return;\n\n    this.log('Unsubscribe confirmed:', subId);\n    this.subscriptions.delete(subId);\n  }\n\n  /**\n   * Register error callback\n   */\n  onError(callback: ErrorCallback): () => void {\n    this.errorCallbacks.add(callback);\n    return () => this.errorCallbacks.delete(callback);\n  }\n\n  /**\n   * Register connect callback\n   */\n  onConnect(callback: () => void): () => void {\n    this.connectCallbacks.add(callback);\n    return () => this.connectCallbacks.delete(callback);\n  }\n\n  /**\n   * Register disconnect callback\n   */\n  onDisconnect(callback: () => void): () => void {\n    this.disconnectCallbacks.add(callback);\n    return () => this.disconnectCallbacks.delete(callback);\n  }\n\n  /**\n   * Emit error to all error callbacks\n   */\n  private emitError(error: Error): void {\n    this.errorCallbacks.forEach((cb) => {\n      try {\n        cb(error);\n      } catch (err) {\n        this.log('Error in error callback:', err);\n      }\n    });\n  }\n\n  /**\n   * Check if connected (via Talon)\n   */\n  isConnected(): boolean {\n    return this.talon.connected;\n  }\n\n  /**\n   * Get number of active subscriptions\n   */\n  getSubscriptionCount(): number {\n    return this.subscriptions.size;\n  }\n\n  /**\n   * Debug logging\n   */\n  private log(...args: any[]): void {\n    if (this.debug) {\n      console.log('[SubscriptionManager]', ...args);\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,228 @@
+/**
+ * Type definitions for subscriptions
+ */
+/**
+ * Subscription filter
+ */
+interface SubscriptionFilter {
+    /**
+     * Filter by event types
+     */
+    eventTypes?: string[];
+    /**
+     * Filter by user ID
+     */
+    userId?: string;
+    /**
+     * Filter by session ID
+     */
+    sessionId?: string;
+    /**
+     * Filter by custom properties
+     */
+    properties?: Record<string, any>;
+    /**
+     * Time range filter (Unix timestamp ms)
+     */
+    timeRange?: {
+        start?: number;
+        end?: number;
+    };
+}
+/**
+ * Subscription message from server
+ */
+interface SubscriptionMessage {
+    /**
+     * Message type
+     */
+    type: 'subscribed' | 'unsubscribed' | 'event' | 'error';
+    /**
+     * Subscription ID
+     */
+    subscriptionId?: string;
+    /**
+     * Event data (when type is 'event')
+     */
+    data?: any;
+    /**
+     * Error message (when type is 'error')
+     */
+    error?: string;
+}
+/**
+ * Client subscription request
+ */
+interface SubscriptionRequest {
+    /**
+     * Request type
+     */
+    type: 'subscribe' | 'unsubscribe';
+    /**
+     * Subscription ID (for unsubscribe)
+     */
+    subscriptionId?: string;
+    /**
+     * Filters (for subscribe)
+     */
+    filters?: SubscriptionFilter;
+}
+/**
+ * Subscription callback
+ */
+type SubscriptionCallback<T = any> = (event: T) => void;
+/**
+ * Subscription error callback
+ */
+type ErrorCallback = (error: Error) => void;
+/**
+ * Subscription options
+ */
+interface SubscriptionOptions {
+    /**
+     * Filters for this subscription
+     */
+    filters?: SubscriptionFilter;
+    /**
+     * Auto-reconnect on disconnect
+     * @default true
+     */
+    autoReconnect?: boolean;
+    /**
+     * Debug mode
+     * @default false
+     */
+    debug?: boolean;
+}
+/**
+ * Subscription manager options
+ */
+interface SubscriptionManagerOptions {
+    /**
+     * WebSocket URL
+     */
+    url: string;
+    /**
+     * Auto-connect on initialization
+     * @default false
+     */
+    autoConnect?: boolean;
+    /**
+     * Debug mode
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Connection timeout (ms)
+     * @default 5000
+     */
+    connectionTimeout?: number;
+}
+/**
+ * Active subscription
+ */
+interface ActiveSubscription {
+    /**
+     * Subscription ID from server
+     */
+    id: string;
+    /**
+     * Filters for this subscription
+     */
+    filters: SubscriptionFilter;
+    /**
+     * Callback function
+     */
+    callback: SubscriptionCallback;
+    /**
+     * Whether subscription is active
+     */
+    active: boolean;
+}
+
+/**
+ * SubscriptionManager - Real-time event subscriptions
+ *
+ * Built on top of @sygnl/talon for WebSocket management.
+ * Provides high-level subscription API with filtering.
+ */
+
+declare class SubscriptionManager {
+    private talon;
+    private subscriptions;
+    private pendingSubscriptions;
+    private tempIdToServerIdMap;
+    private debug;
+    private errorCallbacks;
+    private connectCallbacks;
+    private disconnectCallbacks;
+    constructor(options: SubscriptionManagerOptions);
+    /**
+     * Connect to WebSocket server (via Talon)
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from WebSocket server (via Talon)
+     */
+    disconnect(): void;
+    /**
+     * Subscribe to events with optional filters
+     *
+     * @returns Unsubscribe function
+     */
+    subscribe<T = any>(callback: SubscriptionCallback<T>, options?: SubscriptionOptions): () => void;
+    /**
+     * Unsubscribe from events
+     */
+    private unsubscribe;
+    /**
+     * Send subscribe request to server (via Talon)
+     */
+    private sendSubscribeRequest;
+    /**
+     * Resubscribe to all active subscriptions (after reconnect)
+     */
+    private resubscribeAll;
+    /**
+     * Handle subscription confirmation (from Talon)
+     */
+    private handleSubscribed;
+    /**
+     * Handle incoming event (from Talon)
+     */
+    private handleEvent;
+    /**
+     * Handle unsubscribe confirmation (from Talon)
+     */
+    private handleUnsubscribed;
+    /**
+     * Register error callback
+     */
+    onError(callback: ErrorCallback): () => void;
+    /**
+     * Register connect callback
+     */
+    onConnect(callback: () => void): () => void;
+    /**
+     * Register disconnect callback
+     */
+    onDisconnect(callback: () => void): () => void;
+    /**
+     * Emit error to all error callbacks
+     */
+    private emitError;
+    /**
+     * Check if connected (via Talon)
+     */
+    isConnected(): boolean;
+    /**
+     * Get number of active subscriptions
+     */
+    getSubscriptionCount(): number;
+    /**
+     * Debug logging
+     */
+    private log;
+}
+
+export { type ActiveSubscription, type ErrorCallback, type SubscriptionCallback, type SubscriptionFilter, SubscriptionManager, type SubscriptionManagerOptions, type SubscriptionMessage, type SubscriptionOptions, type SubscriptionRequest };

package/dist/index.d.ts

@@ -0,0 +1,228 @@
+/**
+ * Type definitions for subscriptions
+ */
+/**
+ * Subscription filter
+ */
+interface SubscriptionFilter {
+    /**
+     * Filter by event types
+     */
+    eventTypes?: string[];
+    /**
+     * Filter by user ID
+     */
+    userId?: string;
+    /**
+     * Filter by session ID
+     */
+    sessionId?: string;
+    /**
+     * Filter by custom properties
+     */
+    properties?: Record<string, any>;
+    /**
+     * Time range filter (Unix timestamp ms)
+     */
+    timeRange?: {
+        start?: number;
+        end?: number;
+    };
+}
+/**
+ * Subscription message from server
+ */
+interface SubscriptionMessage {
+    /**
+     * Message type
+     */
+    type: 'subscribed' | 'unsubscribed' | 'event' | 'error';
+    /**
+     * Subscription ID
+     */
+    subscriptionId?: string;
+    /**
+     * Event data (when type is 'event')
+     */
+    data?: any;
+    /**
+     * Error message (when type is 'error')
+     */
+    error?: string;
+}
+/**
+ * Client subscription request
+ */
+interface SubscriptionRequest {
+    /**
+     * Request type
+     */
+    type: 'subscribe' | 'unsubscribe';
+    /**
+     * Subscription ID (for unsubscribe)
+     */
+    subscriptionId?: string;
+    /**
+     * Filters (for subscribe)
+     */
+    filters?: SubscriptionFilter;
+}
+/**
+ * Subscription callback
+ */
+type SubscriptionCallback<T = any> = (event: T) => void;
+/**
+ * Subscription error callback
+ */
+type ErrorCallback = (error: Error) => void;
+/**
+ * Subscription options
+ */
+interface SubscriptionOptions {
+    /**
+     * Filters for this subscription
+     */
+    filters?: SubscriptionFilter;
+    /**
+     * Auto-reconnect on disconnect
+     * @default true
+     */
+    autoReconnect?: boolean;
+    /**
+     * Debug mode
+     * @default false
+     */
+    debug?: boolean;
+}
+/**
+ * Subscription manager options
+ */
+interface SubscriptionManagerOptions {
+    /**
+     * WebSocket URL
+     */
+    url: string;
+    /**
+     * Auto-connect on initialization
+     * @default false
+     */
+    autoConnect?: boolean;
+    /**
+     * Debug mode
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Connection timeout (ms)
+     * @default 5000
+     */
+    connectionTimeout?: number;
+}
+/**
+ * Active subscription
+ */
+interface ActiveSubscription {
+    /**
+     * Subscription ID from server
+     */
+    id: string;
+    /**
+     * Filters for this subscription
+     */
+    filters: SubscriptionFilter;
+    /**
+     * Callback function
+     */
+    callback: SubscriptionCallback;
+    /**
+     * Whether subscription is active
+     */
+    active: boolean;
+}
+
+/**
+ * SubscriptionManager - Real-time event subscriptions
+ *
+ * Built on top of @sygnl/talon for WebSocket management.
+ * Provides high-level subscription API with filtering.
+ */
+
+declare class SubscriptionManager {
+    private talon;
+    private subscriptions;
+    private pendingSubscriptions;
+    private tempIdToServerIdMap;
+    private debug;
+    private errorCallbacks;
+    private connectCallbacks;
+    private disconnectCallbacks;
+    constructor(options: SubscriptionManagerOptions);
+    /**
+     * Connect to WebSocket server (via Talon)
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from WebSocket server (via Talon)
+     */
+    disconnect(): void;
+    /**
+     * Subscribe to events with optional filters
+     *
+     * @returns Unsubscribe function
+     */
+    subscribe<T = any>(callback: SubscriptionCallback<T>, options?: SubscriptionOptions): () => void;
+    /**
+     * Unsubscribe from events
+     */
+    private unsubscribe;
+    /**
+     * Send subscribe request to server (via Talon)
+     */
+    private sendSubscribeRequest;
+    /**
+     * Resubscribe to all active subscriptions (after reconnect)
+     */
+    private resubscribeAll;
+    /**
+     * Handle subscription confirmation (from Talon)
+     */
+    private handleSubscribed;
+    /**
+     * Handle incoming event (from Talon)
+     */
+    private handleEvent;
+    /**
+     * Handle unsubscribe confirmation (from Talon)
+     */
+    private handleUnsubscribed;
+    /**
+     * Register error callback
+     */
+    onError(callback: ErrorCallback): () => void;
+    /**
+     * Register connect callback
+     */
+    onConnect(callback: () => void): () => void;
+    /**
+     * Register disconnect callback
+     */
+    onDisconnect(callback: () => void): () => void;
+    /**
+     * Emit error to all error callbacks
+     */
+    private emitError;
+    /**
+     * Check if connected (via Talon)
+     */
+    isConnected(): boolean;
+    /**
+     * Get number of active subscriptions
+     */
+    getSubscriptionCount(): number;
+    /**
+     * Debug logging
+     */
+    private log;
+}
+
+export { type ActiveSubscription, type ErrorCallback, type SubscriptionCallback, type SubscriptionFilter, SubscriptionManager, type SubscriptionManagerOptions, type SubscriptionMessage, type SubscriptionOptions, type SubscriptionRequest };

package/dist/index.js

@@ -0,0 +1,220 @@
+// src/SubscriptionManager.ts
+import { TalonClient } from "@sygnl/talon";
+import { WebSocketTransport } from "@sygnl/talon/transports";
+var SubscriptionManager = class {
+  constructor(options) {
+    this.subscriptions = /* @__PURE__ */ new Map();
+    this.pendingSubscriptions = /* @__PURE__ */ new Map();
+    this.tempIdToServerIdMap = /* @__PURE__ */ new Map();
+    this.errorCallbacks = /* @__PURE__ */ new Set();
+    this.connectCallbacks = /* @__PURE__ */ new Set();
+    this.disconnectCallbacks = /* @__PURE__ */ new Set();
+    this.debug = options.debug ?? false;
+    this.talon = new TalonClient({
+      transport: new WebSocketTransport({
+        url: options.url,
+        debug: this.debug
+      }),
+      autoConnect: options.autoConnect ?? false,
+      debug: this.debug
+    });
+    this.talon.on("_connected", () => {
+      this.log("Connected via Talon");
+      this.resubscribeAll();
+      this.connectCallbacks.forEach((cb) => cb());
+    });
+    this.talon.on("_disconnected", () => {
+      this.log("Disconnected via Talon");
+      this.disconnectCallbacks.forEach((cb) => cb());
+      for (const sub of this.subscriptions.values()) {
+        sub.active = false;
+      }
+    });
+    this.talon.on("_error", (error) => {
+      this.emitError(error instanceof Error ? error : new Error(String(error)));
+    });
+    this.talon.on("subscribed", (data) => this.handleSubscribed(data));
+    this.talon.on("event", (data) => this.handleEvent(data));
+    this.talon.on("unsubscribed", (data) => this.handleUnsubscribed(data));
+    this.talon.on("error", (data) => this.emitError(new Error(data.error || "Unknown error")));
+  }
+  /**
+   * Connect to WebSocket server (via Talon)
+   */
+  async connect() {
+    return this.talon.connect();
+  }
+  /**
+   * Disconnect from WebSocket server (via Talon)
+   */
+  disconnect() {
+    this.talon.disconnect();
+  }
+  /**
+   * Subscribe to events with optional filters
+   * 
+   * @returns Unsubscribe function
+   */
+  subscribe(callback, options = {}) {
+    const tempId = crypto.randomUUID();
+    this.pendingSubscriptions.set(tempId, {
+      filters: options.filters || {},
+      callback
+    });
+    if (this.talon.connected) {
+      this.sendSubscribeRequest(tempId, options.filters || {});
+    }
+    return () => {
+      this.unsubscribe(tempId);
+    };
+  }
+  /**
+   * Unsubscribe from events
+   */
+  async unsubscribe(tempId) {
+    const serverSubId = this.tempIdToServerIdMap.get(tempId);
+    if (serverSubId) {
+      const sub = this.subscriptions.get(serverSubId);
+      if (sub) {
+        this.log("Unsubscribing:", serverSubId);
+        if (this.talon.connected) {
+          const request = {
+            type: "unsubscribe",
+            subscriptionId: serverSubId
+          };
+          await this.talon.send(request);
+        }
+        this.subscriptions.delete(serverSubId);
+        this.tempIdToServerIdMap.delete(tempId);
+      }
+    }
+    this.pendingSubscriptions.delete(tempId);
+  }
+  /**
+   * Send subscribe request to server (via Talon)
+   */
+  async sendSubscribeRequest(tempId, filters) {
+    if (!this.talon.connected) {
+      this.log("Cannot subscribe: not connected");
+      return;
+    }
+    const request = {
+      type: "subscribe",
+      filters
+    };
+    this.log("Subscribing with filters:", filters);
+    await this.talon.send(request);
+  }
+  /**
+   * Resubscribe to all active subscriptions (after reconnect)
+   */
+  resubscribeAll() {
+    this.log("Resubscribing to", this.pendingSubscriptions.size, "subscriptions");
+    for (const [tempId, { filters, callback }] of this.pendingSubscriptions.entries()) {
+      this.sendSubscribeRequest(tempId, filters);
+    }
+  }
+  /**
+   * Handle subscription confirmation (from Talon)
+   */
+  handleSubscribed(message) {
+    const serverSubId = message.subscriptionId;
+    if (!serverSubId) return;
+    this.log("Subscription confirmed:", serverSubId);
+    const pending = Array.from(this.pendingSubscriptions.entries())[0];
+    if (!pending) return;
+    const [tempId, { filters, callback }] = pending;
+    this.tempIdToServerIdMap.set(tempId, serverSubId);
+    this.subscriptions.set(serverSubId, {
+      id: serverSubId,
+      filters,
+      callback,
+      active: true
+    });
+    this.pendingSubscriptions.delete(tempId);
+  }
+  /**
+   * Handle incoming event (from Talon)
+   */
+  handleEvent(message) {
+    const subId = message.subscriptionId;
+    if (!subId) return;
+    const sub = this.subscriptions.get(subId);
+    if (!sub || !sub.active) {
+      this.log("Received event for unknown/inactive subscription:", subId);
+      return;
+    }
+    try {
+      sub.callback(message.data);
+    } catch (error) {
+      this.log("Error in subscription callback:", error);
+      this.emitError(error instanceof Error ? error : new Error("Callback error"));
+    }
+  }
+  /**
+   * Handle unsubscribe confirmation (from Talon)
+   */
+  handleUnsubscribed(message) {
+    const subId = message.subscriptionId;
+    if (!subId) return;
+    this.log("Unsubscribe confirmed:", subId);
+    this.subscriptions.delete(subId);
+  }
+  /**
+   * Register error callback
+   */
+  onError(callback) {
+    this.errorCallbacks.add(callback);
+    return () => this.errorCallbacks.delete(callback);
+  }
+  /**
+   * Register connect callback
+   */
+  onConnect(callback) {
+    this.connectCallbacks.add(callback);
+    return () => this.connectCallbacks.delete(callback);
+  }
+  /**
+   * Register disconnect callback
+   */
+  onDisconnect(callback) {
+    this.disconnectCallbacks.add(callback);
+    return () => this.disconnectCallbacks.delete(callback);
+  }
+  /**
+   * Emit error to all error callbacks
+   */
+  emitError(error) {
+    this.errorCallbacks.forEach((cb) => {
+      try {
+        cb(error);
+      } catch (err) {
+        this.log("Error in error callback:", err);
+      }
+    });
+  }
+  /**
+   * Check if connected (via Talon)
+   */
+  isConnected() {
+    return this.talon.connected;
+  }
+  /**
+   * Get number of active subscriptions
+   */
+  getSubscriptionCount() {
+    return this.subscriptions.size;
+  }
+  /**
+   * Debug logging
+   */
+  log(...args) {
+    if (this.debug) {
+      console.log("[SubscriptionManager]", ...args);
+    }
+  }
+};
+export {
+  SubscriptionManager
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/SubscriptionManager.ts"],"sourcesContent":["/**\n * SubscriptionManager - Real-time event subscriptions\n * \n * Built on top of @sygnl/talon for WebSocket management.\n * Provides high-level subscription API with filtering.\n */\n\nimport { TalonClient } from '@sygnl/talon';\nimport { WebSocketTransport } from '@sygnl/talon/transports';\nimport type { AnyEvent } from '@sygnl/event-schema';\n\nimport type {\n  SubscriptionManagerOptions,\n  SubscriptionOptions,\n  SubscriptionFilter,\n  SubscriptionCallback,\n  ErrorCallback,\n  SubscriptionMessage,\n  SubscriptionRequest,\n  ActiveSubscription,\n} from './types';\n\nexport class SubscriptionManager {\n  private talon: TalonClient;\n  private subscriptions: Map<string, ActiveSubscription> = new Map();\n  private pendingSubscriptions: Map<string, {\n    filters: SubscriptionFilter;\n    callback: SubscriptionCallback;\n  }> = new Map();\n  private tempIdToServerIdMap: Map<string, string> = new Map();\n  \n  private debug: boolean;\n  \n  private errorCallbacks: Set<ErrorCallback> = new Set();\n  private connectCallbacks: Set<() => void> = new Set();\n  private disconnectCallbacks: Set<() => void> = new Set();\n\n  constructor(options: SubscriptionManagerOptions) {\n    this.debug = options.debug ?? false;\n\n    // Use Talon for WebSocket management!\n    this.talon = new TalonClient({\n      transport: new WebSocketTransport({\n        url: options.url,\n        debug: this.debug,\n      }),\n      autoConnect: options.autoConnect ?? false,\n      debug: this.debug,\n    });\n\n    // Listen to Talon events\n    this.talon.on('_connected', () => {\n      this.log('Connected via Talon');\n      this.resubscribeAll();\n      this.connectCallbacks.forEach((cb) => cb());\n    });\n\n    this.talon.on('_disconnected', () => {\n      this.log('Disconnected via Talon');\n      this.disconnectCallbacks.forEach((cb) => cb());\n      \n      // Mark all subscriptions as inactive\n      for (const sub of this.subscriptions.values()) {\n        sub.active = false;\n      }\n    });\n\n    this.talon.on('_error', (error: any) => {\n      this.emitError(error instanceof Error ? error : new Error(String(error)));\n    });\n\n    // Listen for subscription-specific messages\n    this.talon.on('subscribed', (data: any) => this.handleSubscribed(data));\n    this.talon.on('event', (data: any) => this.handleEvent(data));\n    this.talon.on('unsubscribed', (data: any) => this.handleUnsubscribed(data));\n    this.talon.on('error', (data: any) => this.emitError(new Error(data.error || 'Unknown error')));\n  }\n\n  /**\n   * Connect to WebSocket server (via Talon)\n   */\n  async connect(): Promise<void> {\n    return this.talon.connect();\n  }\n\n  /**\n   * Disconnect from WebSocket server (via Talon)\n   */\n  disconnect(): void {\n    this.talon.disconnect();\n  }\n\n  /**\n   * Subscribe to events with optional filters\n   * \n   * @returns Unsubscribe function\n   */\n  subscribe<T = any>(\n    callback: SubscriptionCallback<T>,\n    options: SubscriptionOptions = {}\n  ): () => void {\n    const tempId = crypto.randomUUID();\n    \n    // Store as pending until server confirms\n    this.pendingSubscriptions.set(tempId, {\n      filters: options.filters || {},\n      callback,\n    });\n\n    // Send subscribe request if connected (via Talon)\n    if (this.talon.connected) {\n      this.sendSubscribeRequest(tempId, options.filters || {});\n    }\n\n    // Return unsubscribe function\n    return () => {\n      this.unsubscribe(tempId);\n    };\n  }\n\n  /**\n   * Unsubscribe from events\n   */\n  private async unsubscribe(tempId: string): Promise<void> {\n    // Map temp ID to server ID\n    const serverSubId = this.tempIdToServerIdMap.get(tempId);\n    \n    if (serverSubId) {\n      const sub = this.subscriptions.get(serverSubId);\n      \n      if (sub) {\n        this.log('Unsubscribing:', serverSubId);\n        \n        // Send unsubscribe request via Talon\n        if (this.talon.connected) {\n          const request: SubscriptionRequest = {\n            type: 'unsubscribe',\n            subscriptionId: serverSubId,\n          };\n          await this.talon.send(request as any);\n        }\n\n        // Remove from active subscriptions\n        this.subscriptions.delete(serverSubId);\n        this.tempIdToServerIdMap.delete(tempId);\n      }\n    }\n\n    // Also check pending\n    this.pendingSubscriptions.delete(tempId);\n  }\n\n  /**\n   * Send subscribe request to server (via Talon)\n   */\n  private async sendSubscribeRequest(tempId: string, filters: SubscriptionFilter): Promise<void> {\n    if (!this.talon.connected) {\n      this.log('Cannot subscribe: not connected');\n      return;\n    }\n\n    const request: SubscriptionRequest = {\n      type: 'subscribe',\n      filters,\n    };\n\n    this.log('Subscribing with filters:', filters);\n    await this.talon.send(request as any);\n  }\n\n  /**\n   * Resubscribe to all active subscriptions (after reconnect)\n   */\n  private resubscribeAll(): void {\n    this.log('Resubscribing to', this.pendingSubscriptions.size, 'subscriptions');\n\n    for (const [tempId, { filters, callback }] of this.pendingSubscriptions.entries()) {\n      this.sendSubscribeRequest(tempId, filters);\n    }\n  }\n\n  /**\n   * Handle subscription confirmation (from Talon)\n   */\n  private handleSubscribed(message: any): void {\n    const serverSubId = message.subscriptionId;\n    if (!serverSubId) return;\n\n    this.log('Subscription confirmed:', serverSubId);\n\n    // Find the pending subscription\n    const pending = Array.from(this.pendingSubscriptions.entries())[0];\n    if (!pending) return;\n\n    const [tempId, { filters, callback }] = pending;\n\n    // Map temp ID to server ID\n    this.tempIdToServerIdMap.set(tempId, serverSubId);\n\n    // Move from pending to active\n    this.subscriptions.set(serverSubId, {\n      id: serverSubId,\n      filters,\n      callback,\n      active: true,\n    });\n    this.pendingSubscriptions.delete(tempId);\n  }\n\n  /**\n   * Handle incoming event (from Talon)\n   */\n  private handleEvent(message: any): void {\n    const subId = message.subscriptionId;\n    if (!subId) return;\n\n    const sub = this.subscriptions.get(subId);\n    if (!sub || !sub.active) {\n      this.log('Received event for unknown/inactive subscription:', subId);\n      return;\n    }\n\n    // Call the subscription callback\n    try {\n      sub.callback(message.data);\n    } catch (error) {\n      this.log('Error in subscription callback:', error);\n      this.emitError(error instanceof Error ? error : new Error('Callback error'));\n    }\n  }\n\n  /**\n   * Handle unsubscribe confirmation (from Talon)\n   */\n  private handleUnsubscribed(message: any): void {\n    const subId = message.subscriptionId;\n    if (!subId) return;\n\n    this.log('Unsubscribe confirmed:', subId);\n    this.subscriptions.delete(subId);\n  }\n\n  /**\n   * Register error callback\n   */\n  onError(callback: ErrorCallback): () => void {\n    this.errorCallbacks.add(callback);\n    return () => this.errorCallbacks.delete(callback);\n  }\n\n  /**\n   * Register connect callback\n   */\n  onConnect(callback: () => void): () => void {\n    this.connectCallbacks.add(callback);\n    return () => this.connectCallbacks.delete(callback);\n  }\n\n  /**\n   * Register disconnect callback\n   */\n  onDisconnect(callback: () => void): () => void {\n    this.disconnectCallbacks.add(callback);\n    return () => this.disconnectCallbacks.delete(callback);\n  }\n\n  /**\n   * Emit error to all error callbacks\n   */\n  private emitError(error: Error): void {\n    this.errorCallbacks.forEach((cb) => {\n      try {\n        cb(error);\n      } catch (err) {\n        this.log('Error in error callback:', err);\n      }\n    });\n  }\n\n  /**\n   * Check if connected (via Talon)\n   */\n  isConnected(): boolean {\n    return this.talon.connected;\n  }\n\n  /**\n   * Get number of active subscriptions\n   */\n  getSubscriptionCount(): number {\n    return this.subscriptions.size;\n  }\n\n  /**\n   * Debug logging\n   */\n  private log(...args: any[]): void {\n    if (this.debug) {\n      console.log('[SubscriptionManager]', ...args);\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@sygnl/subscriptions",
+  "version": "1.0.0",
+  "description": "Real-time event subscriptions via WebSocket with filtering and type-safe callbacks",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "subscriptions",
+    "websocket",
+    "real-time",
+    "pub-sub",
+    "events",
+    "durable-objects",
+    "cloudflare"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@sygnl/event-schema": "^1.0.0",
+    "@sygnl/talon": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@vitest/coverage-v8": "^1.0.4",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3",
+    "vite-tsconfig-paths": "^6.0.4",
+    "vitest": "^1.0.4"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "author": "Edge Foundry, Inc.",
+  "license": "Apache-2.0"
+}