digitaltwin-core 0.13.1 → 0.13.3

package/dist/components/tileset_manager.d.ts

@@ -5,64 +5,67 @@ import type { HttpMethod } from '../engine/endpoints.js';
 import type { AsyncUploadable } from './async_upload.js';
 import type { Queue } from 'bullmq';
 /**
- * Extended metadata for tileset assets with file index support
+ * Metadata stored in database for a tileset.
+ * Simplified: Cesium accesses files directly from OVH.
  */
 export interface TilesetMetadataRow {
     id?: number;
     name: string;
     type: string;
+    /** Base path in storage for deletion (e.g., tilesets/123) */
     url: string;
+    /** Public URL to tileset.json */
+    tileset_url: string;
     date: Date;
     description: string;
-    source: string;
-    owner_id: number | null;
     filename: string;
+    owner_id: number | null;
     is_public?: boolean;
-    file_index?: {
-        files: Array<{
-            path: string;
-            name: string;
-            size: number;
-        }>;
-        root_file?: string;
-    };
+    upload_status?: 'pending' | 'processing' | 'completed' | 'failed';
+    upload_job_id?: string;
+    upload_error?: string;
 }
 /**
  * Specialized Assets Manager for handling 3D Tiles tilesets.
  *
- * This manager extracts uploaded ZIP files and stores each file individually,
- * allowing Cesium and other 3D viewers to load tilesets directly via URL.
+ * This manager extracts uploaded ZIP files and stores each file in cloud storage (OVH S3),
+ * allowing Cesium and other 3D viewers to load tilesets directly via public URLs.
+ *
+ * ## How it works
  *
- * Key features:
- * - Extracts ZIP archives on upload (no ZIP stored, only extracted files)
- * - Detects and tracks the root tileset.json file
- * - Serves individual files via dedicated endpoint
- * - Returns tileset.json URL for direct Cesium loading
+ * 1. User uploads a ZIP containing a 3D Tiles tileset
+ * 2. ZIP is extracted and all files are stored in OVH with public-read ACL
+ * 3. Database stores only the tileset.json URL and base path
+ * 4. Cesium loads tileset.json directly from OVH
+ * 5. Cesium fetches tiles using relative paths in tileset.json (directly from OVH)
  *
- * Endpoints:
- * - GET /{endpoint} - List all tilesets with tileset.json URLs
- * - POST /{endpoint} - Upload tileset ZIP (extracts and stores files)
- * - GET /{endpoint}/:id - Get tileset metadata
- * - GET /{endpoint}/:id/files/* - Serve extracted files (tileset.json, .b3dm, etc.)
+ * ## Endpoints
+ *
+ * - GET /{endpoint} - List all tilesets with their public URLs
+ * - POST /{endpoint} - Upload tileset ZIP (sync < 50MB, async >= 50MB)
+ * - GET /{endpoint}/:id/status - Poll async upload status
  * - PUT /{endpoint}/:id - Update tileset metadata
- * - DELETE /{endpoint}/:id - Delete tileset and all extracted files
+ * - DELETE /{endpoint}/:id - Delete tileset and all files from storage
  *
  * @example
  * ```typescript
  * class MyTilesetManager extends TilesetManager {
  *   getConfiguration() {
  *     return {
- *       name: 'tilesets_manager',
+ *       name: 'tilesets',
  *       description: 'Manage 3D Tiles tilesets',
  *       contentType: 'application/json',
  *       endpoint: 'api/tilesets',
- *       tags: ['Tileset']
+ *       extension: '.zip'
  *     }
  *   }
  * }
  *
- * // After upload, Cesium can load:
- * // Cesium3DTileset.fromUrl('/api/tilesets/123/files/tileset.json')
+ * // After upload, response contains:
+ * // { tileset_url: 'https://bucket.s3.../tilesets/123/tileset.json' }
+ * //
+ * // Cesium loads directly:
+ * // Cesium.Cesium3DTileset.fromUrl(tileset_url)
  * ```
  */
 export declare abstract class TilesetManager extends AssetsManager implements AsyncUploadable {
@@ -74,53 +77,39 @@ export declare abstract class TilesetManager extends AssetsManager implements As
      */
     setUploadQueue(queue: Queue): void;
     /**
-     * Override the upload handler to support async processing for large files.
-     *
-     * When uploadQueue is available (async mode):
-     * 1. Validates request and authentication
-     * 2. Creates a database record with status 'pending'
-     * 3. Queues a job for background processing
-     * 4. Returns immediately with job ID
-     *
-     * When uploadQueue is not available (sync mode - fallback):
-     * 1. Validates request and authentication
-     * 2. Extracts ZIP and stores files synchronously
-     * 3. Returns with completed tileset info
+     * Handle tileset upload.
      *
-     * @param req - HTTP request with ZIP file upload
-     * @returns DataResponse with upload result (async: job info, sync: tileset info)
+     * - Files < 50MB: Synchronous extraction and upload
+     * - Files >= 50MB: Queued for async processing (returns 202)
      */
     handleUpload(req: any): Promise<DataResponse>;
+    /**
+     * Authenticate user from request headers.
+     * Returns user ID on success, or error response on failure.
+     */
+    private authenticateUser;
     /**
      * Queue upload for background processing. Returns HTTP 202 immediately.
      */
     private handleAsyncUpload;
     /**
-     * Process upload synchronously (fallback when queue unavailable).
+     * Process upload synchronously.
      */
     private handleSyncUpload;
     /**
-     * Get upload status for polling. Returns: pending | processing | completed | failed
+     * Get upload status for async uploads.
      */
     handleGetStatus(req: any): Promise<DataResponse>;
     /**
-     * Serve extracted tileset file (tileset.json, .b3dm, textures, etc.)
-     */
-    handleGetFile(req: any): Promise<DataResponse>;
-    /**
-     * Determines the MIME content type based on file extension.
-     */
-    private getContentTypeForFile;
-    /**
-     * Override retrieve to include tileset.json URL in the response.
+     * List all tilesets with their public URLs.
      */
     retrieve(req?: any): Promise<DataResponse>;
     /**
-     * Delete tileset and all extracted files from storage.
+     * Delete tileset and all files from storage.
      */
     handleDelete(req: any): Promise<DataResponse>;
     /**
-     * Override getEndpoints to add the file serving endpoint.
+     * Get HTTP endpoints for this manager.
      */
     getEndpoints(): Array<{
         method: HttpMethod;
@@ -129,7 +118,7 @@ export declare abstract class TilesetManager extends AssetsManager implements As
         responseType?: string;
     }>;
     /**
-     * Override OpenAPI specification to include tileset-specific endpoints.
+     * Generate OpenAPI specification.
      */
     getOpenAPISpec(): OpenAPIComponentSpec;
 }

