yeow-api 0.2.52 → 0.2.54

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "yeow-api",
-    "version": "0.2.52",
+    "version": "0.2.54",
     "description": "Yeow API",
     "type": "module",
     "main": "./src/index.ts",

package/src/global.d.ts

@@ -28,5 +28,8 @@ declare global {
         { cbId: string; handler: Function; manualRelease: boolean }[]
       >
     | undefined;
+
+  function uint8ArrayToBase64(buffer: ArrayBuffer): string;
+  function base64ToUint8Array(base64: string): ArrayBuffer;
 }
 export {};

package/src/index.ts

@@ -79,4 +79,6 @@ export { createBoard as createScoreboard, deleteBoard as deleteScoreboard,
     setPlayerBoard } from './scoreboard.js';
 export { getMaterials, getBlocks, getItems } from './material.js';
 export type { MaterialInfo } from './material.js';
+export { registerService, registerNativeService, request as serviceRequest, subscribe as serviceSubscribe, publish as servicePublish } from './service.js';
+export type { ServiceResult } from './service.js';
 export { log, Logger } from './log.js';

package/src/service.ts

@@ -0,0 +1,60 @@
+import { post } from './task.js';
+
+export interface ServiceResult {
+  serviceId: string;
+  token: string;
+}
+
+let _reqSeq = 0;
+
+// ── Register Plugin Service ──
+
+export async function registerService(refName: string, onRequest: (path: string, body: any) => any, isPublic = true): Promise<ServiceResult> {
+  const svcCbId = _registerCallback((payload: any) => {
+    if (payload?._svc === 'request') {
+      let body: any = null;
+      try { body = JSON.parse(payload.body); } catch { body = {}; }
+      const result = onRequest(payload.path, body);
+      $send('service', { t: 'response', requestId: payload.requestId, body: result });
+    }
+  }, { persistent: true });
+
+  const r = $send('service', { t: 'register', refName, onRequest: svcCbId, public: isPublic }) as ServiceResult;
+  return r;
+}
+
+export async function registerNativeService(refName: string, platforms: Record<string, string>, isPublic = true): Promise<ServiceResult> {
+  const r = $send('service', { t: 'registerNative', refName, platforms, public: isPublic }) as ServiceResult;
+  return r;
+}
+
+// ── Request ──
+
+export function request(serviceId: string, path: string, body?: any): Promise<any> {
+  const reqId = 'svcreq_' + (++_reqSeq);
+  return new Promise((resolve, reject) => {
+    _registerCallback((result: any) => {
+      if (result?.err) { reject(new Error(result.err)); } else resolve(result);
+    });
+    $send('service', { t: 'request', serviceId, path, body: body || {}, requestId: reqId });
+  });
+}
+
+// ── Subscribe ──
+
+export function subscribe(serviceId: string, eventPath: string, handler: (eventPath: string, body: any) => void): () => void {
+  const cbId = _registerCallback((payload: any) => {
+    handler(payload.eventPath, payload.body);
+  }, { persistent: true });
+  $send('service', { t: 'subscribe', serviceId, eventPath, cb: cbId });
+  return () => {
+    $send('service', { t: 'unsubscribe', serviceId, eventPath });
+    _unregisterCallback(cbId);
+  };
+}
+
+// ── Publish ──
+
+export function publish(token: string, eventPath: string, body?: any): void {
+  $send('service', { t: 'publish', token, eventPath, body: body || {} });
+}