@mesh-sync/worker-backend-client 4.0.19 → 4.0.24-pr.51.20260312132340

package/README.md

@@ -100,6 +100,26 @@ await client.sendToQueue(MessageTypes.FILE_DOWNLOAD_REQUEST, {
 ## Available Message Types
 
 
+### analytics-collection-request
+
+**Description:** Request to trigger a manual market data collection job.
+Used for ad-hoc scraping of specific queries on marketplaces.
+
+
+**Method:** `client.analyticsCollectionRequest(data)`
+
+**Payload Type:** `AnalyticsCollectionRequestMessage`
+
+**Fields:**
+
+- `marketplace` (string) [✗]: The marketplace to scrape (etsy, ebay, etc.)
+
+- `query` (string) [✓]: The search query to use
+
+- `options` (object) [✗]: Collection options (pages, filters, etc.)
+
+
+
 ### backend-logging-event
 
 **Description:** Centralized logging event for capturing all warn/error/failure logs from meshsync-backend.
@@ -163,52 +183,6 @@ Used for:
 
 
 
-### ekg-edge-batch-create-completed
-
-**Description:** Completion event for EKG edge batch creation with propagation results.
-
-**Method:** `client.ekgEdgeBatchCreateCompleted(data)`
-
-**Payload Type:** `EkgEdgeBatchCreateCompletedMessage`
-
-**Fields:**
-
-- `requestId` (string) [✓]: Original request ID from ekg-edge-batch-create-request
-
-- `success` (boolean) [✓]: Whether the batch operation succeeded
-
-- `statistics` (object) [✓]: Batch operation statistics
-
-- `conflicts` (array) [✗]: List of high-conflict edges requiring review
-
-- `errors` (array) [✗]: Errors encountered during processing
-
-- `graphMetrics` (object) [✗]: Overall graph state after this batch
-
-
-
-### ekg-edge-batch-create-request
-
-**Description:** Create multiple EKG edges with Dempster-Shafer mass functions. Triggered by metamodel detection completion.
-
-**Method:** `client.ekgEdgeBatchCreateRequest(data)`
-
-**Payload Type:** `EkgEdgeBatchCreateRequestMessage`
-
-**Fields:**
-
-- `requestId` (string) [✓]: Unique request ID for tracking (e.g., metamodel detection job ID)
-
-- `source` (string) [✓]: Source of the edges: metamodel-heuristic, manual, taxonomy-import, etc.
-
-- `edges` (array) [✓]: Batch of edges to create/update in the EKG
-
-- `propagationOptions` (object) [✗]: Options for evidential edge propagation after edge creation
-
-- `webhookUrl` (string) [✗]: Optional webhook URL for async completion notification
-
-
-
 ### etsy-analytics-sync-completed
 
 **Description:** Contains synced analytics data for Etsy listings. Backend stores this in etsy_analytics_snapshots table and indexes to ELK.
@@ -444,63 +418,81 @@ Retry Configuration:
 
 
 
-### marketplace-analytics-sync-completed
+### ip-check-completed
 
-**Description:** Contains synced analytics data for marketplace listings. Backend stores this in marketplace_analytics_snapshots table and indexes to ELK. Works with any marketplace provider.
+**Description:** Contains IP verification results including trademark risk, copyright risk, detected brands/franchises, and analysis confidence scores
 
-**Method:** `client.marketplaceAnalyticsSyncCompleted(data)`
+**Method:** `client.ipCheckCompleted(data)`
 
-**Payload Type:** `MarketplaceAnalyticsSyncCompletedMessage`
+**Payload Type:** `IpCheckCompletedMessage`
 
 **Fields:**
 
-- `originalJobId` (string) [✗]: BullMQ job ID from original request
+- `modelId` (string) [✗]: Model UUID that was analyzed
+
+- `ownerId` (string) [✗]: Owner user ID
 
-- `marketplaceProvider` (string) [✗]: Marketplace provider type (etsy, ebay, etc.)
+- `entityType` (string) [✗]: Type of entity checked: 'model' or 'metamodel'
 
-- `status` (string) [✗]: Sync result (SUCCESS, PARTIAL_SUCCESS, or FAILED)
+- `status` (string) [✗]: Overall IP check outcome: 'clear', 'flagged', or 'error'
 
-- `syncedCount` (integer) [✗]: Number of listings successfully synced
+- `trademarkRisk` (string) [✗]: Detected trademark infringement risk level: 'none', 'low', 'medium', 'high'
 
-- `errorCount` (integer) [✗]: Number of listings that failed
+- `copyrightRisk` (string) [✗]: Detected copyright infringement risk level: 'none', 'low', 'medium', 'high'
 
-- `results` (array) [✗]: Analytics for each synced listing
+- `matchedBrands` (array) [✗]: Brand names detected in model name or content
 
-- `errors` (array) [✗]: Errors for failed listings
+- `matchedFranchises` (array) [✗]: Franchise/character names detected
+
+- `similarModelsCount` (integer) [✗]: Number of visually similar models found
+
+- `confidence` (number) [✗]: Overall confidence score for the analysis (0.0-1.0)
+
+- `riskScorePercent` (integer) [✗]: Risk score as 0-100 integer (FR-024: >70 HIGH, 40-70 MEDIUM, <40 LOW)
+
+- `riskLevel` (string) [✗]: Overall risk level: 'none', 'low', 'medium', 'high'
+
+- `recommendation` (string) [✗]: Recommended action: 'block' (HIGH risk), 'warn' (MEDIUM risk), 'allow' (LOW/NONE risk)
+
+- `suggestedChanges` (object) [✗]: Suggested modifications to reduce IP risk
 
-- `syncedAt` (string) [✗]: When sync completed (ISO 8601)
+- `heuristicResults` (object) [✗]: Detailed results from each heuristic check
 
-- `nextScheduledSync` (string) [✗]: When next automatic sync should occur (ISO 8601)
+- `error` (object) [✗]: Error details if status is 'error'
 
+- `processingDurationMs` (integer) [✗]: Total processing time in milliseconds
 
 
-### marketplace-analytics-sync-request
 
-**Description:** Syncs analytics data from marketplace API for one or more listings. Fetches views, favorites, sales, revenue, and traffic source data. Can sync: specific listings, all user listings, or shop-level analytics. Works with any marketplace provider that supports analytics (etsy, ebay, etc.).
+### ip-check-request
 
-**Method:** `client.marketplaceAnalyticsSyncRequest(data)`
+**Description:** Triggers intellectual property verification analysis for a model thumbnail, detecting potential trademark and copyright issues using perceptual hashing, text analysis, and optional reverse image search.
 
-**Payload Type:** `MarketplaceAnalyticsSyncRequestMessage`
+**Method:** `client.ipCheckRequest(data)`
+
+**Payload Type:** `IpCheckRequestMessage`
 
 **Fields:**
 
-- `marketplaceProvider` (string) [✗]: Marketplace provider type (etsy, ebay, etc.)
+- `modelId` (string) [✗]: Unique identifier for the model to analyze
 
-- `marketplaceConnectionId` (string) [✗]: UUID of the marketplace connection configuration
+- `ownerId` (string) [✗]: User ID who owns the model
 
-- `listingIds` (array) [✗]: Internal listing UUIDs to sync. Empty array = sync all for user.
+- `entityType` (string) [✗]: Type of entity being checked: 'model' or 'metamodel'
 
-- `userId` (string) [✗]: UUID of user whose listings to sync (if listingIds empty)
+- `modelName` (string) [✗]: Name of the model for trademark/franchise text detection
 
-- `externalShopId` (string) [✗]: External marketplace shop ID for shop-level analytics
+- `tags` (array) [✗]: Model tags for IP reference detection
 
-- `timeRange` (object) [✗]: Date range for historical analytics
+- `description` (string) [✗]: Model description for text-based IP analysis
 
-- `syncOptions` (object) [✗]: Optional sync configuration
+- `thumbnailUrl` (string) [✗]: URL to fetch the thumbnail image for visual analysis
 
-- `marketplaceCredentials` (object) [✗]: Encrypted marketplace credentials (retrieved from marketplaceConnectionId)
+- `minioPath` (string) [✗]: Path to thumbnail in MinIO if stored internally
 
-- `webhookUrl` (string) [✗]: Callback URL for completion notification
+- `additionalImageUrls` (array) [✗]: Optional additional images for more comprehensive analysis (e.g., 360° views)
+
+- `analysisOptions` (object) [✗]: Optional analysis configuration
 
 
 
@@ -647,6 +639,41 @@ This is typically triggered after initial connection or periodically to keep mar
 
 
 
+### marketplace-intelligence-completed
+
+**Description:** Response from marketplace intelligence scraping.
+Contains aggregated similarity data from marketplace searches.
+
+Consumed by worker-backend to update pipeline context before
+sellability analysis runs.
+
+
+**Method:** `client.marketplaceIntelligenceCompleted(data)`
+
+**Payload Type:** `MarketplaceIntelligenceCompletedMessage`
+
+**Fields:**
+
+- `modelId` (string) [✓]: UUID of the model that was researched
+
+- `ownerId` (string) [✓]: UUID of the model owner
+
+- `status` (string) [✓]: Result status
+
+- `marketData` (object) [✗]: Aggregated market intelligence across all scraped marketplaces
+
+- `marketplaceBreakdown` (array) [✗]: Results per marketplace
+
+- `similarityScore` (number) [✗]: How saturated the market is for this model type (0=unique, 100=very common)
+
+- `error` (object) [✗]: Error information if status is FAILED
+
+- `analyzedAt` (string) [✗]: When the analysis completed
+
+- `analysisVersion` (string) [✗]: Version of the intelligence collector
+
+
+
 ### marketplace-intelligence-event
 
 **Description:** Public marketplace intelligence data scraped from external marketplaces.
@@ -692,6 +719,43 @@ Used for market research, pricing optimization, and trend detection.
 
 
 
+### marketplace-intelligence-request
+
+**Description:** Triggers automated marketplace scraping to find similar/competing listings
+for a given model. This is a pipeline stage that runs after metadata generation
+to inform sellability analysis with real market data.
+
+The worker-analytic-collector (or marketplace-connectors worker) will:
+1. Use model metadata (title, tags, category) to build search queries
+2. Scrape connected marketplaces (Etsy, eBay, etc.) for similar listings
+3. Emit marketplace-intelligence-event results for Elasticsearch indexing
+4. Return aggregated similarity data to the pipeline context
+
+Pipeline integration:
+- Triggered after: metadata-generation (needs model title/tags/category)
+- Results feed into: sellability-analysis (market positioning data)
+
+
+**Method:** `client.marketplaceIntelligenceRequest(data)`
+
+**Payload Type:** `MarketplaceIntelligenceRequestMessage`
+
+**Fields:**
+
+- `modelId` (string) [✓]: UUID of the model to research
+
+- `ownerId` (string) [✓]: UUID of the model owner
+
+- `searchContext` (object) [✗]: Model metadata used to build marketplace search queries
+
+- `scrapingOptions` (object) [✗]: Configuration for the marketplace scraping
+
+- `pipelineId` (string) [✗]: Pipeline execution ID for correlation
+
+- `executionId` (string) [✗]: Pipeline execution UUID for correlation
+
+
+
 ### marketplace-listing-description-generation-completed
 
 **Description:** Notifies backend that marketplace description generation completed. Contains generated description with metadata tracking (AI model, confidence, generation timestamp) and suggested price.
@@ -997,76 +1061,6 @@ Includes bidirectional sync: - Pull: Fetch listings from marketplace to update l
 
 
 
-### marketplace-publish-listing-completed
-
-**Description:** Indicates completion of marketplace listing publication. Contains external listing ID and URL, or error details if failed. Works with any marketplace provider (etsy, ebay, etc.).
-
-**Method:** `client.marketplacePublishListingCompleted(data)`
-
-**Payload Type:** `MarketplacePublishListingCompletedMessage`
-
-**Fields:**
-
-- `originalJobId` (string) [✗]: BullMQ job ID from original request
-
-- `listingId` (string) [✗]: Internal marketplace_items UUID
-
-- `metamodelId` (string) [✗]: UUID of the metamodel that was published
-
-- `marketplaceProvider` (string) [✗]: Marketplace provider type (etsy, ebay, etc.)
-
-- `materialName` (string) [✗]: Material variant name
-
-- `status` (string) [✗]: Publication result (SUCCESS or FAILED)
-
-- `externalListingId` (string) [✗]: External marketplace listing ID (only if status=SUCCESS)
-
-- `externalListingUrl` (string) [✗]: URL to view listing on marketplace (only if status=SUCCESS)
-
-- `externalFileId` (string) [✗]: External marketplace file ID (only if status=SUCCESS)
-
-- `error` (object) [✗]: Error details (only if status=FAILED)
-
-- `publishedAt` (string) [✗]: When the listing was created (ISO 8601, only if status=SUCCESS)
-
-- `processingDuration` (integer) [✗]: Processing time in milliseconds
-
-
-
-### marketplace-publish-listing-request
-
-**Description:** Publishes a single metamodel listing to a marketplace for a specific material variant. Creates listing, uploads digital file, and returns external listing ID. This message is enqueued for EACH material variant when publishing a metamodel. The marketplace type (etsy, ebay, etc.) is determined by the marketplaceProvider field.
-
-**Method:** `client.marketplacePublishListingRequest(data)`
-
-**Payload Type:** `MarketplacePublishListingRequestMessage`
-
-**Fields:**
-
-- `listingId` (string) [✗]: Internal marketplace_items table UUID
-
-- `metamodelId` (string) [✗]: UUID of the metamodel being published
-
-- `ownerId` (string) [✗]: UUID of the user who owns the metamodel
-
-- `marketplaceProvider` (string) [✗]: Marketplace provider type (etsy, ebay, leboncoin, etc.)
-
-- `marketplaceConnectionId` (string) [✗]: UUID of the marketplace connection configuration
-
-- `materialVariant` (object) [✗]: Material-specific listing configuration
-
-- `baseListingData` (object) [✗]: Common listing information shared across variants
-
-- `publishOptions` (object) [✗]: Publishing configuration (marketplace-specific options)
-
-- `marketplaceCredentials` (object) [✗]: Encrypted marketplace credentials (retrieved from marketplaceConnectionId)
-
-- `fileMetadata` (object) [✗]: Digital file to upload
-
-- `webhookUrl` (string) [✗]: Callback URL for completion notification
-
-
-
 ### media-batch-download-completed
 
 **Description:** Notifies that a batch media download has been completed.
@@ -1303,7 +1297,7 @@ and stores aggregated statistics in Elasticsearch for trend analysis.
 
 ### model-finder-index-request
 
-**Description:** Request to index a 3D model for similarity search.
+**Description:** DEPRECATED (2026-02-18) — FR-023 retired. Merge 3D rendering into worker-file-vectorize.
 
 **Method:** `client.modelFinderIndexRequest(data)`
 
@@ -1319,7 +1313,7 @@ and stores aggregated statistics in Elasticsearch for trend analysis.
 
 ### model-finder-response
 
-**Description:** Response containing search results from the model finder.
+**Description:** DEPRECATED (2026-02-18) — FR-023 retired. Merge 3D rendering into worker-file-vectorize.
 
 **Method:** `client.modelFinderResponse(data)`
 
@@ -1335,7 +1329,7 @@ and stores aggregated statistics in Elasticsearch for trend analysis.
 
 ### model-finder-search-request
 
-**Description:** Request to search for similar 3D models.
+**Description:** DEPRECATED (2026-02-18) — FR-023 retired. Merge 3D rendering into worker-file-vectorize.
 
 **Method:** `client.modelFinderSearchRequest(data)`
 
@@ -1429,6 +1423,76 @@ and stores aggregated statistics in Elasticsearch for trend analysis.
 
 
 
+### model-print-analysis-completed
+
+**Description:** Reports completion of 3D print analysis — contains estimation, printability, and cost breakdown per FR-022
+
+**Method:** `client.modelPrintAnalysisCompleted(data)`
+
+**Payload Type:** `ModelPrintAnalysisCompletedMessage`
+
+**Fields:**
+
+- `originalJobId` (string) [✗]: ID of the original analysis request job
+
+- `modelId` (string) [✗]: UUID of the analysed model
+
+- `status` (string) [✗]: Analysis result status
+
+- `errorMessage` (string) [✗]: Error description when status is FAILED
+
+- `material` (string) [✗]: Material type used for estimation
+
+- `quality` (string) [✗]: Quality preset used
+
+- `printTimeMinutes` (number) [✗]: Estimated total print time in minutes
+
+- `materialGrams` (number) [✗]: Estimated material consumption in grams (body only)
+
+- `needsSupport` (boolean) [✗]: Whether the model requires support structures
+
+- `supportMaterialGrams` (number) [✗]: Estimated support material in grams
+
+- `overhangPercentage` (number) [✗]: Percentage of surface area with overhangs > 45°
+
+- `minWallThicknessMm` (number) [✗]: Thinnest detected wall in millimeters
+
+- `solidVolumeCm3` (number) [✗]: Solid volume of the mesh in cm³
+
+- `surfaceAreaCm2` (number) [✗]: Total surface area in cm²
+
+- `boundingBox` (object) [✗]: Bounding box in millimeters
+
+- `estimatedCostEUR` (number) [✗]: Total estimated production cost in EUR
+
+- `costBreakdown` (object) [✗]: Granular cost breakdown per WF-009 MaterialCostCalculatorService
+
+
+
+### model-print-analysis-request
+
+**Description:** Triggers 3D print analysis for a model — estimates print time, material usage, support needs, and cost breakdown per FR-022
+
+**Method:** `client.modelPrintAnalysisRequest(data)`
+
+**Payload Type:** `ModelPrintAnalysisRequestMessage`
+
+**Fields:**
+
+- `modelId` (string) [✗]: UUID of the model to analyse
+
+- `ownerId` (string) [✗]: UUID of the user who owns the model
+
+- `material` (string) [✗]: Material type enum value (e.g. PLA, PETG, RESIN_STANDARD)
+
+- `quality` (string) [✗]: Print quality preset
+
+- `webhookUrl` (string) [✗]: URL called when analysis completes or fails
+
+- `minioPath` (string) [✗]: Path to model in MinIO storage for geometry analysis (e.g. 'raw_models/{modelId}/original.glb')
+
+
+
 ### model-sellability-analysis-completed
 
 **Description:** Contains sellability analysis results including Etsy-specific recommendations, material pricing, and marketplace compatibility scores
@@ -1609,6 +1673,8 @@ and stores aggregated statistics in Elasticsearch for trend analysis.
 
 - `recommendedOrientation` (object) [✗]: Recommended print orientation for minimal support material and best results
 
+- `slicerRecommendations` (object) [✗]: Slicer-derived recommended print settings based on model analysis (feeds into print job creation as defaults)
+
 - `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')
@@ -1659,6 +1725,226 @@ and stores aggregated statistics in Elasticsearch for trend analysis.
 
 
 
+### slicing-fdm-request
+
+**Description:** Request FDM slicing simulation via OrcaSlicer (preferred) or heuristic fallback. Accepts OrcaSlicer-compatible printer/process/filament JSON profiles.
+
+**Method:** `client.slicingFdmRequest(data)`
+
+**Payload Type:** `SlicingFdmRequestMessage`
+
+**Fields:**
+
+- `modelId` (string) [✗]: UUID of the model
+
+- `storageItemId` (string) [✗]: UUID or path of the storage item to download the STL/3MF
+
+- `profileId` (string) [✗]: UUID of the user's slicer profile from the database
+
+- `profileName` (string) [✗]: Human-readable profile name (e.g. 'My Bambu X1C - PLA Fine')
+
+- `printerProfile` (object) [✗]: OrcaSlicer printer profile JSON: nozzle_diameter, bed_shape, max speeds, acceleration, retraction
+
+- `processProfile` (object) [✗]: OrcaSlicer process profile JSON: layer_height, sparse_infill_density, wall_loops, speeds, support settings
+
+- `filamentProfile` (object) [✗]: OrcaSlicer filament profile JSON: filament_type, filament_density, temperature, flow_ratio, retraction
+
+- `layerHeight` (number) [✗]: Override: layer height in mm (takes precedence over processProfile)
+
+- `infillPercentage` (number) [✗]: Override: infill percentage (0-100)
+
+- `nozzleDiameter` (number) [✗]: Override: nozzle diameter in mm
+
+- `printSpeed` (number) [✗]: Override: outer wall print speed in mm/s
+
+- `wallCount` (integer) [✗]: Override: number of wall loops / perimeters
+
+- `supportEnabled` (boolean) [✗]: Override: generate support structures
+
+- `materialDensity` (number) [✗]: Override: filament density in g/cm³ (default: 1.24 PLA)
+
+- `webhookUrl` (string) [✗]: URL to POST the slicing result back to
+
+
+
+### slicing-fdm-result
+
+**Description:** Result of FDM slicing simulation from OrcaSlicer (toolpath) or heuristic fallback. Contains exact physical metrics for cost calculation.
+
+**Method:** `client.slicingFdmResult(data)`
+
+**Payload Type:** `SlicingFdmResultMessage`
+
+**Fields:**
+
+- `modelId` (string) [✗]: UUID of the model
+
+- `status` (string) [✗]: Status of the simulation
+
+- `printTimeHours` (number) [✗]: Exact print time in hours (from toolpath analysis)
+
+- `materialWeightGrams` (number) [✗]: Total filament weight in grams (including supports)
+
+- `materialVolumeCm3` (number) [✗]: Extruded material volume in cm³
+
+- `maxZHeightMM` (number) [✗]: Maximum Z height in mm
+
+- `supportMaterialWeightGrams` (number) [✗]: Support structure filament weight in grams
+
+- `layerCount` (integer) [✗]: Total number of layers
+
+- `totalExtrusionLengthMm` (number) [✗]: Total filament extrusion length in mm
+
+- `slicingMethod` (string) [✗]: Engine that produced the result
+
+- `slicerVersion` (string) [✗]: Version of the slicer engine used
+
+- `profileUsed` (string) [✗]: Name or ID of the slicer profile used
+
+- `errorCode` (string) [✗]: Error code if simulation failed
+
+- `errorMessage` (string) [✗]: Error message if simulation failed
+
+
+
+### slicing-sla-request
+
+**Description:** Request SLA/MSLA slicing simulation via PySLM cross-sectional analysis. Accepts resin printer profile with exposure, lift, and layer parameters.
+
+**Method:** `client.slicingSlaRequest(data)`
+
+**Payload Type:** `SlicingSlaRequestMessage`
+
+**Fields:**
+
+- `modelId` (string) [✗]: UUID of the model
+
+- `storageItemId` (string) [✗]: UUID or path of the storage item to download the STL/3MF
+
+- `technology` (string) [✗]: SLA or MSLA
+
+- `profileId` (string) [✗]: UUID of the user's slicer profile from the database
+
+- `profileName` (string) [✗]: Human-readable profile name (e.g. 'Elegoo Mars 3 - Standard Grey')
+
+- `layerHeight` (number) [✗]: Layer height in mm (default: 0.05)
+
+- `exposureTime` (number) [✗]: Normal layer UV exposure time in seconds (default: 2.5)
+
+- `bottomExposureTime` (number) [✗]: Bottom/burn-in layer exposure time in seconds (default: 30)
+
+- `bottomLayers` (integer) [✗]: Number of bottom/burn-in layers (default: 5)
+
+- `liftHeight` (number) [✗]: Platform lift height in mm between layers (default: 5.0)
+
+- `liftSpeed` (number) [✗]: Platform lift speed in mm/min (default: 60)
+
+- `retractSpeed` (number) [✗]: Platform retract speed in mm/min (default: 150)
+
+- `resinDensity` (number) [✗]: Resin density in g/cm³ (default: 1.1)
+
+- `supportEnabled` (boolean) [✗]: Generate support structures (default: true for SLA)
+
+- `webhookUrl` (string) [✗]: URL to POST the slicing result back to
+
+
+
+### slicing-sla-result
+
+**Description:** Result of SLA/MSLA slicing simulation from PySLM cross-sectional analysis. Contains exact resin usage and print time metrics.
+
+**Method:** `client.slicingSlaResult(data)`
+
+**Payload Type:** `SlicingSlaResultMessage`
+
+**Fields:**
+
+- `modelId` (string) [✗]: UUID of the model
+
+- `status` (string) [✗]: Status of the simulation
+
+- `printTimeHours` (number) [✗]: Exact print time in hours (from cross-sectional analysis)
+
+- `materialWeightGrams` (number) [✗]: Total resin weight in grams (including supports)
+
+- `materialVolumeCm3` (number) [✗]: Cured resin volume in cm³ (from cross-sectional area integration)
+
+- `maxZHeightMM` (number) [✗]: Maximum Z height in mm
+
+- `supportMaterialWeightGrams` (number) [✗]: Support structure resin weight in grams
+
+- `layerCount` (integer) [✗]: Total number of layers
+
+- `maxCrossSectionAreaMm2` (number) [✗]: Maximum cross-sectional area in mm² (affects MSLA peel force)
+
+- `slicingMethod` (string) [✗]: Engine that produced the result
+
+- `slicerVersion` (string) [✗]: Version of PySLM / trimesh used
+
+- `profileUsed` (string) [✗]: Name or ID of the slicer profile used
+
+- `errorCode` (string) [✗]: Error code if simulation failed
+
+- `errorMessage` (string) [✗]: Error message if simulation failed
+
+
+
+### texture-generation-completed
+
+**Description:** Emitted when AI texture generation completes (success or failure). Contains artifact S3 URLs on success, or error details on failure. The credit reservation should be confirmed (success) or released (failure) based on the status.
+
+**Method:** `client.textureGenerationCompleted(data)`
+
+**Payload Type:** `TextureGenerationCompletedMessage`
+
+**Fields:**
+
+- `jobId` (string) [✗]: The unique job identifier matching the original request.
+
+- `modelId` (string) [✗]: The ID of the model that was textured.
+
+- `tenantId` (string) [✗]: The tenant who owns the model.
+
+- `status` (string) [✗]: The result status of the texture generation.
+
+- `artifacts` (object) [✗]: S3 URLs of generated texture artifacts. Present only when status is 'completed'.
+
+- `error` (object) [✗]: Error details. Present only when status is 'failed'.
+
+- `metrics` (object) [✗]: Pipeline performance metrics.
+
+- `creditReservationId` (string) [✗]: Credit reservation ID to confirm (on success) or release (on failure).
+
+
+
+### texture-generation-request
+
+**Description:** Request AI-powered texture generation for a 3D model. Requires a mesh file URL and a text prompt describing the desired texture. Credits are reserved before dispatch.
+
+**Method:** `client.textureGenerationRequest(data)`
+
+**Payload Type:** `TextureGenerationRequestMessage`
+
+**Fields:**
+
+- `jobId` (string) [✗]: Unique job identifier for tracking.
+
+- `modelId` (string) [✗]: The unique identifier for the model to texture.
+
+- `tenantId` (string) [✗]: The identifier of the tenant requesting the generation.
+
+- `meshUrl` (string) [✗]: S3 URL to the source mesh file (GLB, OBJ, or STL).
+
+- `prompt` (string) [✗]: Text description of the desired texture (1-500 characters). Example: 'weathered bronze with green patina'.
+
+- `stylePreset` (string) [✗]: Style preset to guide the texture generation aesthetic.
+
+- `resolution` (integer) [✗]: Output texture resolution (width = height in pixels).
+
+- `creditReservationId` (string) [✗]: Credit reservation ID from the credit ledger. Must be confirmed on completion or released on failure.
+
+
+
 ### thumbnail-generation-completed
 
 **Description:** Handles thumbnail generation completed.
@@ -1681,6 +1967,8 @@ and stores aggregated statistics in Elasticsearch for trend analysis.
 
 - `gltfPreviewPath` (string) [✗]: The path to the generated GLTF/GLB 3D preview file.
 
+- `animatedPreviewPath` (string) [✗]: The path to the generated animated MP4 preview file.
+
 - `errorMessage` (string) [✗]: An error message if the thumbnail generation failed.
 
 - `storageLocation` (object) [✗]: The storage location of the model.
@@ -1741,6 +2029,8 @@ Used for:
 
 **Fields:**
 
+- `eventVersion` (string) [✓]: Schema version for forward-compatible evolution
+
 - `eventType` (string) [✓]: Category of user engagement event
 
 - `action` (string) [✓]: Specific user action performed
@@ -1749,7 +2039,7 @@ Used for:
 
 - `userId` (string) [✓]: Unique identifier of the user
 
-- `userEmail` (string) [✗]: User's email (hashed for privacy in analytics)
+- `userEmail` (string) [✗]: User's email — MUST be SHA-256 hashed at the producer side before publishing (GDPR/CNIL compliance). Never send raw email.
 
 - `userCreatedAt` (string) [✗]: When the user account was created (for cohort analysis)
 
@@ -1757,7 +2047,9 @@ Used for:
 
 - `sessionId` (string) [✗]: User session identifier for grouping actions
 
-- `requestId` (string) [✗]: Request ID for correlation with logs
+- `requestId` (string) [✗]: Request ID for correlation with backend logs
+
+- `correlationId` (string) [✗]: Correlation ID to link engagement events across frontend and backend boundaries, and to pipeline traces
 
 - `actionDetails` (object) [✗]: Additional context about the action
 
@@ -1926,6 +2218,11 @@ new WorkerClient(config: WorkerClientConfig)
   - Get the current status of a job
 
 
+- `analyticsCollectionRequest(data: AnalyticsCollectionRequestMessage): Promise<JobResponse>`
+  - Request to trigger a manual market data collection job.
+Used for ad-hoc scraping of specific queries on marketplaces.
+
+
 - `backendLoggingEvent(data: BackendLoggingEventMessage): Promise<JobResponse>`
   - Centralized logging event for capturing all warn/error/failure logs from meshsync-backend.
 This event is sent to ELK for centralized monitoring, alerting, and debugging.
@@ -1944,12 +2241,6 @@ Used for:
 - Compliance and audit trails
 
 
-- `ekgEdgeBatchCreateCompleted(data: EkgEdgeBatchCreateCompletedMessage): Promise<JobResponse>`
-  - Completion event for EKG edge batch creation with propagation results.
-
-- `ekgEdgeBatchCreateRequest(data: EkgEdgeBatchCreateRequestMessage): Promise<JobResponse>`
-  - Create multiple EKG edges with Dempster-Shafer mass functions. Triggered by metamodel detection completion.
-
 - `etsyAnalyticsSyncCompleted(data: EtsyAnalyticsSyncCompletedMessage): Promise<JobResponse>`
   - Contains synced analytics data for Etsy listings. Backend stores this in etsy_analytics_snapshots table and indexes to ELK.
 
@@ -1989,11 +2280,11 @@ Retry Configuration:
 - `fileVectorizeRequest(data: FileVectorizeRequestMessage): Promise<JobResponse>`
   - Request to generate a vector embedding for an image file using CLIP.
 
-- `marketplaceAnalyticsSyncCompleted(data: MarketplaceAnalyticsSyncCompletedMessage): Promise<JobResponse>`
-  - Contains synced analytics data for marketplace listings. Backend stores this in marketplace_analytics_snapshots table and indexes to ELK. Works with any marketplace provider.
+- `ipCheckCompleted(data: IpCheckCompletedMessage): Promise<JobResponse>`
+  - Contains IP verification results including trademark risk, copyright risk, detected brands/franchises, and analysis confidence scores
 
-- `marketplaceAnalyticsSyncRequest(data: MarketplaceAnalyticsSyncRequestMessage): Promise<JobResponse>`
-  - Syncs analytics data from marketplace API for one or more listings. Fetches views, favorites, sales, revenue, and traffic source data. Can sync: specific listings, all user listings, or shop-level analytics. Works with any marketplace provider that supports analytics (etsy, ebay, etc.).
+- `ipCheckRequest(data: IpCheckRequestMessage): Promise<JobResponse>`
+  - Triggers intellectual property verification analysis for a model thumbnail, detecting potential trademark and copyright issues using perceptual hashing, text analysis, and optional reverse image search.
 
 - `marketplaceConnectionSyncCompleted(data: MarketplaceConnectionSyncCompletedMessage): Promise<JobResponse>`
   - Notification that marketplace connection sync has completed. Contains updated connection metadata, profile information, and sync statistics.
@@ -2012,6 +2303,14 @@ This is typically triggered after initial connection or periodically to keep mar
   - Requests rotation/refresh of marketplace connection credentials. This is used for: - OAuth token refresh when tokens are near expiry - API key rotation for enhanced security - Re-authentication after connection errors - Scheduled credential updates
 
 
+- `marketplaceIntelligenceCompleted(data: MarketplaceIntelligenceCompletedMessage): Promise<JobResponse>`
+  - Response from marketplace intelligence scraping.
+Contains aggregated similarity data from marketplace searches.
+
+Consumed by worker-backend to update pipeline context before
+sellability analysis runs.
+
+
 - `marketplaceIntelligenceEvent(data: MarketplaceIntelligenceEventMessage): Promise<JobResponse>`
   - Public marketplace intelligence data scraped from external marketplaces.
 
@@ -2030,6 +2329,22 @@ Consumed by worker-analytic-collector for Elasticsearch indexing.
 Used for market research, pricing optimization, and trend detection.
 
 
+- `marketplaceIntelligenceRequest(data: MarketplaceIntelligenceRequestMessage): Promise<JobResponse>`
+  - Triggers automated marketplace scraping to find similar/competing listings
+for a given model. This is a pipeline stage that runs after metadata generation
+to inform sellability analysis with real market data.
+
+The worker-analytic-collector (or marketplace-connectors worker) will:
+1. Use model metadata (title, tags, category) to build search queries
+2. Scrape connected marketplaces (Etsy, eBay, etc.) for similar listings
+3. Emit marketplace-intelligence-event results for Elasticsearch indexing
+4. Return aggregated similarity data to the pipeline context
+
+Pipeline integration:
+- Triggered after: metadata-generation (needs model title/tags/category)
+- Results feed into: sellability-analysis (market positioning data)
+
+
 - `marketplaceListingDescriptionGenerationCompleted(data: MarketplaceListingDescriptionGenerationCompletedMessage): Promise<JobResponse>`
   - Notifies backend that marketplace description generation completed. Contains generated description with metadata tracking (AI model, confidence, generation timestamp) and suggested price.
 
@@ -2063,12 +2378,6 @@ Includes bidirectional sync: - Pull: Fetch listings from marketplace to update l
 - `marketplaceListingUpdateRequest(data: MarketplaceListingUpdateRequestMessage): Promise<JobResponse>`
   - Request to update an existing listing on a marketplace (price, quantity, etc.)
 
-- `marketplacePublishListingCompleted(data: MarketplacePublishListingCompletedMessage): Promise<JobResponse>`
-  - Indicates completion of marketplace listing publication. Contains external listing ID and URL, or error details if failed. Works with any marketplace provider (etsy, ebay, etc.).
-
-- `marketplacePublishListingRequest(data: MarketplacePublishListingRequestMessage): Promise<JobResponse>`
-  - Publishes a single metamodel listing to a marketplace for a specific material variant. Creates listing, uploads digital file, and returns external listing ID. This message is enqueued for EACH material variant when publishing a metamodel. The marketplace type (etsy, ebay, etc.) is determined by the marketplaceProvider field.
-
 - `mediaBatchDownloadCompleted(data: MediaBatchDownloadCompletedMessage): Promise<JobResponse>`
   - Notifies that a batch media download has been completed.
 
@@ -2103,13 +2412,13 @@ and stores aggregated statistics in Elasticsearch for trend analysis.
   - Handles model discovery scan requests events.
 
 - `modelFinderIndexRequest(data: ModelFinderIndexRequestMessage): Promise<JobResponse>`
-  - Request to index a 3D model for similarity search.
+  - DEPRECATED (2026-02-18) — FR-023 retired. Merge 3D rendering into worker-file-vectorize.
 
 - `modelFinderResponse(data: ModelFinderResponseMessage): Promise<JobResponse>`
-  - Response containing search results from the model finder.
+  - DEPRECATED (2026-02-18) — FR-023 retired. Merge 3D rendering into worker-file-vectorize.
 
 - `modelFinderSearchRequest(data: ModelFinderSearchRequestMessage): Promise<JobResponse>`
-  - Request to search for similar 3D models.
+  - DEPRECATED (2026-02-18) — FR-023 retired. Merge 3D rendering into worker-file-vectorize.
 
 - `modelMetadataGenerationCompleted(data: ModelMetadataGenerationCompletedMessage): Promise<JobResponse>`
   - Notifies backend that enriched marketplace metadata generation completed. Backend updates Model entity with generated description, tags, classification, etc.
@@ -2123,6 +2432,12 @@ and stores aggregated statistics in Elasticsearch for trend analysis.
 - `modelMetamodelDetectionRequest(data: ModelMetamodelDetectionRequestMessage): Promise<JobResponse>`
   - Handles model metamodel detection requests.
 
+- `modelPrintAnalysisCompleted(data: ModelPrintAnalysisCompletedMessage): Promise<JobResponse>`
+  - Reports completion of 3D print analysis — contains estimation, printability, and cost breakdown per FR-022
+
+- `modelPrintAnalysisRequest(data: ModelPrintAnalysisRequestMessage): Promise<JobResponse>`
+  - Triggers 3D print analysis for a model — estimates print time, material usage, support needs, and cost breakdown per FR-022
+
 - `modelSellabilityAnalysisCompleted(data: ModelSellabilityAnalysisCompletedMessage): Promise<JobResponse>`
   - Contains sellability analysis results including Etsy-specific recommendations, material pricing, and marketplace compatibility scores
 
@@ -2141,6 +2456,24 @@ and stores aggregated statistics in Elasticsearch for trend analysis.
 - `modelTechnicalMetadataRequest(data: ModelTechnicalMetadataRequestMessage): Promise<JobResponse>`
   - Triggers comprehensive technical analysis of a 3D model file to extract geometry, quality metrics, and print-readiness information
 
+- `slicingFdmRequest(data: SlicingFdmRequestMessage): Promise<JobResponse>`
+  - Request FDM slicing simulation via OrcaSlicer (preferred) or heuristic fallback. Accepts OrcaSlicer-compatible printer/process/filament JSON profiles.
+
+- `slicingFdmResult(data: SlicingFdmResultMessage): Promise<JobResponse>`
+  - Result of FDM slicing simulation from OrcaSlicer (toolpath) or heuristic fallback. Contains exact physical metrics for cost calculation.
+
+- `slicingSlaRequest(data: SlicingSlaRequestMessage): Promise<JobResponse>`
+  - Request SLA/MSLA slicing simulation via PySLM cross-sectional analysis. Accepts resin printer profile with exposure, lift, and layer parameters.
+
+- `slicingSlaResult(data: SlicingSlaResultMessage): Promise<JobResponse>`
+  - Result of SLA/MSLA slicing simulation from PySLM cross-sectional analysis. Contains exact resin usage and print time metrics.
+
+- `textureGenerationCompleted(data: TextureGenerationCompletedMessage): Promise<JobResponse>`
+  - Emitted when AI texture generation completes (success or failure). Contains artifact S3 URLs on success, or error details on failure. The credit reservation should be confirmed (success) or released (failure) based on the status.
+
+- `textureGenerationRequest(data: TextureGenerationRequestMessage): Promise<JobResponse>`
+  - Request AI-powered texture generation for a 3D model. Requires a mesh file URL and a text prompt describing the desired texture. Credits are reserved before dispatch.
+
 - `thumbnailGenerationCompleted(data: ThumbnailGenerationCompletedMessage): Promise<JobResponse>`
   - Handles thumbnail generation completed.