@harrylabsj/kiwi 0.6.0

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

@@ -0,0 +1,71 @@
+/**
+ * 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 { UcpCheckoutErrorResponse, UcpCheckoutLineItem, UcpCheckoutLink, UcpCheckoutMessage, UcpCheckoutResponse, UcpCheckoutSession, UcpCheckoutTotals } from "./types.js";
+export declare class UcpCheckoutParseError extends Error {
+    readonly path: string;
+    constructor(path: string, message: string);
+}
+declare function fail(path: string, message: string): never;
+declare function requireObject(value: unknown, path: string): Record<string, unknown>;
+declare function requireNonEmptyString(value: unknown, path: string): string;
+declare function requireIsoTimestamp(value: unknown, path: string): string;
+/** 解析对象并把「未知字段原样保留」的 forward-compat 补到目标对象上。 */
+declare function preserveUnknown(obj: Record<string, unknown>, target: Record<string, unknown>, known: ReadonlySet<string>): void;
+declare function parseLineItems(value: unknown): UcpCheckoutLineItem[];
+declare function parseTotals(value: unknown): UcpCheckoutTotals;
+declare function parseMessages(value: unknown): UcpCheckoutMessage[];
+declare function parseLinks(value: unknown): UcpCheckoutLink[];
+/**
+ * 解析并校验 UCP checkout 响应（success/error 判别走 /ucp/status）。
+ * 结构非法 → 抛 UcpCheckoutParseError（fail-closed）。
+ */
+export declare function parseUcpCheckoutResponse(raw: unknown): UcpCheckoutResponse;
+declare function parseErrorResponse(root: Record<string, unknown>, ucp: Record<string, unknown>, version: string): UcpCheckoutErrorResponse;
+/**
+ * 判别守卫：success 响应（资源本体）。嵌套判别（/ucp/status）在带 index signature
+ * 的联合成员上无法被 TS 自动窄化，必须用显式 type guard。
+ */
+export declare function isUcpCheckoutSuccessSession(value: UcpCheckoutResponse): value is UcpCheckoutSession;
+/** 判别守卫：error 响应（无资源本体，只有 messages + continue_url）。 */
+export declare function isUcpCheckoutErrorResponse(value: UcpCheckoutResponse): value is UcpCheckoutErrorResponse;
+export interface MessageGrouping {
+    unrecoverable: UcpCheckoutMessage[];
+    requiresBuyerInput: UcpCheckoutMessage[];
+    requiresBuyerReview: UcpCheckoutMessage[];
+    recoverable: UcpCheckoutMessage[];
+    other: UcpCheckoutMessage[];
+}
+/** 按 severity 分组（severity 是处理算法的唯一输入；type 只是辅助信息）。 */
+export declare function groupMessages(messages: UcpCheckoutMessage[] | undefined): MessageGrouping;
+/** 汇总 messages 为可读字符串（`[code] message; …`）。空 → "no message details"。 */
+export declare function summarizeMessages(messages: UcpCheckoutMessage[] | undefined): string;
+export type CheckoutAction = "ok" | "fail_closed" | "requires_user" | "retryable";
+export interface CheckoutDecision {
+    action: CheckoutAction;
+    reason?: string;
+    continue_url?: string;
+}
+/**
+ * 消息算法（不依赖会话状态）：unrecoverable → fail_closed；requires_* → requires_user；
+ * recoverable 或 error 类型 → retryable（改输入重试）；否则 ok。
+ */
+export declare function decideMessages(messages: UcpCheckoutMessage[] | undefined, continue_url?: string): CheckoutDecision;
+/**
+ * 把一份 UCP checkout 响应（success/error）映射为「核心动作」。终态
+ * （completed/canceled）与 requires_escalation 状态优先于消息算法。
+ */
+export declare function decideResponse(response: UcpCheckoutResponse): CheckoutDecision;
+export { fail, parseErrorResponse as parseUcpErrorEnvelope, parseLineItems, parseLinks, parseMessages, parseTotals, preserveUnknown, requireIsoTimestamp, requireNonEmptyString, requireObject, };

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

