@ajke/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Wilt 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/README.md

@@ -0,0 +1,163 @@
+# @ajke/cli
+
+The official CLI for the [Ajke framework](../core/README.md). Scaffold new Cloudflare Workers projects and generate modules, services, and controllers.
+
+## Installation
+
+```bash
+npm install -g @ajke/cli
+```
+
+Or run without installing:
+
+```bash
+npx @ajke/cli new my-app
+```
+
+---
+
+## Commands
+
+### `ajke new <project-name>`
+
+Scaffold a new Ajke project with a Hello module, D1 database setup, and all config files pre-configured.
+
+```bash
+ajke new my-app
+cd my-app
+pnpm dev   # http://localhost:4001
+```
+
+**What gets created:**
+
+```
+my-app/
+├── src/
+│   ├── index.ts
+│   ├── app.module.ts
+│   └── modules/app/hello/
+│       ├── hello.module.ts
+│       ├── hello.controller.ts
+│       └── hello.service.ts
+├── src/database/
+│   ├── schema.ts
+│   └── connection.ts
+├── migrations/
+├── ajke.config.ts
+├── wrangler.jsonc
+├── tsconfig.json
+├── vite.config.ts
+├── vitest.config.ts
+└── package.json
+```
+
+---
+
+### `ajke generate <subcommand> <name>`
+
+Aliases: `g`
+
+Scaffold files inside an existing project. Reads `ajke.config.ts` for the modules directory.
+
+#### `ajke generate module <name>` (alias: `g m`)
+
+Generates a full module: module, controller, service, DTO, entity, and test file.
+
+```bash
+ajke generate module payment
+ajke g m payment
+ajke g m payment --no-test    # skip test file
+ajke g m payment --path src/modules/billing/payment
+```
+
+**Output:**
+
+```
+src/modules/app/payment/
+├── payment.module.ts
+├── payment.controller.ts
+├── payment.service.ts
+├── payment.dto.ts
+├── payment.entity.ts
+└── payment.test.ts
+```
+
+#### `ajke generate service <name>` (alias: `g s`)
+
+```bash
+ajke generate service payment
+ajke g s payment --path src/modules/app/payment
+```
+
+#### `ajke generate controller <name>` (alias: `g c`)
+
+```bash
+ajke generate controller payment
+ajke g c payment --path src/modules/app/payment
+```
+
+---
+
+### `ajke add <service> [args]`
+
+Add a Cloudflare service binding to `wrangler.jsonc`.
+
+| Subcommand | Usage | Example |
+|---|---|---|
+| `d1` | `ajke add d1 <BINDING> <db-name>` | `ajke add d1 DB my-database` |
+| `r2` | `ajke add r2 <BINDING> <bucket-name>` | `ajke add r2 ASSETS my-bucket` |
+| `kv` | `ajke add kv <BINDING>` | `ajke add kv SESSION_KV` |
+| `queue` | `ajke add queue <BINDING> <queue-name>` | `ajke add queue MAIL mail-queue` |
+| `ai` | `ajke add ai <BINDING>` | `ajke add ai AI` |
+| `durable-object` | `ajke add durable-object <BINDING> <ClassName>` | `ajke add durable-object CHAT ChatRoom` |
+| `vectorize` | `ajke add vectorize <BINDING> <index-name> [dims]` | `ajke add vectorize VEC my-index 1536` |
+| `browser` | `ajke add browser <BINDING>` | `ajke add browser BROWSER` |
+| `hyperdrive` | `ajke add hyperdrive <BINDING> <connection-string>` | `ajke add hyperdrive HD postgres://...` |
+
+---
+
+## Config (`ajke.config.ts`)
+
+Place this file in your project root to customise the CLI behaviour.
+
+```typescript
+import { defineConfig } from "@ajke/core/config";
+
+export default defineConfig({
+  // Where generated modules are placed (relative to project root)
+  modulesDir: "src/modules/app",
+
+  // Which files are scaffolded by `ajke generate module <name>`
+  // Remove "test" to skip test files, or pass --no-test per-command
+  generate: {
+    files: ["module", "controller", "service", "dto", "entity", "test"],
+  },
+});
+```
+
+---
+
+## Usage Inside a Project
+
+When `@ajke/cli` is installed locally as a dev dependency, add a script to `package.json`:
+
+```json
+{
+  "scripts": {
+    "ajke": "tsx node_modules/@ajke/cli/bin/ajke.ts"
+  }
+}
+```
+
+Then run:
+
+```bash
+pnpm ajke generate module posts
+pnpm ajke add d1 DB my-database
+```
+
+---
+
+## License
+
+MIT

