create-warlock 4.0.171 → 4.1.1

package/esm/commands/create-new-app/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../../@warlock.js/create-warlock/src/commands/create-new-app/index.ts"],"sourcesContent":["import {\r\n  cancel,\r\n  confirm,\r\n  isCancel,\r\n  multiselect,\r\n  select,\r\n  text,\r\n} from \"@clack/prompts\";\r\nimport { colors } from \"@mongez/copper\";\r\nimport { getJsonFile } from \"@warlock.js/fs\";\r\nimport {\r\n  getDatabaseDriver,\r\n  getDatabaseDriverOptions,\r\n} from \"../../features/database-drivers\";\r\nimport {\r\n  getAiProviderOptions,\r\n  getAllFeatureKeys,\r\n  getDefaultFeatureKeys,\r\n  getFeatureOptions,\r\n} from \"../../features/features-map\";\r\nimport { App } from \"../../helpers/app\";\r\nimport {\r\n  detectPackageManagers,\r\n  getPackageManager,\r\n  getPreferredPackageManager,\r\n  getSystemPackageManagers,\r\n  setPackageManager,\r\n} from \"../../helpers/package-manager\";\r\nimport { packageRoot } from \"../../helpers/paths\";\r\nimport { showIntroBanner } from \"../../ui/banner\";\r\nimport { createWarlockApp } from \"../create-warlock-app\";\r\nimport getAppPath from \"./get-app-path\";\r\nimport { App as AppType, CliFlags } from \"./types\";\r\n\r\nexport default async function createNewApp(cli: CliFlags = {}) {\r\n  // Start detecting package managers in the background to avoid delay later\r\n  const pmDetectionPromise = detectPackageManagers();\r\n\r\n  // Get version from package.json\r\n  const packageJson: any = getJsonFile(packageRoot(\"package.json\"));\r\n  const createWarlockVersion = packageJson.version;\r\n\r\n  // Show the intro banner\r\n  showIntroBanner(createWarlockVersion);\r\n\r\n  console.log(colors.cyan(\"✨ Let's create something magical! ✨\\n\"));\r\n\r\n  // Validate Node.js version (minimum v20)\r\n  const [major] = process.versions.node.split(\".\").map(Number);\r\n  if (major < 20) {\r\n    cancel(\"Node.js version must be at least 20.0.0\");\r\n    process.exit(0);\r\n  }\r\n\r\n  // Non-interactive path: build everything from flags and skip the prompts.\r\n  if (cli.yes) {\r\n    await createNonInteractive(cli);\r\n    return;\r\n  }\r\n\r\n  // Step 1: Project name\r\n  const appName = await text({\r\n    message: \"What shall we call your project?\",\r\n    placeholder: \"my-warlock-app\",\r\n  });\r\n\r\n  if (isCancel(appName) || !appName.trim()) {\r\n    cancel(\"A project name is required to continue\");\r\n    process.exit(0);\r\n  }\r\n\r\n  const appPath = getAppPath(appName);\r\n  if (!appPath) return;\r\n\r\n  // Step 2: Package Manager selection\r\n  await pmDetectionPromise; // Ensure detection is complete\r\n\r\n  const packageManager = await select({\r\n    message: \"Which package manager do you want to use?\",\r\n    options: getSystemPackageManagers().map(pm => ({\r\n      value: pm,\r\n      label: pm,\r\n    })),\r\n    initialValue: getPreferredPackageManager(),\r\n  });\r\n\r\n  if (isCancel(packageManager)) {\r\n    cancel(\"Package manager selection cancelled\");\r\n    process.exit(0);\r\n  }\r\n\r\n  setPackageManager(packageManager as string);\r\n\r\n  // Step 3: Database driver selection\r\n  const databaseDriver = await select({\r\n    message: \"Choose your database driver 🗄️\",\r\n    options: getDatabaseDriverOptions(),\r\n  });\r\n\r\n  if (isCancel(databaseDriver)) {\r\n    cancel(\"Database selection cancelled\");\r\n    process.exit(0);\r\n  }\r\n\r\n  const selectedDriver = getDatabaseDriver(databaseDriver as string);\r\n\r\n  // Step 4: Features selection\r\n  const selectedFeatures = await multiselect({\r\n    message: \"Select optional features to include ✨\",\r\n    options: getFeatureOptions(),\r\n    initialValues: getDefaultFeatureKeys(),\r\n    required: false,\r\n  });\r\n\r\n  if (isCancel(selectedFeatures)) {\r\n    cancel(\"Feature selection cancelled\");\r\n    process.exit(0);\r\n  }\r\n\r\n  // Step 4b: AI providers — selecting any pulls @warlock.js/ai automatically\r\n  const selectedAiProviders = await multiselect({\r\n    message: \"Add AI providers? The core AI package is included automatically 🤖\",\r\n    options: getAiProviderOptions(),\r\n    required: false,\r\n  });\r\n\r\n  if (isCancel(selectedAiProviders)) {\r\n    cancel(\"AI provider selection cancelled\");\r\n    process.exit(0);\r\n  }\r\n\r\n  // Step 5: Git initialization\r\n  const useGit =\r\n    (await confirm({\r\n      message: \"Initialize a Git repository? 📂\",\r\n    })) === true;\r\n\r\n  if (isCancel(useGit)) {\r\n    cancel(\"Setup cancelled\");\r\n    process.exit(0);\r\n  }\r\n\r\n  // Step 6: JWT secret generation\r\n  const useJWT =\r\n    (await confirm({\r\n      message: \"Generate JWT secret keys? 🔐\",\r\n    })) === true;\r\n\r\n  if (isCancel(useJWT)) {\r\n    cancel(\"Setup cancelled\");\r\n    process.exit(0);\r\n  }\r\n\r\n  // Build app details\r\n  const appDetails: Required<AppType> = {\r\n    appName: appName,\r\n    appType: \"warlock\",\r\n    appPath: appPath,\r\n    pkgManager: getPackageManager(),\r\n    options: {\r\n      databaseDriver: databaseDriver as string,\r\n      databasePort: selectedDriver?.defaultPort || 27017,\r\n      features: selectedFeatures as string[],\r\n      aiProviders: selectedAiProviders as string[],\r\n      useGit,\r\n      useJWT,\r\n    },\r\n  };\r\n\r\n  // Create the app\r\n  await createWarlockApp(new App(appDetails));\r\n}\r\n\r\n/**\r\n * Non-interactive scaffold path for `--yes`. Builds the app from flags with\r\n * sensible defaults and skips every prompt. Validates the database driver and\r\n * feature/provider keys up front so a typo fails fast instead of mid-install.\r\n */\r\nasync function createNonInteractive(cli: CliFlags) {\r\n  const appName = (cli.name ?? \"\").trim();\r\n\r\n  if (!appName) {\r\n    cancel(\"--yes requires a project name (first argument or --name=<name>)\");\r\n    process.exit(1);\r\n  }\r\n\r\n  const appPath = getAppPath(appName);\r\n\r\n  if (!appPath) return;\r\n\r\n  await detectPackageManagers();\r\n\r\n  const packageManager = cli.pm ?? getPreferredPackageManager();\r\n  setPackageManager(packageManager);\r\n\r\n  const databaseDriver = cli.db ?? \"mongodb\";\r\n  const driver = getDatabaseDriver(databaseDriver);\r\n\r\n  if (!driver) {\r\n    cancel(`Unknown database driver \"${databaseDriver}\"`);\r\n    process.exit(1);\r\n  }\r\n\r\n  const features = cli.features ?? [];\r\n  const aiProviders = cli.ai ?? [];\r\n\r\n  const allowedKeys = getAllFeatureKeys();\r\n  const invalidKeys = [...features, ...aiProviders].filter(key => !allowedKeys.includes(key));\r\n\r\n  if (invalidKeys.length > 0) {\r\n    cancel(`Unknown feature(s): ${invalidKeys.join(\", \")}`);\r\n    process.exit(1);\r\n  }\r\n\r\n  const appDetails: Required<AppType> = {\r\n    appName,\r\n    appType: \"warlock\",\r\n    appPath,\r\n    pkgManager: getPackageManager(),\r\n    options: {\r\n      databaseDriver,\r\n      databasePort: driver.defaultPort,\r\n      features,\r\n      aiProviders,\r\n      useGit: cli.git ?? false,\r\n      useJWT: cli.jwt ?? false,\r\n    },\r\n  };\r\n\r\n  await createWarlockApp(new App(appDetails));\r\n}\r\n"],"mappings":"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"}

