@fragno-dev/db 0.2.2 → 0.3.0

package/dist/db-fragment-definition-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"db-fragment-definition-builder.js","names":["#baseBuilder","#schema","#namespace","#hooksFactory","implicitDeps: ImplicitDatabaseDependencies<TSchema>","serviceContext: DatabaseServiceContext<THooks>"],"sources":["../src/db-fragment-definition-builder.ts"],"sourcesContent":["import type { AnySchema } from \"./schema/create\";\nimport type { SimpleQueryInterface } from \"./query/simple-query-interface\";\nimport type { DatabaseAdapter } from \"./adapters/adapters\";\nimport type { IUnitOfWork } from \"./query/unit-of-work/unit-of-work\";\nimport type {\n  RequestThisContext,\n  FragnoPublicConfig,\n  AnyFragnoInstantiatedFragment,\n} from \"@fragno-dev/core\";\nimport {\n  FragmentDefinitionBuilder,\n  type FragmentDefinition,\n  type ServiceConstructorFn,\n} from \"@fragno-dev/core\";\nimport {\n  createServiceTxBuilder,\n  createHandlerTxBuilder,\n  ServiceTxBuilder,\n  HandlerTxBuilder,\n  type ExecuteTxOptions,\n} from \"./query/unit-of-work/execute-unit-of-work\";\nimport {\n  prepareHookMutations,\n  processHooks,\n  type HooksMap,\n  type HookFn,\n  type HookContext,\n} from \"./hooks/hooks\";\nimport type { InternalFragmentInstance } from \"./fragments/internal-fragment\";\n\n/**\n * Extended FragnoPublicConfig that includes a database adapter.\n * Use this type when creating fragments with database support.\n */\nexport type FragnoPublicConfigWithDatabase = FragnoPublicConfig & {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  databaseAdapter: DatabaseAdapter<any>;\n};\n\n/**\n * Implicit dependencies that database fragments get automatically.\n * These are injected without requiring explicit configuration.\n */\nexport type ImplicitDatabaseDependencies<TSchema extends AnySchema> = {\n  /**\n   * Database query engine for the fragment's schema.\n   */\n  db: SimpleQueryInterface<TSchema>;\n  /**\n   * The schema definition for this fragment.\n   */\n  schema: TSchema;\n  /**\n   * The database namespace for this fragment.\n   */\n  namespace: string;\n  /**\n   * Create a new Unit of Work for database operations.\n   */\n  createUnitOfWork: () => IUnitOfWork;\n};\n\n/**\n * Service context for database fragments - provides restricted UOW access without execute methods.\n */\nexport type DatabaseServiceContext<THooks extends HooksMap> = RequestThisContext & {\n  /**\n   * Create a service-level transaction builder using the fluent API.\n   * Returns a builder that can be chained with withServiceCalls, retrieve,\n   * transformRetrieve, mutate, transform, and build.\n   *\n   * @example\n   * ```ts\n   * return this.serviceTx(schema)\n   *   .withServiceCalls(() => [otherService.getData()])\n   *   .retrieve((uow) => uow.find(\"users\", ...))\n   *   .transformRetrieve(([users]) => users[0])\n   *   .mutate(({ uow, retrieveResult, serviceIntermediateResult }) =>\n   *     uow.create(\"records\", { ... })\n   *   )\n   *   .transform(({ mutateResult, serviceResult }) => ({ id: mutateResult }))\n   *   .build();\n   * ```\n   */\n  serviceTx<TSchema extends AnySchema>(\n    schema: TSchema,\n  ): ServiceTxBuilder<\n    TSchema,\n    readonly [],\n    [],\n    [],\n    unknown,\n    unknown,\n    false,\n    false,\n    false,\n    false,\n    THooks\n  >;\n};\n\n/**\n * Handler context for database fragments - provides UOW execution with automatic retry support.\n */\nexport type DatabaseHandlerContext<THooks extends HooksMap = {}> = RequestThisContext & {\n  /**\n   * Create a handler-level transaction builder using the fluent API.\n   * Returns a builder that can be chained with withServiceCalls, retrieve,\n   * transformRetrieve, mutate, transform, and execute.\n   *\n   * @example\n   * ```ts\n   * const result = await this.handlerTx()\n   *   .withServiceCalls(() => [userService.getUser(id)])\n   *   .mutate(({ forSchema, idempotencyKey, currentAttempt, serviceIntermediateResult }) => {\n   *     return forSchema(ordersSchema).create(\"orders\", { ... });\n   *   })\n   *   .transform(({ mutateResult, serviceResult }) => ({ ... }))\n   *   .execute();\n   * ```\n   */\n  handlerTx(\n    options?: Omit<ExecuteTxOptions, \"createUnitOfWork\">,\n  ): HandlerTxBuilder<readonly [], [], [], unknown, unknown, false, false, false, false, THooks>;\n};\n\n/**\n * Database fragment context provided to user callbacks.\n */\nexport type DatabaseFragmentContext<TSchema extends AnySchema> = {\n  /**\n   * Database adapter instance.\n   */\n  databaseAdapter: DatabaseAdapter<any>; // eslint-disable-line @typescript-eslint/no-explicit-any\n  /**\n   * ORM query engine for the fragment's schema.\n   */\n  db: SimpleQueryInterface<TSchema>;\n};\n\n/**\n * Create database context from options.\n * This extracts the database adapter and creates the ORM instance.\n */\nfunction createDatabaseContext<TSchema extends AnySchema>(\n  options: FragnoPublicConfigWithDatabase,\n  schema: TSchema,\n  namespace: string,\n): DatabaseFragmentContext<TSchema> {\n  const databaseAdapter = options.databaseAdapter;\n\n  if (!databaseAdapter) {\n    throw new Error(\n      \"Database fragment requires a database adapter to be provided in options.databaseAdapter\",\n    );\n  }\n\n  const db = databaseAdapter.createQueryEngine(schema, namespace);\n\n  return { databaseAdapter, db };\n}\n\n/**\n * Storage type for database fragments - stores the Unit of Work.\n */\nexport type DatabaseRequestStorage = {\n  uow: IUnitOfWork;\n};\n\n/**\n * Builder for database fragments that wraps the core fragment builder\n * and provides database-specific functionality.\n *\n * Database fragments always require FragnoPublicConfigWithDatabase (which includes databaseAdapter).\n */\nexport class DatabaseFragmentDefinitionBuilder<\n  TSchema extends AnySchema,\n  TConfig,\n  TDeps,\n  TBaseServices,\n  TServices,\n  TServiceDependencies,\n  TPrivateServices,\n  THooks extends HooksMap = {},\n  TServiceThisContext extends RequestThisContext = DatabaseHandlerContext,\n  THandlerThisContext extends RequestThisContext = DatabaseHandlerContext,\n  TLinkedFragments extends Record<string, AnyFragnoInstantiatedFragment> = {},\n> {\n  // Store the base builder - we'll replace its storage and context setup when building\n  #baseBuilder: FragmentDefinitionBuilder<\n    TConfig,\n    FragnoPublicConfigWithDatabase,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    DatabaseRequestStorage,\n    TLinkedFragments\n  >;\n  #schema: TSchema;\n  #namespace: string;\n  #hooksFactory?: (context: { config: TConfig; options: FragnoPublicConfigWithDatabase }) => THooks;\n\n  constructor(\n    baseBuilder: FragmentDefinitionBuilder<\n      TConfig,\n      FragnoPublicConfigWithDatabase,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies,\n      TPrivateServices,\n      TServiceThisContext,\n      THandlerThisContext,\n      DatabaseRequestStorage,\n      TLinkedFragments\n    >,\n    schema: TSchema,\n    namespace?: string,\n    hooksFactory?: (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n    }) => THooks,\n  ) {\n    this.#baseBuilder = baseBuilder;\n    this.#schema = schema;\n    this.#namespace = namespace ?? baseBuilder.name;\n    this.#hooksFactory = hooksFactory;\n  }\n\n  /**\n   * Define dependencies for this database fragment.\n   * The context includes database adapter and ORM instance.\n   */\n  withDependencies<TNewDeps>(\n    fn: (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n      db: SimpleQueryInterface<TSchema>;\n      databaseAdapter: DatabaseAdapter<any>; // eslint-disable-line @typescript-eslint/no-explicit-any\n    }) => TNewDeps,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TNewDeps & ImplicitDatabaseDependencies<TSchema>,\n    {},\n    {},\n    TServiceDependencies,\n    {},\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    // Wrap user function to inject DB context\n    const wrappedFn = (context: { config: TConfig; options: FragnoPublicConfigWithDatabase }) => {\n      const dbContext = createDatabaseContext(context.options, this.#schema, this.#namespace);\n\n      // Call user function with enriched context\n      const userDeps = fn({\n        config: context.config,\n        options: context.options,\n        db: dbContext.db,\n        databaseAdapter: dbContext.databaseAdapter,\n      });\n\n      // Create implicit dependencies\n      const createUow = () => dbContext.db.createUnitOfWork();\n      const implicitDeps: ImplicitDatabaseDependencies<TSchema> = {\n        db: dbContext.db,\n        schema: this.#schema,\n        namespace: this.#namespace,\n        createUnitOfWork: createUow,\n      };\n\n      return {\n        ...userDeps,\n        ...implicitDeps,\n      };\n    };\n\n    // Create new base builder with wrapped function\n    const newBaseBuilder = this.#baseBuilder.withDependencies(wrappedFn);\n\n    return new DatabaseFragmentDefinitionBuilder(\n      newBaseBuilder,\n      this.#schema,\n      this.#namespace,\n      this.#hooksFactory,\n    );\n  }\n\n  providesBaseService<TNewService>(\n    fn: ServiceConstructorFn<\n      TConfig,\n      FragnoPublicConfigWithDatabase,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TNewService,\n      TServiceThisContext\n    >,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TNewService,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const newBaseBuilder = this.#baseBuilder.providesBaseService<TNewService>(fn);\n\n    return new DatabaseFragmentDefinitionBuilder(\n      newBaseBuilder,\n      this.#schema,\n      this.#namespace,\n      this.#hooksFactory,\n    );\n  }\n\n  providesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    fn: ServiceConstructorFn<\n      TConfig,\n      FragnoPublicConfigWithDatabase,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TService,\n      TServiceThisContext\n    >,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices & { [K in TServiceName]: TService },\n    TServiceDependencies,\n    TPrivateServices,\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const newBaseBuilder = this.#baseBuilder.providesService<TServiceName, TService>(\n      serviceName,\n      fn,\n    );\n\n    return new DatabaseFragmentDefinitionBuilder(\n      newBaseBuilder,\n      this.#schema,\n      this.#namespace,\n      this.#hooksFactory,\n    );\n  }\n\n  /**\n   * Provide a private service that is only accessible to the fragment author.\n   * Private services are NOT exposed on the fragment instance, but can be used\n   * when defining other services (baseServices, namedServices, and other privateServices).\n   * Private services are instantiated in order, so earlier private services are available\n   * to later ones.\n   */\n  providesPrivateService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    fn: ServiceConstructorFn<\n      TConfig,\n      FragnoPublicConfigWithDatabase,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TService,\n      TServiceThisContext\n    >,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices & { [K in TServiceName]: TService },\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const newBaseBuilder = this.#baseBuilder.providesPrivateService<TServiceName, TService>(\n      serviceName,\n      fn,\n    );\n\n    return new DatabaseFragmentDefinitionBuilder(\n      newBaseBuilder,\n      this.#schema,\n      this.#namespace,\n      this.#hooksFactory,\n    );\n  }\n\n  /**\n   * Define durable hooks for this fragment.\n   * Hooks are automatically persisted and retried on failure.\n   *\n   * @param fn - Function that receives defineHook helper and returns a hooks map\n   * @returns Builder with hooks type set\n   *\n   * @example\n   * ```ts\n   * .provideHooks(({ defineHook, config }) => ({\n   *   onSubscribe: defineHook(async function (payload: { email: string }) {\n   *     // 'this' context available (HookServiceContext with idempotencyKey)\n   *     await config.onSubscribe?.(payload.email);\n   *   }),\n   * }))\n   * ```\n   */\n  provideHooks<TNewHooks extends HooksMap>(\n    fn: (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n      defineHook: <TPayload>(\n        hook: (this: HookContext, payload: TPayload) => void | Promise<void>,\n      ) => HookFn<TPayload>;\n    }) => TNewHooks,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TNewHooks,\n    DatabaseServiceContext<TNewHooks>,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const defineHook = <TPayload>(\n      hook: (this: HookContext, payload: TPayload) => void | Promise<void>,\n    ): HookFn<TPayload> => {\n      return hook;\n    };\n\n    // Store the hooks factory - it will be called in build() with config/options\n    const hooksFactory = (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n    }) => {\n      return fn({\n        config: context.config,\n        options: context.options,\n        defineHook,\n      });\n    };\n\n    // Create new builder with hooks factory stored\n    // Cast is safe: we're only changing THooks and TServiceThisContext type parameters\n    const newBuilder = new DatabaseFragmentDefinitionBuilder(\n      this.#baseBuilder,\n      this.#schema,\n      this.#namespace,\n    ) as unknown as DatabaseFragmentDefinitionBuilder<\n      TSchema,\n      TConfig,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies,\n      TPrivateServices,\n      TNewHooks,\n      DatabaseServiceContext<TNewHooks>,\n      THandlerThisContext,\n      TLinkedFragments\n    >;\n\n    newBuilder.#hooksFactory = hooksFactory;\n\n    return newBuilder;\n  }\n\n  /**\n   * Declare that this fragment uses a required service provided by the runtime.\n   * Delegates to the base builder.\n   */\n  usesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies & { [K in TServiceName]: TService },\n    TPrivateServices,\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const newBaseBuilder = this.#baseBuilder.usesService<TServiceName, TService>(serviceName);\n\n    return new DatabaseFragmentDefinitionBuilder(\n      newBaseBuilder,\n      this.#schema,\n      this.#namespace,\n      this.#hooksFactory,\n    );\n  }\n\n  /**\n   * Declare that this fragment uses an optional service provided by the runtime.\n   * Delegates to the base builder.\n   */\n  usesOptionalService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies & { [K in TServiceName]: TService | undefined },\n    TPrivateServices,\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const newBaseBuilder = this.#baseBuilder.usesOptionalService<TServiceName, TService>(\n      serviceName,\n    );\n\n    return new DatabaseFragmentDefinitionBuilder(\n      newBaseBuilder,\n      this.#schema,\n      this.#namespace,\n      this.#hooksFactory,\n    );\n  }\n\n  /**\n   * Build the final database fragment definition.\n   * This includes the request context setup for UnitOfWork management.\n   * Note: TDeps already includes ImplicitDatabaseDependencies from withDatabase().\n   */\n  build(): FragmentDefinition<\n    TConfig,\n    FragnoPublicConfigWithDatabase,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    DatabaseServiceContext<THooks>,\n    DatabaseHandlerContext<THooks>,\n    DatabaseRequestStorage,\n    TLinkedFragments\n  > {\n    const baseDef = this.#baseBuilder.build();\n\n    // Ensure dependencies callback always exists for database fragments\n    // If no user dependencies were defined, create a minimal one that only adds implicit deps\n    const dependencies = (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n    }): TDeps => {\n      // In dry run mode, allow user deps to fail gracefully.\n      // This is critical for database fragments because the CLI needs access to the schema\n      // even when user dependencies (like API clients) can't be initialized.\n      // Without this, if user deps fail, we'd lose the implicit database dependencies\n      // (including schema), and the CLI couldn't extract schema information.\n      let userDeps;\n      try {\n        userDeps = baseDef.dependencies?.(context);\n      } catch (error) {\n        if (process.env[\"FRAGNO_INIT_DRY_RUN\"] === \"true\") {\n          console.warn(\n            \"Warning: Failed to initialize user dependencies in dry run mode:\",\n            error instanceof Error ? error.message : String(error),\n          );\n          userDeps = {};\n        } else {\n          throw error;\n        }\n      }\n\n      const { db } = createDatabaseContext(context.options, this.#schema, this.#namespace);\n\n      const implicitDeps: ImplicitDatabaseDependencies<TSchema> = {\n        db,\n        schema: this.#schema,\n        namespace: this.#namespace,\n        createUnitOfWork: () => db.createUnitOfWork(),\n      };\n\n      return {\n        ...userDeps,\n        ...implicitDeps,\n      } as TDeps;\n    };\n\n    // Use the adapter's shared context storage (all fragments using the same adapter share this storage)\n    const builderWithExternalStorage = this.#baseBuilder.withExternalRequestStorage(\n      ({ options }) => {\n        const dbContext = createDatabaseContext(options, this.#schema, this.#namespace);\n        return dbContext.databaseAdapter.contextStorage;\n      },\n    );\n\n    // Set up request storage to initialize the Unit of Work\n    const builderWithStorage = builderWithExternalStorage.withRequestStorage(\n      ({ options }): DatabaseRequestStorage => {\n        // Create database context - needed here to create the UOW\n        const dbContextForStorage = createDatabaseContext(options, this.#schema, this.#namespace);\n\n        // Create a new Unit of Work for this request\n        const uow: IUnitOfWork = dbContextForStorage.db.createUnitOfWork();\n\n        return { uow };\n      },\n    );\n\n    // Get the internal fragment factory from linked fragments (added by withDatabase)\n    // Cast is safe: withDatabase() guarantees this fragment exists and has the correct type\n    const internalFragmentFactory = baseDef.linkedFragments?.[\"_fragno_internal\"] as (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n    }) => InternalFragmentInstance;\n\n    const builderWithContext = builderWithStorage.withThisContext<\n      DatabaseServiceContext<THooks>,\n      DatabaseHandlerContext<THooks>\n    >(({ storage, config, options }) => {\n      // Create hooks config if hooks factory is defined\n      const hooksConfig = this.#hooksFactory\n        ? {\n            hooks: this.#hooksFactory({ config, options }),\n            namespace: this.#namespace,\n            internalFragment: internalFragmentFactory({ config, options }),\n          }\n        : undefined;\n\n      // Builder API: serviceTx using createServiceTxBuilder\n      function serviceTx<TSchema extends AnySchema>(schema: TSchema) {\n        const uow = storage.getStore()?.uow;\n        if (!uow) {\n          throw new Error(\n            \"No UnitOfWork in context. Service must be called within a route handler OR using `withUnitOfWork`.\",\n          );\n        }\n        return createServiceTxBuilder<TSchema, THooks>(schema, uow, hooksConfig?.hooks);\n      }\n\n      const serviceContext: DatabaseServiceContext<THooks> = {\n        serviceTx,\n      };\n\n      // Builder API: handlerTx using createHandlerTxBuilder\n      function handlerTx(execOptions?: Omit<ExecuteTxOptions, \"createUnitOfWork\">) {\n        const currentStorage = storage.getStore();\n        if (!currentStorage) {\n          throw new Error(\n            \"No storage in context. Handler must be called within a request context.\",\n          );\n        }\n\n        const userOnBeforeMutate = execOptions?.onBeforeMutate;\n        const userOnAfterMutate = execOptions?.onAfterMutate;\n\n        return createHandlerTxBuilder<THooks>({\n          ...execOptions,\n          createUnitOfWork: () => {\n            currentStorage.uow.reset();\n            if (hooksConfig) {\n              currentStorage.uow.registerSchema(\n                hooksConfig.internalFragment.$internal.deps.schema,\n                hooksConfig.internalFragment.$internal.deps.namespace,\n              );\n            }\n            return currentStorage.uow;\n          },\n          onBeforeMutate: (uow) => {\n            if (hooksConfig) {\n              prepareHookMutations(uow, hooksConfig);\n            }\n            if (userOnBeforeMutate) {\n              userOnBeforeMutate(uow);\n            }\n          },\n          onAfterMutate: async (uow) => {\n            if (hooksConfig) {\n              await processHooks(hooksConfig);\n            }\n            if (userOnAfterMutate) {\n              await userOnAfterMutate(uow);\n            }\n          },\n        });\n      }\n\n      const handlerContext: DatabaseHandlerContext<THooks> = {\n        handlerTx,\n      };\n\n      return { serviceContext, handlerContext };\n    });\n\n    // Build the final definition\n    const finalDef = builderWithContext.build();\n\n    // Return the complete definition with proper typing and dependencies\n    return {\n      ...finalDef,\n      dependencies,\n    };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"db-fragment-definition-builder.js","names":["#baseBuilder","#schema","#hooksFactory","implicitDeps: ImplicitDatabaseDependencies<TSchema>","hooksConfig: HookProcessorConfig<THooks>","serviceContext: DatabaseServiceContext<THooks>"],"sources":["../src/db-fragment-definition-builder.ts"],"sourcesContent":["import type { AnySchema } from \"./schema/create\";\nimport type { SimpleQueryInterface } from \"./query/simple-query-interface\";\nimport type { DatabaseAdapter } from \"./adapters/adapters\";\nimport type { IUnitOfWork } from \"./query/unit-of-work/unit-of-work\";\nimport type {\n  RequestThisContext,\n  FragnoPublicConfig,\n  AnyFragnoInstantiatedFragment,\n} from \"@fragno-dev/core\";\nimport {\n  FragmentDefinitionBuilder,\n  type FragmentDefinition,\n  type ServiceConstructorFn,\n} from \"@fragno-dev/core\";\nimport {\n  createServiceTxBuilder,\n  createHandlerTxBuilder,\n  ServiceTxBuilder,\n  HandlerTxBuilder,\n  type ExecuteTxOptions,\n} from \"./query/unit-of-work/execute-unit-of-work\";\nimport {\n  prepareHookMutations,\n  type HooksMap,\n  type HookFn,\n  type HookContext,\n  type HookProcessorConfig,\n  type DurableHooksProcessingOptions,\n  createHookScheduler,\n} from \"./hooks/hooks\";\nimport type { InternalFragmentInstance } from \"./fragments/internal-fragment\";\nimport { resolveDatabaseAdapter } from \"./util/default-database-adapter\";\nimport { sanitizeNamespace } from \"./naming/sql-naming\";\n\n/**\n * Extended FragnoPublicConfig for database fragments.\n * If databaseAdapter is omitted and better-sqlite3 is available, a default SQLite adapter is used.\n */\nexport type FragnoPublicConfigWithDatabase = FragnoPublicConfig & {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  databaseAdapter?: DatabaseAdapter<any>;\n  /**\n   * Optional durable hooks processing configuration.\n   */\n  durableHooks?: DurableHooksProcessingOptions;\n  /**\n   * Optional override for database namespace. If provided (including null), it is used as-is\n   * without sanitization — the caller is responsible for providing a valid namespace.\n   * When omitted, defaults to a sanitized version of schema.name.\n   */\n  databaseNamespace?: string | null;\n};\n\n/**\n * Implicit dependencies that database fragments get automatically.\n * These are injected without requiring explicit configuration.\n */\nexport type ImplicitDatabaseDependencies<TSchema extends AnySchema> = {\n  /**\n   * Database query engine for the fragment's schema.\n   * @deprecated Prefer handlerTx/serviceTx instead of direct db usage.\n   */\n  db: SimpleQueryInterface<TSchema>;\n  /**\n   * The schema definition for this fragment.\n   */\n  schema: TSchema;\n  /**\n   * The database namespace for this fragment.\n   */\n  namespace: string | null;\n  /**\n   * Create a new Unit of Work for database operations.\n   */\n  createUnitOfWork: () => IUnitOfWork;\n};\n\n/**\n * Service context for database fragments - provides restricted UOW access without execute methods.\n */\nexport type DatabaseServiceContext<THooks extends HooksMap> = RequestThisContext & {\n  /**\n   * Create a service-level transaction builder using the fluent API.\n   * Returns a builder that can be chained with withServiceCalls, retrieve,\n   * transformRetrieve, mutate, transform, and build.\n   *\n   * @example\n   * ```ts\n   * return this.serviceTx(schema)\n   *   .withServiceCalls(() => [otherService.getData()])\n   *   .retrieve((uow) => uow.find(\"users\", ...))\n   *   .transformRetrieve(([users]) => users[0])\n   *   .mutate(({ uow, retrieveResult, serviceIntermediateResult }) =>\n   *     uow.create(\"records\", { ... })\n   *   )\n   *   .transform(({ mutateResult, serviceResult }) => ({ id: mutateResult }))\n   *   .build();\n   * ```\n   */\n  serviceTx<TSchema extends AnySchema>(\n    schema: TSchema,\n  ): ServiceTxBuilder<\n    TSchema,\n    readonly [],\n    [],\n    [],\n    unknown,\n    unknown,\n    false,\n    false,\n    false,\n    false,\n    THooks\n  >;\n};\n\n/**\n * Handler context for database fragments - provides UOW execution with automatic retry support.\n */\nexport type DatabaseHandlerContext<THooks extends HooksMap = {}> = RequestThisContext & {\n  /**\n   * Create a handler-level transaction builder using the fluent API.\n   * Returns a builder that can be chained with withServiceCalls, retrieve,\n   * transformRetrieve, mutate, transform, and execute.\n   *\n   * @example\n   * ```ts\n   * const result = await this.handlerTx()\n   *   .withServiceCalls(() => [userService.getUser(id)])\n   *   .mutate(({ forSchema, idempotencyKey, currentAttempt, serviceIntermediateResult }) => {\n   *     return forSchema(ordersSchema).create(\"orders\", { ... });\n   *   })\n   *   .transform(({ mutateResult, serviceResult }) => ({ ... }))\n   *   .execute();\n   * ```\n   */\n  handlerTx(\n    options?: Omit<ExecuteTxOptions, \"createUnitOfWork\">,\n  ): HandlerTxBuilder<readonly [], [], [], unknown, unknown, false, false, false, false, THooks>;\n};\n\n/**\n * Database fragment context provided to user callbacks.\n */\nexport type DatabaseFragmentContext<TSchema extends AnySchema> = {\n  /**\n   * Database adapter instance.\n   */\n  databaseAdapter: DatabaseAdapter<any>; // eslint-disable-line @typescript-eslint/no-explicit-any\n  /**\n   * ORM query engine for the fragment's schema.\n   */\n  db: SimpleQueryInterface<TSchema>;\n};\n\n/**\n * Create database context from options.\n * This extracts the database adapter and creates the ORM instance.\n */\nfunction createDatabaseContext<TSchema extends AnySchema>(\n  options: FragnoPublicConfigWithDatabase,\n  schema: TSchema,\n): DatabaseFragmentContext<TSchema> {\n  const databaseAdapter = resolveDatabaseAdapter(options, schema);\n\n  const namespace = resolveDatabaseNamespace(options, schema);\n  const db = databaseAdapter.createQueryEngine(schema, namespace);\n\n  return { databaseAdapter, db };\n}\n\nfunction resolveDatabaseNamespace<TSchema extends AnySchema>(\n  options: FragnoPublicConfigWithDatabase,\n  schema: TSchema,\n): string | null {\n  const hasOverride = options.databaseNamespace !== undefined;\n  return hasOverride ? (options.databaseNamespace ?? null) : sanitizeNamespace(schema.name);\n}\n\n/**\n * Storage type for database fragments - stores the Unit of Work.\n */\nexport type DatabaseRequestStorage = {\n  uow: IUnitOfWork;\n};\n\n/**\n * Builder for database fragments that wraps the core fragment builder\n * and provides database-specific functionality.\n *\n * Database fragments use FragnoPublicConfigWithDatabase and default the adapter when possible.\n */\nexport class DatabaseFragmentDefinitionBuilder<\n  TSchema extends AnySchema,\n  TConfig,\n  TDeps,\n  TBaseServices,\n  TServices,\n  TServiceDependencies,\n  TPrivateServices,\n  THooks extends HooksMap = {},\n  TServiceThisContext extends RequestThisContext = DatabaseHandlerContext,\n  THandlerThisContext extends RequestThisContext = DatabaseHandlerContext,\n  TLinkedFragments extends Record<string, AnyFragnoInstantiatedFragment> = {},\n> {\n  // Store the base builder - we'll replace its storage and context setup when building\n  #baseBuilder: FragmentDefinitionBuilder<\n    TConfig,\n    FragnoPublicConfigWithDatabase,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    DatabaseRequestStorage,\n    TLinkedFragments\n  >;\n  #schema: TSchema;\n  #hooksFactory?: (context: { config: TConfig; options: FragnoPublicConfigWithDatabase }) => THooks;\n\n  constructor(\n    baseBuilder: FragmentDefinitionBuilder<\n      TConfig,\n      FragnoPublicConfigWithDatabase,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies,\n      TPrivateServices,\n      TServiceThisContext,\n      THandlerThisContext,\n      DatabaseRequestStorage,\n      TLinkedFragments\n    >,\n    schema: TSchema,\n    hooksFactory?: (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n    }) => THooks,\n  ) {\n    this.#baseBuilder = baseBuilder;\n    this.#schema = schema;\n    this.#hooksFactory = hooksFactory;\n  }\n\n  /**\n   * Define dependencies for this database fragment.\n   * The context includes database adapter and ORM instance.\n   */\n  withDependencies<TNewDeps>(\n    fn: (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n      db: SimpleQueryInterface<TSchema>;\n      databaseAdapter: DatabaseAdapter<any>; // eslint-disable-line @typescript-eslint/no-explicit-any\n    }) => TNewDeps,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TNewDeps & ImplicitDatabaseDependencies<TSchema>,\n    {},\n    {},\n    TServiceDependencies,\n    {},\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    // Wrap user function to inject DB context\n    const wrappedFn = (context: { config: TConfig; options: FragnoPublicConfigWithDatabase }) => {\n      const dbContext = createDatabaseContext(context.options, this.#schema);\n      const namespace = resolveDatabaseNamespace(context.options, this.#schema);\n\n      // Call user function with enriched context\n      const userDeps = fn({\n        config: context.config,\n        options: context.options,\n        db: dbContext.db,\n        databaseAdapter: dbContext.databaseAdapter,\n      });\n\n      // Create implicit dependencies\n      const createUow = () => dbContext.db.createUnitOfWork();\n      const implicitDeps: ImplicitDatabaseDependencies<TSchema> = {\n        db: dbContext.db,\n        schema: this.#schema,\n        namespace,\n        createUnitOfWork: createUow,\n      };\n\n      return {\n        ...userDeps,\n        ...implicitDeps,\n      };\n    };\n\n    // Create new base builder with wrapped function\n    const newBaseBuilder = this.#baseBuilder.withDependencies(wrappedFn);\n\n    return new DatabaseFragmentDefinitionBuilder(newBaseBuilder, this.#schema, this.#hooksFactory);\n  }\n\n  providesBaseService<TNewService>(\n    fn: ServiceConstructorFn<\n      TConfig,\n      FragnoPublicConfigWithDatabase,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TNewService,\n      TServiceThisContext\n    >,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TNewService,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const newBaseBuilder = this.#baseBuilder.providesBaseService<TNewService>(fn);\n\n    return new DatabaseFragmentDefinitionBuilder(newBaseBuilder, this.#schema, this.#hooksFactory);\n  }\n\n  providesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    fn: ServiceConstructorFn<\n      TConfig,\n      FragnoPublicConfigWithDatabase,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TService,\n      TServiceThisContext\n    >,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices & { [K in TServiceName]: TService },\n    TServiceDependencies,\n    TPrivateServices,\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const newBaseBuilder = this.#baseBuilder.providesService<TServiceName, TService>(\n      serviceName,\n      fn,\n    );\n\n    return new DatabaseFragmentDefinitionBuilder(newBaseBuilder, this.#schema, this.#hooksFactory);\n  }\n\n  /**\n   * Provide a private service that is only accessible to the fragment author.\n   * Private services are NOT exposed on the fragment instance, but can be used\n   * when defining other services (baseServices, namedServices, and other privateServices).\n   * Private services are instantiated in order, so earlier private services are available\n   * to later ones.\n   */\n  providesPrivateService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    fn: ServiceConstructorFn<\n      TConfig,\n      FragnoPublicConfigWithDatabase,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TService,\n      TServiceThisContext\n    >,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices & { [K in TServiceName]: TService },\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const newBaseBuilder = this.#baseBuilder.providesPrivateService<TServiceName, TService>(\n      serviceName,\n      fn,\n    );\n\n    return new DatabaseFragmentDefinitionBuilder(newBaseBuilder, this.#schema, this.#hooksFactory);\n  }\n\n  /**\n   * Define durable hooks for this fragment.\n   * Hooks are automatically persisted and retried on failure.\n   *\n   * @param fn - Function that receives defineHook helper and returns a hooks map\n   * @returns Builder with hooks type set\n   *\n   * @example\n   * ```ts\n   * .provideHooks(({ defineHook, config }) => ({\n   *   onSubscribe: defineHook(async function (payload: { email: string }) {\n   *     // 'this' context available (HookServiceContext with idempotencyKey)\n   *     await config.onSubscribe?.(payload.email);\n   *   }),\n   * }))\n   * ```\n   */\n  provideHooks<TNewHooks extends HooksMap>(\n    fn: (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n      defineHook: <TPayload>(\n        hook: (this: HookContext, payload: TPayload) => void | Promise<void>,\n      ) => HookFn<TPayload>;\n    }) => TNewHooks,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TNewHooks,\n    DatabaseServiceContext<TNewHooks>,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const defineHook = <TPayload>(\n      hook: (this: HookContext, payload: TPayload) => void | Promise<void>,\n    ): HookFn<TPayload> => {\n      return hook;\n    };\n\n    // Store the hooks factory - it will be called in build() with config/options\n    const hooksFactory = (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n    }) => {\n      return fn({\n        config: context.config,\n        options: context.options,\n        defineHook,\n      });\n    };\n\n    // Create new builder with hooks factory stored\n    // Cast is safe: we're only changing THooks and TServiceThisContext type parameters\n    const newBuilder = new DatabaseFragmentDefinitionBuilder(\n      this.#baseBuilder,\n      this.#schema,\n    ) as unknown as DatabaseFragmentDefinitionBuilder<\n      TSchema,\n      TConfig,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies,\n      TPrivateServices,\n      TNewHooks,\n      DatabaseServiceContext<TNewHooks>,\n      THandlerThisContext,\n      TLinkedFragments\n    >;\n\n    newBuilder.#hooksFactory = hooksFactory;\n\n    return newBuilder;\n  }\n\n  /**\n   * Declare that this fragment uses a required service provided by the runtime.\n   * Delegates to the base builder.\n   */\n  usesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies & { [K in TServiceName]: TService },\n    TPrivateServices,\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const newBaseBuilder = this.#baseBuilder.usesService<TServiceName, TService>(serviceName);\n\n    return new DatabaseFragmentDefinitionBuilder(newBaseBuilder, this.#schema, this.#hooksFactory);\n  }\n\n  /**\n   * Declare that this fragment uses an optional service provided by the runtime.\n   * Delegates to the base builder.\n   */\n  usesOptionalService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies & { [K in TServiceName]: TService | undefined },\n    TPrivateServices,\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const newBaseBuilder = this.#baseBuilder.usesOptionalService<TServiceName, TService>(\n      serviceName,\n    );\n\n    return new DatabaseFragmentDefinitionBuilder(newBaseBuilder, this.#schema, this.#hooksFactory);\n  }\n\n  /**\n   * Build the final database fragment definition.\n   * This includes the request context setup for UnitOfWork management.\n   * Note: TDeps already includes ImplicitDatabaseDependencies from withDatabase().\n   */\n  build(): FragmentDefinition<\n    TConfig,\n    FragnoPublicConfigWithDatabase,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    DatabaseServiceContext<THooks>,\n    DatabaseHandlerContext<THooks>,\n    DatabaseRequestStorage,\n    TLinkedFragments\n  > {\n    const baseDef = this.#baseBuilder.build();\n\n    // Ensure dependencies callback always exists for database fragments\n    // If no user dependencies were defined, create a minimal one that only adds implicit deps\n    const dependencies = (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n    }): TDeps => {\n      // In dry run mode, allow user deps to fail gracefully.\n      // This is critical for database fragments because the CLI needs access to the schema\n      // even when user dependencies (like API clients) can't be initialized.\n      // Without this, if user deps fail, we'd lose the implicit database dependencies\n      // (including schema), and the CLI couldn't extract schema information.\n      let userDeps;\n      try {\n        userDeps = baseDef.dependencies?.(context);\n      } catch (error) {\n        if (process.env[\"FRAGNO_INIT_DRY_RUN\"] === \"true\") {\n          console.warn(\n            \"Warning: Failed to initialize user dependencies in dry run mode:\",\n            error instanceof Error ? error.message : String(error),\n          );\n          userDeps = {};\n        } else {\n          throw error;\n        }\n      }\n\n      const { db } = createDatabaseContext(context.options, this.#schema);\n      const namespace = resolveDatabaseNamespace(context.options, this.#schema);\n\n      const implicitDeps: ImplicitDatabaseDependencies<TSchema> = {\n        db,\n        schema: this.#schema,\n        namespace,\n        createUnitOfWork: () => db.createUnitOfWork(),\n      };\n\n      return {\n        ...userDeps,\n        ...implicitDeps,\n      } as TDeps;\n    };\n\n    // Use the adapter's shared context storage (all fragments using the same adapter share this storage)\n    const builderWithExternalStorage = this.#baseBuilder.withExternalRequestStorage(\n      ({ options }) => {\n        const dbContext = createDatabaseContext(options, this.#schema);\n        return dbContext.databaseAdapter.contextStorage;\n      },\n    );\n\n    // Set up request storage to initialize the Unit of Work\n    const builderWithStorage = builderWithExternalStorage.withRequestStorage(\n      ({ options }): DatabaseRequestStorage => {\n        // Create database context - needed here to create the UOW\n        const dbContextForStorage = createDatabaseContext(options, this.#schema);\n\n        // Create a new Unit of Work for this request\n        const uow: IUnitOfWork = dbContextForStorage.db.createUnitOfWork();\n\n        return { uow };\n      },\n    );\n\n    // Get the internal fragment factory from linked fragments (added by withDatabase)\n    // Cast is safe: withDatabase() guarantees this fragment exists and has the correct type\n    const internalFragmentFactory = baseDef.linkedFragments?.[\"_fragno_internal\"] as (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n    }) => InternalFragmentInstance;\n\n    // Cache per instantiated fragment (deps object is unique per instantiation).\n    const hooksConfigCache = new WeakMap<object, HookProcessorConfig<THooks>>();\n\n    const createHooksConfig = (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n      deps: TDeps;\n    }) => {\n      if (!this.#hooksFactory) {\n        return undefined;\n      }\n      const depsKey =\n        typeof context.deps === \"object\" && context.deps !== null\n          ? (context.deps as object)\n          : undefined;\n      const cachedHooksConfig = depsKey ? hooksConfigCache.get(depsKey) : undefined;\n      if (cachedHooksConfig) {\n        return cachedHooksConfig;\n      }\n\n      const namespace = resolveDatabaseNamespace(context.options, this.#schema);\n      const namespaceKey = namespace ?? this.#schema.name;\n      const durableHooksOptions = context.options.durableHooks;\n      const baseAdapter = resolveDatabaseAdapter(context.options, this.#schema);\n      const hookAdapter = baseAdapter.getHookProcessingAdapter?.() ?? baseAdapter;\n      const hookOptions =\n        hookAdapter === baseAdapter\n          ? context.options\n          : { ...context.options, databaseAdapter: hookAdapter };\n      const dbContextForHooks = createDatabaseContext(hookOptions, this.#schema);\n      const hooksConfig: HookProcessorConfig<THooks> = {\n        hooks: this.#hooksFactory(context),\n        namespace: namespaceKey,\n        internalFragment: internalFragmentFactory({\n          config: context.config,\n          options: hookOptions,\n        }),\n        handlerTx: (execOptions?: Omit<ExecuteTxOptions, \"createUnitOfWork\">) => {\n          const userOnBeforeMutate = execOptions?.onBeforeMutate;\n          const userOnAfterMutate = execOptions?.onAfterMutate;\n          return createHandlerTxBuilder<THooks>({\n            ...execOptions,\n            createUnitOfWork: () => {\n              const uow = dbContextForHooks.db.createUnitOfWork();\n              uow.registerSchema(\n                hooksConfig.internalFragment.$internal.deps.schema,\n                hooksConfig.internalFragment.$internal.deps.namespace,\n              );\n              return uow;\n            },\n            onBeforeMutate: (uow) => {\n              prepareHookMutations(uow, hooksConfig);\n              if (userOnBeforeMutate) {\n                userOnBeforeMutate(uow);\n              }\n            },\n            onAfterMutate: async (uow) => {\n              void hooksConfig.scheduler?.schedule().catch((error) => {\n                console.error(\"Durable hooks processing failed\", error);\n              });\n              if (userOnAfterMutate) {\n                await userOnAfterMutate(uow);\n              }\n            },\n          });\n        },\n        stuckProcessingTimeoutMinutes: durableHooksOptions?.stuckProcessingTimeoutMinutes,\n        onStuckProcessingHooks: durableHooksOptions?.onStuckProcessingHooks,\n      };\n      hooksConfig.scheduler = createHookScheduler(hooksConfig);\n      if (depsKey) {\n        hooksConfigCache.set(depsKey, hooksConfig);\n      }\n      return hooksConfig;\n    };\n\n    const builderWithContext = builderWithStorage.withThisContext<\n      DatabaseServiceContext<THooks>,\n      DatabaseHandlerContext<THooks>\n    >(({ storage, config, options, deps }) => {\n      // Create hooks config if hooks factory is defined\n      const hooksConfig = createHooksConfig({ config, options, deps });\n      const internalFragment =\n        hooksConfig?.internalFragment ??\n        (internalFragmentFactory ? internalFragmentFactory({ config, options }) : undefined);\n\n      // Builder API: serviceTx using createServiceTxBuilder\n      function serviceTx<TSchema extends AnySchema>(schema: TSchema) {\n        const uow = storage.getStore()?.uow;\n        if (!uow) {\n          throw new Error(\n            \"No UnitOfWork in context. Service must be called within a route handler OR using `withUnitOfWork`.\",\n          );\n        }\n        return createServiceTxBuilder<TSchema, THooks>(schema, uow, hooksConfig?.hooks);\n      }\n\n      const serviceContext: DatabaseServiceContext<THooks> = {\n        serviceTx,\n      };\n\n      // Builder API: handlerTx using createHandlerTxBuilder\n      function handlerTx(execOptions?: Omit<ExecuteTxOptions, \"createUnitOfWork\">) {\n        const currentStorage = storage.getStore();\n        if (!currentStorage) {\n          throw new Error(\n            \"No storage in context. Handler must be called within a request context.\",\n          );\n        }\n\n        const userOnBeforeMutate = execOptions?.onBeforeMutate;\n        const userOnAfterMutate = execOptions?.onAfterMutate;\n\n        return createHandlerTxBuilder<THooks>({\n          ...execOptions,\n          createUnitOfWork: () => {\n            currentStorage.uow.reset();\n            if (internalFragment) {\n              currentStorage.uow.registerSchema(\n                internalFragment.$internal.deps.schema,\n                internalFragment.$internal.deps.namespace,\n              );\n            }\n            return currentStorage.uow;\n          },\n          onBeforeMutate: (uow) => {\n            if (hooksConfig) {\n              prepareHookMutations(uow, hooksConfig);\n            }\n            if (userOnBeforeMutate) {\n              userOnBeforeMutate(uow);\n            }\n          },\n          onAfterMutate: async (uow) => {\n            if (hooksConfig?.scheduler) {\n              void hooksConfig.scheduler.schedule().catch((error) => {\n                console.error(\"Durable hooks processing failed\", error);\n              });\n            }\n            if (userOnAfterMutate) {\n              await userOnAfterMutate(uow);\n            }\n          },\n        });\n      }\n\n      const handlerContext: DatabaseHandlerContext<THooks> = {\n        handlerTx,\n      };\n\n      return { serviceContext, handlerContext };\n    });\n\n    // Build the final definition\n    const finalDef = builderWithContext.build();\n    if (this.#hooksFactory) {\n      finalDef.internalDataFactory = ({ config, options, deps }) => ({\n        durableHooks: createHooksConfig({\n          config: config as TConfig,\n          options: options as FragnoPublicConfigWithDatabase,\n          deps: deps as TDeps,\n        }),\n      });\n    }\n\n    // Return the complete definition with proper typing and dependencies\n    return {\n      ...finalDef,\n      dependencies,\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/dispatchers/cloudflare-do/index.d.ts

@@ -0,0 +1,26 @@
+import { DurableHooksProcessor } from "../../hooks/durable-hooks-processor.js";
+
+//#region src/dispatchers/cloudflare-do/index.d.ts
+type AlarmStorage = {
+  setAlarm?: (timestamp: number | Date) => Promise<void>;
+  deleteAlarm?: () => Promise<void>;
+};
+type DurableHooksDispatcherDurableObjectState = {
+  readonly storage: AlarmStorage;
+};
+type DurableHooksDispatcherDurableObjectHandler = {
+  fetch?: (request: Request) => Promise<Response>;
+  alarm?: () => Promise<void>;
+};
+type DurableHooksDispatcherDurableObjectFactory<TEnv = unknown> = (state: DurableHooksDispatcherDurableObjectState, env: TEnv) => DurableHooksDispatcherDurableObjectHandler;
+type DurableHooksDispatcherDurableObjectOptions<TEnv = unknown> = {
+  createProcessor: (context: {
+    state: DurableHooksDispatcherDurableObjectState;
+    env: TEnv;
+  }) => DurableHooksProcessor;
+  onProcessError?: (error: unknown) => void;
+};
+declare function createDurableHooksDispatcherDurableObject<TEnv>(options: DurableHooksDispatcherDurableObjectOptions<TEnv>): DurableHooksDispatcherDurableObjectFactory<TEnv>;
+//#endregion
+export { DurableHooksDispatcherDurableObjectFactory, DurableHooksDispatcherDurableObjectHandler, DurableHooksDispatcherDurableObjectOptions, DurableHooksDispatcherDurableObjectState, createDurableHooksDispatcherDurableObject };
+//# sourceMappingURL=index.d.ts.map

package/dist/dispatchers/cloudflare-do/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/dispatchers/cloudflare-do/index.ts"],"sourcesContent":[],"mappings":";;;KAEK,YAAA;kCAC6B,SAAS;EADtC,WAAA,CAAA,EAAA,GAAY,GAEK,OAFL,CAAA,IAAA,CAAA;CACiB;AAAS,KAI/B,wCAAA,GAJ+B;EACrB,SAAA,OAAA,EAIF,YAJE;CAAO;AAGjB,KAIA,0CAAA,GAJwC;EAIxC,KAAA,CAAA,EAAA,CAAA,OAAA,EACQ,OADR,EAAA,GACoB,OADpB,CAC4B,QADc,CAAA;EAClC,KAAA,CAAA,EAAA,GAAA,GACJ,OADI,CAAA,IAAA,CAAA;CAAoB;AAAR,KAIpB,0CAJoB,CAAA,OAAA,OAAA,CAAA,GAAA,CAAA,KAAA,EAKvB,wCALuB,EAAA,GAAA,EAMzB,IANyB,EAAA,GAO3B,0CAP2B;AAChB,KAQJ,0CARI,CAAA,OAAA,OAAA,CAAA,GAAA;EAAO,eAAA,EAAA,CAAA,OAAA,EAAA;IAGX,KAAA,EAOD,wCAP2C;IAC7C,GAAA,EAOA,IAPA;EACF,CAAA,EAAA,GAOC,qBAPD;EACF,cAAA,CAAA,EAAA,CAAA,KAAA,EAAA,OAAA,EAAA,GAAA,IAAA;CAA0C;AAEnC,iBAQI,yCARsC,CAAA,IAAA,CAAA,CAAA,OAAA,EAS3C,0CAT2C,CASA,IATA,CAAA,CAAA,EAUnD,0CAVmD,CAUR,IAVQ,CAAA"}

package/dist/dispatchers/cloudflare-do/index.js

@@ -0,0 +1,63 @@
+//#region src/dispatchers/cloudflare-do/index.ts
+function createDurableHooksDispatcherDurableObject(options) {
+	return (state, env) => {
+		const processor = options.createProcessor({
+			state,
+			env
+		});
+		const onProcessError = options.onProcessError ?? ((error) => {
+			console.error("Durable hooks dispatcher error", error);
+		});
+		const rawSetAlarm = state.storage.setAlarm;
+		const rawDeleteAlarm = state.storage.deleteAlarm;
+		if (!rawSetAlarm) throw new Error("Durable hooks dispatcher requires state.storage.setAlarm to schedule alarms.");
+		const setAlarm = rawSetAlarm.bind(state.storage);
+		const deleteAlarm = rawDeleteAlarm?.bind(state.storage);
+		let processing = false;
+		let queued = false;
+		let currentPromise;
+		const runProcess = () => {
+			if (processing) {
+				queued = true;
+				return currentPromise ?? Promise.resolve();
+			}
+			processing = true;
+			currentPromise = (async () => {
+				do {
+					queued = false;
+					try {
+						await processor.process();
+					} catch (error) {
+						onProcessError(error);
+					}
+				} while (queued);
+				processing = false;
+			})();
+			return currentPromise;
+		};
+		const scheduleNextAlarm = async () => {
+			const nextWakeAt = await processor.getNextWakeAt();
+			if (!nextWakeAt) {
+				await deleteAlarm?.();
+				return;
+			}
+			const now = Date.now();
+			await setAlarm(new Date(Math.max(nextWakeAt.getTime(), now)));
+		};
+		scheduleNextAlarm().catch((error) => {
+			onProcessError(error);
+		});
+		return { alarm: async () => {
+			try {
+				await runProcess();
+				await scheduleNextAlarm();
+			} catch (error) {
+				onProcessError(error);
+			}
+		} };
+	};
+}
+
+//#endregion
+export { createDurableHooksDispatcherDurableObject };
+//# sourceMappingURL=index.js.map

package/dist/dispatchers/cloudflare-do/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["currentPromise: Promise<void> | undefined"],"sources":["../../../src/dispatchers/cloudflare-do/index.ts"],"sourcesContent":["import type { DurableHooksProcessor } from \"../../hooks/durable-hooks-processor\";\n\ntype AlarmStorage = {\n  setAlarm?: (timestamp: number | Date) => Promise<void>;\n  deleteAlarm?: () => Promise<void>;\n};\n\nexport type DurableHooksDispatcherDurableObjectState = {\n  readonly storage: AlarmStorage;\n};\n\nexport type DurableHooksDispatcherDurableObjectHandler = {\n  fetch?: (request: Request) => Promise<Response>;\n  alarm?: () => Promise<void>;\n};\n\nexport type DurableHooksDispatcherDurableObjectFactory<TEnv = unknown> = (\n  state: DurableHooksDispatcherDurableObjectState,\n  env: TEnv,\n) => DurableHooksDispatcherDurableObjectHandler;\n\nexport type DurableHooksDispatcherDurableObjectOptions<TEnv = unknown> = {\n  createProcessor: (context: {\n    state: DurableHooksDispatcherDurableObjectState;\n    env: TEnv;\n  }) => DurableHooksProcessor;\n  onProcessError?: (error: unknown) => void;\n};\n\nexport function createDurableHooksDispatcherDurableObject<TEnv>(\n  options: DurableHooksDispatcherDurableObjectOptions<TEnv>,\n): DurableHooksDispatcherDurableObjectFactory<TEnv> {\n  return (state, env) => {\n    const processor = options.createProcessor({ state, env });\n    const onProcessError =\n      options.onProcessError ??\n      ((error: unknown) => {\n        console.error(\"Durable hooks dispatcher error\", error);\n      });\n    const rawSetAlarm = state.storage.setAlarm;\n    const rawDeleteAlarm = state.storage.deleteAlarm;\n\n    if (!rawSetAlarm) {\n      throw new Error(\n        \"Durable hooks dispatcher requires state.storage.setAlarm to schedule alarms.\",\n      );\n    }\n    const setAlarm = rawSetAlarm.bind(state.storage);\n    const deleteAlarm = rawDeleteAlarm?.bind(state.storage);\n\n    let processing = false;\n    let queued = false;\n    let currentPromise: Promise<void> | undefined;\n\n    const runProcess = () => {\n      if (processing) {\n        queued = true;\n        return currentPromise ?? Promise.resolve();\n      }\n\n      processing = true;\n      currentPromise = (async () => {\n        do {\n          queued = false;\n          try {\n            await processor.process();\n          } catch (error) {\n            onProcessError(error);\n          }\n        } while (queued);\n        processing = false;\n      })();\n\n      return currentPromise;\n    };\n\n    const scheduleNextAlarm = async () => {\n      const nextWakeAt = await processor.getNextWakeAt();\n      if (!nextWakeAt) {\n        await deleteAlarm?.();\n        return;\n      }\n\n      const now = Date.now();\n      const scheduledAt = new Date(Math.max(nextWakeAt.getTime(), now));\n      await setAlarm(scheduledAt);\n    };\n\n    void scheduleNextAlarm().catch((error) => {\n      onProcessError(error);\n    });\n\n    return {\n      alarm: async () => {\n        try {\n          await runProcess();\n          await scheduleNextAlarm();\n        } catch (error) {\n          onProcessError(error);\n        }\n      },\n    };\n  };\n}\n"],"mappings":";AA6BA,SAAgB,0CACd,SACkD;AAClD,SAAQ,OAAO,QAAQ;EACrB,MAAM,YAAY,QAAQ,gBAAgB;GAAE;GAAO;GAAK,CAAC;EACzD,MAAM,iBACJ,QAAQ,oBACN,UAAmB;AACnB,WAAQ,MAAM,kCAAkC,MAAM;;EAE1D,MAAM,cAAc,MAAM,QAAQ;EAClC,MAAM,iBAAiB,MAAM,QAAQ;AAErC,MAAI,CAAC,YACH,OAAM,IAAI,MACR,+EACD;EAEH,MAAM,WAAW,YAAY,KAAK,MAAM,QAAQ;EAChD,MAAM,cAAc,gBAAgB,KAAK,MAAM,QAAQ;EAEvD,IAAI,aAAa;EACjB,IAAI,SAAS;EACb,IAAIA;EAEJ,MAAM,mBAAmB;AACvB,OAAI,YAAY;AACd,aAAS;AACT,WAAO,kBAAkB,QAAQ,SAAS;;AAG5C,gBAAa;AACb,qBAAkB,YAAY;AAC5B,OAAG;AACD,cAAS;AACT,SAAI;AACF,YAAM,UAAU,SAAS;cAClB,OAAO;AACd,qBAAe,MAAM;;aAEhB;AACT,iBAAa;OACX;AAEJ,UAAO;;EAGT,MAAM,oBAAoB,YAAY;GACpC,MAAM,aAAa,MAAM,UAAU,eAAe;AAClD,OAAI,CAAC,YAAY;AACf,UAAM,eAAe;AACrB;;GAGF,MAAM,MAAM,KAAK,KAAK;AAEtB,SAAM,SADc,IAAI,KAAK,KAAK,IAAI,WAAW,SAAS,EAAE,IAAI,CAAC,CACtC;;AAG7B,EAAK,mBAAmB,CAAC,OAAO,UAAU;AACxC,kBAAe,MAAM;IACrB;AAEF,SAAO,EACL,OAAO,YAAY;AACjB,OAAI;AACF,UAAM,YAAY;AAClB,UAAM,mBAAmB;YAClB,OAAO;AACd,mBAAe,MAAM;;KAG1B"}

