@insforge/sdk 1.0.1-refresh.9 → 1.0.1-schema.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { UserSchema, CreateUserRequest, CreateUserResponse, CreateSessionRequest, CreateSessionResponse, OAuthProvidersSchema, GetPublicAuthConfigResponse, UserIdSchema, EmailSchema, RoleSchema, SendVerificationEmailRequest, SendResetPasswordEmailRequest, ExchangeResetPasswordTokenRequest, VerifyEmailRequest, StorageFileSchema, ListObjectsResponseSchema, ChatCompletionRequest, ImageGenerationRequest } from '@insforge/shared-schemas';
-export { AuthErrorResponse, CreateSessionRequest, CreateUserRequest, UserSchema } from '@insforge/shared-schemas';
+import { UserSchema, CreateUserRequest, CreateUserResponse, CreateSessionRequest, CreateSessionResponse, OAuthProvidersSchema, GetPublicAuthConfigResponse, GetProfileResponse, SendVerificationEmailRequest, SendResetPasswordEmailRequest, ExchangeResetPasswordTokenRequest, VerifyEmailRequest, StorageFileSchema, ListObjectsResponseSchema, ChatCompletionRequest, ImageGenerationRequest, SubscribeResponse, SocketMessage } from '@insforge/shared-schemas';
+export { AuthErrorResponse, CreateSessionRequest, CreateUserRequest, RealtimeErrorPayload, SocketMessage, SubscribeResponse, UserSchema } from '@insforge/shared-schemas';
 import * as _supabase_postgrest_js from '@supabase/postgrest-js';
 
 /**
@@ -92,69 +92,13 @@ declare class HttpClient {
     getHeaders(): Record<string, string>;
 }
 
-/**
- * Token Manager for InsForge SDK
- *
- * Simple token storage that supports two modes:
- * - Memory mode (new backend): tokens stored in memory only, more secure
- * - Storage mode (legacy backend): tokens persisted in localStorage
- */
-
 declare class TokenManager {
-    private accessToken;
-    private user;
     private storage;
-    private _mode;
     constructor(storage?: TokenStorage);
-    /**
-     * Get current mode
-     */
-    get mode(): 'memory' | 'storage';
-    /**
-     * Set mode to memory (new backend with cookies + memory)
-     */
-    setMemoryMode(): void;
-    /**
-     * Set mode to storage (legacy backend with localStorage)
-     * Also loads existing session from localStorage
-     */
-    setStorageMode(): void;
-    /**
-     * Load session from localStorage
-     */
-    private loadFromStorage;
-    /**
-     * Save session (memory always, localStorage only in storage mode)
-     */
     saveSession(session: AuthSession): void;
-    /**
-     * Get current session
-     */
     getSession(): AuthSession | null;
-    /**
-     * Get access token
-     */
     getAccessToken(): string | null;
-    /**
-     * Set access token
-     */
-    setAccessToken(token: string): void;
-    /**
-     * Get user
-     */
-    getUser(): UserSchema | null;
-    /**
-     * Set user
-     */
-    setUser(user: UserSchema): void;
-    /**
-     * Clear session (both memory and localStorage)
-     */
     clearSession(): void;
-    /**
-     * Check if there's a session in localStorage (for legacy detection)
-     */
-    hasStoredSession(): boolean;
 }
 
 /**
@@ -162,44 +106,10 @@ declare class TokenManager {
  * Uses shared schemas for type safety
  */
 