package/esm/commands/create-new-app/types.d.mts

@@ -0,0 +1,18 @@
+//#region ../../@warlock.js/create-warlock/src/commands/create-new-app/types.d.ts
+/**
+ * Flags parsed from the command line for non-interactive scaffolding
+ * (`create-warlock my-app --db=postgres --features=test,herald --ai=openai --yes`).
+ */
+type CliFlags = {
+  yes?: boolean;
+  name?: string;
+  db?: string;
+  features?: string[];
+  ai?: string[];
+  pm?: string;
+  git?: boolean;
+  jwt?: boolean;
+};
+//#endregion
+export { CliFlags };
+//# sourceMappingURL=types.d.mts.map

package/esm/commands/create-warlock-app/index.mjs

@@ -0,0 +1,57 @@
+import { getPackageManager, runPackageManagerCommand } from "../../helpers/package-manager.mjs";
+import { showSuccessScreen } from "../../ui/banner.mjs";
+import { spinnerMessages } from "../../ui/spinners.mjs";
+import { spinner } from "@clack/prompts";
+
+//#region ../../@warlock.js/create-warlock/src/commands/create-warlock-app/index.ts
+async function createWarlockApp(application) {
+	const { useGit, useJWT, features, aiProviders, databaseDriver } = application.options;
+	const templateSpinner = spinner();
+	templateSpinner.start(spinnerMessages.copyingTemplate);
+	application.init().use("warlock").updatePackageJson().updateDotEnv().configureDatabaseEnv(databaseDriver);
+	templateSpinner.stop(spinnerMessages.templateCopied);
+	const installSpinner = spinner();
+	installSpinner.start(spinnerMessages.installingDeps);
+	await application.install().install;
+	installSpinner.stop(spinnerMessages.depsInstalled);
+	const selectedFeatures = [
+		databaseDriver,
+		...features,
+		...aiProviders
+	];
+	if (selectedFeatures.length > 0) {
+		const featuresSpinner = spinner();
+		featuresSpinner.start(spinnerMessages.addingFeatures);
+		if (await application.installFeatures(selectedFeatures)) {
+			await application.install().install;
+			featuresSpinner.stop(spinnerMessages.featuresAdded);
+		} else featuresSpinner.stop(spinnerMessages.featuresFailed);
+	}
+	if (useGit) {
+		const gitSpinner = spinner();
+		gitSpinner.start(spinnerMessages.initializingGit);
+		await application.git();
+		gitSpinner.stop(spinnerMessages.gitInitialized);
+	}
+	if (useJWT) {
+		const jwtSpinner = spinner();
+		jwtSpinner.start(spinnerMessages.generatingJwt);
+		await application.exec(runPackageManagerCommand("jwt"));
+		jwtSpinner.stop(spinnerMessages.jwtGenerated);
+	} else {
+		const warmSpinner = spinner();
+		warmSpinner.start(spinnerMessages.warmingCache);
+		await application.exec("npx warlock --warm-cache");
+		warmSpinner.stop(spinnerMessages.cacheWarmed);
+	}
+	showSuccessScreen({
+		projectName: application.name,
+		database: databaseDriver === "mongodb" ? "MongoDB" : "PostgreSQL",
+		features: [...features, ...aiProviders],
+		packageManager: getPackageManager()
+	});
+}
+
+//#endregion
+export { createWarlockApp };
+//# sourceMappingURL=index.mjs.map

