@relkit/observability-local 0.0.0-stage → 0.1.1

package/dist/local/duckdb-worker.types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Owns duckdb worker.types for the optional local history store.
+ * Shared records and query contracts come from lightweight observability; native
+ * handles and worker lifetimes remain owned by this storage package.
+ */
+import type { Effect } from "effect";
+import type { DuckdbDatabaseEffects } from "./duckdb-database.types.js";
+import type { DuckdbError } from "./duckdb-error.js";
+import type { DuckdbQueryError } from "./duckdb-query-error.js";
+import type { LocalWorkerCommand } from "@relkit/observability/local/record";
+/**
+ * Serialized command operations for the local DuckDB worker.
+ * The Layer owns any open database until its Scope closes.
+ *
+ * @example
+ * const worker = yield* DuckdbWorkerService;
+ * yield* worker.execute({ type: "flush" });
+ */
+export interface DuckdbWorkerEffects {
+    /**
+     * Executes one IPC command with a tagged database or query failure.
+     * @param command - Open, append, query, retention, flush, or close command.
+     * @returns An Effect with the command result or tagged failure.
+     * @example
+     * const summary = yield* worker.execute({ type: "open", root });
+     */
+    readonly execute: (command: LocalWorkerCommand) => Effect.Effect<DuckdbWorkerResult, DuckdbError | DuckdbQueryError>;
+    /**
+     * Flushes and releases the active database Scope once.
+     * @returns An Effect completing after release or a DuckdbError.
+     * @example
+     * yield* worker.close();
+     */
+    readonly close: () => Effect.Effect<void, DuckdbError>;
+}
+/** Actual command results before JSON serialization at the IPC boundary. */
+export type DuckdbWorkerResult = void | DuckdbDatabaseEffects["imported"] | Effect.Success<ReturnType<DuckdbDatabaseEffects["append"]>> | Effect.Success<ReturnType<DuckdbDatabaseEffects["list"]>> | Effect.Success<ReturnType<DuckdbDatabaseEffects["detail"]>>;
+//# sourceMappingURL=duckdb-worker.types.d.ts.map

package/dist/local/duckdb-worker.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-worker.types.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-worker.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,CAChB,OAAO,EAAE,kBAAkB,KACxB,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,WAAW,GAAG,gBAAgB,CAAC,CAAC;IACvE;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;CACxD;AAED,4EAA4E;AAC5E,MAAM,MAAM,kBAAkB,GAC1B,IAAI,GACJ,qBAAqB,CAAC,UAAU,CAAC,GACjC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC,GAC3D,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC,GACzD,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC"}

package/dist/local/duckdb-worker.types.js

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

package/dist/local/duckdb-worker.types.js.map

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

package/dist/local/import-history-effect.d.ts

@@ -0,0 +1,9 @@
+import { Effect } from "effect";
+import type { DuckdbConnectionPort } from "./duckdb-driver.types.js";
+import type { LegacyAppend } from "./import-history.types.js";
+/** @param root - Unchanged diagnostic history root. @param connection - Scoped native connection. @param append - Idempotent append operation. @returns Original import summary or typed IO/storage failure. */
+export declare const importLocalHistoryEffect: (root: string, connection: DuckdbConnectionPort, append: LegacyAppend) => Effect.Effect<{
+    records: number;
+    malformed: number;
+}, import("./duckdb-error.js").DuckdbError, never>;
+//# sourceMappingURL=import-history-effect.d.ts.map

package/dist/local/import-history-effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-history-effect.d.ts","sourceRoot":"","sources":["../../src/local/import-history-effect.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAKhC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,gNAAgN;AAChN,eAAO,MAAM,wBAAwB;;;kDAsBnC,CAAC"}

package/dist/local/import-history-effect.js

