@vmz/test 0.1.18 → 0.1.19

package/dist/browser.d.ts

@@ -23,6 +23,8 @@ export type BrowserResult = {
 };
 export declare function runBrowserManifest(manifest: Record<string, unknown>, ctx: {
     outDir: string;
+    /** Optional `profiles.*.name` hint when resolving nested delivery roots. */
+    deliveryName?: string | null;
 }): Promise<BrowserResult>;
 /** Resolve chrome path (for gates / diagnostics). */
 export declare function resolveBrowserExecutable(): string | null;

package/dist/browser.js

@@ -20,6 +20,7 @@ import { resolveComponentEntries } from '@vmz/core/component-registry';
 import { resolveChunkArtifacts } from './compile.js';
 import { createArtifactsDir, writeFailureEvidence, writeTimingOnly } from './browser-evidence.js';
 import { isServeHostManifest, resolveRoutePath, startServeHost } from './browser-serve.js';
+import { resolveDeliveryServeRoot } from './delivery-serve-root.js';
 import { defaultClickLocator, parseActionLocator, resolveLocatorInPage, sleep, } from './browser-protocol.js';
 const MIME = {
     '.html': 'text/html; charset=utf-8',
@@ -174,6 +175,8 @@ export async function runBrowserManifest(manifest, ctx) {
     const fail = (message, extra = {}) => {
         diagnostics.push({ severity: 'error', message, ...extra });
     };
+    // `--out-dir` root may nest under `profiles.*.name` (e.g. dist/cdn). Serve that root.
+    const outDir = resolveDeliveryServeRoot(ctx.outDir, ctx.deliveryName);
     const program = manifest.program && typeof manifest.program === 'object' ? manifest.program : {};
     const chunkId = String(program.chunkId || '');
     const programId = chunkId || null;
@@ -187,14 +190,14 @@ export async function runBrowserManifest(manifest, ctx) {
         return { status: 'error', diagnostics, planId: null, programId: null };
     }
     if (!useServe) {
-        const arts = resolveChunkArtifacts(ctx.outDir, chunkId);
+        const arts = resolveChunkArtifacts(outDir, chunkId);
         if (!arts.clientPath) {
             fail(`missing ${chunkId}.client.js`);
             return { status: 'failed', diagnostics, planId: null, programId };
         }
     }
-    else if (!fs.existsSync(path.join(ctx.outDir, 'vmz-serve-host.mjs'))) {
-        fail(`serve host: missing vmz-serve-host.mjs under ${ctx.outDir}`);
+    else if (!fs.existsSync(path.join(outDir, 'vmz-serve-host.mjs'))) {
+        fail(`serve host: missing vmz-serve-host.mjs under ${outDir}`);
         return { status: 'failed', diagnostics, planId: null, programId };
     }
     const chrome = findChromeExecutable();
@@ -212,7 +215,7 @@ export async function runBrowserManifest(manifest, ctx) {
     const runStarted = Date.now();
     const consoleErrors = [];
     const failedRequests = [];
-    const artifactsDir = createArtifactsDir(ctx.outDir, testId);
+    const artifactsDir = createArtifactsDir(outDir, testId);
     const recordStep = (phase, kind, started, ok, detail) => {
         stepTimings.push({ phase, kind, ms: Date.now() - started, ok, detail });
     };
@@ -220,11 +223,11 @@ export async function runBrowserManifest(manifest, ctx) {
         const puppeteer = await loadPuppeteerCore();
         let origin;
         if (useServe) {
-            serveHost = await startServeHost(ctx.outDir);
+            serveHost = await startServeHost(outDir);
             origin = serveHost.origin;
         }
         else {
-            server = await startStaticServer(ctx.outDir);
+            server = await startStaticServer(outDir);
             origin = `http://127.0.0.1:${server.port}`;
         }
         // CI: spawn+connect first (puppeteer.launch often "Connection closed" on Chrome for Testing).
@@ -335,7 +338,7 @@ export async function runBrowserManifest(manifest, ctx) {
             await page.goto(`${origin}/__vmz/harness`, { waitUntil: 'domcontentloaded' });
             const explicitComponents = program.components && typeof program.components === 'object' ? program.components : undefined;
             const registryStrict = process.env.CI === 'true' || process.env.GITHUB_ACTIONS === 'true';
-            const registryEntries = await resolveComponentEntries(ctx.outDir, explicitComponents, {
+            const registryEntries = await resolveComponentEntries(outDir, explicitComponents, {
                 strict: registryStrict,
                 closureRoots: [chunkId.replace(/\\/g, '/')],
             });
@@ -388,7 +391,7 @@ export async function runBrowserManifest(manifest, ctx) {
             let stepOk = true;
             try {
                 if (kind === 'open' || kind === 'navigate') {
-                    const pathname = resolveRoutePath(ctx.outDir, {
+                    const pathname = resolveRoutePath(outDir, {
                         routeId: a.routeId != null ? String(a.routeId) : undefined,
                         path: a.path != null ? String(a.path) : undefined,
                         params: a.params && typeof a.params === 'object'
@@ -583,7 +586,7 @@ export async function runBrowserManifest(manifest, ctx) {
                             }, wantRouteId);
                             if (!hit && loc.path) {
                                 try {
-                                    const resolved = resolveRoutePath(ctx.outDir, { routeId: wantRouteId });
+                                    const resolved = resolveRoutePath(outDir, { routeId: wantRouteId });
                                     if (loc.path !== resolved && !loc.path.endsWith(resolved))
                                         ok = false;
                                     else

package/dist/compile.d.ts

@@ -17,6 +17,8 @@ export type CreateWorkspaceFn = (opts: {
 export type BuildOptions = {
     createWorkspace?: CreateWorkspaceFn;
     repoRoot?: string;
+    /** Hint for nested `profiles.*.name` when resolving the serve/artifact root. */
+    deliveryName?: string | null;
 };
 export type BuildResult = {
     ok: true;

package/dist/compile.js

@@ -7,8 +7,12 @@ import os from 'node:os';
 import path from 'node:path';
 import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
+import { resolveDeliveryServeRoot } from './delivery-serve-root.js';
 const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
 const repoRootGuess = path.resolve(packageRoot, '../../..');
+function finishBuildOutDir(dist, deliveryName) {
+    return resolveDeliveryServeRoot(dist, deliveryName);
+}
 /** Build project for compile/logic evidence. Prefers N-API `createWorkspace`, else Node `@vmz/vmz`. */
 export function buildForCompile(project, outDir, options = {}) {
     const dist = outDir || fs.mkdtempSync(path.join(os.tmpdir(), 'vmz-test-compile-'));
@@ -31,7 +35,7 @@ export function buildForCompile(project, outDir, options = {}) {
                         error: 'workspace build reported errors',
                     };
                 }
-                return { ok: true, outDir: dist, diagnostics: diags };
+                return { ok: true, outDir: finishBuildOutDir(dist, options.deliveryName), diagnostics: diags };
             }
             finally {
                 ws.dispose();
@@ -52,7 +56,7 @@ export function buildForCompile(project, outDir, options = {}) {
             encoding: 'utf8',
         });
         if (run.status === 0) {
-            return { ok: true, outDir: dist, diagnostics: [] };
+            return { ok: true, outDir: finishBuildOutDir(dist, options.deliveryName), diagnostics: [] };
         }
         return {
             ok: false,

package/dist/delivery-serve-root.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Resolve the delivery artifact root for Browser Host / serve-host.
+ *
+ * `vmz build --out-dir <D>` with `profiles.*.name: 'cdn'` writes under `<D>/cdn`
+ * (see delivery `name` contract). `@vmz/test` must serve that nested root — not
+ * assume HTML / `vmz-serve-host.mjs` live at `<D>/`.
+ */
+/** True when `dir` looks like a built delivery tree (serve-host or static index). */
+export declare function isDeliveryServeRoot(dir: string): boolean;
+/**
+ * Map CLI `--out-dir` root → profile delivery root (`outDir/<name>`).
+ *
+ * Prefer `preferredName` when provided (from the selected delivery profile).
+ * Otherwise pick the sole nested delivery child, preferring a tree that has
+ * `vmz-serve-host.mjs`. If the root itself is already a delivery tree, return it.
+ */
+export declare function resolveDeliveryServeRoot(outDirRoot: string, preferredName?: string | null): string;

package/dist/delivery-serve-root.js

@@ -0,0 +1,58 @@
+/**
+ * Resolve the delivery artifact root for Browser Host / serve-host.
+ *
+ * `vmz build --out-dir <D>` with `profiles.*.name: 'cdn'` writes under `<D>/cdn`
+ * (see delivery `name` contract). `@vmz/test` must serve that nested root — not
+ * assume HTML / `vmz-serve-host.mjs` live at `<D>/`.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+const SERVE_HOST = 'vmz-serve-host.mjs';
+const DEPLOYMENT = 'vmz-deployment.json';
+/** True when `dir` looks like a built delivery tree (serve-host or static index). */
+export function isDeliveryServeRoot(dir) {
+    if (!dir || !fs.existsSync(dir))
+        return false;
+    return (fs.existsSync(path.join(dir, SERVE_HOST)) ||
+        fs.existsSync(path.join(dir, 'index.html')) ||
+        fs.existsSync(path.join(dir, DEPLOYMENT)) ||
+        fs.existsSync(path.join(dir, '_vmz')));
+}
+/**
+ * Map CLI `--out-dir` root → profile delivery root (`outDir/<name>`).
+ *
+ * Prefer `preferredName` when provided (from the selected delivery profile).
+ * Otherwise pick the sole nested delivery child, preferring a tree that has
+ * `vmz-serve-host.mjs`. If the root itself is already a delivery tree, return it.
+ */
+export function resolveDeliveryServeRoot(outDirRoot, preferredName) {
+    const root = path.resolve(outDirRoot);
+    if (isDeliveryServeRoot(root))
+        return root;
+    const preferred = typeof preferredName === 'string' ? preferredName.trim() : '';
+    if (preferred) {
+        const nested = path.join(root, preferred);
+        if (isDeliveryServeRoot(nested))
+            return nested;
+    }
+    if (!fs.existsSync(root) || !fs.statSync(root).isDirectory())
+        return root;
+    const children = fs
+        .readdirSync(root, { withFileTypes: true })
+        .filter((d) => d.isDirectory() && d.name !== 'node_modules' && !d.name.startsWith('.'))
+        .map((d) => path.join(root, d.name))
+        .filter(isDeliveryServeRoot);
+    if (children.length === 0)
+        return root;
+    if (children.length === 1)
+        return children[0];
+    const withHost = children.filter((d) => fs.existsSync(path.join(d, SERVE_HOST)));
+    const pool = withHost.length > 0 ? withHost : children;
+    const cdn = pool.find((d) => path.basename(d) === 'cdn');
+    if (cdn)
+        return cdn;
+    const staticName = pool.find((d) => path.basename(d) === 'static');
+    if (staticName)
+        return staticName;
+    return pool[0];
+}

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export { runSsrManifest, type SsrResult } from './ssr.js';
 export { runResumeManifest, type ResumeResult } from './resume.js';
 export { runDeploymentManifest, type DeploymentResult } from './deployment.js';
 export { runBrowserManifest, resolveBrowserExecutable, type BrowserResult, } from './browser.js';
+export { isDeliveryServeRoot, resolveDeliveryServeRoot, } from './delivery-serve-root.js';
 export { BROWSER_LOCATOR_KINDS, defaultClickLocator, parseActionLocator, type BrowserActionOptions, type BrowserLocator, type LocatorResolveResult, } from './browser-protocol.js';
 export { isServeHostManifest, resolveRoutePath, startServeHost, type ServeHostHandle } from './browser-serve.js';
 export { createArtifactsDir, writeFailureEvidence, writeTimingOnly, type BrowserTiming, type EvidencePaths, type StepTiming, } from './browser-evidence.js';

package/dist/index.js

@@ -10,6 +10,7 @@ export { runSsrManifest } from './ssr.js';
 export { runResumeManifest } from './resume.js';
 export { runDeploymentManifest } from './deployment.js';
 export { runBrowserManifest, resolveBrowserExecutable, } from './browser.js';
+export { isDeliveryServeRoot, resolveDeliveryServeRoot, } from './delivery-serve-root.js';
 export { BROWSER_LOCATOR_KINDS, defaultClickLocator, parseActionLocator, } from './browser-protocol.js';
 export { isServeHostManifest, resolveRoutePath, startServeHost } from './browser-serve.js';
 export { createArtifactsDir, writeFailureEvidence, writeTimingOnly, } from './browser-evidence.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vmz/test",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "type": "module",
   "description": "VMZ native test protocol + Compile/Logic/Browser/SSR/Resume/Deployment hosts",
   "main": "./dist/index.js",
@@ -27,8 +27,8 @@
     "build": "tsc -p tsconfig.json"
   },
   "dependencies": {
-    "@vmz/core": "0.1.18",
-    "@vmz/protocol": "0.1.18",
+    "@vmz/core": "0.1.19",
+    "@vmz/protocol": "0.1.19",
     "linkedom": "^0.18.13",
     "puppeteer-core": "^24.11.2"
   },