@elysiumjs/styx 0.5.0 → 0.6.0

package/src/commands/make_service.ts

@@ -1,201 +0,0 @@
-// Copyright (c) 2025-present Workbud Technologies Inc. All rights reserved.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import type { PromptObject } from 'prompts';
-
-import { join } from 'node:path';
-
-import { Command, CommandArgumentType } from '@elysiumjs/core';
-import prompts from 'prompts';
-import { snake } from 'radash';
-import formatter from 'string-template';
-
-import { getModulePath, parseProjectConfig } from '../config';
-import { getRootPath } from '../utils';
-
-/**
- * Maker command for creating Elysium services.
- * @author Axel Nana <axel.nana@workbud.com>
- */
-export class MakeServiceCommand extends Command {
-	public static readonly command: string = 'make:service';
-	public static readonly description: string = 'Creates a new service.';
-
-	@Command.arg({
-		description: 'The name of the service to create',
-		type: CommandArgumentType.STRING
-	})
-	private name?: string;
-
-	@Command.arg({
-		description: 'The module where the service will be created',
-		type: CommandArgumentType.STRING
-	})
-	private module?: string;
-
-	@Command.arg({
-		description: 'The alias of the service to create',
-		type: CommandArgumentType.STRING
-	})
-	private alias?: string;
-
-	@Command.arg({
-		description: 'Create a factory service',
-		type: CommandArgumentType.BOOLEAN,
-		default: false
-	})
-	private factory: boolean = false;
-
-	@Command.arg({
-		description: 'Create a singleton service',
-		type: CommandArgumentType.BOOLEAN,
-		default: false
-	})
-	private singleton: boolean = false;
-
-	public async run(): Promise<void> {
-		if (!this.name) {
-			return this.setup();
-		}
-
-		const config = await parseProjectConfig();
-
-		const answers: Record<string, any> = {
-			module: this.module,
-			name: this.name,
-			alias: this.alias,
-			scope: this.factory ? 'FACTORY' : this.singleton ? 'SINGLETON' : 'SINGLETON'
-		};
-
-		if (!answers.module && !config.mono) {
-			const module = await prompts({
-				type: 'select',
-				name: 'module',
-				message: 'Module:',
-				choices: Object.keys(config.modules ?? {}).map((moduleName) => ({
-					title: moduleName,
-					value: moduleName
-				}))
-			});
-
-			answers.module = module.module;
-		}
-
-		return this.build(answers);
-	}
-
-	private async setup(): Promise<void> {
-		const config = await parseProjectConfig();
-
-		const items: PromptObject[] = [
-			{
-				type() {
-					return config.mono ? null : 'select';
-				},
-				name: 'module',
-				message: 'Module:',
-				choices() {
-					return Object.keys(config.modules ?? {}).map((moduleName) => ({
-						title: moduleName,
-						value: moduleName
-					}));
-				}
-			},
-			{
-				type: 'text',
-				name: 'name',
-				message: 'Service Name:',
-				initial: 'UserService',
-				validate(value: string) {
-					if (value.length < 1) {
-						return 'Service name cannot be empty';
-					}
-
-					return true;
-				}
-			},
-			{
-				type: 'text',
-				name: 'alias',
-				message: 'Service Alias:',
-				initial(_, values) {
-					return values.name;
-				},
-				validate(value: string) {
-					if (value.length < 1) {
-						return 'Service alias cannot be empty';
-					}
-
-					return true;
-				}
-			},
-			{
-				type: 'select',
-				name: 'scope',
-				message: 'Service Scope:',
-				choices: [
-					{
-						title: 'SINGLETON',
-						value: 'SINGLETON',
-						description: 'A single instance of the service is created.'
-					},
-					{
-						title: 'FACTORY',
-						value: 'FACTORY',
-						description: 'A new instance of the service is created each time it is injected.'
-					}
-				]
-			}
-		];
-
-		const answers = await prompts(items, {
-			onCancel: () => {
-				this.error('Operation cancelled.');
-				process.exit(0);
-			}
-		});
-
-		return this.build(answers);
-	}
-
-	private async build(answers: Record<string, any>): Promise<void> {
-		if (!answers.name) {
-			this.error('Operation cancelled.');
-			return;
-		}
-
-		if (!answers.name.endsWith('Service')) {
-			answers.name += 'Service';
-		}
-
-		if (!answers.alias) {
-			answers.alias = answers.name;
-		}
-
-		// Get stub file
-		const stubFile = Bun.file(join(getRootPath(), 'stubs/service.stub'));
-
-		// Format the stub content
-		const stub = formatter(await stubFile.text(), answers);
-
-		const path = answers.module ? await getModulePath(answers.module) : './src';
-
-		// Write to file
-		const name = snake(answers.name.replace('Service', ''));
-		const file = Bun.file(`${path}/services/${name}.service.ts`);
-		await file.write(stub);
-
-		this.success(`Service ${this.bold(file.name!)} created successfully.`);
-	}
-}

