@cimplify/sdk 0.44.14 → 0.44.18

package/dist/server.d.mts

@@ -1,5 +1,5 @@
-import { C as CimplifyClient } from './client-CkGlXZRd.mjs';
-export { aN as Result } from './client-CkGlXZRd.mjs';
+import { C as CimplifyClient } from './client-Dh-bHyhU.mjs';
+export { aN as Result } from './client-Dh-bHyhU.mjs';
 export { am as Category, h as CimplifyError, ao as Collection, U as Product, a7 as ProductWithDetails } from './payment-DA1i5hhk.mjs';
 
 interface ServerClientOptions {

package/dist/server.d.ts

@@ -1,5 +1,5 @@
-import { C as CimplifyClient } from './client-lvLvB1_K.js';
-export { aN as Result } from './client-lvLvB1_K.js';
+import { C as CimplifyClient } from './client-D6ZisKco.js';
+export { aN as Result } from './client-D6ZisKco.js';
 export { am as Category, h as CimplifyError, ao as Collection, U as Product, a7 as ProductWithDetails } from './payment-DA1i5hhk.js';
 
 interface ServerClientOptions {

package/dist/server.js

@@ -1,8 +1,9 @@
 'use strict';
 
-var chunkOMAP327U_js = require('./chunk-OMAP327U.js');
-require('./chunk-BAWKQRIB.js');
-var chunkV2O5AO7I_js = require('./chunk-V2O5AO7I.js');
+var chunk3FS3ZDKX_js = require('./chunk-3FS3ZDKX.js');
+require('./chunk-HBRCVJL4.js');
+require('./chunk-BN2CXGMO.js');
+var chunkQBQCMQ4F_js = require('./chunk-QBQCMQ4F.js');
 var react = require('react');
 
 var DEFAULT_DEV_URL = "http://127.0.0.1:8787";
@@ -18,7 +19,7 @@ function readEnv(...keys) {
 var getServerClient = react.cache((opts = {}) => {
   const baseUrl = opts.apiUrl ?? readEnv("CIMPLIFY_API_URL", "NEXT_PUBLIC_CIMPLIFY_API_URL") ?? DEFAULT_DEV_URL;
   const publicKey = opts.secretKey ?? readEnv("CIMPLIFY_SECRET_KEY", "NEXT_PUBLIC_CIMPLIFY_PUBLIC_KEY") ?? "mock-dev";
-  const client = chunkOMAP327U_js.createCimplifyClient({
+  const client = chunk3FS3ZDKX_js.createCimplifyClient({
     baseUrl,
     publicKey,
     suppressPublicKeyWarning: true
@@ -93,7 +94,7 @@ async function revalidateByTag(tag) {
 
 Object.defineProperty(exports, "CimplifyError", {
   enumerable: true,
-  get: function () { return chunkV2O5AO7I_js.CimplifyError; }
+  get: function () { return chunkQBQCMQ4F_js.CimplifyError; }
 });
 exports.getServerClient = getServerClient;
 exports.revalidateBusiness = revalidateBusiness;

package/dist/server.mjs

@@ -1,6 +1,7 @@
-import { createCimplifyClient } from './chunk-3WD6U5RD.mjs';
-import './chunk-EZK2FXTM.mjs';
-export { CimplifyError } from './chunk-6TVQQYQ5.mjs';
+import { createCimplifyClient } from './chunk-5OK3YDZC.mjs';
+import './chunk-XZPO5GEM.mjs';
+import './chunk-NRT6PVW5.mjs';
+export { CimplifyError } from './chunk-XPXAZXF2.mjs';
 import { cache } from 'react';
 
 var DEFAULT_DEV_URL = "http://127.0.0.1:8787";

package/dist/testing/msw.d.mts

@@ -0,0 +1,17 @@
+import { A as AppHandle, C as CreateAppOptions } from '../server-CWpUlLOQ.mjs';
+import 'hono';
+
+interface MswHandlerSetup {
+    handlers: unknown[];
+    deps: AppHandle["deps"];
+    baseUrl: string;
+    reset: () => void;
+}
+
+interface MswAdapterOptions extends CreateAppOptions {
+    /** Override the base URL handlers register against. Default `http://localhost:8787`. */
+    baseUrl?: string;
+}
+declare function createMswHandlers(options?: MswAdapterOptions): Promise<MswHandlerSetup>;
+
+export { type MswAdapterOptions, createMswHandlers };

package/dist/testing/msw.d.ts

@@ -0,0 +1,17 @@
+import { A as AppHandle, C as CreateAppOptions } from '../server-CWpUlLOQ.js';
+import 'hono';
+
+interface MswHandlerSetup {
+    handlers: unknown[];
+    deps: AppHandle["deps"];
+    baseUrl: string;
+    reset: () => void;
+}
+
+interface MswAdapterOptions extends CreateAppOptions {
+    /** Override the base URL handlers register against. Default `http://localhost:8787`. */
+    baseUrl?: string;
+}
+declare function createMswHandlers(options?: MswAdapterOptions): Promise<MswHandlerSetup>;
+
+export { type MswAdapterOptions, createMswHandlers };

package/dist/testing/msw.js

@@ -0,0 +1,42 @@
+'use strict';
+
+var chunkCCSONJCO_js = require('../chunk-CCSONJCO.js');
+require('../chunk-QBQCMQ4F.js');
+
+// src/mock/msw.ts
+async function createMswHandlers(options = {}) {
+  const baseUrl = options.baseUrl ?? "http://localhost:8787";
+  const handle = chunkCCSONJCO_js.createMockApp(options);
+  const msw = await import('msw').catch(() => {
+    throw new Error("msw is required to use @cimplify/sdk/mock/msw \u2014 install it as a peer dependency");
+  });
+  const proxy = async ({ request }) => {
+    const url = new URL(request.url);
+    const path = url.pathname + url.search;
+    const init = {
+      method: request.method,
+      headers: request.headers,
+      body: ["GET", "HEAD"].includes(request.method) ? void 0 : await request.text()
+    };
+    return handle.request(path, init);
+  };
+  const apiBase = baseUrl.replace(/\/$/, "");
+  const handlers = [
+    msw.http.all(`${apiBase}/api/v1/*`, proxy),
+    msw.http.all(`${apiBase}/_mock/*`, proxy),
+    msw.http.get(`${apiBase}/healthz`, proxy)
+  ];
+  return {
+    handlers,
+    deps: handle.deps,
+    baseUrl,
+    reset: () => handle.deps.resetAll()
+  };
+}
+
+// src/testing/msw-adapter.ts
+async function createMswHandlers2(options = {}) {
+  return createMswHandlers(options);
+}
+
+exports.createMswHandlers = createMswHandlers2;

package/dist/testing/msw.mjs

@@ -0,0 +1,40 @@
+import { createMockApp } from '../chunk-MJBSVUHO.mjs';
+import '../chunk-XPXAZXF2.mjs';
+
+// src/mock/msw.ts
+async function createMswHandlers(options = {}) {
+  const baseUrl = options.baseUrl ?? "http://localhost:8787";
+  const handle = createMockApp(options);
+  const msw = await import('msw').catch(() => {
+    throw new Error("msw is required to use @cimplify/sdk/mock/msw \u2014 install it as a peer dependency");
+  });
+  const proxy = async ({ request }) => {
+    const url = new URL(request.url);
+    const path = url.pathname + url.search;
+    const init = {
+      method: request.method,
+      headers: request.headers,
+      body: ["GET", "HEAD"].includes(request.method) ? void 0 : await request.text()
+    };
+    return handle.request(path, init);
+  };
+  const apiBase = baseUrl.replace(/\/$/, "");
+  const handlers = [
+    msw.http.all(`${apiBase}/api/v1/*`, proxy),
+    msw.http.all(`${apiBase}/_mock/*`, proxy),
+    msw.http.get(`${apiBase}/healthz`, proxy)
+  ];
+  return {
+    handlers,
+    deps: handle.deps,
+    baseUrl,
+    reset: () => handle.deps.resetAll()
+  };
+}
+
+// src/testing/msw-adapter.ts
+async function createMswHandlers2(options = {}) {
+  return createMswHandlers(options);
+}
+
+export { createMswHandlers2 as createMswHandlers };

package/dist/testing/suite.d.mts

@@ -0,0 +1,85 @@
+import { TestAPI } from 'vitest';
+import { T as TestClientHandle } from '../client-B_Ei3ENB.mjs';
+import { C as CreateAppOptions } from '../server-CWpUlLOQ.mjs';
+import '../client-Dh-bHyhU.mjs';
+import '../payment-DA1i5hhk.mjs';
+import 'hono';
+
+/**
+ * Pre-baked test suites for scaffolded storefronts.
+ *
+ * Templates' `__tests__/*.test.ts` files are now ~5 lines each — they
+ * import their `brand` and call `createBrandSuite` / `createCartFlowSuite`
+ * / `createContractSuite`. One bug fix in this file → every template
+ * picks it up on `bun update @cimplify/sdk`.
+ *
+ *   // __tests__/brand.test.ts in any template:
+ *   import { createBrandSuite } from "@cimplify/sdk/testing/suite";
+ *   import { brand } from "../lib/brand";
+ *   createBrandSuite({ brand });
+ *
+ *   // __tests__/cart-flow.test.ts:
+ *   import { createCartFlowSuite } from "@cimplify/sdk/testing/suite";
+ *   import { brand } from "../lib/brand";
+ *   createCartFlowSuite({ seed: brand.mock.seed, businessId: brand.mock.businessId });
+ *
+ *   // __tests__/contract.test.ts:
+ *   import { createContractSuite } from "@cimplify/sdk/testing/suite";
+ *   import { brand } from "../lib/brand";
+ *   createContractSuite({ seed: brand.mock.seed });
+ */
+
+/**
+ * Brand sanity suite. Catches: missing required fields, placeholder
+ * strings shipped to prod, invalid email/url/locale/currency formats,
+ * mismatched seed/businessId pairing.
+ *
+ * Pass `extend` to append custom cases inside the same describe block:
+ *
+ *   createBrandSuite({
+ *     brand,
+ *     extend: (it) => {
+ *       it("uses our merchant's currency", () => {
+ *         expect(brand.currency).toBe("GHS");
+ *       });
+ *     },
+ *   });
+ */
+declare function createBrandSuite(opts: {
+    brand: unknown;
+    label?: string;
+    extend?: (it: TestAPI) => void;
+}): void;
+interface CartFlowOptions extends CreateAppOptions {
+    /** Expected business ID — asserts cart responses match the merchant. */
+    businessId?: string;
+    /** Override the describe() label. */
+    label?: string;
+    /** Append custom cases inside the same describe block. Receives a `TestClientHandle` getter. */
+    extend?: (ctx: {
+        getHandle: () => TestClientHandle;
+        it: TestAPI;
+    }) => void;
+}
+/**
+ * Cart flow suite. Boots the in-process mock, exercises add/dedupe/remove
+ * with shape assertions on every response. Catches: SDK ↔ mock contract
+ * drift, missing fields on cart items, add-to-cart not persisting,
+ * variant/payload silently dropped.
+ */
+declare function createCartFlowSuite(opts?: CartFlowOptions): void;
+interface ContractOptions extends CreateAppOptions {
+    label?: string;
+    extend?: (ctx: {
+        getHandle: () => TestClientHandle;
+        it: TestAPI;
+    }) => void;
+}
+/**
+ * Shape contract suite. Exercises the schemas against actual mock
+ * traffic. Catches: outbound payloads dropping required fields,
+ * inbound responses missing fields the storefront depends on.
+ */
+declare function createContractSuite(opts?: ContractOptions): void;
+
+export { createBrandSuite, createCartFlowSuite, createContractSuite };

package/dist/testing/suite.d.ts

@@ -0,0 +1,85 @@
+import { TestAPI } from 'vitest';
+import { T as TestClientHandle } from '../client-Bep2FooI.js';
+import { C as CreateAppOptions } from '../server-CWpUlLOQ.js';
+import '../client-D6ZisKco.js';
+import '../payment-DA1i5hhk.js';
+import 'hono';
+
+/**
+ * Pre-baked test suites for scaffolded storefronts.
+ *
+ * Templates' `__tests__/*.test.ts` files are now ~5 lines each — they
+ * import their `brand` and call `createBrandSuite` / `createCartFlowSuite`
+ * / `createContractSuite`. One bug fix in this file → every template
+ * picks it up on `bun update @cimplify/sdk`.
+ *
+ *   // __tests__/brand.test.ts in any template:
+ *   import { createBrandSuite } from "@cimplify/sdk/testing/suite";
+ *   import { brand } from "../lib/brand";
+ *   createBrandSuite({ brand });
+ *
+ *   // __tests__/cart-flow.test.ts:
+ *   import { createCartFlowSuite } from "@cimplify/sdk/testing/suite";
+ *   import { brand } from "../lib/brand";
+ *   createCartFlowSuite({ seed: brand.mock.seed, businessId: brand.mock.businessId });
+ *
+ *   // __tests__/contract.test.ts:
+ *   import { createContractSuite } from "@cimplify/sdk/testing/suite";
+ *   import { brand } from "../lib/brand";
+ *   createContractSuite({ seed: brand.mock.seed });
+ */
+
+/**
+ * Brand sanity suite. Catches: missing required fields, placeholder
+ * strings shipped to prod, invalid email/url/locale/currency formats,
+ * mismatched seed/businessId pairing.
+ *
+ * Pass `extend` to append custom cases inside the same describe block:
+ *
+ *   createBrandSuite({
+ *     brand,
+ *     extend: (it) => {
+ *       it("uses our merchant's currency", () => {
+ *         expect(brand.currency).toBe("GHS");
+ *       });
+ *     },
+ *   });
+ */
+declare function createBrandSuite(opts: {
+    brand: unknown;
+    label?: string;
+    extend?: (it: TestAPI) => void;
+}): void;
+interface CartFlowOptions extends CreateAppOptions {
+    /** Expected business ID — asserts cart responses match the merchant. */
+    businessId?: string;
+    /** Override the describe() label. */
+    label?: string;
+    /** Append custom cases inside the same describe block. Receives a `TestClientHandle` getter. */
+    extend?: (ctx: {
+        getHandle: () => TestClientHandle;
+        it: TestAPI;
+    }) => void;
+}
+/**
+ * Cart flow suite. Boots the in-process mock, exercises add/dedupe/remove
+ * with shape assertions on every response. Catches: SDK ↔ mock contract
+ * drift, missing fields on cart items, add-to-cart not persisting,
+ * variant/payload silently dropped.
+ */
+declare function createCartFlowSuite(opts?: CartFlowOptions): void;
+interface ContractOptions extends CreateAppOptions {
+    label?: string;
+    extend?: (ctx: {
+        getHandle: () => TestClientHandle;
+        it: TestAPI;
+    }) => void;
+}
+/**
+ * Shape contract suite. Exercises the schemas against actual mock
+ * traffic. Catches: outbound payloads dropping required fields,
+ * inbound responses missing fields the storefront depends on.
+ */
+declare function createContractSuite(opts?: ContractOptions): void;
+
+export { createBrandSuite, createCartFlowSuite, createContractSuite };

package/dist/testing/suite.js

@@ -0,0 +1,174 @@
+'use strict';
+
+var chunk53J2WE4S_js = require('../chunk-53J2WE4S.js');
+require('../chunk-3FS3ZDKX.js');
+require('../chunk-HBRCVJL4.js');
+require('../chunk-BN2CXGMO.js');
+require('../chunk-CCSONJCO.js');
+require('../chunk-QBQCMQ4F.js');
+var vitest = require('vitest');
+
+var PLACEHOLDER_PHRASES = [
+  "lorem ipsum",
+  "todo",
+  "fixme",
+  "placeholder",
+  "your business name",
+  "your store"
+];
+function createBrandSuite(opts) {
+  vitest.describe(opts.label ?? "brand schema", () => {
+    vitest.it("conforms to the Cimplify brand contract", () => {
+      vitest.expect(() => chunk53J2WE4S_js.assertBrand(opts.brand)).not.toThrow();
+    });
+    vitest.it("declares a known mock seed", () => {
+      const b = opts.brand;
+      vitest.expect(chunk53J2WE4S_js.SeedNameSchema.safeParse(b.mock?.seed).success).toBe(true);
+    });
+    vitest.it("has no placeholder copy left in", () => {
+      const flat = JSON.stringify(opts.brand).toLowerCase();
+      for (const phrase of PLACEHOLDER_PHRASES) {
+        vitest.expect(flat, `brand contains placeholder phrase "${phrase}"`).not.toContain(phrase);
+      }
+    });
+    vitest.it("uses the bus_ businessId convention", () => {
+      const b = opts.brand;
+      vitest.expect(b.mock?.businessId).toMatch(/^bus_/);
+    });
+    vitest.it("zod-parses cleanly", () => {
+      const result = chunk53J2WE4S_js.BrandSchema.safeParse(opts.brand);
+      if (!result.success) {
+        throw new Error(
+          "Brand schema violations:\n" + result.error.issues.map((i) => `  \u2022 brand.${i.path.join(".")}: ${i.message}`).join("\n")
+        );
+      }
+      vitest.expect(result.success).toBe(true);
+    });
+    opts.extend?.(vitest.it);
+  });
+}
+function createCartFlowSuite(opts = {}) {
+  vitest.describe(opts.label ?? "cart flow against in-process mock", () => {
+    let h;
+    vitest.beforeEach(() => {
+      h = chunk53J2WE4S_js.createTestClient(opts);
+    });
+    vitest.afterEach(() => h.dispose());
+    vitest.it("starts with an empty cart matching the canonical shape", async () => {
+      const res = await h.client.cart.get();
+      vitest.expect(res.ok).toBe(true);
+      if (!res.ok) return;
+      vitest.expect(() => chunk53J2WE4S_js.assertCart(res.value)).not.toThrow();
+      vitest.expect(res.value.items).toHaveLength(0);
+    });
+    vitest.it("adds the first product, persists it, and returns a shape-valid cart", async () => {
+      const { product, variantId } = await chunk53J2WE4S_js.fixtures.addFirstProduct(h.client);
+      vitest.expect(product.id).toBeTruthy();
+      const get = await h.client.cart.get();
+      vitest.expect(get.ok).toBe(true);
+      if (!get.ok) return;
+      vitest.expect(() => chunk53J2WE4S_js.assertCart(get.value)).not.toThrow();
+      vitest.expect(get.value.items).toHaveLength(1);
+      vitest.expect(get.value.items[0]?.item_id).toBe(product.id);
+      if (variantId) {
+        vitest.expect(get.value.items[0]?.variant_id).toBe(variantId);
+        const variantInfo = get.value.items[0]?.variant_info;
+        vitest.expect(variantInfo?.display_attributes).toBeDefined();
+      }
+      vitest.expect(parseFloat(String(get.value.pricing.subtotal))).toBeGreaterThan(0);
+    });
+    vitest.it("dedupes by line_key when adding the same product twice", async () => {
+      await chunk53J2WE4S_js.fixtures.addFirstProduct(h.client);
+      await chunk53J2WE4S_js.fixtures.addFirstProduct(h.client);
+      const res = await h.client.cart.get();
+      vitest.expect(res.ok).toBe(true);
+      if (!res.ok) return;
+      vitest.expect(res.value.items).toHaveLength(1);
+      vitest.expect(res.value.items[0]?.quantity).toBe(2);
+    });
+    vitest.it("removes items and zeroes the subtotal", async () => {
+      await chunk53J2WE4S_js.fixtures.addFirstProduct(h.client);
+      const before = await h.client.cart.get();
+      if (!before.ok) throw before.error;
+      const itemId = before.value.items[0]?.id;
+      vitest.expect(itemId).toBeTruthy();
+      const removed = await h.client.cart.removeItem(itemId);
+      vitest.expect(removed.ok).toBe(true);
+      const after = await h.client.cart.get();
+      if (!after.ok) throw after.error;
+      vitest.expect(after.value.items).toHaveLength(0);
+      vitest.expect(parseFloat(String(after.value.pricing.subtotal))).toBe(0);
+    });
+    if (opts.businessId) {
+      vitest.it("returns the brand's businessId on cart responses", async () => {
+        const res = await h.client.cart.get();
+        if (!res.ok) throw res.error;
+        vitest.expect(res.value.business_id).toBe(opts.businessId);
+      });
+    }
+    opts.extend?.({ getHandle: () => h, it: vitest.it });
+  });
+}
+function createContractSuite(opts = {}) {
+  vitest.describe(opts.label ?? "SDK \u2194 mock contract", () => {
+    let h;
+    vitest.beforeEach(() => {
+      h = chunk53J2WE4S_js.createTestClient(opts);
+    });
+    vitest.afterEach(() => h.dispose());
+    vitest.it("AddItemPayload schema accepts a minimal valid body", () => {
+      const result = chunk53J2WE4S_js.AddItemPayloadSchema.safeParse({ item_id: "prod_x", quantity: 1 });
+      vitest.expect(result.success).toBe(true);
+    });
+    vitest.it("AddItemPayload schema rejects negative quantity", () => {
+      const result = chunk53J2WE4S_js.AddItemPayloadSchema.safeParse({ item_id: "prod_x", quantity: -1 });
+      vitest.expect(result.success).toBe(false);
+    });
+    vitest.it("AddItemPayload schema rejects empty item_id", () => {
+      const result = chunk53J2WE4S_js.AddItemPayloadSchema.safeParse({ item_id: "", quantity: 1 });
+      vitest.expect(result.success).toBe(false);
+    });
+    vitest.it("Cart line items returned by the mock match CartItemSchema", async () => {
+      const { product } = await chunk53J2WE4S_js.fixtures.addFirstProduct(h.client);
+      const get = await h.client.cart.get();
+      if (!get.ok) throw get.error;
+      vitest.expect(get.value.items.length).toBeGreaterThan(0);
+      for (const item of get.value.items) {
+        const result = chunk53J2WE4S_js.CartItemSchema.safeParse(item);
+        if (!result.success) {
+          const issues = result.error.issues.map((i) => `  \u2022 ${i.path.join(".")}: ${i.message}`).join("\n");
+          throw new Error(`Cart item shape mismatch for ${product.name}:
+${issues}`);
+        }
+        vitest.expect(result.success).toBe(true);
+      }
+    });
+    vitest.it("CheckoutResponse from the mock includes bill_token", async () => {
+      await chunk53J2WE4S_js.fixtures.addFirstProduct(h.client);
+      const cartRes = await h.client.cart.get();
+      if (!cartRes.ok) throw cartRes.error;
+      const checkout = await h.client.checkout.process({
+        cart_id: cartRes.value.id,
+        customer: chunk53J2WE4S_js.fixtures.customer(),
+        order_type: "delivery",
+        payment_method: "mobile_money",
+        mobile_money_details: { phone_number: "+233244000000", provider: "mtn" }
+      });
+      vitest.expect(checkout.ok).toBe(true);
+      if (!checkout.ok) return;
+      const result = chunk53J2WE4S_js.CheckoutResponseSchema.safeParse(checkout.value);
+      if (!result.success) {
+        const issues = result.error.issues.map((i) => `  \u2022 ${i.path.join(".")}: ${i.message}`).join("\n");
+        throw new Error(`CheckoutResponse shape mismatch:
+${issues}`);
+      }
+      vitest.expect(checkout.value.bill_token).toBeTruthy();
+      vitest.expect(checkout.value.order_id).toBeTruthy();
+    });
+    opts.extend?.({ getHandle: () => h, it: vitest.it });
+  });
+}
+
+exports.createBrandSuite = createBrandSuite;
+exports.createCartFlowSuite = createCartFlowSuite;
+exports.createContractSuite = createContractSuite;