@relkit/observability-local 0.0.0-stage → 0.1.1

package/dist/local/duckdb-storage.js

@@ -0,0 +1,33 @@
+/** Composes serialized append, retention configuration and checkpoint operations for one native history owner. */
+import { Effect } from "effect";
+import { appendDuckdbRecords } from "./duckdb-transaction.js";
+import { retainDuckdbRecords } from "./duckdb-retention.js";
+import { runDuckdbSql } from "./duckdb-sql.js";
+import { observeDuckdb } from "./duckdb-metrics.js";
+/** @param connection - Scoped native connection. @param permit - Shared database serialization. @param configured - Retention policy. @param initialRedaction - Admission policy. @returns Native store capabilities. */
+export function makeDuckdbStorage(connection, permit, configured, initialRedaction) {
+    const state = {
+        connection,
+        permit,
+        retention: configured,
+        redaction: initialRedaction,
+    };
+    return {
+        append: (records) => appendDuckdbRecords(state, records),
+        configure: Effect.fn("ObservabilityDuckdb.configure")(function* (value, nextRedaction) {
+            yield* observeDuckdb("configure", permit.withPermit(Effect.gen(function* () {
+                state.retention = value;
+                state.redaction = nextRedaction;
+                yield* retainDuckdbRecords(state);
+                yield* runDuckdbSql(connection, "checkpoint", "CHECKPOINT");
+            })));
+        }),
+        flush: Effect.fn("ObservabilityDuckdb.flush")(function* () {
+            yield* observeDuckdb("flush", permit.withPermit(Effect.gen(function* () {
+                yield* retainDuckdbRecords(state);
+                yield* runDuckdbSql(connection, "checkpoint", "CHECKPOINT");
+            })));
+        }),
+    };
+}
+//# sourceMappingURL=duckdb-storage.js.map

package/dist/local/duckdb-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-storage.js","sourceRoot":"","sources":["../../src/local/duckdb-storage.ts"],"names":[],"mappings":"AAAA,kHAAkH;AAClH,OAAO,EAAE,MAAM,EAAkB,MAAM,QAAQ,CAAC;AAKhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,yNAAyN;AACzN,MAAM,UAAU,iBAAiB,CAC/B,UAAgC,EAChC,MAA2B,EAC3B,UAAyC,EACzC,gBAAkC;IAElC,MAAM,KAAK,GAAuB;QAChC,UAAU;QACV,MAAM;QACN,SAAS,EAAE,UAAU;QACrB,SAAS,EAAE,gBAAgB;KAC5B,CAAC;IACF,OAAO;QACL,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC;QACxD,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,+BAA+B,CAAC,CAAC,QAAQ,CAAC,EAC7D,KAAoC,EACpC,aAA+B;YAE/B,KAAK,CAAC,CAAC,aAAa,CAClB,WAAW,EACX,MAAM,CAAC,UAAU,CACf,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAClB,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC;gBACxB,KAAK,CAAC,SAAS,GAAG,aAAa,CAAC;gBAChC,KAAK,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;gBAClC,KAAK,CAAC,CAAC,YAAY,CAAC,UAAU,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;YAC9D,CAAC,CAAC,CACH,CACF,CAAC;QACJ,CAAC,CAAC;QACF,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,2BAA2B,CAAC,CAAC,QAAQ,CAAC;YACrD,KAAK,CAAC,CAAC,aAAa,CAClB,OAAO,EACP,MAAM,CAAC,UAAU,CACf,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAClB,KAAK,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;gBAClC,KAAK,CAAC,CAAC,YAAY,CAAC,UAAU,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;YAC9D,CAAC,CAAC,CACH,CACF,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * Owns duckdb storage.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 { RedactionPolicy } from "@relkit/observability";
+import type { TelemetryLocalRetentionPolicy } from "@relkit/observability";
+import type { LocalRecord, StoredLocalRecord } from "@relkit/observability/local/record";
+import type { DuckdbError } from "./duckdb-error.js";
+/**
+ * Effect operations that persist and retain local telemetry.
+ * All methods serialize access to one native connection.
+ *
+ * @example
+ * const stored = yield* storage.append(records);
+ */
+export interface DuckdbStorageEffects {
+    /**
+     * Appends at most 256 idempotent records in one transaction.
+     * @param records - Valid local telemetry envelopes.
+     * @returns An Effect with committed records or a tagged DuckdbError.
+     * @example
+     * const stored = yield* storage.append(records);
+     */
+    readonly append: (records: readonly LocalRecord[]) => Effect.Effect<StoredLocalRecord[], DuckdbError>;
+    /**
+     * Reconfigures retention and redaction, then checkpoints.
+     * @param retention - New retention limits.
+     * @param redaction - New admission policy.
+     * @returns An Effect completing after checkpoint or a DuckdbError.
+     * @example
+     * yield* storage.configure({ maxEntries: 100 });
+     */
+    readonly configure: (retention: TelemetryLocalRetentionPolicy, redaction?: RedactionPolicy) => Effect.Effect<void, DuckdbError>;
+    /**
+     * Applies retention and checkpoints.
+     * @returns An Effect completing after the flush or a DuckdbError.
+     * @example
+     * yield* storage.flush();
+     */
+    readonly flush: () => Effect.Effect<void, DuckdbError>;
+}
+//# sourceMappingURL=duckdb-storage.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-storage.types.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-storage.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACzF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,CACf,OAAO,EAAE,SAAS,WAAW,EAAE,KAC5B,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,EAAE,WAAW,CAAC,CAAC;IACrD;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,CAClB,SAAS,EAAE,6BAA6B,EACxC,SAAS,CAAC,EAAE,eAAe,KACxB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;CACxD"}

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

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

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

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

