@unifyplane/logsdk 0.1.0

package/dist/esm/validate/schema_guard.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+import { SystemOwnership } from "./core/record_builder.js";
+import type { StepRecord } from "./core/types.js";
+type SinkClass = "authoritative" | "observability";
+type Sink = {
+    emit(record: Readonly<StepRecord>): void | Promise<void>;
+    flush?(): void | Promise<void>;
+};
+type SinkEntry = {
+    sink: Sink;
+    sinkClass: SinkClass;
+};
+export type LogSDKConfig = {
+    context: unknown;
+    system: SystemOwnership;
+    sinks: ReadonlyArray<SinkEntry>;
+};
+export type LogApi = {
+    step(message: string): Promise<void>;
+    flush?: () => Promise<void>;
+};
+export type { SystemOwnership };
+export declare function initLogSDK(config: LogSDKConfig): LogApi;
+export declare function createLogger(config: LogSDKConfig): LogApi;
+export { fileNdjsonSink } from "./sinks/file_ndjson.js";
+export { authoritativeNdjsonSink } from "./sinks/file_ndjson.js";
+//# 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":"AAEA,OAAO,EAAmB,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAW5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,KAAK,SAAS,GAAG,eAAe,GAAG,eAAe,CAAC;AAEnD,KAAK,IAAI,GAAG;IACV,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B,CAAC;AAEF,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAwDvD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEzD;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,52 @@
+import { initContext } from "./core/context.js";
+import { createIdGenerator } from "./core/ids.js";
+import { buildStepRecord } from "./core/record_builder.js";
+import { assertValidMessage } from "./core/message_constraints.js";
+import { fanout } from "./core/fanout.js";
+import { assertApiSurface } from "./validate/api_surface_guard.js";
+import { assertStepRecord } from "./validate/schema_guard.js";
+import { AUTHORITATIVE_FAILURE_SWALLOWED, CONTEXT_INJECTION_VIOLATION, PAYLOAD_EMBEDDING_VIOLATION, NonComplianceError, } from "./validate/noncompliance.js";
+export function initLogSDK(config) {
+    initContext(config.context);
+    const idGenerator = createIdGenerator(config.system.instance_id);
+    const sinks = [...config.sinks];
+    const api = {
+        async step(message) {
+            if (typeof message !== "string") {
+                if (message && typeof message === "object") {
+                    throw new NonComplianceError(CONTEXT_INJECTION_VIOLATION, "Per-step context injection is not allowed.");
+                }
+                throw new NonComplianceError(PAYLOAD_EMBEDDING_VIOLATION, "Message must be a string.");
+            }
+            try {
+                assertValidMessage(message);
+            }
+            catch (error) {
+                throw new NonComplianceError(PAYLOAD_EMBEDDING_VIOLATION, error instanceof Error ? error.message : "Invalid message content.");
+            }
+            const record = buildStepRecord(message, idGenerator.nextSequence(), config.system, {
+                record_id: idGenerator.nextRecordId(),
+            });
+            assertStepRecord(record);
+            const outcome = await fanout(record, sinks);
+            if (outcome === "FAILED") {
+                throw new NonComplianceError(AUTHORITATIVE_FAILURE_SWALLOWED, "Authoritative sink failed to emit.");
+            }
+        },
+        async flush() {
+            for (const entry of sinks) {
+                if (entry.sink.flush) {
+                    await entry.sink.flush();
+                }
+            }
+        },
+    };
+    assertApiSurface(api);
+    return api;
+}
+export function createLogger(config) {
+    return initLogSDK(config);
+}
+export { fileNdjsonSink } from "./sinks/file_ndjson.js";
+export { authoritativeNdjsonSink } from "./sinks/file_ndjson.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,eAAe,EAAmB,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EACL,+BAA+B,EAC/B,2BAA2B,EAC3B,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AA4BrC,MAAM,UAAU,UAAU,CAAC,MAAoB;IAC7C,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE5B,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEhC,MAAM,GAAG,GAAW;QAClB,KAAK,CAAC,IAAI,CAAC,OAAe;YACxB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAChC,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;oBAC3C,MAAM,IAAI,kBAAkB,CAC1B,2BAA2B,EAC3B,4CAA4C,CAC7C,CAAC;gBACJ,CAAC;gBAED,MAAM,IAAI,kBAAkB,CAC1B,2BAA2B,EAC3B,2BAA2B,CAC5B,CAAC;YACJ,CAAC;YAED,IAAI,CAAC;gBACH,kBAAkB,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,kBAAkB,CAC1B,2BAA2B,EAC3B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,CACpE,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,WAAW,CAAC,YAAY,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE;gBACjF,SAAS,EAAE,WAAW,CAAC,YAAY,EAAE;aACtC,CAAC,CAAC;YAEH,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAEzB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC5C,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACzB,MAAM,IAAI,kBAAkB,CAC1B,+BAA+B,EAC/B,oCAAoC,CACrC,CAAC;YACJ,CAAC;QACH,CAAC;QACD,KAAK,CAAC,KAAK;YACT,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;gBAC1B,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;oBACrB,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC;IAEF,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACtB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/sinks/file_ndjson.d.ts

