@fragno-dev/db 0.2.2 → 0.4.1

package/CHANGELOG.md

@@ -1,5 +1,114 @@
 # @fragno-dev/db
 
+## 0.4.1
+
+### Patch Changes
+
+- Updated dependencies [0020e39]
+  - @fragno-dev/core@0.2.2
+
+## 0.4.0
+
+### Minor Changes
+
+- 8a96998: feat: allow altering existing columns to become nullable
+
+### Patch Changes
+
+- 3e2ff94: feat: register schemas via adapter registry and mount internal routes
+- f34d7d7: fix: ensure cross-schema durable hook enqueuing works reliably
+- 4d141f8: fix: remove development exports from published packages
+- c8841b5: feat: add callServices helper with implicit request context
+- ae54a60: fix: add browser-safe db entry and rewrite sync command imports for browser builds
+- 7dd7055: feat: remove deps.db and add db-time helpers on builders
+- e178bf4: fix: treat missing left-joined relations as null/[]
+- d2f68ba: feat: add db now offsets and interval helpers
+- 75191db: fix: return fresh DO SQL connections per acquire
+- d395ad2: fix: improve durable hook claiming and wake scheduling
+- 75407f3: feat: add durable hook pagination and newest-first indexing
+- bfdd4b1: fix: skip better-sqlite3 fallback in Cloudflare workers
+- 3ffa711: fix: align dev browser exports to avoid server entry in clients
+- c2c3229: fix: ignore join-only relations in in-memory FK enforcement
+- e559425: feat: add serviceCalls helper to preserve tuple inference for service deps
+- fc5c256: fix(fragno-db): decode bigint values from SQLite blob columns
+- 93fa469: fix: replace cuid2 with a shared Web Crypto id generator
+- 14e00b1: feat: expose hook event metadata in HookContext
+- f33286c: feat: add join-only addReference foreignKey:false support
+- 95cdf95: feat: add browser-safe client exports entrypoint
+- eabdb9c: feat(db): add in-memory outbox support
+- 9eeba53: feat: add internal fragment describe metadata and adapter identity
+- 49a9f4f: feat: add internal outbox mutation log and sync request tables
+- dcba383: fix: write outbox mutation log rows during commits
+- c895c07: feat(db): add internal sync submit endpoint and idempotency
+- ed4b4a0: fix: add workerd/worker export conditions for server entry resolution
+- 1102ce0: fix: support multi-column cursor pagination for SQL adapters
+- ad2ef56: feat: move outbox opt-in to fragment options
+- 0f9b7ef: refactor: replace linked fragments with internal routes
+- 6d043ea: feat: add durable hooks runtime and dispatcher helpers
+- fe55a13: feat(db): add read tracking hooks and plan mode support
+- 01fc2cb: fix: scope db roundtrip guard to route handlers and enable by default in tests
+- 0176aa8: fix: coerce join-only left-side ids and join where aliases
+- 00f2631: feat: allow triggerHook to accept explicit hook ids
+- c13c1c1: fix: handle sqlite FK preprocessing when FK columns are added in alter-table
+- 0a6c8da: fix: stabilize sqlite recreate-table migrations
+- 7a40517: fix: stabilize schema output ordering by schema name
+- 91a2ac0: feat: add WorkflowStepTx API for step-scoped mutations
+- 7bda0b2: feat(db): add sync command registry, registration, and sync entrypoint
+- c115600: feat: widen external ids to 128 chars
+- Updated dependencies [3e2ff94]
+- Updated dependencies [f34d7d7]
+- Updated dependencies [4d141f8]
+- Updated dependencies [c8841b5]
+- Updated dependencies [83f6223]
+- Updated dependencies [567c3b3]
+- Updated dependencies [8a2da9d]
+- Updated dependencies [93fa469]
+- Updated dependencies [b3ad7eb]
+- Updated dependencies [9eeba53]
+- Updated dependencies [2ae432c]
+- Updated dependencies [9f87189]
+- Updated dependencies [0f9b7ef]
+- Updated dependencies [f4aedad]
+- Updated dependencies [f042c9d]
+- Updated dependencies [7bda0b2]
+- Updated dependencies [b84a3d0]
+  - @fragno-dev/core@0.2.1
+
+## 0.3.0
+
+### Minor Changes
+
+- 8e9b6cd: feat(db,cli): add SqlAdapter and explicit schema output formats
+
+  BREAKING CHANGE: The database adapter API now requires SqlAdapter with explicit schema output
+  formats.
+
+### Patch Changes
+
+- dbbbf60: fix: ensure unit-of-work after-phase hooks run on errors
+- 3e07799: fix: allow durable hook processing to bypass wrapper adapters and widen drain helpers
+- 20a98f8: feat: expose internal outbox route under /\_internal when outbox is enabled
+- 1902f30: fix(db): normalize postgres timestamp decoding for timezone-less values.
+- 15e3263: feat(db): require schema names and support namespace-aware SQL naming
+- 208cb8e: feat: add runtime validation for table inserts
+- 33f671b: fix(db): add dbNow value support, cursor pagination, and retry conflict handling
+- fc803fc: fix(db): ensure Drizzle SQLite external ids are enforced as unique indexes.
+- 0628c1f: fix(db): requeue durable hooks stuck in processing after a timeout
+- 7e1eb47: feat(db): add processAt scheduling and reusable durable hooks dispatchers.
+- 1dc4e7f: fix: disable handlerTx retries when no retrieve ops and reject explicit retry policies
+- 3c9fbac: fix(db): align GenericSQL migration defaults and constraint names with Drizzle output.
+- a5ead11: feat(db): add Prisma adapter and SQLite Prisma profile support.
+- c4d4cc6: feat: default to sqlite adapter when databaseAdapter is omitted (better-sqlite3
+  installed)
+- d4baad3: fix: explicit databaseNamespace values are now used as-is without sanitization; default
+  namespace (from schema.name) is still sanitized
+- 548bf37: feat(db): expose handlerTx in durable hook context and deprecate direct query engines.
+- 3041732: fix: run durable hooks off-request and relax pending task leases
+- 7e179d1: feat(db): remove workflows dispatcher packages in favor of db dispatchers.
+- 0013fa6: fix(db): store outbox versionstamps as strings.
+- 69b9a79: fix: harden durable hook claiming and wake scheduling
+- 5cef16e: feat(db,test): add SQL outbox support and adapter testing configuration.
+
 ## 0.2.2
 
 ### Patch Changes

package/README.md

@@ -2,8 +2,9 @@
 
 Optional, ORM-agnostic database layer for Fragno libraries.
 
