hazo_collab_forms 3.1.7 → 5.0.0

package/dist/lib/resolve_variable.js

@@ -0,0 +1,77 @@
+/**
+ * Resolve variable references (e.g. `@tenant_start_date`, `@Beginning_Of_Tax_Year`)
+ * against the active form data and session-level constants.
+ *
+ * Variable syntax: `@<name>`. Resolution order:
+ *   1. Session vars (by key name) — tax-year boundaries, client name, etc.
+ *   2. Form-field values — looked up by `question_field_id` in `FbFormData.data[]`.
+ *
+ * Empty-string and whitespace-only values are treated as null so a chain like
+ *   ['@tenant_start_date', '@Beginning_Of_Tax_Year']
+ * falls through to the fallback when the user has not yet entered a tenant date.
+ */
+/** Resolve a single variable reference. Returns the value or null if unresolved/empty. */
+export function resolve_variable(ref, ctx) {
+    if (!ref.startsWith('@'))
+        return null;
+    const name = ref.slice(1);
+    // Session-level constants take precedence by name (e.g. Beginning_Of_Tax_Year).
+    if (Object.prototype.hasOwnProperty.call(ctx.session, name)) {
+        return non_empty(ctx.session[name]);
+    }
+    // Otherwise, treat as form-field reference.
+    if (ctx.form_data) {
+        return non_empty(lookup_form_field(ctx.form_data, name));
+    }
+    return null;
+}
+/** Walk the chain. Return the first non-empty resolved value, or null if none resolve. */
+export function resolve_variable_chain(chain, ctx) {
+    for (const ref of chain) {
+        const v = resolve_variable(ref, ctx);
+        if (v !== null)
+            return v;
+    }
+    return null;
+}
+function non_empty(v) {
+    if (v === null || v === undefined)
+        return null;
+    const s = String(v).trim();
+    return s.length === 0 ? null : s;
+}
+/**
+ * Look up a form-field value by question id within FbFormData.
+ *
+ * The v2 hierarchical model stores user input under
+ *   data[].client_data[].client_input.{data_text|data_option}
+ * keyed against a question identified by `question.question_field_id`.
+ *
+ * We return the first non-empty `data_text` we find for the matching question;
+ * if no text input exists we fall back to `data_option`. Returns null when the
+ * question is absent or no input has been provided.
+ */
+function lookup_form_field(form_data, field_id) {
+    for (const entry of form_data.data ?? []) {
+        if (entry.question?.question_field_id !== field_id)
+            continue;
+        for (const cd of entry.client_data ?? []) {
+            const inputs = Array.isArray(cd.client_input)
+                ? cd.client_input
+                : [cd.client_input];
+            // Prefer text input; fall back to option code.
+            for (const inp of inputs) {
+                if (inp?.data_text != null && String(inp.data_text).trim().length > 0) {
+                    return String(inp.data_text);
+                }
+            }
+            for (const inp of inputs) {
+                if (inp?.data_option != null && String(inp.data_option).trim().length > 0) {
+                    return String(inp.data_option);
+                }
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=resolve_variable.js.map

package/dist/lib/resolve_variable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve_variable.js","sourceRoot":"","sources":["../../src/lib/resolve_variable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAaH,0FAA0F;AAC1F,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,GAAmB;IAC/D,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE1B,gFAAgF;IAChF,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;QAC5D,OAAO,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,4CAA4C;IAC5C,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,OAAO,SAAS,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,sBAAsB,CAAC,KAAoB,EAAE,GAAmB;IAC9E,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,SAAS,CAAC,CAAU;IAC3B,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3B,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,iBAAiB,CAAC,SAAqB,EAAE,QAAgB;IAChE,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;QACzC,IAAI,KAAK,CAAC,QAAQ,EAAE,iBAAiB,KAAK,QAAQ;YAAE,SAAS;QAE7D,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;YACzC,MAAM,MAAM,GAAoB,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC;gBAC5D,CAAC,CAAC,EAAE,CAAC,YAAY;gBACjB,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC;YACtB,+CAA+C;YAC/C,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;gBACzB,IAAI,GAAG,EAAE,SAAS,IAAI,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACtE,OAAO,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;YACD,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;gBACzB,IAAI,GAAG,EAAE,WAAW,IAAI,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC1E,OAAO,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBACjC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lib/validation_handler.d.ts

@@ -1,8 +1,9 @@
 /**
  * Server-side validation route handler factory.
  *
- * Creates a POST handler that executes validation rules against uploaded documents
- * using LLM analysis, and returns ClarificationItems for any issues found.
+ * Creates a POST handler that executes validation rules against uploaded
+ * documents or plain text using LLM analysis, and returns ClarificationItems
+ * for any issues found.
  *
  * Usage:
  *   import { create_validation_route } from 'hazo_collab_forms/lib';
@@ -12,7 +13,29 @@
  * hazo_llm_api is dynamically imported so it's only required at runtime.
  */
 import 'server-only';
-import type { ValidationRouteOptions } from '../types/validation.js';
+import type { ValidationIssue, ValidationRouteOptions, ValidationFileEntry } from '../types/validation.js';
+/**
+ * Parse the LLM response into a ValidationRuleResult.
+ *
+ * Expected shape (per validation/response_wrapper in hazo_prompts):
+ *   {
+ *     "summary": "...",                    // optional rule-level explanation
+ *     "issues": [                          // empty = passed
+ *       { "description": "...", "amount": "...", "date": "...", "reason": "...",
+ *         "client_comment": "...", "confidence": 0.9 }
+ *     ],
+ *     "confidence": 0.95                   // optional rule-level confidence
+ *   }
+ *
+ * Tolerates: direct JSON, fenced code block, regex-extracted object, and
+ * top-level arrays (treated as the issues array).
+ */
+export declare function parse_response(text: string, rule_id: string): {
+    summary?: string;
+    issues: ValidationIssue[];
+    confidence?: number;
+    extracted_data?: Record<string, unknown>;
+};
 /**
  * Creates a POST route handler for document validation.
  *
@@ -24,4 +47,5 @@ import type { ValidationRouteOptions } from '../types/validation.js';
  * 5. Returns the results
  */
 export declare function create_validation_route(options?: ValidationRouteOptions): (request: Request) => Promise<Response>;
+export type { ValidationFileEntry };
 //# sourceMappingURL=validation_handler.d.ts.map

package/dist/lib/validation_handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation_handler.d.ts","sourceRoot":"","sources":["../../src/lib/validation_handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,aAAa,CAAC;AAErB,OAAO,KAAK,EAKV,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAoLhC;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,sBAAsB,IAyM3C,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAyMhE"}
+{"version":3,"file":"validation_handler.d.ts","sourceRoot":"","sources":["../../src/lib/validation_handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,aAAa,CAAC;AAErB,OAAO,KAAK,EAKV,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AA2DhC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C,CAuFA;AAgED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,sBAAsB,IA2O3C,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAwKhE;AAGD,YAAY,EAAE,mBAAmB,EAAE,CAAC"}