@@ -0,0 +1,18 @@
+import type { StepRecord } from "../core/types.js";
+type SinkClass = "authoritative" | "observability";
+type Sink = {
+    emit(record: Readonly<StepRecord>): void | Promise<void>;
+    flush?(): void | Promise<void>;
+};
+type SinkEntry = {
+    sink: Sink;
+    sinkClass: SinkClass;
+};
+export declare function fileNdjsonSink(pathOrOptions: string | {
+    path: string;
+}): SinkEntry;
+export declare function authoritativeNdjsonSink(pathOrOptions: string | {
+    path: string;
+}): SinkEntry;
+export {};
+//# sourceMappingURL=file_ndjson.d.ts.map

package/dist/sinks/file_ndjson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_ndjson.d.ts","sourceRoot":"","sources":["../../src/sinks/file_ndjson.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,KAAK,SAAS,GAAG,eAAe,GAAG,eAAe,CAAC;AAEnD,KAAK,IAAI,GAAG;IACV,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAYlF;AACD,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAY3F"}

package/dist/sinks/file_ndjson.js

@@ -0,0 +1,29 @@
+import fs from "fs";
+import path from "path";
+export function fileNdjsonSink(pathOrOptions) {
+    const p = typeof pathOrOptions === "string" ? pathOrOptions : pathOrOptions.path;
+    const dir = path.dirname(p);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const sink = {
+        emit(record) {
+            fs.appendFileSync(p, JSON.stringify(record) + "\n", { encoding: "utf8" });
+        },
+    };
+    return { sink, sinkClass: "observability" };
+}
+export function authoritativeNdjsonSink(pathOrOptions) {
+    const p = typeof pathOrOptions === "string" ? pathOrOptions : pathOrOptions.path;
+    const dir = path.dirname(p);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const sink = {
+        emit(record) {
+            fs.appendFileSync(p, JSON.stringify(record) + "\n", { encoding: "utf8" });
+        },
+    };
+    return { sink, sinkClass: "authoritative" };
+}
+//# sourceMappingURL=file_ndjson.js.map

package/dist/sinks/file_ndjson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_ndjson.js","sourceRoot":"","sources":["../../src/sinks/file_ndjson.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAexB,MAAM,UAAU,cAAc,CAAC,aAAwC;IACrE,MAAM,CAAC,GAAG,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC;IACjF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,IAAI,GAAS;QACjB,IAAI,CAAC,MAA4B;YAC/B,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5E,CAAC;KACF,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;AAC9C,CAAC;AACD,MAAM,UAAU,uBAAuB,CAAC,aAAwC;IAC9E,MAAM,CAAC,GAAG,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC;IACjF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,IAAI,GAAS;QACjB,IAAI,CAAC,MAA4B;YAC/B,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5E,CAAC;KACF,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;AAC9C,CAAC"}

package/dist/sinks/file_ndjson_sink.d.ts

@@ -0,0 +1,7 @@
+import type { StepRecord } from "../core/types.js";
+export interface FileNdjsonSink {
+    emit(record: StepRecord): Promise<void>;
+    close(): Promise<void>;
+}
+export declare function createFileNdjsonSink(filePath: string): FileNdjsonSink;
+//# sourceMappingURL=file_ndjson_sink.d.ts.map

