@uipath/apollo-react 6.45.3 → 6.46.0

package/dist/canvas/components/Guardrails/types.d.ts

@@ -0,0 +1,69 @@
+import type * as React from 'react';
+import type { GuardrailValidatorFormLabels } from './i18n';
+export type GuardrailValidatorParameter = {
+    $parameterType: 'number';
+    id: string;
+    value: number;
+} | {
+    $parameterType: 'text';
+    id: string;
+    value: string;
+} | {
+    $parameterType: 'boolean';
+    id: string;
+    value: boolean;
+} | {
+    $parameterType: 'enum';
+    id: string;
+    value: string;
+} | {
+    $parameterType: 'enum-list';
+    id: string;
+    value: string[];
+} | {
+    $parameterType: 'text-list';
+    id: string;
+    value: string[];
+} | {
+    $parameterType: 'map-enum';
+    id: string;
+    value: Record<string, number>;
+};
+export type GuardrailParameterType = GuardrailValidatorParameter['$parameterType'];
+export interface GuardrailParameterDefinition {
+    id: string;
+    type: GuardrailParameterType;
+    label: string;
+    required: boolean;
+    defaultValue: unknown;
+    tooltip?: string;
+    options?: string[];
+    optionLabels?: Record<string, string>;
+    keySource?: string;
+    min?: number;
+    max?: number;
+    step?: number;
+    maxLength?: number;
+    maxItems?: number;
+}
+export interface GuardrailParameterRenderContext {
+    definition: GuardrailParameterDefinition;
+    value: GuardrailValidatorParameter['value'] | undefined;
+    error?: string;
+    parameters: GuardrailValidatorParameter[];
+    onValueChange: (value: GuardrailValidatorParameter['value']) => void;
+    onParametersChange: (parameters: GuardrailValidatorParameter[]) => void;
+}
+export interface GuardrailValidatorFormProps {
+    parameterDefinitions: GuardrailParameterDefinition[];
+    parameters: GuardrailValidatorParameter[];
+    onChange: (parameters: GuardrailValidatorParameter[]) => void;
+    errors?: Record<string, string>;
+    onClearError?: (paramId: string) => void;
+    renderParameter?: (ctx: GuardrailParameterRenderContext) => React.ReactNode | undefined;
+    overrideParameterIds?: readonly string[];
+    validateLive?: boolean;
+    labels?: Partial<GuardrailValidatorFormLabels>;
+    className?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/canvas/components/Guardrails/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/canvas/components/Guardrails/types.ts"],"names":[],"mappings":"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"}

package/dist/canvas/components/Guardrails/use-metadata-form-bridge.cjs

@@ -0,0 +1,144 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    useMetadataFormBridge: ()=>useMetadataFormBridge
+});
+const external_react_namespaceObject = require("react");
+function valuesEqual(a, b) {
+    if (Object.is(a, b)) return true;
+    if ('object' != typeof a || 'object' != typeof b || null === a || null === b) return false;
+    if (Array.isArray(a) || Array.isArray(b)) {
+        if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) return false;
+        return a.every((item, index)=>valuesEqual(item, b[index]));
+    }
+    const aEntries = Object.entries(a);
+    const bRecord = b;
+    if (aEntries.length !== Object.keys(bRecord).length) return false;
+    return aEntries.every(([key, value])=>Object.hasOwn(bRecord, key) && valuesEqual(value, bRecord[key]));
+}
+function useMetadataFormBridge({ values, errors, onValueChange, components, validateLive = true }) {
+    const formRef = (0, external_react_namespaceObject.useRef)(null);
+    const syncingRef = (0, external_react_namespaceObject.useRef)(false);
+    const onValueChangeRef = (0, external_react_namespaceObject.useRef)(onValueChange);
+    onValueChangeRef.current = onValueChange;
+    const pendingValuesRef = (0, external_react_namespaceObject.useRef)(null);
+    const syncValuesIn = (form, next)=>{
+        syncingRef.current = true;
+        try {
+            for (const [name, value] of Object.entries(next))if (!valuesEqual(form.getValues(name), value)) form.setValue(name, value);
+        } finally{
+            syncingRef.current = false;
+        }
+    };
+    const syncValuesInRef = (0, external_react_namespaceObject.useRef)(syncValuesIn);
+    syncValuesInRef.current = syncValuesIn;
+    const plugins = (0, external_react_namespaceObject.useMemo)(()=>[
+            {
+                name: 'guardrail-host-bridge',
+                components,
+                onFormInit: (context)=>{
+                    formRef.current = context.form;
+                    const pending = pendingValuesRef.current;
+                    if (pending) {
+                        pendingValuesRef.current = null;
+                        syncValuesInRef.current(context.form, pending);
+                    }
+                },
+                onValueChange: (name, value)=>{
+                    if (syncingRef.current) return;
+                    onValueChangeRef.current(name, value);
+                }
+            }
+        ], [
+        components
+    ]);
+    (0, external_react_namespaceObject.useEffect)(()=>{
+        const form = formRef.current;
+        if (!form) {
+            pendingValuesRef.current = values;
+            return;
+        }
+        syncValuesInRef.current(form, values);
+    }, [
+        values
+    ]);
+    const appliedRef = (0, external_react_namespaceObject.useRef)({});
+    const applyHostError = (form, name, message)=>{
+        const current = form.getFieldState(name).error;
+        if (current?.type === 'external' && current.message === message) return;
+        form.setError(name, {
+            type: 'external',
+            message
+        });
+    };
+    (0, external_react_namespaceObject.useEffect)(()=>{
+        const form = formRef.current;
+        if (!form) return;
+        const next = {};
+        for (const [name, message] of Object.entries(errors ?? {}))if (message) {
+            next[name] = message;
+            applyHostError(form, name, message);
+        }
+        for (const name of Object.keys(appliedRef.current))if (!next[name] && form.getFieldState(name).error?.type === 'external') form.clearErrors(name);
+        appliedRef.current = next;
+    }, [
+        errors
+    ]);
+    (0, external_react_namespaceObject.useEffect)(()=>{
+        const form = formRef.current;
+        if (!form) return;
+        return form.subscribe({
+            formState: {
+                values: true
+            },
+            callback: ()=>{
+                const current = formRef.current;
+                if (!current) return;
+                for (const [name, message] of Object.entries(appliedRef.current))applyHostError(current, name, message);
+            }
+        });
+    }, []);
+    const wasValidatingLiveRef = (0, external_react_namespaceObject.useRef)(validateLive);
+    (0, external_react_namespaceObject.useEffect)(()=>{
+        const openedGate = validateLive && !wasValidatingLiveRef.current;
+        wasValidatingLiveRef.current = validateLive;
+        if (!openedGate) return;
+        formRef.current?.trigger();
+    }, [
+        validateLive
+    ]);
+    return {
+        plugins,
+        schemaMode: validateLive ? 'onChange' : 'onSubmit'
+    };
+}
+exports.useMetadataFormBridge = __webpack_exports__.useMetadataFormBridge;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "useMetadataFormBridge"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/canvas/components/Guardrails/use-metadata-form-bridge.d.ts

