@puredesktop/puredesktop-ui-bridge 1.0.0-beta.1 → 2.1.0

package/src/bridge/calendarDraftIntent.ts

@@ -0,0 +1,55 @@
+export const CALENDAR_DRAFT_INTENT_STORAGE_SLUG = 'calendar'
+export const CALENDAR_DRAFT_INTENT_STORAGE_FILE = 'calendar-draft-intents.json'
+export const CALENDAR_DRAFT_INTENT_PREFIX = 'draft-event:mail:'
+
+export interface CalendarDraftAttendee {
+  name: string
+  email: string
+}
+
+export interface CalendarDraftLinkedItem {
+  type: 'email'
+  id: string
+  label: string
+}
+
+export interface CalendarDraftSource {
+  type: 'email'
+  accountId: string
+  threadId: string
+  label: string
+  snippet: string
+}
+
+export interface CalendarDraftIntent {
+  id: string
+  resourceId: string
+  sourceAppSlug: 'mail'
+  source: CalendarDraftSource
+  title: string
+  description: string
+  attendees: CalendarDraftAttendee[]
+  linkedItems: CalendarDraftLinkedItem[]
+  startsAt?: string
+  endsAt?: string
+  createdAt: string
+}
+
+export interface CalendarDraftIntentStore {
+  intents: Record<string, CalendarDraftIntent>
+}
+
+export function calendarDraftResourceId(accountId: string, threadId: string): string {
+  return `${CALENDAR_DRAFT_INTENT_PREFIX}${encodeURIComponent(accountId)}:${encodeURIComponent(threadId)}`
+}
+
+export function isCalendarDraftResourceId(resourceId: string): boolean {
+  return resourceId.startsWith(CALENDAR_DRAFT_INTENT_PREFIX)
+}
+
+export function normalizeCalendarDraftIntentStore(value: unknown): CalendarDraftIntentStore {
+  if (!value || typeof value !== 'object') return { intents: {} }
+  const intents = (value as Partial<CalendarDraftIntentStore>).intents
+  if (!intents || typeof intents !== 'object' || Array.isArray(intents)) return { intents: {} }
+  return { intents: intents as Record<string, CalendarDraftIntent> }
+}

package/src/bridge/calendarInviteIntent.ts

@@ -0,0 +1,64 @@
+export const CALENDAR_INVITE_INTENT_STORAGE_SLUG = 'calendar'
+export const CALENDAR_INVITE_INTENT_STORAGE_FILE = 'calendar-invite-intents.json'
+export const CALENDAR_INVITE_INTENT_PREFIX = 'calendar-invite:mail:'
+
+export type CalendarInviteMethod = 'REQUEST' | 'REPLY' | 'CANCEL' | 'PUBLISH'
+export type CalendarInviteResponse = 'accepted' | 'declined' | 'tentative' | 'needsAction'
+
+export interface CalendarInviteContact {
+  name: string
+  email: string
+}
+
+export interface CalendarInviteAttendee extends CalendarInviteContact {
+  response: CalendarInviteResponse
+}
+
+export interface CalendarInviteIntent {
+  id: string
+  resourceId: string
+  sourceAppSlug: 'mail'
+  source: {
+    type: 'email'
+    accountId: string
+    threadId: string
+    messageId: string
+    label: string
+    snippet: string
+  }
+  uid: string
+  method: CalendarInviteMethod
+  sequence: number
+  status: 'confirmed' | 'tentative' | 'cancelled'
+  title: string
+  description: string
+  location?: string
+  startsAt: string
+  endsAt: string
+  timeZone: string
+  organizer?: CalendarInviteContact
+  attendees: CalendarInviteAttendee[]
+  recurrenceRule?: string
+  response?: CalendarInviteResponse
+  autoCreate?: boolean
+  createdAt: string
+}
+
+export interface CalendarInviteIntentStore {
+  intents: Record<string, CalendarInviteIntent>
+}
+
+export function calendarInviteResourceId(accountId: string, messageId: string, uid: string): string {
+  return `${CALENDAR_INVITE_INTENT_PREFIX}${encodeURIComponent(accountId)}:${encodeURIComponent(messageId)}:${encodeURIComponent(uid)}`
+}
+
+export function isCalendarInviteResourceId(resourceId: string): boolean {
+  return resourceId.startsWith(CALENDAR_INVITE_INTENT_PREFIX)
+}
+
+export function normalizeCalendarInviteIntentStore(value: unknown): CalendarInviteIntentStore {
+  if (!value || typeof value !== 'object') return { intents: {} }
+  const intents = (value as Partial<CalendarInviteIntentStore>).intents
+  if (!intents || typeof intents !== 'object') return { intents: {} }
+  return { intents: intents as Record<string, CalendarInviteIntent> }
+}

