@siggn/core 0.0.4 → 0.1.0

package/README.md

@@ -1,6 +1,8 @@
+[![npm version](https://badge.fury.io/js/%40siggn%2Fcore.svg)](https://www.npmjs.com/package/%40siggn%2Fcore)
+
 # @siggn/core
 
-A lightweight and type-safe event-driven pub/sub system for TypeScript projects.
+A lightweight and type-safe event bus system for TypeScript projects.
 
 ## Features
 
@@ -122,9 +124,9 @@ siggn.publish({ type: 'user_deleted', userId: '123' });
 logger.unsubscribe();
 ```
 
-### Extending message types with `createChild`
+### Extending message types with `createClone`
 
-The `createChild` method allows you to create a new, independent `Siggn` instance that inherits the
+The `createClone` method allows you to create a new, independent `Siggn` instance that inherits the
 message types of its parent. This is useful for creating specialized message buses that extend a
 base set of events without affecting the parent bus.
 
@@ -136,7 +138,7 @@ const baseSiggn = new Siggn<Message>();
 type AdminMessage = { type: 'admin_login'; adminId: string };
 
 // 2. Create a child bus that understands both `Message` and `AdminMessage`
-const adminSiggn = baseSiggn.createChild<AdminMessage>();
+const adminSiggn = baseSiggn.createClone<AdminMessage>();
 
 // 3. Subscribe to events on the child bus
 adminSiggn.subscribe('audit-log', 'user_created', (msg) => {
@@ -160,43 +162,75 @@ baseSiggn.publish({ type: 'user_created', userId: 'def', name: 'Bob' });
 // No output, because the subscription is on `adminSiggn`.
 ```
 
+### Automatic Garbage Collection
+
+Siggn is designed to prevent memory leaks even if subscriptions are not explicitly unsubscribed. It achieves this through the use of `WeakRef` and `FinalizationRegistry`:
+
+While explicit `unsubscribe` calls are still good practice for immediate cleanup and control, Siggn provides a robust safety net against common memory leak scenarios.
+
 ## API
 
 ### `new Siggn<T>()`
 
-Creates a new message bus instance. `T` is a union type of all possible messages.
+Creates a new message bus instance.
+
+- `T`: A union type representing all possible messages.
 
 ### `publish(msg)`
 
 Publishes a message to all relevant subscribers.
 
+- `msg`: The message object to be published. It must conform to the `Msg` type.
+
 ### `subscribe(id, type, callback)`
 
-Subscribes a callback to a specific message type with a unique subscriber ID.
+Subscribes a callback to a specific message type.
+
+- `id`: A unique `SiggnId` (string) to identify the subscriber.
+- `type`: The `type` of the message to subscribe to.
+- `callback`: A function that executes when a message of the specified `type` is published. It receives the message as its only argument.
 
 ### `subscribeAll(id, callback)`
 
-Subscribes a callback to all message types with a unique subscriber ID. The callback will receive
-every message published on the bus.
+Subscribes a callback to all message types.
+
+- `id`: A unique `SiggnId` to identify the subscriber.
+- `callback`: A function that executes for every message published. It receives the message as its only argument.
 
 ### `unsubscribe(id)`
 
-Removes all subscriptions associated with a specific subscriber ID.
+Removes all subscriptions (specific and global) associated with a subscriber ID.
+
+- `id`: The `SiggnId` of the subscriber to remove.
+
+### `unsubscribeGlobal(id)`
+
+Removes a global subscription for a given subscriber ID.
+
+- `id`: The `SiggnId` of the global subscriber to remove.
 
 ### `make(id)`
 
-Returns a helper object with `subscribe`, `subscribeMany`, `subscribeAll`, and `unsubscribe` methods
-pre-bound to the provided ID. This is useful for encapsulating subscription logic within a component
-or service.
+Returns a helper object with `subscribe`, `subscribeMany`, `subscribeAll`, and `unsubscribe` methods pre-bound to the provided ID.
+
+- `id`: A `SiggnId` to pre-bind to the subscription methods.
 
 ### `subscribeMany(id, setup)`
 
-A convenience method to subscribe to multiple message types for a single ID.
+Subscribes to multiple message types for a single ID.
+
+- `id`: A `SiggnId` to identify the subscriber.
+- `setup`: A function that receives a `subscribe` helper to register multiple subscriptions under the same `id`.
+
+### `createClone<C>()`
+
+Creates a new, independent `Siggn` instance that inherits the parent's message types and adds new ones.
+
+- `C`: A union type of additional message types for the new instance.
 
-### `createChild<C>()`
+### `subscriptionsCount()`
 
-Creates a new, independent `Siggn` instance whose message types are a union of the parent's types
-and the new child-specific types `C`.
+Returns the total number of subscriptions.
 
 ## License
 

package/dist/index.cjs.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class e{nextId=0;subscriptions;globalSubscriptions=[];registry=new FinalizationRegistry(s=>{this.unsubscribe(s)});registryGlobal=new FinalizationRegistry(s=>{this.unsubscribeGlobal(s)});constructor(){this.subscriptions=new Map}createClone(){return new e}makeId(s){return s??`sub_${(this.nextId++).toString(36)}`}make(s){return{subscribe:(i,t)=>{this.subscribe(s,i,t)},unsubscribe:()=>{this.unsubscribe(s)},subscribeMany:i=>{this.subscribeMany(s,i)},subscribeAll:i=>{this.subscribeAll(s,i)}}}subscribeMany(s,i){i((t,r)=>this.subscribe(s,t,r))}subscribe(s,i,t){this.subscriptions.has(i)||this.subscriptions.set(i,[]),this.registry.register(t,s),this.subscriptions.get(i)?.push({id:s,ref:new WeakRef(t)})}subscribeAll(s,i){this.registryGlobal.register(i,s),this.globalSubscriptions.push({id:s,ref:new WeakRef(i)})}publish(s){this.globalSubscriptions.forEach(i=>{const t=i.ref.deref();if(!t){this.unsubscribeGlobal(i.id);return}t(s)}),this.subscriptions.has(s.type)&&this.subscriptions.get(s.type)?.forEach(i=>{const t=i.ref.deref();if(!t){this.unsubscribe(i.id);return}t(s)})}unsubscribe(s){this.unsubscribeGlobal(s);for(const[i,t]of this.subscriptions)this.subscriptions.set(i,t.filter(r=>r.id!==s))}unsubscribeGlobal(s){this.globalSubscriptions=this.globalSubscriptions.filter(i=>i.id!==s)}get subscriptionsCount(){let s=0;return this.subscriptions.forEach(i=>{s+=i.length}),s+=this.globalSubscriptions.length,s}}exports.Siggn=e;
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":["../src/siggn.ts"],"sourcesContent":["import type { Msg, Subscription, SiggnId } from './types.js';\n\n/**\n * A type-safe message bus for dispatching and subscribing to events.\n * @template T A union of all possible message types.\n * @since 0.0.5\n */\nexport class Siggn<T extends Msg> {\n  private nextId = 0;\n  private subscriptions: Map<T['type'], Array<Subscription<T, any>>>;\n  private globalSubscriptions: Array<Subscription<T, any>> = [];\n\n  /**\n   * A FinalizationRegistry to automatically unregister specific subscriptions\n   * when the subscribed callback function is garbage collected.\n   */\n  private readonly registry = new FinalizationRegistry<SiggnId>((id) => {\n    this.unsubscribe(id);\n  });\n\n  /**\n   * A FinalizationRegistry to automatically unregister global subscriptions\n   * when the subscribed callback function is garbage collected.\n   */\n  private readonly registryGlobal = new FinalizationRegistry<SiggnId>((id) => {\n    this.unsubscribeGlobal(id);\n  });\n\n  /**\n   * Creates a new Siggn instance.\n   * @category Lifecycle\n   * @since 0.0.5\n   */\n  constructor() {\n    this.subscriptions = new Map();\n  }\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<C extends Msg>() {\n    return new Siggn<C | T>();\n  }\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(id?: string): SiggnId {\n    return id ?? `sub_${(this.nextId++).toString(36)}`;\n  }\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(id: SiggnId): {\n    subscribe: <K extends T['type']>(\n      type: K,\n      callback: (msg: Extract<T, { type: K }>) => void,\n    ) => void;\n    unsubscribe: () => void;\n    subscribeMany: (\n      setup: (\n        subscribe: <K extends T['type']>(\n          type: K,\n          callback: (msg: Extract<T, { type: K }>) => void,\n        ) => void,\n      ) => void,\n    ) => void;\n    subscribeAll: (callback: (msg: T) => void) => void;\n  } {\n    return {\n      subscribe: (type, callback) => {\n        this.subscribe(id, type, callback);\n      },\n      unsubscribe: () => {\n        this.unsubscribe(id);\n      },\n      subscribeMany: (setup) => {\n        this.subscribeMany(id, setup);\n      },\n      subscribeAll: (callback) => {\n        this.subscribeAll(id, callback);\n      },\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(\n    id: SiggnId,\n    setup: (\n      subscribe: <K extends T['type']>(\n        type: K,\n        callback: (msg: Extract<T, { type: K }>) => void,\n      ) => void,\n    ) => void,\n  ) {\n    setup((type, callback) => this.subscribe(id, type, callback));\n  }\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<K extends T['type']>(\n    id: SiggnId,\n    type: K,\n    callback: (msg: Extract<T, { type: K }>) => void,\n  ) {\n    if (!this.subscriptions.has(type)) {\n      this.subscriptions.set(type, []);\n    }\n\n    this.registry.register(callback, id);\n    this.subscriptions.get(type)?.push({ id, ref: new WeakRef(callback) });\n  }\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(id: SiggnId, callback: (msg: T) => void) {\n    this.registryGlobal.register(callback, id);\n    this.globalSubscriptions.push({ id, ref: new WeakRef(callback) });\n  }\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(msg: T) {\n    this.globalSubscriptions.forEach((sub) => {\n      const fn = sub.ref.deref();\n\n      if (!fn) {\n        this.unsubscribeGlobal(sub.id);\n        return;\n      }\n\n      fn(msg as Extract<T, { type: any }>);\n    });\n\n    if (!this.subscriptions.has(msg.type)) {\n      return;\n    }\n\n    this.subscriptions.get(msg.type)?.forEach((sub) => {\n      const fn = sub.ref.deref();\n\n      if (!fn) {\n        this.unsubscribe(sub.id);\n        return;\n      }\n\n      fn(msg as Extract<T, { type: any }>);\n    });\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(id: SiggnId) {\n    this.unsubscribeGlobal(id);\n\n    for (const [type, subscriptions] of this.subscriptions) {\n      this.subscriptions.set(\n        type,\n        subscriptions.filter((sub) => sub.id !== id),\n      );\n    }\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(id: SiggnId) {\n    this.globalSubscriptions = this.globalSubscriptions.filter((s) => s.id !== id);\n  }\n\n  /**\n   * Returns the total number of subscriptions (both specific and global).\n   *\n   * @category Subscription\n   * @since 0.1.0\n   * @example\n   * \n```typescript\n * const siggn = new Siggn<{ type: 'my-event' }>();\n * siggn.subscribe('sub-1', 'my-event', () => {});\n * siggn.subscribeAll('logger', () => {});\n * console.log(siggn.subscriptionsCount); // 2\n * ```\n   */\n  get subscriptionsCount() {\n    let count = 0;\n\n    this.subscriptions.forEach((subs) => {\n      count += subs.length;\n    });\n\n    count += this.globalSubscriptions.length;\n\n    return count;\n  }\n}\n"],"names":["Siggn","id","type","callback","setup","msg","sub","fn","subscriptions","s","count","subs"],"mappings":"gFAOO,MAAMA,CAAqB,CACxB,OAAS,EACT,cACA,oBAAmD,CAAA,EAM1C,SAAW,IAAI,qBAA+BC,GAAO,CACpE,KAAK,YAAYA,CAAE,CACrB,CAAC,EAMgB,eAAiB,IAAI,qBAA+BA,GAAO,CAC1E,KAAK,kBAAkBA,CAAE,CAC3B,CAAC,EAOD,aAAc,CACZ,KAAK,kBAAoB,GAC3B,CAkBA,aAA6B,CAC3B,OAAO,IAAID,CACb,CAkBA,OAAOC,EAAsB,CAC3B,OAAOA,GAAM,QAAQ,KAAK,UAAU,SAAS,EAAE,CAAC,EAClD,CAoBA,KAAKA,EAeH,CACA,MAAO,CACL,UAAW,CAACC,EAAMC,IAAa,CAC7B,KAAK,UAAUF,EAAIC,EAAMC,CAAQ,CACnC,EACA,YAAa,IAAM,CACjB,KAAK,YAAYF,CAAE,CACrB,EACA,cAAgBG,GAAU,CACxB,KAAK,cAAcH,EAAIG,CAAK,CAC9B,EACA,aAAeD,GAAa,CAC1B,KAAK,aAAaF,EAAIE,CAAQ,CAChC,CAAA,CAEJ,CAmBA,cACEF,EACAG,EAMA,CACAA,EAAM,CAACF,EAAMC,IAAa,KAAK,UAAUF,EAAIC,EAAMC,CAAQ,CAAC,CAC9D,CAmBA,UACEF,EACAC,EACAC,EACA,CACK,KAAK,cAAc,IAAID,CAAI,GAC9B,KAAK,cAAc,IAAIA,EAAM,CAAA,CAAE,EAGjC,KAAK,SAAS,SAASC,EAAUF,CAAE,EACnC,KAAK,cAAc,IAAIC,CAAI,GAAG,KAAK,CAAE,GAAAD,EAAI,IAAK,IAAI,QAAQE,CAAQ,CAAA,CAAG,CACvE,CAmBA,aAAaF,EAAaE,EAA4B,CACpD,KAAK,eAAe,SAASA,EAAUF,CAAE,EACzC,KAAK,oBAAoB,KAAK,CAAE,GAAAA,EAAI,IAAK,IAAI,QAAQE,CAAQ,EAAG,CAClE,CAgBA,QAAQE,EAAQ,CACd,KAAK,oBAAoB,QAASC,GAAQ,CACxC,MAAMC,EAAKD,EAAI,IAAI,MAAA,EAEnB,GAAI,CAACC,EAAI,CACP,KAAK,kBAAkBD,EAAI,EAAE,EAC7B,MACF,CAEAC,EAAGF,CAAgC,CACrC,CAAC,EAEI,KAAK,cAAc,IAAIA,EAAI,IAAI,GAIpC,KAAK,cAAc,IAAIA,EAAI,IAAI,GAAG,QAASC,GAAQ,CACjD,MAAMC,EAAKD,EAAI,IAAI,MAAA,EAEnB,GAAI,CAACC,EAAI,CACP,KAAK,YAAYD,EAAI,EAAE,EACvB,MACF,CAEAC,EAAGF,CAAgC,CACrC,CAAC,CACH,CAkBA,YAAYJ,EAAa,CACvB,KAAK,kBAAkBA,CAAE,EAEzB,SAAW,CAACC,EAAMM,CAAa,IAAK,KAAK,cACvC,KAAK,cAAc,IACjBN,EACAM,EAAc,OAAQF,GAAQA,EAAI,KAAOL,CAAE,CAAA,CAGjD,CAiBA,kBAAkBA,EAAa,CAC7B,KAAK,oBAAsB,KAAK,oBAAoB,OAAQQ,GAAMA,EAAE,KAAOR,CAAE,CAC/E,CAgBA,IAAI,oBAAqB,CACvB,IAAIS,EAAQ,EAEZ,YAAK,cAAc,QAASC,GAAS,CACnCD,GAASC,EAAK,MAChB,CAAC,EAEDD,GAAS,KAAK,oBAAoB,OAE3BA,CACT,CACF"}

package/dist/index.d.ts.map

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

package/dist/index.es.js

@@ -0,0 +1,256 @@
+class e {
+  nextId = 0;
+  subscriptions;
+  globalSubscriptions = [];
+  /**
+   * A FinalizationRegistry to automatically unregister specific subscriptions
+   * when the subscribed callback function is garbage collected.
+   */
+  registry = new FinalizationRegistry((s) => {
+    this.unsubscribe(s);
+  });
+  /**
+   * A FinalizationRegistry to automatically unregister global subscriptions
+   * when the subscribed callback function is garbage collected.
+   */
+  registryGlobal = new FinalizationRegistry((s) => {
+    this.unsubscribeGlobal(s);
+  });
+  /**
+   * Creates a new Siggn instance.
+   * @category Lifecycle
+   * @since 0.0.5
+   */
+  constructor() {
+    this.subscriptions = /* @__PURE__ */ new Map();
+  }
+  /**
+     * 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 e();
+  }
+  /**
+     * 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, t) => {
+        this.subscribe(s, i, t);
+      },
+      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((t, r) => this.subscribe(s, t, 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, t) {
+    this.subscriptions.has(i) || this.subscriptions.set(i, []), this.registry.register(t, s), this.subscriptions.get(i)?.push({ id: s, ref: new WeakRef(t) });
+  }
+  /**
+     * 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.registryGlobal.register(i, s), this.globalSubscriptions.push({ id: s, ref: new WeakRef(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) => {
+      const t = i.ref.deref();
+      if (!t) {
+        this.unsubscribeGlobal(i.id);
+        return;
+      }
+      t(s);
+    }), this.subscriptions.has(s.type) && this.subscriptions.get(s.type)?.forEach((i) => {
+      const t = i.ref.deref();
+      if (!t) {
+        this.unsubscribe(i.id);
+        return;
+      }
+      t(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, t] of this.subscriptions)
+      this.subscriptions.set(
+        i,
+        t.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);
+  }
+  /**
+     * Returns the total number of subscriptions (both specific and global).
+     *
+     * @category Subscription
+     * @since 0.1.0
+     * @example
+     * 
+  ```typescript
+   * const siggn = new Siggn<{ type: 'my-event' }>();
+   * siggn.subscribe('sub-1', 'my-event', () => {});
+   * siggn.subscribeAll('logger', () => {});
+   * console.log(siggn.subscriptionsCount); // 2
+   * ```
+     */
+  get subscriptionsCount() {
+    let s = 0;
+    return this.subscriptions.forEach((i) => {
+      s += i.length;
+    }), s += this.globalSubscriptions.length, s;
+  }
+}
+export {
+  e as Siggn
+};
+//# sourceMappingURL=index.es.js.map

package/dist/index.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.es.js","sources":["../src/siggn.ts"],"sourcesContent":["import type { Msg, Subscription, SiggnId } from './types.js';\n\n/**\n * A type-safe message bus for dispatching and subscribing to events.\n * @template T A union of all possible message types.\n * @since 0.0.5\n */\nexport class Siggn<T extends Msg> {\n  private nextId = 0;\n  private subscriptions: Map<T['type'], Array<Subscription<T, any>>>;\n  private globalSubscriptions: Array<Subscription<T, any>> = [];\n\n  /**\n   * A FinalizationRegistry to automatically unregister specific subscriptions\n   * when the subscribed callback function is garbage collected.\n   */\n  private readonly registry = new FinalizationRegistry<SiggnId>((id) => {\n    this.unsubscribe(id);\n  });\n\n  /**\n   * A FinalizationRegistry to automatically unregister global subscriptions\n   * when the subscribed callback function is garbage collected.\n   */\n  private readonly registryGlobal = new FinalizationRegistry<SiggnId>((id) => {\n    this.unsubscribeGlobal(id);\n  });\n\n  /**\n   * Creates a new Siggn instance.\n   * @category Lifecycle\n   * @since 0.0.5\n   */\n  constructor() {\n    this.subscriptions = new Map();\n  }\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<C extends Msg>() {\n    return new Siggn<C | T>();\n  }\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(id?: string): SiggnId {\n    return id ?? `sub_${(this.nextId++).toString(36)}`;\n  }\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(id: SiggnId): {\n    subscribe: <K extends T['type']>(\n      type: K,\n      callback: (msg: Extract<T, { type: K }>) => void,\n    ) => void;\n    unsubscribe: () => void;\n    subscribeMany: (\n      setup: (\n        subscribe: <K extends T['type']>(\n          type: K,\n          callback: (msg: Extract<T, { type: K }>) => void,\n        ) => void,\n      ) => void,\n    ) => void;\n    subscribeAll: (callback: (msg: T) => void) => void;\n  } {\n    return {\n      subscribe: (type, callback) => {\n        this.subscribe(id, type, callback);\n      },\n      unsubscribe: () => {\n        this.unsubscribe(id);\n      },\n      subscribeMany: (setup) => {\n        this.subscribeMany(id, setup);\n      },\n      subscribeAll: (callback) => {\n        this.subscribeAll(id, callback);\n      },\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(\n    id: SiggnId,\n    setup: (\n      subscribe: <K extends T['type']>(\n        type: K,\n        callback: (msg: Extract<T, { type: K }>) => void,\n      ) => void,\n    ) => void,\n  ) {\n    setup((type, callback) => this.subscribe(id, type, callback));\n  }\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<K extends T['type']>(\n    id: SiggnId,\n    type: K,\n    callback: (msg: Extract<T, { type: K }>) => void,\n  ) {\n    if (!this.subscriptions.has(type)) {\n      this.subscriptions.set(type, []);\n    }\n\n    this.registry.register(callback, id);\n    this.subscriptions.get(type)?.push({ id, ref: new WeakRef(callback) });\n  }\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(id: SiggnId, callback: (msg: T) => void) {\n    this.registryGlobal.register(callback, id);\n    this.globalSubscriptions.push({ id, ref: new WeakRef(callback) });\n  }\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(msg: T) {\n    this.globalSubscriptions.forEach((sub) => {\n      const fn = sub.ref.deref();\n\n      if (!fn) {\n        this.unsubscribeGlobal(sub.id);\n        return;\n      }\n\n      fn(msg as Extract<T, { type: any }>);\n    });\n\n    if (!this.subscriptions.has(msg.type)) {\n      return;\n    }\n\n    this.subscriptions.get(msg.type)?.forEach((sub) => {\n      const fn = sub.ref.deref();\n\n      if (!fn) {\n        this.unsubscribe(sub.id);\n        return;\n      }\n\n      fn(msg as Extract<T, { type: any }>);\n    });\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(id: SiggnId) {\n    this.unsubscribeGlobal(id);\n\n    for (const [type, subscriptions] of this.subscriptions) {\n      this.subscriptions.set(\n        type,\n        subscriptions.filter((sub) => sub.id !== id),\n      );\n    }\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(id: SiggnId) {\n    this.globalSubscriptions = this.globalSubscriptions.filter((s) => s.id !== id);\n  }\n\n  /**\n   * Returns the total number of subscriptions (both specific and global).\n   *\n   * @category Subscription\n   * @since 0.1.0\n   * @example\n   * \n```typescript\n * const siggn = new Siggn<{ type: 'my-event' }>();\n * siggn.subscribe('sub-1', 'my-event', () => {});\n * siggn.subscribeAll('logger', () => {});\n * console.log(siggn.subscriptionsCount); // 2\n * ```\n   */\n  get subscriptionsCount() {\n    let count = 0;\n\n    this.subscriptions.forEach((subs) => {\n      count += subs.length;\n    });\n\n    count += this.globalSubscriptions.length;\n\n    return count;\n  }\n}\n"],"names":["Siggn","id","type","callback","setup","msg","sub","fn","subscriptions","s","count","subs"],"mappings":"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"}

package/dist/siggn.d.ts

@@ -0,0 +1,211 @@
+import { Msg, SiggnId } from './types.js';
+/**
+ * A type-safe message bus for dispatching and subscribing to events.
+ * @template T A union of all possible message types.
+ * @since 0.0.5
+ */
+export declare class Siggn<T extends Msg> {
+    private nextId;
+    private subscriptions;
+    private globalSubscriptions;
+    /**
+     * A FinalizationRegistry to automatically unregister specific subscriptions
+     * when the subscribed callback function is garbage collected.
+     */
+    private readonly registry;
+    /**
+     * A FinalizationRegistry to automatically unregister global subscriptions
+     * when the subscribed callback function is garbage collected.
+     */
+    private readonly registryGlobal;
+    /**
+     * Creates a new Siggn instance.
+     * @category Lifecycle
+     * @since 0.0.5
+     */
+    constructor();
+    /**
+     * 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<C extends Msg>(): Siggn<T | C>;
+    /**
+     * 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(id?: string): SiggnId;
+    /**
+     * 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(id: SiggnId): {
+        subscribe: <K extends T['type']>(type: K, callback: (msg: Extract<T, {
+            type: K;
+        }>) => void) => void;
+        unsubscribe: () => void;
+        subscribeMany: (setup: (subscribe: <K extends T['type']>(type: K, callback: (msg: Extract<T, {
+            type: K;
+        }>) => void) => void) => void) => void;
+        subscribeAll: (callback: (msg: T) => void) => void;
+    };
+    /**
+     * 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(id: SiggnId, setup: (subscribe: <K extends T['type']>(type: K, callback: (msg: Extract<T, {
+        type: K;
+    }>) => void) => void) => void): void;
+    /**
+     * 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<K extends T['type']>(id: SiggnId, type: K, callback: (msg: Extract<T, {
+        type: K;
+    }>) => void): void;
+    /**
+     * 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(id: SiggnId, callback: (msg: T) => void): void;
+    /**
+     * 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(msg: T): void;
+    /**
+     * 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(id: SiggnId): void;
+    /**
+     * 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(id: SiggnId): void;
+    /**
+     * Returns the total number of subscriptions (both specific and global).
+     *
+     * @category Subscription
+     * @since 0.1.0
+     * @example
+     *
+  ```typescript
+   * const siggn = new Siggn<{ type: 'my-event' }>();
+   * siggn.subscribe('sub-1', 'my-event', () => {});
+   * siggn.subscribeAll('logger', () => {});
+   * console.log(siggn.subscriptionsCount); // 2
+   * ```
+     */
+    get subscriptionsCount(): number;
+}
+//# sourceMappingURL=siggn.d.ts.map

package/dist/siggn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"siggn.d.ts","sourceRoot":"","sources":["../src/siggn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAgB,OAAO,EAAE,MAAM,YAAY,CAAC;AAE7D;;;;GAIG;AACH,qBAAa,KAAK,CAAC,CAAC,SAAS,GAAG;IAC9B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,mBAAmB,CAAmC;IAE9D;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAEtB;IAEH;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAE5B;IAEH;;;;OAIG;;IAKH;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,CAAC,SAAS,GAAG;IAIzB;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IAI5B;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,CAAC,EAAE,EAAE,OAAO,GAAG;QACjB,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAC7B,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE;YAAE,IAAI,EAAE,CAAC,CAAA;SAAE,CAAC,KAAK,IAAI,KAC7C,IAAI,CAAC;QACV,WAAW,EAAE,MAAM,IAAI,CAAC;QACxB,aAAa,EAAE,CACb,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;YAAE,IAAI,EAAE,CAAC,CAAA;SAAE,CAAC,KAAK,IAAI,KAC7C,IAAI,KACN,IAAI,KACN,IAAI,CAAC;QACV,YAAY,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC;KACpD;IAiBD;;;;;;;;;;;;;;;;OAgBG;IACH,aAAa,CACX,EAAE,EAAE,OAAO,EACX,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;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,KAAK,IAAI,KAC7C,IAAI,KACN,IAAI;IAKX;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAC3B,EAAE,EAAE,OAAO,EACX,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,KAAK,IAAI;IAUlD;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI;IAKpD;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,GAAG,EAAE,CAAC;IA4Bd;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,EAAE,EAAE,OAAO;IAWvB;;;;;;;;;;;;;;OAcG;IACH,iBAAiB,CAAC,EAAE,EAAE,OAAO;IAI7B;;;;;;;;;;;;;OAaG;IACH,IAAI,kBAAkB,WAUrB;CACF"}

package/dist/{src/types.d.ts → types.d.ts}

@@ -4,11 +4,12 @@ export type Msg = {
 };
 export type Subscription<T extends Msg, K extends T['type']> = {
     id: string;
-    callback: (msg: Extract<T, {
+    ref: WeakRef<(msg: Extract<T, {
         type: K;
-    }>) => void;
+    }>) => void>;
 };
 export type SubscriptionMap<T extends Msg> = {
     [K in T['type']]: Array<Subscription<T, K>>;
 };
+export type SiggnId = string;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,GAAG;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,IAAI;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,OAAO,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,KAAK,IAAI,CAAC,CAAC;CACtD,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,GAAG,IAAI;KAC1C,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC"}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@siggn/core",
-  "version": "0.0.4",
+  "version": "0.1.0",
   "description": "A lightweight message bus system for Typescript",
   "keywords": [
     "pub/sub",
     "message",
     "event",
-    "bus"
+    "bus",
+    "typesafe"
   ],
   "publishConfig": {
     "@siggn:registry": "https://registry.npmjs.org/",
@@ -18,18 +19,26 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Guiguerreiro39/siggn.git/",
+    "url": "https://github.com/Guiguerreiro39/siggn.git/",
     "directory": "packages/core"
   },
+  "main": "./dist/index.cjs.js",
+  "module": "./dist/index.es.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.es.js",
+      "require": "./dist/index.cjs.js"
+    }
+  },
   "files": [
     "dist"
   ],
   "license": "MIT",
   "author": "Guilherme Guerreiro (https://guilhermegr.com)",
   "type": "module",
-  "main": "dist/index.cjs.js",
-  "types": "./dist/index.d.ts",
-  "module": "./dist/index.es.js",
+  "sideEffects": false,
   "devDependencies": {
     "typescript": "^5.9.3",
     "vite": "^7.1.12",
@@ -40,13 +49,11 @@
     "typescript": "^5"
   },
   "scripts": {
-    "dev": "vitest",
+    "dev": "vite build --watch",
+    "clean": "rm -rf dist",
     "test": "vitest run",
-    "build": "vite build",
-    "ci": "pnpm run build && pnpm run check-format && pnpm run test",
-    "format": "prettier --write .",
-    "check-format": "prettier --check .",
-    "version": "changeset version",
-    "release": "changeset publish"
+    "coverage": "vitest run --coverage",
+    "test:gc": "NODE_OPTIONS=\"--expose-gc\" pnpx vitest run",
+    "build": "vite build"
   }
 }

package/dist/index.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class r{subscriptions;subscribeAllSubscriptions=[];constructor(){this.subscriptions=new Map}createChild(){return new r}make(i){return{subscribe:(s,b)=>{this.subscribe(i,s,b)},unsubscribe:()=>{this.unsubscribe(i)},subscribeMany:s=>{this.subscribeMany(i,s)},subscribeAll:s=>{this.subscribeAll(i,s)}}}subscribeMany(i,s){s((b,t)=>this.subscribe(i,b,t))}subscribe(i,s,b){this.subscriptions.has(s)||this.subscriptions.set(s,[]),this.subscriptions.get(s)?.push({id:i,callback:b})}subscribeAll(i,s){this.subscribeAllSubscriptions.push({id:i,callback:s})}publish(i){this.subscribeAllSubscriptions.forEach(s=>{s.callback(i)}),this.subscriptions.has(i.type)&&this.subscriptions.get(i.type)?.forEach(s=>{s.callback(i)})}unsubscribe(i){this.subscribeAllSubscriptions=this.subscribeAllSubscriptions.filter(s=>s.id!==i);for(const[s,b]of this.subscriptions)this.subscriptions.set(s,b.filter(t=>t.id!==i))}}exports.Siggn=r;

package/dist/index.js

@@ -1,53 +0,0 @@
-class t {
-  subscriptions;
-  subscribeAllSubscriptions = [];
-  constructor() {
-    this.subscriptions = /* @__PURE__ */ new Map();
-  }
-  createChild() {
-    return new t();
-  }
-  make(i) {
-    return {
-      subscribe: (s, b) => {
-        this.subscribe(i, s, b);
-      },
-      unsubscribe: () => {
-        this.unsubscribe(i);
-      },
-      subscribeMany: (s) => {
-        this.subscribeMany(i, s);
-      },
-      subscribeAll: (s) => {
-        this.subscribeAll(i, s);
-      }
-    };
-  }
-  subscribeMany(i, s) {
-    s((b, r) => this.subscribe(i, b, r));
-  }
-  subscribe(i, s, b) {
-    this.subscriptions.has(s) || this.subscriptions.set(s, []), this.subscriptions.get(s)?.push({ id: i, callback: b });
-  }
-  subscribeAll(i, s) {
-    this.subscribeAllSubscriptions.push({ id: i, callback: s });
-  }
-  publish(i) {
-    this.subscribeAllSubscriptions.forEach((s) => {
-      s.callback(i);
-    }), this.subscriptions.has(i.type) && this.subscriptions.get(i.type)?.forEach((s) => {
-      s.callback(i);
-    });
-  }
-  unsubscribe(i) {
-    this.subscribeAllSubscriptions = this.subscribeAllSubscriptions.filter((s) => s.id !== i);
-    for (const [s, b] of this.subscriptions)
-      this.subscriptions.set(
-        s,
-        b.filter((r) => r.id !== i)
-      );
-  }
-}
-export {
-  t as Siggn
-};

package/dist/src/index.d.ts.map

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

package/dist/src/siggn.d.ts

@@ -1,27 +0,0 @@
-import { Msg } from './types.js';
-export declare class Siggn<T extends Msg> {
-    private subscriptions;
-    private subscribeAllSubscriptions;
-    constructor();
-    createChild<C extends Msg>(): Siggn<T | C>;
-    make(id: string): {
-        subscribe: <K extends T['type']>(type: K, callback: (msg: Extract<T, {
-            type: K;
-        }>) => void) => void;
-        unsubscribe: () => void;
-        subscribeMany: (setup: (subscribe: <K extends T['type']>(type: K, callback: (msg: Extract<T, {
-            type: K;
-        }>) => void) => void) => void) => void;
-        subscribeAll: (callback: (msg: T) => void) => void;
-    };
-    subscribeMany(id: string, setup: (subscribe: <K extends T['type']>(type: K, callback: (msg: Extract<T, {
-        type: K;
-    }>) => void) => void) => void): void;
-    subscribe<K extends T['type']>(id: string, type: K, callback: (msg: Extract<T, {
-        type: K;
-    }>) => void): void;
-    subscribeAll(id: string, callback: (msg: T) => void): void;
-    publish(msg: T): void;
-    unsubscribe(id: string): void;
-}
-//# sourceMappingURL=siggn.d.ts.map

package/dist/src/siggn.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"siggn.d.ts","sourceRoot":"","sources":["../../src/siggn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAgB,MAAM,YAAY,CAAC;AAEpD,qBAAa,KAAK,CAAC,CAAC,SAAS,GAAG;IAC9B,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,yBAAyB,CAAmC;;IAMpE,WAAW,CAAC,CAAC,SAAS,GAAG;IAIzB,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG;QAChB,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAC7B,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE;YAAE,IAAI,EAAE,CAAC,CAAA;SAAE,CAAC,KAAK,IAAI,KAC7C,IAAI,CAAC;QACV,WAAW,EAAE,MAAM,IAAI,CAAC;QACxB,aAAa,EAAE,CACb,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;YAAE,IAAI,EAAE,CAAC,CAAA;SAAE,CAAC,KAAK,IAAI,KAC7C,IAAI,KACN,IAAI,KACN,IAAI,CAAC;QACV,YAAY,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC;KACpD;IAiBD,aAAa,CACX,EAAE,EAAE,MAAM,EACV,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;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,KAAK,IAAI,KAC7C,IAAI,KACN,IAAI;IAKX,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAC3B,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,KAAK,IAAI;IASlD,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI;IAInD,OAAO,CAAC,GAAG,EAAE,CAAC;IAcd,WAAW,CAAC,EAAE,EAAE,MAAM;CAUvB"}

package/dist/src/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,GAAG;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,IAAI;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,KAAK,IAAI,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,GAAG,IAAI;KAC1C,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAC5C,CAAC"}