@rytass/bpm-core-nestjs-module 0.7.0 → 0.9.0

package/src/lib/form-data-source/form-data-source-value-resolver.service.js

@@ -0,0 +1,401 @@
+"use strict";
+var FormDataSourceValueResolverService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FormDataSourceValueResolverService = void 0;
+const tslib_1 = require("tslib");
+const node_crypto_1 = require("node:crypto");
+const common_1 = require("@nestjs/common");
+const form_1 = require("@rytass/bpm-core-shared/form");
+const form_data_source_errors_1 = require("./form-data-source.errors");
+const form_data_source_types_1 = require("./form-data-source.types");
+const MAX_PARAMETER_BYTES = 16_384;
+const PROVIDER_TIMEOUT_MS = 5_000;
+const SOURCE_CONTROLS = [
+    'autocomplete',
+    'checkbox',
+    'radio',
+    'select',
+];
+const PARAMETER_TYPES = [
+    'BOOLEAN',
+    'NUMBER',
+    'STRING',
+    'STRING_ARRAY',
+];
+let FormDataSourceValueResolverService = FormDataSourceValueResolverService_1 = class FormDataSourceValueResolverService {
+    constructor(registry) {
+        this.registry = registry;
+        this.logger = new common_1.Logger(FormDataSourceValueResolverService_1.name);
+    }
+    async resolveFormDataOptionSnapshots(input) {
+        const entries = await Promise.all(input.schema.fields.map(async (field) => {
+            if (!(0, form_1.isFormDataSourceFieldDefinition)(field)) {
+                return null;
+            }
+            const values = readDynamicFieldValues(field, input.formData[field.fieldKey]);
+            if (values.length === 0) {
+                return null;
+            }
+            const previousSnapshot = input.previousSnapshots?.[field.fieldKey];
+            const valueUnchanged = isSameFieldValue(input.previousFormData?.[field.fieldKey], input.formData[field.fieldKey]);
+            const source = this.registry.get(field.dataSource.key, field.dataSource.version);
+            if (!source) {
+                if (!input.revalidateAll &&
+                    previousSnapshot &&
+                    valueUnchanged &&
+                    previousSnapshot.dataSourceKey === field.dataSource.key &&
+                    previousSnapshot.dataSourceVersion === field.dataSource.version) {
+                    return [field.fieldKey, previousSnapshot];
+                }
+                throw this.createSourceMissingException(field.dataSource.key);
+            }
+            this.assertDescriptor(source.descriptor);
+            this.assertControlSupported(field, source.descriptor);
+            const bindings = this.readBindingValues(field, source.descriptor, input.formData);
+            if (bindings.missingParameters.length > 0) {
+                throw new form_data_source_errors_1.BPMFormDataSourceException(form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.WAITING_FOR_DEPENDENCIES);
+            }
+            const bindingHash = hashBindings(source.descriptor, bindings.values);
+            const canReuseSnapshot = !input.revalidateAll &&
+                source.descriptor.revalidationPolicy ===
+                    'WHEN_VALUE_OR_BINDINGS_CHANGE' &&
+                previousSnapshot?.dataSourceKey === source.descriptor.key &&
+                previousSnapshot.dataSourceVersion === source.descriptor.version &&
+                previousSnapshot.bindingHash === bindingHash &&
+                valueUnchanged;
+            if (canReuseSnapshot && previousSnapshot) {
+                return [field.fieldKey, previousSnapshot];
+            }
+            const options = await this.resolveFormFieldOptions({
+                authContext: input.authContext,
+                field,
+                formData: input.formData,
+                values,
+            });
+            const snapshot = {
+                bindingHash,
+                dataSourceKey: source.descriptor.key,
+                dataSourceVersion: source.descriptor.version,
+                options,
+                validatedAt: new Date().toISOString(),
+            };
+            return [field.fieldKey, snapshot];
+        }));
+        return Object.fromEntries(entries.filter((entry) => entry !== null));
+    }
+    async resolveFormFieldOptions(input) {
+        const field = this.readDynamicOptionField(input.field);
+        const source = this.readSourceOrThrow(field.dataSource);
+        this.assertControlSupported(field, source.descriptor);
+        const values = validateRequestedValues(input.values, source.descriptor.maximumResultCount);
+        const bindings = this.readBindingValues(field, source.descriptor, input.formData);
+        if (bindings.missingParameters.length > 0) {
+            throw new form_data_source_errors_1.BPMFormDataSourceException(form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.WAITING_FOR_DEPENDENCIES);
+        }
+        const result = await this.callProvider(source, (signal) => source.resolve({
+            authContext: input.authContext,
+            bindings: bindings.values,
+            signal,
+            values,
+        }));
+        const options = validateResolveResult(result, values, source.descriptor.maximumResultCount);
+        const optionByValue = new Map(options.map((option) => [
+            option.value,
+            option,
+        ]));
+        return values.map((value) => optionByValue.get(value));
+    }
+    readDynamicOptionField(field) {
+        if (!(0, form_1.isFormDataSourceFieldDefinition)(field)) {
+            throw new form_data_source_errors_1.BPMFormDataSourceException(form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.FIELD_NOT_DYNAMIC);
+        }
+        return field;
+    }
+    readSourceOrThrow(reference) {
+        const source = this.registry.get(reference.key, reference.version);
+        if (!source) {
+            throw this.createSourceMissingException(reference.key);
+        }
+        this.assertDescriptor(source.descriptor);
+        return source;
+    }
+    createSourceMissingException(key) {
+        const hasKey = this.registry
+            .list()
+            .some((candidate) => {
+            const candidateRecord = isRecord(candidate) ? candidate : null;
+            const descriptor = candidateRecord && isRecord(candidateRecord.descriptor)
+                ? candidateRecord.descriptor
+                : null;
+            return descriptor?.key === key;
+        });
+        return new form_data_source_errors_1.BPMFormDataSourceException(hasKey
+            ? form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.DATA_SOURCE_VERSION_MISSING
+            : form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.DATA_SOURCE_MISSING);
+    }
+    assertDescriptor(descriptor) {
+        const valid = typeof descriptor.key === 'string' &&
+            descriptor.key.trim().length > 0 &&
+            typeof descriptor.label === 'string' &&
+            descriptor.label.trim().length > 0 &&
+            isPositiveInteger(descriptor.version) &&
+            isPositiveInteger(descriptor.maximumResultCount) &&
+            isPositiveInteger(descriptor.pageSize) &&
+            isNonNegativeInteger(descriptor.minimumSearchLength) &&
+            descriptor.pageSize <= descriptor.maximumResultCount &&
+            (descriptor.paginationMode === 'CURSOR' ||
+                descriptor.paginationMode === 'NONE') &&
+            (descriptor.revalidationPolicy === 'ALWAYS' ||
+                descriptor.revalidationPolicy === 'WHEN_VALUE_OR_BINDINGS_CHANGE') &&
+            typeof descriptor.returnsCompleteList === 'boolean' &&
+            typeof descriptor.supportsSearch === 'boolean' &&
+            Array.isArray(descriptor.parameters) &&
+            Array.isArray(descriptor.supportedControls) &&
+            descriptor.supportedControls.every((control) => SOURCE_CONTROLS.includes(control)) &&
+            descriptor.parameters.every((parameter) => isValidParameter(parameter)) &&
+            new Set(descriptor.parameters.map((parameter) => parameter.key)).size ===
+                descriptor.parameters.length &&
+            new Set(descriptor.supportedControls).size ===
+                descriptor.supportedControls.length;
+        if (!valid) {
+            throw new form_data_source_errors_1.BPMFormDataSourceException(form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.INVALID_DESCRIPTOR);
+        }
+    }
+    assertControlSupported(field, descriptor) {
+        if (!descriptor.supportedControls.includes(field.type)) {
+            throw new form_data_source_errors_1.BPMFormDataSourceException(form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.UNSUPPORTED_CONTROL);
+        }
+        if ((field.type === 'radio' || field.type === 'checkbox') &&
+            (!descriptor.returnsCompleteList || descriptor.maximumResultCount > 50)) {
+            throw new form_data_source_errors_1.BPMFormDataSourceException(form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.UNSUPPORTED_CONTROL);
+        }
+    }
+    readBindingValues(field, descriptor, formData) {
+        const parameterByKey = new Map(descriptor.parameters.map((parameter) => [
+            parameter.key,
+            parameter,
+        ]));
+        const bindingValues = field.dataSource.bindings.reduce((values, binding) => {
+            const parameter = parameterByKey.get(binding.parameter);
+            if (!parameter) {
+                throw new form_data_source_errors_1.BPMFormDataSourceException(form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.INVALID_BINDING);
+            }
+            const nextValue = binding.from.kind === 'FIELD'
+                ? readFormDataValue(formData[binding.from.fieldKey])
+                : binding.from.value;
+            if (typeof nextValue === 'undefined') {
+                return values;
+            }
+            assertParameterValue(parameter, nextValue);
+            return { ...values, [parameter.key]: nextValue };
+        }, {});
+        const missingParameters = descriptor.parameters
+            .filter((parameter) => parameter.required)
+            .filter((parameter) => !isPresentFormDataValue(bindingValues[parameter.key]))
+            .map((parameter) => parameter.key);
+        if (JSON.stringify(bindingValues).length > MAX_PARAMETER_BYTES) {
+            throw new form_data_source_errors_1.BPMFormDataSourceException(form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.PARAMETER_LIMIT_EXCEEDED);
+        }
+        return { missingParameters, values: bindingValues };
+    }
+    async callProvider(source, call) {
+        const controller = new AbortController();
+        let timeoutId;
+        const startedAt = Date.now();
+        try {
+            const result = await Promise.race([
+                call(controller.signal),
+                new Promise((_resolve, reject) => {
+                    timeoutId = setTimeout(() => {
+                        controller.abort();
+                        const timeout = new Error('provider timeout');
+                        Object.assign(timeout, { kind: 'FORM_DATA_SOURCE_TIMEOUT' });
+                        reject(timeout);
+                    }, PROVIDER_TIMEOUT_MS);
+                }),
+            ]);
+            this.logger.log(JSON.stringify({
+                dataSourceKey: source.descriptor.key,
+                dataSourceVersion: source.descriptor.version,
+                durationMs: Date.now() - startedAt,
+                operation: 'resolve',
+                status: 'success',
+            }));
+            return result;
+        }
+        catch (error) {
+            const code = isTimeoutMarker(error)
+                ? form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.TIMEOUT
+                : form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.PROVIDER_FAILURE;
+            this.logger.warn(JSON.stringify({
+                dataSourceKey: source.descriptor.key,
+                dataSourceVersion: source.descriptor.version,
+                durationMs: Date.now() - startedAt,
+                errorCode: code,
+                operation: 'resolve',
+                status: 'error',
+            }));
+            throw new form_data_source_errors_1.BPMFormDataSourceException(code);
+        }
+        finally {
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+            }
+        }
+    }
+};
+exports.FormDataSourceValueResolverService = FormDataSourceValueResolverService;
+exports.FormDataSourceValueResolverService = FormDataSourceValueResolverService = FormDataSourceValueResolverService_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(0, (0, common_1.Inject)(form_data_source_types_1.BPM_FORM_DATA_SOURCE_REGISTRY)),
+    tslib_1.__metadata("design:paramtypes", [Object])
+], FormDataSourceValueResolverService);
+function readDynamicFieldValues(field, value) {
+    const mode = (0, form_1.readFormFieldSelectionMode)(field);
+    if (value === null || typeof value === 'undefined') {
+        return [];
+    }
+    // `''` clears a single field; on a multiple field it is an illegal shape that
+    // must be rejected rather than silently treated as "nothing selected".
+    if (value === '' && mode !== 'multiple') {
+        return [];
+    }
+    if (mode === 'multiple') {
+        if (!Array.isArray(value) ||
+            value.some((item) => typeof item !== 'string' || !item.trim()) ||
+            new Set(value).size !== value.length) {
+            throw new form_data_source_errors_1.BPMFormDataSourceException(form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.INVALID_BINDING);
+        }
+        return [...value];
+    }
+    if (typeof value !== 'string' || !value.trim()) {
+        throw new form_data_source_errors_1.BPMFormDataSourceException(form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.INVALID_BINDING);
+    }
+    return [value];
+}
+function validateRequestedValues(values, maximumResultCount) {
+    if (values.length === 0 ||
+        values.some((value) => !value.trim()) ||
+        new Set(values).size !== values.length) {
+        throw new form_data_source_errors_1.BPMFormDataSourceException(form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.INVALID_BINDING);
+    }
+    if (values.length > maximumResultCount) {
+        throw new form_data_source_errors_1.BPMFormDataSourceException(form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.RESULT_LIMIT_EXCEEDED);
+    }
+    return [...values];
+}
+function validateResolveResult(result, values, maximumResultCount) {
+    if (!Array.isArray(result) || result.length > maximumResultCount) {
+        throw new form_data_source_errors_1.BPMFormDataSourceException(form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.INVALID_PROVIDER_RESULT);
+    }
+    const options = validateOptions(result);
+    const requestedValues = new Set(values);
+    // A value the caller never asked for is a provider contract breach.
+    if (options.some((option) => !requestedValues.has(option.value))) {
+        throw new form_data_source_errors_1.BPMFormDataSourceException(form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.INVALID_PROVIDER_RESULT);
+    }
+    // Every requested value resolved to exactly one option, or the submitted
+    // value is simply no longer selectable — that is a user-facing failure.
+    if (options.length !== values.length) {
+        throw new form_data_source_errors_1.BPMFormDataSourceException(form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.VALUE_NOT_RESOLVED);
+    }
+    return options;
+}
+function validateOptions(value) {
+    if (!Array.isArray(value)) {
+        throw new form_data_source_errors_1.BPMFormDataSourceException(form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.INVALID_PROVIDER_RESULT);
+    }
+    const options = value.filter(isFormFieldOption);
+    if (options.length !== value.length ||
+        options.some((option) => !option.label.trim() || !option.value.trim()) ||
+        new Set(options.map((option) => option.value)).size !== options.length) {
+        throw new form_data_source_errors_1.BPMFormDataSourceException(form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.INVALID_PROVIDER_RESULT);
+    }
+    return options;
+}
+function assertParameterValue(parameter, value) {
+    const valid = (parameter.type === 'BOOLEAN' && typeof value === 'boolean') ||
+        (parameter.type === 'NUMBER' &&
+            typeof value === 'number' &&
+            Number.isFinite(value)) ||
+        (parameter.type === 'STRING' && typeof value === 'string') ||
+        (parameter.type === 'STRING_ARRAY' && isStringArray(value)) ||
+        value === null;
+    if (!valid) {
+        throw new form_data_source_errors_1.BPMFormDataSourceException(form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.INVALID_BINDING);
+    }
+}
+function readFormDataValue(value) {
+    if (value === null ||
+        typeof value === 'boolean' ||
+        (typeof value === 'number' && Number.isFinite(value)) ||
+        typeof value === 'string' ||
+        isStringArrayValue(value)) {
+        return value;
+    }
+    if (typeof value === 'undefined') {
+        return undefined;
+    }
+    throw new form_data_source_errors_1.BPMFormDataSourceException(form_data_source_errors_1.BPM_FORM_DATA_SOURCE_ERROR_CODES.INVALID_BINDING);
+}
+function isPresentFormDataValue(value) {
+    if (typeof value === 'undefined' || value === null) {
+        return false;
+    }
+    if (typeof value === 'string') {
+        return value.trim().length > 0;
+    }
+    if (Array.isArray(value)) {
+        return value.length > 0;
+    }
+    return true;
+}
+function hashBindings(descriptor, values) {
+    const orderedValues = descriptor.parameters.map((parameter) => [
+        parameter.key,
+        values[parameter.key] ?? null,
+    ]);
+    return (0, node_crypto_1.createHash)('sha256')
+        .update(JSON.stringify({
+        dataSourceKey: descriptor.key,
+        dataSourceVersion: descriptor.version,
+        values: orderedValues,
+    }))
+        .digest('hex');
+}
+function isSameFieldValue(left, right) {
+    return JSON.stringify(left ?? null) === JSON.stringify(right ?? null);
+}
+function isFormFieldOption(value) {
+    return (isRecord(value) &&
+        typeof value.label === 'string' &&
+        typeof value.value === 'string');
+}
+function isValidParameter(value) {
+    return (isRecord(value) &&
+        typeof value.key === 'string' &&
+        value.key.trim().length > 0 &&
+        typeof value.required === 'boolean' &&
+        PARAMETER_TYPES.includes(value.type));
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === 'string');
+}
+function isStringArrayValue(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === 'string');
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isTimeoutMarker(value) {
+    return (value instanceof Error &&
+        value.kind ===
+            'FORM_DATA_SOURCE_TIMEOUT');
+}
+function isPositiveInteger(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value > 0;
+}
+function isNonNegativeInteger(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value >= 0;
+}
+//# sourceMappingURL=form-data-source-value-resolver.service.js.map

