@hazejs/cli 0.0.0-stage → 0.1.1

package/dist/key-CmUJM4SG.mjs

@@ -0,0 +1,51 @@
+import { a as resolveRoot, o as rootArg } from "./index.mjs";
+import { defineCommand } from "citty";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join, relative } from "node:path";
+import process from "node:process";
+import { consola } from "consola";
+import { Buffer } from "node:buffer";
+// src/commands/key.ts
+/** 256 位随机密钥（base64url），与 @hazejs/core 的 generateKey() 相同 */
+function generateAppKey() {
+	return Buffer.from(crypto.getRandomValues(/* @__PURE__ */ new Uint8Array(32))).toString("base64url");
+}
+var key_default = defineCommand({
+	meta: {
+		name: "key:generate",
+		description: "生成 APP_KEY（签名 Cookie、加密 Session、JWT 默认密钥）并写入 .env"
+	},
+	args: {
+		...rootArg,
+		show: {
+			type: "boolean",
+			description: "只输出，不写入文件",
+			default: false
+		},
+		force: {
+			type: "boolean",
+			description: "覆盖已有的 APP_KEY（已签发的 Cookie / Session / 令牌会失效）",
+			default: false
+		}
+	},
+	run({ args }) {
+		const key = generateAppKey();
+		if (args.show) {
+			console.log(key);
+			return;
+		}
+		const root = resolveRoot(args.root);
+		const file = join(root, ".env");
+		const source = existsSync(file) ? readFileSync(file, "utf8") : "";
+		const line = /^APP_KEY=(.*)$/m.exec(source);
+		if (line?.[1] && !args.force) {
+			consola.warn(`APP_KEY already exists in ${relative(process.cwd(), file) || ".env"}; use --force to replace it`);
+			process.exitCode = 1;
+			return;
+		}
+		const next = line ? source.replace(/^APP_KEY=.*$/m, `APP_KEY=${key}`) : `${source}${source && !source.endsWith("\n") ? "\n" : ""}APP_KEY=${key}\n`;
+		writeFileSync(file, next);
+		consola.success(`APP_KEY written to ${relative(process.cwd(), file) || ".env"}`);
+	}
+});
+export { key_default as default };

package/dist/preview-B6OYX5qM.mjs

@@ -0,0 +1,36 @@
+import { a as resolveRoot, i as parsePort, o as rootArg, s as serverArgs } from "./index.mjs";
+import { defineCommand } from "citty";
+import process from "node:process";
+import { previewServer } from "@hazejs/vite";
+// src/commands/preview.ts
+var preview_default = defineCommand({
+	meta: {
+		name: "preview",
+		description: "按构建时的部署预设本地预览产物（需先 build）"
+	},
+	args: {
+		...rootArg,
+		...serverArgs,
+		open: {
+			type: "boolean",
+			description: "启动后打开浏览器",
+			default: false
+		}
+	},
+	async run({ args }) {
+		const server = await previewServer({
+			root: resolveRoot(args.root),
+			port: parsePort(args.port),
+			host: args.host,
+			open: args.open
+		});
+		server.printUrls();
+		const close = async () => {
+			await server.close();
+			process.exit(0);
+		};
+		process.once("SIGINT", close);
+		process.once("SIGTERM", close);
+	}
+});
+export { preview_default as default };

package/dist/routes-DF0y4tVg.mjs

