@cellarnode/ui 0.186.0 → 0.188.0

package/dist/brand/brand-assets-api.d.ts

@@ -0,0 +1,58 @@
+import type { ModerationPersistedRead } from "../moderation/index.js";
+import type { BrandAsset, BrandProfileAssetSlot } from "./types.js";
+/** The moderation-relevant fields the backend returns with every asset. */
+export interface BrandAssetModeration {
+    readonly outcome: "pending" | "pass" | "reject" | "unsure" | null;
+    readonly publishedAt: string | null;
+}
+export type BrandAssetRecord = BrandAsset & BrandAssetModeration;
+export interface UploadBrandAssetArgs {
+    readonly profileId: string;
+    readonly slot: BrandProfileAssetSlot;
+    readonly file: File;
+}
+/**
+ * CEL-2127 — the transport-agnostic seam of the brand image/asset flow
+ * (`/brand-profiles/{id}/assets*`, present in both the producer and importer
+ * OpenAPIs). A consumer supplies one implementation: producer may wrap its
+ * generated client, importer uses {@link createBrandAssetsClient}. Cache
+ * invalidation stays with the consumer (wrap `upload`).
+ */
+export interface BrandAssetsApi {
+    /** `GET /brand-profiles/{id}/assets`. */
+    list(profileId: string): Promise<BrandAssetRecord[]>;
+    /** `POST .../assets/upload-url`, `PUT` the file to storage, `POST .../assets/confirm`. */
+    upload(args: UploadBrandAssetArgs): Promise<BrandAssetRecord>;
+    /** `DELETE /brand-profiles/{id}/assets/{assetId}`. */
+    remove(profileId: string, assetId: string): Promise<void>;
+    /**
+     * The durable, asset-id-keyed moderation read the shared moderation operation
+     * falls back to when no live verdict event arrives. `null` when the exact
+     * asset no longer exists; rejects on transport failure so the bounded poll
+     * retries instead of reporting a false outcome.
+     */
+    fetchModeration(profileId: string, assetId: string): Promise<ModerationPersistedRead | null>;
+}
+/** A non-2xx answer, or a failed storage upload, from the assets endpoints. */
+export declare class BrandAssetsRequestError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+export interface BrandAssetsClientOptions {
+    /** API origin (e.g. `http://localhost:4000`). */
+    readonly baseUrl: string;
+    /** Bearer token source. Omit for cookie auth (`credentials: "include"`). */
+    readonly getAccessToken?: () => Promise<string | null>;
+    /** Defaults to the global `fetch`. Used for the API calls only, never for the storage PUT. */
+    readonly fetch?: typeof fetch;
+    /** The injected `fetch` refreshes an expired session itself: never retry a 401 here. */
+    readonly fetchRefreshesSession?: boolean;
+    /** Abort the storage PUT after this long. Default 30000. */
+    readonly uploadTimeoutMs?: number;
+}
+/** Browsers report fonts as octet-stream or empty; the backend whitelists real font MIME types. */
+export declare function resolveBrandAssetMimeType(file: File): string;
+/** The shared HTTP implementation of {@link BrandAssetsApi}. */
+export declare function createBrandAssetsClient(options: BrandAssetsClientOptions): BrandAssetsApi;
+//# sourceMappingURL=brand-assets-api.d.ts.map

package/dist/brand/brand-assets-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-assets-api.d.ts","sourceRoot":"","sources":["../../src/brand/brand-assets-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEjE,2EAA2E;AAC3E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAAC;IAClE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,oBAAoB,CAAC;AAEjE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACrD,0FAA0F;IAC1F,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC9D,sDAAsD;IACtD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D;;;;;OAKG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC;CAC9F;AAED,+EAA+E;AAC/E,qBAAa,uBAAwB,SAAQ,KAAK;IAE9C,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM;gBADZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKlB;AAED,MAAM,WAAW,wBAAwB;IACvC,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvD,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAC9B,wFAAwF;IACxF,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC,4DAA4D;IAC5D,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AASD,mGAAmG;AACnG,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAM5D;AAyCD,gEAAgE;AAChE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,cAAc,CA2HzF"}

package/dist/brand/brand-assets-api.js