package/esm/commands/create-warlock-app/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../../@warlock.js/create-warlock/src/commands/create-warlock-app/index.ts"],"sourcesContent":["import { spinner } from \"@clack/prompts\";\r\nimport { App } from \"../../helpers/app\";\r\nimport {\r\n  getPackageManager,\r\n  runPackageManagerCommand,\r\n} from \"../../helpers/package-manager\";\r\nimport { showSuccessScreen } from \"../../ui/banner\";\r\nimport { spinnerMessages } from \"../../ui/spinners\";\r\n\r\nexport async function createWarlockApp(application: App) {\r\n  const options = application.options;\r\n  const { useGit, useJWT, features, aiProviders, databaseDriver } = options;\r\n\r\n  // Step 1: Initialize and copy template\r\n  const templateSpinner = spinner();\r\n  templateSpinner.start(spinnerMessages.copyingTemplate);\r\n\r\n  application\r\n    .init()\r\n    .use(\"warlock\")\r\n    .updatePackageJson()\r\n    .updateDotEnv()\r\n    .configureDatabaseEnv(databaseDriver);\r\n\r\n  templateSpinner.stop(spinnerMessages.templateCopied);\r\n\r\n  // Step 2: Install base dependencies (so the `warlock` binary is available)\r\n  const installSpinner = spinner();\r\n  installSpinner.start(spinnerMessages.installingDeps);\r\n\r\n  await application.install().install;\r\n\r\n  installSpinner.stop(spinnerMessages.depsInstalled);\r\n\r\n  // Step 3: Add features via `warlock add --no-install`, then one batched install.\r\n  // The DB driver, optional features, and AI providers all go through the single\r\n  // source of truth (core's feature map) so versions never drift.\r\n  const selectedFeatures = [databaseDriver, ...features, ...aiProviders];\r\n\r\n  if (selectedFeatures.length > 0) {\r\n    const featuresSpinner = spinner();\r\n    featuresSpinner.start(spinnerMessages.addingFeatures);\r\n\r\n    const added = await application.installFeatures(selectedFeatures);\r\n\r\n    if (added) {\r\n      await application.install().install;\r\n      featuresSpinner.stop(spinnerMessages.featuresAdded);\r\n    } else {\r\n      featuresSpinner.stop(spinnerMessages.featuresFailed);\r\n    }\r\n  }\r\n\r\n  // Step 4: Initialize Git repository if requested\r\n  if (useGit) {\r\n    const gitSpinner = spinner();\r\n    gitSpinner.start(spinnerMessages.initializingGit);\r\n\r\n    await application.git();\r\n\r\n    gitSpinner.stop(spinnerMessages.gitInitialized);\r\n  }\r\n\r\n  // Step 5: Generate JWT or warm cache\r\n  if (useJWT) {\r\n    const jwtSpinner = spinner();\r\n    jwtSpinner.start(spinnerMessages.generatingJwt);\r\n\r\n    await application.exec(runPackageManagerCommand(\"jwt\"));\r\n\r\n    jwtSpinner.stop(spinnerMessages.jwtGenerated);\r\n  } else {\r\n    const warmSpinner = spinner();\r\n    warmSpinner.start(spinnerMessages.warmingCache);\r\n\r\n    await application.exec(\"npx warlock --warm-cache\");\r\n\r\n    warmSpinner.stop(spinnerMessages.cacheWarmed);\r\n  }\r\n\r\n  // Step 6: Show success screen\r\n  showSuccessScreen({\r\n    projectName: application.name,\r\n    database: databaseDriver === \"mongodb\" ? \"MongoDB\" : \"PostgreSQL\",\r\n    features: [...features, ...aiProviders],\r\n    packageManager: getPackageManager(),\r\n  });\r\n}\r\n"],"mappings":";;;;;;AASA,eAAsB,iBAAiB,aAAkB;CAEvD,MAAM,EAAE,QAAQ,QAAQ,UAAU,aAAa,mBAD/B,YAAY;CAI5B,MAAM,kBAAkB,QAAQ;CAChC,gBAAgB,MAAM,gBAAgB,eAAe;CAErD,YACG,KAAK,EACL,IAAI,SAAS,EACb,kBAAkB,EAClB,aAAa,EACb,qBAAqB,cAAc;CAEtC,gBAAgB,KAAK,gBAAgB,cAAc;CAGnD,MAAM,iBAAiB,QAAQ;CAC/B,eAAe,MAAM,gBAAgB,cAAc;CAEnD,MAAM,YAAY,QAAQ,EAAE;CAE5B,eAAe,KAAK,gBAAgB,aAAa;CAKjD,MAAM,mBAAmB;EAAC;EAAgB,GAAG;EAAU,GAAG;CAAW;CAErE,IAAI,iBAAiB,SAAS,GAAG;EAC/B,MAAM,kBAAkB,QAAQ;EAChC,gBAAgB,MAAM,gBAAgB,cAAc;EAIpD,IAAI,MAFgB,YAAY,gBAAgB,gBAAgB,GAErD;GACT,MAAM,YAAY,QAAQ,EAAE;GAC5B,gBAAgB,KAAK,gBAAgB,aAAa;EACpD,OACE,gBAAgB,KAAK,gBAAgB,cAAc;CAEvD;CAGA,IAAI,QAAQ;EACV,MAAM,aAAa,QAAQ;EAC3B,WAAW,MAAM,gBAAgB,eAAe;EAEhD,MAAM,YAAY,IAAI;EAEtB,WAAW,KAAK,gBAAgB,cAAc;CAChD;CAGA,IAAI,QAAQ;EACV,MAAM,aAAa,QAAQ;EAC3B,WAAW,MAAM,gBAAgB,aAAa;EAE9C,MAAM,YAAY,KAAK,yBAAyB,KAAK,CAAC;EAEtD,WAAW,KAAK,gBAAgB,YAAY;CAC9C,OAAO;EACL,MAAM,cAAc,QAAQ;EAC5B,YAAY,MAAM,gBAAgB,YAAY;EAE9C,MAAM,YAAY,KAAK,0BAA0B;EAEjD,YAAY,KAAK,gBAAgB,WAAW;CAC9C;CAGA,kBAAkB;EAChB,aAAa,YAAY;EACzB,UAAU,mBAAmB,YAAY,YAAY;EACrD,UAAU,CAAC,GAAG,UAAU,GAAG,WAAW;EACtC,gBAAgB,kBAAkB;CACpC,CAAC;AACH"}

package/esm/features/database-drivers.mjs

@@ -0,0 +1,47 @@
+//#region ../../@warlock.js/create-warlock/src/features/database-drivers.ts
+const databaseDrivers = [
+	{
+		value: "mongodb",
+		label: "MongoDB",
+		package: "mongodb",
+		packageVersion: "^7.0.0",
+		defaultPort: 27017
+	},
+	{
+		value: "postgres",
+		label: "PostgreSQL",
+		package: "pg",
+		packageVersion: "^8.11.0",
+		defaultPort: 5432
+	},
+	{
+		value: "mysql",
+		label: "MySQL (Coming Soon)",
+		package: "mysql2",
+		packageVersion: "^3.5.0",
+		defaultPort: 3306,
+		disabled: true,
+		hint: "MySQL support coming in a future release"
+	}
+];
+/**
+* Get database driver options for the select prompt
+*/
+function getDatabaseDriverOptions() {
+	return databaseDrivers.map((driver) => ({
+		value: driver.value,
+		label: driver.label,
+		hint: driver.hint,
+		disabled: driver.disabled
+	}));
+}
+/**
+* Get database driver config by value
+*/
+function getDatabaseDriver(value) {
+	return databaseDrivers.find((driver) => driver.value === value);
+}
+
+//#endregion
+export { getDatabaseDriver, getDatabaseDriverOptions };
+//# sourceMappingURL=database-drivers.mjs.map

