@storyshelf/app 0.6.1 → 0.7.0

package/dist/routers/builds.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"builds.mjs","names":["notFoundResponse","forbiddenResponse"],"sources":["../../src/routers/builds.ts"],"sourcesContent":["import { createRoute, z } from \"@hono/zod-openapi\";\nimport { DEFAULT_MAX_UPLOAD_BYTES } from \"@storyshelf/core/config\";\nimport { BuildModel } from \"@storyshelf/core/models\";\nimport { storybookZipPath } from \"@storyshelf/core/utils\";\nimport { HTTPException } from \"hono/http-exception\";\nimport type { ShelfRouter } from \"../app-types.ts\";\nimport { getStore } from \"../store.ts\";\nimport { registerAttempts } from \"./attempts.ts\";\nimport {\n  VIEW_ROLES,\n  DEVELOPER_ROLES,\n  APPROVER_ROLES,\n  buildCreateJsonSchema,\n  buildListQuery,\n  buildForProject,\n  createBuildRecord,\n  persistInlineStatics,\n  storeUploadStream,\n} from \"./builds.handlers.ts\";\n\nasync function upsertContentRef(hash: string): Promise<void> {\n  try {\n    const contentRefs = getStore().db.tables.contentRefs;\n    const now = new Date().toISOString();\n    const existing = await getStore().db.get(contentRefs, hash);\n    if (existing) {\n      await getStore().db.update(contentRefs, hash, {\n        refCount: (existing as { refCount: number }).refCount + 1,\n        lastSeenAt: now,\n      });\n    } else {\n      await getStore().db.insert(contentRefs, {\n        hash,\n        refCount: 1,\n        lastSeenAt: now,\n        createdAt: now,\n      });\n    }\n  } catch {\n    // ignore — content_refs may not exist on old DB\n  }\n}\nimport { registerComments } from \"./comments.ts\";\nimport { flashHx } from \"./flash.ts\";\nimport { resolveAuthorizedProject } from \"./helpers.ts\";\nimport { hxRefresh } from \"./htmx.ts\";\nimport {\n  badRequest,\n  buildSchema,\n  forbidden as forbiddenResponse,\n  notFound as notFoundResponse,\n  unauthorized,\n} from \"./schemas.ts\";\nimport { registerSnapshots } from \"./snapshots.ts\";\n/** Register the build list, upload, fetch, retry, and delete endpoints. */\nexport function registerBuilds(app: ShelfRouter): void {\n  app.openapi(listBuildsRoute, async (c) => {\n    const project = await resolveAuthorizedProject(c, c.req.valid(\"param\").slug, ...VIEW_ROLES);\n    const { status, branch, labelKey, labelValue } = c.req.valid(\"query\");\n    const builds = new BuildModel(getStore().db).list(project.id, {\n      status,\n      branch: branch ?? undefined,\n      labelKey: labelKey ?? undefined,\n      labelValue: labelValue ?? undefined,\n    });\n    return c.json(await builds);\n  });\n\n  app.openapi(createBuildRoute, async (c) => {\n    const project = await resolveAuthorizedProject(\n      c,\n      c.req.valid(\"param\").slug,\n      ...DEVELOPER_ROLES,\n    );\n    const parsed = buildCreateJsonSchema.safeParse(await c.req.json());\n    if (!parsed.success) {\n      throw new HTTPException(400, { message: parsed.error.message });\n    }\n    const build = await createBuildRecord(project, parsed.data);\n    const uploadUrl = `/api/v1/projects/${project.slug}/builds/${build.id}/zip`;\n    return c.json({ build, uploadUrl, baselineSha: build.baselineSha }, 202);\n  });\n\n  app.openapi(affectedRoute, async (c) => {\n    const { slug, buildId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...DEVELOPER_ROLES);\n    const build = await buildForProject(project.id, buildId);\n    const { baselineSha, changedFiles, affectedImportPaths } = c.req.valid(\"json\");\n    const updated = await new BuildModel(getStore().db).setAffected(build.id, {\n      baselineSha,\n      changedFiles,\n      affectedImportPaths,\n    });\n    return c.json(updated);\n  });\n\n  app.openapi(uploadZipRoute, async (c) => {\n    const { slug, buildId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...DEVELOPER_ROLES);\n    const build = await buildForProject(project.id, buildId);\n    const maxBytes = getStore().config.maxUploadBytes ?? DEFAULT_MAX_UPLOAD_BYTES;\n    await storeUploadStream(\n      getStore().storage,\n      storybookZipPath(project.id, build.id),\n      c.req.raw.body,\n      maxBytes,\n    );\n\n    const reqId = c.get(\"requestId\");\n    await getStore().enqueueCapture?.(build.id, reqId);\n    const { storage, config, logger } = getStore();\n    await persistInlineStatics(\n      storage,\n      config.scratchDir,\n      config.maxInlineUnzipSize,\n      c.req.header(\"content-length\"),\n      project.id,\n      build.id,\n      logger,\n    );\n    return c.json(build, 202);\n  });\n\n  app.openapi(dedupRoute, async (c) => {\n    const { slug, buildId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...DEVELOPER_ROLES);\n    await buildForProject(project.id, buildId);\n    const { hashes } = c.req.valid(\"json\");\n    const needed: string[] = [];\n    for (const hash of hashes) {\n      if (!(await getStore().storage.exists(`content/${hash}`))) {\n        needed.push(hash);\n      }\n    }\n    return c.json({ needed });\n  });\n\n  // oxlint-disable eslint(max-depth) -- dedup upload handler is intentionally nested for batch handling\n  app.openapi(contentUploadRoute, async (c) => {\n    const { slug, buildId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...DEVELOPER_ROLES);\n    await buildForProject(project.id, buildId);\n    const contentType = c.req.header(\"content-type\") ?? \"\";\n    if (contentType.includes(\"multipart/\")) {\n      const form = await c.req.formData();\n      for (const [key, value] of form.entries()) {\n        if (value instanceof File) {\n          const hash = key;\n          const buffer = Buffer.from(await value.arrayBuffer());\n          await getStore().storage.write(`content/${hash}`, buffer);\n          await upsertContentRef(hash);\n        }\n      }\n    } else {\n      // Single content upload via PUT with hash header\n      const hash = c.req.header(\"x-content-hash\") ?? \"\";\n      if (!hash) throw new HTTPException(400, { message: \"Missing X-Content-Hash\" });\n      const buffer = Buffer.from(await c.req.arrayBuffer());\n      await getStore().storage.write(`content/${hash}`, buffer);\n    }\n    return c.json({ ok: true });\n  });\n\n  app.openapi(manifestRoute, async (c) => {\n    const { slug, buildId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...DEVELOPER_ROLES);\n    const build = await buildForProject(project.id, buildId);\n    const { files } = c.req.valid(\"json\");\n    const manifest: Record<string, string> = {};\n    for (const f of files) {\n      manifest[f.rel] = f.hash;\n    }\n    await getStore().storage.write(\n      `${project.id}/builds/${build.id}/storybook/manifest.json`,\n      Buffer.from(JSON.stringify(manifest)),\n    );\n    // Upsert content_refs for each hash\n    for (const f of files) {\n      try {\n        const contentRefs = getStore().db.tables.contentRefs;\n        const now = new Date().toISOString();\n        const existing = await getStore().db.get(contentRefs, f.hash);\n        // oxlint-disable-next-line unicorn/no-if-else -- upsert is clearer as if/else\n        if (!existing) {\n          await getStore().db.insert(contentRefs, {\n            hash: f.hash,\n            refCount: 1,\n            lastSeenAt: now,\n            createdAt: now,\n          });\n        } else {\n          await getStore().db.update(contentRefs, f.hash, {\n            lastSeenAt: now,\n          });\n        }\n      } catch {\n        // ignore — content_refs may not exist\n      }\n    }\n    const reqId = c.get(\"requestId\");\n    await getStore().enqueueCapture?.(build.id, reqId);\n    return c.json({ ok: true });\n  });\n\n  app.openapi(getBuildRoute, async (c) => {\n    const { slug, buildId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...VIEW_ROLES);\n    const build = await buildForProject(project.id, buildId);\n    return c.json(build);\n  });\n\n  app.openapi(retryBuildRoute, async (c) => {\n    const { slug, buildId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...DEVELOPER_ROLES);\n    const build = await buildForProject(project.id, buildId);\n    const updated = await new BuildModel(getStore().db).setStatus(build.id, \"pending\");\n    await getStore().enqueueCapture?.(build.id, c.get(\"requestId\"));\n    hxRefresh(c);\n    flashHx(c, \"Capture queued\");\n    return c.json(updated, 202);\n  });\n\n  app.openapi(deleteBuildRoute, async (c) => {\n    const { slug, buildId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...APPROVER_ROLES);\n    const build = await buildForProject(project.id, buildId);\n    await new BuildModel(getStore().db).remove(build.id);\n    return c.body(null, 204);\n  });\n\n  registerSnapshots(app);\n  registerComments(app);\n  registerAttempts(app);\n}\n\nconst listBuildsRoute = createRoute({\n  method: \"get\",\n  tags: [\"Builds\"],\n  summary: \"List builds\",\n  path: \"/api/v1/projects/{slug}/builds\",\n  request: { params: z.object({ slug: z.string() }), query: buildListQuery },\n  responses: {\n    200: {\n      content: { \"application/json\": { schema: buildSchema.array() } },\n      description: \"List builds for a project\",\n    },\n    ...notFoundResponse,\n    ...unauthorized,\n  },\n});\n\nconst buildCreatedSchema = z\n  .object({ build: buildSchema, uploadUrl: z.string(), baselineSha: z.string().nullable() })\n  .openapi(\"BuildCreated\");\n\nconst createBuildRoute = createRoute({\n  method: \"post\",\n  tags: [\"Builds\"],\n  summary: \"Create a build\",\n  path: \"/api/v1/projects/{slug}/builds\",\n  request: {\n    params: z.object({ slug: z.string() }),\n    body: {\n      content: {\n        \"application/json\": { schema: buildCreateJsonSchema },\n      },\n    },\n  },\n  responses: {\n    202: {\n      content: {\n        \"application/json\": {\n          schema: buildCreatedSchema,\n        },\n      },\n      description: \"Build created. PUT the Storybook zip to uploadUrl to queue capture.\",\n    },\n    ...badRequest,\n    ...forbiddenResponse,\n    ...notFoundResponse,\n  },\n});\n\nconst uploadZipRoute = createRoute({\n  method: \"put\",\n  tags: [\"Builds\"],\n  summary: \"Upload the Storybook zip\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}/zip\",\n  request: {\n    params: z.object({ slug: z.string(), buildId: z.string() }),\n    body: {\n      content: {\n        \"application/zip\": {\n          schema: z.string().openapi({ type: \"string\", format: \"binary\" }),\n        },\n      },\n    },\n  },\n  responses: {\n    202: {\n      content: { \"application/json\": { schema: buildSchema } },\n      description: \"Zip stored and capture queued\",\n    },\n    413: {\n      content: {\n        \"application/json\": {\n          schema: z.object({ message: z.string() }).openapi(\"Error\"),\n        },\n      },\n      description: \"Upload exceeds the configured size limit\",\n    },\n    ...badRequest,\n    ...forbiddenResponse,\n    ...notFoundResponse,\n  },\n});\n\nconst dedupHashesSchema = z.object({ hashes: z.array(z.string()) });\nconst dedupNeededSchema = z.object({ needed: z.array(z.string()) });\nconst dedupRoute = createRoute({\n  method: \"post\",\n  tags: [\"Builds\"],\n  summary: \"Check which files need uploading\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}/dedup\",\n  request: {\n    params: z.object({ slug: z.string(), buildId: z.string() }),\n    body: { content: { \"application/json\": { schema: dedupHashesSchema } } },\n  },\n  responses: {\n    200: {\n      content: { \"application/json\": { schema: dedupNeededSchema } },\n      description: \"Hashes needed for upload\",\n    },\n    ...notFoundResponse,\n  },\n});\n\nconst contentUploadRoute = createRoute({\n  method: \"post\",\n  tags: [\"Builds\"],\n  summary: \"Upload build content\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}/content\",\n  request: {\n    params: z.object({ slug: z.string(), buildId: z.string() }),\n    body: { content: { \"multipart/form-data\": { schema: z.any() } } },\n  },\n  responses: {\n    200: {\n      content: { \"application/json\": { schema: z.object({ ok: z.boolean() }) } },\n      description: \"Content uploaded\",\n    },\n    ...notFoundResponse,\n  },\n});\n\nconst manifestFileSchema = z.object({ rel: z.string(), hash: z.string(), size: z.number() });\nconst manifestRoute = createRoute({\n  method: \"post\",\n  tags: [\"Builds\"],\n  summary: \"Store the build manifest\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}/manifest\",\n  request: {\n    params: z.object({ slug: z.string(), buildId: z.string() }),\n    body: {\n      content: {\n        \"application/json\": {\n          schema: z.object({ files: z.array(manifestFileSchema) }),\n        },\n      },\n    },\n  },\n  responses: {\n    200: {\n      content: { \"application/json\": { schema: z.object({ ok: z.boolean() }) } },\n      description: \"Manifest stored\",\n    },\n    ...notFoundResponse,\n  },\n});\n\nconst affectedPayloadSchema = z.object({\n  baselineSha: z.string().nullable(),\n  changedFiles: z.array(z.string()).max(20_000),\n  affectedImportPaths: z.array(z.string()).max(20_000).nullable(),\n});\nconst affectedRoute = createRoute({\n  method: \"post\",\n  tags: [\"Builds\"],\n  summary: \"Record the affected stories\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}/affected\",\n  request: {\n    params: z.object({ slug: z.string(), buildId: z.string() }),\n    body: { content: { \"application/json\": { schema: affectedPayloadSchema } } },\n  },\n  responses: {\n    200: {\n      content: { \"application/json\": { schema: buildSchema } },\n      description: \"Affected set recorded\",\n    },\n    ...badRequest,\n    ...forbiddenResponse,\n    ...notFoundResponse,\n  },\n});\n\nconst getBuildRoute = createRoute({\n  method: \"get\",\n  tags: [\"Builds\"],\n  summary: \"Get a build\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}\",\n  request: { params: z.object({ slug: z.string(), buildId: z.string() }) },\n  responses: {\n    200: { content: { \"application/json\": { schema: buildSchema } }, description: \"Fetch a build\" },\n    ...notFoundResponse,\n    ...unauthorized,\n  },\n});\n\nconst retryBuildRoute = createRoute({\n  method: \"post\",\n  tags: [\"Builds\"],\n  summary: \"Retry capture\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}/retry\",\n  request: { params: z.object({ slug: z.string(), buildId: z.string() }) },\n  responses: {\n    202: {\n      content: { \"application/json\": { schema: buildSchema } },\n      description: \"Build reset to pending and capture re-queued (new attempt)\",\n    },\n    ...notFoundResponse,\n  },\n});\n\nconst deleteBuildRoute = createRoute({\n  method: \"delete\",\n  tags: [\"Builds\"],\n  summary: \"Delete a build\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}\",\n  request: { params: z.object({ slug: z.string(), buildId: z.string() }) },\n  responses: {\n    204: { description: \"Build deleted\" },\n    ...notFoundResponse,\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"builds.mjs","names":["notFoundResponse","forbiddenResponse"],"sources":["../../src/routers/builds.ts"],"sourcesContent":["import { createRoute, z } from \"@hono/zod-openapi\";\nimport { DEFAULT_MAX_UPLOAD_BYTES } from \"@storyshelf/core/config\";\nimport { BuildModel, PackageUsageModel } from \"@storyshelf/core/models\";\nimport { storybookZipPath } from \"@storyshelf/core/utils\";\nimport { HTTPException } from \"hono/http-exception\";\nimport type { ShelfRouter } from \"../app-types.ts\";\nimport { getStore } from \"../store.ts\";\nimport { registerAttempts } from \"./attempts.ts\";\nimport {\n  VIEW_ROLES,\n  DEVELOPER_ROLES,\n  APPROVER_ROLES,\n  buildCreateJsonSchema,\n  buildListQuery,\n  buildForProject,\n  createBuildRecord,\n  storeUploadStream,\n} from \"./builds.handlers.ts\";\nimport { discardZip, planUpload, publishUpload } from \"./publish-upload.ts\";\n\n/** Decide how the stored zip is published; a zip this host cannot publish is removed and refused. */\nasync function planOrDiscard(\n  zipBytes: number,\n  projectId: string,\n  buildId: string,\n): Promise<\"inline\" | \"job\"> {\n  try {\n    return planUpload(zipBytes);\n  } catch (error) {\n    await discardZip(projectId, buildId);\n    throw error;\n  }\n}\n\nasync function upsertContentRef(hash: string): Promise<void> {\n  try {\n    const contentRefs = getStore().db.tables.contentRefs;\n    const now = new Date().toISOString();\n    const existing = await getStore().db.get(contentRefs, hash);\n    if (existing) {\n      await getStore().db.update(contentRefs, hash, {\n        refCount: (existing as { refCount: number }).refCount + 1,\n        lastSeenAt: now,\n      });\n    } else {\n      await getStore().db.insert(contentRefs, {\n        hash,\n        refCount: 1,\n        lastSeenAt: now,\n        createdAt: now,\n      });\n    }\n  } catch {\n    // ignore — content_refs may not exist on old DB\n  }\n}\nimport { registerBuildCancel } from \"./build-cancel.ts\";\nimport { registerBuildChangeset } from \"./build-changeset.ts\";\nimport { registerBuildReviews } from \"./build-reviews.ts\";\nimport { registerComments } from \"./comments.ts\";\nimport { flashHx } from \"./flash.ts\";\nimport { resolveAuthorizedProject } from \"./helpers.ts\";\nimport { hxRefresh } from \"./htmx.ts\";\nimport {\n  badRequest,\n  buildSchema,\n  forbidden as forbiddenResponse,\n  notFound as notFoundResponse,\n  unauthorized,\n} from \"./schemas.ts\";\nimport { registerSnapshots } from \"./snapshots.ts\";\n/** Register the build list, upload, fetch, retry, and delete endpoints. */\nexport function registerBuilds(app: ShelfRouter): void {\n  app.openapi(listBuildsRoute, async (c) => {\n    const project = await resolveAuthorizedProject(c, c.req.valid(\"param\").slug, ...VIEW_ROLES);\n    const { status, branch, labelKey, labelValue } = c.req.valid(\"query\");\n    const builds = new BuildModel(getStore().db).list(project.id, {\n      status,\n      branch: branch ?? undefined,\n      labelKey: labelKey ?? undefined,\n      labelValue: labelValue ?? undefined,\n    });\n    return c.json(await builds);\n  });\n\n  app.openapi(createBuildRoute, async (c) => {\n    const project = await resolveAuthorizedProject(\n      c,\n      c.req.valid(\"param\").slug,\n      ...DEVELOPER_ROLES,\n    );\n    const build = await createBuildRecord(project, c.req.valid(\"json\"));\n    const uploadUrl = `/api/v1/projects/${project.slug}/builds/${build.id}/zip`;\n    return c.json(\n      { build, uploadUrl, baselineSha: build.baselineSha, testing: getStore().testing },\n      202,\n    );\n  });\n\n  app.openapi(affectedRoute, async (c) => {\n    const { slug, buildId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...DEVELOPER_ROLES);\n    const build = await buildForProject(project.id, buildId);\n    const { baselineSha, changedFiles, affectedImportPaths } = c.req.valid(\"json\");\n    const updated = await new BuildModel(getStore().db).setAffected(build.id, {\n      baselineSha,\n      changedFiles,\n      affectedImportPaths,\n    });\n    return c.json(updated);\n  });\n\n  app.openapi(usageRoute, async (c) => {\n    const { slug, buildId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...DEVELOPER_ROLES);\n    const build = await buildForProject(project.id, buildId);\n    const { usage } = c.req.valid(\"json\");\n    const stored = await new PackageUsageModel(getStore().db).replaceForBuild(\n      project.id,\n      build.id,\n      usage,\n    );\n    return c.json({ stored });\n  });\n\n  app.openapi(uploadZipRoute, async (c) => {\n    const { slug, buildId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...DEVELOPER_ROLES);\n    const build = await buildForProject(project.id, buildId);\n    const maxBytes = getStore().config.maxUploadBytes ?? DEFAULT_MAX_UPLOAD_BYTES;\n    const zipBytes = await storeUploadStream(\n      getStore().storage,\n      storybookZipPath(project.id, build.id),\n      c.req.raw.body,\n      maxBytes,\n    );\n    const route = await planOrDiscard(zipBytes, project.id, build.id);\n    const reqId = c.get(\"requestId\");\n    await getStore().enqueueCapture?.(build.id, reqId);\n    return c.json(await publishUpload(route, build, reqId), 202);\n  });\n\n  app.openapi(dedupRoute, async (c) => {\n    const { slug, buildId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...DEVELOPER_ROLES);\n    await buildForProject(project.id, buildId);\n    const { hashes } = c.req.valid(\"json\");\n    const needed: string[] = [];\n    for (const hash of hashes) {\n      if (!(await getStore().storage.exists(`content/${hash}`))) {\n        needed.push(hash);\n      }\n    }\n    return c.json({ needed });\n  });\n\n  // oxlint-disable eslint(max-depth) -- dedup upload handler is intentionally nested for batch handling\n  app.openapi(contentUploadRoute, async (c) => {\n    const { slug, buildId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...DEVELOPER_ROLES);\n    await buildForProject(project.id, buildId);\n    const contentType = c.req.header(\"content-type\") ?? \"\";\n    if (contentType.includes(\"multipart/\")) {\n      const form = await c.req.formData();\n      for (const [key, value] of form.entries()) {\n        if (value instanceof File) {\n          const hash = key;\n          const buffer = Buffer.from(await value.arrayBuffer());\n          await getStore().storage.write(`content/${hash}`, buffer);\n          await upsertContentRef(hash);\n        }\n      }\n    } else {\n      // Single content upload via PUT with hash header\n      const hash = c.req.header(\"x-content-hash\") ?? \"\";\n      if (!hash) throw new HTTPException(400, { message: \"Missing X-Content-Hash\" });\n      const buffer = Buffer.from(await c.req.arrayBuffer());\n      await getStore().storage.write(`content/${hash}`, buffer);\n    }\n    return c.json({ ok: true });\n  });\n\n  app.openapi(manifestRoute, async (c) => {\n    const { slug, buildId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...DEVELOPER_ROLES);\n    const build = await buildForProject(project.id, buildId);\n    const { files } = c.req.valid(\"json\");\n    const manifest: Record<string, string> = {};\n    for (const f of files) {\n      manifest[f.rel] = f.hash;\n    }\n    await getStore().storage.write(\n      `${project.id}/builds/${build.id}/storybook/manifest.json`,\n      Buffer.from(JSON.stringify(manifest)),\n    );\n    // Upsert content_refs for each hash\n    for (const f of files) {\n      try {\n        const contentRefs = getStore().db.tables.contentRefs;\n        const now = new Date().toISOString();\n        const existing = await getStore().db.get(contentRefs, f.hash);\n        // oxlint-disable-next-line unicorn/no-if-else -- upsert is clearer as if/else\n        if (!existing) {\n          await getStore().db.insert(contentRefs, {\n            hash: f.hash,\n            refCount: 1,\n            lastSeenAt: now,\n            createdAt: now,\n          });\n        } else {\n          await getStore().db.update(contentRefs, f.hash, {\n            lastSeenAt: now,\n          });\n        }\n      } catch {\n        // ignore — content_refs may not exist\n      }\n    }\n    // The files are stored content-addressed: nothing to extract, so publishing is complete.\n    await getStore().publish?.completer.complete(build.id, { ok: true });\n    const reqId = c.get(\"requestId\");\n    await getStore().enqueueCapture?.(build.id, reqId);\n    return c.json({ ok: true });\n  });\n\n  app.openapi(getBuildRoute, async (c) => {\n    const { slug, buildId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...VIEW_ROLES);\n    const build = await buildForProject(project.id, buildId);\n    return c.json(build);\n  });\n\n  app.openapi(retryBuildRoute, async (c) => {\n    const { slug, buildId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...DEVELOPER_ROLES);\n    const build = await buildForProject(project.id, buildId);\n    const updated = await new BuildModel(getStore().db).resetStatus(build.id, \"pending\");\n    await getStore().enqueueCapture?.(build.id, c.get(\"requestId\"));\n    hxRefresh(c);\n    flashHx(c, \"Capture queued\");\n    return c.json(updated, 202);\n  });\n\n  app.openapi(deleteBuildRoute, async (c) => {\n    const { slug, buildId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...APPROVER_ROLES);\n    const build = await buildForProject(project.id, buildId);\n    await new BuildModel(getStore().db).remove(build.id);\n    return c.body(null, 204);\n  });\n\n  registerSnapshots(app);\n  registerComments(app);\n  registerBuildReviews(app);\n  registerBuildChangeset(app);\n  registerBuildCancel(app);\n  registerAttempts(app);\n}\n\nconst listBuildsRoute = createRoute({\n  method: \"get\",\n  tags: [\"Builds\"],\n  summary: \"List builds\",\n  path: \"/api/v1/projects/{slug}/builds\",\n  request: { params: z.object({ slug: z.string() }), query: buildListQuery },\n  responses: {\n    200: {\n      content: { \"application/json\": { schema: buildSchema.array() } },\n      description: \"List builds for a project\",\n    },\n    ...notFoundResponse,\n    ...unauthorized,\n  },\n});\n\nconst buildCreatedSchema = z\n  .object({\n    build: buildSchema,\n    uploadUrl: z.string(),\n    baselineSha: z.string().nullable(),\n    testing: z.boolean().openapi({\n      description:\n        \"False when the server has no `testing` option: the build is published but never captured or compared.\",\n    }),\n  })\n  .openapi(\"BuildCreated\");\n\nconst createBuildRoute = createRoute({\n  method: \"post\",\n  tags: [\"Builds\"],\n  summary: \"Create a build\",\n  path: \"/api/v1/projects/{slug}/builds\",\n  request: {\n    params: z.object({ slug: z.string() }),\n    body: {\n      content: {\n        \"application/json\": { schema: buildCreateJsonSchema },\n      },\n    },\n  },\n  responses: {\n    202: {\n      content: {\n        \"application/json\": {\n          schema: buildCreatedSchema,\n        },\n      },\n      description:\n        \"Build created. PUT the Storybook zip to uploadUrl to publish it (and queue capture when testing is on).\",\n    },\n    ...badRequest,\n    ...forbiddenResponse,\n    ...notFoundResponse,\n  },\n});\n\nconst uploadZipRoute = createRoute({\n  method: \"put\",\n  tags: [\"Builds\"],\n  summary: \"Upload the Storybook zip\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}/zip\",\n  request: {\n    params: z.object({ slug: z.string(), buildId: z.string() }),\n    body: {\n      content: {\n        \"application/zip\": {\n          schema: z.string().openapi({ type: \"string\", format: \"binary\" }),\n        },\n      },\n    },\n  },\n  responses: {\n    202: {\n      content: { \"application/json\": { schema: buildSchema } },\n      description:\n        \"Zip stored. A zip up to maxInlineUnzipSize (default 50 MB) is extracted inline in this request; a larger one is published by a background job. With testing off, the build becomes approved when publishing finishes on the project's default branch (failed if it cannot be published) and stays pending on other branches; with testing on, capture sets the status.\",\n    },\n    413: {\n      content: {\n        \"application/json\": {\n          schema: z.object({ message: z.string() }).openapi(\"Error\"),\n        },\n      },\n      description:\n        \"Upload exceeds the configured size limit, or the zip is over the inline limit and this host (serverless) runs no publish consumer: upload file by file instead (POST /dedup, PUT /content, POST /manifest)\",\n    },\n    ...badRequest,\n    ...forbiddenResponse,\n    ...notFoundResponse,\n  },\n});\n\nconst dedupHashesSchema = z.object({ hashes: z.array(z.string()) });\nconst dedupNeededSchema = z.object({ needed: z.array(z.string()) });\nconst dedupRoute = createRoute({\n  method: \"post\",\n  tags: [\"Builds\"],\n  summary: \"Check which files need uploading\",\n  description:\n    \"File-by-file upload, step 1 (dedup, content, manifest): needs no zip extraction and works on any host, serverless included. Send the content hashes; the response lists those the server does not hold yet.\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}/dedup\",\n  request: {\n    params: z.object({ slug: z.string(), buildId: z.string() }),\n    body: { content: { \"application/json\": { schema: dedupHashesSchema } } },\n  },\n  responses: {\n    200: {\n      content: { \"application/json\": { schema: dedupNeededSchema } },\n      description: \"Hashes needed for upload\",\n    },\n    ...notFoundResponse,\n  },\n});\n\nconst contentUploadRoute = createRoute({\n  method: \"post\",\n  tags: [\"Builds\"],\n  summary: \"Upload build content\",\n  description:\n    \"File-by-file upload, step 2: store the missing files content-addressed (multipart, or one file with an X-Content-Hash header).\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}/content\",\n  request: {\n    params: z.object({ slug: z.string(), buildId: z.string() }),\n    body: { content: { \"multipart/form-data\": { schema: z.any() } } },\n  },\n  responses: {\n    200: {\n      content: { \"application/json\": { schema: z.object({ ok: z.boolean() }) } },\n      description: \"Content uploaded\",\n    },\n    ...notFoundResponse,\n  },\n});\n\nconst manifestFileSchema = z.object({ rel: z.string(), hash: z.string(), size: z.number() });\nconst manifestRoute = createRoute({\n  method: \"post\",\n  tags: [\"Builds\"],\n  summary: \"Store the build manifest\",\n  description:\n    \"File-by-file upload, step 3: store the path-to-hash manifest. This completes publishing. With testing off the build becomes approved when it is on the project's default branch and stays pending on other branches; with testing on, a capture is queued and sets the status.\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}/manifest\",\n  request: {\n    params: z.object({ slug: z.string(), buildId: z.string() }),\n    body: {\n      content: {\n        \"application/json\": {\n          schema: z.object({ files: z.array(manifestFileSchema) }),\n        },\n      },\n    },\n  },\n  responses: {\n    200: {\n      content: { \"application/json\": { schema: z.object({ ok: z.boolean() }) } },\n      description: \"Manifest stored\",\n    },\n    ...notFoundResponse,\n  },\n});\n\nconst affectedPayloadSchema = z.object({\n  baselineSha: z.string().nullable(),\n  changedFiles: z.array(z.string()).max(20_000),\n  affectedImportPaths: z.array(z.string()).max(20_000).nullable(),\n});\nconst affectedRoute = createRoute({\n  method: \"post\",\n  tags: [\"Builds\"],\n  summary: \"Record the affected stories\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}/affected\",\n  request: {\n    params: z.object({ slug: z.string(), buildId: z.string() }),\n    body: { content: { \"application/json\": { schema: affectedPayloadSchema } } },\n  },\n  responses: {\n    200: {\n      content: { \"application/json\": { schema: buildSchema } },\n      description: \"Affected set recorded\",\n    },\n    ...badRequest,\n    ...forbiddenResponse,\n    ...notFoundResponse,\n  },\n});\n\nconst usagePayloadSchema = z.object({\n  usage: z\n    .array(\n      z.object({\n        storyImportPath: z.string().min(1).max(1024),\n        packageName: z.string().min(1).max(214),\n        modulePath: z.string().min(1).max(2048),\n        version: z.string().max(128).nullable().optional(),\n      }),\n    )\n    .max(20_000),\n});\nconst usageRoute = createRoute({\n  method: \"post\",\n  tags: [\"Builds\"],\n  summary: \"Record the dependency packages each story uses\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}/usage\",\n  request: {\n    params: z.object({ slug: z.string(), buildId: z.string() }),\n    body: { content: { \"application/json\": { schema: usagePayloadSchema } } },\n  },\n  responses: {\n    200: {\n      content: { \"application/json\": { schema: z.object({ stored: z.number() }) } },\n      description: \"Usage recorded (replaces any earlier report for the build)\",\n    },\n    ...badRequest,\n    ...forbiddenResponse,\n    ...notFoundResponse,\n  },\n});\n\nconst getBuildRoute = createRoute({\n  method: \"get\",\n  tags: [\"Builds\"],\n  summary: \"Get a build\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}\",\n  request: { params: z.object({ slug: z.string(), buildId: z.string() }) },\n  responses: {\n    200: { content: { \"application/json\": { schema: buildSchema } }, description: \"Fetch a build\" },\n    ...notFoundResponse,\n    ...unauthorized,\n  },\n});\n\nconst retryBuildRoute = createRoute({\n  method: \"post\",\n  tags: [\"Builds\"],\n  summary: \"Retry capture\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}/retry\",\n  request: { params: z.object({ slug: z.string(), buildId: z.string() }) },\n  responses: {\n    202: {\n      content: { \"application/json\": { schema: buildSchema } },\n      description: \"Build reset to pending and capture re-queued (new attempt)\",\n    },\n    ...notFoundResponse,\n  },\n});\n\nconst deleteBuildRoute = createRoute({\n  method: \"delete\",\n  tags: [\"Builds\"],\n  summary: \"Delete a build\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}\",\n  request: { params: z.object({ slug: z.string(), buildId: z.string() }) },\n  responses: {\n    204: { description: \"Build deleted\" },\n    ...notFoundResponse,\n  },\n});\n"],"mappings":"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"}

