@cognite/reveal 4.28.7-dev.20260108 → 4.29.0

package/dist/packages/data-providers/index.d.ts

@@ -2,6 +2,7 @@
  * Copyright 2021 Cognite AS
  */
 export { CdfModelDataProvider } from './src/model-data-providers/CdfModelDataProvider';
+export { CachedModelDataProvider } from './src/model-data-providers/CachedModelDataProvider';
 export { CdfModelIdentifier } from './src/model-identifiers/CdfModelIdentifier';
 export { CdfModelMetadataProvider } from './src/metadata-providers/CdfModelMetadataProvider';
 export { Cdf360ImageAnnotationProvider } from './src/image-360-data-providers/Cdf360ImageAnnotationProvider';

package/dist/packages/data-providers/src/model-data-providers/CachedModelDataProvider.d.ts

@@ -0,0 +1,31 @@
+/*!
+ * Copyright 2025 Cognite AS
+ */
+import { ModelDataProvider } from '../ModelDataProvider';
+import { DataFileCacheManager, CacheConfig } from '../../../utilities';
+/**
+ * Wraps a ModelDataProvider with caching capabilities using the Cache API.
+ *
+ * This provider intercepts getBinaryFile and getJsonFile calls and caches
+ * the responses for faster subsequent access.
+ */
+export declare class CachedModelDataProvider implements ModelDataProvider {
+    private readonly baseProvider;
+    private readonly cacheManager;
+    constructor(baseProvider: ModelDataProvider, cacheConfig?: CacheConfig, cacheStorage?: CacheStorage);
+    getBinaryFile(baseUrl: string, fileName: string, abortSignal?: AbortSignal): Promise<ArrayBuffer>;
+    getJsonFile(baseUrl: string, fileName: string): Promise<unknown>;
+    private fetchWithCache;
+    /**
+     * Get the underlying cache manager for direct cache operations
+     */
+    getCacheManager(): DataFileCacheManager;
+    /**
+     * Check if a file is cached
+     */
+    isCached(baseUrl: string, fileName: string): Promise<boolean>;
+    /**
+     * Clear all cached data
+     */
+    clearCache(): Promise<void>;
+}

package/dist/packages/pointclouds/src/createPointCloudManager.d.ts

@@ -3,7 +3,7 @@
  */
 import { PointCloudManager } from './PointCloudManager';
 import * as THREE from 'three';
-import { DMDataSourceType, ModelDataProvider, ModelMetadataProvider, PointCloudStylableObjectProvider } from '../../data-providers';
+import { DMDataSourceType, ModelMetadataProvider, PointCloudStylableObjectProvider, CachedModelDataProvider } from '../../data-providers';
 import { IPointClassificationsProvider } from './classificationsProviders/IPointClassificationsProvider';
 import { PointCloudMaterialManager } from '../../rendering';
-export declare function createPointCloudManager(modelMetadataProvider: ModelMetadataProvider, modelDataProvider: ModelDataProvider, pointCloudStylableObjectProvider: PointCloudStylableObjectProvider, classificationsProvider: IPointClassificationsProvider, pointCloudDMProvider: PointCloudStylableObjectProvider<DMDataSourceType>, pointCloudMaterialManager: PointCloudMaterialManager, scene: THREE.Scene, renderer: THREE.WebGLRenderer): PointCloudManager;
+export declare function createPointCloudManager(modelMetadataProvider: ModelMetadataProvider, pointCloudStylableObjectProvider: PointCloudStylableObjectProvider, classificationsProvider: IPointClassificationsProvider, pointCloudDMProvider: PointCloudStylableObjectProvider<DMDataSourceType>, pointCloudMaterialManager: PointCloudMaterialManager, cachedProvider: CachedModelDataProvider, scene: THREE.Scene, renderer: THREE.WebGLRenderer): PointCloudManager;

package/dist/packages/utilities/index.d.ts

@@ -35,6 +35,9 @@ export { WebGLRendererStateHelper } from './src/WebGLRendererStateHelper';
 export { TypedArray, TypedArrayConstructor } from './src/types';
 export { MemoryRequestCache } from './src/cache/MemoryRequestCache';
 export { MostFrequentlyUsedCache } from './src/cache/MostFrequentlyUsedCache';
