Add new callback adjustFormValueBeforePopulating

Author: binarykitchen

src/options.ts

@@ -137,10 +137,15 @@ const options: VideomailClientOptions = {
 
   callbacks: {
     /*
-     * a custom callback to tweak form data before posting to server
+     * A custom callback to tweak form data before posting to server
      * this is for advanced use only and shouldn't be used if possible
      */
     adjustFormDataBeforePosting: undefined,
+
+    /*
+      Another custom callback to tweak a single form value before populating the form.
+    */
+    adjustFormValueBeforePopulating: undefined,
   },
 
   defaults: {

src/types/options.ts

@@ -1,6 +1,6 @@
 import { PartialDeep } from "type-fest";
 
-import { PartialVideomail } from "./Videomail";
+import { PartialVideomail, Videomail } from "./Videomail";
 
 export interface VideomailClientOptions {
   logger: {
@@ -118,6 +118,9 @@ export interface VideomailClientOptions {
     adjustFormDataBeforePosting?:
       | undefined
       | ((videomail: PartialVideomail) => PartialVideomail);
+    adjustFormValueBeforePopulating?:
+      | undefined
+      | ((name: string, videomail: Videomail) => string);
   };
 
   defaults: {

src/wrappers/form.ts

@@ -114,9 +114,13 @@ class Form extends Despot {
       const name = formControl.getAttribute("name");
 
       if (name) {
-        const value = videomail[name];
+        let value = videomail[name];
         const tagName = formControl.tagName;
 
+        if (this.options.callbacks.adjustFormValueBeforePopulating) {
+          value = this.options.callbacks.adjustFormValueBeforePopulating(name, videomail);
+        }
+
         switch (tagName) {
           case "INPUT": {
             const inputControl = formControl as HTMLInputElement;