@@ -0,0 +1,13 @@
+import type { FormPlugin, FormSchema } from '@uipath/apollo-wind';
+export interface MetadataFormBridgeOptions {
+    values: Record<string, unknown>;
+    errors?: Record<string, string>;
+    onValueChange: (name: string, value: unknown) => void;
+    components: FormPlugin['components'];
+    validateLive?: boolean;
+}
+export declare function useMetadataFormBridge({ values, errors, onValueChange, components, validateLive, }: MetadataFormBridgeOptions): {
+    plugins: FormPlugin[];
+    schemaMode: FormSchema['mode'];
+};
+//# sourceMappingURL=use-metadata-form-bridge.d.ts.map

package/dist/canvas/components/Guardrails/use-metadata-form-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-metadata-form-bridge.d.ts","sourceRoot":"","sources":["../../../../src/canvas/components/Guardrails/use-metadata-form-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAsB/E,MAAM,WAAW,yBAAyB;IAExC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEhC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAEtD,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;IAErC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAiCD,wBAAgB,qBAAqB,CAAC,EACpC,MAAM,EACN,MAAM,EACN,aAAa,EACb,UAAU,EACV,YAAmB,GACpB,EAAE,yBAAyB,GAAG;IAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IAAC,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,CAAA;CAAE,CA8IvF"}