package/src/lib/form-data-source/form-data-source-value-resolver.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-data-source-value-resolver.service.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/form-data-source/form-data-source-value-resolver.service.ts"],"names":[],"mappings":"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"}

package/src/lib/form-data-source/form-data-source.errors.d.ts

@@ -0,0 +1,34 @@
+import { BadRequestException, ForbiddenException } from '@nestjs/common';
+export declare const BPM_FORM_DATA_SOURCE_ERROR_CODES: {
+    readonly DATA_SOURCE_MISSING: "FORM_DATA_SOURCE_MISSING";
+    readonly DATA_SOURCE_VERSION_MISSING: "FORM_DATA_SOURCE_VERSION_MISSING";
+    readonly FIELD_NOT_DYNAMIC: "FORM_DATA_SOURCE_FIELD_NOT_DYNAMIC";
+    readonly INVALID_BINDING: "FORM_DATA_SOURCE_INVALID_BINDING";
+    readonly INVALID_DESCRIPTOR: "FORM_DATA_SOURCE_INVALID_DESCRIPTOR";
+    readonly INVALID_PROVIDER_RESULT: "FORM_DATA_SOURCE_INVALID_PROVIDER_RESULT";
+    readonly PARAMETER_LIMIT_EXCEEDED: "FORM_DATA_SOURCE_PARAMETER_LIMIT_EXCEEDED";
+    readonly PROVIDER_FAILURE: "FORM_DATA_SOURCE_PROVIDER_FAILURE";
+    readonly RESULT_LIMIT_EXCEEDED: "FORM_DATA_SOURCE_RESULT_LIMIT_EXCEEDED";
+    readonly SEARCH_NOT_SUPPORTED: "FORM_DATA_SOURCE_SEARCH_NOT_SUPPORTED";
+    readonly SEARCH_TOO_SHORT: "FORM_DATA_SOURCE_SEARCH_TOO_SHORT";
+    readonly TIMEOUT: "FORM_DATA_SOURCE_TIMEOUT";
+    readonly UNSUPPORTED_CONTROL: "FORM_DATA_SOURCE_UNSUPPORTED_CONTROL";
+    /**
+     * The submitted value is no longer selectable under the current bindings and
+     * authorization context. This is a user-facing validation failure, not a host
+     * provider contract breach: keep it distinct from `INVALID_PROVIDER_RESULT`
+     * so the renderer can show `INVALID` instead of `UNAVAILABLE`.
+     */
+    readonly VALUE_NOT_RESOLVED: "FORM_DATA_SOURCE_VALUE_NOT_RESOLVED";
+    readonly WAITING_FOR_DEPENDENCIES: "FORM_DATA_SOURCE_WAITING_FOR_DEPENDENCIES";
+    readonly RUNTIME_CONTEXT_FORBIDDEN: "FORM_DATA_SOURCE_RUNTIME_CONTEXT_FORBIDDEN";
+};
+export type BPMFormDataSourceErrorCode = (typeof BPM_FORM_DATA_SOURCE_ERROR_CODES)[keyof typeof BPM_FORM_DATA_SOURCE_ERROR_CODES];
+export declare class BPMFormDataSourceException extends BadRequestException {
+    readonly code: BPMFormDataSourceErrorCode;
+    constructor(code: BPMFormDataSourceErrorCode);
+}
+export declare class BPMFormDataSourceForbiddenException extends ForbiddenException {
+    readonly code: BPMFormDataSourceErrorCode;
+    constructor(code: typeof BPM_FORM_DATA_SOURCE_ERROR_CODES.RUNTIME_CONTEXT_FORBIDDEN);
+}

