@relkit/observability-local 0.0.0-stage → 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-database.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-database.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAe,MAAM,QAAQ,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAI3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,6BAAkC,EAC9C,SAAS,CAAC,EAAE,eAAe;;;;;sBAkBL,UAAU,4MAAwB,CAAC,CAAC,CAAC;iBAE/C,UAAU,mUAAsB,CAAC,CAAC,CAAC,UACjC,UAAU,mUAAsB,CAAC,CAAC,CAAC;mBAE9B,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sFAAwB,CAAC,CAAC,CAAC,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAE7C,6BAA6B,kBAAkB,eAAe;;;GAiBtF"}

package/dist/local/duckdb-database.js

@@ -0,0 +1,61 @@
+/**
+ * Owns duckdb database 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 { openDuckdbDatabaseEffect } from "./duckdb-database-effect.js";
+import { duckdbDriverLayer } from "./duckdb-driver.js";
+import { duckdbError } from "./duckdb-error.js";
+import { DuckdbQueryError } from "./duckdb-query-error.js";
+import { ObservabilityQueryError } from "@relkit/observability";
+/**
+ * Opens a private DuckDB database and owns its Effect Scope until close.
+ * The scoped Effect implementation contains acquisition and operation logic.
+ *
+ * @param root - Directory containing the local database file.
+ * @param configured - Initial retention policy.
+ * @param redaction - Initial redaction policy.
+ * @returns A live Promise API with append, query, configure, flush, and close.
+ * @throws {DuckdbError} If acquisition, storage, or import fails.
+ * @example
+ * const database = await openDuckdbDatabase(root);
+ * await database.close();
+ */
+export async function openDuckdbDatabase(root, configured = {}, redaction) {
+    const scope = Effect.runSync(Scope.make());
+    try {
+        const database = await Effect.runPromise(openDuckdbDatabaseEffect(root, configured, redaction).pipe(Scope.provide(scope), Effect.provide(duckdbDriverLayer)));
+        let closing = false;
+        const run = (operation) => closing
+            ? Promise.reject(duckdbError("closed", new Error("Telemetry database is closed")))
+            : runDirect(operation);
+        let closePromise;
+        return {
+            imported: database.imported,
+            append: (records) => run(database.append(records)),
+            list: (kind, input) => run(database.list(kind, input)),
+            detail: (kind, id) => run(database.detail(kind, id)),
+            configure: (value, nextRedaction) => run(database.configure(value, nextRedaction)),
+            flush: () => run(database.flush()),
+            close: () => (closePromise ??= (async () => {
+                closing = true;
+                try {
+                    await runDirect(database.flush());
+                }
+                finally {
+                    await Effect.runPromise(Scope.close(scope, Exit.void));
+                }
+            })()),
+        };
+    }
+    catch (error) {
+        await Effect.runPromise(Scope.close(scope, Exit.fail(error))).catch(() => undefined);
+        throw error;
+    }
+}
+/** @typeParam A - Native success value. @typeParam E - Native failure. @param operation - Lazy database operation. @returns Promise preserving public query error identity. */
+const runDirect = (operation) => Effect.runPromise(operation.pipe(Effect.mapError((error) => error instanceof DuckdbQueryError
+    ? new ObservabilityQueryError(error.code, error.message)
+    : error)));
+//# sourceMappingURL=duckdb-database.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * Owns duckdb database.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 { makeDuckdbQueryEffect } from "./duckdb-query-effect.js";
+import type { DuckdbStorageEffects } from "./duckdb-storage.types.js";
+import type { LegacyImportSummary } from "./import-history.types.js";
+/**
+ * Scoped local database operations; the owning Scope releases native handles.
+ *
+ * @example
+ * const database = yield* openDuckdbDatabaseEffect(root);
+ * const page = yield* database.list("logs");
+ */
+export type DuckdbDatabaseEffects = DuckdbStorageEffects & ReturnType<typeof makeDuckdbQueryEffect> & {
+    readonly imported: LegacyImportSummary;
+};
+//# sourceMappingURL=duckdb-database.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-database.types.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-database.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,GACtD,UAAU,CAAC,OAAO,qBAAqB,CAAC,GAAG;IACzC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;CACxC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,25 @@
+import { Context, Effect, Layer } from "effect";
+import type { DuckdbDriver } from "./duckdb-driver.types.js";
+declare const DuckdbDriverService_base: Context.ServiceClass<DuckdbDriverService, "@relkit/observability/DuckdbDriver", DuckdbDriver> & {
+    readonly make: Effect.Effect<DuckdbDriver, never, never>;
+};
+/**
+ * Injectable native DuckDB instance factory.
+ *
+ * @example
+ * const driver = yield* DuckdbDriverService;
+ * const instance = yield* driver.create(path);
+ */
+export declare class DuckdbDriverService extends DuckdbDriverService_base {
+}
+/**
+ * Live native driver for local observability storage.
+ *
+ * @example
+ * const database = yield* openDuckdbDatabaseEffect(root).pipe(
+ *   Effect.provide(duckdbDriverLayer),
+ * );
+ */
+export declare const duckdbDriverLayer: Layer.Layer<DuckdbDriverService, never, never>;
+export {};
+//# sourceMappingURL=duckdb-driver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-driver.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-driver.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;;;;AAC7D;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,wBAYxC;CAAG;AACJ;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,gDAA8D,CAAC"}