package/bin/ajke.ts

@@ -0,0 +1,80 @@
+#!/usr/bin/env tsx
+import { runNew } from "./commands/new.js";
+import { runGenerate } from "./commands/generate.js";
+import { runAdd } from "./commands/add.js";
+
+const BANNER = `
+  █████╗      ██╗██╗  ██╗███████╗
+ ██╔══██╗     ██║██║ ██╔╝██╔════╝
+ ███████║     ██║█████╔╝ █████╗
+ ██╔══██║██   ██║██╔═██╗ ██╔══╝
+ ██║  ██║╚█████╔╝██║  ██╗███████╗
+ ╚═╝  ╚═╝ ╚════╝ ╚═╝  ╚═╝╚══════╝
+  Ajke CLI — Cloudflare Workers & Hono Framework
+`.trim();
+
+const HELP = `
+${BANNER}
+
+Usage:
+  pnpm ajke <command> [subcommand] [args...]
+
+Commands:
+  new             Create a new Ajke project
+  generate (g)    Scaffold module, service, or controller files
+  add             Add a Cloudflare service binding to wrangler.jsonc
+  help            Show this help message
+
+Generate subcommands:
+  module (m)      Scaffold a full module (module + controller + service + dto)
+  service (s)     Scaffold a service file
+  controller (c)  Scaffold a controller file
+
+Add subcommands:
+  d1              D1 database binding
+  r2              R2 bucket binding
+  kv              KV namespace binding
+  queue           Queue producer + consumer
+  ai              Workers AI binding
+  durable-object  Durable Object binding + migration
+  vectorize       Vectorize index binding
+  browser         Browser rendering binding
+  hyperdrive      Hyperdrive binding
+
+Examples:
+  pnpm ajke new my-app
+  pnpm ajke generate module payment
+  pnpm ajke g m payment
+  pnpm ajke add d1 PAYMENTS_DB payments-db
+  pnpm ajke add r2 ASSETS_BUCKET my-assets
+  pnpm ajke add kv SESSION_KV
+  pnpm ajke add queue MAIL_QUEUE mailer
+  pnpm ajke add ai AI
+  pnpm ajke add durable-object CHAT_ROOM ChatRoom
+`.trim();
+
+async function main(): Promise<void> {
+  const args = process.argv.slice(2);
+  const [command, ...rest] = args;
+
+  if (!command || command === "help" || command === "--help" || command === "-h") {
+    console.log(`\n${HELP}\n`);
+    process.exit(0);
+  }
+
+  const cmd = command.toLowerCase();
+
+  if (cmd === "new" || cmd === "n") {
+    runNew(rest);
+  } else if (cmd === "generate" || cmd === "g") {
+    await runGenerate(rest);
+  } else if (cmd === "add") {
+    runAdd(rest);
+  } else {
+    console.error(`  ✗ Unknown command: "${command}"\n`);
+    console.log(HELP);
+    process.exit(1);
+  }
+}
+
+main();

package/bin/commands/add.ts

