@followgate/js 0.7.0 → 0.8.0

package/README.md

@@ -225,6 +225,47 @@ FollowGate.getUnlockStatus();
 // }
 ```
 
+### Server-Side Verification
+
+When `userId` is set, completions are automatically saved to the server. You can verify users from your backend:
+
+```typescript
+// Check if user is verified (server-side)
+const isVerified = await FollowGate.isVerified();
+// Returns: true | false
+
+// Get full verification status
+const status = await FollowGate.getVerificationStatus();
+// Returns: {
+//   verified: boolean,
+//   userId: string,
+//   completedAt?: string,  // ISO date string
+//   actions?: [{ action: 'follow', target: 'lukasvanuden' }, ...]
+// }
+```
+
+**Use Case: Conditional Features**
+
+```typescript
+// In your app (e.g., Chrome extension, Electron app)
+FollowGate.init({
+  appId: 'your-app-id',
+  apiKey: 'fg_live_xxx',
+  userId: clerkUserId,
+  twitter: { handle: 'lukasvanuden' },
+});
+
+const isVerified = await FollowGate.isVerified();
+
+if (isVerified) {
+  // User completed FollowGate → Full access
+  enableAllFeatures();
+} else {
+  // User hasn't completed → Limited access
+  enableTrialMode();
+}
+```
+
 ### Event Listeners
 
 ```typescript
