@things-factory/shell 9.0.25 → 9.0.34

package/dist-server/utils/headless-pool/browser-factory.d.ts

@@ -0,0 +1,27 @@
+import { HeadlessPoolConfig } from './config';
+/**
+ * Browser Factory for creating and managing browser instances
+ */
+export declare class BrowserFactory {
+    /**
+     * Create a new browser instance
+     */
+    static createBrowser(poolConfig: HeadlessPoolConfig): Promise<any>;
+    /**
+     * Validate browser instance
+     */
+    static validateBrowser(browser: any): Promise<boolean>;
+    /**
+     * Safely destroy browser instance with multiple cleanup strategies
+     */
+    static destroyBrowser(browser: any): Promise<void>;
+    private static gracefulDestroy;
+    /**
+     * Create browser with custom setup (for special cases like label pool)
+     */
+    static createBrowserWithSetup(poolConfig: HeadlessPoolConfig, customSetup: (browser: any) => Promise<any>): Promise<any>;
+    private static getLaunchSettings;
+    private static closeAllPages;
+    private static killBrowserProcess;
+    private static forceKillProcess;
+}

package/dist-server/utils/headless-pool/browser-factory.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserFactory = void 0;
+const env_1 = require("@things-factory/env");
+// Dynamic puppeteer loading with error handling
+let puppeteer;
+try {
+    puppeteer = require('puppeteer');
+}
+catch (err) {
+    env_1.logger.warn('Puppeteer not available:', err);
+}
+/**
+ * Browser Factory for creating and managing browser instances
+ */
+class BrowserFactory {
+    /**
+     * Create a new browser instance
+     */
+    static async createBrowser(poolConfig) {
+        if (!puppeteer) {
+            throw new Error('Puppeteer is not available');
+        }
+        const launchSettings = this.getLaunchSettings(poolConfig);
+        try {
+            const browser = await puppeteer.launch(launchSettings);
+            env_1.logger.info(`Browser instance created with headless: ${launchSettings.headless}`);
+            return browser;
+        }
+        catch (error) {
+            env_1.logger.error('Failed to create browser instance:', error);
+            throw error;
+        }
+    }
+    /**
+     * Validate browser instance
+     */
+    static validateBrowser(browser) {
+        return Promise.race([
+            new Promise(resolve => setTimeout(() => resolve(false), 1500)),
+            browser
+                .version()
+                .then(() => true)
+                .catch(() => false)
+        ]);
+    }
+    /**
+     * Safely destroy browser instance with multiple cleanup strategies
+     */
+    static async destroyBrowser(browser) {
+        const timeout = 5000; // 5 second timeout
+        try {
+            await Promise.race([
+                this.gracefulDestroy(browser),
+                new Promise((_, reject) => setTimeout(() => reject(new Error('Browser destruction timeout')), timeout))
+            ]);
+            env_1.logger.info('🗑️ Browser instance destroyed successfully');
+        }
+        catch (error) {
+            env_1.logger.warn('⚠️ Error destroying browser instance:', error);
+            // Force kill as last resort
+            await this.forceKillProcess(browser);
+        }
+    }
+    static async gracefulDestroy(browser) {
+        // Step 1: Close all pages
+        await this.closeAllPages(browser);
+        // Step 2: Standard close
+        await browser.close();
+        // Step 3: Kill browser process if still running
+        await this.killBrowserProcess(browser);
+    }
+    /**
+     * Create browser with custom setup (for special cases like label pool)
+     */
+    static async createBrowserWithSetup(poolConfig, customSetup) {
+        const browser = await this.createBrowser(poolConfig);
+        try {
+            const result = await customSetup(browser);
+            return result;
+        }
+        catch (error) {
+            // If setup fails, cleanup the browser
+            await this.destroyBrowser(browser);
+            throw error;
+        }
+    }
+    static getLaunchSettings(poolConfig) {
+        const settings = {
+            headless: poolConfig.headless || 'shell',
+            args: [...(poolConfig.args || [])],
+            handleSIGINT: false, // ★ 기본 핸들러 해제
+            handleSIGTERM: false,
+            handleSIGHUP: false
+        };
+        // Add executable path if specified in config or environment
+        const executablePath = poolConfig.executablePath || env_1.config.get('CHROMIUM_PATH');
+        if (executablePath) {
+            settings.executablePath = executablePath;
+        }
+        return settings;
+    }
+    static async closeAllPages(browser) {
+        try {
+            const pages = await browser.pages();
+            await Promise.all(pages.map((page) => page.close().catch(() => { })));
+        }
+        catch (error) {
+            env_1.logger.warn('Failed to close pages:', error);
+        }
+    }
+    static async killBrowserProcess(browser) {
+        try {
+            const process = browser.process();
+            if (process && !process.killed) {
+                // Try graceful termination first
+                process.kill('SIGTERM');
+                // Wait a bit, then force kill if still alive
+                await new Promise(resolve => setTimeout(resolve, 1000));
+                if (!process.killed) {
+                    process.kill('SIGKILL');
+                    env_1.logger.info('🔪 Browser process force killed');
+                }
+            }
+        }
+        catch (error) {
+            env_1.logger.warn('Failed to kill browser process:', error);
+        }
+    }
+    static async forceKillProcess(browser) {
+        try {
+            const process = browser.process();
+            if (process && !process.killed) {
+                process.kill('SIGKILL');
+                env_1.logger.info('💀 Browser process force killed');
+            }
+        }
+        catch (killError) {
+            env_1.logger.error('💀 Failed to force kill browser process:', killError);
+        }
+    }
+}
+exports.BrowserFactory = BrowserFactory;
+//# sourceMappingURL=browser-factory.js.map

