@fragno-dev/db 0.2.2 → 0.3.0

package/dist/migration-engine/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","names":[],"sources":["../../src/migration-engine/shared.ts"],"sourcesContent":["export interface ForeignKeyInfo {\n  name: string;\n  columns: string[];\n  referencedTable: string;\n  referencedColumns: string[];\n}\n\n/**\n * Provider-specific metadata that can be attached to operations during preprocessing.\n * This allows providers to add additional context without polluting the core operation types.\n */\nexport interface MigrationOperationMetadata {\n  [key: string]: unknown;\n}\n\n/**\n * SQLite-specific metadata for create-table operations.\n * Includes foreign keys that should be created inline with the table.\n */\nexport interface SqliteCreateTableMetadata extends MigrationOperationMetadata {\n  inlineForeignKeys?: ForeignKeyInfo[];\n}\n\nexport interface ColumnInfo {\n  name: string;\n  type:\n    | \"string\"\n    | \"integer\"\n    | \"bigint\"\n    | \"decimal\"\n    | \"bool\"\n    | \"date\"\n    | \"timestamp\"\n    | \"json\"\n    | \"binary\"\n    | `varchar(${number})`;\n  isNullable: boolean;\n  role: \"external-id\" | \"internal-id\" | \"version\" | \"reference\" | \"regular\";\n  default?: { value: unknown } | { dbSpecial: \"now\" } | { runtime: \"cuid\" | \"now\" };\n}\n\nexport type MigrationOperation<\n  TMeta extends MigrationOperationMetadata = MigrationOperationMetadata,\n> =\n  | (TableOperation & { metadata?: TMeta })\n  | ({\n      // warning: not supported by SQLite\n      type: \"add-foreign-key\";\n      table: string;\n      value: ForeignKeyInfo;\n    } & { metadata?: TMeta })\n  | ({\n      // warning: not supported by SQLite\n      type: \"drop-foreign-key\";\n      table: string;\n      name: string;\n    } & { metadata?: TMeta })\n  | ({\n      type: \"drop-index\";\n      table: string;\n      name: string;\n    } & { metadata?: TMeta })\n  | ({\n      type: \"add-index\";\n      table: string;\n      columns: string[];\n      name: string;\n      unique: boolean;\n    } & { metadata?: TMeta })\n  | (CustomOperation & { metadata?: TMeta });\n\nexport type CustomOperation = {\n  type: \"custom\";\n} & Record<string, unknown>;\n\nexport type TableOperation =\n  | {\n      type: \"create-table\";\n      name: string;\n      columns: ColumnInfo[];\n    }\n  | {\n      type: \"drop-table\";\n      name: string;\n    }\n  | {\n      type: \"alter-table\";\n      name: string;\n      value: ColumnOperation[];\n    }\n  | {\n      type: \"rename-table\";\n      from: string;\n      to: string;\n    };\n\nexport type ColumnOperation =\n  | {\n      type: \"rename-column\";\n      from: string;\n      to: string;\n    }\n  | {\n      type: \"drop-column\";\n      name: string;\n    }\n  | {\n      /**\n       * Note: unique constraints are not created, please use dedicated operations like `add-index` instead\n       */\n      type: \"create-column\";\n      value: ColumnInfo;\n    }\n  | {\n      /**\n       * warning: Not supported by SQLite\n       */\n      type: \"update-column\";\n      name: string;\n      /**\n       * For databases like MySQL, it requires the full definition for any modify column statement.\n       * Hence, you need to specify the full information of your column here.\n       *\n       * Then, opt-in for in-detail modification for other databases that supports changing data type/nullable/default separately, such as PostgreSQL.\n       *\n       * Note: unique constraints are not updated, please use dedicated operations like `add-index` instead\n       */\n      value: ColumnInfo;\n\n      updateNullable: boolean;\n      updateDefault: boolean;\n      updateDataType: boolean;\n    };\n\nexport function isUpdated(op: Extract<ColumnOperation, { type: \"update-column\" }>): boolean {\n  return op.updateDataType || op.updateDefault || op.updateNullable;\n}\n"],"mappings":";AAsIA,SAAgB,UAAU,IAAkE;AAC1F,QAAO,GAAG,kBAAkB,GAAG,iBAAiB,GAAG"}
+{"version":3,"file":"shared.js","names":[],"sources":["../../src/migration-engine/shared.ts"],"sourcesContent":["export interface ForeignKeyInfo {\n  name: string;\n  columns: string[];\n  referencedTable: string;\n  referencedColumns: string[];\n}\n\n/**\n * Provider-specific metadata that can be attached to operations during preprocessing.\n * This allows providers to add additional context without polluting the core operation types.\n */\nexport interface MigrationOperationMetadata {\n  [key: string]: unknown;\n}\n\n/**\n * SQLite-specific metadata for create-table operations.\n * Includes foreign keys that should be created inline with the table.\n */\nexport interface SqliteCreateTableMetadata extends MigrationOperationMetadata {\n  inlineForeignKeys?: ForeignKeyInfo[];\n}\n\nexport interface ColumnInfo {\n  name: string;\n  type:\n    | \"string\"\n    | \"integer\"\n    | \"bigint\"\n    | \"decimal\"\n    | \"bool\"\n    | \"date\"\n    | \"timestamp\"\n    | \"json\"\n    | \"binary\"\n    | `varchar(${number})`;\n  isNullable: boolean;\n  role: \"external-id\" | \"internal-id\" | \"version\" | \"reference\" | \"regular\";\n  default?: { value: unknown } | { dbSpecial: \"now\" } | { runtime: \"cuid\" | \"now\" };\n}\n\nexport type MigrationOperation<\n  TMeta extends MigrationOperationMetadata = MigrationOperationMetadata,\n> =\n  | (TableOperation & { metadata?: TMeta })\n  | ({\n      // warning: not supported by SQLite\n      type: \"add-foreign-key\";\n      table: string;\n      value: ForeignKeyInfo;\n    } & { metadata?: TMeta })\n  | ({\n      // warning: not supported by SQLite\n      type: \"drop-foreign-key\";\n      table: string;\n      name: string;\n      referencedTable: string;\n    } & { metadata?: TMeta })\n  | ({\n      type: \"drop-index\";\n      table: string;\n      name: string;\n    } & { metadata?: TMeta })\n  | ({\n      type: \"add-index\";\n      table: string;\n      columns: string[];\n      name: string;\n      unique: boolean;\n    } & { metadata?: TMeta })\n  | (CustomOperation & { metadata?: TMeta });\n\nexport type CustomOperation = {\n  type: \"custom\";\n} & Record<string, unknown>;\n\nexport type TableOperation =\n  | {\n      type: \"create-table\";\n      name: string;\n      columns: ColumnInfo[];\n    }\n  | {\n      type: \"drop-table\";\n      name: string;\n    }\n  | {\n      type: \"alter-table\";\n      name: string;\n      value: ColumnOperation[];\n    }\n  | {\n      type: \"rename-table\";\n      from: string;\n      to: string;\n    };\n\nexport type ColumnOperation =\n  | {\n      type: \"rename-column\";\n      from: string;\n      to: string;\n    }\n  | {\n      type: \"drop-column\";\n      name: string;\n    }\n  | {\n      /**\n       * Note: unique constraints are not created, please use dedicated operations like `add-index` instead\n       */\n      type: \"create-column\";\n      value: ColumnInfo;\n    }\n  | {\n      /**\n       * warning: Not supported by SQLite\n       */\n      type: \"update-column\";\n      name: string;\n      /**\n       * For databases like MySQL, it requires the full definition for any modify column statement.\n       * Hence, you need to specify the full information of your column here.\n       *\n       * Then, opt-in for in-detail modification for other databases that supports changing data type/nullable/default separately, such as PostgreSQL.\n       *\n       * Note: unique constraints are not updated, please use dedicated operations like `add-index` instead\n       */\n      value: ColumnInfo;\n\n      updateNullable: boolean;\n      updateDefault: boolean;\n      updateDataType: boolean;\n    };\n\nexport function isUpdated(op: Extract<ColumnOperation, { type: \"update-column\" }>): boolean {\n  return op.updateDataType || op.updateDefault || op.updateNullable;\n}\n"],"mappings":";AAuIA,SAAgB,UAAU,IAAkE;AAC1F,QAAO,GAAG,kBAAkB,GAAG,iBAAiB,GAAG"}

package/dist/mod.d.ts

@@ -1,11 +1,18 @@
+import { DbNow, dbNow } from "./query/db-now.js";
 import { AnySchema } from "./schema/create.js";
 import { Cursor, CursorData, CursorResult, decodeCursor } from "./query/cursor.js";
 import { ExponentialBackoffRetryPolicy, LinearBackoffRetryPolicy, NoRetryPolicy, RetryPolicy } from "./query/unit-of-work/retry-policy.js";
 import { BuilderTransformContextWithMutate, BuilderTransformContextWithoutMutate, ConcurrencyConflictError, ExtractServiceFinalResults, ExtractServiceRetrieveResults, HandlerBuilderMutateContext, HandlerTxBuilder, ServiceBuilderMutateContext, ServiceTxBuilder, TxResult, createHandlerTxBuilder, createServiceTxBuilder } from "./query/unit-of-work/execute-unit-of-work.js";
-import { DatabaseFragmentContext, DatabaseFragmentDefinitionBuilder, DatabaseHandlerContext, FragnoPublicConfigWithDatabase, ImplicitDatabaseDependencies } from "./db-fragment-definition-builder.js";
+import { DatabaseFragmentContext, DatabaseFragmentDefinitionBuilder, DatabaseHandlerContext, DatabaseServiceContext, FragnoPublicConfigWithDatabase, ImplicitDatabaseDependencies } from "./db-fragment-definition-builder.js";
+import { InMemoryAdapterOptions } from "./adapters/in-memory/options.js";
+import { InMemoryAdapter } from "./adapters/in-memory/in-memory-adapter.js";
+import "./adapters/in-memory/index.js";
 import { withDatabase } from "./with-database.js";
+import { OutboxConfig, OutboxEntry, OutboxMutation, OutboxPayload, OutboxRefMap } from "./outbox/outbox.js";
+import { DurableHooksProcessor, createDurableHooksProcessor } from "./hooks/durable-hooks-processor.js";
+import { internalSchema } from "./fragments/internal-fragment.schema.js";
 import { InternalFragmentInstance, internalFragmentDef } from "./fragments/internal-fragment.js";
-import { HookContext, HookFn, HookPayload, HooksMap, TriggerHookOptions } from "./hooks/hooks.js";
+import { DurableHooksProcessingOptions, HookContext, HookFn, HookPayload, HooksMap, StuckHookProcessingEvent, StuckHookProcessingInfo, StuckHookProcessingTimeoutMinutes, TriggerHookOptions } from "./hooks/hooks.js";
 import { IUnitOfWork, IUnitOfWorkRestricted, TypedUnitOfWork, UOWCompiler, UOWDecoder, UOWExecutor, UnitOfWork, createUnitOfWork } from "./query/unit-of-work/unit-of-work.js";
 import { DatabaseAdapter } from "./adapters/adapters.js";
 import { AnyFragnoInstantiatedFragment, BoundServices, FragnoInstantiatedFragment } from "@fragno-dev/core";
