@storyshelf/app 0.6.2 → 0.7.0

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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"}

package/dist/routers/connections.mjs

@@ -0,0 +1,118 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { getStore } from "../store.mjs";
+import { forbidden, notFound, unauthorized } from "./helpers.mjs";
+import { flash } from "./flash.mjs";
+import { connectionModel, findConnectable } from "../connections.mjs";
+import { safeReturnPath, signState, verifyState } from "./oauth-state.mjs";
+import { deleteCookie, getCookie, setCookie } from "hono/cookie";
+//#region src/routers/connections.ts
+const COOKIE = "storyshelf_oauth_state";
+const COOKIE_PATH = "/connections";
+/**
+* "Connect your account" for any service exposing OAuth (see `connectableServices`):
+* start → consent at the service → callback stores the user's own connection.
+* Services stay unaware of routes, state signing and storage.
+*/
+function registerConnections(app) {
+	app.get("/connections/:service/start", handleStart);
+	app.get("/connections/:service/callback", handleCallback);
+	app.post("/connections/:service/disconnect", handleDisconnect);
+}
+function serviceOf(c) {
+	const service = findConnectable(c.req.param("service") ?? "");
+	if (!service) notFound("Service does not support connecting accounts");
+	return service;
+}
+function sessionUser() {
+	const { user, authEnabled } = getStore();
+	if (!authEnabled) notFound("Connecting accounts requires authentication");
+	if (!user) unauthorized();
+	return user;
+}
+function signingSecret() {
+	const { secret } = getStore().config;
+	if (!secret) notFound("Connecting accounts requires a configured server secret");
+	return secret;
+}
+/**
+* Callback URL of an interactive, request-bound flow (ADR 0007): the confirmed public origin wins,
+* the request's own address is the fallback authentication is allowed.
+*/
+async function redirectUri(c, kind) {
+	const { publicOrigin, config } = getStore();
+	const requestOrigin = new URL(c.req.url).origin;
+	return `${(publicOrigin ? await publicOrigin.authOrigin(requestOrigin) : config.publicBaseUrl ?? requestOrigin).replace(/\/+$/u, "")}/connections/${kind}/callback`;
+}
+async function handleStart(c) {
+	const service = serviceOf(c);
+	const user = sessionUser();
+	const kind = service.metadata.kind;
+	const { state, nonce } = signState(signingSecret(), {
+		userId: user.id,
+		service: kind,
+		returnTo: safeReturnPath(c.req.query("return"), "/")
+	});
+	setCookie(c, COOKIE, nonce, {
+		path: COOKIE_PATH,
+		httpOnly: true,
+		sameSite: "Lax",
+		maxAge: 600,
+		secure: new URL(c.req.url).protocol === "https:"
+	});
+	return c.redirect(service.oauth.authorizeUrl({
+		state,
+		redirectUri: await redirectUri(c, kind)
+	}), 302);
+}
+async function handleCallback(c) {
+	const service = serviceOf(c);
+	const user = sessionUser();
+	const verified = verifiedState(c, service.metadata.kind, user.id);
+	const code = c.req.query("code");
+	if (!code || c.req.query("error")) flash(c, `${service.metadata.name} connection was cancelled`, "warning");
+	else await completeConnect(c, service, user.id, code);
+	return c.redirect(verified.returnTo, 302);
+}
+/** Check the callback's signed state against the service, the signed-in user and this browser's cookie. */
+function verifiedState(c, kind, userId) {
+	const verified = verifyState(signingSecret(), c.req.query("state") ?? "");
+	const nonce = getCookie(c, COOKIE);
+	deleteCookie(c, COOKIE, { path: COOKIE_PATH });
+	if (!verified || verified.service !== kind || verified.userId !== userId) forbidden();
+	if (verified.nonce !== nonce) forbidden();
+	return verified;
+}
+async function completeConnect(c, service, userId, code) {
+	const kind = service.metadata.kind;
+	try {
+		const tokens = await service.oauth.exchangeCode({
+			code,
+			redirectUri: await redirectUri(c, kind)
+		});
+		await connectionModel().connect(userId, kind, tokens);
+		flash(c, `${service.metadata.name} connected`);
+	} catch (error) {
+		getStore().logger.warn({
+			err: error,
+			service: kind
+		}, "oauth connect failed");
+		flash(c, `Could not connect ${service.metadata.name}`, "danger");
+	}
+}
+async function handleDisconnect(c) {
+	const service = serviceOf(c);
+	const user = sessionUser();
+	const form = await c.req.formData();
+	await connectionModel().remove(user.id, service.metadata.kind);
+	flash(c, `${service.metadata.name} disconnected`);
+	return c.redirect(safeReturnPath(formString(form.get("return")), "/"), 303);
+}
+function formString(value) {
+	return typeof value === "string" ? value : "";
+}
+//#endregion
+export { registerConnections };
+
+//# sourceMappingURL=connections.mjs.map

