shop-client 3.8.2 → 3.9.1

package/dist/index.d.ts

@@ -1,97 +1,20 @@
 import { CheckoutOperations } from './checkout.js';
 import { CollectionOperations } from './collections.js';
 import { ProductOperations } from './products.js';
-import { P as ProductClassification, S as SEOContent, C as CountryDetectionResult, a as StoreOperations, b as ShopifyProduct, c as Product, d as ShopifySingleProduct, e as ShopifyCollection, f as Collection, g as StoreInfo, h as StoreTypeBreakdown } from './store-CJVUz2Yb.js';
-export { H as Address, F as CatalogCategory, I as ContactUrls, K as CountryScore, N as CountryScores, J as Coupon, y as CurrencyCode, G as Demographics, Q as JsonLdEntry, L as LocalizedPricing, M as MetaTag, D as ProductImage, z as ProductOption, x as ProductPricing, B as ProductVariant, A as ProductVariantImage, E as ShopifyApiProduct, u as ShopifyBaseProduct, r as ShopifyBaseVariant, k as ShopifyBasicInfo, o as ShopifyFeaturedMedia, O as ShopifyFeaturesData, m as ShopifyImage, l as ShopifyImageDimensions, p as ShopifyMedia, q as ShopifyOption, w as ShopifyPredictiveProductSearch, v as ShopifyProductAndStore, s as ShopifyProductVariant, t as ShopifySingleProductVariant, j as ShopifyTimestamps, n as ShopifyVariantImage, i as StoreCatalog, R as StoreTypeResult, V as ValidStoreCatalog } from './store-CJVUz2Yb.js';
+import { StoreOperations, StoreInfo } from './store.js';
+import { S as ShopifyProduct, P as Product, a as ShopifySingleProduct, b as ShopifyCollection, C as Collection, c as StoreTypeBreakdown } from './types-luPg5O08.js';
+export { d as CountryDetectionResult, e as CountryScores, f as CurrencyCode, L as LocalizedPricing, M as MetaTag, g as ProductImage, h as ProductOption, i as ProductVariant, j as ProductVariantImage } from './types-luPg5O08.js';
+export { classifyProduct, generateSEOContent } from './ai/enrich.js';
+export { detectShopCountry } from './utils/detect-country.js';
+export { calculateDiscount, extractDomainWithoutSuffix, genProductSlug, generateStoreSlug, safeParseDate, sanitizeDomain } from './utils/func.js';
 export { configureRateLimit } from './utils/rate-limit.js';
 
