@codespar/sdk 0.9.0 → 0.10.1

package/dist/__tests__/forward-mocks.test.js

@@ -0,0 +1,134 @@
+/**
+ * Tests for the createSession body builder's `mocks` forwarding.
+ *
+ * Asserts:
+ *   - Wire-neutrality: a cs.create without `mocks` produces a body
+ *     byte-identical to today's shape (R18).
+ *   - Forwarded shape: a cs.create with `mocks` includes the field
+ *     verbatim — no SDK-side rewriting of canonical names.
+ *   - Empty `mocks: {}` is forwarded (the backend accepts; strict-
+ *     mode R3a activates only on non-empty maps).
+ *   - Double-underscore key form reaches the backend unrewritten
+ *     so the canonical-form rejection surfaces at the right layer.
+ */
+import { describe, it, expect, vi, afterEach } from "vitest";
+import { CodeSpar } from "../index.js";
+function mockSessionResponse() {
+    return {
+        ok: true,
+        status: 201,
+        text: async () => "",
+        json: async () => ({
+            id: "ses_demo",
+            org_id: "org_demo",
+            user_id: "user_demo",
+            servers: ["asaas"],
+            status: "active",
+            created_at: new Date().toISOString(),
+            closed_at: null,
+        }),
+    };
+}
+describe("createSession body builder forwards mocks", () => {
+    const originalFetch = globalThis.fetch;
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+    });
+    it("omits mocks key from the wire body when undefined (R18 wire-neutral)", async () => {
+        const fetchMock = vi
+            .fn()
+            .mockResolvedValueOnce(mockSessionResponse());
+        globalThis.fetch = fetchMock;
+        const cs = new CodeSpar({
+            apiKey: "csk_live_test",
+            baseUrl: "https://api.example.com",
+        });
+        await cs.create("user_demo", { servers: ["asaas"] });
+        const init = fetchMock.mock
+            .calls[0][1];
+        const body = JSON.parse(init.body);
+        expect("mocks" in body).toBe(false);
+        expect(body).toEqual({ servers: ["asaas"], user_id: "user_demo" });
+    });
+    it("forwards mocks verbatim when present", async () => {
+        const fetchMock = vi
+            .fn()
+            .mockResolvedValueOnce(mockSessionResponse());
+        globalThis.fetch = fetchMock;
+        const cs = new CodeSpar({
+            apiKey: "csk_live_test",
+            baseUrl: "https://api.example.com",
+        });
+        await cs.create("user_demo", {
+            servers: ["asaas"],
+            mocks: {
+                "asaas/create_payment": { id: "pay_test_42", status: "PENDING" },
+            },
+        });
+        const init = fetchMock.mock
+            .calls[0][1];
+        const body = JSON.parse(init.body);
+        expect(body.mocks).toEqual({
+            "asaas/create_payment": { id: "pay_test_42", status: "PENDING" },
+        });
+    });
+    it("accepts and forwards an empty mocks={} body", async () => {
+        const fetchMock = vi
+            .fn()
+            .mockResolvedValueOnce(mockSessionResponse());
+        globalThis.fetch = fetchMock;
+        const cs = new CodeSpar({
+            apiKey: "csk_live_test",
+            baseUrl: "https://api.example.com",
+        });
+        await cs.create("user_demo", { servers: ["asaas"], mocks: {} });
+        const init = fetchMock.mock
+            .calls[0][1];
+        const body = JSON.parse(init.body);
+        expect(body.mocks).toEqual({});
+    });
+    it("does NOT rewrite double-underscore keys — they reach the backend verbatim", async () => {
+        const fetchMock = vi
+            .fn()
+            .mockResolvedValueOnce(mockSessionResponse());
+        globalThis.fetch = fetchMock;
+        const cs = new CodeSpar({
+            apiKey: "csk_live_test",
+            baseUrl: "https://api.example.com",
+        });
+        await cs.create("user_demo", {
+            servers: ["asaas"],
+            mocks: { asaas__create_payment: { id: "pay_test_42" } },
+        });
+        const init = fetchMock.mock
+            .calls[0][1];
+        const body = JSON.parse(init.body);
+        const mocks = body.mocks;
+        expect(Object.keys(mocks)).toEqual(["asaas__create_payment"]);
+    });
+    it("matches the canonical fixture byte-for-byte when the same input lands", async () => {
+        // Same canonical body used by the Python parity test.
+        const fetchMock = vi
+            .fn()
+            .mockResolvedValueOnce(mockSessionResponse());
+        globalThis.fetch = fetchMock;
+        const cs = new CodeSpar({
+            apiKey: "csk_live_test",
+            baseUrl: "https://api.example.com",
+        });
+        await cs.create("user_demo", {
+            servers: ["asaas"],
+            mocks: {
+                "asaas/create_payment": { id: "pay_test_42", status: "PENDING" },
+                "asaas/get_payment": [
+                    { id: "pay_test_42", status: "PENDING" },
+                    { id: "pay_test_42", status: "CONFIRMED" },
+                ],
+            },
+        });
+        const init = fetchMock.mock
+            .calls[0][1];
+        expect(init.body).toBe('{"servers":["asaas"],"user_id":"user_demo","mocks":{"asaas/create_payment":{"id":"pay_test_42","status":"PENDING"},"asaas/get_payment":[{"id":"pay_test_42","status":"PENDING"},{"id":"pay_test_42","status":"CONFIRMED"}]}}');
+    });
+});
+//# sourceMappingURL=forward-mocks.test.js.map

