create-inferative 0.2.0-next.20261023154401 → 0.2.0

package/README.md

@@ -41,7 +41,7 @@ Add the token line to your `~/.npmrc`. If the token is missing, step 2 stops and
 
 | Flag | What it does |
 | :-- | :-- |
-| `--starter <name>` | The starter to use: `nuxt-cloudflare` (a client site, the default) or `dashboard-cloudflare` (the dashboard). |
+| `--starter <name>` | The starter to use: `nuxt-cloudflare` (a client site, the default), `dashboard-cloudflare` (the dashboard) or `nuxt-sdk` (a website with its own server that reads a deployment with the SDK). |
 | `--source <giget source>` | Download this source instead of the default starters. |
 | `--local <folder>` | Copy the starter from this starters folder. Nothing is downloaded. |
 | `--no-install` | Do not run `pnpm install`. |

package/dist/bin.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as CreateFrontDoor } from "./front-door-CGKOn3bI.mjs";
+import { t as CreateFrontDoor } from "./front-door-C_ckNreK.mjs";
 import { runMain } from "citty";
 //#region src/bin.ts
 const argv = CreateFrontDoor.rawArgs(process.argv.slice(2));

package/dist/{front-door-CGKOn3bI.mjs → front-door-C_ckNreK.mjs}

@@ -3,7 +3,8 @@ import { defineCommand } from "citty";
 import { basename, dirname, join, relative, resolve } from "node:path";
 import { installDependencies } from "nypm";
 import { x } from "tinyexec";
