@fragno-dev/db 0.1.14 → 0.2.0

package/dist/sql-driver/sql.js

@@ -0,0 +1,50 @@
+import { sql } from "kysely";
+
+//#region src/sql-driver/sql.ts
+/**
+* Wrapper around Kysely's RawBuilder that provides a compile() method with a dialect parameter.
+*/
+var RawBuilder = class {
+	#kyselyBuilder;
+	constructor(kyselyBuilder) {
+		this.#kyselyBuilder = kyselyBuilder;
+	}
+	/**
+	* Compiles the SQL query using the provided Kysely dialect.
+	* Creates a minimal query executor with the dialect's adapter and query compiler.
+	*
+	* @param dialect - Kysely dialect (e.g., SqliteDialect, PostgresDialect, MysqlDialect)
+	* @returns Compiled query with SQL string and parameters
+	*/
+	compile(dialect) {
+		const queryCompiler = dialect.createQueryCompiler();
+		return this.#kyselyBuilder.compile({ getExecutor() {
+			return {
+				transformQuery(node, _queryId) {
+					return node;
+				},
+				compileQuery(node, queryId) {
+					return queryCompiler.compileQuery(node, queryId);
+				}
+			};
+		} });
+	}
+};
+/**
+* Tagged template function for building SQL queries with parameters.
+* Wraps Kysely's sql function to provide a compile() method without arguments.
+*
+* @example
+* ```ts
+* const userId = 123;
+* const query = sql`SELECT * FROM users WHERE id = ${userId}`;
+* const compiled = query.compile();
+* ```
+*/
+function sql$1(strings, ...values) {
+	return new RawBuilder(sql(strings, ...values));
+}
+
+//#endregion
+export { sql$1 as sql };
+//# sourceMappingURL=sql.js.map

package/dist/sql-driver/sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.js","names":["#kyselyBuilder","sql","kyselySql"],"sources":["../../src/sql-driver/sql.ts"],"sourcesContent":["import type { CompiledQuery, Dialect } from \"./sql-driver\";\nimport {\n  sql as kyselySql,\n  type QueryExecutor,\n  type CompiledQuery as KyselyCompiledQuery,\n} from \"kysely\";\n\n/**\n * Wrapper around Kysely's RawBuilder that provides a compile() method with a dialect parameter.\n */\nexport class RawBuilder {\n  #kyselyBuilder: ReturnType<typeof kyselySql>;\n\n  constructor(kyselyBuilder: ReturnType<typeof kyselySql>) {\n    this.#kyselyBuilder = kyselyBuilder;\n  }\n\n  /**\n   * Compiles the SQL query using the provided Kysely dialect.\n   * Creates a minimal query executor with the dialect's adapter and query compiler.\n   *\n   * @param dialect - Kysely dialect (e.g., SqliteDialect, PostgresDialect, MysqlDialect)\n   * @returns Compiled query with SQL string and parameters\n   */\n  compile(dialect: Dialect): CompiledQuery {\n    const queryCompiler = dialect.createQueryCompiler();\n\n    return this.#kyselyBuilder.compile({\n      getExecutor(): QueryExecutor {\n        return {\n          transformQuery(node, _queryId) {\n            return node;\n          },\n          compileQuery(node, queryId) {\n            return queryCompiler.compileQuery(node, queryId) as KyselyCompiledQuery;\n          },\n        } as QueryExecutor;\n      },\n    });\n  }\n}\n\n/**\n * Tagged template function for building SQL queries with parameters.\n * Wraps Kysely's sql function to provide a compile() method without arguments.\n *\n * @example\n * ```ts\n * const userId = 123;\n * const query = sql`SELECT * FROM users WHERE id = ${userId}`;\n * const compiled = query.compile();\n * ```\n */\nexport function sql(strings: TemplateStringsArray, ...values: unknown[]): RawBuilder {\n  const kyselyBuilder = kyselySql(strings, ...values);\n  return new RawBuilder(kyselyBuilder);\n}\n"],"mappings":";;;;;;AAUA,IAAa,aAAb,MAAwB;CACtB;CAEA,YAAY,eAA6C;AACvD,QAAKA,gBAAiB;;;;;;;;;CAUxB,QAAQ,SAAiC;EACvC,MAAM,gBAAgB,QAAQ,qBAAqB;AAEnD,SAAO,MAAKA,cAAe,QAAQ,EACjC,cAA6B;AAC3B,UAAO;IACL,eAAe,MAAM,UAAU;AAC7B,YAAO;;IAET,aAAa,MAAM,SAAS;AAC1B,YAAO,cAAc,aAAa,MAAM,QAAQ;;IAEnD;KAEJ,CAAC;;;;;;;;;;;;;;AAeN,SAAgBC,MAAI,SAA+B,GAAG,QAA+B;AAEnF,QAAO,IAAI,WADWC,IAAU,SAAS,GAAG,OAAO,CACf"}