package/esm/features/database-drivers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-drivers.mjs","names":[],"sources":["../../../../../../@warlock.js/create-warlock/src/features/database-drivers.ts"],"sourcesContent":["/**\n * Database driver options and configuration\n */\nexport type DatabaseDriver = {\n  value: string;\n  label: string;\n  package: string;\n  packageVersion: string;\n  defaultPort: number;\n  disabled?: boolean;\n  hint?: string;\n};\n\nexport const databaseDrivers: DatabaseDriver[] = [\n  {\n    value: \"mongodb\",\n    label: \"MongoDB\",\n    package: \"mongodb\",\n    packageVersion: \"^7.0.0\",\n    defaultPort: 27017,\n  },\n  {\n    value: \"postgres\",\n    label: \"PostgreSQL\",\n    package: \"pg\",\n    packageVersion: \"^8.11.0\",\n    defaultPort: 5432,\n  },\n  {\n    value: \"mysql\",\n    label: \"MySQL (Coming Soon)\",\n    package: \"mysql2\",\n    packageVersion: \"^3.5.0\",\n    defaultPort: 3306,\n    disabled: true,\n    hint: \"MySQL support coming in a future release\",\n  },\n];\n\n/**\n * Get database driver options for the select prompt\n */\nexport function getDatabaseDriverOptions() {\n  return databaseDrivers.map(driver => ({\n    value: driver.value,\n    label: driver.label,\n    hint: driver.hint,\n    disabled: driver.disabled,\n  }));\n}\n\n/**\n * Get database driver config by value\n */\nexport function getDatabaseDriver(value: string): DatabaseDriver | undefined {\n  return databaseDrivers.find(driver => driver.value === value);\n}\n\n/**\n * Get database driver dependency\n */\nexport function getDatabaseDependency(\n  driverValue: string,\n): Record<string, string> {\n  const driver = getDatabaseDriver(driverValue);\n  if (!driver) return {};\n\n  return {\n    [driver.package]: driver.packageVersion,\n  };\n}\n"],"mappings":";AAaA,MAAa,kBAAoC;CAC/C;EACE,OAAO;EACP,OAAO;EACP,SAAS;EACT,gBAAgB;EAChB,aAAa;CACf;CACA;EACE,OAAO;EACP,OAAO;EACP,SAAS;EACT,gBAAgB;EAChB,aAAa;CACf;CACA;EACE,OAAO;EACP,OAAO;EACP,SAAS;EACT,gBAAgB;EAChB,aAAa;EACb,UAAU;EACV,MAAM;CACR;AACF;;;;AAKA,SAAgB,2BAA2B;CACzC,OAAO,gBAAgB,KAAI,YAAW;EACpC,OAAO,OAAO;EACd,OAAO,OAAO;EACd,MAAM,OAAO;EACb,UAAU,OAAO;CACnB,EAAE;AACJ;;;;AAKA,SAAgB,kBAAkB,OAA2C;CAC3E,OAAO,gBAAgB,MAAK,WAAU,OAAO,UAAU,KAAK;AAC9D"}

package/esm/features/features-map.mjs

@@ -0,0 +1,157 @@
+//#region ../../@warlock.js/create-warlock/src/features/features-map.ts
+/**
+* Optional features offered in the general multiselect step. The database
+* driver (its own select) and AI providers (their own step) are intentionally
+* NOT here — they have dedicated prompts.
+*/
+const features = [
+	{
+		key: "react",
+		label: "React (rendering & mails)",
+		hint: "React + ReactDOM for non-interactive rendering and HTML/email generation",
+		group: "Rendering & Mail",
+		defaultSelected: true
+	},
+	{
+		key: "react-email",
+		label: "React Email",
+		hint: "Build email templates with React + Tailwind (pulls react + mail)",
+		group: "Rendering & Mail"
+	},
+	{
+		key: "mail",
+		label: "Mail (Nodemailer)",
+		hint: "Send emails via SMTP",
+		group: "Rendering & Mail"
+	},
+	{
+		key: "ses",
+		label: "Amazon SES",
+		hint: "Send emails via the AWS SES API",
+		group: "Rendering & Mail"
+	},
+	{
+		key: "image",
+		label: "Image processing (Sharp)",
+		hint: "Resize, convert, and optimize images",
+		group: "Media"
+	},
+	{
+		key: "s3",
+		label: "S3 storage",
+		hint: "AWS S3 for cloud file storage",
+		group: "Storage & Cache"
+	},
+	{
+		key: "redis",
+		label: "Redis cache",
+		hint: "Redis driver for the cache layer",
+		group: "Storage & Cache"
+	},
+	{
+		key: "scheduler",
+		label: "Scheduler",
+		hint: "Background tasks and cron jobs",
+		group: "Jobs & Messaging"
+	},
+	{
+		key: "herald",
+		label: "Herald (RabbitMQ)",
+		hint: "Message broker for event-driven architecture",
+		group: "Jobs & Messaging"
+	},
+	{
+		key: "socket",
+		label: "Socket.IO",
+		hint: "Realtime websocket server",
+		group: "Realtime"
+	},
+	{
+		key: "swagger",
+		label: "Swagger",
+		hint: "OpenAPI documentation for your routes",
+		group: "API Docs"
+	},
+	{
+		key: "postman",
+		label: "Postman",
+		hint: "Generate a Postman collection for your API",
+		group: "API Docs"
+	},
+	{
+		key: "test",
+		label: "Testing (Vitest)",
+		hint: "Vitest + coverage + per-worker DB/cache test setup",
+		group: "Tooling"
+	}
+];
+/**
+* AI providers offered in the dedicated AI step. Selecting any of these pulls
+* the core `@warlock.js/ai` package automatically via the provider's `requires`
+* in core's feature map — the scaffolder never lists `ai` as a standalone pick.
+*/
+const aiProviders = [
+	{
+		key: "openai",
+		label: "OpenAI",
+		hint: "GPT models via the OpenAI API"
+	},
+	{
+		key: "google",
+		label: "Google (Gemini)",
+		hint: "Gemini models via Google AI"
+	},
+	{
+		key: "anthropic",
+		label: "Anthropic (Claude)",
+		hint: "Claude models via the Anthropic API"
+	},
+	{
+		key: "bedrock",
+		label: "AWS Bedrock",
+		hint: "Foundation models via Amazon Bedrock"
+	},
+	{
+		key: "ollama",
+		label: "Ollama",
+		hint: "Local models via Ollama"
+	}
+];
+/**
+* Feature options for the multiselect prompt, ordered by group with the group
+* surfaced in the hint (keeps a flat list scannable without group widgets).
+*/
+function getFeatureOptions() {
+	return features.map((feature) => ({
+		value: feature.key,
+		label: feature.label,
+		hint: `${feature.group} — ${feature.hint}`
+	}));
+}
+/**
+* Keys pre-checked in the feature multiselect.
+*/
+function getDefaultFeatureKeys() {
+	return features.filter((feature) => feature.defaultSelected).map((feature) => feature.key);
+}
+/**
+* AI provider options for the dedicated AI multiselect step.
+*/
+function getAiProviderOptions() {
+	return aiProviders.map((provider) => ({
+		value: provider.key,
+		label: provider.label,
+		hint: provider.hint
+	}));
+}
+/**
+* Every selectable key the scaffolder knows about (features + AI providers).
+* Used to validate `--features` / `--ai` flags in non-interactive mode.
+*/
+function getAllFeatureKeys() {
+	return [...features.map((feature) => feature.key), ...aiProviders.map((provider) => provider.key)];
+}
+
+//#endregion
+export { getAiProviderOptions, getAllFeatureKeys, getDefaultFeatureKeys, getFeatureOptions };
+//# sourceMappingURL=features-map.mjs.map