package/src/bridge/catalog.d.mts

@@ -1,5 +1,5 @@
-import type { PlatformAppInstallState, ResourceOpenEvent } from './types.js'
-
-export function consumePendingCatalogOpen(): Promise<ResourceOpenEvent | null>
-
-export function isPluginAppInstalled(app: PlatformAppInstallState): boolean
+import type { PlatformAppInstallState, ResourceOpenEvent } from './types.js'
+
+export function consumePendingCatalogOpen(): Promise<ResourceOpenEvent | null>
+
+export function isPluginAppInstalled(app: PlatformAppInstallState): boolean

package/src/bridge/catalog.mjs

@@ -1,24 +1,24 @@
-import { bridge } from './client.mjs'
-import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
-
-/**
- * Cold-start: pull `catalog.open` intent after bridge + boot (path only; app reads via fs).
- *
- * @returns {Promise<import('./types.ts').ResourceOpenEvent | null>}
- */
-export async function consumePendingCatalogOpen() {
-  const result = await bridge.call(
-    PLATFORM_BRIDGE_METHODS.CATALOG_CONSUME_PENDING_OPEN,
-  )
-  return result?.resource ?? null
-}
-
-/**
- * Same rule as shell `isAppInstalled` in catalogAppState.ts.
- *
- * @param {import('./types.ts').PlatformAppInstallState} app
- * @returns {boolean}
- */
-export function isPluginAppInstalled(app) {
-  return Boolean(app.pluginRoot)
-}
+import { bridge } from './client.mjs'
+import { PLATFORM_BRIDGE_METHODS } from './methods.mjs'
+
+/**
+ * Cold-start: pull `catalog.open` intent after bridge + boot (path only; app reads via fs).
+ *
+ * @returns {Promise<import('./types.ts').ResourceOpenEvent | null>}
+ */
+export async function consumePendingCatalogOpen() {
+  const result = await bridge.call(
+    PLATFORM_BRIDGE_METHODS.CATALOG_CONSUME_PENDING_OPEN,
+  )
+  return result?.resource ?? null
+}
+
+/**
+ * Same rule as shell `isAppInstalled` in catalogAppState.ts.
+ *
+ * @param {import('./types.ts').PlatformAppInstallState} app
+ * @returns {boolean}
+ */
+export function isPluginAppInstalled(app) {
+  return Boolean(app.pluginRoot)
+}

package/src/bridge/catalog.ts

@@ -1 +1 @@
-export { consumePendingCatalogOpen, isPluginAppInstalled } from './catalog.mjs'
+export { consumePendingCatalogOpen, isPluginAppInstalled } from './catalog.mjs'

package/src/bridge/client.d.mts

@@ -1,19 +1,19 @@
-import type { PlatformBridgeClient } from './types.js'
-import type { PlatformBridgeEventName } from './events.mjs'
-import type { PlatformBridgeMethodName } from './methods.mjs'
-
-export declare const PLATFORM_BRIDGE_EVENTS: {
-  readonly RESOURCE_OPEN: 'resource.open'
-  readonly THEME_CHANGED: 'theme.changed'
-  readonly RENDER_PROGRESS: 'render.progress'
-  readonly DEBUG_TEST: 'debug.test'
-}
-
-export {
-  PLATFORM_BRIDGE_METHODS,
-  PLATFORM_BRIDGE_METHOD_PREFIXES,
-} from './methods.mjs'
-
-export const bridge: PlatformBridgeClient
-
-export type { PlatformBridgeEventName, PlatformBridgeMethodName }
+import type { PlatformBridgeClient } from './types.js'
+import type { PlatformBridgeEventName } from './events.mjs'
+import type { PlatformBridgeMethodName } from './methods.mjs'
+
+export declare const PLATFORM_BRIDGE_EVENTS: {
+  readonly RESOURCE_OPEN: 'resource.open'
+  readonly THEME_CHANGED: 'theme.changed'
+  readonly RENDER_PROGRESS: 'render.progress'
+  readonly DEBUG_TEST: 'debug.test'
+}
+
+export {
+  PLATFORM_BRIDGE_METHODS,
+  PLATFORM_BRIDGE_METHOD_PREFIXES,
+} from './methods.mjs'
+
+export const bridge: PlatformBridgeClient
+
+export type { PlatformBridgeEventName, PlatformBridgeMethodName }