package/dist/local/duckdb-driver.js

@@ -0,0 +1,34 @@
+/**
+ * Owns duckdb driver 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 { DuckDBInstance } from "@duckdb/node-api";
+import { Context, Effect, Layer } from "effect";
+import { duckdbError } from "./duckdb-error.js";
+/**
+ * Injectable native DuckDB instance factory.
+ *
+ * @example
+ * const driver = yield* DuckdbDriverService;
+ * const instance = yield* driver.create(path);
+ */
+export class DuckdbDriverService extends Context.Service()("@relkit/observability/DuckdbDriver", {
+    make: Effect.sync(() => ({
+        create: Effect.fn("ObservabilityDuckdb.driver.create")((path) => Effect.tryPromise({
+            try: () => DuckDBInstance.create(path),
+            catch: (cause) => duckdbError("create", cause),
+        })),
+    })),
+}) {
+}
+/**
+ * Live native driver for local observability storage.
+ *
+ * @example
+ * const database = yield* openDuckdbDatabaseEffect(root).pipe(
+ *   Effect.provide(duckdbDriverLayer),
+ * );
+ */
+export const duckdbDriverLayer = Layer.effect(DuckdbDriverService, DuckdbDriverService.make);
+//# sourceMappingURL=duckdb-driver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-driver.js","sourceRoot":"","sources":["../../src/local/duckdb-driver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,OAAO,mBAAoB,SAAQ,OAAO,CAAC,OAAO,EAAqC,CAC3F,oCAAoC,EACpC;IACE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAiB,EAAE,CAAC,CAAC;QACrC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,mCAAmC,CAAC,CAAC,CAAC,IAAY,EAAE,EAAE,CACtE,MAAM,CAAC,UAAU,CAAC;YAChB,GAAG,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC;YACtC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC;SAC/C,CAAC,CACH;KACF,CAAC,CAAC;CACJ,CACF;CAAG;AACJ;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC"}

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

