@active-reach/web-sdk 1.15.0 → 1.19.0

package/dist/chat/AegisChat.d.ts

@@ -0,0 +1,138 @@
+/**
+ * AegisChat — the website / in-app "Shopping Assistant" launcher (Track A).
+ *
+ * A floating bottom-right bubble that expands into a chat panel, letting a
+ * customer converse with the SAME channel-neutral chat agent that powers
+ * WhatsApp. This is pure transport + surface — it does NOT contain any agent
+ * intelligence. Messages go to the gateway (`POST /v1/chat/message` →
+ * `chatbot.inbound channel='web'`); replies arrive as a thin `chat.message`
+ * SSE nudge (per-session, ticket-authed) that triggers a re-fetch of the
+ * rendered thread from `GET /v1/chat/history`. REST polling is the fallback
+ * when the panel is closed or SSE drops.
+ *
+ * Identity: true-anonymous visitors work — we send the SDK's `anonymous_id`
+ * (first-party cookie) and the server resolves/creates a stable contact. The
+ * server returns the opaque `contact_id`, which we echo on every subsequent
+ * message so the server hits the indexed PK path (and the anon→known stitch
+ * upgrades the contact when the customer later identifies).
+ *
+ * Rendering reuses the `web` payload the backend already emits
+ * (`chat_response_renderer.py`): text + `{type:'product_carousel', products:[…]}`.
+ */
+export interface AegisChatConfig {
+    writeKey: string;
+    /** Gateway origin (the single public SDK surface). Falls back to same-origin. */
+    apiHost?: string;
+    organizationId?: string;
+    /** Known contact id when the visitor is already identified; else anonymous. */
+    contactId?: string;
+    /** 'web' (browser) or 'in_app' (mobile webview). Opaque to the agent. */
+    channel?: 'web' | 'in_app';
+    debugMode?: boolean;
+    /** Launcher header title shown to the customer. Default "Shopping Assistant";
+     *  the storefront passes "Ask {Brand}". */
+    title?: string;
+    /** First assistant greeting bubble + attention tooltip text. */
+    greeting?: string;
+    /** Accent colour for the bubble + customer bubbles. Defaults to brand. */
+    accentColor?: string;
+    /** Bubble icon style. 'sparkle' (default, signals AI) | 'chat' (plain bubble)
+     *  | 'logo' (renders `logoUrl`). No robot — brand-friendly by design. */
+    icon?: 'sparkle' | 'chat' | 'logo';
+    /** Image URL used when `icon: 'logo'` (brand logo / mascot). */
+    logoUrl?: string;
+    /** Corner the launcher docks to. */
+    position?: 'bottom-right' | 'bottom-left';
+    /** Chat agent persona key bound to this launcher (campaign-driven). Sent to
+     *  the backend on /v1/chat/message; honored server-side (Active Web Chat
+     *  Phase E). Absent = the tenant's default persona. */
+    agentPersona?: string;
+    /** Quick-reply chips offered under the greeting (campaign-driven). */
+    quickReplies?: string[];
+    /** Fired when the panel transitions closed→open — a chat session begins.
+     *  Used by the Active Web Chat renderer to report a campaign engagement. */
+    onSessionStart?: () => void;
+    /** Fired when the panel transitions open→closed — the session ends. */
+    onSessionEnd?: () => void;
+    /** Fired after a customer message is accepted by the server. */
+    onMessageSent?: () => void;
+}
+export declare class AegisChat {
+    private readonly writeKey;
+    private readonly apiHost;
+    private contactId?;
+    private readonly channel;
+    private readonly debugMode;
+    private readonly title;
+    private readonly greeting;
+    private readonly accent;
+    private readonly icon;
+    private readonly logoUrl?;
+    private readonly position;
+    private readonly agentPersona?;
+    private readonly quickReplies?;
+    private readonly onSessionStart?;
+    private readonly onSessionEnd?;
+    private readonly onMessageSent?;
+    private anonymousId?;
+    /** Per-session SSE ticket from the last /message response. Authorizes both
+     *  the SSE subscription AND the contact-scoped /history read (the server
+     *  requires it — chat history is not readable by contact_id alone). */
+    private sseTicket?;
+    private open;
+    private initialized;
+    private root?;
+    private bubble?;
+    private panel?;
+    private thread?;
+    private input?;
+    private unread;
+    private badge?;
+    private eventSource?;
+    private pollTimer?;
+    private renderedIds;
+    /** Contents of optimistically-rendered customer messages awaiting their
+     *  server echo — used to dedup the history refetch (double-message fix). */
+    private pendingEcho;
+    private typingEl?;
+    private greetingTip?;
+    private attentionTimer?;
+    private hasInteracted;
+    constructor(config: AegisChatConfig);
+    initialize(): void;
+    /** Called by the runtime when the visitor identifies. */
+    updateContactId(contactId: string): void;
+    /** Programmatic open (used by the proactive TriggerEngine wiring). */
+    openPanel(prefill?: string): void;
+    closePanel(): void;
+    destroy(): void;
+    private send;
+    private connectSSE;
+    private disconnectSSE;
+    private startPolling;
+    private stopPolling;
+    private refreshHistory;
+    /** Bubble glyph by config. Default 'sparkle' (signals AI, brand-friendly —
+     *  never a robot). 'logo' renders the brand image; falls back to sparkle. */
+    private bubbleIconHtml;
+    private mount;
+    /** Campaign-configured quick-reply chips shown under the greeting. Tapping a
+     *  chip sends it as the customer's first message, then the row is removed. */
+    private renderQuickReplies;
+    private appendBubble;
+    /** Render a `web`-format interactive message. Currently product_carousel. */
+    private renderInteractive;
+    private appendSystem;
+    private appendSystemGreeting;
+    private bumpUnread;
+    private clearUnread;
+    private scrollToBottom;
+    private readAnonId;
+    private showTyping;
+    private hideTyping;
+    private scheduleAttention;
+    private dismissAttention;
+    private log;
+    private injectStyles;
+}
+//# sourceMappingURL=AegisChat.d.ts.map

