用途:维护 Apex 标准库(命名空间、类、方法、枚举)的 .cls 存根文件。存根位于本仓库 packages/apex-parser-ast/src/resources/StandardApexLibrary/ 与 jorje 仓库 apex-jorje/apex-jorje-lsp/src/main/resources/StandardApexLibrary/,两处需保持同步,权威来源为本仓库生成流程。
主要能力:从 Salesforce Symbol Table API 抓取 Apex 类型定义,将 JSON 转换为 .cls 文件,并重建 protobuf 缓存。抓取阶段发现命名空间并写入 build/api-stubs/;生成阶段校验输入、替换配置命名空间的输出并保留手写内置类;compile 阶段解析 .cls 生成 protobuf 缓存。
使用方式:先将 Salesforce CLI 认证到暴露 Symbol Table API 的组织(264 org farm 或更高)。在 packages/apex-parser-ast 目录下执行 npm run update:stubs 抓取默认组织全部类型定义并生成存根,再执行 npm run compile 重建 protobuf 缓存。可指定其他组织、API 版本或命名空间:npm run fetch:api-stubs -- --org myorg、npm run fetch:api-stubs -- --api-version v68.0、npm run fetch:api-stubs -- --namespace System,然后执行 npm run generate:api-stubs。
关键规则与限制:TARGET_NAMESPACES 决定哪些命名空间输出到 StandardApexLibrary/,其余命名空间仍进入类型注册表但不生成 .cls;BUILTIN_CLASSES 与 BUILTIN_NAMESPACED_CLASSES 为跳过列表,手写内置类在生成时保留。macOS 文件系统大小写不敏感,ls 与本地读取会静默折叠大小写,可能导致 Linux CI 上不可复现的测试失败;应使用 git ls-tree -r HEAD 获取真实提交名,重命名大小写须经临时名两步 git mv,并审计文件名与声明类名不一致的 .cls。快照测试 emptyStubDetection.snapshot.test.ts 跟踪无成员存根,可用 npx jest emptyStubDetection --updateSnapshot 更新;macOS 上可能误报通过,必要时直接编辑快照。同步到 jorje 为手动复制 StandardApexLibrary/ 目录,再在 jorje 中构建测试。其余细节暂未提供。