@@ -0,0 +1,32 @@
+/**
+ * Imports existing history in stable path order using original path/hash markers.
+ * Source files, receipt identities, malformed counts and applied schema stay intact.
+ */
+import { relative } from "node:path";
+import { Effect } from "effect";
+import { readDuckdbSql, runDuckdbSql } from "./duckdb-sql.js";
+import { historyFiles, historyFingerprint } from "./import-history-files.js";
+import { importLegacyLines } from "./import-history-lines.js";
+import { observeDuckdb } from "./duckdb-metrics.js";
+/** @param root - Unchanged diagnostic history root. @param connection - Scoped native connection. @param append - Idempotent append operation. @returns Original import summary or typed IO/storage failure. */
+export const importLocalHistoryEffect = Effect.fn("ObservabilityDuckdb.import")(function* (root, connection, append) {
+    return yield* observeDuckdb("import", Effect.gen(function* () {
+        const summaries = yield* Effect.forEach(yield* historyFiles(root), (path) => importHistoryFile(root, path, connection, append), { concurrency: 1 });
+        return summaries.reduce((total, item) => ({
+            records: total.records + item.records,
+            malformed: total.malformed + item.malformed,
+        }), { records: 0, malformed: 0 });
+    }));
+});
+/** @param root - History root. @param path - Existing segment. @param connection - Native imports table. @param append - Transactional writer. @returns Counts for a new file fingerprint, or zero for an existing import. */
+const importHistoryFile = Effect.fn("ObservabilityDuckdb.import.file")(function* (root, path, connection, append) {
+    const sourcePath = relative(root, path).replace(/\.active\.ndjson$/, ".ndjson");
+    const source = `${sourcePath}:${yield* historyFingerprint(path)}`;
+    const exists = yield* readDuckdbSql(connection, "import", "SELECT source FROM imports WHERE source = ?", [source]);
+    if (exists.getRowObjectsJson().length > 0)
+        return { records: 0, malformed: 0 };
+    const summary = yield* importLegacyLines(path, sourcePath, append);
+    yield* runDuckdbSql(connection, "import", "INSERT INTO imports VALUES (?, ?) ON CONFLICT DO NOTHING", [source, summary.malformed]);
+    return summary;
+});
+//# sourceMappingURL=import-history-effect.js.map

package/dist/local/import-history-effect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-history-effect.js","sourceRoot":"","sources":["../../src/local/import-history-effect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIpD,gNAAgN;AAChN,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,EAAE,CAAC,4BAA4B,CAAC,CAAC,QAAQ,CAAC,EACvF,IAAY,EACZ,UAAgC,EAChC,MAAoB;IAEpB,OAAO,KAAK,CAAC,CAAC,aAAa,CACzB,QAAQ,EACR,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CACrC,KAAK,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,EACzB,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EAC3D,EAAE,WAAW,EAAE,CAAC,EAAE,CACnB,CAAC;QACF,OAAO,SAAS,CAAC,MAAM,CACrB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO;YACrC,SAAS,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS;SAC5C,CAAC,EACF,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAC7B,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,8NAA8N;AAC9N,MAAM,iBAAiB,GAAG,MAAM,CAAC,EAAE,CAAC,iCAAiC,CAAC,CAAC,QAAQ,CAAC,EAC9E,IAAY,EACZ,IAAY,EACZ,UAAgC,EAChC,MAAoB;IAEpB,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;IAChF,MAAM,MAAM,GAAG,GAAG,UAAU,IAAI,KAAK,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;IAClE,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,aAAa,CACjC,UAAU,EACV,QAAQ,EACR,6CAA6C,EAC7C,CAAC,MAAM,CAAC,CACT,CAAC;IACF,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAC/E,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IACnE,KAAK,CAAC,CAAC,YAAY,CACjB,UAAU,EACV,QAAQ,EACR,0DAA0D,EAC1D,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAC5B,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC,CAAC"}

package/dist/local/import-history-files.d.ts

@@ -0,0 +1,5 @@
+import { Effect } from "effect";
+import { duckdbError } from "./duckdb-error.js";
+export declare const historyFiles: (root: string) => Effect.Effect<string[], ReturnType<typeof duckdbError>>;
+export declare const historyFingerprint: (path: string) => Effect.Effect<string, import("./duckdb-error.js").DuckdbError, never>;
+//# sourceMappingURL=import-history-files.d.ts.map

package/dist/local/import-history-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-history-files.d.ts","sourceRoot":"","sources":["../../src/local/import-history-files.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,eAAO,MAAM,YAAY,EAAE,CACzB,IAAI,EAAE,MAAM,KACT,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAqBzD,CAAC;AACH,eAAO,MAAM,kBAAkB,yFAoB7B,CAAC"}

