@essential-apps/shopify-test-runner 1.0.0

package/dist/playwright/globalSetup.js.map

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

package/dist/playwright/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Public Playwright preset for @essential-apps/shopify-test-runner.
+ * Imported by the consuming app's `playwright.config.ts`:
+ *
+ *   import { definePlaywrightConfig } from
+ *     '@essential-apps/shopify-test-runner/playwright';
+ */
+export { definePlaywrightConfig, type DefinePlaywrightConfigOptions, } from './baseConfig.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/playwright/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/playwright/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,GACnC,MAAM,iBAAiB,CAAC"}

package/dist/playwright/index.js

@@ -0,0 +1,9 @@
+/**
+ * Public Playwright preset for @essential-apps/shopify-test-runner.
+ * Imported by the consuming app's `playwright.config.ts`:
+ *
+ *   import { definePlaywrightConfig } from
+ *     '@essential-apps/shopify-test-runner/playwright';
+ */
+export { definePlaywrightConfig, } from './baseConfig.js';
+//# sourceMappingURL=index.js.map

package/dist/playwright/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/playwright/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,sBAAsB,GAEvB,MAAM,iBAAiB,CAAC"}

package/dist/probes/fonts.d.ts

@@ -0,0 +1,4 @@
+import type { Probe } from './types.js';
+declare const probe: Probe;
+export default probe;
+//# sourceMappingURL=fonts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../../src/probes/fonts.ts"],"names":[],"mappings":"AAgDA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AASxC,QAAA,MAAM,KAAK,EAAE,KAmKZ,CAAC;AA0DF,eAAe,KAAK,CAAC"}

package/dist/probes/fonts.js

