@followgate/js 0.12.1 → 0.13.0

package/dist/index.d.mts

@@ -28,6 +28,7 @@ interface FollowGateConfig {
     onComplete?: () => void;
     theme?: 'dark' | 'light';
     accentColor?: string;
+    forceShow?: boolean;
 }
 /**
  * SDK Error class with helpful messages
@@ -102,7 +103,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>;
     /**
@@ -147,9 +148,14 @@ declare class FollowGateClient {
      */
     hasUsername(): boolean;
     /**
-     * Clear stored session
+     * Clear stored session (user, actions, and unlock status)
      */
     reset(): void;
+    /**
+     * Clear only the unlock status (keeps user and actions)
+     * Useful for allowing users to go through the flow again
+     */
+    clearUnlockStatus(): void;
     getFollowUrl(platform: Platform, target: string): string;
     getRepostUrl(platform: Platform, target: string): string;
     getLikeUrl(platform: Platform, target: string): string;

package/dist/index.d.ts

@@ -28,6 +28,7 @@ interface FollowGateConfig {
     onComplete?: () => void;
     theme?: 'dark' | 'light';
     accentColor?: string;
+    forceShow?: boolean;
 }
 /**
  * SDK Error class with helpful messages
@@ -102,7 +103,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>;
     /**
@@ -147,9 +148,14 @@ declare class FollowGateClient {
      */
     hasUsername(): boolean;
     /**
-     * Clear stored session
+     * Clear stored session (user, actions, and unlock status)
      */
     reset(): void;
+    /**
+     * Clear only the unlock status (keeps user and actions)
+     * Useful for allowing users to go through the flow again
+     */
+    clearUnlockStatus(): void;
     getFollowUrl(platform: Platform, target: string): string;
     getRepostUrl(platform: Platform, target: string): string;
     getLikeUrl(platform: Platform, target: string): string;

package/dist/index.js

@@ -598,18 +598,27 @@ 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("[FollowGate] Already unlocked, skipping modal");
+      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.",
+          "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()) {
@@ -1111,7 +1120,7 @@ var FollowGateClient = class {
     return this.currentUser !== null;
   }
   /**
-   * Clear stored session
+   * Clear stored session (user, actions, and unlock status)
    */
   reset() {
     this.currentUser = null;
@@ -1125,6 +1134,18 @@ var FollowGateClient = class {
       console.log("[FollowGate] Session reset");
     }
   }
+  /**
+   * Clear only the unlock status (keeps user and actions)
+   * Useful for allowing users to go through the flow again
+   */
+  clearUnlockStatus() {
+    if (typeof localStorage !== "undefined") {
+      localStorage.removeItem(this.getStorageKey("followgate_unlocked"));
+    }
+    if (this.config?.debug) {
+      console.log("[FollowGate] Unlock status cleared");
+    }
+  }
   // ============================================
   // Intent URL Methods
   // ============================================

package/dist/index.mjs

@@ -572,18 +572,27 @@ 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("[FollowGate] Already unlocked, skipping modal");
+      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.",
+          "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()) {
@@ -1085,7 +1094,7 @@ var FollowGateClient = class {
     return this.currentUser !== null;
   }
   /**
-   * Clear stored session
+   * Clear stored session (user, actions, and unlock status)
    */
   reset() {
     this.currentUser = null;
@@ -1099,6 +1108,18 @@ var FollowGateClient = class {
       console.log("[FollowGate] Session reset");
     }
   }
+  /**
+   * Clear only the unlock status (keeps user and actions)
+   * Useful for allowing users to go through the flow again
+   */
+  clearUnlockStatus() {
+    if (typeof localStorage !== "undefined") {
+      localStorage.removeItem(this.getStorageKey("followgate_unlocked"));
+    }
+    if (this.config?.debug) {
+      console.log("[FollowGate] Unlock status cleared");
+    }
+  }
   // ============================================
   // Intent URL Methods
   // ============================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@followgate/js",
-  "version": "0.12.1",
+  "version": "0.13.0",
   "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",