@sayren/store-sdk 0.18.0 → 0.19.0

package/dist/index.d.mts

@@ -165,8 +165,8 @@ export declare const auditLogPageSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AuditLogPage = z.infer<typeof auditLogPageSchema>;
 export declare const agentPolicyDecisionSchema: z.ZodEnum<{
-  APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
   DENIED: "DENIED";
+  APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
   ALLOW: "ALLOW";
 }>;
 export type AgentPolicyDecision = z.infer<typeof agentPolicyDecisionSchema>;
@@ -190,8 +190,8 @@ export type WritePreview = z.infer<typeof writePreviewSchema>;
 export declare const writeDryRunResultSchema: z.ZodObject<{
   dryRun: z.ZodLiteral<true>;
   decision: z.ZodEnum<{
-    APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
     DENIED: "DENIED";
+    APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
     ALLOW: "ALLOW";
   }>;
   reason: z.ZodNullable<z.ZodString>;
@@ -921,8 +921,8 @@ export declare const oauthClientRegistrationRequestSchema: z.ZodObject<{
   }>>;
   redirect_uris: z.ZodOptional<z.ZodArray<z.ZodString>>;
   grant_types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-    refresh_token: "refresh_token";
     authorization_code: "authorization_code";
+    refresh_token: "refresh_token";
     client_credentials: "client_credentials";
     "urn:ietf:params:oauth:grant-type:token-exchange": "urn:ietf:params:oauth:grant-type:token-exchange";
   }>>>;
