@cellarnode/ui 0.186.0 → 0.188.0

package/dist/brand/use-brand-image-operation-result.js

@@ -0,0 +1,162 @@
+import { useCallback, useMemo, useRef, useState } from "react";
+import { GIVE_UP_AFTER_MS, useModerationCheckControls, useModerationOperation, } from "../moderation/index.js";
+/**
+ * CEL-2127 (from producer, CEL-1682/CEL-1681) — maps the CEL-1320 moderation read model's 8-state
+ * `ModerationStatus` (checking/passed/rejected/in-review/
+ * approved-after-review/changes-requested/unpublished/escalated) onto
+ * `BrandImageChooser`'s narrower `BrandImageOperationStatus` contract
+ * (saved/checking/passed/rejected/unknown/error). A future backend status
+ * this map doesn't know about degrades to "unknown" rather than being
+ * dropped, mirroring the shared event parser's forward-compatibility
+ * stance.
+ */
+function mapModerationStatus(status) {
+    switch (status) {
+        case "checking":
+        case "in-review":
+            return "checking";
+        case "passed":
+        case "approved-after-review":
+            return "passed";
+        case "rejected":
+        case "changes-requested":
+            return "rejected";
+        default:
+            return "unknown";
+    }
+}
+/**
+ * A server verdict may be stamped slightly before the client's own clock. Kept
+ * small: it is also the window in which a leftover verdict for a previous
+ * upload could be mistaken for this one when the event carries no `assetId`.
+ */
+const CLOCK_SKEW_TOLERANCE_MS = 2_000;
+/**
+ * Owns the chooser's current upload identity and adapts the shared moderation
+ * operation (including its exact-asset durable read) to the chooser result.
+ */
+export function useBrandImageOperationResult(
+/**
+ * The durable, asset-id-keyed read (`BrandAssetsApi.fetchModeration`) used
+ * when no live verdict event arrives.
+ */
+fetchModeration) {
+    const [operation, setOperation] = useState(null);
+    const { markChecking, clearChecking, beginOperation: beginStoreOperation, } = useModerationCheckControls();
+    const beganAtRef = useRef(null);
+    // Read through a ref: an inline `fetchModeration` must not change
+    // `fetchPersisted`'s identity every render and restart the durable poll.
+    const fetchModerationRef = useRef(fetchModeration);
+    fetchModerationRef.current = fetchModeration;
+    const fetchPersisted = useMemo(() => {
+        const profileId = operation?.subject.brandProfileId;
+        return profileId && operation
+            ? () => fetchModerationRef.current(profileId, operation.id)
+            : undefined;
+    }, [operation]);
+    const subjectState = useModerationOperation({
+        match: operation?.subject ?? null,
+        identity: operation?.id,
+        fetchPersisted,
+    });
+    const startOperation = useCallback((operationId, subject, startSeq) => {
+        const now = Date.now();
+        // An inline verdict is published while the upload request is in flight,
+        // i.e. BEFORE `now`; anchor staleness at when the request began (minus
+        // clock skew), not at when its response came back.
+        // Only a begin that this start is paired with (it carries the store's
+        // `startSeq`) counts; a begin whose upload failed must not leak into
+        // a later, unrelated operation.
+        const began = startSeq !== undefined ? (beganAtRef.current ?? now) : now;
+        beganAtRef.current = null;
+        setOperation({
+            id: operationId,
+            subject,
+            appliedAt: now,
+            notBefore: began - CLOCK_SKEW_TOLERANCE_MS,
+        });
+        markChecking(subject, operationId, startSeq);
+    }, [markChecking]);
+    const beginOperation = useCallback(() => {
+        beganAtRef.current = Date.now();
+        return beginStoreOperation();
+    }, [beginStoreOperation]);
+    const reset = useCallback(() => {
+        setOperation((current) => {
+            if (current)
+                clearChecking(current.subject);
+            return null;
+        });
+    }, [clearChecking]);
+    const operationResult = useMemo(() => {
+        if (!operation)
+            return null;
+        // A verdict landed for this subject. Guard against a STALE result from a
+        // PREVIOUS operation on the same slot (e.g. re-uploading a rejected
+        // banner) — the chooser's own contract: "old verdict cannot complete
+        // newer upload." An event older than this operation's start is ignored,
+        // falling through to the in-flight branches below. CEL-1682 review
+        // fixup (reviewer A, P3): an UNPARSEABLE `occurredAt` must also count as
+        // stale — `Number.isFinite(NaN)` is `false`, so the original
+        // `finite && older` test let a malformed prior verdict slip through as
+        // "not stale" and complete a newer, still-in-flight upload.
+        if (subjectState.event) {
+            const event = subjectState.event;
+            // A verdict that names its asset is matched EXACTLY: it belongs to this
+            // operation iff it is this asset's, whatever the clocks say. A verdict
+            // that does not (the wire cannot always carry it) is matched on slot
+            // alone, so it must also not predate this operation: one older than the
+            // upload's start is a leftover from a PREVIOUS upload into the same slot
+            // ("old verdict cannot complete newer upload"). An unparseable
+            // `occurredAt` counts as stale for the same reason.
+            let isStale;
+            if (event.subject?.assetId !== undefined) {
+                isStale = event.subject.assetId !== operation.id;
+            }
+            else {
+                const eventTime = Date.parse(event.occurredAt);
+                isStale = !Number.isFinite(eventTime) || eventTime < operation.notBefore;
+            }
+            if (!isStale) {
+                const status = mapModerationStatus(subjectState.event.state);
+                return {
+                    status,
+                    operationId: operation.id,
+                    reason: status === "rejected"
+                        ? (subjectState.event.detail ?? subjectState.event.headline ?? null)
+                        : undefined,
+                };
+            }
+        }
+        if (subjectState.status === "checking") {
+            return {
+                status: subjectState.slow ? "unknown" : "checking",
+                operationId: operation.id,
+            };
+        }
+        // A durable, asset-id-keyed read may resolve without a live event. The
+        // shared operation reconciler gives that answer precedence over a stale
+        // same-slot event; the chooser receives only the coarse status here.
+        if (subjectState.persistedOnly && subjectState.status) {
+            return { status: mapModerationStatus(subjectState.status), operationId: operation.id };
+        }
+        if (subjectState.status === "unknown" && !subjectState.event) {
+            return { status: "unknown", operationId: operation.id };
+        }
+        // No event yet, no local pending mark. Either `markChecking` hasn't run
+        // yet (a same-tick gap right after `startOperation`) or the store gave
+        // up waiting after GIVE_UP_AFTER_MS and dropped the mark — the store
+        // itself no longer distinguishes those, so use this operation's own
+        // `appliedAt` timestamp to tell them apart. This is a `useMemo`, so
+        // noticing the GIVE_UP transition depends on getting a fresh render —
+        // in practice the shared store's sweep interval delivers one while any
+        // check is pending, including the tick that drops the mark. This never polls
+        // `Date.now()` on its own between renders.
+        if (Date.now() - operation.appliedAt > GIVE_UP_AFTER_MS) {
+            return { status: "unknown", operationId: operation.id };
+        }
+        return { status: "saved", operationId: operation.id };
+    }, [operation, subjectState]);
+    return { operationResult, startOperation, beginOperation, reset };
+}
+//# sourceMappingURL=use-brand-image-operation-result.js.map

