shop-client 3.8.2 → 3.9.1

package/dist/collections.js

@@ -1,540 +1,8 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/collections.ts
-var collections_exports = {};
-__export(collections_exports, {
-  createCollectionOperations: () => createCollectionOperations
-});
-module.exports = __toCommonJS(collections_exports);
-var import_remeda = require("remeda");
-
-// src/utils/func.ts
-var import_tldts = require("tldts");
-function formatPrice(amountInCents, currency) {
-  try {
-    return new Intl.NumberFormat(void 0, {
-      style: "currency",
-      currency
-    }).format((amountInCents || 0) / 100);
-  } catch {
-    const val = (amountInCents || 0) / 100;
-    return `${val} ${currency}`;
-  }
-}
-
-// src/utils/rate-limit.ts
-var RateLimiter = class {
-  constructor(options) {
-    this.queue = [];
-    this.inFlight = 0;
-    this.refillTimer = null;
-    this.options = options;
-    this.tokens = options.maxRequestsPerInterval;
-  }
-  startRefill() {
-    if (this.refillTimer) return;
-    this.refillTimer = setInterval(() => {
-      this.tokens = this.options.maxRequestsPerInterval;
-      this.tryRun();
-    }, this.options.intervalMs);
-    if (this.refillTimer && typeof this.refillTimer.unref === "function") {
-      this.refillTimer.unref();
-    }
-  }
-  stopRefill() {
-    if (this.refillTimer) {
-      clearInterval(this.refillTimer);
-      this.refillTimer = null;
-    }
-  }
-  ensureRefillStarted() {
-    if (!this.refillTimer) {
-      this.startRefill();
-    }
-  }
-  configure(next) {
-    this.options = { ...this.options, ...next };
-    this.options.maxRequestsPerInterval = Math.max(
-      1,
-      this.options.maxRequestsPerInterval
-    );
-    this.options.intervalMs = Math.max(10, this.options.intervalMs);
-    this.options.maxConcurrency = Math.max(1, this.options.maxConcurrency);
-  }
-  schedule(fn) {
-    return new Promise((resolve, reject) => {
-      this.ensureRefillStarted();
-      this.queue.push({ fn, resolve, reject });
-      this.tryRun();
-    });
-  }
-  tryRun() {
-    while (this.queue.length > 0 && this.inFlight < this.options.maxConcurrency && this.tokens > 0) {
-      const task = this.queue.shift();
-      this.tokens -= 1;
-      this.inFlight += 1;
-      Promise.resolve().then(task.fn).then((result) => task.resolve(result)).catch((err) => task.reject(err)).finally(() => {
-        this.inFlight -= 1;
-        setTimeout(() => this.tryRun(), 0);
-      });
-    }
-  }
-};
-var enabled = false;
-var defaultOptions = {
-  maxRequestsPerInterval: 5,
-  // 5 requests
-  intervalMs: 1e3,
-  // per second
-  maxConcurrency: 5
-  // up to 5 in parallel
-};
-var limiter = new RateLimiter(defaultOptions);
-var hostLimiters = /* @__PURE__ */ new Map();
-var classLimiters = /* @__PURE__ */ new Map();
-function getHost(input) {
-  try {
-    if (typeof input === "string") {
-      return new URL(input).host;
-    }
-    if (input instanceof URL) {
-      return input.host;
-    }
-    const url = input.url;
-    if (url) {
-      return new URL(url).host;
-    }
-  } catch {
-  }
-  return void 0;
-}
-function getHostLimiter(host) {
-  if (!host) return void 0;
-  const exact = hostLimiters.get(host);
-  if (exact) return exact;
-  for (const [key, lim] of hostLimiters.entries()) {
-    if (key.startsWith("*.") && host.endsWith(key.slice(2))) {
-      return lim;
-    }
-  }
-  return void 0;
-}
-async function rateLimitedFetch(input, init) {
-  var _a;
-  if (!enabled) {
-    return fetch(input, init);
-  }
-  const klass = init == null ? void 0 : init.rateLimitClass;
-  const byClass = klass ? classLimiters.get(klass) : void 0;
-  const byHost = getHostLimiter(getHost(input));
-  const eff = (_a = byClass != null ? byClass : byHost) != null ? _a : limiter;
-  return eff.schedule(() => fetch(input, init));
-}
-
-// src/collections.ts
-function createCollectionOperations(baseUrl, storeDomain, fetchCollections, collectionsDto, fetchPaginatedProductsFromCollection, getStoreInfo, findCollection) {
-  function applyCurrencyOverride(product, currency) {
-    var _a, _b, _c, _d, _e, _f;
-    const priceMin = (_b = (_a = product.priceMin) != null ? _a : product.price) != null ? _b : 0;
-    const priceMax = (_d = (_c = product.priceMax) != null ? _c : product.price) != null ? _d : 0;
-    const compareAtMin = (_f = (_e = product.compareAtPriceMin) != null ? _e : product.compareAtPrice) != null ? _f : 0;
-    return {
-      ...product,
-      currency,
-      localizedPricing: {
-        currency,
-        priceFormatted: formatPrice(priceMin, currency),
-        priceMinFormatted: formatPrice(priceMin, currency),
-        priceMaxFormatted: formatPrice(priceMax, currency),
-        compareAtPriceFormatted: formatPrice(compareAtMin, currency)
-      }
-    };
-  }
-  function maybeOverrideProductsCurrency(products, currency) {
-    if (!products || !currency) return products;
-    return products.map((p) => applyCurrencyOverride(p, currency));
-  }
-  return {
-    /**
-     * Fetches collections with pagination support.
-     *
-     * @param options - Pagination options
-     * @param options.page - Page number (default: 1)
-     * @param options.limit - Number of collections per page (default: 10, max: 250)
-     *
-     * @returns {Promise<Collection[] | null>} Collections for the requested page, or null on error
-     */
-    paginated: async (options) => {
-      var _a, _b;
-      const page = (_a = options == null ? void 0 : options.page) != null ? _a : 1;
-      const limit = (_b = options == null ? void 0 : options.limit) != null ? _b : 10;
-      if (page < 1 || limit < 1 || limit > 250) {
-        throw new Error(
-          "Invalid pagination parameters: page must be >= 1, limit must be between 1 and 250"
-        );
-      }
-      try {
-        const collections = await fetchCollections(page, limit);
-        return collections != null ? collections : null;
-      } catch (error) {
-        console.error(
-          "Failed to fetch paginated collections:",
-          storeDomain,
-          error
-        );
-        return null;
-      }
-    },
-    /**
-     * Fetches all collections from the store across all pages.
-     *
-     * @returns {Promise<Collection[]>} Array of all collections
-     *
-     * @throws {Error} When there's a network error or API failure
-     *
-     * @example
-     * ```typescript
-     * const shop = new ShopClient('https://exampleshop.com');
-     * const allCollections = await shop.collections.all();
-     *
-     * console.log(`Found ${allCollections.length} collections`);
-     * allCollections.forEach(collection => {
-     *   console.log(collection.title, collection.handle);
-     * });
-     * ```
-     */
-    all: async () => {
-      const limit = 250;
-      const allCollections = [];
-      async function fetchAll() {
-        let currentPage = 1;
-        while (true) {
-          const collections = await fetchCollections(currentPage, limit);
-          if (!collections || collections.length === 0 || collections.length < limit) {
-            if (!collections) {
-              console.warn(
-                "fetchCollections returned null, treating as empty array."
-              );
-              break;
-            }
-            if (collections && collections.length > 0) {
-              allCollections.push(...collections);
-            }
-            break;
-          }
-          allCollections.push(...collections);
-          currentPage++;
-        }
-        return allCollections;
-      }
-      try {
-        const collections = await fetchAll();
-        return collections || [];
-      } catch (error) {
-        console.error("Failed to fetch all collections:", storeDomain, error);
-        throw error;
-      }
-    },
-    /**
-     * Finds a specific collection by its handle.
-     *
-     * @param collectionHandle - The collection handle (URL slug) to search for
-     *
-     * @returns {Promise<Collection | null>} The collection if found, null if not found
-     *
-     * @throws {Error} When the handle is invalid or there's a network error
-     *
-     * @example
-     * ```typescript
-     * const shop = new ShopClient('https://example.myshopify.com');
-     * const collection = await shop.collections.find('summer-collection');
-     * if (collection) {
-     *   console.log(collection.title); // "Summer Collection"
-     * }
-     * ```
-     */
-    find: async (collectionHandle) => {
-      var _a, _b;
-      if (!collectionHandle || typeof collectionHandle !== "string") {
-        throw new Error("Collection handle is required and must be a string");
-      }
-      const sanitizedHandle = collectionHandle.trim().replace(/[^a-zA-Z0-9\-_]/g, "");
-      if (!sanitizedHandle) {
-        throw new Error("Invalid collection handle format");
-      }
-      if (sanitizedHandle.length > 255) {
-        throw new Error("Collection handle is too long");
-      }
-      try {
-        const url = `${baseUrl}collections/${encodeURIComponent(sanitizedHandle)}.json`;
-        const response = await rateLimitedFetch(url);
-        if (!response.ok) {
-          if (response.status === 404) {
-            return null;
-          }
-          throw new Error(`HTTP error! status: ${response.status}`);
-        }
-        const result = await response.json();
-        let collectionImage = result.collection.image;
-        if (!collectionImage) {
-          const collectionProduct = (_a = await fetchPaginatedProductsFromCollection(
-            result.collection.handle,
-            {
-              limit: 1,
-              page: 1
-            }
-          )) == null ? void 0 : _a.at(0);
-          const collectionProductImage = (_b = collectionProduct == null ? void 0 : collectionProduct.images) == null ? void 0 : _b[0];
-          if (collectionProduct && collectionProductImage) {
-            collectionImage = {
-              id: collectionProductImage.id,
-              src: collectionProductImage.src,
-              alt: collectionProductImage.alt || collectionProduct.title,
-              created_at: collectionProductImage.createdAt || (/* @__PURE__ */ new Date()).toISOString()
-            };
-          }
-        }
-        const collectionData = collectionsDto([
-          {
-            ...result.collection,
-            image: collectionImage
-          }
-        ]);
-        return collectionData[0] || null;
-      } catch (error) {
-        if (error instanceof Error) {
-          console.error(
-            `Error fetching collection ${sanitizedHandle}:`,
-            baseUrl,
-            error.message
-          );
-        }
-        throw error;
-      }
-    },
-    /**
-     * Fetches collections that are showcased/featured on the store's homepage.
-     *
-     * @returns {Promise<Collection[]>} Array of showcased collections found on the homepage
-     *
-     * @throws {Error} When there's a network error or API failure
-     *
-     * @example
-     * ```typescript
-     * const shop = new ShopClient('https://exampleshop.com');
-     * const showcasedCollections = await shop.collections.showcased();
-     *
-     * console.log(`Found ${showcasedCollections.length} showcased collections`);
-     * showcasedCollections.forEach(collection => {
-     *   console.log(`Featured: ${collection.title} - ${collection.productsCount} products`);
-     * });
-     * ```
-     */
-    showcased: async () => {
-      const storeInfo = await getStoreInfo();
-      const collections = await Promise.all(
-        storeInfo.showcase.collections.map(
-          (collectionHandle) => findCollection(collectionHandle)
-        )
-      );
-      return (0, import_remeda.filter)(collections, import_remeda.isNonNullish);
-    },
-    products: {
-      /**
-       * Fetches products from a specific collection with pagination support.
-       *
-       * @param collectionHandle - The collection handle to fetch products from
-       * @param options - Pagination options
-       * @param options.page - Page number (default: 1)
-       * @param options.limit - Number of products per page (default: 250, max: 250)
-       *
-       * @returns {Promise<Product[] | null>} Array of products from the collection or null if error occurs
-       *
-       * @throws {Error} When the collection handle is invalid or there's a network error
-       *
-       * @example
-       * ```typescript
-       * const shop = new ShopClient('https://example.myshopify.com');
-       *
-       * // Get first page of products from a collection
-       * const products = await shop.collections.products.paginated('summer-collection');
-       *
-       * // Get second page with custom limit
-       * const moreProducts = await shop.collections.products.paginated(
-       *   'summer-collection',
-       *   { page: 2, limit: 50 }
-       * );
-       * ```
-       */
-      paginated: async (collectionHandle, options) => {
-        var _a, _b;
-        if (!collectionHandle || typeof collectionHandle !== "string") {
-          throw new Error("Collection handle is required and must be a string");
-        }
-        const sanitizedHandle = collectionHandle.trim().replace(/[^a-zA-Z0-9\-_]/g, "");
-        if (!sanitizedHandle) {
-          throw new Error("Invalid collection handle format");
-        }
-        if (sanitizedHandle.length > 255) {
-          throw new Error("Collection handle is too long");
-        }
-        const page = (_a = options == null ? void 0 : options.page) != null ? _a : 1;
-        const limit = (_b = options == null ? void 0 : options.limit) != null ? _b : 250;
-        if (page < 1 || limit < 1 || limit > 250) {
-          throw new Error(
-            "Invalid pagination parameters: page must be >= 1, limit must be between 1 and 250"
-          );
-        }
-        const products = await fetchPaginatedProductsFromCollection(
-          sanitizedHandle,
-          { page, limit }
-        );
-        return maybeOverrideProductsCurrency(products, options == null ? void 0 : options.currency);
-      },
-      /**
-       * Fetches all products from a specific collection.
-       *
-       * @param collectionHandle - The collection handle to fetch products from
-       *
-       * @returns {Promise<Product[] | null>} Array of all products from the collection or null if error occurs
-       *
-       * @throws {Error} When the collection handle is invalid or there's a network error
-       *
-       * @example
-       * ```typescript
-       * const shop = new ShopClient('https://exampleshop.com');
-       * const allProducts = await shop.collections.products.all('summer-collection');
-       *
-       * if (allProducts) {
-       *   console.log(`Found ${allProducts.length} products in the collection`);
-       *   allProducts.forEach(product => {
-       *     console.log(`${product.title} - $${product.price}`);
-       *   });
-       * }
-       * ```
-       */
-      all: async (collectionHandle, options) => {
-        if (!collectionHandle || typeof collectionHandle !== "string") {
-          throw new Error("Collection handle is required and must be a string");
-        }
-        const sanitizedHandle = collectionHandle.trim().replace(/[^a-zA-Z0-9\-_]/g, "");
-        if (!sanitizedHandle) {
-          throw new Error("Invalid collection handle format");
-        }
-        if (sanitizedHandle.length > 255) {
-          throw new Error("Collection handle is too long");
-        }
-        try {
-          const limit = 250;
-          const allProducts = [];
-          let currentPage = 1;
-          while (true) {
-            const products = await fetchPaginatedProductsFromCollection(
-              sanitizedHandle,
-              {
-                page: currentPage,
-                limit
-              }
-            );
-            if (!products || products.length === 0 || products.length < limit) {
-              if (products && products.length > 0) {
-                allProducts.push(...products);
-              }
-              break;
-            }
-            allProducts.push(...products);
-            currentPage++;
-          }
-          return maybeOverrideProductsCurrency(allProducts, options == null ? void 0 : options.currency);
-        } catch (error) {
-          console.error(
-            `Error fetching all products for collection ${sanitizedHandle}:`,
-            baseUrl,
-            error
-          );
-          return null;
-        }
-      },
-      /**
-       * Fetches all product slugs from a specific collection.
-       *
-       * @param collectionHandle - The collection handle to fetch product slugs from
-       *
-       * @returns {Promise<string[] | null>} Array of product slugs from the collection or null if error occurs
-       *
-       * @throws {Error} When the collection handle is invalid or there's a network error
-       *
-       * @example
-       * ```typescript
-       * const shop = new ShopClient('https://exampleshop.com');
-       * const productSlugs = await shop.collections.products.slugs('summer-collection');
-       * console.log(productSlugs);
-       * ```
-       */
-      slugs: async (collectionHandle) => {
-        if (!collectionHandle || typeof collectionHandle !== "string") {
-          throw new Error("Collection handle is required and must be a string");
-        }
-        const sanitizedHandle = collectionHandle.trim().replace(/[^a-zA-Z0-9\-_]/g, "");
-        if (!sanitizedHandle) {
-          throw new Error("Invalid collection handle format");
-        }
-        if (sanitizedHandle.length > 255) {
-          throw new Error("Collection handle is too long");
-        }
-        try {
-          const limit = 250;
-          const slugs = [];
-          let currentPage = 1;
-          while (true) {
-            const products = await fetchPaginatedProductsFromCollection(
-              sanitizedHandle,
-              {
-                page: currentPage,
-                limit
-              }
-            );
-            if (!products || products.length === 0 || products.length < limit) {
-              if (products && products.length > 0) {
-                slugs.push(...products.map((p) => p.slug));
-              }
-              break;
-            }
-            slugs.push(...products.map((p) => p.slug));
-            currentPage++;
-          }
-          return slugs;
-        } catch (error) {
-          console.error(
-            `Error fetching product slugs for collection ${sanitizedHandle}:`,
-            baseUrl,
-            error
-          );
-          return null;
-        }
-      }
-    }
-  };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
+import {
+  createCollectionOperations
+} from "./chunk-MOBWPEY4.js";
+import "./chunk-2MF53V33.js";
+import "./chunk-CN7L3BHG.js";
+export {
   createCollectionOperations
-});
-//# sourceMappingURL=collections.js.map
+};