package/src/lib/form-data-source/form-data-source.errors.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BPMFormDataSourceForbiddenException = exports.BPMFormDataSourceException = exports.BPM_FORM_DATA_SOURCE_ERROR_CODES = void 0;
+const common_1 = require("@nestjs/common");
+exports.BPM_FORM_DATA_SOURCE_ERROR_CODES = {
+    DATA_SOURCE_MISSING: 'FORM_DATA_SOURCE_MISSING',
+    DATA_SOURCE_VERSION_MISSING: 'FORM_DATA_SOURCE_VERSION_MISSING',
+    FIELD_NOT_DYNAMIC: 'FORM_DATA_SOURCE_FIELD_NOT_DYNAMIC',
+    INVALID_BINDING: 'FORM_DATA_SOURCE_INVALID_BINDING',
+    INVALID_DESCRIPTOR: 'FORM_DATA_SOURCE_INVALID_DESCRIPTOR',
+    INVALID_PROVIDER_RESULT: 'FORM_DATA_SOURCE_INVALID_PROVIDER_RESULT',
+    PARAMETER_LIMIT_EXCEEDED: 'FORM_DATA_SOURCE_PARAMETER_LIMIT_EXCEEDED',
+    PROVIDER_FAILURE: 'FORM_DATA_SOURCE_PROVIDER_FAILURE',
+    RESULT_LIMIT_EXCEEDED: 'FORM_DATA_SOURCE_RESULT_LIMIT_EXCEEDED',
+    SEARCH_NOT_SUPPORTED: 'FORM_DATA_SOURCE_SEARCH_NOT_SUPPORTED',
+    SEARCH_TOO_SHORT: 'FORM_DATA_SOURCE_SEARCH_TOO_SHORT',
+    TIMEOUT: 'FORM_DATA_SOURCE_TIMEOUT',
+    UNSUPPORTED_CONTROL: 'FORM_DATA_SOURCE_UNSUPPORTED_CONTROL',
+    /**
+     * The submitted value is no longer selectable under the current bindings and
+     * authorization context. This is a user-facing validation failure, not a host
+     * provider contract breach: keep it distinct from `INVALID_PROVIDER_RESULT`
+     * so the renderer can show `INVALID` instead of `UNAVAILABLE`.
+     */
+    VALUE_NOT_RESOLVED: 'FORM_DATA_SOURCE_VALUE_NOT_RESOLVED',
+    WAITING_FOR_DEPENDENCIES: 'FORM_DATA_SOURCE_WAITING_FOR_DEPENDENCIES',
+    RUNTIME_CONTEXT_FORBIDDEN: 'FORM_DATA_SOURCE_RUNTIME_CONTEXT_FORBIDDEN',
+};
+class BPMFormDataSourceException extends common_1.BadRequestException {
+    constructor(code) {
+        super({ code, message: code });
+        this.code = code;
+    }
+}
+exports.BPMFormDataSourceException = BPMFormDataSourceException;
+class BPMFormDataSourceForbiddenException extends common_1.ForbiddenException {
+    constructor(code) {
+        super({ code, message: code });
+        this.code = code;
+    }
+}
+exports.BPMFormDataSourceForbiddenException = BPMFormDataSourceForbiddenException;
+//# sourceMappingURL=form-data-source.errors.js.map