package/dist/__tests__/forward-mocks.test.js.map

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

package/dist/__tests__/mocks-wire-parity.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Wire-shape parity test for the test-mode mocks field.
+ *
+ * Asserts that the TypeScript SessionConfig type carries the optional
+ * `mocks` field with the right shape, and that the serialized form
+ * matches the canonical fixture used by the Python SDK's parallel
+ * test. Both languages serialize the same example to byte-identical
+ * JSON; any drift here is a wire-contract break.
+ *
+ * The canonical fixture lives at packages/python/tests/_fixtures/
+ * mocks_canonical.json — kept in sync by hand. Future contributors
+ * MUST update both files together when extending the example.
+ */
+export {};
+//# sourceMappingURL=mocks-wire-parity.test.d.ts.map

package/dist/__tests__/mocks-wire-parity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mocks-wire-parity.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/mocks-wire-parity.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/__tests__/mocks-wire-parity.test.js

@@ -0,0 +1,71 @@
+/**
+ * Wire-shape parity test for the test-mode mocks field.
+ *
+ * Asserts that the TypeScript SessionConfig type carries the optional
+ * `mocks` field with the right shape, and that the serialized form
+ * matches the canonical fixture used by the Python SDK's parallel
+ * test. Both languages serialize the same example to byte-identical
+ * JSON; any drift here is a wire-contract break.
+ *
+ * The canonical fixture lives at packages/python/tests/_fixtures/
+ * mocks_canonical.json — kept in sync by hand. Future contributors
+ * MUST update both files together when extending the example.
+ */
+import { describe, it, expect } from "vitest";
+const CANONICAL_BODY = {
+    servers: ["asaas"],
+    user_id: "user_demo",
+    mocks: {
+        "asaas/create_payment": { id: "pay_test_42", status: "PENDING" },
+        "asaas/get_payment": [
+            { id: "pay_test_42", status: "PENDING" },
+            { id: "pay_test_42", status: "CONFIRMED" },
+        ],
+    },
+};
+describe("MockObject + MockValue type aliases", () => {
+    it("accepts a plain dict as MockObject", () => {
+        const obj = { id: "pay_test_42", status: "PENDING" };
+        expect(obj.id).toBe("pay_test_42");
+    });
+    it("accepts a single MockObject as MockValue (static mock)", () => {
+        const v = { id: "pay_test_42", status: "PENDING" };
+        expect(v).toBeDefined();
+    });
+    it("accepts a MockObject array as MockValue (stateful mock)", () => {
+        const v = [
+            { id: "pay_test_42", status: "PENDING" },
+            { id: "pay_test_42", status: "CONFIRMED" },
+        ];
+        expect(Array.isArray(v)).toBe(true);
+    });
+});
+describe("CreateSessionOptions carries optional mocks field", () => {
+    it("accepts a SessionConfig with no mocks (wire-neutral)", () => {
+        const cfg = { servers: ["asaas"] };
+        expect(cfg.mocks).toBeUndefined();
+    });
+    it("accepts a SessionConfig with canonical mocks shape", () => {
+        const cfg = {
+            servers: ["asaas"],
+            mocks: {
+                "asaas/create_payment": { id: "pay_test_42", status: "PENDING" },
+                "asaas/get_payment": [
+                    { id: "pay_test_42", status: "PENDING" },
+                    { id: "pay_test_42", status: "CONFIRMED" },
+                ],
+            },
+        };
+        expect(cfg.mocks?.["asaas/create_payment"]).toBeDefined();
+    });
+});
+describe("Canonical body serializes to byte-identical JSON", () => {
+    it("matches the Python SDK fixture byte-for-byte", () => {
+        // The canonical body field order is preserved by the JSON.stringify
+        // contract used in createSession's body builder. If field ordering
+        // changes here, the Python side must change too.
+        const serialized = JSON.stringify(CANONICAL_BODY);
+        expect(serialized).toBe('{"servers":["asaas"],"user_id":"user_demo","mocks":{"asaas/create_payment":{"id":"pay_test_42","status":"PENDING"},"asaas/get_payment":[{"id":"pay_test_42","status":"PENDING"},{"id":"pay_test_42","status":"CONFIRMED"}]}}');
+    });
+});
+//# sourceMappingURL=mocks-wire-parity.test.js.map

