chartjs2img 0.3.0

package/dist/chromium.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Find a Chromium/Chrome executable already installed on this machine.
+ * Checks: CHROMIUM_PATH env → Playwright cache → system Chrome → Chrome
+ * for Testing cache.
+ */
+export declare function findChromiumExecutable(): string | null;
+/** Download Chrome for Testing directly via fetch — no sudo, no npm/npx needed */
+export declare function downloadChromeForTesting(): Promise<string>;
+export declare function ensureChromiumInstalled(): Promise<string>;
+//# sourceMappingURL=chromium.d.ts.map

package/dist/chromium.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chromium.d.ts","sourceRoot":"","sources":["../src/chromium.ts"],"names":[],"mappings":"AAiBA;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAgFtD;AAaD,kFAAkF;AAClF,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,MAAM,CAAC,CAqFhE;AASD,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC,CAyB/D"}

package/dist/chromium.js

@@ -0,0 +1,226 @@
+// Chromium procurement.
+//
+// Three functions, each with a tight responsibility:
+//   findChromiumExecutable — scan known install locations and return
+//     a path if Chrome/Chromium is already present. Pure wrt. the
+//     filesystem: it doesn't touch the network or create files.
+//   downloadChromeForTesting — install Chrome for Testing into the
+//     user-local Playwright cache. Side effects: fetch + fs write.
+//   ensureChromiumInstalled — orchestrator. Returns a cached path if
+//     called repeatedly within the same process.
+//
+// Split out from renderer.ts so renderer owns browser/page lifecycle,
+// not platform-specific binary discovery.
+import { existsSync, readdirSync, mkdirSync, writeFileSync, chmodSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { homedir, platform, arch } from 'os';
+/**
+ * Find a Chromium/Chrome executable already installed on this machine.
+ * Checks: CHROMIUM_PATH env → Playwright cache → system Chrome → Chrome
+ * for Testing cache.
+ */
+export function findChromiumExecutable() {
+    const os = platform();
+    const home = homedir();
+    // 1. Environment variable override
+    if (process.env.CHROMIUM_PATH && existsSync(process.env.CHROMIUM_PATH)) {
+        return process.env.CHROMIUM_PATH;
+    }
+    // 2. Scan Playwright's browser cache directories (from prior installs)
+    const cacheDirs = [];
+    if (process.env.PLAYWRIGHT_BROWSERS_PATH) {
+        cacheDirs.push(process.env.PLAYWRIGHT_BROWSERS_PATH);
+    }
+    if (os === 'darwin') {
+        cacheDirs.push(join(home, 'Library', 'Caches', 'ms-playwright'));
+    }
+    else if (os === 'linux') {
+        cacheDirs.push(join(home, '.cache', 'ms-playwright'));
+    }
+    else if (os === 'win32') {
+        cacheDirs.push(join(home, 'AppData', 'Local', 'ms-playwright'));
+    }
+    const playwrightExecPaths = {
+        darwin: [
+            'chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing',
+            'chrome-mac/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing',
+            'chrome-mac-arm64/Chromium.app/Contents/MacOS/Chromium',
+            'chrome-mac/Chromium.app/Contents/MacOS/Chromium',
+        ],
+        linux: ['chrome-linux/chrome', 'chrome-linux64/chrome', 'chrome-linux/chromium'],
+        win32: ['chrome-win64/chrome.exe', 'chrome-win/chrome.exe'],
+    };
+    const candidates = playwrightExecPaths[os] ?? playwrightExecPaths['linux'];
+    for (const cacheDir of cacheDirs) {
+        if (!existsSync(cacheDir))
+            continue;
+        let entries;
+        try {
+            entries = readdirSync(cacheDir)
+                .filter((e) => e.startsWith('chromium'))
+                .sort()
+                .reverse();
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            for (const relPath of candidates) {
+                const fullPath = join(cacheDir, entry, relPath);
+                if (existsSync(fullPath))
+                    return fullPath;
+            }
+        }
+    }
+    // 3. System-installed Chrome/Chromium
+    const systemPaths = {
+        darwin: [
+            '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+            '/Applications/Chromium.app/Contents/MacOS/Chromium',
+            join(home, 'Applications/Google Chrome.app/Contents/MacOS/Google Chrome'),
+        ],
+        linux: [
+            '/usr/bin/google-chrome-stable',
+            '/usr/bin/google-chrome',
+            '/usr/bin/chromium-browser',
+            '/usr/bin/chromium',
+            '/snap/bin/chromium',
+        ],
+        win32: [
+            join(process.env.PROGRAMFILES ?? 'C:\\Program Files', 'Google\\Chrome\\Application\\chrome.exe'),
+            join(process.env['PROGRAMFILES(X86)'] ?? 'C:\\Program Files (x86)', 'Google\\Chrome\\Application\\chrome.exe'),
+            join(home, 'AppData\\Local\\Google\\Chrome\\Application\\chrome.exe'),
+        ],
+    };
+    for (const p of systemPaths[os] ?? []) {
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+/** Chrome-for-Testing platform string for the current OS/arch, or null if unsupported */
+function getCftPlatform() {
+    const os = platform();
+    const a = arch();
+    if (os === 'darwin')
+        return a === 'arm64' ? 'mac-arm64' : 'mac-x64';
+    if (os === 'win32')
+        return a === 'x64' ? 'win64' : 'win32';
+    // Chrome for Testing only provides linux64 (x86_64) — no linux-arm64
+    if (a === 'arm64' || a === 'aarch64')
+        return null;
+    return 'linux64';
+}
+/** Download Chrome for Testing directly via fetch — no sudo, no npm/npx needed */
+export async function downloadChromeForTesting() {
+    const os = platform();
+    const cftPlatform = getCftPlatform();
+    if (!cftPlatform) {
+        throw new Error(`Chrome for Testing is not available for ${platform()}/${arch()}.\n` +
+            'Install Chromium manually (e.g., apt install chromium) and set CHROMIUM_PATH.');
+    }
+    // Install into user-local cache directory (no sudo)
+    const home = homedir();
+    let installBase;
+    if (os === 'darwin') {
+        installBase = join(home, 'Library', 'Caches', 'ms-playwright');
+    }
+    else if (os === 'win32') {
+        installBase = join(home, 'AppData', 'Local', 'ms-playwright');
+    }
+    else {
+        installBase = join(home, '.cache', 'ms-playwright');
+    }
+    const installDir = join(installBase, 'chromium-cft');
+    mkdirSync(installDir, { recursive: true });
+    // Fetch latest stable download URL from Chrome for Testing API
+    console.log('[chromium] Fetching Chrome for Testing download info...');
+    const apiUrl = 'https://googlechromelabs.github.io/chrome-for-testing/last-known-good-versions-with-downloads.json';
+    const res = await fetch(apiUrl);
+    if (!res.ok)
+        throw new Error(`Failed to fetch Chrome for Testing API: ${res.status}`);
+    const data = (await res.json());
+    const entry = data.channels.Stable.downloads.chrome.find((d) => d.platform === cftPlatform);
+    if (!entry)
+        throw new Error(`No Chrome for Testing download for platform: ${cftPlatform}`);
+    const downloadUrl = entry.url;
+    const version = data.channels.Stable.version;
+    console.log(`[chromium] Downloading Chrome ${version} for ${cftPlatform}...`);
+    const dlRes = await fetch(downloadUrl);
+    if (!dlRes.ok)
+        throw new Error(`Download failed: ${dlRes.status}`);
+    const zipBuffer = Buffer.from(await dlRes.arrayBuffer());
+    const zipPath = join(installDir, 'chrome.zip');
+    writeFileSync(zipPath, zipBuffer);
+    console.log('[chromium] Extracting...');
+    if (os === 'win32') {
+        const proc = Bun.spawn(['powershell', '-Command', `Expand-Archive -Force -Path '${zipPath}' -DestinationPath '${installDir}'`], { stdout: 'inherit', stderr: 'inherit' });
+        if ((await proc.exited) !== 0)
+            throw new Error('Failed to extract (PowerShell Expand-Archive)');
+    }
+    else {
+        const proc = Bun.spawn(['unzip', '-o', '-q', zipPath, '-d', installDir], {
+            stdout: 'inherit',
+            stderr: 'inherit',
+        });
+        if ((await proc.exited) !== 0)
+            throw new Error('Failed to extract (unzip)');
+    }
+    try {
+        unlinkSync(zipPath);
+    }
+    catch {
+        /* ignore */
+    }
+    // Find the extracted executable
+    const execCandidates = {
+        darwin: [`chrome-${cftPlatform}/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing`],
+        linux: [`chrome-${cftPlatform}/chrome`],
+        win32: [`chrome-${cftPlatform}\\chrome.exe`],
+    };
+    for (const rel of execCandidates[os] ?? execCandidates['linux']) {
+        const fullPath = join(installDir, rel);
+        if (existsSync(fullPath)) {
+            if (os !== 'win32') {
+                try {
+                    chmodSync(fullPath, 0o755);
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+            return fullPath;
+        }
+    }
+    throw new Error('Chrome was downloaded but executable not found in extracted files');
+}
+/**
+ * Return a path to a Chromium executable, installing Chrome for Testing
+ * on first call if no local Chrome/Chromium is discoverable. Caches the
+ * result for the lifetime of the process.
+ */
+let cachedPath = null;
+export async function ensureChromiumInstalled() {
+    if (cachedPath)
+        return cachedPath;
+    const found = findChromiumExecutable();
+    if (found) {
+        cachedPath = found;
+        return cachedPath;
+    }
+    console.log('[chromium] Chrome/Chromium not found. Installing Chrome for Testing...');
+    try {
+        const p = await downloadChromeForTesting();
+        console.log('[chromium] Chrome for Testing installed successfully');
+        cachedPath = p;
+        return cachedPath;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to install Chrome automatically: ${msg}\n` +
+            'You can install it manually:\n' +
+            '  - Install Google Chrome, or\n' +
+            '  - Set CHROMIUM_PATH env var to an existing Chrome/Chromium executable.');
+    }
+}
+//# sourceMappingURL=chromium.js.map

package/dist/chromium.js.map

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

package/dist/lib.d.ts

@@ -0,0 +1,40 @@
+/**
+ * chartjs2img — TypeScript / Node library entry.
+ *
+ * Import this file to render Chart.js configurations to images from
+ * any Bun / Node program:
+ *
+ *     import { renderChart, closeBrowser } from 'chartjs2img'
+ *
+ *     const result = await renderChart({
+ *       chart: { type: 'bar', data: { labels: ['A','B'], datasets: [{ data: [1,2] }] } },
+ *       width: 800, height: 600, format: 'png',
+ *     })
+ *     await Bun.write('chart.png', result.buffer)
+ *     if (result.messages.length) console.warn(result.messages)
+ *     await closeBrowser() // on process shutdown
+ *
+ * The `chartjs2img` CLI (`src/index.ts`) and the HTTP server
+ * (`src/server.ts`) share the same render pipeline but import it
+ * directly from ./renderer etc. — NOT from this file. That way the
+ * public surface exported here is a constraint for external consumers
+ * only, and internal refactoring does not have to preserve it.
+ *
+ * This module intentionally **does not** export the in-memory cache
+ * internals, the Puppeteer launch helpers, the HTML template, or the
+ * CLI argument parser. Those are implementation details; keep your
+ * dependency surface on the exports below so upgrades stay drop-in.
+ */
+export { renderChart, closeBrowser, rendererStats, Renderer } from './renderer';
+export type { RenderResult, ConsoleMessage, RendererConfig, RendererStats } from './renderer';
+export type { RenderOptions } from './template';
+export { computeHash } from './cache';
+export { VERSION, NAME } from './version';
+/**
+ * The exact Chart.js + plugin versions bundled into the rendering
+ * page. Frozen as a reference table so callers can expose "what's
+ * inside this chartjs2img?" to their own users without parsing
+ * `chartjs2img llm`.
+ */
+export { LIBS as BUNDLED_LIBS } from './template';
+//# sourceMappingURL=lib.d.ts.map

package/dist/lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAQH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC/E,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG7F,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAI/C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAIrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEzC;;;;;GAKG;AACH,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,YAAY,CAAA"}

package/dist/lib.js

@@ -0,0 +1,48 @@
+/**
+ * chartjs2img — TypeScript / Node library entry.
+ *
+ * Import this file to render Chart.js configurations to images from
+ * any Bun / Node program:
+ *
+ *     import { renderChart, closeBrowser } from 'chartjs2img'
+ *
+ *     const result = await renderChart({
+ *       chart: { type: 'bar', data: { labels: ['A','B'], datasets: [{ data: [1,2] }] } },
+ *       width: 800, height: 600, format: 'png',
+ *     })
+ *     await Bun.write('chart.png', result.buffer)
+ *     if (result.messages.length) console.warn(result.messages)
+ *     await closeBrowser() // on process shutdown
+ *
+ * The `chartjs2img` CLI (`src/index.ts`) and the HTTP server
+ * (`src/server.ts`) share the same render pipeline but import it
+ * directly from ./renderer etc. — NOT from this file. That way the
+ * public surface exported here is a constraint for external consumers
+ * only, and internal refactoring does not have to preserve it.
+ *
+ * This module intentionally **does not** export the in-memory cache
+ * internals, the Puppeteer launch helpers, the HTML template, or the
+ * CLI argument parser. Those are implementation details; keep your
+ * dependency surface on the exports below so upgrades stay drop-in.
+ */
+// Core render pipeline. Most callers just need the module-level
+// renderChart / closeBrowser helpers, which back onto a lazily-created
+// default Renderer. Advanced callers (test harnesses, multi-tenant
+// servers that want isolated browser pools, or programs that want to
+// configure concurrency per-instance) can instantiate `Renderer`
+// directly.
+export { renderChart, closeBrowser, rendererStats, Renderer } from './renderer';
+// Deterministic hash computation — useful for building a CDN-facing
+// cache layer or for deduping submissions before rendering.
+export { computeHash } from './cache';
+// Identification. `VERSION` is the value the CLI reports and the
+// X-Powered-By HTTP header surfaces.
+export { VERSION, NAME } from './version';
+/**
+ * The exact Chart.js + plugin versions bundled into the rendering
+ * page. Frozen as a reference table so callers can expose "what's
+ * inside this chartjs2img?" to their own users without parsing
+ * `chartjs2img llm`.
+ */
+export { LIBS as BUNDLED_LIBS } from './template';
+//# sourceMappingURL=lib.js.map

package/dist/lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,gEAAgE;AAChE,uEAAuE;AACvE,mEAAmE;AACnE,qEAAqE;AACrE,iEAAiE;AACjE,YAAY;AACZ,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAM/E,oEAAoE;AACpE,4DAA4D;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAErC,iEAAiE;AACjE,qCAAqC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEzC;;;;;GAKG;AACH,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,YAAY,CAAA"}

package/dist/renderer.d.ts

@@ -0,0 +1,76 @@
+import { type RenderOptions } from './template';
+export interface ConsoleMessage {
+    level: 'error' | 'warn' | 'info' | 'log';
+    message: string;
+}
+export interface RenderResult {
+    buffer: Buffer;
+    hash: string;
+    contentType: string;
+    cached: boolean;
+    /** Console messages (errors/warnings) from Chart.js during rendering */
+    messages: ConsoleMessage[];
+}
+export interface RendererConfig {
+    /** Max simultaneous renders. Defaults to CONCURRENCY env or 8. */
+    maxConcurrency?: number;
+    /**
+     * Hard upper bound on a single render (applied to page.goto and
+     * page.waitForFunction). Defaults to MAX_RENDER_TIME_SECONDS env or
+     * 30s. Chart rendering itself is sub-second; 30s accommodates slow
+     * CDN fetches of Chart.js + plugins on cold start.
+     */
+    maxRenderTimeMs?: number;
+    /**
+     * Safety-net timeout for force-closing a page if the render flow
+     * somehow never reaches its finally block. This is a LAST-RESORT
+     * leak guard, not a render budget — the per-render timeout above is
+     * what you want to tune for slow environments.
+     *
+     * Defaults to `maxRenderTimeMs * 2 + 10s`, which leaves room for
+     * both goto and waitForFunction to fail with their own timeout and
+     * still have the finally block clean up before this fires. Can be
+     * overridden via PAGE_TIMEOUT_SECONDS env for legacy operators.
+     */
+    pageSafetyNetMs?: number;
+}
+export interface RendererStats {
+    browserConnected: boolean;
+    concurrency: {
+        max: number;
+        active: number;
+        pending: number;
+    };
+    activePages: number;
+    /** Rendering-budget timeout (goto + waitForFunction) in seconds. */
+    maxRenderTimeSeconds: number;
+    /** Last-resort page force-close timer in seconds. Always > maxRenderTimeSeconds. */
+    pageSafetyNetSeconds: number;
+    /**
+     * @deprecated alias of pageSafetyNetSeconds for /health consumers
+     * that shipped before the field was renamed. Will be removed.
+     */
+    pageTimeoutSeconds: number;
+}
+export declare class Renderer {
+    private readonly maxConcurrency;
+    private readonly maxRenderTimeMs;
+    private readonly pageSafetyNetMs;
+    private readonly semaphore;
+    private browser;
+    private launching;
+    private launchPromise;
+    private readonly activePages;
+    constructor(config?: RendererConfig);
+    private launchBrowser;
+    private ensureBrowser;
+    private schedulePageCleanup;
+    private clearPageCleanup;
+    render(options: RenderOptions): Promise<RenderResult>;
+    close(): Promise<void>;
+    stats(): RendererStats;
+}
+export declare function renderChart(options: RenderOptions): Promise<RenderResult>;
+export declare function closeBrowser(): Promise<void>;
+export declare function rendererStats(): RendererStats;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAaA,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,YAAY,CAAA;AAS1D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;IACxC,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,OAAO,CAAA;IACf,wEAAwE;IACxE,QAAQ,EAAE,cAAc,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,OAAO,CAAA;IACzB,WAAW,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7D,WAAW,EAAE,MAAM,CAAA;IACnB,oEAAoE;IACpE,oBAAoB,EAAE,MAAM,CAAA;IAC5B,oFAAoF;IACpF,oBAAoB,EAAE,MAAM,CAAA;IAC5B;;;OAGG;IACH,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AA+BD,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IAErC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,aAAa,CAAgC;IAKrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkC;gBAElD,MAAM,GAAE,cAAmB;YASzB,aAAa;YAmBb,aAAa;IA6B3B,OAAO,CAAC,mBAAmB;IAkB3B,OAAO,CAAC,gBAAgB;IAUlB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA2GrD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B,KAAK,IAAI,aAAa;CAWvB;AAaD,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAE/E;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAKlD;AAED,wBAAgB,aAAa,IAAI,aAAa,CAa7C"}