@things-factory/integration-label-studio 9.1.19

package/dist-server/utils/label-studio-api-client.js

@@ -0,0 +1,401 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.labelStudioApi = exports.LabelStudioApiClient = void 0;
+const tslib_1 = require("tslib");
+const axios_1 = tslib_1.__importDefault(require("axios"));
+const env_1 = require("@things-factory/env");
+/**
+ * Label Studio API Client
+ * Provides methods to interact with Label Studio REST API
+ */
+class LabelStudioApiClient {
+    constructor() {
+        this.client = null;
+        this.serverUrl = null;
+        this.apiToken = null;
+        // Defer initialization until first use
+    }
+    ensureInitialized() {
+        if (this.client) {
+            return;
+        }
+        const labelStudioConfig = env_1.config.get('labelStudio', {});
+        this.serverUrl = labelStudioConfig.serverUrl || 'http://localhost:8080';
+        this.apiToken = labelStudioConfig.apiToken || '';
+        this.client = axios_1.default.create({
+            baseURL: this.serverUrl,
+            headers: {
+                Authorization: `Token ${this.apiToken}`,
+                'Content-Type': 'application/json'
+            },
+            timeout: 30000
+        });
+    }
+    // ============================================================================
+    // Project Methods
+    // ============================================================================
+    /**
+     * Get all projects
+     */
+    async getProjects() {
+        this.ensureInitialized();
+        const response = await this.client.get('/api/projects');
+        return response.data.results || response.data;
+    }
+    /**
+     * Get project by ID
+     */
+    async getProject(projectId) {
+        this.ensureInitialized();
+        const response = await this.client.get(`/api/projects/${projectId}`);
+        return response.data;
+    }
+    /**
+     * Create new project
+     */
+    async createProject(data) {
+        this.ensureInitialized();
+        const response = await this.client.post('/api/projects', data);
+        return response.data;
+    }
+    /**
+     * Update project
+     */
+    async updateProject(projectId, data) {
+        this.ensureInitialized();
+        const response = await this.client.patch(`/api/projects/${projectId}`, data);
+        return response.data;
+    }
+    /**
+     * Delete project
+     */
+    async deleteProject(projectId) {
+        this.ensureInitialized();
+        await this.client.delete(`/api/projects/${projectId}`);
+    }
+    // ============================================================================
+    // Task Methods
+    // ============================================================================
+    /**
+     * Get tasks for a project
+     */
+    async getTasks(projectId, params) {
+        this.ensureInitialized();
+        const response = await this.client.get(`/api/projects/${projectId}/tasks`, { params });
+        return response.data;
+    }
+    /**
+     * Get single task
+     */
+    async getTask(taskId) {
+        this.ensureInitialized();
+        const response = await this.client.get(`/api/tasks/${taskId}`);
+        return response.data;
+    }
+    /**
+     * Create task
+     */
+    async createTask(projectId, data) {
+        this.ensureInitialized();
+        const response = await this.client.post(`/api/projects/${projectId}/tasks`, data);
+        return response.data;
+    }
+    /**
+     * Import tasks in bulk
+     */
+    async importTasks(projectId, tasks) {
+        this.ensureInitialized();
+        const response = await this.client.post(`/api/projects/${projectId}/import`, tasks, {
+            headers: {
+                'Content-Type': 'application/json'
+            }
+        });
+        return response.data;
+    }
+    /**
+     * Delete task
+     */
+    async deleteTask(taskId) {
+        this.ensureInitialized();
+        await this.client.delete(`/api/tasks/${taskId}`);
+    }
+    // ============================================================================
+    // Annotation Methods
+    // ============================================================================
+    /**
+     * Get annotations for a task
+     */
+    async getAnnotations(taskId) {
+        this.ensureInitialized();
+        const response = await this.client.get(`/api/tasks/${taskId}/annotations`);
+        return response.data;
+    }
+    /**
+     * Create annotation
+     */
+    async createAnnotation(taskId, annotation) {
+        this.ensureInitialized();
+        const response = await this.client.post(`/api/tasks/${taskId}/annotations`, annotation);
+        return response.data;
+    }
+    /**
+     * Update annotation
+     */
+    async updateAnnotation(annotationId, data) {
+        this.ensureInitialized();
+        const response = await this.client.patch(`/api/annotations/${annotationId}`, data);
+        return response.data;
+    }
+    /**
+     * Delete annotation
+     */
+    async deleteAnnotation(annotationId) {
+        this.ensureInitialized();
+        await this.client.delete(`/api/annotations/${annotationId}`);
+    }
+    // ============================================================================
+    // Prediction Methods
+    // ============================================================================
+    /**
+     * Get all predictions for a task
+     */
+    async getPredictions(taskId) {
+        this.ensureInitialized();
+        const response = await this.client.get('/api/predictions', {
+            params: { task: taskId }
+        });
+        return response.data.results || response.data;
+    }
+    /**
+     * Get predictions for a project
+     */
+    async getProjectPredictions(projectId) {
+        this.ensureInitialized();
+        const response = await this.client.get('/api/predictions', {
+            params: { project: projectId }
+        });
+        return response.data.results || response.data;
+    }
+    /**
+     * Get single prediction by ID
+     */
+    async getPrediction(predictionId) {
+        this.ensureInitialized();
+        const response = await this.client.get(`/api/predictions/${predictionId}`);
+        return response.data;
+    }
+    /**
+     * Create a prediction for a task
+     */
+    async createPrediction(data) {
+        this.ensureInitialized();
+        const response = await this.client.post('/api/predictions', data);
+        return response.data;
+    }
+    /**
+     * Create predictions in bulk
+     */
+    async createPredictions(predictions) {
+        this.ensureInitialized();
+        const results = await Promise.all(predictions.map(prediction => this.createPrediction(prediction)));
+        return {
+            created: results.length,
+            predictions: results
+        };
+    }
+    /**
+     * Update prediction
+     */
+    async updatePrediction(predictionId, data) {
+        this.ensureInitialized();
+        const response = await this.client.patch(`/api/predictions/${predictionId}`, data);
+        return response.data;
+    }
+    /**
+     * Delete prediction
+     */
+    async deletePrediction(predictionId) {
+        this.ensureInitialized();
+        await this.client.delete(`/api/predictions/${predictionId}`);
+    }
+    /**
+     * Import predictions for a project
+     * This is useful for bulk importing AI model predictions
+     */
+    async importPredictions(projectId, predictions) {
+        this.ensureInitialized();
+        const response = await this.client.post(`/api/projects/${projectId}/import/predictions`, predictions);
+        return response.data;
+    }
+    // ============================================================================
+    // Export Methods
+    // ============================================================================
+    /**
+     * Export annotations
+     */
+    async exportAnnotations(projectId, format = 'JSON') {
+        this.ensureInitialized();
+        const response = await this.client.get(`/api/projects/${projectId}/export`, {
+            params: { exportType: format }
+        });
+        return response.data;
+    }
+    /**
+     * Get export files
+     */
+    async getExportFiles(projectId) {
+        this.ensureInitialized();
+        const response = await this.client.get(`/api/projects/${projectId}/exports`);
+        return response.data;
+    }
+    // ============================================================================
+    // ML Backend Methods
+    // ============================================================================
+    /**
+     * Get ML backends for project
+     */
+    async getMLBackends(projectId) {
+        this.ensureInitialized();
+        const response = await this.client.get(`/api/ml`, {
+            params: { project: projectId }
+        });
+        return response.data.results || response.data;
+    }
+    /**
+     * Add ML backend to project
+     */
+    async addMLBackend(data) {
+        this.ensureInitialized();
+        const response = await this.client.post('/api/ml', data);
+        return response.data;
+    }
+    /**
+     * Delete ML backend
+     */
+    async deleteMLBackend(mlBackendId) {
+        this.ensureInitialized();
+        await this.client.delete(`/api/ml/${mlBackendId}`);
+    }
+    /**
+     * Trigger predictions for tasks
+     */
+    async triggerPredictions(projectId, taskIds) {
+        this.ensureInitialized();
+        const payload = taskIds ? { task_ids: taskIds } : {};
+        const response = await this.client.post(`/api/projects/${projectId}/predict`, payload);
+        return response.data;
+    }
+    /**
+     * Train ML model
+     */
+    async trainModel(mlBackendId) {
+        this.ensureInitialized();
+        const response = await this.client.post(`/api/ml/${mlBackendId}/train`);
+        return response.data;
+    }
+    // ============================================================================
+    // Statistics Methods
+    // ============================================================================
+    /**
+     * Get project statistics
+     */
+    async getProjectStats(projectId) {
+        this.ensureInitialized();
+        const response = await this.client.get(`/api/projects/${projectId}`);
+        const project = response.data;
+        // Get detailed statistics
+        const tasksResponse = await this.client.get(`/api/projects/${projectId}/tasks`, {
+            params: { page_size: 1 }
+        });
+        return {
+            totalTasks: project.task_number || 0,
+            completedTasks: project.finished_task_number || 0,
+            totalAnnotations: project.total_annotations_number || 0,
+            avgAnnotationsPerTask: project.task_number > 0 ? (project.total_annotations_number || 0) / project.task_number : 0,
+            completionRate: project.task_number > 0 ? (project.finished_task_number || 0) / project.task_number : 0
+        };
+    }
+    /**
+     * Get annotator statistics
+     */
+    async getAnnotatorStats(projectId) {
+        this.ensureInitialized();
+        const response = await this.client.get(`/api/projects/${projectId}/annotations`);
+        const annotations = response.data.results || response.data;
+        // Group by annotator
+        const statsByUser = {};
+        for (const annotation of annotations) {
+            const email = annotation.completed_by?.email || 'unknown';
+            if (!statsByUser[email]) {
+                statsByUser[email] = {
+                    email,
+                    annotationCount: 0,
+                    totalTime: 0,
+                    lastAnnotationDate: null
+                };
+            }
+            statsByUser[email].annotationCount++;
+            if (annotation.lead_time) {
+                statsByUser[email].totalTime += annotation.lead_time;
+            }
+            const annotationDate = new Date(annotation.created_at);
+            if (!statsByUser[email].lastAnnotationDate ||
+                annotationDate > new Date(statsByUser[email].lastAnnotationDate)) {
+                statsByUser[email].lastAnnotationDate = annotation.created_at;
+            }
+        }
+        return Object.values(statsByUser).map(stat => ({
+            ...stat,
+            avgTime: stat.annotationCount > 0 ? stat.totalTime / stat.annotationCount : 0
+        }));
+    }
+    // ============================================================================
+    // Webhook Methods
+    // ============================================================================
+    /**
+     * Create webhook
+     */
+    async createWebhook(data) {
+        this.ensureInitialized();
+        const response = await this.client.post('/api/webhooks', data);
+        return response.data;
+    }
+    /**
+     * Get webhooks for project
+     */
+    async getWebhooks(projectId) {
+        this.ensureInitialized();
+        const response = await this.client.get('/api/webhooks', {
+            params: { project: projectId }
+        });
+        return response.data.results || response.data;
+    }
+    /**
+     * Delete webhook
+     */
+    async deleteWebhook(webhookId) {
+        this.ensureInitialized();
+        await this.client.delete(`/api/webhooks/${webhookId}`);
+    }
+}
+exports.LabelStudioApiClient = LabelStudioApiClient;
+// Singleton instance (lazy initialization)
+let _instance = null;
+function getLabelStudioApiClient() {
+    if (!_instance) {
+        _instance = new LabelStudioApiClient();
+    }
+    return _instance;
+}
+// Export singleton accessor
+exports.labelStudioApi = new Proxy({}, {
+    get(_target, prop) {
+        const instance = getLabelStudioApiClient();
+        const value = instance[prop];
+        if (typeof value === 'function') {
+            return value.bind(instance);
+        }
+        return value;
+    }
+});
+//# sourceMappingURL=label-studio-api-client.js.map

