@storyshelf/core 0.7.0 → 0.9.0-next-d2cc082

package/dist/models/changeset.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { BuildModel } from "./build.mjs";
 import { BuildComponentModel } from "./build-component.mjs";
-//#region src/models/changeset.ts
+// src/models/changeset.ts
 /**
 * Compare a build's components with the baseline's. Components match by story file, or by title
 * when the index carries no file. With no baseline (`null`) every component is `added`.
@@ -75,7 +75,6 @@ function summary(row) {
 function byTitle(a, b) {
 	return a.title.localeCompare(b.title) || a.importPath.localeCompare(b.importPath);
 }
-//#endregion
 export { changesetOf, computeChangeset, findChangesetBaseline };
 
 //# sourceMappingURL=changeset.mjs.map

package/dist/models/columns.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { getTableColumns } from "drizzle-orm";
-//#region src/models/columns.ts
+// src/models/columns.ts
 /**
 * Column handle for query builders (`eq`, `inArray`, `desc`, …) from a table
 * handle and a property name. Throws on an unknown name instead of letting
@@ -13,7 +13,6 @@ function col(table, name) {
 	if (!column) throw new Error(`Unknown column "${name}"`);
 	return column;
 }
-//#endregion
 export { col };
 
 //# sourceMappingURL=columns.mjs.map

package/dist/models/comment.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { Comment } from "../schema/comment.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/comment.d.ts
 /** Tables required by {@link CommentModel}. */
 interface CommentTables {
   comments: Table;
@@ -27,6 +26,5 @@ interface CommentCreateInput {
   storyId?: string;
   parentId?: string;
 }
-//#endregion
 export { CommentCreateInput, CommentModel, CommentTables };
 //# sourceMappingURL=comment.d.mts.map

package/dist/models/comment.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { eq } from "drizzle-orm";
-//#region src/models/comment.ts
+// src/models/comment.ts
 /** Build and snapshot review comments. */
 /** Data operations for review comments. */
 var CommentModel = class {
@@ -45,7 +45,6 @@ var CommentModel = class {
 		});
 	}
 };
-//#endregion
 export { CommentModel };
 
 //# sourceMappingURL=comment.mjs.map

package/dist/models/component.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { SnapshotStatus } from "../types.mjs";
 import { Build } from "../schema/build.mjs";
 import { Snapshot } from "../schema/snapshot.mjs";
-//#region src/models/component.d.ts
 /** The most attention-worthy status of a set (unchanged when empty). */
 declare function worstStatus(statuses: readonly SnapshotStatus[]): SnapshotStatus;
 /** One build's view of a component. */
