@glassly/engine 0.4.0-dev.1066 → 0.4.0-dev.1068

package/build/services/notifications/miniappNotifications.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Notifications miniapps post (`session.phone.notifications.post`) on their
+ * way into the host's phone-notification path. The runtime validates and
+ * emits here; the host subscribes through `engine.phoneNotifications` and
+ * feeds them to the same fan-out as the phone's own, with `system: false`
+ * and `source` set, so the dashboard, other readers and presentation treat
+ * them alike.
+ */
+export interface MiniappNotificationPosted {
+    type: "posted";
+    notificationId: string;
+    source: string;
+    app: string;
+    title: string;
+    content: string;
+    timestamp: number;
+}
+export interface MiniappNotificationDismissed {
+    type: "dismissed";
+    notificationId: string;
+    source: string;
+    timestamp: number;
+}
+export type MiniappNotificationEvent = MiniappNotificationPosted | MiniappNotificationDismissed;
+export declare const MINIAPP_NOTIFICATION_TITLE_MAX = 200;
+export declare const MINIAPP_NOTIFICATION_CONTENT_MAX = 2000;
+export declare const MINIAPP_NOTIFICATION_ID_MAX = 128;
+export declare function miniappNotificationId(source: string, id: string): string;
+export declare function emitMiniappNotification(event: MiniappNotificationEvent): void;
+export declare function onMiniappNotification(listener: (event: MiniappNotificationEvent) => void): () => void;
+//# sourceMappingURL=miniappNotifications.d.ts.map

package/build/services/notifications/miniappNotifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"miniappNotifications.d.ts","sourceRoot":"","sources":["../../../src/services/notifications/miniappNotifications.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,QAAQ,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,WAAW,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,MAAM,wBAAwB,GAAG,yBAAyB,GAAG,4BAA4B,CAAA;AAE/F,eAAO,MAAM,8BAA8B,MAAM,CAAA;AACjD,eAAO,MAAM,gCAAgC,OAAQ,CAAA;AACrD,eAAO,MAAM,2BAA2B,MAAM,CAAA;AAI9C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAQ7E;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,GAAG,MAAM,IAAI,CAKrG"}

package/build/services/notifications/miniappNotifications.js

