@operato/board 1.22.1 → 1.23.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operato/board",
-  "version": "1.22.1",
+  "version": "1.23.0",
   "description": "Webcomponent for board following open-wc recommendations",
   "author": "heartyoh",
   "main": "dist/src/index.js",
@@ -92,7 +92,7 @@
   },
   "dependencies": {
     "@open-wc/scoped-elements": "^2.0.0-next.6",
-    "@operato/app": "^1.22.1",
+    "@operato/app": "^1.22.2",
     "@operato/data-grist": "^1.22.0",
     "@operato/font": "^1.22.0",
     "@operato/graphql": "^1.21.0",
@@ -152,5 +152,5 @@
       "prettier --write"
     ]
   },
-  "gitHead": "9e174e080a8c4c7fcb588d6d7961c03dbda7b3dd"
+  "gitHead": "7691955920f6d9f952b8faa4ab90ce4036fe2f98"
 }

package/src/data-storage/board-model-cache.ts

@@ -0,0 +1,112 @@
+/*
+ * Copyright © HatioLab Inc. All rights reserved.
+ *
+ * BoardModelCache — 보드 모델 JSON을 IndexedDB에 캐싱.
+ *
+ * 캐시 히트 시 네트워크 대기 없이 즉시 scene 생성 가능.
+ * updatedAt 비교로 캐시 무효화.
+ */
+
+import Dexie from 'dexie'
+
+interface IBoardModelRecord {
+  id: string          // board ID (primary key)
+  name: string
+  model: string       // JSON string (파싱 전)
+  updatedAt: string   // 서버의 updatedAt
+  cachedAt: number    // 로컬 캐시 시점
+}
+
+class BoardModelDatabase extends Dexie {
+  board_models!: Dexie.Table<IBoardModelRecord, string>
+
+  constructor() {
+    super('board-model-cache')
+    this.version(1).stores({
+      board_models: 'id'
+    })
+  }
+}
+
+const db = new BoardModelDatabase()
+
+export interface CachedBoard {
+  id: string
+  name: string
+  model: any      // 파싱된 모델 객체
+  updatedAt: string
+}
+
+export class BoardModelCache {
+  /**
+   * 캐시에서 보드 모델 조회
+   * @returns 캐시된 보드 또는 null
+   */
+  static async get(boardId: string): Promise<CachedBoard | null> {
+    try {
+      const record = await db.board_models.get(boardId)
+      if (!record) return null
+
+      return {
+        id: record.id,
+        name: record.name,
+        model: JSON.parse(record.model),
+        updatedAt: record.updatedAt
+      }
+    } catch {
+      return null
+    }
+  }
+
+  /**
+   * 보드 모델을 캐시에 저장
+   */
+  static async put(boardId: string, name: string, model: string, updatedAt: string): Promise<void> {
+    try {
+      await db.board_models.put({
+        id: boardId,
+        name,
+        model,
+        updatedAt,
+        cachedAt: Date.now()
+      })
+    } catch {
+      // 캐시 저장 실패는 무시 — 기능에 영향 없음
+    }
+  }
+
+  /**
+   * 캐시가 최신인지 확인
+   * @returns true면 캐시 유효, false면 갱신 필요
+   */
+  static async isValid(boardId: string, serverUpdatedAt: string): Promise<boolean> {
+    try {
+      const record = await db.board_models.get(boardId)
+      return record?.updatedAt === serverUpdatedAt
+    } catch {
+      return false
+    }
+  }
+
+  /**
+   * 특정 보드 캐시 삭제
+   */
+  static async remove(boardId: string): Promise<void> {
+    try {
+      await db.board_models.delete(boardId)
+    } catch {
+      // ignore
+    }
+  }
+
+  /**
+   * 전체 캐시 클리어
+   */
+  static async clear(): Promise<void> {
+    try {
+      await db.board_models.clear()
+    } catch {
+      // ignore
+    }
+  }
+}

package/src/index.ts

@@ -2,6 +2,8 @@ export * from './types.js'
 
 export { registerDefaultGroups } from './component/register-default-groups.js'
 export { BoardDataStorage, PlaylistStorage } from './data-storage/data-storage.js'
+export { BoardModelCache } from './data-storage/board-model-cache.js'
+export type { CachedBoard } from './data-storage/board-model-cache.js'
 
 export * from './ox-board-viewer.js'
 export * from './ox-board-player.js'