@storyshelf/runner-playwright 0.6.2 → 0.7.0

package/dist/targets.mjs

@@ -0,0 +1,73 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { isBrowserName, isRemoteBrowser, remoteTargetsOf } from "@storyshelf/core/adapter/capture-runner";
+//#region src/targets.ts
+/** The runner's `browsers` option: what an operator lists, and the local targets it flattens to. */
+/** A local engine with options, for `browsers`: `local("chrome", { channel: "chrome-beta" })`. */
+function local(engine, options = {}) {
+	if (!isBrowserName(engine)) throw new Error(`local(): unknown engine "${String(engine)}"`);
+	if (options.channel !== void 0 && engine !== "chromium" && engine !== "chrome") throw new Error(`local("${engine}"): a channel applies only to chromium and chrome`);
+	return {
+		kind: "local",
+		engine,
+		options
+	};
+}
+/**
+* Flatten the `browsers` list into targets, first = default. Throws on an empty list, an unknown
+* engine, or two entries producing one target, naming both, so a mistake fails when the runner is
+* created and not when the first build runs.
+*/
+function flattenBrowsers(entries) {
+	if (entries.length === 0) throw new Error("browsers must list at least one target");
+	const seen = /* @__PURE__ */ new Map();
+	const flat = {
+		declared: [],
+		locals: [],
+		remotes: []
+	};
+	for (const [index, entry] of entries.entries()) for (const target of isRemoteBrowser(entry) ? remoteTargetsOf(entry) : [localOf(entry)]) {
+		claim(seen, target.target, index);
+		add(flat, target);
+	}
+	return flat;
+}
+/** Record that entry `index` produces `target`, refusing a second entry that does. */
+function claim(seen, target, index) {
+	const first = seen.get(target);
+	if (first !== void 0) throw new Error(`browsers entries ${first + 1} and ${index + 1} both produce the target "${target}"`);
+	seen.set(target, index);
+}
+function localOf(entry) {
+	const { engine, options } = typeof entry === "string" ? local(entry) : entry;
+	return {
+		target: engine,
+		channel: channelOf(engine, options)
+	};
+}
+function add(flat, target) {
+	if ("kind" in target) {
+		flat.remotes.push(target);
+		flat.declared.push({
+			target: target.target,
+			reach: target.reach,
+			status: "ready"
+		});
+	} else {
+		flat.locals.push(target);
+		flat.declared.push({
+			target: target.target,
+			reach: "loopback",
+			status: "ready"
+		});
+	}
+}
+/** Bare `chrome` means Chrome, not the bundled Chromium (ADR 0007, decision 7). */
+function channelOf(engine, options) {
+	return options.channel ?? (engine === "chrome" ? "chrome" : void 0);
+}
+//#endregion
+export { flattenBrowsers, local };
+
+//# sourceMappingURL=targets.mjs.map

