@newt-dev/cli 0.1.0

package/dist/src/commands/build.d.ts

@@ -0,0 +1,4 @@
+export interface BuildOptions {
+    outDir?: string;
+}
+export declare function buildCommand(file: string, options?: BuildOptions): number;

package/dist/src/commands/build.js

@@ -0,0 +1,17 @@
+import { relative, resolve } from "node:path";
+import { compile } from "@newt-dev/compiler";
+import { printErrors, readSource, writeProject } from "../util.js";
+export function buildCommand(file, options = {}) {
+    const { filename, source } = readSource(file);
+    const result = compile(source, filename);
+    if (!result.success) {
+        printErrors(result.errors, source);
+        return 1;
+    }
+    const outDir = options.outDir ?? "dist";
+    writeProject(outDir, result.botJs, result.packageJson);
+    const display = relative(process.cwd(), resolve(outDir)) || ".";
+    console.log(`OK Built to ${display}`);
+    console.log(`Next: cd ${display} && npm install && DISCORD_TOKEN=... npm start`);
+    return 0;
+}

package/dist/src/commands/check.d.ts

@@ -0,0 +1 @@
+export declare function checkCommand(file: string): number;

package/dist/src/commands/check.js

@@ -0,0 +1,12 @@
+import { compile } from "@newt-dev/compiler";
+import { printErrors, readSource } from "../util.js";
+export function checkCommand(file) {
+    const { filename, source } = readSource(file);
+    const result = compile(source, filename);
+    if (!result.success) {
+        printErrors(result.errors, source);
+        return 1;
+    }
+    console.log(`OK ${file} - no errors found`);
+    return 0;
+}

package/dist/src/commands/deploy.d.ts

@@ -0,0 +1 @@
+export declare function deployCommand(_file: string): number;

package/dist/src/commands/deploy.js

@@ -0,0 +1,5 @@
+export function deployCommand(_file) {
+    console.error("newt deploy is not available yet. Closed beta requires Newt Cloud auth, token encryption, and container orchestration first.");
+    console.error("For now, use: newt build <file> --out dist");
+    return 2;
+}

package/dist/src/commands/new.d.ts

@@ -0,0 +1 @@
+export declare function newCommand(name?: string, template?: string): number;

package/dist/src/commands/new.js

@@ -0,0 +1,51 @@
+import { existsSync } from "node:fs";
+import { basename } from "node:path";
+import { writeTextFile } from "../util.js";
+const templates = {
+    hello: `bot name "HelloNewt"
+bot prefix "!"
+bot token from env "DISCORD_TOKEN"
+
+on ready:
+    say "HelloNewt is online!" in channel "bot-status"
+
+on command "hello":
+    reply "Hey there, {user.name}!"
+`,
+    welcome: `bot name "WelcomeNewt"
+bot prefix "!"
+bot token from env "DISCORD_TOKEN"
+
+on join:
+    give user role "Member"
+    say embed:
+        title "Welcome, {user.name}!"
+        description "Read #rules first, then say hello."
+        color #5865F2
+`,
+    points: `bot name "PointsNewt"
+bot prefix "!"
+bot token from env "DISCORD_TOKEN"
+
+on command "points":
+    let current = load user.id points or 0
+    store user.id points = current + 1
+    reply "You have {load user.id points} points."
+`,
+    blank: `bot name "MyNewtBot"
+bot prefix "!"
+bot token from env "DISCORD_TOKEN"
+`
+};
+export function newCommand(name = "mybot", template = "hello") {
+    const safeName = basename(name).replace(/[^A-Za-z0-9_-]/g, "-").replace(/\.newt$/i, "");
+    const filename = `${safeName || "mybot"}.newt`;
+    if (existsSync(filename)) {
+        console.error(`${filename} already exists. Pick another name or move the existing file.`);
+        return 1;
+    }
+    const source = templates[template] ?? templates.hello;
+    writeTextFile(filename, source);
+    console.log(`OK Created ${filename} - run: newt check ${filename}`);
+    return 0;
+}

