@nuanu-ai/agentify-contracts 0.3.2

package/dist/index.d.ts

@@ -0,0 +1,1008 @@
+/**
+ * Agentify contracts — the single source of truth for the card, the order, the
+ * price check, the receipt and everything else that crosses the boundary
+ * between us, a merchant and an agent. Everything that goes outside or arrives
+ * from outside is described here by a zod schema; consumers get their types by
+ * inference from the schema instead of writing them by hand (ADR-0003 §5).
+ *
+ * This package owns the wire vocabulary: the field names, the values an agent
+ * or a merchant can see, the refusal codes, the event names. What the gateway
+ * calls things inside itself is its own business, and the two are tied
+ * together where they meet rather than by one importing the other.
+ *
+ * Two shapes here are read by nobody outside our own two parts, and they are
+ * described anyway. The worker envelope carries orders, price questions and
+ * events on one stream (ADR-0004 §2), and the merchant never sees it, because
+ * the SDK hands a handler an order rather than the wrapper it arrived in. The
+ * route table says which calls exist, at which addresses, with which document
+ * going each way. Both are formats between the gateway and the SDK, read by
+ * both and owned by neither — which is the same reason a card lives here, and
+ * the reason a shape agreed in two places is a shape that has already
+ * disagreed once.
+ */
+import { z } from "zod";
+export type { AgentOrderStatus, AuthMode, CatalogPage, ErrorCode, ErrorEnvelope, HttpMethod, MerchantCardList, OrderAcceptResponse, OrderCallResponse, OrderList, OrderListQuery, OrderWithStatus, PurchaseRequest, QuoteAnswerAck, ReceiptList, RouteDefinition, RouteName, RouteResponse, WorkerPollRequest, WorkerPollResponse, } from "./api.js";
+export { AgentOrderStatusSchema, API_ROUTES, AUTH_MODES, CatalogPageSchema, ERROR_CODES, ErrorEnvelopeSchema, expandPath, HTTP_METHODS, MERCHANT_KEY_HEADER, MerchantCardListSchema, merchantKeyFrom, merchantKeyHeaderValue, mountableRoutes, OrderAcceptResponseSchema, OrderCallResponseSchema, OrderListQuerySchema, OrderListSchema, OrderWithStatusSchema, PurchaseRequestSchema, pathParamsOf, QuoteAnswerAckSchema, ReceiptListSchema, WorkerPollRequestSchema, WorkerPollResponseSchema, } from "./api.js";
+export type { BazaarDeclaration, Card, CardInput, Fulfillment, MerchantCard, PriceCheck, PublicCard, } from "./card.js";
+export { bazaarDeclarationOf, CardSchema, deliveryCheckFor, FulfillmentSchema, MerchantCardSchema, PriceCheckSchema, PublicCardSchema, publicCardOf, purchaseCheckFor, ServiceNameSchema, TagsSchema, } from "./card.js";
+export type { WorkerEnvelope, WorkerEnvelopeKind } from "./envelope.js";
+export { WORKER_ENVELOPE_KINDS, WORKER_ENVELOPE_PAYLOADS, WorkerEnvelopeSchema, } from "./envelope.js";
+export type { OrderEvent, RefundDueReason } from "./events.js";
+export { ORDER_EVENT_TYPES, OrderEventSchema, RefundDueReasonSchema } from "./events.js";
+export type { EvmAddress } from "./evm-address.js";
+export { checksummedAddressOf, EvmAddressSchema } from "./evm-address.js";
+export type { Acceptance, Delivery, HandlerAnswer, Refusal, RefusalCode } from "./handler.js";
+export { AcceptanceSchema, DeliverySchema, HandlerAnswerSchema, RECOMMENDED_REFUSAL_CODES, RefusalCodeSchema, RefusalSchema, } from "./handler.js";
+export type { CabinetKey, DisabledKey, ForgottenCabinetKey, IssuedKey, IssueKeyRequest, MerchantKey, MerchantKeyList, PayoutWallet, PayoutWalletRequest, RegisteredMerchant, RegistrationRequest, SellerName, SellerNameRequest, } from "./merchant.js";
+export { CabinetKeySchema, DisabledKeySchema, ForgottenCabinetKeySchema, IssuedKeySchema, IssueKeyRequestSchema, MerchantKeyListSchema, MerchantKeySchema, PayoutWalletRequestSchema, PayoutWalletSchema, RegisteredMerchantSchema, RegistrationRequestSchema, SellerNameRequestSchema, SellerNameSchema, } from "./merchant.js";
+export type { Order } from "./order.js";
+export { OrderSchema } from "./order.js";
+export type { OrderStatus } from "./order-status.js";
+export { ORDER_STATUSES, OrderStatusSchema } from "./order-status.js";
+export type { FieldSpec, FieldSpecInput, ParamSpec, ParamSpecDirection, ParamSpecInput, ParamType, } from "./param-spec.js";
+export { FieldSpecSchema, ParamNameSchema, ParamSpecSchema, ParamTypeSchema, PROTOTYPE_KEY_IS_DROPPED, paramSpecToValidator, } from "./param-spec.js";
+export type { Amount, CurrencyCode, Identifier, Money, SalePrice, Timestamp, } from "./primitives.js";
+export { AmountSchema, CurrencyCodeSchema, IdentifierSchema, MoneySchema, SalePriceSchema, TimestampSchema, } from "./primitives.js";
+export type { QuotePurpose, QuoteRequest, QuoteResponse } from "./quote.js";
+export { QuotePurposeSchema, QuoteRequestSchema, QuoteResponseSchema } from "./quote.js";
+export type { Receipt, ReceiptOutcome } from "./receipt.js";
+export { ReceiptOutcomeSchema, ReceiptSchema } from "./receipt.js";
+export type { CallError, OrderCallResult, Problem, PublishResult } from "./results.js";
+export { CARD_REJECTED, CallErrorSchema, ORDER_CALL_ERROR_CODES, ORDER_CALL_RESULTS, OrderCallResultSchema, ProblemSchema, PublishResultSchema, } from "./results.js";
+export type { SellingState } from "./selling.js";
+export { SELLING_STATES, SellingStateSchema } from "./selling.js";
+/**
+ * The version of the public contract. It grows when the meaning of the fields
+ * changes, not when a schema is added: a consumer uses it to decide whether it
+ * understands the other side.
+ */
+export declare const CONTRACT_VERSION = "2";
+/**
+ * Every schema of the public contract, under the name it is known by outside
+ * TypeScript.
+ *
+ * The registry is what makes the contract readable by something that is not
+ * this package: the JSON Schema export below walks it, and a merchant's
+ * engineer working in another language reads that. It carries the building
+ * blocks as well as the whole documents, because a merchant validating one
+ * amount should not have to lift it out of a card.
+ *
+ * A schema that exists and is not here is a schema nobody outside TypeScript
+ * can see, so a test holds the two in step.
+ */
+export declare const schemas: Readonly<{
+    acceptance: z.ZodObject<{
+        eta_seconds: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>;
+    agent_order_status: z.ZodObject<{
+        order_id: z.ZodString;
+        status: z.ZodEnum<{
+            delivered: "delivered";
+            in_progress: "in_progress";
+            rejected: "rejected";
+            payment_unresolved: "payment_unresolved";
+            declined: "declined";
+            expired: "expired";
+            cancelled: "cancelled";
+            refund_due: "refund_due";
+            refunded: "refunded";
+            delivered_unpaid: "delivered_unpaid";
+        }>;
+        price: z.ZodNullable<z.ZodObject<{
+            amount: z.ZodString;
+            currency: z.ZodString;
+            at: z.ZodISODateTime;
+            as_of: z.ZodISODateTime;
+        }, z.core.$strict>>;
+        delivered: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        test: z.ZodBoolean;
+        refusal: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    amount: z.ZodString;
+    cabinet_key: z.ZodObject<{
+        secret: z.ZodString;
+    }, z.core.$strict>;
+    call_error: z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        retryable: z.ZodBoolean;
+        problems: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodArray<z.ZodString>;
+            code: z.ZodString;
+            message: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+    card: z.ZodObject<{
+        merchant_item_id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        price: z.ZodPreprocess<z.ZodObject<{
+            amount: z.ZodString;
+            currency: z.ZodString;
+        }, z.core.$strict>>;
+        params: z.ZodOptional<z.ZodPreprocess<z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                integer: "integer";
+            }>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>>;
+        result: z.ZodPreprocess<z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                integer: "integer";
+            }>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        fulfillment: z.ZodDefault<z.ZodEnum<{
+            sync: "sync";
+            async: "async";
+            confirm: "confirm";
+        }>>;
+        price_check: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"handler">, z.ZodObject<{
+            url: z.ZodURL;
+        }, z.core.$strict>]>>;
+        confirm_deadline_seconds: z.ZodOptional<z.ZodInt>;
+        fulfill_deadline_seconds: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>;
+    catalog_page: z.ZodObject<{
+        items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            price: z.ZodObject<{
+                amount: z.ZodString;
+                currency: z.ZodString;
+            }, z.core.$strict>;
+            as_of: z.ZodISODateTime;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodEnum<{
+                    string: "string";
+                    number: "number";
+                    boolean: "boolean";
+                    integer: "integer";
+                }>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                title: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            result: z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodEnum<{
+                    string: "string";
+                    number: "number";
+                    boolean: "boolean";
+                    integer: "integer";
+                }>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                title: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            price_checked_at_purchase: z.ZodBoolean;
+            fulfillment: z.ZodLiteral<"sync">;
+        }, z.core.$strict>, z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            price: z.ZodObject<{
+                amount: z.ZodString;
+                currency: z.ZodString;
+            }, z.core.$strict>;
+            as_of: z.ZodISODateTime;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodEnum<{
+                    string: "string";
+                    number: "number";
+                    boolean: "boolean";
+                    integer: "integer";
+                }>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                title: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            result: z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodEnum<{
+                    string: "string";
+                    number: "number";
+                    boolean: "boolean";
+                    integer: "integer";
+                }>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                title: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            price_checked_at_purchase: z.ZodBoolean;
+            fulfillment: z.ZodLiteral<"async">;
+            fulfill_deadline_seconds: z.ZodOptional<z.ZodInt>;
+        }, z.core.$strict>, z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            price: z.ZodObject<{
+                amount: z.ZodString;
+                currency: z.ZodString;
+            }, z.core.$strict>;
+            as_of: z.ZodISODateTime;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodEnum<{
+                    string: "string";
+                    number: "number";
+                    boolean: "boolean";
+                    integer: "integer";
+                }>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                title: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            result: z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodEnum<{
+                    string: "string";
+                    number: "number";
+                    boolean: "boolean";
+                    integer: "integer";
+                }>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                title: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            price_checked_at_purchase: z.ZodBoolean;
+            fulfillment: z.ZodLiteral<"confirm">;
+            confirm_deadline_seconds: z.ZodOptional<z.ZodInt>;
+            fulfill_deadline_seconds: z.ZodOptional<z.ZodInt>;
+        }, z.core.$strict>], "fulfillment">>;
+    }, z.core.$strict>;
+    currency_code: z.ZodString;
+    delivery: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    disabled_key: z.ZodObject<{
+        key: z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            created_at: z.ZodISODateTime;
+            last_used_at: z.ZodNullable<z.ZodISODateTime>;
+            disabled_at: z.ZodNullable<z.ZodISODateTime>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    error_envelope: z.ZodObject<{
+        error: z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            retryable: z.ZodBoolean;
+        }, z.core.$loose>;
+    }, z.core.$strict>;
+    evm_address: z.ZodString;
+    field_spec: z.ZodObject<{
+        type: z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            integer: "integer";
+        }>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    forgotten_cabinet_key: z.ZodObject<{
+        forgotten: z.ZodLiteral<true>;
+    }, z.core.$strict>;
+    fulfillment: z.ZodEnum<{
+        sync: "sync";
+        async: "async";
+        confirm: "confirm";
+    }>;
+    handler_answer: z.ZodUnion<readonly [z.ZodObject<{
+        delivered: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strict>, z.ZodObject<{
+        refused: z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        accepted: z.ZodObject<{
+            eta_seconds: z.ZodOptional<z.ZodInt>;
+        }, z.core.$strict>;
+    }, z.core.$strict>]>;
+    identifier: z.ZodString;
+    issue_key_request: z.ZodObject<{
+        label: z.ZodString;
+    }, z.core.$strict>;
+    issued_key: z.ZodObject<{
+        key: z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            created_at: z.ZodISODateTime;
+            last_used_at: z.ZodNullable<z.ZodISODateTime>;
+            disabled_at: z.ZodNullable<z.ZodISODateTime>;
+        }, z.core.$strict>;
+        secret: z.ZodString;
+    }, z.core.$strict>;
+    merchant_card: z.ZodObject<{
+        id: z.ZodString;
+        as_of: z.ZodISODateTime;
+        card: z.ZodObject<{
+            merchant_item_id: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodString;
+            price: z.ZodPreprocess<z.ZodObject<{
+                amount: z.ZodString;
+                currency: z.ZodString;
+            }, z.core.$strict>>;
+            params: z.ZodOptional<z.ZodPreprocess<z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodEnum<{
+                    string: "string";
+                    number: "number";
+                    boolean: "boolean";
+                    integer: "integer";
+                }>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                title: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>>;
+            result: z.ZodPreprocess<z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodEnum<{
+                    string: "string";
+                    number: "number";
+                    boolean: "boolean";
+                    integer: "integer";
+                }>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                title: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            fulfillment: z.ZodDefault<z.ZodEnum<{
+                sync: "sync";
+                async: "async";
+                confirm: "confirm";
+            }>>;
+            price_check: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"handler">, z.ZodObject<{
+                url: z.ZodURL;
+            }, z.core.$strict>]>>;
+            confirm_deadline_seconds: z.ZodOptional<z.ZodInt>;
+            fulfill_deadline_seconds: z.ZodOptional<z.ZodInt>;
+        }, z.core.$strict>;
+        selling: z.ZodEnum<{
+            open: "open";
+            paused: "paused";
+            departed: "departed";
+        }>;
+        paused: z.ZodBoolean;
+    }, z.core.$strict>;
+    merchant_card_list: z.ZodObject<{
+        selling: z.ZodEnum<{
+            open: "open";
+            paused: "paused";
+            departed: "departed";
+        }>;
+        cards: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            as_of: z.ZodISODateTime;
+            card: z.ZodObject<{
+                merchant_item_id: z.ZodString;
+                title: z.ZodString;
+                description: z.ZodString;
+                price: z.ZodPreprocess<z.ZodObject<{
+                    amount: z.ZodString;
+                    currency: z.ZodString;
+                }, z.core.$strict>>;
+                params: z.ZodOptional<z.ZodPreprocess<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    type: z.ZodEnum<{
+                        string: "string";
+                        number: "number";
+                        boolean: "boolean";
+                        integer: "integer";
+                    }>;
+                    required: z.ZodOptional<z.ZodBoolean>;
+                    title: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>>;
+                result: z.ZodPreprocess<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    type: z.ZodEnum<{
+                        string: "string";
+                        number: "number";
+                        boolean: "boolean";
+                        integer: "integer";
+                    }>;
+                    required: z.ZodOptional<z.ZodBoolean>;
+                    title: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                fulfillment: z.ZodDefault<z.ZodEnum<{
+                    sync: "sync";
+                    async: "async";
+                    confirm: "confirm";
+                }>>;
+                price_check: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"handler">, z.ZodObject<{
+                    url: z.ZodURL;
+                }, z.core.$strict>]>>;
+                confirm_deadline_seconds: z.ZodOptional<z.ZodInt>;
+                fulfill_deadline_seconds: z.ZodOptional<z.ZodInt>;
+            }, z.core.$strict>;
+            selling: z.ZodEnum<{
+                open: "open";
+                paused: "paused";
+                departed: "departed";
+            }>;
+            paused: z.ZodBoolean;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    merchant_key: z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        created_at: z.ZodISODateTime;
+        last_used_at: z.ZodNullable<z.ZodISODateTime>;
+        disabled_at: z.ZodNullable<z.ZodISODateTime>;
+    }, z.core.$strict>;
+    merchant_key_list: z.ZodObject<{
+        keys: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            created_at: z.ZodISODateTime;
+            last_used_at: z.ZodNullable<z.ZodISODateTime>;
+            disabled_at: z.ZodNullable<z.ZodISODateTime>;
+        }, z.core.$strict>>;
+        this_call: z.ZodString;
+    }, z.core.$strict>;
+    money: z.ZodObject<{
+        amount: z.ZodString;
+        currency: z.ZodString;
+    }, z.core.$strict>;
+    order: z.ZodObject<{
+        id: z.ZodString;
+        merchant_item_id: z.ZodString;
+        params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        price: z.ZodObject<{
+            amount: z.ZodString;
+            currency: z.ZodString;
+            at: z.ZodISODateTime;
+            as_of: z.ZodISODateTime;
+        }, z.core.$strict>;
+        price_id: z.ZodOptional<z.ZodString>;
+        test: z.ZodBoolean;
+    }, z.core.$strict>;
+    order_accept_response: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        ok: z.ZodLiteral<true>;
+    }, z.core.$strict>, z.ZodObject<{
+        ok: z.ZodLiteral<false>;
+        error: z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            retryable: z.ZodBoolean;
+            problems: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                path: z.ZodArray<z.ZodString>;
+                code: z.ZodString;
+                message: z.ZodString;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "ok">;
+    order_call_response: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        ok: z.ZodLiteral<true>;
+        result: z.ZodEnum<{
+            refused: "refused";
+            delivered: "delivered";
+            accepted: "accepted";
+            already_delivered: "already_delivered";
+            debt_closed_by_delivery: "debt_closed_by_delivery";
+            purchase_already_closed: "purchase_already_closed";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        ok: z.ZodLiteral<false>;
+        error: z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            retryable: z.ZodBoolean;
+            problems: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                path: z.ZodArray<z.ZodString>;
+                code: z.ZodString;
+                message: z.ZodString;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "ok">;
+    order_call_result: z.ZodEnum<{
+        refused: "refused";
+        delivered: "delivered";
+        accepted: "accepted";
+        already_delivered: "already_delivered";
+        debt_closed_by_delivery: "debt_closed_by_delivery";
+        purchase_already_closed: "purchase_already_closed";
+    }>;
+    order_event: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"order.refund_due">;
+        order_id: z.ZodString;
+        at: z.ZodISODateTime;
+        price: z.ZodObject<{
+            amount: z.ZodString;
+            currency: z.ZodString;
+        }, z.core.$strict>;
+        reason: z.ZodEnum<{
+            refused: "refused";
+            deadline_passed: "deadline_passed";
+            merchant_left: "merchant_left";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"order.unpaid_after_confirmation">;
+        order_id: z.ZodString;
+        at: z.ZodISODateTime;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"order.payment_failed_after_delivery">;
+        order_id: z.ZodString;
+        at: z.ZodISODateTime;
+    }, z.core.$strict>], "type">;
+    order_list: z.ZodObject<{
+        orders: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            merchant_item_id: z.ZodString;
+            params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            price: z.ZodObject<{
+                amount: z.ZodString;
+                currency: z.ZodString;
+                at: z.ZodISODateTime;
+                as_of: z.ZodISODateTime;
+            }, z.core.$strict>;
+            price_id: z.ZodOptional<z.ZodString>;
+            test: z.ZodBoolean;
+            status: z.ZodEnum<{
+                delivered: "delivered";
+                in_progress: "in_progress";
+                rejected: "rejected";
+                payment_unresolved: "payment_unresolved";
+                declined: "declined";
+                expired: "expired";
+                cancelled: "cancelled";
+                refund_due: "refund_due";
+                refunded: "refunded";
+                delivered_unpaid: "delivered_unpaid";
+            }>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    order_list_query: z.ZodObject<{
+        open: z.ZodOptional<z.ZodEnum<{
+            true: "true";
+            false: "false";
+        }>>;
+    }, z.core.$strict>;
+    order_status: z.ZodEnum<{
+        delivered: "delivered";
+        in_progress: "in_progress";
+        rejected: "rejected";
+        payment_unresolved: "payment_unresolved";
+        declined: "declined";
+        expired: "expired";
+        cancelled: "cancelled";
+        refund_due: "refund_due";
+        refunded: "refunded";
+        delivered_unpaid: "delivered_unpaid";
+    }>;
+    order_with_status: z.ZodObject<{
+        id: z.ZodString;
+        merchant_item_id: z.ZodString;
+        params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        price: z.ZodObject<{
+            amount: z.ZodString;
+            currency: z.ZodString;
+            at: z.ZodISODateTime;
+            as_of: z.ZodISODateTime;
+        }, z.core.$strict>;
+        price_id: z.ZodOptional<z.ZodString>;
+        test: z.ZodBoolean;
+        status: z.ZodEnum<{
+            delivered: "delivered";
+            in_progress: "in_progress";
+            rejected: "rejected";
+            payment_unresolved: "payment_unresolved";
+            declined: "declined";
+            expired: "expired";
+            cancelled: "cancelled";
+            refund_due: "refund_due";
+            refunded: "refunded";
+            delivered_unpaid: "delivered_unpaid";
+        }>;
+    }, z.core.$strict>;
+    param_name: z.ZodString;
+    param_spec: z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            integer: "integer";
+        }>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    param_type: z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        integer: "integer";
+    }>;
+    payout_wallet: z.ZodObject<{
+        payout_wallet: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    payout_wallet_request: z.ZodObject<{
+        payout_wallet: z.ZodPipe<z.ZodString, z.ZodString>;
+    }, z.core.$strict>;
+    price_check: z.ZodUnion<readonly [z.ZodLiteral<"handler">, z.ZodObject<{
+        url: z.ZodURL;
+    }, z.core.$strict>]>;
+    problem: z.ZodObject<{
+        path: z.ZodArray<z.ZodString>;
+        code: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strict>;
+    public_card: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        price: z.ZodObject<{
+            amount: z.ZodString;
+            currency: z.ZodString;
+        }, z.core.$strict>;
+        as_of: z.ZodISODateTime;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                integer: "integer";
+            }>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        result: z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                integer: "integer";
+            }>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        price_checked_at_purchase: z.ZodBoolean;
+        fulfillment: z.ZodLiteral<"sync">;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        price: z.ZodObject<{
+            amount: z.ZodString;
+            currency: z.ZodString;
+        }, z.core.$strict>;
+        as_of: z.ZodISODateTime;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                integer: "integer";
+            }>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        result: z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                integer: "integer";
+            }>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        price_checked_at_purchase: z.ZodBoolean;
+        fulfillment: z.ZodLiteral<"async">;
+        fulfill_deadline_seconds: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        price: z.ZodObject<{
+            amount: z.ZodString;
+            currency: z.ZodString;
+        }, z.core.$strict>;
+        as_of: z.ZodISODateTime;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                integer: "integer";
+            }>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        result: z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                integer: "integer";
+            }>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        price_checked_at_purchase: z.ZodBoolean;
+        fulfillment: z.ZodLiteral<"confirm">;
+        confirm_deadline_seconds: z.ZodOptional<z.ZodInt>;
+        fulfill_deadline_seconds: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>], "fulfillment">;
+    publish_result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        ok: z.ZodLiteral<true>;
+        id: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        ok: z.ZodLiteral<false>;
+        error: z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            retryable: z.ZodBoolean;
+            problems: z.ZodArray<z.ZodObject<{
+                path: z.ZodArray<z.ZodString>;
+                code: z.ZodString;
+                message: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "ok">;
+    purchase_request: z.ZodObject<{
+        params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strict>;
+    quote_answer_ack: z.ZodObject<{
+        used: z.ZodBoolean;
+    }, z.core.$strict>;
+    quote_purpose: z.ZodEnum<{
+        purchase: "purchase";
+        poll: "poll";
+    }>;
+    quote_request: z.ZodObject<{
+        merchant_item_id: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        price_id: z.ZodString;
+        purpose: z.ZodEnum<{
+            purchase: "purchase";
+            poll: "poll";
+        }>;
+        expires_at: z.ZodISODateTime;
+    }, z.core.$strict>;
+    quote_response: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        available: z.ZodLiteral<true>;
+        price: z.ZodObject<{
+            amount: z.ZodString;
+            currency: z.ZodString;
+        }, z.core.$strict>;
+        as_of: z.ZodISODateTime;
+    }, z.core.$strict>, z.ZodObject<{
+        available: z.ZodLiteral<false>;
+        as_of: z.ZodISODateTime;
+    }, z.core.$strict>], "available">;
+    receipt: z.ZodObject<{
+        id: z.ZodString;
+        order_id: z.ZodString;
+        item_id: z.ZodString;
+        price: z.ZodObject<{
+            amount: z.ZodString;
+            currency: z.ZodString;
+            at: z.ZodISODateTime;
+            as_of: z.ZodISODateTime;
+        }, z.core.$strict>;
+        price_id: z.ZodOptional<z.ZodString>;
+        paid_at: z.ZodISODateTime;
+        outcome: z.ZodEnum<{
+            delivered: "delivered";
+            in_progress: "in_progress";
+            refund_due: "refund_due";
+            refunded: "refunded";
+        }>;
+        test: z.ZodBoolean;
+    }, z.core.$strict>;
+    receipt_list: z.ZodObject<{
+        receipts: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            order_id: z.ZodString;
+            item_id: z.ZodString;
+            price: z.ZodObject<{
+                amount: z.ZodString;
+                currency: z.ZodString;
+                at: z.ZodISODateTime;
+                as_of: z.ZodISODateTime;
+            }, z.core.$strict>;
+            price_id: z.ZodOptional<z.ZodString>;
+            paid_at: z.ZodISODateTime;
+            outcome: z.ZodEnum<{
+                delivered: "delivered";
+                in_progress: "in_progress";
+                refund_due: "refund_due";
+                refunded: "refunded";
+            }>;
+            test: z.ZodBoolean;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    receipt_outcome: z.ZodEnum<{
+        delivered: "delivered";
+        in_progress: "in_progress";
+        refund_due: "refund_due";
+        refunded: "refunded";
+    }>;
+    registered_merchant: z.ZodObject<{
+        merchant_id: z.ZodString;
+        secret: z.ZodString;
+    }, z.core.$strict>;
+    registration_request: z.ZodObject<{
+        invitation: z.ZodString;
+    }, z.core.$strict>;
+    refund_due_reason: z.ZodEnum<{
+        refused: "refused";
+        deadline_passed: "deadline_passed";
+        merchant_left: "merchant_left";
+    }>;
+    refusal: z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strict>;
+    refusal_code: z.ZodString;
+    sale_price: z.ZodObject<{
+        amount: z.ZodString;
+        currency: z.ZodString;
+        at: z.ZodISODateTime;
+        as_of: z.ZodISODateTime;
+    }, z.core.$strict>;
+    seller_name: z.ZodObject<{
+        seller_name: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    seller_name_request: z.ZodObject<{
+        seller_name: z.ZodPipe<z.ZodString, z.ZodString>;
+    }, z.core.$strict>;
+    selling_state: z.ZodEnum<{
+        open: "open";
+        paused: "paused";
+        departed: "departed";
+    }>;
+    service_name: z.ZodString;
+    tags: z.ZodArray<z.ZodString>;
+    timestamp: z.ZodISODateTime;
+    worker_envelope: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"order">;
+        id: z.ZodString;
+        sent_at: z.ZodISODateTime;
+        payload: z.ZodObject<{
+            id: z.ZodString;
+            merchant_item_id: z.ZodString;
+            params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            price: z.ZodObject<{
+                amount: z.ZodString;
+                currency: z.ZodString;
+                at: z.ZodISODateTime;
+                as_of: z.ZodISODateTime;
+            }, z.core.$strict>;
+            price_id: z.ZodOptional<z.ZodString>;
+            test: z.ZodBoolean;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"quote_request">;
+        id: z.ZodString;
+        sent_at: z.ZodISODateTime;
+        payload: z.ZodObject<{
+            merchant_item_id: z.ZodString;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            price_id: z.ZodString;
+            purpose: z.ZodEnum<{
+                purchase: "purchase";
+                poll: "poll";
+            }>;
+            expires_at: z.ZodISODateTime;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"order_event">;
+        id: z.ZodString;
+        sent_at: z.ZodISODateTime;
+        payload: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"order.refund_due">;
+            order_id: z.ZodString;
+            at: z.ZodISODateTime;
+            price: z.ZodObject<{
+                amount: z.ZodString;
+                currency: z.ZodString;
+            }, z.core.$strict>;
+            reason: z.ZodEnum<{
+                refused: "refused";
+                deadline_passed: "deadline_passed";
+                merchant_left: "merchant_left";
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"order.unpaid_after_confirmation">;
+            order_id: z.ZodString;
+            at: z.ZodISODateTime;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"order.payment_failed_after_delivery">;
+            order_id: z.ZodString;
+            at: z.ZodISODateTime;
+        }, z.core.$strict>], "type">;
+    }, z.core.$strict>], "kind">;
+    worker_poll_request: z.ZodObject<{
+        wait_seconds: z.ZodOptional<z.ZodInt>;
+        max: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>;
+    worker_poll_response: z.ZodObject<{
+        contract_version: z.ZodString;
+        envelopes: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"order">;
+            id: z.ZodString;
+            sent_at: z.ZodISODateTime;
+            payload: z.ZodObject<{
+                id: z.ZodString;
+                merchant_item_id: z.ZodString;
+                params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                price: z.ZodObject<{
+                    amount: z.ZodString;
+                    currency: z.ZodString;
+                    at: z.ZodISODateTime;
+                    as_of: z.ZodISODateTime;
+                }, z.core.$strict>;
+                price_id: z.ZodOptional<z.ZodString>;
+                test: z.ZodBoolean;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"quote_request">;
+            id: z.ZodString;
+            sent_at: z.ZodISODateTime;
+            payload: z.ZodObject<{
+                merchant_item_id: z.ZodString;
+                params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                price_id: z.ZodString;
+                purpose: z.ZodEnum<{
+                    purchase: "purchase";
+                    poll: "poll";
+                }>;
+                expires_at: z.ZodISODateTime;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"order_event">;
+            id: z.ZodString;
+            sent_at: z.ZodISODateTime;
+            payload: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"order.refund_due">;
+                order_id: z.ZodString;
+                at: z.ZodISODateTime;
+                price: z.ZodObject<{
+                    amount: z.ZodString;
+                    currency: z.ZodString;
+                }, z.core.$strict>;
+                reason: z.ZodEnum<{
+                    refused: "refused";
+                    deadline_passed: "deadline_passed";
+                    merchant_left: "merchant_left";
+                }>;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"order.unpaid_after_confirmation">;
+                order_id: z.ZodString;
+                at: z.ZodISODateTime;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"order.payment_failed_after_delivery">;
+                order_id: z.ZodString;
+                at: z.ZodISODateTime;
+            }, z.core.$strict>], "type">;
+        }, z.core.$strict>], "kind">>;
+    }, z.core.$strict>;
+}>;
+/** The name of one schema in the registry. */
+export type SchemaName = keyof typeof schemas;
+/** One JSON Schema document, as zod renders it. */
+export type JsonSchemaDocument = z.core.JSONSchema.BaseSchema;
+/** The identifier a rendered document carries, so a reader knows what it holds. */
+export declare const jsonSchemaIdOf: (name: SchemaName) => string;
+/**
+ * The whole contract as JSON Schema, one document per registry entry.
+ *
+ * A function rather than a constant: the conversion costs something, and a
+ * consumer who only needs to validate a card in TypeScript should not pay for
+ * a description of everything else at import time.
+ *
+ * What the documents carry and what they do not is worth saying plainly,
+ * because the difference is invisible from the outside. Structure crosses
+ * intact — fields, types, which are required, whether unknown keys are
+ * allowed, enumerations, patterns, the branches of a union. Rules that look at
+ * more than one field at a time do not: JSON Schema cannot say "this field
+ * only when that one has this value", and zod drops such a rule without a
+ * word. Every schema that has one says so in its own `description`, which does
+ * cross, so a reader of the document is told what it is not checking rather
+ * than left to assume it checks everything.
+ *
+ * Each document is stamped with the contract version it came from.
+ */
+export declare const toJsonSchemas: () => Record<SchemaName, JsonSchemaDocument>;