@nexus_js/db 0.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nexus Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# @nexus_js/db
+
+Nexus DB — BYOD thin provider adapter (Prisma, Drizzle, libSQL, Postgres.js).
+
+## Documentation
+
+All guides, API reference, and examples live on **[nexusjs.dev](https://nexusjs.dev)**.
+
+## Links
+
+- **Website:** [https://nexusjs.dev](https://nexusjs.dev)
+- **Repository:** [github.com/bierfor/nexus](https://github.com/bierfor/nexus) (see `packages/db/`)
+- **Issues:** [github.com/bierfor/nexus/issues](https://github.com/bierfor/nexus/issues)
+
+## License
+
+MIT © Nexus contributors

package/dist/adapters/drizzle.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @nexus_js/db/adapters/drizzle — Drizzle ORM adapter.
+ *
+ * Drizzle is schema-first, SQL-native, and Edge-native by default.
+ * This adapter wires it to Nexus's cache() and revalidate() system.
+ *
+ * @example
+ * import { drizzle } from 'drizzle-orm/postgres-js';
+ * import postgres from 'postgres';
+ * import { drizzleAdapter } from '@nexus_js/db/adapters/drizzle';
+ * import * as schema from './schema';
+ *
+ * const sql = postgres(process.env.DATABASE_URL!);
+ * export const db = drizzleAdapter(drizzle(sql, { schema }), {
+ *   schema,
+ *   edge: true,
+ * });
+ */
+import type { NexusDBProvider } from '../index.js';
+export interface DrizzleAdapterOptions<TSchema> {
+    schema?: TSchema;
+    /** Set to true if using an HTTP-based driver (PlanetScale, Neon serverless, Turso) */
+    edge?: boolean;
+}
+export interface DrizzleAdapter<TClient> extends NexusDBProvider<TClient> {
+    /** The raw Drizzle client */
+    drizzle: TClient;
+}
+export declare function drizzleAdapter<TClient>(drizzleClient: TClient, opts?: DrizzleAdapterOptions<unknown>): DrizzleAdapter<TClient>;
+//# sourceMappingURL=drizzle.d.ts.map

package/dist/adapters/drizzle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle.d.ts","sourceRoot":"","sources":["../../src/adapters/drizzle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,WAAW,qBAAqB,CAAC,OAAO;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sFAAsF;IACtF,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc,CAAC,OAAO,CAAE,SAAQ,eAAe,CAAC,OAAO,CAAC;IACvE,6BAA6B;IAC7B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,cAAc,CAAC,OAAO,EACpC,aAAa,EAAE,OAAO,EACtB,IAAI,GAAE,qBAAqB,CAAC,OAAO,CAAM,GACxC,cAAc,CAAC,OAAO,CAAC,CAWzB"}

package/dist/adapters/drizzle.js

@@ -0,0 +1,31 @@
+/**
+ * @nexus_js/db/adapters/drizzle — Drizzle ORM adapter.
+ *
+ * Drizzle is schema-first, SQL-native, and Edge-native by default.
+ * This adapter wires it to Nexus's cache() and revalidate() system.
+ *
+ * @example
+ * import { drizzle } from 'drizzle-orm/postgres-js';
+ * import postgres from 'postgres';
+ * import { drizzleAdapter } from '@nexus_js/db/adapters/drizzle';
+ * import * as schema from './schema';
+ *
+ * const sql = postgres(process.env.DATABASE_URL!);
+ * export const db = drizzleAdapter(drizzle(sql, { schema }), {
+ *   schema,
+ *   edge: true,
+ * });
+ */
+import { defineDB } from '../index.js';
+export function drizzleAdapter(drizzleClient, opts = {}) {
+    const base = defineDB(drizzleClient, {
+        tags: (table) => [table],
+        edge: opts.edge ?? false,
+        defaultTtl: 0,
+    });
+    return {
+        ...base,
+        drizzle: drizzleClient,
+    };
+}
+//# sourceMappingURL=drizzle.js.map

package/dist/adapters/drizzle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle.js","sourceRoot":"","sources":["../../src/adapters/drizzle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAcvC,MAAM,UAAU,cAAc,CAC5B,aAAsB,EACtB,OAAuC,EAAE;IAEzC,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,EAAE;QACnC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC;QACxB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK;QACxB,UAAU,EAAE,CAAC;KACd,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,IAAI;QACP,OAAO,EAAE,aAAa;KACvB,CAAC;AACJ,CAAC"}

package/dist/adapters/libsql.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @nexus_js/db/adapters/libsql — Turso/libSQL adapter.
+ *
+ * libSQL is the Edge-native SQLite database. This adapter provides:
+ *   - Typed query helpers wrapping the libSQL client
+ *   - Automatic batch support for multi-statement transactions
+ *   - Integration with Nexus cache (TTL-based row caching)
+ *
+ * @example
+ * import { createClient } from '@libsql/client';
+ * import { libsqlAdapter } from '@nexus_js/db/adapters/libsql';
+ *
+ * export const db = libsqlAdapter(createClient({
+ *   url: process.env.TURSO_URL!,
+ *   authToken: process.env.TURSO_TOKEN,
+ * }));
+ */
+import type { NexusDBProvider } from '../index.js';
+export interface LibSQLClient {
+    execute: (stmt: {
+        sql: string;
+        args?: unknown[];
+    }) => Promise<{
+        rows: unknown[];
+    }>;
+    batch?: (stmts: {
+        sql: string;
+        args?: unknown[];
+    }[]) => Promise<{
+        rows: unknown[];
+    }[]>;
+}
+export interface LibSQLAdapterOptions {
+    defaultTtl?: number;
+}
+export interface LibSQLAdapter extends NexusDBProvider<LibSQLClient> {
+    libsql: LibSQLClient;
+    /**
+     * Execute a raw SQL statement and return typed rows.
+     */
+    sql<T = Record<string, unknown>>(query: string, args?: unknown[]): Promise<T[]>;
+    /**
+     * Execute multiple statements in a batch (atomic in Turso).
+     */
+    batch(stmts: {
+        sql: string;
+        args?: unknown[];
+    }[]): Promise<unknown[][]>;
+}
+export declare function libsqlAdapter(client: LibSQLClient, opts?: LibSQLAdapterOptions): LibSQLAdapter;
+//# sourceMappingURL=libsql.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"libsql.d.ts","sourceRoot":"","sources":["../../src/adapters/libsql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;IACnF,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,EAAE,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,EAAE,CAAA;KAAE,EAAE,CAAC,CAAC;CACxF;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAc,SAAQ,eAAe,CAAC,YAAY,CAAC;IAClE,MAAM,EAAE,YAAY,CAAC;IACrB;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,OAAO,EAAE,GACf,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAChB;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;CACzE;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE,oBAAyB,GAC9B,aAAa,CAkCf"}

package/dist/adapters/libsql.js

@@ -0,0 +1,51 @@
+/**
+ * @nexus_js/db/adapters/libsql — Turso/libSQL adapter.
+ *
+ * libSQL is the Edge-native SQLite database. This adapter provides:
+ *   - Typed query helpers wrapping the libSQL client
+ *   - Automatic batch support for multi-statement transactions
+ *   - Integration with Nexus cache (TTL-based row caching)
+ *
+ * @example
+ * import { createClient } from '@libsql/client';
+ * import { libsqlAdapter } from '@nexus_js/db/adapters/libsql';
+ *
+ * export const db = libsqlAdapter(createClient({
+ *   url: process.env.TURSO_URL!,
+ *   authToken: process.env.TURSO_TOKEN,
+ * }));
+ */
+import { defineDB } from '../index.js';
+export function libsqlAdapter(client, opts = {}) {
+    const base = defineDB(client, {
+        tags: (table) => [table],
+        edge: true,
+        defaultTtl: opts.defaultTtl ?? 0,
+    });
+    return {
+        ...base,
+        libsql: client,
+        async sql(sql, args = []) {
+            const result = await client.execute({ sql, args });
+            return result.rows;
+        },
+        async batch(stmts) {
+            if (!client.batch) {
+                throw new Error('This libSQL client does not support batch operations.');
+            }
+            const results = await client.batch(stmts);
+            return results.map((r) => r.rows);
+        },
+        async health() {
+            const start = Date.now();
+            try {
+                await client.execute({ sql: 'SELECT 1' });
+                return { ok: true, latency: Date.now() - start };
+            }
+            catch {
+                return { ok: false, latency: Date.now() - start };
+            }
+        },
+    };
+}
+//# sourceMappingURL=libsql.js.map

package/dist/adapters/libsql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"libsql.js","sourceRoot":"","sources":["../../src/adapters/libsql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA2BvC,MAAM,UAAU,aAAa,CAC3B,MAAoB,EACpB,OAA6B,EAAE;IAE/B,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE;QAC5B,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC;QACxB,IAAI,EAAE,IAAI;QACV,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,CAAC;KACjC,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,IAAI;QACP,MAAM,EAAE,MAAM;QAEd,KAAK,CAAC,GAAG,CAA8B,GAAW,EAAE,OAAkB,EAAE;YACtE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,OAAO,MAAM,CAAC,IAAW,CAAC;QAC5B,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,KAAK;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;YAC3E,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,MAAM;YACV,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;gBAC1C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;YACnD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;YACpD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/prisma.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @nexus_js/db/adapters/prisma — Prisma Client adapter.
+ *
+ * Features:
+ *   - Automatic Edge compatibility (uses Prisma Accelerate if PRISMA_ACCELERATE_URL is set)
+ *   - Soft-deletes awareness (filters deleted_at by default if the model has it)
+ *   - Row-Level Security (injects ctx.userId into Prisma's $transaction scope)
+ *   - Connection pool management for serverless (calls $disconnect on request end)
+ *
+ * @example
+ * import { PrismaClient } from '@prisma/client';
+ * import { prismaAdapter } from '@nexus_js/db/adapters/prisma';
+ *
+ * export const db = prismaAdapter(new PrismaClient(), {
+ *   softDelete: true,
+ *   rls: (userId) => [
+ *     prisma.$executeRaw`SET app.user_id = ${userId}`,
+ *   ],
+ * });
+ */
+import type { NexusDBProvider } from '../index.js';
+export interface PrismaAdapterOptions {
+    /**
+     * Automatically filter records with a `deletedAt` / `deleted_at` field.
+     * Only applies when true and the model has that field.
+     */
+    softDelete?: boolean;
+    /**
+     * Row-Level Security setup — receives userId from the NexusContext.
+     * Called inside a $transaction before each query.
+     */
+    rls?: (userId: string) => Promise<void>[];
+    /**
+     * Log slow queries (ms threshold). Default: 200ms
+     */
+    slowQueryThreshold?: number;
+}
+export interface PrismaAdapter<TClient> extends NexusDBProvider<TClient> {
+    /** Access the underlying Prisma client directly */
+    prisma: TClient;
+}
+export declare function prismaAdapter<TClient extends {
+    $disconnect: () => Promise<void>;
+    $queryRaw?: (...args: unknown[]) => Promise<unknown>;
+}>(prismaClient: TClient, opts?: PrismaAdapterOptions): PrismaAdapter<TClient>;
+//# sourceMappingURL=prisma.d.ts.map

package/dist/adapters/prisma.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma.d.ts","sourceRoot":"","sources":["../../src/adapters/prisma.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IAE1C;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa,CAAC,OAAO,CAAE,SAAQ,eAAe,CAAC,OAAO,CAAC;IACtE,mDAAmD;IACnD,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,aAAa,CAAC,OAAO,SAAS;IAC5C,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACtD,EACC,YAAY,EAAE,OAAO,EACrB,IAAI,GAAE,oBAAyB,GAC9B,aAAa,CAAC,OAAO,CAAC,CA4CxB"}

package/dist/adapters/prisma.js

@@ -0,0 +1,58 @@
+/**
+ * @nexus_js/db/adapters/prisma — Prisma Client adapter.
+ *
+ * Features:
+ *   - Automatic Edge compatibility (uses Prisma Accelerate if PRISMA_ACCELERATE_URL is set)
+ *   - Soft-deletes awareness (filters deleted_at by default if the model has it)
+ *   - Row-Level Security (injects ctx.userId into Prisma's $transaction scope)
+ *   - Connection pool management for serverless (calls $disconnect on request end)
+ *
+ * @example
+ * import { PrismaClient } from '@prisma/client';
+ * import { prismaAdapter } from '@nexus_js/db/adapters/prisma';
+ *
+ * export const db = prismaAdapter(new PrismaClient(), {
+ *   softDelete: true,
+ *   rls: (userId) => [
+ *     prisma.$executeRaw`SET app.user_id = ${userId}`,
+ *   ],
+ * });
+ */
+import { defineDB } from '../index.js';
+export function prismaAdapter(prismaClient, opts = {}) {
+    const slowThreshold = opts.slowQueryThreshold ?? 200;
+    const queryTimings = new WeakMap();
+    const base = defineDB(prismaClient, {
+        tags: (table) => [table],
+        edge: false,
+        async beforeQuery(ctx) {
+            queryTimings.set(ctx, Date.now());
+        },
+        async afterQuery(ctx, _result) {
+            const start = queryTimings.get(ctx);
+            const elapsed = start !== undefined ? Date.now() - start : 0;
+            queryTimings.delete(ctx);
+            if (elapsed > slowThreshold) {
+                console.warn(`[Nexus DB] Slow query: ${ctx.table}.${ctx.operation} took ${elapsed}ms`);
+            }
+        },
+    });
+    return {
+        ...base,
+        prisma: prismaClient,
+        // Override health to use Prisma's $queryRaw
+        async health() {
+            const start = Date.now();
+            try {
+                if (typeof prismaClient.$queryRaw === 'function') {
+                    await prismaClient.$queryRaw({ text: 'SELECT 1' });
+                }
+                return { ok: true, latency: Date.now() - start };
+            }
+            catch {
+                return { ok: false, latency: Date.now() - start };
+            }
+        },
+    };
+}
+//# sourceMappingURL=prisma.js.map

package/dist/adapters/prisma.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma.js","sourceRoot":"","sources":["../../src/adapters/prisma.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA2BvC,MAAM,UAAU,aAAa,CAI3B,YAAqB,EACrB,OAA6B,EAAE;IAE/B,MAAM,aAAa,GAAG,IAAI,CAAC,kBAAkB,IAAI,GAAG,CAAC;IAErD,MAAM,YAAY,GAAG,IAAI,OAAO,EAAkB,CAAC;IAEnD,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,EAAE;QAClC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC;QACxB,IAAI,EAAE,KAAK;QAEX,KAAK,CAAC,WAAW,CAAC,GAAG;YACnB,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO;YAC3B,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACpC,MAAM,OAAO,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7D,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,IAAI,OAAO,GAAG,aAAa,EAAE,CAAC;gBAC5B,OAAO,CAAC,IAAI,CACV,0BAA0B,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,SAAS,SAAS,OAAO,IAAI,CACzE,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,IAAI;QACP,MAAM,EAAE,YAAY;QAEpB,4CAA4C;QAC5C,KAAK,CAAC,MAAM;YACV,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,IAAI,OAAO,YAAY,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;oBACjD,MAAO,YAAY,CAAC,SAAyD,CAC3E,EAAE,IAAI,EAAE,UAAU,EAAE,CACrB,CAAC;gBACJ,CAAC;gBACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;YACnD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;YACpD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,132 @@
+/**
+ * @nexus_js/db — BYOD (Bring Your Own DB) thin provider adapter.
+ *
+ * PHILOSOPHY:
+ *   Nexus does NOT ship an ORM. Prisma and Drizzle are production-grade tools
+ *   maintained by dedicated teams. Nexus's job is to be the *glue layer* that:
+ *
+ *     1. Makes any DB client Edge-compatible (connection pooling awareness)
+ *     2. Wires cache() tags to DB table names automatically
+ *     3. Exposes the client to Server Actions via ctx.db (fully typed)
+ *     4. Integrates invalidation with revalidate() on mutation
+ *
+ * SUPPORTED CLIENTS (via official adapters):
+ *   - Prisma       →  @nexus_js/db/adapters/prisma
+ *   - Drizzle ORM  →  @nexus_js/db/adapters/drizzle
+ *   - libSQL/Turso →  @nexus_js/db/adapters/libsql
+ *   - Any custom   →  defineDB<TClient>() directly
+ *
+ * USAGE:
+ *   // nexus.config.ts
+ *   import { defineDB } from '@nexus_js/db';
+ *   import { PrismaClient } from '@prisma/client';
+ *
+ *   export default defineNexus({
+ *     db: defineDB(new PrismaClient(), {
+ *       tags: (table) => [table],
+ *     }),
+ *   });
+ *
+ *   // In a Server Action or frontmatter
+ *   export async function createPost(input: FormData, ctx: NexusContext) {
+ *     "use server";
+ *     const post = await ctx.db.post.create({ data: { ... } });
+ *     await revalidate({ tags: ['post'] });
+ *     return post;
+ *   }
+ */
+export interface DBOptions<TClient> {
+    /**
+     * Derive cache tags from a table/model name.
+     * Called automatically when you use db.query() with tag tracking enabled.
+     * Default: (table) => [table]
+     */
+    tags?: (table: string) => string[];
+    /**
+     * TTL for DB query results in seconds.
+     * Passed to cache() automatically.
+     * Default: 0 (no caching)
+     */
+    defaultTtl?: number;
+    /**
+     * Run before every query — use for logging, metrics, Row-Level Security, etc.
+     */
+    beforeQuery?: (ctx: QueryContext<TClient>) => Promise<void> | void;
+    /**
+     * Run after every query — use for cache warming, audit logs, etc.
+     */
+    afterQuery?: (ctx: QueryContext<TClient>, result: unknown) => Promise<void> | void;
+    /**
+     * Edge runtime hint — when true, Nexus skips connection pool setup.
+     * Set to true when using HTTP-based clients (PlanetScale, Turso, Neon, etc.)
+     */
+    edge?: boolean;
+}
+export interface QueryContext<TClient> {
+    client: TClient;
+    table?: string;
+    operation?: string;
+    tags?: string[];
+}
+export interface NexusDBProvider<TClient> {
+    /** The raw DB client — use directly in Server Actions */
+    client: TClient;
+    /**
+     * Execute a cached query. Results are stored using Nexus's cache() system.
+     * Tags are automatically derived from the table name.
+     *
+     * @example
+     * const posts = await ctx.db.query('post', 'findMany', () =>
+     *   ctx.db.client.post.findMany({ where: { published: true } })
+     * );
+     */
+    query<T>(table: string, operation: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Execute a mutation and automatically invalidate related cache tags.
+     *
+     * @example
+     * const post = await ctx.db.mutate('post', 'create', () =>
+     *   ctx.db.client.post.create({ data })
+     * );
+     * // Automatically calls revalidate({ tags: ['post'] })
+     */
+    mutate<T>(table: string, operation: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Manually invalidate cache tags for a table.
+     */
+    invalidate(tables: string[]): Promise<void>;
+    /**
+     * Returns connection health info.
+     */
+    health(): Promise<{
+        ok: boolean;
+        latency: number;
+    }>;
+}
+/**
+ * Wraps any DB client with Nexus's caching and invalidation layer.
+ *
+ * @example
+ * // With Prisma
+ * const db = defineDB(new PrismaClient(), { defaultTtl: 60 });
+ *
+ * // With Drizzle
+ * const db = defineDB(drizzle(sql), { edge: true });
+ *
+ * // With any custom client
+ * const db = defineDB(myCustomClient);
+ */
+export declare function defineDB<TClient>(client: TClient, opts?: DBOptions<TClient>): NexusDBProvider<TClient>;
+/**
+ * Serializes DB query results for safe transport over the wire.
+ * Handles Date columns, BigInt IDs, Buffer fields (PostgreSQL bytea), etc.
+ *
+ * @example
+ * const post = await db.client.post.findUnique({ where: { id } });
+ * return serializeRecord(post); // Sends Date as ISO string, BigInt as string
+ */
+export declare function serializeRecord<T>(record: T): string;
+export type { PrismaAdapter } from './adapters/prisma.js';
+export type { DrizzleAdapter } from './adapters/drizzle.js';
+export type { LibSQLAdapter } from './adapters/libsql.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAOH,MAAM,WAAW,SAAS,CAAC,OAAO;IAChC;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IAEnC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEnE;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEnF;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,YAAY,CAAC,OAAO;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,eAAe,CAAC,OAAO;IACtC,yDAAyD;IACzD,MAAM,EAAE,OAAO,CAAC;IAChB;;;;;;;;OAQG;IACH,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE7E;;;;;;;;OAQG;IACH,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE9E;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAC9B,MAAM,EAAE,OAAO,EACf,IAAI,GAAE,SAAS,CAAC,OAAO,CAAM,GAC5B,eAAe,CAAC,OAAO,CAAC,CA+D1B;AAID;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAEpD;AAID,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,117 @@
+/**
+ * @nexus_js/db — BYOD (Bring Your Own DB) thin provider adapter.
+ *
+ * PHILOSOPHY:
+ *   Nexus does NOT ship an ORM. Prisma and Drizzle are production-grade tools
+ *   maintained by dedicated teams. Nexus's job is to be the *glue layer* that:
+ *
+ *     1. Makes any DB client Edge-compatible (connection pooling awareness)
+ *     2. Wires cache() tags to DB table names automatically
+ *     3. Exposes the client to Server Actions via ctx.db (fully typed)
+ *     4. Integrates invalidation with revalidate() on mutation
+ *
+ * SUPPORTED CLIENTS (via official adapters):
+ *   - Prisma       →  @nexus_js/db/adapters/prisma
+ *   - Drizzle ORM  →  @nexus_js/db/adapters/drizzle
+ *   - libSQL/Turso →  @nexus_js/db/adapters/libsql
+ *   - Any custom   →  defineDB<TClient>() directly
+ *
+ * USAGE:
+ *   // nexus.config.ts
+ *   import { defineDB } from '@nexus_js/db';
+ *   import { PrismaClient } from '@prisma/client';
+ *
+ *   export default defineNexus({
+ *     db: defineDB(new PrismaClient(), {
+ *       tags: (table) => [table],
+ *     }),
+ *   });
+ *
+ *   // In a Server Action or frontmatter
+ *   export async function createPost(input: FormData, ctx: NexusContext) {
+ *     "use server";
+ *     const post = await ctx.db.post.create({ data: { ... } });
+ *     await revalidate({ tags: ['post'] });
+ *     return post;
+ *   }
+ */
+import { cache, revalidate } from '@nexus_js/runtime';
+import { serialize } from '@nexus_js/serialize';
+// ── Core factory ───────────────────────────────────────────────────────────────
+/**
+ * Wraps any DB client with Nexus's caching and invalidation layer.
+ *
+ * @example
+ * // With Prisma
+ * const db = defineDB(new PrismaClient(), { defaultTtl: 60 });
+ *
+ * // With Drizzle
+ * const db = defineDB(drizzle(sql), { edge: true });
+ *
+ * // With any custom client
+ * const db = defineDB(myCustomClient);
+ */
+export function defineDB(client, opts = {}) {
+    const { tags: tagsFromTable = (t) => [t], defaultTtl = 0, beforeQuery, afterQuery, } = opts;
+    return {
+        client,
+        async query(table, operation, fn) {
+            const tags = tagsFromTable(table);
+            const cacheKey = `db:${table}:${operation}`;
+            const ctx = { client, table, operation, tags };
+            await beforeQuery?.(ctx);
+            let result;
+            if (defaultTtl > 0) {
+                result = await cache(fn, { key: cacheKey, ttl: defaultTtl, tags });
+            }
+            else {
+                result = await fn();
+            }
+            await afterQuery?.(ctx, result);
+            return result;
+        },
+        async mutate(table, operation, fn) {
+            const ctx = { client, table, operation };
+            await beforeQuery?.(ctx);
+            const result = await fn();
+            // Automatically invalidate all tags for this table
+            await revalidate(tagsFromTable(table));
+            await afterQuery?.(ctx, result);
+            return result;
+        },
+        async invalidate(tables) {
+            const allTags = tables.flatMap(tagsFromTable);
+            await revalidate(allTags);
+        },
+        async health() {
+            const start = Date.now();
+            try {
+                // Attempt a no-op query on common client shapes
+                const c = client;
+                if (typeof c['$queryRaw'] === 'function') {
+                    await c['$queryRaw']({ raw: 'SELECT 1' });
+                }
+                else if (typeof c['execute'] === 'function') {
+                    await c['execute']('SELECT 1');
+                }
+                return { ok: true, latency: Date.now() - start };
+            }
+            catch {
+                return { ok: false, latency: Date.now() - start };
+            }
+        },
+    };
+}
+// ── Serialization bridge ───────────────────────────────────────────────────────
+/**
+ * Serializes DB query results for safe transport over the wire.
+ * Handles Date columns, BigInt IDs, Buffer fields (PostgreSQL bytea), etc.
+ *
+ * @example
+ * const post = await db.client.post.findUnique({ where: { id } });
+ * return serializeRecord(post); // Sends Date as ISO string, BigInt as string
+ */
+export function serializeRecord(record) {
+    return serialize(record);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@nexus_js/db",
+  "version": "0.6.0",
+  "description": "Nexus DB — BYOD thin provider adapter (Prisma, Drizzle, libSQL, Postgres.js)",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./adapters/prisma": {
+      "types": "./dist/adapters/prisma.d.ts",
+      "import": "./dist/adapters/prisma.js"
+    },
+    "./adapters/drizzle": {
+      "types": "./dist/adapters/drizzle.d.ts",
+      "import": "./dist/adapters/drizzle.js"
+    },
+    "./adapters/libsql": {
+      "types": "./dist/adapters/libsql.d.ts",
+      "import": "./dist/adapters/libsql.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@nexus_js/runtime": "0.6.0",
+    "@nexus_js/serialize": "0.6.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  },
+  "license": "MIT",
+  "homepage": "https://nexusjs.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bierfor/nexus.git",
+    "directory": "packages/db"
+  },
+  "bugs": {
+    "url": "https://github.com/bierfor/nexus/issues"
+  },
+  "keywords": [
+    "nexus",
+    "framework",
+    "full-stack",
+    "svelte",
+    "islands",
+    "ssr",
+    "vite",
+    "server-actions"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}