@storyshelf/core 0.6.2 → 0.7.0

package/dist/test-helpers/fake-tables.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"fake-tables.mjs","names":[],"sources":["../../src/test-helpers/fake-tables.ts"],"sourcesContent":["/**\n * Dialect-free stub tables for the in-memory test fake.\n *\n * The fake never touches a driver: it only needs table handles whose columns\n * carry the property → column-name mapping (`getTableColumns`) and flow\n * through drizzle's expression builders (`eq`, `and`, `inArray`, `orderBy`)\n * into the `sql-chunks.ts` matcher. Real `Column`/`Table` base classes from\n * the `drizzle-orm` root (already a core dependency) satisfy both without\n * pulling in any dialect package (`sqlite-core`, `pg-core`, …).\n */\nimport { Column, Table } from \"drizzle-orm\";\nimport type { Tables } from \"../adapters/database.ts\";\n\n/** A column handle with driver passthrough mapping (the fake maps nothing). */\nclass FakeColumn extends Column {\n  override getSQLType(): string {\n    return this.columnType;\n  }\n}\n\n// `Table.Symbol` is runtime-only (`@internal`, absent from the public types).\nconst columnsSymbol = (Table as unknown as { Symbol: { Columns: symbol } }).Symbol.Columns;\n\nfunction defineTable(name: string, columns: Record<string, string>): Table {\n  const table = new Table(name, undefined, name);\n  const handles: Record<string, FakeColumn> = {};\n  for (const [property, dbName] of Object.entries(columns)) {\n    handles[property] = new FakeColumn(table, {\n      name: dbName,\n      keyAsName: false,\n      notNull: false,\n      default: undefined,\n      defaultFn: undefined,\n      onUpdateFn: undefined,\n      hasDefault: false,\n      primaryKey: false,\n      isUnique: false,\n      uniqueName: undefined,\n      uniqueType: undefined,\n      dataType: \"string\",\n      columnType: \"FakeColumn\",\n      generated: undefined,\n      generatedIdentity: undefined,\n    });\n  }\n  (table as unknown as Record<symbol, unknown>)[columnsSymbol] = handles;\n  return table;\n}\n\n// Stub tables matching the real schema's property -> column mapping.\n// No constraints or defaults — just names for whereMatches/orderRows.\nconst projects = defineTable(\"projects\", {\n  id: \"id\",\n  name: \"name\",\n  slug: \"slug\",\n  gitRepository: \"git_repository\",\n  gitDefaultBranch: \"git_default_branch\",\n  pixelThreshold: \"pixel_threshold\",\n  maxDiffRatio: \"max_diff_ratio\",\n  publicBranchRegex: \"public_branch_regex\",\n  storybookMeta: \"storybook_meta\",\n  executePlay: \"execute_play\",\n  playTimeoutMs: \"play_timeout_ms\",\n  runA11y: \"run_a11y\",\n  browser: \"browser\",\n  viewports: \"viewports\",\n  automigrate: \"automigrate\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst projectStatusConfigs = defineTable(\"project_status_configs\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  provider: \"provider\",\n  config: \"config\",\n  tokenEncrypted: \"token_encrypted\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst builds = defineTable(\"builds\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  gitSha: \"git_sha\",\n  gitBranch: \"git_branch\",\n  isDefault: \"is_default\",\n  authorEmail: \"author_email\",\n  authorName: \"author_name\",\n  message: \"message\",\n  public: \"public\",\n  status: \"status\",\n  snapshotCount: \"snapshot_count\",\n  changedCount: \"changed_count\",\n  approvedCount: \"approved_count\",\n  rejectedCount: \"rejected_count\",\n  affectedOnly: \"affected_only\",\n  baselineSha: \"baseline_sha\",\n  changedFiles: \"changed_files\",\n  affectedImportPaths: \"affected_import_paths\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst captureAttempts = defineTable(\"capture_attempts\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  buildId: \"build_id\",\n  attemptNo: \"attempt_no\",\n  status: \"status\",\n  error: \"error\",\n  reqId: \"req_id\",\n  storyCount: \"story_count\",\n  failedCount: \"failed_count\",\n  queuedAt: \"queued_at\",\n  startedAt: \"started_at\",\n  finishedAt: \"finished_at\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst captureLogs = defineTable(\"capture_logs\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  buildId: \"build_id\",\n  attemptId: \"attempt_id\",\n  seq: \"seq\",\n  level: \"level\",\n  message: \"message\",\n  fields: \"fields\",\n  createdAt: \"created_at\",\n});\n\nconst snapshots = defineTable(\"snapshots\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  buildId: \"build_id\",\n  storyId: \"story_id\",\n  storyName: \"story_name\",\n  storyTitle: \"story_title\",\n  storyImportPath: \"story_import_path\",\n  viewportName: \"viewport_name\",\n  viewportWidth: \"viewport_width\",\n  viewportHeight: \"viewport_height\",\n  screenshotPath: \"screenshot_path\",\n  diffPath: \"diff_path\",\n  diffPixels: \"diff_pixels\",\n  diffRatio: \"diff_ratio\",\n  diffPassed: \"diff_passed\",\n  status: \"status\",\n  reviewedBy: \"reviewed_by\",\n  reviewedAt: \"reviewed_at\",\n  infraHash: \"infra_hash\",\n  inherited: \"inherited\",\n  baselineId: \"baseline_id\",\n  baselineVersion: \"baseline_version\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst baselines = defineTable(\"baselines\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  storyId: \"story_id\",\n  viewportName: \"viewport_name\",\n  branch: \"branch\",\n  snapshotId: \"snapshot_id\",\n  screenshotPath: \"screenshot_path\",\n  infraHash: \"infra_hash\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst comments = defineTable(\"comments\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  buildId: \"build_id\",\n  snapshotId: \"snapshot_id\",\n  userId: \"user_id\",\n  body: \"body\",\n  parentId: \"parent_id\",\n  resolved: \"resolved\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst labelTypes = defineTable(\"label_types\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  key: \"key\",\n  name: \"name\",\n  linkTemplate: \"link_template\",\n  color: \"color\",\n  createdAt: \"created_at\",\n});\n\nconst buildLabels = defineTable(\"build_labels\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  buildId: \"build_id\",\n  typeKey: \"type_key\",\n  value: \"value\",\n  createdAt: \"created_at\",\n});\n\nconst tokens = defineTable(\"tokens\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  name: \"name\",\n  hash: \"hash\",\n  userId: \"user_id\",\n  lastUsedAt: \"last_used_at\",\n  createdAt: \"created_at\",\n});\n\nconst webhooks = defineTable(\"webhooks\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  url: \"url\",\n  secretEncrypted: \"secret_encrypted\",\n  events: \"events\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst users = defineTable(\"users\", {\n  id: \"id\",\n  email: \"email\",\n  name: \"name\",\n  avatarUrl: \"avatar_url\",\n  role: \"role\",\n  lastLoginAt: \"last_login_at\",\n  createdAt: \"created_at\",\n  passwordHash: \"password_hash\",\n  displayNameOverride: \"display_name_override\",\n  authProvider: \"auth_provider\",\n  disabled: \"disabled\",\n});\n\nconst userInviteTokens = defineTable(\"user_invite_tokens\", {\n  id: \"id\",\n  userId: \"user_id\",\n  tokenHash: \"token_hash\",\n  expiresAt: \"expires_at\",\n  usedAt: \"used_at\",\n  createdAt: \"created_at\",\n});\n\nconst projectMembers = defineTable(\"project_members\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  userId: \"user_id\",\n  role: \"role\",\n  source: \"source\",\n  createdAt: \"created_at\",\n});\n\nconst projectGroupMappings = defineTable(\"project_group_mappings\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  groupName: \"group_name\",\n  role: \"role\",\n  createdAt: \"created_at\",\n});\n\nconst notificationChannels = defineTable(\"notification_channels\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  provider: \"provider\",\n  config: \"config\",\n  secretEncrypted: \"secret_encrypted\",\n  events: \"events\",\n  enabled: \"enabled\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst notificationSubscriptions = defineTable(\"notification_subscriptions\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  userId: \"user_id\",\n  events: \"events\",\n  via: \"via\",\n  enabled: \"enabled\",\n  createdAt: \"created_at\",\n});\n\nconst contentRefs = defineTable(\"content_refs\", {\n  hash: \"hash\",\n  refCount: \"ref_count\",\n  lastSeenAt: \"last_seen_at\",\n  createdAt: \"created_at\",\n});\n\n/** Stub schema bundled into the `Tables` map every fake serves. */\nexport const fakeSchema: Tables = {\n  projects,\n  projectStatusConfigs,\n  builds,\n  captureAttempts,\n  captureLogs,\n  snapshots,\n  baselines,\n  comments,\n  labelTypes,\n  buildLabels,\n  tokens,\n  webhooks,\n  users,\n  userInviteTokens,\n  projectMembers,\n  projectGroupMappings,\n  notificationChannels,\n  notificationSubscriptions,\n  contentRefs,\n};\n"],"mappings":"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"}
+{"version":3,"file":"fake-tables.mjs","names":[],"sources":["../../src/test-helpers/fake-tables.ts"],"sourcesContent":["/**\n * Dialect-free stub tables for the in-memory test fake.\n *\n * The fake never touches a driver: it only needs table handles whose columns\n * carry the property → column-name mapping (`getTableColumns`) and flow\n * through drizzle's expression builders (`eq`, `and`, `inArray`, `orderBy`)\n * into the `sql-chunks.ts` matcher. Real `Column`/`Table` base classes from\n * the `drizzle-orm` root (already a core dependency) satisfy both without\n * pulling in any dialect package (`sqlite-core`, `pg-core`, …).\n */\nimport { Column, Table } from \"drizzle-orm\";\nimport type { Tables } from \"../adapters/database.ts\";\n\n/** A column handle with driver passthrough mapping (the fake maps nothing). */\nclass FakeColumn extends Column {\n  override getSQLType(): string {\n    return this.columnType;\n  }\n}\n\n// `Table.Symbol` is runtime-only (`@internal`, absent from the public types).\nconst columnsSymbol = (Table as unknown as { Symbol: { Columns: symbol } }).Symbol.Columns;\n\nfunction defineTable(name: string, columns: Record<string, string>): Table {\n  const table = new Table(name, undefined, name);\n  const handles: Record<string, FakeColumn> = {};\n  for (const [property, dbName] of Object.entries(columns)) {\n    handles[property] = new FakeColumn(table, {\n      name: dbName,\n      keyAsName: false,\n      notNull: false,\n      default: undefined,\n      defaultFn: undefined,\n      onUpdateFn: undefined,\n      hasDefault: false,\n      primaryKey: false,\n      isUnique: false,\n      uniqueName: undefined,\n      uniqueType: undefined,\n      dataType: \"string\",\n      columnType: \"FakeColumn\",\n      generated: undefined,\n      generatedIdentity: undefined,\n    });\n  }\n  (table as unknown as Record<symbol, unknown>)[columnsSymbol] = handles;\n  return table;\n}\n\n// Stub tables matching the real schema's property -> column mapping.\n// No constraints or defaults — just names for whereMatches/orderRows.\nconst projects = defineTable(\"projects\", {\n  id: \"id\",\n  name: \"name\",\n  slug: \"slug\",\n  gitRepository: \"git_repository\",\n  gitDefaultBranch: \"git_default_branch\",\n  pixelThreshold: \"pixel_threshold\",\n  maxDiffRatio: \"max_diff_ratio\",\n  publicBranchRegex: \"public_branch_regex\",\n  storybookMeta: \"storybook_meta\",\n  executePlay: \"execute_play\",\n  playTimeoutMs: \"play_timeout_ms\",\n  runA11y: \"run_a11y\",\n  runTests: \"run_tests\",\n  browser: \"browser\",\n  viewports: \"viewports\",\n  browsers: \"browsers\",\n  modesAllowlist: \"modes_allowlist\",\n  automigrate: \"automigrate\",\n  aiProfile: \"ai_profile\",\n  reviewEnabled: \"review_enabled\",\n  reviewApprovals: \"review_approvals\",\n  storybookUrlTtlSeconds: \"storybook_url_ttl_seconds\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst designLinks = defineTable(\"design_links\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  importPath: \"import_path\",\n  label: \"label\",\n  url: \"url\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst designCredentials = defineTable(\"design_credentials\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  provider: \"provider\",\n  tokenEncrypted: \"token_encrypted\",\n  status: \"status\",\n  checkedAt: \"checked_at\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst userConnections = defineTable(\"user_connections\", {\n  id: \"id\",\n  userId: \"user_id\",\n  service: \"service\",\n  tokenEncrypted: \"token_encrypted\",\n  refreshTokenEncrypted: \"refresh_token_encrypted\",\n  expiresAt: \"expires_at\",\n  status: \"status\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst designNodes = defineTable(\"design_nodes\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  provider: \"provider\",\n  viewerId: \"viewer_id\",\n  fileKey: \"file_key\",\n  nodeId: \"node_id\",\n  name: \"name\",\n  version: \"version\",\n  lastModified: \"last_modified\",\n  state: \"state\",\n  renderPath: \"render_path\",\n  renderVersion: \"render_version\",\n  fetchedAt: \"fetched_at\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst builds = defineTable(\"builds\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  gitSha: \"git_sha\",\n  gitBranch: \"git_branch\",\n  isDefault: \"is_default\",\n  authorEmail: \"author_email\",\n  authorName: \"author_name\",\n  message: \"message\",\n  public: \"public\",\n  status: \"status\",\n  snapshotCount: \"snapshot_count\",\n  changedCount: \"changed_count\",\n  approvedCount: \"approved_count\",\n  rejectedCount: \"rejected_count\",\n  inheritedCount: \"inherited_count\",\n  affectedOnly: \"affected_only\",\n  baselineSha: \"baseline_sha\",\n  changedFiles: \"changed_files\",\n  affectedImportPaths: \"affected_import_paths\",\n  testResults: \"test_results\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst captureAttempts = defineTable(\"capture_attempts\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  buildId: \"build_id\",\n  attemptNo: \"attempt_no\",\n  status: \"status\",\n  error: \"error\",\n  reqId: \"req_id\",\n  storyCount: \"story_count\",\n  failedCount: \"failed_count\",\n  queuedAt: \"queued_at\",\n  startedAt: \"started_at\",\n  finishedAt: \"finished_at\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst captureShards = defineTable(\"capture_shards\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  buildId: \"build_id\",\n  kind: \"kind\",\n  ordinal: \"ordinal\",\n  status: \"status\",\n  attemptId: \"attempt_id\",\n  payload: \"payload\",\n  result: \"result\",\n  error: \"error\",\n  startedAt: \"started_at\",\n  finishedAt: \"finished_at\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst captureJobs = defineTable(\"capture_jobs\", {\n  id: \"id\",\n  entry: \"entry\",\n  jobId: \"job_id\",\n  kind: \"kind\",\n  buildId: \"build_id\",\n  shardId: \"shard_id\",\n  attempt: \"attempt\",\n  maxAttempts: \"max_attempts\",\n  status: \"status\",\n  visibleAt: \"visible_at\",\n  owner: \"owner\",\n  payload: \"payload\",\n  cancelRequestedAt: \"cancel_requested_at\",\n  error: \"error\",\n  startedAt: \"started_at\",\n  finishedAt: \"finished_at\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst buildComponents = defineTable(\"build_components\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  buildId: \"build_id\",\n  importPath: \"import_path\",\n  title: \"title\",\n  storyCount: \"story_count\",\n  hash: \"hash\",\n  createdAt: \"created_at\",\n});\n\nconst buildReviews = defineTable(\"build_reviews\", {\n  id: \"id\",\n  buildId: \"build_id\",\n  userId: \"user_id\",\n  verdict: \"verdict\",\n  body: \"body\",\n  createdAt: \"created_at\",\n});\n\nconst siteSettings = defineTable(\"site_settings\", {\n  id: \"id\",\n  value: \"value\",\n  updatedBy: \"updated_by\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst captureLogs = defineTable(\"capture_logs\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  buildId: \"build_id\",\n  attemptId: \"attempt_id\",\n  seq: \"seq\",\n  level: \"level\",\n  message: \"message\",\n  fields: \"fields\",\n  createdAt: \"created_at\",\n});\n\nconst snapshots = defineTable(\"snapshots\", {\n  durationMs: \"duration_ms\",\n  a11yViolations: \"a11y_violations\",\n  id: \"id\",\n  projectId: \"project_id\",\n  buildId: \"build_id\",\n  storyId: \"story_id\",\n  storyName: \"story_name\",\n  storyTitle: \"story_title\",\n  storyImportPath: \"story_import_path\",\n  viewportName: \"viewport_name\",\n  viewportWidth: \"viewport_width\",\n  viewportHeight: \"viewport_height\",\n  screenshotPath: \"screenshot_path\",\n  diffPath: \"diff_path\",\n  diffPixels: \"diff_pixels\",\n  diffRatio: \"diff_ratio\",\n  diffPassed: \"diff_passed\",\n  status: \"status\",\n  reviewedBy: \"reviewed_by\",\n  reviewedAt: \"reviewed_at\",\n  designUrl: \"design_url\",\n  infraHash: \"infra_hash\",\n  envChange: \"env_change\",\n  inherited: \"inherited\",\n  baselineId: \"baseline_id\",\n  baselineVersion: \"baseline_version\",\n  mode: \"mode\",\n  browser: \"browser\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst baselines = defineTable(\"baselines\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  storyId: \"story_id\",\n  viewportName: \"viewport_name\",\n  branch: \"branch\",\n  snapshotId: \"snapshot_id\",\n  screenshotPath: \"screenshot_path\",\n  infraHash: \"infra_hash\",\n  fingerprint: \"fingerprint\",\n  mode: \"mode\",\n  browser: \"browser\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst comments = defineTable(\"comments\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  buildId: \"build_id\",\n  snapshotId: \"snapshot_id\",\n  userId: \"user_id\",\n  body: \"body\",\n  parentId: \"parent_id\",\n  resolved: \"resolved\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n  storyId: \"story_id\",\n});\n\nconst labelTypes = defineTable(\"label_types\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  key: \"key\",\n  name: \"name\",\n  linkTemplate: \"link_template\",\n  color: \"color\",\n  createdAt: \"created_at\",\n});\n\nconst buildLabels = defineTable(\"build_labels\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  buildId: \"build_id\",\n  typeKey: \"type_key\",\n  value: \"value\",\n  createdAt: \"created_at\",\n});\n\nconst projectLinks = defineTable(\"project_links\", {\n  id: \"id\",\n  downstreamId: \"downstream_id\",\n  upstreamId: \"upstream_id\",\n  packageName: \"package_name\",\n  createdAt: \"created_at\",\n});\n\nconst buildPackageUsage = defineTable(\"build_package_usage\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  buildId: \"build_id\",\n  storyImportPath: \"story_import_path\",\n  packageName: \"package_name\",\n  modulePath: \"module_path\",\n  version: \"version\",\n  createdAt: \"created_at\",\n});\n\nconst tokens = defineTable(\"tokens\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  name: \"name\",\n  hash: \"hash\",\n  userId: \"user_id\",\n  lastUsedAt: \"last_used_at\",\n  createdAt: \"created_at\",\n});\n\nconst webhooks = defineTable(\"webhooks\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  url: \"url\",\n  secretEncrypted: \"secret_encrypted\",\n  events: \"events\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst users = defineTable(\"users\", {\n  id: \"id\",\n  email: \"email\",\n  name: \"name\",\n  avatarUrl: \"avatar_url\",\n  role: \"role\",\n  lastLoginAt: \"last_login_at\",\n  createdAt: \"created_at\",\n  passwordHash: \"password_hash\",\n  displayNameOverride: \"display_name_override\",\n  authProvider: \"auth_provider\",\n  disabled: \"disabled\",\n});\n\nconst userInviteTokens = defineTable(\"user_invite_tokens\", {\n  id: \"id\",\n  userId: \"user_id\",\n  tokenHash: \"token_hash\",\n  expiresAt: \"expires_at\",\n  usedAt: \"used_at\",\n  createdAt: \"created_at\",\n});\n\nconst projectMembers = defineTable(\"project_members\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  userId: \"user_id\",\n  role: \"role\",\n  source: \"source\",\n  createdAt: \"created_at\",\n});\n\nconst projectGroupMappings = defineTable(\"project_group_mappings\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  groupName: \"group_name\",\n  role: \"role\",\n  createdAt: \"created_at\",\n});\n\nconst insights = defineTable(\"insights\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  buildId: \"build_id\",\n  kind: \"kind\",\n  windowKey: \"window_key\",\n  inputHash: \"input_hash\",\n  status: \"status\",\n  profile: \"profile\",\n  model: \"model\",\n  promptVersion: \"prompt_version\",\n  verdict: \"verdict\",\n  summary: \"summary\",\n  result: \"result\",\n  errorCode: \"error_code\",\n  createdAt: \"created_at\",\n  startedAt: \"started_at\",\n  finishedAt: \"finished_at\",\n});\n\nconst aiUsage = defineTable(\"ai_usage\", {\n  id: \"id\",\n  insightId: \"insight_id\",\n  projectId: \"project_id\",\n  profile: \"profile\",\n  task: \"task\",\n  model: \"model\",\n  inputTokens: \"input_tokens\",\n  outputTokens: \"output_tokens\",\n  estimated: \"estimated\",\n  images: \"images\",\n  status: \"status\",\n  createdAt: \"created_at\",\n});\n\nconst aiBudgetAlerts = defineTable(\"ai_budget_alerts\", {\n  id: \"id\",\n  day: \"day\",\n  threshold: \"threshold\",\n  createdAt: \"created_at\",\n});\n\nconst notificationChannels = defineTable(\"notification_channels\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  provider: \"provider\",\n  config: \"config\",\n  secretEncrypted: \"secret_encrypted\",\n  events: \"events\",\n  enabled: \"enabled\",\n  lastError: \"last_error\",\n  lastErrorAt: \"last_error_at\",\n  createdAt: \"created_at\",\n  updatedAt: \"updated_at\",\n});\n\nconst notificationSubscriptions = defineTable(\"notification_subscriptions\", {\n  id: \"id\",\n  projectId: \"project_id\",\n  userId: \"user_id\",\n  events: \"events\",\n  via: \"via\",\n  enabled: \"enabled\",\n  createdAt: \"created_at\",\n});\n\nconst contentRefs = defineTable(\"content_refs\", {\n  hash: \"hash\",\n  refCount: \"ref_count\",\n  lastSeenAt: \"last_seen_at\",\n  createdAt: \"created_at\",\n});\n\n/** Stub schema bundled into the `Tables` map every fake serves. */\nexport const fakeSchema: Tables = {\n  projects,\n  builds,\n  captureAttempts,\n  captureLogs,\n  captureShards,\n  captureJobs,\n  buildComponents,\n  buildReviews,\n  siteSettings,\n  snapshots,\n  baselines,\n  comments,\n  labelTypes,\n  buildLabels,\n  projectLinks,\n  designLinks,\n  designCredentials,\n  userConnections,\n  designNodes,\n  buildPackageUsage,\n  tokens,\n  webhooks,\n  users,\n  userInviteTokens,\n  projectMembers,\n  projectGroupMappings,\n  insights,\n  aiUsage,\n  aiBudgetAlerts,\n  notificationChannels,\n  notificationSubscriptions,\n  contentRefs,\n};\n"],"mappings":"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"}