package/dist/local/duckdb-transaction.d.ts

@@ -0,0 +1,7 @@
+/** Commits one validated idempotent batch and retention atomically; failures retain rollback behavior. */
+import { Effect } from "effect";
+import type { LocalRecord, StoredLocalRecord } from "@relkit/observability/local/record";
+import type { DuckdbStorageState } from "./duckdb-storage-state.types.js";
+/** @param state - Serialized store owner. @param records - At most 256 envelopes. @returns Committed stored records or typed native failure. */
+export declare const appendDuckdbRecords: (state: DuckdbStorageState, records: readonly LocalRecord[]) => Effect.Effect<StoredLocalRecord[], import("./duckdb-error.js").DuckdbError, never>;
+//# sourceMappingURL=duckdb-transaction.d.ts.map

package/dist/local/duckdb-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-transaction.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-transaction.ts"],"names":[],"mappings":"AAAA,0GAA0G;AAC1G,OAAO,EAAS,MAAM,EAAQ,MAAM,QAAQ,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAMzF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,gJAAgJ;AAChJ,eAAO,MAAM,mBAAmB,oJA4C9B,CAAC"}

package/dist/local/duckdb-transaction.js

@@ -0,0 +1,25 @@
+/** Commits one validated idempotent batch and retention atomically; failures retain rollback behavior. */
+import { Clock, Effect, Exit } from "effect";
+import { appendDuckdbBatchEffect } from "./duckdb-batch.js";
+import { retainDuckdbRecords } from "./duckdb-retention.js";
+import { runDuckdbSql } from "./duckdb-sql.js";
+import { duckdbError } from "./duckdb-error.js";
+import { observeDuckdb } from "./duckdb-metrics.js";
+/** @param state - Serialized store owner. @param records - At most 256 envelopes. @returns Committed stored records or typed native failure. */
+export const appendDuckdbRecords = Effect.fn("ObservabilityDuckdb.append")(function* (state, records) {
+    return yield* observeDuckdb("append", state.permit.withPermit(Effect.gen(function* () {
+        if (records.length > 256)
+            return yield* Effect.fail(duckdbError("append", new RangeError("Telemetry batches contain at most 256 records")));
+        let committed = [];
+        const receivedAt = yield* Clock.currentTimeMillis;
+        yield* Effect.acquireUseRelease(runDuckdbSql(state.connection, "begin", "BEGIN TRANSACTION"), () => Effect.gen(function* () {
+            committed = yield* appendDuckdbBatchEffect(state.connection, records, receivedAt, state.redaction);
+            yield* retainDuckdbRecords(state);
+            return committed;
+        }), (_begin, exit) => Exit.isSuccess(exit)
+            ? runDuckdbSql(state.connection, "commit", "COMMIT").pipe(Effect.catchTag("DuckdbError", (failure) => runDuckdbSql(state.connection, "rollback", "ROLLBACK").pipe(Effect.ignore, Effect.flatMap(() => Effect.fail(failure)))), Effect.asVoid)
+            : runDuckdbSql(state.connection, "rollback", "ROLLBACK").pipe(Effect.ignore));
+        return committed;
+    })));
+});
+//# sourceMappingURL=duckdb-transaction.js.map