package/dist/routers/connections.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"connections.mjs","names":[],"sources":["../../src/routers/connections.ts"],"sourcesContent":["import type { Context } from \"hono\";\nimport { deleteCookie, getCookie, setCookie } from \"hono/cookie\";\nimport type { ShelfRouter } from \"../app-types.ts\";\nimport { connectionModel, findConnectable, type Connectable } from \"../connections.ts\";\nimport { getStore } from \"../store.ts\";\nimport { flash } from \"./flash.ts\";\nimport { forbidden, notFound, unauthorized } from \"./helpers.ts\";\nimport { safeReturnPath, signState, verifyState, type OAuthState } from \"./oauth-state.ts\";\n\nconst COOKIE = \"storyshelf_oauth_state\";\nconst COOKIE_PATH = \"/connections\";\n\n/**\n * \"Connect your account\" for any service exposing OAuth (see `connectableServices`):\n * start → consent at the service → callback stores the user's own connection.\n * Services stay unaware of routes, state signing and storage.\n */\nexport function registerConnections(app: ShelfRouter): void {\n  app.get(\"/connections/:service/start\", handleStart);\n  app.get(\"/connections/:service/callback\", handleCallback);\n  app.post(\"/connections/:service/disconnect\", handleDisconnect);\n}\n\nfunction serviceOf(c: Context): Connectable {\n  const service = findConnectable(c.req.param(\"service\") ?? \"\");\n  if (!service) notFound(\"Service does not support connecting accounts\");\n  return service;\n}\n\nfunction sessionUser(): { id: string } {\n  const { user, authEnabled } = getStore();\n  if (!authEnabled) notFound(\"Connecting accounts requires authentication\");\n  if (!user) unauthorized();\n  return user;\n}\n\nfunction signingSecret(): string {\n  const { secret } = getStore().config;\n  if (!secret) notFound(\"Connecting accounts requires a configured server secret\");\n  return secret;\n}\n\n/**\n * Callback URL of an interactive, request-bound flow (ADR 0007): the confirmed public origin wins,\n * the request's own address is the fallback authentication is allowed.\n */\nasync function redirectUri(c: Context, kind: string): Promise<string> {\n  const { publicOrigin, config } = getStore();\n  const requestOrigin = new URL(c.req.url).origin;\n  const base = publicOrigin\n    ? await publicOrigin.authOrigin(requestOrigin)\n    : (config.publicBaseUrl ?? requestOrigin);\n  return `${base.replace(/\\/+$/u, \"\")}/connections/${kind}/callback`;\n}\n\nasync function handleStart(c: Context): Promise<Response> {\n  const service = serviceOf(c);\n  const user = sessionUser();\n  const kind = service.metadata.kind;\n  const { state, nonce } = signState(signingSecret(), {\n    userId: user.id,\n    service: kind,\n    returnTo: safeReturnPath(c.req.query(\"return\"), \"/\"),\n  });\n  setCookie(c, COOKIE, nonce, {\n    path: COOKIE_PATH,\n    httpOnly: true,\n    sameSite: \"Lax\",\n    maxAge: 600,\n    secure: new URL(c.req.url).protocol === \"https:\",\n  });\n  return c.redirect(\n    service.oauth.authorizeUrl({ state, redirectUri: await redirectUri(c, kind) }),\n    302,\n  );\n}\n\nasync function handleCallback(c: Context): Promise<Response> {\n  const service = serviceOf(c);\n  const user = sessionUser();\n  const verified = verifiedState(c, service.metadata.kind, user.id);\n  const code = c.req.query(\"code\");\n  if (!code || c.req.query(\"error\")) {\n    flash(c, `${service.metadata.name} connection was cancelled`, \"warning\");\n  } else {\n    await completeConnect(c, service, user.id, code);\n  }\n  return c.redirect(verified.returnTo, 302);\n}\n\n/** Check the callback's signed state against the service, the signed-in user and this browser's cookie. */\nfunction verifiedState(c: Context, kind: string, userId: string): OAuthState {\n  const verified = verifyState(signingSecret(), c.req.query(\"state\") ?? \"\");\n  const nonce = getCookie(c, COOKIE);\n  deleteCookie(c, COOKIE, { path: COOKIE_PATH });\n  if (!verified || verified.service !== kind || verified.userId !== userId) forbidden();\n  if (verified.nonce !== nonce) forbidden();\n  return verified;\n}\n\nasync function completeConnect(\n  c: Context,\n  service: Connectable,\n  userId: string,\n  code: string,\n): Promise<void> {\n  const kind = service.metadata.kind;\n  try {\n    const tokens = await service.oauth.exchangeCode({\n      code,\n      redirectUri: await redirectUri(c, kind),\n    });\n    await connectionModel().connect(userId, kind, tokens);\n    flash(c, `${service.metadata.name} connected`);\n  } catch (error) {\n    getStore().logger.warn({ err: error, service: kind }, \"oauth connect failed\");\n    flash(c, `Could not connect ${service.metadata.name}`, \"danger\");\n  }\n}\n\nasync function handleDisconnect(c: Context): Promise<Response> {\n  const service = serviceOf(c);\n  const user = sessionUser();\n  const form = await c.req.formData();\n  await connectionModel().remove(user.id, service.metadata.kind);\n  flash(c, `${service.metadata.name} disconnected`);\n  return c.redirect(safeReturnPath(formString(form.get(\"return\")), \"/\"), 303);\n}\n\nfunction formString(value: FormDataEntryValue | null): string {\n  return typeof value === \"string\" ? value : \"\";\n}\n"],"mappings":"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"}

