@cellarnode/ui 0.186.0 → 0.188.0

package/dist/brand/use-brand-generation-transport.d.ts

@@ -0,0 +1,16 @@
+import type { BrandGenerationApi, BrandGenerationStreamConfig } from "./brand-generation-api.js";
+import type { BrandGenerationJobStatus as JobStatus } from "./brand-generation-response.js";
+import { type BrandGenerationUpdate } from "./brand-generation-sse-parser.js";
+export type { BrandGenerationUpdate } from "./brand-generation-sse-parser.js";
+interface TransportOptions {
+    api: Pick<BrandGenerationApi, "getStatus">;
+    stream: BrandGenerationStreamConfig;
+    onUpdate: (data: BrandGenerationUpdate) => void;
+    onDegraded: () => void;
+    isTerminal: (status: JobStatus | undefined) => boolean;
+}
+export declare function useBrandGenerationTransport({ api, stream, onUpdate, onDegraded, isTerminal, }: TransportOptions): {
+    cleanup: () => void;
+    connect: (jobId: string) => Promise<void>;
+};
+//# sourceMappingURL=use-brand-generation-transport.d.ts.map

package/dist/brand/use-brand-generation-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-brand-generation-transport.d.ts","sourceRoot":"","sources":["../../src/brand/use-brand-generation-transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAC9F,OAAO,KAAK,EAAE,wBAAwB,IAAI,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACzF,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAS3E,UAAU,gBAAgB;IACxB,GAAG,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,CAAC;IAC3C,MAAM,EAAE,2BAA2B,CAAC;IACpC,QAAQ,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAChD,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,UAAU,EAAE,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,KAAK,OAAO,CAAC;CACxD;AAED,wBAAgB,2BAA2B,CAAC,EAC1C,GAAG,EACH,MAAM,EACN,QAAQ,EACR,UAAU,EACV,UAAU,GACX,EAAE,gBAAgB;;qBA8DD,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;EAwHvC"}

package/dist/brand/use-brand-generation-transport.js

