@epistola.app/valtimo-plugin 0.5.1 → 0.6.0

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/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, TemplateField, VariableSuggestions } from '../../models';
 import { EpistolaPluginService } from '../../services';
 import * as i0 from "@angular/core";
 export type VariantSelectionMode = 'explicit' | 'attributes';
@@ -25,7 +25,10 @@ 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" */
@@ -41,6 +44,8 @@ export declare class GenerateDocumentConfigurationComponent implements FunctionC
     availableAttributeKeys: string[];
     caseDefinitionKey: string | null;
     processVariables: string[];
+    expressionFunctions: ExpressionFunctionInfo[];
+    variableSuggestions: VariableSuggestions | null;
     requiredFieldsStatus: {
         mapped: number;
         total: number;
@@ -57,7 +62,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;
@@ -99,7 +104,9 @@ export declare class GenerateDocumentConfigurationComponent implements FunctionC
      *   prefill + templateFields loaded → seed dataMapping
      */
     private initCascade;
+    private loadExpressionFunctions;
     private loadProcessVariables;
+    private loadVariableSuggestions;
     private handleValid;
     private openSaveSubscription;
     static ɵfac: i0.ɵɵFactoryDeclaration<GenerateDocumentConfigurationComponent, 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/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.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

@@ -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,12 @@ 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;
+}

package/lib/models/expression.d.ts

@@ -0,0 +1,13 @@
+export interface ExpressionFunctionInfo {
+    name: string;
+    description: string;
+    overloads: OverloadInfo[];
+}
+export interface OverloadInfo {
+    arguments: ArgumentInfo[];
+    returnType: string;
+}
+export interface ArgumentInfo {
+    name: string;
+    type: string;
+}

package/lib/models/index.d.ts

@@ -1,3 +1,5 @@
+export * from './admin';
 export * from './async-resource';
 export * from './config';
+export * from './expression';
 export * from './template';

package/lib/models/template.d.ts

