@sayren/storefront-sdk 0.20.8 → 0.20.10

package/dist/auth/index.mjs

@@ -1,4 +1,4 @@
-import { t as createStorefrontClient, zt as ApiError } from "../client-S_gOAeBM.mjs";
+import { Ht as ApiError, t as createStorefrontClient } from "../client-DJjcGd_M.mjs";
 //#region src/auth/index.ts
 /** 소셜 로그인 실패 — 구매자가 취소했거나(`access_denied`) state가 맞지 않는다 */
 var IdpCallbackError = class extends Error {

package/dist/{client-S_gOAeBM.mjs → client-DJjcGd_M.mjs}

@@ -1,5 +1,5 @@
 import { a as ANALYTICS_VISITOR_HEADER, r as ANALYTICS_SESSION_HEADER } from "./analytics-CgD70OqH.mjs";
-import { $ as customInputViewSchema, A as retryPaymentRequestSchema, F as applicableCouponSchema, I as checkoutPricingRequestSchema, J as addonGroupViewSchema, K as storefrontCouponSchema, L as checkoutPricingSchema, M as startPaymentRequestSchema, T as paymentStatusSchema, U as myCouponSchema, d as checkoutSessionSchema, dt as pickupLocationViewSchema, et as lineSelectionRequestShape, f as createCheckoutRequestSchema, ft as productCardFulfillmentSchema, h as easyPayProviderResponseSchema, k as responsePaymentMethodSchema, lt as lineFulfillmentSchema, m as deliveryQuoteSchema, ot as calendarDayViewSchema, p as deliveryQuoteRequestSchema, pt as productFulfillmentViewSchema, tt as lineSelectionResponseShape, ut as myOrderItemFulfillmentSnapshotSchema, w as paymentStartSchema } from "./checkout-BjJ4Efbn.mjs";
+import { $ as customInputViewSchema, A as retryPaymentRequestSchema, F as applicableCouponSchema, I as checkoutPricingRequestSchema, J as addonGroupViewSchema, K as storefrontCouponSchema, L as checkoutPricingSchema, M as startPaymentRequestSchema, T as paymentStatusSchema, U as myCouponSchema, d as checkoutSessionSchema, dt as pickupLocationViewSchema, et as lineSelectionRequestShape, f as createCheckoutRequestSchema, ft as productCardFulfillmentSchema, h as easyPayProviderResponseSchema, it as orderInputUploadRequestSchema, k as responsePaymentMethodSchema, lt as lineFulfillmentSchema, m as deliveryQuoteSchema, ot as calendarDayViewSchema, p as deliveryQuoteRequestSchema, pt as productFulfillmentViewSchema, tt as lineSelectionResponseShape, ut as myOrderItemFulfillmentSnapshotSchema, w as paymentStartSchema } from "./checkout-BjJ4Efbn.mjs";
 import { z } from "zod";
 //#region src/http.ts
 /** 표준 엔벨로프의 $.error 상세 */
@@ -525,9 +525,10 @@ const myClaimSchema = z.object({
 */
 const flowInputFieldSchema = z.object({
 	key: z.string(),
-	type: z.string().describe("text · number · select · date · datetime · image (늘어날 수 있다)"),
+	type: z.string().describe("text · textarea · number · select · radio · checkbox · boolean · date · datetime · image (늘어날 수 있다). 값: checkbox는 고른 선택지 배열, boolean은 참거짓(필수면 true), date는 `YYYY-MM-DD`, datetime은 오프셋 있는 ISO 8601, image는 https 주소 배열"),
 	required: z.boolean(),
 	label: z.string(),
+	placeholder: z.string().optional().describe("입력 안내"),
 	maxLength: z.number().int().optional(),
 	maxFiles: z.number().int().optional(),
 	options: z.array(z.union([z.string(), z.number()])).optional()
@@ -566,9 +567,51 @@ const flowStateSchema = z.object({
 	enteredAt: z.string(),
 	deadlineAt: z.string().optional().describe("가장 가까운 기한(ISO 8601)"),
 	attachments: z.array(z.string()).optional().describe("가장 최근 행동이 붙인 첨부 주소(시안 등, #115). 없으면 생략"),
+	inputs: z.object({
+		by: z.string().describe("적은 사람 — seller · buyer"),
+		values: z.array(z.object({
+			key: z.string(),
+			label: z.string(),
+			type: z.string(),
+			value: z.union([
+				z.string(),
+				z.number(),
+				z.boolean(),
+				z.array(z.string())
+			])
+		}))
+	}).optional().describe("이 상태로 오게 한 행동의 입력값(수정 내용 등, #115). 없으면 생략"),
 	progress: z.boolean().optional(),
 	fields: z.record(z.string(), flowFieldValueSchema).describe("구매자 공개 범위의 커스텀 필드")
 });
+/**
+* 주문상품의 지금 단계(#115) — 구매자 화면이 흐름 구조를 몰라도 그릴 수 있게 서버가 정리한 값이다. `type`으로 화면 모양을 고르고,
+* `actions`(입력 칸 포함)로 버튼·폼을 그린다. 판정은 서버다.
+*/
+const ORDER_STEP_TYPES = [
+	"BUYER_ACTION",
+	"SELLER_PROCESSING",
+	"IN_DELIVERY",
+	"DELIVERED",
+	"COMPLETED",
+	"CANCELED",
+	"CLAIM_IN_PROGRESS"
+];
+const orderStepSchema = z.object({
+	type: z.string().describe("BUYER_ACTION 구매자 확인·입력 필요 · SELLER_PROCESSING 판매자 처리 중 · IN_DELIVERY 배송 중 · DELIVERED 배송·제공 완료 · COMPLETED 구매확정 · CANCELED 취소 · CLAIM_IN_PROGRESS 취소·반품·교환 처리 중. 값이 늘어날 수 있다(모르는 값은 SELLER_PROCESSING처럼 보인다)"),
+	label: z.string().describe("지금 상태 이름(구매자용)"),
+	message: z.string().optional().describe("판매자가 둔 안내문"),
+	deadlineAt: z.string().optional().describe("가장 가까운 기한(ISO 8601)"),
+	attachments: z.array(z.string()).optional().describe("판매자가 올린 자료(시안 등)"),
+	inputs: flowStateSchema.shape.inputs,
+	actions: z.array(flowActionSchema).describe("이 단계에서 구매자가 할 행동(입력 칸 포함). `BUYER_ACTION`이면 하나 이상이다. 취소·반품 요청·구매확정은 `actions`(주문상품)에 있다"),
+	data: z.object({ delivery: z.object({
+		carrierName: z.string().nullable(),
+		trackingNumber: z.string().nullable(),
+		trackingUrl: z.string().nullable(),
+		dispatchedAt: z.string()
+	}).optional().describe("`IN_DELIVERY` — 발송 정보") }).optional().describe("단계별 부가 정보. 없으면 생략")
+});
 const flowActionRequestSchema = z.object({ input: z.record(z.string(), z.unknown()).optional() });
 /** 비회원 행동 — 비회원 주문 조회와 같은 확인(연락처·주문 조회 비밀번호)을 함께 보낸다 */
 const guestFlowActionRequestSchema = flowActionRequestSchema.extend({
@@ -585,6 +628,24 @@ const flowActionResultSchema = z.object({
 		claimNo: z.string().nullable()
 	}).optional().describe("취소·반품·교환 행동(하위 플로우 `core.claim.*`)이 접수한 클레임(#115). 클레임 API(`POST /me/order-items/{id}/claims`)와 같은 접수다. 다른 행동은 생략")
 });
+/**
+* 주문 전체 행동 결과(#115) — 같은 행동을 주문의 주문상품마다 실행한다. 한 주문상품의 실패가 다른 주문상품을 되돌리지 않는다(부분 실행).
+* 묶음 진행이면 한 번 실행이 묶음의 주문상품을 함께 움직인다(COMPLETED로 함께 나온다). 그 행동이 없는 주문상품은 SKIPPED다
+*/
+const orderFlowActionResultSchema = z.object({
+	orderId: z.string(),
+	key: z.string(),
+	results: z.array(z.object({
+		orderItemId: z.string(),
+		status: z.enum([
+			"COMPLETED",
+			"SKIPPED",
+			"FAILED"
+		]).describe("COMPLETED 실행 · SKIPPED 이 주문상품에는 그 행동이 없다 · FAILED 실행하다 거절됐다"),
+		reason: z.string().optional().describe("SKIPPED·FAILED의 이유 — 꺼진 이유(EXPIRED·CONDITION·NOT_IN_STATE) 또는 오류 코드"),
+		message: z.string().optional()
+	}))
+});
 //#endregion
 //#region src/schemas/consent.ts
 /**
@@ -783,7 +844,9 @@ const myOrderItemSchema = z.object({
 	reviewWritten: z.boolean(),
 	autoDecisionDate: z.string().nullable(),
 	flowState: flowStateSchema.optional().describe("주문 플로우의 지금 상태(이슈 #115). 플로우가 없는 주문상품은 없다"),
-	actions: z.array(flowActionSchema).optional().describe("지금 할 수 있는 행동. 화면은 이 목록으로 버튼을 그린다(상태 이름으로 분기하지 않는다)")
+	actions: z.array(flowActionSchema).optional().describe("지금 할 수 있는 행동. 화면은 이 목록으로 버튼을 그린다(상태 이름으로 분기하지 않는다)"),
+	flowBranches: z.array(flowStateSchema).optional().describe("진행 위치가 둘 이상(병렬 진행·하위 흐름)이면 각 위치의 상태. `flowState`는 그 가운데 가장 앞 단계다"),
+	step: orderStepSchema.optional().describe("지금 단계 요약(#115) — `type`으로 화면을 고르고 `actions`의 입력 칸으로 폼을 그린다. 플로우가 없는 주문상품은 없다")
 });
 /**
 * 주문 응답의 배송지 — 결제 요청 시 저장된 스냅샷. 요청 스키마(`shippingAddressInputSchema`)와 분리한 응답 스키마라
@@ -800,6 +863,7 @@ const orderShippingAddressSchema = z.object({
 });
 const myOrderSchema = z.object({
 	orderId: z.string(),
+	progressStatus: orderItemStatusSchema.optional().describe("진행 중 주문상품 가운데 가장 앞 단계(취소 제외, 모두 취소면 CANCELED, #115). 섞인 주문에서 아직 기다리는 단계다. 서버는 항상 싣는다"),
 	orderNo: commerceNumberField("주문번호(이슈 #107) — 숫자 14자리, 생성 후 바뀌지 않습니다. 구매자 화면에는 `formatOrderNo`(4자리 하이픈)로 표시하십시오. 비회원 주문 조회 경로에도 쓸 수 있습니다"),
 	orderedAt: z.string(),
 	items: z.array(myOrderItemSchema),
@@ -1147,7 +1211,13 @@ get: () => http.request("GET", "/store", storefrontStoreSchema) },
 			get: () => http.request("GET", "/cart", cartSchema),
 			addItem: (body) => http.request("POST", "/cart/items", cartSchema, { body: addCartItemRequestSchema.parse(body) }),
 			updateItem: (cartItemId, body) => http.request("PATCH", path`/cart/items/${cartItemId}`, cartSchema, { body: updateCartItemRequestSchema.parse(body) }),
-			removeItem: (cartItemId) => http.requestVoid("DELETE", path`/cart/items/${cartItemId}`)
+			removeItem: (cartItemId) => http.requestVoid("DELETE", path`/cart/items/${cartItemId}`),
+			/**
+			* 직접 입력 이미지(`type: "image"`) 업로드 자리 — 응답 `uploadUrl`에 파일을 PUT한 뒤 `url`을 담기·바로 구매의
+			* `customInputs` 값에 넣는다(여러 장이면 줄바꿈으로 잇는다). 비회원도 부를 수 있다.
+			* 형식·크기가 맞지 않으면 400 `UNSUPPORTED_FILE_TYPE`·413 `FILE_TOO_LARGE`, 연타하면 429 `TOO_MANY_REQUESTS`다
+			*/
+			createInputImageUpload: (body) => http.request("POST", "/uploads/order-inputs", uploadTicketSchema, { body: orderInputUploadRequestSchema.parse(body) })
 		},
 		checkout: {
 			create: (body) => http.request("POST", "/checkout", checkoutSessionSchema, { body: createCheckoutRequestSchema.parse(body) }),
@@ -1220,7 +1290,14 @@ get: () => http.request("GET", "/store", storefrontStoreSchema) },
 			*/
 			act: (orderItemId, key, input = {}) => http.request("POST", path`/me/order-items/${orderItemId}/actions/${key}`, flowActionResultSchema, { body: flowActionRequestSchema.parse({ input }) }),
 			/** 비회원 행동 — 비회원 주문 조회와 같은 연락처·비밀번호 확인과 시도 한도를 지난다 */
-			guestAct: (orderId, orderItemId, key, body) => http.request("POST", path`/guest/orders/${orderId}/items/${orderItemId}/actions/${key}`, flowActionResultSchema, { body: guestFlowActionRequestSchema.parse(body) })
+			guestAct: (orderId, orderItemId, key, body) => http.request("POST", path`/guest/orders/${orderId}/items/${orderItemId}/actions/${key}`, flowActionResultSchema, { body: guestFlowActionRequestSchema.parse(body) }),
+			/**
+			* `POST /me/orders/{id}/actions/{key}` — 주문 전체 행동(#115, 예: 주문 전체 취소). 그 행동이 켜진 주문상품마다 실행하고 결과를
+			* 주문상품별로 준다(부분 실행). 켜진 주문상품이 하나도 없으면 409 `ACTION_NOT_AVAILABLE`
+			*/
+			actOnOrder: (orderId, key, input = {}) => http.request("POST", path`/me/orders/${orderId}/actions/${key}`, orderFlowActionResultSchema, { body: flowActionRequestSchema.parse({ input }) }),
+			/** 비회원 주문 전체 행동 — 비회원 주문 조회와 같은 확인·시도 한도 */
+			guestActOnOrder: (orderId, key, body) => http.request("POST", path`/guest/orders/${orderId}/actions/${key}`, orderFlowActionResultSchema, { body: guestFlowActionRequestSchema.parse(body) })
 		},
 		myClaims: {
 			create: (orderItemId, body) => http.request("POST", path`/me/order-items/${orderItemId}/claims`, createClaimResultSchema, { body: createClaimRequestSchema.parse(body) }),
@@ -1280,4 +1357,4 @@ get: () => http.request("GET", "/store", storefrontStoreSchema) },
 	};
 }
 //#endregion
-export { claimTypeSchema as $, wishlistAddResultSchema as A, idpTokenRequestSchema as At, consentSourceSchema as B, buildQuery as Bt, orderShippingAddressSchema as C, cartItemSchema as Ct, memberAddressSchema as D, idpAgreementsSchema as Dt, memberAddressRequestSchema as E, anonymousSessionSchema as Et, createCustomerInquiryRequestSchema as F, socialProviderSchema as Ft, flowActionResultSchema as G, consentUpdateRequestSchema as H, unwrapData as Ht, customerInquiryCategorySchema as I, tokenPairSchema as It, flowInputFieldSchema as J, flowActionSchema as K, customerInquirySchema as L, withdrawRequestSchema as Lt, createInquiryResultSchema as M, loginRequestSchema as Mt, productInquiryCategorySchema as N, memberIdentitiesSchema as Nt, memberSchema as O, idpAuthorizeRequestSchema as Ot, publicInquirySchema as P, signupRequestSchema as Pt, claimReturnAddressSchema as Q, consentActionSchema as R, withdrawalBlockedDetailsSchema as Rt, myOrderSchema as S, addCartItemRequestSchema as St, trackingStageResponseSchema as T, updateCartItemRequestSchema as Tt, memberConsentsSchema as U, consentStateSchema as V, toApiError as Vt, flowActionRequestSchema as W, guestFlowActionRequestSchema as X, flowStateSchema as Y, claimReasonSchema as Z, memberPointEntrySchema as _, storefrontCollectionSchema as _t, myReviewSchema as a, parseOrderNo as at, deliveryTrackingSchema as b, pageInfoSchema as bt, publicReviewSchema as c, collectionProductQuerySchema as ct, reviewSummarySchema as d, productDetailSchema as dt, createClaimRequestSchema as et, updateReviewRequestSchema as f, productFacetsSchema as ft, memberPointEntryPageSchema as g, storefrontCollectionListQuerySchema as gt, writableReviewSchema as h, storefrontCollectionDetailSchema as ht, createReviewResultSchema as i, formatOrderNo as it, createInquiryRequestSchema as j, linkIdentityRequestSchema as jt, updateProfileRequestSchema as k, idpAuthorizeResponseSchema as kt, reviewImageUploadRequestSchema as l, collectionProductSortSchema as lt, uploadTicketSchema as m, productSortSchema as mt, storefrontStoreSchema as n, myClaimSchema as nt, productReviewQuerySchema as o, categoryNodeSchema as ot, updateReviewResultSchema as p, productPageSchema as pt, flowFieldValueSchema as q, createReviewRequestSchema as r, commerceNumberField as rt, productReviewSortSchema as s, collectionProductPageSchema as st, createStorefrontClient as t, createClaimResultSchema as tt, reviewPageSchema as u, productCardSchema as ut, memberPointsSchema as v, claimStatusSchema as vt, purchaseDecisionResultSchema as w, cartSchema as wt, myOrderItemSchema as x, pageSchema as xt, storefrontPointPolicySchema as y, orderItemStatusSchema as yt, consentKindSchema as z, ApiError as zt };
+export { orderStepSchema as $, wishlistAddResultSchema as A, idpAgreementsSchema as At, consentSourceSchema as B, withdrawRequestSchema as Bt, orderShippingAddressSchema as C, pageInfoSchema as Ct, memberAddressSchema as D, cartSchema as Dt, memberAddressRequestSchema as E, cartItemSchema as Et, createCustomerInquiryRequestSchema as F, loginRequestSchema as Ft, flowActionRequestSchema as G, unwrapData as Gt, consentUpdateRequestSchema as H, ApiError as Ht, customerInquiryCategorySchema as I, memberIdentitiesSchema as It, flowFieldValueSchema as J, flowActionResultSchema as K, customerInquirySchema as L, signupRequestSchema as Lt, createInquiryResultSchema as M, idpAuthorizeResponseSchema as Mt, productInquiryCategorySchema as N, idpTokenRequestSchema as Nt, memberSchema as O, updateCartItemRequestSchema as Ot, publicInquirySchema as P, linkIdentityRequestSchema as Pt, orderFlowActionResultSchema as Q, consentActionSchema as R, socialProviderSchema as Rt, myOrderSchema as S, orderItemStatusSchema as St, trackingStageResponseSchema as T, addCartItemRequestSchema as Tt, memberConsentsSchema as U, buildQuery as Ut, consentStateSchema as V, withdrawalBlockedDetailsSchema as Vt, ORDER_STEP_TYPES as W, toApiError as Wt, flowStateSchema as X, flowInputFieldSchema as Y, guestFlowActionRequestSchema as Z, memberPointEntrySchema as _, productSortSchema as _t, myReviewSchema as a, myClaimSchema as at, deliveryTrackingSchema as b, storefrontCollectionSchema as bt, publicReviewSchema as c, parseOrderNo as ct, reviewSummarySchema as d, collectionProductQuerySchema as dt, claimReasonSchema as et, updateReviewRequestSchema as f, collectionProductSortSchema as ft, memberPointEntryPageSchema as g, productPageSchema as gt, writableReviewSchema as h, productFacetsSchema as ht, createReviewResultSchema as i, createClaimResultSchema as it, createInquiryRequestSchema as j, idpAuthorizeRequestSchema as jt, updateProfileRequestSchema as k, anonymousSessionSchema as kt, reviewImageUploadRequestSchema as l, categoryNodeSchema as lt, uploadTicketSchema as m, productDetailSchema as mt, storefrontStoreSchema as n, claimTypeSchema as nt, productReviewQuerySchema as o, commerceNumberField as ot, updateReviewResultSchema as p, productCardSchema as pt, flowActionSchema as q, createReviewRequestSchema as r, createClaimRequestSchema as rt, productReviewSortSchema as s, formatOrderNo as st, createStorefrontClient as t, claimReturnAddressSchema as tt, reviewPageSchema as u, collectionProductPageSchema as ut, memberPointsSchema as v, storefrontCollectionDetailSchema as vt, purchaseDecisionResultSchema as w, pageSchema as wt, myOrderItemSchema as x, claimStatusSchema as xt, storefrontPointPolicySchema as y, storefrontCollectionListQuerySchema as yt, consentKindSchema as z, tokenPairSchema as zt };