@@ -0,0 +1,182 @@
+import { useCallback, useRef } from "react";
+import { dataPayload, parseSseUpdate, } from "./brand-generation-sse-parser.js";
+const DEFAULT_SSE_IDLE_TIMEOUT_MS = 15_000;
+const DEFAULT_POLL_INTERVAL_MS = 2000;
+function errorType(error) {
+    return error instanceof Error ? error.name : "UnknownError";
+}
+export function useBrandGenerationTransport({ api, stream, onUpdate, onDegraded, isTerminal, }) {
+    // `api`/`stream` are read through refs so `connect`/`cleanup` keep a stable
+    // identity even when a consumer passes fresh object literals each render.
+    const apiRef = useRef(api);
+    apiRef.current = api;
+    const streamRef = useRef(stream);
+    streamRef.current = stream;
+    const pollIntervalRef = useRef(null);
+    const idleTimeoutRef = useRef(null);
+    const abortControllerRef = useRef(null);
+    const connectionGenerationRef = useRef(0);
+    const cleanup = useCallback(() => {
+        connectionGenerationRef.current += 1;
+        abortControllerRef.current?.abort();
+        abortControllerRef.current = null;
+        if (idleTimeoutRef.current !== null) {
+            window.clearTimeout(idleTimeoutRef.current.timerId);
+            idleTimeoutRef.current = null;
+        }
+        if (pollIntervalRef.current !== null) {
+            window.clearInterval(pollIntervalRef.current);
+            pollIntervalRef.current = null;
+        }
+    }, []);
+    const emitUpdate = useCallback((data) => {
+        if (isTerminal(data.status))
+            cleanup();
+        onUpdate(data);
+    }, [cleanup, isTerminal, onUpdate]);
+    const startPolling = useCallback((jobId) => {
+        cleanup();
+        const generation = connectionGenerationRef.current;
+        onDegraded();
+        const poll = async () => {
+            try {
+                const update = await apiRef.current.getStatus(jobId);
+                if (connectionGenerationRef.current === generation)
+                    emitUpdate(update);
+            }
+            catch (error) {
+                console.warn("[brand-generation] status poll failed; retrying", {
+                    errorType: errorType(error),
+                });
+            }
+        };
+        void poll();
+        pollIntervalRef.current = window.setInterval(() => void poll(), streamRef.current.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS);
+    }, [cleanup, emitUpdate, onDegraded]);
+    const connect = useCallback(async (jobId) => {
+        cleanup();
+        const generation = connectionGenerationRef.current;
+        const isCurrent = () => connectionGenerationRef.current === generation;
+        try {
+            const config = streamRef.current;
+            const token = config.getAccessToken ? await config.getAccessToken() : undefined;
+            if (!isCurrent())
+                return;
+            // Bearer mode with no usable token (null or empty) degrades to polling,
+            // like producer; cookie mode (no `getAccessToken`) streams with
+            // credentials instead.
+            if (config.getAccessToken && !token) {
+                startPolling(jobId);
+                return;
+            }
+            const controller = new AbortController();
+            abortControllerRef.current = controller;
+            const clearIdleTimeout = () => {
+                const idleTimeout = idleTimeoutRef.current;
+                if (idleTimeout?.generation !== generation)
+                    return;
+                window.clearTimeout(idleTimeout.timerId);
+                idleTimeoutRef.current = null;
+            };
+            const armIdleTimeout = () => {
+                clearIdleTimeout();
+                const timerId = window.setTimeout(() => {
+                    const idleTimeout = idleTimeoutRef.current;
+                    if (idleTimeout?.generation !== generation || idleTimeout.timerId !== timerId)
+                        return;
+                    idleTimeoutRef.current = null;
+                    if (!isCurrent())
+                        return;
+                    controller.abort();
+                    startPolling(jobId);
+                }, config.idleTimeoutMs ?? DEFAULT_SSE_IDLE_TIMEOUT_MS);
+                idleTimeoutRef.current = { generation, timerId };
+            };
+            armIdleTimeout();
+            const doFetch = config.fetch ?? fetch;
+            const response = await doFetch(`${config.baseUrl.replace(/\/+$/, "")}/brand-profiles/generate/${encodeURIComponent(jobId)}/stream`, {
+                headers: {
+                    Accept: "text/event-stream",
+                    ...(token ? { Authorization: `Bearer ${token}` } : {}),
+                },
+                ...(token ? {} : { credentials: "include" }),
+                signal: controller.signal,
+            });
+            if (!isCurrent()) {
+                controller.abort();
+                return;
+            }
+            if (!response.ok) {
+                startPolling(jobId);
+                return;
+            }
+            const reader = response.body?.getReader();
+            if (!reader) {
+                startPolling(jobId);
+                return;
+            }
+            const decoder = new TextDecoder();
+            let buffer = "";
+            let terminalSeen = false;
+            try {
+                while (true) {
+                    const { done, value } = await reader.read();
+                    clearIdleTimeout();
+                    if (!isCurrent())
+                        return;
+                    if (done) {
+                        if (!terminalSeen)
+                            startPolling(jobId);
+                        return;
+                    }
+                    armIdleTimeout();
+                    buffer += decoder.decode(value, { stream: true });
+                    let boundary = buffer.search(/\r?\n\r?\n/);
+                    while (boundary !== -1) {
+                        const chunk = buffer.slice(0, boundary);
+                        const separator = buffer.slice(boundary).match(/^\r?\n\r?\n/)?.[0] ?? "\n\n";
+                        buffer = buffer.slice(boundary + separator.length);
+                        const payload = dataPayload(chunk);
+                        if (payload !== null) {
+                            const data = parseSseUpdate(payload);
+                            if (data) {
+                                const terminal = isTerminal(data.status);
+                                if (terminal)
+                                    terminalSeen = true;
+                                emitUpdate(data);
+                                if (terminal)
+                                    return;
+                            }
+                        }
+                        boundary = buffer.search(/\r?\n\r?\n/);
+                    }
+                }
+            }
+            catch (error) {
+                if (!isCurrent())
+                    return;
+                if (error instanceof Error && error.name === "AbortError")
+                    return;
+                console.warn("[brand-generation] SSE read failed; polling", {
+                    errorType: errorType(error),
+                });
+                startPolling(jobId);
+            }
+            finally {
+                clearIdleTimeout();
+            }
+        }
+        catch (error) {
+            if (!isCurrent())
+                return;
+            if (error instanceof Error && error.name === "AbortError")
+                return;
+            console.warn("[brand-generation] SSE connection failed; polling", {
+                errorType: errorType(error),
+            });
+            startPolling(jobId);
+        }
+    }, [cleanup, emitUpdate, isTerminal, startPolling]);
+    return { cleanup, connect };
+}
+//# sourceMappingURL=use-brand-generation-transport.js.map

