@followgate/js 0.12.1 → 0.14.0

package/dist/index.d.mts

@@ -12,6 +12,7 @@ type SocialAction = 'follow' | 'repost' | 'like';
 interface TwitterConfig {
     handle?: string;
     overrideHandle?: string;
+    overridePostUrl?: string;
     tweetId?: string;
     username?: string;
 }
@@ -120,6 +121,24 @@ declare class FollowGateClient {
      * 3. config.twitter.handle (legacy fallback, deprecated)
      */
     private getTargetHandle;
+    /**
+     * Get target post URL/ID with priority:
+     * 1. config.twitter.overridePostUrl (explicit override)
+     * 2. serverConfig.targetPostUrl (from Dashboard)
+     * 3. config.twitter.tweetId (legacy fallback, deprecated)
+     */
+    private getTargetPostUrl;
+    /**
+     * Extract post ID from URL or return as-is if already an ID
+     * Supports: Tweet ID, Twitter/X URLs
+     */
+    private extractPostId;
+    /**
+     * Check if repost step should be shown based on:
+     * 1. serverConfig.actions includes 'repost'
+     * 2. A valid postUrl is available
+     */
+    private shouldShowRepostStep;
     private renderUsernameStep;
     private handleUsernameSubmit;
     private renderFollowStep;
@@ -147,9 +166,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

@@ -12,6 +12,7 @@ type SocialAction = 'follow' | 'repost' | 'like';
 interface TwitterConfig {
     handle?: string;
     overrideHandle?: string;
+    overridePostUrl?: string;
     tweetId?: string;
     username?: string;
 }
@@ -120,6 +121,24 @@ declare class FollowGateClient {
      * 3. config.twitter.handle (legacy fallback, deprecated)
      */
     private getTargetHandle;
+    /**
+     * Get target post URL/ID with priority:
+     * 1. config.twitter.overridePostUrl (explicit override)
+     * 2. serverConfig.targetPostUrl (from Dashboard)
+     * 3. config.twitter.tweetId (legacy fallback, deprecated)
+     */
+    private getTargetPostUrl;
+    /**
+     * Extract post ID from URL or return as-is if already an ID
+     * Supports: Tweet ID, Twitter/X URLs
+     */
+    private extractPostId;
+    /**
+     * Check if repost step should be shown based on:
+     * 1. serverConfig.actions includes 'repost'
+     * 2. A valid postUrl is available
+     */
+    private shouldShowRepostStep;
     private renderUsernameStep;
     private handleUsernameSubmit;
     private renderFollowStep;
@@ -147,9 +166,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

@@ -606,7 +606,11 @@ var FollowGateClient = class {
     }
     if (this.isUnlocked()) {
       if (this.config.debug) {
-        console.log("[FollowGate] Already unlocked, skipping modal");
+        console.log(
+          "[FollowGate] Modal skipped - user already unlocked.",
+          "Call FollowGate.reset() to clear unlock status.",
+          this.config.userId ? `(userId: ${this.config.userId})` : "(no userId set)"
+        );
       }
       this.config.onComplete?.();
       return;
@@ -709,11 +713,68 @@ var FollowGateClient = class {
     }
     return null;
   }
+  /**
+   * Get target post URL/ID with priority:
+   * 1. config.twitter.overridePostUrl (explicit override)
+   * 2. serverConfig.targetPostUrl (from Dashboard)
+   * 3. config.twitter.tweetId (legacy fallback, deprecated)
+   */
+  getTargetPostUrl() {
+    if (this.config?.twitter?.overridePostUrl) {
+      return this.extractPostId(this.config.twitter.overridePostUrl);
+    }
+    if (this.serverConfig?.targetPostUrl) {
+      return this.extractPostId(this.serverConfig.targetPostUrl);
+    }
+    if (this.config?.twitter?.tweetId) {
+      return this.config.twitter.tweetId;
+    }
+    return null;
+  }
+  /**
+   * Extract post ID from URL or return as-is if already an ID
+   * Supports: Tweet ID, Twitter/X URLs
+   */
+  extractPostId(input) {
+    if (!input) return null;
+    const trimmed = input.trim();
+    if (/^\d+$/.test(trimmed)) {
+      return trimmed;
+    }
+    const twitterMatch = trimmed.match(
+      /(?:twitter|x)\.com\/\w+\/status\/(\d+)/
+    );
+    if (twitterMatch) {
+      return twitterMatch[1];
+    }
+    return trimmed;
+  }
+  /**
+   * Check if repost step should be shown based on:
+   * 1. serverConfig.actions includes 'repost'
+   * 2. A valid postUrl is available
+   */
+  shouldShowRepostStep() {
+    const postUrl = this.getTargetPostUrl();
+    const actionsIncludeRepost = this.serverConfig?.actions?.includes("repost");
+    if (actionsIncludeRepost && !postUrl) {
+      console.warn(
+        "[FollowGate] REPOST action configured but no targetPostUrl available.",
+        "Set targetPostUrl in Dashboard or use overridePostUrl in config.",
+        "Skipping repost step."
+      );
+      return false;
+    }
+    if (this.config?.twitter?.tweetId) {
+      return true;
+    }
+    return !!actionsIncludeRepost && !!postUrl;
+  }
   renderUsernameStep() {
     const content = this.getContentElement();
     if (!content) return;
     const handle = this.getTargetHandle();
-    const hasRepost = !!this.config?.twitter?.tweetId;
+    const hasRepost = this.shouldShowRepostStep();
     const allowSkip = this.serverConfig?.allowSkip ?? false;
     const welcomeTitle = this.serverConfig?.welcomeTitle || "Unlock Free Access";
     const welcomeMessage = this.serverConfig?.welcomeMessage || "Enter your X username to get started";
@@ -775,7 +836,7 @@ var FollowGateClient = class {
       );
       return;
     }
-    const hasRepost = !!this.config?.twitter?.tweetId;
+    const hasRepost = this.shouldShowRepostStep();
     const defaultTitle = hasRepost ? "Step 1: Follow" : "Follow to Continue";
     const defaultMessage = `Follow @${handle} on X`;
     const title = this.serverConfig?.welcomeTitle || defaultTitle;
@@ -810,8 +871,7 @@ var FollowGateClient = class {
     });
   }
   handleSkipFollow() {
-    if (!this.config?.twitter) return;
-    if (this.config.twitter.tweetId) {
+    if (this.shouldShowRepostStep()) {
       this.renderRepostStep();
     } else {
       this.renderConfirmStep();
@@ -882,7 +942,7 @@ var FollowGateClient = class {
       action: "follow",
       target: handle
     });
-    if (this.config?.twitter?.tweetId) {
+    if (this.shouldShowRepostStep()) {
       this.renderRepostStep();
     } else {
       this.renderConfirmStep();
@@ -890,7 +950,8 @@ var FollowGateClient = class {
   }
   renderRepostStep() {
     const content = this.getContentElement();
-    if (!content || !this.config?.twitter?.tweetId) return;
+    const postId = this.getTargetPostUrl();
+    if (!content || !postId) return;
     content.innerHTML = `
       ${this.renderStepIndicator(2)}
       <div class="fg-icon-box fg-success">
@@ -921,12 +982,12 @@ var FollowGateClient = class {
     });
   }
   handleRepostClick() {
-    if (!this.config?.twitter?.tweetId) return;
-    const tweetId = this.config.twitter.tweetId;
+    const postId = this.getTargetPostUrl();
+    if (!postId) return;
     this.openIntent({
       platform: "twitter",
       action: "repost",
-      target: tweetId
+      target: postId
     });
     this.showRepostConfirmation();
   }
@@ -976,11 +1037,12 @@ var FollowGateClient = class {
     }
   }
   async handleRepostConfirm() {
-    if (!this.config?.twitter?.tweetId) return;
+    const postId = this.getTargetPostUrl();
+    if (!postId) return;
     await this.complete({
       platform: "twitter",
       action: "repost",
-      target: this.config.twitter.tweetId
+      target: postId
     });
     this.renderConfirmStep();
   }
@@ -988,15 +1050,27 @@ var FollowGateClient = class {
     const content = this.getContentElement();
     if (!content) return;
     const username = this.currentUser?.username;
+    const targetHandle = this.getTargetHandle();
+    const postId = this.getTargetPostUrl();
     const successTitle = this.serverConfig?.successTitle || "Almost done!";
     const successMessage = this.serverConfig?.successMessage || null;
+    const hasFollow = targetHandle !== null;
+    const hasRepost = postId !== null;
+    let verifyText = "Verifying";
+    if (hasFollow && hasRepost) {
+      verifyText = "Verifying follow & repost";
+    } else if (hasFollow) {
+      verifyText = "Verifying follow";
+    } else if (hasRepost) {
+      verifyText = "Verifying repost";
+    }
     content.innerHTML = `
       <h2 class="fg-title">${this.escapeHtml(successTitle)}</h2>
       ${successMessage ? `<p class="fg-subtitle" style="margin-bottom: 16px;">${this.escapeHtml(successMessage)}</p>` : ""}
       <div class="fg-verify-box">
         <div class="fg-verify-box-left">
           <div class="fg-verify-spinner"></div>
-          <span class="fg-verify-text">Verifying follow & repost</span>
+          <span class="fg-verify-text">${verifyText}</span>
         </div>
         ${username ? `
           <div class="fg-user-badge" style="margin: 0; padding: 4px 10px; gap: 6px;">
@@ -1014,13 +1088,15 @@ var FollowGateClient = class {
         ${ICONS.check}
         Got it
       </button>
-      ${this.config?.twitter ? `
+      ${hasFollow || hasRepost ? `
         <div class="fg-btn-row">
-          <button class="fg-btn fg-btn-secondary" id="fg-redo-follow">
-            ${ICONS.x}
-            Open follow
-          </button>
-          ${this.config.twitter.tweetId ? `
+          ${hasFollow ? `
+            <button class="fg-btn fg-btn-secondary" id="fg-redo-follow">
+              ${ICONS.x}
+              Open follow
+            </button>
+          ` : ""}
+          ${hasRepost ? `
             <button class="fg-btn fg-btn-secondary" id="fg-redo-repost">
               ${ICONS.repost}
               Open repost
@@ -1043,11 +1119,12 @@ var FollowGateClient = class {
       }
     });
     document.getElementById("fg-redo-repost")?.addEventListener("click", () => {
-      if (this.config?.twitter?.tweetId) {
+      const repostId = this.getTargetPostUrl();
+      if (repostId) {
         this.openIntent({
           platform: "twitter",
           action: "repost",
-          target: this.config.twitter.tweetId
+          target: repostId
         });
       }
     });
@@ -1111,7 +1188,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 +1202,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

@@ -580,7 +580,11 @@ var FollowGateClient = class {
     }
     if (this.isUnlocked()) {
       if (this.config.debug) {
-        console.log("[FollowGate] Already unlocked, skipping modal");
+        console.log(
+          "[FollowGate] Modal skipped - user already unlocked.",
+          "Call FollowGate.reset() to clear unlock status.",
+          this.config.userId ? `(userId: ${this.config.userId})` : "(no userId set)"
+        );
       }
       this.config.onComplete?.();
       return;
@@ -683,11 +687,68 @@ var FollowGateClient = class {
     }
     return null;
   }
+  /**
+   * Get target post URL/ID with priority:
+   * 1. config.twitter.overridePostUrl (explicit override)
+   * 2. serverConfig.targetPostUrl (from Dashboard)
+   * 3. config.twitter.tweetId (legacy fallback, deprecated)
+   */
+  getTargetPostUrl() {
+    if (this.config?.twitter?.overridePostUrl) {
+      return this.extractPostId(this.config.twitter.overridePostUrl);
+    }
+    if (this.serverConfig?.targetPostUrl) {
+      return this.extractPostId(this.serverConfig.targetPostUrl);
+    }
+    if (this.config?.twitter?.tweetId) {
+      return this.config.twitter.tweetId;
+    }
+    return null;
+  }
+  /**
+   * Extract post ID from URL or return as-is if already an ID
+   * Supports: Tweet ID, Twitter/X URLs
+   */
+  extractPostId(input) {
+    if (!input) return null;
+    const trimmed = input.trim();
+    if (/^\d+$/.test(trimmed)) {
+      return trimmed;
+    }
+    const twitterMatch = trimmed.match(
+      /(?:twitter|x)\.com\/\w+\/status\/(\d+)/
+    );
+    if (twitterMatch) {
+      return twitterMatch[1];
+    }
+    return trimmed;
+  }
+  /**
+   * Check if repost step should be shown based on:
+   * 1. serverConfig.actions includes 'repost'
+   * 2. A valid postUrl is available
+   */
+  shouldShowRepostStep() {
+    const postUrl = this.getTargetPostUrl();
+    const actionsIncludeRepost = this.serverConfig?.actions?.includes("repost");
+    if (actionsIncludeRepost && !postUrl) {
+      console.warn(
+        "[FollowGate] REPOST action configured but no targetPostUrl available.",
+        "Set targetPostUrl in Dashboard or use overridePostUrl in config.",
+        "Skipping repost step."
+      );
+      return false;
+    }
+    if (this.config?.twitter?.tweetId) {
+      return true;
+    }
+    return !!actionsIncludeRepost && !!postUrl;
+  }
   renderUsernameStep() {
     const content = this.getContentElement();
     if (!content) return;
     const handle = this.getTargetHandle();
-    const hasRepost = !!this.config?.twitter?.tweetId;
+    const hasRepost = this.shouldShowRepostStep();
     const allowSkip = this.serverConfig?.allowSkip ?? false;
     const welcomeTitle = this.serverConfig?.welcomeTitle || "Unlock Free Access";
     const welcomeMessage = this.serverConfig?.welcomeMessage || "Enter your X username to get started";
@@ -749,7 +810,7 @@ var FollowGateClient = class {
       );
       return;
     }
-    const hasRepost = !!this.config?.twitter?.tweetId;
+    const hasRepost = this.shouldShowRepostStep();
     const defaultTitle = hasRepost ? "Step 1: Follow" : "Follow to Continue";
     const defaultMessage = `Follow @${handle} on X`;
     const title = this.serverConfig?.welcomeTitle || defaultTitle;
@@ -784,8 +845,7 @@ var FollowGateClient = class {
     });
   }
   handleSkipFollow() {
-    if (!this.config?.twitter) return;
-    if (this.config.twitter.tweetId) {
+    if (this.shouldShowRepostStep()) {
       this.renderRepostStep();
     } else {
       this.renderConfirmStep();
@@ -856,7 +916,7 @@ var FollowGateClient = class {
       action: "follow",
       target: handle
     });
-    if (this.config?.twitter?.tweetId) {
+    if (this.shouldShowRepostStep()) {
       this.renderRepostStep();
     } else {
       this.renderConfirmStep();
@@ -864,7 +924,8 @@ var FollowGateClient = class {
   }
   renderRepostStep() {
     const content = this.getContentElement();
-    if (!content || !this.config?.twitter?.tweetId) return;
+    const postId = this.getTargetPostUrl();
+    if (!content || !postId) return;
     content.innerHTML = `
       ${this.renderStepIndicator(2)}
       <div class="fg-icon-box fg-success">
@@ -895,12 +956,12 @@ var FollowGateClient = class {
     });
   }
   handleRepostClick() {
-    if (!this.config?.twitter?.tweetId) return;
-    const tweetId = this.config.twitter.tweetId;
+    const postId = this.getTargetPostUrl();
+    if (!postId) return;
     this.openIntent({
       platform: "twitter",
       action: "repost",
-      target: tweetId
+      target: postId
     });
     this.showRepostConfirmation();
   }
@@ -950,11 +1011,12 @@ var FollowGateClient = class {
     }
   }
   async handleRepostConfirm() {
-    if (!this.config?.twitter?.tweetId) return;
+    const postId = this.getTargetPostUrl();
+    if (!postId) return;
     await this.complete({
       platform: "twitter",
       action: "repost",
-      target: this.config.twitter.tweetId
+      target: postId
     });
     this.renderConfirmStep();
   }
@@ -962,15 +1024,27 @@ var FollowGateClient = class {
     const content = this.getContentElement();
     if (!content) return;
     const username = this.currentUser?.username;
+    const targetHandle = this.getTargetHandle();
+    const postId = this.getTargetPostUrl();
     const successTitle = this.serverConfig?.successTitle || "Almost done!";
     const successMessage = this.serverConfig?.successMessage || null;
+    const hasFollow = targetHandle !== null;
+    const hasRepost = postId !== null;
+    let verifyText = "Verifying";
+    if (hasFollow && hasRepost) {
+      verifyText = "Verifying follow & repost";
+    } else if (hasFollow) {
+      verifyText = "Verifying follow";
+    } else if (hasRepost) {
+      verifyText = "Verifying repost";
+    }
     content.innerHTML = `
       <h2 class="fg-title">${this.escapeHtml(successTitle)}</h2>
       ${successMessage ? `<p class="fg-subtitle" style="margin-bottom: 16px;">${this.escapeHtml(successMessage)}</p>` : ""}
       <div class="fg-verify-box">
         <div class="fg-verify-box-left">
           <div class="fg-verify-spinner"></div>
-          <span class="fg-verify-text">Verifying follow & repost</span>
+          <span class="fg-verify-text">${verifyText}</span>
         </div>
         ${username ? `
           <div class="fg-user-badge" style="margin: 0; padding: 4px 10px; gap: 6px;">
@@ -988,13 +1062,15 @@ var FollowGateClient = class {
         ${ICONS.check}
         Got it
       </button>
-      ${this.config?.twitter ? `
+      ${hasFollow || hasRepost ? `
         <div class="fg-btn-row">
-          <button class="fg-btn fg-btn-secondary" id="fg-redo-follow">
-            ${ICONS.x}
-            Open follow
-          </button>
-          ${this.config.twitter.tweetId ? `
+          ${hasFollow ? `
+            <button class="fg-btn fg-btn-secondary" id="fg-redo-follow">
+              ${ICONS.x}
+              Open follow
+            </button>
+          ` : ""}
+          ${hasRepost ? `
             <button class="fg-btn fg-btn-secondary" id="fg-redo-repost">
               ${ICONS.repost}
               Open repost
@@ -1017,11 +1093,12 @@ var FollowGateClient = class {
       }
     });
     document.getElementById("fg-redo-repost")?.addEventListener("click", () => {
-      if (this.config?.twitter?.tweetId) {
+      const repostId = this.getTargetPostUrl();
+      if (repostId) {
         this.openIntent({
           platform: "twitter",
           action: "repost",
-          target: this.config.twitter.tweetId
+          target: repostId
         });
       }
     });
@@ -1085,7 +1162,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 +1176,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.14.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",