heroshot 0.17.0 → 0.19.0

package/dist/{snippet-Cm6b-EdU.js → snippet-ZcZmuryj.js}

@@ -9,7 +9,6 @@ import { homedir, platform } from "node:os";
 import { chromium } from "playwright";
 import { execSync } from "node:child_process";
 import pLimit from "p-limit";
-
 //#region src/ui.ts
 /**
 * Terminal UI using @clack/prompts
@@ -83,7 +82,6 @@ function spinner$1() {
 function log$1(text) {
 	console.log(text);
 }
-
 //#endregion
 //#region src/actionSchema.ts
 /**
@@ -211,7 +209,6 @@ const actionSchema = z.discriminatedUnion("type", [
 ]);
 /** Array of actions to execute sequentially before screenshot capture */
 const actionsSchema = z.array(actionSchema).describe("Ordered list of actions to execute before capturing. Actions run sequentially.");
-
 //#endregion
 //#region src/utils/generateUid.ts
 /**
@@ -221,7 +218,6 @@ const actionsSchema = z.array(actionSchema).describe("Ordered list of actions to
 function generateUid() {
 	return crypto.randomUUID().slice(0, 8);
 }
-
 //#endregion
 //#region src/schema.ts
 /**
@@ -335,33 +331,8 @@ const browserSchema = z.object({
 	deviceScaleFactor: z.number().min(1).max(3).optional().describe("Device pixel ratio (1 = standard, 2 = retina, 3 = ultra-high DPI)"),
 	bypassCSP: z.boolean().optional().describe("Bypass Content-Security-Policy restrictions. Enabled by default for reliable page.evaluate() calls"),
 	reducedMotion: z.enum(["reduce", "no-preference"]).optional().describe("Emulate prefers-reduced-motion media feature. Use \"reduce\" to disable animations"),
-	userAgent: z.string().optional().describe("Custom user agent string for the browser")
-});
-/** Shared CLI options for URL capture */
-const shotCliOptionsSchema = z.object({
-	selector: z.array(z.string()).optional(),
-	output: z.string().optional(),
-	padding: z.number().int().min(0).optional(),
-	width: z.number().int().positive().optional(),
-	height: z.number().int().positive().optional(),
-	mobile: z.boolean().optional(),
-	tablet: z.boolean().optional(),
-	desktop: z.boolean().optional(),
-	dark: z.boolean().optional(),
-	light: z.boolean().optional(),
-	scale: z.number().min(1).max(3).optional(),
-	retina: z.boolean().optional(),
-	quality: z.number().int().min(1).max(100).optional(),
-	viewportOnly: z.boolean().optional(),
-	reducedMotion: z.boolean().optional(),
-	userAgent: z.string().optional()
-});
-/** CLI command options for URL capture (includes --save and --clean flags) */
-const shotCommandOptionsSchema = shotCliOptionsSchema.extend({
-	save: z.boolean().optional(),
-	clean: z.boolean().optional(),
-	workers: z.number().int().min(1).optional(),
-	headed: z.boolean().optional()
+	userAgent: z.string().optional().describe("Custom user agent string for the browser"),
+	ignoreHTTPSErrors: z.boolean().optional().describe("Ignore TLS certificate errors (self-signed certs, custom CA). Dev-only setting")
 });
 /** Global config */
 const configSchema = z.object({
@@ -374,7 +345,6 @@ const configSchema = z.object({
 	hiddenElements: z.record(z.string(), z.array(z.string())).optional().describe("Elements to hide per domain (hostname → CSS selectors)"),
 	locales: z.array(z.string().min(1)).optional().describe("Locale codes (e.g., [\"en\", \"de\"]).")
 });
-
 //#endregion
 //#region src/config.ts
 /**
@@ -385,7 +355,6 @@ const configSchema = z.object({
 function parseConfig(input) {
 	return configSchema.parse(input);
 }
-
 //#endregion
 //#region src/configFile.ts
 const HEROSHOT_DIRECTORY_NAME = ".heroshot";
@@ -426,7 +395,6 @@ function saveConfig(configPath, config) {
 	if (!existsSync(parentDirectory)) mkdirSync(parentDirectory, { recursive: true });
 	writeFileSync(configPath, JSON.stringify(config, null, 2), "utf8");
 }
-
 //#endregion
 //#region src/session.ts
 const SESSION_FILENAME = "session.enc";
@@ -434,7 +402,6 @@ const KEYS_DIRECTORY = path.join(homedir(), ".heroshot", "keys");
 const ALGORITHM = "aes-256-gcm";
 const KEY_LENGTH = 32;
 const IV_LENGTH = 16;
-const AUTH_TAG_LENGTH = 16;
 const SALT_LENGTH = 16;
 const SESSION_KEY_LENGTH = 20;
 /**
@@ -473,9 +440,9 @@ function encrypt(data, sessionKey) {
 */
 function decrypt(encryptedData, sessionKey) {
 	const salt = encryptedData.subarray(0, SALT_LENGTH);
-	const iv = encryptedData.subarray(SALT_LENGTH, SALT_LENGTH + IV_LENGTH);
-	const authTag = encryptedData.subarray(SALT_LENGTH + IV_LENGTH, SALT_LENGTH + IV_LENGTH + AUTH_TAG_LENGTH);
-	const ciphertext = encryptedData.subarray(SALT_LENGTH + IV_LENGTH + AUTH_TAG_LENGTH);
+	const iv = encryptedData.subarray(SALT_LENGTH, 32);
+	const authTag = encryptedData.subarray(32, 48);
+	const ciphertext = encryptedData.subarray(48);
 	const decipher = createDecipheriv(ALGORITHM, deriveKey(sessionKey, salt), iv);
 	decipher.setAuthTag(authTag);
 	return Buffer.concat([decipher.update(ciphertext), decipher.final()]).toString("utf8");
@@ -559,7 +526,6 @@ function getSessionKey(cliKey, directory = process.cwd()) {
 	if (environmentKey) return environmentKey;
 	return loadLocalKey(directory);
 }
-
 //#endregion
 //#region src/browser/constants.ts
 /** Default viewport dimensions */
@@ -581,7 +547,6 @@ function findPackageRoot(startDirectory) {
 }
 /** Path to editor directory */
 const EDITOR_DIR = path.join(findPackageRoot(path.dirname(fileURLToPath(import.meta.url))), "editor");
-
 //#endregion
 //#region src/browser/browserDetect.ts
 /**
@@ -661,7 +626,6 @@ function detectSystemBrowsers() {
 	}
 	return detected;
 }
-
 //#endregion
 //#region src/browser/noBrowserError.ts
 /**
@@ -683,7 +647,6 @@ function noBrowserError() {
 	].join("\n");
 	return new Error(message);
 }
-
 //#endregion
 //#region src/browser/launchBrowser.ts
 /**
@@ -733,6 +696,7 @@ async function launchBrowser(options = {}) {
 		...options.colorScheme && { colorScheme: options.colorScheme },
 		...options.reducedMotion && { reducedMotion: options.reducedMotion },
 		...options.userAgent && { userAgent: options.userAgent },
+		...options.ignoreHTTPSErrors && { ignoreHTTPSErrors: true },
 		...options.locale && { locale: options.locale },
 		...options.locale && { extraHTTPHeaders: { "Accept-Language": options.locale } }
 	});
@@ -741,7 +705,6 @@ async function launchBrowser(options = {}) {
 		context
 	};
 }
-
 //#endregion
 //#region src/utils/getColorSchemes.ts
 /**
@@ -755,7 +718,6 @@ function getColorSchemes(setting) {
 	if (setting === "dark") return ["dark"];
 	return ["light", "dark"];
 }
-
 //#endregion
 //#region src/sync/configHelpers.ts
 /**
@@ -814,10 +776,10 @@ function buildBrowserOptions(config) {
 		deviceScaleFactor: config.browser?.deviceScaleFactor,
 		bypassCSP: config.browser?.bypassCSP,
 		reducedMotion: config.browser?.reducedMotion,
-		userAgent: config.browser?.userAgent
+		userAgent: config.browser?.userAgent,
+		ignoreHTTPSErrors: config.browser?.ignoreHTTPSErrors
 	};
 }
-
 //#endregion
 //#region src/utils/localeUrl.ts
 /**
@@ -834,7 +796,6 @@ function buildBrowserOptions(config) {
 function applyLocale(url, locale) {
 	return url.replaceAll("{locale}", locale);
 }
-
 //#endregion
 //#region src/utils/parseViewport.ts
 /**
@@ -868,7 +829,6 @@ function parseViewport(variant) {
 		...VIEWPORT_PRESETS.desktop
 	};
 }
-
 //#endregion
 //#region src/utils/screenshotPath.ts
 /**
@@ -893,7 +853,6 @@ function generateScreenshotFilename(options) {
 	const pathWithDirectory = directory ? `${directory}/${filename}` : filename;
 	return locale ? `${locale}/${pathWithDirectory}` : pathWithDirectory;
 }
-
 //#endregion
 //#region src/sync/actions/click.ts
 /** MCP: locator.click(options) or locator.dblclick(options) */
@@ -908,7 +867,6 @@ async function executeClick(page, action) {
 		await (action.doubleClick ? locator.dblclick(options) : locator.click(options));
 	} else await (action.doubleClick ? locator.dblclick() : locator.click());
 }
-
 //#endregion
 //#region src/sync/actions/drag.ts
 /** MCP: startLocator.dragTo(endLocator) */
@@ -918,7 +876,6 @@ async function executeDrag(page, action) {
 	const to = page.locator(action.to);
 	await (action.timeout ? from.dragTo(to, { timeout: action.timeout }) : from.dragTo(to));
 }
-
 //#endregion
 //#region src/sync/actions/evaluate.ts
 /**
@@ -933,7 +890,6 @@ async function executeEvaluate(page, action) {
 		await page.evaluate(`(${action.function})(document.querySelector('${escapedSelector}'))`);
 	} else await page.evaluate(`(${action.function})()`);
 }
-
 //#endregion
 //#region src/sync/actions/fileUpload.ts
 /** MCP: locator.setInputFiles(paths) */
@@ -941,7 +897,6 @@ async function executeFileUpload(page, action) {
 	if (action.type !== "file_upload") return;
 	await page.locator(action.selector).setInputFiles(action.paths);
 }
-
 //#endregion
 //#region src/sync/actions/fillForm.ts
 /** MCP: locator.fill / setChecked / check / selectOption per field type */
@@ -967,7 +922,6 @@ async function executeFillForm(page, action) {
 		}[field.fieldType]?.();
 	}
 }
