@fluid-app/fluid-cli-portal 0.1.46 → 0.1.48

package/dist/portal-dev-plugin-CytSDvBy.mjs

@@ -0,0 +1,287 @@
+import { t as __exportAll } from "./rolldown-runtime-twds-ZHy.mjs";
+import { basename, extname, join, resolve, sep } from "node:path";
+import { readFile, readdir } from "node:fs/promises";
+import { existsSync, readFileSync } from "node:fs";
+import { createHash } from "node:crypto";
+//#region src/vite-plugin/build-manifest.ts
+/**
+* Build a RawManifestResponse from local portal/ files.
+*
+* Reads the portal directory structure produced by `fluid portal pull` and
+* assembles it into the same shape the SDK expects from the
+* `/api/fluid_os/definitions/active` endpoint, so the existing
+* `transformManifestToRepAppData()` pipeline works unchanged.
+*/
+/**
+* Generate a deterministic synthetic numeric ID from a string key.
+* Uses a CRC32-like hash so the same slug always produces the same ID
+* within a dev session, while avoiding collisions in practice.
+*/
+function syntheticId(key) {
+	return createHash("md5").update(key).digest().readUInt32BE(0);
+}
+/**
+* Read and parse a JSON file, returning null on failure.
+*/
+async function readJsonFile(filePath) {
+	try {
+		const content = await readFile(filePath, "utf-8");
+		return JSON.parse(content);
+	} catch {
+		return null;
+	}
+}
+/**
+* Read all JSON files in a directory, returning an array of [slug, data] tuples.
+* Slug is the filename without extension.
+*/
+async function readJsonDir(dirPath) {
+	if (!existsSync(dirPath)) return [];
+	const entries = await readdir(dirPath, { withFileTypes: true });
+	const results = [];
+	for (const entry of entries) {
+		if (!entry.isFile() || extname(entry.name) !== ".json") continue;
+		const slug = basename(entry.name, ".json");
+		const data = await readJsonFile(join(dirPath, entry.name));
+		if (data != null) results.push([slug, data]);
+	}
+	return results;
+}
+/**
+* Convert local navigation items (which reference screens by slug)
+* back to the raw API format (which uses screen_id).
+*/
+function toRawNavigationItems(items, screenSlugToId) {
+	return items.map((item) => {
+		const rawItem = {
+			id: item.id,
+			label: item.label ?? "Untitled",
+			position: item.position ?? 0,
+			children: toRawNavigationItems(item.children ?? [], screenSlugToId)
+		};
+		if (item.slug != null) rawItem.slug = item.slug;
+		if (item.icon != null) rawItem.icon = item.icon;
+		if (item.source != null) rawItem.source = item.source;
+		if (item.parent_id != null) rawItem.parent_id = item.parent_id;
+		if (item.screen != null) {
+			const screenId = screenSlugToId.get(item.screen);
+			if (screenId != null) rawItem.screen_id = screenId;
+		}
+		return rawItem;
+	});
+}
+/**
+* Build a `RawManifestResponse` from local portal/ files.
+*
+* The returned object matches the shape from `/api/fluid_os/definitions/active`
+* so the SDK's `transformManifestToRepAppData()` works without modification.
+*/
+async function buildManifestFromLocalFiles(portalDir) {
+	const definitionId = syntheticId(`definition:${(await readJsonFile(join(portalDir, "definition.json")))?.name ?? "Local Dev"}`);
+	const [screenEntries, themeEntries, navEntries, profileEntries] = await Promise.all([
+		readJsonDir(join(portalDir, "screens")),
+		readJsonDir(join(portalDir, "themes")),
+		readJsonDir(join(portalDir, "navigations")),
+		readJsonDir(join(portalDir, "profiles"))
+	]);
+	const screenSlugToId = /* @__PURE__ */ new Map();
+	for (const [slug] of screenEntries) screenSlugToId.set(slug, syntheticId(`screen:${slug}`));
+	const rawScreens = screenEntries.map(([slug, screen]) => ({
+		id: screenSlugToId.get(slug),
+		definition_id: definitionId,
+		name: screen.name,
+		slug,
+		component_tree: screen.component_tree
+	}));
+	const themeSlugToRaw = /* @__PURE__ */ new Map();
+	for (const [slug, theme] of themeEntries) themeSlugToRaw.set(slug, {
+		id: syntheticId(`theme:${slug}`),
+		name: theme.name,
+		config: theme.config,
+		active: theme.active
+	});
+	const rawThemes = Array.from(themeSlugToRaw.values());
+	const navSlugToId = /* @__PURE__ */ new Map();
+	for (const [slug] of navEntries) navSlugToId.set(slug, syntheticId(`navigation:${slug}`));
+	const rawNavigations = /* @__PURE__ */ new Map();
+	for (const [slug, nav] of navEntries) rawNavigations.set(slug, {
+		id: navSlugToId.get(slug),
+		name: nav.name,
+		definition_id: definitionId,
+		navigation_items: toRawNavigationItems(nav.navigation_items ?? [], screenSlugToId)
+	});
+	const defaultProfile = profileEntries.find(([, p]) => p.default)?.[1] ?? profileEntries[0]?.[1] ?? null;
+	let rawProfile;
+	if (defaultProfile) {
+		const navigation = defaultProfile.navigation ? rawNavigations.get(defaultProfile.navigation) : void 0;
+		const mobileNavigation = defaultProfile.mobile_navigation ? rawNavigations.get(defaultProfile.mobile_navigation) : void 0;
+		const profileThemeSet = new Set(defaultProfile.themes);
+		const profileThemes = profileThemeSet.size > 0 ? Array.from(profileThemeSet).map((slug) => themeSlugToRaw.get(slug)).filter((t) => t != null) : rawThemes;
+		rawProfile = {
+			name: defaultProfile.name,
+			definition_id: definitionId,
+			themes: profileThemes,
+			...navigation ? { navigation } : {},
+			...mobileNavigation ? { mobile_navigation: mobileNavigation } : {}
+		};
+	} else if (rawThemes.length > 0 || rawNavigations.size > 0) {
+		const firstNav = rawNavigations.size > 0 ? rawNavigations.values().next().value : void 0;
+		rawProfile = {
+			name: "Default",
+			definition_id: definitionId,
+			themes: rawThemes,
+			...firstNav ? { navigation: firstNav } : {}
+		};
+	}
+	return { manifest: {
+		definition_id: definitionId,
+		published_version: 0,
+		screens: rawScreens,
+		...rawProfile ? { profile: rawProfile } : {}
+	} };
+}
+//#endregion
+//#region src/vite-plugin/portal-dev-plugin.ts
+/**
+* Vite plugin for local portal content development.
+*
+* Intercepts the manifest API request and serves content assembled from the
+* local `portal/` directory. Watches portal files for changes and triggers a
+* full page reload.
+*
+* The manifest is intercepted on BOTH paths the SDK has used across versions
+* (`/api/app/manifest` since portal-sdk 0.1.4xx, `/api/fluid_os/definitions/
+* active` before that) so a newer SDK against an older-generation app — or
+* vice versa — still gets the local draft.
+*/
+var portal_dev_plugin_exports = /* @__PURE__ */ __exportAll({ portalDevPlugin: () => portalDevPlugin });
+const DEBOUNCE_MS = 100;
+/** Manifest endpoints across SDK generations — all serve the local draft. */
+const MANIFEST_PATHS = ["/api/app/manifest", "/api/fluid_os/definitions/active"];
+const DEFAULT_API_URL = "https://api.fluid.app";
+/**
+* Fallback .env reader for VITE_API_URL, used only when vite's `loadEnv`
+* can't be imported (it's a declared dependency, so this is defensive — but
+* a broken install must degrade to "wrong host" rather than "dev server
+* won't boot"). Mirrors the basic lookup order: live env > .env.local >
+* .env. Unlike loadEnv it ignores .env.[mode] files and variable expansion.
+*/
+function readViteApiUrlFallback(root) {
+	if (process.env.VITE_API_URL) return process.env.VITE_API_URL;
+	if (process.env.NEXT_PUBLIC_API_BASE_URL) return process.env.NEXT_PUBLIC_API_BASE_URL;
+	for (const file of [".env.local", ".env"]) {
+		const path = join(root, file);
+		if (!existsSync(path)) continue;
+		for (const line of readFileSync(path, "utf8").split("\n")) {
+			const match = /^\s*VITE_API_URL\s*=\s*(?:"([^"]*)"|(.*?))\s*(?:#.*)?$/.exec(line);
+			const value = match?.[1] ?? match?.[2];
+			if (value) return value;
+		}
+	}
+}
+/**
+* Resolve VITE_API_URL the way vite itself would — `loadEnv` honors
+* .env.[mode], .env.[mode].local, envDir, and variable expansion, which the
+* fallback parser does not (a mode-specific staging API must not silently
+* fall back to production).
+*/
+async function resolveViteApiUrl(root, mode, envDir) {
+	try {
+		const { loadEnv } = await import("vite");
+		const env = loadEnv(mode, envDir ?? root, ["VITE_", "NEXT_PUBLIC_"]);
+		return env.VITE_API_URL || process.env.VITE_API_URL || env.NEXT_PUBLIC_API_BASE_URL || process.env.NEXT_PUBLIC_API_BASE_URL || void 0;
+	} catch {
+		return readViteApiUrlFallback(root);
+	}
+}
+function portalDevPlugin(options) {
+	let portalDir;
+	let cachedManifest = null;
+	let buildInFlight = null;
+	return {
+		name: "fluid-portal-dev",
+		enforce: "pre",
+		async config(config, env) {
+			if (env?.command !== "serve" || options?.sameOriginDev === false) return {};
+			const root = config.root ?? process.cwd();
+			const target = options?.apiProxyTarget ?? await resolveViteApiUrl(root, env?.mode ?? "development", config.envDir) ?? DEFAULT_API_URL;
+			return {
+				define: config.define?.["import.meta.env.VITE_API_URL"] === void 0 ? { "import.meta.env.VITE_API_URL": JSON.stringify("") } : {},
+				server: { proxy: config.server?.proxy?.["/api"] === void 0 ? { "/api": {
+					target,
+					changeOrigin: true
+				} } : {} }
+			};
+		},
+		configResolved(config) {
+			const root = config.root ?? process.cwd();
+			portalDir = options?.portalDir ? resolve(root, options.portalDir) : join(root, "portal");
+		},
+		configureServer(server) {
+			if (server.__fluidPortalDevWired) return;
+			server.__fluidPortalDevWired = true;
+			const watchDir = portalDir;
+			if (existsSync(watchDir)) {
+				server.watcher.add(watchDir);
+				let reloadTimer = null;
+				const onFileChange = (filePath) => {
+					if (!filePath.startsWith(watchDir)) return;
+					cachedManifest = null;
+					buildInFlight = null;
+					console.log(`[fluid-portal-dev] File changed: ${filePath.replace(watchDir + sep, "")}`);
+					if (reloadTimer) clearTimeout(reloadTimer);
+					reloadTimer = setTimeout(() => {
+						reloadTimer = null;
+						server.ws.send({
+							type: "full-reload",
+							path: "*"
+						});
+					}, DEBOUNCE_MS);
+				};
+				server.watcher.on("change", onFileChange);
+				server.watcher.on("add", onFileChange);
+				server.watcher.on("unlink", onFileChange);
+			}
+			server.middlewares.use((req, res, next) => {
+				const url = req.url;
+				if (!url || !MANIFEST_PATHS.some((path) => url.includes(path))) {
+					next();
+					return;
+				}
+				(async () => {
+					try {
+						if (!existsSync(portalDir)) {
+							next();
+							return;
+						}
+						if (cachedManifest == null) {
+							if (!buildInFlight) buildInFlight = buildManifestFromLocalFiles(portalDir).then((m) => {
+								cachedManifest = JSON.stringify(m);
+								buildInFlight = null;
+								return cachedManifest;
+							}).catch((err) => {
+								buildInFlight = null;
+								throw err;
+							});
+							cachedManifest = await buildInFlight;
+						}
+						res.writeHead(200, {
+							"Content-Type": "application/json",
+							"X-Portal-Dev-Mode": "true",
+							"Cache-Control": "no-store"
+						});
+						res.end(cachedManifest);
+					} catch (err) {
+						console.error("[fluid-portal-dev] Error building manifest:", err);
+						res.writeHead(500, { "Content-Type": "application/json" });
+						res.end(JSON.stringify({ error: err instanceof Error ? err.message : "Failed to build manifest from local files" }));
+					}
+				})();
+			});
+		}
+	};
+}
+//#endregion
+export { portal_dev_plugin_exports as n, buildManifestFromLocalFiles as r, portalDevPlugin as t };
+
+//# sourceMappingURL=portal-dev-plugin-CytSDvBy.mjs.map