@@ -0,0 +1,160 @@
+/** A non-2xx answer, or a failed storage upload, from the assets endpoints. */
+export class BrandAssetsRequestError extends Error {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = "BrandAssetsRequestError";
+    }
+}
+const FONT_MIME_BY_EXTENSION = {
+    woff2: "font/woff2",
+    woff: "font/woff",
+    ttf: "font/ttf",
+    otf: "font/otf",
+};
+/** Browsers report fonts as octet-stream or empty; the backend whitelists real font MIME types. */
+export function resolveBrandAssetMimeType(file) {
+    const extension = file.name.split(".").pop()?.toLowerCase();
+    const fontMime = extension ? FONT_MIME_BY_EXTENSION[extension] : undefined;
+    if (fontMime)
+        return fontMime;
+    if (file.type && file.type !== "application/octet-stream")
+        return file.type;
+    return "application/octet-stream";
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+const OUTCOMES = new Set(["pending", "pass", "reject", "unsure"]);
+function parseAsset(value) {
+    if (!isRecord(value) ||
+        typeof value.id !== "string" ||
+        typeof value.slot !== "string" ||
+        typeof value.fileUrl !== "string") {
+        throw new BrandAssetsRequestError(200, "INVALID_RESPONSE", "Unexpected brand asset response");
+    }
+    const outcome = value.moderationOutcome;
+    return {
+        id: value.id,
+        slot: value.slot,
+        fileUrl: value.fileUrl,
+        fileName: typeof value.fileName === "string" ? value.fileName : "",
+        mimeType: typeof value.mimeType === "string" ? value.mimeType : "",
+        fileSize: typeof value.fileSize === "number" ? value.fileSize : 0,
+        width: typeof value.width === "number" ? value.width : null,
+        height: typeof value.height === "number" ? value.height : null,
+        outcome: typeof outcome === "string" && OUTCOMES.has(outcome) ? outcome : null,
+        publishedAt: typeof value.publishedAt === "string" ? value.publishedAt : null,
+    };
+}
+function errorFields(body, fallback) {
+    if (!isRecord(body))
+        return { code: "UNKNOWN", message: fallback };
+    const nested = isRecord(body.error) ? body.error : body;
+    return {
+        code: typeof nested.code === "string" ? nested.code : "UNKNOWN",
+        message: typeof nested.message === "string" ? nested.message : fallback,
+    };
+}
+/** The shared HTTP implementation of {@link BrandAssetsApi}. */
+export function createBrandAssetsClient(options) {
+    const base = options.baseUrl.replace(/\/+$/, "");
+    const assetsPath = (profileId) => `/brand-profiles/${encodeURIComponent(profileId)}/assets`;
+    async function request(method, path, fallback, body) {
+        const doFetch = options.fetch ?? fetch;
+        const send = async (token) => {
+            const headers = { Accept: "application/json" };
+            if (body !== undefined)
+                headers["Content-Type"] = "application/json";
+            if (token)
+                headers.Authorization = `Bearer ${token}`;
+            return doFetch(`${base}${path}`, {
+                method,
+                headers,
+                ...(options.getAccessToken ? {} : { credentials: "include" }),
+                ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+            });
+        };
+        let response = await send(options.getAccessToken ? await options.getAccessToken() : undefined);
+        if (response.status === 401 && options.getAccessToken && !options.fetchRefreshesSession) {
+            response = await send(await options.getAccessToken());
+        }
+        let parsed;
+        if (response.status !== 204) {
+            try {
+                parsed = await response.json();
+            }
+            catch {
+                parsed = undefined;
+            }
+        }
+        if (!response.ok) {
+            const { code, message } = errorFields(parsed, fallback);
+            throw new BrandAssetsRequestError(response.status, code, message);
+        }
+        return parsed;
+    }
+    async function list(profileId) {
+        const data = await request("GET", assetsPath(profileId), "Failed to list brand assets");
+        if (!isRecord(data) || !Array.isArray(data.assets)) {
+            throw new BrandAssetsRequestError(200, "INVALID_RESPONSE", "Unexpected brand asset list");
+        }
+        return data.assets.map(parseAsset);
+    }
+    return {
+        list,
+        async upload({ profileId, slot, file }) {
+            const mimeType = resolveBrandAssetMimeType(file);
+            const target = await request("POST", `${assetsPath(profileId)}/upload-url`, "Failed to start brand asset upload", { slot, fileName: file.name, mimeType, fileSize: file.size });
+            if (!isRecord(target) ||
+                typeof target.uploadUrl !== "string" ||
+                typeof target.uploadId !== "string") {
+                throw new BrandAssetsRequestError(200, "INVALID_RESPONSE", "Unexpected upload target");
+            }
+            const requiredHeaders = isRecord(target.requiredHeaders)
+                ? target.requiredHeaders
+                : {};
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), options.uploadTimeoutMs ?? 30_000);
+            try {
+                let stored;
+                try {
+                    // Storage is a different origin with a presigned URL: plain fetch,
+                    // never the authenticated one, so no bearer token leaks to it.
+                    stored = await fetch(target.uploadUrl, {
+                        method: "PUT",
+                        headers: requiredHeaders,
+                        body: file,
+                        signal: controller.signal,
+                    });
+                }
+                catch {
+                    throw new BrandAssetsRequestError(0, controller.signal.aborted ? "BRAND_ASSET_UPLOAD_TIMEOUT" : "BRAND_ASSET_UPLOAD_NETWORK", controller.signal.aborted
+                        ? "Upload timed out. Please try again."
+                        : "Network error while uploading. Please check your connection and try again.");
+                }
+                if (!stored.ok) {
+                    throw new BrandAssetsRequestError(stored.status, "BRAND_ASSET_UPLOAD_FAILED", "Failed to upload file to storage");
+                }
+            }
+            finally {
+                clearTimeout(timeoutId);
+            }
+            const confirmed = await request("POST", `${assetsPath(profileId)}/confirm`, "Failed to confirm brand asset upload", { uploadId: target.uploadId, slot, fileName: file.name, mimeType, fileSize: file.size });
+            return parseAsset(confirmed);
+        },
+        async remove(profileId, assetId) {
+            await request("DELETE", `${assetsPath(profileId)}/${encodeURIComponent(assetId)}`, "Failed to delete brand asset");
+        },
+        async fetchModeration(profileId, assetId) {
+            const asset = (await list(profileId)).find((candidate) => candidate.id === assetId);
+            if (!asset)
+                return null;
+            return { identity: asset.id, outcome: asset.outcome, published: asset.publishedAt !== null };
+        },
+    };
+}
+//# sourceMappingURL=brand-assets-api.js.map