-Library authors define a type-safe schema; users plug in their existing Kysely or Drizzle setup so
-data is written directly into their database.
+Library authors define a type-safe schema; users plug in the SqlAdapter (configured with Kysely
+dialects) so data is written directly into their database. Schema output can be generated for SQL
+migrations, Drizzle, or Prisma workflows.
 
 Full docs live at
 [Database integration for library authors](https://fragno.dev/docs/fragno/for-library-authors/database-integration/overview).
@@ -39,7 +40,7 @@ pnpm add --dev @fragno-dev/cli
 // schema.ts
 import { schema, idColumn, column } from "@fragno-dev/db/schema";
 
-export const commentSchema = schema((s) => {
+export const commentSchema = schema("comment", (s) => {
   return s
     .addTable("comment", (t) => {
       return t
@@ -91,22 +92,66 @@ export function createCommentLibrary(
 }
 ```
 
-Your users pass their own database adapter (Kysely or Drizzle) via `options`.
+Your users pass a SqlAdapter via `options`. If `better-sqlite3` is installed, `databaseAdapter` is
+optional and defaults to a local SQLite file per fragment in `FRAGNO_DATA_DIR` (default:
+`~/.fragno`).
+
+```ts
+// User's application code
+import { SqlAdapter } from "@fragno-dev/db";
+import { PostgresDialect } from "kysely";
+import { Pool } from "pg";
+
+const commentLib = createCommentLibrary(
+  { maxCommentsPerPost: 10 },
+  {
+    databaseAdapter: new SqlAdapter({
+      dialect: new PostgresDialect({
+        pool: new Pool({
+          /* connection config */
+        }),
+      }),
+    }),
+  },
+);
+```
 
 ## Key features
 
 - **Schema definition**: define tables, columns, indexes, and relations with a fluent, typed API.
 - **Type-safe ORM**: full TypeScript inference for queries and results.
 - **User-owned database**: your library never owns the database; users provide the adapter.
-- **ORM agnostic**: works with Kysely or Drizzle (and more to come).
+- **ORM agnostic**: SQL runtime with explicit schema output formats (SQL, Drizzle, Prisma).
 - **Namespaced tables**: avoids conflicts with user tables.
 
-## ORM and database support
+## Internal registry + describe route
+
+When multiple fragments share a database adapter, Fragno maintains an in-memory, adapter-scoped
+registry of schemas and fragment mount routes. Each fragment exposes a lightweight internal describe
+endpoint at `/_internal` (mounted under the fragment's mount route) that aggregates this registry.
+
+Example response:
 
-`@fragno-dev/db` works with:
+```json
+{
+  "fragments": [{ "name": "comment-library", "mountRoute": "/api/comment-library" }],
+  "schemas": [
+    { "name": "comment", "namespace": "comment", "version": 1, "tables": ["comment", "user"] }
+  ],
+  "routes": { "internal": "/_internal", "outbox": "/_internal/outbox" }
+}
+```
+
+Notes:
+
+- `schemas` excludes the internal Fragno schema.
+- `fragments` only includes fragments that opted into outbox support via fragment options.
+- `routes.outbox` is only present when at least one fragment has outbox enabled.
+
+## ORM and database support
 
-- **Kysely**
-- **Drizzle**
+`@fragno-dev/db` works with Kysely dialects for runtime execution and supports SQL migrations plus
+Drizzle or Prisma schema outputs.
 
 Backed by Postgres and SQLite, including PGLite and Cloudflare Durable Objects.
 

package/dist/adapters/adapters.d.ts

@@ -1,7 +1,9 @@
 import { AnySchema } from "../schema/create.js";
+import { SqlNamingStrategy } from "../naming/sql-naming.js";
+import { SQLiteStorageMode } from "./generic-sql/sqlite-storage.js";
 import { IUnitOfWork } from "../query/unit-of-work/unit-of-work.js";
 import { SimpleQueryInterface } from "../query/simple-query-interface.js";
-import { SchemaGenerator } from "../schema-generator/schema-generator.js";
+import { SQLProvider } from "../shared/providers.js";
 import { PreparedMigrations } from "./generic-sql/migration/prepared-migrations.js";
 import { RequestContextStorage } from "@fragno-dev/core/internal/request-context-storage";
 
@@ -15,12 +17,11 @@ declare const fragnoDatabaseAdapterVersionFakeSymbol: "$fragno-database-adapter-
 type DatabaseContextStorage = {
   uow: IUnitOfWork;
 };
-/**
- * Maps logical table names (used by fragment authors) to physical table names (with namespace suffix)
- */
-interface TableNameMapper {
-  toPhysical(logicalName: string): string;
-  toLogical(physicalName: string): string;
+type SQLiteProfile = "default" | "prisma";
+interface DatabaseAdapterMetadata {
+  databaseType?: SQLProvider;
+  sqliteProfile?: SQLiteProfile;
+  sqliteStorageMode?: SQLiteStorageMode;
 }
 interface DatabaseAdapter<TUOWConfig = void> {
   [fragnoDatabaseAdapterNameFakeSymbol]: string;
@@ -30,30 +31,31 @@ interface DatabaseAdapter<TUOWConfig = void> {
    * This allows multiple fragments to participate in the same Unit of Work.
    */
   readonly contextStorage: RequestContextStorage<DatabaseContextStorage>;
+  /**
+   * Optional adapter override used for durable hook processing.
+   * Use this when the public adapter wraps another adapter (e.g. model checker).
+   */
+  getHookProcessingAdapter?: () => DatabaseAdapter<TUOWConfig>;
   /**
    * Get current schema version, undefined if not initialized.
    */
   getSchemaVersion(namespace: string): Promise<string | undefined>;
-  createQueryEngine: <const T extends AnySchema>(schema: T, namespace: string) => SimpleQueryInterface<T, TUOWConfig>;
-  prepareMigrations?: <const T extends AnySchema>(schema: T, namespace: string) => PreparedMigrations;
   /**
-   * Generate a combined schema file from one or more fragments.
-   * If not implemented, schema generation is not supported for this adapter.
+   * Optional metadata used by schema output tooling.
+   */
+  readonly adapterMetadata?: DatabaseAdapterMetadata;
+  /**
+   * Naming strategy used for physical SQL identifiers.
    */
-  createSchemaGenerator?: (fragments: {
-    schema: AnySchema;
-    namespace: string;
-  }[], options?: {
-    path?: string;
-  }) => SchemaGenerator;
+  readonly namingStrategy: SqlNamingStrategy;
   /**
-   * Creates a table name mapper for the given namespace.
-   * Used to convert between logical table names and physical table names.
+   * @deprecated Avoid using query engines directly in fragment code. Prefer handlerTx/serviceTx.
    */
-  createTableNameMapper: (namespace: string) => TableNameMapper;
+  createQueryEngine: <const T extends AnySchema>(schema: T, namespace: string | null) => SimpleQueryInterface<T, TUOWConfig>;
+  prepareMigrations?: <const T extends AnySchema>(schema: T, namespace: string | null) => PreparedMigrations;
   isConnectionHealthy: () => Promise<boolean>;
   close: () => Promise<void>;
 }
 //#endregion
-export { DatabaseAdapter, DatabaseContextStorage, TableNameMapper, fragnoDatabaseAdapterNameFakeSymbol, fragnoDatabaseAdapterVersionFakeSymbol };
+export { DatabaseAdapter, DatabaseAdapterMetadata, DatabaseContextStorage, SQLiteProfile, fragnoDatabaseAdapterNameFakeSymbol, fragnoDatabaseAdapterVersionFakeSymbol };
 //# sourceMappingURL=adapters.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"adapters.d.ts","names":[],"sources":["../../src/adapters/adapters.ts"],"sourcesContent":[],"mappings":";;;;;;;;cAOa;cACA;AADb;AACA;AAMA;AAOA;AAKiB,KAZL,sBAAA,GAYoB;EAC7B,GAAA,EAZI,WAYJ;CACA;;;;AAamC,UApBrB,eAAA,CAoBqB;EAC1B,UAAA,CAAA,WAAA,EAAA,MAAA,CAAA,EAAA,MAAA;EAEgB,SAAA,CAAA,YAAA,EAAA,MAAA,CAAA,EAAA,MAAA;;AAArB,UAlBU,eAkBV,CAAA,aAAA,IAAA,CAAA,CAAA;EAEgC,CAnBpC,mCAAA,CAmBoC,EAAA,MAAA;EAC3B,CAnBT,sCAAA,CAmBS,EAAA,MAAA;EAEL;;;;EAiBsB,SAAA,cAAA,EAhCF,qBAgCE,CAhCoB,sBAgCpB,CAAA;EAEd;;;uCA7BwB;sCAED,mBAC1B,yBAEL,qBAAqB,GAAG;uCAEQ,mBAC3B,yBAEL;;;;;;YAOkB;;;;QAElB;;;;;gDAMyC;6BAEnB;eAEd"}
+{"version":3,"file":"adapters.d.ts","names":[],"sources":["../../src/adapters/adapters.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;cAUa;cACA;AADb;AACA;AAMA;AAIA;AAEiB,KANL,sBAAA,GAM4B;EACvB,GAAA,EANV,WAMU;CACC;AACI,KALV,aAAA,GAKU,SAAA,GAAA,QAAA;AAAiB,UAHtB,uBAAA,CAGsB;EAGtB,YAAA,CAAA,EALA,WAKe;EAC7B,aAAA,CAAA,EALe,aAKf;EACA,iBAAA,CAAA,EALmB,iBAKnB;;AAMwB,UARV,eAQU,CAAA,aAAA,IAAA,CAAA,CAAA;EAMwB,CAbhD,mCAAA,CAagD,EAAA,MAAA;EAAhB,CAZhC,sCAAA,CAYgC,EAAA,MAAA;EAKI;;;;EAgB3B,SAAA,cAAA,EA3Be,qBA2Bf,CA3BqC,sBA2BrC,CAAA;EAEgB;;;;EAGhB,wBAAA,CAAA,EAAA,GAAA,GA1BuB,eA0BvB,CA1BuC,UA0BvC,CAAA;EAEL;;;EAIe,gBAAA,CAAA,SAAA,EAAA,MAAA,CAAA,EA3BiB,OA2BjB,CAAA,MAAA,GAAA,SAAA,CAAA;;;;6BAtBO;;;;2BAKF;;;;sCAKW,mBAC1B,gCAEL,qBAAqB,GAAG;uCAEQ,mBAC3B,gCAEL;6BAEsB;eAEd"}

package/dist/adapters/adapters.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapters.js","names":[],"sources":["../../src/adapters/adapters.ts"],"sourcesContent":["import type { SimpleQueryInterface } from \"../query/simple-query-interface\";\nimport type { SchemaGenerator } from \"../schema-generator/schema-generator\";\nimport type { AnySchema } from \"../schema/create\";\nimport type { RequestContextStorage } from \"@fragno-dev/core/internal/request-context-storage\";\nimport type { IUnitOfWork } from \"../query/unit-of-work/unit-of-work\";\nimport type { PreparedMigrations } from \"./generic-sql/migration/prepared-migrations\";\n\nexport const fragnoDatabaseAdapterNameFakeSymbol = \"$fragno-database-adapter-name\" as const;\nexport const fragnoDatabaseAdapterVersionFakeSymbol = \"$fragno-database-adapter-version\" as const;\n\n/**\n * Storage type for database context - stores the Unit of Work.\n * This is shared across all fragments using the same adapter.\n */\nexport type DatabaseContextStorage = {\n  uow: IUnitOfWork;\n};\n\n/**\n * Maps logical table names (used by fragment authors) to physical table names (with namespace suffix)\n */\nexport interface TableNameMapper {\n  toPhysical(logicalName: string): string;\n  toLogical(physicalName: string): string;\n}\n\nexport interface DatabaseAdapter<TUOWConfig = void> {\n  [fragnoDatabaseAdapterNameFakeSymbol]: string;\n  [fragnoDatabaseAdapterVersionFakeSymbol]: number;\n\n  /**\n   * Request context storage shared across all fragments using this adapter.\n   * This allows multiple fragments to participate in the same Unit of Work.\n   */\n  readonly contextStorage: RequestContextStorage<DatabaseContextStorage>;\n\n  /**\n   * Get current schema version, undefined if not initialized.\n   */\n  getSchemaVersion(namespace: string): Promise<string | undefined>;\n\n  createQueryEngine: <const T extends AnySchema>(\n    schema: T,\n    namespace: string,\n  ) => SimpleQueryInterface<T, TUOWConfig>;\n\n  prepareMigrations?: <const T extends AnySchema>(\n    schema: T,\n    namespace: string,\n  ) => PreparedMigrations;\n\n  /**\n   * Generate a combined schema file from one or more fragments.\n   * If not implemented, schema generation is not supported for this adapter.\n   */\n  createSchemaGenerator?: (\n    fragments: { schema: AnySchema; namespace: string }[],\n    options?: { path?: string },\n  ) => SchemaGenerator;\n\n  /**\n   * Creates a table name mapper for the given namespace.\n   * Used to convert between logical table names and physical table names.\n   */\n  createTableNameMapper: (namespace: string) => TableNameMapper;\n\n  isConnectionHealthy: () => Promise<boolean>;\n\n  close: () => Promise<void>;\n}\n"],"mappings":";AAOA,MAAa,sCAAsC;AACnD,MAAa,yCAAyC"}
+{"version":3,"file":"adapters.js","names":[],"sources":["../../src/adapters/adapters.ts"],"sourcesContent":["import type { RequestContextStorage } from \"@fragno-dev/core/internal/request-context-storage\";\n\nimport type { SqlNamingStrategy } from \"../naming/sql-naming\";\nimport type { SimpleQueryInterface } from \"../query/simple-query-interface\";\nimport type { IUnitOfWork } from \"../query/unit-of-work/unit-of-work\";\nimport type { AnySchema } from \"../schema/create\";\nimport type { SQLProvider } from \"../shared/providers\";\nimport type { PreparedMigrations } from \"./generic-sql/migration/prepared-migrations\";\nimport type { SQLiteStorageMode } from \"./generic-sql/sqlite-storage\";\n\nexport const fragnoDatabaseAdapterNameFakeSymbol = \"$fragno-database-adapter-name\" as const;\nexport const fragnoDatabaseAdapterVersionFakeSymbol = \"$fragno-database-adapter-version\" as const;\n\n/**\n * Storage type for database context - stores the Unit of Work.\n * This is shared across all fragments using the same adapter.\n */\nexport type DatabaseContextStorage = {\n  uow: IUnitOfWork;\n};\n\nexport type SQLiteProfile = \"default\" | \"prisma\";\n\nexport interface DatabaseAdapterMetadata {\n  databaseType?: SQLProvider;\n  sqliteProfile?: SQLiteProfile;\n  sqliteStorageMode?: SQLiteStorageMode;\n}\n\nexport interface DatabaseAdapter<TUOWConfig = void> {\n  [fragnoDatabaseAdapterNameFakeSymbol]: string;\n  [fragnoDatabaseAdapterVersionFakeSymbol]: number;\n\n  /**\n   * Request context storage shared across all fragments using this adapter.\n   * This allows multiple fragments to participate in the same Unit of Work.\n   */\n  readonly contextStorage: RequestContextStorage<DatabaseContextStorage>;\n\n  /**\n   * Optional adapter override used for durable hook processing.\n   * Use this when the public adapter wraps another adapter (e.g. model checker).\n   */\n  getHookProcessingAdapter?: () => DatabaseAdapter<TUOWConfig>;\n\n  /**\n   * Get current schema version, undefined if not initialized.\n   */\n  getSchemaVersion(namespace: string): Promise<string | undefined>;\n\n  /**\n   * Optional metadata used by schema output tooling.\n   */\n  readonly adapterMetadata?: DatabaseAdapterMetadata;\n\n  /**\n   * Naming strategy used for physical SQL identifiers.\n   */\n  readonly namingStrategy: SqlNamingStrategy;\n\n  /**\n   * @deprecated Avoid using query engines directly in fragment code. Prefer handlerTx/serviceTx.\n   */\n  createQueryEngine: <const T extends AnySchema>(\n    schema: T,\n    namespace: string | null,\n  ) => SimpleQueryInterface<T, TUOWConfig>;\n\n  prepareMigrations?: <const T extends AnySchema>(\n    schema: T,\n    namespace: string | null,\n  ) => PreparedMigrations;\n\n  isConnectionHealthy: () => Promise<boolean>;\n\n  close: () => Promise<void>;\n}\n"],"mappings":";AAUA,MAAa,sCAAsC;AACnD,MAAa,yCAAyC"}

package/dist/adapters/generic-sql/driver-config.d.ts

@@ -1,3 +1,5 @@
+import { SqlNamingStrategy } from "../../naming/sql-naming.js";
+
 //#region src/adapters/generic-sql/driver-config.d.ts
 declare const supportedDatabases: readonly ["sqlite", "postgresql", "mysql"];
 type SupportedDatabase = (typeof supportedDatabases)[number];
@@ -8,12 +10,17 @@ declare abstract class DriverConfig<T extends SupportedDriverType = SupportedDri
   abstract readonly databaseType: SupportedDatabase;
   abstract readonly supportsReturning: boolean;
   abstract readonly supportsJson: boolean;
+  abstract readonly outboxVersionstampStrategy: OutboxVersionstampStrategy;
   /**
    * Column name for internal ID in RETURNING results.
    * Only defined if supportsReturning is true.
    */
   abstract readonly internalIdColumn: string | undefined;
+  /**
+   * SQLite storage selection is handled by adapters, not driver config.
+   */
   get supportsRowsAffected(): boolean;
+  get defaultNamingStrategy(): SqlNamingStrategy;
   /**
    * Extract the number of affected rows from a query result.
    * Only implemented for drivers that support affected rows reporting.
@@ -24,12 +31,15 @@ declare abstract class DriverConfig<T extends SupportedDriverType = SupportedDri
    */
   extractAffectedRows?(result: Record<string, unknown>): bigint;
 }
+declare const defaultNamingStrategyForDatabase: (databaseType: SupportedDatabase) => SqlNamingStrategy;
+type OutboxVersionstampStrategy = "update-returning" | "insert-on-conflict-returning" | "insert-on-duplicate-last-insert-id";
 declare class SQLocalDriverConfig extends DriverConfig<"sqlocal"> {
   readonly driverType = "sqlocal";
   readonly databaseType = "sqlite";
   readonly supportsReturning = true;
   readonly supportsJson = false;
   readonly internalIdColumn = "_internalId";
+  readonly outboxVersionstampStrategy = "insert-on-conflict-returning";
 }
 declare class CloudflareDurableObjectsDriverConfig extends DriverConfig<"cloudflare_durable_objects"> {
   readonly driverType = "cloudflare_durable_objects";
@@ -37,6 +47,7 @@ declare class CloudflareDurableObjectsDriverConfig extends DriverConfig<"cloudfl
   readonly supportsReturning = true;
   readonly supportsJson = false;
   readonly internalIdColumn = "_internalId";
+  readonly outboxVersionstampStrategy = "insert-on-conflict-returning";
 }
 declare class BetterSQLite3DriverConfig extends DriverConfig<"better-sqlite3"> {
   readonly driverType = "better-sqlite3";
@@ -44,6 +55,7 @@ declare class BetterSQLite3DriverConfig extends DriverConfig<"better-sqlite3"> {
   readonly supportsReturning = true;
   readonly supportsJson = false;
   readonly internalIdColumn = "_internalId";
+  readonly outboxVersionstampStrategy = "insert-on-conflict-returning";
   extractAffectedRows(result: Record<string, unknown>): bigint;
 }
 declare class NodePostgresDriverConfig extends DriverConfig<"pg"> {
@@ -52,6 +64,7 @@ declare class NodePostgresDriverConfig extends DriverConfig<"pg"> {
   readonly supportsReturning = true;
   readonly supportsJson = true;
   readonly internalIdColumn = "_internalId";
+  readonly outboxVersionstampStrategy = "insert-on-conflict-returning";
   extractAffectedRows(result: Record<string, unknown>): bigint;
 }
 declare class PGLiteDriverConfig extends DriverConfig<"pglite"> {
@@ -60,6 +73,7 @@ declare class PGLiteDriverConfig extends DriverConfig<"pglite"> {
   readonly supportsReturning = true;
   readonly supportsJson = true;
   readonly internalIdColumn = "_internalId";
+  readonly outboxVersionstampStrategy = "insert-on-conflict-returning";
   extractAffectedRows(result: Record<string, unknown>): bigint;
 }
 declare class MySQL2DriverConfig extends DriverConfig<"mysql2"> {
@@ -68,7 +82,8 @@ declare class MySQL2DriverConfig extends DriverConfig<"mysql2"> {
   readonly supportsReturning = false;
   readonly supportsJson = true;
   readonly internalIdColumn: undefined;
+  readonly outboxVersionstampStrategy = "insert-on-duplicate-last-insert-id";
 }
 //#endregion
-export { BetterSQLite3DriverConfig, CloudflareDurableObjectsDriverConfig, DriverConfig, MySQL2DriverConfig, NodePostgresDriverConfig, PGLiteDriverConfig, SQLocalDriverConfig, SupportedDatabase, SupportedDriverType, supportedDatabases, supportedDriverTypes };
+export { BetterSQLite3DriverConfig, CloudflareDurableObjectsDriverConfig, DriverConfig, MySQL2DriverConfig, NodePostgresDriverConfig, OutboxVersionstampStrategy, PGLiteDriverConfig, SQLocalDriverConfig, SupportedDatabase, SupportedDriverType, defaultNamingStrategyForDatabase, supportedDatabases, supportedDriverTypes };
 //# sourceMappingURL=driver-config.d.ts.map

package/dist/adapters/generic-sql/driver-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"driver-config.d.ts","names":[],"sources":["../../../src/adapters/generic-sql/driver-config.ts"],"sourcesContent":[],"mappings":";cAAa;AAAA,KACD,iBAAA,GADgE,CAAA,OACpC,kBADoC,CAAA,CAAA,MAAA,CAAA;AAChE,cAEC,oBAF2B,EAAA,SAAA,CAAA,SAAkB,EAAA,4BAAA,EAAA,gBAAA,EAAA,IAAA,EAAA,QAAA,EAAA,QAAA,CAAA;AAE7C,KASD,mBAAA,GAFF,CAAA,OAEgC,oBAFhC,CAAA,CAAA,MAAA,CAAA;AAEE,uBAEU,YAFoB,CAAA,UAEG,mBAFiB,GAEK,mBAFL,CAAA,CAAA;EAExC,kBAAY,UAAA,EACF,CADE;EAAW,kBAAA,YAAA,EAEX,iBAFW;EAAsB,kBAAA,iBAAA,EAAA,OAAA;EACnC,kBAAA,YAAA,EAAA,OAAA;EACE;;;AA0BlC;EAQa,kBAAA,gBAAA,EAAA,MAAqC,GAAA,SAAQ;EAQ7C,IAAA,oBAAA,CAAA,CAAA,EAA0B,OAAA;EAwB1B;AAgCb;AAuBA;;;;;;+BAlG+B;;cAGlB,mBAAA,SAA4B;;;;;;;cAQ5B,oCAAA,SAA6C;;;;;;;cAQ7C,yBAAA,SAAkC;;;;;;8BAOR;;cAiB1B,wBAAA,SAAiC;;;;;;8BAOP;;cAyB1B,kBAAA,SAA2B;;;;;;8BAOD;;cAgB1B,kBAAA,SAA2B"}
+{"version":3,"file":"driver-config.d.ts","names":[],"sources":["../../../src/adapters/generic-sql/driver-config.ts"],"sourcesContent":[],"mappings":";;;cAMa;KACD,iBAAA,WAA4B;AAD3B,cAGA,oBAH+D,EAAA,SAAA,CAAA,SAAA,EAAA,4BAAA,EAAA,gBAAA,EAAA,IAAA,EAAA,QAAA,EAAA,QAAA,CAAA;AAChE,KAWA,mBAAA,GAXiB,CAAA,OAWa,oBAXgB,CAAA,CAAA,MAAA,CAAA;AAE7C,uBAWS,YAJZ,CAAA,UAImC,mBAJnC,GAIyD,mBAJzD,CAAA,CAAA;EAEE,kBAAA,UAAmB,EAGC,CAHD;EAET,kBAAY,YAAA,EAEA,iBAFA;EAAW,kBAAA,iBAAA,EAAA,OAAA;EAAsB,kBAAA,YAAA,EAAA,OAAA;EACnC,kBAAA,0BAAA,EAKgB,0BALhB;EACE;;;;EA+BG,kBAAA,gBAAA,EAAA,MAAA,GAAA,SAAA;EAGxB;AAab;AAKA;EASa,IAAA,oBAAA,CAAA,CAAA,EAAA,OAAA;EASA,IAAA,qBAAA,CAAA,CAAA,EAnDkB,iBA2DQ;EAiB1B;AAiCb;AAwBA;;;;;;+BAzH+B;;cAGlB,iDACG,sBACb;KAWS,0BAAA;cAKC,mBAAA,SAA4B;;;;;;;;cAS5B,oCAAA,SAA6C;;;;;;;;cAS7C,yBAAA,SAAkC;;;;;;;8BAQR;;cAiB1B,wBAAA,SAAiC;;;;;;;8BAQP;;cAyB1B,kBAAA,SAA2B;;;;;;;8BAQD;;cAgB1B,kBAAA,SAA2B"}

package/dist/adapters/generic-sql/driver-config.js

@@ -1,3 +1,5 @@
+import { schemaNamingStrategy, suffixNamingStrategy } from "../../naming/sql-naming.js";
+
 //#region src/adapters/generic-sql/driver-config.ts
 const supportedDatabases = [
 	"sqlite",
@@ -13,9 +15,23 @@ const supportedDriverTypes = [
 	"mysql2"
 ];
 var DriverConfig = class {
+	/**
+	* SQLite storage selection is handled by adapters, not driver config.
+	*/
 	get supportsRowsAffected() {
 		return !!this.extractAffectedRows;
 	}
+	get defaultNamingStrategy() {
+		return defaultNamingStrategyForDatabase(this.databaseType);
+	}
+};
+const defaultNamingStrategyForDatabase = (databaseType) => {
+	switch (databaseType) {
+		case "postgresql": return schemaNamingStrategy;
+		case "sqlite":
+		case "mysql":
+		default: return suffixNamingStrategy;
+	}
 };
 var SQLocalDriverConfig = class extends DriverConfig {
 	driverType = "sqlocal";
@@ -23,6 +39,7 @@ var SQLocalDriverConfig = class extends DriverConfig {
 	supportsReturning = true;
 	supportsJson = false;
 	internalIdColumn = "_internalId";
+	outboxVersionstampStrategy = "insert-on-conflict-returning";
 };
 var CloudflareDurableObjectsDriverConfig = class extends DriverConfig {
 	driverType = "cloudflare_durable_objects";
@@ -30,6 +47,7 @@ var CloudflareDurableObjectsDriverConfig = class extends DriverConfig {
 	supportsReturning = true;
 	supportsJson = false;
 	internalIdColumn = "_internalId";
+	outboxVersionstampStrategy = "insert-on-conflict-returning";
 };
 var BetterSQLite3DriverConfig = class extends DriverConfig {
 	driverType = "better-sqlite3";
@@ -37,6 +55,7 @@ var BetterSQLite3DriverConfig = class extends DriverConfig {
 	supportsReturning = true;
 	supportsJson = false;
 	internalIdColumn = "_internalId";
+	outboxVersionstampStrategy = "insert-on-conflict-returning";
 	extractAffectedRows(result) {
 		if ("numAffectedRows" in result) {
 			const value = result["numAffectedRows"];
@@ -52,6 +71,7 @@ var NodePostgresDriverConfig = class extends DriverConfig {
 	supportsReturning = true;
 	supportsJson = true;
 	internalIdColumn = "_internalId";
+	outboxVersionstampStrategy = "insert-on-conflict-returning";
 	extractAffectedRows(result) {
 		if ("numAffectedRows" in result) {
 			const value = result["numAffectedRows"];
@@ -72,6 +92,7 @@ var PGLiteDriverConfig = class extends DriverConfig {
 	supportsReturning = true;
 	supportsJson = true;
 	internalIdColumn = "_internalId";
+	outboxVersionstampStrategy = "insert-on-conflict-returning";
 	extractAffectedRows(result) {
 		if ("affectedRows" in result) {
 			const value = result["affectedRows"];
@@ -87,8 +108,9 @@ var MySQL2DriverConfig = class extends DriverConfig {
 	supportsReturning = false;
 	supportsJson = true;
 	internalIdColumn = void 0;
+	outboxVersionstampStrategy = "insert-on-duplicate-last-insert-id";
 };
 
 //#endregion
-export { BetterSQLite3DriverConfig, CloudflareDurableObjectsDriverConfig, DriverConfig, MySQL2DriverConfig, NodePostgresDriverConfig, PGLiteDriverConfig, SQLocalDriverConfig, supportedDatabases, supportedDriverTypes };
+export { BetterSQLite3DriverConfig, CloudflareDurableObjectsDriverConfig, DriverConfig, MySQL2DriverConfig, NodePostgresDriverConfig, PGLiteDriverConfig, SQLocalDriverConfig, defaultNamingStrategyForDatabase, supportedDatabases, supportedDriverTypes };
 //# sourceMappingURL=driver-config.js.map

package/dist/adapters/generic-sql/driver-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"driver-config.js","names":[],"sources":["../../../src/adapters/generic-sql/driver-config.ts"],"sourcesContent":["export const supportedDatabases = [\"sqlite\", \"postgresql\", \"mysql\"] as const;\nexport type SupportedDatabase = (typeof supportedDatabases)[number];\n\nexport const supportedDriverTypes = [\n  \"sqlocal\",\n  \"cloudflare_durable_objects\",\n  \"better-sqlite3\",\n  \"pg\",\n  \"pglite\",\n  \"mysql2\",\n] as const;\n\nexport type SupportedDriverType = (typeof supportedDriverTypes)[number];\n\nexport abstract class DriverConfig<T extends SupportedDriverType = SupportedDriverType> {\n  abstract readonly driverType: T;\n  abstract readonly databaseType: SupportedDatabase;\n\n  abstract readonly supportsReturning: boolean;\n  abstract readonly supportsJson: boolean;\n\n  /**\n   * Column name for internal ID in RETURNING results.\n   * Only defined if supportsReturning is true.\n   */\n  abstract readonly internalIdColumn: string | undefined;\n\n  get supportsRowsAffected(): boolean {\n    return !!this.extractAffectedRows;\n  }\n\n  /**\n   * Extract the number of affected rows from a query result.\n   * Only implemented for drivers that support affected rows reporting.\n   *\n   * @param result - The query result from the SQL driver\n   * @returns The number of affected rows as bigint\n   * @throws Error if affected rows information is not found in the result\n   */\n  extractAffectedRows?(result: Record<string, unknown>): bigint;\n}\n\nexport class SQLocalDriverConfig extends DriverConfig<\"sqlocal\"> {\n  override readonly driverType = \"sqlocal\";\n  override readonly databaseType = \"sqlite\";\n  override readonly supportsReturning = true;\n  override readonly supportsJson = false;\n  override readonly internalIdColumn = \"_internalId\";\n}\n\nexport class CloudflareDurableObjectsDriverConfig extends DriverConfig<\"cloudflare_durable_objects\"> {\n  override readonly driverType = \"cloudflare_durable_objects\";\n  override readonly databaseType = \"sqlite\";\n  override readonly supportsReturning = true;\n  override readonly supportsJson = false;\n  override readonly internalIdColumn = \"_internalId\";\n}\n\nexport class BetterSQLite3DriverConfig extends DriverConfig<\"better-sqlite3\"> {\n  override readonly driverType = \"better-sqlite3\";\n  override readonly databaseType = \"sqlite\";\n  override readonly supportsReturning = true;\n  override readonly supportsJson = false;\n  override readonly internalIdColumn = \"_internalId\";\n\n  override extractAffectedRows(result: Record<string, unknown>): bigint {\n    if (\"numAffectedRows\" in result) {\n      const value = result[\"numAffectedRows\"];\n      if (typeof value === \"bigint\") {\n        return value;\n      }\n      if (typeof value === \"number\") {\n        return BigInt(value);\n      }\n    }\n\n    throw new Error(\n      `No affected rows found in result: ${JSON.stringify(result)}. Driver ${this.driverType} is expected to support affected rows.`,\n    );\n  }\n}\n\nexport class NodePostgresDriverConfig extends DriverConfig<\"pg\"> {\n  override readonly driverType = \"pg\";\n  override readonly databaseType = \"postgresql\";\n  override readonly supportsReturning = true;\n  override readonly supportsJson = true;\n  override readonly internalIdColumn = \"_internalId\";\n\n  override extractAffectedRows(result: Record<string, unknown>): bigint {\n    if (\"numAffectedRows\" in result) {\n      const value = result[\"numAffectedRows\"];\n      if (typeof value === \"bigint\") {\n        return value;\n      }\n      if (typeof value === \"number\") {\n        return BigInt(value);\n      }\n    }\n    if (\"numChangedRows\" in result) {\n      const value = result[\"numChangedRows\"];\n      if (typeof value === \"bigint\") {\n        return value;\n      }\n      if (typeof value === \"number\") {\n        return BigInt(value);\n      }\n    }\n    throw new Error(\n      `No affected rows found in result: ${JSON.stringify(result)}. Driver ${this.driverType} is expected to support affected rows.`,\n    );\n  }\n}\n\nexport class PGLiteDriverConfig extends DriverConfig<\"pglite\"> {\n  override readonly driverType = \"pglite\";\n  override readonly databaseType = \"postgresql\";\n  override readonly supportsReturning = true;\n  override readonly supportsJson = true;\n  override readonly internalIdColumn = \"_internalId\";\n\n  override extractAffectedRows(result: Record<string, unknown>): bigint {\n    if (\"affectedRows\" in result) {\n      const value = result[\"affectedRows\"];\n      if (typeof value === \"bigint\") {\n        return value;\n      }\n      if (typeof value === \"number\") {\n        return BigInt(value);\n      }\n    }\n    throw new Error(\n      `No affected rows found in result: ${JSON.stringify(result)}. Driver ${this.driverType} is expected to support affected rows.`,\n    );\n  }\n}\n\nexport class MySQL2DriverConfig extends DriverConfig<\"mysql2\"> {\n  override readonly driverType = \"mysql2\";\n  override readonly databaseType = \"mysql\";\n  override readonly supportsReturning = false;\n  override readonly supportsJson = true;\n  override readonly internalIdColumn = undefined;\n}\n"],"mappings":";AAAA,MAAa,qBAAqB;CAAC;CAAU;CAAc;CAAQ;AAGnE,MAAa,uBAAuB;CAClC;CACA;CACA;CACA;CACA;CACA;CACD;AAID,IAAsB,eAAtB,MAAwF;CAatF,IAAI,uBAAgC;AAClC,SAAO,CAAC,CAAC,KAAK;;;AAclB,IAAa,sBAAb,cAAyC,aAAwB;CAC/D,AAAkB,aAAa;CAC/B,AAAkB,eAAe;CACjC,AAAkB,oBAAoB;CACtC,AAAkB,eAAe;CACjC,AAAkB,mBAAmB;;AAGvC,IAAa,uCAAb,cAA0D,aAA2C;CACnG,AAAkB,aAAa;CAC/B,AAAkB,eAAe;CACjC,AAAkB,oBAAoB;CACtC,AAAkB,eAAe;CACjC,AAAkB,mBAAmB;;AAGvC,IAAa,4BAAb,cAA+C,aAA+B;CAC5E,AAAkB,aAAa;CAC/B,AAAkB,eAAe;CACjC,AAAkB,oBAAoB;CACtC,AAAkB,eAAe;CACjC,AAAkB,mBAAmB;CAErC,AAAS,oBAAoB,QAAyC;AACpE,MAAI,qBAAqB,QAAQ;GAC/B,MAAM,QAAQ,OAAO;AACrB,OAAI,OAAO,UAAU,SACnB,QAAO;AAET,OAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;;AAIxB,QAAM,IAAI,MACR,qCAAqC,KAAK,UAAU,OAAO,CAAC,WAAW,KAAK,WAAW,wCACxF;;;AAIL,IAAa,2BAAb,cAA8C,aAAmB;CAC/D,AAAkB,aAAa;CAC/B,AAAkB,eAAe;CACjC,AAAkB,oBAAoB;CACtC,AAAkB,eAAe;CACjC,AAAkB,mBAAmB;CAErC,AAAS,oBAAoB,QAAyC;AACpE,MAAI,qBAAqB,QAAQ;GAC/B,MAAM,QAAQ,OAAO;AACrB,OAAI,OAAO,UAAU,SACnB,QAAO;AAET,OAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;;AAGxB,MAAI,oBAAoB,QAAQ;GAC9B,MAAM,QAAQ,OAAO;AACrB,OAAI,OAAO,UAAU,SACnB,QAAO;AAET,OAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;;AAGxB,QAAM,IAAI,MACR,qCAAqC,KAAK,UAAU,OAAO,CAAC,WAAW,KAAK,WAAW,wCACxF;;;AAIL,IAAa,qBAAb,cAAwC,aAAuB;CAC7D,AAAkB,aAAa;CAC/B,AAAkB,eAAe;CACjC,AAAkB,oBAAoB;CACtC,AAAkB,eAAe;CACjC,AAAkB,mBAAmB;CAErC,AAAS,oBAAoB,QAAyC;AACpE,MAAI,kBAAkB,QAAQ;GAC5B,MAAM,QAAQ,OAAO;AACrB,OAAI,OAAO,UAAU,SACnB,QAAO;AAET,OAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;;AAGxB,QAAM,IAAI,MACR,qCAAqC,KAAK,UAAU,OAAO,CAAC,WAAW,KAAK,WAAW,wCACxF;;;AAIL,IAAa,qBAAb,cAAwC,aAAuB;CAC7D,AAAkB,aAAa;CAC/B,AAAkB,eAAe;CACjC,AAAkB,oBAAoB;CACtC,AAAkB,eAAe;CACjC,AAAkB,mBAAmB"}
+{"version":3,"file":"driver-config.js","names":[],"sources":["../../../src/adapters/generic-sql/driver-config.ts"],"sourcesContent":["import {\n  schemaNamingStrategy,\n  suffixNamingStrategy,\n  type SqlNamingStrategy,\n} from \"../../naming/sql-naming\";\n\nexport const supportedDatabases = [\"sqlite\", \"postgresql\", \"mysql\"] as const;\nexport type SupportedDatabase = (typeof supportedDatabases)[number];\n\nexport const supportedDriverTypes = [\n  \"sqlocal\",\n  \"cloudflare_durable_objects\",\n  \"better-sqlite3\",\n  \"pg\",\n  \"pglite\",\n  \"mysql2\",\n] as const;\n\nexport type SupportedDriverType = (typeof supportedDriverTypes)[number];\n\nexport abstract class DriverConfig<T extends SupportedDriverType = SupportedDriverType> {\n  abstract readonly driverType: T;\n  abstract readonly databaseType: SupportedDatabase;\n\n  abstract readonly supportsReturning: boolean;\n  abstract readonly supportsJson: boolean;\n  abstract readonly outboxVersionstampStrategy: OutboxVersionstampStrategy;\n\n  /**\n   * Column name for internal ID in RETURNING results.\n   * Only defined if supportsReturning is true.\n   */\n  abstract readonly internalIdColumn: string | undefined;\n\n  /**\n   * SQLite storage selection is handled by adapters, not driver config.\n   */\n  get supportsRowsAffected(): boolean {\n    return !!this.extractAffectedRows;\n  }\n\n  get defaultNamingStrategy(): SqlNamingStrategy {\n    return defaultNamingStrategyForDatabase(this.databaseType);\n  }\n\n  /**\n   * Extract the number of affected rows from a query result.\n   * Only implemented for drivers that support affected rows reporting.\n   *\n   * @param result - The query result from the SQL driver\n   * @returns The number of affected rows as bigint\n   * @throws Error if affected rows information is not found in the result\n   */\n  extractAffectedRows?(result: Record<string, unknown>): bigint;\n}\n\nexport const defaultNamingStrategyForDatabase = (\n  databaseType: SupportedDatabase,\n): SqlNamingStrategy => {\n  switch (databaseType) {\n    case \"postgresql\":\n      return schemaNamingStrategy;\n    case \"sqlite\":\n    case \"mysql\":\n    default:\n      return suffixNamingStrategy;\n  }\n};\n\nexport type OutboxVersionstampStrategy =\n  | \"update-returning\"\n  | \"insert-on-conflict-returning\"\n  | \"insert-on-duplicate-last-insert-id\";\n\nexport class SQLocalDriverConfig extends DriverConfig<\"sqlocal\"> {\n  override readonly driverType = \"sqlocal\";\n  override readonly databaseType = \"sqlite\";\n  override readonly supportsReturning = true;\n  override readonly supportsJson = false;\n  override readonly internalIdColumn = \"_internalId\";\n  override readonly outboxVersionstampStrategy = \"insert-on-conflict-returning\";\n}\n\nexport class CloudflareDurableObjectsDriverConfig extends DriverConfig<\"cloudflare_durable_objects\"> {\n  override readonly driverType = \"cloudflare_durable_objects\";\n  override readonly databaseType = \"sqlite\";\n  override readonly supportsReturning = true;\n  override readonly supportsJson = false;\n  override readonly internalIdColumn = \"_internalId\";\n  override readonly outboxVersionstampStrategy = \"insert-on-conflict-returning\";\n}\n\nexport class BetterSQLite3DriverConfig extends DriverConfig<\"better-sqlite3\"> {\n  override readonly driverType = \"better-sqlite3\";\n  override readonly databaseType = \"sqlite\";\n  override readonly supportsReturning = true;\n  override readonly supportsJson = false;\n  override readonly internalIdColumn = \"_internalId\";\n  override readonly outboxVersionstampStrategy = \"insert-on-conflict-returning\";\n\n  override extractAffectedRows(result: Record<string, unknown>): bigint {\n    if (\"numAffectedRows\" in result) {\n      const value = result[\"numAffectedRows\"];\n      if (typeof value === \"bigint\") {\n        return value;\n      }\n      if (typeof value === \"number\") {\n        return BigInt(value);\n      }\n    }\n\n    throw new Error(\n      `No affected rows found in result: ${JSON.stringify(result)}. Driver ${this.driverType} is expected to support affected rows.`,\n    );\n  }\n}\n\nexport class NodePostgresDriverConfig extends DriverConfig<\"pg\"> {\n  override readonly driverType = \"pg\";\n  override readonly databaseType = \"postgresql\";\n  override readonly supportsReturning = true;\n  override readonly supportsJson = true;\n  override readonly internalIdColumn = \"_internalId\";\n  override readonly outboxVersionstampStrategy = \"insert-on-conflict-returning\";\n\n  override extractAffectedRows(result: Record<string, unknown>): bigint {\n    if (\"numAffectedRows\" in result) {\n      const value = result[\"numAffectedRows\"];\n      if (typeof value === \"bigint\") {\n        return value;\n      }\n      if (typeof value === \"number\") {\n        return BigInt(value);\n      }\n    }\n    if (\"numChangedRows\" in result) {\n      const value = result[\"numChangedRows\"];\n      if (typeof value === \"bigint\") {\n        return value;\n      }\n      if (typeof value === \"number\") {\n        return BigInt(value);\n      }\n    }\n    throw new Error(\n      `No affected rows found in result: ${JSON.stringify(result)}. Driver ${this.driverType} is expected to support affected rows.`,\n    );\n  }\n}\n\nexport class PGLiteDriverConfig extends DriverConfig<\"pglite\"> {\n  override readonly driverType = \"pglite\";\n  override readonly databaseType = \"postgresql\";\n  override readonly supportsReturning = true;\n  override readonly supportsJson = true;\n  override readonly internalIdColumn = \"_internalId\";\n  override readonly outboxVersionstampStrategy = \"insert-on-conflict-returning\";\n\n  override extractAffectedRows(result: Record<string, unknown>): bigint {\n    if (\"affectedRows\" in result) {\n      const value = result[\"affectedRows\"];\n      if (typeof value === \"bigint\") {\n        return value;\n      }\n      if (typeof value === \"number\") {\n        return BigInt(value);\n      }\n    }\n    throw new Error(\n      `No affected rows found in result: ${JSON.stringify(result)}. Driver ${this.driverType} is expected to support affected rows.`,\n    );\n  }\n}\n\nexport class MySQL2DriverConfig extends DriverConfig<\"mysql2\"> {\n  override readonly driverType = \"mysql2\";\n  override readonly databaseType = \"mysql\";\n  override readonly supportsReturning = false;\n  override readonly supportsJson = true;\n  override readonly internalIdColumn = undefined;\n  override readonly outboxVersionstampStrategy = \"insert-on-duplicate-last-insert-id\";\n}\n"],"mappings":";;;AAMA,MAAa,qBAAqB;CAAC;CAAU;CAAc;CAAQ;AAGnE,MAAa,uBAAuB;CAClC;CACA;CACA;CACA;CACA;CACA;CACD;AAID,IAAsB,eAAtB,MAAwF;;;;CAiBtF,IAAI,uBAAgC;AAClC,SAAO,CAAC,CAAC,KAAK;;CAGhB,IAAI,wBAA2C;AAC7C,SAAO,iCAAiC,KAAK,aAAa;;;AAc9D,MAAa,oCACX,iBACsB;AACtB,SAAQ,cAAR;EACE,KAAK,aACH,QAAO;EACT,KAAK;EACL,KAAK;EACL,QACE,QAAO;;;AASb,IAAa,sBAAb,cAAyC,aAAwB;CAC/D,AAAkB,aAAa;CAC/B,AAAkB,eAAe;CACjC,AAAkB,oBAAoB;CACtC,AAAkB,eAAe;CACjC,AAAkB,mBAAmB;CACrC,AAAkB,6BAA6B;;AAGjD,IAAa,uCAAb,cAA0D,aAA2C;CACnG,AAAkB,aAAa;CAC/B,AAAkB,eAAe;CACjC,AAAkB,oBAAoB;CACtC,AAAkB,eAAe;CACjC,AAAkB,mBAAmB;CACrC,AAAkB,6BAA6B;;AAGjD,IAAa,4BAAb,cAA+C,aAA+B;CAC5E,AAAkB,aAAa;CAC/B,AAAkB,eAAe;CACjC,AAAkB,oBAAoB;CACtC,AAAkB,eAAe;CACjC,AAAkB,mBAAmB;CACrC,AAAkB,6BAA6B;CAE/C,AAAS,oBAAoB,QAAyC;AACpE,MAAI,qBAAqB,QAAQ;GAC/B,MAAM,QAAQ,OAAO;AACrB,OAAI,OAAO,UAAU,SACnB,QAAO;AAET,OAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;;AAIxB,QAAM,IAAI,MACR,qCAAqC,KAAK,UAAU,OAAO,CAAC,WAAW,KAAK,WAAW,wCACxF;;;AAIL,IAAa,2BAAb,cAA8C,aAAmB;CAC/D,AAAkB,aAAa;CAC/B,AAAkB,eAAe;CACjC,AAAkB,oBAAoB;CACtC,AAAkB,eAAe;CACjC,AAAkB,mBAAmB;CACrC,AAAkB,6BAA6B;CAE/C,AAAS,oBAAoB,QAAyC;AACpE,MAAI,qBAAqB,QAAQ;GAC/B,MAAM,QAAQ,OAAO;AACrB,OAAI,OAAO,UAAU,SACnB,QAAO;AAET,OAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;;AAGxB,MAAI,oBAAoB,QAAQ;GAC9B,MAAM,QAAQ,OAAO;AACrB,OAAI,OAAO,UAAU,SACnB,QAAO;AAET,OAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;;AAGxB,QAAM,IAAI,MACR,qCAAqC,KAAK,UAAU,OAAO,CAAC,WAAW,KAAK,WAAW,wCACxF;;;AAIL,IAAa,qBAAb,cAAwC,aAAuB;CAC7D,AAAkB,aAAa;CAC/B,AAAkB,eAAe;CACjC,AAAkB,oBAAoB;CACtC,AAAkB,eAAe;CACjC,AAAkB,mBAAmB;CACrC,AAAkB,6BAA6B;CAE/C,AAAS,oBAAoB,QAAyC;AACpE,MAAI,kBAAkB,QAAQ;GAC5B,MAAM,QAAQ,OAAO;AACrB,OAAI,OAAO,UAAU,SACnB,QAAO;AAET,OAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;;AAGxB,QAAM,IAAI,MACR,qCAAqC,KAAK,UAAU,OAAO,CAAC,WAAW,KAAK,WAAW,wCACxF;;;AAIL,IAAa,qBAAb,cAAwC,aAAuB;CAC7D,AAAkB,aAAa;CAC/B,AAAkB,eAAe;CACjC,AAAkB,oBAAoB;CACtC,AAAkB,eAAe;CACjC,AAAkB,mBAAmB;CACrC,AAAkB,6BAA6B"}

package/dist/adapters/generic-sql/generic-sql-adapter.d.ts

@@ -1,43 +1,58 @@
 import { AnySchema } from "../../schema/create.js";
+import { SqlNamingStrategy } from "../../naming/sql-naming.js";
 import { DriverConfig } from "./driver-config.js";
+import { SQLiteStorageMode, sqliteStorageDefault, sqliteStoragePrisma } from "./sqlite-storage.js";
+import { OutboxConfig } from "../../outbox/outbox.js";
+import { UOWInstrumentation } from "../../query/unit-of-work/unit-of-work.js";
 import { SimpleQueryInterface } from "../../query/simple-query-interface.js";
 import { CompiledQuery, Dialect } from "../../sql-driver/sql-driver.js";
 import { SqlDriverAdapter } from "../../sql-driver/sql-driver-adapter.js";
 import { PreparedMigrations } from "./migration/prepared-migrations.js";
-import { DatabaseAdapter, DatabaseContextStorage, TableNameMapper, fragnoDatabaseAdapterNameFakeSymbol, fragnoDatabaseAdapterVersionFakeSymbol } from "../adapters.js";
+import { DatabaseAdapter, DatabaseAdapterMetadata, DatabaseContextStorage, SQLiteProfile, fragnoDatabaseAdapterNameFakeSymbol, fragnoDatabaseAdapterVersionFakeSymbol } from "../adapters.js";
 import { RequestContextStorage } from "@fragno-dev/core/internal/request-context-storage";
 
 //#region src/adapters/generic-sql/generic-sql-adapter.d.ts
 interface UnitOfWorkConfig {
   onQuery?: (query: CompiledQuery) => void;
   dryRun?: boolean;
+  instrumentation?: UOWInstrumentation;
 }
-interface GenericSQLOptions {
+interface SqlAdapterOptions {
   dialect: Dialect;
   driverConfig: DriverConfig;
   uowConfig?: UnitOfWorkConfig;
+  sqliteProfile?: SQLiteProfile;
+  sqliteStorageMode?: SQLiteStorageMode;
+  namingStrategy?: SqlNamingStrategy;
 }
-declare class GenericSQLAdapter implements DatabaseAdapter<UnitOfWorkConfig> {
+declare const sqliteProfiles: Record<SQLiteProfile, SQLiteStorageMode>;
+declare class SqlAdapter implements DatabaseAdapter<UnitOfWorkConfig> {
   #private;
   readonly dialect: Dialect;
   readonly driverConfig: DriverConfig;
   readonly uowConfig?: UnitOfWorkConfig;
+  readonly sqliteStorageMode?: SQLiteStorageMode;
+  readonly sqliteProfile?: SQLiteProfile;
+  readonly adapterMetadata: DatabaseAdapterMetadata;
+  readonly namingStrategy: SqlNamingStrategy;
   constructor({
     dialect,
     driverConfig,
-    uowConfig
-  }: GenericSQLOptions);
+    uowConfig,
+    sqliteProfile,
+    sqliteStorageMode,
+    namingStrategy
+  }: SqlAdapterOptions);
   get driver(): SqlDriverAdapter;
   get [fragnoDatabaseAdapterNameFakeSymbol](): string;
   get [fragnoDatabaseAdapterVersionFakeSymbol](): number;
   get contextStorage(): RequestContextStorage<DatabaseContextStorage>;
   close(): Promise<void>;
   isConnectionHealthy(): Promise<boolean>;
-  prepareMigrations<T extends AnySchema>(schema: T, namespace: string): PreparedMigrations;
-  createTableNameMapper(namespace: string): TableNameMapper;
+  prepareMigrations<T extends AnySchema>(schema: T, namespace: string | null): PreparedMigrations;
   getSchemaVersion(namespace: string): Promise<string | undefined>;
-  createQueryEngine<T extends AnySchema>(schema: T, namespace: string): SimpleQueryInterface<T, UnitOfWorkConfig>;
+  createQueryEngine<T extends AnySchema>(schema: T, namespace: string | null): SimpleQueryInterface<T, UnitOfWorkConfig>;
 }
 //#endregion
-export { GenericSQLAdapter, GenericSQLOptions, UnitOfWorkConfig };
+export { SqlAdapter, SqlAdapterOptions, UnitOfWorkConfig, sqliteProfiles };
 //# sourceMappingURL=generic-sql-adapter.d.ts.map

package/dist/adapters/generic-sql/generic-sql-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generic-sql-adapter.d.ts","names":[],"sources":["../../../src/adapters/generic-sql/generic-sql-adapter.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;UAyBiB,gBAAA;oBACG;EADH,MAAA,CAAA,EAAA,OAAA;AAKjB;AACW,UADM,iBAAA,CACN;EACK,OAAA,EADL,OACK;EACF,YAAA,EADE,YACF;EAAgB,SAAA,CAAA,EAAhB,gBAAgB;AAG9B;AAA0D,cAA7C,iBAAA,YAA6B,eAAgB,CAAA,gBAAA,CAAA,CAAA;EACtC,CAAA,OAAA;EACK,SAAA,OAAA,EADL,OACK;EACF,SAAA,YAAA,EADE,YACF;EAOP,SAAA,SAAA,CAAA,EAPO,gBAOP;EAAS,WAAA,CAAA;IAAA,OAAA;IAAA,YAAA;IAAA;EAAA,CAAA,EAA2B,iBAA3B;EAAc,IAAA,MAAA,CAAA,CAAA,EAWvB,gBAXuB;EAAa,KAe7C,mCAAA,GAf6C,EAAA,MAAA;EAWpC,KAQT,sCAAA,GARS,EAAA,MAAA;EAIT,IAAA,cAAA,CAAA,CAAA,EAQiB,qBARjB,CAQuC,sBARvC,CAAA;EAIA,KAAA,CAAA,CAAA,EAQI,OARJ,CAAA,IAAA,CAAA;EAIuC,mBAAA,CAAA,CAAA,EAQf,OARe,CAAA,OAAA,CAAA;EAAtB,iBAAA,CAAA,UAaM,SAbN,CAAA,CAAA,MAAA,EAayB,CAbzB,EAAA,SAAA,EAAA,MAAA,CAAA,EAagD,kBAbhD;EAIb,qBAAA,CAAA,SAAA,EAAA,MAAA,CAAA,EAmBiC,eAnBjC;EAIoB,gBAAA,CAAA,SAAA,EAAA,MAAA,CAAA,EAmBc,OAnBd,CAAA,MAAA,GAAA,SAAA,CAAA;EAKD,iBAAA,CAAA,UA2CA,SA3CA,CAAA,CAAA,MAAA,EA4ClB,CA5CkB,EAAA,SAAA,EAAA,MAAA,CAAA,EA8CzB,oBA9CyB,CA8CJ,CA9CI,EA8CD,gBA9CC,CAAA"}
+{"version":3,"file":"generic-sql-adapter.d.ts","names":[],"sources":["../../../src/adapters/generic-sql/generic-sql-adapter.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;UAoCiB,gBAAA;oBACG;;EADH,eAAA,CAAA,EAGG,kBAFA;AAKpB;AACW,UADM,iBAAA,CACN;EACK,OAAA,EADL,OACK;EACF,YAAA,EADE,YACF;EACI,SAAA,CAAA,EADJ,gBACI;EACI,aAAA,CAAA,EADJ,aACI;EACH,iBAAA,CAAA,EADG,iBACH;EAAiB,cAAA,CAAA,EAAjB,iBAAiB;AAGpC;AAAoC,cAAvB,cAAuB,EAAP,MAAO,CAAA,aAAA,EAAe,iBAAf,CAAA;AAAe,cAKtC,UAAA,YAAsB,eALgB,CAKA,gBALA,CAAA,CAAA;EAAtB,CAAA,OAAA;EAAM,SAAA,OAAA,EAMf,OANe;EAKtB,SAAA,YAAW,EAEC,YAFD;EAA2B,SAAA,SAAA,CAAA,EAG5B,gBAH4B;EAC/B,SAAA,iBAAA,CAAA,EAGW,iBAHX;EACK,SAAA,aAAA,CAAA,EAGE,aAHF;EACF,SAAA,eAAA,EAGK,uBAHL;EACQ,SAAA,cAAA,EAGJ,iBAHI;EACJ,WAAA,CAAA;IAAA,OAAA;IAAA,YAAA;IAAA,SAAA;IAAA,aAAA;IAAA,iBAAA;IAAA;EAAA,CAAA,EAgBtB,iBAhBsB;EACC,IAAA,MAAA,CAAA,CAAA,EA6CZ,gBA7CY;EACD,KAgDpB,mCAAA,GAhDoB,EAAA,MAAA;EAQvB,KA4CG,sCAAA,GA5CH,EAAA,MAAA;EACA,IAAA,cAAA,CAAA,CAAA,EA+CoB,qBA/CpB,CA+C0C,sBA/C1C,CAAA;EACA,KAAA,CAAA,CAAA,EAkDO,OAlDP,CAAA,IAAA,CAAA;EACA,mBAAA,CAAA,CAAA,EAqD2B,OArD3B,CAAA,OAAA,CAAA;EACA,iBAAA,CAAA,UA0D0B,SA1D1B,CAAA,CAAA,MAAA,EA0D6C,CA1D7C,EAAA,SAAA,EAAA,MAAA,GAAA,IAAA,CAAA,EA0D2E,kBA1D3E;EACA,gBAAA,CAAA,SAAA,EAAA,MAAA,CAAA,EAsEyC,OAtEzC,CAAA,MAAA,GAAA,SAAA,CAAA;EACC,iBAAA,CAAA,UAkGyB,SAlGzB,CAAA,CAAA,MAAA,EAmGO,CAnGP,EAAA,SAAA,EAAA,MAAA,GAAA,IAAA,CAAA,EAqGA,oBArGA,CAqGqB,CArGrB,EAqGwB,gBArGxB,CAAA"}