package/dist/canvas/components/Guardrails/use-metadata-form-bridge.js

@@ -0,0 +1,110 @@
+import { useEffect, useMemo, useRef } from "react";
+function valuesEqual(a, b) {
+    if (Object.is(a, b)) return true;
+    if ('object' != typeof a || 'object' != typeof b || null === a || null === b) return false;
+    if (Array.isArray(a) || Array.isArray(b)) {
+        if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) return false;
+        return a.every((item, index)=>valuesEqual(item, b[index]));
+    }
+    const aEntries = Object.entries(a);
+    const bRecord = b;
+    if (aEntries.length !== Object.keys(bRecord).length) return false;
+    return aEntries.every(([key, value])=>Object.hasOwn(bRecord, key) && valuesEqual(value, bRecord[key]));
+}
+function useMetadataFormBridge({ values, errors, onValueChange, components, validateLive = true }) {
+    const formRef = useRef(null);
+    const syncingRef = useRef(false);
+    const onValueChangeRef = useRef(onValueChange);
+    onValueChangeRef.current = onValueChange;
+    const pendingValuesRef = useRef(null);
+    const syncValuesIn = (form, next)=>{
+        syncingRef.current = true;
+        try {
+            for (const [name, value] of Object.entries(next))if (!valuesEqual(form.getValues(name), value)) form.setValue(name, value);
+        } finally{
+            syncingRef.current = false;
+        }
+    };
+    const syncValuesInRef = useRef(syncValuesIn);
+    syncValuesInRef.current = syncValuesIn;
+    const plugins = useMemo(()=>[
+            {
+                name: 'guardrail-host-bridge',
+                components,
+                onFormInit: (context)=>{
+                    formRef.current = context.form;
+                    const pending = pendingValuesRef.current;
+                    if (pending) {
+                        pendingValuesRef.current = null;
+                        syncValuesInRef.current(context.form, pending);
+                    }
+                },
+                onValueChange: (name, value)=>{
+                    if (syncingRef.current) return;
+                    onValueChangeRef.current(name, value);
+                }
+            }
+        ], [
+        components
+    ]);
+    useEffect(()=>{
+        const form = formRef.current;
+        if (!form) {
+            pendingValuesRef.current = values;
+            return;
+        }
+        syncValuesInRef.current(form, values);
+    }, [
+        values
+    ]);
+    const appliedRef = useRef({});
+    const applyHostError = (form, name, message)=>{
+        const current = form.getFieldState(name).error;
+        if (current?.type === 'external' && current.message === message) return;
+        form.setError(name, {
+            type: 'external',
+            message
+        });
+    };
+    useEffect(()=>{
+        const form = formRef.current;
+        if (!form) return;
+        const next = {};
+        for (const [name, message] of Object.entries(errors ?? {}))if (message) {
+            next[name] = message;
+            applyHostError(form, name, message);
+        }
+        for (const name of Object.keys(appliedRef.current))if (!next[name] && form.getFieldState(name).error?.type === 'external') form.clearErrors(name);
+        appliedRef.current = next;
+    }, [
+        errors
+    ]);
+    useEffect(()=>{
+        const form = formRef.current;
+        if (!form) return;
+        return form.subscribe({
+            formState: {
+                values: true
+            },
+            callback: ()=>{
+                const current = formRef.current;
+                if (!current) return;
+                for (const [name, message] of Object.entries(appliedRef.current))applyHostError(current, name, message);
+            }
+        });
+    }, []);
+    const wasValidatingLiveRef = useRef(validateLive);
+    useEffect(()=>{
+        const openedGate = validateLive && !wasValidatingLiveRef.current;
+        wasValidatingLiveRef.current = validateLive;
+        if (!openedGate) return;
+        formRef.current?.trigger();
+    }, [
+        validateLive
+    ]);
+    return {
+        plugins,
+        schemaMode: validateLive ? 'onChange' : 'onSubmit'
+    };
+}
+export { useMetadataFormBridge };