package/dist/brand/brand-assets-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-assets-api.js","sourceRoot":"","sources":["../../src/brand/brand-assets-api.ts"],"names":[],"mappings":"AAwCA,+EAA+E;AAC/E,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAErC;IACA;IAFX,YACW,MAAc,EACd,IAAY,EACrB,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAJN,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAQ;QAIrB,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAeD,MAAM,sBAAsB,GAAqC;IAC/D,KAAK,EAAE,YAAY;IACnB,IAAI,EAAE,WAAW;IACjB,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,UAAU;CAChB,CAAC;AAEF,mGAAmG;AACnG,MAAM,UAAU,yBAAyB,CAAC,IAAU;IAClD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC;IAC5D,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3E,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,0BAA0B;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IAC5E,OAAO,0BAA0B,CAAC;AACpC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAElE,SAAS,UAAU,CAAC,KAAc;IAChC,IACE,CAAC,QAAQ,CAAC,KAAK,CAAC;QAChB,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;QAC5B,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EACjC,CAAC;QACD,MAAM,IAAI,uBAAuB,CAAC,GAAG,EAAE,kBAAkB,EAAE,iCAAiC,CAAC,CAAC;IAChG,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,iBAAiB,CAAC;IACxC,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAA6B;QACzC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;QAClE,QAAQ,EAAE,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;QAClE,QAAQ,EAAE,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACjE,KAAK,EAAE,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;QAC3D,MAAM,EAAE,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;QAC9D,OAAO,EAAE,OAAO,OAAO,KAAK,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAE,OAAiB,CAAC,CAAC,CAAC,IAAI;QACzF,WAAW,EAAE,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI;KAC9E,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,IAAa,EAAE,QAAgB;IAClD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IACnE,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACxD,OAAO;QACL,IAAI,EAAE,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QAC/D,OAAO,EAAE,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;KACxE,CAAC;AACJ,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,uBAAuB,CAAC,OAAiC;IACvE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,CAAC,SAAiB,EAAE,EAAE,CACvC,mBAAmB,kBAAkB,CAAC,SAAS,CAAC,SAAS,CAAC;IAE5D,KAAK,UAAU,OAAO,CACpB,MAAiC,EACjC,IAAY,EACZ,QAAgB,EAChB,IAAc;QAEd,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,EAAE,KAAgC,EAAqB,EAAE;YACzE,MAAM,OAAO,GAA2B,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;YACvE,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;YACrE,IAAI,KAAK;gBAAE,OAAO,CAAC,aAAa,GAAG,UAAU,KAAK,EAAE,CAAC;YACrD,OAAO,OAAO,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,EAAE;gBAC/B,MAAM;gBACN,OAAO;gBACP,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,SAAkB,EAAE,CAAC;gBACtE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;aAC9D,CAAC,CAAC;QACL,CAAC,CAAC;QACF,IAAI,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC/F,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,OAAO,CAAC,cAAc,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC;YACxF,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,MAAe,CAAC;QACpB,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACjC,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,GAAG,SAAS,CAAC;YACrB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACxD,MAAM,IAAI,uBAAuB,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,UAAU,IAAI,CAAC,SAAiB;QACnC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,6BAA6B,CAAC,CAAC;QACxF,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,uBAAuB,CAAC,GAAG,EAAE,kBAAkB,EAAE,6BAA6B,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;IAED,OAAO;QACL,IAAI;QACJ,KAAK,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE;YACpC,MAAM,QAAQ,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,MAAM,EACN,GAAG,UAAU,CAAC,SAAS,CAAC,aAAa,EACrC,oCAAoC,EACpC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAC7D,CAAC;YACF,IACE,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACjB,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;gBACpC,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,EACnC,CAAC;gBACD,MAAM,IAAI,uBAAuB,CAAC,GAAG,EAAE,kBAAkB,EAAE,0BAA0B,CAAC,CAAC;YACzF,CAAC;YACD,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,eAAe,CAAC;gBACtD,CAAC,CAAE,MAAM,CAAC,eAA0C;gBACpD,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,eAAe,IAAI,MAAM,CAAC,CAAC;YAC1F,IAAI,CAAC;gBACH,IAAI,MAAgB,CAAC;gBACrB,IAAI,CAAC;oBACH,mEAAmE;oBACnE,+DAA+D;oBAC/D,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE;wBACrC,MAAM,EAAE,KAAK;wBACb,OAAO,EAAE,eAAe;wBACxB,IAAI,EAAE,IAAI;wBACV,MAAM,EAAE,UAAU,CAAC,MAAM;qBAC1B,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,IAAI,uBAAuB,CAC/B,CAAC,EACD,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,4BAA4B,EACvF,UAAU,CAAC,MAAM,CAAC,OAAO;wBACvB,CAAC,CAAC,qCAAqC;wBACvC,CAAC,CAAC,4EAA4E,CACjF,CAAC;gBACJ,CAAC;gBACD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;oBACf,MAAM,IAAI,uBAAuB,CAC/B,MAAM,CAAC,MAAM,EACb,2BAA2B,EAC3B,kCAAkC,CACnC,CAAC;gBACJ,CAAC;YACH,CAAC;oBAAS,CAAC;gBACT,YAAY,CAAC,SAAS,CAAC,CAAC;YAC1B,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,OAAO,CAC7B,MAAM,EACN,GAAG,UAAU,CAAC,SAAS,CAAC,UAAU,EAClC,sCAAsC,EACtC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CACxF,CAAC;YACF,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO;YAC7B,MAAM,OAAO,CACX,QAAQ,EACR,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,kBAAkB,CAAC,OAAO,CAAC,EAAE,EACzD,8BAA8B,CAC/B,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,eAAe,CAAC,SAAS,EAAE,OAAO;YACtC,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;YACpF,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;YACxB,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QAC/F,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/brand/brand-generation-api.d.ts