package/dist/dispatchers/node/index.d.ts

@@ -0,0 +1,17 @@
+import { DurableHooksProcessor } from "../../hooks/durable-hooks-processor.js";
+
+//#region src/dispatchers/node/index.d.ts
+type DurableHooksDispatcher = {
+  wake: () => Promise<void>;
+  startPolling: () => void;
+  stopPolling: () => void;
+};
+type DurableHooksDispatcherOptions = {
+  processor: DurableHooksProcessor;
+  pollIntervalMs?: number;
+  onError?: (error: unknown) => void;
+};
+declare function createDurableHooksDispatcher(options: DurableHooksDispatcherOptions): DurableHooksDispatcher;
+//#endregion
+export { DurableHooksDispatcher, DurableHooksDispatcherOptions, createDurableHooksDispatcher };
+//# sourceMappingURL=index.d.ts.map

package/dist/dispatchers/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/dispatchers/node/index.ts"],"sourcesContent":[],"mappings":";;;KAEY,sBAAA;cACE;EADF,YAAA,EAAA,GAAA,GAAA,IAAA;EAMA,WAAA,EAAA,GAAA,GAAA,IAAA;AAMZ,CAAA;KANY,6BAAA;aACC;;;;iBAKG,4BAAA,UACL,gCACR"}

