import { z } from 'zod'; /** * stdio·Remote 쇼핑몰 도구가 함께 쓰는 입력 계약. * * 기준: commerce-api 소스(2026-09-14) — V1::ProductListService(Const::PRODUCT_SORTS 의 param), * V1::ProductsController#reviews(sort_by), Cart#generate_guest_order_preview, V1::OrderPrepareService. * 이 파일의 값이 바뀌면 src/commerce/__tests__/runtime-parity.test.ts 의 fixture 도 같이 바꾼다. */ export declare const COMMERCE_TOOL_CONTRACT_VERSION = "commerce-api-v1@2026-09-14"; /** GET /v1/products 가 실제로 읽는 sort 값 (Const::PRODUCT_SORTS[*][:param]) */ export declare const PRODUCT_SORTS: readonly ["position", "-created_at", "created_at", "price", "-price", "-sold"]; export declare const pageSchema: z.ZodDefault>; export declare const limitSchema: z.ZodDefault>; export declare const productSortSchema: z.ZodOptional>; export declare const productKeywordSchema: z.ZodOptional; export interface ProductListInput { page?: number; limit?: number; category_id?: string; sort?: string; keyword?: string; } export type ProductListQuery = { ok: true; query: URLSearchParams; sent: Record; sortAlias?: { requested: string; sent: string; }; } | { ok: false; error_code: 'UNSUPPORTED_SORT'; message: string; }; /** 두 런타임이 같은 순서·같은 값으로 query 를 만들도록 한 곳에서 조립한다 */ export declare function buildProductListQuery(input: ProductListInput): ProductListQuery; /** 서버는 sort_by 를 읽는다 (sort 는 무시). recent 가 기본 */ export declare const reviewSortSchema: z.ZodOptional>; export declare function buildReviewListQuery(input: { page?: number; limit?: number; sort?: string; }): URLSearchParams; export declare const RAW_BODY_NOTE: string; export declare const PRODUCT_LIST_NOTE: string; /** stdio 에는 없는 도구 범위. 존재하지 않는 stdio 도구를 부르라고 안내하지 않기 위해 한 곳에 둔다 */ export declare const STDIO_COMMERCE_SCOPE: Readonly<{ provided: string[]; not_provided: string; }>; export type CheckoutOrderState = 'reusable' | 'expired' | 'settled' | 'unconfirmed'; export interface CheckoutOrderDecision { state: CheckoutOrderState; /** 'next_user_action_only' 는 구매자가 다시 누를 때에만 새 준비를 허용한다는 뜻. 도구가 스스로 만들지 않는다 */ new_order_allowed: 'next_user_action_only' | false; next_step: string; } /** * 재시도 판단. 어떤 결과도 도구가 새 주문 준비를 자동 호출하게 만들지 않는다. * - order_expired + receipt_ready → 만료: 다음 구매자 클릭에서만 새 준비 * - order_pending + receipt_ready → 같은 주문서 재사용 * - 결제 완료·취소 계열 → 결과 확인 * - 그 외·알 수 없음 → 확인 대기 (새 준비 금지) */ export declare function classifyCheckoutOrder(status: unknown, receiptStatus: unknown): CheckoutOrderDecision; //# sourceMappingURL=contract.d.ts.map