@elsium-ai/observe 0.10.0 → 0.11.0

package/dist/audit-sink-jsonl.d.ts

@@ -0,0 +1,7 @@
+import type { AuditSink } from './audit-sink';
+export interface JsonlSinkConfig {
+    path: string;
+    fsync?: boolean;
+}
+export declare function createJsonlSink(config: JsonlSinkConfig): AuditSink;
+//# sourceMappingURL=audit-sink-jsonl.d.ts.map

package/dist/audit-sink-jsonl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-sink-jsonl.d.ts","sourceRoot":"","sources":["../src/audit-sink-jsonl.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAI7C,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,OAAO,CAAA;CACf;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAwDlE"}

package/dist/index.d.ts

@@ -16,6 +16,8 @@ export { createSplunkSink } from './audit-sink-splunk';
 export type { SplunkSinkConfig } from './audit-sink-splunk';
 export { createDatadogSink } from './audit-sink-datadog';
 export type { DatadogSinkConfig } from './audit-sink-datadog';
+export { createJsonlSink } from './audit-sink-jsonl';
+export type { JsonlSinkConfig } from './audit-sink-jsonl';
 export { createProvenanceTracker } from './provenance';
 export type { ProvenanceRecord, ProvenanceTracker } from './provenance';
 export { createExperiment, createFileExperimentStore } from './experiment';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACnC,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAG1F,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACnE,YAAY,EACX,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,aAAa,EACb,sBAAsB,EACtB,eAAe,EACf,cAAc,GACd,MAAM,eAAe,CAAA;AAGtB,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAClC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAG9F,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAG9D,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAClF,YAAY,EACX,cAAc,EACd,UAAU,EACV,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,GACV,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,YAAY,EAAE,SAAS,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AACnG,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxD,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxD,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAG7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AACtD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAGvE,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AAC1E,YAAY,EACX,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,GACf,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAClE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAGvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AACxD,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAG7E,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAC/E,YAAY,EACX,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,GACrB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACN,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,GAClB,MAAM,QAAQ,CAAA;AACf,YAAY,EACX,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,GAClB,MAAM,QAAQ,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1282,6 +1282,68 @@ function createDatadogSink(config) {
     }
   };
 }