package/dist/portal-dev-plugin-CytSDvBy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-dev-plugin-CytSDvBy.mjs","names":[],"sources":["../src/vite-plugin/build-manifest.ts","../src/vite-plugin/portal-dev-plugin.ts"],"sourcesContent":["/**\n * Build a RawManifestResponse from local portal/ files.\n *\n * Reads the portal directory structure produced by `fluid portal pull` and\n * assembles it into the same shape the SDK expects from the\n * `/api/fluid_os/definitions/active` endpoint, so the existing\n * `transformManifestToRepAppData()` pipeline works unchanged.\n */\n\nimport { readFile, readdir } from \"node:fs/promises\";\nimport { join, basename, extname } from \"node:path\";\nimport { existsSync } from \"node:fs\";\nimport { createHash } from \"node:crypto\";\n\nimport type {\n  LocalScreen,\n  LocalTheme,\n  LocalNavigation,\n  LocalNavigationItem,\n  LocalProfile,\n} from \"../utils/transform.js\";\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Types matching the RawManifestResponse shape from\n// packages/portal/sdk/src/transforms/index.ts\n// ─────────────────────────────────────────────────────────────────────────────\n\ninterface RawNavigationItem {\n  id: number;\n  label: string;\n  slug?: string;\n  icon?: string;\n  screen_id?: number;\n  parent_id?: number;\n  source?: string;\n  position: number;\n  children: RawNavigationItem[];\n}\n\ninterface RawNavigation {\n  id: number;\n  name?: string;\n  definition_id: number;\n  navigation_items?: RawNavigationItem[];\n}\n\ninterface RawTheme {\n  id: number;\n  config?: Record<string, unknown> | null;\n  active?: boolean | null;\n  name?: string | null;\n}\n\ninterface RawScreen {\n  id: number;\n  definition_id?: number;\n  name?: string | null;\n  slug?: string | null;\n  component_tree?: unknown;\n}\n\ninterface RawManifestProfile {\n  name?: string;\n  definition_id: number;\n  themes?: RawTheme[];\n  navigation?: RawNavigation;\n  mobile_navigation?: RawNavigation;\n}\n\ninterface RawManifestResponse {\n  manifest: {\n    definition_id: number;\n    published_version?: number;\n    screens?: RawScreen[];\n    profile?: RawManifestProfile;\n  };\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Synthetic ID generation\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Generate a deterministic synthetic numeric ID from a string key.\n * Uses a CRC32-like hash so the same slug always produces the same ID\n * within a dev session, while avoiding collisions in practice.\n */\nfunction syntheticId(key: string): number {\n  const hash = createHash(\"md5\").update(key).digest();\n  // Read first 4 bytes as unsigned 32-bit integer, ensure positive\n  return hash.readUInt32BE(0);\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// File reading helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Read and parse a JSON file, returning null on failure.\n */\nasync function readJsonFile<T>(filePath: string): Promise<T | null> {\n  try {\n    const content = await readFile(filePath, \"utf-8\");\n    return JSON.parse(content) as T;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Read all JSON files in a directory, returning an array of [slug, data] tuples.\n * Slug is the filename without extension.\n */\nasync function readJsonDir<T>(\n  dirPath: string,\n): Promise<Array<[slug: string, data: T]>> {\n  if (!existsSync(dirPath)) return [];\n\n  const entries = await readdir(dirPath, { withFileTypes: true });\n  const results: Array<[string, T]> = [];\n\n  for (const entry of entries) {\n    if (!entry.isFile() || extname(entry.name) !== \".json\") continue;\n\n    const slug = basename(entry.name, \".json\");\n    const data = await readJsonFile<T>(join(dirPath, entry.name));\n    if (data != null) {\n      results.push([slug, data]);\n    }\n  }\n\n  return results;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Navigation item conversion\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Convert local navigation items (which reference screens by slug)\n * back to the raw API format (which uses screen_id).\n */\nfunction toRawNavigationItems(\n  items: LocalNavigationItem[],\n  screenSlugToId: Map<string, number>,\n): RawNavigationItem[] {\n  return items.map((item) => {\n    const rawItem: RawNavigationItem = {\n      id: item.id,\n      label: item.label ?? \"Untitled\",\n      position: item.position ?? 0,\n      children: toRawNavigationItems(item.children ?? [], screenSlugToId),\n    };\n\n    if (item.slug != null) rawItem.slug = item.slug;\n    if (item.icon != null) rawItem.icon = item.icon;\n    if (item.source != null) rawItem.source = item.source;\n    if (item.parent_id != null) rawItem.parent_id = item.parent_id;\n\n    // Resolve screen slug -> synthetic screen ID\n    if (item.screen != null) {\n      const screenId = screenSlugToId.get(item.screen);\n      if (screenId != null) {\n        rawItem.screen_id = screenId;\n      }\n    }\n\n    return rawItem;\n  });\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Main builder\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Build a `RawManifestResponse` from local portal/ files.\n *\n * The returned object matches the shape from `/api/fluid_os/definitions/active`\n * so the SDK's `transformManifestToRepAppData()` works without modification.\n */\nexport async function buildManifestFromLocalFiles(\n  portalDir: string,\n): Promise<RawManifestResponse> {\n  // 1. Read definition.json\n  const definition = await readJsonFile<{ name?: string }>(\n    join(portalDir, \"definition.json\"),\n  );\n  const definitionName = definition?.name ?? \"Local Dev\";\n  const definitionId = syntheticId(`definition:${definitionName}`);\n\n  // 2. Read all resource files in parallel\n  const [screenEntries, themeEntries, navEntries, profileEntries] =\n    await Promise.all([\n      readJsonDir<LocalScreen>(join(portalDir, \"screens\")),\n      readJsonDir<LocalTheme>(join(portalDir, \"themes\")),\n      readJsonDir<LocalNavigation>(join(portalDir, \"navigations\")),\n      readJsonDir<LocalProfile>(join(portalDir, \"profiles\")),\n    ]);\n\n  // 3. Build screen slug -> synthetic ID map\n  const screenSlugToId = new Map<string, number>();\n  for (const [slug] of screenEntries) {\n    screenSlugToId.set(slug, syntheticId(`screen:${slug}`));\n  }\n\n  // 4. Build raw screens\n  const rawScreens: RawScreen[] = screenEntries.map(([slug, screen]) => ({\n    id: screenSlugToId.get(slug)!,\n    definition_id: definitionId,\n    name: screen.name,\n    slug,\n    component_tree: screen.component_tree,\n  }));\n\n  // 5. Build raw themes (keyed by slug for profile lookup)\n  const themeSlugToRaw = new Map<string, RawTheme>();\n  for (const [slug, theme] of themeEntries) {\n    themeSlugToRaw.set(slug, {\n      id: syntheticId(`theme:${slug}`),\n      name: theme.name,\n      config: theme.config,\n      active: theme.active,\n    });\n  }\n  const rawThemes = Array.from(themeSlugToRaw.values());\n\n  // 6. Build navigation slug -> synthetic ID map\n  const navSlugToId = new Map<string, number>();\n  for (const [slug] of navEntries) {\n    navSlugToId.set(slug, syntheticId(`navigation:${slug}`));\n  }\n\n  // Build raw navigations (keyed by slug for profile lookup)\n  const rawNavigations = new Map<string, RawNavigation>();\n  for (const [slug, nav] of navEntries) {\n    rawNavigations.set(slug, {\n      id: navSlugToId.get(slug)!,\n      name: nav.name,\n      definition_id: definitionId,\n      navigation_items: toRawNavigationItems(\n        nav.navigation_items ?? [],\n        screenSlugToId,\n      ),\n    });\n  }\n\n  // 7. Find the default profile (or use the first one)\n  const defaultProfile =\n    profileEntries.find(([, p]) => p.default)?.[1] ??\n    profileEntries[0]?.[1] ??\n    null;\n\n  // 8. Assemble the profile for the manifest\n  let rawProfile: RawManifestProfile | undefined;\n  if (defaultProfile) {\n    // Resolve navigation slugs to raw navigation objects\n    const navigation = defaultProfile.navigation\n      ? rawNavigations.get(defaultProfile.navigation)\n      : undefined;\n\n    const mobileNavigation = defaultProfile.mobile_navigation\n      ? rawNavigations.get(defaultProfile.mobile_navigation)\n      : undefined;\n\n    // Filter themes to those referenced by the profile (by slug)\n    const profileThemeSet = new Set(defaultProfile.themes);\n    const profileThemes =\n      profileThemeSet.size > 0\n        ? Array.from(profileThemeSet)\n            .map((slug) => themeSlugToRaw.get(slug))\n            .filter((t): t is RawTheme => t != null)\n        : rawThemes; // If no themes specified in profile, include all\n\n    rawProfile = {\n      name: defaultProfile.name,\n      definition_id: definitionId,\n      themes: profileThemes,\n      ...(navigation ? { navigation } : {}),\n      ...(mobileNavigation ? { mobile_navigation: mobileNavigation } : {}),\n    };\n  } else if (rawThemes.length > 0 || rawNavigations.size > 0) {\n    // No profile files but we have themes/navs — create a synthetic profile\n    const firstNav =\n      rawNavigations.size > 0\n        ? rawNavigations.values().next().value\n        : undefined;\n\n    rawProfile = {\n      name: \"Default\",\n      definition_id: definitionId,\n      themes: rawThemes,\n      ...(firstNav ? { navigation: firstNav } : {}),\n    };\n  }\n\n  // 9. Return assembled manifest\n  return {\n    manifest: {\n      definition_id: definitionId,\n      published_version: 0,\n      screens: rawScreens,\n      ...(rawProfile ? { profile: rawProfile } : {}),\n    },\n  };\n}\n","/**\n * Vite plugin for local portal content development.\n *\n * Intercepts the manifest API request and serves content assembled from the\n * local `portal/` directory. Watches portal files for changes and triggers a\n * full page reload.\n *\n * The manifest is intercepted on BOTH paths the SDK has used across versions\n * (`/api/app/manifest` since portal-sdk 0.1.4xx, `/api/fluid_os/definitions/\n * active` before that) so a newer SDK against an older-generation app — or\n * vice versa — still gets the local draft.\n */\n\nimport { join, resolve, sep } from \"node:path\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { buildManifestFromLocalFiles } from \"./build-manifest.js\";\n\n/** Options for the portal dev plugin. */\nexport interface PortalDevPluginOptions {\n  portalDir?: string;\n  /**\n   * When true (default), dev-server requests are forced same-origin: the\n   * plugin blanks `import.meta.env.VITE_API_URL` in serve mode and proxies\n   * `/api` to the configured Fluid host instead. Without this, a `.env`\n   * pointing VITE_API_URL at a remote API makes the SPA fetch its manifest\n   * cross-origin — silently bypassing this plugin and rendering the remote\n   * app instead of the local `portal/` draft. Set false to opt out and let\n   * the SPA call the remote API directly.\n   */\n  sameOriginDev?: boolean;\n  /** Override the `/api` dev-proxy target. Defaults to VITE_API_URL from the process env / .env files, then https://api.fluid.app. */\n  apiProxyTarget?: string;\n}\n\nconst DEBOUNCE_MS = 100;\n\n/** Manifest endpoints across SDK generations — all serve the local draft. */\nconst MANIFEST_PATHS = [\n  \"/api/app/manifest\",\n  \"/api/fluid_os/definitions/active\",\n];\n\nconst DEFAULT_API_URL = \"https://api.fluid.app\";\n\n/**\n * Fallback .env reader for VITE_API_URL, used only when vite's `loadEnv`\n * can't be imported (it's a declared dependency, so this is defensive — but\n * a broken install must degrade to \"wrong host\" rather than \"dev server\n * won't boot\"). Mirrors the basic lookup order: live env > .env.local >\n * .env. Unlike loadEnv it ignores .env.[mode] files and variable expansion.\n */\nfunction readViteApiUrlFallback(root: string): string | undefined {\n  if (process.env.VITE_API_URL) return process.env.VITE_API_URL;\n  if (process.env.NEXT_PUBLIC_API_BASE_URL) {\n    return process.env.NEXT_PUBLIC_API_BASE_URL;\n  }\n  for (const file of [\".env.local\", \".env\"]) {\n    const path = join(root, file);\n    if (!existsSync(path)) continue;\n    for (const line of readFileSync(path, \"utf8\").split(\"\\n\")) {\n      // Quoted values stop at the closing `\"`; unquoted values stop before\n      // an inline ` # comment` tail (dotenv semantics — a trailing comment\n      // must not leak into the proxy target URL).\n      const match =\n        /^\\s*VITE_API_URL\\s*=\\s*(?:\"([^\"]*)\"|(.*?))\\s*(?:#.*)?$/.exec(line);\n      const value = match?.[1] ?? match?.[2];\n      if (value) return value;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Resolve VITE_API_URL the way vite itself would — `loadEnv` honors\n * .env.[mode], .env.[mode].local, envDir, and variable expansion, which the\n * fallback parser does not (a mode-specific staging API must not silently\n * fall back to production).\n */\nasync function resolveViteApiUrl(\n  root: string,\n  mode: string,\n  envDir: string | undefined,\n): Promise<string | undefined> {\n  try {\n    const { loadEnv } = await import(\"vite\");\n    const env = loadEnv(mode, envDir ?? root, [\"VITE_\", \"NEXT_PUBLIC_\"]);\n    return (\n      env.VITE_API_URL ||\n      process.env.VITE_API_URL ||\n      // Portals migrated from Next.js conventions configure the API host as\n      // NEXT_PUBLIC_API_BASE_URL — honored by `fluid portal dev` since it\n      // was introduced, so it stays a recognized source here.\n      env.NEXT_PUBLIC_API_BASE_URL ||\n      process.env.NEXT_PUBLIC_API_BASE_URL ||\n      undefined\n    );\n  } catch {\n    return readViteApiUrlFallback(root);\n  }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function portalDevPlugin(options?: PortalDevPluginOptions): any {\n  let portalDir: string;\n  let cachedManifest: string | null = null;\n  let buildInFlight: Promise<string> | null = null;\n\n  return {\n    name: \"fluid-portal-dev\",\n    enforce: \"pre\" as const,\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    async config(config: any, env: any) {\n      if (env?.command !== \"serve\" || options?.sameOriginDev === false) {\n        return {};\n      }\n\n      const root: string = config.root ?? process.cwd();\n      const target =\n        options?.apiProxyTarget ??\n        (await resolveViteApiUrl(\n          root,\n          env?.mode ?? \"development\",\n          config.envDir,\n        )) ??\n        DEFAULT_API_URL;\n\n      // Vite merges a plugin's returned config OVER the user config, so an\n      // app's own explicit define / /api proxy is only preserved by checking\n      // for it and yielding here.\n      const defines =\n        config.define?.[\"import.meta.env.VITE_API_URL\"] === undefined\n          ? { \"import.meta.env.VITE_API_URL\": JSON.stringify(\"\") }\n          : {};\n      const proxy =\n        config.server?.proxy?.[\"/api\"] === undefined\n          ? { \"/api\": { target, changeOrigin: true } }\n          : {};\n\n      return {\n        define: defines,\n        server: { proxy },\n      };\n    },\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    configResolved(config: any) {\n      const root: string = config.root ?? process.cwd();\n      portalDir = options?.portalDir\n        ? resolve(root, options.portalDir)\n        : join(root, \"portal\");\n    },\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    configureServer(server: any) {\n      // Idempotency: `fluid portal dev` injects this plugin, and a portal's\n      // own vite.config may also wire it. Only the first instance registers\n      // the watcher + middleware so we don't double-reload or double-serve.\n      if (server.__fluidPortalDevWired) return;\n      server.__fluidPortalDevWired = true;\n\n      const watchDir = portalDir;\n\n      if (existsSync(watchDir)) {\n        server.watcher.add(watchDir);\n\n        let reloadTimer: ReturnType<typeof setTimeout> | null = null;\n\n        const onFileChange = (filePath: string) => {\n          if (!filePath.startsWith(watchDir)) return;\n\n          cachedManifest = null;\n          buildInFlight = null;\n\n          console.log(\n            `[fluid-portal-dev] File changed: ${filePath.replace(watchDir + sep, \"\")}`,\n          );\n\n          if (reloadTimer) clearTimeout(reloadTimer);\n          reloadTimer = setTimeout(() => {\n            reloadTimer = null;\n            server.ws.send({ type: \"full-reload\", path: \"*\" });\n          }, DEBOUNCE_MS);\n        };\n\n        server.watcher.on(\"change\", onFileChange);\n        server.watcher.on(\"add\", onFileChange);\n        server.watcher.on(\"unlink\", onFileChange);\n      }\n\n      // ── Middleware to intercept manifest requests ───────────────────\n      // Every MANIFEST_PATHS route returns the SAME `{ manifest }` payload:\n      // the portal-tenant BFF route the current SDK runtime fetches\n      // (useFluidApp → app_manifest_show) and the legacy FluidOS route, so\n      // the local portal/ draft feeds the running app regardless of which\n      // runtime generation it uses (the SDK adapter reads\n      // `response.manifest`, matching buildManifestFromLocalFiles' output).\n      server.middlewares.use(\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        (req: any, res: any, next: () => void) => {\n          const url: string | undefined = req.url;\n\n          if (!url || !MANIFEST_PATHS.some((path) => url.includes(path))) {\n            next();\n            return;\n          }\n\n          (async () => {\n            try {\n              if (!existsSync(portalDir)) {\n                // Fall through to the Vite proxy so requests reach the real\n                // API when local portal content is unavailable (e.g. --skip-pull).\n                next();\n                return;\n              }\n\n              if (cachedManifest == null) {\n                if (!buildInFlight) {\n                  buildInFlight = buildManifestFromLocalFiles(portalDir)\n                    .then((m) => {\n                      cachedManifest = JSON.stringify(m);\n                      buildInFlight = null;\n                      return cachedManifest;\n                    })\n                    .catch((err) => {\n                      buildInFlight = null; // allow retry on next request\n                      throw err;\n                    });\n                }\n                cachedManifest = await buildInFlight;\n              }\n\n              res.writeHead(200, {\n                \"Content-Type\": \"application/json\",\n                \"X-Portal-Dev-Mode\": \"true\",\n                \"Cache-Control\": \"no-store\",\n              });\n              res.end(cachedManifest);\n            } catch (err) {\n              console.error(\"[fluid-portal-dev] Error building manifest:\", err);\n              res.writeHead(500, { \"Content-Type\": \"application/json\" });\n              res.end(\n                JSON.stringify({\n                  error:\n                    err instanceof Error\n                      ? err.message\n                      : \"Failed to build manifest from local files\",\n                }),\n              );\n            }\n          })();\n        },\n      );\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/{pull-CG5dELOX.mjs → pull-XOsFaqz2.mjs}

