@vistagenic/vista 0.2.12 → 0.2.13

package/dist/server/ppr.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAppPPREnabled = isAppPPREnabled;
+exports.isRoutePPREligible = isRoutePPREligible;
+exports.getPprShellArtifactPath = getPprShellArtifactPath;
+exports.createPartialPrerenderInfo = createPartialPrerenderInfo;
+exports.resolvePprRequestMode = resolvePprRequestMode;
+exports.injectPprResumeBootstrap = injectPprResumeBootstrap;
+const config_1 = require("../config");
+function isAppPPREnabled(config) {
+    return (0, config_1.resolveCacheComponentsConfig)(config).enabled;
+}
+function isRoutePPREligible(route, appPprEnabled) {
+    if (!appPprEnabled) {
+        return false;
+    }
+    if (!route.loadingPath) {
+        return false;
+    }
+    return route.renderMode === 'static' || route.renderMode === 'isr';
+}
+function getPprShellArtifactPath(urlPath) {
+    const normalized = urlPath === '/' ? '/index' : urlPath;
+    return `static/pages${normalized}.shell.html`;
+}
+function createPartialPrerenderInfo(urlPath) {
+    return {
+        enabled: true,
+        strategy: 'loading-boundary',
+        shellArtifact: getPprShellArtifactPath(urlPath),
+        resumePath: urlPath,
+    };
+}
+function resolvePprRequestMode(input) {
+    const headerValue = String(input.headerValue || '').trim().toLowerCase();
+    const queryValue = String(input.queryValue || '').trim().toLowerCase();
+    const value = headerValue || queryValue;
+    if (value === 'shell') {
+        return 'shell';
+    }
+    if (value === 'resume') {
+        return 'resume';
+    }
+    return 'default';
+}
+function injectPprResumeBootstrap(shellHtml, urlPath) {
+    const payload = JSON.stringify({
+        url: urlPath,
+        headerName: 'x-vista-prerender',
+        headerValue: 'resume',
+        queryKey: '__vista_prerender',
+        queryValue: 'resume',
+    });
+    const script = `<script>window.__VISTA_PPR_RESUME__=${payload};(function(){var c=window.__VISTA_PPR_RESUME__;if(!c)return;var root=document.getElementById('root');if(!root)return;var finished=false;function ensureTraceStore(){var existing=window.__VISTA_RUNTIME_TRACE__;if(existing&&typeof existing.pushEvent==='function'&&Array.isArray(existing.events)){return existing;}var store={events:[],lastEvent:null,pushEvent:function(type,detail){var entry={type:type,detail:detail||{},at:Date.now()};store.events.push(entry);if(store.events.length>60){store.events.shift();}store.lastEvent=entry;return entry;}};window.__VISTA_RUNTIME_TRACE__=store;return store;}function trace(type,detail){var store=ensureTraceStore();return store.pushEvent(type,detail||{});}function mark(mode){document.documentElement.setAttribute('data-vista-ppr',mode);}function emit(name,detail){document.dispatchEvent(new CustomEvent(name,{detail:detail}));}trace('ppr-shell-rendered',{url:c.url});mark('shell');emit('vista:ppr-shell',{url:c.url});function complete(detail){trace('ppr-resume-complete',detail);emit('vista:ppr-complete',detail);}function fail(detail,error){trace('ppr-resume-error',{url:detail&&detail.url||c.url,mode:detail&&detail.mode||'unknown',message:(error&&error.message)||String(error||'Unknown PPR resume error')});emit('vista:ppr-error',{url:detail&&detail.url||c.url,mode:detail&&detail.mode||'unknown',message:(error&&error.message)||String(error||'Unknown PPR resume error')});mark('error');console.error('[vista:ppr] resume failed',error);}function fallbackHtmlResume(){var resumeUrl=new URL(c.url,window.location.href);resumeUrl.searchParams.set(c.queryKey,c.queryValue);trace('ppr-resume-start',{url:resumeUrl.toString(),mode:'html'});emit('vista:ppr-resume',{url:resumeUrl.toString(),mode:'html'});fetch(resumeUrl.toString(),{headers:{[c.headerName]:c.headerValue},credentials:'same-origin',cache:'no-store'}).then(function(res){return res.text().then(function(html){return{res:res,html:html,url:resumeUrl.toString()};});}).then(function(result){if(!result.res.ok){throw new Error('Resume request failed with status '+result.res.status);}var parsed=new DOMParser().parseFromString(result.html,'text/html');var nextRoot=parsed.getElementById('root');if(nextRoot){root.innerHTML=nextRoot.innerHTML;}var nextTitle=parsed.querySelector('title');if(nextTitle&&nextTitle.textContent){document.title=nextTitle.textContent;}finished=true;mark('resumed');complete({url:result.url,mode:'html'});}).catch(function(error){fail({url:resumeUrl.toString(),mode:'html'},error);});}function tryFlightResume(){var router=window.__VISTA_RSC_ROUTER__;if(!router||typeof router.resume!=='function'){return false;}finished=true;trace('ppr-resume-start',{url:c.url,mode:'flight'});mark('flight-resume');emit('vista:ppr-resume',{url:c.url,mode:'flight'});router.resume(c.url);return true;}function onFlightComplete(event){var detail=event&&event.detail&&typeof event.detail==='object'?event.detail:{url:c.url};complete({url:detail.url||c.url,mode:'flight'});mark('resumed');}function onFlightError(event){var detail=event&&event.detail&&typeof event.detail==='object'?event.detail:{url:c.url};fail({url:detail.url||c.url,mode:'flight'},new Error(detail.message||'Flight resume failed'));}document.addEventListener('vista:rsc-resume-complete',onFlightComplete,{once:true});document.addEventListener('vista:rsc-resume-error',onFlightError,{once:true});var attempts=0;var maxAttempts=20;function attemptResume(){if(finished)return;if(tryFlightResume())return;attempts++;if(attempts>=maxAttempts){fallbackHtmlResume();return;}setTimeout(attemptResume,100);}document.addEventListener('vista:rsc-router-ready',attemptResume,{once:true});attemptResume();})();</script>`;
+    if (/<\/body>/i.test(shellHtml)) {
+        return shellHtml.replace(/<\/body>/i, `${script}\n</body>`);
+    }
+    return `${shellHtml}\n${script}`;
+}

