@siggn/react 0.1.4 → 0.2.0

package/README.md

@@ -166,6 +166,24 @@ function LocalComponent() {
 }
 ```
 
+### Using Middleware
+
+You can use the `useMiddleware` hook to register middleware for a `Siggn` instance. The middleware intercepts messages before they are delivered to subscribers and is automatically unregistered when the component unmounts.
+
+```tsx
+import { useMiddleware } from '@siggn/react';
+import { siggn } from '../siggn';
+
+function LoggerComponent() {
+  useMiddleware(siggn, (msg, next) => {
+    console.log('Middleware:', msg);
+    next();
+  });
+
+  return null;
+}
+```
+
 ## API
 
 ### `useSiggn<T>()`
@@ -176,12 +194,21 @@ Creates and returns a `Siggn` instance that persists for the lifetime of the com
 
 Returns a `Siggn<T>` instance.
 
-### `useSubscribe(options, setup, deps)`
+### `useSubscribe(options, type, callback, deps)`
+
+Subscribes to a single message type and automatically unsubscribes when the component unmounts.
+
+- `options`: A `Siggn` instance or an object `{ instance: Siggn<T>; id?: string; }`.
+- `type`: The message type to subscribe to.
+- `callback`: The function to call when the message is received.
+- `deps` (optional): A dependency array to control when the subscription is re-created.
+
+### `useSubscribeMany(options, setup, deps)`
 
-Subscribes to messages and automatically unsubscribes when the component unmounts.
+Subscribes to multiple message types and automatically unsubscribes when the component unmounts.
 
 - `options`: A `Siggn` instance or an object `{ instance: Siggn<T>; id?: string; }`.
-- `setup`: A function that receives a `subscribe` helper to define subscriptions, similar to `subscribeMany` in `@siggn/core`.
+- `setup`: A function that receives a `subscribe` helper to define subscriptions.
 - `deps` (optional): A dependency array to control when the subscriptions are re-created.
 
 ### `useSubscribeAll(options, callback, deps)`
@@ -189,9 +216,16 @@ Subscribes to messages and automatically unsubscribes when the component unmount
 Subscribes to all messages and automatically unsubscribes when the component unmounts.
 
 - `options`: A `Siggn` instance or an object `{ instance: Siggn<T>; id?: string; }`.
-- `callback`: A function that will be called with every message.
 - `deps` (optional): A dependency array to control when the subscriptions are re-created.
 
+### `useMiddleware(instance, middleware, deps)`
+
+Registers a middleware and automatically unregisters it when the component unmounts.
+
+- `instance`: A `Siggn` instance.
+- `middleware`: The middleware function.
+- `deps` (optional): A dependency array to control when the middleware is re-registered.
+
 ## License
 
 This project is licensed under the [MIT License](LICENSE).

package/dist/hooks.d.ts

@@ -1,4 +1,4 @@
-import { Msg, Siggn } from '@siggn/core';
+import { Middleware, Msg, Siggn } from '@siggn/core';
 import { SubscriptionOptions } from 'packages/react/src/types';
 import { DependencyList } from 'react';
 /**
@@ -91,5 +91,30 @@ export declare function useSubscribe<M extends Msg, T extends M['type']>(options
  * }
  * ```
  */
-export declare function useSubscribeAll<T extends Msg>(options: SubscriptionOptions<T>, callback: (msg: T) => void, deps?: DependencyList): void;
+export declare function useSubscribeAll<M extends Msg>(options: SubscriptionOptions<M>, callback: (msg: M) => void, deps?: DependencyList): void;
+/**
+ * Adds a middleware to a `Siggn` instance that persists for the lifetime of the component.
+ * Automatically removes the middleware when the component unmounts.
+ *
+ * @template M A union of all possible message types.
+ * @param options A `Siggn` instance or an object with the instance.
+ * @param middleware The middleware function to add.
+ * @param deps An optional dependency array to control when the middleware is re-added.
+ * @category Middleware
+ * @since 0.0.6
+ * @example
+ *
+ * ```tsx
+ *  import { siggn } from './siggn';
+ *
+ *  function LoggerComponent() {
+ *    useMiddleware(siggn, async (msg, next) => {
+ *      console.log('Middleware:', msg);
+ *      next();
+ *    }, []);
+ *    // ...
+ *  }
+ * ```
+ */
+export declare function useMiddleware<M extends Msg>(instance: Siggn<M>, middleware: Middleware<M>, deps?: React.DependencyList): void;
 //# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAgC,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAE1E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAGlD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,GAAG,EAC5C,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC/B,KAAK,EAAE,CACL,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAC7B,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,KAAK,IAAI,KAC7C,IAAI,KACN,IAAI,EACT,IAAI,GAAE,cAAmB,QAe1B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAC7D,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC/B,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,KAAK,IAAI,EAChD,IAAI,GAAE,cAAmB,QAe1B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,GAAG,EAC3C,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC/B,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAC1B,IAAI,GAAE,cAAmB,QAe1B"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,GAAG,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,OAAO,EAAgC,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAE1E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAGlD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,GAAG,EAC5C,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC/B,KAAK,EAAE,CACL,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAC7B,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,KAAK,IAAI,KAC7C,IAAI,KACN,IAAI,EACT,IAAI,GAAE,cAAmB,QAe1B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAC7D,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC/B,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,KAAK,IAAI,EAChD,IAAI,GAAE,cAAmB,QAe1B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,GAAG,EAC3C,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC/B,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAC1B,IAAI,GAAE,cAAmB,QAe1B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,GAAG,EACzC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,EAClB,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EACzB,IAAI,GAAE,KAAK,CAAC,cAAmB,QAMhC"}