package/dist/dispatchers/node/index.js

@@ -0,0 +1,59 @@
+//#region src/dispatchers/node/index.ts
+function createDurableHooksDispatcher(options) {
+	const pollIntervalMs = options.pollIntervalMs ?? 5e3;
+	const onError = options.onError ?? ((error) => {
+		console.error("Durable hooks dispatcher error", error);
+	});
+	let timer;
+	let processing = false;
+	let queued = false;
+	let currentPromise;
+	const runProcess = () => {
+		if (processing) {
+			queued = true;
+			return currentPromise ?? Promise.resolve();
+		}
+		processing = true;
+		currentPromise = (async () => {
+			do {
+				queued = false;
+				try {
+					await options.processor.process();
+				} catch (error) {
+					onError(error);
+				}
+			} while (queued);
+			processing = false;
+		})();
+		return currentPromise;
+	};
+	const poll = async () => {
+		try {
+			const nextWakeAt = await options.processor.getNextWakeAt();
+			if (!nextWakeAt) return;
+			if (Date.now() >= nextWakeAt.getTime()) await runProcess();
+		} catch (error) {
+			onError(error);
+		}
+	};
+	return {
+		wake: async () => {
+			await runProcess();
+		},
+		startPolling: () => {
+			if (timer) return;
+			timer = setInterval(() => {
+				poll();
+			}, pollIntervalMs);
+		},
+		stopPolling: () => {
+			if (!timer) return;
+			clearInterval(timer);
+			timer = void 0;
+		}
+	};
+}
+
+//#endregion
+export { createDurableHooksDispatcher };
+//# sourceMappingURL=index.js.map