package/dist/brand/use-brand-generation-transport.js.map

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

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

@@ -0,0 +1,35 @@
+import { type QueryKey } from "@tanstack/react-query";
+import type { BrandGenerationApi, BrandGenerationStreamConfig } from "./brand-generation-api.js";
+import type { BrandGenerationContext, BrandGenerationJob } from "./brand-generation-response.js";
+export interface UseBrandGenerationOptions {
+    /** Active org id. Every piece of generation state resets when it changes. */
+    readonly orgId: string;
+    /** The endpoint seam. See {@link BrandGenerationApi}. */
+    readonly api: BrandGenerationApi;
+    /** How the SSE stream authenticates. See {@link BrandGenerationStreamConfig}. */
+    readonly stream: BrandGenerationStreamConfig;
+    /**
+     * The consumer's brand-profile query key (prefix) for this org. It is
+     * invalidated when a job reaches a terminal state or is accepted, so the
+     * consumer's profile/draft queries refetch. Must not live under the
+     * `"brand-generation"` namespace.
+     */
+    readonly profileQueryKey: QueryKey;
+}
+export type UseBrandGenerationResult = ReturnType<typeof useBrandGeneration>;
+export declare function useBrandGeneration({ orgId, api, stream, profileQueryKey, }: UseBrandGenerationOptions): {
+    job: BrandGenerationJob | null;
+    isGenerating: boolean;
+    isDiscoveringActive: boolean;
+    discoveryError: Error | null;
+    error: "start" | "resume" | "accept" | "cancel" | "prioritize" | null;
+    transportDegraded: boolean;
+    eligibility: import("./brand-generation-types.js").BrandGenerationEligibility | null;
+    start: (homepageUrl: string, context?: BrandGenerationContext) => Promise<void>;
+    resume: (jobId: string) => Promise<void>;
+    cancel: () => Promise<void>;
+    prioritizeUrl: (url: string) => Promise<void>;
+    accept: () => Promise<boolean>;
+    reset: () => void;
+};
+//# sourceMappingURL=use-brand-generation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-brand-generation.d.ts","sourceRoot":"","sources":["../../src/brand/use-brand-generation.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAM9F,OAAO,KAAK,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAS9F,MAAM,WAAW,yBAAyB;IACxC,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC;IACjC,iFAAiF;IACjF,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;IAC7C;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC;CACpC;AAED,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE7E,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,GAAG,EACH,MAAM,EACN,eAAe,GAChB,EAAE,yBAAyB;;;;;;;;yBAwEQ,MAAM,YAAY,sBAAsB;oBAkHnD,MAAM;;yBA1EK,MAAM;;;EA8GzC"}

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