@@ -0,0 +1,96 @@
+/**
+ * Owns duckdb driver.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 { DuckDBValue, Json, DuckDBMaterializedResult } from "@duckdb/node-api";
+import type { Effect } from "effect";
+import type { DuckdbError } from "./duckdb-error.js";
+/**
+ * SQL result shape used by the local observability store.
+ *
+ * @example
+ * const rows = result.getRowObjectsJson();
+ */
+export interface DuckdbRows {
+    /**
+     * Returns JSON-compatible rows from a completed statement.
+     * @returns Row objects decoded by the native driver.
+     * @example
+     * const rows = result.getRowObjectsJson();
+     */
+    readonly getRowObjectsJson: () => Record<string, Json>[];
+}
+/**
+ * Substitutable DuckDB connection with the operations used by this package.
+ * The owning Effect Scope calls `closeSync` after all operations settle.
+ *
+ * @example
+ * const result = await connection.runAndReadAll("SELECT 1");
+ */
+export interface DuckdbConnectionPort {
+    /**
+     * Runs a statement or transaction command.
+     * @param sql - SQL statement.
+     * @param values - Bound parameters.
+     * @returns Native completion result.
+     * @example
+     * await connection.run("CHECKPOINT");
+     */
+    readonly run: (sql: string, values?: DuckDBValue[]) => Promise<DuckDBMaterializedResult | void>;
+    /**
+     * Reads all rows from a completed statement.
+     * @param sql - SQL query.
+     * @param values - Bound parameters.
+     * @returns A Promise containing a row reader.
+     * @example
+     * const rows = await connection.runAndReadAll("SELECT 1");
+     */
+    readonly runAndReadAll: (sql: string, values?: DuckDBValue[]) => Promise<DuckdbRows>;
+    /**
+     * Releases the native connection from its Scope finalizer.
+     * @returns Nothing after release.
+     * @example
+     * connection.closeSync();
+     */
+    readonly closeSync: () => void;
+}
+/**
+ * Native database instance owned by the acquiring Effect Scope.
+ *
+ * @example
+ * const connection = await instance.connect();
+ */
+export interface DuckdbInstancePort {
+    /**
+     * Opens a connection owned by the same Scope.
+     * @returns A Promise containing the live connection.
+     * @example
+     * const connection = await instance.connect();
+     */
+    readonly connect: () => Promise<DuckdbConnectionPort>;
+    /**
+     * Releases the native instance after its connection closes.
+     * @returns Nothing after release.
+     * @example
+     * instance.closeSync();
+     */
+    readonly closeSync: () => void;
+}
+/**
+ * Creates a native instance; tests can supply deterministic handles.
+ *
+ * @example
+ * const instance = yield* driver.create(path);
+ */
+export interface DuckdbDriver {
+    /**
+     * Creates an instance at the requested database path.
+     * @param path - Private DuckDB database path.
+     * @returns An Effect yielding an instance or a tagged IO error.
+     * @example
+     * const instance = yield* driver.create(path);
+     */
+    readonly create: (path: string) => Effect.Effect<DuckdbInstancePort, DuckdbError>;
+}
+//# sourceMappingURL=duckdb-driver.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-driver.types.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-driver.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;CAC1D;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,KAAK,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAAC;IAChG;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACrF;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;CAChC;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACtD;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;CAChC;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,WAAW,CAAC,CAAC;CACnF"}

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

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

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

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

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

@@ -0,0 +1,32 @@
+/**
+ * Owns duckdb error 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 { Schema } from "effect";
+declare const DuckdbError_base: Schema.Class<DuckdbError, Schema.TaggedStruct<"DuckdbError", {
+    readonly operation: Schema.String;
+    readonly message: Schema.String;
+    readonly cause: Schema.Defect;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * Expected local DuckDB IO or schema failure with a stable operation label.
+ *
+ * @example
+ * const failure = new DuckdbError({ operation: "connect", message: "failed", cause });
+ */
+export declare class DuckdbError extends DuckdbError_base {
+}
+/**
+ * Converts a native DuckDB failure to the local storage error channel.
+ *
+ * @typeParam Cause - Native rejection type retained in the error cause.
+ * @param operation - Stable operation name without SQL or user values.
+ * @param cause - Native failure value.
+ * @returns A tagged storage failure preserving the cause.
+ * @example
+ * const error = duckdbError("connect", cause);
+ */
+export declare function duckdbError<Cause>(operation: string, cause: Cause): DuckdbError;
+export {};
+//# sourceMappingURL=duckdb-error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-error.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;;AAEhC;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,gBAI/B;CAAG;AAEL;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,WAAW,CAM/E"}