-
 //#endregion
 //#region src/sync/actions/handleDialog.ts
 /** MCP: Sets up a one-time dialog handler for the next dialog */
@@ -978,7 +932,6 @@ function executeHandleDialog(page, action) {
 		await (accept ? dialog.accept(promptText) : dialog.dismiss());
 	});
 }
-
 //#endregion
 //#region src/sync/actions/hide.ts
 /** Hide elements by setting visibility: hidden (preserves layout) */
@@ -988,7 +941,6 @@ async function executeHide(page, action) {
 		for (const element of elements) element.style.setProperty("visibility", "hidden", "important");
 	});
 }
-
 //#endregion
 //#region src/sync/actions/hover.ts
 /** MCP: locator.hover() */
@@ -997,7 +949,6 @@ async function executeHover(page, action) {
 	const locator = page.locator(action.selector);
 	await (action.timeout ? locator.hover({ timeout: action.timeout }) : locator.hover());
 }
-
 //#endregion
 //#region src/sync/actions/navigate.ts
 /** MCP: page.goto(url) or page.goBack() */
@@ -1006,7 +957,6 @@ async function executeNavigate(page, action) {
 	if (action.back) await page.goBack();
 	else if (action.url) await page.goto(action.url, { waitUntil: "domcontentloaded" });
 }
