@essential-apps/shopify-test-runner 1.0.0

package/dist/edge/edgeProxy.js

@@ -0,0 +1,297 @@
+/**
+ * Edge proxy — a real HTTPS reverse-proxy that takes Chromium
+ * requests for Shopify-shaped hostnames (test-shop.myshopify.com,
+ * admin.shopify.com, cdn.shopify.com) and dispatches them to the
+ * right internal mock based on Host + path.
+ *
+ * Why this exists: we abandoned Playwright's `page.route()` for
+ * routing because `route.fulfill({status: 302, …})` causes
+ * Chromium to follow redirects via its native network stack,
+ * bypassing route handlers — and our `test-shop.myshopify.com`
+ * domain resolves to real Shopify on the public internet, so any
+ * un-intercepted request leaks out of the test harness.
+ *
+ * The fix: drop down a network layer. With Chromium launched via
+ *
+ *   --host-resolver-rules="MAP test-shop.myshopify.com 127.0.0.1:<edgePort>, …"
+ *   --ignore-certificate-errors
+ *
+ * ALL browser traffic to those hostnames (initial requests, redirect
+ * follow-ups, sub-resources, XHR, fetch, service workers) lands at
+ * this proxy. There is no per-request interception layer to bypass.
+ * Redirects are handled by Chromium natively. The browser's URL bar
+ * stays correct.
+ *
+ * The proxy itself uses Node's `http` module (raw — no undici/fetch,
+ * which hangs against sibling-process loopback ports), forwards the
+ * request to the right internal mock, and streams the response back.
+ * 302/307/etc. responses are passed through unchanged; Chromium does
+ * the right thing with them.
+ *
+ * Cert: a static self-signed cert lives in `src/edge/cert.pem` +
+ * `src/edge/key.pem`, with SANs covering `*.myshopify.com`,
+ * `*.shopify.com`, etc. (See `src/edge/openssl.cnf`.) The cert is
+ * trusted because Chromium runs with `--ignore-certificate-errors`.
+ */
+import { createServer as createHttpsServer } from 'node:https';
+import { request as httpRequest } from 'node:http';
+import { TEST_CA_CERT_PEM, TEST_SERVER_CERT_PEM, TEST_SERVER_KEY_PEM, } from './cert.js';
+/**
+ * Resolve an incoming request to (internalBase, overridePath).
+ *
+ * Host-based first (admin/cdn pick a backend), then path-based on
+ * the shop domain (/admin/api/, /api/ go to dedicated mocks).
+ */
+function dispatch(hostHeader, pathWithQuery, shopDomain, backends) {
+    // Strip ":port" — Host may include it; we only care about hostname.
+    const host = hostHeader.split(':')[0]?.toLowerCase() ?? '';
+    const path = pathWithQuery;
+    // ── admin.shopify.com → admin shell ─────────────────────
+    if (host === 'admin.shopify.com') {
+        return { internalBase: backends.adminShell, overridePath: path };
+    }
+    // ── fonts.shopifycdn.com → storefront (handles its /cdn/fonts route) ─
+    // The storefront mock owns the bundled font mirror produced by
+    // the `fonts` probe. Routing the real Shopify font-CDN hostname
+    // here means `font_face` filter output (which contains the real
+    // shopifycdn URL by design) just works in-browser.
+    if (host === 'fonts.shopifycdn.com') {
+        return { internalBase: backends.storefront, overridePath: `/__shopify-fonts${path}` };
+    }
+    // ── *.shopifycdn.com → storefront mirror ────────────────────
+    // Any other Shopify CDN subdomain not handled above falls back to
+    // the generic asset-mirror handler. Bundled by the `mirror` probe.
+    if (host.endsWith('.shopifycdn.com')) {
+        return {
+            internalBase: backends.storefront,
+            overridePath: `/__shopify-mirror/${host}${path}`,
+        };
+    }
+    // ── cdn.shopify.com → split by path ─────────────────────
+    if (host === 'cdn.shopify.com') {
+        // App Bridge + Polaris CSS etc. live under /shopifycloud
+        // and /static, both served by the admin shell mock (which
+        // mirrors Shopify's CDN snapshot at packages/mock-admin/
+        // cdn-mirror).
+        if (path.startsWith('/shopifycloud/')) {
+            return { internalBase: backends.adminShell, overridePath: path };
+        }
+        if (path.startsWith('/static/')) {
+            return { internalBase: backends.adminShell, overridePath: path };
+        }
+        // Extension assets and theme assets live on the storefront
+        // mock. cdn.shopify.com/foo/bar/assets/baz.js → /assets/baz.js
+        if (path.startsWith('/extensions/')) {
+            return { internalBase: backends.storefront, overridePath: path };
+        }
+        const assetIdx = path.lastIndexOf('/assets/');
+        if (assetIdx >= 0) {
+            return {
+                internalBase: backends.storefront,
+                overridePath: path.slice(assetIdx),
+            };
+        }
+        // Fall through: anything else on cdn.shopify.com → storefront.
+        return { internalBase: backends.storefront, overridePath: path };
+    }
+    // ── shop.myshopify.com (or any *.myshopify.com) ──────────
+    if (host === shopDomain.toLowerCase() || host.endsWith('.myshopify.com')) {
+        if (path.startsWith('/admin/api/')) {
+            return { internalBase: backends.adminApi, overridePath: path };
+        }
+        if (path.startsWith('/api/')) {
+            return { internalBase: backends.storefrontApi, overridePath: path };
+        }
+        // Per-shop CDN proxy: theme assets, shopifycloud scripts,
+        // product images, fonts. Real Shopify hosts them all under
+        // `<shop>/cdn/*`. The mirror probe captures these into the
+        // shared mirror dir; serve from there transparently so any
+        // shop hostname resolves to mirrored bytes.
+        if (path.startsWith('/cdn/')) {
+            return {
+                internalBase: backends.storefront,
+                overridePath: `/__shopify-mirror/${host}${path}`,
+            };
+        }
+        return { internalBase: backends.storefront, overridePath: path };
+    }
+    // ── unknown host: best-effort → storefront ─────────────
+    // Chromium with host-resolver-rules wouldn't deliver an
+    // unmapped host here, but if someone hits this directly (a
+    // test using page.request with a custom host header, etc.)
+    // returning storefront 404s with a useful body is friendlier
+    // than connection refused.
+    return { internalBase: backends.storefront, overridePath: path };
+}
+/**
+ * Read a request body into a Buffer. Streaming would be more
+ * memory-efficient, but mock-sized POSTs are tiny (cart items,
+ * form data) and buffering keeps the proxy logic simple.
+ */
+function readBody(req) {
+    return new Promise((resolveBody, rejectBody) => {
+        const chunks = [];
+        req.on('data', (c) => chunks.push(c));
+        req.on('end', () => resolveBody(Buffer.concat(chunks)));
+        req.on('error', rejectBody);
+    });
+}
+/** Forward one request to the chosen internal mock and stream the response back. */
+async function forwardOne(internalBase, overridePath, method, headers, body) {
+    const target = new URL(internalBase);
+    // Drop hop-by-hop headers and the original Host — we set Host
+    // to the internal mock's address so Hono's c.req.url is
+    // consistent.
+    const outHeaders = {};
+    for (const [k, v] of Object.entries(headers)) {
+        if (!v)
+            continue;
+        const lower = k.toLowerCase();
+        if (lower === 'host' || lower === 'connection' || lower === 'keep-alive' || lower === 'transfer-encoding')
+            continue;
+        if (typeof v === 'string')
+            outHeaders[k] = v;
+        else if (Array.isArray(v))
+            outHeaders[k] = v.join(', ');
+    }
+    return new Promise((resolveReq, rejectReq) => {
+        const r = httpRequest({
+            hostname: target.hostname,
+            port: Number(target.port),
+            path: overridePath,
+            method,
+            headers: outHeaders,
+        }, (res) => {
+            const chunks = [];
+            res.on('data', (c) => chunks.push(c));
+            res.on('end', () => resolveReq({
+                status: res.statusCode ?? 502,
+                headers: res.headers,
+                body: Buffer.concat(chunks),
+            }));
+            res.on('error', rejectReq);
+        });
+        r.on('error', rejectReq);
+        if (body.length > 0)
+            r.write(body);
+        r.end();
+    });
+}
+/**
+ * Boot the edge HTTPS proxy. Returns a handle with the bound port
+ * and a `close()` to tear it down.
+ */
+export async function startEdgeProxy(opts) {
+    const server = createHttpsServer({
+        // Send server cert + CA chain so Chrome's chain validation
+        // sees a complete path even without `intermediate_certs`.
+        // Some Chrome versions are stricter about chain
+        // completeness when the CA is "private" (NSS-trusted only).
+        cert: `${TEST_SERVER_CERT_PEM}\n${TEST_CA_CERT_PEM}`,
+        key: TEST_SERVER_KEY_PEM,
+    }, async (req, res) => {
+        try {
+            const hostHeader = req.headers.host ?? '';
+            const pathWithQuery = req.url ?? '/';
+            const { internalBase, overridePath } = dispatch(hostHeader, pathWithQuery, opts.shopDomain, opts.backends);
+            const body = await readBody(req);
+            const proxied = await forwardOne(internalBase, overridePath, req.method ?? 'GET', req.headers, body);
+            // Strip headers that don't make sense to forward verbatim
+            // (Node decompressed the body for us; content-length will
+            // be wrong; transfer-encoding shouldn't survive a hop).
+            const outHeaders = {};
+            for (const [k, v] of Object.entries(proxied.headers)) {
+                if (!v)
+                    continue;
+                const lower = k.toLowerCase();
+                if (lower === 'content-encoding' || lower === 'content-length' || lower === 'transfer-encoding')
+                    continue;
+                if (typeof v === 'string')
+                    outHeaders[k] = v;
+                else if (Array.isArray(v))
+                    outHeaders[k] = v;
+            }
+            // CORS — the offline stack lives behind ONE edge proxy serving
+            // multiple Shopify origins (admin.shopify.com, cdn.shopify.com,
+            // *.myshopify.com). Any cross-origin XHR/fetch issued by the
+            // embedded app or by storefront JS would otherwise be blocked
+            // by Chrome with "TypeError: Failed to fetch" (the symptom in
+            // offline-full-stack tests that try to `fetch('https://cdn.
+            // shopify.com/...')` from an admin.shopify.com page). Real
+            // Shopify sets these on cdn.shopify.com responses too. Allow
+            // everything because this is a test-only proxy bound to
+            // 127.0.0.1 — no real traffic ever reaches it.
+            if (!outHeaders['Access-Control-Allow-Origin']) {
+                outHeaders['Access-Control-Allow-Origin'] = '*';
+            }
+            if (!outHeaders['Access-Control-Allow-Methods']) {
+                outHeaders['Access-Control-Allow-Methods'] =
+                    'GET, POST, PUT, PATCH, DELETE, OPTIONS';
+            }
+            if (!outHeaders['Access-Control-Allow-Headers']) {
+                outHeaders['Access-Control-Allow-Headers'] = '*';
+            }
+            if (!outHeaders['Access-Control-Expose-Headers']) {
+                outHeaders['Access-Control-Expose-Headers'] = '*';
+            }
+            // Short-circuit CORS preflights (the upstream mock might not
+            // implement OPTIONS at all; serving them here is cheaper anyway).
+            if (req.method === 'OPTIONS') {
+                res.writeHead(204, outHeaders);
+                res.end();
+                return;
+            }
+            res.writeHead(proxied.status, outHeaders);
+            res.end(proxied.body);
+            if (process.env['TEST_OFFLINE_EDGE_DEBUG'] === 'true') {
+                console.log(`[edge] ${req.method} https://${hostHeader}${pathWithQuery} → ${internalBase}${overridePath} → ${proxied.status}`);
+            }
+        }
+        catch (err) {
+            console.error('[edge] error:', err.message);
+            res.writeHead(502, { 'content-type': 'text/plain' });
+            res.end(`edge proxy error: ${err.message}`);
+        }
+    });
+    // Wait for listen() to either succeed OR error. Without an error
+    // handler, a failed bind (EADDRINUSE, EACCES on <1024 without
+    // privileges, no IPv6 stack when hostname='::', etc.) leaves the
+    // promise unresolved and the whole offline test run hangs silently.
+    const targetHost = opts.hostname ?? '127.0.0.1';
+    const targetPort = opts.port ?? 0;
+    // Wait for listen() to either succeed OR fail. Without explicit
+    // error/timeout handling, a failed bind (EADDRINUSE; EACCES on
+    // <1024 ports without privileges; a kernel that hangs on `::`
+    // dual-stack bind — the VM's libkrun does this) leaves the
+    // promise unresolved and the whole offline run stalls silently.
+    // The 10 s timeout surfaces any "listen never called back" case
+    // as a real error instead of a wedge.
+    await new Promise((resolveListen, rejectListen) => {
+        const timer = setTimeout(() => {
+            rejectListen(new Error(`edge proxy listen() did not call back within 10 s on ${targetHost}:${targetPort} ` +
+                `(no 'error' event, no 'listening' callback). Kernel issue? ` +
+                `Try '0.0.0.0' instead of '::'.`));
+        }, 10_000);
+        const onError = (err) => {
+            clearTimeout(timer);
+            server.off('error', onError);
+            rejectListen(new Error(`edge proxy bind failed on ${targetHost}:${targetPort}: ` +
+                `${err.code ?? '?'} ${err.message}`));
+        };
+        server.on('error', onError);
+        server.listen(targetPort, targetHost, () => {
+            clearTimeout(timer);
+            server.off('error', onError);
+            resolveListen();
+        });
+    });
+    const addr = server.address();
+    return {
+        port: addr.port,
+        baseUrl: `https://${opts.hostname ?? '127.0.0.1'}:${addr.port}`,
+        close: () => new Promise((resolveClose, rejectClose) => {
+            server.close((err) => (err ? rejectClose(err) : resolveClose()));
+        }),
+    };
+}
+//# sourceMappingURL=edgeProxy.js.map

