@mesh-sync/worker-backend-client 1.0.0

package/README.md

@@ -0,0 +1,349 @@
+# Worker Backend Client (TypeScript)
+
+Auto-generated TypeScript client library for the Mesh-Sync worker-backend.
+
+## Installation
+
+### From npm (public registry)
+
+```bash
+npm install @mesh-sync/worker-backend-client
+```
+
+### From GitHub Packages (Recommended for Private Access)
+
+GitHub Packages provides package hosting with access control based on repository permissions.
+
+**Prerequisites:**
+- GitHub Personal Access Token (PAT) with `read:packages` scope
+- Repository access (for private packages)
+
+**Installation Steps:**
+
+1. Create or update your `.npmrc` file in your project root:
+
+```ini
+@mesh-sync:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
+```
+
+2. Set your GitHub token as an environment variable:
+
+```bash
+export GITHUB_TOKEN=your_github_personal_access_token
+```
+
+3. Install the package:
+
+```bash
+npm install @mesh-sync/worker-backend-client
+```
+
+**Access Control:** Only users with read access to the repository can install private packages from GitHub Packages.
+
+**Generate GitHub PAT:**
+1. Go to GitHub Settings → Developer settings → Personal access tokens → Tokens (classic)
+2. Generate new token with `read:packages` scope
+3. Copy the token and use it as `GITHUB_TOKEN`
+
+### From a private npm registry
+
+If you're using a private npm registry, configure your `.npmrc`:
+
+```
+@mesh-sync:registry=https://your-registry.example.com
+//your-registry.example.com/:_authToken=${NPM_TOKEN}
+```
+
+## Usage
+
+### Basic Example
+
+```typescript
+import { WorkerClient } from '@mesh-sync/worker-backend-client';
+
+const client = new WorkerClient({
+  baseUrl: 'http://localhost:3000',
+  apiKey: process.env.API_KEY, // Optional
+  timeout: 30000 // Optional, default 30s
+});
+
+// Type-safe method call
+const job = await client.fileDownloadRequest({
+  url: 'https://example.com/file.pdf',
+  destination: '/downloads/file.pdf'
+});
+
+console.log(`Job created: ${job.jobId}`);
+
+// Check job status
+const status = await client.getJobStatus(job.jobId);
+console.log(`Job state: ${status.state}`);
+```
+
+### Using Message Type Constants
+
+```typescript
+import { WorkerClient, MessageTypes } from '@mesh-sync/worker-backend-client';
+
+const client = new WorkerClient({
+  baseUrl: 'http://localhost:3000'
+});
+
+// Dynamic message type
+await client.sendToQueue(MessageTypes.FILE_DOWNLOAD_REQUEST, {
+  url: 'https://example.com/file.pdf',
+  destination: '/downloads/file.pdf'
+});
+```
+
+## Available Message Types
+
+### file-download-request
+
+**Description:** Handles file download requests.
+
+**Method:** `client.fileDownloadRequest(data)`
+
+**Payload Type:** `FileDownloadRequestMessage`
+
+**Fields:**
+- `modelId` (string) [✓]: The unique identifier for the model to be downloaded.
+- `storageLocation` (object) [✓]: The storage location of the model.
+
+### model-discovery-folder-processed-event
+
+**Description:** Handles model discovery folder processed events.
+
+**Method:** `client.modelDiscoveryFolderProcessedEvent(data)`
+
+**Payload Type:** `ModelDiscoveryFolderProcessedEventMessage`
+
+**Fields:**
+- `connectionId` (string) [✓]: The unique identifier for the connection.
+- `folderPath` (string) [✓]: The path to the processed folder.
+- `discoveredFiles` (array) [✓]: A list of files discovered in the folder.
+- `folderSignature` (object) [✗]: A signature representing the state of the folder.
+- `processedAt` (string) [✓]: The timestamp when the folder was processed.
+- `statistics` (object) [✓]: Statistics about the processed folder.
+
+### model-discovery-scan-found-event
+
+**Description:** Handles model discovery scan found events.
+
+**Method:** `client.modelDiscoveryScanFoundEvent(data)`
+
+**Payload Type:** `ModelDiscoveryScanFoundEventMessage`
+
+**Fields:**
+- `modelId` (string) [✓]: The unique identifier for the model.
+- `name` (string) [✓]: The name of the model.
+- `fileName` (string) [✓]: The name of the model file.
+- `description` (string) [✓]: A description of the model.
+- `fileTypes` (array) [✓]: An array of file types associated with the model.
+- `size` (number) [✓]: The size of the model file in bytes.
+- `storageLocation` (object) [✓]: The storage location of the model.
+- `providerType` (string) [✓]: The type of the storage provider.
+- `metadata` (object) [✓]: A flexible object for additional metadata.
+
+### model-discovery-scan-progress-event
+
+**Description:** Handles model discovery scan progress events.
+
+**Method:** `client.modelDiscoveryScanProgressEvent(data)`
+
+**Payload Type:** `ModelDiscoveryScanProgressEventMessage`
+
+**Fields:**
+- `payload` (object) [✓]: Contains the discovery scan progress details.
+
+### model-discovery-scan-request
+
+**Description:** Handles model discovery scan requests events.
+
+**Method:** `client.modelDiscoveryScanRequest(data)`
+
+**Payload Type:** `ModelDiscoveryScanRequestMessage`
+
+**Fields:**
+- `libraryId` (string) [✓]: The ID of the library to scan.
+
+### model-metadata-generation-completed
+
+**Description:** Handles model metadata generation completed.
+
+**Method:** `client.modelMetadataGenerationCompleted(data)`
+
+**Payload Type:** `ModelMetadataGenerationCompletedMessage`
+
+**Fields:**
+- `modelId` (string) [✗]: The unique identifier for the model.
+- `metadata` (object) [✓]: The enriched metadata for the model.
+
+### model-metadata-generation-request
+
+**Description:** Handles model metadata generation requests.
+
+**Method:** `client.modelMetadataGenerationRequest(data)`
+
+**Payload Type:** `ModelMetadataGenerationRequestMessage`
+
+**Fields:**
+- `modelId` (string) [✓]: The unique identifier for the model.
+- `storageConnectionId` (string) [✓]: The ID of the storage connection.
+- `filePath` (string) [✓]: The path to the model file.
+- `fileName` (string) [✓]: The name of the model file.
+- `fileSize` (number) [✓]: The size of the model file in bytes.
+- `fileLastModified` (string) [✓]: The last modified date of the model file.
+- `storageProviderType` (string) [✓]: The type of the storage provider.
+- `modelThumbnailUrl` (string) [✗]: The URL of the model thumbnail.
+- `metamodel` (object) [✗]: The metamodel of the model.
+
+### model-metamodel-detection-found
+
+**Description:** Handles model metamodel detection found.
+
+**Method:** `client.modelMetamodelDetectionFound(data)`
+
+**Payload Type:** `ModelMetamodelDetectionFoundMessage`
+
+**Fields:**
+- `suggestions` (array) [✗]: List of metamodel suggestions.
+
+### model-metamodel-detection-request
+
+**Description:** Handles model metamodel detection requests.
+
+**Method:** `client.modelMetamodelDetectionRequest(data)`
+
+**Payload Type:** `ModelMetamodelDetectionRequestMessage`
+
+**Fields:**
+- `connectionId` (string) [✗]: The unique identifier for the storage connection.
+- `folderPath` (string) [✗]: The path to the folder that was processed.
+- `discoveredFiles` (array) [✗]: A list of files discovered in the folder.
+- `folderSignature` (object) [✓]: A signature representing the state of the folder.
+- `processedAt` (string) [✗]: The timestamp when the folder was processed.
+- `statistics` (object) [✓]: Statistics about the processed folder.
+
+### thumbnail-generation-completed
+
+**Description:** Handles thumbnail generation completed.
+
+**Method:** `client.thumbnailGenerationCompleted(data)`
+
+**Payload Type:** `ThumbnailGenerationCompletedMessage`
+
+**Fields:**
+- `originalJobId` (string) [✓]: The ID of the original job that requested the thumbnail generation.
+- `modelId` (string) [✓]: The ID of the model that the thumbnail was generated for.
+- `status` (string) [✓]: The status of the thumbnail generation.
+- `thumbnailPath` (string) [✗]: The path to the generated thumbnail.
+- `errorMessage` (string) [✗]: An error message if the thumbnail generation failed.
+- `storageLocation` (object) [✓]: The storage location of the model.
+
+### thumbnail-generation-request
+
+**Description:** Handles thumbnail generation requests.
+
+**Method:** `client.thumbnailGenerationRequest(data)`
+
+**Payload Type:** `ThumbnailGenerationRequestMessage`
+
+**Fields:**
+- `modelId` (string) [✓]: The unique identifier for the model requiring a thumbnail.
+- `ownerId` (string) [✓]: The identifier of the user who owns the entity.
+- `storageLocation` (object) [✓]: The storage location of the model.
+- `previewType` (string) [✓]: The type of preview to generate, e.g., 'default', 'static', 'glb'.
+
+## Configuration
+
+### Environment Variables
+
+- `WORKER_BACKEND_URL`: Base URL of the worker backend
+- `WORKER_BACKEND_API_KEY`: Optional API key for authentication
+- `GITHUB_TOKEN`: GitHub personal access token (for GitHub Packages installation)
+- `NPM_TOKEN`: npm token (for private registry installation)
+
+### Worker Client Options
+
+```typescript
+interface WorkerClientConfig {
+  baseUrl: string;        // Required: Worker backend URL
+  apiKey?: string;        // Optional: API key for authentication
+  timeout?: number;       // Optional: Request timeout in ms (default: 30000)
+}
+```
+
+## API Reference
+
+### `WorkerClient`
+
+#### Constructor
+
+```typescript
+new WorkerClient(config: WorkerClientConfig)
+```
+
+#### Methods
+
+- `sendToQueue(messageType: MessageType, payload: any): Promise<JobResponse>`
+  - Send a job to the queue with the specified message type
+  
+- `getJobStatus(jobId: string): Promise<JobStatus>`
+  - Get the current status of a job
+
+- `fileDownloadRequest(data: FileDownloadRequestMessage): Promise<JobResponse>`
+  - Handles file download requests.
+- `modelDiscoveryFolderProcessedEvent(data: ModelDiscoveryFolderProcessedEventMessage): Promise<JobResponse>`
+  - Handles model discovery folder processed events.
+- `modelDiscoveryScanFoundEvent(data: ModelDiscoveryScanFoundEventMessage): Promise<JobResponse>`
+  - Handles model discovery scan found events.
+- `modelDiscoveryScanProgressEvent(data: ModelDiscoveryScanProgressEventMessage): Promise<JobResponse>`
+  - Handles model discovery scan progress events.
+- `modelDiscoveryScanRequest(data: ModelDiscoveryScanRequestMessage): Promise<JobResponse>`
+  - Handles model discovery scan requests events.
+- `modelMetadataGenerationCompleted(data: ModelMetadataGenerationCompletedMessage): Promise<JobResponse>`
+  - Handles model metadata generation completed.
+- `modelMetadataGenerationRequest(data: ModelMetadataGenerationRequestMessage): Promise<JobResponse>`
+  - Handles model metadata generation requests.
+- `modelMetamodelDetectionFound(data: ModelMetamodelDetectionFoundMessage): Promise<JobResponse>`
+  - Handles model metamodel detection found.
+- `modelMetamodelDetectionRequest(data: ModelMetamodelDetectionRequestMessage): Promise<JobResponse>`
+  - Handles model metamodel detection requests.
+- `thumbnailGenerationCompleted(data: ThumbnailGenerationCompletedMessage): Promise<JobResponse>`
+  - Handles thumbnail generation completed.
+- `thumbnailGenerationRequest(data: ThumbnailGenerationRequestMessage): Promise<JobResponse>`
+  - Handles thumbnail generation requests.
+
+### Response Types
+
+#### `JobResponse`
+
+```typescript
+interface JobResponse {
+  success: boolean;
+  jobId: string;
+  messageName: string;
+  queue: string;
+}
+```
+
+#### `JobStatus`
+
+```typescript
+interface JobStatus {
+  jobId: string;
+  name: string;
+  queue: string;
+  state: 'waiting' | 'active' | 'completed' | 'failed' | 'delayed';
+  data: any;
+  returnvalue?: any;
+  progress?: number;
+  timestamp: number;
+}
+```
+
+## License
+
+ISC

