@voltkit/volt-test 0.1.2

package/dist/runner.js.map

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

package/dist/suites/hello-world.d.ts

@@ -0,0 +1,15 @@
+import type { VoltTestSuite } from '../types.js';
+export interface HelloWorldSmokeSuiteOptions {
+    name?: string;
+    projectDir?: string;
+    timeoutMs?: number;
+}
+export interface HelloWorldSmokePayload {
+    ok: boolean;
+    heading: string;
+    ping: {
+        pong: number;
+    };
+    durationMs: number;
+}
+export declare function createHelloWorldSmokeSuite(options?: HelloWorldSmokeSuiteOptions): VoltTestSuite;

package/dist/suites/hello-world.js

@@ -0,0 +1,139 @@
+import { existsSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { VoltAppLauncher } from '../launcher.js';
+const RESULT_FILE = '.volt-smoke-result.json';
+export function createHelloWorldSmokeSuite(options = {}) {
+    const name = options.name ?? 'hello-world-smoke';
+    const projectDir = options.projectDir ?? 'examples/hello-world';
+    const timeoutMs = options.timeoutMs ?? 120_000;
+    return {
+        name,
+        timeoutMs,
+        async run(context) {
+            const launcher = new VoltAppLauncher({
+                repoRoot: context.repoRoot,
+                cliEntryPath: context.cliEntryPath,
+                logger: context.logger,
+            });
+            await launcher.run({
+                sourceProjectDir: projectDir,
+                resultFile: RESULT_FILE,
+                timeoutMs: context.timeoutMs,
+                prepareProject: prepareHelloWorldSmokeProject,
+                validatePayload: validateHelloWorldPayload,
+                artifactsDir: context.artifactsDir,
+            });
+            await context.captureScreenshot(`${name}-post-run`);
+        },
+    };
+}
+function prepareHelloWorldSmokeProject(projectDir) {
+    writeFileSync(join(projectDir, 'src', 'backend.ts'), HELLO_WORLD_BACKEND_SOURCE, 'utf8');
+    writeFileSync(join(projectDir, 'src', 'main.ts'), HELLO_WORLD_FRONTEND_SOURCE, 'utf8');
+    const tsConfigPath = join(projectDir, 'volt.config.ts');
+    if (existsSync(tsConfigPath)) {
+        rmSync(tsConfigPath, { force: true });
+    }
+    writeFileSync(join(projectDir, 'volt.config.mjs'), HELLO_WORLD_CONFIG_SOURCE, 'utf8');
+}
+function validateHelloWorldPayload(payload) {
+    const value = asRecord(payload);
+    if (!value) {
+        throw new Error('[volt:test] hello-world smoke payload must be an object.');
+    }
+    if (value.ok !== true) {
+        throw new Error(`[volt:test] hello-world smoke failed: ${JSON.stringify(payload)}`);
+    }
+    const heading = value.heading;
+    if (typeof heading !== 'string' || heading.trim().length === 0) {
+        throw new Error('[volt:test] hello-world smoke payload missing heading text.');
+    }
+    const ping = asRecord(value.ping);
+    if (!ping || typeof ping.pong !== 'number') {
+        throw new Error('[volt:test] hello-world smoke payload missing ping.pong number.');
+    }
+    const durationMs = value.durationMs;
+    if (typeof durationMs !== 'number' || !Number.isFinite(durationMs) || durationMs < 0) {
+        throw new Error('[volt:test] hello-world smoke payload missing durationMs number.');
+    }
+    return {
+        ok: true,
+        heading,
+        ping: { pong: ping.pong },
+        durationMs,
+    };
+}
+function asRecord(value) {
+    if (!value || typeof value !== 'object') {
+        return null;
+    }
+    return value;
+}
+const HELLO_WORLD_BACKEND_SOURCE = `
+import { ipcMain } from 'volt:ipc';
+import * as voltFs from 'volt:fs';
+import * as voltWindow from 'volt:window';
+
+const RESULT_FILE = '.volt-smoke-result.json';
+
+ipcMain.handle('ping', () => ({ pong: Date.now() }));
+
+ipcMain.handle('smoke:complete', async (payload) => {
+  await voltFs.writeFile(RESULT_FILE, JSON.stringify(payload));
+  setTimeout(() => {
+    voltWindow.quit();
+  }, 50);
+  return { ok: true };
+});
+`.trimStart();
+const HELLO_WORLD_FRONTEND_SOURCE = `
+interface VoltBridge {
+  invoke(method: string, args?: unknown): Promise<unknown>;
+}
+
+declare global {
+  interface Window {
+    __volt__?: VoltBridge;
+  }
+}
+
+async function runSmoke(): Promise<void> {
+  const bridge = window.__volt__;
+  if (!bridge?.invoke) {
+    throw new Error('window.__volt__.invoke is unavailable');
+  }
+
+  const startedAt = Date.now();
+  try {
+    const heading = document.querySelector('h1')?.textContent ?? '';
+    const ping = await bridge.invoke('ping');
+    await bridge.invoke('smoke:complete', {
+      ok: true,
+      heading,
+      ping,
+      durationMs: Date.now() - startedAt,
+    });
+  } catch (error) {
+    await bridge.invoke('smoke:complete', {
+      ok: false,
+      error: error instanceof Error ? error.message : String(error),
+    });
+  }
+}
+
+void runSmoke();
+`.trimStart();
+const HELLO_WORLD_CONFIG_SOURCE = `
+export default {
+  name: 'Hello World',
+  version: '0.1.0',
+  backend: './src/backend.ts',
+  permissions: ['fs'],
+  window: {
+    width: 800,
+    height: 600,
+    title: 'Hello Volt!',
+  },
+};
+`.trimStart();
+//# sourceMappingURL=hello-world.js.map

package/dist/suites/hello-world.js.map

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

package/dist/suites/index.d.ts

@@ -0,0 +1,2 @@
+export { createHelloWorldSmokeSuite, type HelloWorldSmokePayload, type HelloWorldSmokeSuiteOptions, } from './hello-world.js';
+export { createIpcDemoSmokeSuite, type IpcDemoSmokePayload, type IpcDemoSmokeSuiteOptions, } from './ipc-demo.js';

package/dist/suites/index.js

@@ -0,0 +1,3 @@
+export { createHelloWorldSmokeSuite, } from './hello-world.js';
+export { createIpcDemoSmokeSuite, } from './ipc-demo.js';
+//# sourceMappingURL=index.js.map

package/dist/suites/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/suites/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,GAG3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,GAGxB,MAAM,eAAe,CAAC"}

package/dist/suites/ipc-demo.d.ts

@@ -0,0 +1,26 @@
+import { type AutomationEvent } from '../drivers/index.js';
+import type { VoltTestSuite } from '../types.js';
+export interface IpcDemoSmokeSuiteOptions {
+    name?: string;
+    projectDir?: string;
+    timeoutMs?: number;
+}
+export interface IpcDemoSmokePayload {
+    ok: boolean;
+    ping: {
+        pong: number;
+    };
+    echo: {
+        message: string;
+        sentAt: string;
+    };
+    compute: {
+        sum: number;
+        product: number;
+    };
+    nativeSetup: unknown;
+    status: unknown;
+    dbList: unknown;
+    events: AutomationEvent[];
+}
+export declare function createIpcDemoSmokeSuite(options?: IpcDemoSmokeSuiteOptions): VoltTestSuite;

package/dist/suites/ipc-demo.js

@@ -0,0 +1,287 @@
+import { readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { MenuAutomationDriver, TrayAutomationDriver } from '../drivers/index.js';
+import { VoltAppLauncher } from '../launcher.js';
+import { assertWindowReady, parseWindowStatus } from '../window.js';
+const RESULT_FILE = '.volt-smoke-result.json';
+export function createIpcDemoSmokeSuite(options = {}) {
+    const name = options.name ?? 'ipc-demo-smoke';
+    const projectDir = options.projectDir ?? 'examples/ipc-demo';
+    const timeoutMs = options.timeoutMs ?? 120_000;
+    return {
+        name,
+        timeoutMs,
+        async run(context) {
+            const launcher = new VoltAppLauncher({
+                repoRoot: context.repoRoot,
+                cliEntryPath: context.cliEntryPath,
+                logger: context.logger,
+            });
+            const menuDriver = new MenuAutomationDriver();
+            const trayDriver = new TrayAutomationDriver();
+            const payload = await launcher.run({
+                sourceProjectDir: projectDir,
+                resultFile: RESULT_FILE,
+                timeoutMs: context.timeoutMs,
+                prepareProject: prepareIpcDemoSmokeProject,
+                validatePayload: validateIpcDemoPayload,
+                artifactsDir: context.artifactsDir,
+            });
+            const menuSetup = menuDriver.parseSetupPayload(payload.nativeSetup);
+            const traySetup = trayDriver.parseSetupPayload(payload.nativeSetup);
+            const windowStatus = parseWindowStatus(payload.status);
+            if (!menuSetup.shortcutRegistered) {
+                context.logger.warn('[volt:test] ipc-demo shortcut registration failed (accepted in headless CI).');
+            }
+            if (!traySetup.trayReady) {
+                context.logger.warn('[volt:test] ipc-demo tray setup reported trayReady=false (accepted in headless CI).');
+            }
+            const menuClicks = menuDriver.countClickEvents(payload.events);
+            const trayClicks = trayDriver.countClickEvents(payload.events);
+            assertWindowReady(windowStatus, 1);
+            context.logger.log(`[volt:test] ipc-demo event summary: menuClicks=${menuClicks}, trayClicks=${trayClicks}, totalEvents=${payload.events.length}`);
+            await context.captureScreenshot(`${name}-post-run`);
+        },
+    };
+}
+function prepareIpcDemoSmokeProject(projectDir) {
+    const backendPath = join(projectDir, 'src', 'backend.ts');
+    const backendSource = readFileSync(backendPath, 'utf8');
+    writeFileSync(backendPath, patchBackendForSmoke(backendSource), 'utf8');
+    const tsConfigPath = join(projectDir, 'volt.config.ts');
+    rmSync(tsConfigPath, { force: true });
+    writeFileSync(join(projectDir, 'volt.config.mjs'), IPC_DEMO_SMOKE_CONFIG_SOURCE, 'utf8');
+    const mainPath = join(projectDir, 'src', 'main.ts');
+    writeFileSync(mainPath, IPC_DEMO_FRONTEND_SMOKE_SOURCE, 'utf8');
+}
+function validateIpcDemoPayload(payload) {
+    const value = asRecord(payload);
+    if (!value) {
+        throw new Error('[volt:test] ipc-demo smoke payload must be an object.');
+    }
+    if (value.ok !== true) {
+        throw new Error(`[volt:test] ipc-demo smoke failed: ${JSON.stringify(payload)}`);
+    }
+    const ping = asRecord(value.ping);
+    if (!ping || typeof ping.pong !== 'number') {
+        throw new Error('[volt:test] ipc-demo smoke payload missing ping.pong number.');
+    }
+    const echo = asRecord(value.echo);
+    if (!echo || typeof echo.message !== 'string' || typeof echo.sentAt !== 'string') {
+        throw new Error('[volt:test] ipc-demo smoke payload missing echo object.');
+    }
+    const compute = asRecord(value.compute);
+    const computeSum = compute?.sum;
+    const computeProduct = compute?.product;
+    if (!compute
+        || typeof computeSum !== 'number'
+        || typeof computeProduct !== 'number'
+        || computeSum !== 23
+        || computeProduct !== 42) {
+        throw new Error('[volt:test] ipc-demo smoke payload has invalid compute result.');
+    }
+    const events = normalizeEvents(value.events);
+    if (events.length === 0) {
+        throw new Error('[volt:test] ipc-demo smoke payload must include at least one native event.');
+    }
+    const dbList = value.dbList;
+    if (!Array.isArray(dbList) || dbList.length === 0) {
+        throw new Error('[volt:test] ipc-demo smoke payload expected non-empty dbList.');
+    }
+    return {
+        ok: true,
+        ping: { pong: ping.pong },
+        echo: {
+            message: echo.message,
+            sentAt: echo.sentAt,
+        },
+        compute: {
+            sum: computeSum,
+            product: computeProduct,
+        },
+        nativeSetup: value.nativeSetup,
+        status: value.status,
+        dbList,
+        events,
+    };
+}
+function normalizeEvents(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value
+        .map((entry) => {
+        const record = asRecord(entry);
+        if (!record || typeof record.event !== 'string') {
+            return null;
+        }
+        return {
+            event: record.event,
+            payload: record.payload,
+        };
+    })
+        .filter((entry) => entry !== null);
+}
+function patchBackendForSmoke(source) {
+    let next = source;
+    const fsImport = "import * as voltFs from 'volt:fs';";
+    if (!next.includes(fsImport)) {
+        const anchorImport = "import * as voltEvents from 'volt:events';";
+        if (!next.includes(anchorImport)) {
+            throw new Error('[volt:test] failed to patch ipc-demo backend: expected voltEvents import anchor.');
+        }
+        next = next.replace(anchorImport, `${anchorImport}\n${fsImport}`);
+    }
+    if (next.includes("ipcMain.handle('smoke:complete'")) {
+        return next;
+    }
+    return `${next.trimEnd()}
+
+const IPC_DEMO_SMOKE_RESULT_FILE = '.volt-smoke-result.json';
+
+ipcMain.handle('smoke:complete', async (payload: unknown) => {
+  await voltFs.writeFile(IPC_DEMO_SMOKE_RESULT_FILE, JSON.stringify(payload));
+  setTimeout(() => {
+    voltWindow.quit();
+  }, 50);
+  return { ok: true };
+});
+`;
+}
+function asRecord(value) {
+    if (!value || typeof value !== 'object') {
+        return null;
+    }
+    return value;
+}
+const IPC_DEMO_SMOKE_CONFIG_SOURCE = `
+export default {
+  name: 'IPC Demo',
+  version: '0.1.0',
+  backend: './src/backend.ts',
+  window: {
+    width: 980,
+    height: 760,
+    title: 'Volt IPC Demo',
+    minWidth: 860,
+    minHeight: 640,
+  },
+  permissions: ['clipboard', 'db', 'menu', 'globalShortcut', 'tray', 'secureStorage', 'fs'],
+};
+`.trimStart();
+const IPC_DEMO_FRONTEND_SMOKE_SOURCE = `
+interface VoltBridge {
+  invoke(method: string, args?: unknown): Promise<unknown>;
+  on(event: string, callback: (payload: unknown) => void): void;
+  off(event: string, callback: (payload: unknown) => void): void;
+}
+
+interface AutomationEvent {
+  event: string;
+  payload: unknown;
+}
+
+declare global {
+  interface Window {
+    __volt__?: VoltBridge;
+  }
+}
+
+const events: AutomationEvent[] = [];
+
+function appendEvent(event: string, payload: unknown): void {
+  events.push({ event, payload });
+}
+
+function bindEvent(bridge: VoltBridge, event: string): void {
+  bridge.on(event, (payload) => {
+    appendEvent(event, payload);
+  });
+}
+
+function asRecord(value: unknown): Record<string, unknown> | null {
+  if (!value || typeof value !== 'object') {
+    return null;
+  }
+  return value as Record<string, unknown>;
+}
+
+function sleep(milliseconds: number): Promise<void> {
+  return new Promise((resolve) => {
+    setTimeout(resolve, milliseconds);
+  });
+}
+
+function isWindowReadyStatus(value: unknown): boolean {
+  const root = asRecord(value);
+  const runtime = asRecord(root?.runtime);
+  const windowCount = runtime?.windowCount;
+  return typeof windowCount === 'number' && windowCount >= 1;
+}
+
+async function waitForWindowReady(bridge: VoltBridge, timeoutMs: number): Promise<unknown> {
+  const startedAt = Date.now();
+  let lastStatus: unknown = null;
+
+  while (Date.now() - startedAt <= timeoutMs) {
+    lastStatus = await bridge.invoke('status');
+    if (isWindowReadyStatus(lastStatus)) {
+      return lastStatus;
+    }
+    await sleep(120);
+  }
+
+  throw new Error(
+    'timed out waiting for native-ready window status: '
+      + JSON.stringify(lastStatus),
+  );
+}
+
+async function runSmoke(): Promise<void> {
+  const bridge = window.__volt__;
+  if (!bridge?.invoke || !bridge.on) {
+    throw new Error('window.__volt__ bridge is unavailable');
+  }
+
+  bindEvent(bridge, 'demo:menu-click');
+  bindEvent(bridge, 'demo:tray-click');
+  bindEvent(bridge, 'demo:native-ready');
+  bindEvent(bridge, 'demo:native-error');
+  bindEvent(bridge, 'demo:db-updated');
+
+  try {
+    const readyStatus = await waitForWindowReady(bridge, 12_000);
+    const ping = await bridge.invoke('ping');
+    const echoPayload = {
+      message: 'smoke-echo',
+      sentAt: new Date().toISOString(),
+    };
+    const echo = await bridge.invoke('echo', echoPayload);
+    const compute = await bridge.invoke('compute', { a: 21, b: 2 });
+    const nativeSetup = await bridge.invoke('native:setup');
+    await bridge.invoke('db:add', { message: 'smoke-row' });
+    const dbList = await bridge.invoke('db:list');
+    const status = await bridge.invoke('status');
+
+    await bridge.invoke('smoke:complete', {
+      ok: true,
+      ping,
+      echo,
+      compute,
+      nativeSetup,
+      status: status ?? readyStatus,
+      dbList,
+      events,
+    });
+  } catch (error) {
+    await bridge.invoke('smoke:complete', {
+      ok: false,
+      error: error instanceof Error ? error.message : String(error),
+      events,
+    });
+  }
+}
+
+void runSmoke();
+`.trimStart();
+//# sourceMappingURL=ipc-demo.js.map

package/dist/suites/ipc-demo.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,48 @@
+export interface VoltTestLogger {
+    log(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+}
+export interface VoltTestArtifactCaptureResult {
+    path: string;
+    captured: boolean;
+}
+export interface VoltTestSuiteContext {
+    repoRoot: string;
+    cliEntryPath: string;
+    logger: VoltTestLogger;
+    timeoutMs: number;
+    suiteName: string;
+    attempt: number;
+    artifactsDir: string;
+    captureScreenshot(name?: string): Promise<VoltTestArtifactCaptureResult>;
+}
+export interface VoltTestSuite {
+    name: string;
+    timeoutMs?: number;
+    run(context: VoltTestSuiteContext): Promise<void>;
+}
+export interface VoltTestConfig {
+    timeoutMs?: number;
+    retries?: number;
+    artifactDir?: string;
+    suites: VoltTestSuite[];
+}
+export interface LoadedVoltTestConfig {
+    configPath: string;
+    config: VoltTestConfig;
+}
+export interface LoadVoltTestConfigOptions {
+    configPath?: string;
+    strict?: boolean;
+}
+export interface RunSuitesOptions {
+    cliEntryPath: string;
+    suiteNames?: readonly string[];
+    timeoutMs?: number;
+    retries?: number;
+    artifactDir?: string;
+    captureScreenshots?: boolean;
+    repoRoot?: string;
+    logger?: VoltTestLogger;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/window.d.ts

@@ -0,0 +1,13 @@
+export interface WindowRuntimeStatus {
+    windowCount: number;
+    nativeReady: boolean;
+    shortcut?: string;
+}
+export interface WaitForWindowStatusOptions {
+    timeoutMs: number;
+    intervalMs?: number;
+    description?: string;
+}
+export declare function waitForWindowStatus(readStatus: () => Promise<unknown>, predicate: (status: WindowRuntimeStatus) => boolean, options: WaitForWindowStatusOptions): Promise<WindowRuntimeStatus>;
+export declare function assertWindowReady(status: WindowRuntimeStatus, minimumWindowCount?: number): void;
+export declare function parseWindowStatus(payload: unknown): WindowRuntimeStatus;

package/dist/window.js

@@ -0,0 +1,65 @@
+import { setTimeout as delay } from 'node:timers/promises';
+export async function waitForWindowStatus(readStatus, predicate, options) {
+    const timeoutMs = options.timeoutMs;
+    const intervalMs = options.intervalMs ?? 150;
+    const description = options.description ?? 'window status condition';
+    const startedAt = Date.now();
+    let lastStatus = null;
+    while (Date.now() - startedAt <= timeoutMs) {
+        const parsed = parseWindowStatus(readStatus ? await readStatus() : null);
+        lastStatus = parsed;
+        if (predicate(parsed)) {
+            return parsed;
+        }
+        await delay(intervalMs);
+    }
+    const lastSnapshot = lastStatus ? JSON.stringify(lastStatus) : 'none';
+    throw new Error(`[volt:test] timed out waiting for ${description} after ${timeoutMs}ms (last status: ${lastSnapshot}).`);
+}
+export function assertWindowReady(status, minimumWindowCount = 1) {
+    if (!Number.isInteger(minimumWindowCount) || minimumWindowCount <= 0) {
+        throw new Error('[volt:test] minimumWindowCount must be a positive integer.');
+    }
+    if (status.windowCount < minimumWindowCount) {
+        throw new Error(`[volt:test] expected at least ${minimumWindowCount} open window(s), got ${status.windowCount}.`);
+    }
+    if (!status.nativeReady) {
+        throw new Error('[volt:test] expected native integrations to be ready but nativeReady=false.');
+    }
+}
+export function parseWindowStatus(payload) {
+    const root = asRecord(payload);
+    if (!root) {
+        throw new Error('[volt:test] invalid window status payload: expected object.');
+    }
+    const runtime = asRecord(root.runtime);
+    if (!runtime) {
+        throw new Error('[volt:test] invalid window status payload: missing runtime object.');
+    }
+    const windowCountValue = runtime.windowCount;
+    if (typeof windowCountValue !== 'number' || !Number.isInteger(windowCountValue) || windowCountValue < 0) {
+        throw new Error('[volt:test] invalid window status payload: runtime.windowCount must be >= 0.');
+    }
+    const windowCount = windowCountValue;
+    const nativeReady = runtime.nativeReady;
+    if (typeof nativeReady !== 'boolean') {
+        throw new Error('[volt:test] invalid window status payload: runtime.nativeReady must be boolean.');
+    }
+    const shortcutValue = runtime.shortcut;
+    if (shortcutValue !== undefined && typeof shortcutValue !== 'string') {
+        throw new Error('[volt:test] invalid window status payload: runtime.shortcut must be a string when set.');
+    }
+    const shortcut = typeof shortcutValue === 'string' ? shortcutValue : undefined;
+    return {
+        windowCount,
+        nativeReady,
+        shortcut,
+    };
+}
+function asRecord(value) {
+    if (!value || typeof value !== 'object') {
+        return null;
+    }
+    return value;
+}
+//# sourceMappingURL=window.js.map

package/dist/window.js.map

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