@harrylabsj/kiwi 0.6.0

package/dist/commerce/http-client.js

@@ -0,0 +1,284 @@
+/**
+ * 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.
+ */
+/**
+ * HttpCommerceClient — CommerceClient over the shopping-cli 2.x
+ * shopping.negotiation/0.1 HTTP API (the authoritative Commerce Gateway).
+ *
+ * This is the only supported way Kiwi talks to a real marketplace. No Python
+ * imports, no SQLite, no subprocess calls into shopping-cli business
+ * commands. Auth is `Authorization: Bearer <token>`; the API answers with a
+ * uniform `{"ok": true, ...}` / `{"ok": false, "error": ...}` envelope.
+ *
+ * Protocol mapping (references/negotiation-api.md on the shopping-cli side):
+ * - GET  /capabilities                  -> getCapabilities (inner `capabilities`
+ *                                          object, frozen-schema validated)
+ * - GET  /negotiation/pending-messages  -> listPendingMessages (role/owner are
+ *                                          derived from the token server-side;
+ *                                          the client never sends them)
+ * - POST /negotiation/claims            -> claimMessage
+ * - GET  /negotiation/snapshot          -> getNegotiationSnapshot (frozen-schema
+ *                                          validated, fail closed)
+ * - POST /negotiation/decisions         -> submitNegotiationDecision (inner
+ *                                          `policy_result`, frozen-schema
+ *                                          validated)
+ * - POST /negotiation/claims/{complete,fail,abandon} -> claim settlement
+ *
+ * Every gateway response that carries a frozen-contract object (capabilities,
+ * snapshot, policy_result) is validated with the Kiwi Ajv frozen schemas
+ * before use: a malformed envelope, a missing inner object, or a wrong field
+ * type is classified as a `validation` CommerceError and never trusted.
+ */
+import { validateAgainst } from "../contracts/schemas.js";
+import { readJsonBody, SafeHttpError } from "../net/safe-http.js";
+import { CommerceError, } from "./types.js";
+const PROCESS_STATUSES = [
+    "processing",
+    "processed",
+    "failed",
+    "abandoned",
+];
+export class HttpCommerceClient {
+    baseUrl;
+    token;
+    fetchImpl;
+    timeoutMs;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+        this.token = options.token;
+        this.fetchImpl = options.fetchImpl ?? globalThis.fetch;
+        this.timeoutMs = options.timeoutMs ?? 15_000;
+    }
+    async request(method, path, body) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        let response;
+        try {
+            response = await this.fetchImpl(`${this.baseUrl}${path}`, {
+                method,
+                // 出站加固：绝不跟随重定向（3xx 目标不经过校验，且会携带 Bearer 头）。
+                redirect: "manual",
+                headers: {
+                    authorization: `Bearer ${this.token}`,
+                    "content-type": "application/json",
+                    accept: "application/json",
+                },
+                body: body === undefined ? undefined : JSON.stringify(body),
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            throw new CommerceError("transient", `Commerce API request failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        if (response.redirected ||
+            response.type === "opaqueredirect" ||
+            (response.status >= 300 && response.status < 400)) {
+            throw new CommerceError("transient", `Commerce API must not follow redirects (HTTP ${response.status})`);
+        }
+        let payload = {};
+        try {
+            // 响应体读取在超时覆盖内 + 大小上限（出站加固）。
+            payload = (await readJsonBody(response, { signal: controller.signal }));
+        }
+        catch (err) {
+            if (controller.signal.aborted) {
+                throw new CommerceError("transient", `Commerce API request timed out after ${this.timeoutMs}ms while reading response`);
+            }
+            if (err instanceof SafeHttpError && err.code === "response_too_large") {
+                throw new CommerceError("transient", err.message);
+            }
+            // Non-JSON body; handled via status mapping below.
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        if (!response.ok || payload.ok === false) {
+            const message = typeof payload.error === "string" ? payload.error : `HTTP ${response.status}`;
+            const kind = response.status === 401 || response.status === 403
+                ? "auth"
+                : response.status === 404
+                    ? "not_found"
+                    : response.status === 409
+                        ? "conflict"
+                        : response.status === 429
+                            ? "rate_limit"
+                            : response.status >= 400 && response.status < 500
+                                ? "validation"
+                                : "transient";
+            throw new CommerceError(kind, message, response.status);
+        }
+        return payload;
+    }
+    /** Fail-closed shape check for envelope fields that carry typed data. */
+    static badShape(what, detail) {
+        return new CommerceError("validation", `Commerce API ${what} response invalid: ${detail}`);
+    }
+    static requireObject(value, what) {
+        if (typeof value !== "object" || value === null || Array.isArray(value)) {
+            throw HttpCommerceClient.badShape(what, "expected an object");
+        }
+        return value;
+    }
+    async health() {
+        const payload = await this.request("GET", "/health");
+        return {
+            ok: payload.ok === true,
+            service: typeof payload.service === "string" ? payload.service : undefined,
+            version: typeof payload.version === "string" ? payload.version : undefined,
+            details: typeof payload.checks === "object" && payload.checks !== null
+                ? payload.checks
+                : undefined,
+        };
+    }
+    async getCapabilities() {
+        const payload = await this.request("GET", "/capabilities");
+        const inner = HttpCommerceClient.requireObject(payload.capabilities, "capabilities");
+        const errors = validateAgainst("capabilities", inner);
+        if (errors.length > 0) {
+            throw HttpCommerceClient.badShape("capabilities", errors.join("; "));
+        }
+        return inner;
+    }
+    async listPendingMessages() {
+        const payload = await this.request("GET", "/negotiation/pending-messages");
+        if (!Array.isArray(payload.pending)) {
+            throw HttpCommerceClient.badShape("pending-messages", "pending must be an array");
+        }
+        return payload.pending.map((item, index) => {
+            const what = `pending-messages[${index}]`;
+            const m = HttpCommerceClient.requireObject(item, what);
+            if (typeof m.conversation_id !== "string" ||
+                !Number.isInteger(m.message_id) ||
+                typeof m.conversation_status !== "string" ||
+                (m.sender_role !== "buyer" && m.sender_role !== "merchant") ||
+                typeof m.preview !== "string" ||
+                typeof m.created_at !== "string") {
+                throw HttpCommerceClient.badShape(what, "field types do not match the protocol");
+            }
+            return {
+                conversation_id: m.conversation_id,
+                message_id: m.message_id,
+                conversation_status: m.conversation_status,
+                sender_role: m.sender_role,
+                preview: m.preview,
+                created_at: m.created_at,
+            };
+        });
+    }
+    async claimMessage(input) {
+        const payload = await this.request("POST", "/negotiation/claims", {
+            conversation_id: input.conversation_id,
+            message_id: input.message_id,
+            idempotency_key: input.idempotency_key,
+        });
+        const claim = HttpCommerceClient.requireObject(payload.claim, "claim");
+        if (typeof claim.claimed !== "boolean" ||
+            typeof claim.status !== "string" ||
+            typeof claim.attempts !== "number" ||
+            typeof claim.idempotency_key !== "string") {
+            throw HttpCommerceClient.badShape("claim", "field types do not match the protocol");
+        }
+        return {
+            claimed: claim.claimed,
+            status: claim.status,
+            attempts: claim.attempts,
+            idempotency_key: claim.idempotency_key,
+        };
+    }
+    async getNegotiationSnapshot(input) {
+        const query = `conversation_id=${encodeURIComponent(input.conversation_id)}` +
+            `&message_id=${encodeURIComponent(String(input.message_id))}`;
+        const payload = await this.request("GET", `/negotiation/snapshot?${query}`);
+        const inner = HttpCommerceClient.requireObject(payload.snapshot, "snapshot");
+        const errors = validateAgainst("snapshot", inner);
+        if (errors.length > 0) {
+            throw HttpCommerceClient.badShape("snapshot", errors.join("; "));
+        }
+        return inner;
+    }
+    async submitNegotiationDecision(input) {
+        const payload = await this.request("POST", "/negotiation/decisions", {
+            idempotency_key: input.idempotency_key,
+            decision: input.decision,
+        });
+        const inner = HttpCommerceClient.requireObject(payload.policy_result, "policy_result");
+        const errors = validateAgainst("policy-result", inner);
+        if (errors.length > 0) {
+            throw HttpCommerceClient.badShape("policy_result", errors.join("; "));
+        }
+        return inner;
+    }
+    async completeClaim(input) {
+        return this.processVerb("complete", input.message_id);
+    }
+    async failClaim(input) {
+        return this.processVerb("fail", input.message_id, input.error);
+    }
+    async abandonClaim(input) {
+        return this.processVerb("abandon", input.message_id, input.error);
+    }
+    async heartbeat(input) {
+        const body = {};
+        if (input?.message_id !== undefined)
+            body.message_id = input.message_id;
+        const payload = await this.request("POST", "/negotiation/claims/heartbeat", body);
+        const inner = HttpCommerceClient.requireObject(payload.heartbeat, "heartbeat");
+        if (typeof inner.status !== "string" ||
+            !Number.isInteger(inner.refreshed) ||
+            typeof inner.at !== "string") {
+            throw HttpCommerceClient.badShape("heartbeat", "field types do not match the protocol");
+        }
+        return { status: inner.status, refreshed: inner.refreshed, at: inner.at };
+    }
+    async abandonStaleClaims(input) {
+        const body = {};
+        if (input?.ttl_seconds !== undefined)
+            body.ttl_seconds = input.ttl_seconds;
+        const payload = await this.request("POST", "/negotiation/claims/abandon-stale", body);
+        const inner = HttpCommerceClient.requireObject(payload.stale, "abandon-stale");
+        if (!Number.isInteger(inner.abandoned) ||
+            !Array.isArray(inner.message_ids) ||
+            !inner.message_ids.every((id) => Number.isInteger(id)) ||
+            !Number.isInteger(inner.ttl_seconds) ||
+            typeof inner.at !== "string") {
+            throw HttpCommerceClient.badShape("abandon-stale", "field types do not match the protocol");
+        }
+        return {
+            abandoned: inner.abandoned,
+            message_ids: inner.message_ids,
+            ttl_seconds: inner.ttl_seconds,
+            at: inner.at,
+        };
+    }
+    async processVerb(verb, messageId, error) {
+        const payload = await this.request("POST", `/negotiation/claims/${verb}`, {
+            message_id: messageId,
+            ...(error !== undefined ? { error } : {}),
+        });
+        const process = HttpCommerceClient.requireObject(payload.process, `claims/${verb}`);
+        if (typeof process.status !== "string" ||
+            !PROCESS_STATUSES.includes(process.status)) {
+            throw HttpCommerceClient.badShape(`claims/${verb}`, "process.status invalid");
+        }
+        const result = {
+            status: process.status,
+            message_id: messageId,
+        };
+        if (typeof process.last_error === "string")
+            result.last_error = process.last_error;
+        return result;
+    }
+}
+//# sourceMappingURL=http-client.js.map

package/dist/commerce/http-client.js.map

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

package/dist/commerce/local-db-source.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 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 { DatabaseSync } from "node:sqlite";
+import type { CommerceHealth } from "./types.js";
+import { type CommerceDataSource, type CommerceField, type ProductFact, type ProductSearchQuery } from "./data-source.js";
+declare const CTOR: unique symbol;
+/** 本地商品库 CommerceDataSource（LOCAL_AUTHORITATIVE）。 */
+export declare class LocalDatabaseCommerceDataSource implements CommerceDataSource {
+    private readonly db;
+    constructor(db: DatabaseSync, _token: typeof CTOR);
+    getProduct(sku: string): Promise<ProductFact | undefined>;
+    getProducts(query?: ProductSearchQuery): Promise<ProductFact[]>;
+    getInventory(sku: string): Promise<CommerceField<number> | undefined>;
+    getPrice(sku: string): Promise<CommerceField<{
+        currency: string;
+        amount_minor: number;
+    }> | undefined>;
+    getPublicListing(): Promise<Record<string, unknown>>;
+    health(): Promise<CommerceHealth>;
+    /** 写入商品事实（本地权威：录入即事实）。 */
+    upsertProduct(input: {
+        sku: string;
+        title?: string;
+        price_minor: number;
+        currency?: string;
+        stock?: number;
+        delivery_lead_days?: number;
+        updated_at?: string;
+    }): ProductFact;
+    close(): void;
+    private rowToFact;
+}
+/** 打开（必要时创建）本地商品库；目录 0700 / 文件 0600。 */
+export declare function openLocalDatabaseCommerceDataSource(options: {
+    dbPath: string;
+}): LocalDatabaseCommerceDataSource;
+export {};

package/dist/commerce/local-db-source.js

@@ -0,0 +1,162 @@
+/**
+ * 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.
+ */
+/**
+ * LocalDatabaseCommerceDataSource —— 本地商品库（node:sqlite，
+ * shopping-cli data hub v0.2.1 §4/#6「至少一种本地数据库源」）。
+ *
+ * 全部字段 LOCAL_AUTHORITATIVE（本地规则/录入即权威）；存储惯例对齐
+ * src/handoff/order-record.ts（目录 0700 / 文件 0600 / DatabaseSync）。
+ * public-only：成本/底价等私有字段不在本表。
+ */
+import { chmodSync, existsSync, mkdirSync } from "node:fs";
+import path from "node:path";
+import { DatabaseSync } from "node:sqlite";
+import { CommerceError, } from "./data-source.js";
+const PRODUCT_SCHEMA = `
+CREATE TABLE IF NOT EXISTS product_facts (
+  sku               TEXT PRIMARY KEY,
+  title             TEXT NOT NULL DEFAULT '',
+  price_minor       INTEGER NOT NULL,
+  currency          TEXT NOT NULL DEFAULT 'CNY',
+  stock             INTEGER,
+  delivery_lead_days INTEGER,
+  updated_at        TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_product_title ON product_facts(title);
+`;
+const CTOR = Symbol("local-db-source.ctor");
+/** LIKE 通配符转义（`%`/`_` 在用户输入里是字面量，不是通配符）。 */
+function escapeLike(value) {
+    return value.replace(/[\\%_]/g, (ch) => `\\${ch}`);
+}
+/** 本地商品库 CommerceDataSource（LOCAL_AUTHORITATIVE）。 */
+export class LocalDatabaseCommerceDataSource {
+    db;
+    constructor(db, _token) {
+        this.db = db;
+    }
+    async getProduct(sku) {
+        if (typeof sku !== "string" || sku.length === 0) {
+            throw new CommerceError("invalid_input", "sku must be a non-empty string");
+        }
+        const row = this.db
+            .prepare("SELECT * FROM product_facts WHERE sku = ?")
+            .get(sku);
+        return row === undefined ? undefined : this.rowToFact(row);
+    }
+    async getProducts(query = {}) {
+        const limit = Math.max(1, Math.min(Number(query.limit ?? 20) || 20, 100));
+        const q = (query.q ?? "").trim();
+        const rows = q
+            ? this.db
+                .prepare("SELECT * FROM product_facts WHERE sku LIKE ? ESCAPE '\\' OR title LIKE ? ESCAPE '\\' ORDER BY sku LIMIT ?")
+                .all(`%${escapeLike(q)}%`, `%${escapeLike(q)}%`, limit)
+            : this.db
+                .prepare("SELECT * FROM product_facts ORDER BY sku LIMIT ?")
+                .all(limit);
+        return rows.map((r) => this.rowToFact(r));
+    }
+    async getInventory(sku) {
+        const product = await this.getProduct(sku);
+        if (product?.stock === undefined)
+            return undefined;
+        return {
+            value: product.stock,
+            authority: "LOCAL_AUTHORITATIVE",
+            source: "local-db",
+        };
+    }
+    async getPrice(sku) {
+        const product = await this.getProduct(sku);
+        if (product?.price_minor === undefined || product.currency === undefined)
+            return undefined;
+        return {
+            value: { currency: product.currency, amount_minor: product.price_minor },
+            authority: "LOCAL_AUTHORITATIVE",
+            source: "local-db",
+        };
+    }
+    async getPublicListing() {
+        const rows = this.db
+            .prepare("SELECT sku, title, price_minor, currency FROM product_facts ORDER BY sku LIMIT 500")
+            .all();
+        return { source: "local-db", count: rows.length, products: rows.map((r) => this.rowToFact(r)) };
+    }
+    async health() {
+        try {
+            this.db.prepare("SELECT COUNT(*) AS n FROM product_facts").get();
+            return { ok: true, service: "local-db-commerce-data-source", version: "1" };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                service: "local-db-commerce-data-source",
+                details: { error: err instanceof Error ? err.message : String(err) },
+            };
+        }
+    }
+    /** 写入商品事实（本地权威：录入即事实）。 */
+    upsertProduct(input) {
+        if (typeof input.sku !== "string" || input.sku.length === 0) {
+            throw new CommerceError("invalid_input", "sku must be a non-empty string");
+        }
+        if (!Number.isInteger(input.price_minor) || input.price_minor < 0) {
+            throw new CommerceError("invalid_input", "price_minor must be a non-negative integer");
+        }
+        const updatedAt = input.updated_at ?? new Date().toISOString();
+        this.db
+            .prepare(`INSERT INTO product_facts (sku, title, price_minor, currency, stock, delivery_lead_days, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?)
+         ON CONFLICT(sku) DO UPDATE SET
+           title=excluded.title, price_minor=excluded.price_minor, currency=excluded.currency,
+           stock=excluded.stock, delivery_lead_days=excluded.delivery_lead_days, updated_at=excluded.updated_at`)
+            .run(input.sku, input.title ?? "", input.price_minor, input.currency ?? "CNY", input.stock ?? null, input.delivery_lead_days ?? null, updatedAt);
+        const row = this.db.prepare("SELECT * FROM product_facts WHERE sku = ?").get(input.sku);
+        if (row === undefined)
+            throw new CommerceError("request_failed", "upsert did not persist");
+        return this.rowToFact(row);
+    }
+    close() {
+        this.db.close();
+    }
+    rowToFact(row) {
+        return {
+            sku: row.sku,
+            ...(row.title !== "" ? { title: row.title } : {}),
+            price_minor: row.price_minor,
+            currency: row.currency,
+            ...(row.stock !== null ? { stock: row.stock } : {}),
+            ...(row.delivery_lead_days !== null ? { delivery_lead_days: row.delivery_lead_days } : {}),
+        };
+    }
+}
+/** 打开（必要时创建）本地商品库；目录 0700 / 文件 0600。 */
+export function openLocalDatabaseCommerceDataSource(options) {
+    if (options.dbPath === ":memory:") {
+        const db = new DatabaseSync(":memory:");
+        db.exec(PRODUCT_SCHEMA);
+        return new LocalDatabaseCommerceDataSource(db, CTOR);
+    }
+    const dir = path.dirname(options.dbPath);
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+    chmodSync(dir, 0o700);
+    const db = new DatabaseSync(options.dbPath);
+    if (existsSync(options.dbPath))
+        chmodSync(options.dbPath, 0o600);
+    db.exec(PRODUCT_SCHEMA);
+    return new LocalDatabaseCommerceDataSource(db, CTOR);
+}
+//# sourceMappingURL=local-db-source.js.map

package/dist/commerce/local-db-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-db-source.js","sourceRoot":"","sources":["../../src/commerce/local-db-source.ts"],"names":[],"mappings":"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"}

package/dist/commerce/shopping-cli-source.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 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.
+ */
+/**
+ * ShoppingCliCommerceDataSource —— shopping-cli 商品开放层 adapter
+ * （shopping-cli data hub v0.2.1 §3/#5：shopping-cli 可作为 Merchant
+ * CommerceDataSource，完成定义 #5）。
+ *
+ * 端点契约（shopping-cli 仓 route_registry）：
+ *   GET {baseUrl}/products/{sku}        → {product: {...}}
+ *   GET {baseUrl}/search/products?limit= → {results: [...]}
+ *
+ * 字段语义：
+ *   - shopping-cli 的 `price` 以「元」为单位（float）→ 转换为
+ *     `price_minor`（minor units，KNP Money 约定；两位小数假设，文档注明）；
+ *   - 权威语义 UPSTREAM_PROXY（数据权威在 shopping-cli 侧，Kiwi 只读）。
+ */
+import { type CommerceDataSource, type CommerceField, type ProductFact, type ProductSearchQuery } from "./data-source.js";
+import type { CommerceHealth } from "./types.js";
+export interface ShoppingCliCommerceDataSourceDeps {
+    /** shopping-cli 服务根 URL（http/https，无 userinfo/query/fragment）。 */
+    baseUrl: string;
+    /** 可选的 bearer 凭证（merchants 角色只读 token）。 */
+    authToken?: string;
+    /** 拉取超时 ms（默认 15000）。 */
+    timeoutMs?: number;
+    /** 注入 fetch（测试）。 */
+    fetchImpl?: typeof fetch;
+}
+/** shopping-cli 商品开放层数据源（UPSTREAM_PROXY，source="shopping-cli"）。 */
+export declare class ShoppingCliCommerceDataSource implements CommerceDataSource {
+    private readonly baseUrl;
+    private readonly deps;
+    constructor(deps: ShoppingCliCommerceDataSourceDeps);
+    private getJson;
+    getProduct(sku: string): Promise<ProductFact | undefined>;
+    getProducts(query?: ProductSearchQuery): Promise<ProductFact[]>;
+    getInventory(sku: string): Promise<CommerceField<number> | undefined>;
+    getPrice(sku: string): Promise<CommerceField<{
+        currency: string;
+        amount_minor: number;
+    }> | undefined>;
+    getPublicListing(): Promise<Record<string, unknown>>;
+    health(): Promise<CommerceHealth>;
+}