lumiverse-spindle-types 0.2.1 → 0.2.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumiverse-spindle-types",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "types": "./src/index.ts",
   "keywords": [
     "lumiverse",

package/src/api.ts

@@ -637,7 +637,10 @@ export type WorkerToHost =
   // ─── Chat Memories (gated: "chats") ───────────────────────────────
   | { type: "chats_get_memories"; requestId: string; chatId: string; topK?: number; userId?: string }
   // ─── Toast (free tier) ───────────────────────────────────────────────
-  | { type: "toast_show"; toastType: "success" | "warning" | "error" | "info"; message: string; title?: string; duration?: number };
+  | { type: "toast_show"; toastType: "success" | "warning" | "error" | "info"; message: string; title?: string; duration?: number }
+  // ─── Push Notifications (gated: "push_notification") ────────────────
+  | { type: "push_send"; requestId: string; title: string; body: string; tag?: string; url?: string; userId?: string }
+  | { type: "push_get_status"; requestId: string; userId?: string };
 
 // ─── Host → Worker messages ──────────────────────────────────────────────
 

package/src/permissions.ts

@@ -28,7 +28,8 @@ export type SpindlePermission =
   | "characters"
   | "chats"
   | "world_books"
-  | "personas";
+  | "personas"
+  | "push_notification";
 
 export const ALL_PERMISSIONS: readonly SpindlePermission[] = [
   "generation",
@@ -46,6 +47,7 @@ export const ALL_PERMISSIONS: readonly SpindlePermission[] = [
   "chats",
   "world_books",
   "personas",
+  "push_notification",
 ] as const;
 
 export function isValidPermission(p: string): p is SpindlePermission {

package/src/spindle-api.ts

@@ -376,6 +376,48 @@ export interface SpindleAPI {
     error(msg: string): void;
   };
 
+  /**
+   * Push notifications (permission: "push_notification").
+   * Send OS-level push notifications to users and check push status.
+   * Notifications are attributed to your extension name.
+   */
+  push: {
+    /**
+     * Send a push notification to a user's registered devices.
+     * Only delivered when the app is not focused (avoids double-notification).
+     */
+    send(input: {
+      title: string;
+      body: string;
+      tag?: string;
+      url?: string;
+    }, userId?: string): Promise<{ sent: number }>;
+    /**
+     * Check if push notifications are available for a user.
+     * Returns subscription count and whether the push system is active.
+     */
+    getStatus(userId?: string): Promise<{
+      available: boolean;
+      subscriptionCount: number;
+    }>;
+  };
+
+  /**
+   * User presence queries (free tier — no permission needed).
+   * Check whether a user currently has the Lumiverse app visible/focused
+   * in at least one browser tab or PWA window.
+   */
+  users: {
+    /**
+     * Returns true if the user has the app visible in at least one session.
+     * Returns false if all sessions are hidden/backgrounded or the user has no
+     * active WebSocket connections.
+     * For user-scoped extensions, userId is inferred from the extension owner.
+     * For operator-scoped extensions, pass userId explicitly.
+     */
+    isVisible(userId?: string): Promise<boolean>;
+  };
+
   /** Show toast notifications in the frontend UI (free tier — no permission needed) */
   toast: {
     success(message: string, options?: { title?: string; duration?: number }): void;