@@ -0,0 +1,44 @@
+import type { BrandGenerationActiveResult, BrandGenerationContext, BrandGenerationJob, BrandGenerationStartResponse } from "./brand-generation-response.js";
+/**
+ * The transport-agnostic seam of the shared generation flow. A consumer
+ * supplies one implementation; the hook never touches `fetch` for these calls.
+ * Producer wraps its generated openapi client; importer uses
+ * `createBrandGenerationClient`. Both talk to the same backend endpoints.
+ *
+ * Every method rejects on failure (the hook maps a rejection to its error
+ * kind) and resolves already-parsed values.
+ */
+export interface BrandGenerationApi {
+    /** `POST /brand-profiles/generate/`. Retry is a start with amended context. */
+    start(homepageUrl: string, context?: BrandGenerationContext): Promise<BrandGenerationStartResponse>;
+    /** `GET /brand-profiles/generate/active?includeTerminal=`. */
+    getActive(includeTerminal?: boolean): Promise<BrandGenerationActiveResult>;
+    /** `GET /brand-profiles/generate/{jobId}`. */
+    getStatus(jobId: string): Promise<BrandGenerationJob>;
+    /** `PUT /brand-profiles/generate/{jobId}/cancel`. */
+    cancel(jobId: string): Promise<BrandGenerationJob>;
+    /** `PUT /brand-profiles/generate/{jobId}/prioritize-url`. */
+    prioritizeUrl(jobId: string, url: string): Promise<BrandGenerationJob>;
+    /** `PUT /brand-profiles/generate/{jobId}/accept`. */
+    accept(jobId: string): Promise<BrandGenerationJob>;
+}
+/**
+ * How the SSE stream (`GET /brand-profiles/generate/{jobId}/stream`) is opened.
+ *
+ * - Bearer mode: pass `getAccessToken`. A `null` token means "no session
+ *   token available", which degrades to polling exactly like producer.
+ * - Cookie mode: omit `getAccessToken`; the stream is opened with
+ *   `credentials: "include"` and no Authorization header.
+ */
+export interface BrandGenerationStreamConfig {
+    /** API origin, no trailing slash needed (e.g. `http://localhost:4000`). */
+    readonly baseUrl: string;
+    readonly getAccessToken?: () => Promise<string | null>;
+    /** Defaults to the global `fetch`. */
+    readonly fetch?: typeof fetch;
+    /** Idle ms before a silent stream is abandoned for polling. Default 15000. */
+    readonly idleTimeoutMs?: number;
+    /** Status poll interval while degraded. Default 2000. */
+    readonly pollIntervalMs?: number;
+}
+//# sourceMappingURL=brand-generation-api.d.ts.map

package/dist/brand/brand-generation-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-generation-api.d.ts","sourceRoot":"","sources":["../../src/brand/brand-generation-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,sBAAsB,EACtB,kBAAkB,EAClB,4BAA4B,EAC7B,MAAM,6BAA6B,CAAC;AAErC;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,KAAK,CACH,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACzC,8DAA8D;IAC9D,SAAS,CAAC,eAAe,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC3E,8CAA8C;IAC9C,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACtD,qDAAqD;IACrD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACnD,6DAA6D;IAC7D,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACvE,qDAAqD;IACrD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACpD;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B;IAC1C,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvD,sCAAsC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,yDAAyD;IACzD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC"}

