@nativescript/vite 8.0.0-beta.0 → 8.0.0-rc.0

package/hmr/server/websocket-ns-entry.js

@@ -0,0 +1,163 @@
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+import { existsSync, readFileSync } from 'fs';
+import * as path from 'path';
+import babelCore from '@babel/core';
+import { getPackageJson, getProjectFilePath } from '../../helpers/project.js';
+import { REQUIRE_GUARD_SNIPPET } from './require-guard.js';
+import { setDeviceModuleHeaders } from './route-helpers.js';
+import { getServerOrigin } from './server-origin.js';
+// Lazily loaded only for the source-tree fallback below (transform
+// entry-runtime.ts on the fly when the built .js isn't present).
+const pluginTransformTypescript = (() => {
+    const requireFromHere = createRequire(import.meta.url);
+    const loaded = requireFromHere('@babel/plugin-transform-typescript');
+    return loaded?.default || loaded;
+})();
+/**
+ * Registers the device bootstrap endpoints:
+ *   - `GET /ns/entry-rt[?v=<ver>]` — serves the compiled entry runtime module
+ *     (built `entry-runtime.js`, or a transformed `entry-runtime.ts` fallback), and
+ *   - `GET /ns/entry[/<ver>]` — a script-safe wrapper that fetches the entry
+ *     runtime and starts the app with `{ origin, main, ver }`.
+ */
+export function registerNsEntryRoutes(server, options) {
+    const verbose = options.verbose;
+    const APP_ROOT_DIR = options.appRootDir;
+    const DEFAULT_MAIN_ENTRY = options.defaultMainEntry;
+    const DEFAULT_MAIN_ENTRY_VIRTUAL = options.defaultMainEntryVirtual;
+    const getGraphVersion = options.getGraphVersion;
+    // The compiled entry runtime is static for a dev-server session (a package
+    // rebuild restarts the server), so read/transform it once and reuse — avoids a
+    // `readFileSync` (and, in a source-tree checkout, a synchronous Babel
+    // transform) on every device boot.
+    let cachedEntryRtContent = null;
+    // 2.6a) Serve compiled entry runtime module: GET /ns/entry-rt[?v=<ver>]
+    server.middlewares.use(async (req, res, next) => {
+        try {
+            const urlObj = new URL(req.url || '', 'http://localhost');
+            if (!(urlObj.pathname === '/ns/entry-rt'))
+                return next();
+            if (verbose) {
+                const ra = req.socket?.remoteAddress;
+                const rp = req.socket?.remotePort;
+                console.log('[hmr-http] GET /ns/entry-rt from', ra + (rp ? ':' + rp : ''));
+            }
+            setDeviceModuleHeaders(res);
+            let content = cachedEntryRtContent || '';
+            if (!content) {
+                try {
+                    const _req = createRequire(import.meta.url);
+                    const entryRtPath = _req.resolve('@nativescript/vite/hmr/entry-runtime.js');
+                    content = readFileSync(entryRtPath, 'utf-8');
+                }
+                catch (e) {
+                    // .js not found (source tree without build) — transform .ts on the fly
+                    try {
+                        // fileURLToPath (not `new URL(...).pathname`) so the `/C:/…`
+                        // leading-slash on Windows file URLs doesn't break the lookup.
+                        const tsPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', 'entry-runtime.ts');
+                        if (existsSync(tsPath)) {
+                            const tsSource = readFileSync(tsPath, 'utf-8');
+                            const result = babelCore.transformSync(tsSource, {
+                                filename: tsPath,
+                                plugins: [[pluginTransformTypescript, { isTSX: false, allowDeclareFields: true }]],
+                                sourceType: 'module',
+                            });
+                            if (result?.code) {
+                                content = result.code;
+                            }
+                        }
+                    }
+                    catch (e2) {
+                        if (verbose)
+                            console.warn('[hmr-http] entry-runtime.ts transform failed', e2);
+                    }
+                }
+                // Cache only successful content; never cache the not-found fallback stub.
+                if (content) {
+                    cachedEntryRtContent = content;
+                }
+                else {
+                    content = 'export default async function start(){ console.error("[/ns/entry-rt] not found"); }\n';
+                }
+            }
+            if (verbose)
+                console.log('[hmr-http] /ns/entry-rt serving', content.length, 'bytes');
+            res.statusCode = 200;
+            res.end(content);
+        }
+        catch (e) {
+            console.warn('[hmr-http] /ns/entry-rt error', e);
+            next();
+        }
+    });
+    // 2.6b) HTTP-only app entry endpoint: GET /ns/entry[/<ver>]
+    // Thin wrapper that imports the compiled entry runtime and starts it with parameters.
+    server.middlewares.use(async (req, res, next) => {
+        try {
+            const urlObj = new URL(req.url || '', 'http://localhost');
+            if (!(urlObj.pathname === '/ns/entry' || /^\/ns\/entry\/[\d]+$/.test(urlObj.pathname)))
+                return next();
+            try {
+                if (verbose) {
+                    const ra = req.socket?.remoteAddress;
+                    const rp = req.socket?.remotePort;
+                    console.log('[hmr-http] GET /ns/entry from', ra + (rp ? ':' + rp : ''));
+                }
+            }
+            catch { }
+            const verSeg = urlObj.pathname.replace(/^\/ns\/entry\/?/, '');
+            // A JavaScript MIME is required: the runtime refuses to evaluate a
+            // module response that carries none.
+            setDeviceModuleHeaders(res);
+            const ver = /^[0-9]+$/.test(verSeg) ? verSeg : String(getGraphVersion() || 0);
+            const origin = getServerOrigin(server) || `${urlObj.protocol}//${urlObj.host}`;
+            // Resolve app main entry to an absolute path-like key used by /ns/m
+            let mainEntry = '/';
+            try {
+                const pkg = getPackageJson();
+                const main = pkg?.main || DEFAULT_MAIN_ENTRY;
+                const abs = getProjectFilePath(main).replace(/\\/g, '/');
+                // Normalize to '/app/...'
+                const marker = `/${APP_ROOT_DIR}/`;
+                const idx = abs.indexOf(marker);
+                mainEntry = idx >= 0 ? abs.substring(idx) : DEFAULT_MAIN_ENTRY_VIRTUAL;
+            }
+            catch { }
+            // Build a tiny wrapper that imports the compiled entry runtime from the dev server
+            let code = REQUIRE_GUARD_SNIPPET +
+                `// [ns-entry][v${ver}] wrapper (script-safe) bytes will follow\n` +
+                `(async function(){\n` +
+                `  let origin = ${JSON.stringify(origin)}; const main = ${JSON.stringify(mainEntry)}; const __ns_graph_ver = ${JSON.stringify(ver)};\n` +
+                `  try { const __b = (globalThis && globalThis.__NS_ENTRY_BASE__) ? String(globalThis.__NS_ENTRY_BASE__) : ''; if (__b) { try { const __o = new URL(__b).origin; if (__o) origin = __o; } catch {} } } catch {}\n` +
+                `  const __VERBOSE__ = (typeof __NS_ENV_VERBOSE__ !== 'undefined' && __NS_ENV_VERBOSE__) || (globalThis && globalThis.process && globalThis.process.env && globalThis.process.env.verbose) || (globalThis && globalThis.__NS_ENV_VERBOSE__) || ${JSON.stringify(!!verbose)};\n` +
+                `  if (__VERBOSE__) console.info('[ns-entry][wrapper] start', { origin, main, ver: __ns_graph_ver });\n` +
+                `  async function __ns_import_entry_rt(u){\n` +
+                `    // Prefer fetch+eval script transformation to avoid module import limitations on device\n` +
+                `    try { const r = await fetch(u); const t = await r.text(); if (__VERBOSE__) console.info('[ns-entry][wrapper] entry-rt fetched bytes', (t&&t.length)||0);\n` +
+                `      // Transform 'export default function' or 'export default async function' into global assignment\n` +
+                `      let s = t.replace(/export\\s+default\\s+async\\s+function\\s+([A-Za-z0-9_$]+)?/,'globalThis.__NS_START_ENTRY__=async function $1')\n` +
+                `               .replace(/export\\s+default\\s+function\\s+([A-Za-z0-9_$]+)?/,'globalThis.__NS_START_ENTRY__=function $1');\n` +
+                `      // Fallback: if function-form replacements didn't run, handle expression default export too\n` +
+                `      if (String(s).indexOf('__NS_START_ENTRY__') === -1) { s = 'globalThis.__NS_START_ENTRY__=' + s.replace(/export\\s+default\\s*/,''); }\n` +
+                `      try { (0,eval)(s); } catch (ee) { console.error('[ns-entry][wrapper] eval entry-rt failed', ee && (ee.message||ee)); throw ee; }\n` +
+                `      const fn = globalThis.__NS_START_ENTRY__; if (!fn) { throw new Error('entry-rt missing __NS_START_ENTRY__'); }\n` +
+                `      return { default: fn };\n` +
+                `    } catch(e) { console.error('[ns-entry][wrapper] entry-rt fetch/eval failed', e && (e.message||e)); throw e; }\n` +
+                `  }\n` +
+                `  const __entryRtUrl = '/ns/entry-rt?v=' + String(__ns_graph_ver);\n` +
+                `  let __mod; try { __mod = await __ns_import_entry_rt(__entryRtUrl); if (__VERBOSE__) console.info('[ns-entry][wrapper] entry-rt ready'); } catch (e) { console.error('[ns-entry][wrapper] failed to prepare entry-rt', e && (e.message||e)); throw e; }\n` +
+                `  const startEntry = (__mod && (__mod.default || __mod));\n` +
+                `  try { await startEntry({ origin, main, ver: __ns_graph_ver, verbose: !!__VERBOSE__ }); if (__VERBOSE__) console.info('[ns-entry][wrapper] startEntry() resolved'); } catch (e) { console.error('[ns-entry][wrapper] startEntry() failed', e && (e.message||e)); throw e; }\n` +
+                `})();\n`;
+            code = code + `\n//# sourceURL=${origin}/ns/entry`;
+            res.statusCode = 200;
+            res.end(code);
+        }
+        catch (e) {
+            next();
+        }
+    });
+}
+//# sourceMappingURL=websocket-ns-entry.js.map

