@epistola.app/valtimo-plugin 0.3.2 → 0.3.3

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

@@ -32,7 +32,10 @@ export declare class GenerateDocumentConfigurationComponent implements FunctionC
     variantAttributeEntries: {
         key: string;
         value: string;
+        required: boolean;
+        _customKey?: boolean;
     }[];
+    availableAttributeKeys: string[];
     caseDefinitionKey: string | null;
     processVariables: string[];
     requiredFieldsStatus: {
@@ -58,6 +61,18 @@ export declare class GenerateDocumentConfigurationComponent implements FunctionC
     addAttributeEntry(): void;
     removeAttributeEntry(index: number): void;
     onAttributeEntryChange(): void;
+    onKeySelected(entry: {
+        key: string;
+        value: string;
+        required: boolean;
+        _customKey?: boolean;
+    }, value: string): void;
+    cancelCustomKey(entry: {
+        key: string;
+        value: string;
+        required: boolean;
+        _customKey?: boolean;
+    }): void;
     private revalidate;
     private formatAttributes;
     private initContext;
@@ -65,6 +80,7 @@ export declare class GenerateDocumentConfigurationComponent implements FunctionC
     private initPluginConfiguration;
     private initTemplatesLoading;
     private initEnvironmentsLoading;
+    private initAttributesLoading;
     private initVariantsLoading;
     private initTemplateFieldsLoading;
     private loadProcessVariables;

package/lib/models/config.d.ts

@@ -10,6 +10,16 @@ export interface EpistolaPluginConfig extends PluginConfigurationData {
     defaultEnvironmentId?: string;
     templateSyncEnabled?: boolean;
 }
+/**
+ * A single variant attribute entry for attribute-based variant selection.
+ * When required is true, the variant MUST match this attribute.
+ * When required is false, it is a preference (preferred but not mandatory).
+ */
+export interface VariantAttributeEntry {
+    key: string;
+    value: string;
+    required: boolean;
+}
 /**
  * Action configuration for the generate-document action.
  * Contains all parameters needed to generate a document.
@@ -21,7 +31,7 @@ export interface EpistolaPluginConfig extends PluginConfigurationData {
 export interface GenerateDocumentConfig {
     templateId: string;
     variantId?: string;
-    variantAttributes?: Record<string, string>;
+    variantAttributes?: VariantAttributeEntry[];
     environmentId?: string;
     dataMapping: Record<string, any>;
     outputFormat: 'PDF' | 'HTML';

package/lib/models/template.d.ts

@@ -61,3 +61,10 @@ export interface VariantInfo {
     name: string;
     attributes: Record<string, string>;
 }
+/**
+ * An attribute definition for variant selection within a tenant.
+ */
+export interface AttributeDefinition {
+    key: string;
+    description?: string;
+}

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 { EnvironmentInfo, PreviewSource, TemplateDetails, TemplateInfo, ValidationResult, VariantInfo } from '../models';
+import { AttributeDefinition, EnvironmentInfo, PreviewSource, TemplateDetails, TemplateInfo, ValidationResult, VariantInfo } from '../models';
 import * as i0 from "@angular/core";
 /**
  * Service for interacting with Epistola plugin API endpoints.
@@ -21,6 +21,10 @@ export declare class EpistolaPluginService {
      * Get template details including its fields.
      */
     getTemplateDetails(pluginConfigurationId: string, templateId: string): Observable<TemplateDetails>;
+    /**
+     * Get all attribute definitions for a plugin configuration's tenant.
+     */
+    getAttributes(pluginConfigurationId: string): Observable<AttributeDefinition[]>;
     /**
      * Get all available environments for a plugin configuration.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epistola.app/valtimo-plugin",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Epistola document generation plugin for Valtimo",
   "license": "EUPL-1.2",
   "repository": {
@@ -23,10 +23,10 @@
     "@angular/common": ">=17.0.0",
     "@angular/core": ">=17.0.0",
     "@angular/forms": ">=17.0.0",
-    "@valtimo/plugin": "^13.21.0",
     "@valtimo/components": "^13.21.0",
-    "@valtimo/shared": "^13.21.0",
-    "@valtimo/process-link": "^13.21.0"
+    "@valtimo/plugin": "^13.21.0",
+    "@valtimo/process-link": "^13.21.0",
+    "@valtimo/shared": "^13.21.0"
   },
   "dependencies": {
     "tslib": "^2.6.0"