@glassly/miniapp 0.3.4-dev.704 → 0.3.5-beta.707

package/src/session.ts

@@ -51,6 +51,7 @@ import {StreamModule} from "./modules/stream"
 import {SystemModule} from "./modules/system"
 import {MiniappsModule} from "./modules/miniapps"
 import {ActionsModule} from "./modules/actions"
+import {WidgetsModule, type WidgetBox, type WidgetEvent, type WidgetFrame} from "./modules/widgets"
 import {BlobModule} from "./modules/blob"
 
 // ---------------------------------------------------------------------------
@@ -212,6 +213,7 @@ export type PermissionType =
   | "displayMirror"
   | "manageMiniapps"
   | "platformSettings"
+  | "hostWidgets"
 export type PermissionRecord = Record<PermissionType, boolean>
 
 const ALL_PERMISSION_TYPES: readonly PermissionType[] = [
@@ -227,6 +229,7 @@ const ALL_PERMISSION_TYPES: readonly PermissionType[] = [
   "displayMirror",
   "manageMiniapps",
   "platformSettings",
+  "hostWidgets",
 ] as const
 
 export class NotConnectedError extends Error {
@@ -398,6 +401,11 @@ export class MiniappSession<TChannels extends object = any> {
    * action; `handle` exposes one of your own. Both are open to all.
    */
   public readonly actions: ActionsModule
+  /**
+   * Dashboard widgets. `provide` serves a widget this miniapp declares; the
+   * host side (`list`, `place`, `send`, `onFrame`) needs HOST_WIDGETS.
+   */
+  public readonly widgets: WidgetsModule
 
   /** Phone-declared glasses capabilities. Null until CONNECT_ACK arrives. */
   public capabilities: GlassesCapabilities | null = null
@@ -458,6 +466,7 @@ export class MiniappSession<TChannels extends object = any> {
     displayMirror: false,
     manageMiniapps: false,
     platformSettings: false,
+    hostWidgets: false,
   }
 
   constructor(options: MiniappSessionOptions = {}) {
@@ -503,6 +512,7 @@ export class MiniappSession<TChannels extends object = any> {
     this.ui = new UIModuleImpl<TChannels>(this)
     this.miniapps = new MiniappsModule(this)
     this.actions = new ActionsModule(this)
+    this.widgets = new WidgetsModule(this)
   }
 
   /**
@@ -928,6 +938,29 @@ export class MiniappSession<TChannels extends object = any> {
         return
       }
 
+      case MiniappResponseType.WIDGET_CALL: {
+        const callId = payload.callId as string | undefined
+        const widgetId = payload.widgetId as string | undefined
+        const kind = payload.kind
+        if (!callId || !widgetId || (kind !== "box" && kind !== "event")) return
+        this.widgets._deliverCall(
+          callId,
+          widgetId,
+          kind,
+          (payload.box as WidgetBox | null | undefined) ?? null,
+          (payload.event as WidgetEvent | null | undefined) ?? null,
+        )
+        return
+      }
+
+      case MiniappResponseType.WIDGET_FRAME: {
+        const packageName = payload.packageName as string | undefined
+        const widgetId = payload.widgetId as string | undefined
+        if (!packageName || !widgetId || !Array.isArray(payload.elements)) return
+        this.widgets._deliverFrame({packageName, widgetId, elements: payload.elements} as WidgetFrame)
+        return
+      }
+
       case MiniappResponseType.CAPABILITIES_UPDATE: {
         const cap = (payload.capabilities as GlassesCapabilities | null) ?? null
         this.capabilities = cap
@@ -1147,6 +1180,8 @@ function manifestKeyToCanonical(manifestKey: string): PermissionType | null {
       return "manageMiniapps"
     case "PLATFORM_SETTINGS":
       return "platformSettings"
+    case "HOST_WIDGETS":
+      return "hostWidgets"
     default:
       return null
   }