package/dist/src/commands/run.d.ts

@@ -0,0 +1,4 @@
+export interface RunOptions {
+    safe?: boolean;
+}
+export declare function runCommand(file: string, options?: RunOptions): number;

package/dist/src/commands/run.js

@@ -0,0 +1,29 @@
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { spawnSync } from "node:child_process";
+import { buildCommand } from "./build.js";
+export function runCommand(file, options = {}) {
+    if (!process.env.DISCORD_TOKEN) {
+        console.error("DISCORD_TOKEN is not set. Newt bots read tokens from the environment by default.");
+        return 1;
+    }
+    const outDir = mkdtempSync(join(tmpdir(), "newt-run-"));
+    const built = buildCommand(file, { outDir });
+    if (built !== 0) {
+        rmSync(outDir, { recursive: true, force: true });
+        return built;
+    }
+    console.log("Installing generated bot dependencies...");
+    const install = spawnSync("npm.cmd", ["install", "--omit=dev"], { cwd: outDir, stdio: "inherit", shell: false });
+    if (install.status !== 0) {
+        return install.status ?? 1;
+    }
+    console.log("Starting Newt bot...");
+    const child = spawnSync("node", ["bot.js"], {
+        cwd: outDir,
+        stdio: "inherit",
+        env: { ...process.env, NEWT_SAFE_MODE: options.safe ? "1" : process.env.NEWT_SAFE_MODE ?? "" }
+    });
+    return child.status ?? 0;
+}

package/dist/src/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/index.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+import { buildCommand } from "./commands/build.js";
+import { checkCommand } from "./commands/check.js";
+import { deployCommand } from "./commands/deploy.js";
+import { newCommand } from "./commands/new.js";
+import { runCommand } from "./commands/run.js";
+const [, , command, ...args] = process.argv;
+function help() {
+    console.log(`Newt CLI
+
+Usage:
+  newt check <file>
+  newt build <file> [--out <dir>]
+  newt run <file> [--safe]
+  newt new [name] [--template hello|welcome|points|blank]
+  newt deploy <file>
+`);
+}
+function optionValue(flag, fallback) {
+    const index = args.indexOf(flag);
+    return index >= 0 ? args[index + 1] : fallback;
+}
+try {
+    let exitCode = 0;
+    if (!command || command === "--help" || command === "-h") {
+        help();
+    }
+    else if (command === "check") {
+        exitCode = args[0] ? checkCommand(args[0]) : missingFile();
+    }
+    else if (command === "build") {
+        exitCode = args[0] ? buildCommand(args[0], { outDir: optionValue("--out") }) : missingFile();
+    }
+    else if (command === "run") {
+        exitCode = args[0] ? runCommand(args[0], { safe: args.includes("--safe") }) : missingFile();
+    }
+    else if (command === "new") {
+        exitCode = newCommand(args[0], optionValue("--template", "hello"));
+    }
+    else if (command === "deploy") {
+        exitCode = args[0] ? deployCommand(args[0]) : missingFile();
+    }
+    else {
+        console.error(`Unknown command: ${command}`);
+        help();
+        exitCode = 1;
+    }
+    process.exitCode = exitCode;
+}
+catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+}
+function missingFile() {
+    console.error("Please pass a .newt file.");
+    return 1;
+}

package/dist/src/util.d.ts

@@ -0,0 +1,8 @@
+import { type NewtError } from "@newt-dev/compiler";
+export declare function readSource(file: string): {
+    filename: string;
+    source: string;
+};
+export declare function printErrors(errors: NewtError[], source: string): void;
+export declare function writeProject(outDir: string, botJs: string, packageJson: string): void;
+export declare function writeTextFile(path: string, text: string): void;

package/dist/src/util.js