package/src/commands/make_validator.ts

@@ -1,147 +0,0 @@
-// Copyright (c) 2025-present Workbud Technologies Inc. All rights reserved.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import type { PromptObject } from 'prompts';
-
-import { join } from 'node:path';
-
-import { Command, CommandArgumentType } from '@elysiumjs/core';
-import prompts from 'prompts';
-import { snake } from 'radash';
-import formatter from 'string-template';
-
-import { getModulePath, parseProjectConfig } from '../config';
-import { getRootPath } from '../utils';
-
-/**
- * Maker command for creating Elysium validators.
- * @author Axel Nana <axel.nana@workbud.com>
- */
-export class MakeValidatorCommand extends Command {
-	public static readonly command: string = 'make:validator';
-	public static readonly description: string = 'Creates a new validator.';
-
-	@Command.arg({
-		description: 'The name of the validator to create',
-		type: CommandArgumentType.STRING
-	})
-	private name?: string;
-
-	@Command.arg({
-		description: 'The module where the validator will be created',
-		type: CommandArgumentType.STRING
-	})
-	private module?: string;
-
-	public async run(): Promise<void> {
-		if (!this.name) {
-			return this.setup();
-		}
-
-		const config = await parseProjectConfig();
-
-		const answers: Record<string, any> = {
-			module: this.module,
-			name: this.name
-		};
-
-		if (!answers.module && !config.mono) {
-			const module = await prompts({
-				type: 'select',
-				name: 'module',
-				message: 'Module:',
-				choices: Object.keys(config.modules ?? {}).map((moduleName) => ({
-					title: moduleName,
-					value: moduleName
-				}))
-			});
-
-			answers.module = module.module;
-		}
-
-		return this.build(answers);
-	}
-
-	private async setup(): Promise<void> {
-		const config = await parseProjectConfig();
-
-		const items: PromptObject[] = [
-			{
-				type() {
-					return config.mono ? null : 'select';
-				},
-				name: 'module',
-				message: 'Module:',
-				choices() {
-					return Object.keys(config.modules ?? {}).map((moduleName) => ({
-						title: moduleName,
-						value: moduleName
-					}));
-				}
-			},
-			{
-				type: 'text',
-				name: 'name',
-				message: 'Validator Name:',
-				initial: 'LoginValidator',
-				validate(value: string) {
-					if (value.length < 1) {
-						return 'Validator name cannot be empty';
-					}
-
-					return true;
-				}
-			}
-		];
-
-		const answers = await prompts(items, {
-			onCancel: () => {
-				this.error('Operation cancelled.');
-				process.exit(0);
-			}
-		});
-
-		return this.build(answers);
-	}
-
-	private async build(answers: Record<string, any>): Promise<void> {
-		if (!answers.name) {
-			this.error('Operation cancelled.');
-			return;
-		}
-
-		if (!answers.name.endsWith('Validator')) {
-			answers.name += 'Validator';
-		}
-
-		if (!answers.request_name) {
-			answers.request_name = answers.name.replace('Validator', 'Request');
-		}
-
-		// Get stub file
-		const stubFile = Bun.file(join(getRootPath(), 'stubs/validator.stub'));
-
-		// Format the stub content
-		const stub = formatter(await stubFile.text(), answers);
-
-		const path = answers.module ? await getModulePath(answers.module) : './src';
-
-		// Write to file
-		const name = snake(answers.name.replace('Validator', ''));
-		const file = Bun.file(`${path}/validators/${name}.validator.ts`);
-		await file.write(stub);
-
-		this.success(`Validator ${this.bold(file.name!)} created successfully.`);
-	}
-}

package/src/commands/migration_generate.ts