package/dist/edge/edgeProxy.js.map

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

package/dist/edge/nodeShim.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=nodeShim.d.ts.map

package/dist/edge/nodeShim.d.ts.map

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

package/dist/edge/nodeShim.js

@@ -0,0 +1,217 @@
+/**
+ * Node-side socket-layer shim that routes Shopify hostnames to the
+ * edge proxy. Mirrors what `--host-resolver-rules` does for Chromium,
+ * but for the Node runtime that Playwright tests execute in.
+ *
+ * Why this exists:
+ *   Chromium's `--host-resolver-rules` only affects the browser.
+ *   Node's HTTP stack — used by Playwright's `page.request`, by
+ *   `globalThis.fetch` (undici-based), and by anything calling
+ *   `node:http` / `node:https` directly — uses Node's own DNS. A
+ *   test that does `page.request.get('https://test-shop.myshopify.com/x')`
+ *   would resolve that hostname via Node's DNS and hit real Shopify
+ *   on the public internet.
+ *
+ * What this does:
+ *   - Patches `dns.lookup` so `*.shopify.com` / `*.myshopify.com`
+ *     resolve to `127.0.0.1`.
+ *   - Patches `net.createConnection` (the path every HTTPS client
+ *     eventually takes, including undici) so when the resolved
+ *     address is `127.0.0.1` AND the original hostname was a
+ *     Shopify host, the connect targets the edge port instead of
+ *     the original 80/443.
+ *
+ * Net effect: any Node-side HTTP/HTTPS request to a Shopify
+ * hostname lands on our edge proxy. From the calling code's
+ * perspective, it's hitting real Shopify; only the kernel-adjacent
+ * shim knows the difference. TLS SNI carries the original hostname
+ * to the edge, which presents a cert with broad SANs for it.
+ *
+ * Loading: import this module BEFORE Playwright loads its HTTP
+ * machinery — `NODE_OPTIONS=--import <path-to-built-shim.js>` is
+ * the canonical hook (Node 20.6+). The orchestrator sets this when
+ * it spawns Playwright.
+ *
+ * Env: reads `E2E_MOCK_EDGE_PORT` at module load. If unset, the
+ * shim no-ops (so loading it in non-offline contexts is harmless).
+ */
+import dns from 'node:dns';
+import net from 'node:net';
+const SHOPIFY_HOSTNAME = /(?:^|\.)(my)?shopify\.com$/i;
+const EDGE_PORT = process.env['E2E_MOCK_EDGE_PORT']
+    ? Number(process.env['E2E_MOCK_EDGE_PORT'])
+    : undefined;
+if (EDGE_PORT && Number.isFinite(EDGE_PORT)) {
+    installDnsPatch();
+    installConnectPatch(EDGE_PORT);
+    // Accept self-signed certs at the Node TLS layer. The edge proxy
+    // serves a self-signed cert for *.myshopify.com / *.shopify.com
+    // (see packages/runner/src/edge/cert.ts) — Chromium already
+    // accepts it via the `--ignore-certificate-errors` launch flag,
+    // and Playwright's APIRequestContext inherits the BrowserContext's
+    // `ignoreHTTPSErrors: true`. But raw `globalThis.fetch` (undici)
+    // and direct `https.request` calls in the test process have no
+    // per-call override — they need this process-level flag.
+    //
+    // SCOPE: this affects ALL TLS in the test process, not just
+    // Shopify hostnames. That's acceptable here because:
+    //   1. The test process should never make TLS connections that
+    //      depend on cert verification — production Shopify code
+    //      runs in the Remix backend (a separate process), not here.
+    //   2. The shim already aggressively redirects to localhost via
+    //      DNS+connect patches; cert verification on those would
+    //      always fail anyway (hostname mismatch).
+    // If a future test genuinely needs strict TLS verification against
+    // a real public host, it should reset this flag locally for that
+    // request.
+    process.env['NODE_TLS_REJECT_UNAUTHORIZED'] = '0';
+    if (process.env['E2E_OFFLINE_SHIM_DEBUG'] === 'true') {
+        console.error(`[node-shim] Shopify hostname routing → 127.0.0.1:${EDGE_PORT}; ` +
+            `NODE_TLS_REJECT_UNAUTHORIZED=0 (test-process scope)`);
+    }
+}
+else if (process.env['E2E_OFFLINE_SHIM_DEBUG'] === 'true') {
+    console.error('[node-shim] E2E_MOCK_EDGE_PORT not set — shim is a no-op');
+}
+/**
+ * Patch `dns.lookup` so Shopify hostnames resolve to 127.0.0.1.
+ * Every HTTP client in Node ultimately calls this (or `dns.lookup`
+ * with the `family`/`hints` options form). We handle both shapes.
+ *
+ * Don't patch `dns.resolve*` — those do direct DNS queries (used
+ * for explicit DNS-record inspection, not for connection setup);
+ * patching them would surprise tests that genuinely want to query
+ * DNS records.
+ */
+function installDnsPatch() {
+    const origLookup = dns.lookup;
+    /**
+     * Signature variants to support:
+     *   dns.lookup(hostname, callback)
+     *   dns.lookup(hostname, family, callback)
+     *   dns.lookup(hostname, options, callback)
+     */
+    const patched = function patched(hostname, optionsOrCallback, maybeCallback) {
+        if (!SHOPIFY_HOSTNAME.test(hostname)) {
+            // Pass through to the original — same arity & types.
+            return origLookup.call(dns, hostname, optionsOrCallback, maybeCallback);
+        }
+        // Synthesize the response Node's resolver would have produced.
+        const cb = typeof optionsOrCallback === 'function' ? optionsOrCallback : maybeCallback;
+        const opts = typeof optionsOrCallback === 'object' && optionsOrCallback !== null
+            ? optionsOrCallback
+            : { family: typeof optionsOrCallback === 'number' ? optionsOrCallback : 0 };
+        if (typeof cb !== 'function') {
+            // No callback → Promise form. Node 18+ supports this via
+            // `dns/promises`, but `dns.lookup` itself is callback-only.
+            // If someone calls it without a callback, that's their bug —
+            // throw the same TypeError Node would.
+            throw new TypeError('dns.lookup: callback required');
+        }
+        const address = { address: '127.0.0.1', family: 4 };
+        if (opts.all) {
+            cb(null, [address]);
+        }
+        else {
+            cb(null, address.address, address.family);
+        }
+        return undefined;
+    };
+    // `dns.lookup` is a property of the `dns` module object; reassigning
+    // it affects every consumer that does `dns.lookup(...)` (which is
+    // every Node HTTP client). `Object.defineProperty` rather than `=`
+    // to avoid surprise from frozen properties in future Node versions.
+    Object.defineProperty(dns, 'lookup', { value: patched, writable: true, configurable: true });
+}
+/**
+ * Patch `net.createConnection` (aliased as `net.connect`) so that
+ * outbound TCP connections to Shopify hosts get their port rewritten
+ * to the edge port. The hostname is preserved on the socket, so TLS
+ * SNI carries it through and the edge sees the real Host header.
+ *
+ * Detection: we look at the `host` option (most callers) or the
+ * `hostname` option (some), AND/OR the path option (Unix sockets,
+ * irrelevant here). If neither matches, we pass through.
+ */
+function installConnectPatch(edgePort) {
+    /**
+     * Decide whether a connect() call should be rewritten to the edge.
+     *
+     * Two triggers:
+     *   1. `host` is a Shopify hostname (e.g. callers that pass
+     *      hostname+port to net.connect and let the kernel resolve
+     *      DNS during connect).
+     *   2. `host` is loopback (127.0.0.1 / ::1) AND port is 80/443.
+     *      This catches clients that resolve DNS themselves (undici
+     *      does this — calls dns.lookup, then connects with the IP).
+     *      Our dns.lookup patch maps Shopify hostnames to 127.0.0.1;
+     *      the only way loopback:80/443 happens in the test process
+     *      is via that redirected resolution.
+     */
+    function parseAndMaybeRewrite(args) {
+        const first = args[0];
+        let opts = null;
+        if (typeof first === 'object' && first !== null && !Array.isArray(first)) {
+            opts = first;
+        }
+        else if (typeof first === 'number') {
+            const second = args[1];
+            const host = typeof second === 'string' ? second : undefined;
+            opts = host !== undefined ? { port: first, host } : { port: first };
+        }
+        if (!opts)
+            return null;
+        const host = opts.host ?? opts.hostname;
+        const isShopifyHost = !!host && SHOPIFY_HOSTNAME.test(host);
+        const isLoopback = host === '127.0.0.1' || host === '::1' || host === '::ffff:127.0.0.1';
+        const isWellKnownPort = opts.port === 80 || opts.port === 443;
+        const shouldRedirect = isShopifyHost || (isLoopback && isWellKnownPort);
+        if (!shouldRedirect)
+            return null;
+        if (process.env['E2E_OFFLINE_SHIM_DEBUG'] === 'true') {
+            console.error(`[node-shim] connect ${host}:${opts.port ?? '?'} → 127.0.0.1:${edgePort}`);
+        }
+        return { ...opts, port: edgePort };
+    }
+    // ── 1. net.createConnection / net.connect ───────────────────
+    // Path used by `http.request` / `https.request` (Node's built-in
+    // HTTP clients) and many libraries built on them.
+    const origCreate = net.createConnection;
+    const patchedCreate = function patchedCreate(...args) {
+        const rewritten = parseAndMaybeRewrite(args);
+        if (rewritten) {
+            const listener = args.find((a) => typeof a === 'function');
+            return listener
+                ? origCreate.call(net, rewritten, listener)
+                : origCreate.call(net, rewritten);
+        }
+        return origCreate.apply(net, args);
+    };
+    Object.defineProperty(net, 'createConnection', {
+        value: patchedCreate,
+        writable: true,
+        configurable: true,
+    });
+    Object.defineProperty(net, 'connect', {
+        value: patchedCreate,
+        writable: true,
+        configurable: true,
+    });
+    // ── 2. net.Socket.prototype.connect ─────────────────────────
+    // Path used by undici (Node's built-in `fetch`). undici creates
+    // a Socket directly and calls .connect() on it — bypassing
+    // net.createConnection entirely. Patch the prototype method so
+    // it gets the same rewrite treatment.
+    const origSocketConnect = net.Socket.prototype.connect;
+    net.Socket.prototype.connect = function patchedSocketConnect(...args) {
+        const rewritten = parseAndMaybeRewrite(args);
+        if (rewritten) {
+            const listener = args.find((a) => typeof a === 'function');
+            return listener
+                ? origSocketConnect.call(this, rewritten, listener)
+                : origSocketConnect.call(this, rewritten);
+        }
+        return origSocketConnect.apply(this, args);
+    };
+}
+//# sourceMappingURL=nodeShim.js.map