package/dist/targets.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.mjs","names":[],"sources":["../src/targets.ts"],"sourcesContent":["/** The runner's `browsers` option: what an operator lists, and the local targets it flattens to. */\nimport {\n  isBrowserName,\n  isRemoteBrowser,\n  remoteTargetsOf,\n  type BrowserName,\n  type RemoteBrowser,\n  type RemoteTarget,\n  type RunnerTarget,\n} from \"@storyshelf/core/adapter/capture-runner\";\n\n/** Options of {@link local}. */\nexport interface LocalOptions {\n  /** Playwright channel (`chrome`, `chrome-beta`, `msedge`, …); only for `chromium` and `chrome`. */\n  channel?: string;\n}\n\n/** A local engine with options (ADR 0007, decision 1). */\nexport interface LocalBrowser {\n  readonly kind: \"local\";\n  readonly engine: BrowserName;\n  readonly options: LocalOptions;\n}\n\n/**\n * One entry of `browsers`: a bare engine name, {@link local}, or a remote service from\n * `@storyshelf/runner-playwright/remote` (`playwrightServer(...)`, `remote(...)`, ...), which\n * stands for one target per engine.\n */\nexport type BrowserEntry = BrowserName | LocalBrowser | RemoteBrowser;\n\n/** A local engine this runner launches. */\nexport interface LocalTarget {\n  /** The engine name, which is also the target. */\n  target: BrowserName;\n  /** The Playwright channel to launch with, when one applies. */\n  channel: string | undefined;\n}\n\n/** A local engine with options, for `browsers`: `local(\"chrome\", { channel: \"chrome-beta\" })`. */\nexport function local(engine: BrowserName, options: LocalOptions = {}): LocalBrowser {\n  if (!isBrowserName(engine)) {\n    throw new Error(`local(): unknown engine \"${String(engine)}\"`);\n  }\n  if (options.channel !== undefined && engine !== \"chromium\" && engine !== \"chrome\") {\n    throw new Error(`local(\"${engine}\"): a channel applies only to chromium and chrome`);\n  }\n  return { kind: \"local\", engine, options };\n}\n\n/** The `browsers` list, flattened: what the runner offers and how to start each target. */\nexport interface FlatTargets {\n  /** Every target as the runner declares it, default first (all `ready` until verified). */\n  declared: RunnerTarget[];\n  locals: LocalTarget[];\n  remotes: RemoteTarget[];\n}\n\n/**\n * Flatten the `browsers` list into targets, first = default. Throws on an empty list, an unknown\n * engine, or two entries producing one target, naming both, so a mistake fails when the runner is\n * created and not when the first build runs.\n */\nexport function flattenBrowsers(entries: readonly BrowserEntry[]): FlatTargets {\n  if (entries.length === 0) {\n    throw new Error(\"browsers must list at least one target\");\n  }\n  const seen = new Map<string, number>();\n  const flat: FlatTargets = { declared: [], locals: [], remotes: [] };\n  for (const [index, entry] of entries.entries()) {\n    for (const target of isRemoteBrowser(entry) ? remoteTargetsOf(entry) : [localOf(entry)]) {\n      claim(seen, target.target, index);\n      add(flat, target);\n    }\n  }\n  return flat;\n}\n\n/** Record that entry `index` produces `target`, refusing a second entry that does. */\nfunction claim(seen: Map<string, number>, target: string, index: number): void {\n  const first = seen.get(target);\n  if (first !== undefined) {\n    throw new Error(\n      `browsers entries ${first + 1} and ${index + 1} both produce the target \"${target}\"`,\n    );\n  }\n  seen.set(target, index);\n}\n\nfunction localOf(entry: BrowserName | LocalBrowser): LocalTarget {\n  const { engine, options } = typeof entry === \"string\" ? local(entry) : entry;\n  return { target: engine, channel: channelOf(engine, options) };\n}\n\nfunction add(flat: FlatTargets, target: LocalTarget | RemoteTarget): void {\n  if (\"kind\" in target) {\n    flat.remotes.push(target);\n    flat.declared.push({ target: target.target, reach: target.reach, status: \"ready\" });\n  } else {\n    flat.locals.push(target);\n    flat.declared.push({ target: target.target, reach: \"loopback\", status: \"ready\" });\n  }\n}\n\n/** Bare `chrome` means Chrome, not the bundled Chromium (ADR 0007, decision 7). */\nfunction channelOf(engine: BrowserName, options: LocalOptions): string | undefined {\n  return options.channel ?? (engine === \"chrome\" ? \"chrome\" : undefined);\n}\n"],"mappings":";;;;;;;AAwCA,SAAgB,MAAM,QAAqB,UAAwB,CAAC,GAAiB;CACnF,IAAI,CAAC,cAAc,MAAM,GACvB,MAAM,IAAI,MAAM,4BAA4B,OAAO,MAAM,EAAE,EAAE;CAE/D,IAAI,QAAQ,YAAY,KAAA,KAAa,WAAW,cAAc,WAAW,UACvE,MAAM,IAAI,MAAM,UAAU,OAAO,kDAAkD;CAErF,OAAO;EAAE,MAAM;EAAS;EAAQ;CAAQ;AAC1C;;;;;;AAeA,SAAgB,gBAAgB,SAA+C;CAC7E,IAAI,QAAQ,WAAW,GACrB,MAAM,IAAI,MAAM,wCAAwC;CAE1D,MAAM,uBAAO,IAAI,IAAoB;CACrC,MAAM,OAAoB;EAAE,UAAU,CAAC;EAAG,QAAQ,CAAC;EAAG,SAAS,CAAC;CAAE;CAClE,KAAK,MAAM,CAAC,OAAO,UAAU,QAAQ,QAAQ,GAC3C,KAAK,MAAM,UAAU,gBAAgB,KAAK,IAAI,gBAAgB,KAAK,IAAI,CAAC,QAAQ,KAAK,CAAC,GAAG;EACvF,MAAM,MAAM,OAAO,QAAQ,KAAK;EAChC,IAAI,MAAM,MAAM;CAClB;CAEF,OAAO;AACT;;AAGA,SAAS,MAAM,MAA2B,QAAgB,OAAqB;CAC7E,MAAM,QAAQ,KAAK,IAAI,MAAM;CAC7B,IAAI,UAAU,KAAA,GACZ,MAAM,IAAI,MACR,oBAAoB,QAAQ,EAAE,OAAO,QAAQ,EAAE,4BAA4B,OAAO,EACpF;CAEF,KAAK,IAAI,QAAQ,KAAK;AACxB;AAEA,SAAS,QAAQ,OAAgD;CAC/D,MAAM,EAAE,QAAQ,YAAY,OAAO,UAAU,WAAW,MAAM,KAAK,IAAI;CACvE,OAAO;EAAE,QAAQ;EAAQ,SAAS,UAAU,QAAQ,OAAO;CAAE;AAC/D;AAEA,SAAS,IAAI,MAAmB,QAA0C;CACxE,IAAI,UAAU,QAAQ;EACpB,KAAK,QAAQ,KAAK,MAAM;EACxB,KAAK,SAAS,KAAK;GAAE,QAAQ,OAAO;GAAQ,OAAO,OAAO;GAAO,QAAQ;EAAQ,CAAC;CACpF,OAAO;EACL,KAAK,OAAO,KAAK,MAAM;EACvB,KAAK,SAAS,KAAK;GAAE,QAAQ,OAAO;GAAQ,OAAO;GAAY,QAAQ;EAAQ,CAAC;CAClF;AACF;;AAGA,SAAS,UAAU,QAAqB,SAA2C;CACjF,OAAO,QAAQ,YAAY,WAAW,WAAW,WAAW,KAAA;AAC9D"}

