@elysiumjs/styx 0.3.0 → 0.5.0

package/README.md

@@ -1,6 +1,6 @@
 # @elysiumjs/styx
 
-CLI tool for Elysium.
+CLI tool for Elysium.js framework.
 
 ## Installation
 
@@ -10,34 +10,45 @@ bun install @elysiumjs/styx
 
 ## Usage
 
-The `styx` command needs to be run from the root of your Elysium project.
+The `styx` command needs to be run inside an Elysium.js project.
 
 To create new items:
 
 ```bash
-bun styx exec make:controller [options]
-bun styx exec make:job [options]
-bun styx exec make:middleware [options]
-bun styx exec make:service [options]
-bun styx exec make:command [options]
+bun styx make:command [options]
+bun styx make:controller [options]
+bun styx make:job [options]
+bun styx make:middleware [options]
+bun styx make:model [options]
+bun styx make:repository [options]
+bun styx make:service [options]
+bun styx make:validator [options]
 ```
 
-To start the Elysium project:
+To manage migrations:
 
 ```bash
-bun styx serve
+bun styx migration:generate [options]
+bun styx migration:run [options]
 ```
 
-To execute a custom command:
+To manage modules:
+
+```bash
+bun styx module:new [options]
+bun styx module:rename [options]
+```
+
+To start the Elysium.js project:
 
 ```bash
-bun styx exec <command>
+bun styx serve
 ```
 
-To run a worker:
+To execute a custom command:
 
 ```bash
-bun styx work --queue queue1 --queue queue2
+bun styx <command>
 ```
 
 To show all available commands:
@@ -60,4 +71,4 @@ Feel free to open issues for any bugs or questions you may have. Pull requests a
 
 ## License
 
