@relkit/observability-local 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,33 @@
+/**
+ * Owns worker client service 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 { Context, Effect, Layer } from "effect";
+import type { LocalWorkerEffects } from "@relkit/observability/local/worker-contract";
+declare const LocalWorkerService_base: Context.ServiceClass<LocalWorkerService, "@relkit/observability/LocalWorkerService", LocalWorkerEffects> & {
+    readonly make: (onFailure?: ((error: Error) => void) | undefined) => Effect.Effect<LocalWorkerEffects, import("@relkit/observability/local/worker-contract").LocalWorkerError, import("effect/Scope").Scope>;
+};
+/**
+ * Injectable local worker operations. A Layer owns the worker process until
+ * its scope closes, so callers can substitute a deterministic service in tests.
+ *
+ * @example
+ * const program = Effect.gen(function* () {
+ *   const worker = yield* LocalWorkerService;
+ *   return worker.pid;
+ * });
+ */
+export declare class LocalWorkerService extends LocalWorkerService_base {
+}
+/**
+ * Acquires a worker for the Layer scope and releases it on every exit.
+ *
+ * @param onFailure - Receives the first unexpected worker failure.
+ * @returns A Layer providing `LocalWorkerService`.
+ * @example
+ * const result = await Effect.runPromise(program.pipe(Effect.provide(localWorkerLayer())));
+ */
+export declare const localWorkerLayer: (onFailure?: (error: Error) => void) => Layer.Layer<LocalWorkerService, import("@relkit/observability/local/worker-contract").LocalWorkerError, never>;
+export {};
+//# sourceMappingURL=worker-client-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker-client-service.d.ts","sourceRoot":"","sources":["../../src/local/worker-client-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;;yCAevD,KAAK,KAAK,IAAI;;AAb7C;;;;;;;;;GASG;AACH,qBAAa,kBAAmB,SAAQ,uBAQvC;CAAG;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAAI,YAAY,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,mHACG,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * Owns worker client service 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 { Context, Effect, Layer } from "effect";
+import { startLocalWorkerEffect } from "./worker-client-effect.js";
+/**
+ * Injectable local worker operations. A Layer owns the worker process until
+ * its scope closes, so callers can substitute a deterministic service in tests.
+ *
+ * @example
+ * const program = Effect.gen(function* () {
+ *   const worker = yield* LocalWorkerService;
+ *   return worker.pid;
+ * });
+ */
+export class LocalWorkerService extends Context.Service()("@relkit/observability/LocalWorkerService", {
+    make: (onFailure) => Effect.acquireRelease(startLocalWorkerEffect(onFailure), (worker) => Effect.ignore(worker.close())),
+}) {
+}
+/**
+ * Acquires a worker for the Layer scope and releases it on every exit.
+ *
+ * @param onFailure - Receives the first unexpected worker failure.
+ * @returns A Layer providing `LocalWorkerService`.
+ * @example
+ * const result = await Effect.runPromise(program.pipe(Effect.provide(localWorkerLayer())));
+ */
+export const localWorkerLayer = (onFailure) => Layer.effect(LocalWorkerService, LocalWorkerService.make(onFailure));
+//# sourceMappingURL=worker-client-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker-client-service.js","sourceRoot":"","sources":["../../src/local/worker-client-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAGnE;;;;;;;;;GASG;AACH,MAAM,OAAO,kBAAmB,SAAQ,OAAO,CAAC,OAAO,EAA0C,CAC/F,0CAA0C,EAC1C;IACE,IAAI,EAAE,CAAC,SAAkC,EAAE,EAAE,CAC3C,MAAM,CAAC,cAAc,CAAC,sBAAsB,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAClE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAC9B;CACJ,CACF;CAAG;AAEJ;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,SAAkC,EAAE,EAAE,CACrE,KAAK,CAAC,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { ChildProcess } from "node:child_process";
+import type { WorkerClientState } from "./worker-client-state.types.js";
+/** @param child - Owned IPC child. @param onFailure - First terminal failure observer. @returns Registered process state. */
+export declare function createWorkerClientState(child: ChildProcess, onFailure: (error: Error) => void): WorkerClientState;
+/** @param state - Owned child state. @returns Nothing after idempotent child termination. */
+export declare function stopWorkerClient(state: WorkerClientState): void;
+/** @param state - Owned IPC state. @param error - Terminal diagnostic. @returns Nothing after settling pending calls and stopping the child. */
+export declare function failWorkerClient(state: WorkerClientState, error: Error): void;
+//# sourceMappingURL=worker-client-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker-client-state.d.ts","sourceRoot":"","sources":["../../src/local/worker-client-state.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAexE,6HAA6H;AAC7H,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAChC,iBAAiB,CA8BnB;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAI/D;AAED,gJAAgJ;AAChJ,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAa7E"}

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

