@essential-apps/shopify-test-runner 1.0.0

package/dist/probes/runProbe.js

@@ -0,0 +1,219 @@
+#!/usr/bin/env node
+/**
+ * Probe runner — entry point for the online-store inspection framework.
+ *
+ * Invocation:
+ *   node --import tsx \
+ *     node_modules/@essential-apps/shopify-test-runner/src/probes/runProbe.ts \
+ *     <probe-name> [--key=value …]
+ *
+ * What it does:
+ *   1. Loads the consuming app's `.env.test` so probes can read
+ *      env (e.g. STOREFRONT_PASSWORD).
+ *   2. Picks an installed store from `tests/test-online/.stores.json`.
+ *   3. Launches Playwright chromium via patchright with the
+ *      saved Partner storage state — same recipe online tests use.
+ *   4. Hands control to the probe.
+ *
+ * Adding a probe: drop a file in `packages/runner/src/probes/<name>.ts`
+ * default-exporting a {@link Probe}, and add a row to `PROBES` below.
+ */
+import { existsSync, mkdirSync, readFileSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { readRegistry, storageStatePath, } from '@essential-apps/shopify-test-core';
+import fontsProbe from './fonts.js';
+import mirrorProbe from './mirror.js';
+import { launchStealthBrowser } from '../lib/stealthLaunch.js';
+// ── Registry of available probes ──────────────────────────────
+// Order matters only for `--help` listing.
+const PROBES = {
+    [fontsProbe.name]: fontsProbe,
+    [mirrorProbe.name]: mirrorProbe,
+};
+function parseArgs(argv) {
+    const [name, ...rest] = argv;
+    const args = {};
+    let help = false;
+    for (const a of rest) {
+        if (a === '--help' || a === '-h') {
+            help = true;
+            continue;
+        }
+        const m = a.match(/^--([^=]+)=(.*)$/);
+        if (m) {
+            args[m[1]] = m[2];
+            continue;
+        }
+        // Bare flag: --foo (no value) → true
+        const bare = a.match(/^--(.+)$/);
+        if (bare) {
+            args[bare[1]] = '';
+        }
+    }
+    return { name: name ?? '', args, help };
+}
+function printUsage() {
+    console.error('Usage: runProbe <name> [--key=value …]');
+    console.error('');
+    console.error('Available probes:');
+    for (const p of Object.values(PROBES)) {
+        console.error(`  ${p.name.padEnd(14)} ${p.description}`);
+    }
+    console.error('');
+    console.error('Global flags:');
+    console.error('  --help                    Show this help');
+    console.error('  --store=<slug>            Use a specific store from the pool (default: any available)');
+    console.error('');
+}
+// ── Workspace path discovery ──────────────────────────────────
+/**
+ * Locate the workspace root. When this script runs from a packed
+ * tarball inside a consumer's node_modules, the workspace is the
+ * shopify-test repo's root — the package nearest us with
+ * `name === "@essential-apps/shopify-test"`. When running from the
+ * repo itself, that's the repo root.
+ *
+ * We walk up from this file looking for a `package.json` whose
+ * `name` matches, falling back to the nearest directory containing
+ * a `packages/` folder (matches the monorepo layout).
+ */
+function findWorkspaceRoot() {
+    // When invoked from a consumer, the runner's source lives under
+    // `node_modules/@essential-apps/shopify-test-runner/src/`. That
+    // path doesn't help us reach the workspace's themes/, etc.
+    // Look upward from this file for the workspace root marker.
+    let dir = dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 10; i++) {
+        const pj = resolve(dir, 'package.json');
+        if (existsSync(pj)) {
+            try {
+                const pkg = JSON.parse(readFileSync(pj, 'utf8'));
+                if (pkg.name === '@essential-apps/shopify-test')
+                    return dir;
+            }
+            catch {
+                /* fall through */
+            }
+        }
+        const parent = resolve(dir, '..');
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // Fallback: assume cwd is the consumer app — outputs go to its
+    // tests/test-online/probe-output/ if we can't find a workspace.
+    return process.cwd();
+}
+// ── Store selection ───────────────────────────────────────────
+function pickStore(slug) {
+    const { stores } = readRegistry();
+    if (slug) {
+        const s = stores.find((x) => x.slug === slug);
+        if (!s) {
+            throw new Error(`Store with slug "${slug}" not found in registry. ` +
+                `Available: ${stores.map((x) => x.slug).join(', ')}`);
+        }
+        return s;
+    }
+    const candidate = stores.find((s) => s.appInstalled && s.status === 'available') ??
+        stores.find((s) => s.appInstalled) ??
+        stores[0];
+    if (!candidate) {
+        throw new Error('No stores in registry. Run `npm run test:online:add` + `npm run test:online:install` first.');
+    }
+    return candidate;
+}
+/**
+ * Synthesize a Store record from a bare URL. Used by `--url=<full>`
+ * mode so probes can run against arbitrary public Shopify storefronts
+ * (e.g. `theme-dawn-demo.myshopify.com` for canonical Dawn font
+ * mirroring) without needing a Partner-auth registry entry.
+ */
+function storeFromUrl(rawUrl) {
+    const u = new URL(rawUrl);
+    const shop = u.hostname;
+    const slug = shop.replace(/\.myshopify\.com$/, '');
+    return {
+        shop,
+        slug,
+        plan: 'PUBLIC',
+        appInstalled: false,
+        status: 'available',
+    };
+}
+// ── Browser bootstrap ─────────────────────────────────────────
+async function launchBrowser(opts) {
+    // Reuse the same chrome+patchright recipe as the online-test store
+    // pool: real Google Chrome via patchright. For probes against
+    // Partner-owned stores we layer in the saved Partner storage
+    // state so password gates / admin redirects work; for public
+    // storefronts (--url mode) we skip that — no auth needed.
+    const browser = await launchStealthBrowser({ headless: true });
+    const storageState = opts.needAuth && existsSync(storageStatePath)
+        ? JSON.parse(readFileSync(storageStatePath, 'utf8'))
+        : undefined;
+    if (opts.needAuth && !storageState) {
+        throw new Error(`Storage state not found at ${storageStatePath}. ` +
+            `Run online tests at least once to capture Partner auth cookies, ` +
+            `or pass --url=<public-store-url> to skip auth.`);
+    }
+    const context = await browser.newContext({
+        viewport: { width: 1400, height: 900 },
+        ignoreHTTPSErrors: true,
+        ...(storageState ? { storageState } : {}),
+    });
+    return context;
+}
+// ── Main ──────────────────────────────────────────────────────
+async function main() {
+    const parsed = parseArgs(process.argv.slice(2));
+    if (parsed.help || !parsed.name) {
+        printUsage();
+        process.exit(parsed.name ? 0 : 1);
+    }
+    const probe = PROBES[parsed.name];
+    if (!probe) {
+        console.error(`Unknown probe: "${parsed.name}"\n`);
+        printUsage();
+        process.exit(1);
+    }
+    const workspaceRoot = findWorkspaceRoot();
+    // --url=<full> mode: synthesize a Store record from the URL and
+    // skip auth. For probing arbitrary public storefronts (e.g.
+    // theme-dawn-demo.myshopify.com for canonical Dawn font mirroring).
+    const urlMode = parsed.args['url'];
+    const store = urlMode ? storeFromUrl(urlMode) : pickStore(parsed.args['store']);
+    const outputDir = resolve(workspaceRoot, probe.outputDir.replace(/\$\{name\}/g, probe.name));
+    mkdirSync(outputDir, { recursive: true });
+    console.log(`[runProbe] probe: ${probe.name}`);
+    console.log(`[runProbe] store: ${store.shop} (${store.slug})${urlMode ? ' [public --url mode]' : ''}`);
+    console.log(`[runProbe] output: ${outputDir}`);
+    const browserContext = await launchBrowser({ needAuth: !urlMode });
+    const page = await browserContext.newPage();
+    const ctx = {
+        store,
+        browserContext,
+        page,
+        outputDir,
+        args: parsed.args,
+        workspaceRoot,
+    };
+    try {
+        await probe.run(ctx);
+        console.log(`[runProbe] ✓ ${probe.name} complete`);
+    }
+    catch (err) {
+        console.error(`[runProbe] ✗ ${probe.name} failed:`, err);
+        process.exitCode = 1;
+    }
+    finally {
+        await browserContext.close().catch(() => { });
+        await browserContext.browser()?.close().catch(() => { });
+    }
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=runProbe.js.map

package/dist/probes/runProbe.js.map

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

package/dist/probes/types.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Probe framework — a reusable harness for asking real Shopify
+ * "what does this actually look like?" against the online test store
+ * pool.
+ *
+ * Why this exists: every offline mock has a long tail of "is our
+ * shape right?" questions. Examples we've already hit:
+ *   - what URLs does Shopify's `font_face` Liquid filter emit?
+ *   - what does the real `themes/{id}/assets.json` response look like?
+ *   - what HTTP headers does fonts.shopifycdn.com set on a .woff2?
+ *   - what's the exact `settings_data.json` shape when an app embed
+ *     is activated?
+ *
+ * Each probe is a small Node script that drives a Playwright browser
+ * against a real online store (picked from `tests/test-online/.stores.json`),
+ * captures structured fixture data, and writes it somewhere the
+ * mocks can read at runtime.
+ *
+ * Adding a probe: create `packages/runner/src/probes/<name>.ts`,
+ * default-export an object conforming to {@link Probe}, and add a
+ * row to the registry in `runProbe.ts`.
+ *
+ * Invoke from the consuming app's repo:
+ *   node --import tsx \
+ *     node_modules/@essential-apps/shopify-test-runner/src/probes/runProbe.ts \
+ *     <probe-name> [--key=value …]
+ */
+import type { BrowserContext, Page } from '@playwright/test';
+import type { Store } from '@essential-apps/shopify-test-core';
+/**
+ * Per-probe execution context. The runner sets up the browser +
+ * store before invoking the probe; the probe focuses on what it
+ * captures, not how to get a browser.
+ */
+export interface ProbeContext {
+    /** The online store this probe runs against. */
+    store: Store;
+    /** Logged-in Playwright BrowserContext (storage state pre-loaded). */
+    browserContext: BrowserContext;
+    /** Convenience: a fresh page in the context. Probes can open more. */
+    page: Page;
+    /**
+     * Absolute path where probe artifacts go. Probes write fixture
+     * files (JSON, binary, etc.) under here so the mock packages
+     * can read them later. Conventionally the workspace path
+     * `packages/<owner-package>/fixtures/<probe-name>/`.
+     */
+    outputDir: string;
+    /** Parsed --key=value CLI args. */
+    args: Record<string, string>;
+    /** Workspace root absolute path (the shopify-test repo). */
+    workspaceRoot: string;
+}
+export interface Probe {
+    /** Probe name — what you type after `runProbe`. */
+    name: string;
+    /** One-line description shown in `runProbe --help`. */
+    description: string;
+    /**
+     * Where outputs should go, relative to workspaceRoot. The harness
+     * creates this dir and passes its absolute path as
+     * `ctx.outputDir`. Use `${name}` etc. — substituted at runtime.
+     */
+    outputDir: string;
+    /**
+     * Main entry point. Throws on failure; logs progress to stdout.
+     * Should be idempotent — re-running a probe should refresh
+     * outputs cleanly.
+     */
+    run(ctx: ProbeContext): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/probes/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/probes/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAE/D;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,KAAK,EAAE,KAAK,CAAC;IACb,sEAAsE;IACtE,cAAc,EAAE,cAAc,CAAC;IAC/B,sEAAsE;IACtE,IAAI,EAAE,IAAI,CAAC;IACX;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,4DAA4D;IAC5D,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,KAAK;IACpB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC"}

package/dist/probes/types.js

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

package/dist/probes/types.js.map

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

package/dist/scripts/_probeSourceUrl.d.ts

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

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

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

package/dist/scripts/_probeSourceUrl.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+/** Test the CLI's actual format: tar + brotli, sourceExtension: BR. */
+import { createReadStream, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { Readable } from 'node:stream';
+import { randomUUID } from 'node:crypto';
+import { brotliCompressSync, constants as zlibConst } from 'node:zlib';
+import { pack as tarPack } from 'tar-stream';
+const TOKEN = process.env.SHOPIFY_APP_AUTOMATION_TOKEN;
+const ORG = 'gid://shopify/Organization/217838969';
+const APP = 'gid://shopify/App/366427176961';
+const WS = '/Users/domas/Developer/supercorp/essential-upsell';
+async function getAt() {
+    const body = new URLSearchParams({
+        grant_type: 'urn:ietf:params:oauth:grant-type:token-exchange',
+        requested_token_type: 'urn:ietf:params:oauth:token-type:access_token',
+        subject_token_type: 'urn:ietf:params:oauth:token-type:access_token',
+        client_id: 'fbdb2649-e327-4907-8f67-908d24cfd7e3',
+        audience: '7ee65a63608843c577db8b23c4d7316ea0a01bd2f7594f8a9c06ea668c1b775c',
+        scope: 'https://api.shopify.com/auth/organization.apps.manage',
+        subject_token: TOKEN,
+    }).toString();
+    const r = await fetch('https://accounts.shopify.com/oauth/token', { method: 'POST', headers: { 'Content-Type': 'application/x-www-form-urlencoded' }, body });
+    return JSON.parse(await r.text()).access_token;
+}
+async function gql(at, body) {
+    const r = await fetch('https://app.shopify.com/app_management/unstable/graphql.json', { method: 'POST', headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${at}`, 'X-Shopify-Access-Token': `Bearer ${at}` }, body: JSON.stringify(body) });
+    return { status: r.status, body: await r.text() };
+}
+async function mintBr(at) {
+    const r = await gql(at, { query: `mutation Q($o:ID!){appRequestSourceUploadUrl(sourceExtension:BR,organizationId:$o){sourceUploadUrl userErrors{field message}}}`, variables: { o: ORG } });
+    return JSON.parse(r.body).data.appRequestSourceUploadUrl.sourceUploadUrl;
+}
+async function upload(url, path) {
+    const size = statSync(path).size;
+    const body = Readable.toWeb(createReadStream(path));
+    const r = await fetch(url, {
+        method: 'PUT', body,
+        // Match CLI: no content-encoding header, raw bytes
+        headers: { 'Content-Length': String(size) },
+        // @ts-expect-error
+        duplex: 'half',
+    });
+    if (!r.ok)
+        throw new Error(`upload: ${r.status} ${await r.text()}`);
+}
+/** Build a tar archive in memory from { path: bytes } map. */
+async function buildTarBr(files) {
+    return new Promise((resolve, reject) => {
+        const pack = tarPack();
+        const chunks = [];
+        pack.on('data', (c) => chunks.push(c));
+        pack.on('end', () => {
+            const tarBuf = Buffer.concat(chunks);
+            const brBuf = brotliCompressSync(tarBuf, {
+                params: { [zlibConst.BROTLI_PARAM_QUALITY]: 7 },
+            });
+            resolve(brBuf);
+        });
+        pack.on('error', reject);
+        (async () => {
+            for (const [name, content] of Object.entries(files)) {
+                const buf = Buffer.isBuffer(content) ? content : Buffer.from(content, 'utf8');
+                await new Promise((res, rej) => {
+                    pack.entry({ name }, buf, (err) => (err ? rej(err) : res()));
+                });
+            }
+            pack.finalize();
+        })().catch(reject);
+    });
+}
+async function tryIt(at, label, manifest, files) {
+    const tarBr = await buildTarBr({ 'manifest.json': JSON.stringify(manifest, null, 2), ...files });
+    const p = `/tmp/probe-${Date.now()}.tar.br`;
+    writeFileSync(p, tarBr);
+    console.log(`\n--- ${label} (tar.br: ${tarBr.length} bytes) ---`);
+    const url = await mintBr(at);
+    await upload(url, p);
+    const r = await gql(at, {
+        query: `mutation Q($a:ID!,$v:AppVersionInput!,$m:VersionMetadataInput){appVersionCreate(appId:$a,version:$v,metadata:$m){version{id metadata{versionTag} appModules{uuid handle specification{identifier}}} userErrors{field message category code}}}`,
+        variables: { a: APP, v: { sourceUrl: url }, m: { versionTag: `probe-${Date.now()}`, message: label } },
+    });
+    console.log(`status ${r.status}: ${r.body.slice(0, 1500)}`);
+}
+async function main() {
+    const at = await getAt();
+    const fnWasm = readFileSync(`${WS}/app_extensions/discounts/dist/function.wasm`);
+    const fnWasmB64 = fnWasm.toString('base64');
+    const iq1 = readFileSync(`${WS}/app_extensions/discounts/src/cart_lines_discounts_generate_run.graphql`, 'utf8');
+    const iq2 = readFileSync(`${WS}/app_extensions/discounts/src/cart_delivery_options_discounts_generate_run.graphql`, 'utf8');
+    const targets = [
+        { handle: 'cart.lines.discounts.generate.run', export: 'cart-lines-discounts-generate-run', input_query: iq1 },
+        { handle: 'cart.delivery-options.discounts.generate.run', export: 'cart-delivery-options-discounts-generate-run', input_query: iq2 },
+    ];
+    const uid = randomUUID();
+    await tryIt(at, 'V53: tar.br with <uid>/dist/index.wasm (base64 text), full CLI shape', {
+        name: 'Essential Upsell Test Online',
+        handle: '',
+        modules: [{
+                type: 'function',
+                handle: 'discounts',
+                uid,
+                assets: uid,
+                target: '',
+                config: {
+                    title: 'Discounts',
+                    module_id: randomUUID(),
+                    description: 'Discount function',
+                    app_key: '3384e849dbc1e2588cb63240b79907d3',
+                    api_version: '2026-04',
+                    enable_creation_ui: true,
+                    targets,
+                },
+            }],
+    }, {
+        [`${uid}/dist/index.wasm`]: fnWasmB64,
+    });
+}
+main().catch((e) => { console.error(e); process.exit(1); });
+//# sourceMappingURL=_probeSourceUrl.js.map

package/dist/scripts/_probeSourceUrl.js.map

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

package/dist/scripts/addStore.d.ts

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

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

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

package/dist/scripts/addStore.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+import { parseArgs } from 'node:util';
+import { loadEnv, printEnvSummary, appendStore, readRegistry, } from '@essential-apps/shopify-test-core';
+async function main() {
+    const { values } = parseArgs({
+        options: {
+            shop: { type: 'string' },
+            plan: { type: 'string' },
+        },
+    });
+    const shop = values.shop?.trim();
+    if (!shop) {
+        console.error('Usage: npm run test:online:add -- --shop online-1.myshopify.com [--plan UNLIMITED_APP_DEVELOPMENT]');
+        process.exit(1);
+    }
+    if (!/^[a-z0-9-]+\.myshopify\.com$/.test(shop)) {
+        console.error(`Invalid shop format. Expected "<slug>.myshopify.com", got "${shop}".`);
+        process.exit(1);
+    }
+    const env = loadEnv();
+    printEnvSummary(env);
+    const reg = readRegistry();
+    if (reg.stores.some((s) => s.shop === shop)) {
+        console.error(`Already in registry: ${shop}`);
+        process.exit(1);
+    }
+    const slug = shop.replace('.myshopify.com', '');
+    appendStore({
+        shop,
+        slug,
+        plan: values.plan ?? env.plan,
+        createdAt: new Date().toISOString(),
+        appInstalled: false,
+        status: 'available',
+    });
+    console.log(`✓ Added ${shop} to pool.`);
+    console.log('');
+    console.log('Next: install the dev app on this store.');
+    console.log(`  Make sure your dev server is running, then:`);
+    console.log(`    npm run test:online:install -- --shop ${shop}`);
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=addStore.js.map

package/dist/scripts/addStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addStore.js","sourceRoot":"","sources":["../../src/scripts/addStore.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EACL,OAAO,EACP,eAAe,EACf,WAAW,EACX,YAAY,GACb,MAAM,mCAAmC,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAC3B,OAAO,EAAE;YACP,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SACzB;KACF,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IACjC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CACX,oGAAoG,CACrG,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,OAAO,CAAC,KAAK,CAAC,8DAA8D,IAAI,IAAI,CAAC,CAAC;QACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,eAAe,CAAC,GAAG,CAAC,CAAC;IAErB,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;IAC3B,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,KAAK,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAChD,WAAW,CAAC;QACV,IAAI;QACJ,IAAI;QACJ,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI;QAC7B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,YAAY,EAAE,KAAK;QACnB,MAAM,EAAE,WAAW;KACpB,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,WAAW,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,6CAA6C,IAAI,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/scripts/buildDockerImage.d.ts

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

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

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

package/dist/scripts/buildDockerImage.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+/**
+ * Build the canonical `shopify-test` image from the Dockerfile
+ * bundled in this package. Run from the shopify-test workspace
+ * root:
+ *
+ *   npm run docker:build
+ *
+ * Or directly:
+ *
+ *   node --import tsx packages/runner/src/scripts/buildDockerImage.ts
+ *
+ * The image is amd64-only (Rosetta on Apple Silicon) — see
+ * docker/README.md for why.
+ */
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// Mirrors the npm scope (`@essential-apps/shopify-test`) so anyone
+// inspecting `container images` sees the same name they `npm install`.
+const DEFAULT_TAG = 'essential-apps/shopify-test:latest';
+function dockerContextDir() {
+    // This file lives at packages/runner/src/scripts/ (or dist/scripts/
+    // after build). Walk up + sideways to docker/.
+    const here = dirname(fileURLToPath(import.meta.url));
+    // here = .../packages/runner/{src,dist}/scripts
+    const candidates = [
+        resolve(here, '../../docker'),
+        resolve(here, '../docker'),
+    ];
+    for (const c of candidates) {
+        if (existsSync(resolve(c, 'Dockerfile')))
+            return c;
+    }
+    throw new Error(`Could not locate the Dockerfile under packages/runner/docker/. ` +
+        `Tried: ${candidates.join(', ')}`);
+}
+async function main() {
+    const tag = process.env['SHOPIFY_TEST_IMAGE_TAG'] ?? DEFAULT_TAG;
+    const context = dockerContextDir();
+    console.log('────────────────────────────────────────────────────────────');
+    console.log(' shopify-test docker image build');
+    console.log('────────────────────────────────────────────────────────────');
+    console.log(`  Tag      : ${tag}`);
+    console.log(`  Context  : ${context}`);
+    console.log(`  Arch     : amd64`);
+    console.log('────────────────────────────────────────────────────────────');
+    console.log('');
+    const args = ['build', '--arch', 'amd64', '--tag', tag, context];
+    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=buildDockerImage.js.map

package/dist/scripts/buildDockerImage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildDockerImage.js","sourceRoot":"","sources":["../../src/scripts/buildDockerImage.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,mEAAmE;AACnE,uEAAuE;AACvE,MAAM,WAAW,GAAG,oCAAoC,CAAC;AAEzD,SAAS,gBAAgB;IACvB,oEAAoE;IACpE,+CAA+C;IAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,gDAAgD;IAChD,MAAM,UAAU,GAAG;QACjB,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC;QAC7B,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC;KAC3B,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IACD,MAAM,IAAI,KAAK,CACb,iEAAiE;QAC/D,UAAU,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACpC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,IAAI,WAAW,CAAC;IACjE,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IAEnC,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,gBAAgB,OAAO,EAAE,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACjE,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAChD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/scripts/captureAuth.d.ts

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

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

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