package/dist/tests.mjs

@@ -0,0 +1,114 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { messageOf, safeCloseBrowser, safeCloseServer } from "./browser.mjs";
+import { waitForSettled } from "./settle.mjs";
+import { acquirePage } from "./pages.mjs";
+import { assertReachable, planRun, serve } from "./pipeline.mjs";
+import { engineOf } from "@storyshelf/core/adapter/capture-runner";
+import { createPageLimiter, isTimeoutError } from "@storyshelf/core/utils";
+import { StorybookAdapter } from "@storyshelf/core/capture";
+//#region src/tests.ts
+/** Storybook 10 `.test()` entries run as interaction tests in the iframe (ADR 0004, decision 10). */
+/** How long one test may take (render plus body) when the project sets nothing. */
+const DEFAULT_TEST_TIMEOUT_MS = 1e4;
+/** A viewport for tests: they take no screenshot, so one size serves every entry. */
+const TEST_VIEWPORT = {
+	name: "test",
+	width: 1280,
+	height: 720
+};
+/** Run every test entry once and report pass or fail for each; a failing test never throws. */
+async function runTestEntries(rawInput, active, driver, defaultTarget) {
+	if (rawInput.tests.length === 0) return [];
+	const { input, name, remote } = planRun(rawInput, driver, defaultTarget);
+	assertReachable(name, remote, input.storybookUrl);
+	const browser = await driver.launch(name, input.logger);
+	const server = await serve(input, browser);
+	active.browser = browser;
+	try {
+		return await runAll(browser, server.url, input, active);
+	} finally {
+		active.browser = null;
+		await Promise.all([safeCloseBrowser(browser), safeCloseServer(server)]);
+	}
+}
+async function runAll(browser, baseUrl, input, active) {
+	const outcomes = /* @__PURE__ */ new Map();
+	const pages = createPageLimiter({
+		concurrency: input.concurrency,
+		...input.gate === void 0 ? {} : { gate: input.gate },
+		browser: engineOf(input.target),
+		logger: input.logger
+	});
+	try {
+		await pages.each(input.tests, async (test) => {
+			if (active.cancelled) throw new Error("Capture cancelled");
+			const outcome = await runTestEntry(browser, baseUrl, test, input);
+			outcomes.set(test.id, outcome);
+			return outcome.timedOut === true;
+		});
+	} finally {
+		pages.dispose();
+	}
+	return input.tests.flatMap((test) => outcomes.get(test.id) ?? []);
+}
+/** One test: open its iframe URL, let Storybook render and run it, then read the verdict. */
+async function runTestEntry(browser, baseUrl, test, input) {
+	const started = performance.now();
+	const lease = await acquirePage({ browser }, TEST_VIEWPORT);
+	let reusable = false;
+	try {
+		const report = await openAndWait(lease.page, baseUrl, test, input);
+		reusable = true;
+		const timeoutMs = input.playTimeoutMs ?? 1e4;
+		return verdictOf(test.id, report, timeoutMs, elapsedSince(started));
+	} catch (error) {
+		return crashed(test.id, error, elapsedSince(started));
+	} finally {
+		await lease.release(reusable);
+	}
+}
+function elapsedSince(started) {
+	return Math.round(performance.now() - started);
+}
+/** The page or navigation failed before Storybook could say anything: the test failed. */
+function crashed(storyId, error, durationMs) {
+	return {
+		storyId,
+		status: "failed",
+		error: messageOf(error),
+		durationMs,
+		timedOut: isTimeoutError(error)
+	};
+}
+async function openAndWait(page, baseUrl, test, input) {
+	if (input.navigationTimeoutMs) page.setDefaultTimeout(input.navigationTimeoutMs);
+	const adapter = input.adapter ?? new StorybookAdapter();
+	await page.goto(adapter.buildUrl(baseUrl, test.id), { waitUntil: "load" });
+	return await waitForSettled(page, input.playTimeoutMs ?? 1e4);
+}
+/** Read Storybook's own account of the run: a thrown play body or render error fails the test. */
+function verdictOf(storyId, report, timeoutMs, durationMs) {
+	const failed = (error, timedOut = false) => ({
+		storyId,
+		status: "failed",
+		error,
+		durationMs,
+		...timedOut ? { timedOut } : {}
+	});
+	if (!report.hooked) return failed("Storybook's preview did not start (no channel to listen to)");
+	if (report.renderError !== void 0) return failed(`render failed: ${report.renderError}`);
+	if (report.playError !== void 0) return failed(report.playError);
+	if (report.unhandled?.[0] !== void 0) return failed(report.unhandled[0]);
+	if (!report.settled) return failed(`test did not finish within ${timeoutMs}ms (phase: ${report.phase ?? "unknown"})`, true);
+	return {
+		storyId,
+		status: "passed",
+		durationMs
+	};
+}
+//#endregion
+export { DEFAULT_TEST_TIMEOUT_MS, runTestEntries, verdictOf };
+
+//# sourceMappingURL=tests.mjs.map

