@mesh-sync/worker-backend-client 4.0.17 → 4.0.19

package/README.md

@@ -647,9 +647,54 @@ This is typically triggered after initial connection or periodically to keep mar
 
 
 
+### marketplace-intelligence-event
+
+**Description:** Public marketplace intelligence data scraped from external marketplaces.
+
+This event contains:
+- Listing details (title, price, images)
+- Engagement metrics (views, favorites, reviews)
+- Shop information
+- Market positioning data
+
+Unlike marketplace-listing-sync-request (private user data), this focuses on:
+- Broad market trends and pricing analysis
+- Competitive intelligence and demand signals
+- Product popularity and sentiment
+
+Consumed by worker-analytic-collector for Elasticsearch indexing.
+Used for market research, pricing optimization, and trend detection.
+
+
+**Method:** `client.marketplaceIntelligenceEvent(data)`
+
+**Payload Type:** `MarketplaceIntelligenceEventMessage`
+
+**Fields:**
+
+- `marketplace` (string) [✓]: Source marketplace
+
+- `externalId` (string) [✓]: Marketplace-native listing ID
+
+- `listing` (object) [✓]: Core listing information
+
+- `metrics` (object) [✗]: Public engagement and sales metrics
+
+- `metadata` (object) [✗]: Additional listing context and categorization
+
+- `queryContext` (object) [✗]: Search context that found this listing
+
+- `collectedAt` (string) [✓]: ISO 8601 timestamp when data was scraped
+
+- `collectorVersion` (string) [✗]: Version of collector that scraped this data
+
+- `scrapingMethod` (string) [✗]: Method used for scraping
+
+
+
 ### marketplace-listing-description-generation-completed
 
-**Description:** Notifies backend that marketplace description generation completed. Contains generated description with metadata tracking (AI model, confidence, generation timestamp).
+**Description:** Notifies backend that marketplace description generation completed. Contains generated description with metadata tracking (AI model, confidence, generation timestamp) and suggested price.
 
 **Method:** `client.marketplaceListingDescriptionGenerationCompleted(data)`
 
@@ -661,10 +706,14 @@ This is typically triggered after initial connection or periodically to keep mar
 
 - `entityType` (string) [✓]: Type of entity processed
 
+- `targetMarketplace` (string) [✗]: Target marketplace ID (e.g., 'etsy', 'ebay')
+
 - `description` (string) [✓]: SEO-optimized marketplace description (3-5 sentences)
 
 - `metadata` (object) [✓]: Content generation metadata for tracking
 
+- `suggestedPrice` (object) [✗]: Volume-based price calculation for 3D printed item
+
 - `error` (string) [✗]: Error message if generation failed
 
 
@@ -699,6 +748,12 @@ This is typically triggered after initial connection or periodically to keep mar
 
 - `existingCategory` (string) [✗]: Current classification for context
 
+- `brandVoice` (string) [✗]: Desired tone/voice for the listing (e.g., 'professional', 'playful')
+
+- `targetMarket` (string) [✗]: Target geographic market (e.g., 'US', 'EU')
+
+- `keywords` (array) [✗]: Specific keywords to include
+
 
 
 ### marketplace-listing-sync-completed
@@ -832,6 +887,12 @@ Includes bidirectional sync: - Pull: Fetch listings from marketplace to update l
 
 - `tagLimit` (number) [✗]: Maximum number of tags for marketplace (e.g., 13 for Etsy)
 
+- `targetMarket` (string) [✗]: Target geographic market (e.g., 'US', 'EU')
+
+- `style` (string) [✗]: Artistic style of the model (e.g., 'realistic', 'low-poly')
+
+- `useCases` (array) [✗]: Intended uses for the model
+
 
 
 ### marketplace-listing-title-generation-completed
@@ -886,6 +947,54 @@ Includes bidirectional sync: - Pull: Fetch listings from marketplace to update l
 
 - `characterLimit` (number) [✗]: Maximum character count for marketplace (e.g., 140 for Etsy)
 