-/**
- * Classify product content into a three-tier hierarchy using LLM.
- * Returns strictly validated JSON with audience, vertical, and optional category/subCategory.
- */
-declare function classifyProduct(productContent: string, options?: {
-    apiKey?: string;
-    model?: string;
-}): Promise<ProductClassification>;
-/**
- * Generate SEO and marketing content for a product. Returns strictly validated JSON.
- */
-declare function generateSEOContent(product: {
-    title: string;
-    description?: string;
-    vendor?: string;
-    price?: number;
-    tags?: string[];
-}, options?: {
-    apiKey?: string;
-    model?: string;
-}): Promise<SEOContent>;
-
-/**
- * Detects the country of a Shopify store by analyzing various signals in the HTML content.
- *
- * This function examines multiple data sources within the HTML to determine the store's country:
- * - Shopify features JSON data (country, locale, money format)
- * - Phone number prefixes in contact information
- * - JSON-LD structured data with address information
- * - Footer mentions of country names
- * - Currency symbols in money formatting
- *
- * @param html - The HTML content of the Shopify store's homepage
- * @returns Promise resolving to country detection results containing:
- * - `country` - The detected country ISO 3166-1 alpha-2 code (e.g., "US", "GB") or "Unknown" if no reliable detection
- * - `confidence` - Confidence score between 0 and 1 (higher = more confident)
- * - `signals` - Array of detection signals that contributed to the result
- *
- * @example
- * ```typescript
- * const response = await fetch('https://exampleshop.com');
- * const html = await response.text();
- * const result = await detectShopifyCountry(html);
- *
- * console.log(result.country); // "US" (ISO code for United States)
- * console.log(result.confidence); // 0.85
- * console.log(result.signals); // ["shopify-features.country", "phone prefix +1"]
- * ```
- */
-declare function detectShopifyCountry(html: string): Promise<CountryDetectionResult>;
-
-declare function extractDomainWithoutSuffix(domain: string): string | null;
-declare function generateStoreSlug(domain: string): string;
-declare const genProductSlug: ({ handle, storeDomain, }: {
-    handle: string;
-    storeDomain: string;
-}) => string;
-declare const calculateDiscount: (price: number, compareAtPrice?: number) => number;
-/**
- * Normalize and sanitize a domain string.
- *
- * Accepts inputs like full URLs, protocol-relative URLs, bare hostnames,
- * or strings with paths/query/fragment, and returns a normalized domain.
- *
- * Examples:
- *  - "https://WWW.Example.com/path" -> "example.com"
- *  - "//sub.example.co.uk" -> "example.co.uk"
- *  - "www.example.com:8080" -> "example.com"
- *  - "example" -> "example"
- */
-declare function sanitizeDomain(input: string, opts?: {
-    stripWWW?: boolean;
-}): string;
-/**
- * Safely parse a date string into a Date object.
- *
- * Returns `undefined` when input is falsy or cannot be parsed into a valid date.
- * Use `|| null` at call sites that expect `null` instead of `undefined`.
- */
-declare function safeParseDate(input?: string | null): Date | undefined;
-
 /**
  * A comprehensive Shopify store client for fetching products, collections, and store information.
  *
  * @example
  * ```typescript
- * import { ShopClient } from 'shop-search';
+ * import { ShopClient } from 'shop-client';
  *
  * const shop = new ShopClient('https://exampleshop.com');
  *
@@ -102,6 +25,9 @@ declare function safeParseDate(input?: string | null): Date | undefined;
  * const storeInfo = await shop.getInfo();
  * ```
  */
+type ShopClientOptions = {
+    cacheTTL?: number;
+};
 declare class ShopClient {
     private storeDomain;
     private baseUrl;
@@ -111,6 +37,9 @@ declare class ShopClient {
     private cacheTimestamps;
     private normalizeImageUrlCache;
     private storeCurrency?;
+    private infoCacheValue?;
+    private infoCacheTimestamp?;
+    private infoInFlight?;
     products: ProductOperations;
     collections: CollectionOperations;
     checkout: CheckoutOperations;
@@ -135,7 +64,7 @@ declare class ShopClient {
      * const shop2 = new ShopClient('https://boutique.fashion');
      * ```
      */
-    constructor(urlPath: string);
+    constructor(urlPath: string, options?: ShopClientOptions);
     /**
      * Optimized image URL normalization with caching
      */
@@ -217,7 +146,19 @@ declare class ShopClient {
      * console.log(storeInfo.country); // "US"
      * ```
      */
-    getInfo(): Promise<StoreInfo>;
+    /**
+     * Optionally bypass cache and force a fresh fetch.
+     *
+     * @param options - `{ force?: boolean }` when `true`, ignores cached value and TTL.
+     */
+    getInfo(options?: {
+        force?: boolean;
+    }): Promise<StoreInfo>;
+    /**
+     * Manually clear the cached store info.
+     * The next call to `getInfo()` will fetch fresh data regardless of TTL.
+     */
+    clearInfoCache(): void;
     /**
      * Determine the store's primary vertical and target audience.
      * Uses `getInfo()` internally; no input required.
@@ -230,4 +171,4 @@ declare class ShopClient {
     }): Promise<StoreTypeBreakdown>;
 }
 
-export { CheckoutOperations, Collection, CollectionOperations, CountryDetectionResult, Product, ProductClassification, ProductOperations, SEOContent, ShopClient, ShopifyCollection, ShopifyProduct, ShopifySingleProduct, StoreInfo, StoreOperations, StoreTypeBreakdown, calculateDiscount, classifyProduct, detectShopifyCountry, extractDomainWithoutSuffix, genProductSlug, generateSEOContent, generateStoreSlug, safeParseDate, sanitizeDomain };
+export { CheckoutOperations, Collection, CollectionOperations, Product, ProductOperations, ShopClient, type ShopClientOptions, StoreInfo, StoreOperations, StoreTypeBreakdown };