@cli4ai/lib - npm Package Compare versions

Comparing version 1.0.6 to 1.0.7

browser.ts

+/**
+ * Shared browser utilities for packages that depend on @cli4ai/chrome
+ * Auto-launches managed browser if not running
+ */
+import puppeteer, { Browser, Page } from 'puppeteer';
+import { readFileSync, writeFileSync, existsSync, unlinkSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+// Persistent storage paths (same as chrome package)
+const CLI4AI_DIR = join(homedir(), '.cli4ai');
+const CHROME_DIR = join(CLI4AI_DIR, 'chrome');
+const PROFILE_DIR = join(CHROME_DIR, 'profile');
+const WS_FILE = join(CHROME_DIR, 'ws-endpoint');
+const PID_FILE = join(CHROME_DIR, 'pid');
+
+function ensureDirs() {
+  if (!existsSync(CLI4AI_DIR)) mkdirSync(CLI4AI_DIR, { recursive: true });
+  if (!existsSync(CHROME_DIR)) mkdirSync(CHROME_DIR, { recursive: true });
+}
+
+function isBrowserRunning(): boolean {
+  if (!existsSync(PID_FILE)) return false;
+  const pid = parseInt(readFileSync(PID_FILE, 'utf-8').trim(), 10);
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    cleanup();
+    return false;
+  }
+}
+
+function cleanup() {
+  if (existsSync(WS_FILE)) unlinkSync(WS_FILE);
+  if (existsSync(PID_FILE)) unlinkSync(PID_FILE);
+}
+
+async function launchBrowser(headless: boolean): Promise<Browser> {
+  ensureDirs();
+
+  const browser = await puppeteer.launch({
+    headless: headless ? 'shell' : false,
+    userDataDir: PROFILE_DIR,
+    args: [
+      '--no-first-run',
+      '--no-default-browser-check',
+      '--disable-infobars',
+    ],
+    defaultViewport: null,
+  });
+
+  const wsEndpoint = browser.wsEndpoint();
+  writeFileSync(WS_FILE, wsEndpoint);
+
+  const browserProcess = browser.process();
+  if (browserProcess?.pid) {
+    writeFileSync(PID_FILE, String(browserProcess.pid));
+  }
+
+  return browser;
+}
+
+/**
+ * Get or create browser instance
+ * Auto-launches if not running
+ */
+export async function getBrowser(headless = false): Promise<Browser> {
+  if (isBrowserRunning() && existsSync(WS_FILE)) {
+    try {
+      const ws = readFileSync(WS_FILE, 'utf-8').trim();
+      return await puppeteer.connect({ browserWSEndpoint: ws });
+    } catch {
+      cleanup();
+    }
+  }
+  return launchBrowser(headless);
+}
+
+/**
+ * Get a page from the browser
+ */
+export async function getPage(browser: Browser, newTab = false): Promise<Page> {
+  if (newTab) {
+    return browser.newPage();
+  }
+  const pages = await browser.pages();
+  return pages[pages.length - 1] || browser.newPage();
+}
+
+/**
+ * Execute a function with a page, handling browser connection
+ */
+export async function withPage<T>(
+  fn: (page: Page) => Promise<T>,
+  options: { headless?: boolean; newTab?: boolean } = {}
+): Promise<T> {
+  const browser = await getBrowser(options.headless ?? false);
+  const page = await getPage(browser, options.newTab ?? false);
+  try {
+    return await fn(page);
+  } finally {
+    browser.disconnect();
+  }
+}
+
+/**
+ * Execute a function with a new tab
+ */
+export async function withNewPage<T>(
+  fn: (page: Page) => Promise<T>,
+  headless = false
+): Promise<T> {
+  const browser = await getBrowser(headless);
+  const page = await browser.newPage();
+  try {
+    return await fn(page);
+  } finally {
+    await page.close();
+    browser.disconnect();
+  }
+}
+
+/**
+ * Check if browser is currently running
+ */
+export function isRunning(): boolean {
+  return isBrowserRunning();
+}
+
+export { Browser, Page };

dist/browser.d.ts

