shopify_storefront_sdk 1.0.4 → 2.0.0

package/dist/tests/unit/cache.test.js

@@ -0,0 +1,85 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import ShopifyStorefront from "../../index.js";
+import { InMemoryCache } from "../../utils/cache.js";
+const fetchMock = vi.fn();
+vi.stubGlobal("fetch", fetchMock);
+describe("Caching System", () => {
+    const MOCK_DOMAIN = "test-store.myshopify.com";
+    const MOCK_TOKEN = "mock-token-123";
+    let cache;
+    beforeEach(() => {
+        vi.resetAllMocks();
+        cache = new InMemoryCache();
+    });
+    it("should cache successful queries and prevent subsequent network requests", async () => {
+        const client = new ShopifyStorefront({
+            storeUrl: MOCK_DOMAIN,
+            storefrontToken: MOCK_TOKEN,
+            cache,
+            defaultCacheTtl: 60,
+        });
+        fetchMock.mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({
+                data: { shop: { name: "First Fetch" } },
+            }),
+        });
+        // 1st call: Should hit the network (fetchMock called)
+        const result1 = await client.customQuery("query { shop { name } }", {});
+        expect(result1.shop.name).toBe("First Fetch");
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        // 2nd call: Should return from cache (fetchMock NOT called again)
+        const result2 = await client.customQuery("query { shop { name } }", {});
+        expect(result2.shop.name).toBe("First Fetch");
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+    });
+    it("should NOT cache mutations", async () => {
+        const client = new ShopifyStorefront({
+            storeUrl: MOCK_DOMAIN,
+            storefrontToken: MOCK_TOKEN,
+            cache,
+            defaultCacheTtl: 60,
+        });
+        fetchMock.mockResolvedValue({
+            ok: true,
+            json: async () => ({
+                data: { customerCreate: { customer: { id: "123" } } },
+            }),
+        });
+        // 1st call
+        await client.customQuery("mutation { customerCreate(input: {}) { customer { id } } }", {});
+        // 2nd call with exactly the same mutation
+        await client.customQuery("mutation { customerCreate(input: {}) { customer { id } } }", {});
+        // Mutations should bypass the cache entirely
+        expect(fetchMock).toHaveBeenCalledTimes(2);
+    });
+    it("should expire cache entries after the TTL", async () => {
+        // Override Date.now for time travel
+        const originalDateNow = Date.now;
+        let mockedTime = 1000000;
+        vi.spyOn(Date, "now").mockImplementation(() => mockedTime);
+        const client = new ShopifyStorefront({
+            storeUrl: MOCK_DOMAIN,
+            storefrontToken: MOCK_TOKEN,
+            cache,
+            defaultCacheTtl: 1, // 1 second TTL
+        });
+        fetchMock.mockResolvedValue({
+            ok: true,
+            json: async () => ({
+                data: { data: "mocked" },
+            }),
+        });
+        // Initial fetch
+        await client.customQuery("query { something }", {});
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        // Fast forward time by 2 seconds (exceeding 1s TTL)
+        mockedTime += 2000;
+        // Subsequent fetch should hit network again because cache expired
+        await client.customQuery("query { something }", {});
+        expect(fetchMock).toHaveBeenCalledTimes(2);
+        // Restore Date.now
+        vi.restoreAllMocks();
+    });
+});
+//# sourceMappingURL=cache.test.js.map

package/dist/tests/unit/cache.test.js.map

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

package/dist/tests/unit/cartManager.test.d.ts

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

package/dist/tests/unit/cartManager.test.d.ts.map

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

package/dist/tests/unit/cartManager.test.js