package/dist/sinks/file_ndjson_sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_ndjson_sink.d.ts","sourceRoot":"","sources":["../../src/sinks/file_ndjson_sink.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAkCrE"}

package/dist/sinks/file_ndjson_sink.js

@@ -0,0 +1,36 @@
+/// <reference path="../fs-shim.d.ts" />
+import { promises as fs } from "fs";
+export function createFileNdjsonSink(filePath) {
+    let closed = false;
+    return {
+        async emit(record) {
+            if (closed) {
+                throw new Error("File NDJSON sink is closed.");
+            }
+            const line = JSON.stringify(record);
+            const payload = `${line}\n`;
+            const handle = await fs.open(filePath, "a");
+            try {
+                const result = await handle.write(payload, undefined, "utf8");
+                if (!result || typeof result.bytesWritten !== "number") {
+                    throw new Error("File NDJSON sink write did not report bytes.");
+                }
+                if (result.bytesWritten !== payload.length) {
+                    throw new Error("File NDJSON sink partial write detected.");
+                }
+                await handle.sync();
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                throw new Error(`File NDJSON sink write failed: ${message}`);
+            }
+            finally {
+                await handle.close();
+            }
+        },
+        async close() {
+            closed = true;
+        },
+    };
+}
+//# sourceMappingURL=file_ndjson_sink.js.map

package/dist/sinks/file_ndjson_sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_ndjson_sink.js","sourceRoot":"","sources":["../../src/sinks/file_ndjson_sink.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AAQpC,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,MAAkB;YAC3B,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YACjD,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACpC,MAAM,OAAO,GAAG,GAAG,IAAI,IAAI,CAAC;YAC5B,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAE5C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;gBAC9D,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;oBACvD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;gBAClE,CAAC;gBAED,IAAI,MAAM,CAAC,YAAY,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;oBAC3C,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;gBAC9D,CAAC;gBACD,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACtB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,MAAM,IAAI,KAAK,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;YAC/D,CAAC;oBAAS,CAAC;gBACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACvB,CAAC;QACH,CAAC;QACD,KAAK,CAAC,KAAK;YACT,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/sinks/sink_types.d.ts

@@ -0,0 +1,12 @@
+import type { StepRecord as CoreStepRecord } from "../core/types.js";
+export type StepRecord = Readonly<CoreStepRecord>;
+export type SinkClass = "authoritative" | "observability";
+export interface Sink<TRecord = StepRecord> {
+    emit(record: Readonly<TRecord>): void | Promise<void>;
+    flush?(): void | Promise<void>;
+}
+export interface SinkEntry<TRecord = StepRecord> {
+    sink: Sink<TRecord>;
+    sinkClass: SinkClass;
+}
+//# sourceMappingURL=sink_types.d.ts.map

package/dist/sinks/sink_types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink_types.d.ts","sourceRoot":"","sources":["../../src/sinks/sink_types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAErE,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC;AAElD,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,eAAe,CAAC;AAE1D,MAAM,WAAW,IAAI,CAAC,OAAO,GAAG,UAAU;IACxC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,SAAS,CAAC,OAAO,GAAG,UAAU;IAC7C,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,SAAS,EAAE,SAAS,CAAC;CACtB"}

package/dist/sinks/sink_types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sink_types.js.map

package/dist/sinks/sink_types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink_types.js","sourceRoot":"","sources":["../../src/sinks/sink_types.ts"],"names":[],"mappings":""}

package/dist/sinks/stdout_sink.d.ts

@@ -0,0 +1,6 @@
+import type { StepRecord } from "../core/types.js";
+export interface StdoutSink {
+    emit(record: StepRecord): Promise<void>;
+}
+export declare function createStdoutSink(): StdoutSink;
+//# sourceMappingURL=stdout_sink.d.ts.map

package/dist/sinks/stdout_sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdout_sink.d.ts","sourceRoot":"","sources":["../../src/sinks/stdout_sink.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,wBAAgB,gBAAgB,IAAI,UAAU,CAW7C"}

package/dist/sinks/stdout_sink.js