@@ -0,0 +1,96 @@
+/**
+ * Registers IPC reply/exit handlers for one isolated storage worker.
+ * Invalid replies fail pending callers; stopping affects only the owned child.
+ */
+import { Schema } from "effect";
+import { ObservabilityQueryError } from "@relkit/observability";
+import { WorkerTransportError } from "@relkit/observability/local/worker-contract";
+const responseSchema = Schema.Struct({
+    id: Schema.Number,
+    fatal: Schema.optionalKey(Schema.Boolean),
+    value: Schema.optionalKey(Schema.Json),
+    error: Schema.optionalKey(Schema.String),
+    code: Schema.optionalKey(Schema.Literals([
+        "RELKIT_OBSERVABILITY_QUERY_INVALID",
+        "RELKIT_OBSERVABILITY_QUERY_PROTOCOL_MISMATCH",
+    ])),
+});
+/** @param child - Owned IPC child. @param onFailure - First terminal failure observer. @returns Registered process state. */
+export function createWorkerClientState(child, onFailure) {
+    const state = {
+        child,
+        onFailure,
+        exited: new Promise((resolve) => child.once("close", () => resolve())),
+        pending: new Map(),
+        nextId: 0,
+        closed: false,
+        closing: false,
+        opened: false,
+        failure: undefined,
+        diagnostic: "",
+        closePromise: undefined,
+    };
+    child.stderr?.on("data", (value) => {
+        state.diagnostic = `${state.diagnostic}${value.toString()}`.slice(-8192);
+    });
+    child.on("error", (error) => failWorkerClient(state, error));
+    child.on("exit", (code) => {
+        if (!state.closed && (!state.closing || state.pending.size > 0))
+            failWorkerClient(state, new Error(`Telemetry worker exited (${code}): ${state.diagnostic}`));
+    });
+    child.on("message", (input) => {
+        try {
+            receiveWorkerReply(state, Schema.decodeUnknownSync(responseSchema)(input));
+        }
+        catch (cause) {
+            failWorkerClient(state, new Error("Invalid telemetry worker response", { cause }));
+        }
+    });
+    return state;
+}
+/** @param state - Owned child state. @returns Nothing after idempotent child termination. */
+export function stopWorkerClient(state) {
+    if (state.closed)
+        return;
+    state.closed = true;
+    state.child.kill();
+}
+/** @param state - Owned IPC state. @param error - Terminal diagnostic. @returns Nothing after settling pending calls and stopping the child. */
+export function failWorkerClient(state, error) {
+    if (state.failure)
+        return;
+    state.failure = error;
+    for (const item of state.pending.values()) {
+        clearTimeout(item.timer);
+        item.reject(error);
+    }
+    state.pending.clear();
+    try {
+        if (!state.closed)
+            state.onFailure(error);
+    }
+    finally {
+        stopWorkerClient(state);
+    }
+}
+/** @param state - Pending owner. @param message - Decoded IPC reply. @returns Nothing after settling its exact pending identity. */
+function receiveWorkerReply(state, message) {
+    if (message.fatal) {
+        failWorkerClient(state, new Error(message.error ?? "Telemetry worker failed; restart dev to recover"));
+        return;
+    }
+    const item = state.pending.get(message.id);
+    if (!item)
+        return;
+    clearTimeout(item.timer);
+    state.pending.delete(message.id);
+    if (!message.error) {
+        item.resolve(message.value);
+        return;
+    }
+    if (message.code)
+        item.reject(new ObservabilityQueryError(message.code, message.error));
+    else
+        item.reject(new WorkerTransportError("response", message.error));
+}
+//# sourceMappingURL=worker-client-state.js.map

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

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

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

