@followgate/js 0.13.0 → 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;
 }
@@ -28,7 +29,6 @@ interface FollowGateConfig {
     onComplete?: () => void;
     theme?: 'dark' | 'light';
     accentColor?: string;
-    forceShow?: boolean;
 }
 /**
  * SDK Error class with helpful messages
@@ -103,7 +103,7 @@ declare class FollowGateClient {
     private fetchServerConfig;
     /**
      * Show the FollowGate modal
-     * If user is already unlocked, calls onComplete immediately (unless forceShow is true)
+     * If user is already unlocked, calls onComplete immediately
      */
     show(): Promise<void>;
     /**
@@ -121,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;

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

package/dist/index.js

@@ -598,27 +598,22 @@ var FollowGateClient = class {
   }
   /**
    * Show the FollowGate modal
-   * If user is already unlocked, calls onComplete immediately (unless forceShow is true)
+   * If user is already unlocked, calls onComplete immediately
    */
   async show() {
     if (!this.config) {
       throw new Error("[FollowGate] SDK not initialized. Call init() first.");
     }
     if (this.isUnlocked()) {
-      if (this.config.forceShow) {
-        this.clearUnlockStatus();
-        if (this.config.debug) {
-          console.log("[FollowGate] forceShow enabled - cleared unlock status, showing modal");
-        }
-      } else {
-        console.warn(
+      if (this.config.debug) {
+        console.log(
           "[FollowGate] Modal skipped - user already unlocked.",
-          "Use forceShow: true in init() to always show modal, or call FollowGate.reset() to clear.",
+          "Call FollowGate.reset() to clear unlock status.",
           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()) {
@@ -718,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";
@@ -784,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;
@@ -819,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();
@@ -891,7 +942,7 @@ var FollowGateClient = class {
       action: "follow",
       target: handle
     });
-    if (this.config?.twitter?.tweetId) {
+    if (this.shouldShowRepostStep()) {
       this.renderRepostStep();
     } else {
       this.renderConfirmStep();
@@ -899,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">
@@ -930,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();
   }
@@ -985,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();
   }
@@ -997,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;">
@@ -1023,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
@@ -1052,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
         });
       }
     });

package/dist/index.mjs

@@ -572,27 +572,22 @@ var FollowGateClient = class {
   }
   /**
    * Show the FollowGate modal
-   * If user is already unlocked, calls onComplete immediately (unless forceShow is true)
+   * If user is already unlocked, calls onComplete immediately
    */
   async show() {
     if (!this.config) {
       throw new Error("[FollowGate] SDK not initialized. Call init() first.");
     }
     if (this.isUnlocked()) {
-      if (this.config.forceShow) {
-        this.clearUnlockStatus();
-        if (this.config.debug) {
-          console.log("[FollowGate] forceShow enabled - cleared unlock status, showing modal");
-        }
-      } else {
-        console.warn(
+      if (this.config.debug) {
+        console.log(
           "[FollowGate] Modal skipped - user already unlocked.",
-          "Use forceShow: true in init() to always show modal, or call FollowGate.reset() to clear.",
+          "Call FollowGate.reset() to clear unlock status.",
           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()) {
@@ -692,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";
@@ -758,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;
@@ -793,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();
@@ -865,7 +916,7 @@ var FollowGateClient = class {
       action: "follow",
       target: handle
     });
-    if (this.config?.twitter?.tweetId) {
+    if (this.shouldShowRepostStep()) {
       this.renderRepostStep();
     } else {
       this.renderConfirmStep();
@@ -873,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">
@@ -904,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();
   }
@@ -959,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();
   }
@@ -971,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;">
@@ -997,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
@@ -1026,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
         });
       }
     });

package/package.json

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