package/dist/brand/brand-generation-api.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=brand-generation-api.js.map

package/dist/brand/brand-generation-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-generation-api.js","sourceRoot":"","sources":["../../src/brand/brand-generation-api.ts"],"names":[],"mappings":""}

package/dist/brand/brand-generation-client.d.ts

@@ -0,0 +1,36 @@
+import type { BrandGenerationApi } from "./brand-generation-api.js";
+/** A non-2xx answer from a generation endpoint. */
+export declare class BrandGenerationRequestError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+export interface BrandGenerationClientOptions {
+    /** API origin (e.g. `http://localhost:4000`). */
+    readonly baseUrl: string;
+    /** Bearer token source. Omit for cookie auth (`credentials: "include"`). */
+    readonly getAccessToken?: () => Promise<string | null>;
+    /**
+     * Defaults to the global `fetch`. Pass the consumer's authenticated fetch
+     * (the one that refreshes an expired session) here: it owns refresh. With
+     * `getAccessToken` the client additionally retries ONCE on a 401, asking
+     * `getAccessToken` for a fresh token, so a consumer whose token getter
+     * refreshes needs no custom fetch.
+     */
+    readonly fetch?: typeof fetch;
+    /**
+     * Set when the injected `fetch` already refreshes an expired session and
+     * retries the request itself. The client then NEVER retries a 401: stacking
+     * its own retry on top of the consumer's would send a persistent 401 twice
+     * (2x2 requests) and hammer the refresh endpoint. Only meaningful together
+     * with `fetch`; default `false`.
+     */
+    readonly fetchRefreshesSession?: boolean;
+}
+/**
+ * The shared HTTP implementation of {@link BrandGenerationApi}. It parses every
+ * response with the same strict parsers producer uses, so a wire drift fails
+ * the same way in every consumer instead of rendering a half-valid job.
+ */
+export declare function createBrandGenerationClient(options: BrandGenerationClientOptions): BrandGenerationApi;
+//# sourceMappingURL=brand-generation-client.d.ts.map

package/dist/brand/brand-generation-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-generation-client.d.ts","sourceRoot":"","sources":["../../src/brand/brand-generation-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AASjE,mDAAmD;AACnD,qBAAa,2BAA4B,SAAQ,KAAK;IAElD,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM;gBADZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKlB;AAED,MAAM,WAAW,4BAA4B;IAC3C,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvD;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAC9B;;;;;;OAMG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAC1C;AAyBD;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,GACpC,kBAAkB,CA+EpB"}

package/dist/brand/brand-generation-client.js