package/dist/routers/capture-config.mjs

@@ -0,0 +1,35 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { modeSlug } from "@storyshelf/core/capture";
+import { HTTPException } from "hono/http-exception";
+//#region src/routers/capture-config.ts
+/** Translating the capture settings (browsers, mode allowlist) into stored project columns. */
+/**
+* Translate the array fields into the stored JSON columns and keep the legacy
+* `browser` column equal to the primary engine. Other fields pass through.
+*/
+function toProjectPatch(body) {
+	const { browsers, modesAllowlist, ...rest } = body;
+	const patch = { ...rest };
+	if (browsers !== void 0) {
+		const unique = browsers === null ? null : [...new Set(browsers)];
+		patch["browsers"] = unique ? JSON.stringify(unique) : null;
+		if (unique?.[0]) patch["browser"] = unique[0];
+	} else if (rest.browser !== void 0) patch["browsers"] = null;
+	if (modesAllowlist !== void 0) patch["modesAllowlist"] = modesAllowlist ? JSON.stringify(assertModeNames(modesAllowlist)) : null;
+	return patch;
+}
+/** 400 for a mode name that cannot form a baseline key; returns the deduped list. */
+function assertModeNames(names) {
+	for (const name of names) try {
+		modeSlug(name);
+	} catch {
+		throw new HTTPException(400, { message: `Invalid mode name "${name}"` });
+	}
+	return [...new Set(names)];
+}
+//#endregion
+export { assertModeNames, toProjectPatch };
+
+//# sourceMappingURL=capture-config.mjs.map

