shop-client 3.9.0 → 3.9.2

package/dist/products.d.ts

@@ -1,4 +1,5 @@
-import { y as CurrencyCode, c as Product, P as ProductClassification, S as SEOContent, b as ShopifyProduct, d as ShopifySingleProduct, g as StoreInfo } from './store-iQARl6J3.js';
+import { StoreInfo } from './store.js';
+import { f as CurrencyCode, P as Product, k as ProductClassification, l as SEOContent, S as ShopifyProduct, a as ShopifySingleProduct } from './types-luPg5O08.js';
 
 /**
  * Interface for product operations

package/dist/products.js

@@ -0,0 +1,8 @@
+import {
+  createProductOperations
+} from "./chunk-CXUCPK6X.js";
+import "./chunk-2MF53V33.js";
+import "./chunk-CN7L3BHG.js";
+export {
+  createProductOperations
+};

package/dist/store.d.ts

@@ -1 +1,53 @@
-export { g as StoreInfo, a as StoreOperations, T as createStoreOperations } from './store-iQARl6J3.js';
+import { J as JsonLdEntry, d as CountryDetectionResult } from './types-luPg5O08.js';
+
+/**
+ * Store operations interface for managing store-related functionality.
+ * Provides methods to fetch comprehensive store information and metadata.
+ */
+interface StoreOperations {
+    info(): Promise<StoreInfo>;
+}
+/**
+ * Comprehensive store information structure returned by the info method.
+ * Contains all metadata, branding, social links, and showcase content for a Shopify store.
+ */
+interface StoreInfo {
+    name: string;
+    domain: string;
+    slug: string;
+    title: string | null;
+    description: string | null;
+    logoUrl: string | null;
+    socialLinks: Record<string, string>;
+    contactLinks: {
+        tel: string | null;
+        email: string | null;
+        contactPage: string | null;
+    };
+    headerLinks: string[];
+    showcase: {
+        products: string[];
+        collections: string[];
+    };
+    jsonLdData: JsonLdEntry[] | undefined;
+    techProvider: {
+        name: string;
+        walletId: string | undefined;
+        subDomain: string | null;
+    };
+    country: CountryDetectionResult["country"];
+}
+/**
+ * Creates store operations for a ShopClient instance.
+ * @param context - ShopClient context containing necessary methods and properties for store operations
+ */
+declare function createStoreOperations(context: {
+    baseUrl: string;
+    storeDomain: string;
+    validateProductExists: (handle: string) => Promise<boolean>;
+    validateCollectionExists: (handle: string) => Promise<boolean>;
+    validateLinksInBatches: <T>(items: T[], validator: (item: T) => Promise<boolean>, batchSize?: number) => Promise<T[]>;
+    handleFetchError: (error: unknown, context: string, url: string) => never;
+}): StoreOperations;
+
+export { type StoreInfo, type StoreOperations, createStoreOperations };

package/dist/store.js

@@ -0,0 +1,9 @@
+import {
+  createStoreOperations
+} from "./chunk-DJQEZNHG.js";
+import "./chunk-2MF53V33.js";
+import "./chunk-QUDGES3A.js";
+import "./chunk-CN7L3BHG.js";
+export {
+  createStoreOperations
+};

package/dist/{store-iQARl6J3.d.ts → types-luPg5O08.d.ts}

@@ -1,41 +1,3 @@
-/**
- * @fileoverview Type definitions for the shop-client package.
- *
- * This file contains all TypeScript type definitions used throughout the shop-client library,
- * including Shopify API response types, normalized product/collection types, and utility types.
- *
- * @author shop-client
- */
-type RequireAtLeastOne<T> = {
-    [K in keyof T]-?: Required<Pick<T, K>> & Partial<Omit<T, K>>;
-}[keyof T];
-/**
- * Supported audience demographics for product categorization.
- */
-type Audience = "adult_male" | "adult_female" | "kid_male" | "kid_female" | "adult_unisex" | "kid_unisex";
-/**
- * Product category structure for organizing store inventory.
- */
-type Category = {
-    clothing?: string[];
-    jewellery?: string[];
-    accessories?: string[];
-};
-/**
- * Special category for non-demographic specific products.
- */
-type NoneCategory = {
-    home_decor: string[];
-    accessories: string[];
-};
-/**
- * Complete store catalog structure with demographic-based categorization.
- */
-type StoreCatalog = RequireAtLeastOne<{
-    [K in Audience]: RequireAtLeastOne<Category>;
-}> & {
-    none: RequireAtLeastOne<NoneCategory>;
-};
 /**
  * Base timestamp fields used across Shopify entities.
  */
