vinext 0.1.8 → 0.2.0

package/dist/init-platform.d.ts

@@ -0,0 +1,40 @@
+import { Readable, Writable } from "node:stream";
+
+//#region src/init-platform.d.ts
+type InitPlatform = "cloudflare" | "node";
+type InitDataCache = "kv" | "none";
+type InitCdnCache = "data-cache" | "workers-cache";
+type InitImageOptimization = "cloudflare-images" | "none";
+type CloudflareInitOptions = {
+  dataCache: InitDataCache;
+  cdnCache: InitCdnCache;
+  imageOptimization: InitImageOptimization;
+};
+declare const INIT_PLATFORMS: {
+  cloudflare: {
+    name: string;
+    options: typeof resolveCloudflareInitOptions;
+  };
+  node: {
+    name: string;
+    options: () => Promise<undefined>;
+  };
+};
+type PlatformPromptOptions = {
+  env?: Record<string, string | undefined>;
+  input?: Readable;
+  output?: Writable;
+  isInteractive?: boolean;
+  question?: (prompt: string) => Promise<string>;
+};
+declare function isAgentEnvironment(env?: Record<string, string | undefined>): boolean;
+declare function parsePlatformArg(args: string[]): InitPlatform | undefined;
+declare function parseDataCacheArg(args: string[]): InitDataCache | undefined;
+declare function parseCdnCacheArg(args: string[]): InitCdnCache | undefined;
+declare function parseImageOptimizationArg(args: string[]): InitImageOptimization | undefined;
+declare function parsePrerenderArg(args: string[]): boolean | undefined;
+declare function resolveInitPlatform(args: string[], options?: PlatformPromptOptions): Promise<InitPlatform>;
+declare function resolveInitPrerender(args: string[], options?: PlatformPromptOptions): Promise<boolean>;
+declare function resolveCloudflareInitOptions(args: string[], options?: PlatformPromptOptions): Promise<CloudflareInitOptions>;
+//#endregion
+export { CloudflareInitOptions, INIT_PLATFORMS, InitCdnCache, InitDataCache, InitImageOptimization, InitPlatform, isAgentEnvironment, parseCdnCacheArg, parseDataCacheArg, parseImageOptimizationArg, parsePlatformArg, parsePrerenderArg, resolveCloudflareInitOptions, resolveInitPlatform, resolveInitPrerender };

package/dist/init-platform.js

