@glassly/engine 0.3.5-beta.760 → 0.3.5-beta.775

package/src/services/memoryBackupFile.ts

@@ -0,0 +1,50 @@
+/**
+ * Memory backup files: the share-sheet export and file-picker import behind
+ * Settings > Memory and session.memory.exportFile/importFile.
+ */
+
+import type {MemoryExportResult, MemoryImportResult} from "@glassly/miniapp"
+import {File, Paths} from "expo-file-system"
+import {Platform} from "react-native"
+import Share from "react-native-share"
+
+import {MemoryBackupError} from "./MemoryStore"
+import {memoryStore} from "./memoryStoreInstance"
+
+// Some Android document providers report .json files as octet-stream.
+const PICK_MIME_TYPES =
+  Platform.OS === "android" ? ["application/json", "application/octet-stream"] : ["application/json"]
+
+export async function exportMemoryFile(): Promise<MemoryExportResult> {
+  const backup = await memoryStore.exportBackup()
+  const filename = `glassly-memory-${localDate(backup.exportedAt)}.json`
+  const file = new File(Paths.cache, filename)
+  file.writeSync(JSON.stringify(backup))
+  try {
+    await Share.open({url: file.uri, type: "application/json", filename, title: "Glassly memory"})
+    return {success: true}
+  } catch (error: any) {
+    // react-native-share rejects when the user dismisses the sheet.
+    if (error?.message?.includes("User did not share")) return {success: false, cancelled: true}
+    throw error
+  }
+}
+
+/** Resolves null when the user cancels the picker. */
+export async function importMemoryFile(): Promise<MemoryImportResult | null> {
+  const picked = await File.pickFileAsync({mimeTypes: PICK_MIME_TYPES})
+  if (picked.canceled) return null
+  let data: unknown
+  try {
+    data = JSON.parse(await picked.result.text())
+  } catch {
+    throw new MemoryBackupError("Not a Glassly memory backup")
+  }
+  return memoryStore.importBackup(data)
+}
+
+function localDate(ms: number): string {
+  const d = new Date(ms)
+  const pad = (n: number) => String(n).padStart(2, "0")
+  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`
+}

package/src/services/widgetPlacements.ts

@@ -2,12 +2,14 @@
  * Who placed which widget where: the pure bookkeeping behind the runtime's
  * widget routing. A placement is one host's box for one provider widget;
  * a provider is placed while any host holds one of its widgets. Frames are
- * kept per widget so a host that places one again gets the last frame
- * at once.
+ * kept per widget and view so a host that places one again gets the last
+ * card and expanded frames at once.
  */
 
+export type WidgetView = "card" | "expanded"
+
 export interface WidgetBox {
-  size: "XS" | "SM" | "MD" | "LG"
+  size: "XS" | "XSM" | "SM" | "MD" | "LG"
   width: number
   height: number
 }
@@ -22,8 +24,8 @@ export interface Placement {
 export interface WidgetPlacements {
   /** Keyed by `${host}|${provider}/${widgetId}`. */
   placements: ReadonlyMap<string, Placement>
-  /** The latest frame per `${provider}/${widgetId}`. */
-  frames: ReadonlyMap<string, unknown[]>
+  /** The latest frame per `${provider}/${widgetId}` and view. */
+  frames: ReadonlyMap<string, Readonly<Partial<Record<WidgetView, unknown[]>>>>
 }
 
 export const widgetKey = (providerPackageName: string, widgetId: string): string => `${providerPackageName}/${widgetId}`
@@ -71,14 +73,26 @@ export function dropProvider(state: WidgetPlacements, providerPackageName: strin
   return placements.size === state.placements.size ? state : {...state, placements}
 }
 
-export function setFrame(state: WidgetPlacements, providerPackageName: string, widgetId: string, elements: unknown[]): WidgetPlacements {
+export function setFrame(
+  state: WidgetPlacements,
+  providerPackageName: string,
+  widgetId: string,
+  elements: unknown[],
+  view: WidgetView = "card",
+): WidgetPlacements {
+  const key = widgetKey(providerPackageName, widgetId)
   const frames = new Map(state.frames)
-  frames.set(widgetKey(providerPackageName, widgetId), elements)
+  frames.set(key, {...state.frames.get(key), [view]: elements})
   return {...state, frames}
 }
 
-export function frameOf(state: WidgetPlacements, providerPackageName: string, widgetId: string): unknown[] | null {
-  return state.frames.get(widgetKey(providerPackageName, widgetId)) ?? null
+export function frameOf(
+  state: WidgetPlacements,
+  providerPackageName: string,
+  widgetId: string,
+  view: WidgetView = "card",
+): unknown[] | null {
+  return state.frames.get(widgetKey(providerPackageName, widgetId))?.[view] ?? null
 }
 
 export function placementOf(

package/src/types/applet.ts

@@ -89,7 +89,7 @@ export interface DeclaredAction {
   visibility?: "public" | "system"
 }
 
-export type DeclaredWidgetSize = "XS" | "SM" | "MD" | "LG"
+export type DeclaredWidgetSize = "XS" | "XSM" | "SM" | "MD" | "LG"
 
 /** A dashboard widget a miniapp declares in `miniapp.json` and serves through `session.widgets`. */
 export interface DeclaredWidget {
@@ -97,6 +97,8 @@ export interface DeclaredWidget {
   name: string
   sizes: DeclaredWidgetSize[]
   defaultSize: DeclaredWidgetSize
+  /** A tap on the selected widget expands it to the full screen instead of activating the card. */
+  expandable: boolean
 }
 
 export interface ClientApp extends AppletInterface {