@@ -183,10 +145,6 @@ type ShopifyProduct = ShopifyBaseProduct & {
     variants: ShopifyProductVariant[];
     images: ShopifyImage[];
 };
-/**
- * Alias for ShopifyProduct with store context.
- */
-type ShopifyProductAndStore = ShopifyProduct;
 /**
  * Enhanced single product structure with additional pricing and availability data.
  */
@@ -212,33 +170,6 @@ type ShopifySingleProduct = ShopifyBaseProduct & {
     requires_selling_plan?: boolean;
     selling_plan_groups?: string[];
 };
-/**
- * Shopify predictive search API response structure.
- */
-type ShopifyPredictiveProductSearch = {
-    resources: {
-        results: {
-            products: Array<Omit<ShopifySingleProduct, "description"> & {
-                body: string;
-            }>;
-        };
-    };
-};
-/**
- * Normalized pricing information for products.
- */
-type ProductPricing = {
-    price: number;
-    priceMin: number;
-    priceMax: number;
-    priceVaries: boolean;
-    compareAtPrice: number;
-    compareAtPriceMin: number;
-    compareAtPriceMax: number;
-    compareAtPriceVaries: boolean;
-    discount: number;
-    currency?: string;
-};
 /**
  * Localized/display pricing with currency-aware formatted strings.
  */
@@ -377,80 +308,6 @@ type Product = {
     variantOptionsMap: Record<string, string>;
     enriched_content?: string;
 };
-/**
- * Alternative product structure for API responses with normalized field names.
- */
-type ShopifyApiProduct = ShopifyBasicInfo & {
-    bodyHtml: string;
-    body?: string | undefined;
-    publishedAt: string;
-    createdAt?: string | undefined;
-    updatedAt?: string | undefined;
-    vendor: string;
-    productType: string;
-    tags: string[];
-    variants: (Omit<ShopifyBaseVariant, "id"> & {
-        id: number;
-        name?: string | undefined;
-        title: string;
-        featuredImage: ProductVariantImage | null;
-        available: boolean;
-        price: number;
-        weightInGrams?: number | undefined;
-        compareAtPrice: number;
-        position: number;
-        productId: number;
-        createdAt?: string | undefined;
-        updatedAt?: string | undefined;
-    })[];
-    images: ProductImage[];
-    options: ShopifyOption[];
-};
-/**
- * Product category structure for store catalogs.
- */
-type CatalogCategory = {
-    clothing?: string[] | undefined;
-    jewellery?: string[] | undefined;
-    accessories?: string[] | undefined;
-};
-/**
- * Demographic categories for product targeting.
- */
-type Demographics = "adult_male" | "adult_female" | "adult_unisex" | "kid_male" | "kid_female" | "kid_unisex";
-/**
- * Valid store catalog structure with demographic-based organization.
- */
-type ValidStoreCatalog = {
-    [key in Demographics]?: CatalogCategory | undefined;
-};
-/**
- * Physical address structure for shipping and contact information.
- */
-type Address = {
-    addressLine1: string;
-    addressLine2?: string | undefined;
-    city: string;
-    state: string;
-    code: string;
-    country: string;
-    label?: string | undefined;
-};
-/**
- * Contact URL structure for store communication channels.
- */
-type ContactUrls = {
-    whatsapp?: string | undefined;
-    tel?: string | undefined;
-    email?: string | undefined;
-};
-/**
- * Coupon/discount code structure.
- */
-type Coupon = {
-    label: string;
-    description?: string | undefined;
-};
 /**
  * Shopify collection structure from API responses.
  */