@@ -1,80 +0,0 @@
-// Copyright (c) 2025-present Workbud Technologies Inc. All rights reserved.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import { exists } from 'node:fs/promises';
-
-import { Command, CommandArgumentType } from '@elysiumjs/core';
-import prompts from 'prompts';
-
-import { getProjectPath } from '../utils';
-
-/**
- * Generates migration files.
- * @author Axel Nana <axel.nana@workbud.com>
- */
-export class MigrationGenerateCommand extends Command {
-	public static readonly command: string = 'migration:generate';
-	public static readonly description: string = 'Generates migration files.';
-
-	@Command.arg({
-		description: 'The name of the migration to create',
-		type: CommandArgumentType.STRING
-	})
-	private name?: string;
-
-	public async run(): Promise<void> {
-		if (!this.name) {
-			const answers = await prompts(
-				[
-					{
-						type: 'text',
-						name: 'name',
-						message: 'Migration Name:',
-						initial: 'create_users_table',
-						validate(value: string) {
-							if (value.length < 1) {
-								return 'Migration name cannot be empty';
-							}
-
-							return true;
-						}
-					}
-				],
-				{
-					onCancel: () => {
-						this.error('Operation cancelled.');
-						process.exit(0);
-					}
-				}
-			);
-
-			this.name = answers.name;
-		}
-
-		const projectRoot = getProjectPath();
-		let schemaPath = `${projectRoot}/src/database/schemas`;
-		if (await exists(`${projectRoot}/src/database/schema.ts`)) {
-			schemaPath = `${projectRoot}/src/database/schema.ts`;
-		}
-
-		await Bun.$`bunx --bun drizzle-kit generate --dialect postgresql --schema ${schemaPath} --out ${projectRoot}/src/database/migrations --prefix timestamp --name ${this.name}`;
-
-		const sqlFiles = new Bun.Glob(`${projectRoot}/src/database/migrations/**/*.sql`).scan();
-		for await (const path of sqlFiles) {
-			const file = Bun.file(path);
-			const content = await file.text();
-			await file.write(content.replace(/"public"\./gm, ''));
-		}
-	}
-}

package/src/commands/migration_run.ts

@@ -1,153 +0,0 @@
-// Copyright (c) 2025-present Workbud Technologies Inc. All rights reserved.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import { basename } from 'node:path';
-
-import { Command, CommandArgumentType, Database } from '@elysiumjs/core';
-import prompts from 'prompts';
-import { alphabetical } from 'radash';
-
-/**
- * Execute migration files.
- * @author Axel Nana <axel.nana@workbud.com>
- */
-export class MigrationRunCommand extends Command {
-	public static readonly command: string = 'migration:run';
-	public static readonly description: string = 'Generates migration files.';
-
-	@Command.arg({
-		description: 'The name of the tenant in which the migrations will be executed.',
-		type: CommandArgumentType.STRING,
-		required: true
-	})
-	private tenant: string = '';
-
-	@Command.arg({
-		description: 'The name of the connection to use.',
-		type: CommandArgumentType.STRING,
-		default: 'default'
-	})
-	private connection: string = 'default';
-
-	@Command.arg({
-		description: 'Drop the entire schema before running the migrations.',
-		type: CommandArgumentType.BOOLEAN,
-		default: false
-	})
-	private fresh: boolean = false;
-
-	public async run(): Promise<void> {
-		if (!Database.connectionExists(this.connection)) {
-			this.error(`Connection ${this.bold(this.connection)} does not exist.`);
-			return process.exit(1);
-		}
-
-		const sql = Database.getConnection(this.connection).$client;
-		await sql.connect();
-
-		await sql.begin(async (sql) => {
-			if (this.fresh) {
-				await sql`DROP SCHEMA IF EXISTS ${sql(this.tenant)} CASCADE;`;
-				await sql`CREATE SCHEMA ${sql(this.tenant)};`;
-			}
-
-			const [{ schema_exists }] = await sql`SELECT EXISTS (
-			SELECT schema_name
-			  FROM information_schema.schemata
-			 WHERE schema_name = ${this.tenant}
-		) AS schema_exists;`;
-
-			if (!schema_exists) {
-				const answers = await prompts(
-					[
-						{
-							type: 'confirm',
-							name: 'create',
-							message: `Schema ${this.tenant} does not exist. Do you want to create it?`,
-							initial: true
-						}
-					],
-					{
-						onCancel: () => {
-							this.error('Operation cancelled.');
-							process.exit(0);
-						}
-					}
-				);
-
-				if (answers.create) {
-					await sql`CREATE SCHEMA ${sql(this.tenant)};`;
-				} else {
-					this.error(`Schema ${this.bold(this.tenant)} creation cancelled.`);
-					return process.exit(1);
-				}
-			}
-
-			await sql`SET search_path TO ${sql(this.tenant)};`;
-
-			const [{ table_exists }] = await sql`SELECT EXISTS (
-			SELECT *
-			  FROM information_schema.tables
-			 WHERE table_name = 'elysium_migrations'
-			   AND table_schema = ${this.tenant}
-		) AS table_exists;`;
-
-			if (!table_exists) {
-				await sql`CREATE TABLE elysium_migrations (
-				id SERIAL PRIMARY KEY,
-				name TEXT NOT NULL,
-				batch INTEGER NOT NULL,
-				applied_at TIMESTAMP NOT NULL
-			);`;
-			}
-
-			const migrations: { name: string }[] = await sql`SELECT name FROM elysium_migrations;`;
-			const completedMigrations = migrations.map((row) => row.name);
-
-			const filesIt = new Bun.Glob(`./src/database/migrations/**/*.sql`).scan({
-				absolute: true,
-				onlyFiles: true
-			});
-
-			const files = await Array.fromAsync(filesIt);
-			const sqlFiles = alphabetical(
-				files.filter((file) => !completedMigrations.includes(basename(file))),
-				(file) => file
-			);
-
-			if (sqlFiles.length === 0) {
-				this.success('No new migrations to apply.');
-				return;
-			}
-
-			const s = this.spinner(`Running migrations for tenant ${this.bold(this.tenant)}...`);
-
-			const [{ max }]: [{ max?: number }] =
-				await sql`SELECT MAX(batch) + 1 AS max FROM elysium_migrations;`;
-
-			const batch = max ?? 0;
-
-			for (const path of sqlFiles) {
-				await sql.file(path);
-				const [{ name }] =
-					await sql`INSERT INTO elysium_migrations (name, batch, applied_at) VALUES (${basename(path)}, ${batch}, ${new Date()}) RETURNING name;`;
-				s.pause(`Migration ${this.bold(name)} applied successfully.`);
-			}
-
-			s.complete(`Migrations for tenant ${this.bold(this.tenant)} applied successfully.`);
-		});
-
-		await sql.close();
-	}
-}