package/dist/routers/capture-config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-config.mjs","names":[],"sources":["../../src/routers/capture-config.ts"],"sourcesContent":["/** Translating the capture settings (browsers, mode allowlist) into stored project columns. */\nimport { modeSlug } from \"@storyshelf/core/capture\";\nimport { HTTPException } from \"hono/http-exception\";\n\n/** The capture-related fields of a project update (API body or settings form). */\nexport interface CaptureConfigInput {\n  browser?: string | undefined;\n  browsers?: string[] | null | undefined;\n  modesAllowlist?: string[] | null | undefined;\n}\n\n/**\n * Translate the array fields into the stored JSON columns and keep the legacy\n * `browser` column equal to the primary engine. Other fields pass through.\n */\nexport function toProjectPatch(\n  body: CaptureConfigInput & Record<string, unknown>,\n): Record<string, unknown> {\n  const { browsers, modesAllowlist, ...rest } = body;\n  const patch: Record<string, unknown> = { ...rest };\n  if (browsers !== undefined) {\n    const unique = browsers === null ? null : [...new Set(browsers)];\n    patch[\"browsers\"] = unique ? JSON.stringify(unique) : null;\n    if (unique?.[0]) patch[\"browser\"] = unique[0];\n  } else if (rest.browser !== undefined) {\n    patch[\"browsers\"] = null;\n  }\n  if (modesAllowlist !== undefined) {\n    patch[\"modesAllowlist\"] = modesAllowlist\n      ? JSON.stringify(assertModeNames(modesAllowlist))\n      : null;\n  }\n  return patch;\n}\n\n/** 400 for a mode name that cannot form a baseline key; returns the deduped list. */\nexport function assertModeNames(names: string[]): string[] {\n  for (const name of names) {\n    try {\n      modeSlug(name);\n    } catch {\n      throw new HTTPException(400, { message: `Invalid mode name \"${name}\"` });\n    }\n  }\n  return [...new Set(names)];\n}\n"],"mappings":";;;;;;;;;;;AAeA,SAAgB,eACd,MACyB;CACzB,MAAM,EAAE,UAAU,gBAAgB,GAAG,SAAS;CAC9C,MAAM,QAAiC,EAAE,GAAG,KAAK;CACjD,IAAI,aAAa,KAAA,GAAW;EAC1B,MAAM,SAAS,aAAa,OAAO,OAAO,CAAC,GAAG,IAAI,IAAI,QAAQ,CAAC;EAC/D,MAAM,cAAc,SAAS,KAAK,UAAU,MAAM,IAAI;EACtD,IAAI,SAAS,IAAI,MAAM,aAAa,OAAO;CAC7C,OAAO,IAAI,KAAK,YAAY,KAAA,GAC1B,MAAM,cAAc;CAEtB,IAAI,mBAAmB,KAAA,GACrB,MAAM,oBAAoB,iBACtB,KAAK,UAAU,gBAAgB,cAAc,CAAC,IAC9C;CAEN,OAAO;AACT;;AAGA,SAAgB,gBAAgB,OAA2B;CACzD,KAAK,MAAM,QAAQ,OACjB,IAAI;EACF,SAAS,IAAI;CACf,QAAQ;EACN,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,sBAAsB,KAAK,GAAG,CAAC;CACzE;CAEF,OAAO,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC;AAC3B"}