package/dist/with-database.d.ts

@@ -0,0 +1,32 @@
+import { AnySchema } from "./schema/create.js";
+import { DatabaseFragmentDefinitionBuilder, DatabaseHandlerContext, DatabaseServiceContext, ImplicitDatabaseDependencies } from "./db-fragment-definition-builder.js";
+import { InternalFragmentInstance } from "./fragments/internal-fragment.js";
+import { HooksMap } from "./hooks/hooks.js";
+import { AnyFragnoInstantiatedFragment, FragmentDefinitionBuilder, FragnoPublicConfig, RequestThisContext } from "@fragno-dev/core";
+
+//#region src/with-database.d.ts
+
+/**
+ * Helper to add database support to a fragment builder.
+ * Automatically links the internal fragment and adds ImplicitDatabaseDependencies to the TDeps type.
+ *
+ * @example
+ * ```typescript
+ * // With .extend() - recommended
+ * const def = defineFragment("my-frag")
+ *   .extend(withDatabase(mySchema))
+ *   .withDependencies(...)
+ *   .build();
+ *
+ * // Or as a function wrapper
+ * const def = withDatabase(mySchema)(defineFragment("my-frag"))
+ *   .withDependencies(...)
+ *   .build();
+ * ```
+ */
+declare function withDatabase<TSchema extends AnySchema>(schema: TSchema, namespace?: string): <TConfig, TDeps, TBaseServices, TServices, TServiceDeps, TPrivateServices, TServiceThisContext extends RequestThisContext, THandlerThisContext extends RequestThisContext, TRequestStorage, TLinkedFragments extends Record<string, AnyFragnoInstantiatedFragment>>(builder: FragmentDefinitionBuilder<TConfig, FragnoPublicConfig, TDeps, TBaseServices, TServices, TServiceDeps, TPrivateServices, TServiceThisContext, THandlerThisContext, TRequestStorage, TLinkedFragments>) => DatabaseFragmentDefinitionBuilder<TSchema, TConfig, TDeps & ImplicitDatabaseDependencies<TSchema>, TBaseServices, TServices, TServiceDeps, TPrivateServices, HooksMap, DatabaseServiceContext<HooksMap>, DatabaseHandlerContext, TLinkedFragments & {
+  _fragno_internal: InternalFragmentInstance;
+}>;
+//#endregion
+export { withDatabase };
+//# sourceMappingURL=with-database.d.ts.map

package/dist/with-database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-database.d.ts","names":[],"sources":["../src/with-database.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAoCA;;;;;;;;;;;;;;;;;AA0BI,iBA1BY,YA0BZ,CAAA,gBA1ByC,SA0BzC,CAAA,CAAA,MAAA,EAzBM,OAyBN,EAAA,SAAA,CAAA,EAAA,MAAA,CAAA,EAAA,CAAA,OAAA,EAAA,KAAA,EAAA,aAAA,EAAA,SAAA,EAAA,YAAA,EAAA,gBAAA,EAAA,4BAhB0B,kBAgB1B,EAAA,4BAf0B,kBAe1B,EAAA,eAAA,EAAA,yBAbuB,MAavB,CAAA,MAAA,EAbsC,6BAatC,CAAA,CAAA,CAAA,OAAA,EAXO,yBAWP,CAVA,OAUA,EATA,kBASA,EARA,KAQA,EAPA,aAOA,EANA,SAMA,EALA,YAKA,EAJA,gBAIA,EAHA,mBAGA,EAFA,mBAEA,EADA,eACA,EAAA,gBAAA,CAAA,EAAA,GAEC,iCAFD,CAGF,OAHE,EAIF,OAJE,EAKF,KALE,GAKM,4BALN,CAKmC,OALnC,CAAA,EAMF,aANE,EAOF,SAPE,EAQF,YARE,EASF,gBATE,EAUF,QAVE,EAWF,sBAXE,CAWqB,QAXrB,CAAA,EAYF,sBAZE,EAaF,gBAbE,GAAA;EAXO,gBAAA,EAwB8B,wBAxB9B;CAcT,CAAA"}

package/dist/with-database.js