-This project is licensed under the Apache License, Version 2.0. See the [LICENSE](LICENSE) file for more information.
+This project is licensed under the Apache License, Version 2.0. See the [LICENSE](https://github.com/workbud/elysium/blob/main/LICENSE) file for more information.

package/package.json

@@ -1,39 +1,38 @@
 {
 	"name": "@elysiumjs/styx",
-	"version": "0.3.0",
+	"version": "0.5.0",
 	"license": "Apache-2.0",
-	"description": "The CLI tool for the Elysium framework.",
+	"description": "The CLI tool for the Elysium.js framework.",
 	"private": false,
-	"author": {
-		"name": "Axel Nana",
-		"email": "axel.nana@workbud.com"
-	},
+	"author": "Workbud Technologies Inc.",
 	"repository": {
 		"type": "git",
-		"url": "https://github.com/Workerly/elysium"
+		"url": "https://github.com/workbud/elysium"
 	},
-	"homepage": "https://github.com/Workerly/elysium",
+	"homepage": "https://github.com/workbud/elysium",
 	"scripts": {
 		"format": "prettier --write \"./src/**/*.ts\"",
-		"build": "bun build index.ts --outfile=styx.js --target bun --minify -e @elysiumjs/core"
+		"build": "bun build ./src/styx.ts --outdir=./ --root ./src --target bun --minify -e @elysiumjs/core -e reflect-metadata",
+		"prepublishOnly": "bun run build"
 	},
 	"keywords": [
 		"elysium",
 		"framework",
 		"web",
 		"api",
-		"typescript"
+		"typescript",
+		"cli"
 	],
 	"type": "module",
 	"bin": {
 		"styx": "./styx.js"
 	},
 	"devDependencies": {
-		"@ianvs/prettier-plugin-sort-imports": "^4.4.1",
+		"@ianvs/prettier-plugin-sort-imports": "^4.4.2",
 		"@types/bun": "latest",
 		"@types/prompts": "^2.4.9",
 		"@types/string-template": "^1.0.6",
-		"type-fest": "^4.40.1",
+		"type-fest": "^4.41.0",
 		"prompts": "^2.4.2",
 		"radash": "^12.1.0",
 		"string-template": "^1.0.0"

package/src/commands/make_command.ts

@@ -0,0 +1,172 @@
+// 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 { pascal, snake } from 'radash';
+import formatter from 'string-template';
+
+import { getModulePath, parseProjectConfig } from '../config';
+import { getRootPath } from '../utils';
+
+/**
+ * Maker class for creating Elysium.js commands.
+ * @author Axel Nana <axel.nana@workbud.com>
+ */
+export class MakeCommandCommand extends Command {
+	public static readonly command: string = 'make:command';
+	public static readonly description: string = 'Creates a new command.';
+
+	@Command.arg({
+		description: 'The name of the command to create',
+		type: CommandArgumentType.STRING
+	})
+	private name?: string;
+
+	@Command.arg({
+		description: 'The module where the command will be created',
+		type: CommandArgumentType.STRING
+	})
+	private module?: string;
+
+	@Command.arg({
+		description: 'The command to create',
+		type: CommandArgumentType.STRING
+	})
+	private command?: string;
+
+	@Command.arg({
+		description: 'The description of the command',
+		type: CommandArgumentType.STRING
+	})
+	private description?: string;
+
+	public async run(): Promise<void> {
+		if (!this.command || !this.name) {
+			return this.setup();
+		}
+
+		const config = await parseProjectConfig();
+
+		const answers: Record<string, any> = {
+			module: this.module,
+			name: this.name,
+			command: this.command,
+			description: this.description
+		};
+
+		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: 'command',
+				message: 'Command Name:',
+				initial: 'user:say',
+				validate(value: string) {
+					if (value.length < 1) {
+						return 'Command name cannot be empty';
+					}
+
+					return true;
+				}
+			},
+			{
+				type: 'text',
+				name: 'description',
+				message: 'Command Description:',
+				initial: 'Say something',
+				validate(value: string) {
+					if (value.length < 1) {
+						return 'Command description cannot be empty';
+					}
+
+					return true;
+				}
+			}
+		];
+
+		const answers = await prompts(items, {
+			onCancel: () => {
+				this.error('Operation cancelled.');
+				process.exit(0);
+			}
+		});
+
+		answers.name = pascal(answers.command.replaceAll(':', '_'));
+
+		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('Command')) {
+			answers.name += 'Command';
+		}
+
+		// Get stub file
+		const stubFile = Bun.file(join(getRootPath(), 'stubs/command.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('Command', ''));
+		const file = Bun.file(`${path}/commands/${name}.command.ts`);
+		await file.write(stub);
+
+		this.success(`Command ${this.bold(file.name!)} created successfully.`);
+	}
+}

package/src/commands/make_controller.ts

@@ -0,0 +1,277 @@
+// 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 class for creating Elysium.js controllers.
+ * @author Axel Nana <axel.nana@workbud.com>
+ */
+export class MakeControllerCommand extends Command {
+	public static readonly command: string = 'make:controller';
+	public static readonly description: string = 'Creates a new controller.';
+
+	@Command.arg({
+		description: 'The name of the controller to create',
+		type: CommandArgumentType.STRING
+	})
+	private name?: string;
+
+	@Command.arg({
+		description: 'The module where the controller will be created',
+		type: CommandArgumentType.STRING
+	})
+	private module?: string;
+
+	@Command.arg({
+		description: 'Whether to create a HTTP controller',
+		type: CommandArgumentType.BOOLEAN,
+		default: false
+	})
+	private http: boolean = false;
+
+	@Command.arg({
+		description: 'Whether to create a WAMP controller',
+		type: CommandArgumentType.BOOLEAN,
+		default: false
+	})
+	private wamp: boolean = false;
+
+	@Command.arg({
+		description: 'Whether to create a WebSocket controller',
+		type: CommandArgumentType.BOOLEAN,
+		default: false
+	})
+	private ws: boolean = false;
+
+	@Command.arg({
+		description: 'Whether to create a SERVER scope controller',
+		type: CommandArgumentType.BOOLEAN,
+		default: false
+	})
+	private server: boolean = false;
+
+	@Command.arg({
+		description: 'Whether to create a REQUEST scope controller',
+		type: CommandArgumentType.BOOLEAN,
+		default: false
+	})
+	private request: boolean = false;
+
+	@Command.arg({
+		description: 'The path or URL of the controller',
+		type: CommandArgumentType.STRING
+	})
+	private path: string = '/users';
+
+	@Command.arg({
+		description: 'The realm of the controller (only applicable to WAMP controllers)',
+		type: CommandArgumentType.STRING
+	})
+	private realm?: string;
+
+	public async run(): Promise<void> {
+		if (!this.name) {
+			return this.setup();
+		}
+
+		const config = await parseProjectConfig();
+
+		const answers: Record<string, any> = {
+			module: this.module,
+			type: 'http',
+			scope: 'SERVER',
+			name: this.name,
+			path: this.path,
+			realm: this.realm ?? 'realm1'
+		};
+
+		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;
+		}
+
+		if (this.http) {
+			answers.type = 'http';
+		} else if (this.wamp) {
+			answers.type = 'wamp';
+		} else if (this.ws) {
+			answers.type = 'ws';
+		}
+
+		if (this.server) {
+			answers.scope = 'SERVER';
+		} else if (this.request) {
+			answers.scope = 'REQUEST';
+		}
+
+		return this.build(answers);
+	}
+
+	private async setup(): Promise<void> {
+		let mode: 'http' | 'wamp' | 'ws' = 'http';
+
+		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: 'select',
+				name: 'type',
+				message: 'Controller Type:',
+				choices: [
+					{ title: 'HTTP', value: 'http' },
+					{ title: 'WAMP', value: 'wamp' },
+					{ title: 'WebSocket', value: 'ws' }
+				]
+			},
+			{
+				type: 'text',
+				name: 'name',
+				message: 'Controller Name:',
+				initial: 'UserController',
+				validate: (value: string) => {
+					if (value.length < 1) {
+						return 'Controller name cannot be empty';
+					}
+
+					return true;
+				}
+			},
+			{
+				type: 'text',
+				name: 'path',
+				message(_prev, values) {
+					mode = values.type;
+					return values.type === 'wamp' ? 'Controller URL' : 'Controller Path:';
+				},
+				initial(_prev, values) {
+					return values.type === 'wamp' ? 'ws://localhost:8000' : '/users';
+				},
+				validate(value) {
+					if (mode === 'wamp') {
+						return value.match(/^wss?:\/\//) ? true : 'The URL must start with ws:// or wss://';
+					}
+
+					if (value[0] !== '/') {
+						return 'The path must start with a slash (/)';
+					}
+
+					return true;
+				}
+			},
+			{
+				type(_prev, values) {
+					return values.type === 'http' ? 'select' : null;
+				},
+				name: 'scope',
+				message: 'Controller Scope:',
+				choices: [
+					{
+						title: 'SERVER',
+						value: 'SERVER',
+						description:
+							'An unique instance of the controller is created for the entire lifecycle of the server.'
+					},
+					{
+						title: 'REQUEST',
+						value: 'REQUEST',
+						description: 'An instance of the controller is created for each request.'
+					}
+				]
+			},
+			{
+				type(_prev, values) {
+					return values.type === 'wamp' ? 'text' : null;
+				},
+				name: 'realm',
+				message: 'Controller Realm:',
+				initial: 'realm1',
+				validate(value) {
+					if (value.length < 1) {
+						return 'Realm 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.type || !answers.name || !answers.path) {
+			this.error('Operation cancelled.');
+			return;
+		}
+
+		if (!answers.name.endsWith('Controller')) {
+			answers.name += 'Controller';
+		}
+
+		// Get stub file
+		const stubFile = Bun.file(join(getRootPath(), `stubs/${answers.type}.controller.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('Controller', ''));
+		const file = Bun.file(`${path}/controllers/${answers.type}/${name}.controller.ts`);
+		await file.write(stub);
+
+		this.success(`Controller ${this.bold(file.name!)} created successfully.`);
+	}
+}