@@ -0,0 +1,195 @@
+import { isAgent } from "./node_modules/.pnpm/am-i-vibing@0.5.0/node_modules/am-i-vibing/dist/detector-1yx2Hoe0.js";
+import { createInterface } from "node:readline/promises";
+//#region src/init-platform.ts
+const INIT_PLATFORMS = {
+	cloudflare: {
+		name: "Cloudflare",
+		options: resolveCloudflareInitOptions
+	},
+	node: {
+		name: "Node",
+		options: async () => void 0
+	}
+};
+function isAgentEnvironment(env = process.env) {
+	return isAgent({ env });
+}
+function parsePlatformArg(args) {
+	for (let index = 0; index < args.length; index++) {
+		const arg = args[index];
+		let value;
+		if (arg === "--platform") {
+			value = args[index + 1];
+			if (!value || value.startsWith("-")) throw new Error("--platform requires a value (cloudflare or node).");
+		} else if (arg.startsWith("--platform=")) {
+			value = arg.slice(11);
+			if (!value) throw new Error("--platform requires a value (cloudflare or node).");
+		}
+		if (value) {
+			if (value === "cloudflare" || value === "node") return value;
+			throw new Error(`Unsupported platform "${value}". Expected cloudflare or node.`);
+		}
+	}
+}
+function parseChoiceArg(args, flag, choices, displayedChoices = choices) {
+	for (let index = 0; index < args.length; index++) {
+		const arg = args[index];
+		let value;
+		if (arg === flag) {
+			value = args[index + 1];
+			if (!value || value.startsWith("-")) throw new Error(`${flag} requires a value (${displayedChoices.join(" or ")}).`);
+		} else if (arg.startsWith(`${flag}=`)) {
+			value = arg.slice(flag.length + 1);
+			if (!value) throw new Error(`${flag} requires a value (${displayedChoices.join(" or ")}).`);
+		}
+		if (value) {
+			if (choices.includes(value)) return value;
+			throw new Error(`Unsupported ${flag} value "${value}". Expected ${displayedChoices.join(" or ")}.`);
+		}
+	}
+}
+function parseDataCacheArg(args) {
+	return parseChoiceArg(args, "--data-cache", ["kv", "none"]);
+}
+function parseCdnCacheArg(args) {
+	return parseChoiceArg(args, "--cdn-cache", ["data-cache", "workers-cache"], ["data-cache"]);
+}
+function parseImageOptimizationArg(args) {
+	return parseChoiceArg(args, "--image-optimization", ["cloudflare-images", "none"]);
+}
+function parsePrerenderArg(args) {
+	for (const arg of args) {
+		if (arg === "--prerender") return true;
+		if (arg === "--no-prerender") return false;
+		if (!arg.startsWith("--prerender=")) continue;
+		const value = arg.slice(12).toLowerCase();
+		if (value === "true" || value === "yes" || value === "1") return true;
+		if (value === "false" || value === "no" || value === "0") return false;
+		throw new Error("--prerender expects true or false when using the \"--prerender=value\" form.");
+	}
+}
+async function resolveInitPlatform(args, options = {}) {
+	const explicitPlatform = parsePlatformArg(args);
+	if (explicitPlatform) return explicitPlatform;
+	if (isAgentEnvironment(options.env ?? process.env)) throw new Error("vinext init needs a deployment target. Ask the user whether they want Cloudflare or Node, then re-run the command with --platform=cloudflare or --platform=node.");
+	const input = options.input ?? process.stdin;
+	const output = options.output ?? process.stdout;
+	if (!(options.isInteractive ?? Boolean(process.stdin.isTTY && process.stdout.isTTY))) return "cloudflare";
+	const readline = options.question ? void 0 : createInterface({
+		input,
+		output
+	});
+	const question = options.question ?? ((prompt) => readline.question(prompt));
+	try {
+		while (true) {
+			const answer = (await question(`  Choose a deployment platform:
+    1. ${INIT_PLATFORMS.cloudflare.name} (default)\n    2. ${INIT_PLATFORMS.node.name}\n  Platform [1]: `)).trim().toLowerCase();
+			if (answer === "" || answer === "1" || answer === "cloudflare") {
+				output.write("\n");
+				return "cloudflare";
+			}
+			if (answer === "2" || answer === "node") {
+				output.write("\n");
+				return "node";
+			}
+			output.write("  Please choose Cloudflare (1) or Node (2).\n");
+		}
+	} finally {
+		readline?.close();
+	}
+}
+async function resolveInitPrerender(args, options = {}) {
+	const explicitPrerender = parsePrerenderArg(args);
+	if (explicitPrerender !== void 0) return explicitPrerender;
+	const env = options.env ?? process.env;
+	const input = options.input ?? process.stdin;
+	const output = options.output ?? process.stdout;
+	const isInteractive = options.isInteractive ?? Boolean(process.stdin.isTTY && process.stdout.isTTY);
+	if (isAgentEnvironment(env) || !isInteractive) return false;
+	const readline = options.question ? void 0 : createInterface({
+		input,
+		output
+	});
+	const question = options.question ?? ((prompt) => readline.question(prompt));
+	try {
+		while (true) {
+			const answer = (await question("  Pre-render all static routes after build? [y/N]: ")).trim().toLowerCase();
+			if (answer === "") {
+				output.write("\n");
+				return false;
+			}
+			if (answer === "y" || answer === "yes") {
+				output.write("\n");
+				return true;
+			}
+			if (answer === "n" || answer === "no") {
+				output.write("\n");
+				return false;
+			}
+			output.write("  Please answer yes or no.\n");
+		}
+	} finally {
+		readline?.close();
+	}
+}
+async function resolveCloudflareInitOptions(args, options = {}) {
+	const explicitDataCache = parseDataCacheArg(args);
+	const explicitCdnCache = parseCdnCacheArg(args);
+	const explicitImageOptimization = parseImageOptimizationArg(args);
+	if (explicitDataCache && explicitImageOptimization) return {
+		dataCache: explicitDataCache,
+		cdnCache: explicitCdnCache ?? "data-cache",
+		imageOptimization: explicitImageOptimization
+	};
+	if (isAgentEnvironment(options.env ?? process.env)) throw new Error("vinext init needs Cloudflare cache and image choices. Ask the user which data cache (kv or none) and image optimization (cloudflare-images or none) they want, then re-run with --data-cache=... and --image-optimization=....");
+	const input = options.input ?? process.stdin;
+	const output = options.output ?? process.stdout;
+	if (!(options.isInteractive ?? Boolean(process.stdin.isTTY && process.stdout.isTTY))) return {
+		dataCache: explicitDataCache ?? "kv",
+		cdnCache: explicitCdnCache ?? "data-cache",
+		imageOptimization: explicitImageOptimization ?? "cloudflare-images"
+	};
+	const readline = options.question ? void 0 : createInterface({
+		input,
+		output
+	});
+	const question = options.question ?? ((prompt) => readline.question(prompt));
+	try {
+		const promptChoice = async (current, prompt, values, defaultValue, error) => {
+			if (current) return current;
+			while (true) {
+				const answer = (await question(prompt)).trim().toLowerCase();
+				if (answer === "") {
+					output.write("\n");
+					return defaultValue;
+				}
+				const value = values[answer];
+				if (value) {
+					output.write("\n");
+					return value;
+				}
+				output.write(`  ${error}\n`);
+			}
+		};
+		return {
+			dataCache: await promptChoice(explicitDataCache, "  Choose a data cache:\n    1. Cloudflare KV (default)\n    2. None\n  Data cache [1]: ", {
+				"1": "kv",
+				kv: "kv",
+				"2": "none",
+				none: "none"
+			}, "kv", "Please choose Cloudflare KV (1) or None (2)."),
+			cdnCache: explicitCdnCache ?? "data-cache",
+			imageOptimization: await promptChoice(explicitImageOptimization, "  Choose image optimization:\n    1. Cloudflare Images (default)\n    2. None\n  Image optimization [1]: ", {
+				"1": "cloudflare-images",
+				"cloudflare-images": "cloudflare-images",
+				images: "cloudflare-images",
+				"2": "none",
+				none: "none"
+			}, "cloudflare-images", "Please choose Cloudflare Images (1) or None (2).")
+		};
+	} finally {
+		readline?.close();
+	}
+}
+//#endregion
+export { INIT_PLATFORMS, isAgentEnvironment, parseCdnCacheArg, parseDataCacheArg, parseImageOptimizationArg, parsePlatformArg, parsePrerenderArg, resolveCloudflareInitOptions, resolveInitPlatform, resolveInitPrerender };

