@mesh-sync/worker-backend-client 1.0.4 → 1.0.6

package/README.md

@@ -100,6 +100,131 @@ await client.sendToQueue(MessageTypes.FILE_DOWNLOAD_REQUEST, {
 ## Available Message Types
 
 
+### etsy-analytics-sync-completed
+
+**Description:** Contains synced analytics data for Etsy listings. Backend stores this in etsy_analytics_snapshots table and indexes to ELK.
+
+
+**Method:** `client.etsyAnalyticsSyncCompleted(data)`
+
+**Payload Type:** `EtsyAnalyticsSyncCompletedMessage`
+
+**Fields:**
+
+- `originalJobId` (string) [✗]: 
+
+- `status` (string) [✗]: 
+
+- `syncedCount` (integer) [✗]: Number of listings successfully synced
+
+- `errorCount` (integer) [✗]: Number of listings that failed
+
+- `results` (array) [✗]: Analytics for each synced listing
+
+- `errors` (array) [✗]: Errors for failed listings
+
+- `syncedAt` (string) [✗]: 
+
+- `nextScheduledSync` (string) [✗]: When next automatic sync should occur
+
+
+
+### etsy-analytics-sync-request
+
+**Description:** Syncs analytics data from Etsy API for one or more listings. Fetches views, favorites, sales, revenue, and traffic source data.
+Can sync: - Specific listings (provide listingIds) - All user listings (provide userId, empty listingIds) - Shop-level analytics (provide shopId)
+
+
+**Method:** `client.etsyAnalyticsSyncRequest(data)`
+
+**Payload Type:** `EtsyAnalyticsSyncRequestMessage`
+
+**Fields:**
+
+- `listingIds` (array) [✗]: Internal listing IDs to sync. Empty = sync all for user.
+
+- `userId` (string) [✗]: User whose listings to sync (if listingIds empty)
+
+- `shopId` (string) [✗]: Etsy shop ID for shop-level analytics
+
+- `timeRange` (object) [✗]: Date range for historical analytics
+
+- `syncOptions` (object) [✗]: 
+
+- `etsyCredentials` (object) [✗]: Encrypted Etsy OAuth credentials
+
+- `webhookUrl` (string) [✗]: 
+
+
+
+### etsy-publish-listing-completed
+
+**Description:** Indicates completion of Etsy listing publication. Contains external Etsy listing ID and URL, or error details if failed.
+
+
+**Method:** `client.etsyPublishListingCompleted(data)`
+
+**Payload Type:** `EtsyPublishListingCompletedMessage`
+
+**Fields:**
+
+- `originalJobId` (string) [✗]: BullMQ job ID from request
+
+- `listingId` (string) [✗]: Internal marketplace_items ID
+
+- `metamodelId` (string) [✗]: Metamodel that was published
+
+- `materialName` (string) [✗]: Material variant name
+
+- `status` (string) [✗]: Publication result
+
+- `etsyListingId` (string) [✗]: External Etsy listing ID (only if status=SUCCESS)
+
+- `etsyListingUrl` (string) [✗]: URL to view listing on Etsy (only if status=SUCCESS)
+
+- `etsyFileId` (string) [✗]: Etsy digital file ID (only if status=SUCCESS)
+
+- `error` (object) [✗]: Error details (only if status=FAILED)
+
+- `publishedAt` (string) [✗]: When the listing was created (only if status=SUCCESS)
+
+- `processingDuration` (integer) [✗]: Processing time in milliseconds
+
+
+
+### etsy-publish-listing-request
+
+**Description:** Publishes a single metamodel listing to Etsy for a specific material variant. Creates Etsy listing, uploads digital file, and returns external listing ID.
+This message is enqueued for EACH material variant when publishing a metamodel.
+Example: Publishing a metamodel with PLA, Resin, ABS materials creates 3 jobs.
+
+
+**Method:** `client.etsyPublishListingRequest(data)`
+
+**Payload Type:** `EtsyPublishListingRequestMessage`
+
+**Fields:**
+
+- `listingId` (string) [✗]: Internal marketplace_items table ID
+
+- `metamodelId` (string) [✗]: Metamodel being published
+
+- `ownerId` (string) [✗]: User ID who owns the metamodel
+
+- `materialVariant` (object) [✗]: Material-specific listing configuration
+
+- `baseListingData` (object) [✗]: Common listing information
+
+- `publishOptions` (object) [✗]: 
+
+- `etsyCredentials` (object) [✗]: Encrypted Etsy OAuth credentials
+
+- `fileMetadata` (object) [✗]: Digital file to upload
+
+- `webhookUrl` (string) [✗]: Callback URL for completion notification
+
+
+
 ### file-download-completed
 
 **Description:** Notifies that a file download has been processed, indicating success or failure.
@@ -140,6 +265,136 @@ await client.sendToQueue(MessageTypes.FILE_DOWNLOAD_REQUEST, {
 
 
 
+### marketplace-analytics-sync-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.
+
+**Method:** `client.marketplaceAnalyticsSyncCompleted(data)`
+
+**Payload Type:** `MarketplaceAnalyticsSyncCompletedMessage`
+
+**Fields:**
+
+- `originalJobId` (string) [✗]: BullMQ job ID from original request
+
+- `marketplaceProvider` (string) [✗]: Marketplace provider type (etsy, ebay, etc.)
+
+- `status` (string) [✗]: Sync result (SUCCESS, PARTIAL_SUCCESS, or FAILED)
+
+- `syncedCount` (integer) [✗]: Number of listings successfully synced
+
+- `errorCount` (integer) [✗]: Number of listings that failed
+
+- `results` (array) [✗]: Analytics for each synced listing
+
+- `errors` (array) [✗]: Errors for failed listings
+
+- `syncedAt` (string) [✗]: When sync completed (ISO 8601)
+
+- `nextScheduledSync` (string) [✗]: When next automatic sync should occur (ISO 8601)
+
+
+
+### 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.).
+
+**Method:** `client.marketplaceAnalyticsSyncRequest(data)`
+
+**Payload Type:** `MarketplaceAnalyticsSyncRequestMessage`
+
+**Fields:**
+
+- `marketplaceProvider` (string) [✗]: Marketplace provider type (etsy, ebay, etc.)
+
+- `marketplaceConnectionId` (string) [✗]: UUID of the marketplace connection configuration
+
+- `listingIds` (array) [✗]: Internal listing UUIDs to sync. Empty array = sync all for user.
+
+- `userId` (string) [✗]: UUID of user whose listings to sync (if listingIds empty)
+
+- `externalShopId` (string) [✗]: External marketplace shop ID for shop-level analytics
+
+- `timeRange` (object) [✗]: Date range for historical analytics
+
+- `syncOptions` (object) [✗]: Optional sync configuration
+
+- `marketplaceCredentials` (object) [✗]: Encrypted marketplace credentials (retrieved from marketplaceConnectionId)
+
+- `webhookUrl` (string) [✗]: Callback URL for completion notification
+
+
+
+### 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.
@@ -227,6 +482,8 @@ await client.sendToQueue(MessageTypes.FILE_DOWNLOAD_REQUEST, {
 
 - `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
 
 
@@ -367,7 +624,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)`
 
@@ -375,7 +632,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).
 
 
 
@@ -403,6 +660,58 @@ await client.sendToQueue(MessageTypes.FILE_DOWNLOAD_REQUEST, {
 
 
 
+### model-sellability-analysis-completed
+
+**Description:** Contains sellability analysis results including Etsy-specific recommendations, material pricing, and marketplace compatibility scores
+
+**Method:** `client.modelSellabilityAnalysisCompleted(data)`
+
+**Payload Type:** `ModelSellabilityAnalysisCompletedMessage`
+
+**Fields:**
+
+- `metamodelId` (string) [✗]: Metamodel UUID
+
+- `ownerId` (string) [✗]: Owner user ID
+
+- `sellabilityScore` (number) [✗]: Overall sellability score (0-100)
+
+- `pricingRecommendations` (object) [✗]: Pricing analysis and recommendations with material-specific pricing (v2.0.0)
+
+- `marketplaceRecommendations` (array) [✗]: Recommended marketplaces with Etsy-specific scoring (v2.0.0)
+
+- `demandAnalysis` (object) [✗]: Market demand insights
+
+- `qualityFactors` (object) [✗]: Quality-related factors affecting sellability
+
+- `recommendations` (array) [✗]: Actionable recommendations to improve sellability
+
+- `analyzedAt` (string) [✗]: Analysis completion timestamp (ISO 8601)
+
+- `analysisVersion` (string) [✗]: Analysis algorithm version
+
+- `error` (object) [✗]: Error information if analysis failed
+
+
+
+### model-sellability-analysis-request
+
+**Description:** Analyzes a metamodel to determine sellability score, pricing recommendations, and optimal marketplace selection. Enhanced with Etsy-specific analysis including competitor pricing, category demand trends, and material suitability.
+
+**Method:** `client.modelSellabilityAnalysisRequest(data)`
+
+**Payload Type:** `ModelSellabilityAnalysisRequestMessage`
+
+**Fields:**
+
+- `metamodelId` (string) [✗]: UUID of the metamodel to analyze. Worker will fetch all model metadata, technical metadata, enriched metadata, and child models from PostgreSQL.
+
+- `ownerId` (string) [✗]: UUID of the user who owns the metamodel
+
+- `analysisOptions` (object) [✗]: Optional analysis configuration
+
+
+
 ### model-technical-metadata-completed
 
 **Description:** Reports comprehensive results of technical metadata analysis including geometry, quality metrics, and print-readiness assessment
@@ -595,12 +904,43 @@ new WorkerClient(config: WorkerClientConfig)
   - Get the current status of a job
 
 
+- `etsyAnalyticsSyncCompleted(data: EtsyAnalyticsSyncCompletedMessage): Promise<JobResponse>`
+  - Contains synced analytics data for Etsy listings. Backend stores this in etsy_analytics_snapshots table and indexes to ELK.
+
+
+- `etsyAnalyticsSyncRequest(data: EtsyAnalyticsSyncRequestMessage): Promise<JobResponse>`
+  - Syncs analytics data from Etsy API for one or more listings. Fetches views, favorites, sales, revenue, and traffic source data.
+Can sync: - Specific listings (provide listingIds) - All user listings (provide userId, empty listingIds) - Shop-level analytics (provide shopId)
+
+
+- `etsyPublishListingCompleted(data: EtsyPublishListingCompletedMessage): Promise<JobResponse>`
+  - Indicates completion of Etsy listing publication. Contains external Etsy listing ID and URL, or error details if failed.
+
+
+- `etsyPublishListingRequest(data: EtsyPublishListingRequestMessage): Promise<JobResponse>`
+  - Publishes a single metamodel listing to Etsy for a specific material variant. Creates Etsy listing, uploads digital file, and returns external listing ID.
+This message is enqueued for EACH material variant when publishing a metamodel.
+Example: Publishing a metamodel with PLA, Resin, ABS materials creates 3 jobs.
+
+
 - `fileDownloadCompleted(data: FileDownloadCompletedMessage): Promise<JobResponse>`
   - Notifies that a file download has been processed, indicating success or failure.
 
 - `fileDownloadRequest(data: FileDownloadRequestMessage): Promise<JobResponse>`
   - Handles file download requests.
 
+- `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.
+
+- `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.).
+
+- `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.
 
@@ -633,11 +973,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.
 
+- `modelSellabilityAnalysisCompleted(data: ModelSellabilityAnalysisCompletedMessage): Promise<JobResponse>`
+  - Contains sellability analysis results including Etsy-specific recommendations, material pricing, and marketplace compatibility scores
+
+- `modelSellabilityAnalysisRequest(data: ModelSellabilityAnalysisRequestMessage): Promise<JobResponse>`
+  - Analyzes a metamodel to determine sellability score, pricing recommendations, and optimal marketplace selection. Enhanced with Etsy-specific analysis including competitor pricing, category demand trends, and material suitability.
+
 - `modelTechnicalMetadataCompleted(data: ModelTechnicalMetadataCompletedMessage): Promise<JobResponse>`
   - Reports comprehensive results of technical metadata analysis including geometry, quality metrics, and print-readiness assessment
 

package/dist/client.d.ts

@@ -37,6 +37,37 @@ export declare class WorkerClient {
      * Get job status by job ID
      */
     getJobStatus(jobId: string): Promise<JobStatus>;
+    /**
+     * Contains synced analytics data for Etsy listings. Backend stores this in etsy_analytics_snapshots table and indexes to ELK.
+  
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    etsyAnalyticsSyncCompleted(data: types.EtsyAnalyticsSyncCompletedMessage): Promise<JobResponse>;
+    /**
+     * Syncs analytics data from Etsy API for one or more listings. Fetches views, favorites, sales, revenue, and traffic source data.
+  Can sync: - Specific listings (provide listingIds) - All user listings (provide userId, empty listingIds) - Shop-level analytics (provide shopId)
+  
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    etsyAnalyticsSyncRequest(data: types.EtsyAnalyticsSyncRequestMessage): Promise<JobResponse>;
+    /**
+     * Indicates completion of Etsy listing publication. Contains external Etsy listing ID and URL, or error details if failed.
+  
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    etsyPublishListingCompleted(data: types.EtsyPublishListingCompletedMessage): Promise<JobResponse>;
+    /**
+     * Publishes a single metamodel listing to Etsy for a specific material variant. Creates Etsy listing, uploads digital file, and returns external listing ID.
+  This message is enqueued for EACH material variant when publishing a metamodel.
+  Example: Publishing a metamodel with PLA, Resin, ABS materials creates 3 jobs.
+  
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    etsyPublishListingRequest(data: types.EtsyPublishListingRequestMessage): Promise<JobResponse>;
     /**
      * Notifies that a file download has been processed, indicating success or failure.
      * @param data - The message payload
@@ -49,6 +80,30 @@ export declare class WorkerClient {
      * @returns Job response with job ID
      */
     fileDownloadRequest(data: types.FileDownloadRequestMessage): 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.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    marketplaceAnalyticsSyncCompleted(data: types.MarketplaceAnalyticsSyncCompletedMessage): 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.).
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    marketplaceAnalyticsSyncRequest(data: types.MarketplaceAnalyticsSyncRequestMessage): 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.).
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    marketplacePublishListingCompleted(data: types.MarketplacePublishListingCompletedMessage): 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.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    marketplacePublishListingRequest(data: types.MarketplacePublishListingRequestMessage): Promise<JobResponse>;
     /**
      * Notifies that a batch media download has been completed.
      * @param data - The message payload
@@ -111,7 +166,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
      */
@@ -122,6 +177,18 @@ export declare class WorkerClient {
      * @returns Job response with job ID
      */
     modelMetamodelDetectionRequest(data: types.ModelMetamodelDetectionRequestMessage): Promise<JobResponse>;
+    /**
+     * Contains sellability analysis results including Etsy-specific recommendations, material pricing, and marketplace compatibility scores
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    modelSellabilityAnalysisCompleted(data: types.ModelSellabilityAnalysisCompletedMessage): Promise<JobResponse>;
+    /**
+     * Analyzes a metamodel to determine sellability score, pricing recommendations, and optimal marketplace selection. Enhanced with Etsy-specific analysis including competitor pricing, category demand trends, and material suitability.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    modelSellabilityAnalysisRequest(data: types.ModelSellabilityAnalysisRequestMessage): Promise<JobResponse>;
     /**
      * Reports comprehensive results of technical metadata analysis including geometry, quality metrics, and print-readiness assessment
      * @param data - The message payload

package/dist/client.js

@@ -60,6 +60,45 @@ export class WorkerClient {
         }
         return await response.json();
     }
+    /**
+     * Contains synced analytics data for Etsy listings. Backend stores this in etsy_analytics_snapshots table and indexes to ELK.
+  
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async etsyAnalyticsSyncCompleted(data) {
+        return this.sendToQueue(types.MessageTypes.ETSY_ANALYTICS_SYNC_COMPLETED, data);
+    }
+    /**
+     * Syncs analytics data from Etsy API for one or more listings. Fetches views, favorites, sales, revenue, and traffic source data.
+  Can sync: - Specific listings (provide listingIds) - All user listings (provide userId, empty listingIds) - Shop-level analytics (provide shopId)
+  
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async etsyAnalyticsSyncRequest(data) {
+        return this.sendToQueue(types.MessageTypes.ETSY_ANALYTICS_SYNC_REQUEST, data);
+    }
+    /**
+     * Indicates completion of Etsy listing publication. Contains external Etsy listing ID and URL, or error details if failed.
+  
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async etsyPublishListingCompleted(data) {
+        return this.sendToQueue(types.MessageTypes.ETSY_PUBLISH_LISTING_COMPLETED, data);
+    }
+    /**
+     * Publishes a single metamodel listing to Etsy for a specific material variant. Creates Etsy listing, uploads digital file, and returns external listing ID.
+  This message is enqueued for EACH material variant when publishing a metamodel.
+  Example: Publishing a metamodel with PLA, Resin, ABS materials creates 3 jobs.
+  
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async etsyPublishListingRequest(data) {
+        return this.sendToQueue(types.MessageTypes.ETSY_PUBLISH_LISTING_REQUEST, data);
+    }
     /**
      * Notifies that a file download has been processed, indicating success or failure.
      * @param data - The message payload
@@ -76,6 +115,38 @@ export class WorkerClient {
     async fileDownloadRequest(data) {
         return this.sendToQueue(types.MessageTypes.FILE_DOWNLOAD_REQUEST, data);
     }
+    /**
+     * Contains synced analytics data for marketplace listings. Backend stores this in marketplace_analytics_snapshots table and indexes to ELK. Works with any marketplace provider.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async marketplaceAnalyticsSyncCompleted(data) {
+        return this.sendToQueue(types.MessageTypes.MARKETPLACE_ANALYTICS_SYNC_COMPLETED, data);
+    }
+    /**
+     * 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.).
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async marketplaceAnalyticsSyncRequest(data) {
+        return this.sendToQueue(types.MessageTypes.MARKETPLACE_ANALYTICS_SYNC_REQUEST, data);
+    }
+    /**
+     * 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.).
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async marketplacePublishListingCompleted(data) {
+        return this.sendToQueue(types.MessageTypes.MARKETPLACE_PUBLISH_LISTING_COMPLETED, data);
+    }
+    /**
+     * 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.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async marketplacePublishListingRequest(data) {
+        return this.sendToQueue(types.MessageTypes.MARKETPLACE_PUBLISH_LISTING_REQUEST, data);
+    }
     /**
      * Notifies that a batch media download has been completed.
      * @param data - The message payload
@@ -158,7 +229,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
      */
@@ -173,6 +244,22 @@ export class WorkerClient {
     async modelMetamodelDetectionRequest(data) {
         return this.sendToQueue(types.MessageTypes.MODEL_METAMODEL_DETECTION_REQUEST, data);
     }
+    /**
+     * Contains sellability analysis results including Etsy-specific recommendations, material pricing, and marketplace compatibility scores
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async modelSellabilityAnalysisCompleted(data) {
+        return this.sendToQueue(types.MessageTypes.MODEL_SELLABILITY_ANALYSIS_COMPLETED, data);
+    }
+    /**
+     * Analyzes a metamodel to determine sellability score, pricing recommendations, and optimal marketplace selection. Enhanced with Etsy-specific analysis including competitor pricing, category demand trends, and material suitability.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async modelSellabilityAnalysisRequest(data) {
+        return this.sendToQueue(types.MessageTypes.MODEL_SELLABILITY_ANALYSIS_REQUEST, data);
+    }
     /**
      * Reports comprehensive results of technical metadata analysis including geometry, quality metrics, and print-readiness assessment
      * @param data - The message payload

package/dist/types.d.ts

@@ -2,8 +2,16 @@
  * Message type constants
  */
 export declare const MessageTypes: {
+    readonly ETSY_ANALYTICS_SYNC_COMPLETED: "etsy-analytics-sync-completed";
+    readonly ETSY_ANALYTICS_SYNC_REQUEST: "etsy-analytics-sync-request";
+    readonly ETSY_PUBLISH_LISTING_COMPLETED: "etsy-publish-listing-completed";
+    readonly ETSY_PUBLISH_LISTING_REQUEST: "etsy-publish-listing-request";
     readonly FILE_DOWNLOAD_COMPLETED: "file-download-completed";
     readonly FILE_DOWNLOAD_REQUEST: "file-download-request";
+    readonly MARKETPLACE_ANALYTICS_SYNC_COMPLETED: "marketplace-analytics-sync-completed";
+    readonly MARKETPLACE_ANALYTICS_SYNC_REQUEST: "marketplace-analytics-sync-request";
+    readonly MARKETPLACE_PUBLISH_LISTING_COMPLETED: "marketplace-publish-listing-completed";
+    readonly MARKETPLACE_PUBLISH_LISTING_REQUEST: "marketplace-publish-listing-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";
@@ -16,12 +24,111 @@ 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_SELLABILITY_ANALYSIS_COMPLETED: "model-sellability-analysis-completed";
+    readonly MODEL_SELLABILITY_ANALYSIS_REQUEST: "model-sellability-analysis-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";
 };
 export type MessageType = typeof MessageTypes[keyof typeof MessageTypes];
+/**
+ * Contains synced analytics data for Etsy listings. Backend stores this in etsy_analytics_snapshots table and indexes to ELK.
+
+ */
+export interface EtsyAnalyticsSyncCompletedMessage {
+    /**  */
+    originalJobId?: string;
+    /**  */
+    status?: string;
+    /** Number of listings successfully synced */
+    syncedCount?: string | number | boolean;
+    /** Number of listings that failed */
+    errorCount?: string | number | boolean;
+    /** Analytics for each synced listing */
+    results?: Array<Record<string, string | number | boolean>>;
+    /** Errors for failed listings */
+    errors?: Array<Record<string, string | number | boolean>>;
+    /**  */
+    syncedAt?: string;
+    /** When next automatic sync should occur */
+    nextScheduledSync?: string;
+}
+/**
+ * Syncs analytics data from Etsy API for one or more listings. Fetches views, favorites, sales, revenue, and traffic source data.
+Can sync: - Specific listings (provide listingIds) - All user listings (provide userId, empty listingIds) - Shop-level analytics (provide shopId)
+
+ */
+export interface EtsyAnalyticsSyncRequestMessage {
+    /** Internal listing IDs to sync. Empty = sync all for user. */
+    listingIds?: Array<Record<string, string | number | boolean>>;
+    /** User whose listings to sync (if listingIds empty) */
+    userId?: string;
+    /** Etsy shop ID for shop-level analytics */
+    shopId?: string;
+    /** Date range for historical analytics */
+    timeRange?: Record<string, string | number | boolean>;
+    /**  */
+    syncOptions?: Record<string, string | number | boolean>;
+    /** Encrypted Etsy OAuth credentials */
+    etsyCredentials?: Record<string, string | number | boolean>;
+    /**  */
+    webhookUrl?: string;
+}
+/**
+ * Indicates completion of Etsy listing publication. Contains external Etsy listing ID and URL, or error details if failed.
+
+ */
+export interface EtsyPublishListingCompletedMessage {
+    /** BullMQ job ID from request */
+    originalJobId?: string;
+    /** Internal marketplace_items ID */
+    listingId?: string;
+    /** Metamodel that was published */
+    metamodelId?: string;
+    /** Material variant name */
+    materialName?: string;
+    /** Publication result */
+    status?: string;
+    /** External Etsy listing ID (only if status=SUCCESS) */
+    etsyListingId?: string;
+    /** URL to view listing on Etsy (only if status=SUCCESS) */
+    etsyListingUrl?: string;
+    /** Etsy digital file ID (only if status=SUCCESS) */
+    etsyFileId?: string;
+    /** Error details (only if status=FAILED) */
+    error?: Record<string, string | number | boolean>;
+    /** When the listing was created (only if status=SUCCESS) */
+    publishedAt?: string;
+    /** Processing time in milliseconds */
+    processingDuration?: string | number | boolean;
+}
+/**
+ * Publishes a single metamodel listing to Etsy for a specific material variant. Creates Etsy listing, uploads digital file, and returns external listing ID.
+This message is enqueued for EACH material variant when publishing a metamodel.
+Example: Publishing a metamodel with PLA, Resin, ABS materials creates 3 jobs.
+
+ */
+export interface EtsyPublishListingRequestMessage {
+    /** Internal marketplace_items table ID */
+    listingId?: string;
+    /** Metamodel being published */
+    metamodelId?: string;
+    /** User ID who owns the metamodel */
+    ownerId?: string;
+    /** Material-specific listing configuration */
+    materialVariant?: Record<string, string | number | boolean>;
+    /** Common listing information */
+    baseListingData?: Record<string, string | number | boolean>;
+    /**  */
+    publishOptions?: Record<string, string | number | boolean>;
+    /** Encrypted Etsy OAuth credentials */
+    etsyCredentials?: Record<string, string | number | boolean>;
+    /** Digital file to upload */
+    fileMetadata?: Record<string, string | number | boolean>;
+    /** Callback URL for completion notification */
+    webhookUrl?: string;
+}
 /**
  * Notifies that a file download has been processed, indicating success or failure.
  */
@@ -48,6 +155,108 @@ export interface FileDownloadRequestMessage {
     /** The storage location of the model. */
     storageLocation?: Record<string, string | number | boolean>;
 }
+/**
+ * Contains synced analytics data for marketplace listings. Backend stores this in marketplace_analytics_snapshots table and indexes to ELK. Works with any marketplace provider.
+ */
+export interface MarketplaceAnalyticsSyncCompletedMessage {
+    /** BullMQ job ID from original request */
+    originalJobId?: string;
+    /** Marketplace provider type (etsy, ebay, etc.) */
+    marketplaceProvider?: string;
+    /** Sync result (SUCCESS, PARTIAL_SUCCESS, or FAILED) */
+    status?: string;
+    /** Number of listings successfully synced */
+    syncedCount?: string | number | boolean;
+    /** Number of listings that failed */
+    errorCount?: string | number | boolean;
+    /** Analytics for each synced listing */
+    results?: Array<Record<string, string | number | boolean>>;
+    /** Errors for failed listings */
+    errors?: Array<Record<string, string | number | boolean>>;
+    /** When sync completed (ISO 8601) */
+    syncedAt?: string;
+    /** When next automatic sync should occur (ISO 8601) */
+    nextScheduledSync?: string;
+}
+/**
+ * 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.).
+ */
+export interface MarketplaceAnalyticsSyncRequestMessage {
+    /** Marketplace provider type (etsy, ebay, etc.) */
+    marketplaceProvider?: string;
+    /** UUID of the marketplace connection configuration */
+    marketplaceConnectionId?: string;
+    /** Internal listing UUIDs to sync. Empty array = sync all for user. */
+    listingIds?: Array<Record<string, string | number | boolean>>;
+    /** UUID of user whose listings to sync (if listingIds empty) */
+    userId?: string;
+    /** External marketplace shop ID for shop-level analytics */
+    externalShopId?: string;
+    /** Date range for historical analytics */
+    timeRange?: Record<string, string | number | boolean>;
+    /** Optional sync configuration */
+    syncOptions?: Record<string, string | number | boolean>;
+    /** Encrypted marketplace credentials (retrieved from marketplaceConnectionId) */
+    marketplaceCredentials?: Record<string, string | number | boolean>;
+    /** Callback URL for completion notification */
+    webhookUrl?: string;
+}
+/**
+ * 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.).
+ */
+export interface MarketplacePublishListingCompletedMessage {
+    /** BullMQ job ID from original request */
+    originalJobId?: string;
+    /** Internal marketplace_items UUID */
+    listingId?: string;
+    /** UUID of the metamodel that was published */
+    metamodelId?: string;
+    /** Marketplace provider type (etsy, ebay, etc.) */
+    marketplaceProvider?: string;
+    /** Material variant name */
+    materialName?: string;
+    /** Publication result (SUCCESS or FAILED) */
+    status?: string;
+    /** External marketplace listing ID (only if status=SUCCESS) */
+    externalListingId?: string;
+    /** URL to view listing on marketplace (only if status=SUCCESS) */
+    externalListingUrl?: string;
+    /** External marketplace file ID (only if status=SUCCESS) */
+    externalFileId?: string;
+    /** Error details (only if status=FAILED) */
+    error?: Record<string, string | number | boolean>;
+    /** When the listing was created (ISO 8601, only if status=SUCCESS) */
+    publishedAt?: string;
+    /** Processing time in milliseconds */
+    processingDuration?: string | number | boolean;
+}
+/**
+ * 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.
+ */
+export interface MarketplacePublishListingRequestMessage {
+    /** Internal marketplace_items table UUID */
+    listingId?: string;
+    /** UUID of the metamodel being published */
+    metamodelId?: string;
+    /** UUID of the user who owns the metamodel */
+    ownerId?: string;
+    /** Marketplace provider type (etsy, ebay, leboncoin, etc.) */
+    marketplaceProvider?: string;
+    /** UUID of the marketplace connection configuration */
+    marketplaceConnectionId?: string;
+    /** Material-specific listing configuration */
+    materialVariant?: Record<string, string | number | boolean>;
+    /** Common listing information shared across variants */
+    baseListingData?: Record<string, string | number | boolean>;
+    /** Publishing configuration (marketplace-specific options) */
+    publishOptions?: Record<string, string | number | boolean>;
+    /** Encrypted marketplace credentials (retrieved from marketplaceConnectionId) */
+    marketplaceCredentials?: Record<string, string | number | boolean>;
+    /** Digital file to upload */
+    fileMetadata?: Record<string, string | number | boolean>;
+    /** Callback URL for completion notification */
+    webhookUrl?: string;
+}
 /**
  * Notifies that a batch media download has been completed.
  */
@@ -108,6 +317,8 @@ export interface MetamodelMetadataGenerationRequestMessage {
     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;
 }
@@ -204,11 +415,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.
@@ -227,6 +438,44 @@ export interface ModelMetamodelDetectionRequestMessage {
     /** Statistics about the processed folder. */
     statistics: Record<string, string | number | boolean>;
 }
+/**
+ * Contains sellability analysis results including Etsy-specific recommendations, material pricing, and marketplace compatibility scores
+ */
+export interface ModelSellabilityAnalysisCompletedMessage {
+    /** Metamodel UUID */
+    metamodelId?: string;
+    /** Owner user ID */
+    ownerId?: string;
+    /** Overall sellability score (0-100) */
+    sellabilityScore?: number;
+    /** Pricing analysis and recommendations with material-specific pricing (v2.0.0) */
+    pricingRecommendations?: Record<string, string | number | boolean>;
+    /** Recommended marketplaces with Etsy-specific scoring (v2.0.0) */
+    marketplaceRecommendations?: Array<Record<string, string | number | boolean>>;
+    /** Market demand insights */
+    demandAnalysis?: Record<string, string | number | boolean>;
+    /** Quality-related factors affecting sellability */
+    qualityFactors?: Record<string, string | number | boolean>;
+    /** Actionable recommendations to improve sellability */
+    recommendations?: Array<Record<string, string | number | boolean>>;
+    /** Analysis completion timestamp (ISO 8601) */
+    analyzedAt?: string;
+    /** Analysis algorithm version */
+    analysisVersion?: string;
+    /** Error information if analysis failed */
+    error?: Record<string, string | number | boolean>;
+}
+/**
+ * Analyzes a metamodel to determine sellability score, pricing recommendations, and optimal marketplace selection. Enhanced with Etsy-specific analysis including competitor pricing, category demand trends, and material suitability.
+ */
+export interface ModelSellabilityAnalysisRequestMessage {
+    /** UUID of the metamodel to analyze. Worker will fetch all model metadata, technical metadata, enriched metadata, and child models from PostgreSQL. */
+    metamodelId?: string;
+    /** UUID of the user who owns the metamodel */
+    ownerId?: string;
+    /** Optional analysis configuration */
+    analysisOptions?: Record<string, string | number | boolean>;
+}
 /**
  * Reports comprehensive results of technical metadata analysis including geometry, quality metrics, and print-readiness assessment
  */

package/dist/types.js

@@ -3,8 +3,16 @@
  * Message type constants
  */
 export const MessageTypes = {
+    ETSY_ANALYTICS_SYNC_COMPLETED: 'etsy-analytics-sync-completed',
+    ETSY_ANALYTICS_SYNC_REQUEST: 'etsy-analytics-sync-request',
+    ETSY_PUBLISH_LISTING_COMPLETED: 'etsy-publish-listing-completed',
+    ETSY_PUBLISH_LISTING_REQUEST: 'etsy-publish-listing-request',
     FILE_DOWNLOAD_COMPLETED: 'file-download-completed',
     FILE_DOWNLOAD_REQUEST: 'file-download-request',
+    MARKETPLACE_ANALYTICS_SYNC_COMPLETED: 'marketplace-analytics-sync-completed',
+    MARKETPLACE_ANALYTICS_SYNC_REQUEST: 'marketplace-analytics-sync-request',
+    MARKETPLACE_PUBLISH_LISTING_COMPLETED: 'marketplace-publish-listing-completed',
+    MARKETPLACE_PUBLISH_LISTING_REQUEST: 'marketplace-publish-listing-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',
@@ -17,6 +25,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_SELLABILITY_ANALYSIS_COMPLETED: 'model-sellability-analysis-completed',
+    MODEL_SELLABILITY_ANALYSIS_REQUEST: 'model-sellability-analysis-request',
     MODEL_TECHNICAL_METADATA_COMPLETED: 'model-technical-metadata-completed',
     MODEL_TECHNICAL_METADATA_REQUEST: 'model-technical-metadata-request',
     THUMBNAIL_GENERATION_COMPLETED: 'thumbnail-generation-completed',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mesh-sync/worker-backend-client",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Auto-generated TypeScript client for worker-backend - provides type-safe methods for enqueueing jobs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -25,7 +25,7 @@
   "license": "ISC",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Mesh-Sync/worker-backend.git",
+    "url": "git+https://github.com/Mesh-Sync/worker-backend.git",
     "directory": "generated/typescript"
   },
   "publishConfig": {