@truly-you/trulyyou-web-sdk 0.1.24 → 0.1.26

package/index.d.ts

@@ -0,0 +1,86 @@
+/**
+ * TrulyYou Web SDK - Client-side SDK for browser authentication
+ */
+export class TrulyYouSDK {
+  constructor(config: {
+    appId: string;
+    mode?: 'visible' | 'hidden';
+    authUrl?: string;
+    apiUrl?: string;
+    targetElement?: string | HTMLElement;
+    mockMobile?: boolean;
+  });
+
+  /**
+   * Fetch with TrulyYou signature
+   */
+  fetchWithSignature(url: string, options?: RequestInit): Promise<Response>;
+
+  /**
+   * Get current configuration
+   */
+  getConfig(): {
+    appId: string;
+    mode: string;
+    authUrl: string;
+    mockMobile: boolean;
+  };
+
+  /**
+   * Update mockMobile setting
+   */
+  setMockMobile(enabled: boolean): void;
+
+  /**
+   * Update mode (visible/hidden)
+   */
+  setMode(mode: 'visible' | 'hidden'): void;
+}
+
+/**
+ * TrulyYou Server SDK - Server-side SDK for signature verification
+ */
+export class TrulyYouServer {
+  constructor(config: {
+    appId: string;
+    secretKey: string;
+    apiUrl?: string;
+  });
+
+  /**
+   * Verify a signature from an incoming request
+   */
+  verifySignature(request: {
+    headers: Record<string, string | string[] | undefined>;
+    method: string;
+    url: string;
+    body?: string | object;
+  }): Promise<{
+    verified: boolean;
+    user?: {
+      _id?: string;
+      id?: string;
+      email?: string;
+      [key: string]: any;
+    };
+    verifications?: Record<string, any>;
+    authRequirementsMet?: boolean;
+    missingVerifications?: string[];
+    error?: string;
+  }>;
+
+  /**
+   * Express/Connect middleware for signature verification
+   */
+  middleware(options?: {
+    optional?: boolean;
+    onError?: (error: string, req: any, res: any, next: any) => void;
+  }): (req: any, res: any, next: any) => Promise<void>;
+}
+
+declare global {
+  interface Window {
+    TrulyYouSDK: typeof TrulyYouSDK;
+    TrulyYouServer: typeof TrulyYouServer;
+  }
+}