Options and Configuration

/**
 * Configuration options for creating a new Strapi application
 */
interface NewOptions {
  /** Force use of npm instead of yarn even if yarn is available */
  useNpm: boolean;
  /** Whether to run the application after creation (default: true) */
  run: boolean;
  /** Enable debug mode with additional logging */
  debug: boolean;
  /** Use quickstart mode with SQLite (skip database prompts) */
  quickstart: boolean;
  /** Template URL or npm package name for custom project template */
  template: string;
  /** Starter configuration name */
  starter: string;
  /** Generate TypeScript project instead of JavaScript */
  typescript: boolean;
  /** Force database configuration without connection testing */
  dbforce: boolean;
  /** Database SSL configuration */
  dbssl: string;
  /** Database client type (mysql, postgres, sqlite) */
  dbclient: string;
  /** Database host address */
  dbhost: string;
  /** Database port number */
  dbport: string;
  /** Database name */
  dbname: string;
  /** Database username */
  dbusername: string;
  /** Database password */
  dbpassword: string;
  /** SQLite database file path */
  dbfile: string;
}

/**
 * Complete configuration scope for project generation
 */
interface Scope {
  /** Project name (derived from directory name) */
  name?: string;
  /** Absolute path to project root directory */
  rootPath: string;
  /** Template URL or package name */
  template?: string;
  /** Strapi version to install */
  strapiVersion: string;
  /** Core Strapi dependencies to install */
  strapiDependencies: Array<string>;
  /** Whether to install dependencies automatically */
  installDependencies?: boolean;
  /** Additional dependencies (React, etc.) */
  additionalsDependencies: Record<string, string>;
  /** Whether running in Docker environment */
  docker: boolean;
  /** Whether to use Yarn package manager */
  useYarn: boolean;
  /** Whether to generate TypeScript project */
  useTypescript: boolean;
  /** Whether to run app after quickstart creation */
  runQuickstartApp: boolean;
  /** Whether in quickstart mode */
  quick?: boolean;
  /** Unique project identifier */
  uuid?: string;
  /** Machine identifier for telemetry */
  deviceId?: string;
  /** Force database configuration */
  dbforce?: boolean;
  /** Database configuration */
  database?: DatabaseInfo;
  /** Debug mode enabled */
  debug?: boolean;
  /** Temporary directory path */
  tmpPath: string;
  /** Package.json Strapi-specific configuration */
  packageJsonStrapi: Record<string, unknown>;
}

/**
 * Validates that target directory exists and is empty
 * @param rootPath - Absolute path to target directory
 * @throws Error if path is not a directory or not empty
 */
function checkInstallPath(rootPath: string): Promise<void>;

import { checkInstallPath } from "@strapi/generate-new";

// Validate before generation
try {
  await checkInstallPath("./my-new-app");
  console.log("Path is valid for Strapi app creation");
} catch (error) {
  console.error("Invalid path:", error.message);
}

/**
 * Validates system requirements for Strapi generation
 * Checks Node.js version and other system prerequisites
 */
function checkRequirements(): void;

/**
 * Detects if Yarn is available on the system
 * @returns true if yarn command is available
 */
function hasYarn(): boolean;

/**
 * Parses database arguments from options and populates scope
 * @param params - Object containing scope and command-line args
 */
function parseDatabaseArguments(params: {
  scope: Scope;
  args: Partial<NewOptions>;
}): void;

// Default Strapi dependencies
const defaultStrapiDependencies = [
  '@strapi/strapi',
  '@strapi/plugin-users-permissions',
  '@strapi/plugin-i18n',
  '@strapi/plugin-cloud'
];

// Default additional dependencies
const defaultAdditionalDependencies = {
  'react': '^18.0.0',
  'react-dom': '^18.0.0',
  'react-router-dom': '5.3.4',
  'styled-components': '5.3.3'
};

// Default database configuration (SQLite)
const defaultDatabase = {
  client: 'sqlite',
  connection: {
    filename: '.tmp/data.db'
  },
  useNullAsDefault: true
};

// Docker detection
const isDocker = process.env.DOCKER === 'true';

// Package manager preference
const useYarn = !options.useNpm && hasYarn();

// UUID prefix support
const uuid = (process.env.STRAPI_UUID_PREFIX || '') + crypto.randomUUID();

// Sentry configuration for error tracking
sentry.init({
  dsn: 'https://841d2b2c9b4d4b43a4cde92794cb705a@sentry.io/1762059'
});

// Telemetry tags
const telemetryTags = {
  os: os.type(),
  osPlatform: os.platform(),
  osArch: os.arch(),
  osRelease: os.release(),
  version: scope.strapiVersion,
  nodeVersion: process.versions.node,
  docker: scope.docker
};