+- `brandVoice` (string) [✗]: Desired tone/voice for the listing (e.g., 'professional', 'playful')
+
+- `targetMarket` (string) [✗]: Target geographic market (e.g., 'US', 'EU')
+
+- `keywords` (array) [✗]: Specific keywords to include
+
+
+
+### marketplace-listing-update-completed
+
+**Description:** Result of a listing update operation
+
+**Method:** `client.marketplaceListingUpdateCompleted(data)`
+
+**Payload Type:** `MarketplaceListingUpdateCompletedMessage`
+
+**Fields:**
+
+- `marketplace` (string) [✗]: Target marketplace
+
+- `listingId` (string) [✗]: External ID of the listing
+
+- `status` (string) [✗]: Status of the update (success, failed)
+
+- `result` (object) [✗]: Result details from the marketplace API
+
+- `error` (string) [✗]: Error message if failed
+
+
+
+### marketplace-listing-update-request
+
+**Description:** Request to update an existing listing on a marketplace (price, quantity, etc.)
+
+**Method:** `client.marketplaceListingUpdateRequest(data)`
+
+**Payload Type:** `MarketplaceListingUpdateRequestMessage`
+
+**Fields:**
+
+- `marketplace` (string) [✗]: Target marketplace (etsy, ebay, etc.)
+
+- `listingId` (string) [✗]: External ID of the listing to update
+
+- `updates` (object) [✗]: Fields to update
+
+- `credentials` (object) [✗]: User credentials for the marketplace
+
 
 
 ### marketplace-publish-listing-completed
@@ -1903,8 +2012,26 @@ 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
 
 
+- `marketplaceIntelligenceEvent(data: MarketplaceIntelligenceEventMessage): Promise<JobResponse>`
+  - Public marketplace intelligence data scraped from external marketplaces.
+
+This event contains:
+- Listing details (title, price, images)
+- Engagement metrics (views, favorites, reviews)
+- Shop information
+- Market positioning data
+
+Unlike marketplace-listing-sync-request (private user data), this focuses on:
+- Broad market trends and pricing analysis
+- Competitive intelligence and demand signals
+- Product popularity and sentiment
+
+Consumed by worker-analytic-collector for Elasticsearch indexing.
+Used for market research, pricing optimization, and trend detection.
+
+
 - `marketplaceListingDescriptionGenerationCompleted(data: MarketplaceListingDescriptionGenerationCompletedMessage): Promise<JobResponse>`
-  - Notifies backend that marketplace description generation completed. Contains generated description with metadata tracking (AI model, confidence, generation timestamp).
+  - Notifies backend that marketplace description generation completed. Contains generated description with metadata tracking (AI model, confidence, generation timestamp) and suggested price.
 
 - `marketplaceListingDescriptionGenerationRequest(data: MarketplaceListingDescriptionGenerationRequestMessage): Promise<JobResponse>`
   - Generates SEO-optimized marketplace description for a 3D model using LLM vision analysis. Worker receives model data, technical metadata, and thumbnail URLs to generate compelling product descriptions tailored to the target marketplace.
@@ -1930,6 +2057,12 @@ Includes bidirectional sync: - Pull: Fetch listings from marketplace to update l
 - `marketplaceListingTitleGenerationRequest(data: MarketplaceListingTitleGenerationRequestMessage): Promise<JobResponse>`
   - Generates marketplace-optimized title for a 3D model. Worker creates concise, SEO-friendly titles following marketplace character limits and best practices.
 