package/dist/canvas/components/Guardrails/utils.cjs

@@ -0,0 +1,174 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    coerceParameterValueToType: ()=>coerceParameterValueToType,
+    dropEmptyOptionalParameters: ()=>dropEmptyOptionalParameters,
+    getOutOfRangeParameterIds: ()=>getOutOfRangeParameterIds,
+    getRequiredEmptyParameterIds: ()=>getRequiredEmptyParameterIds,
+    normalizeGuardrailParameters: ()=>normalizeGuardrailParameters,
+    seedGuardrailParameters: ()=>seedGuardrailParameters,
+    syncMapEnumParameters: ()=>syncMapEnumParameters
+});
+function coerceParameterValueToType(value, paramDef) {
+    switch(paramDef.type){
+        case 'text':
+        case 'enum':
+            return 'string' == typeof value ? value : '';
+        case 'boolean':
+            return 'boolean' == typeof value ? value : false;
+        case 'number':
+            return 'number' != typeof value || Number.isNaN(value) ? paramDef.min ?? 0 : value;
+        case 'text-list':
+        case 'enum-list':
+            return Array.isArray(value) ? value.filter((v)=>'string' == typeof v) : [];
+        case 'map-enum':
+            return value && 'object' == typeof value && !Array.isArray(value) ? value : {};
+        default:
+            return value;
+    }
+}
+function seedGuardrailParameters(definitions, existing) {
+    if (existing) return normalizeGuardrailParameters(existing, definitions);
+    return definitions.map((paramDef)=>({
+            $parameterType: paramDef.type,
+            id: paramDef.id,
+            value: coerceParameterValueToType(paramDef.defaultValue, paramDef)
+        }));
+}
+function normalizeGuardrailParameters(parameters, definitions) {
+    const defById = new Map(definitions.map((d)=>[
+            d.id,
+            d
+        ]));
+    let changed = false;
+    const next = parameters.map((param)=>{
+        const paramDef = defById.get(param.id);
+        if (!paramDef) return param;
+        const value = coerceParameterValueToType(param.value, paramDef);
+        const type = paramDef.type;
+        if (value === param.value && type === param.$parameterType) return param;
+        changed = true;
+        return {
+            ...param,
+            $parameterType: type,
+            value
+        };
+    });
+    return changed ? next : parameters;
+}
+function syncMapEnumParameters(parameters, definitions) {
+    const selectionBySourceId = new Map();
+    for (const param of parameters)if ('enum-list' === param.$parameterType && Array.isArray(param.value)) selectionBySourceId.set(param.id, param.value);
+    const defById = new Map(definitions.map((d)=>[
+            d.id,
+            d
+        ]));
+    return parameters.map((param)=>{
+        if ('map-enum' !== param.$parameterType) return param;
+        const def = defById.get(param.id);
+        const keySource = def?.keySource;
+        if (!keySource) return param;
+        const sourceDef = defById.get(keySource);
+        const allowedKeys = selectionBySourceId.get(keySource) ?? (Array.isArray(sourceDef?.defaultValue) ? sourceDef.defaultValue : void 0);
+        if (!allowedKeys) return param;
+        const currentMap = param.value && 'object' == typeof param.value && !Array.isArray(param.value) ? param.value : {};
+        const defaults = def?.defaultValue ?? {};
+        const fallback = def?.min ?? 0;
+        const synced = {};
+        for (const key of allowedKeys){
+            const persisted = currentMap[key];
+            synced[key] = 'number' == typeof persisted && Number.isFinite(persisted) ? persisted : defaults[key] ?? fallback;
+        }
+        return {
+            ...param,
+            value: synced
+        };
+    });
+}
+function dropEmptyOptionalParameters(parameters, definitions) {
+    return parameters.filter((param)=>{
+        const parameterDefinition = definitions.find((p)=>p.id === param.id);
+        if (!parameterDefinition || parameterDefinition.required) return true;
+        const isEmpty = 'string' == typeof param.value && '' === param.value || Array.isArray(param.value) && 0 === param.value.length;
+        return !isEmpty;
+    });
+}
+function getOutOfRangeParameterIds(definitions, parameters) {
+    const isOutOfRange = (value, paramDef)=>null != paramDef.min && value < paramDef.min || null != paramDef.max && value > paramDef.max;
+    const ids = [];
+    for (const paramDef of definitions){
+        if ('number' !== paramDef.type && 'map-enum' !== paramDef.type) continue;
+        if (null == paramDef.min && null == paramDef.max) continue;
+        const value = parameters.find((p)=>p.id === paramDef.id)?.value;
+        if ('number' === paramDef.type) {
+            if ('number' != typeof value || Number.isNaN(value)) continue;
+            if (isOutOfRange(value, paramDef)) ids.push(paramDef.id);
+            continue;
+        }
+        if (null == value || 'object' != typeof value || Array.isArray(value)) continue;
+        const entries = Object.values(value);
+        if (entries.some((entry)=>'number' == typeof entry && !Number.isNaN(entry) && isOutOfRange(entry, paramDef))) ids.push(paramDef.id);
+    }
+    return ids;
+}
+function getRequiredEmptyParameterIds(definitions, parameters) {
+    const emptyIds = [];
+    for (const paramDef of definitions){
+        if (!paramDef.required) continue;
+        const param = parameters.find((p)=>p.id === paramDef.id);
+        if (!param) {
+            emptyIds.push(paramDef.id);
+            continue;
+        }
+        const value = param.value;
+        let isEmpty = false;
+        if ('enum-list' === paramDef.type && Array.isArray(value)) isEmpty = 0 === value.length;
+        else if ('text-list' === paramDef.type && Array.isArray(value)) isEmpty = value.every((entry)=>'string' == typeof entry && 0 === entry.trim().length);
+        else if (('text' === paramDef.type || 'enum' === paramDef.type) && 'string' == typeof value) isEmpty = 0 === value.trim().length;
+        else if ('map-enum' === paramDef.type && 'object' == typeof value && null !== value && !Array.isArray(value)) isEmpty = 0 === Object.keys(value).length;
+        if (isEmpty) emptyIds.push(paramDef.id);
+    }
+    return emptyIds;
+}
+exports.coerceParameterValueToType = __webpack_exports__.coerceParameterValueToType;
+exports.dropEmptyOptionalParameters = __webpack_exports__.dropEmptyOptionalParameters;
+exports.getOutOfRangeParameterIds = __webpack_exports__.getOutOfRangeParameterIds;
+exports.getRequiredEmptyParameterIds = __webpack_exports__.getRequiredEmptyParameterIds;
+exports.normalizeGuardrailParameters = __webpack_exports__.normalizeGuardrailParameters;
+exports.seedGuardrailParameters = __webpack_exports__.seedGuardrailParameters;
+exports.syncMapEnumParameters = __webpack_exports__.syncMapEnumParameters;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "coerceParameterValueToType",
+    "dropEmptyOptionalParameters",
+    "getOutOfRangeParameterIds",
+    "getRequiredEmptyParameterIds",
+    "normalizeGuardrailParameters",
+    "seedGuardrailParameters",
+    "syncMapEnumParameters"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/canvas/components/Guardrails/utils.d.ts