package/hmr/server/websocket-ns-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-ns-entry.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/server/websocket-ns-entry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,SAAS,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,mEAAmE;AACnE,iEAAiE;AACjE,MAAM,yBAAyB,GAAQ,CAAC,GAAG,EAAE;IAC5C,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,eAAe,CAAC,oCAAoC,CAAC,CAAC;IACrE,OAAO,MAAM,EAAE,OAAO,IAAI,MAAM,CAAC;AAClC,CAAC,CAAC,EAAE,CAAC;AAeL;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAqB,EAAE,OAAqC;IACjG,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IACxC,MAAM,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IACpD,MAAM,0BAA0B,GAAG,OAAO,CAAC,uBAAuB,CAAC;IACnE,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAChD,2EAA2E;IAC3E,+EAA+E;IAC/E,sEAAsE;IACtE,mCAAmC;IACnC,IAAI,oBAAoB,GAAkB,IAAI,CAAC;IAC/C,wEAAwE;IACxE,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC/C,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,EAAE,kBAAkB,CAAC,CAAC;YAC1D,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,cAAc,CAAC;gBAAE,OAAO,IAAI,EAAE,CAAC;YACzD,IAAI,OAAO,EAAE,CAAC;gBACb,MAAM,EAAE,GAAI,GAAG,CAAC,MAAc,EAAE,aAAa,CAAC;gBAC9C,MAAM,EAAE,GAAI,GAAG,CAAC,MAAc,EAAE,UAAU,CAAC;gBAC3C,OAAO,CAAC,GAAG,CAAC,kCAAkC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5E,CAAC;YACD,sBAAsB,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,OAAO,GAAG,oBAAoB,IAAI,EAAE,CAAC;YACzC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACd,IAAI,CAAC;oBACJ,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,yCAAyC,CAAC,CAAC;oBAC5E,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;gBAC9C,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACZ,uEAAuE;oBACvE,IAAI,CAAC;wBACJ,6DAA6D;wBAC7D,+DAA+D;wBAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,kBAAkB,CAAC,CAAC;wBACpG,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;4BACxB,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;4BAC/C,MAAM,MAAM,GAAG,SAAS,CAAC,aAAa,CAAC,QAAQ,EAAE;gCAChD,QAAQ,EAAE,MAAM;gCAChB,OAAO,EAAE,CAAC,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC;gCAClF,UAAU,EAAE,QAAQ;6BACpB,CAAC,CAAC;4BACH,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC;gCAClB,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC;4BACvB,CAAC;wBACF,CAAC;oBACF,CAAC;oBAAC,OAAO,EAAE,EAAE,CAAC;wBACb,IAAI,OAAO;4BAAE,OAAO,CAAC,IAAI,CAAC,8CAA8C,EAAE,EAAE,CAAC,CAAC;oBAC/E,CAAC;gBACF,CAAC;gBACD,0EAA0E;gBAC1E,IAAI,OAAO,EAAE,CAAC;oBACb,oBAAoB,GAAG,OAAO,CAAC;gBAChC,CAAC;qBAAM,CAAC;oBACP,OAAO,GAAG,uFAAuF,CAAC;gBACnG,CAAC;YACF,CAAC;YACD,IAAI,OAAO;gBAAE,OAAO,CAAC,GAAG,CAAC,iCAAiC,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACrF,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,+BAA+B,EAAE,CAAC,CAAC,CAAC;YACjD,IAAI,EAAE,CAAC;QACR,CAAC;IACF,CAAC,CAAC,CAAC;IAEH,4DAA4D;IAC5D,sFAAsF;IACtF,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC/C,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,EAAE,kBAAkB,CAAC,CAAC;YAC1D,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,WAAW,IAAI,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAAE,OAAO,IAAI,EAAE,CAAC;YACtG,IAAI,CAAC;gBACJ,IAAI,OAAO,EAAE,CAAC;oBACb,MAAM,EAAE,GAAI,GAAG,CAAC,MAAc,EAAE,aAAa,CAAC;oBAC9C,MAAM,EAAE,GAAI,GAAG,CAAC,MAAc,EAAE,UAAU,CAAC;oBAC3C,OAAO,CAAC,GAAG,CAAC,+BAA+B,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACzE,CAAC;YACF,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;YACV,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;YAC9D,mEAAmE;YACnE,qCAAqC;YACrC,sBAAsB,CAAC,GAAG,CAAC,CAAC;YAC5B,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC,CAAC;YAC9E,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;YAC/E,oEAAoE;YACpE,IAAI,SAAS,GAAG,GAAG,CAAC;YACpB,IAAI,CAAC;gBACJ,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;gBAC7B,MAAM,IAAI,GAAG,GAAG,EAAE,IAAI,IAAI,kBAAkB,CAAC;gBAC7C,MAAM,GAAG,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBACzD,0BAA0B;gBAC1B,MAAM,MAAM,GAAG,IAAI,YAAY,GAAG,CAAC;gBACnC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAChC,SAAS,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC;YACxE,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;YACV,mFAAmF;YACnF,IAAI,IAAI,GACP,qBAAqB;gBACrB,kBAAkB,GAAG,6CAA6C;gBAClE,sBAAsB;gBACtB,kBAAkB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,4BAA4B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK;gBACvI,kNAAkN;gBAClN,iPAAiP,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK;gBAC/Q,wGAAwG;gBACxG,6CAA6C;gBAC7C,+FAA+F;gBAC/F,gKAAgK;gBAChK,0GAA0G;gBAC1G,4IAA4I;gBAC5I,8HAA8H;gBAC9H,qGAAqG;gBACrG,+IAA+I;gBAC/I,0IAA0I;gBAC1I,wHAAwH;gBACxH,iCAAiC;gBACjC,qHAAqH;gBACrH,OAAO;gBACP,sEAAsE;gBACtE,4PAA4P;gBAC5P,6DAA6D;gBAC7D,gRAAgR;gBAChR,SAAS,CAAC;YACX,IAAI,GAAG,IAAI,GAAG,mBAAmB,MAAM,WAAW,CAAC;YACnD,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACZ,IAAI,EAAE,CAAC;QACR,CAAC;IACF,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/hmr/server/websocket-ns-m-paths.d.ts