@@ -0,0 +1,225 @@
+import { useEffect, useCallback, useRef } from "react";
+import { useQueryClient } from "@tanstack/react-query";
+import { brandGenerationKeys, isTerminalStatus, } from "./brand-generation-keys.js";
+import { resumeBrandGeneration } from "./resume-brand-generation.js";
+import { useBrandGenerationDiscovery } from "./use-brand-generation-discovery.js";
+import { useBrandGenerationTransport, } from "./use-brand-generation-transport.js";
+import { useOrgScopedState } from "./use-org-scoped-state.js";
+export function useBrandGeneration({ orgId, api, stream, profileQueryKey, }) {
+    // Read through a ref so a fresh array literal each render cannot churn the callbacks below.
+    const profileKeyRef = useRef(profileQueryKey);
+    profileKeyRef.current = profileQueryKey;
+    const orgEpochRef = useRef(0);
+    const renderedOrgIdRef = useRef(orgId);
+    if (renderedOrgIdRef.current !== orgId) {
+        renderedOrgIdRef.current = orgId;
+        orgEpochRef.current += 1;
+    }
+    const orgEpoch = orgEpochRef.current;
+    const queryClient = useQueryClient();
+    const { activeQuery, activeJob, terminalQuery, terminalJob, eligibility: discoveryEligibility, needsTerminalHandoff, isDiscoveringActive, discoveryError, } = useBrandGenerationDiscovery(orgId, api, profileKeyRef);
+    const [job, setJob, updateJob] = useOrgScopedState(orgId, null);
+    const [dismissedTerminalJobId, setDismissedTerminalJobId] = useOrgScopedState(orgId, null);
+    const [isGenerating, setIsGenerating] = useOrgScopedState(orgId, false);
+    const [error, setError] = useOrgScopedState(orgId, null);
+    const [transportDegraded, setTransportDegraded] = useOrgScopedState(orgId, false);
+    const clearGenerationState = useCallback(() => {
+        setJob(null);
+        setIsGenerating(false);
+        setError(null);
+        setTransportDegraded(false);
+    }, [setError, setIsGenerating, setJob, setTransportDegraded]);
+    const markTransportDegraded = useCallback(() => {
+        if (orgEpochRef.current === orgEpoch)
+            setTransportDegraded(true);
+    }, [orgEpoch, setTransportDegraded]);
+    const invalidateGenerationHandoff = useCallback(() => {
+        if (!orgId)
+            return;
+        queryClient.setQueryData(brandGenerationKeys.active(orgId), null);
+        void Promise.all([
+            queryClient.invalidateQueries({ queryKey: brandGenerationKeys.active(orgId), exact: true }),
+            queryClient.invalidateQueries({ queryKey: profileKeyRef.current }),
+        ]);
+    }, [orgId, queryClient]);
+    const handleUpdate = useCallback((data) => {
+        if (orgEpochRef.current !== orgEpoch)
+            return;
+        const { jobId, ...update } = data;
+        updateJob((currentJob) => {
+            if (!currentJob)
+                return currentJob;
+            return { ...currentJob, ...update, id: jobId || update.id || currentJob.id };
+        });
+        if (isTerminalStatus(data.status)) {
+            setIsGenerating(false);
+            invalidateGenerationHandoff();
+        }
+    }, [invalidateGenerationHandoff, orgEpoch, setIsGenerating, updateJob]);
+    const { cleanup, connect: connectSSE } = useBrandGenerationTransport({
+        api,
+        stream,
+        onUpdate: handleUpdate,
+        onDegraded: markTransportDegraded,
+        isTerminal: isTerminalStatus,
+    });
+    // CEL-1679 contract §2: "Retry is a start with amended context" — no
+    // separate retry endpoint, so a retry calls this same function again with
+    // the operator's amended context from `BrandGenerationContextForm`.
+    const start = async (homepageUrl, context) => {
+        if (isDiscoveringActive || discoveryError !== null)
+            return;
+        const actionEpoch = orgEpoch;
+        try {
+            setError(null);
+            setTransportDegraded(false);
+            setDismissedTerminalJobId(null);
+            setIsGenerating(true);
+            const res = await api.start(homepageUrl, context);
+            if (orgEpochRef.current !== actionEpoch)
+                return;
+            setJob({
+                id: res.jobId,
+                workflowId: res.workflowId,
+                status: "pending",
+                progress: {},
+                error: null,
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString(),
+            });
+            connectSSE(res.jobId);
+        }
+        catch {
+            if (orgEpochRef.current !== actionEpoch)
+                return;
+            setIsGenerating(false);
+            setError("start");
+        }
+    };
+    const cancel = async () => {
+        if (!job?.id)
+            return;
+        const actionEpoch = orgEpoch;
+        try {
+            const res = await api.cancel(job.id);
+            if (orgEpochRef.current !== actionEpoch)
+                return;
+            handleUpdate(res);
+        }
+        catch {
+            if (orgEpochRef.current !== actionEpoch)
+                return;
+            setError("cancel");
+        }
+    };
+    const prioritizeUrl = async (url) => {
+        if (!job?.id)
+            return;
+        const actionEpoch = orgEpoch;
+        try {
+            const res = await api.prioritizeUrl(job.id, url);
+            if (orgEpochRef.current !== actionEpoch)
+                return;
+            handleUpdate(res);
+        }
+        catch {
+            if (orgEpochRef.current !== actionEpoch)
+                return;
+            setError("prioritize");
+        }
+    };
+    const accept = async () => {
+        if (!job?.id)
+            return false;
+        const actionEpoch = orgEpoch;
+        try {
+            await api.accept(job.id);
+            if (orgEpochRef.current !== actionEpoch)
+                return false;
+            invalidateGenerationHandoff();
+            if (isTerminalStatus(job.status))
+                setDismissedTerminalJobId(job.id);
+            setJob(null);
+            return true;
+        }
+        catch {
+            if (orgEpochRef.current !== actionEpoch)
+                return false;
+            setError("accept");
+            return false;
+        }
+    };
+    const reset = () => {
+        cleanup();
+        if (job && isTerminalStatus(job.status))
+            setDismissedTerminalJobId(job.id);
+        clearGenerationState();
+    };
+    useEffect(() => cleanup, [cleanup]);
+    useEffect(() => {
+        cleanup();
+    }, [cleanup, orgId]);
+    useEffect(() => {
+        if (activeQuery.isFetching ||
+            (needsTerminalHandoff && terminalQuery.isFetching) ||
+            (!activeJob && (!terminalJob || terminalJob.id === dismissedTerminalJobId)) ||
+            job ||
+            isGenerating)
+            return;
+        setError(null);
+        setTransportDegraded(false);
+        setJob(activeJob ?? terminalJob ?? null);
+        if (activeJob) {
+            setIsGenerating(true);
+            void connectSSE(activeJob.id);
+        }
+    }, [
+        activeJob,
+        activeQuery.isFetching,
+        connectSSE,
+        isGenerating,
+        job,
+        dismissedTerminalJobId,
+        needsTerminalHandoff,
+        setError,
+        setIsGenerating,
+        setJob,
+        setTransportDegraded,
+        terminalJob,
+        terminalQuery.isFetching,
+    ]);
+    const resume = (jobId) => resumeBrandGeneration(jobId, {
+        api,
+        isCurrent: () => orgEpochRef.current === orgEpoch,
+        setError,
+        setIsGenerating,
+        setTransportDegraded,
+        setJob,
+        handleUpdate,
+        connect: connectSSE,
+    });
+    return {
+        job,
+        isGenerating,
+        isDiscoveringActive,
+        discoveryError,
+        error,
+        transportDegraded,
+        // CEL-1682 (contracts §2): prefers the tracked job's own eligibility
+        // (populated by GET /:jobId via `resume`, and by GET /active when a job
+        // is active — the freshest snapshot once a specific job is in view),
+        // falling back to the discovery-level snapshot from
+        // `useBrandGenerationDiscovery`'s unconditional `/active` read. This is
+        // the fix for the confirmed idle-state gap: `getActiveBrandGeneration`
+        // no longer collapses `{ job: null, eligibility }` to a bare `null`, so
+        // the cooldown banner has data even when nothing is running.
+        eligibility: job?.eligibility ?? discoveryEligibility,
+        start,
+        resume,
+        cancel,
+        prioritizeUrl,
+        accept,
+        reset,
+    };
+}
+//# sourceMappingURL=use-brand-generation.js.map

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

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