package/dist/local/import-history-files.js

@@ -0,0 +1,37 @@
+/**
+ * Owns import history effect for the optional local history store.
+ * Shared records and query contracts come from lightweight observability; native
+ * handles and worker lifetimes remain owned by this storage package.
+ */
+import { createHash } from "node:crypto";
+import { createReadStream } from "node:fs";
+import { readdir } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { createInterface } from "node:readline";
+import { Effect, Stream } from "effect";
+import { duckdbError } from "./duckdb-error.js";
+export const historyFiles = Effect.fn("ObservabilityDuckdb.import.files")(function* (root) {
+    const entries = yield* Effect.tryPromise({
+        try: () => readdir(root, { withFileTypes: true }),
+        catch: (cause) => duckdbError("import-files", cause),
+    });
+    const nested = yield* Effect.forEach(entries, (item) => Effect.gen(function* () {
+        const path = join(root, item.name);
+        return item.isDirectory()
+            ? yield* historyFiles(path)
+            : item.isFile() && item.name.endsWith(".ndjson")
+                ? [path]
+                : [];
+    }), { concurrency: 1 });
+    return nested.flat().sort();
+});
+export const historyFingerprint = Effect.fn("ObservabilityDuckdb.import.fingerprint")(function* (path) {
+    const hash = createHash("sha256");
+    yield* Effect.acquireUseRelease(Effect.sync(() => createReadStream(path)), (input) => Stream.runForEach(Stream.fromAsyncIterable(input, (cause) => duckdbError("import-read", cause)), (chunk) => Effect.sync(() => {
+        hash.update(chunk);
+    })), (input) => Effect.sync(() => {
+        input.destroy();
+    }));
+    return hash.digest("hex");
+});
+//# sourceMappingURL=import-history-files.js.map

package/dist/local/import-history-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-history-files.js","sourceRoot":"","sources":["../../src/local/import-history-files.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,MAAM,CAAC,MAAM,YAAY,GAEsC,MAAM,CAAC,EAAE,CACtE,kCAAkC,CACnC,CAAC,QAAQ,CAAC,EAAE,IAAY;IACvB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;QACvC,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;QACjD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,cAAc,EAAE,KAAK,CAAC;KACrD,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAClC,OAAO,EACP,CAAC,IAAI,EAAE,EAAE,CACP,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC,WAAW,EAAE;YACvB,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC;YAC3B,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAC9C,CAAC,CAAC,CAAC,IAAI,CAAC;gBACR,CAAC,CAAC,EAAE,CAAC;IACX,CAAC,CAAC,EACJ,EAAE,WAAW,EAAE,CAAC,EAAE,CACnB,CAAC;IACF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;AAC9B,CAAC,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,EAAE,CAAC,wCAAwC,CAAC,CAAC,QAAQ,CAAC,EAC7F,IAAY;IAEZ,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,KAAK,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAC7B,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,EACzC,CAAC,KAAK,EAAE,EAAE,CACR,MAAM,CAAC,UAAU,CACf,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC,EAC7E,CAAC,KAAK,EAAE,EAAE,CACR,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC,CAAC,CACL,EACH,CAAC,KAAK,EAAE,EAAE,CACR,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC,CAAC,CACL,CAAC;IACF,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC,CAAC,CAAC"}

package/dist/local/import-history-line.d.ts

@@ -0,0 +1,6 @@
+import { Effect } from "effect";
+import type { LegacyAppend } from "./import-history.types.js";
+import type { LegacyLineState } from "./import-history-lines.types.js";
+/** @param state - Per-file identity and batch state. @param line - Original file line. @param append - Transactional idempotent writer. @returns Completion after admission or one malformed count. */
+export declare const importLegacyLine: (state: LegacyLineState, line: string, append: LegacyAppend) => Effect.Effect<void, import("./duckdb-error.js").DuckdbError, never>;
+//# sourceMappingURL=import-history-line.d.ts.map

package/dist/local/import-history-line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-history-line.d.ts","sourceRoot":"","sources":["../../src/local/import-history-line.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AA8BvE,uMAAuM;AACvM,eAAO,MAAM,gBAAgB,qIAoB3B,CAAC"}

package/dist/local/import-history-line.js