@@ -0,0 +1,19 @@
+export declare function canonicalizeNsMImportPath(p: string): string;
+export interface InboundLegacyNsMSpec {
+    cleanedSpec: string;
+    bootTaggedRequest: boolean;
+    forcedVer: string | null;
+}
+/**
+ * Single seam for BOTH directions of legacy `/ns/m` tag handling:
+ *
+ *   - `'inbound-request-spec'`: strip `__ns_boot__`/`__ns_hmr__` decorations
+ *     from a raw request spec, reporting what was stripped.
+ *   - `'outbound-served-code'`: collapse every emitted `/ns/m` URL in served
+ *     code to its canonical stable form (requires `origin`).
+ *
+ * Current servers never EMIT tags; both directions exist purely to tolerate
+ * stale cached device code.
+ */
+export declare function collapseLegacyNsMTags(value: string, mode: 'inbound-request-spec'): InboundLegacyNsMSpec;
+export declare function collapseLegacyNsMTags(value: string, mode: 'outbound-served-code', origin: string): string;

package/hmr/server/websocket-ns-m-paths.js

@@ -0,0 +1,115 @@
+// Stable URL + explicit invalidation contract for `/ns/m/...` modules.
+//
+// Older versions emitted `/ns/m/__ns_hmr__/v<N>/<rel>` (and, for cold boot,
+// `/ns/m/__ns_boot__/b1/<rel>`) URLs in served modules so that V8's HTTP
+// module cache would see a fresh URL on each save and so that the server
+// could detect boot-time requests. Both decorations are gone:
+//
+//   - Freshness is driven by explicit eviction: the client calls
+//     ns:module `invalidateModules(urls)` with the server-computed eviction set,
+//     and the iOS runtime pairs that with an eviction-driven fetch nonce
+//     that defeats CFNetwork's HTTP cache. URLs stay STABLE across saves —
+//     module identity IS the canonical URL.
+//   - Boot-progress instrumentation is injected self-gating into every
+//     served /ns/m module (the snippet no-ops once
+//     `__NS_HMR_BOOT_COMPLETE__` flips), so no boot tag is needed.
+//
+// `canonicalizeNsMImportPath` collapses any tagged inbound URL shape
+// (stale served code still cached on a device) back to the canonical
+// stable form.
+export function canonicalizeNsMImportPath(p) {
+    if (!p || !p.startsWith('/ns/m/')) {
+        return p;
+    }
+    // Collapse tagged boot+hmr, hmr-only, or boot-only prefixes back to the
+    // canonical `/ns/m/<rest>` form. Inputs we may still see from stale
+    // cached code include:
+    //   * `/ns/m/__ns_boot__/b1/__ns_hmr__/v<N>/<rest>`
+    //   * `/ns/m/__ns_hmr__/v<N>/<rest>` (any tag: `live`, `v<N>`, `n<N>`, …)
+    //   * `/ns/m/__ns_boot__/b1/<rest>`
+    //   * `/ns/m/<rest>` (canonical, passes through unchanged)
+    return p
+        .replace(/^\/ns\/m\/__ns_boot__\/b1\/__ns_hmr__\/[^/]+\//, '/ns/m/')
+        .replace(/^\/ns\/m\/__ns_hmr__\/[^/]+\//, '/ns/m/')
+        .replace(/^\/ns\/m\/__ns_boot__\/b1\//, '/ns/m/');
+}
+/**
+ * Inbound half of the legacy-tag contract: a raw `/ns/m` request spec (the
+ * path AFTER the `/ns/m` route prefix) may still carry `__ns_boot__/<tag>/`
+ * and/or `__ns_hmr__/<tag>/` decorations from stale cached device code.
+ * Strips them (repeatedly — the two can nest in either order) and reports
+ * what was seen.
+ */
+function stripLegacyNsMRequestTags(spec) {
+    let cleanedSpec = spec || '';
+    let bootTaggedRequest = false;
+    let forcedVer = null;
+    try {
+        let changed = true;
+        while (changed) {
+            changed = false;
+            const bootMatch = cleanedSpec.match(/^\/?__ns_boot__\/[^\/]+(\/.*)?$/);
+            if (bootMatch) {
+                bootTaggedRequest = true;
+                cleanedSpec = bootMatch[1] || '/';
+                changed = true;
+            }
+            const hmrMatch = cleanedSpec.match(/^\/?__ns_hmr__\/([^\/]+)(\/.*)?$/);
+            if (hmrMatch) {
+                const tag = hmrMatch[1] || '';
+                if (tag) {
+                    forcedVer = tag;
+                }
+                cleanedSpec = hmrMatch[2] || '/';
+                changed = true;
+            }
+        }
+    }
+    catch { }
+    return { cleanedSpec, bootTaggedRequest, forcedVer };
+}
+/**
+ * Outbound half of the legacy-tag contract: the `/ns/m` finalize step runs
+ * served code through this so every emitted `/ns/m/...` URL (in any import
+ * form) is the canonical stable shape from `canonicalizeNsMImportPath`, and
+ * `new URL(..., import.meta.url).href` forms are pinned to the absolute
+ * dev-server origin.
+ */
+function collapseLegacyNsMTagsInServedCode(code, origin) {
+    const rewritePath = (p) => canonicalizeNsMImportPath(p);
+    // 1) Static imports: import ... from "/ns/m/..."
+    code = code.replace(/(from\s*["'])(\/ns\/m\/[^"'?]+)(["'])/g, (_m, a, p, b) => `${a}${rewritePath(p)}${b}`);
+    // 2) Side-effect imports: import "/ns/m/..."
+    code = code.replace(/(import\s*(?!\()\s*["'])(\/ns\/m\/[^"'?]+)(["'])/g, (_m, a, p, b) => `${a}${rewritePath(p)}${b}`);
+    // 3) Dynamic imports: import("/ns/m/...")
+    code = code.replace(/(import\(\s*["'])(\/ns\/m\/[^"'?]+)(["']\s*\))/g, (_m, a, p, b) => `${a}${rewritePath(p)}${b}`);
+    // 4) new URL("/ns/m/...", import.meta.url)
+    code = code.replace(/(new\s+URL\(\s*["'])(\/ns\/m\/[^"'?]+)(["']\s*,\s*import\.meta\.url\s*\))/g, (_m, a, p, b) => `${a}${rewritePath(p)}${b}`);
+    // 5) __ns_import(new URL('/ns/m/...', import.meta.url).href)
+    code = code.replace(/(new\s+URL\(\s*["'])(\/ns\/m\/[^"'?]+)(["']\s*,\s*import\.meta\.url\s*\)\.href)/g, (_m, a, p, b) => `${a}${rewritePath(p)}${b}`);
+    // 6) Force absolute HTTP for new URL('/ns/m/...', import.meta.url).href → canonical stable URL.
+    try {
+        code = code.replace(/new\s+URL\(\s*["'](\/ns\/m\/[^"'?]+)(?:\?[^"']*)?["']\s*,\s*import\.meta\.url\s*\)\.href/g, (_m, p1) => `${JSON.stringify(`${origin}${rewritePath(p1)}`)}`);
+    }
+    catch { }
+    // 7) SFC URLs (Vue) — canonical, like everything else. Freshness
+    // is driven by the Vue client evicting the SFC artifact URL set.
+    try {
+        code = code.replace(/new\s+URL\(\s*["']\/ns\/sfc(\/[^"'?]+)(?:\?[^"']*)?["']\s*,\s*import\.meta\.url\s*\)\.href/g, (_m, p1) => `${JSON.stringify(`${origin}/ns/sfc${p1}`)}`);
+    }
+    catch { }
+    return code;
+}
+export function collapseLegacyNsMTags(value, mode, origin) {
+    switch (mode) {
+        case 'inbound-request-spec':
+            return stripLegacyNsMRequestTags(value);
+        case 'outbound-served-code':
+            return collapseLegacyNsMTagsInServedCode(value, origin ?? '');
+        default: {
+            const exhaustive = mode;
+            throw new Error(`Unhandled collapseLegacyNsMTags mode: ${exhaustive}`);
+        }
+    }
+}
+//# sourceMappingURL=websocket-ns-m-paths.js.map

package/hmr/server/websocket-ns-m-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-ns-m-paths.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/server/websocket-ns-m-paths.ts"],"names":[],"mappings":"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"}

package/hmr/server/websocket-ns-m-request.d.ts

@@ -0,0 +1,46 @@
+import type { TransformResult } from 'vite';
+export interface NsMRequestContext {
+    requestUrl: string;
+    spec: string;
+    forcedVer: string | null;
+    bootTaggedRequest: boolean;
+    serverRoot: string;
+    /**
+     * Optional monorepo workspace root for the dev server. When the app
+     * lives under `apps/<name>/` inside a hoisted-`node_modules` workspace
+     * (Nx / Rush / Turborepo / pnpm / yarn workspaces / npm workspaces),
+     * `serverRoot` is the app dir but most packages live at the workspace
+     * root. Candidates that resolve there are routed through `/@fs/...`
+     * to bypass the package's `package.json#exports` gating which would
+     * otherwise refuse internal sub-paths like `css-tree/lib/syntax/...`.
+     */
+    workspaceRoot?: string | null;
+    candidates: string[];
+    transformCandidates: string[];
+}
+export type NsMRequestContextResult = {
+    kind: 'next';
+} | {
+    kind: 'response';
+    statusCode: number;
+    code: string;
+} | {
+    kind: 'context';
+    value: NsMRequestContext;
+};
+export interface ResolveNsMTransformedModuleOptions {
+    context: NsMRequestContext;
+    transformRequest: (url: string, timeoutMs?: number) => Promise<TransformResult | null>;
+    resolveId: (id: string) => Promise<string | null>;
+    /** Matches `pluginContainer.load`'s LoadResult (which includes `void`). */
+    loadVirtualId: (id: string) => Promise<string | {
+        code?: string;
+    } | TransformResult | null | void>;
+    timeoutMs?: number;
+}
+export interface NsMResolvedTransform {
+    transformed: TransformResult | null;
+    resolvedCandidate: string | null;
+}
+export declare function createNsMRequestContext(requestUrl: string, serverRoot: string, appVirtualWithSlash: string, workspaceRoot?: string | null): NsMRequestContextResult;
+export declare function resolveNsMTransformedModule(options: ResolveNsMTransformedModuleOptions): Promise<NsMResolvedTransform>;

package/hmr/server/websocket-ns-m-request.js

@@ -0,0 +1,197 @@
+import * as path from 'path';
+import { filterExistingNodeModulesTransformCandidates, getBlockedDeviceNodeModulesReason, resolveCandidateFilePath, tryReadRawExplicitJavaScriptModule } from './websocket-module-specifiers.js';
+import { collapseLegacyNsMTags } from './websocket-ns-m-paths.js';
+function normalizeAbsoluteFilesystemSpec(spec, serverRoot) {
+    const toPosix = (value) => value.replace(/\\/g, '/');
+    const rootPosix = toPosix(serverRoot);
+    const specPosix = toPosix(spec);
+    const isAbsoluteFilesystemPath = /^\//.test(specPosix) || /^[A-Za-z]:\//.test(spec);
+    if (!isAbsoluteFilesystemPath) {
+        return spec;
+    }
+    let relative = specPosix.startsWith(rootPosix) ? specPosix.slice(rootPosix.length) : path.posix.relative(rootPosix, specPosix);
+    if (relative.startsWith('..')) {
+        return spec;
+    }
+    if (!relative.startsWith('/')) {
+        relative = `/${relative}`;
+    }
+    return relative;
+}
+export function createNsMRequestContext(requestUrl, serverRoot, appVirtualWithSlash, workspaceRoot) {
+    try {
+        const urlObj = new URL(requestUrl || '', 'http://localhost');
+        if (!urlObj.pathname.startsWith('/ns/m')) {
+            return { kind: 'next' };
+        }
+        let spec = urlObj.searchParams.get('path') || '';
+        let forcedVer = urlObj.searchParams.get('v');
+        let bootTaggedRequest = false;
+        if (!spec) {
+            const base = '/ns/m';
+            const rest = urlObj.pathname.slice(base.length);
+            if (rest && rest !== '/') {
+                spec = rest;
+            }
+        }
+        if (spec === '/__invalid_at__.mjs' || spec === '__invalid_at__.mjs') {
+            return {
+                kind: 'response',
+                statusCode: 200,
+                code: "// invalid '@' import stub\nexport {}\n",
+            };
+        }
+        if (!spec) {
+            return {
+                kind: 'response',
+                statusCode: 200,
+                code: 'export {}\n',
+            };
+        }
+        spec = spec.replace(/[?#].*$/, '');
+        const decorated = collapseLegacyNsMTags(spec, 'inbound-request-spec');
+        spec = decorated.cleanedSpec;
+        bootTaggedRequest = decorated.bootTaggedRequest;
+        forcedVer || (forcedVer = decorated.forcedVer);
+        spec = normalizeAbsoluteFilesystemSpec(spec, serverRoot);
+        if (spec.startsWith('@/')) {
+            spec = appVirtualWithSlash + spec.slice(2);
+        }
+        if (spec.startsWith('./')) {
+            spec = spec.slice(1);
+        }
+        const blockedNodeModulesReason = getBlockedDeviceNodeModulesReason(spec);
+        if (blockedNodeModulesReason) {
+            return {
+                kind: 'response',
+                statusCode: 404,
+                code: `// [ns:m] blocked device import\nthrow new Error(${JSON.stringify(`[ns/m] ${blockedNodeModulesReason}`)});\nexport {};\n`,
+            };
+        }
+        if (!spec.startsWith('/')) {
+            spec = `/${spec}`;
+        }
+        const hasExt = /\.(ts|tsx|js|jsx|mjs|mts|cts|vue)$/i.test(spec);
+        const baseNoExt = hasExt ? spec.replace(/\.(ts|tsx|js|jsx|mjs|mts|cts)$/i, '') : spec;
+        const candidates = [...(hasExt ? [spec] : []), `${baseNoExt}.ts`, `${baseNoExt}.js`, `${baseNoExt}.tsx`, `${baseNoExt}.jsx`, `${baseNoExt}.mjs`, `${baseNoExt}.mts`, `${baseNoExt}.cts`, `${baseNoExt}.vue`, `${baseNoExt}/index.ts`, `${baseNoExt}/index.js`, `${baseNoExt}/index.tsx`, `${baseNoExt}/index.jsx`, `${baseNoExt}/index.mjs`];
+        const transformCandidates = filterExistingNodeModulesTransformCandidates(spec, candidates, serverRoot, workspaceRoot);
+        return {
+            kind: 'context',
+            value: {
+                requestUrl,
+                spec,
+                forcedVer,
+                bootTaggedRequest,
+                serverRoot,
+                workspaceRoot: workspaceRoot ?? null,
+                candidates,
+                transformCandidates,
+            },
+        };
+    }
+    catch {
+        return { kind: 'next' };
+    }
+}
+async function tryTransformRequest(transformRequest, url, timeoutMs) {
+    try {
+        return await transformRequest(url, timeoutMs);
+    }
+    catch {
+        return null;
+    }
+}
+function getLoadedCode(loadResult) {
+    if (!loadResult) {
+        return null;
+    }
+    if (typeof loadResult === 'string') {
+        return loadResult;
+    }
+    return typeof loadResult.code === 'string' ? loadResult.code : null;
+}
+export async function resolveNsMTransformedModule(options) {
+    const { context, transformRequest, resolveId, loadVirtualId, timeoutMs = 120000 } = options;
+    const { spec, serverRoot, workspaceRoot, transformCandidates } = context;
+    let transformed = null;
+    let resolvedCandidate = null;
+    if (spec.startsWith('/@id/')) {
+        transformed = await tryTransformRequest(transformRequest, spec, timeoutMs);
+        if (transformed?.code) {
+            return { transformed, resolvedCandidate };
+        }
+        try {
+            const rawId = spec.slice('/@id/'.length).replace(/__x00__/g, '\0');
+            const loadedCode = getLoadedCode(await loadVirtualId(rawId));
+            if (loadedCode) {
+                return {
+                    transformed: { code: loadedCode },
+                    resolvedCandidate: rawId,
+                };
+            }
+        }
+        catch { }
+    }
+    const rawExplicitModule = tryReadRawExplicitJavaScriptModule(spec, serverRoot);
+    if (rawExplicitModule) {
+        return {
+            transformed: { code: rawExplicitModule.code },
+            resolvedCandidate: rawExplicitModule.resolvedId,
+        };
+    }
+    for (const candidate of transformCandidates) {
+        transformed = await tryTransformRequest(transformRequest, candidate, timeoutMs);
+        if (transformed?.code) {
+            resolvedCandidate = candidate;
+            return { transformed, resolvedCandidate };
+        }
+    }
+    const resolvedId = await resolveId(spec);
+    if (resolvedId) {
+        transformed = await tryTransformRequest(transformRequest, resolvedId, timeoutMs);
+        if (transformed?.code) {
+            return { transformed, resolvedCandidate: resolvedId };
+        }
+    }
+    if (spec.includes('/node_modules/')) {
+        const nodeModulesIndex = spec.lastIndexOf('/node_modules/');
+        const bareSpecifier = spec.slice(nodeModulesIndex + '/node_modules/'.length);
+        if (bareSpecifier && !bareSpecifier.startsWith('.')) {
+            const resolvedBareId = await resolveId(bareSpecifier);
+            if (resolvedBareId) {
+                transformed = await tryTransformRequest(transformRequest, resolvedBareId, timeoutMs);
+                if (transformed?.code) {
+                    return { transformed, resolvedCandidate: resolvedBareId };
+                }
+            }
+        }
+    }
+    const buildFsCandidate = (root) => {
+        const rootPosix = root.replace(/\\/g, '/').replace(/\/$/, '');
+        const absolutePosixPath = `${rootPosix}${spec.startsWith('/') ? '' : '/'}${spec}`;
+        return `/@fs${absolutePosixPath}`;
+    };
+    const fsRootsToTry = [serverRoot, ...(workspaceRoot && path.resolve(workspaceRoot) !== path.resolve(serverRoot) ? [workspaceRoot] : [])];
+    for (const root of fsRootsToTry) {
+        const fsId = buildFsCandidate(root);
+        if (resolveCandidateFilePath(fsId, serverRoot, workspaceRoot)) {
+            transformed = await tryTransformRequest(transformRequest, fsId, timeoutMs);
+            if (transformed?.code) {
+                return { transformed, resolvedCandidate: fsId };
+            }
+        }
+    }
+    for (const candidate of transformCandidates) {
+        const importHintCandidate = `${candidate}${candidate.includes('?') ? '&' : '?'}import`;
+        transformed = await tryTransformRequest(transformRequest, importHintCandidate, timeoutMs);
+        if (transformed?.code) {
+            resolvedCandidate = importHintCandidate;
+            return { transformed, resolvedCandidate };
+        }
+    }
+    return {
+        transformed: null,
+        resolvedCandidate,
+    };
+}
+//# sourceMappingURL=websocket-ns-m-request.js.map

package/hmr/server/websocket-ns-m-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-ns-m-request.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/server/websocket-ns-m-request.ts"],"names":[],"mappings":"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"}

package/hmr/server/websocket-ns-m.d.ts

@@ -0,0 +1,52 @@
+import type { TransformResult, ViteDevServer } from 'vite';
+import { type DepsBundleService } from './deps-bundle.js';
+import type { FrameworkServerStrategy } from './framework-strategy.js';
+type SharedTransformRequestFn = (url: string, timeoutMs?: number) => Promise<TransformResult | null>;
+type UpsertGraphModuleFn = (rawId: string, code: string, deps: string[], options?: {
+    bumpVersion?: boolean;
+    emitDeltaOnInsert?: boolean;
+    broadcastDelta?: boolean;
+}) => void;
+/**
+ * Plugin-closure dependencies the `/ns/m` device module server needs. The pure
+ * transform/codegen functions are imported directly from
+ * `websocket-device-transform.ts`; only genuine plugin state (graph version,
+ * strategy, shared transform runner, graph upsert) is injected here.
+ */
+export interface RegisterNsModuleServerRouteOptions {
+    verbose: boolean;
+    appVirtualWithSlash: string;
+    sfcFileMap: Map<string, string>;
+    depFileMap: Map<string, string>;
+    getGraphVersion(): number;
+    getStrategy(): FrameworkServerStrategy;
+    sharedTransformRequest: SharedTransformRequestFn;
+    ensureInitialGraphPopulationStarted(server: ViteDevServer): void;
+    upsertGraphModule: UpsertGraphModuleFn;
+    /**
+     * Injectable deps-bundle service (testability seam). When omitted, the
+     * shared process-wide service is used — null when `NS_DEPS_PER_MODULE=1`
+     * forces per-module node_modules serving.
+     */
+    depsBundle?: DepsBundleService | null;
+    /**
+     * Live-broadcast gate for AnalogJS `/@ng/component` metadata fetches.
+     * When provided, only fetches whose `(c, t)` pair matches a recorded
+     * `angular:component-update` broadcast are delegated to Analog's
+     * middleware; everything else — most importantly the boot-time
+     * `<Class>_HmrLoad(Date.now())` fetch every compiled component issues on
+     * evaluation — is answered with the empty no-update stub. See the ledger
+     * in `websocket-angular-hot-update.ts` for the full failure mode this
+     * prevents (post-edit relaunch → boot-time `ɵɵreplaceMetadata` on the
+     * root component → white screen).
+     */
+    isLiveAngularComponentUpdateFetch?(componentId: string, timestamp: number): boolean;
+}
+/**
+ * Registers the `/ns/m/*` device module server: the HTTP endpoint every
+ * NativeScript device uses to fetch app/source modules (and AnalogJS Angular
+ * `/@ng/component` live-reload requests) as device-ready ESM. This is the
+ * single hottest route in the HMR server.
+ */
+export declare function registerNsModuleServerRoute(server: ViteDevServer, options: RegisterNsModuleServerRouteOptions): void;
+export {};