@things-factory/integration-label-studio 9.1.19

package/dist-server/utils/label-config-builder.js

@@ -0,0 +1,286 @@
+"use strict";
+/**
+ * Label Config Builder
+ *
+ * Flexible, declarative Label Studio configuration generator.
+ * Supports any data type and control combination without hardcoding templates.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LabelConfigTemplates = exports.LabelConfigBuilder = void 0;
+class LabelConfigBuilder {
+    /**
+     * Build Label Studio XML configuration from specification
+     */
+    static build(spec) {
+        const dataName = spec.dataName || 'data';
+        const dataTag = this.buildDataTag(spec.dataType, dataName);
+        const controlTags = spec.controls.map(c => this.buildControlTag(c));
+        return `
+<View>
+  ${dataTag}
+  ${controlTags.join('\n  ')}
+</View>
+    `.trim();
+    }
+    /**
+     * Build data source tag (Image, Text, Audio, etc.)
+     */
+    static buildDataTag(type, name) {
+        const capitalizedType = type.charAt(0).toUpperCase() + type.slice(1);
+        return `<${capitalizedType} name="${name}" value="$${name}"/>`;
+    }
+    /**
+     * Build control tag based on type
+     */
+    static buildControlTag(control) {
+        switch (control.type) {
+            case 'choices':
+                return this.buildChoices(control);
+            case 'labels':
+                return this.buildLabels(control);
+            case 'textarea':
+                return this.buildTextArea(control);
+            case 'rating':
+                return this.buildRating(control);
+            case 'rectangles':
+                return this.buildRectangles(control);
+            case 'polygon':
+                return this.buildPolygon(control);
+            case 'keypoint':
+                return this.buildKeypoint(control);
+            case 'brush':
+                return this.buildBrush(control);
+            default:
+                throw new Error(`Unknown control type: ${control.type}`);
+        }
+    }
+    /**
+     * Build Choices control (single or multiple selection)
+     */
+    static buildChoices(control) {
+        const config = control.config;
+        const choice = config.choice || 'single';
+        const required = config.required ? 'required="true"' : '';
+        const choiceElements = config.choices
+            .map(c => `    <Choice value="${this.escapeXml(c)}"/>`)
+            .join('\n');
+        return `<Choices name="${control.name}" toName="${control.toName}" choice="${choice}" ${required}>
+${choiceElements}
+  </Choices>`;
+    }
+    /**
+     * Build Labels control (for NER, classification, etc.)
+     */
+    static buildLabels(control) {
+        const config = control.config;
+        const labelElements = config.labels
+            .map(l => {
+            const background = l.background ? `background="${l.background}"` : '';
+            const hotkey = l.hotkey ? `hotkey="${l.hotkey}"` : '';
+            return `    <Label value="${this.escapeXml(l.value)}" ${background} ${hotkey}/>`;
+        })
+            .join('\n');
+        return `<Labels name="${control.name}" toName="${control.toName}">
+${labelElements}
+  </Labels>`;
+    }
+    /**
+     * Build TextArea control
+     */
+    static buildTextArea(control) {
+        const placeholder = control.config.placeholder ? `placeholder="${control.config.placeholder}"` : '';
+        const required = control.config.required ? 'required="true"' : '';
+        const maxSubmissions = control.config.maxSubmissions ? `maxSubmissions="${control.config.maxSubmissions}"` : '';
+        return `<TextArea name="${control.name}" toName="${control.toName}" ${placeholder} ${required} ${maxSubmissions}/>`;
+    }
+    /**
+     * Build Rating control
+     */
+    static buildRating(control) {
+        const config = control.config;
+        const maxRating = config.maxRating || 5;
+        const icon = config.icon || 'star';
+        const size = config.size || 'medium';
+        return `<Rating name="${control.name}" toName="${control.toName}" maxRating="${maxRating}" icon="${icon}" size="${size}"/>`;
+    }
+    /**
+     * Build Rectangle control (bounding boxes)
+     */
+    static buildRectangles(control) {
+        const labels = control.config.labels ? `labels="${control.config.labels.join(',')}"` : '';
+        return `<Rectangle name="${control.name}" toName="${control.toName}" ${labels}/>`;
+    }
+    /**
+     * Build Polygon control
+     */
+    static buildPolygon(control) {
+        const labels = control.config.labels ? `labels="${control.config.labels.join(',')}"` : '';
+        return `<Polygon name="${control.name}" toName="${control.toName}" ${labels}/>`;
+    }
+    /**
+     * Build Keypoint control
+     */
+    static buildKeypoint(control) {
+        const labels = control.config.labels ? `labels="${control.config.labels.join(',')}"` : '';
+        return `<KeyPoint name="${control.name}" toName="${control.toName}" ${labels}/>`;
+    }
+    /**
+     * Build Brush control (semantic segmentation)
+     */
+    static buildBrush(control) {
+        const labels = control.config.labels ? `labels="${control.config.labels.join(',')}"` : '';
+        return `<Brush name="${control.name}" toName="${control.toName}" ${labels}/>`;
+    }
+    /**
+     * Escape XML special characters
+     */
+    static escapeXml(str) {
+        return str
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&apos;');
+    }
+}
+exports.LabelConfigBuilder = LabelConfigBuilder;
+/**
+ * Pre-built template generators for common use cases
+ */
+class LabelConfigTemplates {
+    /**
+     * Generate Rank N image classification config
+     * Example: WBM Rank 3 classification
+     */
+    static imageRankN(ranks, classes) {
+        const controls = [];
+        for (let i = 1; i <= ranks; i++) {
+            controls.push({
+                type: 'choices',
+                name: `rank${i}`,
+                toName: 'data',
+                config: {
+                    choices: classes,
+                    choice: 'single',
+                    required: i === 1 // First rank is required
+                }
+            });
+        }
+        return {
+            dataType: 'image',
+            controls
+        };
+    }
+    /**
+     * Simple image classification
+     */
+    static imageClassification(classes, multiLabel = false) {
+        return {
+            dataType: 'image',
+            controls: [
+                {
+                    type: 'choices',
+                    name: 'choice',
+                    toName: 'data',
+                    config: {
+                        choices: classes,
+                        choice: multiLabel ? 'multiple' : 'single',
+                        required: true
+                    }
+                }
+            ]
+        };
+    }
+    /**
+     * Text classification (sentiment, intent, etc.)
+     */
+    static textClassification(classes) {
+        return {
+            dataType: 'text',
+            controls: [
+                {
+                    type: 'choices',
+                    name: 'choice',
+                    toName: 'data',
+                    config: {
+                        choices: classes,
+                        choice: 'single',
+                        required: true
+                    }
+                }
+            ]
+        };
+    }
+    /**
+     * Named Entity Recognition
+     */
+    static namedEntityRecognition(labels) {
+        return {
+            dataType: 'text',
+            controls: [
+                {
+                    type: 'labels',
+                    name: 'label',
+                    toName: 'data',
+                    config: {
+                        labels
+                    }
+                }
+            ]
+        };
+    }
+    /**
+     * Object detection (bounding boxes)
+     */
+    static objectDetection(labels) {
+        return {
+            dataType: 'image',
+            controls: [
+                {
+                    type: 'rectangles',
+                    name: 'bbox',
+                    toName: 'data',
+                    config: {
+                        labels
+                    }
+                },
+                {
+                    type: 'labels',
+                    name: 'label',
+                    toName: 'data',
+                    config: {
+                        labels: labels.map(l => ({ value: l }))
+                    }
+                }
+            ]
+        };
+    }
+    /**
+     * Semantic segmentation
+     */
+    static semanticSegmentation(labels) {
+        return {
+            dataType: 'image',
+            controls: [
+                {
+                    type: 'brush',
+                    name: 'segmentation',
+                    toName: 'data',
+                    config: {
+                        labels
+                    }
+                },
+                {
+                    type: 'labels',
+                    name: 'label',
+                    toName: 'data',
+                    config: {
+                        labels: labels.map(l => ({ value: l }))
+                    }
+                }
+            ]
+        };
+    }
+}
+exports.LabelConfigTemplates = LabelConfigTemplates;
+//# sourceMappingURL=label-config-builder.js.map