@@ -1073,9 +1073,9 @@ export type ApiLogSummary = z.infer<typeof apiLogSummarySchema>;
 //#endregion
 //#region src/schemas/auth.d.ts
 export declare const storeRoleSchema: z.ZodEnum<{
-  OWNER: "OWNER";
   ADMIN: "ADMIN";
   STAFF: "STAFF";
+  OWNER: "OWNER";
 }>;
 export type StoreRole = z.infer<typeof storeRoleSchema>;
 export declare const userTokenResponseSchema: z.ZodObject<{
@@ -1099,9 +1099,9 @@ export declare const storeTokenResponseSchema: z.ZodObject<{
   expires_in: z.ZodNumber;
   storeId: z.ZodString;
   role: z.ZodEnum<{
-    OWNER: "OWNER";
     ADMIN: "ADMIN";
     STAFF: "STAFF";
+    OWNER: "OWNER";
   }>;
   scopes: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
@@ -1111,9 +1111,9 @@ export declare const myStoreSchema: z.ZodObject<{
   storeName: z.ZodString;
   storeCode: z.ZodString;
   role: z.ZodEnum<{
-    OWNER: "OWNER";
     ADMIN: "ADMIN";
     STAFF: "STAFF";
+    OWNER: "OWNER";
   }>;
   status: z.ZodEnum<{
     ACTIVE: "ACTIVE";
@@ -5322,20 +5322,20 @@ export interface PaymentListParams extends PageParams {
 //#endregion
 //#region src/schemas/product.d.ts
 export declare const productStatusSchema: z.ZodEnum<{
-  SUSPENDED: "SUSPENDED";
-  CLOSED: "CLOSED";
   SALE: "SALE";
+  SUSPENDED: "SUSPENDED";
   OUT_OF_STOCK: "OUT_OF_STOCK";
+  CLOSED: "CLOSED";
 }>;
 export type ProductStatus = z.infer<typeof productStatusSchema>;
 export declare const productSummarySchema: z.ZodObject<{
   productId: z.ZodString;
   name: z.ZodString;
   status: z.ZodEnum<{
-    SUSPENDED: "SUSPENDED";
-    CLOSED: "CLOSED";
     SALE: "SALE";
+    SUSPENDED: "SUSPENDED";
     OUT_OF_STOCK: "OUT_OF_STOCK";
+    CLOSED: "CLOSED";
   }>;
   salePrice: z.ZodNumber;
   discountedPrice: z.ZodNullable<z.ZodNumber>;
@@ -5402,10 +5402,10 @@ export declare const productSchema: z.ZodObject<{
   productId: z.ZodString;
   name: z.ZodString;
   status: z.ZodEnum<{
-    SUSPENDED: "SUSPENDED";
-    CLOSED: "CLOSED";
     SALE: "SALE";
+    SUSPENDED: "SUSPENDED";
     OUT_OF_STOCK: "OUT_OF_STOCK";
+    CLOSED: "CLOSED";
   }>;
   salePrice: z.ZodNumber;
   discountedPrice: z.ZodNullable<z.ZodNumber>;
@@ -5824,10 +5824,10 @@ export declare const productPatchRequestSchema: z.ZodObject<{
   name: z.ZodOptional<z.ZodString>;
   salePrice: z.ZodOptional<z.ZodNumber>;
   status: z.ZodOptional<z.ZodEnum<{
-    SUSPENDED: "SUSPENDED";
-    CLOSED: "CLOSED";
     SALE: "SALE";
+    SUSPENDED: "SUSPENDED";
     OUT_OF_STOCK: "OUT_OF_STOCK";
+    CLOSED: "CLOSED";
   }>>;
   fulfillment: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
@@ -5902,10 +5902,10 @@ export declare const productListQuerySchema: z.ZodObject<{
   page: z.ZodOptional<z.ZodString>;
   size: z.ZodOptional<z.ZodString>;
   status: z.ZodOptional<z.ZodEnum<{
-    SUSPENDED: "SUSPENDED";
-    CLOSED: "CLOSED";
     SALE: "SALE";
+    SUSPENDED: "SUSPENDED";
     OUT_OF_STOCK: "OUT_OF_STOCK";
+    CLOSED: "CLOSED";
   }>>;
   categoryId: z.ZodOptional<z.ZodString>;
   keyword: z.ZodOptional<z.ZodString>;
@@ -6042,9 +6042,9 @@ export declare const storeMemberSchema: z.ZodObject<{
   name: z.ZodString;
   email: z.ZodEmail;
   role: z.ZodEnum<{
-    OWNER: "OWNER";
     ADMIN: "ADMIN";
     STAFF: "STAFF";
+    OWNER: "OWNER";
   }>;
   joinedAt: z.ZodString;
   lastActiveAt: z.ZodNullable<z.ZodString>;
@@ -6174,6 +6174,331 @@ export declare const sellerAddressRequestSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type SellerAddressRequest = z.infer<typeof sellerAddressRequestSchema>;
 //#endregion
+//#region src/schemas/storefront-hosting.d.ts
+/**
+ * 스토어프론트 호스팅 (이슈 #53, M1: 템플릿 발행) — 관리 API `/v1/storefront/**`의 계약이다.
+ *
+ * 셀러는 템플릿을 골라 사이트를 만들고 `{slug}.{호스팅 도메인}` 주소를 받는다. 발행은 버전 단위이고,
+ * 되돌리기는 이전 버전을 다시 발행하는 것이다(재빌드 없음). 상태의 원천은 api DB이고 Cloudflare 쪽 반영
+ * (라우팅 표·사이트 Worker)은 커밋 뒤 비동기다 — 반영 상태는 `provisioning`으로 본다.
+ *
+ * 스코프는 조회 `storefront:r`, 쓰기 `storefront:rw`(역할 OWNER·ADMIN)다. 에이전트(MCP)의 발행·되돌리기·템플릿 변경·
+ * 공개 전환·슬러그 변경·호스팅 끄기는 승인(`APPROVAL_REQUIRED`)이다 — 구매자가 보는 화면을 바꾸는 쓰기다.
+ *
+ * 오류 코드:
+ * - 403 `STOREFRONT_HOSTING_DISABLED` — 플랫폼 스위치가 꺼져 새 사이트를 만들 수 없다
+ * - 404 `STOREFRONT_SITE_NOT_FOUND` · `STOREFRONT_TEMPLATE_NOT_FOUND` · `STOREFRONT_VERSION_NOT_FOUND`
+ * - 409 `STOREFRONT_SITE_EXISTS` — 이미 사이트가 있다(스토어당 1개)
+ * - 409 `STOREFRONT_SLUG_TAKEN` — 다른 사이트가 쓰거나 보류 중인 슬러그다
+ * - 409 `STOREFRONT_SLUG_CHANGE_LIMIT` — 슬러그는 스토어당 30일에 3번까지 바꾼다
+ * - 409 `STOREFRONT_SITE_CREATE_LIMIT` — 사이트는 스토어당 30일에 3번까지 만든다
+ * - 409 `STOREFRONT_SITE_CHANGED` — 읽은 상태(`expected*`)와 현재 상태가 다르다. 다시 읽고 시도한다
+ * - 409 `STOREFRONT_SITE_NOT_ACTIVE` — 정지(`SUSPENDED`)된 사이트는 바꾸거나 끌 수 없다
+ * - 409 `STOREFRONT_VERSION_NOT_READY` — 빌드가 끝나지 않았거나 실패한 버전은 발행할 수 없다
+ * - 409 `STOREFRONT_NO_ROLLBACK_TARGET` — 되돌릴 이전 발행 버전이 없다
+ * - 400 `STOREFRONT_SLUG_CONFIRM_MISMATCH` — 호스팅 끄기 확인 입력이 현재 슬러그와 다르다
+ * - 503 `STOREFRONT_PREVIEW_NOT_CONFIGURED` — 미리보기 서명 키가 설정되지 않았다
+ */
+/**
+ * 슬러그 형식 — 스토어 코드와 같은 DNS 라벨 규칙(소문자·숫자·하이픈 3~30자, 하이픈으로 시작·끝 불가)에
+ * 연속 하이픈 금지를 더한다. `--`는 버전 미리보기 주소(`v3--{slug}`)와 punycode(`xn--`)가 쓰는 구분자다.
+ */
+export declare const STOREFRONT_SLUG_PATTERN: RegExp;
+/** 호스팅 도메인에서 플랫폼이 쓰거나 쓸 이름 — 스토어 코드 예약어에 호스팅 전용 이름을 더한다 */
+export declare const RESERVED_STOREFRONT_SLUGS: readonly string[];
+export declare function isReservedStorefrontSlug(slug: string): boolean;
+export declare const storefrontSlugSchema: z.ZodString;
+/** 바꾼 슬러그를 다른 사이트가 가져가지 못하게 막는 기간(일). 보류 동안 옛 주소는 새 주소로 301한다 */
+export declare const STOREFRONT_SLUG_HOLD_DAYS = 90;
+/** 슬러그 변경 한도 — 이 기간(일) 안에 */
+export declare const STOREFRONT_SLUG_CHANGE_WINDOW_DAYS = 30;
+/** 슬러그 변경 한도 — 횟수(스토어 단위. 끄고 다시 만들어도 이어서 센다) */
+export declare const STOREFRONT_SLUG_CHANGE_LIMIT = 3;
+/** 사이트 만들기 한도 — 같은 창(30일) 안의 횟수(스토어 단위). 끄고 만들기를 되풀이해 이름을 묶어 두지 못하게 한다 */
+export declare const STOREFRONT_SITE_CREATE_LIMIT = 3;
+export declare const storefrontTemplateSchema: z.ZodObject<{
+  templateId: z.ZodString;
+  name: z.ZodString;
+  industry: z.ZodString;
+  description: z.ZodString;
+  thumbnailUrl: z.ZodNullable<z.ZodString>;
+  version: z.ZodString;
+  isDefault: z.ZodBoolean;
+}, z.core.$strip>;
+export type StorefrontTemplate = z.infer<typeof storefrontTemplateSchema>;
+/**
+ * 버전 상태 — M1은 템플릿 빌드 산출물을 그대로 쓰므로 만들 때 곧바로 `READY`다. `BUILDING`·`FAILED`는
+ * 셀러 편집 빌드(M2)가 쓴다. 발행 여부는 상태가 아니라 사이트의 발행 포인터가 원천이다(`published`).
+ */
+export declare const storefrontVersionStatusSchema: z.ZodEnum<{
+  FAILED: "FAILED";
+  BUILDING: "BUILDING";
+  READY: "READY";
+}>;
+export type StorefrontVersionStatus = z.infer<typeof storefrontVersionStatusSchema>;
+export declare const storefrontVersionSchema: z.ZodObject<{
+  versionId: z.ZodString;
+  number: z.ZodNumber;
+  templateId: z.ZodString;
+  templateVersion: z.ZodString;
+  status: z.ZodEnum<{
+    FAILED: "FAILED";
+    BUILDING: "BUILDING";
+    READY: "READY";
+  }>;
+  published: z.ZodBoolean;
+  publishedAt: z.ZodNullable<z.ZodString>;
+  message: z.ZodNullable<z.ZodString>;
+  createdByType: z.ZodString;
+  createdAt: z.ZodString;
+}, z.core.$strip>;
+export type StorefrontVersion = z.infer<typeof storefrontVersionSchema>;
+export declare const storefrontSiteStatusSchema: z.ZodEnum<{
+  ACTIVE: "ACTIVE";
+  SUSPENDED: "SUSPENDED";
+  CLOSED: "CLOSED";
+}>;
+export type StorefrontSiteStatus = z.infer<typeof storefrontSiteStatusSchema>;
+export declare const storefrontVisibilitySchema: z.ZodEnum<{
+  COMING_SOON: "COMING_SOON";
+  PUBLIC: "PUBLIC";
+}>;
+export type StorefrontVisibility = z.infer<typeof storefrontVisibilitySchema>;
+export declare const storefrontSourceModeSchema: z.ZodEnum<{
+  CUSTOM: "CUSTOM";
+  MANAGED: "MANAGED";
+}>;
+export declare const storefrontDomainSchema: z.ZodObject<{
+  hostname: z.ZodString;
+  kind: z.ZodEnum<{
+    PLATFORM: "PLATFORM";
+    CUSTOM: "CUSTOM";
+  }>;
+  status: z.ZodEnum<{
+    ACTIVE: "ACTIVE";
+    HELD: "HELD";
+  }>;
+  isPrimary: z.ZodBoolean;
+  holdUntil: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type StorefrontDomain = z.infer<typeof storefrontDomainSchema>;
+/**
+ * 호스팅 반영 상태 — 발행·슬러그·공개 전환은 DB에 먼저 확정되고 Cloudflare 반영은 커밋 뒤에 한다.
+ * `PENDING`이면 반영 중이거나 재시도 대기다(잡이 다시 한다). 반영 뒤에도 라우팅 전파에 최대 1분이 걸린다.
+ */
+export declare const storefrontProvisioningSchema: z.ZodObject<{
+  status: z.ZodEnum<{
+    PENDING: "PENDING";
+    FAILED: "FAILED";
+    SYNCED: "SYNCED";
+  }>;
+  lastErrorCode: z.ZodNullable<z.ZodString>;
+  syncedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type StorefrontProvisioning = z.infer<typeof storefrontProvisioningSchema>;
+export declare const storefrontSiteSchema: z.ZodObject<{
+  siteId: z.ZodString;
+  slug: z.ZodString;
+  hostname: z.ZodString;
+  url: z.ZodString;
+  domains: z.ZodArray<z.ZodObject<{
+    hostname: z.ZodString;
+    kind: z.ZodEnum<{
+      PLATFORM: "PLATFORM";
+      CUSTOM: "CUSTOM";
+    }>;
+    status: z.ZodEnum<{
+      ACTIVE: "ACTIVE";
+      HELD: "HELD";
+    }>;
+    isPrimary: z.ZodBoolean;
+    holdUntil: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+  templateId: z.ZodString;
+  sourceMode: z.ZodEnum<{
+    CUSTOM: "CUSTOM";
+    MANAGED: "MANAGED";
+  }>;
+  status: z.ZodEnum<{
+    ACTIVE: "ACTIVE";
+    SUSPENDED: "SUSPENDED";
+    CLOSED: "CLOSED";
+  }>;
+  visibility: z.ZodEnum<{
+    COMING_SOON: "COMING_SOON";
+    PUBLIC: "PUBLIC";
+  }>;
+  publishedVersion: z.ZodNullable<z.ZodObject<{
+    versionId: z.ZodString;
+    number: z.ZodNumber;
+    templateId: z.ZodString;
+    templateVersion: z.ZodString;
+    status: z.ZodEnum<{
+      FAILED: "FAILED";
+      BUILDING: "BUILDING";
+      READY: "READY";
+    }>;
+    published: z.ZodBoolean;
+    publishedAt: z.ZodNullable<z.ZodString>;
+    message: z.ZodNullable<z.ZodString>;
+    createdByType: z.ZodString;
+    createdAt: z.ZodString;
+  }, z.core.$strip>>;
+  provisioning: z.ZodObject<{
+    status: z.ZodEnum<{
+      PENDING: "PENDING";
+      FAILED: "FAILED";
+      SYNCED: "SYNCED";
+    }>;
+    lastErrorCode: z.ZodNullable<z.ZodString>;
+    syncedAt: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+  slugChangesRemaining: z.ZodNumber;
+  createdAt: z.ZodString;
+  updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type StorefrontSite = z.infer<typeof storefrontSiteSchema>;
+/** `GET /v1/storefront/site` — 스위치 상태와 현재 사이트(없으면 null. 끈 사이트는 싣지 않는다) */
+export declare const storefrontHostingSchema: z.ZodObject<{
+  enabled: z.ZodBoolean;
+  domain: z.ZodString;
+  site: z.ZodNullable<z.ZodObject<{
+    siteId: z.ZodString;
+    slug: z.ZodString;
+    hostname: z.ZodString;
+    url: z.ZodString;
+    domains: z.ZodArray<z.ZodObject<{
+      hostname: z.ZodString;
+      kind: z.ZodEnum<{
+        PLATFORM: "PLATFORM";
+        CUSTOM: "CUSTOM";
+      }>;
+      status: z.ZodEnum<{
+        ACTIVE: "ACTIVE";
+        HELD: "HELD";
+      }>;
+      isPrimary: z.ZodBoolean;
+      holdUntil: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    templateId: z.ZodString;
+    sourceMode: z.ZodEnum<{
+      CUSTOM: "CUSTOM";
+      MANAGED: "MANAGED";
+    }>;
+    status: z.ZodEnum<{
+      ACTIVE: "ACTIVE";
+      SUSPENDED: "SUSPENDED";
+      CLOSED: "CLOSED";
+    }>;
+    visibility: z.ZodEnum<{
+      COMING_SOON: "COMING_SOON";
+      PUBLIC: "PUBLIC";
+    }>;
+    publishedVersion: z.ZodNullable<z.ZodObject<{
+      versionId: z.ZodString;
+      number: z.ZodNumber;
+      templateId: z.ZodString;
+      templateVersion: z.ZodString;
+      status: z.ZodEnum<{
+        FAILED: "FAILED";
+        BUILDING: "BUILDING";
+        READY: "READY";
+      }>;
+      published: z.ZodBoolean;
+      publishedAt: z.ZodNullable<z.ZodString>;
+      message: z.ZodNullable<z.ZodString>;
+      createdByType: z.ZodString;
+      createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    provisioning: z.ZodObject<{
+      status: z.ZodEnum<{
+        PENDING: "PENDING";
+        FAILED: "FAILED";
+        SYNCED: "SYNCED";
+      }>;
+      lastErrorCode: z.ZodNullable<z.ZodString>;
+      syncedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    slugChangesRemaining: z.ZodNumber;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type StorefrontHosting = z.infer<typeof storefrontHostingSchema>;
+export declare const storefrontSlugAvailabilitySchema: z.ZodObject<{
+  slug: z.ZodString;
+  available: z.ZodBoolean;
+  reason: z.ZodNullable<z.ZodEnum<{
+    RESERVED: "RESERVED";
+    INVALID: "INVALID";
+    TAKEN: "TAKEN";
+    CURRENT: "CURRENT";
+  }>>;
+}, z.core.$strip>;
+export type StorefrontSlugAvailability = z.infer<typeof storefrontSlugAvailabilitySchema>;
+export declare const createStorefrontSiteRequestSchema: z.ZodObject<{
+  templateId: z.ZodString;
+  slug: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CreateStorefrontSiteRequest = z.infer<typeof createStorefrontSiteRequestSchema>;
+export declare const changeStorefrontTemplateRequestSchema: z.ZodObject<{
+  templateId: z.ZodString;
+  publish: z.ZodOptional<z.ZodBoolean>;
+  message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ChangeStorefrontTemplateRequest = z.infer<typeof changeStorefrontTemplateRequestSchema>;
+/**
+ * 발행·되돌리기 — 발행은 사이트의 발행 포인터를 바꾸는 조건부 쓰기다. `expectedPublishedVersionId`를 주면
+ * 지금 발행 버전이 그 값일 때만 바꾼다(화면을 본 뒤 다른 사람이 바꿨으면 409 `STOREFRONT_SITE_CHANGED`).
+ * 이미 그 버전이 발행돼 있으면 아무것도 바꾸지 않고 200이다(같은 요청의 재실행이 안전하다).
+ */
+export declare const publishStorefrontVersionRequestSchema: z.ZodObject<{
+  expectedPublishedVersionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type PublishStorefrontVersionRequest = z.infer<typeof publishStorefrontVersionRequestSchema>;
+export declare const rollbackStorefrontRequestSchema: z.ZodObject<{
+  versionId: z.ZodOptional<z.ZodString>;
+  expectedPublishedVersionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type RollbackStorefrontRequest = z.infer<typeof rollbackStorefrontRequestSchema>;
+export declare const changeStorefrontSlugRequestSchema: z.ZodObject<{
+  slug: z.ZodString;
+}, z.core.$strip>;
+export type ChangeStorefrontSlugRequest = z.infer<typeof changeStorefrontSlugRequestSchema>;
+export declare const setStorefrontVisibilityRequestSchema: z.ZodObject<{
+  visibility: z.ZodEnum<{
+    COMING_SOON: "COMING_SOON";
+    PUBLIC: "PUBLIC";
+  }>;
+  expectedVisibility: z.ZodOptional<z.ZodEnum<{
+    COMING_SOON: "COMING_SOON";
+    PUBLIC: "PUBLIC";
+  }>>;
+}, z.core.$strip>;
+export type SetStorefrontVisibilityRequest = z.infer<typeof setStorefrontVisibilityRequestSchema>;
+/** 호스팅 끄기 — 사이트를 닫고(`CLOSED`) 슬러그를 보류한다. 확인 입력은 현재 슬러그다 */
+export declare const disableStorefrontHostingRequestSchema: z.ZodObject<{
+  confirmSlug: z.ZodString;
+}, z.core.$strip>;
+export type DisableStorefrontHostingRequest = z.infer<typeof disableStorefrontHostingRequestSchema>;
+export declare const storefrontSlugAvailabilityQuerySchema: z.ZodObject<{
+  slug: z.ZodString;
+}, z.core.$strip>;
+/**
+ * 오픈 준비 중 미리보기 링크 — 콘솔에서 로그인한 OWNER·ADMIN만 받는다(PAT·에이전트 불가). 링크는 5분 안에 한 번 열면
+ * 그 브라우저에 12시간짜리 미리보기 쿠키가 생기고 오픈 준비 중인 사이트의 실제 화면을 본다. 링크를 남에게 넘기면 그 사람도
+ * 볼 수 있으므로 공유하지 않는다.
+ */
+export declare const createStorefrontPreviewLinkRequestSchema: z.ZodObject<{
+  path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CreateStorefrontPreviewLinkRequest = z.infer<typeof createStorefrontPreviewLinkRequestSchema>;
+export declare const storefrontPreviewLinkSchema: z.ZodObject<{
+  url: z.ZodString;
+  expiresAt: z.ZodString;
+}, z.core.$strip>;
+export type StorefrontPreviewLink = z.infer<typeof storefrontPreviewLinkSchema>;
+//#endregion
 //#region src/schemas/upload.d.ts
 /**
  * 업로드 용도. 허용 확장자와 크기 상한이 용도별로 다르다.
@@ -6382,7 +6707,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       storeId: string;
       storeName: string;
       storeCode: string;
-      role: "OWNER" | "ADMIN" | "STAFF";
+      role: "ADMIN" | "STAFF" | "OWNER";
       status: "ACTIVE" | "SUSPENDED" | "CLOSED";
     }[]>;
     /** RFC 7009 — token을 폐기한다 (public client는 client_id만 동반) */
@@ -6542,7 +6867,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       contents: {
         productId: string;
         name: string;
-        status: "SUSPENDED" | "CLOSED" | "SALE" | "OUT_OF_STOCK";
+        status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
         salePrice: number;
         discountedPrice: number | null;
         stockQuantity: number;
@@ -6558,7 +6883,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     get: (productId: string) => Promise<{
       productId: string;
       name: string;
-      status: "SUSPENDED" | "CLOSED" | "SALE" | "OUT_OF_STOCK";
+      status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
       salePrice: number;
       discountedPrice: number | null;
       stockQuantity: number;
@@ -6652,7 +6977,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     create: (body: ProductCreateRequestInput, idempotencyKey?: string) => Promise<{
       productId: string;
       name: string;
-      status: "SUSPENDED" | "CLOSED" | "SALE" | "OUT_OF_STOCK";
+      status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
       salePrice: number;
       discountedPrice: number | null;
       stockQuantity: number;
@@ -6746,7 +7071,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     update: (productId: string, body: ProductReplaceRequestInput) => Promise<{
       productId: string;
       name: string;
-      status: "SUSPENDED" | "CLOSED" | "SALE" | "OUT_OF_STOCK";
+      status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
       salePrice: number;
       discountedPrice: number | null;
       stockQuantity: number;
@@ -10231,6 +10556,358 @@ export declare function createStoreClient(options: StoreClientOptions): {
     remove: (addressId: string) => Promise<void>;
     setDefault: (addressId: string) => Promise<void>;
   };
+  /**
+   * 스토어프론트 호스팅 (이슈 #53) — 조회 `storefront:r`, 쓰기 `storefront:rw`(OWNER·ADMIN).
+   * 쓰기 응답은 바뀐 사이트다. Cloudflare 반영은 커밋 뒤라 `provisioning.status`가 잠시 `PENDING`일 수 있다.
+   * 에이전트 토큰의 발행·되돌리기·템플릿 변경·공개 전환·슬러그 변경·끄기는 승인 대기(`ApprovalPendingError`)다.
+   */
+  storefront: {
+    /** `GET /v1/storefront/templates` — 템플릿 카탈로그 */
+    listTemplates: () => Promise<{
+      templateId: string;
+      name: string;
+      industry: string;
+      description: string;
+      thumbnailUrl: string | null;
+      version: string;
+      isDefault: boolean;
+    }[]>;
+    /** `GET /v1/storefront/site` — 스위치 상태와 현재 사이트(없으면 `site: null`) */
+    get: () => Promise<{
+      enabled: boolean;
+      domain: string;
+      site: {
+        siteId: string;
+        slug: string;
+        hostname: string;
+        url: string;
+        domains: {
+          hostname: string;
+          kind: "PLATFORM" | "CUSTOM";
+          status: "ACTIVE" | "HELD";
+          isPrimary: boolean;
+          holdUntil: string | null;
+        }[];
+        templateId: string;
+        sourceMode: "CUSTOM" | "MANAGED";
+        status: "ACTIVE" | "SUSPENDED" | "CLOSED";
+        visibility: "COMING_SOON" | "PUBLIC";
+        publishedVersion: {
+          versionId: string;
+          number: number;
+          templateId: string;
+          templateVersion: string;
+          status: "FAILED" | "BUILDING" | "READY";
+          published: boolean;
+          publishedAt: string | null;
+          message: string | null;
+          createdByType: string;
+          createdAt: string;
+        } | null;
+        provisioning: {
+          status: "PENDING" | "FAILED" | "SYNCED";
+          lastErrorCode: string | null;
+          syncedAt: string | null;
+        };
+        slugChangesRemaining: number;
+        createdAt: string;
+        updatedAt: string;
+      } | null;
+    }>;
+    /** `GET /v1/storefront/slug-availability?slug=` — 슬러그를 쓸 수 있는가 */
+    checkSlug: (slug: string) => Promise<{
+      slug: string;
+      available: boolean;
+      reason: "RESERVED" | "INVALID" | "TAKEN" | "CURRENT" | null;
+    }>;
+    /** `POST /v1/storefront/site` (201) — 템플릿으로 사이트를 만들고 v1을 발행한다. 공개 상태는 오픈 준비 중이다 */
+    create: (body: CreateStorefrontSiteRequest) => Promise<{
+      siteId: string;
+      slug: string;
+      hostname: string;
+      url: string;
+      domains: {
+        hostname: string;
+        kind: "PLATFORM" | "CUSTOM";
+        status: "ACTIVE" | "HELD";
+        isPrimary: boolean;
+        holdUntil: string | null;
+      }[];
+      templateId: string;
+      sourceMode: "CUSTOM" | "MANAGED";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
+      visibility: "COMING_SOON" | "PUBLIC";
+      publishedVersion: {
+        versionId: string;
+        number: number;
+        templateId: string;
+        templateVersion: string;
+        status: "FAILED" | "BUILDING" | "READY";
+        published: boolean;
+        publishedAt: string | null;
+        message: string | null;
+        createdByType: string;
+        createdAt: string;
+      } | null;
+      provisioning: {
+        status: "PENDING" | "FAILED" | "SYNCED";
+        lastErrorCode: string | null;
+        syncedAt: string | null;
+      };
+      slugChangesRemaining: number;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+    /** `POST /v1/storefront/site/template` — 템플릿을 바꾼다. 새 버전을 만들고 기본으로 곧바로 발행한다 */
+    changeTemplate: (body: ChangeStorefrontTemplateRequest) => Promise<{
+      siteId: string;
+      slug: string;
+      hostname: string;
+      url: string;
+      domains: {
+        hostname: string;
+        kind: "PLATFORM" | "CUSTOM";
+        status: "ACTIVE" | "HELD";
+        isPrimary: boolean;
+        holdUntil: string | null;
+      }[];
+      templateId: string;
+      sourceMode: "CUSTOM" | "MANAGED";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
+      visibility: "COMING_SOON" | "PUBLIC";
+      publishedVersion: {
+        versionId: string;
+        number: number;
+        templateId: string;
+        templateVersion: string;
+        status: "FAILED" | "BUILDING" | "READY";
+        published: boolean;
+        publishedAt: string | null;
+        message: string | null;
+        createdByType: string;
+        createdAt: string;
+      } | null;
+      provisioning: {
+        status: "PENDING" | "FAILED" | "SYNCED";
+        lastErrorCode: string | null;
+        syncedAt: string | null;
+      };
+      slugChangesRemaining: number;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+    /** `GET /v1/storefront/site/versions` — 버전 목록(최신 먼저) */
+    listVersions: () => Promise<{
+      versionId: string;
+      number: number;
+      templateId: string;
+      templateVersion: string;
+      status: "FAILED" | "BUILDING" | "READY";
+      published: boolean;
+      publishedAt: string | null;
+      message: string | null;
+      createdByType: string;
+      createdAt: string;
+    }[]>;
+    /** `POST /v1/storefront/site/versions/{versionId}/publish` — 그 버전을 발행한다(이미 발행돼 있으면 그대로 200) */
+    publish: (versionId: string, body?: PublishStorefrontVersionRequest) => Promise<{
+      siteId: string;
+      slug: string;
+      hostname: string;
+      url: string;
+      domains: {
+        hostname: string;
+        kind: "PLATFORM" | "CUSTOM";
+        status: "ACTIVE" | "HELD";
+        isPrimary: boolean;
+        holdUntil: string | null;
+      }[];
+      templateId: string;
+      sourceMode: "CUSTOM" | "MANAGED";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
+      visibility: "COMING_SOON" | "PUBLIC";
+      publishedVersion: {
+        versionId: string;
+        number: number;
+        templateId: string;
+        templateVersion: string;
+        status: "FAILED" | "BUILDING" | "READY";
+        published: boolean;
+        publishedAt: string | null;
+        message: string | null;
+        createdByType: string;
+        createdAt: string;
+      } | null;
+      provisioning: {
+        status: "PENDING" | "FAILED" | "SYNCED";
+        lastErrorCode: string | null;
+        syncedAt: string | null;
+      };
+      slugChangesRemaining: number;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+    /** `POST /v1/storefront/site/rollback` — 이전 발행 버전으로 되돌린다(재빌드 없음) */
+    rollback: (body?: RollbackStorefrontRequest) => Promise<{
+      siteId: string;
+      slug: string;
+      hostname: string;
+      url: string;
+      domains: {
+        hostname: string;
+        kind: "PLATFORM" | "CUSTOM";
+        status: "ACTIVE" | "HELD";
+        isPrimary: boolean;
+        holdUntil: string | null;
+      }[];
+      templateId: string;
+      sourceMode: "CUSTOM" | "MANAGED";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
+      visibility: "COMING_SOON" | "PUBLIC";
+      publishedVersion: {
+        versionId: string;
+        number: number;
+        templateId: string;
+        templateVersion: string;
+        status: "FAILED" | "BUILDING" | "READY";
+        published: boolean;
+        publishedAt: string | null;
+        message: string | null;
+        createdByType: string;
+        createdAt: string;
+      } | null;
+      provisioning: {
+        status: "PENDING" | "FAILED" | "SYNCED";
+        lastErrorCode: string | null;
+        syncedAt: string | null;
+      };
+      slugChangesRemaining: number;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+    /** `PUT /v1/storefront/site/slug` — 슬러그를 바꾼다. 옛 슬러그는 90일 보류되고 새 주소로 301한다 */
+    changeSlug: (body: ChangeStorefrontSlugRequest) => Promise<{
+      siteId: string;
+      slug: string;
+      hostname: string;
+      url: string;
+      domains: {
+        hostname: string;
+        kind: "PLATFORM" | "CUSTOM";
+        status: "ACTIVE" | "HELD";
+        isPrimary: boolean;
+        holdUntil: string | null;
+      }[];
+      templateId: string;
+      sourceMode: "CUSTOM" | "MANAGED";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
+      visibility: "COMING_SOON" | "PUBLIC";
+      publishedVersion: {
+        versionId: string;
+        number: number;
+        templateId: string;
+        templateVersion: string;
+        status: "FAILED" | "BUILDING" | "READY";
+        published: boolean;
+        publishedAt: string | null;
+        message: string | null;
+        createdByType: string;
+        createdAt: string;
+      } | null;
+      provisioning: {
+        status: "PENDING" | "FAILED" | "SYNCED";
+        lastErrorCode: string | null;
+        syncedAt: string | null;
+      };
+      slugChangesRemaining: number;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+    /** `PUT /v1/storefront/site/visibility` — 오픈 준비 중 ↔ 공개 */
+    setVisibility: (body: SetStorefrontVisibilityRequest) => Promise<{
+      siteId: string;
+      slug: string;
+      hostname: string;
+      url: string;
+      domains: {
+        hostname: string;
+        kind: "PLATFORM" | "CUSTOM";
+        status: "ACTIVE" | "HELD";
+        isPrimary: boolean;
+        holdUntil: string | null;
+      }[];
+      templateId: string;
+      sourceMode: "CUSTOM" | "MANAGED";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
+      visibility: "COMING_SOON" | "PUBLIC";
+      publishedVersion: {
+        versionId: string;
+        number: number;
+        templateId: string;
+        templateVersion: string;
+        status: "FAILED" | "BUILDING" | "READY";
+        published: boolean;
+        publishedAt: string | null;
+        message: string | null;
+        createdByType: string;
+        createdAt: string;
+      } | null;
+      provisioning: {
+        status: "PENDING" | "FAILED" | "SYNCED";
+        lastErrorCode: string | null;
+        syncedAt: string | null;
+      };
+      slugChangesRemaining: number;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+    /**
+     * `POST /v1/storefront/site/preview-link` — 오픈 준비 중인 사이트를 구성원이 볼 수 있는 5분짜리 링크.
+     * 콘솔에서 로그인한 OWNER·ADMIN만 받는다
+     */
+    createPreviewLink: (body?: CreateStorefrontPreviewLinkRequest) => Promise<{
+      url: string;
+      expiresAt: string;
+    }>;
+    /** `POST /v1/storefront/site/disable` — 호스팅을 끈다(사이트 `CLOSED`, 슬러그 90일 보류). 다시 만들 수 있다 */
+    disable: (body: DisableStorefrontHostingRequest) => Promise<{
+      siteId: string;
+      slug: string;
+      hostname: string;
+      url: string;
+      domains: {
+        hostname: string;
+        kind: "PLATFORM" | "CUSTOM";
+        status: "ACTIVE" | "HELD";
+        isPrimary: boolean;
+        holdUntil: string | null;
+      }[];
+      templateId: string;
+      sourceMode: "CUSTOM" | "MANAGED";
+      status: "ACTIVE" | "SUSPENDED" | "CLOSED";
+      visibility: "COMING_SOON" | "PUBLIC";
+      publishedVersion: {
+        versionId: string;
+        number: number;
+        templateId: string;
+        templateVersion: string;
+        status: "FAILED" | "BUILDING" | "READY";
+        published: boolean;
+        publishedAt: string | null;
+        message: string | null;
+        createdByType: string;
+        createdAt: string;
+      } | null;
+      provisioning: {
+        status: "PENDING" | "FAILED" | "SYNCED";
+        lastErrorCode: string | null;
+        syncedAt: string | null;
+      };
+      slugChangesRemaining: number;
+      createdAt: string;
+      updatedAt: string;
+    }>;
+  };
   store: {
     get: () => Promise<{
       storeId: string;
@@ -10318,7 +10995,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       userId: string;
       name: string;
       email: string;
-      role: "OWNER" | "ADMIN" | "STAFF";
+      role: "ADMIN" | "STAFF" | "OWNER";
       joinedAt: string;
       lastActiveAt: string | null;
     }[]>;
@@ -10880,6 +11557,7 @@ export declare const STORE_SCOPE_RESOURCES: {
   readonly customer: readonly ["r", "rw"];
   readonly audit: readonly ["r"];
   readonly promotion: readonly ["r", "rw"];
+  readonly storefront: readonly ["r", "rw"];
 };
 export type StoreScopeResource = keyof typeof STORE_SCOPE_RESOURCES;
 export declare const storeScopeResourceSchema: z.ZodEnum<{
@@ -10897,6 +11575,7 @@ export declare const storeScopeResourceSchema: z.ZodEnum<{
   customer: "customer";
   audit: "audit";
   promotion: "promotion";
+  storefront: "storefront";
 }>;
 /** 카탈로그상 존재하는 스코프 문자열인가 (예: `settlement:rw`는 false) */
 export declare function isStoreScope(scope: string): boolean;
@@ -10906,8 +11585,8 @@ export declare function isStoreScope(scope: string): boolean;
  * 발급 시 지정한 스코프만 갖는다(발급자 보유 스코프 이내).
  */
 export declare const STORE_ROLE_SCOPES: {
-  readonly OWNER: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "settlement:r", "analytics:r", "webhook:rw", "store:rw", "member:rw", "customer:rw", "audit:r", "promotion:rw"];
-  readonly ADMIN: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "analytics:r", "webhook:rw", "store:rw", "member:rw", "customer:rw", "audit:r", "promotion:rw"];
+  readonly OWNER: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "settlement:r", "analytics:r", "webhook:rw", "store:rw", "member:rw", "customer:rw", "audit:r", "promotion:rw", "storefront:rw"];
+  readonly ADMIN: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "analytics:r", "webhook:rw", "store:rw", "member:rw", "customer:rw", "audit:r", "promotion:rw", "storefront:rw"];
   readonly STAFF: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "customer:r", "promotion:r"];
 };
 //#endregion