@veloxts/cli 0.6.31 → 0.6.52

package/dist/generators/generators/event.js

@@ -0,0 +1,99 @@
+/**
+ * Event Generator
+ *
+ * Scaffolds event-related files for VeloxTS applications.
+ *
+ * Usage:
+ *   velox make event <name> [options]
+ *
+ * Examples:
+ *   velox make event user-registered           # Broadcastable event
+ *   velox make event order-created --listener  # Event listener
+ *   velox make event notifications --channel   # Channel with authorization
+ */
+import { BaseGenerator } from '../base.js';
+import { eventTemplate, getEventInstructions, getEventPath, } from '../templates/event.js';
+// ============================================================================
+// Generator Implementation
+// ============================================================================
+/**
+ * Event generator - creates event-related files
+ */
+export class EventGenerator extends BaseGenerator {
+    metadata = {
+        name: 'event',
+        description: 'Generate event definitions, listeners, and channels',
+        longDescription: `
+Scaffold event-related files for VeloxTS applications using @veloxts/events.
+
+Events enable real-time communication between backend and frontend, as well as
+internal event-driven architecture patterns.
+
+Variants:
+  - Broadcast (default): Event definition with WebSocket broadcasting
+  - Listener: Event handler for responding to dispatched events
+  - Channel: WebSocket channel configuration with authorization
+
+Examples:
+  velox make event user-registered           # Broadcastable event
+  velox make event order-created --listener  # Event listener
+  velox make event notifications --channel   # Channel with authorization
+`,
+        aliases: ['ev', 'broadcast'],
+        category: 'infrastructure',
+    };
+    options = [
+        {
+            name: 'listener',
+            short: 'l',
+            description: 'Generate event listener/handler',
+            type: 'boolean',
+            default: false,
+        },
+        {
+            name: 'channel',
+            short: 'c',
+            description: 'Generate channel configuration with authorization',
+            type: 'boolean',
+            default: false,
+        },
+    ];
+    /**
+     * Validate and transform raw options
+     */
+    validateOptions(raw) {
+        const listener = Boolean(raw.listener ?? false);
+        const channel = Boolean(raw.channel ?? false);
+        // Ensure only one variant is selected
+        if (listener && channel) {
+            throw new Error('Cannot use both --listener and --channel options. Choose one variant per generator call.');
+        }
+        return {
+            listener,
+            channel,
+        };
+    }
+    /**
+     * Generate event files
+     */
+    async generate(config) {
+        const context = this.createContext(config);
+        const files = [];
+        // Generate event file
+        const eventContent = eventTemplate(context);
+        files.push({
+            path: getEventPath(config.entityName, config.project, config.options),
+            content: eventContent,
+        });
+        return {
+            files,
+            postInstructions: getEventInstructions(config.entityName, config.options),
+        };
+    }
+}
+/**
+ * Factory function for creating an EventGenerator instance
+ */
+export function createEventGenerator() {
+    return new EventGenerator();
+}

package/dist/generators/generators/index.d.ts

@@ -4,10 +4,13 @@
  * Re-exports all built-in generators and provides auto-registration.
  */
 export { ActionGenerator, createActionGenerator } from './action.js';
+export { createEventGenerator, EventGenerator } from './event.js';
 export { createExceptionGenerator, ExceptionGenerator } from './exception.js';
 export { createFactoryGenerator, FactoryGenerator } from './factory.js';
 export { createGuardGenerator, GuardGenerator } from './guard.js';
+export { createJobGenerator, JobGenerator } from './job.js';
 export { createLayoutGenerator, LayoutGenerator } from './layout.js';
+export { createMailGenerator, MailGenerator } from './mail.js';
 export { createMiddlewareGenerator, MiddlewareGenerator } from './middleware.js';
 export { createMigrationGenerator, MigrationGenerator } from './migration.js';
 export { createModelGenerator, ModelGenerator } from './model.js';
@@ -18,6 +21,8 @@ export { createResourceGenerator, ResourceGenerator } from './resource.js';
 export { createSchemaGenerator, SchemaGenerator } from './schema.js';
 export { createSeederGenerator, SeederGenerator } from './seeder.js';
 export { createServiceGenerator, ServiceGenerator } from './service.js';