@@ -0,0 +1,9 @@
+import type { GuardrailParameterDefinition, GuardrailValidatorParameter } from './types';
+export declare function coerceParameterValueToType(value: unknown, paramDef: Pick<GuardrailParameterDefinition, 'type' | 'min'>): GuardrailValidatorParameter['value'];
+export declare function seedGuardrailParameters(definitions: GuardrailParameterDefinition[], existing?: GuardrailValidatorParameter[]): GuardrailValidatorParameter[];
+export declare function normalizeGuardrailParameters(parameters: readonly GuardrailValidatorParameter[], definitions: readonly GuardrailParameterDefinition[]): GuardrailValidatorParameter[];
+export declare function syncMapEnumParameters(parameters: GuardrailValidatorParameter[], definitions: GuardrailParameterDefinition[]): GuardrailValidatorParameter[];
+export declare function dropEmptyOptionalParameters(parameters: readonly GuardrailValidatorParameter[], definitions: readonly GuardrailParameterDefinition[]): GuardrailValidatorParameter[];
+export declare function getOutOfRangeParameterIds(definitions: readonly GuardrailParameterDefinition[], parameters: readonly GuardrailValidatorParameter[]): string[];
+export declare function getRequiredEmptyParameterIds(definitions: readonly GuardrailParameterDefinition[], parameters: readonly GuardrailValidatorParameter[]): string[];
+//# sourceMappingURL=utils.d.ts.map

