@shoppexio/storefront 0.3.7 → 0.3.8

package/README.md

@@ -1,76 +1,235 @@
-# @shoppexio/storefront
+# Shoppex Storefront SDK
 
-Official JavaScript storefront SDK for Shoppex.
+Build custom storefronts with any framework using the Shoppex SDK.
 
-Use this package when you want to embed Shoppex products, cart behavior, and hosted checkout into a custom frontend.
+## Installation
 
-## Good fit
+### CDN (Recommended for quick start)
 
-Use this package for:
+```html
+<script src="https://cdn.shoppex.io/sdk/v0.3/shoppex.umd.js"></script>
+```
+
+Use the moving minor channel for managed updates.
+Simple example: `v0.3` moves to the latest `0.3.x` release.
 
-- product loading
-- cart state
-- checkout redirects
-- storefront helpers
+If you need a locked production rollout, pin an exact version:
+
+```html
+<script src="https://cdn.shoppex.io/sdk/<exact-version>/shoppex.umd.js"></script>
+```
 
-## Install
+`/sdk/latest/` stays available for internal and development usage only.
+
+### npm
 
 ```bash
 npm install @shoppexio/storefront
 ```
 
-## Quick start
+## Quick Start
+
+```html
+<script src="https://cdn.shoppex.io/sdk/v0.3/shoppex.umd.js"></script>
+<script>
+  // Initialize with your store slug
+  shoppex.init('my-store');
+
+  // Get store info
+  shoppex.getStore().then(function(result) {
+    if (result.success) {
+      console.log('Store:', result.data.name);
+    }
+  });
+
+  // Add product to cart
+  shoppex.addToCart('product-id', 'variant-id', 2);
+
+  // Checkout (redirects to hosted checkout)
+  document.getElementById('checkout-btn').onclick = function() {
+    shoppex.checkout();
+  };
+</script>
+```
 
-```ts
-import shoppex from '@shoppexio/storefront';
+### ES Modules (with async/await)
 
-shoppex.init('my-store');
+```html
+<script type="module">
+  import shoppex from 'https://cdn.shoppex.io/sdk/v0.3/shoppex.esm.js';
 