package/dist/brand/use-brand-image-operation-result.js.map

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

package/dist/brand/use-brand-profile-acceptance.d.ts

@@ -0,0 +1,38 @@
+import type { UseBrandGenerationResult } from "./use-brand-generation.js";
+export interface BrandWorkspaceNotice {
+    readonly tone: "success" | "error" | "info";
+    readonly message: string;
+}
+export interface BrandProfileAcceptanceCopy {
+    readonly acceptFailed: string;
+    readonly acceptEarlyRequested: string;
+    readonly acceptRunIncomplete: string;
+    readonly accepted: string;
+}
+export declare const DEFAULT_BRAND_PROFILE_ACCEPTANCE_COPY: BrandProfileAcceptanceCopy;
+export interface UseBrandProfileAcceptanceOptions {
+    readonly orgId: string;
+    readonly brandGeneration: Pick<UseBrandGenerationResult, "job" | "accept" | "reset">;
+    /**
+     * Approves the generated draft (the injected data layer). With TanStack
+     * Query: `(handlers) => approve.mutate(undefined, handlers)`.
+     */
+    readonly approve: (handlers: {
+        onSuccess: () => void;
+        onError: () => void;
+    }) => void;
+    readonly notify?: (notice: BrandWorkspaceNotice) => void;
+    readonly copy?: Partial<BrandProfileAcceptanceCopy>;
+}
+/**
+ * CEL-2127 — "Accept profile" for a generated draft, shared by producer and
+ * importer. While the run is still going it asks the backend to wrap up
+ * (early accept); once completed it approves the draft and resets the flow.
+ * Either path is single-flight per org and never reports into another org's
+ * session after an org switch.
+ */
+export declare function useBrandProfileAcceptance({ orgId, brandGeneration, approve, notify, copy, }: UseBrandProfileAcceptanceOptions): {
+    accept: () => void;
+    signalPending: boolean;
+};
+//# sourceMappingURL=use-brand-profile-acceptance.d.ts.map

