@relkit/observability-local 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,35 @@
+/**
+ * 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";
+/**
+ * Invalid local query input reported through the Effect error channel.
+ *
+ * @example
+ * const failure = new DuckdbQueryError({
+ *   code: "RELKIT_OBSERVABILITY_QUERY_INVALID", message: "Invalid cursor",
+ * });
+ */
+export class DuckdbQueryError extends Schema.TaggedError()("DuckdbQueryError", {
+    code: Schema.Literals([
+        "RELKIT_OBSERVABILITY_QUERY_INVALID",
+        "RELKIT_OBSERVABILITY_QUERY_PROTOCOL_MISMATCH",
+    ]),
+    message: Schema.String,
+}) {
+}
+/**
+ * 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 function duckdbQueryError(error) {
+    return new DuckdbQueryError({ code: error.code, message: error.message });
+}
+//# sourceMappingURL=duckdb-query-error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-query-error.js","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,MAAM,OAAO,gBAAiB,SAAQ,MAAM,CAAC,WAAW,EAAoB,CAAC,kBAAkB,EAAE;IAC/F,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC;QACpB,oCAAoC;QACpC,8CAA8C;KAC/C,CAAC;IACF,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC;CAAG;AACL;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAA8B;IAC7D,OAAO,IAAI,gBAAgB,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;AAC5E,CAAC"}

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

@@ -0,0 +1,9 @@
+/** Compiles validated query filters into bound native SQL parameters; no user value becomes SQL. */
+import type { DuckDBValue } from "@duckdb/node-api";
+import type { NormalizedQuery } from "@relkit/observability/internal/query";
+/** @param kind - Signal family. @param query - Validated query. @returns SQL clauses and ordered values. */
+export declare function duckdbQueryFilters(kind: "logs" | "requests" | "traces", query: NormalizedQuery): {
+    clauses: string[];
+    values: DuckDBValue[];
+};
+//# sourceMappingURL=duckdb-query-filters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-query-filters.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-query-filters.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,4GAA4G;AAC5G,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,EAAE,KAAK,EAAE,eAAe;;;EA2C9F"}

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

@@ -0,0 +1,51 @@
+/** @param kind - Signal family. @param query - Validated query. @returns SQL clauses and ordered values. */
+export function duckdbQueryFilters(kind, query) {
+    const clauses = [
+        kind === "logs"
+            ? "signal = 'log'"
+            : kind === "requests"
+                ? "signal = 'request'"
+                : "signal IN ('trace', 'span', 'request')",
+    ];
+    const values = [];
+    const add = (clause, value) => {
+        clauses.push(clause);
+        values.push(value);
+    };
+    const descending = query.order === "desc";
+    if (query.cursor !== undefined && !(kind === "traces" && query.traceId === undefined))
+        add(`id ${descending ? "<" : ">"} ?`, BigInt(query.cursor));
+    if (query.fromMs !== undefined)
+        add("recorded_at >= ?", query.fromMs);
+    if (query.toMs !== undefined)
+        add("recorded_at <= ?", query.toMs);
+    if (query.source !== undefined)
+        add("origin = ?", query.source);
+    if (query.search?.trim())
+        add("strpos(lower(payload::VARCHAR), lower(?)) > 0", query.search.trim());
+    for (const [key, column] of Object.entries({
+        severity: "level",
+        routeId: "routeId",
+        functionId: "functionId",
+        outcome: "outcome",
+        serviceId: "serviceId",
+        generationId: "generationId",
+        graphHash: "graphHash",
+    })) {
+        const value = query[key];
+        if (typeof value === "string")
+            add(`json_extract_string(payload, '$.${column}') = ?`, value);
+    }
+    for (const [key, column] of Object.entries({
+        traceId: "trace_id",
+        spanId: "span_id",
+        requestId: "request_id",
+        originRequestId: "origin_request_id",
+    })) {
+        const value = query[key];
+        if (typeof value === "string")
+            add(`${column} = ?`, value);
+    }
+    return { clauses, values };
+}
+//# sourceMappingURL=duckdb-query-filters.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-query-filters.js","sourceRoot":"","sources":["../../src/local/duckdb-query-filters.ts"],"names":[],"mappings":"AAIA,4GAA4G;AAC5G,MAAM,UAAU,kBAAkB,CAAC,IAAoC,EAAE,KAAsB;IAC7F,MAAM,OAAO,GAAG;QACd,IAAI,KAAK,MAAM;YACb,CAAC,CAAC,gBAAgB;YAClB,CAAC,CAAC,IAAI,KAAK,UAAU;gBACnB,CAAC,CAAC,oBAAoB;gBACtB,CAAC,CAAC,wCAAwC;KAC/C,CAAC;IACF,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,MAAM,GAAG,GAAG,CAAC,MAAc,EAAE,KAAkB,EAAQ,EAAE;QACvD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC;IAC1C,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC;QACnF,GAAG,CAAC,MAAM,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9D,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,GAAG,CAAC,kBAAkB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACtE,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,GAAG,CAAC,kBAAkB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAClE,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAChE,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE;QACtB,GAAG,CAAC,+CAA+C,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5E,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC;QACzC,QAAQ,EAAE,OAAO;QACjB,OAAO,EAAE,SAAS;QAClB,UAAU,EAAE,YAAY;QACxB,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,WAAW;QACtB,YAAY,EAAE,cAAc;QAC5B,SAAS,EAAE,WAAW;KACvB,CAAC,EAAE,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CAAC,GAAsC,CAAC,CAAC;QAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,GAAG,CAAC,mCAAmC,MAAM,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC/F,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC;QACzC,OAAO,EAAE,UAAU;QACnB,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,YAAY;QACvB,eAAe,EAAE,mBAAmB;KACrC,CAAC,EAAE,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CAAC,GAAsC,CAAC,CAAC;QAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,GAAG,CAAC,GAAG,MAAM,MAAM,EAAE,KAAK,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC"}

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