package/src/bridge/client.mjs

@@ -1,26 +1,26 @@
-/**
- * Plugin-side bridge client (plain JS, no build step).
- * Import: @purescience/platform-ui/bridge/client
- */
-
-import { applyThemeFromHost } from './applyThemeFromHost.mjs'
-
-export { PLATFORM_BRIDGE_EVENTS } from './events.mjs'
-export {
-  PLATFORM_BRIDGE_METHODS,
-  PLATFORM_BRIDGE_METHOD_PREFIXES,
-} from './methods.mjs'
-export {
-  applyThemeFromHost,
-  PLATFORM_THEME_STYLE_ID,
-} from './applyThemeFromHost.mjs'
-
-const CHANNEL = 'purescience-plugin-bridge'
-const HANDSHAKE_MS = 800
-
-let readyPromise = null
-let bridgeMeta = null
-let eventListenerAttached = false
+/**
+ * Plugin-side bridge client (plain JS, no build step).
+ * Import: @purescience/platform-ui/bridge/client
+ */
+
+import { applyThemeFromHost } from './applyThemeFromHost.mjs'
+
+export { PLATFORM_BRIDGE_EVENTS } from './events.mjs'
+export {
+  PLATFORM_BRIDGE_METHODS,
+  PLATFORM_BRIDGE_METHOD_PREFIXES,
+} from './methods.mjs'
+export {
+  applyThemeFromHost,
+  PLATFORM_THEME_STYLE_ID,
+} from './applyThemeFromHost.mjs'
+
+const CHANNEL = 'purescience-plugin-bridge'
+const HANDSHAKE_MS = 800
+
+let readyPromise = null
+let bridgeMeta = null
+let eventListenerAttached = false
 const eventListeners = new Map()
 
 function postHandshake() {
@@ -31,33 +31,33 @@ function ensureEventListener() {
   if (eventListenerAttached) return
   eventListenerAttached = true
   window.addEventListener('message', event => {
-    const data = event.data
-    if (!data || data.channel !== CHANNEL || data.type !== 'event') return
-    const handlers = eventListeners.get(data.name)
-    if (!handlers) return
-    for (const handler of handlers) {
-      try {
-        handler(data.payload)
-      } catch (error) {
-        console.error('[plugin-bridge] event handler failed', error)
-      }
-    }
-  })
-}
-
-function onEvent(name, handler) {
-  ensureEventListener()
-  if (!eventListeners.has(name)) {
-    eventListeners.set(name, new Set())
-  }
-  eventListeners.get(name).add(handler)
-  return () => offEvent(name, handler)
-}
-
-function offEvent(name, handler) {
-  eventListeners.get(name)?.delete(handler)
-}
-
+    const data = event.data
+    if (!data || data.channel !== CHANNEL || data.type !== 'event') return
+    const handlers = eventListeners.get(data.name)
+    if (!handlers) return
+    for (const handler of handlers) {
+      try {
+        handler(data.payload)
+      } catch (error) {
+        console.error('[plugin-bridge] event handler failed', error)
+      }
+    }
+  })
+}
+
+function onEvent(name, handler) {
+  ensureEventListener()
+  if (!eventListeners.has(name)) {
+    eventListeners.set(name, new Set())
+  }
+  eventListeners.get(name).add(handler)
+  return () => offEvent(name, handler)
+}
+
+function offEvent(name, handler) {
+  eventListeners.get(name)?.delete(handler)
+}
+
 function waitForReady() {
   if (readyPromise) return readyPromise
   readyPromise = new Promise((resolve, reject) => {
@@ -65,41 +65,41 @@ function waitForReady() {
       window.clearInterval(handshakeTimer)
       reject(
         new Error(
-          'PureScience plugin bridge ready timeout (is this page inside the desktop iframe?)',
-        ),
-      )
-    }, 15_000)
-
+          'PureScience plugin bridge ready timeout (is this page inside the desktop iframe?)',
+        ),
+      )
+    }, 15_000)
+
     const onMessage = event => {
       const data = event.data
       if (!data || data.channel !== CHANNEL || data.type !== 'ready') return
       window.clearTimeout(timeout)
       window.clearInterval(handshakeTimer)
       window.removeEventListener('message', onMessage)
-      const viewport =
-        data.viewport &&
-        typeof data.viewport === 'object' &&
-        typeof data.viewport.tabId === 'string'
-          ? {
-              tabId: data.viewport.tabId,
-              resource:
-                data.viewport.resource &&
-                typeof data.viewport.resource === 'object' &&
-                typeof data.viewport.resource.path === 'string'
-                  ? data.viewport.resource
-                  : null,
-            }
-          : undefined
-      bridgeMeta = {
-        version: data.version,
-        pluginId: data.pluginId,
-        appSlug: data.appSlug,
-        methods: Array.isArray(data.methods) ? data.methods : [],
-        theme: data.theme,
-        ...(viewport ? { viewport } : {}),
-      }
-      applyThemeFromHost(data.theme)
-      resolve(bridgeMeta)
+      const viewport =
+        data.viewport &&
+        typeof data.viewport === 'object' &&
+        typeof data.viewport.tabId === 'string'
+          ? {
+              tabId: data.viewport.tabId,
+              resource:
+                data.viewport.resource &&
+                typeof data.viewport.resource === 'object' &&
+                typeof data.viewport.resource.path === 'string'
+                  ? data.viewport.resource
+                  : null,
+            }
+          : undefined
+      bridgeMeta = {
+        version: data.version,
+        pluginId: data.pluginId,
+        appSlug: data.appSlug,
+        methods: Array.isArray(data.methods) ? data.methods : [],
+        theme: data.theme,
+        ...(viewport ? { viewport } : {}),
+      }
+      applyThemeFromHost(data.theme)
+      resolve(bridgeMeta)
     }
 
     window.addEventListener('message', onMessage)