@@ -0,0 +1,255 @@
+/**
+ * Font-mirror probe.
+ *
+ * Goal: download the actual font WOFF2 files Shopify ships, plus
+ * a manifest mapping `<family>_<handle>` → `{ url, file }`, so the
+ * offline storefront mock can serve byte-identical fonts at
+ * byte-identical URLs.
+ *
+ * Why this can't be a static download script: Shopify's font CDN
+ * URLs have a content hash baked in
+ *   `https://fonts.shopifycdn.com/assistant/assistant_n4.<hash>.woff2`
+ * and that hash isn't published anywhere — you have to render a real
+ * storefront, observe what URL gets emitted by the Liquid
+ * `font_face` filter, then fetch.
+ *
+ * What we do:
+ *   1. Open the online store's homepage. The theme's
+ *      `settings_data.json` picks fonts via handles; `font_face`
+ *      renders @font-face rules whose URLs point at fonts.shopifycdn.com.
+ *   2. Observe page network. Every fonts.shopifycdn.com request is
+ *      a font Shopify is actually using for this theme/store.
+ *   3. Download each font file with the original URL preserved.
+ *   4. Save under:
+ *        packages/themes/themes/_shopify-fonts/<family>/<original-filename>
+ *      and write a manifest.json:
+ *        {
+ *          "assistant_n4": {
+ *            "family": "assistant",
+ *            "handle": "assistant_n4",
+ *            "file":   "assistant_n4.f55fa3ec4ee20.woff2",
+ *            "url":    "https://fonts.shopifycdn.com/assistant/assistant_n4.f55fa3ec4ee20.woff2"
+ *          },
+ *          ...
+ *        }
+ *
+ * Reading the manifest at runtime: `font_face` filter parses the
+ * font handle from its Liquid argument and emits the @font-face
+ * with the URL from the manifest. The storefront mock + edge proxy
+ * serve fonts.shopifycdn.com/<family>/<file> from the bundled
+ * directory.
+ *
+ * To capture fonts the online store doesn't currently use, change the
+ * theme's font settings in the merchant's admin first, then re-run
+ * this probe. (We could automate that too — argue for a follow-up
+ * if it becomes a pain.)
+ */
+import { mkdirSync, readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { resolve, basename } from 'node:path';
+const probe = {
+    name: 'fonts',
+    description: 'Mirror Shopify-hosted fonts the online store uses + write a manifest the offline mock reads.',
+    outputDir: 'packages/themes/themes/_shopify-fonts',
+    async run(ctx) {
+        const passwordFromEnv = process.env['STOREFRONT_PASSWORD'] ?? '';
+        const homeUrl = `https://${ctx.store.shop}/`;
+        console.log(`[fonts] navigating to ${homeUrl}`);
+        // Capture every Shopify-hosted font URL the page references.
+        // Two flavours both end up serving the same blob:
+        //   - canonical:  https://fonts.shopifycdn.com/<family>/<file>.woff2
+        //                 (emitted by Dawn's @font-face `src:` via the
+        //                 `font_url` Liquid filter)
+        //   - per-shop:   https://<shop>.myshopify.com/cdn/fonts/<family>/<file>.woff2
+        //                 (emitted by `<link rel="preload" as="font">` and
+        //                 some CSS variable assignments)
+        // We listen on requests AND scrape the rendered DOM so both
+        // flavours surface; everything gets normalized back to the
+        // canonical fonts.shopifycdn.com URL before download (the manifest
+        // is keyed on the canonical URL because that's what our offline
+        // `font_face` filter emits).
+        const fontUrls = new Set();
+        const captureUrl = (raw) => {
+            const canonical = normalizeToShopifycdn(raw);
+            if (canonical)
+                fontUrls.add(canonical);
+        };
+        ctx.page.on('request', (req) => captureUrl(req.url()));
+        await ctx.page.goto(homeUrl, { waitUntil: 'domcontentloaded' });
+        // Storefront-password gate: type the password from .env.test and
+        // submit. Skips silently if the store doesn't require one.
+        const passwordField = ctx.page.locator('input[name="password"], input#password');
+        if (await passwordField.count().catch(() => 0)) {
+            if (!passwordFromEnv) {
+                throw new Error(`Store ${ctx.store.shop} has a password gate but STOREFRONT_PASSWORD ` +
+                    `is not set in .env.test. Set it or use a public store.`);
+            }
+            console.log('[fonts] entering storefront password');
+            await passwordField.first().fill(passwordFromEnv);
+            await ctx.page.locator('button[type="submit"], input[type="submit"]').first().click();
+            await ctx.page.waitForLoadState('domcontentloaded');
+        }
+        // Wait for network idle so any deferred font loads (e.g. lazy
+        // CSS imports) have a chance to fire.
+        await ctx.page.waitForLoadState('networkidle', { timeout: 30_000 }).catch(() => {
+            console.warn('[fonts] networkidle timed out — proceeding with what we have');
+        });
+        // Some themes embed all @font-face rules but don't actually
+        // fetch the WOFF2 until a glyph is needed. As a backstop, scrape
+        // the rendered DOM for both canonical and per-shop font URLs.
+        const dom = await ctx.page.content();
+        for (const m of dom.matchAll(/https:\/\/fonts\.shopifycdn\.com\/[^"')\s]+/g)) {
+            captureUrl(m[0]);
+        }
+        for (const m of dom.matchAll(/https?:\/\/[^"')\s]+\/cdn\/fonts\/[^"')\s]+/g)) {
+            captureUrl(m[0]);
+        }
+        // Some preload links use protocol-relative `//<shop>/cdn/fonts/...`.
+        for (const m of dom.matchAll(/\/\/[^"')\s]+\/cdn\/fonts\/[^"')\s]+/g)) {
+            captureUrl('https:' + m[0]);
+        }
+        if (fontUrls.size === 0) {
+            throw new Error(`No fonts.shopifycdn.com URLs observed on ${homeUrl}. ` +
+                `The theme may be using a system font (mono/sans/serif handles), ` +
+                `in which case no Shopify fonts are needed — the mock's system stack ` +
+                `is already correct.`);
+        }
+        console.log(`[fonts] discovered ${fontUrls.size} font URL(s)`);
+        // Download each font + record metadata. Use the page's request
+        // context so cookies + headers match what the browser sent
+        // (avoids 403s on hashed URLs that key on referer etc.).
+        const manifest = {};
+        let downloaded = 0;
+        for (const url of fontUrls) {
+            const parsed = parseFontUrl(url);
+            if (!parsed) {
+                console.warn(`[fonts] skipping unrecognized URL shape: ${url}`);
+                continue;
+            }
+            const familyDir = resolve(ctx.outputDir, parsed.family);
+            mkdirSync(familyDir, { recursive: true });
+            const destPath = resolve(familyDir, parsed.file);
+            // Skip re-download if file already exists with same size — keeps
+            // re-runs quick. Use HEAD to compare; if HEAD fails fall through
+            // to a fresh GET.
+            let needFetch = true;
+            if (existsSync(destPath)) {
+                try {
+                    const head = await ctx.page.request.fetch(url, { method: 'HEAD' });
+                    const remoteLen = Number(head.headers()['content-length'] ?? -1);
+                    if (remoteLen > 0) {
+                        const localLen = readFileSync(destPath).byteLength;
+                        if (remoteLen === localLen)
+                            needFetch = false;
+                    }
+                }
+                catch {
+                    /* fall through to GET */
+                }
+            }
+            if (needFetch) {
+                const resp = await ctx.page.request.fetch(url, { method: 'GET' });
+                if (!resp.ok()) {
+                    console.warn(`[fonts] ${resp.status()} ${url} — skipping`);
+                    continue;
+                }
+                const body = await resp.body();
+                writeFileSync(destPath, body);
+                downloaded++;
+                console.log(`[fonts]   ${parsed.handle.padEnd(20)}  ${body.byteLength.toString().padStart(7)}b  ${url}`);
+            }
+            // Prefer woff2 over woff when a handle has both — Shopify ships
+            // both formats from /cdn for browser compatibility; our offline
+            // @font-face filter emits a single `src ... format("woff2")` so
+            // recording the woff URL would cause Chrome to fetch a file we
+            // mis-label as woff2.
+            const existing = manifest[parsed.handle];
+            const isWoff2 = parsed.file.endsWith('.woff2');
+            const existingIsWoff2 = existing?.file.endsWith('.woff2');
+            if (existing && existingIsWoff2 && !isWoff2)
+                continue;
+            manifest[parsed.handle] = {
+                family: parsed.family,
+                handle: parsed.handle,
+                file: parsed.file,
+                url,
+            };
+        }
+        // Merge into existing manifest (so probes run against different
+        // themes accumulate). Conflicting handles overwrite — the latest
+        // run wins.
+        const manifestPath = resolve(ctx.outputDir, 'manifest.json');
+        let existing = {};
+        if (existsSync(manifestPath)) {
+            try {
+                existing = JSON.parse(readFileSync(manifestPath, 'utf8'));
+            }
+            catch {
+                /* corrupted — start fresh */
+            }
+        }
+        const merged = { ...existing, ...manifest };
+        writeFileSync(manifestPath, JSON.stringify(merged, null, 2) + '\n');
+        console.log(`[fonts] downloaded ${downloaded} new file(s); manifest has ${Object.keys(merged).length} entries`);
+        console.log(`[fonts] manifest: ${manifestPath}`);
+    },
+};
+/**
+ * Map a font URL (canonical fonts.shopifycdn.com OR per-shop
+ * `/cdn/fonts/...` proxy) to the canonical fonts.shopifycdn.com URL.
+ * Returns null for anything that doesn't look like a font URL.
+ *
+ * Examples:
+ *   https://fonts.shopifycdn.com/assistant/assistant_n4.<hash>.woff2
+ *     → unchanged
+ *   https://theme-dawn-demo.myshopify.com/cdn/fonts/assistant/assistant_n4.<hash>.woff2
+ *     → https://fonts.shopifycdn.com/assistant/assistant_n4.<hash>.woff2
+ *
+ * The per-shop proxy serves byte-identical files at byte-identical
+ * filenames (Shopify just rewrites the host) so the canonical form is
+ * always recoverable.
+ */
+function normalizeToShopifycdn(raw) {
+    try {
+        const u = new URL(raw);
+        if (u.hostname === 'fonts.shopifycdn.com')
+            return u.toString();
+        // Per-shop proxy path is `/cdn/fonts/<rest>`; strip the prefix
+        // and re-host on fonts.shopifycdn.com.
+        const m = u.pathname.match(/^\/cdn\/fonts\/(.+)$/);
+        if (m) {
+            return `https://fonts.shopifycdn.com/${m[1]}`;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse a fonts.shopifycdn.com URL into:
+ *   family — the URL's first path segment (e.g. `assistant`)
+ *   file   — the trailing filename
+ *   handle — Shopify-style font handle derived from the filename,
+ *            e.g. `assistant_n4.f55fa3ec4ee20.woff2` → `assistant_n4`
+ *
+ * Returns null if the URL doesn't match the expected
+ *   `/<family>/<family>_<style+weight>.<hash>.woff2`
+ * shape — anything else gets logged + skipped rather than guessed.
+ */
+function parseFontUrl(url) {
+    const u = new URL(url);
+    const parts = u.pathname.split('/').filter(Boolean);
+    if (parts.length < 2)
+        return null;
+    const family = parts[0];
+    const file = basename(u.pathname);
+    // handle = the leading "<family>_<code>" before the first dot.
+    // e.g. `assistant_n4.f55fa3ec4ee20.woff2` → `assistant_n4`.
+    // `inter_v1_n4.woff2` → `inter_v1_n4` (handles dotless names too).
+    const handle = file.split('.')[0];
+    if (!handle)
+        return null;
+    return { family, handle, file };
+}
+export default probe;
+//# sourceMappingURL=fonts.js.map

package/dist/probes/fonts.js.map

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

package/dist/probes/mirror.d.ts

@@ -0,0 +1,4 @@
+import type { Probe } from './types.js';
+declare const probe: Probe;
+export default probe;
+//# sourceMappingURL=mirror.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mirror.d.ts","sourceRoot":"","sources":["../../src/probes/mirror.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AA4ExC,QAAA,MAAM,KAAK,EAAE,KA8KZ,CAAC;AAEF,eAAe,KAAK,CAAC"}

package/dist/probes/mirror.js

@@ -0,0 +1,260 @@
+/**
+ * Site mirror probe — capture every static asset a real Shopify
+ * storefront loads (CSS, JS, images, fonts, SVG, …) and bundle them
+ * so the offline mock can serve byte-identical responses at
+ * byte-identical URLs.
+ *
+ * Why: the offline storefront uses real Liquid templates (Dawn), and
+ * Dawn's HTML references ~170 distinct asset URLs on a single page
+ * (theme CSS, theme JS, shopifycloud scripts proxied through the
+ * shop's CDN, fonts, product images, theme images). The fonts probe
+ * handles the fonts subset; this probe handles the rest, end-to-end:
+ *
+ *   1. Open the source storefront page(s) with a real browser.
+ *   2. Watch the network. Capture every GET request to a Shopify
+ *      host that returns 200.
+ *   3. Download each response body.
+ *   4. Save under `packages/themes/themes/_shopify-mirror/<host>/<path>`.
+ *   5. Update `manifest.json`: URL → { file, contentType, size, etag }.
+ *
+ * The mock storefront's edge proxy routes Shopify hostnames into a
+ * single `/__shopify-mirror/*` handler that serves files from this
+ * directory with the captured content-type.
+ *
+ * Re-run idempotent: existing files (same size) are skipped; new
+ * files added, conflicting URLs overwritten with the latest version.
+ * Commit the mirror dir to git so consumers get it from the tarball.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, statSync, rmSync } from 'node:fs';
+import { resolve, dirname, basename } from 'node:path';
+import { vendoredAssetFilenames } from '@essential-apps/shopify-test-themes';
+/**
+ * Hosts whose asset traffic we mirror. Two flavours:
+ *   - exact match (e.g. `cdn.shopify.com`, `fonts.shopifycdn.com`)
+ *   - suffix match for per-shop CDNs (`*.myshopify.com/cdn/*`)
+ *
+ * Tracking endpoints (`monorail-edge.shopifysvc.com`,
+ * `otlp-http-production.shopifysvc.com`) intentionally NOT mirrored —
+ * they're POST-only telemetry that the offline mock already no-ops.
+ */
+function shouldMirror(url) {
+    let u;
+    try {
+        u = new URL(url);
+    }
+    catch {
+        return false;
+    }
+    if (u.protocol !== 'https:' && u.protocol !== 'http:')
+        return false;
+    // Per-shop CDN proxy: any *.myshopify.com under /cdn/.
+    if (u.hostname.endsWith('.myshopify.com') && u.pathname.startsWith('/cdn/'))
+        return true;
+    // Shopify's CDN edge.
+    if (u.hostname === 'cdn.shopify.com')
+        return true;
+    // Fonts CDN.
+    if (u.hostname === 'fonts.shopifycdn.com')
+        return true;
+    // shopifycloud subdomains, if/when used directly.
+    if (u.hostname.endsWith('.shopifycdn.com'))
+        return true;
+    return false;
+}
+/**
+ * Translate a URL to a path on disk under the mirror root:
+ *   https://theme-dawn-demo.myshopify.com/cdn/shop/t/53/assets/global.js?v=12345
+ *     → theme-dawn-demo.myshopify.com/cdn/shop/t/53/assets/global.js
+ *
+ * Query strings are STRIPPED for now — most Shopify asset URLs carry
+ * a `?v=<cachebuster>` that doesn't affect content. If we hit a case
+ * where the same path serves different bodies under different query
+ * params, we'll switch to including a hash of the query.
+ *
+ * Returns null for paths that would escape the mirror root.
+ */
+function pathForUrl(url) {
+    const u = new URL(url);
+    // Strip leading slash so resolve(mirror, p) puts it INSIDE mirror.
+    let p = u.pathname.replace(/^\/+/, '');
+    if (!p)
+        p = '_index';
+    // Defence-in-depth: reject any segment that's `..` etc.
+    if (p.split('/').some((seg) => seg === '..' || seg === ''))
+        return null;
+    return `${u.hostname}/${p}`;
+}
+/**
+ * Pages to crawl. The base URL is whatever the operator passes in
+ * via `--url`; we also visit a couple of canonical sub-pages so the
+ * mirror covers product pages and collection grids, not just the
+ * homepage. Failures on sub-pages are non-fatal (the site might
+ * have password gates, locale redirects, etc.).
+ */
+const CRAWL_PATHS = [
+    '/',
+    '/products.json?limit=1',
+    '/collections/all',
+];
+const probe = {
+    name: 'mirror',
+    description: 'Mirror every static asset (CSS, JS, images, fonts, …) a real Shopify storefront loads.',
+    outputDir: 'packages/themes/themes/_shopify-mirror',
+    async run(ctx) {
+        const passwordFromEnv = process.env['STOREFRONT_PASSWORD'] ?? '';
+        const baseUrl = `https://${ctx.store.shop}`;
+        const mirrorRoot = ctx.outputDir;
+        // Read existing manifest (so reruns merge rather than truncate).
+        const manifestPath = resolve(mirrorRoot, 'manifest.json');
+        const manifest = existsSync(manifestPath)
+            ? (() => {
+                try {
+                    return JSON.parse(readFileSync(manifestPath, 'utf8'));
+                }
+                catch {
+                    return {};
+                }
+            })()
+            : {};
+        // Capture every Shopify asset URL the pages reference. We listen on
+        // BOTH `request` (catches preloads + speculative loads) and
+        // `response` (so we can record content-type from the response
+        // headers without an extra HEAD/GET).
+        const seen = new Set();
+        const captureUrl = (url) => {
+            if (shouldMirror(url))
+                seen.add(url);
+        };
+        ctx.page.on('request', (req) => captureUrl(req.url()));
+        ctx.page.on('response', (resp) => captureUrl(resp.url()));
+        let visited = 0;
+        let passwordHandled = false;
+        for (const path of CRAWL_PATHS) {
+            const url = `${baseUrl}${path}`;
+            console.log(`[mirror] crawl ${url}`);
+            try {
+                await ctx.page.goto(url, { waitUntil: 'domcontentloaded', timeout: 30_000 });
+            }
+            catch (err) {
+                console.warn(`[mirror]   nav failed: ${err.message}`);
+                continue;
+            }
+            // Password gate (only check once — subsequent navigations
+            // already carry the cookie).
+            if (!passwordHandled) {
+                const pwd = ctx.page.locator('input[name="password"], input#password');
+                if (await pwd.count().catch(() => 0)) {
+                    if (!passwordFromEnv) {
+                        throw new Error(`Store ${ctx.store.shop} has a password gate but STOREFRONT_PASSWORD is unset.`);
+                    }
+                    console.log('[mirror]   entering storefront password');
+                    await pwd.first().fill(passwordFromEnv);
+                    await ctx.page.locator('button[type="submit"], input[type="submit"]').first().click();
+                    await ctx.page.waitForLoadState('domcontentloaded');
+                    passwordHandled = true;
+                }
+            }
+            // Let lazy-loaded assets (images below the fold, scripts on
+            // requestIdleCallback, etc.) fire.
+            await ctx.page
+                .waitForLoadState('networkidle', { timeout: 20_000 })
+                .catch(() => { });
+            visited++;
+        }
+        if (visited === 0) {
+            throw new Error(`Failed to load any pages on ${baseUrl}`);
+        }
+        // Also scrape the rendered DOM for asset URLs the network may
+        // not have surfaced (e.g. `<link rel="preload">` references
+        // sometimes don't fetch until a glyph/element is used).
+        const dom = await ctx.page.content();
+        for (const m of dom.matchAll(/https?:\/\/[^"')\s<>]+/g)) {
+            captureUrl(m[0]);
+        }
+        // Protocol-relative.
+        for (const m of dom.matchAll(/(["'(])\/\/([^"')\s<>]+)/g)) {
+            captureUrl('https://' + m[2]);
+        }
+        console.log(`[mirror] ${seen.size} candidate URL(s) discovered`);
+        // Don't mirror files the vendored themes already ship. Dawn's
+        // `/assets/` directory contains 185 CSS/JS/SVG files; real
+        // Shopify serves the SAME logical files (possibly compiled) at
+        // `/cdn/shop/t/<theme-id>/assets/<file>`. Mirroring them
+        // duplicates bytes and creates stale-vs-upgrade drift. Match by
+        // basename — that's the only stable identifier across the
+        // un-compiled (Dawn source) and compiled (CDN) versions.
+        const vendored = vendoredAssetFilenames();
+        // Download each. Use the page's request context so cookies/CF
+        // tokens flow through; some asset URLs 403 without them.
+        let downloaded = 0;
+        let skipped = 0;
+        let skippedVendored = 0;
+        let failed = 0;
+        for (const url of seen) {
+            const rel = pathForUrl(url);
+            if (!rel) {
+                console.warn(`[mirror]   skip unsafe path: ${url}`);
+                failed++;
+                continue;
+            }
+            const fileName = basename(rel);
+            if (vendored.has(fileName)) {
+                skippedVendored++;
+                // Make sure we also DON'T retain a stale copy from a previous
+                // run that pre-dates the skip-vendored rule. (Cleanup is
+                // additive — we remove ONLY the file we'd otherwise overwrite.)
+                const abs = resolve(mirrorRoot, rel);
+                try {
+                    if (existsSync(abs))
+                        rmSync(abs);
+                }
+                catch { /* ignore */ }
+                delete manifest[url];
+                continue;
+            }
+            const abs = resolve(mirrorRoot, rel);
+            // Skip if a file with the same size is already on disk AND
+            // already in the manifest (immutable Shopify URLs include a
+            // content hash so any change means a new URL anyway).
+            if (existsSync(abs) && manifest[url] && statSync(abs).size === manifest[url].size) {
+                skipped++;
+                continue;
+            }
+            let resp;
+            try {
+                resp = await ctx.page.request.fetch(url, { method: 'GET' });
+            }
+            catch (err) {
+                console.warn(`[mirror]   fetch error  ${url}  ${err.message}`);
+                failed++;
+                continue;
+            }
+            if (!resp.ok()) {
+                console.warn(`[mirror]   ${resp.status()}  ${url}`);
+                failed++;
+                continue;
+            }
+            const body = await resp.body();
+            mkdirSync(dirname(abs), { recursive: true });
+            writeFileSync(abs, body);
+            const contentType = (resp.headers()['content-type'] ?? 'application/octet-stream')
+                .split(';')[0]
+                .trim();
+            manifest[url] = {
+                url,
+                file: rel,
+                contentType,
+                size: body.byteLength,
+            };
+            downloaded++;
+            if (downloaded <= 10 || downloaded % 25 === 0) {
+                console.log(`[mirror]   ${downloaded.toString().padStart(3)}  ${body.byteLength.toString().padStart(8)}b  ${contentType.padEnd(28)}  ${url}`);
+            }
+        }
+        writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n');
+        console.log(`[mirror] done: ${downloaded} downloaded, ${skipped} cached, ${skippedVendored} skipped (vendored in theme repo), ${failed} failed, ${Object.keys(manifest).length} total in manifest`);
+        console.log(`[mirror] manifest: ${manifestPath}`);
+    },
+};
+export default probe;
+//# sourceMappingURL=mirror.js.map

package/dist/probes/mirror.js.map

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

package/dist/probes/runProbe.d.ts

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

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

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