@@ -0,0 +1,107 @@
+import { BrandGenerationResponseError, parseActiveEnvelope, parseJob, parseStart, } from "./brand-generation-response.js";
+/** A non-2xx answer from a generation endpoint. */
+export class BrandGenerationRequestError extends Error {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = "BrandGenerationRequestError";
+    }
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function errorFields(body, fallback) {
+    if (!isRecord(body))
+        return { code: "UNKNOWN", message: fallback };
+    const nested = isRecord(body.error) ? body.error : body;
+    return {
+        code: typeof nested.code === "string" ? nested.code : "UNKNOWN",
+        message: typeof nested.message === "string"
+            ? nested.message
+            : typeof body.message === "string"
+                ? body.message
+                : fallback,
+    };
+}
+function toWireContext(context) {
+    const { focusUrls, ...rest } = context;
+    return focusUrls === undefined ? rest : { ...rest, focusUrls: [...focusUrls] };
+}
+/**
+ * The shared HTTP implementation of {@link BrandGenerationApi}. It parses every
+ * response with the same strict parsers producer uses, so a wire drift fails
+ * the same way in every consumer instead of rendering a half-valid job.
+ */
+export function createBrandGenerationClient(options) {
+    const base = options.baseUrl.replace(/\/+$/, "");
+    async function request(method, path, fallback, body) {
+        const doFetch = options.fetch ?? fetch;
+        const send = async (token) => {
+            const headers = { Accept: "application/json" };
+            if (body !== undefined)
+                headers["Content-Type"] = "application/json";
+            if (token)
+                headers.Authorization = `Bearer ${token}`;
+            return doFetch(`${base}${path}`, {
+                method,
+                headers,
+                ...(options.getAccessToken ? {} : { credentials: "include" }),
+                ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+            });
+        };
+        let response = await send(options.getAccessToken ? await options.getAccessToken() : undefined);
+        if (response.status === 401 && options.getAccessToken && !options.fetchRefreshesSession) {
+            // The token may have expired between read and send; ask again (a
+            // refreshing getter returns a new one) and retry exactly once.
+            response = await send(await options.getAccessToken());
+        }
+        if (response.status === 204)
+            return { status: 204, data: undefined };
+        let parsed;
+        try {
+            parsed = await response.json();
+        }
+        catch {
+            parsed = undefined;
+        }
+        if (!response.ok) {
+            const { code, message } = errorFields(parsed, fallback);
+            throw new BrandGenerationRequestError(response.status, code, message);
+        }
+        return { status: response.status, data: parsed };
+    }
+    async function job(method, path, fallback, body) {
+        const { status, data } = await request(method, path, fallback, body);
+        const parsed = parseJob(data, false);
+        if (parsed === null)
+            throw new BrandGenerationResponseError(status);
+        return parsed;
+    }
+    const jobPath = (jobId) => `/brand-profiles/generate/${encodeURIComponent(jobId)}`;
+    return {
+        async start(homepageUrl, context) {
+            const { status, data } = await request("POST", "/brand-profiles/generate/", "Failed to start brand generation", context === undefined ? { homepageUrl } : { homepageUrl, context: toWireContext(context) });
+            const start = parseStart(data);
+            if (start === null)
+                throw new BrandGenerationResponseError(status);
+            return start;
+        },
+        async getActive(includeTerminal = false) {
+            const { status, data } = await request("GET", `/brand-profiles/generate/active?includeTerminal=${includeTerminal}`, "Failed to get active brand generation");
+            if (status === 204)
+                return { job: null, eligibility: null };
+            const result = parseActiveEnvelope(data);
+            if (result === null)
+                throw new BrandGenerationResponseError(status);
+            return result;
+        },
+        getStatus: (jobId) => job("GET", jobPath(jobId), "Failed to get job status"),
+        cancel: (jobId) => job("PUT", `${jobPath(jobId)}/cancel`, "Failed to cancel brand generation"),
+        prioritizeUrl: (jobId, url) => job("PUT", `${jobPath(jobId)}/prioritize-url`, "Failed to prioritize URL", { url }),
+        accept: (jobId) => job("PUT", `${jobPath(jobId)}/accept`, "Failed to accept brand generation"),
+    };
+}
+//# sourceMappingURL=brand-generation-client.js.map

package/dist/brand/brand-generation-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-generation-client.js","sourceRoot":"","sources":["../../src/brand/brand-generation-client.ts"],"names":[],"mappings":"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"}

package/dist/brand/brand-generation-copy.d.ts

@@ -0,0 +1,44 @@
+import { type BrandProfilePageChecklistCopy } from "../components/brand-profile-page-checklist.js";
+import type { MultiStepLoaderCopy } from "../components/multi-step-loader.js";
+import type { BrandGenerationErrorKind } from "./brand-generation-keys.js";
+import type { BrandGenerationRecoveryCopy } from "./brand-generation-recovery-copy.js";
+import type { BrandPersona } from "./types.js";
+/**
+ * Every string `BrandGenerationProgress` / `BrandGenerationSurface` render.
+ * The package does not do i18n: a consumer passes already translated strings
+ * (producer through `t()`), or relies on the English defaults below.
+ */
+export interface BrandGenerationCopy {
+    readonly title: string;
+    readonly subtitle: string;
+    readonly transportDegraded: string;
+    readonly cancelAction: string;
+    readonly eligibilityUnavailable: string;
+    /** Sub-label on a re-crawl pass, e.g. "pass 2". */
+    readonly passLabel: (pass: number) => string;
+    /** Rail labels keyed by generation phase. */
+    readonly phaseLabels: Readonly<Record<"mapping" | "selecting" | "crawling" | "consolidating" | "finalizing", string>>;
+    readonly errors: Readonly<Record<BrandGenerationErrorKind, string>>;
+    readonly checklist: BrandProfilePageChecklistCopy;
+    /** Step rail: the live-region announcement and the list's accessible name. */
+    readonly stepper: Required<MultiStepLoaderCopy>;
+    /** Accessible name of the placeholder rail shown before the first phase. */
+    readonly loadingStepsLabel: string;
+    /** Merged over `DEFAULT_BRAND_GENERATION_RECOVERY_COPY`. */
+    readonly recovery: BrandGenerationRecoveryCopy;
+    /** Shown when recovering an in-progress job failed (`discoveryError`). */
+    readonly recoveryFailed: string;
+    /** Review-step actions of `BrandGenerationSurface`. */
+    readonly acceptAction: string;
+    readonly acceptingAction: string;
+    readonly dismissAction: string;
+}
+/**
+ * Default copy for a persona. Importer and distributor orgs are the "importer"
+ * persona; they read their own company website, so the wording says so. Every
+ * other string is shared, which is the point: one flow, two voices, no drift.
+ */
+export declare function defaultBrandGenerationCopy(persona?: BrandPersona): BrandGenerationCopy;
+/** Overlay a consumer's partial copy on the persona defaults. */
+export declare function resolveBrandGenerationCopy(persona: BrandPersona, copy?: Partial<BrandGenerationCopy>): BrandGenerationCopy;
+//# sourceMappingURL=brand-generation-copy.d.ts.map