package/dist/server/request-context.d.ts

@@ -0,0 +1,31 @@
+import type express from 'express';
+import type { ResolvedSegmentConfig } from './segment-config';
+export interface RequestContext {
+    req?: express.Request;
+    res?: express.Response;
+    cwd?: string;
+    vistaDirRoot?: string;
+    urlPath?: string;
+    segmentConfig?: ResolvedSegmentConfig;
+    usedTags: Set<string>;
+    revalidatedTags: Set<string>;
+    revalidatedPaths: Set<string>;
+}
+export interface RequestContextSeed {
+    req?: express.Request;
+    res?: express.Response;
+    cwd?: string;
+    vistaDirRoot?: string;
+    urlPath?: string;
+    segmentConfig?: ResolvedSegmentConfig;
+}
+export declare function runWithRequestContext<T>(seed: RequestContextSeed, callback: () => T): T;
+export declare function getRequestContext(): RequestContext | undefined;
+export declare function setCurrentSegmentConfig(segmentConfig: ResolvedSegmentConfig | undefined): void;
+export declare function getCurrentSegmentConfig(): ResolvedSegmentConfig | undefined;
+export declare function trackCacheTags(tags: Iterable<string> | undefined): void;
+export declare function consumeTrackedTags(): string[];
+export declare function consumeRevalidatedTags(): string[];
+export declare function consumeRevalidatedPaths(): string[];
+export declare function recordRevalidatedTag(tag: string): void;
+export declare function recordRevalidatedPath(urlPath: string): void;

