@things-factory/integration-label-studio 9.1.19

package/dist-server/utils/task-transformer.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Task Transformer
+ *
+ * Flexible data transformation from any source format to Label Studio tasks.
+ * Supports nested data, predictions, and custom field mapping.
+ */
+export interface TaskTransformRule {
+    /**
+     * Field mapping: Label Studio field name -> source data path
+     * Example: { "image": "image_url", "date": "metadata.timestamp" }
+     */
+    dataFields: {
+        [lsField: string]: string;
+    };
+    /**
+     * Prediction configuration (optional)
+     */
+    predictions?: PredictionConfig;
+    /**
+     * Metadata to attach to task (optional)
+     */
+    meta?: {
+        [key: string]: string;
+    };
+}
+export interface PredictionConfig {
+    /**
+     * Enable predictions
+     */
+    enabled: boolean;
+    /**
+     * Path to prediction result in source data
+     */
+    resultPath: string;
+    /**
+     * Path to confidence score (optional)
+     */
+    scorePath?: string;
+    /**
+     * Model version identifier (optional)
+     */
+    modelVersion?: string;
+    /**
+     * Transform function for prediction result
+     */
+    resultTransform?: (result: any) => any;
+}
+export interface LabelStudioTask {
+    data: string;
+    predictions?: Array<{
+        result: any;
+        score?: number;
+        model_version?: string;
+    }>;
+    meta?: any;
+}
+export declare class TaskTransformer {
+    /**
+     * Transform source data to Label Studio tasks
+     *
+     * @param sourceData - Array of source data objects
+     * @param rule - Transformation rules
+     * @returns Array of Label Studio tasks
+     */
+    static transform(sourceData: any[], rule: TaskTransformRule): LabelStudioTask[];
+    /**
+     * Transform a single data object
+     */
+    static transformOne(sourceData: any, rule: TaskTransformRule): LabelStudioTask | null;
+    /**
+     * Build prediction object from source data
+     */
+    private static buildPrediction;
+    /**
+     * Get nested value from object using dot notation path
+     * Example: "metadata.user.name" -> obj.metadata.user.name
+     */
+    private static getNestedValue;
+    /**
+     * Transform with multiple rules (useful for heterogeneous data)
+     */
+    static transformMultiRule(sourceData: any[], rules: TaskTransformRule[]): LabelStudioTask[];
+}
+/**
+ * Pre-built transformation templates for common scenarios
+ */
+export declare class TaskTransformTemplates {
+    /**
+     * WBM Image Classification with AI predictions
+     */
+    static wbmImageClassification(includeAiPrediction?: boolean): TaskTransformRule;
+    /**
+     * Simple image classification
+     */
+    static imageClassification(imageField?: string): TaskTransformRule;
+    /**
+     * Text classification with metadata
+     */
+    static textClassification(textField?: string, metaFields?: string[]): TaskTransformRule;
+    /**
+     * Time series data
+     */
+    static timeSeries(valuesField: string, timestampField?: string): TaskTransformRule;
+    /**
+     * Object detection with bounding box predictions
+     */
+    static objectDetection(imageField?: string, predictionsField?: string): TaskTransformRule;
+}

package/dist-server/utils/task-transformer.js