@@ -38,6 +37,5 @@ type ComponentPresence = {
  * every file, used to find a moved file by its last-seen title.
  */
 declare function componentPresence(history: readonly ComponentHistoryRow[], latestBuildId: string | null, latest: readonly Pick<Snapshot, "storyTitle" | "storyImportPath">[], lastTitle: string | null): ComponentPresence;
-//#endregion
 export { ComponentHistoryRow, ComponentPresence, componentHistory, componentPresence, worstStatus };
 //# sourceMappingURL=component.d.mts.map

package/dist/models/component.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/models/component.ts
+// src/models/component.ts
 /** Worst-first order used for status roll-ups. */
 const STATUS_PRIORITY = [
 	"rejected",
@@ -54,7 +54,6 @@ function componentPresence(history, latestBuildId, latest, lastTitle) {
 		lastSeen: newest.build
 	};
 }
-//#endregion
 export { componentHistory, componentPresence, worstStatus };
 
 //# sourceMappingURL=component.mjs.map

package/dist/models/connections.d.mts

@@ -5,7 +5,6 @@ import { OAuthClient, OAuthTokens } from "../adapter/oauth.mjs";
 import { SecretInput } from "../utils/encrypt.mjs";
 import { UserConnection } from "../schema/connection.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/connections.d.ts
 /** Tables required by {@link ConnectionModel}. */
 interface ConnectionTables {
   userConnections: Table;
@@ -36,6 +35,5 @@ declare class ConnectionModel {
   accessToken(userId: string, service: string, oauth?: Pick<OAuthClient, "refresh">, now?: Date): Promise<string | null>;
   private refreshOnce;
 }
-//#endregion
 export { ConnectionModel, ConnectionTables };
 //# sourceMappingURL=connections.d.mts.map

package/dist/models/connections.mjs

@@ -5,7 +5,7 @@ import { decryptCredential, encrypt } from "../utils/encrypt.mjs";
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { and, eq } from "drizzle-orm";
-//#region src/models/connections.ts
+// src/models/connections.ts
 /** A user's own OAuth connections to external services: encrypted tokens, lazy refresh on use. */
 /** Refresh this long before expiry so a call never starts with a token about to lapse. */
 const REFRESH_MARGIN_MS = 6e4;
@@ -106,7 +106,6 @@ var ConnectionModel = class {
 function isExpiring(expiresAt, now) {
 	return expiresAt !== null && Date.parse(expiresAt) - now.getTime() < REFRESH_MARGIN_MS;
 }
-//#endregion
 export { ConnectionModel };
 
 //# sourceMappingURL=connections.mjs.map

package/dist/models/content-ref.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { ContentRef } from "../schema/content-ref.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/content-ref.d.ts
 /** Content refs for deduplicated Storybook assets. */
 declare class ContentRefModel {
   private readonly tables;
@@ -16,6 +15,5 @@ declare class ContentRefModel {
   decrement(hash: string): Promise<ContentRef | null>;
   listStale(cutoff: string): Promise<ContentRef[]>;
 }
-//#endregion
 export { ContentRefModel };
 //# sourceMappingURL=content-ref.d.mts.map

package/dist/models/content-ref.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/models/content-ref.ts
+// src/models/content-ref.ts
 /** Content refs for deduplicated Storybook assets. */
 var ContentRefModel = class {
 	tables;
@@ -43,7 +43,6 @@ var ContentRefModel = class {
 		return (await this.db.list(this.tables.contentRefs)).filter((r) => r.refCount === 0 && r.lastSeenAt < cutoff);
 	}
 };
-//#endregion
 export { ContentRefModel };
 
 //# sourceMappingURL=content-ref.mjs.map

package/dist/models/credentials.d.mts

@@ -2,7 +2,6 @@ import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { SecretKeys } from "../utils/encrypt.mjs";
-//#region src/models/credentials.d.ts
 /** A row no configured key can decrypt. */
 interface UnreadableCredential {
   source: string;
@@ -31,6 +30,5 @@ declare function probeCredentials(db: DatabaseAdapter, keys: SecretKeys): Promis
  * write does not stop the rest.
  */
 declare function reencryptCredentials(db: DatabaseAdapter, keys: SecretKeys): Promise<ReencryptResult>;
-//#endregion
 export { CredentialProbe, ReencryptResult, UnreadableCredential, probeCredentials, reencryptCredentials };
 //# sourceMappingURL=credentials.d.mts.map

package/dist/models/credentials.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { decryptWithKey, encrypt } from "../utils/encrypt.mjs";
-//#region src/models/credentials.ts
+// src/models/credentials.ts
 /** Tables that hold encrypted credentials, with the column to read. */
 const SOURCES = [
 	{
@@ -107,7 +107,6 @@ async function reencryptOne(db, keys, item) {
 		return { state: "failed" };
 	}
 }
-//#endregion
 export { probeCredentials, reencryptCredentials };
 
 //# sourceMappingURL=credentials.mjs.map

package/dist/models/design-credentials.d.mts

@@ -5,7 +5,6 @@ import { SecretInput } from "../utils/encrypt.mjs";
 import { DesignCredential } from "../schema/design.mjs";
 import { DesignCredentialStatus } from "./design-resolve.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/design-credentials.d.ts
 /** Tables required by {@link DesignCredentialModel}. */
 interface DesignCredentialTables {
   designCredentials: Table;
@@ -36,6 +35,5 @@ declare class DesignCredentialModel {
   recordStatus(projectId: string, provider: string, status: DesignCredentialStatus): Promise<void>;
   private replace;
 }
-//#endregion
 export { DesignCredentialModel, DesignCredentialTables, PROJECT_SCOPE };
 //# sourceMappingURL=design-credentials.d.mts.map

package/dist/models/design-credentials.mjs

@@ -5,7 +5,7 @@ import { decryptCredential, encrypt } from "../utils/encrypt.mjs";
 import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { and, eq } from "drizzle-orm";
-//#region src/models/design-credentials.ts
+// src/models/design-credentials.ts
 /** Encrypted design-provider credentials: the project-wide token an admin pastes. */
 /** Cache scope of the shared project credential (`design_nodes.viewer_id`); a user id marks a member's own connection. */
 const PROJECT_SCOPE = "";
@@ -80,7 +80,6 @@ var DesignCredentialModel = class {
 		return true;
 	}
 };
-//#endregion
 export { DesignCredentialModel, PROJECT_SCOPE };
 
 //# sourceMappingURL=design-credentials.mjs.map

package/dist/models/design-health.d.mts

@@ -1,16 +1,29 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { DesignNode } from "../schema/design.mjs";
-//#region src/models/design-health.d.ts
 /** Cached metadata younger than this is served without a refetch. */
 declare const DESIGN_TTL_MS: number;
 /** True when the design changed after the baseline it is compared with was approved. */
 declare function isDesignStale(node: Pick<DesignNode, "state" | "lastModified"> | null | undefined, baselineVersion: string | null | undefined): boolean;
+/** What happened to a design after its baseline was approved. */
+type DesignChangeKind = "modified-after-approval" | "deleted";
+/** A design change to tell people about, with the identity it is de-duplicated on. */
+interface DesignChange {
+  change: DesignChangeKind;
+  /** `<change>:<version>`: one notification per design version and kind of change. */
+  key: string;
+  /** The design's version when it changed (a deleted node keeps its last known one). */
+  designVersion: string | null;
+}
+/**
+ * The change worth a `design:changed` notification, or null. A deleted node always counts; a
+ * modified one only when it moved after `baselineVersion` (see {@link isDesignStale}).
+ */
+declare function designChange(node: Pick<DesignNode, "state" | "version" | "lastModified"> | null | undefined, baselineVersion: string | null | undefined): DesignChange | null;
 /**
  * Days until a credential passes its provider's maximum lifetime (negative once
  * past). `issuedAt` is when the credential was set or replaced — never a status write.
  */
 declare function credentialDaysLeft(issuedAt: string, maxAgeDays: number, now?: Date): number;
-//#endregion
-export { DESIGN_TTL_MS, credentialDaysLeft, isDesignStale };
+export { DESIGN_TTL_MS, DesignChange, DesignChangeKind, credentialDaysLeft, designChange, isDesignStale };
 //# sourceMappingURL=design-health.d.mts.map

package/dist/models/design-health.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/models/design-health.ts
+// src/models/design-health.ts
 /** Cached metadata younger than this is served without a refetch. */
 const DESIGN_TTL_MS = 9e5;
 /** True when the design changed after the baseline it is compared with was approved. */
@@ -12,6 +12,25 @@ function isDesignStale(node, baselineVersion) {
 	return Number.isFinite(modified) && Number.isFinite(approved) && modified > approved;
 }
 /**
+* The change worth a `design:changed` notification, or null. A deleted node always counts; a
+* modified one only when it moved after `baselineVersion` (see {@link isDesignStale}).
+*/
+function designChange(node, baselineVersion) {
+	if (!node) return null;
+	const designVersion = node.version ?? node.lastModified;
+	if (node.state === "deleted") return {
+		change: "deleted",
+		key: `deleted:${designVersion ?? ""}`,
+		designVersion
+	};
+	if (!isDesignStale(node, baselineVersion)) return null;
+	return {
+		change: "modified-after-approval",
+		key: `modified-after-approval:${designVersion ?? ""}`,
+		designVersion
+	};
+}
+/**
 * Days until a credential passes its provider's maximum lifetime (negative once
 * past). `issuedAt` is when the credential was set or replaced — never a status write.
 */
@@ -19,7 +38,6 @@ function credentialDaysLeft(issuedAt, maxAgeDays, now = /* @__PURE__ */ new Date
 	const ageDays = (now.getTime() - Date.parse(issuedAt)) / 864e5;
 	return Math.ceil(maxAgeDays - ageDays);
 }
-//#endregion
-export { DESIGN_TTL_MS, credentialDaysLeft, isDesignStale };
+export { DESIGN_TTL_MS, credentialDaysLeft, designChange, isDesignStale };
 
 //# sourceMappingURL=design-health.mjs.map

package/dist/models/design-health.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"design-health.mjs","names":[],"sources":["../../src/models/design-health.ts"],"sourcesContent":["/** Design cache freshness, staleness and credential-age rules (provider-neutral). */\nimport type { DesignNode } from \"../schema/design.ts\";\n\n/** Cached metadata younger than this is served without a refetch. */\nexport const DESIGN_TTL_MS = 15 * 60_000;\n\n/** True when the design changed after the baseline it is compared with was approved. */\nexport function isDesignStale(\n  node: Pick<DesignNode, \"state\" | \"lastModified\"> | null | undefined,\n  baselineVersion: string | null | undefined,\n): boolean {\n  if (node?.state !== \"ok\" || !node.lastModified || !baselineVersion) return false;\n  const modified = Date.parse(node.lastModified);\n  const approved = Date.parse(baselineVersion);\n  return Number.isFinite(modified) && Number.isFinite(approved) && modified > approved;\n}\n\n/**\n * Days until a credential passes its provider's maximum lifetime (negative once\n * past). `issuedAt` is when the credential was set or replaced — never a status write.\n */\nexport function credentialDaysLeft(\n  issuedAt: string,\n  maxAgeDays: number,\n  now: Date = new Date(),\n): number {\n  const ageDays = (now.getTime() - Date.parse(issuedAt)) / 86_400_000;\n  return Math.ceil(maxAgeDays - ageDays);\n}\n"],"mappings":";;;;;AAIA,MAAa,gBAAgB;;AAG7B,SAAgB,cACd,MACA,iBACS;CACT,IAAI,MAAM,UAAU,QAAQ,CAAC,KAAK,gBAAgB,CAAC,iBAAiB,OAAO;CAC3E,MAAM,WAAW,KAAK,MAAM,KAAK,YAAY;CAC7C,MAAM,WAAW,KAAK,MAAM,eAAe;CAC3C,OAAO,OAAO,SAAS,QAAQ,KAAK,OAAO,SAAS,QAAQ,KAAK,WAAW;AAC9E;;;;;AAMA,SAAgB,mBACd,UACA,YACA,sBAAY,IAAI,KAAK,GACb;CACR,MAAM,WAAW,IAAI,QAAQ,IAAI,KAAK,MAAM,QAAQ,KAAK;CACzD,OAAO,KAAK,KAAK,aAAa,OAAO;AACvC"}
+{"version":3,"file":"design-health.mjs","names":[],"sources":["../../src/models/design-health.ts"],"sourcesContent":["/** Design cache freshness, staleness and credential-age rules (provider-neutral). */\nimport type { DesignNode } from \"../schema/design.ts\";\n\n/** Cached metadata younger than this is served without a refetch. */\nexport const DESIGN_TTL_MS = 15 * 60_000;\n\n/** True when the design changed after the baseline it is compared with was approved. */\nexport function isDesignStale(\n  node: Pick<DesignNode, \"state\" | \"lastModified\"> | null | undefined,\n  baselineVersion: string | null | undefined,\n): boolean {\n  if (node?.state !== \"ok\" || !node.lastModified || !baselineVersion) return false;\n  const modified = Date.parse(node.lastModified);\n  const approved = Date.parse(baselineVersion);\n  return Number.isFinite(modified) && Number.isFinite(approved) && modified > approved;\n}\n\n/** What happened to a design after its baseline was approved. */\nexport type DesignChangeKind = \"modified-after-approval\" | \"deleted\";\n\n/** A design change to tell people about, with the identity it is de-duplicated on. */\nexport interface DesignChange {\n  change: DesignChangeKind;\n  /** `<change>:<version>`: one notification per design version and kind of change. */\n  key: string;\n  /** The design's version when it changed (a deleted node keeps its last known one). */\n  designVersion: string | null;\n}\n\n/**\n * The change worth a `design:changed` notification, or null. A deleted node always counts; a\n * modified one only when it moved after `baselineVersion` (see {@link isDesignStale}).\n */\nexport function designChange(\n  node: Pick<DesignNode, \"state\" | \"version\" | \"lastModified\"> | null | undefined,\n  baselineVersion: string | null | undefined,\n): DesignChange | null {\n  if (!node) return null;\n  const designVersion = node.version ?? node.lastModified;\n  if (node.state === \"deleted\") {\n    return { change: \"deleted\", key: `deleted:${designVersion ?? \"\"}`, designVersion };\n  }\n  if (!isDesignStale(node, baselineVersion)) return null;\n  return {\n    change: \"modified-after-approval\",\n    key: `modified-after-approval:${designVersion ?? \"\"}`,\n    designVersion,\n  };\n}\n\n/**\n * Days until a credential passes its provider's maximum lifetime (negative once\n * past). `issuedAt` is when the credential was set or replaced — never a status write.\n */\nexport function credentialDaysLeft(\n  issuedAt: string,\n  maxAgeDays: number,\n  now: Date = new Date(),\n): number {\n  const ageDays = (now.getTime() - Date.parse(issuedAt)) / 86_400_000;\n  return Math.ceil(maxAgeDays - ageDays);\n}\n"],"mappings":";;;;;AAIA,MAAa,gBAAgB;;AAG7B,SAAgB,cACd,MACA,iBACS;CACT,IAAI,MAAM,UAAU,QAAQ,CAAC,KAAK,gBAAgB,CAAC,iBAAiB,OAAO;CAC3E,MAAM,WAAW,KAAK,MAAM,KAAK,YAAY;CAC7C,MAAM,WAAW,KAAK,MAAM,eAAe;CAC3C,OAAO,OAAO,SAAS,QAAQ,KAAK,OAAO,SAAS,QAAQ,KAAK,WAAW;AAC9E;;;;;AAkBA,SAAgB,aACd,MACA,iBACqB;CACrB,IAAI,CAAC,MAAM,OAAO;CAClB,MAAM,gBAAgB,KAAK,WAAW,KAAK;CAC3C,IAAI,KAAK,UAAU,WACjB,OAAO;EAAE,QAAQ;EAAW,KAAK,WAAW,iBAAiB;EAAM;CAAc;CAEnF,IAAI,CAAC,cAAc,MAAM,eAAe,GAAG,OAAO;CAClD,OAAO;EACL,QAAQ;EACR,KAAK,2BAA2B,iBAAiB;EACjD;CACF;AACF;;;;;AAMA,SAAgB,mBACd,UACA,YACA,sBAAY,IAAI,KAAK,GACb;CACR,MAAM,WAAW,IAAI,QAAQ,IAAI,KAAK,MAAM,QAAQ,KAAK;CACzD,OAAO,KAAK,KAAK,aAAa,OAAO;AACvC"}

package/dist/models/design-nodes.d.mts

@@ -1,15 +1,15 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { DatabaseAdapter } from "../adapter/database.mjs";
 import { Logger } from "../logger.mjs";
+import { DatabaseAdapter } from "../adapter/database.mjs";
 import { DesignProvider } from "../adapter/design.mjs";
 import { StorageAdapter } from "../adapter/storage.mjs";
-import { ConnectionModel } from "./connections.mjs";
 import { DesignNode } from "../schema/design.mjs";
+import { ConnectionModel } from "./connections.mjs";
 import { DesignCredentialModel } from "./design-credentials.mjs";
+import { DesignChange } from "./design-health.mjs";
 import { Table } from "drizzle-orm";
 import { Buffer } from "node:buffer";
-//#region src/models/design-nodes.d.ts
 /** Tables required by {@link DesignNodeModel}. */
 interface DesignNodeTables {
   designNodes: Table;
@@ -47,6 +47,14 @@ declare class DesignNodeModel {
    * absent). A row fetched with someone's own connection is only visible to that viewer.
    */
   cachedFor(projectId: string, urls: readonly string[], viewerId?: string): Promise<Map<string, DesignNode>>;
+  /**
+   * Claim the right to announce `change` for a node: true for exactly one caller per
+   * `change.key`, even when health checks run concurrently. The claim is a compare-and-set of
+   * `notified_version` from the value read here to a fresh `<key>#<token>`; a caller that finds
+   * the key already claimed, or loses the swap, gets false. Shared (project-credential) rows only:
+   * a member's own-connection row never announces, so one design is never announced twice.
+   */
+  claimChange(node: DesignNode, change: DesignChange): Promise<boolean>;
   /** Refresh one link (see {@link refreshMany}); null for unsupported URLs or nothing cached. */
   refresh(projectId: string, url: string, now?: Date, viewerId?: string): Promise<DesignNode | null>;
   /**
@@ -78,6 +86,5 @@ declare class DesignNodeModel {
    */
   private store;
 }
-//#endregion
 export { DesignNodeModel, DesignNodeTables, RefreshOptions };
 //# sourceMappingURL=design-nodes.d.mts.map

package/dist/models/design-nodes.mjs

@@ -8,8 +8,8 @@ import { mapLimit } from "../utils/map-limit.mjs";
 import "./design-credentials.mjs";
 import "./design-health.mjs";
 import { DesignRenderStore } from "./design-renders.mjs";
-import { and, eq } from "drizzle-orm";
-//#region src/models/design-nodes.ts
+import { and, eq, isNull } from "drizzle-orm";
+// src/models/design-nodes.ts
 /** Design metadata + render cache: TTL refresh, batched per file, bounded concurrency, abortable. */
 /** Most files refreshed in parallel by one {@link DesignNodeModel.refreshMany} call. */
 const FILE_CONCURRENCY = 3;
@@ -51,6 +51,21 @@ var DesignNodeModel = class {
 		}));
 		return new Map(rows.flatMap(([url, row]) => row ? [[url, row]] : []));
 	}
+	/**
+	* Claim the right to announce `change` for a node: true for exactly one caller per
+	* `change.key`, even when health checks run concurrently. The claim is a compare-and-set of
+	* `notified_version` from the value read here to a fresh `<key>#<token>`; a caller that finds
+	* the key already claimed, or loses the swap, gets false. Shared (project-credential) rows only:
+	* a member's own-connection row never announces, so one design is never announced twice.
+	*/
+	async claimChange(node, change) {
+		if (node.viewerId !== "") return false;
+		const column = col(this.tables.designNodes, "notifiedVersion");
+		const current = await this.db.get(this.tables.designNodes, node.id);
+		if (!current || current.notifiedVersion?.startsWith(`${change.key}#`) === true) return false;
+		const token = `${change.key}#${ulid()}`;
+		return (await this.db.updateWhere(this.tables.designNodes, node.id, { notifiedVersion: token }, current.notifiedVersion === null ? isNull(column) : eq(column, current.notifiedVersion)))?.notifiedVersion === token;
+	}
 	/** Refresh one link (see {@link refreshMany}); null for unsupported URLs or nothing cached. */
 	async refresh(projectId, url, now, viewerId) {
 		return (await this.refreshMany(projectId, [url], {
@@ -181,6 +196,7 @@ var DesignNodeModel = class {
 			nodeId: ref.nodeId ?? "",
 			renderPath: null,
 			renderVersion: null,
+			notifiedVersion: null,
 			createdAt: stamp,
 			...values
 		});
@@ -216,7 +232,6 @@ async function memo(cache, key, load) {
 	cache.set(key, created);
 	return await created;
 }
-//#endregion
 export { DesignNodeModel };
 
 //# sourceMappingURL=design-nodes.mjs.map

package/dist/models/design-nodes.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"design-nodes.mjs","names":[],"sources":["../../src/models/design-nodes.ts"],"sourcesContent":["/** Design metadata + render cache: TTL refresh, batched per file, bounded concurrency, abortable. */\nimport { and, eq } from \"drizzle-orm\";\nimport type { Table } from \"drizzle-orm\";\nimport type { Buffer } from \"node:buffer\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type {\n  DesignCallOptions,\n  DesignClient,\n  DesignMeta,\n  DesignProvider,\n  DesignRef,\n} from \"../adapters/design.ts\";\nimport { parseDesignUrl } from \"../adapters/design.ts\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport type { Logger } from \"../logger.ts\";\nimport type { DesignNode } from \"../schema/design.ts\";\nimport { mapLimit } from \"../utils/map-limit.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\nimport { col } from \"./columns.ts\";\nimport type { ConnectionModel } from \"./connections.ts\";\nimport { PROJECT_SCOPE, type DesignCredentialModel } from \"./design-credentials.ts\";\nimport { DESIGN_TTL_MS } from \"./design-health.ts\";\nimport { DesignRenderStore } from \"./design-renders.ts\";\nimport type { DesignCredentialStatus } from \"./design-resolve.ts\";\n\n/** Most files refreshed in parallel by one {@link DesignNodeModel.refreshMany} call. */\nconst FILE_CONCURRENCY = 3;\n\n/** Tables required by {@link DesignNodeModel}. */\nexport interface DesignNodeTables {\n  designNodes: Table;\n}\n\n/** Options of {@link DesignNodeModel.refreshMany}. */\nexport interface RefreshOptions {\n  now?: Date;\n  /** Cancels in-flight provider calls (e.g. a page-render budget). */\n  signal?: AbortSignal;\n  /** The visiting user: their own connection is used when the project has no credential. */\n  viewerId?: string;\n}\n\ninterface Due {\n  url: string;\n  provider: DesignProvider;\n  ref: DesignRef;\n  cached: DesignNode | null;\n  /** Whose credential fetches this link: {@link PROJECT_SCOPE} or the viewer's user id. */\n  scope: string;\n}\n\n/** Cache of design file/node metadata and node renders with TTL refresh. */\nexport class DesignNodeModel {\n  private readonly tables: DesignNodeTables;\n  private readonly renders: DesignRenderStore;\n  private readonly logger: Logger | undefined;\n  private readonly connections: ConnectionModel | undefined;\n  private readonly db: DatabaseAdapter;\n  private readonly credentials: DesignCredentialModel;\n  private readonly providers: readonly DesignProvider[];\n\n  constructor(\n    db: DatabaseAdapter,\n    credentials: DesignCredentialModel,\n    providers: readonly DesignProvider[],\n    options: {\n      tables?: DesignNodeTables;\n      logger?: Logger;\n      storage?: StorageAdapter;\n      /** Members' own connections, used when the project has no credential. */\n      connections?: ConnectionModel;\n    } = {},\n  ) {\n    this.db = db;\n    this.credentials = credentials;\n    this.providers = providers;\n    this.tables = options.tables ?? { designNodes: db.tables.designNodes };\n    this.renders = new DesignRenderStore(\n      db,\n      this.tables.designNodes,\n      options.storage,\n      options.logger,\n    );\n    this.logger = options.logger;\n    this.connections = options.connections;\n  }\n\n  /** Cached row by id, scoped to the project, or null. */\n  async get(projectId: string, id: string): Promise<DesignNode | null> {\n    const row = (await this.db.get(this.tables.designNodes, id)) as unknown as DesignNode | null;\n    return row?.projectId === projectId ? row : null;\n  }\n\n  /** Cached render bytes of a node, or null when it has none (or storage is not wired). */\n  async readRender(node: DesignNode): Promise<Buffer | null> {\n    return await this.renders.read(node);\n  }\n\n  /**\n   * Cached rows for the given design URLs, keyed by URL (unparseable or uncached URLs are\n   * absent). A row fetched with someone's own connection is only visible to that viewer.\n   */\n  async cachedFor(\n    projectId: string,\n    urls: readonly string[],\n    viewerId?: string,\n  ): Promise<Map<string, DesignNode>> {\n    const rows = await Promise.all(\n      [...new Set(urls)].map(async (url) => {\n        const parsed = parseDesignUrl(this.providers, url);\n        const row = parsed\n          ? await this.visible(projectId, parsed.provider.metadata.kind, parsed.ref, viewerId)\n          : null;\n        return [url, row] as const;\n      }),\n    );\n    return new Map(rows.flatMap(([url, row]) => (row ? [[url, row] as const] : [])));\n  }\n\n  /** Refresh one link (see {@link refreshMany}); null for unsupported URLs or nothing cached. */\n  async refresh(\n    projectId: string,\n    url: string,\n    now?: Date,\n    viewerId?: string,\n  ): Promise<DesignNode | null> {\n    const results = await this.refreshMany(projectId, [url], {\n      ...(now ? { now } : {}),\n      ...(viewerId ? { viewerId } : {}),\n    });\n    return results.get(url) ?? null;\n  }\n\n  /**\n   * Refresh the given links' metadata and renders when missing or past the TTL.\n   * Links of one file share one metadata call and one render call, and files run\n   * with bounded concurrency. Transient failures keep the previous cache; auth\n   * failures update the credential's health. Never throws.\n   */\n  async refreshMany(\n    projectId: string,\n    urls: readonly string[],\n    options: RefreshOptions = {},\n  ): Promise<Map<string, DesignNode | null>> {\n    const now = options.now ?? new Date();\n    const scopes = new Map<string, Promise<string>>();\n    const lookups = await Promise.all(\n      [...new Set(urls)].map(async (url) => {\n        const parsed = parseDesignUrl(this.providers, url);\n        if (!parsed) return null;\n        const kind = parsed.provider.metadata.kind;\n        const scope = await memo(scopes, kind, async () => {\n          return await this.scopeFor(projectId, kind, options.viewerId);\n        });\n        const cached = await this.lookup(projectId, kind, parsed.ref, scope);\n        return { url, provider: parsed.provider, ref: parsed.ref, cached, scope };\n      }),\n    );\n    const known = lookups.filter((item) => item !== null);\n    const results = new Map<string, DesignNode | null>(\n      known.map((item) => [item.url, item.cached]),\n    );\n    const due = known.filter((item) => isDue(item.cached, now));\n    if (due.length === 0) return results;\n    const fresh = await this.refreshDue(projectId, due, now, callOptions(this.logger, options));\n    for (const [url, node] of fresh) results.set(url, node);\n    return results;\n  }\n\n  /** Refresh due links grouped by provider and file, files in parallel (bounded). */\n  private async refreshDue(\n    projectId: string,\n    due: Due[],\n    now: Date,\n    call: DesignCallOptions,\n  ): Promise<Map<string, DesignNode>> {\n    const byFile = [\n      ...Map.groupBy(due, (item) => `${item.provider.metadata.kind}\\u0000${item.ref.fileKey}`),\n    ];\n    const batches = await mapLimit(byFile, FILE_CONCURRENCY, async ([, items]) => {\n      return await this.refreshFile(projectId, items, now, call);\n    });\n    const merged = new Map<string, DesignNode>();\n    for (const batch of batches) {\n      for (const [url, node] of batch) merged.set(url, node);\n    }\n    return merged;\n  }\n\n  private async refreshFile(\n    projectId: string,\n    items: Due[],\n    now: Date,\n    call: DesignCallOptions,\n  ): Promise<Map<string, DesignNode>> {\n    const client = await this.clientFor(projectId, items);\n    const first = items[0];\n    if (!client || !first) return new Map();\n    const { provider, ref } = first;\n    const metas = await client.fetchMetas(\n      ref.fileKey,\n      items.map((item) => item.ref),\n      call,\n    );\n    const answered = [...metas.values()].find((meta) => meta.state !== \"error\");\n    if (answered && first.scope === PROJECT_SCOPE) {\n      await this.credentials.recordStatus(\n        projectId,\n        provider.metadata.kind,\n        statusFor(answered.state),\n      );\n    }\n    const stored = await this.storeAll(projectId, items, metas, now);\n    return await this.renders.ensure(projectId, client, ref.fileKey, stored, call);\n  }\n\n  /** Upsert a row per item that got a usable answer (`error` keeps its cached row), keyed by URL. */\n  private async storeAll(\n    projectId: string,\n    items: Due[],\n    metas: Map<string, DesignMeta>,\n    now: Date,\n  ): Promise<Map<string, DesignNode>> {\n    const rows = await Promise.all(\n      items.map(async (item) => {\n        const meta = metas.get(item.ref.nodeId ?? \"\");\n        const row =\n          meta && meta.state !== \"error\" ? await this.store(projectId, item, meta, now) : null;\n        return row ? ([item.url, row] as const) : null;\n      }),\n    );\n    return new Map(rows.filter((entry) => entry !== null));\n  }\n\n  /** A client for the provider of `items` bound to the items' credential scope, or null without one. */\n  private async clientFor(projectId: string, items: Due[]): Promise<DesignClient | null> {\n    const first = items[0];\n    if (!first) return null;\n    const { provider, scope } = first;\n    const kind = provider.metadata.kind;\n    const own = scope !== PROJECT_SCOPE;\n    const credential = own\n      ? await this.connections?.accessToken(scope, kind, provider.oauth).catch(() => null)\n      : await this.credentials.get(projectId, kind).catch(() => null);\n    if (!credential) return null;\n    return provider.create({\n      credential,\n      authType: own ? \"oauth\" : \"token\",\n      ...(this.logger ? { logger: this.logger } : {}),\n    });\n  }\n\n  /**\n   * Whose credential serves a provider: the project's when set (it is shared and\n   * wins), else the viewer's own connection, else the project scope (nothing to fetch with).\n   */\n  private async scopeFor(projectId: string, provider: string, viewerId?: string): Promise<string> {\n    if (!viewerId || !this.connections || (await this.credentials.info(projectId, provider))) {\n      return PROJECT_SCOPE;\n    }\n    return (await this.connections.info(viewerId, provider)) ? viewerId : PROJECT_SCOPE;\n  }\n\n  /** The shared row, else the viewer's own (a connected member's entries are never served to others). */\n  private async visible(\n    projectId: string,\n    provider: string,\n    ref: DesignRef,\n    viewerId?: string,\n  ): Promise<DesignNode | null> {\n    const shared = await this.lookup(projectId, provider, ref, PROJECT_SCOPE);\n    if (shared || !viewerId) return shared;\n    return await this.lookup(projectId, provider, ref, viewerId);\n  }\n\n  private async lookup(\n    projectId: string,\n    provider: string,\n    ref: DesignRef,\n    scope: string,\n  ): Promise<DesignNode | null> {\n    const rows = (await this.db.list(this.tables.designNodes, {\n      where: and(\n        eq(col(this.tables.designNodes, \"projectId\"), projectId),\n        eq(col(this.tables.designNodes, \"provider\"), provider),\n        eq(col(this.tables.designNodes, \"viewerId\"), scope),\n        eq(col(this.tables.designNodes, \"fileKey\"), ref.fileKey),\n        eq(col(this.tables.designNodes, \"nodeId\"), ref.nodeId ?? \"\"),\n      ),\n      limit: 1,\n    })) as unknown as DesignNode[];\n    return rows[0] ?? null;\n  }\n\n  /**\n   * Upsert the row. Non-ok states keep the last good name/version/modified time\n   * (an auth failure must not erase the label); a deleted node also drops its\n   * cached render, so a design that no longer exists is never shown as reference.\n   */\n  private async store(\n    projectId: string,\n    item: Due,\n    meta: DesignMeta,\n    now: Date,\n  ): Promise<DesignNode> {\n    const { ref, cached } = item;\n    const stamp = now.toISOString();\n    const keep = meta.state !== \"ok\" && cached;\n    const values = {\n      name: keep ? cached.name : meta.name,\n      version: keep ? cached.version : meta.version,\n      lastModified: keep ? cached.lastModified : meta.lastModified,\n      state: meta.state,\n      fetchedAt: stamp,\n      updatedAt: stamp,\n    };\n    if (!cached) {\n      return (await this.db.insert(this.tables.designNodes, {\n        id: ulid(),\n        projectId,\n        provider: item.provider.metadata.kind,\n        viewerId: item.scope,\n        fileKey: ref.fileKey,\n        nodeId: ref.nodeId ?? \"\",\n        renderPath: null,\n        renderVersion: null,\n        createdAt: stamp,\n        ...values,\n      })) as unknown as DesignNode;\n    }\n    const dropRender = meta.state === \"deleted\" && cached.renderPath !== null;\n    if (dropRender) await this.renders.remove(cached);\n    return (await this.db.update(this.tables.designNodes, cached.id, {\n      ...values,\n      ...(dropRender ? { renderPath: null, renderVersion: null } : {}),\n    })) as unknown as DesignNode;\n  }\n}\n\n/** Never fetched, or cached longer ago than the TTL. */\nfunction isDue(cached: DesignNode | null, now: Date): boolean {\n  return !cached || now.getTime() - Date.parse(cached.fetchedAt) >= DESIGN_TTL_MS;\n}\n\nfunction callOptions(logger: Logger | undefined, options: RefreshOptions): DesignCallOptions {\n  return {\n    ...(logger ? { logger } : {}),\n    ...(options.signal ? { signal: options.signal } : {}),\n  };\n}\n\nfunction statusFor(state: DesignMeta[\"state\"]): DesignCredentialStatus {\n  return state === \"unauthorized\" || state === \"forbidden\" ? state : \"ok\";\n}\n\n/** Run `load` once per key, sharing the in-flight promise between concurrent callers. */\nasync function memo<T>(\n  cache: Map<string, Promise<T>>,\n  key: string,\n  load: () => Promise<T>,\n): Promise<T> {\n  const hit = cache.get(key);\n  if (hit) return await hit;\n  const created = load();\n  cache.set(key, created);\n  return await created;\n}\n"],"mappings":"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"}
+{"version":3,"file":"design-nodes.mjs","names":[],"sources":["../../src/models/design-nodes.ts"],"sourcesContent":["/** Design metadata + render cache: TTL refresh, batched per file, bounded concurrency, abortable. */\nimport { and, eq, isNull } from \"drizzle-orm\";\nimport type { Table } from \"drizzle-orm\";\nimport type { Buffer } from \"node:buffer\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type {\n  DesignCallOptions,\n  DesignClient,\n  DesignMeta,\n  DesignProvider,\n  DesignRef,\n} from \"../adapters/design.ts\";\nimport { parseDesignUrl } from \"../adapters/design.ts\";\nimport type { StorageAdapter } from \"../adapters/storage.ts\";\nimport type { Logger } from \"../logger.ts\";\nimport type { DesignNode } from \"../schema/design.ts\";\nimport { mapLimit } from \"../utils/map-limit.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\nimport { col } from \"./columns.ts\";\nimport type { ConnectionModel } from \"./connections.ts\";\nimport { PROJECT_SCOPE, type DesignCredentialModel } from \"./design-credentials.ts\";\nimport { DESIGN_TTL_MS, type DesignChange } from \"./design-health.ts\";\nimport { DesignRenderStore } from \"./design-renders.ts\";\nimport type { DesignCredentialStatus } from \"./design-resolve.ts\";\n\n/** Most files refreshed in parallel by one {@link DesignNodeModel.refreshMany} call. */\nconst FILE_CONCURRENCY = 3;\n\n/** Tables required by {@link DesignNodeModel}. */\nexport interface DesignNodeTables {\n  designNodes: Table;\n}\n\n/** Options of {@link DesignNodeModel.refreshMany}. */\nexport interface RefreshOptions {\n  now?: Date;\n  /** Cancels in-flight provider calls (e.g. a page-render budget). */\n  signal?: AbortSignal;\n  /** The visiting user: their own connection is used when the project has no credential. */\n  viewerId?: string;\n}\n\ninterface Due {\n  url: string;\n  provider: DesignProvider;\n  ref: DesignRef;\n  cached: DesignNode | null;\n  /** Whose credential fetches this link: {@link PROJECT_SCOPE} or the viewer's user id. */\n  scope: string;\n}\n\n/** Cache of design file/node metadata and node renders with TTL refresh. */\nexport class DesignNodeModel {\n  private readonly tables: DesignNodeTables;\n  private readonly renders: DesignRenderStore;\n  private readonly logger: Logger | undefined;\n  private readonly connections: ConnectionModel | undefined;\n  private readonly db: DatabaseAdapter;\n  private readonly credentials: DesignCredentialModel;\n  private readonly providers: readonly DesignProvider[];\n\n  constructor(\n    db: DatabaseAdapter,\n    credentials: DesignCredentialModel,\n    providers: readonly DesignProvider[],\n    options: {\n      tables?: DesignNodeTables;\n      logger?: Logger;\n      storage?: StorageAdapter;\n      /** Members' own connections, used when the project has no credential. */\n      connections?: ConnectionModel;\n    } = {},\n  ) {\n    this.db = db;\n    this.credentials = credentials;\n    this.providers = providers;\n    this.tables = options.tables ?? { designNodes: db.tables.designNodes };\n    this.renders = new DesignRenderStore(\n      db,\n      this.tables.designNodes,\n      options.storage,\n      options.logger,\n    );\n    this.logger = options.logger;\n    this.connections = options.connections;\n  }\n\n  /** Cached row by id, scoped to the project, or null. */\n  async get(projectId: string, id: string): Promise<DesignNode | null> {\n    const row = (await this.db.get(this.tables.designNodes, id)) as unknown as DesignNode | null;\n    return row?.projectId === projectId ? row : null;\n  }\n\n  /** Cached render bytes of a node, or null when it has none (or storage is not wired). */\n  async readRender(node: DesignNode): Promise<Buffer | null> {\n    return await this.renders.read(node);\n  }\n\n  /**\n   * Cached rows for the given design URLs, keyed by URL (unparseable or uncached URLs are\n   * absent). A row fetched with someone's own connection is only visible to that viewer.\n   */\n  async cachedFor(\n    projectId: string,\n    urls: readonly string[],\n    viewerId?: string,\n  ): Promise<Map<string, DesignNode>> {\n    const rows = await Promise.all(\n      [...new Set(urls)].map(async (url) => {\n        const parsed = parseDesignUrl(this.providers, url);\n        const row = parsed\n          ? await this.visible(projectId, parsed.provider.metadata.kind, parsed.ref, viewerId)\n          : null;\n        return [url, row] as const;\n      }),\n    );\n    return new Map(rows.flatMap(([url, row]) => (row ? [[url, row] as const] : [])));\n  }\n\n  /**\n   * Claim the right to announce `change` for a node: true for exactly one caller per\n   * `change.key`, even when health checks run concurrently. The claim is a compare-and-set of\n   * `notified_version` from the value read here to a fresh `<key>#<token>`; a caller that finds\n   * the key already claimed, or loses the swap, gets false. Shared (project-credential) rows only:\n   * a member's own-connection row never announces, so one design is never announced twice.\n   */\n  async claimChange(node: DesignNode, change: DesignChange): Promise<boolean> {\n    if (node.viewerId !== PROJECT_SCOPE) return false;\n    const column = col(this.tables.designNodes, \"notifiedVersion\");\n    const current = (await this.db.get(\n      this.tables.designNodes,\n      node.id,\n    )) as unknown as DesignNode | null;\n    if (!current || current.notifiedVersion?.startsWith(`${change.key}#`) === true) return false;\n    const token = `${change.key}#${ulid()}`;\n    const won = (await this.db.updateWhere(\n      this.tables.designNodes,\n      node.id,\n      { notifiedVersion: token },\n      current.notifiedVersion === null ? isNull(column) : eq(column, current.notifiedVersion),\n    )) as unknown as DesignNode | null;\n    return won?.notifiedVersion === token;\n  }\n\n  /** Refresh one link (see {@link refreshMany}); null for unsupported URLs or nothing cached. */\n  async refresh(\n    projectId: string,\n    url: string,\n    now?: Date,\n    viewerId?: string,\n  ): Promise<DesignNode | null> {\n    const results = await this.refreshMany(projectId, [url], {\n      ...(now ? { now } : {}),\n      ...(viewerId ? { viewerId } : {}),\n    });\n    return results.get(url) ?? null;\n  }\n\n  /**\n   * Refresh the given links' metadata and renders when missing or past the TTL.\n   * Links of one file share one metadata call and one render call, and files run\n   * with bounded concurrency. Transient failures keep the previous cache; auth\n   * failures update the credential's health. Never throws.\n   */\n  async refreshMany(\n    projectId: string,\n    urls: readonly string[],\n    options: RefreshOptions = {},\n  ): Promise<Map<string, DesignNode | null>> {\n    const now = options.now ?? new Date();\n    const scopes = new Map<string, Promise<string>>();\n    const lookups = await Promise.all(\n      [...new Set(urls)].map(async (url) => {\n        const parsed = parseDesignUrl(this.providers, url);\n        if (!parsed) return null;\n        const kind = parsed.provider.metadata.kind;\n        const scope = await memo(scopes, kind, async () => {\n          return await this.scopeFor(projectId, kind, options.viewerId);\n        });\n        const cached = await this.lookup(projectId, kind, parsed.ref, scope);\n        return { url, provider: parsed.provider, ref: parsed.ref, cached, scope };\n      }),\n    );\n    const known = lookups.filter((item) => item !== null);\n    const results = new Map<string, DesignNode | null>(\n      known.map((item) => [item.url, item.cached]),\n    );\n    const due = known.filter((item) => isDue(item.cached, now));\n    if (due.length === 0) return results;\n    const fresh = await this.refreshDue(projectId, due, now, callOptions(this.logger, options));\n    for (const [url, node] of fresh) results.set(url, node);\n    return results;\n  }\n\n  /** Refresh due links grouped by provider and file, files in parallel (bounded). */\n  private async refreshDue(\n    projectId: string,\n    due: Due[],\n    now: Date,\n    call: DesignCallOptions,\n  ): Promise<Map<string, DesignNode>> {\n    const byFile = [\n      ...Map.groupBy(due, (item) => `${item.provider.metadata.kind}\\u0000${item.ref.fileKey}`),\n    ];\n    const batches = await mapLimit(byFile, FILE_CONCURRENCY, async ([, items]) => {\n      return await this.refreshFile(projectId, items, now, call);\n    });\n    const merged = new Map<string, DesignNode>();\n    for (const batch of batches) {\n      for (const [url, node] of batch) merged.set(url, node);\n    }\n    return merged;\n  }\n\n  private async refreshFile(\n    projectId: string,\n    items: Due[],\n    now: Date,\n    call: DesignCallOptions,\n  ): Promise<Map<string, DesignNode>> {\n    const client = await this.clientFor(projectId, items);\n    const first = items[0];\n    if (!client || !first) return new Map();\n    const { provider, ref } = first;\n    const metas = await client.fetchMetas(\n      ref.fileKey,\n      items.map((item) => item.ref),\n      call,\n    );\n    const answered = [...metas.values()].find((meta) => meta.state !== \"error\");\n    if (answered && first.scope === PROJECT_SCOPE) {\n      await this.credentials.recordStatus(\n        projectId,\n        provider.metadata.kind,\n        statusFor(answered.state),\n      );\n    }\n    const stored = await this.storeAll(projectId, items, metas, now);\n    return await this.renders.ensure(projectId, client, ref.fileKey, stored, call);\n  }\n\n  /** Upsert a row per item that got a usable answer (`error` keeps its cached row), keyed by URL. */\n  private async storeAll(\n    projectId: string,\n    items: Due[],\n    metas: Map<string, DesignMeta>,\n    now: Date,\n  ): Promise<Map<string, DesignNode>> {\n    const rows = await Promise.all(\n      items.map(async (item) => {\n        const meta = metas.get(item.ref.nodeId ?? \"\");\n        const row =\n          meta && meta.state !== \"error\" ? await this.store(projectId, item, meta, now) : null;\n        return row ? ([item.url, row] as const) : null;\n      }),\n    );\n    return new Map(rows.filter((entry) => entry !== null));\n  }\n\n  /** A client for the provider of `items` bound to the items' credential scope, or null without one. */\n  private async clientFor(projectId: string, items: Due[]): Promise<DesignClient | null> {\n    const first = items[0];\n    if (!first) return null;\n    const { provider, scope } = first;\n    const kind = provider.metadata.kind;\n    const own = scope !== PROJECT_SCOPE;\n    const credential = own\n      ? await this.connections?.accessToken(scope, kind, provider.oauth).catch(() => null)\n      : await this.credentials.get(projectId, kind).catch(() => null);\n    if (!credential) return null;\n    return provider.create({\n      credential,\n      authType: own ? \"oauth\" : \"token\",\n      ...(this.logger ? { logger: this.logger } : {}),\n    });\n  }\n\n  /**\n   * Whose credential serves a provider: the project's when set (it is shared and\n   * wins), else the viewer's own connection, else the project scope (nothing to fetch with).\n   */\n  private async scopeFor(projectId: string, provider: string, viewerId?: string): Promise<string> {\n    if (!viewerId || !this.connections || (await this.credentials.info(projectId, provider))) {\n      return PROJECT_SCOPE;\n    }\n    return (await this.connections.info(viewerId, provider)) ? viewerId : PROJECT_SCOPE;\n  }\n\n  /** The shared row, else the viewer's own (a connected member's entries are never served to others). */\n  private async visible(\n    projectId: string,\n    provider: string,\n    ref: DesignRef,\n    viewerId?: string,\n  ): Promise<DesignNode | null> {\n    const shared = await this.lookup(projectId, provider, ref, PROJECT_SCOPE);\n    if (shared || !viewerId) return shared;\n    return await this.lookup(projectId, provider, ref, viewerId);\n  }\n\n  private async lookup(\n    projectId: string,\n    provider: string,\n    ref: DesignRef,\n    scope: string,\n  ): Promise<DesignNode | null> {\n    const rows = (await this.db.list(this.tables.designNodes, {\n      where: and(\n        eq(col(this.tables.designNodes, \"projectId\"), projectId),\n        eq(col(this.tables.designNodes, \"provider\"), provider),\n        eq(col(this.tables.designNodes, \"viewerId\"), scope),\n        eq(col(this.tables.designNodes, \"fileKey\"), ref.fileKey),\n        eq(col(this.tables.designNodes, \"nodeId\"), ref.nodeId ?? \"\"),\n      ),\n      limit: 1,\n    })) as unknown as DesignNode[];\n    return rows[0] ?? null;\n  }\n\n  /**\n   * Upsert the row. Non-ok states keep the last good name/version/modified time\n   * (an auth failure must not erase the label); a deleted node also drops its\n   * cached render, so a design that no longer exists is never shown as reference.\n   */\n  private async store(\n    projectId: string,\n    item: Due,\n    meta: DesignMeta,\n    now: Date,\n  ): Promise<DesignNode> {\n    const { ref, cached } = item;\n    const stamp = now.toISOString();\n    const keep = meta.state !== \"ok\" && cached;\n    const values = {\n      name: keep ? cached.name : meta.name,\n      version: keep ? cached.version : meta.version,\n      lastModified: keep ? cached.lastModified : meta.lastModified,\n      state: meta.state,\n      fetchedAt: stamp,\n      updatedAt: stamp,\n    };\n    if (!cached) {\n      return (await this.db.insert(this.tables.designNodes, {\n        id: ulid(),\n        projectId,\n        provider: item.provider.metadata.kind,\n        viewerId: item.scope,\n        fileKey: ref.fileKey,\n        nodeId: ref.nodeId ?? \"\",\n        renderPath: null,\n        renderVersion: null,\n        notifiedVersion: null,\n        createdAt: stamp,\n        ...values,\n      })) as unknown as DesignNode;\n    }\n    const dropRender = meta.state === \"deleted\" && cached.renderPath !== null;\n    if (dropRender) await this.renders.remove(cached);\n    return (await this.db.update(this.tables.designNodes, cached.id, {\n      ...values,\n      ...(dropRender ? { renderPath: null, renderVersion: null } : {}),\n    })) as unknown as DesignNode;\n  }\n}\n\n/** Never fetched, or cached longer ago than the TTL. */\nfunction isDue(cached: DesignNode | null, now: Date): boolean {\n  return !cached || now.getTime() - Date.parse(cached.fetchedAt) >= DESIGN_TTL_MS;\n}\n\nfunction callOptions(logger: Logger | undefined, options: RefreshOptions): DesignCallOptions {\n  return {\n    ...(logger ? { logger } : {}),\n    ...(options.signal ? { signal: options.signal } : {}),\n  };\n}\n\nfunction statusFor(state: DesignMeta[\"state\"]): DesignCredentialStatus {\n  return state === \"unauthorized\" || state === \"forbidden\" ? state : \"ok\";\n}\n\n/** Run `load` once per key, sharing the in-flight promise between concurrent callers. */\nasync function memo<T>(\n  cache: Map<string, Promise<T>>,\n  key: string,\n  load: () => Promise<T>,\n): Promise<T> {\n  const hit = cache.get(key);\n  if (hit) return await hit;\n  const created = load();\n  cache.set(key, created);\n  return await created;\n}\n"],"mappings":"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"}

package/dist/models/design-renders.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { designRenderPath } from "../paths.mjs";
-//#region src/models/design-renders.ts
+// src/models/design-renders.ts
 /**
 * Renders live at `{projectId}/design/{provider}/{fileKey}/{node}.png` (a member's own
 * connection: `…/{provider}/user-{id}/{fileKey}/…`), one per
@@ -68,7 +68,6 @@ var DesignRenderStore = class {
 function needsRender(node) {
 	return node.state === "ok" && node.nodeId !== "" && node.version !== null && node.renderVersion !== node.version;
 }
-//#endregion
 export { DesignRenderStore };
 
 //# sourceMappingURL=design-renders.mjs.map

package/dist/models/design-resolve.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { DesignLink } from "../schema/design.mjs";
-//#region src/models/design-resolve.d.ts
 /** Last observed health of a design credential. */
 type DesignCredentialStatus = "unknown" | "ok" | "unauthorized" | "forbidden";
 /** Where a component's resolved design link came from. */
@@ -24,6 +23,5 @@ declare function resolveDesigns(manual: readonly Pick<DesignLink, "importPath" |
   storyImportPath: string | null;
   designUrl?: string | null;
 }[]): Map<string, DesignResolution>;
-//#endregion
 export { DesignCredentialStatus, DesignResolution, DesignSource, normalizeImportPath, resolveDesigns };
 //# sourceMappingURL=design-resolve.d.mts.map

package/dist/models/design-resolve.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/models/design-resolve.ts
+// src/models/design-resolve.ts
 /** Story-file key: path without a leading `./`, so index and manual entries compare equal. */
 function normalizeImportPath(path) {
 	return path.trim().replace(/^(?:\.\/)+/u, "");
@@ -35,7 +35,6 @@ function storyDesigns(snapshots) {
 	}
 	return resolved;
 }
-//#endregion
 export { normalizeImportPath, resolveDesigns };
 
 //# sourceMappingURL=design-resolve.mjs.map

package/dist/models/design.d.mts

@@ -4,7 +4,6 @@ import { DatabaseAdapter } from "../adapter/database.mjs";
 import { DesignProvider } from "../adapter/design.mjs";
 import { DesignLink } from "../schema/design.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/design.d.ts
 /** Tables required by {@link DesignModel}. */
 interface DesignTables {
   designLinks: Table;
@@ -34,6 +33,5 @@ declare class DesignModel {
   private links;
   private insertLink;
 }
-//#endregion
 export { DesignModel, DesignTables };
 //# sourceMappingURL=design.d.mts.map

package/dist/models/design.mjs

@@ -6,7 +6,7 @@ import { ulid } from "../utils/ulid.mjs";
 import { col } from "./columns.mjs";
 import { normalizeImportPath } from "./design-resolve.mjs";
 import { eq } from "drizzle-orm";
-//#region src/models/design.ts
+// src/models/design.ts
 /** Design-source links: project-level design files and per-component (story file) mappings. */
 /** Data operations for design links; URLs are validated by the configured providers. */
 var DesignModel = class {
@@ -84,7 +84,6 @@ var DesignModel = class {
 		});
 	}
 };
-//#endregion
 export { DesignModel };
 
 //# sourceMappingURL=design.mjs.map

package/dist/models/inherited-ratio.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { Build } from "../schema/build.mjs";
-//#region src/models/inherited-ratio.d.ts
 /** Builds the average looks at by default (newest first). */
 declare const RECENT_BUILDS_FOR_INHERITED_RATIO = 20;
 /** The average inherited ratio of a project's recent builds. */
@@ -16,6 +15,5 @@ interface InheritedRatio {
  * does (no data is not a 0 % skip rate). A build with no snapshots has no ratio and is skipped.
  */
 declare function averageInheritedRatio(builds: readonly Pick<Build, "createdAt" | "snapshotCount" | "inheritedCount">[], limit?: number): InheritedRatio | null;
-//#endregion
 export { InheritedRatio, RECENT_BUILDS_FOR_INHERITED_RATIO, averageInheritedRatio };
 //# sourceMappingURL=inherited-ratio.d.mts.map

package/dist/models/inherited-ratio.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/models/inherited-ratio.ts
+// src/models/inherited-ratio.ts
 /** Builds the average looks at by default (newest first). */
 const RECENT_BUILDS_FOR_INHERITED_RATIO = 20;
 /**
@@ -16,7 +16,6 @@ function averageInheritedRatio(builds, limit = 20) {
 		builds: recent.length
 	};
 }
-//#endregion
 export { RECENT_BUILDS_FOR_INHERITED_RATIO, averageInheritedRatio };
 
 //# sourceMappingURL=inherited-ratio.mjs.map