shopify_storefront_sdk 1.0.3 → 2.0.0

package/dist/index.js

@@ -1,14 +1,62 @@
 import ShopifyClient from "./client/client.js";
-import { CartBuyerIdentityUpdateDocument, CartCreateDocument, CartLinesAddDocument, CartLinesRemoveDocument, CartLinesUpdateDocument, CustomerAccessTokenCreateDocument, CustomerCreateDocument, CustomerRecoverDocument, CustomerUpdateDocument, GetAllProductTypesDocument, GetArticlesDocument, GetBlogsDocument, GetCartDocument, GetCollectionsDocument, GetCustomerDocument, GetCustomerOrdersDocument, GetProductByHandleDocument, GetProductByIdDocument, GetProductRecommendationsDocument, GetProductsDocument, GetSingleArticleDocument, } from "./generated/shopify.js";
+import { CartBuyerIdentityUpdateDocument, CartCreateDocument, CartLinesAddDocument, CartLinesRemoveDocument, CartLinesUpdateDocument, CustomerAccessTokenCreateDocument, CustomerCreateDocument, CustomerRecoverDocument, CustomerUpdateDocument, GetAllProductTypesDocument, GetArticlesDocument, GetBlogsDocument, GetCartDocument, GetCollectionsDocument, GetCustomerDocument, GetCustomerOrdersDocument, GetProductByHandleDocument, GetProductByIdDocument, GetProductRecommendationsDocument, GetProductsDocument, GetSingleArticleDocument, GetShopInfoDocument, } from "./generated/shopify.js";
+// Export Custom Error Classes
+export { ShopifyError, ShopifyNetworkError, ShopifyGraphQLError, ShopifyUserError, ShopifyInvalidRequestError, } from "./utils/errors.js";
+// Export Cache utilities
+export { InMemoryCache } from "./utils/cache.js";
+import { autoPaginate } from "./utils/pagination.js";
+import { verifyWebhook } from "./utils/webhooks.js";
+import { CartManager } from "./helpers/CartManager.js";
+import { CustomerSession } from "./helpers/CustomerSession.js";
 class ShopifyStorefront {
     client;
     constructor(config) {
         this.client = new ShopifyClient(config);
     }
+    /**
+     * Returns a stateful CustomerSession wrapper.
+     * This automatically injects the customer's access token into subsequent requests.
+     *
+     * @param customerAccessToken The active access token for the logged-in customer.
+     * @returns CustomerSession instance.
+     */
+    customer(customerAccessToken) {
+        return new CustomerSession(this, customerAccessToken);
+    }
+    /**
+     * Returns a stateful CartManager to effortlessly manage a shopping cart.
+     * If a cartId is not provided, the manager will lazily create one on the first operation.
+     *
+     * @param cartId An optional existing cart ID.
+     * @returns CartManager instance.
+     */
+    cart(cartId) {
+        return new CartManager(this, cartId);
+    }
+    /**
+     * Verifies the authenticity of a Shopify webhook.
+     * @param rawBody The raw string/buffer payload of the webhook.
+     * @param hmacHeader The X-Shopify-Hmac-Sha256 header.
+     * @param secret Your Shopify API secret key.
+     * @returns true if the webhook is authentic.
+     */
+    static verifyWebhook(rawBody, hmacHeader, secret) {
+        return verifyWebhook(rawBody, hmacHeader, secret);
+    }
+    /**
+     * Fetches a paginated list of products from the store.
+     * @param variables Includes `first`, `after`, `last`, `before`, and `query` to control pagination and filtering.
+     * @returns A promise resolving to the products connection.
+     */
     async getProducts({ first, last, after, before, query, }) {
         const data = await this.client.query(GetProductsDocument, { first, last, after, before, query });
         return data;
     }
+    /**
+     * Fetches a single product by its global ID.
+     * @param variables The `id` of the product and optional `metafields` array.
+     * @returns A promise resolving to the requested product.
+     */
     async getProductById({ id, metafields }) {
         const data = await this.client.query(GetProductByIdDocument, {
             id,
@@ -16,18 +64,38 @@ class ShopifyStorefront {
         });
         return data;
     }
+    /**
+     * Fetches recommended products based on a given product ID.
+     * @param variables The `productId` for which to fetch recommendations.
+     * @returns A promise resolving to an array of recommended products.
+     */
     async getProductRecommendations({ productId, }) {
         const data = await this.client.query(GetProductRecommendationsDocument, { productId });
         return data;
     }
+    /**
+     * Fetches a single product by its handle.
+     * @param variables The `handle` of the product.
+     * @returns A promise resolving to the requested product.
+     */
     async getProductByHandle({ handle }) {
         const data = await this.client.query(GetProductByHandleDocument, { handle });
         return data;
     }
-    async getAllProductType({ first }) {
+    /**
+     * Fetches a paginated list of product types available in the store.
+     * @param variables Includes `first` to limit the number of types returned.
+     * @returns A promise resolving to the product types connection.
+     */
+    async getProductTypes({ first }) {
         const data = await this.client.query(GetAllProductTypesDocument, { first });
         return data;
     }
+    /**
+     * Fetches a paginated list of collections from the store.
+     * @param variables Includes `first` and `after` for pagination.
+     * @returns A promise resolving to the collections connection.
+     */
     async getCollections({ first, after }) {
         const data = await this.client.query(GetCollectionsDocument, {
             first,
@@ -35,7 +103,12 @@ class ShopifyStorefront {
         });
         return data;
     }
-    async createUser({ firstName, lastName, password, acceptsMarketing, email, phone, }) {
+    /**
+     * Creates a new customer account.
+     * @param variables The customer details including `firstName`, `lastName`, `email`, `password`, `phone`, and `acceptsMarketing`.
+     * @returns A promise resolving to the customer creation payload. Throws ShopifyUserError if validation fails.
+     */
+    async createCustomer({ firstName, lastName, password, acceptsMarketing, email, phone, }) {
         const data = await this.client.query(CustomerCreateDocument, {
             firstName,
             lastName,
@@ -54,7 +127,12 @@ class ShopifyStorefront {
         });
         return data;
     }
-    async loginUser({ email, password }) {
+    /**
+     * Authenticates a customer using their email and password to generate an access token.
+     * @param variables The `email` and `password` of the customer.
+     * @returns A promise resolving to the access token payload. Throws ShopifyUserError on invalid credentials.
+     */
+    async loginCustomer({ email, password }) {
         const data = await this.client.query(CustomerAccessTokenCreateDocument, {
             email,
             password,
@@ -65,25 +143,50 @@ class ShopifyStorefront {
         });
         return data;
     }
-    async verifyUserToken({ token }) {
+    /**
+     * Retrieves customer details using an active customer access token.
+     * @param variables The customer access `token`.
+     * @returns A promise resolving to the customer details.
+     */
+    async verifyCustomerToken({ token }) {
         const data = await this.client.query(GetCustomerDocument, { token });
         return data;
     }
-    async customerRecover({ email }) {
+    /**
+     * Initiates the password recovery flow for a customer.
+     * @param variables The `email` of the customer recovering their account.
+     * @returns A promise resolving to the recovery payload.
+     */
+    async recoverCustomer({ email }) {
         const data = await this.client.query(CustomerRecoverDocument, { email });
         return data;
     }
-    async customerUpdate({ customerAccessToken, customer, }) {
+    /**
+     * Updates an existing customer's information.
+     * @param variables The `customerAccessToken` and the `customer` input fields to update.
+     * @returns A promise resolving to the update payload.
+     */
+    async updateCustomer({ customerAccessToken, customer, }) {
         const data = await this.client.query(CustomerUpdateDocument, {
             customerAccessToken,
             customer,
         });
         return data;
     }
+    /**
+     * Retrieves an existing cart by its ID.
+     * @param variables The `cartId` and optional `first` limit for lines.
+     * @returns A promise resolving to the cart details.
+     */
     async getCart({ cartId, first }) {
         const data = await this.client.query(GetCartDocument, { cartId, first });
         return data;
     }
+    /**
+     * Creates a new cart with optional initial line items.
+     * @param variables The `input` configuration for the new cart.
+     * @returns A promise resolving to the created cart payload.
+     */
     async createCart({ input, first }) {
         const data = await this.client.query(CartCreateDocument, {
             input,
@@ -91,21 +194,36 @@ class ShopifyStorefront {
         });
         return data;
     }
-    async cartLinesAdd({ cartId, lines }) {
+    /**
+     * Adds line items to an existing cart.
+     * @param variables The `cartId` and the `lines` to add.
+     * @returns A promise resolving to the updated cart payload.
+     */
+    async addCartLines({ cartId, lines }) {
         const data = await this.client.query(CartLinesAddDocument, {
             cartId,
             lines,
         });
         return data;
     }
-    async cartLinesRemove({ cartId, lineIds }) {
+    /**
+     * Removes line items from an existing cart.
+     * @param variables The `cartId` and the `lineIds` to remove.
+     * @returns A promise resolving to the updated cart payload.
+     */
+    async removeCartLines({ cartId, lineIds }) {
         const data = await this.client.query(CartLinesRemoveDocument, {
             cartId,
             lineIds,
         });
         return data;
     }
-    async cartLinesUpdate({ cartId, first, lines, }) {
+    /**
+     * Updates line items in an existing cart (e.g., changing quantity).
+     * @param variables The `cartId`, the updated `lines`, and optional `first` limit.
+     * @returns A promise resolving to the updated cart payload.
+     */
+    async updateCartLines({ cartId, first, lines, }) {
         const data = await this.client.query(CartLinesUpdateDocument, {
             cartId,
             first,
@@ -113,7 +231,12 @@ class ShopifyStorefront {
         });
         return data;
     }
-    async cartBuyerIdentityUpdate({ cartId, buyerIdentity: { email, phone, preferences, companyLocationId, countryCode, customerAccessToken, }, }) {
+    /**
+     * Updates the buyer identity (e.g., email, customer access token) for a cart.
+     * @param variables The `cartId` and the `buyerIdentity` object.
+     * @returns A promise resolving to the updated cart payload.
+     */
+    async updateCartBuyerIdentity({ cartId, buyerIdentity: { email, phone, preferences, companyLocationId, countryCode, customerAccessToken, }, }) {
         const data = await this.client.query(CartBuyerIdentityUpdateDocument, {
             cartId,
             buyerIdentity: {
@@ -127,43 +250,99 @@ class ShopifyStorefront {
         });
         return data;
     }
-    async cartMetafieldsSet({ metafields }) {
+    /**
+     * Sets metafields on an existing cart.
+     * @param variables The `metafields` array containing key-value pairs.
+     * @returns A promise resolving to the updated cart payload.
+     */
+    async setCartMetafields({ metafields }) {
         const data = await this.client.query(CartBuyerIdentityUpdateDocument, {
             metafields,
         });
         return data;
     }
+    /**
+     * Fetches a paginated list of blogs from the store.
+     * @param variables Includes `first` for pagination.
+     * @returns A promise resolving to the blogs connection.
+     */
     async getBlogs({ first }) {
-        const data = await this.client.query(GetBlogsDocument, {
-            first,
-        });
+        const data = await this.client.query(GetBlogsDocument, { first });
         return data;
     }
+    /**
+     * Fetches a specific blog by its handle.
+     * @param variables The `handle` of the blog and `first` pagination parameter for its articles.
+     * @returns A promise resolving to the requested blog.
+     */
     async getBlog({ first, handle }) {
-        const data = await this.client.query(GetBlogsDocument, {
-            first,
-            handle,
-        });
+        const data = await this.client.query(GetBlogsDocument, // Original used GetBlogsDocument here, not GetBlogDocument
+        { first, handle });
         return data;
     }
+    /**
+     * Fetches a paginated list of all articles across all blogs.
+     * @param variables Includes `first` for pagination.
+     * @returns A promise resolving to the articles connection.
+     */
     async getArticles({ first }) {
-        const data = await this.client.query(GetArticlesDocument, {
-            first,
-        });
+        const data = await this.client.query(GetArticlesDocument, { first });
         return data;
     }
-    async getArticle({ blogHandle, articleHandle, }) {
-        const data = await this.client.query(GetSingleArticleDocument, { blogHandle, articleHandle });
+    /**
+     * Fetches a single article by its handle and its parent blog's handle.
+     * @param variables The `articleHandle` and `blogHandle`.
+     * @returns A promise resolving to the requested article.
+     */
+    async getArticle({ articleHandle, blogHandle, }) {
+        const data = await this.client.query(GetSingleArticleDocument, {
+            articleHandle,
+            blogHandle,
+        });
         return data;
     }
+    /**
+     * Fetches the order history for an authenticated customer.
+     * @param variables The `customerAccessToken` and pagination limits.
+     * @returns A promise resolving to the customer's orders connection.
+     */
     async getCustomerOrders({ customerAccessToken, first, }) {
-        const data = await this.client.query(GetCustomerOrdersDocument, { customerAccessToken, first });
+        const data = await this.client.query(GetCustomerOrdersDocument, {
+            customerAccessToken,
+            first,
+        });
+        return data;
+    }
+    /**
+     * Fetches general information about the store (name, description, payment settings).
+     * @returns A promise resolving to the shop information.
+     */
+    async getShopInfo() {
+        const data = await this.client.query(GetShopInfoDocument, {});
         return data;
     }
+    /**
+     * Executes a custom GraphQL query or mutation against the Storefront API.
+     * Use this when the built-in SDK methods do not cover your specific use case.
+     *
+     * @param query The raw GraphQL query or mutation string.
+     * @param variables An object containing variables for the GraphQL query.
+     * @returns A promise resolving to the generic requested data structure `T`.
+     */
     async customQuery(query, variables) {
         const data = await this.client.query(query, variables);
         return data;
     }
+    /**
+     * Automatically fetches all pages of a Shopify GraphQL Connection and flattens the nodes into an array.
+     *
+     * @param fetchPage A function that takes an optional cursor and returns a promise of the API response.
+     * @param getConnection A selector function that extracts the Connection object from the API response.
+     * @returns A flat array of all nodes across all pages.
+     */
+    async autoPaginate(fetchPage, getConnection) {
+        return autoPaginate(fetchPage, getConnection);
+    }
 }
 export default ShopifyStorefront;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tests/integration/sdk.test.d.ts

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

package/dist/tests/integration/sdk.test.d.ts.map

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

package/dist/tests/integration/sdk.test.js

@@ -0,0 +1,245 @@
+import { describe, it, expect, beforeAll } from "vitest";
+import ShopifyStoreFront from "../../index.js";
+import * as dotenv from "dotenv";
+dotenv.config();
+const { SHOPIFY_STORE_DOMAIN, SHOPIFY_STOREFRONT_TOKEN } = process.env;
+// Only run these tests if the environment variables are present
+const runLiveTests = !!(SHOPIFY_STORE_DOMAIN && SHOPIFY_STOREFRONT_TOKEN);
+describe.runIf(runLiveTests)("Shopify SDK Integration Tests", () => {
+    let client;
+    // Shared state for the test chain
+    let firstProductId;
+    let firstProductHandle;
+    let firstVariantId;
+    let blogHandle;
+    let articleHandle;
+    let customerEmail = `testuser_${Date.now()}@example.com`;
+    let customerPassword = "Testing123!";
+    let customerAccessToken;
+    let cartId;
+    let lineItemId;
+    beforeAll(() => {
+        client = new ShopifyStoreFront({
+            storeUrl: String(SHOPIFY_STORE_DOMAIN),
+            storefrontToken: String(SHOPIFY_STOREFRONT_TOKEN),
+        });
+    });
+    describe("Products & Collections", () => {
+        it("should fetch products", async () => {
+            const products = await client.getProducts({ first: 10 });
+            expect(products).toBeDefined();
+            expect(products.products?.edges).toBeInstanceOf(Array);
+            const firstEdge = products.products?.edges[0];
+            if (firstEdge) {
+                firstProductId = firstEdge.node.id;
+                firstProductHandle = firstEdge.node.handle;
+                firstVariantId = firstEdge.node.variants?.edges[0]?.node.id || "";
+            }
+        });
+        it("should fetch a product by ID", async () => {
+            if (!firstProductId)
+                return;
+            const product = await client.getProductById({
+                id: firstProductId,
+                metafields: [],
+            });
+            expect(product?.product?.id).toBe(firstProductId);
+        });
+        it("should fetch a product by handle", async () => {
+            if (!firstProductHandle)
+                return;
+            const product = await client.getProductByHandle({
+                handle: firstProductHandle,
+            });
+            expect(product?.product?.handle).toBe(firstProductHandle);
+        });
+        it("should fetch all product types", async () => {
+            const types = await client.getProductTypes({ first: 50 });
+            expect(types?.products?.edges).toBeInstanceOf(Array);
+        });
+        it("should fetch product recommendations", async () => {
+            if (!firstProductId)
+                return;
+            const recommendations = await client.getProductRecommendations({
+                productId: firstProductId,
+            });
+            expect(recommendations?.productRecommendations).toBeInstanceOf(Array);
+        });
+    });
+    describe("Blogs & Articles", () => {
+        it("should fetch blogs", async () => {
+            const blogs = await client.getBlogs({ first: 10 });
+            expect(blogs?.blogs?.edges).toBeInstanceOf(Array);
+            const firstBlog = blogs?.blogs?.edges[0]?.node;
+            if (firstBlog) {
+                blogHandle = firstBlog.handle;
+            }
+        });
+        it("should fetch a specific blog", async () => {
+            if (!blogHandle)
+                return;
+            const blog = await client.getBlog({ first: 10, handle: blogHandle });
+            expect(blog?.blog?.handle).toBe(blogHandle);
+        });
+        it("should fetch articles", async () => {
+            const articles = await client.getArticles({ first: 10 });
+            expect(articles?.articles?.edges).toBeInstanceOf(Array);
+            const firstArticle = articles?.articles?.edges[0]?.node;
+            if (firstArticle) {
+                articleHandle = firstArticle.handle;
+            }
+        });
+        it("should fetch a specific article", async () => {
+            if (!blogHandle || !articleHandle)
+                return;
+            const article = await client.getArticle({
+                blogHandle: blogHandle,
+                articleHandle: articleHandle,
+            });
+            expect(article).toBeDefined();
+        });
+    });
+    describe("Customers", () => {
+        it("should create a customer", async () => {
+            const user = await client.createCustomer({
+                email: customerEmail,
+                password: customerPassword,
+                firstName: "SDK",
+                lastName: "User",
+            });
+            expect(user?.customerCreate?.customer?.firstName).toBe("SDK");
+        });
+        it("should login a customer", async () => {
+            const login = await client.loginCustomer({
+                email: customerEmail,
+                password: customerPassword,
+            });
+            const token = login?.customerAccessTokenCreate?.customerAccessToken?.accessToken;
+            expect(token).toBeDefined();
+            if (token)
+                customerAccessToken = token;
+        });
+        it("should verify customer token", async () => {
+            if (!customerAccessToken)
+                return;
+            const verify = await client.verifyCustomerToken({ token: customerAccessToken });
+            expect(verify?.customer?.email).toBe(customerEmail);
+        });
+        it("should request customer recovery", async () => {
+            const resetReq = await client.recoverCustomer({ email: customerEmail });
+            expect(resetReq?.customerRecover?.customerUserErrors).toBeDefined();
+        });
+        it("should fetch customer orders", async () => {
+            if (!customerAccessToken)
+                return;
+            const orders = await client.getCustomerOrders({
+                customerAccessToken,
+                first: 50,
+            });
+            expect(orders?.customer?.orders?.edges).toBeDefined();
+        });
+    });
+    describe("Carts", () => {
+        it("should create a cart", async () => {
+            if (!firstVariantId)
+                return;
+            const cart = await client.createCart({
+                input: {
+                    lines: [
+                        {
+                            quantity: 1,
+                            merchandiseId: firstVariantId,
+                        },
+                    ],
+                },
+                first: 20,
+            });
+            expect(cart?.cartCreate?.cart?.id).toBeDefined();
+            if (cart?.cartCreate?.cart?.id) {
+                cartId = cart.cartCreate.cart.id;
+                lineItemId = cart.cartCreate.cart.lines?.edges[0]?.node?.id ?? "";
+            }
+        });
+        it("should update cart buyer identity", async () => {
+            if (!cartId || !customerAccessToken)
+                return;
+            const identity = await client.updateCartBuyerIdentity({
+                cartId: cartId,
+                buyerIdentity: {
+                    customerAccessToken: customerAccessToken,
+                    email: customerEmail,
+                    phone: "00000000000",
+                },
+            });
+            expect(identity?.cartBuyerIdentityUpdate?.cart?.id).toBeDefined();
+        });
+        it("should fetch an existing cart", async () => {
+            if (!cartId)
+                return;
+            const existingCart = await client.getCart({ cartId, first: 20 });
+            expect(existingCart?.cart?.id).toBe(cartId);
+        });
+        it("should add lines to a cart", async () => {
+            if (!cartId || !firstVariantId)
+                return;
+            const addToCart = await client.addCartLines({
+                cartId,
+                lines: [
+                    {
+                        quantity: 1,
+                        merchandiseId: firstVariantId,
+                    },
+                ],
+            });
+            expect(addToCart?.cartLinesAdd?.cart?.id).toBeDefined();
+        });
+        it("should update lines in a cart", async () => {
+            if (!cartId || !firstVariantId || !lineItemId)
+                return;
+            const updatedCart = await client.updateCartLines({
+                cartId,
+                first: 20,
+                lines: [
+                    {
+                        id: lineItemId,
+                        quantity: 2,
+                        merchandiseId: firstVariantId,
+                    },
+                ],
+            });
+            expect(updatedCart?.cartLinesUpdate?.cart?.id).toBeDefined();
+        });
+        it("should remove lines from a cart", async () => {
+            if (!cartId || !lineItemId)
+                return;
+            const removedCart = await client.removeCartLines({
+                cartId,
+                lineIds: [lineItemId],
+            });
+            expect(removedCart?.cartLinesRemove?.cart?.id).toBeDefined();
+        });
+    });
+    describe("Shop Info", () => {
+        it("should fetch shop info using the dedicated method", async () => {
+            const shopInfo = await client.getShopInfo();
+            expect(shopInfo?.shop?.name).toBeDefined();
+        });
+    });
+    describe("Custom Queries", () => {
+        it("should successfully execute a custom query", async () => {
+            const customQuery = await client.customQuery(`query getShopInfo {
+            shop {
+              name
+              description
+              paymentSettings {
+                currencyCode
+                countryCode
+                enabledPresentmentCurrencies
+              }
+            }
+          }`, {});
+            expect(customQuery?.shop?.name).toBeDefined();
+        });
+    });
+});
+//# sourceMappingURL=sdk.test.js.map

package/dist/tests/integration/sdk.test.js.map

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

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

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

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

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