@@ -0,0 +1,43 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import ShopifyStorefront from "../../index.js";
+import { CartManager } from "../../helpers/CartManager.js";
+describe("CartManager", () => {
+    const MOCK_DOMAIN = "test-store.myshopify.com";
+    const MOCK_TOKEN = "mock-token-123";
+    let shopify;
+    beforeEach(() => {
+        vi.resetAllMocks();
+        shopify = new ShopifyStorefront({ storeUrl: MOCK_DOMAIN, storefrontToken: MOCK_TOKEN });
+    });
+    it("should initialize with an existing cart ID", () => {
+        const cart = shopify.cart("existing-cart-123");
+        expect(cart.id).toBe("existing-cart-123");
+    });
+    it("should lazily create a cart if no ID is provided", async () => {
+        const cart = shopify.cart();
+        expect(cart.id).toBeNull();
+        // Mock createCart on the SDK instance
+        const createCartSpy = vi.spyOn(shopify, "createCart").mockResolvedValueOnce({
+            cartCreate: { cart: { id: "new-cart-456" } }
+        });
+        // Mock addCartLines
+        const addCartLinesSpy = vi.spyOn(shopify, "addCartLines").mockResolvedValueOnce({});
+        await cart.addLines([{ merchandiseId: "variant-1", quantity: 1 }]);
+        expect(createCartSpy).toHaveBeenCalledTimes(1);
+        expect(addCartLinesSpy).toHaveBeenCalledWith({
+            cartId: "new-cart-456",
+            lines: [{ merchandiseId: "variant-1", quantity: 1 }]
+        });
+        expect(cart.id).toBe("new-cart-456");
+    });
+    it("should reuse the cart ID for subsequent operations", async () => {
+        const cart = shopify.cart("existing-cart-123");
+        const createCartSpy = vi.spyOn(shopify, "createCart");
+        const getCartSpy = vi.spyOn(shopify, "getCart").mockResolvedValueOnce({});
+        await cart.get();
+        // Should NOT have called createCart since an ID was provided
+        expect(createCartSpy).not.toHaveBeenCalled();
+        expect(getCartSpy).toHaveBeenCalledWith({ cartId: "existing-cart-123", first: 250 });
+    });
+});
+//# sourceMappingURL=cartManager.test.js.map

package/dist/tests/unit/cartManager.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cartManager.test.js","sourceRoot":"","sources":["../../../src/tests/unit/cartManager.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,iBAAiB,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,MAAM,WAAW,GAAG,0BAA0B,CAAC;IAC/C,MAAM,UAAU,GAAG,gBAAgB,CAAC;IACpC,IAAI,OAA0B,CAAC;IAE/B,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,GAAG,IAAI,iBAAiB,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;QAE3B,sCAAsC;QACtC,MAAM,aAAa,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,qBAAqB,CAAC;YAC1E,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE;SACtC,CAAC,CAAC;QAEV,oBAAoB;QACpB,MAAM,eAAe,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,qBAAqB,CAAC,EAAS,CAAC,CAAC;QAE3F,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAEnE,MAAM,CAAC,aAAa,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,CAAC,eAAe,CAAC,CAAC,oBAAoB,CAAC;YAC3C,MAAM,EAAE,cAAc;YACtB,KAAK,EAAE,CAAC,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;SACrD,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAE/C,MAAM,aAAa,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACtD,MAAM,UAAU,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,qBAAqB,CAAC,EAAS,CAAC,CAAC;QAEjF,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;QAEjB,6DAA6D;QAC7D,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAC7C,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/unit/client.test.d.ts

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

package/dist/tests/unit/client.test.d.ts.map

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

package/dist/tests/unit/client.test.js