package/dist/tests.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tests.mjs","names":[],"sources":["../src/tests.ts"],"sourcesContent":["/** Storybook 10 `.test()` entries run as interaction tests in the iframe (ADR 0004, decision 10). */\n\nimport {\n  engineOf,\n  type CaptureTarget,\n  type StoryEntry,\n  type TestOutcome,\n} from \"@storyshelf/core/adapter/capture-runner\";\nimport { StorybookAdapter } from \"@storyshelf/core/capture\";\nimport { createPageLimiter, isTimeoutError, type SessionGate } from \"@storyshelf/core/utils\";\nimport type { Browser, Page } from \"playwright-core\";\nimport { messageOf, safeCloseBrowser, safeCloseServer } from \"./browser.ts\";\nimport { acquirePage } from \"./pages.ts\";\nimport { assertReachable, planRun, serve } from \"./pipeline.ts\";\nimport { waitForSettled, type SettleReport } from \"./settle.ts\";\nimport type { ActiveRun, PlaywrightTestsInput, TargetDriver } from \"./types.ts\";\n\n/** How long one test may take (render plus body) when the project sets nothing. */\nexport const DEFAULT_TEST_TIMEOUT_MS = 10_000;\n\n/** A viewport for tests: they take no screenshot, so one size serves every entry. */\nconst TEST_VIEWPORT = { name: \"test\", width: 1280, height: 720 };\n\n/** Run every test entry once and report pass or fail for each; a failing test never throws. */\nexport async function runTestEntries(\n  rawInput: PlaywrightTestsInput,\n  active: ActiveRun,\n  driver: TargetDriver,\n  defaultTarget: CaptureTarget,\n): Promise<TestOutcome[]> {\n  if (rawInput.tests.length === 0) return [];\n  const { input, name, remote } = planRun(rawInput, driver, defaultTarget);\n  assertReachable(name, remote, input.storybookUrl);\n  const browser = await driver.launch(name, input.logger);\n  const server = await serve(input, browser);\n  active.browser = browser;\n  try {\n    return await runAll(browser, server.url, input, active);\n  } finally {\n    active.browser = null;\n    await Promise.all([safeCloseBrowser(browser), safeCloseServer(server)]);\n  }\n}\n\nasync function runAll(\n  browser: Browser,\n  baseUrl: string,\n  input: PlaywrightTestsInput & { target: CaptureTarget; gate?: SessionGate | undefined },\n  active: ActiveRun,\n): Promise<TestOutcome[]> {\n  const outcomes = new Map<string, TestOutcome>();\n  const pages = createPageLimiter({\n    concurrency: input.concurrency,\n    ...(input.gate === undefined ? {} : { gate: input.gate }),\n    browser: engineOf(input.target),\n    logger: input.logger,\n  });\n  try {\n    await pages.each(input.tests, async (test) => {\n      if (active.cancelled) throw new Error(\"Capture cancelled\");\n      const outcome = await runTestEntry(browser, baseUrl, test, input);\n      outcomes.set(test.id, outcome);\n      return outcome.timedOut === true;\n    });\n  } finally {\n    pages.dispose();\n  }\n  return input.tests.flatMap((test) => outcomes.get(test.id) ?? []);\n}\n\n/** One test: open its iframe URL, let Storybook render and run it, then read the verdict. */\nasync function runTestEntry(\n  browser: Browser,\n  baseUrl: string,\n  test: StoryEntry,\n  input: PlaywrightTestsInput,\n): Promise<TestOutcome & { timedOut?: boolean }> {\n  const started = performance.now();\n  const lease = await acquirePage({ browser }, TEST_VIEWPORT);\n  let reusable = false;\n  try {\n    const report = await openAndWait(lease.page, baseUrl, test, input);\n    reusable = true;\n    const timeoutMs = input.playTimeoutMs ?? DEFAULT_TEST_TIMEOUT_MS;\n    return verdictOf(test.id, report, timeoutMs, elapsedSince(started));\n  } catch (error) {\n    return crashed(test.id, error, elapsedSince(started));\n  } finally {\n    await lease.release(reusable);\n  }\n}\n\nfunction elapsedSince(started: number): number {\n  return Math.round(performance.now() - started);\n}\n\n/** The page or navigation failed before Storybook could say anything: the test failed. */\nfunction crashed(\n  storyId: string,\n  error: unknown,\n  durationMs: number,\n): TestOutcome & { timedOut?: boolean } {\n  return {\n    storyId,\n    status: \"failed\",\n    error: messageOf(error),\n    durationMs,\n    timedOut: isTimeoutError(error),\n  };\n}\n\nasync function openAndWait(\n  page: Page,\n  baseUrl: string,\n  test: StoryEntry,\n  input: PlaywrightTestsInput,\n): Promise<SettleReport> {\n  if (input.navigationTimeoutMs) page.setDefaultTimeout(input.navigationTimeoutMs);\n  const adapter = input.adapter ?? new StorybookAdapter();\n  await page.goto(adapter.buildUrl(baseUrl, test.id), { waitUntil: \"load\" });\n  return await waitForSettled(page, input.playTimeoutMs ?? DEFAULT_TEST_TIMEOUT_MS);\n}\n\n/** Read Storybook's own account of the run: a thrown play body or render error fails the test. */\nexport function verdictOf(\n  storyId: string,\n  report: SettleReport,\n  timeoutMs: number,\n  durationMs: number,\n): TestOutcome & { timedOut?: boolean } {\n  const failed = (error: string, timedOut = false): TestOutcome & { timedOut?: boolean } => ({\n    storyId,\n    status: \"failed\",\n    error,\n    durationMs,\n    ...(timedOut ? { timedOut } : {}),\n  });\n  if (!report.hooked) return failed(\"Storybook's preview did not start (no channel to listen to)\");\n  if (report.renderError !== undefined) return failed(`render failed: ${report.renderError}`);\n  if (report.playError !== undefined) return failed(report.playError);\n  if (report.unhandled?.[0] !== undefined) return failed(report.unhandled[0]);\n  if (!report.settled) {\n    return failed(\n      `test did not finish within ${timeoutMs}ms (phase: ${report.phase ?? \"unknown\"})`,\n      true,\n    );\n  }\n  return { storyId, status: \"passed\", durationMs };\n}\n"],"mappings":"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"}

