@tagadapay/headless-sdk 1.6.0 → 1.8.0-rc.0

package/README.md

@@ -1,186 +1 @@
-# @tagadapay/headless-sdk
-
-Use TagadaPay as a **headless checkout and CRM backend** from any website — React, Vue, vanilla JS, or plain HTML. Zero runtime dependencies in core.
-
-## Install
-
-```bash
-npm install @tagadapay/headless-sdk
-# Optional: for card tokenization
-npm install @tagadapay/core-js
-```
-
-## Quick Start (Vanilla JS)
-
-```typescript
-import { createHeadlessClient } from '@tagadapay/headless-sdk';
-
-const tagada = createHeadlessClient({
-  storeId: 'store_abc123',
-  environment: 'production',
-});
-
-// Load checkout session
-const session = await tagada.checkout.loadSession(checkoutToken, sessionToken);
-
-// Set customer info (stored in memory, sent with address)
-await tagada.checkout.updateCustomer(session.id, {
-  email: 'john@example.com',
-  firstName: 'John',
-  lastName: 'Doe',
-});
-
-// Set address — customer fields are included automatically
-await tagada.checkout.updateAddress(session.id, {
-  shippingAddress: { line1: '10 Rue de la Paix', city: 'Paris', postalCode: '75002', country: 'FR' },
-});
-
-// Tokenize card + pay with automatic 3DS / redirect handling
-const { tagadaToken } = await tagada.payment.tokenizeCard({
-  cardNumber: '4242424242424242',
-  expiryDate: '12/28',
-  cvc: '123',
-});
-
-const result = await tagada.payment.processPayment({
-  checkoutSessionId: session.id,
-  tagadaToken,
-});
-
-if (result.status === 'succeeded') {
-  console.log('Payment succeeded!', result.order);
-} else if (result.status === 'requires_redirect') {
-  // SDK handles this automatically in React; in vanilla JS, redirect manually:
-  window.location.href = result.redirectUrl;
-} else if (result.status === 'failed') {
-  console.error(result.error);
-}
-```
-
-## Quick Start (React)
-
-```tsx
-import { TagadaHeadlessProvider, useCheckout, usePayment } from '@tagadapay/headless-sdk/react';
-
-function App() {
-  return (
-    <TagadaHeadlessProvider storeId="store_abc123" environment="production">
-      <CheckoutPage />
-    </TagadaHeadlessProvider>
-  );
-}
-
-function CheckoutPage() {
-  const { session, updateCustomer, updateAddress } = useCheckout(checkoutToken, sessionToken);
-  const { processPayment, isProcessing, tokenizeCard } = usePayment({
-    onPaymentSuccess: (result) => router.push('/thank-you'),
-    onPaymentFailed: (result) => alert(result.error),
-  });
-
-  const handlePay = async () => {
-    // Customer + address (single atomic API call under the hood)
-    await updateCustomer({ email, firstName, lastName });
-    await updateAddress({ shippingAddress: { line1, city, postalCode, country } });
-
-    // Tokenize + pay — 3DS redirects and polling are handled automatically
-    const { tagadaToken } = await tokenizeCard({ cardNumber, expiryDate, cvc });
-    await processPayment({ checkoutSessionId: session.id, tagadaToken });
-    // onPaymentSuccess / onPaymentFailed callbacks fire automatically
-  };
-
-  return <button onClick={handlePay} disabled={isProcessing}>Pay Now</button>;
-}
-```
-
-## Payment Flow
-
-`processPayment()` handles the full payment lifecycle automatically:
-
-1. **Tokenize** → creates a payment instrument from the card
-2. **Pay** → submits payment to the processor
-3. **3DS / Redirect** → if the bank requires authentication, the SDK redirects the user and resumes automatically on return
-4. **Poll** → waits for async processing to complete
-5. **Result** → returns a typed `ProcessPaymentResult`
-
-The return type is a discriminated union:
-
-| Status | Meaning |
-|--------|---------|
-| `succeeded` | Payment confirmed. Show success screen. |
-| `requires_redirect` | User must visit a URL (3DS, bank auth). Auto-handled in React. |
-| `failed` | Payment declined or errored. `result.error` has details. |
-| `pending` | Still processing (rare — polling timed out). |
-
-## Address Handling
-
-The SDK handles both **shipped** and **digital** products:
-
-```typescript
-// Shipped product — billing defaults to shipping
-await tagada.checkout.updateAddress(sessionId, {
-  shippingAddress: { line1: '...', city: '...', country: 'FR' },
-});
-
-// Digital product — billing only, no shipping needed
-await tagada.checkout.updateAddress(sessionId, {
-  billingAddress: { country: 'FR' },
-});
-
-// Separate billing and shipping
-await tagada.checkout.updateAddress(sessionId, {
-  shippingAddress: { line1: '...', city: '...', country: 'FR' },
-  billingAddress: { line1: '...', city: '...', country: 'DE' },
-});
-
-// Or use the combined method
-await tagada.checkout.updateCustomerAndAddress(sessionId, {
-  customer: { email: 'john@example.com', firstName: 'John', lastName: 'Doe' },
-  shippingAddress: { line1: '...', city: '...', country: 'FR' },
-});
-```
-
-## Modules
-
-| Module | What it does |
-|--------|-------------|
-| `tagada.checkout` | Session management — load, update cart, promo codes, shipping |
-| `tagada.payment` | Full payment lifecycle — APMs, tokenize, 3DS, pay, poll, express checkout |
-| `tagada.offers` | Upsells & order bumps — preview, pay, post-purchase accept/decline |
-| `tagada.customer` | CRM data — profile, orders, subscriptions |
-| `tagada.catalog` | Product browsing — list products, variants, prices |
-
-## CDN Usage
-
-```html
-<script src="https://cdn.jsdelivr.net/npm/@tagadapay/headless-sdk/dist/tagada-headless.min.js"></script>
-<script>
-  const tagada = TagadaHeadless.create({ storeId: 'store_abc123' });
-</script>
-```
-
-## Example
-
-A complete React checkout app is available as a live demo and open-source reference:
-
-- **Live demo**: [headless-react-eta.vercel.app](https://headless-react-eta.vercel.app)
-- **Source code**: [github.com/TagadaPay/examples/tree/main/headless-react](https://github.com/TagadaPay/examples/tree/main/headless-react)
-
-## Architecture
-
-- **Zero dependencies** in core — native `fetch`, no axios
-- **Tree-shakeable ESM** — unused modules are eliminated by bundlers
-- **Framework-agnostic core** + thin React hooks layer
-- **TypeScript first** — full type coverage, JSDoc on every method
-- **Optional `@tagadapay/core-js`** peer — only needed for client-side card tokenization
-- **Automatic 3DS** — handles redirects, iframe challenges, and polling out of the box
-
-## Package Exports
-
-| Import path | What you get |
-|------------|--------------|
-| `@tagadapay/headless-sdk` | Core client + all modules |
-| `@tagadapay/headless-sdk/react` | React hooks + provider |
-
-## License
-
-MIT
+test

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tagadapay/headless-sdk",
-  "version": "1.6.0",
+  "version": "1.8.0-rc.0",
   "description": "Headless SDK for using TagadaPay as a checkout, offers, and CRM backend from any external website",
   "type": "module",
   "main": "dist/core/index.js",
@@ -18,14 +18,7 @@
     }
   },
   "scripts": {
-    "build": "tsc && node build-cdn.js",
-    "build:types": "tsc",
-    "build:cdn": "node build-cdn.js",
-    "clean": "rm -rf dist",
-    "dev": "tsc --watch",
-    "lint": "echo \"No linting configured\"",
-    "test": "echo \"No tests yet\" && exit 0",
-    "prepublishOnly": "npm run clean && npm run build"
+    "prepublishOnly": "echo skip"
   },
   "keywords": [
     "tagadapay",
@@ -45,7 +38,8 @@
     "@types/node": "^18.0.0",
     "@types/react": "^19",
     "esbuild": "^0.20.0",
-    "typescript": "^5.0.0"
+    "typescript": "^5.0.0",
+    "vitest": "^3.2.4"
   },
   "peerDependencies": {
     "@stripe/stripe-js": "^7.0.0 || ^8.0.0",
@@ -64,7 +58,8 @@
     }
   },
   "files": [
-    "dist/**/*",
+    "dist/index.js",
+    "dist/index.d.ts",
     "README.md"
   ],
   "repository": {

package/dist/core/client.d.ts

@@ -1,54 +0,0 @@
-import { CheckoutModule } from './modules/checkout.js';
-import { PaymentModule } from './modules/payment.js';
-import { OffersModule } from './modules/offers.js';
-import { CustomerModule } from './modules/customer.js';
-import { CatalogModule } from './modules/catalog.js';
-import type { HeadlessConfig } from './types.js';
-/**
- * Main entry point for the TagadaPay Headless SDK.
- *
- * Composes all domain modules (checkout, payment, offers, customer, catalog)
- * over a single lightweight HTTP client built on native fetch.
- *
- * **PCI DSS notice:** Card tokenization via `payment.tokenizeCard()` sends
- * card data directly to Basis Theory — it never reaches TagadaPay servers.
- * However, because card data passes through your JavaScript environment,
- * merchants using this SDK are responsible for PCI DSS SAQ-A-EP compliance.
- * See https://docs.tagada.io/developer-tools/headless-sdk/pci-compliance
- */
-export declare class HeadlessClient {
-    readonly config: Required<Pick<HeadlessConfig, 'storeId' | 'environment'>> & HeadlessConfig;
-    private readonly http;
-    /** Shared session token used by all modules for authenticated API calls. */
-    private _sessionToken;
-    /** Checkout session management -- load, update cart, apply promos, shipping. */
-    readonly checkout: CheckoutModule;
-    /** Payment processing -- setup config, APMs, tokenize, pay, 3DS, poll. */
-    readonly payment: PaymentModule;
-    /** Offers -- preview, pay, accept/decline upsells and order bumps. */
-    readonly offers: OffersModule;
-    /** Customer data -- profile, orders, subscriptions. */
-    readonly customer: CustomerModule;
-    /** Product catalog -- list products, variants, and prices. */
-    readonly catalog: CatalogModule;
-    constructor(config: HeadlessConfig);
-    /** Manually set the session token (e.g. from URL params on page load). */
-    setSessionToken(token: string): void;
-}
-/**
- * Create a new HeadlessClient instance.
- *
- * @example
- * ```ts
- * import { createHeadlessClient } from '@tagadapay/headless-sdk';
- *
- * const tagada = createHeadlessClient({
- *   storeId: 'store_abc123',
- *   environment: 'production',
- * });
- *
- * const session = await tagada.checkout.loadSession(checkoutToken);
- * ```
- */
-export declare function createHeadlessClient(config: HeadlessConfig): HeadlessClient;
-//# sourceMappingURL=client.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,YAAY,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,qBAAa,cAAc;IACzB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,aAAa,CAAC,CAAC,GAAG,cAAc,CAAC;IAE5F,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAElC,4EAA4E;IAC5E,OAAO,CAAC,aAAa,CAAqB;IAE1C,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAElC,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAEhC,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAElC,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;gBAEpB,MAAM,EAAE,cAAc;IA6BlC,0EAA0E;IAC1E,eAAe,CAAC,KAAK,EAAE,MAAM;CAG9B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAE3E"}

package/dist/core/client.js

@@ -1,67 +0,0 @@
-import { HttpClient } from './http.js';
-import { CheckoutModule } from './modules/checkout.js';
-import { PaymentModule } from './modules/payment.js';
-import { OffersModule } from './modules/offers.js';
-import { CustomerModule } from './modules/customer.js';
-import { CatalogModule } from './modules/catalog.js';
-/**
- * Main entry point for the TagadaPay Headless SDK.
- *
- * Composes all domain modules (checkout, payment, offers, customer, catalog)
- * over a single lightweight HTTP client built on native fetch.
- *
- * **PCI DSS notice:** Card tokenization via `payment.tokenizeCard()` sends
- * card data directly to Basis Theory — it never reaches TagadaPay servers.
- * However, because card data passes through your JavaScript environment,
- * merchants using this SDK are responsible for PCI DSS SAQ-A-EP compliance.
- * See https://docs.tagada.io/developer-tools/headless-sdk/pci-compliance
- */
-export class HeadlessClient {
-    constructor(config) {
-        const environment = config.environment ?? 'production';
-        const baseUrl = HttpClient.resolveBaseUrl(environment, config.baseUrl);
-        this.config = {
-            ...config,
-            environment,
-            baseUrl,
-            timeout: config.timeout ?? 30000,
-        };
-        this.http = new HttpClient({
-            baseUrl,
-            timeout: this.config.timeout,
-            apiKey: config.apiKey,
-            getToken: () => this._sessionToken,
-        });
-        const setToken = (token) => {
-            this._sessionToken = token;
-        };
-        this.checkout = new CheckoutModule(this.http, this.config.storeId, setToken);
-        this.payment = new PaymentModule(this.http, this.config.storeId, environment);
-        this.offers = new OffersModule(this.http, this.config.storeId, this.payment);
-        this.customer = new CustomerModule(this.http, this.config.storeId);
-        this.catalog = new CatalogModule(this.http, this.config.storeId);
-    }
-    /** Manually set the session token (e.g. from URL params on page load). */
-    setSessionToken(token) {
-        this._sessionToken = token;
-    }
-}
-/**
- * Create a new HeadlessClient instance.
- *
- * @example
- * ```ts
- * import { createHeadlessClient } from '@tagadapay/headless-sdk';
- *
- * const tagada = createHeadlessClient({
- *   storeId: 'store_abc123',
- *   environment: 'production',
- * });
- *
- * const session = await tagada.checkout.loadSession(checkoutToken);
- * ```
- */
-export function createHeadlessClient(config) {
-    return new HeadlessClient(config);
-}
-//# sourceMappingURL=client.js.map

package/dist/core/client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,cAAc;IAuBzB,YAAY,MAAsB;QAChC,MAAM,WAAW,GAAgB,MAAM,CAAC,WAAW,IAAI,YAAY,CAAC;QACpE,MAAM,OAAO,GAAG,UAAU,CAAC,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAEvE,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG,MAAM;YACT,WAAW;YACX,OAAO;YACP,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,KAAM;SAClC,CAAC;QAEF,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC;YACzB,OAAO;YACP,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAQ;YAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa;SACnC,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,EAAE;YACjC,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC7B,CAAC,CAAC;QAEF,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC7E,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAC9E,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7E,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACnE,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC;IAED,0EAA0E;IAC1E,eAAe,CAAC,KAAa;QAC3B,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;IAC7B,CAAC;CACF;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAsB;IACzD,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/dist/core/errors.d.ts

@@ -1,46 +0,0 @@
-/** Base error for all TagadaPay headless SDK errors. */
-export declare class TagadaError extends Error {
-    readonly code: string;
-    readonly statusCode?: number;
-    readonly details?: Record<string, unknown>;
-    constructor(message: string, code: string, statusCode?: number, details?: Record<string, unknown>);
-}
-/** Thrown when the API returns 401/403. */
-export declare class TagadaAuthError extends TagadaError {
-    constructor(message?: string);
-}
-/** Thrown when the API returns 422 with validation errors. */
-export declare class TagadaValidationError extends TagadaError {
-    readonly errors: Array<{
-        field: string;
-        message: string;
-    }>;
-    constructor(message: string, errors?: Array<{
-        field: string;
-        message: string;
-    }>);
-}
-/** Thrown when a resource is not found (404). */
-export declare class TagadaNotFoundError extends TagadaError {
-    constructor(resource: string, id: string);
-}
-/** Thrown when the API returns 429. */
-export declare class TagadaRateLimitError extends TagadaError {
-    readonly retryAfterMs: number;
-    constructor(retryAfterMs?: number);
-}
-/** Thrown when a payment fails or requires action. */
-export declare class TagadaPaymentError extends TagadaError {
-    readonly paymentId?: string;
-    readonly requireAction?: string;
-    constructor(message: string, opts?: {
-        paymentId?: string;
-        requireAction?: string;
-        details?: Record<string, unknown>;
-    });
-}
-/** Thrown on network / fetch failures. */
-export declare class TagadaNetworkError extends TagadaError {
-    constructor(message?: string);
-}
-//# sourceMappingURL=errors.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAGhD,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQpC;AAED,2CAA2C;AAC3C,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,SAAiE;CAIrF;AAED,8DAA8D;AAC9D,qBAAa,qBAAsB,SAAQ,WAAW;IACpD,SAAgB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;gBAGhE,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAM;CAMzD;AAED,iDAAiD;AACjD,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;CAIzC;AAED,uCAAuC;AACvC,qBAAa,oBAAqB,SAAQ,WAAW;IACnD,SAAgB,YAAY,EAAE,MAAM,CAAC;gBAEzB,YAAY,SAAO;CAKhC;AAED,sDAAsD;AACtD,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnC,SAAgB,aAAa,CAAC,EAAE,MAAM,CAAC;gBAGrC,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;CAO3F;AAED,0CAA0C;AAC1C,qBAAa,kBAAmB,SAAQ,WAAW;gBACrC,OAAO,SAAmD;CAIvE"}

package/dist/core/errors.js

@@ -1,57 +0,0 @@
-/** Base error for all TagadaPay headless SDK errors. */
-export class TagadaError extends Error {
-    constructor(message, code, statusCode, details) {
-        super(message);
-        this.name = 'TagadaError';
-        this.code = code;
-        this.statusCode = statusCode;
-        this.details = details;
-    }
-}
-/** Thrown when the API returns 401/403. */
-export class TagadaAuthError extends TagadaError {
-    constructor(message = 'Authentication failed. Check your API key or checkout token.') {
-        super(message, 'auth_error', 401);
-        this.name = 'TagadaAuthError';
-    }
-}
-/** Thrown when the API returns 422 with validation errors. */
-export class TagadaValidationError extends TagadaError {
-    constructor(message, errors = []) {
-        super(message, 'validation_error', 422, { errors });
-        this.name = 'TagadaValidationError';
-        this.errors = errors;
-    }
-}
-/** Thrown when a resource is not found (404). */
-export class TagadaNotFoundError extends TagadaError {
-    constructor(resource, id) {
-        super(`${resource} "${id}" not found.`, 'not_found', 404);
-        this.name = 'TagadaNotFoundError';
-    }
-}
-/** Thrown when the API returns 429. */
-export class TagadaRateLimitError extends TagadaError {
-    constructor(retryAfterMs = 1000) {
-        super(`Rate limited. Retry after ${retryAfterMs}ms.`, 'rate_limit', 429);
-        this.name = 'TagadaRateLimitError';
-        this.retryAfterMs = retryAfterMs;
-    }
-}
-/** Thrown when a payment fails or requires action. */
-export class TagadaPaymentError extends TagadaError {
-    constructor(message, opts) {
-        super(message, 'payment_error', undefined, opts?.details);
-        this.name = 'TagadaPaymentError';
-        this.paymentId = opts?.paymentId;
-        this.requireAction = opts?.requireAction;
-    }
-}
-/** Thrown on network / fetch failures. */
-export class TagadaNetworkError extends TagadaError {
-    constructor(message = 'Network request failed. Check your connection.') {
-        super(message, 'network_error');
-        this.name = 'TagadaNetworkError';
-    }
-}
-//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,OAAO,WAAY,SAAQ,KAAK;IAKpC,YACE,OAAe,EACf,IAAY,EACZ,UAAmB,EACnB,OAAiC;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,2CAA2C;AAC3C,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C,YAAY,OAAO,GAAG,8DAA8D;QAClF,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,8DAA8D;AAC9D,MAAM,OAAO,qBAAsB,SAAQ,WAAW;IAGpD,YACE,OAAe,EACf,SAAoD,EAAE;QAEtD,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,iDAAiD;AACjD,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAClD,YAAY,QAAgB,EAAE,EAAU;QACtC,KAAK,CAAC,GAAG,QAAQ,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,uCAAuC;AACvC,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IAGnD,YAAY,YAAY,GAAG,IAAI;QAC7B,KAAK,CAAC,6BAA6B,YAAY,KAAK,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC;QACzE,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAED,sDAAsD;AACtD,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IAIjD,YACE,OAAe,EACf,IAAwF;QAExF,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,IAAI,EAAE,SAAS,CAAC;QACjC,IAAI,CAAC,aAAa,GAAG,IAAI,EAAE,aAAa,CAAC;IAC3C,CAAC;CACF;AAED,0CAA0C;AAC1C,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IACjD,YAAY,OAAO,GAAG,gDAAgD;QACpE,KAAK,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

package/dist/core/helpers/autocomplete.d.ts

@@ -1,89 +0,0 @@
-/**
- * Google Places Autocomplete — script injection + address extraction.
- * Works standalone (no external dependencies beyond the Google Maps JS API).
- */
-declare global {
-    interface Window {
-        google?: {
-            maps?: {
-                places?: {
-                    AutocompleteService: new () => any;
-                    PlacesService: new (el: any) => any;
-                    PlacesServiceStatus: {
-                        OK: string;
-                        ZERO_RESULTS: string;
-                    };
-                };
-                Map: new (el: HTMLElement) => any;
-            };
-        };
-    }
-}
-export interface GooglePrediction {
-    place_id: string;
-    description: string;
-    structured_formatting?: {
-        main_text: string;
-        secondary_text: string;
-    };
-}
-export interface GooglePlaceDetails {
-    place_id: string;
-    formatted_address: string;
-    address_components: Array<{
-        long_name: string;
-        short_name: string;
-        types: string[];
-    }>;
-    geometry?: {
-        location: {
-            lat: number;
-            lng: number;
-        };
-    };
-}
-export interface ExtractedAddress {
-    subpremise: string;
-    streetNumber: string;
-    route: string;
-    locality: string;
-    administrativeAreaLevel1: string;
-    administrativeAreaLevel1Long: string;
-    administrativeAreaLevel2: string;
-    administrativeAreaLevel2Long: string;
-    country: string;
-    postalCode: string;
-    fullStreetAddress: string;
-}
-export interface FormattedAddress {
-    address1: string;
-    city: string;
-    country: string;
-    state: string;
-    postal: string;
-}
-/**
- * Inject the Google Maps JS SDK into the page (idempotent).
- * Resolves once `window.google.maps.places` is available.
- */
-export declare function loadGoogleMapsScript(apiKey: string, opts?: {
-    language?: string;
-    region?: string;
-    version?: string;
-}): Promise<void>;
-export declare class GoogleAutocompleteCore {
-    /** Search for address predictions. */
-    static searchPlaces(input: string, options?: {
-        types?: string[];
-        componentRestrictions?: {
-            country: string;
-        };
-    }): Promise<GooglePrediction[]>;
-    /** Get full place details by place_id. */
-    static getPlaceDetails(placeId: string): Promise<GooglePlaceDetails | null>;
-    /** Extract structured address fields from a Google PlaceDetails result. */
-    static extractAddressComponents(place: GooglePlaceDetails): ExtractedAddress;
-    /** Shorthand: extract into the flat shape used by address forms. */
-    static extractFormattedAddress(place: GooglePlaceDetails): FormattedAddress;
-}
-//# sourceMappingURL=autocomplete.d.ts.map

package/dist/core/helpers/autocomplete.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"autocomplete.d.ts","sourceRoot":"","sources":["../../../src/core/helpers/autocomplete.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,MAAM,CAAC,EAAE;YACP,IAAI,CAAC,EAAE;gBACL,MAAM,CAAC,EAAE;oBACP,mBAAmB,EAAE,UAAU,GAAG,CAAC;oBACnC,aAAa,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,GAAG,CAAC;oBACpC,mBAAmB,EAAE;wBAAE,EAAE,EAAE,MAAM,CAAC;wBAAC,YAAY,EAAE,MAAM,CAAA;qBAAE,CAAC;iBAC3D,CAAC;gBACF,GAAG,EAAE,KAAK,EAAE,EAAE,WAAW,KAAK,GAAG,CAAC;aACnC,CAAC;SACH,CAAC;KACH;CACF;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;CACvE;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACtF,QAAQ,CAAC,EAAE;QAAE,QAAQ,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CACvD;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB,EAAE,MAAM,CAAC;IACjC,4BAA4B,EAAE,MAAM,CAAC;IACrC,wBAAwB,EAAE,MAAM,CAAC;IACjC,4BAA4B,EAAE,MAAM,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAgBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAClE,OAAO,CAAC,IAAI,CAAC,CAyCf;AAMD,qBAAa,sBAAsB;IACjC,sCAAsC;WACzB,YAAY,CACvB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,qBAAqB,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;KAAO,GAC9E,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAc9B,0CAA0C;WAC7B,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAcjF,2EAA2E;IAC3E,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,kBAAkB,GAAG,gBAAgB;IAwE5E,oEAAoE;IACpE,MAAM,CAAC,uBAAuB,CAAC,KAAK,EAAE,kBAAkB,GAAG,gBAAgB;CAU5E"}