@supacloud/compiler 0.3.1 → 0.4.1

package/dist/types.d.ts

@@ -1,6 +1,6 @@
 /**
- * ApplicationGraph：编译器从源码 AST 构建出的静态应用图。
- * 运行期不反射、无容器，所有信息都在该结构与生成代码中显式给出。
+ * ApplicationGraph: Static application graph built by the compiler from source AST.
+ * No runtime reflection or container; all metadata is explicitly represented here and in generated code.
  */
 export type Scope = "application" | "request" | "job";
 export type ProviderKind = "class" | "value" | "factory" | "existing";
@@ -13,7 +13,7 @@ export interface Diagnostic {
     line?: number;
 }
 export interface ProviderNode {
-    /** token 名（InjectionToken 变量名或类名）。 */
+    /** Token name (InjectionToken variable name or class name). */
     token: string;
     tokenKind: TokenKind;
     kind: ProviderKind;
@@ -22,16 +22,16 @@ export interface ProviderNode {
     useFactoryName?: string;
     useExisting?: string;
     scope: Scope;
-    /** token 名，构造/工厂参数顺序。 */
+    /** Token names in constructor/factory parameter order. */
     deps: string[];
     exported: boolean;
     file: string;
     line: number;
-    /** useClass/useFactory/useValue 符号的模块相对路径（供生成 import）。 */
+    /** Relative module path of useClass/useFactory/useValue symbol (for import generation). */
     importPath?: string;
 }
 export interface RouteNode {
-    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
     path: string;
     handler: string;
     body?: string;
@@ -49,7 +49,7 @@ export interface ControllerNode {
     routes: RouteNode[];
     file: string;
     importPath: string;
-    /** 路由 schema 符号名 → 模块相对路径（供生成 import）。 */
+    /** Route schema symbol name -> relative module path (for import generation). */
     schemaImports?: Record<string, string>;
 }
 export interface CommandNode {
@@ -65,60 +65,114 @@ export interface QueryNode {
     name: string;
 }
 export interface ModuleNode {
-    /** @Module({ name }) 或 defineModule 的 name。 */
+    /** Name from @Module({ name }) or defineModule. */
     name: string;
     className: string;
-    /** 模块标签（如 ['scope:case', 'type:feature']），用于架构边界治理。 */
+    /** Module tags (e.g. ['scope:case', 'type:feature']) for architecture boundary governance. */
     tags?: string[];
     file: string;
     line: number;
-    /** 被 import 模块的 name。 */
+    /** Names of imported modules. */
     imports: string[];
     providers: ProviderNode[];
     controllers: ControllerNode[];
     commands: CommandNode[];
     queries: QueryNode[];
-    /** 导出的 token 名。 */
+    /** Exported token names. */
     exports: string[];
 }
 export interface ApplicationGraph {
     modules: ModuleNode[];
-    /** 被依赖但无任何模块提供的 token 名（平台注入）。 */
+    /** Depended token names provided by platform injection rather than any module. */
     externalTokens: string[];
     /**
-     * 分析阶段产生的诊断（如 missing-deps），由 compileProject 合并进结果。
-     * 不写入 app.manifest.json。
+     * Diagnostics produced during analysis (e.g. missing-deps), merged by compileProject.
+     * Omitted from app.manifest.json.
      */
     diagnostics?: Diagnostic[];
     /**
-     * InjectionToken 变量名 → 字符串 name（如 REQUEST_CONTEXT →
-     * "supacloud.request-context"），供代码生成识别内置上下文 token。
-     * 不写入 app.manifest.json。
+     * InjectionToken variable name -> string name (e.g. REQUEST_CONTEXT ->
+     * "supacloud.request-context"), used during code generation to identify built-in context tokens.
+     * Omitted from app.manifest.json.
      */
     tokenNames?: Record<string, string>;
 }
 export interface CompileOptions {
-    /** 项目根（含 tsconfig）。 */
+    /** Project root directory (containing tsconfig). */
     rootDir: string;
-    /** glob，默认 ['**\/*.module.ts', '**\/*.ts']。 */
+    /** Glob patterns, defaults to ['**\/*.module.ts', '**\/*.ts']. */
     include?: string[];
-    /** 生成目录（如 <rootDir>/generated）。 */
+    /** Output directory (e.g. <rootDir>/generated). */
     outDir: string;
-    /** warn 级诊断升级为 error。 */
+    /** Upgrade warn-level diagnostics to error. */
     strict?: boolean;
-    /** 模块边界与架构治理规则（受 Nx enforce-module-boundaries 启发）。 */
+    /** Built-in architecture boundary preset (for example, 'modular-monolith'). */
+    moduleBoundaryPreset?: ModuleBoundaryPresetName;
+    /** Module boundary and architecture governance rules inspired by Nx enforce-module-boundaries. */
     moduleBoundaries?: ModuleBoundaryRule[];
+    /** Allow routes to bind directly to @Command (defaults to true). */
+    allowRouteCommandBindings?: boolean;
+    /** Runtime Command executor capabilities used to validate declared governance metadata. */
+    commandCapabilities?: CommandExecutionCapabilities;
+    /** Disallow controllers from directly injecting DB clients (enforces presentation layer separation). */
+    disallowControllerDirectDb?: boolean;
+    /** Detect modules declared in the project that are unreachable from any root module. */
+    detectOrphanModules?: boolean;
 }
 export interface ModuleBoundaryRule {
-    /** 源模块标签模式或标签（如 'type:ui', 'scope:case', '*'）。 */
+    /** Source module tag pattern or tag (for example, 'type:ui', 'scope:case', or '*'). */
     sourceTag: string;
-    /** 源模块仅允许依赖具有这些标签的模块。 */
+    /** Tags allowed for modules imported by the source module. */
     onlyDependOnLibsWithTags?: string[];
-    /** 源模块禁止依赖具有这些标签的模块。 */
+    /** Tags forbidden for modules imported by the source module. */
     bannedDependenciesWithTags?: string[];
 }
+/** Names of built-in module boundary presets. */
+export type ModuleBoundaryPresetName = "modular-monolith" | "feature-slices" | "vertical-slices" | "angular-enterprise" | "angular" | "clean-architecture" | "domain-driven";
+export interface ModuleBoundaryProfile {
+    name: ModuleBoundaryPresetName;
+    description: string;
+    rules: ModuleBoundaryRule[];
+}
+export interface ValidateOptions {
+    strict?: boolean;
+    moduleBoundaryPreset?: ModuleBoundaryPresetName;
+    moduleBoundaries?: ModuleBoundaryRule[];
+    /** Allow routes to bind directly to @Command (defaults to true). */
+    allowRouteCommandBindings?: boolean;
+    /** Runtime Command executor capabilities used to validate declared governance metadata. */
+    commandCapabilities?: CommandExecutionCapabilities;
+    /** Disallow controllers from directly injecting DB clients. */
+    disallowControllerDirectDb?: boolean;
+    /** Detect modules declared in the project that are unreachable from any root module. */
+    detectOrphanModules?: boolean;
+}
+/** Runtime capabilities declared by the Command executor. */
+export interface CommandExecutionCapabilities {
+    /** Whether runtime permission checks are supported. */
+    permission?: boolean;
+    /** Whether runtime audit persistence is supported. */
+    audit?: boolean;
+    /** Whether idempotency receipts are supported. */
+    idempotency?: boolean;
+    /**
+     * Transaction execution capability:
+     * - true: full transaction boundaries are supported;
+     * - 'rpc-only': application-level transactions are unavailable and multi-table writes must use one DB RPC (warn);
+     * - false: transaction support is disabled (error).
+     */
+    transaction?: boolean | "rpc-only";
+}
 export interface CompileResult {
     diagnostics: Diagnostic[];
     graph: ApplicationGraph;
     written: string[];
 }
+export interface CheckProjectResult {
+    /** Whether generated artifacts exactly match the files on disk. */
+    upToDate: boolean;
+    /** Relative paths of missing or mismatched artifacts. */
+    mismatches: string[];
+    diagnostics: Diagnostic[];
+    graph: ApplicationGraph;
+}

package/dist/util.d.ts

@@ -1,15 +1,15 @@
 /**
- * token 名 → services 对象的 key。
- * CASE_REPOSITORY → caseRepository、LOGGER → logger（常量命名转 camelCase），
- * CaseService → caseService（PascalCase 首字母小写）。
+ * Token name -> key in services object.
+ * CASE_REPOSITORY -> caseRepository, LOGGER -> logger (convert CONSTANT_CASE to camelCase),
+ * CaseService -> caseService (lowercase first letter of PascalCase).
  */
 export declare function camelName(token: string): string;
-/** 计算 from 目录到 to 文件的相对 import 路径（去扩展名，保证 ./ 或 ../ 前缀）。 */
+/** Computes relative import path from fromDir to toFile (stripping extension, ensuring ./ or ../ prefix). */
 export declare function relativeImportPath(fromDir: string, toFile: string): string;
-/** 内置上下文 token 的字符串 name（与 @supacloud/app 的 REQUEST_CONTEXT/JOB_CONTEXT 对齐）。 */
+/** String names of built-in context tokens (aligned with REQUEST_CONTEXT/JOB_CONTEXT in @supacloud/app). */
 export declare const REQUEST_CONTEXT_TOKEN_NAME = "supacloud.request-context";
 export declare const JOB_CONTEXT_TOKEN_NAME = "supacloud.job-context";
-/** 判断 token 是否为内置 request 上下文（变量名 REQUEST_CONTEXT 或 token name 匹配）。 */
+/** Determines whether token is built-in request context (variable name REQUEST_CONTEXT or matching token name). */
 export declare function isRequestContextToken(token: string, tokenNames?: Record<string, string>): boolean;
-/** 判断 token 是否为内置 job 上下文。 */
+/** Determines whether token is built-in job context. */
 export declare function isJobContextToken(token: string, tokenNames?: Record<string, string>): boolean;

package/dist/validate.d.ts

@@ -1,9 +1,6 @@
-import type { ApplicationGraph, Diagnostic, ModuleBoundaryRule } from "./types";
+import type { ApplicationGraph, Diagnostic, ValidateOptions } from "./types";
 /**
- * 校验 ApplicationGraph，产出诊断列表。
- * strict 时 warn 级诊断升级为 error。
+ * Validates ApplicationGraph and produces diagnostics list.
+ * In strict mode, warn-level diagnostics are promoted to error.
  */
-export declare function validateGraph(graph: ApplicationGraph, options?: boolean | {
-    strict?: boolean;
-    moduleBoundaries?: ModuleBoundaryRule[];
-}): Diagnostic[];
+export declare function validateGraph(graph: ApplicationGraph, options?: boolean | ValidateOptions): Diagnostic[];

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@supacloud/compiler",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "Static compiler for @supacloud/app metadata: builds the application graph from AST, validates it, and generates reflection-free factory code",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "bin": {
+    "supacloud-compiler": "./dist/cli.js"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -19,7 +22,7 @@
   ],
   "scripts": {
     "build": "bun run clean && bun run build:js && bun run build:types",
-    "build:js": "bun build src/index.ts --outdir dist --target node --external ts-morph",
+    "build:js": "bun build src/index.ts src/cli.ts --outdir dist --target node --external ts-morph",
     "build:types": "tsc -p tsconfig.json --emitDeclarationOnly",
     "clean": "rm -rf dist",
     "prepublishOnly": "bun run build",