@@ -0,0 +1,24 @@
+export const MINIAPP_NOTIFICATION_TITLE_MAX = 200;
+export const MINIAPP_NOTIFICATION_CONTENT_MAX = 2_000;
+export const MINIAPP_NOTIFICATION_ID_MAX = 128;
+const listeners = new Set();
+export function miniappNotificationId(source, id) {
+    return `${source}:${id}`;
+}
+export function emitMiniappNotification(event) {
+    for (const listener of listeners) {
+        try {
+            listener(event);
+        }
+        catch (err) {
+            console.warn(`miniappNotifications: listener threw: ${err?.message ?? err}`);
+        }
+    }
+}
+export function onMiniappNotification(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+//# sourceMappingURL=miniappNotifications.js.map

package/build/services/notifications/miniappNotifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"miniappNotifications.js","sourceRoot":"","sources":["../../../src/services/notifications/miniappNotifications.ts"],"names":[],"mappings":"AA2BA,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,CAAA;AACjD,MAAM,CAAC,MAAM,gCAAgC,GAAG,KAAK,CAAA;AACrD,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAA;AAE9C,MAAM,SAAS,GAAG,IAAI,GAAG,EAA6C,CAAA;AAEtE,MAAM,UAAU,qBAAqB,CAAC,MAAc,EAAE,EAAU;IAC9D,OAAO,GAAG,MAAM,IAAI,EAAE,EAAE,CAAA;AAC1B,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAA+B;IACrE,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,QAAQ,CAAC,KAAK,CAAC,CAAA;QACjB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,yCAA0C,GAAa,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC,CAAA;QACzF,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAmD;IACvF,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACvB,OAAO,GAAG,EAAE;QACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC5B,CAAC,CAAA;AACH,CAAC","sourcesContent":["/**\n * Notifications miniapps post (`session.phone.notifications.post`) on their\n * way into the host's phone-notification path. The runtime validates and\n * emits here; the host subscribes through `engine.phoneNotifications` and\n * feeds them to the same fan-out as the phone's own, with `system: false`\n * and `source` set, so the dashboard, other readers and presentation treat\n * them alike.\n */\nexport interface MiniappNotificationPosted {\n  type: \"posted\"\n  notificationId: string\n  source: string\n  app: string\n  title: string\n  content: string\n  timestamp: number\n}\n\nexport interface MiniappNotificationDismissed {\n  type: \"dismissed\"\n  notificationId: string\n  source: string\n  timestamp: number\n}\n\nexport type MiniappNotificationEvent = MiniappNotificationPosted | MiniappNotificationDismissed\n\nexport const MINIAPP_NOTIFICATION_TITLE_MAX = 200\nexport const MINIAPP_NOTIFICATION_CONTENT_MAX = 2_000\nexport const MINIAPP_NOTIFICATION_ID_MAX = 128\n\nconst listeners = new Set<(event: MiniappNotificationEvent) => void>()\n\nexport function miniappNotificationId(source: string, id: string): string {\n  return `${source}:${id}`\n}\n\nexport function emitMiniappNotification(event: MiniappNotificationEvent): void {\n  for (const listener of listeners) {\n    try {\n      listener(event)\n    } catch (err) {\n      console.warn(`miniappNotifications: listener threw: ${(err as Error)?.message ?? err}`)\n    }\n  }\n}\n\nexport function onMiniappNotification(listener: (event: MiniappNotificationEvent) => void): () => void {\n  listeners.add(listener)\n  return () => {\n    listeners.delete(listener)\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glassly/engine",
-  "version": "0.4.0-dev.1066",
+  "version": "0.4.0-dev.1068",
   "description": "Glassly Engine — miniapp registry, WebView bridge, and miniapp store",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -97,17 +97,17 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@glassly/bluetooth-sdk": "0.4.0-dev.1066",
-    "@glassly/cloud-client": "0.4.0-dev.1066",
-    "@glassly/cloud-protocol": "0.4.0-dev.1066",
-    "@glassly/crust": "0.4.0-dev.1066",
-    "@glassly/miniapp": "0.4.0-dev.1066",
+    "@glassly/bluetooth-sdk": "0.4.0-dev.1068",
+    "@glassly/cloud-client": "0.4.0-dev.1068",
+    "@glassly/cloud-protocol": "0.4.0-dev.1068",
+    "@glassly/crust": "0.4.0-dev.1068",
+    "@glassly/miniapp": "0.4.0-dev.1068",
     "buffer": "^6.0.3",
     "events": "^3.3.0",
     "react-native-marked": "8.3.4",
     "semver": "^7.8.6",
     "typesafe-ts": "^1.7.1",
-    "@glassly/llm-providers": "0.4.0-dev.1066",
+    "@glassly/llm-providers": "0.4.0-dev.1068",
     "@huggingface/jinja": "^0.5.12",
     "jsonrepair": "^3.15.0"
   },

package/src/facades/permissions.ts

@@ -125,14 +125,12 @@ export const permissions = {
           features.add(PermissionFeatures.CALENDAR)
           features.add(PermissionFeatures.LOCATION)
           features.add(PermissionFeatures.BACKGROUND_LOCATION)
-          features.add(PermissionFeatures.POST_NOTIFICATIONS)
           features.add("read_notifications")
           break
         case "MICROPHONE":
         case "CALENDAR":
         case "LOCATION":
         case "BACKGROUND_LOCATION":
-        case "POST_NOTIFICATIONS":
           features.add(PermissionFeatures[permission.type])
           break
         case "READ_NOTIFICATIONS":

package/src/facades/phoneNotifications.ts

@@ -23,6 +23,9 @@ import {
   nativeNotificationsSupported,
   uploadPhoneNotification,
 } from "../services/PhoneNotificationsSync"
+import {onMiniappNotification, type MiniappNotificationEvent} from "../services/notifications/miniappNotifications"
+
+export type {MiniappNotificationEvent} from "../services/notifications/miniappNotifications"
 
 export const phoneNotifications = {
   /**
@@ -65,6 +68,13 @@ export const phoneNotifications = {
    * surface runs and draw only when the answer is `host`.
    */
   presentationOwner: currentPresentationOwner,
+  /**
+   * Notifications miniapps post and dismiss. Hosts feed them to the same
+   * fan-out as the phone's, marked `system: false` with `source` set.
+   */
+  onMiniappNotification: (listener: (event: MiniappNotificationEvent) => void): (() => void) =>
+    onMiniappNotification(listener),
+
   /** Hand a captured notification to firmware that presents uploaded content (owner `firmware`, Android). */
   uploadToGlasses: (event: PhoneNotificationEvent): Promise<void> => uploadPhoneNotification(event),
 

package/src/generated/releaseMetadata.ts

@@ -12,9 +12,9 @@ export interface EngineReleaseMetadata {
 export const ENGINE_RELEASE_METADATA: Readonly<EngineReleaseMetadata> = Object.freeze({
   "schemaVersion": 1,
   "familyBaseVersion": "0.4.0",
-  "releaseIdentity": "0.4.0-dev.1066",
-  "releaseSetId": "glassly-0.4.0-dev.1066",
-  "sourceCommit": "1df55b8e89eeec2cb01fa011748fed92c1f5e920",
+  "releaseIdentity": "0.4.0-dev.1068",
+  "releaseSetId": "glassly-0.4.0-dev.1068",
+  "sourceCommit": "633efe3678d98aeda2d2f47346a8f35e80ab3992",
   "otaManifestUrl": null,
   "otaManifestSha256": null
 })

package/src/index.ts

@@ -23,6 +23,7 @@ export type {
 } from "./facades/reports"
 export type {IslandNotification, IslandNotificationKind} from "./facades/notifications"
 export type {PresentationOwner} from "./services/notifications/notificationPolicy"
+export type {MiniappNotificationEvent} from "./services/notifications/miniappNotifications"
 export {DEFAULT_HIDDEN_PACKAGES, isGatedByDevTools, isSystemMiniapp} from "./stores/appVisibility"
 export type {WifiSearchResult} from "./facades/glassesWifi"
 export type {IdentitySnapshot} from "./services/PairingIdentity"

package/src/services/LocalMiniappRuntime.ts

@@ -83,6 +83,13 @@ import overlayPages from "./pages/OverlayPages"
 import dashboardOpenTrace from "./debug/DashboardOpenTrace"
 import {isAppForegrounded, isPhoneActive, onAppForegroundChange, onPhoneActivityChange} from "./PhoneActivity"
 import {installedNotificationApps} from "./PhoneNotificationsSync"
+import {
+  emitMiniappNotification,
+  MINIAPP_NOTIFICATION_CONTENT_MAX,
+  MINIAPP_NOTIFICATION_ID_MAX,
+  MINIAPP_NOTIFICATION_TITLE_MAX,
+  miniappNotificationId,
+} from "./notifications/miniappNotifications"
 import {MiniappIcons} from "./MiniappIcons"
 import {pairedControllersFrom, readyControllersKey} from "./controllers"
 import {
@@ -1513,6 +1520,12 @@ class LocalMiniappRuntime {
       case MiniappRequestType.NOTIFICATION_APPS_LIST:
         void this.handleNotificationAppsList(packageName, requestId)
         break
+      case MiniappRequestType.NOTIFICATION_POST:
+        this.handleNotificationPost(packageName, payload, requestId)
+        break
+      case MiniappRequestType.NOTIFICATION_DISMISS:
+        this.handleNotificationDismiss(packageName, payload, requestId)
+        break
       case MiniappRequestType.NATIVE_NAV:
         this.handleNativeNav(packageName, payload, requestId)
         break
@@ -2792,7 +2805,17 @@ class LocalMiniappRuntime {
       return
     }
     try {
-      this.sendResult(packageName, requestId, true, await installedNotificationApps())
+      const posters = this.interopApps().filter(
+        (app) => app.packageName && app.permissions?.some((permission) => permission.type === "POST_NOTIFICATIONS"),
+      )
+      const miniapps = await Promise.all(
+        posters.map(async (app) => ({
+          packageName: app.packageName,
+          appName: app.name || app.packageName,
+          icon: (await this.miniappIcons.read(app)) ?? null,
+        })),
+      )
+      this.sendResult(packageName, requestId, true, [...(await installedNotificationApps()), ...miniapps])
     } catch (err) {
       this.sendResult(packageName, requestId, false, undefined, {
         code: MiniappErrorCode.INTERNAL,
@@ -2801,6 +2824,60 @@ class LocalMiniappRuntime {
     }
   }
 
+  private handleNotificationPost(packageName: string, payload: Record<string, unknown>, requestId?: string): void {
+    if (!this.requirePermission(packageName, requestId, "POST_NOTIFICATIONS", "to post notifications")) return
+    const title = typeof payload.title === "string" ? payload.title.slice(0, MINIAPP_NOTIFICATION_TITLE_MAX) : ""
+    const content =
+      typeof payload.content === "string" ? payload.content.slice(0, MINIAPP_NOTIFICATION_CONTENT_MAX) : ""
+    if (!title.trim() && !content.trim()) {
+      this.sendResult(packageName, requestId, false, undefined, {
+        code: MiniappErrorCode.INVALID_ARGUMENT,
+        message: "A notification needs a title or content",
+      })
+      return
+    }
+    if (payload.id !== undefined && (typeof payload.id !== "string" || !payload.id.trim())) {
+      this.sendResult(packageName, requestId, false, undefined, {
+        code: MiniappErrorCode.INVALID_ARGUMENT,
+        message: "A notification id must be a non-empty string",
+      })
+      return
+    }
+    const id =
+      typeof payload.id === "string"
+        ? payload.id.trim().slice(0, MINIAPP_NOTIFICATION_ID_MAX)
+        : `${Date.now().toString(36)}-${++this.notificationSeq}`
+    const app = this.interopApps().find((candidate) => candidate.packageName === packageName)
+    emitMiniappNotification({
+      type: "posted",
+      notificationId: miniappNotificationId(packageName, id),
+      source: packageName,
+      app: app?.name || packageName,
+      title,
+      content,
+      timestamp: Date.now(),
+    })
+    this.sendResult(packageName, requestId, true, {id})
+  }
+
+  private handleNotificationDismiss(packageName: string, payload: Record<string, unknown>, requestId?: string): void {
+    if (!this.requirePermission(packageName, requestId, "POST_NOTIFICATIONS", "to dismiss notifications")) return
+    if (typeof payload.id !== "string" || !payload.id.trim()) {
+      this.sendResult(packageName, requestId, false, undefined, {
+        code: MiniappErrorCode.INVALID_ARGUMENT,
+        message: "dismiss needs the id post() returned",
+      })
+      return
+    }
+    emitMiniappNotification({
+      type: "dismissed",
+      notificationId: miniappNotificationId(packageName, payload.id.trim().slice(0, MINIAPP_NOTIFICATION_ID_MAX)),
+      source: packageName,
+      timestamp: Date.now(),
+    })
+    this.sendResult(packageName, requestId, true)
+  }
+
   /**
    * Push bridged settings as they change: stored keys from the store, the
    * derived keys whenever their inputs move (phone activity, the display,
@@ -6269,6 +6346,7 @@ class LocalMiniappRuntime {
   }
 
   private miniappIcons = new MiniappIcons()
+  private notificationSeq = 0
 
   private async handleMiniappsList(
     packageName: string,

package/src/services/notifications/miniappNotifications.ts

@@ -0,0 +1,53 @@
+/**
+ * Notifications miniapps post (`session.phone.notifications.post`) on their
+ * way into the host's phone-notification path. The runtime validates and
+ * emits here; the host subscribes through `engine.phoneNotifications` and
+ * feeds them to the same fan-out as the phone's own, with `system: false`
+ * and `source` set, so the dashboard, other readers and presentation treat
+ * them alike.
+ */
+export interface MiniappNotificationPosted {
+  type: "posted"
+  notificationId: string
+  source: string
+  app: string
+  title: string
+  content: string
+  timestamp: number
+}
+
+export interface MiniappNotificationDismissed {
+  type: "dismissed"
+  notificationId: string
+  source: string
+  timestamp: number
+}
+
+export type MiniappNotificationEvent = MiniappNotificationPosted | MiniappNotificationDismissed
+
+export const MINIAPP_NOTIFICATION_TITLE_MAX = 200
+export const MINIAPP_NOTIFICATION_CONTENT_MAX = 2_000
+export const MINIAPP_NOTIFICATION_ID_MAX = 128
+
+const listeners = new Set<(event: MiniappNotificationEvent) => void>()
+
+export function miniappNotificationId(source: string, id: string): string {
+  return `${source}:${id}`
+}
+
+export function emitMiniappNotification(event: MiniappNotificationEvent): void {
+  for (const listener of listeners) {
+    try {
+      listener(event)
+    } catch (err) {
+      console.warn(`miniappNotifications: listener threw: ${(err as Error)?.message ?? err}`)
+    }
+  }
+}
+
+export function onMiniappNotification(listener: (event: MiniappNotificationEvent) => void): () => void {
+  listeners.add(listener)
+  return () => {
+    listeners.delete(listener)
+  }
+}