@discord-ts-dev/cli 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,30 @@
+# @discord-ts-dev/cli
+
+## 1.0.1
+
+### Patch Changes
+
+- 96e1908: First publish to npm. Add `repository`, `bugs` and `homepage` metadata, and ship
+  `CHANGELOG.md` and `LICENSE` in the tarball. See ADR 0012.
+
+  Internal dependencies move from the `workspace:*` protocol to a caret range.
+  npm does not rewrite `workspace:` on pack or publish, so the protocol reached
+  the registry verbatim and every consumer install failed with
+  `EUNSUPPORTEDPROTOCOL`. Caret ranges are what `updateInternalDependencies`
+  already expects, and they resolve once the dependencies are published.
+
+## 1.0.0
+
+### Major Changes
+
+- e95d73e: Drop `@nestjs/*` for a standalone runtime and move to ESM (`NodeNext`, `type: module`). `Injectable`, `Module`, `SetMetadata`, `UseGuards`, `UsePipes`, `Logger` now come from `@discord-ts-dev/common`; update example imports accordingly
+
+### Minor Changes
+
+- e85b103: Run on Bun instead of Node.js. The CLI spawns the runtime it is already running under (`process.execPath`) rather than `node` for build output, uses `Bun.spawnSync` / `Bun.file` / `Bun.stdout`, and its shebang is `#!/usr/bin/env bun` - the `discord` bin needs Bun now. Core reads config files via `Bun.pathToFileURL` and paints route logs with `Bun.color`. Node APIs with no Bun equivalent stay: `node:path`, `node:fs` `realpathSync`/`existsSync`, `node:vm` in the music-bot eval command, and `node:assert` in tests.
+- 9f0dea9: Declare `exports` maps so deep subpaths stop being implicitly public. The CLI runner is now importable: `main(argv, deps)`, `COMMANDS`, `usage()` and the `CliDeps` injection point are exported, and `main` only runs when the file is the entry point - tests no longer spawn processes.
+
+### Patch Changes
+
+- 58bdc90: Fix two validation bugs found by the coverage pass: `validateDto` now calls `class-validator` with `forbidUnknownValues: false`, so plain DTOs without validator decorators pass instead of being blocked with "an unknown value was passed"; `resolveDiscordOptions` no longer clobbers `forRootAsync({ skipValidation: true })` with `undefined`. `deployWithModule()` and `bootstrapApp()` take an optional runtime factory for tests. The CLI runner sets `process.exitCode` instead of calling `process.exit`, so output flushes before the process ends.
+- 76feef4: Add bun smoke tests with per-package test scripts

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) discord.ts contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cli.d.ts

@@ -0,0 +1,26 @@
+#!/usr/bin/env bun
+export interface CliCommand {
+    file: string;
+    args: string[];
+    help: string;
+    /** Built output, so a missing file means "build first". */
+    needsBuild?: boolean;
+}
+export declare const COMMANDS: Record<string, CliCommand>;
+/** Side effects `main` needs, injectable so tests never spawn or exit. */
+export interface CliDeps {
+    cwd: string;
+    exists: (file: string) => Promise<boolean>;
+    spawn: (argv: string[]) => {
+        exitCode: number | null;
+    };
+    out: (text: string) => void;
+    err: (text: string) => void;
+    exit: (code: number) => void;
+}
+export declare function usage(): string;
+export declare function main(argv: string[], deps?: CliDeps): Promise<void>;
+/** True when this module is the process entry. Realpath so bin symlinks match. */
+export declare function isEntry(entry: string | undefined, moduleUrl: string): boolean;
+export declare function mainIfEntry(argv: string[], moduleUrl: string, deps?: CliDeps): Promise<void>;
+export declare function processDeps(): CliDeps;