package/src/lib/form-data-source/form-data-source.errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-data-source.errors.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/form-data-source/form-data-source.errors.ts"],"names":[],"mappings":";;;AAAA,2CAAyE;AAE5D,QAAA,gCAAgC,GAAG;IAC9C,mBAAmB,EAAE,0BAA0B;IAC/C,2BAA2B,EAAE,kCAAkC;IAC/D,iBAAiB,EAAE,oCAAoC;IACvD,eAAe,EAAE,kCAAkC;IACnD,kBAAkB,EAAE,qCAAqC;IACzD,uBAAuB,EAAE,0CAA0C;IACnE,wBAAwB,EAAE,2CAA2C;IACrE,gBAAgB,EAAE,mCAAmC;IACrD,qBAAqB,EAAE,wCAAwC;IAC/D,oBAAoB,EAAE,uCAAuC;IAC7D,gBAAgB,EAAE,mCAAmC;IACrD,OAAO,EAAE,0BAA0B;IACnC,mBAAmB,EAAE,sCAAsC;IAC3D;;;;;OAKG;IACH,kBAAkB,EAAE,qCAAqC;IACzD,wBAAwB,EAAE,2CAA2C;IACrE,yBAAyB,EAAE,4CAA4C;CAC/D,CAAC;AAKX,MAAa,0BAA2B,SAAQ,4BAAmB;IAGjE,YAAY,IAAgC;QAC1C,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAPD,gEAOC;AAED,MAAa,mCAAoC,SAAQ,2BAAkB;IAGzE,YACE,IAAuE;QAEvE,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AATD,kFASC"}

