@saas-maker/foundry-db 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,61 @@
+import * as drizzle_orm from 'drizzle-orm';
+import * as drizzle_orm_sqlite_core from 'drizzle-orm/sqlite-core';
+
+type LibSQLClient = {
+    execute: (query: string | {
+        sql: string;
+        args?: unknown[];
+    }) => Promise<unknown>;
+    batch?: (queries: unknown[]) => Promise<unknown[]>;
+};
+interface FoundryDbConfig {
+    project?: string;
+    d1?: D1Database;
+    url?: string;
+    authToken?: string;
+}
+/**
+ * Get a DB client. Auto-detects D1 vs Turso based on what's provided.
+ *
+ * In Cloudflare Workers: pass env.DB as `d1`
+ * In Node.js/Vite: reads DATABASE_URL + TURSO_AUTH_TOKEN from process.env
+ *
+ * Usage:
+ *   // CF Worker
+ *   const db = getDbClient({ d1: env.DB, project: 'linkchat' });
+ *
+ *   // Node/Vite / Next.js
+ *   const db = getDbClient({ project: 'significanthobbies' });
+ *   // requires DATABASE_URL (and optionally TURSO_AUTH_TOKEN) in env
+ */
+declare function getDbClient(config?: FoundryDbConfig): LibSQLClient;
+/** Reset the cached libSQL client (useful in tests). */
+declare function resetDbClient(): void;
+
+/**
+ * Standard columns every Foundry table should have.
+ * Usage: const myTable = sqliteTable('my_table', { ...foundryColumns(), ...myColumns })
+ */
+declare function foundryColumns(): {
+    id: drizzle_orm.HasRuntimeDefault<drizzle_orm.HasDefault<drizzle_orm.IsPrimaryKey<drizzle_orm.NotNull<drizzle_orm_sqlite_core.SQLiteTextBuilderInitial<"id", [string, ...string[]], number | undefined>>>>>;
+    createdAt: drizzle_orm.HasDefault<drizzle_orm.NotNull<drizzle_orm_sqlite_core.SQLiteTextBuilderInitial<"created_at", [string, ...string[]], number | undefined>>>;
+    updatedAt: drizzle_orm.HasDefault<drizzle_orm.NotNull<drizzle_orm_sqlite_core.SQLiteTextBuilderInitial<"updated_at", [string, ...string[]], number | undefined>>>;
+    deletedAt: drizzle_orm_sqlite_core.SQLiteTextBuilderInitial<"deleted_at", [string, ...string[]], number | undefined>;
+    version: drizzle_orm.HasDefault<drizzle_orm.NotNull<drizzle_orm_sqlite_core.SQLiteIntegerBuilderInitial<"version">>>;
+};
+/**
+ * Soft-delete helper — sets deletedAt instead of removing the row.
+ */
+declare function softDelete(): {
+    deletedAt: drizzle_orm_sqlite_core.SQLiteTextBuilderInitial<"deleted_at", [string, ...string[]], number | undefined>;
+};
+
+/**
+ * Convenience wrapper for manually tracing DB operations.
+ * Use when getDbClient() auto-tracing isn't sufficient.
+ *
+ * const results = await dbTrace('users:findByEmail', () => db.select(...), 'linkchat');
+ */
+declare function dbTrace<T>(operation: string, fn: () => Promise<T>, project?: string): Promise<T>;
+
+export { type FoundryDbConfig, type LibSQLClient, dbTrace, foundryColumns, getDbClient, resetDbClient, softDelete };

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+import * as drizzle_orm from 'drizzle-orm';
+import * as drizzle_orm_sqlite_core from 'drizzle-orm/sqlite-core';
+
+type LibSQLClient = {
+    execute: (query: string | {
+        sql: string;
+        args?: unknown[];
+    }) => Promise<unknown>;
+    batch?: (queries: unknown[]) => Promise<unknown[]>;
+};
+interface FoundryDbConfig {
+    project?: string;
+    d1?: D1Database;
+    url?: string;
+    authToken?: string;
+}
+/**
+ * Get a DB client. Auto-detects D1 vs Turso based on what's provided.
+ *
+ * In Cloudflare Workers: pass env.DB as `d1`
+ * In Node.js/Vite: reads DATABASE_URL + TURSO_AUTH_TOKEN from process.env
+ *
+ * Usage:
+ *   // CF Worker
+ *   const db = getDbClient({ d1: env.DB, project: 'linkchat' });
+ *
+ *   // Node/Vite / Next.js
+ *   const db = getDbClient({ project: 'significanthobbies' });
+ *   // requires DATABASE_URL (and optionally TURSO_AUTH_TOKEN) in env
+ */
+declare function getDbClient(config?: FoundryDbConfig): LibSQLClient;
+/** Reset the cached libSQL client (useful in tests). */
+declare function resetDbClient(): void;
+
+/**
+ * Standard columns every Foundry table should have.
+ * Usage: const myTable = sqliteTable('my_table', { ...foundryColumns(), ...myColumns })
+ */
+declare function foundryColumns(): {
+    id: drizzle_orm.HasRuntimeDefault<drizzle_orm.HasDefault<drizzle_orm.IsPrimaryKey<drizzle_orm.NotNull<drizzle_orm_sqlite_core.SQLiteTextBuilderInitial<"id", [string, ...string[]], number | undefined>>>>>;
+    createdAt: drizzle_orm.HasDefault<drizzle_orm.NotNull<drizzle_orm_sqlite_core.SQLiteTextBuilderInitial<"created_at", [string, ...string[]], number | undefined>>>;
+    updatedAt: drizzle_orm.HasDefault<drizzle_orm.NotNull<drizzle_orm_sqlite_core.SQLiteTextBuilderInitial<"updated_at", [string, ...string[]], number | undefined>>>;
+    deletedAt: drizzle_orm_sqlite_core.SQLiteTextBuilderInitial<"deleted_at", [string, ...string[]], number | undefined>;
+    version: drizzle_orm.HasDefault<drizzle_orm.NotNull<drizzle_orm_sqlite_core.SQLiteIntegerBuilderInitial<"version">>>;
+};
+/**
+ * Soft-delete helper — sets deletedAt instead of removing the row.
+ */
+declare function softDelete(): {
+    deletedAt: drizzle_orm_sqlite_core.SQLiteTextBuilderInitial<"deleted_at", [string, ...string[]], number | undefined>;
+};
+
+/**
+ * Convenience wrapper for manually tracing DB operations.
+ * Use when getDbClient() auto-tracing isn't sufficient.
+ *
+ * const results = await dbTrace('users:findByEmail', () => db.select(...), 'linkchat');
+ */
+declare function dbTrace<T>(operation: string, fn: () => Promise<T>, project?: string): Promise<T>;
+
+export { type FoundryDbConfig, type LibSQLClient, dbTrace, foundryColumns, getDbClient, resetDbClient, softDelete };