package/dist/local/duckdb-error.js

@@ -0,0 +1,36 @@
+/**
+ * Owns duckdb error 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 { Schema } from "effect";
+/**
+ * Expected local DuckDB IO or schema failure with a stable operation label.
+ *
+ * @example
+ * const failure = new DuckdbError({ operation: "connect", message: "failed", cause });
+ */
+export class DuckdbError extends Schema.TaggedError()("DuckdbError", {
+    operation: Schema.String,
+    message: Schema.String,
+    cause: Schema.Defect(),
+}) {
+}
+/**
+ * Converts a native DuckDB failure to the local storage error channel.
+ *
+ * @typeParam Cause - Native rejection type retained in the error cause.
+ * @param operation - Stable operation name without SQL or user values.
+ * @param cause - Native failure value.
+ * @returns A tagged storage failure preserving the cause.
+ * @example
+ * const error = duckdbError("connect", cause);
+ */
+export function duckdbError(operation, cause) {
+    return new DuckdbError({
+        operation,
+        message: cause instanceof Error ? cause.message : String(cause),
+        cause,
+    });
+}
+//# sourceMappingURL=duckdb-error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-error.js","sourceRoot":"","sources":["../../src/local/duckdb-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,OAAO,WAAY,SAAQ,MAAM,CAAC,WAAW,EAAe,CAAC,aAAa,EAAE;IAChF,SAAS,EAAE,MAAM,CAAC,MAAM;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;CACvB,CAAC;CAAG;AAEL;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAQ,SAAiB,EAAE,KAAY;IAChE,OAAO,IAAI,WAAW,CAAC;QACrB,SAAS;QACT,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/D,KAAK;KACN,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * Owns duckdb metrics 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";
+/**
+ * Records bounded operation, duration, and outcome telemetry for DuckDB work.
+ *
+ * @param operation - Static operation label.
+ * @param effect - Operation to observe.
+ * @returns The same Effect with metrics updated on every exit.
+ * @example
+ * yield* observeDuckdb("append", appendBatch);
+ */
+export declare function observeDuckdb<A, E, R>(operation: string, effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R>;
+//# sourceMappingURL=duckdb-metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-metrics.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-metrics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAmB,MAAM,EAAgB,MAAM,QAAQ,CAAC;AAC/D;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACnC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAqBxB"}

package/dist/local/duckdb-metrics.js

@@ -0,0 +1,30 @@
+/**
+ * Owns duckdb metrics 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 { Clock, Duration, Effect, Exit, Metric } from "effect";
+/**
+ * Records bounded operation, duration, and outcome telemetry for DuckDB work.
+ *
+ * @param operation - Static operation label.
+ * @param effect - Operation to observe.
+ * @returns The same Effect with metrics updated on every exit.
+ * @example
+ * yield* observeDuckdb("append", appendBatch);
+ */
+export function observeDuckdb(operation, effect) {
+    return Effect.gen(function* () {
+        const started = yield* Clock.currentTimeMillis;
+        return yield* Effect.onExit(effect, (exit) => Effect.gen(function* () {
+            const elapsed = (yield* Clock.currentTimeMillis) - started;
+            yield* Metric.update(Metric.counter("relkit_observability_duckdb_operations_total", {
+                attributes: { operation, outcome: Exit.isSuccess(exit) ? "success" : "failure" },
+            }), 1);
+            yield* Metric.update(Metric.timer("relkit_observability_duckdb_duration", {
+                attributes: { operation },
+            }), Duration.millis(elapsed));
+        }));
+    });
+}
+//# sourceMappingURL=duckdb-metrics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-metrics.js","sourceRoot":"","sources":["../../src/local/duckdb-metrics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC/D;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAC3B,SAAiB,EACjB,MAA8B;IAE9B,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;QAC/C,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAC3C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC;YAC3D,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAClB,MAAM,CAAC,OAAO,CAAC,8CAA8C,EAAE;gBAC7D,UAAU,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE;aACjF,CAAC,EACF,CAAC,CACF,CAAC;YACF,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAClB,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE;gBACnD,UAAU,EAAE,EAAE,SAAS,EAAE;aAC1B,CAAC,EACF,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CACzB,CAAC;QACJ,CAAC,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/local/duckdb-query-detail.d.ts

@@ -0,0 +1,40 @@
+/** Assembles request/log/trace detail from bounded serialized history reads. */
+import { Effect } from "effect";
+import type { DuckdbReadRows } from "./duckdb-query-rows.types.js";
+import type { makeDuckdbList } from "./duckdb-query-list.js";
+/** @param rows - Serialized row reader. @param list - Validated trace list operation. @returns Lazy bounded detail operations. */
+export declare function makeDuckdbDetail(rows: DuckdbReadRows, list: ReturnType<typeof makeDuckdbList>): (kind: "trace" | "request" | "log", id: string) => Effect.Effect<{
+    log: import("@relkit/observability/local/record").StoredLocalRecord;
+    items: readonly never[];
+    nextCursor?: string;
+    protocol: typeof import("@relkit/observability").OBSERVABILITY_QUERY_PROTOCOL;
+    version: typeof import("@relkit/observability").OBSERVABILITY_QUERY_VERSION;
+} | {
+    request: import("@relkit/observability").RequestRecord;
+    spans: readonly import("@relkit/observability").SpanRecord[];
+    roots: readonly import("@relkit/observability").SpanNode[];
+    continuations: readonly {
+        readonly traceId: string;
+        readonly active: boolean;
+    }[];
+    records: readonly import("@relkit/observability").ObservabilityRecord[];
+    counts: {
+        readonly records: number;
+        readonly spans: number;
+        readonly continuations: number;
+    };
+    incomplete: readonly string[];
+    items: readonly never[];
+    nextCursor?: string;
+    protocol: typeof import("@relkit/observability").OBSERVABILITY_QUERY_PROTOCOL;
+    version: typeof import("@relkit/observability").OBSERVABILITY_QUERY_VERSION;
+} | {
+    trace: import("@relkit/observability/local/record").StoredLocalRecord | undefined;
+    spans: import("@relkit/observability").SpanRecord[];
+    records: readonly import("@relkit/observability/local/record").StoredLocalRecord[];
+    items: readonly import("@relkit/observability/local/record").StoredLocalRecord[];
+    nextCursor?: string;
+    protocol: typeof import("@relkit/observability").OBSERVABILITY_QUERY_PROTOCOL;
+    version: typeof import("@relkit/observability").OBSERVABILITY_QUERY_VERSION;
+} | undefined, import("./duckdb-query-error.js").DuckdbQueryError | import("./duckdb-error.js").DuckdbError, never>;
+//# sourceMappingURL=duckdb-query-detail.d.ts.map

package/dist/local/duckdb-query-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-query-detail.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-query-detail.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAWhC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,kIAAkI;AAClI,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oHA4C7F"}

package/dist/local/duckdb-query-detail.js

@@ -0,0 +1,43 @@
+/** Assembles request/log/trace detail from bounded serialized history reads. */
+import { Effect } from "effect";
+import { ObservabilityQueryError, assembleRequestExecution, coalesceSpans, MAX_EXECUTION_RECORDS, } from "@relkit/observability";
+import { response, validate } from "@relkit/observability/internal/query";
+import { duckdbError } from "./duckdb-error.js";
+import { duckdbQueryError } from "./duckdb-query-error.js";
+import { observeDuckdb } from "./duckdb-metrics.js";
+const select = "SELECT id::VARCHAR AS cursor, payload::VARCHAR AS payload, origin FROM records";
+/** @param rows - Serialized row reader. @param list - Validated trace list operation. @returns Lazy bounded detail operations. */
+export function makeDuckdbDetail(rows, list) {
+    return Effect.fn("ObservabilityDuckdb.query.detail")(function* (kind, id) {
+        return yield* observeDuckdb("detail", Effect.gen(function* () {
+            if (kind === "log") {
+                yield* Effect.try({
+                    try: () => validate({ cursor: id }, 100),
+                    catch: (cause) => cause instanceof ObservabilityQueryError
+                        ? duckdbQueryError(cause)
+                        : duckdbError("validate", cause),
+                });
+                const log = (yield* rows(`${select} WHERE id = ? AND signal = 'log'`, [BigInt(id)]))[0];
+                return log ? { ...response([]), log } : undefined;
+            }
+            if (kind === "request") {
+                const records = yield* rows(`${select} WHERE request_id = ? OR origin_request_id = ? OR trace_id IN
+          (SELECT trace_id FROM records WHERE signal = 'request' AND request_id = ?)
+          ORDER BY id DESC LIMIT ?`, [id, id, id, MAX_EXECUTION_RECORDS + 1]);
+                const execution = assembleRequestExecution(records, id);
+                return execution ? { ...response([]), ...execution } : undefined;
+            }
+            const page = yield* list("traces", { traceId: id, limit: 100 });
+            if (page.items.length === 0)
+                return undefined;
+            const trace = (yield* rows(`${select} WHERE signal = 'trace' AND trace_id = ? ORDER BY id DESC LIMIT 1`, [id]))[0];
+            return {
+                ...page,
+                trace,
+                spans: coalesceSpans(page.items.filter((item) => item.signal === "span")),
+                records: page.items,
+            };
+        }));
+    });
+}
+//# sourceMappingURL=duckdb-query-detail.js.map

package/dist/local/duckdb-query-detail.js.map

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

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

@@ -0,0 +1,42 @@
+/** Composes native history rows, versioned pages and execution detail under one serialization permit. */
+import type { Semaphore } from "effect";
+import type { DuckdbConnectionPort } from "./duckdb-driver.types.js";
+/** @param connection - Scoped database connection. @param permit - Shared write/read permit. @returns List and detail Effects. */
+export declare function makeDuckdbQueryEffect(connection: DuckdbConnectionPort, permit: Semaphore.Semaphore): {
+    list: (kind: "logs" | "requests" | "traces", input?: import("@relkit/observability").ObservabilityQueryRequest | undefined) => import("effect/Effect").Effect<import("@relkit/observability").ObservabilityQueryPage<import("@relkit/observability/local/record").StoredLocalRecord>, import("./duckdb-query-error.js").DuckdbQueryError | import("./duckdb-error.js").DuckdbError, never>;
+    detail: (kind: "trace" | "request" | "log", id: string) => import("effect/Effect").Effect<{
+        log: import("@relkit/observability/local/record").StoredLocalRecord;
+        items: readonly never[];
+        nextCursor?: string;
+        protocol: typeof import("@relkit/observability").OBSERVABILITY_QUERY_PROTOCOL;
+        version: typeof import("@relkit/observability").OBSERVABILITY_QUERY_VERSION;
+    } | {
+        request: import("@relkit/observability").RequestRecord;
+        spans: readonly import("@relkit/observability").SpanRecord[];
+        roots: readonly import("@relkit/observability").SpanNode[];
+        continuations: readonly {
+            readonly traceId: string;
+            readonly active: boolean;
+        }[];
+        records: readonly import("@relkit/observability").ObservabilityRecord[];
+        counts: {
+            readonly records: number;
+            readonly spans: number;
+            readonly continuations: number;
+        };
+        incomplete: readonly string[];
+        items: readonly never[];
+        nextCursor?: string;
+        protocol: typeof import("@relkit/observability").OBSERVABILITY_QUERY_PROTOCOL;
+        version: typeof import("@relkit/observability").OBSERVABILITY_QUERY_VERSION;
+    } | {
+        trace: import("@relkit/observability/local/record").StoredLocalRecord | undefined;
+        spans: import("@relkit/observability").SpanRecord[];
+        records: readonly import("@relkit/observability/local/record").StoredLocalRecord[];
+        items: readonly import("@relkit/observability/local/record").StoredLocalRecord[];
+        nextCursor?: string;
+        protocol: typeof import("@relkit/observability").OBSERVABILITY_QUERY_PROTOCOL;
+        version: typeof import("@relkit/observability").OBSERVABILITY_QUERY_VERSION;
+    } | undefined, import("./duckdb-query-error.js").DuckdbQueryError | import("./duckdb-error.js").DuckdbError, never>;
+};
+//# sourceMappingURL=duckdb-query-effect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-query-effect.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-query-effect.ts"],"names":[],"mappings":"AAAA,yGAAyG;AACzG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAIrE,kIAAkI;AAClI,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,oBAAoB,EAChC,MAAM,EAAE,SAAS,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK5B"}

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

@@ -0,0 +1,10 @@
+import { makeDuckdbRows } from "./duckdb-query-rows.js";
+import { makeDuckdbList } from "./duckdb-query-list.js";
+import { makeDuckdbDetail } from "./duckdb-query-detail.js";
+/** @param connection - Scoped database connection. @param permit - Shared write/read permit. @returns List and detail Effects. */
+export function makeDuckdbQueryEffect(connection, permit) {
+    const rows = makeDuckdbRows(connection, permit);
+    const list = makeDuckdbList(rows);
+    return { list, detail: makeDuckdbDetail(rows, list) };
+}
+//# sourceMappingURL=duckdb-query-effect.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-query-effect.js","sourceRoot":"","sources":["../../src/local/duckdb-query-effect.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,kIAAkI;AAClI,MAAM,UAAU,qBAAqB,CACnC,UAAgC,EAChC,MAA2B;IAE3B,MAAM,IAAI,GAAG,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;AACxD,CAAC"}

package/dist/local/duckdb-query-error.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Owns duckdb query error 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 { Schema } from "effect";
+import { ObservabilityQueryError } from "@relkit/observability";
+declare const DuckdbQueryError_base: Schema.Class<DuckdbQueryError, Schema.TaggedStruct<"DuckdbQueryError", {
+    readonly code: Schema.Literals<readonly ["RELKIT_OBSERVABILITY_QUERY_INVALID", "RELKIT_OBSERVABILITY_QUERY_PROTOCOL_MISMATCH"]>;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * Invalid local query input reported through the Effect error channel.
+ *
+ * @example
+ * const failure = new DuckdbQueryError({
+ *   code: "RELKIT_OBSERVABILITY_QUERY_INVALID", message: "Invalid cursor",
+ * });
+ */
+export declare class DuckdbQueryError extends DuckdbQueryError_base {
+}
+/**
+ * Converts a query validation exception to a tagged Effect error.
+ *
+ * @param error - Compatibility query exception.
+ * @returns Tagged query failure with its stable public code.
+ * @example
+ * const failure = duckdbQueryError(error);
+ */
+export declare function duckdbQueryError(error: ObservabilityQueryError): DuckdbQueryError;
+export {};
+//# sourceMappingURL=duckdb-query-error.d.ts.map

package/dist/local/duckdb-query-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-query-error.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-query-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;;;;;AAChE;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,qBAMpC;CAAG;AACL;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,uBAAuB,GAAG,gBAAgB,CAEjF"}