+/**
+ * Shared browser utilities for packages that depend on @cli4ai/chrome
+ * Auto-launches managed browser if not running
+ */
+import { Browser, Page } from 'puppeteer';
+/**
+ * Get or create browser instance
+ * Auto-launches if not running
+ */
+export declare function getBrowser(headless?: boolean): Promise<Browser>;
+/**
+ * Get a page from the browser
+ */
+export declare function getPage(browser: Browser, newTab?: boolean): Promise<Page>;
+/**
+ * Execute a function with a page, handling browser connection
+ */
+export declare function withPage<T>(fn: (page: Page) => Promise<T>, options?: {
+    headless?: boolean;
+    newTab?: boolean;
+}): Promise<T>;
+/**
+ * Execute a function with a new tab
+ */
+export declare function withNewPage<T>(fn: (page: Page) => Promise<T>, headless?: boolean): Promise<T>;
+/**
+ * Check if browser is currently running
+ */
+export declare function isRunning(): boolean;
+export { Browser, Page };
+//# sourceMappingURL=browser.d.ts.map

dist/browser.d.ts.map

+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAkB,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AA2DrD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,QAAQ,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAUnE;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7E;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9B,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACrD,OAAO,CAAC,CAAC,CAAC,CAQZ;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9B,QAAQ,UAAQ,GACf,OAAO,CAAC,CAAC,CAAC,CASZ;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC"}

dist/browser.js

+/**
+ * Shared browser utilities for packages that depend on @cli4ai/chrome
+ * Auto-launches managed browser if not running
+ */
+import puppeteer, { Browser, Page } from 'puppeteer';
+import { readFileSync, writeFileSync, existsSync, unlinkSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+// Persistent storage paths (same as chrome package)
+const CLI4AI_DIR = join(homedir(), '.cli4ai');
+const CHROME_DIR = join(CLI4AI_DIR, 'chrome');
+const PROFILE_DIR = join(CHROME_DIR, 'profile');
+const WS_FILE = join(CHROME_DIR, 'ws-endpoint');
+const PID_FILE = join(CHROME_DIR, 'pid');
+function ensureDirs() {
+    if (!existsSync(CLI4AI_DIR))
+        mkdirSync(CLI4AI_DIR, { recursive: true });
+    if (!existsSync(CHROME_DIR))
+        mkdirSync(CHROME_DIR, { recursive: true });
+}
+function isBrowserRunning() {
+    if (!existsSync(PID_FILE))
+        return false;
+    const pid = parseInt(readFileSync(PID_FILE, 'utf-8').trim(), 10);
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        cleanup();
+        return false;
+    }
+}
+function cleanup() {
+    if (existsSync(WS_FILE))
+        unlinkSync(WS_FILE);
+    if (existsSync(PID_FILE))
+        unlinkSync(PID_FILE);
+}
+async function launchBrowser(headless) {
+    ensureDirs();
+    const browser = await puppeteer.launch({
+        headless: headless ? 'shell' : false,
+        userDataDir: PROFILE_DIR,
+        args: [
+            '--no-first-run',
+            '--no-default-browser-check',
+            '--disable-infobars',
+        ],
+        defaultViewport: null,
+    });
+    const wsEndpoint = browser.wsEndpoint();
+    writeFileSync(WS_FILE, wsEndpoint);
+    const browserProcess = browser.process();
+    if (browserProcess?.pid) {
+        writeFileSync(PID_FILE, String(browserProcess.pid));
+    }
+    return browser;
+}
+/**
+ * Get or create browser instance
+ * Auto-launches if not running
+ */
+export async function getBrowser(headless = false) {
+    if (isBrowserRunning() && existsSync(WS_FILE)) {
+        try {
+            const ws = readFileSync(WS_FILE, 'utf-8').trim();
+            return await puppeteer.connect({ browserWSEndpoint: ws });
+        }
+        catch {
+            cleanup();
+        }
+    }
+    return launchBrowser(headless);
+}
+/**
+ * Get a page from the browser
+ */
+export async function getPage(browser, newTab = false) {
+    if (newTab) {
+        return browser.newPage();
+    }
+    const pages = await browser.pages();
+    return pages[pages.length - 1] || browser.newPage();
+}
+/**
+ * Execute a function with a page, handling browser connection
+ */
+export async function withPage(fn, options = {}) {
+    const browser = await getBrowser(options.headless ?? false);
+    const page = await getPage(browser, options.newTab ?? false);
+    try {
+        return await fn(page);
+    }
+    finally {
+        browser.disconnect();
+    }
+}
+/**
+ * Execute a function with a new tab
+ */
+export async function withNewPage(fn, headless = false) {
+    const browser = await getBrowser(headless);
+    const page = await browser.newPage();
+    try {
+        return await fn(page);
+    }
+    finally {
+        await page.close();
+        browser.disconnect();
+    }
+}
+/**
+ * Check if browser is currently running
+ */
+export function isRunning() {
+    return isBrowserRunning();
+}
+export { Browser, Page };

