@mission_sciences/provider-sdk 0.3.0-dev.31ea3d4 → 0.3.0-dev.6e896da

package/dist/adapters/vue/useMarketplaceSession.d.ts

@@ -22,6 +22,7 @@ export declare function useMarketplaceSession(options?: UseMarketplaceSessionOpt
         getFormattedTime: () => string;
         getFormattedTimeWithHours: () => string;
         isTimerRunning: () => boolean;
+        requestPurchase: (itemId: string) => void;
         getPurchaseStateManager: () => import('../../core/PurchaseStateManager').PurchaseStateManager;
         destroy: () => void;
     } | null, MarketplaceSDK | {
@@ -38,6 +39,7 @@ export declare function useMarketplaceSession(options?: UseMarketplaceSessionOpt
         getFormattedTime: () => string;
         getFormattedTimeWithHours: () => string;
         isTimerRunning: () => boolean;
+        requestPurchase: (itemId: string) => void;
         getPurchaseStateManager: () => import('../../core/PurchaseStateManager').PurchaseStateManager;
         destroy: () => void;
     } | null>;

package/dist/adapters/vue/useMarketplaceSession.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMarketplaceSession.d.ts","sourceRoot":"","sources":["../../../src/adapters/vue/useMarketplaceSession.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAElG,MAAM,WAAW,4BAA6B,SAAQ,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5E,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;CAC5B;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,4BAAiE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4F/G"}
+{"version":3,"file":"useMarketplaceSession.d.ts","sourceRoot":"","sources":["../../../src/adapters/vue/useMarketplaceSession.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAElG,MAAM,WAAW,4BAA6B,SAAQ,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5E,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;CAC5B;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,4BAAiE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4F/G"}

package/dist/core/MarketplaceSDK.d.ts

@@ -22,6 +22,7 @@ export declare class MarketplaceSDK {
     private jwtToken;
     private endReason;
     private purchaseStateManager;
+    private purchaseModal;
     constructor(config: SDKConfig);
     /**
      * Register event handlers
@@ -99,6 +100,11 @@ export declare class MarketplaceSDK {
      * Check if timer is running
      */
     isTimerRunning(): boolean;
+    /**
+     * Request purchase of an item — opens PurchaseModal directly
+     * Bypasses the add-ons panel; works for any active item (visible or hidden)
+     */
+    requestPurchase(itemId: string): void;
     /**
      * Get purchase state manager for item purchase state checking
      */

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

@@ -1 +1 @@
-{"version":3,"file":"MarketplaceSDK.d.ts","sourceRoot":"","sources":["../../src/core/MarketplaceSDK.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAI9D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAiG,MAAM,UAAU,CAAC;AAE5J;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,oBAAoB,CAAuB;gBAEvC,MAAM,EAAE,SAAS;IAwC7B;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAKpE;;OAEG;YACW,WAAW;IAuCzB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAO/B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IA+LxC;;OAEG;YACW,mBAAmB;IAkCjC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAapC;;OAEG;IACH,UAAU,IAAI,IAAI;IAYlB;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;OAEG;IACH,WAAW,IAAI,IAAI;IAMnB;;OAEG;IACG,aAAa,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoE7D;;OAEG;IACG,eAAe,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgDjE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2DjC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0CxB;;OAEG;IACH,cAAc,IAAI,WAAW,GAAG,IAAI;IAIpC;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,yBAAyB,IAAI,MAAM;IAInC;;OAEG;IACH,cAAc,IAAI,OAAO;IAIzB;;OAEG;IACH,uBAAuB,IAAI,oBAAoB;IAI/C;;OAEG;IACH,OAAO,IAAI,IAAI;CAgBhB"}
+{"version":3,"file":"MarketplaceSDK.d.ts","sourceRoot":"","sources":["../../src/core/MarketplaceSDK.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAI9D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAgI,MAAM,UAAU,CAAC;AAG3L;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,aAAa,CAA8B;gBAEvC,MAAM,EAAE,SAAS;IAwC7B;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAKpE;;OAEG;YACW,WAAW;IAuCzB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAO/B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IA+LxC;;OAEG;YACW,mBAAmB;IAkCjC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAapC;;OAEG;IACH,UAAU,IAAI,IAAI;IAYlB;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;OAEG;IACH,WAAW,IAAI,IAAI;IAMnB;;OAEG;IACG,aAAa,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoE7D;;OAEG;IACG,eAAe,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgDjE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2DjC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0CxB;;OAEG;IACH,cAAc,IAAI,WAAW,GAAG,IAAI;IAIpC;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,yBAAyB,IAAI,MAAM;IAInC;;OAEG;IACH,cAAc,IAAI,OAAO;IAIzB;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IA4ErC;;OAEG;IACH,uBAAuB,IAAI,oBAAoB;IAI/C;;OAEG;IACH,OAAO,IAAI,IAAI;CAiBhB"}

package/dist/index.d.ts

@@ -11,10 +11,12 @@ export { TabSyncManager } from './core/TabSyncManager';
 export type { TabSyncMessage } from './core/TabSyncManager';
 export { WarningModal } from './ui/WarningModal';
 export { SessionHeader } from './ui/SessionHeader';
+export { PurchaseModal } from './ui/PurchaseModal';
 export { lightTheme, darkTheme, getTheme, generateCSSVariables } from './styles/theme';
 export type { Theme, ThemeColors, ThemeTypography, ThemeSpacing } from './styles/theme';
 export type { SDKConfig, SessionData, SDKEvents, ModalStyles, ThemeMode, JWTHeader, JWTClaims, JWKSKey, JWKSResponse, SessionLifecycleHooks, SessionStartContext, SessionEndContext, SessionExtendContext, SessionWarningContext, } from './types';
-export { SDKError } from './types';
+export { SDKError, PurchaseError } from './types';
+export type { PurchaseResult } from './types';
 export { extractTokenFromURL, isBrowser } from './utils/url';
 export { Logger } from './utils/logger';
 export { MarketplaceSDK as default } from './core/MarketplaceSDK';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACvF,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGxF,YAAY,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,WAAW,EACX,SAAS,EACT,SAAS,EACT,SAAS,EACT,OAAO,EACP,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnC,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxC,OAAO,EAAE,cAAc,IAAI,OAAO,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACvF,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGxF,YAAY,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,WAAW,EACX,SAAS,EACT,SAAS,EACT,SAAS,EACT,OAAO,EACP,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9C,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxC,OAAO,EAAE,cAAc,IAAI,OAAO,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/marketplace-sdk.es.js

@@ -20,6 +20,13 @@ class SDKError extends Error {
     }
   }
 }
+class PurchaseError extends SDKError {
+  constructor(message2, code, itemId, statusCode) {
+    super(message2, code, statusCode);
+    this.itemId = itemId;
+    this.name = "PurchaseError";
+  }
+}
 var PurchaseState = /* @__PURE__ */ ((PurchaseState2) => {
   PurchaseState2["AVAILABLE"] = "AVAILABLE";
   PurchaseState2["PRIVY_REQUIRED"] = "PRIVY_REQUIRED";
@@ -2558,6 +2565,166 @@ function extractTokenFromURL(paramName = "gwSession", url) {
 function isBrowser() {
   return typeof window !== "undefined" && typeof window.document !== "undefined";
 }
+class PurchaseModal {
+  constructor(themeMode = "light", customStyles) {
+    this.modal = null;
+    this.legacyStyles = null;
+    const prefersDark = themeMode === "dark" || themeMode === "auto" && this.detectDarkMode();
+    this.theme = getTheme(prefersDark);
+    if (customStyles) {
+      this.legacyStyles = {
+        backgroundColor: customStyles.backgroundColor || "#ffffff",
+        textColor: customStyles.textColor || "#333333",
+        primaryColor: customStyles.primaryColor || "#007bff",
+        borderRadius: customStyles.borderRadius || "8px",
+        fontFamily: customStyles.fontFamily || '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif'
+      };
+    }
+  }
+  detectDarkMode() {
+    if (typeof window !== "undefined" && window.matchMedia) {
+      return window.matchMedia("(prefers-color-scheme: dark)").matches;
+    }
+    return false;
+  }
+  escapeHtml(text) {
+    return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+  }
+  /**
+   * Show purchase confirmation modal
+   */
+  show(options) {
+    this.hide();
+    this.modal = document.createElement("div");
+    this.modal.id = "gw-purchase-modal";
+    this.modal.style.cssText = `
+      position: fixed;
+      top: 0;
+      left: 0;
+      width: 100%;
+      height: 100%;
+      background-color: rgba(0, 0, 0, 0.5);
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      z-index: 99999;
+      font-family: ${this.legacyStyles?.fontFamily || this.theme.typography.fontFamily};
+    `;
+    const content = document.createElement("div");
+    const bgColor = this.legacyStyles?.backgroundColor || this.theme.colors.card;
+    const textColor = this.legacyStyles?.textColor || this.theme.colors.cardForeground;
+    const borderRadius = this.legacyStyles?.borderRadius || this.theme.spacing.borderRadius.lg;
+    content.style.cssText = `
+      background-color: ${bgColor};
+      color: ${textColor};
+      border-radius: ${borderRadius};
+      padding: ${this.theme.spacing.padding.lg};
+      max-width: 400px;
+      width: 90%;
+      box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
+      border: 1px solid ${this.theme.colors.border};
+    `;
+    content.innerHTML = `
+      <h2 style="margin: 0 0 ${this.theme.spacing.padding.md} 0; font-size: ${this.theme.typography.fontSize.xl}; font-weight: ${this.theme.typography.fontWeight.semibold}; color: ${textColor};">
+        🛒 Confirm Purchase
+      </h2>
+      <p style="margin: 0 0 ${this.theme.spacing.padding.lg} 0; font-size: ${this.theme.typography.fontSize.base}; line-height: ${this.theme.typography.lineHeight.normal}; color: ${this.theme.colors.mutedForeground};">
+        Are you sure you want to purchase item <strong style="color: ${textColor};">${this.escapeHtml(options.itemId)}</strong>?
+      </p>
+      <div style="display: flex; gap: ${this.theme.spacing.gap.md}; justify-content: flex-end;">
+        <button id="gw-cancel-btn" style="
+          padding: 10px 20px;
+          background-color: ${this.theme.colors.secondary};
+          color: ${this.theme.colors.secondaryForeground};
+          border: 1px solid ${this.theme.colors.border};
+          border-radius: ${this.theme.spacing.borderRadius.sm};
+          font-size: ${this.theme.typography.fontSize.sm};
+          font-weight: ${this.theme.typography.fontWeight.medium};
+          cursor: pointer;
+          transition: all 0.2s;
+          font-family: ${this.theme.typography.fontFamily};
+        ">
+          Cancel
+        </button>
+        <button id="gw-confirm-btn" style="
+          padding: 10px 20px;
+          background-color: ${this.theme.colors.primary};
+          color: ${this.theme.colors.primaryForeground};
+          border: none;
+          border-radius: ${this.theme.spacing.borderRadius.sm};
+          font-size: ${this.theme.typography.fontSize.sm};
+          font-weight: ${this.theme.typography.fontWeight.medium};
+          cursor: pointer;
+          transition: all 0.2s;
+          font-family: ${this.theme.typography.fontFamily};
+        ">
+          Confirm Purchase
+        </button>
+      </div>
+    `;
+    this.modal.appendChild(content);
+    document.body.appendChild(this.modal);
+    const confirmBtn = document.getElementById("gw-confirm-btn");
+    if (confirmBtn && options.onConfirm) {
+      confirmBtn.addEventListener("click", () => {
+        options.onConfirm?.();
+        this.hide();
+      });
+    }
+    const cancelBtn = document.getElementById("gw-cancel-btn");
+    if (cancelBtn) {
+      cancelBtn.addEventListener("click", () => {
+        options.onCancel?.();
+        this.hide();
+      });
+    }
+    const buttons = content.querySelectorAll("button");
+    buttons.forEach((button) => {
+      button.addEventListener("mouseenter", () => {
+        button.style.opacity = "0.9";
+      });
+      button.addEventListener("mouseleave", () => {
+        button.style.opacity = "1";
+      });
+      button.addEventListener("focus", () => {
+        button.style.outline = `2px solid ${this.theme.colors.ring}`;
+        button.style.outlineOffset = "2px";
+      });
+      button.addEventListener("blur", () => {
+        button.style.outline = "none";
+      });
+    });
+    const handleKeyDown = (e) => {
+      if (e.key === "Escape") {
+        options.onCancel?.();
+        this.hide();
+        document.removeEventListener("keydown", handleKeyDown);
+      }
+    };
+    document.addEventListener("keydown", handleKeyDown);
+    this.modal.addEventListener("click", (e) => {
+      if (e.target === this.modal) {
+        options.onCancel?.();
+        this.hide();
+      }
+    });
+  }
+  /**
+   * Hide and remove modal
+   */
+  hide() {
+    if (this.modal && this.modal.parentNode) {
+      this.modal.parentNode.removeChild(this.modal);
+      this.modal = null;
+    }
+  }
+  /**
+   * Check if modal is currently shown
+   */
+  isShown() {
+    return this.modal !== null;
+  }
+}
 class MarketplaceSDK {
   constructor(config) {
     this.timer = null;
@@ -2568,6 +2735,7 @@ class MarketplaceSDK {
     this.sessionData = null;
     this.jwtToken = null;
     this.endReason = "manual";
+    this.purchaseModal = null;
     this.config = {
       jwksUri: config.jwksUri || "https://api.platform.generalwisdom.com/.well-known/jwks.json",
       jwtParamName: config.jwtParamName || "gwSession",
@@ -3104,6 +3272,73 @@ class MarketplaceSDK {
   isTimerRunning() {
     return this.timer?.isRunning() ?? false;
   }
+  /**
+   * Request purchase of an item — opens PurchaseModal directly
+   * Bypasses the add-ons panel; works for any active item (visible or hidden)
+   */
+  requestPurchase(itemId) {
+    if (!this.sessionData || !this.jwtToken) {
+      throw new SDKError("No active session", "NO_SESSION");
+    }
+    this.logger.info("Requesting purchase for item:", itemId);
+    this.events.onPurchaseStart?.({ itemId, quantity: 1 });
+    if (!this.purchaseModal) {
+      this.purchaseModal = new PurchaseModal(
+        this.config.themeMode || "light",
+        this.config.customStyles
+      );
+    }
+    this.purchaseModal.show({
+      itemId,
+      onConfirm: async () => {
+        try {
+          const response = await fetch(
+            `${this.config.apiEndpoint}/items/${itemId}/purchase`,
+            {
+              method: "POST",
+              headers: {
+                "Authorization": `Bearer ${this.jwtToken}`,
+                "Content-Type": "application/json"
+              },
+              body: JSON.stringify({ item_id: itemId, quantity: 1 })
+            }
+          );
+          if (!response.ok) {
+            throw new PurchaseError(
+              "Purchase failed",
+              "PURCHASE_FAILED",
+              itemId,
+              response.status
+            );
+          }
+          const data = await response.json();
+          const result = {
+            itemId,
+            transactionId: data.transactionId,
+            amount: data.amount
+          };
+          this.events.onPurchaseSuccess?.(result);
+          this.events.onPurchaseComplete?.(itemId);
+          if (data.newBalance !== void 0) {
+            this.events.onBalanceUpdate?.(data.newBalance);
+          }
+          this.logger.info("Purchase successful:", result);
+        } catch (error) {
+          const purchaseError = error instanceof PurchaseError ? error : new PurchaseError(
+            error instanceof Error ? error.message : "Purchase failed",
+            "PURCHASE_ERROR",
+            itemId
+          );
+          this.events.onPurchaseError?.(purchaseError);
+          this.logger.error("Purchase failed:", purchaseError);
+        }
+      },
+      onCancel: () => {
+        this.events.onPurchaseCancelled?.(itemId);
+        this.logger.info("Purchase cancelled for item:", itemId);
+      }
+    });
+  }
   /**
    * Get purchase state manager for item purchase state checking
    */
@@ -3119,6 +3354,7 @@ class MarketplaceSDK {
     this.heartbeat?.stop();
     this.tabSync?.destroy();
     this.modal?.hide();
+    this.purchaseModal?.hide();
     if (typeof sessionStorage !== "undefined") {
       sessionStorage.removeItem("gw_marketplace_jwt");
       this.logger.log("JWT token cleared from storage");
@@ -3329,6 +3565,8 @@ export {
   JWTParser,
   Logger,
   MarketplaceSDK,
+  PurchaseError,
+  PurchaseModal,
   SDKError,
   SessionHeader,
   TabSyncManager,