@fragno-dev/db 0.1.0 → 0.1.2

package/dist/shared/settings-schema.js

@@ -0,0 +1,36 @@
+import { column, idColumn, schema } from "../schema/create.js";
+
+//#region src/shared/settings-schema.ts
+const SETTINGS_TABLE_NAME = "fragno_db_settings";
+const SETTINGS_NAMESPACE = "fragno-db-settings";
+const settingsSchema = schema((s) => {
+	return s.addTable(SETTINGS_TABLE_NAME, (t) => {
+		return t.addColumn("id", idColumn()).addColumn("key", column("string")).addColumn("value", column("string")).createIndex("unique_key", ["key"], { unique: true });
+	});
+});
+function createSettingsManager(queryEngine, namespace) {
+	return {
+		async get(key) {
+			const [[result]] = await queryEngine.createUnitOfWork().find(SETTINGS_TABLE_NAME, (b) => b.whereIndex("unique_key", (eb) => eb("key", "=", `${namespace}.${key}`))).executeRetrieve();
+			return result;
+		},
+		async set(key, value) {
+			const uow = queryEngine.createUnitOfWork("createSettingsManager#set").find(SETTINGS_TABLE_NAME, (b) => b.whereIndex("unique_key", (eb) => eb("key", "=", `${namespace}.${key}`)));
+			const [[existing]] = await uow.executeRetrieve();
+			if (existing) uow.update(SETTINGS_TABLE_NAME, existing.id, (b) => b.set({ value }).check());
+			else uow.create(SETTINGS_TABLE_NAME, {
+				key: `${namespace}.${key}`,
+				value
+			});
+			const { success } = await uow.executeMutations();
+			if (!success) throw new Error("Failed to set schema version");
+		},
+		async delete(id) {
+			await queryEngine.delete(SETTINGS_TABLE_NAME, id);
+		}
+	};
+}
+
+//#endregion
+export { SETTINGS_NAMESPACE, SETTINGS_TABLE_NAME, createSettingsManager, settingsSchema };
+//# sourceMappingURL=settings-schema.js.map

package/dist/shared/settings-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-schema.js","names":[],"sources":["../../src/shared/settings-schema.ts"],"sourcesContent":["import type { AbstractQuery } from \"../query/query\";\nimport { schema, idColumn, column, type FragnoId } from \"../schema/create\";\n\nexport const SETTINGS_TABLE_NAME = \"fragno_db_settings\" as const;\nexport const SETTINGS_NAMESPACE = \"fragno-db-settings\" as const;\n\nexport const settingsSchema = schema((s) => {\n  return s.addTable(SETTINGS_TABLE_NAME, (t) => {\n    return t\n      .addColumn(\"id\", idColumn())\n      .addColumn(\"key\", column(\"string\"))\n      .addColumn(\"value\", column(\"string\"))\n      .createIndex(\"unique_key\", [\"key\"], { unique: true });\n  });\n});\n\nexport function createSettingsManager(\n  // oxlint-disable-next-line no-explicit-any\n  queryEngine: AbstractQuery<typeof settingsSchema, any>,\n  namespace: string,\n) {\n  return {\n    async get(key: string): Promise<{ id: FragnoId; key: string; value: string } | undefined> {\n      const uow = queryEngine\n        .createUnitOfWork()\n        .find(SETTINGS_TABLE_NAME, (b) =>\n          b.whereIndex(\"unique_key\", (eb) => eb(\"key\", \"=\", `${namespace}.${key}`)),\n        );\n      const [[result]] = await uow.executeRetrieve();\n      return result; // Safe: result can be undefined if key doesn't exist\n    },\n\n    async set(key: string, value: string) {\n      const uow = queryEngine\n        .createUnitOfWork(\"createSettingsManager#set\")\n        .find(SETTINGS_TABLE_NAME, (b) =>\n          b.whereIndex(\"unique_key\", (eb) => eb(\"key\", \"=\", `${namespace}.${key}`)),\n        );\n      const [[existing]] = await uow.executeRetrieve();\n\n      if (existing) {\n        uow.update(SETTINGS_TABLE_NAME, existing.id, (b) => b.set({ value }).check());\n      } else {\n        uow.create(SETTINGS_TABLE_NAME, {\n          key: `${namespace}.${key}`,\n          value,\n        });\n      }\n\n      const { success } = await uow.executeMutations();\n\n      if (!success) {\n        throw new Error(\"Failed to set schema version\");\n      }\n    },\n\n    async delete(id: FragnoId) {\n      await queryEngine.delete(SETTINGS_TABLE_NAME, id);\n    },\n  };\n}\n"],"mappings":";;;AAGA,MAAa,sBAAsB;AACnC,MAAa,qBAAqB;AAElC,MAAa,iBAAiB,QAAQ,MAAM;AAC1C,QAAO,EAAE,SAAS,sBAAsB,MAAM;AAC5C,SAAO,EACJ,UAAU,MAAM,UAAU,CAAC,CAC3B,UAAU,OAAO,OAAO,SAAS,CAAC,CAClC,UAAU,SAAS,OAAO,SAAS,CAAC,CACpC,YAAY,cAAc,CAAC,MAAM,EAAE,EAAE,QAAQ,MAAM,CAAC;GACvD;EACF;AAEF,SAAgB,sBAEd,aACA,WACA;AACA,QAAO;EACL,MAAM,IAAI,KAAgF;GAMxF,MAAM,CAAC,CAAC,WAAW,MALP,YACT,kBAAkB,CAClB,KAAK,sBAAsB,MAC1B,EAAE,WAAW,eAAe,OAAO,GAAG,OAAO,KAAK,GAAG,UAAU,GAAG,MAAM,CAAC,CAC1E,CAC0B,iBAAiB;AAC9C,UAAO;;EAGT,MAAM,IAAI,KAAa,OAAe;GACpC,MAAM,MAAM,YACT,iBAAiB,4BAA4B,CAC7C,KAAK,sBAAsB,MAC1B,EAAE,WAAW,eAAe,OAAO,GAAG,OAAO,KAAK,GAAG,UAAU,GAAG,MAAM,CAAC,CAC1E;GACH,MAAM,CAAC,CAAC,aAAa,MAAM,IAAI,iBAAiB;AAEhD,OAAI,SACF,KAAI,OAAO,qBAAqB,SAAS,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC;OAE7E,KAAI,OAAO,qBAAqB;IAC9B,KAAK,GAAG,UAAU,GAAG;IACrB;IACD,CAAC;GAGJ,MAAM,EAAE,YAAY,MAAM,IAAI,kBAAkB;AAEhD,OAAI,CAAC,QACH,OAAM,IAAI,MAAM,+BAA+B;;EAInD,MAAM,OAAO,IAAc;AACzB,SAAM,YAAY,OAAO,qBAAqB,GAAG;;EAEpD"}

