@holo-js/cli 0.1.2 → 0.1.3

package/dist/chunk-ICJR7TS4.mjs

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import {
+  fileExists
+} from "./chunk-M7J3YTHR.mjs";
+
+// src/migrations.ts
+import { join } from "path";
+import {
+  generateMigrationTemplate,
+  inferMigrationTableName,
+  inferMigrationTemplateKind,
+  normalizeMigrationSlug
+} from "@holo-js/db";
+var MIGRATION_NAME_PREFIX_PATTERN = /^\d{4}_\d{2}_\d{2}_\d{6}_/;
+function stripMigrationNamePrefix(name) {
+  return name.replace(MIGRATION_NAME_PREFIX_PATTERN, "");
+}
+function getRegistryMigrationSlug(name) {
+  return normalizeMigrationSlug(stripMigrationNamePrefix(name));
+}
+function hasRegisteredMigrationSlug(registry, migrationSlug) {
+  return Boolean(registry?.migrations.some((entry) => {
+    try {
+      return getRegistryMigrationSlug(entry.name) === migrationSlug;
+    } catch {
+      return false;
+    }
+  }));
+}
+function hasRegisteredCreateTableMigration(registry, tableName) {
+  const expectedSlug = `create_${tableName}_table`;
+  return Boolean(registry?.migrations.some((entry) => {
+    try {
+      const slug = getRegistryMigrationSlug(entry.name);
+      if (slug === expectedSlug) {
+        return true;
+      }
+      if (inferMigrationTemplateKind(slug) !== "create_table") {
+        return false;
+      }
+      return inferMigrationTableName(slug, "create_table") === tableName;
+    } catch {
+      return false;
+    }
+  }));
+}
+async function nextMigrationTemplate(name, migrationsDir, options = {}) {
+  let offsetSeconds = 0;
+  while (true) {
+    const candidate = generateMigrationTemplate(name, {
+      date: new Date(Date.now() + offsetSeconds * 1e3),
+      ...options
+    });
+    if (!await fileExists(join(migrationsDir, candidate.fileName))) {
+      return candidate;
+    }
+    offsetSeconds += 1;
+  }
+}
+
+export {
+  getRegistryMigrationSlug,
+  hasRegisteredMigrationSlug,
+  hasRegisteredCreateTableMigration,
+  nextMigrationTemplate
+};

package/dist/chunk-ICKN56JY.mjs

