create-velox-app 0.3.4 → 0.3.6

package/dist/cli.js

@@ -6,6 +6,16 @@
  * Handles command-line arguments and initiates the scaffolding process.
  */
 import { CREATE_VERSION, createVeloxApp } from './index.js';
+import { getAvailableTemplates, isValidTemplate, TEMPLATE_METADATA } from './templates/index.js';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Get list of available template names for error messages */
+function getTemplateNames() {
+    return getAvailableTemplates()
+        .map((t) => t.type)
+        .join(', ');
+}
 // ============================================================================
 // Help & Version
 // ============================================================================
@@ -13,17 +23,105 @@ const HELP_TEXT = `
 create-velox-app v${CREATE_VERSION}
 
 Usage:
-  npx create-velox-app [project-name]
-  pnpm create velox-app [project-name]
+  npx create-velox-app [project-name] [options]
+  pnpm create velox-app [project-name] [options]
 
 Options:
-  -h, --help      Show this help message
-  -v, --version   Show version number
+  -t, --template <name>  Template to use (default: "default")
+                         Available: ${getTemplateNames()}
+  -h, --help             Show this help message
+  -v, --version          Show version number
+
+Templates:
+  default    ${TEMPLATE_METADATA.default.description}
+  auth       ${TEMPLATE_METADATA.auth.description}
 
 Examples:
-  npx create-velox-app my-app
-  npx create-velox-app           # Interactive mode
+  npx create-velox-app my-app                    # Interactive mode
+  npx create-velox-app my-app --template=auth    # Auth template
+  npx create-velox-app                           # Prompt for name
 `;
+function parseArgs(args) {
+    const result = {
+        help: false,
+        version: false,
+    };
+    const unexpectedArgs = [];
+    let templateFlagSeen = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        // Handle --help / -h
+        if (arg === '-h' || arg === '--help') {
+            result.help = true;
+            continue;
+        }
+        // Handle --version / -v
+        if (arg === '-v' || arg === '--version') {
+            result.version = true;
+            continue;
+        }
+        // Handle --template=<value> or -t=<value>
+        if (arg.startsWith('--template=') || arg.startsWith('-t=')) {
+            // Check for duplicate flag
+            if (templateFlagSeen) {
+                console.error('Error: --template flag specified multiple times');
+                process.exit(1);
+            }
+            templateFlagSeen = true;
+            const value = arg.split('=')[1];
+            if (!value) {
+                console.error(`Error: --template requires a value. Available: ${getTemplateNames()}`);
+                process.exit(1);
+            }
+            if (isValidTemplate(value)) {
+                result.template = value;
+            }
+            else {
+                console.error(`Invalid template: ${value}. Available: ${getTemplateNames()}`);
+                process.exit(1);
+            }
+            continue;
+        }
+        // Handle --template <value> or -t <value>
+        if (arg === '--template' || arg === '-t') {
+            // Check for duplicate flag
+            if (templateFlagSeen) {
+                console.error('Error: --template flag specified multiple times');
+                process.exit(1);
+            }
+            templateFlagSeen = true;
+            const value = args[i + 1];
+            if (!value || value.startsWith('-')) {
+                console.error(`Error: --template requires a value. Available: ${getTemplateNames()}`);
+                process.exit(1);
+            }
+            if (isValidTemplate(value)) {
+                result.template = value;
+                i++; // Skip next arg
+            }
+            else {
+                console.error(`Invalid template: ${value}. Available: ${getTemplateNames()}`);
+                process.exit(1);
+            }
+            continue;
+        }
+        // Non-flag argument
+        if (!arg.startsWith('-')) {
+            if (!result.projectName) {
+                result.projectName = arg;
+            }
+            else {
+                // Track unexpected positional arguments
+                unexpectedArgs.push(arg);
+            }
+        }
+    }
+    // Warn about unexpected arguments
+    if (unexpectedArgs.length > 0) {
+        console.warn(`Warning: Unexpected arguments ignored: ${unexpectedArgs.join(', ')}`);
+    }
+    return result;
+}
 // ============================================================================
 // Main Entry Point
 // ============================================================================
