@spoosh/core 0.15.0 → 0.16.0

package/dist/index.js

@@ -26,6 +26,7 @@ __export(src_exports, {
   __DEV__: () => __DEV__,
   buildUrl: () => buildUrl,
   clone: () => clone,
+  composeAdapter: () => composeAdapter,
   containsFile: () => containsFile,
   createClient: () => createClient,
   createEventEmitter: () => createEventEmitter,
@@ -37,7 +38,9 @@ __export(src_exports, {
   createProxyHandler: () => createProxyHandler,
   createQueueController: () => createQueueController,
   createSelectorProxy: () => createSelectorProxy,
+  createSpooshPlugin: () => createSpooshPlugin,
   createStateManager: () => createStateManager,
+  createSubscriptionController: () => createSubscriptionController,
   createTracer: () => createTracer,
   executeFetch: () => executeFetch,
   extractMethodFromSelector: () => extractMethodFromSelector,
@@ -715,7 +718,7 @@ function createSelectorProxy(onCapture) {
       {},
       {
         get(_, prop) {
-          if (HTTP_METHODS.includes(prop)) {
+          if (typeof prop === "string" && prop === prop.toUpperCase()) {
             const selectorFn = (options) => {
               onCapture?.({
                 call: { path, method: prop, options },
@@ -1062,6 +1065,9 @@ function createPluginExecutor(initialPlugins = []) {
     getPlugins() {
       return frozenPlugins;
     },
+    getPluginsForOperation(operationType) {
+      return frozenPlugins.filter((p) => p.operations.includes(operationType));
+    },
     registerContextEnhancer(enhancer) {
       contextEnhancers.push(enhancer);
     },
@@ -1084,11 +1090,17 @@ function createPluginRegistry(plugins) {
   };
 }
 
+// src/plugins/create.ts
+function createSpooshPlugin(definition) {
+  return definition;
+}
+
 // src/Spoosh.ts
 var Spoosh = class _Spoosh {
   baseUrl;
   defaultOptions;
   _plugins;
+  _transports = /* @__PURE__ */ new Map();
   /**
    * Creates a new Spoosh instance.
    *
@@ -1113,10 +1125,13 @@ var Spoosh = class _Spoosh {
    * });
    * ```
    */
-  constructor(baseUrl, defaultOptions, plugins) {
+  constructor(baseUrl, defaultOptions, plugins, transports) {
     this.baseUrl = baseUrl;
     this.defaultOptions = defaultOptions || {};
     this._plugins = plugins || [];
+    if (transports) {
+      this._transports = transports;
+    }
   }
   /**
    * Adds plugins to the Spoosh instance.
@@ -1140,8 +1155,37 @@ var Spoosh = class _Spoosh {
     return new _Spoosh(
       this.baseUrl,
       this.defaultOptions,
-      plugins
+      plugins,
+      this._transports
+    );
+  }
+  /**
+   * Registers transport implementations for real-time operations.
+   *
+   * @param transports - Array of transport instances to register
+   * @returns This Spoosh instance for method chaining
+   *
+   * @example
+   * ```ts
+   * import { sse } from '@spoosh/transport-sse';
+   *
+   * const spoosh = new Spoosh<Schema, Error>('/api')
+   *   .withTransports([sse()])
+   *   .use([...]);
+   * ```
+   */
+  withTransports(transports) {
+    const newTransports = new Map(this._transports);
+    for (const transport of transports) {
+      newTransports.set(transport.name, transport);
+    }
+    const instance = new _Spoosh(
+      this.baseUrl,
+      this.defaultOptions,
+      this._plugins,
+      newTransports
     );
+    return instance;
   }
   /**
    * Cached instance of the underlying SpooshInstance.
@@ -1168,6 +1212,7 @@ var Spoosh = class _Spoosh {
         stateManager,
         eventEmitter,
         pluginExecutor,
+        transports: this._transports,
         config: {
           baseUrl: this.baseUrl,
           defaultOptions: this.defaultOptions
@@ -1175,7 +1220,8 @@ var Spoosh = class _Spoosh {
         _types: {
           schema: void 0,
           defaultError: void 0,
-          plugins: this._plugins
+          plugins: this._plugins,
+          transports: void 0
         }
       };
     }
@@ -1285,6 +1331,18 @@ var Spoosh = class _Spoosh {
   get _types() {
     return this.getInstance()._types;
   }
+  /**
+   * Map of registered transport implementations.
+   *
+   * @example
+   * ```ts
+   * const { transports } = client;
+   * const sseTransport = transports.get('sse');
+   * ```
+   */
+  get transports() {
+    return this.getInstance().transports;
+  }
 };
 
 // src/createClient.ts
@@ -1296,6 +1354,16 @@ function createClient(baseUrl, defaultOptions) {
   });
 }
 
+// src/transport/compose.ts
+function composeAdapter(baseAdapter, plugins) {
+  return plugins.reduce((adapter, plugin) => {
+    if (plugin.wrapAdapter) {
+      return plugin.wrapAdapter(adapter);
+    }
+    return adapter;
+  }, baseAdapter);
+}
+
 // src/controllers/base/controller.ts
 function createOperationController(options) {
   const {
@@ -2239,3 +2307,190 @@ function createQueueController(config, context) {
     }
   };
 }
+
+// src/controllers/subscription/controller.ts
+function createSubscriptionController(options) {
+  const {
+    channel,
+    baseAdapter,
+    pluginExecutor,
+    operationType,
+    stateManager,
+    eventEmitter,
+    queryKey,
+    path,
+    method,
+    instanceId
+  } = options;
+  const plugins = pluginExecutor.getPluginsForOperation(operationType);
+  const adapter = composeAdapter(
+    baseAdapter,
+    plugins
+  );
+  let handle = null;
+  const subscribers = /* @__PURE__ */ new Set();
+  let subscriptionVersion = 0;
+  let cachedState = {
+    data: void 0,
+    error: void 0,
+    isConnected: false
+  };
+  const updateStateFromHandle = () => {
+    if (!handle) return;
+    const newData = handle.getData();
+    const newError = handle.getError();
+    if (newData !== cachedState.data || newError !== cachedState.error) {
+      cachedState = {
+        data: newData,
+        error: newError,
+        isConnected: true
+      };
+    }
+  };
+  const notify = () => {
+    subscribers.forEach((callback) => callback());
+  };
+  const createContext = () => {
+    const baseCtx = pluginExecutor.createContext({
+      operationType,
+      path,
+      method,
+      queryKey,
+      tags: [],
+      requestTimestamp: Date.now(),
+      instanceId,
+      request: { headers: {} },
+      temp: /* @__PURE__ */ new Map(),
+      stateManager,
+      eventEmitter
+    });
+    return {
+      ...baseCtx,
+      channel
+    };
+  };
+  return {
+    subscribe: ((callbackOrVoid) => {
+      if (callbackOrVoid === void 0) {
+        subscriptionVersion++;
+        const thisVersion = subscriptionVersion;
+        if (handle) {
+          handle.unsubscribe();
+          handle = null;
+        }
+        cachedState = { data: void 0, error: void 0, isConnected: false };
+        notify();
+        const ctx = createContext();
+        ctx.onData = (data) => {
+          if (thisVersion !== subscriptionVersion) {
+            return;
+          }
+          cachedState = {
+            data,
+            error: cachedState.error,
+            isConnected: true
+          };
+          notify();
+        };
+        ctx.onError = (error) => {
+          if (thisVersion !== subscriptionVersion) {
+            return;
+          }
+          cachedState = {
+            data: cachedState.data,
+            error,
+            isConnected: cachedState.isConnected
+          };
+          notify();
+        };
+        ctx.onDisconnect = () => {
+          if (thisVersion !== subscriptionVersion) {
+            return;
+          }
+          cachedState = {
+            ...cachedState,
+            isConnected: false
+          };
+          notify();
+        };
+        return adapter.subscribe(ctx).then((newHandle) => {
+          if (thisVersion !== subscriptionVersion) {
+            newHandle.unsubscribe();
+            return newHandle;
+          }
+          handle = newHandle;
+          const handleError = newHandle.getError();
+          if (handleError) {
+            cachedState = {
+              ...cachedState,
+              error: handleError,
+              isConnected: false
+            };
+          } else {
+            updateStateFromHandle();
+            cachedState = {
+              ...cachedState,
+              isConnected: true
+            };
+          }
+          notify();
+          return handle;
+        }).catch((err) => {
+          if (thisVersion !== subscriptionVersion) {
+            return null;
+          }
+          cachedState = {
+            ...cachedState,
+            error: err,
+            isConnected: false
+          };
+          notify();
+          return null;
+        });
+      }
+      subscribers.add(callbackOrVoid);
+      return () => {
+        subscribers.delete(callbackOrVoid);
+      };
+    }),
+    emit: async (message) => {
+      const ctx = createContext();
+      ctx.message = message;
+      return adapter.emit(ctx);
+    },
+    unsubscribe: () => {
+      subscriptionVersion++;
+      if (handle) {
+        handle.unsubscribe();
+        handle = null;
+      }
+      cachedState = {
+        ...cachedState,
+        isConnected: false
+      };
+      notify();
+    },
+    getState: () => cachedState,
+    mount: () => {
+    },
+    unmount: () => {
+      subscriptionVersion++;
+      if (handle) {
+        handle.unsubscribe();
+        handle = null;
+      }
+      cachedState = {
+        ...cachedState,
+        isConnected: false
+      };
+      notify();
+    },
+    setDisconnected: () => {
+      cachedState = {
+        ...cachedState,
+        isConnected: false
+      };
+      notify();
+    }
+  };
+}

package/dist/index.mjs

@@ -646,7 +646,7 @@ function createSelectorProxy(onCapture) {
       {},
       {
         get(_, prop) {
-          if (HTTP_METHODS.includes(prop)) {
+          if (typeof prop === "string" && prop === prop.toUpperCase()) {
             const selectorFn = (options) => {
               onCapture?.({
                 call: { path, method: prop, options },
@@ -993,6 +993,9 @@ function createPluginExecutor(initialPlugins = []) {
     getPlugins() {
       return frozenPlugins;
     },
+    getPluginsForOperation(operationType) {
+      return frozenPlugins.filter((p) => p.operations.includes(operationType));
+    },
     registerContextEnhancer(enhancer) {
       contextEnhancers.push(enhancer);
     },
@@ -1015,11 +1018,17 @@ function createPluginRegistry(plugins) {
   };
 }
 
+// src/plugins/create.ts
+function createSpooshPlugin(definition) {
+  return definition;
+}
+
 // src/Spoosh.ts
 var Spoosh = class _Spoosh {
   baseUrl;
   defaultOptions;
   _plugins;
+  _transports = /* @__PURE__ */ new Map();
   /**
    * Creates a new Spoosh instance.
    *
@@ -1044,10 +1053,13 @@ var Spoosh = class _Spoosh {
    * });
    * ```
    */
-  constructor(baseUrl, defaultOptions, plugins) {
+  constructor(baseUrl, defaultOptions, plugins, transports) {
     this.baseUrl = baseUrl;
     this.defaultOptions = defaultOptions || {};
     this._plugins = plugins || [];
+    if (transports) {
+      this._transports = transports;
+    }
   }
   /**
    * Adds plugins to the Spoosh instance.
@@ -1071,8 +1083,37 @@ var Spoosh = class _Spoosh {
     return new _Spoosh(
       this.baseUrl,
       this.defaultOptions,
-      plugins
+      plugins,
+      this._transports
+    );
+  }
+  /**
+   * Registers transport implementations for real-time operations.
+   *
+   * @param transports - Array of transport instances to register
+   * @returns This Spoosh instance for method chaining
+   *
+   * @example
+   * ```ts
+   * import { sse } from '@spoosh/transport-sse';
+   *
+   * const spoosh = new Spoosh<Schema, Error>('/api')
+   *   .withTransports([sse()])
+   *   .use([...]);
+   * ```
+   */
+  withTransports(transports) {
+    const newTransports = new Map(this._transports);
+    for (const transport of transports) {
+      newTransports.set(transport.name, transport);
+    }
+    const instance = new _Spoosh(
+      this.baseUrl,
+      this.defaultOptions,
+      this._plugins,
+      newTransports
     );
+    return instance;
   }
   /**
    * Cached instance of the underlying SpooshInstance.
@@ -1099,6 +1140,7 @@ var Spoosh = class _Spoosh {
         stateManager,
         eventEmitter,
         pluginExecutor,
+        transports: this._transports,
         config: {
           baseUrl: this.baseUrl,
           defaultOptions: this.defaultOptions
@@ -1106,7 +1148,8 @@ var Spoosh = class _Spoosh {
         _types: {
           schema: void 0,
           defaultError: void 0,
-          plugins: this._plugins
+          plugins: this._plugins,
+          transports: void 0
         }
       };
     }
@@ -1216,6 +1259,18 @@ var Spoosh = class _Spoosh {
   get _types() {
     return this.getInstance()._types;
   }
+  /**
+   * Map of registered transport implementations.
+   *
+   * @example
+   * ```ts
+   * const { transports } = client;
+   * const sseTransport = transports.get('sse');
+   * ```
+   */
+  get transports() {
+    return this.getInstance().transports;
+  }
 };
 
 // src/createClient.ts
@@ -1227,6 +1282,16 @@ function createClient(baseUrl, defaultOptions) {
   });
 }
 
+// src/transport/compose.ts
+function composeAdapter(baseAdapter, plugins) {
+  return plugins.reduce((adapter, plugin) => {
+    if (plugin.wrapAdapter) {
+      return plugin.wrapAdapter(adapter);
+    }
+    return adapter;
+  }, baseAdapter);
+}
+
 // src/controllers/base/controller.ts
 function createOperationController(options) {
   const {
@@ -2170,6 +2235,193 @@ function createQueueController(config, context) {
     }
   };
 }
+
+// src/controllers/subscription/controller.ts
+function createSubscriptionController(options) {
+  const {
+    channel,
+    baseAdapter,
+    pluginExecutor,
+    operationType,
+    stateManager,
+    eventEmitter,
+    queryKey,
+    path,
+    method,
+    instanceId
+  } = options;
+  const plugins = pluginExecutor.getPluginsForOperation(operationType);
+  const adapter = composeAdapter(
+    baseAdapter,
+    plugins
+  );
+  let handle = null;
+  const subscribers = /* @__PURE__ */ new Set();
+  let subscriptionVersion = 0;
+  let cachedState = {
+    data: void 0,
+    error: void 0,
+    isConnected: false
+  };
+  const updateStateFromHandle = () => {
+    if (!handle) return;
+    const newData = handle.getData();
+    const newError = handle.getError();
+    if (newData !== cachedState.data || newError !== cachedState.error) {
+      cachedState = {
+        data: newData,
+        error: newError,
+        isConnected: true
+      };
+    }
+  };
+  const notify = () => {
+    subscribers.forEach((callback) => callback());
+  };
+  const createContext = () => {
+    const baseCtx = pluginExecutor.createContext({
+      operationType,
+      path,
+      method,
+      queryKey,
+      tags: [],
+      requestTimestamp: Date.now(),
+      instanceId,
+      request: { headers: {} },
+      temp: /* @__PURE__ */ new Map(),
+      stateManager,
+      eventEmitter
+    });
+    return {
+      ...baseCtx,
+      channel
+    };
+  };
+  return {
+    subscribe: ((callbackOrVoid) => {
+      if (callbackOrVoid === void 0) {
+        subscriptionVersion++;
+        const thisVersion = subscriptionVersion;
+        if (handle) {
+          handle.unsubscribe();
+          handle = null;
+        }
+        cachedState = { data: void 0, error: void 0, isConnected: false };
+        notify();
+        const ctx = createContext();
+        ctx.onData = (data) => {
+          if (thisVersion !== subscriptionVersion) {
+            return;
+          }
+          cachedState = {
+            data,
+            error: cachedState.error,
+            isConnected: true
+          };
+          notify();
+        };
+        ctx.onError = (error) => {
+          if (thisVersion !== subscriptionVersion) {
+            return;
+          }
+          cachedState = {
+            data: cachedState.data,
+            error,
+            isConnected: cachedState.isConnected
+          };
+          notify();
+        };
+        ctx.onDisconnect = () => {
+          if (thisVersion !== subscriptionVersion) {
+            return;
+          }
+          cachedState = {
+            ...cachedState,
+            isConnected: false
+          };
+          notify();
+        };
+        return adapter.subscribe(ctx).then((newHandle) => {
+          if (thisVersion !== subscriptionVersion) {
+            newHandle.unsubscribe();
+            return newHandle;
+          }
+          handle = newHandle;
+          const handleError = newHandle.getError();
+          if (handleError) {
+            cachedState = {
+              ...cachedState,
+              error: handleError,
+              isConnected: false
+            };
+          } else {
+            updateStateFromHandle();
+            cachedState = {
+              ...cachedState,
+              isConnected: true
+            };
+          }
+          notify();
+          return handle;
+        }).catch((err) => {
+          if (thisVersion !== subscriptionVersion) {
+            return null;
+          }
+          cachedState = {
+            ...cachedState,
+            error: err,
+            isConnected: false
+          };
+          notify();
+          return null;
+        });
+      }
+      subscribers.add(callbackOrVoid);
+      return () => {
+        subscribers.delete(callbackOrVoid);
+      };
+    }),
+    emit: async (message) => {
+      const ctx = createContext();
+      ctx.message = message;
+      return adapter.emit(ctx);
+    },
+    unsubscribe: () => {
+      subscriptionVersion++;
+      if (handle) {
+        handle.unsubscribe();
+        handle = null;
+      }
+      cachedState = {
+        ...cachedState,
+        isConnected: false
+      };
+      notify();
+    },
+    getState: () => cachedState,
+    mount: () => {
+    },
+    unmount: () => {
+      subscriptionVersion++;
+      if (handle) {
+        handle.unsubscribe();
+        handle = null;
+      }
+      cachedState = {
+        ...cachedState,
+        isConnected: false
+      };
+      notify();
+    },
+    setDisconnected: () => {
+      cachedState = {
+        ...cachedState,
+        isConnected: false
+      };
+      notify();
+    }
+  };
+}
 export {
   HTTP_METHODS,
   Semaphore,
@@ -2177,6 +2429,7 @@ export {
   __DEV__,
   buildUrl,
   clone,
+  composeAdapter,
   containsFile,
   createClient,
   createEventEmitter,
@@ -2188,7 +2441,9 @@ export {
   createProxyHandler,
   createQueueController,
   createSelectorProxy,
+  createSpooshPlugin,
   createStateManager,
+  createSubscriptionController,
   createTracer,
   executeFetch,
   extractMethodFromSelector,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spoosh/core",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "license": "MIT",
   "description": "Type-safe API toolkit with plugin middleware system",
   "keywords": [