@promptbook/remote-client 0.98.0 → 0.100.0-0

package/esm/typings/src/config.d.ts

@@ -138,6 +138,9 @@ export declare const SMALL_NUMBER = 0.001;
 /**
  * Timeout for the connections in milliseconds
  *
+ * Note: Increased from 7 seconds to 30 seconds to accommodate OAuth flows
+ * like Facebook login which may require user interaction and redirects
+ *
  * @private within the repository - too low-level in comparison with other `MAX_...`
  */
 export declare const CONNECTION_TIMEOUT_MS: number;
@@ -147,6 +150,13 @@ export declare const CONNECTION_TIMEOUT_MS: number;
  * @private within the repository - too low-level in comparison with other `MAX_...`
  */
 export declare const CONNECTION_RETRIES_LIMIT = 5;
+/**
+ * Timeout specifically for OAuth authentication flows in milliseconds
+ * OAuth flows typically require more time due to user interaction and redirects
+ *
+ * @private within the repository - too low-level in comparison with other `MAX_...`
+ */
+export declare const OAUTH_TIMEOUT_MS: number;
 /**
  * Short time interval to prevent race conditions in milliseconds
  *

package/esm/typings/src/remote-server/connection-improvements.test.d.ts

@@ -0,0 +1 @@
+export {};

package/esm/typings/src/remote-server/utils/connectionProgress.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Connection progress utilities for better user experience during authentication
+ */
+/**
+ * Connection status types for better progress indication
+ *
+ * @private
+ */
+export type ConnectionStatus = 'connecting' | 'authenticating' | 'connected' | 'disconnected' | 'error' | 'timeout';
+/**
+ * Progress callback function type for connection status updates
+ *
+ * @private
+ */
+export type ConnectionProgressCallback = (status: ConnectionStatus, message?: string) => void;
+/**
+ * Enhanced connection options with progress reporting
+ *
+ * @private
+ */
+export interface ConnectionProgressOptions {
+    onProgress?: ConnectionProgressCallback;
+    enableProgressReporting?: boolean;
+}
+/**
+ * Default progress messages for different connection states
+ *
+ * @private
+ */
+export declare const DEFAULT_PROGRESS_MESSAGES: {
+    readonly connecting: "Connecting to Promptbook server...";
+    readonly authenticating: "Authenticating with social provider (Facebook, Google, etc.)...";
+    readonly connected: "Successfully connected to Promptbook server";
+    readonly disconnected: "Disconnected from Promptbook server";
+    readonly error: "Connection failed";
+    readonly timeout: "Connection timed out - this may happen during social login flows";
+};
+/**
+ * Creates a progress reporter for connection status
+ * This can be used by frontend applications to show connection progress
+ *
+ * @private
+ */
+export declare function createConnectionProgressReporter(callback?: ConnectionProgressCallback): ConnectionProgressCallback;
+/**
+ * Timeout constants with descriptions for different connection types
+ *
+ * @private
+ */
+export declare const CONNECTION_TIMEOUTS: {
+    /** Standard timeout for regular connections */
+    readonly STANDARD: number;
+    /** Extended timeout for OAuth flows that require user interaction */
+    readonly OAUTH: number;
+    /** Short timeout for quick health checks */
+    readonly HEALTH_CHECK: number;
+};
+/**
+ * Helper function to get appropriate timeout based on connection type
+ *
+ * @private
+ */
+export declare function getConnectionTimeout(type: 'standard' | 'oauth' | 'health_check'): number;
+/**
+ * Creates a timeout wrapper with progress reporting
+ *
+ * @private
+ */
+export declare function createTimeoutWithProgress(timeoutMs: number, onProgress?: ConnectionProgressCallback): Promise<never>;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.98.0-10`).
+ * It follows semantic versioning (e.g., `0.99.0-0`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/remote-client",
-    "version": "0.98.0",
+    "version": "0.100.0-0",
     "description": "Promptbook: Run AI apps in plain human language across multiple models and platforms",
     "private": false,
     "sideEffects": false,
@@ -100,7 +100,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/remote-client.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.98.0"
+        "@promptbook/core": "0.100.0-0"
     },
     "dependencies": {
         "crypto": "1.0.1",

package/umd/index.umd.js

@@ -23,7 +23,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.98.0';
+    const PROMPTBOOK_ENGINE_VERSION = '0.100.0-0';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -352,9 +352,12 @@
     /**
      * Timeout for the connections in milliseconds
      *
+     * Note: Increased from 7 seconds to 30 seconds to accommodate OAuth flows
+     * like Facebook login which may require user interaction and redirects
+     *
      * @private within the repository - too low-level in comparison with other `MAX_...`
      */
-    const CONNECTION_TIMEOUT_MS = 7 * 1000;
+    const CONNECTION_TIMEOUT_MS = 30 * 1000;
     // <- TODO: [⏳] Standardize timeouts, Make DEFAULT_TIMEOUT_MS as global constant
     /**
      * How many times to retry the connections
@@ -620,13 +623,39 @@
                 transports: ['polling', 'websocket' /*, <- TODO: [🌬] Allow to pass `transports`, add 'webtransport' */],
             });
             // console.log('Connecting to', this.options.remoteServerUrl.href, { socket });
+            let isResolved = false;
             socket.on('connect', () => {
-                resolve(socket);
+                if (!isResolved) {
+                    isResolved = true;
+                    resolve(socket);
+                }
+            });
+            socket.on('connect_error', (error) => {
+                if (!isResolved) {
+                    isResolved = true;
+                    reject(new Error(`Failed to connect to ${remoteServerUrl}: ${error.message || error}`));
+                }
+            });
+            socket.on('disconnect', (reason) => {
+                if (!isResolved) {
+                    isResolved = true;
+                    reject(new Error(`Connection to ${remoteServerUrl} was disconnected: ${reason}`));
+                }
             });
-            // TODO: [💩] Better timeout handling
-            setTimeout(() => {
-                reject(new Error(`Timeout while connecting to ${remoteServerUrl}`));
+            // Better timeout handling with more descriptive error message
+            const timeoutId = setTimeout(() => {
+                if (!isResolved) {
+                    isResolved = true;
+                    socket.disconnect();
+                    reject(new Error(`Connection timeout after ${CONNECTION_TIMEOUT_MS / 1000} seconds while connecting to ${remoteServerUrl}. ` +
+                        `This may indicate network issues or the server may be experiencing high load. ` +
+                        `For authentication flows like social login, ensure sufficient time is allowed for user interaction.`));
+                }
             }, CONNECTION_TIMEOUT_MS);
+            // Clean up timeout if connection succeeds
+            socket.on('connect', () => {
+                clearTimeout(timeoutId);
+            });
         });
     }
 
@@ -5632,8 +5661,33 @@
          * Check the configuration of all execution tools
          */
         async checkConfiguration() {
-            const socket = await createRemoteClient(this.options);
-            socket.disconnect();
+            try {
+                const socket = await createRemoteClient(this.options);
+                socket.disconnect();
+            }
+            catch (error) {
+                if (error instanceof Error) {
+                    // Provide user-friendly error messages for common connection issues
+                    if (error.message.includes('timeout') || error.message.includes('Timeout')) {
+                        throw new Error(`Connection to Promptbook server timed out. This may happen during authentication flows like Facebook login. ` +
+                            `Please ensure: 1) Server is running at ${this.options.remoteServerUrl}, ` +
+                            `2) Network connection is stable, 3) Authentication process is completed within the timeout period. ` +
+                            `Original error: ${error.message}`);
+                    }
+                    if (error.message.includes('connect') || error.message.includes('ECONNREFUSED')) {
+                        throw new Error(`Cannot connect to Promptbook server at ${this.options.remoteServerUrl}. ` +
+                            `Please check if the server is running and accessible. ` +
+                            `Original error: ${error.message}`);
+                    }
+                    if (error.message.includes('authentication') || error.message.includes('auth')) {
+                        throw new Error(`Authentication failed when connecting to Promptbook server. ` +
+                            `This may happen if social login (like Facebook) was not completed properly. ` +
+                            `Please retry the authentication process. ` +
+                            `Original error: ${error.message}`);
+                    }
+                }
+                throw error; // Re-throw if not a recognized error pattern
+            }
             // TODO: [main] !!3 Check version of the remote server and compatibility
             // TODO: [🎍] Send checkConfiguration
         }