@@ -41,12 +41,6 @@ export interface DataMappingEntry {
  */
 export type DataSourceType = 'document' | 'processVariable' | 'manual';
 /**
- * Validation result from the backend.
- */
-export interface ValidationResult {
-    valid: boolean;
-    missingRequiredFields: string[];
-}
 /**
  * Information about an Epistola environment.
  */

package/lib/services/epistola-admin.service.d.ts

@@ -0,0 +1,37 @@
+import { HttpClient } from '@angular/common/http';
+import { ConfigService } from '@valtimo/shared';
+import { Observable } from 'rxjs';
+import { ConnectionStatus, PendingJob, PluginUsageEntry, VersionInfo } from '../models';
+import * as i0 from "@angular/core";
+/**
+ * Service for Epistola plugin administrative operations.
+ * Provides health checks, version info, and usage overview.
+ */
+export declare class EpistolaAdminService {
+    private readonly http;
+    private readonly configService;
+    private readonly apiEndpoint;
+    constructor(http: HttpClient, configService: ConfigService);
+    /**
+     * Check connectivity to Epistola for all plugin configurations.
+     */
+    getConnectionStatus(): Observable<ConnectionStatus[]>;
+    /**
+     * Get version information for the plugin and connected Epistola server.
+     */
+    getVersions(): Observable<VersionInfo>;
+    /**
+     * Get an overview of all Epistola plugin usages across process definitions.
+     */
+    getPluginUsage(): Observable<PluginUsageEntry[]>;
+    /**
+     * Get all process instances currently waiting for an Epistola document generation result.
+     */
+    getPendingJobs(): Observable<PendingJob[]>;
+    /**
+     * Export a single process link as a .process-link.json file.
+     */
+    exportProcessLink(processLinkId: string): Observable<Blob>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EpistolaAdminService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<EpistolaAdminService>;
+}

package/lib/services/epistola-menu.service.d.ts

@@ -0,0 +1,13 @@
+import { MenuService } from '@valtimo/components';
+import * as i0 from "@angular/core";
+/**
+ * Registers the Epistola admin page menu item under the Admin > Other section.
+ * Instantiated eagerly via ENVIRONMENT_INITIALIZER so the menu item
+ * appears without any manual configuration in the host application.
+ */
+export declare class EpistolaMenuService {
+    private readonly menuService;
+    constructor(menuService: MenuService);
+    static ɵfac: i0.ɵɵFactoryDeclaration<EpistolaMenuService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<EpistolaMenuService>;
+}

package/lib/services/epistola-plugin.service.d.ts

@@ -1,7 +1,7 @@
 import { HttpClient } from '@angular/common/http';
 import { ConfigService } from '@valtimo/shared';
 import { Observable } from 'rxjs';
-import { AttributeDefinition, CatalogInfo, EnvironmentInfo, PreviewSource, TemplateDetails, TemplateInfo, ValidationResult, VariantInfo } from '../models';
+import { AttributeDefinition, CatalogInfo, EnvironmentInfo, ExpressionFunctionInfo, PreviewSource, TemplateDetails, TemplateInfo, EvaluationResult, VariableSuggestions, VariantInfo } from '../models';
 import * as i0 from "@angular/core";
 /**
  * Service for interacting with Epistola plugin API endpoints.
@@ -42,13 +42,21 @@ export declare class EpistolaPluginService {
      */
     getProcessVariables(processDefinitionKey: string): Observable<string[]>;
     /**
-     * Validate that a data mapping covers all required template fields.
+     * Get variable suggestions for JSONata autocompletion.
      */
-    validateMapping(pluginConfigurationId: string, templateId: string, dataMapping: Record<string, any>): Observable<ValidationResult>;
+    getVariableSuggestions(caseDefinitionKey?: string, processDefinitionKey?: string): Observable<VariableSuggestions>;
+    /**
+     * Evaluate a JSONata expression against a real document.
+     */
+    evaluateMapping(expression: string, documentId: string, processInstanceId?: string): Observable<EvaluationResult>;
     /**
      * Get a dynamically generated Formio form for retrying a failed document generation.
      */
     getRetryForm(processInstanceId: string, documentId?: string, sourceActivityId?: string): Observable<any>;
+    /**
+     * List all available expression functions for expr: data mapping values.
+     */
+    getExpressionFunctions(): Observable<ExpressionFunctionInfo[]>;
     /**
      * Discover all previewable document sources for a given Valtimo document.
      */

package/lib/services/index.d.ts

@@ -1 +1,3 @@
+export * from './epistola-admin.service';
+export * from './epistola-menu.service';
 export * from './epistola-plugin.service';

package/lib/utils/jsonata-converter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Represents a field in the visual builder.
+ * - mode 'ref': a simple $doc/$pv/$case path reference
+ * - mode 'raw': raw JSONata text the builder can't represent visually
+ */
+export interface BuilderField {
+    name: string;
+    mode: 'ref' | 'raw';
+    value: string;
+    children?: BuilderField[];
+}
+/**
+ * Parse a JSONata expression into BuilderField array.
+ * Only supports top-level object literals with simple path references or nested objects.
+ * Anything else is stored as raw JSONata text.
+ */
+export declare function parseJsonataToBuilder(expression: string): BuilderField[];
+/**
+ * Convert BuilderField array back to a JSONata expression string.
+ */
+export declare function builderToJsonata(fields: BuilderField[]): string;
+/**
+ * Check if a JSONata expression can be fully represented by the builder
+ * (i.e., all fields are simple refs or nested objects of simple refs).
+ */
+export declare function isBuilderCompatible(expression: string): boolean;

package/lib/utils/jsonata-monaco.d.ts

@@ -0,0 +1,14 @@
+import { ExpressionFunctionInfo, VariableSuggestions } from '../models';
+/**
+ * Shared state for the JSONata completion provider.
+ * Updated by the editor component when suggestions/functions change.
+ */
+export declare const jsonataCompletionData: {
+    suggestions: VariableSuggestions | null;
+    functions: ExpressionFunctionInfo[];
+};
+/**
+ * Register the JSONata language in Monaco editor.
+ * Call this once when Monaco is available (e.g., in editor component OnInit).
+ */
+export declare function registerJsonataLanguage(monaco: any): void;

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@epistola.app/valtimo-plugin",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Epistola document generation plugin for Valtimo",
   "license": "EUPL-1.2",
   "repository": {
     "type": "git",
     "url": "https://github.com/epistola-app/valtimo-epistola-plugin"
   },
+  "sideEffects": false,
   "module": "fesm2022/epistola.app-valtimo-plugin.mjs",
   "typings": "index.d.ts",
   "exports": {
@@ -18,17 +19,18 @@
       "default": "./fesm2022/epistola.app-valtimo-plugin.mjs"
     }
   },
-  "sideEffects": false,
+  "dependencies": {
+    "tslib": "^2.6.0"
+  },
   "peerDependencies": {
     "@angular/common": ">=17.0.0",
     "@angular/core": ">=17.0.0",
     "@angular/forms": ">=17.0.0",
+    "@angular/router": ">=17.0.0",
     "@valtimo/components": "^13.21.0",
     "@valtimo/plugin": "^13.21.0",
     "@valtimo/process-link": "^13.21.0",
+    "@valtimo/security": "^13.21.0",
     "@valtimo/shared": "^13.21.0"
-  },
-  "dependencies": {
-    "tslib": "^2.6.0"
   }
 }