+export { DataFileCacheManager } from './src/cache/DataFileCacheManager';
+export type { CacheConfig } from './src/cache/types';
+export { BINARY_FILES_CACHE_NAME } from './src/cache/constants';
 export { disposeAttributeArrayOnUpload } from './src/disposeAttributeArrayOnUpload';
 export { incrementOrInsertIndex, decrementOrDeleteIndex } from './src/counterMap';
 export { calculateVolumeOfMesh } from './src/calculateVolumeOfMesh';

package/dist/packages/utilities/src/cache/DataFileCacheManager.d.ts

@@ -0,0 +1,49 @@
+import { CacheConfig } from './types';
+/**
+ * Data File Cache Manager using the Browser Cache API for storing various data files
+ * Supports caching of binary files (point clouds, CAD models), images (360 images), and JSON data
+ *
+ * @example
+ * ```typescript
+ * // Default: Cache forever, browser manages eviction
+ * const cache = new DataFileCacheManager({
+ *   cacheName: 'reveal-3d-resources-v1'
+ * });
+ *
+ * // Optional: Add time-based expiration
+ * const cache = new DataFileCacheManager({
+ *   cacheName: 'reveal-3d-resources-v1',
+ *   maxAge: 7 * 24 * 60 * 60 * 1000 // Expire after 7 days
+ * });
+ *
+ * // Store a response
+ * await cache.storeResponse(url, response);
+ *
+ * // Retrieve cached response, returns undefined if expired or not found
+ * const cachedResponse = await cache.getCachedResponse(url);
+ * ```
+ */
+export declare class DataFileCacheManager {
+    private readonly DEFAULT_CONFIG;
+    private readonly _config;
+    private readonly _caches;
+    get cacheConfig(): CacheConfig;
+    constructor(config?: Partial<CacheConfig>, cacheStorage?: CacheStorage);
+    /**
+     * Check if a URL is cached and not expired
+     */
+    has(url: string): Promise<boolean>;
+    /**
+     * Clear all cached entries
+     */
+    clear(): Promise<void>;
+    /**
+     * Get a cached response if it exists and is not expired
+     */
+    getCachedResponse(url: string): Promise<Response | undefined>;
+    /**
+     * Store data in cache
+     * Browser will automatically evict old entries when quota is reached
+     */
+    storeResponse(url: string, data: ArrayBuffer, contentType?: string): Promise<void>;
+}

package/dist/packages/utilities/src/cache/constants.d.ts

@@ -0,0 +1,6 @@
+/*!
+ * Copyright 2025 Cognite AS
+ */
+export declare const BINARY_FILES_CACHE_NAME = "reveal-3d-resources-v1";
+export declare const BINARY_FILES_CACHE_HEADER_DATE = "X-Cache-Date";
+export declare const BINARY_FILES_CACHE_HEADER_SIZE = "X-Cache-Size";

package/dist/packages/utilities/src/cache/types.d.ts

@@ -0,0 +1,14 @@
+/*!
+ * Copyright 2025 Cognite AS
+ */
+/**
+ * Configuration for cache behavior
+ */
+export type CacheConfig = {
+    /** Name of the cache */
+    cacheName: string;
+    /** Maximum age in milliseconds before entries expire (Default is Infinity = never expire) */
+    maxAge: number;
+    /** Maximum cache size in bytes (Default is Infinity = browser manages quota) */
+    maxCacheSize: number;
+};

package/dist/packages/utilities/src/cache/utils.d.ts

@@ -0,0 +1,6 @@
+/*!
+ * Copyright 2025 Cognite AS
+ */
+export declare function safeParseInt(value: string | null | undefined): number | undefined;
+export declare function getCacheDate(response: Response): number | undefined;
+export declare function getCacheSize(response: Response): number | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cognite/reveal",
-  "version": "4.28.7-dev.20260108",
+  "version": "4.29.0",
   "description": "WebGL based 3D viewer for CAD and point clouds processed in Cognite Data Fusion.",
   "homepage": "https://github.com/cognitedata/reveal/tree/master/viewer",
   "repository": {