-const products = await shoppex.getProducts();
-shoppex.addToCart(products.data?.[0]?.uniqid ?? '', 'default', 1);
-await shoppex.checkout();
+  shoppex.init('my-store');
+
+  const store = await shoppex.getStore();
+  const products = await shoppex.getProducts();
+
+  shoppex.addToCart(products.data[0].uniqid, 'default', 1);
+
+  await shoppex.checkout();
+</script>
 ```
 
-## Coupon validation
+## API Reference
 
-Use the options form when validating a coupon for a selected product variant:
+### Initialization
 
-```ts
-const result = await shoppex.validateCoupon('SAVE10', {
-  productId: 'prod_abc123',
-  variantId: 'variant_lifetime',
+```javascript
+// Simple init
+shoppex.init('store-slug');
+
+// With options
+shoppex.init({
+  storeId: 'store-slug',
+  locale: 'de',
+  currency: 'EUR'
 });
 ```
 
-Calling `validateCoupon(code)` without options validates against the current SDK cart. Affiliate/referral codes are separate and should use `validateAffiliateCode` or `applyAffiliateCode`. If `program_enabled` is false in an affiliate validation response, the shop-level affiliate program is disabled even if individual links exist.
+### Store
 
-## Live online users
+```javascript
+const store = await shoppex.getStore();
+// → { success: true, data: { id, name, currency, ... } }
 
-The SDK can power a custom live online visitor counter. It provides the data; your storefront renders the badge.
+const logoUrl = await shoppex.getStoreLogoUrl();
+const bannerUrl = await shoppex.getStoreBannerUrl();
+```
 
-```ts
-import shoppex from '@shoppexio/storefront';
+### Products
 
-shoppex.init('my-store');
+```javascript
+const products = await shoppex.getProducts();
+// → { success: true, data: [{ uniqid, title, price, images[], variants[], addons[], faqs[], feedback, ... }] }
+//    variants[] mirrors price_variants[] (legacy field); both are present for compatibility.
+//    images[] contains the full product gallery; the first entry is the primary image.
 
-async function refreshLiveUsers() {
-  await shoppex.touchStorefrontPresence();
+const product = await shoppex.getProduct('product-id-or-slug');
+const categories = await shoppex.getCategories();
+```
+
+### Cart
+
+```javascript
+// Simple add
+shoppex.addToCart('productId', 'variantId', 2);
+
+// With Shoppex features (addons, custom fields)
+shoppex.addToCart('productId', 'variantId', 1, {
+  addons: [
+    { id: 'addon_gift_wrap', quantity: 1 }
+  ],
+  customFields: {
+    'engraving_text': 'Happy Birthday!'
+  },
+  priceVariantId: 'price_premium'
+});
+
+// Get cart
+const cart = shoppex.getCart();
+const itemCount = shoppex.getCartItemCount();
+
+// Manage cart
+shoppex.removeFromCart('productId', 'variantId');
+shoppex.clearCart();
+
+// Backup/restore (useful for error recovery)
+shoppex.createCartBackup();
+shoppex.restoreCartFromBackup();
+```
+
+### Checkout
+
+```javascript
+// Simple checkout (auto-redirects)
+await shoppex.checkout();
+
+// With coupon
+await shoppex.checkout('SAVE20');
+
+// Get URL without redirecting
+const result = await shoppex.checkout('SAVE20', { autoRedirect: false });
+console.log(result.redirectUrl);
+```
 
-  const result = await shoppex.getStorefrontOnlineUsers();
-  if (result.success && result.data) {
-    console.log(`${result.data.count} online`);
-  }
+### Coupons
+
+```javascript
+const result = await shoppex.validateCoupon('SAVE20', {
+  productId: 'product-id',
+  variantId: 'variant-id',
+});
+// -> { success: true, data: { valid: true, discount: 20, restriction_scope: 'variants' } }
+```
+
+### Affiliate Codes
+
+Affiliate/referral codes are separate from coupon codes. Validate and store them before checkout:
+
+```javascript
+const affiliate = await shoppex.applyAffiliateCode('creator10');
+
+if (affiliate.data?.program_enabled === false) {
+  throw new Error('Affiliate program is disabled for this shop');
 }
 
-await refreshLiveUsers();
-setInterval(refreshLiveUsers, 30_000);
+await shoppex.checkout({
+  coupon: 'SAVE20',
+  affiliateCode: affiliate.data?.affiliate_code,
+});
+```
+
+### Reviews
+
+```javascript
+const reviews = await shoppex.getShopReviews();
+// → { success: true, data: [{ rating, comment, ... }] }
+```
+
+### Invoices
+
+```javascript
+const invoice = await shoppex.getInvoice('invoice-id');
+const status = await shoppex.getInvoiceStatus('invoice-id');
 ```
 
-## Not this package
+### Formatting
+
+```javascript
+const formatter = shoppex.createFormatter('USD', 'en-US');
+formatter.format(29.99); // → "$29.99"
+
+// Or directly
+shoppex.formatPrice(29.99, 'EUR', 'de-DE'); // → "29,99 €"
+```
+
+## Shoppex Features
+
+The SDK supports Shoppex-specific features not found in competitors:
+
+| Feature | Description |
+|---------|-------------|
+| **Product Addons** | Express shipping, gift wrap, etc. |
+| **Custom Fields** | Customer input (engraving, gift message) |
+| **Price Variants** | Different pricing tiers |
+| **Multiple Gateways** | Stripe, PayPal, Crypto |
 
-If you want the authenticated Developer API wrapper for backend integrations, use `@shoppexio/sdk`. Do not ship `@shoppexio/sdk` in a browser bundle; use this Storefront SDK for headless storefronts.
+## Browser Support
+
+- Chrome 80+
+- Firefox 75+
+- Safari 13+
+- Edge 80+
+
+## TypeScript
+
+Full TypeScript support with type definitions included.
+
+```typescript
+import shoppex, { Product, CartItem } from '@shoppexio/storefront';
+
+const products: Product[] = (await shoppex.getProducts()).data ?? [];
+```
 
-## Docs
+## License
 
-- Storefront docs: [docs.shoppex.io/sdk/introduction](https://docs.shoppex.io/sdk/introduction)
-- Installation: [docs.shoppex.io/sdk/installation](https://docs.shoppex.io/sdk/installation)
+MIT

package/dist/__tests__/affiliates.test.d.ts

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

package/dist/__tests__/affiliates.test.d.ts.map

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

package/dist/__tests__/analytics.test.d.ts

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

package/dist/__tests__/analytics.test.d.ts.map

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

package/dist/__tests__/cache.test.d.ts

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

package/dist/__tests__/cache.test.d.ts.map

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

package/dist/__tests__/cart.test.d.ts

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

package/dist/__tests__/cart.test.d.ts.map

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

package/dist/__tests__/checkout.test.d.ts

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

package/dist/__tests__/checkout.test.d.ts.map

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

package/dist/__tests__/client.test.d.ts

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

package/dist/__tests__/client.test.d.ts.map

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

package/dist/__tests__/config.test.d.ts

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

package/dist/__tests__/config.test.d.ts.map

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

package/dist/__tests__/coupons.test.d.ts

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

package/dist/__tests__/coupons.test.d.ts.map

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

package/dist/__tests__/endpoint.test.d.ts

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

package/dist/__tests__/endpoint.test.d.ts.map

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

package/dist/__tests__/invoices.test.d.ts

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

package/dist/__tests__/invoices.test.d.ts.map

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

package/dist/__tests__/navigation.test.d.ts

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

package/dist/__tests__/navigation.test.d.ts.map

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

package/dist/__tests__/pages.test.d.ts

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

package/dist/__tests__/pages.test.d.ts.map

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

package/dist/__tests__/products.test.d.ts

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

package/dist/__tests__/products.test.d.ts.map

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

package/dist/__tests__/reviews.test.d.ts

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

package/dist/__tests__/reviews.test.d.ts.map

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

package/dist/__tests__/sdk.smoke.test.d.ts

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

package/dist/__tests__/sdk.smoke.test.d.ts.map

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

package/dist/__tests__/setup.d.ts

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

package/dist/__tests__/setup.d.ts.map

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

package/dist/__tests__/store.test.d.ts

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

package/dist/__tests__/store.test.d.ts.map

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

package/dist/__tests__/storefront-custom-fields.test.d.ts

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

package/dist/__tests__/storefront-custom-fields.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront-custom-fields.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/storefront-custom-fields.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/theme.test.d.ts

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

package/dist/__tests__/theme.test.d.ts.map

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

package/dist/core/cache.d.ts

@@ -0,0 +1,26 @@
+/**
+ * In-memory cache with pending request deduplication.
+ */
+export interface CacheEntry<T> {
+    data: T;
+    expiresAt: number;
+    updatedAt: number;
+    ttl: number;
+}
+export interface CacheOptions {
+    ttl: number;
+    staleWhileRevalidate?: boolean;
+}
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    pendingRequests: number;
+    entries: number;
+}
+export declare function getCacheStats(): CacheStats;
+export declare function clearCache(): void;
+export declare function invalidateCache(prefixOrKey: string): void;
+export declare function setCacheEntry<T>(key: string, data: T, ttl: number): void;
+export declare function getCacheEntry<T>(key: string): CacheEntry<T> | null;
+export declare function getOrFetch<T>(key: string, fetcher: () => Promise<T>, options: CacheOptions, shouldCache?: (value: T) => boolean): Promise<T>;
+//# sourceMappingURL=cache.d.ts.map

package/dist/core/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/core/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAcD,wBAAgB,aAAa,IAAI,UAAU,CAO1C;AAED,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAMzD;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAQxE;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAIlE;AAED,wBAAsB,UAAU,CAAC,CAAC,EAChC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,OAAO,EAAE,YAAY,EACrB,WAAW,GAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAoB,GAC9C,OAAO,CAAC,CAAC,CAAC,CA8CZ"}

package/dist/core/client.d.ts

@@ -0,0 +1,17 @@
+import { SDKResponse } from '../types';
+import { CacheOptions } from './cache';
+interface RequestOptions {
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    body?: unknown;
+    timeout?: number;
+    retries?: number;
+    baseUrl?: string;
+    cache?: (CacheOptions & {
+        key?: string;
+    }) | false;
+}
+export declare function request<T>(endpoint: string, options?: RequestOptions): Promise<SDKResponse<T>>;
+export declare function get<T>(endpoint: string, options?: Omit<RequestOptions, 'method' | 'body'>): Promise<SDKResponse<T>>;
+export declare function post<T>(endpoint: string, body?: unknown, options?: Omit<RequestOptions, 'method' | 'body'>): Promise<SDKResponse<T>>;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/core/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,UAAU,CAAC;AAGzD,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAMxD,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,YAAY,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,KAAK,CAAC;CACnD;AAiBD,wBAAsB,OAAO,CAAC,CAAC,EAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAiIzB;AA6DD,wBAAsB,GAAG,CAAC,CAAC,EACzB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,MAAM,CAAC,GAChD,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAEzB;AAED,wBAAsB,IAAI,CAAC,CAAC,EAC1B,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,MAAM,CAAC,GAChD,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAEzB"}

package/dist/core/config.d.ts

@@ -0,0 +1,10 @@
+import { ShoppexConfig, ShoppexInitOptions } from '../types';
+export declare const DEFAULT_API_BASE_URL = "https://api.shoppex.io";
+export declare const DEFAULT_CHECKOUT_BASE_URL = "https://checkout.shoppex.io";
+export declare function initConfig(storeSlug: string, options?: ShoppexInitOptions): ShoppexConfig;
+export declare function getConfig(): ShoppexConfig;
+export declare function isInitialized(): boolean;
+export declare function resetConfig(): void;
+export declare function setShopId(shopId: string): void;
+export declare function getShopId(): string | null;
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAIlE,eAAO,MAAM,oBAAoB,2BAA2B,CAAC;AAK7D,eAAO,MAAM,yBAAyB,gCAAgC,CAAC;AAEvE,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,aAAa,CAgBf;AAED,wBAAgB,SAAS,IAAI,aAAa,CAKzC;AAED,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,wBAAgB,WAAW,IAAI,IAAI,CAIlC;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,wBAAgB,SAAS,IAAI,MAAM,GAAG,IAAI,CAEzC"}

package/dist/core/endpoint.d.ts

@@ -0,0 +1,2 @@
+export declare function buildEndpoint(template: string, params: Record<string, string | number | null | undefined>): string;
+//# sourceMappingURL=endpoint.d.ts.map

package/dist/core/endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../src/core/endpoint.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GACzD,MAAM,CAcR"}

package/dist/core/errors.d.ts

@@ -0,0 +1,22 @@
+/**
+ * SDK Error Classes
+ */
+export declare class ShoppexError extends Error {
+    readonly code: string;
+    readonly statusCode?: number;
+    constructor(message: string, code: string, statusCode?: number);
+}
+export declare class NotInitializedError extends ShoppexError {
+    constructor();
+}
+export declare class NetworkError extends ShoppexError {
+    constructor(message: string, statusCode?: number);
+}
+export declare class ValidationError extends ShoppexError {
+    readonly invalidFields?: string[];
+    constructor(message: string, invalidFields?: string[]);
+}
+export declare class CartError extends ShoppexError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAO/D;AAED,qBAAa,mBAAoB,SAAQ,YAAY;;CASpD;AAED,qBAAa,YAAa,SAAQ,YAAY;gBAChC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAKjD;AAED,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,SAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;gBAE7B,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE;CAMtD;AAED,qBAAa,SAAU,SAAQ,YAAY;gBAC7B,OAAO,EAAE,MAAM;CAK5B"}

package/dist/core/telemetry.d.ts

@@ -0,0 +1,20 @@
+type VisibilityStateValue = 'hidden' | 'visible' | 'prerender' | 'unloaded';
+type RequestMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';
+export interface StorefrontClientErrorPayload {
+    endpoint: string;
+    method: RequestMethod;
+    message: string;
+    statusCode?: number;
+    source?: 'sdk';
+    phase?: 'request';
+    attemptCount?: number;
+    responseReceived?: boolean;
+    pageUrl?: string;
+    requestUrl?: string;
+    online?: boolean;
+    visibilityState?: VisibilityStateValue;
+}
+export declare function getStorefrontConnectionId(storeSlug: string): string | null;
+export declare function reportStorefrontClientError(payload: StorefrontClientErrorPayload): Promise<void>;
+export {};
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/core/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/core/telemetry.ts"],"names":[],"mappings":"AAOA,KAAK,oBAAoB,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAC5E,KAAK,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEvD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,oBAAoB,CAAC;CACxC;AASD,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY1E;AAwBD,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDtG"}

package/dist/core/typed-client.d.ts

@@ -0,0 +1,15 @@
+import { createApiClient } from '@shoppex/contracts';
+type ApiClient = ReturnType<typeof createApiClient>;
+/**
+ * Return a typed OpenAPI client bound to the SDK's configured API base URL.
+ * The client is cached per base URL and recreated when the SDK is re-initialized
+ * against a different host.
+ */
+export declare function getTypedClient(token?: string): ApiClient;
+/**
+ * Reset the cached client. Called when the SDK is re-initialized so that a new
+ * `apiBaseUrl` takes effect immediately on the next `client()` call.
+ */
+export declare function resetTypedClient(): void;
+export {};
+//# sourceMappingURL=typed-client.d.ts.map

package/dist/core/typed-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-client.d.ts","sourceRoot":"","sources":["../../src/core/typed-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAKpD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAgBxD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}