package/dist/local/duckdb-transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-transaction.js","sourceRoot":"","sources":["../../src/local/duckdb-transaction.ts"],"names":[],"mappings":"AAAA,0GAA0G;AAC1G,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,gJAAgJ;AAChJ,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,EAAE,CAAC,4BAA4B,CAAC,CAAC,QAAQ,CAAC,EAClF,KAAyB,EACzB,OAA+B;IAE/B,OAAO,KAAK,CAAC,CAAC,aAAa,CACzB,QAAQ,EACR,KAAK,CAAC,MAAM,CAAC,UAAU,CACrB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG;YACtB,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,WAAW,CAAC,QAAQ,EAAE,IAAI,UAAU,CAAC,+CAA+C,CAAC,CAAC,CACvF,CAAC;QACJ,IAAI,SAAS,GAAwB,EAAE,CAAC;QACxC,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;QAClD,KAAK,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAC7B,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,mBAAmB,CAAC,EAC5D,GAAG,EAAE,CACH,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,SAAS,GAAG,KAAK,CAAC,CAAC,uBAAuB,CACxC,KAAK,CAAC,UAAU,EAChB,OAAO,EACP,UAAU,EACV,KAAK,CAAC,SAAS,CAChB,CAAC;YACF,KAAK,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAClC,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC,EACJ,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CACf,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAClB,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,IAAI,CACrD,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE,CACzC,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,IAAI,CACzD,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAC3C,CACF,EACD,MAAM,CAAC,MAAM,CACd;YACH,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CACjF,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CACH,CACF,CAAC;AACJ,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * Transfers a database's native handles to the worker's explicit owning scope.
+ * Acquisition failure closes partial handles; retirement flushes before release.
+ */
+import { Effect } from "effect";
+import type { LocalWorkerCommand } from "@relkit/observability/local/record";
+import type { DuckdbWorkerState } from "./duckdb-worker-state.types.js";
+/** @param state - Worker-owned database authority. @returns Completion after flush and native scope release. */
+export declare const closeDuckdbWorkerDatabase: (state: DuckdbWorkerState) => Effect.Effect<void, import("./duckdb-error.js").DuckdbError, never>;
+/** @param state - Worker-owned database authority. @param command - Open request with the unchanged history root. @returns Existing-history import summary after scoped acquisition. */
+export declare const openDuckdbWorkerDatabase: (state: DuckdbWorkerState, command: {
+    readonly type: "open";
+    readonly root: string;
+    readonly retention?: import("@relkit/observability").TelemetryLocalRetentionPolicy;
+    readonly redaction?: import("@relkit/observability").RedactionPolicy;
+}) => Effect.Effect<{
+    records: number;
+    malformed: number;
+}, import("./duckdb-error.js").DuckdbError, never>;
+/** @param state - Worker-owned authority. @param command - Serialized wire operation. @returns Database operation result or typed state failure. */
+export declare const executeDuckdbWorkerCommand: (state: DuckdbWorkerState, command: LocalWorkerCommand) => Effect.Effect<void | import("@relkit/observability/local/record").StoredLocalRecord[] | import("@relkit/observability").ObservabilityQueryPage<import("@relkit/observability/local/record").StoredLocalRecord> | {
+    records: number;
+    malformed: number;
+}, import("./duckdb-error.js").DuckdbError | import("./duckdb-query-error.js").DuckdbQueryError, never>;
+//# sourceMappingURL=duckdb-worker-database.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-worker-database.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-worker-database.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAe,MAAM,QAAQ,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAI7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAExE,gHAAgH;AAChH,eAAO,MAAM,yBAAyB,mGASrC,CAAC;AAEF,wLAAwL;AACxL,eAAO,MAAM,wBAAwB;;;;;;;;kDA2BpC,CAAC;AAEF,oJAAoJ;AACpJ,eAAO,MAAM,0BAA0B;;;uGAuBtC,CAAC"}

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

