@supacloud/lite 0.10.0 → 0.12.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [0.12.0](https://github.com/vibeunion/supacloud/compare/supacloud-lite-v0.11.0...supacloud-lite-v0.12.0) (2026-09-03)
+
+
+### Features
+
+* **compiler,app:** add module tags and boundary governance with Nx workspace configuration ([#1110](https://github.com/vibeunion/supacloud/issues/1110)) ([dda9635](https://github.com/vibeunion/supacloud/commit/dda96355ba25a53f1b550e8e95011b1c806a2003))
+
+
+### Miscellaneous Chores
+
+* clean up obsolete scripts, deprecated files and tech debt ([#1109](https://github.com/vibeunion/supacloud/issues/1109)) ([3df42f7](https://github.com/vibeunion/supacloud/commit/3df42f7a3ddfb57866427c648c08fbcac699b7dc))
+
+## [0.11.0](https://github.com/vibeunion/supacloud/compare/supacloud-lite-v0.10.0...supacloud-lite-v0.11.0) (2026-09-02)
+
+
+### Features
+
+* **app:** add command governance boundaries ([#1104](https://github.com/vibeunion/supacloud/issues/1104)) ([48b6f4f](https://github.com/vibeunion/supacloud/commit/48b6f4f1dc9c8f474faa325172ee9f20b42d8332))
+* **lite:** add read-only db check against the live catalog ([#1100](https://github.com/vibeunion/supacloud/issues/1100)) ([f5b2efd](https://github.com/vibeunion/supacloud/commit/f5b2efd7635a72c5b21fb9197f1fe2da5bc5a3f6))
+* **lite:** add response body limits and EdgeRuntime.waitUntil support ([#1099](https://github.com/vibeunion/supacloud/issues/1099)) ([4500d9d](https://github.com/vibeunion/supacloud/commit/4500d9d4abc291b7e76add4a6f936463ff9c6d08))
+* **lite:** enforce function limits and capability declarations locally ([#1097](https://github.com/vibeunion/supacloud/issues/1097)) ([1ec0cfb](https://github.com/vibeunion/supacloud/commit/1ec0cfb43226ed2b3b5d4246d55b7cd8b7504a91))
+
 ## [0.10.0](https://github.com/vibeunion/supacloud/compare/supacloud-lite-v0.9.2...supacloud-lite-v0.10.0) (2026-09-02)
 
 

package/README.md

@@ -96,6 +96,35 @@ framework = "elysia"   # fetch（默认）| elysia | hono
 
 注意：浏览器预检（OPTIONS）会转发给框架应用，框架函数应自行挂载 CORS（如 `@elysiajs/cors`），与生产 Edge Runtime 行为一致。
 
+#### Function 限制与能力声明
+
+`[functions.<name>]` 可声明运行限制（limits）与能力（capabilities），字段与生产 Edge Runtime Manifest v2 一一对应：
+
+```toml
+[functions.api]
+timeout_ms = 15000                        # limits.timeout_ms
+max_request_body_bytes = 1048576          # limits.max_request_body_bytes
+max_response_body_bytes = 524288          # limits.max_response_body_bytes
+wait_until_timeout_ms = 2000              # limits.wait_until_timeout_ms
+outbound_hosts = ["api.example.com"]      # capabilities.outbound_hosts
+secrets = ["OPENAI_API_KEY"]              # capabilities.secrets
+background = true                         # capabilities.background
+```
+
+| config.toml 字段 | 类型 | 语义 | 生产 Edge Runtime 对应 |
+| --- | --- | --- | --- |
+| `timeout_ms` | integer | 单次调用超时；超时返回 504 并 abort 请求 | `limits.timeout_ms` |
+| `max_request_body_bytes` | integer | 请求体上限；content-length 超限返回 413，无长度声明的流式 body 超限则中断读取 | `limits.max_request_body_bytes` |
+| `max_response_body_bytes` | integer | 响应体上限；content-length 超限直接替换为 502，流式 body 超限则在传输中截断（状态行已提交，客户端看到流中断） | `limits.max_response_body_bytes` |
+| `wait_until_timeout_ms` | integer | 响应返回后等待 `EdgeRuntime.waitUntil` 后台任务的最长时间；超时不再等待（任务继续运行，记录警告） | `limits.wait_until_timeout_ms` |
+| `outbound_hosts` | string[] | `fetch` 出站 host 白名单（精确匹配，不含端口）；loopback（localhost/127.0.0.1/::1）始终放行，未声明的 host 直接抛错 | `capabilities.outbound_hosts` |
+| `secrets` | string[] | 函数可见的环境变量白名单：基础三键（`SUPABASE_URL`/`SUPABASE_ANON_KEY`/`SUPABASE_SERVICE_ROLE_KEY`）+ 声明的 key，同时约束 `Deno.env` 与 `ctx.env` | `capabilities.secrets` |
+| `background` | boolean | 是否允许 `EdgeRuntime.waitUntil`；设为 `false` 时调用抛出与生产一致的错误 | `capabilities.background` |
+
+`EdgeRuntime.waitUntil(promise)` 注册跨响应的后台任务：响应照常返回，任务在响应后等待 allSettled（上限 `wait_until_timeout_ms`），任务中再次调用 `waitUntil` 的嵌套任务同样被追踪。Lite 面向本地开发默认**允许** `waitUntil`（向后兼容）；生产 Edge Runtime 需要声明 `background` capability。`backend.close()` 不等待仍在漂移的后台任务。
+
+与生产的差异：Lite 面向本地开发，未声明时默认**不限制**（不包 fetch、env 全量可见）；生产 Edge Runtime 有 900s 超时与 30MB 请求体的默认上限。OPTIONS 预检与正常请求走同一路径、受同一组限制约束。
+
 #### Auth 运行方式
 
 Lite 不下载、安装或启动独立的 GoTrue 进程。`/auth/v1/*` 由同一个 Bun 进程中的内置 Auth 实现处理，并与该 Lite 项目的 PGlite `auth` schema 共享生命周期；这避免了 sidecar 的配置、端口和会话一致性负担。
@@ -124,6 +153,7 @@ supacloud-lite gen types [-o database.types.ts]
 supacloud-lite db reset
 supacloud-lite db diff [-f migration_name]
 supacloud-lite db pull [migration_name]
+supacloud-lite db check [--module-file supabase/db/modules.ts]
 supacloud-lite snapshot create [-o backup.tar.gz]
 supacloud-lite snapshot restore <backup.tar.gz> [--force]
 supacloud-lite upgrade [-o pre-upgrade.tar.gz]
@@ -134,6 +164,8 @@ supacloud-lite version
 
 首次初始化或 state 目录不存在/为空时，先运行 `supacloud-lite migrate`。`db reset` 只接受已经初始化且保留有效 `secrets.json` 标记的 state；它不会为 reset 创建或覆盖项目 secrets。
 
+`db check` 是只读治理命令：加载 `@supacloud/db` 的 `defineDatabaseModule` 清单（默认 `supabase/db/modules.ts`），对声明的 SQL 源做静态 lint，并把声明的表/RLS 策略/RPC/授权与 Lite 数据库的真实 Catalog 对账（pg_policy、pg_proc、grants）。存在 error 级问题（声明缺失、RLS 未启用、security definer 未固定 search_path、PUBLIC 授权）时以非零退出码结束，可接入 CI；不会修改数据库。
+
 通用参数：
 
 - `--project-dir`：包含 `supabase/` 的项目目录
@@ -521,6 +553,7 @@ supacloud-lite gen types [-o database.types.ts]
 supacloud-lite db reset
 supacloud-lite db diff [-f migration_name]
 supacloud-lite db pull [migration_name]
+supacloud-lite db check [--module-file supabase/db/modules.ts]
 supacloud-lite snapshot create [-o backup.tar.gz]
 supacloud-lite snapshot restore <backup.tar.gz> [--force]
 supacloud-lite upgrade [-o pre-upgrade.tar.gz]