@@ -0,0 +1,349 @@
+/**
+ * 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 Checkout 响应解析 + 消息算法。
+ *
+ * 两层：
+ *  1. 结构解析（parseUcpCheckoutResponse）：不可信响应 → UcpCheckoutResponse，
+ *     任何结构问题抛 UcpCheckoutParseError（fail-closed，§4.6）——无法证明合法
+ *     即拒绝。未知字段保留（forward-compat）。
+ *  2. 消息算法（decideMessages / decideResponse）：把 messages[] 的 severity 汇聚
+ *     成可执行动作。处理顺序（spec 事实）：
+ *        unrecoverable 非空 → fail_closed（重试无意义或 handoff）；
+ *        否则先解 recoverable（改输入重试）；仍 requires_* → handoff（requires_user）。
+ *     requires_buyer_input / requires_buyer_review 汇聚成 requires_escalation。
+ */
+import { UCP_CHECKOUT_STATUSES, UCP_MESSAGE_SEVERITIES, UCP_MESSAGE_TYPES, } from "./types.js";
+// ---------------------------------------------------------------------------
+// Parse error
+// ---------------------------------------------------------------------------
+export class UcpCheckoutParseError extends Error {
+    path;
+    constructor(path, message) {
+        super(`${path}: ${message}`);
+        this.name = "UcpCheckoutParseError";
+        this.path = path;
+    }
+}
+// ---------------------------------------------------------------------------
+// 校验原语
+// ---------------------------------------------------------------------------
+function fail(path, message) {
+    throw new UcpCheckoutParseError(path, message);
+}
+function requireObject(value, path) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        fail(path, "must be an object");
+    }
+    return value;
+}
+function requireString(value, path) {
+    if (typeof value !== "string")
+        fail(path, "must be a string");
+    return value;
+}
+function requireNonEmptyString(value, path) {
+    const s = requireString(value, path);
+    if (s.length === 0)
+        fail(path, "must be a non-empty string");
+    return s;
+}
+function requireInteger(value, path) {
+    if (typeof value !== "number" || !Number.isInteger(value))
+        fail(path, "must be an integer");
+    return value;
+}
+function requireEnum(value, allowed, path) {
+    const s = requireNonEmptyString(value, path);
+    if (!allowed.includes(s)) {
+        fail(path, `must be one of ${allowed.join("|")} (got ${s})`);
+    }
+    return s;
+}
+const RFC3339 = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$/;
+function requireIsoTimestamp(value, path) {
+    const s = requireNonEmptyString(value, path);
+    if (!RFC3339.test(s) || Number.isNaN(Date.parse(s)))
+        fail(path, "must be an RFC 3339 timestamp");
+    return s;
+}
+/** 解析对象并把「未知字段原样保留」的 forward-compat 补到目标对象上。 */
+function preserveUnknown(obj, target, known) {
+    for (const key of Object.keys(obj)) {
+        if (!known.has(key) && !(key in target))
+            target[key] = obj[key];
+    }
+}
+// ---------------------------------------------------------------------------
+// 子结构解析
+// ---------------------------------------------------------------------------
+function parseLineItems(value) {
+    if (!Array.isArray(value))
+        fail("/line_items", "must be an array");
+    return value.map((entry, i) => {
+        const obj = requireObject(entry, `/line_items/${i}`);
+        const item = {
+            sku: requireNonEmptyString(obj.sku, `/line_items/${i}/sku`),
+            quantity: requireInteger(obj.quantity, `/line_items/${i}/quantity`),
+        };
+        if (obj.unit_price !== undefined) {
+            const price = requireObject(obj.unit_price, `/line_items/${i}/unit_price`);
+            item.unit_price = {
+                currency: requireNonEmptyString(price.currency, `/line_items/${i}/unit_price/currency`),
+                amount_minor: requireInteger(price.amount_minor, `/line_items/${i}/unit_price/amount_minor`),
+            };
+        }
+        preserveUnknown(obj, item, new Set(["sku", "quantity", "unit_price"]));
+        return item;
+    });
+}
+function parseTotals(value) {
+    const obj = requireObject(value, "/totals");
+    const totals = {
+        currency: requireNonEmptyString(obj.currency, "/totals/currency"),
+        total: requireInteger(obj.total, "/totals/total"),
+    };
+    for (const key of ["items_total", "tax", "shipping", "discount"]) {
+        if (obj[key] !== undefined)
+            totals[key] = requireInteger(obj[key], `/totals/${key}`);
+    }
+    preserveUnknown(obj, totals, new Set(["currency", "total", "items_total", "tax", "shipping", "discount"]));
+    return totals;
+}
+function parseMessages(value) {
+    if (!Array.isArray(value))
+        fail("/messages", "must be an array");
+    return value.map((entry, i) => {
+        const obj = requireObject(entry, `/messages/${i}`);
+        const msg = {
+            type: requireEnum(obj.type, UCP_MESSAGE_TYPES, `/messages/${i}/type`),
+            severity: requireEnum(obj.severity, UCP_MESSAGE_SEVERITIES, `/messages/${i}/severity`),
+        };
+        if (obj.code !== undefined)
+            msg.code = requireNonEmptyString(obj.code, `/messages/${i}/code`);
+        if (obj.message !== undefined)
+            msg.message = requireString(obj.message, `/messages/${i}/message`);
+        preserveUnknown(obj, msg, new Set(["type", "severity", "code", "message"]));
+        return msg;
+    });
+}
+function parseLinks(value) {
+    if (!Array.isArray(value))
+        fail("/links", "must be an array");
+    return value.map((entry, i) => {
+        const obj = requireObject(entry, `/links/${i}`);
+        const link = {
+            rel: requireNonEmptyString(obj.rel, `/links/${i}/rel`),
+            href: requireNonEmptyString(obj.href, `/links/${i}/href`),
+        };
+        preserveUnknown(obj, link, new Set(["rel", "href"]));
+        return link;
+    });
+}
+// ---------------------------------------------------------------------------
+// 响应结构解析
+// ---------------------------------------------------------------------------
+/**
+ * 解析并校验 UCP checkout 响应（success/error 判别走 /ucp/status）。
+ * 结构非法 → 抛 UcpCheckoutParseError（fail-closed）。
+ */
+export function parseUcpCheckoutResponse(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 parseSuccessSession(root, ucp, version);
+    }
+    return parseErrorResponse(root, ucp, version);
+}
+function parseSuccessSession(root, ucp, version) {
+    const session = {
+        ucp: { ...ucp, status: "success", version },
+        status: requireEnum(root.status, UCP_CHECKOUT_STATUSES, "/status"),
+        session_id: requireNonEmptyString(root.session_id, "/session_id"),
+    };
+    const known = new Set(["ucp", "status", "session_id"]);
+    if (root.expires_at !== undefined) {
+        session.expires_at = requireIsoTimestamp(root.expires_at, "/expires_at");
+        known.add("expires_at");
+    }
+    if (root.line_items !== undefined) {
+        session.line_items = parseLineItems(root.line_items);
+        known.add("line_items");
+    }
+    if (root.totals !== undefined) {
+        session.totals = parseTotals(root.totals);
+        known.add("totals");
+    }
+    if (root.messages !== undefined) {
+        session.messages = parseMessages(root.messages);
+        known.add("messages");
+    }
+    if (root.continue_url !== undefined) {
+        session.continue_url = requireNonEmptyString(root.continue_url, "/continue_url");
+        known.add("continue_url");
+    }
+    if (root.payment !== undefined) {
+        session.payment = requireObject(root.payment, "/payment");
+        known.add("payment");
+    }
+    if (root.links !== undefined) {
+        session.links = parseLinks(root.links);
+        known.add("links");
+    }
+    if (root.authorization_reference !== undefined) {
+        session.authorization_reference = requireNonEmptyString(root.authorization_reference, "/authorization_reference");
+        known.add("authorization_reference");
+    }
+    preserveUnknown(root, session, known);
+    return session;
+}
+function parseErrorResponse(root, ucp, version) {
+    if (!Array.isArray(root.messages))
+        fail("/messages", "error response requires a messages array");
+    const response = {
+        ucp: { ...ucp, status: "error", version },
+        messages: parseMessages(root.messages),
+    };
+    const known = new Set(["ucp", "messages"]);
+    if (root.continue_url !== undefined) {
+        response.continue_url = requireNonEmptyString(root.continue_url, "/continue_url");
+        known.add("continue_url");
+    }
+    preserveUnknown(root, response, known);
+    return response;
+}
+// ---------------------------------------------------------------------------
+// 判别守卫
+// ---------------------------------------------------------------------------
+/**
+ * 判别守卫：success 响应（资源本体）。嵌套判别（/ucp/status）在带 index signature
+ * 的联合成员上无法被 TS 自动窄化，必须用显式 type guard。
+ */
+export function isUcpCheckoutSuccessSession(value) {
+    return value.ucp.status === "success";
+}
+/** 判别守卫：error 响应（无资源本体，只有 messages + continue_url）。 */
+export function isUcpCheckoutErrorResponse(value) {
+    return value.ucp.status === "error";
+}
+const emptyGrouping = () => ({
+    unrecoverable: [],
+    requiresBuyerInput: [],
+    requiresBuyerReview: [],
+    recoverable: [],
+    other: [],
+});
+/** 按 severity 分组（severity 是处理算法的唯一输入；type 只是辅助信息）。 */
+export function groupMessages(messages) {
+    if (messages === undefined || messages.length === 0)
+        return emptyGrouping();
+    const groups = emptyGrouping();
+    for (const m of messages) {
+        switch (m.severity) {
+            case "unrecoverable":
+                groups.unrecoverable.push(m);
+                break;
+            case "requires_buyer_input":
+                groups.requiresBuyerInput.push(m);
+                break;
+            case "requires_buyer_review":
+                groups.requiresBuyerReview.push(m);
+                break;
+            case "recoverable":
+                groups.recoverable.push(m);
+                break;
+            default:
+                groups.other.push(m);
+        }
+    }
+    return groups;
+}
+/** 汇总 messages 为可读字符串（`[code] message; …`）。空 → "no message details"。 */
+export function summarizeMessages(messages) {
+    if (messages === undefined || messages.length === 0)
+        return "no message details";
+    const parts = messages
+        .map((m) => `${m.code !== undefined ? `[${m.code}]` : ""}${m.message ?? ""}`.trim())
+        .filter((s) => s.length > 0);
+    return parts.length > 0 ? parts.join("; ") : "no message details";
+}
+function hasErrorType(messages) {
+    return messages.some((m) => m.type === "error");
+}
+/**
+ * 消息算法（不依赖会话状态）：unrecoverable → fail_closed；requires_* → requires_user；
+ * recoverable 或 error 类型 → retryable（改输入重试）；否则 ok。
+ */
+export function decideMessages(messages, continue_url) {
+    const groups = groupMessages(messages);
+    if (groups.unrecoverable.length > 0) {
+        return {
+            action: "fail_closed",
+            reason: `unrecoverable: ${summarizeMessages(groups.unrecoverable)}`,
+        };
+    }
+    const escalation = [...groups.requiresBuyerInput, ...groups.requiresBuyerReview];
+    if (escalation.length > 0) {
+        return {
+            action: "requires_user",
+            reason: `requires_escalation: ${summarizeMessages(escalation)}`,
+            continue_url,
+        };
+    }
+    if (groups.recoverable.length > 0 || hasErrorType(messages ?? [])) {
+        return { action: "retryable", reason: `recoverable: ${summarizeMessages(messages)}` };
+    }
+    return { action: "ok" };
+}
+/**
+ * 把一份 UCP checkout 响应（success/error）映射为「核心动作」。终态
+ * （completed/canceled）与 requires_escalation 状态优先于消息算法。
+ */
+export function decideResponse(response) {
+    if (response.ucp.status === "error") {
+        const decision = decideMessages(response.messages, response.continue_url);
+        // error 响应意味着操作失败：即使消息不可归因也绝不能 ok（fail-closed）。
+        return decision.action === "ok"
+            ? { action: "fail_closed", reason: "ucp error response without actionable messages" }
+            : decision;
+    }
+    const checkout = response;
+    if (checkout.status === "completed" || checkout.status === "canceled") {
+        // 终态权威：消息只作旁证，不把已完成/已取消翻成失败。
+        return { action: "ok" };
+    }
+    if (checkout.status === "requires_escalation") {
+        return {
+            action: "requires_user",
+            reason: `requires_escalation: ${summarizeMessages(checkout.messages)}`,
+            continue_url: checkout.continue_url,
+        };
+    }
+    const decision = decideMessages(checkout.messages, checkout.continue_url);
+    // ready_for_complete / complete_in_progress / incomplete：消息算法决定动作
+    // （recoverable → retryable，requires_* → requires_user，无可操作 → ok）。
+    return decision;
+}
+// ---------------------------------------------------------------------------
+// 复用导出（同包 cart-parse 用；cart 实体与 checkout 同构，不另起平行实现）
+// ---------------------------------------------------------------------------
+export { fail, parseErrorResponse as parseUcpErrorEnvelope, parseLineItems, parseLinks, parseMessages, parseTotals, preserveUnknown, requireIsoTimestamp, requireNonEmptyString, requireObject, };
+//# sourceMappingURL=parse.js.map

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

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

