nstbrowser-ai-agent 0.0.1

package/dist/nstbrowser-client.js

@@ -0,0 +1,454 @@
+/**
+ * Nstbrowser API client
+ * Handles all communication with Nstbrowser API v2
+ */
+import { NstbrowserError, NstbrowserAuthError, handleNstbrowserError, } from './nstbrowser-errors.js';
+export class NstbrowserClient {
+    baseUrl;
+    apiKey;
+    constructor(host, port, apiKey) {
+        this.baseUrl = `http://${host}:${port}`;
+        this.apiKey = apiKey;
+        // Validate endpoint
+        this.validateEndpoint(host, port);
+        // Debug mode warning
+        if (process.env.NSTBROWSER_AI_AGENT_DEBUG === '1') {
+            console.error('[SECURITY] Debug mode enabled - API keys may be logged');
+        }
+    }
+    /**
+     * Validate endpoint configuration
+     */
+    validateEndpoint(host, port) {
+        if (!host || host.trim() === '') {
+            throw new Error('Invalid Nstbrowser host');
+        }
+        if (port < 1 || port > 65535) {
+            throw new Error('Invalid Nstbrowser port (must be 1-65535)');
+        }
+        // Prevent connecting to dangerous internal addresses
+        const dangerousHosts = ['0.0.0.0', '169.254.169.254'];
+        if (dangerousHosts.includes(host)) {
+            throw new Error(`Connecting to ${host} is not allowed for security reasons`);
+        }
+    }
+    /**
+     * Make HTTP request to Nstbrowser API
+     */
+    async request(method, endpoint, data, options) {
+        const timeout = options?.timeout || 30000;
+        const retries = options?.retries || 3;
+        const url = `${this.baseUrl}${endpoint}`;
+        let lastError = null;
+        for (let attempt = 0; attempt < retries; attempt++) {
+            try {
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), timeout);
+                this.logRequest(method, endpoint, data);
+                const response = await fetch(url, {
+                    method,
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'x-api-key': this.apiKey,
+                    },
+                    body: data ? JSON.stringify(data) : undefined,
+                    signal: controller.signal,
+                });
+                clearTimeout(timeoutId);
+                if (!response.ok) {
+                    if (response.status === 401) {
+                        throw new NstbrowserAuthError();
+                    }
+                    if (response.status === 404) {
+                        const errorText = await response.text().catch(() => 'No response body');
+                        if (process.env.NSTBROWSER_AI_AGENT_DEBUG === '1') {
+                            console.error('[DEBUG] 404 Error details:', {
+                                url,
+                                status: response.status,
+                                statusText: response.statusText,
+                                body: errorText,
+                            });
+                        }
+                        throw new NstbrowserError(`Resource not found: ${url}`, 'NST_NOT_FOUND', 404);
+                    }
+                    const errorData = (await response.json().catch(() => ({})));
+                    throw new NstbrowserError(errorData.message || `HTTP ${response.status}: ${response.statusText}`, errorData.code?.toString(), response.status);
+                }
+                const result = (await response.json());
+                // Nstbrowser API uses 'err: false' to indicate success
+                if (result.err) {
+                    throw new NstbrowserError(result.msg || 'Unknown error', result.code?.toString());
+                }
+                return result.data;
+            }
+            catch (error) {
+                if (error instanceof NstbrowserError) {
+                    throw error;
+                }
+                lastError = error instanceof Error ? error : new Error(String(error));
+                // If last attempt, throw error
+                if (attempt === retries - 1) {
+                    throw handleNstbrowserError(lastError);
+                }
+                // Wait before retry
+                await new Promise((resolve) => setTimeout(resolve, 1000 * (attempt + 1)));
+            }
+        }
+        throw lastError || new Error('Request failed');
+    }
+    /**
+     * Log request details in debug mode
+     */
+    logRequest(method, endpoint, data) {
+        if (process.env.NSTBROWSER_AI_AGENT_DEBUG !== '1')
+            return;
+        console.log(`[NST] ${method} ${this.baseUrl}${endpoint}`);
+        if (data) {
+            console.log(`[NST] Request body:`, JSON.stringify(data, null, 2));
+        }
+    }
+    // ==================== Browser Instance Management ====================
+    /**
+     * Get all running browser instances
+     */
+    async getBrowsers() {
+        const result = await this.request('GET', '/api/v2/browsers');
+        return result || [];
+    }
+    /**
+     * Start a browser instance for a profile
+     */
+    async startBrowser(profileId, options) {
+        // Note: Options are not supported by this endpoint
+        // Use startOnceBrowser for custom configuration
+        const response = await this.request('POST', `/api/v2/browsers/${profileId}`);
+        return {
+            profileId: response.profileId,
+            webSocketDebuggerUrl: response.webSocketDebuggerUrl,
+            remoteDebuggingPort: response.port,
+        };
+    }
+    /**
+     * Start a temporary browser (once browser)
+     */
+    async startOnceBrowser(config) {
+        return this.request('POST', '/api/v2/browsers/once', config);
+    }
+    /**
+     * Start multiple browsers in batch
+     */
+    async startBrowsersBatch(profileIds, options) {
+        return this.request('POST', '/api/v2/browsers/batch', {
+            profileIds,
+            ...options,
+        });
+    }
+    /**
+     * Stop a browser instance
+     */
+    async stopBrowser(profileId) {
+        await this.request('DELETE', `/api/v2/browsers/${profileId}`);
+    }
+    /**
+     * Stop all browser instances
+     * API Doc: https://apidocs.nstbrowser.io/api-15554896.md
+     * Note: Requires empty array as request body to stop all browsers
+     * Note: Endpoint requires trailing slash to avoid 307 redirect
+     */
+    async stopAllBrowsers() {
+        await this.request('DELETE', '/api/v2/browsers/', []);
+    }
+    /**
+     * Get all pages for a browser instance
+     */
+    async getBrowserPages(profileId) {
+        return this.request('GET', `/api/v2/browsers/${profileId}/pages`);
+    }
+    /**
+     * Get remote debugging address for a browser
+     */
+    async getBrowserDebugger(profileId) {
+        return this.request('GET', `/api/v2/browsers/${profileId}/debugger`);
+    }
+    // ==================== Profile Management ====================
+    /**
+     * Get profiles with optional query
+     * API Doc: https://apidocs.nstbrowser.io/api-15554903.md
+     */
+    async getProfiles(query) {
+        // Build query parameters for server-side filtering
+        const params = new URLSearchParams();
+        if (query) {
+            if (query.name) {
+                params.append('s', query.name); // 's' parameter searches by name or id
+            }
+            if (query.groupId) {
+                params.append('groupId', query.groupId);
+            }
+            if (query.tags) {
+                const tagsStr = Array.isArray(query.tags) ? query.tags.join(',') : query.tags;
+                params.append('tags', tagsStr);
+            }
+            // Note: platform filtering is not supported by the API query parameters
+            // We'll apply it client-side if needed
+        }
+        const queryString = params.toString();
+        const endpoint = queryString ? `/api/v2/profiles?${queryString}` : '/api/v2/profiles';
+        const response = await this.request('GET', endpoint);
+        let profiles = response.docs || [];
+        // Apply client-side platform filtering if needed (API doesn't support this parameter)
+        if (query?.platform) {
+            const platformMap = { Windows: 0, macOS: 1, Linux: 2 };
+            const platformNum = platformMap[query.platform];
+            if (platformNum !== undefined) {
+                profiles = profiles.filter((p) => p.platform === platformNum);
+            }
+        }
+        return profiles;
+    }
+    /**
+     * Get profiles with cursor-based pagination
+     * API Doc: https://apidocs.nstbrowser.io/api-19974738.md
+     * Note: Requires Nstbrowser 1.17.3+
+     */
+    async getProfilesByCursor(cursor, pageSize, direction) {
+        // Build query parameters
+        const params = new URLSearchParams();
+        if (pageSize) {
+            params.append('pageSize', pageSize.toString());
+        }
+        if (cursor) {
+            params.append('cursor', cursor);
+        }
+        if (direction) {
+            params.append('direction', direction);
+        }
+        const queryString = params.toString();
+        const endpoint = queryString
+            ? `/api/v2/profiles/cursor?${queryString}`
+            : '/api/v2/profiles/cursor';
+        return this.request('GET', endpoint);
+    }
+    /**
+     * Create a new profile
+     */
+    async createProfile(config) {
+        const response = await this.request('POST', '/api/v2/profiles', config);
+        // Debug log in debug mode
+        if (process.env.NSTBROWSER_AI_AGENT_DEBUG === '1') {
+            console.error('[DEBUG] Create profile response:', JSON.stringify(response, null, 2));
+        }
+        return response;
+    }
+    /**
+     * Delete a profile
+     */
+    async deleteProfile(profileId) {
+        await this.request('DELETE', `/api/v2/profiles/${profileId}`);
+    }
+    /**
+     * Delete multiple profiles in batch
+     * API Doc: https://apidocs.nstbrowser.io/api-15554905.md
+     */
+    async deleteProfilesBatch(profileIds) {
+        // Note: API expects array directly as request body, not wrapped in object
+        await this.request('DELETE', '/api/v2/profiles', profileIds);
+    }
+    // ==================== Proxy Management ====================
+    /**
+     * Update profile proxy configuration
+     * API Doc: https://apidocs.nstbrowser.io/api-15554907.md
+     */
+    async updateProfileProxy(profileId, proxy) {
+        // Convert ProxyConfig to URL format expected by API
+        const proxyUrl = `${proxy.type}://${proxy.username && proxy.password ? `${proxy.username}:${proxy.password}@` : ''}${proxy.host}:${proxy.port}`;
+        await this.request('PUT', `/api/v2/profiles/${profileId}/proxy`, { url: proxyUrl });
+    }
+    /**
+     * Update proxy for multiple profiles in batch
+     * API Doc: https://apidocs.nstbrowser.io/api-15554909.md
+     */
+    async batchUpdateProxy(profileIds, proxy) {
+        // Convert ProxyConfig to URL format expected by API
+        const proxyUrl = `${proxy.type}://${proxy.username && proxy.password ? `${proxy.username}:${proxy.password}@` : ''}${proxy.host}:${proxy.port}`;
+        await this.request('PUT', '/api/v2/profiles/proxy/batch', {
+            profileIds,
+            proxyConfig: {
+                // Note: API expects 'proxyConfig', not 'proxy'
+                url: proxyUrl,
+            },
+        });
+    }
+    /**
+     * Reset profile proxy to local type
+     */
+    async resetProfileProxy(profileId) {
+        await this.request('DELETE', `/api/v2/profiles/${profileId}/proxy`);
+    }
+    /**
+     * Reset proxy for multiple profiles in batch
+     */
+    async batchResetProfileProxy(profileIds) {
+        await this.request('POST', '/api/v2/profiles/proxy/batch-reset', { profileIds });
+    }
+    // ==================== Tag Management ====================
+    /**
+     * Get all available tags
+     */
+    async getProfileTags() {
+        return this.request('GET', '/api/v2/profiles/tags');
+    }
+    /**
+     * Create tags for a profile
+     */
+    async createProfileTags(profileId, tags) {
+        // API expects array directly, not wrapped in object
+        await this.request('POST', `/api/v2/profiles/${profileId}/tags`, tags);
+    }
+    /**
+     * Create tags for multiple profiles in batch
+     */
+    async batchCreateProfileTags(profileIds, tags) {
+        await this.request('POST', '/api/v2/profiles/tags/batch', {
+            profileIds,
+            tags,
+        });
+    }
+    /**
+     * Update tags for a profile
+     */
+    async updateProfileTags(profileId, tags) {
+        await this.request('PUT', `/api/v2/profiles/${profileId}/tags`, { tags });
+    }
+    /**
+     * Update tags for multiple profiles in batch
+     */
+    async batchUpdateProfileTags(profileIds, tags) {
+        await this.request('PUT', '/api/v2/profiles/tags/batch', {
+            profileIds,
+            tags,
+        });
+    }
+    /**
+     * Clear tags for a profile
+     */
+    async clearProfileTags(profileId) {
+        await this.request('DELETE', `/api/v2/profiles/${profileId}/tags`);
+    }
+    /**
+     * Clear tags for multiple profiles in batch
+     */
+    async batchClearProfileTags(profileIds) {
+        await this.request('POST', '/api/v2/profiles/tags/batch-clear', { profileIds });
+    }
+    // ==================== Group Management ====================
+    /**
+     * Get all profile groups
+     */
+    async getAllProfileGroups() {
+        return this.request('GET', '/api/v2/profiles/groups');
+    }
+    /**
+     * Change profile group
+     */
+    async changeProfileGroup(profileId, groupId) {
+        await this.request('PUT', `/api/v2/profiles/${profileId}/group`, { groupId });
+    }
+    /**
+     * Change group for multiple profiles in batch
+     */
+    async batchChangeProfileGroup(profileIds, groupId) {
+        await this.request('PUT', '/api/v2/profiles/group/batch', {
+            profileIds,
+            groupId,
+        });
+    }
+    // ==================== Local Data Management ====================
+    /**
+     * Clear profile cache
+     */
+    async clearProfileCache(profileId) {
+        await this.request('DELETE', `/api/v2/profiles/${profileId}/cache`);
+    }
+    /**
+     * Clear profile cookies
+     */
+    async clearProfileCookies(profileId) {
+        await this.request('DELETE', `/api/v2/profiles/${profileId}/cookies`);
+    }
+    // ==================== CDP Endpoints ====================
+    /**
+     * Get CDP WebSocket URL for a profile browser
+     * Uses the correct CDP endpoint: GET /api/v2/connect/{profileId}
+     */
+    async getCdpUrl(profileId) {
+        const response = await this.request('GET', `/api/v2/connect/${profileId}`);
+        return {
+            webSocketDebuggerUrl: response.webSocketDebuggerUrl,
+        };
+    }
+    /**
+     * Get CDP WebSocket URL for once browser
+     * Uses the correct CDP endpoint: GET /api/v2/connect
+     */
+    async getCdpUrlOnce() {
+        const response = await this.request('GET', '/api/v2/connect');
+        return {
+            webSocketDebuggerUrl: response.webSocketDebuggerUrl,
+        };
+    }
+    /**
+     * Connect to a browser (start and get CDP URL)
+     */
+    async connectBrowser(profileId) {
+        const response = await this.request('POST', `/api/v2/browsers/${profileId}`);
+        return {
+            profileId: response.profileId,
+            webSocketDebuggerUrl: response.webSocketDebuggerUrl,
+            remoteDebuggingPort: response.port,
+        };
+    }
+    /**
+     * Connect to a temporary browser (once browser)
+     */
+    async connectOnceBrowser(config) {
+        const response = await this.request('POST', '/api/v2/browsers/once', config);
+        return {
+            profileId: response.profileId,
+            webSocketDebuggerUrl: response.webSocketDebuggerUrl,
+            remoteDebuggingPort: response.port,
+        };
+    }
+    // ==================== Method Aliases for Convenience ====================
+    /**
+     * Alias for getProfiles()
+     */
+    async listProfiles(query) {
+        return this.getProfiles(query);
+    }
+    /**
+     * Alias for deleteProfilesBatch()
+     */
+    async deleteProfiles(profileIds) {
+        return this.deleteProfilesBatch(profileIds);
+    }
+    /**
+     * Alias for getBrowsers()
+     */
+    async listBrowsers() {
+        return this.getBrowsers();
+    }
+    /**
+     * Alias for getProfileTags()
+     */
+    async listTags() {
+        return this.getProfileTags();
+    }
+    /**
+     * Alias for getAllProfileGroups()
+     */
+    async listGroups() {
+        return this.getAllProfileGroups();
+    }
+}
+//# sourceMappingURL=nstbrowser-client.js.map