package/dist/server/request-context.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runWithRequestContext = runWithRequestContext;
+exports.getRequestContext = getRequestContext;
+exports.setCurrentSegmentConfig = setCurrentSegmentConfig;
+exports.getCurrentSegmentConfig = getCurrentSegmentConfig;
+exports.trackCacheTags = trackCacheTags;
+exports.consumeTrackedTags = consumeTrackedTags;
+exports.consumeRevalidatedTags = consumeRevalidatedTags;
+exports.consumeRevalidatedPaths = consumeRevalidatedPaths;
+exports.recordRevalidatedTag = recordRevalidatedTag;
+exports.recordRevalidatedPath = recordRevalidatedPath;
+const node_async_hooks_1 = require("node:async_hooks");
+const requestContextStorage = new node_async_hooks_1.AsyncLocalStorage();
+function createRequestContext(seed = {}) {
+    return {
+        req: seed.req,
+        res: seed.res,
+        cwd: seed.cwd,
+        vistaDirRoot: seed.vistaDirRoot,
+        urlPath: seed.urlPath,
+        segmentConfig: seed.segmentConfig,
+        usedTags: new Set(),
+        revalidatedTags: new Set(),
+        revalidatedPaths: new Set(),
+    };
+}
+function runWithRequestContext(seed, callback) {
+    return requestContextStorage.run(createRequestContext(seed), callback);
+}
+function getRequestContext() {
+    return requestContextStorage.getStore();
+}
+function setCurrentSegmentConfig(segmentConfig) {
+    const context = getRequestContext();
+    if (context) {
+        context.segmentConfig = segmentConfig;
+    }
+}
+function getCurrentSegmentConfig() {
+    return getRequestContext()?.segmentConfig;
+}
+function trackCacheTags(tags) {
+    const context = getRequestContext();
+    if (!context || !tags) {
+        return;
+    }
+    for (const tag of tags) {
+        const normalized = String(tag || '').trim();
+        if (normalized) {
+            context.usedTags.add(normalized);
+        }
+    }
+}
+function consumeTrackedTags() {
+    const context = getRequestContext();
+    if (!context || context.usedTags.size === 0) {
+        return [];
+    }
+    const tags = Array.from(context.usedTags);
+    context.usedTags.clear();
+    return tags;
+}
+function consumeRevalidatedTags() {
+    const context = getRequestContext();
+    if (!context || context.revalidatedTags.size === 0) {
+        return [];
+    }
+    const tags = Array.from(context.revalidatedTags);
+    context.revalidatedTags.clear();
+    return tags;
+}
+function consumeRevalidatedPaths() {
+    const context = getRequestContext();
+    if (!context || context.revalidatedPaths.size === 0) {
+        return [];
+    }
+    const paths = Array.from(context.revalidatedPaths);
+    context.revalidatedPaths.clear();
+    return paths;
+}
+function recordRevalidatedTag(tag) {
+    const context = getRequestContext();
+    const normalized = String(tag || '').trim();
+    if (context && normalized) {
+        context.revalidatedTags.add(normalized);
+    }
+}
+function recordRevalidatedPath(urlPath) {
+    const context = getRequestContext();
+    const normalized = String(urlPath || '').trim();
+    if (context && normalized) {
+        context.revalidatedPaths.add(normalized);
+    }
+}

package/dist/server/rsc-engine-flashpack.d.ts

@@ -0,0 +1,4 @@
+import { type RSCEngineOptions } from './rsc-engine';
+export declare function startFlashpackRSCServer(options?: RSCEngineOptions): void;
+export declare const startRSCServer: typeof startFlashpackRSCServer;
+export { startFlashpackRSCServer as default };

package/dist/server/rsc-engine-flashpack.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startRSCServer = void 0;
+exports.startFlashpackRSCServer = startFlashpackRSCServer;
+exports.default = startFlashpackRSCServer;
+const runtime_1 = require("../flashpack/runtime");
+const rsc_engine_1 = require("./rsc-engine");
+function resolveMode() {
+    return process.env.NODE_ENV === 'development' ? 'development' : 'production';
+}
+function startFlashpackRSCServer(options = {}) {
+    const cwd = process.cwd();
+    const mode = resolveMode();
+    const phase = mode === 'development' ? 'dev' : 'start';
+    const strict = process.env.VISTA_FLASHPACK_STRICT !== 'false';
+    const prepared = (0, runtime_1.prepareFlashpackRuntime)({
+        cwd,
+        phase,
+        mode,
+        allowFallback: !strict,
+    });
+    if (process.env.VISTA_DEBUG) {
+        console.log(`[flashpack] server runtime prepared (rust=${prepared.rustPipelineUsed ? 'on' : 'fallback'}) at ${prepared.flashDir}`);
+    }
+    (0, rsc_engine_1.startRSCServer)(options);
+}
+exports.startRSCServer = startFlashpackRSCServer;

package/dist/server/rsc-engine.d.ts

@@ -11,6 +11,8 @@ import webpack from 'webpack';
 export interface RSCEngineOptions {
     port?: number;
     compiler?: webpack.Compiler | null;
+    projectRoot?: string;
+    runtimeRoot?: string;
 }
 export declare function startRSCServer(options?: RSCEngineOptions): void;
 export { startRSCServer as default };