package/dist/types.d.mts

@@ -1,6 +1,8 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { BrowserName } from "@storyshelf/core/adapter/capture-runner";
+import "./pages.mjs";
+import "@storyshelf/core/adapter/capture-runner";
+import "@storyshelf/core/utils";
 import "@storyshelf/core/capture";
 import "@storyshelf/core/logger";
 import "playwright-core";

package/dist/version.mjs

@@ -0,0 +1,16 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { createRequire } from "node:module";
+//#region src/version.ts
+/** The `playwright-core` this runner drives browsers with. */
+let cached;
+/** Its version, for the connect-time mismatch error and for services that ask the client's version. */
+function playwrightVersion() {
+	cached ??= createRequire(import.meta.url)("playwright-core/package.json").version;
+	return cached;
+}
+//#endregion
+export { playwrightVersion };
+
+//# sourceMappingURL=version.mjs.map

package/dist/version.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.mjs","names":[],"sources":["../src/version.ts"],"sourcesContent":["/** The `playwright-core` this runner drives browsers with. */\nimport { createRequire } from \"node:module\";\n\nlet cached: string | undefined;\n\n/** Its version, for the connect-time mismatch error and for services that ask the client's version. */\nexport function playwrightVersion(): string {\n  cached ??= (createRequire(import.meta.url)(\"playwright-core/package.json\") as { version: string })\n    .version;\n  return cached;\n}\n"],"mappings":";;;;;;AAGA,IAAI;;AAGJ,SAAgB,oBAA4B;CAC1C,WAAY,cAAc,YAAY,GAAG,CAAC,CAAC,8BAA8B,CAAC,CACvE;CACH,OAAO;AACT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storyshelf/runner-playwright",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "description": "Pure Playwright CaptureRunner implementation for StoryShelf: renders Storybook screenshots in-process (no db/storage coupling).",
   "keywords": [
     "playwright",
@@ -27,9 +27,6 @@
     "dist"
   ],
   "type": "module",