@@ -0,0 +1,53 @@
+/**
+ * Transfers a database's native handles to the worker's explicit owning scope.
+ * Acquisition failure closes partial handles; retirement flushes before release.
+ */
+import { Effect, Exit, Scope } from "effect";
+import { openDuckdbDatabaseEffect } from "./duckdb-database-effect.js";
+import { DuckdbDriverService } from "./duckdb-driver.js";
+import { duckdbError } from "./duckdb-error.js";
+/** @param state - Worker-owned database authority. @returns Completion after flush and native scope release. */
+export const closeDuckdbWorkerDatabase = Effect.fn("ObservabilityDuckdb.worker.closeDatabase")(function* (state) {
+    const current = state.database;
+    const scope = state.databaseScope;
+    state.database = undefined;
+    state.databaseScope = undefined;
+    if (current === undefined || scope === undefined)
+        return;
+    yield* current.flush().pipe(Effect.ensuring(Scope.close(scope, Exit.void)));
+});
+/** @param state - Worker-owned database authority. @param command - Open request with the unchanged history root. @returns Existing-history import summary after scoped acquisition. */
+export const openDuckdbWorkerDatabase = Effect.fn("ObservabilityDuckdb.worker.openDatabase")(function* (state, command) {
+    if (state.database !== undefined)
+        return yield* Effect.fail(duckdbError("open", new Error("Telemetry database is already open")));
+    return yield* Effect.uninterruptible(Effect.gen(function* () {
+        const scope = yield* Scope.make();
+        const acquired = yield* openDuckdbDatabaseEffect(command.root, command.retention, command.redaction).pipe(Scope.provide(scope), Effect.provideService(DuckdbDriverService, state.driver), Effect.onExit((exit) => (Exit.isSuccess(exit) ? Effect.void : Scope.close(scope, exit))));
+        state.database = acquired;
+        state.databaseScope = scope;
+        return acquired.imported;
+    }));
+});
+/** @param state - Worker-owned authority. @param command - Serialized wire operation. @returns Database operation result or typed state failure. */
+export const executeDuckdbWorkerCommand = Effect.fn("ObservabilityDuckdb.worker.command")(function* (state, command) {
+    if (command.type === "open")
+        return yield* openDuckdbWorkerDatabase(state, command);
+    const database = state.database;
+    if (database === undefined)
+        return yield* Effect.fail(duckdbError("command", new Error("Telemetry database is not open")));
+    switch (command.type) {
+        case "append":
+            return yield* database.append(command.records);
+        case "query":
+            return yield* database.list(command.kind, command.query);
+        case "detail":
+            return yield* database.detail(command.kind, command.id);
+        case "retention":
+            return yield* database.configure(command.retention, command.redaction);
+        case "flush":
+            return yield* database.flush();
+        case "close":
+            return yield* closeDuckdbWorkerDatabase(state);
+    }
+});
+//# sourceMappingURL=duckdb-worker-database.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * Composes serialized storage commands behind an injectable worker service.
+ * Its scope owns the explicit database scope until close, failure or interruption.
+ */
+import { Context, Effect, Layer } from "effect";
+import { DuckdbDriverService } from "./duckdb-driver.js";
+import type { DuckdbWorkerEffects } from "./duckdb-worker.types.js";
+import type { LocalWorkerCommand } from "@relkit/observability/local/record";
+declare const DuckdbWorkerService_base: Context.ServiceClass<DuckdbWorkerService, "@relkit/observability/DuckdbWorker", DuckdbWorkerEffects> & {
+    readonly make: () => Effect.Effect<DuckdbWorkerEffects, never, DuckdbDriverService>;
+};
+/** Injectable command executor whose owner must close its database. */
+export declare class DuckdbWorkerService extends DuckdbWorkerService_base {
+}
+/** @returns Lazy command service requiring the explicit native driver. */
+export declare const makeDuckdbWorkerEffect: () => Effect.Effect<{
+    execute: (command: LocalWorkerCommand) => Effect.Effect<void | import("@relkit/observability/local/record").StoredLocalRecord[] | import("@relkit/observability").ObservabilityQueryPage<import("@relkit/observability/local/record").StoredLocalRecord> | {
+        records: number;
+        malformed: number;
+    }, import("./duckdb-error.js").DuckdbError | import("./duckdb-query-error.js").DuckdbQueryError, never>;
+    close: () => Effect.Effect<void, import("./duckdb-error.js").DuckdbError, never>;
+}, never, DuckdbDriverService>;
+/** Owns the command service and releases native state on every scope exit. */
+export declare const duckdbWorkerLayer: Layer.Layer<DuckdbWorkerService, never, DuckdbDriverService>;
+export {};
+//# sourceMappingURL=duckdb-worker-effect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-worker-effect.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-worker-effect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAa,MAAM,QAAQ,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;;;;AAE7E,uEAAuE;AACvE,qBAAa,mBAAoB,SAAQ,wBAG0C;CAAG;AAEtF,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB;;;;;;8BAoBjC,CAAC;AAEH,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,8DAG7B,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * Composes serialized storage commands behind an injectable worker service.
+ * Its scope owns the explicit database scope until close, failure or interruption.
+ */
+import { Context, Effect, Layer, Semaphore } from "effect";
+import { DuckdbDriverService } from "./duckdb-driver.js";
+import { observeDuckdb } from "./duckdb-metrics.js";
+import { closeDuckdbWorkerDatabase, executeDuckdbWorkerCommand } from "./duckdb-worker-database.js";
+/** Injectable command executor whose owner must close its database. */
+export class DuckdbWorkerService extends Context.Service()("@relkit/observability/DuckdbWorker", { make: () => makeDuckdbWorkerEffect() }) {
+}
+/** @returns Lazy command service requiring the explicit native driver. */
+export const makeDuckdbWorkerEffect = Effect.fn("ObservabilityDuckdb.worker.create")(function* () {
+    const driver = yield* DuckdbDriverService;
+    const permit = yield* Semaphore.make(1);
+    const state = {
+        driver,
+        permit,
+        database: undefined,
+        databaseScope: undefined,
+    };
+    return {
+        execute: Effect.fn("ObservabilityDuckdb.worker.execute")((command) => observeDuckdb("worker-command", permit.withPermit(executeDuckdbWorkerCommand(state, command)))),
+        close: Effect.fn("ObservabilityDuckdb.worker.close")(() => permit.withPermit(closeDuckdbWorkerDatabase(state))),
+    };
+});
+/** Owns the command service and releases native state on every scope exit. */
+export const duckdbWorkerLayer = Layer.effect(DuckdbWorkerService, Effect.acquireRelease(DuckdbWorkerService.make(), (worker) => Effect.ignore(worker.close())));
+//# sourceMappingURL=duckdb-worker-effect.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-worker-effect.js","sourceRoot":"","sources":["../../src/local/duckdb-worker-effect.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAKpG,uEAAuE;AACvE,MAAM,OAAO,mBAAoB,SAAQ,OAAO,CAAC,OAAO,EAGrD,CAAC,oCAAoC,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,sBAAsB,EAAE,EAAE,CAAC;CAAG;AAEtF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,EAAE,CAAC,mCAAmC,CAAC,CAAC,QAAQ,CAAC;IAC5F,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,mBAAmB,CAAC;IAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxC,MAAM,KAAK,GAAsB;QAC/B,MAAM;QACN,MAAM;QACN,QAAQ,EAAE,SAAS;QACnB,aAAa,EAAE,SAAS;KACzB,CAAC;IACF,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,oCAAoC,CAAC,CAAC,CAAC,OAA2B,EAAE,EAAE,CACvF,aAAa,CACX,gBAAgB,EAChB,MAAM,CAAC,UAAU,CAAC,0BAA0B,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAC9D,CACF;QACD,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,kCAAkC,CAAC,CAAC,GAAG,EAAE,CACxD,MAAM,CAAC,UAAU,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,CACpD;KAC4B,CAAC;AAClC,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC,MAAM,CAC3C,mBAAmB,EACnB,MAAM,CAAC,cAAc,CAAC,mBAAmB,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAC7F,CAAC"}

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