package/dist/init.d.ts

@@ -1,30 +1,21 @@
+import { CloudflareInitOptions, InitPlatform } from "./init-platform.js";
+import { getReactUpgradeDeps } from "./utils/react-version.js";
+
 //#region src/init.d.ts
-/**
- * vinext init — one-command project migration for Next.js apps.
- *
- * Automates the steps needed to run a Next.js app under vinext:
- *
- *   1. Run `vinext check` to show compatibility report
- *   2. Install dependencies (vite, @vitejs/plugin-react, and App Router deps)
- *   3. Add "type": "module" to package.json
- *   4. Rename CJS config files to .cjs
- *   5. Add vinext scripts to package.json
- *   6. Generate vite.config.ts
- *   7. Update .gitignore to include /dist/ and .vinext/
- *   8. Print summary
- *
- * Non-destructive: does NOT modify next.config, tsconfig, or source files.
- * The project should work with both Next.js and vinext simultaneously.
- */
 type InitOptions = {
   /** Project root directory */root: string; /** Dev server port (default: 3001) */
   port?: number; /** Skip the compatibility check step */
   skipCheck?: boolean; /** Force overwrite even if vite.config.ts exists */
-  force?: boolean; /** @internal — override exec for testing (avoids ESM spy issues) */
+  force?: boolean; /** Deployment target selected by the user */
+  platform?: InitPlatform; /** Configure build-time pre-rendering for all discovered static routes */
+  prerender?: boolean; /** Cloudflare cache and image choices. */
+  cloudflare?: CloudflareInitOptions; /** @internal — override exec for testing (avoids ESM spy issues) */
   _exec?: (cmd: string, opts: {
     cwd: string;
     stdio: string;
-  }) => void;
+  }) => string | void | Promise<string | void>; /** @internal — override pnpm ignored-builds inspection for testing */
+  _inspectPnpmIgnoredBuilds?: (root: string) => string; /** @internal — stable compatibility date for snapshot tests */
+  _today?: string;
 };
 type InitResult = {
   /** Whether dependencies were installed */installedDeps: string[]; /** Whether "type": "module" was added */
@@ -33,37 +24,24 @@ type InitResult = {
   addedScripts: string[]; /** Whether vite.config.ts was generated */
   generatedViteConfig: boolean; /** Whether vite.config.ts generation was skipped (already exists) */
   skippedViteConfig: boolean; /** Whether .gitignore was updated to include vinext-generated output */
-  updatedGitignore: boolean;
+  updatedGitignore: boolean; /** Deployment target configured by init */
+  platform: InitPlatform; /** Platform-specific deployment files generated by init */
+  generatedPlatformFiles: string[];
 };
-declare function generateViteConfig(_isAppRouter: boolean): string;
+declare function generateViteConfig(_isAppRouter: boolean, prerender?: boolean): string;
 /**
  * Add vinext scripts to package.json without overwriting existing scripts.
  * Returns the list of script names that were added.
  */
 declare function addScripts(root: string, port: number): string[];
-declare function getInitDeps(isAppRouter: boolean): string[];
+declare function getInitDeps(isAppRouter: boolean, platform: InitPlatform): string[];
 declare function isDepInstalled(root: string, dep: string): boolean;
-/**
- * Check if react/react-dom need upgrading for react-server-dom-webpack compatibility.
- *
- * react-server-dom-webpack versions are pinned to match their React version
- * (e.g. rsdw@19.2.6 requires react@^19.2.6). When a project has an older
- * React (e.g. create-next-app ships react@19.2.3), we need to upgrade
- * react/react-dom BEFORE installing rsdw to avoid peer-dep conflicts.
- *
- * Uses createRequire to resolve react's package.json through Node's module
- * resolution, which works correctly across all package managers (npm, pnpm,
- * yarn, Yarn PnP) and monorepo layouts with hoisting/symlinking.
- *
- * Returns ["react@latest", "react-dom@latest"] if upgrade is needed, [] otherwise.
- */
-declare function getReactUpgradeDeps(root: string): string[];
 /**
  * Ensure vinext-generated output directories are listed in .gitignore.
  * Creates the file if it doesn't exist. Returns true if the file was modified
  * (or created), false if all entries were already present.
  */
-declare function updateGitignore(root: string): boolean;
+declare function updateGitignore(root: string, platform?: InitPlatform): boolean;
 declare function init(options: InitOptions): Promise<InitResult>;
 //#endregion
 export { InitOptions, addScripts, generateViteConfig, getInitDeps, getReactUpgradeDeps, init, isDepInstalled, updateGitignore };