@mesh-sync/worker-backend-client 1.0.3 → 1.0.5

package/README.md

@@ -140,6 +140,99 @@ await client.sendToQueue(MessageTypes.FILE_DOWNLOAD_REQUEST, {
 
 
 
+### media-batch-download-completed
+
+**Description:** Notifies that a batch media download has been completed.
+
+**Method:** `client.mediaBatchDownloadCompleted(data)`
+
+**Payload Type:** `MediaBatchDownloadCompletedMessage`
+
+**Fields:**
+
+- `batchId` (string) [✓]: The unique identifier for the batch download operation.
+
+- `status` (string) [✓]: The final status of the batch download operation.
+
+- `processedFiles` (array) [✗]: List of successfully processed files.
+
+- `failedFiles` (array) [✗]: List of files that failed to process.
+
+- `processedAt` (string) [✓]: Timestamp when the batch processing completed.
+
+- `statistics` (object) [✗]: Statistics about the batch processing.
+
+
+
+### media-batch-download-request
+
+**Description:** Request to download and process a batch of media files from a storage provider. Images are compressed and resized to specified dimensions, converted to WebP format. Text files and documents are processed and stored with metadata. All processed files are uploaded to MinIO S3 storage under the media/{batchId}/ prefix.
+
+
+**Method:** `client.mediaBatchDownloadRequest(data)`
+
+**Payload Type:** `MediaBatchDownloadRequestMessage`
+
+**Fields:**
+
+- `batchId` (string) [✗]: Unique identifier for this batch of media files. Used for organizing processed files in S3 storage (media/{batchId}/) and correlating with completion responses.
+
+
+- `storageConnectionId` (string) [✗]: UUID of the StorageConnection entity from which to download the media files. Used to authenticate and access the source storage provider.
+
+
+- `mediaFiles` (array) [✗]: Array of media files to download and process. Must contain at least one file. Each file includes metadata for identification and processing.
+
+
+- `compressionSettings` (object) [✗]: Optional compression settings that override deployment environment defaults. If not provided, uses values from MAX_IMAGE_WIDTH, MAX_IMAGE_HEIGHT, IMAGE_QUALITY, and OUTPUT_FORMAT environment variables.
+
+
+
+
+### metamodel-metadata-generation-completed
+
+**Description:** Handles metamodel metadata generation completion. Contains AI-generated metadata and aggregated technical analysis.
+
+**Method:** `client.metamodelMetadataGenerationCompleted(data)`
+
+**Payload Type:** `MetamodelMetadataGenerationCompletedMessage`
+
+**Fields:**
+
+- `metamodelId` (string) [✓]: The unique identifier for the metamodel
+
+- `metadata` (object) [✓]: AI-generated metadata for the metamodel
+
+- `technicalMetadata` (object) [✓]: Aggregated technical analysis from constituent models
+
+
+
+### metamodel-metadata-generation-request
+
+**Description:** Handles metamodel metadata generation requests via Ollama. Aggregates data from constituent models and generates AI-enhanced metadata.
+
+**Method:** `client.metamodelMetadataGenerationRequest(data)`
+
+**Payload Type:** `MetamodelMetadataGenerationRequestMessage`
+
+**Fields:**
+
+- `metamodelId` (string) [✗]: The unique identifier for the metamodel
+
+- `constituentModelIds` (array) [✗]: Array of model IDs that compose this metamodel
+
+- `name` (string) [✗]: The name of the metamodel
+
+- `ownerId` (string) [✗]: The owner's user ID
+
+- `libraryId` (string) [✗]: The library containing this metamodel
+
+- `constituentModels` (array) [✗]: Enriched metadata for constituent models (includes storage items)
+
+- `webhookUrl` (string) [✗]: Optional webhook URL for async completion notification
+
+
+
 ### model-discovery-folder-processed-event
 
 **Description:** Handles model discovery folder processed events.
@@ -276,7 +369,7 @@ await client.sendToQueue(MessageTypes.FILE_DOWNLOAD_REQUEST, {
 
 ### model-metamodel-detection-found
 
-**Description:** Handles model metamodel detection found.
+**Description:** Handles model metamodel detection found with hierarchical relationships.
 
 **Method:** `client.modelMetamodelDetectionFound(data)`
 
@@ -284,7 +377,7 @@ await client.sendToQueue(MessageTypes.FILE_DOWNLOAD_REQUEST, {
 
 **Fields:**
 
-- `suggestions` (array) [✓]: List of metamodel suggestions.
+- `metamodels` (array) [✓]: List of metamodel nodes in hierarchical structure (roots and children).
 
 
 
@@ -312,6 +405,114 @@ await client.sendToQueue(MessageTypes.FILE_DOWNLOAD_REQUEST, {
 
 
 
+### model-technical-metadata-completed
+
+**Description:** Reports comprehensive results of technical metadata analysis including geometry, quality metrics, and print-readiness assessment
+
+**Method:** `client.modelTechnicalMetadataCompleted(data)`
+
+**Payload Type:** `ModelTechnicalMetadataCompletedMessage`
+
+**Fields:**
+
+- `originalJobId` (string) [✗]: ID of the original analysis request job
+
+- `modelId` (string) [✗]: ID of the analyzed model
+
+- `status` (string) [✗]: Analysis completion status
+
+- `vertices` (integer) [✗]: Number of vertices in the mesh
+
+- `faces` (integer) [✗]: Number of faces/polygons in the mesh
+
+- `edges` (integer) [✗]: Number of edges in the mesh
+
+- `detailLevel` (string) [✗]: Visual detail level based on polygon density
+
+- `boundingBox` (object) [✗]: 3D bounding box dimensions in millimeters
+
+- `volumeCubicMm` (number) [✗]: Model volume in cubic millimeters (for material calculation)
+
+- `surfaceAreaSqMm` (number) [✗]: Total surface area in square millimeters
+
+- `minWallThickness` (number) [✗]: Minimum wall thickness detected in millimeters (critical for printability)
+
+- `maxWallThickness` (number) [✗]: Maximum wall thickness detected in millimeters
+
+- `manifold` (boolean) [✗]: Is the mesh watertight/manifold? Critical for 3D printing (true = printable)
+
+- `nonManifoldEdges` (integer) [✗]: Number of non-manifold edges (repair needed if > 0)
+
+- `holes` (integer) [✗]: Number of holes/boundary loops in the mesh (0 = closed mesh)
+
+- `flippedNormals` (integer) [✗]: Number of faces with inverted normals (causes rendering/slicing issues)
+
+- `selfIntersections` (integer) [✗]: Number of self-intersecting faces (0 = clean geometry)
+
+- `qualityScore` (number) [✗]: Overall quality score 0-100 (100 = perfect for printing, <60 needs repair)
+
+- `printabilityScore` (number) [✗]: Printability score 0-100 (considers supports, orientation, size constraints)
+
+- `requiresSupports` (boolean) [✗]: Does this model require support structures for 3D printing?
+
+- `overhangs` (array) [✗]: Detected overhang areas requiring support structures
+
+- `estimatedPrintTimeMinutes` (integer) [✗]: Estimated print time in minutes using normal quality settings (0.2mm layers, 20% infill)
+
+- `printTimeEstimates` (object) [✗]: Print time estimates for different quality presets
+
+- `estimatedMaterialGrams` (number) [✗]: Estimated material usage in grams using 20% infill (assumes PLA density 1.24g/cm³)
+
+- `materialEstimates` (object) [✗]: Material usage estimates for different infill percentages
+
+- `recommendedOrientation` (object) [✗]: Recommended print orientation for minimal support material and best results
+
+- `originalUnit` (string) [✗]: Original file format unit detected from metadata or inferred from scale
+
+- `formatVersion` (string) [✗]: File format version (e.g., 'STL Binary', 'OBJ v4', 'PLY 1.0')
+
+- `hasColorData` (boolean) [✗]: Does the file contain per-vertex color information?
+
+- `hasTextureCoordinates` (boolean) [✗]: Does the file contain UV texture mapping coordinates?
+
+- `hasVertexNormals` (boolean) [✗]: Does the file contain per-vertex normal vectors?
+
+- `analyzedBy` (string) [✗]: Tool/service that performed the analysis
+
+- `analysisVersion` (string) [✗]: Version of the analysis algorithm (for tracking improvements)
+
+- `analysisConfidence` (number) [✗]: Confidence level of analysis results (0.0 = uncertain, 1.0 = highly confident)
+
+- `analysisWarnings` (array) [✗]: Warnings or issues detected during analysis (structured for programmatic handling)
+
+- `analyzedAt` (string) [✗]: ISO 8601 timestamp when analysis was performed (e.g., '2025-11-19T14:35:22Z')
+
+- `errorMessage` (string) [✗]: Detailed error message if status is FAILED
+
+- `errorCode` (string) [✗]: Machine-readable error code for programmatic error handling
+
+
+
+### model-technical-metadata-request
+
+**Description:** Triggers comprehensive technical analysis of a 3D model file to extract geometry, quality metrics, and print-readiness information
+
+**Method:** `client.modelTechnicalMetadataRequest(data)`
+
+**Payload Type:** `ModelTechnicalMetadataRequestMessage`
+
+**Fields:**
+
+- `modelId` (string) [✗]: Unique identifier for the model to analyze
+
+- `ownerId` (string) [✗]: User ID who owns the model
+
+- `storageLocation` (object) [✗]: Location of the 3D model file
+
+- `analysisOptions` (object) [✗]: Optional analysis configuration parameters
+
+
+
 ### thumbnail-generation-completed
 
 **Description:** Handles thumbnail generation completed.
@@ -402,6 +603,19 @@ new WorkerClient(config: WorkerClientConfig)
 - `fileDownloadRequest(data: FileDownloadRequestMessage): Promise<JobResponse>`
   - Handles file download requests.
 
+- `mediaBatchDownloadCompleted(data: MediaBatchDownloadCompletedMessage): Promise<JobResponse>`
+  - Notifies that a batch media download has been completed.
+
+- `mediaBatchDownloadRequest(data: MediaBatchDownloadRequestMessage): Promise<JobResponse>`
+  - Request to download and process a batch of media files from a storage provider. Images are compressed and resized to specified dimensions, converted to WebP format. Text files and documents are processed and stored with metadata. All processed files are uploaded to MinIO S3 storage under the media/{batchId}/ prefix.
+
+
+- `metamodelMetadataGenerationCompleted(data: MetamodelMetadataGenerationCompletedMessage): Promise<JobResponse>`
+  - Handles metamodel metadata generation completion. Contains AI-generated metadata and aggregated technical analysis.
+
+- `metamodelMetadataGenerationRequest(data: MetamodelMetadataGenerationRequestMessage): Promise<JobResponse>`
+  - Handles metamodel metadata generation requests via Ollama. Aggregates data from constituent models and generates AI-enhanced metadata.
+
 - `modelDiscoveryFolderProcessedEvent(data: ModelDiscoveryFolderProcessedEventMessage): Promise<JobResponse>`
   - Handles model discovery folder processed events.
 
@@ -421,11 +635,17 @@ new WorkerClient(config: WorkerClientConfig)
   - Handles model metadata generation requests.
 
 - `modelMetamodelDetectionFound(data: ModelMetamodelDetectionFoundMessage): Promise<JobResponse>`
-  - Handles model metamodel detection found.
+  - Handles model metamodel detection found with hierarchical relationships.
 
 - `modelMetamodelDetectionRequest(data: ModelMetamodelDetectionRequestMessage): Promise<JobResponse>`
   - Handles model metamodel detection requests.
 
+- `modelTechnicalMetadataCompleted(data: ModelTechnicalMetadataCompletedMessage): Promise<JobResponse>`
+  - Reports comprehensive results of technical metadata analysis including geometry, quality metrics, and print-readiness assessment
+
+- `modelTechnicalMetadataRequest(data: ModelTechnicalMetadataRequestMessage): Promise<JobResponse>`
+  - Triggers comprehensive technical analysis of a 3D model file to extract geometry, quality metrics, and print-readiness information
+
 - `thumbnailGenerationCompleted(data: ThumbnailGenerationCompletedMessage): Promise<JobResponse>`
   - Handles thumbnail generation completed.
 

package/dist/client.d.ts

@@ -49,6 +49,31 @@ export declare class WorkerClient {
      * @returns Job response with job ID
      */
     fileDownloadRequest(data: types.FileDownloadRequestMessage): Promise<JobResponse>;
+    /**
+     * Notifies that a batch media download has been completed.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    mediaBatchDownloadCompleted(data: types.MediaBatchDownloadCompletedMessage): Promise<JobResponse>;
+    /**
+     * Request to download and process a batch of media files from a storage provider. Images are compressed and resized to specified dimensions, converted to WebP format. Text files and documents are processed and stored with metadata. All processed files are uploaded to MinIO S3 storage under the media/{batchId}/ prefix.
+  
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    mediaBatchDownloadRequest(data: types.MediaBatchDownloadRequestMessage): Promise<JobResponse>;
+    /**
+     * Handles metamodel metadata generation completion. Contains AI-generated metadata and aggregated technical analysis.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    metamodelMetadataGenerationCompleted(data: types.MetamodelMetadataGenerationCompletedMessage): Promise<JobResponse>;
+    /**
+     * Handles metamodel metadata generation requests via Ollama. Aggregates data from constituent models and generates AI-enhanced metadata.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    metamodelMetadataGenerationRequest(data: types.MetamodelMetadataGenerationRequestMessage): Promise<JobResponse>;
     /**
      * Handles model discovery folder processed events.
      * @param data - The message payload
@@ -86,7 +111,7 @@ export declare class WorkerClient {
      */
     modelMetadataGenerationRequest(data: types.ModelMetadataGenerationRequestMessage): Promise<JobResponse>;
     /**
-     * Handles model metamodel detection found.
+     * Handles model metamodel detection found with hierarchical relationships.
      * @param data - The message payload
      * @returns Job response with job ID
      */
@@ -97,6 +122,18 @@ export declare class WorkerClient {
      * @returns Job response with job ID
      */
     modelMetamodelDetectionRequest(data: types.ModelMetamodelDetectionRequestMessage): Promise<JobResponse>;
+    /**
+     * Reports comprehensive results of technical metadata analysis including geometry, quality metrics, and print-readiness assessment
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    modelTechnicalMetadataCompleted(data: types.ModelTechnicalMetadataCompletedMessage): Promise<JobResponse>;
+    /**
+     * Triggers comprehensive technical analysis of a 3D model file to extract geometry, quality metrics, and print-readiness information
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    modelTechnicalMetadataRequest(data: types.ModelTechnicalMetadataRequestMessage): Promise<JobResponse>;
     /**
      * Handles thumbnail generation completed.
      * @param data - The message payload

package/dist/client.js

@@ -76,6 +76,39 @@ export class WorkerClient {
     async fileDownloadRequest(data) {
         return this.sendToQueue(types.MessageTypes.FILE_DOWNLOAD_REQUEST, data);
     }
+    /**
+     * Notifies that a batch media download has been completed.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async mediaBatchDownloadCompleted(data) {
+        return this.sendToQueue(types.MessageTypes.MEDIA_BATCH_DOWNLOAD_COMPLETED, data);
+    }
+    /**
+     * Request to download and process a batch of media files from a storage provider. Images are compressed and resized to specified dimensions, converted to WebP format. Text files and documents are processed and stored with metadata. All processed files are uploaded to MinIO S3 storage under the media/{batchId}/ prefix.
+  
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async mediaBatchDownloadRequest(data) {
+        return this.sendToQueue(types.MessageTypes.MEDIA_BATCH_DOWNLOAD_REQUEST, data);
+    }
+    /**
+     * Handles metamodel metadata generation completion. Contains AI-generated metadata and aggregated technical analysis.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async metamodelMetadataGenerationCompleted(data) {
+        return this.sendToQueue(types.MessageTypes.METAMODEL_METADATA_GENERATION_COMPLETED, data);
+    }
+    /**
+     * Handles metamodel metadata generation requests via Ollama. Aggregates data from constituent models and generates AI-enhanced metadata.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async metamodelMetadataGenerationRequest(data) {
+        return this.sendToQueue(types.MessageTypes.METAMODEL_METADATA_GENERATION_REQUEST, data);
+    }
     /**
      * Handles model discovery folder processed events.
      * @param data - The message payload
@@ -125,7 +158,7 @@ export class WorkerClient {
         return this.sendToQueue(types.MessageTypes.MODEL_METADATA_GENERATION_REQUEST, data);
     }
     /**
-     * Handles model metamodel detection found.
+     * Handles model metamodel detection found with hierarchical relationships.
      * @param data - The message payload
      * @returns Job response with job ID
      */
@@ -140,6 +173,22 @@ export class WorkerClient {
     async modelMetamodelDetectionRequest(data) {
         return this.sendToQueue(types.MessageTypes.MODEL_METAMODEL_DETECTION_REQUEST, data);
     }
+    /**
+     * Reports comprehensive results of technical metadata analysis including geometry, quality metrics, and print-readiness assessment
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async modelTechnicalMetadataCompleted(data) {
+        return this.sendToQueue(types.MessageTypes.MODEL_TECHNICAL_METADATA_COMPLETED, data);
+    }
+    /**
+     * Triggers comprehensive technical analysis of a 3D model file to extract geometry, quality metrics, and print-readiness information
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async modelTechnicalMetadataRequest(data) {
+        return this.sendToQueue(types.MessageTypes.MODEL_TECHNICAL_METADATA_REQUEST, data);
+    }
     /**
      * Handles thumbnail generation completed.
      * @param data - The message payload

package/dist/types.d.ts

@@ -4,6 +4,10 @@
 export declare const MessageTypes: {
     readonly FILE_DOWNLOAD_COMPLETED: "file-download-completed";
     readonly FILE_DOWNLOAD_REQUEST: "file-download-request";
+    readonly MEDIA_BATCH_DOWNLOAD_COMPLETED: "media-batch-download-completed";
+    readonly MEDIA_BATCH_DOWNLOAD_REQUEST: "media-batch-download-request";
+    readonly METAMODEL_METADATA_GENERATION_COMPLETED: "metamodel-metadata-generation-completed";
+    readonly METAMODEL_METADATA_GENERATION_REQUEST: "metamodel-metadata-generation-request";
     readonly MODEL_DISCOVERY_FOLDER_PROCESSED_EVENT: "model-discovery-folder-processed-event";
     readonly MODEL_DISCOVERY_SCAN_FOUND_EVENT: "model-discovery-scan-found-event";
     readonly MODEL_DISCOVERY_SCAN_PROGRESS_EVENT: "model-discovery-scan-progress-event";
@@ -12,6 +16,8 @@ export declare const MessageTypes: {
     readonly MODEL_METADATA_GENERATION_REQUEST: "model-metadata-generation-request";
     readonly MODEL_METAMODEL_DETECTION_FOUND: "model-metamodel-detection-found";
     readonly MODEL_METAMODEL_DETECTION_REQUEST: "model-metamodel-detection-request";
+    readonly MODEL_TECHNICAL_METADATA_COMPLETED: "model-technical-metadata-completed";
+    readonly MODEL_TECHNICAL_METADATA_REQUEST: "model-technical-metadata-request";
     readonly THUMBNAIL_GENERATION_COMPLETED: "thumbnail-generation-completed";
     readonly THUMBNAIL_GENERATION_REQUEST: "thumbnail-generation-request";
 };
@@ -42,6 +48,71 @@ export interface FileDownloadRequestMessage {
     /** The storage location of the model. */
     storageLocation?: Record<string, string | number | boolean>;
 }
+/**
+ * Notifies that a batch media download has been completed.
+ */
+export interface MediaBatchDownloadCompletedMessage {
+    /** The unique identifier for the batch download operation. */
+    batchId: string;
+    /** The final status of the batch download operation. */
+    status: string;
+    /** List of successfully processed files. */
+    processedFiles?: Array<Record<string, string | number | boolean>>;
+    /** List of files that failed to process. */
+    failedFiles?: Array<Record<string, string | number | boolean>>;
+    /** Timestamp when the batch processing completed. */
+    processedAt: string;
+    /** Statistics about the batch processing. */
+    statistics?: Record<string, string | number | boolean>;
+}
+/**
+ * Request to download and process a batch of media files from a storage provider. Images are compressed and resized to specified dimensions, converted to WebP format. Text files and documents are processed and stored with metadata. All processed files are uploaded to MinIO S3 storage under the media/{batchId}/ prefix.
+
+ */
+export interface MediaBatchDownloadRequestMessage {
+    /** Unique identifier for this batch of media files. Used for organizing processed files in S3 storage (media/{batchId}/) and correlating with completion responses.
+   */
+    batchId?: string;
+    /** UUID of the StorageConnection entity from which to download the media files. Used to authenticate and access the source storage provider.
+   */
+    storageConnectionId?: string;
+    /** Array of media files to download and process. Must contain at least one file. Each file includes metadata for identification and processing.
+   */
+    mediaFiles?: Array<Record<string, string | number | boolean>>;
+    /** Optional compression settings that override deployment environment defaults. If not provided, uses values from MAX_IMAGE_WIDTH, MAX_IMAGE_HEIGHT, IMAGE_QUALITY, and OUTPUT_FORMAT environment variables.
+   */
+    compressionSettings?: Record<string, string | number | boolean>;
+}
+/**
+ * Handles metamodel metadata generation completion. Contains AI-generated metadata and aggregated technical analysis.
+ */
+export interface MetamodelMetadataGenerationCompletedMessage {
+    /** The unique identifier for the metamodel */
+    metamodelId: string;
+    /** AI-generated metadata for the metamodel */
+    metadata: Record<string, string | number | boolean>;
+    /** Aggregated technical analysis from constituent models */
+    technicalMetadata: Record<string, string | number | boolean>;
+}
+/**
+ * Handles metamodel metadata generation requests via Ollama. Aggregates data from constituent models and generates AI-enhanced metadata.
+ */
+export interface MetamodelMetadataGenerationRequestMessage {
+    /** The unique identifier for the metamodel */
+    metamodelId?: string;
+    /** Array of model IDs that compose this metamodel */
+    constituentModelIds?: Array<Record<string, string | number | boolean>>;
+    /** The name of the metamodel */
+    name?: string;
+    /** The owner's user ID */
+    ownerId?: string;
+    /** The library containing this metamodel */
+    libraryId?: string;
+    /** Enriched metadata for constituent models (includes storage items) */
+    constituentModels?: Array<Record<string, string | number | boolean>>;
+    /** Optional webhook URL for async completion notification */
+    webhookUrl?: string;
+}
 /**
  * Handles model discovery folder processed events.
  */
@@ -135,11 +206,11 @@ export interface ModelMetadataGenerationRequestMessage {
     metamodel?: Record<string, string | number | boolean>;
 }
 /**
- * Handles model metamodel detection found.
+ * Handles model metamodel detection found with hierarchical relationships.
  */
 export interface ModelMetamodelDetectionFoundMessage {
-    /** List of metamodel suggestions. */
-    suggestions: Array<Record<string, string | number | boolean>>;
+    /** List of metamodel nodes in hierarchical structure (roots and children). */
+    metamodels: Array<Record<string, string | number | boolean>>;
 }
 /**
  * Handles model metamodel detection requests.
@@ -158,6 +229,100 @@ export interface ModelMetamodelDetectionRequestMessage {
     /** Statistics about the processed folder. */
     statistics: Record<string, string | number | boolean>;
 }
+/**
+ * Reports comprehensive results of technical metadata analysis including geometry, quality metrics, and print-readiness assessment
+ */
+export interface ModelTechnicalMetadataCompletedMessage {
+    /** ID of the original analysis request job */
+    originalJobId?: string;
+    /** ID of the analyzed model */
+    modelId?: string;
+    /** Analysis completion status */
+    status?: string;
+    /** Number of vertices in the mesh */
+    vertices?: string | number | boolean;
+    /** Number of faces/polygons in the mesh */
+    faces?: string | number | boolean;
+    /** Number of edges in the mesh */
+    edges?: string | number | boolean;
+    /** Visual detail level based on polygon density */
+    detailLevel?: string;
+    /** 3D bounding box dimensions in millimeters */
+    boundingBox?: Record<string, string | number | boolean>;
+    /** Model volume in cubic millimeters (for material calculation) */
+    volumeCubicMm?: number;
+    /** Total surface area in square millimeters */
+    surfaceAreaSqMm?: number;
+    /** Minimum wall thickness detected in millimeters (critical for printability) */
+    minWallThickness?: number;
+    /** Maximum wall thickness detected in millimeters */
+    maxWallThickness?: number;
+    /** Is the mesh watertight/manifold? Critical for 3D printing (true = printable) */
+    manifold?: boolean;
+    /** Number of non-manifold edges (repair needed if > 0) */
+    nonManifoldEdges?: string | number | boolean;
+    /** Number of holes/boundary loops in the mesh (0 = closed mesh) */
+    holes?: string | number | boolean;
+    /** Number of faces with inverted normals (causes rendering/slicing issues) */
+    flippedNormals?: string | number | boolean;
+    /** Number of self-intersecting faces (0 = clean geometry) */
+    selfIntersections?: string | number | boolean;
+    /** Overall quality score 0-100 (100 = perfect for printing, <60 needs repair) */
+    qualityScore?: number;
+    /** Printability score 0-100 (considers supports, orientation, size constraints) */
+    printabilityScore?: number;
+    /** Does this model require support structures for 3D printing? */
+    requiresSupports?: boolean;
+    /** Detected overhang areas requiring support structures */
+    overhangs?: Array<Record<string, string | number | boolean>>;
+    /** Estimated print time in minutes using normal quality settings (0.2mm layers, 20% infill) */
+    estimatedPrintTimeMinutes?: string | number | boolean;
+    /** Print time estimates for different quality presets */
+    printTimeEstimates?: Record<string, string | number | boolean>;
+    /** Estimated material usage in grams using 20% infill (assumes PLA density 1.24g/cm³) */
+    estimatedMaterialGrams?: number;
+    /** Material usage estimates for different infill percentages */
+    materialEstimates?: Record<string, string | number | boolean>;
+    /** Recommended print orientation for minimal support material and best results */
+    recommendedOrientation?: Record<string, string | number | boolean>;
+    /** Original file format unit detected from metadata or inferred from scale */
+    originalUnit?: string;
+    /** File format version (e.g., 'STL Binary', 'OBJ v4', 'PLY 1.0') */
+    formatVersion?: string;
+    /** Does the file contain per-vertex color information? */
+    hasColorData?: boolean;
+    /** Does the file contain UV texture mapping coordinates? */
+    hasTextureCoordinates?: boolean;
+    /** Does the file contain per-vertex normal vectors? */
+    hasVertexNormals?: boolean;
+    /** Tool/service that performed the analysis */
+    analyzedBy?: string;
+    /** Version of the analysis algorithm (for tracking improvements) */
+    analysisVersion?: string;
+    /** Confidence level of analysis results (0.0 = uncertain, 1.0 = highly confident) */
+    analysisConfidence?: number;
+    /** Warnings or issues detected during analysis (structured for programmatic handling) */
+    analysisWarnings?: Array<Record<string, string | number | boolean>>;
+    /** ISO 8601 timestamp when analysis was performed (e.g., '2025-11-19T14:35:22Z') */
+    analyzedAt?: string;
+    /** Detailed error message if status is FAILED */
+    errorMessage?: string;
+    /** Machine-readable error code for programmatic error handling */
+    errorCode?: string;
+}
+/**
+ * Triggers comprehensive technical analysis of a 3D model file to extract geometry, quality metrics, and print-readiness information
+ */
+export interface ModelTechnicalMetadataRequestMessage {
+    /** Unique identifier for the model to analyze */
+    modelId?: string;
+    /** User ID who owns the model */
+    ownerId?: string;
+    /** Location of the 3D model file */
+    storageLocation?: Record<string, string | number | boolean>;
+    /** Optional analysis configuration parameters */
+    analysisOptions?: Record<string, string | number | boolean>;
+}
 /**
  * Handles thumbnail generation completed.
  */

package/dist/types.js

@@ -5,6 +5,10 @@
 export const MessageTypes = {
     FILE_DOWNLOAD_COMPLETED: 'file-download-completed',
     FILE_DOWNLOAD_REQUEST: 'file-download-request',
+    MEDIA_BATCH_DOWNLOAD_COMPLETED: 'media-batch-download-completed',
+    MEDIA_BATCH_DOWNLOAD_REQUEST: 'media-batch-download-request',
+    METAMODEL_METADATA_GENERATION_COMPLETED: 'metamodel-metadata-generation-completed',
+    METAMODEL_METADATA_GENERATION_REQUEST: 'metamodel-metadata-generation-request',
     MODEL_DISCOVERY_FOLDER_PROCESSED_EVENT: 'model-discovery-folder-processed-event',
     MODEL_DISCOVERY_SCAN_FOUND_EVENT: 'model-discovery-scan-found-event',
     MODEL_DISCOVERY_SCAN_PROGRESS_EVENT: 'model-discovery-scan-progress-event',
@@ -13,6 +17,8 @@ export const MessageTypes = {
     MODEL_METADATA_GENERATION_REQUEST: 'model-metadata-generation-request',
     MODEL_METAMODEL_DETECTION_FOUND: 'model-metamodel-detection-found',
     MODEL_METAMODEL_DETECTION_REQUEST: 'model-metamodel-detection-request',
+    MODEL_TECHNICAL_METADATA_COMPLETED: 'model-technical-metadata-completed',
+    MODEL_TECHNICAL_METADATA_REQUEST: 'model-technical-metadata-request',
     THUMBNAIL_GENERATION_COMPLETED: 'thumbnail-generation-completed',
     THUMBNAIL_GENERATION_REQUEST: 'thumbnail-generation-request',
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mesh-sync/worker-backend-client",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Auto-generated TypeScript client for worker-backend - provides type-safe methods for enqueueing jobs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",