@@ -108,22 +108,22 @@ function waitForReady() {
   })
   return readyPromise
 }
-
+
 function call(method, args = []) {
   return waitForReady().then(
     () =>
       new Promise((resolve, reject) => {
         const id = `req-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`
         const onMessage = event => {
-          const data = event.data
-          if (
-            !data ||
-            data.channel !== CHANNEL ||
-            data.type !== 'response' ||
-            data.id !== id
-          ) {
-            return
-          }
+          const data = event.data
+          if (
+            !data ||
+            data.channel !== CHANNEL ||
+            data.type !== 'response' ||
+            data.id !== id
+          ) {
+            return
+          }
           window.removeEventListener('message', onMessage)
           if (data.ok) resolve(data.result)
           else reject(new Error(data.error || 'Bridge request failed'))
@@ -132,16 +132,16 @@ function call(method, args = []) {
         window.parent.postMessage(
           { channel: CHANNEL, type: 'request', id, method, args },
           '*',
-        )
-      }),
-  )
-}
-
-export const bridge = {
-  waitForReady,
-  call,
-  onEvent,
-  offEvent,
-  getMethods: () => bridgeMeta?.methods ?? [],
-  ping: () => call('ping'),
-}
+        )
+      }),
+  )
+}
+
+export const bridge = {
+  waitForReady,
+  call,
+  onEvent,
+  offEvent,
+  getMethods: () => bridgeMeta?.methods ?? [],
+  ping: () => call('ping'),
+}

package/src/bridge/collectionAssetAdapter.ts

