返回文档
docs/functions.md

Edge Functions

通过 QuickJS (WASM) 在 Next.js 进程内运行用户脚本，强限额 + 强沙箱。

触发方式

Trigger说明
sdkuniid.functions.invoke("fnName", payload)
httpPOST /api/v1/functions/[fnId]/invoke（同上）
cron通过 CronJob 调度
event`bus.on("record.created" \"file.uploaded" \...)` → invoke

函数模板

export default async function handler(event) {
  // event = { payload, ctx: { userId, appId }, log, env }
  uniid.log("hello", event.payload);

  const res = await uniid.fetch("https://api.example.com/data");
  const json = await res.json();

  return { ok: true, items: json.items.length };
}

Host API（注入到沙箱）

  • uniid.log(...args) — 记录到 FunctionInvocation.logs
  • uniid.fetch(url, init?) — 受全局配置中的 Fetch 域名白名单限制；默认 5s 超时，响应出站字节计入月度 egress 配额
  • uniid.data.{query,get,create,update,delete,fieldOps} — 走 PolicyEngine，以 $function:{name} 身份访问当前 App 数据
  • uniid.files.{getDownloadUrl,share,getActiveShareToken,revokeShareTokens} — 仅允许访问当前 App 文件，下载/分享访问计入 egress 配额
  • uniid.broadcast(channel, payload?) — 向当前 App 的 Realtime broadcast 频道发送消息

uniid.data.* 默认不是管理员绕过；需要在 Policy DSL 中显式授权 $function:{functionName}。

限额

资源默认可配置
内存64 MBper-function memoryMb
时长5000 msper-function timeoutMs
fetch 域名空（全禁）全局配置中的 Fetch 域名白名单

超出 → FUNC_TIMEOUT / FUNC_OOM 错误码。

部署

  1. 在控制台 /console/apps/[appId]/functions 新建函数（Monaco 编辑器）
  2. 保存 → 后端 FunctionDeployment 自动版本 +1
  3. 切换 active version（默认部署后自动设为 active）
  4. 实时日志：控制台日志面板订阅 FunctionInvocation SSE 流

安全清单

  • 禁止访问 process / fs / 原生 fetch / eval / Function
  • 所有 host call 通过 marshalToHost 序列化（避免泄漏 QuickJS 句柄）
  • fetch 强制走域名白名单；缺省全禁
  • 超时硬 kill；OOM 直接抛出
  • 输出 / 日志 / payload 都做 16KB 截断后再入库