@@ -0,0 +1,24 @@
+/** Private IPC ownership state; every pending reply belongs to one child process. */
+import type { ChildProcess } from "node:child_process";
+import type { Schema } from "effect";
+/** One timer-bound IPC reply, settled or rejected when the worker retires. */
+export interface PendingWorkerCall {
+    readonly resolve: (value: Schema.Json | undefined) => void;
+    readonly reject: (error: Error) => void;
+    readonly timer: ReturnType<typeof setTimeout>;
+}
+/** Physical process, pending replies, and exactly-once close state. */
+export interface WorkerClientState {
+    readonly child: ChildProcess;
+    readonly pending: Map<number, PendingWorkerCall>;
+    readonly onFailure: (error: Error) => void;
+    readonly exited: Promise<void>;
+    nextId: number;
+    closed: boolean;
+    closing: boolean;
+    opened: boolean;
+    failure: Error | undefined;
+    diagnostic: string;
+    closePromise: Promise<void> | undefined;
+}
+//# sourceMappingURL=worker-client-state.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker-client-state.types.d.ts","sourceRoot":"","sources":["../../src/local/worker-client-state.types.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,8EAA8E;AAC9E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;IAC3D,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;CAC/C;AAED,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,KAAK,GAAG,SAAS,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;CACzC"}

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

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

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

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

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

@@ -0,0 +1,21 @@
+import type { LocalWorkerCommand } from "@relkit/observability/local/record";
+export { LocalWorkerError } from "@relkit/observability/local/worker-contract";
+export { startLocalWorkerEffect } from "./worker-client-effect.js";
+export { LocalWorkerService, localWorkerLayer } from "./worker-client-service.js";
+export type { LocalWorkerEffects } from "@relkit/observability/local/worker-contract";
+/**
+ * Starts a local worker with the existing Promise API.
+ *
+ * @param onFailure - Receives the first unexpected worker failure.
+ * @returns A live worker with Promise based `call` and `close` methods.
+ * @throws {Error} If process creation fails.
+ * @example
+ * const worker = startLocalWorker();
+ * try { await worker.call({ type: "flush" }); } finally { await worker.close(); }
+ */
+export declare function startLocalWorker(onFailure?: (error: Error) => void): {
+    pid: number | undefined;
+    call: <T>(command: LocalWorkerCommand) => Promise<T>;
+    close: () => Promise<void>;
+};
+//# sourceMappingURL=worker-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker-client.d.ts","sourceRoot":"","sources":["../../src/local/worker-client.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAE7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAClF,YAAY,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AAKtF;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,GAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAsB;;WAkBzE,CAAC,WAAW,kBAAkB,KAAG,OAAO,CAAC,CAAC,CAAC;iBAEvC,OAAO,CAAC,IAAI,CAAC;EAE3B"}

package/dist/local/worker-client.js