package/dist/brand/use-brand-profile-acceptance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-brand-profile-acceptance.d.ts","sourceRoot":"","sources":["../../src/brand/use-brand-profile-acceptance.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAEvE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,qCAAqC,EAAE,0BAMnD,CAAC;AAEF,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAC,wBAAwB,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC,CAAC;IACrF;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAAE,SAAS,EAAE,MAAM,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,KAAK,IAAI,CAAC;IACrF,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACzD,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACrD;AAID;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,EACxC,KAAK,EACL,eAAe,EACf,OAAO,EACP,MAAM,EACN,IAAI,GACL,EAAE,gCAAgC;;;EA4DlC"}

package/dist/brand/use-brand-profile-acceptance.js

@@ -0,0 +1,84 @@
+import { useRef, useState } from "react";
+import { isTerminalStatus } from "./brand-generation-keys.js";
+export const DEFAULT_BRAND_PROFILE_ACCEPTANCE_COPY = {
+    acceptFailed: "Failed to accept profile",
+    acceptEarlyRequested: "Wrapping up the current run",
+    acceptRunIncomplete: "This run did not finish, so there is no new profile to accept. Retry generation.",
+    accepted: "Profile accepted",
+};
+/**
+ * CEL-2127 — "Accept profile" for a generated draft, shared by producer and
+ * importer. While the run is still going it asks the backend to wrap up
+ * (early accept); once completed it approves the draft and resets the flow.
+ * Either path is single-flight per org and never reports into another org's
+ * session after an org switch.
+ */
+export function useBrandProfileAcceptance({ orgId, brandGeneration, approve, notify, copy, }) {
+    const text = { ...DEFAULT_BRAND_PROFILE_ACCEPTANCE_COPY, ...copy };
+    const [signalPendingState, setSignalPendingState] = useState(null);
+    const pendingActionRef = useRef(null);
+    const currentOrgIdRef = useRef(orgId);
+    currentOrgIdRef.current = orgId;
+    const signalPending = signalPendingState?.orgId === orgId;
+    const beginPendingAction = () => {
+        if (pendingActionRef.current?.orgId === orgId)
+            return null;
+        const action = { orgId };
+        pendingActionRef.current = action;
+        setSignalPendingState(action);
+        return action;
+    };
+    const finishPendingAction = (action) => {
+        if (pendingActionRef.current === action)
+            pendingActionRef.current = null;
+        setSignalPendingState((pending) => (pending === action ? null : pending));
+    };
+    const stillCurrent = (action) => currentOrgIdRef.current === action.orgId;
+    const accept = () => {
+        const job = brandGeneration.job;
+        if (job && !isTerminalStatus(job.status)) {
+            const action = beginPendingAction();
+            if (!action)
+                return;
+            brandGeneration
+                .accept()
+                .then((accepted) => {
+                if (!stillCurrent(action))
+                    return;
+                if (accepted === false)
+                    notify?.({ tone: "error", message: text.acceptFailed });
+                else
+                    notify?.({ tone: "info", message: text.acceptEarlyRequested });
+            })
+                .catch(() => {
+                if (stillCurrent(action))
+                    notify?.({ tone: "error", message: text.acceptFailed });
+            })
+                .finally(() => finishPendingAction(action));
+            return;
+        }
+        if (job && job.status !== "completed") {
+            notify?.({ tone: "error", message: text.acceptRunIncomplete });
+            return;
+        }
+        const action = beginPendingAction();
+        if (!action)
+            return;
+        approve({
+            onSuccess: () => {
+                finishPendingAction(action);
+                if (!stillCurrent(action))
+                    return;
+                notify?.({ tone: "success", message: text.accepted });
+                brandGeneration.reset();
+            },
+            onError: () => {
+                finishPendingAction(action);
+                if (stillCurrent(action))
+                    notify?.({ tone: "error", message: text.acceptFailed });
+            },
+        });
+    };
+    return { accept, signalPending };
+}
+//# sourceMappingURL=use-brand-profile-acceptance.js.map

package/dist/brand/use-brand-profile-acceptance.js.map

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

package/dist/brand/use-brand-public-visibility.d.ts

