@plumix/core 0.4.0 → 0.5.0

package/dist/debug-bar/collector.js

@@ -1,80 +0,0 @@
-import { NOOP_DEBUG } from "../context/debug.js";
-import { traceStore } from "../context/stores.js";
-import { normalizeDebugBar } from "./config.js";
-function isThenable(value) {
-    return (value != null && typeof value.then === "function");
-}
-/**
- * The real, dev-only debug collector. Accumulates per-namespace entries and a
- * span tree for the request. Created only under the dev gate; production uses
- * {@link NOOP_DEBUG} instead, so this module tree-shakes out of prod builds.
- */
-export function createDebugCollector(debugBar) {
-    const { enabled, disabled } = normalizeDebugBar(debugBar);
-    // Globally disabled in dev: skip all collection overhead, not just render.
-    if (!enabled)
-        return NOOP_DEBUG;
-    const entries = new Map();
-    const roots = [];
-    return {
-        record(namespace, entry) {
-            // A disabled panel stops collecting too (not just rendering): its
-            // namespace is its panel id, so denylisted namespaces drop at the source.
-            if (disabled.has(namespace))
-                return;
-            const bucket = entries.get(namespace);
-            if (bucket)
-                bucket.push(entry);
-            else
-                entries.set(namespace, [entry]);
-        },
-        span(name, fn) {
-            const startedAt = Date.now();
-            const span = {
-                name,
-                startedAt,
-                durationMs: 0,
-                children: [],
-                annotations: {},
-            };
-            // Attach to the enclosing span (via AsyncLocalStorage) so nesting
-            // reflects call structure; top-level spans become roots.
-            const parent = traceStore.getStore();
-            if (parent)
-                parent.children.push(span);
-            else
-                roots.push(span);
-            const stamp = () => {
-                span.durationMs = Date.now() - startedAt;
-            };
-            let result;
-            try {
-                result = traceStore.run(span, fn);
-            }
-            catch (error) {
-                stamp();
-                throw error;
-            }
-            // Await async work before stamping so I/O time is measured, not just the
-            // synchronous prelude. Nesting already survives awaits via ALS.
-            if (isThenable(result)) {
-                return result.then((value) => {
-                    stamp();
-                    return value;
-                }, (error) => {
-                    stamp();
-                    throw error;
-                });
-            }
-            stamp();
-            return result;
-        },
-        get(namespace) {
-            return entries.get(namespace) ?? [];
-        },
-        getSpans() {
-            return roots;
-        },
-    };
-}
-//# sourceMappingURL=collector.js.map

