@obinexusltd/obix-sdk-telemetry 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * OBIX Telemetry - State tracking, policy decorators, QA matrix integration
+ * Comprehensive event instrumentation and quality metrics collection
+ */
+export interface QAMatrix {
+    truePositive: number;
+    trueNegative: number;
+    falsePositive: number;
+    falseNegative: number;
+}
+export interface TelemetryEvent {
+    id: string;
+    timestamp: number;
+    eventType: string;
+    payload: Record<string, unknown>;
+    severity: "debug" | "info" | "warn" | "error";
+    context?: Record<string, unknown>;
+}
+export interface PolicyDecorator {
+    name: string;
+    condition: (event: TelemetryEvent) => boolean;
+    transform?: (event: TelemetryEvent) => TelemetryEvent;
+    sampleRate?: number;
+}
+export interface TelemetryConfig {
+    enabled: boolean;
+    endpoint?: string;
+    batchSize?: number;
+    flushInterval?: number;
+    decorators?: PolicyDecorator[];
+}
+export interface TelemetryEngine {
+    track(event: TelemetryEvent): void;
+    query(filter: {
+        eventType?: string;
+        severity?: string;
+    }): TelemetryEvent[];
+    getQAMatrix(): QAMatrix;
+    createPolicyDecorator(decorator: PolicyDecorator): void;
+}
+export declare function createTelemetry(config: TelemetryConfig): TelemetryEngine;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,QAAQ;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC;IAC9C,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,cAAc,CAAC;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IACnC,KAAK,CAAC,MAAM,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,EAAE,CAAC;IAC3E,WAAW,IAAI,QAAQ,CAAC;IACxB,qBAAqB,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;CACzD;AAID,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAsExE"}

package/dist/index.js

@@ -0,0 +1,68 @@
+/**
+ * OBIX Telemetry - State tracking, policy decorators, QA matrix integration
+ * Comprehensive event instrumentation and quality metrics collection
+ */
+const randomId = () => Math.random().toString(36).slice(2);
+export function createTelemetry(config) {
+    const events = [];
+    const decorators = [...(config.decorators ?? [])];
+    const emitEnvironmentEvent = (eventType, payload) => {
+        events.push({
+            id: randomId(),
+            timestamp: Date.now(),
+            eventType,
+            payload,
+            severity: "info"
+        });
+    };
+    if (config.enabled && typeof window !== "undefined") {
+        window.addEventListener("offline", () => emitEnvironmentEvent("network.offline", { online: false }));
+        window.addEventListener("online", () => emitEnvironmentEvent("network.online", { online: true }));
+        document.addEventListener("visibilitychange", () => {
+            if (document.hidden) {
+                emitEnvironmentEvent("tab.stale", { hidden: true });
+            }
+        });
+    }
+    return {
+        track(event) {
+            if (!config.enabled) {
+                return;
+            }
+            let candidate = event;
+            for (const decorator of decorators) {
+                if (!decorator.condition(candidate)) {
+                    continue;
+                }
+                if (decorator.sampleRate !== undefined && Math.random() > decorator.sampleRate) {
+                    return;
+                }
+                candidate = decorator.transform?.(candidate) ?? candidate;
+            }
+            events.push(candidate);
+        },
+        query(filter) {
+            return events.filter((event) => {
+                if (filter.eventType && event.eventType !== filter.eventType) {
+                    return false;
+                }
+                if (filter.severity && event.severity !== filter.severity) {
+                    return false;
+                }
+                return true;
+            });
+        },
+        getQAMatrix() {
+            return {
+                truePositive: events.filter((event) => event.severity === "error").length,
+                trueNegative: events.filter((event) => event.severity === "debug").length,
+                falsePositive: events.filter((event) => event.severity === "warn").length,
+                falseNegative: events.filter((event) => event.severity === "info").length
+            };
+        },
+        createPolicyDecorator(decorator) {
+            decorators.push(decorator);
+        }
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@obinexusltd/obix-sdk-telemetry",
+  "version": "0.1.0",
+  "description": "OBIX Telemetry - State tracking, policy decorators, QA matrix integration",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "license": "MIT",
+  "author": "OBINexus <okpalan@protonmail.com>",
+  "peerDependencies": {
+    "@obinexusltd/obix-sdk-core": "^0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}