@@ -14,7 +21,7 @@ import { AnyFragnoInstantiatedFragment, BoundServices, FragnoInstantiatedFragmen
 declare const fragnoDatabaseFakeSymbol: "$fragno-database";
 declare const fragnoDatabaseLibraryVersion: "0.1";
 interface CreateFragnoDatabaseDefinitionOptions<T extends AnySchema> {
-  namespace: string;
+  namespace: string | null;
   schema: T;
 }
 declare function isFragnoDatabase(value: unknown): value is FragnoDatabase<AnySchema>;
@@ -25,16 +32,16 @@ declare function isFragnoDatabase(value: unknown): value is FragnoDatabase<AnySc
 declare class FragnoDatabase<const T extends AnySchema, TUOWConfig = void> {
   #private;
   constructor(options: {
-    namespace: string;
+    namespace: string | null;
     schema: T;
     adapter: DatabaseAdapter<TUOWConfig>;
   });
   get [fragnoDatabaseFakeSymbol](): typeof fragnoDatabaseFakeSymbol;
-  get namespace(): string;
+  get namespace(): string | null;
   get schema(): T;
   get adapter(): DatabaseAdapter<TUOWConfig>;
 }
-type AnyFragnoInstantiatedDatabaseFragment = FragnoInstantiatedFragment<any, ImplicitDatabaseDependencies<AnySchema>, any, any, any, any, FragnoPublicConfigWithDatabase, {
+type AnyFragnoInstantiatedDatabaseFragment<TSchema extends AnySchema = AnySchema> = FragnoInstantiatedFragment<any, ImplicitDatabaseDependencies<TSchema>, any, any, any, any, FragnoPublicConfigWithDatabase, {
   _fragno_internal: InternalFragmentInstance;
 } & Record<string, AnyFragnoInstantiatedFragment>>;
 /**
@@ -59,7 +66,7 @@ type AnyFragnoInstantiatedDatabaseFragment = FragnoInstantiatedFragment<any, Imp
  * await migrate(fragment);
  * ```
  */
-declare function migrate(fragment: AnyFragnoInstantiatedDatabaseFragment): Promise<void>;
+declare function migrate<TSchema extends AnySchema>(fragment: AnyFragnoInstantiatedDatabaseFragment<TSchema>): Promise<void>;
 //#endregion
-export { AnyFragnoInstantiatedDatabaseFragment, type BoundServices, type BuilderTransformContextWithMutate, type BuilderTransformContextWithoutMutate, ConcurrencyConflictError, CreateFragnoDatabaseDefinitionOptions, Cursor, type CursorData, type CursorResult, type DatabaseAdapter, type DatabaseFragmentContext, DatabaseFragmentDefinitionBuilder, type DatabaseHandlerContext as DatabaseRequestContext, ExponentialBackoffRetryPolicy, type ExtractServiceFinalResults, type ExtractServiceRetrieveResults, FragnoDatabase, type FragnoPublicConfigWithDatabase, type HandlerBuilderMutateContext, HandlerTxBuilder, type HookContext, type HookFn, type HookPayload, type HooksMap, type IUnitOfWork, type IUnitOfWorkRestricted, type ImplicitDatabaseDependencies, type InternalFragmentInstance, LinearBackoffRetryPolicy, NoRetryPolicy, type RetryPolicy, type ServiceBuilderMutateContext, ServiceTxBuilder, type TriggerHookOptions, type TxResult, TypedUnitOfWork, type UOWCompiler, type UOWDecoder, type UOWExecutor, UnitOfWork, createHandlerTxBuilder, createServiceTxBuilder, createUnitOfWork, decodeCursor, fragnoDatabaseFakeSymbol, fragnoDatabaseLibraryVersion, internalFragmentDef, isFragnoDatabase, migrate, withDatabase };
+export { AnyFragnoInstantiatedDatabaseFragment, type BoundServices, type BuilderTransformContextWithMutate, type BuilderTransformContextWithoutMutate, ConcurrencyConflictError, CreateFragnoDatabaseDefinitionOptions, Cursor, type CursorData, type CursorResult, type DatabaseAdapter, type DatabaseFragmentContext, DatabaseFragmentDefinitionBuilder, type DatabaseHandlerContext as DatabaseRequestContext, type DatabaseServiceContext, type DbNow, type DurableHooksProcessingOptions, type DurableHooksProcessor, ExponentialBackoffRetryPolicy, type ExtractServiceFinalResults, type ExtractServiceRetrieveResults, FragnoDatabase, type FragnoPublicConfigWithDatabase, type HandlerBuilderMutateContext, HandlerTxBuilder, type HookContext, type HookFn, type HookPayload, type HooksMap, type IUnitOfWork, type IUnitOfWorkRestricted, type ImplicitDatabaseDependencies, InMemoryAdapter, type InMemoryAdapterOptions, type InternalFragmentInstance, LinearBackoffRetryPolicy, NoRetryPolicy, type OutboxConfig, type OutboxEntry, type OutboxMutation, type OutboxPayload, type OutboxRefMap, type RetryPolicy, type ServiceBuilderMutateContext, ServiceTxBuilder, type StuckHookProcessingEvent, type StuckHookProcessingInfo, type StuckHookProcessingTimeoutMinutes, type TriggerHookOptions, type TxResult, TypedUnitOfWork, type UOWCompiler, type UOWDecoder, type UOWExecutor, UnitOfWork, createDurableHooksProcessor, createHandlerTxBuilder, createServiceTxBuilder, createUnitOfWork, dbNow, decodeCursor, fragnoDatabaseFakeSymbol, fragnoDatabaseLibraryVersion, internalFragmentDef, internalSchema, isFragnoDatabase, migrate, withDatabase };
 //# sourceMappingURL=mod.d.ts.map

package/dist/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","names":[],"sources":["../src/mod.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;cAiBa;cACA;UAEI,gDAAgD;;EAHpD,MAAA,EAKH,CALG;AACb;AAEiB,iBAKD,gBAAA,CALC,KAAqC,EAAA,OAAA,CAAW,EAAA,KAAA,IAKN,cAHhD,CAG+D,SAH/D,CAAA;AAGX;AAmBA;;;AAKgF,cALnE,cAKmE,CAAA,gBALpC,SAKoC,EAAA,aAAA,IAAA,CAAA,CAAA;EAAhB,CAAA,OAAA;EAMrB,WAAA,CAAA,OAAA,EAAA;IAApC,SAAA,EAAA,MAAA;IAQK,MAAA,EAdwC,CAcxC;IAIqB,OAAA,EAlB+B,eAkB/B,CAlB+C,UAkB/C,CAAA;EAAhB,CAAA;EAAe,KAZzB,wBAAA,GAYyB,EAAA,OAZW,wBAYX;EA2DpB,IAAA,SAAA,CAAA,CAAA,EAAA,MAAA;EAGmB,IAAA,MAAA,CAAA,CAAA,EAlEnB,CAkEmB;EAA7B,IAAA,OAAA,CAAA,CAAA,EA9De,eA8Df,CA9D+B,UA8D/B,CAAA;;KAHU,qCAAA,GAAwC,gCAGlD,6BAA6B,gCAS7B;oBAEoB;IAA6B,eAAe;;;;;;;;;;;;;;;;;;;;;;;iBAyB5C,OAAA,WAAkB,wCAAwC"}
+{"version":3,"file":"mod.d.ts","names":[],"sources":["../src/mod.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;cAuBa;cACA;UAEI,gDAAgD;;UAEvD;;AALG,iBAQG,gBAAA,CARmD,KAAA,EAAA,OAAA,CAAA,EAAA,KAAA,IAQR,cARQ,CAQO,SARP,CAAA;AACnE;AAEA;AAKA;AAmBA;AAA4C,cAA/B,cAA+B,CAAA,gBAAA,SAAA,EAAA,aAAA,IAAA,CAAA,CAAA;EAOhC,CAAA,OAAA;EACiB,WAAA,CAAA,OAAA,EAAA;IAAhB,SAAA,EAAA,MAAA,GAAA,IAAA;IAO8B,MAAA,EAR/B,CAQ+B;IAApC,OAAA,EAPM,eAON,CAPsB,UAOtB,CAAA;EAQK,CAAA;EAIqB,KAZ1B,wBAAA,GAY0B,EAAA,OAZU,wBAYV;EAAhB,IAAA,SAAA,CAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAAe,IAAA,MAAA,CAAA,CAAA,EAJpB,CAIoB;EAiFpB,IAAA,OAAA,CAAA,CAAA,EAjFK,eAiFL,CAjFqB,UAiFgB,CAAA;;AAyCrC,KAzCA,qCAyCA,CAAA,gBAzCsD,SAyCtD,GAzCkE,SAyClE,CAAA,GAxCV,0BAwCU,CAAA,GAAA,EArCR,4BAqCQ,CArCqB,OAqCrB,CAAA,EAAA,GAAA,EAAA,GAAA,EAAA,GAAA,EAAA,GAAA,EA5BR,8BA4BQ,EAAA;EACT,gBAAA,EA3BqB,wBA2BrB;CAAO,GA3B2C,MA2B3C,CAAA,MAAA,EA3B0D,6BA2B1D,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;iBAFY,wBAAwB,qBAClC,sCAAsC,WAC/C"}

package/dist/mod.js

@@ -1,10 +1,16 @@
 import { ExponentialBackoffRetryPolicy, LinearBackoffRetryPolicy, NoRetryPolicy } from "./query/unit-of-work/retry-policy.js";
 import { ConcurrencyConflictError, HandlerTxBuilder, ServiceTxBuilder, createHandlerTxBuilder, createServiceTxBuilder } from "./query/unit-of-work/execute-unit-of-work.js";
-import { DatabaseFragmentDefinitionBuilder } from "./db-fragment-definition-builder.js";
+import { internalSchema } from "./fragments/internal-fragment.schema.js";
 import { Cursor, decodeCursor } from "./query/cursor.js";
+import { dbNow } from "./query/db-now.js";
+import { TypedUnitOfWork, UnitOfWork, createUnitOfWork } from "./query/unit-of-work/unit-of-work.js";
+import { resolveDatabaseAdapter } from "./util/default-database-adapter.js";
+import { DatabaseFragmentDefinitionBuilder } from "./db-fragment-definition-builder.js";
 import { getSchemaVersionFromDatabase, internalFragmentDef } from "./fragments/internal-fragment.js";
+import { InMemoryAdapter } from "./adapters/in-memory/in-memory-adapter.js";
+import "./adapters/in-memory/index.js";
 import { withDatabase } from "./with-database.js";
-import { TypedUnitOfWork, UnitOfWork, createUnitOfWork } from "./query/unit-of-work/unit-of-work.js";
+import { createDurableHooksProcessor } from "./hooks/durable-hooks-processor.js";
 
 //#region src/mod.ts
 const fragnoDatabaseFakeSymbol = "$fragno-database";
@@ -64,18 +70,18 @@ var FragnoDatabase = class {
 */
 async function migrate(fragment) {
 	const { options, deps, linkedFragments } = fragment.$internal;
-	const adapter = options.databaseAdapter;
+	const adapter = resolveDatabaseAdapter(options, deps.schema);
 	if (!adapter.prepareMigrations) throw new Error("Database adapter does not support prepareMigrations. Please use an adapter that implements this method.");
 	const schema = deps.schema;
-	const namespace = deps.namespace;
+	const namespace = deps.namespace ?? schema.name;
 	const internalFragment = linkedFragments._fragno_internal;
 	if (!internalFragment) throw new Error("Internal fragment not found. Please ensure the internal fragment is linked.");
 	if (!await adapter.isConnectionHealthy()) throw new Error("Database connection is not healthy. Please check your database connection and try again.");
 	const internalDeps = internalFragment.$internal.deps;
-	const internalSchema = internalDeps.schema;
-	const internalNamespace = internalDeps.namespace;
+	const internalSchema$1 = internalDeps.schema;
+	const internalNamespace = internalDeps.namespace ?? "";
 	const internalCurrentVersion = await getSchemaVersionFromDatabase(internalFragment, internalNamespace);
-	if (internalCurrentVersion < internalSchema.version) await adapter.prepareMigrations(internalSchema, internalNamespace).execute(internalCurrentVersion, internalSchema.version);
+	if (internalCurrentVersion < internalSchema$1.version) await adapter.prepareMigrations(internalSchema$1, internalNamespace).execute(internalCurrentVersion, internalSchema$1.version);
 	const currentVersion = await getSchemaVersionFromDatabase(internalFragment, namespace);
 	const targetVersion = schema.version;
 	if (currentVersion === targetVersion) return;
@@ -84,5 +90,5 @@ async function migrate(fragment) {
 }
 
 //#endregion
-export { ConcurrencyConflictError, Cursor, DatabaseFragmentDefinitionBuilder, ExponentialBackoffRetryPolicy, FragnoDatabase, HandlerTxBuilder, LinearBackoffRetryPolicy, NoRetryPolicy, ServiceTxBuilder, TypedUnitOfWork, UnitOfWork, createHandlerTxBuilder, createServiceTxBuilder, createUnitOfWork, decodeCursor, fragnoDatabaseFakeSymbol, fragnoDatabaseLibraryVersion, internalFragmentDef, isFragnoDatabase, migrate, withDatabase };
+export { ConcurrencyConflictError, Cursor, DatabaseFragmentDefinitionBuilder, ExponentialBackoffRetryPolicy, FragnoDatabase, HandlerTxBuilder, InMemoryAdapter, LinearBackoffRetryPolicy, NoRetryPolicy, ServiceTxBuilder, TypedUnitOfWork, UnitOfWork, createDurableHooksProcessor, createHandlerTxBuilder, createServiceTxBuilder, createUnitOfWork, dbNow, decodeCursor, fragnoDatabaseFakeSymbol, fragnoDatabaseLibraryVersion, internalFragmentDef, internalSchema, isFragnoDatabase, migrate, withDatabase };
 //# sourceMappingURL=mod.js.map

package/dist/mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"mod.js","names":["#namespace","#schema","#adapter"],"sources":["../src/mod.ts"],"sourcesContent":["import type { DatabaseAdapter } from \"./adapters/adapters\";\nimport type { AnySchema } from \"./schema/create\";\nimport type { CursorResult } from \"./query/cursor\";\nimport { Cursor } from \"./query/cursor\";\nimport type { FragnoInstantiatedFragment, AnyFragnoInstantiatedFragment } from \"@fragno-dev/core\";\nimport type {\n  FragnoPublicConfigWithDatabase,\n  ImplicitDatabaseDependencies,\n} from \"./db-fragment-definition-builder\";\nimport {\n  getSchemaVersionFromDatabase,\n  type InternalFragmentInstance,\n} from \"./fragments/internal-fragment\";\n\nexport type { DatabaseAdapter, CursorResult };\nexport { Cursor };\n\nexport const fragnoDatabaseFakeSymbol = \"$fragno-database\" as const;\nexport const fragnoDatabaseLibraryVersion = \"0.1\" as const;\n\nexport interface CreateFragnoDatabaseDefinitionOptions<T extends AnySchema> {\n  namespace: string;\n  schema: T;\n}\n\nexport function isFragnoDatabase(value: unknown): value is FragnoDatabase<AnySchema> {\n  if (value instanceof FragnoDatabase) {\n    return true;\n  }\n\n  if (typeof value !== \"object\" || value === null) {\n    return false;\n  }\n\n  return (\n    fragnoDatabaseFakeSymbol in value &&\n    value[fragnoDatabaseFakeSymbol] === fragnoDatabaseFakeSymbol\n  );\n}\n\n/**\n * A Fragno database instance with a bound adapter.\n * Created from a FragnoDatabaseDefinition by calling .create(adapter).\n */\nexport class FragnoDatabase<const T extends AnySchema, TUOWConfig = void> {\n  #namespace: string;\n  #schema: T;\n  #adapter: DatabaseAdapter<TUOWConfig>;\n\n  constructor(options: { namespace: string; schema: T; adapter: DatabaseAdapter<TUOWConfig> }) {\n    this.#namespace = options.namespace;\n    this.#schema = options.schema;\n    this.#adapter = options.adapter;\n  }\n\n  get [fragnoDatabaseFakeSymbol](): typeof fragnoDatabaseFakeSymbol {\n    return fragnoDatabaseFakeSymbol;\n  }\n\n  get namespace() {\n    return this.#namespace;\n  }\n\n  get schema() {\n    return this.#schema;\n  }\n\n  get adapter(): DatabaseAdapter<TUOWConfig> {\n    return this.#adapter;\n  }\n}\n\nexport {\n  DatabaseFragmentDefinitionBuilder,\n  type FragnoPublicConfigWithDatabase,\n  type DatabaseFragmentContext,\n  type DatabaseHandlerContext as DatabaseRequestContext,\n  type ImplicitDatabaseDependencies,\n} from \"./db-fragment-definition-builder\";\n\nexport { withDatabase } from \"./with-database\";\n\nexport { decodeCursor, type CursorData } from \"./query/cursor\";\n\nexport {\n  createUnitOfWork,\n  UnitOfWork,\n  TypedUnitOfWork,\n  type IUnitOfWork,\n  type IUnitOfWorkRestricted,\n  type UOWCompiler,\n  type UOWExecutor,\n  type UOWDecoder,\n} from \"./query/unit-of-work/unit-of-work\";\n\nexport {\n  type RetryPolicy,\n  NoRetryPolicy,\n  ExponentialBackoffRetryPolicy,\n  LinearBackoffRetryPolicy,\n} from \"./query/unit-of-work/retry-policy\";\n\nexport {\n  ConcurrencyConflictError,\n  // Builder pattern exports\n  ServiceTxBuilder,\n  HandlerTxBuilder,\n  createServiceTxBuilder,\n  createHandlerTxBuilder,\n  type TxResult,\n  // Builder context types\n  type ServiceBuilderMutateContext,\n  type HandlerBuilderMutateContext,\n  type BuilderTransformContextWithMutate,\n  type BuilderTransformContextWithoutMutate,\n  type ExtractServiceRetrieveResults,\n  type ExtractServiceFinalResults,\n} from \"./query/unit-of-work/execute-unit-of-work\";\n\nexport type { BoundServices } from \"@fragno-dev/core\";\n\nexport { internalFragmentDef } from \"./fragments/internal-fragment\";\nexport type { InternalFragmentInstance } from \"./fragments/internal-fragment\";\n\nexport type { HookContext, HooksMap, HookFn, HookPayload, TriggerHookOptions } from \"./hooks/hooks\";\n\nexport type AnyFragnoInstantiatedDatabaseFragment = FragnoInstantiatedFragment<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any,\n  ImplicitDatabaseDependencies<AnySchema>,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any,\n  FragnoPublicConfigWithDatabase,\n  // Ensure the fragment has the internal fragment linked\n  { _fragno_internal: InternalFragmentInstance } & Record<string, AnyFragnoInstantiatedFragment>\n>;\n\n/**\n * Helper function to run migrations for a database fragment.\n * Extracts the database adapter, schema, and namespace from the fragment and runs migrations.\n * This function:\n * 1. Ensures the internal settings fragment is migrated first\n * 2. Retrieves the current database version from the internal fragment\n * 3. Runs migration from current version to target version\n *\n * @param fragment - The instantiated fragment to run migrations for\n * @throws Error if the fragment doesn't have database support or the adapter doesn't support migrations\n *\n * @example\n * ```typescript\n * const fragment = instantiate(myFragmentDef)\n *   .withConfig({})\n *   .withRoutes([])\n *   .withOptions({ databaseAdapter: myAdapter })\n *   .build();\n *\n * await migrate(fragment);\n * ```\n */\nexport async function migrate(fragment: AnyFragnoInstantiatedDatabaseFragment): Promise<void> {\n  const { options, deps, linkedFragments } = fragment.$internal;\n  const adapter = options.databaseAdapter;\n\n  // Check if adapter supports prepareMigrations\n  if (!adapter.prepareMigrations) {\n    throw new Error(\n      \"Database adapter does not support prepareMigrations. Please use an adapter that implements this method.\",\n    );\n  }\n\n  const schema = deps.schema;\n  const namespace = deps.namespace;\n\n  // Step 1: Ensure the internal fragment (settings table) is migrated first\n  const internalFragment = linkedFragments._fragno_internal;\n\n  if (!internalFragment) {\n    throw new Error(\"Internal fragment not found. Please ensure the internal fragment is linked.\");\n  }\n\n  if (!(await adapter.isConnectionHealthy())) {\n    throw new Error(\n      \"Database connection is not healthy. Please check your database connection and try again.\",\n    );\n  }\n\n  const internalDeps = internalFragment.$internal.deps;\n  const internalSchema = internalDeps.schema;\n  const internalNamespace = internalDeps.namespace;\n\n  const internalCurrentVersion = await getSchemaVersionFromDatabase(\n    internalFragment,\n    internalNamespace,\n  );\n\n  // Migrate internal fragment if needed\n  if (internalCurrentVersion < internalSchema.version) {\n    const internalMigrations = adapter.prepareMigrations(internalSchema, internalNamespace);\n    await internalMigrations.execute(internalCurrentVersion, internalSchema.version);\n  }\n\n  // Step 2: Get current database version for this fragment's namespace\n  const currentVersion = await getSchemaVersionFromDatabase(internalFragment, namespace);\n\n  // Step 3: Run the migration from current version to target version\n  const targetVersion = schema.version;\n\n  if (currentVersion === targetVersion) {\n    return;\n  }\n\n  if (currentVersion > targetVersion) {\n    throw new Error(\n      `Cannot migrate backwards: current version (${currentVersion}) > target version (${targetVersion})`,\n    );\n  }\n\n  const migrations = adapter.prepareMigrations(schema, namespace);\n  await migrations.execute(currentVersion, targetVersion);\n}\n"],"mappings":";;;;;;;;;AAiBA,MAAa,2BAA2B;AACxC,MAAa,+BAA+B;AAO5C,SAAgB,iBAAiB,OAAoD;AACnF,KAAI,iBAAiB,eACnB,QAAO;AAGT,KAAI,OAAO,UAAU,YAAY,UAAU,KACzC,QAAO;AAGT,QACE,4BAA4B,SAC5B,MAAM,8BAA8B;;;;;;AAQxC,IAAa,iBAAb,MAA0E;CACxE;CACA;CACA;CAEA,YAAY,SAAiF;AAC3F,QAAKA,YAAa,QAAQ;AAC1B,QAAKC,SAAU,QAAQ;AACvB,QAAKC,UAAW,QAAQ;;CAG1B,KAAK,4BAA6D;AAChE,SAAO;;CAGT,IAAI,YAAY;AACd,SAAO,MAAKF;;CAGd,IAAI,SAAS;AACX,SAAO,MAAKC;;CAGd,IAAI,UAAuC;AACzC,SAAO,MAAKC;;;;;;;;;;;;;;;;;;;;;;;;;AAiGhB,eAAsB,QAAQ,UAAgE;CAC5F,MAAM,EAAE,SAAS,MAAM,oBAAoB,SAAS;CACpD,MAAM,UAAU,QAAQ;AAGxB,KAAI,CAAC,QAAQ,kBACX,OAAM,IAAI,MACR,0GACD;CAGH,MAAM,SAAS,KAAK;CACpB,MAAM,YAAY,KAAK;CAGvB,MAAM,mBAAmB,gBAAgB;AAEzC,KAAI,CAAC,iBACH,OAAM,IAAI,MAAM,8EAA8E;AAGhG,KAAI,CAAE,MAAM,QAAQ,qBAAqB,CACvC,OAAM,IAAI,MACR,2FACD;CAGH,MAAM,eAAe,iBAAiB,UAAU;CAChD,MAAM,iBAAiB,aAAa;CACpC,MAAM,oBAAoB,aAAa;CAEvC,MAAM,yBAAyB,MAAM,6BACnC,kBACA,kBACD;AAGD,KAAI,yBAAyB,eAAe,QAE1C,OAD2B,QAAQ,kBAAkB,gBAAgB,kBAAkB,CAC9D,QAAQ,wBAAwB,eAAe,QAAQ;CAIlF,MAAM,iBAAiB,MAAM,6BAA6B,kBAAkB,UAAU;CAGtF,MAAM,gBAAgB,OAAO;AAE7B,KAAI,mBAAmB,cACrB;AAGF,KAAI,iBAAiB,cACnB,OAAM,IAAI,MACR,8CAA8C,eAAe,sBAAsB,cAAc,GAClG;AAIH,OADmB,QAAQ,kBAAkB,QAAQ,UAAU,CAC9C,QAAQ,gBAAgB,cAAc"}
+{"version":3,"file":"mod.js","names":["#namespace","#schema","#adapter","internalSchema"],"sources":["../src/mod.ts"],"sourcesContent":["import type { DatabaseAdapter } from \"./adapters/adapters\";\nimport type { AnySchema } from \"./schema/create\";\nimport type { CursorResult } from \"./query/cursor\";\nimport { Cursor } from \"./query/cursor\";\nimport { dbNow, type DbNow } from \"./query/db-now\";\nimport type { FragnoInstantiatedFragment, AnyFragnoInstantiatedFragment } from \"@fragno-dev/core\";\nimport type {\n  FragnoPublicConfigWithDatabase,\n  ImplicitDatabaseDependencies,\n} from \"./db-fragment-definition-builder\";\nimport {\n  getSchemaVersionFromDatabase,\n  type InternalFragmentInstance,\n} from \"./fragments/internal-fragment\";\nimport { resolveDatabaseAdapter } from \"./util/default-database-adapter\";\n\nexport type { DatabaseAdapter, CursorResult };\nexport { Cursor };\nexport { dbNow };\nexport type { DbNow };\nexport { InMemoryAdapter, type InMemoryAdapterOptions } from \"./adapters/in-memory\";\nexport { internalSchema } from \"./fragments/internal-fragment\";\n\nexport const fragnoDatabaseFakeSymbol = \"$fragno-database\" as const;\nexport const fragnoDatabaseLibraryVersion = \"0.1\" as const;\n\nexport interface CreateFragnoDatabaseDefinitionOptions<T extends AnySchema> {\n  namespace: string | null;\n  schema: T;\n}\n\nexport function isFragnoDatabase(value: unknown): value is FragnoDatabase<AnySchema> {\n  if (value instanceof FragnoDatabase) {\n    return true;\n  }\n\n  if (typeof value !== \"object\" || value === null) {\n    return false;\n  }\n\n  return (\n    fragnoDatabaseFakeSymbol in value &&\n    value[fragnoDatabaseFakeSymbol] === fragnoDatabaseFakeSymbol\n  );\n}\n\n/**\n * A Fragno database instance with a bound adapter.\n * Created from a FragnoDatabaseDefinition by calling .create(adapter).\n */\nexport class FragnoDatabase<const T extends AnySchema, TUOWConfig = void> {\n  #namespace: string | null;\n  #schema: T;\n  #adapter: DatabaseAdapter<TUOWConfig>;\n\n  constructor(options: {\n    namespace: string | null;\n    schema: T;\n    adapter: DatabaseAdapter<TUOWConfig>;\n  }) {\n    this.#namespace = options.namespace;\n    this.#schema = options.schema;\n    this.#adapter = options.adapter;\n  }\n\n  get [fragnoDatabaseFakeSymbol](): typeof fragnoDatabaseFakeSymbol {\n    return fragnoDatabaseFakeSymbol;\n  }\n\n  get namespace() {\n    return this.#namespace;\n  }\n\n  get schema() {\n    return this.#schema;\n  }\n\n  get adapter(): DatabaseAdapter<TUOWConfig> {\n    return this.#adapter;\n  }\n}\n\nexport {\n  DatabaseFragmentDefinitionBuilder,\n  type FragnoPublicConfigWithDatabase,\n  type DatabaseFragmentContext,\n  type DatabaseServiceContext,\n  type DatabaseHandlerContext as DatabaseRequestContext,\n  type ImplicitDatabaseDependencies,\n} from \"./db-fragment-definition-builder\";\n\nexport { withDatabase } from \"./with-database\";\n\nexport { decodeCursor, type CursorData } from \"./query/cursor\";\n\nexport {\n  createUnitOfWork,\n  UnitOfWork,\n  TypedUnitOfWork,\n  type IUnitOfWork,\n  type IUnitOfWorkRestricted,\n  type UOWCompiler,\n  type UOWExecutor,\n  type UOWDecoder,\n} from \"./query/unit-of-work/unit-of-work\";\n\nexport {\n  type RetryPolicy,\n  NoRetryPolicy,\n  ExponentialBackoffRetryPolicy,\n  LinearBackoffRetryPolicy,\n} from \"./query/unit-of-work/retry-policy\";\n\nexport {\n  ConcurrencyConflictError,\n  // Builder pattern exports\n  ServiceTxBuilder,\n  HandlerTxBuilder,\n  createServiceTxBuilder,\n  createHandlerTxBuilder,\n  type TxResult,\n  // Builder context types\n  type ServiceBuilderMutateContext,\n  type HandlerBuilderMutateContext,\n  type BuilderTransformContextWithMutate,\n  type BuilderTransformContextWithoutMutate,\n  type ExtractServiceRetrieveResults,\n  type ExtractServiceFinalResults,\n} from \"./query/unit-of-work/execute-unit-of-work\";\n\nexport type { BoundServices } from \"@fragno-dev/core\";\n\nexport { internalFragmentDef } from \"./fragments/internal-fragment\";\nexport type { InternalFragmentInstance } from \"./fragments/internal-fragment\";\nexport type {\n  OutboxConfig,\n  OutboxEntry,\n  OutboxPayload,\n  OutboxMutation,\n  OutboxRefMap,\n} from \"./outbox/outbox\";\n\nexport type {\n  HookContext,\n  HooksMap,\n  HookFn,\n  HookPayload,\n  TriggerHookOptions,\n  DurableHooksProcessingOptions,\n  StuckHookProcessingInfo,\n  StuckHookProcessingEvent,\n  StuckHookProcessingTimeoutMinutes,\n} from \"./hooks/hooks\";\nexport {\n  createDurableHooksProcessor,\n  type DurableHooksProcessor,\n} from \"./hooks/durable-hooks-processor\";\n\nexport type AnyFragnoInstantiatedDatabaseFragment<TSchema extends AnySchema = AnySchema> =\n  FragnoInstantiatedFragment<\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    any,\n    ImplicitDatabaseDependencies<TSchema>,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    any,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    any,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    any,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    any,\n    FragnoPublicConfigWithDatabase,\n    // Ensure the fragment has the internal fragment linked\n    { _fragno_internal: InternalFragmentInstance } & Record<string, AnyFragnoInstantiatedFragment>\n  >;\n\n/**\n * Helper function to run migrations for a database fragment.\n * Extracts the database adapter, schema, and namespace from the fragment and runs migrations.\n * This function:\n * 1. Ensures the internal settings fragment is migrated first\n * 2. Retrieves the current database version from the internal fragment\n * 3. Runs migration from current version to target version\n *\n * @param fragment - The instantiated fragment to run migrations for\n * @throws Error if the fragment doesn't have database support or the adapter doesn't support migrations\n *\n * @example\n * ```typescript\n * const fragment = instantiate(myFragmentDef)\n *   .withConfig({})\n *   .withRoutes([])\n *   .withOptions({ databaseAdapter: myAdapter })\n *   .build();\n *\n * await migrate(fragment);\n * ```\n */\nexport async function migrate<TSchema extends AnySchema>(\n  fragment: AnyFragnoInstantiatedDatabaseFragment<TSchema>,\n): Promise<void> {\n  const { options, deps, linkedFragments } = fragment.$internal;\n  const adapter = resolveDatabaseAdapter(options, deps.schema);\n\n  // Check if adapter supports prepareMigrations\n  if (!adapter.prepareMigrations) {\n    throw new Error(\n      \"Database adapter does not support prepareMigrations. Please use an adapter that implements this method.\",\n    );\n  }\n\n  const schema = deps.schema;\n  const namespace = deps.namespace ?? schema.name;\n\n  // Step 1: Ensure the internal fragment (settings table) is migrated first\n  const internalFragment = linkedFragments._fragno_internal;\n\n  if (!internalFragment) {\n    throw new Error(\"Internal fragment not found. Please ensure the internal fragment is linked.\");\n  }\n\n  if (!(await adapter.isConnectionHealthy())) {\n    throw new Error(\n      \"Database connection is not healthy. Please check your database connection and try again.\",\n    );\n  }\n\n  const internalDeps = internalFragment.$internal.deps;\n  const internalSchema = internalDeps.schema;\n  // Internal fragment uses databaseNamespace: null (no table suffix).\n  // Version tracking uses empty string so the key is \".schema_version\",\n  // which matches both the legacy format and how the internal fragment was designed.\n  const internalNamespace = internalDeps.namespace ?? \"\";\n\n  const internalCurrentVersion = await getSchemaVersionFromDatabase(\n    internalFragment,\n    internalNamespace,\n  );\n\n  // Migrate internal fragment if needed\n  if (internalCurrentVersion < internalSchema.version) {\n    const internalMigrations = adapter.prepareMigrations(internalSchema, internalNamespace);\n    await internalMigrations.execute(internalCurrentVersion, internalSchema.version);\n  }\n\n  // Step 2: Get current database version for this fragment's namespace\n  const currentVersion = await getSchemaVersionFromDatabase(internalFragment, namespace);\n\n  // Step 3: Run the migration from current version to target version\n  const targetVersion = schema.version;\n\n  if (currentVersion === targetVersion) {\n    return;\n  }\n\n  if (currentVersion > targetVersion) {\n    throw new Error(\n      `Cannot migrate backwards: current version (${currentVersion}) > target version (${targetVersion})`,\n    );\n  }\n\n  const migrations = adapter.prepareMigrations(schema, namespace);\n  await migrations.execute(currentVersion, targetVersion);\n}\n"],"mappings":";;;;;;;;;;;;;;;AAuBA,MAAa,2BAA2B;AACxC,MAAa,+BAA+B;AAO5C,SAAgB,iBAAiB,OAAoD;AACnF,KAAI,iBAAiB,eACnB,QAAO;AAGT,KAAI,OAAO,UAAU,YAAY,UAAU,KACzC,QAAO;AAGT,QACE,4BAA4B,SAC5B,MAAM,8BAA8B;;;;;;AAQxC,IAAa,iBAAb,MAA0E;CACxE;CACA;CACA;CAEA,YAAY,SAIT;AACD,QAAKA,YAAa,QAAQ;AAC1B,QAAKC,SAAU,QAAQ;AACvB,QAAKC,UAAW,QAAQ;;CAG1B,KAAK,4BAA6D;AAChE,SAAO;;CAGT,IAAI,YAAY;AACd,SAAO,MAAKF;;CAGd,IAAI,SAAS;AACX,SAAO,MAAKC;;CAGd,IAAI,UAAuC;AACzC,SAAO,MAAKC;;;;;;;;;;;;;;;;;;;;;;;;;AAwHhB,eAAsB,QACpB,UACe;CACf,MAAM,EAAE,SAAS,MAAM,oBAAoB,SAAS;CACpD,MAAM,UAAU,uBAAuB,SAAS,KAAK,OAAO;AAG5D,KAAI,CAAC,QAAQ,kBACX,OAAM,IAAI,MACR,0GACD;CAGH,MAAM,SAAS,KAAK;CACpB,MAAM,YAAY,KAAK,aAAa,OAAO;CAG3C,MAAM,mBAAmB,gBAAgB;AAEzC,KAAI,CAAC,iBACH,OAAM,IAAI,MAAM,8EAA8E;AAGhG,KAAI,CAAE,MAAM,QAAQ,qBAAqB,CACvC,OAAM,IAAI,MACR,2FACD;CAGH,MAAM,eAAe,iBAAiB,UAAU;CAChD,MAAMC,mBAAiB,aAAa;CAIpC,MAAM,oBAAoB,aAAa,aAAa;CAEpD,MAAM,yBAAyB,MAAM,6BACnC,kBACA,kBACD;AAGD,KAAI,yBAAyBA,iBAAe,QAE1C,OAD2B,QAAQ,kBAAkBA,kBAAgB,kBAAkB,CAC9D,QAAQ,wBAAwBA,iBAAe,QAAQ;CAIlF,MAAM,iBAAiB,MAAM,6BAA6B,kBAAkB,UAAU;CAGtF,MAAM,gBAAgB,OAAO;AAE7B,KAAI,mBAAmB,cACrB;AAGF,KAAI,iBAAiB,cACnB,OAAM,IAAI,MACR,8CAA8C,eAAe,sBAAsB,cAAc,GAClG;AAIH,OADmB,QAAQ,kBAAkB,QAAQ,UAAU,CAC9C,QAAQ,gBAAgB,cAAc"}

package/dist/naming/sql-naming.d.ts

@@ -0,0 +1,19 @@
+//#region src/naming/sql-naming.d.ts
+type NamespaceScope = "suffix" | "schema";
+interface SqlNamingStrategy {
+  namespaceScope: NamespaceScope;
+  namespaceToSchema: (namespace: string) => string;
+  tableName: (logicalTable: string, namespace: string | null) => string;
+  columnName: (logicalColumn: string, logicalTable: string) => string;
+  indexName: (logicalIndex: string, logicalTable: string, namespace: string | null) => string;
+  uniqueIndexName: (logicalIndex: string, logicalTable: string, namespace: string | null) => string;
+  foreignKeyName: (params: {
+    logicalTable: string;
+    logicalReferencedTable: string;
+    referenceName: string;
+    namespace: string | null;
+  }) => string;
+}
+//#endregion
+export { SqlNamingStrategy };
+//# sourceMappingURL=sql-naming.d.ts.map

package/dist/naming/sql-naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-naming.d.ts","names":[],"sources":["../../src/naming/sql-naming.ts"],"sourcesContent":[],"mappings":";AAGY,KAAA,cAAA,GAAc,QAAA,GAAA,QAAA;AAET,UAAA,iBAAA,CAAiB;kBAChB"}

package/dist/naming/sql-naming.js

@@ -0,0 +1,116 @@
+import { createHash } from "node:crypto";
+
+//#region src/naming/sql-naming.ts
+const normalizeNamespace = (namespace) => namespace && namespace.length > 0 ? namespace : null;
+const buildNamespaceSuffix = (namespace) => {
+	const sanitized = normalizeNamespace(namespace);
+	return sanitized ? `_${sanitized}` : "";
+};
+const MAX_IDENTIFIER_LENGTH = 63;
+const HASH_LENGTH = 8;
+const withHash = (value) => {
+	return `${value}_${createHash("sha1").update(value).digest("hex").slice(0, 8)}`;
+};
+const truncateWithHash = (value) => {
+	if (value.length <= MAX_IDENTIFIER_LENGTH) return value;
+	const hash = createHash("sha1").update(value).digest("hex").slice(0, HASH_LENGTH);
+	return `${value.slice(0, MAX_IDENTIFIER_LENGTH - HASH_LENGTH)}${hash}`;
+};
+const buildIndexName = (prefix, logicalIndex, logicalTable, namespace) => {
+	return `${prefix}_${withHash(`${logicalTable}_${logicalIndex}${buildNamespaceSuffix(namespace)}`)}`;
+};
+const suffixNamingStrategy = {
+	namespaceScope: "suffix",
+	namespaceToSchema: (namespace) => namespace,
+	tableName: (logicalTable, namespace) => {
+		const sanitized = normalizeNamespace(namespace);
+		return truncateWithHash(sanitized ? `${logicalTable}_${sanitized}` : logicalTable);
+	},
+	columnName: (logicalColumn) => logicalColumn,
+	indexName: (logicalIndex, logicalTable, namespace) => truncateWithHash(buildIndexName("idx", logicalIndex, logicalTable, namespace)),
+	uniqueIndexName: (logicalIndex, logicalTable, namespace) => truncateWithHash(buildIndexName("uidx", logicalIndex, logicalTable, namespace)),
+	foreignKeyName: ({ logicalTable, logicalReferencedTable, referenceName, namespace }) => {
+		return truncateWithHash(`fk_${withHash(`${logicalTable}_${logicalReferencedTable}_${referenceName}${buildNamespaceSuffix(namespace)}`)}`);
+	}
+};
+const schemaNamingStrategy = {
+	namespaceScope: "schema",
+	namespaceToSchema: (namespace) => namespace,
+	tableName: (logicalTable) => truncateWithHash(logicalTable),
+	columnName: (logicalColumn) => logicalColumn,
+	indexName: (logicalIndex) => truncateWithHash(logicalIndex),
+	uniqueIndexName: (logicalIndex) => truncateWithHash(logicalIndex),
+	foreignKeyName: ({ logicalTable, logicalReferencedTable, referenceName }) => truncateWithHash(`fk_${logicalTable}_${logicalReferencedTable}_${referenceName}`)
+};
+var NamingResolver = class {
+	#namespace;
+	#strategy;
+	#tableNameMap = {};
+	#columnNameMaps = /* @__PURE__ */ new Map();
+	constructor(schema, namespace, strategy) {
+		this.#namespace = namespace;
+		this.#strategy = strategy;
+		for (const table of Object.values(schema.tables)) {
+			const physicalTable = this.getTableName(table.name);
+			this.#tableNameMap[physicalTable] = table.name;
+			const columnMap = {};
+			for (const column of Object.values(table.columns)) {
+				const physicalColumn = this.getColumnName(table.name, column.name);
+				columnMap[physicalColumn] = column.name;
+			}
+			this.#columnNameMaps.set(table.name, columnMap);
+		}
+	}
+	get namespace() {
+		return this.#namespace;
+	}
+	get strategy() {
+		return this.#strategy;
+	}
+	getSchemaName() {
+		if (this.#strategy.namespaceScope !== "schema") return null;
+		if (!this.#namespace || this.#namespace.length === 0) return null;
+		return this.#strategy.namespaceToSchema(this.#namespace);
+	}
+	getTableName(logicalTable) {
+		return this.#strategy.tableName(logicalTable, this.#namespace);
+	}
+	getColumnName(logicalTable, logicalColumn) {
+		return this.#strategy.columnName(logicalColumn, logicalTable);
+	}
+	getIndexName(logicalIndex, logicalTable) {
+		return this.#strategy.indexName(logicalIndex, logicalTable, this.#namespace);
+	}
+	getUniqueIndexName(logicalIndex, logicalTable) {
+		return this.#strategy.uniqueIndexName(logicalIndex, logicalTable, this.#namespace);
+	}
+	getForeignKeyName(params) {
+		return this.#strategy.foreignKeyName({
+			...params,
+			namespace: this.#namespace
+		});
+	}
+	getTableNameMap() {
+		return { ...this.#tableNameMap };
+	}
+	getColumnNameMap(table) {
+		const tableName = typeof table === "string" ? table : table.name;
+		const map = this.#columnNameMaps.get(tableName);
+		return map ? { ...map } : {};
+	}
+};
+const createNamingResolver = (schema, namespace, strategy) => new NamingResolver(schema, namespace, strategy);
+/**
+* Sanitizes a namespace for use in SQL identifiers and TypeScript exports.
+* Converts dashes to underscores to ensure compatibility with SQL identifiers.
+*
+* @example
+* sanitizeNamespace("my-fragment") // => "my_fragment"
+*/
+function sanitizeNamespace(namespace) {
+	return namespace.replace(/-/g, "_");
+}
+
+//#endregion
+export { createNamingResolver, sanitizeNamespace, schemaNamingStrategy, suffixNamingStrategy };
+//# sourceMappingURL=sql-naming.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sql-naming.js","names":["suffixNamingStrategy: SqlNamingStrategy","schemaNamingStrategy: SqlNamingStrategy","#namespace","#strategy","#tableNameMap","#columnNameMaps","columnMap: Record<string, string>"],"sources":["../../src/naming/sql-naming.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport type { AnySchema, AnyTable } from \"../schema/create\";\n\nexport type NamespaceScope = \"suffix\" | \"schema\";\n\nexport interface SqlNamingStrategy {\n  namespaceScope: NamespaceScope;\n  namespaceToSchema: (namespace: string) => string;\n\n  tableName: (logicalTable: string, namespace: string | null) => string;\n  columnName: (logicalColumn: string, logicalTable: string) => string;\n\n  indexName: (logicalIndex: string, logicalTable: string, namespace: string | null) => string;\n  uniqueIndexName: (logicalIndex: string, logicalTable: string, namespace: string | null) => string;\n  foreignKeyName: (params: {\n    logicalTable: string;\n    logicalReferencedTable: string;\n    referenceName: string;\n    namespace: string | null;\n  }) => string;\n}\n\nconst normalizeNamespace = (namespace: string | null) =>\n  namespace && namespace.length > 0 ? namespace : null;\n\nconst buildNamespaceSuffix = (namespace: string | null) => {\n  const sanitized = normalizeNamespace(namespace);\n  return sanitized ? `_${sanitized}` : \"\";\n};\n\nconst MAX_IDENTIFIER_LENGTH = 63;\nconst HASH_LENGTH = 8;\n\nconst withHash = (value: string) => {\n  const hash = createHash(\"sha1\").update(value).digest(\"hex\").slice(0, 8);\n  return `${value}_${hash}`;\n};\n\nconst truncateWithHash = (value: string) => {\n  if (value.length <= MAX_IDENTIFIER_LENGTH) {\n    return value;\n  }\n  const hash = createHash(\"sha1\").update(value).digest(\"hex\").slice(0, HASH_LENGTH);\n  return `${value.slice(0, MAX_IDENTIFIER_LENGTH - HASH_LENGTH)}${hash}`;\n};\n\nconst buildIndexName = (\n  prefix: \"idx\" | \"uidx\",\n  logicalIndex: string,\n  logicalTable: string,\n  namespace: string | null,\n) => {\n  const base = `${logicalTable}_${logicalIndex}${buildNamespaceSuffix(namespace)}`;\n  return `${prefix}_${withHash(base)}`;\n};\n\nexport const suffixNamingStrategy: SqlNamingStrategy = {\n  namespaceScope: \"suffix\",\n  namespaceToSchema: (namespace) => namespace,\n  tableName: (logicalTable, namespace) => {\n    const sanitized = normalizeNamespace(namespace);\n    return truncateWithHash(sanitized ? `${logicalTable}_${sanitized}` : logicalTable);\n  },\n  columnName: (logicalColumn) => logicalColumn,\n  indexName: (logicalIndex, logicalTable, namespace) =>\n    truncateWithHash(buildIndexName(\"idx\", logicalIndex, logicalTable, namespace)),\n  uniqueIndexName: (logicalIndex, logicalTable, namespace) =>\n    truncateWithHash(buildIndexName(\"uidx\", logicalIndex, logicalTable, namespace)),\n  foreignKeyName: ({ logicalTable, logicalReferencedTable, referenceName, namespace }) => {\n    const base = `${logicalTable}_${logicalReferencedTable}_${referenceName}${buildNamespaceSuffix(namespace)}`;\n    return truncateWithHash(`fk_${withHash(base)}`);\n  },\n};\n\nexport const schemaNamingStrategy: SqlNamingStrategy = {\n  namespaceScope: \"schema\",\n  namespaceToSchema: (namespace) => namespace,\n  tableName: (logicalTable) => truncateWithHash(logicalTable),\n  columnName: (logicalColumn) => logicalColumn,\n  indexName: (logicalIndex) => truncateWithHash(logicalIndex),\n  uniqueIndexName: (logicalIndex) => truncateWithHash(logicalIndex),\n  foreignKeyName: ({ logicalTable, logicalReferencedTable, referenceName }) =>\n    truncateWithHash(`fk_${logicalTable}_${logicalReferencedTable}_${referenceName}`),\n};\n\nexport class NamingResolver {\n  readonly #namespace: string | null;\n  readonly #strategy: SqlNamingStrategy;\n  readonly #tableNameMap: Record<string, string> = {};\n  readonly #columnNameMaps = new Map<string, Record<string, string>>();\n\n  constructor(schema: AnySchema, namespace: string | null, strategy: SqlNamingStrategy) {\n    this.#namespace = namespace;\n    this.#strategy = strategy;\n\n    for (const table of Object.values(schema.tables)) {\n      const physicalTable = this.getTableName(table.name);\n      this.#tableNameMap[physicalTable] = table.name;\n\n      const columnMap: Record<string, string> = {};\n      for (const column of Object.values(table.columns)) {\n        const physicalColumn = this.getColumnName(table.name, column.name);\n        columnMap[physicalColumn] = column.name;\n      }\n      this.#columnNameMaps.set(table.name, columnMap);\n    }\n  }\n\n  get namespace(): string | null {\n    return this.#namespace;\n  }\n\n  get strategy(): SqlNamingStrategy {\n    return this.#strategy;\n  }\n\n  getSchemaName(): string | null {\n    if (this.#strategy.namespaceScope !== \"schema\") {\n      return null;\n    }\n    if (!this.#namespace || this.#namespace.length === 0) {\n      return null;\n    }\n    return this.#strategy.namespaceToSchema(this.#namespace);\n  }\n\n  getTableName(logicalTable: string): string {\n    return this.#strategy.tableName(logicalTable, this.#namespace);\n  }\n\n  getColumnName(logicalTable: string, logicalColumn: string): string {\n    return this.#strategy.columnName(logicalColumn, logicalTable);\n  }\n\n  getIndexName(logicalIndex: string, logicalTable: string): string {\n    return this.#strategy.indexName(logicalIndex, logicalTable, this.#namespace);\n  }\n\n  getUniqueIndexName(logicalIndex: string, logicalTable: string): string {\n    return this.#strategy.uniqueIndexName(logicalIndex, logicalTable, this.#namespace);\n  }\n\n  getForeignKeyName(params: {\n    logicalTable: string;\n    logicalReferencedTable: string;\n    referenceName: string;\n  }): string {\n    return this.#strategy.foreignKeyName({\n      ...params,\n      namespace: this.#namespace,\n    });\n  }\n\n  getTableNameMap(): Record<string, string> {\n    return { ...this.#tableNameMap };\n  }\n\n  getColumnNameMap(table: AnyTable | string): Record<string, string> {\n    const tableName = typeof table === \"string\" ? table : table.name;\n    const map = this.#columnNameMaps.get(tableName);\n    return map ? { ...map } : {};\n  }\n}\n\nexport const createNamingResolver = (\n  schema: AnySchema,\n  namespace: string | null,\n  strategy: SqlNamingStrategy,\n): NamingResolver => new NamingResolver(schema, namespace, strategy);\n\n/**\n * Sanitizes a namespace for use in SQL identifiers and TypeScript exports.\n * Converts dashes to underscores to ensure compatibility with SQL identifiers.\n *\n * @example\n * sanitizeNamespace(\"my-fragment\") // => \"my_fragment\"\n */\nexport function sanitizeNamespace(namespace: string): string {\n  return namespace.replace(/-/g, \"_\");\n}\n"],"mappings":"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"}

package/dist/node_modules/.pnpm/{rou3@0.7.10 → rou3@0.7.12}/node_modules/rou3/dist/index.js

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/rou3@0.7.10/node_modules/rou3/dist/index.mjs
+//#region ../../node_modules/.pnpm/rou3@0.7.12/node_modules/rou3/dist/index.mjs
 const NullProtoObj = /* @__PURE__ */ (() => {
 	const e = function() {};
 	return e.prototype = Object.create(null), Object.freeze(e.prototype), e;
@@ -19,7 +19,7 @@ function splitPath(path) {
 function getMatchParams(segments, paramsMap) {
 	const params = new NullProtoObj();
 	for (const [index, name] of paramsMap) {
-		const segment = index < 0 ? segments.slice(-1 * index).join("/") : segments[index];
+		const segment = index < 0 ? segments.slice(-(index + 1)).join("/") : segments[index];
 		if (typeof name === "string") params[name] = segment;
 		else {
 			const match = segment.match(name);
@@ -34,18 +34,19 @@ function getMatchParams(segments, paramsMap) {
 function addRoute(ctx, method = "", path, data) {
 	method = method.toUpperCase();
 	if (path.charCodeAt(0) !== 47) path = `/${path}`;
+	path = path.replace(/\\:/g, "%3A");
 	const segments = splitPath(path);
 	let node = ctx.root;
 	let _unnamedParamIndex = 0;
 	const paramsMap = [];
 	const paramsRegexp = [];
 	for (let i = 0; i < segments.length; i++) {
-		const segment = segments[i];
+		let segment = segments[i];
 		if (segment.startsWith("**")) {
 			if (!node.wildcard) node.wildcard = { key: "**" };
 			node = node.wildcard;
 			paramsMap.push([
-				-i,
+				-(i + 1),
 				segment.split(":")[1] || "_",
 				segment.length === 2
 			]);
@@ -75,6 +76,8 @@ function addRoute(ctx, method = "", path, data) {
 			]);
 			continue;
 		}
+		if (segment === "\\*") segment = segments[i] = "*";
+		else if (segment === "\\*\\*") segment = segments[i] = "**";
 		const child = node.static?.[segment];
 		if (child) node = child;
 		else {
@@ -92,7 +95,7 @@ function addRoute(ctx, method = "", path, data) {
 		paramsRegexp,
 		paramsMap: hasParams ? paramsMap : void 0
 	});
-	if (!hasParams) ctx.static[path] = node;
+	if (!hasParams) ctx.static["/" + segments.join("/")] = node;
 }
 function getParamRegexp(segment) {
 	const regex = segment.replace(/:(\w+)/g, (_, id) => `(?<${id}>[^/]+)`).replace(/\./g, "\\.");

package/dist/node_modules/.pnpm/rou3@0.7.12/node_modules/rou3/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../../../../../../node_modules/.pnpm/rou3@0.7.12/node_modules/rou3/dist/index.mjs"],"sourcesContent":["const NullProtoObj = /* @__PURE__ */ (() => {\n\tconst e = function() {};\n\treturn e.prototype = Object.create(null), Object.freeze(e.prototype), e;\n})();\n\n/**\n* Create a new router context.\n*/\nfunction createRouter() {\n\treturn {\n\t\troot: { key: \"\" },\n\t\tstatic: new NullProtoObj()\n\t};\n}\n\nfunction splitPath(path) {\n\tconst [_, ...s] = path.split(\"/\");\n\treturn s[s.length - 1] === \"\" ? s.slice(0, -1) : s;\n}\nfunction getMatchParams(segments, paramsMap) {\n\tconst params = new NullProtoObj();\n\tfor (const [index, name] of paramsMap) {\n\t\tconst segment = index < 0 ? segments.slice(-(index + 1)).join(\"/\") : segments[index];\n\t\tif (typeof name === \"string\") params[name] = segment;\n\t\telse {\n\t\t\tconst match = segment.match(name);\n\t\t\tif (match) for (const key in match.groups) params[key] = match.groups[key];\n\t\t}\n\t}\n\treturn params;\n}\n\n/**\n* Add a route to the router context.\n*/\nfunction addRoute(ctx, method = \"\", path, data) {\n\tmethod = method.toUpperCase();\n\tif (path.charCodeAt(0) !== 47) path = `/${path}`;\n\tpath = path.replace(/\\\\:/g, \"%3A\");\n\tconst segments = splitPath(path);\n\tlet node = ctx.root;\n\tlet _unnamedParamIndex = 0;\n\tconst paramsMap = [];\n\tconst paramsRegexp = [];\n\tfor (let i = 0; i < segments.length; i++) {\n\t\tlet segment = segments[i];\n\t\tif (segment.startsWith(\"**\")) {\n\t\t\tif (!node.wildcard) node.wildcard = { key: \"**\" };\n\t\t\tnode = node.wildcard;\n\t\t\tparamsMap.push([\n\t\t\t\t-(i + 1),\n\t\t\t\tsegment.split(\":\")[1] || \"_\",\n\t\t\t\tsegment.length === 2\n\t\t\t]);\n\t\t\tbreak;\n\t\t}\n\t\tif (segment === \"*\" || segment.includes(\":\")) {\n\t\t\tif (!node.param) node.param = { key: \"*\" };\n\t\t\tnode = node.param;\n\t\t\tif (segment === \"*\") paramsMap.push([\n\t\t\t\ti,\n\t\t\t\t`_${_unnamedParamIndex++}`,\n\t\t\t\ttrue\n\t\t\t]);\n\t\t\telse if (segment.includes(\":\", 1)) {\n\t\t\t\tconst regexp = getParamRegexp(segment);\n\t\t\t\tparamsRegexp[i] = regexp;\n\t\t\t\tnode.hasRegexParam = true;\n\t\t\t\tparamsMap.push([\n\t\t\t\t\ti,\n\t\t\t\t\tregexp,\n\t\t\t\t\tfalse\n\t\t\t\t]);\n\t\t\t} else paramsMap.push([\n\t\t\t\ti,\n\t\t\t\tsegment.slice(1),\n\t\t\t\tfalse\n\t\t\t]);\n\t\t\tcontinue;\n\t\t}\n\t\tif (segment === \"\\\\*\") segment = segments[i] = \"*\";\n\t\telse if (segment === \"\\\\*\\\\*\") segment = segments[i] = \"**\";\n\t\tconst child = node.static?.[segment];\n\t\tif (child) node = child;\n\t\telse {\n\t\t\tconst staticNode = { key: segment };\n\t\t\tif (!node.static) node.static = new NullProtoObj();\n\t\t\tnode.static[segment] = staticNode;\n\t\t\tnode = staticNode;\n\t\t}\n\t}\n\tconst hasParams = paramsMap.length > 0;\n\tif (!node.methods) node.methods = new NullProtoObj();\n\tnode.methods[method] ??= [];\n\tnode.methods[method].push({\n\t\tdata: data || null,\n\t\tparamsRegexp,\n\t\tparamsMap: hasParams ? paramsMap : void 0\n\t});\n\tif (!hasParams) ctx.static[\"/\" + segments.join(\"/\")] = node;\n}\nfunction getParamRegexp(segment) {\n\tconst regex = segment.replace(/:(\\w+)/g, (_, id) => `(?<${id}>[^/]+)`).replace(/\\./g, \"\\\\.\");\n\treturn /* @__PURE__ */ new RegExp(`^${regex}$`);\n}\n\n/**\n* Find a route by path.\n*/\nfunction findRoute(ctx, method = \"\", path, opts) {\n\tif (path.charCodeAt(path.length - 1) === 47) path = path.slice(0, -1);\n\tconst staticNode = ctx.static[path];\n\tif (staticNode && staticNode.methods) {\n\t\tconst staticMatch = staticNode.methods[method] || staticNode.methods[\"\"];\n\t\tif (staticMatch !== void 0) return staticMatch[0];\n\t}\n\tconst segments = splitPath(path);\n\tconst match = _lookupTree(ctx, ctx.root, method, segments, 0)?.[0];\n\tif (match === void 0) return;\n\tif (opts?.params === false) return match;\n\treturn {\n\t\tdata: match.data,\n\t\tparams: match.paramsMap ? getMatchParams(segments, match.paramsMap) : void 0\n\t};\n}\nfunction _lookupTree(ctx, node, method, segments, index) {\n\tif (index === segments.length) {\n\t\tif (node.methods) {\n\t\t\tconst match = node.methods[method] || node.methods[\"\"];\n\t\t\tif (match) return match;\n\t\t}\n\t\tif (node.param && node.param.methods) {\n\t\t\tconst match = node.param.methods[method] || node.param.methods[\"\"];\n\t\t\tif (match) {\n\t\t\t\tconst pMap = match[0].paramsMap;\n\t\t\t\tif (pMap?.[pMap?.length - 1]?.[2]) return match;\n\t\t\t}\n\t\t}\n\t\tif (node.wildcard && node.wildcard.methods) {\n\t\t\tconst match = node.wildcard.methods[method] || node.wildcard.methods[\"\"];\n\t\t\tif (match) {\n\t\t\t\tconst pMap = match[0].paramsMap;\n\t\t\t\tif (pMap?.[pMap?.length - 1]?.[2]) return match;\n\t\t\t}\n\t\t}\n\t\treturn;\n\t}\n\tconst segment = segments[index];\n\tif (node.static) {\n\t\tconst staticChild = node.static[segment];\n\t\tif (staticChild) {\n\t\t\tconst match = _lookupTree(ctx, staticChild, method, segments, index + 1);\n\t\t\tif (match) return match;\n\t\t}\n\t}\n\tif (node.param) {\n\t\tconst match = _lookupTree(ctx, node.param, method, segments, index + 1);\n\t\tif (match) {\n\t\t\tif (node.param.hasRegexParam) {\n\t\t\t\tconst exactMatch = match.find((m) => m.paramsRegexp[index]?.test(segment)) || match.find((m) => !m.paramsRegexp[index]);\n\t\t\t\treturn exactMatch ? [exactMatch] : void 0;\n\t\t\t}\n\t\t\treturn match;\n\t\t}\n\t}\n\tif (node.wildcard && node.wildcard.methods) return node.wildcard.methods[method] || node.wildcard.methods[\"\"];\n}\n\n/**\n* Remove a route from the router context.\n*/\nfunction removeRoute(ctx, method, path) {\n\tconst segments = splitPath(path);\n\treturn _remove(ctx.root, method || \"\", segments, 0);\n}\nfunction _remove(node, method, segments, index) {\n\tif (index === segments.length) {\n\t\tif (node.methods && method in node.methods) {\n\t\t\tdelete node.methods[method];\n\t\t\tif (Object.keys(node.methods).length === 0) node.methods = void 0;\n\t\t}\n\t\treturn;\n\t}\n\tconst segment = segments[index];\n\tif (segment === \"*\") {\n\t\tif (node.param) {\n\t\t\t_remove(node.param, method, segments, index + 1);\n\t\t\tif (_isEmptyNode(node.param)) node.param = void 0;\n\t\t}\n\t\treturn;\n\t}\n\tif (segment.startsWith(\"**\")) {\n\t\tif (node.wildcard) {\n\t\t\t_remove(node.wildcard, method, segments, index + 1);\n\t\t\tif (_isEmptyNode(node.wildcard)) node.wildcard = void 0;\n\t\t}\n\t\treturn;\n\t}\n\tconst childNode = node.static?.[segment];\n\tif (childNode) {\n\t\t_remove(childNode, method, segments, index + 1);\n\t\tif (_isEmptyNode(childNode)) {\n\t\t\tdelete node.static[segment];\n\t\t\tif (Object.keys(node.static).length === 0) node.static = void 0;\n\t\t}\n\t}\n}\nfunction _isEmptyNode(node) {\n\treturn node.methods === void 0 && node.static === void 0 && node.param === void 0 && node.wildcard === void 0;\n}\n\n/**\n* Find all route patterns that match the given path.\n*/\nfunction findAllRoutes(ctx, method = \"\", path, opts) {\n\tif (path.charCodeAt(path.length - 1) === 47) path = path.slice(0, -1);\n\tconst segments = splitPath(path);\n\tconst matches = _findAll(ctx, ctx.root, method, segments, 0);\n\tif (opts?.params === false) return matches;\n\treturn matches.map((m) => {\n\t\treturn {\n\t\t\tdata: m.data,\n\t\t\tparams: m.paramsMap ? getMatchParams(segments, m.paramsMap) : void 0\n\t\t};\n\t});\n}\nfunction _findAll(ctx, node, method, segments, index, matches = []) {\n\tconst segment = segments[index];\n\tif (node.wildcard && node.wildcard.methods) {\n\t\tconst match = node.wildcard.methods[method] || node.wildcard.methods[\"\"];\n\t\tif (match) matches.push(...match);\n\t}\n\tif (node.param) {\n\t\t_findAll(ctx, node.param, method, segments, index + 1, matches);\n\t\tif (index === segments.length && node.param.methods) {\n\t\t\tconst match = node.param.methods[method] || node.param.methods[\"\"];\n\t\t\tif (match) {\n\t\t\t\tconst pMap = match[0].paramsMap;\n\t\t\t\tif (pMap?.[pMap?.length - 1]?.[2]) matches.push(...match);\n\t\t\t}\n\t\t}\n\t}\n\tconst staticChild = node.static?.[segment];\n\tif (staticChild) _findAll(ctx, staticChild, method, segments, index + 1, matches);\n\tif (index === segments.length && node.methods) {\n\t\tconst match = node.methods[method] || node.methods[\"\"];\n\t\tif (match) matches.push(...match);\n\t}\n\treturn matches;\n}\n\nfunction routeToRegExp(route = \"/\") {\n\tconst reSegments = [];\n\tlet idCtr = 0;\n\tfor (const segment of route.split(\"/\")) {\n\t\tif (!segment) continue;\n\t\tif (segment === \"*\") reSegments.push(`(?<_${idCtr++}>[^/]*)`);\n\t\telse if (segment.startsWith(\"**\")) reSegments.push(segment === \"**\" ? \"?(?<_>.*)\" : `?(?<${segment.slice(3)}>.+)`);\n\t\telse if (segment.includes(\":\")) reSegments.push(segment.replace(/:(\\w+)/g, (_, id) => `(?<${id}>[^/]+)`).replace(/\\./g, \"\\\\.\"));\n\t\telse reSegments.push(segment);\n\t}\n\treturn /* @__PURE__ */ new RegExp(`^/${reSegments.join(\"/\")}/?$`);\n}\n\nexport { NullProtoObj, addRoute, createRouter, findAllRoutes, findRoute, removeRoute, routeToRegExp };"],"x_google_ignoreList":[0],"mappings":"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"}

package/dist/outbox/outbox-builder.js

@@ -0,0 +1,156 @@
+import { FragnoId, FragnoReference } from "../schema/create.js";
+import { internalSchema } from "../fragments/internal-fragment.schema.js";
+import { encodeVersionstamp, versionstampToHex } from "./outbox.js";
+
+//#region src/outbox/outbox-builder.ts
+const INTERNAL_TABLE_NAMES = new Set(Object.keys(internalSchema.tables));
+function buildOutboxPlan(operations) {
+	const drafts = [];
+	const lookups = [];
+	for (const op of operations) {
+		if (op.type === "check") continue;
+		if (isInternalMutation(op)) continue;
+		const table = getTable(op.schema, op.table);
+		const schemaName = op.namespace ?? "";
+		const namespace = op.namespace ? op.namespace : void 0;
+		const mutationIndex = drafts.length;
+		if (op.type === "create") {
+			drafts.push({
+				op: "create",
+				schema: schemaName,
+				namespace,
+				table: op.table,
+				externalId: op.generatedExternalId,
+				values: encodeOutboxValues({
+					table,
+					values: op.values,
+					mutationIndex,
+					namespace,
+					lookups
+				})
+			});
+			continue;
+		}
+		if (op.type === "update") {
+			drafts.push({
+				op: "update",
+				schema: schemaName,
+				namespace,
+				table: op.table,
+				externalId: getExternalId(op.id),
+				set: encodeOutboxValues({
+					table,
+					values: op.set,
+					mutationIndex,
+					namespace,
+					lookups
+				}),
+				checkVersion: op.checkVersion && op.id instanceof FragnoId ? op.id.version : void 0
+			});
+			continue;
+		}
+		if (op.type === "delete") drafts.push({
+			op: "delete",
+			schema: schemaName,
+			namespace,
+			table: op.table,
+			externalId: getExternalId(op.id),
+			checkVersion: op.checkVersion && op.id instanceof FragnoId ? op.id.version : void 0
+		});
+	}
+	return {
+		drafts,
+		lookups
+	};
+}
+function finalizeOutboxPayload(plan, transactionVersion) {
+	return {
+		version: 1,
+		mutations: plan.drafts.map((draft, index) => {
+			const versionstamp = versionstampToHex(encodeVersionstamp(transactionVersion, index));
+			return {
+				...draft,
+				versionstamp
+			};
+		})
+	};
+}
+function encodeOutboxValues(options) {
+	const { table, values, mutationIndex, namespace, lookups } = options;
+	const output = {};
+	for (const [key, value] of Object.entries(values)) {
+		if (value === void 0) continue;
+		if (table.columns[key]?.role === "reference") {
+			output[key] = resolveReferenceValue({
+				value,
+				mutationIndex,
+				columnName: key,
+				table,
+				namespace,
+				lookups
+			});
+			continue;
+		}
+		if (value instanceof FragnoId) {
+			output[key] = value.externalId;
+			continue;
+		}
+		output[key] = value;
+	}
+	return output;
+}
+function resolveReferenceValue(options) {
+	const { value, mutationIndex, columnName, table, namespace, lookups } = options;
+	if (value === null) return null;
+	if (value instanceof FragnoId) return value.externalId;
+	if (typeof value === "string") return value;
+	if (value instanceof FragnoReference) return createReferencePlaceholder({
+		internalId: value.internalId,
+		mutationIndex,
+		columnName,
+		table,
+		namespace,
+		lookups
+	});
+	if (typeof value === "bigint" || typeof value === "number") return createReferencePlaceholder({
+		internalId: value,
+		mutationIndex,
+		columnName,
+		table,
+		namespace,
+		lookups
+	});
+	return value;
+}
+function createReferencePlaceholder(options) {
+	const { internalId, mutationIndex, columnName, table, namespace, lookups } = options;
+	const key = `${mutationIndex}.${columnName}`;
+	const referencedTable = resolveReferencedTable(table, columnName);
+	lookups.push({
+		key,
+		internalId,
+		table: referencedTable,
+		namespace
+	});
+	return { __fragno_ref: key };
+}
+function resolveReferencedTable(table, columnName) {
+	for (const relation of Object.values(table.relations)) if (relation.on.some(([localColumn]) => localColumn === columnName)) return relation.table;
+	throw new Error(`Reference column ${columnName} not found in table ${table.name}`);
+}
+function getExternalId(id) {
+	return typeof id === "string" ? id : id.externalId;
+}
+function isInternalMutation(op) {
+	if (op.schema === internalSchema) return true;
+	return op.namespace === "" && INTERNAL_TABLE_NAMES.has(op.table);
+}
+function getTable(schema, tableName) {
+	const table = schema.tables[tableName];
+	if (!table) throw new Error(`Invalid table name ${tableName}.`);
+	return table;
+}
+
+//#endregion
+export { buildOutboxPlan, finalizeOutboxPayload };
+//# sourceMappingURL=outbox-builder.js.map

package/dist/outbox/outbox-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox-builder.js","names":["drafts: OutboxMutationDraft[]","lookups: OutboxRefLookup[]","output: Record<string, unknown>"],"sources":["../../src/outbox/outbox-builder.ts"],"sourcesContent":["import type { MutationOperation } from \"../query/unit-of-work/unit-of-work\";\nimport type { AnySchema, AnyTable } from \"../schema/create\";\nimport { FragnoId, FragnoReference } from \"../schema/create\";\nimport { internalSchema } from \"../fragments/internal-fragment.schema\";\nimport type { OutboxRefLookup, OutboxPayload, OutboxMutation } from \"./outbox\";\nimport { encodeVersionstamp, versionstampToHex } from \"./outbox\";\n\nconst INTERNAL_TABLE_NAMES = new Set(Object.keys(internalSchema.tables));\n\ntype OutboxMutationDraft = OutboxMutation extends infer T\n  ? T extends OutboxMutation\n    ? Omit<T, \"versionstamp\"> & { versionstamp?: string }\n    : never\n  : never;\n\nexport type OutboxPlan = {\n  drafts: OutboxMutationDraft[];\n  lookups: OutboxRefLookup[];\n};\n\nexport function buildOutboxPlan(operations: MutationOperation<AnySchema>[]): OutboxPlan {\n  const drafts: OutboxMutationDraft[] = [];\n  const lookups: OutboxRefLookup[] = [];\n\n  for (const op of operations) {\n    if (op.type === \"check\") {\n      continue;\n    }\n\n    if (isInternalMutation(op)) {\n      continue;\n    }\n\n    const table = getTable(op.schema, op.table);\n    const schemaName = op.namespace ?? \"\";\n    const namespace = op.namespace ? op.namespace : undefined;\n    const mutationIndex = drafts.length;\n\n    if (op.type === \"create\") {\n      drafts.push({\n        op: \"create\",\n        schema: schemaName,\n        namespace,\n        table: op.table,\n        externalId: op.generatedExternalId,\n        values: encodeOutboxValues({\n          table,\n          values: op.values,\n          mutationIndex,\n          namespace,\n          lookups,\n        }),\n      });\n      continue;\n    }\n\n    if (op.type === \"update\") {\n      drafts.push({\n        op: \"update\",\n        schema: schemaName,\n        namespace,\n        table: op.table,\n        externalId: getExternalId(op.id),\n        set: encodeOutboxValues({\n          table,\n          values: op.set,\n          mutationIndex,\n          namespace,\n          lookups,\n        }),\n        checkVersion: op.checkVersion && op.id instanceof FragnoId ? op.id.version : undefined,\n      });\n      continue;\n    }\n\n    if (op.type === \"delete\") {\n      drafts.push({\n        op: \"delete\",\n        schema: schemaName,\n        namespace,\n        table: op.table,\n        externalId: getExternalId(op.id),\n        checkVersion: op.checkVersion && op.id instanceof FragnoId ? op.id.version : undefined,\n      });\n    }\n  }\n\n  return { drafts, lookups };\n}\n\nexport function finalizeOutboxPayload(plan: OutboxPlan, transactionVersion: bigint): OutboxPayload {\n  const mutations: OutboxMutation[] = plan.drafts.map((draft, index) => {\n    const versionstamp = versionstampToHex(encodeVersionstamp(transactionVersion, index));\n    return { ...draft, versionstamp } as OutboxMutation;\n  });\n\n  return {\n    version: 1,\n    mutations,\n  };\n}\n\nfunction encodeOutboxValues(options: {\n  table: AnyTable;\n  values: Record<string, unknown>;\n  mutationIndex: number;\n  namespace?: string;\n  lookups: OutboxRefLookup[];\n}): Record<string, unknown> {\n  const { table, values, mutationIndex, namespace, lookups } = options;\n  const output: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(values)) {\n    if (value === undefined) {\n      continue;\n    }\n\n    const column = table.columns[key];\n\n    if (column?.role === \"reference\") {\n      const resolved = resolveReferenceValue({\n        value,\n        mutationIndex,\n        columnName: key,\n        table,\n        namespace,\n        lookups,\n      });\n      output[key] = resolved;\n      continue;\n    }\n\n    if (value instanceof FragnoId) {\n      output[key] = value.externalId;\n      continue;\n    }\n\n    output[key] = value;\n  }\n\n  return output;\n}\n\nfunction resolveReferenceValue(options: {\n  value: unknown;\n  mutationIndex: number;\n  columnName: string;\n  table: AnyTable;\n  namespace?: string;\n  lookups: OutboxRefLookup[];\n}): unknown {\n  const { value, mutationIndex, columnName, table, namespace, lookups } = options;\n\n  if (value === null) {\n    return null;\n  }\n\n  if (value instanceof FragnoId) {\n    return value.externalId;\n  }\n\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  if (value instanceof FragnoReference) {\n    return createReferencePlaceholder({\n      internalId: value.internalId,\n      mutationIndex,\n      columnName,\n      table,\n      namespace,\n      lookups,\n    });\n  }\n\n  if (typeof value === \"bigint\" || typeof value === \"number\") {\n    return createReferencePlaceholder({\n      internalId: value,\n      mutationIndex,\n      columnName,\n      table,\n      namespace,\n      lookups,\n    });\n  }\n\n  return value;\n}\n\nfunction createReferencePlaceholder(options: {\n  internalId: bigint | number;\n  mutationIndex: number;\n  columnName: string;\n  table: AnyTable;\n  namespace?: string;\n  lookups: OutboxRefLookup[];\n}): { __fragno_ref: string } {\n  const { internalId, mutationIndex, columnName, table, namespace, lookups } = options;\n  const key = `${mutationIndex}.${columnName}`;\n  const referencedTable = resolveReferencedTable(table, columnName);\n\n  lookups.push({\n    key,\n    internalId,\n    table: referencedTable,\n    namespace,\n  });\n\n  return { __fragno_ref: key };\n}\n\nfunction resolveReferencedTable(table: AnyTable, columnName: string): AnyTable {\n  for (const relation of Object.values(table.relations)) {\n    if (relation.on.some(([localColumn]) => localColumn === columnName)) {\n      return relation.table;\n    }\n  }\n\n  throw new Error(`Reference column ${columnName} not found in table ${table.name}`);\n}\n\nfunction getExternalId(id: FragnoId | string): string {\n  return typeof id === \"string\" ? id : id.externalId;\n}\n\nfunction isInternalMutation(op: MutationOperation<AnySchema>): boolean {\n  if (op.schema === internalSchema) {\n    return true;\n  }\n\n  return op.namespace === \"\" && INTERNAL_TABLE_NAMES.has(op.table);\n}\n\nfunction getTable(schema: AnySchema, tableName: string): AnyTable {\n  const table = schema.tables[tableName];\n  if (!table) {\n    throw new Error(`Invalid table name ${tableName}.`);\n  }\n  return table;\n}\n"],"mappings":"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"}