spaps-sdk 0.1.0 → 1.0.2

package/admin-utils.ts

@@ -0,0 +1,243 @@
+/**
+ * Admin utilities for Sweet Potato
+ * These are helper functions for admin operations that require JWT authentication
+ * NOT included in main SDK for security reasons
+ */
+
+export interface WhitelistEntry {
+  application_id: string;
+  email: string;
+  tier: 'basic' | 'premium' | 'enterprise';
+  bypass_payment: boolean;
+  metadata?: Record<string, any>;
+  created_at?: string;
+  updated_at?: string;
+}
+
+export interface WhitelistClient {
+  apiUrl: string;
+  apiKey: string;
+  adminToken: string;
+}
+
+/**
+ * Create a whitelist management client
+ * Requires admin JWT token from authentication
+ */
+export class WhitelistManager {
+  private headers: Record<string, string>;
+  
+  constructor(private config: WhitelistClient) {
+    this.headers = {
+      'Authorization': `Bearer ${config.adminToken}`,
+      'X-API-Key': config.apiKey,
+      'Content-Type': 'application/json'
+    };
+  }
+
+  /**
+   * Check if email is whitelisted
+   */
+  async check(email: string): Promise<WhitelistEntry | null> {
+    const response = await fetch(
+      `${this.config.apiUrl}/api/v1/whitelist/check?email=${encodeURIComponent(email)}`,
+      { headers: { 'X-API-Key': this.config.apiKey } }
+    );
+    
+    const result = await response.json() as any;
+    return result.data?.entry || null;
+  }
+
+  /**
+   * Add email to whitelist
+   */
+  async add(
+    email: string,
+    tier: 'basic' | 'premium' | 'enterprise' = 'premium',
+    options?: {
+      bypass_payment?: boolean;
+      metadata?: Record<string, any>;
+    }
+  ): Promise<WhitelistEntry> {
+    const response = await fetch(`${this.config.apiUrl}/api/v1/whitelist`, {
+      method: 'POST',
+      headers: this.headers,
+      body: JSON.stringify({
+        email,
+        tier,
+        bypass_payment: options?.bypass_payment ?? true,
+        metadata: options?.metadata
+      })
+    });
+
+    if (!response.ok) {
+      const error = await response.json() as any;
+      throw new Error(error.error?.message || 'Failed to add to whitelist');
+    }
+
+    const result = await response.json() as any;
+    return result.data.entry;
+  }
+
+  /**
+   * Bulk add emails to whitelist
+   */
+  async bulkAdd(
+    emails: Array<{
+      email: string;
+      tier?: 'basic' | 'premium' | 'enterprise';
+      metadata?: Record<string, any>;
+    }>
+  ): Promise<{
+    successful: WhitelistEntry[];
+    failed: Array<{ email: string; error: string }>;
+    total: number;
+  }> {
+    const response = await fetch(`${this.config.apiUrl}/api/v1/whitelist/bulk`, {
+      method: 'POST',
+      headers: this.headers,
+      body: JSON.stringify({ emails })
+    });
+
+    const result = await response.json() as any;
+    return result.data;
+  }
+
+  /**
+   * List whitelisted emails
+   */
+  async list(options?: {
+    limit?: number;
+    offset?: number;
+    tier?: string;
+  }): Promise<{
+    entries: WhitelistEntry[];
+    total: number;
+  }> {
+    const params = new URLSearchParams();
+    if (options?.limit) params.append('limit', options.limit.toString());
+    if (options?.offset) params.append('offset', options.offset.toString());
+    if (options?.tier) params.append('tier', options.tier);
+
+    const response = await fetch(
+      `${this.config.apiUrl}/api/v1/whitelist?${params}`,
+      { headers: this.headers }
+    );
+
+    const result = await response.json() as any;
+    return result.data;
+  }
+
+  /**
+   * Update whitelist entry
+   */
+  async update(
+    email: string,
+    updates: {
+      tier?: 'basic' | 'premium' | 'enterprise';
+      bypass_payment?: boolean;
+      metadata?: Record<string, any>;
+    }
+  ): Promise<WhitelistEntry> {
+    const response = await fetch(
+      `${this.config.apiUrl}/api/v1/whitelist/${encodeURIComponent(email)}`,
+      {
+        method: 'PUT',
+        headers: this.headers,
+        body: JSON.stringify(updates)
+      }
+    );
+
+    if (!response.ok) {
+      const error = await response.json() as any;
+      throw new Error(error.error?.message || 'Failed to update whitelist');
+    }
+
+    const result = await response.json() as any;
+    return result.data.entry;
+  }
+
+  /**
+   * Remove email from whitelist
+   */
+  async remove(email: string): Promise<void> {
+    const response = await fetch(
+      `${this.config.apiUrl}/api/v1/whitelist/${encodeURIComponent(email)}`,
+      {
+        method: 'DELETE',
+        headers: this.headers
+      }
+    );
+
+    if (!response.ok) {
+      const error = await response.json() as any;
+      throw new Error(error.error?.message || 'Failed to remove from whitelist');
+    }
+  }
+
+  /**
+   * Get whitelist statistics
+   */
+  async getStats(): Promise<{
+    enabled: boolean;
+    total: number;
+    tierBreakdown: Array<{ tier: string; count: number }>;
+  }> {
+    const response = await fetch(
+      `${this.config.apiUrl}/api/v1/whitelist/stats`,
+      { headers: this.headers }
+    );
+
+    const result = await response.json() as any;
+    return result.data.stats;
+  }
+
+  /**
+   * Clear all whitelist entries (use with caution!)
+   */
+  async clearAll(): Promise<number> {
+    const response = await fetch(
+      `${this.config.apiUrl}/api/v1/whitelist/all`,
+      {
+        method: 'DELETE',
+        headers: this.headers
+      }
+    );
+
+    if (!response.ok) {
+      const error = await response.json() as any;
+      throw new Error(error.error?.message || 'Failed to clear whitelist');
+    }
+
+    const result = await response.json() as any;
+    const match = result.data.message.match(/Cleared (\d+) entries/);
+    return match ? parseInt(match[1]) : 0;
+  }
+}
+
+/**
+ * Example usage:
+ * 
+ * ```typescript
+ * import { SweetPotatoSDK } from '@sweet-potato/sdk';
+ * import { WhitelistManager } from '@sweet-potato/sdk/admin-utils';
+ * 
+ * // First authenticate as admin
+ * const sdk = new SweetPotatoSDK({ apiUrl, apiKey });
+ * const auth = await sdk.auth.signInWithPassword({
+ *   email: 'admin@example.com',
+ *   password: 'admin_password'
+ * });
+ * 
+ * // Create whitelist manager
+ * const whitelist = new WhitelistManager({
+ *   apiUrl,
+ *   apiKey,
+ *   adminToken: auth.access_token
+ * });
+ * 
+ * // Use whitelist operations
+ * await whitelist.add('vip@example.com', 'premium');
+ * const stats = await whitelist.getStats();
+ * ```
+ */