@epistola.app/valtimo-plugin 0.5.2 → 0.7.0

package/lib/assets/epistola-logo.d.ts

@@ -1 +1 @@
-export declare const EPISTOLA_PLUGIN_LOGO_BASE64 = "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0iIzMzNjZjYyI+PHBhdGggZD0iTTE0IDJINmMtMS4xIDAtMiAuOS0yIDJ2MTZjMCAxLjEuOSAyIDIgMmgxMmMxLjEgMCAyLS45IDItMlY4bC02LTZ6bTQgMThINlY0aDd2NWg1djExeiIvPjxwYXRoIGQ9Ik04IDEyaDh2Mkg4em0wIDRoOHYtMkg4em0wLThWNmg0djJ6Ii8+PC9zdmc+";
+export declare const EPISTOLA_PLUGIN_LOGO_BASE64 = "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxMjAgMTIwIiB3aWR0aD0iMTIwIiBoZWlnaHQ9IjEyMCI+CiAgPCEtLSBTdGFjayBiYXNlIC0tPgogIDxyZWN0IHg9IjM2IiB5PSIxNiIgd2lkdGg9IjU0IiBoZWlnaHQ9IjcwIiByeD0iMyIgZmlsbD0iI2U2YzJiMCIgc3Ryb2tlPSIjNGYyZjJiIiBzdHJva2Utd2lkdGg9IjIiIHRyYW5zZm9ybT0icm90YXRlKDUgNjMgNTEpIi8+CiAgPHJlY3QgeD0iMzIiIHk9IjIyIiB3aWR0aD0iNTQiIGhlaWdodD0iNzAiIHJ4PSIzIiBmaWxsPSIjZjBkOGM4IiBzdHJva2U9IiM0ZjJmMmIiIHN0cm9rZS13aWR0aD0iMiIvPgogIDxyZWN0IHg9IjI4IiB5PSIyOCIgd2lkdGg9IjU0IiBoZWlnaHQ9IjcwIiByeD0iMyIgZmlsbD0iI2Y1ZWJlMyIgc3Ryb2tlPSIjNGYyZjJiIiBzdHJva2Utd2lkdGg9IjIuNSIvPgogIDxsaW5lIHgxPSIzOCIgeTE9IjQ0IiB4Mj0iNzIiIHkyPSI0NCIgc3Ryb2tlPSIjYzRhODgyIiBzdHJva2Utd2lkdGg9IjIiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgogIDxsaW5lIHgxPSIzOCIgeTE9IjU0IiB4Mj0iNzIiIHkyPSI1NCIgc3Ryb2tlPSIjYzRhODgyIiBzdHJva2Utd2lkdGg9IjIiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgogIDxsaW5lIHgxPSIzOCIgeTE9IjY0IiB4Mj0iNTgiIHkyPSI2NCIgc3Ryb2tlPSIjYzRhODgyIiBzdHJva2Utd2lkdGg9IjIiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgogIDwhLS0gV2F4IHNlYWwgd2l0aCBjaGVja21hcmsgLS0+CiAgPGNpcmNsZSBjeD0iNTUiIGN5PSI4NCIgcj0iMTUiIGZpbGw9IiNiODVjM2MiIHN0cm9rZT0iIzRmMmYyYiIgc3Ryb2tlLXdpZHRoPSIyIi8+CiAgPGNpcmNsZSBjeD0iNTUiIGN5PSI4NCIgcj0iMTAuNSIgZmlsbD0ibm9uZSIgc3Ryb2tlPSIjZDQ4MzZhIiBzdHJva2Utd2lkdGg9IjEiLz4KICA8cG9seWxpbmUgcG9pbnRzPSI0OSw4NCA1Myw4OSA2Miw3OCIgZmlsbD0ibm9uZSIgc3Ryb2tlPSIjNGYyZjJiIiBzdHJva2Utd2lkdGg9IjIuNSIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIi8+Cjwvc3ZnPgo=";

package/lib/components/epistola-admin-page/epistola-admin-page.component.d.ts

