@asaidimu/utils-store 10.2.12 → 10.2.13

package/index.d.cts

@@ -610,6 +610,19 @@ type StoreAction<T, R extends any[] = any[]> = {
  * Levels are ordered by increasing severity: trace, debug, info, warn, error.
  */
 type LogLevel = "trace" | "debug" | "info" | "warn" | "error";
+/**
+ * Defines a destination where system logs are outputted or processed.
+ * Custom sinks (e.g., File, Logstash, Sentry) must implement this interface.
+ */
+interface LogSink {
+  /**
+   * Dispatches a structured log entry to the underlying destination.
+   *
+   * @param record - The complete log object containing metadata and payload.
+   * @returns A void or Promise that resolves when the log has been safely handed off.
+   */
+  write(record: SystemLog): void | Promise<void>;
+}
 /**
  * Structure representing a fully contextualized system log entry ready for sinking.
  */
@@ -626,7 +639,8 @@ interface SystemLog {
   timestamp: number;
 }
 /**
- * Primary logger interface providing level-specific log dispatching and context-chaining.
+ * Primary logger interface providing level-specific log dispatching, context-chaining,
+ * and dynamic sink management.
  */
 interface SystemLogger {
   /** Logs high-volume, extremely fine-grained diagnostic details. */
@@ -653,6 +667,22 @@ interface SystemLogger {
    * @param context - The metadata to append to all subsequent logs emitted by the child logger.
    */
   child(context: object): SystemLogger;
+  /**
+   * Adds a new sink to this logger instance.
+   * The sink will receive all logs emitted by this logger and its descendants (unless
+   * a descendant removes it). This operation does not affect the parent logger.
+   *
+   * @param sink - The LogSink to add.
+   */
+  addSink(sink: LogSink): void;
+  /**
+   * Removes a previously added sink from this logger instance.
+   * Returns `true` if the sink was found and removed, otherwise `false`.
+   * This operation does not affect the parent logger.
+   *
+   * @param sink - The LogSink to remove.
+   */
+  removeSink(sink: LogSink): boolean;
 }
 //#endregion
 //#region src/store/logger.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asaidimu/utils-store",
-  "version": "10.2.12",
+  "version": "10.2.13",
   "description": "A reactive data store",
   "main": "index.js",
   "module": "index.mjs",
@@ -29,11 +29,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@asaidimu/utils-events": "^1.2.6",
-    "@asaidimu/utils-logger": "^1.0.8",
+    "@asaidimu/utils-events": "^1.2.7",
+    "@asaidimu/utils-logger": "^1.0.9",
     "uuid": "^14.0.0",
-    "@asaidimu/utils-sync": "^2.3.5",
-    "@asaidimu/utils-persistence": "^6.1.16"
+    "@asaidimu/utils-sync": "^2.3.6",
+    "@asaidimu/utils-persistence": "^6.1.17"
   },
   "exports": {
     ".": {