@@ -0,0 +1,7 @@
+/** Registers the existing worker command/reply channel within the process owner's Effect scope. */
+import { Effect } from "effect";
+import type { DuckdbWorkerEffects } from "./duckdb-worker.types.js";
+import type { DuckdbProcessState } from "./duckdb-worker-process.types.js";
+/** @param worker - Serialized database executor. @param state - Process maintenance state. @returns Scoped IPC listener registration. */
+export declare const installDuckdbWorkerIpc: (worker: DuckdbWorkerEffects, state: DuckdbProcessState) => Effect.Effect<void, never, import("effect/Scope").Scope>;
+//# sourceMappingURL=duckdb-worker-ipc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-worker-ipc.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-worker-ipc.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAuB,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAChG,yIAAyI;AACzI,eAAO,MAAM,sBAAsB,sHAwCjC,CAAC"}

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

@@ -0,0 +1,40 @@
+/** Registers the existing worker command/reply channel within the process owner's Effect scope. */
+import { Effect } from "effect";
+import { DuckdbQueryError } from "./duckdb-query-error.js";
+/** @param worker - Serialized database executor. @param state - Process maintenance state. @returns Scoped IPC listener registration. */
+export const installDuckdbWorkerIpc = Effect.fn("ObservabilityDuckdb.worker.ipc")(function* (worker, state) {
+    const message = (envelope) => {
+        void Effect.runPromise(worker.execute(envelope.command))
+            .then((value) => {
+            if (envelope.command.type === "open")
+                state.opened = true;
+            if (envelope.command.type === "close")
+                state.opened = false;
+            process.send?.({ id: envelope.id, value });
+            if (envelope.command.type === "close")
+                process.disconnect?.();
+        }, (error) => {
+            process.send?.({
+                id: envelope.id,
+                error: error instanceof Error ? error.message : String(error),
+                ...(error instanceof DuckdbQueryError ? { code: error.code } : {}),
+            });
+        })
+            .catch(() => {
+            process.exitCode = 1;
+            try {
+                process.disconnect?.();
+            }
+            catch {
+                /* The IPC channel may already be gone. */
+            }
+        });
+    };
+    yield* Effect.acquireRelease(Effect.sync(() => {
+        process.on("message", message);
+        return message;
+    }), (owned) => Effect.sync(() => {
+        process.off("message", owned);
+    }));
+});
+//# sourceMappingURL=duckdb-worker-ipc.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-worker-ipc.js","sourceRoot":"","sources":["../../src/local/duckdb-worker-ipc.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,yIAAyI;AACzI,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,EAAE,CAAC,gCAAgC,CAAC,CAAC,QAAQ,CAAC,EACzF,MAA2B,EAC3B,KAAyB;IAEzB,MAAM,OAAO,GAAG,CAAC,QAA6B,EAAQ,EAAE;QACtD,KAAK,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;aACrD,IAAI,CACH,CAAC,KAAK,EAAE,EAAE;YACR,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM;gBAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;YAC1D,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO;gBAAE,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;YAC5D,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3C,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO;gBAAE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;QAChE,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;YACR,OAAO,CAAC,IAAI,EAAE,CAAC;gBACb,EAAE,EAAE,QAAQ,CAAC,EAAE;gBACf,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC7D,GAAG,CAAC,KAAK,YAAY,gBAAgB,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC,CAAC;QACL,CAAC,CACF;aACA,KAAK,CAAC,GAAG,EAAE;YACV,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,IAAI,CAAC;gBACH,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;YACzB,CAAC;YAAC,MAAM,CAAC;gBACP,0CAA0C;YAC5C,CAAC;QACH,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;IACF,KAAK,CAAC,CAAC,MAAM,CAAC,cAAc,CAC1B,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC,EACF,CAAC,KAAK,EAAE,EAAE,CACR,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC,CACL,CAAC;AACJ,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,7 @@
+/** Runs the existing minute retention checkpoint only while the process owns an open database. */
+import { Effect } from "effect";
+import type { DuckdbWorkerEffects } from "./duckdb-worker.types.js";
+import type { DuckdbProcessState } from "./duckdb-worker-process.types.js";
+/** @param worker - Serialized database authority. @param state - Open/close state shared with IPC. @returns Scoped maintenance timer ownership. */
+export declare const installDuckdbWorkerMaintenance: (worker: DuckdbWorkerEffects, state: DuckdbProcessState) => Effect.Effect<void, never, import("effect/Scope").Scope>;
+//# sourceMappingURL=duckdb-worker-maintenance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-worker-maintenance.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-worker-maintenance.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,mJAAmJ;AACnJ,eAAO,MAAM,8BAA8B,sHAyB1C,CAAC"}

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