package/dist/routers/design-connect.handlers.mjs

@@ -0,0 +1,44 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { credentialKeys } from "../credential-keys.mjs";
+import { getStore } from "../store.mjs";
+import { canConnect, connectionModel } from "../connections.mjs";
+import { DesignCredentialModel } from "@storyshelf/core/models";
+//#region src/routers/design-connect.handlers.ts
+/** The signed-in user whose own connection may serve previews (none when auth is off). */
+function viewerIdOf() {
+	const { user, authEnabled } = getStore();
+	return authEnabled ? user?.id : void 0;
+}
+/**
+* Per provider kind, whether to offer "Connect your account": only when the operator
+* enabled OAuth, the viewer is signed in, and the project has no shared credential.
+*/
+async function loadConnectStates(projectId, kinds, returnTo) {
+	const viewerId = viewerIdOf();
+	if (!viewerId || !canConnect()) return /* @__PURE__ */ new Map();
+	const { db, config, design } = getStore();
+	const credentials = new DesignCredentialModel(db, credentialKeys(config));
+	const candidates = design.filter((p) => p.oauth && kinds.includes(p.metadata.kind));
+	const states = await Promise.all(candidates.map(async (provider) => {
+		const kind = provider.metadata.kind;
+		if (await credentials.info(projectId, kind)) return null;
+		return [kind, connectOffer(kind, await connectionModel().info(viewerId, kind), returnTo)];
+	}));
+	return new Map(states.filter((entry) => entry !== null));
+}
+function connectOffer(kind, row, returnTo) {
+	const base = `/connections/${kind}`;
+	const expired = row?.status === "expired";
+	return {
+		state: row ? expired ? "reconnect" : "connected" : "connect",
+		startUrl: `${base}/start?return=${encodeURIComponent(returnTo)}`,
+		disconnectUrl: `${base}/disconnect`,
+		returnTo
+	};
+}
+//#endregion
+export { loadConnectStates, viewerIdOf };
+
+//# sourceMappingURL=design-connect.handlers.mjs.map