@@ -0,0 +1,15 @@
+/// <reference path="../process-shim.d.ts" />
+export function createStdoutSink() {
+    return {
+        async emit(record) {
+            try {
+                const line = JSON.stringify(record);
+                process.stdout.write(`${line}\n`);
+            }
+            catch {
+                // Best-effort only: never throw.
+            }
+        },
+    };
+}
+//# sourceMappingURL=stdout_sink.js.map

package/dist/sinks/stdout_sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdout_sink.js","sourceRoot":"","sources":["../../src/sinks/stdout_sink.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAQ7C,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,MAAkB;YAC3B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,iCAAiC;YACnC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/types/core/clock.d.ts

@@ -0,0 +1,3 @@
+export declare function nowUtcIso(): string;
+export declare function monotonicNow(): number;
+//# sourceMappingURL=clock.d.ts.map

package/dist/types/core/clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../../../src/core/clock.ts"],"names":[],"mappings":"AAKA,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAerC"}

package/dist/types/core/context.d.ts

@@ -0,0 +1,10 @@
+type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export declare function initContext(context: unknown, version?: string): void;
+export declare function getContextHash(): string;
+export declare function getContextVersion(): string;
+export declare function resetContextForTests(): void;
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/types/core/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/core/context.ts"],"names":[],"mappings":"AAIA,KAAK,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AACtD,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAkBnF,wBAAgB,WAAW,CACzB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,MAAgC,GACxC,IAAI,CAiBN;AAED,wBAAgB,cAAc,IAAI,MAAM,CAKvC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C"}

package/dist/types/core/fanout.d.ts

@@ -0,0 +1,4 @@
+import type { SinkEntry, StepRecord } from "../sinks/sink_types.js";
+export type FanoutOutcome = "OK" | "DEGRADED" | "FAILED";
+export declare function fanout(record: StepRecord, sinks: ReadonlyArray<SinkEntry>): Promise<FanoutOutcome>;
+//# sourceMappingURL=fanout.d.ts.map

package/dist/types/core/fanout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fanout.d.ts","sourceRoot":"","sources":["../../../src/core/fanout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIpE,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEzD,wBAAsB,MAAM,CAC1B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,GAC9B,OAAO,CAAC,aAAa,CAAC,CA4BxB"}

package/dist/types/core/ids.d.ts

@@ -0,0 +1,6 @@
+export interface IdGenerator {
+    nextRecordId(): string;
+    nextSequence(): number;
+}
+export declare function createIdGenerator(instanceTag?: string): IdGenerator;
+//# sourceMappingURL=ids.d.ts.map

package/dist/types/core/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../../src/core/ids.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,YAAY,IAAI,MAAM,CAAC;IACvB,YAAY,IAAI,MAAM,CAAC;CACxB;AASD,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAoBnE"}

package/dist/types/core/message_constraints.d.ts

@@ -0,0 +1,4 @@
+declare const MESSAGE_MAX_LENGTH = 512;
+export declare function assertValidMessage(message: unknown): string;
+export { MESSAGE_MAX_LENGTH };
+//# sourceMappingURL=message_constraints.d.ts.map

package/dist/types/core/message_constraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message_constraints.d.ts","sourceRoot":"","sources":["../../../src/core/message_constraints.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,kBAAkB,MAAM,CAAC;AAyC/B,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAsB3D;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/types/core/outcomes.d.ts

@@ -0,0 +1,5 @@
+export declare const OK: "OK";
+export declare const DEGRADED: "DEGRADED";
+export declare const FAILED: "FAILED";
+export type Outcome = typeof OK | typeof DEGRADED | typeof FAILED;
+//# sourceMappingURL=outcomes.d.ts.map

package/dist/types/core/outcomes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcomes.d.ts","sourceRoot":"","sources":["../../../src/core/outcomes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,EAAE,EAAG,IAAa,CAAC;AAChC,eAAO,MAAM,QAAQ,EAAG,UAAmB,CAAC;AAC5C,eAAO,MAAM,MAAM,EAAG,QAAiB,CAAC;AAExC,MAAM,MAAM,OAAO,GAAG,OAAO,EAAE,GAAG,OAAO,QAAQ,GAAG,OAAO,MAAM,CAAC"}

package/dist/types/core/record_builder.d.ts