package/dist/__tests__/mocks-wire-parity.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mocks-wire-parity.test.js","sourceRoot":"","sources":["../../src/__tests__/mocks-wire-parity.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAI9C,MAAM,cAAc,GAAG;IACrB,OAAO,EAAE,CAAC,OAAO,CAAC;IAClB,OAAO,EAAE,WAAW;IACpB,KAAK,EAAE;QACL,sBAAsB,EAAE,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE;QAChE,mBAAmB,EAAE;YACnB,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE;YACxC,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE;SAC3C;KACF;CACO,CAAC;AAEX,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,GAAG,GAAe,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QACjE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,GAAc,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC9D,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,GAAc;YACnB,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE;YACxC,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE;SAC3C,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,mDAAmD,EAAE,GAAG,EAAE;IACjE,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,GAAG,GAAkB,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,GAAG,GAAkB;YACzB,OAAO,EAAE,CAAC,OAAO,CAAC;YAClB,KAAK,EAAE;gBACL,sBAAsB,EAAE,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE;gBAChE,mBAAmB,EAAE;oBACnB,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE;oBACxC,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE;iBAC3C;aACF;SACF,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kDAAkD,EAAE,GAAG,EAAE;IAChE,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,oEAAoE;QACpE,mEAAmE;QACnE,iDAAiD;QACjD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAClD,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CACrB,8NAA8N,CAC/N,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/shop.test.d.ts

@@ -0,0 +1,17 @@
+/**
+ * codespar_shop typed facade tests.
+ *
+ * Covers the discriminated `ShopArgs`/`ShopResult` union: it gives a
+ * caller the action-correct result type without an untyped cast. A
+ * `ready_for_payment` status result exposes typed `pix_copia_e_cola` +
+ * `total_minor`; a `canceled` result exposes typed `error`. The facade also mirrors `charge()`: it dispatches
+ * `execute("codespar_shop", args)` and throws `shop failed: <error>` on
+ * `!success`.
+ *
+ * These drive the real `createSession` facade with a mocked `fetch`, so
+ * the shipped client surface is exercised end-to-end (not a test
+ * double); the wire dispatch (`tool` + `input`) is asserted on the
+ * mocked `/execute` call.
+ */
+export {};
+//# sourceMappingURL=shop.test.d.ts.map

package/dist/__tests__/shop.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shop.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/shop.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/dist/__tests__/shop.test.js

