@harrylabsj/kiwi 0.6.0

package/dist/handoff/ucp-checkout/cart-channel.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Kiwi v0.7.0 Transaction Handoff（WP2 补全）— UcpCartChannel：UCP Cart client +
+ * cart→checkout 转换。
+ *
+ * Cart（UCP 2026-04-08）：
+ *   - capability `dev.ucp.shopping.cart`；操作 Create/Get/Update（全量替换）/Cancel；
+ *   - cart 无支付配置、无 status 生命周期、无 complete 操作；totals 是估算，
+ *     平台 SHOULD 视为 estimate（本 channel 不做 checkout 级 sum 校验）；
+ *   - ucp.status=success|error 判别；Get 对不存在/过期/已取消返回 not_found
+ *     （client.ts 结构化判别 → cart_not_found）；
+ *   - Cancel 返回删除前的 cart 状态，后续操作返回 not_found。
+ *
+ * cart→checkout 转换（createCheckoutFromCart）：
+ *   - 前置：business profile 宣告 cart capability（cartCapabilityVerified）；
+ *     本地 cart 镜像存在且未被 cancel；远端仍是活 cart（refresh，防过期/已取消）；
+ *   - 委托 UcpCheckoutChannel.createSession(pkg, {cart_id})——payload 不带
+ *     line_items；链接由 checkout channel 本地记录（cartCheckoutLink）；
+ *   - 幂等：同 cart_id + 同 terms_digest 二次转换短接为既有会话；
+ *     完成门禁不变（complete 仍需 HandoffPackage + 授权）。
+ *
+ * 零新增依赖；HTTP 传输复用 UcpCheckoutHttpClient（client.ts）。
+ */
+import { type TermSet } from "../../negotiation/domain/common.js";
+import type { AuthorizationProvider } from "../authorization.js";
+import type { HandoffPackage } from "../package.js";
+import type { UcpProfile } from "../../discovery/ucp/types.js";
+import { UcpCheckoutChannel } from "./channel.js";
+import type { UcpCartResult } from "./cart-types.js";
+import type { UcpCheckoutResult } from "./types.js";
+export interface UcpCartChannelOptions {
+    /** cart REST service endpoint（与 profile 二选一；优先 endpoint）。 */
+    endpoint?: string;
+    /** UCP profile：解析 cart endpoint + checkout endpoint，并验证 cart capability。 */
+    profile?: UcpProfile;
+    /** 显式指定 profile 内 cart service 名（自动探测时省略）。 */
+    cartServiceName?: string;
+    /** 预建的 checkout channel（缺省按 profile/checkoutEndpoint 自建）。 */
+    checkout?: UcpCheckoutChannel;
+    /** 预建缺省时，checkout REST service endpoint（profile 缺 checkout 时用）。 */
+    checkoutEndpoint?: string;
+    /** 预建缺省时，显式指定 profile 内 checkout service 名。 */
+    checkoutServiceName?: string;
+    fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+    /** 透传给 url-policy 的私网放行开关（默认 false，fail-closed）。 */
+    allowPrivateRanges?: boolean;
+    /** 跳过请求前 DNS 复查（测试用；生产应保持 false）。 */
+    skipDnsCheck?: boolean;
+    resolveIp?: (hostname: string) => Promise<string[]>;
+    /** buyer 的 UCP profile URI；配置时每个请求携带 `UCP-Agent` 头（§25.1）。 */
+    ucpAgentProfile?: string;
+    headers?: Record<string, string>;
+    /** 可注入时钟（RFC 3339）；缺省 new Date().toISOString()。 */
+    now?: () => string;
+    /** 预建 checkout channel 时透传的授权提供方（cart 自身无 complete）。 */
+    authorizationProvider?: AuthorizationProvider;
+}
+export declare class UcpCartChannel {
+    private readonly client;
+    private readonly now;
+    /** cart_id 仅在 business profile 宣告 cart capability 时可用。 */
+    private readonly cartCapabilityVerified;
+    private readonly checkout?;
+    /** 本地 cart 镜像：只服务本地前置校验；远端 cart 是状态权威（not_found 判别）。 */
+    private readonly carts;
+    constructor(options?: UcpCartChannelOptions);
+    createCart(pkg: HandoffPackage): Promise<UcpCartResult>;
+    getCart(cartId: string): Promise<UcpCartResult>;
+    /** Update 全量替换语义：远端确认存活后 PUT 完整 cart 表示。 */
+    updateCart(cartId: string, terms: TermSet): Promise<UcpCartResult>;
+    /**
+     * Cancel：返回删除前的 cart 状态（记录为本地 canceled 快照）；后续操作
+     * （get/update/cancel）远端返回 not_found → cart_not_found / cart_not_actionable。
+     */
+    cancelCart(cartId: string): Promise<UcpCartResult>;
+    /**
+     * 把已存在的 cart 转成 checkout 会话。
+     *
+     * 前置（spec 事实）：
+     *   - business profile 宣告 cart capability（否则 cart_capability_unavailable）；
+     *   - 本地镜像存在且未 cancel；
+     *   - refresh 远端确认 cart 仍是活的（过期/已取消 → not_found → cart_not_found）。
+     * 委托 checkout channel.createSession(pkg, {cart_id})——payload 不带 line_items；
+     * 链接由 checkout channel 本地记录；幂等语义见 UcpCheckoutChannel。
+     */
+    createCheckoutFromCart(cartId: string, pkg: HandoffPackage): Promise<UcpCheckoutResult>;
+    /** 当前本地 cart 镜像数量（诊断用）。 */
+    get cartCount(): number;
+    private validatePackage;
+    /** 远端确认 cart 仍是活的：not_found → cart_not_found；error envelope → 消息算法。 */
+    private confirmLive;
+    private failWith;
+    private mapHttpError;
+    /** error envelope → 三形态结果（error 响应绝不 ok）。 */
+    private cartDecision;
+}