+export { createStorageGenerator, StorageGenerator } from './storage.js';
+export { createTaskGenerator, TaskGenerator } from './task.js';
 export { createTestGenerator, TestGenerator } from './test.js';
 /**
  * Register all built-in generators with the global registry.

package/dist/generators/generators/index.js

@@ -5,10 +5,13 @@
  */
 import { registerGenerator } from '../registry.js';
 import { createActionGenerator } from './action.js';
+import { createEventGenerator } from './event.js';
 import { createExceptionGenerator } from './exception.js';
 import { createFactoryGenerator } from './factory.js';
 import { createGuardGenerator } from './guard.js';
+import { createJobGenerator } from './job.js';
 import { createLayoutGenerator } from './layout.js';
+import { createMailGenerator } from './mail.js';
 import { createMiddlewareGenerator } from './middleware.js';
 import { createMigrationGenerator } from './migration.js';
 import { createModelGenerator } from './model.js';
@@ -19,15 +22,20 @@ import { createResourceGenerator } from './resource.js';
 import { createSchemaGenerator } from './schema.js';
 import { createSeederGenerator } from './seeder.js';
 import { createServiceGenerator } from './service.js';
+import { createStorageGenerator } from './storage.js';
+import { createTaskGenerator } from './task.js';
 import { createTestGenerator } from './test.js';
 // ============================================================================
 // Generator Exports
 // ============================================================================
 export { ActionGenerator, createActionGenerator } from './action.js';
+export { createEventGenerator, EventGenerator } from './event.js';
 export { createExceptionGenerator, ExceptionGenerator } from './exception.js';
 export { createFactoryGenerator, FactoryGenerator } from './factory.js';
 export { createGuardGenerator, GuardGenerator } from './guard.js';
+export { createJobGenerator, JobGenerator } from './job.js';
 export { createLayoutGenerator, LayoutGenerator } from './layout.js';
+export { createMailGenerator, MailGenerator } from './mail.js';
 export { createMiddlewareGenerator, MiddlewareGenerator } from './middleware.js';
 export { createMigrationGenerator, MigrationGenerator } from './migration.js';
 export { createModelGenerator, ModelGenerator } from './model.js';
@@ -38,6 +46,8 @@ export { createResourceGenerator, ResourceGenerator } from './resource.js';
 export { createSchemaGenerator, SchemaGenerator } from './schema.js';
 export { createSeederGenerator, SeederGenerator } from './seeder.js';
 export { createServiceGenerator, ServiceGenerator } from './service.js';
+export { createStorageGenerator, StorageGenerator } from './storage.js';
+export { createTaskGenerator, TaskGenerator } from './task.js';
 export { createTestGenerator, TestGenerator } from './test.js';
 // ============================================================================
 // Auto-Registration
