hazo_collab_forms 1.12.0 → 2.0.0

package/dist/lib/autofill_handler.js

@@ -0,0 +1,330 @@
+/**
+ * Server-side autofill route handler factory.
+ *
+ * Wraps hazo_llm_api's hazo_llm_dynamic_data_extract into a ready-made
+ * POST handler so consumers can set up autofill in ~2 lines:
+ *
+ *   import { create_autofill_route } from 'hazo_collab_forms/lib';
+ *   export const POST = create_autofill_route();
+ *
+ * Uses standard Web API Request/Response for portability (works in Next.js,
+ * Deno, Cloudflare Workers, etc.).
+ *
+ * hazo_llm_api is dynamically imported so it's only required at runtime
+ * when the handler is actually called.
+ */
+import 'server-only';
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Build a detailed field list string from field schemas.
+ * Used as the {{field_list}} variable in LLM prompts.
+ */
+function build_field_list_string(fields) {
+    return fields.map((f) => {
+        let desc = `- "${f.field_id}" (${f.label})`;
+        if (f.description)
+            desc += `: ${f.description}`;
+        if (f.input_type === 'numeric')
+            desc += ' [numeric value]';
+        if (f.input_options?.length) {
+            desc += ` [one of: ${f.input_options.map((o) => o.value).join(', ')}]`;
+        }
+        if (f.component_type === 'HazoCollabFormCheckbox')
+            desc += ' [true/false]';
+        if (f.component_type === 'HazoCollabFormDate')
+            desc += ' [date in YYYY-MM-DD format]';
+        // Data table: enumerate columns so the LLM knows exact column IDs/types
+        if (f.component_type === 'HazoCollabFormDataTable' && f.table_config) {
+            const config = f.table_config;
+            if (config.columns?.length) {
+                desc += ': array of row objects with columns:';
+                for (const col of config.columns) {
+                    let col_desc = `\n    - "${col.id}" (${col.label})`;
+                    if (col.field_type === 'numeric' || col.field_type === 'currency') {
+                        col_desc += ': numeric';
+                        if (col.constraints?.decimal_places !== undefined) {
+                            col_desc += ` [${col.constraints.decimal_places} decimal places]`;
+                        }
+                    }
+                    else if (col.field_type === 'dropdown' || col.field_type === 'radiobutton') {
+                        col_desc += `: ${col.field_type}`;
+                    }
+                    else {
+                        col_desc += ': text';
+                    }
+                    if (col.constraints?.required)
+                        col_desc += ' [required]';
+                    desc += col_desc;
+                }
+            }
+            else {
+                desc += ' [array of row objects]';
+            }
+        }
+        return desc;
+    }).join('\n');
+}
+/**
+ * Parse LLM response text as JSON, stripping markdown code fences if present.
+ */
+function parse_json_response(text) {
+    const cleaned = text.trim();
+    // Try direct parse first
+    try {
+        return JSON.parse(cleaned);
+    }
+    catch {
+        // Continue to more sophisticated extraction
+    }
+    // Strip markdown code fences
+    const fence_match = cleaned.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+    if (fence_match) {
+        return JSON.parse(fence_match[1].trim());
+    }
+    // Try to find a JSON object anywhere in the text
+    const json_match = cleaned.match(/\{[\s\S]*\}/);
+    if (json_match) {
+        return JSON.parse(json_match[0]);
+    }
+    throw new Error('No JSON found in response');
+}
+function is_image_mime(mime_type) {
+    return mime_type.startsWith('image/');
+}
+function is_document_mime(mime_type) {
+    return mime_type === 'application/pdf';
+}
+// ============================================================================
+// Route Handler Factory
+// ============================================================================
+/**
+ * Creates a POST route handler for autofill document extraction.
+ *
+ * The handler:
+ * 1. Validates request (prompt_area, prompt_key required)
+ * 2. Initializes hazo_llm_api (once, lazily)
+ * 3. Calls hazo_llm_dynamic_data_extract for prompt lookup + LLM extraction
+ * 4. Falls back to direct LLM call if dynamic extract isn't suitable
+ * 5. Returns extracted data as JSON
+ */
+export function create_autofill_route(options) {
+    const sqlite_path = options?.sqlite_path ?? 'data/prompt_library.sqlite';
+    const on_error = options?.on_error ?? ((err, ctx) => console.error(`[autofill] ${ctx}:`, err));
+    let init_promise = null;
+    // Cache the dynamic import
+    let llm_api_module = null;
+    async function get_llm_api() {
+        if (!llm_api_module) {
+            try {
+                // Use variable to prevent TypeScript from resolving the module at compile time
+                const module_id = 'hazo_llm_api/server';
+                llm_api_module = await import(/* webpackIgnore: true */ module_id);
+            }
+            catch (err) {
+                throw new Error('hazo_llm_api is required for autofill. Install it: npm install hazo_llm_api');
+            }
+        }
+        return llm_api_module;
+    }
+    async function ensure_initialized() {
+        const api = await get_llm_api();
+        if (!api.is_initialized()) {
+            if (!init_promise) {
+                init_promise = api.initialize_llm_api({ sqlite_path }).then(() => { });
+            }
+            await init_promise;
+        }
+    }
+    /**
+     * Generate a default extraction prompt from field schemas.
+     * Used as fallback when no prompt exists in the database.
+     */
+    function generate_default_prompt(fields) {
+        const field_list = build_field_list_string(fields);
+        return `Extract the following fields from this document and return ONLY valid JSON (no markdown, no explanation).
+
+Fields to extract:
+${field_list}
+
+Return a JSON object where keys are the field IDs shown in quotes above.
+For numeric fields, return the value as a string (e.g., "1234.56").
+For checkbox fields, return true or false.
+For date fields, return the date in YYYY-MM-DD format.
+For data table fields, return an array of row objects where each key matches a column ID.
+If a field cannot be found in the document, omit it from the response.
+
+Return ONLY the JSON object, no other text.`;
+    }
+    return async function POST(request) {
+        try {
+            const body = await request.json();
+            const { file_name, mime_type, download_url, file_b64: request_file_b64, prompt_area, prompt_key, fields, } = body;
+            // Validate required fields
+            if (!prompt_area || !prompt_key) {
+                return Response.json({
+                    success: false,
+                    error: 'prompt_area and prompt_key are required',
+                    data: {},
+                }, { status: 400 });
+            }
+            if (!fields?.length) {
+                return Response.json({
+                    success: false,
+                    error: 'fields array is required and must not be empty',
+                    data: {},
+                }, { status: 400 });
+            }
+            // Initialize hazo_llm_api
+            await ensure_initialized();
+            const api = await get_llm_api();
+            // Get file as base64 — prefer inline data, fall back to fetching from download_url
+            let file_b64;
+            if (request_file_b64) {
+                file_b64 = request_file_b64;
+            }
+            else {
+                try {
+                    const absolute_url = download_url.startsWith('http')
+                        ? download_url
+                        : `${new URL(request.url).origin}${download_url}`;
+                    const file_response = await fetch(absolute_url);
+                    if (!file_response.ok) {
+                        throw new Error(`Failed to fetch file: ${file_response.status}`);
+                    }
+                    const buffer = Buffer.from(await file_response.arrayBuffer());
+                    file_b64 = buffer.toString('base64');
+                }
+                catch (err) {
+                    return Response.json({
+                        success: false,
+                        error: `Failed to fetch uploaded file "${file_name}": ${err instanceof Error ? err.message : 'Unknown error'}`,
+                        data: {},
+                    }, { status: 500 });
+                }
+            }
+            // Build field_list string for prompt variable substitution
+            const field_list = build_field_list_string(fields);
+            // Determine file MIME category for hazo_llm_dynamic_data_extract
+            const effective_mime = is_image_mime(mime_type) || is_document_mime(mime_type)
+                ? mime_type
+                : mime_type; // pass through — hazo_llm_api handles type routing
+            // Try hazo_llm_dynamic_data_extract first (prompt lookup + LLM call + JSON parsing)
+            try {
+                const result = await api.hazo_llm_dynamic_data_extract({
+                    initial_prompt_area: prompt_area,
+                    initial_prompt_key: prompt_key,
+                    initial_prompt_variables: [{ field_list }],
+                    file_b64,
+                    file_mime_type: effective_mime,
+                    max_depth: 1,
+                });
+                if (result.success && result.merged_result && Object.keys(result.merged_result).length > 0) {
+                    const has_data = Object.values(result.merged_result).some((v) => {
+                        if (v === null || v === undefined || v === '')
+                            return false;
+                        if (Array.isArray(v) && v.length === 0)
+                            return false;
+                        return true;
+                    });
+                    return Response.json({
+                        success: true,
+                        data: result.merged_result,
+                        ...(has_data ? {} : { message: 'No matching data found in this document.' }),
+                    });
+                }
+                // If dynamic extract failed or returned empty, fall through to direct LLM call
+                if (!result.success && result.errors?.length) {
+                    on_error(result.errors, 'dynamic_data_extract failed, falling back to direct LLM call');
+                }
+            }
+            catch (dde_err) {
+                on_error(dde_err, 'dynamic_data_extract threw, falling back to direct LLM call');
+            }
+            // Fallback: direct LLM call with generated or DB-looked-up prompt
+            let prompt_text;
+            try {
+                const connect = api.get_hazo_connect();
+                if (connect) {
+                    const lookup = await connect.get_by_area_key(prompt_area, prompt_key);
+                    if (lookup.success && lookup.data?.prompt_text_full) {
+                        prompt_text = api.substitute_variables(lookup.data.prompt_text_full, [{ field_list }], api.default_logger);
+                    }
+                    else {
+                        prompt_text = generate_default_prompt(fields);
+                    }
+                }
+                else {
+                    prompt_text = generate_default_prompt(fields);
+                }
+            }
+            catch {
+                prompt_text = generate_default_prompt(fields);
+            }
+            // Call LLM based on file type
+            let llm_response;
+            if (is_image_mime(mime_type)) {
+                llm_response = await api.hazo_llm_image_text({
+                    prompt: prompt_text,
+                    image_b64: file_b64,
+                    image_mime_type: mime_type,
+                });
+            }
+            else if (is_document_mime(mime_type)) {
+                llm_response = await api.hazo_llm_document_text({
+                    prompt: prompt_text,
+                    document_b64: file_b64,
+                    document_mime_type: mime_type,
+                });
+            }
+            else {
+                llm_response = await api.hazo_llm_image_text({
+                    prompt: prompt_text,
+                    image_b64: file_b64,
+                    image_mime_type: mime_type,
+                });
+            }
+            if (!llm_response.success || !llm_response.text) {
+                return Response.json({
+                    success: false,
+                    error: llm_response.error || 'LLM extraction failed',
+                    data: {},
+                }, { status: 500 });
+            }
+            // Parse JSON response from LLM
+            let extracted_data;
+            try {
+                extracted_data = parse_json_response(llm_response.text);
+            }
+            catch {
+                return Response.json({
+                    success: false,
+                    error: `Failed to parse LLM response as JSON. Raw: ${llm_response.text.substring(0, 200)}`,
+                    data: {},
+                }, { status: 500 });
+            }
+            const has_data = Object.values(extracted_data).some((v) => {
+                if (v === null || v === undefined || v === '')
+                    return false;
+                if (Array.isArray(v) && v.length === 0)
+                    return false;
+                return true;
+            });
+            return Response.json({
+                success: true,
+                data: extracted_data,
+                ...(has_data ? {} : { message: 'No matching data found in this document.' }),
+            });
+        }
+        catch (error) {
+            on_error(error, 'unhandled error');
+            return Response.json({
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error',
+                data: {},
+            }, { status: 500 });
+        }
+    };
+}
+//# sourceMappingURL=autofill_handler.js.map

