shopify_storefront_sdk 1.0.3 → 2.0.0

package/dist/cjs/helpers/CustomerSession.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomerSession = void 0;
+/**
+ * A stateful high-level manager for an authenticated Customer's session.
+ * Automatically injects the customer access token into subsequent requests.
+ */
+class CustomerSession {
+    constructor(sdk, customerAccessToken) {
+        this.sdk = sdk;
+        this.token = customerAccessToken;
+    }
+    /**
+     * Retrieves the customer details for this session.
+     * Useful for verifying the token is still valid.
+     */
+    async verify() {
+        return this.sdk.verifyCustomerToken({ token: this.token });
+    }
+    /**
+     * Updates this customer's profile information.
+     * @param customer The fields to update (e.g. firstName, lastName).
+     */
+    async update(customer) {
+        return this.sdk.updateCustomer({
+            customerAccessToken: this.token,
+            customer,
+        });
+    }
+    /**
+     * Fetches the order history for this authenticated customer.
+     * @param first The number of orders to return (defaults to 250).
+     */
+    async getOrders(first = 250) {
+        return this.sdk.getCustomerOrders({
+            customerAccessToken: this.token,
+            first,
+        });
+    }
+}
+exports.CustomerSession = CustomerSession;

package/dist/cjs/index.js

@@ -1,15 +1,70 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryCache = exports.ShopifyInvalidRequestError = exports.ShopifyUserError = exports.ShopifyGraphQLError = exports.ShopifyNetworkError = exports.ShopifyError = void 0;
 const client_js_1 = require("./client/client.js");
 const shopify_js_1 = require("./generated/shopify.js");
