@essential-apps/shopify-test-runner 1.0.0

package/dist/lib/buildSourceBundle.d.ts

@@ -0,0 +1,56 @@
+/** A single entry in the manifest.json's `modules` array. Matches
+ *  the CLI's `ManifestModule` interface from app.ts. */
+export interface ManifestModule {
+    type: string;
+    handle: string;
+    uid: string;
+    /** Folder name inside the archive that holds this module's
+     *  artifacts. Conventionally equal to `uid`. */
+    assets?: string;
+    /** Single-target handle (e.g. "cart.lines.discounts.generate.run").
+     *  Empty string for multi-target functions, omitted for non-targeted
+     *  modules like app_home / branding / app_access. */
+    target?: string;
+    config: Record<string, unknown>;
+}
+export interface BuildSourceBundleOptions {
+    /** The app's top-level display name. Goes into `manifest.name`. */
+    name: string;
+    /** All modules for this deploy. */
+    modules: ManifestModule[];
+    /**
+     * Files to embed in the archive, keyed by their path-inside-the-
+     * archive. Function .wasm files MUST be base64-encoded as text by
+     * the caller (we'd do it here, but the caller already has the
+     * raw wasm and may or may not have other text/binary content —
+     * doing it here would obscure the contract).
+     */
+    files: Record<string, Buffer | string>;
+    /** Output path. Caller owns the path — typically /tmp/<…>.tar.br. */
+    outPath: string;
+    /**
+     * Brotli quality (0-11). Default 7 matches the CLI's choice. Higher
+     * = smaller + slower. Functions + theme bundles fit comfortably in
+     * a few hundred KB at quality 7.
+     */
+    brotliQuality?: number;
+}
+/**
+ * Build a tar+brotli source bundle and write it to `outPath`. Returns
+ * the path written.
+ *
+ * Implementation note: we tar in-memory (chunked into Node Buffers)
+ * then brotli-compress in one shot. Suitable for the < 10MB bundles
+ * we deal with; switch to streaming if that changes.
+ */
+export declare function buildSourceBundle(opts: BuildSourceBundleOptions): Promise<string>;
+/**
+ * Walk an extension directory and return its file contents keyed by
+ * the path-inside-the-archive-folder (i.e. NOT prefixed with the
+ * uid; the caller prepends that). Returns raw Buffers.
+ *
+ * Skips dirs/files that aren't shipped (same list as the inline
+ * theme bundler in deployAppVersion.ts).
+ */
+export declare function readExtensionFilesAsBuffers(extensionDir: string): Record<string, Buffer>;
+//# sourceMappingURL=buildSourceBundle.d.ts.map

package/dist/lib/buildSourceBundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildSourceBundle.d.ts","sourceRoot":"","sources":["../../src/lib/buildSourceBundle.ts"],"names":[],"mappings":"AAyDA;wDACwD;AACxD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ;oDACgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;yDAEqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACvC,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAwCjB;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,MAAM,GACnB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsCxB"}

package/dist/lib/buildSourceBundle.js

