@neta-art/cohub 12.1.1 → 12.3.0

package/dist/board/replica/indexeddb.js

@@ -0,0 +1,155 @@
+//#region src/board/replica/indexeddb.ts
+const DATABASE = "cohub-board";
+const VERSION = 1;
+const OPEN_TIMEOUT_MS = 3e3;
+const connections = /* @__PURE__ */ new Map();
+function open(name) {
+	const existing = connections.get(name);
+	if (existing) return existing;
+	const opening = new Promise((resolve, reject) => {
+		const factory = globalThis.indexedDB;
+		if (!factory) {
+			reject(/* @__PURE__ */ new Error("IndexedDB is unavailable."));
+			return;
+		}
+		let late = false;
+		const timer = setTimeout(() => {
+			late = true;
+			reject(/* @__PURE__ */ new Error("IndexedDB did not open in time."));
+		}, OPEN_TIMEOUT_MS);
+		const request = factory.open(name, VERSION);
+		request.onupgradeneeded = () => {
+			const db = request.result;
+			db.createObjectStore("documents", { keyPath: "board" }).createIndex("user", "userKey");
+			const pending = db.createObjectStore("pending", { keyPath: ["board", "mutationId"] });
+			pending.createIndex("board", "board");
+			pending.createIndex("user", "userKey");
+		};
+		request.onsuccess = () => {
+			clearTimeout(timer);
+			const db = request.result;
+			if (late) {
+				db.close();
+				return;
+			}
+			const forget = () => {
+				if (connections.get(name) === opening) connections.delete(name);
+			};
+			db.onversionchange = () => {
+				db.close();
+				forget();
+			};
+			db.onclose = forget;
+			resolve(db);
+		};
+		request.onerror = () => {
+			clearTimeout(timer);
+			reject(request.error ?? /* @__PURE__ */ new Error("IndexedDB failed to open."));
+		};
+	});
+	connections.set(name, opening);
+	opening.catch(() => {
+		if (connections.get(name) === opening) connections.delete(name);
+	});
+	return opening;
+}
+async function transact(name, stores, mode, work, retry = true) {
+	const db = await open(name);
+	let tx;
+	try {
+		tx = db.transaction(stores, mode);
+	} catch (error) {
+		if (!retry) throw error;
+		db.close();
+		connections.delete(name);
+		return transact(name, stores, mode, work, false);
+	}
+	return new Promise((resolve, reject) => {
+		const result = work(tx);
+		tx.oncomplete = () => resolve(result());
+		tx.onerror = () => reject(tx.error ?? /* @__PURE__ */ new Error("IndexedDB transaction failed."));
+		tx.onabort = () => reject(tx.error ?? /* @__PURE__ */ new Error("IndexedDB transaction aborted."));
+	});
+}
+function deleteByIndex(store, index, key) {
+	const request = store.index(index).openKeyCursor(IDBKeyRange.only(key));
+	request.onsuccess = () => {
+		const cursor = request.result;
+		if (!cursor) return;
+		store.delete(cursor.primaryKey);
+		cursor.continue();
+	};
+}
+let lastOrder = 0;
+function createIndexedDbBoardReplicaStorage(scope, options = {}) {
+	const name = options.database ?? DATABASE;
+	const board = JSON.stringify([
+		scope.userKey,
+		scope.spaceId,
+		scope.boardId
+	]);
+	return {
+		listPending: () => transact(name, ["pending"], "readonly", (tx) => {
+			const request = tx.objectStore("pending").index("board").getAll(IDBKeyRange.only(board));
+			return () => request.result.sort((a, b) => a.order - b.order).map(({ mutationId, patch }) => ({
+				mutationId,
+				patch
+			}));
+		}),
+		putPending: ({ mutationId, patch }) => transact(name, ["pending"], "readwrite", (tx) => {
+			lastOrder = Math.max(Date.now(), lastOrder + 1);
+			const record = {
+				board,
+				mutationId,
+				userKey: scope.userKey,
+				order: lastOrder,
+				patch
+			};
+			tx.objectStore("pending").put(record);
+			return () => void 0;
+		}),
+		deletePending: (mutationId) => transact(name, ["pending"], "readwrite", (tx) => {
+			tx.objectStore("pending").delete([board, mutationId]);
+			return () => void 0;
+		}),
+		readDocument: () => transact(name, ["documents"], "readonly", (tx) => {
+			const request = tx.objectStore("documents").get(board);
+			return () => {
+				const record = request.result;
+				return record ? {
+					version: record.version,
+					document: record.document
+				} : null;
+			};
+		}),
+		writeDocument: (version, document) => transact(name, ["documents"], "readwrite", (tx) => {
+			const store = tx.objectStore("documents");
+			const request = store.get(board);
+			request.onsuccess = () => {
+				const current = request.result;
+				if (current && current.version > version) return;
+				const record = {
+					board,
+					userKey: scope.userKey,
+					version,
+					document
+				};
+				store.put(record);
+			};
+			return () => void 0;
+		})
+	};
+}
+async function clearBoardReplicaStorage(options = {}) {
+	const { userKey } = options;
+	await transact(options.database ?? DATABASE, ["documents", "pending"], "readwrite", (tx) => {
+		for (const name of ["documents", "pending"]) {
+			const store = tx.objectStore(name);
+			if (userKey === void 0) store.clear();
+			else deleteByIndex(store, "user", userKey);
+		}
+		return () => void 0;
+	});
+}
+//#endregion
+export { clearBoardReplicaStorage, createIndexedDbBoardReplicaStorage };

