lexmount 0.2.0 → 0.2.3

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AxiosResponse } from 'axios';
+import { AxiosRequestConfig, AxiosResponse } from 'axios';
 
 /**
  * Supported SDK log levels.
@@ -67,6 +67,27 @@ interface SessionContext {
      */
     mode: ContextAccessMode;
 }
+/**
+ * Upstream proxy configuration for a session.
+ */
+interface SessionProxyConfig {
+    /**
+     * Proxy type. Currently `external` is supported by the API.
+     */
+    type?: 'external' | string;
+    /**
+     * Upstream proxy server URL.
+     */
+    server: string;
+    /**
+     * Optional upstream proxy username.
+     */
+    username?: string;
+    /**
+     * Optional upstream proxy password.
+     */
+    password?: string;
+}
 /**
  * SDK client configuration.
  */
@@ -112,6 +133,14 @@ interface SessionCreateOptions {
      * Optional persistent context configuration.
      */
     context?: SessionContext;
+    /**
+     * Optional uploaded browser extension identifiers to mount.
+     */
+    extensionIds?: string[];
+    /**
+     * Optional upstream proxy configuration.
+     */
+    proxy?: SessionProxyConfig;
 }
 /**
  * Session list options.
@@ -174,6 +203,72 @@ interface ForceReleaseResponse {
     status: string;
     message: string;
 }
+/**
+ * Extension metadata returned by the API.
+ */
+interface ExtensionInfoShape {
+    id: string;
+    name: string;
+    projectId: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+/**
+ * Extension upload options.
+ */
+interface ExtensionUploadOptions {
+    /**
+     * Optional display name for the uploaded extension.
+     */
+    name?: string;
+    /**
+     * Override the default project identifier.
+     */
+    projectId?: string;
+}
+/**
+ * Extension list options.
+ */
+interface ExtensionListOptions {
+    /**
+     * Override the default project identifier.
+     */
+    projectId?: string;
+    /**
+     * Maximum number of extensions to return.
+     */
+    limit?: number;
+    /**
+     * Number of extensions to skip.
+     */
+    offset?: number;
+}
+/**
+ * Session download metadata returned by the API.
+ */
+interface SessionDownloadInfoShape {
+    id: string;
+    filename: string;
+    contentType: string | null;
+    size: number;
+    sha256: string | null;
+    status: string;
+    createdAt: string;
+}
+/**
+ * Structured response from session download listing.
+ */
+interface SessionDownloadsListResponseShape {
+    count: number;
+    totalSize: number;
+}
+/**
+ * Structured response from session download deletion.
+ */
+interface SessionDownloadsDeleteResponseShape {
+    status: string;
+    deletedCount: number;
+}
 /**
  * Session pagination metadata.
  */
@@ -250,6 +345,35 @@ declare class ContextsResource {
     private handleError;
 }
 
+/**
+ * Extension resource implementation.
+ */
+
+/**
+ * Extension metadata returned by the API.
+ */
+declare class ExtensionInfo implements ExtensionInfoShape {
+    readonly id: string;
+    readonly name: string;
+    readonly projectId: string;
+    readonly createdAt?: string;
+    readonly updatedAt?: string;
+    constructor(shape: ExtensionInfoShape);
+}
+/**
+ * Browser extension resource operations.
+ */
+declare class ExtensionsResource {
+    private readonly client;
+    constructor(client: Lexmount);
+    upload(filePath: string, options?: ExtensionUploadOptions): Promise<ExtensionInfo>;
+    list(options?: ExtensionListOptions): Promise<ExtensionInfo[]>;
+    get(extensionId: string, projectId?: string): Promise<ExtensionInfo>;
+    delete(extensionId: string): Promise<void>;
+    private parseInfo;
+    private handleError;
+}
+
 /**
  * Session resource implementation.
  */
@@ -327,6 +451,47 @@ declare class SessionListResponse implements Iterable<SessionInfo> {
     [Symbol.iterator](): Iterator<SessionInfo>;
     at(index: number): SessionInfo | undefined;
 }
+/**
+ * Session download metadata returned by the API.
+ */
+declare class SessionDownloadInfo implements SessionDownloadInfoShape {
+    readonly id: string;
+    readonly filename: string;
+    readonly contentType: string | null;
+    readonly size: number;
+    readonly sha256: string | null;
+    readonly status: string;
+    readonly createdAt: string;
+    constructor(shape: SessionDownloadInfoShape);
+}
+/**
+ * Structured response from `sessions.downloads.list()`.
+ */
+declare class SessionDownloadsListResponse {
+    readonly downloads: SessionDownloadInfo[];
+    readonly summary: SessionDownloadsListResponseShape;
+    constructor(downloads: SessionDownloadInfo[], summary: SessionDownloadsListResponseShape);
+}
+/**
+ * Structured response from `sessions.downloads.delete()`.
+ */
+declare class SessionDownloadsDeleteResponse implements SessionDownloadsDeleteResponseShape {
+    readonly status: string;
+    readonly deletedCount: number;
+    constructor(shape: SessionDownloadsDeleteResponseShape);
+}
+/**
+ * Session download operations.
+ */
+declare class SessionDownloadsResource {
+    private readonly client;
+    constructor(client: Lexmount);
+    list(sessionId: string, projectId?: string): Promise<SessionDownloadsListResponse>;
+    get(sessionId: string, downloadId: string, projectId?: string): Promise<Buffer>;
+    archive(sessionId: string, projectId?: string): Promise<Buffer>;
+    delete(sessionId: string, projectId?: string): Promise<SessionDownloadsDeleteResponse>;
+    private handleError;
+}
 /**
  * Alias kept for parity with the Python SDK.
  */
@@ -336,6 +501,7 @@ type SessionCreateResponse = SessionInfo;
  */
 declare class SessionsResource {
     private readonly client;
+    readonly downloads: SessionDownloadsResource;
     constructor(client: Lexmount);
     /**
      * Create a new browser session.
@@ -355,6 +521,7 @@ declare class SessionsResource {
      * @internal
      */
     _getWebSocketDebuggerUrl(sessionId: string): Promise<string | null>;
+    private normalizeProxy;
     private handleCreateError;
     private handleListError;
     private handleDeleteError;
@@ -388,6 +555,10 @@ declare class Lexmount {
      * Persistent context operations.
      */
     readonly contexts: ContextsResource;
+    /**
+     * Browser extension operations.
+     */
+    readonly extensions: ExtensionsResource;
     private readonly httpClient;
     constructor(config?: LexmountConfig);
     /**
@@ -395,19 +566,19 @@ declare class Lexmount {
      *
      * @internal
      */
-    _post<T = unknown>(url: string, data: Record<string, unknown>): Promise<AxiosResponse<T>>;
+    _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>): Promise<AxiosResponse<T>>;
+    _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: Record<string, unknown>): Promise<AxiosResponse<T>>;
+    _delete<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
     /**
      * Close the client.
      *
@@ -420,6 +591,7 @@ declare class Lexmount {
     toString(): string;
     private request;
     private normalizeRequestError;
+    private getDefaultHeaders;
 }
 
 /**
@@ -489,4 +661,4 @@ declare class TimeoutError extends LexmountError {
  */
 declare const VERSION = "0.2.0";
 
-export { APIError, AuthenticationError, type BrowserMode, type ContextAccessMode, type ContextCreateOptions, ContextInfo, type ContextListOptions, ContextListResponse, ContextLockedError, type ContextMetadata, ContextNotFoundError, type ContextStatus, ContextsResource, type ForceReleaseResponse, Lexmount, type LexmountConfig, LexmountError, LexmountLogger, type LogLevel, NetworkError, PaginationInfo, type PaginationInfoShape, type SessionContext, type SessionCreateOptions, type SessionCreateResponse, type SessionDeleteOptions, SessionInfo, type SessionListOptions, SessionListResponse, SessionNotFoundError, type SessionStatus, SessionsResource, TimeoutError, VERSION, ValidationError, Lexmount as default, disableLogging, enableLogging, getLogger, setLogLevel };
+export { APIError, AuthenticationError, type BrowserMode, 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 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, SessionsResource, TimeoutError, VERSION, ValidationError, Lexmount as default, disableLogging, enableLogging, getLogger, setLogLevel };