feat(agent-client): add File and FileList action field support

packages/agent-client/src/action-fields/action-field-file-list.ts

@@ -0,0 +1,25 @@
+import ActionField from './action-field';
+import ActionFieldFile, { type FileInput } from './action-field-file';
+
+export default class ActionFieldFileList extends ActionField {
+  async add(file: FileInput) {
+    const values = (this.field?.getValue() as string[]) || [];
+    await this.setValue([...values, ActionFieldFile.makeDataUri(file)]);
+  }
+
+  async remove(fileName: string) {
+    const values = (this.field?.getValue() as string[]) || [];
+    const nameParam = `name=${encodeURIComponent(fileName)}`;
+    const filtered = values.filter(uri => {
+      const [metadata] = uri.split(';base64,');
+
+      return !metadata.split(';').some(part => part === nameParam);
+    });
+
+    if (filtered.length === values.length) {
+      throw new Error(`File "${fileName}" is not in the list`);
+    }
+
+    await this.setValue(filtered);
+  }
+}

packages/agent-client/src/action-fields/action-field-file.ts

@@ -0,0 +1,24 @@
+import ActionField from './action-field';
+
+export type FileInput = { mimeType: string; buffer: Buffer; name: string; charset?: string };
+
+export default class ActionFieldFile extends ActionField {
+  async fill(file?: FileInput | null) {
+    if (this.isValueUndefinedOrNull(file)) {
+      await this.setValue(file);
+
+      return;
+    }
+
+    await this.setValue(ActionFieldFile.makeDataUri(file));
+  }
+
+  static makeDataUri(file: FileInput): string {
+    const { mimeType, buffer, ...rest } = file;
+    const params = Object.entries(rest)
+      .map(([key, value]) => `${key}=${encodeURIComponent(value)}`)
+      .join(';');
+
+    return `data:${mimeType};${params};base64,${buffer.toString('base64')}`;
+  }
+}

packages/agent-client/src/domains/action.ts

@@ -8,6 +8,8 @@ import ActionFieldColorPicker from '../action-fields/action-field-color-picker';
 import ActionFieldDate from '../action-fields/action-field-date';
 import ActionFieldDropdown from '../action-fields/action-field-dropdown';
 import ActionFieldEnum from '../action-fields/action-field-enum';
+import ActionFieldFile from '../action-fields/action-field-file';
+import ActionFieldFileList from '../action-fields/action-field-file-list';
 import ActionFieldJson from '../action-fields/action-field-json';
 import ActionFieldNumber from '../action-fields/action-field-number';
 import ActionFieldNumberList from '../action-fields/action-field-number-list';
@@ -124,6 +126,11 @@ export default class Action {
         return this.getDateField(fieldName);
       case 'Enum':
         return this.getEnumField(fieldName);
+      case 'File':
+        return this.getFileField(fieldName);
+      case 'FileList':
+      case '["File"]':
+        return this.getFileListField(fieldName);
       case 'String':
       default:
         return this.getFieldString(fieldName);
@@ -174,6 +181,14 @@ export default class Action {
     return new ActionFieldEnum(fieldName, this.fieldsFormStates);
   }
 
+  getFileField(fieldName: string): ActionFieldFile {
+    return new ActionFieldFile(fieldName, this.fieldsFormStates);
+  }
+
+  getFileListField(fieldName: string): ActionFieldFileList {
+    return new ActionFieldFileList(fieldName, this.fieldsFormStates);
+  }
+
   getRadioGroupField(fieldName: string): ActionFieldRadioGroup {
     return new ActionFieldRadioGroup(fieldName, this.fieldsFormStates);
   }