package/dist/handoff/ucp-checkout/cart-channel.js

@@ -0,0 +1,370 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Kiwi v0.7.0 Transaction Handoff（WP2 补全）— UcpCartChannel：UCP Cart client +
+ * cart→checkout 转换。
+ *
+ * Cart（UCP 2026-04-08）：
+ *   - capability `dev.ucp.shopping.cart`；操作 Create/Get/Update（全量替换）/Cancel；
+ *   - cart 无支付配置、无 status 生命周期、无 complete 操作；totals 是估算，
+ *     平台 SHOULD 视为 estimate（本 channel 不做 checkout 级 sum 校验）；
+ *   - ucp.status=success|error 判别；Get 对不存在/过期/已取消返回 not_found
+ *     （client.ts 结构化判别 → cart_not_found）；
+ *   - Cancel 返回删除前的 cart 状态，后续操作返回 not_found。
+ *
+ * cart→checkout 转换（createCheckoutFromCart）：
+ *   - 前置：business profile 宣告 cart capability（cartCapabilityVerified）；
+ *     本地 cart 镜像存在且未被 cancel；远端仍是活 cart（refresh，防过期/已取消）；
+ *   - 委托 UcpCheckoutChannel.createSession(pkg, {cart_id})——payload 不带
+ *     line_items；链接由 checkout channel 本地记录（cartCheckoutLink）；
+ *   - 幂等：同 cart_id + 同 terms_digest 二次转换短接为既有会话；
+ *     完成门禁不变（complete 仍需 HandoffPackage + 授权）。
+ *
+ * 零新增依赖；HTTP 传输复用 UcpCheckoutHttpClient（client.ts）。
+ */
+import { validateTermSet } from "../../negotiation/domain/common.js";
+import { contentDigest } from "../../negotiation/jcs.js";
+import { HandoffError } from "../errors.js";
+import { verifyHandoffPackageDigest } from "../package.js";
+import { UcpCheckoutChannel, mapTermsToLineItems, } from "./channel.js";
+import { isUcpCartErrorResponse } from "./cart-parse.js";
+import { decideMessages } from "./parse.js";
+import { UcpCheckoutHttpClient, } from "./client.js";
+import { findCartEndpoint, profileHasCartCapability, findCheckoutEndpoint } from "./endpoint.js";
+// ---------------------------------------------------------------------------
+// UcpCartChannel
+// ---------------------------------------------------------------------------
+export class UcpCartChannel {
+    client;
+    now;
+    /** cart_id 仅在 business profile 宣告 cart capability 时可用。 */
+    cartCapabilityVerified;
+    checkout;
+    /** 本地 cart 镜像：只服务本地前置校验；远端 cart 是状态权威（not_found 判别）。 */
+    carts = new Map();
+    constructor(options = {}) {
+        const cartEndpoint = options.endpoint ??
+            (options.profile !== undefined
+                ? findCartEndpoint(options.profile, { serviceName: options.cartServiceName })
+                : undefined);
+        if (cartEndpoint === undefined) {
+            throw new HandoffError("invalid_input", "UcpCartChannel requires cart endpoint or a profile with a cart REST service");
+        }
+        let client;
+        try {
+            client = new UcpCheckoutHttpClient({
+                endpoint: cartEndpoint,
+                fetchImpl: options.fetchImpl,
+                timeoutMs: options.timeoutMs,
+                allowPrivateRanges: options.allowPrivateRanges,
+                skipDnsCheck: options.skipDnsCheck,
+                resolveIp: options.resolveIp,
+                ucpAgentProfile: options.ucpAgentProfile,
+                headers: options.headers,
+            });
+        }
+        catch (err) {
+            throw new HandoffError("invalid_input", `ucp cart endpoint rejected: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        this.client = client;
+        this.now = options.now ?? (() => new Date().toISOString());
+        this.cartCapabilityVerified =
+            options.profile !== undefined ? profileHasCartCapability(options.profile) : false;
+        if (options.checkout !== undefined) {
+            this.checkout = options.checkout;
+        }
+        else {
+            const checkoutEndpoint = options.checkoutEndpoint ??
+                (options.profile !== undefined
+                    ? findCheckoutEndpoint(options.profile, { serviceName: options.checkoutServiceName })
+                    : undefined);
+            if (checkoutEndpoint !== undefined) {
+                const checkoutOpts = {
+                    endpoint: checkoutEndpoint,
+                    fetchImpl: options.fetchImpl,
+                    timeoutMs: options.timeoutMs,
+                    allowPrivateRanges: options.allowPrivateRanges,
+                    skipDnsCheck: options.skipDnsCheck,
+                    resolveIp: options.resolveIp,
+                    ucpAgentProfile: options.ucpAgentProfile,
+                    headers: options.headers,
+                    now: options.now,
+                    authorizationProvider: options.authorizationProvider,
+                };
+                if (options.profile !== undefined)
+                    checkoutOpts.profile = options.profile;
+                this.checkout = new UcpCheckoutChannel(checkoutOpts);
+            }
+        }
+    }
+    // -- Cart CRUD -----------------------------------------------------------
+    async createCart(pkg) {
+        const guard = this.validatePackage(pkg, "createCart");
+        if (!guard.ok)
+            return this.failWith(guard.reason, guard.code);
+        const mapped = mapTermsToLineItems(guard.terms);
+        if (!mapped.ok) {
+            return this.failWith(`createCart rejected: ${mapped.reason}`, "invalid_quantity");
+        }
+        const http = await this.client.createCart({ line_items: mapped.items });
+        if (http.kind === "error")
+            return this.mapHttpError(http);
+        if (http.kind === "not_found") {
+            return this.failWith(`cart_not_found: create cart returned not_found`, "cart_not_found");
+        }
+        if (isUcpCartErrorResponse(http.response)) {
+            return this.cartDecision(decideMessages(http.response.messages, http.response.continue_url), {
+                messages: http.response.messages,
+                continue_url: http.response.continue_url,
+            });
+        }
+        const cart = http.response;
+        this.carts.set(cart.cart_id, { cart, canceled: false });
+        return { status: "ok", cart_ref: cart.cart_id, cart };
+    }
+    async getCart(cartId) {
+        const http = await this.client.getCart(cartId);
+        if (http.kind === "error")
+            return this.mapHttpError(http);
+        if (http.kind === "not_found") {
+            return this.failWith(`cart_not_found: ${cartId}`, "cart_not_found");
+        }
+        if (isUcpCartErrorResponse(http.response)) {
+            return this.cartDecision(decideMessages(http.response.messages, http.response.continue_url), {
+                messages: http.response.messages,
+                continue_url: http.response.continue_url,
+            });
+        }
+        const cart = http.response;
+        this.carts.set(cartId, { cart, canceled: false });
+        return { status: "ok", cart_ref: cartId, cart };
+    }
+    /** Update 全量替换语义：远端确认存活后 PUT 完整 cart 表示。 */
+    async updateCart(cartId, terms) {
+        const mirror = this.carts.get(cartId);
+        if (mirror === undefined) {
+            return this.failWith(`cart_not_found: ${cartId}`, "cart_not_found");
+        }
+        if (mirror.canceled) {
+            return this.failWith(`cart_not_actionable: canceled ${cartId}`, "cart_not_actionable");
+        }
+        const live = await this.confirmLive(cartId);
+        if (live.status !== "ok")
+            return live;
+        let nextTerms;
+        try {
+            nextTerms = validateTermSet(terms, "terms");
+        }
+        catch (err) {
+            return this.failWith(`updateCart rejected: ${err instanceof Error ? err.message : String(err)}`, "invalid_terms");
+        }
+        const mapped = mapTermsToLineItems(nextTerms);
+        if (!mapped.ok) {
+            return this.failWith(`updateCart rejected: ${mapped.reason}`, "invalid_quantity");
+        }
+        const put = await this.client.updateCart(cartId, { line_items: mapped.items });
+        if (put.kind === "error")
+            return this.mapHttpError(put);
+        if (put.kind === "not_found") {
+            return this.failWith(`cart_not_found: ${cartId}`, "cart_not_found");
+        }
+        if (isUcpCartErrorResponse(put.response)) {
+            return this.cartDecision(decideMessages(put.response.messages, put.response.continue_url), {
+                messages: put.response.messages,
+                continue_url: put.response.continue_url,
+            });
+        }
+        const cart = put.response;
+        this.carts.set(cartId, { cart, canceled: false });
+        return { status: "ok", cart_ref: cartId, cart };
+    }
+    /**
+     * Cancel：返回删除前的 cart 状态（记录为本地 canceled 快照）；后续操作
+     * （get/update/cancel）远端返回 not_found → cart_not_found / cart_not_actionable。
+     */
+    async cancelCart(cartId) {
+        const mirror = this.carts.get(cartId);
+        if (mirror === undefined) {
+            return this.failWith(`cart_not_found: ${cartId}`, "cart_not_found");
+        }
+        if (mirror.canceled) {
+            return this.failWith(`cart_not_actionable: already canceled ${cartId}`, "cart_not_actionable");
+        }
+        const live = await this.confirmLive(cartId);
+        if (live.status !== "ok")
+            return live;
+        const cancel = await this.client.cancelCart(cartId);
+        if (cancel.kind === "error")
+            return this.mapHttpError(cancel);
+        if (cancel.kind === "not_found") {
+            return this.failWith(`cart_not_found: ${cartId}`, "cart_not_found");
+        }
+        if (isUcpCartErrorResponse(cancel.response)) {
+            return this.cartDecision(decideMessages(cancel.response.messages, cancel.response.continue_url), {
+                messages: cancel.response.messages,
+                continue_url: cancel.response.continue_url,
+            });
+        }
+        // 成功：返回的是删除前的 cart 状态。
+        const cart = cancel.response;
+        this.carts.set(cartId, { cart, canceled: true });
+        return { status: "ok", cart_ref: cartId, cart, canceled: true };
+    }
+    // -- cart→checkout 转换 ---------------------------------------------------
+    /**
+     * 把已存在的 cart 转成 checkout 会话。
+     *
+     * 前置（spec 事实）：
+     *   - business profile 宣告 cart capability（否则 cart_capability_unavailable）；
+     *   - 本地镜像存在且未 cancel；
+     *   - refresh 远端确认 cart 仍是活的（过期/已取消 → not_found → cart_not_found）。
+     * 委托 checkout channel.createSession(pkg, {cart_id})——payload 不带 line_items；
+     * 链接由 checkout channel 本地记录；幂等语义见 UcpCheckoutChannel。
+     */
+    async createCheckoutFromCart(cartId, pkg) {
+        if (!this.cartCapabilityVerified) {
+            return {
+                status: "fail_closed",
+                reason: "cart_id unavailable: business profile does not declare dev.ucp.shopping.cart",
+                code: "cart_capability_unavailable",
+                messages: [],
+            };
+        }
+        if (this.checkout === undefined) {
+            return {
+                status: "fail_closed",
+                reason: "no checkout channel configured for cart→checkout conversion",
+                code: "cart_capability_unavailable",
+                messages: [],
+            };
+        }
+        const mirror = this.carts.get(cartId);
+        if (mirror === undefined) {
+            return { status: "fail_closed", reason: `cart_not_found: ${cartId}`, code: "cart_not_found", messages: [] };
+        }
+        if (mirror.canceled) {
+            return {
+                status: "fail_closed",
+                reason: "cart_not_actionable: canceled",
+                code: "cart_not_actionable",
+                messages: [],
+            };
+        }
+        // Refresh：远端仍是活 cart（过期/已取消 → not_found）。
+        const fresh = await this.getCart(cartId);
+        if (fresh.status !== "ok") {
+            return {
+                status: "fail_closed",
+                reason: fresh.status === "fail_closed" ? fresh.reason : "cart refresh failed",
+                code: fresh.status === "fail_closed" ? fresh.code ?? "network" : "network",
+                messages: fresh.status === "fail_closed" ? fresh.messages : [],
+            };
+        }
+        return this.checkout.createSession(pkg, { cart_id: cartId });
+    }
+    /** 当前本地 cart 镜像数量（诊断用）。 */
+    get cartCount() {
+        return this.carts.size;
+    }
+    // -- 内部辅助 ---------------------------------------------------------------
+    validatePackage(pkg, op) {
+        if (!verifyHandoffPackageDigest(pkg)) {
+            return { ok: false, reason: `${op} rejected: package terms_digest verification failed`, code: "invalid_package" };
+        }
+        let terms;
+        try {
+            terms = validateTermSet(pkg.agreed_terms, "agreed_terms");
+        }
+        catch (err) {
+            return {
+                ok: false,
+                reason: `${op} rejected: ${err instanceof Error ? err.message : String(err)}`,
+                code: "invalid_terms",
+            };
+        }
+        if (contentDigest(terms) !== pkg.terms_digest) {
+            return {
+                ok: false,
+                reason: `${op} rejected: package terms_digest does not match validated agreed_terms`,
+                code: "invalid_package",
+            };
+        }
+        return { ok: true, terms };
+    }
+    /** 远端确认 cart 仍是活的：not_found → cart_not_found；error envelope → 消息算法。 */
+    async confirmLive(cartId) {
+        const http = await this.client.getCart(cartId);
+        if (http.kind === "error")
+            return this.mapHttpError(http);
+        if (http.kind === "not_found") {
+            return this.failWith(`cart_not_found: ${cartId}`, "cart_not_found");
+        }
+        if (isUcpCartErrorResponse(http.response)) {
+            return this.cartDecision(decideMessages(http.response.messages, http.response.continue_url), {
+                messages: http.response.messages,
+                continue_url: http.response.continue_url,
+            });
+        }
+        this.carts.set(cartId, { cart: http.response, canceled: false });
+        return { status: "ok", cart_ref: cartId, cart: http.response };
+    }
+    failWith(reason, code) {
+        return { status: "fail_closed", reason, code, messages: [] };
+    }
+    mapHttpError(err) {
+        return {
+            status: "fail_closed",
+            reason: `ucp_cart_${err.code}: ${err.reason}`,
+            code: err.code,
+            messages: [],
+        };
+    }
+    /** error envelope → 三形态结果（error 响应绝不 ok）。 */
+    cartDecision(decision, ctx) {
+        switch (decision.action) {
+            case "ok":
+                return {
+                    status: "fail_closed",
+                    reason: "ucp error response without actionable messages",
+                    code: "unrecoverable",
+                    messages: ctx.messages,
+                };
+            case "requires_user":
+                return {
+                    status: "requires_user",
+                    reason: decision.reason ?? "requires user",
+                    continue_url: decision.continue_url ?? ctx.continue_url,
+                    messages: ctx.messages,
+                };
+            case "retryable":
+                return {
+                    status: "fail_closed",
+                    reason: decision.reason ?? "recoverable",
+                    code: "recoverable",
+                    messages: ctx.messages,
+                    retryable: true,
+                };
+            case "fail_closed":
+                return {
+                    status: "fail_closed",
+                    reason: decision.reason ?? "fail closed",
+                    code: "unrecoverable",
+                    messages: ctx.messages,
+                };
+        }
+    }
+}
+//# sourceMappingURL=cart-channel.js.map

package/dist/handoff/ucp-checkout/cart-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart-channel.js","sourceRoot":"","sources":["../../../src/handoff/ucp-checkout/cart-channel.ts"],"names":[],"mappings":"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"}

package/dist/handoff/ucp-checkout/cart-parse.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { UcpCart, UcpCartErrorResponse, UcpCartResponse } from "./cart-types.js";
+/** 解析并校验 UCP cart 响应（success/error 判别走 /ucp/status）。 */
+export declare function parseUcpCartResponse(raw: unknown): UcpCartResponse;
+/** 判别守卫：success 响应（cart 资源本体）。 */
+export declare function isUcpCartSuccess(value: UcpCartResponse): value is UcpCart;
+/** 判别守卫：error 响应（无 cart 资源，只有 messages + continue_url）。 */
+export declare function isUcpCartErrorResponse(value: UcpCartResponse): value is UcpCartErrorResponse;

package/dist/handoff/ucp-checkout/cart-parse.js

@@ -0,0 +1,102 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Kiwi v0.7.0 Transaction Handoff（WP2 补全）— UCP Cart 响应解析。
+ *
+ * 与 checkout 判别同构：`/ucp/status === success|error`。success 资源本体是
+ * `UcpCart`（cart_id 取代 session_id；无 status 生命周期）；error 响应复用
+ * parse.ts 的 error envelope 解析（结构完全一致）。
+ *
+ * 结构解析全部复用 parse.ts 的子解析器（line_items / totals / messages / links）
+ * 与校验原语；任何结构问题抛 UcpCheckoutParseError（fail-closed，§4.6）。
+ */
+import { UcpCheckoutParseError, parseLineItems, parseLinks, parseMessages, parseTotals, parseUcpErrorEnvelope, preserveUnknown, requireIsoTimestamp, requireNonEmptyString, requireObject, } from "./parse.js";
+function fail(path, message) {
+    throw new UcpCheckoutParseError(path, message);
+}
+/** 解析并校验 UCP cart 响应（success/error 判别走 /ucp/status）。 */
+export function parseUcpCartResponse(raw) {
+    const root = requireObject(raw, "/");
+    const ucp = requireObject(root.ucp, "/ucp");
+    const version = requireNonEmptyString(ucp.version, "/ucp/version");
+    const status = ucp.status;
+    if (status !== "success" && status !== "error") {
+        fail("/ucp/status", `must be success|error (got ${String(status)})`);
+    }
+    if (status === "success") {
+        return parseSuccessCart(root, ucp, version);
+    }
+    return parseUcpErrorEnvelope(root, ucp, version);
+}
+function parseSuccessCart(root, ucp, version) {
+    // 缺 id 是次要指标；fail-closed：success envelope 必须带 cart_id，否则视为畸形。
+    const cart = {
+        ucp: { ...ucp, status: "success", version },
+        cart_id: requireNonEmptyString(root.cart_id, "/cart_id"),
+    };
+    const known = new Set(["ucp", "cart_id"]);
+    if (root.expires_at !== undefined) {
+        cart.expires_at = requireIsoTimestamp(root.expires_at, "/expires_at");
+        known.add("expires_at");
+    }
+    if (root.line_items !== undefined) {
+        cart.line_items = parseLineItems(root.line_items);
+        known.add("line_items");
+    }
+    if (root.totals !== undefined) {
+        cart.totals = parseTotals(root.totals);
+        known.add("totals");
+    }
+    if (root.context !== undefined) {
+        cart.context = requireObject(root.context, "/context");
+        known.add("context");
+    }
+    if (root.buyer !== undefined) {
+        cart.buyer = requireObject(root.buyer, "/buyer");
+        known.add("buyer");
+    }
+    if (root.signals !== undefined) {
+        cart.signals = requireObject(root.signals, "/signals");
+        known.add("signals");
+    }
+    if (root.attribution !== undefined) {
+        cart.attribution = requireObject(root.attribution, "/attribution");
+        known.add("attribution");
+    }
+    if (root.messages !== undefined) {
+        cart.messages = parseMessages(root.messages);
+        known.add("messages");
+    }
+    if (root.links !== undefined) {
+        cart.links = parseLinks(root.links);
+        known.add("links");
+    }
+    if (root.continue_url !== undefined) {
+        cart.continue_url = requireNonEmptyString(root.continue_url, "/continue_url");
+        known.add("continue_url");
+    }
+    preserveUnknown(root, cart, known);
+    return cart;
+}
+/** 判别守卫：success 响应（cart 资源本体）。 */
+export function isUcpCartSuccess(value) {
+    return value.ucp.status === "success";
+}
+/** 判别守卫：error 响应（无 cart 资源，只有 messages + continue_url）。 */
+export function isUcpCartErrorResponse(value) {
+    return value.ucp.status === "error";
+}
+//# sourceMappingURL=cart-parse.js.map

package/dist/handoff/ucp-checkout/cart-parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart-parse.js","sourceRoot":"","sources":["../../../src/handoff/ucp-checkout/cart-parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;GASG;AAEH,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,UAAU,EACV,aAAa,EACb,WAAW,EACX,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,SAAS,IAAI,CAAC,IAAY,EAAE,OAAe;IACzC,MAAM,IAAI,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC/C,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,qBAAqB,CAAC,GAAG,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAC1B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QAC/C,IAAI,CAAC,aAAa,EAAE,8BAA8B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,qBAAqB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,gBAAgB,CACvB,IAA6B,EAC7B,GAA4B,EAC5B,OAAe;IAEf,8DAA8D;IAC9D,MAAM,IAAI,GAAY;QACpB,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAoB;QAC7D,OAAO,EAAE,qBAAqB,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;KACzD,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IAC1C,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,mBAAmB,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QACtE,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClD,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACvD,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACjD,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACvD,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QACnE,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7C,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACxB,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IACD,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACpC,IAAI,CAAC,YAAY,GAAG,qBAAqB,CAAC,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;QAC9E,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC5B,CAAC;IACD,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC;AACxC,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,sBAAsB,CAAC,KAAsB;IAC3D,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,KAAK,OAAO,CAAC;AACtC,CAAC"}