@cognite/reveal 4.29.1 → 4.29.2-dev.20260211

package/dist/packages/360-images/src/collection/DefaultImage360Collection.d.ts

@@ -32,10 +32,13 @@ export declare class DefaultImage360Collection<T extends DataSourceType> impleme
     private readonly _events;
     private readonly _icons;
     private _isCollectionVisible;
-    private readonly _collectionId;
+    private readonly _sourceId;
     private readonly _collectionLabel;
     private readonly _setNeedsRedraw;
-    get collectionId(): T['image360Identifier'];
+    /**
+     * returns the source ID of the collection
+     */
+    get sourceId(): T['image360Identifier'];
     /**
      * @deprecated
      */

package/dist/packages/360-images/src/collection/Image360Collection.d.ts

@@ -81,7 +81,8 @@ export type Image360AnnotationAssetQueryResult<T extends DataSourceType = Classi
 export interface Image360Collection<T extends DataSourceType = ClassicDataSourceType> {
     /**
      * The id of the collection.
-     * @returns The id of the collection.
+     * @returns The id of the collection
+     * @deprecated Use `sourceId` instead
      */
     readonly id: string;
     /**
@@ -89,6 +90,10 @@ export interface Image360Collection<T extends DataSourceType = ClassicDataSource
      * @returns The label of the collection.
      */
     readonly label: string | undefined;
+    /**
+     * The source identifier of the collection.
+     */
+    readonly sourceId: T['image360Identifier'];
     /**
      * A list containing all the 360 images in this set.
      */

package/dist/packages/data-providers/src/image-360-data-providers/Cdf360ImageFileProvider.d.ts

@@ -1,10 +1,14 @@
 import { Image360Face, Image360FileDescriptor, Image360FileProvider } from '../types';
-import { CogniteClient, InternalId } from '@cognite/sdk';
+import { FileIdentifier, FileDownloadResult } from './CdfImageFileProvider';
+import { CogniteClient } from '@cognite/sdk';
 export declare class Cdf360ImageFileProvider implements Image360FileProvider {
     private readonly _imageFileProvider;
     constructor(client: CogniteClient);
     get360ImageFiles(image360FaceDescriptors: Image360FileDescriptor[], abortSignal?: AbortSignal): Promise<Image360Face[]>;
     getLowResolution360ImageFiles(image360FaceDescriptors: Image360FileDescriptor[], abortSignal?: AbortSignal): Promise<Image360Face[]>;
 }
-export declare function getFileIds(image360FaceDescriptors: Image360FileDescriptor[]): InternalId[];
-export declare function createFacesFromDescriptorsAndBuffers(image360FaceDescriptors: Image360FileDescriptor[], fileBuffer: ArrayBuffer[]): Image360Face[];
+/**
+ * Extracts file identifiers from face descriptors.
+ */
+export declare function getFileIdentifiers(image360FaceDescriptors: Image360FileDescriptor[]): FileIdentifier[];
+export declare function createFacesFromDescriptorsAndDownloads(image360FaceDescriptors: Image360FileDescriptor[], downloadResults: FileDownloadResult[]): Image360Face[];

package/dist/packages/data-providers/src/image-360-data-providers/CdfImageFileProvider.d.ts

@@ -2,14 +2,42 @@
  * Copyright 2025 Cognite AS
  */
 import { CogniteClient } from '@cognite/sdk';
+import { DMInstanceRef } from '../../../utilities';
+/**
+ * File identifier types supported by CDF's /files/downloadlink endpoint.
+ */
+export type FileIdentifier = {
+    id: number;
+} | {
+    externalId: string;
+} | {
+    instanceId: DMInstanceRef;
+};
+/**
+ * Result of downloading a file, including both the data and the mimeType
+ * extracted from the Content-Type response header.
+ */
+export type FileDownloadResult = {
+    data: ArrayBuffer;
+    mimeType: 'image/jpeg' | 'image/png';
+};
 export declare class CdfImageFileProvider {
     private readonly _client;
     constructor(sdk: CogniteClient);
-    getFileBuffers(fileIds: {
-        id: number;
-    }[], abortSignal?: AbortSignal): Promise<ArrayBuffer[]>;
-    getIconBuffers(fileIds: {
-        id: number;
-    }[], abortSignal?: AbortSignal): Promise<ArrayBuffer[]>;
+    /**
+     * Downloads files and returns both the data and mimeType (from Content-Type header).
+     */
+    getFileBuffersWithMimeType(fileIdentifiers: FileIdentifier[], abortSignal?: AbortSignal): Promise<FileDownloadResult[]>;
+    getFileBuffers(fileIdentifiers: FileIdentifier[], abortSignal?: AbortSignal): Promise<ArrayBuffer[]>;
+    /**
+     * Downloads low-resolution icon versions of files.
+     * The /files/icon endpoint only supports internal numeric IDs.
+     */
+    getIconBuffersWithMimeType(fileIdentifiers: FileIdentifier[], abortSignal?: AbortSignal): Promise<FileDownloadResult[]>;
+    private partitionIdentifiersByInternalId;
+    private resolveInternalIdsFromDownloadUrls;
+    private mergeResultsInOriginalOrder;
+    private fetchIconsById;
+    getIconBuffers(fileIdentifiers: FileIdentifier[], abortSignal?: AbortSignal): Promise<ArrayBuffer[]>;
     private getDownloadUrls;
 }

package/dist/packages/data-providers/src/image-360-data-providers/descriptor-providers/datamodels/cdm/Cdf360CdmBatchCollectionLoader.d.ts

@@ -12,25 +12,30 @@ import { BatchLoader } from '../../../../utilities/BatchLoader';
  * Instead of loading each collection individually (1000 queries for 1000 collections),
  * it batches them into groups and makes far fewer queries (e.g., 20 queries for 1000 collections).
  * This allows collections with any number of images, not just ~200 per collection (10,000 / 50 batch size).
+ *
+ * This loader uses instance IDs directly from DMS queries to identify files,
+ * eliminating the need for /files/byids API calls to resolve file metadata.
+ * This significantly improves loading performance for large collections (e.g., 16k+ images).
  */
 export declare class Cdf360CdmBatchCollectionLoader extends BatchLoader<DMInstanceRef, Historical360ImageSet<DMDataSourceType>[]> {
     private readonly _dmsSdk;
-    private readonly _cogniteSdk;
-    constructor(dmsSdk: DataModelsSdk, cogniteSdk: CogniteClient);
+    constructor(dmsSdk: DataModelsSdk, _cogniteSdk: CogniteClient);
     getCollectionDescriptors(identifier: DMInstanceRef): Promise<Historical360ImageSet<DMDataSourceType>[]>;
     protected fetchBatch(identifiers: DMInstanceRef[]): Promise<Map<DMInstanceKey, Historical360ImageSet<DMDataSourceType>[]>>;
     protected getKeyForIdentifier(identifier: DMInstanceRef): DMInstanceKey;
     protected getDefaultResult(_identifier: DMInstanceRef): Historical360ImageSet<DMDataSourceType>[];
     private fetchAllPages;
     private groupResultsByCollection;
-    private getFileDescriptorsForBatch;
-    private getFileDescriptorsForImages;
+    /**
+     * Creates file descriptors directly from the DMS image data using instance IDs.
+     * This avoids the need to call /files/byids to resolve file metadata.
+     * The instance IDs are used directly with the /files/downloadlink endpoint.
+     */
+    private createFileDescriptorsFromImage;
     private createHistoricalImageSets;
     private getHistorical360ImageSet;
     private getImageRevision;
-    private getFaceDescriptors;
     private getRevisionTransform;
-    private getCdmFiles;
     private stringifyValue;
     private toNumber;
 }

package/dist/packages/data-providers/src/image-360-data-providers/descriptor-providers/datamodels/system-space/Cdf360DataModelsDescriptorProvider.d.ts

@@ -35,11 +35,13 @@ export type Image360BaseIdentifier = {
 };
 export declare class Cdf360DataModelsDescriptorProvider implements Image360DescriptorProvider<ClassicDataSourceType> {
     readonly _dmsSdk: DataModelsSdk;
-    private readonly _cogniteSdk;
     constructor(sdk: CogniteClient);
     get360ImageDescriptors(collectionIdentifier: Image360DataModelIdentifier, _: boolean): Promise<Historical360ImageSet<ClassicDataSourceType>[]>;
+    /**
+     * Creates file descriptors directly from the DMS image data using external IDs.
+     */
+    private createFileDescriptorsFromImage;
     private queryCollection;
-    private getFileDescriptors;
     private getHistorical360ImageSet;
     private getImageRevision;
     private getRevisionTransform;

package/dist/packages/data-providers/src/pointcloud-stylable-object-providers/pointcloud-volume-data-providers/getDMPointCloudObjects.d.ts

@@ -1,4 +1,11 @@
 import { DataModelsSdk } from '../../DataModelsSdk';
+import { CdfDMPointCloudVolumeQuery } from './getDMPointCloudVolumeCollectionQuery';
 import { CdfPointCloudObjectAnnotation } from '../types';
 import { DMModelIdentifierType } from '../../DataSourceType';
+type QueryResult = Awaited<ReturnType<typeof DataModelsSdk.prototype.queryNodesAndEdges<CdfDMPointCloudVolumeQuery>>>;
+export type ExhaustedQueryResult = {
+    pointCloudVolumes: QueryResult['pointCloudVolumes'];
+    assets: QueryResult['assets'];
+};
 export declare function getDMPointCloudObjects(dmsSdk: DataModelsSdk, modelIdentifier: DMModelIdentifierType): Promise<CdfPointCloudObjectAnnotation[]>;
+export {};

package/dist/packages/data-providers/src/pointcloud-stylable-object-providers/pointcloud-volume-data-providers/getDMPointCloudVolumeCollectionQuery.d.ts

@@ -63,6 +63,9 @@ declare const getDMPointCloudVolumeQuery: (revisionRef: DMInstanceRef) => {
                 readonly properties: ["revisions", "volumeReferences", "volumeType", "volume", "object3D"];
             }];
         };