@@ -0,0 +1,213 @@
+/**
+ * codespar_shop typed facade tests.
+ *
+ * Covers the discriminated `ShopArgs`/`ShopResult` union: it gives a
+ * caller the action-correct result type without an untyped cast. A
+ * `ready_for_payment` status result exposes typed `pix_copia_e_cola` +
+ * `total_minor`; a `canceled` result exposes typed `error`. The facade also mirrors `charge()`: it dispatches
+ * `execute("codespar_shop", args)` and throws `shop failed: <error>` on
+ * `!success`.
+ *
+ * These drive the real `createSession` facade with a mocked `fetch`, so
+ * the shipped client surface is exercised end-to-end (not a test
+ * double); the wire dispatch (`tool` + `input`) is asserted on the
+ * mocked `/execute` call.
+ */
+import { describe, it, expect, vi, afterEach } from "vitest";
+import { createSession } from "../session.js";
+function envelope(over) {
+    return {
+        success: true,
+        data: null,
+        error: null,
+        duration: 1,
+        server: "_codespar",
+        tool: "codespar_shop",
+        ...over,
+    };
+}
+/**
+ * Build a REAL session (`createSession`) whose `/execute` route returns
+ * a caller-supplied envelope, so `shop()` exercises the shipped facade
+ * end-to-end — not a test double. `fetch` is mocked: the create POST
+ * returns a session, the execute POST returns the envelope.
+ */
+async function sessionReturning(over) {
+    const calls = [];
+    const env = envelope(over);
+    const fetchMock = vi.fn(async (url, init) => {
+        if (typeof url === "string" && url.endsWith("/execute")) {
+            const body = JSON.parse(init?.body ?? "{}");
+            calls.push({ toolName: body.tool, params: body.input });
+            return {
+                ok: true,
+                status: 200,
+                text: async () => "",
+                json: async () => env,
+            };
+        }
+        // create session
+        return {
+            ok: true,
+            status: 201,
+            text: async () => "",
+            json: async () => ({
+                id: "ses_shop",
+                org_id: "org_test",
+                user_id: "consumer_123",
+                servers: ["cobasi"],
+                status: "active",
+                created_at: new Date().toISOString(),
+                closed_at: null,
+            }),
+        };
+    });
+    globalThis.fetch = fetchMock;
+    const session = await createSession("consumer_123", { servers: ["cobasi"] }, { baseUrl: "https://api.example.com", apiKey: "csk_live_test" });
+    return { session, calls };
+}
+const originalFetch = globalThis.fetch;
+afterEach(() => {
+    globalThis.fetch = originalFetch;
+});
+describe("session.shop facade", () => {
+    it("dispatches execute('codespar_shop', args) and returns typed data", async () => {
+        const data = {
+            rail: "vtex",
+            products: [
+                {
+                    product_id: "p1",
+                    sku_id: "sku1",
+                    title: "Ração",
+                    price_minor: 1990,
+                    currency: "BRL",
+                    available: true,
+                    variants: [{ sku_id: "sku1", available: true }],
+                },
+            ],
+        };
+        const { session, calls } = await sessionReturning({ success: true, data });
+        const args = {
+            action: "search",
+            query: "ração para gato",
+            merchant: "cobasi",
+            limit: 10,
+        };
+        const result = await session.shop(args);
+        expect(calls).toHaveLength(1);
+        expect(calls[0].toolName).toBe("codespar_shop");
+        expect(calls[0].params).toEqual(args);
+        // discriminate on the search shape.
+        if ("products" in result) {
+            const search = result;
+            expect(search.rail).toBe("vtex");
+            expect(search.products[0].variants[0].sku_id).toBe("sku1");
+        }
+        else {
+            throw new Error("expected a search result");
+        }
+    });
+    it("throws 'shop failed: <error>' when the envelope is unsuccessful", async () => {
+        const { session } = await sessionReturning({
+            success: false,
+            error: "invalid_args",
+        });
+        await expect(session.shop({ action: "search", query: "x" })).rejects.toThrow("shop failed: invalid_args");
+    });
+    it("throws 'shop failed: unknown' when no error string is present", async () => {
+        const { session } = await sessionReturning({ success: false });
+        await expect(session.shop({ action: "checkout_status", checkout_session_id: "c1" })).rejects.toThrow("shop failed: unknown");
+    });
+    it("checkout returns an in_progress session result (async start)", async () => {
+        const data = {
+            checkout_session_id: "cks_1",
+            status: "in_progress",
+            message: "started",
+        };
+        const { session } = await sessionReturning({ success: true, data });
+        const result = await session.shop({
+            action: "checkout",
+            merchant: "cobasi",
+            items: [{ variant_id: "sku1", quantity: 1 }],
+            consumer_id: "consumer_123",
+        });
+        if ("products" in result) {
+            throw new Error("expected a checkout result, got search");
+        }
+        // Narrowed off the search variant; status is reachable + typed.
+        expect(result.status).toBe("in_progress");
+        expect(result.checkout_session_id).toBe("cks_1");
+    });
+    it("a ready_for_payment status exposes typed pix_copia_e_cola + total_minor", async () => {
+        const data = {
+            checkout_session_id: "cks_1",
+            status: "ready_for_payment",
+            rail: "vtex",
+            total_minor: 1990,
+            pix_copia_e_cola: "00020126...br.gov.bcb.pix",
+        };
+        const { session } = await sessionReturning({ success: true, data });
+        const result = await session.shop({
+            action: "checkout_status",
+            checkout_session_id: "cks_1",
+        });
+        if ("products" in result) {
+            throw new Error("expected a status result, got search");
+        }
+        // Narrowed off search; the payable Pix is typed, not unknown.
+        if (result.status === "ready_for_payment") {
+            const pix = result.pix_copia_e_cola;
+            const total = result.total_minor;
+            expect(pix).toContain("br.gov.bcb.pix");
+            expect(total).toBe(1990);
+        }
+        else {
+            throw new Error("expected ready_for_payment");
+        }
+    });
+    it("a canceled status exposes the typed error field", async () => {
+        const data = {
+            checkout_session_id: "cks_2",
+            status: "canceled",
+            error: "browser_worker_checkout_failed",
+        };
+        const { session } = await sessionReturning({ success: true, data });
+        const result = await session.shop({
+            action: "checkout_status",
+            checkout_session_id: "cks_2",
+        });
+        if ("products" in result) {
+            throw new Error("expected a status result, got search");
+        }
+        if (result.status === "canceled") {
+            const err = result.error;
+            expect(err).toBe("browser_worker_checkout_failed");
+        }
+        else {
+            throw new Error("expected canceled");
+        }
+    });
+});
+/**
+ * Compile-time discriminated-union assertions. These do not run
+ * assertions at runtime — they fail the build if the union stops
+ * narrowing correctly, which is the real guarantee the contract makes.
+ */
+describe("ShopResult type-level narrowing (compile-time)", () => {
+    it("narrows each variant by its discriminant without an unknown cast", () => {
+        const widen = (r) => {
+            if ("products" in r) {
+                // ShopSearchResult
+                return r.rail;
+            }
+            if (r.status === "in_progress" && !("rail" in r)) {
+                // ShopCheckoutResult — status is the literal "in_progress"
+                return r.checkout_session_id;
+            }
+            // ShopStatusResult
+            return r.pix_copia_e_cola ?? r.error ?? r.status;
+        };
+        expect(typeof widen).toBe("function");
+    });
+});
+//# sourceMappingURL=shop.test.js.map