@@ -0,0 +1,155 @@
+import {
+  addD1,
+  addR2,
+  addKv,
+  addQueue,
+  addAi,
+  addDurableObject,
+  addVectorize,
+  addBrowser,
+  addHyperdrive,
+} from "../utils/wrangler.js";
+
+const USAGE = `
+Usage:
+  pnpm ajke add d1 <BINDING_NAME> <database-name>
+  pnpm ajke add r2 <BINDING_NAME> <bucket-name>
+  pnpm ajke add kv <BINDING_NAME>
+  pnpm ajke add queue <BINDING_NAME> <queue-name>
+  pnpm ajke add ai <BINDING_NAME>
+  pnpm ajke add durable-object <BINDING_NAME> <ClassName>
+  pnpm ajke add vectorize <BINDING_NAME> <index-name> [dimensions]
+  pnpm ajke add browser <BINDING_NAME>
+  pnpm ajke add hyperdrive <BINDING_NAME> <connection-string>
+
+Examples:
+  pnpm ajke add d1 PAYMENTS_DB payments-db
+  pnpm ajke add r2 ASSETS_BUCKET my-assets
+  pnpm ajke add kv SESSION_KV
+  pnpm ajke add queue MAIL_QUEUE mailer
+  pnpm ajke add ai AI
+  pnpm ajke add durable-object CHAT_ROOM ChatRoom
+  pnpm ajke add vectorize VECTOR_IDX my-index 1536
+  pnpm ajke add browser BROWSER
+  pnpm ajke add hyperdrive HYPERDRIVE postgres://user:pass@host/db
+`.trim();
+
+export function runAdd(args: string[]): void {
+  const [service, ...rest] = args;
+
+  if (!service) {
+    console.error(`  ✗ Missing service type.\n\n${USAGE}`);
+    process.exit(1);
+  }
+
+  const svc = service.toLowerCase();
+
+  switch (svc) {
+    case "d1": {
+      const [binding, dbName] = rest;
+      if (!binding || !dbName) {
+        console.error(`  ✗ Usage: pnpm ajke add d1 <BINDING_NAME> <database-name>`);
+        process.exit(1);
+      }
+      console.log(`\n  Adding D1 binding to wrangler.jsonc...\n`);
+      addD1(binding, dbName);
+      break;
+    }
+
+    case "r2": {
+      const [binding, bucketName] = rest;
+      if (!binding || !bucketName) {
+        console.error(`  ✗ Usage: pnpm ajke add r2 <BINDING_NAME> <bucket-name>`);
+        process.exit(1);
+      }
+      console.log(`\n  Adding R2 binding to wrangler.jsonc...\n`);
+      addR2(binding, bucketName);
+      break;
+    }
+
+    case "kv": {
+      const [binding] = rest;
+      if (!binding) {
+        console.error(`  ✗ Usage: pnpm ajke add kv <BINDING_NAME>`);
+        process.exit(1);
+      }
+      console.log(`\n  Adding KV namespace binding to wrangler.jsonc...\n`);
+      addKv(binding);
+      break;
+    }
+
+    case "queue": {
+      const [binding, queueName] = rest;
+      if (!binding || !queueName) {
+        console.error(`  ✗ Usage: pnpm ajke add queue <BINDING_NAME> <queue-name>`);
+        process.exit(1);
+      }
+      console.log(`\n  Adding Queue binding to wrangler.jsonc...\n`);
+      addQueue(binding, queueName);
+      break;
+    }
+
+    case "ai": {
+      const [binding] = rest;
+      if (!binding) {
+        console.error(`  ✗ Usage: pnpm ajke add ai <BINDING_NAME>`);
+        process.exit(1);
+      }
+      console.log(`\n  Adding AI binding to wrangler.jsonc...\n`);
+      addAi(binding);
+      break;
+    }
+
+    case "durable-object":
+    case "do": {
+      const [binding, className] = rest;
+      if (!binding || !className) {
+        console.error(`  ✗ Usage: pnpm ajke add durable-object <BINDING_NAME> <ClassName>`);
+        process.exit(1);
+      }
+      console.log(`\n  Adding Durable Object binding to wrangler.jsonc...\n`);
+      addDurableObject(binding, className);
+      break;
+    }
+
+    case "vectorize":
+    case "vector": {
+      const [binding, indexName, rawDimensions] = rest;
+      if (!binding || !indexName) {
+        console.error(`  ✗ Usage: pnpm ajke add vectorize <BINDING_NAME> <index-name> [dimensions]`);
+        process.exit(1);
+      }
+      const dimensions = rawDimensions ? parseInt(rawDimensions, 10) : 1536;
+      console.log(`\n  Adding Vectorize binding to wrangler.jsonc...\n`);
+      addVectorize(binding, indexName, dimensions);
+      break;
+    }
+
+    case "browser": {
+      const [binding] = rest;
+      if (!binding) {
+        console.error(`  ✗ Usage: pnpm ajke add browser <BINDING_NAME>`);
+        process.exit(1);
+      }
+      console.log(`\n  Adding Browser rendering binding to wrangler.jsonc...\n`);
+      addBrowser(binding);
+      break;
+    }
+
+    case "hyperdrive": {
+      const [binding, connectionString] = rest;
+      if (!binding || !connectionString) {
+        console.error(`  ✗ Usage: pnpm ajke add hyperdrive <BINDING_NAME> <connection-string>`);
+        process.exit(1);
+      }
+      console.log(`\n  Adding Hyperdrive binding to wrangler.jsonc...\n`);
+      addHyperdrive(binding, connectionString);
+      break;
+    }
+
+    default: {
+      console.error(`  ✗ Unknown service type: "${service}"\n\n${USAGE}`);
+      process.exit(1);
+    }
+  }
+}