+        readonly object3D: {
+            readonly sources: [];
+        };
         readonly assets: {
             readonly sources: [{
                 readonly source: {

package/dist/packages/data-providers/src/types.d.ts

@@ -89,9 +89,14 @@ export type Image360Texture = {
     texture: THREE.Texture;
 };
 export type Image360FileDescriptor = {
-    fileId: number;
     face: 'front' | 'back' | 'left' | 'right' | 'top' | 'bottom';
     mimeType: 'image/jpeg' | 'image/png';
+    /** Internal CDF file ID (numeric) */
+    fileId?: number;
+    /** External file ID (string) - for system-space/FDM collections */
+    externalId?: string;
+    /** DM instance reference - for CDM collections */
+    instanceId?: DMInstanceRef;
 };
 export declare enum File3dFormat {
     EptPointCloud = "ept-pointcloud",

package/dist/packages/data-providers/src/utilities/constants.d.ts

@@ -46,3 +46,4 @@ export declare const COGNITE_360_IMAGE_STATION_SOURCE: {
     readonly type: "view";
 };
 export declare const MAX_DMS_QUERY_LIMIT = 10000;
+export declare const DEFAULT_360_IMAGE_MIME_TYPE: "image/jpeg";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cognite/reveal",
-  "version": "4.29.1",
+  "version": "4.29.2-dev.20260211",
   "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": {
@@ -134,7 +134,7 @@
     "ts-loader": "^9.5.1",
     "tsc-alias": "^1.8.8",
     "typescript": "^5.4.5",
-    "wasm-pack": "^0.13.0",
+    "wasm-pack": "^0.14.0",
     "webpack": "^5.91.0",
     "webpack-cli": "^5.1.4",
     "webpack-dev-server": "^5.0.4",