@@ -0,0 +1,59 @@
+import type { BrandWorkspaceTarget } from "./use-brand-workspace-concurrency.js";
+import type { BrandPublicField } from "./brand-profile-review.js";
+/** The profile a visibility write is compare-and-swapped against. */
+export interface BrandVisibilityProfile {
+    readonly id: string;
+    readonly status: string;
+    readonly revision?: number | null;
+}
+export interface BrandPublicVisibilityWrite {
+    readonly expectedProfileId: string;
+    readonly expectedStatus: string;
+    readonly expectedRevision: number | undefined;
+    readonly publicVisibility: Readonly<Partial<Record<BrandPublicField, boolean>>>;
+}
+/**
+ * The injected data layer: persist one field's visibility on the approved
+ * profile or on the generated draft, resolving with the saved profile.
+ */
+export interface BrandPublicVisibilityApi {
+    save: (write: BrandPublicVisibilityWrite, target: BrandWorkspaceTarget) => Promise<{
+        readonly revision?: number | null;
+    } | null | undefined | void>;
+}
+export type BrandPublicVisibilityEvent = {
+    readonly kind: "reload-before-saving";
+} | {
+    readonly kind: "wait-for-save";
+} | {
+    readonly kind: "save-failed";
+};
+export interface UseBrandPublicVisibilityOptions {
+    readonly orgId: string | null;
+    readonly api: BrandPublicVisibilityApi;
+    /** The approved profile. */
+    readonly profile: BrandVisibilityProfile | null | undefined;
+    /** The generated draft under review; wins over `profile` when present. */
+    readonly generatedDraftProfile: BrandVisibilityProfile | null | undefined;
+    /** `requiresReload` from `useBrandWorkspaceConcurrency`. */
+    readonly requiresReload: boolean;
+    /** A profile write (save, approve, discard) in flight. */
+    readonly profileWritePending: boolean;
+    /** A 409 REVISION_CONFLICT / TARGET_MISMATCH: wire to `markServerChanged`. */
+    readonly onConflict: () => void;
+    /** Wire to `noteOwnWrite` so the refetch is not read as a remote change. */
+    readonly onOwnWrite?: (saved: {
+        readonly revision?: number | null;
+    } | null | undefined) => void;
+    readonly notify?: (event: BrandPublicVisibilityEvent) => void;
+    /** Same duck-typed check as the concurrency hook's default classifier. */
+    readonly isConflict?: (error: unknown) => boolean;
+}
+/**
+ * CEL-2127 — the public-visibility toggle handler for the brand workspace.
+ * One in-flight write per org+field; refuses while a reload is required or a
+ * profile write is pending; a CAS conflict marks the server as changed rather
+ * than retrying (the user must see the latest values first).
+ */
+export declare function useBrandPublicVisibility(options: UseBrandPublicVisibilityOptions): (field: BrandPublicField, next: boolean) => void;
+//# sourceMappingURL=use-brand-public-visibility.d.ts.map

package/dist/brand/use-brand-public-visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-brand-public-visibility.d.ts","sourceRoot":"","sources":["../../src/brand/use-brand-public-visibility.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,qEAAqE;AACrE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACjF;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,CACJ,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,oBAAoB,KACzB,OAAO,CAAC;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;CAC/E;AAED,MAAM,MAAM,0BAA0B,GAClC;IAAE,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAA;CAAE,GACzC;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GAClC;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAErC,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,wBAAwB,CAAC;IACvC,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5D,0EAA0E;IAC1E,QAAQ,CAAC,qBAAqB,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1E,4DAA4D;IAC5D,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,0DAA0D;IAC1D,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;IAChG,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,CAAC;IAC9D,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACnD;AAQD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,+BAA+B,GACvC,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAmElD"}

package/dist/brand/use-brand-public-visibility.js