@@ -0,0 +1,59 @@
+import { a as resolveRoot, o as rootArg } from "./index.mjs";
+import { defineCommand } from "citty";
+import { createDevServer } from "@hazejs/vite";
+import { consola } from "consola";
+import { colors } from "consola/utils";
+// src/commands/routes.ts
+var routes_default = defineCommand({
+	meta: {
+		name: "route:list",
+		description: "列出所有路由"
+	},
+	args: {
+		...rootArg,
+		json: {
+			type: "boolean",
+			description: "以 JSON 输出",
+			default: false
+		}
+	},
+	async run({ args }) {
+		const server = await createDevServer({
+			root: resolveRoot(args.root),
+			listen: false
+		});
+		try {
+			if (!server.app) throw new Error("Application failed to start");
+			const routes = server.app.router.list();
+			if (args.json) {
+				consola.log(JSON.stringify(routes, null, 2));
+				return;
+			}
+			const multiApp = routes.some((route) => route.app);
+			const rows = [[
+				...multiApp ? ["APP", "DOMAIN"] : [],
+				"METHOD",
+				"PATH",
+				"NAME",
+				"HANDLER",
+				"MIDDLEWARE"
+			], ...routes.map((route) => [
+				...multiApp ? [route.app ?? "-", route.domain ?? ""] : [],
+				route.method,
+				route.path,
+				route.name ?? "",
+				route.handler,
+				route.middleware.join(", ")
+			])];
+			const widths = rows[0].map((_, i) => Math.max(...rows.map((row) => row[i].length)));
+			rows.forEach((row, index) => {
+				const line = row.map((cell, i) => cell.padEnd(widths[i])).join("  ").trimEnd();
+				consola.log(index === 0 ? colors.dim(line) : line);
+			});
+			consola.log(colors.dim(`\n${routes.length} route(s)`));
+		} finally {
+			await server.close();
+		}
+	}
+});
+export { routes_default as default };

package/dist/start-DYW9Ar9y.mjs

@@ -0,0 +1,30 @@
+import { a as resolveRoot, o as rootArg, s as serverArgs } from "./index.mjs";
+import { defineCommand } from "citty";
+import { existsSync } from "node:fs";
+import { join, relative } from "node:path";
+import process from "node:process";
+import { loadHazeConfig } from "@hazejs/vite";
+import { pathToFileURL } from "node:url";
+// src/commands/start.ts
+var start_default = defineCommand({
+	meta: {
+		name: "start",
+		description: "运行生产环境产物（需先 build）"
+	},
+	args: {
+		...rootArg,
+		...serverArgs
+	},
+	async run({ args }) {
+		const root = resolveRoot(args.root);
+		const { outDir } = await loadHazeConfig(root, "production");
+		const entry = [join(outDir, "index.mjs"), join(outDir, "server", "index.mjs")].find((file) => existsSync(file));
+		if (!entry) throw new Error(`No build output found in ${relative(process.cwd(), outDir) || "."}. Run \`haze build\` first.`);
+		process.env.NODE_ENV = "production";
+		if (args.port) process.env.PORT = args.port;
+		if (args.host) process.env.HOST = args.host;
+		process.chdir(root);
+		await import(pathToFileURL(entry).href);
+	}
+});
+export { start_default as default };

package/dist/stub-publish-BvtOsp9D.mjs

@@ -0,0 +1,35 @@
+import { a as resolveRoot, o as rootArg, t as STUBS_DIR } from "./index.mjs";
+import { defineCommand } from "citty";
+import { existsSync, readdirSync } from "node:fs";
+import { join, relative } from "node:path";
+import process from "node:process";
+import { consola } from "consola";
+import { copyFile, mkdir } from "node:fs/promises";
+// src/commands/stub-publish.ts
+var stub_publish_default = defineCommand({
+	meta: {
+		name: "stub:publish",
+		description: "把内置 stub 复制到项目 stubs/ 目录以便定制 make:* 生成的代码"
+	},
+	args: {
+		...rootArg,
+		force: {
+			type: "boolean",
+			description: "覆盖已存在的 stub",
+			default: false
+		}
+	},
+	async run({ args }) {
+		const target = join(resolveRoot(args.root), "stubs");
+		await mkdir(target, { recursive: true });
+		let copied = 0;
+		for (const file of readdirSync(STUBS_DIR)) {
+			const destination = join(target, file);
+			if (existsSync(destination) && !args.force) continue;
+			await copyFile(join(STUBS_DIR, file), destination);
+			copied++;
+		}
+		consola.success(`Published ${copied} stub(s) to ${relative(process.cwd(), target) || "."}/`);
+	}
+});
+export { stub_publish_default as default };

package/dist/test-CUMzRaAD.mjs

