@seaverse/data-sdk 0.1.8 → 0.1.9

package/README.md

@@ -174,7 +174,7 @@ SDK 会按照以下优先级自动获取 appId：
 1. 显式传入的 `appId` 参数（最高优先级）
 2. `localStorage.getItem('app_id')` - **标准 key**
 3. 环境变量 `process.env.APP_ID`
-4. PostMessage 从父窗口获取（iframe 场景，使用 `seaverse:get_appid` 协议）
+4. PostMessage 从父窗口获取（iframe 场景，使用 `seaverse:get_appId` 协议）
 
 > 💡 **最佳实践**：
 > - 使用 `@seaverse/auth-sdk` 进行登录，token 会自动存储到 `localStorage.auth_token`
@@ -419,12 +419,12 @@ window.addEventListener('message', (event) => {
   }
 
   // 处理 appId 请求
-  if (event.data.type === 'seaverse:get_appid') {
+  if (event.data.type === 'seaverse:get_appId') {
     const appId = localStorage.getItem('app_id');
 
     if (appId) {
       event.source.postMessage({
-        type: 'seaverse:appid',
+        type: 'seaverse:appId',
         payload: {
           appId: appId
         }
@@ -453,7 +453,7 @@ const notes = await query({ table: 'notes' });
 | 协议 | 请求 type | 响应 type | 响应 payload |
 |------|----------|----------|-------------|
 | Token | `seaverse:get_token` | `seaverse:token` | `{ accessToken: string, expiresIn: number }` |
-| AppId | `seaverse:get_appid` | `seaverse:appid` | `{ appId: string }` |
+| AppId | `seaverse:get_appId` | `seaverse:appId` | `{ appId: string }` |
 | 错误 | - | `seaverse:error` | `{ error: string }` |
 
 #### 服务端渲染（SSR/SSG）
@@ -613,12 +613,19 @@ psql -h <host> -U postgres -d <database> -f init/init-schema.sql
 
 ## 版本历史
 
+### v0.1.9 (2026-01-15)
+
+**🔧 PostMessage 协议调整**
+
+- ✅ **协议命名优化**：PostMessage appId 协议从 `seaverse:get_appid` / `seaverse:appid` 改为 `seaverse:get_appId` / `seaverse:appId`（驼峰命名）
+- ✅ **保持一致性**：与 token 协议命名风格保持一致
+
 ### v0.1.8 (2026-01-15)
 
 **🎉 AppId 自动获取功能**
 
 - ✅ **AppId 自动获取**：支持从 localStorage/环境变量/PostMessage 自动获取 appId
-- ✅ **PostMessage 协议扩展**：新增 `seaverse:get_appid` / `seaverse:appid` 协议
+- ✅ **PostMessage 协议扩展**：新增 `seaverse:get_appId` / `seaverse:appId` 协议
 - ✅ **零配置使用**：`initData()` 和 `DataClient.create()` 现在可以不传任何参数
 - ✅ **优先级统一**：appId 和 token 采用相同的获取优先级
 - ✅ **环境变量支持**：新增 `APP_ID` 环境变量支持

package/dist/index.cjs

@@ -253,8 +253,8 @@ async function getTokenFromParent(timeout = 5000) {
  *
  * 此函数允许接收来自任何源的 PostMessage 消息，便于跨域 iframe 集成。
  * 使用 seaverse 协议与父页面通信：
- * - 发送: { type: 'seaverse:get_appid' }
- * - 接收: { type: 'seaverse:appid', payload: { appId: string } }
+ * - 发送: { type: 'seaverse:get_appId' }
+ * - 接收: { type: 'seaverse:appId', payload: { appId: string } }
  * - 错误: { type: 'seaverse:error', error: string }
  *
  * @param timeout 超时时间（毫秒），默认 5000ms
@@ -267,7 +267,7 @@ async function getAppIdFromParent(timeout = 5000) {
     return new Promise((resolve) => {
         const messageHandler = (event) => {
             // 验证消息格式
-            if (event.data && event.data.type === 'seaverse:appid') {
+            if (event.data && event.data.type === 'seaverse:appId') {
                 cleanup();
                 // 从 payload.appId 中获取 appId
                 const appId = event.data.payload?.appId;
@@ -292,7 +292,7 @@ async function getAppIdFromParent(timeout = 5000) {
         globalThis.window.addEventListener('message', messageHandler);
         // 向父页面发送请求（允许任何源接收）
         try {
-            globalThis.window.parent.postMessage({ type: 'seaverse:get_appid' }, '*' // 允许任何源，支持跨域场景
+            globalThis.window.parent.postMessage({ type: 'seaverse:get_appId' }, '*' // 允许任何源，支持跨域场景
             );
         }
         catch (e) {

package/dist/index.js

@@ -251,8 +251,8 @@ async function getTokenFromParent(timeout = 5000) {
  *
  * 此函数允许接收来自任何源的 PostMessage 消息，便于跨域 iframe 集成。
  * 使用 seaverse 协议与父页面通信：
- * - 发送: { type: 'seaverse:get_appid' }
- * - 接收: { type: 'seaverse:appid', payload: { appId: string } }
+ * - 发送: { type: 'seaverse:get_appId' }
+ * - 接收: { type: 'seaverse:appId', payload: { appId: string } }
  * - 错误: { type: 'seaverse:error', error: string }
  *
  * @param timeout 超时时间（毫秒），默认 5000ms
@@ -265,7 +265,7 @@ async function getAppIdFromParent(timeout = 5000) {
     return new Promise((resolve) => {
         const messageHandler = (event) => {
             // 验证消息格式
-            if (event.data && event.data.type === 'seaverse:appid') {
+            if (event.data && event.data.type === 'seaverse:appId') {
                 cleanup();
                 // 从 payload.appId 中获取 appId
                 const appId = event.data.payload?.appId;
@@ -290,7 +290,7 @@ async function getAppIdFromParent(timeout = 5000) {
         globalThis.window.addEventListener('message', messageHandler);
         // 向父页面发送请求（允许任何源接收）
         try {
-            globalThis.window.parent.postMessage({ type: 'seaverse:get_appid' }, '*' // 允许任何源，支持跨域场景
+            globalThis.window.parent.postMessage({ type: 'seaverse:get_appId' }, '*' // 允许任何源，支持跨域场景
             );
         }
         catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seaverse/data-sdk",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "SeaVerse Data SDK - PostgreSQL/AlloyDB data operations with RLS-based permissions",
   "keywords": [
     "seaverse",