package/dist/util/import-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"import-generator.js","names":["v: string[]","names"],"sources":["../../src/util/import-generator.ts"],"sourcesContent":["export function importGenerator() {\n  const names = new Set<string>();\n  // specifier -> import name\n  const map = new Map<string, string[]>();\n\n  return {\n    addImport(name: string, specifier: string) {\n      if (names.has(name)) {\n        return;\n      }\n\n      names.add(name);\n      const list = map.get(specifier) ?? [];\n      list.push(name);\n      map.set(specifier, list);\n    },\n    format(): string {\n      const v: string[] = [];\n      for (const [specifier, names] of map) {\n        if (names.length === 0) continue;\n\n        v.push(`import { ${names.join(\", \")} } from \"${specifier}\"`);\n      }\n\n      return v.join(\"\\n\");\n    },\n  };\n}\n"],"mappings":";AAAA,SAAgB,kBAAkB;CAChC,MAAM,wBAAQ,IAAI,KAAa;CAE/B,MAAM,sBAAM,IAAI,KAAuB;AAEvC,QAAO;EACL,UAAU,MAAc,WAAmB;AACzC,OAAI,MAAM,IAAI,KAAK,CACjB;AAGF,SAAM,IAAI,KAAK;GACf,MAAM,OAAO,IAAI,IAAI,UAAU,IAAI,EAAE;AACrC,QAAK,KAAK,KAAK;AACf,OAAI,IAAI,WAAW,KAAK;;EAE1B,SAAiB;GACf,MAAMA,IAAc,EAAE;AACtB,QAAK,MAAM,CAAC,WAAWC,YAAU,KAAK;AACpC,QAAIA,QAAM,WAAW,EAAG;AAExB,MAAE,KAAK,YAAYA,QAAM,KAAK,KAAK,CAAC,WAAW,UAAU,GAAG;;AAG9D,UAAO,EAAE,KAAK,KAAK;;EAEtB"}
+{"version":3,"file":"import-generator.js","names":["v: string[]","names"],"sources":["../../src/util/import-generator.ts"],"sourcesContent":["export function importGenerator() {\n  const names = new Set<string>();\n  // specifier -> import name\n  const map = new Map<string, string[]>();\n\n  return {\n    addImport(name: string, specifier: string) {\n      if (names.has(name)) {\n        return;\n      }\n\n      names.add(name);\n      const list = map.get(specifier) ?? [];\n      list.push(name);\n      map.set(specifier, list);\n    },\n    format(): string {\n      const v: string[] = [];\n      for (const [specifier, names] of map) {\n        if (names.length === 0) {\n          continue;\n        }\n\n        v.push(`import { ${names.join(\", \")} } from \"${specifier}\"`);\n      }\n\n      return v.join(\"\\n\");\n    },\n  };\n}\n"],"mappings":";AAAA,SAAgB,kBAAkB;CAChC,MAAM,wBAAQ,IAAI,KAAa;CAE/B,MAAM,sBAAM,IAAI,KAAuB;AAEvC,QAAO;EACL,UAAU,MAAc,WAAmB;AACzC,OAAI,MAAM,IAAI,KAAK,CACjB;AAGF,SAAM,IAAI,KAAK;GACf,MAAM,OAAO,IAAI,IAAI,UAAU,IAAI,EAAE;AACrC,QAAK,KAAK,KAAK;AACf,OAAI,IAAI,WAAW,KAAK;;EAE1B,SAAiB;GACf,MAAMA,IAAc,EAAE;AACtB,QAAK,MAAM,CAAC,WAAWC,YAAU,KAAK;AACpC,QAAIA,QAAM,WAAW,EACnB;AAGF,MAAE,KAAK,YAAYA,QAAM,KAAK,KAAK,CAAC,WAAW,UAAU,GAAG;;AAG9D,UAAO,EAAE,KAAK,KAAK;;EAEtB"}