@@ -0,0 +1,7 @@
+/** Executes a validated list plan and emits versioned cursor pages over committed history. */
+import { Effect } from "effect";
+import type { ObservabilityQueryRequest } from "@relkit/observability";
+import type { DuckdbReadRows } from "./duckdb-query-rows.types.js";
+/** @param rows - Serialized native reader. @returns Lazy list operation with database/query typed failures. */
+export declare function makeDuckdbList(rows: DuckdbReadRows): (kind: "logs" | "requests" | "traces", input?: ObservabilityQueryRequest | undefined) => Effect.Effect<import("@relkit/observability").ObservabilityQueryPage<import("@relkit/observability/local/record").StoredLocalRecord>, import("./duckdb-query-error.js").DuckdbQueryError | import("./duckdb-error.js").DuckdbError, never>;
+//# sourceMappingURL=duckdb-query-list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-query-list.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-query-list.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAMvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,+GAA+G;AAC/G,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,uUAsBlD"}

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

@@ -0,0 +1,26 @@
+/** Executes a validated list plan and emits versioned cursor pages over committed history. */
+import { Effect } from "effect";
+import { ObservabilityQueryError } from "@relkit/observability";
+import { response, validate } from "@relkit/observability/internal/query";
+import { duckdbQueryPlan } from "./duckdb-query-plan.js";
+import { duckdbError } from "./duckdb-error.js";
+import { duckdbQueryError } from "./duckdb-query-error.js";
+import { observeDuckdb } from "./duckdb-metrics.js";
+/** @param rows - Serialized native reader. @returns Lazy list operation with database/query typed failures. */
+export function makeDuckdbList(rows) {
+    return Effect.fn("ObservabilityDuckdb.query.list")(function* (kind, input = {}) {
+        return yield* observeDuckdb("list", Effect.gen(function* () {
+            const query = yield* Effect.try({
+                try: () => validate(input, 100),
+                catch: (cause) => cause instanceof ObservabilityQueryError
+                    ? duckdbQueryError(cause)
+                    : duckdbError("validate", cause),
+            });
+            const plan = duckdbQueryPlan(kind, query);
+            const found = yield* rows(plan.sql, plan.values);
+            const page = found.slice(0, query.limit);
+            return response(page, found.length > query.limit ? page.at(-1)?.cursor : undefined);
+        }));
+    });
+}
+//# sourceMappingURL=duckdb-query-list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-query-list.js","sourceRoot":"","sources":["../../src/local/duckdb-query-list.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,+GAA+G;AAC/G,MAAM,UAAU,cAAc,CAAC,IAAoB;IACjD,OAAO,MAAM,CAAC,EAAE,CAAC,gCAAgC,CAAC,CAAC,QAAQ,CAAC,EAC1D,IAAoC,EACpC,QAAmC,EAAE;QAErC,OAAO,KAAK,CAAC,CAAC,aAAa,CACzB,MAAM,EACN,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;gBAC9B,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC;gBAC/B,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,KAAK,YAAY,uBAAuB;oBACtC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC;oBACzB,CAAC,CAAC,WAAW,CAAC,UAAU,EAAE,KAAK,CAAC;aACrC,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACjD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACzC,OAAO,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACtF,CAAC,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,8 @@
+/** Builds history paging SQL with stable request/trace revision selection and bound parameters. */
+import type { NormalizedQuery } from "@relkit/observability/internal/query";
+/** @param kind - Query signal family. @param query - Validated paging/filter request. @returns Native SQL and ordered bindings. */
+export declare function duckdbQueryPlan(kind: "logs" | "requests" | "traces", query: NormalizedQuery): {
+    sql: string;
+    values: import("@duckdb/node-api").DuckDBValue[];
+};
+//# sourceMappingURL=duckdb-query-plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-query-plan.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-query-plan.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAG5E,mIAAmI;AACnI,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,EAAE,KAAK,EAAE,eAAe;;;EAiC3F"}

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