package/dist/__tests__/shop.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shop.test.js","sourceRoot":"","sources":["../../src/__tests__/shop.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAU7D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAO9C,SAAS,QAAQ,CAAC,IAAyB;IACzC,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,CAAC;QACX,MAAM,EAAE,WAAW;QACnB,IAAI,EAAE,eAAe;QACrB,GAAG,IAAI;KACR,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,gBAAgB,CAAC,IAAyB;IAIvD,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,IAAwB,EAAE,EAAE;QACtE,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,IAAI,IAAI,CAGzC,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACxD,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,MAAM,EAAE,GAAG;gBACX,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;gBACpB,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,GAAG;aACtB,CAAC;QACJ,CAAC;QACD,iBAAiB;QACjB,OAAO;YACL,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;YACpB,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;gBACjB,EAAE,EAAE,UAAU;gBACd,MAAM,EAAE,UAAU;gBAClB,OAAO,EAAE,cAAc;gBACvB,OAAO,EAAE,CAAC,QAAQ,CAAC;gBACnB,MAAM,EAAE,QAAQ;gBAChB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACpC,SAAS,EAAE,IAAI;aAChB,CAAC;SACH,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,UAAU,CAAC,KAAK,GAAG,SAAoC,CAAC;IAExD,MAAM,OAAO,GAAG,MAAM,aAAa,CACjC,cAAc,EACd,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,EACvB,EAAE,OAAO,EAAE,yBAAyB,EAAE,MAAM,EAAE,eAAe,EAAE,CAChE,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC;AACvC,SAAS,CAAC,GAAG,EAAE;IACb,UAAU,CAAC,KAAK,GAAG,aAAa,CAAC;AACnC,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,IAAI,GAAqB;YAC7B,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE;gBACR;oBACE,UAAU,EAAE,IAAI;oBAChB,MAAM,EAAE,MAAM;oBACd,KAAK,EAAE,OAAO;oBACd,WAAW,EAAE,IAAI;oBACjB,QAAQ,EAAE,KAAK;oBACf,SAAS,EAAE,IAAI;oBACf,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;iBAChD;aACF;SACF,CAAC;QACF,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,gBAAgB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAE3E,MAAM,IAAI,GAAa;YACrB,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,iBAAiB;YACxB,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,EAAE;SACV,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAExC,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAEvC,oCAAoC;QACpC,IAAI,UAAU,IAAI,MAAM,EAAE,CAAC;YACzB,MAAM,MAAM,GAAqB,MAAM,CAAC;YACxC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACjC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/D,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,gBAAgB,CAAC;YACzC,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,cAAc;SACtB,CAAC,CAAC;QACH,MAAM,MAAM,CACV,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAC/C,CAAC,OAAO,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC7E,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,gBAAgB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/D,MAAM,MAAM,CACV,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,CACvE,CAAC,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,IAAI,GAAuB;YAC/B,mBAAmB,EAAE,OAAO;YAC5B,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE,SAAS;SACnB,CAAC;QACF,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,gBAAgB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YAChC,MAAM,EAAE,UAAU;YAClB,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YAC5C,WAAW,EAAE,cAAc;SAC5B,CAAC,CAAC;QAEH,IAAI,UAAU,IAAI,MAAM,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QACD,gEAAgE;QAChE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,KAAK,IAAI,EAAE;QACvF,MAAM,IAAI,GAAqB;YAC7B,mBAAmB,EAAE,OAAO;YAC5B,MAAM,EAAE,mBAAmB;YAC3B,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,IAAI;YACjB,gBAAgB,EAAE,2BAA2B;SAC9C,CAAC;QACF,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,gBAAgB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YAChC,MAAM,EAAE,iBAAiB;YACzB,mBAAmB,EAAE,OAAO;SAC7B,CAAC,CAAC;QAEH,IAAI,UAAU,IAAI,MAAM,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,8DAA8D;QAC9D,IAAI,MAAM,CAAC,MAAM,KAAK,mBAAmB,EAAE,CAAC;YAC1C,MAAM,GAAG,GAAuB,MAAM,CAAC,gBAAgB,CAAC;YACxD,MAAM,KAAK,GAAuB,MAAM,CAAC,WAAW,CAAC;YACrD,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;YACxC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,IAAI,GAAqB;YAC7B,mBAAmB,EAAE,OAAO;YAC5B,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,gCAAgC;SACxC,CAAC;QACF,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,gBAAgB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YAChC,MAAM,EAAE,iBAAiB;YACzB,mBAAmB,EAAE,OAAO;SAC7B,CAAC,CAAC;QAEH,IAAI,UAAU,IAAI,MAAM,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,MAAM,GAAG,GAAuB,MAAM,CAAC,KAAK,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH;;;;GAIG;AACH,QAAQ,CAAC,gDAAgD,EAAE,GAAG,EAAE;IAC9D,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,KAAK,GAAG,CAAC,CAAa,EAAU,EAAE;YACtC,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;gBACpB,mBAAmB;gBACnB,OAAO,CAAC,CAAC,IAAI,CAAC;YAChB,CAAC;YACD,IAAI,CAAC,CAAC,MAAM,KAAK,aAAa,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC;gBACjD,2DAA2D;gBAC3D,OAAO,CAAC,CAAC,mBAAmB,CAAC;YAC/B,CAAC;YACD,mBAAmB;YACnB,OAAO,CAAC,CAAC,gBAAgB,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC;QACnD,CAAC,CAAC;QACF,MAAM,CAAC,OAAO,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/testing.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=testing.test.d.ts.map