@@ -0,0 +1,69 @@
+import { useRef } from "react";
+function defaultIsConflict(error) {
+    if (error === null || typeof error !== "object")
+        return false;
+    const code = error.code;
+    return code === "REVISION_CONFLICT" || code === "TARGET_MISMATCH";
+}
+/**
+ * CEL-2127 — the public-visibility toggle handler for the brand workspace.
+ * One in-flight write per org+field; refuses while a reload is required or a
+ * profile write is pending; a CAS conflict marks the server as changed rather
+ * than retrying (the user must see the latest values first).
+ */
+export function useBrandPublicVisibility(options) {
+    const pendingKeysRef = useRef(new Set());
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    return (field, next) => {
+        const { orgId, api, profile, generatedDraftProfile, requiresReload, profileWritePending, onConflict, onOwnWrite, notify, isConflict = defaultIsConflict, } = optionsRef.current;
+        const reviewed = generatedDraftProfile ?? profile;
+        if (!orgId || !reviewed)
+            return;
+        if (requiresReload) {
+            notify?.({ kind: "reload-before-saving" });
+            return;
+        }
+        if (profileWritePending) {
+            notify?.({ kind: "wait-for-save" });
+            return;
+        }
+        const pendingKey = `${orgId}:${field}`;
+        // Results of a write started in org A must never act in org B.
+        const stillCurrent = () => optionsRef.current.orgId === orgId;
+        if (pendingKeysRef.current.has(pendingKey))
+            return;
+        pendingKeysRef.current.add(pendingKey);
+        const target = generatedDraftProfile ? "draft" : "approved";
+        let attempt;
+        try {
+            attempt = api.save({
+                expectedProfileId: reviewed.id,
+                expectedStatus: reviewed.status,
+                expectedRevision: reviewed.revision ?? undefined,
+                publicVisibility: { [field]: next },
+            }, target);
+        }
+        catch (error) {
+            attempt = Promise.reject(error);
+        }
+        void attempt
+            .then((saved) => {
+            if (stillCurrent())
+                onOwnWrite?.(saved ?? undefined);
+        }, (error) => {
+            if (!stillCurrent())
+                return;
+            if (isConflict(error)) {
+                onConflict();
+                notify?.({ kind: "reload-before-saving" });
+                return;
+            }
+            notify?.({ kind: "save-failed" });
+        })
+            .finally(() => {
+            pendingKeysRef.current.delete(pendingKey);
+        });
+    };
+}
+//# sourceMappingURL=use-brand-public-visibility.js.map

package/dist/brand/use-brand-public-visibility.js.map

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

package/dist/brand/use-brand-workspace-concurrency.d.ts