package/dist/routers/design-connect.handlers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-connect.handlers.mjs","names":[],"sources":["../../src/routers/design-connect.handlers.ts"],"sourcesContent":["import { DesignCredentialModel } from \"@storyshelf/core/models\";\nimport type { UserConnection } from \"@storyshelf/core/schema\";\nimport { canConnect, connectionModel } from \"../connections.ts\";\nimport { credentialKeys } from \"../credential-keys.ts\";\nimport type { DesignConnect } from \"../pages/design-links.tsx\";\nimport { getStore } from \"../store.ts\";\n\n/** The signed-in user whose own connection may serve previews (none when auth is off). */\nexport function viewerIdOf(): string | undefined {\n  const { user, authEnabled } = getStore();\n  return authEnabled ? user?.id : undefined;\n}\n\n/**\n * Per provider kind, whether to offer \"Connect your account\": only when the operator\n * enabled OAuth, the viewer is signed in, and the project has no shared credential.\n */\nexport async function loadConnectStates(\n  projectId: string,\n  kinds: readonly string[],\n  returnTo: string,\n): Promise<Map<string, DesignConnect>> {\n  const viewerId = viewerIdOf();\n  if (!viewerId || !canConnect()) return new Map();\n  const { db, config, design } = getStore();\n  const credentials = new DesignCredentialModel(db, credentialKeys(config));\n  const candidates = design.filter((p) => p.oauth && kinds.includes(p.metadata.kind));\n  const states = await Promise.all(\n    candidates.map(async (provider) => {\n      const kind = provider.metadata.kind;\n      const shared = await credentials.info(projectId, kind);\n      if (shared) return null;\n      return [\n        kind,\n        connectOffer(kind, await connectionModel().info(viewerId, kind), returnTo),\n      ] as const;\n    }),\n  );\n  return new Map(states.filter((entry) => entry !== null));\n}\n\nfunction connectOffer(kind: string, row: UserConnection | null, returnTo: string): DesignConnect {\n  const base = `/connections/${kind}`;\n  const expired = row?.status === \"expired\";\n  return {\n    state: row ? (expired ? \"reconnect\" : \"connected\") : \"connect\",\n    startUrl: `${base}/start?return=${encodeURIComponent(returnTo)}`,\n    disconnectUrl: `${base}/disconnect`,\n    returnTo,\n  };\n}\n"],"mappings":";;;;;;;;;AAQA,SAAgB,aAAiC;CAC/C,MAAM,EAAE,MAAM,gBAAgB,SAAS;CACvC,OAAO,cAAc,MAAM,KAAK,KAAA;AAClC;;;;;AAMA,eAAsB,kBACpB,WACA,OACA,UACqC;CACrC,MAAM,WAAW,WAAW;CAC5B,IAAI,CAAC,YAAY,CAAC,WAAW,GAAG,uBAAO,IAAI,IAAI;CAC/C,MAAM,EAAE,IAAI,QAAQ,WAAW,SAAS;CACxC,MAAM,cAAc,IAAI,sBAAsB,IAAI,eAAe,MAAM,CAAC;CACxE,MAAM,aAAa,OAAO,QAAQ,MAAM,EAAE,SAAS,MAAM,SAAS,EAAE,SAAS,IAAI,CAAC;CAClF,MAAM,SAAS,MAAM,QAAQ,IAC3B,WAAW,IAAI,OAAO,aAAa;EACjC,MAAM,OAAO,SAAS,SAAS;EAE/B,IAAI,MADiB,YAAY,KAAK,WAAW,IAAI,GACzC,OAAO;EACnB,OAAO,CACL,MACA,aAAa,MAAM,MAAM,gBAAgB,CAAC,CAAC,KAAK,UAAU,IAAI,GAAG,QAAQ,CAC3E;CACF,CAAC,CACH;CACA,OAAO,IAAI,IAAI,OAAO,QAAQ,UAAU,UAAU,IAAI,CAAC;AACzD;AAEA,SAAS,aAAa,MAAc,KAA4B,UAAiC;CAC/F,MAAM,OAAO,gBAAgB;CAC7B,MAAM,UAAU,KAAK,WAAW;CAChC,OAAO;EACL,OAAO,MAAO,UAAU,cAAc,cAAe;EACrD,UAAU,GAAG,KAAK,gBAAgB,mBAAmB,QAAQ;EAC7D,eAAe,GAAG,KAAK;EACvB;CACF;AACF"}