@@ -0,0 +1,51 @@
+/** Derives unchanged path/line/hash receipt keys and admits bounded legacy batches. */
+import { createHash } from "node:crypto";
+import { Effect } from "effect";
+import { validateLocalRecord } from "@relkit/observability/local/record";
+import { duckdbError } from "./duckdb-error.js";
+/** @param sourcePath - Normalized relative segment path. @param lineNumber - Original physical line. @param line - Untrusted NDJSON. @returns A validated legacy envelope. */
+function decodeLegacyLine(sourcePath, lineNumber, line) {
+    const record = JSON.parse(line);
+    const envelope = {
+        key: `legacy:${sourcePath}:${lineNumber}:${createHash("sha256").update(line).digest("hex")}`,
+        record,
+        origin: legacyOrigin(record),
+    };
+    validateLocalRecord(envelope);
+    return envelope;
+}
+/** @typeParam Record - Foreign parsed record. @param record - Parsed input narrowed before property use. @returns Existing legacy CLI/application source attribution. */
+function legacyOrigin(record) {
+    if (record === null ||
+        typeof record !== "object" ||
+        !("signal" in record) ||
+        record.signal !== "log" ||
+        !("component" in record) ||
+        typeof record.component !== "string")
+        return "application";
+    if (record.component.startsWith("cli."))
+        return "relkit";
+    if (record.component === "inspector")
+        return "inspector";
+    return "application";
+}
+/** @param state - Per-file identity and batch state. @param line - Original file line. @param append - Transactional idempotent writer. @returns Completion after admission or one malformed count. */
+export const importLegacyLine = Effect.fn("ObservabilityDuckdb.import.line")(function* (state, line, append) {
+    state.lineNumber++;
+    if (!line.trim())
+        return;
+    const item = yield* Effect.try({
+        try: () => decodeLegacyLine(state.sourcePath, state.lineNumber, line),
+        catch: (cause) => duckdbError("import-decode", cause),
+    }).pipe(Effect.option);
+    if (item._tag === "None") {
+        state.malformed++;
+        return;
+    }
+    state.pending.push(item.value);
+    if (state.pending.length === 256) {
+        state.records += (yield* append(state.pending)).length;
+        state.pending = [];
+    }
+});
+//# sourceMappingURL=import-history-line.js.map

package/dist/local/import-history-line.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-history-line.js","sourceRoot":"","sources":["../../src/local/import-history-line.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIhD,8KAA8K;AAC9K,SAAS,gBAAgB,CAAC,UAAkB,EAAE,UAAkB,EAAE,IAAY;IAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG;QACf,GAAG,EAAE,UAAU,UAAU,IAAI,UAAU,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;QAC5F,MAAM;QACN,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC;KAC7B,CAAC;IACF,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC9B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,yKAAyK;AACzK,SAAS,YAAY,CAAS,MAAc;IAC1C,IACE,MAAM,KAAK,IAAI;QACf,OAAO,MAAM,KAAK,QAAQ;QAC1B,CAAC,CAAC,QAAQ,IAAI,MAAM,CAAC;QACrB,MAAM,CAAC,MAAM,KAAK,KAAK;QACvB,CAAC,CAAC,WAAW,IAAI,MAAM,CAAC;QACxB,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;QAEpC,OAAO,aAAa,CAAC;IACvB,IAAI,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,QAAQ,CAAC;IACzD,IAAI,MAAM,CAAC,SAAS,KAAK,WAAW;QAAE,OAAO,WAAW,CAAC;IACzD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,uMAAuM;AACvM,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,EAAE,CAAC,iCAAiC,CAAC,CAAC,QAAQ,CAAC,EACpF,KAAsB,EACtB,IAAY,EACZ,MAAoB;IAEpB,KAAK,CAAC,UAAU,EAAE,CAAC;IACnB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO;IACzB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAC7B,GAAG,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC;QACrE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,eAAe,EAAE,KAAK,CAAC;KACtD,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACvB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACzB,KAAK,CAAC,SAAS,EAAE,CAAC;QAClB,OAAO;IACT,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACjC,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QACvD,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC;IACrB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/local/import-history-lines.d.ts