@@ -0,0 +1,35 @@
+/**
+ * Owns worker client 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 { ObservabilityQueryError } from "@relkit/observability";
+import { LocalWorkerError } from "@relkit/observability/local/worker-contract";
+import { startLocalWorkerEffect } from "./worker-client-effect.js";
+export { LocalWorkerError } from "@relkit/observability/local/worker-contract";
+export { startLocalWorkerEffect } from "./worker-client-effect.js";
+export { LocalWorkerService, localWorkerLayer } from "./worker-client-service.js";
+const compatibilityError = (error) => error.code ? new ObservabilityQueryError(error.code, error.message) : new Error(error.message);
+/**
+ * Starts a local worker with the existing Promise API.
+ *
+ * @param onFailure - Receives the first unexpected worker failure.
+ * @returns A live worker with Promise based `call` and `close` methods.
+ * @throws {Error} If process creation fails.
+ * @example
+ * const worker = startLocalWorker();
+ * try { await worker.call({ type: "flush" }); } finally { await worker.close(); }
+ */
+export function startLocalWorker(onFailure = () => undefined) {
+    const worker = Effect.runSync(startLocalWorkerEffect(onFailure).pipe(Effect.catchTag("LocalWorkerError", (error) => Effect.sync(() => {
+        throw compatibilityError(error);
+    }))));
+    const legacy = (effect) => Effect.runPromise(effect.pipe(Effect.catchTag("LocalWorkerError", (error) => Effect.fail(compatibilityError(error)))));
+    return {
+        pid: worker.pid,
+        call: (command) => legacy(worker.call(command)),
+        close: () => legacy(worker.close()),
+    };
+}
+//# sourceMappingURL=worker-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker-client.js","sourceRoot":"","sources":["../../src/local/worker-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAGnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAGlF,MAAM,kBAAkB,GAAG,CAAC,KAAuB,EAAS,EAAE,CAC5D,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,uBAAuB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAEjG;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,YAAoC,GAAG,EAAE,CAAC,SAAS;IAClF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAC3B,sBAAsB,CAAC,SAAS,CAAC,CAAC,IAAI,CACpC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,EAAE,CAC5C,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC,CAAC,CACH,CACF,CACF,CAAC;IACF,MAAM,MAAM,GAAG,CAAI,MAA0C,EAAc,EAAE,CAC3E,MAAM,CAAC,UAAU,CACf,MAAM,CAAC,IAAI,CACT,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CACvF,CACF,CAAC;IACJ,OAAO;QACL,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,IAAI,EAAE,CAAI,OAA2B,EAAc,EAAE,CACnD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAe;QAC5C,KAAK,EAAE,GAAkB,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;KACnD,CAAC;AACJ,CAAC"}

package/dist/local/worker.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Owns 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.
+ */
+/**
+ * Exposes IPC transport without evaluating the native DuckDB driver in its caller.
+ * The isolated Node worker imports that driver in its own process. Its caller
+ * retains the transport's explicit close operation and physical child identity.
+ */
+export { startLocalWorkerEffect } from "./worker-client-effect.js";
+export type { LocalWorkerEffects } from "@relkit/observability/local/worker-contract";
+export type { LocalWorkerError } from "@relkit/observability/local/worker-contract";
+export type { LocalWorkerCommand } from "@relkit/observability/local/record";
+//# sourceMappingURL=worker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/local/worker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;GAIG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AACtF,YAAY,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AACpF,YAAY,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/local/worker.js

@@ -0,0 +1,12 @@
+/**
+ * Owns 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.
+ */
+/**
+ * Exposes IPC transport without evaluating the native DuckDB driver in its caller.
+ * The isolated Node worker imports that driver in its own process. Its caller
+ * retains the transport's explicit close operation and physical child identity.
+ */
+export { startLocalWorkerEffect } from "./worker-client-effect.js";
+//# sourceMappingURL=worker.js.map

package/dist/local/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../src/local/worker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;GAIG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC"}

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "@relkit/observability-local",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Explicit local diagnostic history and worker storage for RELKIT inspection.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rel-kit/relkit.git",
+    "directory": "packages/observability-local"
+  },
+  "homepage": "https://github.com/rel-kit/relkit#readme",
+  "bugs": {
+    "url": "https://github.com/rel-kit/relkit/issues"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "bun": ">=1.3.10"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./worker": {
+      "types": "./dist/local/worker.d.ts",
+      "import": "./dist/local/worker.js"
+    },
+    "./internal/local-worker": {
+      "types": "./dist/local/duckdb-worker.d.ts",
+      "import": "./dist/local/duckdb-worker.js"
+    }
+  },
+  "dependencies": {
+    "@duckdb/node-api": "1.5.5-r.4",
+    "@relkit/contracts": "0.7.10",
+    "@relkit/observability": "0.7.10",
+    "effect": "4.0.1"
+  },
+  "devDependencies": {
+    "@effect/vitest": "4.0.1",
+    "@vitest/coverage-v8": "5.0.1",
+    "vitest": "5.0.1"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "check": "tsc -b --pretty false",
+    "typecheck": "tsc -b --pretty false",
+    "test": "vitest run --config vitest.config.ts"
+  }
+}