package/src/lib/form-data-source/form-data-source.module.d.ts

@@ -0,0 +1,9 @@
+import { DynamicModule, Provider } from '@nestjs/common';
+import { ModuleMetadata } from '@nestjs/common/interfaces';
+import { BPMFormDataSourceRegistry } from './form-data-source.types';
+export interface FormDataSourceModuleOptions extends Pick<ModuleMetadata, 'imports'> {
+    readonly registryProvider?: Provider<BPMFormDataSourceRegistry>;
+}
+export declare class FormDataSourceModule {
+    static forRoot(options?: FormDataSourceModuleOptions): DynamicModule;
+}

package/src/lib/form-data-source/form-data-source.module.js

@@ -0,0 +1,55 @@
+"use strict";
+var FormDataSourceModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FormDataSourceModule = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("@nestjs/typeorm");
+const workflow_engine_module_1 = require("../workflow-engine/workflow-engine.module");
+const approval_template_version_entity_1 = require("../template/approval-template-version.entity");
+const form_definition_version_entity_1 = require("../form/form-definition-version.entity");
+const form_data_source_queries_1 = require("./form-data-source.queries");
+const form_data_source_service_1 = require("./form-data-source.service");
+const form_data_source_value_resolver_service_1 = require("./form-data-source-value-resolver.service");
+const form_data_source_types_1 = require("./form-data-source.types");
+let FormDataSourceModule = FormDataSourceModule_1 = class FormDataSourceModule {
+    static forRoot(options = {}) {
+        const registryProvider = options.registryProvider ?? {
+            provide: form_data_source_types_1.BPM_FORM_DATA_SOURCE_REGISTRY,
+            useClass: form_data_source_types_1.EmptyBPMFormDataSourceRegistry,
+        };
+        return {
+            exports: [
+                form_data_source_types_1.BPM_FORM_DATA_SOURCE_REGISTRY,
+                form_data_source_types_1.BPM_FORM_DATA_SOURCE_VALUE_RESOLVER,
+                form_data_source_service_1.FormDataSourceService,
+            ],
+            global: true,
+            imports: [
+                ...(options.imports ?? []),
+                workflow_engine_module_1.WorkflowEngineModule,
+                typeorm_1.TypeOrmModule.forFeature([
+                    approval_template_version_entity_1.ApprovalTemplateVersionEntity,
+                    form_definition_version_entity_1.FormDefinitionVersionEntity,
+                ]),
+            ],
+            module: FormDataSourceModule_1,
+            providers: [
+                registryProvider,
+                form_data_source_queries_1.FormDataSourceQueries,
+                form_data_source_service_1.FormDataSourceService,
+                form_data_source_value_resolver_service_1.FormDataSourceValueResolverService,
+                {
+                    provide: form_data_source_types_1.BPM_FORM_DATA_SOURCE_VALUE_RESOLVER,
+                    useExisting: form_data_source_value_resolver_service_1.FormDataSourceValueResolverService,
+                },
+            ],
+        };
+    }
+};
+exports.FormDataSourceModule = FormDataSourceModule;
+exports.FormDataSourceModule = FormDataSourceModule = FormDataSourceModule_1 = tslib_1.__decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], FormDataSourceModule);
+//# sourceMappingURL=form-data-source.module.js.map