package/dist/lib/autofill_handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autofill_handler.js","sourceRoot":"","sources":["../../src/lib/autofill_handler.ts"],"names":[],"mappings":"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"}

package/dist/lib/index.d.ts

@@ -4,4 +4,13 @@
 export { get_config, get_config_path, has_config } from './config.js';
 export { set_server_logger, get_server_logger } from '../logger/server.js';
 export type { Logger } from '../logger/types.js';
+export { create_autofill_route } from './autofill_handler.js';
+export type { AutofillRouteOptions } from './autofill_handler.js';
+export type { ContentTagConfig } from '../types/file_manager.js';
+export type { AutofillRequest, AutofillResponse, AutofillFieldSchema } from '../components/autofill_dropzone/types.js';
+export type { ClarificationType, ClarificationStatus, ClarificationDocReference, ClarificationResponseOption, ClarificationItem, ClarificationTemplate, ClarificationResponse, ClarificationCallbacks, ClarificationCounts, } from '../types/clarification.js';
+export { DEFAULT_CLARIFICATION_TEMPLATES } from '../config/clarification_templates.js';
+export { create_validation_route } from './validation_handler.js';
+export type { ValidationRouteOptions, ValidationRequest, ValidationResponse, ValidationRuleExecution, ValidationRuleResult, ValidationRule, ValidationRuleRecord, PromptCommand, PromptVariable, PromptEditorConfig, } from '../types/validation.js';
+export { DEFAULT_PROMPT_COMMANDS, DEFAULT_PROMPT_VARIABLES, DEFAULT_PROMPT_EDITOR_CONFIG, } from '../config/validation_rule_commands.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,YAAY,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,YAAY,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAGlE,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAGvH,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,2BAA2B,EAC3B,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAGvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,YAAY,EACV,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC"}