package/src/commands/module_new.ts

@@ -1,112 +0,0 @@
-// Copyright (c) 2025-present Workbud Technologies Inc. All rights reserved.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import { exists, rmdir } from 'node:fs/promises';
-import { join } from 'node:path';
-
-import { Command, CommandArgumentType } from '@elysiumjs/core';
-import prompts from 'prompts';
-import { snake } from 'radash';
-
-import { parseProjectConfig } from '../config';
-import { createModule, getProjectPath } from '../utils';
-
-/**
- * Command for creating Elysium.js modules.
- * @author Axel Nana <axel.nana@workbud.com>
- */
-export class ModuleNewCommand extends Command {
-	public static readonly command: string = 'module:new';
-	public static readonly description: string = 'Creates a new module.';
-
-	@Command.arg({
-		description: 'The name of the module to create',
-		type: CommandArgumentType.STRING
-	})
-	private name?: string;
-
-	private module?: string;
-	private convert: boolean = false;
-
-	public override async run(): Promise<void> {
-		const config = await parseProjectConfig();
-
-		// 1. Prompt for new module name if not provided
-		if (!this.name) {
-			const name = await prompts(
-				{
-					type: 'text',
-					name: 'name',
-					message: 'New module name:',
-					initial: 'module',
-					validate(value) {
-						return value.length > 0 ? true : 'Module name cannot be empty';
-					}
-				},
-				{
-					onCancel: () => process.exit(0)
-				}
-			);
-
-			this.name = snake(name.name);
-		}
-
-		// 2. If mono-module, prompt for conversion and current module name
-		if (config.mono) {
-			const { module, convert } = await prompts(
-				[
-					{
-						type: 'confirm',
-						name: 'convert',
-						message:
-							'This project is a mono-module project. Do you want to convert it to a multi-module project?',
-						initial: false
-					},
-					{
-						type: (convert) => (convert ? 'text' : null),
-						name: 'module',
-						message: 'Current module name:',
-						initial: 'main',
-						validate(value) {
-							return value.length > 0 ? true : 'Module name cannot be empty';
-						}
-					}
-				],
-				{
-					onCancel: () => process.exit(0)
-				}
-			);
-
-			if (!convert) return this.error('Operation cancelled. The project is left unchanged.');
-
-			this.module = snake(module as string);
-			this.convert = convert;
-		}
-
-		// 3. If multi-module conversion is enabled, convert the project to a multi-module project
-		if (this.convert) {
-			const modulesDir = join(getProjectPath(), 'src', 'modules');
-			if (await exists(modulesDir)) await rmdir(modulesDir, { recursive: true });
-
-			await createModule(this.module!, 'root');
-
-			this.success(`Project converted to multi-module.`);
-			this.success(`Module '${this.module}' created.`);
-		}
-
-		// 4. Create the new module
-		await createModule(this.name);
-		this.success(`Module '${this.name}' created.`);
-	}
-}