@plumix/core 0.1.0

package/dist/context/app.js

@@ -0,0 +1,149 @@
+import { createBlockRegistry } from "@plumix/blocks";
+import { defaultAuthenticator } from "../auth/authenticator.js";
+import { resolveMailer } from "../auth/mailer/resolve.js";
+import { createCapabilityResolver } from "../auth/rbac.js";
+import { resolveLocales } from "../i18n/locale-registry.js";
+import { resolveLocale } from "../i18n/resolve-locale.js";
+import { ContextError } from "./errors.js";
+const EMPTY_BLOCK_REGISTRY = createBlockRegistry([]);
+const EMPTY_MARK_LIST = Object.freeze([]);
+const EMPTY_SHORTCODE_REGISTRY = new Map();
+const DEFAULT_I18N = resolveLocales({
+    defaultLocale: "en",
+    locales: ["en"],
+});
+function logRejection(logger, error) {
+    // Both the error message and the raw value land in the log — the
+    // message is the grep-friendly bit; the raw value (with stack) goes
+    // through the logger's `meta` channel for structured backends.
+    // Wrapped in try/catch because a custom logger backend can throw
+    // (broken transport, fs full, etc.); a fire-and-forget task must
+    // not surface a downstream rejection just because logging failed.
+    const message = errorMessage(error);
+    try {
+        logger.error(`[plumix] deferred promise rejected: ${message}`, {
+            error,
+        });
+    }
+    catch {
+        // Best-effort logging — swallow.
+    }
+}
+function errorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === "string")
+        return error;
+    return String(error);
+}
+function wrapDefer(logger, target) {
+    // Wrap the caller's `defer` so the inner promise's rejection is
+    // logged through the configured logger before the runtime sees it.
+    // Runtimes (cloudflare, tests) only handle the success path —
+    // logging is centralised here so an operator's structured logger
+    // always wins.
+    return (promise) => {
+        const handled = promise.catch((error) => {
+            logRejection(logger, error);
+        });
+        if (target === undefined) {
+            void handled;
+            return;
+        }
+        target(handled);
+    };
+}
+function makeAuthCan(resolver, user, tokenScopes) {
+    if (user === null)
+        return () => false;
+    if (tokenScopes === null) {
+        return (capability) => resolver.hasCapability(user.role, capability);
+    }
+    // Pre-build the Set so each can() call is O(1) instead of O(scopes).
+    // Token-authed requests are the hot path; the Set is per-request,
+    // tiny, and sees ≥1 lookups per request typically.
+    const scopeSet = new Set(tokenScopes);
+    return (capability) => scopeSet.has(capability) && resolver.hasCapability(user.role, capability);
+}
+export function createAppContext(args) {
+    const resolver = createCapabilityResolver(args.plugins);
+    const user = args.user ?? null;
+    const tokenScopes = args.tokenScopes ?? null;
+    const i18n = args.i18n ?? DEFAULT_I18N;
+    const locale = resolveLocale({ request: args.request, user, i18n });
+    const base = {
+        db: args.db,
+        env: args.env,
+        request: args.request,
+        user,
+        tokenScopes,
+        hooks: args.hooks,
+        plugins: args.plugins,
+        blocks: args.blocks ?? EMPTY_BLOCK_REGISTRY,
+        marks: args.marks ?? EMPTY_MARK_LIST,
+        shortcodes: args.shortcodes ?? EMPTY_SHORTCODE_REGISTRY,
+        logger: args.logger ?? consoleLogger,
+        auth: {
+            can: makeAuthCan(resolver, user, tokenScopes),
+        },
+        defer: wrapDefer(args.logger ?? consoleLogger, args.defer),
+        assets: args.assets,
+        storage: args.storage,
+        cache: args.cache,
+        imageDelivery: args.imageDelivery,
+        imageRemotePatterns: args.imageRemotePatterns,
+        mailer: resolveMailer(args.mailer, args.env),
+        i18n,
+        locale,
+        oauthProviders: args.oauthProviders ?? [],
+        authenticator: args.authenticator ?? defaultAuthenticator(),
+        bootstrapAllowed: args.bootstrapAllowed ?? false,
+        resolvedEntity: null,
+        // Best-effort fallback for tests / runtimes that don't pass an
+        // explicit origin: derive from the inbound request URL. Production
+        // always passes the canonical operator-set origin so URLs in
+        // outgoing email are stable across worker geos.
+        origin: args.origin ?? new URL(args.request.url).origin,
+        basePath: args.basePath ?? "",
+        siteName: args.siteName,
+    };
+    // Spread plugin-contributed entries onto the base. The cast is the
+    // unavoidable seam between an open `Record`-of-unknown registry and
+    // the `AppContextExtensions` declaration-merge type — plugin authors
+    // augment the latter, the dispatcher feeds the former.
+    if (args.appContextExtensions !== undefined) {
+        const target = base;
+        for (const [key, entry] of args.appContextExtensions) {
+            // Defense in depth — `extendAppContext` already rejects these at
+            // registration time. Throwing here means a malformed map (built
+            // by a test or dev tool that bypasses the registration guard)
+            // fails fast on the first request rather than silently
+            // corrupting `db` / `auth` / etc. for the rest of the process.
+            if (key in target) {
+                throw ContextError.appContextExtensionShadowsBuiltin(key);
+            }
+            target[key] = entry.value;
+        }
+    }
+    return base;
+}
+export function withUser(ctx, user, tokenScopes = null) {
+    const resolver = createCapabilityResolver(ctx.plugins);
+    return {
+        ...ctx,
+        user,
+        tokenScopes,
+        auth: {
+            can: makeAuthCan(resolver, user, tokenScopes),
+        },
+        oauthProviders: ctx.oauthProviders,
+        locale: resolveLocale({ request: ctx.request, user, i18n: ctx.i18n }),
+    };
+}
+export const consoleLogger = {
+    debug: (m, meta) => console.debug(m, meta ?? ""),
+    info: (m, meta) => console.info(m, meta ?? ""),
+    warn: (m, meta) => console.warn(m, meta ?? ""),
+    error: (m, meta) => console.error(m, meta ?? ""),
+};
+//# sourceMappingURL=app.js.map