package/dist/client.d.ts

@@ -0,0 +1,106 @@
+import * as types from './types.js';
+export interface WorkerClientConfig {
+    baseUrl: string;
+    apiKey?: string;
+    timeout?: number;
+}
+export interface JobResponse {
+    success: boolean;
+    jobId: string;
+    messageName: string;
+    queue: string;
+}
+export interface JobStatus {
+    jobId: string;
+    name: string;
+    queue: string;
+    state: 'waiting' | 'active' | 'completed' | 'failed' | 'delayed';
+    data: any;
+    returnvalue?: any;
+    progress?: number;
+    timestamp: number;
+}
+/**
+ * HTTP-based client for worker-backend
+ * Provides methods to enqueue jobs and check job status
+ */
+export declare class WorkerClient {
+    private baseUrl;
+    private apiKey?;
+    private timeout;
+    constructor(config: WorkerClientConfig);
+    /**
+     * Send a job to the queue
+     */
+    sendToQueue(messageType: types.MessageType, payload: any): Promise<JobResponse>;
+    /**
+     * Get job status by job ID
+     */
+    getJobStatus(jobId: string): Promise<JobStatus>;
+    /**
+     * Handles file download requests.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    fileDownloadRequest(data: types.FileDownloadRequestMessage): Promise<JobResponse>;
+    /**
+     * Handles model discovery folder processed events.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    modelDiscoveryFolderProcessedEvent(data: types.ModelDiscoveryFolderProcessedEventMessage): Promise<JobResponse>;
+    /**
+     * Handles model discovery scan found events.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    modelDiscoveryScanFoundEvent(data: types.ModelDiscoveryScanFoundEventMessage): Promise<JobResponse>;
+    /**
+     * Handles model discovery scan progress events.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    modelDiscoveryScanProgressEvent(data: types.ModelDiscoveryScanProgressEventMessage): Promise<JobResponse>;
+    /**
+     * Handles model discovery scan requests events.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    modelDiscoveryScanRequest(data: types.ModelDiscoveryScanRequestMessage): Promise<JobResponse>;
+    /**
+     * Handles model metadata generation completed.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    modelMetadataGenerationCompleted(data: types.ModelMetadataGenerationCompletedMessage): Promise<JobResponse>;
+    /**
+     * Handles model metadata generation requests.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    modelMetadataGenerationRequest(data: types.ModelMetadataGenerationRequestMessage): Promise<JobResponse>;
+    /**
+     * Handles model metamodel detection found.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    modelMetamodelDetectionFound(data: types.ModelMetamodelDetectionFoundMessage): Promise<JobResponse>;
+    /**
+     * Handles model metamodel detection requests.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    modelMetamodelDetectionRequest(data: types.ModelMetamodelDetectionRequestMessage): Promise<JobResponse>;
+    /**
+     * Handles thumbnail generation completed.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    thumbnailGenerationCompleted(data: types.ThumbnailGenerationCompletedMessage): Promise<JobResponse>;
+    /**
+     * Handles thumbnail generation requests.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    thumbnailGenerationRequest(data: types.ThumbnailGenerationRequestMessage): Promise<JobResponse>;
+}

package/dist/client.js

@@ -0,0 +1,151 @@
+import * as types from './types.js';
+/**
+ * HTTP-based client for worker-backend
+ * Provides methods to enqueue jobs and check job status
+ */
+export class WorkerClient {
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/$/, '');
+        this.apiKey = config.apiKey;
+        this.timeout = config.timeout || 30000;
+    }
+    /**
+     * Send a job to the queue
+     */
+    async sendToQueue(messageType, payload) {
+        const url = `${this.baseUrl}/api/jobs/${messageType}`;
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (this.apiKey) {
+            headers['Authorization'] = `Bearer ${this.apiKey}`;
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(payload),
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const error = await response.json().catch(() => ({ error: response.statusText }));
+                throw new Error(`HTTP ${response.status}: ${error.error || error.message || response.statusText}`);
+            }
+            return await response.json();
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new Error('Request timeout');
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get job status by job ID
+     */
+    async getJobStatus(jobId) {
+        const url = `${this.baseUrl}/api/jobs/${jobId}`;
+        const headers = {};
+        if (this.apiKey) {
+            headers['Authorization'] = `Bearer ${this.apiKey}`;
+        }
+        const response = await fetch(url, { headers });
+        if (!response.ok) {
+            const error = await response.json().catch(() => ({ error: response.statusText }));
+            throw new Error(`HTTP ${response.status}: ${error.error || error.message || response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Handles file download requests.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async fileDownloadRequest(data) {
+        return this.sendToQueue(types.MessageTypes.FILE_DOWNLOAD_REQUEST, data);
+    }
+    /**
+     * Handles model discovery folder processed events.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async modelDiscoveryFolderProcessedEvent(data) {
+        return this.sendToQueue(types.MessageTypes.MODEL_DISCOVERY_FOLDER_PROCESSED_EVENT, data);
+    }
+    /**
+     * Handles model discovery scan found events.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async modelDiscoveryScanFoundEvent(data) {
+        return this.sendToQueue(types.MessageTypes.MODEL_DISCOVERY_SCAN_FOUND_EVENT, data);
+    }
+    /**
+     * Handles model discovery scan progress events.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async modelDiscoveryScanProgressEvent(data) {
+        return this.sendToQueue(types.MessageTypes.MODEL_DISCOVERY_SCAN_PROGRESS_EVENT, data);
+    }
+    /**
+     * Handles model discovery scan requests events.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async modelDiscoveryScanRequest(data) {
+        return this.sendToQueue(types.MessageTypes.MODEL_DISCOVERY_SCAN_REQUEST, data);
+    }
+    /**
+     * Handles model metadata generation completed.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async modelMetadataGenerationCompleted(data) {
+        return this.sendToQueue(types.MessageTypes.MODEL_METADATA_GENERATION_COMPLETED, data);
+    }
+    /**
+     * Handles model metadata generation requests.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async modelMetadataGenerationRequest(data) {
+        return this.sendToQueue(types.MessageTypes.MODEL_METADATA_GENERATION_REQUEST, data);
+    }
+    /**
+     * Handles model metamodel detection found.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async modelMetamodelDetectionFound(data) {
+        return this.sendToQueue(types.MessageTypes.MODEL_METAMODEL_DETECTION_FOUND, data);
+    }
+    /**
+     * Handles model metamodel detection requests.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async modelMetamodelDetectionRequest(data) {
+        return this.sendToQueue(types.MessageTypes.MODEL_METAMODEL_DETECTION_REQUEST, data);
+    }
+    /**
+     * Handles thumbnail generation completed.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async thumbnailGenerationCompleted(data) {
+        return this.sendToQueue(types.MessageTypes.THUMBNAIL_GENERATION_COMPLETED, data);
+    }
+    /**
+     * Handles thumbnail generation requests.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async thumbnailGenerationRequest(data) {
+        return this.sendToQueue(types.MessageTypes.THUMBNAIL_GENERATION_REQUEST, data);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types.js';
+export * from './client.js';

package/dist/index.js

@@ -0,0 +1,3 @@
+// Auto-generated exports
+export * from './types.js';
+export * from './client.js';

package/dist/types.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Message type constants
+ */
+export declare const MessageTypes: {
+    readonly FILE_DOWNLOAD_REQUEST: "file-download-request";
+    readonly MODEL_DISCOVERY_FOLDER_PROCESSED_EVENT: "model-discovery-folder-processed-event";
+    readonly MODEL_DISCOVERY_SCAN_FOUND_EVENT: "model-discovery-scan-found-event";
+    readonly MODEL_DISCOVERY_SCAN_PROGRESS_EVENT: "model-discovery-scan-progress-event";
+    readonly MODEL_DISCOVERY_SCAN_REQUEST: "model-discovery-scan-request";
+    readonly MODEL_METADATA_GENERATION_COMPLETED: "model-metadata-generation-completed";
+    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 THUMBNAIL_GENERATION_COMPLETED: "thumbnail-generation-completed";
+    readonly THUMBNAIL_GENERATION_REQUEST: "thumbnail-generation-request";
+};
+export type MessageType = typeof MessageTypes[keyof typeof MessageTypes];
+/**
+ * Handles file download requests.
+ */
+export interface FileDownloadRequestMessage {
+    /** The unique identifier for the model to be downloaded. */
+    modelId: string;
+    /** The storage location of the model. */
+    storageLocation: Record<string, any>;
+}
+/**
+ * Handles model discovery folder processed events.
+ */
+export interface ModelDiscoveryFolderProcessedEventMessage {
+    /** The unique identifier for the connection. */
+    connectionId: string;
+    /** The path to the processed folder. */
+    folderPath: string;
+    /** A list of files discovered in the folder. */
+    discoveredFiles: any[];
+    /** A signature representing the state of the folder. */
+    folderSignature?: Record<string, any>;
+    /** The timestamp when the folder was processed. */
+    processedAt: string;
+    /** Statistics about the processed folder. */
+    statistics: Record<string, any>;
+}
+/**
+ * Handles model discovery scan found events.
+ */
+export interface ModelDiscoveryScanFoundEventMessage {
+    /** The unique identifier for the model. */
+    modelId: string;
+    /** The name of the model. */
+    name: string;
+    /** The name of the model file. */
+    fileName: string;
+    /** A description of the model. */
+    description: string;
+    /** An array of file types associated with the model. */
+    fileTypes: any[];
+    /** The size of the model file in bytes. */
+    size: number;
+    /** The storage location of the model. */
+    storageLocation: Record<string, any>;
+    /** The type of the storage provider. */
+    providerType: string;
+    /** A flexible object for additional metadata. */
+    metadata: Record<string, any>;
+}
+/**
+ * Handles model discovery scan progress events.
+ */
+export interface ModelDiscoveryScanProgressEventMessage {
+    /** Contains the discovery scan progress details. */
+    payload: Record<string, any>;
+}
+/**
+ * Handles model discovery scan requests events.
+ */
+export interface ModelDiscoveryScanRequestMessage {
+    /** The ID of the library to scan. */
+    libraryId: string;
+}
+/**
+ * Handles model metadata generation completed.
+ */
+export interface ModelMetadataGenerationCompletedMessage {
+    /** The unique identifier for the model. */
+    modelId?: string;
+    /** The enriched metadata for the model. */
+    metadata: Record<string, any>;
+}
+/**
+ * Handles model metadata generation requests.
+ */
+export interface ModelMetadataGenerationRequestMessage {
+    /** The unique identifier for the model. */
+    modelId: string;
+    /** The ID of the storage connection. */
+    storageConnectionId: string;
+    /** The path to the model file. */
+    filePath: string;
+    /** The name of the model file. */
+    fileName: string;
+    /** The size of the model file in bytes. */
+    fileSize: number;
+    /** The last modified date of the model file. */
+    fileLastModified: string;
+    /** The type of the storage provider. */
+    storageProviderType: string;
+    /** The URL of the model thumbnail. */
+    modelThumbnailUrl?: string;
+    /** The metamodel of the model. */
+    metamodel?: Record<string, any>;
+}
+/**
+ * Handles model metamodel detection found.
+ */
+export interface ModelMetamodelDetectionFoundMessage {
+    /** List of metamodel suggestions. */
+    suggestions?: any[];
+}
+/**
+ * Handles model metamodel detection requests.
+ */
+export interface ModelMetamodelDetectionRequestMessage {
+    /** The unique identifier for the storage connection. */
+    connectionId?: string;
+    /** The path to the folder that was processed. */
+    folderPath?: string;
+    /** A list of files discovered in the folder. */
+    discoveredFiles?: any[];
+    /** A signature representing the state of the folder. */
+    folderSignature: Record<string, any>;
+    /** The timestamp when the folder was processed. */
+    processedAt?: string;
+    /** Statistics about the processed folder. */
+    statistics: Record<string, any>;
+}
+/**
+ * Handles thumbnail generation completed.
+ */
+export interface ThumbnailGenerationCompletedMessage {
+    /** The ID of the original job that requested the thumbnail generation. */
+    originalJobId: string;
+    /** The ID of the model that the thumbnail was generated for. */
+    modelId: string;
+    /** The status of the thumbnail generation. */
+    status: string;
+    /** The path to the generated thumbnail. */
+    thumbnailPath?: string;
+    /** An error message if the thumbnail generation failed. */
+    errorMessage?: string;
+    /** The storage location of the model. */
+    storageLocation: Record<string, any>;
+}
+/**
+ * Handles thumbnail generation requests.
+ */
+export interface ThumbnailGenerationRequestMessage {
+    /** The unique identifier for the model requiring a thumbnail. */
+    modelId: string;
+    /** The identifier of the user who owns the entity. */
+    ownerId: string;
+    /** The storage location of the model. */
+    storageLocation: Record<string, any>;
+    /** The type of preview to generate, e.g., 'default', 'static', 'glb'. */
+    previewType: string;
+}

package/dist/types.js

@@ -0,0 +1,17 @@
+// Auto-generated message types
+/**
+ * Message type constants
+ */
+export const MessageTypes = {
+    FILE_DOWNLOAD_REQUEST: 'file-download-request',
+    MODEL_DISCOVERY_FOLDER_PROCESSED_EVENT: 'model-discovery-folder-processed-event',
+    MODEL_DISCOVERY_SCAN_FOUND_EVENT: 'model-discovery-scan-found-event',
+    MODEL_DISCOVERY_SCAN_PROGRESS_EVENT: 'model-discovery-scan-progress-event',
+    MODEL_DISCOVERY_SCAN_REQUEST: 'model-discovery-scan-request',
+    MODEL_METADATA_GENERATION_COMPLETED: 'model-metadata-generation-completed',
+    MODEL_METADATA_GENERATION_REQUEST: 'model-metadata-generation-request',
+    MODEL_METAMODEL_DETECTION_FOUND: 'model-metamodel-detection-found',
+    MODEL_METAMODEL_DETECTION_REQUEST: 'model-metamodel-detection-request',
+    THUMBNAIL_GENERATION_COMPLETED: 'thumbnail-generation-completed',
+    THUMBNAIL_GENERATION_REQUEST: 'thumbnail-generation-request',
+};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@mesh-sync/worker-backend-client",
+  "version": "1.0.0",
+  "description": "Auto-generated TypeScript client for worker-backend - provides type-safe methods for enqueueing jobs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "worker",
+    "job-queue",
+    "bullmq",
+    "client",
+    "typescript",
+    "mesh-sync"
+  ],
+  "author": "Mesh-Sync",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Mesh-Sync/worker-backend.git",
+    "directory": "generated/typescript"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {}
+}