@leviosa-ai/detail-page-editor 0.7.1 → 0.7.3

package/components/detail-page/ai-generate-panel.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { useCallback, useState, type ChangeEvent } from "react";
+import { useCallback, useMemo, useState, type ChangeEvent } from "react";
 import { ImagePlus, Info, Loader2, Pencil, Sparkles, X } from "lucide-react";
 import { useTranslation } from "react-i18next";
 
@@ -8,11 +8,11 @@ import { AnnotationDialog } from "./annotation-dialog";
 import { toDrawableDataUri } from "../../lib/detail-page/image-data-uri";
 
 import {
-  DEFAULT_IMAGE_TIER,
-  IMAGE_TIERS,
   IMAGE_TIER_META,
   isImageCreditBlocked,
   imageCreditRequired,
+  resolveDefaultImageTier,
+  resolveImageTiers,
   type ImageTier,
 } from "../../lib/detail-page/image-credit";
 import {
@@ -246,6 +246,12 @@ type AiGeneratePanelProps = {
    * 계산한다. 단일 값 `creditCost`보다 우선. 데모(dev-canvas)는 대체 단가 맵을 넘긴다.
    */
   costByTier?: Partial<Record<ImageTier, number>>;
+  /**
+   * 고르게 할 티어. 안 주면 셋 다(`IMAGE_TIERS`). 요금표에서 은퇴한 티어를 가진
+   * 소비자가 드롭다운에서 그 항목을 빼는 자리다 — 값이 없는 티어가 남아 있으면
+   * 누를 수는 있는데 아무도 청구를 못 한다.
+   */
+  tiers?: readonly ImageTier[];
   /**
    * (레거시) 단일 티어 크레딧. `costByTier` 미주입 시 선택 티어 관계없이 이 값을 쓴다.
    * 0/미지정이면 크레딧 UI 숨김.
@@ -286,6 +292,7 @@ export function AiGeneratePanel({
   uploadFile,
   onResult,
   costByTier,
+  tiers,
   creditCost = 0,
   creditBalance = 0,
   onBuyCredits,
@@ -296,7 +303,17 @@ export function AiGeneratePanel({
     // GIF 생성이 배선된 경우에만 gif 초기값을 존중(미배선이면 토글이 없어 갇힘).
     initialMode === "gif" && onGenerateGif ? "gif" : "image",
   );
-  const [tier, setTier] = useState<ImageTier>(DEFAULT_IMAGE_TIER);
+  // 목록은 props 로 오지만 배열이라 매 렌더 새 참조다. 여기서 한 번 정규화해
+  // 아래 `useMemo`·초기값이 같은 값을 본다.
+  const tierOptions = useMemo(() => resolveImageTiers(tiers), [tiers]);
+  const [tier, setTier] = useState<ImageTier>(() =>
+    resolveDefaultImageTier(resolveImageTiers(tiers)),
+  );
+  // 목록이 좁아졌는데 고른 것이 그 밖이면(소비자가 티어를 은퇴시킨 뒤 열린 패널)
+  // 목록 안으로 되돌린다. 안 그러면 트리거가 빈 채로 뜨고 생성은 사라진 티어로 나간다.
+  const activeTier = tierOptions.includes(tier)
+    ? tier
+    : resolveDefaultImageTier(tierOptions);
   const [transparent, setTransparent] = useState(true);
   const [refUrl, setRefUrl] = useState<string | null>(null);
   const [refUploading, setRefUploading] = useState(false);
@@ -314,7 +331,7 @@ export function AiGeneratePanel({
   );
 
   // 활성 단가: GIF 모드는 단일 gifCreditCost, 이미지 모드는 선택 티어 단가.
-  const tierCost = costByTier?.[tier] ?? creditCost;
+  const tierCost = costByTier?.[activeTier] ?? creditCost;
   const activeCost = isGif ? gifCreditCost : tierCost;
 
   // 잔액이 비용의 1.5배 미만이면 생성 차단(비용 0=미구성이면 게이트 비활성).
@@ -380,7 +397,7 @@ export function AiGeneratePanel({
             prompt: finalPrompt,
             referenceImages,
             mode: refUrl ? "new_reference" : "based_on_existing",
-            tier,
+            tier: activeTier,
             brandId,
             annotatedImage,
           });
@@ -408,7 +425,7 @@ export function AiGeneratePanel({
     } finally {
       setLoading(false);
     }
-  }, [prompt, loading, blocked, isGif, gifMissingRef, transparent, onGenerate, onGenerateGif, refUrl, store, onResult, tier, t]);
+  }, [prompt, loading, blocked, isGif, gifMissingRef, transparent, onGenerate, onGenerateGif, refUrl, store, onResult, activeTier, t]);
 
   const handleGenerate = useCallback(() => {
     void runGenerate();
@@ -529,7 +546,7 @@ export function AiGeneratePanel({
             <TooltipContent side="left" className="max-w-[240px] text-left">
               <p className="mb-1 font-dpe-semibold">{t("detailPage.aiGenerate.modelTooltipTitle")}</p>
               <ul className="space-y-1">
-                {IMAGE_TIERS.map((tk) => (
+                {tierOptions.map((tk) => (
                   <li key={tk}>
                     <span className="font-dpe-medium">{IMAGE_TIER_META[tk].label}</span>
                     <span className="opacity-80"> · {IMAGE_TIER_META[tk].quality}</span>
@@ -539,12 +556,12 @@ export function AiGeneratePanel({
             </TooltipContent>
           </Tooltip>
         </div>
-        <Select value={tier} onValueChange={(v) => setTier(v as ImageTier)}>
+        <Select value={activeTier} onValueChange={(v) => setTier(v as ImageTier)}>
           <SelectTrigger className="h-10 w-full text-sm">
             <SelectValue />
           </SelectTrigger>
           <SelectContent>
-            {IMAGE_TIERS.map((tk) => {
+            {tierOptions.map((tk) => {
               const meta = IMAGE_TIER_META[tk];
               const cost = costByTier?.[tk];
               return (
@@ -573,7 +590,7 @@ export function AiGeneratePanel({
           </SelectContent>
         </Select>
         <p className="mt-1.5 text-[11px] leading-4 text-dpe-ink-500">
-          {IMAGE_TIER_META[tier].description}
+          {IMAGE_TIER_META[activeTier].description}
         </p>
       </div>
 

package/components/detail-page/detail-page-editor.tsx

@@ -92,6 +92,14 @@ export type DetailPageEditorProps = {
    * 쓴다. 인증된 호스트가 공유 훅으로 feature_costs에서 계산해 주입한다.
    */
   imageCostByTier?: Partial<Record<ImageTier, number>>;
+  /**
+   * 고르게 할 이미지 티어. 안 주면 셋 다(basic/pro/max).
+   *
+   * 요금표에서 티어를 은퇴시킨 소비자가 쓰는 자리다 — 값이 없는 티어를 드롭다운에
+   * 남겨 두면 누를 수는 있는데 아무도 청구를 못 하고, 그 상태는 화면 어디에도 안
+   * 보인다. 에이전시는 `["pro", "max"]` 를 준다.
+   */
+  imageTiers?: readonly ImageTier[];
   /**
    * 생성 인스턴스 ID. 주어지면 텍스트 요소 선택 시 우측에 "프롬프트로 편집"이
    * 노출된다(소싱 서버 카피 엔진 호출). dev 하네스는 scratch ID를 주입한다.
@@ -435,6 +443,7 @@ export function DetailPageEditor({
   imageCreditCost = 0,
   imageCreditBalance = 0,
   imageCostByTier,
+  imageTiers,
   generatedId,
   structurePanel,
   productName,
@@ -662,6 +671,7 @@ export function DetailPageEditor({
         imageCreditCost,
         imageCreditBalance,
         imageCostByTier,
+        imageTiers,
         onBuyImageCredits: () => setPricingOpen(true),
         structurePanel,
         generatedId,
@@ -675,6 +685,7 @@ export function DetailPageEditor({
       imageCreditCost,
       imageCreditBalance,
       imageCostByTier,
+      imageTiers,
       structurePanel,
       generatedId,
     ],
@@ -721,6 +732,7 @@ export function DetailPageEditor({
       imageCreditCost,
       imageCreditBalance,
       imageCostByTier,
+      imageTiers,
       onGenerateGif,
       gifCreditCost,
       onRemoveBackground,
@@ -733,6 +745,7 @@ export function DetailPageEditor({
       imageCreditCost,
       imageCreditBalance,
       imageCostByTier,
+      imageTiers,
       onGenerateGif,
       gifCreditCost,
       onRemoveBackground,

package/components/detail-page/detail-page-host-context.tsx

@@ -40,6 +40,7 @@ import type {
   DetailPageGroupEditItem,
   DetailPageGroupPromptEditResult,
   DetailPageImageEditResult,
+  DetailPagePromoteImageResult,
   DetailPageInsufficientCreditsDetail,
   DetailPagePersonalShapeSaveResult,
   DetailPagePromptEditResult,
@@ -117,6 +118,25 @@ export interface DetailPageHostApi {
     },
     signal?: AbortSignal,
   ) => Promise<DetailPageImageEditResult>;
+  /**
+   * 저작이 만든 사진 한 장을 브랜드 자산으로 승격한다.
+   *
+   * 사진은 문서에 이미 박혀 있는 `job_id`·`name`·`sig` 로 가리킨다 — 서버가 그 서명을
+   * 먼저 검증하므로, 편집기가 임의의 주소를 대신 받아 오게 만들 수 없다.
+   *
+   * 선택 사항이다. 호스트가 안 주면 "브랜드 이미지로 저장" 버튼이 뜨지 않는다 — 이
+   * 편집기를 쓰는 앱이 둘이라, 필수로 두면 한쪽이 늦는 동안 다른 쪽까지 못 올린다.
+   */
+  promoteAuthoringImageToBrand?: (
+    payload: {
+      job_id: string;
+      name: string;
+      sig: string;
+      brand_id: string;
+      display_name?: string;
+    },
+    signal?: AbortSignal,
+  ) => Promise<DetailPagePromoteImageResult>;
   svgPromptEditDetailPage: (
     generatedId: string,
     payload: { slot_role?: string; current_svg: string; instruction: string },

package/components/detail-page/detail-page-properties-panel.tsx

@@ -26,6 +26,7 @@ import {
   Ungroup,
   Type as TypeIcon,
   Image as ImageIcon,
+  ImagePlus,
   Film,
   Eraser,
   Square,
@@ -70,6 +71,7 @@ import {
 import { readColorReplace } from "@leviosa-ai/canvas/render/svg-source";
 import { selectedElementsDeep } from "./detail-page-selection";
 import { useEditorAi } from "./editor-ai-context";
+import { parseAuthoringImageSrc } from "../../lib/detail-page/authoring-image-src";
 import { PromptEditPanel } from "./prompt-edit-panel";
 import { SvgPromptEditPanel } from "./svg-prompt-edit-panel";
 import { GroupPromptEditPanel } from "./group-prompt-edit-panel";
@@ -1886,6 +1888,78 @@ async function saveShapeToMyShapes(
   }
 }
 
+/**
+ * 저작 사진을 브랜드 라이브러리에 남기는 버튼.
+ *
+ * 저작 사진은 잡 아래 산다. 고른 잡은 이제 만료하지 않으니 사진이 죽지는 않지만, 그
+ * 사진은 여전히 **그 잡의 것**이라 다음 상품을 만들 때 라이브러리에서 고를 수 없다.
+ * 승격은 한 장을 브랜드 자산으로 복사해 그 벽을 없앤다.
+ *
+ * 전부 자동으로 복사하지 않는 이유는 저작 한 번에 십수 장이 들어와 라이브러리가
+ * 폐기물로 차기 때문이다 — **셀러가 누르는 행위 자체가 신호다.**
+ *
+ * 사진의 `src` 가 저작 주소로 파싱될 때만 뜬다. 셀러가 직접 올린 것, 브랜드에서 가져온
+ * 것, 이미 브랜드에 들어간 AI 이미지는 승격할 이유가 없다.
+ */
+const SaveImageToBrandButton = observer(function SaveImageToBrandButton({
+  src,
+  label,
+}: {
+  src: string;
+  label: string;
+}) {
+  const { t } = useTranslation("branding");
+  const host = useDetailPageHost();
+  const { brand } = host;
+  const [saving, setSaving] = useState(false);
+
+  const ref = parseAuthoringImageSrc(src);
+  const brandId = brand.getStoredActiveBrandId() ?? "";
+  const promote = host.api.promoteAuthoringImageToBrand;
+  // 브랜드가 안 골라져 있으면 넣을 곳이 없다. 버튼을 띄워 놓고 누른 뒤에 알려 주면
+  // 셀러는 저장이 실패했다고 읽는다. 호스트가 승격을 안 붙였을 때도 마찬가지다.
+  if (!ref || !brandId || !promote) return null;
+
+  const save = async () => {
+    if (saving) return;
+    setSaving(true);
+    try {
+      const res = await promote({
+        job_id: ref.jobId,
+        name: ref.name,
+        sig: ref.sig,
+        brand_id: brandId,
+        display_name: label,
+      });
+      host.toast.success(
+        res.reused
+          ? t("detailPage.properties.saveToBrandDuplicate")
+          : t("detailPage.properties.saveToBrandDone"),
+      );
+    } catch {
+      host.toast.error(t("detailPage.properties.saveToBrandFailed"));
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  return (
+    <div className="border-t border-dpe-ink-200 px-4 py-2">
+      <button
+        type="button"
+        disabled={saving}
+        onClick={() => void save()}
+        className="flex w-full items-center justify-center gap-1.5 rounded-dpe-lg border border-dpe-ink-200 py-2 text-xs font-dpe-medium text-dpe-ink-600 hover:border-dpe-ink-400 hover:bg-dpe-ink-50 disabled:opacity-50"
+      >
+        <ImagePlus size={13} />
+        {saving
+          ? t("detailPage.properties.saveToBrandSaving")
+          : t("detailPage.properties.saveToBrand")}
+      </button>
+    </div>
+  );
+});
+
 // svg 도형(벡터 장식)용 인스펙터: 불투명도 + "내 도형에 저장" + 프롬프트 편집(생성
 // ID·디코드 가능한 마크업이 있을 때만) + 삭제. figure 등 마크업이 없는 도형은
 // 저장/프롬프트 편집을 숨긴다.
@@ -2296,10 +2370,15 @@ export const ElementAiEditPanel = observer(function ElementAiEditPanel({
           initialMode={isGif ? "gif" : "image"}
           onResult={(src) => single.set({ src })}
           costByTier={ai.imageCostByTier}
+          tiers={ai.imageTiers}
           creditCost={ai.imageCreditCost}
           creditBalance={ai.imageCreditBalance}
           onBuyCredits={ai.onBuyCredits}
         />
+        <SaveImageToBrandButton
+          src={str(single.src)}
+          label={str(singleCustom.leviosaSlot ?? "")}
+        />
       </section>
     );
   }

package/components/detail-page/detail-page-sidebar-sections.tsx

@@ -138,6 +138,7 @@ export type BuildSectionsOptions = {
   imageCreditBalance?: number;
   /** 티어별(basic/pro/max) 크레딧 단가. 모델 드롭다운의 각 항목 비용에 쓴다. */
   imageCostByTier?: Partial<Record<ImageTier, number>>;
+  imageTiers?: readonly ImageTier[];
   /** 크레딧 부족 시 "크레딧 추가하기" 목적지(레비오사 pricing). */
   onBuyImageCredits?: () => void;
   /** AI 생성 결과를 현재 브랜드 중앙 에셋에 미러링. */
@@ -167,6 +168,7 @@ export function buildDetailPageSections({
   imageCreditCost,
   imageCreditBalance,
   imageCostByTier,
+  imageTiers,
   onBuyImageCredits,
   structurePanel,
   generatedId,
@@ -225,6 +227,7 @@ export function buildDetailPageSections({
         gifCreditCost={gifCreditCost}
         uploadFile={uploadFile}
         costByTier={imageCostByTier}
+        tiers={imageTiers}
         creditCost={imageCreditCost}
         creditBalance={imageCreditBalance}
         onBuyCredits={onBuyImageCredits}

package/components/detail-page/editor-ai-context.tsx

@@ -29,6 +29,7 @@ export type EditorAiValue = {
   imageCreditCost?: number;
   imageCreditBalance?: number;
   imageCostByTier?: Partial<Record<ImageTier, number>>;
+  imageTiers?: readonly ImageTier[];
   onGenerateGif?: GenerateGifFn;
   gifCreditCost?: number;
   onRemoveBackground?: RemoveBackgroundFn;

package/i18n/en.json

@@ -104,6 +104,11 @@
         "shapeSaved": "Saved to brand shapes.",
         "shapeColors": "Colors",
         "shapeColorsReset": "Reset to original colors",
+        "saveToBrand": "Save to brand images",
+        "saveToBrandSaving": "Saving…",
+        "saveToBrandDone": "Saved to brand images.",
+        "saveToBrandDuplicate": "Already in brand images.",
+        "saveToBrandFailed": "Could not save to brand images.",
         "saveToMyShapes": "Save to brand shapes",
         "aiShapeEdit": "AI shape editing",
         "pageHeight": "Section height",

package/i18n/ko.json

@@ -104,6 +104,11 @@
         "shapeSaved": "브랜드 도형에 저장했어요.",
         "shapeColors": "색",
         "shapeColorsReset": "원래 색으로 되돌리기",
+        "saveToBrand": "브랜드 이미지로 저장",
+        "saveToBrandSaving": "저장하는 중…",
+        "saveToBrandDone": "브랜드 이미지에 저장했어요.",
+        "saveToBrandDuplicate": "이미 브랜드 이미지에 있어요.",
+        "saveToBrandFailed": "브랜드 이미지에 저장하지 못했어요.",
         "saveToMyShapes": "브랜드 도형에 저장",
         "aiShapeEdit": "AI 도형 편집",
         "pageHeight": "섹션 높이",

package/lib/detail-page/authoring-image-src.ts

@@ -0,0 +1,83 @@
+/**
+ * 저작이 만든 사진인지 **주소만 보고** 알아낸다.
+ *
+ * 브랜드 저작이 만든 사진은 문서에 잡 주소로 박힌다:
+ *
+ * ```
+ * https://<host>/api/v2/detail-pages/brand-authoring/{job_id}/images/{name}?sig=<hmac>
+ * ```
+ *
+ * 이 사진을 브랜드 자산으로 승격하려면 서버에 그 셋(`job_id`·`name`·`sig`)을 그대로
+ * 넘겨야 한다. 서버는 서명을 먼저 검증하고 나서야 바이트를 읽는다 — 그렇게 하지 않으면
+ * 로그인만 하면 임의의 주소를 대신 받아 오는 통로가 된다.
+ *
+ * 편집기가 들고 있는 것은 `el.src` 뿐이므로, 승격 버튼을 띄울지 말지도 이 파싱 하나로
+ * 정해진다. **파싱되지 않으면 저작 사진이 아니다** — 셀러가 직접 올린 것, 브랜드
+ * 라이브러리에서 가져온 것, AI 가 만들어 이미 브랜드에 들어간 것은 모두 승격할 이유가
+ * 없고, 실제로 이 모양이 아니다.
+ *
+ * 상대 주소·절대 주소·프록시 경유를 모두 받는다. 어느 쪽이든 경로와 질의만 보면 된다.
+ */
+
+export interface AuthoringImageRef {
+  /** 이 사진을 만든 저작 잡. */
+  jobId: string;
+  /** 명세가 정한 사진 이름. */
+  name: string;
+  /** 주소에 이미 붙어 있는 HMAC 서명. 서버가 권한 증거로 쓴다. */
+  sig: string;
+}
+
+/** 라우터 mount prefix + 라우트 경로. 소싱 서버의 `BRAND_LANE_IMAGE_PATH` 와 같아야 한다. */
+const LANE_IMAGE_PATH = "/api/v2/detail-pages/brand-authoring/";
+
+/**
+ * 저작 사진 주소를 (잡, 이름, 서명)으로 쪼갠다. 저작 사진이 아니면 `null`.
+ *
+ * 셋 중 하나라도 비면 `null` 이다. 반쪽짜리를 넘기면 서버는 어차피 404 로 돌려보내는데,
+ * 버튼은 이미 눌린 뒤라 셀러에게는 "저장이 실패했다"로 보인다.
+ */
+export function parseAuthoringImageSrc(src: string): AuthoringImageRef | null {
+  const raw = String(src ?? "").trim();
+  if (!raw || raw.startsWith("data:") || raw.startsWith("blob:")) return null;
+
+  // 절대 주소로 와도 경로만 보면 된다. base 는 상대 주소를 파싱하기 위한 것일 뿐이라
+  // 값 자체는 쓰이지 않는다.
+  let url: URL;
+  try {
+    url = new URL(raw, "https://placeholder.invalid");
+  } catch {
+    return null;
+  }
+
+  const path = url.pathname;
+  if (!path.startsWith(LANE_IMAGE_PATH)) return null;
+
+  const rest = path.slice(LANE_IMAGE_PATH.length).replace(/\/+$/, "");
+  const parts = rest.split("/");
+  // {job_id}/images/{name} — 정확히 셋이어야 한다. 폴링(`{job_id}`)이나
+  // 고르기(`{job_id}/select`)가 같이 걸리면 안 된다.
+  if (parts.length !== 3 || parts[1] !== "images") return null;
+
+  const jobId = safeDecode(parts[0]);
+  const name = safeDecode(parts[2]);
+  const sig = url.searchParams.get("sig") ?? "";
+  if (!jobId || !name || !sig) return null;
+
+  return { jobId, name, sig };
+}
+
+/** 저작 사진인지만 묻는다. 버튼을 띄울지 정하는 자리에서 쓴다. */
+export function isAuthoringImageSrc(src: string): boolean {
+  return parseAuthoringImageSrc(src) !== null;
+}
+
+function safeDecode(value: string): string {
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    // 인코딩이 깨진 이름은 디코드하면 던진다. 그때는 원문 그대로 넘긴다 — 서명이
+    // 원문에 대해 만들어졌으므로 서버가 판단하게 두는 편이 맞다.
+    return value;
+  }
+}

package/lib/detail-page/image-credit.ts

@@ -13,6 +13,27 @@ export type ImageTier = "basic" | "pro" | "max";
 /** 선택 UI에 노출할 티어 순서(저→고 품질). */
 export const IMAGE_TIERS: ImageTier[] = ["basic", "pro", "max"];
 
+/**
+ * 이 편집기가 실제로 고르게 할 티어.
+ *
+ * 소비자마다 파는 것이 다르다. 소싱은 셋을 다 팔지만, 에이전시 요금표는 basic 을
+ * 은퇴시키고 pro 를 기본으로 뒀다 — 값이 없는 티어를 드롭다운에 남겨 두면 사용자는
+ * 고를 수 있는데 아무도 청구를 못 하는 자리가 생긴다.
+ *
+ * 안 주면 지금까지대로 셋 다. 준 값이 비었거나 아는 티어가 하나도 없으면 그것도
+ * 셋 다로 되돌린다 — 빈 드롭다운은 "AI 이미지를 못 만드는 편집기"이고, 그건 소비자가
+ * 배열 하나를 잘못 넘겨서 벌어질 만한 일이 아니다.
+ */
+export function resolveImageTiers(allowed?: readonly ImageTier[]): ImageTier[] {
+  const picked = IMAGE_TIERS.filter((tier) => allowed?.includes(tier));
+  return picked.length > 0 ? picked : IMAGE_TIERS;
+}
+
+/** 목록 안의 기본 티어. 기본값이 빠진 목록이면 그 목록의 첫 항목. */
+export function resolveDefaultImageTier(tiers: readonly ImageTier[]): ImageTier {
+  return tiers.includes(DEFAULT_IMAGE_TIER) ? DEFAULT_IMAGE_TIER : tiers[0];
+}
+
 export const IMAGE_FEATURE_KEYS: Record<ImageTier, string> = {
   basic: "detail_page_image_basic",
   pro: "detail_page_image_pro",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leviosa-ai/detail-page-editor",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "Leviosa detail-page editor shell. Source-only: consumers compile it through Next transpilePackages. Every app coupling (sourcing server, brand store, cache keys, toast) arrives through the DetailPageHost interface, and every URL it fetches comes from configureDetailPageEditor.",
   "type": "module",
   "license": "UNLICENSED",

package/types/detail-page-api.ts

@@ -89,6 +89,20 @@ export interface DetailPageGroupPromptEditResult {
   svg_limit: number;
 }
 
+/** 저작 사진을 브랜드 자산으로 승격한 결과. */
+export interface DetailPagePromoteImageResult {
+  asset_id: string;
+  /**
+   * 15분짜리 presigned. **문서에 박으면 안 된다** — 그 시간 뒤에 403 이 된다.
+   * 문서에 남길 주소는 `stable_path` 다.
+   */
+  url?: string;
+  /** 만료가 없는 서명 경로. 브랜드 라이브러리가 이 주소로 이 사진을 연다. */
+  stable_path?: string;
+  /** 같은 바이트가 이미 있어 새로 넣지 않았다는 뜻. */
+  reused?: boolean;
+}
+
 export interface DetailPageImageEditResult {
   success: boolean;
   message?: string;