arkenv

ArkEnv 是类型安全的环境变量校验库，统一入口为 import { env } from "./env"，前端与后端使用同一套 API。v1 提供两个校验引擎：@arkenv/core 使用内置 ArkType DSL，@arkenv/standard 支持任何兼容 Standard Schema 的校验器（如 Zod、Valibot，Valibot 走 /valibot 子路径并需安装 @valibot/to-json-schema）。能力包括自动强制转换（string.numeric、number.port、布尔、JSON 对象、数组）与默认值。框架集成含 Vite 插件、Bun 插件、Next.js、Nuxt 及 Node.js 启动期校验；插件会内联前端公开变量并把服务端私密键替换为运行时抛错守卫。CLI 可用 pnpm dlx arkenv init（或 npx arkenv init）初始化，自动检测框架并生成 env.ts，支持 --preset/-P 选择托管商预设（none、vercel、netlify、cloudflare、railway、render、fly），--no-codegen、--force；check 命令支持 --schema/-s、--verify-example、--env-file、--json。面向 AI 代理，推荐 pnpm dlx arkenv init --agent，自动启用 --yes、--quiet、--json，成功时 stdout 返回 ok:true 与 commandId:"init"；被拒绝时返回 ok:false 与 error.code、nextActions，不要预先添加 --force，先按提示判断。限制：CLI 的 schema 发现使用 --schema 或扁平约定路径（env.ts、src/env.ts），不使用 package.json 的 "arkenv" 字段，也不识别 env/server.ts 等拆分布局文件名；托管预设为代码优先，无机器管理的注释块或 CLI 变更命令。使用规范：始终从规范 env 对象读取变量，不要直接用 import.meta.env 或 process.env；不要写环境变量的 ambient .d.ts 类型增强（v0 遗留）；服务端密钥不要加 VITE_、NEXT_PUBLIC_、BUN_PUBLIC_、NUXT_PUBLIC_ 前缀。需隐藏秘密名/类型时可用客户端与服务端双模块方案，Nuxt 客户端不得导入服务端模块。具体收费、价格与更多平台信息暂未提供。