@storyshelf/app 0.5.3

package/dist/routers/builds.mjs

@@ -0,0 +1,381 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { getStore } from "../store.mjs";
+import { hxRefresh } from "./htmx.mjs";
+import { flashHx } from "./flash.mjs";
+import { resolveAuthorizedProject } from "./helpers.mjs";
+import { badRequest, buildSchema, forbidden, notFound, unauthorized } from "./schemas.mjs";
+import { APPROVER_ROLES, DEVELOPER_ROLES, VIEW_ROLES, buildCreateJsonSchema, buildForProject, buildListQuery, createBuildRecord, persistInlineStatics, storeUploadStream } from "./builds.handlers.mjs";
+import { registerAttempts } from "./attempts.mjs";
+import { registerComments } from "./comments.mjs";
+import { registerSnapshots } from "./snapshots.mjs";
+import { createRoute, z } from "@hono/zod-openapi";
+import { BuildModel } from "@storyshelf/core/models";
+import { storybookZipPath } from "@storyshelf/core/utils";
+import { HTTPException } from "hono/http-exception";
+import { DEFAULT_MAX_UPLOAD_BYTES } from "@storyshelf/core/config";
+//#region src/routers/builds.ts
+async function upsertContentRef(hash) {
+	try {
+		const contentRefs = getStore().db.tables.contentRefs;
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const existing = await getStore().db.get(contentRefs, hash);
+		if (existing) await getStore().db.update(contentRefs, hash, {
+			refCount: existing.refCount + 1,
+			lastSeenAt: now
+		});
+		else await getStore().db.insert(contentRefs, {
+			hash,
+			refCount: 1,
+			lastSeenAt: now,
+			createdAt: now
+		});
+	} catch {}
+}
+/** Register the build list, upload, fetch, retry, and delete endpoints. */
+function registerBuilds(app) {
+	app.openapi(listBuildsRoute, async (c) => {
+		const project = await resolveAuthorizedProject(c, c.req.valid("param").slug, ...VIEW_ROLES);
+		const { status, branch, labelKey, labelValue } = c.req.valid("query");
+		const builds = new BuildModel(getStore().db).list(project.id, {
+			status,
+			branch: branch ?? void 0,
+			labelKey: labelKey ?? void 0,
+			labelValue: labelValue ?? void 0
+		});
+		return c.json(await builds);
+	});
+	app.openapi(createBuildRoute, async (c) => {
+		const project = await resolveAuthorizedProject(c, c.req.valid("param").slug, ...DEVELOPER_ROLES);
+		const parsed = buildCreateJsonSchema.safeParse(await c.req.json());
+		if (!parsed.success) throw new HTTPException(400, { message: parsed.error.message });
+		const build = await createBuildRecord(project, parsed.data);
+		const uploadUrl = `/api/v1/projects/${project.slug}/builds/${build.id}/zip`;
+		return c.json({
+			build,
+			uploadUrl,
+			baselineSha: build.baselineSha
+		}, 202);
+	});
+	app.openapi(affectedRoute, 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 { baselineSha, changedFiles, affectedImportPaths } = c.req.valid("json");
+		const updated = await new BuildModel(getStore().db).setAffected(build.id, {
+			baselineSha,
+			changedFiles,
+			affectedImportPaths
+		});
+		return c.json(updated);
+	});
+	app.openapi(uploadZipRoute, 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 maxBytes = getStore().config.maxUploadBytes ?? DEFAULT_MAX_UPLOAD_BYTES;
+		await storeUploadStream(getStore().storage, storybookZipPath(project.id, build.id), c.req.raw.body, maxBytes);
+		const reqId = c.get("requestId");
+		await getStore().enqueueCapture?.(build.id, reqId);
+		const { storage, config, logger } = getStore();
+		await persistInlineStatics(storage, config.scratchDir, config.maxInlineUnzipSize, c.req.header("content-length"), project.id, build.id, logger);
+		return c.json(build, 202);
+	});
+	app.openapi(dedupRoute, async (c) => {
+		const { slug, buildId } = c.req.valid("param");
+		const project = await resolveAuthorizedProject(c, slug, ...DEVELOPER_ROLES);
+		await buildForProject(project.id, buildId);
+		const { hashes } = c.req.valid("json");
+		const needed = [];
+		for (const hash of hashes) if (!await getStore().storage.exists(`content/${hash}`)) needed.push(hash);
+		return c.json({ needed });
+	});
+	app.openapi(contentUploadRoute, async (c) => {
+		const { slug, buildId } = c.req.valid("param");
+		const project = await resolveAuthorizedProject(c, slug, ...DEVELOPER_ROLES);
+		await buildForProject(project.id, buildId);
+		if ((c.req.header("content-type") ?? "").includes("multipart/")) {
+			const form = await c.req.formData();
+			for (const [key, value] of form.entries()) if (value instanceof File) {
+				const hash = key;
+				const buffer = Buffer.from(await value.arrayBuffer());
+				await getStore().storage.write(`content/${hash}`, buffer);
+				await upsertContentRef(hash);
+			}
+		} else {
+			const hash = c.req.header("x-content-hash") ?? "";
+			if (!hash) throw new HTTPException(400, { message: "Missing X-Content-Hash" });
+			const buffer = Buffer.from(await c.req.arrayBuffer());
+			await getStore().storage.write(`content/${hash}`, buffer);
+		}
+		return c.json({ ok: true });
+	});
+	app.openapi(manifestRoute, 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 { files } = c.req.valid("json");
+		const manifest = {};
+		for (const f of files) manifest[f.rel] = f.hash;
+		await getStore().storage.write(`${project.id}/builds/${build.id}/storybook/manifest.json`, Buffer.from(JSON.stringify(manifest)));
+		for (const f of files) try {
+			const contentRefs = getStore().db.tables.contentRefs;
+			const now = (/* @__PURE__ */ new Date()).toISOString();
+			if (!await getStore().db.get(contentRefs, f.hash)) await getStore().db.insert(contentRefs, {
+				hash: f.hash,
+				refCount: 1,
+				lastSeenAt: now,
+				createdAt: now
+			});
+			else await getStore().db.update(contentRefs, f.hash, { lastSeenAt: now });
+		} catch {}
+		const reqId = c.get("requestId");
+		await getStore().enqueueCapture?.(build.id, reqId);
+		return c.json({ ok: true });
+	});
+	app.openapi(getBuildRoute, async (c) => {
+		const { slug, buildId } = c.req.valid("param");
+		const project = await resolveAuthorizedProject(c, slug, ...VIEW_ROLES);
+		const build = await buildForProject(project.id, buildId);
+		return c.json(build);
+	});
+	app.openapi(retryBuildRoute, 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 updated = await new BuildModel(getStore().db).setStatus(build.id, "pending");
+		await getStore().enqueueCapture?.(build.id, c.get("requestId"));
+		hxRefresh(c);
+		flashHx(c, "Capture queued");
+		return c.json(updated, 202);
+	});
+	app.openapi(deleteBuildRoute, async (c) => {
+		const { slug, buildId } = c.req.valid("param");
+		const project = await resolveAuthorizedProject(c, slug, ...APPROVER_ROLES);
+		const build = await buildForProject(project.id, buildId);
+		await new BuildModel(getStore().db).remove(build.id);
+		return c.body(null, 204);
+	});
+	registerSnapshots(app);
+	registerComments(app);
+	registerAttempts(app);
+}
+const listBuildsRoute = createRoute({
+	method: "get",
+	tags: ["Builds"],
+	summary: "List builds",
+	path: "/api/v1/projects/{slug}/builds",
+	request: {
+		params: z.object({ slug: z.string() }),
+		query: buildListQuery
+	},
+	responses: {
+		200: {
+			content: { "application/json": { schema: buildSchema.array() } },
+			description: "List builds for a project"
+		},
+		...notFound,
+		...unauthorized
+	}
+});
+const buildCreatedSchema = z.object({
+	build: buildSchema,
+	uploadUrl: z.string(),
+	baselineSha: z.string().nullable()
+}).openapi("BuildCreated");
+const createBuildRoute = createRoute({
+	method: "post",
+	tags: ["Builds"],
+	summary: "Create a build",
+	path: "/api/v1/projects/{slug}/builds",
+	request: {
+		params: z.object({ slug: z.string() }),
+		body: { content: { "application/json": { schema: buildCreateJsonSchema } } }
+	},
+	responses: {
+		202: {
+			content: { "application/json": { schema: buildCreatedSchema } },
+			description: "Build created. PUT the Storybook zip to uploadUrl to queue capture."
+		},
+		...badRequest,
+		...forbidden,
+		...notFound
+	}
+});
+const uploadZipRoute = createRoute({
+	method: "put",
+	tags: ["Builds"],
+	summary: "Upload the Storybook zip",
+	path: "/api/v1/projects/{slug}/builds/{buildId}/zip",
+	request: {
+		params: z.object({
+			slug: z.string(),
+			buildId: z.string()
+		}),
+		body: { content: { "application/zip": { schema: z.string().openapi({
+			type: "string",
+			format: "binary"
+		}) } } }
+	},
+	responses: {
+		202: {
+			content: { "application/json": { schema: buildSchema } },
+			description: "Zip stored and capture queued"
+		},
+		413: {
+			content: { "application/json": { schema: z.object({ message: z.string() }).openapi("Error") } },
+			description: "Upload exceeds the configured size limit"
+		},
+		...badRequest,
+		...forbidden,
+		...notFound
+	}
+});
+const dedupHashesSchema = z.object({ hashes: z.array(z.string()) });
+const dedupNeededSchema = z.object({ needed: z.array(z.string()) });
+const dedupRoute = createRoute({
+	method: "post",
+	tags: ["Builds"],
+	summary: "Check which files need uploading",
+	path: "/api/v1/projects/{slug}/builds/{buildId}/dedup",
+	request: {
+		params: z.object({
+			slug: z.string(),
+			buildId: z.string()
+		}),
+		body: { content: { "application/json": { schema: dedupHashesSchema } } }
+	},
+	responses: {
+		200: {
+			content: { "application/json": { schema: dedupNeededSchema } },
+			description: "Hashes needed for upload"
+		},
+		...notFound
+	}
+});
+const contentUploadRoute = createRoute({
+	method: "post",
+	tags: ["Builds"],
+	summary: "Upload build content",
+	path: "/api/v1/projects/{slug}/builds/{buildId}/content",
+	request: {
+		params: z.object({
+			slug: z.string(),
+			buildId: z.string()
+		}),
+		body: { content: { "multipart/form-data": { schema: z.any() } } }
+	},
+	responses: {
+		200: {
+			content: { "application/json": { schema: z.object({ ok: z.boolean() }) } },
+			description: "Content uploaded"
+		},
+		...notFound
+	}
+});
+const manifestFileSchema = z.object({
+	rel: z.string(),
+	hash: z.string(),
+	size: z.number()
+});
+const manifestRoute = createRoute({
+	method: "post",
+	tags: ["Builds"],
+	summary: "Store the build manifest",
+	path: "/api/v1/projects/{slug}/builds/{buildId}/manifest",
+	request: {
+		params: z.object({
+			slug: z.string(),
+			buildId: z.string()
+		}),
+		body: { content: { "application/json": { schema: z.object({ files: z.array(manifestFileSchema) }) } } }
+	},
+	responses: {
+		200: {
+			content: { "application/json": { schema: z.object({ ok: z.boolean() }) } },
+			description: "Manifest stored"
+		},
+		...notFound
+	}
+});
+const affectedPayloadSchema = z.object({
+	baselineSha: z.string().nullable(),
+	changedFiles: z.array(z.string()).max(2e4),
+	affectedImportPaths: z.array(z.string()).max(2e4).nullable()
+});
+const affectedRoute = createRoute({
+	method: "post",
+	tags: ["Builds"],
+	summary: "Record the affected stories",
+	path: "/api/v1/projects/{slug}/builds/{buildId}/affected",
+	request: {
+		params: z.object({
+			slug: z.string(),
+			buildId: z.string()
+		}),
+		body: { content: { "application/json": { schema: affectedPayloadSchema } } }
+	},
+	responses: {
+		200: {
+			content: { "application/json": { schema: buildSchema } },
+			description: "Affected set recorded"
+		},
+		...badRequest,
+		...forbidden,
+		...notFound
+	}
+});
+const getBuildRoute = createRoute({
+	method: "get",
+	tags: ["Builds"],
+	summary: "Get a build",
+	path: "/api/v1/projects/{slug}/builds/{buildId}",
+	request: { params: z.object({
+		slug: z.string(),
+		buildId: z.string()
+	}) },
+	responses: {
+		200: {
+			content: { "application/json": { schema: buildSchema } },
+			description: "Fetch a build"
+		},
+		...notFound,
+		...unauthorized
+	}
+});
+const retryBuildRoute = createRoute({
+	method: "post",
+	tags: ["Builds"],
+	summary: "Retry capture",
+	path: "/api/v1/projects/{slug}/builds/{buildId}/retry",
+	request: { params: z.object({
+		slug: z.string(),
+		buildId: z.string()
+	}) },
+	responses: {
+		202: {
+			content: { "application/json": { schema: buildSchema } },
+			description: "Build reset to pending and capture re-queued (new attempt)"
+		},
+		...notFound
+	}
+});
+const deleteBuildRoute = createRoute({
+	method: "delete",
+	tags: ["Builds"],
+	summary: "Delete a build",
+	path: "/api/v1/projects/{slug}/builds/{buildId}",
+	request: { params: z.object({
+		slug: z.string(),
+		buildId: z.string()
+	}) },
+	responses: {
+		204: { description: "Build deleted" },
+		...notFound
+	}
+});
+//#endregion
+export { registerBuilds };
+
+//# sourceMappingURL=builds.mjs.map