@@ -0,0 +1,132 @@
+import type { BrandProfileConflict } from "./brand-profile-form.js";
+/**
+ * CEL-2127 — the ONE implementation of brand-workspace write concurrency.
+ *
+ * It owns what producer's `BrandContentController` and importer's
+ * `BrandProfileContent` each did by hand, with producer's semantics:
+ *
+ * - `409 REVISION_CONFLICT` surfaces as {@link UseBrandWorkspaceConcurrencyResult.conflict}
+ *   on the form. The user then chooses, explicitly:
+ *   - **reload** re-reads the server and remounts the form on the fresh values
+ *     (the form key changes, so nothing of the stale edit survives);
+ *   - **keep mine** re-submits the SAME sparse patch against the revision the
+ *     conflict reported. It only ever runs from that explicit user action,
+ *     never automatically, and the server still compare-and-swaps it, so a
+ *     third write in between conflicts again instead of being overwritten.
+ * - `409 TARGET_MISMATCH` (the row this edit targeted is no longer the current
+ *   target, e.g. the draft was approved elsewhere) has no revision to retry
+ *   with: it reloads and closes the editor, and shows the change notice if
+ *   that reload fails.
+ * - A server revision that moves underneath an open workspace, and is not our
+ *   own write, raises `serverChanged` (render {@link BrandWorkspaceChangeNotice}).
+ *
+ * The data layer is injected: the hook never imports a client.
+ */
+/** What the hook needs to know about the profile the workspace is editing. */
+export interface BrandWorkspaceSnapshot {
+    readonly id?: string | null;
+    readonly revision?: number | null;
+    readonly version?: number | null;
+    readonly updatedAt?: string | null;
+    readonly status?: string | null;
+    readonly profileData?: unknown;
+}
+export type BrandWorkspaceTarget = "approved" | "draft";
+/** The parts of a write body the hook reads or rewrites. */
+export interface BrandWorkspaceWriteBody {
+    expectedRevision?: number;
+}
+/** How a failed save is classified. {@link classifyBrandProfileApiError} is the default. */
+export type BrandWorkspaceSaveFailure = {
+    readonly kind: "revision-conflict";
+    readonly currentRevision: number;
+} | {
+    readonly kind: "target-mismatch";
+} | {
+    readonly kind: "validation";
+    readonly fieldErrors: Readonly<Record<string, string>>;
+} | {
+    readonly kind: "other";
+};
+/**
+ * Duck-typed classifier for the brand-profile API error both dashboards use
+ * (`status`, `code`, `currentRevision`, `fieldErrors`). It deliberately does
+ * not `instanceof` a consumer class, so one classifier serves every client.
+ */
+export declare function classifyBrandProfileApiError(error: unknown): BrandWorkspaceSaveFailure;
+/** Events the consumer turns into its own (translated) toast. The hook has no strings. */
+export type BrandWorkspaceEvent = {
+    readonly kind: "saved";
+} | {
+    readonly kind: "save-failed";
+} | {
+    readonly kind: "target-mismatch";
+} | {
+    readonly kind: "reload-failed";
+} | {
+    readonly kind: "reload-before-saving";
+} | {
+    readonly kind: "wait-for-save";
+};
+export interface UseBrandWorkspaceConcurrencyOptions<TBody extends BrandWorkspaceWriteBody> {
+    readonly orgId: string;
+    /** The profile (approved or generated draft) the workspace is editing. */
+    readonly workspaceProfile: BrandWorkspaceSnapshot | null | undefined;
+    /** Whether a form is open on `workspaceProfile`; changes only matter then. */
+    readonly workspaceVisible: boolean;
+    /** Any write of this workspace in flight (save, visibility, approve, discard). */
+    readonly localWritePending: boolean;
+    /**
+     * Performs the write. Resolve with the saved profile. Its `revision` is
+     * REQUIRED for exact own-write detection: the refetch is "ours" only when
+     * the profile's revision equals it; without a revision the refetch raises
+     * the change notice (a safe false positive, never a swallowed remote edit).
+     * Reject with the transport error.
+     */
+    readonly save: (body: TBody, target: BrandWorkspaceTarget) => Promise<{
+        readonly revision?: number | null;
+    } | null | undefined | void>;
+    /**
+     * Forces a re-read of everything the workspace derives from. MUST reject on
+     * failure so a failed reload never unlocks writes against a stale target.
+     * Resolve with the fresh workspace profile when known: it becomes the
+     * baseline, so the re-read is not reported back as a remote change.
+     */
+    readonly reload: () => Promise<BrandWorkspaceSnapshot | null | undefined | void>;
+    readonly classifyError?: (error: unknown) => BrandWorkspaceSaveFailure;
+    /** Called after a successful save (close the editor here). */
+    readonly onSaved?: () => void;
+    /** Called after a successful reload; `closeEditor` is true for conflict resolution. */
+    readonly onReloaded?: (info: {
+        readonly closeEditor: boolean;
+    }) => void;
+    readonly notify?: (event: BrandWorkspaceEvent) => void;
+}
+export interface UseBrandWorkspaceConcurrencyResult<TBody extends BrandWorkspaceWriteBody> {
+    /** Pass to `BrandProfileForm`/`BrandProfileWorkspace`/`BrandGenerationSurface`. */
+    readonly conflict: BrandProfileConflict | null;
+    readonly fieldErrors: Readonly<Record<string, string>> | undefined;
+    /** The server changed underneath an open workspace; render the change notice. */
+    readonly serverChanged: boolean;
+    readonly reloadPending: boolean;
+    /** True while a write must wait for the user to reload (changed, reloading or conflicted). */
+    readonly requiresReload: boolean;
+    /** Pass as `key` on the form: it changes on every successful reload, remounting on fresh values. */
+    readonly workspaceKey: string;
+    /** Guarded submit: refuses while a reload is required or a write is pending. */
+    readonly submit: (body: TBody, target: BrandWorkspaceTarget) => void;
+    /** Conflict action: discard local edits, reload, close the editor. */
+    readonly reloadConflict: () => void;
+    /** Conflict action: deliberately re-submit the last patch against the reported revision. */
+    readonly keepMine: () => void;
+    /** Change-notice action: reload and keep the editor open. */
+    readonly reloadLatest: () => void;
+    /** Record a write made OUTSIDE `submit` (e.g. visibility) so its refetch is not a remote change. */
+    readonly noteOwnWrite: (saved: {
+        readonly revision?: number | null;
+    } | null | undefined) => void;
+    /** Mark the server as changed (e.g. a visibility write hit a conflict). */
+    readonly markServerChanged: () => void;
+}
+export declare function useBrandWorkspaceConcurrency<TBody extends BrandWorkspaceWriteBody>(options: UseBrandWorkspaceConcurrencyOptions<TBody>): UseBrandWorkspaceConcurrencyResult<TBody>;
+//# sourceMappingURL=use-brand-workspace-concurrency.d.ts.map

package/dist/brand/use-brand-workspace-concurrency.d.ts.map

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