package/dist/nstbrowser-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nstbrowser-client.js","sourceRoot":"","sources":["../src/nstbrowser-client.ts"],"names":[],"mappings":"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"}

package/dist/nstbrowser-errors.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Nstbrowser integration error classes
+ */
+export declare class NstbrowserError extends Error {
+    code?: string | undefined;
+    statusCode?: number | undefined;
+    constructor(message: string, code?: string | undefined, statusCode?: number | undefined);
+}
+export declare class NstbrowserNotInstalledError extends NstbrowserError {
+    constructor();
+}
+export declare class NstbrowserNotRunningError extends NstbrowserError {
+    constructor();
+}
+export declare class NstbrowserAuthError extends NstbrowserError {
+    constructor();
+}
+export declare class NstbrowserProfileNotFoundError extends NstbrowserError {
+    constructor(profileName: string);
+}
+export declare class NstbrowserConnectionError extends NstbrowserError {
+    constructor(message: string);
+}
+/**
+ * Convert Nstbrowser API errors to user-friendly error messages
+ */
+export declare function handleNstbrowserError(error: unknown): Error;
+//# sourceMappingURL=nstbrowser-errors.d.ts.map

package/dist/nstbrowser-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nstbrowser-errors.d.ts","sourceRoot":"","sources":["../src/nstbrowser-errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,eAAgB,SAAQ,KAAK;IAG/B,IAAI,CAAC,EAAE,MAAM;IACb,UAAU,CAAC,EAAE,MAAM;gBAF1B,OAAO,EAAE,MAAM,EACR,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,UAAU,CAAC,EAAE,MAAM,YAAA;CAK7B;AAED,qBAAa,2BAA4B,SAAQ,eAAe;;CAI/D;AAED,qBAAa,yBAA0B,SAAQ,eAAe;;CAI7D;AAED,qBAAa,mBAAoB,SAAQ,eAAe;;CAIvD;AAED,qBAAa,8BAA+B,SAAQ,eAAe;gBACrD,WAAW,EAAE,MAAM;CAGhC;AAED,qBAAa,yBAA0B,SAAQ,eAAe;gBAChD,OAAO,EAAE,MAAM;CAG5B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAoB3D"}