@@ -0,0 +1,25 @@
+/** Runs the existing minute retention checkpoint only while the process owns an open database. */
+import { Effect } from "effect";
+/** @param worker - Serialized database authority. @param state - Open/close state shared with IPC. @returns Scoped maintenance timer ownership. */
+export const installDuckdbWorkerMaintenance = Effect.fn("ObservabilityDuckdb.worker.maintenance")(function* (worker, state) {
+    yield* Effect.acquireRelease(Effect.sync(() => {
+        const timer = setInterval(() => {
+            if (!state.opened)
+                return;
+            void Effect.runPromise(worker.execute({ type: "flush" })).catch((error) => {
+                process.send?.({
+                    id: 0,
+                    fatal: true,
+                    error: `Telemetry cleanup failed: ${String(error)}`,
+                });
+                process.exitCode = 1;
+                process.disconnect?.();
+            });
+        }, 60_000);
+        timer.unref();
+        return timer;
+    }), (timer) => Effect.sync(() => {
+        clearInterval(timer);
+    }));
+});
+//# sourceMappingURL=duckdb-worker-maintenance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-worker-maintenance.js","sourceRoot":"","sources":["../../src/local/duckdb-worker-maintenance.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,mJAAmJ;AACnJ,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC,EAAE,CAAC,wCAAwC,CAAC,CAC/F,QAAQ,CAAC,EAAE,MAA2B,EAAE,KAAyB;IAC/D,KAAK,CAAC,CAAC,MAAM,CAAC,cAAc,CAC1B,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC7B,IAAI,CAAC,KAAK,CAAC,MAAM;gBAAE,OAAO;YAC1B,KAAK,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACxE,OAAO,CAAC,IAAI,EAAE,CAAC;oBACb,EAAE,EAAE,CAAC;oBACL,KAAK,EAAE,IAAI;oBACX,KAAK,EAAE,6BAA6B,MAAM,CAAC,KAAK,CAAC,EAAE;iBACpD,CAAC,CAAC;gBACH,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACrB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;YACzB,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,MAAM,CAAC,CAAC;QACX,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,EACF,CAAC,KAAK,EAAE,EAAE,CACR,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,aAAa,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC,CAAC,CACL,CAAC;AACJ,CAAC,CACF,CAAC"}

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