@@ -0,0 +1,8 @@
+import { Effect } from "effect";
+import type { LegacyAppend } from "./import-history.types.js";
+/** @param path - Existing segment file. @param sourcePath - Stable normalized relative path. @param append - Idempotent transactional append. @returns Accepted/malformed counts after all file handles close. */
+export declare const importLegacyLines: (path: string, sourcePath: string, append: LegacyAppend) => Effect.Effect<{
+    records: number;
+    malformed: number;
+}, import("./duckdb-error.js").DuckdbError, never>;
+//# sourceMappingURL=import-history-lines.d.ts.map

package/dist/local/import-history-lines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-history-lines.d.ts","sourceRoot":"","sources":["../../src/local/import-history-lines.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AAGxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,kNAAkN;AAClN,eAAO,MAAM,iBAAiB;;;kDA8B5B,CAAC"}

package/dist/local/import-history-lines.js

@@ -0,0 +1,27 @@
+/** Streams one legacy NDJSON source with owned reader handles and sequential receipt identity. */
+import { createReadStream } from "node:fs";
+import { createInterface } from "node:readline";
+import { Effect, Stream } from "effect";
+import { duckdbError } from "./duckdb-error.js";
+import { importLegacyLine } from "./import-history-line.js";
+/** @param path - Existing segment file. @param sourcePath - Stable normalized relative path. @param append - Idempotent transactional append. @returns Accepted/malformed counts after all file handles close. */
+export const importLegacyLines = Effect.fn("ObservabilityDuckdb.import.lines")(function* (path, sourcePath, append) {
+    const state = {
+        sourcePath,
+        lineNumber: 0,
+        malformed: 0,
+        records: 0,
+        pending: [],
+    };
+    yield* Effect.acquireUseRelease(Effect.sync(() => {
+        const stream = createReadStream(path);
+        return { stream, input: createInterface({ input: stream, crlfDelay: Infinity }) };
+    }), ({ input }) => Stream.runForEach(Stream.fromAsyncIterable(input, (cause) => duckdbError("import-read", cause)), (line) => importLegacyLine(state, line, append)), ({ input, stream }) => Effect.sync(() => {
+        input.close();
+        stream.destroy();
+    }));
+    if (state.pending.length)
+        state.records += (yield* append(state.pending)).length;
+    return { records: state.records, malformed: state.malformed };
+});
+//# sourceMappingURL=import-history-lines.js.map

package/dist/local/import-history-lines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-history-lines.js","sourceRoot":"","sources":["../../src/local/import-history-lines.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAI5D,kNAAkN;AAClN,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,EAAE,CAAC,kCAAkC,CAAC,CAAC,QAAQ,CAAC,EACtF,IAAY,EACZ,UAAkB,EAClB,MAAoB;IAEpB,MAAM,KAAK,GAAoB;QAC7B,UAAU;QACV,UAAU,EAAE,CAAC;QACb,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,EAAE;KACZ,CAAC;IACF,KAAK,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAC7B,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACtC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACpF,CAAC,CAAC,EACF,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CACZ,MAAM,CAAC,UAAU,CACf,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC,EAC7E,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAChD,EACH,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CACpB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,MAAM,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC,CAAC,CACL,CAAC;IACF,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM;QAAE,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IACjF,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;AAChE,CAAC,CAAC,CAAC"}

package/dist/local/import-history-lines.types.d.ts

@@ -0,0 +1,11 @@
+/** Sequential line/import counters private to one legacy NDJSON source. */
+import type { LocalRecord } from "@relkit/observability/local/record";
+/** Keeps file line identity stable across malformed rows and batch boundaries. */
+export interface LegacyLineState {
+    readonly sourcePath: string;
+    lineNumber: number;
+    malformed: number;
+    records: number;
+    pending: LocalRecord[];
+}
+//# sourceMappingURL=import-history-lines.types.d.ts.map

package/dist/local/import-history-lines.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-history-lines.types.d.ts","sourceRoot":"","sources":["../../src/local/import-history-lines.types.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEtE,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB"}

package/dist/local/import-history-lines.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=import-history-lines.types.js.map

package/dist/local/import-history-lines.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-history-lines.types.js","sourceRoot":"","sources":["../../src/local/import-history-lines.types.ts"],"names":[],"mappings":""}

package/dist/local/import-history.d.ts