package/dist/test-helpers/manual-clock.d.mts

@@ -0,0 +1,27 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+//#region src/test-helpers/manual-clock.d.ts
+/**
+ * A manual clock with its own timers, for lease, poll-cadence and cancel tests that must not sleep.
+ * `advance` moves time forward and fires every timer that falls due, in order, letting promise
+ * chains settle between timers, so code under test behaves as it would with real time.
+ */
+/** Manual clock: `now` for injected clocks, `timers` for injected `setTimeout`/`clearTimeout`. */
+interface ManualClock {
+  now: () => number;
+  timers: {
+    setTimeout(callback: () => void, ms: number): unknown;
+    clearTimeout(handle: unknown): void;
+  };
+  /** Move time forward by `ms`, firing due timers in order. */
+  advance(ms: number): Promise<void>;
+  /** Let pending promise chains run without moving time. */
+  flush(): Promise<void>;
+  /** Timers currently scheduled. */
+  readonly pending: number;
+}
+/** Create a manual clock starting at `start` (epoch ms). */
+declare function createManualClock(start?: number): ManualClock;
+//#endregion
+export { ManualClock, createManualClock };
+//# sourceMappingURL=manual-clock.d.mts.map

package/dist/test-helpers/manual-clock.mjs

@@ -0,0 +1,56 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/test-helpers/manual-clock.ts
+/** Let queued promise jobs and I/O callbacks run (a few macrotask turns). */
+async function settle() {
+	for (let turn = 0; turn < 5; turn += 1) await new Promise((resolve) => {
+		setImmediate(resolve);
+	});
+}
+/** Create a manual clock starting at `start` (epoch ms). */
+function createManualClock(start = Date.parse("2026-01-01T00:00:00.000Z")) {
+	let current = start;
+	let nextId = 1;
+	const timers = [];
+	const due = (until) => timers.filter((timer) => timer.at <= until).toSorted((a, b) => a.at - b.at || a.id - b.id)[0];
+	return {
+		now: () => current,
+		timers: {
+			setTimeout: (callback, ms) => {
+				const timer = {
+					id: nextId,
+					at: current + Math.max(0, ms),
+					callback
+				};
+				nextId += 1;
+				timers.push(timer);
+				return timer.id;
+			},
+			clearTimeout: (handle) => {
+				const index = timers.findIndex((timer) => timer.id === handle);
+				if (index !== -1) timers.splice(index, 1);
+			}
+		},
+		advance: async (ms) => {
+			const until = current + ms;
+			await settle();
+			for (let timer = due(until); timer !== void 0; timer = due(until)) {
+				timers.splice(timers.indexOf(timer), 1);
+				current = Math.max(current, timer.at);
+				timer.callback();
+				await settle();
+			}
+			current = until;
+			await settle();
+		},
+		flush: settle,
+		get pending() {
+			return timers.length;
+		}
+	};
+}
+//#endregion
+export { createManualClock };
+
+//# sourceMappingURL=manual-clock.mjs.map