@@ -0,0 +1,39 @@
+import { a as resolveRoot, n as binOf } from "./index.mjs";
+import { defineCommand } from "citty";
+import { spawn } from "node:child_process";
+import process from "node:process";
+// src/commands/test.ts
+var test_default = defineCommand({
+	meta: {
+		name: "test",
+		description: "运行 Vitest（其余参数原样透传）"
+	},
+	args: { root: {
+		type: "string",
+		description: "项目根目录",
+		default: "."
+	} },
+	async run({ args, rawArgs }) {
+		const root = resolveRoot(args.root);
+		const bin = binOf(root, "vitest");
+		const passthrough = stripRootArg(rawArgs);
+		const vitestArgs = passthrough.length ? passthrough : ["run"];
+		const child = spawn(process.execPath, [bin, ...vitestArgs], {
+			cwd: root,
+			stdio: "inherit",
+			env: {
+				...process.env,
+				NODE_ENV: "test"
+			}
+		});
+		const code = await new Promise((resolve) => child.on("close", (code) => resolve(code ?? 1)));
+		process.exitCode = code;
+	}
+});
+function stripRootArg(rawArgs) {
+	const result = [];
+	for (let i = 0; i < rawArgs.length; i++) if (rawArgs[i] === "--root") i++;
+	else if (!rawArgs[i].startsWith("--root=")) result.push(rawArgs[i]);
+	return result;
+}
+export { test_default as default };

package/dist/typegen-BljZvG5y.mjs

@@ -0,0 +1,34 @@
+import { a as resolveRoot, o as rootArg } from "./index.mjs";
+import { defineCommand } from "citty";
+import { relative } from "node:path";
+import process from "node:process";
+import { createDevServer, loadHazeConfig, writeTypes } from "@hazejs/vite";
+import { consola } from "consola";
+// src/commands/typegen.ts
+var typegen_default = defineCommand({
+	meta: {
+		name: "typegen",
+		description: "生成配置键与路由名类型（.haze/types/haze.d.ts）"
+	},
+	args: rootArg,
+	async run({ args }) {
+		const root = resolveRoot(args.root);
+		const { srcDir } = await loadHazeConfig(root);
+		const server = await createDevServer({
+			root,
+			listen: false
+		});
+		try {
+			if (!server.app) throw new Error("Application failed to start");
+			const result = await writeTypes({
+				root,
+				srcDir,
+				routes: server.app.router.list()
+			});
+			consola.success(`Types written to ${relative(process.cwd(), result.file)} (${result.configs.length} config file(s), ${result.routes.length} named route(s))`);
+		} finally {
+			await server.close();
+		}
+	}
+});
+export { typegen_default as default };

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "@hazejs/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "type": "module",
+  "version": "0.1.1",
+  "description": "The haze command line: dev / build / preview / make:* / db:* / queue:* / schedule:*",
+  "license": "MIT",
+  "homepage": "https://github.com/penna-org/haze/tree/main/packages/cli#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/penna-org/haze.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/penna-org/haze/issues"
+  },
+  "keywords": [
+    "hazejs",
+    "haze",
+    "nodejs",
+    "typescript",
+    "cli",
+    "framework",
+    "generator",
+    "scaffold"
+  ],
+  "bin": {
+    "haze": "./bin/haze.mjs"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "stubs"
+  ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "peerDependencies": {
+    "vite": "^8.0.0"
+  },
+  "dependencies": {
+    "citty": "^0.2.2",
+    "consola": "^3.4.2",
+    "@hazejs/vite": "0.1.1"
+  },
+  "devDependencies": {
+    "vite": "^8.3.5",
+    "@hazejs/orm": "0.1.1",
+    "@hazejs/core": "0.1.1"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch"
+  }
 }

package/stubs/config.stub

@@ -0,0 +1,6 @@
+import { defineConfig, env } from '@hazejs/core'
+
+// 读取：config('{{camelName}}.enabled')
+export default defineConfig(() => ({
+  enabled: env('{{envName}}_ENABLED', true),
+}))

package/stubs/controller.resource.stub