@@ -32,30 +130,45 @@ Examples:
  */
 async function main() {
     try {
-        // Get arguments
         const args = process.argv.slice(2);
+        const parsed = parseArgs(args);
         // Handle --help
-        if (args.includes('-h') || args.includes('--help')) {
+        if (parsed.help) {
             console.log(HELP_TEXT);
             process.exit(0);
         }
         // Handle --version
-        if (args.includes('-v') || args.includes('--version')) {
+        if (parsed.version) {
             console.log(CREATE_VERSION);
             process.exit(0);
         }
-        // Get project name (first non-flag argument)
-        const projectName = args.find((arg) => !arg.startsWith('-'));
         // Run scaffolder
-        await createVeloxApp(projectName);
+        await createVeloxApp(parsed.projectName, parsed.template);
     }
     catch (error) {
-        // Handle unexpected errors
+        // Handle unexpected errors with actionable guidance
         if (error instanceof Error) {
             console.error(`\nError: ${error.message}`);
+            // Provide contextual help based on error type
+            const msg = error.message.toLowerCase();
+            if (msg.includes('eacces') || msg.includes('permission')) {
+                console.error('\nTry running with appropriate permissions or choose a different directory.');
+            }
+            else if (msg.includes('enospc') || msg.includes('no space')) {
+                console.error('\nInsufficient disk space. Free up some space and try again.');
+            }
+            else if (msg.includes('enotfound') ||
+                msg.includes('network') ||
+                msg.includes('etimedout')) {
+                console.error('\nCheck your internet connection and try again.');
+            }
+            else if (msg.includes('already exists')) {
+                console.error('\nChoose a different project name or remove the existing directory.');
+            }
         }
         else {
             console.error('\nAn unexpected error occurred');
+            console.error('Please report this issue at: https://github.com/veloxts/velox-ts-framework/issues');
         }
         process.exit(1);
     }

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5D,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,MAAM,SAAS,GAAG;oBACE,cAAc;;;;;;;;;;;;;CAajC,CAAC;AAEF,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,gBAAgB;QAChB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAEnC,gBAAgB;QAChB,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnD,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,mBAAmB;QACnB,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACtD,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,6CAA6C;QAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QAE7D,iBAAiB;QACjB,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,2BAA2B;QAC3B,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,cAAc;AACd,IAAI,EAAE,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5D,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEjG,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,8DAA8D;AAC9D,SAAS,gBAAgB;IACvB,OAAO,qBAAqB,EAAE;SAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,MAAM,SAAS,GAAG;oBACE,cAAc;;;;;;;;sCAQI,gBAAgB,EAAE;;;;;eAKzC,iBAAiB,CAAC,OAAO,CAAC,WAAW;eACrC,iBAAiB,CAAC,IAAI,CAAC,WAAW;;;;;;CAMhD,CAAC;AAaF,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,MAAM,GAAe;QACzB,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,KAAK;KACf,CAAC;IAEF,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAE7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpB,qBAAqB;QACrB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;YACnB,SAAS;QACX,CAAC;QAED,wBAAwB;QACxB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACtB,SAAS;QACX,CAAC;QAED,0CAA0C;QAC1C,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3D,2BAA2B;YAC3B,IAAI,gBAAgB,EAAE,CAAC;gBACrB,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;gBACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,gBAAgB,GAAG,IAAI,CAAC;YAExB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAChC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,CAAC,KAAK,CAAC,kDAAkD,gBAAgB,EAAE,EAAE,CAAC,CAAC;gBACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3B,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,qBAAqB,KAAK,gBAAgB,gBAAgB,EAAE,EAAE,CAAC,CAAC;gBAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,SAAS;QACX,CAAC;QAED,0CAA0C;QAC1C,IAAI,GAAG,KAAK,YAAY,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACzC,2BAA2B;YAC3B,IAAI,gBAAgB,EAAE,CAAC;gBACrB,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;gBACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,gBAAgB,GAAG,IAAI,CAAC;YAExB,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpC,OAAO,CAAC,KAAK,CAAC,kDAAkD,gBAAgB,EAAE,EAAE,CAAC,CAAC;gBACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3B,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC;gBACxB,CAAC,EAAE,CAAC,CAAC,gBAAgB;YACvB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,qBAAqB,KAAK,gBAAgB,gBAAgB,EAAE,EAAE,CAAC,CAAC;gBAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,SAAS;QACX,CAAC;QAED,oBAAoB;QACpB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;gBACxB,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,wCAAwC;gBACxC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,0CAA0C,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAE/B,gBAAgB;QAChB,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,mBAAmB;QACnB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,iBAAiB;QACjB,MAAM,cAAc,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,oDAAoD;QACpD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAE3C,8CAA8C;YAC9C,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACxC,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBACzD,OAAO,CAAC,KAAK,CACX,6EAA6E,CAC9E,CAAC;YACJ,CAAC;iBAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9D,OAAO,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;YAChF,CAAC;iBAAM,IACL,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACzB,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC;gBACvB,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,EACzB,CAAC;gBACD,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACnE,CAAC;iBAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBAC1C,OAAO,CAAC,KAAK,CAAC,qEAAqE,CAAC,CAAC;YACvF,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAChD,OAAO,CAAC,KAAK,CACX,mFAAmF,CACpF,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,cAAc;AACd,IAAI,EAAE,CAAC"}

package/dist/index.d.ts

@@ -1,13 +1,14 @@
 /**
  * create-velox-app - Project scaffolding tool
  *
- * CLI tool for bootstrapping new VeloxTS applications with a default template.
+ * CLI tool for bootstrapping new VeloxTS applications with multiple templates.
  * Provides an interactive setup experience similar to create-next-app.
  */
+import type { TemplateType } from './templates/index.js';
 /** Create-velox-app package version */
 export declare const CREATE_VERSION: string;
 /**
  * Main scaffolding function that creates a new VeloxTS project
  */
-export declare function createVeloxApp(initialProjectName?: string): Promise<void>;
+export declare function createVeloxApp(initialProjectName?: string, initialTemplate?: TemplateType): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0CH,uCAAuC;AACvC,eAAO,MAAM,cAAc,EAAE,MAA+C,CAAC;AAgB7E;;GAEG;AACH,wBAAsB,cAAc,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C/E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,OAAO,KAAK,EAAgC,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAiBvF,uCAAuC;AACvC,eAAO,MAAM,cAAc,EAAE,MAA+C,CAAC;AAkD7E;;GAEG;AACH,wBAAsB,cAAc,CAClC,kBAAkB,CAAC,EAAE,MAAM,EAC3B,eAAe,CAAC,EAAE,YAAY,GAC7B,OAAO,CAAC,IAAI,CAAC,CAuEf"}