package/dist/brand/use-brand-image-operation-result.d.ts

@@ -0,0 +1,43 @@
+import { type ModerationPersistedRead, type ModerationSubjectMatch } from "../moderation/index.js";
+import type { BrandImageOperationResult } from "./brand-image-chooser-types.js";
+export interface BrandImageOperationController {
+    /** `null` when no operation has started yet — the chooser's own idle
+     * default. */
+    readonly operationResult: BrandImageOperationResult | null;
+    /**
+     * Call once `onApply`'s upload/candidate-select call has been accepted by
+     * the backend: a caller-generated id that correlates a later verdict back
+     * to THIS call (never a previous operation on the same subject slot), and
+     * the subject to watch. The subject is passed HERE rather than fixed at
+     * the hook call site because it depends on which slot the upload actually
+     * landed in — a candidate's OWN role can route it to a different slot than
+     * the chooser instance's own target (e.g. a favicon-role candidate picked
+     * through the "profile picture" chooser still saves to the favicon slot;
+     * see `candidateAssetSlot` in `useBrandImageCandidates.ts`). Also marks the
+     * subject "checking" in the shared moderation store so every OTHER surface
+     * watching it (e.g. `BrandAssetsSection`'s `ModerationSurfaceNotice`) sees
+     * it too.
+     */
+    readonly startOperation: (operationId: string, subject: ModerationSubjectMatch, startSeq?: number) => void;
+    /**
+     * Call BEFORE issuing the upload request and pass the result to
+     * `startOperation`. The backend can publish a verdict for the asset while
+     * the upload's HTTP response is still in flight; without this snapshot that
+     * event is gated out as "pre-existing" and the operation hangs at
+     * `checking` until it gives up.
+     */
+    readonly beginOperation: () => number;
+    /** Drops tracking — e.g. when the chooser is dismissed/closed. */
+    readonly reset: () => void;
+}
+/**
+ * Owns the chooser's current upload identity and adapts the shared moderation
+ * operation (including its exact-asset durable read) to the chooser result.
+ */
+export declare function useBrandImageOperationResult(
+/**
+ * The durable, asset-id-keyed read (`BrandAssetsApi.fetchModeration`) used
+ * when no live verdict event arrives.
+ */
+fetchModeration: (profileId: string, assetId: string) => Promise<ModerationPersistedRead | null>): BrandImageOperationController;
+//# sourceMappingURL=use-brand-image-operation-result.d.ts.map

package/dist/brand/use-brand-image-operation-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-brand-image-operation-result.d.ts","sourceRoot":"","sources":["../../src/brand/use-brand-image-operation-result.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EACV,yBAAyB,EAE1B,MAAM,6BAA6B,CAAC;AAmCrC,MAAM,WAAW,6BAA6B;IAC5C;kBACc;IACd,QAAQ,CAAC,eAAe,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAC3D;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,cAAc,EAAE,CACvB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,sBAAsB,EAC/B,QAAQ,CAAC,EAAE,MAAM,KACd,IAAI,CAAC;IACV;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,MAAM,CAAC;IACtC,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,4BAA4B;AAC1C;;;GAGG;AACH,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,GAC/F,6BAA6B,CA0I/B"}