@auxiora/guardrails 1.10.1 → 1.10.6

package/dist/index.d.ts

@@ -3,4 +3,6 @@ export { PiiDetector } from './pii-detector.js';
 export { InjectionDetector } from './injection-detector.js';
 export { ToxicityFilter } from './toxicity-filter.js';
 export { GuardrailPipeline } from './guardrail-pipeline.js';
+export { GuardrailMetrics } from './metrics.js';
+export type { GuardrailStats } from './metrics.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,eAAe,EACf,UAAU,EACV,MAAM,EACN,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,eAAe,EACf,UAAU,EACV,MAAM,EACN,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -2,4 +2,5 @@ export { PiiDetector } from './pii-detector.js';
 export { InjectionDetector } from './injection-detector.js';
 export { ToxicityFilter } from './toxicity-filter.js';
 export { GuardrailPipeline } from './guardrail-pipeline.js';
+export { GuardrailMetrics } from './metrics.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/metrics.d.ts

@@ -0,0 +1,35 @@
+import type { ScanResult, ThreatLevel } from './types.js';
+export interface GuardrailStats {
+    totalScans: number;
+    inputScans: number;
+    outputScans: number;
+    totalThreats: number;
+    threatsByType: Record<string, number>;
+    threatsByLevel: Partial<Record<ThreatLevel, number>>;
+    actionCounts: Record<string, number>;
+    blockedCount: number;
+    redactedCount: number;
+    lastScanAt: number;
+}
+export declare class GuardrailMetrics {
+    private totalScans;
+    private inputScans;
+    private outputScans;
+    private totalThreats;
+    private threatsByType;
+    private threatsByLevel;
+    private actionCounts;
+    private blockedCount;
+    private redactedCount;
+    private lastScanAt;
+    /** Record an input scan result */
+    recordInputScan(result: ScanResult): void;
+    /** Record an output scan result */
+    recordOutputScan(result: ScanResult): void;
+    /** Get current stats snapshot */
+    getStats(): GuardrailStats;
+    /** Reset all counters */
+    reset(): void;
+    private recordScanResult;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,UAAU,CAAK;IAEvB,kCAAkC;IAClC,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAMzC,mCAAmC;IACnC,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAM1C,iCAAiC;IACjC,QAAQ,IAAI,cAAc;IAe1B,yBAAyB;IACzB,KAAK,IAAI,IAAI;IAab,OAAO,CAAC,gBAAgB;CAmBzB"}

package/dist/metrics.js

@@ -0,0 +1,71 @@
+export class GuardrailMetrics {
+    totalScans = 0;
+    inputScans = 0;
+    outputScans = 0;
+    totalThreats = 0;
+    threatsByType = new Map();
+    threatsByLevel = new Map();
+    actionCounts = new Map();
+    blockedCount = 0;
+    redactedCount = 0;
+    lastScanAt = 0;
+    /** Record an input scan result */
+    recordInputScan(result) {
+        this.totalScans++;
+        this.inputScans++;
+        this.recordScanResult(result);
+    }
+    /** Record an output scan result */
+    recordOutputScan(result) {
+        this.totalScans++;
+        this.outputScans++;
+        this.recordScanResult(result);
+    }
+    /** Get current stats snapshot */
+    getStats() {
+        return {
+            totalScans: this.totalScans,
+            inputScans: this.inputScans,
+            outputScans: this.outputScans,
+            totalThreats: this.totalThreats,
+            threatsByType: Object.fromEntries(this.threatsByType),
+            threatsByLevel: Object.fromEntries(this.threatsByLevel),
+            actionCounts: Object.fromEntries(this.actionCounts),
+            blockedCount: this.blockedCount,
+            redactedCount: this.redactedCount,
+            lastScanAt: this.lastScanAt,
+        };
+    }
+    /** Reset all counters */
+    reset() {
+        this.totalScans = 0;
+        this.inputScans = 0;
+        this.outputScans = 0;
+        this.totalThreats = 0;
+        this.threatsByType.clear();
+        this.threatsByLevel.clear();
+        this.actionCounts.clear();
+        this.blockedCount = 0;
+        this.redactedCount = 0;
+        this.lastScanAt = 0;
+    }
+    recordScanResult(result) {
+        this.lastScanAt = Date.now();
+        // Track action
+        const current = this.actionCounts.get(result.action) ?? 0;
+        this.actionCounts.set(result.action, current + 1);
+        if (result.action === 'block')
+            this.blockedCount++;
+        if (result.action === 'redact')
+            this.redactedCount++;
+        // Track threats
+        for (const threat of result.threats) {
+            this.totalThreats++;
+            const typeCount = this.threatsByType.get(threat.type) ?? 0;
+            this.threatsByType.set(threat.type, typeCount + 1);
+            const levelCount = this.threatsByLevel.get(threat.level) ?? 0;
+            this.threatsByLevel.set(threat.level, levelCount + 1);
+        }
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@auxiora/guardrails",
-  "version": "1.10.1",
+  "version": "1.10.6",
   "description": "Content safety guardrails with PII detection and prompt injection defense",
   "type": "module",
   "main": "dist/index.js",
@@ -12,7 +12,7 @@
     }
   },
   "dependencies": {
-    "@auxiora/logger": "1.10.1"
+    "@auxiora/logger": "1.10.6"
   },
   "devDependencies": {},
   "engines": {