package/dist/brand/brand-generation-copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-generation-copy.d.ts","sourceRoot":"","sources":["../../src/brand/brand-generation-copy.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,4CAA4C,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7C,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAC5B,MAAM,CAAC,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,eAAe,GAAG,YAAY,EAAE,MAAM,CAAC,CACtF,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC,CAAC;IACpE,QAAQ,CAAC,SAAS,EAAE,6BAA6B,CAAC;IAClD,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IAChD,4EAA4E;IAC5E,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;IAC/C,0EAA0E;IAC1E,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,uDAAuD;IACvD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AA2CD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,YAAyB,GACjC,mBAAmB,CAQrB;AAED,iEAAiE;AACjE,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,YAAY,EACrB,IAAI,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAClC,mBAAmB,CAYrB"}

package/dist/brand/brand-generation-copy.js

@@ -0,0 +1,70 @@
+import { defaultBrandProfilePageChecklistCopy, } from "../components/brand-profile-page-checklist.js";
+const PRODUCER_COPY = {
+    title: "Generating Brand Profile",
+    subtitle: "We are analyzing your website to build a complete brand profile.",
+    transportDegraded: "Live updates degraded, refreshing every 2s",
+    cancelAction: "Cancel",
+    eligibilityUnavailable: "Generation is unavailable right now. Try again later or create your profile manually.",
+    passLabel: (pass) => `pass ${pass}`,
+    phaseLabels: {
+        mapping: "Mapping your website",
+        selecting: "Choosing pages to read",
+        crawling: "Crawling and reading pages",
+        consolidating: "Consolidating information",
+        finalizing: "Saving draft",
+    },
+    errors: {
+        start: "Could not start generation. Try again.",
+        cancel: "Could not cancel generation. Try again.",
+        prioritize: "Could not prioritize this page. Try again.",
+        accept: "Could not accept profile. Try again.",
+        resume: "Could not resume generation. Try again.",
+    },
+    checklist: defaultBrandProfilePageChecklistCopy,
+    stepper: {
+        announceLabel: (current, total, label) => `Step ${current} of ${total}: ${label}`,
+        stepsLabel: "Process steps",
+    },
+    loadingStepsLabel: "Loading steps",
+    recovery: {
+        failedHeading: "Generation Failed",
+        failedBody: "An unknown error occurred.",
+        retryAction: "Retry",
+        createManuallyAction: "Cancel",
+        cancelAction: "Cancel",
+    },
+    recoveryFailed: "Could not recover an in-progress generation. Refresh the page to try again.",
+    acceptAction: "Accept Profile",
+    acceptingAction: "Accepting...",
+    dismissAction: "Dismiss",
+};
+/**
+ * Default copy for a persona. Importer and distributor orgs are the "importer"
+ * persona; they read their own company website, so the wording says so. Every
+ * other string is shared, which is the point: one flow, two voices, no drift.
+ */
+export function defaultBrandGenerationCopy(persona = "producer") {
+    if (persona === "importer") {
+        return {
+            ...PRODUCER_COPY,
+            subtitle: "We are analyzing your company website to build a complete brand profile.",
+        };
+    }
+    return PRODUCER_COPY;
+}
+/** Overlay a consumer's partial copy on the persona defaults. */
+export function resolveBrandGenerationCopy(persona, copy) {
+    const base = defaultBrandGenerationCopy(persona);
+    if (!copy)
+        return base;
+    return {
+        ...base,
+        ...copy,
+        phaseLabels: { ...base.phaseLabels, ...copy.phaseLabels },
+        errors: { ...base.errors, ...copy.errors },
+        checklist: { ...base.checklist, ...copy.checklist },
+        stepper: { ...base.stepper, ...copy.stepper },
+        recovery: { ...base.recovery, ...copy.recovery },
+    };
+}
+//# sourceMappingURL=brand-generation-copy.js.map