@@ -0,0 +1,18 @@
+import type { DuckdbConnectionPort } from "./duckdb-driver.types.js";
+import type { LocalRecord, StoredLocalRecord } from "@relkit/observability/local/record";
+/**
+ * Imports legacy NDJSON through the scoped Effect implementation.
+ *
+ * @param root - Directory containing legacy segment files.
+ * @param connection - Open DuckDB connection.
+ * @param append - Idempotent Promise batch persistence operation.
+ * @returns Imported and malformed record counts.
+ * @throws {DuckdbError} If file IO or persistence fails.
+ * @example
+ * const summary = await importLocalHistory(root, connection, append);
+ */
+export declare function importLocalHistory(root: string, connection: DuckdbConnectionPort, append: (records: readonly LocalRecord[]) => Promise<readonly StoredLocalRecord[]>): Promise<{
+    records: number;
+    malformed: number;
+}>;
+//# sourceMappingURL=import-history.d.ts.map

package/dist/local/import-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-history.d.ts","sourceRoot":"","sources":["../../src/local/import-history.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACzF;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,oBAAoB,EAChC,MAAM,EAAE,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,KAAK,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC;;;GAUnF"}

package/dist/local/import-history.js

@@ -0,0 +1,26 @@
+/**
+ * Owns import history for the optional local history store.
+ * Shared records and query contracts come from lightweight observability; native
+ * handles and worker lifetimes remain owned by this storage package.
+ */
+import { Effect } from "effect";
+import { duckdbError } from "./duckdb-error.js";
+import { importLocalHistoryEffect } from "./import-history-effect.js";
+/**
+ * Imports legacy NDJSON through the scoped Effect implementation.
+ *
+ * @param root - Directory containing legacy segment files.
+ * @param connection - Open DuckDB connection.
+ * @param append - Idempotent Promise batch persistence operation.
+ * @returns Imported and malformed record counts.
+ * @throws {DuckdbError} If file IO or persistence fails.
+ * @example
+ * const summary = await importLocalHistory(root, connection, append);
+ */
+export function importLocalHistory(root, connection, append) {
+    return Effect.runPromise(importLocalHistoryEffect(root, connection, (records) => Effect.tryPromise({
+        try: () => append(records),
+        catch: (cause) => duckdbError("import-append", cause),
+    })));
+}
+//# sourceMappingURL=import-history.js.map

package/dist/local/import-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-history.js","sourceRoot":"","sources":["../../src/local/import-history.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,UAAgC,EAChC,MAAkF;IAElF,OAAO,MAAM,CAAC,UAAU,CACtB,wBAAwB,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CACrD,MAAM,CAAC,UAAU,CAAC;QAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;QAC1B,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,eAAe,EAAE,KAAK,CAAC;KACtD,CAAC,CACH,CACF,CAAC;AACJ,CAAC"}

package/dist/local/import-history.types.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Owns import history.types for the optional local history store.
+ * Shared records and query contracts come from lightweight observability; native
+ * handles and worker lifetimes remain owned by this storage package.
+ */
+import type { Effect } from "effect";
+import type { DuckdbError } from "./duckdb-error.js";
+import type { LocalRecord, StoredLocalRecord } from "@relkit/observability/local/record";
+/**
+ * Counts persisted and malformed legacy segment records.
+ *
+ * @example
+ * const summary: LegacyImportSummary = { records: 2, malformed: 1 };
+ */
+export interface LegacyImportSummary {
+    readonly records: number;
+    readonly malformed: number;
+}
+/**
+ * Effect batch writer used during the ordered legacy import.
+ *
+ * @param records - At most 256 validated legacy envelopes.
+ * @returns An Effect with committed records or a tagged DuckdbError.
+ * @example
+ * const append: LegacyAppend = (records) => storage.append(records);
+ */
+export type LegacyAppend = (records: readonly LocalRecord[]) => Effect.Effect<readonly StoredLocalRecord[], DuckdbError>;
+//# sourceMappingURL=import-history.types.d.ts.map

package/dist/local/import-history.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-history.types.d.ts","sourceRoot":"","sources":["../../src/local/import-history.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAEzF;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,OAAO,EAAE,SAAS,WAAW,EAAE,KAC5B,MAAM,CAAC,MAAM,CAAC,SAAS,iBAAiB,EAAE,EAAE,WAAW,CAAC,CAAC"}