package/dist/index.cjs.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("react");class t{nextId=0;subscriptions;globalSubscriptions;middlewares;constructor(){this.subscriptions=new Map,this.globalSubscriptions=[],this.middlewares=[]}use(s){this.middlewares.push(s)}createClone(){return new t}makeId(s){return s??`sub_${(this.nextId++).toString(36)}`}make(s){return{subscribe:(e,u)=>{this.subscribe(s,e,u)},unsubscribe:()=>{this.unsubscribe(s)},subscribeMany:e=>{this.subscribeMany(s,e)},subscribeAll:e=>{this.subscribeAll(s,e)}}}subscribeMany(s,e){e((u,b)=>this.subscribe(s,u,b))}subscribe(s,e,u){this.subscriptions.has(e)||this.subscriptions.set(e,[]),this.subscriptions.get(e)?.push({id:s,ref:u})}subscribeAll(s,e){this.globalSubscriptions.push({id:s,ref:e})}publish(s){this.globalSubscriptions.forEach(e=>{e.ref(s)}),this.subscriptions.has(s.type)&&this.subscriptions.get(s.type)?.forEach(e=>{e.ref(s)})}unsubscribe(s){this.unsubscribeGlobal(s);for(const[e,u]of this.subscriptions)this.subscriptions.set(e,u.filter(b=>b.id!==s))}unsubscribeGlobal(s){this.globalSubscriptions=this.globalSubscriptions.filter(e=>e.id!==s)}}function n(){const[i]=r.useState(new t);return i}function a(i,s,e=[]){const u=r.useMemo(()=>i instanceof t?i:i.instance,[i]),b=r.useMemo(()=>u.makeId("id"in i?i.id:void 0),[u]);r.useEffect(()=>(u.subscribeMany(b,s),()=>{u.unsubscribe(b)}),[u,b,...e])}function l(i,s,e,u=[]){const b=r.useMemo(()=>i instanceof t?i:i.instance,[i]),c=r.useMemo(()=>b.makeId("id"in i?i.id:void 0),[b]);r.useEffect(()=>(b.subscribe(c,s,e),()=>{b.unsubscribe(c)}),[b,c,...u])}function o(i,s,e=[]){const u=r.useMemo(()=>i instanceof t?i:i.instance,[i]),b=r.useMemo(()=>u.makeId("id"in i?i.id:void 0),[u]);r.useEffect(()=>(u.subscribeAll(b,s),()=>{u.unsubscribeGlobal(b)}),[u,b,...e])}exports.Siggn=t;exports.useSiggn=n;exports.useSubscribe=l;exports.useSubscribeAll=o;exports.useSubscribeMany=a;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("@siggn/core"),n=require("react");function b(){const[e]=n.useState(new i.Siggn);return e}function a(e,s,r=[]){const u=n.useMemo(()=>e instanceof i.Siggn?e:e.instance,[e]),c=n.useMemo(()=>u.makeId("id"in e?e.id:void 0),[u]);n.useEffect(()=>(u.subscribeMany(c,s),()=>{u.unsubscribe(c)}),[u,c,...r])}function d(e,s,r,u=[]){const c=n.useMemo(()=>e instanceof i.Siggn?e:e.instance,[e]),t=n.useMemo(()=>c.makeId("id"in e?e.id:void 0),[c]);n.useEffect(()=>(c.subscribe(t,s,r),()=>{c.unsubscribe(t)}),[c,t,...u])}function f(e,s,r=[]){const u=n.useMemo(()=>e instanceof i.Siggn?e:e.instance,[e]),c=n.useMemo(()=>u.makeId("id"in e?e.id:void 0),[u]);n.useEffect(()=>(u.subscribeAll(c,s),()=>{u.unsubscribeGlobal(c)}),[u,c,...r])}function l(e,s,r=[]){n.useEffect(()=>e.use(s),[e,s,...r])}exports.useMiddleware=l;exports.useSiggn=b;exports.useSubscribe=d;exports.useSubscribeAll=f;exports.useSubscribeMany=a;Object.keys(i).forEach(e=>{e!=="default"&&!Object.prototype.hasOwnProperty.call(exports,e)&&Object.defineProperty(exports,e,{enumerable:!0,get:()=>i[e]})});
 //# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs.js","sources":["../../core/dist/index.es.js","../src/hooks.ts"],"sourcesContent":["class r {\n  nextId = 0;\n  subscriptions;\n  globalSubscriptions;\n  middlewares;\n  /**\n   * Creates a new Siggn instance.\n   * @category Lifecycle\n   * @since 0.0.5\n   */\n  constructor() {\n    this.subscriptions = /* @__PURE__ */ new Map(), this.globalSubscriptions = [], this.middlewares = [];\n  }\n  use(s) {\n    this.middlewares.push(s);\n  }\n  /**\n     * Creates a new, independent `Siggn` instance that inherits the message\n     * types of its parent and adds new ones.\n     *\n     * @template C The new message types to add.\n     * @returns A new `Siggn` instance with combined message types.\n     * @category Lifecycle\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const baseSiggn = new Siggn<{ type: 'A' }>();\n   * const childSiggn = baseSiggn.createClone<{ type: 'B' }>();\n   * // childSiggn can now publish and subscribe to types 'A' and 'B'.\n   * ```\n     */\n  createClone() {\n    return new r();\n  }\n  /**\n     * Generates a unique ID for a subscriber.\n     * If an ID is provided, it will be used; otherwise, a new one is generated.\n     *\n     * @param id An optional ID to use.\n     * @returns A unique subscriber ID.\n     * @category Utilities\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn();\n   * const id1 = siggn.makeId(); // e.g., \"sub_0\"\n   * const id2 = siggn.makeId('custom-id'); // \"custom-id\"\n   * ```\n     */\n  makeId(s) {\n    return s ?? `sub_${(this.nextId++).toString(36)}`;\n  }\n  /**\n     * Creates a subscription helper object that is pre-configured with a\n     * specific subscriber ID. This simplifies managing multiple subscriptions\n     * for a single component or service.\n     *\n     * @param id The subscriber ID to use for all subscriptions.\n     * @returns An object with `subscribe`, `unsubscribe`, `subscribeMany`, and `subscribeAll` methods.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'event' }>();\n   * const component = siggn.make('my-component');\n   * component.subscribe('event', () => console.log('event received!'));\n   * component.unsubscribe();\n   * ```\n     */\n  make(s) {\n    return {\n      subscribe: (i, t) => {\n        this.subscribe(s, i, t);\n      },\n      unsubscribe: () => {\n        this.unsubscribe(s);\n      },\n      subscribeMany: (i) => {\n        this.subscribeMany(s, i);\n      },\n      subscribeAll: (i) => {\n        this.subscribeAll(s, i);\n      }\n    };\n  }\n  /**\n     * Subscribes to multiple message types using a single subscriber ID.\n     *\n     * @param id The subscriber ID.\n     * @param setup A function that receives a `subscribe` helper to register callbacks.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'A' } | { type: 'B' }>();\n   * siggn.subscribeMany('subscriber-1', (subscribe) => {\n   *   subscribe('A', () => console.log('A received'));\n   *   subscribe('B', () => console.log('B received'));\n   * });\n   * ```\n     */\n  subscribeMany(s, i) {\n    i((t, b) => this.subscribe(s, t, b));\n  }\n  /**\n     * Subscribes to a specific message type.\n     *\n     * @param id The subscriber ID.\n     * @param type The message type to subscribe to.\n     * @param callback The function to call when a message of the specified type is published.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'my-event', payload: string }>();\n   * siggn.subscribe('subscriber-1', 'my-event', (msg) => {\n   *   console.log(msg.payload);\n   * });\n   * ```\n     */\n  subscribe(s, i, t) {\n    this.subscriptions.has(i) || this.subscriptions.set(i, []), this.subscriptions.get(i)?.push({ id: s, ref: t });\n  }\n  /**\n     * Subscribes to all message types. The callback will be invoked for every\n     * message published on the bus.\n     *\n     * @param id The subscriber ID.\n     * @param callback The function to call for any message.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'A' } | { type: 'B' }>();\n   * siggn.subscribeAll('logger', (msg) => {\n   *   console.log(`Received message of type: ${msg.type}`);\n   * });\n   * ```\n     */\n  subscribeAll(s, i) {\n    this.globalSubscriptions.push({ id: s, ref: i });\n  }\n  /**\n     * Publishes a message to all relevant subscribers.\n     *\n     * @param msg The message to publish.\n     * @category Publishing\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'my-event' }>();\n   * siggn.subscribe('sub-1', 'my-event', () => console.log('received'));\n   * siggn.publish({ type: 'my-event' }); // \"received\"\n   * ```\n     */\n  publish(s) {\n    this.globalSubscriptions.forEach((i) => {\n      i.ref(s);\n    }), this.subscriptions.has(s.type) && this.subscriptions.get(s.type)?.forEach((i) => {\n      i.ref(s);\n    });\n  }\n  /**\n     * Removes all subscriptions (both specific and global) for a given\n     * subscriber ID.\n     *\n     * @param id The subscriber ID to unsubscribe.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'my-event' }>();\n   * siggn.subscribe('sub-1', 'my-event', () => console.log('received'));\n   * siggn.unsubscribe('sub-1');\n   * siggn.publish({ type: 'my-event' }); // (nothing is logged)\n   * ```\n     */\n  unsubscribe(s) {\n    this.unsubscribeGlobal(s);\n    for (const [i, t] of this.subscriptions)\n      this.subscriptions.set(\n        i,\n        t.filter((b) => b.id !== s)\n      );\n  }\n  /**\n     * Removes a global subscription for a given subscriber ID.\n     *\n     * @param id The subscriber ID to unsubscribe.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'my-event' }>();\n   * siggn.subscribeAll('logger', console.log);\n   * siggn.unsubscribeGlobal('logger');\n   * siggn.publish({ type: 'my-event' }); // (nothing is logged)\n   * ```\n     */\n  unsubscribeGlobal(s) {\n    this.globalSubscriptions = this.globalSubscriptions.filter((i) => i.id !== s);\n  }\n}\nexport {\n  r as Siggn\n};\n//# sourceMappingURL=index.es.js.map\n","import { type Msg, Siggn } from '@siggn/core';\nimport type { SubscriptionOptions } from 'packages/react/src/types';\nimport { useEffect, useMemo, useState, type DependencyList } from 'react';\n\n/**\n * Creates and returns a `Siggn` instance that persists for the lifetime of the component.\n * This is useful for creating a message bus scoped to a component and its children.\n *\n * @template T A union of all possible message types for the new instance.\n * @returns A `Siggn<T>` instance.\n * @category Lifecycle\n * @since 0.0.1\n * @example\n * \n```tsx\n * function MyComponent() {\n *   const localSiggn = useSiggn<{ type: 'local-event' }>();\n *   // ...\n * }\n * ```\n */\nexport function useSiggn<T extends Msg>(): Siggn<T> {\n  const [siggn] = useState(new Siggn<T>());\n  return siggn;\n}\n\n/**\n * Subscribes to multiple messages and automatically unsubscribes when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param setup A function that receives a `subscribe` helper to define subscriptions.\n * @param deps An optional dependency array to control when the subscriptions are re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn'; // Your shared instance\n *\n * function MyComponent() {\n *   useSubscribeMany(siggn, (subscribe) => {\n *     subscribe('user-created', (msg) => console.log(msg.name));\n *     subscribe('user-updated', (msg) => console.log(msg.name));\n *   });\n *   // ...\n * }\n * ```\n */\nexport function useSubscribeMany<M extends Msg>(\n  options: SubscriptionOptions<M>,\n  setup: (\n    subscribe: <T extends M['type']>(\n      type: T,\n      callback: (msg: Extract<M, { type: T }>) => void,\n    ) => void,\n  ) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribeMany(id, setup);\n\n    return () => {\n      instance.unsubscribe(id);\n    };\n  }, [instance, id, ...deps]);\n}\n\n/**\n * Subscribes to a single message and automatically unsubscribe when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param setup A function that receives a `subscribe` helper to define subscriptions.\n * @param deps An optional dependency array to control when the subscriptions are re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn'; // Your shared instance\n *\n * function MyComponent() {\n *   useSubscribe(siggn, 'user-created', (msg) => console.log(msg.name));\n *   // ...\n * }\n * ```\n */\nexport function useSubscribe<M extends Msg, T extends M['type']>(\n  options: SubscriptionOptions<M>,\n  type: T,\n  callback: (msg: Extract<M, { type: T }>) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribe(id, type, callback);\n\n    return () => {\n      instance.unsubscribe(id);\n    };\n  }, [instance, id, ...deps]);\n}\n\n/**\n * Subscribes to all messages on a `Siggn` instance and automatically unsubscribes\n * when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param callback The function to call for any message.\n * @param deps An optional dependency array to control when the subscription is re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn';\n *\n * function LoggerComponent() {\n *   useSubscribeAll(siggn, (msg) => {\n *     console.log(`[LOG]: ${msg.type}`);\n *   }, []);\n *   // ...\n * }\n * ```\n */\nexport function useSubscribeAll<T extends Msg>(\n  options: SubscriptionOptions<T>,\n  callback: (msg: T) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribeAll(id, callback);\n\n    return () => {\n      instance.unsubscribeGlobal(id);\n    };\n  }, [instance, id, ...deps]);\n}\n"],"names":["r","i","t","useSiggn","siggn","useState","Siggn","useSubscribeMany","options","setup","deps","instance","useMemo","id","useEffect","useSubscribe","type","callback","useSubscribeAll"],"mappings":"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"}