@@ -0,0 +1,153 @@
+/**
+ * Assemble the source archive uploaded for `appVersionCreate` via
+ * the `sourceUrl` path.
+ *
+ * What format does Shopify actually accept?
+ * -----------------------------------------
+ * Empirically (May 2026, App Management /unstable/ endpoint): the
+ * server accepts **tar + brotli** (`.tar.br`), AND requires
+ * `sourceExtension: BR` when minting the signed-upload URL via
+ * `appRequestSourceUploadUrl`. The legacy `sourceExtension: ZIP`
+ * branch exists in the schema and returns a working signed URL, but
+ * something downstream chokes on zips that contain a per-extension
+ * folder layout — the server 500s on any zip whose top level has a
+ * `<uid>/...` directory entry. Tar+brotli works.
+ *
+ * This was reverse-engineered from `Shopify/cli`'s bundle pipeline:
+ *   packages/app/src/cli/services/bundle.ts
+ *   packages/cli-kit/src/public/node/archiver.ts
+ * The CLI ALWAYS uses tar+brotli; the ZIP code path appears to be
+ * unused / vestigial.
+ *
+ * Layout inside the archive
+ * -------------------------
+ *   manifest.json                          ← top-level module list
+ *   <module_uid>/dist/index.wasm           ← function WASM, BASE64-
+ *                                            ENCODED AS TEXT (not raw
+ *                                            binary — see below)
+ *   <theme_uid>/assets/<file>              ← theme files, raw bytes
+ *   <theme_uid>/blocks/<file>
+ *   <theme_uid>/locales/<file>
+ *   <theme_uid>/snippets/<file>
+ *
+ * The base64-encoding-of-wasm is THE critical detail that gets you
+ * past `"Wasm file is not present"`. The Shopify CLI does this in
+ * `bundleFunctionExtension(wasmPath, bundlePath)` which calls
+ * `readFile(path, {encoding: 'base64'})` and `writeFile(bundlePath, b64)`.
+ * The server reads the file at `<uid>/dist/index.wasm` and expects
+ * base64 text content, decoding it back to WASM bytes on its side.
+ *
+ * Manifest format
+ * ---------------
+ * Mirrors the CLI's `app.manifest()` builder
+ * (`packages/app/src/cli/models/app/app.ts`). Each module entry has:
+ *   {
+ *     type: <externalIdentifier — e.g. 'function' for plain function>,
+ *     handle: <toml handle>,
+ *     uid: <stable uuid>,
+ *     assets: <uid>,        ← same string as uid; folder name in archive
+ *     target: <contextValue>, ← single-target handle, or '' for multi
+ *     config: { … per-spec deployConfig output … },
+ *   }
+ */
+import { readFileSync, readdirSync, statSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { brotliCompressSync, constants as zlibConst } from 'node:zlib';
+import { pack as tarPack } from 'tar-stream';
+/**
+ * Build a tar+brotli source bundle and write it to `outPath`. Returns
+ * the path written.
+ *
+ * Implementation note: we tar in-memory (chunked into Node Buffers)
+ * then brotli-compress in one shot. Suitable for the < 10MB bundles
+ * we deal with; switch to streaming if that changes.
+ */
+export async function buildSourceBundle(opts) {
+    const manifestJson = JSON.stringify({ name: opts.name, handle: '', modules: opts.modules }, null, 2);
+    const entries = [
+        { name: 'manifest.json', content: Buffer.from(manifestJson, 'utf8') },
+    ];
+    for (const [name, content] of Object.entries(opts.files)) {
+        entries.push({
+            name,
+            content: Buffer.isBuffer(content) ? content : Buffer.from(content, 'utf8'),
+        });
+    }
+    // tar-stream pack: collect chunks, finalize, then brotli-compress.
+    const tarBuf = await new Promise((resolve_, reject) => {
+        const pack = tarPack();
+        const chunks = [];
+        pack.on('data', (c) => chunks.push(c));
+        pack.on('end', () => resolve_(Buffer.concat(chunks)));
+        pack.on('error', reject);
+        (async () => {
+            for (const e of entries) {
+                await new Promise((res, rej) => {
+                    pack.entry({ name: e.name }, e.content, (err) => (err ? rej(err) : res()));
+                });
+            }
+            pack.finalize();
+        })().catch(reject);
+    });
+    const brBuf = brotliCompressSync(tarBuf, {
+        params: {
+            [zlibConst.BROTLI_PARAM_QUALITY]: opts.brotliQuality ?? 7,
+        },
+    });
+    writeFileSync(opts.outPath, brBuf);
+    return opts.outPath;
+}
+/**
+ * Walk an extension directory and return its file contents keyed by
+ * the path-inside-the-archive-folder (i.e. NOT prefixed with the
+ * uid; the caller prepends that). Returns raw Buffers.
+ *
+ * Skips dirs/files that aren't shipped (same list as the inline
+ * theme bundler in deployAppVersion.ts).
+ */
+export function readExtensionFilesAsBuffers(extensionDir) {
+    const SKIP_DIRS = new Set([
+        'node_modules',
+        '.git',
+        'src',
+        'frontend',
+        'generated',
+    ]);
+    const SKIP_FILES = new Set([
+        'shopify.extension.toml',
+        'package.json',
+        'package-lock.json',
+        'tsconfig.json',
+        '.shopifyignore',
+        '.gitignore',
+        'README.md',
+    ]);
+    const out = {};
+    function walk(dir, rel) {
+        for (const name of readdirSync(dir)) {
+            const full = resolve(dir, name);
+            const relPath = rel ? `${rel}/${name}` : name;
+            const st = statSync(full);
+            if (st.isDirectory()) {
+                if (SKIP_DIRS.has(name) || name.startsWith('.'))
+                    continue;
+                walk(full, relPath);
+                continue;
+            }
+            if (SKIP_FILES.has(name))
+                continue;
+            if (name.endsWith('.config.ts') || name.endsWith('.config.mts'))
+                continue;
+            if (name.endsWith('.config.js') || name.endsWith('.config.cjs'))
+                continue;
+            if (name.endsWith('.js.map'))
+                continue; // CLI excludes these
+            if (name.endsWith('.metafile.json'))
+                continue; // CLI excludes these
+            out[relPath] = readFileSync(full);
+        }
+    }
+    walk(extensionDir, '');
+    return out;
+}
+//# sourceMappingURL=buildSourceBundle.js.map

package/dist/lib/buildSourceBundle.js.map

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

package/dist/lib/freePort.d.ts

@@ -0,0 +1,5 @@
+/** Asks the OS for a random free TCP port. */
+export declare function findFreePort(): Promise<number>;
+/** Returns true if the given port is free to bind. */
+export declare function isPortFree(port: number): Promise<boolean>;
+//# sourceMappingURL=freePort.d.ts.map

package/dist/lib/freePort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freePort.d.ts","sourceRoot":"","sources":["../../src/lib/freePort.ts"],"names":[],"mappings":"AAEA,8CAA8C;AAC9C,wBAAgB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAgB9C;AAED,sDAAsD;AACtD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUzD"}

package/dist/lib/freePort.js

@@ -0,0 +1,33 @@
+import { createServer } from 'node:net';
+/** Asks the OS for a random free TCP port. */
+export function findFreePort() {
+    return new Promise((resolve, reject) => {
+        const srv = createServer();
+        srv.unref();
+        srv.on('error', reject);
+        srv.listen(0, '127.0.0.1', () => {
+            const addr = srv.address();
+            if (addr && typeof addr === 'object') {
+                const port = addr.port;
+                srv.close(() => resolve(port));
+            }
+            else {
+                srv.close();
+                reject(new Error('Could not determine free port'));
+            }
+        });
+    });
+}
+/** Returns true if the given port is free to bind. */
+export function isPortFree(port) {
+    return new Promise((resolve) => {
+        const srv = createServer();
+        srv.unref();
+        srv.once('error', () => resolve(false));
+        srv.once('listening', () => {
+            srv.close(() => resolve(true));
+        });
+        srv.listen(port, '127.0.0.1');
+    });
+}
+//# sourceMappingURL=freePort.js.map

package/dist/lib/freePort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"freePort.js","sourceRoot":"","sources":["../../src/lib/freePort.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,8CAA8C;AAC9C,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;QAC3B,GAAG,CAAC,KAAK,EAAE,CAAC;QACZ,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACxB,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE;YAC9B,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;YAC3B,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;gBACvB,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,KAAK,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;YACrD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;QAC3B,GAAG,CAAC,KAAK,EAAE,CAAC;QACZ,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YACzB,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/functionBuild.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Pinned Javy version. Bumping = updating the URL pattern in
+ * `binaryUrlForJavy` AND verifying the `-C` flag interface hasn't
+ * changed across the bump (Javy did break flags between v0.x and v3+).
+ */
+export declare const JAVY_VERSION = "v7.0.1";
+/**
+ * Pinned Shopify Functions Javy plugin wasm. The URL contains the
+ * major version (`_v3`) — if Shopify publishes a `_v4`, we explicitly
+ * decide whether to upgrade (the plugin's host ABI is what user JS
+ * sees via `@shopify/shopify_function`).
+ */
+export declare const PLUGIN_URL = "https://cdn.shopify.com/shopifycloud/shopify-functions-javy-plugin/shopify_functions_javy_v3.wasm";
+/**
+ * Return a path to the Javy binary, downloading it on first use.
+ * Idempotent — second call hits the on-disk cache. `JAVY_BIN`
+ * environment variable bypasses the download and points at a local
+ * build (useful when tracking Javy main).
+ */
+export declare function ensureJavy(): Promise<string>;
+/**
+ * Return a path to the Shopify Functions Javy plugin wasm,
+ * downloading it on first use. `JAVY_PLUGIN_WASM` env overrides for
+ * local plugin development.
+ */
+export declare function ensureJavyPlugin(): Promise<string>;
+/**
+ * One `[[extensions.targeting]]` block in a function's
+ * `shopify.extension.toml`. Maps to one exported function in the
+ * compiled wasm.
+ *
+ *   target       e.g. "cart.lines.discounts.generate.run"  (Shopify-defined)
+ *   export       e.g. "cart-lines-discounts-generate-run"  (what we name
+ *                the wasm export — Shopify's docs use kebab-case here)
+ *   input_query  path (relative to the function dir) of the GraphQL
+ *                query that produces the function's input — embedded
+ *                into the deploy manifest, NOT compiled into the wasm.
+ */
+export interface FunctionTarget {
+    target: string;
+    export: string;
+    inputQueryPath: string;
+}
+/**
+ * Subset of `shopify.extension.toml` that we care about for the build.
+ * We don't validate fields we don't use (e.g. `name`/`description`
+ * which come from locales) so this shape may grow as we touch more
+ * function deploys.
+ */
+export interface ParsedFunctionToml {
+    handle: string;
+    /** Stable per-extension UUID baked into the toml. Shopify uses it
+     * to correlate the manifest entry with the right folder inside the
+     * source zip (the zip layout is `<uid>/dist/function.wasm`). */
+    uid: string;
+    type: 'function';
+    apiVersion: string;
+    /** Each target becomes one exported function in the compiled wasm. */
+    targets: FunctionTarget[];
+    /** `[extensions.build].path` — defaults to `dist/function.wasm`. */
+    outputRelativePath: string;
+}
+/**
+ * Bespoke parser for the function's `shopify.extension.toml`. The
+ * minimal-toml reader in `deployAppVersion.ts` doesn't grok arrays of
+ * inline tables (`[[extensions.targeting]]`), so we do a tiny ad-hoc
+ * parse here. It's intentionally narrow — only handles the shape
+ * `shopify app function init` produces (essentially: a single
+ * `[[extensions]]` table containing N `[[extensions.targeting]]`
+ * sub-tables and one `[extensions.build]` sub-table).
+ *
+ * If/when we deploy a function with multiple top-level `[[extensions]]`
+ * entries (rare — usually one file per extension dir), this needs
+ * generalizing.
+ */
+export declare function parseFunctionToml(path: string): ParsedFunctionToml;
+export interface BuildFunctionWasmOptions {
+    /** Directory containing `shopify.extension.toml` + `src/index.{ts,js}`. */
+    functionDir: string;
+    /**
+     * Optional override for the input source file. Defaults to
+     * src/index.ts / src/index.js. Useful for tests.
+     */
+    entrySource?: string;
+}
+export interface BuildFunctionWasmResult {
+    wasmPath: string;
+    parsedToml: ParsedFunctionToml;
+}
+/**
+ * Build a deployable `.wasm` for a JS Shopify Function.
+ *
+ * Idempotent: rebuilds on every call (we don't try to be clever about
+ * stale-cache detection — esbuild + javy together are ~hundreds of
+ * milliseconds, fast enough that incremental caching is unnecessary
+ * for our use case).
+ */
+export declare function buildFunctionWasm(opts: BuildFunctionWasmOptions): Promise<BuildFunctionWasmResult>;
+//# sourceMappingURL=functionBuild.d.ts.map

package/dist/lib/functionBuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functionBuild.d.ts","sourceRoot":"","sources":["../../src/lib/functionBuild.ts"],"names":[],"mappings":"AAyDA;;;;GAIG;AACH,eAAO,MAAM,YAAY,WAAW,CAAC;AAErC;;;;;GAKG;AACH,eAAO,MAAM,UAAU,sGAC8E,CAAC;AAoFtG;;;;;GAKG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAclD;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAaxD;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf;;oEAEgE;IAChE,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,oEAAoE;IACpE,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CA6ElE;AA0ED,MAAM,WAAW,wBAAwB;IACvC,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CAiElC"}