@seaverse/dataservice 1.8.3 → 1.8.4

package/dist/index.d.mts

@@ -302,6 +302,53 @@ declare function debugSetToken(token: string): void;
  * ```
  */
 declare function setAppId(appId: string): void;
+/**
+ * Create a new Data Service client
+ *
+ * The SDK automatically obtains the service host from the parent page via PostMessage (500ms timeout).
+ * If the fetch fails, it falls back to the default host: https://dataservice-api.seaverse.ai
+ *
+ * AI-friendly: Single entry point with clear configuration
+ *
+ * @param config - Client configuration (optional)
+ * @returns DataServiceClient instance
+ *
+ * @example
+ * ```typescript
+ * // Auto-fetch token and serviceHost from parent page (iframe)
+ * // ServiceHost fetch: 500ms timeout, falls back to https://dataservice-api.seaverse.ai
+ * const client = await createClient({});
+ *
+ * // For development/testing, use debugSetToken
+ * import { debugSetToken, createClient } from '@seaverse/dataservice';
+ * debugSetToken('your-test-token');
+ * const client = await createClient({});
+ *
+ * // appId is automatically extracted from current URL
+ * const order = await client.userData.collection('orders').insert({ ... });
+ * const orders = await client.userData.collection('orders').select().execute();
+ * ```
+ */
+/**
+ * Notify the parent (SeaVerse App or iframe) of the current game score.
+ *
+ * Fire-and-forget — no response is expected.
+ *
+ * Protocol:
+ * - RN WebView: window.ReactNativeWebView.postMessage({ type: 'seaverse:game_score', score: number })
+ * - iframe:     window.parent.postMessage({ type: 'seaverse:game_score', score: number }, '*')
+ *
+ * @param score Current game score (must be a non-negative number)
+ *
+ * @example
+ * ```typescript
+ * import { notifyGameScore } from '@seaverse/dataservice';
+ *
+ * // Call whenever the score updates
+ * notifyGameScore(1234);
+ * ```
+ */
+declare function notifyGameScore(score: number): void;
 declare function createClient(config?: ClientConfig): Promise<DataServiceClient>;
 
 /**
@@ -350,6 +397,6 @@ declare function createClient(config?: ClientConfig): Promise<DataServiceClient>
  * ```
  */
 
-declare const VERSION = "1.8.0";
+declare const VERSION = "1.8.4";
 
-export { type APIError, type ClientConfig, type Collection, type DataRecord, type DataServiceClient, DataServiceError, type DataTable, type OrderOptions, type QueryBuilder, type QueryFilter, type UserDataStats, VERSION, createClient, debugSetToken, setAppId };
+export { type APIError, type ClientConfig, type Collection, type DataRecord, type DataServiceClient, DataServiceError, type DataTable, type OrderOptions, type QueryBuilder, type QueryFilter, type UserDataStats, VERSION, createClient, debugSetToken, notifyGameScore, setAppId };

package/dist/index.d.ts

@@ -302,6 +302,53 @@ declare function debugSetToken(token: string): void;
  * ```
  */
 declare function setAppId(appId: string): void;
+/**
+ * Create a new Data Service client
+ *
+ * The SDK automatically obtains the service host from the parent page via PostMessage (500ms timeout).
+ * If the fetch fails, it falls back to the default host: https://dataservice-api.seaverse.ai
+ *
+ * AI-friendly: Single entry point with clear configuration
+ *
+ * @param config - Client configuration (optional)
+ * @returns DataServiceClient instance
+ *
+ * @example
+ * ```typescript
+ * // Auto-fetch token and serviceHost from parent page (iframe)
+ * // ServiceHost fetch: 500ms timeout, falls back to https://dataservice-api.seaverse.ai
+ * const client = await createClient({});
+ *
+ * // For development/testing, use debugSetToken
+ * import { debugSetToken, createClient } from '@seaverse/dataservice';
+ * debugSetToken('your-test-token');
+ * const client = await createClient({});
+ *
+ * // appId is automatically extracted from current URL
+ * const order = await client.userData.collection('orders').insert({ ... });
+ * const orders = await client.userData.collection('orders').select().execute();
+ * ```
+ */
+/**
+ * Notify the parent (SeaVerse App or iframe) of the current game score.
+ *
+ * Fire-and-forget — no response is expected.
+ *
+ * Protocol:
+ * - RN WebView: window.ReactNativeWebView.postMessage({ type: 'seaverse:game_score', score: number })
+ * - iframe:     window.parent.postMessage({ type: 'seaverse:game_score', score: number }, '*')
+ *
+ * @param score Current game score (must be a non-negative number)
+ *
+ * @example
+ * ```typescript
+ * import { notifyGameScore } from '@seaverse/dataservice';
+ *
+ * // Call whenever the score updates
+ * notifyGameScore(1234);
+ * ```
+ */
+declare function notifyGameScore(score: number): void;
 declare function createClient(config?: ClientConfig): Promise<DataServiceClient>;
 
 /**
@@ -350,6 +397,6 @@ declare function createClient(config?: ClientConfig): Promise<DataServiceClient>
  * ```
  */
 