+{"version":3,"file":"index.cjs.js","sources":["../src/hooks.ts"],"sourcesContent":["import { type Middleware, type Msg, Siggn } from '@siggn/core';\nimport type { SubscriptionOptions } from 'packages/react/src/types';\n\nimport { useEffect, useMemo, useState, type DependencyList } from 'react';\n\n/**\n * Creates and returns a `Siggn` instance that persists for the lifetime of the component.\n * This is useful for creating a message bus scoped to a component and its children.\n *\n * @template T A union of all possible message types for the new instance.\n * @returns A `Siggn<T>` instance.\n * @category Lifecycle\n * @since 0.0.1\n * @example\n * \n```tsx\n * function MyComponent() {\n *   const localSiggn = useSiggn<{ type: 'local-event' }>();\n *   // ...\n * }\n * ```\n */\nexport function useSiggn<T extends Msg>(): Siggn<T> {\n  const [siggn] = useState(new Siggn<T>());\n  return siggn;\n}\n\n/**\n * Subscribes to multiple messages and automatically unsubscribes when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param setup A function that receives a `subscribe` helper to define subscriptions.\n * @param deps An optional dependency array to control when the subscriptions are re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn'; // Your shared instance\n *\n * function MyComponent() {\n *   useSubscribeMany(siggn, (subscribe) => {\n *     subscribe('user-created', (msg) => console.log(msg.name));\n *     subscribe('user-updated', (msg) => console.log(msg.name));\n *   });\n *   // ...\n * }\n * ```\n */\nexport function useSubscribeMany<M extends Msg>(\n  options: SubscriptionOptions<M>,\n  setup: (\n    subscribe: <T extends M['type']>(\n      type: T,\n      callback: (msg: Extract<M, { type: T }>) => void,\n    ) => void,\n  ) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribeMany(id, setup);\n\n    return () => {\n      instance.unsubscribe(id);\n    };\n  }, [instance, id, ...deps]);\n}\n\n/**\n * Subscribes to a single message and automatically unsubscribe when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param setup A function that receives a `subscribe` helper to define subscriptions.\n * @param deps An optional dependency array to control when the subscriptions are re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn'; // Your shared instance\n *\n * function MyComponent() {\n *   useSubscribe(siggn, 'user-created', (msg) => console.log(msg.name));\n *   // ...\n * }\n * ```\n */\nexport function useSubscribe<M extends Msg, T extends M['type']>(\n  options: SubscriptionOptions<M>,\n  type: T,\n  callback: (msg: Extract<M, { type: T }>) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribe(id, type, callback);\n\n    return () => {\n      instance.unsubscribe(id);\n    };\n  }, [instance, id, ...deps]);\n}\n\n/**\n * Subscribes to all messages on a `Siggn` instance and automatically unsubscribes\n * when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param callback The function to call for any message.\n * @param deps An optional dependency array to control when the subscription is re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn';\n *\n * function LoggerComponent() {\n *   useSubscribeAll(siggn, (msg) => {\n *     console.log(`[LOG]: ${msg.type}`);\n *   }, []);\n *   // ...\n * }\n * ```\n */\nexport function useSubscribeAll<M extends Msg>(\n  options: SubscriptionOptions<M>,\n  callback: (msg: M) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribeAll(id, callback);\n\n    return () => {\n      instance.unsubscribeGlobal(id);\n    };\n  }, [instance, id, ...deps]);\n}\n\n/**\n * Adds a middleware to a `Siggn` instance that persists for the lifetime of the component.\n * Automatically removes the middleware when the component unmounts.\n *\n * @template M A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance.\n * @param middleware The middleware function to add.\n * @param deps An optional dependency array to control when the middleware is re-added.\n * @category Middleware\n * @since 0.0.6\n * @example\n *\n * ```tsx\n *  import { siggn } from './siggn';\n *\n *  function LoggerComponent() {\n *    useMiddleware(siggn, async (msg, next) => {\n *      console.log('Middleware:', msg);\n *      next();\n *    }, []);\n *    // ...\n *  }\n * ```\n */\nexport function useMiddleware<M extends Msg>(\n  instance: Siggn<M>,\n  middleware: Middleware<M>,\n  deps: React.DependencyList = [],\n) {\n  useEffect(() => {\n    const cleanup = instance.use(middleware);\n    return cleanup;\n  }, [instance, middleware, ...deps]);\n}\n"],"names":["useSiggn","siggn","useState","Siggn","useSubscribeMany","options","setup","deps","instance","useMemo","id","useEffect","useSubscribe","type","callback","useSubscribeAll","useMiddleware","middleware"],"mappings":"kIAsBO,SAASA,GAAoC,CAClD,KAAM,CAACC,CAAK,EAAIC,WAAS,IAAIC,EAAAA,KAAU,EACvC,OAAOF,CACT,CAyBO,SAASG,EACdC,EACAC,EAMAC,EAAuB,CAAA,EACvB,CACA,MAAMC,EAAWC,EAAAA,QACf,IAAOJ,aAAmBF,EAAAA,MAAQE,EAAUA,EAAQ,SACpD,CAACA,CAAO,CAAA,EAEJK,EAAKD,EAAAA,QAAQ,IAAMD,EAAS,OAAO,OAAQH,EAAUA,EAAQ,GAAK,MAAS,EAAG,CAACG,CAAQ,CAAC,EAE9FG,EAAAA,UAAU,KACRH,EAAS,cAAcE,EAAIJ,CAAK,EAEzB,IAAM,CACXE,EAAS,YAAYE,CAAE,CACzB,GACC,CAACF,EAAUE,EAAI,GAAGH,CAAI,CAAC,CAC5B,CAsBO,SAASK,EACdP,EACAQ,EACAC,EACAP,EAAuB,CAAA,EACvB,CACA,MAAMC,EAAWC,EAAAA,QACf,IAAOJ,aAAmBF,EAAAA,MAAQE,EAAUA,EAAQ,SACpD,CAACA,CAAO,CAAA,EAEJK,EAAKD,EAAAA,QAAQ,IAAMD,EAAS,OAAO,OAAQH,EAAUA,EAAQ,GAAK,MAAS,EAAG,CAACG,CAAQ,CAAC,EAE9FG,EAAAA,UAAU,KACRH,EAAS,UAAUE,EAAIG,EAAMC,CAAQ,EAE9B,IAAM,CACXN,EAAS,YAAYE,CAAE,CACzB,GACC,CAACF,EAAUE,EAAI,GAAGH,CAAI,CAAC,CAC5B,CAyBO,SAASQ,EACdV,EACAS,EACAP,EAAuB,CAAA,EACvB,CACA,MAAMC,EAAWC,EAAAA,QACf,IAAOJ,aAAmBF,EAAAA,MAAQE,EAAUA,EAAQ,SACpD,CAACA,CAAO,CAAA,EAEJK,EAAKD,EAAAA,QAAQ,IAAMD,EAAS,OAAO,OAAQH,EAAUA,EAAQ,GAAK,MAAS,EAAG,CAACG,CAAQ,CAAC,EAE9FG,EAAAA,UAAU,KACRH,EAAS,aAAaE,EAAII,CAAQ,EAE3B,IAAM,CACXN,EAAS,kBAAkBE,CAAE,CAC/B,GACC,CAACF,EAAUE,EAAI,GAAGH,CAAI,CAAC,CAC5B,CA0BO,SAASS,EACdR,EACAS,EACAV,EAA6B,CAAA,EAC7B,CACAI,EAAAA,UAAU,IACQH,EAAS,IAAIS,CAAU,EAEtC,CAACT,EAAUS,EAAY,GAAGV,CAAI,CAAC,CACpC"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from './hooks.js';
+export * from './types.js';
 export * from '@siggn/core';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/index.es.js

@@ -1,252 +1,45 @@
-import { useState as a, useMemo as u, useEffect as c } from "react";
-class t {
-  nextId = 0;
-  subscriptions;
-  globalSubscriptions;
-  middlewares;
-  /**
-   * Creates a new Siggn instance.
-   * @category Lifecycle
-   * @since 0.0.5
-   */
-  constructor() {
-    this.subscriptions = /* @__PURE__ */ new Map(), this.globalSubscriptions = [], this.middlewares = [];
-  }
-  use(s) {
-    this.middlewares.push(s);
-  }
-  /**
-     * Creates a new, independent `Siggn` instance that inherits the message
-     * types of its parent and adds new ones.
-     *
-     * @template C The new message types to add.
-     * @returns A new `Siggn` instance with combined message types.
-     * @category Lifecycle
-     * @since 0.0.5
-     * @example
-     * 
-  ```typescript
-   * const baseSiggn = new Siggn<{ type: 'A' }>();
-   * const childSiggn = baseSiggn.createClone<{ type: 'B' }>();
-   * // childSiggn can now publish and subscribe to types 'A' and 'B'.
-   * ```
-     */
-  createClone() {
-    return new t();
-  }
-  /**
-     * Generates a unique ID for a subscriber.
-     * If an ID is provided, it will be used; otherwise, a new one is generated.
-     *
-     * @param id An optional ID to use.
-     * @returns A unique subscriber ID.
-     * @category Utilities
-     * @since 0.0.5
-     * @example
-     * 
-  ```typescript
-   * const siggn = new Siggn();
-   * const id1 = siggn.makeId(); // e.g., "sub_0"
-   * const id2 = siggn.makeId('custom-id'); // "custom-id"
-   * ```
-     */
-  makeId(s) {
-    return s ?? `sub_${(this.nextId++).toString(36)}`;
-  }
-  /**
-     * Creates a subscription helper object that is pre-configured with a
-     * specific subscriber ID. This simplifies managing multiple subscriptions
-     * for a single component or service.
-     *
-     * @param id The subscriber ID to use for all subscriptions.
-     * @returns An object with `subscribe`, `unsubscribe`, `subscribeMany`, and `subscribeAll` methods.
-     * @category Subscription
-     * @since 0.0.5
-     * @example
-     * 
-  ```typescript
-   * const siggn = new Siggn<{ type: 'event' }>();
-   * const component = siggn.make('my-component');
-   * component.subscribe('event', () => console.log('event received!'));
-   * component.unsubscribe();
-   * ```
-     */
-  make(s) {
-    return {
-      subscribe: (i, b) => {
-        this.subscribe(s, i, b);
-      },
-      unsubscribe: () => {
-        this.unsubscribe(s);
-      },
-      subscribeMany: (i) => {
-        this.subscribeMany(s, i);
-      },
-      subscribeAll: (i) => {
-        this.subscribeAll(s, i);
-      }
-    };
-  }
-  /**
-     * Subscribes to multiple message types using a single subscriber ID.
-     *
-     * @param id The subscriber ID.
-     * @param setup A function that receives a `subscribe` helper to register callbacks.
-     * @category Subscription
-     * @since 0.0.5
-     * @example
-     * 
-  ```typescript
-   * const siggn = new Siggn<{ type: 'A' } | { type: 'B' }>();
-   * siggn.subscribeMany('subscriber-1', (subscribe) => {
-   *   subscribe('A', () => console.log('A received'));
-   *   subscribe('B', () => console.log('B received'));
-   * });
-   * ```
-     */
-  subscribeMany(s, i) {
-    i((b, r) => this.subscribe(s, b, r));
-  }
-  /**
-     * Subscribes to a specific message type.
-     *
-     * @param id The subscriber ID.
-     * @param type The message type to subscribe to.
-     * @param callback The function to call when a message of the specified type is published.
-     * @category Subscription
-     * @since 0.0.5
-     * @example
-     * 
-  ```typescript
-   * const siggn = new Siggn<{ type: 'my-event', payload: string }>();
-   * siggn.subscribe('subscriber-1', 'my-event', (msg) => {
-   *   console.log(msg.payload);
-   * });
-   * ```
-     */
-  subscribe(s, i, b) {
-    this.subscriptions.has(i) || this.subscriptions.set(i, []), this.subscriptions.get(i)?.push({ id: s, ref: b });
-  }
-  /**
-     * Subscribes to all message types. The callback will be invoked for every
-     * message published on the bus.
-     *
-     * @param id The subscriber ID.
-     * @param callback The function to call for any message.
-     * @category Subscription
-     * @since 0.0.5
-     * @example
-     * 
-  ```typescript
-   * const siggn = new Siggn<{ type: 'A' } | { type: 'B' }>();
-   * siggn.subscribeAll('logger', (msg) => {
-   *   console.log(`Received message of type: ${msg.type}`);
-   * });
-   * ```
-     */
-  subscribeAll(s, i) {
-    this.globalSubscriptions.push({ id: s, ref: i });
-  }
-  /**
-     * Publishes a message to all relevant subscribers.
-     *
-     * @param msg The message to publish.
-     * @category Publishing
-     * @since 0.0.5
-     * @example
-     * 
-  ```typescript
-   * const siggn = new Siggn<{ type: 'my-event' }>();
-   * siggn.subscribe('sub-1', 'my-event', () => console.log('received'));
-   * siggn.publish({ type: 'my-event' }); // "received"
-   * ```
-     */
-  publish(s) {
-    this.globalSubscriptions.forEach((i) => {
-      i.ref(s);
-    }), this.subscriptions.has(s.type) && this.subscriptions.get(s.type)?.forEach((i) => {
-      i.ref(s);
-    });
-  }
-  /**
-     * Removes all subscriptions (both specific and global) for a given
-     * subscriber ID.
-     *
-     * @param id The subscriber ID to unsubscribe.
-     * @category Subscription
-     * @since 0.0.5
-     * @example
-     * 
-  ```typescript
-   * const siggn = new Siggn<{ type: 'my-event' }>();
-   * siggn.subscribe('sub-1', 'my-event', () => console.log('received'));
-   * siggn.unsubscribe('sub-1');
-   * siggn.publish({ type: 'my-event' }); // (nothing is logged)
-   * ```
-     */
-  unsubscribe(s) {
-    this.unsubscribeGlobal(s);
-    for (const [i, b] of this.subscriptions)
-      this.subscriptions.set(
-        i,
-        b.filter((r) => r.id !== s)
-      );
-  }
-  /**
-     * Removes a global subscription for a given subscriber ID.
-     *
-     * @param id The subscriber ID to unsubscribe.
-     * @category Subscription
-     * @since 0.0.5
-     * @example
-     * 
-  ```typescript
-   * const siggn = new Siggn<{ type: 'my-event' }>();
-   * siggn.subscribeAll('logger', console.log);
-   * siggn.unsubscribeGlobal('logger');
-   * siggn.publish({ type: 'my-event' }); // (nothing is logged)
-   * ```
-     */
-  unsubscribeGlobal(s) {
-    this.globalSubscriptions = this.globalSubscriptions.filter((i) => i.id !== s);
-  }
-}
-function h() {
-  const [e] = a(new t());
+import { Siggn as s } from "@siggn/core";
+export * from "@siggn/core";
+import { useState as a, useMemo as r, useEffect as b } from "react";
+function l() {
+  const [e] = a(new s());
   return e;
 }
-function d(e, s, i = []) {
-  const b = u(
-    () => e instanceof t ? e : e.instance,
+function m(e, u, i = []) {
+  const n = r(
+    () => e instanceof s ? e : e.instance,
     [e]
-  ), r = u(() => b.makeId("id" in e ? e.id : void 0), [b]);
-  c(() => (b.subscribeMany(r, s), () => {
-    b.unsubscribe(r);
-  }), [b, r, ...i]);
+  ), c = r(() => n.makeId("id" in e ? e.id : void 0), [n]);
+  b(() => (n.subscribeMany(c, u), () => {
+    n.unsubscribe(c);
+  }), [n, c, ...i]);
 }
-function o(e, s, i, b = []) {
-  const r = u(
-    () => e instanceof t ? e : e.instance,
+function g(e, u, i, n = []) {
+  const c = r(
+    () => e instanceof s ? e : e.instance,
     [e]
-  ), n = u(() => r.makeId("id" in e ? e.id : void 0), [r]);
-  c(() => (r.subscribe(n, s, i), () => {
-    r.unsubscribe(n);
-  }), [r, n, ...b]);
+  ), t = r(() => c.makeId("id" in e ? e.id : void 0), [c]);
+  b(() => (c.subscribe(t, u, i), () => {
+    c.unsubscribe(t);
+  }), [c, t, ...n]);
 }
-function f(e, s, i = []) {
-  const b = u(
-    () => e instanceof t ? e : e.instance,
+function S(e, u, i = []) {
+  const n = r(
+    () => e instanceof s ? e : e.instance,
     [e]
-  ), r = u(() => b.makeId("id" in e ? e.id : void 0), [b]);
-  c(() => (b.subscribeAll(r, s), () => {
-    b.unsubscribeGlobal(r);
-  }), [b, r, ...i]);
+  ), c = r(() => n.makeId("id" in e ? e.id : void 0), [n]);
+  b(() => (n.subscribeAll(c, u), () => {
+    n.unsubscribeGlobal(c);
+  }), [n, c, ...i]);
+}
+function M(e, u, i = []) {
+  b(() => e.use(u), [e, u, ...i]);
 }
 export {
-  t as Siggn,
-  h as useSiggn,
-  o as useSubscribe,
-  f as useSubscribeAll,
-  d as useSubscribeMany
+  M as useMiddleware,
+  l as useSiggn,
+  g as useSubscribe,
+  S as useSubscribeAll,
+  m as useSubscribeMany
 };
 //# sourceMappingURL=index.es.js.map

package/dist/index.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.es.js","sources":["../../core/dist/index.es.js","../src/hooks.ts"],"sourcesContent":["class r {\n  nextId = 0;\n  subscriptions;\n  globalSubscriptions;\n  middlewares;\n  /**\n   * Creates a new Siggn instance.\n   * @category Lifecycle\n   * @since 0.0.5\n   */\n  constructor() {\n    this.subscriptions = /* @__PURE__ */ new Map(), this.globalSubscriptions = [], this.middlewares = [];\n  }\n  use(s) {\n    this.middlewares.push(s);\n  }\n  /**\n     * Creates a new, independent `Siggn` instance that inherits the message\n     * types of its parent and adds new ones.\n     *\n     * @template C The new message types to add.\n     * @returns A new `Siggn` instance with combined message types.\n     * @category Lifecycle\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const baseSiggn = new Siggn<{ type: 'A' }>();\n   * const childSiggn = baseSiggn.createClone<{ type: 'B' }>();\n   * // childSiggn can now publish and subscribe to types 'A' and 'B'.\n   * ```\n     */\n  createClone() {\n    return new r();\n  }\n  /**\n     * Generates a unique ID for a subscriber.\n     * If an ID is provided, it will be used; otherwise, a new one is generated.\n     *\n     * @param id An optional ID to use.\n     * @returns A unique subscriber ID.\n     * @category Utilities\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn();\n   * const id1 = siggn.makeId(); // e.g., \"sub_0\"\n   * const id2 = siggn.makeId('custom-id'); // \"custom-id\"\n   * ```\n     */\n  makeId(s) {\n    return s ?? `sub_${(this.nextId++).toString(36)}`;\n  }\n  /**\n     * Creates a subscription helper object that is pre-configured with a\n     * specific subscriber ID. This simplifies managing multiple subscriptions\n     * for a single component or service.\n     *\n     * @param id The subscriber ID to use for all subscriptions.\n     * @returns An object with `subscribe`, `unsubscribe`, `subscribeMany`, and `subscribeAll` methods.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'event' }>();\n   * const component = siggn.make('my-component');\n   * component.subscribe('event', () => console.log('event received!'));\n   * component.unsubscribe();\n   * ```\n     */\n  make(s) {\n    return {\n      subscribe: (i, t) => {\n        this.subscribe(s, i, t);\n      },\n      unsubscribe: () => {\n        this.unsubscribe(s);\n      },\n      subscribeMany: (i) => {\n        this.subscribeMany(s, i);\n      },\n      subscribeAll: (i) => {\n        this.subscribeAll(s, i);\n      }\n    };\n  }\n  /**\n     * Subscribes to multiple message types using a single subscriber ID.\n     *\n     * @param id The subscriber ID.\n     * @param setup A function that receives a `subscribe` helper to register callbacks.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'A' } | { type: 'B' }>();\n   * siggn.subscribeMany('subscriber-1', (subscribe) => {\n   *   subscribe('A', () => console.log('A received'));\n   *   subscribe('B', () => console.log('B received'));\n   * });\n   * ```\n     */\n  subscribeMany(s, i) {\n    i((t, b) => this.subscribe(s, t, b));\n  }\n  /**\n     * Subscribes to a specific message type.\n     *\n     * @param id The subscriber ID.\n     * @param type The message type to subscribe to.\n     * @param callback The function to call when a message of the specified type is published.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'my-event', payload: string }>();\n   * siggn.subscribe('subscriber-1', 'my-event', (msg) => {\n   *   console.log(msg.payload);\n   * });\n   * ```\n     */\n  subscribe(s, i, t) {\n    this.subscriptions.has(i) || this.subscriptions.set(i, []), this.subscriptions.get(i)?.push({ id: s, ref: t });\n  }\n  /**\n     * Subscribes to all message types. The callback will be invoked for every\n     * message published on the bus.\n     *\n     * @param id The subscriber ID.\n     * @param callback The function to call for any message.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'A' } | { type: 'B' }>();\n   * siggn.subscribeAll('logger', (msg) => {\n   *   console.log(`Received message of type: ${msg.type}`);\n   * });\n   * ```\n     */\n  subscribeAll(s, i) {\n    this.globalSubscriptions.push({ id: s, ref: i });\n  }\n  /**\n     * Publishes a message to all relevant subscribers.\n     *\n     * @param msg The message to publish.\n     * @category Publishing\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'my-event' }>();\n   * siggn.subscribe('sub-1', 'my-event', () => console.log('received'));\n   * siggn.publish({ type: 'my-event' }); // \"received\"\n   * ```\n     */\n  publish(s) {\n    this.globalSubscriptions.forEach((i) => {\n      i.ref(s);\n    }), this.subscriptions.has(s.type) && this.subscriptions.get(s.type)?.forEach((i) => {\n      i.ref(s);\n    });\n  }\n  /**\n     * Removes all subscriptions (both specific and global) for a given\n     * subscriber ID.\n     *\n     * @param id The subscriber ID to unsubscribe.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'my-event' }>();\n   * siggn.subscribe('sub-1', 'my-event', () => console.log('received'));\n   * siggn.unsubscribe('sub-1');\n   * siggn.publish({ type: 'my-event' }); // (nothing is logged)\n   * ```\n     */\n  unsubscribe(s) {\n    this.unsubscribeGlobal(s);\n    for (const [i, t] of this.subscriptions)\n      this.subscriptions.set(\n        i,\n        t.filter((b) => b.id !== s)\n      );\n  }\n  /**\n     * Removes a global subscription for a given subscriber ID.\n     *\n     * @param id The subscriber ID to unsubscribe.\n     * @category Subscription\n     * @since 0.0.5\n     * @example\n     * \n  ```typescript\n   * const siggn = new Siggn<{ type: 'my-event' }>();\n   * siggn.subscribeAll('logger', console.log);\n   * siggn.unsubscribeGlobal('logger');\n   * siggn.publish({ type: 'my-event' }); // (nothing is logged)\n   * ```\n     */\n  unsubscribeGlobal(s) {\n    this.globalSubscriptions = this.globalSubscriptions.filter((i) => i.id !== s);\n  }\n}\nexport {\n  r as Siggn\n};\n//# sourceMappingURL=index.es.js.map\n","import { type Msg, Siggn } from '@siggn/core';\nimport type { SubscriptionOptions } from 'packages/react/src/types';\nimport { useEffect, useMemo, useState, type DependencyList } from 'react';\n\n/**\n * Creates and returns a `Siggn` instance that persists for the lifetime of the component.\n * This is useful for creating a message bus scoped to a component and its children.\n *\n * @template T A union of all possible message types for the new instance.\n * @returns A `Siggn<T>` instance.\n * @category Lifecycle\n * @since 0.0.1\n * @example\n * \n```tsx\n * function MyComponent() {\n *   const localSiggn = useSiggn<{ type: 'local-event' }>();\n *   // ...\n * }\n * ```\n */\nexport function useSiggn<T extends Msg>(): Siggn<T> {\n  const [siggn] = useState(new Siggn<T>());\n  return siggn;\n}\n\n/**\n * Subscribes to multiple messages and automatically unsubscribes when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param setup A function that receives a `subscribe` helper to define subscriptions.\n * @param deps An optional dependency array to control when the subscriptions are re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn'; // Your shared instance\n *\n * function MyComponent() {\n *   useSubscribeMany(siggn, (subscribe) => {\n *     subscribe('user-created', (msg) => console.log(msg.name));\n *     subscribe('user-updated', (msg) => console.log(msg.name));\n *   });\n *   // ...\n * }\n * ```\n */\nexport function useSubscribeMany<M extends Msg>(\n  options: SubscriptionOptions<M>,\n  setup: (\n    subscribe: <T extends M['type']>(\n      type: T,\n      callback: (msg: Extract<M, { type: T }>) => void,\n    ) => void,\n  ) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribeMany(id, setup);\n\n    return () => {\n      instance.unsubscribe(id);\n    };\n  }, [instance, id, ...deps]);\n}\n\n/**\n * Subscribes to a single message and automatically unsubscribe when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param setup A function that receives a `subscribe` helper to define subscriptions.\n * @param deps An optional dependency array to control when the subscriptions are re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn'; // Your shared instance\n *\n * function MyComponent() {\n *   useSubscribe(siggn, 'user-created', (msg) => console.log(msg.name));\n *   // ...\n * }\n * ```\n */\nexport function useSubscribe<M extends Msg, T extends M['type']>(\n  options: SubscriptionOptions<M>,\n  type: T,\n  callback: (msg: Extract<M, { type: T }>) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribe(id, type, callback);\n\n    return () => {\n      instance.unsubscribe(id);\n    };\n  }, [instance, id, ...deps]);\n}\n\n/**\n * Subscribes to all messages on a `Siggn` instance and automatically unsubscribes\n * when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param callback The function to call for any message.\n * @param deps An optional dependency array to control when the subscription is re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn';\n *\n * function LoggerComponent() {\n *   useSubscribeAll(siggn, (msg) => {\n *     console.log(`[LOG]: ${msg.type}`);\n *   }, []);\n *   // ...\n * }\n * ```\n */\nexport function useSubscribeAll<T extends Msg>(\n  options: SubscriptionOptions<T>,\n  callback: (msg: T) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribeAll(id, callback);\n\n    return () => {\n      instance.unsubscribeGlobal(id);\n    };\n  }, [instance, id, ...deps]);\n}\n"],"names":["r","t","b","useSiggn","siggn","useState","Siggn","useSubscribeMany","options","setup","deps","instance","useMemo","id","useEffect","useSubscribe","type","callback","useSubscribeAll"],"mappings":"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"}
+{"version":3,"file":"index.es.js","sources":["../src/hooks.ts"],"sourcesContent":["import { type Middleware, type Msg, Siggn } from '@siggn/core';\nimport type { SubscriptionOptions } from 'packages/react/src/types';\n\nimport { useEffect, useMemo, useState, type DependencyList } from 'react';\n\n/**\n * Creates and returns a `Siggn` instance that persists for the lifetime of the component.\n * This is useful for creating a message bus scoped to a component and its children.\n *\n * @template T A union of all possible message types for the new instance.\n * @returns A `Siggn<T>` instance.\n * @category Lifecycle\n * @since 0.0.1\n * @example\n * \n```tsx\n * function MyComponent() {\n *   const localSiggn = useSiggn<{ type: 'local-event' }>();\n *   // ...\n * }\n * ```\n */\nexport function useSiggn<T extends Msg>(): Siggn<T> {\n  const [siggn] = useState(new Siggn<T>());\n  return siggn;\n}\n\n/**\n * Subscribes to multiple messages and automatically unsubscribes when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param setup A function that receives a `subscribe` helper to define subscriptions.\n * @param deps An optional dependency array to control when the subscriptions are re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn'; // Your shared instance\n *\n * function MyComponent() {\n *   useSubscribeMany(siggn, (subscribe) => {\n *     subscribe('user-created', (msg) => console.log(msg.name));\n *     subscribe('user-updated', (msg) => console.log(msg.name));\n *   });\n *   // ...\n * }\n * ```\n */\nexport function useSubscribeMany<M extends Msg>(\n  options: SubscriptionOptions<M>,\n  setup: (\n    subscribe: <T extends M['type']>(\n      type: T,\n      callback: (msg: Extract<M, { type: T }>) => void,\n    ) => void,\n  ) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribeMany(id, setup);\n\n    return () => {\n      instance.unsubscribe(id);\n    };\n  }, [instance, id, ...deps]);\n}\n\n/**\n * Subscribes to a single message and automatically unsubscribe when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param setup A function that receives a `subscribe` helper to define subscriptions.\n * @param deps An optional dependency array to control when the subscriptions are re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn'; // Your shared instance\n *\n * function MyComponent() {\n *   useSubscribe(siggn, 'user-created', (msg) => console.log(msg.name));\n *   // ...\n * }\n * ```\n */\nexport function useSubscribe<M extends Msg, T extends M['type']>(\n  options: SubscriptionOptions<M>,\n  type: T,\n  callback: (msg: Extract<M, { type: T }>) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribe(id, type, callback);\n\n    return () => {\n      instance.unsubscribe(id);\n    };\n  }, [instance, id, ...deps]);\n}\n\n/**\n * Subscribes to all messages on a `Siggn` instance and automatically unsubscribes\n * when the component unmounts.\n *\n * @template T A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance and an optional subscriber ID.\n * @param callback The function to call for any message.\n * @param deps An optional dependency array to control when the subscription is re-created.\n * @category Subscription\n * @since 0.0.1\n * @example\n * \n```tsx\n * import { siggn } from './siggn';\n *\n * function LoggerComponent() {\n *   useSubscribeAll(siggn, (msg) => {\n *     console.log(`[LOG]: ${msg.type}`);\n *   }, []);\n *   // ...\n * }\n * ```\n */\nexport function useSubscribeAll<M extends Msg>(\n  options: SubscriptionOptions<M>,\n  callback: (msg: M) => void,\n  deps: DependencyList = [],\n) {\n  const instance = useMemo(\n    () => (options instanceof Siggn ? options : options.instance),\n    [options],\n  );\n  const id = useMemo(() => instance.makeId('id' in options ? options.id : undefined), [instance]);\n\n  useEffect(() => {\n    instance.subscribeAll(id, callback);\n\n    return () => {\n      instance.unsubscribeGlobal(id);\n    };\n  }, [instance, id, ...deps]);\n}\n\n/**\n * Adds a middleware to a `Siggn` instance that persists for the lifetime of the component.\n * Automatically removes the middleware when the component unmounts.\n *\n * @template M A union of all possible message types.\n * @param options A `Siggn` instance or an object with the instance.\n * @param middleware The middleware function to add.\n * @param deps An optional dependency array to control when the middleware is re-added.\n * @category Middleware\n * @since 0.0.6\n * @example\n *\n * ```tsx\n *  import { siggn } from './siggn';\n *\n *  function LoggerComponent() {\n *    useMiddleware(siggn, async (msg, next) => {\n *      console.log('Middleware:', msg);\n *      next();\n *    }, []);\n *    // ...\n *  }\n * ```\n */\nexport function useMiddleware<M extends Msg>(\n  instance: Siggn<M>,\n  middleware: Middleware<M>,\n  deps: React.DependencyList = [],\n) {\n  useEffect(() => {\n    const cleanup = instance.use(middleware);\n    return cleanup;\n  }, [instance, middleware, ...deps]);\n}\n"],"names":["useSiggn","siggn","useState","Siggn","useSubscribeMany","options","setup","deps","instance","useMemo","id","useEffect","useSubscribe","type","callback","useSubscribeAll","useMiddleware","middleware"],"mappings":";;;AAsBO,SAASA,IAAoC;AAClD,QAAM,CAACC,CAAK,IAAIC,EAAS,IAAIC,GAAU;AACvC,SAAOF;AACT;AAyBO,SAASG,EACdC,GACAC,GAMAC,IAAuB,CAAA,GACvB;AACA,QAAMC,IAAWC;AAAA,IACf,MAAOJ,aAAmBF,IAAQE,IAAUA,EAAQ;AAAA,IACpD,CAACA,CAAO;AAAA,EAAA,GAEJK,IAAKD,EAAQ,MAAMD,EAAS,OAAO,QAAQH,IAAUA,EAAQ,KAAK,MAAS,GAAG,CAACG,CAAQ,CAAC;AAE9F,EAAAG,EAAU,OACRH,EAAS,cAAcE,GAAIJ,CAAK,GAEzB,MAAM;AACX,IAAAE,EAAS,YAAYE,CAAE;AAAA,EACzB,IACC,CAACF,GAAUE,GAAI,GAAGH,CAAI,CAAC;AAC5B;AAsBO,SAASK,EACdP,GACAQ,GACAC,GACAP,IAAuB,CAAA,GACvB;AACA,QAAMC,IAAWC;AAAA,IACf,MAAOJ,aAAmBF,IAAQE,IAAUA,EAAQ;AAAA,IACpD,CAACA,CAAO;AAAA,EAAA,GAEJK,IAAKD,EAAQ,MAAMD,EAAS,OAAO,QAAQH,IAAUA,EAAQ,KAAK,MAAS,GAAG,CAACG,CAAQ,CAAC;AAE9F,EAAAG,EAAU,OACRH,EAAS,UAAUE,GAAIG,GAAMC,CAAQ,GAE9B,MAAM;AACX,IAAAN,EAAS,YAAYE,CAAE;AAAA,EACzB,IACC,CAACF,GAAUE,GAAI,GAAGH,CAAI,CAAC;AAC5B;AAyBO,SAASQ,EACdV,GACAS,GACAP,IAAuB,CAAA,GACvB;AACA,QAAMC,IAAWC;AAAA,IACf,MAAOJ,aAAmBF,IAAQE,IAAUA,EAAQ;AAAA,IACpD,CAACA,CAAO;AAAA,EAAA,GAEJK,IAAKD,EAAQ,MAAMD,EAAS,OAAO,QAAQH,IAAUA,EAAQ,KAAK,MAAS,GAAG,CAACG,CAAQ,CAAC;AAE9F,EAAAG,EAAU,OACRH,EAAS,aAAaE,GAAII,CAAQ,GAE3B,MAAM;AACX,IAAAN,EAAS,kBAAkBE,CAAE;AAAA,EAC/B,IACC,CAACF,GAAUE,GAAI,GAAGH,CAAI,CAAC;AAC5B;AA0BO,SAASS,EACdR,GACAS,GACAV,IAA6B,CAAA,GAC7B;AACA,EAAAI,EAAU,MACQH,EAAS,IAAIS,CAAU,GAEtC,CAACT,GAAUS,GAAY,GAAGV,CAAI,CAAC;AACpC;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@siggn/react",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "A lightweight type safe message bus system for React",
   "keywords": [
     "pub/sub",
@@ -58,7 +58,7 @@
     "react": ">=18 <20"
   },
   "dependencies": {
-    "@siggn/core": "0.1.1"
+    "@siggn/core": "0.2.0"
   },
   "scripts": {
     "dev": "vite build --watch",