package.json

 {
   "name": "@cli4ai/lib",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "Shared CLI framework for cli4ai tools",
   "author": "cliforai",
-  "license": "MIT",
+  "license": "BUSL-1.1",
   "type": "module",
@@ -20,2 +20,7 @@ "main": "dist/cli.js",
       "default": "./dist/cli.js"
+    },
+    "./browser.ts": {
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.js",
+      "default": "./dist/browser.js"
     }
@@ -43,3 +48,4 @@ },
   "dependencies": {
-    "commander": "^14.0.0"
+    "commander": "^14.0.0",
+    "puppeteer": "^24.0.0"
   },
@@ -52,2 +58,3 @@ "devDependencies": {
     "cli.ts",
+    "browser.ts",
     "dist"
@@ -54,0 +61,0 @@ ],

New alerts

Environment variable access

Supply chain risk

Package accesses environment variables, which may be a sign of credential stuffing or data theft.

Found 1 instance in 1 package

Filesystem access

Supply chain risk

Accesses the file system, and could potentially read sensitive data.

Found 1 instance in 1 package

Non-permissive License

License

A license not known to be considered permissive was found.

Found 1 instance in 1 package

Fixed alerts

Environment variable access

Supply chain risk

Package accesses environment variables, which may be a sign of credential stuffing or data theft.

Found 1 instance in 1 package

Filesystem access

Supply chain risk

Accesses the file system, and could potentially read sensitive data.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

35243

32.23%

Number of package files

10

66.67%

Lines of code

868

43.95%

Worsened metrics

Dependency count

2

100%

Number of low license alerts

1

Infinity%

License quality

90

-10%

Number of low supply chain risk alerts

15

15.38%

Dependency changes

• + Added

  puppeteer@^24.0.0

• + Added

  @babel/code-frame@7.29.0
  (transitive)

• + Added

  @babel/helper-validator-identifier@7.28.5
  (transitive)

• + Added

  @puppeteer/browsers@2.13.0
  (transitive)

• + Added

  @tootallnate/quickjs-emscripten@0.23.0
  (transitive)

• + Added

  @types/node@25.6.0
  (transitive)

• + Added

  @types/yauzl@2.10.3
  (transitive)

• + Added

  agent-base@7.1.4
  (transitive)

• + Added

  ansi-regex@5.0.1
  (transitive)

• + Added

  ansi-styles@4.3.0
  (transitive)

• + Added

  argparse@2.0.1
  (transitive)

• + Added

  ast-types@0.13.4
  (transitive)

• + Added

  b4a@1.8.0
  (transitive)

• + Added

  bare-events@2.8.2
  (transitive)

• + Added

  bare-fs@4.7.0
  (transitive)

• + Added

  bare-os@3.8.7
  (transitive)

• + Added

  bare-path@3.0.0
  (transitive)

• + Added

  bare-stream@2.13.0
  (transitive)

• + Added

  bare-url@2.4.0
  (transitive)

• + Added

  basic-ftp@5.2.2
  (transitive)

• + Added

  buffer-crc32@0.2.13
  (transitive)

• + Added

  callsites@3.1.0
  (transitive)

• + Added

  chromium-bidi@14.0.0
  (transitive)

• + Added

  cliui@8.0.1
  (transitive)

• + Added

  color-convert@2.0.1
  (transitive)

• + Added

  color-name@1.1.4
  (transitive)

• + Added

  cosmiconfig@9.0.1
  (transitive)

• + Added

  data-uri-to-buffer@6.0.2
  (transitive)

• + Added

  debug@4.4.3
  (transitive)

• + Added

  degenerator@5.0.1
  (transitive)

• + Added

  devtools-protocol@0.0.1581282
  (transitive)