@@ -0,0 +1,342 @@
+import {
+  prepareProjectDiscovery
+} from "./chunk-S7P7EBM3.mjs";
+import {
+  syncManagedDriverDependencies
+} from "./chunk-HE6FYNVN.mjs";
+import {
+  ensureProjectConfig
+} from "./chunk-GSQ3HTRO.mjs";
+import {
+  readTextFile
+} from "./chunk-G5ADO27Q.mjs";
+
+// src/dev.ts
+import { spawnSync, spawn } from "child_process";
+import { watch } from "fs";
+import { readdir, stat } from "fs/promises";
+import { dirname, join, relative, resolve } from "path";
+async function fileExists(path) {
+  try {
+    await stat(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function resolveProjectPackageManager(projectRoot) {
+  const packageJsonPath = join(projectRoot, "package.json");
+  const packageJson = await readTextFile(packageJsonPath);
+  if (packageJson) {
+    try {
+      const parsed = JSON.parse(packageJson);
+      const packageManager = typeof parsed.packageManager === "string" ? parsed.packageManager.split("@")[0] : void 0;
+      if (packageManager === "bun" || packageManager === "npm" || packageManager === "pnpm" || packageManager === "yarn") {
+        return packageManager;
+      }
+    } catch {
+    }
+  }
+  if (await fileExists(join(projectRoot, "bun.lock"))) {
+    return "bun";
+  }
+  if (await fileExists(join(projectRoot, "pnpm-lock.yaml"))) {
+    return "pnpm";
+  }
+  if (await fileExists(join(projectRoot, "yarn.lock"))) {
+    return "yarn";
+  }
+  if (await fileExists(join(projectRoot, "package-lock.json"))) {
+    return "npm";
+  }
+  return "bun";
+}
+async function resolvePackageManagerCommand(projectRoot, scriptName) {
+  const packageManager = await resolveProjectPackageManager(projectRoot);
+  return {
+    command: packageManager,
+    args: ["run", scriptName]
+  };
+}
+async function resolvePackageManagerInstallInvocation(projectRoot) {
+  const packageManager = await resolveProjectPackageManager(projectRoot);
+  return {
+    command: packageManager,
+    args: ["install"]
+  };
+}
+async function runProjectLifecycleScript(io, projectRoot, scriptName, spawn2 = spawnSync) {
+  const invocation = await resolvePackageManagerCommand(projectRoot, scriptName);
+  const result = spawn2(invocation.command, [...invocation.args], {
+    cwd: projectRoot,
+    encoding: "utf8",
+    env: process.env
+  });
+  if (result.stdout) {
+    io.stdout.write(result.stdout);
+  }
+  if (result.stderr) {
+    io.stderr.write(result.stderr);
+  }
+  if (result.status !== 0) {
+    throw new Error(result.stderr?.trim() || result.stdout?.trim() || `Project script "${scriptName}" failed.`);
+  }
+}
+async function runProjectDependencyInstall(io, projectRoot, spawn2 = spawnSync) {
+  const invocation = await resolvePackageManagerInstallInvocation(projectRoot);
+  const result = spawn2(invocation.command, [...invocation.args], {
+    cwd: projectRoot,
+    encoding: "utf8",
+    env: process.env
+  });
+  if (result.stdout) {
+    io.stdout.write(result.stdout);
+  }
+  if (result.stderr) {
+    io.stderr.write(result.stderr);
+  }
+  if (result.status !== 0) {
+    throw new Error(result.stderr?.trim() || result.stdout?.trim() || "Project dependency installation failed.");
+  }
+}
+async function runProjectPrepare(projectRoot, io) {
+  const project = await ensureProjectConfig(projectRoot);
+  await prepareProjectDiscovery(projectRoot, project.config);
+  const updatedDependencies = await syncManagedDriverDependencies(projectRoot);
+  if (updatedDependencies && io) {
+    await runProjectDependencyInstall(io, projectRoot);
+    await prepareProjectDiscovery(projectRoot, project.config);
+  }
+}
+function toPosixSlashes(value) {
+  return value.replaceAll("\\", "/");
+}
+function isDiscoveryRelevantPath(filePath, project) {
+  const normalized = toPosixSlashes(filePath);
+  const authorizationPoliciesPath = project.config.paths.authorizationPolicies || "server/policies";
+  const authorizationAbilitiesPath = project.config.paths.authorizationAbilities || "server/abilities";
+  const roots = [
+    project.config.paths.models,
+    project.config.paths.migrations,
+    project.config.paths.seeders,
+    project.config.paths.commands,
+    project.config.paths.jobs,
+    project.config.paths.events,
+    project.config.paths.listeners,
+    authorizationPoliciesPath,
+    authorizationAbilitiesPath,
+    "server/broadcast",
+    "server/channels",
+    project.config.paths.generatedSchema,
+    "config",
+    ".holo-js/generated"
+  ];
+  if (normalized === ".env" || normalized.startsWith(".env.")) {
+    return true;
+  }
+  return roots.some((root) => normalized === root || normalized.startsWith(`${toPosixSlashes(root)}/`));
+}
+function isRecursiveWatchUnsupported(error) {
+  return error instanceof Error && (error.message.includes("recursive") || "code" in error && error.code === "ERR_FEATURE_UNAVAILABLE_ON_PLATFORM");
+}
+function isIgnorableWatchError(error) {
+  return error instanceof Error && "code" in error && (error.code === "ENOENT" || error.code === "EPERM");
+}
+async function collectDirectoryTree(rootPath, directories) {
+  const rootStats = await stat(rootPath).catch(() => void 0);
+  if (!rootStats?.isDirectory()) {
+    return;
+  }
+  directories.add(rootPath);
+  const entries = await readdir(rootPath, { withFileTypes: true }).catch(() => []);
+  for (const entry of entries) {
+    if (!entry.isDirectory()) {
+      continue;
+    }
+    await collectDirectoryTree(join(rootPath, entry.name), directories);
+  }
+}
+async function collectDiscoveryWatchRoots(projectRoot, project) {
+  const directories = /* @__PURE__ */ new Set();
+  const authorizationPoliciesPath = project.config.paths.authorizationPolicies || "server/policies";
+  const authorizationAbilitiesPath = project.config.paths.authorizationAbilities || "server/abilities";
+  const roots = [
+    projectRoot,
+    resolve(projectRoot, "config"),
+    resolve(projectRoot, ".holo-js/generated"),
+    resolve(projectRoot, project.config.paths.models),
+    resolve(projectRoot, project.config.paths.migrations),
+    resolve(projectRoot, project.config.paths.seeders),
+    resolve(projectRoot, project.config.paths.commands),
+    resolve(projectRoot, project.config.paths.jobs),
+    resolve(projectRoot, project.config.paths.events),
+    resolve(projectRoot, project.config.paths.listeners),
+    resolve(projectRoot, authorizationPoliciesPath),
+    resolve(projectRoot, authorizationAbilitiesPath),
+    resolve(projectRoot, "server/broadcast"),
+    resolve(projectRoot, "server/channels"),
+    dirname(resolve(projectRoot, project.config.paths.generatedSchema))
+  ];
+  for (const rootPath of roots) {
+    await collectDirectoryTree(rootPath, directories);
+  }
+  return [...directories];
+}
+function normalizeWatchedFilePath(projectRoot, watchedRoot, fileName) {
+  return toPosixSlashes(relative(projectRoot, resolve(watchedRoot, fileName)));
+}
+async function runProjectDevServer(io, projectRoot, spawnProcess = spawn, createWatcher = watch, prepare = runProjectPrepare) {
+  let project = await ensureProjectConfig(projectRoot);
+  let refreshNonRecursiveWatchers;
+  let requestChildRestart;
+  const prepareDiscovery = async () => {
+    await prepare(projectRoot, io);
+    project = await ensureProjectConfig(projectRoot);
+    await refreshNonRecursiveWatchers?.();
+  };
+  await prepareDiscovery();
+  let pendingPrepare;
+  let queued = false;
+  let shuttingDown = false;
+  const rerunPrepare = () => {
+    if (shuttingDown) {
+      return;
+    }
+    if (pendingPrepare) {
+      queued = true;
+      return;
+    }
+    pendingPrepare = prepareDiscovery().then(() => {
+      requestChildRestart?.();
+    }).catch((error) => {
+      io.stderr.write(`${error instanceof Error ? error.message : String(error)}
+`);
+    }).finally(() => {
+      pendingPrepare = void 0;
+      if (queued) {
+        queued = false;
+        rerunPrepare();
+      }
+    });
+  };
+  const closeWatchers = (() => {
+    try {
+      const watcher = createWatcher(projectRoot, { recursive: true }, (_eventType, fileName) => {
+        if (shuttingDown || typeof fileName !== "string" || !isDiscoveryRelevantPath(fileName, project)) {
+          return;
+        }
+        rerunPrepare();
+      });
+      return () => watcher.close();
+    } catch (error) {
+      if (!isRecursiveWatchUnsupported(error)) {
+        throw error;
+      }
+      const watchers = [];
+      const closeAllWatchers = () => {
+        while (watchers.length > 0) {
+          watchers.pop()?.close();
+        }
+      };
+      refreshNonRecursiveWatchers = async () => {
+        closeAllWatchers();
+        const watchRoots = await collectDiscoveryWatchRoots(projectRoot, project);
+        for (const watchRoot of watchRoots) {
+          try {
+            watchers.push(createWatcher(watchRoot, { recursive: false }, (_eventType, fileName) => {
+              if (shuttingDown || typeof fileName !== "string") {
+                return;
+              }
+              const normalizedPath = normalizeWatchedFilePath(projectRoot, watchRoot, fileName);
+              if (!isDiscoveryRelevantPath(normalizedPath, project)) {
+                return;
+              }
+              rerunPrepare();
+            }));
+          } catch (watchError) {
+            if (!isIgnorableWatchError(watchError)) {
+              throw watchError;
+            }
+          }
+        }
+      };
+      return () => closeAllWatchers();
+    }
+  })();
+  await refreshNonRecursiveWatchers?.();
+  const invocation = await resolvePackageManagerCommand(projectRoot, "holo:dev");
+  while (!shuttingDown) {
+    const child = spawnProcess(invocation.command, [...invocation.args], {
+      cwd: projectRoot,
+      env: process.env,
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    child.stdout?.on("data", (chunk) => io.stdout.write(chunk));
+    child.stderr?.on("data", (chunk) => io.stderr.write(chunk));
+    if (child.stdin) {
+      io.stdin.pipe(child.stdin);
+    }
+    const result = await new Promise((resolvePromise) => {
+      let restartRequested = false;
+      requestChildRestart = () => {
+        if (restartRequested || shuttingDown || typeof child.kill !== "function") {
+          return;
+        }
+        restartRequested = true;
+        child.kill("SIGTERM");
+      };
+      child.on("error", (error) => {
+        if (child.stdin) {
+          io.stdin.unpipe(child.stdin);
+        }
+        requestChildRestart = void 0;
+        if (restartRequested) {
+          resolvePromise({ kind: "restart" });
+          return;
+        }
+        resolvePromise({ kind: "error", error });
+      });
+      child.on("close", (code) => {
+        if (child.stdin) {
+          io.stdin.unpipe(child.stdin);
+        }
+        requestChildRestart = void 0;
+        if (restartRequested) {
+          resolvePromise({ kind: "restart" });
+          return;
+        }
+        resolvePromise({ kind: "close", code });
+      });
+    });
+    if (result.kind === "restart") {
+      continue;
+    }
+    shuttingDown = true;
+    closeWatchers();
+    await Promise.resolve(pendingPrepare);
+    if (result.kind === "error") {
+      throw result.error;
+    }
+    if (result.code === 0) {
+      return;
+    }
+    throw new Error(`Project script "holo:dev" failed with exit code ${result.code ?? "unknown"}.`);
+  }
+}
+
+export {
+  resolveProjectPackageManager,
+  resolvePackageManagerCommand,
+  resolvePackageManagerInstallInvocation,
+  runProjectLifecycleScript,
+  runProjectDependencyInstall,
+  runProjectPrepare,
+  toPosixSlashes,
+  isDiscoveryRelevantPath,
+  isRecursiveWatchUnsupported,
+  isIgnorableWatchError,
+  collectDirectoryTree,
+  collectDiscoveryWatchRoots,
+  normalizeWatchedFilePath,
+  runProjectDevServer
+};

package/dist/chunk-JX2ZH6XY.mjs

@@ -0,0 +1,270 @@
+// src/parsing.ts
+import { createInterface } from "readline/promises";
+var SUPPORTED_NEW_FRAMEWORKS = ["nuxt", "next", "sveltekit"];
+var SUPPORTED_NEW_DATABASE_DRIVERS = ["sqlite", "mysql", "postgres"];
+var SUPPORTED_NEW_PACKAGE_MANAGERS = ["bun", "npm", "pnpm", "yarn"];
+var SUPPORTED_NEW_STORAGE_DISKS = ["local", "public"];
+var SUPPORTED_NEW_OPTIONAL_PACKAGES = ["storage", "events", "queue", "validation", "forms", "auth", "authorization", "notifications", "mail", "broadcast", "security", "cache"];
+var SUPPORTED_INSTALL_TARGETS = ["queue", "events", "auth", "authorization", "notifications", "mail", "broadcast", "security", "cache"];
+var SUPPORTED_QUEUE_INSTALL_DRIVERS = ["sync", "redis", "database"];
+var SUPPORTED_CACHE_INSTALL_DRIVERS = ["file", "redis", "database"];
+function parseTokens(tokens) {
+  const args = [];
+  const flags = {};
+  const isNumericValueToken = (value) => typeof value === "string" && /^-\d+$/.test(value);
+  const assignFlag = (name, value) => {
+    const existing = flags[name];
+    if (typeof existing === "undefined") {
+      flags[name] = value;
+      return;
+    }
+    if (Array.isArray(existing)) {
+      flags[name] = [...existing, String(value)];
+      return;
+    }
+    flags[name] = [String(existing), String(value)];
+  };
+  for (let index = 0; index < tokens.length; index += 1) {
+    const token = tokens[index];
+    if (typeof token === "undefined") {
+      continue;
+    }
+    if (token === "--") {
+      args.push(...tokens.slice(index + 1));
+      break;
+    }
+    if (token.startsWith("--")) {
+      const flag = token.slice(2);
+      const separator = flag.indexOf("=");
+      if (separator >= 0) {
+        assignFlag(flag.slice(0, separator), flag.slice(separator + 1));
+        continue;
+      }
+      const next = tokens[index + 1];
+      if (next && (!next.startsWith("-") || isNumericValueToken(next))) {
+        assignFlag(flag, next);
+        index += 1;
+        continue;
+      }
+      assignFlag(flag, true);
+      continue;
+    }
+    if (token.startsWith("-") && token.length > 1) {
+      const short = token.slice(1);
+      if (short.length > 1) {
+        for (const char of short) {
+          assignFlag(char, true);
+        }
+        continue;
+      }
+      const next = tokens[index + 1];
+      if (next && (!next.startsWith("-") || isNumericValueToken(next))) {
+        assignFlag(short, next);
+        index += 1;
+        continue;
+      }
+      assignFlag(short, true);
+      continue;
+    }
+    args.push(token);
+  }
+  return { args, flags };
+}
+function isInteractive(io, flags) {
+  const disabled = flags["no-interactive"] === true;
+  return io.stdin.isTTY === true && io.stdout.isTTY === true && !disabled;
+}
+async function prompt(io, label) {
+  const rl = createInterface({
+    input: io.stdin,
+    output: io.stdout
+  });
+  try {
+    return (await rl.question(label)).trim();
+  } finally {
+    rl.close();
+  }
+}
+async function confirm(io, label, defaultValue = false) {
+  const suffix = defaultValue ? " [Y/n] " : " [y/N] ";
+  const answer = (await prompt(io, `${label}${suffix}`)).toLowerCase();
+  if (!answer) {
+    return defaultValue;
+  }
+  return answer === "y" || answer === "yes";
+}
+function normalizeChoice(value, allowed, label) {
+  const normalized = value?.trim().toLowerCase();
+  if (normalized && allowed.includes(normalized)) {
+    return normalized;
+  }
+  throw new Error(`Unsupported ${label}: ${value ?? "(empty)"}. Expected one of ${allowed.join(", ")}.`);
+}
+async function promptChoice(io, label, allowed, defaultValue) {
+  const answer = (await prompt(io, `${label} (${allowed.join("/")}) [${defaultValue}]: `)).trim().toLowerCase();
+  if (!answer) {
+    return defaultValue;
+  }
+  return normalizeChoice(answer, allowed, label);
+}
+function normalizeOptionalPackageName(value) {
+  const current = value.trim().toLowerCase();
+  if (current === "validate") {
+    return "validation";
+  }
+  if (current === "form") {
+    return "forms";
+  }
+  return current;
+}
+function normalizeOptionalPackages(value) {
+  if (!value || value.length === 0) {
+    return [];
+  }
+  const normalized = /* @__PURE__ */ new Set();
+  for (const raw of value) {
+    const current = normalizeOptionalPackageName(raw);
+    if (current === "none") {
+      continue;
+    }
+    if (SUPPORTED_NEW_OPTIONAL_PACKAGES.includes(current)) {
+      normalized.add(current);
+      if (current === "forms") {
+        normalized.add("validation");
+      }
+      continue;
+    }
+    throw new Error(
+      `Unsupported optional package: ${raw}. Expected one of ${[...SUPPORTED_NEW_OPTIONAL_PACKAGES, "none"].join(", ")}.`
+    );
+  }
+  return [...normalized].sort((left, right) => left.localeCompare(right));
+}
+async function promptOptionalPackages(io) {
+  const answer = await prompt(io, `Optional packages (${[...SUPPORTED_NEW_OPTIONAL_PACKAGES, "none"].join("/")}): `);
+  return normalizeOptionalPackages(splitCsv(answer) ?? (answer ? [answer] : []));
+}
+async function resolveNewProjectInput(io, input, prompts = {
+  prompt: (label) => prompt(io, label),
+  choose: (label, allowed, defaultValue) => promptChoice(io, label, allowed, defaultValue),
+  optionalPackages: () => promptOptionalPackages(io)
+}) {
+  const flagProjectName = resolveStringFlag(input.flags, "name");
+  const positionalProjectName = input.args[0]?.trim();
+  if (flagProjectName && positionalProjectName && flagProjectName !== positionalProjectName) {
+    throw new Error("Conflicting project names. Use either the positional argument or --name, not both.");
+  }
+  const interactive = isInteractive(io, input.flags);
+  const projectName = (flagProjectName ?? positionalProjectName)?.trim() || (interactive ? await prompts.prompt("Project name: ") : "");
+  if (!projectName) {
+    throw new Error(interactive ? "Project creation cancelled." : "Missing required argument: Project name.");
+  }
+  const framework = resolveStringFlag(input.flags, "framework") ? normalizeChoice(resolveStringFlag(input.flags, "framework"), SUPPORTED_NEW_FRAMEWORKS, "framework") : interactive ? await prompts.choose("Framework", SUPPORTED_NEW_FRAMEWORKS, "nuxt") : "nuxt";
+  const databaseDriver = resolveStringFlag(input.flags, "database") ? normalizeChoice(resolveStringFlag(input.flags, "database"), SUPPORTED_NEW_DATABASE_DRIVERS, "database driver") : interactive ? await prompts.choose("Database driver", SUPPORTED_NEW_DATABASE_DRIVERS, "sqlite") : "sqlite";
+  const packageManager = resolveStringFlag(input.flags, "package-manager") ? normalizeChoice(resolveStringFlag(input.flags, "package-manager"), SUPPORTED_NEW_PACKAGE_MANAGERS, "package manager") : interactive ? await prompts.choose("Package manager", SUPPORTED_NEW_PACKAGE_MANAGERS, "bun") : "bun";
+  const requestedOptionalPackages = collectMultiStringFlag(input.flags, "package");
+  let optionalPackages;
+  if (requestedOptionalPackages) {
+    const normalizedOptionalPackages = [];
+    for (const entry of requestedOptionalPackages) {
+      normalizedOptionalPackages.push(...splitCsv(entry));
+    }
+    optionalPackages = normalizeOptionalPackages(normalizedOptionalPackages);
+  } else if (interactive) {
+    optionalPackages = await prompts.optionalPackages();
+  } else {
+    optionalPackages = [];
+  }
+  const storageDefaultDisk = optionalPackages.includes("storage") ? resolveStringFlag(input.flags, "storage-default-disk") ? normalizeChoice(resolveStringFlag(input.flags, "storage-default-disk"), SUPPORTED_NEW_STORAGE_DISKS, "storage default disk") : interactive ? await prompts.choose("Default storage disk", SUPPORTED_NEW_STORAGE_DISKS, "local") : "local" : "local";
+  return {
+    projectName,
+    framework,
+    databaseDriver,
+    packageManager,
+    storageDefaultDisk,
+    optionalPackages
+  };
+}
+async function ensureRequiredArg(io, input, index, label) {
+  const value = input.args[index]?.trim();
+  if (value) {
+    return value;
+  }
+  if (!isInteractive(io, input.flags)) {
+    throw new Error(`Missing required argument: ${label}.`);
+  }
+  const prompted = await prompt(io, `${label}: `);
+  if (!prompted) {
+    throw new Error(`Missing required argument: ${label}.`);
+  }
+  return prompted;
+}
+function resolveStringFlag(flags, name, alias) {
+  const value = flags[name] ?? (alias ? flags[alias] : void 0);
+  if (Array.isArray(value)) {
+    return value[value.length - 1];
+  }
+  if (typeof value === "string") {
+    return value;
+  }
+  return void 0;
+}
+function collectMultiStringFlag(flags, name, alias) {
+  const value = flags[name] ?? (alias ? flags[alias] : void 0);
+  if (Array.isArray(value)) {
+    return value.map((entry) => entry.trim()).filter(Boolean);
+  }
+  if (typeof value === "string") {
+    const normalized = value.trim();
+    return normalized ? [normalized] : void 0;
+  }
+  return void 0;
+}
+function resolveBooleanFlag(flags, name, alias) {
+  const value = flags[name] ?? (alias ? flags[alias] : void 0);
+  if (Array.isArray(value)) {
+    return value[value.length - 1] === "true";
+  }
+  if (typeof value === "string") {
+    return value === "true";
+  }
+  return value === true;
+}
+function parseNumberFlag(flags, name, alias) {
+  const raw = resolveStringFlag(flags, name, alias);
+  if (typeof raw === "undefined") {
+    return void 0;
+  }
+  if (!/^\d+$/.test(raw)) {
+    throw new Error(`Flag "--${name}" must be a non-negative integer.`);
+  }
+  const parsed = Number.parseInt(raw, 10);
+  if (!Number.isInteger(parsed) || parsed < 0) {
+    throw new Error(`Flag "--${name}" must be a non-negative integer.`);
+  }
+  return parsed;
+}
+function splitCsv(value) {
+  if (!value) {
+    return void 0;
+  }
+  return value.split(",").map((part) => part.trim()).filter(Boolean);
+}
+
+export {
+  SUPPORTED_INSTALL_TARGETS,
+  SUPPORTED_QUEUE_INSTALL_DRIVERS,
+  SUPPORTED_CACHE_INSTALL_DRIVERS,
+  parseTokens,
+  isInteractive,
+  confirm,
+  normalizeChoice,
+  normalizeOptionalPackages,
+  resolveNewProjectInput,
+  ensureRequiredArg,
+  resolveStringFlag,
+  collectMultiStringFlag,
+  resolveBooleanFlag,
+  parseNumberFlag,
+  splitCsv
+};

package/dist/chunk-M7J3YTHR.mjs

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import {
+  readTextFile
+} from "./chunk-66FHW725.mjs";
+
+// src/fs-utils.ts
+import { stat } from "fs/promises";
+async function fileExists(path) {
+  try {
+    await stat(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function ensureAbsent(path) {
+  const existing = await readTextFile(path);
+  if (typeof existing !== "undefined") {
+    throw new TypeError(`Refusing to overwrite existing file: ${path}`);
+  }
+}
+
+export {
+  fileExists,
+  ensureAbsent
+};