experimental-a2 0.19.0 → 0.21.1

package/dist/scheduler-qstash.js.map

@@ -1 +1 @@
-{"version":3,"file":"scheduler-qstash.js","names":[],"sources":["../src/scheduler-qstash.ts"],"sourcesContent":["/**\n * experimental-a2/scheduler-qstash — HTTP scheduler over Upstash QStash.\n *\n * QStash publishes one signed HTTP delivery per scheduler task. Drain tasks\n * use an absolute, whole-second `notBefore` and a fixed-size deduplication id;\n * append and clear tasks hash their stable task id with the callback URL, each\n * under its own version tag.\n * Store-outage successors carry a signed private generation and back off to\n * one day without deriving their deduplication identity from the local clock.\n * `handler(...servers)` verifies the signature over the raw request body\n * before parsing it, then applies the same drain protocol as the Vercel\n * scheduler adapter.\n *\n * `@upstash/qstash` is an optional peer dependency, imported lazily. The\n * structural `transport` option keeps its types out of A2's public surface and\n * gives tests a provider-faithful injection seam.\n */\n\nimport {\n  assertSchedulerTargets,\n  classifySchedulerSendFailure,\n  DRAIN_TIMINGS,\n  serverInternals,\n  type DrainResult,\n} from './internal.ts'\nimport { A2Error } from './errors.ts'\nimport { platformVercelOidcToken } from './platform.ts'\nimport { retryableLazy } from './retryable-lazy.ts'\nimport { normalizeSchedulerTask, type SchedulerTask } from './scheduler-task.ts'\nimport {\n  deliverSchedulerAppend,\n  deliverSchedulerClear,\n  type A2Scheduler,\n  type DrainableServer,\n} from './server.ts'\nimport { SYSTEM_CLOCK, type Clock } from './store.ts'\n\ntype QStashStoreOutage = {\n  version: 1\n  /** Zero is the first successor created for a store outage. */\n  generation: number\n  /** The first failing drain task's due time. Append and clear identity lives on the task. */\n  rootDueAt?: number\n}\n\ntype QStashMessage = SchedulerTask & {\n  /** Provider-private state authenticated as part of QStash's signed body. */\n  _a2QStash?: QStashStoreOutage\n}\n\nexport type QStashPublishRequest = {\n  url: string\n  body: QStashMessage\n  /** Headers the transport must deliver to the callback. */\n  headers?: Readonly<Record<string, string>>\n  /** Header names the transport must redact from provider dashboard/API views. */\n  redact?: {\n    header: readonly string[]\n  }\n  /** Whole-second Unix timestamp. Omitted for an immediate delivery. */\n  notBefore?: number\n  deduplicationId: string\n  /** Delivery retries after the initial attempt. */\n  retries?: number\n}\n\n/** The request shape passed to an injected `@upstash/qstash` client. */\nexport type QStashClientPublishRequest = Omit<\n  QStashPublishRequest,\n  'headers' | 'redact'\n> & {\n  headers?: Record<string, string>\n  redact?: {\n    header: string[]\n  }\n}\n\n/** The outbound part of `@upstash/qstash` used by the built-in transport. */\nexport type QStashPublishingClient = {\n  publishJSON(request: QStashClientPublishRequest): Promise<unknown>\n}\n\nexport type QStashVerifyRequest = {\n  signature: string\n  /** The untouched request body covered by the signature. */\n  body: string\n  /** Exact destination URL, checked against the signature subject. */\n  url: string\n  upstashRegion?: string\n}\n\n/** The small part of `@upstash/qstash` this adapter needs. */\nexport type QStashTransport = {\n  publish(request: QStashPublishRequest): Promise<unknown>\n  verify(request: QStashVerifyRequest): Promise<boolean>\n}\n\nexport type QStashSchedulerOptions = {\n  /** Exact URL mounted with `scheduler.handler(...)`. Inferred in local dev and on Vercel. */\n  url?: string\n  /** QStash API token. Default: `QSTASH_TOKEN`. */\n  token?: string\n  /** QStash signing key. Default: `QSTASH_CURRENT_SIGNING_KEY`. */\n  currentSigningKey?: string\n  /** Next QStash signing key. Default: `QSTASH_NEXT_SIGNING_KEY`. */\n  nextSigningKey?: string\n  /** Delivery retries after the initial attempt. Default: provider default. */\n  retries?: number\n  /** Maximum callback body and outbound task with outage headroom. Default 1 MiB. */\n  maxBodyBytes?: number\n  /** Static callback headers. QStash receives them; A2 requests dashboard/API redaction. */\n  headers?: Readonly<Record<string, string>>\n  /** Injectable publishing client. The built-in receiver still verifies callbacks. */\n  client?: QStashPublishingClient\n  /** Injectable transport (tests). Default: `@upstash/qstash`. */\n  transport?: QStashTransport\n  /** Injectable clock for due-time calculations (tests). */\n  clock?: Clock\n}\n\nconst qstashTransport = async (\n  options: Pick<\n    QStashSchedulerOptions,\n    'token' | 'currentSigningKey' | 'nextSigningKey' | 'client'\n  >,\n  developmentMode: boolean | undefined,\n): Promise<QStashTransport> => {\n  const sdk = await import('@upstash/qstash').catch(() => {\n    throw classifySchedulerSendFailure(\n      new Error(\n        \"experimental-a2/scheduler-qstash needs the '@upstash/qstash' package (optional peer dependency) — install it, or inject a transport\",\n      ),\n      'terminal',\n    )\n  })\n  const developmentOverride =\n    developmentMode === undefined ? {} : { devMode: developmentMode }\n  const client: QStashPublishingClient =\n    options.client ??\n    new sdk.Client({\n      ...(options.token === undefined ? {} : { token: options.token }),\n      ...developmentOverride,\n    })\n  const receiver = new sdk.Receiver({\n    ...(options.currentSigningKey === undefined\n      ? {}\n      : { currentSigningKey: options.currentSigningKey }),\n    ...(options.nextSigningKey === undefined\n      ? {}\n      : { nextSigningKey: options.nextSigningKey }),\n    ...developmentOverride,\n  })\n  return {\n    publish: (request) => {\n      const clientRequest: QStashClientPublishRequest = {\n        url: request.url,\n        body: request.body,\n        ...(request.headers === undefined\n          ? {}\n          : { headers: { ...request.headers } }),\n        ...(request.redact === undefined\n          ? {}\n          : { redact: { header: [...request.redact.header] } }),\n        deduplicationId: request.deduplicationId,\n        ...(request.retries === undefined ? {} : { retries: request.retries }),\n        ...(request.notBefore === undefined\n          ? {}\n          : { notBefore: request.notBefore }),\n      }\n      return client.publishJSON(clientRequest)\n    },\n    verify: (request) => receiver.verify(request),\n  }\n}\n\nconst digestId = async (\n  parts: readonly (string | number)[],\n): Promise<string> => {\n  const digest = await crypto.subtle.digest(\n    'SHA-256',\n    new TextEncoder().encode(JSON.stringify(parts)),\n  )\n  const hex = Array.from(new Uint8Array(digest), (byte) =>\n    byte.toString(16).padStart(2, '0'),\n  ).join('')\n  return `a2_${hex}`\n}\n\ntype ParsedQStashMessage = {\n  task: SchedulerTask\n  outage?: QStashStoreOutage\n}\n\nconst recordOf = (value: unknown): Record<string, unknown> | null =>\n  value !== null && typeof value === 'object' && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : null\n\nconst TRUSTED_SOURCE_HEADER = 'x-vercel-trusted-oidc-idp-token'\nconst TRUSTED_SOURCE_DELIVERY_MARGIN_MS = 60_000\nconst RESERVED_CALLBACK_HEADERS = new Set([\n  'connection',\n  'content-length',\n  'host',\n  'keep-alive',\n  'proxy-authenticate',\n  'proxy-authorization',\n  'te',\n  'trailer',\n  'transfer-encoding',\n  'upgrade',\n  'x-vercel-oidc-token',\n  TRUSTED_SOURCE_HEADER,\n])\n\nconst callbackHeaders = (\n  value: Readonly<Record<string, string>> | undefined,\n): Readonly<Record<string, string>> | undefined => {\n  if (value === undefined) return undefined\n\n  let entries: [string, string][]\n  try {\n    entries = Object.entries(value)\n  } catch {\n    throw new TypeError('qstash() headers must be an HTTP header record')\n  }\n\n  const normalized: [string, string][] = []\n  const seen = new Set<string>()\n  for (const [name, headerValue] of entries) {\n    if (typeof headerValue !== 'string') {\n      throw new TypeError('qstash() header values must be strings')\n    }\n    let entry: [string, string] | undefined\n    try {\n      entry = [...new Headers([[name, headerValue]]).entries()][0]\n    } catch {\n      throw new TypeError(\n        'qstash() headers must contain valid HTTP header names and values',\n      )\n    }\n    if (entry === undefined) {\n      throw new TypeError(\n        'qstash() headers must contain valid HTTP header names and values',\n      )\n    }\n    const [normalizedName, normalizedValue] = entry\n    if (seen.has(normalizedName)) {\n      throw new TypeError(\n        `qstash() headers contain duplicate name '${normalizedName}'`,\n      )\n    }\n    if (\n      normalizedName.startsWith('upstash-') ||\n      normalizedName.startsWith('content-type') ||\n      RESERVED_CALLBACK_HEADERS.has(normalizedName)\n    ) {\n      throw new TypeError(\n        `qstash() headers cannot set reserved header '${normalizedName}'`,\n      )\n    }\n    seen.add(normalizedName)\n    normalized.push([normalizedName, normalizedValue])\n  }\n\n  return normalized.length === 0\n    ? undefined\n    : Object.freeze(Object.fromEntries(normalized))\n}\n\nconst publishHeaders = (\n  configured: Readonly<Record<string, string>> | undefined,\n  generated: Pick<QStashPublishRequest, 'headers' | 'redact'> | undefined,\n): Pick<QStashPublishRequest, 'headers' | 'redact'> | undefined => {\n  if (configured === undefined && generated === undefined) return undefined\n\n  const headers = new Headers()\n  const redacted = new Set<string>()\n  for (const [name, value] of Object.entries(configured ?? {})) {\n    headers.set(name, value)\n    redacted.add(name)\n  }\n  for (const [name, value] of Object.entries(generated?.headers ?? {})) {\n    headers.set(name, value)\n    redacted.add(name)\n  }\n  for (const name of generated?.redact?.header ?? []) {\n    const normalized = [...new Headers([[name, 'redacted']]).keys()][0]\n    if (normalized === undefined) {\n      throw new TypeError('qstash generated an invalid redaction header')\n    }\n    redacted.add(normalized)\n  }\n\n  const headerEntries = [...headers.entries()]\n  return {\n    ...(headerEntries.length === 0\n      ? {}\n      : { headers: Object.fromEntries(headerEntries) }),\n    ...(redacted.size === 0\n      ? {}\n      : { redact: { header: [...redacted].toSorted() } }),\n  }\n}\n\nconst jwtExpirationMs = (token: string): number | null => {\n  const parts = token.split('.')\n  const payloadPart = parts.length === 3 ? parts[1] : undefined\n  if (\n    payloadPart === undefined ||\n    payloadPart.length === 0 ||\n    !/^[A-Za-z0-9_-]+$/.test(payloadPart) ||\n    payloadPart.length % 4 === 1\n  ) {\n    return null\n  }\n\n  try {\n    const decode = globalThis.atob\n    if (typeof decode !== 'function') return null\n    const base64 = payloadPart\n      .replaceAll('-', '+')\n      .replaceAll('_', '/')\n      .padEnd(payloadPart.length + ((4 - (payloadPart.length % 4)) % 4), '=')\n    const binary = decode(base64)\n    const bytes = Uint8Array.from(binary, (character) =>\n      character.charCodeAt(0),\n    )\n    const payload = recordOf(JSON.parse(new TextDecoder().decode(bytes)))\n    const expiration = payload?.['exp']\n    if (\n      typeof expiration !== 'number' ||\n      !Number.isSafeInteger(expiration) ||\n      expiration <= 0 ||\n      expiration > Number.MAX_SAFE_INTEGER / 1_000\n    ) {\n      return null\n    }\n    return expiration * 1_000\n  } catch {\n    return null\n  }\n}\n\nconst previewTrustedSource = (\n  firstDeliveryAt: number,\n): Pick<QStashPublishRequest, 'headers' | 'redact'> | undefined => {\n  const token = platformVercelOidcToken()\n  if (token === null) return undefined\n  const expiration = jwtExpirationMs(token)\n  if (\n    expiration === null ||\n    firstDeliveryAt + TRUSTED_SOURCE_DELIVERY_MARGIN_MS > expiration\n  ) {\n    return undefined\n  }\n  return {\n    headers: { [TRUSTED_SOURCE_HEADER]: token },\n    redact: { header: [TRUSTED_SOURCE_HEADER] },\n  }\n}\n\nconst RETRYABLE_HTTP_CLIENT_STATUSES = new Set([408, 409, 425, 429])\n\nconst httpStatusOf = (error: unknown): number | undefined => {\n  try {\n    const record = recordOf(error)\n    if (!record) return undefined\n    const response = recordOf(record['response'])\n    const statuses = [\n      record['status'],\n      record['statusCode'],\n      response?.['status'],\n    ].filter(\n      (value): value is number =>\n        typeof value === 'number' &&\n        Number.isInteger(value) &&\n        value >= 100 &&\n        value <= 599,\n    )\n    const [status] = statuses\n    if (status === undefined) return undefined\n    return statuses.every((candidate) => candidate === status)\n      ? status\n      : undefined\n  } catch {\n    return undefined\n  }\n}\n\nconst classifyQStashPublishFailure = (error: unknown): unknown => {\n  const status = httpStatusOf(error)\n  const terminal =\n    status !== undefined &&\n    status >= 400 &&\n    status < 500 &&\n    !RETRYABLE_HTTP_CLIENT_STATUSES.has(status)\n  return classifySchedulerSendFailure(\n    error,\n    terminal ? 'terminal' : 'retryable',\n  )\n}\n\nconst parseTask = (body: string): ParsedQStashMessage | null => {\n  let value: unknown\n  try {\n    value = JSON.parse(body)\n  } catch {\n    return null\n  }\n  const task = normalizeSchedulerTask(value)\n  const record = recordOf(value)\n  if (!task || !record) return null\n\n  const encodedOutage = record['_a2QStash']\n  if (encodedOutage === undefined) return { task }\n  const outage = recordOf(encodedOutage)\n  const generation = outage?.['generation']\n  if (\n    !outage ||\n    outage['version'] !== 1 ||\n    typeof generation !== 'number' ||\n    !Number.isSafeInteger(generation) ||\n    generation < 0 ||\n    generation >= Number.MAX_SAFE_INTEGER\n  ) {\n    return null\n  }\n\n  const rootDueAt = outage['rootDueAt']\n  if (task.kind === 'drain') {\n    if (\n      typeof rootDueAt !== 'number' ||\n      !Number.isInteger(rootDueAt) ||\n      rootDueAt % 1_000 !== 0\n    ) {\n      return null\n    }\n  } else if (rootDueAt !== undefined) {\n    return null\n  }\n\n  return {\n    task,\n    outage: {\n      version: 1,\n      generation,\n      ...(rootDueAt === undefined ? {} : { rootDueAt }),\n    },\n  }\n}\n\nconst DEFAULT_MAX_BODY_BYTES = 1024 * 1024\nconst STORE_OUTAGE_BASE_DELAY_MS = 30_000\nconst STORE_OUTAGE_MAX_DELAY_MS = 24 * 60 * 60 * 1_000\n\nconst readBoundedBody = async (\n  request: Request,\n  maxBytes: number,\n): Promise<string | null> => {\n  const declared = request.headers.get('content-length')\n  if (\n    declared !== null &&\n    /^\\d+$/.test(declared) &&\n    Number(declared) > maxBytes\n  ) {\n    return null\n  }\n\n  if (request.body === null) return ''\n  const reader = request.body.getReader()\n  const chunks: Uint8Array[] = []\n  let length = 0\n  try {\n    for (;;) {\n      // oxlint-disable-next-line no-await-in-loop\n      const { done, value } = await reader.read()\n      if (done) break\n      length += value.byteLength\n      if (length > maxBytes) {\n        // oxlint-disable-next-line no-await-in-loop\n        await reader.cancel().catch(() => {})\n        return null\n      }\n      chunks.push(value)\n    }\n  } finally {\n    reader.releaseLock()\n  }\n\n  const bytes = new Uint8Array(length)\n  let offset = 0\n  for (const chunk of chunks) {\n    bytes.set(chunk, offset)\n    offset += chunk.byteLength\n  }\n  return new TextDecoder().decode(bytes)\n}\n\nconst storeUnavailable = (error: unknown): error is A2Error =>\n  error instanceof A2Error && error.code === 'STORE_UNAVAILABLE'\n\nconst response = {\n  ok: (): Response => new Response('ok'),\n  unauthorized: (): Response => new Response('unauthorized', { status: 401 }),\n  malformed: (): Response =>\n    new Response('invalid a2 scheduler message', {\n      status: 489,\n      headers: { 'Upstash-NonRetryable-Error': 'true' },\n    }),\n  tooLarge: (): Response =>\n    new Response('a2 scheduler message is too large', {\n      status: 489,\n      headers: { 'Upstash-NonRetryable-Error': 'true' },\n    }),\n}\n\nconst CALLBACK_PATH = '/api/a2/scheduler'\nconst DEFAULT_DEVELOPMENT_PORT = 3_000\n\nconst developmentCallbackUrl = (portValue: string | undefined): string => {\n  const port =\n    portValue === undefined || portValue === ''\n      ? DEFAULT_DEVELOPMENT_PORT\n      : Number(portValue)\n  if (\n    !Number.isSafeInteger(port) ||\n    port < 1 ||\n    port > 65_535 ||\n    (portValue !== undefined && portValue !== '' && !/^\\d+$/.test(portValue))\n  ) {\n    throw new TypeError(\n      'qstash() could not infer url: PORT must be an integer from 1 to 65535 for local development',\n    )\n  }\n  return `http://localhost:${String(port)}${CALLBACK_PATH}`\n}\n\ntype CallbackResolution = {\n  callbackUrl: string\n  /** An SDK override. Undefined preserves the SDK's environment behavior. */\n  developmentMode?: boolean\n  inferredVercelPreview?: true\n}\n\nconst inferCallbackUrl = (): CallbackResolution => {\n  const env = typeof process === 'undefined' ? undefined : process.env\n  const vercelEnv = env?.['VERCEL_ENV']\n  const variable =\n    env?.['VERCEL'] !== '1'\n      ? null\n      : vercelEnv === 'production'\n        ? 'VERCEL_PROJECT_PRODUCTION_URL'\n        : vercelEnv === 'preview'\n          ? 'VERCEL_BRANCH_URL'\n          : null\n  if (variable !== null) {\n    const host = env?.[variable]\n    if (!host) {\n      throw new TypeError(\n        `qstash() could not infer url: ${variable} is missing`,\n      )\n    }\n    let origin: URL\n    try {\n      origin = new URL(`https://${host}`)\n    } catch {\n      throw new TypeError(\n        `qstash() could not infer url: ${variable} must be a hostname`,\n      )\n    }\n    if (\n      origin.host !== host ||\n      origin.pathname !== '/' ||\n      origin.search !== '' ||\n      origin.hash !== '' ||\n      origin.username !== '' ||\n      origin.password !== '' ||\n      origin.port !== ''\n    ) {\n      throw new TypeError(\n        `qstash() could not infer url: ${variable} must be a hostname`,\n      )\n    }\n    return {\n      callbackUrl: new URL(CALLBACK_PATH, origin).toString(),\n      developmentMode: false,\n      ...(vercelEnv === 'preview' ? { inferredVercelPreview: true } : {}),\n    }\n  }\n\n  if (env === undefined) {\n    throw new TypeError(\n      'qstash() needs url when the runtime cannot identify local development',\n    )\n  }\n\n  if (env['NODE_ENV'] === 'production') {\n    throw new TypeError(\n      'qstash() needs url in production outside a Vercel production or preview deployment',\n    )\n  }\n\n  return {\n    callbackUrl: developmentCallbackUrl(env['PORT']),\n    developmentMode: true,\n  }\n}\n\nexport function qstash(options: QStashSchedulerOptions = {}): A2Scheduler {\n  const env = typeof process === 'undefined' ? undefined : process.env\n  const resolution: CallbackResolution =\n    options.url === undefined\n      ? inferCallbackUrl()\n      : {\n          callbackUrl: options.url,\n          ...(env?.['NODE_ENV'] === 'production'\n            ? { developmentMode: false }\n            : {}),\n        }\n  const { callbackUrl, developmentMode, inferredVercelPreview } = resolution\n  let parsedUrl: URL\n  try {\n    parsedUrl = new URL(callbackUrl)\n  } catch {\n    throw new TypeError('qstash() needs an absolute callback url')\n  }\n  if (parsedUrl.protocol !== 'http:' && parsedUrl.protocol !== 'https:') {\n    throw new TypeError('qstash() callback url must use http or https')\n  }\n  if (options.client !== undefined && options.transport !== undefined) {\n    throw new TypeError('qstash() cannot combine client and transport')\n  }\n  if (options.client !== undefined && options.token !== undefined) {\n    throw new TypeError('qstash() cannot combine client and token')\n  }\n  const url = parsedUrl.toString()\n  const configuredHeaders = callbackHeaders(options.headers)\n  const { retries } = options\n  if (\n    retries !== undefined &&\n    (!Number.isSafeInteger(retries) || retries < 0)\n  ) {\n    throw new TypeError('qstash() retries must be a non-negative integer')\n  }\n  const maxBodyBytes = options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES\n  if (!Number.isSafeInteger(maxBodyBytes) || maxBodyBytes < 1) {\n    throw new TypeError('qstash() maxBodyBytes must be a positive integer')\n  }\n  const clock = options.clock ?? SYSTEM_CLOCK\n\n  // Lazy: construction does no I/O and does not require the optional peer.\n  const transport = retryableLazy(() =>\n    options.transport\n      ? Promise.resolve(options.transport)\n      : qstashTransport(options, developmentMode),\n  ).get\n\n  const storeOutageDeduplicationId = (\n    task: SchedulerTask,\n    outage: QStashStoreOutage,\n  ): Promise<string> => {\n    if (task.kind === 'clear') {\n      return digestId([\n        'a2:scheduler-qstash:store-outage:clear:v1',\n        url,\n        task.contract,\n        task.sessionId,\n        task.id,\n        outage.generation,\n      ])\n    }\n    if (task.kind === 'append') {\n      return digestId([\n        'a2:scheduler-qstash:store-outage:append:v1',\n        url,\n        task.contract,\n        task.sessionId,\n        task.id,\n        outage.generation,\n      ])\n    }\n    const { rootDueAt } = outage\n    if (rootDueAt === undefined) {\n      throw new TypeError('qstash store-outage drain needs a root dueAt')\n    }\n    return digestId([\n      'a2:scheduler-qstash:store-outage:drain:v1',\n      url,\n      task.contract,\n      task.sessionId,\n      rootDueAt,\n      outage.generation,\n    ])\n  }\n\n  const sendTask = async (\n    task: SchedulerTask,\n    outage?: QStashStoreOutage,\n  ): Promise<void> => {\n    const nowMs = clock.now().getTime()\n    const requestedDueAt = task.dueAt\n    if (!Number.isFinite(requestedDueAt)) {\n      throw classifySchedulerSendFailure(\n        new TypeError('qstash scheduler dueAt must be a finite number'),\n        'terminal',\n      )\n    }\n    const dueAt =\n      requestedDueAt <= nowMs\n        ? Math.floor(nowMs / 1_000) * 1_000\n        : Math.ceil(requestedDueAt / 1_000) * 1_000\n    const normalizedTask: SchedulerTask =\n      task.kind === 'append'\n        ? {\n            version: 1,\n            kind: 'append',\n            id: task.id,\n            contract: task.contract,\n            sessionId: task.sessionId,\n            dueAt,\n            events: task.events,\n            ...(task.originIndex === undefined\n              ? {}\n              : { originIndex: task.originIndex }),\n          }\n        : task.kind === 'clear'\n          ? {\n              version: 1,\n              kind: 'clear',\n              id: task.id,\n              contract: task.contract,\n              sessionId: task.sessionId,\n              dueAt,\n              ifLastIndex: task.ifLastIndex,\n            }\n          : {\n              version: 1,\n              kind: 'drain',\n              contract: task.contract,\n              sessionId: task.sessionId,\n              dueAt,\n            }\n    const message: QStashMessage = {\n      ...normalizedTask,\n      ...(outage === undefined ? {} : { _a2QStash: outage }),\n    }\n    const sizeCheckedMessage: QStashMessage =\n      outage === undefined\n        ? {\n            ...normalizedTask,\n            _a2QStash:\n              normalizedTask.kind !== 'drain'\n                ? { version: 1, generation: Number.MAX_SAFE_INTEGER }\n                : {\n                    version: 1,\n                    generation: Number.MAX_SAFE_INTEGER,\n                    rootDueAt: dueAt,\n                  },\n          }\n        : message\n    let bodyBytes: number\n    try {\n      bodyBytes = new TextEncoder().encode(\n        JSON.stringify(sizeCheckedMessage),\n      ).byteLength\n    } catch (error) {\n      throw classifySchedulerSendFailure(error, 'terminal')\n    }\n    if (bodyBytes > maxBodyBytes) {\n      throw classifySchedulerSendFailure(\n        new RangeError('qstash scheduler message exceeds maxBodyBytes'),\n        'terminal',\n      )\n    }\n    const deduplicationId =\n      outage !== undefined\n        ? await storeOutageDeduplicationId(task, outage)\n        : task.kind === 'append'\n          ? await digestId(['a2:scheduler-qstash:append:v1', url, task.id])\n          : task.kind === 'clear'\n            ? await digestId(['a2:scheduler-qstash:clear:v1', url, task.id])\n            : await digestId([\n                'a2:scheduler-qstash:v1',\n                url,\n                task.contract,\n                task.sessionId,\n                dueAt,\n              ])\n    const trustedSource =\n      inferredVercelPreview === true\n        ? previewTrustedSource(Math.max(nowMs, dueAt))\n        : undefined\n    const deliveryHeaders = publishHeaders(configuredHeaders, trustedSource)\n    const t = await transport()\n    try {\n      await t.publish({\n        url,\n        body: message,\n        ...deliveryHeaders,\n        ...(dueAt <= nowMs ? {} : { notBefore: dueAt / 1_000 }),\n        deduplicationId,\n        ...(retries === undefined ? {} : { retries }),\n      })\n    } catch (error) {\n      throw classifyQStashPublishFailure(error)\n    }\n  }\n\n  const sendStoreOutageSuccessor = async (\n    task: SchedulerTask,\n    outage?: QStashStoreOutage,\n  ): Promise<void> => {\n    const generation = (outage?.generation ?? -1) + 1\n    const exponent = Math.min(generation, 6)\n    const delayMs = Math.min(\n      STORE_OUTAGE_MAX_DELAY_MS,\n      STORE_OUTAGE_BASE_DELAY_MS * 4 ** exponent,\n    )\n    const nowMs = clock.now().getTime()\n    const dueAt = Math.ceil((nowMs + delayMs) / 1_000) * 1_000\n    const nextOutage: QStashStoreOutage =\n      task.kind !== 'drain'\n        ? { version: 1, generation }\n        : { version: 1, generation, rootDueAt: outage?.rootDueAt ?? task.dueAt }\n    await sendTask({ ...task, dueAt }, nextOutage)\n  }\n\n  const successorDueAt = (message: { dueAt: number }): number => {\n    const minimumDueAt =\n      clock.now().getTime() +\n      DRAIN_TIMINGS.claimTtlMs +\n      DRAIN_TIMINGS.watchdogGraceMs\n    const beats = Math.max(\n      1,\n      Math.ceil(\n        (minimumDueAt - message.dueAt) / DRAIN_TIMINGS.claimHeartbeatMs,\n      ),\n    )\n    return message.dueAt + beats * DRAIN_TIMINGS.claimHeartbeatMs\n  }\n\n  return {\n    async schedule(task) {\n      await sendTask(task)\n    },\n\n    handler(...servers: DrainableServer[]) {\n      assertSchedulerTargets(servers)\n      const byContract = new Map<string, DrainableServer>()\n      for (const server of servers) {\n        byContract.set(server.contract.name, server)\n      }\n      return async (req: Request): Promise<Response> => {\n        const signature = req.headers.get('upstash-signature')\n        if (!signature) return response.unauthorized()\n\n        const body = await readBoundedBody(req, maxBodyBytes)\n        if (body === null) return response.tooLarge()\n        const upstashRegion = req.headers.get('upstash-region')\n        const t = await transport()\n        try {\n          const valid = await t.verify({\n            signature,\n            body,\n            url,\n            ...(upstashRegion === null ? {} : { upstashRegion }),\n          })\n          if (!valid) return response.unauthorized()\n        } catch {\n          return response.unauthorized()\n        }\n\n        const parsed = parseTask(body)\n        if (!parsed) return response.malformed()\n        const { task, outage } = parsed\n\n        const server = byContract.get(task.contract)\n        if (!server) {\n          throw new Error(\n            `a2 scheduler: no server for contract '${task.contract}' — pass it to scheduler.handler(...)`,\n          )\n        }\n        const internals = serverInternals.get(server)\n        if (task.kind !== 'drain') {\n          try {\n            if (task.kind === 'append')\n              await deliverSchedulerAppend(server, task)\n            else await deliverSchedulerClear(server, task)\n          } catch (error) {\n            if (!storeUnavailable(error)) throw error\n            await sendStoreOutageSuccessor(task, outage)\n          }\n          return response.ok()\n        }\n\n        const nextDueAt = successorDueAt(task)\n        let result: DrainResult | { settled: boolean; outcome: 'unknown' }\n        try {\n          result = internals\n            ? await internals.schedulerDrain(task.sessionId, {\n                watchdogDueAt: nextDueAt,\n              })\n            : {\n                ...(await server.drain(task.sessionId)),\n                outcome: 'unknown' as const,\n              }\n        } catch (error) {\n          if (!storeUnavailable(error)) throw error\n          await sendStoreOutageSuccessor(task, outage)\n          return response.ok()\n        }\n        if (result.settled) return response.ok()\n\n        if (result.outcome === 'busy' || result.outcome === 'stalled') {\n          if (result.schedulerArm) await result.schedulerArm\n          else {\n            await sendTask({\n              version: 1,\n              kind: 'drain',\n              contract: task.contract,\n              sessionId: task.sessionId,\n              dueAt: nextDueAt,\n            })\n          }\n          return response.ok()\n        }\n\n        // A drain whose outcome is unknown hands its work to a fresh durable\n        // message: QStash's per-message retry default can be lower than A2's\n        // failure budget. If this publish fails, the throw keeps the current\n        // delivery retryable.\n        await sendTask({\n          version: 1,\n          kind: 'drain',\n          contract: task.contract,\n          sessionId: task.sessionId,\n          dueAt: nextDueAt,\n        })\n        return response.ok()\n      }\n    },\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"scheduler-qstash.js","names":[],"sources":["../src/scheduler-qstash.ts"],"sourcesContent":["/**\n * experimental-a2/scheduler-qstash — HTTP scheduler over Upstash QStash.\n *\n * QStash publishes one signed HTTP delivery per scheduler task. Drain tasks\n * use an absolute, whole-second `notBefore` and a fixed-size deduplication id;\n * append and clear tasks hash their stable task id with the callback URL, each\n * under its own version tag.\n * Store-outage successors carry a signed private generation and back off to\n * one day without deriving their deduplication identity from the local clock.\n * `handler(...servers)` verifies the signature over the raw request body\n * before parsing it, then applies the same drain protocol as the Vercel\n * scheduler adapter.\n *\n * `@upstash/qstash` is an optional peer dependency, imported lazily. The\n * structural `transport` option keeps its types out of A2's public surface and\n * gives tests a provider-faithful injection seam.\n */\n\nimport {\n  assertSchedulerTargets,\n  classifySchedulerSendFailure,\n  DRAIN_TIMINGS,\n  serverInternals,\n  type DrainResult,\n} from './internal.ts'\nimport { A2Error } from './errors.ts'\nimport { platformVercelOidcToken } from './platform.ts'\nimport { retryableLazy } from './retryable-lazy.ts'\nimport { normalizeSchedulerTask, type SchedulerTask } from './scheduler-task.ts'\nimport {\n  deliverSchedulerAppend,\n  deliverSchedulerClear,\n  type A2Scheduler,\n  type DrainableServer,\n} from './server.ts'\nimport { SYSTEM_CLOCK, type Clock } from './store.ts'\n\ntype QStashStoreOutage = {\n  version: 1\n  /** Zero is the first successor created for a store outage. */\n  generation: number\n  /** The first failing drain task's due time. Append and clear identity lives on the task. */\n  rootDueAt?: number\n}\n\ntype QStashMessage = SchedulerTask & {\n  /** Provider-private state authenticated as part of QStash's signed body. */\n  _a2QStash?: QStashStoreOutage\n}\n\nexport type QStashPublishRequest = {\n  url: string\n  body: QStashMessage\n  /** Headers the transport must deliver to the callback. */\n  headers?: Readonly<Record<string, string>>\n  /** Header names the transport must redact from provider dashboard/API views. */\n  redact?: {\n    header: readonly string[]\n  }\n  /** Whole-second Unix timestamp. Omitted for an immediate delivery. */\n  notBefore?: number\n  deduplicationId: string\n  /** Delivery retries after the initial attempt. */\n  retries?: number\n}\n\n/** The request shape passed to an injected `@upstash/qstash` client. */\nexport type QStashClientPublishRequest = Omit<\n  QStashPublishRequest,\n  'headers' | 'redact'\n> & {\n  headers?: Record<string, string>\n  redact?: {\n    header: string[]\n  }\n}\n\n/** The outbound part of `@upstash/qstash` used by the built-in transport. */\nexport type QStashPublishingClient = {\n  publishJSON(request: QStashClientPublishRequest): Promise<unknown>\n}\n\nexport type QStashVerifyRequest = {\n  signature: string\n  /** The untouched request body covered by the signature. */\n  body: string\n  /** Exact destination URL, checked against the signature subject. */\n  url: string\n  upstashRegion?: string\n}\n\n/** The small part of `@upstash/qstash` this adapter needs. */\nexport type QStashTransport = {\n  publish(request: QStashPublishRequest): Promise<unknown>\n  verify(request: QStashVerifyRequest): Promise<boolean>\n}\n\nexport type QStashSchedulerOptions = {\n  /** Exact URL mounted with `scheduler.handler(...)`. Inferred in local dev and on Vercel. */\n  url?: string\n  /** QStash API token. Default: `QSTASH_TOKEN`. */\n  token?: string\n  /** QStash signing key. Default: `QSTASH_CURRENT_SIGNING_KEY`. */\n  currentSigningKey?: string\n  /** Next QStash signing key. Default: `QSTASH_NEXT_SIGNING_KEY`. */\n  nextSigningKey?: string\n  /** Delivery retries after the initial attempt. Default: provider default. */\n  retries?: number\n  /** Maximum callback body and outbound task with outage headroom. Default 1 MiB. */\n  maxBodyBytes?: number\n  /** Static callback headers. QStash receives them; A2 requests dashboard/API redaction. */\n  headers?: Readonly<Record<string, string>>\n  /** Injectable publishing client. The built-in receiver still verifies callbacks. */\n  client?: QStashPublishingClient\n  /** Injectable transport (tests). Default: `@upstash/qstash`. */\n  transport?: QStashTransport\n  /** Injectable clock for due-time calculations (tests). */\n  clock?: Clock\n}\n\nconst qstashTransport = async (\n  options: Pick<\n    QStashSchedulerOptions,\n    'token' | 'currentSigningKey' | 'nextSigningKey' | 'client'\n  >,\n  developmentMode: boolean | undefined,\n): Promise<QStashTransport> => {\n  const sdk = await import('@upstash/qstash').catch(() => {\n    throw classifySchedulerSendFailure(\n      new Error(\n        \"experimental-a2/scheduler-qstash needs the '@upstash/qstash' package (optional peer dependency) — install it, or inject a transport\",\n      ),\n      'terminal',\n    )\n  })\n  const developmentOverride =\n    developmentMode === undefined ? {} : { devMode: developmentMode }\n  const client: QStashPublishingClient =\n    options.client ??\n    new sdk.Client({\n      ...(options.token === undefined ? {} : { token: options.token }),\n      ...developmentOverride,\n    })\n  const receiver = new sdk.Receiver({\n    ...(options.currentSigningKey === undefined\n      ? {}\n      : { currentSigningKey: options.currentSigningKey }),\n    ...(options.nextSigningKey === undefined\n      ? {}\n      : { nextSigningKey: options.nextSigningKey }),\n    ...developmentOverride,\n  })\n  return {\n    publish: (request) => {\n      const clientRequest: QStashClientPublishRequest = {\n        url: request.url,\n        body: request.body,\n        ...(request.headers === undefined\n          ? {}\n          : { headers: { ...request.headers } }),\n        ...(request.redact === undefined\n          ? {}\n          : { redact: { header: [...request.redact.header] } }),\n        deduplicationId: request.deduplicationId,\n        ...(request.retries === undefined ? {} : { retries: request.retries }),\n        ...(request.notBefore === undefined\n          ? {}\n          : { notBefore: request.notBefore }),\n      }\n      return client.publishJSON(clientRequest)\n    },\n    verify: (request) => receiver.verify(request),\n  }\n}\n\nconst digestId = async (\n  parts: readonly (string | number)[],\n): Promise<string> => {\n  const digest = await crypto.subtle.digest(\n    'SHA-256',\n    new TextEncoder().encode(JSON.stringify(parts)),\n  )\n  const hex = Array.from(new Uint8Array(digest), (byte) =>\n    byte.toString(16).padStart(2, '0'),\n  ).join('')\n  return `a2_${hex}`\n}\n\ntype ParsedQStashMessage = {\n  task: SchedulerTask\n  outage?: QStashStoreOutage\n}\n\nconst recordOf = (value: unknown): Record<string, unknown> | null =>\n  value !== null && typeof value === 'object' && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : null\n\nconst TRUSTED_SOURCE_HEADER = 'x-vercel-trusted-oidc-idp-token'\nconst TRUSTED_SOURCE_DELIVERY_MARGIN_MS = 60_000\nconst RESERVED_CALLBACK_HEADERS = new Set([\n  'connection',\n  'content-length',\n  'host',\n  'keep-alive',\n  'proxy-authenticate',\n  'proxy-authorization',\n  'te',\n  'trailer',\n  'transfer-encoding',\n  'upgrade',\n  'x-vercel-oidc-token',\n  TRUSTED_SOURCE_HEADER,\n])\n\nconst callbackHeaders = (\n  value: Readonly<Record<string, string>> | undefined,\n): Readonly<Record<string, string>> | undefined => {\n  if (value === undefined) return undefined\n\n  let entries: [string, string][]\n  try {\n    entries = Object.entries(value)\n  } catch {\n    throw new TypeError('qstash() headers must be an HTTP header record')\n  }\n\n  const normalized: [string, string][] = []\n  const seen = new Set<string>()\n  for (const [name, headerValue] of entries) {\n    if (typeof headerValue !== 'string') {\n      throw new TypeError('qstash() header values must be strings')\n    }\n    let entry: [string, string] | undefined\n    try {\n      entry = [...new Headers([[name, headerValue]]).entries()][0]\n    } catch {\n      throw new TypeError(\n        'qstash() headers must contain valid HTTP header names and values',\n      )\n    }\n    if (entry === undefined) {\n      throw new TypeError(\n        'qstash() headers must contain valid HTTP header names and values',\n      )\n    }\n    const [normalizedName, normalizedValue] = entry\n    if (seen.has(normalizedName)) {\n      throw new TypeError(\n        `qstash() headers contain duplicate name '${normalizedName}'`,\n      )\n    }\n    if (\n      normalizedName.startsWith('upstash-') ||\n      normalizedName.startsWith('content-type') ||\n      RESERVED_CALLBACK_HEADERS.has(normalizedName)\n    ) {\n      throw new TypeError(\n        `qstash() headers cannot set reserved header '${normalizedName}'`,\n      )\n    }\n    seen.add(normalizedName)\n    normalized.push([normalizedName, normalizedValue])\n  }\n\n  return normalized.length === 0\n    ? undefined\n    : Object.freeze(Object.fromEntries(normalized))\n}\n\nconst publishHeaders = (\n  configured: Readonly<Record<string, string>> | undefined,\n  generated: Pick<QStashPublishRequest, 'headers' | 'redact'> | undefined,\n): Pick<QStashPublishRequest, 'headers' | 'redact'> | undefined => {\n  if (configured === undefined && generated === undefined) return undefined\n\n  const headers = new Headers()\n  const redacted = new Set<string>()\n  for (const [name, value] of Object.entries(configured ?? {})) {\n    headers.set(name, value)\n    redacted.add(name)\n  }\n  for (const [name, value] of Object.entries(generated?.headers ?? {})) {\n    headers.set(name, value)\n    redacted.add(name)\n  }\n  for (const name of generated?.redact?.header ?? []) {\n    const normalized = [...new Headers([[name, 'redacted']]).keys()][0]\n    if (normalized === undefined) {\n      throw new TypeError('qstash generated an invalid redaction header')\n    }\n    redacted.add(normalized)\n  }\n\n  const headerEntries = [...headers.entries()]\n  return {\n    ...(headerEntries.length === 0\n      ? {}\n      : { headers: Object.fromEntries(headerEntries) }),\n    ...(redacted.size === 0\n      ? {}\n      : { redact: { header: [...redacted].toSorted() } }),\n  }\n}\n\nconst jwtExpirationMs = (token: string): number | null => {\n  const parts = token.split('.')\n  const payloadPart = parts.length === 3 ? parts[1] : undefined\n  if (\n    payloadPart === undefined ||\n    payloadPart.length === 0 ||\n    !/^[A-Za-z0-9_-]+$/.test(payloadPart) ||\n    payloadPart.length % 4 === 1\n  ) {\n    return null\n  }\n\n  try {\n    const decode = globalThis.atob\n    if (typeof decode !== 'function') return null\n    const base64 = payloadPart\n      .replaceAll('-', '+')\n      .replaceAll('_', '/')\n      .padEnd(payloadPart.length + ((4 - (payloadPart.length % 4)) % 4), '=')\n    const binary = decode(base64)\n    const bytes = Uint8Array.from(binary, (character) =>\n      character.charCodeAt(0),\n    )\n    const payload = recordOf(JSON.parse(new TextDecoder().decode(bytes)))\n    const expiration = payload?.['exp']\n    if (\n      typeof expiration !== 'number' ||\n      !Number.isSafeInteger(expiration) ||\n      expiration <= 0 ||\n      expiration > Number.MAX_SAFE_INTEGER / 1_000\n    ) {\n      return null\n    }\n    return expiration * 1_000\n  } catch {\n    return null\n  }\n}\n\nconst previewTrustedSource = (\n  firstDeliveryAt: number,\n): Pick<QStashPublishRequest, 'headers' | 'redact'> | undefined => {\n  const token = platformVercelOidcToken()\n  if (token === null) return undefined\n  const expiration = jwtExpirationMs(token)\n  if (\n    expiration === null ||\n    firstDeliveryAt + TRUSTED_SOURCE_DELIVERY_MARGIN_MS > expiration\n  ) {\n    return undefined\n  }\n  return {\n    headers: { [TRUSTED_SOURCE_HEADER]: token },\n    redact: { header: [TRUSTED_SOURCE_HEADER] },\n  }\n}\n\nconst RETRYABLE_HTTP_CLIENT_STATUSES = new Set([408, 409, 425, 429])\n\nconst httpStatusOf = (error: unknown): number | undefined => {\n  try {\n    const record = recordOf(error)\n    if (!record) return undefined\n    const response = recordOf(record['response'])\n    const statuses = [\n      record['status'],\n      record['statusCode'],\n      response?.['status'],\n    ].filter(\n      (value): value is number =>\n        typeof value === 'number' &&\n        Number.isInteger(value) &&\n        value >= 100 &&\n        value <= 599,\n    )\n    const [status] = statuses\n    if (status === undefined) return undefined\n    return statuses.every((candidate) => candidate === status)\n      ? status\n      : undefined\n  } catch {\n    return undefined\n  }\n}\n\nconst classifyQStashPublishFailure = (error: unknown): unknown => {\n  const status = httpStatusOf(error)\n  const terminal =\n    status !== undefined &&\n    status >= 400 &&\n    status < 500 &&\n    !RETRYABLE_HTTP_CLIENT_STATUSES.has(status)\n  return classifySchedulerSendFailure(\n    error,\n    terminal ? 'terminal' : 'retryable',\n  )\n}\n\nconst parseTask = (body: string): ParsedQStashMessage | null => {\n  let value: unknown\n  try {\n    value = JSON.parse(body)\n  } catch {\n    return null\n  }\n  const task = normalizeSchedulerTask(value)\n  const record = recordOf(value)\n  if (!task || !record) return null\n\n  const encodedOutage = record['_a2QStash']\n  if (encodedOutage === undefined) return { task }\n  const outage = recordOf(encodedOutage)\n  const generation = outage?.['generation']\n  if (\n    !outage ||\n    outage['version'] !== 1 ||\n    typeof generation !== 'number' ||\n    !Number.isSafeInteger(generation) ||\n    generation < 0 ||\n    generation >= Number.MAX_SAFE_INTEGER\n  ) {\n    return null\n  }\n\n  const rootDueAt = outage['rootDueAt']\n  if (task.kind === 'drain') {\n    if (\n      typeof rootDueAt !== 'number' ||\n      !Number.isInteger(rootDueAt) ||\n      rootDueAt % 1_000 !== 0\n    ) {\n      return null\n    }\n  } else if (rootDueAt !== undefined) {\n    return null\n  }\n\n  return {\n    task,\n    outage: {\n      version: 1,\n      generation,\n      ...(rootDueAt === undefined ? {} : { rootDueAt }),\n    },\n  }\n}\n\nconst DEFAULT_MAX_BODY_BYTES = 1024 * 1024\nconst STORE_OUTAGE_BASE_DELAY_MS = 30_000\nconst STORE_OUTAGE_MAX_DELAY_MS = 24 * 60 * 60 * 1_000\n\nconst readBoundedBody = async (\n  request: Request,\n  maxBytes: number,\n): Promise<string | null> => {\n  const declared = request.headers.get('content-length')\n  if (\n    declared !== null &&\n    /^\\d+$/.test(declared) &&\n    Number(declared) > maxBytes\n  ) {\n    return null\n  }\n\n  if (request.body === null) return ''\n  const reader = request.body.getReader()\n  const chunks: Uint8Array[] = []\n  let length = 0\n  try {\n    for (;;) {\n      // oxlint-disable-next-line no-await-in-loop\n      const { done, value } = await reader.read()\n      if (done) break\n      length += value.byteLength\n      if (length > maxBytes) {\n        // oxlint-disable-next-line no-await-in-loop\n        await reader.cancel().catch(() => {})\n        return null\n      }\n      chunks.push(value)\n    }\n  } finally {\n    reader.releaseLock()\n  }\n\n  const bytes = new Uint8Array(length)\n  let offset = 0\n  for (const chunk of chunks) {\n    bytes.set(chunk, offset)\n    offset += chunk.byteLength\n  }\n  return new TextDecoder().decode(bytes)\n}\n\n// A store that isn't set up yet (Postgres before schema.sql, a missing driver)\n// is fixed without changing the task, so its work waits like any outage.\nconst storeOutage = (error: unknown): error is A2Error =>\n  error instanceof A2Error &&\n  (error.code === 'STORE_UNAVAILABLE' || error.code === 'STORE_NOT_CONFIGURED')\n\nconst response = {\n  ok: (): Response => new Response('ok'),\n  unauthorized: (): Response => new Response('unauthorized', { status: 401 }),\n  malformed: (): Response =>\n    new Response('invalid a2 scheduler message', {\n      status: 489,\n      headers: { 'Upstash-NonRetryable-Error': 'true' },\n    }),\n  tooLarge: (): Response =>\n    new Response('a2 scheduler message is too large', {\n      status: 489,\n      headers: { 'Upstash-NonRetryable-Error': 'true' },\n    }),\n}\n\nconst CALLBACK_PATH = '/api/a2/scheduler'\nconst DEFAULT_DEVELOPMENT_PORT = 3_000\n\nconst developmentCallbackUrl = (portValue: string | undefined): string => {\n  const port =\n    portValue === undefined || portValue === ''\n      ? DEFAULT_DEVELOPMENT_PORT\n      : Number(portValue)\n  if (\n    !Number.isSafeInteger(port) ||\n    port < 1 ||\n    port > 65_535 ||\n    (portValue !== undefined && portValue !== '' && !/^\\d+$/.test(portValue))\n  ) {\n    throw new TypeError(\n      'qstash() could not infer url: PORT must be an integer from 1 to 65535 for local development',\n    )\n  }\n  return `http://localhost:${String(port)}${CALLBACK_PATH}`\n}\n\ntype CallbackResolution = {\n  callbackUrl: string\n  /** An SDK override. Undefined preserves the SDK's environment behavior. */\n  developmentMode?: boolean\n  inferredVercelPreview?: true\n}\n\nconst inferCallbackUrl = (): CallbackResolution => {\n  const env = typeof process === 'undefined' ? undefined : process.env\n  const vercelEnv = env?.['VERCEL_ENV']\n  const variable =\n    env?.['VERCEL'] !== '1'\n      ? null\n      : vercelEnv === 'production'\n        ? 'VERCEL_PROJECT_PRODUCTION_URL'\n        : vercelEnv === 'preview'\n          ? 'VERCEL_BRANCH_URL'\n          : null\n  if (variable !== null) {\n    const host = env?.[variable]\n    if (!host) {\n      throw new TypeError(\n        `qstash() could not infer url: ${variable} is missing`,\n      )\n    }\n    let origin: URL\n    try {\n      origin = new URL(`https://${host}`)\n    } catch {\n      throw new TypeError(\n        `qstash() could not infer url: ${variable} must be a hostname`,\n      )\n    }\n    if (\n      origin.host !== host ||\n      origin.pathname !== '/' ||\n      origin.search !== '' ||\n      origin.hash !== '' ||\n      origin.username !== '' ||\n      origin.password !== '' ||\n      origin.port !== ''\n    ) {\n      throw new TypeError(\n        `qstash() could not infer url: ${variable} must be a hostname`,\n      )\n    }\n    return {\n      callbackUrl: new URL(CALLBACK_PATH, origin).toString(),\n      developmentMode: false,\n      ...(vercelEnv === 'preview' ? { inferredVercelPreview: true } : {}),\n    }\n  }\n\n  if (env === undefined) {\n    throw new TypeError(\n      'qstash() needs url when the runtime cannot identify local development',\n    )\n  }\n\n  if (env['NODE_ENV'] === 'production') {\n    throw new TypeError(\n      'qstash() needs url in production outside a Vercel production or preview deployment',\n    )\n  }\n\n  return {\n    callbackUrl: developmentCallbackUrl(env['PORT']),\n    developmentMode: true,\n  }\n}\n\nexport function qstash(options: QStashSchedulerOptions = {}): A2Scheduler {\n  const env = typeof process === 'undefined' ? undefined : process.env\n  const resolution: CallbackResolution =\n    options.url === undefined\n      ? inferCallbackUrl()\n      : {\n          callbackUrl: options.url,\n          ...(env?.['NODE_ENV'] === 'production'\n            ? { developmentMode: false }\n            : {}),\n        }\n  const { callbackUrl, developmentMode, inferredVercelPreview } = resolution\n  let parsedUrl: URL\n  try {\n    parsedUrl = new URL(callbackUrl)\n  } catch {\n    throw new TypeError('qstash() needs an absolute callback url')\n  }\n  if (parsedUrl.protocol !== 'http:' && parsedUrl.protocol !== 'https:') {\n    throw new TypeError('qstash() callback url must use http or https')\n  }\n  if (options.client !== undefined && options.transport !== undefined) {\n    throw new TypeError('qstash() cannot combine client and transport')\n  }\n  if (options.client !== undefined && options.token !== undefined) {\n    throw new TypeError('qstash() cannot combine client and token')\n  }\n  const url = parsedUrl.toString()\n  const configuredHeaders = callbackHeaders(options.headers)\n  const { retries } = options\n  if (\n    retries !== undefined &&\n    (!Number.isSafeInteger(retries) || retries < 0)\n  ) {\n    throw new TypeError('qstash() retries must be a non-negative integer')\n  }\n  const maxBodyBytes = options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES\n  if (!Number.isSafeInteger(maxBodyBytes) || maxBodyBytes < 1) {\n    throw new TypeError('qstash() maxBodyBytes must be a positive integer')\n  }\n  const clock = options.clock ?? SYSTEM_CLOCK\n\n  // Lazy: construction does no I/O and does not require the optional peer.\n  const transport = retryableLazy(() =>\n    options.transport\n      ? Promise.resolve(options.transport)\n      : qstashTransport(options, developmentMode),\n  ).get\n\n  const storeOutageDeduplicationId = (\n    task: SchedulerTask,\n    outage: QStashStoreOutage,\n  ): Promise<string> => {\n    if (task.kind === 'clear') {\n      return digestId([\n        'a2:scheduler-qstash:store-outage:clear:v1',\n        url,\n        task.contract,\n        task.sessionId,\n        task.id,\n        outage.generation,\n      ])\n    }\n    if (task.kind === 'append') {\n      return digestId([\n        'a2:scheduler-qstash:store-outage:append:v1',\n        url,\n        task.contract,\n        task.sessionId,\n        task.id,\n        outage.generation,\n      ])\n    }\n    const { rootDueAt } = outage\n    if (rootDueAt === undefined) {\n      throw new TypeError('qstash store-outage drain needs a root dueAt')\n    }\n    return digestId([\n      'a2:scheduler-qstash:store-outage:drain:v1',\n      url,\n      task.contract,\n      task.sessionId,\n      rootDueAt,\n      outage.generation,\n    ])\n  }\n\n  const sendTask = async (\n    task: SchedulerTask,\n    outage?: QStashStoreOutage,\n  ): Promise<void> => {\n    const nowMs = clock.now().getTime()\n    const requestedDueAt = task.dueAt\n    if (!Number.isFinite(requestedDueAt)) {\n      throw classifySchedulerSendFailure(\n        new TypeError('qstash scheduler dueAt must be a finite number'),\n        'terminal',\n      )\n    }\n    const dueAt =\n      requestedDueAt <= nowMs\n        ? Math.floor(nowMs / 1_000) * 1_000\n        : Math.ceil(requestedDueAt / 1_000) * 1_000\n    const normalizedTask: SchedulerTask =\n      task.kind === 'append'\n        ? {\n            version: 1,\n            kind: 'append',\n            id: task.id,\n            contract: task.contract,\n            sessionId: task.sessionId,\n            dueAt,\n            events: task.events,\n            ...(task.originIndex === undefined\n              ? {}\n              : { originIndex: task.originIndex }),\n          }\n        : task.kind === 'clear'\n          ? {\n              version: 1,\n              kind: 'clear',\n              id: task.id,\n              contract: task.contract,\n              sessionId: task.sessionId,\n              dueAt,\n              ifLastIndex: task.ifLastIndex,\n            }\n          : {\n              version: 1,\n              kind: 'drain',\n              contract: task.contract,\n              sessionId: task.sessionId,\n              dueAt,\n            }\n    const message: QStashMessage = {\n      ...normalizedTask,\n      ...(outage === undefined ? {} : { _a2QStash: outage }),\n    }\n    const sizeCheckedMessage: QStashMessage =\n      outage === undefined\n        ? {\n            ...normalizedTask,\n            _a2QStash:\n              normalizedTask.kind !== 'drain'\n                ? { version: 1, generation: Number.MAX_SAFE_INTEGER }\n                : {\n                    version: 1,\n                    generation: Number.MAX_SAFE_INTEGER,\n                    rootDueAt: dueAt,\n                  },\n          }\n        : message\n    let bodyBytes: number\n    try {\n      bodyBytes = new TextEncoder().encode(\n        JSON.stringify(sizeCheckedMessage),\n      ).byteLength\n    } catch (error) {\n      throw classifySchedulerSendFailure(error, 'terminal')\n    }\n    if (bodyBytes > maxBodyBytes) {\n      throw classifySchedulerSendFailure(\n        new RangeError('qstash scheduler message exceeds maxBodyBytes'),\n        'terminal',\n      )\n    }\n    const deduplicationId =\n      outage !== undefined\n        ? await storeOutageDeduplicationId(task, outage)\n        : task.kind === 'append'\n          ? await digestId(['a2:scheduler-qstash:append:v1', url, task.id])\n          : task.kind === 'clear'\n            ? await digestId(['a2:scheduler-qstash:clear:v1', url, task.id])\n            : await digestId([\n                'a2:scheduler-qstash:v1',\n                url,\n                task.contract,\n                task.sessionId,\n                dueAt,\n              ])\n    const trustedSource =\n      inferredVercelPreview === true\n        ? previewTrustedSource(Math.max(nowMs, dueAt))\n        : undefined\n    const deliveryHeaders = publishHeaders(configuredHeaders, trustedSource)\n    const t = await transport()\n    try {\n      await t.publish({\n        url,\n        body: message,\n        ...deliveryHeaders,\n        ...(dueAt <= nowMs ? {} : { notBefore: dueAt / 1_000 }),\n        deduplicationId,\n        ...(retries === undefined ? {} : { retries }),\n      })\n    } catch (error) {\n      throw classifyQStashPublishFailure(error)\n    }\n  }\n\n  const sendStoreOutageSuccessor = async (\n    task: SchedulerTask,\n    outage?: QStashStoreOutage,\n  ): Promise<void> => {\n    const generation = (outage?.generation ?? -1) + 1\n    const exponent = Math.min(generation, 6)\n    const delayMs = Math.min(\n      STORE_OUTAGE_MAX_DELAY_MS,\n      STORE_OUTAGE_BASE_DELAY_MS * 4 ** exponent,\n    )\n    const nowMs = clock.now().getTime()\n    const dueAt = Math.ceil((nowMs + delayMs) / 1_000) * 1_000\n    const nextOutage: QStashStoreOutage =\n      task.kind !== 'drain'\n        ? { version: 1, generation }\n        : { version: 1, generation, rootDueAt: outage?.rootDueAt ?? task.dueAt }\n    await sendTask({ ...task, dueAt }, nextOutage)\n  }\n\n  const successorDueAt = (message: { dueAt: number }): number => {\n    const minimumDueAt =\n      clock.now().getTime() +\n      DRAIN_TIMINGS.claimTtlMs +\n      DRAIN_TIMINGS.watchdogGraceMs\n    const beats = Math.max(\n      1,\n      Math.ceil(\n        (minimumDueAt - message.dueAt) / DRAIN_TIMINGS.claimHeartbeatMs,\n      ),\n    )\n    return message.dueAt + beats * DRAIN_TIMINGS.claimHeartbeatMs\n  }\n\n  return {\n    async schedule(task) {\n      await sendTask(task)\n    },\n\n    handler(...servers: DrainableServer[]) {\n      assertSchedulerTargets(servers)\n      const byContract = new Map<string, DrainableServer>()\n      for (const server of servers) {\n        byContract.set(server.contract.name, server)\n      }\n      return async (req: Request): Promise<Response> => {\n        const signature = req.headers.get('upstash-signature')\n        if (!signature) return response.unauthorized()\n\n        const body = await readBoundedBody(req, maxBodyBytes)\n        if (body === null) return response.tooLarge()\n        const upstashRegion = req.headers.get('upstash-region')\n        const t = await transport()\n        try {\n          const valid = await t.verify({\n            signature,\n            body,\n            url,\n            ...(upstashRegion === null ? {} : { upstashRegion }),\n          })\n          if (!valid) return response.unauthorized()\n        } catch {\n          return response.unauthorized()\n        }\n\n        const parsed = parseTask(body)\n        if (!parsed) return response.malformed()\n        const { task, outage } = parsed\n\n        const server = byContract.get(task.contract)\n        if (!server) {\n          throw new Error(\n            `a2 scheduler: no server for contract '${task.contract}' — pass it to scheduler.handler(...)`,\n          )\n        }\n        const internals = serverInternals.get(server)\n        if (task.kind !== 'drain') {\n          try {\n            if (task.kind === 'append')\n              await deliverSchedulerAppend(server, task)\n            else await deliverSchedulerClear(server, task)\n          } catch (error) {\n            if (!storeOutage(error)) throw error\n            await sendStoreOutageSuccessor(task, outage)\n          }\n          return response.ok()\n        }\n\n        const nextDueAt = successorDueAt(task)\n        let result: DrainResult | { settled: boolean; outcome: 'unknown' }\n        try {\n          result = internals\n            ? await internals.schedulerDrain(task.sessionId, {\n                watchdogDueAt: nextDueAt,\n              })\n            : {\n                ...(await server.drain(task.sessionId)),\n                outcome: 'unknown' as const,\n              }\n        } catch (error) {\n          if (!storeOutage(error)) throw error\n          await sendStoreOutageSuccessor(task, outage)\n          return response.ok()\n        }\n        if (result.settled) return response.ok()\n\n        if (\n          result.outcome === 'busy' ||\n          result.outcome === 'stalled' ||\n          result.outcome === 'failed'\n        ) {\n          if (result.schedulerArm) await result.schedulerArm\n          else {\n            await sendTask({\n              version: 1,\n              kind: 'drain',\n              contract: task.contract,\n              sessionId: task.sessionId,\n              dueAt: nextDueAt,\n            })\n          }\n          return response.ok()\n        }\n\n        // A drain whose outcome is unknown hands its work to a fresh durable\n        // message: QStash's per-message retry default can be lower than A2's\n        // failure budget. If this publish fails, the throw keeps the current\n        // delivery retryable.\n        await sendTask({\n          version: 1,\n          kind: 'drain',\n          contract: task.contract,\n          sessionId: task.sessionId,\n          dueAt: nextDueAt,\n        })\n        return response.ok()\n      }\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/scheduler-task-X1SToDjP.js.map

@@ -1 +1 @@
-{"version":3,"file":"scheduler-task-X1SToDjP.js","names":[],"sources":["../src/scheduler-task.ts"],"sourcesContent":["/** One event carried by a delayed append task. */\nexport type ScheduledEvent = {\n  id: string\n  type: string\n  payload: unknown\n}\n\n/** A durable wake-up for pending handler work. */\nexport type SchedulerDrainTask = {\n  version: 1\n  kind: 'drain'\n  contract: string\n  sessionId: string\n  /** Earliest useful delivery as epoch milliseconds. */\n  dueAt: number\n}\n\n/** A durable delayed append. */\nexport type SchedulerAppendTask = {\n  version: 1\n  kind: 'append'\n  /** Stable identity for provider-level deduplication. */\n  id: string\n  contract: string\n  sessionId: string\n  /** Earliest useful delivery as epoch milliseconds. */\n  dueAt: number\n  events: readonly ScheduledEvent[]\n  /** The scheduling handler's event; delivery skips once it is cleared. */\n  originIndex?: number\n}\n\n/** A durable conditional clear. */\nexport type SchedulerClearTask = {\n  version: 1\n  kind: 'clear'\n  /** Stable identity for provider-level deduplication. */\n  id: string\n  contract: string\n  sessionId: string\n  /** Earliest useful delivery as epoch milliseconds. */\n  dueAt: number\n  /** Clear only while this is still the head. */\n  ifLastIndex: number\n}\n\n/** The versioned message protocol shared by scheduler adapters. */\nexport type SchedulerTask =\n  SchedulerDrainTask | SchedulerAppendTask | SchedulerClearTask\n\nconst recordOf = (value: unknown): Record<string, unknown> | null =>\n  value !== null && typeof value === 'object' && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : null\n\nconst validName = (value: unknown): value is string =>\n  typeof value === 'string' && value.length > 0\n\nconst validDueAt = (value: unknown): value is number =>\n  typeof value === 'number' && Number.isInteger(value) && value % 1_000 === 0\n\nconst validIndex = (value: unknown): value is number =>\n  typeof value === 'number' && Number.isSafeInteger(value) && value >= 0\n\nconst baseTask = (\n  record: Record<string, unknown>,\n): { contract: string; sessionId: string } | null =>\n  Object.hasOwn(record, 'contract') &&\n  Object.hasOwn(record, 'sessionId') &&\n  validName(record['contract']) &&\n  validName(record['sessionId'])\n    ? { contract: record['contract'], sessionId: record['sessionId'] }\n    : null\n\n/**\n * Validate one delivered task.\n * Adapters call this only after their transport authentication has succeeded.\n */\nexport function normalizeSchedulerTask(value: unknown): SchedulerTask | null {\n  const record = recordOf(value)\n  if (!record) return null\n  const base = baseTask(record)\n  if (!base) return null\n\n  if (record['version'] !== 1) return null\n  if (record['kind'] === 'drain') {\n    const dueAt = record['dueAt']\n    if (!validDueAt(dueAt)) return null\n    return { version: 1, kind: 'drain', ...base, dueAt }\n  }\n  if (record['kind'] === 'clear') {\n    const { dueAt, id, ifLastIndex } = record\n    if (!validName(id) || !validDueAt(dueAt) || !validIndex(ifLastIndex))\n      return null\n    return { version: 1, kind: 'clear', id, ...base, dueAt, ifLastIndex }\n  }\n  if (record['kind'] !== 'append') return null\n\n  const { dueAt, events, id, originIndex } = record\n  if (!validName(id) || !validDueAt(dueAt)) return null\n  if (\n    originIndex !== undefined &&\n    (!validIndex(originIndex) || originIndex === 0)\n  )\n    return null\n  if (!Array.isArray(events) || events.length === 0) return null\n  const parsedEvents: ScheduledEvent[] = []\n  for (const event of events) {\n    const item = recordOf(event)\n    if (\n      !item ||\n      typeof item['id'] !== 'string' ||\n      typeof item['type'] !== 'string' ||\n      !Object.hasOwn(item, 'payload')\n    ) {\n      return null\n    }\n    parsedEvents.push({\n      id: item['id'],\n      type: item['type'],\n      payload: item['payload'],\n    })\n  }\n  if (\n    new Set(parsedEvents.map((event) => event.id)).size !== parsedEvents.length\n  ) {\n    return null\n  }\n  return {\n    version: 1,\n    kind: 'append',\n    id,\n    ...base,\n    dueAt,\n    events: parsedEvents,\n    ...(originIndex === undefined ? {} : { originIndex }),\n  }\n}\n"],"mappings":";AAkDA,MAAM,YAAY,UAChB,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,IAC9D,QACD;AAEN,MAAM,aAAa,UACjB,OAAO,UAAU,YAAY,MAAM,SAAS;AAE9C,MAAM,cAAc,UAClB,OAAO,UAAU,YAAY,OAAO,UAAU,KAAK,KAAK,QAAQ,QAAU;AAE5E,MAAM,cAAc,UAClB,OAAO,UAAU,YAAY,OAAO,cAAc,KAAK,KAAK,SAAS;AAEvE,MAAM,YACJ,WAEA,OAAO,OAAO,QAAQ,UAAU,KAChC,OAAO,OAAO,QAAQ,WAAW,KACjC,UAAU,OAAO,WAAW,KAC5B,UAAU,OAAO,YAAY,IACzB;CAAE,UAAU,OAAO;CAAa,WAAW,OAAO;AAAa,IAC/D;;;;;AAMN,SAAgB,uBAAuB,OAAsC;CAC3E,MAAM,SAAS,SAAS,KAAK;CAC7B,IAAI,CAAC,QAAQ,OAAO;CACpB,MAAM,OAAO,SAAS,MAAM;CAC5B,IAAI,CAAC,MAAM,OAAO;CAElB,IAAI,OAAO,eAAe,GAAG,OAAO;CACpC,IAAI,OAAO,YAAY,SAAS;EAC9B,MAAM,QAAQ,OAAO;EACrB,IAAI,CAAC,WAAW,KAAK,GAAG,OAAO;EAC/B,OAAO;GAAE,SAAS;GAAG,MAAM;GAAS,GAAG;GAAM;EAAM;CACrD;CACA,IAAI,OAAO,YAAY,SAAS;EAC9B,MAAM,EAAE,OAAO,IAAI,gBAAgB;EACnC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW,WAAW,GACjE,OAAO;EACT,OAAO;GAAE,SAAS;GAAG,MAAM;GAAS;GAAI,GAAG;GAAM;GAAO;EAAY;CACtE;CACA,IAAI,OAAO,YAAY,UAAU,OAAO;CAExC,MAAM,EAAE,OAAO,QAAQ,IAAI,gBAAgB;CAC3C,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,WAAW,KAAK,GAAG,OAAO;CACjD,IACE,gBAAgB,KAAA,MACf,CAAC,WAAW,WAAW,KAAK,gBAAgB,IAE7C,OAAO;CACT,IAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,OAAO,WAAW,GAAG,OAAO;CAC1D,MAAM,eAAiC,CAAC;CACxC,KAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,OAAO,SAAS,KAAK;EAC3B,IACE,CAAC,QACD,OAAO,KAAK,UAAU,YACtB,OAAO,KAAK,YAAY,YACxB,CAAC,OAAO,OAAO,MAAM,SAAS,GAE9B,OAAO;EAET,aAAa,KAAK;GAChB,IAAI,KAAK;GACT,MAAM,KAAK;GACX,SAAS,KAAK;EAChB,CAAC;CACH;CACA,IACE,IAAI,IAAI,aAAa,KAAK,UAAU,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,aAAa,QAErE,OAAO;CAET,OAAO;EACL,SAAS;EACT,MAAM;EACN;EACA,GAAG;EACH;EACA,QAAQ;EACR,GAAI,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,YAAY;CACrD;AACF"}
+{"version":3,"file":"scheduler-task-X1SToDjP.js","names":[],"sources":["../src/scheduler-task.ts"],"sourcesContent":["/** One event carried by a delayed append task. */\nexport type ScheduledEvent = {\n  id: string\n  type: string\n  payload: unknown\n}\n\n/** A durable wake-up for pending consumer work. */\nexport type SchedulerDrainTask = {\n  version: 1\n  kind: 'drain'\n  contract: string\n  sessionId: string\n  /** Earliest useful delivery as epoch milliseconds. */\n  dueAt: number\n}\n\n/** A durable delayed append. */\nexport type SchedulerAppendTask = {\n  version: 1\n  kind: 'append'\n  /** Stable identity for provider-level deduplication. */\n  id: string\n  contract: string\n  sessionId: string\n  /** Earliest useful delivery as epoch milliseconds. */\n  dueAt: number\n  events: readonly ScheduledEvent[]\n  /** The scheduling consumer's event; delivery skips once it is cleared. */\n  originIndex?: number\n}\n\n/** A durable conditional clear. */\nexport type SchedulerClearTask = {\n  version: 1\n  kind: 'clear'\n  /** Stable identity for provider-level deduplication. */\n  id: string\n  contract: string\n  sessionId: string\n  /** Earliest useful delivery as epoch milliseconds. */\n  dueAt: number\n  /** Clear only while this is still the head. */\n  ifLastIndex: number\n}\n\n/** The versioned message protocol shared by scheduler adapters. */\nexport type SchedulerTask =\n  SchedulerDrainTask | SchedulerAppendTask | SchedulerClearTask\n\nconst recordOf = (value: unknown): Record<string, unknown> | null =>\n  value !== null && typeof value === 'object' && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : null\n\nconst validName = (value: unknown): value is string =>\n  typeof value === 'string' && value.length > 0\n\nconst validDueAt = (value: unknown): value is number =>\n  typeof value === 'number' && Number.isInteger(value) && value % 1_000 === 0\n\nconst validIndex = (value: unknown): value is number =>\n  typeof value === 'number' && Number.isSafeInteger(value) && value >= 0\n\nconst baseTask = (\n  record: Record<string, unknown>,\n): { contract: string; sessionId: string } | null =>\n  Object.hasOwn(record, 'contract') &&\n  Object.hasOwn(record, 'sessionId') &&\n  validName(record['contract']) &&\n  validName(record['sessionId'])\n    ? { contract: record['contract'], sessionId: record['sessionId'] }\n    : null\n\n/**\n * Validate one delivered task.\n * Adapters call this only after their transport authentication has succeeded.\n */\nexport function normalizeSchedulerTask(value: unknown): SchedulerTask | null {\n  const record = recordOf(value)\n  if (!record) return null\n  const base = baseTask(record)\n  if (!base) return null\n\n  if (record['version'] !== 1) return null\n  if (record['kind'] === 'drain') {\n    const dueAt = record['dueAt']\n    if (!validDueAt(dueAt)) return null\n    return { version: 1, kind: 'drain', ...base, dueAt }\n  }\n  if (record['kind'] === 'clear') {\n    const { dueAt, id, ifLastIndex } = record\n    if (!validName(id) || !validDueAt(dueAt) || !validIndex(ifLastIndex))\n      return null\n    return { version: 1, kind: 'clear', id, ...base, dueAt, ifLastIndex }\n  }\n  if (record['kind'] !== 'append') return null\n\n  const { dueAt, events, id, originIndex } = record\n  if (!validName(id) || !validDueAt(dueAt)) return null\n  if (\n    originIndex !== undefined &&\n    (!validIndex(originIndex) || originIndex === 0)\n  )\n    return null\n  if (!Array.isArray(events) || events.length === 0) return null\n  const parsedEvents: ScheduledEvent[] = []\n  for (const event of events) {\n    const item = recordOf(event)\n    if (\n      !item ||\n      typeof item['id'] !== 'string' ||\n      typeof item['type'] !== 'string' ||\n      !Object.hasOwn(item, 'payload')\n    ) {\n      return null\n    }\n    parsedEvents.push({\n      id: item['id'],\n      type: item['type'],\n      payload: item['payload'],\n    })\n  }\n  if (\n    new Set(parsedEvents.map((event) => event.id)).size !== parsedEvents.length\n  ) {\n    return null\n  }\n  return {\n    version: 1,\n    kind: 'append',\n    id,\n    ...base,\n    dueAt,\n    events: parsedEvents,\n    ...(originIndex === undefined ? {} : { originIndex }),\n  }\n}\n"],"mappings":";AAkDA,MAAM,YAAY,UAChB,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,IAC9D,QACD;AAEN,MAAM,aAAa,UACjB,OAAO,UAAU,YAAY,MAAM,SAAS;AAE9C,MAAM,cAAc,UAClB,OAAO,UAAU,YAAY,OAAO,UAAU,KAAK,KAAK,QAAQ,QAAU;AAE5E,MAAM,cAAc,UAClB,OAAO,UAAU,YAAY,OAAO,cAAc,KAAK,KAAK,SAAS;AAEvE,MAAM,YACJ,WAEA,OAAO,OAAO,QAAQ,UAAU,KAChC,OAAO,OAAO,QAAQ,WAAW,KACjC,UAAU,OAAO,WAAW,KAC5B,UAAU,OAAO,YAAY,IACzB;CAAE,UAAU,OAAO;CAAa,WAAW,OAAO;AAAa,IAC/D;;;;;AAMN,SAAgB,uBAAuB,OAAsC;CAC3E,MAAM,SAAS,SAAS,KAAK;CAC7B,IAAI,CAAC,QAAQ,OAAO;CACpB,MAAM,OAAO,SAAS,MAAM;CAC5B,IAAI,CAAC,MAAM,OAAO;CAElB,IAAI,OAAO,eAAe,GAAG,OAAO;CACpC,IAAI,OAAO,YAAY,SAAS;EAC9B,MAAM,QAAQ,OAAO;EACrB,IAAI,CAAC,WAAW,KAAK,GAAG,OAAO;EAC/B,OAAO;GAAE,SAAS;GAAG,MAAM;GAAS,GAAG;GAAM;EAAM;CACrD;CACA,IAAI,OAAO,YAAY,SAAS;EAC9B,MAAM,EAAE,OAAO,IAAI,gBAAgB;EACnC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW,WAAW,GACjE,OAAO;EACT,OAAO;GAAE,SAAS;GAAG,MAAM;GAAS;GAAI,GAAG;GAAM;GAAO;EAAY;CACtE;CACA,IAAI,OAAO,YAAY,UAAU,OAAO;CAExC,MAAM,EAAE,OAAO,QAAQ,IAAI,gBAAgB;CAC3C,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,WAAW,KAAK,GAAG,OAAO;CACjD,IACE,gBAAgB,KAAA,MACf,CAAC,WAAW,WAAW,KAAK,gBAAgB,IAE7C,OAAO;CACT,IAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,OAAO,WAAW,GAAG,OAAO;CAC1D,MAAM,eAAiC,CAAC;CACxC,KAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,OAAO,SAAS,KAAK;EAC3B,IACE,CAAC,QACD,OAAO,KAAK,UAAU,YACtB,OAAO,KAAK,YAAY,YACxB,CAAC,OAAO,OAAO,MAAM,SAAS,GAE9B,OAAO;EAET,aAAa,KAAK;GAChB,IAAI,KAAK;GACT,MAAM,KAAK;GACX,SAAS,KAAK;EAChB,CAAC;CACH;CACA,IACE,IAAI,IAAI,aAAa,KAAK,UAAU,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,aAAa,QAErE,OAAO;CAET,OAAO;EACL,SAAS;EACT,MAAM;EACN;EACA,GAAG;EACH;EACA,QAAQ;EACR,GAAI,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,YAAY;CACrD;AACF"}

package/dist/scheduler-vercel.d.ts

@@ -1,5 +1,5 @@
-import { r as Clock } from "./store-CyLUy86v.js";
-import { P as SchedulerTask, t as A2Scheduler } from "./server-DYAATFuT.js";
+import { r as Clock } from "./store-Z2qjw50n.js";
+import { B as SchedulerTask, t as A2Scheduler } from "./server-BshFZ0eL.js";
 //#region src/scheduler-vercel.d.ts
 /**
  * The "not settled yet" signal for a drain whose outcome is unknown — an

package/dist/scheduler-vercel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scheduler-vercel.d.ts","names":[],"sources":["../src/scheduler-vercel.ts"],"mappings":";;;;;;;;;;;;cAqDa,uBAAuB;KAExB;EACV;EACA;;;KAIU;EACV,KACE,eACA,SAAS,eACT;IACE;IACA;IACA;MAED;;;;;;;;EAQH,eACE,UACE,kBACA,UAAU,0BACP,iBACH,KAAK,YAAY,QAAQ;;EAE7B,YAAY;;KAGF;;EAEV;;EAEA;;EAEA,YAAY;;EAEZ,QAAQ;;iBA2HM,aAAa,UAAS,sBAA2B"}
+{"version":3,"file":"scheduler-vercel.d.ts","names":[],"sources":["../src/scheduler-vercel.ts"],"mappings":";;;;;;;;;;;;cAsDa,uBAAuB;KAExB;EACV;EACA;;;KAIU;EACV,KACE,eACA,SAAS,eACT;IACE;IACA;IACA;MAED;;;;;;;;EAQH,eACE,UACE,kBACA,UAAU,0BACP,iBACH,KAAK,YAAY,QAAQ;;EAE7B,YAAY;;KAGF;;EAEV;;EAEA;;EAEA,YAAY;;EAEZ,QAAQ;;iBA2HM,aAAa,UAAS,sBAA2B"}

package/dist/scheduler-vercel.js

@@ -1,5 +1,5 @@
-import { d as assertSchedulerTargets, f as classifySchedulerSendFailure, t as DRAIN_TIMINGS, v as serverInternals } from "./internal-CscSY7K_.js";
-import { n as deliverSchedulerAppend, r as deliverSchedulerClear } from "./server-D-Y4pqwu.js";
+import { b as serverInternals, d as assertSchedulerTargets, f as classifySchedulerSendFailure, t as DRAIN_TIMINGS } from "./internal-Bc4PvfHk.js";
+import { i as deliverSchedulerClear, r as deliverSchedulerAppend } from "./server-DvIB8kj5.js";
 import { t as retryableLazy } from "./retryable-lazy-DZWmHpii.js";
 import { n as SYSTEM_CLOCK } from "./store-N8PXxDAS.js";
 import { t as normalizeSchedulerTask } from "./scheduler-task-X1SToDjP.js";
@@ -21,7 +21,8 @@ import { createHash } from "node:crypto";
 *   the configured deployment scope for sending and receiving.
 * - `handler(...servers)` is the delivery route: look up the server for
 *   the contract named in the message and drain it. Settled drains ack;
-*   contention and handler failure arm a later watchdog before acking.
+*   contention, consumer failure, and a drain that throws after arming its
+*   successor all ack once a later watchdog is durable.
 *
 * `@vercel/queue` is an optional peer dependency, imported lazily. The
 * `transport` option is the injection seam — tests run a real little
@@ -182,7 +183,7 @@ function vercelQueues(options = {}) {
 						outcome: "unknown"
 					};
 					if (result.settled) return;
-					if (result.outcome === "busy" || result.outcome === "stalled") {
+					if (result.outcome === "busy" || result.outcome === "stalled" || result.outcome === "failed") {
 						if (result.schedulerArm) await result.schedulerArm;
 						else await sendTask({
 							version: 1,

package/dist/scheduler-vercel.js.map

@@ -1 +1 @@
-{"version":3,"file":"scheduler-vercel.js","names":[],"sources":["../src/scheduler-vercel.ts"],"sourcesContent":["/**\n * experimental-a2/scheduler-vercel — queue-backed scheduler over Vercel Queues.\n *\n * `vercelQueues()` returns an `A2Scheduler` (a2-implementation.md §9):\n *\n * - drain tasks round the requested watchdog time up to a one-second slot.\n *   One message per `(topic, contract, session, dueAt)` coalesces appends,\n *   claim renewals and racing callbacks. `DuplicateMessageError` is\n *   success because that due-time slot is already durable.\n * - append tasks hash their stable task id with the topic for provider\n *   deduplication. Their six-day maximum delay leaves a full day for\n *   delivery and retries inside the provider's seven-day retention.\n *   Clear tasks follow the same identity and delay rules. All tasks use\n *   the configured deployment scope for sending and receiving.\n * - `handler(...servers)` is the delivery route: look up the server for\n *   the contract named in the message and drain it. Settled drains ack;\n *   contention and handler failure arm a later watchdog before acking.\n *\n * `@vercel/queue` is an optional peer dependency, imported lazily. The\n * `transport` option is the injection seam — tests run a real little\n * in-memory queue through the same interface.\n */\n\nimport { createHash } from 'node:crypto'\nimport { SYSTEM_CLOCK, type Clock } from './store.ts'\nimport {\n  assertSchedulerTargets,\n  classifySchedulerSendFailure,\n  DRAIN_TIMINGS,\n  serverInternals,\n} from './internal.ts'\nimport { retryableLazy } from './retryable-lazy.ts'\nimport {\n  normalizeSchedulerTask,\n  type SchedulerDrainTask,\n  type SchedulerTask,\n} from './scheduler-task.ts'\nimport {\n  deliverSchedulerAppend,\n  deliverSchedulerClear,\n  type A2Scheduler,\n  type DrainableServer,\n} from './server.ts'\n\n/**\n * The \"not settled yet\" signal for a drain whose outcome is unknown — an\n * expected state, not a transport failure. The default transport classifies\n * it in `@vercel/queue`'s `retry` option and reschedules the delivery quietly\n * (`{ afterSeconds }` → visibility change → 200 response, no error log)\n * instead of letting it surface as a thrown 500. Busy and stalled deliveries\n * use a fresh watchdog instead. Custom transports should treat this class the\n * same way when their protocol has a polite reschedule.\n */\nexport class DrainUnsettled extends Error {}\n\nexport type QueueDeliveryMetadata = {\n  messageId: string\n  deliveryCount: number\n}\n\n/** What this module needs from a Vercel Queues-compatible transport. */\nexport type QueueTransport = {\n  send(\n    topic: string,\n    message: SchedulerTask,\n    options?: {\n      delaySeconds?: number\n      idempotencyKey?: string\n      retentionSeconds?: number\n    },\n  ): Promise<unknown>\n  /**\n   * Wrap the delivery handler into a route. The handler throws\n   * `DrainUnsettled` when the session needs redelivery — transports\n   * with a polite reschedule (visibility change) should use it there\n   * instead of surfacing an error; anything else thrown is a genuine\n   * failure and should stay loud.\n   */\n  handleCallback(\n    handler: (\n      message: unknown,\n      metadata: QueueDeliveryMetadata,\n    ) => Promise<void>,\n  ): (req: Request) => Promise<Response>\n  /** Is this send error the idempotency-key collision? (= success) */\n  isDuplicate(error: unknown): boolean\n}\n\nexport type VercelQueuesOptions = {\n  /** Queue topic matching `[A-Za-z0-9_-]+`. Default `'a2'`. */\n  topic?: string\n  /** Queue SDK deployment scope for all tasks. Default: VERCEL_DEPLOYMENT_ID; null opts out. */\n  deploymentId?: string | null\n  /** Injectable transport (tests). Default: `@vercel/queue`. */\n  transport?: QueueTransport\n  /** Injectable clock for due-time calculations (tests). */\n  clock?: Clock\n}\n\n/** Vercel Queues rejects shorter visibility changes. */\nconst MIN_VISIBILITY_SECONDS = 30\n\n/** Vercel Queues' maximum message retention; its default is a day. */\nconst MAX_RETENTION_SECONDS = 7 * 24 * 60 * 60\n\nconst TOPIC_PATTERN = /^[A-Za-z0-9_-]+$/\nconst RETRYABLE_HTTP_CLIENT_STATUSES = new Set([408, 409, 425, 429])\n/** The SDK's send path maps these statuses to name-only error instances. */\nconst TERMINAL_VERCEL_SEND_ERROR_NAMES = new Set([\n  'BadRequestError',\n  'UnauthorizedError',\n  'ForbiddenError',\n])\n\nconst recordOf = (value: unknown): Record<string, unknown> | null =>\n  value !== null && typeof value === 'object' && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : null\n\nconst httpStatusOf = (error: unknown): number | undefined => {\n  try {\n    const record = recordOf(error)\n    if (!record) return undefined\n    const response = recordOf(record['response'])\n    const statuses = [\n      record['status'],\n      record['statusCode'],\n      response?.['status'],\n    ].filter(\n      (value): value is number =>\n        typeof value === 'number' &&\n        Number.isInteger(value) &&\n        value >= 100 &&\n        value <= 599,\n    )\n    const [status] = statuses\n    if (status === undefined) return undefined\n    return statuses.every((candidate) => candidate === status)\n      ? status\n      : undefined\n  } catch {\n    return undefined\n  }\n}\n\nconst errorNameOf = (error: unknown): string | undefined => {\n  try {\n    const name = recordOf(error)?.['name']\n    return typeof name === 'string' ? name : undefined\n  } catch {\n    return undefined\n  }\n}\n\nconst classifyVercelSendFailure = (error: unknown): unknown => {\n  const status = httpStatusOf(error)\n  const terminal =\n    status === undefined\n      ? TERMINAL_VERCEL_SEND_ERROR_NAMES.has(errorNameOf(error) ?? '')\n      : status >= 400 &&\n        status < 500 &&\n        !RETRYABLE_HTTP_CLIENT_STATUSES.has(status)\n  return classifySchedulerSendFailure(\n    error,\n    terminal ? 'terminal' : 'retryable',\n  )\n}\n\nconst digestId = (parts: readonly string[]): string =>\n  `a2_${createHash('sha256').update(JSON.stringify(parts)).digest('hex')}`\n\n/** Base of the unsettled redelivery backoff, doubled per delivery. */\nconst UNSETTLED_BACKOFF_BASE_SECONDS = 5\n\n/** Redelivery backoff for retry states: base, 2×, 4×… bounded. */\nconst unsettledBackoffSeconds = (deliveryCount: number): number =>\n  Math.min(\n    Math.max(\n      UNSETTLED_BACKOFF_BASE_SECONDS * 2 ** Math.max(deliveryCount - 1, 0),\n      MIN_VISIBILITY_SECONDS,\n    ),\n    60,\n  )\n\nconst vercelQueueTransport = async (\n  clientOptions: Pick<VercelQueuesOptions, 'deploymentId'>,\n): Promise<QueueTransport> => {\n  const queue = await import('@vercel/queue').catch(() => {\n    throw classifySchedulerSendFailure(\n      new Error(\n        \"experimental-a2/scheduler-vercel needs the '@vercel/queue' package (optional peer dependency) — install it, or inject a transport\",\n      ),\n      'terminal',\n    )\n  })\n  const client = new queue.QueueClient(clientOptions)\n  return {\n    send: (topic, message, options) => client.send(topic, message, options),\n    handleCallback: (handler) =>\n      client.handleCallback(handler, {\n        // A hard-killed callback normally has a fresh claim watchdog. If\n        // its successor send also failed, make the old unacked delivery's\n        // fallback as prompt as Vercel Queues permits.\n        visibilityTimeoutSeconds: MIN_VISIBILITY_SECONDS,\n        // Not-settled-yet is an expected state: reschedule the (still\n        // unacked) delivery via a visibility change — 200, no error\n        // log. Everything else returns undefined → the SDK's default\n        // throw path, which is loud on purpose.\n        retry: (error, metadata) =>\n          error instanceof DrainUnsettled\n            ? {\n                afterSeconds: unsettledBackoffSeconds(metadata.deliveryCount),\n              }\n            : undefined,\n      }) as (req: Request) => Promise<Response>,\n    isDuplicate: (error) => error instanceof queue.DuplicateMessageError,\n  }\n}\n\nexport function vercelQueues(options: VercelQueuesOptions = {}): A2Scheduler {\n  const topic = options.topic ?? 'a2'\n  if (typeof topic !== 'string' || !TOPIC_PATTERN.test(topic)) {\n    throw new TypeError('vercelQueues() topic must match [A-Za-z0-9_-]+')\n  }\n  const clock = options.clock ?? SYSTEM_CLOCK\n  const clientOptions =\n    options.deploymentId === undefined\n      ? {}\n      : { deploymentId: options.deploymentId }\n\n  // Lazy: constructing the scheduler value does no I/O and works without\n  // the peer dep until the first task or delivery.\n  const transport = retryableLazy(() =>\n    options.transport\n      ? Promise.resolve(options.transport)\n      : vercelQueueTransport(clientOptions),\n  ).get\n\n  const sendTask = async (task: SchedulerTask): Promise<void> => {\n    const nowMs = clock.now().getTime()\n    const requestedDueAt = task.dueAt\n    if (!Number.isFinite(requestedDueAt)) {\n      throw classifySchedulerSendFailure(\n        new TypeError('vercel scheduler dueAt must be a finite number'),\n        'terminal',\n      )\n    }\n    const dueAt =\n      requestedDueAt <= nowMs\n        ? Math.floor(nowMs / 1_000) * 1_000\n        : Math.ceil(requestedDueAt / 1_000) * 1_000\n    const deliveryTargetAt = task.kind === 'drain' ? dueAt : requestedDueAt\n    const deliveryDelaySeconds = Math.max(\n      0,\n      Math.ceil((deliveryTargetAt - nowMs) / 1_000),\n    )\n    const message: SchedulerTask = { ...task, dueAt }\n    const idempotencyKey =\n      task.kind === 'drain'\n        ? digestId([\n            'a2:scheduler-vercel:drain:v1',\n            topic,\n            task.contract,\n            task.sessionId,\n            String(dueAt),\n          ])\n        : task.kind === 'append'\n          ? digestId(['a2:scheduler-vercel:append:v1', topic, task.id])\n          : digestId(['a2:scheduler-vercel:clear:v1', topic, task.id])\n    const t = await transport()\n    try {\n      await t.send(topic, message, {\n        delaySeconds: deliveryDelaySeconds,\n        idempotencyKey,\n        retentionSeconds: MAX_RETENTION_SECONDS,\n      })\n    } catch (err) {\n      if (t.isDuplicate(err)) return\n      throw classifyVercelSendFailure(err)\n    }\n  }\n\n  const successorDueAt = (message: SchedulerDrainTask): number => {\n    const minimumDueAt =\n      clock.now().getTime() +\n      DRAIN_TIMINGS.claimTtlMs +\n      DRAIN_TIMINGS.watchdogGraceMs\n    const beats = Math.max(\n      1,\n      Math.ceil(\n        (minimumDueAt - message.dueAt) / DRAIN_TIMINGS.claimHeartbeatMs,\n      ),\n    )\n    return message.dueAt + beats * DRAIN_TIMINGS.claimHeartbeatMs\n  }\n\n  return {\n    async schedule(task) {\n      await sendTask(task)\n    },\n\n    handler(...servers: DrainableServer[]) {\n      assertSchedulerTargets(servers)\n      const byContract = new Map<string, DrainableServer>()\n      for (const server of servers) {\n        byContract.set(server.contract.name, server)\n      }\n      return async (req: Request): Promise<Response> => {\n        const t = await transport()\n        return t.handleCallback(async (delivered) => {\n          const task = normalizeSchedulerTask(delivered)\n          if (!task) {\n            throw new TypeError('a2 scheduler received an invalid task')\n          }\n          const server = byContract.get(task.contract)\n          if (!server) {\n            // A message for a contract this route doesn't serve is a\n            // wiring bug — throw so it redelivers and stays visible in\n            // queue observability instead of vanishing on an ack.\n            throw new Error(\n              `a2 scheduler: no server for contract '${task.contract}' — pass it to scheduler.handler(...)`,\n            )\n          }\n          const internals = serverInternals.get(server)\n          if (task.kind === 'append') {\n            await deliverSchedulerAppend(server, task)\n            return\n          }\n          if (task.kind === 'clear') {\n            await deliverSchedulerClear(server, task)\n            return\n          }\n\n          const nextDueAt = successorDueAt(task)\n          const result = internals\n            ? await internals.schedulerDrain(task.sessionId, {\n                watchdogDueAt: nextDueAt,\n              })\n            : {\n                ...(await server.drain(task.sessionId)),\n                outcome: 'unknown' as const,\n              }\n          if (result.settled) return\n\n          if (result.outcome === 'busy' || result.outcome === 'stalled') {\n            // The live owner arms its own claim windows, and the store holds\n            // a failed event until its retry time. Ensure a later slot here\n            // as well before relinquishing this durable delivery. If the queue is down, the\n            // throw leaves the current message unacked for visibility-timeout\n            // redelivery.\n            if (result.schedulerArm) await result.schedulerArm\n            else {\n              await sendTask({\n                version: 1,\n                kind: 'drain',\n                contract: task.contract,\n                sessionId: task.sessionId,\n                dueAt: nextDueAt,\n              })\n            }\n            return\n          }\n\n          // A drain whose outcome is unknown keeps the current durable message\n          // and uses the transport retry path.\n          throw new DrainUnsettled(\n            `a2 scheduler: session '${task.sessionId}' of '${task.contract}' not settled yet (${result.outcome}) — rescheduled for redelivery`,\n          )\n        })(req)\n      }\n    },\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"scheduler-vercel.js","names":[],"sources":["../src/scheduler-vercel.ts"],"sourcesContent":["/**\n * experimental-a2/scheduler-vercel — queue-backed scheduler over Vercel Queues.\n *\n * `vercelQueues()` returns an `A2Scheduler` (a2-implementation.md §9):\n *\n * - drain tasks round the requested watchdog time up to a one-second slot.\n *   One message per `(topic, contract, session, dueAt)` coalesces appends,\n *   claim renewals and racing callbacks. `DuplicateMessageError` is\n *   success because that due-time slot is already durable.\n * - append tasks hash their stable task id with the topic for provider\n *   deduplication. Their six-day maximum delay leaves a full day for\n *   delivery and retries inside the provider's seven-day retention.\n *   Clear tasks follow the same identity and delay rules. All tasks use\n *   the configured deployment scope for sending and receiving.\n * - `handler(...servers)` is the delivery route: look up the server for\n *   the contract named in the message and drain it. Settled drains ack;\n *   contention, consumer failure, and a drain that throws after arming its\n *   successor all ack once a later watchdog is durable.\n *\n * `@vercel/queue` is an optional peer dependency, imported lazily. The\n * `transport` option is the injection seam — tests run a real little\n * in-memory queue through the same interface.\n */\n\nimport { createHash } from 'node:crypto'\nimport { SYSTEM_CLOCK, type Clock } from './store.ts'\nimport {\n  assertSchedulerTargets,\n  classifySchedulerSendFailure,\n  DRAIN_TIMINGS,\n  serverInternals,\n} from './internal.ts'\nimport { retryableLazy } from './retryable-lazy.ts'\nimport {\n  normalizeSchedulerTask,\n  type SchedulerDrainTask,\n  type SchedulerTask,\n} from './scheduler-task.ts'\nimport {\n  deliverSchedulerAppend,\n  deliverSchedulerClear,\n  type A2Scheduler,\n  type DrainableServer,\n} from './server.ts'\n\n/**\n * The \"not settled yet\" signal for a drain whose outcome is unknown — an\n * expected state, not a transport failure. The default transport classifies\n * it in `@vercel/queue`'s `retry` option and reschedules the delivery quietly\n * (`{ afterSeconds }` → visibility change → 200 response, no error log)\n * instead of letting it surface as a thrown 500. Busy and stalled deliveries\n * use a fresh watchdog instead. Custom transports should treat this class the\n * same way when their protocol has a polite reschedule.\n */\nexport class DrainUnsettled extends Error {}\n\nexport type QueueDeliveryMetadata = {\n  messageId: string\n  deliveryCount: number\n}\n\n/** What this module needs from a Vercel Queues-compatible transport. */\nexport type QueueTransport = {\n  send(\n    topic: string,\n    message: SchedulerTask,\n    options?: {\n      delaySeconds?: number\n      idempotencyKey?: string\n      retentionSeconds?: number\n    },\n  ): Promise<unknown>\n  /**\n   * Wrap the delivery handler into a route. The handler throws\n   * `DrainUnsettled` when the session needs redelivery — transports\n   * with a polite reschedule (visibility change) should use it there\n   * instead of surfacing an error; anything else thrown is a genuine\n   * failure and should stay loud.\n   */\n  handleCallback(\n    handler: (\n      message: unknown,\n      metadata: QueueDeliveryMetadata,\n    ) => Promise<void>,\n  ): (req: Request) => Promise<Response>\n  /** Is this send error the idempotency-key collision? (= success) */\n  isDuplicate(error: unknown): boolean\n}\n\nexport type VercelQueuesOptions = {\n  /** Queue topic matching `[A-Za-z0-9_-]+`. Default `'a2'`. */\n  topic?: string\n  /** Queue SDK deployment scope for all tasks. Default: VERCEL_DEPLOYMENT_ID; null opts out. */\n  deploymentId?: string | null\n  /** Injectable transport (tests). Default: `@vercel/queue`. */\n  transport?: QueueTransport\n  /** Injectable clock for due-time calculations (tests). */\n  clock?: Clock\n}\n\n/** Vercel Queues rejects shorter visibility changes. */\nconst MIN_VISIBILITY_SECONDS = 30\n\n/** Vercel Queues' maximum message retention; its default is a day. */\nconst MAX_RETENTION_SECONDS = 7 * 24 * 60 * 60\n\nconst TOPIC_PATTERN = /^[A-Za-z0-9_-]+$/\nconst RETRYABLE_HTTP_CLIENT_STATUSES = new Set([408, 409, 425, 429])\n/** The SDK's send path maps these statuses to name-only error instances. */\nconst TERMINAL_VERCEL_SEND_ERROR_NAMES = new Set([\n  'BadRequestError',\n  'UnauthorizedError',\n  'ForbiddenError',\n])\n\nconst recordOf = (value: unknown): Record<string, unknown> | null =>\n  value !== null && typeof value === 'object' && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : null\n\nconst httpStatusOf = (error: unknown): number | undefined => {\n  try {\n    const record = recordOf(error)\n    if (!record) return undefined\n    const response = recordOf(record['response'])\n    const statuses = [\n      record['status'],\n      record['statusCode'],\n      response?.['status'],\n    ].filter(\n      (value): value is number =>\n        typeof value === 'number' &&\n        Number.isInteger(value) &&\n        value >= 100 &&\n        value <= 599,\n    )\n    const [status] = statuses\n    if (status === undefined) return undefined\n    return statuses.every((candidate) => candidate === status)\n      ? status\n      : undefined\n  } catch {\n    return undefined\n  }\n}\n\nconst errorNameOf = (error: unknown): string | undefined => {\n  try {\n    const name = recordOf(error)?.['name']\n    return typeof name === 'string' ? name : undefined\n  } catch {\n    return undefined\n  }\n}\n\nconst classifyVercelSendFailure = (error: unknown): unknown => {\n  const status = httpStatusOf(error)\n  const terminal =\n    status === undefined\n      ? TERMINAL_VERCEL_SEND_ERROR_NAMES.has(errorNameOf(error) ?? '')\n      : status >= 400 &&\n        status < 500 &&\n        !RETRYABLE_HTTP_CLIENT_STATUSES.has(status)\n  return classifySchedulerSendFailure(\n    error,\n    terminal ? 'terminal' : 'retryable',\n  )\n}\n\nconst digestId = (parts: readonly string[]): string =>\n  `a2_${createHash('sha256').update(JSON.stringify(parts)).digest('hex')}`\n\n/** Base of the unsettled redelivery backoff, doubled per delivery. */\nconst UNSETTLED_BACKOFF_BASE_SECONDS = 5\n\n/** Redelivery backoff for retry states: base, 2×, 4×… bounded. */\nconst unsettledBackoffSeconds = (deliveryCount: number): number =>\n  Math.min(\n    Math.max(\n      UNSETTLED_BACKOFF_BASE_SECONDS * 2 ** Math.max(deliveryCount - 1, 0),\n      MIN_VISIBILITY_SECONDS,\n    ),\n    60,\n  )\n\nconst vercelQueueTransport = async (\n  clientOptions: Pick<VercelQueuesOptions, 'deploymentId'>,\n): Promise<QueueTransport> => {\n  const queue = await import('@vercel/queue').catch(() => {\n    throw classifySchedulerSendFailure(\n      new Error(\n        \"experimental-a2/scheduler-vercel needs the '@vercel/queue' package (optional peer dependency) — install it, or inject a transport\",\n      ),\n      'terminal',\n    )\n  })\n  const client = new queue.QueueClient(clientOptions)\n  return {\n    send: (topic, message, options) => client.send(topic, message, options),\n    handleCallback: (handler) =>\n      client.handleCallback(handler, {\n        // A hard-killed callback normally has a fresh claim watchdog. If\n        // its successor send also failed, make the old unacked delivery's\n        // fallback as prompt as Vercel Queues permits.\n        visibilityTimeoutSeconds: MIN_VISIBILITY_SECONDS,\n        // Not-settled-yet is an expected state: reschedule the (still\n        // unacked) delivery via a visibility change — 200, no error\n        // log. Everything else returns undefined → the SDK's default\n        // throw path, which is loud on purpose.\n        retry: (error, metadata) =>\n          error instanceof DrainUnsettled\n            ? {\n                afterSeconds: unsettledBackoffSeconds(metadata.deliveryCount),\n              }\n            : undefined,\n      }) as (req: Request) => Promise<Response>,\n    isDuplicate: (error) => error instanceof queue.DuplicateMessageError,\n  }\n}\n\nexport function vercelQueues(options: VercelQueuesOptions = {}): A2Scheduler {\n  const topic = options.topic ?? 'a2'\n  if (typeof topic !== 'string' || !TOPIC_PATTERN.test(topic)) {\n    throw new TypeError('vercelQueues() topic must match [A-Za-z0-9_-]+')\n  }\n  const clock = options.clock ?? SYSTEM_CLOCK\n  const clientOptions =\n    options.deploymentId === undefined\n      ? {}\n      : { deploymentId: options.deploymentId }\n\n  // Lazy: constructing the scheduler value does no I/O and works without\n  // the peer dep until the first task or delivery.\n  const transport = retryableLazy(() =>\n    options.transport\n      ? Promise.resolve(options.transport)\n      : vercelQueueTransport(clientOptions),\n  ).get\n\n  const sendTask = async (task: SchedulerTask): Promise<void> => {\n    const nowMs = clock.now().getTime()\n    const requestedDueAt = task.dueAt\n    if (!Number.isFinite(requestedDueAt)) {\n      throw classifySchedulerSendFailure(\n        new TypeError('vercel scheduler dueAt must be a finite number'),\n        'terminal',\n      )\n    }\n    const dueAt =\n      requestedDueAt <= nowMs\n        ? Math.floor(nowMs / 1_000) * 1_000\n        : Math.ceil(requestedDueAt / 1_000) * 1_000\n    const deliveryTargetAt = task.kind === 'drain' ? dueAt : requestedDueAt\n    const deliveryDelaySeconds = Math.max(\n      0,\n      Math.ceil((deliveryTargetAt - nowMs) / 1_000),\n    )\n    const message: SchedulerTask = { ...task, dueAt }\n    const idempotencyKey =\n      task.kind === 'drain'\n        ? digestId([\n            'a2:scheduler-vercel:drain:v1',\n            topic,\n            task.contract,\n            task.sessionId,\n            String(dueAt),\n          ])\n        : task.kind === 'append'\n          ? digestId(['a2:scheduler-vercel:append:v1', topic, task.id])\n          : digestId(['a2:scheduler-vercel:clear:v1', topic, task.id])\n    const t = await transport()\n    try {\n      await t.send(topic, message, {\n        delaySeconds: deliveryDelaySeconds,\n        idempotencyKey,\n        retentionSeconds: MAX_RETENTION_SECONDS,\n      })\n    } catch (err) {\n      if (t.isDuplicate(err)) return\n      throw classifyVercelSendFailure(err)\n    }\n  }\n\n  const successorDueAt = (message: SchedulerDrainTask): number => {\n    const minimumDueAt =\n      clock.now().getTime() +\n      DRAIN_TIMINGS.claimTtlMs +\n      DRAIN_TIMINGS.watchdogGraceMs\n    const beats = Math.max(\n      1,\n      Math.ceil(\n        (minimumDueAt - message.dueAt) / DRAIN_TIMINGS.claimHeartbeatMs,\n      ),\n    )\n    return message.dueAt + beats * DRAIN_TIMINGS.claimHeartbeatMs\n  }\n\n  return {\n    async schedule(task) {\n      await sendTask(task)\n    },\n\n    handler(...servers: DrainableServer[]) {\n      assertSchedulerTargets(servers)\n      const byContract = new Map<string, DrainableServer>()\n      for (const server of servers) {\n        byContract.set(server.contract.name, server)\n      }\n      return async (req: Request): Promise<Response> => {\n        const t = await transport()\n        return t.handleCallback(async (delivered) => {\n          const task = normalizeSchedulerTask(delivered)\n          if (!task) {\n            throw new TypeError('a2 scheduler received an invalid task')\n          }\n          const server = byContract.get(task.contract)\n          if (!server) {\n            // A message for a contract this route doesn't serve is a\n            // wiring bug — throw so it redelivers and stays visible in\n            // queue observability instead of vanishing on an ack.\n            throw new Error(\n              `a2 scheduler: no server for contract '${task.contract}' — pass it to scheduler.handler(...)`,\n            )\n          }\n          const internals = serverInternals.get(server)\n          if (task.kind === 'append') {\n            await deliverSchedulerAppend(server, task)\n            return\n          }\n          if (task.kind === 'clear') {\n            await deliverSchedulerClear(server, task)\n            return\n          }\n\n          const nextDueAt = successorDueAt(task)\n          const result = internals\n            ? await internals.schedulerDrain(task.sessionId, {\n                watchdogDueAt: nextDueAt,\n              })\n            : {\n                ...(await server.drain(task.sessionId)),\n                outcome: 'unknown' as const,\n              }\n          if (result.settled) return\n\n          if (\n            result.outcome === 'busy' ||\n            result.outcome === 'stalled' ||\n            result.outcome === 'failed'\n          ) {\n            // The live owner arms its own claim windows, the store holds\n            // a failed event until its retry time, and a drain that failed\n            // after claiming armed its successor. Ensure a later slot here\n            // as well before relinquishing this durable delivery. If the queue is down, the\n            // throw leaves the current message unacked for visibility-timeout\n            // redelivery.\n            if (result.schedulerArm) await result.schedulerArm\n            else {\n              await sendTask({\n                version: 1,\n                kind: 'drain',\n                contract: task.contract,\n                sessionId: task.sessionId,\n                dueAt: nextDueAt,\n              })\n            }\n            return\n          }\n\n          // A drain whose outcome is unknown keeps the current durable message\n          // and uses the transport retry path.\n          throw new DrainUnsettled(\n            `a2 scheduler: session '${task.sessionId}' of '${task.contract}' not settled yet (${result.outcome}) — rescheduled for redelivery`,\n          )\n        })(req)\n      }\n    },\n  }\n}\n"],"mappings":"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"}