package/dist/canvas/components/Guardrails/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/canvas/components/Guardrails/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAczF,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,IAAI,CAAC,4BAA4B,EAAE,MAAM,GAAG,KAAK,CAAC,GAC3D,2BAA2B,CAAC,OAAO,CAAC,CAmBtC;AAQD,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,4BAA4B,EAAE,EAC3C,QAAQ,CAAC,EAAE,2BAA2B,EAAE,GACvC,2BAA2B,EAAE,CAU/B;AAWD,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,SAAS,2BAA2B,EAAE,EAClD,WAAW,EAAE,SAAS,4BAA4B,EAAE,GACnD,2BAA2B,EAAE,CAoB/B;AAcD,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,2BAA2B,EAAE,EACzC,WAAW,EAAE,4BAA4B,EAAE,GAC1C,2BAA2B,EAAE,CA2C/B;AAQD,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,SAAS,2BAA2B,EAAE,EAClD,WAAW,EAAE,SAAS,4BAA4B,EAAE,GACnD,2BAA2B,EAAE,CAW/B;AAeD,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,SAAS,4BAA4B,EAAE,EACpD,UAAU,EAAE,SAAS,2BAA2B,EAAE,GACjD,MAAM,EAAE,CA6BV;AAUD,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,SAAS,4BAA4B,EAAE,EACpD,UAAU,EAAE,SAAS,2BAA2B,EAAE,GACjD,MAAM,EAAE,CA+BV"}

package/dist/canvas/components/Guardrails/utils.js

