@insforge/sdk 1.0.1-refresh.9 → 1.0.1

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, UserIdSchema, EmailSchema, RoleSchema, 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;
 }
 
 /**
@@ -182,24 +126,6 @@ declare class Auth {
     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
@@ -656,6 +582,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 +721,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 +755,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 +777,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, type ProfileData, Realtime, Storage, StorageBucket, type StorageResponse, TokenManager, type TokenStorage, type UpdateProfileData, 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, UserIdSchema, EmailSchema, RoleSchema, 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;
 }
 
 /**
@@ -182,24 +126,6 @@ declare class Auth {
     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
@@ -656,6 +582,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 +721,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 +755,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 +777,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, type ProfileData, Realtime, Storage, StorageBucket, type StorageResponse, TokenManager, type TokenStorage, type UpdateProfileData, createClient, InsForgeClient as default };