@@ -0,0 +1,34 @@
+import { assertValidMessage } from "./message_constraints.js";
+import type { StepRecord } from "./types.js";
+export declare const message_constraints: {
+    maxLength: number;
+    validate: typeof assertValidMessage;
+};
+export type EvidenceRef = string;
+export type SystemOwnership = {
+    institution: string;
+    system_name: string;
+    system_type: string;
+    environment: string;
+    system_version: string;
+    instance_id?: string;
+};
+export type StepRecordOverrides = {
+    record_id?: string;
+    timestamp_utc?: string;
+    monotonic_time?: number;
+    message_code?: string;
+    evidence_refs?: EvidenceRef[];
+    trace_id?: string;
+    span_id?: string;
+    parent_step_id?: string;
+    surface_type?: string;
+    surface_name?: string;
+    surface_instance?: string;
+    source_file?: string;
+    source_module?: string;
+    source_function?: string;
+    source_line?: number;
+};
+export declare function buildStepRecord(message: string, sequence: number, system: SystemOwnership, overrides?: StepRecordOverrides): StepRecord;
+//# sourceMappingURL=record_builder.d.ts.map

package/dist/types/core/record_builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record_builder.d.ts","sourceRoot":"","sources":["../../../src/core/record_builder.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAsB,MAAM,0BAA0B,CAAC;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,eAAO,MAAM,mBAAmB;;;CAG/B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,eAAe,EACvB,SAAS,GAAE,mBAAwB,GAClC,UAAU,CAsDZ"}

package/dist/types/core/spool.d.ts

@@ -0,0 +1,4 @@
+import type { StepRecord } from "./types.js";
+export declare function getEmergencySpoolPath(): string;
+export declare function writeEmergencySpool(record: StepRecord): Promise<void>;
+//# sourceMappingURL=spool.d.ts.map

package/dist/types/core/spool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spool.d.ts","sourceRoot":"","sources":["../../../src/core/spool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAW7C,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB3E"}

package/dist/types/core/types.d.ts