package/dist/cli.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env bun
+// ponytail: path.resolve and realpathSync have no Bun equivalent; both are
+// Bun-native implementations of the node modules.
+import { realpathSync } from 'node:fs';
+import * as path from 'node:path';
+// ponytail: no arg-parser dep, five commands fit in one table. Bun runs both
+// TS source and build output, so no runtime switch.
+export const COMMANDS = {
+    dev: { file: 'src/main.ts', args: [], help: 'boot bot from TS source' },
+    'dev:shard': { file: 'src/main.ts', args: ['--shards'], help: 'boot shards from TS source' },
+    deploy: { file: 'src/deploy.ts', args: [], help: 'sync commands without login' },
+    start: { file: 'dist/main.js', args: [], help: 'boot bot from build output', needsBuild: true },
+    'start:shard': {
+        file: 'dist/main.js',
+        args: ['--shards'],
+        help: 'boot shards from build output',
+        needsBuild: true,
+    },
+};
+export function usage() {
+    const rows = Object.entries(COMMANDS)
+        .map(([name, cmd]) => `  discord ${name.padEnd(12)} ${cmd.help}`)
+        .join('\n');
+    return `Usage: discord <command>\n\n${rows}\n`;
+}
+export async function main(argv, deps = processDeps()) {
+    const [, , cmd, ...rest] = argv;
+    if (!cmd || cmd === '--help' || cmd === '-h') {
+        deps.out(usage());
+        deps.exit(cmd ? 0 : 1);
+        return;
+    }
+    const found = COMMANDS[cmd];
+    if (!found) {
+        deps.err(`[discord.ts] unknown command "${cmd}".\n\n${usage()}`);
+        deps.exit(1);
+        return;
+    }
+    if (rest.includes('--help') || rest.includes('-h')) {
+        deps.out(usage());
+        deps.exit(0);
+        return;
+    }
+    const file = path.resolve(deps.cwd, found.file);
+    if (!(await deps.exists(file))) {
+        deps.err(`[discord.ts] missing ${found.file}. Run inside your bot app${found.needsBuild ? ' after building' : ''}.`);
+        deps.exit(1);
+        return;
+    }
+    const run = deps.spawn([process.execPath, file, ...found.args, ...rest]);
+    deps.exit(run.exitCode ?? 1);
+}
+/** True when this module is the process entry. Realpath so bin symlinks match. */
+export function isEntry(entry, moduleUrl) {
+    if (entry === undefined)
+        return false;
+    try {
+        return realpathSync(entry) === realpathSync(Bun.fileURLToPath(moduleUrl));
+    }
+    catch {
+        return false;
+    }
+}
+export async function mainIfEntry(argv, moduleUrl, deps = processDeps()) {
+    if (isEntry(argv[1], moduleUrl))
+        await main(argv, deps);
+}
+export function processDeps() {
+    return {
+        cwd: process.cwd(),
+        exists: (file) => Bun.file(file).exists(),
+        spawn: (argv) => Bun.spawnSync(argv, { stdio: ['inherit', 'inherit', 'inherit'] }),
+        out: (text) => void Bun.stdout.write(text),
+        err: (text) => void Bun.stderr.write(text),
+        exit: (code) => {
+            process.exitCode = code;
+        },
+    };
+}
+await mainIfEntry(Bun.argv, import.meta.url);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@discord-ts-dev/cli",
+  "version": "1.0.1",
+  "description": "discord.ts command runner: dev, shard, deploy, start",
+  "homepage": "https://github.com/discord-ts-dev/discord.ts#readme",
+  "bugs": {
+    "url": "https://github.com/discord-ts-dev/discord.ts/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/discord-ts-dev/discord.ts.git",
+    "directory": "packages/cli"
+  },
+  "bin": {
+    "discord": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "main": "dist/cli.js",
+  "types": "dist/cli.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/cli.d.ts",
+      "default": "./dist/cli.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "oxlint .",
+    "format": "oxfmt --write src",
+    "test": "bun test --preload=../../scripts/test-preload.ts"
+  },
+  "devDependencies": {
+    "@types/node": "^26.4.1",
+    "typescript": "^7.0.2"
+  }
+}