package/dist/routers/comments.mjs

@@ -3,13 +3,15 @@ import "node:url";
 import.meta.url;
 import { getStore } from "../store.mjs";
 import { notifyProject } from "../notify.mjs";
+import { REVIEW_EVENTS, announceReview } from "../review-events.mjs";
+import { notFound, resolveAuthorizedProject } from "./helpers.mjs";
 import { hxRefresh } from "./htmx.mjs";
 import { flashHx } from "./flash.mjs";
-import { notFound, resolveAuthorizedProject } from "./helpers.mjs";
 import { commentCreateSchema, commentSchema, notFound as notFound$1, unauthorized } from "./schemas.mjs";
 import { DEVELOPER_ROLES, VIEW_ROLES, buildForProject } from "./builds.handlers.mjs";
 import { createRoute, z } from "@hono/zod-openapi";
 import { CommentModel } from "@storyshelf/core/models";
+import { HTTPException } from "hono/http-exception";
 //#region src/routers/comments.ts
 const listCommentsRoute = createRoute({
 	method: "get",
@@ -78,16 +80,7 @@ function registerComments(app) {
 	app.openapi(createCommentRoute, async (c) => {
 		const { slug, buildId } = c.req.valid("param");
 		const project = await resolveAuthorizedProject(c, slug, ...DEVELOPER_ROLES);
-		const build = await buildForProject(project.id, buildId);
-		const body = c.req.valid("json");
-		const userId = getStore().user?.id ?? null;
-		const comment = await new CommentModel(getStore().db).create(project.id, build.id, userId, body);
-		await notifyProject(project, "comment:created", {
-			buildId: build.id,
-			commentId: comment.id,
-			snapshotId: comment.snapshotId,
-			body: comment.body.slice(0, 500)
-		}, `/builds/${build.id}`);
+		const comment = await createComment(project, (await buildForProject(project.id, buildId)).id, c.req.valid("json"));
 		hxRefresh(c);
 		flashHx(c, "Comment added");
 		return c.json(comment, 201);
@@ -95,15 +88,48 @@ function registerComments(app) {
 	app.openapi(resolveCommentRoute, async (c) => {
 		const { slug, buildId, commentId } = c.req.valid("param");
 		const project = await resolveAuthorizedProject(c, slug, ...DEVELOPER_ROLES);
-		const build = await buildForProject(project.id, buildId);
-		const comment = await new CommentModel(getStore().db).resolve(commentId);
-		if (comment.buildId !== build.id) notFound("Comment not found");
+		const comment = await resolveBuildComment((await buildForProject(project.id, buildId)).id, commentId);
 		hxRefresh(c);
 		flashHx(c, "Comment resolved");
 		return c.json(comment);
 	});
 }
+/** Mark a comment of `buildId` resolved; 404 for a comment of another build. */
+async function resolveBuildComment(buildId, commentId) {
+	const comments = new CommentModel(getStore().db);
+	if (!(await comments.listByBuild(buildId)).find((item) => item.id === commentId)) notFound("Comment not found");
+	return await comments.resolve(commentId);
+}
+/** A comment anchors to the build, a story or a snapshot (ADR 0013, decision 2), never two. */
+function assertOneAnchor(body) {
+	if (body.snapshotId !== void 0 && body.storyId !== void 0) throw new HTTPException(400, { message: "A comment anchors to the build, a story or a snapshot, not several" });
+}
+/**
+* Snapshot comments keep `comment:created`; build and story comments, the review ones, raise
+* `review:comment` (webhook and notifications, ADR 0013, decision 10). One event per comment.
+*/
+async function announceComment(project, buildId, comment) {
+	const data = {
+		buildId,
+		commentId: comment.id,
+		snapshotId: comment.snapshotId,
+		storyId: comment.storyId,
+		body: comment.body.slice(0, 500)
+	};
+	if (comment.snapshotId === null) {
+		await announceReview(project, REVIEW_EVENTS.comment, data, buildId);
+		return;
+	}
+	await notifyProject(project, "comment:created", data, `/builds/${buildId}`);
+}
+async function createComment(project, buildId, body) {
+	assertOneAnchor(body);
+	const userId = getStore().user?.id ?? null;
+	const comment = await new CommentModel(getStore().db).create(project.id, buildId, userId, body);
+	await announceComment(project, buildId, comment);
+	return comment;
+}
 //#endregion
-export { registerComments };
+export { createComment, registerComments, resolveBuildComment };
 
 //# sourceMappingURL=comments.mjs.map

package/dist/routers/comments.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"comments.mjs","names":["notFound"],"sources":["../../src/routers/comments.ts"],"sourcesContent":["import { createRoute, z } from \"@hono/zod-openapi\";\nimport { CommentModel } from \"@storyshelf/core/models\";\nimport type { ShelfRouter } from \"../app-types.ts\";\nimport { notifyProject } from \"../notify.ts\";\nimport { getStore } from \"../store.ts\";\nimport { VIEW_ROLES, DEVELOPER_ROLES, buildForProject } from \"./builds.handlers.ts\";\nimport { flashHx } from \"./flash.ts\";\nimport { resolveAuthorizedProject, notFound as throwNotFound } from \"./helpers.ts\";\nimport { hxRefresh } from \"./htmx.ts\";\nimport { commentSchema, commentCreateSchema, notFound, unauthorized } from \"./schemas.ts\";\nconst listCommentsRoute = createRoute({\n  method: \"get\",\n  tags: [\"Review\"],\n  summary: \"List comments\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}/comments\",\n  request: { params: z.object({ slug: z.string(), buildId: z.string() }) },\n  responses: {\n    200: {\n      content: { \"application/json\": { schema: commentSchema.array() } },\n      description: \"List comments on a build\",\n    },\n    ...notFound,\n    ...unauthorized,\n  },\n});\n\nconst createCommentRoute = createRoute({\n  method: \"post\",\n  tags: [\"Review\"],\n  summary: \"Add a comment\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}/comments\",\n  request: {\n    params: z.object({ slug: z.string(), buildId: z.string() }),\n    body: { content: { \"application/json\": { schema: commentCreateSchema } } },\n  },\n  responses: {\n    201: {\n      content: { \"application/json\": { schema: commentSchema } },\n      description: \"Comment created\",\n    },\n    ...notFound,\n  },\n});\n\nconst resolveCommentRoute = createRoute({\n  method: \"post\",\n  tags: [\"Review\"],\n  summary: \"Resolve a comment\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}/comments/{commentId}/resolve\",\n  request: { params: z.object({ slug: z.string(), buildId: z.string(), commentId: z.string() }) },\n  responses: {\n    200: {\n      content: { \"application/json\": { schema: commentSchema } },\n      description: \"Comment resolved\",\n    },\n    ...notFound,\n  },\n});\n\n/** Register the build comment list, create, and resolve endpoints. */\nexport function registerComments(app: ShelfRouter): void {\n  app.openapi(listCommentsRoute, async (c) => {\n    const { slug, buildId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...VIEW_ROLES);\n    const build = await buildForProject(project.id, buildId);\n    return c.json(await new CommentModel(getStore().db).listByBuild(build.id));\n  });\n\n  app.openapi(createCommentRoute, async (c) => {\n    const { slug, buildId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...DEVELOPER_ROLES);\n    const build = await buildForProject(project.id, buildId);\n    const body = c.req.valid(\"json\");\n    const userId = getStore().user?.id ?? null;\n    const comment = await new CommentModel(getStore().db).create(\n      project.id,\n      build.id,\n      userId,\n      body,\n    );\n    await notifyProject(\n      project,\n      \"comment:created\",\n      {\n        buildId: build.id,\n        commentId: comment.id,\n        snapshotId: comment.snapshotId,\n        body: comment.body.slice(0, 500),\n      },\n      `/builds/${build.id}`,\n    );\n    hxRefresh(c);\n    flashHx(c, \"Comment added\");\n    return c.json(comment, 201);\n  });\n\n  app.openapi(resolveCommentRoute, async (c) => {\n    const { slug, buildId, commentId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...DEVELOPER_ROLES);\n    const build = await buildForProject(project.id, buildId);\n    const comment = await new CommentModel(getStore().db).resolve(commentId);\n    if (comment.buildId !== build.id) {\n      throwNotFound(\"Comment not found\");\n    }\n    hxRefresh(c);\n    flashHx(c, \"Comment resolved\");\n    return c.json(comment);\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"comments.mjs","names":["notFound"],"sources":["../../src/routers/comments.ts"],"sourcesContent":["import { createRoute, z } from \"@hono/zod-openapi\";\nimport { CommentModel, type CommentCreateInput } from \"@storyshelf/core/models\";\nimport type { Comment, Project } from \"@storyshelf/core/schema\";\nimport { HTTPException } from \"hono/http-exception\";\nimport type { ShelfRouter } from \"../app-types.ts\";\nimport { notifyProject } from \"../notify.ts\";\nimport { REVIEW_EVENTS, announceReview } from \"../review-events.ts\";\nimport { getStore } from \"../store.ts\";\nimport { VIEW_ROLES, DEVELOPER_ROLES, buildForProject } from \"./builds.handlers.ts\";\nimport { flashHx } from \"./flash.ts\";\nimport { resolveAuthorizedProject, notFound as throwNotFound } from \"./helpers.ts\";\nimport { hxRefresh } from \"./htmx.ts\";\nimport { commentSchema, commentCreateSchema, notFound, unauthorized } from \"./schemas.ts\";\nconst listCommentsRoute = createRoute({\n  method: \"get\",\n  tags: [\"Review\"],\n  summary: \"List comments\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}/comments\",\n  request: { params: z.object({ slug: z.string(), buildId: z.string() }) },\n  responses: {\n    200: {\n      content: { \"application/json\": { schema: commentSchema.array() } },\n      description: \"List comments on a build\",\n    },\n    ...notFound,\n    ...unauthorized,\n  },\n});\n\nconst createCommentRoute = createRoute({\n  method: \"post\",\n  tags: [\"Review\"],\n  summary: \"Add a comment\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}/comments\",\n  request: {\n    params: z.object({ slug: z.string(), buildId: z.string() }),\n    body: { content: { \"application/json\": { schema: commentCreateSchema } } },\n  },\n  responses: {\n    201: {\n      content: { \"application/json\": { schema: commentSchema } },\n      description: \"Comment created\",\n    },\n    ...notFound,\n  },\n});\n\nconst resolveCommentRoute = createRoute({\n  method: \"post\",\n  tags: [\"Review\"],\n  summary: \"Resolve a comment\",\n  path: \"/api/v1/projects/{slug}/builds/{buildId}/comments/{commentId}/resolve\",\n  request: { params: z.object({ slug: z.string(), buildId: z.string(), commentId: z.string() }) },\n  responses: {\n    200: {\n      content: { \"application/json\": { schema: commentSchema } },\n      description: \"Comment resolved\",\n    },\n    ...notFound,\n  },\n});\n\n/** Register the build comment list, create, and resolve endpoints. */\nexport function registerComments(app: ShelfRouter): void {\n  app.openapi(listCommentsRoute, async (c) => {\n    const { slug, buildId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...VIEW_ROLES);\n    const build = await buildForProject(project.id, buildId);\n    return c.json(await new CommentModel(getStore().db).listByBuild(build.id));\n  });\n\n  app.openapi(createCommentRoute, async (c) => {\n    const { slug, buildId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...DEVELOPER_ROLES);\n    const build = await buildForProject(project.id, buildId);\n    const comment = await createComment(project, build.id, c.req.valid(\"json\"));\n    hxRefresh(c);\n    flashHx(c, \"Comment added\");\n    return c.json(comment, 201);\n  });\n\n  app.openapi(resolveCommentRoute, async (c) => {\n    const { slug, buildId, commentId } = c.req.valid(\"param\");\n    const project = await resolveAuthorizedProject(c, slug, ...DEVELOPER_ROLES);\n    const build = await buildForProject(project.id, buildId);\n    const comment = await resolveBuildComment(build.id, commentId);\n    hxRefresh(c);\n    flashHx(c, \"Comment resolved\");\n    return c.json(comment);\n  });\n}\n\n/** Mark a comment of `buildId` resolved; 404 for a comment of another build. */\nexport async function resolveBuildComment(buildId: string, commentId: string): Promise<Comment> {\n  const comments = new CommentModel(getStore().db);\n  const found = (await comments.listByBuild(buildId)).find((item) => item.id === commentId);\n  if (!found) {\n    throwNotFound(\"Comment not found\");\n  }\n  return await comments.resolve(commentId);\n}\n\n/** A comment anchors to the build, a story or a snapshot (ADR 0013, decision 2), never two. */\nfunction assertOneAnchor(body: {\n  snapshotId?: string | undefined;\n  storyId?: string | undefined;\n}): void {\n  if (body.snapshotId !== undefined && body.storyId !== undefined) {\n    throw new HTTPException(400, {\n      message: \"A comment anchors to the build, a story or a snapshot, not several\",\n    });\n  }\n}\n\n/**\n * Snapshot comments keep `comment:created`; build and story comments, the review ones, raise\n * `review:comment` (webhook and notifications, ADR 0013, decision 10). One event per comment.\n */\nasync function announceComment(project: Project, buildId: string, comment: Comment): Promise<void> {\n  const data = {\n    buildId,\n    commentId: comment.id,\n    snapshotId: comment.snapshotId,\n    storyId: comment.storyId,\n    body: comment.body.slice(0, 500),\n  };\n  if (comment.snapshotId === null) {\n    await announceReview(project, REVIEW_EVENTS.comment, data, buildId);\n    return;\n  }\n  await notifyProject(project, \"comment:created\", data, `/builds/${buildId}`);\n}\n\nexport async function createComment(\n  project: Project,\n  buildId: string,\n  body: CommentCreateInput,\n): Promise<Comment> {\n  assertOneAnchor(body);\n  const userId = getStore().user?.id ?? null;\n  const comment = await new CommentModel(getStore().db).create(project.id, buildId, userId, body);\n  await announceComment(project, buildId, comment);\n  return comment;\n}\n"],"mappings":"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"}

package/dist/routers/component-catalog.handlers.mjs

@@ -0,0 +1,71 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { catalogOf, getStore } from "../store.mjs";
+import { catalogPresence, componentBuildHistory, diffEntries } from "@storyshelf/core/capture";
+import { BuildComponentModel, BuildModel } from "@storyshelf/core/models";
+//#region src/routers/component-catalog.handlers.ts
+/** Newest builds a component's history lists. */
+const HISTORY_LIMIT = 50;
+/** Changed rows whose added/removed/renamed counts are worked out (each loads two catalogs). */
+const DETAIL_LIMIT = 10;
+/** Newest build on the default branch, else the newest at all; the library's own choice. */
+async function latestProjectBuild(project) {
+	const builds = new BuildModel(getStore().db);
+	return (await builds.list(project.id, {
+		branch: project.gitDefaultBranch,
+		limit: 1
+	}))[0] ?? (await builds.list(project.id, { limit: 1 }))[0];
+}
+/**
+* The catalog view of a story file, or null when no published build holds it. The latest build is
+* catalogued first (lazily, when it predates the catalog) so presence can be told.
+*/
+async function loadCatalogView(project, importPath) {
+	const latest = await latestProjectBuild(project);
+	const latestRows = latest ? await catalogueLatest(project, latest) : [];
+	const rows = await new BuildComponentModel(getStore().db).listByImportPath(project.id, importPath);
+	const history = componentBuildHistory(rows, await buildsOf(rows)).slice(0, HISTORY_LIMIT);
+	const shown = history.find((entry) => entry.build.gitBranch === project.gitDefaultBranch) ?? history[0];
+	if (!shown) return null;
+	return {
+		build: shown.build,
+		title: shown.component.title,
+		entries: await entriesOf(project.id, shown.build.id, importPath),
+		history: await withChanges(project.id, importPath, history),
+		presence: catalogPresence(history, importPath, latestRows.length > 0 ? latestRows : null)
+	};
+}
+/** Catalogue the latest build when it has no catalog yet; its component rows. */
+async function catalogueLatest(project, latest) {
+	await catalogOf().load(project.id, latest.id).catch(() => null);
+	return await new BuildComponentModel(getStore().db).listByBuild(latest.id);
+}
+async function buildsOf(rows) {
+	const model = new BuildModel(getStore().db);
+	return (await Promise.all([...new Set(rows.map((row) => row.buildId))].map(async (id) => await model.get(id)))).filter((build) => build !== null);
+}
+/** A file's entries in one build's catalog; empty when the catalog cannot be read. */
+async function entriesOf(projectId, buildId, importPath) {
+	return ((await catalogOf().load(projectId, buildId).catch(() => null))?.entries ?? []).filter((entry) => entry.importPath === importPath);
+}
+/** Add added/removed/renamed counts to the newest changed rows. */
+async function withChanges(projectId, importPath, history) {
+	let budget = DETAIL_LIMIT;
+	return await Promise.all(history.map(async (row) => {
+		if (row.change !== "changed" || !row.previous || budget <= 0) return {
+			...row,
+			changes: null
+		};
+		budget -= 1;
+		const [before, after] = await Promise.all([entriesOf(projectId, row.previous.buildId, importPath), entriesOf(projectId, row.build.id, importPath)]);
+		return {
+			...row,
+			changes: diffEntries(before, after)
+		};
+	}));
+}
+//#endregion
+export { latestProjectBuild, loadCatalogView };
+
+//# sourceMappingURL=component-catalog.handlers.mjs.map

package/dist/routers/component-catalog.handlers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-catalog.handlers.mjs","names":[],"sources":["../../src/routers/component-catalog.handlers.ts"],"sourcesContent":["import {\n  catalogPresence,\n  componentBuildHistory,\n  diffEntries,\n  type CatalogEntry,\n  type ComponentBuildRow,\n  type EntryChanges,\n} from \"@storyshelf/core/capture\";\nimport { BuildComponentModel, BuildModel } from \"@storyshelf/core/models\";\nimport type { ComponentPresence } from \"@storyshelf/core/models\";\nimport type { Build, BuildComponent, Project } from \"@storyshelf/core/schema\";\nimport { catalogOf, getStore } from \"../store.ts\";\n\n/** Newest builds a component's history lists. */\nconst HISTORY_LIMIT = 50;\n\n/** Changed rows whose added/removed/renamed counts are worked out (each loads two catalogs). */\nconst DETAIL_LIMIT = 10;\n\n/** A build of the component's history, with what changed in its stories when known. */\nexport interface CatalogHistoryRow extends ComponentBuildRow {\n  changes: EntryChanges | null;\n}\n\n/** What the catalog knows of a component (ADR 0006, decision 9); the same with `testing` on or off. */\nexport interface ComponentCatalogView {\n  /** The build the Stories tab shows: newest on the default branch holding the file, else newest. */\n  build: Build;\n  title: string;\n  /** The file's stories and docs entries in that build. */\n  entries: CatalogEntry[];\n  history: CatalogHistoryRow[];\n  presence: ComponentPresence;\n}\n\n/** Newest build on the default branch, else the newest at all; the library's own choice. */\nexport async function latestProjectBuild(project: Project): Promise<Build | undefined> {\n  const builds = new BuildModel(getStore().db);\n  return (\n    (await builds.list(project.id, { branch: project.gitDefaultBranch, limit: 1 }))[0] ??\n    (await builds.list(project.id, { limit: 1 }))[0]\n  );\n}\n\n/**\n * The catalog view of a story file, or null when no published build holds it. The latest build is\n * catalogued first (lazily, when it predates the catalog) so presence can be told.\n */\nexport async function loadCatalogView(\n  project: Project,\n  importPath: string,\n): Promise<ComponentCatalogView | null> {\n  const latest = await latestProjectBuild(project);\n  const latestRows = latest ? await catalogueLatest(project, latest) : [];\n  const rows = await new BuildComponentModel(getStore().db).listByImportPath(\n    project.id,\n    importPath,\n  );\n  const history = componentBuildHistory(rows, await buildsOf(rows)).slice(0, HISTORY_LIMIT);\n  const shown =\n    history.find((entry) => entry.build.gitBranch === project.gitDefaultBranch) ?? history[0];\n  if (!shown) {\n    return null;\n  }\n  return {\n    build: shown.build,\n    title: shown.component.title,\n    entries: await entriesOf(project.id, shown.build.id, importPath),\n    history: await withChanges(project.id, importPath, history),\n    presence: catalogPresence(history, importPath, latestRows.length > 0 ? latestRows : null),\n  };\n}\n\n/** Catalogue the latest build when it has no catalog yet; its component rows. */\nasync function catalogueLatest(project: Project, latest: Build): Promise<BuildComponent[]> {\n  await catalogOf()\n    .load(project.id, latest.id)\n    .catch(() => null);\n  return await new BuildComponentModel(getStore().db).listByBuild(latest.id);\n}\n\nasync function buildsOf(rows: readonly BuildComponent[]): Promise<Build[]> {\n  const model = new BuildModel(getStore().db);\n  const found = await Promise.all(\n    [...new Set(rows.map((row) => row.buildId))].map(async (id) => await model.get(id)),\n  );\n  return found.filter((build): build is Build => build !== null);\n}\n\n/** A file's entries in one build's catalog; empty when the catalog cannot be read. */\nasync function entriesOf(\n  projectId: string,\n  buildId: string,\n  importPath: string,\n): Promise<CatalogEntry[]> {\n  const catalog = await catalogOf()\n    .load(projectId, buildId)\n    .catch(() => null);\n  return (catalog?.entries ?? []).filter((entry) => entry.importPath === importPath);\n}\n\n/** Add added/removed/renamed counts to the newest changed rows. */\nasync function withChanges(\n  projectId: string,\n  importPath: string,\n  history: readonly ComponentBuildRow[],\n): Promise<CatalogHistoryRow[]> {\n  let budget = DETAIL_LIMIT;\n  return await Promise.all(\n    history.map(async (row): Promise<CatalogHistoryRow> => {\n      if (row.change !== \"changed\" || !row.previous || budget <= 0) {\n        return { ...row, changes: null };\n      }\n      budget -= 1;\n      const [before, after] = await Promise.all([\n        entriesOf(projectId, row.previous.buildId, importPath),\n        entriesOf(projectId, row.build.id, importPath),\n      ]);\n      return { ...row, changes: diffEntries(before, after) };\n    }),\n  );\n}\n"],"mappings":";;;;;;;;AAcA,MAAM,gBAAgB;;AAGtB,MAAM,eAAe;;AAmBrB,eAAsB,mBAAmB,SAA8C;CACrF,MAAM,SAAS,IAAI,WAAW,SAAS,CAAC,CAAC,EAAE;CAC3C,QACG,MAAM,OAAO,KAAK,QAAQ,IAAI;EAAE,QAAQ,QAAQ;EAAkB,OAAO;CAAE,CAAC,EAAA,CAAG,OAC/E,MAAM,OAAO,KAAK,QAAQ,IAAI,EAAE,OAAO,EAAE,CAAC,EAAA,CAAG;AAElD;;;;;AAMA,eAAsB,gBACpB,SACA,YACsC;CACtC,MAAM,SAAS,MAAM,mBAAmB,OAAO;CAC/C,MAAM,aAAa,SAAS,MAAM,gBAAgB,SAAS,MAAM,IAAI,CAAC;CACtE,MAAM,OAAO,MAAM,IAAI,oBAAoB,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,iBACxD,QAAQ,IACR,UACF;CACA,MAAM,UAAU,sBAAsB,MAAM,MAAM,SAAS,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,aAAa;CACxF,MAAM,QACJ,QAAQ,MAAM,UAAU,MAAM,MAAM,cAAc,QAAQ,gBAAgB,KAAK,QAAQ;CACzF,IAAI,CAAC,OACH,OAAO;CAET,OAAO;EACL,OAAO,MAAM;EACb,OAAO,MAAM,UAAU;EACvB,SAAS,MAAM,UAAU,QAAQ,IAAI,MAAM,MAAM,IAAI,UAAU;EAC/D,SAAS,MAAM,YAAY,QAAQ,IAAI,YAAY,OAAO;EAC1D,UAAU,gBAAgB,SAAS,YAAY,WAAW,SAAS,IAAI,aAAa,IAAI;CAC1F;AACF;;AAGA,eAAe,gBAAgB,SAAkB,QAA0C;CACzF,MAAM,UAAU,CAAC,CACd,KAAK,QAAQ,IAAI,OAAO,EAAE,CAAC,CAC3B,YAAY,IAAI;CACnB,OAAO,MAAM,IAAI,oBAAoB,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,YAAY,OAAO,EAAE;AAC3E;AAEA,eAAe,SAAS,MAAmD;CACzE,MAAM,QAAQ,IAAI,WAAW,SAAS,CAAC,CAAC,EAAE;CAI1C,QAAO,MAHa,QAAQ,IAC1B,CAAC,GAAG,IAAI,IAAI,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,OAAO,MAAM,MAAM,IAAI,EAAE,CAAC,CACpF,EAAA,CACa,QAAQ,UAA0B,UAAU,IAAI;AAC/D;;AAGA,eAAe,UACb,WACA,SACA,YACyB;CAIzB,SAAQ,MAHc,UAAU,CAAC,CAC9B,KAAK,WAAW,OAAO,CAAC,CACxB,YAAY,IAAI,EAAA,EACF,WAAW,CAAC,EAAA,CAAG,QAAQ,UAAU,MAAM,eAAe,UAAU;AACnF;;AAGA,eAAe,YACb,WACA,YACA,SAC8B;CAC9B,IAAI,SAAS;CACb,OAAO,MAAM,QAAQ,IACnB,QAAQ,IAAI,OAAO,QAAoC;EACrD,IAAI,IAAI,WAAW,aAAa,CAAC,IAAI,YAAY,UAAU,GACzD,OAAO;GAAE,GAAG;GAAK,SAAS;EAAK;EAEjC,UAAU;EACV,MAAM,CAAC,QAAQ,SAAS,MAAM,QAAQ,IAAI,CACxC,UAAU,WAAW,IAAI,SAAS,SAAS,UAAU,GACrD,UAAU,WAAW,IAAI,MAAM,IAAI,UAAU,CAC/C,CAAC;EACD,OAAO;GAAE,GAAG;GAAK,SAAS,YAAY,QAAQ,KAAK;EAAE;CACvD,CAAC,CACH;AACF"}

package/dist/routers/component.handlers.mjs

@@ -0,0 +1,121 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { getStore, testingEnabled } from "../store.mjs";
+import { linkedUsageFor } from "./links.handlers.mjs";
+import { previewBaseOf } from "./preview-base.mjs";
+import { designUrlsFor, loadDesignResolutions, loadReviewDesign, returnPathOf } from "./design.handlers.mjs";
+import { loadComponentReview } from "./review-section.handlers.mjs";
+import { groupSnapshots } from "../pages/build-diff-model.mjs";
+import { componentTabs } from "../pages/component-detail.mjs";
+import { entriesFromSnapshots } from "../pages/library-model.mjs";
+import { latestProjectBuild, loadCatalogView } from "./component-catalog.handlers.mjs";
+import { BuildModel, ProjectModel, SnapshotModel, componentHistory, componentPresence, normalizeImportPath } from "@storyshelf/core/models";
+//#region src/routers/component.handlers.ts
+async function buildsOf(snapshots) {
+	const model = new BuildModel(getStore().db);
+	return (await Promise.all([...new Set(snapshots.map((snap) => snap.buildId))].map(async (id) => await model.get(id)))).filter((build) => build !== null);
+}
+/** Design links of a component's first state, with cached metadata and connect offers. */
+async function loadDesignTab(c, project, states) {
+	const [first] = states;
+	if (!first) return [];
+	const urls = designUrlsFor(await loadDesignResolutions(project, states), first);
+	return await loadReviewDesign(project, first, urls, returnPathOf(c)).catch(() => []);
+}
+/** Tab-specific data (design strip or linked packages), loaded only when its tab is open. */
+async function loadTabData(c, data, tab, states) {
+	const [first] = states;
+	if (!first) return {
+		design: [],
+		usage: []
+	};
+	if (tab === "design") return {
+		design: await loadDesignTab(c, data.project, states),
+		usage: []
+	};
+	if (tab === "linked") return {
+		design: [],
+		usage: await linkedUsageFor(c, data.project, data.shownBuild.id, first.storyImportPath).catch(() => [])
+	};
+	return {
+		design: [],
+		usage: []
+	};
+}
+/** History, states and tombstone presence of a story file from its snapshots. */
+async function loadCaptured(project, importPath) {
+	const { db } = getStore();
+	const snapshots = await new SnapshotModel(db).listByImportPath(project.id, importPath);
+	const history = componentHistory(snapshots, await buildsOf(snapshots));
+	const shownBuild = history[0]?.build;
+	if (!shownBuild) return null;
+	const states = snapshots.filter((snap) => snap.buildId === shownBuild.id);
+	const latest = await latestProjectBuild(project);
+	const latestSnapshots = latest ? await new SnapshotModel(db).listByBuild(latest.id) : [];
+	const title = states[0]?.storyTitle ?? importPath;
+	return {
+		states,
+		title,
+		captured: {
+			shownBuild,
+			groups: groupSnapshots(states),
+			history,
+			presence: componentPresence(history, latest?.id ?? null, latestSnapshots, title)
+		}
+	};
+}
+/**
+* Load a component page by story-file path, or null when the project or file is unknown. The
+* catalog gives the page its skeleton in both modes; with `testing`, captured snapshots are layered
+* on. Moved/deleted files still load, carrying a tombstone presence.
+*/
+async function loadComponentPage(c, slug, rawPath, requestedTab, story) {
+	const project = await new ProjectModel(getStore().db).getBySlug(slug);
+	const importPath = normalizeImportPath(rawPath);
+	if (!project || !importPath) return null;
+	const testing = testingEnabled();
+	const [loaded, catalog] = await Promise.all([testing ? loadCaptured(project, importPath) : Promise.resolve(null), loadCatalogView(project, importPath).catch(() => null)]);
+	const view = catalog ?? (loaded ? viewOfCaptured(loaded) : null);
+	if (!view) return null;
+	const tab = resolveTab(requestedTab, testing, loaded !== null);
+	const tabData = loaded ? await loadTabData(c, {
+		project,
+		shownBuild: loaded.captured.shownBuild
+	}, tab, loaded.states) : {
+		design: [],
+		usage: []
+	};
+	return {
+		project,
+		importPath,
+		title: loaded?.title ?? view.title,
+		tab,
+		testing,
+		catalog: view,
+		captured: loaded?.captured ?? null,
+		story,
+		previewBase: await previewBaseOf(project, view.build),
+		publishedBaseDomain: getStore().config.publishedBaseDomain,
+		review: await loadComponentReview(project, view.build),
+		...tabData
+	};
+}
+/** A catalog view for a captured file whose published index is gone: its snapshots stand in. */
+function viewOfCaptured(loaded) {
+	return {
+		build: loaded.captured.shownBuild,
+		title: loaded.title,
+		entries: entriesFromSnapshots(loaded.states),
+		history: [],
+		presence: loaded.captured.presence
+	};
+}
+/** The requested tab when this page offers it; else States once captured, Stories otherwise. */
+function resolveTab(requested, testing, captured) {
+	return componentTabs(testing).find((candidate) => candidate === requested) ?? (testing && captured ? "states" : "stories");
+}
+//#endregion
+export { loadComponentPage };
+
+//# sourceMappingURL=component.handlers.mjs.map

package/dist/routers/component.handlers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.handlers.mjs","names":[],"sources":["../../src/routers/component.handlers.ts"],"sourcesContent":["import {\n  BuildModel,\n  componentHistory,\n  componentPresence,\n  normalizeImportPath,\n  ProjectModel,\n  SnapshotModel,\n} from \"@storyshelf/core/models\";\nimport type { Build, Project, Snapshot } from \"@storyshelf/core/schema\";\nimport type { Context } from \"hono\";\nimport { groupSnapshots } from \"../pages/build-diff-model.ts\";\nimport {\n  componentTabs,\n  type CapturedComponent,\n  type ComponentPageData,\n  type ComponentTab,\n} from \"../pages/component-detail.tsx\";\nimport type { DesignItem } from \"../pages/design-links.tsx\";\nimport { entriesFromSnapshots } from \"../pages/library-model.ts\";\nimport { getStore, testingEnabled } from \"../store.ts\";\nimport {\n  latestProjectBuild,\n  loadCatalogView,\n  type ComponentCatalogView,\n} from \"./component-catalog.handlers.ts\";\nimport {\n  designUrlsFor,\n  loadDesignResolutions,\n  loadReviewDesign,\n  returnPathOf,\n} from \"./design.handlers.ts\";\nimport { linkedUsageFor } from \"./links.handlers.ts\";\nimport { previewBaseOf } from \"./preview-base.ts\";\nimport { loadComponentReview } from \"./review-section.handlers.ts\";\n\nasync function buildsOf(snapshots: readonly Snapshot[]): Promise<Build[]> {\n  const model = new BuildModel(getStore().db);\n  const found = await Promise.all(\n    [...new Set(snapshots.map((snap) => snap.buildId))].map(async (id) => await model.get(id)),\n  );\n  return found.filter((build): build is Build => build !== null);\n}\n\n/** Design links of a component's first state, with cached metadata and connect offers. */\nasync function loadDesignTab(\n  c: Context,\n  project: ComponentPageData[\"project\"],\n  states: Snapshot[],\n): Promise<DesignItem[]> {\n  const [first] = states;\n  if (!first) return [];\n  const urls = designUrlsFor(await loadDesignResolutions(project, states), first);\n  return await loadReviewDesign(project, first, urls, returnPathOf(c)).catch(() => []);\n}\n\n/** Tab-specific data (design strip or linked packages), loaded only when its tab is open. */\nasync function loadTabData(\n  c: Context,\n  data: { project: Project; shownBuild: Build },\n  tab: ComponentTab,\n  states: Snapshot[],\n): Promise<Pick<ComponentPageData, \"design\" | \"usage\">> {\n  const [first] = states;\n  if (!first) return { design: [], usage: [] };\n  if (tab === \"design\") return { design: await loadDesignTab(c, data.project, states), usage: [] };\n  if (tab === \"linked\") {\n    const usage = await linkedUsageFor(\n      c,\n      data.project,\n      data.shownBuild.id,\n      first.storyImportPath,\n    ).catch(() => []);\n    return { design: [], usage };\n  }\n  return { design: [], usage: [] };\n}\n\n/** What a story file's captured snapshots give the page; null when it was never captured. */\ninterface CapturedLoad {\n  captured: CapturedComponent;\n  /** The shown build's snapshots of the file (they drive the Design and Linked tabs). */\n  states: Snapshot[];\n  /** Title of the newest snapshot (retitles update in place). */\n  title: string;\n}\n\n/** History, states and tombstone presence of a story file from its snapshots. */\nasync function loadCaptured(project: Project, importPath: string): Promise<CapturedLoad | null> {\n  const { db } = getStore();\n  const snapshots = await new SnapshotModel(db).listByImportPath(project.id, importPath);\n  const history = componentHistory(snapshots, await buildsOf(snapshots));\n  const shownBuild = history[0]?.build;\n  if (!shownBuild) return null;\n  const states = snapshots.filter((snap) => snap.buildId === shownBuild.id);\n  const latest = await latestProjectBuild(project);\n  const latestSnapshots = latest ? await new SnapshotModel(db).listByBuild(latest.id) : [];\n  const title = states[0]?.storyTitle ?? importPath;\n  return {\n    states,\n    title,\n    captured: {\n      shownBuild,\n      groups: groupSnapshots(states),\n      history,\n      presence: componentPresence(history, latest?.id ?? null, latestSnapshots, title),\n    },\n  };\n}\n\n/**\n * Load a component page by story-file path, or null when the project or file is unknown. The\n * catalog gives the page its skeleton in both modes; with `testing`, captured snapshots are layered\n * on. Moved/deleted files still load, carrying a tombstone presence.\n */\nexport async function loadComponentPage(\n  c: Context,\n  slug: string,\n  rawPath: string,\n  requestedTab: string | undefined,\n  story?: string,\n): Promise<ComponentPageData | null> {\n  const project = await new ProjectModel(getStore().db).getBySlug(slug);\n  const importPath = normalizeImportPath(rawPath);\n  if (!project || !importPath) return null;\n  const testing = testingEnabled();\n  const [loaded, catalog] = await Promise.all([\n    testing ? loadCaptured(project, importPath) : Promise.resolve(null),\n    loadCatalogView(project, importPath).catch(() => null),\n  ]);\n  const view = catalog ?? (loaded ? viewOfCaptured(loaded) : null);\n  if (!view) return null;\n  const tab = resolveTab(requestedTab, testing, loaded !== null);\n  const tabData = loaded\n    ? await loadTabData(c, { project, shownBuild: loaded.captured.shownBuild }, tab, loaded.states)\n    : { design: [], usage: [] };\n  return {\n    project,\n    importPath,\n    title: loaded?.title ?? view.title,\n    tab,\n    testing,\n    catalog: view,\n    captured: loaded?.captured ?? null,\n    story,\n    previewBase: await previewBaseOf(project, view.build),\n    publishedBaseDomain: getStore().config.publishedBaseDomain,\n    review: await loadComponentReview(project, view.build),\n    ...tabData,\n  };\n}\n\n/** A catalog view for a captured file whose published index is gone: its snapshots stand in. */\nfunction viewOfCaptured(loaded: CapturedLoad): ComponentCatalogView {\n  return {\n    build: loaded.captured.shownBuild,\n    title: loaded.title,\n    entries: entriesFromSnapshots(loaded.states),\n    history: [],\n    presence: loaded.captured.presence,\n  };\n}\n\n/** The requested tab when this page offers it; else States once captured, Stories otherwise. */\nfunction resolveTab(\n  requested: string | undefined,\n  testing: boolean,\n  captured: boolean,\n): ComponentTab {\n  const tabs = componentTabs(testing);\n  const found = tabs.find((candidate) => candidate === requested);\n  return found ?? (testing && captured ? \"states\" : \"stories\");\n}\n"],"mappings":"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"}