@@ -0,0 +1,33 @@
+export type SinkClass = "authoritative" | "observability";
+export type FanoutOutcome = "OK" | "DEGRADED" | "FAILED";
+export interface StepRecord {
+    record_version: "log.step.v1";
+    record_id: string;
+    sequence: number;
+    timestamp_utc: string;
+    monotonic_time: number;
+    institution: string;
+    system_name: string;
+    system_type: string;
+    environment: string;
+    system_version: string;
+    instance_id?: string;
+    trace_id?: string;
+    span_id?: string;
+    parent_step_id?: string;
+    surface_type?: string;
+    surface_name?: string;
+    surface_instance?: string;
+    source_file?: string;
+    source_module?: string;
+    source_function?: string;
+    source_line?: number;
+    message: string;
+    message_code?: string;
+    context_hash: string;
+    context_version: string;
+    evidence_refs?: string[];
+    record_hash: string;
+    hash_algorithm: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,eAAe,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEzD,MAAM,WAAW,UAAU;IAEzB,cAAc,EAAE,aAAa,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IAGjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IAGvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAG1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IAGxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAGzB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB"}

package/dist/types/index.d.ts

@@ -0,0 +1,26 @@
+import { SystemOwnership } from "./core/record_builder.js";
+import type { StepRecord } from "./core/types.js";
+type SinkClass = "authoritative" | "observability";
+type Sink = {
+    emit(record: Readonly<StepRecord>): void | Promise<void>;
+    flush?(): void | Promise<void>;
+};
+type SinkEntry = {
+    sink: Sink;
+    sinkClass: SinkClass;
+};
+export type LogSDKConfig = {
+    context: unknown;
+    system: SystemOwnership;
+    sinks: ReadonlyArray<SinkEntry>;
+};
+export type LogApi = {
+    step(message: string): Promise<void>;
+    flush?: () => Promise<void>;
+};
+export type { SystemOwnership };
+export declare function initLogSDK(config: LogSDKConfig): LogApi;
+export declare function createLogger(config: LogSDKConfig): LogApi;
+export { fileNdjsonSink } from "./sinks/file_ndjson.js";
+export { authoritativeNdjsonSink } from "./sinks/file_ndjson.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAW5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,KAAK,SAAS,GAAG,eAAe,GAAG,eAAe,CAAC;AAEnD,KAAK,IAAI,GAAG;IACV,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B,CAAC;AAEF,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAwDvD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEzD;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/types/sinks/file_ndjson.d.ts

@@ -0,0 +1,18 @@
+import type { StepRecord } from "../core/types.js";
+type SinkClass = "authoritative" | "observability";
+type Sink = {
+    emit(record: Readonly<StepRecord>): void | Promise<void>;
+    flush?(): void | Promise<void>;
+};
+type SinkEntry = {
+    sink: Sink;
+    sinkClass: SinkClass;
+};
+export declare function fileNdjsonSink(pathOrOptions: string | {
+    path: string;
+}): SinkEntry;
+export declare function authoritativeNdjsonSink(pathOrOptions: string | {
+    path: string;
+}): SinkEntry;
+export {};
+//# sourceMappingURL=file_ndjson.d.ts.map

package/dist/types/sinks/file_ndjson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_ndjson.d.ts","sourceRoot":"","sources":["../../../src/sinks/file_ndjson.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,KAAK,SAAS,GAAG,eAAe,GAAG,eAAe,CAAC;AAEnD,KAAK,IAAI,GAAG;IACV,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAYlF;AACD,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAY3F"}

package/dist/types/sinks/file_ndjson_sink.d.ts

@@ -0,0 +1,7 @@
+import type { StepRecord } from "../core/types.js";
+export interface FileNdjsonSink {
+    emit(record: StepRecord): Promise<void>;
+    close(): Promise<void>;
+}
+export declare function createFileNdjsonSink(filePath: string): FileNdjsonSink;
+//# sourceMappingURL=file_ndjson_sink.d.ts.map

package/dist/types/sinks/file_ndjson_sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_ndjson_sink.d.ts","sourceRoot":"","sources":["../../../src/sinks/file_ndjson_sink.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAkCrE"}

package/dist/types/sinks/sink_types.d.ts

@@ -0,0 +1,12 @@
+import type { StepRecord as CoreStepRecord } from "../core/types.js";
+export type StepRecord = Readonly<CoreStepRecord>;
+export type SinkClass = "authoritative" | "observability";
+export interface Sink<TRecord = StepRecord> {
+    emit(record: Readonly<TRecord>): void | Promise<void>;
+    flush?(): void | Promise<void>;
+}
+export interface SinkEntry<TRecord = StepRecord> {
+    sink: Sink<TRecord>;
+    sinkClass: SinkClass;
+}
+//# sourceMappingURL=sink_types.d.ts.map

package/dist/types/sinks/sink_types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink_types.d.ts","sourceRoot":"","sources":["../../../src/sinks/sink_types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAErE,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC;AAElD,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,eAAe,CAAC;AAE1D,MAAM,WAAW,IAAI,CAAC,OAAO,GAAG,UAAU;IACxC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,SAAS,CAAC,OAAO,GAAG,UAAU;IAC7C,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,SAAS,EAAE,SAAS,CAAC;CACtB"}

package/dist/types/sinks/stdout_sink.d.ts

@@ -0,0 +1,6 @@
+import type { StepRecord } from "../core/types.js";
+export interface StdoutSink {
+    emit(record: StepRecord): Promise<void>;
+}
+export declare function createStdoutSink(): StdoutSink;
+//# sourceMappingURL=stdout_sink.d.ts.map

package/dist/types/sinks/stdout_sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdout_sink.d.ts","sourceRoot":"","sources":["../../../src/sinks/stdout_sink.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,wBAAgB,gBAAgB,IAAI,UAAU,CAW7C"}

package/dist/types/validate/api_surface_guard.d.ts

@@ -0,0 +1,2 @@
+export declare function assertApiSurface(surface: unknown): void;
+//# sourceMappingURL=api_surface_guard.d.ts.map

package/dist/types/validate/api_surface_guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api_surface_guard.d.ts","sourceRoot":"","sources":["../../../src/validate/api_surface_guard.ts"],"names":[],"mappings":"AA2DA,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8CvD"}

package/dist/types/validate/noncompliance.d.ts

@@ -0,0 +1,15 @@
+export declare const API_SURFACE_VIOLATION: "API_SURFACE_VIOLATION";
+export declare const CONTEXT_INJECTION_VIOLATION: "CONTEXT_INJECTION_VIOLATION";
+export declare const PAYLOAD_EMBEDDING_VIOLATION: "PAYLOAD_EMBEDDING_VIOLATION";
+export declare const CANONICAL_SCHEMA_VIOLATION: "CANONICAL_SCHEMA_VIOLATION";
+export declare const SINK_MUTATION_VIOLATION: "SINK_MUTATION_VIOLATION";
+export declare const NO_AUTHORITATIVE_SINK: "NO_AUTHORITATIVE_SINK";
+export declare const FANOUT_NONDETERMINISM: "FANOUT_NONDETERMINISM";
+export declare const AUTHORITATIVE_FAILURE_SWALLOWED: "AUTHORITATIVE_FAILURE_SWALLOWED";
+export declare const UNBOUNDED_BUFFER_RISK: "UNBOUNDED_BUFFER_RISK";
+export type NonComplianceCode = typeof API_SURFACE_VIOLATION | typeof CONTEXT_INJECTION_VIOLATION | typeof PAYLOAD_EMBEDDING_VIOLATION | typeof CANONICAL_SCHEMA_VIOLATION | typeof SINK_MUTATION_VIOLATION | typeof NO_AUTHORITATIVE_SINK | typeof FANOUT_NONDETERMINISM | typeof AUTHORITATIVE_FAILURE_SWALLOWED | typeof UNBOUNDED_BUFFER_RISK;
+export declare class NonComplianceError extends Error {
+    readonly code: NonComplianceCode;
+    constructor(code: NonComplianceCode, message: string);
+}
+//# sourceMappingURL=noncompliance.d.ts.map

package/dist/types/validate/noncompliance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noncompliance.d.ts","sourceRoot":"","sources":["../../../src/validate/noncompliance.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,EAAG,uBAAgC,CAAC;AACtE,eAAO,MAAM,2BAA2B,EACtC,6BAAsC,CAAC;AACzC,eAAO,MAAM,2BAA2B,EACtC,6BAAsC,CAAC;AACzC,eAAO,MAAM,0BAA0B,EACrC,4BAAqC,CAAC;AACxC,eAAO,MAAM,uBAAuB,EAAG,yBAAkC,CAAC;AAC1E,eAAO,MAAM,qBAAqB,EAAG,uBAAgC,CAAC;AACtE,eAAO,MAAM,qBAAqB,EAAG,uBAAgC,CAAC;AACtE,eAAO,MAAM,+BAA+B,EAC1C,iCAA0C,CAAC;AAC7C,eAAO,MAAM,qBAAqB,EAAG,uBAAgC,CAAC;AAEtE,MAAM,MAAM,iBAAiB,GACzB,OAAO,qBAAqB,GAC5B,OAAO,2BAA2B,GAClC,OAAO,2BAA2B,GAClC,OAAO,0BAA0B,GACjC,OAAO,uBAAuB,GAC9B,OAAO,qBAAqB,GAC5B,OAAO,qBAAqB,GAC5B,OAAO,+BAA+B,GACtC,OAAO,qBAAqB,CAAC;AAEjC,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;gBAErB,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM;CAIrD"}

package/dist/types/validate/schema_guard.d.ts

@@ -0,0 +1,5 @@
+import type { StepRecord } from "../core/types.js";
+import type { SinkEntry } from "../sinks/sink_types.js";
+export declare function assertStepRecord(record: unknown): asserts record is StepRecord;
+export declare function assertHasAuthoritativeSink(sinks: ReadonlyArray<SinkEntry>): void;
+//# sourceMappingURL=schema_guard.d.ts.map

package/dist/types/validate/schema_guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema_guard.d.ts","sourceRoot":"","sources":["../../../src/validate/schema_guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AA0DxD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,CA8G9E;AAID,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,GAC9B,IAAI,CAWN"}

package/dist/validate/api_surface_guard.d.ts

@@ -0,0 +1,2 @@
+export declare function assertApiSurface(surface: unknown): void;
+//# sourceMappingURL=api_surface_guard.d.ts.map

package/dist/validate/api_surface_guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api_surface_guard.d.ts","sourceRoot":"","sources":["../../src/validate/api_surface_guard.ts"],"names":[],"mappings":"AA2DA,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8CvD"}