formanitor 0.0.10 → 0.0.11

package/dist/index.d.cts

@@ -244,12 +244,14 @@ interface PersistenceProvider {
 type Listener = (state: FormState) => void;
 type EventListener = (event: string, payload?: any) => void;
 type UploadHandler = (file: File | Blob, filename: string) => Promise<string>;
+type DraftChangeHandler = (payload: SavedState) => void | Promise<void>;
 interface StoreConfig {
     persistence?: PersistenceProvider;
     prefillData?: Record<string, any>;
     role?: string;
     onEvent?: EventListener;
     onUpload?: UploadHandler;
+    onDraftChange?: DraftChangeHandler;
 }
 declare class FormStore {
     private state;
@@ -260,6 +262,7 @@ declare class FormStore {
     private prefillData;
     private config;
     private saveTimeout;
+    private draftCallbackTimeout;
     constructor(schema: FormDef, config?: StoreConfig);
     private initializeDefaults;
     getState(): FormState;
@@ -278,6 +281,7 @@ declare class FormStore {
     setRole(role: string): void;
     load(): Promise<void>;
     private scheduleSave;
+    private scheduleDraftCallback;
     save(): Promise<void>;
     /**
      * Prepare values for outbound submission to the backend.

package/dist/index.d.ts

@@ -244,12 +244,14 @@ interface PersistenceProvider {
 type Listener = (state: FormState) => void;
 type EventListener = (event: string, payload?: any) => void;
 type UploadHandler = (file: File | Blob, filename: string) => Promise<string>;
+type DraftChangeHandler = (payload: SavedState) => void | Promise<void>;
 interface StoreConfig {
     persistence?: PersistenceProvider;
     prefillData?: Record<string, any>;
     role?: string;
     onEvent?: EventListener;
     onUpload?: UploadHandler;
+    onDraftChange?: DraftChangeHandler;
 }
 declare class FormStore {
     private state;
@@ -260,6 +262,7 @@ declare class FormStore {
     private prefillData;
     private config;
     private saveTimeout;
+    private draftCallbackTimeout;
     constructor(schema: FormDef, config?: StoreConfig);
     private initializeDefaults;
     getState(): FormState;
@@ -278,6 +281,7 @@ declare class FormStore {
     setRole(role: string): void;
     load(): Promise<void>;
     private scheduleSave;
+    private scheduleDraftCallback;
     save(): Promise<void>;
     /**
      * Prepare values for outbound submission to the backend.

package/dist/index.mjs

@@ -178,6 +178,7 @@ var FormStore = class {
   config;
   // Cache for debounce
   saveTimeout = null;
+  draftCallbackTimeout = null;
   constructor(schema, config = {}) {
     this.schema = schema;
     this.config = config;
@@ -247,7 +248,10 @@ var FormStore = class {
     this.checkEvents(fieldId, "onValueChange", value);
     this.evaluate();
     this.notify();
-    this.scheduleSave();
+    this.scheduleDraftCallback();
+    if (!this.config.onDraftChange) {
+      this.scheduleSave();
+    }
   }
   setTouched(fieldId) {
     if (this.state.touched[fieldId]) return;
@@ -283,6 +287,26 @@ var FormStore = class {
       this.save();
     }, 1e3);
   }
+  scheduleDraftCallback() {
+    if (!this.config.onDraftChange) return;
+    if (this.draftCallbackTimeout) {
+      clearTimeout(this.draftCallbackTimeout);
+    }
+    this.draftCallbackTimeout = setTimeout(() => {
+      const payload = {
+        // For consumer callbacks, send values in the same
+        // serialized shape used for outbound submissions so
+        // media/signature fields are wrapped consistently.
+        values: this.serializeValuesForSubmission(this.state.values),
+        meta: {
+          updatedAt: Date.now(),
+          workflowState: this.state.workflowState,
+          version: this.schema.version
+        }
+      };
+      this.config.onDraftChange?.(payload);
+    }, 2500);
+  }
   async save() {
     const payload = {
       values: this.state.values,
@@ -470,6 +494,7 @@ var FormStore = class {
     let needsReeval = false;
     if (next.onUpload !== void 0) this.config.onUpload = next.onUpload;
     if (next.onEvent !== void 0) this.config.onEvent = next.onEvent;
+    if (next.onDraftChange !== void 0) this.config.onDraftChange = next.onDraftChange;
     if (next.role !== void 0 && next.role !== this.config.role) {
       this.config.role = next.role;
       needsReeval = true;