@@ -0,0 +1,260 @@
+"use strict";
+/**
+ * Task Transformer
+ *
+ * Flexible data transformation from any source format to Label Studio tasks.
+ * Supports nested data, predictions, and custom field mapping.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskTransformTemplates = exports.TaskTransformer = void 0;
+class TaskTransformer {
+    /**
+     * Transform source data to Label Studio tasks
+     *
+     * @param sourceData - Array of source data objects
+     * @param rule - Transformation rules
+     * @returns Array of Label Studio tasks
+     */
+    static transform(sourceData, rule) {
+        return sourceData.map(data => this.transformOne(data, rule)).filter(task => task !== null);
+    }
+    /**
+     * Transform a single data object
+     */
+    static transformOne(sourceData, rule) {
+        try {
+            // Build task data
+            const taskData = {};
+            for (const [lsField, sourcePath] of Object.entries(rule.dataFields)) {
+                const value = this.getNestedValue(sourceData, sourcePath);
+                if (value !== undefined) {
+                    taskData[lsField] = value;
+                }
+            }
+            // Skip if no data extracted
+            if (Object.keys(taskData).length === 0) {
+                return null;
+            }
+            const task = {
+                data: JSON.stringify(taskData)
+            };
+            // Add predictions if configured
+            if (rule.predictions?.enabled) {
+                const prediction = this.buildPrediction(sourceData, rule.predictions);
+                if (prediction) {
+                    task.predictions = [prediction];
+                }
+            }
+            // Add metadata if configured
+            if (rule.meta) {
+                const meta = {};
+                for (const [metaKey, sourcePath] of Object.entries(rule.meta)) {
+                    const value = this.getNestedValue(sourceData, sourcePath);
+                    if (value !== undefined) {
+                        meta[metaKey] = value;
+                    }
+                }
+                if (Object.keys(meta).length > 0) {
+                    task.meta = meta;
+                }
+            }
+            return task;
+        }
+        catch (error) {
+            console.error('Failed to transform task:', error);
+            return null;
+        }
+    }
+    /**
+     * Build prediction object from source data
+     */
+    static buildPrediction(sourceData, config) {
+        const result = this.getNestedValue(sourceData, config.resultPath);
+        if (!result) {
+            return null;
+        }
+        const prediction = {
+            result: config.resultTransform ? config.resultTransform(result) : result
+        };
+        if (config.scorePath) {
+            const score = this.getNestedValue(sourceData, config.scorePath);
+            if (score !== undefined) {
+                prediction.score = score;
+            }
+        }
+        if (config.modelVersion) {
+            prediction.model_version = config.modelVersion;
+        }
+        return prediction;
+    }
+    /**
+     * Get nested value from object using dot notation path
+     * Example: "metadata.user.name" -> obj.metadata.user.name
+     */
+    static getNestedValue(obj, path) {
+        if (!path || !obj)
+            return undefined;
+        const keys = path.split('.');
+        let current = obj;
+        for (const key of keys) {
+            if (current === null || current === undefined) {
+                return undefined;
+            }
+            // Support array indexing: "items[0].name"
+            const arrayMatch = key.match(/^(\w+)\[(\d+)\]$/);
+            if (arrayMatch) {
+                const [, arrayKey, index] = arrayMatch;
+                current = current[arrayKey]?.[parseInt(index, 10)];
+            }
+            else {
+                current = current[key];
+            }
+        }
+        return current;
+    }
+    /**
+     * Transform with multiple rules (useful for heterogeneous data)
+     */
+    static transformMultiRule(sourceData, rules) {
+        const tasks = [];
+        for (const rule of rules) {
+            tasks.push(...this.transform(sourceData, rule));
+        }
+        return tasks;
+    }
+}
+exports.TaskTransformer = TaskTransformer;
+/**
+ * Pre-built transformation templates for common scenarios
+ */
+class TaskTransformTemplates {
+    /**
+     * WBM Image Classification with AI predictions
+     */
+    static wbmImageClassification(includeAiPrediction = true) {
+        const rule = {
+            dataFields: {
+                image: 'image_url',
+                date: 'timestamp',
+                device_id: 'device_id'
+            },
+            meta: {
+                wafer_id: 'wafer_id',
+                lot_id: 'lot_id'
+            }
+        };
+        if (includeAiPrediction) {
+            rule.predictions = {
+                enabled: true,
+                resultPath: 'ai_prediction',
+                scorePath: 'confidence',
+                modelVersion: 'wbm-classifier-v1',
+                resultTransform: result => {
+                    // Transform AI result to Label Studio format
+                    return [
+                        {
+                            from_name: 'rank1',
+                            to_name: 'data',
+                            type: 'choices',
+                            value: {
+                                choices: [result.rank1]
+                            }
+                        },
+                        {
+                            from_name: 'rank2',
+                            to_name: 'data',
+                            type: 'choices',
+                            value: {
+                                choices: [result.rank2]
+                            }
+                        },
+                        {
+                            from_name: 'rank3',
+                            to_name: 'data',
+                            type: 'choices',
+                            value: {
+                                choices: [result.rank3]
+                            }
+                        }
+                    ];
+                }
+            };
+        }
+        return rule;
+    }
+    /**
+     * Simple image classification
+     */
+    static imageClassification(imageField = 'image_url') {
+        return {
+            dataFields: {
+                image: imageField
+            }
+        };
+    }
+    /**
+     * Text classification with metadata
+     */
+    static textClassification(textField = 'text', metaFields = []) {
+        const rule = {
+            dataFields: {
+                text: textField
+            }
+        };
+        if (metaFields.length > 0) {
+            rule.meta = {};
+            for (const field of metaFields) {
+                rule.meta[field] = field;
+            }
+        }
+        return rule;
+    }
+    /**
+     * Time series data
+     */
+    static timeSeries(valuesField, timestampField) {
+        const dataFields = {
+            timeseries: valuesField
+        };
+        if (timestampField) {
+            dataFields.timestamp = timestampField;
+        }
+        return {
+            dataFields
+        };
+    }
+    /**
+     * Object detection with bounding box predictions
+     */
+    static objectDetection(imageField = 'image_url', predictionsField) {
+        const rule = {
+            dataFields: {
+                image: imageField
+            }
+        };
+        if (predictionsField) {
+            rule.predictions = {
+                enabled: true,
+                resultPath: predictionsField,
+                resultTransform: bboxes => {
+                    // Transform bounding boxes to Label Studio format
+                    return bboxes.map((bbox) => ({
+                        from_name: 'bbox',
+                        to_name: 'data',
+                        type: 'rectanglelabels',
+                        value: {
+                            x: bbox.x,
+                            y: bbox.y,
+                            width: bbox.width,
+                            height: bbox.height,
+                            rectanglelabels: [bbox.label]
+                        }
+                    }));
+                }
+            };
+        }
+        return rule;
+    }
+}
+exports.TaskTransformTemplates = TaskTransformTemplates;
+//# sourceMappingURL=task-transformer.js.map

