@cimplify/sdk 0.44.16 → 0.44.18

package/dist/testing.d.ts

@@ -1,15 +1,42 @@
 import { z } from 'zod';
-import { C as CimplifyClient } from './client-D6ZisKco.js';
-import { C as CreateAppOptions, A as AppHandle } from './server-CWpUlLOQ.js';
+import { $ZodType } from 'zod/v4/core';
+export { A as AddFirstProductOptions, a as AddFirstProductResult, P as ProductSummary, T as TestClientHandle, c as createTestClient, f as fixtures } from './client-Bep2FooI.js';
+import './client-D6ZisKco.js';
 import './payment-DA1i5hhk.js';
+import './server-CWpUlLOQ.js';
 import 'hono';
 
 /**
- * Schema version. Increment when making a breaking change to any
- * schema in this directory. Consumer tests can pin to a version
- * to detect drift between SDK upgrades.
+ * Cimplify schema registry. Every public schema in this directory is
+ * registered here with `id`, `description`, and `version` metadata.
+ *
+ *   import { cimplifyRegistry } from "@cimplify/sdk/testing";
+ *   const meta = cimplifyRegistry.get(CartSchema); // { id, description, version }
+ *
+ * Per-schema versions let consumers pin to a specific shape and detect
+ * drift when only one schema changes (vs a single global SCHEMA_VERSION
+ * which gives false positives on every release).
+ *
+ * The registry feeds `z.toJSONSchema()` so emitted JSON Schemas have
+ * proper `$id` / `description` / clean `$defs` for downstream tooling
+ * (OpenAPI, agent prompts, codegen).
+ */
+interface CimplifySchemaMeta {
+    id: string;
+    description: string;
+    /** Bump when the shape of THIS schema changes in a breaking way. */
+    version: string;
+}
+declare const cimplifyRegistry: z.core.$ZodRegistry<CimplifySchemaMeta, z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+/**
+ * Helper: register a schema with metadata and return it. Pattern is:
+ *
+ *   export const MoneySchema = registerSchema(
+ *     z.string().regex(...),
+ *     { id: "Money", description: "Decimal money string", version: "1.0.0" },
+ *   );
  */
-declare const SCHEMA_VERSION: "2026-05-07.1";
+declare function registerSchema<T extends $ZodType>(schema: T, meta: CimplifySchemaMeta): T;
 /**
  * Strict money — exactly two decimal places. Backend always serializes
  * decimals to 2dp; consumer code that produces "12.5" or "12.555" is wrong.
@@ -18,30 +45,16 @@ declare const SCHEMA_VERSION: "2026-05-07.1";
  * (rare; usually FX / tax-rate display), use `MoneyLooseSchema`.
  */
 declare const MoneySchema: z.ZodString;
-/**
- * Loose money — any decimal precision. Use for tax rates and FX rates
- * where precision varies. Prefer `MoneySchema` for all amounts.
- */
 declare const MoneyLooseSchema: z.ZodString;
-/** Strict ISO 8601 date-time. */
 declare const IsoDateTimeSchema: z.ZodISODateTime;
-/**
- * Permissive timestamp — accepts ISO 8601 OR any non-empty string.
- * Useful at boundaries where downstream systems serialize timestamps
- * inconsistently. Prefer `IsoDateTimeSchema` for new code.
- */
 declare const TimestampSchema: z.ZodUnion<readonly [z.ZodISODateTime, z.ZodString]>;
-/** ISO 4217 currency code (3 letters). */
 declare const CurrencyCodeSchema: z.ZodString;
-/** ISO 3166-1 alpha-2 country code. */
 declare const CountryCodeSchema: z.ZodString;
-/** BCP-47-ish locale (e.g. "en", "en_GH", "fr_FR"). */
 declare const LocaleSchema: z.ZodString;