@@ -0,0 +1,133 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import ShopifyStorefront from "../../index.js";
+import { ShopifyInvalidRequestError, ShopifyNetworkError, ShopifyGraphQLError, ShopifyUserError, } from "../../utils/errors.js";
+const fetchMock = vi.fn();
+vi.stubGlobal("fetch", fetchMock);
+describe("Shopify SDK Unit Tests", () => {
+    const MOCK_DOMAIN = "test-store.myshopify.com";
+    const MOCK_TOKEN = "mock-token-123";
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    describe("Initialization", () => {
+        it("should throw ShopifyInvalidRequestError if domain is missing", () => {
+            expect(() => {
+                new ShopifyStorefront({ storeUrl: "", storefrontToken: MOCK_TOKEN });
+            }).toThrow(ShopifyInvalidRequestError);
+        });
+        it("should throw ShopifyInvalidRequestError if domain is invalid", () => {
+            expect(() => {
+                new ShopifyStorefront({ storeUrl: "invalid-url.com", storefrontToken: MOCK_TOKEN });
+            }).toThrow(ShopifyInvalidRequestError);
+        });
+        it("should throw ShopifyInvalidRequestError if token is missing", () => {
+            expect(() => {
+                new ShopifyStorefront({ storeUrl: MOCK_DOMAIN, storefrontToken: "" });
+            }).toThrow(ShopifyInvalidRequestError);
+        });
+        it("should initialize successfully with valid config", () => {
+            const client = new ShopifyStorefront({ storeUrl: MOCK_DOMAIN, storefrontToken: MOCK_TOKEN });
+            expect(client).toBeDefined();
+        });
+    });
+    describe("API Versioning", () => {
+        it("should default to the 2025-01 API version if none is provided", async () => {
+            const client = new ShopifyStorefront({ storeUrl: MOCK_DOMAIN, storefrontToken: MOCK_TOKEN });
+            fetchMock.mockResolvedValueOnce({
+                ok: true,
+                json: async () => ({ data: {} }),
+            });
+            await client.customQuery("query { shop { name } }", {});
+            expect(fetchMock).toHaveBeenCalledWith(`https://${MOCK_DOMAIN}/api/2025-01/graphql.json`, expect.objectContaining({ method: "POST" }));
+        });
+        it("should use a custom API version if provided", async () => {
+            const client = new ShopifyStorefront({
+                storeUrl: MOCK_DOMAIN,
+                storefrontToken: MOCK_TOKEN,
+                apiVersion: "unstable"
+            });
+            fetchMock.mockResolvedValueOnce({
+                ok: true,
+                json: async () => ({ data: {} }),
+            });
+            await client.customQuery("query { shop { name } }", {});
+            expect(fetchMock).toHaveBeenCalledWith(`https://${MOCK_DOMAIN}/api/unstable/graphql.json`, expect.objectContaining({ method: "POST" }));
+        });
+    });
+    describe("Error Handling", () => {
+        let client;
+        beforeEach(() => {
+            // Reduce retries in tests to avoid slowing them down
+            client = new ShopifyStorefront({ storeUrl: MOCK_DOMAIN, storefrontToken: MOCK_TOKEN, maxRetries: 0 });
+        });
+        it("should throw ShopifyNetworkError when fetch fails (e.g. network down)", async () => {
+            fetchMock.mockRejectedValueOnce(new Error("Network connection lost"));
+            await expect(client.customQuery("query { shop { name } }", {})).rejects.toThrow(ShopifyNetworkError);
+        });
+        it("should throw ShopifyInvalidRequestError for 400 responses", async () => {
+            fetchMock.mockResolvedValueOnce({
+                ok: false,
+                status: 400,
+                statusText: "Bad Request"
+            });
+            await expect(client.customQuery("query { shop { name } }", {})).rejects.toThrow(ShopifyInvalidRequestError);
+        });
+        it("should throw ShopifyGraphQLError when Shopify returns top-level errors", async () => {
+            fetchMock.mockResolvedValueOnce({
+                ok: true,
+                json: async () => ({
+                    errors: [{ message: "Unauthorized Request" }],
+                })
+            });
+            await expect(client.customQuery("query { shop { name } }", {})).rejects.toThrow(ShopifyGraphQLError);
+        });
+        it("should throw ShopifyUserError when a mutation returns nested userErrors", async () => {
+            fetchMock.mockResolvedValueOnce({
+                ok: true,
+                json: async () => ({
+                    data: {
+                        customerCreate: {
+                            customer: null,
+                            userErrors: [{ field: ["email"], message: "Email has already been taken" }],
+                        },
+                    },
+                })
+            });
+            await expect(client.customQuery("mutation { customerCreate { userErrors { message } } }", {})).rejects.toThrow(ShopifyUserError);
+        });
+        it("should return the correct data on a successful response", async () => {
+            fetchMock.mockResolvedValueOnce({
+                ok: true,
+                json: async () => ({
+                    data: {
+                        shop: { name: "Test Store" },
+                    },
+                })
+            });
+            const response = await client.customQuery("query { shop { name } }", {});
+            expect(response.shop.name).toBe("Test Store");
+        });
+    });
+    describe("Auto-Retries", () => {
+        it("should successfully retry on a 429 rate limit response", async () => {
+            const client = new ShopifyStorefront({ storeUrl: MOCK_DOMAIN, storefrontToken: MOCK_TOKEN, maxRetries: 2 });
+            // First attempt: Rate Limited
+            fetchMock.mockResolvedValueOnce({
+                ok: false,
+                status: 429,
+                statusText: "Too Many Requests"
+            });
+            // Second attempt: Success
+            fetchMock.mockResolvedValueOnce({
+                ok: true,
+                json: async () => ({
+                    data: { shop: { name: "Success After Retry" } },
+                })
+            });
+            const response = await client.customQuery("query { shop { name } }", {});
+            expect(response.shop.name).toBe("Success After Retry");
+            expect(fetchMock).toHaveBeenCalledTimes(2);
+        });
+    });
+});
+//# sourceMappingURL=client.test.js.map