@@ -0,0 +1,5 @@
+/** Owns native database commands, IPC, signals and maintenance until the physical worker process disconnects. */
+import { Effect, type Scope } from "effect";
+/** @param scope - Physical process owner. @returns Completion after all scoped resources are registered. */
+export declare const startDuckdbWorkerProcessEffect: (scope: Scope.Closeable) => Effect.Effect<void, never, Scope.Scope>;
+//# sourceMappingURL=duckdb-worker-process.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-worker-process.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-worker-process.ts"],"names":[],"mappings":"AAAA,iHAAiH;AACjH,OAAO,EAAE,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,QAAQ,CAAC;AAO5C,4GAA4G;AAC5G,eAAO,MAAM,8BAA8B,qEAgB1C,CAAC"}

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

@@ -0,0 +1,19 @@
+/** Owns native database commands, IPC, signals and maintenance until the physical worker process disconnects. */
+import { Effect } from "effect";
+import { makeDuckdbWorkerEffect } from "./duckdb-worker-effect.js";
+import { duckdbDriverLayer } from "./duckdb-driver.js";
+import { observeDuckdb } from "./duckdb-metrics.js";
+import { installDuckdbWorkerIpc } from "./duckdb-worker-ipc.js";
+import { installDuckdbWorkerSignals } from "./duckdb-worker-signals.js";
+import { installDuckdbWorkerMaintenance } from "./duckdb-worker-maintenance.js";
+/** @param scope - Physical process owner. @returns Completion after all scoped resources are registered. */
+export const startDuckdbWorkerProcessEffect = Effect.fn("ObservabilityDuckdb.worker.process")(function* (scope) {
+    return yield* observeDuckdb("worker-process", Effect.gen(function* () {
+        const worker = yield* Effect.acquireRelease(makeDuckdbWorkerEffect().pipe(Effect.provide(duckdbDriverLayer)), (owned) => Effect.ignore(owned.close()));
+        const state = { opened: false };
+        yield* installDuckdbWorkerIpc(worker, state);
+        yield* installDuckdbWorkerSignals(scope);
+        yield* installDuckdbWorkerMaintenance(worker, state);
+    }));
+});
+//# sourceMappingURL=duckdb-worker-process.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-worker-process.js","sourceRoot":"","sources":["../../src/local/duckdb-worker-process.ts"],"names":[],"mappings":"AAAA,iHAAiH;AACjH,OAAO,EAAE,MAAM,EAAc,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAChF,4GAA4G;AAC5G,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC,EAAE,CAAC,oCAAoC,CAAC,CAC3F,QAAQ,CAAC,EAAE,KAAsB;IAC/B,OAAO,KAAK,CAAC,CAAC,aAAa,CACzB,gBAAgB,EAChB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,cAAc,CACzC,sBAAsB,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,EAChE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CACxC,CAAC;QACF,MAAM,KAAK,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAChC,KAAK,CAAC,CAAC,sBAAsB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC7C,KAAK,CAAC,CAAC,0BAA0B,CAAC,KAAK,CAAC,CAAC;QACzC,KAAK,CAAC,CAAC,8BAA8B,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC,CAAC,CACH,CAAC;AACJ,CAAC,CACF,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * Owns duckdb worker process.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 { LocalWorkerCommand } from "@relkit/observability/local/record";
+/**
+ * IPC envelope received by the local DuckDB worker process.
+ *
+ * @example
+ * const message: DuckdbWorkerMessage = { id: 1, command: { type: "flush" } };
+ */
+export interface DuckdbWorkerMessage {
+    readonly id: number;
+    readonly command: LocalWorkerCommand;
+}
+/** Tracks whether maintenance may issue database commands in this process. */
+export interface DuckdbProcessState {
+    opened: boolean;
+}
+//# sourceMappingURL=duckdb-worker-process.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-worker-process.types.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-worker-process.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;CACtC;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAC;CACjB"}

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

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

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

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

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

@@ -0,0 +1,5 @@
+/** Holds signal/disconnect listeners until the worker process scope finishes database finalization. */
+import { Effect, Scope } from "effect";
+/** @param scope - Physical process owner. @returns Scoped signal/disconnect registrations. */
+export declare const installDuckdbWorkerSignals: (scope: Scope.Closeable) => Effect.Effect<void, never, Scope.Scope>;
+//# sourceMappingURL=duckdb-worker-signals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-worker-signals.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-worker-signals.ts"],"names":[],"mappings":"AAAA,uGAAuG;AACvG,OAAO,EAAE,MAAM,EAAQ,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC7C,8FAA8F;AAC9F,eAAO,MAAM,0BAA0B,qEA8BtC,CAAC"}

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

