vite-plugin-zephyr 1.3.0 → 1.4.1

package/README.md

@@ -58,11 +58,52 @@ export default defineConfig({
 
 ### Multi-Environment and SSR Builds
 
-Vite 6, 7, and 8 environment builds are collected across `client`, `server`, RSC, or custom
-child environments and published once after `buildApp` completes. The plugin validates
-that each current environment contributed output; persisted partial-build contributions
-are merged atomically. Vite 5 and watch builds use the direct single-environment upload
-path.
+Vite 7 and 8 application-builder invocations collect output across `client`, `server`,
+RSC, or custom child environments and publish once through the `buildApp` hook. The
+plugin validates that each current environment contributed output; persisted
+partial-build contributions are merged atomically. Programmatic `vite.build()` calls,
+including Slidev builds, use the direct single-environment upload path, as do Vite 5
+and single-environment watch builds.
+
+When `createBuilder()` instantiates multiple environments, publish through
+`builder.buildApp()`. Calling `builder.build(environment)` individually is rejected to
+prevent separate, incomplete deployments. This check tracks actual environment
+creation, so ordinary legacy SSR builds can still select one server environment.
+
+Non-watch programmatic builds collect every output format and publish one combined
+snapshot when the bundler closes, after all expected writes succeed. External partial
+output is claimed and committed once for that snapshot. Library `formats` and explicit
+output arrays are both supported. Separate output directories are preserved relative
+to their common root; TAP artifact paths remain unchanged.
+
+Direct SSR builds infer `snapshotType: 'ssr'` from the selected server build and use its
+emitted entry chunk, including renamed or hashed filenames. Explicit `snapshotType` and
+`entrypoint` options take precedence. Multiple server entry chunks require an explicit
+emitted `entrypoint`. TAP builds do not infer SSR unless explicitly requested.
+
+For direct non-watch publication, Zephyr must observe the final `outputOptions`,
+`writeBundle` and `closeBundle` hooks. Output plugins are checked after normal option
+hooks have returned their changes. Later post-ordered hooks and unresolved asynchronous
+output plugins are rejected because they could change the writers or fail after Zephyr
+records success. Application-builder and watch publication keep their own lifecycles.
+
+If publication and partial-claim rollback both fail, the rollback error is logged
+separately and the original publication error keeps the configured throw-or-log behavior.
+
+Vite 6 does not dispatch plugin `buildApp` hooks. Its non-watch publication supports only
+a single environment without an explicit `builder` configuration; other configurations
+are rejected to avoid publishing incomplete output. Use Vite 7 or newer for coordinated
+application builds.
+
+Place `withZephyr()` before other plugins that combine `enforce: 'pre'` with a
+pre-ordered `buildApp` hook. Zephyr checks this order before building so it can start
+collecting output before any application build hook compiles an environment. The
+ordering check also applies to legacy builds carrying those plugins.
+
+Files generated by a framework after `vite.build()` returns are outside the Vite upload
+lifecycle. For example, Slidev can generate a PDF, an OG image, `404.html`, and
+`_redirects` after Vite finishes; those files need a separate post-build publication
+step if they must be included.
 
 ```typescript
 withZephyr({

package/dist/index.mjs

@@ -1,3 +1,2 @@
-import "node:module";
 export { withZephyr } from "./lib/vite-plugin-zephyr.mjs";
 export { withZephyrPartial } from "./lib/vite-plugin-zephyr-partial.mjs";

package/dist/lib/internal/extract/extract-entrypoint.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { ze_log } from "zephyr-agent";
 import { normalizeEntrypoint } from "../utils/normalize-entrypoint.mjs";
 function extractEntrypoint(config) {

package/dist/lib/internal/extract/extract_mf_plugin.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 function isPlugin(plugin) {
     return !!plugin && 'object' == typeof plugin && 'name' in plugin;
 }

package/dist/lib/internal/extract/extract_vite_assets_map.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { buildAssetsMap } from "zephyr-agent";
 import { loadStaticAssets } from "./load_static_assets.mjs";
 import { mergeViteOutputAssets } from "./merge_vite_output_assets.mjs";

package/dist/lib/internal/extract/load_public_dir.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { basename, resolve } from "node:path";
 import { readDirRecursiveWithContents } from "zephyr-agent";
 import { normalizeFilesystemVitePath, normalizeVitePath } from "../utils/normalize-vite-path.mjs";

package/dist/lib/internal/extract/load_static_assets.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { load_public_dir } from "./load_public_dir.mjs";
 import { load_static_entries } from "./load_static_entries.mjs";
 import { mergeViteOutputAssets } from "./merge_vite_output_assets.mjs";

package/dist/lib/internal/extract/load_static_entries.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { basename, resolve } from "node:path";
 import { readDirRecursiveWithContents } from "zephyr-agent";
 import { normalizeFilesystemVitePath, normalizeVitePath } from "../utils/normalize-vite-path.mjs";

package/dist/lib/internal/extract/merge_vite_output_assets.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { ZeErrors, ZephyrError } from "zephyr-agent";
 import { normalizeVitePath } from "../utils/normalize-vite-path.mjs";
 function outputBytes(asset) {

package/dist/lib/internal/mf-vite-etl/ensure_runtime_plugin.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { fileURLToPath as __rspack_fileURLToPath } from "node:url";
 import { dirname as __rspack_dirname } from "node:path";
 var __rspack_import_meta_dirname__ = __rspack_dirname(__rspack_fileURLToPath(import.meta.url));

package/dist/lib/internal/mf-vite-etl/extract-mf-vite-remotes.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { readPackageJson } from "zephyr-agent";
 function extract_remotes_dependencies(root, mfConfig) {
     const { zephyrDependencies } = readPackageJson(root);

package/dist/lib/internal/mf-vite-etl/federation-metadata.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { ZeErrors, ZephyrError, resolveMfManifestPath } from "zephyr-agent";
 function nonEmptyString(value) {
     return 'string' == typeof value && value.trim() ? value : void 0;

package/dist/lib/internal/mf-vite-etl/runtime_plugin.mjs

@@ -4,15 +4,38 @@ function getGlobalManifestCache() {
     if (!_global[globalCacheKey]) _global[globalCacheKey] = new Map();
     return _global[globalCacheKey];
 }
-function getScriptBaseUrl() {
-    if ("u" > typeof document && document.currentScript) try {
-        const src = document.currentScript.src;
-        if (src) {
-            const url = new URL(src);
-            return `${url.protocol}//${url.host}`;
-        }
-    } catch  {}
-    return '';
+const manifestFileName = 'zephyr-manifest.json';
+function toHttpUrl(value) {
+    if (!value) return;
+    try {
+        const url = new URL(value);
+        return 'http:' === url.protocol || 'https:' === url.protocol ? url : void 0;
+    } catch  {
+        return;
+    }
+}
+function getModuleUrl() {
+    try {
+        return import.meta.url;
+    } catch  {
+        return;
+    }
+}
+function getDocumentBaseUrl() {
+    if ("u" < typeof document || 'function' != typeof document.querySelector) return;
+    if (!document.querySelector('base[href]')) return;
+    try {
+        return toHttpUrl(new URL('.', document.baseURI).href);
+    } catch  {
+        return;
+    }
+}
+export function resolveManifestUrl(moduleUrl) {
+    const script = toHttpUrl(moduleUrl);
+    const documentBase = getDocumentBaseUrl();
+    if (documentBase && (!script || script.origin === documentBase.origin)) return `${documentBase.href}${manifestFileName}`;
+    if (script) return `${script.origin}/${manifestFileName}`;
+    return `/${manifestFileName}`;
 }
 function getRemotes(args) {
     if (Array.isArray(args?.options?.remotes)) return args.options.remotes;
@@ -20,7 +43,7 @@ function getRemotes(args) {
     return [];
 }
 export default function createZephyrRuntimePlugin(options = {}) {
-    const defaultManifestUrl = `${getScriptBaseUrl()}/zephyr-manifest.json`;
+    const defaultManifestUrl = resolveManifestUrl(getModuleUrl());
     const { manifestUrl = defaultManifestUrl } = options;
     let processedRemotes;
     async function fetchManifest(url) {

package/dist/lib/internal/partial-build-scope.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { ZeErrors, ZephyrError } from "zephyr-agent";
 function firstDefined(parts) {
     return parts.every((part)=>!!part) ? parts.join(':') : void 0;

package/dist/lib/internal/types/zephyr-internal-options.mjs

@@ -1 +1 @@
-import "node:module";
+export { };

package/dist/lib/internal/types/zephyr-output.mjs

@@ -1 +1 @@
-import "node:module";
+export { };

package/dist/lib/internal/utils/normalize-entrypoint.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 function normalizeEntrypoint(entrypoint) {
     let normalized = entrypoint.trim();
     normalized = normalized.split('\\').join('/');

package/dist/lib/internal/utils/normalize-vite-path.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { sep } from "node:path";
 function normalizeVitePath(pathname) {
     return pathname.replace(/\\/g, '/');

package/dist/lib/vite-plugin-zephyr-partial.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { ZeErrors, ZephyrEngine, ZephyrError, assertZephyrBuildTarget, handleGlobalError, savePartialAssetMap } from "zephyr-agent";
 import { extract_vite_assets_map } from "./internal/extract/extract_vite_assets_map.mjs";
 import { requireVitePartialBuildScope } from "./internal/partial-build-scope.mjs";