package/dist-server/utils/headless-pool/browser-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-factory.js","sourceRoot":"","sources":["../../../server/utils/headless-pool/browser-factory.ts"],"names":[],"mappings":";;;AAAA,6CAAoD;AAGpD,gDAAgD;AAChD,IAAI,SAAc,CAAA;AAClB,IAAI,CAAC;IACH,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;AAClC,CAAC;AAAC,OAAO,GAAG,EAAE,CAAC;IACb,YAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,GAAG,CAAC,CAAA;AAC9C,CAAC;AAED;;GAEG;AACH,MAAa,cAAc;IACzB;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,UAA8B;QACvD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;QAC/C,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAA;QAEzD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;YACtD,YAAM,CAAC,IAAI,CAAC,2CAA2C,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAA;YACjF,OAAO,OAAO,CAAA;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAA;YACzD,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,OAAY;QACjC,OAAO,OAAO,CAAC,IAAI,CAAC;YAClB,IAAI,OAAO,CAAU,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;YACvE,OAAO;iBACJ,OAAO,EAAE;iBACT,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;iBAChB,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC;SACtB,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,OAAY;QACtC,MAAM,OAAO,GAAG,IAAI,CAAA,CAAC,mBAAmB;QAExC,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,CAAC;gBACjB,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;gBAC7B,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;aACxG,CAAC,CAAA;YAEF,YAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAA;QAC5D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAM,CAAC,IAAI,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAA;YAE3D,4BAA4B;YAC5B,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAA;QACtC,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,OAAY;QAC/C,0BAA0B;QAC1B,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;QAEjC,yBAAyB;QACzB,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;QAErB,gDAAgD;QAChD,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAA;IACxC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,sBAAsB,CACjC,UAA8B,EAC9B,WAA2C;QAE3C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAA;QAEpD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAA;YACzC,OAAO,MAAM,CAAA;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,sCAAsC;YACtC,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;YAClC,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,iBAAiB,CAAC,UAA8B;QAC7D,MAAM,QAAQ,GAAQ;YACpB,QAAQ,EAAE,UAAU,CAAC,QAAQ,IAAI,OAAO;YACxC,IAAI,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YAClC,YAAY,EAAE,KAAK,EAAE,cAAc;YACnC,aAAa,EAAE,KAAK;YACpB,YAAY,EAAE,KAAK;SACpB,CAAA;QAED,4DAA4D;QAC5D,MAAM,cAAc,GAAG,UAAU,CAAC,cAAc,IAAI,YAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;QAC/E,IAAI,cAAc,EAAE,CAAC;YACnB,QAAQ,CAAC,cAAc,GAAG,cAAc,CAAA;QAC1C,CAAC;QAED,OAAO,QAAQ,CAAA;IACjB,CAAC;IAEO,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,OAAY;QAC7C,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;YACnC,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QAC3E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAA;QAC9C,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,OAAY;QAClD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAA;YACjC,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBAC/B,iCAAiC;gBACjC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;gBAEvB,6CAA6C;gBAC7C,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAA;gBAEvD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;oBACpB,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;oBACvB,YAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAA;gBAChD,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAA;QACvD,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,OAAY;QAChD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAA;YACjC,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBAC/B,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;gBACvB,YAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAA;YAChD,CAAC;QACH,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YACnB,YAAM,CAAC,KAAK,CAAC,0CAA0C,EAAE,SAAS,CAAC,CAAA;QACrE,CAAC;IACH,CAAC;CACF;AA/ID,wCA+IC","sourcesContent":["import { config, logger } from '@things-factory/env'\nimport { HeadlessPoolConfig } from './config'\n\n// Dynamic puppeteer loading with error handling\nlet puppeteer: any\ntry {\n  puppeteer = require('puppeteer')\n} catch (err) {\n  logger.warn('Puppeteer not available:', err)\n}\n\n/**\n * Browser Factory for creating and managing browser instances\n */\nexport class BrowserFactory {\n  /**\n   * Create a new browser instance\n   */\n  static async createBrowser(poolConfig: HeadlessPoolConfig): Promise<any> {\n    if (!puppeteer) {\n      throw new Error('Puppeteer is not available')\n    }\n\n    const launchSettings = this.getLaunchSettings(poolConfig)\n\n    try {\n      const browser = await puppeteer.launch(launchSettings)\n      logger.info(`Browser instance created with headless: ${launchSettings.headless}`)\n      return browser\n    } catch (error) {\n      logger.error('Failed to create browser instance:', error)\n      throw error\n    }\n  }\n\n  /**\n   * Validate browser instance\n   */\n  static validateBrowser(browser: any): Promise<boolean> {\n    return Promise.race([\n      new Promise<boolean>(resolve => setTimeout(() => resolve(false), 1500)),\n      browser\n        .version()\n        .then(() => true)\n        .catch(() => false)\n    ])\n  }\n\n  /**\n   * Safely destroy browser instance with multiple cleanup strategies\n   */\n  static async destroyBrowser(browser: any): Promise<void> {\n    const timeout = 5000 // 5 second timeout\n\n    try {\n      await Promise.race([\n        this.gracefulDestroy(browser),\n        new Promise((_, reject) => setTimeout(() => reject(new Error('Browser destruction timeout')), timeout))\n      ])\n\n      logger.info('🗑️ Browser instance destroyed successfully')\n    } catch (error) {\n      logger.warn('⚠️ Error destroying browser instance:', error)\n\n      // Force kill as last resort\n      await this.forceKillProcess(browser)\n    }\n  }\n\n  private static async gracefulDestroy(browser: any): Promise<void> {\n    // Step 1: Close all pages\n    await this.closeAllPages(browser)\n\n    // Step 2: Standard close\n    await browser.close()\n\n    // Step 3: Kill browser process if still running\n    await this.killBrowserProcess(browser)\n  }\n\n  /**\n   * Create browser with custom setup (for special cases like label pool)\n   */\n  static async createBrowserWithSetup(\n    poolConfig: HeadlessPoolConfig,\n    customSetup: (browser: any) => Promise<any>\n  ): Promise<any> {\n    const browser = await this.createBrowser(poolConfig)\n\n    try {\n      const result = await customSetup(browser)\n      return result\n    } catch (error) {\n      // If setup fails, cleanup the browser\n      await this.destroyBrowser(browser)\n      throw error\n    }\n  }\n\n  private static getLaunchSettings(poolConfig: HeadlessPoolConfig) {\n    const settings: any = {\n      headless: poolConfig.headless || 'shell',\n      args: [...(poolConfig.args || [])],\n      handleSIGINT: false, // ★ 기본 핸들러 해제\n      handleSIGTERM: false,\n      handleSIGHUP: false\n    }\n\n    // Add executable path if specified in config or environment\n    const executablePath = poolConfig.executablePath || config.get('CHROMIUM_PATH')\n    if (executablePath) {\n      settings.executablePath = executablePath\n    }\n\n    return settings\n  }\n\n  private static async closeAllPages(browser: any): Promise<void> {\n    try {\n      const pages = await browser.pages()\n      await Promise.all(pages.map((page: any) => page.close().catch(() => {})))\n    } catch (error) {\n      logger.warn('Failed to close pages:', error)\n    }\n  }\n\n  private static async killBrowserProcess(browser: any): Promise<void> {\n    try {\n      const process = browser.process()\n      if (process && !process.killed) {\n        // Try graceful termination first\n        process.kill('SIGTERM')\n\n        // Wait a bit, then force kill if still alive\n        await new Promise(resolve => setTimeout(resolve, 1000))\n\n        if (!process.killed) {\n          process.kill('SIGKILL')\n          logger.info('🔪 Browser process force killed')\n        }\n      }\n    } catch (error) {\n      logger.warn('Failed to kill browser process:', error)\n    }\n  }\n\n  private static async forceKillProcess(browser: any): Promise<void> {\n    try {\n      const process = browser.process()\n      if (process && !process.killed) {\n        process.kill('SIGKILL')\n        logger.info('💀 Browser process force killed')\n      }\n    } catch (killError) {\n      logger.error('💀 Failed to force kill browser process:', killError)\n    }\n  }\n}\n"]}