-
 //#endregion
 //#region src/sync/actions/pressKey.ts
 /** MCP: page.keyboard.press(key) */
@@ -1014,7 +964,6 @@ async function executePressKey(page, action) {
 	if (action.type !== "press_key") return;
 	await page.keyboard.press(action.key);
 }
-
 //#endregion
 //#region src/sync/actions/resize.ts
 /** MCP: page.setViewportSize({ width, height }) */
@@ -1025,7 +974,6 @@ async function executeResize(page, action) {
 		height: action.height
 	});
 }
-
 //#endregion
 //#region src/sync/actions/selectOption.ts
 /** MCP: locator.selectOption(values) */
@@ -1034,7 +982,6 @@ async function executeSelectOption(page, action) {
 	const locator = page.locator(action.selector);
 	await (action.timeout ? locator.selectOption(action.values, { timeout: action.timeout }) : locator.selectOption(action.values));
 }
-
 //#endregion
 //#region src/sync/actions/type.ts
 /** MCP: locator.fill(text) or locator.pressSequentially(text) */
@@ -1047,7 +994,6 @@ async function executeType(page, action) {
 	} else await (action.slowly ? locator.pressSequentially(action.text) : locator.fill(action.text));
 	if (action.submit) await page.keyboard.press("Enter");
 }