package/dist/test-helpers/manual-clock.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual-clock.mjs","names":[],"sources":["../../src/test-helpers/manual-clock.ts"],"sourcesContent":["/**\n * A manual clock with its own timers, for lease, poll-cadence and cancel tests that must not sleep.\n * `advance` moves time forward and fires every timer that falls due, in order, letting promise\n * chains settle between timers, so code under test behaves as it would with real time.\n */\n\n/** A scheduled callback. */\ninterface PendingTimer {\n  id: number;\n  at: number;\n  callback: () => void;\n}\n\n/** Manual clock: `now` for injected clocks, `timers` for injected `setTimeout`/`clearTimeout`. */\nexport interface ManualClock {\n  now: () => number;\n  timers: {\n    setTimeout(callback: () => void, ms: number): unknown;\n    clearTimeout(handle: unknown): void;\n  };\n  /** Move time forward by `ms`, firing due timers in order. */\n  advance(ms: number): Promise<void>;\n  /** Let pending promise chains run without moving time. */\n  flush(): Promise<void>;\n  /** Timers currently scheduled. */\n  readonly pending: number;\n}\n\n/** Let queued promise jobs and I/O callbacks run (a few macrotask turns). */\nasync function settle(): Promise<void> {\n  for (let turn = 0; turn < 5; turn += 1) {\n    // oxlint-disable-next-line eslint/no-await-in-loop -- each turn drains one round of callbacks\n    await new Promise((resolve) => {\n      setImmediate(resolve);\n    });\n  }\n}\n\n/** Create a manual clock starting at `start` (epoch ms). */\nexport function createManualClock(start = Date.parse(\"2026-01-01T00:00:00.000Z\")): ManualClock {\n  let current = start;\n  let nextId = 1;\n  const timers: PendingTimer[] = [];\n  const due = (until: number): PendingTimer | undefined =>\n    timers.filter((timer) => timer.at <= until).toSorted((a, b) => a.at - b.at || a.id - b.id)[0];\n  return {\n    now: () => current,\n    timers: {\n      setTimeout: (callback, ms) => {\n        const timer = { id: nextId, at: current + Math.max(0, ms), callback };\n        nextId += 1;\n        timers.push(timer);\n        return timer.id;\n      },\n      clearTimeout: (handle) => {\n        const index = timers.findIndex((timer) => timer.id === handle);\n        if (index !== -1) {\n          timers.splice(index, 1);\n        }\n      },\n    },\n    advance: async (ms) => {\n      const until = current + ms;\n      await settle();\n      for (let timer = due(until); timer !== undefined; timer = due(until)) {\n        timers.splice(timers.indexOf(timer), 1);\n        current = Math.max(current, timer.at);\n        timer.callback();\n        // oxlint-disable-next-line eslint/no-await-in-loop -- let the callback's promises settle\n        await settle();\n      }\n      current = until;\n      await settle();\n    },\n    flush: settle,\n    get pending() {\n      return timers.length;\n    },\n  };\n}\n"],"mappings":";;;;;AA6BA,eAAe,SAAwB;CACrC,KAAK,IAAI,OAAO,GAAG,OAAO,GAAG,QAAQ,GAEnC,MAAM,IAAI,SAAS,YAAY;EAC7B,aAAa,OAAO;CACtB,CAAC;AAEL;;AAGA,SAAgB,kBAAkB,QAAQ,KAAK,MAAM,0BAA0B,GAAgB;CAC7F,IAAI,UAAU;CACd,IAAI,SAAS;CACb,MAAM,SAAyB,CAAC;CAChC,MAAM,OAAO,UACX,OAAO,QAAQ,UAAU,MAAM,MAAM,KAAK,CAAC,CAAC,UAAU,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;CAC7F,OAAO;EACL,WAAW;EACX,QAAQ;GACN,aAAa,UAAU,OAAO;IAC5B,MAAM,QAAQ;KAAE,IAAI;KAAQ,IAAI,UAAU,KAAK,IAAI,GAAG,EAAE;KAAG;IAAS;IACpE,UAAU;IACV,OAAO,KAAK,KAAK;IACjB,OAAO,MAAM;GACf;GACA,eAAe,WAAW;IACxB,MAAM,QAAQ,OAAO,WAAW,UAAU,MAAM,OAAO,MAAM;IAC7D,IAAI,UAAU,IACZ,OAAO,OAAO,OAAO,CAAC;GAE1B;EACF;EACA,SAAS,OAAO,OAAO;GACrB,MAAM,QAAQ,UAAU;GACxB,MAAM,OAAO;GACb,KAAK,IAAI,QAAQ,IAAI,KAAK,GAAG,UAAU,KAAA,GAAW,QAAQ,IAAI,KAAK,GAAG;IACpE,OAAO,OAAO,OAAO,QAAQ,KAAK,GAAG,CAAC;IACtC,UAAU,KAAK,IAAI,SAAS,MAAM,EAAE;IACpC,MAAM,SAAS;IAEf,MAAM,OAAO;GACf;GACA,UAAU;GACV,MAAM,OAAO;EACf;EACA,OAAO;EACP,IAAI,UAAU;GACZ,OAAO,OAAO;EAChB;CACF;AACF"}

package/dist/test-helpers/notifier-contract.d.mts

@@ -6,6 +6,12 @@ import { NotifierProvider } from "../adapters/notifier/provider.mjs";
 type NotifierFactory = () => NotifierProvider | Promise<NotifierProvider>;
 /** Run the notifier contract against a factory. */
 declare function notifierContractSuite(label: string, make: NotifierFactory): void;
+/**
+ * Run the `state` delivery contract against a factory: the provider declares
+ * `delivery: "state"`, binds a valid `config` to an adapter that can `setState`,
+ * and rejects an invalid config at `create`.
+ */
+declare function stateNotifierContractSuite(label: string, make: NotifierFactory, validConfig: unknown): void;
 //#endregion
-export { NotifierFactory, notifierContractSuite };
+export { NotifierFactory, notifierContractSuite, stateNotifierContractSuite };
 //# sourceMappingURL=notifier-contract.d.mts.map

package/dist/test-helpers/notifier-contract.mjs

@@ -1,13 +1,14 @@
 import "node:path";
 import "node:url";
 import.meta.url;
+import { isStateProvider } from "../adapters/notifier/provider.mjs";
 import { describe, expect, it } from "vitest";
 //#region src/test-helpers/notifier-contract.ts
 /**
-* Published notifier contract suite for first- and third-party providers.
+* Published notifier contract suites for first- and third-party providers.
 *
 * Structural conformance (identity, descriptor, config schema). Message
-* delivery stays per-package behind faked transports.
+* and state delivery stay per-package behind faked transports.
 */
 /** Run the notifier contract against a factory. */
 function notifierContractSuite(label, make) {
@@ -28,7 +29,35 @@ function notifierContractSuite(label, make) {
 		});
 	});
 }