package/dist/routers/builds.mjs.map

@@ -0,0 +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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"}

package/dist/routers/comments.mjs

@@ -0,0 +1,109 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { getStore } from "../store.mjs";
+import { notifyProject } from "../notify.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";
+//#region src/routers/comments.ts
+const listCommentsRoute = createRoute({
+	method: "get",
+	tags: ["Review"],
+	summary: "List comments",
+	path: "/api/v1/projects/{slug}/builds/{buildId}/comments",
+	request: { params: z.object({
+		slug: z.string(),
+		buildId: z.string()
+	}) },
+	responses: {
+		200: {
+			content: { "application/json": { schema: commentSchema.array() } },
+			description: "List comments on a build"
+		},
+		...notFound$1,
+		...unauthorized
+	}
+});
+const createCommentRoute = createRoute({
+	method: "post",
+	tags: ["Review"],
+	summary: "Add a comment",
+	path: "/api/v1/projects/{slug}/builds/{buildId}/comments",
+	request: {
+		params: z.object({
+			slug: z.string(),
+			buildId: z.string()
+		}),
+		body: { content: { "application/json": { schema: commentCreateSchema } } }
+	},
+	responses: {
+		201: {
+			content: { "application/json": { schema: commentSchema } },
+			description: "Comment created"
+		},
+		...notFound$1
+	}
+});
+const resolveCommentRoute = createRoute({
+	method: "post",
+	tags: ["Review"],
+	summary: "Resolve a comment",
+	path: "/api/v1/projects/{slug}/builds/{buildId}/comments/{commentId}/resolve",
+	request: { params: z.object({
+		slug: z.string(),
+		buildId: z.string(),
+		commentId: z.string()
+	}) },
+	responses: {
+		200: {
+			content: { "application/json": { schema: commentSchema } },
+			description: "Comment resolved"
+		},
+		...notFound$1
+	}
+});
+/** Register the build comment list, create, and resolve endpoints. */
+function registerComments(app) {
+	app.openapi(listCommentsRoute, async (c) => {
+		const { slug, buildId } = c.req.valid("param");
+		const project = await resolveAuthorizedProject(c, slug, ...VIEW_ROLES);
+		const build = await buildForProject(project.id, buildId);
+		return c.json(await new CommentModel(getStore().db).listByBuild(build.id));
+	});
+	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}`);
+		hxRefresh(c);
+		flashHx(c, "Comment added");
+		return c.json(comment, 201);
+	});
+	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");
+		hxRefresh(c);
+		flashHx(c, "Comment resolved");
+		return c.json(comment);
+	});
+}
+//#endregion
+export { registerComments };
+
+//# sourceMappingURL=comments.mjs.map

package/dist/routers/comments.mjs.map

@@ -0,0 +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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"}

package/dist/routers/flash.mjs

@@ -0,0 +1,35 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { isHxRequest } from "./htmx.mjs";
+import { setCookie } from "hono/cookie";
+//#region src/routers/flash.ts
+/** Cookie the client script reads, shows as a toast, and clears. */
+const FLASH_COOKIE = "storyshelf_flash";
+const MAX_MESSAGE_LENGTH = 140;
+/**
+* Queue a one-shot toast for the next page the browser renders. The server
+* decides this (only after the action actually succeeded), so it works for
+* HTMX redirects, in-place swaps, and plain form posts alike. The cookie is
+* short-lived and readable by the page script, which shows it with
+* `textContent` and removes it.
+*/
+function flash(c, message, tone = "success") {
+	const text = message.length > MAX_MESSAGE_LENGTH ? `${message.slice(0, 139)}…` : message;
+	setCookie(c, FLASH_COOKIE, JSON.stringify({
+		message: text,
+		tone
+	}), {
+		path: "/",
+		maxAge: 60,
+		sameSite: "Lax"
+	});
+}
+/** Like {@link flash}, but only for HTMX callers (keeps JSON API responses cookie-free). */
+function flashHx(c, message, tone = "success") {
+	if (isHxRequest(c)) flash(c, message, tone);
+}
+//#endregion
+export { FLASH_COOKIE, flash, flashHx };
+
+//# sourceMappingURL=flash.mjs.map

package/dist/routers/flash.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"flash.mjs","names":[],"sources":["../../src/routers/flash.ts"],"sourcesContent":["import type { Context } from \"hono\";\nimport { setCookie } from \"hono/cookie\";\nimport { isHxRequest } from \"./htmx.ts\";\n\n/** Visual tone of a flash message. */\nexport type FlashTone = \"success\" | \"danger\" | \"warning\" | \"info\";\n\n/** Cookie the client script reads, shows as a toast, and clears. */\nexport const FLASH_COOKIE = \"storyshelf_flash\";\n\nconst MAX_MESSAGE_LENGTH = 140;\n\n/**\n * Queue a one-shot toast for the next page the browser renders. The server\n * decides this (only after the action actually succeeded), so it works for\n * HTMX redirects, in-place swaps, and plain form posts alike. The cookie is\n * short-lived and readable by the page script, which shows it with\n * `textContent` and removes it.\n */\nexport function flash(c: Context, message: string, tone: FlashTone = \"success\"): void {\n  const text =\n    message.length > MAX_MESSAGE_LENGTH ? `${message.slice(0, MAX_MESSAGE_LENGTH - 1)}…` : message;\n  setCookie(c, FLASH_COOKIE, JSON.stringify({ message: text, tone }), {\n    path: \"/\",\n    maxAge: 60,\n    sameSite: \"Lax\",\n  });\n}\n\n/** Like {@link flash}, but only for HTMX callers (keeps JSON API responses cookie-free). */\nexport function flashHx(c: Context, message: string, tone: FlashTone = \"success\"): void {\n  if (isHxRequest(c)) {\n    flash(c, message, tone);\n  }\n}\n"],"mappings":";;;;;;;AAQA,MAAa,eAAe;AAE5B,MAAM,qBAAqB;;;;;;;;AAS3B,SAAgB,MAAM,GAAY,SAAiB,OAAkB,WAAiB;CACpF,MAAM,OACJ,QAAQ,SAAS,qBAAqB,GAAG,QAAQ,MAAM,GAAG,GAAsB,EAAE,KAAK;CACzF,UAAU,GAAG,cAAc,KAAK,UAAU;EAAE,SAAS;EAAM;CAAK,CAAC,GAAG;EAClE,MAAM;EACN,QAAQ;EACR,UAAU;CACZ,CAAC;AACH;;AAGA,SAAgB,QAAQ,GAAY,SAAiB,OAAkB,WAAiB;CACtF,IAAI,YAAY,CAAC,GACf,MAAM,GAAG,SAAS,IAAI;AAE1B"}