package/dist/components/tileset_manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tileset_manager.d.ts","sourceRoot":"","sources":["../../src/components/tileset_manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAIxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAGnC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,IAAI,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB,UAAU,CAAC,EAAE;QACT,KAAK,EAAE,KAAK,CAAC;YACT,IAAI,EAAE,MAAM,CAAA;YACZ,IAAI,EAAE,MAAM,CAAA;YACZ,IAAI,EAAE,MAAM,CAAA;SACf,CAAC,CAAA;QACF,SAAS,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;CACJ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,8BAAsB,cAAe,SAAQ,aAAc,YAAW,eAAe;IACjF,6DAA6D;IAC7D,SAAS,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI,CAAO;IAE1C;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAGlC;;;;;;;;;;;;;;;;OAgBG;IACG,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;IAuFnD;;OAEG;YACW,iBAAiB;IAiE/B;;OAEG;YACW,gBAAgB;IAyE9B;;OAEG;IACG,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;IA0EtD;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;IAsFpD;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;OAEG;IACG,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;IA+DhD;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;IA8FnD;;OAEG;IACH,YAAY,IAAI,KAAK,CAAC;QAClB,MAAM,EAAE,UAAU,CAAA;QAClB,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;QAChC,YAAY,CAAC,EAAE,MAAM,CAAA;KACxB,CAAC;IA2CF;;OAEG;IACH,cAAc,IAAI,oBAAoB;CAmGzC"}
+{"version":3,"file":"tileset_manager.d.ts","sourceRoot":"","sources":["../../src/components/tileset_manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAIxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAcnC;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAA;IACX,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,IAAI,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,aAAa,CAAC,EAAE,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAA;IACjE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,8BAAsB,cAAe,SAAQ,aAAc,YAAW,eAAe;IACjF,6DAA6D;IAC7D,SAAS,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI,CAAO;IAE1C;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAIlC;;;;;OAKG;IACG,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;IAkDnD;;;OAGG;YACW,gBAAgB;IA0B9B;;OAEG;YACW,iBAAiB;IAgE/B;;OAEG;YACW,gBAAgB;IAqE9B;;OAEG;IACG,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;IAwCtD;;OAEG;IACG,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;IAyChD;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;IA8DnD;;OAEG;IACH,YAAY,IAAI,KAAK,CAAC;QAClB,MAAM,EAAE,UAAU,CAAA;QAClB,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;QAChC,YAAY,CAAC,EAAE,MAAM,CAAA;KACxB,CAAC;IA0CF;;OAEG;IACH,cAAc,IAAI,oBAAoB;CA0LzC"}