@veloxts/cli 0.6.26 → 0.6.29

package/GUIDE.md

@@ -0,0 +1,239 @@
+# @veloxts/cli
+
+Command-line interface for VeloxTS Framework.
+
+## Installation
+
+Automatically installed when creating a new VeloxTS project:
+
+```bash
+npx create-velox-app my-app
+```
+
+Or add to an existing project:
+
+```bash
+npm install -D @veloxts/cli
+```
+
+## Commands
+
+### velox dev
+
+Start development server with Hot Module Replacement (HMR):
+
+```bash
+velox dev                # Start with HMR (default port: 3030)
+velox dev --port 4000    # Custom port
+velox dev --no-hmr       # Disable HMR
+velox dev --verbose      # Enable debug output
+```
+
+HMR features:
+- Fast, efficient reloads with sub-second restart times
+- Precise timing metrics (startup, reload, total uptime)
+- Smart error classification with actionable suggestions
+- Automatic `velox:ready` IPC integration
+
+Configure HMR boundaries in `package.json`:
+
+```json
+{
+  "hotHook": {
+    "boundaries": [
+      "src/procedures/**/*.ts",
+      "src/schemas/**/*.ts",
+      "src/handlers/**/*.ts"
+    ]
+  }
+}
+```
+
+Add server ready signal for accurate timing:
+
+```typescript
+await app.start();
+
+// Send ready signal to CLI
+if (process.send) {
+  process.send({ type: 'velox:ready' });
+}
+```
+
+### velox migrate
+
+Run database migrations using Prisma:
+
+```bash
+velox migrate           # Apply pending migrations
+velox migrate --force   # Force push schema (dev only)
+velox migrate --deploy  # Deploy migrations (production)
+```
+
+### velox db:seed
+
+Seed database with test or initial data:
+
+```bash
+velox db:seed              # Run all seeders
+velox db:seed UserSeeder   # Run specific seeder
+velox db:seed --fresh      # Truncate tables first
+velox db:seed --dry-run    # Preview without executing
+velox db:seed --verbose    # Show debug output
+```
+
+### velox make
+
+Generate code from templates:
+
+```bash
+velox make procedure users  # Scaffold procedure
+velox make schema user      # Scaffold Zod schema
+velox make seeder user      # Scaffold database seeder
+velox make factory user     # Scaffold model factory
+```
+
+## Database Seeding
+
+### Creating Seeders
+
+```bash
+velox make seeder user
+```
+
+Creates `src/database/seeders/UserSeeder.ts`:
+
+```typescript
+import type { Seeder, SeederContext } from '@veloxts/cli';
+
+export const UserSeeder: Seeder = {
+  name: 'UserSeeder',
+  dependencies: [],
+  environments: ['development', 'test'],
+
+  async run({ db, factory, log }) {
+    log.info('Seeding users...');
+
+    await db.user.createMany({
+      data: [
+        { email: 'admin@example.com', name: 'Admin', role: 'admin' },
+        { email: 'user@example.com', name: 'User', role: 'user' },
+      ],
+    });
+
+    log.success('Created 2 users');
+  },
+
+  async truncate({ db, log }) {
+    await db.user.deleteMany();
+  },
+};
+```
+
+### Creating Factories
+
+```bash
+velox make factory user
+```
+
+Creates `src/database/factories/UserFactory.ts`:
+
+```typescript
+import { BaseFactory, type PrismaClientLike } from '@veloxts/cli';
+import { faker } from '@faker-js/faker';
+
+export class UserFactory extends BaseFactory<UserInput> {
+  readonly modelName = 'user';
+
+  constructor(prisma: PrismaClientLike) {
+    super(prisma);
+
+    this.registerState('admin', (attrs) => ({
+      ...attrs,
+      role: 'admin',
+    }));
+  }
+
+  definition(): UserInput {
+    return {
+      email: faker.internet.email(),
+      name: faker.person.fullName(),
+      role: 'user',
+    };
+  }
+}
+```
+
+Usage in seeders:
+
+```typescript
+async run({ factory, log }) {
+  // Create 50 users
+  await factory.get(UserFactory).createMany(50);
+
+  // Create 5 admins
+  await factory.get(UserFactory)
+    .state('admin')
+    .createMany(5);
+}
+```
+
+### Seeder Dependencies
+
+Ensure correct execution order:
+
+```typescript
+export const PostSeeder: Seeder = {
+  name: 'PostSeeder',
+  dependencies: ['UserSeeder'], // Runs after UserSeeder
+
+  async run({ db, factory, log }) {
+    const users = await db.user.findMany();
+
+    for (const user of users) {
+      await factory.get(PostFactory).createMany(5, {
+        authorId: user.id,
+      });
+    }
+  },
+};
+```
+
+## HMR Configuration
+
+Add to `package.json`:
+
+```json
+{
+  "hotHook": {
+    "boundaries": [
+      "src/procedures/**/*.ts",
+      "src/schemas/**/*.ts",
+      "src/config/**/*.ts"
+    ]
+  }
+}
+```
+
+Add graceful shutdown:
+
+```typescript
+const shutdown = async () => {
+  await prisma.$disconnect();
+  process.exit(0);
+};
+
+process.on('SIGTERM', shutdown);
+process.on('SIGINT', shutdown);
+```
+
+## Learn More
+
+- [@veloxts/core](https://www.npmjs.com/package/@veloxts/core) - Application framework
+- [@veloxts/router](https://www.npmjs.com/package/@veloxts/router) - Procedures
+- [@veloxts/orm](https://www.npmjs.com/package/@veloxts/orm) - Database
+- [VeloxTS Framework](https://www.npmjs.com/package/@veloxts/velox) - Complete framework
+
+## License
+
+MIT

package/dist/cli.js

@@ -15,6 +15,7 @@ import { createIntrospectCommand } from './commands/introspect.js';
 import { createMakeCommand } from './commands/make.js';
 import { createMigrateCommand } from './commands/migrate.js';
 import { createProceduresCommand } from './commands/procedures.js';
+import { createTenantCommand } from './commands/tenant.js';
 import { CLI_VERSION } from './index.js';
 /**
  * Create the main CLI program
@@ -33,6 +34,7 @@ function createCLI() {
     program.addCommand(createMakeCommand());
     program.addCommand(createMigrateCommand());
     program.addCommand(createProceduresCommand());
+    program.addCommand(createTenantCommand());
     return program;
 }
 /**

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;GAEG;AACH,SAAS,SAAS;IAChB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,OAAO,CAAC;SACb,WAAW,CAAC,sEAAsE,CAAC;SACnF,OAAO,CAAC,WAAW,EAAE,eAAe,EAAE,4BAA4B,CAAC;SACnE,UAAU,CAAC,YAAY,EAAE,0BAA0B,CAAC,CAAC;IAExD,oBAAoB;IACpB,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAE9C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;IAE5B,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC7C,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;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;GAEG;AACH,SAAS,SAAS;IAChB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,OAAO,CAAC;SACb,WAAW,CAAC,sEAAsE,CAAC;SACnF,OAAO,CAAC,WAAW,EAAE,eAAe,EAAE,4BAA4B,CAAC;SACnE,UAAU,CAAC,YAAY,EAAE,0BAA0B,CAAC,CAAC;IAExD,oBAAoB;IACpB,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAE1C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;IAE5B,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,cAAc;AACd,IAAI,EAAE,CAAC"}

package/dist/commands/tenant.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Tenant command - Multi-tenancy management commands
+ *
+ * Provides subcommands for managing tenant schemas:
+ * - tenant:create - Create a new tenant with PostgreSQL schema
+ * - tenant:list - List all tenants
+ * - tenant:migrate - Run migrations on tenant schemas
+ * - tenant:status - Show tenant status
+ * - tenant:suspend - Suspend a tenant
+ * - tenant:activate - Activate a suspended tenant
+ *
+ * SECURITY: All SQL queries use parameterized queries to prevent SQL injection
+ */
+import { Command } from 'commander';
+/**
+ * Create the tenant command with subcommands
+ */
+export declare function createTenantCommand(): Command;
+//# sourceMappingURL=tenant.d.ts.map

package/dist/commands/tenant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant.d.ts","sourceRoot":"","sources":["../../src/commands/tenant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAszBpC;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAW7C"}