@@ -1,63 +1,63 @@
-import type { Editor } from '@tiptap/core'
-import {
-  insertCollectionImageFromBinaryResult,
-  insertInlineAssetKind,
-} from '@purescience/platform-editor'
-import type { CollectionAssetDocumentAdapter } from '../components/assets/asset-library/types.js'
-import type { PlatformAssetSummary } from './types.js'
-
-function isFileCollectionAsset(asset: PlatformAssetSummary): boolean {
-  return asset.kind === 'image' || asset.kind === 'vector'
-}
-
-function altForAsset(asset: PlatformAssetSummary): string {
-  return asset.label.trim() || asset.fileName
-}
-
-export interface CreateCollectionAssetDocumentAdapterOptions {
-  getEditor: () => Editor | null | undefined
-  readBinary: (
-    absolutePath: string,
-  ) => Promise<{ mimeType: string; base64: string }>
-}
-
-export async function insertCollectionAsset(
-  editor: Editor | null | undefined,
-  asset: PlatformAssetSummary,
-  readBinary: CreateCollectionAssetDocumentAdapterOptions['readBinary'],
-): Promise<void> {
-  if (!editor || editor.isDestroyed) return
-
-  if (isFileCollectionAsset(asset)) {
-    const binary = await readBinary(asset.absolutePath)
-    insertCollectionImageFromBinaryResult(editor, {
-      relativePath: asset.relativePath,
-      alt: altForAsset(asset),
-      mimeType: binary.mimeType,
-      base64: binary.base64,
-    })
-    return
-  }
-
-  if (
-    asset.kind === 'mermaid' ||
-    asset.kind === 'table' ||
-    asset.kind === 'math'
-  ) {
-    insertInlineAssetKind(editor, asset.kind, asset.sourceCode)
-  }
-}
-
-export function createCollectionAssetDocumentAdapter(
-  options: CreateCollectionAssetDocumentAdapterOptions,
-): CollectionAssetDocumentAdapter {
-  return {
-    insertAsset: async (asset: PlatformAssetSummary) => {
-      await insertCollectionAsset(
-        options.getEditor(),
-        asset,
-        options.readBinary,
-      )
-    },
-  }
-}
+import type { Editor } from '@tiptap/core'
+import {
+  insertCollectionImageFromBinaryResult,
+  insertInlineAssetKind,
+} from '@purescience/platform-editor'
+import type { CollectionAssetDocumentAdapter } from '../components/assets/asset-library/types.js'
+import type { PlatformAssetSummary } from './types.js'
+
+function isFileCollectionAsset(asset: PlatformAssetSummary): boolean {
+  return asset.kind === 'image' || asset.kind === 'vector'
+}
+
+function altForAsset(asset: PlatformAssetSummary): string {
+  return asset.label.trim() || asset.fileName
+}
+
+export interface CreateCollectionAssetDocumentAdapterOptions {
+  getEditor: () => Editor | null | undefined
+  readBinary: (
+    absolutePath: string,
+  ) => Promise<{ mimeType: string; base64: string }>
+}
+
+export async function insertCollectionAsset(
+  editor: Editor | null | undefined,
+  asset: PlatformAssetSummary,
+  readBinary: CreateCollectionAssetDocumentAdapterOptions['readBinary'],
+): Promise<void> {
+  if (!editor || editor.isDestroyed) return
+
+  if (isFileCollectionAsset(asset)) {
+    const binary = await readBinary(asset.absolutePath)
+    insertCollectionImageFromBinaryResult(editor, {
+      relativePath: asset.relativePath,
+      alt: altForAsset(asset),
+      mimeType: binary.mimeType,
+      base64: binary.base64,
+    })
+    return
+  }
+
+  if (
+    asset.kind === 'mermaid' ||
+    asset.kind === 'table' ||
+    asset.kind === 'math'
+  ) {
+    insertInlineAssetKind(editor, asset.kind, asset.sourceCode)
+  }
+}
+
+export function createCollectionAssetDocumentAdapter(
+  options: CreateCollectionAssetDocumentAdapterOptions,
+): CollectionAssetDocumentAdapter {
+  return {
+    insertAsset: async (asset: PlatformAssetSummary) => {
+      await insertCollectionAsset(
+        options.getEditor(),
+        asset,
+        options.readBinary,
+      )
+    },
+  }
+}

package/src/bridge/collectionAssets.d.mts

@@ -1 +1 @@
-export declare const DEFAULT_COLLECTION_FIGURES_DIR: 'assets/figures'
+export declare const DEFAULT_COLLECTION_FIGURES_DIR: 'assets/figures'

package/src/bridge/collectionAssets.mjs

@@ -1,2 +1,2 @@
-/** Default relative folder for collection file uploads (figures, pasted images). */
-export const DEFAULT_COLLECTION_FIGURES_DIR = 'assets/figures'
+/** Default relative folder for collection file uploads (figures, pasted images). */
+export const DEFAULT_COLLECTION_FIGURES_DIR = 'assets/figures'

package/src/bridge/collectionAssets.ts

@@ -1 +1 @@
-export { DEFAULT_COLLECTION_FIGURES_DIR } from './collectionAssets.mjs'
+export { DEFAULT_COLLECTION_FIGURES_DIR } from './collectionAssets.mjs'