package/dist-server/utils/label-config-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-config-builder.js","sourceRoot":"","sources":["../../server/utils/label-config-builder.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Label Config Builder\n *\n * Flexible, declarative Label Studio configuration generator.\n * Supports any data type and control combination without hardcoding templates.\n */\n\nexport interface LabelConfigSpec {\n  dataType: 'image' | 'text' | 'audio' | 'video' | 'timeseries' | 'html' | 'hypertext'\n  dataName?: string // default: 'data'\n  controls: ControlSpec[]\n}\n\nexport interface ControlSpec {\n  type: 'choices' | 'labels' | 'textarea' | 'rating' | 'rectangles' | 'polygon' | 'keypoint' | 'brush'\n  name: string\n  toName: string\n  config: any\n}\n\nexport interface ChoicesConfig {\n  choices: string[]\n  choice?: 'single' | 'multiple'\n  required?: boolean\n}\n\nexport interface LabelsConfig {\n  labels: Array<{\n    value: string\n    background?: string\n    hotkey?: string\n  }>\n}\n\nexport interface RatingConfig {\n  maxRating?: number\n  icon?: string\n  size?: 'small' | 'medium' | 'large'\n}\n\nexport class LabelConfigBuilder {\n  /**\n   * Build Label Studio XML configuration from specification\n   */\n  static build(spec: LabelConfigSpec): string {\n    const dataName = spec.dataName || 'data'\n    const dataTag = this.buildDataTag(spec.dataType, dataName)\n    const controlTags = spec.controls.map(c => this.buildControlTag(c))\n\n    return `\n<View>\n  ${dataTag}\n  ${controlTags.join('\\n  ')}\n</View>\n    `.trim()\n  }\n\n  /**\n   * Build data source tag (Image, Text, Audio, etc.)\n   */\n  private static buildDataTag(type: string, name: string): string {\n    const capitalizedType = type.charAt(0).toUpperCase() + type.slice(1)\n    return `<${capitalizedType} name=\"${name}\" value=\"$${name}\"/>`\n  }\n\n  /**\n   * Build control tag based on type\n   */\n  private static buildControlTag(control: ControlSpec): string {\n    switch (control.type) {\n      case 'choices':\n        return this.buildChoices(control)\n      case 'labels':\n        return this.buildLabels(control)\n      case 'textarea':\n        return this.buildTextArea(control)\n      case 'rating':\n        return this.buildRating(control)\n      case 'rectangles':\n        return this.buildRectangles(control)\n      case 'polygon':\n        return this.buildPolygon(control)\n      case 'keypoint':\n        return this.buildKeypoint(control)\n      case 'brush':\n        return this.buildBrush(control)\n      default:\n        throw new Error(`Unknown control type: ${control.type}`)\n    }\n  }\n\n  /**\n   * Build Choices control (single or multiple selection)\n   */\n  private static buildChoices(control: ControlSpec): string {\n    const config = control.config as ChoicesConfig\n    const choice = config.choice || 'single'\n    const required = config.required ? 'required=\"true\"' : ''\n\n    const choiceElements = config.choices\n      .map(c => `    <Choice value=\"${this.escapeXml(c)}\"/>`)\n      .join('\\n')\n\n    return `<Choices name=\"${control.name}\" toName=\"${control.toName}\" choice=\"${choice}\" ${required}>\n${choiceElements}\n  </Choices>`\n  }\n\n  /**\n   * Build Labels control (for NER, classification, etc.)\n   */\n  private static buildLabels(control: ControlSpec): string {\n    const config = control.config as LabelsConfig\n\n    const labelElements = config.labels\n      .map(l => {\n        const background = l.background ? `background=\"${l.background}\"` : ''\n        const hotkey = l.hotkey ? `hotkey=\"${l.hotkey}\"` : ''\n        return `    <Label value=\"${this.escapeXml(l.value)}\" ${background} ${hotkey}/>`\n      })\n      .join('\\n')\n\n    return `<Labels name=\"${control.name}\" toName=\"${control.toName}\">\n${labelElements}\n  </Labels>`\n  }\n\n  /**\n   * Build TextArea control\n   */\n  private static buildTextArea(control: ControlSpec): string {\n    const placeholder = control.config.placeholder ? `placeholder=\"${control.config.placeholder}\"` : ''\n    const required = control.config.required ? 'required=\"true\"' : ''\n    const maxSubmissions = control.config.maxSubmissions ? `maxSubmissions=\"${control.config.maxSubmissions}\"` : ''\n\n    return `<TextArea name=\"${control.name}\" toName=\"${control.toName}\" ${placeholder} ${required} ${maxSubmissions}/>`\n  }\n\n  /**\n   * Build Rating control\n   */\n  private static buildRating(control: ControlSpec): string {\n    const config = control.config as RatingConfig\n    const maxRating = config.maxRating || 5\n    const icon = config.icon || 'star'\n    const size = config.size || 'medium'\n\n    return `<Rating name=\"${control.name}\" toName=\"${control.toName}\" maxRating=\"${maxRating}\" icon=\"${icon}\" size=\"${size}\"/>`\n  }\n\n  /**\n   * Build Rectangle control (bounding boxes)\n   */\n  private static buildRectangles(control: ControlSpec): string {\n    const labels = control.config.labels ? `labels=\"${control.config.labels.join(',')}\"` : ''\n    return `<Rectangle name=\"${control.name}\" toName=\"${control.toName}\" ${labels}/>`\n  }\n\n  /**\n   * Build Polygon control\n   */\n  private static buildPolygon(control: ControlSpec): string {\n    const labels = control.config.labels ? `labels=\"${control.config.labels.join(',')}\"` : ''\n    return `<Polygon name=\"${control.name}\" toName=\"${control.toName}\" ${labels}/>`\n  }\n\n  /**\n   * Build Keypoint control\n   */\n  private static buildKeypoint(control: ControlSpec): string {\n    const labels = control.config.labels ? `labels=\"${control.config.labels.join(',')}\"` : ''\n    return `<KeyPoint name=\"${control.name}\" toName=\"${control.toName}\" ${labels}/>`\n  }\n\n  /**\n   * Build Brush control (semantic segmentation)\n   */\n  private static buildBrush(control: ControlSpec): string {\n    const labels = control.config.labels ? `labels=\"${control.config.labels.join(',')}\"` : ''\n    return `<Brush name=\"${control.name}\" toName=\"${control.toName}\" ${labels}/>`\n  }\n\n  /**\n   * Escape XML special characters\n   */\n  private static escapeXml(str: string): string {\n    return str\n      .replace(/&/g, '&amp;')\n      .replace(/</g, '&lt;')\n      .replace(/>/g, '&gt;')\n      .replace(/\"/g, '&quot;')\n      .replace(/'/g, '&apos;')\n  }\n}\n\n/**\n * Pre-built template generators for common use cases\n */\nexport class LabelConfigTemplates {\n  /**\n   * Generate Rank N image classification config\n   * Example: WBM Rank 3 classification\n   */\n  static imageRankN(ranks: number, classes: string[]): LabelConfigSpec {\n    const controls: ControlSpec[] = []\n\n    for (let i = 1; i <= ranks; i++) {\n      controls.push({\n        type: 'choices',\n        name: `rank${i}`,\n        toName: 'data',\n        config: {\n          choices: classes,\n          choice: 'single',\n          required: i === 1 // First rank is required\n        }\n      })\n    }\n\n    return {\n      dataType: 'image',\n      controls\n    }\n  }\n\n  /**\n   * Simple image classification\n   */\n  static imageClassification(classes: string[], multiLabel: boolean = false): LabelConfigSpec {\n    return {\n      dataType: 'image',\n      controls: [\n        {\n          type: 'choices',\n          name: 'choice',\n          toName: 'data',\n          config: {\n            choices: classes,\n            choice: multiLabel ? 'multiple' : 'single',\n            required: true\n          }\n        }\n      ]\n    }\n  }\n\n  /**\n   * Text classification (sentiment, intent, etc.)\n   */\n  static textClassification(classes: string[]): LabelConfigSpec {\n    return {\n      dataType: 'text',\n      controls: [\n        {\n          type: 'choices',\n          name: 'choice',\n          toName: 'data',\n          config: {\n            choices: classes,\n            choice: 'single',\n            required: true\n          }\n        }\n      ]\n    }\n  }\n\n  /**\n   * Named Entity Recognition\n   */\n  static namedEntityRecognition(labels: Array<{ value: string; background: string }>): LabelConfigSpec {\n    return {\n      dataType: 'text',\n      controls: [\n        {\n          type: 'labels',\n          name: 'label',\n          toName: 'data',\n          config: {\n            labels\n          }\n        }\n      ]\n    }\n  }\n\n  /**\n   * Object detection (bounding boxes)\n   */\n  static objectDetection(labels: string[]): LabelConfigSpec {\n    return {\n      dataType: 'image',\n      controls: [\n        {\n          type: 'rectangles',\n          name: 'bbox',\n          toName: 'data',\n          config: {\n            labels\n          }\n        },\n        {\n          type: 'labels',\n          name: 'label',\n          toName: 'data',\n          config: {\n            labels: labels.map(l => ({ value: l }))\n          }\n        }\n      ]\n    }\n  }\n\n  /**\n   * Semantic segmentation\n   */\n  static semanticSegmentation(labels: string[]): LabelConfigSpec {\n    return {\n      dataType: 'image',\n      controls: [\n        {\n          type: 'brush',\n          name: 'segmentation',\n          toName: 'data',\n          config: {\n            labels\n          }\n        },\n        {\n          type: 'labels',\n          name: 'label',\n          toName: 'data',\n          config: {\n            labels: labels.map(l => ({ value: l }))\n          }\n        }\n      ]\n    }\n  }\n}\n"]}

package/dist-server/utils/label-studio-api-client.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Label Studio API Client
+ * Provides methods to interact with Label Studio REST API
+ */
+export declare class LabelStudioApiClient {
+    private client;
+    private serverUrl;
+    private apiToken;
+    constructor();
+    private ensureInitialized;
+    /**
+     * Get all projects
+     */
+    getProjects(): Promise<any[]>;
+    /**
+     * Get project by ID
+     */
+    getProject(projectId: number): Promise<any>;
+    /**
+     * Create new project
+     */
+    createProject(data: {
+        title: string;
+        description?: string;
+        label_config: string;
+        expert_instruction?: string;
+    }): Promise<any>;
+    /**
+     * Update project
+     */
+    updateProject(projectId: number, data: any): Promise<any>;
+    /**
+     * Delete project
+     */
+    deleteProject(projectId: number): Promise<void>;
+    /**
+     * Get tasks for a project
+     */
+    getTasks(projectId: number, params?: {
+        page?: number;
+        page_size?: number;
+    }): Promise<any>;
+    /**
+     * Get single task
+     */
+    getTask(taskId: number): Promise<any>;
+    /**
+     * Create task
+     */
+    createTask(projectId: number, data: any): Promise<any>;
+    /**
+     * Import tasks in bulk
+     */
+    importTasks(projectId: number, tasks: any[]): Promise<any>;
+    /**
+     * Delete task
+     */
+    deleteTask(taskId: number): Promise<void>;
+    /**
+     * Get annotations for a task
+     */
+    getAnnotations(taskId: number): Promise<any[]>;
+    /**
+     * Create annotation
+     */
+    createAnnotation(taskId: number, annotation: any): Promise<any>;
+    /**
+     * Update annotation
+     */
+    updateAnnotation(annotationId: number, data: any): Promise<any>;
+    /**
+     * Delete annotation
+     */
+    deleteAnnotation(annotationId: number): Promise<void>;
+    /**
+     * Get all predictions for a task
+     */
+    getPredictions(taskId: number): Promise<any[]>;
+    /**
+     * Get predictions for a project
+     */
+    getProjectPredictions(projectId: number): Promise<any[]>;
+    /**
+     * Get single prediction by ID
+     */
+    getPrediction(predictionId: number): Promise<any>;
+    /**
+     * Create a prediction for a task
+     */
+    createPrediction(data: {
+        task: number;
+        result: any[];
+        score?: number;
+        model_version?: string;
+    }): Promise<any>;
+    /**
+     * Create predictions in bulk
+     */
+    createPredictions(predictions: Array<{
+        task: number;
+        result: any[];
+        score?: number;
+        model_version?: string;
+    }>): Promise<any>;
+    /**
+     * Update prediction
+     */
+    updatePrediction(predictionId: number, data: any): Promise<any>;
+    /**
+     * Delete prediction
+     */
+    deletePrediction(predictionId: number): Promise<void>;
+    /**
+     * Import predictions for a project
+     * This is useful for bulk importing AI model predictions
+     */
+    importPredictions(projectId: number, predictions: any[]): Promise<any>;
+    /**
+     * Export annotations
+     */
+    exportAnnotations(projectId: number, format?: 'JSON' | 'JSON_MIN' | 'CSV' | 'TSV' | 'CONLL2003' | 'COCO' | 'VOC' | 'YOLO'): Promise<any>;
+    /**
+     * Get export files
+     */
+    getExportFiles(projectId: number): Promise<any[]>;
+    /**
+     * Get ML backends for project
+     */
+    getMLBackends(projectId: number): Promise<any[]>;
+    /**
+     * Add ML backend to project
+     */
+    addMLBackend(data: {
+        project: number;
+        url: string;
+        title: string;
+        is_interactive?: boolean;
+    }): Promise<any>;
+    /**
+     * Delete ML backend
+     */
+    deleteMLBackend(mlBackendId: number): Promise<void>;
+    /**
+     * Trigger predictions for tasks
+     */
+    triggerPredictions(projectId: number, taskIds?: number[]): Promise<any>;
+    /**
+     * Train ML model
+     */
+    trainModel(mlBackendId: number): Promise<any>;
+    /**
+     * Get project statistics
+     */
+    getProjectStats(projectId: number): Promise<any>;
+    /**
+     * Get annotator statistics
+     */
+    getAnnotatorStats(projectId: number): Promise<any[]>;
+    /**
+     * Create webhook
+     */
+    createWebhook(data: {
+        project: number;
+        url: string;
+        send_payload?: boolean;
+        send_for_all_actions?: boolean;
+        headers?: {
+            [key: string]: string;
+        };
+    }): Promise<any>;
+    /**
+     * Get webhooks for project
+     */
+    getWebhooks(projectId: number): Promise<any[]>;
+    /**
+     * Delete webhook
+     */
+    deleteWebhook(webhookId: number): Promise<void>;
+}
+export declare const labelStudioApi: LabelStudioApiClient;