@@ -71,6 +81,11 @@ export function registerBuiltinGenerators() {
     registerGenerator(createMiddlewareGenerator());
     registerGenerator(createServiceGenerator());
     registerGenerator(createExceptionGenerator());
+    registerGenerator(createJobGenerator());
+    registerGenerator(createMailGenerator());
+    registerGenerator(createStorageGenerator());
+    registerGenerator(createEventGenerator());
+    registerGenerator(createTaskGenerator());
     // Register auth generators
     registerGenerator(createGuardGenerator());
     registerGenerator(createPolicyGenerator());

package/dist/generators/generators/job.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Job Generator
+ *
+ * Scaffolds background job files for VeloxTS applications.
+ *
+ * Usage:
+ *   velox make job <name> [options]
+ *
+ * Examples:
+ *   velox make job send-email              # Simple job
+ *   velox make job process-payment --queue # Job with custom queue
+ *   velox make job import-data --retry     # Job with retry configuration
+ *   velox make job batch-export --progress # Job with progress tracking
+ */
+import { BaseGenerator } from '../base.js';
+import { type JobOptions } from '../templates/job.js';
+import type { GeneratorConfig, GeneratorMetadata, GeneratorOption, GeneratorOutput } from '../types.js';
+/**
+ * Job generator - creates background job files
+ */
+export declare class JobGenerator extends BaseGenerator<JobOptions> {
+    readonly metadata: GeneratorMetadata;
+    readonly options: ReadonlyArray<GeneratorOption>;
+    /**
+     * Validate and transform raw options
+     */
+    validateOptions(raw: Record<string, unknown>): JobOptions;
+    /**
+     * Generate job files
+     */
+    generate(config: GeneratorConfig<JobOptions>): Promise<GeneratorOutput>;
+}
+/**
+ * Factory function for creating a JobGenerator instance
+ */
+export declare function createJobGenerator(): JobGenerator;

package/dist/generators/generators/job.js

@@ -0,0 +1,98 @@
+/**
+ * Job Generator
+ *
+ * Scaffolds background job files for VeloxTS applications.
+ *
+ * Usage:
+ *   velox make job <name> [options]
+ *
+ * Examples:
+ *   velox make job send-email              # Simple job
+ *   velox make job process-payment --queue # Job with custom queue
+ *   velox make job import-data --retry     # Job with retry configuration
+ *   velox make job batch-export --progress # Job with progress tracking
+ */
+import { BaseGenerator } from '../base.js';
+import { getJobInstructions, getJobPath, jobTemplate } from '../templates/job.js';
+// ============================================================================
+// Generator Implementation
+// ============================================================================
+/**
+ * Job generator - creates background job files
+ */
+export class JobGenerator extends BaseGenerator {
+    metadata = {
+        name: 'job',
+        description: 'Generate background job definitions',
+        longDescription: `
+Scaffold background job definitions for VeloxTS applications.
+
+Jobs are background tasks that run asynchronously using the @veloxts/queue package.
+They support retry logic, progress tracking, and custom queue assignment.
+
+Examples:
+  velox make job send-email              # Simple job
+  velox make job process-payment --queue # Job with custom queue
+  velox make job import-data --retry     # Job with retry configuration
+  velox make job batch-export --progress # Job with progress tracking
+`,
+        aliases: ['j'],
+        category: 'infrastructure',
+    };
+    options = [
+        {
+            name: 'queue',
+            short: 'q',
+            description: 'Generate job with custom queue assignment',
+            type: 'boolean',
+            default: false,
+        },
+        {
+            name: 'retry',
+            short: 'r',
+            description: 'Generate job with retry/backoff configuration',
+            type: 'boolean',
+            default: false,
+        },
+        {
+            name: 'progress',
+            short: 'p',
+            description: 'Generate job with progress tracking',
+            type: 'boolean',
+            default: false,
+        },
+    ];
+    /**
+     * Validate and transform raw options
+     */
+    validateOptions(raw) {
+        return {
+            queue: Boolean(raw.queue ?? false),
+            retry: Boolean(raw.retry ?? false),
+            progress: Boolean(raw.progress ?? false),
+        };
+    }
+    /**
+     * Generate job files
+     */
+    async generate(config) {
+        const context = this.createContext(config);
+        const files = [];
+        // Generate job file
+        const jobContent = jobTemplate(context);
+        files.push({
+            path: getJobPath(config.entityName, config.project),
+            content: jobContent,
+        });
+        return {
+            files,
+            postInstructions: getJobInstructions(config.entityName, config.options),
+        };
+    }
+}
+/**
+ * Factory function for creating a JobGenerator instance
+ */
+export function createJobGenerator() {
+    return new JobGenerator();
+}

package/dist/generators/generators/mail.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Mail Generator
+ *
+ * Scaffolds email template files for VeloxTS applications.
+ *
+ * Usage:
+ *   velox make mail <name> [options]
+ *
+ * Examples:
+ *   velox make mail welcome                # React Email template
+ *   velox make mail password-reset         # React Email template
+ *   velox make mail notification --text    # Plain text email
+ *   velox make mail invoice --attachment   # Email with attachments
+ */
+import { BaseGenerator } from '../base.js';
+import { type MailOptions } from '../templates/mail.js';
+import type { GeneratorConfig, GeneratorMetadata, GeneratorOption, GeneratorOutput } from '../types.js';
+/**
+ * Mail generator - creates email template files
+ */
+export declare class MailGenerator extends BaseGenerator<MailOptions> {
+    readonly metadata: GeneratorMetadata;
+    readonly options: ReadonlyArray<GeneratorOption>;
+    /**
+     * Validate and transform raw options
+     */
+    validateOptions(raw: Record<string, unknown>): MailOptions;
+    /**
+     * Generate mail template files
+     */
+    generate(config: GeneratorConfig<MailOptions>): Promise<GeneratorOutput>;
+}
+/**
+ * Factory function for creating a MailGenerator instance
+ */
+export declare function createMailGenerator(): MailGenerator;

package/dist/generators/generators/mail.js

@@ -0,0 +1,90 @@
+/**
+ * Mail Generator
+ *
+ * Scaffolds email template files for VeloxTS applications.
+ *
+ * Usage:
+ *   velox make mail <name> [options]
+ *
+ * Examples:
+ *   velox make mail welcome                # React Email template
+ *   velox make mail password-reset         # React Email template
+ *   velox make mail notification --text    # Plain text email
+ *   velox make mail invoice --attachment   # Email with attachments
+ */
+import { BaseGenerator } from '../base.js';
+import { getMailInstructions, getMailPath, mailTemplate, } from '../templates/mail.js';
+// ============================================================================
+// Generator Implementation
+// ============================================================================
+/**
+ * Mail generator - creates email template files
+ */
+export class MailGenerator extends BaseGenerator {
+    metadata = {
+        name: 'mail',
+        description: 'Generate email templates with React Email',
+        longDescription: `
+Scaffold email templates for VeloxTS applications using React Email.
+
+Email templates use React components to build beautiful, responsive emails
+with type-safe data validation via Zod schemas.
+
+Examples:
+  velox make mail welcome                # React Email template
+  velox make mail password-reset         # React Email template
+  velox make mail notification --text    # Plain text email
+  velox make mail invoice --attachment   # Email with attachment support
+`,
+        aliases: ['email', 'em'],
+        category: 'infrastructure',
+    };
+    options = [
+        {
+            name: 'text',
+            short: 't',
+            description: 'Generate plain text email (no React)',
+            type: 'boolean',
+            default: false,
+        },
+        {
+            name: 'attachment',
+            short: 'a',
+            description: 'Generate email with attachment support',
+            type: 'boolean',
+            default: false,
+        },
+    ];
+    /**
+     * Validate and transform raw options
+     */
+    validateOptions(raw) {
+        return {
+            text: Boolean(raw.text ?? false),
+            attachment: Boolean(raw.attachment ?? false),
+        };
+    }
+    /**
+     * Generate mail template files
+     */
+    async generate(config) {
+        const context = this.createContext(config);
+        const files = [];
+        // Generate mail template file
+        const mailContent = mailTemplate(context);
+        files.push({
+            path: getMailPath(config.entityName, config.project, config.options),
+            content: mailContent,
+        });
+        return {
+            files,
+            postInstructions: getMailInstructions(config.entityName, config.options),
+        };
+    }
+}
+/**
+ * Factory function for creating a MailGenerator instance
+ */
+export function createMailGenerator() {
+    return new MailGenerator();
+}

package/dist/generators/generators/storage.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Storage Generator
+ *
+ * Scaffolds storage configuration and upload handler files for VeloxTS applications.
+ *
+ * Usage:
+ *   velox make storage <name> [options]
+ *
+ * Examples:
+ *   velox make storage avatar                # Local filesystem storage
+ *   velox make storage document --s3         # S3/R2/MinIO storage
+ *   velox make storage file --upload         # File upload handler
+ */
+import { BaseGenerator } from '../base.js';
+import { type StorageOptions } from '../templates/storage.js';
+import type { GeneratorConfig, GeneratorMetadata, GeneratorOption, GeneratorOutput } from '../types.js';
+/**
+ * Storage generator - creates storage configuration and upload handlers
+ */
+export declare class StorageGenerator extends BaseGenerator<StorageOptions> {
+    readonly metadata: GeneratorMetadata;
+    readonly options: ReadonlyArray<GeneratorOption>;
+    /**
+     * Validate and transform raw options
+     */
+    validateOptions(raw: Record<string, unknown>): StorageOptions;
+    /**
+     * Generate storage configuration or upload handler files
+     */
+    generate(config: GeneratorConfig<StorageOptions>): Promise<GeneratorOutput>;
+}
+/**
+ * Factory function for creating a StorageGenerator instance
+ */
+export declare function createStorageGenerator(): StorageGenerator;

package/dist/generators/generators/storage.js

@@ -0,0 +1,104 @@
+/**
+ * Storage Generator
+ *
+ * Scaffolds storage configuration and upload handler files for VeloxTS applications.
+ *
+ * Usage:
+ *   velox make storage <name> [options]
+ *
+ * Examples:
+ *   velox make storage avatar                # Local filesystem storage
+ *   velox make storage document --s3         # S3/R2/MinIO storage
+ *   velox make storage file --upload         # File upload handler
+ */
+import { BaseGenerator } from '../base.js';
+import { getStorageInstructions, getStoragePath, storageTemplate, } from '../templates/storage.js';
+// ============================================================================
+// Generator Implementation
+// ============================================================================
+/**
+ * Storage generator - creates storage configuration and upload handlers
+ */
+export class StorageGenerator extends BaseGenerator {
+    metadata = {
+        name: 'storage',
+        description: 'Generate storage configurations and upload handlers',
+        longDescription: `
+Scaffold storage configurations and file upload handlers for VeloxTS applications.
+
+Storage configurations support local filesystem, S3-compatible object storage (AWS S3,
+Cloudflare R2, MinIO), and complete upload/download handlers with validation.
+
+Examples:
+  velox make storage avatar                # Local filesystem storage config
+  velox make storage document --s3         # S3/R2/MinIO storage config
+  velox make storage file --upload         # Upload handler with storage integration
+  velox make storage media --local         # Explicit local storage
+`,
+        aliases: ['st', 'store'],
+        category: 'infrastructure',
+    };
+    options = [
+        {
+            name: 'local',
+            short: 'l',
+            description: 'Generate local filesystem storage configuration (default)',
+            type: 'boolean',
+            default: false,
+        },
+        {
+            name: 's3',
+            description: 'Generate S3/R2/MinIO storage configuration',
+            type: 'boolean',
+            default: false,
+        },
+        {
+            name: 'upload',
+            short: 'u',
+            description: 'Generate file upload handler with storage integration',
+            type: 'boolean',
+            default: false,
+        },
+    ];
+    /**
+     * Validate and transform raw options
+     */
+    validateOptions(raw) {
+        const local = Boolean(raw.local ?? false);
+        const s3 = Boolean(raw.s3 ?? false);
+        const upload = Boolean(raw.upload ?? false);
+        // Validate mutually exclusive options
+        const optionCount = [local, s3, upload].filter(Boolean).length;
+        if (optionCount > 1) {
+            throw new Error('Options --local, --s3, and --upload are mutually exclusive. Choose one.');
+        }
+        return {
+            local,
+            s3,
+            upload,
+        };
+    }
+    /**
+     * Generate storage configuration or upload handler files
+     */
+    async generate(config) {
+        const context = this.createContext(config);
+        const files = [];
+        // Generate storage file
+        const storageContent = storageTemplate(context);
+        files.push({
+            path: getStoragePath(config.entityName, config.project, config.options),
+            content: storageContent,
+        });
+        return {
+            files,
+            postInstructions: getStorageInstructions(config.entityName, config.options),
+        };
+    }
+}
+/**
+ * Factory function for creating a StorageGenerator instance
+ */
+export function createStorageGenerator() {
+    return new StorageGenerator();
+}

package/dist/generators/generators/task.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Task Generator
+ *
+ * Scaffolds scheduled task files for VeloxTS applications.
+ *
+ * Usage:
+ *   velox make task <name> [options]
+ *
+ * Examples:
+ *   velox make task cleanup-tokens          # Simple daily task
+ *   velox make task send-digest --callbacks # Task with success/failure callbacks
+ *   velox make task backup-db --no-overlap  # Task that prevents overlapping runs
+ *   velox make task report --constraints    # Task with time/day constraints
+ */
+import { BaseGenerator } from '../base.js';
+import { type TaskOptions } from '../templates/task.js';
+import type { GeneratorConfig, GeneratorMetadata, GeneratorOption, GeneratorOutput } from '../types.js';
+/**
+ * Task generator - creates scheduled task files
+ */
+export declare class TaskGenerator extends BaseGenerator<TaskOptions> {
+    readonly metadata: GeneratorMetadata;
+    readonly options: ReadonlyArray<GeneratorOption>;
+    /**
+     * Validate and transform raw options
+     */
+    validateOptions(raw: Record<string, unknown>): TaskOptions;
+    /**
+     * Generate task files
+     */
+    generate(config: GeneratorConfig<TaskOptions>): Promise<GeneratorOutput>;
+}
+/**
+ * Factory function for creating a TaskGenerator instance
+ */
+export declare function createTaskGenerator(): TaskGenerator;