@followgate/js 0.12.0 → 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()) {
@@ -770,10 +779,16 @@ var FollowGateClient = class {
     if (!content) return;
     const handle = this.getTargetHandle();
     if (!handle) {
-      console.error("[FollowGate] No target handle configured. Set it in Dashboard or use overrideHandle.");
+      console.error(
+        "[FollowGate] No target handle configured. Set it in Dashboard or use overrideHandle."
+      );
       return;
     }
     const hasRepost = !!this.config?.twitter?.tweetId;
+    const defaultTitle = hasRepost ? "Step 1: Follow" : "Follow to Continue";
+    const defaultMessage = `Follow @${handle} on X`;
+    const title = this.serverConfig?.welcomeTitle || defaultTitle;
+    const message = this.serverConfig?.welcomeMessage || defaultMessage;
     content.innerHTML = `
       ${hasRepost ? this.renderStepIndicator(1) : ""}
       <div class="fg-icon-box">
@@ -785,8 +800,8 @@ var FollowGateClient = class {
           <span class="fg-user-badge-text">@${this.currentUser.username}</span>
         </div>
       ` : ""}
-      <h2 class="fg-title">${hasRepost ? "Step 1: Follow" : "Follow to Continue"}</h2>
-      <p class="fg-subtitle" id="fg-follow-subtitle">Follow @${handle} on X</p>
+      <h2 class="fg-title">${this.escapeHtml(title)}</h2>
+      <p class="fg-subtitle" id="fg-follow-subtitle">${this.escapeHtml(message)}</p>
       <div id="fg-follow-actions">
         <button class="fg-btn fg-btn-dark" id="fg-follow-btn">
           ${ICONS.x}
@@ -1105,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;
@@ -1119,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()) {
@@ -744,10 +753,16 @@ var FollowGateClient = class {
     if (!content) return;
     const handle = this.getTargetHandle();
     if (!handle) {
-      console.error("[FollowGate] No target handle configured. Set it in Dashboard or use overrideHandle.");
+      console.error(
+        "[FollowGate] No target handle configured. Set it in Dashboard or use overrideHandle."
+      );
       return;
     }
     const hasRepost = !!this.config?.twitter?.tweetId;
+    const defaultTitle = hasRepost ? "Step 1: Follow" : "Follow to Continue";
+    const defaultMessage = `Follow @${handle} on X`;
+    const title = this.serverConfig?.welcomeTitle || defaultTitle;
+    const message = this.serverConfig?.welcomeMessage || defaultMessage;
     content.innerHTML = `
       ${hasRepost ? this.renderStepIndicator(1) : ""}
       <div class="fg-icon-box">
@@ -759,8 +774,8 @@ var FollowGateClient = class {
           <span class="fg-user-badge-text">@${this.currentUser.username}</span>
         </div>
       ` : ""}
-      <h2 class="fg-title">${hasRepost ? "Step 1: Follow" : "Follow to Continue"}</h2>
-      <p class="fg-subtitle" id="fg-follow-subtitle">Follow @${handle} on X</p>
+      <h2 class="fg-title">${this.escapeHtml(title)}</h2>
+      <p class="fg-subtitle" id="fg-follow-subtitle">${this.escapeHtml(message)}</p>
       <div id="fg-follow-actions">
         <button class="fg-btn fg-btn-dark" id="fg-follow-btn">
           ${ICONS.x}
@@ -1079,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;
@@ -1093,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.0",
+  "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",