lexmount 0.5.1 → 0.5.3

package/dist/index.d.mts

@@ -171,6 +171,28 @@ interface SessionCreateOptions {
      * Optional upstream proxy configuration.
      */
     proxy?: SessionProxyConfig;
+    /**
+     * Forward weak_lock to the API when creating sessions with read-write contexts.
+     */
+    weakLock?: boolean;
+    /**
+     * Use the async create API (`POST /instance/v2`) and poll until active.
+     *
+     * Defaults to true. Set to false to use the legacy synchronous `POST /instance`.
+     */
+    asyncCreate?: boolean;
+    /**
+     * Delay between async create status polls in milliseconds.
+     *
+     * Defaults to 1000.
+     */
+    pollIntervalMs?: number;
+    /**
+     * Maximum time to wait for async create activation in milliseconds.
+     *
+     * Defaults to 600000.
+     */
+    pollTimeoutMs?: number;
 }
 /**
  * Session list options.
@@ -566,6 +588,7 @@ declare class SessionsResource {
      * Create a new browser session.
      */
     create(options?: SessionCreateOptions): Promise<SessionCreateResponse>;
+    private createAsync;
     /**
      * Fetch one session by id.
      *
@@ -592,6 +615,7 @@ declare class SessionsResource {
      */
     _getWebSocketDebuggerUrl(sessionId: string): Promise<string | null>;
     private normalizeProxy;
+    private handleAsyncCreateFailed;
     private handleCreateError;
     private handleGetError;
     private handleListError;