package/dist/chat/AegisChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AegisChat.d.ts","sourceRoot":"","sources":["../../src/chat/AegisChat.ts"],"names":[],"mappings":"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"}

package/dist/chat/index.d.ts

@@ -0,0 +1,3 @@
+export { AegisChat } from './AegisChat';
+export type { AegisChatConfig } from './AegisChat';
+//# sourceMappingURL=index.d.ts.map

package/dist/chat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chat/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/core/analytics.d.ts

@@ -4,6 +4,30 @@ import { ConsentPreferences, ConsentCategory } from '../utils/consent';
 import { EcommerceTracker } from '../ecommerce';
 import { EventGovernanceHint } from '../governance';
 import { UserNamespace } from './user-namespace';
+/** One redeemable reward for the identified contact (from `contact_entitlements`). */
+export interface EntitlementItem {
+    id: string;
+    /** coupon | discount | points | free_delivery | freebie */
+    type: string;
+    label: string | null;
+    /** Real, redeemable code (coupon/discount) — apply at checkout. */
+    coupon_code: string | null;
+    /** Awarded points (points grants). */
+    points: number | null;
+    /** Outlet the grant is attributed to; null = org-wide. */
+    location_id: string | null;
+    /** ISO 8601 expiry, or null for no expiry. */
+    expires_at: string | null;
+}
+/** Response of `aegis.getRewards()` / `GET /api/v1/sdk/entitlements`. */
+export interface RewardsResponse {
+    contact_id: string;
+    loyalty: {
+        points_balance: number;
+        tier: string | null;
+    };
+    entitlements: EntitlementItem[];
+}
 export declare class Aegis {
     private config;
     private storage;
@@ -177,10 +201,10 @@ export declare class Aegis {
      */
     /**
      * Public so peer SDK surfaces (AegisMessageRuntime / AegisInAppManager /
-     * AegisPlacementManager / AegisWidgetManager) can plumb the same
+     * AegisWidgetManager) can plumb the same
      * resolved workspace into their own gateway POSTs. Each manager calls
      * the gateway on its own endpoint (`/v1/in_app/events`,
-     * `/v1/placements/track`, `/v1/widgets/track-event`); without this,
+     * `/v1/widgets/track-event`); without this,
      * those events arrive at event-ingress with no workspace_id stamped
      * → impressions/clicks fall back to the org's primary workspace and
      * cross-outlet attribution breaks.
@@ -225,6 +249,17 @@ export declare class Aegis {
     flush(): Promise<void>;
     getAnonymousId(): string | null;
     getUserId(): string | null;
+    /**
+     * Fetch the identified contact's REDEEMABLE rewards — coupon codes the
+     * storefront can auto-apply at checkout + loyalty points balance/tier.
+     * Mirrors `GET /api/v1/sdk/entitlements`. Returns `null` when the SDK is
+     * uninitialised, the contact is anonymous, the endpoint returns 204 (nothing
+     * to show), or on any network/HTTP error — callers degrade gracefully.
+     *
+     * Scoped to the identified contact (own grants only) and, when an outlet is
+     * resolvable (`getEffectiveLocationId()`), to org-wide + that outlet's grants.
+     */
+    getRewards(): Promise<RewardsResponse | null>;
     getSessionId(): string | null;
     /**
      * B1.2 — Tenant-Pixel coexistence handoff. Returns the messageId of the

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

@@ -1 +1 @@
-{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/core/analytics.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EAGX,YAAY,EACb,MAAM,iBAAiB,CAAC;AAUzB,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAUzC,OAAO,EAAkB,kBAAkB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAgB,mBAAmB,EAAiB,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,QAAQ,CAAY;IAC5B,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,YAAY,CAAoC;IAKxD,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,kBAAkB,CAAyC;IACnE,OAAO,CAAC,qBAAqB,CAA4C;IAQzE,OAAO,CAAC,aAAa,CAAkC;IAMvD,OAAO,CAAC,eAAe,CAA0B;IAKjD,OAAO,CAAC,iBAAiB,CAAuB;IAQhD,OAAO,CAAC,gBAAgB,CAAuB;IAEzC,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC;YASF,KAAK;IAuGnB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAkCxB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,uBAAuB;YAWjB,iBAAiB;IAU/B,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAUzB;;;;;;;;;;OAUG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhC;;;;;;;;;;;OAWG;IACH,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAO9D;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAgB3C,uDAAuD;IACvD,cAAc,IAAI,IAAI;IAatB;;;;;;;;;;;OAWG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAa7D;;;;;;;;;;;;;OAaG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAgB1C,sDAAsD;IACtD,aAAa,IAAI,IAAI;IAIrB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;;;;;;;;;;;;;;;OAgBG;IACI,sBAAsB,IAAI,MAAM,GAAG,SAAS;IAqCnD;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH;;;;;;;;;OASG;IACI,uBAAuB,IAAI,MAAM,GAAG,SAAS;IAmCpD,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAyBhE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IA4B5D,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAoB3D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAuB1D,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAmB9B;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;YAwB9C,YAAY;IAyF1B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAqBzB,KAAK,IAAI,IAAI;IAWb;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IASxE;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IA8BxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,cAAc,IAAI,MAAM,GAAG,IAAI;IAK/B,SAAS,IAAI,MAAM,GAAG,IAAI;IAK1B,YAAY,IAAI,MAAM,GAAG,IAAI;IAK7B;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI7C,KAAK,CAAC,MAAM,GAAE,OAAc,GAAG,IAAI;IAYnC,OAAO,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI;IAmBzC,WAAW;;;;IASX,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI;IAU1D,YAAY,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI;IAa9C,WAAW,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI;IAa7C,UAAU,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO;IAQ9C,qBAAqB,IAAI,kBAAkB,GAAG,IAAI;IAQlD,eAAe,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI;IAShF,OAAO,CAAC,iBAAiB;IAQzB,IAAI,SAAS,IAAI,gBAAgB,CAKhC;IAED,IAAI,IAAI,IAAI,aAAa,CAKxB;IAED,OAAO,IAAI,IAAI;CAwBhB"}
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/core/analytics.ts"],"names":[],"mappings":"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"}

package/dist/ecommerce/index.d.ts

@@ -4,20 +4,24 @@
  * Provides standardized e-commerce event tracking that maps to the
  * Active Reach Intelligence data governance pipeline.
  *
- * Event names follow the canonical mapper:
- *   product_viewed      → engagement.product_view
- *   product_list_viewed → engagement.product_list_view
- *   cart_item_added     → cart_item_added
- *   cart_item_removed   → cart_item_removed
- *   cart_viewed         → cart_viewed
- *   checkout_started    → checkout_started
- *   checkout_step       → checkout_step
- *   order_completed     → transaction.purchase
- *   order_refunded      → transaction.refund
- *   coupon_applied      → coupon_applied
- *   coupon_removed      → coupon_removed
- *   search_performed    → search_performed
- *   wishlist_item_added → wishlist_item_added
+ * Event names follow the canonical mapper (libs/gateway-core/src/canonical-event.ts).
+ * The dotted-vs-flat split is intentional, not accidental: HIGH-VALUE lifecycle
+ * moments are namespaced `domain.action` (transaction.*, engagement.*); raw
+ * funnel telemetry that maps 1:1 to a Meta-standard event stays flat snake_case
+ * (its name is a frozen contract with the Meta CAPI/pixel maps). Don't "tidy"
+ * either side — see the convention block in canonical-event.ts.
+ *   product_viewed      → product_viewed              (flat)
+ *   product_list_viewed → product_list_viewed         (flat)
+ *   product_clicked     → engagement.product_click    (dotted)
+ *   cart_item_added     → cart_item_added             (flat)
+ *   cart_item_removed   → cart_item_removed           (flat)
+ *   cart_viewed         → cart_viewed                 (flat)
+ *   checkout_started    → checkout_started            (flat)
+ *   order_completed     → transaction.purchase        (dotted)
+ *   order_refunded      → transaction.refund          (dotted)
+ *   coupon_applied      → coupon_applied              (flat)
+ *   search_performed    → engagement.search           (dotted)
+ *   wishlist_item_added → wishlist_item_added         (flat)
  *   product_waitlisted  → product_waitlisted (back-in-stock waitlist opt-in;
  *                         consumed by product_event_trigger_service
  *                         _get_waitlisted_contacts; fires catalog.back_in_stock
@@ -52,11 +56,25 @@ export declare class EcommerceTracker {
     cartViewed(cart: EcommerceCart): void;
     checkoutStarted(checkout: EcommerceCheckout): void;
     checkoutStep(step: number, options?: Record<string, unknown>): void;
+    checkoutOption(option: {
+        step?: number;
+        payment_method?: string;
+        shipping_method?: string;
+        option_id?: string;
+        option_label?: string;
+    }): void;
     orderCompleted(order: EcommerceOrder): void;
     orderRefunded(orderId: string, value?: number, products?: EcommerceProduct[]): void;
+    orderShipped(orderId: string, tracking?: {
+        carrier?: string;
+        tracking_code?: string;
+        tracking_url?: string;
+    }): void;
     couponApplied(coupon: EcommerceCoupon): void;
     couponRemoved(coupon: EcommerceCoupon): void;
+    couponDenied(coupon: EcommerceCoupon, reason?: string): void;
     wishlistItemAdded(wishlist: EcommerceWishlist): void;
+    productRemovedFromWishlist(wishlist: EcommerceWishlist): void;
     productWaitlisted(waitlist: EcommerceWaitlist): void;
     promotionViewed(promo: EcommercePromotion): void;
     promotionClicked(promo: EcommercePromotion): void;

package/dist/ecommerce/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ecommerce/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AA0CjB,qBAAa,gBAAgB;IACf,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,KAAK;IAIhC,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAgB9C,iBAAiB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI;IASnD,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAgBnH,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAcrH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAQzG,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAU9C,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAe1C,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAY/C,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAYrC,eAAe,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAalD,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IASnE,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAgB3C,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,gBAAgB,EAAE,GAAG,IAAI;IAUnF,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAI5C,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAM5C,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAoBpD,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAapD,eAAe,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAIhD,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;CAGlD;AAED,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ecommerce/index.ts"],"names":[],"mappings":"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"}