ngx-signal-plus 2.1.0 → 2.2.0

package/README.md

@@ -382,6 +382,31 @@ const darkMode = spPresets.toggle({
 });
 ```
 
+### Middleware/Plugin System
+
+Intercept signal operations for logging, analytics, and error tracking:
+
+```typescript
+import { spUseMiddleware, spLoggerMiddleware, spAnalyticsMiddleware } from "ngx-signal-plus";
+
+// Built-in logger middleware
+spUseMiddleware(spLoggerMiddleware("[DEBUG]"));
+
+// Custom analytics middleware
+spUseMiddleware(
+  spAnalyticsMiddleware((event) => {
+    analytics.track("signal_change", event);
+  }),
+);
+
+// Custom middleware
+spUseMiddleware({
+  name: "error-tracker",
+  onSet: (ctx) => console.log(`${ctx.signalName}: ${ctx.oldValue} -> ${ctx.newValue}`),
+  onError: (error) => Sentry.captureException(error),
+});
+```
+
 ### State Management
 
 ```typescript
@@ -509,6 +534,7 @@ What happens during SSR:
 | **Collection Management**   | `spCollection` - Manage arrays of entities with ID-based CRUD, queries, transforms, and history                                                |
 | **Transactions & Batching** | `spTransaction`, `spBatch`, `spIsTransactionActive`, `spIsInTransaction`, `spIsInBatch`, `spGetModifiedSignals`                                |
 | **Utilities**               | `spValidators`, `spPresets`                                                                                                                    |
+| **Middleware/Plugins**      | `spUseMiddleware`, `spRemoveMiddleware`, `spLoggerMiddleware`, `spAnalyticsMiddleware`                                                         |
 | **State Management**        | `spHistoryManager`, `spStorageManager`                                                                                                         |
 | **Components**              | `spSignalPlusComponent`, `spSignalPlusService`, `spSignalBuilder`                                                                              |
 

package/fesm2022/ngx-signal-plus.mjs

@@ -4362,6 +4362,67 @@ function spFormGroup(config, options) {
     };
 }
 
+/**
+ * Middleware system for intercepting signal operations.
+ */
+const middlewareRegistry = [];
+function spUseMiddleware(middleware) {
+    if (!middlewareRegistry.some((m) => m.name === middleware.name)) {
+        middlewareRegistry.push(middleware);
+    }
+}
+function spRemoveMiddleware(name) {
+    const index = middlewareRegistry.findIndex((m) => m.name === name);
+    if (index === -1)
+        return false;
+    middlewareRegistry.splice(index, 1);
+    return true;
+}
+function spClearMiddleware() {
+    middlewareRegistry.length = 0;
+}
+function spGetMiddlewareCount() {
+    return middlewareRegistry.length;
+}
+function spRunMiddleware(context) {
+    for (const m of middlewareRegistry) {
+        try {
+            m.onSet?.(context);
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+function spRunMiddlewareError(error, context) {
+    for (const m of middlewareRegistry) {
+        try {
+            m.onError?.(error, context);
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+function spLoggerMiddleware(prefix = '[Signal]') {
+    return {
+        name: 'sp-logger',
+        onSet: (ctx) => console.log(`${prefix} ${ctx.signalName || 'signal'}: ${JSON.stringify(ctx.oldValue)} -> ${JSON.stringify(ctx.newValue)}`),
+        onError: (error, ctx) => console.error(`${prefix} Error in ${ctx.signalName || 'signal'}:`, error.message),
+    };
+}
+function spAnalyticsMiddleware(tracker) {
+    return {
+        name: 'sp-analytics',
+        onSet: (ctx) => tracker({
+            name: ctx.signalName || 'unknown',
+            oldValue: ctx.oldValue,
+            newValue: ctx.newValue,
+            timestamp: ctx.timestamp,
+        }),
+    };
+}
+
 /**
  * @fileoverview Transaction and batching utilities for ngx-signal-plus
  * @description Provides functionality for atomic operations and batched updates
@@ -5748,5 +5809,5 @@ function createQuery(queryKey, queryFn, options) {
  * Generated bundle index. Do not edit.
  */
 
-export { QueryClient, createMutation, createQuery, enhance, getGlobalQueryClient, setGlobalQueryClient, sp, spAsync, spBatch, spCollection, combineLatest as spCombineLatest, spComputed, spCounter, debounceTime as spDebounceTime, delay$1 as spDelay, distinctUntilChanged as spDistinctUntilChanged, filter as spFilter, spForm, spFormGroup, spGetModifiedSignals, HistoryManager as spHistoryManager, spIsInBatch, spIsInTransaction, spIsTransactionActive, map as spMap, merge as spMerge, spMutation, presets as spPresets, spQuery, SignalBuilder as spSignalBuilder, SignalPlusComponent as spSignalPlusComponent, SignalPlusService as spSignalPlusService, skip as spSkip, StorageManager as spStorageManager, take as spTake, throttleTime as spThrottleTime, spToggle, spTransaction, validators as spValidators };
+export { QueryClient, createMutation, createQuery, enhance, getGlobalQueryClient, setGlobalQueryClient, sp, spAnalyticsMiddleware, spAsync, spBatch, spClearMiddleware, spCollection, combineLatest as spCombineLatest, spComputed, spCounter, debounceTime as spDebounceTime, delay$1 as spDelay, distinctUntilChanged as spDistinctUntilChanged, filter as spFilter, spForm, spFormGroup, spGetMiddlewareCount, spGetModifiedSignals, HistoryManager as spHistoryManager, spIsInBatch, spIsInTransaction, spIsTransactionActive, spLoggerMiddleware, map as spMap, merge as spMerge, spMutation, presets as spPresets, spQuery, spRemoveMiddleware, SignalBuilder as spSignalBuilder, SignalPlusComponent as spSignalPlusComponent, SignalPlusService as spSignalPlusService, skip as spSkip, StorageManager as spStorageManager, take as spTake, throttleTime as spThrottleTime, spToggle, spTransaction, spUseMiddleware, validators as spValidators };
 //# sourceMappingURL=ngx-signal-plus.mjs.map