package/dist/board/stage/assets.d.ts

@@ -1,5 +1,6 @@
 import { ModelFormat } from "../../protocol/dist/fs/mime.js";
 import { BoardSceneItem } from "../model/scene.js";
+import { BoardAssetMedia, BoardAssetRef } from "../model/asset-key.js";
 import { BoardAssetUrlOptions } from "../model/media-playback.js";
 import "../model/index.js";
 import { LruBudget } from "./lru.js";
@@ -7,9 +8,6 @@ import { BoardImageTexturePool } from "./texture-pool.js";
 import { Texture } from "pixi.js";
 //#region src/board/stage/assets.d.ts
 type BoardUrlMedia = "image" | "video";
-type BoardAssetMedia = BoardUrlMedia | "model";
-declare function boardTextureEdge(item: BoardSceneItem, scale: number): number;
-declare function boardAssetKey(item: BoardSceneItem): string | null;
 type Size = {
   width: number;
   height: number;
@@ -27,22 +25,44 @@ type BoardModelPreviews = {
 type BoardAssetManager = {
   assetKey: (item: BoardSceneItem) => string | null;
   invalidatePath: (path: string) => void;
+  invalidateItemAssets: () => void;
   requestItem: (item: BoardSceneItem, edge?: number) => void;
+  /** World point used to prioritize queued loads. */
+  focus: (point: {
+    x: number;
+    y: number;
+  } | null) => void;
   getTexture: (key: string) => Texture | null;
   getNaturalSize: (key: string) => Size | null;
+  getTone: (key: string) => number | null;
   hasError: (key: string) => boolean;
   acquire: (key: string) => void;
   release: (key: string) => void;
+  prefetch?: (requests: readonly BoardAssetPrefetch[]) => void;
   withTextures: <T>(items: BoardSceneItem[], use: (textures: Map<string, Texture>) => T | Promise<T>, options?: {
     timeoutMs?: number;
     edge?: (item: BoardSceneItem) => number;
   }) => Promise<T>;
-  subscribe: (listener: (key: string) => void) => () => void;
+  subscribe: (listener: (key: string, change: BoardAssetChange) => void) => () => void;
+  stats: () => {
+    textures: number;
+    cooling: number;
+    bytes: number;
+    loading?: number;
+    prefetching?: number;
+  };
   destroy: () => void;
 };
+type BoardAssetPrefetch = {
+  item: BoardSceneItem;
+  edge: number;
+};
+type BoardAssetChange = "texture" | "tone";
 type BoardAssetManagerOptions = {
   /** Resolve a Space file path to a URL a texture can load from; null when unavailable. */
   resolveFileUrl: (path: string, options?: BoardAssetUrlOptions) => Promise<string | null>;
+  /** undefined keeps the built-in rule, null shows none; cached until `invalidateItemAssets`. */
+  itemAsset?: (item: BoardSceneItem) => BoardAssetRef | null | undefined;
   concurrency?: number;
   videoConcurrency?: number;
   loadVideoPreviews?: boolean;
@@ -51,8 +71,11 @@ type BoardAssetManagerOptions = {
   imageTexturePool?: BoardImageTexturePool;
   loadTexture?: (url: string, media: BoardUrlMedia) => Promise<Texture | null>;
   unloadTexture?: (url: string, texture: Texture | null, media: BoardAssetMedia) => Promise<void>;
+  /** An unshared copy of an image texture at `edge`; null keeps evicting outright. */
+  shrinkTexture?: (texture: Texture, edge: number) => Promise<Texture | null>;
+  readTone?: ((texture: Texture) => Promise<number | null>) | null;
   now?: () => number;
 };
 declare function createBoardAssetManager(options: BoardAssetManagerOptions): BoardAssetManager;
 //#endregion
-export { BoardAssetManager, BoardAssetManagerOptions, BoardModelPreviewRequest, BoardModelPreviews, boardAssetKey, boardTextureEdge, createBoardAssetManager };
+export { BoardAssetChange, BoardAssetManager, BoardAssetManagerOptions, BoardAssetPrefetch, BoardModelPreviewRequest, BoardModelPreviews, createBoardAssetManager };