package/dist-server/utils/headless-pool/config.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Headless Pool Configuration
+ */
+export type HeadlessMode = 'shell' | 'new' | boolean;
+export interface HeadlessPoolConfig {
+    min?: number;
+    max?: number;
+    acquireTimeoutMillis?: number;
+    idleTimeoutMillis?: number;
+    testOnBorrow?: boolean;
+    headless?: HeadlessMode;
+    args?: string[];
+    executablePath?: string;
+    enableStats?: boolean;
+    enableRecovery?: boolean;
+    enableCleanup?: boolean;
+    customSetup?: (browser: any) => Promise<any>;
+}
+export declare const DEFAULT_POOL_CONFIG: Required<Omit<HeadlessPoolConfig, 'customSetup'>>;
+export declare const HEADLESS_POOL_ARGUMENT_SETS: {
+    basic: string[];
+    keychain_safe: string[];
+    security_enhanced: string[];
+};
+export declare function mergeConfig(base: HeadlessPoolConfig, override?: HeadlessPoolConfig): HeadlessPoolConfig;

package/dist-server/utils/headless-pool/config.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Headless Pool Configuration
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HEADLESS_POOL_ARGUMENT_SETS = exports.DEFAULT_POOL_CONFIG = void 0;
+exports.mergeConfig = mergeConfig;
+// Default configurations
+exports.DEFAULT_POOL_CONFIG = {
+    // Pool defaults
+    min: 2,
+    max: 10,
+    acquireTimeoutMillis: 15000,
+    idleTimeoutMillis: 300000, // 5 minutes
+    testOnBorrow: true,
+    // Browser defaults
+    headless: 'shell',
+    args: [
+        '--hide-scrollbars',
+        '--mute-audio',
+        '--no-sandbox',
+        '--use-gl=egl',
+        '--use-mock-keychain',
+        '--disable-password-manager-reauthentication',
+        '--disable-keychain-reauthorization',
+        '--disable-web-security',
+        '--disable-site-isolation-trials',
+        '--disable-extensions',
+        '--disable-default-apps',
+        '--disable-component-extensions-with-background-pages',
+        '--disable-background-timer-throttling',
+        '--disable-background-networking',
+        '--disable-sync',
+        '--disable-features=TranslateUI',
+        '--disable-ipc-flooding-protection'
+    ],
+    executablePath: '',
+    // Feature defaults
+    enableStats: false,
+    enableRecovery: false,
+    enableCleanup: true
+};
+// Common argument sets
+exports.HEADLESS_POOL_ARGUMENT_SETS = {
+    basic: ['--hide-scrollbars', '--mute-audio', '--no-sandbox', '--use-gl=egl'],
+    keychain_safe: [
+        '--use-mock-keychain',
+        '--disable-password-manager-reauthentication',
+        '--disable-keychain-reauthorization',
+        '--disable-web-security',
+        '--disable-site-isolation-trials',
+        '--disable-extensions',
+        '--disable-default-apps',
+        '--disable-component-extensions-with-background-pages',
+        '--disable-background-timer-throttling',
+        '--disable-background-networking',
+        '--disable-sync',
+        '--disable-features=TranslateUI',
+        '--disable-ipc-flooding-protection'
+    ],
+    security_enhanced: ['--disable-setuid-sandbox', '--disable-dev-shm-usage']
+};
+// Helper function to merge configs
+function mergeConfig(base, override = {}) {
+    return {
+        ...exports.DEFAULT_POOL_CONFIG,
+        ...base,
+        ...override,
+        args: [...(base.args || exports.DEFAULT_POOL_CONFIG.args), ...(override.args || [])]
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist-server/utils/headless-pool/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../server/utils/headless-pool/config.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAwFH,kCAOC;AArED,yBAAyB;AACZ,QAAA,mBAAmB,GAAsD;IACpF,gBAAgB;IAChB,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,EAAE;IACP,oBAAoB,EAAE,KAAK;IAC3B,iBAAiB,EAAE,MAAM,EAAE,YAAY;IACvC,YAAY,EAAE,IAAI;IAElB,mBAAmB;IACnB,QAAQ,EAAE,OAAO;IACjB,IAAI,EAAE;QACJ,mBAAmB;QACnB,cAAc;QACd,cAAc;QACd,cAAc;QACd,qBAAqB;QACrB,6CAA6C;QAC7C,oCAAoC;QACpC,wBAAwB;QACxB,iCAAiC;QACjC,sBAAsB;QACtB,wBAAwB;QACxB,sDAAsD;QACtD,uCAAuC;QACvC,iCAAiC;QACjC,gBAAgB;QAChB,gCAAgC;QAChC,mCAAmC;KACpC;IACD,cAAc,EAAE,EAAE;IAElB,mBAAmB;IACnB,WAAW,EAAE,KAAK;IAClB,cAAc,EAAE,KAAK;IACrB,aAAa,EAAE,IAAI;CACpB,CAAA;AAED,uBAAuB;AACV,QAAA,2BAA2B,GAAG;IACzC,KAAK,EAAE,CAAC,mBAAmB,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,CAAC;IAE5E,aAAa,EAAE;QACb,qBAAqB;QACrB,6CAA6C;QAC7C,oCAAoC;QACpC,wBAAwB;QACxB,iCAAiC;QACjC,sBAAsB;QACtB,wBAAwB;QACxB,sDAAsD;QACtD,uCAAuC;QACvC,iCAAiC;QACjC,gBAAgB;QAChB,gCAAgC;QAChC,mCAAmC;KACpC;IAED,iBAAiB,EAAE,CAAC,0BAA0B,EAAE,yBAAyB,CAAC;CAC3E,CAAA;AAED,mCAAmC;AACnC,SAAgB,WAAW,CAAC,IAAwB,EAAE,WAA+B,EAAE;IACrF,OAAO;QACL,GAAG,2BAAmB;QACtB,GAAG,IAAI;QACP,GAAG,QAAQ;QACX,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,2BAAmB,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;KAC7E,CAAA;AACH,CAAC","sourcesContent":["/**\n * Headless Pool Configuration\n */\n\nexport type HeadlessMode = 'shell' | 'new' | boolean\n\nexport interface HeadlessPoolConfig {\n  // Pool settings\n  min?: number\n  max?: number\n  acquireTimeoutMillis?: number\n  idleTimeoutMillis?: number\n  testOnBorrow?: boolean\n\n  // Browser launch settings\n  headless?: HeadlessMode\n  args?: string[]\n  executablePath?: string\n\n  // Features\n  enableStats?: boolean\n  enableRecovery?: boolean\n  enableCleanup?: boolean\n\n  // Custom setup function for special cases (like label pool)\n  customSetup?: (browser: any) => Promise<any>\n}\n\n// Default configurations\nexport const DEFAULT_POOL_CONFIG: Required<Omit<HeadlessPoolConfig, 'customSetup'>> = {\n  // Pool defaults\n  min: 2,\n  max: 10,\n  acquireTimeoutMillis: 15000,\n  idleTimeoutMillis: 300000, // 5 minutes\n  testOnBorrow: true,\n\n  // Browser defaults\n  headless: 'shell',\n  args: [\n    '--hide-scrollbars',\n    '--mute-audio',\n    '--no-sandbox',\n    '--use-gl=egl',\n    '--use-mock-keychain',\n    '--disable-password-manager-reauthentication',\n    '--disable-keychain-reauthorization',\n    '--disable-web-security',\n    '--disable-site-isolation-trials',\n    '--disable-extensions',\n    '--disable-default-apps',\n    '--disable-component-extensions-with-background-pages',\n    '--disable-background-timer-throttling',\n    '--disable-background-networking',\n    '--disable-sync',\n    '--disable-features=TranslateUI',\n    '--disable-ipc-flooding-protection'\n  ],\n  executablePath: '',\n\n  // Feature defaults\n  enableStats: false,\n  enableRecovery: false,\n  enableCleanup: true\n}\n\n// Common argument sets\nexport const HEADLESS_POOL_ARGUMENT_SETS = {\n  basic: ['--hide-scrollbars', '--mute-audio', '--no-sandbox', '--use-gl=egl'],\n\n  keychain_safe: [\n    '--use-mock-keychain',\n    '--disable-password-manager-reauthentication',\n    '--disable-keychain-reauthorization',\n    '--disable-web-security',\n    '--disable-site-isolation-trials',\n    '--disable-extensions',\n    '--disable-default-apps',\n    '--disable-component-extensions-with-background-pages',\n    '--disable-background-timer-throttling',\n    '--disable-background-networking',\n    '--disable-sync',\n    '--disable-features=TranslateUI',\n    '--disable-ipc-flooding-protection'\n  ],\n\n  security_enhanced: ['--disable-setuid-sandbox', '--disable-dev-shm-usage']\n}\n\n// Helper function to merge configs\nexport function mergeConfig(base: HeadlessPoolConfig, override: HeadlessPoolConfig = {}): HeadlessPoolConfig {\n  return {\n    ...DEFAULT_POOL_CONFIG,\n    ...base,\n    ...override,\n    args: [...(base.args || DEFAULT_POOL_CONFIG.args), ...(override.args || [])]\n  }\n}\n"]}

package/dist-server/utils/headless-pool/index.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Unified Headless Pool System for Things Factory
+ *
+ * This module provides a centralized headless browser pool system
+ * that can be used across all Things Factory packages.
+ */
+import { HeadlessPool } from './pool-manager';
+import { HeadlessPoolConfig } from './config';
+export { HeadlessPoolConfig, HEADLESS_POOL_ARGUMENT_SETS } from './config';
+export { HeadlessPool, HeadlessPoolManager } from './pool-manager';
+export { PoolStats } from './pool-stats';
+export { BrowserFactory } from './browser-factory';
+/**
+ * Create a new headless browser pool
+ *
+ * @param name - Unique name for the pool
+ * @param config - Pool configuration options
+ * @returns HeadlessPool instance
+ *
+ * @example
+ * // Create integration pool with advanced features
+ * const integrationPool = createHeadlessPool('integration', {
+ *   min: 2, max: 20,
+ *   args: [...HEADLESS_POOL_ARGUMENT_SETS.basic, ...HEADLESS_POOL_ARGUMENT_SETS.keychain_safe],
+ *   enableStats: true,
+ *   enableRecovery: true
+ * })
+ *
+ * @example
+ * // Create simple pool
+ * const myPool = createHeadlessPool('my-pool', {
+ *   min: 1, max: 5
+ * })
+ */
+export declare function createHeadlessPool(name: string, config?: HeadlessPoolConfig): HeadlessPool;
+/**
+ * Get existing headless browser pool by name
+ *
+ * @param name - Pool name
+ * @returns HeadlessPool instance
+ * @throws Error if pool doesn't exist
+ */
+export declare function getHeadlessPool(name: string): HeadlessPool;
+/**
+ * Get or create headless browser pool
+ * If pool exists, returns it. If not, creates with provided config.
+ *
+ * @param name - Pool name
+ * @param config - Pool configuration (used only if creating new pool)
+ * @returns HeadlessPool instance
+ */
+export declare function getOrCreateHeadlessPool(name: string, config?: HeadlessPoolConfig): HeadlessPool;
+/**
+ * Check if pool exists
+ *
+ * @param name - Pool name
+ * @returns boolean
+ */
+export declare function hasHeadlessPool(name: string): boolean;
+/**
+ * Get statistics for all pools
+ *
+ * @returns Object containing stats for all pools
+ */
+export declare function getAllPoolStats(): Record<string, any>;
+/**
+ * Clean up all headless browser pools
+ * Typically called during application shutdown
+ */
+export declare function cleanupAllPools(): Promise<void>;
+/**
+ * Reset a specific pool (cleanup and recreate)
+ *
+ * @param name - Pool name
+ */
+export declare function resetPool(name: string): Promise<void>;
+/**
+ * Remove pool from registry
+ *
+ * @param name - Pool name
+ */
+export declare function removePool(name: string): void;
+declare const _default: {
+    createHeadlessPool: typeof createHeadlessPool;
+    getHeadlessPool: typeof getHeadlessPool;
+    getOrCreateHeadlessPool: typeof getOrCreateHeadlessPool;
+    hasHeadlessPool: typeof hasHeadlessPool;
+    getAllPoolStats: typeof getAllPoolStats;
+    cleanupAllPools: typeof cleanupAllPools;
+    resetPool: typeof resetPool;
+    removePool: typeof removePool;
+    HEADLESS_POOL_ARGUMENT_SETS: {
+        basic: string[];
+        keychain_safe: string[];
+        security_enhanced: string[];
+    };
+};
+export default _default;

package/dist-server/utils/headless-pool/index.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * Unified Headless Pool System for Things Factory
+ *
+ * This module provides a centralized headless browser pool system
+ * that can be used across all Things Factory packages.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserFactory = exports.PoolStats = exports.HeadlessPoolManager = exports.HeadlessPool = exports.HEADLESS_POOL_ARGUMENT_SETS = void 0;
+exports.createHeadlessPool = createHeadlessPool;
+exports.getHeadlessPool = getHeadlessPool;
+exports.getOrCreateHeadlessPool = getOrCreateHeadlessPool;
+exports.hasHeadlessPool = hasHeadlessPool;
+exports.getAllPoolStats = getAllPoolStats;
+exports.cleanupAllPools = cleanupAllPools;
+exports.resetPool = resetPool;
+exports.removePool = removePool;
+const pool_manager_1 = require("./pool-manager");
+const config_1 = require("./config");
+// Re-export types and utilities
+var config_2 = require("./config");
+Object.defineProperty(exports, "HEADLESS_POOL_ARGUMENT_SETS", { enumerable: true, get: function () { return config_2.HEADLESS_POOL_ARGUMENT_SETS; } });
+var pool_manager_2 = require("./pool-manager");
+Object.defineProperty(exports, "HeadlessPool", { enumerable: true, get: function () { return pool_manager_2.HeadlessPool; } });
+Object.defineProperty(exports, "HeadlessPoolManager", { enumerable: true, get: function () { return pool_manager_2.HeadlessPoolManager; } });
+var pool_stats_1 = require("./pool-stats");
+Object.defineProperty(exports, "PoolStats", { enumerable: true, get: function () { return pool_stats_1.PoolStats; } });
+var browser_factory_1 = require("./browser-factory");
+Object.defineProperty(exports, "BrowserFactory", { enumerable: true, get: function () { return browser_factory_1.BrowserFactory; } });
+/**
+ * Create a new headless browser pool
+ *
+ * @param name - Unique name for the pool
+ * @param config - Pool configuration options
+ * @returns HeadlessPool instance
+ *
+ * @example
+ * // Create integration pool with advanced features
+ * const integrationPool = createHeadlessPool('integration', {
+ *   min: 2, max: 20,
+ *   args: [...HEADLESS_POOL_ARGUMENT_SETS.basic, ...HEADLESS_POOL_ARGUMENT_SETS.keychain_safe],
+ *   enableStats: true,
+ *   enableRecovery: true
+ * })
+ *
+ * @example
+ * // Create simple pool
+ * const myPool = createHeadlessPool('my-pool', {
+ *   min: 1, max: 5
+ * })
+ */
+function createHeadlessPool(name, config = {}) {
+    return pool_manager_1.HeadlessPoolManager.createPool(name, config);
+}
+/**
+ * Get existing headless browser pool by name
+ *
+ * @param name - Pool name
+ * @returns HeadlessPool instance
+ * @throws Error if pool doesn't exist
+ */
+function getHeadlessPool(name) {
+    return pool_manager_1.HeadlessPoolManager.getPool(name);
+}
+/**
+ * Get or create headless browser pool
+ * If pool exists, returns it. If not, creates with provided config.
+ *
+ * @param name - Pool name
+ * @param config - Pool configuration (used only if creating new pool)
+ * @returns HeadlessPool instance
+ */
+function getOrCreateHeadlessPool(name, config = {}) {
+    if (pool_manager_1.HeadlessPoolManager.hasPool(name)) {
+        return pool_manager_1.HeadlessPoolManager.getPool(name);
+    }
+    return pool_manager_1.HeadlessPoolManager.createPool(name, config);
+}
+/**
+ * Check if pool exists
+ *
+ * @param name - Pool name
+ * @returns boolean
+ */
+function hasHeadlessPool(name) {
+    return pool_manager_1.HeadlessPoolManager.hasPool(name);
+}
+/**
+ * Get statistics for all pools
+ *
+ * @returns Object containing stats for all pools
+ */
+function getAllPoolStats() {
+    return pool_manager_1.HeadlessPoolManager.getAllPoolStats();
+}
+/**
+ * Clean up all headless browser pools
+ * Typically called during application shutdown
+ */
+function cleanupAllPools() {
+    return pool_manager_1.HeadlessPoolManager.cleanupAll();
+}
+/**
+ * Reset a specific pool (cleanup and recreate)
+ *
+ * @param name - Pool name
+ */
+function resetPool(name) {
+    return pool_manager_1.HeadlessPoolManager.resetPool(name);
+}
+/**
+ * Remove pool from registry
+ *
+ * @param name - Pool name
+ */
+function removePool(name) {
+    return pool_manager_1.HeadlessPoolManager.removePool(name);
+}
+// Default export
+exports.default = {
+    createHeadlessPool,
+    getHeadlessPool,
+    getOrCreateHeadlessPool,
+    hasHeadlessPool,
+    getAllPoolStats,
+    cleanupAllPools,
+    resetPool,
+    removePool,
+    HEADLESS_POOL_ARGUMENT_SETS: config_1.HEADLESS_POOL_ARGUMENT_SETS
+};
+//# sourceMappingURL=index.js.map

package/dist-server/utils/headless-pool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/utils/headless-pool/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAiCH,gDAEC;AASD,0CAEC;AAUD,0DAKC;AAQD,0CAEC;AAOD,0CAEC;AAMD,0CAEC;AAOD,8BAEC;AAOD,gCAEC;AAxGD,iDAAkE;AAClE,qCAA0E;AAE1E,gCAAgC;AAChC,mCAA0E;AAA7C,qHAAA,2BAA2B,OAAA;AACxD,+CAAkE;AAAzD,4GAAA,YAAY,OAAA;AAAE,mHAAA,mBAAmB,OAAA;AAC1C,2CAAwC;AAA/B,uGAAA,SAAS,OAAA;AAClB,qDAAkD;AAAzC,iHAAA,cAAc,OAAA;AAEvB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,kBAAkB,CAAC,IAAY,EAAE,SAA6B,EAAE;IAC9E,OAAO,kCAAmB,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;AACrD,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,eAAe,CAAC,IAAY;IAC1C,OAAO,kCAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;AAC1C,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,uBAAuB,CAAC,IAAY,EAAE,SAA6B,EAAE;IACnF,IAAI,kCAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,OAAO,kCAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1C,CAAC;IACD,OAAO,kCAAmB,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;AACrD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,IAAY;IAC1C,OAAO,kCAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;AAC1C,CAAC;AAED;;;;GAIG;AACH,SAAgB,eAAe;IAC7B,OAAO,kCAAmB,CAAC,eAAe,EAAE,CAAA;AAC9C,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe;IAC7B,OAAO,kCAAmB,CAAC,UAAU,EAAE,CAAA;AACzC,CAAC;AAED;;;;GAIG;AACH,SAAgB,SAAS,CAAC,IAAY;IACpC,OAAO,kCAAmB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;AAC5C,CAAC;AAED;;;;GAIG;AACH,SAAgB,UAAU,CAAC,IAAY;IACrC,OAAO,kCAAmB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;AAC7C,CAAC;AAGD,iBAAiB;AACjB,kBAAe;IACb,kBAAkB;IAClB,eAAe;IACf,uBAAuB;IACvB,eAAe;IACf,eAAe;IACf,eAAe;IACf,SAAS;IACT,UAAU;IACV,2BAA2B,EAA3B,oCAA2B;CAC5B,CAAA","sourcesContent":["/**\n * Unified Headless Pool System for Things Factory\n * \n * This module provides a centralized headless browser pool system\n * that can be used across all Things Factory packages.\n */\n\nimport { HeadlessPoolManager, HeadlessPool } from './pool-manager'\nimport { HeadlessPoolConfig, HEADLESS_POOL_ARGUMENT_SETS } from './config'\n\n// Re-export types and utilities\nexport { HeadlessPoolConfig, HEADLESS_POOL_ARGUMENT_SETS } from './config'\nexport { HeadlessPool, HeadlessPoolManager } from './pool-manager'\nexport { PoolStats } from './pool-stats'\nexport { BrowserFactory } from './browser-factory'\n\n/**\n * Create a new headless browser pool\n * \n * @param name - Unique name for the pool\n * @param config - Pool configuration options\n * @returns HeadlessPool instance\n * \n * @example\n * // Create integration pool with advanced features\n * const integrationPool = createHeadlessPool('integration', {\n *   min: 2, max: 20,\n *   args: [...HEADLESS_POOL_ARGUMENT_SETS.basic, ...HEADLESS_POOL_ARGUMENT_SETS.keychain_safe],\n *   enableStats: true,\n *   enableRecovery: true\n * })\n * \n * @example  \n * // Create simple pool\n * const myPool = createHeadlessPool('my-pool', {\n *   min: 1, max: 5\n * })\n */\nexport function createHeadlessPool(name: string, config: HeadlessPoolConfig = {}): HeadlessPool {\n  return HeadlessPoolManager.createPool(name, config)\n}\n\n/**\n * Get existing headless browser pool by name\n * \n * @param name - Pool name\n * @returns HeadlessPool instance\n * @throws Error if pool doesn't exist\n */\nexport function getHeadlessPool(name: string): HeadlessPool {\n  return HeadlessPoolManager.getPool(name)\n}\n\n/**\n * Get or create headless browser pool\n * If pool exists, returns it. If not, creates with provided config.\n * \n * @param name - Pool name\n * @param config - Pool configuration (used only if creating new pool)\n * @returns HeadlessPool instance\n */\nexport function getOrCreateHeadlessPool(name: string, config: HeadlessPoolConfig = {}): HeadlessPool {\n  if (HeadlessPoolManager.hasPool(name)) {\n    return HeadlessPoolManager.getPool(name)\n  }\n  return HeadlessPoolManager.createPool(name, config)\n}\n\n/**\n * Check if pool exists\n * \n * @param name - Pool name\n * @returns boolean\n */\nexport function hasHeadlessPool(name: string): boolean {\n  return HeadlessPoolManager.hasPool(name)\n}\n\n/**\n * Get statistics for all pools\n * \n * @returns Object containing stats for all pools\n */\nexport function getAllPoolStats() {\n  return HeadlessPoolManager.getAllPoolStats()\n}\n\n/**\n * Clean up all headless browser pools\n * Typically called during application shutdown\n */\nexport function cleanupAllPools(): Promise<void> {\n  return HeadlessPoolManager.cleanupAll()\n}\n\n/**\n * Reset a specific pool (cleanup and recreate)\n * \n * @param name - Pool name\n */\nexport function resetPool(name: string): Promise<void> {\n  return HeadlessPoolManager.resetPool(name)\n}\n\n/**\n * Remove pool from registry\n * \n * @param name - Pool name\n */\nexport function removePool(name: string): void {\n  return HeadlessPoolManager.removePool(name)\n}\n\n\n// Default export\nexport default {\n  createHeadlessPool,\n  getHeadlessPool,\n  getOrCreateHeadlessPool,\n  hasHeadlessPool,\n  getAllPoolStats,\n  cleanupAllPools,\n  resetPool,\n  removePool,\n  HEADLESS_POOL_ARGUMENT_SETS\n}"]}

package/dist-server/utils/headless-pool/pool-manager.d.ts

@@ -0,0 +1,59 @@
+import { HeadlessPoolConfig } from './config';
+/**
+ * Individual Pool Instance
+ */
+export declare class HeadlessPool {
+    private pool;
+    private stats?;
+    private config;
+    private name;
+    constructor(name: string, config: HeadlessPoolConfig);
+    private createPool;
+    private createResource;
+    private validateResource;
+    private destroyResource;
+    private addMonitoring;
+    acquire(): Promise<any>;
+    release(resource: any): Promise<void>;
+    getStats(): {
+        poolStatus: {
+            utilizationRate: string;
+            size: number;
+            available: number;
+            borrowed: number;
+            pending: number;
+            max: number;
+            min: number;
+        };
+        statistics: {
+            averageAcquisitionTime: string;
+            totalCreated: number;
+            totalDestroyed: number;
+            totalAcquired: number;
+            totalReleased: number;
+            currentlyAcquired: number;
+            acquisitionTimes: number[];
+            lastActivity: string | null;
+        };
+        health: {
+            status: string;
+            message: string;
+            leakDetection: string;
+        };
+    };
+    cleanup(): Promise<void>;
+    reset(): Promise<void>;
+}
+/**
+ * Global Pool Manager/Registry
+ */
+export declare class HeadlessPoolManager {
+    private static pools;
+    static createPool(name: string, config?: HeadlessPoolConfig): HeadlessPool;
+    static getPool(name: string): HeadlessPool;
+    static hasPool(name: string): boolean;
+    static getAllPoolStats(): Record<string, any>;
+    static cleanupAll(): Promise<void>;
+    static resetPool(name: string): Promise<void>;
+    static removePool(name: string): void;
+}