package/dist/handoff/ucp-checkout/totals.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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 Checkout totals 校验。
+ *
+ * totals 是 business 权威（platform MUST NOT 自行计算替代）；platform MAY 校验
+ * `非 total 各项之和 == total`。不符 → MUST NOT 自动完成，应拒绝或升级。本模块
+ * 只做「校验 + 结构化上报」，绝不修改 / 替代 business 给出的 totals。
+ *
+ * 判定规则：
+ *   - 无 totals → undefined（不校验；business 权威）；
+ *   - totals 有至少一个数值细项（除 currency/total 外）→ 求和 == total 才 ok，
+ *     否则 mismatch（附 breakdown 供上报）；
+ *   - totals 只有 currency + total（无数值细项可核对）→ 视为「无法校验」→ 拒绝
+ *     完成（fail-closed：无法证明 sum 一致就不能自动完成）。
+ */
+import type { UcpCheckoutTotals } from "./types.js";
+export interface TotalsValidationResult {
+    ok: boolean;
+    /** 非 total 各项之和。 */
+    computed: number;
+    /** business 声明的 total。 */
+    expected: number;
+    /** 参与求和的数值字段明细（不含 currency/total）。 */
+    breakdown: Record<string, number>;
+}
+/** totals 缺席 → undefined（MAY 校验，不强制）。 */
+export declare function validateTotals(totals: UcpCheckoutTotals | undefined): TotalsValidationResult | undefined;