@@ -0,0 +1,49 @@
+import { duckdbQueryFilters } from "./duckdb-query-filters.js";
+const select = "SELECT id::VARCHAR AS cursor, payload::VARCHAR AS payload, origin FROM records";
+/** @param kind - Query signal family. @param query - Validated paging/filter request. @returns Native SQL and ordered bindings. */
+export function duckdbQueryPlan(kind, query) {
+    const { clauses, values } = duckdbQueryFilters(kind, query);
+    const descending = query.order === "desc";
+    const distinctTraces = kind === "traces" && query.traceId === undefined;
+    if (distinctTraces)
+        return {
+            sql: `WITH matching AS (
+             SELECT DISTINCT trace_id FROM records WHERE ${clauses.join(" AND ")} AND trace_id IS NOT NULL
+           ), ranked AS (
+             SELECT id, payload, origin,
+               row_number() OVER (
+                 PARTITION BY trace_id
+                 ORDER BY CASE signal WHEN 'request' THEN 3 WHEN 'trace' THEN 2 ELSE 1 END DESC, id DESC
+               ) AS trace_rank
+             FROM records
+             WHERE trace_id IN (SELECT trace_id FROM matching)
+               AND signal IN ('trace', 'span', 'request')
+           )
+           SELECT id::VARCHAR AS cursor, payload::VARCHAR AS payload, origin
+           FROM ranked WHERE trace_rank = 1
+             ${query.cursor === undefined ? "" : `AND id ${descending ? "<" : ">"} ?`}
+           ORDER BY id ${descending ? "DESC" : "ASC"} LIMIT ?`,
+            values: [
+                ...values,
+                ...(query.cursor === undefined ? [] : [BigInt(query.cursor)]),
+                query.limit + 1,
+            ],
+        };
+    const listSelect = querySelect(kind);
+    return {
+        sql: `${listSelect} ${clauses.join(" AND ")} ORDER BY id ${descending ? "DESC" : "ASC"} LIMIT ?`,
+        values: [...values, query.limit + 1],
+    };
+}
+/** @param kind - Signal family. @returns Request revision projection or ordinary record projection. */
+function querySelect(kind) {
+    return kind === "requests"
+        ? `${select.replace("FROM records", `FROM (
+              SELECT *, row_number() OVER (
+                PARTITION BY request_id
+                ORDER BY CASE json_extract_string(payload, '$.phase') WHEN 'completed' THEN 1 ELSE 0 END DESC, id DESC
+              ) AS request_rank FROM records WHERE signal = 'request'
+            )`)} WHERE request_rank = 1 AND`
+        : `${select} WHERE`;
+}
+//# sourceMappingURL=duckdb-query-plan.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-query-plan.js","sourceRoot":"","sources":["../../src/local/duckdb-query-plan.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,MAAM,MAAM,GAAG,gFAAgF,CAAC;AAChG,mIAAmI;AACnI,MAAM,UAAU,eAAe,CAAC,IAAoC,EAAE,KAAsB;IAC1F,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC;IAC1C,MAAM,cAAc,GAAG,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC;IACxE,IAAI,cAAc;QAChB,OAAO;YACL,GAAG,EAAE;2DACgD,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;;;;;;;;;;;;;eAajE,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI;yBAC5D,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,UAAU;YACxD,MAAM,EAAE;gBACN,GAAG,MAAM;gBACT,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC7D,KAAK,CAAC,KAAK,GAAG,CAAC;aAChB;SACF,CAAC;IACJ,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO;QACL,GAAG,EAAE,GAAG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,UAAU;QAChG,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;KACrC,CAAC;AACJ,CAAC;AACD,uGAAuG;AACvG,SAAS,WAAW,CAAC,IAAoC;IACvD,OAAO,IAAI,KAAK,UAAU;QACxB,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CACf,cAAc,EACd;;;;;cAKM,CACP,6BAA6B;QAChC,CAAC,CAAC,GAAG,MAAM,QAAQ,CAAC;AACxB,CAAC"}

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