+/**
+* Run the `state` delivery contract against a factory: the provider declares
+* `delivery: "state"`, binds a valid `config` to an adapter that can `setState`,
+* and rejects an invalid config at `create`.
+*/
+function stateNotifierContractSuite(label, make, validConfig) {
+	notifierContractSuite(label, make);
+	describe(`state notifier contract: ${label}`, () => {
+		it("declares state delivery", async () => {
+			const provider = await make();
+			expect(isStateProvider(provider)).toBe(true);
+		});
+		it("binds a valid config to an adapter that can set state", async () => {
+			const adapter = (await make()).create({
+				config: validConfig,
+				secret: "token"
+			});
+			expect("setState" in adapter && typeof adapter.setState === "function").toBe(true);
+		});
+		it("rejects an invalid config at create", async () => {
+			const provider = await make();
+			expect(() => provider.create({
+				config: {},
+				secret: "token"
+			})).toThrow();
+		});
+	});
+}
 //#endregion
-export { notifierContractSuite };
+export { notifierContractSuite, stateNotifierContractSuite };
 
 //# sourceMappingURL=notifier-contract.mjs.map

package/dist/test-helpers/notifier-contract.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"notifier-contract.mjs","names":[],"sources":["../../src/test-helpers/notifier-contract.ts"],"sourcesContent":["/**\n * Published notifier contract suite for first- and third-party providers.\n *\n * Structural conformance (identity, descriptor, config schema). Message\n * delivery stays per-package behind faked transports.\n */\nimport { describe, expect, it } from \"vitest\";\nimport type { NotifierProvider } from \"../adapters/notifier/provider.ts\";\n\n/** Build the provider under test (sync or async factories both work). */\nexport type NotifierFactory = () => NotifierProvider | Promise<NotifierProvider>;\n\n/** Run the notifier contract against a factory. */\nexport function notifierContractSuite(label: string, make: NotifierFactory): void {\n  describe(`notifier contract: ${label}`, () => {\n    it(\"exposes notifier metadata with a config schema\", async () => {\n      const provider = await make();\n      expect(provider.metadata.category).toBe(\"notifier\");\n      expect(provider.metadata.kind.length).toBeGreaterThan(0);\n      expect(typeof provider.metadata.schema.parse).toBe(\"function\");\n    });\n\n    it(\"exposes the create descriptor\", async () => {\n      const provider = await make();\n      expect(typeof provider.create).toBe(\"function\");\n    });\n\n    it(\"validates channel config through a real schema\", async () => {\n      const provider = await make();\n      const result = provider.metadata.schema.safeParse({});\n      expect(typeof result.success).toBe(\"boolean\");\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;AAaA,SAAgB,sBAAsB,OAAe,MAA6B;CAChF,SAAS,sBAAsB,eAAe;EAC5C,GAAG,kDAAkD,YAAY;GAC/D,MAAM,WAAW,MAAM,KAAK;GAC5B,OAAO,SAAS,SAAS,QAAQ,CAAC,CAAC,KAAK,UAAU;GAClD,OAAO,SAAS,SAAS,KAAK,MAAM,CAAC,CAAC,gBAAgB,CAAC;GACvD,OAAO,OAAO,SAAS,SAAS,OAAO,KAAK,CAAC,CAAC,KAAK,UAAU;EAC/D,CAAC;EAED,GAAG,iCAAiC,YAAY;GAC9C,MAAM,WAAW,MAAM,KAAK;GAC5B,OAAO,OAAO,SAAS,MAAM,CAAC,CAAC,KAAK,UAAU;EAChD,CAAC;EAED,GAAG,kDAAkD,YAAY;GAE/D,MAAM,UAAS,MADQ,KAAK,EAAA,CACJ,SAAS,OAAO,UAAU,CAAC,CAAC;GACpD,OAAO,OAAO,OAAO,OAAO,CAAC,CAAC,KAAK,SAAS;EAC9C,CAAC;CACH,CAAC;AACH"}
+{"version":3,"file":"notifier-contract.mjs","names":[],"sources":["../../src/test-helpers/notifier-contract.ts"],"sourcesContent":["/**\n * Published notifier contract suites for first- and third-party providers.\n *\n * Structural conformance (identity, descriptor, config schema). Message\n * and state delivery stay per-package behind faked transports.\n */\nimport { describe, expect, it } from \"vitest\";\nimport type { NotifierProvider } from \"../adapters/notifier/provider.ts\";\nimport { isStateProvider } from \"../adapters/notifier/provider.ts\";\n\n/** Build the provider under test (sync or async factories both work). */\nexport type NotifierFactory = () => NotifierProvider | Promise<NotifierProvider>;\n\n/** Run the notifier contract against a factory. */\nexport function notifierContractSuite(label: string, make: NotifierFactory): void {\n  describe(`notifier contract: ${label}`, () => {\n    it(\"exposes notifier metadata with a config schema\", async () => {\n      const provider = await make();\n      expect(provider.metadata.category).toBe(\"notifier\");\n      expect(provider.metadata.kind.length).toBeGreaterThan(0);\n      expect(typeof provider.metadata.schema.parse).toBe(\"function\");\n    });\n\n    it(\"exposes the create descriptor\", async () => {\n      const provider = await make();\n      expect(typeof provider.create).toBe(\"function\");\n    });\n\n    it(\"validates channel config through a real schema\", async () => {\n      const provider = await make();\n      const result = provider.metadata.schema.safeParse({});\n      expect(typeof result.success).toBe(\"boolean\");\n    });\n  });\n}\n\n/**\n * Run the `state` delivery contract against a factory: the provider declares\n * `delivery: \"state\"`, binds a valid `config` to an adapter that can `setState`,\n * and rejects an invalid config at `create`.\n */\nexport function stateNotifierContractSuite(\n  label: string,\n  make: NotifierFactory,\n  validConfig: unknown,\n): void {\n  notifierContractSuite(label, make);\n  describe(`state notifier contract: ${label}`, () => {\n    it(\"declares state delivery\", async () => {\n      const provider = await make();\n      expect(isStateProvider(provider)).toBe(true);\n    });\n\n    it(\"binds a valid config to an adapter that can set state\", async () => {\n      const provider = await make();\n      const adapter = provider.create({ config: validConfig, secret: \"token\" });\n      expect(\"setState\" in adapter && typeof adapter.setState === \"function\").toBe(true);\n    });\n\n    it(\"rejects an invalid config at create\", async () => {\n      const provider = await make();\n      expect(() => provider.create({ config: {}, secret: \"token\" })).toThrow();\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;;AAcA,SAAgB,sBAAsB,OAAe,MAA6B;CAChF,SAAS,sBAAsB,eAAe;EAC5C,GAAG,kDAAkD,YAAY;GAC/D,MAAM,WAAW,MAAM,KAAK;GAC5B,OAAO,SAAS,SAAS,QAAQ,CAAC,CAAC,KAAK,UAAU;GAClD,OAAO,SAAS,SAAS,KAAK,MAAM,CAAC,CAAC,gBAAgB,CAAC;GACvD,OAAO,OAAO,SAAS,SAAS,OAAO,KAAK,CAAC,CAAC,KAAK,UAAU;EAC/D,CAAC;EAED,GAAG,iCAAiC,YAAY;GAC9C,MAAM,WAAW,MAAM,KAAK;GAC5B,OAAO,OAAO,SAAS,MAAM,CAAC,CAAC,KAAK,UAAU;EAChD,CAAC;EAED,GAAG,kDAAkD,YAAY;GAE/D,MAAM,UAAS,MADQ,KAAK,EAAA,CACJ,SAAS,OAAO,UAAU,CAAC,CAAC;GACpD,OAAO,OAAO,OAAO,OAAO,CAAC,CAAC,KAAK,SAAS;EAC9C,CAAC;CACH,CAAC;AACH;;;;;;AAOA,SAAgB,2BACd,OACA,MACA,aACM;CACN,sBAAsB,OAAO,IAAI;CACjC,SAAS,4BAA4B,eAAe;EAClD,GAAG,2BAA2B,YAAY;GACxC,MAAM,WAAW,MAAM,KAAK;GAC5B,OAAO,gBAAgB,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI;EAC7C,CAAC;EAED,GAAG,yDAAyD,YAAY;GAEtE,MAAM,WAAU,MADO,KAAK,EAAA,CACH,OAAO;IAAE,QAAQ;IAAa,QAAQ;GAAQ,CAAC;GACxE,OAAO,cAAc,WAAW,OAAO,QAAQ,aAAa,UAAU,CAAC,CAAC,KAAK,IAAI;EACnF,CAAC;EAED,GAAG,uCAAuC,YAAY;GACpD,MAAM,WAAW,MAAM,KAAK;GAC5B,aAAa,SAAS,OAAO;IAAE,QAAQ,CAAC;IAAG,QAAQ;GAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ;EACzE,CAAC;CACH,CAAC;AACH"}

package/dist/test-helpers/queue-contract.d.mts

@@ -4,8 +4,22 @@ import { CaptureQueue } from "../adapter/capture-queue.mjs";
 //#region src/test-helpers/queue-contract.d.ts
 /** Build the adapter under test (sync or async factories both work). */
 type QueueFactory = () => CaptureQueue | Promise<CaptureQueue>;
+/** Options of {@link queueContractSuite}. */
+interface QueueContractOptions {
+  /** Run the delivery cases; the factory must then return a `PollableCaptureQueue`. */
+  pollable?: PollableContractOptions;
+}
+/** What the harness tells the delivery cases about the queue it builds. */
+interface PollableContractOptions {
+  /** Move the queue's clock forward by `ms` (fake timers or an injected clock). */
+  advance?: (ms: number) => void | Promise<void>;
+  /** Lease the factory grants per delivery; with `advance`, enables the redelivery cases. */
+  leaseMs?: number;
+  /** Retries the factory allows after the first delivery; enables the exhaustion case. */
+  retries?: number;
+}
 /** Run the queue contract against a factory. */
-declare function queueContractSuite(label: string, make: QueueFactory): void;
+declare function queueContractSuite(label: string, make: QueueFactory, options?: QueueContractOptions): void;
 //#endregion
-export { QueueFactory, queueContractSuite };
+export { PollableContractOptions, QueueContractOptions, QueueFactory, queueContractSuite };
 //# sourceMappingURL=queue-contract.d.mts.map

package/dist/test-helpers/queue-contract.mjs

@@ -16,9 +16,21 @@ import { describe, expect, it } from "vitest";
 * Behavioral cases (enqueue/status/active/recent) need a fake transport that
 * answers realistically; structural cases (poll extension rule) run against
 * any factory.
+*
+* Pollable queues opt in to the delivery cases (poll, ack, nack, extend, redelivery, at-most-one
+* claim, cancel) with `options.pollable`. Time-dependent cases (delayed nack, lease expiry) run only
+* when the harness can move the queue's clock (`advance`), and retry exhaustion only when it says
+* how many retries the queue allows; queues without `extend`, `inspect` or `cancel` skip those
+* checks, so the suite stays backward compatible.
 */
+let sequence = 0;
+/** A build id no other case (or earlier run on a shared backend) uses. */
+function freshId(tag) {
+	sequence += 1;
+	return `b-contract-${tag}-${String(Date.now())}-${String(sequence)}`;
+}
 /** Run the queue contract against a factory. */
-function queueContractSuite(label, make) {
+function queueContractSuite(label, make, options = {}) {
 	describe(`queue contract: ${label}`, () => {
 		it("exposes capture-queue metadata", async () => {
 			const queue = await make();
@@ -56,6 +68,188 @@ function queueContractSuite(label, make) {
 			await queue.lifecycle.teardown();
 			await expect(queue.lifecycle.teardown()).resolves.toBeUndefined();
 		});
+		if (options.pollable !== void 0) pollableCases(make, options.pollable);
+	});
+}
+async function makePollable(make) {
+	const queue = await make();
+	expect(typeof queue.poll).toBe("function");
+	return queue;
+}
+/** Poll until the job for `buildId` comes up (other cases' leftovers on a shared backend are skipped). */
+async function pollFor(queue, buildId, tries = 20) {
+	for (let attempt = 0; attempt < tries; attempt += 1) {
+		const job = await queue.poll();
+		if (job === null || job.buildId === buildId) return job;
+		await queue.ack(job);
+	}
+	return null;
+}
+function pollableCases(make, options) {
+	describe("delivery", () => {
+		deliveryCases(make);
+		retryCases(make, options);
+		if (options.advance !== void 0 && options.leaseMs !== void 0) leaseCases(make, options.advance, options.leaseMs);
+		cancelCases(make);
+	});
+}
+function deliveryCases(make) {
+	it("delivers an enqueued job once, with its fields, as a first attempt", async () => {
+		const queue = await makePollable(make);
+		const buildId = freshId("deliver");
+		await queue.enqueue({
+			buildId,
+			reqId: "req-1",
+			traceparent: "00-abc-def-01",
+			shard: "s-1"
+		});
+		const job = await pollFor(queue, buildId);
+		expect(job).toMatchObject({
+			buildId,
+			reqId: "req-1",
+			traceparent: "00-abc-def-01",
+			shard: "s-1"
+		});
+		expect(job?.attempts ?? 0).toBe(0);
+		expect(await pollFor(queue, buildId)).toBeNull();
+		await queue.ack(job);
+	});
+	it("lets at most one of many concurrent polls claim a job", async () => {
+		const queue = await makePollable(make);
+		const buildId = freshId("race");
+		await queue.enqueue({ buildId });
+		const results = await Promise.all(Array.from({ length: 6 }, async () => await queue.poll()));
+		const claimed = results.filter((job) => job?.buildId === buildId);
+		expect(claimed).toHaveLength(1);
+		await Promise.all(results.flatMap((job) => job === null ? [] : [queue.ack(job)]));
+	});
+	it("does not redeliver an acked job and reports it completed", async () => {
+		const queue = await makePollable(make);
+		const buildId = freshId("ack");
+		await queue.enqueue({ buildId });
+		const job = await pollFor(queue, buildId);
+		await queue.ack(job);
+		expect(await pollFor(queue, buildId)).toBeNull();
+		expect((await queue.status(buildId))?.status).toBe("completed");
+	});
+	it("renews the holder's lease while it owns the job", async () => {
+		const queue = await makePollable(make);
+		const buildId = freshId("extend");
+		await queue.enqueue({ buildId });
+		const job = await pollFor(queue, buildId);
+		if (queue.extend !== void 0) expect(await queue.extend(job)).toBe("ok");
+		if (queue.inspect !== void 0) expect(await queue.inspect(job)).toBe("ok");
+		await queue.ack(job);
+	});
+}
+function retryCases(make, options) {
+	it("redelivers a nacked job as the next attempt", async () => {
+		const queue = await makePollable(make);
+		const buildId = freshId("nack");
+		await queue.enqueue({ buildId });
+		const first = await pollFor(queue, buildId);
+		await queue.nack(first, {
+			requeue: true,
+			error: "boom"
+		});
+		const second = await pollFor(queue, buildId);
+		expect(second?.buildId).toBe(buildId);
+		expect(second?.attempts ?? 0).toBeGreaterThan(first?.attempts ?? 0);
+		await queue.ack(second);
+	});
+	it("drops a job nacked with requeue: false and reports it failed", async () => {
+		const queue = await makePollable(make);
+		const buildId = freshId("drop");
+		await queue.enqueue({ buildId });
+		const job = await pollFor(queue, buildId);
+		await queue.nack(job, {
+			requeue: false,
+			error: "fatal"
+		});
+		expect(await pollFor(queue, buildId)).toBeNull();
+		const entry = await queue.status(buildId);
+		expect(entry?.status).toBe("failed");
+		expect(entry?.error).toBe("fatal");
+	});
+	if (options.advance !== void 0) {
+		const { advance } = options;
+		it("hides a job nacked with a delay until the delay passes", async () => {
+			const queue = await makePollable(make);
+			const buildId = freshId("delay");
+			await queue.enqueue({ buildId });
+			const job = await pollFor(queue, buildId);
+			await queue.nack(job, {
+				requeue: true,
+				delayMs: 1e4
+			});
+			expect(await pollFor(queue, buildId)).toBeNull();
+			await advance(10001);
+			const again = await pollFor(queue, buildId);
+			expect(again?.buildId).toBe(buildId);
+			await queue.ack(again);
+		});
+	}
+	if (options.retries !== void 0) {
+		const { retries } = options;
+		it("fails a job once its retries are spent", async () => {
+			const queue = await makePollable(make);
+			const buildId = freshId("exhaust");
+			await queue.enqueue({ buildId });
+			for (let attempt = 0; attempt <= retries; attempt += 1) {
+				const job = await pollFor(queue, buildId);
+				expect(job?.buildId).toBe(buildId);
+				await queue.nack(job, {
+					requeue: true,
+					error: `attempt ${String(attempt)}`
+				});
+			}
+			expect(await pollFor(queue, buildId)).toBeNull();
+			expect((await queue.status(buildId))?.status).toBe("failed");
+		});
+	}
+}
+function leaseCases(make, advance, leaseMs) {
+	it("redelivers a job whose lease expired, and the stale holder learns it lost", async () => {
+		const queue = await makePollable(make);
+		const buildId = freshId("expire");
+		await queue.enqueue({ buildId });
+		const stale = await pollFor(queue, buildId);
+		expect(await pollFor(queue, buildId)).toBeNull();
+		await advance(leaseMs + 1);
+		const fresh = await pollFor(queue, buildId);
+		expect(fresh?.buildId).toBe(buildId);
+		expect(fresh?.attempts ?? 0).toBeGreaterThan(stale?.attempts ?? 0);
+		if (queue.extend !== void 0) {
+			expect(await queue.extend(stale)).toBe("lost");
+			expect(await queue.extend(fresh)).toBe("ok");
+		}
+		await queue.ack(fresh);
+	});
+}
+function cancelCases(make) {
+	it("cancels a queued job at once and flags a running one", async () => {
+		const queue = await makePollable(make);
+		if (queue.cancel === void 0) {
+			expect(queue.cancel).toBeUndefined();
+			return;
+		}
+		const queued = freshId("cancel-queued");
+		const running = freshId("cancel-running");
+		await queue.enqueue({ buildId: queued });
+		expect(await queue.cancel(queued)).toBe(true);
+		expect((await queue.status(queued))?.status).toBe("cancelled");
+		await queue.enqueue({ buildId: running });
+		const job = await pollFor(queue, running);
+		expect(job?.buildId).toBe(running);
+		expect(await queue.cancel(running)).toBe(true);
+		const seen = await (queue.inspect ?? queue.extend)?.(job);
+		expect(seen ?? "cancelled").toBe("cancelled");
+		await queue.nack(job, {
+			requeue: false,
+			error: "cancelled"
+		});
+		expect((await queue.status(running))?.status).toBe("cancelled");
+		expect(await queue.cancel("b-contract-unknown")).toBe(false);
 	});
 }
 //#endregion

package/dist/test-helpers/queue-contract.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"queue-contract.mjs","names":[],"sources":["../../src/test-helpers/queue-contract.ts"],"sourcesContent":["/**\n * Published queue contract suite for first- and third-party adapters.\n *\n * A package proves conformance in one line from its own vitest file:\n *\n * ```ts\n * import { queueContractSuite } from \"@storyshelf/core/test-helpers\";\n * queueContractSuite(\"sqs\", () => createSqsCaptureQueue({ queueUrl, client: fake }));\n * ```\n *\n * Behavioral cases (enqueue/status/active/recent) need a fake transport that\n * answers realistically; structural cases (poll extension rule) run against\n * any factory.\n */\nimport { describe, expect, it } from \"vitest\";\nimport type { CaptureQueue } from \"../adapters/capture-queue.ts\";\n\n/** Build the adapter under test (sync or async factories both work). */\nexport type QueueFactory = () => CaptureQueue | Promise<CaptureQueue>;\n\n/** Run the queue contract against a factory. */\nexport function queueContractSuite(label: string, make: QueueFactory): void {\n  describe(`queue contract: ${label}`, () => {\n    it(\"exposes capture-queue metadata\", async () => {\n      const queue = await make();\n      expect(queue.metadata.category).toBe(\"capture-queue\");\n      expect(queue.metadata.kind.length).toBeGreaterThan(0);\n    });\n\n    it(\"keeps the poll extension all-or-nothing\", async () => {\n      const queue = await make();\n      const record = queue as unknown as Record<string, unknown>;\n      const present = [\"poll\", \"ack\", \"nack\"].filter((method) => record[method] !== undefined);\n      expect([0, 3]).toContain(present.length);\n      for (const method of present) {\n        expect(typeof record[method]).toBe(\"function\");\n      }\n    });\n\n    it(\"tracks an enqueued build through status/active/recent\", async () => {\n      const queue = await make();\n      await queue.enqueue({ buildId: \"b-contract-1\" });\n      const entry = await queue.status(\"b-contract-1\");\n      expect(entry?.buildId).toBe(\"b-contract-1\");\n      // Remote transports report \"queued\" until a worker polls; in-process\n      // queues may already report \"running\".\n      expect([\"queued\", \"running\"]).toContain(entry?.status);\n      expect((await queue.active()).map((job) => job.buildId)).toContain(\"b-contract-1\");\n      expect((await queue.recent(10)).map((job) => job.buildId)).toContain(\"b-contract-1\");\n      expect(await queue.status(\"b-missing\")).toBeNull();\n    });\n\n    it(\"keeps lifecycle idempotent when present\", async () => {\n      const queue = await make();\n      if (queue.lifecycle === undefined) {\n        expect(queue.lifecycle).toBeUndefined();\n        return;\n      }\n      await queue.lifecycle.setup({} as never);\n      await queue.lifecycle.setup({} as never);\n      await queue.lifecycle.teardown();\n      await expect(queue.lifecycle.teardown()).resolves.toBeUndefined();\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,mBAAmB,OAAe,MAA0B;CAC1E,SAAS,mBAAmB,eAAe;EACzC,GAAG,kCAAkC,YAAY;GAC/C,MAAM,QAAQ,MAAM,KAAK;GACzB,OAAO,MAAM,SAAS,QAAQ,CAAC,CAAC,KAAK,eAAe;GACpD,OAAO,MAAM,SAAS,KAAK,MAAM,CAAC,CAAC,gBAAgB,CAAC;EACtD,CAAC;EAED,GAAG,2CAA2C,YAAY;GAExD,MAAM,SAAS,MADK,KAAK;GAEzB,MAAM,UAAU;IAAC;IAAQ;IAAO;GAAM,CAAC,CAAC,QAAQ,WAAW,OAAO,YAAY,KAAA,CAAS;GACvF,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,QAAQ,MAAM;GACvC,KAAK,MAAM,UAAU,SACnB,OAAO,OAAO,OAAO,OAAO,CAAC,CAAC,KAAK,UAAU;EAEjD,CAAC;EAED,GAAG,yDAAyD,YAAY;GACtE,MAAM,QAAQ,MAAM,KAAK;GACzB,MAAM,MAAM,QAAQ,EAAE,SAAS,eAAe,CAAC;GAC/C,MAAM,QAAQ,MAAM,MAAM,OAAO,cAAc;GAC/C,OAAO,OAAO,OAAO,CAAC,CAAC,KAAK,cAAc;GAG1C,OAAO,CAAC,UAAU,SAAS,CAAC,CAAC,CAAC,UAAU,OAAO,MAAM;GACrD,QAAQ,MAAM,MAAM,OAAO,EAAA,CAAG,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,UAAU,cAAc;GACjF,QAAQ,MAAM,MAAM,OAAO,EAAE,EAAA,CAAG,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,UAAU,cAAc;GACnF,OAAO,MAAM,MAAM,OAAO,WAAW,CAAC,CAAC,CAAC,SAAS;EACnD,CAAC;EAED,GAAG,2CAA2C,YAAY;GACxD,MAAM,QAAQ,MAAM,KAAK;GACzB,IAAI,MAAM,cAAc,KAAA,GAAW;IACjC,OAAO,MAAM,SAAS,CAAC,CAAC,cAAc;IACtC;GACF;GACA,MAAM,MAAM,UAAU,MAAM,CAAC,CAAU;GACvC,MAAM,MAAM,UAAU,MAAM,CAAC,CAAU;GACvC,MAAM,MAAM,UAAU,SAAS;GAC/B,MAAM,OAAO,MAAM,UAAU,SAAS,CAAC,CAAC,CAAC,SAAS,cAAc;EAClE,CAAC;CACH,CAAC;AACH"}
+{"version":3,"file":"queue-contract.mjs","names":[],"sources":["../../src/test-helpers/queue-contract.ts"],"sourcesContent":["/**\n * Published queue contract suite for first- and third-party adapters.\n *\n * A package proves conformance in one line from its own vitest file:\n *\n * ```ts\n * import { queueContractSuite } from \"@storyshelf/core/test-helpers\";\n * queueContractSuite(\"sqs\", () => createSqsCaptureQueue({ queueUrl, client: fake }));\n * ```\n *\n * Behavioral cases (enqueue/status/active/recent) need a fake transport that\n * answers realistically; structural cases (poll extension rule) run against\n * any factory.\n *\n * Pollable queues opt in to the delivery cases (poll, ack, nack, extend, redelivery, at-most-one\n * claim, cancel) with `options.pollable`. Time-dependent cases (delayed nack, lease expiry) run only\n * when the harness can move the queue's clock (`advance`), and retry exhaustion only when it says\n * how many retries the queue allows; queues without `extend`, `inspect` or `cancel` skip those\n * checks, so the suite stays backward compatible.\n */\nimport { describe, expect, it } from \"vitest\";\nimport type { CaptureQueue, PollableCaptureQueue, PollableJob } from \"../adapters/capture-queue.ts\";\n\n/** Build the adapter under test (sync or async factories both work). */\nexport type QueueFactory = () => CaptureQueue | Promise<CaptureQueue>;\n\n/** Options of {@link queueContractSuite}. */\nexport interface QueueContractOptions {\n  /** Run the delivery cases; the factory must then return a `PollableCaptureQueue`. */\n  pollable?: PollableContractOptions;\n}\n\n/** What the harness tells the delivery cases about the queue it builds. */\nexport interface PollableContractOptions {\n  /** Move the queue's clock forward by `ms` (fake timers or an injected clock). */\n  advance?: (ms: number) => void | Promise<void>;\n  /** Lease the factory grants per delivery; with `advance`, enables the redelivery cases. */\n  leaseMs?: number;\n  /** Retries the factory allows after the first delivery; enables the exhaustion case. */\n  retries?: number;\n}\n\nlet sequence = 0;\n\n/** A build id no other case (or earlier run on a shared backend) uses. */\nfunction freshId(tag: string): string {\n  sequence += 1;\n  return `b-contract-${tag}-${String(Date.now())}-${String(sequence)}`;\n}\n\n/** Run the queue contract against a factory. */\nexport function queueContractSuite(\n  label: string,\n  make: QueueFactory,\n  options: QueueContractOptions = {},\n): void {\n  describe(`queue contract: ${label}`, () => {\n    it(\"exposes capture-queue metadata\", async () => {\n      const queue = await make();\n      expect(queue.metadata.category).toBe(\"capture-queue\");\n      expect(queue.metadata.kind.length).toBeGreaterThan(0);\n    });\n\n    it(\"keeps the poll extension all-or-nothing\", async () => {\n      const queue = await make();\n      const record = queue as unknown as Record<string, unknown>;\n      const present = [\"poll\", \"ack\", \"nack\"].filter((method) => record[method] !== undefined);\n      expect([0, 3]).toContain(present.length);\n      for (const method of present) {\n        expect(typeof record[method]).toBe(\"function\");\n      }\n    });\n\n    it(\"tracks an enqueued build through status/active/recent\", async () => {\n      const queue = await make();\n      await queue.enqueue({ buildId: \"b-contract-1\" });\n      const entry = await queue.status(\"b-contract-1\");\n      expect(entry?.buildId).toBe(\"b-contract-1\");\n      // Remote transports report \"queued\" until a worker polls; in-process\n      // queues may already report \"running\".\n      expect([\"queued\", \"running\"]).toContain(entry?.status);\n      expect((await queue.active()).map((job) => job.buildId)).toContain(\"b-contract-1\");\n      expect((await queue.recent(10)).map((job) => job.buildId)).toContain(\"b-contract-1\");\n      expect(await queue.status(\"b-missing\")).toBeNull();\n    });\n\n    it(\"keeps lifecycle idempotent when present\", async () => {\n      const queue = await make();\n      if (queue.lifecycle === undefined) {\n        expect(queue.lifecycle).toBeUndefined();\n        return;\n      }\n      await queue.lifecycle.setup({} as never);\n      await queue.lifecycle.setup({} as never);\n      await queue.lifecycle.teardown();\n      await expect(queue.lifecycle.teardown()).resolves.toBeUndefined();\n    });\n\n    if (options.pollable !== undefined) {\n      pollableCases(make, options.pollable);\n    }\n  });\n}\n\nasync function makePollable(make: QueueFactory): Promise<PollableCaptureQueue> {\n  const queue = (await make()) as PollableCaptureQueue;\n  expect(typeof queue.poll).toBe(\"function\");\n  return queue;\n}\n\n/** Poll until the job for `buildId` comes up (other cases' leftovers on a shared backend are skipped). */\nasync function pollFor(\n  queue: PollableCaptureQueue,\n  buildId: string,\n  tries = 20,\n): Promise<PollableJob | null> {\n  for (let attempt = 0; attempt < tries; attempt += 1) {\n    // oxlint-disable-next-line eslint/no-await-in-loop -- sequential polls are the point\n    const job = await queue.poll();\n    if (job === null || job.buildId === buildId) {\n      return job;\n    }\n    // oxlint-disable-next-line eslint/no-await-in-loop -- settle someone else's job and keep looking\n    await queue.ack(job);\n  }\n  return null;\n}\n\nfunction pollableCases(make: QueueFactory, options: PollableContractOptions): void {\n  describe(\"delivery\", () => {\n    deliveryCases(make);\n    retryCases(make, options);\n    if (options.advance !== undefined && options.leaseMs !== undefined) {\n      leaseCases(make, options.advance, options.leaseMs);\n    }\n    cancelCases(make);\n  });\n}\n\nfunction deliveryCases(make: QueueFactory): void {\n  it(\"delivers an enqueued job once, with its fields, as a first attempt\", async () => {\n    const queue = await makePollable(make);\n    const buildId = freshId(\"deliver\");\n    await queue.enqueue({ buildId, reqId: \"req-1\", traceparent: \"00-abc-def-01\", shard: \"s-1\" });\n    const job = await pollFor(queue, buildId);\n    expect(job).toMatchObject({\n      buildId,\n      reqId: \"req-1\",\n      traceparent: \"00-abc-def-01\",\n      shard: \"s-1\",\n    });\n    expect(job?.attempts ?? 0).toBe(0);\n    expect(await pollFor(queue, buildId)).toBeNull();\n    await queue.ack(job!);\n  });\n\n  it(\"lets at most one of many concurrent polls claim a job\", async () => {\n    const queue = await makePollable(make);\n    const buildId = freshId(\"race\");\n    await queue.enqueue({ buildId });\n    const results = await Promise.all(Array.from({ length: 6 }, async () => await queue.poll()));\n    const claimed = results.filter((job) => job?.buildId === buildId);\n    expect(claimed).toHaveLength(1);\n    await Promise.all(results.flatMap((job) => (job === null ? [] : [queue.ack(job)])));\n  });\n\n  it(\"does not redeliver an acked job and reports it completed\", async () => {\n    const queue = await makePollable(make);\n    const buildId = freshId(\"ack\");\n    await queue.enqueue({ buildId });\n    const job = await pollFor(queue, buildId);\n    await queue.ack(job!);\n    expect(await pollFor(queue, buildId)).toBeNull();\n    expect((await queue.status(buildId))?.status).toBe(\"completed\");\n  });\n\n  it(\"renews the holder's lease while it owns the job\", async () => {\n    const queue = await makePollable(make);\n    const buildId = freshId(\"extend\");\n    await queue.enqueue({ buildId });\n    const job = await pollFor(queue, buildId);\n    if (queue.extend !== undefined) {\n      expect(await queue.extend(job!)).toBe(\"ok\");\n    }\n    if (queue.inspect !== undefined) {\n      expect(await queue.inspect(job!)).toBe(\"ok\");\n    }\n    await queue.ack(job!);\n  });\n}\n\nfunction retryCases(make: QueueFactory, options: PollableContractOptions): void {\n  it(\"redelivers a nacked job as the next attempt\", async () => {\n    const queue = await makePollable(make);\n    const buildId = freshId(\"nack\");\n    await queue.enqueue({ buildId });\n    const first = await pollFor(queue, buildId);\n    await queue.nack(first!, { requeue: true, error: \"boom\" });\n    const second = await pollFor(queue, buildId);\n    expect(second?.buildId).toBe(buildId);\n    expect(second?.attempts ?? 0).toBeGreaterThan(first?.attempts ?? 0);\n    await queue.ack(second!);\n  });\n\n  it(\"drops a job nacked with requeue: false and reports it failed\", async () => {\n    const queue = await makePollable(make);\n    const buildId = freshId(\"drop\");\n    await queue.enqueue({ buildId });\n    const job = await pollFor(queue, buildId);\n    await queue.nack(job!, { requeue: false, error: \"fatal\" });\n    expect(await pollFor(queue, buildId)).toBeNull();\n    const entry = await queue.status(buildId);\n    expect(entry?.status).toBe(\"failed\");\n    expect(entry?.error).toBe(\"fatal\");\n  });\n\n  if (options.advance !== undefined) {\n    const { advance } = options;\n    it(\"hides a job nacked with a delay until the delay passes\", async () => {\n      const queue = await makePollable(make);\n      const buildId = freshId(\"delay\");\n      await queue.enqueue({ buildId });\n      const job = await pollFor(queue, buildId);\n      await queue.nack(job!, { requeue: true, delayMs: 10_000 });\n      expect(await pollFor(queue, buildId)).toBeNull();\n      await advance(10_001);\n      const again = await pollFor(queue, buildId);\n      expect(again?.buildId).toBe(buildId);\n      await queue.ack(again!);\n    });\n  }\n\n  if (options.retries !== undefined) {\n    const { retries } = options;\n    it(\"fails a job once its retries are spent\", async () => {\n      const queue = await makePollable(make);\n      const buildId = freshId(\"exhaust\");\n      await queue.enqueue({ buildId });\n      for (let attempt = 0; attempt <= retries; attempt += 1) {\n        // oxlint-disable-next-line eslint/no-await-in-loop -- attempts are sequential\n        const job = await pollFor(queue, buildId);\n        expect(job?.buildId).toBe(buildId);\n        // oxlint-disable-next-line eslint/no-await-in-loop -- see above\n        await queue.nack(job!, { requeue: true, error: `attempt ${String(attempt)}` });\n      }\n      expect(await pollFor(queue, buildId)).toBeNull();\n      expect((await queue.status(buildId))?.status).toBe(\"failed\");\n    });\n  }\n}\n\nfunction leaseCases(\n  make: QueueFactory,\n  advance: (ms: number) => void | Promise<void>,\n  leaseMs: number,\n): void {\n  it(\"redelivers a job whose lease expired, and the stale holder learns it lost\", async () => {\n    const queue = await makePollable(make);\n    const buildId = freshId(\"expire\");\n    await queue.enqueue({ buildId });\n    const stale = await pollFor(queue, buildId);\n    expect(await pollFor(queue, buildId)).toBeNull();\n    await advance(leaseMs + 1);\n    const fresh = await pollFor(queue, buildId);\n    expect(fresh?.buildId).toBe(buildId);\n    expect(fresh?.attempts ?? 0).toBeGreaterThan(stale?.attempts ?? 0);\n    if (queue.extend !== undefined) {\n      expect(await queue.extend(stale!)).toBe(\"lost\");\n      expect(await queue.extend(fresh!)).toBe(\"ok\");\n    }\n    await queue.ack(fresh!);\n  });\n}\n\nfunction cancelCases(make: QueueFactory): void {\n  it(\"cancels a queued job at once and flags a running one\", async () => {\n    const queue = await makePollable(make);\n    if (queue.cancel === undefined) {\n      expect(queue.cancel).toBeUndefined();\n      return;\n    }\n    const queued = freshId(\"cancel-queued\");\n    const running = freshId(\"cancel-running\");\n    await queue.enqueue({ buildId: queued });\n    expect(await queue.cancel(queued)).toBe(true);\n    expect((await queue.status(queued))?.status).toBe(\"cancelled\");\n    await queue.enqueue({ buildId: running });\n    const job = await pollFor(queue, running);\n    expect(job?.buildId).toBe(running);\n    expect(await queue.cancel(running)).toBe(true);\n    const seen = await (queue.inspect ?? queue.extend)?.(job!);\n    expect(seen ?? \"cancelled\").toBe(\"cancelled\");\n    await queue.nack(job!, { requeue: false, error: \"cancelled\" });\n    expect((await queue.status(running))?.status).toBe(\"cancelled\");\n    expect(await queue.cancel(\"b-contract-unknown\")).toBe(false);\n  });\n}\n"],"mappings":"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"}

package/dist/test-helpers/queue-multi-instance.d.mts

@@ -0,0 +1,20 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { DatabaseAdapter } from "../adapter/database.mjs";
+//#region src/test-helpers/queue-multi-instance.d.ts
+/** A set-up database the instances of one case share. */
+type SharedDatabaseFactory = () => DatabaseAdapter | Promise<DatabaseAdapter>;
+/** Options of {@link databaseQueueMultiInstanceSuite}. */
+interface MultiInstanceOptions {
+  /** Queue instances sharing the database (default 4). */
+  instances?: number;
+  /** Jobs in the exactly-once case (default 24). */
+  jobs?: number;
+  /** Per-case timeout in ms, for slow remote databases (default vitest's). */
+  timeoutMs?: number;
+}
+/** Run the multi-instance suite against databases from `makeDb`. */
+declare function databaseQueueMultiInstanceSuite(label: string, makeDb: SharedDatabaseFactory, options?: MultiInstanceOptions): void;
+//#endregion
+export { MultiInstanceOptions, SharedDatabaseFactory, databaseQueueMultiInstanceSuite };
+//# sourceMappingURL=queue-multi-instance.d.mts.map