package/dist/edge/nodeShim.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Public API of @essential-apps/shopify-test-runner.
+ *
+ * The CLI binaries (shopify-test-run-docker, etc.) are exposed via
+ * the `bin` field in package.json — they don't import from this
+ * file. This module re-exports a few utilities that consuming apps
+ * occasionally use programmatically (port checking, stealth browser
+ * launch).
+ *
+ * Most apps will only import from this package's `/playwright`
+ * subpath:
+ *   import { definePlaywrightConfig } from
+ *     '@essential-apps/shopify-test-runner/playwright';
+ */
+export { isPortFree, findFreePort } from './lib/freePort.js';
+export { launchStealthBrowser, stealthLaunchArgs } from './lib/stealthLaunch.js';
+/**
+ * Shopify Functions JS-source → deployable .wasm pipeline. Builds
+ * without the Shopify CLI; downloads stock Javy + the Shopify-CDN
+ * plugin .wasm on first use. See `./lib/functionBuild.ts` for the
+ * full rationale.
+ */
+export { buildFunctionWasm, ensureJavy, ensureJavyPlugin, parseFunctionToml, JAVY_VERSION, PLUGIN_URL, } from './lib/functionBuild.js';
+export type { BuildFunctionWasmOptions, BuildFunctionWasmResult, FunctionTarget, ParsedFunctionToml, } from './lib/functionBuild.js';
+/**
+ * App Management API source-zip upload helpers — used together
+ * when deploying app versions that contain a function or
+ * post-purchase extension (their binary artifacts don't fit
+ * inline in the `source` manifest).
+ */
+export { requestSourceUploadUrl, uploadSourceToSignedUrl, } from './lib/sourceZipUpload.js';
+export type { RequestSourceUploadUrlOptions, UploadSourceOptions, } from './lib/sourceZipUpload.js';
+/**
+ * Source-bundle (zip) assembly. Produces the artifact uploaded to
+ * GCS and referenced via `AppVersionInput.sourceUrl`.
+ */
+export { buildSourceBundle, readExtensionFilesAsBuffers, } from './lib/buildSourceBundle.js';
+export type { BuildSourceBundleOptions, ManifestModule, } from './lib/buildSourceBundle.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEjF;;;;;GAKG;AACH,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,UAAU,GACX,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,wBAAwB,EACxB,uBAAuB,EACvB,cAAc,EACd,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAEhC;;;;;GAKG;AACH,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,OAAO,EACL,iBAAiB,EACjB,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,wBAAwB,EACxB,cAAc,GACf,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,36 @@
+/**
+ * Public API of @essential-apps/shopify-test-runner.
+ *
+ * The CLI binaries (shopify-test-run-docker, etc.) are exposed via
+ * the `bin` field in package.json — they don't import from this
+ * file. This module re-exports a few utilities that consuming apps
+ * occasionally use programmatically (port checking, stealth browser
+ * launch).
+ *
+ * Most apps will only import from this package's `/playwright`
+ * subpath:
+ *   import { definePlaywrightConfig } from
+ *     '@essential-apps/shopify-test-runner/playwright';
+ */
+export { isPortFree, findFreePort } from './lib/freePort.js';
+export { launchStealthBrowser, stealthLaunchArgs } from './lib/stealthLaunch.js';
+/**
+ * Shopify Functions JS-source → deployable .wasm pipeline. Builds
+ * without the Shopify CLI; downloads stock Javy + the Shopify-CDN
+ * plugin .wasm on first use. See `./lib/functionBuild.ts` for the
+ * full rationale.
+ */
+export { buildFunctionWasm, ensureJavy, ensureJavyPlugin, parseFunctionToml, JAVY_VERSION, PLUGIN_URL, } from './lib/functionBuild.js';
+/**
+ * App Management API source-zip upload helpers — used together
+ * when deploying app versions that contain a function or
+ * post-purchase extension (their binary artifacts don't fit
+ * inline in the `source` manifest).
+ */
+export { requestSourceUploadUrl, uploadSourceToSignedUrl, } from './lib/sourceZipUpload.js';
+/**
+ * Source-bundle (zip) assembly. Produces the artifact uploaded to
+ * GCS and referenced via `AppVersionInput.sourceUrl`.
+ */
+export { buildSourceBundle, readExtensionFilesAsBuffers, } from './lib/buildSourceBundle.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEjF;;;;;GAKG;AACH,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,UAAU,GACX,MAAM,wBAAwB,CAAC;AAQhC;;;;;GAKG;AACH,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAMlC;;;GAGG;AACH,OAAO,EACL,iBAAiB,EACjB,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC"}