@essential-apps/shopify-test-runner 1.0.0

package/dist/scripts/devE2eBackend.js

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+/**
+ * Manual run of the e2e backend WITHOUT Shopify CLI.
+ *
+ * Used for `npm run test:online:install` (which needs a running backend to
+ * complete OAuth) and for local debugging. Mirrors the env-isolation
+ * guarantees of runTests.ts but uses a persistent DB
+ * (${appName}_e2e_${user}) instead of an ephemeral UUID one — so OAuth
+ * tokens persist across runs.
+ *
+ * Serves on https://localhost:PORT with a self-signed cert (vite +
+ * @vitejs/plugin-basic-ssl). No tunnel, no DNS.
+ */
+import { spawn, execSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { loadEnv, printEnvSummary } from '@essential-apps/shopify-test-core';
+import { isPortFree } from '../lib/freePort.js';
+const PG_HOST = 'localhost';
+const PG_PORT = '5432';
+function readAppName() {
+    const pkgPath = resolve(process.cwd(), '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(/^@[^/]+\//, '');
+}
+function dbExists(name) {
+    try {
+        execSync(`psql -h ${PG_HOST} -p ${PG_PORT} -lqt | cut -d \\| -f 1 | grep -qw ${name}`, {
+            stdio: 'ignore',
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function main() {
+    const env = loadEnv();
+    printEnvSummary(env);
+    if (!env.apiSecret) {
+        throw new Error(`SHOPIFY_API_SECRET is not set in .env.test.\n\n` +
+            `Get it from Partner Dashboard → Apps → "${env.devAppHandle}" → ` +
+            `Configuration → "Client credentials" → "Reveal client secret".\n` +
+            `Paste it into .env.test as SHOPIFY_API_SECRET=...`);
+    }
+    const appUrl = new URL(env.devAppUrl);
+    if (appUrl.hostname !== 'localhost' && appUrl.hostname !== '127.0.0.1') {
+        throw new Error(`SHOPIFY_APP_URL must be a localhost URL (https://localhost:PORT). Got: ${env.devAppUrl}`);
+    }
+    if (appUrl.protocol !== 'https:') {
+        throw new Error(`SHOPIFY_APP_URL must use https:// — got ${env.devAppUrl}`);
+    }
+    const port = appUrl.port || '443';
+    if (!(await isPortFree(Number(port)))) {
+        throw new Error(`Port ${port} is in use. Find what's there:  lsof -i :${port}\n` +
+            `Or change SHOPIFY_APP_URL in .env.test to a different port (and update Partner Dashboard).`);
+    }
+    const appName = readAppName();
+    const dbPrefix = (process.env['TEST_ONLINE_DB_NAME_PREFIX'] ?? `${appName}_e2e`)
+        .toLowerCase()
+        .replace(/[^a-z0-9_]/g, '_');
+    const PERSISTENT_DB_NAME = `${dbPrefix}_${process.env['USER'] ?? 'local'}`;
+    const user = process.env['USER'] ?? '';
+    const url = `postgresql://${user}@${PG_HOST}:${PG_PORT}/${PERSISTENT_DB_NAME}`;
+    console.log(`[dev-e2e] Persistent DB: ${url}`);
+    console.log(`[dev-e2e] Backend: ${env.devAppUrl} (vite https, self-signed cert)`);
+    console.log('');
+    if (!dbExists(PERSISTENT_DB_NAME)) {
+        console.log(`[dev-e2e] createdb ${PERSISTENT_DB_NAME}…`);
+        execSync(`createdb -h ${PG_HOST} -p ${PG_PORT} ${PERSISTENT_DB_NAME}`, {
+            stdio: 'inherit',
+        });
+    }
+    else {
+        console.log(`[dev-e2e] DB ${PERSISTENT_DB_NAME} exists, reusing.`);
+    }
+    const backendEnv = {
+        PATH: process.env['PATH'] ?? '',
+        // See runOfflineFullTests.ts for the long-form note — empty HOME
+        // makes npm write its cache to literal `~/.npm` in cwd.
+        HOME: process.env['HOME'] || '/root',
+        USER: process.env['USER'] ?? '',
+        NODE_ENV: 'test',
+        DATABASE_URL: url,
+        DIRECT_URL: url,
+        SHOPIFY_API_KEY: env.devClientId,
+        SHOPIFY_API_SECRET: env.apiSecret,
+        SCOPES: env.scopes,
+        SHOPIFY_APP_URL: env.devAppUrl,
+        PORT: port,
+        HOST: env.devAppUrl,
+    };
+    console.log('[dev-e2e] prisma migrate deploy…');
+    execSync('npx prisma migrate deploy', { stdio: 'inherit', env: backendEnv });
+    console.log('');
+    console.log('[dev-e2e] booting Remix dev server (vite, no tunnel)…');
+    console.log(`  Open ${env.devAppUrl} (accept self-signed cert warning once).`);
+    console.log('  Ctrl-C to stop.');
+    console.log('');
+    const dev = spawn('npx', ['vite', '--port', port, '--strictPort', '--host', '0.0.0.0'], {
+        stdio: 'inherit',
+        env: backendEnv,
+    });
+    dev.on('exit', (code) => process.exit(code ?? 0));
+    process.on('SIGINT', () => dev.kill('SIGINT'));
+    process.on('SIGTERM', () => dev.kill('SIGTERM'));
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=devE2eBackend.js.map

package/dist/scripts/devE2eBackend.js.map

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

package/dist/scripts/devOnlineBackend.d.ts

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

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

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

package/dist/scripts/devOnlineBackend.js

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+/**
+ * Manual run of the online backend WITHOUT Shopify CLI.
+ *
+ * Used for `npm run test:online:install` (which needs a running backend to
+ * complete OAuth) and for local debugging. Mirrors the env-isolation
+ * guarantees of runTests.ts but uses a persistent DB
+ * (${appName}_online_${user}) instead of an ephemeral UUID one — so OAuth
+ * tokens persist across runs.
+ *
+ * Serves on https://localhost:PORT with a self-signed cert (vite +
+ * @vitejs/plugin-basic-ssl). No tunnel, no DNS.
+ */
+import { spawn, execSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { loadEnv, printEnvSummary } from '@essential-apps/shopify-test-core';
+import { isPortFree } from '../lib/freePort.js';
+const PG_HOST = 'localhost';
+const PG_PORT = '5432';
+function readAppName() {
+    const pkgPath = resolve(process.cwd(), '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(/^@[^/]+\//, '');
+}
+function dbExists(name) {
+    try {
+        execSync(`psql -h ${PG_HOST} -p ${PG_PORT} -lqt | cut -d \\| -f 1 | grep -qw ${name}`, {
+            stdio: 'ignore',
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function main() {
+    const env = loadEnv();
+    printEnvSummary(env);
+    if (!env.apiSecret) {
+        throw new Error(`SHOPIFY_API_SECRET is not set in .env.test.\n\n` +
+            `Get it from Partner Dashboard → Apps → "${env.devAppHandle}" → ` +
+            `Configuration → "Client credentials" → "Reveal client secret".\n` +
+            `Paste it into .env.test as SHOPIFY_API_SECRET=...`);
+    }
+    const appUrl = new URL(env.devAppUrl);
+    if (appUrl.hostname !== 'localhost' && appUrl.hostname !== '127.0.0.1') {
+        throw new Error(`SHOPIFY_APP_URL must be a localhost URL (https://localhost:PORT). Got: ${env.devAppUrl}`);
+    }
+    if (appUrl.protocol !== 'https:') {
+        throw new Error(`SHOPIFY_APP_URL must use https:// — got ${env.devAppUrl}`);
+    }
+    const port = appUrl.port || '443';
+    if (!(await isPortFree(Number(port)))) {
+        throw new Error(`Port ${port} is in use. Find what's there:  lsof -i :${port}\n` +
+            `Or change SHOPIFY_APP_URL in .env.test to a different port (and update Partner Dashboard).`);
+    }
+    const appName = readAppName();
+    const dbPrefix = (process.env['TEST_ONLINE_DB_NAME_PREFIX'] ?? `${appName}_online`)
+        .toLowerCase()
+        .replace(/[^a-z0-9_]/g, '_');
+    const PERSISTENT_DB_NAME = `${dbPrefix}_${process.env['USER'] ?? 'local'}`;
+    const user = process.env['USER'] ?? '';
+    const url = `postgresql://${user}@${PG_HOST}:${PG_PORT}/${PERSISTENT_DB_NAME}`;
+    console.log(`[dev-online] Persistent DB: ${url}`);
+    console.log(`[dev-online] Backend: ${env.devAppUrl} (vite https, self-signed cert)`);
+    console.log('');
+    if (!dbExists(PERSISTENT_DB_NAME)) {
+        console.log(`[dev-online] createdb ${PERSISTENT_DB_NAME}…`);
+        execSync(`createdb -h ${PG_HOST} -p ${PG_PORT} ${PERSISTENT_DB_NAME}`, {
+            stdio: 'inherit',
+        });
+    }
+    else {
+        console.log(`[dev-online] DB ${PERSISTENT_DB_NAME} exists, reusing.`);
+    }
+    const backendEnv = {
+        PATH: process.env['PATH'] ?? '',
+        // See runOfflineFullTests.ts for the long-form note — empty HOME
+        // makes npm write its cache to literal `~/.npm` in cwd.
+        HOME: process.env['HOME'] || '/root',
+        USER: process.env['USER'] ?? '',
+        NODE_ENV: 'test',
+        DATABASE_URL: url,
+        DIRECT_URL: url,
+        SHOPIFY_API_KEY: env.devClientId,
+        SHOPIFY_API_SECRET: env.apiSecret,
+        SCOPES: env.scopes,
+        SHOPIFY_APP_URL: env.devAppUrl,
+        PORT: port,
+        HOST: env.devAppUrl,
+    };
+    console.log('[dev-online] prisma migrate deploy…');
+    execSync('npx prisma migrate deploy', { stdio: 'inherit', env: backendEnv });
+    console.log('');
+    console.log('[dev-online] booting Remix dev server (vite, no tunnel)…');
+    console.log(`  Open ${env.devAppUrl} (accept self-signed cert warning once).`);
+    console.log('  Ctrl-C to stop.');
+    console.log('');
+    const dev = spawn('npx', ['vite', '--port', port, '--strictPort', '--host', '0.0.0.0'], {
+        stdio: 'inherit',
+        env: backendEnv,
+    });
+    dev.on('exit', (code) => process.exit(code ?? 0));
+    process.on('SIGINT', () => dev.kill('SIGINT'));
+    process.on('SIGTERM', () => dev.kill('SIGTERM'));
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=devOnlineBackend.js.map

package/dist/scripts/devOnlineBackend.js.map

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

package/dist/scripts/installApp.d.ts

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

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

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

package/dist/scripts/installApp.js

@@ -0,0 +1,163 @@
+#!/usr/bin/env node
+/**
+ * Playwright-driven app install onto a registered test store. No
+ * human clicking, no Chrome PNA flag toggles.
+ *
+ * The consuming app's dev backend (e.g. `npm run dev:test-online`) MUST be
+ * running so the OAuth callback can hit localhost successfully.
+ */
+import { existsSync } from 'node:fs';
+import { parseArgs } from 'node:util';
+import { loadEnv, printEnvSummary, storageStatePath, readRegistry, writeRegistry, } from '@essential-apps/shopify-test-core';
+import { launchStealthBrowser } from '../lib/stealthLaunch.js';
+async function main() {
+    const { values } = parseArgs({
+        options: {
+            shop: { type: 'string' },
+            headless: { type: 'boolean', default: false },
+        },
+    });
+    const shop = values.shop?.trim();
+    if (!shop) {
+        console.error('Usage: npm run test:online:install -- --shop <shop>.myshopify.com');
+        process.exit(1);
+    }
+    const env = loadEnv();
+    printEnvSummary(env);
+    if (!existsSync(storageStatePath)) {
+        throw new Error(`Auth state not found at ${storageStatePath}. Run: npm run test:online:auth`);
+    }
+    const reg = readRegistry();
+    const store = reg.stores.find((s) => s.shop === shop);
+    if (!store) {
+        throw new Error(`Shop not in registry: ${shop}. Run: npm run test:online:add -- --shop ${shop}`);
+    }
+    if (store.appInstalled) {
+        console.log(`Already marked installed in registry. Skipping.`);
+        process.exit(0);
+    }
+    console.log('');
+    console.log(`Prerequisites: \`npm run dev:test-online\` must be running in another terminal.`);
+    console.log('');
+    // patchright's bundled Chromium (the one stealth engine the suite uses —
+    // same as the online storePool fixture + captureAuth) patches the CDP
+    // leak Cloudflare keys on, so its challenge fires less. PNA/LNA bypass
+    // flags are baked into launchStealthBrowser.
+    const browser = await launchStealthBrowser({ headless: values.headless ?? false });
+    const context = await browser.newContext({
+        storageState: storageStatePath,
+        ignoreHTTPSErrors: true,
+        viewport: { width: 1400, height: 900 },
+    });
+    await context.addInitScript(() => {
+        Object.defineProperty(navigator, 'webdriver', { get: () => undefined });
+    });
+    const page = await context.newPage();
+    page.on('console', (msg) => {
+        if (['error', 'warning'].includes(msg.type())) {
+            console.log(`[browser console ${msg.type()}] ${msg.text()}`);
+        }
+    });
+    try {
+        // First, load any page on our origin so we can run JS in its context.
+        console.log(`[install] Loading ${env.devAppUrl}/auth/login to establish origin context…`);
+        await page.goto(`${env.devAppUrl}/auth/login`, { waitUntil: 'domcontentloaded' });
+        // POST to /auth/login with shop in form body via native form submit
+        // (bypasses Remix's <Form> fetch intercept, browser follows the
+        // 30x redirect to admin.shopify.com OAuth natively).
+        console.log(`[install] Submitting native POST to /auth/login (shop=${shop})…`);
+        await page.evaluate((shopParam) => {
+            const form = document.createElement('form');
+            form.action = '/auth/login';
+            form.method = 'POST';
+            const input = document.createElement('input');
+            input.name = 'shop';
+            input.value = shopParam;
+            form.appendChild(input);
+            document.body.appendChild(form);
+            form.submit();
+        }, shop);
+        // Wait for navigation away from our localhost origin — POST should
+        // redirect to admin.shopify.com or accounts.shopify.com.
+        await page.waitForURL((u) => !u.toString().includes('localhost:8181'), {
+            timeout: 30_000,
+        });
+        // Redirect chain can bounce through any combo of:
+        //   accounts.shopify.com/select        → account picker
+        //   admin.shopify.com/login            → no_cookie_session bounce
+        //   admin.shopify.com/store/X/oauth/install  → install consent
+        // Keep clicking through until we land on the consent screen.
+        for (let i = 0; i < 8; i++) {
+            await page.waitForLoadState('domcontentloaded').catch(() => { });
+            const url = page.url();
+            console.log(`[install] At: ${url}`);
+            if (url.includes('accounts.shopify.com/select')) {
+                const target = env.accountEmail
+                    ? page.getByText(env.accountEmail, { exact: false }).first()
+                    : page.locator('[role="link"], a, button').first();
+                await target.click({ timeout: 15_000 });
+                await page.waitForURL((u) => !u.toString().includes('/select'), {
+                    timeout: 30_000,
+                });
+                continue;
+            }
+            if (url.includes('admin.shopify.com/login')) {
+                // The login page should auto-redirect once cookies settle.
+                await page.waitForURL((u) => !u.toString().includes('admin.shopify.com/login'), {
+                    timeout: 30_000,
+                });
+                continue;
+            }
+            // We've landed somewhere stable — break and look for install button
+            break;
+        }
+        // Possible terminal states after the redirect chain:
+        //   1. /apps/{handle}* — app already installed at Shopify level. Done.
+        //   2. /oauth/install — fresh install, click "Install app".
+        //   3. /app/grant — scope change requested, click "Update".
+        const url = page.url();
+        if (url.includes(`/apps/${env.devAppHandle}`)) {
+            console.log(`[install] Landed on app page — installation already complete: ${url}`);
+        }
+        else if (url.includes('/app/grant')) {
+            console.log('[install] Scope grant screen — clicking "Update"…');
+            await page.getByRole('button', { name: /^update$/i }).first().click();
+            await page.waitForURL((u) => u.toString().includes(`/apps/${env.devAppHandle}`), {
+                timeout: 90_000,
+            });
+        }
+        else {
+            console.log('[install] Looking for "Install app" button…');
+            const installButton = page
+                .getByRole('button', { name: /^install app$|^install$/i })
+                .first();
+            await installButton.waitFor({ state: 'visible', timeout: 60_000 });
+            console.log('[install] Clicking "Install app"…');
+            await installButton.click();
+            console.log('[install] Waiting for OAuth callback + app load…');
+            await page.waitForURL((u) => u.toString().includes(`/apps/${env.devAppHandle}`), {
+                timeout: 90_000,
+            });
+        }
+        await page.waitForLoadState('domcontentloaded');
+        console.log('[install] ✓ Install completed');
+        store.appInstalled = true;
+        writeRegistry(reg);
+        console.log(`[install] Marked ${shop} as installed in registry.`);
+    }
+    catch (err) {
+        console.error(`[install] Failed: ${err.message}`);
+        console.error(`Final URL: ${page.url()}`);
+        await page.screenshot({ path: 'tests/test-online/install-failure.png' }).catch(() => { });
+        console.error('Screenshot: tests/test-online/install-failure.png');
+        process.exit(1);
+    }
+    finally {
+        await browser.close();
+    }
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=installApp.js.map

package/dist/scripts/installApp.js.map

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

package/dist/scripts/listStores.d.ts

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

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

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

package/dist/scripts/listStores.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import { readRegistry } from '@essential-apps/shopify-test-core';
+const reg = readRegistry();
+if (reg.stores.length === 0) {
+    console.log('Pool is empty. Run: npm run test:online:create -- --count 2');
+    process.exit(0);
+}
+console.log(`${reg.stores.length} store(s) in pool:`);
+console.log('');
+for (const s of reg.stores) {
+    console.log(`  ${s.shop}`);
+    console.log(`    plan       : ${s.plan}`);
+    console.log(`    created    : ${s.createdAt ?? '(unknown)'}`);
+    console.log(`    installed  : ${s.appInstalled}`);
+    console.log(`    status     : ${s.status}`);
+    console.log('');
+}
+//# sourceMappingURL=listStores.js.map

package/dist/scripts/listStores.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listStores.js","sourceRoot":"","sources":["../../src/scripts/listStores.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjE,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;AAC3B,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IAC5B,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;IAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,oBAAoB,CAAC,CAAC;AACtD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAChB,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;IAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3B,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,SAAS,IAAI,WAAW,EAAE,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC"}

package/dist/scripts/runDocker.d.ts

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

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

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

package/dist/scripts/runDocker.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+/**
+ * Run e2e tests inside Apple's `container` (libkrun-based microVM).
+ *
+ * Why: macOS-host Chrome can't be hidden reliably while passing
+ * Cloudflare's bot management. Running tests in a Linux microVM means
+ * the browser exists entirely off-host — no window flashes ever, fully
+ * invisible.
+ *
+ * Architecture:
+ *   - Image: ${appName}-e2e:latest (built once via the consuming app's
+ *     tests/e2e/docker/Dockerfile). Default image name is derived
+ *     from package.json `name`; override via E2E_IMAGE env var.
+ *   - Bind mounts:
+ *       - app repo               → /workspace
+ *       - linux node_modules     → /workspace/node_modules (cached)
+ *       - shopify-test repo      → same host path inside the container
+ *         (so symlinks created by `npm install file:...` resolve
+ *         identically on host and container)
+ *   - Postgres starts inside the container via the app's entrypoint.sh.
+ *   - The shopify-test-run-tests CLI runs unchanged inside the
+ *     container — its localhost:5432 points at the container's pg,
+ *     not the host's.
+ */
+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.`);
+    }
+    // Strip any npm scope: @essential-apps/foo → foo
+    return pkg.name.replace(/^@[^/]+\//, '');
+}
+async function main() {
+    const appName = readAppName();
+    const image = process.env['E2E_IMAGE'] ?? `${appName}-e2e:latest`;
+    // Linux node_modules cache lives OUTSIDE the project tree so neither
+    // tsconfig-paths nor Playwright's test discovery sees it.
+    const linuxModules = process.env['E2E_LINUX_NODE_MODULES'] ??
+        resolve(homedir(), `.cache/${appName}-e2e/node_modules`);
+    mkdirSync(linuxModules, { recursive: true });
+    const args = [
+        'run',
+        '--rm',
+        // amd64 + Rosetta — image bundles Google Chrome (Linux amd64-only).
+        // Apple `container` runs amd64 images on Apple Silicon via Rosetta.
+        '--arch',
+        'amd64',
+        '--memory',
+        '8192M',
+        '--cpus',
+        '4',
+        '--mount',
+        `type=bind,source=${repoRoot},target=/workspace`,
+        '--mount',
+        `type=bind,source=${linuxModules},target=/workspace/node_modules`,
+        '-w',
+        '/workspace',
+        image,
+        'bash',
+        '-c',
+        [
+            // Use the .env.test we already have; run the built test runner
+            // from the @essential-apps/shopify-test-runner package.
+            // PG_HOST=127.0.0.1 inside container points at the container's
+            // pg started by entrypoint.sh.
+            'node --env-file=.env.test node_modules/@essential-apps/shopify-test-runner/dist/scripts/runTests.js',
+        ].join(' && '),
+    ];
+    console.log('[runDocker] container run', args.slice(0, 12).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=runDocker.js.map

package/dist/scripts/runDocker.js.map

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

package/dist/scripts/runDockerAuth.d.ts

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

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

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