-  "engines": {
-    "node": ">=24"
-  },
   "sideEffects": false,
   "types": "./dist/index.d.mts",
   "exports": {
@@ -37,11 +34,16 @@
       "source": "./src/index.ts",
       "default": "./dist/index.mjs"
     },
+    "./remote": {
+      "source": "./src/remote/index.ts",
+      "default": "./dist/remote/index.mjs"
+    },
     "./package.json": "./package.json"
   },
   "publishConfig": {
     "exports": {
       ".": "./dist/index.mjs",
+      "./remote": "./dist/remote/index.mjs",
       "./package.json": "./package.json"
     },
     "access": "public"
@@ -52,19 +54,20 @@
     "fmt": "oxfmt ./src",
     "lint": "oxlint --type-aware --type-check ./src",
     "test": "vitest run",
-    "test:integration": "RUN_INTEGRATION=1 vitest run integration.test.ts passkey.integration.test.ts",
-    "prepublishOnly": "nub run build"
+    "test:integration": "RUN_INTEGRATION=1 vitest run integration.test.ts passkey.integration.test.ts remote.integration.test.ts",
+    "prepublishOnly": "nub run build",
+    "test:flake": "vitest run --repeats=20 --maxWorkers=1 --no-file-parallelism src/capture-runner.test.ts src/settle.test.ts src/screenshot.test.ts"
   },
   "dependencies": {
-    "@storyshelf/core": "0.6.2",
+    "@storyshelf/core": "0.7.0",
     "playwright-core": "1.63.0"
   },
   "devDependencies": {
     "@hono/node-server": "^1.17.0",
-    "@storyshelf/app": "0.6.2",
-    "@storyshelf/auth": "0.6.2",
-    "@storyshelf/db-sqlite": "0.6.2",
-    "@storyshelf/storage-local": "0.6.2",
+    "@storyshelf/app": "0.7.0",
+    "@storyshelf/auth": "0.7.0",
+    "@storyshelf/db-sqlite": "0.7.0",
+    "@storyshelf/storage-local": "0.7.0",
     "@types/node": "^26.0.0",
     "@vitest/coverage-v8": "^4.0.0",
     "adm-zip": "0.6.0",
@@ -75,6 +78,9 @@
     "typescript": "^7.0.2",
     "vitest": "^5.0.0"
   },
+  "engines": {
+    "node": ">=24"
+  },
   "jsr": {
     "runtimeCompat": {
       "node": true,