package/dist/tests/unit/client.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.test.js","sourceRoot":"","sources":["../../../src/tests/unit/client.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,iBAAiB,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAC1B,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AAElC,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,MAAM,WAAW,GAAG,0BAA0B,CAAC;IAC/C,MAAM,UAAU,GAAG,gBAAgB,CAAC;IAEpC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;YACtE,MAAM,CAAC,GAAG,EAAE;gBACV,IAAI,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC,CAAC;YACvE,CAAC,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;YACtE,MAAM,CAAC,GAAG,EAAE;gBACV,IAAI,iBAAiB,CAAC,EAAE,QAAQ,EAAE,iBAAiB,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC,CAAC;YACtF,CAAC,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;YACrE,MAAM,CAAC,GAAG,EAAE;gBACV,IAAI,iBAAiB,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC,CAAC;YACxE,CAAC,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC,CAAC;YAC7F,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;YAC7E,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC,CAAC;YAC7F,SAAS,CAAC,qBAAqB,CAAC;gBAC9B,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;aACjC,CAAC,CAAC;YAEH,MAAM,MAAM,CAAC,WAAW,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;YAExD,MAAM,CAAC,SAAS,CAAC,CAAC,oBAAoB,CACpC,WAAW,WAAW,2BAA2B,EACjD,MAAM,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAC5C,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;YAC3D,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC;gBACnC,QAAQ,EAAE,WAAW;gBACrB,eAAe,EAAE,UAAU;gBAC3B,UAAU,EAAE,UAAU;aACvB,CAAC,CAAC;YACH,SAAS,CAAC,qBAAqB,CAAC;gBAC9B,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;aACjC,CAAC,CAAC;YAEH,MAAM,MAAM,CAAC,WAAW,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;YAExD,MAAM,CAAC,SAAS,CAAC,CAAC,oBAAoB,CACpC,WAAW,WAAW,4BAA4B,EAClD,MAAM,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAC5C,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,IAAI,MAAyB,CAAC;QAE9B,UAAU,CAAC,GAAG,EAAE;YACd,qDAAqD;YACrD,MAAM,GAAG,IAAI,iBAAiB,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;QACxG,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;YACrF,SAAS,CAAC,qBAAqB,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC;YAEtE,MAAM,MAAM,CACV,MAAM,CAAC,WAAW,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAClD,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;YACzE,SAAS,CAAC,qBAAqB,CAAC;gBAC9B,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,GAAG;gBACX,UAAU,EAAE,aAAa;aAC1B,CAAC,CAAC;YAEH,MAAM,MAAM,CACV,MAAM,CAAC,WAAW,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAClD,CAAC,OAAO,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;YACtF,SAAS,CAAC,qBAAqB,CAAC;gBAC9B,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;oBACjB,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;iBAC9C,CAAC;aACH,CAAC,CAAC;YAEH,MAAM,MAAM,CACV,MAAM,CAAC,WAAW,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAClD,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yEAAyE,EAAE,KAAK,IAAI,EAAE;YACvF,SAAS,CAAC,qBAAqB,CAAC;gBAC9B,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;oBACjB,IAAI,EAAE;wBACJ,cAAc,EAAE;4BACd,QAAQ,EAAE,IAAI;4BACd,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC;yBAC5E;qBACF;iBACF,CAAC;aACH,CAAC,CAAC;YAEH,MAAM,MAAM,CACV,MAAM,CAAC,WAAW,CAAC,wDAAwD,EAAE,EAAE,CAAC,CACjF,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;YACvE,SAAS,CAAC,qBAAqB,CAAC;gBAC9B,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;oBACjB,IAAI,EAAE;wBACJ,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE;qBAC7B;iBACF,CAAC;aACH,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CAAM,yBAAyB,EAAE,EAAE,CAAC,CAAC;YAC9E,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;YACtE,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;YAE5G,8BAA8B;YAC9B,SAAS,CAAC,qBAAqB,CAAC;gBAC9B,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,GAAG;gBACX,UAAU,EAAE,mBAAmB;aAChC,CAAC,CAAC;YAEH,0BAA0B;YAC1B,SAAS,CAAC,qBAAqB,CAAC;gBAC9B,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;oBACjB,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,EAAE;iBAChD,CAAC;aACH,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CAAM,yBAAyB,EAAE,EAAE,CAAC,CAAC;YAE9E,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YACvD,MAAM,CAAC,SAAS,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/unit/customerSession.test.d.ts

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