@@ -1,4 +1,4 @@
-import "node:module";
+import { t as __exportAll } from "./rolldown-runtime-twds-ZHy.mjs";
 import { Command } from "commander";
 import chalk from "chalk";
 import ora from "ora";
@@ -9,18 +9,6 @@ import prompts from "prompts";
 import { existsSync } from "node:fs";
 import pLimit from "p-limit";
 import { createHash, randomBytes } from "node:crypto";
-//#region \0rolldown/runtime.js
-var __defProp = Object.defineProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-//#endregion
 //#region ../../platform/api-client-core/src/fetch-client.ts
 /**
 * API Error class compatible with fluid-admin's ApiError
@@ -1213,4 +1201,4 @@ const pullCommand = new Command("pull").description("Pull a Fluid OS definition'
 //#endregion
 export { fluid_os_v0_create_fluid_osversion as A, fluid_os_v0_update_fluid_osnavigation as B, writeMappings as C, fluid_os_v0_create_fluid_osprofile as D, fluid_os_v0_create_fluid_osnavigation_item as E, fluid_os_v0_delete_fluid_osscreen as F, fluid_os_v0_update_fluid_osversion as G, fluid_os_v0_update_fluid_osprofile as H, fluid_os_v0_delete_fluid_ostheme as I, createFetchClient as K, fluid_os_v0_list_fluid_osdefinitions as L, fluid_os_v0_delete_fluid_osnavigation as M, fluid_os_v0_delete_fluid_osnavigation_item as N, fluid_os_v0_create_fluid_osscreen as O, fluid_os_v0_delete_fluid_osprofile as P, fluid_os_v0_list_fluid_osnavigation_items as R, updateMapping as S, fluid_os_v0_create_fluid_osnavigation as T, fluid_os_v0_update_fluid_osscreen as U, fluid_os_v0_update_fluid_osnavigation_item as V, fluid_os_v0_update_fluid_ostheme as W, deriveSlug as _, buildThemeIdToSlugMap as a, resolveIdToSlug as b, transformNavigationItems as c, transformTheme as d, buildSnapshot as f, writeSnapshot as g, readSnapshot as h, buildNavigationIdToSlugMap as i, fluid_os_v0_create_widget_package_version as j, fluid_os_v0_create_fluid_ostheme as k, transformProfile as l, diffAgainstSnapshot as m, pull_exports as n, deriveScreenSlug as o, computeFileHash as p, buildIdToSlugMap as r, transformNavigation as s, pullCommand as t, transformScreen as u, readMappings as v, fluid_os_v0_complete_widget_package_version_upload as w, resolveSlugToId as x, removeMapping as y, fluid_os_v0_list_fluid_osversions as z };
 
-//# sourceMappingURL=pull-CG5dELOX.mjs.map
+//# sourceMappingURL=pull-XOsFaqz2.mjs.map