@capgo/capacitor-neon

概览

原生 Neon Auth、JWT 访问，以及面向 Capacitor 的基础 Data API 辅助函数

从这里开始 initialize(); 请参阅 快速入门 以获取核心方法和示例。

平台支持

平台	支持	备注
iOS	是	原生
Android	是	原生
Web 端	否	使用 Capacitor.getPlatform() 做保护

兼容性

插件版本	Capacitor 兼容性	维护中
v8.*.*	v8.*.*	是

插件的主版本号与 Capacitor 一致（Capacitor 8 对应插件 v8）。我们仅对最新的主版本进行积极维护。

核心功能

• 原生 Neon Auth 客户端初始化。
• 邮箱/密码登录与注册。
• 支持 Email OTP、OAuth (Google, GitHub, Vercel) 以及 Session 辅助工具。
• 原生身份验证状态监听器。
• 用于 JavaScript 或后端调用的 JWT 访问权限。
• 针对未登录用户的匿名数据 API token。
• 基础原生 select, insert, update，以及 delete 辅助工具，通过 Neon Data API 实现。

推荐架构

关注点	推荐路径
身份验证	使用 @capgo/capacitor-neon.
会话持久化与刷新	使用 @capgo/capacitor-neon.
高级数据库查询	使用 @neondatabase/neon-js 配合原生 JWT。
Neon Functions 或您自定义的 API	将原生 JWT 作为 Bearer token 发送。
文件上传	使用 Neon 对象存储 通过 Neon Function 或您的 API 实现。存储凭证将保留在服务器端。
AI 功能	调用 Neon AI Gateway 通过 Neon Function 或您的 API 实现。请勿将 gateway token 放入 app bundle 中。

单一事实来源

此参考文档同步自 src/definitions.ts 中的 capacitor-neon.

继续探索 @capgo/capacitor-neon

如果你正在使用 @capgo/capacitor-neon 来规划安全与合规，请结合 加密 了解 Encryption 的实现细节， 合规性 了解合规部分的实现细节， Capgo 安全扫描器 了解 Capgo Security Scanner 的产品工作流， Capgo 安全 用于 Capgo 安全的产品工作流，以及 Capgo 信任中心 用于 Capgo 信任中心的产品工作流。