package/src/lib/form-data-source/form-data-source.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-data-source.module.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/form-data-source/form-data-source.module.ts"],"names":[],"mappings":";;;;;AAAA,2CAAyE;AAEzE,6CAAgD;AAChD,sFAAiF;AACjF,mGAA6F;AAC7F,2FAAqF;AACrF,yEAAmE;AACnE,yEAAmE;AACnE,uGAA+F;AAC/F,qEAKkC;AAQ3B,IAAM,oBAAoB,4BAA1B,MAAM,oBAAoB;IAC/B,MAAM,CAAC,OAAO,CAAC,UAAuC,EAAE;QACtD,MAAM,gBAAgB,GACpB,OAAO,CAAC,gBAAgB,IAAI;YAC1B,OAAO,EAAE,sDAA6B;YACtC,QAAQ,EAAE,uDAA8B;SACzC,CAAC;QAEJ,OAAO;YACL,OAAO,EAAE;gBACP,sDAA6B;gBAC7B,4DAAmC;gBACnC,gDAAqB;aACtB;YACD,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE;gBACP,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;gBAC1B,6CAAoB;gBACpB,uBAAa,CAAC,UAAU,CAAC;oBACvB,gEAA6B;oBAC7B,4DAA2B;iBAC5B,CAAC;aACH;YACD,MAAM,EAAE,sBAAoB;YAC5B,SAAS,EAAE;gBACT,gBAAgB;gBAChB,gDAAqB;gBACrB,gDAAqB;gBACrB,4EAAkC;gBAClC;oBACE,OAAO,EAAE,4DAAmC;oBAC5C,WAAW,EAAE,4EAAkC;iBAChD;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AApCY,oDAAoB;+BAApB,oBAAoB;IAFhC,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,oBAAoB,CAoChC"}

