@signaltree/ng-forms 4.2.1 → 5.0.0

package/dist/audit/audit.js

@@ -0,0 +1,70 @@
+import { getChanges } from '../get-changes.js';
+
+function createAuditTracker(tree, auditLog, config = {}) {
+  const {
+    getMetadata,
+    includePreviousValues = false,
+    filter,
+    maxEntries = 0
+  } = config;
+  let previousState = structuredClone(tree());
+  let isTracking = true;
+  const handleChange = () => {
+    if (!isTracking) return;
+    const currentState = tree();
+    const changes = getChanges(previousState, currentState);
+    if (Object.keys(changes).length > 0) {
+      if (filter && !filter(changes)) {
+        previousState = structuredClone(currentState);
+        return;
+      }
+      const entry = {
+        timestamp: Date.now(),
+        changes,
+        metadata: getMetadata?.()
+      };
+      if (includePreviousValues) {
+        const prevValues = {};
+        for (const key of Object.keys(changes)) {
+          prevValues[key] = previousState[key];
+        }
+        entry.previousValues = prevValues;
+      }
+      auditLog.push(entry);
+      if (maxEntries > 0 && auditLog.length > maxEntries) {
+        auditLog.splice(0, auditLog.length - maxEntries);
+      }
+    }
+    previousState = structuredClone(currentState);
+  };
+  let unsubscribe;
+  let pollingId;
+  try {
+    unsubscribe = tree.subscribe(handleChange);
+  } catch {
+    pollingId = setInterval(handleChange, 100);
+  }
+  return () => {
+    isTracking = false;
+    if (unsubscribe) {
+      unsubscribe();
+    }
+    if (pollingId) {
+      clearInterval(pollingId);
+    }
+  };
+}
+function createAuditCallback(auditLog, getMetadata) {
+  return (previousState, currentState) => {
+    const changes = getChanges(previousState, currentState);
+    if (Object.keys(changes).length > 0) {
+      auditLog.push({
+        timestamp: Date.now(),
+        changes,
+        metadata: getMetadata?.()
+      });
+    }
+  };
+}
+
+export { createAuditCallback, createAuditTracker };

package/dist/audit/index.js

@@ -0,0 +1 @@
+export { createAuditCallback, createAuditTracker } from './audit.js';

package/dist/get-changes.js

@@ -0,0 +1,11 @@
+function getChanges(oldState, newState) {
+  const changes = {};
+  for (const key in newState) {
+    if (oldState[key] !== newState[key]) {
+      changes[key] = newState[key];
+    }
+  }
+  return changes;
+}
+
+export { getChanges };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaltree/ng-forms",
-  "version": "4.2.1",
+  "version": "5.0.0",
   "description": "Complete Angular forms integration for SignalTree. FormTree creation, custom directives, validators, form state tracking, and RxJS bridge.",
   "type": "module",
   "sideEffects": false,
@@ -12,12 +12,17 @@
       "types": "./src/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./audit": {
+      "types": "./src/audit/index.d.ts",
+      "import": "./dist/audit/index.js",
+      "default": "./dist/audit/index.js"
     }
   },
   "peerDependencies": {
     "@angular/core": "^20.3.0",
     "@angular/forms": "^20.3.0",
-    "@signaltree/core": "^4.2.1",
+    "@signaltree/core": "^5.0.0",
     "rxjs": "^7.0.0"
   },
   "devDependencies": {

package/src/audit/audit.d.ts

@@ -1,11 +1,21 @@
-import type { Middleware } from '@signaltree/core';
+import type { SignalTree } from '@signaltree/core';
 export interface AuditEntry<T = unknown> {
     timestamp: number;
     changes: Partial<T>;
-    metadata?: {
-        userId?: string;
-        source?: string;
-        description?: string;
-    };
+    previousValues?: Partial<T>;
+    metadata?: AuditMetadata;
 }
-export declare function createAuditMiddleware<T>(auditLog: AuditEntry<T>[], getMetadata?: () => AuditEntry<T>['metadata']): Middleware<T>;
+export interface AuditMetadata {
+    userId?: string;
+    source?: string;
+    description?: string;
+    [key: string]: unknown;
+}
+export interface AuditTrackerConfig<T> {
+    getMetadata?: () => AuditMetadata;
+    includePreviousValues?: boolean;
+    filter?: (changes: Partial<T>) => boolean;
+    maxEntries?: number;
+}
+export declare function createAuditTracker<T extends Record<string, unknown>>(tree: SignalTree<T>, auditLog: AuditEntry<T>[], config?: AuditTrackerConfig<T>): () => void;
+export declare function createAuditCallback<T extends Record<string, unknown>>(auditLog: AuditEntry<T>[], getMetadata?: () => AuditMetadata): (previousState: T, currentState: T) => void;

package/src/audit/index.d.ts

@@ -1 +1 @@
-export { createAuditMiddleware, type AuditEntry } from './audit';
+export { createAuditTracker, createAuditCallback, type AuditEntry, type AuditMetadata, type AuditTrackerConfig, } from './audit.js';

package/dist/constants.js

@@ -1,6 +0,0 @@
-const SHARED_DEFAULTS = Object.freeze({
-  PATH_CACHE_SIZE: 1000
-});
-const DEFAULT_PATH_CACHE_SIZE = SHARED_DEFAULTS.PATH_CACHE_SIZE;
-
-export { DEFAULT_PATH_CACHE_SIZE, SHARED_DEFAULTS };

package/dist/core/async-validators.js

@@ -1,24 +0,0 @@
-import { isObservable, firstValueFrom } from 'rxjs';
-
-function unique(checkFn, message = 'Already exists') {
-  return async value => {
-    if (!value) return null;
-    const exists = await checkFn(value);
-    return exists ? message : null;
-  };
-}
-function debounce(validator, delayMs) {
-  let timeoutId;
-  return async value => {
-    return new Promise(resolve => {
-      clearTimeout(timeoutId);
-      timeoutId = setTimeout(async () => {
-        const maybeAsync = validator(value);
-        const result = isObservable(maybeAsync) ? await firstValueFrom(maybeAsync) : await maybeAsync;
-        resolve(result);
-      }, delayMs);
-    });
-  };
-}
-
-export { debounce, unique };