@@ -0,0 +1,8 @@
+/** Decodes native JSON rows into validated diagnostic records under the shared database permit. */
+import type { DuckDBValue } from "@duckdb/node-api";
+import { Effect, Semaphore } from "effect";
+import type { StoredLocalRecord } from "@relkit/observability/local/record";
+import type { DuckdbConnectionPort } from "./duckdb-driver.types.js";
+/** @param connection - Scoped native connection. @param permit - Database serialization. @returns The validated row reader. */
+export declare function makeDuckdbRows(connection: DuckdbConnectionPort, permit: Semaphore.Semaphore): (sql: string, values?: DuckDBValue[] | undefined) => Effect.Effect<StoredLocalRecord[], import("./duckdb-error.js").DuckdbError, never>;
+//# sourceMappingURL=duckdb-query-rows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-query-rows.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-query-rows.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAG5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,+HAA+H;AAC/H,wBAAgB,cAAc,CAAC,UAAU,EAAE,oBAAoB,EAAE,MAAM,EAAE,SAAS,CAAC,SAAS,2IAiB3F"}

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

@@ -0,0 +1,23 @@
+import { Effect, Semaphore } from "effect";
+import { validateLocalRecord } from "@relkit/observability/local/record";
+import { duckdbError } from "./duckdb-error.js";
+import { readDuckdbSql } from "./duckdb-sql.js";
+/** @param connection - Scoped native connection. @param permit - Database serialization. @returns The validated row reader. */
+export function makeDuckdbRows(connection, permit) {
+    return Effect.fn("ObservabilityDuckdb.rows")(function* (sql, values = []) {
+        const result = yield* permit.withPermit(readDuckdbSql(connection, "query", sql, values));
+        return yield* Effect.try({
+            try: () => result.getRowObjectsJson().map((item) => {
+                const envelope = {
+                    key: `read:${String(item.cursor)}`,
+                    origin: item.origin,
+                    record: JSON.parse(String(item.payload)),
+                };
+                validateLocalRecord(envelope);
+                return { ...envelope.record, cursor: String(item.cursor), origin: envelope.origin };
+            }),
+            catch: (cause) => duckdbError("decode", cause),
+        });
+    });
+}
+//# sourceMappingURL=duckdb-query-rows.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-query-rows.js","sourceRoot":"","sources":["../../src/local/duckdb-query-rows.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,+HAA+H;AAC/H,MAAM,UAAU,cAAc,CAAC,UAAgC,EAAE,MAA2B;IAC1F,OAAO,MAAM,CAAC,EAAE,CAAC,0BAA0B,CAAC,CAAC,QAAQ,CAAC,EAAE,GAAW,EAAE,SAAwB,EAAE;QAC7F,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QACzF,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YACvB,GAAG,EAAE,GAAwB,EAAE,CAC7B,MAAM,CAAC,iBAAiB,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBACtC,MAAM,QAAQ,GAAG;oBACf,GAAG,EAAE,QAAQ,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;oBAClC,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;iBACzC,CAAC;gBACF,mBAAmB,CAAC,QAAQ,CAAC,CAAC;gBAC9B,OAAO,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;YACtF,CAAC,CAAC;YACJ,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC;SAC/C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/local/duckdb-query-rows.types.d.ts

@@ -0,0 +1,8 @@
+/** SQL row reader shared by native list/detail query operations. */
+import type { Effect } from "effect";
+import type { DuckDBValue } from "@duckdb/node-api";
+import type { StoredLocalRecord } from "@relkit/observability/local/record";
+import type { DuckdbError } from "./duckdb-error.js";
+/** Reads only fully decoded stored records from native SQL. */
+export type DuckdbReadRows = (sql: string, values?: DuckDBValue[]) => Effect.Effect<StoredLocalRecord[], DuckdbError>;
+//# sourceMappingURL=duckdb-query-rows.types.d.ts.map

package/dist/local/duckdb-query-rows.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-query-rows.types.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-query-rows.types.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,+DAA+D;AAC/D,MAAM,MAAM,cAAc,GAAG,CAC3B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,EAAE,KACnB,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,EAAE,WAAW,CAAC,CAAC"}

package/dist/local/duckdb-query-rows.types.js

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