@@ -0,0 +1,122 @@
+function coerceParameterValueToType(value, paramDef) {
+    switch(paramDef.type){
+        case 'text':
+        case 'enum':
+            return 'string' == typeof value ? value : '';
+        case 'boolean':
+            return 'boolean' == typeof value ? value : false;
+        case 'number':
+            return 'number' != typeof value || Number.isNaN(value) ? paramDef.min ?? 0 : value;
+        case 'text-list':
+        case 'enum-list':
+            return Array.isArray(value) ? value.filter((v)=>'string' == typeof v) : [];
+        case 'map-enum':
+            return value && 'object' == typeof value && !Array.isArray(value) ? value : {};
+        default:
+            return value;
+    }
+}
+function seedGuardrailParameters(definitions, existing) {
+    if (existing) return normalizeGuardrailParameters(existing, definitions);
+    return definitions.map((paramDef)=>({
+            $parameterType: paramDef.type,
+            id: paramDef.id,
+            value: coerceParameterValueToType(paramDef.defaultValue, paramDef)
+        }));
+}
+function normalizeGuardrailParameters(parameters, definitions) {
+    const defById = new Map(definitions.map((d)=>[
+            d.id,
+            d
+        ]));
+    let changed = false;
+    const next = parameters.map((param)=>{
+        const paramDef = defById.get(param.id);
+        if (!paramDef) return param;
+        const value = coerceParameterValueToType(param.value, paramDef);
+        const type = paramDef.type;
+        if (value === param.value && type === param.$parameterType) return param;
+        changed = true;
+        return {
+            ...param,
+            $parameterType: type,
+            value
+        };
+    });
+    return changed ? next : parameters;
+}
+function syncMapEnumParameters(parameters, definitions) {
+    const selectionBySourceId = new Map();
+    for (const param of parameters)if ('enum-list' === param.$parameterType && Array.isArray(param.value)) selectionBySourceId.set(param.id, param.value);
+    const defById = new Map(definitions.map((d)=>[
+            d.id,
+            d
+        ]));
+    return parameters.map((param)=>{
+        if ('map-enum' !== param.$parameterType) return param;
+        const def = defById.get(param.id);
+        const keySource = def?.keySource;
+        if (!keySource) return param;
+        const sourceDef = defById.get(keySource);
+        const allowedKeys = selectionBySourceId.get(keySource) ?? (Array.isArray(sourceDef?.defaultValue) ? sourceDef.defaultValue : void 0);
+        if (!allowedKeys) return param;
+        const currentMap = param.value && 'object' == typeof param.value && !Array.isArray(param.value) ? param.value : {};
+        const defaults = def?.defaultValue ?? {};
+        const fallback = def?.min ?? 0;
+        const synced = {};
+        for (const key of allowedKeys){
+            const persisted = currentMap[key];
+            synced[key] = 'number' == typeof persisted && Number.isFinite(persisted) ? persisted : defaults[key] ?? fallback;
+        }
+        return {
+            ...param,
+            value: synced
+        };
+    });
+}
+function dropEmptyOptionalParameters(parameters, definitions) {
+    return parameters.filter((param)=>{
+        const parameterDefinition = definitions.find((p)=>p.id === param.id);
+        if (!parameterDefinition || parameterDefinition.required) return true;
+        const isEmpty = 'string' == typeof param.value && '' === param.value || Array.isArray(param.value) && 0 === param.value.length;
+        return !isEmpty;
+    });
+}
+function getOutOfRangeParameterIds(definitions, parameters) {
+    const isOutOfRange = (value, paramDef)=>null != paramDef.min && value < paramDef.min || null != paramDef.max && value > paramDef.max;
+    const ids = [];
+    for (const paramDef of definitions){
+        if ('number' !== paramDef.type && 'map-enum' !== paramDef.type) continue;
+        if (null == paramDef.min && null == paramDef.max) continue;
+        const value = parameters.find((p)=>p.id === paramDef.id)?.value;
+        if ('number' === paramDef.type) {
+            if ('number' != typeof value || Number.isNaN(value)) continue;
+            if (isOutOfRange(value, paramDef)) ids.push(paramDef.id);
+            continue;
+        }
+        if (null == value || 'object' != typeof value || Array.isArray(value)) continue;
+        const entries = Object.values(value);
+        if (entries.some((entry)=>'number' == typeof entry && !Number.isNaN(entry) && isOutOfRange(entry, paramDef))) ids.push(paramDef.id);
+    }
+    return ids;
+}
+function getRequiredEmptyParameterIds(definitions, parameters) {
+    const emptyIds = [];
+    for (const paramDef of definitions){
+        if (!paramDef.required) continue;
+        const param = parameters.find((p)=>p.id === paramDef.id);
+        if (!param) {
+            emptyIds.push(paramDef.id);
+            continue;
+        }
+        const value = param.value;
+        let isEmpty = false;
+        if ('enum-list' === paramDef.type && Array.isArray(value)) isEmpty = 0 === value.length;
+        else if ('text-list' === paramDef.type && Array.isArray(value)) isEmpty = value.every((entry)=>'string' == typeof entry && 0 === entry.trim().length);
+        else if (('text' === paramDef.type || 'enum' === paramDef.type) && 'string' == typeof value) isEmpty = 0 === value.trim().length;
+        else if ('map-enum' === paramDef.type && 'object' == typeof value && null !== value && !Array.isArray(value)) isEmpty = 0 === Object.keys(value).length;
+        if (isEmpty) emptyIds.push(paramDef.id);
+    }
+    return emptyIds;
+}
+export { coerceParameterValueToType, dropEmptyOptionalParameters, getOutOfRangeParameterIds, getRequiredEmptyParameterIds, normalizeGuardrailParameters, seedGuardrailParameters, syncMapEnumParameters };