-
 //#endregion
 //#region src/sync/actions/wait.ts
 /** MCP: waitForTimeout / getByText().waitFor() */
@@ -1057,7 +1003,6 @@ async function executeWait(page, action) {
 	if (action.text) await page.getByText(action.text).first().waitFor({ state: "visible" });
 	if (action.textGone) await page.getByText(action.textGone).first().waitFor({ state: "hidden" });
 }
-
 //#endregion
 //#region src/sync/actions/index.ts
 /** Dispatch map: action type -> handler function */
@@ -1087,7 +1032,6 @@ async function executeActions(page, actions) {
 		await actionHandlers[action.type](page, action);
 	}
 }
-
 //#endregion
 //#region src/sync/annotationOverlay.ts
 const OVERLAY_ID$1 = "heroshot-annotation-overlay";
@@ -1268,7 +1212,6 @@ async function removeAnnotationOverlay(page) {
       if (existing) existing.remove();
     })()`);
 }
-
 //#endregion
 //#region src/sync/borderOverlay.ts
 const OVERLAY_ID = "heroshot-border-overlay";
@@ -1310,7 +1253,6 @@ async function removeBorderOverlay(page) {
       if (el) el.remove();
     })()`);
 }
-
 //#endregion
 //#region src/sync/borderRadiusMask.ts
 /**
@@ -1391,7 +1333,6 @@ async function removeBorderRadiusMask(page) {
       }
     })()`);
 }
-
 //#endregion
 //#region src/sync/elementFinder.ts
 /**
@@ -1421,7 +1362,6 @@ async function findElement(page, selector, maxAttempts = 10, intervalMs = 500) {
 	}
 	return null;
 }
-
 //#endregion
 //#region src/sync/paddingMask.ts
 const MASK_ID = "heroshot-padding-mask";
@@ -1486,7 +1426,6 @@ async function removePaddingMask(page) {
       if (existing) existing.remove();
     })()`);
 }
-
 //#endregion
 //#region src/sync/browserFunctions.ts
 /**
@@ -1506,7 +1445,6 @@ async function removePaddingMask(page) {
 function applyColorScheme(isDark) {
 	document.documentElement.classList.toggle("dark", isDark);
 }
-
 //#endregion
 //#region src/sync/pageScripts.ts
 /**
@@ -1606,7 +1544,6 @@ async function getElementBackgroundColor(page, selector) {
 async function applyColorSchemeClass(page, colorScheme) {
 	await page.evaluate(applyColorScheme, colorScheme === "dark");
 }
-
 //#endregion
 //#region src/sync/screenshot.ts
 /**
@@ -1650,7 +1587,6 @@ async function takeScreenshot(options) {
 		omitBackground
 	});
 }
-
 //#endregion
 //#region src/sync/elementCapture.ts
 /**
@@ -1762,7 +1698,6 @@ async function captureElementScreenshot(options) {
 	if (elementFill === "solid" || elementFill === "transparent") await restoreElementBackground(page, selector);
 	return { success: true };
 }
-
 //#endregion
 //#region src/sync/results.ts
 /**
@@ -1812,7 +1747,6 @@ function showResults(results, outputDirectory, staleFiles, deletedFiles) {
 		deletedFiles: deletedFiles.length > 0 ? deletedFiles : void 0
 	};
 }
-
 //#endregion
 //#region src/sync/capture.ts
 /**
@@ -1967,7 +1901,6 @@ async function captureAndLog(page, screenshot, outputDirectory, captureOptions,
 		error: result.error
 	};
 }
-
 //#endregion
 //#region src/sync/parallelCapture.ts
 /**
@@ -2026,6 +1959,7 @@ async function executeBatch(jobs, outputDirectory, captureOptions, browserOption
 		bypassCSP: browserOptions.bypassCSP,
 		reducedMotion: browserOptions.reducedMotion,
 		userAgent: browserOptions.userAgent,
+		ignoreHTTPSErrors: browserOptions.ignoreHTTPSErrors,
 		locale: jobs[0]?.locale
 	});
 	const page = await context.newPage();
@@ -2103,10 +2037,12 @@ async function captureParallel(options) {
 	for (const settled of settledResults) if (settled.status === "fulfilled") allResults.push(...settled.value);
 	return allResults;
 }
-
 //#endregion
 //#region src/sync/schemeCapture.ts
 /**
+* Color scheme + locale screenshot capture orchestration.
+*/
+/**
 * Capture screenshots for a single color scheme + locale combination.
 * Launches a browser, captures all screenshots, and closes the browser.
 *
@@ -2126,6 +2062,7 @@ async function captureWithScheme(options) {
 		bypassCSP: browserOptions.bypassCSP,
 		reducedMotion: browserOptions.reducedMotion,
 		userAgent: browserOptions.userAgent,
+		ignoreHTTPSErrors: browserOptions.ignoreHTTPSErrors,
 		locale
 	});
 	const page = await context.newPage();
@@ -2177,7 +2114,6 @@ async function captureWithScheme(options) {
 	await browser.close();
 	return results;
 }
-
 //#endregion
 //#region src/sync/sessionLoader.ts
 /**
@@ -2194,7 +2130,6 @@ function loadEncryptedSession(sessionKeyOption) {
 	}
 	verbose("Failed to decrypt session - using fresh browser");
 }
-
 //#endregion
 //#region src/sync/files.ts
 /**
@@ -2232,7 +2167,6 @@ function deleteStaleFiles(outputDirectory, staleFiles) {
 function findStaleFiles(existingFiles, writtenFiles) {
 	return existingFiles.filter((file) => !writtenFiles.has(file));
 }
-
 //#endregion
 //#region src/sync/staleFiles.ts
 /**
@@ -2255,7 +2189,6 @@ function handleStaleFiles(outputDirectory, results, options) {
 		deleted
 	};
 }
-
 //#endregion
 //#region src/sync/sync.ts
 /**
@@ -2377,7 +2310,6 @@ async function sync(options = {}) {
 	});
 	return showResults(results, outputDirectory, staleFiles, deletedFiles);
 }
-
 //#endregion
 //#region src/cli/snippet.ts
 /**
@@ -2464,6 +2396,5 @@ function snippetAction(pattern, options, configPath) {
 	log$1("");
 	return true;
 }
-
 //#endregion
-export { intro$1 as C, setVerbose as D, outro$1 as E, spinner$1 as O, error as S, note$1 as T, loadConfig as _, launchBrowser as a, screenshotSchema as b, generateSessionKey as c, loadSession as d, saveLocalKey as f, getConfigPath as g, ensureHeroshotDirectory as h, filterScreenshots as i, verbose as k, getSessionPath as l, sessionExists as m, snippetAction as n, DEFAULT_VIEWPORT as o, saveSession as p, sync as r, EDITOR_DIR as s, generateSnippets as t, loadLocalKey as u, saveConfig as v, log$1 as w, generateUid as x, VIEWPORT_PRESETS as y };
+export { intro$1 as C, setVerbose as D, outro$1 as E, spinner$1 as O, error as S, note$1 as T, loadConfig as _, launchBrowser as a, screenshotSchema as b, generateSessionKey as c, loadSession as d, saveLocalKey as f, getConfigPath as g, ensureHeroshotDirectory as h, filterScreenshots as i, verbose as k, getSessionPath as l, sessionExists as m, snippetAction as n, DEFAULT_VIEWPORT as o, saveSession as p, sync as r, EDITOR_DIR as s, generateSnippets as t, loadLocalKey as u, saveConfig as v, log$1 as w, generateUid as x, VIEWPORT_PRESETS as y };

package/dist/templates/heroshotReadme.txt

@@ -24,4 +24,4 @@ To use heroshot in CI, add your session key as a secret:
 
 To get your session key, run: `npx heroshot session-key`
 
-Learn more: https://heroshot.sh/docs
+Learn more: https://heroshot.dev/docs