@@ -0,0 +1,35 @@
+import type { HttpContext } from '@hazejs/core'
+import { NotFoundException } from '@hazejs/core'
+
+/**
+ * RESTful 资源控制器，在 route/*.ts 中注册：
+ * r.resource('/{{routePath}}', {{className}})
+ */
+export class {{className}} {
+  /** GET /{{routePath}} */
+  index() {
+    return []
+  }
+
+  /** GET /{{routePath}}/:id */
+  show(ctx: HttpContext) {
+    throw new NotFoundException(`{{name}} ${ctx.param('id')} 不存在`)
+  }
+
+  /** POST /{{routePath}} */
+  async store(ctx: HttpContext) {
+    const data = await ctx.body<Record<string, unknown>>()
+    return ctx.created(data)
+  }
+
+  /** PUT | PATCH /{{routePath}}/:id */
+  async update(ctx: HttpContext) {
+    const data = await ctx.body<Record<string, unknown>>()
+    return { id: ctx.param('id'), ...data }
+  }
+
+  /** DELETE /{{routePath}}/:id */
+  destroy(ctx: HttpContext) {
+    return ctx.noContent()
+  }
+}

package/stubs/controller.stub

@@ -0,0 +1,6 @@
+/** 控制器：接收参数 → 调用服务 → 返回数据（框架统一包装为 { code, message, data }） */
+export class {{className}} {
+  index() {
+    return { message: 'Hello from {{className}}' }
+  }
+}

package/stubs/event.stub

@@ -0,0 +1,6 @@
+import { defineEvent } from '@hazejs/core'
+
+/** 事件（app/event 下自动注册，文件名即事件名）：await {{name}}.emit({ id: 1 }) */
+const {{name}} = defineEvent<{ id: number }>()
+
+export default {{name}}

package/stubs/interceptor.stub

@@ -0,0 +1,9 @@
+import { defineInterceptor } from '@hazejs/core'
+
+/**
+ * 出站拦截器：拿到最终的 Response（统一格式与异常渲染之后），
+ * 可修改响应头，或返回新的 Response 替换；app/interceptor 下按文件名顺序执行。
+ */
+export default defineInterceptor((response, ctx) => {
+  response.headers.set('x-response-time', `${Math.round(performance.now() - ctx.startedAt)}ms`)
+})

package/stubs/job.stub

@@ -0,0 +1,25 @@
+import { defineJob } from '@hazejs/core'
+
+export interface {{name}}Payload {
+  id: number
+}
+
+/**
+ * 队列任务（app/job 下自动注册，文件名即任务名）：
+ * 投递 await {{name}}.dispatch({ id: 1 }, { delay: '10m' })；消费 haze queue:work
+ */
+const {{name}} = defineJob({
+  // 最多执行次数与重试前的等待（秒 / '5m'）
+  tries: 3,
+  backoff: [10, 60],
+  timeout: '1m',
+  async handle(payload: {{name}}Payload, job) {
+    job.logger.info(`{{name}} ${payload.id}`)
+  },
+  // 全部重试失败后调用
+  async failed(payload, error, job) {
+    job.logger.error(`{{name}} ${payload.id} failed`, error)
+  },
+})
+
+export default {{name}}

package/stubs/listener.stub

@@ -0,0 +1,12 @@
+import { defineEvent, defineListener } from '@hazejs/core'
+
+// 替换为要监听的事件：import UserRegistered from '~/app/event/UserRegistered'
+const SomeEvent = defineEvent<{ id: number }>()
+
+/**
+ * 监听器（app/listener 下自动注册，按文件名顺序执行）。
+ * 返回 false 时不再执行后续监听器；耗时操作加 { queue: true }（或 { queue: { tries: 3 } }）排队异步执行
+ */
+export default defineListener(SomeEvent, async (payload, ctx) => {
+  ctx.logger.info(`{{name}} handled ${ctx.event} ${payload.id}`)
+})

package/stubs/middleware.stub

