@useago/sdk 0.4.2 → 0.4.4

package/dist/react.d.cts

@@ -542,6 +542,14 @@ export declare interface CreateFormCollectorOptions<V = Record<string, unknown>>
  */
 export declare function createMockClient(options?: MockAgoClientOptions): MockAgoClient;
 
+/**
+ * Compute which required fields are still empty and whether the form is complete.
+ * Pure — the single home for the "required + non-empty" rule, shared by the update
+ * handler, submit, the dynamic context, and the React hook. Derived on read so the
+ * store only ever holds canonical state ({@link FormCollectorState}).
+ */
+export declare function deriveFormStatus(schema: FormCollectorSchema, values: Partial<Record<string, unknown>>): FormCollectorStatus;
+
 /**
  * A function that returns a fresh context entry on demand.
  * Evaluated every time a message is sent — use it to pull data from stores,
@@ -583,16 +591,20 @@ export declare interface FormCollector<V = Record<string, unknown>> {
  */
 export declare type FormCollectorSchema = ClientFunctionSchema["parameters"];
 
-/** Live state held in the collector's store. */
+/** Canonical, source-of-truth state held in the collector's store. */
 export declare interface FormCollectorState<V = Record<string, unknown>> {
     /** Field values collected so far. */
     values: Partial<V>;
+    /** True once a submit succeeded. */
+    submitted: boolean;
+}
+
+/** Completeness status derived from values + schema — computed on read, never stored. */
+export declare interface FormCollectorStatus {
     /** Required field names still empty. */
     missing: string[];
     /** True when no required field is missing. */
     complete: boolean;
-    /** True once a submit succeeded. */
-    submitted: boolean;
 }
 
 declare interface FormField {
@@ -994,8 +1006,11 @@ export declare interface UseConversationResult {
 export declare function useFormCollector<V = Record<string, unknown>>(options: CreateFormCollectorOptions<V>): UseFormCollectorResult<V>;
 
 export declare interface UseFormCollectorResult<V = Record<string, unknown>> extends FormCollector<V> {
-    /** Live form state from the collector's store — re-renders on every change. */
-    state: FormCollectorState<V>;
+    /**
+     * Live form state from the store (`values`, `submitted`) plus the completeness
+     * status (`missing`, `complete`) derived on read — re-renders on every change.
+     */
+    state: FormCollectorState<V> & FormCollectorStatus;
 }
 
 /**

package/dist/react.d.ts

@@ -542,6 +542,14 @@ export declare interface CreateFormCollectorOptions<V = Record<string, unknown>>
  */
 export declare function createMockClient(options?: MockAgoClientOptions): MockAgoClient;
 
+/**
+ * Compute which required fields are still empty and whether the form is complete.
+ * Pure — the single home for the "required + non-empty" rule, shared by the update
+ * handler, submit, the dynamic context, and the React hook. Derived on read so the
+ * store only ever holds canonical state ({@link FormCollectorState}).
+ */
+export declare function deriveFormStatus(schema: FormCollectorSchema, values: Partial<Record<string, unknown>>): FormCollectorStatus;
+
 /**
  * A function that returns a fresh context entry on demand.
  * Evaluated every time a message is sent — use it to pull data from stores,
@@ -583,16 +591,20 @@ export declare interface FormCollector<V = Record<string, unknown>> {
  */
 export declare type FormCollectorSchema = ClientFunctionSchema["parameters"];
 
-/** Live state held in the collector's store. */
+/** Canonical, source-of-truth state held in the collector's store. */
 export declare interface FormCollectorState<V = Record<string, unknown>> {
     /** Field values collected so far. */
     values: Partial<V>;
+    /** True once a submit succeeded. */
+    submitted: boolean;
+}
+
+/** Completeness status derived from values + schema — computed on read, never stored. */
+export declare interface FormCollectorStatus {
     /** Required field names still empty. */
     missing: string[];
     /** True when no required field is missing. */
     complete: boolean;
-    /** True once a submit succeeded. */
-    submitted: boolean;
 }
 
 declare interface FormField {
@@ -994,8 +1006,11 @@ export declare interface UseConversationResult {
 export declare function useFormCollector<V = Record<string, unknown>>(options: CreateFormCollectorOptions<V>): UseFormCollectorResult<V>;
 
 export declare interface UseFormCollectorResult<V = Record<string, unknown>> extends FormCollector<V> {
-    /** Live form state from the collector's store — re-renders on every change. */
-    state: FormCollectorState<V>;
+    /**
+     * Live form state from the store (`values`, `submitted`) plus the completeness
+     * status (`missing`, `complete`) derived on read — re-renders on every change.
+     */
+    state: FormCollectorState<V> & FormCollectorStatus;
 }
 
 /**