package/dist/dispatchers/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["timer: ReturnType<typeof setInterval> | undefined","currentPromise: Promise<void> | undefined"],"sources":["../../../src/dispatchers/node/index.ts"],"sourcesContent":["import type { DurableHooksProcessor } from \"../../hooks/durable-hooks-processor\";\n\nexport type DurableHooksDispatcher = {\n  wake: () => Promise<void>;\n  startPolling: () => void;\n  stopPolling: () => void;\n};\n\nexport type DurableHooksDispatcherOptions = {\n  processor: DurableHooksProcessor;\n  pollIntervalMs?: number;\n  onError?: (error: unknown) => void;\n};\n\nexport function createDurableHooksDispatcher(\n  options: DurableHooksDispatcherOptions,\n): DurableHooksDispatcher {\n  const pollIntervalMs = options.pollIntervalMs ?? 5000;\n  const onError =\n    options.onError ??\n    ((error: unknown) => {\n      console.error(\"Durable hooks dispatcher error\", error);\n    });\n  let timer: ReturnType<typeof setInterval> | undefined;\n  let processing = false;\n  let queued = false;\n  let currentPromise: Promise<void> | undefined;\n\n  const runProcess = () => {\n    if (processing) {\n      queued = true;\n      return currentPromise ?? Promise.resolve();\n    }\n\n    processing = true;\n    currentPromise = (async () => {\n      do {\n        queued = false;\n        try {\n          await options.processor.process();\n        } catch (error) {\n          onError(error);\n        }\n      } while (queued);\n      processing = false;\n    })();\n\n    return currentPromise;\n  };\n\n  const poll = async () => {\n    try {\n      const nextWakeAt = await options.processor.getNextWakeAt();\n      if (!nextWakeAt) {\n        return;\n      }\n      if (Date.now() >= nextWakeAt.getTime()) {\n        await runProcess();\n      }\n    } catch (error) {\n      onError(error);\n    }\n  };\n\n  return {\n    wake: async () => {\n      await runProcess();\n    },\n    startPolling: () => {\n      if (timer) {\n        return;\n      }\n\n      timer = setInterval(() => {\n        void poll();\n      }, pollIntervalMs);\n    },\n    stopPolling: () => {\n      if (!timer) {\n        return;\n      }\n\n      clearInterval(timer);\n      timer = undefined;\n    },\n  };\n}\n"],"mappings":";AAcA,SAAgB,6BACd,SACwB;CACxB,MAAM,iBAAiB,QAAQ,kBAAkB;CACjD,MAAM,UACJ,QAAQ,aACN,UAAmB;AACnB,UAAQ,MAAM,kCAAkC,MAAM;;CAE1D,IAAIA;CACJ,IAAI,aAAa;CACjB,IAAI,SAAS;CACb,IAAIC;CAEJ,MAAM,mBAAmB;AACvB,MAAI,YAAY;AACd,YAAS;AACT,UAAO,kBAAkB,QAAQ,SAAS;;AAG5C,eAAa;AACb,oBAAkB,YAAY;AAC5B,MAAG;AACD,aAAS;AACT,QAAI;AACF,WAAM,QAAQ,UAAU,SAAS;aAC1B,OAAO;AACd,aAAQ,MAAM;;YAET;AACT,gBAAa;MACX;AAEJ,SAAO;;CAGT,MAAM,OAAO,YAAY;AACvB,MAAI;GACF,MAAM,aAAa,MAAM,QAAQ,UAAU,eAAe;AAC1D,OAAI,CAAC,WACH;AAEF,OAAI,KAAK,KAAK,IAAI,WAAW,SAAS,CACpC,OAAM,YAAY;WAEb,OAAO;AACd,WAAQ,MAAM;;;AAIlB,QAAO;EACL,MAAM,YAAY;AAChB,SAAM,YAAY;;EAEpB,oBAAoB;AAClB,OAAI,MACF;AAGF,WAAQ,kBAAkB;AACxB,IAAK,MAAM;MACV,eAAe;;EAEpB,mBAAmB;AACjB,OAAI,CAAC,MACH;AAGF,iBAAc,MAAM;AACpB,WAAQ;;EAEX"}