@@ -0,0 +1,13 @@
+import type { HttpContext, Middleware, Next } from '@hazejs/core'
+
+/**
+ * 在 config/middleware.ts 中注册：alias: { {{camelName}}: {{className}} }
+ * 路由中使用：.middleware('{{camelName}}')
+ */
+export class {{className}} implements Middleware {
+  async handle(ctx: HttpContext, next: Next) {
+    ctx.logger.debug(`{{className}}: ${ctx.method} ${ctx.path}`)
+    const response = await next()
+    return response
+  }
+}

package/stubs/model.mongodb.stub

@@ -0,0 +1,17 @@
+import { MongoModel } from '@hazejs/orm/mongo'
+
+/** {{name}} 文档结构：MongoDB 没有固定表结构，在这里声明字段类型 */
+export interface {{className}}Doc {
+  name: string
+  createdAt?: Date
+  updatedAt?: Date
+  deletedAt?: Date | null
+}
+
+/**
+ * {{name}} 模型（集合 {{tableName}}），API 与 SQL 模型一致：
+ * {{className}}.findOrFail(id)、{{className}}.where('name', 'Ada').paginate(1, 20)、{{className}}.create(data)
+ */
+export class {{className}} extends MongoModel.define<{{className}}Doc>('{{tableName}}') {
+  static override softDelete = {{softDelete}}
+}

package/stubs/model.stub

@@ -0,0 +1,10 @@
+import { Model } from '@hazejs/orm'
+import { {{tableVar}} } from '~/database/schema/{{tableName}}'
+
+/**
+ * {{name}} 模型：字段与类型来自 database/schema/{{tableName}}.ts，
+ * 修改表结构后运行 haze db:generate 生成迁移，再 haze db:migrate。
+ */
+export class {{className}} extends Model.define({{tableVar}}) {
+  static override softDelete = {{softDelete}}
+}

package/stubs/policy.stub

@@ -0,0 +1,21 @@
+import { allowGuest, definePolicy, deny } from '@hazejs/core'
+import { {{name}} } from '~/app/model/{{name}}'
+
+/**
+ * {{name}} 的授权策略（app/policy 下自动注册）：
+ * - 控制器：await ctx.authorize('update', {{camelName}})，或 if (await ctx.can('delete', {{camelName}}))
+ * - 路由：.middleware('can:update,{{name}},id')（按路由参数 id 加载并检查，实例存入 ctx.get('{{camelName}}')）
+ * 能力函数返回 true / false / deny('原因')；未登录用户默认拒绝，用 allowGuest() 包装后才会调用。
+ */
+export default definePolicy({{name}}, {
+  // 先于所有能力执行：返回 true / false 直接决定，undefined 继续判断（如超级管理员）
+  // before: user => user?.role === 'admin' || undefined,
+
+  viewAny: allowGuest(() => true),
+  view: allowGuest(() => true),
+  create: () => true,
+  // 示例：只有作者可以修改
+  // update: (user, {{camelName}}) => {{camelName}}.userId === user.id || deny('只能修改自己的{{name}}'),
+  update: () => deny('尚未配置 {{name}} 的修改权限'),
+  delete: () => deny('尚未配置 {{name}} 的删除权限'),
+})

package/stubs/provider.stub

@@ -0,0 +1,11 @@
+import { defineProvider } from '@hazejs/core'
+
+/** 服务提供者：app/provider 下的文件会被自动加载 */
+export default defineProvider({
+  register(_container) {
+    // _container.singleton(SomeService)
+  },
+  boot(_app) {
+    // 所有提供者 register 完成后执行
+  },
+})

package/stubs/repository.stub

@@ -0,0 +1,6 @@
+/** 数据访问层：封装持久化细节（ORM / 外部 API），供服务层调用 */
+export class {{className}} {
+  async findById(id: number): Promise<{ id: number } | undefined> {
+    return { id }
+  }
+}

package/stubs/route.stub

@@ -0,0 +1,7 @@
+import { defineRoutes } from '@hazejs/core'
+
+export default defineRoutes((r) => {
+  r.group({ prefix: '/{{kebabName}}', as: '{{camelName}}.' }, (r) => {
+    r.get('/', () => ({ message: 'ok' })).name('index')
+  })
+})

package/stubs/schema.mysql.stub