-/** E.164-ish phone — digits with optional leading `+`. */
 declare const PhoneE164Schema: z.ZodString;
 declare const SeedNameSchema: z.ZodEnum<{
-    empty: "empty";
     default: "default";
+    empty: "empty";
     "reesa-storefront": "reesa-storefront";
     restaurant: "restaurant";
     retail: "retail";
@@ -57,11 +70,11 @@ declare const ProductTypeSchema: z.ZodEnum<{
     composite: "composite";
 }>;
 declare const LineTypeSchema: z.ZodEnum<{
-    simple: "simple";
     service: "service";
     digital: "digital";
     bundle: "bundle";
     composite: "composite";
+    simple: "simple";
 }>;
 declare const ServiceStatusSchema: z.ZodEnum<{
     pending: "pending";
@@ -69,29 +82,52 @@ declare const ServiceStatusSchema: z.ZodEnum<{
     completed: "completed";
     cancelled: "cancelled";
 }>;
-/**
- * Build a typed assertion from any zod schema. Single source of the
- * "parse → format issues → throw helpful Error" pattern.
- *
- *   const assertCart = makeAssertion(CartSchema, "cart");
- *   assertCart(value);  // throws with field paths if invalid
- */
-declare function makeAssertion<T>(schema: z.ZodType<T>, label: string): (value: unknown) => asserts value is T;
 /**
  * Structured error thrown by every `assertX` helper. Agents can catch
  * this and surface the issue list directly (e.g. in a toast or log).
+ *
+ * Compatible with RFC 7807 Problem Details: `toJSON()` produces a
+ * `{ type, title, status, detail, errors }` envelope where `errors`
+ * is the typed zod issue array.
  */
 declare class SchemaViolationError extends Error {
-    readonly issues: Array<{
+    readonly label: string;
+    readonly issues: ReadonlyArray<{
         path: string[];
         message: string;
+        code?: string;
     }>;
     readonly name = "SchemaViolationError";
-    constructor(message: string, issues: Array<{
+    constructor(message: string, label: string, issues: ReadonlyArray<{
         path: string[];
         message: string;
+        code?: string;
     }>);
+    toJSON(): {
+        type: string;
+        title: string;
+        status: number;
+        detail: string;
+        errors: ReadonlyArray<{
+            path: string[];
+            message: string;
+            code?: string;
+        }>;
+    };
 }
+/**
+ * Build a typed assertion from any zod schema. Single source of the
+ * "parse → format → throw" pattern. Powered by zod 4's built-in
+ * `z.prettifyError` for human-readable output.
+ *
+ *   const assertCart = makeAssertion(CartSchema, "cart");
+ *   assertCart(value); // throws SchemaViolationError with structured issues
+ *
+ * Generic over `$ZodType` (zod/v4/core), so both classic Zod schemas
+ * and Zod Mini schemas work — required for library authors per the
+ * official Zod 4 guidance.
+ */
+declare function makeAssertion<T extends $ZodType>(schema: T, label: string): (value: unknown) => asserts value is z.infer<T>;
 
 /**
  * Brand schema — the contract for `lib/brand.ts` in every storefront.
@@ -331,8 +367,8 @@ declare const BrandSchema: z.ZodObject<{
     }, z.core.$strip>;
     mock: z.ZodObject<{
         seed: z.ZodEnum<{
-            empty: "empty";
             default: "default";
+            empty: "empty";
             "reesa-storefront": "reesa-storefront";
             restaurant: "restaurant";
             retail: "retail";
@@ -496,7 +532,7 @@ declare const assertBrand: (value: unknown) => asserts value is {
         summary: string;
     };
     mock: {
-        seed: "empty" | "default" | "reesa-storefront" | "restaurant" | "retail" | "services" | "grocery" | "fashion";
+        seed: "default" | "empty" | "reesa-storefront" | "restaurant" | "retail" | "services" | "grocery" | "fashion";
         businessId: string;
     };
     trustItems?: {
@@ -684,11 +720,11 @@ declare const CartItemSchema: z.ZodObject<{
     quantity: z.ZodNumber;
     line_key: z.ZodString;
     line_type: z.ZodEnum<{
-        simple: "simple";
         service: "service";
         digital: "digital";
         bundle: "bundle";
         composite: "composite";
+        simple: "simple";
     }>;
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
@@ -781,15 +817,16 @@ declare const CartItemSchema: z.ZodObject<{
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     created_at: z.ZodUnion<readonly [z.ZodISODateTime, z.ZodString]>;
     updated_at: z.ZodUnion<readonly [z.ZodISODateTime, z.ZodString]>;
-}, z.core.$strip>;
+}, z.core.$loose>;
 type CartItem = z.infer<typeof CartItemSchema>;
 declare const assertCartItem: (value: unknown) => asserts value is {
+    [x: string]: unknown;
     id: string;
     cart_id: string;
     item_id: string;
     quantity: number;
     line_key: string;
-    line_type: "simple" | "service" | "digital" | "bundle" | "composite";
+    line_type: "service" | "digital" | "bundle" | "composite" | "simple";
     name: string;
     is_available: boolean;
     base_price: string;
@@ -899,11 +936,11 @@ declare const CartSchema: z.ZodObject<{
         quantity: z.ZodNumber;
         line_key: z.ZodString;
         line_type: z.ZodEnum<{
-            simple: "simple";
             service: "service";
             digital: "digital";
             bundle: "bundle";
             composite: "composite";
+            simple: "simple";
         }>;
         name: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
@@ -996,7 +1033,7 @@ declare const CartSchema: z.ZodObject<{
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         created_at: z.ZodUnion<readonly [z.ZodISODateTime, z.ZodString]>;
         updated_at: z.ZodUnion<readonly [z.ZodISODateTime, z.ZodString]>;
-    }, z.core.$strip>>;
+    }, z.core.$loose>>;
     pricing: z.ZodObject<{
         subtotal: z.ZodString;
         total_discounts: z.ZodString;
@@ -1019,18 +1056,20 @@ declare const CartSchema: z.ZodObject<{
     status: z.ZodString;
     source: z.ZodString;
     channel: z.ZodString;
-}, z.core.$strip>;
+}, z.core.$loose>;
 type Cart = z.infer<typeof CartSchema>;
 declare const assertCart: (value: unknown) => asserts value is {
+    [x: string]: unknown;
     id: string;
     business_id: string;
     items: {
+        [x: string]: unknown;
         id: string;
         cart_id: string;
         item_id: string;
         quantity: number;
         line_key: string;
-        line_type: "simple" | "service" | "digital" | "bundle" | "composite";
+        line_type: "service" | "digital" | "bundle" | "composite" | "simple";
         name: string;
         is_available: boolean;
         base_price: string;
@@ -1203,10 +1242,10 @@ declare const assertCheckoutBody: (value: unknown) => asserts value is {
 };
 declare const AuthorizationTypeSchema: z.ZodEnum<{
     phone: "phone";
+    address: "address";
     otp: "otp";
     pin: "pin";
     birthday: "birthday";
-    address: "address";
 }>;
 declare const NextActionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"none">;
@@ -1226,10 +1265,10 @@ declare const CheckoutResponseSchema: z.ZodObject<{
     requires_authorization: z.ZodBoolean;
     authorization_type: z.ZodOptional<z.ZodEnum<{
         phone: "phone";
+        address: "address";
         otp: "otp";
         pin: "pin";
         birthday: "birthday";
-        address: "address";
     }>>;
     next_action: z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"none">;
@@ -1247,9 +1286,10 @@ declare const CheckoutResponseSchema: z.ZodObject<{
     bill_token: z.ZodOptional<z.ZodString>;
     client_secret: z.ZodOptional<z.ZodString>;
     public_key: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
+}, z.core.$loose>;
 type CheckoutResponse = z.infer<typeof CheckoutResponseSchema>;
 declare const assertCheckoutResponse: (value: unknown) => asserts value is {
+    [x: string]: unknown;
     order_id: string;
     order_number: string;
     payment_status: string;
@@ -1265,7 +1305,7 @@ declare const assertCheckoutResponse: (value: unknown) => asserts value is {
         display_text?: string | undefined;
     };
     payment_reference?: string | undefined;
-    authorization_type?: "phone" | "otp" | "pin" | "birthday" | "address" | undefined;
+    authorization_type?: "phone" | "address" | "otp" | "pin" | "birthday" | undefined;
     provider?: string | undefined;
     authorization_url?: string | undefined;
     display_text?: string | undefined;
@@ -1275,85 +1315,571 @@ declare const assertCheckoutResponse: (value: unknown) => asserts value is {
 };
 
 /**
- * Test client + fixtures.
+ * JSON Schema export — feeds OpenAPI generators, agent prompts,
+ * codegen tooling, and CI contract-snapshot diffs.
  *
- * Spins up an in-process Hono mock and a typed SDK client wired to it
- * via the SDK's first-class `fetch` injection — no global mutation,
- * no port, no MSW. Tests in the same module run in parallel safely.
+ * Uses zod 4's built-in `z.toJSONSchema()` with our registry so output
+ * has stable `$id`, `description`, and `$defs` for clean dereferencing.
  *
- *   import { createTestClient, fixtures } from "@cimplify/sdk/testing";
+ *   import { exportJsonSchemas } from "@cimplify/sdk/testing";
+ *   const schemas = exportJsonSchemas();
+ *   // → { Brand: { $id: "Brand", ...}, Cart: {...}, ... }
  *
- *   const handle = createTestClient({ seed: "fashion" });
- *   try {
- *     const item = await fixtures.addFirstProduct(handle.client);
- *     expect(item.product.name).toBeTruthy();
- *   } finally {
- *     handle.dispose();
- *   }
+ * For a single schema:
+ *
+ *   import { z } from "zod";
+ *   import { CartSchema } from "@cimplify/sdk/testing";
+ *   const cartJsonSchema = z.toJSONSchema(CartSchema);
  */
 
-interface TestClientHandle {
-    /** Typed SDK client routed to the in-process mock. */
-    client: CimplifyClient;
-    /** Direct access to the mock — registry, deps, request shortcut. */
-    mock: AppHandle;
-    /** Reset all in-memory state (cart, orders, sessions). Token persists. */
-    reset: () => void;
-    /** Drop all state + session. Always safe to call multiple times. */
-    dispose: () => void;
-}
+declare const PUBLIC_SCHEMAS: {
+    readonly Brand: z.ZodObject<{
+        name: z.ZodString;
+        shortName: z.ZodString;
+        microTag: z.ZodString;
+        description: z.ZodString;
+        schemaType: z.ZodString;
+        currency: z.ZodString;
+        locale: z.ZodString;
+        contact: z.ZodObject<{
+            email: z.ZodString;
+            phone: z.ZodString;
+            phoneTel: z.ZodString;
+            streetAddress: z.ZodString;
+            city: z.ZodString;
+            countryCode: z.ZodString;
+            hours: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        socials: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            href: z.ZodString;
+            icon: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        header: z.ZodObject<{
+            nav: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                href: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        hero: z.ZodObject<{
+            badge: z.ZodOptional<z.ZodString>;
+            title: z.ZodString;
+            subtitle: z.ZodString;
+            primaryCta: z.ZodOptional<z.ZodObject<{
+                label: z.ZodString;
+                href: z.ZodString;
+            }, z.core.$strip>>;
+            secondaryCta: z.ZodOptional<z.ZodObject<{
+                label: z.ZodString;
+                href: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        trustItems: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            body: z.ZodString;
+        }, z.core.$strip>>>;
+        brandStrip: z.ZodOptional<z.ZodObject<{
+            headline: z.ZodString;
+            logos: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+        promo: z.ZodOptional<z.ZodObject<{
+            eyebrow: z.ZodOptional<z.ZodString>;
+            title: z.ZodString;
+            cta: z.ZodObject<{
+                label: z.ZodString;
+                href: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        terms: z.ZodObject<{
+            eyebrow: z.ZodString;
+            title: z.ZodString;
+            lastUpdated: z.ZodString;
+            sections: z.ZodArray<z.ZodObject<{
+                heading: z.ZodString;
+                body: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    intro: z.ZodString;
+                    bullets: z.ZodArray<z.ZodString>;
+                }, z.core.$strip>]>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        privacy: z.ZodObject<{
+            eyebrow: z.ZodString;
+            title: z.ZodString;
+            lastUpdated: z.ZodString;
+            sections: z.ZodArray<z.ZodObject<{
+                heading: z.ZodString;
+                body: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    intro: z.ZodString;
+                    bullets: z.ZodArray<z.ZodString>;
+                }, z.core.$strip>]>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        shipping: z.ZodObject<{
+            eyebrow: z.ZodString;
+            title: z.ZodString;
+            lastUpdated: z.ZodString;
+            sections: z.ZodArray<z.ZodObject<{
+                heading: z.ZodString;
+                body: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    intro: z.ZodString;
+                    bullets: z.ZodArray<z.ZodString>;
+                }, z.core.$strip>]>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        returns: z.ZodObject<{
+            eyebrow: z.ZodString;
+            title: z.ZodString;
+            lastUpdated: z.ZodString;
+            sections: z.ZodArray<z.ZodObject<{
+                heading: z.ZodString;
+                body: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    intro: z.ZodString;
+                    bullets: z.ZodArray<z.ZodString>;
+                }, z.core.$strip>]>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        accessibility: z.ZodObject<{
+            eyebrow: z.ZodString;
+            title: z.ZodString;
+            lastUpdated: z.ZodString;
+            sections: z.ZodArray<z.ZodObject<{
+                heading: z.ZodString;
+                body: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    intro: z.ZodString;
+                    bullets: z.ZodArray<z.ZodString>;
+                }, z.core.$strip>]>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        newsletter: z.ZodObject<{
+            eyebrow: z.ZodOptional<z.ZodString>;
+            title: z.ZodString;
+            body: z.ZodString;
+        }, z.core.$strip>;
+        about: z.ZodObject<{
+            eyebrow: z.ZodOptional<z.ZodString>;
+            title: z.ZodString;
+            body: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strip>;
+        faq: z.ZodObject<{
+            eyebrow: z.ZodOptional<z.ZodString>;
+            title: z.ZodString;
+            sections: z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                items: z.ZodArray<z.ZodObject<{
+                    q: z.ZodString;
+                    a: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        account: z.ZodObject<{
+            eyebrow: z.ZodOptional<z.ZodString>;
+            title: z.ZodString;
+            signin: z.ZodOptional<z.ZodObject<{
+                eyebrow: z.ZodOptional<z.ZodString>;
+                title: z.ZodString;
+            }, z.core.$strip>>;
+            signup: z.ZodOptional<z.ZodObject<{
+                eyebrow: z.ZodOptional<z.ZodString>;
+                title: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        contactPage: z.ZodObject<{
+            eyebrow: z.ZodOptional<z.ZodString>;
+            title: z.ZodString;
+            body: z.ZodString;
+        }, z.core.$strip>;
+        trackOrder: z.ZodObject<{
+            eyebrow: z.ZodOptional<z.ZodString>;
+            title: z.ZodString;
+            body: z.ZodString;
+        }, z.core.$strip>;
+        footer: z.ZodObject<{
+            sitemap: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+            poweredBy: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        llms: z.ZodObject<{
+            summary: z.ZodString;
+        }, z.core.$strip>;
+        mock: z.ZodObject<{
+            seed: z.ZodEnum<{
+                default: "default";
+                empty: "empty";
+                "reesa-storefront": "reesa-storefront";
+                restaurant: "restaurant";
+                retail: "retail";
+                services: "services";
+                grocery: "grocery";
+                fashion: "fashion";
+            }>;
+            businessId: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    readonly AddItemPayload: z.ZodObject<{
+        item_id: z.ZodString;
+        quantity: z.ZodNumber;
+        variant_id: z.ZodOptional<z.ZodString>;
+        quote_id: z.ZodOptional<z.ZodString>;
+        add_on_options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        bundle_selections: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            component_id: z.ZodString;
+            variant_id: z.ZodOptional<z.ZodString>;
+            quantity: z.ZodNumber;
+            scheduled_start: z.ZodOptional<z.ZodString>;
+            scheduled_end: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        composite_selections: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            component_id: z.ZodOptional<z.ZodString>;
+            source_product_id: z.ZodOptional<z.ZodString>;
+            source_stock_id: z.ZodOptional<z.ZodString>;
+            source_type: z.ZodOptional<z.ZodEnum<{
+                product: "product";
+                stock: "stock";
+                add_on: "add_on";
+                standalone: "standalone";
+            }>>;
+            quantity: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        scheduled_start: z.ZodOptional<z.ZodString>;
+        scheduled_end: z.ZodOptional<z.ZodString>;
+        staff_id: z.ZodOptional<z.ZodString>;
+        resource_id: z.ZodOptional<z.ZodString>;
+        special_instructions: z.ZodOptional<z.ZodString>;
+        customer_inputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            field_id: z.ZodString;
+            field_name: z.ZodOptional<z.ZodString>;
+            field_type: z.ZodOptional<z.ZodString>;
+            value: z.ZodUnknown;
+        }, z.core.$strip>>>;
+        billing_plan_id: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    readonly Cart: z.ZodObject<{
+        id: z.ZodString;
+        business_id: z.ZodString;
+        items: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            cart_id: z.ZodString;
+            item_id: z.ZodString;
+            quantity: z.ZodNumber;
+            line_key: z.ZodString;
+            line_type: z.ZodEnum<{
+                service: "service";
+                digital: "digital";
+                bundle: "bundle";
+                composite: "composite";
+                simple: "simple";
+            }>;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            image_url: z.ZodOptional<z.ZodString>;
+            category_id: z.ZodOptional<z.ZodString>;
+            category_name: z.ZodOptional<z.ZodString>;
+            is_available: z.ZodBoolean;
+            variant_id: z.ZodOptional<z.ZodString>;
+            variant_name: z.ZodOptional<z.ZodString>;
+            variant_info: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                sku: z.ZodOptional<z.ZodString>;
+                price_adjustment: z.ZodString;
+                display_attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    axis_id: z.ZodString;
+                    axis_name: z.ZodString;
+                    value_id: z.ZodString;
+                    value_name: z.ZodString;
+                }, z.core.$strip>>>;
+                images: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+            variant_details: z.ZodOptional<z.ZodObject<{
+                variant_id: z.ZodString;
+                sku: z.ZodOptional<z.ZodString>;
+                properties: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, z.core.$strip>>;
+            base_price: z.ZodString;
+            add_ons_price: z.ZodString;
+            total_price: z.ZodString;
+            item_discount_amount: z.ZodString;
+            price_info: z.ZodObject<{
+                base_price: z.ZodString;
+                final_price: z.ZodString;
+                markup_percentage: z.ZodString;
+                markup_amount: z.ZodString;
+                markup_discount_percentage: z.ZodString;
+                markup_discount_amount: z.ZodString;
+            }, z.core.$strip>;
+            add_on_option_ids: z.ZodArray<z.ZodString>;
+            add_on_ids: z.ZodArray<z.ZodString>;
+            add_on_details: z.ZodObject<{
+                selected_options: z.ZodArray<z.ZodUnknown>;
+                total_add_on_price: z.ZodString;
+                add_ons: z.ZodArray<z.ZodUnknown>;
+            }, z.core.$strip>;
+            add_on_options: z.ZodArray<z.ZodUnknown>;
+            add_ons: z.ZodArray<z.ZodUnknown>;
+            scheduled_start: z.ZodOptional<z.ZodString>;
+            scheduled_end: z.ZodOptional<z.ZodString>;
+            staff_id: z.ZodOptional<z.ZodString>;
+            resource_id: z.ZodOptional<z.ZodString>;
+            service_status: z.ZodOptional<z.ZodEnum<{
+                pending: "pending";
+                confirmed: "confirmed";
+                completed: "completed";
+                cancelled: "cancelled";
+            }>>;
+            confirmation_code: z.ZodOptional<z.ZodString>;
+            special_instructions: z.ZodOptional<z.ZodString>;
+            customer_inputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                field_id: z.ZodString;
+                field_name: z.ZodOptional<z.ZodString>;
+                field_type: z.ZodOptional<z.ZodString>;
+                value: z.ZodUnknown;
+            }, z.core.$strip>>>;
+            bundle_selections: z.ZodOptional<z.ZodUnknown>;
+            bundle_resolved: z.ZodOptional<z.ZodObject<{
+                bundle_id: z.ZodString;
+                selections: z.ZodArray<z.ZodUnknown>;
+            }, z.core.$loose>>;
+            composite_selections: z.ZodOptional<z.ZodUnknown>;
+            composite_resolved: z.ZodOptional<z.ZodObject<{
+                composite_id: z.ZodString;
+                selections: z.ZodArray<z.ZodUnknown>;
+                breakdown: z.ZodOptional<z.ZodObject<{
+                    base_price: z.ZodString;
+                    components_total: z.ZodString;
+                    final_price: z.ZodString;
+                    tier_applied: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$loose>>;
+            billing_plan_id: z.ZodOptional<z.ZodString>;
+            applied_discount_ids: z.ZodArray<z.ZodString>;
+            discount_details: z.ZodOptional<z.ZodObject<{
+                applied_count: z.ZodNumber;
+                total_amount: z.ZodString;
+                discount_ids: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            created_at: z.ZodUnion<readonly [z.ZodISODateTime, z.ZodString]>;
+            updated_at: z.ZodUnion<readonly [z.ZodISODateTime, z.ZodString]>;
+        }, z.core.$loose>>;
+        pricing: z.ZodObject<{
+            subtotal: z.ZodString;
+            total_discounts: z.ZodString;
+            tax_amount: z.ZodString;
+            service_charge: z.ZodString;
+            total_price: z.ZodString;
+            currency: z.ZodString;
+            tax_rate: z.ZodOptional<z.ZodString>;
+            service_charge_rate: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        customer_info: z.ZodObject<{
+            name: z.ZodString;
+            email: z.ZodOptional<z.ZodString>;
+            phone: z.ZodOptional<z.ZodString>;
+            address: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        created_at: z.ZodUnion<readonly [z.ZodISODateTime, z.ZodString]>;
+        updated_at: z.ZodUnion<readonly [z.ZodISODateTime, z.ZodString]>;
+        expires_at: z.ZodUnion<readonly [z.ZodISODateTime, z.ZodString]>;
+        status: z.ZodString;
+        source: z.ZodString;
+        channel: z.ZodString;
+    }, z.core.$loose>;
+    readonly CartItem: z.ZodObject<{
+        id: z.ZodString;
+        cart_id: z.ZodString;
+        item_id: z.ZodString;
+        quantity: z.ZodNumber;
+        line_key: z.ZodString;
+        line_type: z.ZodEnum<{
+            service: "service";
+            digital: "digital";
+            bundle: "bundle";
+            composite: "composite";
+            simple: "simple";
+        }>;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        image_url: z.ZodOptional<z.ZodString>;
+        category_id: z.ZodOptional<z.ZodString>;
+        category_name: z.ZodOptional<z.ZodString>;
+        is_available: z.ZodBoolean;
+        variant_id: z.ZodOptional<z.ZodString>;
+        variant_name: z.ZodOptional<z.ZodString>;
+        variant_info: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            sku: z.ZodOptional<z.ZodString>;
+            price_adjustment: z.ZodString;
+            display_attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                axis_id: z.ZodString;
+                axis_name: z.ZodString;
+                value_id: z.ZodString;
+                value_name: z.ZodString;
+            }, z.core.$strip>>>;
+            images: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        variant_details: z.ZodOptional<z.ZodObject<{
+            variant_id: z.ZodString;
+            sku: z.ZodOptional<z.ZodString>;
+            properties: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strip>>;
+        base_price: z.ZodString;
+        add_ons_price: z.ZodString;
+        total_price: z.ZodString;
+        item_discount_amount: z.ZodString;
+        price_info: z.ZodObject<{
+            base_price: z.ZodString;
+            final_price: z.ZodString;
+            markup_percentage: z.ZodString;
+            markup_amount: z.ZodString;
+            markup_discount_percentage: z.ZodString;
+            markup_discount_amount: z.ZodString;
+        }, z.core.$strip>;
+        add_on_option_ids: z.ZodArray<z.ZodString>;
+        add_on_ids: z.ZodArray<z.ZodString>;
+        add_on_details: z.ZodObject<{
+            selected_options: z.ZodArray<z.ZodUnknown>;
+            total_add_on_price: z.ZodString;
+            add_ons: z.ZodArray<z.ZodUnknown>;
+        }, z.core.$strip>;
+        add_on_options: z.ZodArray<z.ZodUnknown>;
+        add_ons: z.ZodArray<z.ZodUnknown>;
+        scheduled_start: z.ZodOptional<z.ZodString>;
+        scheduled_end: z.ZodOptional<z.ZodString>;
+        staff_id: z.ZodOptional<z.ZodString>;
+        resource_id: z.ZodOptional<z.ZodString>;
+        service_status: z.ZodOptional<z.ZodEnum<{
+            pending: "pending";
+            confirmed: "confirmed";
+            completed: "completed";
+            cancelled: "cancelled";
+        }>>;
+        confirmation_code: z.ZodOptional<z.ZodString>;
+        special_instructions: z.ZodOptional<z.ZodString>;
+        customer_inputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            field_id: z.ZodString;
+            field_name: z.ZodOptional<z.ZodString>;
+            field_type: z.ZodOptional<z.ZodString>;
+            value: z.ZodUnknown;
+        }, z.core.$strip>>>;
+        bundle_selections: z.ZodOptional<z.ZodUnknown>;
+        bundle_resolved: z.ZodOptional<z.ZodObject<{
+            bundle_id: z.ZodString;
+            selections: z.ZodArray<z.ZodUnknown>;
+        }, z.core.$loose>>;
+        composite_selections: z.ZodOptional<z.ZodUnknown>;
+        composite_resolved: z.ZodOptional<z.ZodObject<{
+            composite_id: z.ZodString;
+            selections: z.ZodArray<z.ZodUnknown>;
+            breakdown: z.ZodOptional<z.ZodObject<{
+                base_price: z.ZodString;
+                components_total: z.ZodString;
+                final_price: z.ZodString;
+                tier_applied: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$loose>>;
+        billing_plan_id: z.ZodOptional<z.ZodString>;
+        applied_discount_ids: z.ZodArray<z.ZodString>;
+        discount_details: z.ZodOptional<z.ZodObject<{
+            applied_count: z.ZodNumber;
+            total_amount: z.ZodString;
+            discount_ids: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        created_at: z.ZodUnion<readonly [z.ZodISODateTime, z.ZodString]>;
+        updated_at: z.ZodUnion<readonly [z.ZodISODateTime, z.ZodString]>;
+    }, z.core.$loose>;
+    readonly CartPricing: z.ZodObject<{
+        subtotal: z.ZodString;
+        total_discounts: z.ZodString;
+        tax_amount: z.ZodString;
+        service_charge: z.ZodString;
+        total_price: z.ZodString;
+        currency: z.ZodString;
+        tax_rate: z.ZodOptional<z.ZodString>;
+        service_charge_rate: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly CheckoutBody: z.ZodObject<{
+        cart_id: z.ZodString;
+        location_id: z.ZodOptional<z.ZodString>;
+        customer: z.ZodObject<{
+            name: z.ZodString;
+            email: z.ZodString;
+            phone: z.ZodString;
+            notes: z.ZodOptional<z.ZodString>;
+            save_details: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+        order_type: z.ZodString;
+        address_info: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        payment_method: z.ZodString;
+        mobile_money_details: z.ZodOptional<z.ZodObject<{
+            phone_number: z.ZodString;
+            provider: z.ZodString;
+        }, z.core.$strip>>;
+        special_instructions: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        pay_currency: z.ZodOptional<z.ZodString>;
+        fx_quote_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly CheckoutResponse: z.ZodObject<{
+        order_id: z.ZodString;
+        order_number: z.ZodString;
+        payment_status: z.ZodString;
+        payment_reference: z.ZodOptional<z.ZodString>;
+        requires_authorization: z.ZodBoolean;
+        authorization_type: z.ZodOptional<z.ZodEnum<{
+            phone: "phone";
+            address: "address";
+            otp: "otp";
+            pin: "pin";
+            birthday: "birthday";
+        }>>;
+        next_action: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"redirect">;
+            authorization_url: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"authorization">;
+            authorization_type: z.ZodString;
+            display_text: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "type">;
+        provider: z.ZodOptional<z.ZodString>;
+        authorization_url: z.ZodOptional<z.ZodString>;
+        display_text: z.ZodOptional<z.ZodString>;
+        bill_token: z.ZodOptional<z.ZodString>;
+        client_secret: z.ZodOptional<z.ZodString>;
+        public_key: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    readonly VariantInfo: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        sku: z.ZodOptional<z.ZodString>;
+        price_adjustment: z.ZodString;
+        display_attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            axis_id: z.ZodString;
+            axis_name: z.ZodString;
+            value_id: z.ZodString;
+            value_name: z.ZodString;
+        }, z.core.$strip>>>;
+        images: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+};
+type PublicSchemaName = keyof typeof PUBLIC_SCHEMAS;
 /**
- * Create an in-process mock + a typed SDK client wired to it.
- *
- * Each call gets its OWN session token — tests in the same module
- * run safely in parallel because there's no shared global state.
+ * Export all public schemas as JSON Schema (Draft 2020-12). Handy for
+ * a CI contract-snapshot — diff `schemas.json` against the Rust
+ * backend's emitted `openapi.json` to catch drift at PR time.
  */
-declare function createTestClient(options?: CreateAppOptions): TestClientHandle;
-interface ProductSummary {
-    id: string;
-    name: string;
-    slug: string;
-    type?: string;
-}
-interface AddFirstProductOptions {
-    /** Pick a specific product by slug instead of "first". */
-    slug?: string;
-    /** Auto-pick the first available variant if the product has variants. Default true. */
-    withVariant?: boolean;
-}
-interface AddFirstProductResult {
-    product: ProductSummary;
-    variantId?: string;
-}
+declare function exportJsonSchemas(): Record<PublicSchemaName, Record<string, unknown>>;
 /**
- * Pre-baked fixture functions for common test setup. Use these to keep
- * tests focused on the assertion you care about, not on plumbing.
+ * Read every schema currently in the cimplifyRegistry along with its
+ * metadata. Useful for tooling that wants to discover available
+ * schemas dynamically (e.g. an agent prompt generator).
  */
-declare const fixtures: {
-    /**
-     * Add the first available product (or a named one) to the cart.
-     * Picks the first variant if the product has variants.
-     */
-    addFirstProduct(client: CimplifyClient, opts?: AddFirstProductOptions): Promise<AddFirstProductResult>;
-    /** A minimal valid customer object for checkout. */
-    customer(overrides?: Partial<{
-        name: string;
-        email: string;
-        phone: string;
-    }>): {
-        name: string;
-        email: string;
-        phone: string;
-    };
-    /**
-     * Run the full guest auth flow (request OTP → verify) and return
-     * the new session token. The mock's permissive auth mode echoes
-     * the code in `request_otp`, so we don't need to read it.
-     */
-    authenticate(client: CimplifyClient, contact?: string, code?: string): Promise<{
-        token: string;
-        customerId: string;
-    }>;
-};
+declare function listRegisteredSchemas(): Array<{
+    schema: z.ZodType;
+    meta: CimplifySchemaMeta;
+}>;
 
-export { type AddFirstProductOptions, type AddFirstProductResult, type AddItemPayload, AddItemPayloadSchema, AddOnDetailsSchema, AuthorizationTypeSchema, type Brand, BrandContactSchema, BrandFaqSchema, BrandHeroSchema, BrandNavLinkSchema, BrandPolicyPageSchema, BrandPolicySectionSchema, BrandSchema, BrandSocialSchema, BundleResolvedSchema, BundleSelectionInputSchema, type Cart, type CartItem, CartItemSchema, CartPricingSchema, CartSchema, type CheckoutBody, CheckoutBodySchema, CheckoutCustomerSchema, type CheckoutResponse, CheckoutResponseSchema, ChosenPriceSchema, CompositeResolvedSchema, CompositeSelectionInputSchema, CountryCodeSchema, CurrencyCodeSchema, CustomerInputValueSchema, DiscountDetailsSchema, IsoDateTimeSchema, LineTypeSchema, LocaleSchema, MoneyLooseSchema, MoneySchema, NextActionSchema, PhoneE164Schema, type ProductSummary, ProductTypeSchema, SCHEMA_VERSION, SchemaViolationError, SeedNameSchema, ServiceStatusSchema, type TestClientHandle, TimestampSchema, VariantDetailsSchema, VariantDisplayAttributeSchema, VariantInfoSchema, assertAddItemPayload, assertBrand, assertCart, assertCartItem, assertCheckoutBody, assertCheckoutResponse, createTestClient, fixtures, makeAssertion };
+export { type AddItemPayload, AddItemPayloadSchema, AddOnDetailsSchema, AuthorizationTypeSchema, type Brand, BrandContactSchema, BrandFaqSchema, BrandHeroSchema, BrandNavLinkSchema, BrandPolicyPageSchema, BrandPolicySectionSchema, BrandSchema, BrandSocialSchema, BundleResolvedSchema, BundleSelectionInputSchema, type Cart, type CartItem, CartItemSchema, CartPricingSchema, CartSchema, type CheckoutBody, CheckoutBodySchema, CheckoutCustomerSchema, type CheckoutResponse, CheckoutResponseSchema, ChosenPriceSchema, type CimplifySchemaMeta, CompositeResolvedSchema, CompositeSelectionInputSchema, CountryCodeSchema, CurrencyCodeSchema, CustomerInputValueSchema, DiscountDetailsSchema, IsoDateTimeSchema, LineTypeSchema, LocaleSchema, MoneyLooseSchema, MoneySchema, NextActionSchema, PhoneE164Schema, ProductTypeSchema, type PublicSchemaName, SchemaViolationError, SeedNameSchema, ServiceStatusSchema, TimestampSchema, VariantDetailsSchema, VariantDisplayAttributeSchema, VariantInfoSchema, assertAddItemPayload, assertBrand, assertCart, assertCartItem, assertCheckoutBody, assertCheckoutResponse, cimplifyRegistry, exportJsonSchemas, listRegisteredSchemas, makeAssertion, registerSchema };