@fragno-dev/db 0.3.0 → 0.4.1

package/dist/migration-engine/shared.d.ts

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

package/dist/migration-engine/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","names":[],"sources":["../../src/migration-engine/shared.ts"],"sourcesContent":[],"mappings":";UAAiB,cAAA;EAAA,IAAA,EAAA,MAAA;EAWA,OAAA,EAAA,MAAA,EAAA;EAYA,eAAU,EAAA,MAAA;EA+Bf,iBAAA,EAAA,MAAkB,EAAA;;;;;;AAST,UApDJ,0BAAA,CAoDI;EAOA,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;;UA/CJ,UAAA;;;;;;;;;;;;;KA+BL,iCACI,6BAA6B,+BAExC;aAA8B;;;;SAKtB;;aACQ;;;;;;;aAOA;;;;;;aAKA;;;;;;;;aAOA;MAChB;aAA+B;;KAExB,eAAA;;IAER;KAEQ,cAAA;;;WAIG;;;;;;;SASF;;;;;;KAQD,eAAA;;;;;;;;;;;;SAeC;;;;;;;;;;;;;;;SAgBA"}

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      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"}
+{"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 interface SqliteRecreateTableInfo {\n  columns: ColumnInfo[];\n  copyColumns: SqliteCopyColumn[];\n  indexes: { name: string; columns: string[]; unique: boolean }[];\n  foreignKeys: ForeignKeyInfo[];\n}\n\nexport type SqliteCopyColumn = string | { from: string; to: string };\n\nexport interface SqliteAlterTableMetadata extends MigrationOperationMetadata {\n  recreateTable?: SqliteRecreateTableInfo;\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":";AAoJA,SAAgB,UAAU,IAAkE;AAC1F,QAAO,GAAG,kBAAkB,GAAG,iBAAiB,GAAG"}

package/dist/mod.d.ts