@@ -0,0 +1,26 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { formatError } from "@newt-dev/compiler";
+export function readSource(file) {
+    const filename = resolve(file);
+    if (!existsSync(filename)) {
+        throw new Error(`I could not find ${file}. Check the path and try again.`);
+    }
+    return { filename, source: readFileSync(filename, "utf8") };
+}
+export function printErrors(errors, source) {
+    for (const error of errors) {
+        console.error(formatError(error, source));
+        console.error("");
+    }
+}
+export function writeProject(outDir, botJs, packageJson) {
+    const target = resolve(outDir);
+    mkdirSync(target, { recursive: true });
+    writeFileSync(resolve(target, "bot.js"), botJs);
+    writeFileSync(resolve(target, "package.json"), packageJson);
+}
+export function writeTextFile(path, text) {
+    mkdirSync(dirname(resolve(path)), { recursive: true });
+    writeFileSync(resolve(path), text);
+}

package/dist/test/cli.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/cli.test.js

@@ -0,0 +1,32 @@
+import assert from "node:assert/strict";
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { test } from "node:test";
+import { buildCommand } from "../src/commands/build.js";
+import { checkCommand } from "../src/commands/check.js";
+test("check command accepts a valid file", () => {
+    const dir = mkdtempSync(join(tmpdir(), "newt-cli-"));
+    try {
+        const file = join(dir, "bot.newt");
+        writeFileSync(file, `bot name "CliBot"\nbot prefix "!"\nbot token from env "DISCORD_TOKEN"\n\non command "hello":\n    reply "Hi!"\n`);
+        assert.equal(checkCommand(file), 0);
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+});
+test("build command writes generated project", () => {
+    const dir = mkdtempSync(join(tmpdir(), "newt-cli-"));
+    try {
+        const file = join(dir, "bot.newt");
+        const out = join(dir, "dist");
+        writeFileSync(file, `bot name "CliBot"\nbot prefix "!"\nbot token from env "DISCORD_TOKEN"\n\non command "hello":\n    reply "Hi!"\n`);
+        assert.equal(buildCommand(file, { outDir: out }), 0);
+        assert.match(readFileSync(join(out, "bot.js"), "utf8"), /client\.login/);
+        assert.match(readFileSync(join(out, "package.json"), "utf8"), /discord\.js/);
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+});

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@newt-dev/cli",
+  "version": "0.1.0",
+  "description": "Command-line tools for the Newt Discord bot DSL.",
+  "type": "module",
+  "bin": {
+    "newt": "dist/src/index.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test dist/test/*.test.js"
+  },
+  "keywords": [
+    "discord",
+    "bot",
+    "dsl",
+    "cli",
+    "newt"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/newt-dev-sudo/newt.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/newt-dev-sudo/newt#readme",
+  "dependencies": {
+    "@newt-dev/compiler": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.12.0",
+    "typescript": "^5.5.0"
+  },
+  "license": "MIT"
+}

package/src/commands/build.ts

@@ -0,0 +1,24 @@
+import { relative, resolve } from "node:path";
+import { compile } from "@newt-dev/compiler";
+import { printErrors, readSource, writeProject } from "../util.js";
+
+export interface BuildOptions {
+  outDir?: string;
+}
+
+export function buildCommand(file: string, options: BuildOptions = {}): number {
+  const { filename, source } = readSource(file);
+  const result = compile(source, filename);
+
+  if (!result.success) {
+    printErrors(result.errors, source);
+    return 1;
+  }
+
+  const outDir = options.outDir ?? "dist";
+  writeProject(outDir, result.botJs, result.packageJson);
+  const display = relative(process.cwd(), resolve(outDir)) || ".";
+  console.log(`OK Built to ${display}`);
+  console.log(`Next: cd ${display} && npm install && DISCORD_TOKEN=... npm start`);
+  return 0;
+}

package/src/commands/check.ts

@@ -0,0 +1,15 @@
+import { compile } from "@newt-dev/compiler";
+import { printErrors, readSource } from "../util.js";
+
+export function checkCommand(file: string): number {
+  const { filename, source } = readSource(file);
+  const result = compile(source, filename);
+
+  if (!result.success) {
+    printErrors(result.errors, source);
+    return 1;
+  }
+
+  console.log(`OK ${file} - no errors found`);
+  return 0;
+}

package/src/commands/deploy.ts

@@ -0,0 +1,5 @@
+export function deployCommand(_file: string): number {
+  console.error("newt deploy is not available yet. Closed beta requires Newt Cloud auth, token encryption, and container orchestration first.");
+  console.error("For now, use: newt build <file> --out dist");
+  return 2;
+}

package/src/commands/new.ts

@@ -0,0 +1,54 @@
+import { existsSync } from "node:fs";
+import { basename } from "node:path";
+import { writeTextFile } from "../util.js";
+
+const templates: Record<string, string> = {
+  hello: `bot name "HelloNewt"
+bot prefix "!"
+bot token from env "DISCORD_TOKEN"
+
+on ready:
+    say "HelloNewt is online!" in channel "bot-status"
+
+on command "hello":
+    reply "Hey there, {user.name}!"
+`,
+  welcome: `bot name "WelcomeNewt"
+bot prefix "!"
+bot token from env "DISCORD_TOKEN"
+
+on join:
+    give user role "Member"
+    say embed:
+        title "Welcome, {user.name}!"
+        description "Read #rules first, then say hello."
+        color #5865F2
+`,
+  points: `bot name "PointsNewt"
+bot prefix "!"
+bot token from env "DISCORD_TOKEN"
+
+on command "points":
+    let current = load user.id points or 0
+    store user.id points = current + 1
+    reply "You have {load user.id points} points."
+`,
+  blank: `bot name "MyNewtBot"
+bot prefix "!"
+bot token from env "DISCORD_TOKEN"
+`
+};
+
+export function newCommand(name = "mybot", template = "hello"): number {
+  const safeName = basename(name).replace(/[^A-Za-z0-9_-]/g, "-").replace(/\.newt$/i, "");
+  const filename = `${safeName || "mybot"}.newt`;
+  if (existsSync(filename)) {
+    console.error(`${filename} already exists. Pick another name or move the existing file.`);
+    return 1;
+  }
+
+  const source = templates[template] ?? templates.hello;
+  writeTextFile(filename, source);
+  console.log(`OK Created ${filename} - run: newt check ${filename}`);
+  return 0;
+}

package/src/commands/run.ts

@@ -0,0 +1,38 @@
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { spawnSync } from "node:child_process";
+import { buildCommand } from "./build.js";
+
+export interface RunOptions {
+  safe?: boolean;
+}
+
+export function runCommand(file: string, options: RunOptions = {}): number {
+  if (!process.env.DISCORD_TOKEN) {
+    console.error("DISCORD_TOKEN is not set. Newt bots read tokens from the environment by default.");
+    return 1;
+  }
+
+  const outDir = mkdtempSync(join(tmpdir(), "newt-run-"));
+  const built = buildCommand(file, { outDir });
+  if (built !== 0) {
+    rmSync(outDir, { recursive: true, force: true });
+    return built;
+  }
+
+  console.log("Installing generated bot dependencies...");
+  const install = spawnSync("npm.cmd", ["install", "--omit=dev"], { cwd: outDir, stdio: "inherit", shell: false });
+  if (install.status !== 0) {
+    return install.status ?? 1;
+  }
+
+  console.log("Starting Newt bot...");
+  const child = spawnSync("node", ["bot.js"], {
+    cwd: outDir,
+    stdio: "inherit",
+    env: { ...process.env, NEWT_SAFE_MODE: options.safe ? "1" : process.env.NEWT_SAFE_MODE ?? "" }
+  });
+
+  return child.status ?? 0;
+}

package/src/index.ts

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+import { buildCommand } from "./commands/build.js";
+import { checkCommand } from "./commands/check.js";
+import { deployCommand } from "./commands/deploy.js";
+import { newCommand } from "./commands/new.js";
+import { runCommand } from "./commands/run.js";
+
+const [, , command, ...args] = process.argv;
+
+function help(): void {
+  console.log(`Newt CLI
+
+Usage:
+  newt check <file>
+  newt build <file> [--out <dir>]
+  newt run <file> [--safe]
+  newt new [name] [--template hello|welcome|points|blank]
+  newt deploy <file>
+`);
+}
+
+function optionValue(flag: string, fallback?: string): string | undefined {
+  const index = args.indexOf(flag);
+  return index >= 0 ? args[index + 1] : fallback;
+}
+
+try {
+  let exitCode = 0;
+  if (!command || command === "--help" || command === "-h") {
+    help();
+  } else if (command === "check") {
+    exitCode = args[0] ? checkCommand(args[0]) : missingFile();
+  } else if (command === "build") {
+    exitCode = args[0] ? buildCommand(args[0], { outDir: optionValue("--out") }) : missingFile();
+  } else if (command === "run") {
+    exitCode = args[0] ? runCommand(args[0], { safe: args.includes("--safe") }) : missingFile();
+  } else if (command === "new") {
+    exitCode = newCommand(args[0], optionValue("--template", "hello"));
+  } else if (command === "deploy") {
+    exitCode = args[0] ? deployCommand(args[0]) : missingFile();
+  } else {
+    console.error(`Unknown command: ${command}`);
+    help();
+    exitCode = 1;
+  }
+  process.exitCode = exitCode;
+} catch (error) {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exitCode = 1;
+}
+
+function missingFile(): number {
+  console.error("Please pass a .newt file.");
+  return 1;
+}

package/src/util.ts

@@ -0,0 +1,31 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { formatError, type NewtError } from "@newt-dev/compiler";
+
+export function readSource(file: string): { filename: string; source: string } {
+  const filename = resolve(file);
+  if (!existsSync(filename)) {
+    throw new Error(`I could not find ${file}. Check the path and try again.`);
+  }
+
+  return { filename, source: readFileSync(filename, "utf8") };
+}
+
+export function printErrors(errors: NewtError[], source: string): void {
+  for (const error of errors) {
+    console.error(formatError(error, source));
+    console.error("");
+  }
+}
+
+export function writeProject(outDir: string, botJs: string, packageJson: string): void {
+  const target = resolve(outDir);
+  mkdirSync(target, { recursive: true });
+  writeFileSync(resolve(target, "bot.js"), botJs);
+  writeFileSync(resolve(target, "package.json"), packageJson);
+}
+
+export function writeTextFile(path: string, text: string): void {
+  mkdirSync(dirname(resolve(path)), { recursive: true });
+  writeFileSync(resolve(path), text);
+}

package/test/cli.test.ts

@@ -0,0 +1,32 @@
+import assert from "node:assert/strict";
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { test } from "node:test";
+import { buildCommand } from "../src/commands/build.js";
+import { checkCommand } from "../src/commands/check.js";
+
+test("check command accepts a valid file", () => {
+  const dir = mkdtempSync(join(tmpdir(), "newt-cli-"));
+  try {
+    const file = join(dir, "bot.newt");
+    writeFileSync(file, `bot name "CliBot"\nbot prefix "!"\nbot token from env "DISCORD_TOKEN"\n\non command "hello":\n    reply "Hi!"\n`);
+    assert.equal(checkCommand(file), 0);
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test("build command writes generated project", () => {
+  const dir = mkdtempSync(join(tmpdir(), "newt-cli-"));
+  try {
+    const file = join(dir, "bot.newt");
+    const out = join(dir, "dist");
+    writeFileSync(file, `bot name "CliBot"\nbot prefix "!"\nbot token from env "DISCORD_TOKEN"\n\non command "hello":\n    reply "Hi!"\n`);
+    assert.equal(buildCommand(file, { outDir: out }), 0);
+    assert.match(readFileSync(join(out, "bot.js"), "utf8"), /client\.login/);
+    assert.match(readFileSync(join(out, "package.json"), "utf8"), /discord\.js/);
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "declaration": true,
+    "outDir": "dist",
+    "rootDir": ".",
+    "strict": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true
+  },
+  "include": [
+    "src/**/*.ts",
+    "test/**/*.ts"
+  ]
+}