bunderstack 0.21.1 → 0.22.1

package/dist/jobs/define.d.ts.map

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

package/dist/jobs/define.js.map

@@ -1 +1 @@
-{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/jobs/define.ts"],"names":[],"mappings":"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","sourcesContent":["// src/jobs/define.ts — job definition types and the typed builder.\n// `createJobsBuilder` exists purely to carry\n// TSchema/TEnvResult typing into inline callbacks and extracted files.\nimport type { StandardSchemaV1 } from '@standard-schema/spec'\n\nimport type { DbFor } from '../db'\nimport type { EmailFacade } from '../email'\nimport type { StorageFacade } from '../index'\n\nimport { parseCron } from './cron'\nimport { CRON_PREFIX, type CatchUp } from './slots'\n\nexport const DEFAULT_RETRIES = 3\nexport const DEFAULT_TIMEOUT_MS = 60_000\n\nexport type EnqueueOptions = {\n  /** Collapse duplicate enqueues while the queue row is non-terminal. */\n  dedupeKey?: string\n  /** Milliseconds from now until the job becomes claimable. */\n  delay?: number\n  /** Absolute time the job becomes claimable; wins over `delay`. */\n  runAt?: Date | number\n}\n\nexport type TickResult = {\n  /** Rows moved from pending to running this tick. */\n  claimed: number\n  /** Handlers that completed successfully. */\n  ran: number\n  /** Handlers that threw, whether or not they will be retried. */\n  failed: number\n}\n\n/**\n * The untyped runtime facade. Job handlers and API context expose this shape;\n * `app.jobs` narrows `enqueue` to the declared job names/payloads.\n */\nexport type JobsRuntimeFacade = {\n  enqueue(\n    name: string,\n    input?: unknown,\n    opts?: EnqueueOptions,\n  ): Promise<{ id: string }>\n  /** Run one poll cycle deterministically (tests). `now` defaults to Date.now(). */\n  tick(now?: number): Promise<TickResult>\n}\n\nimport type { RealtimeFacade } from '../realtime/facade'\n\nexport type JobContext<\n  TSchema extends Record<string, unknown> = Record<string, unknown>,\n  TEnvResult = Record<string, unknown>,\n> = {\n  db: DbFor<TSchema>\n  env: TEnvResult\n  email: EmailFacade\n  storage: StorageFacade\n  jobs: JobsRuntimeFacade\n  realtime: RealtimeFacade<TSchema>\n}\n\nexport type BunderstackJobContext<\n  TSchema extends Record<string, unknown> = Record<string, unknown>,\n  TEnvResult = Record<string, unknown>,\n> = JobContext<TSchema, TEnvResult>\n\nexport type QueueJobDefinition<\n  TInput,\n  TSchema extends Record<string, unknown> = Record<string, unknown>,\n  TEnvResult = Record<string, unknown>,\n> = {\n  kind: 'job'\n  /** Standard Schema payload; parsed at enqueue AND before the handler runs. */\n  input?: StandardSchemaV1<unknown, TInput>\n  /** Attempts after the first failure. Default 3 (so 4 total attempts). */\n  retries?: number\n  /** Delay before retry N (1-based). Default exponential: 1s, 2s, 4s, … */\n  backoff?: ((attempt: number) => number) | { baseMs?: number; factor?: number }\n  /** Max simultaneous `running` rows of this type, enforced per worker. */\n  concurrency?: number\n  /** Lease duration in ms; an expired lease sends the job back to pending. */\n  timeout?: number\n  handler: (\n    input: TInput,\n    ctx: JobContext<TSchema, TEnvResult>,\n  ) => Promise<void> | void\n  /** Fires once, after the final attempt fails. Errors here are logged, never retried. */\n  onFailed?: (\n    input: TInput,\n    error: Error,\n    ctx: JobContext<TSchema, TEnvResult>,\n  ) => Promise<void> | void\n}\n\nexport type CronInvocation = { scheduledFor: Date }\n\nexport type CronDefinition<\n  TSchema extends Record<string, unknown> = Record<string, unknown>,\n  TEnvResult = Record<string, unknown>,\n  TSchedule extends string = string,\n> = {\n  kind: 'cron'\n  schedule: TSchedule\n  /** Attempts after the first failure. Default 3 (so 4 total attempts). */\n  retries?: number\n  /** Delay before retry N (1-based). Default exponential: 1s, 2s, 4s, … */\n  backoff?: ((attempt: number) => number) | { baseMs?: number; factor?: number }\n  /** Lease duration in ms; an expired lease sends the slot back to pending. */\n  timeout?: number\n  /** How missed slots are handled on wake. Default 'latest'. */\n  catchUp?: CatchUp\n  /** How far back catch-up looks, in ms. Default 1 hour. */\n  catchUpWindow?: number\n  handler: (\n    invocation: CronInvocation,\n    ctx: JobContext<TSchema, TEnvResult>,\n  ) => Promise<void> | void\n  /** Fires once, after the final attempt fails. Errors here are logged, never retried. */\n  onFailed?: (\n    invocation: CronInvocation,\n    error: Error,\n    ctx: JobContext<TSchema, TEnvResult>,\n  ) => Promise<void> | void\n}\n\nexport type BackgroundDefinition =\n  | QueueJobDefinition<any, any, any>\n  | CronDefinition<any, any>\nexport type BackgroundDefs = Record<string, BackgroundDefinition>\n\n/** @deprecated Use QueueJobDefinition. */\nexport type JobDefinition<\n  TInput,\n  TSchema extends Record<string, unknown> = Record<string, unknown>,\n  TEnvResult = Record<string, unknown>,\n> = QueueJobDefinition<TInput, TSchema, TEnvResult>\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyJobDefinition = QueueJobDefinition<any, any, any>\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyBackgroundDefinition =\n  | QueueJobDefinition<any, any, any>\n  | CronDefinition<any, any, any>\nexport type JobsDefs = BackgroundDefs\n\nexport type QueueJobKeys<TDefs extends BackgroundDefs> = {\n  [K in keyof TDefs & string]: TDefs[K] extends QueueJobDefinition<\n    any,\n    any,\n    any\n  >\n    ? K\n    : never\n}[keyof TDefs & string]\n\n/** Throws when a definition is unusable. Safe to call more than once. */\nexport function validateBackgroundDefs(defs: BackgroundDefs): void {\n  for (const [name, def] of Object.entries(defs)) {\n    if (typeof def.handler !== 'function') {\n      throw new Error(`[bunderstack] background task \"${name}\" has no handler`)\n    }\n    if (def.kind === 'job' && name.startsWith(CRON_PREFIX)) {\n      throw new Error(\n        `[bunderstack] job \"${name}\": the \"${CRON_PREFIX}\" prefix is reserved for cron tasks`,\n      )\n    }\n    if (\n      def.retries !== undefined &&\n      (def.retries < 0 || !Number.isInteger(def.retries))\n    ) {\n      throw new Error(\n        `[bunderstack] background task \"${name}\": retries must be a non-negative integer`,\n      )\n    }\n    if (def.timeout !== undefined && def.timeout <= 0) {\n      throw new Error(\n        `[bunderstack] background task \"${name}\": timeout must be positive`,\n      )\n    }\n    if (def.kind === 'cron') {\n      parseCron(def.schedule)\n      if ((def as { concurrency?: number }).concurrency !== undefined) {\n        throw new Error(\n          `[bunderstack] cron \"${name}\": concurrency is not supported for cron tasks — slots are already unique`,\n        )\n      }\n      if (def.catchUpWindow !== undefined && def.catchUpWindow <= 0) {\n        throw new Error(\n          `[bunderstack] cron \"${name}\": catchUpWindow must be positive`,\n        )\n      }\n      continue\n    }\n    if (\n      def.concurrency !== undefined &&\n      (def.concurrency < 1 || !Number.isInteger(def.concurrency))\n    ) {\n      throw new Error(\n        `[bunderstack] job \"${name}\": concurrency must be a positive integer`,\n      )\n    }\n  }\n}\n\n/** @deprecated Use validateBackgroundDefs. */\nexport const validateJobsDefs = validateBackgroundDefs\n\n/**\n * Delay in ms before retry `attempt` (1-based = the attempt that just failed).\n * Jittered by ±20% so a shared outage does not retry every job in lockstep.\n * A caller-supplied backoff function is returned verbatim — the caller owns it.\n */\nexport function backoffMs(\n  def: AnyBackgroundDefinition,\n  attempt: number,\n): number {\n  const b = def.backoff\n  if (typeof b === 'function') return b(attempt)\n  const baseMs = b?.baseMs ?? 1000\n  const factor = b?.factor ?? 2\n  const flat = baseMs * factor ** (attempt - 1)\n  return Math.round(flat * (0.8 + Math.random() * 0.4))\n}\n\n/**\n * Build the `j` instance bunderstack hands to the config's `jobs` builder\n * callback (and exports for multi-file job setups).\n */\nexport function createJobsBuilder<\n  TSchema extends Record<string, unknown>,\n  TEnvResult = Record<string, unknown>,\n>() {\n  return {\n    /** Identity with inference: pins TInput from the schema output. */\n    job<TInput = undefined>(\n      def: Omit<QueueJobDefinition<TInput, TSchema, TEnvResult>, 'kind'>,\n    ): QueueJobDefinition<TInput, TSchema, TEnvResult> {\n      return { kind: 'job', ...def }\n    },\n    cron<const TSchedule extends string>(\n      def: Omit<CronDefinition<TSchema, TEnvResult, TSchedule>, 'kind'>,\n    ): CronDefinition<TSchema, TEnvResult, TSchedule> {\n      parseCron(def.schedule)\n      return { kind: 'cron', ...def }\n    },\n    /** Identity with validation: returns the defs map, typed. */\n    define<TDefs extends BackgroundDefs>(defs: TDefs): TDefs {\n      validateBackgroundDefs(defs)\n      return defs\n    },\n  }\n}\n\n/** Type of the `j` instance — for builder callbacks declared in separate files. */\nexport type BunderstackJobsBuilder<\n  TSchema extends Record<string, unknown>,\n  TEnvResult = Record<string, unknown>,\n> = ReturnType<typeof createJobsBuilder<TSchema, TEnvResult>>\n\n// Infers TInput from the JobDefinition's own type argument rather than\n// pattern-matching the (optional, so union-with-undefined) `input` property —\n// A required-property pattern fails structurally because `input` is optional,\n// so infer from the definition's own type argument instead.\ntype JobInputOf<TDef> =\n  TDef extends QueueJobDefinition<infer TInput, any, any> ? TInput : undefined\n\n/**\n * `app.jobs`: `enqueue` narrowed to declared names + payloads. `Omit`s the\n * runtime facade's loose `enqueue` first — intersecting two same-named\n * methods instead would make TS treat them as overloaded, so the loose\n * `(name: string, ...)` signature would still accept any name.\n */\nexport type JobsFacade<TDefs extends JobsDefs> = Omit<\n  JobsRuntimeFacade,\n  'enqueue'\n> & {\n  enqueue<K extends QueueJobKeys<TDefs>>(\n    name: K,\n    ...rest: JobInputOf<TDefs[K]> extends undefined\n      ? [input?: undefined, opts?: EnqueueOptions]\n      : [input: JobInputOf<TDefs[K]>, opts?: EnqueueOptions]\n  ): Promise<{ id: string }>\n}\n"]}
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/jobs/define.ts"],"names":[],"mappings":"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","sourcesContent":["// src/jobs/define.ts — job definition types and the typed builder.\n// `createJobsBuilder` exists purely to carry\n// TSchema/TEnvResult typing into inline callbacks and extracted files.\nimport type { StandardSchemaV1 } from '@standard-schema/spec'\n\nimport type { DbFor } from '../db'\nimport type { EmailFacade } from '../email'\nimport type { StorageFacade } from '../runtime'\n\nimport { parseCron } from './cron'\nimport { CRON_PREFIX, type CatchUp } from './slots'\n\nexport const DEFAULT_RETRIES = 3\nexport const DEFAULT_TIMEOUT_MS = 60_000\n\nexport type EnqueueOptions = {\n  /** Collapse duplicate enqueues while the queue row is non-terminal. */\n  dedupeKey?: string\n  /** Milliseconds from now until the job becomes claimable. */\n  delay?: number\n  /** Absolute time the job becomes claimable; wins over `delay`. */\n  runAt?: Date | number\n}\n\nexport type TickResult = {\n  /** Rows moved from pending to running this tick. */\n  claimed: number\n  /** Handlers that completed successfully. */\n  ran: number\n  /** Handlers that threw, whether or not they will be retried. */\n  failed: number\n}\n\n/**\n * The untyped runtime facade. Job handlers and API context expose this shape;\n * `app.jobs` narrows `enqueue` to the declared job names/payloads.\n */\nexport type JobsRuntimeFacade = {\n  enqueue(\n    name: string,\n    input?: unknown,\n    opts?: EnqueueOptions,\n  ): Promise<{ id: string }>\n  /** Run one poll cycle deterministically (tests). `now` defaults to Date.now(). */\n  tick(now?: number): Promise<TickResult>\n}\n\nimport type { RealtimeFacade } from '../realtime/facade'\n\nexport type JobContext<\n  TSchema extends Record<string, unknown> = Record<string, unknown>,\n  TEnvResult = Record<string, unknown>,\n> = {\n  db: DbFor<TSchema>\n  env: TEnvResult\n  email: EmailFacade\n  storage: StorageFacade\n  jobs: JobsRuntimeFacade\n  realtime: RealtimeFacade<TSchema>\n}\n\nexport type BunderstackJobContext<\n  TSchema extends Record<string, unknown> = Record<string, unknown>,\n  TEnvResult = Record<string, unknown>,\n> = JobContext<TSchema, TEnvResult>\n\nexport type QueueJobDefinition<\n  TInput,\n  TSchema extends Record<string, unknown> = Record<string, unknown>,\n  TEnvResult = Record<string, unknown>,\n> = {\n  kind: 'job'\n  /** Standard Schema payload; parsed at enqueue AND before the handler runs. */\n  input?: StandardSchemaV1<unknown, TInput>\n  /** Attempts after the first failure. Default 3 (so 4 total attempts). */\n  retries?: number\n  /** Delay before retry N (1-based). Default exponential: 1s, 2s, 4s, … */\n  backoff?: ((attempt: number) => number) | { baseMs?: number; factor?: number }\n  /** Max simultaneous `running` rows of this type, enforced per worker. */\n  concurrency?: number\n  /** Lease duration in ms; an expired lease sends the job back to pending. */\n  timeout?: number\n  handler: (\n    input: TInput,\n    ctx: JobContext<TSchema, TEnvResult>,\n  ) => Promise<void> | void\n  /** Fires once, after the final attempt fails. Errors here are logged, never retried. */\n  onFailed?: (\n    input: TInput,\n    error: Error,\n    ctx: JobContext<TSchema, TEnvResult>,\n  ) => Promise<void> | void\n}\n\nexport type CronInvocation = { scheduledFor: Date }\n\nexport type CronDefinition<\n  TSchema extends Record<string, unknown> = Record<string, unknown>,\n  TEnvResult = Record<string, unknown>,\n  TSchedule extends string = string,\n> = {\n  kind: 'cron'\n  schedule: TSchedule\n  /** Attempts after the first failure. Default 3 (so 4 total attempts). */\n  retries?: number\n  /** Delay before retry N (1-based). Default exponential: 1s, 2s, 4s, … */\n  backoff?: ((attempt: number) => number) | { baseMs?: number; factor?: number }\n  /** Lease duration in ms; an expired lease sends the slot back to pending. */\n  timeout?: number\n  /** How missed slots are handled on wake. Default 'latest'. */\n  catchUp?: CatchUp\n  /** How far back catch-up looks, in ms. Default 1 hour. */\n  catchUpWindow?: number\n  handler: (\n    invocation: CronInvocation,\n    ctx: JobContext<TSchema, TEnvResult>,\n  ) => Promise<void> | void\n  /** Fires once, after the final attempt fails. Errors here are logged, never retried. */\n  onFailed?: (\n    invocation: CronInvocation,\n    error: Error,\n    ctx: JobContext<TSchema, TEnvResult>,\n  ) => Promise<void> | void\n}\n\nexport type BackgroundDefinition =\n  | QueueJobDefinition<any, any, any>\n  | CronDefinition<any, any>\nexport type BackgroundDefs = Record<string, BackgroundDefinition>\n\n/** @deprecated Use QueueJobDefinition. */\nexport type JobDefinition<\n  TInput,\n  TSchema extends Record<string, unknown> = Record<string, unknown>,\n  TEnvResult = Record<string, unknown>,\n> = QueueJobDefinition<TInput, TSchema, TEnvResult>\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyJobDefinition = QueueJobDefinition<any, any, any>\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyBackgroundDefinition =\n  | QueueJobDefinition<any, any, any>\n  | CronDefinition<any, any, any>\nexport type JobsDefs = BackgroundDefs\n\nexport type QueueJobKeys<TDefs extends BackgroundDefs> = {\n  [K in keyof TDefs & string]: TDefs[K] extends QueueJobDefinition<\n    any,\n    any,\n    any\n  >\n    ? K\n    : never\n}[keyof TDefs & string]\n\n/** Throws when a definition is unusable. Safe to call more than once. */\nexport function validateBackgroundDefs(defs: BackgroundDefs): void {\n  for (const [name, def] of Object.entries(defs)) {\n    if (typeof def.handler !== 'function') {\n      throw new Error(`[bunderstack] background task \"${name}\" has no handler`)\n    }\n    if (def.kind === 'job' && name.startsWith(CRON_PREFIX)) {\n      throw new Error(\n        `[bunderstack] job \"${name}\": the \"${CRON_PREFIX}\" prefix is reserved for cron tasks`,\n      )\n    }\n    if (\n      def.retries !== undefined &&\n      (def.retries < 0 || !Number.isInteger(def.retries))\n    ) {\n      throw new Error(\n        `[bunderstack] background task \"${name}\": retries must be a non-negative integer`,\n      )\n    }\n    if (def.timeout !== undefined && def.timeout <= 0) {\n      throw new Error(\n        `[bunderstack] background task \"${name}\": timeout must be positive`,\n      )\n    }\n    if (def.kind === 'cron') {\n      parseCron(def.schedule)\n      if ((def as { concurrency?: number }).concurrency !== undefined) {\n        throw new Error(\n          `[bunderstack] cron \"${name}\": concurrency is not supported for cron tasks — slots are already unique`,\n        )\n      }\n      if (def.catchUpWindow !== undefined && def.catchUpWindow <= 0) {\n        throw new Error(\n          `[bunderstack] cron \"${name}\": catchUpWindow must be positive`,\n        )\n      }\n      continue\n    }\n    if (\n      def.concurrency !== undefined &&\n      (def.concurrency < 1 || !Number.isInteger(def.concurrency))\n    ) {\n      throw new Error(\n        `[bunderstack] job \"${name}\": concurrency must be a positive integer`,\n      )\n    }\n  }\n}\n\n/** @deprecated Use validateBackgroundDefs. */\nexport const validateJobsDefs = validateBackgroundDefs\n\n/**\n * Delay in ms before retry `attempt` (1-based = the attempt that just failed).\n * Jittered by ±20% so a shared outage does not retry every job in lockstep.\n * A caller-supplied backoff function is returned verbatim — the caller owns it.\n */\nexport function backoffMs(\n  def: AnyBackgroundDefinition,\n  attempt: number,\n): number {\n  const b = def.backoff\n  if (typeof b === 'function') return b(attempt)\n  const baseMs = b?.baseMs ?? 1000\n  const factor = b?.factor ?? 2\n  const flat = baseMs * factor ** (attempt - 1)\n  return Math.round(flat * (0.8 + Math.random() * 0.4))\n}\n\n/**\n * Build the `j` instance bunderstack hands to the config's `jobs` builder\n * callback (and exports for multi-file job setups).\n */\nexport function createJobsBuilder<\n  TSchema extends Record<string, unknown>,\n  TEnvResult = Record<string, unknown>,\n>() {\n  return {\n    /** Identity with inference: pins TInput from the schema output. */\n    job<TInput = undefined>(\n      def: Omit<QueueJobDefinition<TInput, TSchema, TEnvResult>, 'kind'>,\n    ): QueueJobDefinition<TInput, TSchema, TEnvResult> {\n      return { kind: 'job', ...def }\n    },\n    cron<const TSchedule extends string>(\n      def: Omit<CronDefinition<TSchema, TEnvResult, TSchedule>, 'kind'>,\n    ): CronDefinition<TSchema, TEnvResult, TSchedule> {\n      parseCron(def.schedule)\n      return { kind: 'cron', ...def }\n    },\n    /** Identity with validation: returns the defs map, typed. */\n    define<TDefs extends BackgroundDefs>(defs: TDefs): TDefs {\n      validateBackgroundDefs(defs)\n      return defs\n    },\n  }\n}\n\n/** Type of the `j` instance — for builder callbacks declared in separate files. */\nexport type BunderstackJobsBuilder<\n  TSchema extends Record<string, unknown>,\n  TEnvResult = Record<string, unknown>,\n> = ReturnType<typeof createJobsBuilder<TSchema, TEnvResult>>\n\n// Infers TInput from the JobDefinition's own type argument rather than\n// pattern-matching the (optional, so union-with-undefined) `input` property —\n// A required-property pattern fails structurally because `input` is optional,\n// so infer from the definition's own type argument instead.\ntype JobInputOf<TDef> =\n  TDef extends QueueJobDefinition<infer TInput, any, any> ? TInput : undefined\n\n/**\n * `app.jobs`: `enqueue` narrowed to declared names + payloads. `Omit`s the\n * runtime facade's loose `enqueue` first — intersecting two same-named\n * methods instead would make TS treat them as overloaded, so the loose\n * `(name: string, ...)` signature would still accept any name.\n */\nexport type JobsFacade<TDefs extends JobsDefs> = Omit<\n  JobsRuntimeFacade,\n  'enqueue'\n> & {\n  enqueue<K extends QueueJobKeys<TDefs>>(\n    name: K,\n    ...rest: JobInputOf<TDefs[K]> extends undefined\n      ? [input?: undefined, opts?: EnqueueOptions]\n      : [input: JobInputOf<TDefs[K]>, opts?: EnqueueOptions]\n  ): Promise<{ id: string }>\n}\n"]}

package/dist/jobs/index.js

@@ -1,4 +1,4 @@
-// src/jobs/index.ts — module surface consumed by createBunderstack.
+// src/jobs/index.ts — module surface consumed by bunderstack.
 export { createJobsBuilder, validateBackgroundDefs, validateJobsDefs, DEFAULT_RETRIES, DEFAULT_TIMEOUT_MS, } from './define.js';
 export { enqueueJob } from './queue.js';
 export { createJobRunner } from './worker.js';

package/dist/jobs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jobs/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,UAAU,CAAA;AAkBjB,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAM1C,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA","sourcesContent":["// src/jobs/index.ts — module surface consumed by createBunderstack.\nexport {\n  createJobsBuilder,\n  validateBackgroundDefs,\n  validateJobsDefs,\n  DEFAULT_RETRIES,\n  DEFAULT_TIMEOUT_MS,\n} from './define'\nexport type {\n  AnyJobDefinition,\n  BackgroundDefinition,\n  BackgroundDefs,\n  BunderstackJobContext,\n  BunderstackJobsBuilder,\n  EnqueueOptions,\n  JobContext,\n  JobDefinition,\n  QueueJobDefinition,\n  CronDefinition,\n  CronInvocation,\n  QueueJobKeys,\n  JobsDefs,\n  JobsFacade,\n  JobsRuntimeFacade,\n} from './define'\nexport { enqueueJob } from './queue'\nexport { createJobRunner } from './worker'\nexport { startJobWorker } from './runtime'\nexport type {\n  StartWorkerOptions,\n  RunWorkerOptions,\n  WorkerHandle,\n} from './runtime'\nexport { parseCron, cronMatches } from './cron'\nexport { slotsDue, floorSlot, CRON_PREFIX, SLOT_MS } from './slots'\nexport type { CatchUp } from './slots'\nexport type { TickResult } from './define'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jobs/index.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,UAAU,CAAA;AAkBjB,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAM1C,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA","sourcesContent":["// src/jobs/index.ts — module surface consumed by bunderstack.\nexport {\n  createJobsBuilder,\n  validateBackgroundDefs,\n  validateJobsDefs,\n  DEFAULT_RETRIES,\n  DEFAULT_TIMEOUT_MS,\n} from './define'\nexport type {\n  AnyJobDefinition,\n  BackgroundDefinition,\n  BackgroundDefs,\n  BunderstackJobContext,\n  BunderstackJobsBuilder,\n  EnqueueOptions,\n  JobContext,\n  JobDefinition,\n  QueueJobDefinition,\n  CronDefinition,\n  CronInvocation,\n  QueueJobKeys,\n  JobsDefs,\n  JobsFacade,\n  JobsRuntimeFacade,\n} from './define'\nexport { enqueueJob } from './queue'\nexport { createJobRunner } from './worker'\nexport { startJobWorker } from './runtime'\nexport type {\n  StartWorkerOptions,\n  RunWorkerOptions,\n  WorkerHandle,\n} from './runtime'\nexport { parseCron, cronMatches } from './cron'\nexport { slotsDue, floorSlot, CRON_PREFIX, SLOT_MS } from './slots'\nexport type { CatchUp } from './slots'\nexport type { TickResult } from './define'\n"]}

package/dist/jobs/queue.d.ts

@@ -1,6 +1,6 @@
 import type { AnyDb } from '../dialect.js';
 import type { EnqueueOptions, JobsDefs } from './define.js';
-export declare function enqueueJob(db: AnyDb, defs: JobsDefs, name: string, input: unknown, opts?: EnqueueOptions): Promise<{
+export declare function enqueueJob(db: AnyDb, defs: JobsDefs, name: string, input: unknown, opts?: EnqueueOptions, now?: number): Promise<{
     id: string;
 }>;
 //# sourceMappingURL=queue.d.ts.map

package/dist/jobs/queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/jobs/queue.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAOxD,wBAAsB,UAAU,CAC9B,EAAE,EAAE,KAAK,EACT,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAiDzB"}
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/jobs/queue.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAOxD,wBAAsB,UAAU,CAC9B,EAAE,EAAE,KAAK,EACT,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,cAAmB,EACzB,GAAG,GAAE,MAAmB,GACvB,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAgDzB"}

package/dist/jobs/queue.js

@@ -4,7 +4,7 @@ import { jobsTableFor } from '../internal-tables.js';
 import { validateStandardSchema } from '../standard-schema.js';
 import { generate } from '../typeid.js';
 import { CRON_PREFIX } from './slots.js';
-export async function enqueueJob(db, defs, name, input, opts = {}) {
+export async function enqueueJob(db, defs, name, input, opts = {}, now = Date.now()) {
     const def = defs[name];
     if (!def) {
         throw new Error(`[bunderstack] unknown background task "${name}"`);
@@ -18,7 +18,6 @@ export async function enqueueJob(db, defs, name, input, opts = {}) {
             ? validateStandardSchema(def.input, input, `job "${name}" input`)
             : null;
     const t = jobsTableFor(db);
-    const now = Date.now();
     const runAt = opts.runAt !== undefined
         ? new Date(opts.runAt).getTime()
         : now + (opts.delay ?? 0);

package/dist/jobs/queue.js.map

@@ -1 +1 @@
-{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/jobs/queue.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAKrC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAErC,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,EAAS,EACT,IAAc,EACd,IAAY,EACZ,KAAc,EACd,OAAuB,EAAE;IAEzB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;IACtB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,GAAG,CAAC,CAAA;IACpE,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,KAAK,MAAM,CAAA;IAClC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IACpD,4EAA4E;IAC5E,MAAM,MAAM,GAAG,MAAM;QACnB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,GAAG,CAAC,KAAK;YACT,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,IAAI,SAAS,CAAC;YACjE,CAAC,CAAC,IAAI,CAAA;IACV,MAAM,CAAC,GAAG,YAAY,CAAC,EAAE,CAAC,CAAA;IAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACtB,MAAM,KAAK,GACT,IAAI,CAAC,KAAK,KAAK,SAAS;QACtB,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE;QAChC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAA;IAE7B,4EAA4E;IAC5E,6DAA6D;IAC7D,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QACvC,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;QAC1B,MAAM,YAAY,GAAG,MAAM,EAAE;aAC1B,MAAM,CAAC,CAAC,CAAC;aACT,MAAM,CAAC;YACN,EAAE;YACF,IAAI;YACJ,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;YACnC,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,CAAC;YACX,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;YACjC,SAAS,EAAE,GAAG;SACf,CAAC;aACD,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;aACtD,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QAC1B,IAAI,YAAY,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;QAC9D,MAAM,QAAQ,GAAG,MAAM,EAAE;aACtB,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;aACpB,IAAI,CAAC,CAAC,CAAC;aACP,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;aACnE,KAAK,CAAC,CAAC,CAAC,CAAA;QACX,IAAI,QAAQ,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;IACxD,CAAC;IACD,MAAM,IAAI,KAAK,CACb,6BAA6B,IAAI,2CAA2C,CAC7E,CAAA;AACH,CAAC","sourcesContent":["// src/jobs/queue.ts — durable enqueue with constraint-backed dedupe.\nimport { and, eq } from 'drizzle-orm'\n\nimport type { AnyDb } from '../dialect'\nimport type { EnqueueOptions, JobsDefs } from './define'\n\nimport { jobsTableFor } from '../internal-tables'\nimport { validateStandardSchema } from '../standard-schema'\nimport { generate } from '../typeid'\nimport { CRON_PREFIX } from './slots'\n\nexport async function enqueueJob(\n  db: AnyDb,\n  defs: JobsDefs,\n  name: string,\n  input: unknown,\n  opts: EnqueueOptions = {},\n): Promise<{ id: string }> {\n  const def = defs[name]\n  if (!def) {\n    throw new Error(`[bunderstack] unknown background task \"${name}\"`)\n  }\n  const isCron = def.kind === 'cron'\n  const type = isCron ? `${CRON_PREFIX}${name}` : name\n  // Cron slots carry no payload; queue jobs validate theirs at the call site.\n  const parsed = isCron\n    ? null\n    : def.input\n      ? validateStandardSchema(def.input, input, `job \"${name}\" input`)\n      : null\n  const t = jobsTableFor(db)\n  const now = Date.now()\n  const runAt =\n    opts.runAt !== undefined\n      ? new Date(opts.runAt).getTime()\n      : now + (opts.delay ?? 0)\n\n  // Two rounds cover the race where the deduping row reaches a terminal state\n  // (clearing its key) between our failed insert and our read.\n  for (let round = 0; round < 2; round++) {\n    const id = generate('job')\n    const insertedRows = await db\n      .insert(t)\n      .values({\n        id,\n        type,\n        payloadJson: JSON.stringify(parsed),\n        status: 'pending',\n        attempts: 0,\n        runAt,\n        dedupeKey: opts.dedupeKey ?? null,\n        createdAt: now,\n      })\n      .onConflictDoNothing({ target: [t.type, t.dedupeKey] })\n      .returning({ id: t.id })\n    if (insertedRows[0]) return { id: String(insertedRows[0].id) }\n    const existing = await db\n      .select({ id: t.id })\n      .from(t)\n      .where(and(eq(t.type, type), eq(t.dedupeKey, opts.dedupeKey ?? '')))\n      .limit(1)\n    if (existing[0]) return { id: String(existing[0].id) }\n  }\n  throw new Error(\n    `[bunderstack] enqueue of \"${name}\" lost a dedupe race twice — please retry`,\n  )\n}\n"]}
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/jobs/queue.ts"],"names":[],"mappings":"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","sourcesContent":["// src/jobs/queue.ts — durable enqueue with constraint-backed dedupe.\nimport { and, eq } from 'drizzle-orm'\n\nimport type { AnyDb } from '../dialect'\nimport type { EnqueueOptions, JobsDefs } from './define'\n\nimport { jobsTableFor } from '../internal-tables'\nimport { validateStandardSchema } from '../standard-schema'\nimport { generate } from '../typeid'\nimport { CRON_PREFIX } from './slots'\n\nexport async function enqueueJob(\n  db: AnyDb,\n  defs: JobsDefs,\n  name: string,\n  input: unknown,\n  opts: EnqueueOptions = {},\n  now: number = Date.now(),\n): Promise<{ id: string }> {\n  const def = defs[name]\n  if (!def) {\n    throw new Error(`[bunderstack] unknown background task \"${name}\"`)\n  }\n  const isCron = def.kind === 'cron'\n  const type = isCron ? `${CRON_PREFIX}${name}` : name\n  // Cron slots carry no payload; queue jobs validate theirs at the call site.\n  const parsed = isCron\n    ? null\n    : def.input\n      ? validateStandardSchema(def.input, input, `job \"${name}\" input`)\n      : null\n  const t = jobsTableFor(db)\n  const runAt =\n    opts.runAt !== undefined\n      ? new Date(opts.runAt).getTime()\n      : now + (opts.delay ?? 0)\n\n  // Two rounds cover the race where the deduping row reaches a terminal state\n  // (clearing its key) between our failed insert and our read.\n  for (let round = 0; round < 2; round++) {\n    const id = generate('job')\n    const insertedRows = await db\n      .insert(t)\n      .values({\n        id,\n        type,\n        payloadJson: JSON.stringify(parsed),\n        status: 'pending',\n        attempts: 0,\n        runAt,\n        dedupeKey: opts.dedupeKey ?? null,\n        createdAt: now,\n      })\n      .onConflictDoNothing({ target: [t.type, t.dedupeKey] })\n      .returning({ id: t.id })\n    if (insertedRows[0]) return { id: String(insertedRows[0].id) }\n    const existing = await db\n      .select({ id: t.id })\n      .from(t)\n      .where(and(eq(t.type, type), eq(t.dedupeKey, opts.dedupeKey ?? '')))\n      .limit(1)\n    if (existing[0]) return { id: String(existing[0].id) }\n  }\n  throw new Error(\n    `[bunderstack] enqueue of \"${name}\" lost a dedupe race twice — please retry`,\n  )\n}\n"]}

package/dist/jobs/worker.d.ts

@@ -1,12 +1,33 @@
 import type { AnyDb } from '../dialect.js';
+import type { BunderstackLogger } from '../logging.js';
 import type { JobsDefs, JobsRuntimeFacade, TickResult } from './define.js';
 export declare function createJobRunner(deps: {
     db: AnyDb;
     defs: JobsDefs;
     /** Handler ctx WITHOUT `jobs`; the facade is injected via setJobsFacade. */
     ctx: Record<string, unknown>;
+    logger?: BunderstackLogger;
 }): {
     tick(now?: number): Promise<TickResult>;
+    inspect(now: number): Promise<{
+        runnable: any;
+        failed: {
+            id: string;
+            name: string;
+            attempts: number;
+            lastError: string | null;
+        }[];
+        jobs: {
+            id: string;
+            name: string;
+            kind: "job" | "cron";
+            status: "pending" | "running" | "succeeded" | "failed";
+            attempts: number;
+            runAt: number;
+            dedupeKey: string | null;
+            lastError: string | null;
+        }[];
+    }>;
     setJobsFacade(f: JobsRuntimeFacade): void;
 };
 //# sourceMappingURL=worker.d.ts.map

package/dist/jobs/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/jobs/worker.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,KAAK,EAEV,QAAQ,EACR,iBAAiB,EACjB,UAAU,EACX,MAAM,UAAU,CAAA;AAgDjB,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,EAAE,EAAE,KAAK,CAAA;IACT,IAAI,EAAE,QAAQ,CAAA;IACd,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC7B;eAmSmB,MAAM,GAAgB,OAAO,CAAC,UAAU,CAAC;qBASxC,iBAAiB;EAIrC"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/jobs/worker.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,KAAK,EAEV,QAAQ,EACR,iBAAiB,EACjB,UAAU,EACX,MAAM,UAAU,CAAA;AAiDjB,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,EAAE,EAAE,KAAK,CAAA;IACT,IAAI,EAAE,QAAQ,CAAA;IACd,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC5B,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAC3B;eA+SmB,MAAM,GAAgB,OAAO,CAAC,UAAU,CAAC;iBAStC,MAAM;;;;;;;;;;;;oBAiEb,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ;;;;;;;qBAQH,iBAAiB;EAIrC"}

package/dist/jobs/worker.js

@@ -3,6 +3,7 @@
 import { and, eq, inArray, is, isNotNull, lt, lte, max, sql } from 'drizzle-orm';
 import { PgDatabase } from 'drizzle-orm/pg-core';
 import { jobsTableFor } from '../internal-tables.js';
+import { consoleLogger } from '../logging.js';
 import { validateStandardSchema } from '../standard-schema.js';
 import { parseCron } from './cron.js';
 import { backoffMs, DEFAULT_RETRIES, DEFAULT_TIMEOUT_MS } from './define.js';
@@ -33,6 +34,7 @@ function terminalPatch() {
 }
 export function createJobRunner(deps) {
     const { db, defs } = deps;
+    const logger = deps.logger ?? consoleLogger;
     const t = jobsTableFor(db);
     const ctx = { ...deps.ctx };
     let lastReapAt = 0;
@@ -89,7 +91,7 @@ export function createJobRunner(deps) {
             await def.onFailed(input, error, ctx);
         }
         catch (hookErr) {
-            console.error('[bunderstack] onFailed hook threw:', hookErr);
+            logger.error('[bunderstack] onFailed hook threw:', hookErr);
         }
     }
     /** running rows whose lease expired → pending (or failed when exhausted). */
@@ -261,7 +263,7 @@ export function createJobRunner(deps) {
         }
     }
     async function runClaimable(now) {
-        const work = [];
+        const claimedWork = [];
         let totalClaimed = 0;
         for (const [name, def] of Object.entries(defs)) {
             const type = def.kind === 'cron' ? `${CRON_PREFIX}${name}` : name;
@@ -280,9 +282,12 @@ export function createJobRunner(deps) {
             const claimed = await claim(type, limit, now, leaseUntil);
             totalClaimed += claimed.length;
             for (const row of claimed)
-                work.push(runJob(row, def, now, leaseUntil));
+                claimedWork.push({ row, def, leaseUntil });
         }
-        const outcomes = await Promise.all(work);
+        // Claim the whole tick snapshot before starting any handler. Work enqueued
+        // by a handler therefore belongs to the next tick, regardless of the
+        // declaration order of its target job type.
+        const outcomes = await Promise.all(claimedWork.map(({ row, def, leaseUntil }) => runJob(row, def, now, leaseUntil)));
         let ran = 0;
         let failed = 0;
         for (const outcome of outcomes) {
@@ -303,6 +308,61 @@ export function createJobRunner(deps) {
             }
             return runClaimable(now);
         },
+        async inspect(now) {
+            const runnableRows = await db
+                .select({ id: t.id })
+                .from(t)
+                .where(and(eq(t.status, 'pending'), lte(t.runAt, now)));
+            const failed = await db
+                .select({
+                id: t.id,
+                type: t.type,
+                attempts: t.attempts,
+                lastError: t.lastError,
+            })
+                .from(t)
+                .where(eq(t.status, 'failed'));
+            const rows = await db
+                .select({
+                id: t.id,
+                type: t.type,
+                status: t.status,
+                attempts: t.attempts,
+                runAt: t.runAt,
+                dedupeKey: t.dedupeKey,
+                lastError: t.lastError,
+                createdAt: t.createdAt,
+            })
+                .from(t);
+            return {
+                runnable: runnableRows.length,
+                failed: failed.map((row) => ({
+                    id: String(row.id),
+                    name: row.type.startsWith(CRON_PREFIX)
+                        ? row.type.slice(CRON_PREFIX.length)
+                        : row.type,
+                    attempts: Number(row.attempts),
+                    lastError: row.lastError,
+                })),
+                jobs: rows
+                    .sort((left, right) => Number(left.createdAt) - Number(right.createdAt) ||
+                    String(left.id).localeCompare(String(right.id)))
+                    .map((row) => ({
+                    id: String(row.id),
+                    name: row.type.startsWith(CRON_PREFIX)
+                        ? row.type.slice(CRON_PREFIX.length)
+                        : row.type,
+                    kind: row.type.startsWith(CRON_PREFIX)
+                        ? 'cron'
+                        : 'job',
+                    status: row.status,
+                    attempts: Number(row.attempts),
+                    runAt: Number(row.runAt),
+                    dedupeKey: row.dedupeKey,
+                    lastError: row.lastError,
+                })),
+            };
+        },
         setJobsFacade(f) {
             ctx.jobs = f;
         },

package/dist/jobs/worker.js.map

@@ -1 +1 @@
-{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../src/jobs/worker.ts"],"names":[],"mappings":"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","sourcesContent":["// src/jobs/worker.ts — the queue worker. One `tick()` is a full cycle:\n// recover expired leases → reap old succeeded rows → claim and run queue jobs.\nimport { and, eq, inArray, is, isNotNull, lt, lte, max, sql } from 'drizzle-orm'\nimport { PgDatabase } from 'drizzle-orm/pg-core'\n\nimport type { AnyDb } from '../dialect'\nimport type {\n  AnyBackgroundDefinition,\n  JobsDefs,\n  JobsRuntimeFacade,\n  TickResult,\n} from './define'\n\nimport { jobsTableFor } from '../internal-tables'\nimport { validateStandardSchema } from '../standard-schema'\nimport { parseCron } from './cron'\nimport { backoffMs, DEFAULT_RETRIES, DEFAULT_TIMEOUT_MS } from './define'\nimport { enqueueJob } from './queue'\nimport { CRON_PREFIX, floorSlot, slotsDue, SLOT_MS } from './slots'\n\nconst CLAIM_BATCH = 10\nconst SUCCEEDED_RETENTION_MS = 24 * 60 * 60 * 1000\nconst REAP_INTERVAL_MS = 60 * 60_000\n\ntype JobRow = {\n  id: string\n  type: string\n  payloadJson: string\n  attempts: number\n  runAt: number\n}\n\nfunction toError(err: unknown): Error {\n  return err instanceof Error ? err : new Error(String(err))\n}\n\nfunction maxAttempts(def: AnyBackgroundDefinition): number {\n  return 1 + (def.retries ?? DEFAULT_RETRIES)\n}\n\n/** Resolve a stored row type back to its definition. Cron rows carry the\n *  reserved prefix; queue rows use the definition key verbatim. */\nfunction definitionFor(\n  defs: JobsDefs,\n  type: string,\n): AnyBackgroundDefinition | undefined {\n  if (type.startsWith(CRON_PREFIX)) {\n    const def = defs[type.slice(CRON_PREFIX.length)]\n    return def?.kind === 'cron' ? def : undefined\n  }\n  const def = defs[type]\n  return def?.kind === 'job' ? def : undefined\n}\n\n/** Terminal queue rows release their dedupe key. */\nfunction terminalPatch() {\n  return { dedupeKey: null }\n}\n\nexport function createJobRunner(deps: {\n  db: AnyDb\n  defs: JobsDefs\n  /** Handler ctx WITHOUT `jobs`; the facade is injected via setJobsFacade. */\n  ctx: Record<string, unknown>\n}) {\n  const { db, defs } = deps\n  const t = jobsTableFor(db)\n  const ctx = { ...deps.ctx } as Record<string, unknown>\n  let lastReapAt = 0\n\n  /** Cron rows carry no payload — their handler input is the slot itself. */\n  function resolveInput(def: AnyBackgroundDefinition, row: JobRow): unknown {\n    if (def.kind === 'cron') {\n      return { scheduledFor: new Date(Number(row.runAt)) }\n    }\n    const raw = JSON.parse(row.payloadJson)\n    return def.input\n      ? validateStandardSchema(def.input, raw, 'job payload')\n      : undefined\n  }\n\n  /**\n   * The watermark is the newest slot we already stored for this cron. When no\n   * rows exist — a newly declared cron, or one whose rows were reaped — anchor\n   * one slot before now so the current minute is eligible and nothing older is.\n   */\n  async function cronWatermark(type: string, now: number): Promise<number> {\n    const rows = await db\n      .select({ latest: max(t.runAt) })\n      .from(t)\n      .where(eq(t.type, type))\n    const latest = rows[0]?.latest\n    return latest == null ? floorSlot(now) - SLOT_MS : Number(latest)\n  }\n\n  /** Enqueue a row per due slot. The unique(type, dedupeKey) constraint makes\n   *  this safe to run concurrently in any number of processes. */\n  async function materializeCronSlots(now: number) {\n    for (const [name, def] of Object.entries(defs)) {\n      if (def.kind !== 'cron') continue\n      const type = `${CRON_PREFIX}${name}`\n      const from = await cronWatermark(type, now)\n      const slots = slotsDue({\n        cron: parseCron(def.schedule),\n        from,\n        to: now,\n        catchUp: def.catchUp,\n        catchUpWindowMs: def.catchUpWindow,\n      })\n      for (const slot of slots) {\n        await enqueueJob(db, defs, name, null, {\n          runAt: slot,\n          dedupeKey: String(slot),\n        })\n      }\n    }\n  }\n\n  async function fireOnFailed(\n    def: AnyBackgroundDefinition,\n    input: unknown,\n    error: Error,\n  ) {\n    if (!def.onFailed) return\n    try {\n      await (def.onFailed as (i: unknown, e: Error, c: unknown) => unknown)(\n        input,\n        error,\n        ctx,\n      )\n    } catch (hookErr) {\n      console.error('[bunderstack] onFailed hook threw:', hookErr)\n    }\n  }\n\n  /** running rows whose lease expired → pending (or failed when exhausted). */\n  async function recoverExpiredLeases(now: number) {\n    const expired: (JobRow & { lastError: string | null })[] = await db\n      .select({\n        id: t.id,\n        type: t.type,\n        payloadJson: t.payloadJson,\n        attempts: t.attempts,\n        lastError: t.lastError,\n        runAt: t.runAt,\n      })\n      .from(t)\n      .where(\n        and(\n          eq(t.status, 'running'),\n          isNotNull(t.lockedUntil),\n          lt(t.lockedUntil, now),\n        ),\n      )\n    for (const row of expired) {\n      const def = definitionFor(defs, row.type)\n      const error = new Error('lease expired (worker crashed or timed out)')\n      if (!def) {\n        await db\n          .update(t)\n          .set({\n            status: 'failed',\n            finishedAt: now,\n            lockedUntil: null,\n            lastError: `unknown job type \"${row.type}\"`,\n            dedupeKey: null,\n          })\n          .where(eq(t.id, row.id))\n        continue\n      }\n      if (Number(row.attempts) >= maxAttempts(def)) {\n        await db\n          .update(t)\n          .set({\n            status: 'failed',\n            finishedAt: now,\n            lockedUntil: null,\n            lastError: error.message,\n            ...terminalPatch(),\n          })\n          .where(eq(t.id, row.id))\n        await fireOnFailed(def, resolveInput(def, row), error)\n      } else {\n        await db\n          .update(t)\n          .set({\n            status: 'pending',\n            lockedUntil: null,\n            runAt: now + backoffMs(def, Number(row.attempts)),\n            lastError: error.message,\n          })\n          .where(eq(t.id, row.id))\n      }\n    }\n  }\n\n  async function reapSucceeded(now: number) {\n    await db\n      .delete(t)\n      .where(\n        and(\n          eq(t.status, 'succeeded'),\n          lt(t.finishedAt, now - SUCCEEDED_RETENTION_MS),\n        ),\n      )\n  }\n\n  /** Atomically claim up to `limit` runnable jobs of one type. */\n  async function claim(\n    type: string,\n    limit: number,\n    now: number,\n    leaseUntil: number,\n  ): Promise<JobRow[]> {\n    const pendingIds = db\n      .select({ id: t.id })\n      .from(t)\n      .where(and(eq(t.type, type), eq(t.status, 'pending'), lte(t.runAt, now)))\n      .orderBy(t.runAt)\n      .limit(limit)\n    // PG: lock the selected rows so concurrent replicas skip them. SQLite's\n    // single-writer model makes the one-statement UPDATE atomic on its own.\n    const sub = is(db, PgDatabase)\n      ? (\n          pendingIds as unknown as {\n            for: (m: string, o: object) => typeof pendingIds\n          }\n        ).for('update', { skipLocked: true })\n      : pendingIds\n    const rows: JobRow[] = await db\n      .update(t)\n      .set({\n        status: 'running',\n        lockedUntil: leaseUntil,\n        attempts: sql`${t.attempts} + 1`,\n      })\n      .where(and(inArray(t.id, sub), eq(t.status, 'pending')))\n      .returning({\n        id: t.id,\n        type: t.type,\n        payloadJson: t.payloadJson,\n        attempts: t.attempts,\n        runAt: t.runAt,\n      })\n    return rows\n  }\n\n  // `now` is the tick's injected clock: retry runAt math uses it so tests can\n  // drive backoff deterministically. finishedAt uses the real clock (a handler\n  // may run long past the tick's start).\n  async function runJob(\n    row: JobRow,\n    def: AnyBackgroundDefinition,\n    now: number,\n    leaseUntil: number,\n  ): Promise<'ran' | 'failed' | 'lost'> {\n    let input: unknown\n    try {\n      input = resolveInput(def, row)\n    } catch (err) {\n      // Stored payload no longer parses (schema drift): retrying can't help.\n      const e = toError(err)\n      const updated = await db\n        .update(t)\n        .set({\n          status: 'failed',\n          finishedAt: Date.now(),\n          lockedUntil: null,\n          lastError: e.message,\n          ...terminalPatch(),\n        })\n        .where(and(eq(t.id, row.id), eq(t.lockedUntil, leaseUntil)))\n        .returning({ id: t.id })\n      if (!updated[0]) return 'lost'\n      await fireOnFailed(def, undefined, e)\n      return 'failed'\n    }\n    try {\n      await (def.handler as (i: unknown, c: unknown) => unknown)(input, ctx)\n      const updated = await db\n        .update(t)\n        .set({\n          status: 'succeeded',\n          finishedAt: Date.now(),\n          lockedUntil: null,\n          ...terminalPatch(),\n        })\n        .where(and(eq(t.id, row.id), eq(t.lockedUntil, leaseUntil)))\n        .returning({ id: t.id })\n      if (!updated[0]) return 'lost'\n      return 'ran'\n    } catch (err) {\n      const e = toError(err)\n      if (Number(row.attempts) < maxAttempts(def)) {\n        const updated = await db\n          .update(t)\n          .set({\n            status: 'pending',\n            lockedUntil: null,\n            runAt: now + backoffMs(def, Number(row.attempts)),\n            lastError: e.message,\n          })\n          .where(and(eq(t.id, row.id), eq(t.lockedUntil, leaseUntil)))\n          .returning({ id: t.id })\n        if (!updated[0]) return 'lost'\n      } else {\n        const updated = await db\n          .update(t)\n          .set({\n            status: 'failed',\n            finishedAt: Date.now(),\n            lockedUntil: null,\n            lastError: e.message,\n            ...terminalPatch(),\n          })\n          .where(and(eq(t.id, row.id), eq(t.lockedUntil, leaseUntil)))\n          .returning({ id: t.id })\n        if (!updated[0]) return 'lost'\n        await fireOnFailed(def, input, e)\n      }\n      return 'failed'\n    }\n  }\n\n  async function runClaimable(now: number): Promise<TickResult> {\n    const work: Promise<'ran' | 'failed' | 'lost'>[] = []\n    let totalClaimed = 0\n    for (const [name, def] of Object.entries(defs)) {\n      const type = def.kind === 'cron' ? `${CRON_PREFIX}${name}` : name\n      let limit = CLAIM_BATCH\n      if (def.kind === 'job' && def.concurrency !== undefined) {\n        const runningRows = await db\n          .select({ id: t.id })\n          .from(t)\n          .where(and(eq(t.type, type), eq(t.status, 'running')))\n        const capacity = def.concurrency - runningRows.length\n        if (capacity <= 0) continue\n        limit = Math.min(limit, capacity)\n      }\n      const leaseUntil = now + (def.timeout ?? DEFAULT_TIMEOUT_MS)\n      const claimed = await claim(type, limit, now, leaseUntil)\n      totalClaimed += claimed.length\n      for (const row of claimed) work.push(runJob(row, def, now, leaseUntil))\n    }\n    const outcomes = await Promise.all(work)\n    let ran = 0\n    let failed = 0\n    for (const outcome of outcomes) {\n      if (outcome === 'ran') ran++\n      else if (outcome === 'failed') failed++\n    }\n    return { claimed: totalClaimed, ran, failed }\n  }\n\n  return {\n    async tick(now: number = Date.now()): Promise<TickResult> {\n      await materializeCronSlots(now)\n      await recoverExpiredLeases(now)\n      if (now - lastReapAt >= REAP_INTERVAL_MS) {\n        lastReapAt = now\n        await reapSucceeded(now)\n      }\n      return runClaimable(now)\n    },\n    setJobsFacade(f: JobsRuntimeFacade) {\n      ctx.jobs = f\n    },\n  }\n}\n"]}
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../src/jobs/worker.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,+EAA+E;AAC/E,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAWhD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEnE,MAAM,WAAW,GAAG,EAAE,CAAA;AACtB,MAAM,sBAAsB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAClD,MAAM,gBAAgB,GAAG,EAAE,GAAG,MAAM,CAAA;AAUpC,SAAS,OAAO,CAAC,GAAY;IAC3B,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;AAC5D,CAAC;AAED,SAAS,WAAW,CAAC,GAA4B;IAC/C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,eAAe,CAAC,CAAA;AAC7C,CAAC;AAED;mEACmE;AACnE,SAAS,aAAa,CACpB,IAAc,EACd,IAAY;IAEZ,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAA;QAChD,OAAO,GAAG,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAA;IAC/C,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;IACtB,OAAO,GAAG,EAAE,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAA;AAC9C,CAAC;AAED,oDAAoD;AACpD,SAAS,aAAa;IACpB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAM/B;IACC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,IAAI,CAAA;IACzB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,aAAa,CAAA;IAC3C,MAAM,CAAC,GAAG,YAAY,CAAC,EAAE,CAAC,CAAA;IAC1B,MAAM,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAA6B,CAAA;IACtD,IAAI,UAAU,GAAG,CAAC,CAAA;IAElB,2EAA2E;IAC3E,SAAS,YAAY,CAAC,GAA4B,EAAE,GAAW;QAC7D,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACxB,OAAO,EAAE,YAAY,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAA;QACtD,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;QACvC,OAAO,GAAG,CAAC,KAAK;YACd,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,aAAa,CAAC;YACvD,CAAC,CAAC,SAAS,CAAA;IACf,CAAC;IAED;;;;OAIG;IACH,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,GAAW;QACpD,MAAM,IAAI,GAAG,MAAM,EAAE;aAClB,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;aAChC,IAAI,CAAC,CAAC,CAAC;aACP,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,CAAA;QAC9B,OAAO,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACnE,CAAC;IAED;oEACgE;IAChE,KAAK,UAAU,oBAAoB,CAAC,GAAW;QAC7C,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/C,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;gBAAE,SAAQ;YACjC,MAAM,IAAI,GAAG,GAAG,WAAW,GAAG,IAAI,EAAE,CAAA;YACpC,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;YAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC;gBACrB,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAC7B,IAAI;gBACJ,EAAE,EAAE,GAAG;gBACP,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,eAAe,EAAE,GAAG,CAAC,aAAa;aACnC,CAAC,CAAA;YACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,UAAU,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;oBACrC,KAAK,EAAE,IAAI;oBACX,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC;iBACxB,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,UAAU,YAAY,CACzB,GAA4B,EAC5B,KAAc,EACd,KAAY;QAEZ,IAAI,CAAC,GAAG,CAAC,QAAQ;YAAE,OAAM;QACzB,IAAI,CAAC;YACH,MAAO,GAAG,CAAC,QAA0D,CACnE,KAAK,EACL,KAAK,EACL,GAAG,CACJ,CAAA;QACH,CAAC;QAAC,OAAO,OAAO,EAAE,CAAC;YACjB,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,OAAO,CAAC,CAAA;QAC7D,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,KAAK,UAAU,oBAAoB,CAAC,GAAW;QAC7C,MAAM,OAAO,GAA8C,MAAM,EAAE;aAChE,MAAM,CAAC;YACN,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,KAAK,EAAE,CAAC,CAAC,KAAK;SACf,CAAC;aACD,IAAI,CAAC,CAAC,CAAC;aACP,KAAK,CACJ,GAAG,CACD,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,EACvB,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,EACxB,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CACvB,CACF,CAAA;QACH,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;YACzC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;YACtE,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,EAAE;qBACL,MAAM,CAAC,CAAC,CAAC;qBACT,GAAG,CAAC;oBACH,MAAM,EAAE,QAAQ;oBAChB,UAAU,EAAE,GAAG;oBACf,WAAW,EAAE,IAAI;oBACjB,SAAS,EAAE,qBAAqB,GAAG,CAAC,IAAI,GAAG;oBAC3C,SAAS,EAAE,IAAI;iBAChB,CAAC;qBACD,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;gBAC1B,SAAQ;YACV,CAAC;YACD,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7C,MAAM,EAAE;qBACL,MAAM,CAAC,CAAC,CAAC;qBACT,GAAG,CAAC;oBACH,MAAM,EAAE,QAAQ;oBAChB,UAAU,EAAE,GAAG;oBACf,WAAW,EAAE,IAAI;oBACjB,SAAS,EAAE,KAAK,CAAC,OAAO;oBACxB,GAAG,aAAa,EAAE;iBACnB,CAAC;qBACD,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;gBAC1B,MAAM,YAAY,CAAC,GAAG,EAAE,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAA;YACxD,CAAC;iBAAM,CAAC;gBACN,MAAM,EAAE;qBACL,MAAM,CAAC,CAAC,CAAC;qBACT,GAAG,CAAC;oBACH,MAAM,EAAE,SAAS;oBACjB,WAAW,EAAE,IAAI;oBACjB,KAAK,EAAE,GAAG,GAAG,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBACjD,SAAS,EAAE,KAAK,CAAC,OAAO;iBACzB,CAAC;qBACD,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,UAAU,aAAa,CAAC,GAAW;QACtC,MAAM,EAAE;aACL,MAAM,CAAC,CAAC,CAAC;aACT,KAAK,CACJ,GAAG,CACD,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,EACzB,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,GAAG,sBAAsB,CAAC,CAC/C,CACF,CAAA;IACL,CAAC;IAED,gEAAgE;IAChE,KAAK,UAAU,KAAK,CAClB,IAAY,EACZ,KAAa,EACb,GAAW,EACX,UAAkB;QAElB,MAAM,UAAU,GAAG,EAAE;aAClB,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;aACpB,IAAI,CAAC,CAAC,CAAC;aACP,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;aACxE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;aAChB,KAAK,CAAC,KAAK,CAAC,CAAA;QACf,wEAAwE;QACxE,wEAAwE;QACxE,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,UAAU,CAAC;YAC5B,CAAC,CACG,UAGD,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;YACvC,CAAC,CAAC,UAAU,CAAA;QACd,MAAM,IAAI,GAAa,MAAM,EAAE;aAC5B,MAAM,CAAC,CAAC,CAAC;aACT,GAAG,CAAC;YACH,MAAM,EAAE,SAAS;YACjB,WAAW,EAAE,UAAU;YACvB,QAAQ,EAAE,GAAG,CAAA,GAAG,CAAC,CAAC,QAAQ,MAAM;SACjC,CAAC;aACD,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;aACvD,SAAS,CAAC;YACT,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,KAAK,EAAE,CAAC,CAAC,KAAK;SACf,CAAC,CAAA;QACJ,OAAO,IAAI,CAAA;IACb,CAAC;IAED,4EAA4E;IAC5E,6EAA6E;IAC7E,uCAAuC;IACvC,KAAK,UAAU,MAAM,CACnB,GAAW,EACX,GAA4B,EAC5B,GAAW,EACX,UAAkB;QAElB,IAAI,KAAc,CAAA;QAClB,IAAI,CAAC;YACH,KAAK,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,uEAAuE;YACvE,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;YACtB,MAAM,OAAO,GAAG,MAAM,EAAE;iBACrB,MAAM,CAAC,CAAC,CAAC;iBACT,GAAG,CAAC;gBACH,MAAM,EAAE,QAAQ;gBAChB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;gBACtB,WAAW,EAAE,IAAI;gBACjB,SAAS,EAAE,CAAC,CAAC,OAAO;gBACpB,GAAG,aAAa,EAAE;aACnB,CAAC;iBACD,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;iBAC3D,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;YAC1B,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;gBAAE,OAAO,MAAM,CAAA;YAC9B,MAAM,YAAY,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,CAAA;YACrC,OAAO,QAAQ,CAAA;QACjB,CAAC;QACD,IAAI,CAAC;YACH,MAAO,GAAG,CAAC,OAA+C,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;YACtE,MAAM,OAAO,GAAG,MAAM,EAAE;iBACrB,MAAM,CAAC,CAAC,CAAC;iBACT,GAAG,CAAC;gBACH,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;gBACtB,WAAW,EAAE,IAAI;gBACjB,GAAG,aAAa,EAAE;aACnB,CAAC;iBACD,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;iBAC3D,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;YAC1B,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;gBAAE,OAAO,MAAM,CAAA;YAC9B,OAAO,KAAK,CAAA;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;YACtB,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC5C,MAAM,OAAO,GAAG,MAAM,EAAE;qBACrB,MAAM,CAAC,CAAC,CAAC;qBACT,GAAG,CAAC;oBACH,MAAM,EAAE,SAAS;oBACjB,WAAW,EAAE,IAAI;oBACjB,KAAK,EAAE,GAAG,GAAG,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBACjD,SAAS,EAAE,CAAC,CAAC,OAAO;iBACrB,CAAC;qBACD,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;qBAC3D,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;gBAC1B,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;oBAAE,OAAO,MAAM,CAAA;YAChC,CAAC;iBAAM,CAAC;gBACN,MAAM,OAAO,GAAG,MAAM,EAAE;qBACrB,MAAM,CAAC,CAAC,CAAC;qBACT,GAAG,CAAC;oBACH,MAAM,EAAE,QAAQ;oBAChB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;oBACtB,WAAW,EAAE,IAAI;oBACjB,SAAS,EAAE,CAAC,CAAC,OAAO;oBACpB,GAAG,aAAa,EAAE;iBACnB,CAAC;qBACD,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;qBAC3D,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;gBAC1B,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;oBAAE,OAAO,MAAM,CAAA;gBAC9B,MAAM,YAAY,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;YACnC,CAAC;YACD,OAAO,QAAQ,CAAA;QACjB,CAAC;IACH,CAAC;IAED,KAAK,UAAU,YAAY,CAAC,GAAW;QACrC,MAAM,WAAW,GAIZ,EAAE,CAAA;QACP,IAAI,YAAY,GAAG,CAAC,CAAA;QACpB,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;YACjE,IAAI,KAAK,GAAG,WAAW,CAAA;YACvB,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;gBACxD,MAAM,WAAW,GAAG,MAAM,EAAE;qBACzB,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;qBACpB,IAAI,CAAC,CAAC,CAAC;qBACP,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;gBACxD,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,GAAG,WAAW,CAAC,MAAM,CAAA;gBACrD,IAAI,QAAQ,IAAI,CAAC;oBAAE,SAAQ;gBAC3B,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;YACnC,CAAC;YACD,MAAM,UAAU,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,kBAAkB,CAAC,CAAA;YAC5D,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,CAAC,CAAA;YACzD,YAAY,IAAI,OAAO,CAAC,MAAM,CAAA;YAC9B,KAAK,MAAM,GAAG,IAAI,OAAO;gBAAE,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAA;QACvE,CAAC;QACD,2EAA2E;QAC3E,qEAAqE;QACrE,4CAA4C;QAC5C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,CAC3C,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,UAAU,CAAC,CAClC,CACF,CAAA;QACD,IAAI,GAAG,GAAG,CAAC,CAAA;QACX,IAAI,MAAM,GAAG,CAAC,CAAA;QACd,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,OAAO,KAAK,KAAK;gBAAE,GAAG,EAAE,CAAA;iBACvB,IAAI,OAAO,KAAK,QAAQ;gBAAE,MAAM,EAAE,CAAA;QACzC,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,CAAA;IAC/C,CAAC;IAED,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,MAAc,IAAI,CAAC,GAAG,EAAE;YACjC,MAAM,oBAAoB,CAAC,GAAG,CAAC,CAAA;YAC/B,MAAM,oBAAoB,CAAC,GAAG,CAAC,CAAA;YAC/B,IAAI,GAAG,GAAG,UAAU,IAAI,gBAAgB,EAAE,CAAC;gBACzC,UAAU,GAAG,GAAG,CAAA;gBAChB,MAAM,aAAa,CAAC,GAAG,CAAC,CAAA;YAC1B,CAAC;YACD,OAAO,YAAY,CAAC,GAAG,CAAC,CAAA;QAC1B,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,GAAW;YACvB,MAAM,YAAY,GAAG,MAAM,EAAE;iBAC1B,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;iBACpB,IAAI,CAAC,CAAC,CAAC;iBACP,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;YACzD,MAAM,MAAM,GAKP,MAAM,EAAE;iBACV,MAAM,CAAC;gBACN,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,SAAS,EAAE,CAAC,CAAC,SAAS;aACvB,CAAC;iBACD,IAAI,CAAC,CAAC,CAAC;iBACP,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;YAChC,MAAM,IAAI,GASL,MAAM,EAAE;iBACV,MAAM,CAAC;gBACN,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,SAAS,EAAE,CAAC,CAAC,SAAS;aACvB,CAAC;iBACD,IAAI,CAAC,CAAC,CAAC,CAAA;YACV,OAAO;gBACL,QAAQ,EAAE,YAAY,CAAC,MAAM;gBAC7B,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;oBAC3B,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;oBAClB,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;wBACpC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC;wBACpC,CAAC,CAAC,GAAG,CAAC,IAAI;oBACZ,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;oBAC9B,SAAS,EAAE,GAAG,CAAC,SAAS;iBACzB,CAAC,CAAC;gBACH,IAAI,EAAE,IAAI;qBACP,IAAI,CACH,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;oBAChD,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAClD;qBACA,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;oBACb,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;oBAClB,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;wBACpC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC;wBACpC,CAAC,CAAC,GAAG,CAAC,IAAI;oBACZ,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;wBACpC,CAAC,CAAE,MAAgB;wBACnB,CAAC,CAAE,KAAe;oBACpB,MAAM,EAAE,GAAG,CAAC,MAIA;oBACZ,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;oBAC9B,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;oBACxB,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,SAAS,EAAE,GAAG,CAAC,SAAS;iBACzB,CAAC,CAAC;aACN,CAAA;QACH,CAAC;QACD,aAAa,CAAC,CAAoB;YAChC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAA;QACd,CAAC;KACF,CAAA;AACH,CAAC","sourcesContent":["// src/jobs/worker.ts — the queue worker. One `tick()` is a full cycle:\n// recover expired leases → reap old succeeded rows → claim and run queue jobs.\nimport { and, eq, inArray, is, isNotNull, lt, lte, max, sql } from 'drizzle-orm'\nimport { PgDatabase } from 'drizzle-orm/pg-core'\n\nimport type { AnyDb } from '../dialect'\nimport type { BunderstackLogger } from '../logging'\nimport type {\n  AnyBackgroundDefinition,\n  JobsDefs,\n  JobsRuntimeFacade,\n  TickResult,\n} from './define'\n\nimport { jobsTableFor } from '../internal-tables'\nimport { consoleLogger } from '../logging'\nimport { validateStandardSchema } from '../standard-schema'\nimport { parseCron } from './cron'\nimport { backoffMs, DEFAULT_RETRIES, DEFAULT_TIMEOUT_MS } from './define'\nimport { enqueueJob } from './queue'\nimport { CRON_PREFIX, floorSlot, slotsDue, SLOT_MS } from './slots'\n\nconst CLAIM_BATCH = 10\nconst SUCCEEDED_RETENTION_MS = 24 * 60 * 60 * 1000\nconst REAP_INTERVAL_MS = 60 * 60_000\n\ntype JobRow = {\n  id: string\n  type: string\n  payloadJson: string\n  attempts: number\n  runAt: number\n}\n\nfunction toError(err: unknown): Error {\n  return err instanceof Error ? err : new Error(String(err))\n}\n\nfunction maxAttempts(def: AnyBackgroundDefinition): number {\n  return 1 + (def.retries ?? DEFAULT_RETRIES)\n}\n\n/** Resolve a stored row type back to its definition. Cron rows carry the\n *  reserved prefix; queue rows use the definition key verbatim. */\nfunction definitionFor(\n  defs: JobsDefs,\n  type: string,\n): AnyBackgroundDefinition | undefined {\n  if (type.startsWith(CRON_PREFIX)) {\n    const def = defs[type.slice(CRON_PREFIX.length)]\n    return def?.kind === 'cron' ? def : undefined\n  }\n  const def = defs[type]\n  return def?.kind === 'job' ? def : undefined\n}\n\n/** Terminal queue rows release their dedupe key. */\nfunction terminalPatch() {\n  return { dedupeKey: null }\n}\n\nexport function createJobRunner(deps: {\n  db: AnyDb\n  defs: JobsDefs\n  /** Handler ctx WITHOUT `jobs`; the facade is injected via setJobsFacade. */\n  ctx: Record<string, unknown>\n  logger?: BunderstackLogger\n}) {\n  const { db, defs } = deps\n  const logger = deps.logger ?? consoleLogger\n  const t = jobsTableFor(db)\n  const ctx = { ...deps.ctx } as Record<string, unknown>\n  let lastReapAt = 0\n\n  /** Cron rows carry no payload — their handler input is the slot itself. */\n  function resolveInput(def: AnyBackgroundDefinition, row: JobRow): unknown {\n    if (def.kind === 'cron') {\n      return { scheduledFor: new Date(Number(row.runAt)) }\n    }\n    const raw = JSON.parse(row.payloadJson)\n    return def.input\n      ? validateStandardSchema(def.input, raw, 'job payload')\n      : undefined\n  }\n\n  /**\n   * The watermark is the newest slot we already stored for this cron. When no\n   * rows exist — a newly declared cron, or one whose rows were reaped — anchor\n   * one slot before now so the current minute is eligible and nothing older is.\n   */\n  async function cronWatermark(type: string, now: number): Promise<number> {\n    const rows = await db\n      .select({ latest: max(t.runAt) })\n      .from(t)\n      .where(eq(t.type, type))\n    const latest = rows[0]?.latest\n    return latest == null ? floorSlot(now) - SLOT_MS : Number(latest)\n  }\n\n  /** Enqueue a row per due slot. The unique(type, dedupeKey) constraint makes\n   *  this safe to run concurrently in any number of processes. */\n  async function materializeCronSlots(now: number) {\n    for (const [name, def] of Object.entries(defs)) {\n      if (def.kind !== 'cron') continue\n      const type = `${CRON_PREFIX}${name}`\n      const from = await cronWatermark(type, now)\n      const slots = slotsDue({\n        cron: parseCron(def.schedule),\n        from,\n        to: now,\n        catchUp: def.catchUp,\n        catchUpWindowMs: def.catchUpWindow,\n      })\n      for (const slot of slots) {\n        await enqueueJob(db, defs, name, null, {\n          runAt: slot,\n          dedupeKey: String(slot),\n        })\n      }\n    }\n  }\n\n  async function fireOnFailed(\n    def: AnyBackgroundDefinition,\n    input: unknown,\n    error: Error,\n  ) {\n    if (!def.onFailed) return\n    try {\n      await (def.onFailed as (i: unknown, e: Error, c: unknown) => unknown)(\n        input,\n        error,\n        ctx,\n      )\n    } catch (hookErr) {\n      logger.error('[bunderstack] onFailed hook threw:', hookErr)\n    }\n  }\n\n  /** running rows whose lease expired → pending (or failed when exhausted). */\n  async function recoverExpiredLeases(now: number) {\n    const expired: (JobRow & { lastError: string | null })[] = await db\n      .select({\n        id: t.id,\n        type: t.type,\n        payloadJson: t.payloadJson,\n        attempts: t.attempts,\n        lastError: t.lastError,\n        runAt: t.runAt,\n      })\n      .from(t)\n      .where(\n        and(\n          eq(t.status, 'running'),\n          isNotNull(t.lockedUntil),\n          lt(t.lockedUntil, now),\n        ),\n      )\n    for (const row of expired) {\n      const def = definitionFor(defs, row.type)\n      const error = new Error('lease expired (worker crashed or timed out)')\n      if (!def) {\n        await db\n          .update(t)\n          .set({\n            status: 'failed',\n            finishedAt: now,\n            lockedUntil: null,\n            lastError: `unknown job type \"${row.type}\"`,\n            dedupeKey: null,\n          })\n          .where(eq(t.id, row.id))\n        continue\n      }\n      if (Number(row.attempts) >= maxAttempts(def)) {\n        await db\n          .update(t)\n          .set({\n            status: 'failed',\n            finishedAt: now,\n            lockedUntil: null,\n            lastError: error.message,\n            ...terminalPatch(),\n          })\n          .where(eq(t.id, row.id))\n        await fireOnFailed(def, resolveInput(def, row), error)\n      } else {\n        await db\n          .update(t)\n          .set({\n            status: 'pending',\n            lockedUntil: null,\n            runAt: now + backoffMs(def, Number(row.attempts)),\n            lastError: error.message,\n          })\n          .where(eq(t.id, row.id))\n      }\n    }\n  }\n\n  async function reapSucceeded(now: number) {\n    await db\n      .delete(t)\n      .where(\n        and(\n          eq(t.status, 'succeeded'),\n          lt(t.finishedAt, now - SUCCEEDED_RETENTION_MS),\n        ),\n      )\n  }\n\n  /** Atomically claim up to `limit` runnable jobs of one type. */\n  async function claim(\n    type: string,\n    limit: number,\n    now: number,\n    leaseUntil: number,\n  ): Promise<JobRow[]> {\n    const pendingIds = db\n      .select({ id: t.id })\n      .from(t)\n      .where(and(eq(t.type, type), eq(t.status, 'pending'), lte(t.runAt, now)))\n      .orderBy(t.runAt)\n      .limit(limit)\n    // PG: lock the selected rows so concurrent replicas skip them. SQLite's\n    // single-writer model makes the one-statement UPDATE atomic on its own.\n    const sub = is(db, PgDatabase)\n      ? (\n          pendingIds as unknown as {\n            for: (m: string, o: object) => typeof pendingIds\n          }\n        ).for('update', { skipLocked: true })\n      : pendingIds\n    const rows: JobRow[] = await db\n      .update(t)\n      .set({\n        status: 'running',\n        lockedUntil: leaseUntil,\n        attempts: sql`${t.attempts} + 1`,\n      })\n      .where(and(inArray(t.id, sub), eq(t.status, 'pending')))\n      .returning({\n        id: t.id,\n        type: t.type,\n        payloadJson: t.payloadJson,\n        attempts: t.attempts,\n        runAt: t.runAt,\n      })\n    return rows\n  }\n\n  // `now` is the tick's injected clock: retry runAt math uses it so tests can\n  // drive backoff deterministically. finishedAt uses the real clock (a handler\n  // may run long past the tick's start).\n  async function runJob(\n    row: JobRow,\n    def: AnyBackgroundDefinition,\n    now: number,\n    leaseUntil: number,\n  ): Promise<'ran' | 'failed' | 'lost'> {\n    let input: unknown\n    try {\n      input = resolveInput(def, row)\n    } catch (err) {\n      // Stored payload no longer parses (schema drift): retrying can't help.\n      const e = toError(err)\n      const updated = await db\n        .update(t)\n        .set({\n          status: 'failed',\n          finishedAt: Date.now(),\n          lockedUntil: null,\n          lastError: e.message,\n          ...terminalPatch(),\n        })\n        .where(and(eq(t.id, row.id), eq(t.lockedUntil, leaseUntil)))\n        .returning({ id: t.id })\n      if (!updated[0]) return 'lost'\n      await fireOnFailed(def, undefined, e)\n      return 'failed'\n    }\n    try {\n      await (def.handler as (i: unknown, c: unknown) => unknown)(input, ctx)\n      const updated = await db\n        .update(t)\n        .set({\n          status: 'succeeded',\n          finishedAt: Date.now(),\n          lockedUntil: null,\n          ...terminalPatch(),\n        })\n        .where(and(eq(t.id, row.id), eq(t.lockedUntil, leaseUntil)))\n        .returning({ id: t.id })\n      if (!updated[0]) return 'lost'\n      return 'ran'\n    } catch (err) {\n      const e = toError(err)\n      if (Number(row.attempts) < maxAttempts(def)) {\n        const updated = await db\n          .update(t)\n          .set({\n            status: 'pending',\n            lockedUntil: null,\n            runAt: now + backoffMs(def, Number(row.attempts)),\n            lastError: e.message,\n          })\n          .where(and(eq(t.id, row.id), eq(t.lockedUntil, leaseUntil)))\n          .returning({ id: t.id })\n        if (!updated[0]) return 'lost'\n      } else {\n        const updated = await db\n          .update(t)\n          .set({\n            status: 'failed',\n            finishedAt: Date.now(),\n            lockedUntil: null,\n            lastError: e.message,\n            ...terminalPatch(),\n          })\n          .where(and(eq(t.id, row.id), eq(t.lockedUntil, leaseUntil)))\n          .returning({ id: t.id })\n        if (!updated[0]) return 'lost'\n        await fireOnFailed(def, input, e)\n      }\n      return 'failed'\n    }\n  }\n\n  async function runClaimable(now: number): Promise<TickResult> {\n    const claimedWork: Array<{\n      row: JobRow\n      def: AnyBackgroundDefinition\n      leaseUntil: number\n    }> = []\n    let totalClaimed = 0\n    for (const [name, def] of Object.entries(defs)) {\n      const type = def.kind === 'cron' ? `${CRON_PREFIX}${name}` : name\n      let limit = CLAIM_BATCH\n      if (def.kind === 'job' && def.concurrency !== undefined) {\n        const runningRows = await db\n          .select({ id: t.id })\n          .from(t)\n          .where(and(eq(t.type, type), eq(t.status, 'running')))\n        const capacity = def.concurrency - runningRows.length\n        if (capacity <= 0) continue\n        limit = Math.min(limit, capacity)\n      }\n      const leaseUntil = now + (def.timeout ?? DEFAULT_TIMEOUT_MS)\n      const claimed = await claim(type, limit, now, leaseUntil)\n      totalClaimed += claimed.length\n      for (const row of claimed) claimedWork.push({ row, def, leaseUntil })\n    }\n    // Claim the whole tick snapshot before starting any handler. Work enqueued\n    // by a handler therefore belongs to the next tick, regardless of the\n    // declaration order of its target job type.\n    const outcomes = await Promise.all(\n      claimedWork.map(({ row, def, leaseUntil }) =>\n        runJob(row, def, now, leaseUntil),\n      ),\n    )\n    let ran = 0\n    let failed = 0\n    for (const outcome of outcomes) {\n      if (outcome === 'ran') ran++\n      else if (outcome === 'failed') failed++\n    }\n    return { claimed: totalClaimed, ran, failed }\n  }\n\n  return {\n    async tick(now: number = Date.now()): Promise<TickResult> {\n      await materializeCronSlots(now)\n      await recoverExpiredLeases(now)\n      if (now - lastReapAt >= REAP_INTERVAL_MS) {\n        lastReapAt = now\n        await reapSucceeded(now)\n      }\n      return runClaimable(now)\n    },\n    async inspect(now: number) {\n      const runnableRows = await db\n        .select({ id: t.id })\n        .from(t)\n        .where(and(eq(t.status, 'pending'), lte(t.runAt, now)))\n      const failed: Array<{\n        id: string\n        type: string\n        attempts: number\n        lastError: string | null\n      }> = await db\n        .select({\n          id: t.id,\n          type: t.type,\n          attempts: t.attempts,\n          lastError: t.lastError,\n        })\n        .from(t)\n        .where(eq(t.status, 'failed'))\n      const rows: Array<{\n        id: string\n        type: string\n        status: string\n        attempts: number\n        runAt: number\n        dedupeKey: string | null\n        lastError: string | null\n        createdAt: number\n      }> = await db\n        .select({\n          id: t.id,\n          type: t.type,\n          status: t.status,\n          attempts: t.attempts,\n          runAt: t.runAt,\n          dedupeKey: t.dedupeKey,\n          lastError: t.lastError,\n          createdAt: t.createdAt,\n        })\n        .from(t)\n      return {\n        runnable: runnableRows.length,\n        failed: failed.map((row) => ({\n          id: String(row.id),\n          name: row.type.startsWith(CRON_PREFIX)\n            ? row.type.slice(CRON_PREFIX.length)\n            : row.type,\n          attempts: Number(row.attempts),\n          lastError: row.lastError,\n        })),\n        jobs: rows\n          .sort(\n            (left, right) =>\n              Number(left.createdAt) - Number(right.createdAt) ||\n              String(left.id).localeCompare(String(right.id)),\n          )\n          .map((row) => ({\n            id: String(row.id),\n            name: row.type.startsWith(CRON_PREFIX)\n              ? row.type.slice(CRON_PREFIX.length)\n              : row.type,\n            kind: row.type.startsWith(CRON_PREFIX)\n              ? ('cron' as const)\n              : ('job' as const),\n            status: row.status as\n              | 'pending'\n              | 'running'\n              | 'succeeded'\n              | 'failed',\n            attempts: Number(row.attempts),\n            runAt: Number(row.runAt),\n            dedupeKey: row.dedupeKey,\n            lastError: row.lastError,\n          })),\n      }\n    },\n    setJobsFacade(f: JobsRuntimeFacade) {\n      ctx.jobs = f\n    },\n  }\n}\n"]}

package/dist/logging.d.ts

@@ -0,0 +1,8 @@
+export type BunderstackLogLevel = 'info' | 'warn' | 'error';
+export type BunderstackLogger = {
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+};
+export declare const consoleLogger: BunderstackLogger;
+//# sourceMappingURL=logging.d.ts.map

package/dist/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE3D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CAChC,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,iBAI3B,CAAA"}

package/dist/logging.js

@@ -0,0 +1,6 @@
+export const consoleLogger = {
+    info: (...args) => console.info(...args),
+    warn: (...args) => console.warn(...args),
+    error: (...args) => console.error(...args),
+};
+//# sourceMappingURL=logging.js.map

package/dist/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,aAAa,GAAsB;IAC9C,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;CAC3C,CAAA","sourcesContent":["export type BunderstackLogLevel = 'info' | 'warn' | 'error'\n\nexport type BunderstackLogger = {\n  info(...args: unknown[]): void\n  warn(...args: unknown[]): void\n  error(...args: unknown[]): void\n}\n\nexport const consoleLogger: BunderstackLogger = {\n  info: (...args) => console.info(...args),\n  warn: (...args) => console.warn(...args),\n  error: (...args) => console.error(...args),\n}\n"]}

package/dist/provision-internals.d.ts

@@ -1,7 +1,7 @@
 import type { Driver } from './db.js';
 import type { AnyDb, Dialect } from './dialect.js';
 /**
- * Hidden handle connecting `createBunderstack()` to the optional
+ * Hidden handle connecting `bunderstack()` to the optional
  * `bunderstack/provision` entry. Lives in its own module so the main entry
  * never imports provision code (and its drizzle-kit reference).
  */

package/dist/provision-internals.js

@@ -1,5 +1,5 @@
 /**
- * Hidden handle connecting `createBunderstack()` to the optional
+ * Hidden handle connecting `bunderstack()` to the optional
  * `bunderstack/provision` entry. Lives in its own module so the main entry
  * never imports provision code (and its drizzle-kit reference).
  */

package/dist/provision-internals.js.map

@@ -1 +1 @@
-{"version":3,"file":"provision-internals.js","sourceRoot":"","sources":["../src/provision-internals.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAkB,MAAM,CAAC,GAAG,CAC1D,iCAAiC,CAClC,CAAA","sourcesContent":["import type { Driver } from './db'\n// src/provision-internals.ts\nimport type { AnyDb, Dialect } from './dialect'\n\n/**\n * Hidden handle connecting `createBunderstack()` to the optional\n * `bunderstack/provision` entry. Lives in its own module so the main entry\n * never imports provision code (and its drizzle-kit reference).\n */\nexport const PROVISION_INTERNALS: unique symbol = Symbol.for(\n  'bunderstack.provision-internals',\n)\n\nexport interface ProvisionInternals {\n  /** Runtime db typed over the MERGED schema (user + internal tables). */\n  db: AnyDb\n  /** Merged schema used for push. */\n  schema: Record<string, unknown>\n  databaseUrl: string\n  /** Resolved migrations folder (config `database.migrations`). */\n  migrationsFolder: string\n  dialect: Dialect\n  driver: Driver\n  adapter: import('./database/adapter').DatabaseAdapter\n}\n\nexport interface WithProvisionInternals {\n  [PROVISION_INTERNALS]?: ProvisionInternals\n}\n"]}
+{"version":3,"file":"provision-internals.js","sourceRoot":"","sources":["../src/provision-internals.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAkB,MAAM,CAAC,GAAG,CAC1D,iCAAiC,CAClC,CAAA","sourcesContent":["import type { Driver } from './db'\n// src/provision-internals.ts\nimport type { AnyDb, Dialect } from './dialect'\n\n/**\n * Hidden handle connecting `bunderstack()` to the optional\n * `bunderstack/provision` entry. Lives in its own module so the main entry\n * never imports provision code (and its drizzle-kit reference).\n */\nexport const PROVISION_INTERNALS: unique symbol = Symbol.for(\n  'bunderstack.provision-internals',\n)\n\nexport interface ProvisionInternals {\n  /** Runtime db typed over the MERGED schema (user + internal tables). */\n  db: AnyDb\n  /** Merged schema used for push. */\n  schema: Record<string, unknown>\n  databaseUrl: string\n  /** Resolved migrations folder (config `database.migrations`). */\n  migrationsFolder: string\n  dialect: Dialect\n  driver: Driver\n  adapter: import('./database/adapter').DatabaseAdapter\n}\n\nexport interface WithProvisionInternals {\n  [PROVISION_INTERNALS]?: ProvisionInternals\n}\n"]}

package/dist/provision.d.ts

@@ -20,4 +20,6 @@ export declare function provisionSchema<TSchema extends Record<string, unknown>>
 export declare function provision(app: object, options?: {
     force?: boolean;
 }): Promise<void>;
+export type TestSchemaMode = 'auto' | 'push' | 'migrations';
+export declare function provisionForTest(app: object, mode: TestSchemaMode): Promise<void>;
 //# sourceMappingURL=provision.d.ts.map

package/dist/provision.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provision.d.ts","sourceRoot":"","sources":["../src/provision.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAW,MAAM,WAAW,CAAA;AA0C/C,kEAAkE;AAClE,wBAAsB,eAAe,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3E,EAAE,EAAE,KAAK,EACT,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAClD,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B,OAAO,CAAC,IAAI,CAAC,CAqBf"}
+{"version":3,"file":"provision.d.ts","sourceRoot":"","sources":["../src/provision.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAW,MAAM,WAAW,CAAA;AA0C/C,kEAAkE;AAClE,wBAAsB,eAAe,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3E,EAAE,EAAE,KAAK,EACT,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAClD,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,CAAA;AAE3D,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,IAAI,CAAC,CA8Bf"}

package/dist/provision.js

@@ -78,11 +78,9 @@ export async function provisionSchema(db, schema, options) {
  * pushing and every schema change goes through an explicit `generate`.
  */
 export async function provision(app, options) {
-    if (process.env.BUNDERSTACK_INTROSPECT === '1')
-        return;
     const internals = app[PROVISION_INTERNALS];
     if (!internals) {
-        throw new Error('[bunderstack] provision() expects the app returned by createBunderstack().');
+        throw new Error('[bunderstack] provision() expects the app returned by bunderstack().');
     }
     const { db, schema, databaseUrl, migrationsFolder, dialect, adapter } = internals;
     const journal = join(migrationsFolder, 'meta', '_journal.json');
@@ -93,4 +91,27 @@ export async function provision(app, options) {
     }
     await provisionSchema(db, schema, { force: options?.force, databaseUrl });
 }
+export async function provisionForTest(app, mode) {
+    if (mode === 'auto') {
+        await provision(app, { force: true });
+        return;
+    }
+    const internals = app[PROVISION_INTERNALS];
+    if (!internals) {
+        throw new Error('[bunderstack] test provisioning expects a Bunderstack runtime');
+    }
+    if (mode === 'push') {
+        await provisionSchema(internals.db, internals.schema, {
+            force: true,
+            databaseUrl: internals.databaseUrl,
+        });
+        return;
+    }
+    const journal = join(internals.migrationsFolder, 'meta', '_journal.json');
+    if (!(await exists(journal))) {
+        throw new Error('[bunderstack] committed migrations journal not found');
+    }
+    await ensureLocalDataDir(internals.databaseUrl, internals.dialect);
+    await internals.adapter.migrate(internals.db, internals.migrationsFolder);
+}
 //# sourceMappingURL=provision.js.map

package/dist/provision.js.map

@@ -1 +1 @@
-{"version":3,"file":"provision.js","sourceRoot":"","sources":["../src/provision.ts"],"names":[],"mappings":"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","sourcesContent":["// src/provision.ts\nimport { access, mkdir } from 'node:fs/promises'\nimport { dirname, join } from 'node:path'\n\nimport type { AnyDb, Dialect } from './dialect'\n\nimport { detectDialect } from './dialect'\nimport {\n  PROVISION_INTERNALS,\n  type WithProvisionInternals,\n} from './provision-internals'\n\n/** Create the local backing directory for file-based urls, per dialect. */\nasync function ensureLocalDataDir(\n  url: string,\n  dialect: Dialect,\n): Promise<void> {\n  if (dialect === 'pg') {\n    // PGlite data dir: `file:<dir>` or a bare path; server/memory urls need nothing.\n    if (/^postgres(ql)?:\\/\\//.test(url)) return\n    const raw = url.startsWith('file:') ? url.slice('file:'.length) : url\n    if (raw === ':memory:' || raw.startsWith('memory://')) return\n    await mkdir(raw, { recursive: true })\n    return\n  }\n  const match = /^file:(.+)$/.exec(url)\n  if (!match) return\n  const filePath = match[1]!\n  if (filePath === ':memory:') return\n  await mkdir(dirname(filePath), { recursive: true })\n}\n\nasync function exists(path: string): Promise<boolean> {\n  try {\n    await access(path)\n    return true\n  } catch {\n    return false\n  }\n}\n\nconst DRIZZLE_KIT_HINT =\n  '[bunderstack] Schema push requires drizzle-kit, which is not installed.\\n' +\n  '  Development: run `bun add -d drizzle-kit` — provision() will push schema changes to the database on startup.\\n' +\n  '  Production: generate migrations locally with `bunx drizzle-kit generate` and commit the folder — provision() applies them without drizzle-kit.'\n\n/** Push the merged schema to the database via drizzle-kit/api. */\nexport async function provisionSchema<TSchema extends Record<string, unknown>>(\n  db: AnyDb,\n  schema: TSchema,\n  options?: { force?: boolean; databaseUrl?: string },\n): Promise<void> {\n  const dialect = detectDialect(schema)\n  if (options?.databaseUrl) {\n    await ensureLocalDataDir(options.databaseUrl, dialect)\n  }\n\n  let kit: typeof import('drizzle-kit/api')\n  try {\n    kit = await import('drizzle-kit/api')\n  } catch (cause) {\n    throw new Error(DRIZZLE_KIT_HINT, { cause })\n  }\n\n  const result =\n    dialect === 'pg'\n      ? await kit.pushSchema(schema, db as never)\n      : await kit.pushSQLiteSchema(schema, db as never)\n\n  if (result.hasDataLoss && !options?.force) {\n    throw new Error(\n      '[bunderstack] Schema push would cause data loss. Run `bunx drizzle-kit push` or call provision(app, { force: true }).',\n    )\n  }\n\n  if (result.warnings.length > 0) {\n    for (const warning of result.warnings) {\n      console.warn(`[bunderstack] ${warning}`)\n    }\n  }\n\n  if (result.statementsToExecute.length === 0) return\n\n  await result.apply()\n\n  console.log(\n    `[bunderstack] provisioned ${result.statementsToExecute.length} schema change(s)`,\n  )\n}\n\n/**\n * Provision the database for a Bunderstack app.\n *\n * The migrations folder is the mode switch:\n * - `<migrations>/meta/_journal.json` exists → apply committed migrations via\n *   drizzle-orm's migrator. Pure runtime; drizzle-kit is never imported, so a\n *   fresh clone deploys with `bun install --production`.\n * - No migrations → development: push the schema straight to the database via\n *   drizzle-kit (install it with `bun add -d drizzle-kit`).\n *\n * Once you run `bunx drizzle-kit generate` for the first time, provision stops\n * pushing and every schema change goes through an explicit `generate`.\n */\nexport async function provision(\n  app: object,\n  options?: { force?: boolean },\n): Promise<void> {\n  if (process.env.BUNDERSTACK_INTROSPECT === '1') return\n\n  const internals = (app as WithProvisionInternals)[PROVISION_INTERNALS]\n  if (!internals) {\n    throw new Error(\n      '[bunderstack] provision() expects the app returned by createBunderstack().',\n    )\n  }\n\n  const { db, schema, databaseUrl, migrationsFolder, dialect, adapter } =\n    internals\n  const journal = join(migrationsFolder, 'meta', '_journal.json')\n\n  if (await exists(journal)) {\n    await ensureLocalDataDir(databaseUrl, dialect)\n    await adapter.migrate(db as never, migrationsFolder)\n    return\n  }\n\n  await provisionSchema(db, schema, { force: options?.force, databaseUrl })\n}\n"]}
+{"version":3,"file":"provision.js","sourceRoot":"","sources":["../src/provision.ts"],"names":[],"mappings":"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","sourcesContent":["// src/provision.ts\nimport { access, mkdir } from 'node:fs/promises'\nimport { dirname, join } from 'node:path'\n\nimport type { AnyDb, Dialect } from './dialect'\n\nimport { detectDialect } from './dialect'\nimport {\n  PROVISION_INTERNALS,\n  type WithProvisionInternals,\n} from './provision-internals'\n\n/** Create the local backing directory for file-based urls, per dialect. */\nasync function ensureLocalDataDir(\n  url: string,\n  dialect: Dialect,\n): Promise<void> {\n  if (dialect === 'pg') {\n    // PGlite data dir: `file:<dir>` or a bare path; server/memory urls need nothing.\n    if (/^postgres(ql)?:\\/\\//.test(url)) return\n    const raw = url.startsWith('file:') ? url.slice('file:'.length) : url\n    if (raw === ':memory:' || raw.startsWith('memory://')) return\n    await mkdir(raw, { recursive: true })\n    return\n  }\n  const match = /^file:(.+)$/.exec(url)\n  if (!match) return\n  const filePath = match[1]!\n  if (filePath === ':memory:') return\n  await mkdir(dirname(filePath), { recursive: true })\n}\n\nasync function exists(path: string): Promise<boolean> {\n  try {\n    await access(path)\n    return true\n  } catch {\n    return false\n  }\n}\n\nconst DRIZZLE_KIT_HINT =\n  '[bunderstack] Schema push requires drizzle-kit, which is not installed.\\n' +\n  '  Development: run `bun add -d drizzle-kit` — provision() will push schema changes to the database on startup.\\n' +\n  '  Production: generate migrations locally with `bunx drizzle-kit generate` and commit the folder — provision() applies them without drizzle-kit.'\n\n/** Push the merged schema to the database via drizzle-kit/api. */\nexport async function provisionSchema<TSchema extends Record<string, unknown>>(\n  db: AnyDb,\n  schema: TSchema,\n  options?: { force?: boolean; databaseUrl?: string },\n): Promise<void> {\n  const dialect = detectDialect(schema)\n  if (options?.databaseUrl) {\n    await ensureLocalDataDir(options.databaseUrl, dialect)\n  }\n\n  let kit: typeof import('drizzle-kit/api')\n  try {\n    kit = await import('drizzle-kit/api')\n  } catch (cause) {\n    throw new Error(DRIZZLE_KIT_HINT, { cause })\n  }\n\n  const result =\n    dialect === 'pg'\n      ? await kit.pushSchema(schema, db as never)\n      : await kit.pushSQLiteSchema(schema, db as never)\n\n  if (result.hasDataLoss && !options?.force) {\n    throw new Error(\n      '[bunderstack] Schema push would cause data loss. Run `bunx drizzle-kit push` or call provision(app, { force: true }).',\n    )\n  }\n\n  if (result.warnings.length > 0) {\n    for (const warning of result.warnings) {\n      console.warn(`[bunderstack] ${warning}`)\n    }\n  }\n\n  if (result.statementsToExecute.length === 0) return\n\n  await result.apply()\n\n  console.log(\n    `[bunderstack] provisioned ${result.statementsToExecute.length} schema change(s)`,\n  )\n}\n\n/**\n * Provision the database for a Bunderstack app.\n *\n * The migrations folder is the mode switch:\n * - `<migrations>/meta/_journal.json` exists → apply committed migrations via\n *   drizzle-orm's migrator. Pure runtime; drizzle-kit is never imported, so a\n *   fresh clone deploys with `bun install --production`.\n * - No migrations → development: push the schema straight to the database via\n *   drizzle-kit (install it with `bun add -d drizzle-kit`).\n *\n * Once you run `bunx drizzle-kit generate` for the first time, provision stops\n * pushing and every schema change goes through an explicit `generate`.\n */\nexport async function provision(\n  app: object,\n  options?: { force?: boolean },\n): Promise<void> {\n  const internals = (app as WithProvisionInternals)[PROVISION_INTERNALS]\n  if (!internals) {\n    throw new Error(\n      '[bunderstack] provision() expects the app returned by bunderstack().',\n    )\n  }\n\n  const { db, schema, databaseUrl, migrationsFolder, dialect, adapter } =\n    internals\n  const journal = join(migrationsFolder, 'meta', '_journal.json')\n\n  if (await exists(journal)) {\n    await ensureLocalDataDir(databaseUrl, dialect)\n    await adapter.migrate(db as never, migrationsFolder)\n    return\n  }\n\n  await provisionSchema(db, schema, { force: options?.force, databaseUrl })\n}\n\nexport type TestSchemaMode = 'auto' | 'push' | 'migrations'\n\nexport async function provisionForTest(\n  app: object,\n  mode: TestSchemaMode,\n): Promise<void> {\n  if (mode === 'auto') {\n    await provision(app, { force: true })\n    return\n  }\n\n  const internals = (app as WithProvisionInternals)[PROVISION_INTERNALS]\n  if (!internals) {\n    throw new Error(\n      '[bunderstack] test provisioning expects a Bunderstack runtime',\n    )\n  }\n\n  if (mode === 'push') {\n    await provisionSchema(internals.db, internals.schema, {\n      force: true,\n      databaseUrl: internals.databaseUrl,\n    })\n    return\n  }\n\n  const journal = join(internals.migrationsFolder, 'meta', '_journal.json')\n  if (!(await exists(journal))) {\n    throw new Error('[bunderstack] committed migrations journal not found')\n  }\n  await ensureLocalDataDir(internals.databaseUrl, internals.dialect)\n  await internals.adapter.migrate(\n    internals.db as never,\n    internals.migrationsFolder,\n  )\n}\n"]}

package/dist/query/infer.d.ts

@@ -1,6 +1,6 @@
 import type { AnyRouter } from '@orpc/server';
 import type { ExposedApiTables } from '../api/types.js';
-/** Shape of the `$inferClient` phantom `createBunderstack` puts on the app. */
+/** Shape of the `$inferClient` phantom `bunderstack` puts on the app. */
 export type ClientCarrier = {
     schema: Record<string, unknown>;
     access: unknown;