-import { cp, mkdir, readFile, readdir, rm, rmdir, stat, writeFile } from "node:fs/promises";
+import { cp, mkdir, mkdtemp, readFile, readdir, rm, rmdir, stat, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
 //#region src/package-version.ts
 /**
 * The version in this package's own `package.json`.
@@ -113,10 +114,13 @@ var InitMessages = class InitMessages {
 	static devCommand = "pnpm dev";
 	/** The command that writes the first migration of a starter. A starter commits no migration. */
 	static generateCommand = "pnpm db:generate";
+	/** The starters with no database of their own, so no migration step. */
+	static startersWithoutDatabase = /* @__PURE__ */ new Set(["nuxt-sdk"]);
 	/** The last line of the next steps for each starter: what its `README.md` explains first. */
 	static firstRunLines = {
 		"nuxt-cloudflare": "Fill in the values of .env first. README.md in the project explains the first run, with its first manifest sync (pnpm sync:manifest --first-sync).",
-		"dashboard-cloudflare": "Fill in the values of .env first. README.md in the project explains the secrets, the Cloudflare resources and the first run."
+		"dashboard-cloudflare": "Fill in the values of .env first. README.md in the project explains the secrets, the Cloudflare resources and the first run.",
+		"nuxt-sdk": "Fill in the values of .env first. README.md in the project explains the channel, its two keys and the manifest sync (pnpm sync:manifest)."
 	};
 	/** The last line of the next steps for a starter that {@link firstRunLines} does not name. */
 	static firstRunLine = "Fill in the values of .env first. README.md in the project explains the first run.";
@@ -136,7 +140,7 @@ var InitMessages = class InitMessages {
 				...changeDirectory === void 0 ? [] : [`cd ${InitMessages.quote(changeDirectory)}`],
 				...isInstalled ? [] : [`${DependencyInstaller.command} install`],
 				"cp .env.example .env",
-				InitMessages.generateCommand,
+				...InitMessages.startersWithoutDatabase.has(starter) ? [] : [InitMessages.generateCommand],
 				InitMessages.devCommand
 			].map((step) => `  ${step}`),
 			InitMessages.firstRunLines[starter] ?? InitMessages.firstRunLine
@@ -610,7 +614,7 @@ var NpmrcScopes = class NpmrcScopes {
 };
 //#endregion
 //#region src/init/starter-source.ts
-/** A download that failed. Only this failure makes {@link StarterSource.fetch} try the next source. */
+/** A download that failed or wrote no file. Only this failure makes {@link StarterSource.fetch} try the next source. */
 var StarterDownloadError = class StarterDownloadError extends InitError {
 	/** The giget sources that failed. */
 	sources;
@@ -632,6 +636,31 @@ var StarterDownloadError = class StarterDownloadError extends InitError {
 		return new StarterDownloadError([source], cause instanceof Error ? cause.message : String(cause), { cause });
 	}
 };
+/** No source holds the starter: each download worked and wrote no file. */
+var StarterMissingError = class StarterMissingError extends InitError {
+	/** The giget sources that were tried. */
+	sources;
+	/** The starters that the repository holds, or `undefined` when they could not be read. */
+	listing;
+	constructor(sources, listing) {
+		super(StarterMissingError.describe(sources, listing));
+		this.name = "StarterMissingError";
+		this.sources = sources;
+		this.listing = listing;
+	}
+	/** The message: the starter, the repository and the refs tried, then the starters that exist. */
+	static describe(sources, listing) {
+		const locations = sources.map((source) => StarterSource.locate(source));
+		const [first] = locations;
+		const missing = first !== void 0 && locations.every((location) => location !== void 0 && location.repository === first.repository && location.folder === first.folder) ? `The starter "${first.folder}" does not exist in ${first.repository} (tried ${locations.map((location) => StarterMissingError.refName(location?.ref)).join(", ")}).` : `No source holds the starter: ${sources.join(", ")}.`;
+		if (listing === void 0) return missing;
+		const at = StarterMissingError.refName(listing.ref);
+		return listing.starters.length === 0 ? `${missing} The repository holds no starter at ${at}.` : `${missing} The starters at ${at}: ${listing.starters.join(", ")}.`;
+	}
+	static refName(ref) {
+		return ref === void 0 ? "the default branch" : `#${ref}`;
+	}
+};
 /** Fetches the files of a starter. */
 var StarterSource = class StarterSource {
 	/** The public repository that holds the starters, one folder for each. */
@@ -641,11 +670,19 @@ var StarterSource = class StarterSource {
 	/** The starters of the starters repository, by folder name, with what each one creates. */
 	static starters = {
 		"nuxt-cloudflare": "a client site: the public site and its dashboard on one Worker",
-		"dashboard-cloudflare": "the Inferative dashboard on one Worker"
+		"dashboard-cloudflare": "the Inferative dashboard on one Worker",
+		"nuxt-sdk": "a website with its own server that reads a deployment with the SDK, on Node"
 	};
 	/** The branch that the default sources fall back to. */
 	static fallbackBranch = "main";
 	static starterNamePattern = /^[a-z0-9][a-z0-9-]*$/u;
+	/** Why a source that wrote no file failed. */
+	static missingReason = "the starter folder does not exist there";
+	static locationPattern = /^(?<provider>[\w+.-]+):(?<path>[^#]+)(?:#(?<ref>.+))?$/u;
+	/** The giget sources that are a URL, not a repository path: the error names them whole. */
+	static urlProviders = /* @__PURE__ */ new Set(["http", "https"]);
+	/** The giget providers whose repository path may have more than two segments (GitLab subgroups). */
+	static nestedRepositoryProviders = /* @__PURE__ */ new Set(["gitlab"]);
 	download;
 	/** @param download - The download function. It calls giget by default. */
 	constructor(download = (source, directory) => StarterSource.downloadWithGiget(source, directory)) {
@@ -668,6 +705,37 @@ var StarterSource = class StarterSource {
 		return Object.entries(StarterSource.starters).map(([name, creates]) => `${name} (${creates})`).join(", ");
 	}
 	/**
+	* Splits a giget source of a starter folder, such as `gh:inferative/starters/nuxt-cloudflare#main`.
+	*
+	* @returns The parts, or `undefined` when the source names no folder in a repository.
+	*/
+	static locate(source) {
+		const groups = StarterSource.locationPattern.exec(source)?.groups;
+		const provider = groups?.["provider"];
+		const path = groups?.["path"];
+		if (provider === void 0 || path === void 0) return;
+		const split = StarterSource.splitPath(provider, path);
+		return split === void 0 ? void 0 : {
+			repository: `${provider}:${split.repository}`,
+			folder: split.folder,
+			ref: groups?.["ref"]
+		};
+	}
+	/**
+	* Splits the path of a giget source as giget does: `::` ends the repository path; without it, a GitLab path is
+	* the repository only, and any other path has a repository of two segments.
+	*/
+	static splitPath(provider, path) {
+		const separator = path.indexOf("::");
+		const [repository, folder] = separator >= 0 ? [path.slice(0, separator), path.slice(separator + 2)] : StarterSource.nestedRepositoryProviders.has(provider) ? [path, ""] : [path.split("/").slice(0, 2).join("/"), path.split("/").slice(2).join("/")];
+		const trimmed = folder.replace(/^\/+|\/+$/gu, "");
+		const segments = repository.split("/");
+		return StarterSource.urlProviders.has(provider) || segments.length < 2 || segments.includes("") || trimmed === "" ? void 0 : {
+			repository,
+			folder: trimmed
+		};
+	}
+	/**
 	* Checks a starter name, which becomes a path segment.
 	*
 	* @throws {InitError} When the name is not a plain lowercase folder name.
@@ -678,24 +746,35 @@ var StarterSource = class StarterSource {
 	/**
 	* Downloads the starter from the first source that works.
 	*
-	* Only a failed download moves on to the next source. Any other error stops the run, because the next
-	* source would fail the same way.
+	* Only a failed download, or one that wrote no file, moves on to the next source. Any other error stops the
+	* run, because the next source would fail the same way. Giget does not fail for a folder that the repository
+	* does not hold: it writes nothing.
 	*
 	* @param sources - The giget sources, in order.
 	* @param directory - The folder to fill.
 	* @param resetDirectory - Called before each later source, to remove the half-written files of the last one.
 	* @returns The source that worked.
+	* @throws {StarterMissingError} When no source holds the starter. The message names the starters that exist.
 	* @throws {StarterDownloadError} When every source failed. The message holds each failure.
 	*/
 	async fetch(sources, directory, resetDirectory) {
 		const failures = [];
-		for (const source of sources) try {
-			await this.download(source, directory);
-			return source;
-		} catch (error) {
-			failures.push(StarterDownloadError.of(source, error));
-			await resetDirectory();
+		const missing = [];
+		for (const source of sources) {
+			const before = new Set(await StarterSource.entryNames(directory));
+			try {
+				await this.download(source, directory);
+			} catch (error) {
+				failures.push(StarterDownloadError.of(source, error));
+				await resetDirectory();
+				continue;
+			}
+			if ((await StarterSource.entryNames(directory)).some((entry) => !before.has(entry))) return source;
+			missing.push(source);
+			failures.push(new StarterDownloadError([source], StarterSource.missingReason));
 		}
+		const lastMissing = missing.at(-1);
+		if (lastMissing !== void 0 && missing.length === sources.length) throw new StarterMissingError(sources, await this.listStarters(lastMissing));
 		const [first] = failures;
 		if (failures.length === 1 && first !== void 0) throw first;
 		throw new StarterDownloadError(sources, `Tried ${failures.map((failure) => `${failure.sources.join("")} (${failure.reason})`).join(", then ")}.`);
@@ -722,6 +801,43 @@ var StarterSource = class StarterSource {
 		});
 		return source;
 	}
+	/**
+	* Reads the starter folders of the repository at the ref of a source, from a download of the repository root
+	* into a temporary folder. The starters repository is small, so the second download is cheap.
+	*
+	* @returns The listing, or `undefined` when the source names no repository folder or the download fails.
+	*/
+	async listStarters(source) {
+		const location = StarterSource.locate(source);
+		if (location === void 0) return;
+		const root = location.ref === void 0 ? location.repository : `${location.repository}#${location.ref}`;
+		let directory;
+		try {
+			directory = await mkdtemp(join(tmpdir(), "inferative-starters-"));
+			await this.download(root, directory);
+			const starters = (await readdir(directory, { withFileTypes: true })).filter((entry) => entry.isDirectory() && !entry.name.startsWith(".")).map((entry) => entry.name).sort();
+			return {
+				ref: location.ref,
+				starters
+			};
+		} catch {
+			return;
+		} finally {
+			if (directory !== void 0) await rm(directory, {
+				recursive: true,
+				force: true
+			}).catch(() => void 0);
+		}
+	}
+	/** The entries of a folder, or none when it does not exist. */
+	static async entryNames(directory) {
+		try {
+			return await readdir(directory);
+		} catch (error) {
+			if (ErrorCode.is(error, "ENOENT")) return [];
+			throw error;
+		}
+	}
 	/** The default {@link StarterDownload}. It loads giget on first use, so a local copy needs no giget. */
 	static async downloadWithGiget(source, directory) {
 		const { downloadTemplate } = await import("giget");

package/dist/heximon.inputs.json

@@ -6,7 +6,7 @@
         "../../tools/vitest/build-inputs.ts": "HO104hfJGDCrhwXLsy7I55ONi1PnjtDA6_gpYQ1gYlI",
         "../../tools/vitest/measure-lane.ts": "VKf7uKWSoz3vYvCbLFw76YSksMT_E41akYmYdWIeFbE",
         "../../tsconfig.base.json": "w6D6cbSUqUPq2R3SoBAQReeRQ-kQPVfQbddoBcybh-0",
-        "package.json": "7Ta-mRHwaztqLYBbu3Ez2zG3lxWpM0fDIgP9-yXLt3U",
+        "package.json": "klm0tpBWEWBj7nJ7Y5DUAuFdn0x5AqSvgwo3quoyJ40",
         "src/bin.ts": "IjsGZUVikS80RJn9Bo_1czPmrIh-J2cH4vVLZVmfggQ",
         "src/error-code.ts": "5ollpvBpNVAGGvd0Jfic7xhNc0B_nGN9au8G7OqMIq4",
         "src/front-door.ts": "AvZQP1lKw9zodvbNmg9HIdB8d1pfJx7MsrbBoO_bzlc",
@@ -14,12 +14,12 @@
         "src/init/dependency-installer.ts": "jVTa8spFjggsWLUnSn9Vzvl4D-B2EYwRmpsVaBTCJaI",
         "src/init/init-command.ts": "CWR-yuf-vglYxt2RiNqr5GCoEIiEO0ekvK3nCS20inU",
         "src/init/init-error.ts": "Bdd0MQ9JvVwNHnzFH6aQnA1HiM_mVOsO0utGervvUsQ",
-        "src/init/init-messages.ts": "a5mcbK_R0bKyH2ohyOaMQzJH8WNEFfHz9t-zy_hrQso",
+        "src/init/init-messages.ts": "r9kO19rAH-xgu-U2ty5vVMOPzywWe7z5TzsETbvzvZk",
         "src/init/init-target.ts": "9UaRdl0vf6nVsgHJ5BHFcIIcbScWsocDol9zFf5_Kqc",
         "src/init/manifest-stamper.ts": "0ANMdqEvOUbAYwiihoyIExim9fc0mIcjAkCfw840bfE",
         "src/init/npmrc-scopes.ts": "aRIFEP9-WVq67QPsVjVP8HPPZFltMsKu-xXMFgJbLK4",
         "src/init/project-initializer.ts": "NW9IsMY0Rx1vaDSGNkWUyCxDQU0V6UksrCQdfLK-RSk",
-        "src/init/starter-source.ts": "u8OzsosNZSDZq4KpogMFlA5K-HDxWkGmORUnI1ovzWQ",
+        "src/init/starter-source.ts": "AhAW-qXEBb4c5-beeIS8qh-DqZBkjY0X0IyvlPeWkkQ",
         "src/package-version.ts": "BkSZq0oCN8fB5tbamfWcRonwCyWs2Rw0-qUXq-83zu4",
         "src/process/npm-runner.ts": "KpIcT-JZAnaCXZ6v4AYo5WlEiWfb3jfel9El1R2jqjo",
         "src/registry/registry-access.ts": "DVVkaI0o0MTVfyWZ1d9S8KT8h0WMS16xTzV2mjgf98M",

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { i as RegistryAccessStatus, n as InitCommand, r as RegistryAccess, t as CreateFrontDoor } from "./front-door-CGKOn3bI.mjs";
+import { i as RegistryAccessStatus, n as InitCommand, r as RegistryAccess, t as CreateFrontDoor } from "./front-door-C_ckNreK.mjs";
 export { CreateFrontDoor, InitCommand, RegistryAccess, RegistryAccessStatus };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-inferative",
-  "version": "0.2.0-next.20261023154401",
+  "version": "0.2.0",
   "description": "Create a new Inferative project: the `npm create inferative` command, which installs from public npm only.",
   "keywords": [
     "create",