package/esm/features/features-map.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"features-map.mjs","names":[],"sources":["../../../../../../@warlock.js/create-warlock/src/features/features-map.ts"],"sourcesContent":["/**\n * Presentation manifest for the scaffolder's feature prompts.\n *\n * This file is **display metadata only** — keys, labels, hints, grouping, and\n * default selections. It deliberately holds NO dependency names or versions:\n * the single source of truth for what each feature installs is the `add`\n * command's feature map in `@warlock.js/core`\n * (`src/generations/add-command.action.ts`). The scaffolder collects the\n * selections here and delegates the actual install to `warlock add`, so the\n * two never drift on versions again.\n *\n * Every `key` below MUST exist in core's `allowedFeatures`; a CI guard should\n * assert that subset relationship so a typo fails the build instead of shipping.\n */\n\nexport type FeatureGroup =\n  | \"Rendering & Mail\"\n  | \"Media\"\n  | \"Storage & Cache\"\n  | \"Jobs & Messaging\"\n  | \"Realtime\"\n  | \"API Docs\"\n  | \"Tooling\";\n\nexport type FeatureOption = {\n  /** Must match a key in core's `add` feature map. */\n  key: string;\n  label: string;\n  hint: string;\n  group: FeatureGroup;\n  defaultSelected?: boolean;\n};\n\n/**\n * Optional features offered in the general multiselect step. The database\n * driver (its own select) and AI providers (their own step) are intentionally\n * NOT here — they have dedicated prompts.\n */\nexport const features: FeatureOption[] = [\n  // Rendering & Mail\n  {\n    key: \"react\",\n    label: \"React (rendering & mails)\",\n    hint: \"React + ReactDOM for non-interactive rendering and HTML/email generation\",\n    group: \"Rendering & Mail\",\n    defaultSelected: true,\n  },\n  {\n    key: \"react-email\",\n    label: \"React Email\",\n    hint: \"Build email templates with React + Tailwind (pulls react + mail)\",\n    group: \"Rendering & Mail\",\n  },\n  {\n    key: \"mail\",\n    label: \"Mail (Nodemailer)\",\n    hint: \"Send emails via SMTP\",\n    group: \"Rendering & Mail\",\n  },\n  {\n    key: \"ses\",\n    label: \"Amazon SES\",\n    hint: \"Send emails via the AWS SES API\",\n    group: \"Rendering & Mail\",\n  },\n\n  // Media\n  {\n    key: \"image\",\n    label: \"Image processing (Sharp)\",\n    hint: \"Resize, convert, and optimize images\",\n    group: \"Media\",\n  },\n\n  // Storage & Cache\n  {\n    key: \"s3\",\n    label: \"S3 storage\",\n    hint: \"AWS S3 for cloud file storage\",\n    group: \"Storage & Cache\",\n  },\n  {\n    key: \"redis\",\n    label: \"Redis cache\",\n    hint: \"Redis driver for the cache layer\",\n    group: \"Storage & Cache\",\n  },\n\n  // Jobs & Messaging\n  {\n    key: \"scheduler\",\n    label: \"Scheduler\",\n    hint: \"Background tasks and cron jobs\",\n    group: \"Jobs & Messaging\",\n  },\n  {\n    key: \"herald\",\n    label: \"Herald (RabbitMQ)\",\n    hint: \"Message broker for event-driven architecture\",\n    group: \"Jobs & Messaging\",\n  },\n\n  // Realtime\n  {\n    key: \"socket\",\n    label: \"Socket.IO\",\n    hint: \"Realtime websocket server\",\n    group: \"Realtime\",\n  },\n\n  // API Docs\n  {\n    key: \"swagger\",\n    label: \"Swagger\",\n    hint: \"OpenAPI documentation for your routes\",\n    group: \"API Docs\",\n  },\n  {\n    key: \"postman\",\n    label: \"Postman\",\n    hint: \"Generate a Postman collection for your API\",\n    group: \"API Docs\",\n  },\n\n  // Tooling\n  {\n    key: \"test\",\n    label: \"Testing (Vitest)\",\n    hint: \"Vitest + coverage + per-worker DB/cache test setup\",\n    group: \"Tooling\",\n  },\n];\n\nexport type AiProviderOption = {\n  /** Must match a provider key in core's `add` feature map. */\n  key: string;\n  label: string;\n  hint: string;\n};\n\n/**\n * AI providers offered in the dedicated AI step. Selecting any of these pulls\n * the core `@warlock.js/ai` package automatically via the provider's `requires`\n * in core's feature map — the scaffolder never lists `ai` as a standalone pick.\n */\nexport const aiProviders: AiProviderOption[] = [\n  { key: \"openai\", label: \"OpenAI\", hint: \"GPT models via the OpenAI API\" },\n  { key: \"google\", label: \"Google (Gemini)\", hint: \"Gemini models via Google AI\" },\n  { key: \"anthropic\", label: \"Anthropic (Claude)\", hint: \"Claude models via the Anthropic API\" },\n  { key: \"bedrock\", label: \"AWS Bedrock\", hint: \"Foundation models via Amazon Bedrock\" },\n  { key: \"ollama\", label: \"Ollama\", hint: \"Local models via Ollama\" },\n];\n\n/**\n * Feature options for the multiselect prompt, ordered by group with the group\n * surfaced in the hint (keeps a flat list scannable without group widgets).\n */\nexport function getFeatureOptions() {\n  return features.map(feature => ({\n    value: feature.key,\n    label: feature.label,\n    hint: `${feature.group} — ${feature.hint}`,\n  }));\n}\n\n/**\n * Keys pre-checked in the feature multiselect.\n */\nexport function getDefaultFeatureKeys(): string[] {\n  return features.filter(feature => feature.defaultSelected).map(feature => feature.key);\n}\n\n/**\n * AI provider options for the dedicated AI multiselect step.\n */\nexport function getAiProviderOptions() {\n  return aiProviders.map(provider => ({\n    value: provider.key,\n    label: provider.label,\n    hint: provider.hint,\n  }));\n}\n\n/**\n * Every selectable key the scaffolder knows about (features + AI providers).\n * Used to validate `--features` / `--ai` flags in non-interactive mode.\n */\nexport function getAllFeatureKeys(): string[] {\n  return [...features.map(feature => feature.key), ...aiProviders.map(provider => provider.key)];\n}\n"],"mappings":";;;;;;AAsCA,MAAa,WAA4B;CAEvC;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;EACP,iBAAiB;CACnB;CACA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;CACT;CACA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;CACT;CACA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;CACT;CAGA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;CACT;CAGA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;CACT;CACA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;CACT;CAGA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;CACT;CACA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;CACT;CAGA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;CACT;CAGA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;CACT;CACA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;CACT;CAGA;EACE,KAAK;EACL,OAAO;EACP,MAAM;EACN,OAAO;CACT;AACF;;;;;;AAcA,MAAa,cAAkC;CAC7C;EAAE,KAAK;EAAU,OAAO;EAAU,MAAM;CAAgC;CACxE;EAAE,KAAK;EAAU,OAAO;EAAmB,MAAM;CAA8B;CAC/E;EAAE,KAAK;EAAa,OAAO;EAAsB,MAAM;CAAsC;CAC7F;EAAE,KAAK;EAAW,OAAO;EAAe,MAAM;CAAuC;CACrF;EAAE,KAAK;EAAU,OAAO;EAAU,MAAM;CAA0B;AACpE;;;;;AAMA,SAAgB,oBAAoB;CAClC,OAAO,SAAS,KAAI,aAAY;EAC9B,OAAO,QAAQ;EACf,OAAO,QAAQ;EACf,MAAM,GAAG,QAAQ,MAAM,KAAK,QAAQ;CACtC,EAAE;AACJ;;;;AAKA,SAAgB,wBAAkC;CAChD,OAAO,SAAS,QAAO,YAAW,QAAQ,eAAe,EAAE,KAAI,YAAW,QAAQ,GAAG;AACvF;;;;AAKA,SAAgB,uBAAuB;CACrC,OAAO,YAAY,KAAI,cAAa;EAClC,OAAO,SAAS;EAChB,OAAO,SAAS;EAChB,MAAM,SAAS;CACjB,EAAE;AACJ;;;;;AAMA,SAAgB,oBAA8B;CAC5C,OAAO,CAAC,GAAG,SAAS,KAAI,YAAW,QAAQ,GAAG,GAAG,GAAG,YAAY,KAAI,aAAY,SAAS,GAAG,CAAC;AAC/F"}

