lexmount 0.5.3 → 0.5.5

package/dist/index.d.mts

@@ -1,3 +1,5 @@
+/// <reference path="../types/chrome-remote-interface.d.ts" />
+import { EventEmitter } from 'events';
 import { AxiosRequestConfig, AxiosResponse } from 'axios';
 
 /**
@@ -443,6 +445,87 @@ declare class ExtensionsResource {
     private handleError;
 }
 
+/**
+ * Lexmount API client.
+ */
+
+/**
+ * Main Lexmount SDK client.
+ */
+declare class Lexmount {
+    /**
+     * API key used for authentication.
+     */
+    readonly apiKey: string;
+    /**
+     * Default project identifier used by resource methods.
+     */
+    readonly projectId: string;
+    /**
+     * API base URL.
+     */
+    readonly baseUrl: string;
+    readonly region?: string;
+    selectedRegion?: string;
+    private endpointBaseUrl?;
+    private selectedHost?;
+    private regionResolutionAttempted;
+    private regionResolutionPromise?;
+    /**
+     * Session operations.
+     */
+    readonly sessions: SessionsResource;
+    /**
+     * Persistent context operations.
+     */
+    readonly contexts: ContextsResource;
+    /**
+     * Browser extension operations.
+     */
+    readonly extensions: ExtensionsResource;
+    private readonly httpClient;
+    constructor(config?: LexmountConfig);
+    /**
+     * Internal POST request helper with timeout and network error mapping.
+     *
+     * @internal
+     */
+    _post<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+    /**
+     * Internal GET request helper with timeout and network error mapping.
+     *
+     * @internal
+     */
+    _get<T = unknown>(url: string, params?: Record<string, unknown>, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+    /**
+     * Internal DELETE request helper with timeout and network error mapping.
+     *
+     * @internal
+     */
+    _delete<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+    regionInfo(): Promise<RegionInfo>;
+    catalogInfo(): Promise<CatalogInfo>;
+    /**
+     * Close the client.
+     *
+     * Axios does not require explicit teardown, but the method is kept for API symmetry.
+     */
+    close(): void;
+    /**
+     * String representation of the client.
+     */
+    toString(): string;
+    private request;
+    private normalizeRequestError;
+    private getDefaultHeaders;
+    private ensureRegionResolved;
+    private resolveRegion;
+    private selectCatalogRegion;
+    private probeRegionHost;
+    private isAllowedCatalogHost;
+    private rewriteUrl;
+}
+
 /**
  * Session resource implementation.
  */
@@ -464,6 +547,7 @@ interface SessionInfoOptions {
     status: SessionStatus;
     apiKey: string;
     projectId: string;
+    regionId?: string | null;
     browserType: BrowserMode | string;
     createdAt: string;
     inspectUrl: string;
@@ -480,6 +564,8 @@ declare class SessionInfo {
     readonly status: SessionStatus;
     readonly apiKey: string;
     readonly projectId: string;
+    readonly regionId: string | null;
+    readonly region_id: string | null;
     readonly browserType: BrowserMode | string;
     readonly createdAt: string;
     readonly inspectUrl: string;
@@ -627,85 +713,65 @@ declare class SessionsResource {
 }
 
 /**
- * Lexmount API client.
+ * Chrome DevTools Protocol connection helpers.
  */
 
+interface CDPEventMessage {
+    method: string;
+    params?: Record<string, unknown>;
+    sessionId?: string;
+}
 /**
- * Main Lexmount SDK client.
+ * Lexmount CDP client.
+ *
+ * It forwards Chrome DevTools Protocol notifications through EventEmitter and
+ * exposes `send()` for raw CDP commands.
  */
-declare class Lexmount {
-    /**
-     * API key used for authentication.
-     */
-    readonly apiKey: string;
-    /**
-     * Default project identifier used by resource methods.
-     */
-    readonly projectId: string;
-    /**
-     * API base URL.
-     */
-    readonly baseUrl: string;
-    readonly region?: string;
-    selectedRegion?: string;
-    private endpointBaseUrl?;
-    private selectedHost?;
-    private regionResolutionAttempted;
-    private regionResolutionPromise?;
-    /**
-     * Session operations.
-     */
-    readonly sessions: SessionsResource;
-    /**
-     * Persistent context operations.
-     */
-    readonly contexts: ContextsResource;
-    /**
-     * Browser extension operations.
-     */
-    readonly extensions: ExtensionsResource;
-    private readonly httpClient;
-    constructor(config?: LexmountConfig);
-    /**
-     * Internal POST request helper with timeout and network error mapping.
-     *
-     * @internal
-     */
-    _post<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
-    /**
-     * Internal GET request helper with timeout and network error mapping.
-     *
-     * @internal
-     */
-    _get<T = unknown>(url: string, params?: Record<string, unknown>, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+declare class CDPClient extends EventEmitter {
+    readonly session: SessionInfo;
+    private closed;
+    private rawClient?;
+    constructor(session: SessionInfo);
     /**
-     * Internal DELETE request helper with timeout and network error mapping.
-     *
-     * @internal
+     * Connect the CDP client to the session.
      */
-    _delete<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
-    regionInfo(): Promise<RegionInfo>;
-    catalogInfo(): Promise<CatalogInfo>;
+    connect(): Promise<this>;
     /**
-     * Close the client.
+     * Send a raw Chrome DevTools Protocol command.
      *
-     * Axios does not require explicit teardown, but the method is kept for API symmetry.
+     * Returns `undefined` if called before the client has connected.
      */
-    close(): void;
+    send(method: string, params?: any, sessionId?: string): Promise<any | undefined>;
     /**
-     * String representation of the client.
+     * Close the CDP connection and release internal listeners.
      */
-    toString(): string;
-    private request;
-    private normalizeRequestError;
-    private getDefaultHeaders;
-    private ensureRegionResolved;
-    private resolveRegion;
-    private selectCatalogRegion;
-    private probeRegionHost;
-    private isAllowedCatalogHost;
-    private rewriteUrl;
+    close(): Promise<void>;
 }
+/**
+ * Connect to a Lexmount browser session over Chrome DevTools Protocol.
+ */
+declare function connectOverCDP(session: SessionInfo): Promise<CDPClient>;
+
+/**
+ * Integrated authentication helpers.
+ */
+
+type IntegratedAuthCallbackResult = {
+    cancel: true;
+} | {
+    cancel: false;
+    scheme: string;
+    token: string;
+};
+type IntegratedAuthCallback = (params: any, callback: (result: IntegratedAuthCallbackResult) => Promise<void>) => void | Promise<void>;
+/**
+ * Register an integrated auth callback for a session.
+ */
+declare function registerIntegratedAuthCallback(sessionOrClient: SessionInfo | CDPClient, callback: IntegratedAuthCallback): Promise<void>;
+/**
+ * Deregister a previously registered integrated auth callback.
+ */
+declare function deregisterIntegratedAuthCallback(sessionOrClient: SessionInfo | CDPClient, callback: IntegratedAuthCallback): void;
 
 /**
  * Lexmount SDK error hierarchy.
@@ -772,6 +838,6 @@ declare class TimeoutError extends LexmountError {
 /**
  * Lexmount Node.js SDK.
  */
-declare const VERSION = "0.5.3";
+declare const VERSION = "0.5.5";
 
-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 };
+export { APIError, AuthenticationError, type BrowserMode, CDPClient, type CDPEventMessage, 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, type IntegratedAuthCallback, type IntegratedAuthCallbackResult, 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, connectOverCDP, Lexmount as default, deregisterIntegratedAuthCallback, disableLogging, enableLogging, getLogger, registerIntegratedAuthCallback, setLogLevel };

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+/// <reference path="../types/chrome-remote-interface.d.ts" />
+import { EventEmitter } from 'events';
 import { AxiosRequestConfig, AxiosResponse } from 'axios';
 
 /**
@@ -443,6 +445,87 @@ declare class ExtensionsResource {
     private handleError;
 }
 
+/**
+ * Lexmount API client.
+ */
+
+/**
+ * Main Lexmount SDK client.
+ */
+declare class Lexmount {
+    /**
+     * API key used for authentication.
+     */
+    readonly apiKey: string;
+    /**
+     * Default project identifier used by resource methods.
+     */
+    readonly projectId: string;
+    /**
+     * API base URL.
+     */
+    readonly baseUrl: string;
+    readonly region?: string;
+    selectedRegion?: string;
+    private endpointBaseUrl?;
+    private selectedHost?;
+    private regionResolutionAttempted;
+    private regionResolutionPromise?;
+    /**
+     * Session operations.
+     */
+    readonly sessions: SessionsResource;
+    /**
+     * Persistent context operations.
+     */
+    readonly contexts: ContextsResource;
+    /**
+     * Browser extension operations.
+     */
+    readonly extensions: ExtensionsResource;
+    private readonly httpClient;
+    constructor(config?: LexmountConfig);
+    /**
+     * Internal POST request helper with timeout and network error mapping.
+     *
+     * @internal
+     */
+    _post<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+    /**
+     * Internal GET request helper with timeout and network error mapping.
+     *
+     * @internal
+     */
+    _get<T = unknown>(url: string, params?: Record<string, unknown>, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+    /**
+     * Internal DELETE request helper with timeout and network error mapping.
+     *
+     * @internal
+     */
+    _delete<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+    regionInfo(): Promise<RegionInfo>;
+    catalogInfo(): Promise<CatalogInfo>;
+    /**
+     * Close the client.
+     *
+     * Axios does not require explicit teardown, but the method is kept for API symmetry.
+     */
+    close(): void;
+    /**
+     * String representation of the client.
+     */
+    toString(): string;
+    private request;
+    private normalizeRequestError;
+    private getDefaultHeaders;
+    private ensureRegionResolved;
+    private resolveRegion;
+    private selectCatalogRegion;
+    private probeRegionHost;
+    private isAllowedCatalogHost;
+    private rewriteUrl;
+}
+
 /**
  * Session resource implementation.
  */
@@ -464,6 +547,7 @@ interface SessionInfoOptions {
     status: SessionStatus;
     apiKey: string;
     projectId: string;
+    regionId?: string | null;
     browserType: BrowserMode | string;
     createdAt: string;
     inspectUrl: string;
@@ -480,6 +564,8 @@ declare class SessionInfo {
     readonly status: SessionStatus;
     readonly apiKey: string;
     readonly projectId: string;
+    readonly regionId: string | null;
+    readonly region_id: string | null;
     readonly browserType: BrowserMode | string;
     readonly createdAt: string;
     readonly inspectUrl: string;
@@ -627,85 +713,65 @@ declare class SessionsResource {
 }
 
 /**
- * Lexmount API client.
+ * Chrome DevTools Protocol connection helpers.
  */
 
+interface CDPEventMessage {
+    method: string;
+    params?: Record<string, unknown>;
+    sessionId?: string;
+}
 /**
- * Main Lexmount SDK client.
+ * Lexmount CDP client.
+ *
+ * It forwards Chrome DevTools Protocol notifications through EventEmitter and
+ * exposes `send()` for raw CDP commands.
  */
-declare class Lexmount {
-    /**
-     * API key used for authentication.
-     */
-    readonly apiKey: string;
-    /**
-     * Default project identifier used by resource methods.
-     */
-    readonly projectId: string;
-    /**
-     * API base URL.
-     */
-    readonly baseUrl: string;
-    readonly region?: string;
-    selectedRegion?: string;
-    private endpointBaseUrl?;
-    private selectedHost?;
-    private regionResolutionAttempted;
-    private regionResolutionPromise?;
-    /**
-     * Session operations.
-     */
-    readonly sessions: SessionsResource;
-    /**
-     * Persistent context operations.
-     */
-    readonly contexts: ContextsResource;
-    /**
-     * Browser extension operations.
-     */
-    readonly extensions: ExtensionsResource;
-    private readonly httpClient;
-    constructor(config?: LexmountConfig);
-    /**
-     * Internal POST request helper with timeout and network error mapping.
-     *
-     * @internal
-     */
-    _post<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
-    /**
-     * Internal GET request helper with timeout and network error mapping.
-     *
-     * @internal
-     */
-    _get<T = unknown>(url: string, params?: Record<string, unknown>, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+declare class CDPClient extends EventEmitter {
+    readonly session: SessionInfo;
+    private closed;
+    private rawClient?;
+    constructor(session: SessionInfo);
     /**
-     * Internal DELETE request helper with timeout and network error mapping.
-     *
-     * @internal
+     * Connect the CDP client to the session.
      */
-    _delete<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
-    regionInfo(): Promise<RegionInfo>;
-    catalogInfo(): Promise<CatalogInfo>;
+    connect(): Promise<this>;
     /**
-     * Close the client.
+     * Send a raw Chrome DevTools Protocol command.
      *
-     * Axios does not require explicit teardown, but the method is kept for API symmetry.
+     * Returns `undefined` if called before the client has connected.
      */
-    close(): void;
+    send(method: string, params?: any, sessionId?: string): Promise<any | undefined>;
     /**
-     * String representation of the client.
+     * Close the CDP connection and release internal listeners.
      */
-    toString(): string;
-    private request;
-    private normalizeRequestError;
-    private getDefaultHeaders;
-    private ensureRegionResolved;
-    private resolveRegion;
-    private selectCatalogRegion;
-    private probeRegionHost;
-    private isAllowedCatalogHost;
-    private rewriteUrl;
+    close(): Promise<void>;
 }
+/**
+ * Connect to a Lexmount browser session over Chrome DevTools Protocol.
+ */
+declare function connectOverCDP(session: SessionInfo): Promise<CDPClient>;
+
+/**
+ * Integrated authentication helpers.
+ */
+
+type IntegratedAuthCallbackResult = {
+    cancel: true;
+} | {
+    cancel: false;
+    scheme: string;
+    token: string;
+};
+type IntegratedAuthCallback = (params: any, callback: (result: IntegratedAuthCallbackResult) => Promise<void>) => void | Promise<void>;
+/**
+ * Register an integrated auth callback for a session.
+ */
+declare function registerIntegratedAuthCallback(sessionOrClient: SessionInfo | CDPClient, callback: IntegratedAuthCallback): Promise<void>;
+/**
+ * Deregister a previously registered integrated auth callback.
+ */
+declare function deregisterIntegratedAuthCallback(sessionOrClient: SessionInfo | CDPClient, callback: IntegratedAuthCallback): void;
 
 /**
  * Lexmount SDK error hierarchy.
@@ -772,6 +838,6 @@ declare class TimeoutError extends LexmountError {
 /**
  * Lexmount Node.js SDK.
  */
-declare const VERSION = "0.5.3";
+declare const VERSION = "0.5.5";
 
-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 };
+export { APIError, AuthenticationError, type BrowserMode, CDPClient, type CDPEventMessage, 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, type IntegratedAuthCallback, type IntegratedAuthCallbackResult, 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, connectOverCDP, Lexmount as default, deregisterIntegratedAuthCallback, disableLogging, enableLogging, getLogger, registerIntegratedAuthCallback, setLogLevel };