@@ -748,6 +772,6 @@ declare class TimeoutError extends LexmountError {
 /**
  * Lexmount Node.js SDK.
  */
-declare const VERSION = "0.5.1";
+declare const VERSION = "0.5.3";
 
 export { APIError, AuthenticationError, type BrowserMode, type CatalogInfo, type ContextAccessMode, type ContextCreateOptions, ContextInfo, type ContextListOptions, ContextListResponse, ContextLockedError, type ContextMetadata, ContextNotFoundError, type ContextStatus, ContextsResource, ExtensionInfo, type ExtensionInfoShape, type ExtensionListOptions, type ExtensionUploadOptions, ExtensionsResource, type ForceReleaseResponse, Lexmount, type LexmountConfig, LexmountError, LexmountLogger, type LogLevel, NetworkError, PaginationInfo, type PaginationInfoShape, type RegionCatalogEntry, type RegionInfo, type SessionContext, type SessionCreateOptions, type SessionCreateResponse, type SessionDeleteOptions, SessionDownloadInfo, type SessionDownloadInfoShape, SessionDownloadsDeleteResponse, type SessionDownloadsDeleteResponseShape, SessionDownloadsListResponse, type SessionDownloadsListResponseShape, SessionDownloadsResource, SessionInfo, type SessionListOptions, SessionListResponse, SessionNotFoundError, type SessionProxyConfig, type SessionStatus, SessionTargetInfo, type SessionTargetInfoShape, SessionsResource, TimeoutError, VERSION, ValidationError, Lexmount as default, disableLogging, enableLogging, getLogger, setLogLevel };

package/dist/index.d.ts

@@ -171,6 +171,28 @@ interface SessionCreateOptions {
      * Optional upstream proxy configuration.
      */
     proxy?: SessionProxyConfig;
+    /**
+     * Forward weak_lock to the API when creating sessions with read-write contexts.
+     */
+    weakLock?: boolean;
+    /**
+     * Use the async create API (`POST /instance/v2`) and poll until active.
+     *
+     * Defaults to true. Set to false to use the legacy synchronous `POST /instance`.
+     */
+    asyncCreate?: boolean;
+    /**
+     * Delay between async create status polls in milliseconds.
+     *
+     * Defaults to 1000.
+     */
+    pollIntervalMs?: number;
+    /**
+     * Maximum time to wait for async create activation in milliseconds.
+     *
+     * Defaults to 600000.
+     */
+    pollTimeoutMs?: number;
 }
 /**
  * Session list options.
@@ -566,6 +588,7 @@ declare class SessionsResource {
      * Create a new browser session.
      */
     create(options?: SessionCreateOptions): Promise<SessionCreateResponse>;
+    private createAsync;
     /**
      * Fetch one session by id.
      *
@@ -592,6 +615,7 @@ declare class SessionsResource {
      */
     _getWebSocketDebuggerUrl(sessionId: string): Promise<string | null>;
     private normalizeProxy;
+    private handleAsyncCreateFailed;
     private handleCreateError;
     private handleGetError;
     private handleListError;
@@ -748,6 +772,6 @@ declare class TimeoutError extends LexmountError {
 /**
  * Lexmount Node.js SDK.
  */
-declare const VERSION = "0.5.1";
+declare const VERSION = "0.5.3";
 
 export { APIError, AuthenticationError, type BrowserMode, type CatalogInfo, type ContextAccessMode, type ContextCreateOptions, ContextInfo, type ContextListOptions, ContextListResponse, ContextLockedError, type ContextMetadata, ContextNotFoundError, type ContextStatus, ContextsResource, ExtensionInfo, type ExtensionInfoShape, type ExtensionListOptions, type ExtensionUploadOptions, ExtensionsResource, type ForceReleaseResponse, Lexmount, type LexmountConfig, LexmountError, LexmountLogger, type LogLevel, NetworkError, PaginationInfo, type PaginationInfoShape, type RegionCatalogEntry, type RegionInfo, type SessionContext, type SessionCreateOptions, type SessionCreateResponse, type SessionDeleteOptions, SessionDownloadInfo, type SessionDownloadInfoShape, SessionDownloadsDeleteResponse, type SessionDownloadsDeleteResponseShape, SessionDownloadsListResponse, type SessionDownloadsListResponseShape, SessionDownloadsResource, SessionInfo, type SessionListOptions, SessionListResponse, SessionNotFoundError, type SessionProxyConfig, type SessionStatus, SessionTargetInfo, type SessionTargetInfoShape, SessionsResource, TimeoutError, VERSION, ValidationError, Lexmount as default, disableLogging, enableLogging, getLogger, setLogLevel };

package/dist/index.js

@@ -620,6 +620,11 @@ function normalizeContextMode(mode) {
   }
   return "read_only";
 }
+function delay(ms) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
+}
 var PaginationInfo = class {
   constructor(shape) {
     this.currentPage = shape.currentPage;
@@ -851,7 +856,6 @@ var SessionsResource = class {
    * Create a new browser session.
    */
   async create(options = {}) {
-    const url = `${this.client.baseUrl}/instance`;
     const payload = {
       api_key: this.client.apiKey,
       project_id: options.projectId ?? this.client.projectId,
@@ -875,6 +879,13 @@ var SessionsResource = class {
     if (options.proxy) {
       payload.proxy = this.normalizeProxy(options.proxy);
     }
+    if (options.weakLock) {
+      payload.weak_lock = true;
+    }
+    if (options.asyncCreate !== false) {
+      return this.createAsync(payload, options);
+    }
+    const url = `${this.client.baseUrl}/instance`;
     const response = await this.client._post(url, payload);
     if (response.status >= 400) {
       this.handleCreateError(response);
@@ -905,6 +916,60 @@ var SessionsResource = class {
       client: this.client
     });
   }
+  async createAsync(payload, options) {
+    const response = await this.client._post(`${this.client.baseUrl}/instance/v2`, payload);
+    if (response.status >= 400) {
+      this.handleCreateError(response);
+    }
+    const result = asRecord3(response.data);
+    const sessionId = getString3(result.session_id);
+    if (!sessionId) {
+      throw new APIError("Failed to create session: session_id missing from response", {
+        statusCode: response.status,
+        response: response.data
+      });
+    }
+    const projectId = options.projectId ?? this.client.projectId;
+    const pollIntervalMs = options.pollIntervalMs ?? 1e3;
+    const pollTimeoutMs = options.pollTimeoutMs ?? 6e5;
+    const deadline = Date.now() + pollTimeoutMs;
+    while (Date.now() < deadline) {
+      const info = await this.get(sessionId, projectId);
+      if (info.status === "active") {
+        const wsUrl = await this._getWebSocketDebuggerUrl(sessionId);
+        getLogger().info(`Session created successfully (async): id=${sessionId}`);
+        return new SessionInfo({
+          id: sessionId,
+          status: "active",
+          apiKey: this.client.apiKey,
+          projectId,
+          browserType: info.browserType || (options.browserMode ?? "normal"),
+          createdAt: info.createdAt,
+          inspectUrl: info.inspectUrl,
+          containerId: info.containerId,
+          ws: wsUrl ?? info.ws,
+          client: this.client
+        });
+      }
+      if (info.status === "create_failed") {
+        this.handleAsyncCreateFailed(payload);
+        throw new APIError("Session creation failed", {
+          statusCode: 500,
+          response: { session_id: sessionId, status: info.status }
+        });
+      }
+      if (info.status === "closed") {
+        throw new APIError("Session closed before activation", {
+          statusCode: 500,
+          response: { session_id: sessionId, status: info.status }
+        });
+      }
+      await delay(pollIntervalMs);
+    }
+    throw new TimeoutError(
+      `Timed out waiting for session ${sessionId} to become active after ${pollTimeoutMs}ms`
+    );
+  }
   /**
    * Fetch one session by id.
    *
@@ -1021,6 +1086,14 @@ var SessionsResource = class {
     }
     return normalizedProxy;
   }
+  handleAsyncCreateFailed(payload) {
+    const context = asRecord3(payload.context);
+    const contextId = getString3(context.id);
+    const contextMode = getString3(context.mode);
+    if (contextId && contextMode === "read_write" && payload.weak_lock !== true) {
+      throw new ContextLockedError("Context is locked by another active session");
+    }
+  }
   handleCreateError(response) {
     const errorData = asRecord3(response.data);
     const errorMessage = getString3(errorData.error) ?? getString3(errorData.message) ?? "Unknown error";
@@ -1422,7 +1495,7 @@ var Lexmount = class {
 };
 
 // src/index.ts
-var VERSION = "0.5.1";
+var VERSION = "0.5.3";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   APIError,