@nativescript/vite 8.0.0-alpha.56 → 8.0.0-alpha.58

package/hmr/server/boot-closure-route.js

@@ -0,0 +1,99 @@
+import { resolveProjectMainEntryPath } from './vite-plugin.js';
+import { CORE_BUNDLE_PATH, isCorePerModuleServingEnabled } from './core-bundle.js';
+import { getServerOrigin } from './server-origin.js';
+// `/__ns_dev__/boot-closure` — the server-computed cold-boot module closure.
+//
+// The device bootstrap (`session-bootstrap.ts`) fetches this list and hands
+// it to `__NS_DEV__.kickstartPrefetch(urls)` so the runtime can pre-fill its HTTP
+// body cache in ONE parallel wave before V8's synchronous
+// `ResolveModuleCallback` walks the entry graph. The server owns the module
+// graph, so closure computation lives here — the runtime performs no import
+// scanning of its own; it fetches exactly this list.
+//
+// Watchdog note: the response must come back fast even on a cold Vite
+// process. `populateInitialGraph` starts at `configureServer` time (see
+// websocket.ts) and we only wait for it up to `maxWaitMs`; a PARTIAL list is
+// fine — the kickstart tolerates partial pre-fill and V8 falls back to
+// per-module fetches for anything missing.
+const SCRIPT_EXT_RE = /\.(ts|tsx|js|jsx|mjs|mts|cts)$/i;
+// Pure helper (unit-testable): graph ids → ordered, deduped absolute URL list.
+// The entry goes first so the deepest chain starts fetching immediately; the
+// /ns/rt and /ns/core bridges ride along since every app module imports them.
+// In core-bundle mode the single-eval `/ns/core-bundle.mjs` payload is the
+// biggest body in the boot closure, so it goes right after the entry — the
+// kickstart prewarm then downloads it in parallel with everything else
+// instead of V8 discovering it mid-walk through the /ns/core shim.
+export function buildBootClosureUrls(options) {
+    const origin = options.origin.replace(/\/$/, '');
+    const urls = [];
+    const seen = new Set();
+    const add = (url) => {
+        if (!seen.has(url)) {
+            seen.add(url);
+            urls.push(url);
+        }
+    };
+    const entryPath = options.entryPathname.startsWith('/') ? options.entryPathname : `/${options.entryPathname}`;
+    add(`${origin}/ns/m${entryPath.replace(SCRIPT_EXT_RE, '')}`);
+    if (options.includeCoreBundle) {
+        add(`${origin}${CORE_BUNDLE_PATH}`);
+    }
+    add(`${origin}/ns/rt`);
+    add(`${origin}/ns/core`);
+    for (const id of options.graphModuleIds) {
+        if (typeof id !== 'string' || !id.startsWith('/'))
+            continue;
+        // Vue SFCs and other non-script assets are served through their own
+        // routes with their own identity; the /ns/m closure is script-only.
+        if (!SCRIPT_EXT_RE.test(id))
+            continue;
+        add(`${origin}/ns/m${id.replace(SCRIPT_EXT_RE, '')}`);
+    }
+    return urls;
+}
+export function registerBootClosureRoute(server, source, options) {
+    const maxWaitMs = options?.maxWaitMs ?? 3000;
+    server.middlewares.use(async (req, res, next) => {
+        try {
+            const url = new URL(req.url || '', 'http://localhost');
+            if (url.pathname !== '/__ns_dev__/boot-closure')
+                return next();
+            res.setHeader('Access-Control-Allow-Origin', '*');
+            res.setHeader('Access-Control-Allow-Methods', 'GET, OPTIONS');
+            if (req.method === 'OPTIONS') {
+                res.statusCode = 204;
+                res.end();
+                return;
+            }
+            // Wait for the background graph walk, but never past the budget —
+            // partial closures are acceptable by contract.
+            await Promise.race([source.ensureInitialGraphPopulationStarted(server), new Promise((resolve) => setTimeout(resolve, maxWaitMs))]);
+            // Use the single trusted origin resolver — never the client-supplied
+            // `Host` header (see the import-map route and CLAUDE.md invariant 6:
+            // every device-reachable URL must be byte-identical to the origin
+            // baked into bundle.mjs).
+            const origin = getServerOrigin(server);
+            const projectRoot = server.config?.root || process.cwd();
+            const payload = {
+                urls: buildBootClosureUrls({
+                    origin,
+                    entryPathname: resolveProjectMainEntryPath(projectRoot),
+                    graphModuleIds: source.getGraphModuleIds(),
+                    // If the bundle build later fails, the kickstart prefetch of this
+                    // URL just gets a 503 body — prewarm tolerates failures, and the
+                    // /ns/core shims never reference the bundle in that case.
+                    includeCoreBundle: !isCorePerModuleServingEnabled(),
+                }),
+            };
+            res.setHeader('Content-Type', 'application/json');
+            res.statusCode = 200;
+            res.end(JSON.stringify(payload));
+        }
+        catch (error) {
+            res.statusCode = 500;
+            res.setHeader('Content-Type', 'application/json');
+            res.end(JSON.stringify({ error: error?.message || 'Failed to compute NativeScript boot closure', urls: [] }));
+        }
+    });
+}
+//# sourceMappingURL=boot-closure-route.js.map