-/**
- * Dynamic profile type - represents flexible profile data from database
- * Fields can vary based on database schema configuration.
- * All fields are converted from snake_case (database) to camelCase (API)
- */
-type ProfileData = Record<string, any> & {
-    id: string;
-    createdAt?: string;
-    updatedAt?: string;
-};
-/**
- * Dynamic profile update type - for updating profile fields
- * Supports any fields that exist in the profile table
- */
-type UpdateProfileData = Partial<Record<string, any>>;
 declare class Auth {
     private http;
     private tokenManager;
-    private database;
     constructor(http: HttpClient, tokenManager: TokenManager);
-    /**
-   * Restore session on app initialization
-   *
-   * @returns Object with isLoggedIn status
-   *
-   * @example
-   * ```typescript
-   * const client = new InsForgeClient({ baseUrl: '...' });
-   * const { isLoggedIn } = await client.auth.restoreSession();
-   *
-   * if (isLoggedIn) {
-   *   const { data } = await client.auth.getCurrentUser();
-   * }
-   * ```
-   */
-    restoreSession(): Promise<{
-        isLoggedIn: boolean;
-    }>;
     /**
      * Automatically detect and handle OAuth callback parameters in the URL
      * This runs on initialization to seamlessly complete the OAuth flow
@@ -266,22 +176,17 @@ declare class Auth {
      */
     getCurrentUser(): Promise<{
         data: {
-            user: {
-                id: UserIdSchema;
-                email: EmailSchema;
-                role: RoleSchema;
-            };
-            profile: ProfileData | null;
+            user: UserSchema;
         } | null;
         error: any | null;
     }>;
     /**
      * Get any user's profile by ID
-     * Returns profile information from the users table (dynamic fields)
+     * Returns profile information from the users table
      */
     getProfile(userId: string): Promise<{
-        data: ProfileData | null;
-        error: any | null;
+        data: GetProfileResponse | null;
+        error: InsForgeError | null;
     }>;
     /**
      * Get the current session (only session data, no API call)
@@ -296,10 +201,11 @@ declare class Auth {
     /**
      * Set/Update the current user's profile
      * Updates profile information in the users table (supports any dynamic fields)
+     * Requires authentication
      */
-    setProfile(profile: UpdateProfileData): Promise<{
-        data: ProfileData | null;
-        error: any | null;
+    setProfile(profile: Record<string, unknown>): Promise<{
+        data: GetProfileResponse | null;
+        error: InsForgeError | null;
     }>;
     /**
      * Send email verification (code or link based on config)
@@ -656,6 +562,133 @@ declare class Functions {
     }>;
 }
 
+type ConnectionState = 'disconnected' | 'connecting' | 'connected';
+type EventCallback<T = unknown> = (payload: T) => void;
+/**
+ * Realtime module for subscribing to channels and handling real-time events
+ *
+ * @example
+ * ```typescript
+ * const { realtime } = client;
+ *
+ * // Connect to the realtime server
+ * await realtime.connect();
+ *
+ * // Subscribe to a channel
+ * const response = await realtime.subscribe('orders:123');
+ * if (!response.ok) {
+ *   console.error('Failed to subscribe:', response.error);
+ * }
+ *
+ * // Listen for specific events
+ * realtime.on('order_updated', (payload) => {
+ *   console.log('Order updated:', payload);
+ * });
+ *
+ * // Listen for connection events
+ * realtime.on('connect', () => console.log('Connected!'));
+ * realtime.on('connect_error', (err) => console.error('Connection failed:', err));
+ * realtime.on('disconnect', (reason) => console.log('Disconnected:', reason));
+ * realtime.on('error', (error) => console.error('Realtime error:', error));
+ *
+ * // Publish a message to a channel
+ * await realtime.publish('orders:123', 'status_changed', { status: 'shipped' });
+ *
+ * // Unsubscribe and disconnect when done
+ * realtime.unsubscribe('orders:123');
+ * realtime.disconnect();
+ * ```
+ */
+declare class Realtime {
+    private baseUrl;
+    private tokenManager;
+    private socket;
+    private connectPromise;
+    private subscribedChannels;
+    private eventListeners;
+    constructor(baseUrl: string, tokenManager: TokenManager);
+    private notifyListeners;
+    /**
+     * Connect to the realtime server
+     * @returns Promise that resolves when connected
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the realtime server
+     */
+    disconnect(): void;
+    /**
+     * Check if connected to the realtime server
+     */
+    get isConnected(): boolean;
+    /**
+     * Get the current connection state
+     */
+    get connectionState(): ConnectionState;
+    /**
+     * Get the socket ID (if connected)
+     */
+    get socketId(): string | undefined;
+    /**
+     * Subscribe to a channel
+     *
+     * Automatically connects if not already connected.
+     *
+     * @param channel - Channel name (e.g., 'orders:123', 'broadcast')
+     * @returns Promise with the subscription response
+     */
+    subscribe(channel: string): Promise<SubscribeResponse>;
+    /**
+     * Unsubscribe from a channel (fire-and-forget)
+     *
+     * @param channel - Channel name to unsubscribe from
+     */
+    unsubscribe(channel: string): void;
+    /**
+     * Publish a message to a channel
+     *
+     * @param channel - Channel name
+     * @param event - Event name
+     * @param payload - Message payload
+     */
+    publish<T = unknown>(channel: string, event: string, payload: T): Promise<void>;
+    /**
+     * Listen for events
+     *
+     * Reserved event names:
+     * - 'connect' - Fired when connected to the server
+     * - 'connect_error' - Fired when connection fails (payload: Error)
+     * - 'disconnect' - Fired when disconnected (payload: reason string)
+     * - 'error' - Fired when a realtime error occurs (payload: RealtimeErrorPayload)
+     *
+     * All other events receive a `SocketMessage` payload with metadata.
+     *
+     * @param event - Event name to listen for
+     * @param callback - Callback function when event is received
+     */
+    on<T = SocketMessage>(event: string, callback: EventCallback<T>): void;
+    /**
+     * Remove a listener for a specific event
+     *
+     * @param event - Event name
+     * @param callback - The callback function to remove
+     */
+    off<T = SocketMessage>(event: string, callback: EventCallback<T>): void;
+    /**
+     * Listen for an event only once, then automatically remove the listener
+     *
+     * @param event - Event name to listen for
+     * @param callback - Callback function when event is received
+     */
+    once<T = SocketMessage>(event: string, callback: EventCallback<T>): void;
+    /**
+     * Get all currently subscribed channels
+     *
+     * @returns Array of channel names
+     */
+    getSubscribedChannels(): string[];
+}
+
 /**
  * Main InsForge SDK Client
  *
@@ -668,7 +701,7 @@ declare class Functions {
  * });
  *
  * // Authentication
- * const { data, error } = await client.auth.signUp({
+ * const session = await client.auth.register({
  *   email: 'user@example.com',
  *   password: 'password123',
  *   name: 'John Doe'
@@ -702,6 +735,7 @@ declare class InsForgeClient {
     readonly storage: Storage;
     readonly ai: AI;
     readonly functions: Functions;
+    readonly realtime: Realtime;
     constructor(config?: InsForgeConfig);
     /**
      * Get the underlying HTTP client for custom requests
@@ -723,4 +757,4 @@ declare class InsForgeClient {
 
 declare function createClient(config: InsForgeConfig): InsForgeClient;
 
-export { AI, type ApiError, Auth, type AuthSession, type InsForgeConfig as ClientOptions, Database, type FunctionInvokeOptions, Functions, HttpClient, InsForgeClient, type InsForgeConfig, InsForgeError, type ProfileData, Storage, StorageBucket, type StorageResponse, TokenManager, type TokenStorage, type UpdateProfileData, createClient, InsForgeClient as default };
+export { AI, type ApiError, Auth, type AuthSession, type InsForgeConfig as ClientOptions, type ConnectionState, Database, type EventCallback, type FunctionInvokeOptions, Functions, HttpClient, InsForgeClient, type InsForgeConfig, InsForgeError, Realtime, Storage, StorageBucket, type StorageResponse, TokenManager, type TokenStorage, createClient, InsForgeClient as default };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { UserSchema, CreateUserRequest, CreateUserResponse, CreateSessionRequest, CreateSessionResponse, OAuthProvidersSchema, GetPublicAuthConfigResponse, UserIdSchema, EmailSchema, RoleSchema, SendVerificationEmailRequest, SendResetPasswordEmailRequest, ExchangeResetPasswordTokenRequest, VerifyEmailRequest, StorageFileSchema, ListObjectsResponseSchema, ChatCompletionRequest, ImageGenerationRequest } from '@insforge/shared-schemas';
-export { AuthErrorResponse, CreateSessionRequest, CreateUserRequest, UserSchema } from '@insforge/shared-schemas';
+import { UserSchema, CreateUserRequest, CreateUserResponse, CreateSessionRequest, CreateSessionResponse, OAuthProvidersSchema, GetPublicAuthConfigResponse, GetProfileResponse, SendVerificationEmailRequest, SendResetPasswordEmailRequest, ExchangeResetPasswordTokenRequest, VerifyEmailRequest, StorageFileSchema, ListObjectsResponseSchema, ChatCompletionRequest, ImageGenerationRequest, SubscribeResponse, SocketMessage } from '@insforge/shared-schemas';
+export { AuthErrorResponse, CreateSessionRequest, CreateUserRequest, RealtimeErrorPayload, SocketMessage, SubscribeResponse, UserSchema } from '@insforge/shared-schemas';
 import * as _supabase_postgrest_js from '@supabase/postgrest-js';
 
 /**
@@ -92,69 +92,13 @@ declare class HttpClient {
     getHeaders(): Record<string, string>;
 }
 
-/**
- * Token Manager for InsForge SDK
- *
- * Simple token storage that supports two modes:
- * - Memory mode (new backend): tokens stored in memory only, more secure
- * - Storage mode (legacy backend): tokens persisted in localStorage
- */
-
 declare class TokenManager {
-    private accessToken;
-    private user;
     private storage;
-    private _mode;
     constructor(storage?: TokenStorage);
-    /**
-     * Get current mode
-     */
-    get mode(): 'memory' | 'storage';
-    /**
-     * Set mode to memory (new backend with cookies + memory)
-     */
-    setMemoryMode(): void;
-    /**
-     * Set mode to storage (legacy backend with localStorage)
-     * Also loads existing session from localStorage
-     */
-    setStorageMode(): void;
-    /**
-     * Load session from localStorage
-     */
-    private loadFromStorage;
-    /**
-     * Save session (memory always, localStorage only in storage mode)
-     */
     saveSession(session: AuthSession): void;
-    /**
-     * Get current session
-     */
     getSession(): AuthSession | null;
-    /**
-     * Get access token
-     */
     getAccessToken(): string | null;
-    /**
-     * Set access token
-     */
-    setAccessToken(token: string): void;
-    /**
-     * Get user
-     */
-    getUser(): UserSchema | null;
-    /**
-     * Set user
-     */
-    setUser(user: UserSchema): void;
-    /**
-     * Clear session (both memory and localStorage)
-     */
     clearSession(): void;
-    /**
-     * Check if there's a session in localStorage (for legacy detection)
-     */
-    hasStoredSession(): boolean;
 }
 
 /**
@@ -162,44 +106,10 @@ declare class TokenManager {
  * Uses shared schemas for type safety
  */
 
-/**
- * Dynamic profile type - represents flexible profile data from database
- * Fields can vary based on database schema configuration.
- * All fields are converted from snake_case (database) to camelCase (API)
- */
-type ProfileData = Record<string, any> & {
-    id: string;
-    createdAt?: string;
-    updatedAt?: string;
-};
-/**
- * Dynamic profile update type - for updating profile fields
- * Supports any fields that exist in the profile table
- */
-type UpdateProfileData = Partial<Record<string, any>>;
 declare class Auth {
     private http;
     private tokenManager;
-    private database;
     constructor(http: HttpClient, tokenManager: TokenManager);
-    /**
-   * Restore session on app initialization
-   *
-   * @returns Object with isLoggedIn status
-   *
-   * @example
-   * ```typescript
-   * const client = new InsForgeClient({ baseUrl: '...' });
-   * const { isLoggedIn } = await client.auth.restoreSession();
-   *
-   * if (isLoggedIn) {
-   *   const { data } = await client.auth.getCurrentUser();
-   * }
-   * ```
-   */
-    restoreSession(): Promise<{
-        isLoggedIn: boolean;
-    }>;
     /**
      * Automatically detect and handle OAuth callback parameters in the URL
      * This runs on initialization to seamlessly complete the OAuth flow
@@ -266,22 +176,17 @@ declare class Auth {
      */
     getCurrentUser(): Promise<{
         data: {
-            user: {
-                id: UserIdSchema;
-                email: EmailSchema;
-                role: RoleSchema;
-            };
-            profile: ProfileData | null;
+            user: UserSchema;
         } | null;
         error: any | null;
     }>;
     /**
      * Get any user's profile by ID
-     * Returns profile information from the users table (dynamic fields)
+     * Returns profile information from the users table
      */
     getProfile(userId: string): Promise<{
-        data: ProfileData | null;
-        error: any | null;
+        data: GetProfileResponse | null;
+        error: InsForgeError | null;
     }>;
     /**
      * Get the current session (only session data, no API call)
@@ -296,10 +201,11 @@ declare class Auth {
     /**
      * Set/Update the current user's profile
      * Updates profile information in the users table (supports any dynamic fields)
+     * Requires authentication
      */
-    setProfile(profile: UpdateProfileData): Promise<{
-        data: ProfileData | null;
-        error: any | null;
+    setProfile(profile: Record<string, unknown>): Promise<{
+        data: GetProfileResponse | null;
+        error: InsForgeError | null;
     }>;
     /**
      * Send email verification (code or link based on config)
@@ -656,6 +562,133 @@ declare class Functions {
     }>;
 }
 
+type ConnectionState = 'disconnected' | 'connecting' | 'connected';
+type EventCallback<T = unknown> = (payload: T) => void;
+/**
+ * Realtime module for subscribing to channels and handling real-time events
+ *
+ * @example
+ * ```typescript
+ * const { realtime } = client;
+ *
+ * // Connect to the realtime server
+ * await realtime.connect();
+ *
+ * // Subscribe to a channel
+ * const response = await realtime.subscribe('orders:123');
+ * if (!response.ok) {
+ *   console.error('Failed to subscribe:', response.error);
+ * }
+ *
+ * // Listen for specific events
+ * realtime.on('order_updated', (payload) => {
+ *   console.log('Order updated:', payload);
+ * });
+ *
+ * // Listen for connection events
+ * realtime.on('connect', () => console.log('Connected!'));
+ * realtime.on('connect_error', (err) => console.error('Connection failed:', err));
+ * realtime.on('disconnect', (reason) => console.log('Disconnected:', reason));
+ * realtime.on('error', (error) => console.error('Realtime error:', error));
+ *
+ * // Publish a message to a channel
+ * await realtime.publish('orders:123', 'status_changed', { status: 'shipped' });
+ *
+ * // Unsubscribe and disconnect when done
+ * realtime.unsubscribe('orders:123');
+ * realtime.disconnect();
+ * ```
+ */
+declare class Realtime {
+    private baseUrl;
+    private tokenManager;
+    private socket;
+    private connectPromise;
+    private subscribedChannels;
+    private eventListeners;
+    constructor(baseUrl: string, tokenManager: TokenManager);
+    private notifyListeners;
+    /**
+     * Connect to the realtime server
+     * @returns Promise that resolves when connected
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the realtime server
+     */
+    disconnect(): void;
+    /**
+     * Check if connected to the realtime server
+     */
+    get isConnected(): boolean;
+    /**
+     * Get the current connection state
+     */
+    get connectionState(): ConnectionState;
+    /**
+     * Get the socket ID (if connected)
+     */
+    get socketId(): string | undefined;
+    /**
+     * Subscribe to a channel
+     *
+     * Automatically connects if not already connected.
+     *
+     * @param channel - Channel name (e.g., 'orders:123', 'broadcast')
+     * @returns Promise with the subscription response
+     */
+    subscribe(channel: string): Promise<SubscribeResponse>;
+    /**
+     * Unsubscribe from a channel (fire-and-forget)
+     *
+     * @param channel - Channel name to unsubscribe from
+     */
+    unsubscribe(channel: string): void;
+    /**
+     * Publish a message to a channel
+     *
+     * @param channel - Channel name
+     * @param event - Event name
+     * @param payload - Message payload
+     */
+    publish<T = unknown>(channel: string, event: string, payload: T): Promise<void>;
+    /**
+     * Listen for events
+     *
+     * Reserved event names:
+     * - 'connect' - Fired when connected to the server
+     * - 'connect_error' - Fired when connection fails (payload: Error)
+     * - 'disconnect' - Fired when disconnected (payload: reason string)
+     * - 'error' - Fired when a realtime error occurs (payload: RealtimeErrorPayload)
+     *
+     * All other events receive a `SocketMessage` payload with metadata.
+     *
+     * @param event - Event name to listen for
+     * @param callback - Callback function when event is received
+     */
+    on<T = SocketMessage>(event: string, callback: EventCallback<T>): void;
+    /**
+     * Remove a listener for a specific event
+     *
+     * @param event - Event name
+     * @param callback - The callback function to remove
+     */
+    off<T = SocketMessage>(event: string, callback: EventCallback<T>): void;
+    /**
+     * Listen for an event only once, then automatically remove the listener
+     *
+     * @param event - Event name to listen for
+     * @param callback - Callback function when event is received
+     */
+    once<T = SocketMessage>(event: string, callback: EventCallback<T>): void;
+    /**
+     * Get all currently subscribed channels
+     *
+     * @returns Array of channel names
+     */
+    getSubscribedChannels(): string[];
+}
+
 /**
  * Main InsForge SDK Client
  *
@@ -668,7 +701,7 @@ declare class Functions {
  * });
  *
  * // Authentication
- * const { data, error } = await client.auth.signUp({
+ * const session = await client.auth.register({
  *   email: 'user@example.com',
  *   password: 'password123',
  *   name: 'John Doe'
@@ -702,6 +735,7 @@ declare class InsForgeClient {
     readonly storage: Storage;
     readonly ai: AI;
     readonly functions: Functions;
+    readonly realtime: Realtime;
     constructor(config?: InsForgeConfig);
     /**
      * Get the underlying HTTP client for custom requests
@@ -723,4 +757,4 @@ declare class InsForgeClient {
 
 declare function createClient(config: InsForgeConfig): InsForgeClient;
 
-export { AI, type ApiError, Auth, type AuthSession, type InsForgeConfig as ClientOptions, Database, type FunctionInvokeOptions, Functions, HttpClient, InsForgeClient, type InsForgeConfig, InsForgeError, type ProfileData, Storage, StorageBucket, type StorageResponse, TokenManager, type TokenStorage, type UpdateProfileData, createClient, InsForgeClient as default };
+export { AI, type ApiError, Auth, type AuthSession, type InsForgeConfig as ClientOptions, type ConnectionState, Database, type EventCallback, type FunctionInvokeOptions, Functions, HttpClient, InsForgeClient, type InsForgeConfig, InsForgeError, Realtime, Storage, StorageBucket, type StorageResponse, TokenManager, type TokenStorage, createClient, InsForgeClient as default };