@@ -0,0 +1,52 @@
+import { OnInit } from '@angular/core';
+import { ActivatedRoute, Router } from '@angular/router';
+import { EpistolaAdminService } from '../../services/epistola-admin.service';
+import { PendingJob, PluginUsageEntry } from '../../models';
+import * as i0 from "@angular/core";
+/**
+ * Combined view model for a single plugin configuration card.
+ */
+interface ConfigurationCard {
+    configurationId: string;
+    configurationTitle: string;
+    tenantId: string;
+    reachable: boolean;
+    latencyMs: number;
+    errorMessage?: string;
+    serverVersion?: string;
+    usageCount: number;
+    problemCount: number;
+    usageEntries: PluginUsageEntry[];
+    pendingJobs: PendingJob[];
+}
+export declare class EpistolaAdminPageComponent implements OnInit {
+    private readonly adminService;
+    private readonly route;
+    private readonly router;
+    cards: ConfigurationCard[];
+    selectedCard: ConfigurationCard | null;
+    activeTab: 'actions' | 'pending';
+    loading: boolean;
+    pluginVersion: string | null;
+    private connectionStatuses;
+    private usageEntries;
+    private pendingJobs;
+    private connectionLoaded;
+    private usageLoaded;
+    private pendingLoaded;
+    private deepLinkConfigId;
+    constructor(adminService: EpistolaAdminService, route: ActivatedRoute, router: Router);
+    ngOnInit(): void;
+    selectConfiguration(card: ConfigurationCard): void;
+    backToOverview(): void;
+    setActiveTab(tab: 'actions' | 'pending'): void;
+    refresh(): void;
+    exportProcessLink(entry: PluginUsageEntry): void;
+    private updateUrl;
+    private loadData;
+    private tryBuildCards;
+    private loadPluginVersion;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EpistolaAdminPageComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<EpistolaAdminPageComponent, "epistola-admin-page", never, {}, {}, never, never, true, never>;
+}
+export {};

package/lib/components/epistola-document-preview/epistola-document-preview.component.d.ts

@@ -6,36 +6,59 @@ import { ConfigService } from '@valtimo/shared';
 import { PreviewSource } from '../../models';
 import { EpistolaPluginService } from '../../services';
 import * as i0 from "@angular/core";
