@supacloud/compiler 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * ApplicationGraph：编译器从源码 AST 构建出的静态应用图。
+ * 运行期不反射、无容器，所有信息都在该结构与生成代码中显式给出。
+ */
+export type Scope = "application" | "request" | "job";
+export type ProviderKind = "class" | "value" | "factory" | "existing";
+export type TokenKind = "injection-token" | "class";
+export interface Diagnostic {
+    severity: "error" | "warn";
+    code: string;
+    message: string;
+    file?: string;
+    line?: number;
+}
+export interface ProviderNode {
+    /** token 名（InjectionToken 变量名或类名）。 */
+    token: string;
+    tokenKind: TokenKind;
+    kind: ProviderKind;
+    useClass?: string;
+    useValueExpr?: string;
+    useFactoryName?: string;
+    useExisting?: string;
+    scope: Scope;
+    /** token 名，构造/工厂参数顺序。 */
+    deps: string[];
+    exported: boolean;
+    file: string;
+    line: number;
+    /** useClass/useFactory/useValue 符号的模块相对路径（供生成 import）。 */
+    importPath?: string;
+}
+export interface RouteNode {
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    path: string;
+    handler: string;
+    body?: string;
+    params?: string;
+    query?: string;
+    response?: string;
+}
+export interface ControllerNode {
+    className: string;
+    path: string;
+    scope: Scope;
+    deps: string[];
+    routes: RouteNode[];
+    file: string;
+    importPath: string;
+    /** 路由 schema 符号名 → 模块相对路径（供生成 import）。 */
+    schemaImports?: Record<string, string>;
+}
+export interface CommandNode {
+    className: string;
+    name: string;
+    permission?: string;
+    transaction?: string;
+    audit?: string;
+    idempotency?: string;
+}
+export interface QueryNode {
+    className: string;
+    name: string;
+}
+export interface ModuleNode {
+    /** @Module({ name }) 或 defineModule 的 name。 */
+    name: string;
+    className: string;
+    file: string;
+    line: number;
+    /** 被 import 模块的 name。 */
+    imports: string[];
+    providers: ProviderNode[];
+    controllers: ControllerNode[];
+    commands: CommandNode[];
+    queries: QueryNode[];
+    /** 导出的 token 名。 */
+    exports: string[];
+}
+export interface ApplicationGraph {
+    modules: ModuleNode[];
+    /** 被依赖但无任何模块提供的 token 名（平台注入）。 */
+    externalTokens: string[];
+    /**
+     * 分析阶段产生的诊断（如 missing-deps），由 compileProject 合并进结果。
+     * 不写入 app.manifest.json。
+     */
+    diagnostics?: Diagnostic[];
+    /**
+     * InjectionToken 变量名 → 字符串 name（如 REQUEST_CONTEXT →
+     * "supacloud.request-context"），供代码生成识别内置上下文 token。
+     * 不写入 app.manifest.json。
+     */
+    tokenNames?: Record<string, string>;
+}
+export interface CompileOptions {
+    /** 项目根（含 tsconfig）。 */
+    rootDir: string;
+    /** glob，默认 ['**\/*.module.ts', '**\/*.ts']。 */
+    include?: string[];
+    /** 生成目录（如 <rootDir>/generated）。 */
+    outDir: string;
+    /** warn 级诊断升级为 error。 */
+    strict?: boolean;
+}
+export interface CompileResult {
+    diagnostics: Diagnostic[];
+    graph: ApplicationGraph;
+    written: string[];
+}

package/dist/util.d.ts

@@ -0,0 +1,15 @@
+/**
+ * token 名 → services 对象的 key。
+ * CASE_REPOSITORY → caseRepository、LOGGER → logger（常量命名转 camelCase），
+ * CaseService → caseService（PascalCase 首字母小写）。
+ */
+export declare function camelName(token: string): string;
+/** 计算 from 目录到 to 文件的相对 import 路径（去扩展名，保证 ./ 或 ../ 前缀）。 */
+export declare function relativeImportPath(fromDir: string, toFile: string): string;
+/** 内置上下文 token 的字符串 name（与 @supacloud/app 的 REQUEST_CONTEXT/JOB_CONTEXT 对齐）。 */
+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 匹配）。 */
+export declare function isRequestContextToken(token: string, tokenNames?: Record<string, string>): boolean;
+/** 判断 token 是否为内置 job 上下文。 */
+export declare function isJobContextToken(token: string, tokenNames?: Record<string, string>): boolean;

package/dist/validate.d.ts

@@ -0,0 +1,6 @@
+import type { ApplicationGraph, Diagnostic } from "./types";
+/**
+ * 校验 ApplicationGraph，产出诊断列表。
+ * strict 时 warn 级诊断升级为 error。
+ */
+export declare function validateGraph(graph: ApplicationGraph, strict?: boolean): Diagnostic[];

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@supacloud/compiler",
+  "version": "0.1.0",
+  "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",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "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:types": "tsc -p tsconfig.json --emitDeclarationOnly",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "bun run build",
+    "test": "bun test",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "typecheck:test": "tsc -p tsconfig.test.json --noEmit"
+  },
+  "keywords": [
+    "supacloud",
+    "compiler",
+    "di",
+    "codegen",
+    "elysia"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vibeunion/supacloud.git",
+    "directory": "packages/compiler"
+  },
+  "dependencies": {
+    "ts-morph": "^26.0.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.4.0",
+    "typescript": "^7.0.2"
+  }
+}