package/dist/tests/unit/customerSession.test.d.ts.map

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

package/dist/tests/unit/customerSession.test.js

@@ -0,0 +1,49 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import ShopifyStorefront from "../../index.js";
+describe("CustomerSession", () => {
+    const MOCK_DOMAIN = "test-store.myshopify.com";
+    const MOCK_TOKEN = "mock-token-123";
+    let shopify;
+    beforeEach(() => {
+        vi.resetAllMocks();
+        shopify = new ShopifyStorefront({ storeUrl: MOCK_DOMAIN, storefrontToken: MOCK_TOKEN });
+    });
+    it("should initialize with the provided token", () => {
+        const session = shopify.customer("customer-token-123");
+        expect(session.token).toBe("customer-token-123");
+    });
+    it("should forward the token when verifying the customer", async () => {
+        const session = shopify.customer("customer-token-123");
+        const verifySpy = vi.spyOn(shopify, "verifyCustomerToken").mockResolvedValueOnce({});
+        await session.verify();
+        expect(verifySpy).toHaveBeenCalledWith({ token: "customer-token-123" });
+    });
+    it("should forward the token and customer payload when updating the customer", async () => {
+        const session = shopify.customer("customer-token-123");
+        const updateSpy = vi.spyOn(shopify, "updateCustomer").mockResolvedValueOnce({});
+        await session.update({ firstName: "John", lastName: "Doe" });
+        expect(updateSpy).toHaveBeenCalledWith({
+            customerAccessToken: "customer-token-123",
+            customer: { firstName: "John", lastName: "Doe" }
+        });
+    });
+    it("should forward the token and first argument when fetching orders", async () => {
+        const session = shopify.customer("customer-token-123");
+        const getOrdersSpy = vi.spyOn(shopify, "getCustomerOrders").mockResolvedValueOnce({});
+        await session.getOrders(50);
+        expect(getOrdersSpy).toHaveBeenCalledWith({
+            customerAccessToken: "customer-token-123",
+            first: 50
+        });
+    });
+    it("should default to first: 250 when fetching orders if not specified", async () => {
+        const session = shopify.customer("customer-token-123");
+        const getOrdersSpy = vi.spyOn(shopify, "getCustomerOrders").mockResolvedValueOnce({});
+        await session.getOrders();
+        expect(getOrdersSpy).toHaveBeenCalledWith({
+            customerAccessToken: "customer-token-123",
+            first: 250
+        });
+    });
+});
+//# sourceMappingURL=customerSession.test.js.map