package/dist/__tests__/testing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/testing.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/testing.test.js

@@ -0,0 +1,133 @@
+import { describe, it, expect } from "vitest";
+import { fakeSession } from "../testing/index.js";
+describe("@codespar/sdk/testing — exported surface", () => {
+    it("exports fakeSession and the ToolResult type from a single import", () => {
+        expect(typeof fakeSession).toBe("function");
+        // ToolResult is a type-only re-export; the assertion below proves it
+        // is usable in a value position via a typed identity function.
+        const passthrough = (r) => r;
+        const sample = {
+            success: true,
+            data: {},
+            error: null,
+            duration: 0,
+            server: "",
+            tool: "x",
+        };
+        expect(passthrough(sample)).toBe(sample);
+    });
+});
+describe("fakeSession — strict mode (default)", () => {
+    it("throws verbatim 'fakeSession: no response registered for tool <name>' on miss", async () => {
+        const session = fakeSession();
+        await expect(session.execute("asaas/create_payment", { value: 100 })).rejects.toThrow("fakeSession: no response registered for tool asaas/create_payment");
+    });
+    it("error message is byte-identical to the contract string", async () => {
+        const session = fakeSession();
+        let captured = null;
+        try {
+            await session.execute("foo/bar", {});
+        }
+        catch (err) {
+            captured = err;
+        }
+        expect(captured).toBeInstanceOf(Error);
+        expect(captured.message).toBe("fakeSession: no response registered for tool foo/bar");
+    });
+});
+describe("fakeSession — registered responses", () => {
+    it("returns the static ToolResult registered for a tool name", async () => {
+        const session = fakeSession({
+            "asaas/create_customer": {
+                success: true,
+                data: { id: "cus_test_1", name: "Maria" },
+                error: null,
+                duration: 0,
+                server: "asaas",
+                tool: "asaas/create_customer",
+            },
+        });
+        const result = await session.execute("asaas/create_customer", { name: "Maria" });
+        expect(result.success).toBe(true);
+        expect(result.data).toEqual({ id: "cus_test_1", name: "Maria" });
+        expect(result.tool).toBe("asaas/create_customer");
+    });
+});
+describe("fakeSession — per-tool function variant", () => {
+    it("invokes a sync response function with the call's params and returns its result", async () => {
+        const session = fakeSession({
+            "asaas/create_customer": (input) => ({
+                success: true,
+                data: { echoed: input },
+                error: null,
+                duration: 0,
+                server: "asaas",
+                tool: "asaas/create_customer",
+            }),
+        });
+        const result = await session.execute("asaas/create_customer", { name: "Joana" });
+        expect(result.data).toEqual({ echoed: { name: "Joana" } });
+    });
+    it("awaits a Promise-returning response function", async () => {
+        const session = fakeSession({
+            "asaas/create_customer": async (input) => ({
+                success: true,
+                data: { async_echoed: input },
+                error: null,
+                duration: 0,
+                server: "asaas",
+                tool: "asaas/create_customer",
+            }),
+        });
+        const result = await session.execute("asaas/create_customer", { name: "Joana" });
+        expect(result.data).toEqual({ async_echoed: { name: "Joana" } });
+    });
+});
+describe("fakeSession — lenient mode", () => {
+    it("returns {success:true, data:{}} for unregistered tools when lenient: true", async () => {
+        const session = fakeSession({}, { lenient: true });
+        const result = await session.execute("asaas/create_payment", { value: 100 });
+        expect(result.success).toBe(true);
+        expect(result.data).toEqual({});
+        expect(result.error).toBeNull();
+        expect(result.tool).toBe("asaas/create_payment");
+    });
+    it("does not override a registered failure response in lenient mode", async () => {
+        const session = fakeSession({
+            "asaas/create_payment": {
+                success: false,
+                data: null,
+                error: "boom",
+                duration: 0,
+                server: "asaas",
+                tool: "asaas/create_payment",
+            },
+        }, { lenient: true });
+        const result = await session.execute("asaas/create_payment", { value: 100 });
+        expect(result.success).toBe(false);
+        expect(result.error).toBe("boom");
+    });
+});
+describe("fakeSession — Session interface conformance", () => {
+    it("returns a value assignable to Session without casts", () => {
+        // Compile-time check: the literal annotation forces structural conformance.
+        // If this file compiles, the conformance check has passed.
+        const session = fakeSession();
+        expect(typeof session.execute).toBe("function");
+        expect(typeof session.send).toBe("function");
+        expect(typeof session.sendStream).toBe("function");
+        expect(typeof session.proxyExecute).toBe("function");
+        expect(typeof session.authorize).toBe("function");
+        expect(typeof session.connections).toBe("function");
+        expect(typeof session.close).toBe("function");
+        expect(typeof session.discover).toBe("function");
+        expect(typeof session.connectionWizard).toBe("function");
+        expect(typeof session.charge).toBe("function");
+        expect(typeof session.ship).toBe("function");
+        expect(typeof session.paymentStatus).toBe("function");
+        expect(typeof session.paymentStatusStream).toBe("function");
+        expect(typeof session.verificationStatus).toBe("function");
+        expect(typeof session.verificationStatusStream).toBe("function");
+    });
+});
+//# sourceMappingURL=testing.test.js.map

package/dist/__tests__/testing.test.js.map

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