package/dist/context/app.js.map

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

package/dist/context/errors.d.ts

@@ -0,0 +1,16 @@
+type ContextErrorCode = "no_request_context" | "app_context_extension_shadows_builtin";
+/**
+ * Request/app-context invariant violated. `no_request_context` means an
+ * accessor ran outside `requestStore.run()`; the shadow code means a
+ * malformed extension map reached context assembly. Named-error convention
+ * (#232).
+ */
+export declare class ContextError extends Error {
+    readonly code: ContextErrorCode;
+    readonly key: string | undefined;
+    private constructor();
+    static noRequestContext(): ContextError;
+    static appContextExtensionShadowsBuiltin(key: string): ContextError;
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/context/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/context/errors.ts"],"names":[],"mappings":"AAAA,KAAK,gBAAgB,GACnB,oBAAoB,GAAG,uCAAuC,CAAC;AAEjE;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,KAAK;IAKrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjC,OAAO;IAMP,MAAM,CAAC,gBAAgB,IAAI,YAAY;IAOvC,MAAM,CAAC,iCAAiC,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY;CASpE"}

package/dist/context/errors.js

@@ -0,0 +1,27 @@
+/**
+ * Request/app-context invariant violated. `no_request_context` means an
+ * accessor ran outside `requestStore.run()`; the shadow code means a
+ * malformed extension map reached context assembly. Named-error convention
+ * (#232).
+ */
+export class ContextError extends Error {
+    static {
+        ContextError.prototype.name = "ContextError";
+    }
+    code;
+    key;
+    constructor(code, message, key) {
+        super(message);
+        this.code = code;
+        this.key = key;
+    }
+    static noRequestContext() {
+        return new ContextError("no_request_context", "No request context — getContext() called outside requestStore.run()");
+    }
+    static appContextExtensionShadowsBuiltin(key) {
+        return new ContextError("app_context_extension_shadows_builtin", `appContextExtensions entry "${key}" shadows a built-in ` +
+            `AppContext field. Reserve plugin-scoped names; built-in ` +
+            `members like \`db\` and \`auth\` aren't extendable.`, key);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/context/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/context/errors.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC;QACE,YAAY,CAAC,SAAS,CAAC,IAAI,GAAG,cAAc,CAAC;IAC/C,CAAC;IAEQ,IAAI,CAAmB;IACvB,GAAG,CAAqB;IAEjC,YAAoB,IAAsB,EAAE,OAAe,EAAE,GAAY;QACvE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,gBAAgB;QACrB,OAAO,IAAI,YAAY,CACrB,oBAAoB,EACpB,qEAAqE,CACtE,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,iCAAiC,CAAC,GAAW;QAClD,OAAO,IAAI,YAAY,CACrB,uCAAuC,EACvC,+BAA+B,GAAG,uBAAuB;YACvD,0DAA0D;YAC1D,qDAAqD,EACvD,GAAG,CACJ,CAAC;IACJ,CAAC;CACF"}

package/dist/context/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./app.js";
+export * from "./stores.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}

package/dist/context/index.js

@@ -0,0 +1,3 @@
+export * from "./app.js";
+export * from "./stores.js";
+//# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}

package/dist/context/stores.d.ts

@@ -0,0 +1,19 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import type { AppContext } from "./app.js";
+export declare const requestStore: AsyncLocalStorage<AppContext>;
+export interface HookFrame {
+    readonly hook: string;
+    readonly plugin: string | null;
+}
+export declare const hookStore: AsyncLocalStorage<HookFrame>;
+export interface TraceSpan {
+    readonly name: string;
+    readonly startedAt: number;
+    readonly children: TraceSpan[];
+    readonly annotations: Record<string, unknown>;
+}
+export declare const traceStore: AsyncLocalStorage<TraceSpan>;
+export declare const txStore: AsyncLocalStorage<unknown>;
+export declare function getContext(): AppContext;
+export declare function tryGetContext(): AppContext | null;
+//# sourceMappingURL=stores.d.ts.map

package/dist/context/stores.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stores.d.ts","sourceRoot":"","sources":["../../src/context/stores.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C,eAAO,MAAM,YAAY,+BAAsC,CAAC;AAEhE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,eAAO,MAAM,SAAS,8BAAqC,CAAC;AAE5D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/C;AAED,eAAO,MAAM,UAAU,8BAAqC,CAAC;AAE7D,eAAO,MAAM,OAAO,4BAAmC,CAAC;AAExD,wBAAgB,UAAU,IAAI,UAAU,CAIvC;AAED,wBAAgB,aAAa,IAAI,UAAU,GAAG,IAAI,CAEjD"}

package/dist/context/stores.js

@@ -0,0 +1,19 @@
+// `node:async_hooks` is supported on Node, Bun, Deno (Node-compat), and
+// Cloudflare Workers (with `nodejs_compat` — already required by Plumix).
+// When TC39 AsyncContext ships, swap the import here; consumers stay unchanged.
+import { AsyncLocalStorage } from "node:async_hooks";
+import { ContextError } from "./errors.js";
+export const requestStore = new AsyncLocalStorage();
+export const hookStore = new AsyncLocalStorage();
+export const traceStore = new AsyncLocalStorage();
+export const txStore = new AsyncLocalStorage();
+export function getContext() {
+    const ctx = requestStore.getStore();
+    if (!ctx)
+        throw ContextError.noRequestContext();
+    return ctx;
+}
+export function tryGetContext() {
+    return requestStore.getStore() ?? null;
+}
+//# sourceMappingURL=stores.js.map

package/dist/context/stores.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stores.js","sourceRoot":"","sources":["../../src/context/stores.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,0EAA0E;AAC1E,gFAAgF;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,iBAAiB,EAAc,CAAC;AAOhE,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,iBAAiB,EAAa,CAAC;AAS5D,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,iBAAiB,EAAa,CAAC;AAE7D,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAW,CAAC;AAExD,MAAM,UAAU,UAAU;IACxB,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;IACpC,IAAI,CAAC,GAAG;QAAE,MAAM,YAAY,CAAC,gBAAgB,EAAE,CAAC;IAChD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,YAAY,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC;AACzC,CAAC"}

package/dist/db/errors.d.ts

@@ -0,0 +1,2 @@
+export declare function isUniqueConstraintError(error: unknown): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/db/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/db/errors.ts"],"names":[],"mappings":"AA+DA,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAU/D"}

package/dist/db/errors.js

@@ -0,0 +1,69 @@
+// Unique-constraint detection across every SQLite driver plumix runs on:
+// better-sqlite3 (Node), node:sqlite (Node 22+), bun:sqlite, libsql,
+// Cloudflare D1, Deno's @db/sqlite. Each exposes the constraint violation
+// in a different field; drizzle-orm may wrap the driver error with `.cause`
+// N levels deep. The detector below checks every known shape and falls
+// back to the SQLite-produced message substring, which is the one thing
+// every driver surfaces verbatim.
+// Extended SQLite result codes for UNIQUE / PRIMARYKEY violations. See
+// https://www.sqlite.org/rescode.html — "SQLITE_CONSTRAINT_UNIQUE" (2067)
+// and "SQLITE_CONSTRAINT_PRIMARYKEY" (1555).
+const CONSTRAINT_CODE_STRINGS = new Set([
+    "SQLITE_CONSTRAINT_UNIQUE",
+    "SQLITE_CONSTRAINT_PRIMARYKEY",
+]);
+const CONSTRAINT_CODE_NUMBERS = new Set([2067, 1555]);
+// Max depth of `.cause` walk. Drizzle-orm typically wraps once, libsql twice,
+// D1-through-drizzle can stack three or four. Six gives us headroom without
+// letting a pathological cycle (bug in a driver) loop forever.
+const MAX_CAUSE_DEPTH = 6;
+// Every field name we've seen a SQLite driver put the result code on.
+// String fields hold extended-code strings ("SQLITE_CONSTRAINT_UNIQUE");
+// number fields hold numeric extended codes (2067 / 1555). Adding a new
+// driver is a one-row append to whichever list matches its shape.
+const STRING_CODE_FIELDS = ["code", "extendedCode"];
+const NUMBER_CODE_FIELDS = ["errno", "errcode", "resultCode"];
+function hasUniqueCode(error) {
+    if (!error || typeof error !== "object")
+        return false;
+    const err = error;
+    for (const field of STRING_CODE_FIELDS) {
+        const value = err[field];
+        if (typeof value === "string" && CONSTRAINT_CODE_STRINGS.has(value)) {
+            return true;
+        }
+    }
+    for (const field of NUMBER_CODE_FIELDS) {
+        const value = err[field];
+        if (typeof value === "number" && CONSTRAINT_CODE_NUMBERS.has(value)) {
+            return true;
+        }
+    }
+    // Universal fallback: SQLite's core produces "UNIQUE constraint failed: …"
+    // verbatim; every driver we've audited includes it in the message.
+    // Cloudflare D1 relies entirely on this path (no structured codes at all).
+    //
+    // Colon-anchored to avoid matching a stray substring in an unrelated
+    // wrapper message ("... UNIQUE constraint failed would be bad ...");
+    // SQLite always emits the phrase followed by `": table.column"`.
+    const message = err.message;
+    if (typeof message === "string" &&
+        message.includes("UNIQUE constraint failed:")) {
+        return true;
+    }
+    return false;
+}
+export function isUniqueConstraintError(error) {
+    const seen = new Set();
+    let current = error;
+    for (let depth = 0; depth < MAX_CAUSE_DEPTH && current; depth++) {
+        if (seen.has(current))
+            return false; // cycle guard
+        seen.add(current);
+        if (hasUniqueCode(current))
+            return true;
+        current = current.cause;
+    }
+    return false;
+}
+//# sourceMappingURL=errors.js.map

package/dist/db/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/db/errors.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,qEAAqE;AACrE,0EAA0E;AAC1E,4EAA4E;AAC5E,uEAAuE;AACvE,wEAAwE;AACxE,kCAAkC;AAElC,uEAAuE;AACvE,0EAA0E;AAC1E,6CAA6C;AAC7C,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC;IACtC,0BAA0B;IAC1B,8BAA8B;CAC/B,CAAC,CAAC;AACH,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAEtD,8EAA8E;AAC9E,4EAA4E;AAC5E,+DAA+D;AAC/D,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,sEAAsE;AACtE,yEAAyE;AACzE,wEAAwE;AACxE,kEAAkE;AAClE,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,cAAc,CAAU,CAAC;AAC7D,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,YAAY,CAAU,CAAC;AAEvE,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAE7C,KAAK,MAAM,KAAK,IAAI,kBAAkB,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACpE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,kBAAkB,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACpE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,2EAA2E;IAC3E,mEAAmE;IACnE,2EAA2E;IAC3E,EAAE;IACF,qEAAqE;IACrE,qEAAqE;IACrE,iEAAiE;IACjE,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAC5B,IACE,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAC,EAC7C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAC;IAChC,IAAI,OAAO,GAAY,KAAK,CAAC;IAC7B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,eAAe,IAAI,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC;QAChE,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC,CAAC,cAAc;QACnD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClB,IAAI,aAAa,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QACxC,OAAO,GAAI,OAA+B,CAAC,KAAK,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/db/index.d.ts

@@ -0,0 +1,4 @@
+export * from "drizzle-orm/sql";
+export type { InferInsertModel, InferSelectModel } from "drizzle-orm";
+export { isUniqueConstraintError } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/db/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC"}

package/dist/db/index.js

@@ -0,0 +1,3 @@
+export * from "drizzle-orm/sql";
+export { isUniqueConstraintError } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/db/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAEhC,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC"}

package/dist/db/libsql.d.ts

@@ -0,0 +1,30 @@
+import type { EnvInput } from "../runtime/env-input.js";
+import type { DatabaseAdapter } from "../runtime/slots.js";
+export interface LibsqlConfig {
+    /**
+     * libSQL connection URL — `file:./data.db`, `:memory:`, or a remote
+     * `libsql://` / `https://` endpoint (Turso, self-hosted sqld, …).
+     */
+    readonly url: string;
+    readonly authToken?: string;
+}
+/**
+ * Literal connection config, or an `(env) => LibsqlConfig` resolver for the
+ * Workers case where the auth token only exists in the per-request `env`. See
+ * {@link EnvInput} for the shared union + the typed `env`.
+ */
+export type LibsqlConfigInput = EnvInput<LibsqlConfig>;
+export interface LibsqlDatabaseAdapter extends DatabaseAdapter {
+    readonly config: LibsqlConfigInput;
+}
+/**
+ * Database adapter for any libSQL-compatible SQLite endpoint. Lives behind
+ * the `@plumix/core/db/libsql` subpath so the driver only loads when this
+ * adapter is imported — D1 deployments never pull it into their bundle.
+ *
+ * Single endpoint, strong consistency: no `connectRequest` read-replica hook
+ * (that's D1's Sessions API), and no `requiredBindings` since the connection
+ * comes from config rather than a runtime env binding.
+ */
+export declare function libsql(config: LibsqlConfigInput): LibsqlDatabaseAdapter;
+//# sourceMappingURL=libsql.d.ts.map

package/dist/db/libsql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libsql.d.ts","sourceRoot":"","sources":["../../src/db/libsql.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;AAEvD,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,qBAAqB,CAmBvE"}

package/dist/db/libsql.js

@@ -0,0 +1,33 @@
+import { createClient } from "@libsql/client";
+import { drizzle } from "drizzle-orm/libsql";
+import { resolveEnvInput } from "../runtime/env-input.js";
+/**
+ * Database adapter for any libSQL-compatible SQLite endpoint. Lives behind
+ * the `@plumix/core/db/libsql` subpath so the driver only loads when this
+ * adapter is imported — D1 deployments never pull it into their bundle.
+ *
+ * Single endpoint, strong consistency: no `connectRequest` read-replica hook
+ * (that's D1's Sessions API), and no `requiredBindings` since the connection
+ * comes from config rather than a runtime env binding.
+ */
+export function libsql(config) {
+    // Built on first connect, not in the factory, because a resolver needs the
+    // request-time `env`; reused across requests since the client owns a
+    // connection pipeline. `env` is isolate-stable, so the first value holds.
+    let client;
+    return {
+        kind: "libsql",
+        config,
+        connect: (env, _request, schema) => {
+            if (!client) {
+                const resolved = resolveEnvInput(config, env);
+                client = createClient({
+                    url: resolved.url,
+                    authToken: resolved.authToken,
+                });
+            }
+            return { db: drizzle(client, { schema, casing: "snake_case" }) };
+        },
+    };
+}
+//# sourceMappingURL=libsql.js.map

package/dist/db/libsql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"libsql.js","sourceRoot":"","sources":["../../src/db/libsql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAK7C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAsB1D;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CAAC,MAAyB;IAC9C,2EAA2E;IAC3E,qEAAqE;IACrE,0EAA0E;IAC1E,IAAI,MAAmD,CAAC;IACxD,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,MAAM;QACN,OAAO,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;YACjC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,EAAE,GAAgB,CAAC,CAAC;gBAC3D,MAAM,GAAG,YAAY,CAAC;oBACpB,GAAG,EAAE,QAAQ,CAAC,GAAG;oBACjB,SAAS,EAAE,QAAQ,CAAC,SAAS;iBAC9B,CAAC,CAAC;YACL,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;QACnE,CAAC;KACF,CAAC;AACJ,CAAC"}