package/esm/helpers/app.mjs

@@ -0,0 +1,157 @@
+import { getDatabaseDriver } from "../features/database-drivers.mjs";
+import { executeCommand, runCommand } from "./exec.mjs";
+import { getPackageManager } from "./package-manager.mjs";
+import { template } from "./paths.mjs";
+import { copyDirectory, copyFile, fileExists, getFile, getJsonFile, putFile, putJsonFile, renameFile } from "@warlock.js/fs";
+import path from "path";
+
+//#region ../../@warlock.js/create-warlock/src/helpers/app.ts
+var App = class {
+	constructor(app) {
+		this.app = app;
+		this.files = {};
+		this.jsonFiles = {};
+		this.isInstalled = false;
+	}
+	get options() {
+		return this.app.options;
+	}
+	use(templateName) {
+		copyDirectory(template(templateName), this.path);
+		if (fileExists(this.path + "/.env.example")) copyFile(this.path + "/.env.example", this.path + "/.env");
+		renameFile(this.path + "/_.gitignore", this.path + "/.gitignore");
+		return this;
+	}
+	init() {
+		return this;
+	}
+	terminate() {}
+	install() {
+		return runCommand(getPackageManager(), ["install"], this.path);
+	}
+	async exec(command) {
+		const [commandName, ...optionsList] = command.split(" ");
+		return await executeCommand(commandName, optionsList, this.path);
+	}
+	async git() {
+		const { initializeGitRepository } = await import("./project-builder-helpers.mjs");
+		return await initializeGitRepository(this.path);
+	}
+	updatePackageJson() {
+		this.package.replace("name", this.name.replaceAll("/", "-")).replaceAll("yarn", getPackageManager()).save();
+		return this;
+	}
+	/**
+	* Wire DB_DRIVER and DB_PORT into .env.
+	*
+	* The driver's npm package is installed via `warlock add` (single source for
+	* versions), so this only touches environment configuration — not deps.
+	*/
+	configureDatabaseEnv(driverValue) {
+		const driver = getDatabaseDriver(driverValue);
+		if (!driver) return this;
+		let envContent = getFile(this.path + "/.env");
+		envContent = envContent.replace(/DB_PORT=\d+/, `DB_PORT=${driver.defaultPort}`);
+		if (envContent.includes("DB_DRIVER=")) envContent = envContent.replace(/DB_DRIVER=\w*/, `DB_DRIVER=${driver.value}`);
+		else envContent = envContent.replace(/DB_PORT=\d+/, `DB_PORT=${driver.defaultPort}\nDB_DRIVER=${driver.value}`);
+		putFile(this.path + "/.env", envContent);
+		return this;
+	}
+	/**
+	* Install the selected optional features by delegating to the project's own
+	* `warlock add`. `--no-install` records every dependency in package.json and
+	* ejects configs / scripts / setup hooks WITHOUT installing — the caller runs
+	* one batched install afterwards. Versions come from core's feature map, so
+	* the scaffolder never duplicates them.
+	*
+	* `--no-install` is passed LAST on purpose: the CLI parser treats the
+	* positional after a bare flag as that flag's value, so it must follow the
+	* feature list, not precede it.
+	*/
+	async installFeatures(features) {
+		if (features.length === 0) return true;
+		return this.exec(`npx warlock add ${features.join(" ")} --no-install`);
+	}
+	/**
+	* Get package json file
+	*/
+	get package() {
+		return this.json("package.json");
+	}
+	updateDotEnv() {
+		this.file(".env").replaceAll("appName", this.name).save();
+		return this;
+	}
+	/**
+	* Get env file to update
+	*/
+	get env() {
+		return this.file(".env");
+	}
+	get name() {
+		return this.app.appName;
+	}
+	get path() {
+		return this.app.appPath;
+	}
+	file(relativePath) {
+		const fullPath = path.resolve(this.path, relativePath);
+		if (!this.files[fullPath]) this.files[fullPath] = file(fullPath);
+		return this.files[fullPath];
+	}
+	json(relativePath) {
+		const fullPath = path.resolve(this.path, relativePath);
+		if (!this.jsonFiles[fullPath]) this.jsonFiles[fullPath] = jsonFile(fullPath);
+		return this.jsonFiles[fullPath];
+	}
+};
+var FileManager = class {
+	constructor(filePath) {
+		this.filePath = filePath;
+		this.parseContent();
+	}
+	parseContent() {
+		this.content = getFile(this.filePath);
+	}
+	replace(search, replace) {
+		this.content = this.content.replace(search, replace);
+		return this;
+	}
+	replaceAll(search, replace) {
+		this.content = this.content.replaceAll(search, replace);
+		return this;
+	}
+	save() {
+		putFile(this.filePath, this.content);
+	}
+};
+var JsonFileManager = class extends FileManager {
+	parseContent() {
+		this.content = getJsonFile(this.filePath);
+	}
+	save() {
+		putJsonFile(this.filePath, this.content);
+	}
+	has(key) {
+		return this.content[key] !== void 0;
+	}
+	replace(key, value) {
+		this.content[key] = value;
+		return this;
+	}
+	replaceAll(key, value) {
+		const contentAsString = JSON.stringify(this.content);
+		this.content = JSON.parse(contentAsString.replaceAll(key, value));
+		return this;
+	}
+};
+function file(path) {
+	return new FileManager(path);
+}
+function jsonFile(path) {
+	return new JsonFileManager(path);
+}
+
+//#endregion
+export { App };
+//# sourceMappingURL=app.mjs.map