package/dist/tests/unit/customerSession.test.js.map

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

package/dist/tests/unit/pagination.test.d.ts

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

package/dist/tests/unit/pagination.test.d.ts.map

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

package/dist/tests/unit/pagination.test.js

@@ -0,0 +1,40 @@
+import { describe, it, expect } from "vitest";
+import { autoPaginate } from "../../utils/pagination.js";
+describe("Pagination Utility", () => {
+    it("should extract nodes and stop when hasNextPage is false", async () => {
+        // Mock a paginated API response
+        const mockResponses = [
+            {
+                data: {
+                    edges: [{ node: { id: 1 } }, { node: { id: 2 } }],
+                    pageInfo: { hasNextPage: true, endCursor: "cursor_1" },
+                },
+            },
+            {
+                data: {
+                    edges: [{ node: { id: 3 } }, { node: { id: 4 } }],
+                    pageInfo: { hasNextPage: false, endCursor: null },
+                },
+            },
+        ];
+        let requestCount = 0;
+        const fetchPage = async (cursor) => {
+            if (cursor === "cursor_1") {
+                requestCount++;
+                return mockResponses[1];
+            }
+            requestCount++;
+            return mockResponses[0];
+        };
+        const results = await autoPaginate(fetchPage, (res) => res?.data);
+        expect(requestCount).toBe(2);
+        expect(results).toHaveLength(4);
+        expect(results).toEqual([{ id: 1 }, { id: 2 }, { id: 3 }, { id: 4 }]);
+    });
+    it("should return early if the connection is null or missing", async () => {
+        const fetchPage = async () => ({ data: null });
+        const results = await autoPaginate(fetchPage, (res) => res?.data);
+        expect(results).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=pagination.test.js.map

package/dist/tests/unit/pagination.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.test.js","sourceRoot":"","sources":["../../../src/tests/unit/pagination.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,gCAAgC;QAChC,MAAM,aAAa,GAAG;YACpB;gBACE,IAAI,EAAE;oBACJ,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;oBACjD,QAAQ,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE;iBACvD;aACF;YACD;gBACE,IAAI,EAAE;oBACJ,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;oBACjD,QAAQ,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE;iBAClD;aACF;SACF,CAAC;QAEF,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,MAAM,SAAS,GAAG,KAAK,EAAE,MAAe,EAAE,EAAE;YAC1C,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;gBAC1B,YAAY,EAAE,CAAC;gBACf,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;YAC1B,CAAC;YACD,YAAY,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,YAAY,CAChC,SAAS,EACT,CAAC,GAAQ,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,CACxB,CAAC;QAEF,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,SAAS,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/C,MAAM,OAAO,GAAG,MAAM,YAAY,CAChC,SAAS,EACT,CAAC,GAAQ,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,CACxB,CAAC;QAEF,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/unit/webhooks.test.d.ts

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

package/dist/tests/unit/webhooks.test.d.ts.map

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

package/dist/tests/unit/webhooks.test.js

@@ -0,0 +1,40 @@
+import { describe, it, expect } from "vitest";
+import { verifyWebhook } from "../../utils/webhooks.js";
+import ShopifyStorefront from "../../index.js";
+import * as crypto from "node:crypto";
+describe("Webhook Verification", () => {
+    const SECRET = "my_super_secret_key";
+    const PAYLOAD = JSON.stringify({ id: 12345, status: "created" });
+    it("should return true for a valid signature", () => {
+        // Generate valid HMAC
+        const validHmac = crypto
+            .createHmac("sha256", SECRET)
+            .update(PAYLOAD)
+            .digest("base64");
+        // Test standalone utility
+        expect(verifyWebhook(PAYLOAD, validHmac, SECRET)).toBe(true);
+        // Test SDK static method wrapper
+        expect(ShopifyStorefront.verifyWebhook(PAYLOAD, validHmac, SECRET)).toBe(true);
+    });
+    it("should return false for an invalid signature", () => {
+        const invalidHmac = crypto
+            .createHmac("sha256", "wrong_secret")
+            .update(PAYLOAD)
+            .digest("base64");
+        expect(verifyWebhook(PAYLOAD, invalidHmac, SECRET)).toBe(false);
+    });
+    it("should return false if payload has been tampered with", () => {
+        const validHmac = crypto
+            .createHmac("sha256", SECRET)
+            .update(PAYLOAD)
+            .digest("base64");
+        const tamperedPayload = JSON.stringify({ id: 12345, status: "deleted" });
+        expect(verifyWebhook(tamperedPayload, validHmac, SECRET)).toBe(false);
+    });
+    it("should return false if missing parameters", () => {
+        expect(verifyWebhook("", "hmac", SECRET)).toBe(false);
+        expect(verifyWebhook(PAYLOAD, "", SECRET)).toBe(false);
+        expect(verifyWebhook(PAYLOAD, "hmac", "")).toBe(false);
+    });
+});
+//# sourceMappingURL=webhooks.test.js.map

package/dist/tests/unit/webhooks.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.test.js","sourceRoot":"","sources":["../../../src/tests/unit/webhooks.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,iBAAiB,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,MAAM,MAAM,GAAG,qBAAqB,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAEjE,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,sBAAsB;QACtB,MAAM,SAAS,GAAG,MAAM;aACrB,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC;aAC5B,MAAM,CAAC,OAAO,CAAC;aACf,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEpB,0BAA0B;QAC1B,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE7D,iCAAiC;QACjC,MAAM,CAAC,iBAAiB,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,WAAW,GAAG,MAAM;aACvB,UAAU,CAAC,QAAQ,EAAE,cAAc,CAAC;aACpC,MAAM,CAAC,OAAO,CAAC;aACf,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEpB,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,SAAS,GAAG,MAAM;aACrB,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC;aAC5B,MAAM,CAAC,OAAO,CAAC;aACf,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEpB,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QACzE,MAAM,CAAC,aAAa,CAAC,eAAe,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvD,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/cache.d.ts

@@ -0,0 +1,14 @@
+export interface ShopifyCache {
+    get(key: string): Promise<any> | any;
+    set(key: string, value: any, ttlSeconds: number): Promise<void> | void;
+}
+export declare class InMemoryCache implements ShopifyCache {
+    private cache;
+    get(key: string): any;
+    set(key: string, value: any, ttlSeconds: number): void;
+    /**
+     * Utility to manually clear the entire memory cache.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACrC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACxE;AAED,qBAAa,aAAc,YAAW,YAAY;IAChD,OAAO,CAAC,KAAK,CAAwD;IAErE,GAAG,CAAC,GAAG,EAAE,MAAM;IAWf,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM;IAK/C;;OAEG;IACH,KAAK;CAGN"}

package/dist/utils/cache.js

@@ -0,0 +1,24 @@
+export class InMemoryCache {
+    cache = new Map();
+    get(key) {
+        const item = this.cache.get(key);
+        if (!item)
+            return null;
+        if (Date.now() > item.expiresAt) {
+            this.cache.delete(key);
+            return null;
+        }
+        return item.value;
+    }
+    set(key, value, ttlSeconds) {
+        const expiresAt = Date.now() + ttlSeconds * 1000;
+        this.cache.set(key, { value, expiresAt });
+    }
+    /**
+     * Utility to manually clear the entire memory cache.
+     */
+    clear() {
+        this.cache.clear();
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,aAAa;IAChB,KAAK,GAAG,IAAI,GAAG,EAA6C,CAAC;IAErE,GAAG,CAAC,GAAW;QACb,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QAEvB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAU,EAAE,UAAkB;QAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,IAAI,CAAC;QACjD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/utils/config.d.ts

@@ -1,5 +1,11 @@
+import type { ShopifyCache } from "./cache.js";
+export type ShopifyApiVersion = "2023-10" | "2024-01" | "2024-04" | "2024-07" | "2024-10" | "2025-01" | "unstable" | (string & {});
 export type StoreConfig = {
     storeUrl: string;
     storefrontToken: string;
+    apiVersion?: ShopifyApiVersion;
+    maxRetries?: number;
+    cache?: ShopifyCache;
+    defaultCacheTtl?: number;
 };
 //# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,UAAU,GACV,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,30 @@
+export declare class ShopifyError extends Error {
+    constructor(message: string);
+}
+/**
+ * Thrown when there is an issue with the network or the Shopify API is unreachable (e.g. timeouts, 5xx responses).
+ */
+export declare class ShopifyNetworkError extends ShopifyError {
+    constructor(message: string);
+}
+/**
+ * Thrown when the GraphQL request is successfully made but Shopify returns top-level GraphQL errors.
+ */
+export declare class ShopifyGraphQLError extends ShopifyError {
+    readonly graphqlErrors: any[];
+    constructor(message: string, graphqlErrors: any[]);
+}
+/**
+ * Thrown when a mutation returns user errors (e.g. invalid form data, missing fields)
+ */
+export declare class ShopifyUserError extends ShopifyError {
+    readonly userErrors: any[];
+    constructor(message: string, userErrors: any[]);
+}
+/**
+ * Thrown when the SDK configuration is invalid or the request is malformed (e.g. 400 Bad Request, 401 Unauthorized).
+ */
+export declare class ShopifyInvalidRequestError extends ShopifyError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;gBACvC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;IACnD,SAAgB,aAAa,EAAE,GAAG,EAAE,CAAC;gBAEzB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE;CAKlD;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,SAAgB,UAAU,EAAE,GAAG,EAAE,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE;CAK/C;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,YAAY;gBAC9C,OAAO,EAAE,MAAM;CAI5B"}

package/dist/utils/errors.js

@@ -0,0 +1,48 @@
+export class ShopifyError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ShopifyError";
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Thrown when there is an issue with the network or the Shopify API is unreachable (e.g. timeouts, 5xx responses).
+ */
+export class ShopifyNetworkError extends ShopifyError {
+    constructor(message) {
+        super(message);
+        this.name = "ShopifyNetworkError";
+    }
+}
+/**
+ * Thrown when the GraphQL request is successfully made but Shopify returns top-level GraphQL errors.
+ */
+export class ShopifyGraphQLError extends ShopifyError {
+    graphqlErrors;
+    constructor(message, graphqlErrors) {
+        super(message);
+        this.name = "ShopifyGraphQLError";
+        this.graphqlErrors = graphqlErrors;
+    }
+}
+/**
+ * Thrown when a mutation returns user errors (e.g. invalid form data, missing fields)
+ */
+export class ShopifyUserError extends ShopifyError {
+    userErrors;
+    constructor(message, userErrors) {
+        super(message);
+        this.name = "ShopifyUserError";
+        this.userErrors = userErrors;
+    }
+}
+/**
+ * Thrown when the SDK configuration is invalid or the request is malformed (e.g. 400 Bad Request, 401 Unauthorized).
+ */
+export class ShopifyInvalidRequestError extends ShopifyError {
+    constructor(message) {
+        super(message);
+        this.name = "ShopifyInvalidRequestError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IACnD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IACnC,aAAa,CAAQ;IAErC,YAAY,OAAe,EAAE,aAAoB;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IAChC,UAAU,CAAQ;IAElC,YAAY,OAAe,EAAE,UAAiB;QAC5C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,YAAY;IAC1D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF"}