• + Added

  emoji-regex@8.0.0
  (transitive)

• + Added

  end-of-stream@1.4.5
  (transitive)

• + Added

  env-paths@2.2.1
  (transitive)

• + Added

  error-ex@1.3.4
  (transitive)

• + Added

  escalade@3.2.0
  (transitive)

• + Added

  escodegen@2.1.0
  (transitive)

• + Added

  esprima@4.0.1
  (transitive)

• + Added

  estraverse@5.3.0
  (transitive)

• + Added

  esutils@2.0.3
  (transitive)

• + Added

  events-universal@1.0.1
  (transitive)

• + Added

  extract-zip@2.0.1
  (transitive)

• + Added

  fast-fifo@1.3.2
  (transitive)

• + Added

  fd-slicer@1.1.0
  (transitive)

• + Added

  get-caller-file@2.0.5
  (transitive)

• + Added

  get-stream@5.2.0
  (transitive)

• + Added

  get-uri@6.0.5
  (transitive)

• + Added

  http-proxy-agent@7.0.2
  (transitive)

• + Added

  https-proxy-agent@7.0.6
  (transitive)

• + Added

  import-fresh@3.3.1
  (transitive)

• + Added

  ip-address@10.1.0
  (transitive)

• + Added

  is-arrayish@0.2.1
  (transitive)

• + Added

  is-fullwidth-code-point@3.0.0
  (transitive)

• + Added

  js-tokens@4.0.0
  (transitive)

• + Added

  js-yaml@4.1.1
  (transitive)

• + Added

  json-parse-even-better-errors@2.3.1
  (transitive)

• + Added

  lines-and-columns@1.2.4
  (transitive)

• + Added

  lru-cache@7.18.3
  (transitive)

• + Added

  mitt@3.0.1
  (transitive)

• + Added

  ms@2.1.3
  (transitive)

• + Added

  netmask@2.1.1
  (transitive)

• + Added

  once@1.4.0
  (transitive)

• + Added

  pac-proxy-agent@7.2.0
  (transitive)

• + Added

  pac-resolver@7.0.1
  (transitive)

• + Added

  parent-module@1.0.1
  (transitive)

• + Added

  parse-json@5.2.0
  (transitive)

• + Added

  pend@1.2.0
  (transitive)

• + Added

  picocolors@1.1.1
  (transitive)

• + Added

  progress@2.0.3
  (transitive)

• + Added

  proxy-agent@6.5.0
  (transitive)

• + Added

  proxy-from-env@1.1.0
  (transitive)

• + Added

  pump@3.0.4
  (transitive)

• + Added

  puppeteer@24.40.0
  (transitive)

• + Added

  puppeteer-core@24.40.0
  (transitive)

• + Added

  require-directory@2.1.1
  (transitive)

• + Added

  resolve-from@4.0.0
  (transitive)

• + Added

  semver@7.7.4
  (transitive)

• + Added

  smart-buffer@4.2.0
  (transitive)

• + Added

  socks@2.8.7
  (transitive)

• + Added

  socks-proxy-agent@8.0.5
  (transitive)

• + Added

  source-map@0.6.1
  (transitive)

• + Added

  streamx@2.25.0
  (transitive)

• + Added

  string-width@4.2.3
  (transitive)

• + Added

  strip-ansi@6.0.1
  (transitive)

• + Added

  tar-fs@3.1.2
  (transitive)

• + Added

  tar-stream@3.1.8
  (transitive)

• + Added

  teex@1.0.1
  (transitive)

• + Added

  text-decoder@1.2.7
  (transitive)

• + Added

  tslib@2.8.1
  (transitive)

• + Added

  typed-query-selector@2.12.1
  (transitive)

• + Added

  undici-types@7.19.2
  (transitive)

• + Added

  webdriver-bidi-protocol@0.4.1
  (transitive)

• + Added

  wrap-ansi@7.0.0
  (transitive)

• + Added

  wrappy@1.0.2
  (transitive)

• + Added

  ws@8.20.0
  (transitive)

• + Added

  y18n@5.0.8
  (transitive)

• + Added

  yargs@17.7.2
  (transitive)

• + Added

  yargs-parser@21.1.1
  (transitive)

• + Added

  yauzl@2.10.0
  (transitive)

• + Added

  zod@3.25.76
  (transitive)