package/dist/fragments/internal-fragment.d.ts

@@ -1,13 +1,17 @@
+import { DbNow } from "../query/db-now.js";
 import { AnyColumn, AnyRelation, Column, FragnoId, IdColumn, Index, Schema, Table } from "../schema/create.js";
 import { RetryPolicy } from "../query/unit-of-work/retry-policy.js";
 import { TxResult } from "../query/unit-of-work/execute-unit-of-work.js";
 import { DatabaseHandlerContext, DatabaseRequestStorage, DatabaseServiceContext, FragnoPublicConfigWithDatabase, ImplicitDatabaseDependencies } from "../db-fragment-definition-builder.js";
 import "../mod.js";
+import { internalSchema } from "./internal-fragment.schema.js";
 import * as _fragno_dev_core0 from "@fragno-dev/core";
 import { InstantiatedFragmentFromDefinition } from "@fragno-dev/core";
 
 //#region src/fragments/internal-fragment.d.ts
-declare const internalFragmentDef: _fragno_dev_core0.FragmentDefinition<{}, FragnoPublicConfigWithDatabase, ImplicitDatabaseDependencies<Schema<Record<"fragno_db_settings", Table<Record<string, AnyColumn> & Record<"id", IdColumn<"varchar(30)", string | FragnoId | null, FragnoId>> & Record<"key", Column<"string", string, string>> & Record<"value", Column<"string", string, string>>, Record<string, AnyRelation>, Record<string, Index<AnyColumn[], readonly string[]>> & Record<"unique_key", Index<readonly [Column<"string", string, string>] & AnyColumn[], readonly ["key"]>>>> & Record<"fragno_hooks", Table<Record<string, AnyColumn> & Record<"id", IdColumn<"varchar(30)", string | FragnoId | null, FragnoId>> & Record<"namespace", Column<"string", string, string>> & Record<"hookName", Column<"string", string, string>> & Record<"payload", Column<"json", unknown, unknown>> & Record<"status", Column<"string", string, string>> & Record<"attempts", Column<"integer", number | null, number>> & Record<"maxAttempts", Column<"integer", number | null, number>> & Record<"lastAttemptAt", Column<"timestamp", Date | null, Date | null>> & Record<"nextRetryAt", Column<"timestamp", Date | null, Date | null>> & Record<"error", Column<"string", string | null, string | null>> & Record<"createdAt", Column<"timestamp", Date | null, Date>> & Record<"nonce", Column<"string", string, string>>, Record<string, AnyRelation>, Record<string, Index<AnyColumn[], readonly string[]>> & Record<"idx_namespace_status_retry", Index<readonly [Column<"string", string, string>, Column<"string", string, string>, Column<"timestamp", Date | null, Date | null>] & AnyColumn[], readonly ["namespace", "status", "nextRetryAt"]>> & Record<"idx_nonce", Index<readonly [Column<"string", string, string>] & AnyColumn[], readonly ["nonce"]>>>>>>, {}, {
+declare const internalFragmentDef: _fragno_dev_core0.FragmentDefinition<{}, FragnoPublicConfigWithDatabase, ImplicitDatabaseDependencies<Schema<Record<"fragno_db_settings", Table<Record<string, AnyColumn> & Record<"id", IdColumn<"varchar(30)", string | FragnoId | null, FragnoId>> & Record<"key", Column<"string", string, string>> & Record<"value", Column<"string", string, string>>, Record<string, AnyRelation>, Record<string, Index<AnyColumn[], readonly string[]>> & Record<"unique_key", Index<readonly [Column<"string", string, string>] & AnyColumn[], readonly ["key"]>>>> & Record<"fragno_hooks", Table<Record<string, AnyColumn> & Record<"id", IdColumn<"varchar(30)", string | FragnoId | null, FragnoId>> & Record<"namespace", Column<"string", string, string>> & Record<"hookName", Column<"string", string, string>> & Record<"payload", Column<"json", unknown, unknown>> & Record<"status", Column<"string", string, string>> & Record<"attempts", Column<"integer", number | null, number>> & Record<"maxAttempts", Column<"integer", number | null, number>> & Record<"lastAttemptAt", Column<"timestamp", (DbNow | Date) | null, Date | null>> & Record<"nextRetryAt", Column<"timestamp", (DbNow | Date) | null, Date | null>> & Record<"error", Column<"string", string | null, string | null>> & Record<"createdAt", Column<"timestamp", (DbNow | Date) | null, Date>> & Record<"nonce", Column<"string", string, string>>, Record<string, AnyRelation>, Record<string, Index<AnyColumn[], readonly string[]>> & Record<"idx_namespace_status_retry", Index<readonly [Column<"string", string, string>, Column<"string", string, string>, Column<"timestamp", (DbNow | Date) | null, Date | null>] & AnyColumn[], readonly ["namespace", "status", "nextRetryAt"]>> & Record<"idx_nonce", Index<readonly [Column<"string", string, string>] & AnyColumn[], readonly ["nonce"]>>>> & Record<"fragno_db_outbox", Table<Record<string, AnyColumn> & Record<"id", IdColumn<"varchar(30)", string | FragnoId | null, FragnoId>> & Record<"versionstamp", Column<"string", string, string>> & Record<"uowId", Column<"string", string, string>> & Record<"payload", Column<"json", unknown, unknown>> & Record<"refMap", Column<"json", unknown, unknown>> & Record<"createdAt", Column<"timestamp", (DbNow | Date) | null, Date>>, Record<string, AnyRelation>, Record<string, Index<AnyColumn[], readonly string[]>> & Record<"idx_outbox_versionstamp", Index<readonly [Column<"string", string, string>] & AnyColumn[], readonly ["versionstamp"]>> & Record<"idx_outbox_uow", Index<readonly [Column<"string", string, string>] & AnyColumn[], readonly ["uowId"]>>>>>>, {
+  getDbNow: () => Promise<Date>;
+}, {
   settingsService: {
     /**
      * Get a setting by namespace and key.
@@ -55,6 +59,52 @@ declare const internalFragmentDef: _fragno_dev_core0.FragmentDefinition<{}, Frag
       maxAttempts: number;
       idempotencyKey: string;
     }[]>;
+    /**
+     * Claim pending hook events for processing.
+     * Returns ready events and marks them as processing in the same transaction.
+     */
+    claimPendingHookEvents(namespace: string): TxResult<{
+      id: FragnoId;
+      hookName: string;
+      payload: unknown;
+      attempts: number;
+      maxAttempts: number;
+      idempotencyKey: string;
+    }[], {
+      id: FragnoId;
+      hookName: string;
+      payload: unknown;
+      attempts: number;
+      maxAttempts: number;
+      idempotencyKey: string;
+    }[]>;
+    /**
+     * Re-queue hook events that have been stuck in processing for too long.
+     */
+    requeueStuckProcessingHooks(namespace: string, staleBefore: Date): TxResult<{
+      id: FragnoId;
+      hookName: string;
+      attempts: number;
+      maxAttempts: number;
+      lastAttemptAt: Date | null;
+      nextRetryAt: Date | null;
+    }[], {
+      id: FragnoId;
+      hookName: string;
+      attempts: number;
+      maxAttempts: number;
+      lastAttemptAt: Date | null;
+      nextRetryAt: Date | null;
+    }[]>;
+    /**
+     * Get the next time a processing hook becomes stale.
+     */
+    getNextProcessingStaleAt(namespace: string, timeoutMinutes: number, now?: Date): TxResult<Date | null, Date | null>;
+    /**
+     * Get the earliest pending hook wake time for a namespace.
+     * Optionally considers processing hooks becoming stale when timeoutMinutes is provided.
+     */
+    getNextHookWakeAt(namespace: string, timeoutMinutes?: number | false, now?: Date): TxResult<Date | null, Date | null>;
     /**
      * Mark a hook event as completed.
      */
@@ -62,7 +112,7 @@ declare const internalFragmentDef: _fragno_dev_core0.FragmentDefinition<{}, Frag
     /**
      * Mark a hook event as failed and schedule next retry.
      */
-    markHookFailed(eventId: FragnoId, error: string, attempts: number, retryPolicy: RetryPolicy): TxResult<void, void>;
+    markHookFailed(eventId: FragnoId, error: string, attempts: number, retryPolicy: RetryPolicy, now?: Date): TxResult<void, void>;
     /**
      * Mark a hook event as processing (to prevent concurrent execution).
      */
@@ -128,6 +178,33 @@ declare const internalFragmentDef: _fragno_dev_core0.FragmentDefinition<{}, Frag
       nonce: string;
     }[]>;
   };
+} & {
+  outboxService: {
+    /**
+     * List outbox entries ordered by versionstamp (ascending).
+     */
+    list({
+      afterVersionstamp,
+      limit
+    }?: {
+      afterVersionstamp?: string;
+      limit?: number;
+    }): TxResult<{
+      id: FragnoId;
+      versionstamp: string;
+      uowId: string;
+      payload: unknown;
+      refMap: {} | undefined;
+      createdAt: Date;
+    }[], {
+      id: FragnoId;
+      versionstamp: string;
+      uowId: string;
+      payload: unknown;
+      refMap: {} | undefined;
+      createdAt: Date;
+    }[]>;
+  };
 }, {}, {}, DatabaseServiceContext<{}>, DatabaseHandlerContext<{}>, DatabaseRequestStorage, {}>;
 /**
  * Type representing an instantiated internal fragment.

package/dist/fragments/internal-fragment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal-fragment.d.ts","names":[],"sources":["../../src/fragments/internal-fragment.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"internal-fragment.d.ts","names":[],"sources":["../../src/fragments/internal-fragment.ts"],"sourcesContent":[],"mappings":"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"}