@@ -0,0 +1,10 @@
+import { mysqlTable, serial, timestamp, varchar } from 'drizzle-orm/mysql-core'
+
+// 表结构定义（drizzle）：此文件只依赖 drizzle-orm，不要使用 ~ 别名（drizzle-kit 需要直接读取）
+export const {{tableVar}} = mysqlTable('{{tableName}}', {
+  id: serial('id').primaryKey(),
+  name: varchar('name', { length: 255 }).notNull(),
+  createdAt: timestamp('created_at'),
+  updatedAt: timestamp('updated_at'),
+  deletedAt: timestamp('deleted_at'),
+})

package/stubs/schema.postgres.stub

@@ -0,0 +1,10 @@
+import { pgTable, serial, text, timestamp } from 'drizzle-orm/pg-core'
+
+// 表结构定义（drizzle）：此文件只依赖 drizzle-orm，不要使用 ~ 别名（drizzle-kit 需要直接读取）
+export const {{tableVar}} = pgTable('{{tableName}}', {
+  id: serial('id').primaryKey(),
+  name: text('name').notNull(),
+  createdAt: timestamp('created_at'),
+  updatedAt: timestamp('updated_at'),
+  deletedAt: timestamp('deleted_at'),
+})

package/stubs/schema.sqlite.stub

@@ -0,0 +1,10 @@
+import { integer, sqliteTable, text } from 'drizzle-orm/sqlite-core'
+
+// 表结构定义（drizzle）：此文件只依赖 drizzle-orm，不要使用 ~ 别名（drizzle-kit 需要直接读取）
+export const {{tableVar}} = sqliteTable('{{tableName}}', {
+  id: integer('id').primaryKey({ autoIncrement: true }),
+  name: text('name').notNull(),
+  createdAt: integer('created_at', { mode: 'timestamp' }),
+  updatedAt: integer('updated_at', { mode: 'timestamp' }),
+  deletedAt: integer('deleted_at', { mode: 'timestamp' }),
+})

package/stubs/seeder.stub

@@ -0,0 +1,6 @@
+import type { Application } from '@hazejs/core'
+
+/** 数据填充：haze db:seed 按文件名顺序执行 database/seeders 下的文件 */
+export default async function seed(_app: Application): Promise<void> {
+  // await User.create({ name: 'Admin' })
+}

package/stubs/service.stub

@@ -0,0 +1,9 @@
+/**
+ * 业务服务（默认单例），在控制器中注入：
+ * private {{camelName}} = inject({{className}})
+ */
+export class {{className}} {
+  async find(id: number) {
+    return { id }
+  }
+}

package/stubs/test.stub

@@ -0,0 +1,12 @@
+import { useTestApp } from '@hazejs/testing'
+import { describe, expect, it } from 'vitest'
+
+// 每个用例一个全新的应用实例
+const t = useTestApp()
+
+describe('{{kebabName}}', () => {
+  it('responds', async () => {
+    const res = await t.get('/')
+    expect(res.status).toBeLessThan(500)
+  })
+})

package/stubs/validate.stub

@@ -0,0 +1,10 @@
+import * as v from 'valibot'
+
+export const Create{{name}}Schema = v.object({
+  name: v.pipe(v.string('name 必填'), v.trim(), v.minLength(1, 'name 不能为空')),
+})
+
+export const Update{{name}}Schema = v.partial(Create{{name}}Schema)
+
+export type Create{{name}}Input = v.InferOutput<typeof Create{{name}}Schema>
+export type Update{{name}}Input = v.InferOutput<typeof Update{{name}}Schema>

package/stubs/validate.zod.stub

@@ -0,0 +1,10 @@
+import { z } from 'zod'
+
+export const Create{{name}}Schema = z.object({
+  name: z.string({ error: 'name 必填' }).trim().min(1, 'name 不能为空'),
+})
+
+export const Update{{name}}Schema = Create{{name}}Schema.partial()
+
+export type Create{{name}}Input = z.infer<typeof Create{{name}}Schema>
+export type Update{{name}}Input = z.infer<typeof Update{{name}}Schema>