@@ -503,15 +360,6 @@ type CountryScore = {
 type CountryScores = {
     [country: string]: CountryScore;
 };
-/**
- * Shopify features data structure from script tags.
- */
-type ShopifyFeaturesData = {
-    country?: string;
-    locale?: string;
-    moneyFormat?: string;
-    [key: string]: unknown;
-};
 type JsonLdEntry = Record<string, unknown>;
 type Collection = {
     id: string;
@@ -548,61 +396,6 @@ type SEOContent = {
     tags: string[];
     marketingCopy: string;
 };
-type StoreTypeResult = {
-    vertical: "clothing" | "beauty" | "accessories" | "home-decor" | "food-and-beverages";
-    audience: "adult_male" | "adult_female" | "kid_male" | "kid_female" | "generic";
-    reason: string;
-};
 type StoreTypeBreakdown = Partial<Record<"adult_male" | "adult_female" | "kid_male" | "kid_female" | "generic", Partial<Record<"clothing" | "beauty" | "accessories" | "home-decor" | "food-and-beverages", string[]>>>>;
 
-/**
- * Store operations interface for managing store-related functionality.
- * Provides methods to fetch comprehensive store information and metadata.
- */
-interface StoreOperations {
-    info(): Promise<StoreInfo>;
-}
-/**
- * Comprehensive store information structure returned by the info method.
- * Contains all metadata, branding, social links, and showcase content for a Shopify store.
- */
-interface StoreInfo {
-    name: string;
-    domain: string;
-    slug: string;
-    title: string | null;
-    description: string | null;
-    logoUrl: string | null;
-    socialLinks: Record<string, string>;
-    contactLinks: {
-        tel: string | null;
-        email: string | null;
-        contactPage: string | null;
-    };
-    headerLinks: string[];
-    showcase: {
-        products: string[];
-        collections: string[];
-    };
-    jsonLdData: JsonLdEntry[] | undefined;
-    techProvider: {
-        name: string;
-        walletId: string | undefined;
-        subDomain: string | null;
-    };
-    country: CountryDetectionResult["country"];
-}
-/**
- * Creates store operations for a ShopClient instance.
- * @param context - ShopClient context containing necessary methods and properties for store operations
- */
-declare function createStoreOperations(context: {
-    baseUrl: string;
-    storeDomain: string;
-    validateProductExists: (handle: string) => Promise<boolean>;
-    validateCollectionExists: (handle: string) => Promise<boolean>;
-    validateLinksInBatches: <T>(items: T[], validator: (item: T) => Promise<boolean>, batchSize?: number) => Promise<T[]>;
-    handleFetchError: (error: unknown, context: string, url: string) => never;
-}): StoreOperations;
-
-export { type ProductVariantImage as A, type ProductVariant as B, type CountryDetectionResult as C, type ProductImage as D, type ShopifyApiProduct as E, type CatalogCategory as F, type Demographics as G, type Address as H, type ContactUrls as I, type Coupon as J, type CountryScore as K, type LocalizedPricing as L, type MetaTag as M, type CountryScores as N, type ShopifyFeaturesData as O, type ProductClassification as P, type JsonLdEntry as Q, type StoreTypeResult as R, type SEOContent as S, createStoreOperations as T, type ValidStoreCatalog as V, type StoreOperations as a, type ShopifyProduct as b, type Product as c, type ShopifySingleProduct as d, type ShopifyCollection as e, type Collection as f, type StoreInfo as g, type StoreTypeBreakdown as h, type StoreCatalog as i, type ShopifyTimestamps as j, type ShopifyBasicInfo as k, type ShopifyImageDimensions as l, type ShopifyImage as m, type ShopifyVariantImage as n, type ShopifyFeaturedMedia as o, type ShopifyMedia as p, type ShopifyOption as q, type ShopifyBaseVariant as r, type ShopifyProductVariant as s, type ShopifySingleProductVariant as t, type ShopifyBaseProduct as u, type ShopifyProductAndStore as v, type ShopifyPredictiveProductSearch as w, type ProductPricing as x, type CurrencyCode as y, type ProductOption as z };
+export type { Collection as C, JsonLdEntry as J, LocalizedPricing as L, MetaTag as M, Product as P, ShopifyProduct as S, ShopifySingleProduct as a, ShopifyCollection as b, StoreTypeBreakdown as c, CountryDetectionResult as d, CountryScores as e, CurrencyCode as f, ProductImage as g, ProductOption as h, ProductVariant as i, ProductVariantImage as j, ProductClassification as k, SEOContent as l };

package/dist/utils/detect-country.d.ts

@@ -0,0 +1,32 @@
+import { d as CountryDetectionResult } from '../types-luPg5O08.js';
+
+/**
+ * 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 detectShopCountry(html: string): Promise<CountryDetectionResult>;
+
+export { detectShopCountry };

package/dist/utils/detect-country.js

@@ -0,0 +1,6 @@
+import {
+  detectShopCountry
+} from "../chunk-QUDGES3A.js";
+export {
+  detectShopCountry
+};

package/dist/utils/func.d.ts

@@ -0,0 +1,61 @@
+import { f as CurrencyCode } from '../types-luPg5O08.js';
+
+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;
+/**
+ * Normalize an option name or value to a lowercase, underscore-separated key.
+ */
+declare function normalizeKey(input: string): string;
+/**
+ * Build a map from normalized option combination → variant id strings.
+ * Example key: `size#xl##color#blue`.
+ */
+declare function buildVariantOptionsMap(optionNames: string[], variants: Array<{
+    id: number;
+    option1: string | null;
+    option2: string | null;
+    option3: string | null;
+}>): Record<string, string>;
+/**
+ * Build a normalized variant key string from an object of option name → value.
+ * - Normalizes both names and values using `normalizeKey`
+ * - Sorts parts alphabetically for deterministic output
+ * - Joins parts using `##` and uses `name#value` for each part
+ *
+ * Example output: `color#blue##size#xl`
+ */
+declare function buildVariantKey(obj: Record<string, string | null | undefined>): string;
+/**
+ * Format a price amount (in cents) using a given ISO 4217 currency code.
+ * Falls back to a simple string when Intl formatting fails.
+ */
+declare function formatPrice(amountInCents: number, currency: CurrencyCode): string;
+
+export { buildVariantKey, buildVariantOptionsMap, calculateDiscount, extractDomainWithoutSuffix, formatPrice, genProductSlug, generateStoreSlug, normalizeKey, safeParseDate, sanitizeDomain };

package/dist/utils/func.js

@@ -0,0 +1,24 @@
+import {
+  buildVariantKey,
+  buildVariantOptionsMap,
+  calculateDiscount,
+  extractDomainWithoutSuffix,
+  formatPrice,
+  genProductSlug,
+  generateStoreSlug,
+  normalizeKey,
+  safeParseDate,
+  sanitizeDomain
+} from "../chunk-CN7L3BHG.js";
+export {
+  buildVariantKey,
+  buildVariantOptionsMap,
+  calculateDiscount,
+  extractDomainWithoutSuffix,
+  formatPrice,
+  genProductSlug,
+  generateStoreSlug,
+  normalizeKey,
+  safeParseDate,
+  sanitizeDomain
+};

package/dist/utils/rate-limit.js

@@ -0,0 +1,10 @@
+import {
+  configureRateLimit,
+  getRateLimitStatus,
+  rateLimitedFetch
+} from "../chunk-2MF53V33.js";
+export {
+  configureRateLimit,
+  getRateLimitStatus,
+  rateLimitedFetch
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shop-client",
-  "version": "3.9.0",
+  "version": "3.9.2",
   "type": "module",
   "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",
@@ -10,6 +10,10 @@
       "import": "./dist/index.mjs",
       "types": "./dist/index.d.ts"
     },
+    "./enrich": {
+      "import": "./dist/ai/enrich.mjs",
+      "types": "./dist/ai/enrich.d.ts"
+    },
     "./products": {
       "import": "./dist/products.mjs",
       "types": "./dist/products.d.ts"
@@ -29,6 +33,14 @@
     "./rate-limit": {
       "import": "./dist/utils/rate-limit.mjs",
       "types": "./dist/utils/rate-limit.d.ts"
+    },
+    "./func": {
+      "import": "./dist/utils/func.mjs",
+      "types": "./dist/utils/func.d.ts"
+    },
+    "./detect-country": {
+      "import": "./dist/utils/detect-country.mjs",
+      "types": "./dist/utils/detect-country.d.ts"
     }
   },
   "sideEffects": false,
@@ -46,6 +58,7 @@
     "test": "bun test",
     "test:ci": "bun test --coverage",
     "docs:build": "typedoc",
+    "docs:site": "typedoc --options typedoc.pages.json",
     "semantic-release": "semantic-release",
     "format": "biome format --write --no-errors-on-unmatched",
     "lint": "biome lint --diagnostic-level=error --no-errors-on-unmatched . && tsc --noEmit -p tsconfig.json",
@@ -88,8 +101,8 @@
     "husky": "^9.1.7",
     "lint-staged": "^16.2.7",
     "semantic-release": "^25.0.2",
-    "typedoc": "^0.25.7",
-    "typedoc-plugin-markdown": "^4.0.0",
+    "typedoc": "^0.28.0",
+    "typedoc-plugin-markdown": "^4.9.0",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   },

package/dist/checkout.mjs

@@ -1 +0,0 @@
-export{a as createCheckoutOperations}from'./chunk-SZQPMLZG.mjs';