meocord 1.3.1 → 1.3.2

package/README.md

@@ -10,13 +10,12 @@ While still growing, MeoCord provides a solid foundation for developers to creat
 
 - [Features](#features)
 - [Getting Started](#getting-started)
+  - [Prerequisites](#prerequisites)
+  - [Create Fresh App](#create-fresh-app)
 - [Project Structure](#project-structure)
   - [Example Structure](#example-structure)
   - [Key Components](#key-components)
 - [Configuration](#configuration)
-- [Getting Started](#getting-started)
-  - [Prerequisites](#prerequisites)
-  - [Create Fresh App](#create-fresh-app)
 - [CLI Usage](#cli-usage)
 - [Development Guide](#development-guide)
 - [Deployment Guide](#deployment-guide)
@@ -59,9 +58,9 @@ While still growing, MeoCord provides a solid foundation for developers to creat
 
 ### Prerequisites
 
-- **Node.js**: Ensure you have version **22.14.0** or higher, as it’s the current LTS release.
-- **TypeScript**: Version **5.7** or above is required for compatibility with modern features.
-- **Bun**: Version **1.x** or above is required as the package manager.
+- **Runtime**: **Node.js** (latest LTS) or **Bun** (1.x+).
+- **TypeScript**: Version **6** or above.
+- **Package Manager**: Any of **npm**, **yarn**, **pnpm**, or **bun**. The CLI will detect installed package managers and let you choose.
 
 ### Module Support
 
@@ -145,12 +144,21 @@ Follow these steps to create and run a **MeoCord** application:
 
 ### 1. Create a fresh MeoCord Application
 
-Use the CLI to generate your application.
+Use the CLI to generate your application. You'll be prompted to choose a package manager from those installed on your system.
 
 ```shell
 npx meocord create <your-app-name>
 ```
 
+You can also skip the prompt by specifying a package manager directly:
+
+```shell
+npx meocord create <your-app-name> --use-bun
+npx meocord create <your-app-name> --use-npm
+npx meocord create <your-app-name> --use-yarn
+npx meocord create <your-app-name> --use-pnpm
+```
+
 ---
 
 ### 2. Configure `meocord.config.ts`
@@ -176,14 +184,14 @@ Use the CLI to start your application.
   Run in development mode:
 
 ```shell
-bun start:dev
+npx meocord start --dev
 ```
 
 - **Production Mode**:
   Run in production mode with fresh production build:
 
 ```shell
-bun start:prod --build   # use arg `--build` if not built yet or use `bun build:prod` first
+npx meocord start --build --prod
 ```
 
 ---
@@ -218,7 +226,7 @@ When using MeoCord, the expected project structure is as follows:
 │   └── services
 │       └── sample.service.ts
 ├── tsconfig.json
-└── bun.lock
+└── <lockfile>          # bun.lock / package-lock.json / yarn.lock / pnpm-lock.yaml
 ```
 
 This structure ensures clear separation of concerns and scalable project architecture.
@@ -362,13 +370,13 @@ The **MeoCord CLI** is designed to help you manage, build, and run your applicat
 To ensure you see the most accurate and complete list of commands and options, always refer to the help menu by running:
 
 ```shell
-bun meocord --help
+npx meocord --help
 ```
 
 Below is an example of the help display output:
 
 ```textmate
-❯ bun meocord --help
+❯ npx meocord --help
 MeoCord Copyright (C) 2025  Ukasyah Rahmatullah Zada
     This program comes with ABSOLUTELY NO WARRANTY; for details type `meocord show -w'.
     This is free software, and you are welcome to redistribute it
@@ -412,8 +420,8 @@ Builds the application in **production** or **development** mode.
 **Usage:**
 
 ```shell
-bun meocord build --prod       # Build for production
-bun meocord build --dev        # Build for development
+npx meocord build --prod       # Build for production
+npx meocord build --dev        # Build for development
 ```
 
 #### `meocord start`
@@ -423,8 +431,8 @@ Starts the application with options for either a **production** or **development
 **Usage:**
 
 ```shell
-bun meocord start --build --prod          # Start in production mode with fresh production build
-bun meocord start --dev                   # Start in development mode (will always fresh build)
+npx meocord start --build --prod          # Start in production mode with fresh production build
+npx meocord start --dev                   # Start in development mode (will always fresh build)
 ```
 
 #### `meocord generate` (Alias: `meocord g`)
@@ -434,13 +442,13 @@ Scaffolds application components such as controllers, services, and other elemen
 **Usage:**
 
 ```text
-bun meocord generate|g [options] [command]
+npx meocord generate|g [options] [command]
 ```
 
 **Example:**
 
 ```shell
-bun meocord g co slash "user"
+npx meocord g co slash "user"
 ```
 
 This command will generate a `user` slash controller.
@@ -450,7 +458,7 @@ This command will generate a `user` slash controller.
 For detailed usage of any particular command, append the `--help` flag to it. For instance:
 
 ```shell
-bun meocord g --help
+npx meocord g --help
 ```
 
 This will provide command-specific help and options.
@@ -464,7 +472,7 @@ This will provide command-specific help and options.
 Run the application in development mode with live-reload for a seamless coding experience:
 
 ```shell
-bun meocord start --dev
+npx meocord start --dev
 ```
 
 ### Building for Production
@@ -472,7 +480,7 @@ bun meocord start --dev
 Generate an optimized and compiled production build with:
 
 ```shell
-bun meocord build --prod
+npx meocord build --prod
 ```
 
 Once built, you can deploy or run the application efficiently.
@@ -484,19 +492,25 @@ Once built, you can deploy or run the application efficiently.
 Install all necessary dependencies, including development dependencies, before building:
 
 ```shell
-bun install --frozen-lockfile
+npm ci                        # npm
+yarn install --frozen-lockfile  # yarn
+pnpm install --frozen-lockfile  # pnpm
+bun install --frozen-lockfile   # bun
 ```
 
 Generate an optimized and compiled production build:
 
 ```shell
-bun meocord build --prod
+npx meocord build --prod
 ```
 
 Clean up and focus on production-only dependencies:
 
 ```shell
-bun install --production
+npm ci --omit=dev             # npm
+yarn install --production     # yarn
+pnpm install --prod           # pnpm
+bun install --production      # bun
 ```
 
 Ensure the following essential files and folders are prepared for deployment on the server:
@@ -507,13 +521,13 @@ Ensure the following essential files and folders are prepared for deployment on
 ├── node_modules (production dependencies only)
 ├── .env (if applicable, ensure it contains necessary variables)
 ├── package.json
-└── bun.lock
+└── <lockfile>          # bun.lock / package-lock.json / yarn.lock / pnpm-lock.yaml
 ```
 
 Start the application in production mode on the server:
 
 ```shell
-bun meocord start --prod
+npx meocord start --prod
 ```
 
 ---

package/dist/esm/bin/meocord.js

@@ -103,15 +103,24 @@ For full license details, refer to:
             await wait(100);
             process.exit(1);
         }
-        // Check Node.js version
-        const MINIMUM_NODE_VERSION = '22.14.0';
-        const [major, minor, patch] = process.version.slice(1).split('.').map(Number);
-        const [minMajor, minMinor, minPatch] = MINIMUM_NODE_VERSION.split('.').map(Number);
-        if (major < minMajor || major === minMajor && minor < minMinor || major === minMajor && minor === minMinor && patch < minPatch) {
-            p.cancel(`Node.js v${MINIMUM_NODE_VERSION} or higher is required. Current: ${process.version}`);
+        let latestLTS = null;
+        try {
+            const res = await fetch('https://nodejs.org/dist/index.json');
+            const releases = await res.json();
+            const ltsRelease = releases.find((r)=>r.lts !== false);
+            if (ltsRelease) latestLTS = ltsRelease.version.slice(1);
+        } catch  {
+            p.cancel('No internet connection. Creating a MeoCord app requires network access.');
             await wait(100);
             process.exit(1);
         }
+        if (latestLTS) {
+            const [major, minor, patch] = process.version.slice(1).split('.').map(Number);
+            const [minMajor, minMinor, minPatch] = latestLTS.split('.').map(Number);
+            if (major < minMajor || major === minMajor && minor < minMinor || major === minMajor && minor === minMinor && patch < minPatch) {
+                p.log.warn(`Your Node.js (${process.version}) is behind the latest LTS (v${latestLTS}). Consider upgrading for best compatibility.`);
+            }
+        }
         // Determine package manager
         const installedPMs = detectInstalledPMs();
         let pm;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "meocord",
   "description": "MeoCord is a lightweight and modular framework for building scalable Discord bots using TypeScript and Discord.js. It simplifies bot development with an extensible architecture, TypeScript-first approach, and powerful CLI tools.",
-  "version": "1.3.1",
+  "version": "1.3.2",
   "type": "module",
   "scripts": {
     "lint": "eslint --fix . && tsc --noEmit",