@@ -339,6 +380,7 @@ import type {
   CompleteOptions,
   UserInfo,
   UnlockStatus,
+  VerificationStatus,
 } from '@followgate/js';
 ```
 

package/dist/index.d.mts

@@ -66,6 +66,18 @@ interface UnlockStatus {
     username?: string;
     completedActions?: CompleteOptions[];
 }
+/**
+ * Server-side verification status
+ */
+interface VerificationStatus {
+    verified: boolean;
+    userId: string;
+    completedAt?: string;
+    actions?: Array<{
+        action: string;
+        target: string;
+    }>;
+}
 /**
  * FollowGate SDK Client
  */
@@ -130,6 +142,18 @@ declare class FollowGateClient {
     isUnlocked(): boolean;
     getUnlockStatus(): UnlockStatus;
     getCompletedActions(): CompleteOptions[];
+    /**
+     * Check if user is verified server-side
+     * Requires userId to be set in config
+     * @returns Promise<boolean> - true if verified, false otherwise
+     */
+    isVerified(): Promise<boolean>;
+    /**
+     * Get full verification status from server
+     * Requires userId to be set in config
+     * @returns Promise<VerificationStatus> - full verification details
+     */
+    getVerificationStatus(): Promise<VerificationStatus>;
     on(event: EventType, callback: EventCallback): void;
     off(event: EventType, callback: EventCallback): void;
     /**
@@ -139,6 +163,11 @@ declare class FollowGateClient {
     private getStorageKey;
     private restoreSession;
     private saveCompletedActions;
+    /**
+     * Save completion to server for verification
+     * Only works if userId is set in config
+     */
+    private saveCompletion;
     private buildIntentUrl;
     private buildTwitterUrl;
     private buildBlueskyUrl;
@@ -148,4 +177,4 @@ declare class FollowGateClient {
 }
 declare const FollowGate: FollowGateClient;
 
-export { type CompleteOptions, type EventCallback, type EventType, FollowGate, FollowGateClient, type FollowGateConfig, FollowGateError, type Platform, type SocialAction, type TwitterConfig, type UnlockStatus, type UserInfo };
+export { type CompleteOptions, type EventCallback, type EventType, FollowGate, FollowGateClient, type FollowGateConfig, FollowGateError, type Platform, type SocialAction, type TwitterConfig, type UnlockStatus, type UserInfo, type VerificationStatus };

package/dist/index.d.ts

@@ -66,6 +66,18 @@ interface UnlockStatus {
     username?: string;
     completedActions?: CompleteOptions[];
 }
+/**
+ * Server-side verification status
+ */
+interface VerificationStatus {
+    verified: boolean;
+    userId: string;
+    completedAt?: string;
+    actions?: Array<{
+        action: string;
+        target: string;
+    }>;
+}
 /**
  * FollowGate SDK Client
  */
@@ -130,6 +142,18 @@ declare class FollowGateClient {
     isUnlocked(): boolean;
     getUnlockStatus(): UnlockStatus;
     getCompletedActions(): CompleteOptions[];
+    /**
+     * Check if user is verified server-side
+     * Requires userId to be set in config
+     * @returns Promise<boolean> - true if verified, false otherwise
+     */
+    isVerified(): Promise<boolean>;
+    /**
+     * Get full verification status from server
+     * Requires userId to be set in config
+     * @returns Promise<VerificationStatus> - full verification details
+     */
+    getVerificationStatus(): Promise<VerificationStatus>;
     on(event: EventType, callback: EventCallback): void;
     off(event: EventType, callback: EventCallback): void;
     /**
@@ -139,6 +163,11 @@ declare class FollowGateClient {
     private getStorageKey;
     private restoreSession;
     private saveCompletedActions;
+    /**
+     * Save completion to server for verification
+     * Only works if userId is set in config
+     */
+    private saveCompletion;
     private buildIntentUrl;
     private buildTwitterUrl;
     private buildBlueskyUrl;
@@ -148,4 +177,4 @@ declare class FollowGateClient {
 }
 declare const FollowGate: FollowGateClient;
 
-export { type CompleteOptions, type EventCallback, type EventType, FollowGate, FollowGateClient, type FollowGateConfig, FollowGateError, type Platform, type SocialAction, type TwitterConfig, type UnlockStatus, type UserInfo };
+export { type CompleteOptions, type EventCallback, type EventType, FollowGate, FollowGateClient, type FollowGateConfig, FollowGateError, type Platform, type SocialAction, type TwitterConfig, type UnlockStatus, type UserInfo, type VerificationStatus };

package/dist/index.js

@@ -865,7 +865,10 @@ var FollowGateClient = class {
       platform
     };
     if (typeof localStorage !== "undefined") {
-      localStorage.setItem(this.getStorageKey("followgate_user"), JSON.stringify(this.currentUser));
+      localStorage.setItem(
+        this.getStorageKey("followgate_user"),
+        JSON.stringify(this.currentUser)
+      );
     }
     if (this.config.debug) {
       console.log("[FollowGate] Username set:", normalizedUsername);
@@ -959,6 +962,7 @@ var FollowGateClient = class {
     if (typeof localStorage !== "undefined") {
       localStorage.setItem(this.getStorageKey("followgate_unlocked"), "true");
     }
+    await this.saveCompletion();
     await this.trackEvent("gate_unlocked", {
       username: this.currentUser?.username,
       actions: this.completedActions
@@ -986,6 +990,90 @@ var FollowGateClient = class {
     return [...this.completedActions];
   }
   // ============================================
+  // Server-Side Verification
+  // ============================================
+  /**
+   * Check if user is verified server-side
+   * Requires userId to be set in config
+   * @returns Promise<boolean> - true if verified, false otherwise
+   */
+  async isVerified() {
+    if (!this.config) {
+      throw new Error("[FollowGate] SDK not initialized. Call init() first.");
+    }
+    if (!this.config.userId) {
+      if (this.config.debug) {
+        console.warn("[FollowGate] isVerified() requires userId to be set");
+      }
+      return false;
+    }
+    try {
+      const response = await fetch(
+        `${this.config.apiUrl}/api/v1/completions/verify/${encodeURIComponent(this.config.userId)}`,
+        {
+          headers: {
+            Authorization: `Bearer ${this.config.apiKey}`
+          }
+        }
+      );
+      if (!response.ok) {
+        if (this.config.debug) {
+          console.warn("[FollowGate] Verification check failed:", response.status);
+        }
+        return false;
+      }
+      const data = await response.json();
+      return data.data?.verified === true;
+    } catch (error) {
+      if (this.config.debug) {
+        console.warn("[FollowGate] Verification check error:", error);
+      }
+      return false;
+    }
+  }
+  /**
+   * Get full verification status from server
+   * Requires userId to be set in config
+   * @returns Promise<VerificationStatus> - full verification details
+   */
+  async getVerificationStatus() {
+    if (!this.config) {
+      throw new Error("[FollowGate] SDK not initialized. Call init() first.");
+    }
+    if (!this.config.userId) {
+      return {
+        verified: false,
+        userId: ""
+      };
+    }
+    try {
+      const response = await fetch(
+        `${this.config.apiUrl}/api/v1/completions/verify/${encodeURIComponent(this.config.userId)}`,
+        {
+          headers: {
+            Authorization: `Bearer ${this.config.apiKey}`
+          }
+        }
+      );
+      if (!response.ok) {
+        return {
+          verified: false,
+          userId: this.config.userId
+        };
+      }
+      const data = await response.json();
+      return data.data;
+    } catch (error) {
+      if (this.config.debug) {
+        console.warn("[FollowGate] getVerificationStatus error:", error);
+      }
+      return {
+        verified: false,
+        userId: this.config.userId
+      };
+    }
+  }
+  // ============================================
   // Event System
   // ============================================
   on(event, callback) {
@@ -1012,7 +1100,9 @@ var FollowGateClient = class {
   }
   restoreSession() {
     if (typeof localStorage === "undefined") return;
-    const userJson = localStorage.getItem(this.getStorageKey("followgate_user"));
+    const userJson = localStorage.getItem(
+      this.getStorageKey("followgate_user")
+    );
     if (userJson) {
       try {
         this.currentUser = JSON.parse(userJson);
@@ -1020,7 +1110,9 @@ var FollowGateClient = class {
         localStorage.removeItem(this.getStorageKey("followgate_user"));
       }
     }
-    const actionsJson = localStorage.getItem(this.getStorageKey("followgate_actions"));
+    const actionsJson = localStorage.getItem(
+      this.getStorageKey("followgate_actions")
+    );
     if (actionsJson) {
       try {
         this.completedActions = JSON.parse(actionsJson);
@@ -1037,6 +1129,43 @@ var FollowGateClient = class {
       );
     }
   }
+  /**
+   * Save completion to server for verification
+   * Only works if userId is set in config
+   */
+  async saveCompletion() {
+    if (!this.config?.userId) {
+      return;
+    }
+    try {
+      const response = await fetch(`${this.config.apiUrl}/api/v1/completions`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${this.config.apiKey}`
+        },
+        body: JSON.stringify({
+          userId: this.config.userId,
+          platform: this.currentUser?.platform || "twitter",
+          actions: this.completedActions.map((a) => ({
+            action: a.action,
+            target: a.target
+          }))
+        })
+      });
+      if (this.config.debug) {
+        if (response.ok) {
+          console.log("[FollowGate] Completion saved to server");
+        } else {
+          console.warn("[FollowGate] Failed to save completion:", response.status);
+        }
+      }
+    } catch (error) {
+      if (this.config.debug) {
+        console.warn("[FollowGate] Failed to save completion:", error);
+      }
+    }
+  }
   buildIntentUrl(options) {
     const { platform, action, target } = options;
     switch (platform) {

package/dist/index.mjs

@@ -839,7 +839,10 @@ var FollowGateClient = class {
       platform
     };
     if (typeof localStorage !== "undefined") {
-      localStorage.setItem(this.getStorageKey("followgate_user"), JSON.stringify(this.currentUser));
+      localStorage.setItem(
+        this.getStorageKey("followgate_user"),
+        JSON.stringify(this.currentUser)
+      );
     }
     if (this.config.debug) {
       console.log("[FollowGate] Username set:", normalizedUsername);
@@ -933,6 +936,7 @@ var FollowGateClient = class {
     if (typeof localStorage !== "undefined") {
       localStorage.setItem(this.getStorageKey("followgate_unlocked"), "true");
     }
+    await this.saveCompletion();
     await this.trackEvent("gate_unlocked", {
       username: this.currentUser?.username,
       actions: this.completedActions
@@ -960,6 +964,90 @@ var FollowGateClient = class {
     return [...this.completedActions];
   }
   // ============================================
+  // Server-Side Verification
+  // ============================================
+  /**
+   * Check if user is verified server-side
+   * Requires userId to be set in config
+   * @returns Promise<boolean> - true if verified, false otherwise
+   */
+  async isVerified() {
+    if (!this.config) {
+      throw new Error("[FollowGate] SDK not initialized. Call init() first.");
+    }
+    if (!this.config.userId) {
+      if (this.config.debug) {
+        console.warn("[FollowGate] isVerified() requires userId to be set");
+      }
+      return false;
+    }
+    try {
+      const response = await fetch(
+        `${this.config.apiUrl}/api/v1/completions/verify/${encodeURIComponent(this.config.userId)}`,
+        {
+          headers: {
+            Authorization: `Bearer ${this.config.apiKey}`
+          }
+        }
+      );
+      if (!response.ok) {
+        if (this.config.debug) {
+          console.warn("[FollowGate] Verification check failed:", response.status);
+        }
+        return false;
+      }
+      const data = await response.json();
+      return data.data?.verified === true;
+    } catch (error) {
+      if (this.config.debug) {
+        console.warn("[FollowGate] Verification check error:", error);
+      }
+      return false;
+    }
+  }
+  /**
+   * Get full verification status from server
+   * Requires userId to be set in config
+   * @returns Promise<VerificationStatus> - full verification details
+   */
+  async getVerificationStatus() {
+    if (!this.config) {
+      throw new Error("[FollowGate] SDK not initialized. Call init() first.");
+    }
+    if (!this.config.userId) {
+      return {
+        verified: false,
+        userId: ""
+      };
+    }
+    try {
+      const response = await fetch(
+        `${this.config.apiUrl}/api/v1/completions/verify/${encodeURIComponent(this.config.userId)}`,
+        {
+          headers: {
+            Authorization: `Bearer ${this.config.apiKey}`
+          }
+        }
+      );
+      if (!response.ok) {
+        return {
+          verified: false,
+          userId: this.config.userId
+        };
+      }
+      const data = await response.json();
+      return data.data;
+    } catch (error) {
+      if (this.config.debug) {
+        console.warn("[FollowGate] getVerificationStatus error:", error);
+      }
+      return {
+        verified: false,
+        userId: this.config.userId
+      };
+    }
+  }
+  // ============================================
   // Event System
   // ============================================
   on(event, callback) {
@@ -986,7 +1074,9 @@ var FollowGateClient = class {
   }
   restoreSession() {
     if (typeof localStorage === "undefined") return;
-    const userJson = localStorage.getItem(this.getStorageKey("followgate_user"));
+    const userJson = localStorage.getItem(
+      this.getStorageKey("followgate_user")
+    );
     if (userJson) {
       try {
         this.currentUser = JSON.parse(userJson);
@@ -994,7 +1084,9 @@ var FollowGateClient = class {
         localStorage.removeItem(this.getStorageKey("followgate_user"));
       }
     }
-    const actionsJson = localStorage.getItem(this.getStorageKey("followgate_actions"));
+    const actionsJson = localStorage.getItem(
+      this.getStorageKey("followgate_actions")
+    );
     if (actionsJson) {
       try {
         this.completedActions = JSON.parse(actionsJson);
@@ -1011,6 +1103,43 @@ var FollowGateClient = class {
       );
     }
   }
+  /**
+   * Save completion to server for verification
+   * Only works if userId is set in config
+   */
+  async saveCompletion() {
+    if (!this.config?.userId) {
+      return;
+    }
+    try {
+      const response = await fetch(`${this.config.apiUrl}/api/v1/completions`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${this.config.apiKey}`
+        },
+        body: JSON.stringify({
+          userId: this.config.userId,
+          platform: this.currentUser?.platform || "twitter",
+          actions: this.completedActions.map((a) => ({
+            action: a.action,
+            target: a.target
+          }))
+        })
+      });
+      if (this.config.debug) {
+        if (response.ok) {
+          console.log("[FollowGate] Completion saved to server");
+        } else {
+          console.warn("[FollowGate] Failed to save completion:", response.status);
+        }
+      }
+    } catch (error) {
+      if (this.config.debug) {
+        console.warn("[FollowGate] Failed to save completion:", error);
+      }
+    }
+  }
   buildIntentUrl(options) {
     const { platform, action, target } = options;
     switch (platform) {

package/package.json

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