package/public_api.d.ts

@@ -2,15 +2,14 @@ export * from './lib/models';
 export * from './lib/services';
 export * from './lib/epistola.module';
 export * from './lib/epistola.specification';
+export * from './lib/epistola-admin-routing.module';
+export * from './lib/components/epistola-admin-page/epistola-admin-page.component';
 export * from './lib/components/epistola-configuration/epistola-configuration.component';
 export * from './lib/components/generate-document-configuration/generate-document-configuration.component';
 export * from './lib/components/check-job-status-configuration/check-job-status-configuration.component';
 export * from './lib/components/download-document-configuration/download-document-configuration.component';
-export * from './lib/components/value-input/value-input.component';
-export * from './lib/components/scalar-field/scalar-field.component';
-export * from './lib/components/array-field/array-field.component';
-export * from './lib/components/field-tree/field-tree.component';
-export * from './lib/components/data-mapping-tree/data-mapping-tree.component';
+export * from './lib/components/jsonata-editor/jsonata-editor.component';
+export * from './lib/components/mapping-builder/mapping-builder.component';
 export * from './lib/components/epistola-download/epistola-download.component';
 export * from './lib/components/epistola-download/epistola-download.formio';
 export * from './lib/components/epistola-retry-form/epistola-retry-form.component';

package/lib/components/array-field/array-field.component.d.ts

@@ -1,27 +0,0 @@
-import { EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
-import { TemplateField } from '../../models';
-import * as i0 from "@angular/core";
-export declare class ArrayFieldComponent implements OnChanges {
-    field: TemplateField;
-    value: any;
-    pluginId: string;
-    caseDefinitionKey: string | null;
-    processVariables: string[];
-    disabled: boolean;
-    valueChange: EventEmitter<any>;
-    expanded: boolean;
-    arrayPerFieldMode: boolean;
-    mappedCount: number;
-    totalRequired: number;
-    ngOnChanges(changes: SimpleChanges): void;
-    toggleExpanded(): void;
-    getSourceValue(): string;
-    onSourceValueChange(newValue: string): void;
-    toggleArrayPerFieldMode(): void;
-    onItemFieldChange(childName: string, sourceFieldName: string): void;
-    getItemFieldValue(childName: string): string;
-    hasArrayChildren(): boolean;
-    private updateCompleteness;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ArrayFieldComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ArrayFieldComponent, "epistola-array-field", never, { "field": { "alias": "field"; "required": false; }; "value": { "alias": "value"; "required": false; }; "pluginId": { "alias": "pluginId"; "required": false; }; "caseDefinitionKey": { "alias": "caseDefinitionKey"; "required": false; }; "processVariables": { "alias": "processVariables"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
-}

package/lib/components/data-mapping-tree/data-mapping-tree.component.d.ts

@@ -1,27 +0,0 @@
-import { EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
-import { TemplateField } from '../../models';
-import * as i0 from "@angular/core";
-/**
- * Top-level wrapper that hosts FieldTreeComponent instances for each top-level template field.
- * Manages the full nested mapping object, completeness tracking, and emits mapping changes.
- */
-export declare class DataMappingTreeComponent implements OnChanges {
-    pluginId: string;
-    templateFields: TemplateField[];
-    prefillMapping: Record<string, any>;
-    disabled: boolean;
-    caseDefinitionKey: string | null;
-    processVariables: string[];
-    mappingChange: EventEmitter<Record<string, any>>;
-    requiredFieldsStatus: EventEmitter<{
-        mapped: number;
-        total: number;
-    }>;
-    mapping: Record<string, any>;
-    ngOnChanges(changes: SimpleChanges): void;
-    onFieldValueChange(fieldName: string, value: any): void;
-    getFieldValue(fieldName: string): any;
-    private emitRequiredFieldsStatus;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DataMappingTreeComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DataMappingTreeComponent, "epistola-data-mapping-tree", never, { "pluginId": { "alias": "pluginId"; "required": false; }; "templateFields": { "alias": "templateFields"; "required": false; }; "prefillMapping": { "alias": "prefillMapping"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "caseDefinitionKey": { "alias": "caseDefinitionKey"; "required": false; }; "processVariables": { "alias": "processVariables"; "required": false; }; }, { "mappingChange": "mappingChange"; "requiredFieldsStatus": "requiredFieldsStatus"; }, never, never, true, never>;
-}