package/dist/nstbrowser-errors.js

@@ -0,0 +1,59 @@
+/**
+ * Nstbrowser integration error classes
+ */
+export class NstbrowserError extends Error {
+    code;
+    statusCode;
+    constructor(message, code, statusCode) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.name = 'NstbrowserError';
+    }
+}
+export class NstbrowserNotInstalledError extends NstbrowserError {
+    constructor() {
+        super('Nstbrowser client is not installed', 'NST_NOT_INSTALLED');
+    }
+}
+export class NstbrowserNotRunningError extends NstbrowserError {
+    constructor() {
+        super('Nstbrowser client is not running', 'NST_NOT_RUNNING');
+    }
+}
+export class NstbrowserAuthError extends NstbrowserError {
+    constructor() {
+        super('Invalid Nstbrowser API key', 'NST_AUTH_ERROR', 401);
+    }
+}
+export class NstbrowserProfileNotFoundError extends NstbrowserError {
+    constructor(profileName) {
+        super(`Profile "${profileName}" not found`, 'NST_PROFILE_NOT_FOUND', 404);
+    }
+}
+export class NstbrowserConnectionError extends NstbrowserError {
+    constructor(message) {
+        super(`Failed to connect to Nstbrowser: ${message}`, 'NST_CONNECTION_ERROR');
+    }
+}
+/**
+ * Convert Nstbrowser API errors to user-friendly error messages
+ */
+export function handleNstbrowserError(error) {
+    if (error instanceof NstbrowserError) {
+        return error;
+    }
+    if (error instanceof Error) {
+        // Check for network errors
+        if (error.message.includes('ECONNREFUSED')) {
+            return new NstbrowserNotRunningError();
+        }
+        // Check for authentication errors
+        if (error.message.includes('401') || error.message.includes('Unauthorized')) {
+            return new NstbrowserAuthError();
+        }
+        return new NstbrowserError(error.message);
+    }
+    return new NstbrowserError(String(error));
+}
+//# sourceMappingURL=nstbrowser-errors.js.map

