@mission_sciences/provider-sdk 0.3.0 → 0.4.0

package/dist/marketplace-sdk.es.js

@@ -20,6 +20,19 @@ 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";
+  PurchaseState2["INSUFFICIENT_FUNDS"] = "INSUFFICIENT_FUNDS";
+  return PurchaseState2;
+})(PurchaseState || {});
 class JWTParser {
   /**
    * Decode JWT payload without verification
@@ -2017,6 +2030,55 @@ class TabSyncManager {
     this.logger.log("Tab sync destroyed");
   }
 }
+class PurchaseStateManager {
+  constructor(config) {
+    this.config = {
+      timeout: 5e3,
+      ...config
+    };
+  }
+  /**
+   * Check purchase state for a specific item
+   * Filters raw API response to expose only safe data to publisher apps
+   */
+  async checkItemPurchaseState(itemId) {
+    try {
+      const response = await fetch(`${this.config.apiEndpoint}/items/${itemId}/purchase-state`, {
+        method: "GET",
+        headers: {
+          "Content-Type": "application/json"
+        },
+        signal: AbortSignal.timeout(this.config.timeout)
+      });
+      if (!response.ok) {
+        throw new Error(`API request failed: ${response.status} ${response.statusText}`);
+      }
+      const rawData = await response.json();
+      return this.filterPurchaseStateResponse(rawData);
+    } catch (error) {
+      if (error instanceof Error) {
+        throw error;
+      }
+      throw new Error("Unknown error occurred while checking purchase state");
+    }
+  }
+  /**
+   * Filters raw API response to expose only safe data to publisher apps
+   * CRITICAL: Raw privyEligibility map must NEVER be exposed to apps
+   */
+  filterPurchaseStateResponse(rawResponse) {
+    const filteredResponse = {
+      state: rawResponse.state
+    };
+    if (rawResponse.state === PurchaseState.PRIVY_REQUIRED && rawResponse.privyEligibility) {
+      const requiredLevels = Object.values(rawResponse.privyEligibility).filter((details) => details.requiresUpgrade).map((details) => details.requiredLevel);
+      if (requiredLevels.length > 0) {
+        filteredResponse.requiredLevel = Math.max(...requiredLevels);
+      }
+    }
+    return filteredResponse;
+  }
+}
 const lightTheme = {
   colors: {
     // Background
@@ -2503,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;
@@ -2513,8 +2735,21 @@ class MarketplaceSDK {
     this.sessionData = null;
     this.jwtToken = null;
     this.endReason = "manual";
+    this.purchaseModal = null;
+    if (!config.jwksUri) {
+      throw new SDKError(
+        "jwksUri is required — pass an environment-aware JWKS URL (e.g., https://api.dev.generalwisdom.com/.well-known/jwks.json). See README for environment-specific URLs.",
+        "CONFIG_MISSING_JWKS_URI"
+      );
+    }
+    if (!config.marketplaceUrl) {
+      throw new SDKError(
+        "marketplaceUrl is required — pass an environment-aware marketplace URL (e.g., https://dev.generalwisdom.com/). See README for environment-specific URLs.",
+        "CONFIG_MISSING_MARKETPLACE_URL"
+      );
+    }
     this.config = {
-      jwksUri: config.jwksUri || "https://api.platform.generalwisdom.com/.well-known/jwks.json",
+      jwksUri: config.jwksUri,
       jwtParamName: config.jwtParamName || "gwSession",
       apiEndpoint: config.apiEndpoint || "https://api.platform.generalwisdom.com",
       jwtIssuer: config.jwtIssuer || "generalwisdom.com",
@@ -2524,7 +2759,7 @@ class MarketplaceSDK {
       customStyles: config.customStyles ?? {},
       themeMode: config.themeMode ?? "light",
       applicationId: config.applicationId ?? "",
-      marketplaceUrl: config.marketplaceUrl ?? "https://platform.generalwisdom.com/",
+      marketplaceUrl: config.marketplaceUrl,
       // Phase 2 options
       enableHeartbeat: config.enableHeartbeat ?? false,
       heartbeatIntervalSeconds: config.heartbeatIntervalSeconds ?? 30,
@@ -2537,6 +2772,9 @@ class MarketplaceSDK {
     };
     this.validator = new JWKSValidator(this.config.jwksUri, this.config.debug);
     this.logger = new Logger(this.config.debug, "[MarketplaceSDK]");
+    this.purchaseStateManager = new PurchaseStateManager({
+      apiEndpoint: this.config.apiEndpoint
+    });
     this.logger.info("SDK initialized with config:", {
       jwksUri: this.config.jwksUri,
       jwtParamName: this.config.jwtParamName,
@@ -3046,6 +3284,79 @@ 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
+   */
+  getPurchaseStateManager() {
+    return this.purchaseStateManager;
+  }
   /**
    * Cleanup and destroy SDK instance
    */
@@ -3055,6 +3366,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");
@@ -3265,6 +3577,8 @@ export {
   JWTParser,
   Logger,
   MarketplaceSDK,
+  PurchaseError,
+  PurchaseModal,
   SDKError,
   SessionHeader,
   TabSyncManager,