+// src/audit-sink-jsonl.ts
+import { mkdir, open } from "node:fs/promises";
+import { dirname } from "node:path";
+var log5 = createLogger();
+function createJsonlSink(config) {
+  const { path, fsync = true } = config;
+  let handle = null;
+  let initPromise = null;
+  let writeChain = Promise.resolve();
+  async function getHandle() {
+    if (handle)
+      return handle;
+    if (initPromise)
+      return initPromise;
+    initPromise = (async () => {
+      await mkdir(dirname(path), { recursive: true });
+      handle = await open(path, "a");
+      return handle;
+    })();
+    return initPromise;
+  }
+  function withWriteLock(fn) {
+    const previous = writeChain;
+    const next = previous.catch(() => {}).then(fn);
+    writeChain = next;
+    return next;
+  }
+  return {
+    name: "jsonl",
+    async send(events) {
+      if (events.length === 0)
+        return;
+      return withWriteLock(async () => {
+        const fh = await getHandle();
+        const payload = `${events.map((e) => JSON.stringify(e)).join(`
+`)}
+`;
+        await fh.appendFile(payload, "utf8");
+        if (fsync) {
+          try {
+            await fh.sync();
+          } catch (err2) {
+            log5.warn("jsonl sink fsync failed", { error: err2 });
+          }
+        }
+      });
+    },
+    async shutdown() {
+      await withWriteLock(async () => {
+        if (handle) {
+          try {
+            if (fsync)
+              await handle.sync();
+          } finally {
+            await handle.close();
+            handle = null;
+          }
+        }
+      });
+    }
+  };
+}
 // src/provenance.ts
 import { createHash as createHash2 } from "node:crypto";
 function sha256(input) {
@@ -1343,7 +1405,7 @@ function createProvenanceTracker(options) {
 import { createHash as createHash3 } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, writeFileSync as writeFileSync2 } from "node:fs";
 import { join } from "node:path";
-var log5 = createLogger();
+var log6 = createLogger();
 function createFileExperimentStore(dir) {
   return {
     save(name, data) {
@@ -1354,7 +1416,7 @@ function createFileExperimentStore(dir) {
         const filePath = join(dir, `${name}.json`);
         writeFileSync2(filePath, JSON.stringify(data, null, 2));
       } catch (err2) {
-        log5.error("Failed to save experiment", {
+        log6.error("Failed to save experiment", {
           name,
           error: err2 instanceof Error ? err2.message : String(err2)
         });
@@ -1385,7 +1447,7 @@ function loadFromStore(store, name, stats) {
       stats[vName].metrics[key] = { sum: m.sum, count: m.count };
     }
   }
-  log5.debug("Loaded experiment state", { name, totalAssignments: saved.totalAssignments });
+  log6.debug("Loaded experiment state", { name, totalAssignments: saved.totalAssignments });
 }
 function recordMetrics(s, metrics) {
   for (const [key, value] of Object.entries(metrics)) {
@@ -1453,7 +1515,7 @@ function createExperiment(config) {
       const s = stats[variant.name];
       if (s)
         s.assignments++;
-      log5.debug("Experiment assignment", {
+      log6.debug("Experiment assignment", {
         experiment: name,
         variant: variant.name,
         userId
@@ -1524,7 +1586,7 @@ function instrumentAgent(agent, tracer) {
 // src/studio-exporter.ts
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync3 } from "node:fs";
 import { join as join2 } from "node:path";
-var log6 = createLogger();
+var log7 = createLogger();
 function ensureDir(dirPath) {
   if (!existsSync2(dirPath)) {
     mkdirSync2(dirPath, { recursive: true });
@@ -1534,7 +1596,7 @@ function safeWriteJSON(filePath, data) {
   try {
     writeFileSync3(filePath, JSON.stringify(data, null, 2));
   } catch (err2) {
-    log6.error("Studio exporter write failed", {
+    log7.error("Studio exporter write failed", {
       file: filePath,
       error: err2 instanceof Error ? err2.message : String(err2)
     });
@@ -1919,7 +1981,7 @@ function formatComplianceReport(report) {
 `);
 }
 // src/otel.ts
-var log7 = createLogger();
+var log8 = createLogger();
 var SPAN_KIND_MAP = {
   llm: 3,
   tool: 1,
@@ -2060,10 +2122,10 @@ function createOTLPExporter(config) {
         body: JSON.stringify(payload)
       });
       if (!response.ok) {
-        log7.error(`OTLP export failed: ${response.status} ${response.statusText}`);
+        log8.error(`OTLP export failed: ${response.status} ${response.statusText}`);
       }
     } catch (err2) {
-      log7.error("OTLP export error", { error: err2 instanceof Error ? err2.message : String(err2) });
+      log8.error("OTLP export error", { error: err2 instanceof Error ? err2.message : String(err2) });
     }
   }
   function startAutoFlush() {
@@ -2120,6 +2182,7 @@ export {
   createProvenanceTracker,
   createOTLPExporter,
   createMetrics,
+  createJsonlSink,
   createFileExperimentStore,
   createExperiment,
   createDatadogSink,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@elsium-ai/observe",
-	"version": "0.10.0",
+	"version": "0.11.0",
 	"description": "Observability, tracing, and cost tracking for ElsiumAI",
 	"license": "MIT",
 	"author": "Eric Utrera <ebutrera9103@gmail.com>",
@@ -26,7 +26,7 @@
 		"dev": "bun --watch src/index.ts"
 	},
 	"dependencies": {
-		"@elsium-ai/core": "^0.10.0"
+		"@elsium-ai/core": "^0.11.0"
 	},
 	"devDependencies": {
 		"typescript": "^5.7.0"