@asaidimu/utils-database 3.1.6 → 3.1.8

package/index.d.mts

@@ -1,5 +1,5 @@
 import { QueryFilter, PaginationOptions } from '@asaidimu/query';
-import { IndexDefinition, SchemaDefinition, SchemaChange, DataTransform, PredicateMap } from '@asaidimu/anansi';
+import { IndexDefinition, SchemaChange, DataTransform, PredicateMap, SchemaDefinition } from '@asaidimu/anansi';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 
 /**
@@ -821,14 +821,18 @@ interface EventBus<TEventMap extends Record<string, any>> {
      * subscription
      * @returns A function to unsubscribe from the event.
      */
-    subscribe: <TEventName extends keyof TEventMap>(eventName: TEventName, callback: (payload: TEventMap[TEventName]) => void, options?: SubscribeOptions) => () => void;
+    subscribe<TEventName extends keyof TEventMap | "*">(eventName: TEventName, callback: TEventName extends "*" ? (payload: TEventMap[keyof TEventMap] & {
+        __event__: keyof TEventMap;
+    }) => void : (payload: TEventMap[TEventName]) => void, options?: SubscribeOptions): () => void;
     /**
      * Subscribes to an event and automatically unsubscribes after it fires once.
      * @param eventName - The name of the event to subscribe to.
      * @param callback - The function to call when the event is emitted.
      * @returns A function to cancel the one-shot subscription before it fires.
      */
-    once: <TEventName extends keyof TEventMap>(eventName: TEventName, callback: (payload: TEventMap[TEventName]) => void, options?: SubscribeOptions) => () => void;
+    once<TEventName extends keyof TEventMap | "*">(eventName: TEventName, callback: TEventName extends "*" ? (payload: TEventMap[keyof TEventMap] & {
+        __event__: keyof TEventMap;
+    }) => void : (payload: TEventMap[TEventName]) => void, options?: SubscribeOptions): () => void;
     /**
      * Emits an event with a payload to all subscribed listeners.
      * @param event - An object containing the event name and payload.
@@ -844,10 +848,18 @@ interface EventBus<TEventMap extends Record<string, any>> {
     metrics: () => EventMetrics;
     /**
      * Clears all subscriptions and resets metrics.
-     * After calling clear(), the bus is fully reset and can be reused —
+     *
+     * After calling `clear()`, the bus is fully reset and can be reused
      * cross-tab communication is re-established if it was previously enabled.
+     *
+     * @param options - Optional configuration object.
+     * @param options.permanent - If `true`, the bus becomes permanently unusable after clearing.
+     *                            Defaults to `false`.
+     * @returns {void}
      */
-    clear: () => void;
+    clear: (options?: {
+        permanent?: boolean;
+    }) => void;
 }
 /**
  * Interface defining the metrics tracked by the EventBus.

package/index.d.ts

@@ -1,5 +1,5 @@
 import { QueryFilter, PaginationOptions } from '@asaidimu/query';
-import { IndexDefinition, SchemaDefinition, SchemaChange, DataTransform, PredicateMap } from '@asaidimu/anansi';
+import { IndexDefinition, SchemaChange, DataTransform, PredicateMap, SchemaDefinition } from '@asaidimu/anansi';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 
 /**
@@ -821,14 +821,18 @@ interface EventBus<TEventMap extends Record<string, any>> {
      * subscription
      * @returns A function to unsubscribe from the event.
      */
-    subscribe: <TEventName extends keyof TEventMap>(eventName: TEventName, callback: (payload: TEventMap[TEventName]) => void, options?: SubscribeOptions) => () => void;
+    subscribe<TEventName extends keyof TEventMap | "*">(eventName: TEventName, callback: TEventName extends "*" ? (payload: TEventMap[keyof TEventMap] & {
+        __event__: keyof TEventMap;
+    }) => void : (payload: TEventMap[TEventName]) => void, options?: SubscribeOptions): () => void;
     /**
      * Subscribes to an event and automatically unsubscribes after it fires once.
      * @param eventName - The name of the event to subscribe to.
      * @param callback - The function to call when the event is emitted.
      * @returns A function to cancel the one-shot subscription before it fires.
      */
-    once: <TEventName extends keyof TEventMap>(eventName: TEventName, callback: (payload: TEventMap[TEventName]) => void, options?: SubscribeOptions) => () => void;
+    once<TEventName extends keyof TEventMap | "*">(eventName: TEventName, callback: TEventName extends "*" ? (payload: TEventMap[keyof TEventMap] & {
+        __event__: keyof TEventMap;
+    }) => void : (payload: TEventMap[TEventName]) => void, options?: SubscribeOptions): () => void;
     /**
      * Emits an event with a payload to all subscribed listeners.
      * @param event - An object containing the event name and payload.
@@ -844,10 +848,18 @@ interface EventBus<TEventMap extends Record<string, any>> {
     metrics: () => EventMetrics;
     /**
      * Clears all subscriptions and resets metrics.
-     * After calling clear(), the bus is fully reset and can be reused —
+     *
+     * After calling `clear()`, the bus is fully reset and can be reused
      * cross-tab communication is re-established if it was previously enabled.
+     *
+     * @param options - Optional configuration object.
+     * @param options.permanent - If `true`, the bus becomes permanently unusable after clearing.
+     *                            Defaults to `false`.
+     * @returns {void}
      */
-    clear: () => void;
+    clear: (options?: {
+        permanent?: boolean;
+    }) => void;
 }
 /**
  * Interface defining the metrics tracked by the EventBus.