@essential-apps/shopify-test-runner 1.0.0

package/dist/scripts/runDockerAuth.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+/**
+ * One-time interactive Shopify auth capture inside the test container.
+ *
+ * Why a separate script: tests run with the chromium browser invisible
+ * inside Xvfb, which means there's no way to interactively log in.
+ * This script starts the same container, exposes the Xvfb display via
+ * x11vnc on host port 5900, and opens macOS's built-in Screen Sharing
+ * (`vnc://localhost:5900`) so a developer can log in once. The
+ * resulting tests/test-online/.auth/storageState.json is bind-mounted into
+ * the project, so subsequent test runs use the captured cookies —
+ * bound to the container's Linux Chrome fingerprint, which is what
+ * Cloudflare expects to see during automated runs.
+ *
+ * Usage (one-time per developer machine, or whenever cookies expire):
+ *   npm run test:online:capture-auth
+ *
+ * macOS Screen Sharing.app opens automatically; just log in to
+ * Shopify, wait until you see the Partner Dashboard, then hit Enter
+ * back in the terminal where this script is running.
+ */
+import { spawn } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync } from 'node:fs';
+import { homedir, platform } from 'node:os';
+import { resolve } from 'node:path';
+import { setTimeout as sleep } from 'node:timers/promises';
+import { envFileArgs } from '@essential-apps/shopify-test-core';
+const repoRoot = process.cwd();
+const VNC_PORT = 5900;
+function readAppName() {
+    const pkgPath = resolve(repoRoot, 'package.json');
+    if (!existsSync(pkgPath)) {
+        throw new Error(`No package.json at ${pkgPath}. Run this from the consuming app's repo root.`);
+    }
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+    if (!pkg.name)
+        throw new Error(`package.json at ${pkgPath} has no \`name\` field.`);
+    return pkg.name.replace(/^@[^/]+\//, '');
+}
+async function main() {
+    const appName = readAppName();
+    const image = process.env['TEST_IMAGE'] ?? `${appName}-test:latest`;
+    const linuxModules = process.env['TEST_LINUX_NODE_MODULES'] ??
+        resolve(homedir(), `.cache/${appName}-test/node_modules`);
+    const vncPassword = process.env['TEST_ONLINE_VNC_PASSWORD'] ?? 'test';
+    mkdirSync(linuxModules, { recursive: true });
+    const args = [
+        'run',
+        '--rm',
+        '--arch',
+        'amd64',
+        '--memory',
+        '4096M',
+        '--cpus',
+        '2',
+        '--publish',
+        `127.0.0.1:${VNC_PORT}:${VNC_PORT}`,
+        '--env',
+        'TEST_ONLINE_VNC=1',
+        '--env',
+        `TEST_ONLINE_VNC_PASSWORD=${vncPassword}`,
+        '--mount',
+        `type=bind,source=${repoRoot},target=/workspace`,
+        '--mount',
+        `type=bind,source=${linuxModules},target=/workspace/node_modules`,
+        '-w',
+        '/workspace',
+        image,
+        'bash',
+        '-c',
+        [
+            'sleep 1',
+            `echo "[runDockerAuth] Container ready. VNC server should be on 127.0.0.1:${VNC_PORT}."`,
+            'echo ""',
+            // captureAuth is now in @essential-apps/shopify-test-runner.
+            `node ${envFileArgs(repoRoot)} node_modules/@essential-apps/shopify-test-runner/dist/scripts/captureAuth.js`,
+        ].join(' && '),
+    ];
+    console.log(`[runDockerAuth] Starting container with VNC on 127.0.0.1:${VNC_PORT}…`);
+    console.log(`[runDockerAuth] VNC password (paste into Screen Sharing): ${vncPassword}`);
+    console.log('');
+    const p = spawn('container', args, { stdio: 'inherit' });
+    if (platform() === 'darwin') {
+        void (async () => {
+            await sleep(4_000);
+            // Embed the password in the URL (vnc://:<pw>@host) so Screen Sharing
+            // connects WITHOUT prompting — prefilled, not typed.
+            const vncUrl = `vnc://:${encodeURIComponent(vncPassword)}@localhost:${VNC_PORT}`;
+            console.log(`[runDockerAuth] Opening macOS Screen Sharing → vnc://localhost:${VNC_PORT} (password prefilled)`);
+            console.log(`[runDockerAuth] (If nothing opens, run manually:  open '${vncUrl}')`);
+            spawn('open', [vncUrl], {
+                stdio: 'ignore',
+                detached: true,
+            }).unref();
+        })();
+    }
+    else {
+        console.log(`[runDockerAuth] Connect any VNC viewer to localhost:${VNC_PORT}.`);
+    }
+    p.on('exit', (code) => process.exit(code ?? 0));
+    process.on('SIGINT', () => p.kill('SIGINT'));
+    process.on('SIGTERM', () => p.kill('SIGTERM'));
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=runDockerAuth.js.map

package/dist/scripts/runDockerAuth.js.map

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

package/dist/scripts/runDockerOffline.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=runDockerOffline.d.ts.map

package/dist/scripts/runDockerOffline.d.ts.map

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

package/dist/scripts/runDockerOffline.js

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+/**
+ * Run the OFFLINE-FULL test suite inside Apple's `container`
+ * (libkrun-based microVM) — same image as `runDocker.ts`, different
+ * entrypoint.
+ *
+ * Why a separate script vs. `runDocker`:
+ *   - runDocker invokes `runTests.js` (live tests against real cloud Shopify)
+ *   - runDockerOffline invokes `runOfflineFullTests.js` (mock stack, no internet)
+ *
+ * Why offline tests in a container at all (vs. running host-native,
+ * which also works):
+ *   - /etc/hosts + system CA trust eliminate three layers of bypass
+ *     we'd otherwise need on host: --host-resolver-rules,
+ *     --ignore-certificate-errors, and the Node socket shim.
+ *   - Production-shape DNS + TLS: real getaddrinfo, real cert trust
+ *     chain, real port 443 binding. Closer to "1-to-1 production
+ *     recreation" than the host-native approach.
+ *   - Architectural consistency: live tests already run in this
+ *     container, offline tests should too.
+ *
+ * Architecture mirrors runDocker.ts: bind-mount the app repo and a
+ * cached Linux node_modules, plus the shopify-test repo if it lives
+ * outside the app (for `file:`-symlink stability).
+ */
+import { spawn } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { resolve } from 'node:path';
+const repoRoot = process.cwd();
+function readAppName() {
+    const pkgPath = resolve(repoRoot, 'package.json');
+    if (!existsSync(pkgPath)) {
+        throw new Error(`No package.json at ${pkgPath}. Run this from the consuming app's repo root.`);
+    }
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+    if (!pkg.name) {
+        throw new Error(`package.json at ${pkgPath} has no \`name\` field.`);
+    }
+    return pkg.name.replace(/^@[^/]+\//, '');
+}
+async function main() {
+    const appName = readAppName();
+    const image = process.env['E2E_IMAGE'] ?? `${appName}-e2e:latest`;
+    const linuxModules = process.env['E2E_LINUX_NODE_MODULES'] ??
+        resolve(homedir(), `.cache/${appName}-e2e/node_modules`);
+    mkdirSync(linuxModules, { recursive: true });
+    // Forward any extra args (e.g. `--grep "..."`) to the offline
+    // runner. The container's bash -c sees a single string; we
+    // JSON-escape each forwarded arg.
+    const forwarded = process.argv
+        .slice(2)
+        .map((a) => JSON.stringify(a))
+        .join(' ');
+    // Most envs flow through process.env naturally because of how
+    // `container run` inherits env. Two we explicitly set:
+    //   - E2E_OFFLINE_EXTENSIONS_JSON: extensions to mount in storefront
+    //   - E2E_OFFLINE_POST_PURCHASE_EXT: post-purchase extension JS path
+    // The consuming app provides these in its `npm run e2e:offline-full`
+    // script; we forward them so the equivalent docker run picks them up.
+    const passthroughEnv = [
+        'E2E_OFFLINE_EXTENSIONS_JSON',
+        'E2E_OFFLINE_POST_PURCHASE_EXT',
+        'E2E_OFFLINE_WORKERS',
+        'E2E_OFFLINE_FIXTURE_DEBUG',
+        'E2E_OFFLINE_EDGE_DEBUG',
+        'E2E_OFFLINE_SHIM_DEBUG',
+        'E2E_OFFLINE_SKIP_LEAK_CHECK',
+        'E2E_OFFLINE_STRICT_GRAPHQL',
+        // Contract-conformance toggles (see docs/CONTRACTS.md). The
+        // capture mode for Liquid contracts is driven by an env var
+        // because Playwright specs don't otherwise take CLI flags;
+        // `LIQUID_CONTRACTS_CAPTURE=true npm run e2e:offline-full`
+        // does a one-time bootstrap write.
+        'LIQUID_CONTRACTS_CAPTURE',
+        'CONTRACTS_LIVE_ENDPOINT',
+        'CONTRACTS_LIVE_ACCESS_TOKEN',
+        'CONTRACTS_LIVE_SHOP',
+    ]
+        .flatMap((k) => process.env[k] !== undefined ? ['--env', `${k}=${process.env[k]}`] : []);
+    const args = [
+        'run',
+        '--rm',
+        '--arch',
+        'amd64',
+        '--memory',
+        '8192M',
+        '--cpus',
+        '4',
+        ...passthroughEnv,
+        '--mount',
+        `type=bind,source=${repoRoot},target=/workspace`,
+        '--mount',
+        `type=bind,source=${linuxModules},target=/workspace/node_modules`,
+        '-w',
+        '/workspace',
+        image,
+        'bash',
+        '-c',
+        [
+            // Run `npm install` if node_modules looks empty OR partial.
+            // A previous failed install can leave package dirs without
+            // their package.json — ESM resolution then crashes on import.
+            // Use `node_modules/.package-lock.json` as the "install
+            // completed cleanly" signal (npm writes this after success),
+            // and hono's package.json as a sentinel for transitively-
+            // required deps.
+            'if [ ! -f node_modules/.package-lock.json ] || [ ! -f node_modules/hono/package.json ]; then ' +
+                'echo "[runDockerOffline] node_modules empty/partial — running fresh npm install…"; ' +
+                'rm -rf node_modules; ' +
+                'npm install --legacy-peer-deps --engine-strict=false; ' +
+                'fi',
+            // The offline runner uses TSX-compiled source for stack-trace
+            // fidelity. Inside the container we have the same node_modules
+            // layout as the host, so the same `--import tsx` works.
+            `node --env-file=.env.test --import tsx node_modules/@essential-apps/shopify-test-runner/src/scripts/runOfflineFullTests.ts ${forwarded}`,
+        ].join(' && '),
+    ];
+    console.log('[runDockerOffline] container run', args.slice(0, 14).join(' '), '…');
+    const p = spawn('container', args, { stdio: 'inherit' });
+    p.on('exit', (code) => process.exit(code ?? 0));
+    process.on('SIGINT', () => p.kill('SIGINT'));
+    process.on('SIGTERM', () => p.kill('SIGTERM'));
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=runDockerOffline.js.map

package/dist/scripts/runDockerOffline.js.map

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

package/dist/scripts/runDockerOfflineExplore.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=runDockerOfflineExplore.d.ts.map

package/dist/scripts/runDockerOfflineExplore.d.ts.map

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

package/dist/scripts/runDockerOfflineExplore.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+/**
+ * Spawn the offline e2e container in EXPLORE mode — interactive
+ * "click around the offline Shopify dev store" workflow.
+ *
+ * What this gets you:
+ *   - The full offline stack (Postgres + Remix backend + mocks +
+ *     edge proxy) running inside the container, same as the test
+ *     runner.
+ *   - A non-headless Chrome instance inside the container, pointed
+ *     at the admin app's URL.
+ *   - The container's Xvfb display exposed via VNC on
+ *     127.0.0.1:5900 (password: `e2e`).
+ *
+ * Connect: `open vnc://localhost:5900` on macOS, or any VNC client
+ * elsewhere. You'll see a desktop with Chrome open at the admin
+ * URL — click anywhere, mutate state via the app, navigate to
+ * https://test-shop.myshopify.com/ to see the storefront, etc.
+ *
+ * Stop: Ctrl-C in the terminal where this script runs (or close
+ * Chrome).
+ *
+ * Mirrors `runDockerOffline.ts` (the test runner inside the
+ * container) but with three differences:
+ *   1. `E2E_VNC=1` to make the entrypoint start x11vnc
+ *   2. `--publish 127.0.0.1:5900:5900` to expose VNC to the host
+ *   3. `E2E_OFFLINE_EXPLORE=true` to make the orchestrator skip
+ *      Playwright and launch Chrome instead
+ */
+import { spawn } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { resolve } from 'node:path';
+const repoRoot = process.cwd();
+function readAppName() {
+    const pkgPath = resolve(repoRoot, 'package.json');
+    if (!existsSync(pkgPath)) {
+        throw new Error(`No package.json at ${pkgPath}. Run this from the consuming app's repo root.`);
+    }
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+    if (!pkg.name) {
+        throw new Error(`package.json at ${pkgPath} has no \`name\` field.`);
+    }
+    return pkg.name.replace(/^@[^/]+\//, '');
+}
+async function main() {
+    const appName = readAppName();
+    const image = process.env['E2E_IMAGE'] ?? `${appName}-e2e:latest`;
+    const linuxModules = process.env['E2E_LINUX_NODE_MODULES'] ??
+        resolve(homedir(), `.cache/${appName}-e2e/node_modules`);
+    mkdirSync(linuxModules, { recursive: true });
+    const passthroughEnv = [
+        'E2E_OFFLINE_EXTENSIONS_JSON',
+        'E2E_OFFLINE_POST_PURCHASE_EXT',
+        'E2E_OFFLINE_FIXTURE_DEBUG',
+        'E2E_OFFLINE_EDGE_DEBUG',
+        'E2E_OFFLINE_EXPLORE_URL',
+    ].flatMap((k) => process.env[k] !== undefined ? ['--env', `${k}=${process.env[k]}`] : []);
+    const args = [
+        'run',
+        '--rm',
+        '--arch',
+        'amd64',
+        '--memory',
+        '8192M',
+        '--cpus',
+        '4',
+        // Expose Xvfb display via VNC to the host. The entrypoint starts
+        // x11vnc when E2E_VNC=1 is set (see tests/e2e/docker/entrypoint.sh).
+        '--publish',
+        '127.0.0.1:5900:5900',
+        '--env',
+        'E2E_VNC=1',
+        '--env',
+        'E2E_OFFLINE_EXPLORE=true',
+        ...passthroughEnv,
+        '--mount',
+        `type=bind,source=${repoRoot},target=/workspace`,
+        '--mount',
+        `type=bind,source=${linuxModules},target=/workspace/node_modules`,
+        '-w',
+        '/workspace',
+        image,
+        'bash',
+        '-c',
+        [
+            // Run `npm install` if node_modules looks empty OR partial.
+            // A previous failed install can leave package dirs without
+            // their package.json — ESM resolution then crashes on import.
+            // Use `node_modules/.package-lock.json` as the "install
+            // completed cleanly" signal (npm writes this after success).
+            'if [ ! -f node_modules/.package-lock.json ] || [ ! -f node_modules/hono/package.json ]; then ' +
+                'echo "[explore] node_modules empty/partial — running fresh npm install…"; ' +
+                'rm -rf node_modules; ' +
+                'npm install --legacy-peer-deps --engine-strict=false; ' +
+                'fi',
+            // Boot the orchestrator. The E2E_OFFLINE_EXPLORE=true env we
+            // set above makes it launch Chrome instead of Playwright.
+            'node --env-file=.env.test --import tsx node_modules/@essential-apps/shopify-test-runner/src/scripts/runOfflineFullTests.ts',
+        ].join(' && '),
+    ];
+    console.log('[runDockerOfflineExplore] starting interactive offline e2e container…');
+    console.log('[runDockerOfflineExplore] once you see "explore mode — launching Chrome",');
+    console.log('[runDockerOfflineExplore] connect with: open vnc://localhost:5900');
+    console.log('[runDockerOfflineExplore] password: e2e');
+    console.log('');
+    const p = spawn('container', args, { stdio: 'inherit' });
+    p.on('exit', (code) => process.exit(code ?? 0));
+    process.on('SIGINT', () => p.kill('SIGINT'));
+    process.on('SIGTERM', () => p.kill('SIGTERM'));
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=runDockerOfflineExplore.js.map

package/dist/scripts/runDockerOfflineExplore.js.map

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

package/dist/scripts/runIsolatedDockerOffline.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=runIsolatedDockerOffline.d.ts.map

package/dist/scripts/runIsolatedDockerOffline.d.ts.map

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