@@ -0,0 +1,22 @@
+/** Holds signal/disconnect listeners until the worker process scope finishes database finalization. */
+import { Effect, Exit, Scope } from "effect";
+/** @param scope - Physical process owner. @returns Scoped signal/disconnect registrations. */
+export const installDuckdbWorkerSignals = Effect.fn("ObservabilityDuckdb.worker.signals")(function* (scope) {
+    const sigint = () => undefined;
+    yield* Effect.acquireRelease(Effect.sync(() => {
+        process.on("SIGINT", sigint);
+        return sigint;
+    }), (owned) => Effect.sync(() => {
+        process.off("SIGINT", owned);
+    }));
+    const disconnect = () => {
+        void Effect.runPromise(Scope.close(scope, Exit.void)).then(() => process.exit(), () => process.exit(1));
+    };
+    yield* Effect.acquireRelease(Effect.sync(() => {
+        process.on("disconnect", disconnect);
+        return disconnect;
+    }), (owned) => Effect.sync(() => {
+        process.off("disconnect", owned);
+    }));
+});
+//# sourceMappingURL=duckdb-worker-signals.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-worker-signals.js","sourceRoot":"","sources":["../../src/local/duckdb-worker-signals.ts"],"names":[],"mappings":"AAAA,uGAAuG;AACvG,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC7C,8FAA8F;AAC9F,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC,EAAE,CAAC,oCAAoC,CAAC,CACvF,QAAQ,CAAC,EAAE,KAAsB;IAC/B,MAAM,MAAM,GAAG,GAAS,EAAE,CAAC,SAAS,CAAC;IACrC,KAAK,CAAC,CAAC,MAAM,CAAC,cAAc,CAC1B,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,EACF,CAAC,KAAK,EAAE,EAAE,CACR,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC,CAAC,CACL,CAAC;IACF,MAAM,UAAU,GAAG,GAAS,EAAE;QAC5B,KAAK,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CACxD,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EACpB,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CACtB,CAAC;IACJ,CAAC,CAAC;IACF,KAAK,CAAC,CAAC,MAAM,CAAC,cAAc,CAC1B,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QACrC,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC,EACF,CAAC,KAAK,EAAE,EAAE,CACR,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC,CAAC,CACL,CAAC;AACJ,CAAC,CACF,CAAC"}

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

@@ -0,0 +1,12 @@
+/** Physical database scope and serialization state owned by one storage worker. */
+import type { Scope, Semaphore } from "effect";
+import type { DuckdbDriver } from "./duckdb-driver.types.js";
+import type { DuckdbDatabaseEffects } from "./duckdb-database.types.js";
+/** Open transfers its database scope here; close clears authority before release. */
+export interface DuckdbWorkerState {
+    readonly driver: DuckdbDriver;
+    readonly permit: Semaphore.Semaphore;
+    database: DuckdbDatabaseEffects | undefined;
+    databaseScope: Scope.Closeable | undefined;
+}
+//# sourceMappingURL=duckdb-worker-state.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-worker-state.types.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-worker-state.types.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,qFAAqF;AACrF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC;IACrC,QAAQ,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAC5C,aAAa,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;CAC5C"}

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

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

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

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

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

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

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

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

package/dist/local/duckdb-worker.js

@@ -0,0 +1,18 @@
+/**
+ * Owns duckdb worker 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, Exit, Scope } from "effect";
+import { startDuckdbWorkerProcessEffect } from "./duckdb-worker-process.js";
+const scope = Effect.runSync(Scope.make());
+void Effect.runPromise(startDuckdbWorkerProcessEffect(scope).pipe(Scope.provide(scope))).catch((error) => {
+    process.send?.({
+        id: 0,
+        fatal: true,
+        error: `Telemetry worker startup failed: ${String(error)}`,
+    });
+    process.exitCode = 1;
+    void Effect.runPromise(Scope.close(scope, Exit.fail(error))).then(() => process.disconnect?.(), () => process.disconnect?.());
+});
+//# sourceMappingURL=duckdb-worker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-worker.js","sourceRoot":"","sources":["../../src/local/duckdb-worker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAC5E,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AAC3C,KAAK,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAC5F,CAAC,KAAK,EAAE,EAAE;IACR,OAAO,CAAC,IAAI,EAAE,CAAC;QACb,EAAE,EAAE,CAAC;QACL,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,oCAAoC,MAAM,CAAC,KAAK,CAAC,EAAE;KAC3D,CAAC,CAAC;IACH,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAC/D,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,EAC5B,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAC7B,CAAC;AACJ,CAAC,CACF,CAAC"}