package/src/lib/form-data-source/form-data-source.queries.d.ts

@@ -0,0 +1,57 @@
+import { BPMAuthContext } from '../bpm-auth';
+import { FormFieldOption } from '@rytass/bpm-core-shared/form';
+import { FormDataSourceService } from './form-data-source.service';
+export declare class FormDataSourceParameterObject {
+    key: string;
+    label: string | null;
+    required: boolean;
+    type: string;
+}
+export declare class FormDataSourceDescriptorObject {
+    key: string;
+    label: string;
+    description: string | null;
+    version: number;
+    maximumResultCount: number;
+    minimumSearchLength: number;
+    pageSize: number;
+    paginationMode: string;
+    parameters: readonly FormDataSourceParameterObject[];
+    revalidationPolicy: string;
+    returnsCompleteList: boolean;
+    supportedControls: readonly string[];
+    supportsSearch: boolean;
+}
+export declare class FormFieldOptionObject implements FormFieldOption {
+    label: string;
+    value: string;
+}
+export declare class FormDataSourceOptionsResultObject {
+    dataSourceKey: string;
+    dataSourceVersion: number;
+    nextCursor: string | null;
+    options: readonly FormFieldOptionObject[];
+}
+export declare class PreviewFormFieldOptionsInput {
+    schemaJson: string;
+    uiSchemaJson: string | null;
+    fieldKey: string;
+    formDataJson: string | null;
+    searchText: string | null;
+    cursor: string | null;
+}
+export declare class RuntimeFormFieldOptionsInput {
+    templateId: string | null;
+    instanceId: string | null;
+    fieldKey: string;
+    formDataJson: string | null;
+    searchText: string | null;
+    cursor: string | null;
+}
+export declare class FormDataSourceQueries {
+    private readonly formDataSourceService;
+    constructor(formDataSourceService: FormDataSourceService);
+    formDataSources(): readonly FormDataSourceDescriptorObject[];
+    previewFormFieldOptions(input: PreviewFormFieldOptionsInput, authContext: BPMAuthContext): Promise<FormDataSourceOptionsResultObject>;
+    formFieldOptions(input: RuntimeFormFieldOptionsInput, authContext: BPMAuthContext): Promise<FormDataSourceOptionsResultObject>;
+}