package/hmr/server/boot-closure-route.js.map

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

package/hmr/server/core-bundle.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Single-eval @nativescript/core bundle for device serving (bundle mode).
+ *
+ * DEFAULT MODE (consumers)
+ * ------------------------
+ * Instead of serving @nativescript/core per-module through Vite's transform
+ * pipeline (~hundreds of serial HTTP fetches + per-file transforms during cold
+ * boot), the dev server pre-bundles the ENTIRE core package with esbuild into
+ * one ESM payload served at `GET /ns/core-bundle.mjs`. The canonical
+ * `/ns/core[/<sub>]` URL space is preserved — those routes serve THIN SHIMS
+ * that statically import the bundle and re-export the requested subpath's
+ * namespace from the `globalThis.__NS_CORE_MODULES__` registry the bundle
+ * populates. Because every shim's only dependency is the one bundle URL,
+ * V8/iOS evaluates core exactly once per app lifetime — the single-realm
+ * invariant is enforced by construction, with ONE big prefetchable payload
+ * instead of a deep serial fetch chain.
+ *
+ * OPT-IN PER-MODULE MODE (core maintainers)
+ * -----------------------------------------
+ * Set `NS_CORE_PER_MODULE=1` to keep the classic per-module `/ns/core` bridge
+ * (websocket-ns-core.ts). That is the right mode when editing
+ * `@nativescript/core` source live inside the NativeScript monorepo: each core
+ * module stays individually served/transformed so core edits participate in
+ * HMR. Consumers of the published package don't edit core mid-session, so the
+ * bundle is both safe and much faster for them.
+ *
+ * FAILURE FALLBACK
+ * ----------------
+ * If the esbuild bundle build fails for any reason, the service marks itself
+ * failed and `/ns/core[/<sub>]` transparently falls back to the per-module
+ * bridge for the whole session (logged loudly once). Boot still works; only
+ * the speed win is lost.
+ */
+import type { ViteDevServer } from 'vite';
+import type { Platform } from '../../helpers/platform-types.js';
+/**
+ * Per-module /ns/core serving mode (vs the default single-eval bundle).
+ *
+ * `NS_CORE_PER_MODULE=1|true` forces it on, `0|false` forces bundle mode.
+ * When unset, it AUTO-ENABLES for monorepo core source (packages/core in the
+ * NativeScript repo). Two reasons:
+ *   - core maintainers edit core live, and per-module serving keeps those
+ *     edits in HMR;
+ *   - realm safety: the build-time externalizer emits
+ *     `/ns/m/packages/core/<file>` URLs for workspace-source core (see the
+ *     `ns-core-external-urls` workspace branch in configuration/base.ts), so
+ *     the served graph's core realm lives under /ns/m. A bundle-mode
+ *     `/ns/core-bundle.mjs` would evaluate a complete SECOND copy of core for
+ *     the entry's `/ns/core/globals|application|…` imports — duplicate native
+ *     class registrations crash in MetadataBuilder at startup.
+ */
+export declare function isCorePerModuleServingEnabled(env?: NodeJS.ProcessEnv, hasWorkspaceCoreSource?: () => boolean): boolean;
+export interface CoreBundleState {
+    /** Full ESM payload served at /ns/core-bundle.mjs (shape header + esbuild output). */
+    code: string;
+    /** Canonical subpaths registered in the bundle's __NS_CORE_MODULES__ registry. */
+    subs: Set<string>;
+    hash: string;
+    builtAt: number;
+    buildMs: number;
+}
+export interface CoreBundleService {
+    /** Resolves the built bundle, or null when the build failed (per-module fallback). */
+    ensureBuilt(): Promise<CoreBundleState | null>;
+    /** Synchronous view — null until built (or when failed). */
+    getState(): CoreBundleState | null;
+    hasFailed(): boolean;
+}
+export interface GenerateCoreBundleOptions {
+    projectRoot: string;
+    platform: Platform | string;
+    mode: 'development' | 'production' | string;
+    flavor?: string;
+    verbose?: boolean;
+}
+/**
+ * Resolve the physical @nativescript/core root the same way configuration/
+ * base.ts does: prefer monorepo source (`<workspace>/packages/core`), else the
+ * node_modules install reachable from the project root.
+ */
+export declare function resolveCoreRootForBundle(projectRoot: string): string;
+/**
+ * Enumerate every importable core subpath (canonical form, per
+ * `normalizeCoreSub`) for the given platform. A subpath is included when it
+ * has a platform-neutral variant OR a variant for the current platform —
+ * other-platform-only modules (e.g. `ui/frame/activity.android` on iOS) are
+ * skipped since they can never resolve for this build.
+ */
+export declare function enumerateCoreModuleSubpaths(coreRoot: string, platform: string): string[];
+/**
+ * Synthetic esbuild entry: evaluate core once, expose every subpath's live
+ * namespace through `globalThis.__NS_CORE_MODULES__` (the SAME registry the
+ * per-module bridge footers populate, so the vendor CJS `require()` shim and
+ * `_nsReq` lookups keep working unchanged), and re-export the package main so
+ * `/ns/core-bundle.mjs` itself has core's full named-export surface.
+ */
+export declare function buildCoreBundleEntryCode(subs: readonly string[]): string;
+export declare function generateCoreBundle(options: GenerateCoreBundleOptions): Promise<CoreBundleState>;
+export declare function createCoreBundleService(options: GenerateCoreBundleOptions): CoreBundleService;
+/**
+ * Process-wide bundle service derived from the dev server's config + CLI
+ * flags. One dev server per process, so a module-level singleton matches the
+ * vendor manifest's lifecycle.
+ */
+export declare function getSharedCoreBundleService(server: ViteDevServer): CoreBundleService;
+/** Test seam: drop the shared service so specs can mount fresh. */
+export declare function resetSharedCoreBundleServiceForTests(): void;
+export declare const CORE_BUNDLE_PATH = "/ns/core-bundle.mjs";
+/**
+ * Shim served at `/ns/core` in bundle mode. `export * from` gives real,
+ * live named bindings straight off the bundle module record; the explicit
+ * default keeps the "default import + destructure" consumer rewrite working
+ * (see buildDefaultExportFooter in ns-core-cjs-shape.ts for that contract).
+ */
+export declare function buildCoreMainShimCode(): string;
+export declare function buildCoreSubShimCode(sub: string, exportNames: readonly string[], hasOwnDefaultExport?: boolean): string;