package/bin/commands/generate.ts

@@ -0,0 +1,74 @@
+import {
+  generateModule,
+  generateService,
+  generateController,
+} from "../generators/module.generator.js";
+import { loadConfig } from "../utils/config.js";
+
+const USAGE = `
+Usage:
+  pnpm ajke generate module <name> [--path <dir>] [--no-test]
+  pnpm ajke generate service <name> [--path <dir>]
+  pnpm ajke generate controller <name> [--path <dir>]
+
+Aliases:
+  g m  →  generate module
+  g s  →  generate service
+  g c  →  generate controller
+
+Flags:
+  --no-test   Skip generating the .test.ts file for a module
+
+Examples:
+  pnpm ajke generate module payment
+  pnpm ajke g m payment
+  pnpm ajke generate module payment --no-test
+  pnpm ajke generate service payment --path src/modules/app/payment
+`.trim();
+
+function parsePath(args: string[]): { args: string[]; path?: string } {
+  const idx = args.indexOf("--path");
+  if (idx === -1) return { args };
+  const path = args[idx + 1];
+  const cleaned = args.filter((_, i) => i !== idx && i !== idx + 1);
+  return { args: cleaned, path };
+}
+
+function parseNoTest(args: string[]): { args: string[]; noTest: boolean } {
+  const idx = args.indexOf("--no-test");
+  if (idx === -1) return { args, noTest: false };
+  return { args: args.filter((_, i) => i !== idx), noTest: true };
+}
+
+export async function runGenerate(args: string[]): Promise<void> {
+  const { args: withoutPath, path: targetPath } = parsePath(args);
+  const { args: cleanArgs, noTest } = parseNoTest(withoutPath);
+  const [subcommand, name] = cleanArgs;
+
+  if (!subcommand || !name) {
+    console.error(`  ✗ Missing arguments.\n\n${USAGE}`);
+    process.exit(1);
+  }
+
+  const config = await loadConfig();
+  const sub = subcommand.toLowerCase();
+
+  if (sub === "module" || sub === "m") {
+    console.log(`\n  Generating module "${name}"...\n`);
+    generateModule(name, {
+      dir: targetPath,
+      modulesDir: config.modulesDir,
+      defaultFiles: config.generate.files,
+      noTest,
+    });
+  } else if (sub === "service" || sub === "s") {
+    console.log(`\n  Generating service "${name}"...\n`);
+    generateService(name, targetPath, config.modulesDir);
+  } else if (sub === "controller" || sub === "c") {
+    console.log(`\n  Generating controller "${name}"...\n`);
+    generateController(name, targetPath, config.modulesDir);
+  } else {
+    console.error(`  ✗ Unknown generate subcommand: "${subcommand}"\n\n${USAGE}`);
+    process.exit(1);
+  }
+}