+// Export Custom Error Classes
+var errors_js_1 = require("./utils/errors.js");
+Object.defineProperty(exports, "ShopifyError", { enumerable: true, get: function () { return errors_js_1.ShopifyError; } });
+Object.defineProperty(exports, "ShopifyNetworkError", { enumerable: true, get: function () { return errors_js_1.ShopifyNetworkError; } });
+Object.defineProperty(exports, "ShopifyGraphQLError", { enumerable: true, get: function () { return errors_js_1.ShopifyGraphQLError; } });
+Object.defineProperty(exports, "ShopifyUserError", { enumerable: true, get: function () { return errors_js_1.ShopifyUserError; } });
+Object.defineProperty(exports, "ShopifyInvalidRequestError", { enumerable: true, get: function () { return errors_js_1.ShopifyInvalidRequestError; } });
+// Export Cache utilities
+var cache_js_1 = require("./utils/cache.js");
+Object.defineProperty(exports, "InMemoryCache", { enumerable: true, get: function () { return cache_js_1.InMemoryCache; } });
+const pagination_js_1 = require("./utils/pagination.js");
+const webhooks_js_1 = require("./utils/webhooks.js");
+const CartManager_js_1 = require("./helpers/CartManager.js");
+const CustomerSession_js_1 = require("./helpers/CustomerSession.js");
 class ShopifyStorefront {
     constructor(config) {
         this.client = new client_js_1.default(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_js_1.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_js_1.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 (0, webhooks_js_1.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(shopify_js_1.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(shopify_js_1.GetProductByIdDocument, {
             id,
@@ -17,18 +72,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(shopify_js_1.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(shopify_js_1.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(shopify_js_1.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(shopify_js_1.GetCollectionsDocument, {
             first,
@@ -36,7 +111,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(shopify_js_1.CustomerCreateDocument, {
             firstName,
             lastName,
@@ -55,7 +135,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(shopify_js_1.CustomerAccessTokenCreateDocument, {
             email,
             password,
@@ -66,25 +151,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(shopify_js_1.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(shopify_js_1.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(shopify_js_1.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(shopify_js_1.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(shopify_js_1.CartCreateDocument, {
             input,
@@ -92,21 +202,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(shopify_js_1.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(shopify_js_1.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(shopify_js_1.CartLinesUpdateDocument, {
             cartId,
             first,
@@ -114,7 +239,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(shopify_js_1.CartBuyerIdentityUpdateDocument, {
             cartId,
             buyerIdentity: {
@@ -128,43 +258,98 @@ 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(shopify_js_1.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(shopify_js_1.GetBlogsDocument, {
-            first,
-        });
+        const data = await this.client.query(shopify_js_1.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(shopify_js_1.GetBlogsDocument, {
-            first,
-            handle,
-        });
+        const data = await this.client.query(shopify_js_1.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(shopify_js_1.GetArticlesDocument, {
-            first,
-        });
+        const data = await this.client.query(shopify_js_1.GetArticlesDocument, { first });
         return data;
     }
-    async getArticle({ blogHandle, articleHandle, }) {
-        const data = await this.client.query(shopify_js_1.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(shopify_js_1.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(shopify_js_1.GetCustomerOrdersDocument, { customerAccessToken, first });
+        const data = await this.client.query(shopify_js_1.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(shopify_js_1.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 (0, pagination_js_1.autoPaginate)(fetchPage, getConnection);
+    }
 }
 exports.default = ShopifyStorefront;
-//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,266 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const index_js_1 = require("../../index.js");
+const dotenv = require("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);
+vitest_1.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;
+    (0, vitest_1.beforeAll)(() => {
+        client = new index_js_1.default({
+            storeUrl: String(SHOPIFY_STORE_DOMAIN),
+            storefrontToken: String(SHOPIFY_STOREFRONT_TOKEN),
+        });
+    });
+    (0, vitest_1.describe)("Products & Collections", () => {
+        (0, vitest_1.it)("should fetch products", async () => {
+            var _a, _b, _c, _d;
+            const products = await client.getProducts({ first: 10 });
+            (0, vitest_1.expect)(products).toBeDefined();
+            (0, vitest_1.expect)((_a = products.products) === null || _a === void 0 ? void 0 : _a.edges).toBeInstanceOf(Array);
+            const firstEdge = (_b = products.products) === null || _b === void 0 ? void 0 : _b.edges[0];
+            if (firstEdge) {
+                firstProductId = firstEdge.node.id;
+                firstProductHandle = firstEdge.node.handle;
+                firstVariantId = ((_d = (_c = firstEdge.node.variants) === null || _c === void 0 ? void 0 : _c.edges[0]) === null || _d === void 0 ? void 0 : _d.node.id) || "";
+            }
+        });
+        (0, vitest_1.it)("should fetch a product by ID", async () => {
+            var _a;
+            if (!firstProductId)
+                return;
+            const product = await client.getProductById({
+                id: firstProductId,
+                metafields: [],
+            });
+            (0, vitest_1.expect)((_a = product === null || product === void 0 ? void 0 : product.product) === null || _a === void 0 ? void 0 : _a.id).toBe(firstProductId);
+        });
+        (0, vitest_1.it)("should fetch a product by handle", async () => {
+            var _a;
+            if (!firstProductHandle)
+                return;
+            const product = await client.getProductByHandle({
+                handle: firstProductHandle,
+            });
+            (0, vitest_1.expect)((_a = product === null || product === void 0 ? void 0 : product.product) === null || _a === void 0 ? void 0 : _a.handle).toBe(firstProductHandle);
+        });
+        (0, vitest_1.it)("should fetch all product types", async () => {
+            var _a;
+            const types = await client.getProductTypes({ first: 50 });
+            (0, vitest_1.expect)((_a = types === null || types === void 0 ? void 0 : types.products) === null || _a === void 0 ? void 0 : _a.edges).toBeInstanceOf(Array);
+        });
+        (0, vitest_1.it)("should fetch product recommendations", async () => {
+            if (!firstProductId)
+                return;
+            const recommendations = await client.getProductRecommendations({
+                productId: firstProductId,
+            });
+            (0, vitest_1.expect)(recommendations === null || recommendations === void 0 ? void 0 : recommendations.productRecommendations).toBeInstanceOf(Array);
+        });
+    });
+    (0, vitest_1.describe)("Blogs & Articles", () => {
+        (0, vitest_1.it)("should fetch blogs", async () => {
+            var _a, _b, _c;
+            const blogs = await client.getBlogs({ first: 10 });
+            (0, vitest_1.expect)((_a = blogs === null || blogs === void 0 ? void 0 : blogs.blogs) === null || _a === void 0 ? void 0 : _a.edges).toBeInstanceOf(Array);
+            const firstBlog = (_c = (_b = blogs === null || blogs === void 0 ? void 0 : blogs.blogs) === null || _b === void 0 ? void 0 : _b.edges[0]) === null || _c === void 0 ? void 0 : _c.node;
+            if (firstBlog) {
+                blogHandle = firstBlog.handle;
+            }
+        });
+        (0, vitest_1.it)("should fetch a specific blog", async () => {
+            var _a;
+            if (!blogHandle)
+                return;
+            const blog = await client.getBlog({ first: 10, handle: blogHandle });
+            (0, vitest_1.expect)((_a = blog === null || blog === void 0 ? void 0 : blog.blog) === null || _a === void 0 ? void 0 : _a.handle).toBe(blogHandle);
+        });
+        (0, vitest_1.it)("should fetch articles", async () => {
+            var _a, _b, _c;
+            const articles = await client.getArticles({ first: 10 });
+            (0, vitest_1.expect)((_a = articles === null || articles === void 0 ? void 0 : articles.articles) === null || _a === void 0 ? void 0 : _a.edges).toBeInstanceOf(Array);
+            const firstArticle = (_c = (_b = articles === null || articles === void 0 ? void 0 : articles.articles) === null || _b === void 0 ? void 0 : _b.edges[0]) === null || _c === void 0 ? void 0 : _c.node;
+            if (firstArticle) {
+                articleHandle = firstArticle.handle;
+            }
+        });
+        (0, vitest_1.it)("should fetch a specific article", async () => {
+            if (!blogHandle || !articleHandle)
+                return;
+            const article = await client.getArticle({
+                blogHandle: blogHandle,
+                articleHandle: articleHandle,
+            });
+            (0, vitest_1.expect)(article).toBeDefined();
+        });
+    });
+    (0, vitest_1.describe)("Customers", () => {
+        (0, vitest_1.it)("should create a customer", async () => {
+            var _a, _b;
+            const user = await client.createCustomer({
+                email: customerEmail,
+                password: customerPassword,
+                firstName: "SDK",
+                lastName: "User",
+            });
+            (0, vitest_1.expect)((_b = (_a = user === null || user === void 0 ? void 0 : user.customerCreate) === null || _a === void 0 ? void 0 : _a.customer) === null || _b === void 0 ? void 0 : _b.firstName).toBe("SDK");
+        });
+        (0, vitest_1.it)("should login a customer", async () => {
+            var _a, _b;
+            const login = await client.loginCustomer({
+                email: customerEmail,
+                password: customerPassword,
+            });
+            const token = (_b = (_a = login === null || login === void 0 ? void 0 : login.customerAccessTokenCreate) === null || _a === void 0 ? void 0 : _a.customerAccessToken) === null || _b === void 0 ? void 0 : _b.accessToken;
+            (0, vitest_1.expect)(token).toBeDefined();
+            if (token)
+                customerAccessToken = token;
+        });
+        (0, vitest_1.it)("should verify customer token", async () => {
+            var _a;
+            if (!customerAccessToken)
+                return;
+            const verify = await client.verifyCustomerToken({ token: customerAccessToken });
+            (0, vitest_1.expect)((_a = verify === null || verify === void 0 ? void 0 : verify.customer) === null || _a === void 0 ? void 0 : _a.email).toBe(customerEmail);
+        });
+        (0, vitest_1.it)("should request customer recovery", async () => {
+            var _a;
+            const resetReq = await client.recoverCustomer({ email: customerEmail });
+            (0, vitest_1.expect)((_a = resetReq === null || resetReq === void 0 ? void 0 : resetReq.customerRecover) === null || _a === void 0 ? void 0 : _a.customerUserErrors).toBeDefined();
+        });
+        (0, vitest_1.it)("should fetch customer orders", async () => {
+            var _a, _b;
+            if (!customerAccessToken)
+                return;
+            const orders = await client.getCustomerOrders({
+                customerAccessToken,
+                first: 50,
+            });
+            (0, vitest_1.expect)((_b = (_a = orders === null || orders === void 0 ? void 0 : orders.customer) === null || _a === void 0 ? void 0 : _a.orders) === null || _b === void 0 ? void 0 : _b.edges).toBeDefined();
+        });
+    });
+    (0, vitest_1.describe)("Carts", () => {
+        (0, vitest_1.it)("should create a cart", async () => {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            if (!firstVariantId)
+                return;
+            const cart = await client.createCart({
+                input: {
+                    lines: [
+                        {
+                            quantity: 1,
+                            merchandiseId: firstVariantId,
+                        },
+                    ],
+                },
+                first: 20,
+            });
+            (0, vitest_1.expect)((_b = (_a = cart === null || cart === void 0 ? void 0 : cart.cartCreate) === null || _a === void 0 ? void 0 : _a.cart) === null || _b === void 0 ? void 0 : _b.id).toBeDefined();
+            if ((_d = (_c = cart === null || cart === void 0 ? void 0 : cart.cartCreate) === null || _c === void 0 ? void 0 : _c.cart) === null || _d === void 0 ? void 0 : _d.id) {
+                cartId = cart.cartCreate.cart.id;
+                lineItemId = (_h = (_g = (_f = (_e = cart.cartCreate.cart.lines) === null || _e === void 0 ? void 0 : _e.edges[0]) === null || _f === void 0 ? void 0 : _f.node) === null || _g === void 0 ? void 0 : _g.id) !== null && _h !== void 0 ? _h : "";
+            }
+        });
+        (0, vitest_1.it)("should update cart buyer identity", async () => {
+            var _a, _b;
+            if (!cartId || !customerAccessToken)
+                return;
+            const identity = await client.updateCartBuyerIdentity({
+                cartId: cartId,
+                buyerIdentity: {
+                    customerAccessToken: customerAccessToken,
+                    email: customerEmail,
+                    phone: "00000000000",
+                },
+            });
+            (0, vitest_1.expect)((_b = (_a = identity === null || identity === void 0 ? void 0 : identity.cartBuyerIdentityUpdate) === null || _a === void 0 ? void 0 : _a.cart) === null || _b === void 0 ? void 0 : _b.id).toBeDefined();
+        });
+        (0, vitest_1.it)("should fetch an existing cart", async () => {
+            var _a;
+            if (!cartId)
+                return;
+            const existingCart = await client.getCart({ cartId, first: 20 });
+            (0, vitest_1.expect)((_a = existingCart === null || existingCart === void 0 ? void 0 : existingCart.cart) === null || _a === void 0 ? void 0 : _a.id).toBe(cartId);
+        });
+        (0, vitest_1.it)("should add lines to a cart", async () => {
+            var _a, _b;
+            if (!cartId || !firstVariantId)
+                return;
+            const addToCart = await client.addCartLines({
+                cartId,
+                lines: [
+                    {
+                        quantity: 1,
+                        merchandiseId: firstVariantId,
+                    },
+                ],
+            });
+            (0, vitest_1.expect)((_b = (_a = addToCart === null || addToCart === void 0 ? void 0 : addToCart.cartLinesAdd) === null || _a === void 0 ? void 0 : _a.cart) === null || _b === void 0 ? void 0 : _b.id).toBeDefined();
+        });
+        (0, vitest_1.it)("should update lines in a cart", async () => {
+            var _a, _b;
+            if (!cartId || !firstVariantId || !lineItemId)
+                return;
+            const updatedCart = await client.updateCartLines({
+                cartId,
+                first: 20,
+                lines: [
+                    {
+                        id: lineItemId,
+                        quantity: 2,
+                        merchandiseId: firstVariantId,
+                    },
+                ],
+            });
+            (0, vitest_1.expect)((_b = (_a = updatedCart === null || updatedCart === void 0 ? void 0 : updatedCart.cartLinesUpdate) === null || _a === void 0 ? void 0 : _a.cart) === null || _b === void 0 ? void 0 : _b.id).toBeDefined();
+        });
+        (0, vitest_1.it)("should remove lines from a cart", async () => {
+            var _a, _b;
+            if (!cartId || !lineItemId)
+                return;
+            const removedCart = await client.removeCartLines({
+                cartId,
+                lineIds: [lineItemId],
+            });
+            (0, vitest_1.expect)((_b = (_a = removedCart === null || removedCart === void 0 ? void 0 : removedCart.cartLinesRemove) === null || _a === void 0 ? void 0 : _a.cart) === null || _b === void 0 ? void 0 : _b.id).toBeDefined();
+        });
+    });
+    (0, vitest_1.describe)("Shop Info", () => {
+        (0, vitest_1.it)("should fetch shop info using the dedicated method", async () => {
+            var _a;
+            const shopInfo = await client.getShopInfo();
+            (0, vitest_1.expect)((_a = shopInfo === null || shopInfo === void 0 ? void 0 : shopInfo.shop) === null || _a === void 0 ? void 0 : _a.name).toBeDefined();
+        });
+    });
+    (0, vitest_1.describe)("Custom Queries", () => {
+        (0, vitest_1.it)("should successfully execute a custom query", async () => {
+            var _a;
+            const customQuery = await client.customQuery(`query getShopInfo {
+            shop {
+              name
+              description
+              paymentSettings {
+                currencyCode
+                countryCode
+                enabledPresentmentCurrencies
+              }
+            }
+          }`, {});
+            (0, vitest_1.expect)((_a = customQuery === null || customQuery === void 0 ? void 0 : customQuery.shop) === null || _a === void 0 ? void 0 : _a.name).toBeDefined();
+        });
+    });
+});