@followgate/js 0.14.0 → 0.14.1

package/dist/index.d.mts

@@ -29,6 +29,7 @@ interface FollowGateConfig {
     onComplete?: () => void;
     theme?: 'dark' | 'light';
     accentColor?: string;
+    forceShow?: boolean;
 }
 /**
  * SDK Error class with helpful messages
@@ -93,6 +94,7 @@ declare class FollowGateClient {
     private completedActions;
     private modalElement;
     private stylesInjected;
+    private currentStep;
     /**
      * Initialize the SDK
      */
@@ -103,7 +105,7 @@ declare class FollowGateClient {
     private fetchServerConfig;
     /**
      * Show the FollowGate modal
-     * If user is already unlocked, calls onComplete immediately
+     * If user is already unlocked, calls onComplete immediately (unless forceShow is true)
      */
     show(): Promise<void>;
     /**

package/dist/index.d.ts

@@ -29,6 +29,7 @@ interface FollowGateConfig {
     onComplete?: () => void;
     theme?: 'dark' | 'light';
     accentColor?: string;
+    forceShow?: boolean;
 }
 /**
  * SDK Error class with helpful messages
@@ -93,6 +94,7 @@ declare class FollowGateClient {
     private completedActions;
     private modalElement;
     private stylesInjected;
+    private currentStep;
     /**
      * Initialize the SDK
      */
@@ -103,7 +105,7 @@ declare class FollowGateClient {
     private fetchServerConfig;
     /**
      * Show the FollowGate modal
-     * If user is already unlocked, calls onComplete immediately
+     * If user is already unlocked, calls onComplete immediately (unless forceShow is true)
      */
     show(): Promise<void>;
     /**

package/dist/index.js

@@ -503,6 +503,7 @@ var FollowGateClient = class {
   completedActions = [];
   modalElement = null;
   stylesInjected = false;
+  currentStep = "welcome";
   /**
    * Initialize the SDK
    */
@@ -598,22 +599,29 @@ var FollowGateClient = class {
   }
   /**
    * Show the FollowGate modal
-   * If user is already unlocked, calls onComplete immediately
+   * If user is already unlocked, calls onComplete immediately (unless forceShow is true)
    */
   async show() {
     if (!this.config) {
       throw new Error("[FollowGate] SDK not initialized. Call init() first.");
     }
     if (this.isUnlocked()) {
-      if (this.config.debug) {
-        console.log(
+      if (this.config.forceShow) {
+        this.clearUnlockStatus();
+        if (this.config.debug) {
+          console.log(
+            "[FollowGate] forceShow enabled - cleared unlock status, showing modal"
+          );
+        }
+      } else {
+        console.warn(
           "[FollowGate] Modal skipped - user already unlocked.",
-          "Call FollowGate.reset() to clear unlock status.",
+          "Use forceShow: true in init() to always show modal, or call FollowGate.reset() to clear.",
           this.config.userId ? `(userId: ${this.config.userId})` : "(no userId set)"
         );
+        this.config.onComplete?.();
+        return;
       }
-      this.config.onComplete?.();
-      return;
     }
     await this.fetchServerConfig();
     if (this.config.twitter?.username && !this.hasUsername()) {
@@ -625,6 +633,7 @@ var FollowGateClient = class {
         );
       }
     }
+    this.trackEvent("modal_opened");
     this.injectStyles();
     this.createModal();
   }
@@ -681,6 +690,7 @@ var FollowGateClient = class {
     document.body.appendChild(backdrop);
     this.modalElement = backdrop;
     document.getElementById("fg-close-btn")?.addEventListener("click", () => {
+      this.trackEvent("modal_closed", { step: this.currentStep });
       this.hide(true);
     });
     requestAnimationFrame(() => {
@@ -773,6 +783,8 @@ var FollowGateClient = class {
   renderUsernameStep() {
     const content = this.getContentElement();
     if (!content) return;
+    this.currentStep = "welcome";
+    this.trackEvent("step_viewed", { step: "welcome" });
     const handle = this.getTargetHandle();
     const hasRepost = this.shouldShowRepostStep();
     const allowSkip = this.serverConfig?.allowSkip ?? false;
@@ -824,11 +836,14 @@ var FollowGateClient = class {
   handleUsernameSubmit(username) {
     const normalized = username.replace(/^@/, "");
     this.setUsername(normalized);
+    this.trackEvent("username_submitted", { username: normalized });
     this.renderFollowStep();
   }
   renderFollowStep() {
     const content = this.getContentElement();
     if (!content) return;
+    this.currentStep = "follow";
+    this.trackEvent("step_viewed", { step: "follow" });
     const handle = this.getTargetHandle();
     if (!handle) {
       console.error(
@@ -871,6 +886,7 @@ var FollowGateClient = class {
     });
   }
   handleSkipFollow() {
+    this.trackEvent("step_skipped", { step: "follow" });
     if (this.shouldShowRepostStep()) {
       this.renderRepostStep();
     } else {
@@ -952,6 +968,8 @@ var FollowGateClient = class {
     const content = this.getContentElement();
     const postId = this.getTargetPostUrl();
     if (!content || !postId) return;
+    this.currentStep = "repost";
+    this.trackEvent("step_viewed", { step: "repost" });
     content.innerHTML = `
       ${this.renderStepIndicator(2)}
       <div class="fg-icon-box fg-success">
@@ -978,6 +996,7 @@ var FollowGateClient = class {
       this.handleRepostClick();
     });
     document.getElementById("fg-skip-repost")?.addEventListener("click", () => {
+      this.trackEvent("step_skipped", { step: "repost" });
       this.renderConfirmStep();
     });
   }
@@ -1049,6 +1068,8 @@ var FollowGateClient = class {
   renderConfirmStep() {
     const content = this.getContentElement();
     if (!content) return;
+    this.currentStep = "confirm";
+    this.trackEvent("step_viewed", { step: "confirm" });
     const username = this.currentUser?.username;
     const targetHandle = this.getTargetHandle();
     const postId = this.getTargetPostUrl();
@@ -1543,8 +1564,37 @@ var FollowGateClient = class {
         throw new Error(`[FollowGate] Unsupported LinkedIn action: ${action}`);
     }
   }
-  async trackEvent(event, data) {
+  async trackEvent(event, data = {}) {
     if (!this.config) return;
+    const payload = {
+      event
+    };
+    if (data.platform) {
+      payload.platform = data.platform.toUpperCase();
+    }
+    if (data.action) {
+      payload.action = data.action.toUpperCase();
+    }
+    if (data.target) {
+      payload.target = data.target;
+    }
+    if (data.username || this.currentUser?.username) {
+      payload.username = data.username || this.currentUser?.username;
+    }
+    if (data.externalUserId) {
+      payload.externalUserId = data.externalUserId;
+    }
+    const {
+      platform: _p,
+      action: _a,
+      target: _t,
+      username: _u,
+      externalUserId: _e,
+      ...rest
+    } = data;
+    if (Object.keys(rest).length > 0) {
+      payload.metadata = rest;
+    }
     try {
       await fetch(`${this.config.apiUrl}/api/v1/events`, {
         method: "POST",
@@ -1552,11 +1602,7 @@ var FollowGateClient = class {
           "Content-Type": "application/json",
           "X-API-Key": this.config.apiKey
         },
-        body: JSON.stringify({
-          event,
-          appId: this.config.appId,
-          ...data
-        })
+        body: JSON.stringify(payload)
       });
     } catch (error) {
       if (this.config.debug) {

package/dist/index.mjs

@@ -477,6 +477,7 @@ var FollowGateClient = class {
   completedActions = [];
   modalElement = null;
   stylesInjected = false;
+  currentStep = "welcome";
   /**
    * Initialize the SDK
    */
@@ -572,22 +573,29 @@ var FollowGateClient = class {
   }
   /**
    * Show the FollowGate modal
-   * If user is already unlocked, calls onComplete immediately
+   * If user is already unlocked, calls onComplete immediately (unless forceShow is true)
    */
   async show() {
     if (!this.config) {
       throw new Error("[FollowGate] SDK not initialized. Call init() first.");
     }
     if (this.isUnlocked()) {
-      if (this.config.debug) {
-        console.log(
+      if (this.config.forceShow) {
+        this.clearUnlockStatus();
+        if (this.config.debug) {
+          console.log(
+            "[FollowGate] forceShow enabled - cleared unlock status, showing modal"
+          );
+        }
+      } else {
+        console.warn(
           "[FollowGate] Modal skipped - user already unlocked.",
-          "Call FollowGate.reset() to clear unlock status.",
+          "Use forceShow: true in init() to always show modal, or call FollowGate.reset() to clear.",
           this.config.userId ? `(userId: ${this.config.userId})` : "(no userId set)"
         );
+        this.config.onComplete?.();
+        return;
       }
-      this.config.onComplete?.();
-      return;
     }
     await this.fetchServerConfig();
     if (this.config.twitter?.username && !this.hasUsername()) {
@@ -599,6 +607,7 @@ var FollowGateClient = class {
         );
       }
     }
+    this.trackEvent("modal_opened");
     this.injectStyles();
     this.createModal();
   }
@@ -655,6 +664,7 @@ var FollowGateClient = class {
     document.body.appendChild(backdrop);
     this.modalElement = backdrop;
     document.getElementById("fg-close-btn")?.addEventListener("click", () => {
+      this.trackEvent("modal_closed", { step: this.currentStep });
       this.hide(true);
     });
     requestAnimationFrame(() => {
@@ -747,6 +757,8 @@ var FollowGateClient = class {
   renderUsernameStep() {
     const content = this.getContentElement();
     if (!content) return;
+    this.currentStep = "welcome";
+    this.trackEvent("step_viewed", { step: "welcome" });
     const handle = this.getTargetHandle();
     const hasRepost = this.shouldShowRepostStep();
     const allowSkip = this.serverConfig?.allowSkip ?? false;
@@ -798,11 +810,14 @@ var FollowGateClient = class {
   handleUsernameSubmit(username) {
     const normalized = username.replace(/^@/, "");
     this.setUsername(normalized);
+    this.trackEvent("username_submitted", { username: normalized });
     this.renderFollowStep();
   }
   renderFollowStep() {
     const content = this.getContentElement();
     if (!content) return;
+    this.currentStep = "follow";
+    this.trackEvent("step_viewed", { step: "follow" });
     const handle = this.getTargetHandle();
     if (!handle) {
       console.error(
@@ -845,6 +860,7 @@ var FollowGateClient = class {
     });
   }
   handleSkipFollow() {
+    this.trackEvent("step_skipped", { step: "follow" });
     if (this.shouldShowRepostStep()) {
       this.renderRepostStep();
     } else {
@@ -926,6 +942,8 @@ var FollowGateClient = class {
     const content = this.getContentElement();
     const postId = this.getTargetPostUrl();
     if (!content || !postId) return;
+    this.currentStep = "repost";
+    this.trackEvent("step_viewed", { step: "repost" });
     content.innerHTML = `
       ${this.renderStepIndicator(2)}
       <div class="fg-icon-box fg-success">
@@ -952,6 +970,7 @@ var FollowGateClient = class {
       this.handleRepostClick();
     });
     document.getElementById("fg-skip-repost")?.addEventListener("click", () => {
+      this.trackEvent("step_skipped", { step: "repost" });
       this.renderConfirmStep();
     });
   }
@@ -1023,6 +1042,8 @@ var FollowGateClient = class {
   renderConfirmStep() {
     const content = this.getContentElement();
     if (!content) return;
+    this.currentStep = "confirm";
+    this.trackEvent("step_viewed", { step: "confirm" });
     const username = this.currentUser?.username;
     const targetHandle = this.getTargetHandle();
     const postId = this.getTargetPostUrl();
@@ -1517,8 +1538,37 @@ var FollowGateClient = class {
         throw new Error(`[FollowGate] Unsupported LinkedIn action: ${action}`);
     }
   }
-  async trackEvent(event, data) {
+  async trackEvent(event, data = {}) {
     if (!this.config) return;
+    const payload = {
+      event
+    };
+    if (data.platform) {
+      payload.platform = data.platform.toUpperCase();
+    }
+    if (data.action) {
+      payload.action = data.action.toUpperCase();
+    }
+    if (data.target) {
+      payload.target = data.target;
+    }
+    if (data.username || this.currentUser?.username) {
+      payload.username = data.username || this.currentUser?.username;
+    }
+    if (data.externalUserId) {
+      payload.externalUserId = data.externalUserId;
+    }
+    const {
+      platform: _p,
+      action: _a,
+      target: _t,
+      username: _u,
+      externalUserId: _e,
+      ...rest
+    } = data;
+    if (Object.keys(rest).length > 0) {
+      payload.metadata = rest;
+    }
     try {
       await fetch(`${this.config.apiUrl}/api/v1/events`, {
         method: "POST",
@@ -1526,11 +1576,7 @@ var FollowGateClient = class {
           "Content-Type": "application/json",
           "X-API-Key": this.config.apiKey
         },
-        body: JSON.stringify({
-          event,
-          appId: this.config.appId,
-          ...data
-        })
+        body: JSON.stringify(payload)
       });
     } catch (error) {
       if (this.config.debug) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@followgate/js",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "description": "FollowGate SDK - Grow your audience with every download. Require social actions (follow, repost) before users can access your app.",
   "author": "FollowGate <hello@followgate.app>",
   "homepage": "https://followgate.app",