package/dist/index.js

@@ -0,0 +1,117 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  dbTrace: () => dbTrace,
+  foundryColumns: () => foundryColumns,
+  getDbClient: () => getDbClient,
+  resetDbClient: () => resetDbClient,
+  softDelete: () => softDelete
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var import_ops = require("@saas-maker/ops");
+var _cachedClient = null;
+function getDbClient(config = {}) {
+  if (config.d1) {
+    return wrapWithTrace(adaptD1(config.d1), config.project);
+  }
+  if (_cachedClient) return _cachedClient;
+  const url = config.url ?? (typeof process !== "undefined" ? process.env["DATABASE_URL"] : void 0);
+  const authToken = config.authToken ?? (typeof process !== "undefined" ? process.env["TURSO_AUTH_TOKEN"] : void 0);
+  if (!url) {
+    throw import_ops.FoundryErrors.db(
+      "No database URL provided. Set DATABASE_URL or pass d1 binding."
+    );
+  }
+  const client = createLibSQLClient(url, authToken);
+  _cachedClient = wrapWithTrace(client, config.project);
+  return _cachedClient;
+}
+function resetDbClient() {
+  _cachedClient = null;
+}
+function adaptD1(d1) {
+  return {
+    execute: async (query) => {
+      const sql2 = typeof query === "string" ? query : query.sql;
+      const args = typeof query === "string" ? [] : query.args ?? [];
+      const stmt = d1.prepare(sql2);
+      return args.length > 0 ? stmt.bind(...args).all() : stmt.all();
+    }
+  };
+}
+function createLibSQLClient(url, authToken) {
+  try {
+    const { createClient } = require("@libsql/client");
+    return createClient({ url, authToken });
+  } catch {
+    throw import_ops.FoundryErrors.db(
+      "@libsql/client not installed. Run: pnpm add @libsql/client"
+    );
+  }
+}
+function wrapWithTrace(client, project) {
+  return {
+    execute: async (query) => {
+      const sql2 = typeof query === "string" ? query : query.sql;
+      const opName = `db:${extractTableName(sql2)}`;
+      return (0, import_ops.trace)(opName, () => client.execute(query), { project });
+    },
+    batch: client.batch ? async (queries) => (0, import_ops.trace)("db:batch", () => client.batch(queries), { project }) : void 0
+  };
+}
+function extractTableName(sql2) {
+  const match = sql2.match(/(?:FROM|INTO|UPDATE|DELETE\s+FROM)\s+["'`]?(\w+)/i);
+  return match?.[1] ?? "query";
+}
+
+// src/columns.ts
+var import_drizzle_orm = require("drizzle-orm");
+var import_sqlite_core = require("drizzle-orm/sqlite-core");
+function foundryColumns() {
+  return {
+    id: (0, import_sqlite_core.text)("id").primaryKey().$defaultFn(() => crypto.randomUUID()),
+    createdAt: (0, import_sqlite_core.text)("created_at").notNull().default(import_drizzle_orm.sql`(datetime('now'))`),
+    updatedAt: (0, import_sqlite_core.text)("updated_at").notNull().default(import_drizzle_orm.sql`(datetime('now'))`),
+    deletedAt: (0, import_sqlite_core.text)("deleted_at"),
+    version: (0, import_sqlite_core.integer)("version").notNull().default(1)
+    // optimistic locking
+  };
+}
+function softDelete() {
+  return { deletedAt: (0, import_sqlite_core.text)("deleted_at") };
+}
+
+// src/trace.ts
+var import_ops2 = require("@saas-maker/ops");
+function dbTrace(operation, fn, project) {
+  return (0, import_ops2.trace)(`db:${operation}`, fn, { project });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  dbTrace,
+  foundryColumns,
+  getDbClient,
+  resetDbClient,
+  softDelete
+});

package/dist/index.mjs

@@ -0,0 +1,93 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/client.ts
+import { FoundryErrors, trace } from "@saas-maker/ops";
+var _cachedClient = null;
+function getDbClient(config = {}) {
+  if (config.d1) {
+    return wrapWithTrace(adaptD1(config.d1), config.project);
+  }
+  if (_cachedClient) return _cachedClient;
+  const url = config.url ?? (typeof process !== "undefined" ? process.env["DATABASE_URL"] : void 0);
+  const authToken = config.authToken ?? (typeof process !== "undefined" ? process.env["TURSO_AUTH_TOKEN"] : void 0);
+  if (!url) {
+    throw FoundryErrors.db(
+      "No database URL provided. Set DATABASE_URL or pass d1 binding."
+    );
+  }
+  const client = createLibSQLClient(url, authToken);
+  _cachedClient = wrapWithTrace(client, config.project);
+  return _cachedClient;
+}
+function resetDbClient() {
+  _cachedClient = null;
+}
+function adaptD1(d1) {
+  return {
+    execute: async (query) => {
+      const sql2 = typeof query === "string" ? query : query.sql;
+      const args = typeof query === "string" ? [] : query.args ?? [];
+      const stmt = d1.prepare(sql2);
+      return args.length > 0 ? stmt.bind(...args).all() : stmt.all();
+    }
+  };
+}
+function createLibSQLClient(url, authToken) {
+  try {
+    const { createClient } = __require("@libsql/client");
+    return createClient({ url, authToken });
+  } catch {
+    throw FoundryErrors.db(
+      "@libsql/client not installed. Run: pnpm add @libsql/client"
+    );
+  }
+}
+function wrapWithTrace(client, project) {
+  return {
+    execute: async (query) => {
+      const sql2 = typeof query === "string" ? query : query.sql;
+      const opName = `db:${extractTableName(sql2)}`;
+      return trace(opName, () => client.execute(query), { project });
+    },
+    batch: client.batch ? async (queries) => trace("db:batch", () => client.batch(queries), { project }) : void 0
+  };
+}
+function extractTableName(sql2) {
+  const match = sql2.match(/(?:FROM|INTO|UPDATE|DELETE\s+FROM)\s+["'`]?(\w+)/i);
+  return match?.[1] ?? "query";
+}
+
+// src/columns.ts
+import { sql } from "drizzle-orm";
+import { text, integer } from "drizzle-orm/sqlite-core";
+function foundryColumns() {
+  return {
+    id: text("id").primaryKey().$defaultFn(() => crypto.randomUUID()),
+    createdAt: text("created_at").notNull().default(sql`(datetime('now'))`),
+    updatedAt: text("updated_at").notNull().default(sql`(datetime('now'))`),
+    deletedAt: text("deleted_at"),
+    version: integer("version").notNull().default(1)
+    // optimistic locking
+  };
+}
+function softDelete() {
+  return { deletedAt: text("deleted_at") };
+}
+
+// src/trace.ts
+import { trace as trace2 } from "@saas-maker/ops";
+function dbTrace(operation, fn, project) {
+  return trace2(`db:${operation}`, fn, { project });
+}
+export {
+  dbTrace,
+  foundryColumns,
+  getDbClient,
+  resetDbClient,
+  softDelete
+};

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@saas-maker/foundry-db",
+  "version": "0.1.0",
+  "description": "Foundry DB layer — environment-aware D1/Turso factory with golden columns and auto-tracing",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": { "types": "./dist/index.d.ts", "import": "./dist/index.mjs", "require": "./dist/index.js" }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch"
+  },
+  "publishConfig": { "access": "public" },
+  "dependencies": {
+    "@saas-maker/ops": "^0.1.0"
+  },
+  "peerDependencies": {
+    "drizzle-orm": ">=0.30.0",
+    "@libsql/client": ">=0.6.0"
+  },
+  "peerDependenciesMeta": {
+    "@libsql/client": { "optional": true }
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.0",
+    "drizzle-orm": "^0.45.0",
+    "@libsql/client": "^0.14.0",
+    "@types/node": "^22.0.0",
+    "@cloudflare/workers-types": "^4.0.0"
+  }
+}