-declare const VERSION = "1.8.0";
+declare const VERSION = "1.8.4";
 
-export { type APIError, type ClientConfig, type Collection, type DataRecord, type DataServiceClient, DataServiceError, type DataTable, type OrderOptions, type QueryBuilder, type QueryFilter, type UserDataStats, VERSION, createClient, debugSetToken, setAppId };
+export { type APIError, type ClientConfig, type Collection, type DataRecord, type DataServiceClient, DataServiceError, type DataTable, type OrderOptions, type QueryBuilder, type QueryFilter, type UserDataStats, VERSION, createClient, debugSetToken, notifyGameScore, setAppId };

package/dist/index.js

@@ -24,6 +24,7 @@ __export(index_exports, {
   VERSION: () => VERSION,
   createClient: () => createClient,
   debugSetToken: () => debugSetToken,
+  notifyGameScore: () => notifyGameScore,
   setAppId: () => setAppId
 });
 module.exports = __toCommonJS(index_exports);
@@ -516,6 +517,19 @@ var DataServiceClientImpl = class {
     return this.client.post("/rpc/health");
   }
 };
+function notifyGameScore(score) {
+  if (!isInIframe() && !isInSeaVerseApp()) return;
+  const payload = JSON.stringify({ type: "seaverse:game_score", score });
+  try {
+    if (isInSeaVerseApp()) {
+      globalThis.window.ReactNativeWebView.postMessage(payload);
+    } else {
+      globalThis.window.parent.postMessage({ type: "seaverse:game_score", score }, "*");
+    }
+  } catch (e) {
+    console.warn("[SeaVerse DataService SDK] Failed to notify game score:", e);
+  }
+}
 async function createClient(config = {}) {
   let token = null;
   let serviceHost = null;
@@ -551,12 +565,13 @@ async function createClient(config = {}) {
 }
 
 // src/index.ts
-var VERSION = "1.8.0";
+var VERSION = "1.8.4";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DataServiceError,
   VERSION,
   createClient,
   debugSetToken,
+  notifyGameScore,
   setAppId
 });

package/dist/index.mjs

@@ -486,6 +486,19 @@ var DataServiceClientImpl = class {
     return this.client.post("/rpc/health");
   }
 };
+function notifyGameScore(score) {
+  if (!isInIframe() && !isInSeaVerseApp()) return;
+  const payload = JSON.stringify({ type: "seaverse:game_score", score });
+  try {
+    if (isInSeaVerseApp()) {
+      globalThis.window.ReactNativeWebView.postMessage(payload);
+    } else {
+      globalThis.window.parent.postMessage({ type: "seaverse:game_score", score }, "*");
+    }
+  } catch (e) {
+    console.warn("[SeaVerse DataService SDK] Failed to notify game score:", e);
+  }
+}
 async function createClient(config = {}) {
   let token = null;
   let serviceHost = null;
@@ -521,11 +534,12 @@ async function createClient(config = {}) {
 }
 
 // src/index.ts
-var VERSION = "1.8.0";
+var VERSION = "1.8.4";
 export {
   DataServiceError,
   VERSION,
   createClient,
   debugSetToken,
+  notifyGameScore,
   setAppId
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seaverse/dataservice",
-  "version": "1.8.3",
+  "version": "1.8.4",
   "description": "AI-Friendly Universal Data Storage SDK for TypeScript/JavaScript",
   "main": "dist/index.js",
   "module": "dist/index.mjs",