package/dist/util/parse.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse.js","names":[],"sources":["../../src/util/parse.ts"],"sourcesContent":["const RegexVarchar = /^varchar\\((\\d+)\\)$/;\n\nexport function parseVarchar(template: string): number {\n  const match = RegexVarchar.exec(template);\n  if (!match) throw new Error(\"Failed to match varchar(n)\");\n  return Number(match[1]);\n}\n\nexport function ident(s: string, identation = 2): string {\n  const tab = \" \".repeat(identation);\n\n  return s\n    .split(\"\\n\")\n    .map((v) => tab + v)\n    .join(\"\\n\");\n}\n"],"mappings":";AAAA,MAAM,eAAe;AAErB,SAAgB,aAAa,UAA0B;CACrD,MAAM,QAAQ,aAAa,KAAK,SAAS;AACzC,KAAI,CAAC,MAAO,OAAM,IAAI,MAAM,6BAA6B;AACzD,QAAO,OAAO,MAAM,GAAG;;AAGzB,SAAgB,MAAM,GAAW,aAAa,GAAW;CACvD,MAAM,MAAM,IAAI,OAAO,WAAW;AAElC,QAAO,EACJ,MAAM,KAAK,CACX,KAAK,MAAM,MAAM,EAAE,CACnB,KAAK,KAAK"}
+{"version":3,"file":"parse.js","names":[],"sources":["../../src/util/parse.ts"],"sourcesContent":["const RegexVarchar = /^varchar\\((\\d+)\\)$/;\n\nexport function parseVarchar(template: string): number {\n  const match = RegexVarchar.exec(template);\n  if (!match) {\n    throw new Error(\"Failed to match varchar(n)\");\n  }\n  return Number(match[1]);\n}\n\nexport function ident(s: string, identation = 2): string {\n  const tab = \" \".repeat(identation);\n\n  return s\n    .split(\"\\n\")\n    .map((v) => tab + v)\n    .join(\"\\n\");\n}\n"],"mappings":";AAAA,MAAM,eAAe;AAErB,SAAgB,aAAa,UAA0B;CACrD,MAAM,QAAQ,aAAa,KAAK,SAAS;AACzC,KAAI,CAAC,MACH,OAAM,IAAI,MAAM,6BAA6B;AAE/C,QAAO,OAAO,MAAM,GAAG;;AAGzB,SAAgB,MAAM,GAAW,aAAa,GAAW;CACvD,MAAM,MAAM,IAAI,OAAO,WAAW;AAElC,QAAO,EACJ,MAAM,KAAK,CACX,KAAK,MAAM,MAAM,EAAE,CACnB,KAAK,KAAK"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fragno-dev/db",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "exports": {
     ".": {
@@ -56,6 +56,12 @@
       "development": "./src/fragment.ts",
       "types": "./dist/fragment.d.ts",
       "default": "./dist/fragment.js"
+    },
+    "./generation-engine": {
+      "bun": "./src/migration-engine/generation-engine.ts",
+      "development": "./src/migration-engine/generation-engine.ts",
+      "types": "./dist/migration-engine/generation-engine.d.ts",
+      "default": "./dist/migration-engine/generation-engine.js"
     }
   },
   "scripts": {
@@ -67,19 +73,17 @@
   },
   "devDependencies": {
     "@electric-sql/pglite": "^0.3.10",
+    "@fragno-dev/core": "0.1.2",
     "@fragno-private/typescript-config": "0.0.1",
     "@fragno-private/vitest-config": "0.0.0",
-    "@fragno-dev/core": "0.0.7",
     "@types/bun": "^1.2.23",
     "@types/node": "^22",
     "@vitest/coverage-istanbul": "^3.2.4",
     "drizzle-kit": "^0.31.5",
     "drizzle-orm": "^0.44.6",
     "kysely-pglite": "^0.6.1",
-    "vitest": "^3.2.4"
-  },
-  "peerDependencies": {
-    "@fragno-dev/core": "0.0.7"
+    "vitest": "^3.2.4",
+    "zod": "^4.1.12"
   },
   "repository": {
     "type": "git",

package/src/adapters/adapters.ts

@@ -15,8 +15,15 @@ export interface DatabaseAdapter<TUOWConfig = void> {
   ) => AbstractQuery<T, TUOWConfig>;
 
   createMigrationEngine?: <const T extends AnySchema>(schema: T, namespace: string) => Migrator;
-  createSchemaGenerator?: <const T extends AnySchema>(
-    schema: T,
-    namespace: string,
+
+  /**
+   * Generate a combined schema file from one or more fragments.
+   * If not implemented, schema generation is not supported for this adapter.
+   */
+  createSchemaGenerator?: (
+    fragments: { schema: AnySchema; namespace: string }[],
+    options?: { path?: string },
   ) => SchemaGenerator;
+
+  isConnectionHealthy: () => Promise<boolean>;
 }

package/src/adapters/drizzle/drizzle-adapter-pglite.test.ts

@@ -80,6 +80,7 @@ describe("DrizzleAdapter PGLite", () => {
       "drizzle-adapter-pglite",
       testSchema,
       "postgresql",
+      "namespace",
     );
 
     // Create Drizzle instance with PGLite (in-memory Postgres)
@@ -103,13 +104,16 @@ describe("DrizzleAdapter PGLite", () => {
       provider: "postgresql",
     });
 
+    expect(await adapter.isConnectionHealthy()).toBe(true);
+
     return async () => {
       await cleanup();
     };
   }, 12000);
 
   it("should execute Unit of Work with version checking", async () => {
-    const queryEngine = adapter.createQueryEngine(testSchema, "test");
+    // Pass namespace to ensure mapper translates logical table names to physical (prefixed) names
+    const queryEngine = adapter.createQueryEngine(testSchema, "namespace");
 
     // Create initial user using UOW
     const createUow = queryEngine.createUnitOfWork("create-user").create("users", {
@@ -194,7 +198,7 @@ describe("DrizzleAdapter PGLite", () => {
   });
 
   it("should support count operations", async () => {
-    const queryEngine = adapter.createQueryEngine(testSchema, "test");
+    const queryEngine = adapter.createQueryEngine(testSchema, "namespace");
 
     // Create some users
     await queryEngine
@@ -215,7 +219,7 @@ describe("DrizzleAdapter PGLite", () => {
   });
 
   it("should support cursor-based pagination", async () => {
-    const queryEngine = adapter.createQueryEngine(testSchema, "test");
+    const queryEngine = adapter.createQueryEngine(testSchema, "namespace");
 
     const createUow = queryEngine
       .createUnitOfWork("create-users")
@@ -262,7 +266,7 @@ describe("DrizzleAdapter PGLite", () => {
   });
 
   it("should support joins", async () => {
-    const queryEngine = adapter.createQueryEngine(testSchema, "test");
+    const queryEngine = adapter.createQueryEngine(testSchema, "namespace");
     const queries: DrizzleCompiledQuery[] = [];
 
     const createUow = queryEngine
@@ -298,7 +302,7 @@ describe("DrizzleAdapter PGLite", () => {
 
     const [query] = queries;
     expect(query.sql).toMatchInlineSnapshot(
-      `"select "emails"."id", "emails"."user_id", "emails"."email", "emails"."is_primary", "emails"."_internalId", "emails"."_version", "emails_user"."data" as "user" from "emails" "emails" left join lateral (select json_build_array("emails_user"."name", "emails_user"."id", "emails_user"."age", "emails_user"."_internalId", "emails_user"."_version") as "data" from (select * from "users" "emails_user" where "emails_user"."_internalId" = "emails"."user_id" limit $1) "emails_user") "emails_user" on true"`,
+      `"select "emails_namespace"."id", "emails_namespace"."user_id", "emails_namespace"."email", "emails_namespace"."is_primary", "emails_namespace"."_internalId", "emails_namespace"."_version", "emails_namespace_user"."data" as "user" from "emails_namespace" "emails_namespace" left join lateral (select json_build_array("emails_namespace_user"."name", "emails_namespace_user"."id", "emails_namespace_user"."age", "emails_namespace_user"."_internalId", "emails_namespace_user"."_version") as "data" from (select * from "users_namespace" "emails_namespace_user" where "emails_namespace_user"."_internalId" = "emails_namespace"."user_id" limit $1) "emails_namespace_user") "emails_namespace_user" on true"`,
     );
 
     expect(email).toMatchObject({
@@ -323,7 +327,7 @@ describe("DrizzleAdapter PGLite", () => {
   });
 
   it("should support complex nested joins (comments -> post -> author)", async () => {
-    const queryEngine = adapter.createQueryEngine(testSchema, "test");
+    const queryEngine = adapter.createQueryEngine(testSchema, "namespace");
     const queries: DrizzleCompiledQuery[] = [];
 
     // Create a user (author)
@@ -427,7 +431,7 @@ describe("DrizzleAdapter PGLite", () => {
 
     const [query] = queries;
     expect(query.sql).toMatchInlineSnapshot(
-      `"select "comments"."id", "comments"."post_id", "comments"."user_id", "comments"."text", "comments"."_internalId", "comments"."_version", "comments_post"."data" as "post", "comments_commenter"."data" as "commenter" from "comments" "comments" left join lateral (select json_build_array("comments_post"."id", "comments_post"."title", "comments_post"."content", "comments_post"."_internalId", "comments_post"."_version", "comments_post_author"."data") as "data" from (select * from "posts" "comments_post" where "comments_post"."_internalId" = "comments"."post_id" order by "comments_post"."id" desc limit $1) "comments_post" left join lateral (select json_build_array("comments_post_author"."id", "comments_post_author"."name", "comments_post_author"."age", "comments_post_author"."_internalId", "comments_post_author"."_version") as "data" from (select * from "users" "comments_post_author" where "comments_post_author"."_internalId" = "comments_post"."user_id" order by "comments_post_author"."name" asc limit $2) "comments_post_author") "comments_post_author" on true) "comments_post" on true left join lateral (select json_build_array("comments_commenter"."id", "comments_commenter"."name", "comments_commenter"."_internalId", "comments_commenter"."_version") as "data" from (select * from "users" "comments_commenter" where "comments_commenter"."_internalId" = "comments"."user_id" limit $3) "comments_commenter") "comments_commenter" on true"`,
+      `"select "comments_namespace"."id", "comments_namespace"."post_id", "comments_namespace"."user_id", "comments_namespace"."text", "comments_namespace"."_internalId", "comments_namespace"."_version", "comments_namespace_post"."data" as "post", "comments_namespace_commenter"."data" as "commenter" from "comments_namespace" "comments_namespace" left join lateral (select json_build_array("comments_namespace_post"."id", "comments_namespace_post"."title", "comments_namespace_post"."content", "comments_namespace_post"."_internalId", "comments_namespace_post"."_version", "comments_namespace_post_author"."data") as "data" from (select * from "posts_namespace" "comments_namespace_post" where "comments_namespace_post"."_internalId" = "comments_namespace"."post_id" order by "comments_namespace_post"."id" desc limit $1) "comments_namespace_post" left join lateral (select json_build_array("comments_namespace_post_author"."id", "comments_namespace_post_author"."name", "comments_namespace_post_author"."age", "comments_namespace_post_author"."_internalId", "comments_namespace_post_author"."_version") as "data" from (select * from "users_namespace" "comments_namespace_post_author" where "comments_namespace_post_author"."_internalId" = "comments_namespace_post"."user_id" order by "comments_namespace_post_author"."name" asc limit $2) "comments_namespace_post_author") "comments_namespace_post_author" on true) "comments_namespace_post" on true left join lateral (select json_build_array("comments_namespace_commenter"."id", "comments_namespace_commenter"."name", "comments_namespace_commenter"."_internalId", "comments_namespace_commenter"."_version") as "data" from (select * from "users_namespace" "comments_namespace_commenter" where "comments_namespace_commenter"."_internalId" = "comments_namespace"."user_id" limit $3) "comments_namespace_commenter") "comments_namespace_commenter" on true"`,
     );
   });
 });

package/src/adapters/drizzle/drizzle-adapter.test.ts

@@ -15,7 +15,7 @@ describe("DrizzleAdapter", () => {
       provider: "postgresql",
     });
 
-    const generator = adapter.createSchemaGenerator(testSchema, "test");
+    const generator = adapter.createSchemaGenerator([{ schema: testSchema, namespace: "test" }]);
     const result = generator.generateSchema({ path: "schema.ts" });
 
     expect(result.path).toBe("schema.ts");
@@ -23,22 +23,38 @@ describe("DrizzleAdapter", () => {
       "import { pgTable, varchar, text, bigserial, integer, uniqueIndex } from "drizzle-orm/pg-core"
       import { createId } from "@fragno-dev/db/id"
 
-      export const users = pgTable("users", {
-        id: varchar("id", { length: 30 }).notNull().$defaultFn(() => createId()),
-        name: text("name").notNull(),
-        _internalId: bigserial("_internalId", { mode: "number" }).primaryKey().notNull(),
-        _version: integer("_version").notNull().default(0)
-      })
+      // ============================================================================
+      // Settings Table (shared across all fragments)
+      // ============================================================================
 
       export const fragno_db_settings = pgTable("fragno_db_settings", {
         id: varchar("id", { length: 30 }).notNull().$defaultFn(() => createId()),
         key: text("key").notNull(),
-        value: text("value").notNull().default("1"),
+        value: text("value").notNull(),
         _internalId: bigserial("_internalId", { mode: "number" }).primaryKey().notNull(),
         _version: integer("_version").notNull().default(0)
       }, (table) => [
         uniqueIndex("unique_key").on(table.key)
-      ])"
+      ])
+
+      export const fragnoDbSettingSchemaVersion = 1;
+
+      // ============================================================================
+      // Fragment: test
+      // ============================================================================
+
+      export const users_test = pgTable("users_test", {
+        id: varchar("id", { length: 30 }).notNull().$defaultFn(() => createId()),
+        name: text("name").notNull(),
+        _internalId: bigserial("_internalId", { mode: "number" }).primaryKey().notNull(),
+        _version: integer("_version").notNull().default(0)
+      })
+
+      export const test_schema = {
+        "users_test": users_test,
+        users: users_test,
+        schemaVersion: 1
+      }"
     `);
   });
 
@@ -48,7 +64,7 @@ describe("DrizzleAdapter", () => {
       provider: "sqlite",
     });
 
-    const generator = adapter.createSchemaGenerator(testSchema, "test");
+    const generator = adapter.createSchemaGenerator([{ schema: testSchema, namespace: "test" }]);
     const result = generator.generateSchema({ path: "schema.ts" });
 
     expect(result.path).toBe("schema.ts");
@@ -56,22 +72,38 @@ describe("DrizzleAdapter", () => {
       "import { sqliteTable, text, integer, uniqueIndex } from "drizzle-orm/sqlite-core"
       import { createId } from "@fragno-dev/db/id"
 
-      export const users = sqliteTable("users", {
-        id: text("id").notNull().$defaultFn(() => createId()),
-        name: text("name").notNull(),
-        _internalId: integer("_internalId").primaryKey().autoincrement().notNull(),
-        _version: integer("_version").notNull().default(0)
-      })
+      // ============================================================================
+      // Settings Table (shared across all fragments)
+      // ============================================================================
 
       export const fragno_db_settings = sqliteTable("fragno_db_settings", {
         id: text("id").notNull().$defaultFn(() => createId()),
         key: text("key").notNull(),
-        value: text("value").notNull().default("1"),
+        value: text("value").notNull(),
         _internalId: integer("_internalId").primaryKey().autoincrement().notNull(),
         _version: integer("_version").notNull().default(0)
       }, (table) => [
         uniqueIndex("unique_key").on(table.key)
-      ])"
+      ])
+
+      export const fragnoDbSettingSchemaVersion = 1;
+
+      // ============================================================================
+      // Fragment: test
+      // ============================================================================
+
+      export const users_test = sqliteTable("users_test", {
+        id: text("id").notNull().$defaultFn(() => createId()),
+        name: text("name").notNull(),
+        _internalId: integer("_internalId").primaryKey().autoincrement().notNull(),
+        _version: integer("_version").notNull().default(0)
+      })
+
+      export const test_schema = {
+        "users_test": users_test,
+        users: users_test,
+        schemaVersion: 1
+      }"
     `);
   });
 
@@ -81,10 +113,10 @@ describe("DrizzleAdapter", () => {
       provider: "postgresql",
     });
 
-    const generator = adapter.createSchemaGenerator(testSchema, "myapp");
+    const generator = adapter.createSchemaGenerator([{ schema: testSchema, namespace: "myapp" }]);
     const result = generator.generateSchema();
 
-    expect(result.path).toBe("drizzle-schema-myapp.ts");
+    expect(result.path).toBe("fragno-schema.ts");
   });
 
   it("should preserve original schema tables", () => {
@@ -93,7 +125,7 @@ describe("DrizzleAdapter", () => {
       provider: "postgresql",
     });
 
-    const generator = adapter.createSchemaGenerator(testSchema, "test");
+    const generator = adapter.createSchemaGenerator([{ schema: testSchema, namespace: "test" }]);
     const result = generator.generateSchema();
 
     // Original table should still be there
@@ -101,22 +133,38 @@ describe("DrizzleAdapter", () => {
       "import { pgTable, varchar, text, bigserial, integer, uniqueIndex } from "drizzle-orm/pg-core"
       import { createId } from "@fragno-dev/db/id"
 
-      export const users = pgTable("users", {
-        id: varchar("id", { length: 30 }).notNull().$defaultFn(() => createId()),
-        name: text("name").notNull(),
-        _internalId: bigserial("_internalId", { mode: "number" }).primaryKey().notNull(),
-        _version: integer("_version").notNull().default(0)
-      })
+      // ============================================================================
+      // Settings Table (shared across all fragments)
+      // ============================================================================
 
       export const fragno_db_settings = pgTable("fragno_db_settings", {
         id: varchar("id", { length: 30 }).notNull().$defaultFn(() => createId()),
         key: text("key").notNull(),
-        value: text("value").notNull().default("1"),
+        value: text("value").notNull(),
         _internalId: bigserial("_internalId", { mode: "number" }).primaryKey().notNull(),
         _version: integer("_version").notNull().default(0)
       }, (table) => [
         uniqueIndex("unique_key").on(table.key)
-      ])"
+      ])
+
+      export const fragnoDbSettingSchemaVersion = 1;
+
+      // ============================================================================
+      // Fragment: test
+      // ============================================================================
+
+      export const users_test = pgTable("users_test", {
+        id: varchar("id", { length: 30 }).notNull().$defaultFn(() => createId()),
+        name: text("name").notNull(),
+        _internalId: bigserial("_internalId", { mode: "number" }).primaryKey().notNull(),
+        _version: integer("_version").notNull().default(0)
+      })
+
+      export const test_schema = {
+        "users_test": users_test,
+        users: users_test,
+        schemaVersion: 1
+      }"
     `);
   });
 });

package/src/adapters/drizzle/drizzle-adapter.ts

@@ -1,19 +1,12 @@
 import type { DatabaseAdapter } from "../adapters";
-import {
-  column,
-  idColumn,
-  schema,
-  SchemaBuilder,
-  type AnySchema,
-  type FragnoId,
-} from "../../schema/create";
+import { type AnySchema } from "../../schema/create";
 import type { AbstractQuery } from "../../query/query";
 import type { SchemaGenerator } from "../../schema-generator/schema-generator";
 import { generateSchema } from "./generate";
 import { fromDrizzle, type DrizzleUOWConfig } from "./drizzle-query";
-import { createId } from "../../id";
-
-const SETTINGS_TABLE_NAME = "fragno_db_settings" as const;
+import { createTableNameMapper, type DBType, type DrizzleResult } from "./shared";
+import { createSettingsManager, settingsSchema } from "../../shared/settings-schema";
+import { sql } from "drizzle-orm";
 
 export interface DrizzleConfig {
   db: unknown;
@@ -27,92 +20,52 @@ export class DrizzleAdapter implements DatabaseAdapter<DrizzleUOWConfig> {
     this.#drizzleConfig = config;
   }
 
-  #createFullSchema<T extends AnySchema>(schema: T) {
-    return new SchemaBuilder()
-      .mergeWithExistingSchema(schema)
-      .mergeWithExistingSchema(createSettingsSchema(schema.version))
-      .build();
+  get provider(): "sqlite" | "mysql" | "postgresql" {
+    return this.#drizzleConfig.provider;
+  }
+
+  async isConnectionHealthy(): Promise<boolean> {
+    try {
+      const result = (await (this.#drizzleConfig.db as DBType).execute(
+        sql`SELECT 1 as healthy`,
+      )) as DrizzleResult;
+      return result.rows[0]["healthy"] === 1;
+    } catch {
+      return false;
+    }
   }
 
   async getSchemaVersion(namespace: string): Promise<string | undefined> {
-    const queryEngine = this.createQueryEngine(createSettingsSchema(0), namespace);
+    const queryEngine = this.createQueryEngine(settingsSchema, namespace);
     const manager = createSettingsManager(queryEngine, namespace);
-    const randomId = createId();
-
-    const result = await manager.createKeyWithDefault(randomId);
-    if (result) {
-      await manager.delete(result.id);
-    }
 
+    // Try to read the version key directly
+    const result = await manager.get("version");
     return result?.value;
   }
 
   createQueryEngine<TSchema extends AnySchema>(
     schema: TSchema,
-    _namespace: string,
+    namespace: string,
   ): AbstractQuery<TSchema, DrizzleUOWConfig> {
-    return fromDrizzle(schema, this.#drizzleConfig);
+    // Only create mapper if namespace is non-empty
+    const mapper = namespace ? createTableNameMapper(namespace) : undefined;
+    return fromDrizzle(schema, this.#drizzleConfig, mapper);
   }
 
-  createSchemaGenerator(schema: AnySchema, namespace: string): SchemaGenerator {
+  createSchemaGenerator(
+    fragments: { schema: AnySchema; namespace: string }[],
+    options?: { path?: string },
+  ): SchemaGenerator {
     return {
-      generateSchema: (options) => {
-        const path = options?.path ?? `drizzle-schema-${namespace}.ts`;
-
-        const schemaWithSettingsTable = this.#createFullSchema(schema);
+      generateSchema: (genOptions) => {
+        const path = genOptions?.path ?? options?.path ?? "fragno-schema.ts";
 
         return {
-          schema: generateSchema(schemaWithSettingsTable, this.#drizzleConfig.provider),
+          schema: generateSchema(fragments, this.#drizzleConfig.provider),
           path,
         };
       },
     };
   }
 }
-
-function createSettingsSchema(version: number) {
-  return schema((s) => {
-    return s.addTable(SETTINGS_TABLE_NAME, (t) => {
-      return t
-        .addColumn("id", idColumn())
-        .addColumn("key", column("string"))
-        .addColumn("value", column("string").defaultTo(String(version)))
-        .createIndex("unique_key", ["key"], { unique: true });
-    });
-  });
-}
-
-function createSettingsManager(
-  queryEngine: AbstractQuery<ReturnType<typeof createSettingsSchema>, DrizzleUOWConfig>,
-  namespace: string,
-) {
-  return {
-    async createKeyWithDefault(key: string) {
-      const writeUow = queryEngine
-        .createUnitOfWork("createKeyWithDefault")
-        .create(SETTINGS_TABLE_NAME, {
-          key: `${namespace}.${key}`,
-        });
-      const { success } = await writeUow.executeMutations();
-      if (!success) {
-        throw new Error("Failed to create key with default");
-      }
-
-      return this.get(key);
-    },
-
-    async get(key: string): Promise<{ id: FragnoId; key: string; value: string } | undefined> {
-      const uow = queryEngine
-        .createUnitOfWork()
-        .find(SETTINGS_TABLE_NAME, (b) =>
-          b.whereIndex("unique_key", (eb) => eb("key", "=", `${namespace}.${key}`)),
-        );
-      const [[result]] = await uow.executeRetrieve();
-      return result; // FIXME: result should be maybe undefined
-    },
-
-    async delete(id: FragnoId) {
-      await queryEngine.delete(SETTINGS_TABLE_NAME, id);
-    },
-  };
-}

package/src/adapters/drizzle/drizzle-query.ts

@@ -5,14 +5,9 @@ import type { CompiledMutation, UOWExecutor } from "../../query/unit-of-work";
 import { createDrizzleUOWCompiler, type DrizzleCompiledQuery } from "./drizzle-uow-compiler";
 import { executeDrizzleRetrievalPhase, executeDrizzleMutationPhase } from "./drizzle-uow-executor";
 import { UnitOfWork } from "../../query/unit-of-work";
-import { parseDrizzle } from "./shared";
+import { parseDrizzle, type DrizzleResult, type TableNameMapper } from "./shared";
 import { createDrizzleUOWDecoder } from "./drizzle-uow-decoder";
 
-export interface DrizzleResult {
-  rows: Record<string, unknown>[];
-  affectedRows: number;
-}
-
 /**
  * Configuration options for creating a Drizzle Unit of Work
  */
@@ -33,6 +28,7 @@ export interface DrizzleUOWConfig {
  *
  * @param schema - The database schema definition
  * @param config - Drizzle configuration containing the database instance and provider
+ * @param mapper - Optional table name mapper for namespace prefixing
  * @returns An AbstractQuery instance for performing database operations
  *
  * @example
@@ -48,12 +44,13 @@ export interface DrizzleUOWConfig {
 export function fromDrizzle<T extends AnySchema>(
   schema: T,
   config: DrizzleConfig,
+  mapper?: TableNameMapper,
 ): AbstractQuery<T, DrizzleUOWConfig> {
   const [db] = parseDrizzle(config.db);
   const { provider } = config;
 
   function createUOW(name?: string, uowConfig?: DrizzleUOWConfig) {
-    const uowCompiler = createDrizzleUOWCompiler(schema, config, uowConfig?.onQuery);
+    const uowCompiler = createDrizzleUOWCompiler(schema, config, mapper, uowConfig?.onQuery);
 
     const executor: UOWExecutor<DrizzleCompiledQuery, DrizzleResult> = {
       executeRetrievalPhase: (retrievalBatch: DrizzleCompiledQuery[]) =>

package/src/adapters/drizzle/drizzle-uow-compiler.test.ts

@@ -755,9 +755,15 @@ describe("drizzle-uow-compiler", () => {
         return t
           .addColumn("id", idColumn())
           .addColumn("message", column("string"))
-          .addColumn("sessionId", column("string").defaultTo$("auto")) // runtime auto
-          .addColumn("timestamp", column("timestamp").defaultTo$("now")) // runtime now
-          .addColumn("counter", column("integer").defaultTo$((() => 42) as () => number)) // runtime function
+          .addColumn(
+            "sessionId",
+            column("string").defaultTo$((b) => b.cuid()),
+          ) // runtime cuid
+          .addColumn(
+            "timestamp",
+            column("timestamp").defaultTo$((b) => b.now()),
+          ) // runtime now
+          .addColumn("counter", column("integer").defaultTo$(42)) // runtime function
           .addColumn("status", column("string").defaultTo("pending")) // static default
           .createIndex("idx_session", ["sessionId"]);
       });
@@ -787,7 +793,7 @@ describe("drizzle-uow-compiler", () => {
       return async () => {
         await cleanup();
       };
-    });
+    }, 12000);
 
     it("should generate runtime defaults for missing columns", () => {
       const uow = createTestUOWWithSchema(defaultsSchema);