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

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 등 마크업이 없는 도형은
 // 저장/프롬프트 편집을 숨긴다.
@@ -2300,6 +2374,10 @@ export const ElementAiEditPanel = observer(function ElementAiEditPanel({
           creditBalance={ai.imageCreditBalance}
           onBuyCredits={ai.onBuyCredits}
         />
+        <SaveImageToBrandButton
+          src={str(single.src)}
+          label={str(singleCustom.leviosaSlot ?? "")}
+        />
       </section>
     );
   }

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leviosa-ai/detail-page-editor",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "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;