+- `marketplaceListingUpdateCompleted(data: MarketplaceListingUpdateCompletedMessage): Promise<JobResponse>`
+  - Result of a listing update operation
+
+- `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.).
 

package/dist/client.d.ts

@@ -175,7 +175,28 @@ export declare class WorkerClient {
      */
     marketplaceCredentialRotationRequest(data: types.MarketplaceCredentialRotationRequestMessage): Promise<JobResponse>;
     /**
-     * Notifies backend that marketplace description generation completed. Contains generated description with metadata tracking (AI model, confidence, generation timestamp).
+     * Public marketplace intelligence data scraped from external marketplaces.
+  
+  This event contains:
+  - Listing details (title, price, images)
+  - Engagement metrics (views, favorites, reviews)
+  - Shop information
+  - Market positioning data
+  
+  Unlike marketplace-listing-sync-request (private user data), this focuses on:
+  - Broad market trends and pricing analysis
+  - Competitive intelligence and demand signals
+  - Product popularity and sentiment
+  
+  Consumed by worker-analytic-collector for Elasticsearch indexing.
+  Used for market research, pricing optimization, and trend detection.
+  
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    marketplaceIntelligenceEvent(data: types.MarketplaceIntelligenceEventMessage): Promise<JobResponse>;
+    /**
+     * Notifies backend that marketplace description generation completed. Contains generated description with metadata tracking (AI model, confidence, generation timestamp) and suggested price.
      * @param data - The message payload
      * @returns Job response with job ID
      */
@@ -225,6 +246,18 @@ export declare class WorkerClient {
      * @returns Job response with job ID
      */
     marketplaceListingTitleGenerationRequest(data: types.MarketplaceListingTitleGenerationRequestMessage): Promise<JobResponse>;
+    /**
+     * Result of a listing update operation
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    marketplaceListingUpdateCompleted(data: types.MarketplaceListingUpdateCompletedMessage): Promise<JobResponse>;
+    /**
+     * Request to update an existing listing on a marketplace (price, quantity, etc.)
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    marketplaceListingUpdateRequest(data: types.MarketplaceListingUpdateRequestMessage): 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

package/dist/client.js

@@ -232,7 +232,30 @@ export class WorkerClient {
         return this.sendToQueue(types.MessageTypes.MARKETPLACE_CREDENTIAL_ROTATION_REQUEST, data);
     }
     /**
-     * Notifies backend that marketplace description generation completed. Contains generated description with metadata tracking (AI model, confidence, generation timestamp).
+     * Public marketplace intelligence data scraped from external marketplaces.
+  
+  This event contains:
+  - Listing details (title, price, images)
+  - Engagement metrics (views, favorites, reviews)
+  - Shop information
+  - Market positioning data
+  
+  Unlike marketplace-listing-sync-request (private user data), this focuses on:
+  - Broad market trends and pricing analysis
+  - Competitive intelligence and demand signals
+  - Product popularity and sentiment
+  
+  Consumed by worker-analytic-collector for Elasticsearch indexing.
+  Used for market research, pricing optimization, and trend detection.
+  
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async marketplaceIntelligenceEvent(data) {
+        return this.sendToQueue(types.MessageTypes.MARKETPLACE_INTELLIGENCE_EVENT, data);
+    }
+    /**
+     * Notifies backend that marketplace description generation completed. Contains generated description with metadata tracking (AI model, confidence, generation timestamp) and suggested price.
      * @param data - The message payload
      * @returns Job response with job ID
      */
@@ -298,6 +321,22 @@ export class WorkerClient {
     async marketplaceListingTitleGenerationRequest(data) {
         return this.sendToQueue(types.MessageTypes.MARKETPLACE_LISTING_TITLE_GENERATION_REQUEST, data);
     }
+    /**
+     * Result of a listing update operation
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async marketplaceListingUpdateCompleted(data) {
+        return this.sendToQueue(types.MessageTypes.MARKETPLACE_LISTING_UPDATE_COMPLETED, data);
+    }
+    /**
+     * Request to update an existing listing on a marketplace (price, quantity, etc.)
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async marketplaceListingUpdateRequest(data) {
+        return this.sendToQueue(types.MessageTypes.MARKETPLACE_LISTING_UPDATE_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

package/dist/types.d.ts

@@ -19,6 +19,7 @@ export declare const MessageTypes: {
     readonly MARKETPLACE_CONNECTION_SYNC_REQUEST: "marketplace-connection-sync-request";
     readonly MARKETPLACE_CREDENTIAL_ROTATION_COMPLETED: "marketplace-credential-rotation-completed";
     readonly MARKETPLACE_CREDENTIAL_ROTATION_REQUEST: "marketplace-credential-rotation-request";
+    readonly MARKETPLACE_INTELLIGENCE_EVENT: "marketplace-intelligence-event";
     readonly MARKETPLACE_LISTING_DESCRIPTION_GENERATION_COMPLETED: "marketplace-listing-description-generation-completed";
     readonly MARKETPLACE_LISTING_DESCRIPTION_GENERATION_REQUEST: "marketplace-listing-description-generation-request";
     readonly MARKETPLACE_LISTING_SYNC_COMPLETED: "marketplace-listing-sync-completed";
@@ -27,6 +28,8 @@ export declare const MessageTypes: {
     readonly MARKETPLACE_LISTING_TAGS_GENERATION_REQUEST: "marketplace-listing-tags-generation-request";
     readonly MARKETPLACE_LISTING_TITLE_GENERATION_COMPLETED: "marketplace-listing-title-generation-completed";
     readonly MARKETPLACE_LISTING_TITLE_GENERATION_REQUEST: "marketplace-listing-title-generation-request";
+    readonly MARKETPLACE_LISTING_UPDATE_COMPLETED: "marketplace-listing-update-completed";
+    readonly MARKETPLACE_LISTING_UPDATE_REQUEST: "marketplace-listing-update-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";
@@ -487,17 +490,59 @@ export interface MarketplaceCredentialRotationRequestMessage {
     metadata?: Record<string, string | number | boolean>;
 }
 /**
- * Notifies backend that marketplace description generation completed. Contains generated description with metadata tracking (AI model, confidence, generation timestamp).
+ * Public marketplace intelligence data scraped from external marketplaces.
+
+This event contains:
+- Listing details (title, price, images)
+- Engagement metrics (views, favorites, reviews)
+- Shop information
+- Market positioning data
+
+Unlike marketplace-listing-sync-request (private user data), this focuses on:
+- Broad market trends and pricing analysis
+- Competitive intelligence and demand signals
+- Product popularity and sentiment
+
+Consumed by worker-analytic-collector for Elasticsearch indexing.
+Used for market research, pricing optimization, and trend detection.
+
+ */
+export interface MarketplaceIntelligenceEventMessage {
+    /** Source marketplace */
+    marketplace: string;
+    /** Marketplace-native listing ID */
+    externalId: string;
+    /** Core listing information */
+    listing: Record<string, string | number | boolean>;
+    /** Public engagement and sales metrics */
+    metrics?: Record<string, string | number | boolean>;
+    /** Additional listing context and categorization */
+    metadata?: Record<string, string | number | boolean>;
+    /** Search context that found this listing */
+    queryContext?: Record<string, string | number | boolean>;
+    /** ISO 8601 timestamp when data was scraped */
+    collectedAt: string;
+    /** Version of collector that scraped this data */
+    collectorVersion?: string;
+    /** Method used for scraping */
+    scrapingMethod?: string;
+}
+/**
+ * Notifies backend that marketplace description generation completed. Contains generated description with metadata tracking (AI model, confidence, generation timestamp) and suggested price.
  */
 export interface MarketplaceListingDescriptionGenerationCompletedMessage {
     /** UUID of the model that was processed */
     modelId: string;
     /** Type of entity processed */
     entityType: string;
+    /** Target marketplace ID (e.g., 'etsy', 'ebay') */
+    targetMarketplace?: string;
     /** SEO-optimized marketplace description (3-5 sentences) */
     description: string;
     /** Content generation metadata for tracking */
     metadata: Record<string, string | number | boolean>;
+    /** Volume-based price calculation for 3D printed item */
+    suggestedPrice?: Record<string, string | number | boolean>;
     /** Error message if generation failed */
     error?: string;
 }
@@ -525,6 +570,12 @@ export interface MarketplaceListingDescriptionGenerationRequestMessage {
     existingTags?: Array<Record<string, string | number | boolean>>;
     /** Current classification for context */
     existingCategory?: string;
+    /** Desired tone/voice for the listing (e.g., 'professional', 'playful') */
+    brandVoice?: string;
+    /** Target geographic market (e.g., 'US', 'EU') */
+    targetMarket?: string;
+    /** Specific keywords to include */
+    keywords?: Array<Record<string, string | number | boolean>>;
 }
 /**
  * Notification that marketplace listing sync operation has completed. Contains detailed results of the sync including created/updated listings, errors encountered, and performance statistics.
@@ -630,6 +681,12 @@ export interface MarketplaceListingTagsGenerationRequestMessage {
     existingCategory?: string;
     /** Maximum number of tags for marketplace (e.g., 13 for Etsy) */
     tagLimit?: number;
+    /** Target geographic market (e.g., 'US', 'EU') */
+    targetMarket?: string;
+    /** Artistic style of the model (e.g., 'realistic', 'low-poly') */
+    style?: string;
+    /** Intended uses for the model */
+    useCases?: Array<Record<string, string | number | boolean>>;
 }
 /**
  * Notifies backend that marketplace title generation completed. Contains generated title with metadata tracking.
@@ -670,6 +727,40 @@ export interface MarketplaceListingTitleGenerationRequestMessage {
     existingCategory?: string;
     /** Maximum character count for marketplace (e.g., 140 for Etsy) */
     characterLimit?: number;
+    /** Desired tone/voice for the listing (e.g., 'professional', 'playful') */
+    brandVoice?: string;
+    /** Target geographic market (e.g., 'US', 'EU') */
+    targetMarket?: string;
+    /** Specific keywords to include */
+    keywords?: Array<Record<string, string | number | boolean>>;
+}
+/**
+ * Result of a listing update operation
+ */
+export interface MarketplaceListingUpdateCompletedMessage {
+    /** Target marketplace */
+    marketplace?: string;
+    /** External ID of the listing */
+    listingId?: string;
+    /** Status of the update (success, failed) */
+    status?: string;
+    /** Result details from the marketplace API */
+    result?: Record<string, string | number | boolean>;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Request to update an existing listing on a marketplace (price, quantity, etc.)
+ */
+export interface MarketplaceListingUpdateRequestMessage {
+    /** Target marketplace (etsy, ebay, etc.) */
+    marketplace?: string;
+    /** External ID of the listing to update */
+    listingId?: string;
+    /** Fields to update */
+    updates?: Record<string, string | number | boolean>;
+    /** User credentials for the marketplace */
+    credentials?: Record<string, string | number | boolean>;
 }
 /**
  * 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.).

package/dist/types.js

@@ -20,6 +20,7 @@ export const MessageTypes = {
     MARKETPLACE_CONNECTION_SYNC_REQUEST: 'marketplace-connection-sync-request',
     MARKETPLACE_CREDENTIAL_ROTATION_COMPLETED: 'marketplace-credential-rotation-completed',
     MARKETPLACE_CREDENTIAL_ROTATION_REQUEST: 'marketplace-credential-rotation-request',
+    MARKETPLACE_INTELLIGENCE_EVENT: 'marketplace-intelligence-event',
     MARKETPLACE_LISTING_DESCRIPTION_GENERATION_COMPLETED: 'marketplace-listing-description-generation-completed',
     MARKETPLACE_LISTING_DESCRIPTION_GENERATION_REQUEST: 'marketplace-listing-description-generation-request',
     MARKETPLACE_LISTING_SYNC_COMPLETED: 'marketplace-listing-sync-completed',
@@ -28,6 +29,8 @@ export const MessageTypes = {
     MARKETPLACE_LISTING_TAGS_GENERATION_REQUEST: 'marketplace-listing-tags-generation-request',
     MARKETPLACE_LISTING_TITLE_GENERATION_COMPLETED: 'marketplace-listing-title-generation-completed',
     MARKETPLACE_LISTING_TITLE_GENERATION_REQUEST: 'marketplace-listing-title-generation-request',
+    MARKETPLACE_LISTING_UPDATE_COMPLETED: 'marketplace-listing-update-completed',
+    MARKETPLACE_LISTING_UPDATE_REQUEST: 'marketplace-listing-update-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',

package/package.json

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