@@ -1,21 +1,24 @@
-import { DbNow, dbNow } from "./query/db-now.js";
+import { DbInterval, DbIntervalInput, DbNow, dbInterval, 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, DatabaseServiceContext, FragnoPublicConfigWithDatabase, ImplicitDatabaseDependencies } from "./db-fragment-definition-builder.js";
+import { BuilderTransformContextWithMutate, BuilderTransformContextWithoutMutate, ConcurrencyConflictError, ExtractServiceFinalResults, ExtractServiceRetrieveResults, HandlerBuilderMutateContext, HandlerTxBuilder, HandlerTxContext, ServiceBuilderMutateContext, ServiceTxBuilder, TxResult, createHandlerTxBuilder, createServiceTxBuilder, serviceCalls } from "./query/unit-of-work/execute-unit-of-work.js";
+import { OutboxConfig, OutboxEntry, OutboxMutation, OutboxPayload, OutboxRefMap } from "./outbox/outbox.js";
+import { SubmitAppliedResponse, SubmitConflictReason, SubmitConflictResponse, SubmitRequest, SubmitResponse, SyncCommandDefinition, SyncCommandHandler, SyncCommandRegistry, SyncCommandTxFactory } from "./sync/types.js";
+import { DatabaseFragmentContext, DatabaseFragmentDefinitionBuilder, DatabaseHandlerContext, DatabaseServiceContext, DbRoundtripGuardConfig, 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 { getInternalFragment } from "./internal/adapter-registry.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 { defineSyncCommands } from "./sync/commands.js";
+import { DurableHookRecord, DurableHookStatus, DurableHooksAccessor, DurableHooksService, getDurableHooksService } from "./durable-hooks.js";
 import { internalSchema } from "./fragments/internal-fragment.schema.js";
 import { InternalFragmentInstance, internalFragmentDef } from "./fragments/internal-fragment.js";
-import { DurableHooksProcessingOptions, HookContext, HookFn, HookPayload, HooksMap, StuckHookProcessingEvent, StuckHookProcessingInfo, StuckHookProcessingTimeoutMinutes, TriggerHookOptions } from "./hooks/hooks.js";
+import { DurableHooksProcessingOptions, HookContext, HookFn, HookHandlerTx, 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";
+import { BoundServices, FragnoInstantiatedFragment } from "@fragno-dev/core";
 
 //#region src/mod.d.ts
 declare const fragnoDatabaseFakeSymbol: "$fragno-database";
@@ -41,9 +44,7 @@ declare class FragnoDatabase<const T extends AnySchema, TUOWConfig = void> {
   get schema(): T;
   get adapter(): DatabaseAdapter<TUOWConfig>;
 }
-type AnyFragnoInstantiatedDatabaseFragment<TSchema extends AnySchema = AnySchema> = FragnoInstantiatedFragment<any, ImplicitDatabaseDependencies<TSchema>, any, any, any, any, FragnoPublicConfigWithDatabase, {
-  _fragno_internal: InternalFragmentInstance;
-} & Record<string, AnyFragnoInstantiatedFragment>>;
+type AnyFragnoInstantiatedDatabaseFragment<TSchema extends AnySchema = AnySchema> = FragnoInstantiatedFragment<any, ImplicitDatabaseDependencies<TSchema>, any, any, DatabaseHandlerContext, any, FragnoPublicConfigWithDatabase>;
 /**
  * Helper function to run migrations for a database fragment.
  * Extracts the database adapter, schema, and namespace from the fragment and runs migrations.
@@ -68,5 +69,5 @@ type AnyFragnoInstantiatedDatabaseFragment<TSchema extends AnySchema = AnySchema
  */
 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, 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 };
+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 DbInterval, type DbIntervalInput, type DbNow, type DbRoundtripGuardConfig, type DurableHookRecord, type DurableHookStatus, type DurableHooksAccessor, type DurableHooksProcessingOptions, type DurableHooksService, ExponentialBackoffRetryPolicy, type ExtractServiceFinalResults, type ExtractServiceRetrieveResults, FragnoDatabase, type FragnoPublicConfigWithDatabase, type HandlerBuilderMutateContext, HandlerTxBuilder, type HandlerTxContext, type HookContext, type HookFn, type HookHandlerTx, 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 SubmitAppliedResponse, type SubmitConflictReason, type SubmitConflictResponse, type SubmitRequest, type SubmitResponse, type SyncCommandDefinition, type SyncCommandHandler, type SyncCommandRegistry, type SyncCommandTxFactory, type TriggerHookOptions, type TxResult, TypedUnitOfWork, type UOWCompiler, type UOWDecoder, type UOWExecutor, UnitOfWork, createHandlerTxBuilder, createServiceTxBuilder, createUnitOfWork, dbInterval, dbNow, decodeCursor, defineSyncCommands, fragnoDatabaseFakeSymbol, fragnoDatabaseLibraryVersion, getDurableHooksService, getInternalFragment, internalFragmentDef, internalSchema, isFragnoDatabase, migrate, serviceCalls, 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":";;;;;;;;;;;;;;;;;;;;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"}
+{"version":3,"file":"mod.d.ts","names":[],"sources":["../src/mod.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;cA6Ba;cACA;UAEI,gDAAgD;;UAEvD;;iBAGM,gBAAA,2BAA2C,eAAe;;;AAR1E;AACA;AAEiB,cAwBJ,cAxBI,CAAA,gBAwB2B,SAxBqB,EAAA,aAEtD,IAAA,CAAA,CAAA;EAGK,CAAA,OAAA;EAmBH,WAAA,CAAA,OAAc,EAAA;IAAiB,SAAA,EAAA,MAAA,GAAA,IAAA;IAOhC,MAAA,EAAA,CAAA;IACiB,OAAA,EAAhB,eAAgB,CAAA,UAAA,CAAA;EAAhB,CAAA;EAO8B,KAApC,wBAAA,GAAoC,EAAA,OAAA,wBAAA;EAApC,IAAA,SAAA,CAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAQK,IAAA,MAAA,CAAA,CAAA,EAAA,CAAA;EAIqB,IAAA,OAAA,CAAA,CAAA,EAAhB,eAAgB,CAAA,UAAA,CAAA;;AA2IvB,KAvCE,qCAuCF,CAAA,gBAvCwD,SAuCxD,GAvCoE,SAuCpE,CAAA,GAtCR,0BAsCQ,CAAA,GAAA,EAnCN,4BAmCM,CAnCuB,OAmCvB,CAAA,EAAA,GAAA,EAAA,GAAA,EA9BN,sBA8BM,EAAA,GAAA,EA3BN,8BA2BM,CAAA;;;;;;;;;;;;;;;;;;;;;;;iBAFY,wBAAwB,qBAClC,sCAAsC,WAC/C"}

package/dist/mod.js

@@ -1,16 +1,17 @@
+import { dbInterval, dbNow } from "./query/db-now.js";
 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 { internalSchema } from "./fragments/internal-fragment.schema.js";
+import { ConcurrencyConflictError, HandlerTxBuilder, ServiceTxBuilder, createHandlerTxBuilder, createServiceTxBuilder, serviceCalls } from "./query/unit-of-work/execute-unit-of-work.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 { internalSchema } from "./fragments/internal-fragment.schema.js";
 import { DatabaseFragmentDefinitionBuilder } from "./db-fragment-definition-builder.js";
 import { getSchemaVersionFromDatabase, internalFragmentDef } from "./fragments/internal-fragment.js";
+import { getInternalFragment } from "./internal/adapter-registry.js";
+import { getDurableHooksService } from "./durable-hooks.js";
 import { InMemoryAdapter } from "./adapters/in-memory/in-memory-adapter.js";
 import "./adapters/in-memory/index.js";
 import { withDatabase } from "./with-database.js";
-import { createDurableHooksProcessor } from "./hooks/durable-hooks-processor.js";
+import { defineSyncCommands } from "./sync/commands.js";
 
 //#region src/mod.ts
 const fragnoDatabaseFakeSymbol = "$fragno-database";
@@ -69,13 +70,12 @@ var FragnoDatabase = class {
 * ```
 */
 async function migrate(fragment) {
-	const { options, deps, linkedFragments } = fragment.$internal;
-	const adapter = resolveDatabaseAdapter(options, deps.schema);
+	const { deps } = fragment.$internal;
+	const adapter = deps.databaseAdapter;
 	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 ?? schema.name;
-	const internalFragment = linkedFragments._fragno_internal;
-	if (!internalFragment) throw new Error("Internal fragment not found. Please ensure the internal fragment is linked.");
+	const internalFragment = getInternalFragment(adapter);
 	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$1 = internalDeps.schema;
@@ -90,5 +90,5 @@ async function migrate(fragment) {
 }
 
 //#endregion
-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 };
+export { ConcurrencyConflictError, Cursor, DatabaseFragmentDefinitionBuilder, ExponentialBackoffRetryPolicy, FragnoDatabase, HandlerTxBuilder, InMemoryAdapter, LinearBackoffRetryPolicy, NoRetryPolicy, ServiceTxBuilder, TypedUnitOfWork, UnitOfWork, createHandlerTxBuilder, createServiceTxBuilder, createUnitOfWork, dbInterval, dbNow, decodeCursor, defineSyncCommands, fragnoDatabaseFakeSymbol, fragnoDatabaseLibraryVersion, getDurableHooksService, getInternalFragment, internalFragmentDef, internalSchema, isFragnoDatabase, migrate, serviceCalls, withDatabase };
 //# sourceMappingURL=mod.js.map

package/dist/mod.js.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"mod.js","names":["#namespace","#schema","#adapter","internalSchema"],"sources":["../src/mod.ts"],"sourcesContent":["import type { FragnoInstantiatedFragment } from \"@fragno-dev/core\";\n\nimport type { DatabaseAdapter } from \"./adapters/adapters\";\nimport type {\n  FragnoPublicConfigWithDatabase,\n  ImplicitDatabaseDependencies,\n  DatabaseHandlerContext,\n} from \"./db-fragment-definition-builder\";\nimport { getSchemaVersionFromDatabase } from \"./fragments/internal-fragment\";\nimport { getInternalFragment } from \"./internal/adapter-registry\";\nimport type { CursorResult } from \"./query/cursor\";\nimport { Cursor } from \"./query/cursor\";\nimport {\n  dbInterval,\n  dbNow,\n  type DbInterval,\n  type DbIntervalInput,\n  type DbNow,\n} from \"./query/db-now\";\nimport type { AnySchema } from \"./schema/create\";\n\nexport type { DatabaseAdapter, CursorResult };\nexport { Cursor };\nexport { dbNow, dbInterval };\nexport type { DbNow, DbInterval, DbIntervalInput };\nexport { InMemoryAdapter, type InMemoryAdapterOptions } from \"./adapters/in-memory\";\nexport { internalSchema } from \"./fragments/internal-fragment\";\nexport { getInternalFragment } from \"./internal/adapter-registry\";\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 DbRoundtripGuardConfig,\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  serviceCalls,\n  type TxResult,\n  // Builder context types\n  type HandlerTxContext,\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  HookHandlerTx,\n  HookPayload,\n  TriggerHookOptions,\n  DurableHooksProcessingOptions,\n  StuckHookProcessingInfo,\n  StuckHookProcessingEvent,\n  StuckHookProcessingTimeoutMinutes,\n} from \"./hooks/hooks\";\nexport { defineSyncCommands } from \"./sync/commands\";\nexport type {\n  DurableHookRecord,\n  DurableHookStatus,\n  DurableHooksAccessor,\n  DurableHooksService,\n} from \"./durable-hooks\";\nexport { getDurableHooksService } from \"./durable-hooks\";\nexport type {\n  SubmitAppliedResponse,\n  SubmitConflictReason,\n  SubmitConflictResponse,\n  SubmitRequest,\n  SubmitResponse,\n  SyncCommandDefinition,\n  SyncCommandHandler,\n  SyncCommandRegistry,\n  SyncCommandTxFactory,\n} from \"./sync/types\";\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    DatabaseHandlerContext,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    any,\n    FragnoPublicConfigWithDatabase\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 { deps } = fragment.$internal;\n  const adapter = deps.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 ?? schema.name;\n\n  // Step 1: Ensure the internal fragment (settings table) is migrated first\n  const internalFragment = getInternalFragment(adapter);\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":";;;;;;;;;;;;;;;;AA6BA,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;;;;;;;;;;;;;;;;;;;;;;;;;AAwIhB,eAAsB,QACpB,UACe;CACf,MAAM,EAAE,SAAS,SAAS;CAC1B,MAAM,UAAU,KAAK;AAGrB,KAAI,CAAC,QAAQ,kBACX,OAAM,IAAI,MACR,0GACD;CAGH,MAAM,SAAS,KAAK;CACpB,MAAM,YAAY,KAAK,aAAa,OAAO;CAG3C,MAAM,mBAAmB,oBAAoB,QAAQ;AAErD,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.map

@@ -1 +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"}
+{"version":3,"file":"sql-naming.d.ts","names":[],"sources":["../../src/naming/sql-naming.ts"],"sourcesContent":[],"mappings":";AAIY,KAAA,cAAA,GAAc,QAAA,GAAA,QAAA;AAET,UAAA,iBAAA,CAAiB;kBAChB"}

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

@@ -1 +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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"}
+{"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\";\n\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/outbox/outbox-builder.js.map

@@ -1 +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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"}
+{"version":3,"file":"outbox-builder.js","names":["drafts: OutboxMutationDraft[]","lookups: OutboxRefLookup[]","output: Record<string, unknown>"],"sources":["../../src/outbox/outbox-builder.ts"],"sourcesContent":["import { internalSchema } from \"../fragments/internal-fragment.schema\";\nimport type { MutationOperation } from \"../query/unit-of-work/unit-of-work\";\nimport type { AnySchema, AnyTable } from \"../schema/create\";\nimport { FragnoId, FragnoReference } from \"../schema/create\";\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 };\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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"}

package/dist/outbox/outbox.d.ts

@@ -1,8 +1,10 @@
-import { FragnoId } from "../schema/create.js";
+import { AnySchema, FragnoId } from "../schema/create.js";
+import { MutationOperation } from "../query/unit-of-work/unit-of-work.js";
 
 //#region src/outbox/outbox.d.ts
 type OutboxConfig = {
   enabled: boolean;
+  shouldInclude?: (operation: MutationOperation<AnySchema>) => boolean;
 };
 type OutboxPayload = {
   version: 1;

package/dist/outbox/outbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"outbox.d.ts","names":[],"sources":["../../src/outbox/outbox.ts"],"sourcesContent":[],"mappings":";;;KAEY,YAAA;;AAAZ,CAAA;AAcY,KALA,aAAA,GAKc;EA8Bd,OAAA,EAAA,CAAA;EAEA,SAAA,EAnCC,cAmCD,EAAuB;AAKnC,CAAA;AACM,KAtCM,cAAA,GAsCN;EAGK,EAAA,EAAA,QAAA;EACA,MAAA,EAAA,MAAA;EACE,SAAA,CAAA,EAAA,MAAA;EAAI,KAAA,EAAA,MAAA;;;UAnCH;;;;;;;;OASH;;;;;;;;;;;KAaC,YAAA,GAAe;KAEf,uBAAA;;SAEH;;KAGG,WAAA;MACN;;;WAGK;WACA;aACE"}
+{"version":3,"file":"outbox.d.ts","names":[],"sources":["../../src/outbox/outbox.ts"],"sourcesContent":[],"mappings":";;;;KAGY,YAAA;;EAAA,aAAA,CAAA,EAAY,CAAA,SAAA,EAEM,iBAAA,CAAkB,SAAlB,CAAA,EAAiB,GAAA,OAAA;AAQ/C,CAAA;AAmCY,KAnCA,aAAA,GAmCY;EAEZ,OAAA,EAAA,CAAA;EAKA,SAAA,EAxCC,cAwCU,EAAA;CACjB;AAGK,KAzCC,cAAA,GAyCD;EACA,EAAA,EAAA,QAAA;EACE,MAAA,EAAA,MAAA;EAAI,SAAA,CAAA,EAAA,MAAA;;;;UAnCH;;;;;;;;OASH;;;;;;;;;;;KAaC,YAAA,GAAe;KAEf,uBAAA;;SAEH;;KAGG,WAAA;MACN;;;WAGK;WACA;aACE"}

package/dist/outbox/outbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"outbox.js","names":[],"sources":["../../src/outbox/outbox.ts"],"sourcesContent":["import type { AnyTable, FragnoId } from \"../schema/create\";\n\nexport type OutboxConfig = {\n  enabled: boolean;\n};\n\nexport type OutboxVersionstampStrategy =\n  | \"update-returning\"\n  | \"insert-on-conflict-returning\"\n  | \"insert-on-duplicate-last-insert-id\";\n\nexport type OutboxPayload = {\n  version: 1;\n  mutations: OutboxMutation[];\n};\n\nexport type OutboxMutation =\n  | {\n      op: \"create\";\n      schema: string;\n      namespace?: string;\n      table: string;\n      externalId: string;\n      versionstamp: string;\n      values: Record<string, unknown>;\n    }\n  | {\n      op: \"update\";\n      schema: string;\n      namespace?: string;\n      table: string;\n      externalId: string;\n      versionstamp: string;\n      set: Record<string, unknown>;\n      checkVersion?: number;\n    }\n  | {\n      op: \"delete\";\n      schema: string;\n      namespace?: string;\n      table: string;\n      externalId: string;\n      versionstamp: string;\n      checkVersion?: number;\n    };\n\nexport type OutboxRefMap = Record<string, string>;\n\nexport type OutboxPayloadSerialized = {\n  json: unknown;\n  meta?: Record<string, unknown>;\n};\n\nexport type OutboxEntry = {\n  id: FragnoId;\n  versionstamp: string;\n  uowId: string;\n  payload: OutboxPayloadSerialized;\n  refMap?: OutboxRefMap;\n  createdAt: Date;\n};\n\nexport type OutboxRefLookup = {\n  key: string;\n  internalId: bigint | number;\n  table: AnyTable;\n  namespace?: string;\n};\n\nexport function encodeVersionstamp(transactionVersion: bigint, userVersion: number): Uint8Array {\n  if (userVersion < 0 || userVersion > 0xffff) {\n    throw new Error(`Invalid outbox user version: ${userVersion}`);\n  }\n\n  const txBytes = bigintToBytes(transactionVersion, 10);\n  const userBytes = new Uint8Array(2);\n  userBytes[0] = (userVersion >> 8) & 0xff;\n  userBytes[1] = userVersion & 0xff;\n\n  const combined = new Uint8Array(12);\n  combined.set(txBytes, 0);\n  combined.set(userBytes, 10);\n\n  return combined;\n}\n\nexport function versionstampToHex(bytes: Uint8Array): string {\n  let hex = \"\";\n  for (const byte of bytes) {\n    hex += byte.toString(16).padStart(2, \"0\");\n  }\n  return hex;\n}\n\nexport function hexToVersionstamp(hex: string): Uint8Array {\n  if (hex.length % 2 !== 0) {\n    throw new Error(`Invalid versionstamp hex length: ${hex.length}`);\n  }\n\n  const bytes = new Uint8Array(hex.length / 2);\n  for (let i = 0; i < hex.length; i += 2) {\n    bytes[i / 2] = Number.parseInt(hex.slice(i, i + 2), 16);\n  }\n  return bytes;\n}\n\nexport function parseOutboxVersionValue(value: unknown): bigint {\n  if (typeof value === \"bigint\") {\n    return value;\n  }\n\n  if (typeof value === \"number\") {\n    return BigInt(value);\n  }\n\n  if (typeof value === \"string\") {\n    return BigInt(value);\n  }\n\n  throw new Error(`Invalid outbox version value: ${String(value)}`);\n}\n\nfunction bigintToBytes(value: bigint, length: number): Uint8Array {\n  const bytes = new Uint8Array(length);\n  let remaining = value;\n\n  for (let i = length - 1; i >= 0; i -= 1) {\n    bytes[i] = Number(remaining & 0xffn);\n    remaining >>= 8n;\n  }\n\n  if (remaining !== 0n) {\n    throw new Error(`Outbox version ${value} exceeds ${length * 8} bits`);\n  }\n\n  return bytes;\n}\n"],"mappings":";AAqEA,SAAgB,mBAAmB,oBAA4B,aAAiC;AAC9F,KAAI,cAAc,KAAK,cAAc,MACnC,OAAM,IAAI,MAAM,gCAAgC,cAAc;CAGhE,MAAM,UAAU,cAAc,oBAAoB,GAAG;CACrD,MAAM,YAAY,IAAI,WAAW,EAAE;AACnC,WAAU,KAAM,eAAe,IAAK;AACpC,WAAU,KAAK,cAAc;CAE7B,MAAM,WAAW,IAAI,WAAW,GAAG;AACnC,UAAS,IAAI,SAAS,EAAE;AACxB,UAAS,IAAI,WAAW,GAAG;AAE3B,QAAO;;AAGT,SAAgB,kBAAkB,OAA2B;CAC3D,IAAI,MAAM;AACV,MAAK,MAAM,QAAQ,MACjB,QAAO,KAAK,SAAS,GAAG,CAAC,SAAS,GAAG,IAAI;AAE3C,QAAO;;AAeT,SAAgB,wBAAwB,OAAwB;AAC9D,KAAI,OAAO,UAAU,SACnB,QAAO;AAGT,KAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;AAGtB,KAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;AAGtB,OAAM,IAAI,MAAM,iCAAiC,OAAO,MAAM,GAAG;;AAGnE,SAAS,cAAc,OAAe,QAA4B;CAChE,MAAM,QAAQ,IAAI,WAAW,OAAO;CACpC,IAAI,YAAY;AAEhB,MAAK,IAAI,IAAI,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG;AACvC,QAAM,KAAK,OAAO,YAAY,KAAM;AACpC,gBAAc;;AAGhB,KAAI,cAAc,GAChB,OAAM,IAAI,MAAM,kBAAkB,MAAM,WAAW,SAAS,EAAE,OAAO;AAGvE,QAAO"}
+{"version":3,"file":"outbox.js","names":[],"sources":["../../src/outbox/outbox.ts"],"sourcesContent":["import type { MutationOperation } from \"../query/unit-of-work/unit-of-work\";\nimport type { AnySchema, AnyTable, FragnoId } from \"../schema/create\";\n\nexport type OutboxConfig = {\n  enabled: boolean;\n  shouldInclude?: (operation: MutationOperation<AnySchema>) => boolean;\n};\n\nexport type OutboxVersionstampStrategy =\n  | \"update-returning\"\n  | \"insert-on-conflict-returning\"\n  | \"insert-on-duplicate-last-insert-id\";\n\nexport type OutboxPayload = {\n  version: 1;\n  mutations: OutboxMutation[];\n};\n\nexport type OutboxMutation =\n  | {\n      op: \"create\";\n      schema: string;\n      namespace?: string;\n      table: string;\n      externalId: string;\n      versionstamp: string;\n      values: Record<string, unknown>;\n    }\n  | {\n      op: \"update\";\n      schema: string;\n      namespace?: string;\n      table: string;\n      externalId: string;\n      versionstamp: string;\n      set: Record<string, unknown>;\n      checkVersion?: number;\n    }\n  | {\n      op: \"delete\";\n      schema: string;\n      namespace?: string;\n      table: string;\n      externalId: string;\n      versionstamp: string;\n      checkVersion?: number;\n    };\n\nexport type OutboxRefMap = Record<string, string>;\n\nexport type OutboxPayloadSerialized = {\n  json: unknown;\n  meta?: Record<string, unknown>;\n};\n\nexport type OutboxEntry = {\n  id: FragnoId;\n  versionstamp: string;\n  uowId: string;\n  payload: OutboxPayloadSerialized;\n  refMap?: OutboxRefMap;\n  createdAt: Date;\n};\n\nexport type OutboxRefLookup = {\n  key: string;\n  internalId: bigint | number;\n  table: AnyTable;\n  namespace?: string;\n};\n\nexport function encodeVersionstamp(transactionVersion: bigint, userVersion: number): Uint8Array {\n  if (userVersion < 0 || userVersion > 0xffff) {\n    throw new Error(`Invalid outbox user version: ${userVersion}`);\n  }\n\n  const txBytes = bigintToBytes(transactionVersion, 10);\n  const userBytes = new Uint8Array(2);\n  userBytes[0] = (userVersion >> 8) & 0xff;\n  userBytes[1] = userVersion & 0xff;\n\n  const combined = new Uint8Array(12);\n  combined.set(txBytes, 0);\n  combined.set(userBytes, 10);\n\n  return combined;\n}\n\nexport function versionstampToHex(bytes: Uint8Array): string {\n  let hex = \"\";\n  for (const byte of bytes) {\n    hex += byte.toString(16).padStart(2, \"0\");\n  }\n  return hex;\n}\n\nexport function hexToVersionstamp(hex: string): Uint8Array {\n  if (hex.length % 2 !== 0) {\n    throw new Error(`Invalid versionstamp hex length: ${hex.length}`);\n  }\n\n  const bytes = new Uint8Array(hex.length / 2);\n  for (let i = 0; i < hex.length; i += 2) {\n    bytes[i / 2] = Number.parseInt(hex.slice(i, i + 2), 16);\n  }\n  return bytes;\n}\n\nexport function parseOutboxVersionValue(value: unknown): bigint {\n  if (typeof value === \"bigint\") {\n    return value;\n  }\n\n  if (typeof value === \"number\") {\n    return BigInt(value);\n  }\n\n  if (typeof value === \"string\") {\n    return BigInt(value);\n  }\n\n  throw new Error(`Invalid outbox version value: ${String(value)}`);\n}\n\nfunction bigintToBytes(value: bigint, length: number): Uint8Array {\n  const bytes = new Uint8Array(length);\n  let remaining = value;\n\n  for (let i = length - 1; i >= 0; i -= 1) {\n    bytes[i] = Number(remaining & 0xffn);\n    remaining >>= 8n;\n  }\n\n  if (remaining !== 0n) {\n    throw new Error(`Outbox version ${value} exceeds ${length * 8} bits`);\n  }\n\n  return bytes;\n}\n"],"mappings":";AAuEA,SAAgB,mBAAmB,oBAA4B,aAAiC;AAC9F,KAAI,cAAc,KAAK,cAAc,MACnC,OAAM,IAAI,MAAM,gCAAgC,cAAc;CAGhE,MAAM,UAAU,cAAc,oBAAoB,GAAG;CACrD,MAAM,YAAY,IAAI,WAAW,EAAE;AACnC,WAAU,KAAM,eAAe,IAAK;AACpC,WAAU,KAAK,cAAc;CAE7B,MAAM,WAAW,IAAI,WAAW,GAAG;AACnC,UAAS,IAAI,SAAS,EAAE;AACxB,UAAS,IAAI,WAAW,GAAG;AAE3B,QAAO;;AAGT,SAAgB,kBAAkB,OAA2B;CAC3D,IAAI,MAAM;AACV,MAAK,MAAM,QAAQ,MACjB,QAAO,KAAK,SAAS,GAAG,CAAC,SAAS,GAAG,IAAI;AAE3C,QAAO;;AAeT,SAAgB,wBAAwB,OAAwB;AAC9D,KAAI,OAAO,UAAU,SACnB,QAAO;AAGT,KAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;AAGtB,KAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;AAGtB,OAAM,IAAI,MAAM,iCAAiC,OAAO,MAAM,GAAG;;AAGnE,SAAS,cAAc,OAAe,QAA4B;CAChE,MAAM,QAAQ,IAAI,WAAW,OAAO;CACpC,IAAI,YAAY;AAEhB,MAAK,IAAI,IAAI,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG;AACvC,QAAM,KAAK,OAAO,YAAY,KAAM;AACpC,gBAAc;;AAGhB,KAAI,cAAc,GAChB,OAAM,IAAI,MAAM,kBAAkB,MAAM,WAAW,SAAS,EAAE,OAAO;AAGvE,QAAO"}

package/dist/query/column-defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"column-defaults.js","names":[],"sources":["../../src/query/column-defaults.ts"],"sourcesContent":["import type { AnyColumn } from \"../schema/create\";\nimport { createId } from \"../id\";\n\nexport type RuntimeDefaultContext = {\n  now?: () => Date;\n  createId?: () => string;\n};\n\n/**\n * Generate a runtime default value for a column that has defaultTo$()\n *\n * Only generates values for runtime defaults (defaultTo$), NOT static defaults (defaultTo).\n * Static defaults should be handled by the database via DEFAULT constraints.\n *\n * @param column - The column with a default value configuration\n * @returns The generated default value, or undefined if the column has no runtime default\n *\n * @internal\n */\nexport function generateRuntimeDefault(\n  column: AnyColumn,\n  context: RuntimeDefaultContext = {},\n): unknown {\n  // Check if column has a default value configuration\n  if (!column.default) {\n    return undefined;\n  }\n\n  // If it's a static default value (defaultTo), return undefined\n  // as the database should handle this via DEFAULT constraint\n  if (\"value\" in column.default) {\n    return undefined;\n  }\n\n  // If it's a database-level special function (defaultTo(b => b.now())), return undefined\n  // as the database should handle this via DEFAULT NOW() or equivalent\n  if (\"dbSpecial\" in column.default) {\n    return undefined;\n  }\n\n  // Handle runtime defaults (defaultTo$)\n  const runtime = column.default.runtime;\n\n  if (runtime === \"cuid\") {\n    return (context.createId ?? createId)();\n  }\n\n  if (runtime === \"now\") {\n    return (context.now ?? (() => new Date()))();\n  }\n\n  if (typeof runtime === \"function\") {\n    return runtime();\n  }\n\n  return undefined;\n}\n\n/**\n * Generate a fallback value for database-level defaults.\n *\n * This is used by adapters that cannot rely on database DEFAULT constraints,\n * such as the in-memory adapter.\n *\n * @internal\n */\nexport function generateDatabaseDefault(\n  column: AnyColumn,\n  context: RuntimeDefaultContext = {},\n): unknown {\n  if (!column.default) {\n    return undefined;\n  }\n\n  if (\"value\" in column.default) {\n    return column.default.value;\n  }\n\n  if (\"dbSpecial\" in column.default) {\n    if (column.default.dbSpecial === \"now\") {\n      return (context.now ?? (() => new Date()))();\n    }\n    return undefined;\n  }\n\n  return undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;AAmBA,SAAgB,uBACd,QACA,UAAiC,EAAE,EAC1B;AAET,KAAI,CAAC,OAAO,QACV;AAKF,KAAI,WAAW,OAAO,QACpB;AAKF,KAAI,eAAe,OAAO,QACxB;CAIF,MAAM,UAAU,OAAO,QAAQ;AAE/B,KAAI,YAAY,OACd,SAAQ,QAAQ,YAAY,WAAW;AAGzC,KAAI,YAAY,MACd,SAAQ,QAAQ,8BAAc,IAAI,MAAM,IAAI;AAG9C,KAAI,OAAO,YAAY,WACrB,QAAO,SAAS;;;;;;;;;;AAcpB,SAAgB,wBACd,QACA,UAAiC,EAAE,EAC1B;AACT,KAAI,CAAC,OAAO,QACV;AAGF,KAAI,WAAW,OAAO,QACpB,QAAO,OAAO,QAAQ;AAGxB,KAAI,eAAe,OAAO,SAAS;AACjC,MAAI,OAAO,QAAQ,cAAc,MAC/B,SAAQ,QAAQ,8BAAc,IAAI,MAAM,IAAI;AAE9C"}
+{"version":3,"file":"column-defaults.js","names":[],"sources":["../../src/query/column-defaults.ts"],"sourcesContent":["import { createId } from \"../id\";\nimport type { AnyColumn } from \"../schema/create\";\n\nexport type RuntimeDefaultContext = {\n  now?: () => Date;\n  createId?: () => string;\n};\n\n/**\n * Generate a runtime default value for a column that has defaultTo$()\n *\n * Only generates values for runtime defaults (defaultTo$), NOT static defaults (defaultTo).\n * Static defaults should be handled by the database via DEFAULT constraints.\n *\n * @param column - The column with a default value configuration\n * @returns The generated default value, or undefined if the column has no runtime default\n *\n * @internal\n */\nexport function generateRuntimeDefault(\n  column: AnyColumn,\n  context: RuntimeDefaultContext = {},\n): unknown {\n  // Check if column has a default value configuration\n  if (!column.default) {\n    return undefined;\n  }\n\n  // If it's a static default value (defaultTo), return undefined\n  // as the database should handle this via DEFAULT constraint\n  if (\"value\" in column.default) {\n    return undefined;\n  }\n\n  // If it's a database-level special function (defaultTo(b => b.now())), return undefined\n  // as the database should handle this via DEFAULT NOW() or equivalent\n  if (\"dbSpecial\" in column.default) {\n    return undefined;\n  }\n\n  // Handle runtime defaults (defaultTo$)\n  const runtime = column.default.runtime;\n\n  if (runtime === \"cuid\") {\n    return (context.createId ?? createId)();\n  }\n\n  if (runtime === \"now\") {\n    return (context.now ?? (() => new Date()))();\n  }\n\n  if (typeof runtime === \"function\") {\n    return runtime();\n  }\n\n  return undefined;\n}\n\n/**\n * Generate a fallback value for database-level defaults.\n *\n * This is used by adapters that cannot rely on database DEFAULT constraints,\n * such as the in-memory adapter.\n *\n * @internal\n */\nexport function generateDatabaseDefault(\n  column: AnyColumn,\n  context: RuntimeDefaultContext = {},\n): unknown {\n  if (!column.default) {\n    return undefined;\n  }\n\n  if (\"value\" in column.default) {\n    return column.default.value;\n  }\n\n  if (\"dbSpecial\" in column.default) {\n    if (column.default.dbSpecial === \"now\") {\n      return (context.now ?? (() => new Date()))();\n    }\n    return undefined;\n  }\n\n  return undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;AAmBA,SAAgB,uBACd,QACA,UAAiC,EAAE,EAC1B;AAET,KAAI,CAAC,OAAO,QACV;AAKF,KAAI,WAAW,OAAO,QACpB;AAKF,KAAI,eAAe,OAAO,QACxB;CAIF,MAAM,UAAU,OAAO,QAAQ;AAE/B,KAAI,YAAY,OACd,SAAQ,QAAQ,YAAY,WAAW;AAGzC,KAAI,YAAY,MACd,SAAQ,QAAQ,8BAAc,IAAI,MAAM,IAAI;AAG9C,KAAI,OAAO,YAAY,WACrB,QAAO,SAAS;;;;;;;;;;AAcpB,SAAgB,wBACd,QACA,UAAiC,EAAE,EAC1B;AACT,KAAI,CAAC,OAAO,QACV;AAGF,KAAI,WAAW,OAAO,QACpB,QAAO,OAAO,QAAQ;AAGxB,KAAI,eAAe,OAAO,SAAS;AACjC,MAAI,OAAO,QAAQ,cAAc,MAC/B,SAAQ,QAAQ,8BAAc,IAAI,MAAM,IAAI;AAE9C"}

package/dist/query/condition-builder.d.ts

@@ -1,6 +1,8 @@
+import { DbInterval, DbIntervalInput, DbNow } from "./db-now.js";
 import { AnyColumn, FragnoId, IdColumn } from "../schema/create.js";
 
 //#region src/query/condition-builder.d.ts
+type ConditionType = "compare" | "and" | "or" | "not";
 type Condition = {
   type: "compare";
   a: AnyColumn;
@@ -30,12 +32,16 @@ type ConditionBuilder<Columns extends Record<string, AnyColumn>> = {
   not: (v: Condition | boolean) => Condition | boolean;
   isNull: (a: keyof Columns) => Condition;
   isNotNull: (a: keyof Columns) => Condition;
+  now: () => DbNow;
+  interval: (input: DbIntervalInput) => DbInterval;
 };
 declare const stringOperators: readonly ["contains", "starts with", "ends with", "not contains", "not starts with", "not ends with"];
 declare const arrayOperators: readonly ["in", "not in"];
 declare const valueOperators: readonly ["=", "!=", ">", ">=", "<", "<=", "is", "is not"];
 declare const operators: readonly ["=", "!=", ">", ">=", "<", "<=", "is", "is not", "in", "not in", "contains", "starts with", "ends with", "not contains", "not starts with", "not ends with"];
 type Operator = (typeof operators)[number];
+declare function createBuilder<Columns extends Record<string, AnyColumn>>(columns: Columns): ConditionBuilder<Columns>;
+declare function buildCondition<T, Columns extends Record<string, AnyColumn>>(columns: Columns, input: (builder: ConditionBuilder<Columns>) => T): T;
 //#endregion
-export { Condition, ConditionBuilder };
+export { Condition, ConditionBuilder, ConditionType, Operator, buildCondition, createBuilder, operators };
 //# sourceMappingURL=condition-builder.d.ts.map

package/dist/query/condition-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"condition-builder.d.ts","names":[],"sources":["../../src/query/condition-builder.ts"],"sourcesContent":[],"mappings":";;;KAIY,SAAA;EAAA,IAAA,EAAA,SAAS;EAGZ,CAAA,EAAA,SAAA;EACO,QAAA,EAAA,QAAA;EACP,CAAA,EAAA,SAAA,GAAA,OAAA,GAAA,IAAA;CAII,GAAA;EAID,IAAA,EAAA,IAAA,GAAA,KAAA;EAAS,KAAA,EAJR,SAIQ,EAAA;AACf,CAAA,GAQD;EAA0B,IAAA,EAAA,KAAA;EAAa,IAAA,EAThC,SASgC;CAAU;;;;;KAAjD,eAGY,CAAA,UAHc,SAGd,CAAA,GAH2B,CAG3B,SAHqC,QAGrC,GAFb,CAEa,CAAA,KAAA,CAAA,GAFF,QAEE,GADb,CACa,CAAA,KAAA,CAAA,SAAA,MAAA,GAAX,CAAW,CAAA,KAAA,CAAA,GAAA,QAAA,GACX,CADW,CAAA,KAAA,CAAA;AACX,KAEM,gBAFN,CAAA,gBAEuC,MAFvC,CAAA,MAAA,EAEsD,SAFtD,CAAA,CAAA,GAAA;EAAC,CAAA,gBAAA,MAGkB,OAHlB,CAAA,CAAA,CAAA,EAIA,OAJA,EAAA,QAAA,EAAA,CAAA,OAKe,cALf,CAAA,CAAA,MAAA,CAAA,GAAA,CAAA,OAKiD,eALjD,CAAA,CAAA,MAAA,CAAA,EAAA,CAAA,EAMA,eANA,CAMgB,OANhB,CAMwB,OANxB,CAAA,CAAA,GAAA,IAAA,CAAA,EAOF,SAPE;EAEK,CAAA,gBAAA,MAOa,OAPG,CAAA,CAAA,CAAA,EAQrB,OARqB,EAAA,QAAA,EAAA,CAAA,OASN,cATM,CAAA,CAAA,MAAA,CAAA,EAAA,CAAA,EAUrB,eAVqB,CAUL,OAVK,CAUG,OAVH,CAAA,CAAA,EAAA,CAAA,EAWvB,SAXuB;EAAgC;;;EAErD,CAAA,gBAAA,MAckB,OAdlB,CAAA,CAAA,CAAA,EAc8B,OAd9B,CAAA,EAcwC,SAdxC;EACe,GAAA,EAAA,CAAA,GAAA,CAAA,EAAA,CAeP,SAfO,GAAA,OAAA,CAAA,EAAA,EAAA,GAeoB,SAfpB,GAAA,OAAA;EAAkC,EAAA,EAAA,CAAA,GAAA,CAAA,EAAA,CAgB1C,SAhB0C,GAAA,OAAA,CAAA,EAAA,EAAA,GAgBf,SAhBe,GAAA,OAAA;EACjC,GAAA,EAAA,CAAA,CAAA,EAgBZ,SAhBY,GAAA,OAAA,EAAA,GAgBY,SAhBZ,GAAA,OAAA;EAAQ,MAAA,EAAA,CAAA,CAAA,EAAA,MAkBX,OAlBW,EAAA,GAkBC,SAlBD;EAAxB,SAAA,EAAA,CAAA,CAAA,EAAA,MAmBgB,OAnBhB,EAAA,GAmB4B,SAnB5B;CACF;cAsBC,eApBmB,EAAA,SAAA,CAAA,UAAA,EAAA,aAAA,EAAA,WAAA,EAAA,cAAA,EAAA,iBAAA,EAAA,eAAA,CAAA;cA+BnB,cA9BC,EAAA,SAAA,CAAA,IAAA,EAAA,QAAA,CAAA;cAgCD,cA/BgB,EAAA,SAAA,CAAA,GAAA,EAAA,IAAA,EAAA,GAAA,EAAA,IAAA,EAAA,GAAA,EAAA,IAAA,EAAA,IAAA,EAAA,QAAA,CAAA;AACC,cAmCV,SAnCU,EAAA,SAAA,CAAA,GAAA,EAAA,IAAA,EAAA,GAAA,EAAA,IAAA,EAAA,GAAA,EAAA,IAAA,EAAA,IAAA,EAAA,QAAA,EAAA,IAAA,EAAA,QAAA,EAAA,UAAA,EAAA,aAAA,EAAA,WAAA,EAAA,cAAA,EAAA,iBAAA,EAAA,eAAA,CAAA;AAAQ,KAqCnB,QAAA,GArCmB,CAAA,OAqCA,SArCA,CAAA,CAAA,MAAA,CAAA"}
+{"version":3,"file":"condition-builder.d.ts","names":[],"sources":["../../src/query/condition-builder.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/query/condition-builder.js

@@ -1,3 +1,5 @@
+import { dbInterval, dbNow } from "./db-now.js";
+
 //#region src/query/condition-builder.ts
 const stringOperators = [
 	"contains",
@@ -49,6 +51,8 @@ function createBuilder(columns) {
 	};
 	builder.isNull = (a) => builder(a, "is", null);
 	builder.isNotNull = (a) => builder(a, "is not", null);
+	builder.now = () => dbNow();
+	builder.interval = (input) => dbInterval(input);
 	builder.not = (condition) => {
 		if (typeof condition === "boolean") return !condition;
 		return {
@@ -89,5 +93,5 @@ function buildCondition(columns, input) {
 }
 
 //#endregion
-export { buildCondition };
+export { buildCondition, createBuilder, operators };
 //# sourceMappingURL=condition-builder.js.map

package/dist/query/condition-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"condition-builder.js","names":["builder: ConditionBuilder<Columns>"],"sources":["../../src/query/condition-builder.ts"],"sourcesContent":["import type { AnyColumn, FragnoId, IdColumn } from \"../schema/create\";\n\nexport type ConditionType = \"compare\" | \"and\" | \"or\" | \"not\";\n\nexport type Condition =\n  | {\n      type: \"compare\";\n      a: AnyColumn;\n      operator: Operator;\n      b: AnyColumn | unknown | null;\n    }\n  | {\n      type: \"or\" | \"and\";\n      items: Condition[];\n    }\n  | {\n      type: \"not\";\n      item: Condition;\n    };\n\n// TODO: we temporarily dropped support for comparing against another column, because Prisma ORM still have problems with it.\n\n/**\n * Helper type that allows FragnoId for ID columns and reference columns (bigint).\n * Used in ConditionBuilder to accept FragnoId values in where conditions.\n */\ntype AcceptsFragnoId<T extends AnyColumn> = T extends IdColumn\n  ? T[\"$in\"] | FragnoId\n  : T[\"$in\"] extends bigint\n    ? T[\"$in\"] | FragnoId\n    : T[\"$in\"];\n\nexport type ConditionBuilder<Columns extends Record<string, AnyColumn>> = {\n  <ColName extends keyof Columns>(\n    a: ColName,\n    operator: (typeof valueOperators)[number] | (typeof stringOperators)[number],\n    b: AcceptsFragnoId<Columns[ColName]> | null,\n  ): Condition;\n\n  <ColName extends keyof Columns>(\n    a: ColName,\n    operator: (typeof arrayOperators)[number],\n    b: AcceptsFragnoId<Columns[ColName]>[],\n  ): Condition;\n\n  /**\n   * Boolean values\n   */\n  <ColName extends keyof Columns>(a: ColName): Condition;\n\n  and: (...v: (Condition | boolean)[]) => Condition | boolean;\n  or: (...v: (Condition | boolean)[]) => Condition | boolean;\n  not: (v: Condition | boolean) => Condition | boolean;\n\n  isNull: (a: keyof Columns) => Condition;\n  isNotNull: (a: keyof Columns) => Condition;\n};\n\n// replacement for `like` (Prisma doesn't support `like`)\nconst stringOperators = [\n  \"contains\",\n  \"starts with\",\n  \"ends with\",\n\n  \"not contains\",\n  \"not starts with\",\n  \"not ends with\",\n  // excluded `regexp` since MSSQL doesn't support it, may re-consider\n] as const;\n\nconst arrayOperators = [\"in\", \"not in\"] as const;\n\nconst valueOperators = [\"=\", \"!=\", \">\", \">=\", \"<\", \"<=\", \"is\", \"is not\"] as const;\n\n// JSON specific operators are not included, some databases don't support them\n// `match` requires additional extensions & configurations on SQLite and PostgreSQL\n// MySQL & SQLite requires workarounds to support `ilike`\nexport const operators = [...valueOperators, ...arrayOperators, ...stringOperators] as const;\n\nexport type Operator = (typeof operators)[number];\n\nexport function createBuilder<Columns extends Record<string, AnyColumn>>(\n  columns: Columns,\n): ConditionBuilder<Columns> {\n  function col(name: keyof Columns) {\n    const out = columns[name];\n    if (!out) {\n      throw new Error(`Invalid column name ${String(name)}`);\n    }\n\n    return out;\n  }\n\n  const builder: ConditionBuilder<Columns> = (...args: [string, Operator, unknown] | [string]) => {\n    if (args.length === 3) {\n      const [a, operator, b] = args;\n\n      if (!operators.includes(operator)) {\n        throw new Error(`Unsupported operator: ${operator}`);\n      }\n\n      return {\n        type: \"compare\",\n        a: col(a),\n        b,\n        operator,\n      };\n    }\n\n    return {\n      type: \"compare\",\n      a: col(args[0]),\n      operator: \"=\",\n      b: true,\n    };\n  };\n\n  builder.isNull = (a) => builder(a, \"is\", null);\n  builder.isNotNull = (a) => builder(a, \"is not\", null);\n  builder.not = (condition) => {\n    if (typeof condition === \"boolean\") {\n      return !condition;\n    }\n\n    return {\n      type: \"not\",\n      item: condition,\n    };\n  };\n\n  builder.or = (...conditions) => {\n    const out = {\n      type: \"or\",\n      items: [] as Condition[],\n    } as const;\n\n    for (const item of conditions) {\n      if (item === true) {\n        return true;\n      }\n      if (item === false) {\n        continue;\n      }\n\n      out.items.push(item);\n    }\n\n    if (out.items.length === 0) {\n      return false;\n    }\n    return out;\n  };\n\n  builder.and = (...conditions) => {\n    const out = {\n      type: \"and\",\n      items: [] as Condition[],\n    } as const;\n\n    for (const item of conditions) {\n      if (item === true) {\n        continue;\n      }\n      if (item === false) {\n        return false;\n      }\n\n      out.items.push(item);\n    }\n\n    if (out.items.length === 0) {\n      return true;\n    }\n    return out;\n  };\n\n  return builder;\n}\n\nexport function buildCondition<T, Columns extends Record<string, AnyColumn>>(\n  columns: Columns,\n  input: (builder: ConditionBuilder<Columns>) => T,\n): T {\n  return input(createBuilder(columns));\n}\n\n/**\n * Create a ConditionBuilder that only allows comparisons on indexed columns.\n * Used in Unit of Work to ensure queries can leverage indexes for optimal performance.\n *\n * @param columns - The full set of columns from the table\n * @param indexedColumnNames - Set of column names that are part of indexes\n * @returns A ConditionBuilder restricted to indexed columns only\n *\n * @example\n * ```ts\n * const builder = createIndexedBuilder(\n *   table.columns,\n *   new Set([\"id\", \"userId\", \"createdAt\"])\n * );\n * const condition = builder(\"userId\", \"=\", \"123\");\n * ```\n */\nexport function createIndexedBuilder<Columns extends Record<string, AnyColumn>>(\n  columns: Columns,\n  indexedColumnNames: Set<string>,\n): ConditionBuilder<Columns> {\n  function col(name: keyof Columns) {\n    const columnName = String(name);\n\n    if (!indexedColumnNames.has(columnName)) {\n      throw new Error(\n        `Column \"${columnName}\" is not indexed. Only indexed columns can be used in Unit of Work queries. ` +\n          `Available indexed columns: ${Array.from(indexedColumnNames).join(\", \")}`,\n      );\n    }\n\n    const out = columns[name];\n    if (!out) {\n      throw new Error(`Invalid column name ${columnName}`);\n    }\n\n    return out;\n  }\n\n  const builder: ConditionBuilder<Columns> = (...args: [string, Operator, unknown] | [string]) => {\n    if (args.length === 3) {\n      const [a, operator, b] = args;\n\n      if (!operators.includes(operator)) {\n        throw new Error(`Unsupported operator: ${operator}`);\n      }\n\n      return {\n        type: \"compare\",\n        a: col(a),\n        b,\n        operator,\n      };\n    }\n\n    return {\n      type: \"compare\",\n      a: col(args[0]),\n      operator: \"=\",\n      b: true,\n    };\n  };\n\n  builder.isNull = (a) => builder(a, \"is\", null);\n  builder.isNotNull = (a) => builder(a, \"is not\", null);\n  builder.not = (condition) => {\n    if (typeof condition === \"boolean\") {\n      return !condition;\n    }\n\n    return {\n      type: \"not\",\n      item: condition,\n    };\n  };\n\n  builder.or = (...conditions) => {\n    const out = {\n      type: \"or\",\n      items: [] as Condition[],\n    } as const;\n\n    for (const item of conditions) {\n      if (item === true) {\n        return true;\n      }\n      if (item === false) {\n        continue;\n      }\n\n      out.items.push(item);\n    }\n\n    if (out.items.length === 0) {\n      return false;\n    }\n    return out;\n  };\n\n  builder.and = (...conditions) => {\n    const out = {\n      type: \"and\",\n      items: [] as Condition[],\n    } as const;\n\n    for (const item of conditions) {\n      if (item === true) {\n        continue;\n      }\n      if (item === false) {\n        return false;\n      }\n\n      out.items.push(item);\n    }\n\n    if (out.items.length === 0) {\n      return true;\n    }\n    return out;\n  };\n\n  return builder;\n}\n"],"mappings":";AA2DA,MAAM,kBAAkB;CACtB;CACA;CACA;CAEA;CACA;CACA;CAED;AAED,MAAM,iBAAiB,CAAC,MAAM,SAAS;AAEvC,MAAM,iBAAiB;CAAC;CAAK;CAAM;CAAK;CAAM;CAAK;CAAM;CAAM;CAAS;AAKxE,MAAa,YAAY;CAAC,GAAG;CAAgB,GAAG;CAAgB,GAAG;CAAgB;AAInF,SAAgB,cACd,SAC2B;CAC3B,SAAS,IAAI,MAAqB;EAChC,MAAM,MAAM,QAAQ;AACpB,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,uBAAuB,OAAO,KAAK,GAAG;AAGxD,SAAO;;CAGT,MAAMA,WAAsC,GAAG,SAAiD;AAC9F,MAAI,KAAK,WAAW,GAAG;GACrB,MAAM,CAAC,GAAG,UAAU,KAAK;AAEzB,OAAI,CAAC,UAAU,SAAS,SAAS,CAC/B,OAAM,IAAI,MAAM,yBAAyB,WAAW;AAGtD,UAAO;IACL,MAAM;IACN,GAAG,IAAI,EAAE;IACT;IACA;IACD;;AAGH,SAAO;GACL,MAAM;GACN,GAAG,IAAI,KAAK,GAAG;GACf,UAAU;GACV,GAAG;GACJ;;AAGH,SAAQ,UAAU,MAAM,QAAQ,GAAG,MAAM,KAAK;AAC9C,SAAQ,aAAa,MAAM,QAAQ,GAAG,UAAU,KAAK;AACrD,SAAQ,OAAO,cAAc;AAC3B,MAAI,OAAO,cAAc,UACvB,QAAO,CAAC;AAGV,SAAO;GACL,MAAM;GACN,MAAM;GACP;;AAGH,SAAQ,MAAM,GAAG,eAAe;EAC9B,MAAM,MAAM;GACV,MAAM;GACN,OAAO,EAAE;GACV;AAED,OAAK,MAAM,QAAQ,YAAY;AAC7B,OAAI,SAAS,KACX,QAAO;AAET,OAAI,SAAS,MACX;AAGF,OAAI,MAAM,KAAK,KAAK;;AAGtB,MAAI,IAAI,MAAM,WAAW,EACvB,QAAO;AAET,SAAO;;AAGT,SAAQ,OAAO,GAAG,eAAe;EAC/B,MAAM,MAAM;GACV,MAAM;GACN,OAAO,EAAE;GACV;AAED,OAAK,MAAM,QAAQ,YAAY;AAC7B,OAAI,SAAS,KACX;AAEF,OAAI,SAAS,MACX,QAAO;AAGT,OAAI,MAAM,KAAK,KAAK;;AAGtB,MAAI,IAAI,MAAM,WAAW,EACvB,QAAO;AAET,SAAO;;AAGT,QAAO;;AAGT,SAAgB,eACd,SACA,OACG;AACH,QAAO,MAAM,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"condition-builder.js","names":["builder: ConditionBuilder<Columns>"],"sources":["../../src/query/condition-builder.ts"],"sourcesContent":["import type { AnyColumn, FragnoId, IdColumn } from \"../schema/create\";\nimport { dbInterval, dbNow, type DbInterval, type DbIntervalInput, type DbNow } from \"./db-now\";\n\nexport type ConditionType = \"compare\" | \"and\" | \"or\" | \"not\";\n\nexport type Condition =\n  | {\n      type: \"compare\";\n      a: AnyColumn;\n      operator: Operator;\n      b: AnyColumn | unknown | null;\n    }\n  | {\n      type: \"or\" | \"and\";\n      items: Condition[];\n    }\n  | {\n      type: \"not\";\n      item: Condition;\n    };\n\n// TODO: we temporarily dropped support for comparing against another column, because Prisma ORM still have problems with it.\n\n/**\n * Helper type that allows FragnoId for ID columns and reference columns (bigint).\n * Used in ConditionBuilder to accept FragnoId values in where conditions.\n */\ntype AcceptsFragnoId<T extends AnyColumn> = T extends IdColumn\n  ? T[\"$in\"] | FragnoId\n  : T[\"$in\"] extends bigint\n    ? T[\"$in\"] | FragnoId\n    : T[\"$in\"];\n\nexport type ConditionBuilder<Columns extends Record<string, AnyColumn>> = {\n  <ColName extends keyof Columns>(\n    a: ColName,\n    operator: (typeof valueOperators)[number] | (typeof stringOperators)[number],\n    b: AcceptsFragnoId<Columns[ColName]> | null,\n  ): Condition;\n\n  <ColName extends keyof Columns>(\n    a: ColName,\n    operator: (typeof arrayOperators)[number],\n    b: AcceptsFragnoId<Columns[ColName]>[],\n  ): Condition;\n\n  /**\n   * Boolean values\n   */\n  <ColName extends keyof Columns>(a: ColName): Condition;\n\n  and: (...v: (Condition | boolean)[]) => Condition | boolean;\n  or: (...v: (Condition | boolean)[]) => Condition | boolean;\n  not: (v: Condition | boolean) => Condition | boolean;\n\n  isNull: (a: keyof Columns) => Condition;\n  isNotNull: (a: keyof Columns) => Condition;\n  now: () => DbNow;\n  interval: (input: DbIntervalInput) => DbInterval;\n};\n\n// replacement for `like` (Prisma doesn't support `like`)\nconst stringOperators = [\n  \"contains\",\n  \"starts with\",\n  \"ends with\",\n\n  \"not contains\",\n  \"not starts with\",\n  \"not ends with\",\n  // excluded `regexp` since MSSQL doesn't support it, may re-consider\n] as const;\n\nconst arrayOperators = [\"in\", \"not in\"] as const;\n\nconst valueOperators = [\"=\", \"!=\", \">\", \">=\", \"<\", \"<=\", \"is\", \"is not\"] as const;\n\n// JSON specific operators are not included, some databases don't support them\n// `match` requires additional extensions & configurations on SQLite and PostgreSQL\n// MySQL & SQLite requires workarounds to support `ilike`\nexport const operators = [...valueOperators, ...arrayOperators, ...stringOperators] as const;\n\nexport type Operator = (typeof operators)[number];\n\nexport function createBuilder<Columns extends Record<string, AnyColumn>>(\n  columns: Columns,\n): ConditionBuilder<Columns> {\n  function col(name: keyof Columns) {\n    const out = columns[name];\n    if (!out) {\n      throw new Error(`Invalid column name ${String(name)}`);\n    }\n\n    return out;\n  }\n\n  const builder: ConditionBuilder<Columns> = (...args: [string, Operator, unknown] | [string]) => {\n    if (args.length === 3) {\n      const [a, operator, b] = args;\n\n      if (!operators.includes(operator)) {\n        throw new Error(`Unsupported operator: ${operator}`);\n      }\n\n      return {\n        type: \"compare\",\n        a: col(a),\n        b,\n        operator,\n      };\n    }\n\n    return {\n      type: \"compare\",\n      a: col(args[0]),\n      operator: \"=\",\n      b: true,\n    };\n  };\n\n  builder.isNull = (a) => builder(a, \"is\", null);\n  builder.isNotNull = (a) => builder(a, \"is not\", null);\n  builder.now = () => dbNow();\n  builder.interval = (input) => dbInterval(input);\n  builder.not = (condition) => {\n    if (typeof condition === \"boolean\") {\n      return !condition;\n    }\n\n    return {\n      type: \"not\",\n      item: condition,\n    };\n  };\n\n  builder.or = (...conditions) => {\n    const out = {\n      type: \"or\",\n      items: [] as Condition[],\n    } as const;\n\n    for (const item of conditions) {\n      if (item === true) {\n        return true;\n      }\n      if (item === false) {\n        continue;\n      }\n\n      out.items.push(item);\n    }\n\n    if (out.items.length === 0) {\n      return false;\n    }\n    return out;\n  };\n\n  builder.and = (...conditions) => {\n    const out = {\n      type: \"and\",\n      items: [] as Condition[],\n    } as const;\n\n    for (const item of conditions) {\n      if (item === true) {\n        continue;\n      }\n      if (item === false) {\n        return false;\n      }\n\n      out.items.push(item);\n    }\n\n    if (out.items.length === 0) {\n      return true;\n    }\n    return out;\n  };\n\n  return builder;\n}\n\nexport function buildCondition<T, Columns extends Record<string, AnyColumn>>(\n  columns: Columns,\n  input: (builder: ConditionBuilder<Columns>) => T,\n): T {\n  return input(createBuilder(columns));\n}\n\n/**\n * Create a ConditionBuilder that only allows comparisons on indexed columns.\n * Used in Unit of Work to ensure queries can leverage indexes for optimal performance.\n *\n * @param columns - The full set of columns from the table\n * @param indexedColumnNames - Set of column names that are part of indexes\n * @returns A ConditionBuilder restricted to indexed columns only\n *\n * @example\n * ```ts\n * const builder = createIndexedBuilder(\n *   table.columns,\n *   new Set([\"id\", \"userId\", \"createdAt\"])\n * );\n * const condition = builder(\"userId\", \"=\", \"123\");\n * ```\n */\nexport function createIndexedBuilder<Columns extends Record<string, AnyColumn>>(\n  columns: Columns,\n  indexedColumnNames: Set<string>,\n): ConditionBuilder<Columns> {\n  function col(name: keyof Columns) {\n    const columnName = String(name);\n\n    if (!indexedColumnNames.has(columnName)) {\n      throw new Error(\n        `Column \"${columnName}\" is not indexed. Only indexed columns can be used in Unit of Work queries. ` +\n          `Available indexed columns: ${Array.from(indexedColumnNames).join(\", \")}`,\n      );\n    }\n\n    const out = columns[name];\n    if (!out) {\n      throw new Error(`Invalid column name ${columnName}`);\n    }\n\n    return out;\n  }\n\n  const builder: ConditionBuilder<Columns> = (...args: [string, Operator, unknown] | [string]) => {\n    if (args.length === 3) {\n      const [a, operator, b] = args;\n\n      if (!operators.includes(operator)) {\n        throw new Error(`Unsupported operator: ${operator}`);\n      }\n\n      return {\n        type: \"compare\",\n        a: col(a),\n        b,\n        operator,\n      };\n    }\n\n    return {\n      type: \"compare\",\n      a: col(args[0]),\n      operator: \"=\",\n      b: true,\n    };\n  };\n\n  builder.isNull = (a) => builder(a, \"is\", null);\n  builder.isNotNull = (a) => builder(a, \"is not\", null);\n  builder.now = () => dbNow();\n  builder.interval = (input) => dbInterval(input);\n  builder.not = (condition) => {\n    if (typeof condition === \"boolean\") {\n      return !condition;\n    }\n\n    return {\n      type: \"not\",\n      item: condition,\n    };\n  };\n\n  builder.or = (...conditions) => {\n    const out = {\n      type: \"or\",\n      items: [] as Condition[],\n    } as const;\n\n    for (const item of conditions) {\n      if (item === true) {\n        return true;\n      }\n      if (item === false) {\n        continue;\n      }\n\n      out.items.push(item);\n    }\n\n    if (out.items.length === 0) {\n      return false;\n    }\n    return out;\n  };\n\n  builder.and = (...conditions) => {\n    const out = {\n      type: \"and\",\n      items: [] as Condition[],\n    } as const;\n\n    for (const item of conditions) {\n      if (item === true) {\n        continue;\n      }\n      if (item === false) {\n        return false;\n      }\n\n      out.items.push(item);\n    }\n\n    if (out.items.length === 0) {\n      return true;\n    }\n    return out;\n  };\n\n  return builder;\n}\n"],"mappings":";;;AA8DA,MAAM,kBAAkB;CACtB;CACA;CACA;CAEA;CACA;CACA;CAED;AAED,MAAM,iBAAiB,CAAC,MAAM,SAAS;AAEvC,MAAM,iBAAiB;CAAC;CAAK;CAAM;CAAK;CAAM;CAAK;CAAM;CAAM;CAAS;AAKxE,MAAa,YAAY;CAAC,GAAG;CAAgB,GAAG;CAAgB,GAAG;CAAgB;AAInF,SAAgB,cACd,SAC2B;CAC3B,SAAS,IAAI,MAAqB;EAChC,MAAM,MAAM,QAAQ;AACpB,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,uBAAuB,OAAO,KAAK,GAAG;AAGxD,SAAO;;CAGT,MAAMA,WAAsC,GAAG,SAAiD;AAC9F,MAAI,KAAK,WAAW,GAAG;GACrB,MAAM,CAAC,GAAG,UAAU,KAAK;AAEzB,OAAI,CAAC,UAAU,SAAS,SAAS,CAC/B,OAAM,IAAI,MAAM,yBAAyB,WAAW;AAGtD,UAAO;IACL,MAAM;IACN,GAAG,IAAI,EAAE;IACT;IACA;IACD;;AAGH,SAAO;GACL,MAAM;GACN,GAAG,IAAI,KAAK,GAAG;GACf,UAAU;GACV,GAAG;GACJ;;AAGH,SAAQ,UAAU,MAAM,QAAQ,GAAG,MAAM,KAAK;AAC9C,SAAQ,aAAa,MAAM,QAAQ,GAAG,UAAU,KAAK;AACrD,SAAQ,YAAY,OAAO;AAC3B,SAAQ,YAAY,UAAU,WAAW,MAAM;AAC/C,SAAQ,OAAO,cAAc;AAC3B,MAAI,OAAO,cAAc,UACvB,QAAO,CAAC;AAGV,SAAO;GACL,MAAM;GACN,MAAM;GACP;;AAGH,SAAQ,MAAM,GAAG,eAAe;EAC9B,MAAM,MAAM;GACV,MAAM;GACN,OAAO,EAAE;GACV;AAED,OAAK,MAAM,QAAQ,YAAY;AAC7B,OAAI,SAAS,KACX,QAAO;AAET,OAAI,SAAS,MACX;AAGF,OAAI,MAAM,KAAK,KAAK;;AAGtB,MAAI,IAAI,MAAM,WAAW,EACvB,QAAO;AAET,SAAO;;AAGT,SAAQ,OAAO,GAAG,eAAe;EAC/B,MAAM,MAAM;GACV,MAAM;GACN,OAAO,EAAE;GACV;AAED,OAAK,MAAM,QAAQ,YAAY;AAC7B,OAAI,SAAS,KACX;AAEF,OAAI,SAAS,MACX,QAAO;AAGT,OAAI,MAAM,KAAK,KAAK;;AAGtB,MAAI,IAAI,MAAM,WAAW,EACvB,QAAO;AAET,SAAO;;AAGT,QAAO;;AAGT,SAAgB,eACd,SACA,OACG;AACH,QAAO,MAAM,cAAc,QAAQ,CAAC"}