@mesh-sync/worker-backend-client 4.0.18 → 4.0.21

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.
@@ -647,6 +667,51 @@ 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) and suggested price.
@@ -703,6 +768,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
@@ -836,6 +907,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
@@ -890,6 +967,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
@@ -1821,6 +1946,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.
@@ -1907,6 +2037,24 @@ 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) and suggested price.
 
@@ -1934,6 +2082,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

@@ -37,6 +37,14 @@ export declare class WorkerClient {
      * Get job status by job ID
      */
     getJobStatus(jobId: string): Promise<JobStatus>;
+    /**
+     * Request to trigger a manual market data collection job.
+  Used for ad-hoc scraping of specific queries on marketplaces.
+  
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    analyticsCollectionRequest(data: types.AnalyticsCollectionRequestMessage): 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.
@@ -174,6 +182,27 @@ export declare class WorkerClient {
      * @returns Job response with job ID
      */
     marketplaceCredentialRotationRequest(data: types.MarketplaceCredentialRotationRequestMessage): 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.
+  
+     * @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
@@ -225,6 +254,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

@@ -60,6 +60,16 @@ export class WorkerClient {
         }
         return await response.json();
     }
+    /**
+     * Request to trigger a manual market data collection job.
+  Used for ad-hoc scraping of specific queries on marketplaces.
+  
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async analyticsCollectionRequest(data) {
+        return this.sendToQueue(types.MessageTypes.ANALYTICS_COLLECTION_REQUEST, data);
+    }
     /**
      * 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.
@@ -231,6 +241,29 @@ export class WorkerClient {
     async marketplaceCredentialRotationRequest(data) {
         return this.sendToQueue(types.MessageTypes.MARKETPLACE_CREDENTIAL_ROTATION_REQUEST, data);
     }
+    /**
+     * 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
@@ -298,6 +331,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

@@ -2,6 +2,7 @@
  * Message type constants
  */
 export declare const MessageTypes: {
+    readonly ANALYTICS_COLLECTION_REQUEST: "analytics-collection-request";
     readonly BACKEND_LOGGING_EVENT: "backend-logging-event";
     readonly EKG_EDGE_BATCH_CREATE_COMPLETED: "ekg-edge-batch-create-completed";
     readonly EKG_EDGE_BATCH_CREATE_REQUEST: "ekg-edge-batch-create-request";
@@ -19,6 +20,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 +29,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";
@@ -58,6 +62,19 @@ export declare const MessageTypes: {
     readonly WORKER_METRICS_ENRICHED_EVENT: "worker-metrics-enriched-event";
 };
 export type MessageType = typeof MessageTypes[keyof typeof MessageTypes];
+/**
+ * Request to trigger a manual market data collection job.
+Used for ad-hoc scraping of specific queries on marketplaces.
+
+ */
+export interface AnalyticsCollectionRequestMessage {
+    /** The marketplace to scrape (etsy, ebay, etc.) */
+    marketplace?: string;
+    /** The search query to use */
+    query: string;
+    /** Collection options (pages, filters, etc.) */
+    options?: Record<string, string | number | boolean>;
+}
 /**
  * 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.
@@ -486,6 +503,44 @@ export interface MarketplaceCredentialRotationRequestMessage {
     /** Additional request context */
     metadata?: Record<string, string | number | boolean>;
 }
+/**
+ * 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.
  */
@@ -529,6 +584,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.
@@ -634,6 +695,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.
@@ -674,6 +741,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

@@ -3,6 +3,7 @@
  * Message type constants
  */
 export const MessageTypes = {
+    ANALYTICS_COLLECTION_REQUEST: 'analytics-collection-request',
     BACKEND_LOGGING_EVENT: 'backend-logging-event',
     EKG_EDGE_BATCH_CREATE_COMPLETED: 'ekg-edge-batch-create-completed',
     EKG_EDGE_BATCH_CREATE_REQUEST: 'ekg-edge-batch-create-request',
@@ -20,6 +21,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 +30,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.18",
+  "version": "4.0.21",
   "description": "Auto-generated TypeScript client for worker-backend - provides type-safe methods for enqueueing jobs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",