package/dist/nstbrowser-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nstbrowser-errors.js","sourceRoot":"","sources":["../src/nstbrowser-errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAG/B;IACA;IAHT,YACE,OAAe,EACR,IAAa,EACb,UAAmB;QAE1B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAS;QACb,eAAU,GAAV,UAAU,CAAS;QAG1B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,2BAA4B,SAAQ,eAAe;IAC9D;QACE,KAAK,CAAC,oCAAoC,EAAE,mBAAmB,CAAC,CAAC;IACnE,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,eAAe;IAC5D;QACE,KAAK,CAAC,kCAAkC,EAAE,iBAAiB,CAAC,CAAC;IAC/D,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IACtD;QACE,KAAK,CAAC,4BAA4B,EAAE,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAC7D,CAAC;CACF;AAED,MAAM,OAAO,8BAA+B,SAAQ,eAAe;IACjE,YAAY,WAAmB;QAC7B,KAAK,CAAC,YAAY,WAAW,aAAa,EAAE,uBAAuB,EAAE,GAAG,CAAC,CAAC;IAC5E,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,eAAe;IAC5D,YAAY,OAAe;QACzB,KAAK,CAAC,oCAAoC,OAAO,EAAE,EAAE,sBAAsB,CAAC,CAAC;IAC/E,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,2BAA2B;QAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;YAC3C,OAAO,IAAI,yBAAyB,EAAE,CAAC;QACzC,CAAC;QAED,kCAAkC;QAClC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;YAC5E,OAAO,IAAI,mBAAmB,EAAE,CAAC;QACnC,CAAC;QAED,OAAO,IAAI,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,IAAI,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/dist/nstbrowser-profile-resolver.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Unified profile resolution logic for Nstbrowser
+ *
+ * This module provides a consistent way to resolve profile names or IDs
+ * across all browser-related commands.
+ *
+ * Resolution Priority:
+ * 1. Explicit profileId parameter
+ * 2. Explicit profileName parameter
+ * 3. NST_PROFILE_ID environment variable
+ * 4. NST_PROFILE environment variable
+ * 5. No profile (use once/temporary browser)
+ *
+ * Name Resolution Logic:
+ * When a profile name is provided:
+ * 1. Check running browsers for matching name (use earliest if multiple)
+ * 2. If not running, query profile API for matching name
+ * 3. If found, use the first matching profile
+ * 4. If not found, throw error
+ */
+import type { NstbrowserClient } from './nstbrowser-client.js';
+/**
+ * Check if a string is a valid UUID (case-insensitive)
+ *
+ * @param input - String to check
+ * @returns true if input is a valid UUID, false otherwise
+ */
+export declare function isUuid(input: string): boolean;
+export interface ProfileResolutionOptions {
+    /** Explicit profile ID (highest priority) */
+    profileId?: string;
+    /** Explicit profile name */
+    profileName?: string;
+    /** Whether to allow once/temporary browser (default: true) */
+    allowOnce?: boolean;
+    /** Whether to auto-start browser if not running (default: true) */
+    autoStart?: boolean;
+}
+export interface ResolvedProfile {
+    /** Resolved profile ID (undefined for once browser) */
+    profileId?: string;
+    /** Profile name (if resolved from name) */
+    profileName?: string;
+    /** Whether browser is already running */
+    isRunning: boolean;
+    /** Whether this is a once/temporary browser */
+    isOnce: boolean;
+    /** CDP WebSocket URL */
+    wsUrl?: string;
+}
+/**
+ * Resolve profile from name or ID
+ *
+ * @param client - Nstbrowser API client
+ * @param options - Resolution options
+ * @returns Resolved profile information
+ * @throws Error if profile not found or invalid
+ */
+export declare function resolveProfile(client: NstbrowserClient, options?: ProfileResolutionOptions): Promise<ResolvedProfile>;
+/**
+ * Ensure browser is running for the resolved profile
+ *
+ * @param client - Nstbrowser API client
+ * @param resolved - Resolved profile information
+ * @returns Updated profile information with wsUrl
+ */
+export declare function ensureBrowserRunning(client: NstbrowserClient, resolved: ResolvedProfile, nstHost: string, nstPort: number, nstApiKey: string): Promise<ResolvedProfile>;
+/**
+ * Get profile ID from name or ID (without starting browser)
+ *
+ * This is useful for commands that need profile ID but don't need to start browser
+ * (e.g., profile delete, profile update, etc.)
+ *
+ * @param client - Nstbrowser API client
+ * @param nameOrId - Profile name or ID
+ * @returns Profile ID
+ * @throws Error if profile not found
+ */
+export declare function getProfileId(client: NstbrowserClient, nameOrId: string): Promise<string>;
+/**
+ * Get multiple profile IDs from names or IDs
+ *
+ * @param client - Nstbrowser API client
+ * @param namesOrIds - Array of profile names or IDs
+ * @returns Array of profile IDs
+ * @throws Error if any profile not found
+ */
+export declare function getProfileIds(client: NstbrowserClient, namesOrIds: string[]): Promise<string[]>;
+//# sourceMappingURL=nstbrowser-profile-resolver.d.ts.map

package/dist/nstbrowser-profile-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nstbrowser-profile-resolver.d.ts","sourceRoot":"","sources":["../src/nstbrowser-profile-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAG7C;AAED,MAAM,WAAW,wBAAwB;IACvC,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mEAAmE;IACnE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,+CAA+C;IAC/C,MAAM,EAAE,OAAO,CAAC;IAChB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,eAAe,CAAC,CA6G1B;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC,CA0D1B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiC9F;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CASnB"}