package/dist/brand/brand-generation-copy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-generation-copy.js","sourceRoot":"","sources":["../../src/brand/brand-generation-copy.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oCAAoC,GAErC,MAAM,4CAA4C,CAAC;AAuCpD,MAAM,aAAa,GAAwB;IACzC,KAAK,EAAE,0BAA0B;IACjC,QAAQ,EAAE,kEAAkE;IAC5E,iBAAiB,EAAE,4CAA4C;IAC/D,YAAY,EAAE,QAAQ;IACtB,sBAAsB,EACpB,uFAAuF;IACzF,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,IAAI,EAAE;IACnC,WAAW,EAAE;QACX,OAAO,EAAE,sBAAsB;QAC/B,SAAS,EAAE,wBAAwB;QACnC,QAAQ,EAAE,4BAA4B;QACtC,aAAa,EAAE,2BAA2B;QAC1C,UAAU,EAAE,cAAc;KAC3B;IACD,MAAM,EAAE;QACN,KAAK,EAAE,wCAAwC;QAC/C,MAAM,EAAE,yCAAyC;QACjD,UAAU,EAAE,4CAA4C;QACxD,MAAM,EAAE,sCAAsC;QAC9C,MAAM,EAAE,yCAAyC;KAClD;IACD,SAAS,EAAE,oCAAoC;IAC/C,OAAO,EAAE;QACP,aAAa,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,OAAO,OAAO,KAAK,KAAK,KAAK,EAAE;QACjF,UAAU,EAAE,eAAe;KAC5B;IACD,iBAAiB,EAAE,eAAe;IAClC,QAAQ,EAAE;QACR,aAAa,EAAE,mBAAmB;QAClC,UAAU,EAAE,4BAA4B;QACxC,WAAW,EAAE,OAAO;QACpB,oBAAoB,EAAE,QAAQ;QAC9B,YAAY,EAAE,QAAQ;KACvB;IACD,cAAc,EAAE,6EAA6E;IAC7F,YAAY,EAAE,gBAAgB;IAC9B,eAAe,EAAE,cAAc;IAC/B,aAAa,EAAE,SAAS;CACzB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAAwB,UAAU;IAElC,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,OAAO;YACL,GAAG,aAAa;YAChB,QAAQ,EAAE,0EAA0E;SACrF,CAAC;IACJ,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,0BAA0B,CACxC,OAAqB,EACrB,IAAmC;IAEnC,MAAM,IAAI,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO;QACL,GAAG,IAAI;QACP,GAAG,IAAI;QACP,WAAW,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE;QACzD,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE;QAC1C,SAAS,EAAE,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE;QACnD,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE;QAC7C,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE;KACjD,CAAC;AACJ,CAAC"}

package/dist/brand/brand-generation-fixtures.d.ts

@@ -0,0 +1,32 @@
+import type { BrandGenerationApi } from "./brand-generation-api.js";
+import type { BrandGenerationEligibility, BrandGenerationJob, BrandGenerationJobProgress } from "./brand-generation-response.js";
+/** Fixtures for the generation flow's tests and stories. Not a public export. */
+export declare const IDLE_ELIGIBILITY: BrandGenerationEligibility;
+export declare function makeJob(overrides?: Partial<BrandGenerationJob>): BrandGenerationJob;
+export declare function makeProgress(phase: NonNullable<BrandGenerationJobProgress["phase"]>, extra?: Partial<BrandGenerationJobProgress>): BrandGenerationJobProgress;
+/** One `text/event-stream` frame for a job update. */
+export declare function sseFrame(update: Record<string, unknown>): string;
+export interface FakeStream {
+    /** The `fetch` to inject. Records every call in `calls`. */
+    readonly fetch: typeof fetch;
+    readonly calls: {
+        url: string;
+        init: RequestInit | undefined;
+    }[];
+    /** Push a frame to the open stream. */
+    push(frame: string): void;
+    /** End the open stream normally (without a terminal update). */
+    end(): void;
+    /** Error the open stream mid-read. */
+    fail(error: Error): void;
+    /** True once the consumer aborted the open request. */
+    readonly aborted: () => boolean;
+}
+/** A controllable SSE endpoint: one open stream per `fetch` call, driven by the test. */
+export declare function createFakeStream(options?: {
+    status?: number;
+    fetchError?: Error;
+}): FakeStream;
+/** A `BrandGenerationApi` whose every method is a configurable stub. */
+export declare function createFakeApi(overrides?: Partial<BrandGenerationApi>): BrandGenerationApi;
+//# sourceMappingURL=brand-generation-fixtures.d.ts.map

package/dist/brand/brand-generation-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-generation-fixtures.d.ts","sourceRoot":"","sources":["../../src/brand/brand-generation-fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAEV,0BAA0B,EAC1B,kBAAkB,EAClB,0BAA0B,EAC3B,MAAM,6BAA6B,CAAC;AAErC,iFAAiF;AAEjF,eAAO,MAAM,gBAAgB,EAAE,0BAM9B,CAAC;AAEF,wBAAgB,OAAO,CAAC,SAAS,GAAE,OAAO,CAAC,kBAAkB,CAAM,GAAG,kBAAkB,CAWvF;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,EACvD,KAAK,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAC9C,0BAA0B,CAE5B;AAED,sDAAsD;AACtD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEhE;AAWD,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,WAAW,GAAG,SAAS,CAAA;KAAE,EAAE,CAAC;IACjE,uCAAuC;IACvC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gEAAgE;IAChE,GAAG,IAAI,IAAI,CAAC;IACZ,sCAAsC;IACtC,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACzB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;CACjC;AAED,yFAAyF;AACzF,wBAAgB,gBAAgB,CAC9B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAA;CAAO,GACpD,UAAU,CAoCZ;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,SAAS,GAAE,OAAO,CAAC,kBAAkB,CAAM,GAAG,kBAAkB,CAW7F"}