package/dist/handoff/ucp-checkout/totals.js

@@ -0,0 +1,36 @@
+/**
+ * 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.
+ */
+/** totals 缺席 → undefined（MAY 校验，不强制）。 */
+export function validateTotals(totals) {
+    if (totals === undefined)
+        return undefined;
+    const breakdown = {};
+    let computed = 0;
+    for (const [key, value] of Object.entries(totals)) {
+        if (key === "currency" || key === "total")
+            continue;
+        if (typeof value === "number" && Number.isInteger(value)) {
+            breakdown[key] = value;
+            computed += value;
+        }
+    }
+    if (Object.keys(breakdown).length === 0) {
+        // 无数值细项可核对 → 无法证明 sum == total → fail-closed。
+        return { ok: false, computed: 0, expected: totals.total, breakdown };
+    }
+    return { ok: computed === totals.total, computed, expected: totals.total, breakdown };
+}
+//# sourceMappingURL=totals.js.map

package/dist/handoff/ucp-checkout/totals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"totals.js","sourceRoot":"","sources":["../../../src/handoff/ucp-checkout/totals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA6BH,yCAAyC;AACzC,MAAM,UAAU,cAAc,CAAC,MAAqC;IAClE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,SAAS,GAA2B,EAAE,CAAC;IAC7C,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,OAAO;YAAE,SAAS;QACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACvB,QAAQ,IAAI,KAAK,CAAC;QACpB,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,8CAA8C;QAC9C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;IACvE,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,QAAQ,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;AACxF,CAAC"}