@phi-code-admin/camofox-browser 1.0.0 → 1.0.2

package/lib/downloads.js

@@ -1,168 +1,168 @@
-/**
- * Download capture and DOM image extraction for camofox-browser.
- *
- * Handles Playwright download events, temp file lifecycle, and
- * in-page image source extraction with optional inline data.
- */
-
-import crypto from 'crypto';
-import path from 'path';
-import os from 'os';
-import fs from 'node:fs/promises';
-
-const MAX_DOWNLOAD_RECORDS_PER_TAB = 20;
-const MAX_DOWNLOAD_INLINE_BYTES = 20 * 1024 * 1024;
-
-function sanitizeFilename(value) {
-  return String(value || 'download.bin')
-    .replace(/[\\/:*?"<>|\u0000-\u001F]/g, '_')
-    .trim()
-    .slice(0, 200) || 'download.bin';
-}
-
-function guessMimeTypeFromName(value) {
-  const normalized = String(value || '').toLowerCase();
-  if (normalized.endsWith('.png')) return 'image/png';
-  if (normalized.endsWith('.jpg') || normalized.endsWith('.jpeg')) return 'image/jpeg';
-  if (normalized.endsWith('.webp')) return 'image/webp';
-  if (normalized.endsWith('.gif')) return 'image/gif';
-  if (normalized.endsWith('.svg')) return 'image/svg+xml';
-  return 'application/octet-stream';
-}
-
-async function removeDownloadFileIfPresent(record) {
-  const filePath = record?.filePath;
-  if (!filePath) return;
-  await fs.unlink(filePath).catch(() => {});
-}
-
-async function trimTabDownloads(tabState) {
-  while (tabState.downloads.length > MAX_DOWNLOAD_RECORDS_PER_TAB) {
-    const stale = tabState.downloads.shift();
-    await removeDownloadFileIfPresent(stale);
-  }
-}
-
-async function clearTabDownloads(tabState) {
-  const entries = Array.isArray(tabState.downloads) ? [...tabState.downloads] : [];
-  tabState.downloads = [];
-  await Promise.all(entries.map(removeDownloadFileIfPresent));
-}
-
-async function clearSessionDownloads(session) {
-  if (!session || !session.tabGroups) return;
-  const tasks = [];
-  for (const group of session.tabGroups.values()) {
-    for (const tabState of group.values()) {
-      tasks.push(clearTabDownloads(tabState));
-    }
-  }
-  await Promise.all(tasks);
-}
-
-function attachDownloadListener(tabState, tabId, log, pluginEvents, userId) {
-  if (tabState.downloadListenerAttached) return;
-  tabState.downloadListenerAttached = true;
-
-  tabState.page.on('download', async (download) => {
-    const downloadId = crypto.randomUUID();
-    const suggestedFilename = sanitizeFilename(download.suggestedFilename?.() || `download-${downloadId}.bin`);
-    const filePath = path.join(os.tmpdir(), `camofox-download-${downloadId}-${suggestedFilename}`);
-
-    const url = String(download.url?.() || '').trim();
-    if (pluginEvents) {
-      pluginEvents.emit('tab:download:start', { userId: userId || null, tabId, filename: suggestedFilename, url });
-    }
-
-    let failure = null;
-    let bytes = null;
-
-    try {
-      await download.saveAs(filePath);
-      const stat = await fs.stat(filePath);
-      bytes = stat.size;
-    } catch (err) {
-      failure = String(err?.message || err || 'download_save_failed');
-      await fs.unlink(filePath).catch(() => {});
-    }
-
-    const reportedFailure = await download.failure().catch(() => null);
-    if (reportedFailure) {
-      failure = reportedFailure;
-    }
-
-    if (url) {
-      tabState.visitedUrls.add(url);
-    }
-
-    const mimeType = guessMimeTypeFromName(suggestedFilename) || guessMimeTypeFromName(url);
-    tabState.downloads.push({
-      id: downloadId,
-      tabId,
-      url,
-      suggestedFilename,
-      mimeType,
-      bytes,
-      createdAt: new Date().toISOString(),
-      filePath: failure ? null : filePath,
-      failure,
-    });
-
-    if (pluginEvents && !failure) {
-      pluginEvents.emit('tab:download:complete', { userId: userId || null, tabId, filename: suggestedFilename, path: filePath, size: bytes });
-    }
-
-    await trimTabDownloads(tabState);
-    log('info', 'download captured', {
-      tabId, downloadId, suggestedFilename, mimeType, bytes,
-      hasUrl: Boolean(url), failure,
-    });
-  });
-}
-
-/**
- * Build the response array for GET /tabs/:tabId/downloads.
- */
-async function getDownloadsList(tabState, { includeData = false, maxBytes = MAX_DOWNLOAD_INLINE_BYTES } = {}) {
-  const snapshot = Array.isArray(tabState.downloads) ? [...tabState.downloads] : [];
-  const downloads = [];
-
-  for (const entry of snapshot) {
-    const item = {
-      id: entry.id,
-      url: entry.url,
-      suggestedFilename: entry.suggestedFilename,
-      mimeType: entry.mimeType,
-      bytes: entry.bytes,
-      createdAt: entry.createdAt,
-      failure: entry.failure,
-    };
-
-    if (includeData && entry.filePath && !entry.failure) {
-      if (typeof entry.bytes === 'number' && entry.bytes > maxBytes) {
-        item.dataSkipped = 'max_bytes_exceeded';
-      } else {
-        try {
-          const raw = await fs.readFile(entry.filePath);
-          item.dataBase64 = raw.toString('base64');
-        } catch (err) {
-          item.readError = String(err?.message || err || 'download_read_failed');
-        }
-      }
-    }
-
-    downloads.push(item);
-  }
-
-  return downloads;
-}
-
-export {
-  MAX_DOWNLOAD_INLINE_BYTES,
-  sanitizeFilename,
-  guessMimeTypeFromName,
-  clearTabDownloads,
-  clearSessionDownloads,
-  attachDownloadListener,
-  getDownloadsList,
-};
+/**
+ * Download capture and DOM image extraction for camofox-browser.
+ *
+ * Handles Playwright download events, temp file lifecycle, and
+ * in-page image source extraction with optional inline data.
+ */
+
+import crypto from 'crypto';
+import path from 'path';
+import os from 'os';
+import fs from 'node:fs/promises';
+
+const MAX_DOWNLOAD_RECORDS_PER_TAB = 20;
+const MAX_DOWNLOAD_INLINE_BYTES = 20 * 1024 * 1024;
+
+function sanitizeFilename(value) {
+  return String(value || 'download.bin')
+    .replace(/[\\/:*?"<>|\u0000-\u001F]/g, '_')
+    .trim()
+    .slice(0, 200) || 'download.bin';
+}
+
+function guessMimeTypeFromName(value) {
+  const normalized = String(value || '').toLowerCase();
+  if (normalized.endsWith('.png')) return 'image/png';
+  if (normalized.endsWith('.jpg') || normalized.endsWith('.jpeg')) return 'image/jpeg';
+  if (normalized.endsWith('.webp')) return 'image/webp';
+  if (normalized.endsWith('.gif')) return 'image/gif';
+  if (normalized.endsWith('.svg')) return 'image/svg+xml';
+  return 'application/octet-stream';
+}
+
+async function removeDownloadFileIfPresent(record) {
+  const filePath = record?.filePath;
+  if (!filePath) return;
+  await fs.unlink(filePath).catch(() => {});
+}
+
+async function trimTabDownloads(tabState) {
+  while (tabState.downloads.length > MAX_DOWNLOAD_RECORDS_PER_TAB) {
+    const stale = tabState.downloads.shift();
+    await removeDownloadFileIfPresent(stale);
+  }
+}
+
+async function clearTabDownloads(tabState) {
+  const entries = Array.isArray(tabState.downloads) ? [...tabState.downloads] : [];
+  tabState.downloads = [];
+  await Promise.all(entries.map(removeDownloadFileIfPresent));
+}
+
+async function clearSessionDownloads(session) {
+  if (!session || !session.tabGroups) return;
+  const tasks = [];
+  for (const group of session.tabGroups.values()) {
+    for (const tabState of group.values()) {
+      tasks.push(clearTabDownloads(tabState));
+    }
+  }
+  await Promise.all(tasks);
+}
+
+function attachDownloadListener(tabState, tabId, log, pluginEvents, userId) {
+  if (tabState.downloadListenerAttached) return;
+  tabState.downloadListenerAttached = true;
+
+  tabState.page.on('download', async (download) => {
+    const downloadId = crypto.randomUUID();
+    const suggestedFilename = sanitizeFilename(download.suggestedFilename?.() || `download-${downloadId}.bin`);
+    const filePath = path.join(os.tmpdir(), `camofox-download-${downloadId}-${suggestedFilename}`);
+
+    const url = String(download.url?.() || '').trim();
+    if (pluginEvents) {
+      pluginEvents.emit('tab:download:start', { userId: userId || null, tabId, filename: suggestedFilename, url });
+    }
+
+    let failure = null;
+    let bytes = null;
+
+    try {
+      await download.saveAs(filePath);
+      const stat = await fs.stat(filePath);
+      bytes = stat.size;
+    } catch (err) {
+      failure = String(err?.message || err || 'download_save_failed');
+      await fs.unlink(filePath).catch(() => {});
+    }
+
+    const reportedFailure = await download.failure().catch(() => null);
+    if (reportedFailure) {
+      failure = reportedFailure;
+    }
+
+    if (url) {
+      tabState.visitedUrls.add(url);
+    }
+
+    const mimeType = guessMimeTypeFromName(suggestedFilename) || guessMimeTypeFromName(url);
+    tabState.downloads.push({
+      id: downloadId,
+      tabId,
+      url,
+      suggestedFilename,
+      mimeType,
+      bytes,
+      createdAt: new Date().toISOString(),
+      filePath: failure ? null : filePath,
+      failure,
+    });
+
+    if (pluginEvents && !failure) {
+      pluginEvents.emit('tab:download:complete', { userId: userId || null, tabId, filename: suggestedFilename, path: filePath, size: bytes });
+    }
+
+    await trimTabDownloads(tabState);
+    log('info', 'download captured', {
+      tabId, downloadId, suggestedFilename, mimeType, bytes,
+      hasUrl: Boolean(url), failure,
+    });
+  });
+}
+
+/**
+ * Build the response array for GET /tabs/:tabId/downloads.
+ */
+async function getDownloadsList(tabState, { includeData = false, maxBytes = MAX_DOWNLOAD_INLINE_BYTES } = {}) {
+  const snapshot = Array.isArray(tabState.downloads) ? [...tabState.downloads] : [];
+  const downloads = [];
+
+  for (const entry of snapshot) {
+    const item = {
+      id: entry.id,
+      url: entry.url,
+      suggestedFilename: entry.suggestedFilename,
+      mimeType: entry.mimeType,
+      bytes: entry.bytes,
+      createdAt: entry.createdAt,
+      failure: entry.failure,
+    };
+
+    if (includeData && entry.filePath && !entry.failure) {
+      if (typeof entry.bytes === 'number' && entry.bytes > maxBytes) {
+        item.dataSkipped = 'max_bytes_exceeded';
+      } else {
+        try {
+          const raw = await fs.readFile(entry.filePath);
+          item.dataBase64 = raw.toString('base64');
+        } catch (err) {
+          item.readError = String(err?.message || err || 'download_read_failed');
+        }
+      }
+    }
+
+    downloads.push(item);
+  }
+
+  return downloads;
+}
+
+export {
+  MAX_DOWNLOAD_INLINE_BYTES,
+  sanitizeFilename,
+  guessMimeTypeFromName,
+  clearTabDownloads,
+  clearSessionDownloads,
+  attachDownloadListener,
+  getDownloadsList,
+};

package/lib/extract.js

@@ -1,74 +1,74 @@
-const SUPPORTED_TYPES = new Set(['string', 'number', 'integer', 'boolean', 'object', 'null']);
-
-export function validateSchema(schema) {
-  if (!schema || typeof schema !== 'object') {
-    return { ok: false, error: 'schema must be an object' };
-  }
-  if (schema.type !== 'object') {
-    return { ok: false, error: 'top-level schema must have type: object' };
-  }
-  if (!schema.properties || typeof schema.properties !== 'object') {
-    return { ok: false, error: 'schema must have a properties object' };
-  }
-  for (const [prop, def] of Object.entries(schema.properties)) {
-    if (!def || typeof def !== 'object') {
-      return { ok: false, error: `property "${prop}" must be an object` };
-    }
-    if (def.type && !SUPPORTED_TYPES.has(def.type)) {
-      return { ok: false, error: `property "${prop}" has unsupported type "${def.type}"` };
-    }
-  }
-  return { ok: true };
-}
-
-function coerceValue(raw, type) {
-  if (raw == null) return null;
-  if (type === 'string' || !type) return String(raw).trim();
-  if (type === 'number') {
-    const n = parseFloat(String(raw).replace(/[^0-9.eE+-]/g, ''));
-    return Number.isFinite(n) ? n : null;
-  }
-  if (type === 'integer') {
-    const n = parseInt(String(raw).replace(/[^0-9-]/g, ''), 10);
-    return Number.isFinite(n) ? n : null;
-  }
-  if (type === 'boolean') {
-    const s = String(raw).toLowerCase().trim();
-    if (s === 'true' || s === 'yes' || s === '1') return true;
-    if (s === 'false' || s === 'no' || s === '0') return false;
-    return null;
-  }
-  return raw;
-}
-
-function extractFromRef(refs, refId) {
-  const info = refs.get(refId);
-  if (!info) return null;
-  return info.name || null;
-}
-
-export function extractDeterministic({ schema, refs }) {
-  const check = validateSchema(schema);
-  if (!check.ok) throw new Error(check.error);
-
-  const result = {};
-  for (const [prop, def] of Object.entries(schema.properties)) {
-    const refId = def['x-ref'];
-
-    let value = null;
-    if (refId) {
-      value = extractFromRef(refs, refId);
-      if (value != null && def.type && def.type !== 'object') {
-        value = coerceValue(value, def.type);
-      }
-    }
-
-    if (value == null && Array.isArray(schema.required) && schema.required.includes(prop)) {
-      throw new Error(`required property "${prop}" could not be extracted (x-ref=${refId || 'n/a'})`);
-    }
-
-    result[prop] = value;
-  }
-
-  return result;
-}
+const SUPPORTED_TYPES = new Set(['string', 'number', 'integer', 'boolean', 'object', 'null']);
+
+export function validateSchema(schema) {
+  if (!schema || typeof schema !== 'object') {
+    return { ok: false, error: 'schema must be an object' };
+  }
+  if (schema.type !== 'object') {
+    return { ok: false, error: 'top-level schema must have type: object' };
+  }
+  if (!schema.properties || typeof schema.properties !== 'object') {
+    return { ok: false, error: 'schema must have a properties object' };
+  }
+  for (const [prop, def] of Object.entries(schema.properties)) {
+    if (!def || typeof def !== 'object') {
+      return { ok: false, error: `property "${prop}" must be an object` };
+    }
+    if (def.type && !SUPPORTED_TYPES.has(def.type)) {
+      return { ok: false, error: `property "${prop}" has unsupported type "${def.type}"` };
+    }
+  }
+  return { ok: true };
+}
+
+function coerceValue(raw, type) {
+  if (raw == null) return null;
+  if (type === 'string' || !type) return String(raw).trim();
+  if (type === 'number') {
+    const n = parseFloat(String(raw).replace(/[^0-9.eE+-]/g, ''));
+    return Number.isFinite(n) ? n : null;
+  }
+  if (type === 'integer') {
+    const n = parseInt(String(raw).replace(/[^0-9-]/g, ''), 10);
+    return Number.isFinite(n) ? n : null;
+  }
+  if (type === 'boolean') {
+    const s = String(raw).toLowerCase().trim();
+    if (s === 'true' || s === 'yes' || s === '1') return true;
+    if (s === 'false' || s === 'no' || s === '0') return false;
+    return null;
+  }
+  return raw;
+}
+
+function extractFromRef(refs, refId) {
+  const info = refs.get(refId);
+  if (!info) return null;
+  return info.name || null;
+}
+
+export function extractDeterministic({ schema, refs }) {
+  const check = validateSchema(schema);
+  if (!check.ok) throw new Error(check.error);
+
+  const result = {};
+  for (const [prop, def] of Object.entries(schema.properties)) {
+    const refId = def['x-ref'];
+
+    let value = null;
+    if (refId) {
+      value = extractFromRef(refs, refId);
+      if (value != null && def.type && def.type !== 'object') {
+        value = coerceValue(value, def.type);
+      }
+    }
+
+    if (value == null && Array.isArray(schema.required) && schema.required.includes(prop)) {
+      throw new Error(`required property "${prop}" could not be extracted (x-ref=${refId || 'n/a'})`);
+    }
+
+    result[prop] = value;
+  }
+
+  return result;
+}

package/lib/fly.js

@@ -1,54 +1,54 @@
-/**
- * Fly.io horizontal scaling helpers.
- *
- * Tab IDs encode the owning machine: "{machineId}_{uuid}"
- * Requests for tabs on other machines get replayed via fly-replay header.
- *
- * When not running on Fly (no FLY_MACHINE_ID), all helpers are no-ops:
- * makeTabId() returns a plain UUID and isLocalTab() always returns true.
- */
-
-import crypto from 'crypto';
-
-export function createFlyHelpers(config) {
-  const machineId = config.flyMachineId || '';
-
-  function makeTabId() {
-    const uuid = crypto.randomUUID();
-    return machineId ? `${machineId}_${uuid}` : uuid;
-  }
-
-  function parseTabOwner(tabId) {
-    if (!machineId || !tabId) return null;
-    const idx = tabId.indexOf('_');
-    if (idx === -1) return null; // legacy tab ID (no machine prefix)
-    const candidate = tabId.slice(0, idx);
-    // Fly machine IDs are hex strings (14 chars). UUIDs start with 8 hex chars then '-'.
-    // If the candidate contains '-', it's a UUID segment, not a machine ID.
-    if (candidate.includes('-')) return null;
-    return candidate;
-  }
-
-  function isLocalTab(tabId) {
-    const owner = parseTabOwner(tabId);
-    return owner === null || owner === machineId;
-  }
-
-  /**
-   * Express middleware: replay requests for tabs owned by other machines.
-   * No-op when not running on Fly.
-   */
-  function replayMiddleware(log) {
-    return (req, res, next) => {
-      if (!machineId) return next();
-      const tabId = req.params.tabId;
-      if (!tabId || isLocalTab(tabId)) return next();
-      const owner = parseTabOwner(tabId);
-      log('info', 'fly-replay', { reqId: req.reqId, tabId, owner, self: machineId });
-      res.set('fly-replay', `instance=${owner}`);
-      res.status(307).send();
-    };
-  }
-
-  return { machineId, makeTabId, parseTabOwner, isLocalTab, replayMiddleware };
-}
+/**
+ * Fly.io horizontal scaling helpers.
+ *
+ * Tab IDs encode the owning machine: "{machineId}_{uuid}"
+ * Requests for tabs on other machines get replayed via fly-replay header.
+ *
+ * When not running on Fly (no FLY_MACHINE_ID), all helpers are no-ops:
+ * makeTabId() returns a plain UUID and isLocalTab() always returns true.
+ */
+
+import crypto from 'crypto';
+
+export function createFlyHelpers(config) {
+  const machineId = config.flyMachineId || '';
+
+  function makeTabId() {
+    const uuid = crypto.randomUUID();
+    return machineId ? `${machineId}_${uuid}` : uuid;
+  }
+
+  function parseTabOwner(tabId) {
+    if (!machineId || !tabId) return null;
+    const idx = tabId.indexOf('_');
+    if (idx === -1) return null; // legacy tab ID (no machine prefix)
+    const candidate = tabId.slice(0, idx);
+    // Fly machine IDs are hex strings (14 chars). UUIDs start with 8 hex chars then '-'.
+    // If the candidate contains '-', it's a UUID segment, not a machine ID.
+    if (candidate.includes('-')) return null;
+    return candidate;
+  }
+
+  function isLocalTab(tabId) {
+    const owner = parseTabOwner(tabId);
+    return owner === null || owner === machineId;
+  }
+
+  /**
+   * Express middleware: replay requests for tabs owned by other machines.
+   * No-op when not running on Fly.
+   */
+  function replayMiddleware(log) {
+    return (req, res, next) => {
+      if (!machineId) return next();
+      const tabId = req.params.tabId;
+      if (!tabId || isLocalTab(tabId)) return next();
+      const owner = parseTabOwner(tabId);
+      log('info', 'fly-replay', { reqId: req.reqId, tabId, owner, self: machineId });
+      res.set('fly-replay', `instance=${owner}`);
+      res.status(307).send();
+    };
+  }
+
+  return { machineId, makeTabId, parseTabOwner, isLocalTab, replayMiddleware };
+}