package/dist/lib/index.js

@@ -3,4 +3,9 @@
  */
 export { get_config, get_config_path, has_config } from './config.js';
 export { set_server_logger, get_server_logger } from '../logger/server.js';
+export { create_autofill_route } from './autofill_handler.js';
+export { DEFAULT_CLARIFICATION_TEMPLATES } from '../config/clarification_templates.js';
+// Validation route handler (for server-side use)
+export { create_validation_route } from './validation_handler.js';
+export { DEFAULT_PROMPT_COMMANDS, DEFAULT_PROMPT_VARIABLES, DEFAULT_PROMPT_EDITOR_CONFIG, } from '../config/validation_rule_commands.js';
 //# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAmB9D,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAEvF,iDAAiD;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAalE,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC"}

package/dist/lib/validation_handler.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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.
+ *
+ * Usage:
+ *   import { create_validation_route } from 'hazo_collab_forms/lib';
+ *   export const POST = create_validation_route();
+ *
+ * Uses standard Web API Request/Response for portability.
+ * hazo_llm_api is dynamically imported so it's only required at runtime.
+ */
+import 'server-only';
+import type { ValidationRouteOptions } from '../types/validation.js';
+/**
+ * Creates a POST route handler for document validation.
+ *
+ * The handler:
+ * 1. Validates the request payload
+ * 2. Fetches the file (inline or from URL)
+ * 3. Executes each validation rule against the document via LLM
+ * 4. Creates ClarificationItems for rules that find issues
+ * 5. Returns the results
+ */
+export declare function create_validation_route(options?: ValidationRouteOptions): (request: Request) => Promise<Response>;
+//# sourceMappingURL=validation_handler.d.ts.map

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

@@ -0,0 +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,IA+F3C,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAyHhE"}