@fragno-dev/db 0.2.2 → 0.4.1

package/dist/mod.js.map

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

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

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

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

package/dist/naming/sql-naming.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"sql-naming.js","names":["suffixNamingStrategy: SqlNamingStrategy","schemaNamingStrategy: SqlNamingStrategy","#namespace","#strategy","#tableNameMap","#columnNameMaps","columnMap: Record<string, string>"],"sources":["../../src/naming/sql-naming.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"outbox-builder.js","names":["drafts: OutboxMutationDraft[]","lookups: OutboxRefLookup[]","output: Record<string, unknown>"],"sources":["../../src/outbox/outbox-builder.ts"],"sourcesContent":["import { 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

@@ -0,0 +1,54 @@
+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;
+  mutations: OutboxMutation[];
+};
+type OutboxMutation = {
+  op: "create";
+  schema: string;
+  namespace?: string;
+  table: string;
+  externalId: string;
+  versionstamp: string;
+  values: Record<string, unknown>;
+} | {
+  op: "update";
+  schema: string;
+  namespace?: string;
+  table: string;
+  externalId: string;
+  versionstamp: string;
+  set: Record<string, unknown>;
+  checkVersion?: number;
+} | {
+  op: "delete";
+  schema: string;
+  namespace?: string;
+  table: string;
+  externalId: string;
+  versionstamp: string;
+  checkVersion?: number;
+};
+type OutboxRefMap = Record<string, string>;
+type OutboxPayloadSerialized = {
+  json: unknown;
+  meta?: Record<string, unknown>;
+};
+type OutboxEntry = {
+  id: FragnoId;
+  versionstamp: string;
+  uowId: string;
+  payload: OutboxPayloadSerialized;
+  refMap?: OutboxRefMap;
+  createdAt: Date;
+};
+//#endregion
+export { OutboxConfig, OutboxEntry, OutboxMutation, OutboxPayload, OutboxRefMap };
+//# sourceMappingURL=outbox.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,37 @@
+//#region src/outbox/outbox.ts
+function encodeVersionstamp(transactionVersion, userVersion) {
+	if (userVersion < 0 || userVersion > 65535) throw new Error(`Invalid outbox user version: ${userVersion}`);
+	const txBytes = bigintToBytes(transactionVersion, 10);
+	const userBytes = new Uint8Array(2);
+	userBytes[0] = userVersion >> 8 & 255;
+	userBytes[1] = userVersion & 255;
+	const combined = new Uint8Array(12);
+	combined.set(txBytes, 0);
+	combined.set(userBytes, 10);
+	return combined;
+}
+function versionstampToHex(bytes) {
+	let hex = "";
+	for (const byte of bytes) hex += byte.toString(16).padStart(2, "0");
+	return hex;
+}
+function parseOutboxVersionValue(value) {
+	if (typeof value === "bigint") return value;
+	if (typeof value === "number") return BigInt(value);
+	if (typeof value === "string") return BigInt(value);
+	throw new Error(`Invalid outbox version value: ${String(value)}`);
+}
+function bigintToBytes(value, length) {
+	const bytes = new Uint8Array(length);
+	let remaining = value;
+	for (let i = length - 1; i >= 0; i -= 1) {
+		bytes[i] = Number(remaining & 255n);
+		remaining >>= 8n;
+	}
+	if (remaining !== 0n) throw new Error(`Outbox version ${value} exceeds ${length * 8} bits`);
+	return bytes;
+}
+
+//#endregion
+export { encodeVersionstamp, parseOutboxVersionValue, versionstampToHex };
+//# sourceMappingURL=outbox.js.map

package/dist/outbox/outbox.js.map

@@ -0,0 +1 @@
+{"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

@@ -12,16 +12,32 @@ import { createId } from "../id.js";
 *
 * @internal
 */
-function generateRuntimeDefault(column) {
+function generateRuntimeDefault(column, context = {}) {
 	if (!column.default) return;
 	if ("value" in column.default) return;
 	if ("dbSpecial" in column.default) return;
 	const runtime = column.default.runtime;
-	if (runtime === "cuid") return createId();
-	if (runtime === "now") return /* @__PURE__ */ new Date();
+	if (runtime === "cuid") return (context.createId ?? createId)();
+	if (runtime === "now") return (context.now ?? (() => /* @__PURE__ */ new Date()))();
 	if (typeof runtime === "function") return runtime();
 }
+/**
+* Generate a fallback value for database-level defaults.
+*
+* This is used by adapters that cannot rely on database DEFAULT constraints,
+* such as the in-memory adapter.
+*
+* @internal
+*/
+function generateDatabaseDefault(column, context = {}) {
+	if (!column.default) return;
+	if ("value" in column.default) return column.default.value;
+	if ("dbSpecial" in column.default) {
+		if (column.default.dbSpecial === "now") return (context.now ?? (() => /* @__PURE__ */ new Date()))();
+		return;
+	}
+}
 
 //#endregion
-export { generateRuntimeDefault };
+export { generateDatabaseDefault, generateRuntimeDefault };
 //# sourceMappingURL=column-defaults.js.map

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\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(column: AnyColumn): 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 createId();\n  }\n\n  if (runtime === \"now\") {\n    return new Date();\n  }\n\n  if (typeof runtime === \"function\") {\n    return runtime();\n  }\n\n  return undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;AAcA,SAAgB,uBAAuB,QAA4B;AAEjE,KAAI,CAAC,OAAO,QACV;AAKF,KAAI,WAAW,OAAO,QACpB;AAKF,KAAI,eAAe,OAAO,QACxB;CAIF,MAAM,UAAU,OAAO,QAAQ;AAE/B,KAAI,YAAY,OACd,QAAO,UAAU;AAGnB,KAAI,YAAY,MACd,wBAAO,IAAI,MAAM;AAGnB,KAAI,OAAO,YAAY,WACrB,QAAO,SAAS"}
+{"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