package/dist-server/utils/task-transformer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-transformer.js","sourceRoot":"","sources":["../../server/utils/task-transformer.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAyDH,MAAa,eAAe;IAC1B;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,UAAiB,EAAE,IAAuB;QACzD,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,IAAI,CAAsB,CAAA;IACjH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,UAAe,EAAE,IAAuB;QAC1D,IAAI,CAAC;YACH,kBAAkB;YAClB,MAAM,QAAQ,GAAQ,EAAE,CAAA;YACxB,KAAK,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;gBACpE,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;gBACzD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,QAAQ,CAAC,OAAO,CAAC,GAAG,KAAK,CAAA;gBAC3B,CAAC;YACH,CAAC;YAED,4BAA4B;YAC5B,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvC,OAAO,IAAI,CAAA;YACb,CAAC;YAED,MAAM,IAAI,GAAoB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;aAC/B,CAAA;YAED,gCAAgC;YAChC,IAAI,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;gBAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;gBACrE,IAAI,UAAU,EAAE,CAAC;oBACf,IAAI,CAAC,WAAW,GAAG,CAAC,UAAU,CAAC,CAAA;gBACjC,CAAC;YACH,CAAC;YAED,6BAA6B;YAC7B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,IAAI,GAAQ,EAAE,CAAA;gBACpB,KAAK,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;oBACzD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;wBACxB,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,CAAA;oBACvB,CAAC;gBACH,CAAC;gBACD,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;gBAClB,CAAC;YACH,CAAC;YAED,OAAO,IAAI,CAAA;QACb,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAA;YACjD,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,eAAe,CAC5B,UAAe,EACf,MAAwB;QAExB,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;QACjE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAA;QACb,CAAC;QAED,MAAM,UAAU,GAAQ;YACtB,MAAM,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM;SACzE,CAAA;QAED,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,CAAA;YAC/D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,UAAU,CAAC,KAAK,GAAG,KAAK,CAAA;YAC1B,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,UAAU,CAAC,aAAa,GAAG,MAAM,CAAC,YAAY,CAAA;QAChD,CAAC;QAED,OAAO,UAAU,CAAA;IACnB,CAAC;IAED;;;OAGG;IACK,MAAM,CAAC,cAAc,CAAC,GAAQ,EAAE,IAAY;QAClD,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAA;QAEnC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC5B,IAAI,OAAO,GAAG,GAAG,CAAA;QAEjB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC9C,OAAO,SAAS,CAAA;YAClB,CAAC;YAED,0CAA0C;YAC1C,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAA;YAChD,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,GAAG,UAAU,CAAA;gBACtC,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAA;YACpD,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;YACxB,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,UAAiB,EAAE,KAA0B;QACrE,MAAM,KAAK,GAAsB,EAAE,CAAA;QAEnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAA;QACjD,CAAC;QAED,OAAO,KAAK,CAAA;IACd,CAAC;CACF;AAtID,0CAsIC;AAED;;GAEG;AACH,MAAa,sBAAsB;IACjC;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,sBAA+B,IAAI;QAC/D,MAAM,IAAI,GAAsB;YAC9B,UAAU,EAAE;gBACV,KAAK,EAAE,WAAW;gBAClB,IAAI,EAAE,WAAW;gBACjB,SAAS,EAAE,WAAW;aACvB;YACD,IAAI,EAAE;gBACJ,QAAQ,EAAE,UAAU;gBACpB,MAAM,EAAE,QAAQ;aACjB;SACF,CAAA;QAED,IAAI,mBAAmB,EAAE,CAAC;YACxB,IAAI,CAAC,WAAW,GAAG;gBACjB,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,eAAe;gBAC3B,SAAS,EAAE,YAAY;gBACvB,YAAY,EAAE,mBAAmB;gBACjC,eAAe,EAAE,MAAM,CAAC,EAAE;oBACxB,6CAA6C;oBAC7C,OAAO;wBACL;4BACE,SAAS,EAAE,OAAO;4BAClB,OAAO,EAAE,MAAM;4BACf,IAAI,EAAE,SAAS;4BACf,KAAK,EAAE;gCACL,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;6BACxB;yBACF;wBACD;4BACE,SAAS,EAAE,OAAO;4BAClB,OAAO,EAAE,MAAM;4BACf,IAAI,EAAE,SAAS;4BACf,KAAK,EAAE;gCACL,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;6BACxB;yBACF;wBACD;4BACE,SAAS,EAAE,OAAO;4BAClB,OAAO,EAAE,MAAM;4BACf,IAAI,EAAE,SAAS;4BACf,KAAK,EAAE;gCACL,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;6BACxB;yBACF;qBACF,CAAA;gBACH,CAAC;aACF,CAAA;QACH,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,aAAqB,WAAW;QACzD,OAAO;YACL,UAAU,EAAE;gBACV,KAAK,EAAE,UAAU;aAClB;SACF,CAAA;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,YAAoB,MAAM,EAAE,aAAuB,EAAE;QAC7E,MAAM,IAAI,GAAsB;YAC9B,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;aAChB;SACF,CAAA;QAED,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,IAAI,GAAG,EAAE,CAAA;YACd,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;gBAC/B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,CAAA;YAC1B,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,WAAmB,EAAE,cAAuB;QAC5D,MAAM,UAAU,GAAQ;YACtB,UAAU,EAAE,WAAW;SACxB,CAAA;QAED,IAAI,cAAc,EAAE,CAAC;YACnB,UAAU,CAAC,SAAS,GAAG,cAAc,CAAA;QACvC,CAAC;QAED,OAAO;YACL,UAAU;SACX,CAAA;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,aAAqB,WAAW,EAAE,gBAAyB;QAChF,MAAM,IAAI,GAAsB;YAC9B,UAAU,EAAE;gBACV,KAAK,EAAE,UAAU;aAClB;SACF,CAAA;QAED,IAAI,gBAAgB,EAAE,CAAC;YACrB,IAAI,CAAC,WAAW,GAAG;gBACjB,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,gBAAgB;gBAC5B,eAAe,EAAE,MAAM,CAAC,EAAE;oBACxB,kDAAkD;oBAClD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,CAAC;wBAChC,SAAS,EAAE,MAAM;wBACjB,OAAO,EAAE,MAAM;wBACf,IAAI,EAAE,iBAAiB;wBACvB,KAAK,EAAE;4BACL,CAAC,EAAE,IAAI,CAAC,CAAC;4BACT,CAAC,EAAE,IAAI,CAAC,CAAC;4BACT,KAAK,EAAE,IAAI,CAAC,KAAK;4BACjB,MAAM,EAAE,IAAI,CAAC,MAAM;4BACnB,eAAe,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;yBAC9B;qBACF,CAAC,CAAC,CAAA;gBACL,CAAC;aACF,CAAA;QACH,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AA5ID,wDA4IC","sourcesContent":["/**\n * Task Transformer\n *\n * Flexible data transformation from any source format to Label Studio tasks.\n * Supports nested data, predictions, and custom field mapping.\n */\n\nexport interface TaskTransformRule {\n  /**\n   * Field mapping: Label Studio field name -> source data path\n   * Example: { \"image\": \"image_url\", \"date\": \"metadata.timestamp\" }\n   */\n  dataFields: { [lsField: string]: string }\n\n  /**\n   * Prediction configuration (optional)\n   */\n  predictions?: PredictionConfig\n\n  /**\n   * Metadata to attach to task (optional)\n   */\n  meta?: { [key: string]: string }\n}\n\nexport interface PredictionConfig {\n  /**\n   * Enable predictions\n   */\n  enabled: boolean\n\n  /**\n   * Path to prediction result in source data\n   */\n  resultPath: string\n\n  /**\n   * Path to confidence score (optional)\n   */\n  scorePath?: string\n\n  /**\n   * Model version identifier (optional)\n   */\n  modelVersion?: string\n\n  /**\n   * Transform function for prediction result\n   */\n  resultTransform?: (result: any) => any\n}\n\nexport interface LabelStudioTask {\n  data: string // JSON string\n  predictions?: Array<{\n    result: any\n    score?: number\n    model_version?: string\n  }>\n  meta?: any\n}\n\nexport class TaskTransformer {\n  /**\n   * Transform source data to Label Studio tasks\n   *\n   * @param sourceData - Array of source data objects\n   * @param rule - Transformation rules\n   * @returns Array of Label Studio tasks\n   */\n  static transform(sourceData: any[], rule: TaskTransformRule): LabelStudioTask[] {\n    return sourceData.map(data => this.transformOne(data, rule)).filter(task => task !== null) as LabelStudioTask[]\n  }\n\n  /**\n   * Transform a single data object\n   */\n  static transformOne(sourceData: any, rule: TaskTransformRule): LabelStudioTask | null {\n    try {\n      // Build task data\n      const taskData: any = {}\n      for (const [lsField, sourcePath] of Object.entries(rule.dataFields)) {\n        const value = this.getNestedValue(sourceData, sourcePath)\n        if (value !== undefined) {\n          taskData[lsField] = value\n        }\n      }\n\n      // Skip if no data extracted\n      if (Object.keys(taskData).length === 0) {\n        return null\n      }\n\n      const task: LabelStudioTask = {\n        data: JSON.stringify(taskData)\n      }\n\n      // Add predictions if configured\n      if (rule.predictions?.enabled) {\n        const prediction = this.buildPrediction(sourceData, rule.predictions)\n        if (prediction) {\n          task.predictions = [prediction]\n        }\n      }\n\n      // Add metadata if configured\n      if (rule.meta) {\n        const meta: any = {}\n        for (const [metaKey, sourcePath] of Object.entries(rule.meta)) {\n          const value = this.getNestedValue(sourceData, sourcePath)\n          if (value !== undefined) {\n            meta[metaKey] = value\n          }\n        }\n        if (Object.keys(meta).length > 0) {\n          task.meta = meta\n        }\n      }\n\n      return task\n    } catch (error) {\n      console.error('Failed to transform task:', error)\n      return null\n    }\n  }\n\n  /**\n   * Build prediction object from source data\n   */\n  private static buildPrediction(\n    sourceData: any,\n    config: PredictionConfig\n  ): { result: any; score?: number; model_version?: string } | null {\n    const result = this.getNestedValue(sourceData, config.resultPath)\n    if (!result) {\n      return null\n    }\n\n    const prediction: any = {\n      result: config.resultTransform ? config.resultTransform(result) : result\n    }\n\n    if (config.scorePath) {\n      const score = this.getNestedValue(sourceData, config.scorePath)\n      if (score !== undefined) {\n        prediction.score = score\n      }\n    }\n\n    if (config.modelVersion) {\n      prediction.model_version = config.modelVersion\n    }\n\n    return prediction\n  }\n\n  /**\n   * Get nested value from object using dot notation path\n   * Example: \"metadata.user.name\" -> obj.metadata.user.name\n   */\n  private static getNestedValue(obj: any, path: string): any {\n    if (!path || !obj) return undefined\n\n    const keys = path.split('.')\n    let current = obj\n\n    for (const key of keys) {\n      if (current === null || current === undefined) {\n        return undefined\n      }\n\n      // Support array indexing: \"items[0].name\"\n      const arrayMatch = key.match(/^(\\w+)\\[(\\d+)\\]$/)\n      if (arrayMatch) {\n        const [, arrayKey, index] = arrayMatch\n        current = current[arrayKey]?.[parseInt(index, 10)]\n      } else {\n        current = current[key]\n      }\n    }\n\n    return current\n  }\n\n  /**\n   * Transform with multiple rules (useful for heterogeneous data)\n   */\n  static transformMultiRule(sourceData: any[], rules: TaskTransformRule[]): LabelStudioTask[] {\n    const tasks: LabelStudioTask[] = []\n\n    for (const rule of rules) {\n      tasks.push(...this.transform(sourceData, rule))\n    }\n\n    return tasks\n  }\n}\n\n/**\n * Pre-built transformation templates for common scenarios\n */\nexport class TaskTransformTemplates {\n  /**\n   * WBM Image Classification with AI predictions\n   */\n  static wbmImageClassification(includeAiPrediction: boolean = true): TaskTransformRule {\n    const rule: TaskTransformRule = {\n      dataFields: {\n        image: 'image_url',\n        date: 'timestamp',\n        device_id: 'device_id'\n      },\n      meta: {\n        wafer_id: 'wafer_id',\n        lot_id: 'lot_id'\n      }\n    }\n\n    if (includeAiPrediction) {\n      rule.predictions = {\n        enabled: true,\n        resultPath: 'ai_prediction',\n        scorePath: 'confidence',\n        modelVersion: 'wbm-classifier-v1',\n        resultTransform: result => {\n          // Transform AI result to Label Studio format\n          return [\n            {\n              from_name: 'rank1',\n              to_name: 'data',\n              type: 'choices',\n              value: {\n                choices: [result.rank1]\n              }\n            },\n            {\n              from_name: 'rank2',\n              to_name: 'data',\n              type: 'choices',\n              value: {\n                choices: [result.rank2]\n              }\n            },\n            {\n              from_name: 'rank3',\n              to_name: 'data',\n              type: 'choices',\n              value: {\n                choices: [result.rank3]\n              }\n            }\n          ]\n        }\n      }\n    }\n\n    return rule\n  }\n\n  /**\n   * Simple image classification\n   */\n  static imageClassification(imageField: string = 'image_url'): TaskTransformRule {\n    return {\n      dataFields: {\n        image: imageField\n      }\n    }\n  }\n\n  /**\n   * Text classification with metadata\n   */\n  static textClassification(textField: string = 'text', metaFields: string[] = []): TaskTransformRule {\n    const rule: TaskTransformRule = {\n      dataFields: {\n        text: textField\n      }\n    }\n\n    if (metaFields.length > 0) {\n      rule.meta = {}\n      for (const field of metaFields) {\n        rule.meta[field] = field\n      }\n    }\n\n    return rule\n  }\n\n  /**\n   * Time series data\n   */\n  static timeSeries(valuesField: string, timestampField?: string): TaskTransformRule {\n    const dataFields: any = {\n      timeseries: valuesField\n    }\n\n    if (timestampField) {\n      dataFields.timestamp = timestampField\n    }\n\n    return {\n      dataFields\n    }\n  }\n\n  /**\n   * Object detection with bounding box predictions\n   */\n  static objectDetection(imageField: string = 'image_url', predictionsField?: string): TaskTransformRule {\n    const rule: TaskTransformRule = {\n      dataFields: {\n        image: imageField\n      }\n    }\n\n    if (predictionsField) {\n      rule.predictions = {\n        enabled: true,\n        resultPath: predictionsField,\n        resultTransform: bboxes => {\n          // Transform bounding boxes to Label Studio format\n          return bboxes.map((bbox: any) => ({\n            from_name: 'bbox',\n            to_name: 'data',\n            type: 'rectanglelabels',\n            value: {\n              x: bbox.x,\n              y: bbox.y,\n              width: bbox.width,\n              height: bbox.height,\n              rectanglelabels: [bbox.label]\n            }\n          }))\n        }\n      }\n    }\n\n    return rule\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@things-factory/integration-label-studio",
+  "version": "9.1.19",
+  "main": "dist-server/index.js",
+  "browser": "dist-client/index.js",
+  "things-factory": true,
+  "author": "Things-Factory Team",
+  "description": "Integration module for embedding Label Studio in Things-Factory with SSO support",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "@things-factory:registry": "https://registry.npmjs.org"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hatiolab/things-factory.git",
+    "directory": "packages/integration-label-studio"
+  },
+  "scripts": {
+    "build": "npm run build:server && npm run build:client",
+    "copy:files": "copyfiles -e \"./client/**/*.{ts,js,json}\" -u 1 \"./client/**/*\" dist-client",
+    "build:client": "npm run copy:files && npx tsc --p ./client/tsconfig.json",
+    "build:server": "npx tsc --p ./server/tsconfig.json",
+    "clean:client": "npx rimraf dist-client",
+    "clean:server": "npx rimraf dist-server",
+    "clean": "npm run clean:server && npm run clean:client"
+  },
+  "dependencies": {
+    "@operato/graphql": "^9.0.0",
+    "@operato/layout": "^9.0.0",
+    "@things-factory/ai-inference": "^9.1.19",
+    "@things-factory/auth-base": "^9.1.19",
+    "@things-factory/dataset": "^9.1.19",
+    "@things-factory/env": "^9.1.0",
+    "@things-factory/menu-base": "^9.1.19",
+    "@things-factory/shell": "^9.1.19"
+  },
+  "keywords": [
+    "things-factory",
+    "label-studio",
+    "integration",
+    "iframe",
+    "sso",
+    "data-labeling"
+  ],
+  "gitHead": "078438034dbe19915108e89ff24024f7044a85a9"
+}