package/esm/helpers/app.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.mjs","names":[],"sources":["../../../../../../@warlock.js/create-warlock/src/helpers/app.ts"],"sourcesContent":["import {\r\n  copyDirectory,\r\n  copyFile,\r\n  fileExists,\r\n  getFile,\r\n  getJsonFile,\r\n  putFile,\r\n  putJsonFile,\r\n  renameFile,\r\n} from \"@warlock.js/fs\";\r\nimport path from \"path\";\r\nimport { AppOptions, Application } from \"../commands/create-new-app/types\";\r\nimport { getDatabaseDriver } from \"../features/database-drivers\";\r\nimport { executeCommand, runCommand } from \"./exec\";\r\nimport { getPackageManager } from \"./package-manager\";\r\nimport { Template, template } from \"./paths\";\r\n\r\nexport class App {\r\n  /**\r\n   * Resolved files\r\n   */\r\n  protected files: Record<string, FileManager> = {};\r\n\r\n  /**\r\n   * Resolved JSON files\r\n   */\r\n  protected jsonFiles: Record<string, JsonFileManager> = {};\r\n\r\n  public isInstalled = false;\r\n\r\n  public constructor(protected app: Application) {}\r\n\r\n  public get options(): AppOptions {\r\n    return this.app.options;\r\n  }\r\n\r\n  public use(templateName: Template) {\r\n    copyDirectory(template(templateName), this.path);\r\n\r\n    if (fileExists(this.path + \"/.env.example\")) {\r\n      copyFile(this.path + \"/.env.example\", this.path + \"/.env\");\r\n    }\r\n\r\n    renameFile(this.path + \"/_.gitignore\", this.path + \"/.gitignore\");\r\n\r\n    return this;\r\n  }\r\n\r\n  public init() {\r\n    return this;\r\n  }\r\n\r\n  public terminate() {\r\n    // No longer using outro, using showSuccessScreen instead\r\n  }\r\n\r\n  public install() {\r\n    return runCommand(getPackageManager(), [\"install\"], this.path);\r\n  }\r\n\r\n  public async exec(command: string) {\r\n    const [commandName, ...optionsList] = command.split(\" \");\r\n    return await executeCommand(commandName, optionsList, this.path);\r\n  }\r\n\r\n  public async git() {\r\n    const { initializeGitRepository } = await import(\r\n      \"./project-builder-helpers\"\r\n    );\r\n    return await initializeGitRepository(this.path);\r\n  }\r\n\r\n  public updatePackageJson() {\r\n    this.package\r\n      .replace(\"name\", this.name.replaceAll(\"/\", \"-\"))\r\n      .replaceAll(\"yarn\", getPackageManager())\r\n      .save();\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Wire DB_DRIVER and DB_PORT into .env.\r\n   *\r\n   * The driver's npm package is installed via `warlock add` (single source for\r\n   * versions), so this only touches environment configuration — not deps.\r\n   */\r\n  public configureDatabaseEnv(driverValue: string) {\r\n    const driver = getDatabaseDriver(driverValue);\r\n\r\n    if (!driver) return this;\r\n\r\n    let envContent = getFile(this.path + \"/.env\") as string;\r\n\r\n    envContent = envContent.replace(/DB_PORT=\\d+/, `DB_PORT=${driver.defaultPort}`);\r\n\r\n    if (envContent.includes(\"DB_DRIVER=\")) {\r\n      envContent = envContent.replace(/DB_DRIVER=\\w*/, `DB_DRIVER=${driver.value}`);\r\n    } else {\r\n      envContent = envContent.replace(\r\n        /DB_PORT=\\d+/,\r\n        `DB_PORT=${driver.defaultPort}\\nDB_DRIVER=${driver.value}`,\r\n      );\r\n    }\r\n\r\n    putFile(this.path + \"/.env\", envContent);\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Install the selected optional features by delegating to the project's own\r\n   * `warlock add`. `--no-install` records every dependency in package.json and\r\n   * ejects configs / scripts / setup hooks WITHOUT installing — the caller runs\r\n   * one batched install afterwards. Versions come from core's feature map, so\r\n   * the scaffolder never duplicates them.\r\n   *\r\n   * `--no-install` is passed LAST on purpose: the CLI parser treats the\r\n   * positional after a bare flag as that flag's value, so it must follow the\r\n   * feature list, not precede it.\r\n   */\r\n  public async installFeatures(features: string[]) {\r\n    if (features.length === 0) return true;\r\n\r\n    return this.exec(`npx warlock add ${features.join(\" \")} --no-install`);\r\n  }\r\n\r\n  /**\r\n   * Get package json file\r\n   */\r\n  public get package() {\r\n    return this.json(\"package.json\");\r\n  }\r\n\r\n  public updateDotEnv() {\r\n    this.file(\".env\").replaceAll(\"appName\", this.name).save();\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Get env file to update\r\n   */\r\n  public get env() {\r\n    return this.file(\".env\");\r\n  }\r\n\r\n  public get name() {\r\n    return this.app.appName;\r\n  }\r\n\r\n  public get path() {\r\n    return this.app.appPath;\r\n  }\r\n\r\n  public file(relativePath: string) {\r\n    const fullPath = path.resolve(this.path, relativePath);\r\n\r\n    if (!this.files[fullPath]) {\r\n      this.files[fullPath] = file(fullPath);\r\n    }\r\n\r\n    return this.files[fullPath];\r\n  }\r\n\r\n  public json(relativePath: string): JsonFileManager {\r\n    const fullPath = path.resolve(this.path, relativePath);\r\n\r\n    if (!this.jsonFiles[fullPath]) {\r\n      this.jsonFiles[fullPath] = jsonFile(fullPath);\r\n    }\r\n\r\n    return this.jsonFiles[fullPath];\r\n  }\r\n}\r\n\r\nexport function app(app: Application) {\r\n  return new App(app);\r\n}\r\n\r\nexport class FileManager {\r\n  public content!: string;\r\n  public constructor(protected filePath: string) {\r\n    this.parseContent();\r\n  }\r\n\r\n  protected parseContent() {\r\n    this.content = getFile(this.filePath) as string;\r\n  }\r\n\r\n  public replace(search: string, replace: string) {\r\n    this.content = this.content.replace(search, replace);\r\n\r\n    return this;\r\n  }\r\n\r\n  public replaceAll(search: string, replace: string) {\r\n    this.content = this.content.replaceAll(search, replace);\r\n\r\n    return this;\r\n  }\r\n\r\n  public save() {\r\n    putFile(this.filePath, this.content);\r\n  }\r\n}\r\n\r\nexport class JsonFileManager extends FileManager {\r\n  protected parseContent() {\r\n    this.content = getJsonFile(this.filePath);\r\n  }\r\n\r\n  public save() {\r\n    putJsonFile(this.filePath, this.content);\r\n  }\r\n\r\n  public has(key: string) {\r\n    return this.content[key] !== undefined;\r\n  }\r\n\r\n  public replace(key: string, value: any) {\r\n    this.content[key] = value;\r\n\r\n    return this;\r\n  }\r\n\r\n  public replaceAll(key: string, value: any) {\r\n    const contentAsString = JSON.stringify(this.content);\r\n\r\n    this.content = JSON.parse(contentAsString.replaceAll(key, value));\r\n\r\n    return this;\r\n  }\r\n}\r\n\r\nexport function file(path: string) {\r\n  return new FileManager(path);\r\n}\r\n\r\nexport function jsonFile(path: string) {\r\n  return new JsonFileManager(path);\r\n}\r\n"],"mappings":"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"}