package/dist/local/import-history.types.js

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

package/dist/local/import-history.types.js.map

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

package/dist/local/worker-client-effect.d.ts

@@ -0,0 +1,9 @@
+import { Effect } from "effect";
+import type { LocalWorkerEffects } from "@relkit/observability/local/worker-contract";
+/**
+ * Starts one child without opening a database until the caller sends open.
+ * @param onFailure - Receives its first unexpected terminal failure.
+ * @returns Lazy worker acquisition with typed IPC failures and explicit close.
+ */
+export declare const startLocalWorkerEffect: (onFailure?: ((error: Error) => void) | undefined) => Effect.Effect<LocalWorkerEffects, import("@relkit/observability/local/worker-contract").LocalWorkerError, never>;
+//# sourceMappingURL=worker-client-effect.d.ts.map

package/dist/local/worker-client-effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-client-effect.d.ts","sourceRoot":"","sources":["../../src/local/worker-client-effect.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,KAAK,EACV,kBAAkB,EAEnB,MAAM,6CAA6C,CAAC;AAIrD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,wBACd,KAAK,KAAK,IAAI,kIAMjC,CAAC"}

package/dist/local/worker-client-effect.js

@@ -0,0 +1,54 @@
+/**
+ * Acquires the optional isolated Node worker and exposes shared structural effects.
+ * Its caller owns close; neither record producers nor console logging import it.
+ */
+import { fork } from "node:child_process";
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { Effect } from "effect";
+import { ObservabilityQueryError } from "@relkit/observability";
+import { workerFailure } from "@relkit/observability/local/worker-contract";
+import { createWorkerClientState } from "./worker-client-state.js";
+import { sendWorkerCommand, closeWorkerClient } from "./worker-client-send.js";
+/**
+ * Starts one child without opening a database until the caller sends open.
+ * @param onFailure - Receives its first unexpected terminal failure.
+ * @returns Lazy worker acquisition with typed IPC failures and explicit close.
+ */
+export const startLocalWorkerEffect = Effect.fn("observability.worker.start")(function* (onFailure = () => undefined) {
+    return yield* Effect.try({
+        try: () => createWorkerEffects(onFailure),
+        catch: (error) => workerFailure(error, "start"),
+    });
+});
+/** @param onFailure - Terminal diagnostic observer. @returns Structural IPC operations for one owned child. */
+function createWorkerEffects(onFailure) {
+    const built = new URL("./duckdb-worker.js", import.meta.url);
+    const workerPath = existsSync(built)
+        ? built
+        : new URL("../../dist/local/duckdb-worker.js", import.meta.url);
+    const child = fork(fileURLToPath(workerPath), [], {
+        execPath: "node",
+        execArgv: [],
+        stdio: ["ignore", "ignore", "pipe", "ipc"],
+    });
+    const state = createWorkerClientState(child, onFailure);
+    return {
+        pid: child.pid,
+        call: Effect.fn("observability.worker.call")((command) => {
+            if (state.failure)
+                return Effect.fail(workerFailure(state.failure, "worker"));
+            if (state.closed)
+                return Effect.fail(workerFailure(new Error("Telemetry worker is closed"), "closed"));
+            return Effect.tryPromise({
+                try: (signal) => sendWorkerCommand(state, command, signal),
+                catch: (error) => workerFailure(error, error instanceof ObservabilityQueryError ? "response" : "worker"),
+            });
+        }),
+        close: Effect.fn("observability.worker.close")(() => Effect.uninterruptible(Effect.tryPromise({
+            try: () => closeWorkerClient(state),
+            catch: (error) => workerFailure(error, "worker"),
+        }))),
+    };
+}
+//# sourceMappingURL=worker-client-effect.js.map

package/dist/local/worker-client-effect.js.map

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