-export declare class EpistolaDocumentPreviewComponent implements FormioCustomComponent<null>, OnChanges, OnDestroy {
+export declare class EpistolaDocumentPreviewComponent implements FormioCustomComponent<Record<string, any> | null>, OnChanges, OnDestroy {
     private readonly epistolaPluginService;
     private readonly http;
     private readonly sanitizer;
     private readonly configService;
     private readonly formIoStateService;
     private readonly cdr;
-    value: null;
-    valueChange: EventEmitter<null>;
+    value: Record<string, any> | null;
+    valueChange: EventEmitter<Record<string, any>>;
     disabled: boolean;
     label: string;
+    processDefinitionKey?: string;
+    sourceActivityId?: string;
+    overrideMapping?: Record<string, any>;
     sources: PreviewSource[];
     selectedIndex: number;
     discovering: boolean;
     loading: boolean;
     error: string | null;
     previewUrl: SafeResourceUrl | null;
+    designMode: boolean;
     private initialized;
     private currentBlobUrl;
     private discoverSubscription?;
     private previewSubscription?;
     private readonly apiEndpoint;
+    /** Whether the component is in configured mode (explicit process link) vs auto-discover mode */
+    private get configuredMode();
     constructor(epistolaPluginService: EpistolaPluginService, http: HttpClient, sanitizer: DomSanitizer, configService: ConfigService, formIoStateService: FormIoStateService, cdr: ChangeDetectorRef);
+    get overrideMappingScopes(): string[];
+    overrideMappingEntries(scope: string): {
+        path: string;
+        field: string;
+    }[];
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
     onSourceChange(event: Event): void;
     refresh(): void;
+    /**
+     * Configured mode: preview using the explicitly configured process link + input overrides.
+     */
+    private loadConfiguredPreview;
+    /**
+     * Auto-discover mode: discover sources from running process instances.
+     */
     private discoverSources;
-    private loadPreview;
+    /**
+     * Auto-discover mode: load preview for the selected discovered source.
+     */
+    private loadDiscoveredPreview;
+    private handlePreviewSuccess;
+    private handlePreviewError;
     private revokeBlobUrl;
     static ɵfac: i0.ɵɵFactoryDeclaration<EpistolaDocumentPreviewComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<EpistolaDocumentPreviewComponent, "epistola-document-preview-component", never, { "value": { "alias": "value"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "label": { "alias": "label"; "required": false; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<EpistolaDocumentPreviewComponent, "epistola-document-preview-component", never, { "value": { "alias": "value"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "label": { "alias": "label"; "required": false; }; "processDefinitionKey": { "alias": "processDefinitionKey"; "required": false; }; "sourceActivityId": { "alias": "sourceActivityId"; "required": false; }; "overrideMapping": { "alias": "overrideMapping"; "required": false; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
 }

package/lib/components/epistola-document-preview/preview-utils.d.ts

@@ -0,0 +1,18 @@
+import { OverrideMapping } from '../override-builder/override-builder.component';
+export declare const FORM_REF_PREFIX = "form:";
+/**
+ * Detect if a string value is a JSONata expression (vs a plain literal).
+ * Checks for characters that indicate JSONata operators: $, &, (, {, ?, [
+ */
+export declare function isExpression(value: string): boolean;
+/**
+ * Expand dot-notation keys into nested objects.
+ * e.g. { "beslissing.tekst": "value" } -> { beslissing: { tekst: "value" } }
+ */
+export declare function expandDotNotation(flat: Record<string, any>): Record<string, any>;
+/**
+ * Given an override mapping (scope -> { inputPath -> "form:<componentKey>" })
+ * and form data, produce the inputOverrides object for the backend.
+ * The "form:" prefix identifies form field references; the remainder is the Formio component key.
+ */
+export declare function computeInputOverrides(mapping: OverrideMapping, formData: Record<string, any>): Record<string, any>;

package/lib/components/expected-structure/expected-structure.component.d.ts

@@ -0,0 +1,11 @@
+import { OnChanges, SimpleChanges } from '@angular/core';
+import { TemplateField } from '../../models';
+import * as i0 from "@angular/core";
+export declare class ExpectedStructureComponent implements OnChanges {
+    templateFields: TemplateField[];
+    structureText: string;
+    ngOnChanges(changes: SimpleChanges): void;
+    private buildStructure;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ExpectedStructureComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ExpectedStructureComponent, "epistola-expected-structure", never, { "templateFields": { "alias": "templateFields"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/components/generate-document-configuration/generate-document-configuration.component.d.ts

@@ -4,7 +4,7 @@ import { FormOutput, SelectItem } from '@valtimo/components';
 import { CaseManagementParams, ManagementContext } from '@valtimo/shared';
 import { ProcessLinkStateService } from '@valtimo/process-link';
 import { BehaviorSubject, Observable } from 'rxjs';
-import { AsyncResource, GenerateDocumentConfig, TemplateField } from '../../models';
+import { AsyncResource, ExpressionFunctionInfo, GenerateDocumentConfig, JsonataFieldError, TemplateField, VariableSuggestions } from '../../models';
 import { EpistolaPluginService } from '../../services';
 import * as i0 from "@angular/core";
 export type VariantSelectionMode = 'explicit' | 'attributes';
@@ -25,27 +25,38 @@ export declare class GenerateDocumentConfigurationComponent implements FunctionC
     variants$: BehaviorSubject<AsyncResource<SelectItem[]>>;
     environments$: BehaviorSubject<AsyncResource<SelectItem[]>>;
     templateFields$: BehaviorSubject<AsyncResource<TemplateField[]>>;
-    dataMapping$: BehaviorSubject<Record<string, any>>;
+    dataMapping$: BehaviorSubject<string>;
+    mappingMode: 'simple' | 'advanced';
+    toolsCollapsed: boolean;
+    activeToolTab: 'schema' | 'preview';
     outputFormatOptions: SelectItem[];
     readonly selectedCatalogId$: BehaviorSubject<string>;
     /** Composite ID: "catalogId/templateId" */
     readonly selectedTemplateId$: BehaviorSubject<string>;
     readonly selectedVariantId$: BehaviorSubject<string>;
     variantSelectionMode: VariantSelectionMode;
+    variantIdExpressionMode: boolean;
+    variantIdExpression: string;
+    filenameExpressionMode: boolean;
+    filenameExpression: string;
     variantAttributeEntries: {
         key: string;
         value: string;
         required: boolean;
         _customKey?: boolean;
+        _expressionMode?: boolean;
     }[];
     availableAttributeKeys: string[];
     caseDefinitionKey: string | null;
     processVariables: string[];
+    expressionFunctions: ExpressionFunctionInfo[];
+    variableSuggestions: VariableSuggestions | null;
     requiredFieldsStatus: {
         mapped: number;
         total: number;
     };
     prefillDataMapping: Record<string, any>;
+    validationErrors$: BehaviorSubject<JsonataFieldError[]>;
     private readonly destroy$;
     private saveSubscription;
     private readonly formValue$;
@@ -57,7 +68,7 @@ export declare class GenerateDocumentConfigurationComponent implements FunctionC
     ngOnInit(): void;
     ngOnDestroy(): void;
     formValueChange(formOutput: FormOutput): void;
-    onDataMappingChange(mapping: Record<string, any>): void;
+    onDataMappingChange(expression: string): void;
     onRequiredFieldsStatusChange(status: {
         mapped: number;
         total: number;
@@ -66,6 +77,8 @@ export declare class GenerateDocumentConfigurationComponent implements FunctionC
     addAttributeEntry(): void;
     removeAttributeEntry(index: number): void;
     onAttributeEntryChange(): void;
+    onVariantIdExpressionChange(): void;
+    onFilenameExpressionChange(): void;
     onKeySelected(entry: {
         key: string;
         value: string;
@@ -99,9 +112,22 @@ export declare class GenerateDocumentConfigurationComponent implements FunctionC
      *   prefill + templateFields loaded → seed dataMapping
      */
     private initCascade;
+    private loadExpressionFunctions;
     private loadProcessVariables;
+    private loadVariableSuggestions;
     private handleValid;
     private openSaveSubscription;
+    /**
+     * Build a JSONata validation request from the config and call the backend.
+     * Only fields that are JSONata expressions get validated:
+     * - dataMapping is always JSONata
+     * - filename / variantId only when their `fx` toggle is on
+     * - variant attribute values only when isExpression() reports true
+     * On invalid response, surface errors and abort the emit.
+     * If the validator endpoint itself fails (network/server), proceed with the
+     * emit — the validation is a quality-of-life check, not a hard gate.
+     */
+    private validateAndEmit;
     static ɵfac: i0.ɵɵFactoryDeclaration<GenerateDocumentConfigurationComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<GenerateDocumentConfigurationComponent, "epistola-generate-document-configuration", never, { "save$": { "alias": "save$"; "required": false; }; "disabled$": { "alias": "disabled$"; "required": false; }; "pluginId": { "alias": "pluginId"; "required": false; }; "prefillConfiguration$": { "alias": "prefillConfiguration$"; "required": false; }; "selectedPluginConfigurationData$": { "alias": "selectedPluginConfigurationData$"; "required": false; }; "context$": { "alias": "context$"; "required": false; }; }, { "valid": "valid"; "configuration": "configuration"; }, never, never, true, never>;
 }

package/lib/components/jsonata-editor/jsonata-editor.component.d.ts

@@ -0,0 +1,29 @@
+import { EventEmitter, OnChanges, OnDestroy, SimpleChanges } from '@angular/core';
+import { ExpressionFunctionInfo, VariableSuggestions } from '../../models';
+import * as i0 from "@angular/core";
+export declare class JsonataEditorComponent implements OnChanges, OnDestroy {
+    expression: string;
+    disabled: boolean;
+    suggestions: VariableSuggestions | null;
+    functions: ExpressionFunctionInfo[];
+    expressionChange: EventEmitter<string>;
+    validChange: EventEmitter<boolean>;
+    editorModel: {
+        value: string;
+        language: string;
+    };
+    editorOptions: Record<string, any>;
+    error: string | null;
+    private destroy$;
+    private validate$;
+    private suppressChange;
+    private languageRegistered;
+    constructor();
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    onEditorValueChange(value: string): void;
+    private tryRegisterLanguage;
+    private validateExpression;
+    static ɵfac: i0.ɵɵFactoryDeclaration<JsonataEditorComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<JsonataEditorComponent, "epistola-jsonata-editor", never, { "expression": { "alias": "expression"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "suggestions": { "alias": "suggestions"; "required": false; }; "functions": { "alias": "functions"; "required": false; }; }, { "expressionChange": "expressionChange"; "validChange": "validChange"; }, never, never, true, never>;
+}

package/lib/components/mapping-builder/builder-field/builder-field.component.d.ts

@@ -0,0 +1,21 @@
+import { EventEmitter } from '@angular/core';
+import { BuilderField } from '../../../utils/jsonata-converter';
+import * as i0 from "@angular/core";
+export declare class BuilderFieldComponent {
+    field: BuilderField;
+    path: number[];
+    suggestions: string[];
+    disabled: boolean;
+    collapsed: boolean;
+    required: boolean;
+    collapsedPaths: Set<string>;
+    valueChange: EventEmitter<{
+        path: number[];
+        value: string;
+    }>;
+    modeToggle: EventEmitter<number[]>;
+    collapseToggle: EventEmitter<number[]>;
+    isChildCollapsed(childIndex: number): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BuilderFieldComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BuilderFieldComponent, "epistola-builder-field", never, { "field": { "alias": "field"; "required": false; }; "path": { "alias": "path"; "required": false; }; "suggestions": { "alias": "suggestions"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "collapsed": { "alias": "collapsed"; "required": false; }; "required": { "alias": "required"; "required": false; }; "collapsedPaths": { "alias": "collapsedPaths"; "required": false; }; }, { "valueChange": "valueChange"; "modeToggle": "modeToggle"; "collapseToggle": "collapseToggle"; }, never, never, true, never>;
+}

package/lib/components/mapping-builder/mapping-builder.component.d.ts

@@ -0,0 +1,37 @@
+import { EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
+import { TemplateField, VariableSuggestions } from '../../models';
+import { BuilderField } from '../../utils/jsonata-converter';
+import * as i0 from "@angular/core";
+export declare class MappingBuilderComponent implements OnChanges {
+    expression: string;
+    templateFields: TemplateField[];
+    suggestions: VariableSuggestions | null;
+    disabled: boolean;
+    expressionChange: EventEmitter<string>;
+    fields: BuilderField[];
+    allSuggestions: string[];
+    collapsedPaths: Set<string>;
+    private initialCollapseApplied;
+    ngOnChanges(changes: SimpleChanges): void;
+    onNestedValueChange(path: number[], value: string): void;
+    onNestedModeToggle(path: number[]): void;
+    isRequired(fieldName: string): boolean;
+    isCollapsed(path: number[]): boolean;
+    toggleCollapse(path: number[]): void;
+    private collapseAll;
+    private collapseChildren;
+    private getFieldAtPath;
+    private emit;
+    /**
+     * Ensure all template fields have a corresponding builder field.
+     * Adds missing fields with empty values.
+     */
+    private buildSuggestionList;
+    /**
+     * Rebuild fields using template fields as the source of truth.
+     * Expression values fill in where available; unmapped fields show empty.
+     */
+    private rebuildFields;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MappingBuilderComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MappingBuilderComponent, "epistola-mapping-builder", never, { "expression": { "alias": "expression"; "required": false; }; "templateFields": { "alias": "templateFields"; "required": false; }; "suggestions": { "alias": "suggestions"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "expressionChange": "expressionChange"; }, never, never, true, never>;
+}

package/lib/components/mapping-preview/mapping-preview.component.d.ts

@@ -0,0 +1,26 @@
+import { OnChanges, OnDestroy, SimpleChanges } from '@angular/core';
+import { EvaluationResult, TemplateField } from '../../models';
+import { EpistolaPluginService } from '../../services';
+import * as i0 from "@angular/core";
+export declare class MappingPreviewComponent implements OnChanges, OnDestroy {
+    private readonly epistolaPluginService;
+    expression: string;
+    templateFields: TemplateField[];
+    caseDefinitionKey: string | null;
+    documentId: string;
+    loading: boolean;
+    result: EvaluationResult | null;
+    expectedJson: string;
+    missingRequired: string[];
+    private destroy$;
+    private evaluate$;
+    constructor(epistolaPluginService: EpistolaPluginService);
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    runPreview(): void;
+    private doEvaluate;
+    private buildExpectedJson;
+    private checkMissingRequired;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MappingPreviewComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MappingPreviewComponent, "epistola-mapping-preview", never, { "expression": { "alias": "expression"; "required": false; }; "templateFields": { "alias": "templateFields"; "required": false; }; "caseDefinitionKey": { "alias": "caseDefinitionKey"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/components/override-builder/override-builder.component.d.ts

@@ -0,0 +1,42 @@
+import { ChangeDetectorRef, EventEmitter } from '@angular/core';
+import { FormioCustomComponent } from '@valtimo/components';
+import * as i0 from "@angular/core";
+interface OverrideRow {
+    scope: 'doc' | 'pv';
+    inputPath: string;
+    formFieldKey: string;
+}
+export interface FormFieldOption {
+    key: string;
+    label: string;
+}
+/**
+ * Override mapping format: scope → { inputPath → "form:<componentKey>" }
+ * The "form:" prefix identifies this as a reference to a Formio component.
+ */
+export type OverrideMapping = Record<string, Record<string, string>>;
+export declare class EpistolaOverrideBuilderComponent implements FormioCustomComponent<OverrideMapping | null> {
+    private readonly cdr;
+    value: OverrideMapping | null;
+    valueChange: EventEmitter<OverrideMapping>;
+    disabled: boolean;
+    label: string;
+    availableFields: FormFieldOption[];
+    rows: OverrideRow[];
+    advancedMode: boolean;
+    jsonText: string;
+    jsonError: string | null;
+    private initialized;
+    constructor(cdr: ChangeDetectorRef);
+    ngOnChanges(): void;
+    toggleMode(): void;
+    addRow(): void;
+    removeRow(index: number): void;
+    emitChange(): void;
+    onJsonChange(text: string): void;
+    private rowsToMapping;
+    private mappingToRows;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EpistolaOverrideBuilderComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<EpistolaOverrideBuilderComponent, "epistola-override-builder-component", never, { "value": { "alias": "value"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "label": { "alias": "label"; "required": false; }; "availableFields": { "alias": "availableFields"; "required": false; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
+}
+export {};

package/lib/components/override-builder/override-builder.formio.d.ts

@@ -0,0 +1,4 @@
+import { Injector } from '@angular/core';
+import { FormioCustomComponentInfo } from '@valtimo/components';
+export declare const EPISTOLA_OVERRIDE_BUILDER_OPTIONS: FormioCustomComponentInfo;
+export declare function registerEpistolaOverrideBuilderComponent(injector: Injector): void;

package/lib/components/process-link-selector/process-link-selector.component.d.ts

@@ -0,0 +1,31 @@
+import { ChangeDetectorRef, EventEmitter, OnChanges, OnDestroy, SimpleChanges } from '@angular/core';
+import { FormioCustomComponent } from '@valtimo/components';
+import { EpistolaAdminService } from '../../services';
+import { PluginUsageEntry } from '../../models';
+import * as i0 from "@angular/core";
+export interface ProcessLinkSelection {
+    processDefinitionKey: string;
+    sourceActivityId: string;
+}
+export declare class EpistolaProcessLinkSelectorComponent implements FormioCustomComponent<ProcessLinkSelection | null>, OnChanges, OnDestroy {
+    private readonly adminService;
+    private readonly cdr;
+    value: ProcessLinkSelection | null;
+    valueChange: EventEmitter<ProcessLinkSelection>;
+    disabled: boolean;
+    label: string;
+    filteredEntries: PluginUsageEntry[];
+    selectedKey: string;
+    loading: boolean;
+    error: string | null;
+    private initialized;
+    private loadSubscription?;
+    constructor(adminService: EpistolaAdminService, cdr: ChangeDetectorRef);
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    onSelect(key: string): void;
+    entryKey(entry: PluginUsageEntry): string;
+    private loadEntries;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EpistolaProcessLinkSelectorComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<EpistolaProcessLinkSelectorComponent, "epistola-process-link-selector-component", never, { "value": { "alias": "value"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "label": { "alias": "label"; "required": false; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
+}

package/lib/components/process-link-selector/process-link-selector.formio.d.ts

@@ -0,0 +1,4 @@
+import { Injector } from '@angular/core';
+import { FormioCustomComponentInfo } from '@valtimo/components';
+export declare const EPISTOLA_PROCESS_LINK_SELECTOR_OPTIONS: FormioCustomComponentInfo;
+export declare function registerEpistolaProcessLinkSelectorComponent(injector: Injector): void;

package/lib/epistola-admin-routing.module.d.ts

@@ -0,0 +1,7 @@
+import * as i0 from "@angular/core";
+import * as i1 from "@angular/router";
+export declare class EpistolaAdminRoutingModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<EpistolaAdminRoutingModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<EpistolaAdminRoutingModule, never, [typeof i1.RouterModule], [typeof i1.RouterModule]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<EpistolaAdminRoutingModule>;
+}

package/lib/epistola-enabled.guard.d.ts

@@ -0,0 +1,2 @@
+import { CanActivateFn } from '@angular/router';
+export declare const epistolaEnabledGuard: CanActivateFn;

package/lib/epistola-runtime-config.d.ts

@@ -0,0 +1,28 @@
+export interface EpistolaRuntimeEnv {
+    epistolaEnabled?: boolean | string;
+}
+interface EpistolaRuntimeWindow {
+    env?: EpistolaRuntimeEnv;
+}
+declare global {
+    interface Window extends EpistolaRuntimeWindow {
+    }
+}
+/**
+ * Reads the runtime feature flag that decides whether the Epistola plugin
+ * surfaces (admin menu, /epistola route, plugin specification, Formio
+ * components) should activate in the host Valtimo app.
+ *
+ * The flag is sourced from `window['env']['epistolaEnabled']`, populated at
+ * container start by `envsubst` against `assets/config.template.js` (the
+ * standard Valtimo runtime-config pattern). Defaults to enabled — only the
+ * literal `false` or string `'false'` disables the plugin, matching the
+ * backend's `epistola.enabled` `matchIfMissing = true` semantics.
+ *
+ * Exposed as a runtime helper rather than evaluated directly in `@NgModule`
+ * decorator metadata because Angular's AOT compiler cannot statically resolve
+ * `window` accesses (NG1010). Read from runtime code such as specification
+ * property getters, route guards, or the environment initializer instead.
+ */
+export declare function isEpistolaEnabled(): boolean;
+export {};

package/lib/epistola.module.d.ts

@@ -4,22 +4,19 @@ import * as i1 from "@angular/common";
 import * as i2 from "@angular/common/http";
 import * as i3 from "@valtimo/plugin";
 import * as i4 from "@valtimo/components";
-import * as i5 from "./components/epistola-configuration/epistola-configuration.component";
-import * as i6 from "./components/generate-document-configuration/generate-document-configuration.component";
-import * as i7 from "./components/check-job-status-configuration/check-job-status-configuration.component";
-import * as i8 from "./components/download-document-configuration/download-document-configuration.component";
-import * as i9 from "./components/data-mapping-tree/data-mapping-tree.component";
-import * as i10 from "./components/value-input/value-input.component";
-import * as i11 from "./components/scalar-field/scalar-field.component";
-import * as i12 from "./components/array-field/array-field.component";
-import * as i13 from "./components/field-tree/field-tree.component";
-import * as i14 from "./components/epistola-download/epistola-download.component";
-import * as i15 from "./components/epistola-retry-form/epistola-retry-form.component";
-import * as i16 from "./components/epistola-preview-button/epistola-preview-button.component";
-import * as i17 from "./components/epistola-document-preview/epistola-document-preview.component";
+import * as i5 from "./epistola-admin-routing.module";
+import * as i6 from "./components/epistola-configuration/epistola-configuration.component";
+import * as i7 from "./components/generate-document-configuration/generate-document-configuration.component";
+import * as i8 from "./components/check-job-status-configuration/check-job-status-configuration.component";
+import * as i9 from "./components/download-document-configuration/download-document-configuration.component";
+import * as i10 from "./components/epistola-download/epistola-download.component";
+import * as i11 from "./components/epistola-retry-form/epistola-retry-form.component";
+import * as i12 from "./components/epistola-preview-button/epistola-preview-button.component";
+import * as i13 from "./components/epistola-document-preview/epistola-document-preview.component";
+import * as i14 from "./components/epistola-admin-page/epistola-admin-page.component";
 export declare class EpistolaPluginModule {
     static forRoot(): ModuleWithProviders<EpistolaPluginModule>;
     static ɵfac: i0.ɵɵFactoryDeclaration<EpistolaPluginModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<EpistolaPluginModule, never, [typeof i1.CommonModule, typeof i2.HttpClientModule, typeof i3.PluginTranslatePipeModule, typeof i4.FormModule, typeof i4.InputModule, typeof i4.SelectModule, typeof i5.EpistolaConfigurationComponent, typeof i6.GenerateDocumentConfigurationComponent, typeof i7.CheckJobStatusConfigurationComponent, typeof i8.DownloadDocumentConfigurationComponent, typeof i9.DataMappingTreeComponent, typeof i10.ValueInputComponent, typeof i11.ScalarFieldComponent, typeof i12.ArrayFieldComponent, typeof i13.FieldTreeComponent, typeof i14.EpistolaDownloadComponent, typeof i15.EpistolaRetryFormComponent, typeof i16.EpistolaPreviewButtonComponent, typeof i17.EpistolaDocumentPreviewComponent], [typeof i5.EpistolaConfigurationComponent, typeof i6.GenerateDocumentConfigurationComponent, typeof i7.CheckJobStatusConfigurationComponent, typeof i8.DownloadDocumentConfigurationComponent, typeof i9.DataMappingTreeComponent, typeof i10.ValueInputComponent, typeof i11.ScalarFieldComponent, typeof i12.ArrayFieldComponent, typeof i13.FieldTreeComponent, typeof i14.EpistolaDownloadComponent, typeof i15.EpistolaRetryFormComponent, typeof i16.EpistolaPreviewButtonComponent, typeof i17.EpistolaDocumentPreviewComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<EpistolaPluginModule, never, [typeof i1.CommonModule, typeof i2.HttpClientModule, typeof i3.PluginTranslatePipeModule, typeof i4.FormModule, typeof i4.InputModule, typeof i4.SelectModule, typeof i5.EpistolaAdminRoutingModule, typeof i6.EpistolaConfigurationComponent, typeof i7.GenerateDocumentConfigurationComponent, typeof i8.CheckJobStatusConfigurationComponent, typeof i9.DownloadDocumentConfigurationComponent, typeof i10.EpistolaDownloadComponent, typeof i11.EpistolaRetryFormComponent, typeof i12.EpistolaPreviewButtonComponent, typeof i13.EpistolaDocumentPreviewComponent, typeof i14.EpistolaAdminPageComponent], [typeof i6.EpistolaConfigurationComponent, typeof i7.GenerateDocumentConfigurationComponent, typeof i8.CheckJobStatusConfigurationComponent, typeof i9.DownloadDocumentConfigurationComponent, typeof i10.EpistolaDownloadComponent, typeof i11.EpistolaRetryFormComponent, typeof i12.EpistolaPreviewButtonComponent, typeof i13.EpistolaDocumentPreviewComponent, typeof i14.EpistolaAdminPageComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<EpistolaPluginModule>;
 }

package/lib/models/admin.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Connection health check result for a single Epistola plugin configuration.
+ */
+export interface ConnectionStatus {
+    configurationId: string;
+    configurationTitle: string;
+    tenantId: string;
+    reachable: boolean;
+    latencyMs: number;
+    errorMessage?: string;
+    serverVersion?: string;
+}
+/**
+ * Version information for the Epistola plugin and connected server.
+ */
+export interface VersionInfo {
+    pluginVersion: string;
+    epistolaServerVersion?: string;
+}
+/**
+ * Describes a single usage of an Epistola plugin action within a process definition.
+ */
+/**
+ * A process instance currently waiting for an Epistola document generation result.
+ */
+export interface PendingJob {
+    executionId: string;
+    processInstanceId: string;
+    processDefinitionKey: string;
+    processDefinitionName: string;
+    activityId: string;
+    activityName: string;
+    tenantId: string;
+    requestId: string;
+    configurationTitle: string;
+}
+export interface PluginUsageEntry {
+    processLinkId: string;
+    caseDefinitionKey?: string;
+    caseDefinitionVersionTag?: string;
+    processDefinitionKey: string;
+    processDefinitionName: string;
+    activityId: string;
+    activityName: string;
+    actionKey: string;
+    configurationId: string;
+    configurationTitle: string;
+    problems: string[];
+}

package/lib/models/config.d.ts

@@ -26,7 +26,7 @@ export interface VariantAttributeEntry {
  *
  * Variant selection supports two modes:
  * - Explicit: set variantId directly
- * - By attributes: set variantAttributes with key-value pairs (values can be value resolver expressions)
+ * - By attributes: set variantAttributes with key-value pairs (values can be JSONata expressions)
  */
 export interface GenerateDocumentConfig {
     catalogId: string;
@@ -34,7 +34,7 @@ export interface GenerateDocumentConfig {
     variantId?: string;
     variantAttributes?: VariantAttributeEntry[];
     environmentId?: string;
-    dataMapping: Record<string, any>;
+    dataMapping: string;
     outputFormat: 'PDF' | 'HTML';
     filename: string;
     correlationId?: string;
@@ -68,3 +68,31 @@ export interface PreviewSource {
     templateName: string;
     processInstanceId: string;
 }
+export interface VariableSuggestions {
+    doc: string[];
+    pv: string[];
+}
+export interface EvaluationResult {
+    success: boolean;
+    result: Record<string, any> | null;
+    error: string | null;
+}
+/**
+ * Request body for the JSONata save-time validation endpoint.
+ * All fields are optional; null/blank values are skipped.
+ */
+export interface ValidateJsonataRequest {
+    dataMapping?: string | null;
+    filename?: string | null;
+    variantId?: string | null;
+    variantAttributeValues?: Record<string, string> | null;
+}
+export interface JsonataFieldError {
+    field: string;
+    expression: string;
+    message: string;
+}
+export interface JsonataValidationResult {
+    valid: boolean;
+    errors: JsonataFieldError[];
+}