package/dist-server/utils/label-studio-api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-studio-api-client.js","sourceRoot":"","sources":["../../server/utils/label-studio-api-client.ts"],"names":[],"mappings":"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","sourcesContent":["import axios, { AxiosInstance, AxiosRequestConfig } from 'axios'\nimport { config } from '@things-factory/env'\n\n/**\n * Label Studio API Client\n * Provides methods to interact with Label Studio REST API\n */\nexport class LabelStudioApiClient {\n  private client: AxiosInstance | null = null\n  private serverUrl: string | null = null\n  private apiToken: string | null = null\n\n  constructor() {\n    // Defer initialization until first use\n  }\n\n  private ensureInitialized() {\n    if (this.client) {\n      return\n    }\n\n    const labelStudioConfig = config.get('labelStudio', {})\n    this.serverUrl = labelStudioConfig.serverUrl || 'http://localhost:8080'\n    this.apiToken = labelStudioConfig.apiToken || ''\n\n    this.client = axios.create({\n      baseURL: this.serverUrl,\n      headers: {\n        Authorization: `Token ${this.apiToken}`,\n        'Content-Type': 'application/json'\n      },\n      timeout: 30000\n    })\n  }\n\n  // ============================================================================\n  // Project Methods\n  // ============================================================================\n\n  /**\n   * Get all projects\n   */\n  async getProjects(): Promise<any[]> {\n    this.ensureInitialized()\n    const response = await this.client!.get('/api/projects')\n    return response.data.results || response.data\n  }\n\n  /**\n   * Get project by ID\n   */\n  async getProject(projectId: number): Promise<any> {\n    this.ensureInitialized()\n    const response = await this.client!.get(`/api/projects/${projectId}`)\n    return response.data\n  }\n\n  /**\n   * Create new project\n   */\n  async createProject(data: {\n    title: string\n    description?: string\n    label_config: string\n    expert_instruction?: string\n  }): Promise<any> {\n    this.ensureInitialized()\n    const response = await this.client!.post('/api/projects', data)\n    return response.data\n  }\n\n  /**\n   * Update project\n   */\n  async updateProject(projectId: number, data: any): Promise<any> {\n    this.ensureInitialized()\n    const response = await this.client!.patch(`/api/projects/${projectId}`, data)\n    return response.data\n  }\n\n  /**\n   * Delete project\n   */\n  async deleteProject(projectId: number): Promise<void> {\n    this.ensureInitialized()\n    await this.client!.delete(`/api/projects/${projectId}`)\n  }\n\n  // ============================================================================\n  // Task Methods\n  // ============================================================================\n\n  /**\n   * Get tasks for a project\n   */\n  async getTasks(projectId: number, params?: { page?: number; page_size?: number }): Promise<any> {\n    this.ensureInitialized()\n    const response = await this.client!.get(`/api/projects/${projectId}/tasks`, { params })\n    return response.data\n  }\n\n  /**\n   * Get single task\n   */\n  async getTask(taskId: number): Promise<any> {\n    this.ensureInitialized()\n    const response = await this.client!.get(`/api/tasks/${taskId}`)\n    return response.data\n  }\n\n  /**\n   * Create task\n   */\n  async createTask(projectId: number, data: any): Promise<any> {\n    this.ensureInitialized()\n    const response = await this.client!.post(`/api/projects/${projectId}/tasks`, data)\n    return response.data\n  }\n\n  /**\n   * Import tasks in bulk\n   */\n  async importTasks(projectId: number, tasks: any[]): Promise<any> {\n    this.ensureInitialized()\n    const response = await this.client!.post(`/api/projects/${projectId}/import`, tasks, {\n      headers: {\n        'Content-Type': 'application/json'\n      }\n    })\n    return response.data\n  }\n\n  /**\n   * Delete task\n   */\n  async deleteTask(taskId: number): Promise<void> {\n    this.ensureInitialized()\n    await this.client!.delete(`/api/tasks/${taskId}`)\n  }\n\n  // ============================================================================\n  // Annotation Methods\n  // ============================================================================\n\n  /**\n   * Get annotations for a task\n   */\n  async getAnnotations(taskId: number): Promise<any[]> {\n    this.ensureInitialized()\n    const response = await this.client!.get(`/api/tasks/${taskId}/annotations`)\n    return response.data\n  }\n\n  /**\n   * Create annotation\n   */\n  async createAnnotation(taskId: number, annotation: any): Promise<any> {\n    this.ensureInitialized()\n    const response = await this.client!.post(`/api/tasks/${taskId}/annotations`, annotation)\n    return response.data\n  }\n\n  /**\n   * Update annotation\n   */\n  async updateAnnotation(annotationId: number, data: any): Promise<any> {\n    this.ensureInitialized()\n    const response = await this.client!.patch(`/api/annotations/${annotationId}`, data)\n    return response.data\n  }\n\n  /**\n   * Delete annotation\n   */\n  async deleteAnnotation(annotationId: number): Promise<void> {\n    this.ensureInitialized()\n    await this.client!.delete(`/api/annotations/${annotationId}`)\n  }\n\n  // ============================================================================\n  // Prediction Methods\n  // ============================================================================\n\n  /**\n   * Get all predictions for a task\n   */\n  async getPredictions(taskId: number): Promise<any[]> {\n    this.ensureInitialized()\n    const response = await this.client!.get('/api/predictions', {\n      params: { task: taskId }\n    })\n    return response.data.results || response.data\n  }\n\n  /**\n   * Get predictions for a project\n   */\n  async getProjectPredictions(projectId: number): Promise<any[]> {\n    this.ensureInitialized()\n    const response = await this.client!.get('/api/predictions', {\n      params: { project: projectId }\n    })\n    return response.data.results || response.data\n  }\n\n  /**\n   * Get single prediction by ID\n   */\n  async getPrediction(predictionId: number): Promise<any> {\n    this.ensureInitialized()\n    const response = await this.client!.get(`/api/predictions/${predictionId}`)\n    return response.data\n  }\n\n  /**\n   * Create a prediction for a task\n   */\n  async createPrediction(data: {\n    task: number\n    result: any[]\n    score?: number\n    model_version?: string\n  }): Promise<any> {\n    this.ensureInitialized()\n    const response = await this.client!.post('/api/predictions', data)\n    return response.data\n  }\n\n  /**\n   * Create predictions in bulk\n   */\n  async createPredictions(predictions: Array<{\n    task: number\n    result: any[]\n    score?: number\n    model_version?: string\n  }>): Promise<any> {\n    this.ensureInitialized()\n    const results = await Promise.all(\n      predictions.map(prediction => this.createPrediction(prediction))\n    )\n    return {\n      created: results.length,\n      predictions: results\n    }\n  }\n\n  /**\n   * Update prediction\n   */\n  async updatePrediction(predictionId: number, data: any): Promise<any> {\n    this.ensureInitialized()\n    const response = await this.client!.patch(`/api/predictions/${predictionId}`, data)\n    return response.data\n  }\n\n  /**\n   * Delete prediction\n   */\n  async deletePrediction(predictionId: number): Promise<void> {\n    this.ensureInitialized()\n    await this.client!.delete(`/api/predictions/${predictionId}`)\n  }\n\n  /**\n   * Import predictions for a project\n   * This is useful for bulk importing AI model predictions\n   */\n  async importPredictions(projectId: number, predictions: any[]): Promise<any> {\n    this.ensureInitialized()\n    const response = await this.client!.post(`/api/projects/${projectId}/import/predictions`, predictions)\n    return response.data\n  }\n\n  // ============================================================================\n  // Export Methods\n  // ============================================================================\n\n  /**\n   * Export annotations\n   */\n  async exportAnnotations(\n    projectId: number,\n    format: 'JSON' | 'JSON_MIN' | 'CSV' | 'TSV' | 'CONLL2003' | 'COCO' | 'VOC' | 'YOLO' = 'JSON'\n  ): Promise<any> {\n    this.ensureInitialized()\n    const response = await this.client!.get(`/api/projects/${projectId}/export`, {\n      params: { exportType: format }\n    })\n    return response.data\n  }\n\n  /**\n   * Get export files\n   */\n  async getExportFiles(projectId: number): Promise<any[]> {\n    this.ensureInitialized()\n    const response = await this.client!.get(`/api/projects/${projectId}/exports`)\n    return response.data\n  }\n\n  // ============================================================================\n  // ML Backend Methods\n  // ============================================================================\n\n  /**\n   * Get ML backends for project\n   */\n  async getMLBackends(projectId: number): Promise<any[]> {\n    this.ensureInitialized()\n    const response = await this.client!.get(`/api/ml`, {\n      params: { project: projectId }\n    })\n    return response.data.results || response.data\n  }\n\n  /**\n   * Add ML backend to project\n   */\n  async addMLBackend(data: {\n    project: number\n    url: string\n    title: string\n    is_interactive?: boolean\n  }): Promise<any> {\n    this.ensureInitialized()\n    const response = await this.client!.post('/api/ml', data)\n    return response.data\n  }\n\n  /**\n   * Delete ML backend\n   */\n  async deleteMLBackend(mlBackendId: number): Promise<void> {\n    this.ensureInitialized()\n    await this.client!.delete(`/api/ml/${mlBackendId}`)\n  }\n\n  /**\n   * Trigger predictions for tasks\n   */\n  async triggerPredictions(projectId: number, taskIds?: number[]): Promise<any> {\n    this.ensureInitialized()\n    const payload = taskIds ? { task_ids: taskIds } : {}\n    const response = await this.client!.post(`/api/projects/${projectId}/predict`, payload)\n    return response.data\n  }\n\n  /**\n   * Train ML model\n   */\n  async trainModel(mlBackendId: number): Promise<any> {\n    this.ensureInitialized()\n    const response = await this.client!.post(`/api/ml/${mlBackendId}/train`)\n    return response.data\n  }\n\n  // ============================================================================\n  // Statistics Methods\n  // ============================================================================\n\n  /**\n   * Get project statistics\n   */\n  async getProjectStats(projectId: number): Promise<any> {\n    this.ensureInitialized()\n    const response = await this.client!.get(`/api/projects/${projectId}`)\n    const project = response.data\n\n    // Get detailed statistics\n    const tasksResponse = await this.client!.get(`/api/projects/${projectId}/tasks`, {\n      params: { page_size: 1 }\n    })\n\n    return {\n      totalTasks: project.task_number || 0,\n      completedTasks: project.finished_task_number || 0,\n      totalAnnotations: project.total_annotations_number || 0,\n      avgAnnotationsPerTask:\n        project.task_number > 0 ? (project.total_annotations_number || 0) / project.task_number : 0,\n      completionRate: project.task_number > 0 ? (project.finished_task_number || 0) / project.task_number : 0\n    }\n  }\n\n  /**\n   * Get annotator statistics\n   */\n  async getAnnotatorStats(projectId: number): Promise<any[]> {\n    this.ensureInitialized()\n    const response = await this.client!.get(`/api/projects/${projectId}/annotations`)\n    const annotations = response.data.results || response.data\n\n    // Group by annotator\n    const statsByUser: { [email: string]: any } = {}\n\n    for (const annotation of annotations) {\n      const email = annotation.completed_by?.email || 'unknown'\n\n      if (!statsByUser[email]) {\n        statsByUser[email] = {\n          email,\n          annotationCount: 0,\n          totalTime: 0,\n          lastAnnotationDate: null\n        }\n      }\n\n      statsByUser[email].annotationCount++\n      if (annotation.lead_time) {\n        statsByUser[email].totalTime += annotation.lead_time\n      }\n\n      const annotationDate = new Date(annotation.created_at)\n      if (\n        !statsByUser[email].lastAnnotationDate ||\n        annotationDate > new Date(statsByUser[email].lastAnnotationDate)\n      ) {\n        statsByUser[email].lastAnnotationDate = annotation.created_at\n      }\n    }\n\n    return Object.values(statsByUser).map(stat => ({\n      ...stat,\n      avgTime: stat.annotationCount > 0 ? stat.totalTime / stat.annotationCount : 0\n    }))\n  }\n\n  // ============================================================================\n  // Webhook Methods\n  // ============================================================================\n\n  /**\n   * Create webhook\n   */\n  async createWebhook(data: {\n    project: number\n    url: string\n    send_payload?: boolean\n    send_for_all_actions?: boolean\n    headers?: { [key: string]: string }\n  }): Promise<any> {\n    this.ensureInitialized()\n    const response = await this.client!.post('/api/webhooks', data)\n    return response.data\n  }\n\n  /**\n   * Get webhooks for project\n   */\n  async getWebhooks(projectId: number): Promise<any[]> {\n    this.ensureInitialized()\n    const response = await this.client!.get('/api/webhooks', {\n      params: { project: projectId }\n    })\n    return response.data.results || response.data\n  }\n\n  /**\n   * Delete webhook\n   */\n  async deleteWebhook(webhookId: number): Promise<void> {\n    this.ensureInitialized()\n    await this.client!.delete(`/api/webhooks/${webhookId}`)\n  }\n}\n\n// Singleton instance (lazy initialization)\nlet _instance: LabelStudioApiClient | null = null\n\nfunction getLabelStudioApiClient(): LabelStudioApiClient {\n  if (!_instance) {\n    _instance = new LabelStudioApiClient()\n  }\n  return _instance\n}\n\n// Export singleton accessor\nexport const labelStudioApi = new Proxy({} as LabelStudioApiClient, {\n  get(_target, prop) {\n    const instance = getLabelStudioApiClient()\n    const value = (instance as any)[prop]\n    if (typeof value === 'function') {\n      return value.bind(instance)\n    }\n    return value\n  }\n})\n"]}

package/dist-server/utils/media-url-extractor.d.ts

@@ -0,0 +1,45 @@
+import { DataSample } from '@things-factory/dataset';
+/**
+ * Media URL Extractor
+ *
+ * Extracts media URLs (image, video, audio) from DataSample for Label Studio tasks
+ */
+export interface MediaUrls {
+    [fieldName: string]: string | string[];
+}
+export interface AttachmentInfo {
+    id: string;
+    mimetype: string;
+    name: string;
+    fullpath: string;
+}
+/**
+ * Extract all media URLs from a DataSample
+ * Returns an object with field names as keys and URLs as values
+ *
+ * @param sample - DataSample containing media attachments
+ * @param baseUrl - Base URL for converting relative paths to absolute URLs (e.g., 'https://tf.example.com')
+ * @param mediaFields - Optional array of field names to extract. If not provided, extracts all fields.
+ * @returns Object with media URLs keyed by field name
+ */
+export declare function extractMediaUrls(sample: DataSample, baseUrl: string, mediaFields?: string[]): MediaUrls;
+/**
+ * Extract URL from DataSample for a specific field
+ * Handles both single values and arrays
+ */
+export declare function extractMediaUrl(sample: DataSample, fieldName: string, baseUrl: string): string | string[] | null;
+/**
+ * Build Label Studio task data from DataSample
+ * Automatically extracts all media fields and converts to absolute URLs
+ *
+ * @param sample - DataSample with media attachments
+ * @param baseUrl - Base URL for the Things-Factory server
+ * @param mediaFields - Optional list of media field names to include
+ * @returns Object ready for Label Studio task creation
+ */
+export declare function buildLabelStudioTaskData(sample: DataSample, baseUrl: string, mediaFields?: string[]): Record<string, any>;
+/**
+ * Helper: Get base URL from context or environment
+ * Falls back to environment variable or localhost
+ */
+export declare function getBaseUrl(context?: any): string;

package/dist-server/utils/media-url-extractor.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractMediaUrls = extractMediaUrls;
+exports.extractMediaUrl = extractMediaUrl;
+exports.buildLabelStudioTaskData = buildLabelStudioTaskData;
+exports.getBaseUrl = getBaseUrl;
+/**
+ * Extract all media URLs from a DataSample
+ * Returns an object with field names as keys and URLs as values
+ *
+ * @param sample - DataSample containing media attachments
+ * @param baseUrl - Base URL for converting relative paths to absolute URLs (e.g., 'https://tf.example.com')
+ * @param mediaFields - Optional array of field names to extract. If not provided, extracts all fields.
+ * @returns Object with media URLs keyed by field name
+ */
+function extractMediaUrls(sample, baseUrl, mediaFields) {
+    const urls = {};
+    if (!sample.data || typeof sample.data !== 'object') {
+        return urls;
+    }
+    const fieldsToExtract = mediaFields || Object.keys(sample.data);
+    for (const fieldName of fieldsToExtract) {
+        const fieldValue = sample.data[fieldName];
+        if (!fieldValue)
+            continue;
+        // Handle array of attachments
+        if (Array.isArray(fieldValue)) {
+            const extractedUrls = extractUrlsFromAttachmentArray(fieldValue, baseUrl);
+            if (extractedUrls.length > 0) {
+                urls[fieldName] = extractedUrls.length === 1 ? extractedUrls[0] : extractedUrls;
+            }
+        }
+        // Handle single URL string
+        else if (typeof fieldValue === 'string') {
+            const url = normalizeUrl(fieldValue, baseUrl);
+            if (url) {
+                urls[fieldName] = url;
+            }
+        }
+        // Handle single attachment object
+        else if (typeof fieldValue === 'object' && 'fullpath' in fieldValue) {
+            const url = normalizeUrl(fieldValue.fullpath, baseUrl);
+            if (url) {
+                urls[fieldName] = url;
+            }
+        }
+    }
+    return urls;
+}
+/**
+ * Extract URL from DataSample for a specific field
+ * Handles both single values and arrays
+ */
+function extractMediaUrl(sample, fieldName, baseUrl) {
+    if (!sample.data || typeof sample.data !== 'object') {
+        return null;
+    }
+    const fieldValue = sample.data[fieldName];
+    if (!fieldValue)
+        return null;
+    // Handle array of attachments
+    if (Array.isArray(fieldValue)) {
+        const urls = extractUrlsFromAttachmentArray(fieldValue, baseUrl);
+        return urls.length > 0 ? (urls.length === 1 ? urls[0] : urls) : null;
+    }
+    // Handle single URL string
+    if (typeof fieldValue === 'string') {
+        return normalizeUrl(fieldValue, baseUrl);
+    }
+    // Handle single attachment object
+    if (typeof fieldValue === 'object' && 'fullpath' in fieldValue) {
+        return normalizeUrl(fieldValue.fullpath, baseUrl);
+    }
+    return null;
+}
+/**
+ * Extract URLs from an array of attachments
+ * Handles nested arrays created by create-data-sample.ts
+ */
+function extractUrlsFromAttachmentArray(arr, baseUrl) {
+    const urls = [];
+    for (const item of arr) {
+        if (Array.isArray(item)) {
+            // Nested array - recursively extract
+            urls.push(...extractUrlsFromAttachmentArray(item, baseUrl));
+        }
+        else if (item && typeof item === 'object' && 'fullpath' in item) {
+            // Attachment object
+            const url = normalizeUrl(item.fullpath, baseUrl);
+            if (url)
+                urls.push(url);
+        }
+        else if (typeof item === 'string') {
+            // Direct URL string
+            const url = normalizeUrl(item, baseUrl);
+            if (url)
+                urls.push(url);
+        }
+    }
+    return urls;
+}
+/**
+ * Normalize URL - convert relative paths to absolute URLs
+ *
+ * @param path - Relative path (e.g., '/attachments/2024/01/image.jpg') or absolute URL
+ * @param baseUrl - Base URL (e.g., 'https://tf.example.com')
+ * @returns Absolute URL or null if invalid
+ */
+function normalizeUrl(path, baseUrl) {
+    if (!path)
+        return null;
+    // Already absolute URL
+    if (path.startsWith('http://') || path.startsWith('https://')) {
+        return path;
+    }
+    // Relative path - convert to absolute
+    if (path.startsWith('/')) {
+        const cleanBaseUrl = baseUrl.replace(/\/+$/, ''); // Remove trailing slashes
+        return `${cleanBaseUrl}${path}`;
+    }
+    // Invalid format
+    return null;
+}
+/**
+ * Build Label Studio task data from DataSample
+ * Automatically extracts all media fields and converts to absolute URLs
+ *
+ * @param sample - DataSample with media attachments
+ * @param baseUrl - Base URL for the Things-Factory server
+ * @param mediaFields - Optional list of media field names to include
+ * @returns Object ready for Label Studio task creation
+ */
+function buildLabelStudioTaskData(sample, baseUrl, mediaFields) {
+    return extractMediaUrls(sample, baseUrl, mediaFields);
+}
+/**
+ * Helper: Get base URL from context or environment
+ * Falls back to environment variable or localhost
+ */
+function getBaseUrl(context) {
+    // Try from context (request)
+    if (context?.state?.domain?.systemUrl) {
+        return context.state.domain.systemUrl;
+    }
+    // Try from environment
+    if (process.env.THINGS_FACTORY_URL) {
+        return process.env.THINGS_FACTORY_URL;
+    }
+    // Fallback
+    return 'http://localhost:3000';
+}
+//# sourceMappingURL=media-url-extractor.js.map

package/dist-server/utils/media-url-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-url-extractor.js","sourceRoot":"","sources":["../../server/utils/media-url-extractor.ts"],"names":[],"mappings":"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","sourcesContent":["import { DataSample } from '@things-factory/dataset'\n\n/**\n * Media URL Extractor\n *\n * Extracts media URLs (image, video, audio) from DataSample for Label Studio tasks\n */\n\nexport interface MediaUrls {\n  [fieldName: string]: string | string[]\n}\n\nexport interface AttachmentInfo {\n  id: string\n  mimetype: string\n  name: string\n  fullpath: string\n}\n\n/**\n * Extract all media URLs from a DataSample\n * Returns an object with field names as keys and URLs as values\n *\n * @param sample - DataSample containing media attachments\n * @param baseUrl - Base URL for converting relative paths to absolute URLs (e.g., 'https://tf.example.com')\n * @param mediaFields - Optional array of field names to extract. If not provided, extracts all fields.\n * @returns Object with media URLs keyed by field name\n */\nexport function extractMediaUrls(\n  sample: DataSample,\n  baseUrl: string,\n  mediaFields?: string[]\n): MediaUrls {\n  const urls: MediaUrls = {}\n\n  if (!sample.data || typeof sample.data !== 'object') {\n    return urls\n  }\n\n  const fieldsToExtract = mediaFields || Object.keys(sample.data)\n\n  for (const fieldName of fieldsToExtract) {\n    const fieldValue = sample.data[fieldName]\n\n    if (!fieldValue) continue\n\n    // Handle array of attachments\n    if (Array.isArray(fieldValue)) {\n      const extractedUrls = extractUrlsFromAttachmentArray(fieldValue, baseUrl)\n      if (extractedUrls.length > 0) {\n        urls[fieldName] = extractedUrls.length === 1 ? extractedUrls[0] : extractedUrls\n      }\n    }\n    // Handle single URL string\n    else if (typeof fieldValue === 'string') {\n      const url = normalizeUrl(fieldValue, baseUrl)\n      if (url) {\n        urls[fieldName] = url\n      }\n    }\n    // Handle single attachment object\n    else if (typeof fieldValue === 'object' && 'fullpath' in fieldValue) {\n      const url = normalizeUrl(fieldValue.fullpath, baseUrl)\n      if (url) {\n        urls[fieldName] = url\n      }\n    }\n  }\n\n  return urls\n}\n\n/**\n * Extract URL from DataSample for a specific field\n * Handles both single values and arrays\n */\nexport function extractMediaUrl(\n  sample: DataSample,\n  fieldName: string,\n  baseUrl: string\n): string | string[] | null {\n  if (!sample.data || typeof sample.data !== 'object') {\n    return null\n  }\n\n  const fieldValue = sample.data[fieldName]\n\n  if (!fieldValue) return null\n\n  // Handle array of attachments\n  if (Array.isArray(fieldValue)) {\n    const urls = extractUrlsFromAttachmentArray(fieldValue, baseUrl)\n    return urls.length > 0 ? (urls.length === 1 ? urls[0] : urls) : null\n  }\n\n  // Handle single URL string\n  if (typeof fieldValue === 'string') {\n    return normalizeUrl(fieldValue, baseUrl)\n  }\n\n  // Handle single attachment object\n  if (typeof fieldValue === 'object' && 'fullpath' in fieldValue) {\n    return normalizeUrl(fieldValue.fullpath, baseUrl)\n  }\n\n  return null\n}\n\n/**\n * Extract URLs from an array of attachments\n * Handles nested arrays created by create-data-sample.ts\n */\nfunction extractUrlsFromAttachmentArray(arr: any[], baseUrl: string): string[] {\n  const urls: string[] = []\n\n  for (const item of arr) {\n    if (Array.isArray(item)) {\n      // Nested array - recursively extract\n      urls.push(...extractUrlsFromAttachmentArray(item, baseUrl))\n    } else if (item && typeof item === 'object' && 'fullpath' in item) {\n      // Attachment object\n      const url = normalizeUrl(item.fullpath, baseUrl)\n      if (url) urls.push(url)\n    } else if (typeof item === 'string') {\n      // Direct URL string\n      const url = normalizeUrl(item, baseUrl)\n      if (url) urls.push(url)\n    }\n  }\n\n  return urls\n}\n\n/**\n * Normalize URL - convert relative paths to absolute URLs\n *\n * @param path - Relative path (e.g., '/attachments/2024/01/image.jpg') or absolute URL\n * @param baseUrl - Base URL (e.g., 'https://tf.example.com')\n * @returns Absolute URL or null if invalid\n */\nfunction normalizeUrl(path: string | undefined, baseUrl: string): string | null {\n  if (!path) return null\n\n  // Already absolute URL\n  if (path.startsWith('http://') || path.startsWith('https://')) {\n    return path\n  }\n\n  // Relative path - convert to absolute\n  if (path.startsWith('/')) {\n    const cleanBaseUrl = baseUrl.replace(/\\/+$/, '') // Remove trailing slashes\n    return `${cleanBaseUrl}${path}`\n  }\n\n  // Invalid format\n  return null\n}\n\n/**\n * Build Label Studio task data from DataSample\n * Automatically extracts all media fields and converts to absolute URLs\n *\n * @param sample - DataSample with media attachments\n * @param baseUrl - Base URL for the Things-Factory server\n * @param mediaFields - Optional list of media field names to include\n * @returns Object ready for Label Studio task creation\n */\nexport function buildLabelStudioTaskData(\n  sample: DataSample,\n  baseUrl: string,\n  mediaFields?: string[]\n): Record<string, any> {\n  return extractMediaUrls(sample, baseUrl, mediaFields)\n}\n\n/**\n * Helper: Get base URL from context or environment\n * Falls back to environment variable or localhost\n */\nexport function getBaseUrl(context?: any): string {\n  // Try from context (request)\n  if (context?.state?.domain?.systemUrl) {\n    return context.state.domain.systemUrl\n  }\n\n  // Try from environment\n  if (process.env.THINGS_FACTORY_URL) {\n    return process.env.THINGS_FACTORY_URL\n  }\n\n  // Fallback\n  return 'http://localhost:3000'\n}\n"]}