@@ -0,0 +1,34 @@
+import { instantiate } from "./packages/fragno/dist/api/fragment-instantiator.js";
+import { DatabaseFragmentDefinitionBuilder } from "./db-fragment-definition-builder.js";
+import { internalFragmentDef } from "./fragments/internal-fragment.js";
+
+//#region src/with-database.ts
+/**
+* Helper to add database support to a fragment builder.
+* Automatically links the internal fragment and adds ImplicitDatabaseDependencies to the TDeps type.
+*
+* @example
+* ```typescript
+* // With .extend() - recommended
+* const def = defineFragment("my-frag")
+*   .extend(withDatabase(mySchema))
+*   .withDependencies(...)
+*   .build();
+*
+* // Or as a function wrapper
+* const def = withDatabase(mySchema)(defineFragment("my-frag"))
+*   .withDependencies(...)
+*   .build();
+* ```
+*/
+function withDatabase(schema, namespace) {
+	return (builder) => {
+		return new DatabaseFragmentDefinitionBuilder(builder.withLinkedFragment("_fragno_internal", ({ config, options }) => {
+			return instantiate(internalFragmentDef).withConfig(config).withOptions(options).build();
+		}), schema, namespace);
+	};
+}
+
+//#endregion
+export { withDatabase };
+//# sourceMappingURL=with-database.js.map