package/esm/helpers/exec.mjs

@@ -0,0 +1,58 @@
+import { log } from "@clack/prompts";
+import { colors } from "@mongez/copper";
+import childProcess from "cross-spawn";
+
+//#region ../../@warlock.js/create-warlock/src/helpers/exec.ts
+/**
+* This function directly executes a command
+*/
+async function executeCommand(cmd, args, cwd) {
+	return new Promise((resolve) => {
+		const child = childProcess(cmd, args, {
+			cwd,
+			stdio: "ignore"
+		});
+		child.on("error", (e) => {
+			if (e) if (e.message) log.error(colors.red(String(e.message)) + `\n\n`);
+			else log.error(colors.red(String(e)) + `\n\n`);
+			resolve(false);
+		});
+		child.on("close", (code) => {
+			if (code === 0) resolve(true);
+			else resolve(false);
+		});
+	});
+}
+function runCommand(cmd, args, cwd) {
+	let child;
+	const install = new Promise((resolve) => {
+		try {
+			child = childProcess(cmd, args, {
+				cwd,
+				stdio: "ignore"
+			});
+			child.on("error", (e) => {
+				if (e) if (e.message) log.error(colors.red(String(e.message)) + `\n\n`);
+				else log.error(colors.red(String(e)) + `\n\n`);
+				resolve(false);
+			});
+			child.on("close", (code) => {
+				if (code === 0) resolve(true);
+				else resolve(false);
+			});
+		} catch (e) {
+			resolve(false);
+		}
+	});
+	const abort = async () => {
+		if (child) child.kill("SIGINT");
+	};
+	return {
+		abort,
+		install
+	};
+}
+
+//#endregion
+export { executeCommand, runCommand };
+//# sourceMappingURL=exec.mjs.map

package/esm/helpers/exec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.mjs","names":["spawn"],"sources":["../../../../../../@warlock.js/create-warlock/src/helpers/exec.ts"],"sourcesContent":["import { log } from \"@clack/prompts\";\r\nimport { colors } from \"@mongez/copper\";\r\nimport { ChildProcess } from \"child_process\";\r\nimport { default as childProcess, default as spawn } from \"cross-spawn\";\r\n\r\nexport default async function exec(command: string, options: any = {}) {\r\n  const [commandName, ...optionsList] = command.split(\" \");\r\n\r\n  const commandOutput = childProcess.sync(commandName, optionsList, options);\r\n\r\n  // it means command didn't end as expected, then stop the rest of the program\r\n  if (commandOutput.error !== null) {\r\n    process.exit(1);\r\n  }\r\n\r\n  return commandOutput;\r\n}\r\n\r\n/**\r\n * This function directly executes a command\r\n */\r\nexport async function executeCommand(cmd: string, args: string[], cwd: string) {\r\n  return new Promise<boolean>(resolve => {\r\n    const child = spawn(cmd, args, {\r\n      cwd,\r\n      stdio: \"ignore\",\r\n    });\r\n\r\n    child.on(\"error\", e => {\r\n      if (e) {\r\n        if (e.message) {\r\n          log.error(colors.red(String(e.message)) + `\\n\\n`);\r\n        } else {\r\n          log.error(colors.red(String(e)) + `\\n\\n`);\r\n        }\r\n      }\r\n      resolve(false);\r\n    });\r\n\r\n    child.on(\"close\", code => {\r\n      if (code === 0) {\r\n        resolve(true);\r\n      } else {\r\n        resolve(false);\r\n      }\r\n    });\r\n  });\r\n}\r\n\r\nexport function runCommand(cmd: string, args: string[], cwd: string) {\r\n  let child: ChildProcess;\r\n\r\n  const install = new Promise<boolean>(resolve => {\r\n    try {\r\n      child = spawn(cmd, args, {\r\n        cwd,\r\n        stdio: \"ignore\",\r\n      });\r\n\r\n      child.on(\"error\", e => {\r\n        if (e) {\r\n          if (e.message) {\r\n            log.error(colors.red(String(e.message)) + `\\n\\n`);\r\n          } else {\r\n            log.error(colors.red(String(e)) + `\\n\\n`);\r\n          }\r\n        }\r\n        resolve(false);\r\n      });\r\n\r\n      child.on(\"close\", code => {\r\n        if (code === 0) {\r\n          resolve(true);\r\n        } else {\r\n          resolve(false);\r\n        }\r\n      });\r\n    } catch (e) {\r\n      resolve(false);\r\n    }\r\n  });\r\n\r\n  const abort = async () => {\r\n    if (child) {\r\n      child.kill(\"SIGINT\");\r\n    }\r\n  };\r\n\r\n  return { abort, install };\r\n}\r\n"],"mappings":";;;;;;;;AAqBA,eAAsB,eAAe,KAAa,MAAgB,KAAa;CAC7E,OAAO,IAAI,SAAiB,YAAW;EACrC,MAAM,QAAQA,aAAM,KAAK,MAAM;GAC7B;GACA,OAAO;EACT,CAAC;EAED,MAAM,GAAG,UAAS,MAAK;GACrB,IAAI,GACF,IAAI,EAAE,SACJ,IAAI,MAAM,OAAO,IAAI,OAAO,EAAE,OAAO,CAAC,IAAI,MAAM;QAEhD,IAAI,MAAM,OAAO,IAAI,OAAO,CAAC,CAAC,IAAI,MAAM;GAG5C,QAAQ,KAAK;EACf,CAAC;EAED,MAAM,GAAG,UAAS,SAAQ;GACxB,IAAI,SAAS,GACX,QAAQ,IAAI;QAEZ,QAAQ,KAAK;EAEjB,CAAC;CACH,CAAC;AACH;AAEA,SAAgB,WAAW,KAAa,MAAgB,KAAa;CACnE,IAAI;CAEJ,MAAM,UAAU,IAAI,SAAiB,YAAW;EAC9C,IAAI;GACF,QAAQA,aAAM,KAAK,MAAM;IACvB;IACA,OAAO;GACT,CAAC;GAED,MAAM,GAAG,UAAS,MAAK;IACrB,IAAI,GACF,IAAI,EAAE,SACJ,IAAI,MAAM,OAAO,IAAI,OAAO,EAAE,OAAO,CAAC,IAAI,MAAM;SAEhD,IAAI,MAAM,OAAO,IAAI,OAAO,CAAC,CAAC,IAAI,MAAM;IAG5C,QAAQ,KAAK;GACf,CAAC;GAED,MAAM,GAAG,UAAS,SAAQ;IACxB,IAAI,SAAS,GACX,QAAQ,IAAI;SAEZ,QAAQ,KAAK;GAEjB,CAAC;EACH,SAAS,GAAG;GACV,QAAQ,KAAK;EACf;CACF,CAAC;CAED,MAAM,QAAQ,YAAY;EACxB,IAAI,OACF,MAAM,KAAK,QAAQ;CAEvB;CAEA,OAAO;EAAE;EAAO;CAAQ;AAC1B"}