package/dist/local/duckdb-query-rows.types.js.map

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

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

@@ -0,0 +1,49 @@
+import type { DuckdbConnectionPort } from "./duckdb-driver.types.js";
+import type { ObservabilityQueryRequest } from "@relkit/observability";
+/**
+ * Creates Promise query adapters for a scoped DuckDB connection.
+ *
+ * @param connection - Scoped database connection.
+ * @returns Query operations retaining the public Promise signatures.
+ * @example
+ * const query = createDuckdbQuery(connection);
+ * const page = await query.list("logs");
+ */
+export declare function createDuckdbQuery(connection: DuckdbConnectionPort): {
+    list: (kind: "logs" | "requests" | "traces", input?: ObservabilityQueryRequest) => Promise<import("@relkit/observability").ObservabilityQueryPage<import("@relkit/observability/local/record").StoredLocalRecord>>;
+    detail: (kind: "log" | "request" | "trace", id: string) => Promise<{
+        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>;
+};
+//# sourceMappingURL=duckdb-query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-query.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-query.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAIrE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,oBAAoB;iBAajD,MAAM,GAAG,UAAU,GAAG,QAAQ,UAAS,yBAAyB;mBAE9D,KAAK,GAAG,SAAS,GAAG,OAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEzD"}

package/dist/local/duckdb-query.js

@@ -0,0 +1,29 @@
+/**
+ * Owns duckdb query 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, Semaphore } from "effect";
+import { makeDuckdbQueryEffect } from "./duckdb-query-effect.js";
+import { DuckdbQueryError } from "./duckdb-query-error.js";
+import { ObservabilityQueryError } from "@relkit/observability";
+/**
+ * Creates Promise query adapters for a scoped DuckDB connection.
+ *
+ * @param connection - Scoped database connection.
+ * @returns Query operations retaining the public Promise signatures.
+ * @example
+ * const query = createDuckdbQuery(connection);
+ * const page = await query.list("logs");
+ */
+export function createDuckdbQuery(connection) {
+    const query = makeDuckdbQueryEffect(connection, Semaphore.makeUnsafe(1));
+    const run = (effect) => Effect.runPromise(effect.pipe(Effect.mapError((error) => error instanceof DuckdbQueryError
+        ? new ObservabilityQueryError(error.code, error.message)
+        : error)));
+    return {
+        list: (kind, input = {}) => run(query.list(kind, input)),
+        detail: (kind, id) => run(query.detail(kind, id)),
+    };
+}
+//# sourceMappingURL=duckdb-query.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-query.js","sourceRoot":"","sources":["../../src/local/duckdb-query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAgC;IAChE,MAAM,KAAK,GAAG,qBAAqB,CAAC,UAAU,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,MAAM,GAAG,GAAG,CAAO,MAA2B,EAAc,EAAE,CAC5D,MAAM,CAAC,UAAU,CACf,MAAM,CAAC,IAAI,CACT,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CACxB,KAAK,YAAY,gBAAgB;QAC/B,CAAC,CAAC,IAAI,uBAAuB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC;QACxD,CAAC,CAAC,KAAK,CACV,CACF,CACF,CAAC;IACJ,OAAO;QACL,IAAI,EAAE,CAAC,IAAoC,EAAE,QAAmC,EAAE,EAAE,EAAE,CACpF,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC9B,MAAM,EAAE,CAAC,IAAiC,EAAE,EAAU,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;KACvF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,6 @@
+/** Applies the existing history/receipt retention policy inside the caller's database permit. */
+import { Effect } from "effect";
+import type { DuckdbStorageState } from "./duckdb-storage-state.types.js";
+/** @param state - Store-owned connection and policy. @returns Typed retention completion; no database is acquired here. */
+export declare const retainDuckdbRecords: (state: DuckdbStorageState) => Effect.Effect<void, import("./duckdb-error.js").DuckdbError, never>;
+//# sourceMappingURL=duckdb-retention.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-retention.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-retention.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,OAAO,EAAS,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,2HAA2H;AAC3H,eAAO,MAAM,mBAAmB,oGA8B9B,CAAC"}

package/dist/local/duckdb-retention.js

@@ -0,0 +1,22 @@
+/** Applies the existing history/receipt retention policy inside the caller's database permit. */
+import { Clock, Effect } from "effect";
+import { observeDuckdb } from "./duckdb-metrics.js";
+import { runDuckdbSql } from "./duckdb-sql.js";
+/** @param state - Store-owned connection and policy. @returns Typed retention completion; no database is acquired here. */
+export const retainDuckdbRecords = Effect.fn("ObservabilityDuckdb.retain")(function* (state) {
+    return yield* observeDuckdb("retain", Effect.gen(function* () {
+        const now = yield* Clock.currentTimeMillis;
+        const age = state.retention.maxAgeMs ?? 7 * 24 * 60 * 60 * 1000;
+        const maximum = state.retention.maxBytes ?? 256 * 1024 * 1024;
+        const entries = state.retention.maxEntries ?? Number.MAX_SAFE_INTEGER;
+        yield* runDuckdbSql(state.connection, "retain", "DELETE FROM records WHERE recorded_at < ?", [
+            now - age,
+        ]);
+        yield* runDuckdbSql(state.connection, "retain", `DELETE FROM records WHERE id IN (
+        SELECT id FROM (SELECT id, sum(bytes) OVER (ORDER BY id DESC) AS total,
+        row_number() OVER (ORDER BY id DESC) AS position FROM records) WHERE total > ? OR position > ?
+      )`, [maximum, entries]);
+        yield* runDuckdbSql(state.connection, "retain", "DELETE FROM receipts WHERE received_at < ? AND NOT starts_with(key, 'legacy:')", [now - 7 * 24 * 60 * 60 * 1000]);
+    }));
+});
+//# sourceMappingURL=duckdb-retention.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-retention.js","sourceRoot":"","sources":["../../src/local/duckdb-retention.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,2HAA2H;AAC3H,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,EAAE,CAAC,4BAA4B,CAAC,CAAC,QAAQ,CAAC,EAClF,KAAyB;IAEzB,OAAO,KAAK,CAAC,CAAC,aAAa,CACzB,QAAQ,EACR,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;QAC3C,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,QAAQ,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAChE,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,QAAQ,IAAI,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;QAC9D,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,UAAU,IAAI,MAAM,CAAC,gBAAgB,CAAC;QACtE,KAAK,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,2CAA2C,EAAE;YAC3F,GAAG,GAAG,GAAG;SACV,CAAC,CAAC;QACH,KAAK,CAAC,CAAC,YAAY,CACjB,KAAK,CAAC,UAAU,EAChB,QAAQ,EACR;;;QAGA,EACA,CAAC,OAAO,EAAE,OAAO,CAAC,CACnB,CAAC;QACF,KAAK,CAAC,CAAC,YAAY,CACjB,KAAK,CAAC,UAAU,EAChB,QAAQ,EACR,gFAAgF,EAChF,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAChC,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;AACJ,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * Owns duckdb schema 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 type { DuckdbConnectionPort } from "./duckdb-driver.types.js";
+/**
+ * Initializes the local observability schema and checks compatibility.
+ *
+ * @param connection - Connection owned by the open database Scope.
+ * @returns An Effect completing after schema validation or a tagged error.
+ * @example
+ * yield* initializeDuckdbSchema(connection);
+ */
+export declare const initializeDuckdbSchema: (connection: DuckdbConnectionPort) => Effect.Effect<undefined, import("./duckdb-error.js").DuckdbError, never>;
+//# sourceMappingURL=duckdb-schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-schema.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,gHAoCjC,CAAC"}

package/dist/local/duckdb-schema.js

@@ -0,0 +1,39 @@
+/**
+ * Owns duckdb schema for the optional local history store.
+ * Shared records and query contracts come from lightweight observability; native
+ * handles and worker lifetimes remain owned by this storage package.
+ */
+import { Effect } from "effect";
+import { duckdbError } from "./duckdb-error.js";
+import { readDuckdbSql, runDuckdbSql } from "./duckdb-sql.js";
+/**
+ * Initializes the local observability schema and checks compatibility.
+ *
+ * @param connection - Connection owned by the open database Scope.
+ * @returns An Effect completing after schema validation or a tagged error.
+ * @example
+ * yield* initializeDuckdbSchema(connection);
+ */
+export const initializeDuckdbSchema = Effect.fn("ObservabilityDuckdb.schema")(function* (connection) {
+    yield* runDuckdbSql(connection, "schema", `
+    CREATE SEQUENCE IF NOT EXISTS record_ids;
+    CREATE TABLE IF NOT EXISTS records (
+      id BIGINT PRIMARY KEY DEFAULT nextval('record_ids'), origin VARCHAR NOT NULL,
+      signal VARCHAR NOT NULL, recorded_at BIGINT NOT NULL, received_at BIGINT NOT NULL,
+      request_id VARCHAR, origin_request_id VARCHAR, trace_id VARCHAR, span_id VARCHAR,
+      bytes BIGINT NOT NULL, payload JSON NOT NULL
+    );
+    CREATE TABLE IF NOT EXISTS receipts (key VARCHAR PRIMARY KEY, received_at BIGINT NOT NULL);
+    CREATE TABLE IF NOT EXISTS imports (source VARCHAR PRIMARY KEY, malformed BIGINT NOT NULL);
+    CREATE INDEX IF NOT EXISTS records_trace ON records(trace_id);
+    CREATE INDEX IF NOT EXISTS records_request ON records(request_id);
+    CREATE INDEX IF NOT EXISTS records_origin_request ON records(origin_request_id);
+    CREATE INDEX IF NOT EXISTS records_span ON records(trace_id, span_id);
+  `);
+    const result = yield* readDuckdbSql(connection, "schema", "SELECT name FROM pragma_table_info('records')");
+    const columns = result.getRowObjectsJson().map((row) => String(row.name));
+    for (const required of ["origin_request_id", "span_id"])
+        if (!columns.includes(required))
+            return yield* Effect.fail(duckdbError("schema", new Error("RELKIT_OBSERVABILITY_STATE_INCOMPATIBLE: use fresh development state")));
+});
+//# sourceMappingURL=duckdb-schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-schema.js","sourceRoot":"","sources":["../../src/local/duckdb-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC9D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,EAAE,CAAC,4BAA4B,CAAC,CAAC,QAAQ,CAAC,EACrF,UAAgC;IAEhC,KAAK,CAAC,CAAC,YAAY,CACjB,UAAU,EACV,QAAQ,EACR;;;;;;;;;;;;;;GAcD,CACA,CAAC;IACF,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,aAAa,CACjC,UAAU,EACV,QAAQ,EACR,+CAA+C,CAChD,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1E,KAAK,MAAM,QAAQ,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC;QACrD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC7B,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,WAAW,CACT,QAAQ,EACR,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAClF,CACF,CAAC;AACR,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,35 @@
+/**
+ * Owns duckdb sql 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 } from "@duckdb/node-api";
+import { Effect } from "effect";
+import type { DuckdbConnectionPort, DuckdbRows } from "./duckdb-driver.types.js";
+/**
+ * Runs one native SQL command without closing its connection during interruption.
+ * DuckDB's Promise API has no cancellation signal, so interruption waits for
+ * the native command to settle before Scope finalizers release the handles.
+ *
+ * @param connection - Scoped DuckDB connection.
+ * @param operation - Stable label for a typed failure.
+ * @param sql - SQL statement.
+ * @param values - Bound values.
+ * @returns An Effect completing after the native command or a DuckdbError.
+ * @example
+ * yield* runDuckdbSql(connection, "checkpoint", "CHECKPOINT");
+ */
+export declare const runDuckdbSql: (connection: DuckdbConnectionPort, operation: string, sql: string, values?: DuckDBValue[] | undefined) => Effect.Effect<void | import("@duckdb/node-api").DuckDBMaterializedResult, import("./duckdb-error.js").DuckdbError, never>;
+/**
+ * Reads rows from one native SQL command under the owning connection Scope.
+ *
+ * @param connection - Scoped DuckDB connection.
+ * @param operation - Stable label for a typed failure.
+ * @param sql - SQL query.
+ * @param values - Bound values.
+ * @returns An Effect with a completed row reader or a DuckdbError.
+ * @example
+ * const result = yield* readDuckdbSql(connection, "schema", "SELECT 1");
+ */
+export declare const readDuckdbSql: (connection: DuckdbConnectionPort, operation: string, sql: string, values?: DuckDBValue[] | undefined) => Effect.Effect<DuckdbRows, import("./duckdb-error.js").DuckdbError, never>;
+//# sourceMappingURL=duckdb-sql.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-sql.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-sql.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACjF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,qOAQxB,CAAC;AACF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,qLAazB,CAAC"}

package/dist/local/duckdb-sql.js

@@ -0,0 +1,35 @@
+import { Effect } from "effect";
+import { duckdbError } from "./duckdb-error.js";
+/**
+ * Runs one native SQL command without closing its connection during interruption.
+ * DuckDB's Promise API has no cancellation signal, so interruption waits for
+ * the native command to settle before Scope finalizers release the handles.
+ *
+ * @param connection - Scoped DuckDB connection.
+ * @param operation - Stable label for a typed failure.
+ * @param sql - SQL statement.
+ * @param values - Bound values.
+ * @returns An Effect completing after the native command or a DuckdbError.
+ * @example
+ * yield* runDuckdbSql(connection, "checkpoint", "CHECKPOINT");
+ */
+export const runDuckdbSql = Effect.fn("ObservabilityDuckdb.sql.run")((connection, operation, sql, values) => Effect.uninterruptible(Effect.tryPromise({
+    try: () => connection.run(sql, values),
+    catch: (cause) => duckdbError(operation, cause),
+})));
+/**
+ * Reads rows from one native SQL command under the owning connection Scope.
+ *
+ * @param connection - Scoped DuckDB connection.
+ * @param operation - Stable label for a typed failure.
+ * @param sql - SQL query.
+ * @param values - Bound values.
+ * @returns An Effect with a completed row reader or a DuckdbError.
+ * @example
+ * const result = yield* readDuckdbSql(connection, "schema", "SELECT 1");
+ */
+export const readDuckdbSql = Effect.fn("ObservabilityDuckdb.sql.read")((connection, operation, sql, values) => Effect.uninterruptible(Effect.tryPromise({
+    try: () => connection.runAndReadAll(sql, values),
+    catch: (cause) => duckdbError(operation, cause),
+})));
+//# sourceMappingURL=duckdb-sql.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-sql.js","sourceRoot":"","sources":["../../src/local/duckdb-sql.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,EAAE,CAAC,6BAA6B,CAAC,CAClE,CAAC,UAAgC,EAAE,SAAiB,EAAE,GAAW,EAAE,MAAsB,EAAE,EAAE,CAC3F,MAAM,CAAC,eAAe,CACpB,MAAM,CAAC,UAAU,CAAC;IAChB,GAAG,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC;IACtC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,KAAK,CAAC;CAChD,CAAC,CACH,CACJ,CAAC;AACF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC,8BAA8B,CAAC,CACpE,CACE,UAAgC,EAChC,SAAiB,EACjB,GAAW,EACX,MAAsB,EACqC,EAAE,CAC7D,MAAM,CAAC,eAAe,CACpB,MAAM,CAAC,UAAU,CAAC;IAChB,GAAG,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC;IAChD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,KAAK,CAAC;CAChD,CAAC,CACH,CACJ,CAAC"}

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

@@ -0,0 +1,12 @@
+/** Retention/redaction policy captured by one serialized native history store. */
+import type { Semaphore } from "effect";
+import type { RedactionPolicy, TelemetryLocalRetentionPolicy } from "@relkit/observability";
+import type { DuckdbConnectionPort } from "./duckdb-driver.types.js";
+/** Mutable configuration shares the same permit as writes and queries. */
+export interface DuckdbStorageState {
+    readonly connection: DuckdbConnectionPort;
+    readonly permit: Semaphore.Semaphore;
+    retention: TelemetryLocalRetentionPolicy;
+    redaction: RedactionPolicy | undefined;
+}
+//# sourceMappingURL=duckdb-storage-state.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-storage-state.types.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-storage-state.types.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC;IACrC,SAAS,EAAE,6BAA6B,CAAC;IACzC,SAAS,EAAE,eAAe,GAAG,SAAS,CAAC;CACxC"}

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

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

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

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

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

@@ -0,0 +1,8 @@
+/** Composes serialized append, retention configuration and checkpoint operations for one native history owner. */
+import { type Semaphore } from "effect";
+import type { RedactionPolicy, TelemetryLocalRetentionPolicy } from "@relkit/observability";
+import type { DuckdbConnectionPort } from "./duckdb-driver.types.js";
+import type { DuckdbStorageEffects } from "./duckdb-storage.types.js";
+/** @param connection - Scoped native connection. @param permit - Shared database serialization. @param configured - Retention policy. @param initialRedaction - Admission policy. @returns Native store capabilities. */
+export declare function makeDuckdbStorage(connection: DuckdbConnectionPort, permit: Semaphore.Semaphore, configured: TelemetryLocalRetentionPolicy, initialRedaction?: RedactionPolicy): DuckdbStorageEffects;
+//# sourceMappingURL=duckdb-storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-storage.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-storage.ts"],"names":[],"mappings":"AAAA,kHAAkH;AAClH,OAAO,EAAU,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAMtE,yNAAyN;AACzN,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,oBAAoB,EAChC,MAAM,EAAE,SAAS,CAAC,SAAS,EAC3B,UAAU,EAAE,6BAA6B,EACzC,gBAAgB,CAAC,EAAE,eAAe,GACjC,oBAAoB,CAqCtB"}