package/dist/debug-bar/collector.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"collector.js","sourceRoot":"","sources":["../../src/debug-bar/collector.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,CACL,KAAK,IAAI,IAAI,IAAI,OAAQ,KAA8B,CAAC,IAAI,KAAK,UAAU,CAC5E,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAmC;IAEnC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC1D,2EAA2E;IAC3E,IAAI,CAAC,OAAO;QAAE,OAAO,UAAU,CAAC;IAEhC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC7C,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,OAAO;QACL,MAAM,CAAC,SAAS,EAAE,KAAK;YACrB,kEAAkE;YAClE,0EAA0E;YAC1E,IAAI,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC;gBAAE,OAAO;YACpC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACtC,IAAI,MAAM;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;;gBAC1B,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,EAAE;YACX,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAc;gBACtB,IAAI;gBACJ,SAAS;gBACT,UAAU,EAAE,CAAC;gBACb,QAAQ,EAAE,EAAE;gBACZ,WAAW,EAAE,EAAE;aAChB,CAAC;YACF,kEAAkE;YAClE,yDAAyD;YACzD,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC;YACrC,IAAI,MAAM;gBAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;gBAClC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,MAAM,KAAK,GAAG,GAAS,EAAE;gBACvB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAC3C,CAAC,CAAC;YACF,IAAI,MAA6B,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACpC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,KAAK,EAAE,CAAC;gBACR,MAAM,KAAK,CAAC;YACd,CAAC;YACD,yEAAyE;YACzE,gEAAgE;YAChE,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBACvB,OAAO,MAAM,CAAC,IAAI,CAChB,CAAC,KAAK,EAAE,EAAE;oBACR,KAAK,EAAE,CAAC;oBACR,OAAO,KAAK,CAAC;gBACf,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;oBACR,KAAK,EAAE,CAAC;oBACR,MAAM,KAAK,CAAC;gBACd,CAAC,CACuB,CAAC;YAC7B,CAAC;YACD,KAAK,EAAE,CAAC;YACR,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,GAAG,CAAC,SAAS;YACX,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACtC,CAAC;QACD,QAAQ;YACN,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/debug-bar/db-query.d.ts

@@ -1,21 +0,0 @@
-import type { Logger } from "drizzle-orm";
-/** Panel id + collector namespace for database queries. */
-export declare const DB_PANEL_ID = "database";
-export interface DbQueryEntry {
-    readonly sql: string;
-    readonly params: readonly unknown[];
-}
-/**
- * A drizzle `Logger` that feeds the Database panel. Pass it as the `logger`
- * option to `drizzle(...)` (dev-gated) — one uniform mechanism across every
- * driver, giving the `?`-form SQL plus the bound params. It reaches the
- * request's collector via the request-store ALS, so it's a no-op outside a
- * request (and in prod, where `ctx.debug` is the no-op collector). Per-query
- * timing is not part of drizzle's logger contract; the Timeline panel measures
- * it via spans instead.
- *
- * Driver-agnostic and free of any driver type import, so it can be shared with
- * runtime adapters (D1) over a narrow subpath without dragging libsql types in.
- */
-export declare function createDebugSqlLogger(): Logger;
-//# sourceMappingURL=db-query.d.ts.map

package/dist/debug-bar/db-query.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"db-query.d.ts","sourceRoot":"","sources":["../../src/debug-bar/db-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAI1C,2DAA2D;AAC3D,eAAO,MAAM,WAAW,aAAa,CAAC;AAEtC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;CACrC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAM7C"}

package/dist/debug-bar/db-query.js

@@ -1,23 +0,0 @@
-import { tryGetContext } from "../context/stores.js";
-/** Panel id + collector namespace for database queries. */
-export const DB_PANEL_ID = "database";
-/**
- * A drizzle `Logger` that feeds the Database panel. Pass it as the `logger`
- * option to `drizzle(...)` (dev-gated) — one uniform mechanism across every
- * driver, giving the `?`-form SQL plus the bound params. It reaches the
- * request's collector via the request-store ALS, so it's a no-op outside a
- * request (and in prod, where `ctx.debug` is the no-op collector). Per-query
- * timing is not part of drizzle's logger contract; the Timeline panel measures
- * it via spans instead.
- *
- * Driver-agnostic and free of any driver type import, so it can be shared with
- * runtime adapters (D1) over a narrow subpath without dragging libsql types in.
- */
-export function createDebugSqlLogger() {
-    return {
-        logQuery(sql, params) {
-            tryGetContext()?.debug.record(DB_PANEL_ID, { sql, params });
-        },
-    };
-}
-//# sourceMappingURL=db-query.js.map

package/dist/debug-bar/db-query.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"db-query.js","sourceRoot":"","sources":["../../src/debug-bar/db-query.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AAOtC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,QAAQ,CAAC,GAAG,EAAE,MAAM;YAClB,aAAa,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/debug-bar/trace-libsql.d.ts

@@ -1,18 +0,0 @@
-import type { Client } from "@libsql/client";
-/**
- * Wraps a libsql client so every `execute` runs inside a timed `ctx.debug.span`
- * — the Timeline panel's source of per-query durations, which drizzle's logger
- * contract can't provide. Dev-only (call it behind the `PLUMIX_DEV` gate); a
- * no-op outside a request, and tree-shaken from prod along with its callers.
- *
- * Lives apart from the driver-agnostic query logger so the libsql type import
- * stays out of adapters that don't use libsql (e.g. the D1 runtime).
- *
- * Assumes drizzle's single-argument call convention (`execute(stmt)`,
- * `batch(stmts)`); it forwards only that first argument, so a direct
- * `execute(sql, args)` call would drop its params. Queries inside a drizzle
- * transaction run through `tx.execute` and aren't timed — acceptable for a dev
- * panel.
- */
-export declare function traceSqlClient(client: Client): Client;
-//# sourceMappingURL=trace-libsql.d.ts.map

package/dist/debug-bar/trace-libsql.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"trace-libsql.d.ts","sourceRoot":"","sources":["../../src/debug-bar/trace-libsql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,gBAAgB,CAAC;AAK1D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA0BrD"}

package/dist/debug-bar/trace-libsql.js

@@ -1,42 +0,0 @@
-import { tryGetContext } from "../context/stores.js";
-import { queryKind } from "./highlight-sql.js";
-/**
- * Wraps a libsql client so every `execute` runs inside a timed `ctx.debug.span`
- * — the Timeline panel's source of per-query durations, which drizzle's logger
- * contract can't provide. Dev-only (call it behind the `PLUMIX_DEV` gate); a
- * no-op outside a request, and tree-shaken from prod along with its callers.
- *
- * Lives apart from the driver-agnostic query logger so the libsql type import
- * stays out of adapters that don't use libsql (e.g. the D1 runtime).
- *
- * Assumes drizzle's single-argument call convention (`execute(stmt)`,
- * `batch(stmts)`); it forwards only that first argument, so a direct
- * `execute(sql, args)` call would drop its params. Queries inside a drizzle
- * transaction run through `tx.execute` and aren't timed — acceptable for a dev
- * panel.
- */
-export function traceSqlClient(client) {
-    const stmtSql = (stmt) => typeof stmt === "string" ? stmt : stmt.sql;
-    const rawExecute = client.execute.bind(client);
-    client.execute = (stmt) => {
-        const ctx = tryGetContext();
-        const run = () => rawExecute(stmt);
-        if (!ctx)
-            return run();
-        return ctx.debug.span(`db: ${queryKind(stmtSql(stmt))}`, run);
-    };
-    // Relational reads and transactions run as one batched round-trip; time the
-    // whole batch as a single span (labelled by kind when uniform).
-    const rawBatch = client.batch.bind(client);
-    client.batch = (stmts, ...rest) => {
-        const ctx = tryGetContext();
-        const run = () => rawBatch(stmts, ...rest);
-        if (!ctx || !Array.isArray(stmts))
-            return run();
-        const kinds = new Set(stmts.map((stmt) => queryKind(stmtSql(stmt))));
-        const label = kinds.size === 1 ? `db: ${[...kinds][0]}` : "db: batch";
-        return ctx.debug.span(`${label} (${stmts.length})`, run);
-    };
-    return client;
-}
-//# sourceMappingURL=trace-libsql.js.map

package/dist/debug-bar/trace-libsql.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"trace-libsql.js","sourceRoot":"","sources":["../../src/debug-bar/trace-libsql.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,OAAO,GAAG,CAAC,IAAiB,EAAU,EAAE,CAC5C,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;IAE7C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,CAAC,OAAO,GAAG,CAAC,IAAiB,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,GAAkC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAClE,IAAI,CAAC,GAAG;YAAE,OAAO,GAAG,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAChE,CAAC,CAAC;IAEF,4EAA4E;IAC5E,gEAAgE;IAChE,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,CAAC,KAAK,GAAG,CAAC,KAAoB,EAAE,GAAG,IAAe,EAAE,EAAE;QAC1D,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,GAAgC,EAAE,CAC5C,QAAQ,CAAC,KAAK,EAAE,GAAI,IAAgB,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,GAAG,EAAE,CAAC;QAChD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;QACtE,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,KAAK,KAAK,CAAC,MAAM,GAAG,EAAE,GAAG,CAAC,CAAC;IAC3D,CAAC,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}