package/dist/with-database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-database.js","names":[],"sources":["../src/with-database.ts"],"sourcesContent":["import type { AnySchema } from \"./schema/create\";\nimport type {\n  RequestThisContext,\n  FragnoPublicConfig,\n  AnyFragnoInstantiatedFragment,\n} from \"@fragno-dev/core\";\nimport { FragmentDefinitionBuilder, instantiate } from \"@fragno-dev/core\";\nimport {\n  DatabaseFragmentDefinitionBuilder,\n  type DatabaseServiceContext,\n  type DatabaseHandlerContext,\n  type ImplicitDatabaseDependencies,\n  type FragnoPublicConfigWithDatabase,\n  type DatabaseRequestStorage,\n} from \"./db-fragment-definition-builder\";\nimport { internalFragmentDef, type InternalFragmentInstance } from \"./fragments/internal-fragment\";\nimport type { HooksMap } from \"./hooks/hooks\";\n\n/**\n * Helper to add database support to a fragment builder.\n * Automatically links the internal fragment and adds ImplicitDatabaseDependencies to the TDeps type.\n *\n * @example\n * ```typescript\n * // With .extend() - recommended\n * const def = defineFragment(\"my-frag\")\n *   .extend(withDatabase(mySchema))\n *   .withDependencies(...)\n *   .build();\n *\n * // Or as a function wrapper\n * const def = withDatabase(mySchema)(defineFragment(\"my-frag\"))\n *   .withDependencies(...)\n *   .build();\n * ```\n */\nexport function withDatabase<TSchema extends AnySchema>(\n  schema: TSchema,\n  namespace?: string,\n): <\n  TConfig,\n  TDeps,\n  TBaseServices,\n  TServices,\n  TServiceDeps,\n  TPrivateServices,\n  TServiceThisContext extends RequestThisContext,\n  THandlerThisContext extends RequestThisContext,\n  TRequestStorage,\n  TLinkedFragments extends Record<string, AnyFragnoInstantiatedFragment>,\n>(\n  builder: FragmentDefinitionBuilder<\n    TConfig,\n    FragnoPublicConfig,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDeps,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    TRequestStorage,\n    TLinkedFragments\n  >,\n) => DatabaseFragmentDefinitionBuilder<\n  TSchema,\n  TConfig,\n  TDeps & ImplicitDatabaseDependencies<TSchema>,\n  TBaseServices,\n  TServices,\n  TServiceDeps,\n  TPrivateServices,\n  HooksMap,\n  DatabaseServiceContext<HooksMap>,\n  DatabaseHandlerContext,\n  TLinkedFragments & { _fragno_internal: InternalFragmentInstance }\n> {\n  return <\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDeps,\n    TPrivateServices,\n    TServiceThisContext extends RequestThisContext,\n    THandlerThisContext extends RequestThisContext,\n    TRequestStorage,\n    TLinkedFragments extends Record<string, AnyFragnoInstantiatedFragment>,\n  >(\n    builder: FragmentDefinitionBuilder<\n      TConfig,\n      FragnoPublicConfig,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDeps,\n      TPrivateServices,\n      TServiceThisContext,\n      THandlerThisContext,\n      TRequestStorage,\n      TLinkedFragments\n    >,\n  ) => {\n    const builderWithInternal = builder.withLinkedFragment(\n      \"_fragno_internal\",\n      ({ config, options }) => {\n        // Cast is safe: by the time this callback is invoked during fragment instantiation,\n        // the options will be FragnoPublicConfigWithDatabase (enforced by DatabaseFragmentDefinitionBuilder)\n        return instantiate(internalFragmentDef)\n          .withConfig(config as {})\n          .withOptions(options as FragnoPublicConfigWithDatabase)\n          .build();\n      },\n    );\n\n    // Cast is safe: we're creating a DatabaseFragmentDefinitionBuilder which internally uses\n    // FragnoPublicConfigWithDatabase, but the input builder uses FragnoPublicConfig.\n    // The database builder's build() method will enforce FragnoPublicConfigWithDatabase at the end.\n    // We also add ImplicitDatabaseDependencies to TDeps so they're available in service constructors.\n    // Note: We discard TRequestStorage here because database fragments manage their own storage (DatabaseRequestStorage).\n    // We set TServiceThisContext to DatabaseServiceContext (restricted) and THandlerThisContext to DatabaseHandlerContext (full).\n    return new DatabaseFragmentDefinitionBuilder<\n      TSchema,\n      TConfig,\n      TDeps & ImplicitDatabaseDependencies<TSchema>,\n      TBaseServices,\n      TServices,\n      TServiceDeps,\n      TPrivateServices,\n      {}, // Start with empty hooks, provideHooks() will update this\n      DatabaseServiceContext<{}>,\n      DatabaseHandlerContext,\n      TLinkedFragments & { _fragno_internal: InternalFragmentInstance }\n    >(\n      builderWithInternal as unknown as FragmentDefinitionBuilder<\n        TConfig,\n        FragnoPublicConfigWithDatabase,\n        TDeps & ImplicitDatabaseDependencies<TSchema>,\n        TBaseServices,\n        TServices,\n        TServiceDeps,\n        TPrivateServices,\n        DatabaseServiceContext<{}>,\n        DatabaseHandlerContext,\n        DatabaseRequestStorage,\n        TLinkedFragments & { _fragno_internal: InternalFragmentInstance }\n      >,\n      schema,\n      namespace,\n    );\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,aACd,QACA,WAsCA;AACA,SAYE,YAaG;AAmBH,SAAO,IAAI,kCAlBiB,QAAQ,mBAClC,qBACC,EAAE,QAAQ,cAAc;AAGvB,UAAO,YAAY,oBAAoB,CACpC,WAAW,OAAa,CACxB,YAAY,QAA0C,CACtD,OAAO;IAEb,EAkCC,QACA,UACD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fragno-dev/db",
-  "version": "0.1.14",
+  "version": "0.2.0",
   "type": "module",
   "exports": {
     ".": {
@@ -18,10 +18,30 @@
       "types": "./dist/schema/create.d.ts",
       "default": "./dist/schema/create.js"
     },
+    "./drivers": {
+      "development": "./src/adapters/generic-sql/driver-config.ts",
+      "types": "./dist/adapters/generic-sql/driver-config.d.ts",
+      "default": "./dist/adapters/generic-sql/driver-config.js"
+    },
+    "./sql-driver": {
+      "development": "./src/sql-driver/sql-driver.ts",
+      "types": "./dist/sql-driver/sql-driver.d.ts",
+      "default": "./dist/sql-driver/sql-driver.js"
+    },
+    "./dialects": {
+      "development": "./src/sql-driver/dialects/dialects.ts",
+      "types": "./dist/sql-driver/dialects/dialects.d.ts",
+      "default": "./dist/sql-driver/dialects/dialects.js"
+    },
+    "./dialects/durable-object": {
+      "development": "./src/sql-driver/dialects/durable-object-dialect.ts",
+      "types": "./dist/sql-driver/dialects/durable-object-dialect.d.ts",
+      "default": "./dist/sql-driver/dialects/durable-object-dialect.js"
+    },
     "./query": {
-      "development": "./src/query/query.ts",
-      "types": "./dist/query/query.d.ts",
-      "default": "./dist/query/query.js"
+      "development": "./src/query/simple-query-interface.ts",
+      "types": "./dist/query/simple-query-interface.d.ts",
+      "default": "./dist/query/simple-query-interface.js"
     },
     "./adapters": {
       "development": "./src/adapters/adapters.ts",
@@ -43,10 +63,15 @@
       "types": "./dist/adapters/drizzle/generate.d.ts",
       "default": "./dist/adapters/drizzle/generate.js"
     },
+    "./adapters/generic-sql": {
+      "development": "./src/adapters/generic-sql/generic-sql-adapter.ts",
+      "types": "./dist/adapters/generic-sql/generic-sql-adapter.d.ts",
+      "default": "./dist/adapters/generic-sql/generic-sql-adapter.js"
+    },
     "./unit-of-work": {
-      "development": "./src/query/unit-of-work.ts",
-      "types": "./dist/query/unit-of-work.d.ts",
-      "default": "./dist/query/unit-of-work.js"
+      "development": "./src/query/unit-of-work/unit-of-work.ts",
+      "types": "./dist/query/unit-of-work/unit-of-work.d.ts",
+      "default": "./dist/query/unit-of-work/unit-of-work.js"
     },
     "./cursor": {
       "development": "./src/query/cursor.ts",
@@ -58,6 +83,11 @@
       "types": "./dist/fragment.d.ts",
       "default": "./dist/fragment.js"
     },
+    "./fragment-definition-builder": {
+      "development": "./src/db-fragment-definition-builder.ts",
+      "types": "./dist/db-fragment-definition-builder.d.ts",
+      "default": "./dist/db-fragment-definition-builder.js"
+    },
     "./generation-engine": {
       "development": "./src/migration-engine/generation-engine.ts",
       "types": "./dist/migration-engine/generation-engine.d.ts",
@@ -67,14 +97,18 @@
   "devDependencies": {
     "@electric-sql/pglite": "^0.3.10",
     "@libsql/client": "^0.15.15",
+    "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^22",
     "@vitest/coverage-istanbul": "^3.2.4",
+    "better-sqlite3": "^12.5.0",
     "drizzle-kit": "^0.31.5",
     "drizzle-orm": "^0.44.6",
     "kysely-pglite": "^0.6.1",
+    "mysql2": "^3.11.5",
+    "sqlocal": "^0.15.2",
     "vitest": "^3.2.4",
     "zod": "^4.1.12",
-    "@fragno-dev/core": "0.1.8",
+    "@fragno-dev/core": "0.1.11",
     "@fragno-private/typescript-config": "0.0.1",
     "@fragno-private/vitest-config": "0.0.0"
   },
@@ -86,7 +120,7 @@
   "homepage": "https://fragno.dev",
   "license": "MIT",
   "dependencies": {
-    "@paralleldrive/cuid2": "^2.2.2",
+    "@paralleldrive/cuid2": "^2.3.1",
     "kysely": "^0.28.7"
   },
   "peerDependencies": {

package/src/adapters/adapters.ts

@@ -1,11 +1,21 @@
-import type { Migrator } from "../migration-engine/create";
-import type { AbstractQuery } from "../query/query";
+import type { SimpleQueryInterface } from "../query/simple-query-interface";
 import type { SchemaGenerator } from "../schema-generator/schema-generator";
 import type { AnySchema } from "../schema/create";
+import type { RequestContextStorage } from "@fragno-dev/core/internal/request-context-storage";
+import type { IUnitOfWork } from "../query/unit-of-work/unit-of-work";
+import type { PreparedMigrations } from "./generic-sql/migration/prepared-migrations";
 
 export const fragnoDatabaseAdapterNameFakeSymbol = "$fragno-database-adapter-name" as const;
 export const fragnoDatabaseAdapterVersionFakeSymbol = "$fragno-database-adapter-version" as const;
 
+/**
+ * Storage type for database context - stores the Unit of Work.
+ * This is shared across all fragments using the same adapter.
+ */
+export type DatabaseContextStorage = {
+  uow: IUnitOfWork;
+};
+
 /**
  * Maps logical table names (used by fragment authors) to physical table names (with namespace suffix)
  */
@@ -18,6 +28,12 @@ export interface DatabaseAdapter<TUOWConfig = void> {
   [fragnoDatabaseAdapterNameFakeSymbol]: string;
   [fragnoDatabaseAdapterVersionFakeSymbol]: number;
 
+  /**
+   * Request context storage shared across all fragments using this adapter.
+   * This allows multiple fragments to participate in the same Unit of Work.
+   */
+  readonly contextStorage: RequestContextStorage<DatabaseContextStorage>;
+
   /**
    * Get current schema version, undefined if not initialized.
    */
@@ -26,9 +42,12 @@ export interface DatabaseAdapter<TUOWConfig = void> {
   createQueryEngine: <const T extends AnySchema>(
     schema: T,
     namespace: string,
-  ) => AbstractQuery<T, TUOWConfig>;
+  ) => SimpleQueryInterface<T, TUOWConfig>;
 
-  createMigrationEngine?: <const T extends AnySchema>(schema: T, namespace: string) => Migrator;
+  prepareMigrations?: <const T extends AnySchema>(
+    schema: T,
+    namespace: string,
+  ) => PreparedMigrations;
 
   /**
    * Generate a combined schema file from one or more fragments.