package/dist/local/worker-client-send.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Sends timeout-bound commands to an owned storage child and joins its close IPC.
+ * Caller cancellation stops waiting; the shared worker retains sent commands
+ * until their reply or deadline, so one disconnected reader cannot abort writes.
+ */
+import type { Schema } from "effect";
+import type { LocalWorkerCommand } from "@relkit/observability/local/record";
+import type { WorkerClientState } from "./worker-client-state.types.js";
+/** @param state - Child authority. @param command - Existing wire command. @param signal - Call cancellation. @returns Decoded reply after the worker acknowledges. */
+export declare function sendWorkerCommand(state: WorkerClientState, command: LocalWorkerCommand, signal?: AbortSignal): Promise<Schema.Json | undefined>;
+/** @param state - Owned worker. @returns The single close acknowledgement followed by physical termination. */
+export declare function closeWorkerClient(state: WorkerClientState): Promise<void>;
+//# sourceMappingURL=worker-client-send.d.ts.map

package/dist/local/worker-client-send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-client-send.d.ts","sourceRoot":"","sources":["../../src/local/worker-client-send.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,gCAAgC,CAAC;AAG3F,uKAAuK;AACvK,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,kBAAkB,EAC3B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,SAAS,CAAC,CAyClC;AAgBD,+GAA+G;AAC/G,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzE"}

package/dist/local/worker-client-send.js

@@ -0,0 +1,82 @@
+import { WorkerTransportError } from "@relkit/observability/local/worker-contract";
+import { failWorkerClient, stopWorkerClient } from "./worker-client-state.js";
+/** @param state - Child authority. @param command - Existing wire command. @param signal - Call cancellation. @returns Decoded reply after the worker acknowledges. */
+export function sendWorkerCommand(state, command, signal) {
+    if (state.failure || state.closed)
+        return Promise.reject(state.failure ?? new Error("Telemetry worker is closed"));
+    return new Promise((resolve, reject) => {
+        const id = ++state.nextId;
+        const abort = () => reject(new DOMException("Telemetry request interrupted", "AbortError"));
+        if (signal?.aborted) {
+            abort();
+            return;
+        }
+        signal?.addEventListener("abort", abort, { once: true });
+        if (signal?.aborted) {
+            abort();
+            signal.removeEventListener("abort", abort);
+            return;
+        }
+        // Sent work still owns its deadline and receipt, even after its caller leaves.
+        const timer = setTimeout(() => failWorkerClient(state, new WorkerTransportError("timeout", "Telemetry worker timed out; restart dev to recover")), command.type === "open" ? 120_000 : 15_000);
+        const cleanup = () => signal?.removeEventListener("abort", abort);
+        const pending = {
+            timer,
+            resolve: (value) => {
+                cleanup();
+                if (command.type === "open")
+                    state.opened = true;
+                resolve(value);
+            },
+            reject: (error) => {
+                cleanup();
+                reject(error);
+            },
+        };
+        state.pending.set(id, pending);
+        sendEnvelope(state, id, command);
+    });
+}
+/** @param state - Child authority. @param id - Pending identity. @param command - Wire command. @returns Nothing; send failure settles the pending owner. */
+function sendEnvelope(state, id, command) {
+    try {
+        state.child.send({ id, command }, (error) => {
+            if (error)
+                failWorkerClient(state, new WorkerTransportError("send", error.message));
+        });
+    }
+    catch (cause) {
+        failWorkerClient(state, new WorkerTransportError("send", cause instanceof Error ? cause.message : String(cause)));
+    }
+}
+/** @param state - Owned worker. @returns The single close acknowledgement followed by physical termination. */
+export function closeWorkerClient(state) {
+    state.closePromise ??= closeOnce(state);
+    return state.closePromise;
+}
+/** @param state - Owned worker. @returns Completion after the worker close command or failure. */
+async function closeOnce(state) {
+    state.closing = true;
+    const deadline = setTimeout(() => {
+        try {
+            failWorkerClient(state, new WorkerTransportError("timeout", "Diagnostic history flush exceeded its five-second shutdown budget; history may be incomplete."));
+        }
+        finally {
+            state.child.kill("SIGKILL");
+        }
+    }, 4000);
+    try {
+        if (!state.closed && !state.failure && state.opened)
+            await sendWorkerCommand(state, { type: "close" });
+    }
+    finally {
+        stopWorkerClient(state);
+        try {
+            await state.exited;
+        }
+        finally {
+            clearTimeout(deadline);
+        }
+    }
+}
+//# sourceMappingURL=worker-client-send.js.map

package/dist/local/worker-client-send.js.map

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