ocr-provenance-mcp 1.0.0

package/dist/services/storage/database/form-fill-operations.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Form fill operations for DatabaseService
+ *
+ * Handles all CRUD operations for form fill results
+ * from the Datalab /fill API.
+ */
+import Database from 'better-sqlite3';
+import { FormFill } from '../../../models/form-fill.js';
+/**
+ * Insert a form fill record
+ *
+ * @param db - Database connection
+ * @param formFill - Form fill data
+ * @param updateMetadataCounts - Callback to update metadata counts
+ * @returns string - The form fill ID
+ */
+export declare function insertFormFill(db: Database.Database, formFill: FormFill, updateMetadataCounts: () => void): string;
+/**
+ * Get a form fill by ID
+ *
+ * @param db - Database connection
+ * @param id - Form fill ID
+ * @returns FormFill | null - The form fill or null if not found
+ */
+export declare function getFormFill(db: Database.Database, id: string): FormFill | null;
+/**
+ * List form fills with optional filtering
+ *
+ * @param db - Database connection
+ * @param options - Optional filter options (status, limit, offset)
+ * @returns FormFill[] - Array of form fills
+ */
+export declare function listFormFills(db: Database.Database, options?: {
+    status?: string;
+    limit?: number;
+    offset?: number;
+}): FormFill[];
+/**
+ * Search form fills by field values using LIKE matching on field_data_json
+ *
+ * @param db - Database connection
+ * @param query - Search query string
+ * @param options - Optional filter options (limit, offset)
+ * @returns FormFill[] - Matching form fills
+ */
+export declare function searchFormFills(db: Database.Database, query: string, options?: {
+    limit?: number;
+    offset?: number;
+}): FormFill[];
+/**
+ * Delete a form fill record
+ *
+ * @param db - Database connection
+ * @param id - Form fill ID
+ * @returns boolean - true if a record was deleted
+ */
+export declare function deleteFormFill(db: Database.Database, id: string): boolean;
+//# sourceMappingURL=form-fill-operations.d.ts.map

package/dist/services/storage/database/form-fill-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-fill-operations.d.ts","sourceRoot":"","sources":["../../../../src/services/storage/database/form-fill-operations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAIxD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,QAAQ,EAClB,oBAAoB,EAAE,MAAM,IAAI,GAC/B,MAAM,CAmCR;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAI9E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D,QAAQ,EAAE,CAyBZ;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,QAAQ,EAAE,CAeZ;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAEzE"}

package/dist/services/storage/database/form-fill-operations.js

@@ -0,0 +1,116 @@
+/**
+ * Form fill operations for DatabaseService
+ *
+ * Handles all CRUD operations for form fill results
+ * from the Datalab /fill API.
+ */
+import { runWithForeignKeyCheck } from './helpers.js';
+import { escapeLikePattern } from '../../../utils/validation.js';
+/**
+ * Insert a form fill record
+ *
+ * @param db - Database connection
+ * @param formFill - Form fill data
+ * @param updateMetadataCounts - Callback to update metadata counts
+ * @returns string - The form fill ID
+ */
+export function insertFormFill(db, formFill, updateMetadataCounts) {
+    const stmt = db.prepare(`
+    INSERT INTO form_fills (
+      id, source_file_path, source_file_hash, field_data_json, context,
+      confidence_threshold, output_file_path, output_base64, fields_filled,
+      fields_not_found, page_count, cost_cents, status, error_message,
+      provenance_id, created_at
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `);
+    runWithForeignKeyCheck(stmt, [
+        formFill.id,
+        formFill.source_file_path,
+        formFill.source_file_hash,
+        formFill.field_data_json,
+        formFill.context,
+        formFill.confidence_threshold,
+        formFill.output_file_path,
+        formFill.output_base64,
+        formFill.fields_filled,
+        formFill.fields_not_found,
+        formFill.page_count,
+        formFill.cost_cents,
+        formFill.status,
+        formFill.error_message,
+        formFill.provenance_id,
+        formFill.created_at,
+    ], `inserting form fill: FK violation for provenance_id="${formFill.provenance_id}"`);
+    updateMetadataCounts();
+    return formFill.id;
+}
+/**
+ * Get a form fill by ID
+ *
+ * @param db - Database connection
+ * @param id - Form fill ID
+ * @returns FormFill | null - The form fill or null if not found
+ */
+export function getFormFill(db, id) {
+    return (db.prepare('SELECT * FROM form_fills WHERE id = ?').get(id) ?? null);
+}
+/**
+ * List form fills with optional filtering
+ *
+ * @param db - Database connection
+ * @param options - Optional filter options (status, limit, offset)
+ * @returns FormFill[] - Array of form fills
+ */
+export function listFormFills(db, options) {
+    let query = 'SELECT * FROM form_fills';
+    const params = [];
+    if (options?.status) {
+        query += ' WHERE status = ?';
+        params.push(options.status);
+    }
+    query += ' ORDER BY created_at DESC';
+    if (options?.limit !== undefined) {
+        query += ' LIMIT ?';
+        params.push(options.limit);
+    }
+    if (options?.offset !== undefined) {
+        if (options?.limit === undefined) {
+            query += ' LIMIT 10000'; // bounded default
+        }
+        query += ' OFFSET ?';
+        params.push(options.offset);
+    }
+    return db.prepare(query).all(...params);
+}
+/**
+ * Search form fills by field values using LIKE matching on field_data_json
+ *
+ * @param db - Database connection
+ * @param query - Search query string
+ * @param options - Optional filter options (limit, offset)
+ * @returns FormFill[] - Matching form fills
+ */
+export function searchFormFills(db, query, options) {
+    const limit = options?.limit ?? 50;
+    const offset = options?.offset ?? 0;
+    const escaped = escapeLikePattern(query);
+    return db
+        .prepare(`
+    SELECT * FROM form_fills
+    WHERE field_data_json LIKE ? ESCAPE '\\' OR fields_filled LIKE ? ESCAPE '\\' OR source_file_path LIKE ? ESCAPE '\\'
+    ORDER BY created_at DESC
+    LIMIT ? OFFSET ?
+  `)
+        .all(`%${escaped}%`, `%${escaped}%`, `%${escaped}%`, limit, offset);
+}
+/**
+ * Delete a form fill record
+ *
+ * @param db - Database connection
+ * @param id - Form fill ID
+ * @returns boolean - true if a record was deleted
+ */
+export function deleteFormFill(db, id) {
+    return db.prepare('DELETE FROM form_fills WHERE id = ?').run(id).changes > 0;
+}
+//# sourceMappingURL=form-fill-operations.js.map

package/dist/services/storage/database/form-fill-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-fill-operations.js","sourceRoot":"","sources":["../../../../src/services/storage/database/form-fill-operations.ts"],"names":[],"mappings":"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"}

package/dist/services/storage/database/helpers.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Helper functions for DatabaseService
+ *
+ * Contains utility functions for validation, path resolution,
+ * and foreign key error handling.
+ */
+import Database from 'better-sqlite3';
+/**
+ * Default storage path for databases
+ */
+export declare const DEFAULT_STORAGE_PATH: string;
+/**
+ * Validate database name format
+ */
+export declare function validateName(name: string): void;
+/**
+ * Get full database path
+ */
+export declare function getDatabasePath(name: string, storagePath?: string): string;
+/**
+ * Helper function to run a statement with foreign key error handling.
+ * Converts SQLite FK constraint errors to DatabaseError with proper code.
+ *
+ * @param stmt - Prepared statement to run
+ * @param params - Parameters to bind
+ * @param context - Error context message (e.g., "inserting document: provenance_id does not exist")
+ */
+export declare function runWithForeignKeyCheck(stmt: Database.Statement, params: unknown[], context: string): Database.RunResult;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/services/storage/database/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/services/storage/database/helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAKtC;;GAEG;AACH,eAAO,MAAM,oBAAoB,QAA+F,CAAC;AAOjI;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAa/C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAG1E;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,QAAQ,CAAC,SAAS,EACxB,MAAM,EAAE,OAAO,EAAE,EACjB,OAAO,EAAE,MAAM,GACd,QAAQ,CAAC,SAAS,CAapB"}

package/dist/services/storage/database/helpers.js

@@ -0,0 +1,55 @@
+/**
+ * Helper functions for DatabaseService
+ *
+ * Contains utility functions for validation, path resolution,
+ * and foreign key error handling.
+ */
+import { homedir } from 'os';
+import { join } from 'path';
+import { DatabaseError, DatabaseErrorCode } from './types.js';
+/**
+ * Default storage path for databases
+ */
+export const DEFAULT_STORAGE_PATH = process.env.OCR_PROVENANCE_DATABASES_PATH ?? join(homedir(), '.ocr-provenance', 'databases');
+/**
+ * Valid database name pattern: alphanumeric, underscores, hyphens
+ */
+const VALID_NAME_PATTERN = /^[a-zA-Z0-9_-]+$/;
+/**
+ * Validate database name format
+ */
+export function validateName(name) {
+    if (!name || typeof name !== 'string') {
+        throw new DatabaseError('Database name is required and must be a string', DatabaseErrorCode.INVALID_NAME);
+    }
+    if (!VALID_NAME_PATTERN.test(name)) {
+        throw new DatabaseError(`Invalid database name "${name}". Only alphanumeric characters, underscores, and hyphens are allowed.`, DatabaseErrorCode.INVALID_NAME);
+    }
+}
+/**
+ * Get full database path
+ */
+export function getDatabasePath(name, storagePath) {
+    const basePath = storagePath ?? DEFAULT_STORAGE_PATH;
+    return join(basePath, `${name}.db`);
+}
+/**
+ * Helper function to run a statement with foreign key error handling.
+ * Converts SQLite FK constraint errors to DatabaseError with proper code.
+ *
+ * @param stmt - Prepared statement to run
+ * @param params - Parameters to bind
+ * @param context - Error context message (e.g., "inserting document: provenance_id does not exist")
+ */
+export function runWithForeignKeyCheck(stmt, params, context) {
+    try {
+        return stmt.run(...params);
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('FOREIGN KEY constraint failed')) {
+            throw new DatabaseError(`Foreign key violation ${context}`, DatabaseErrorCode.FOREIGN_KEY_VIOLATION, error);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=helpers.js.map

package/dist/services/storage/database/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../../src/services/storage/database/helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE9D;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,iBAAiB,EAAE,WAAW,CAAC,CAAC;AAEjI;;GAEG;AACH,MAAM,kBAAkB,GAAG,kBAAkB,CAAC;AAE9C;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,aAAa,CACrB,gDAAgD,EAChD,iBAAiB,CAAC,YAAY,CAC/B,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,aAAa,CACrB,0BAA0B,IAAI,wEAAwE,EACtG,iBAAiB,CAAC,YAAY,CAC/B,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,WAAoB;IAChE,MAAM,QAAQ,GAAG,WAAW,IAAI,oBAAoB,CAAC;IACrD,OAAO,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAwB,EACxB,MAAiB,EACjB,OAAe;IAEf,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,+BAA+B,CAAC,EAAE,CAAC;YACtF,MAAM,IAAI,aAAa,CACrB,yBAAyB,OAAO,EAAE,EAClC,iBAAiB,CAAC,qBAAqB,EACvC,KAAK,CACN,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/services/storage/database/image-operations.d.ts

@@ -0,0 +1,202 @@
+/**
+ * Image operations for DatabaseService
+ *
+ * Handles all CRUD operations for extracted images including
+ * insert, get, list, update VLM results, and delete.
+ */
+import Database from 'better-sqlite3';
+import { ImageReference, CreateImageReference, VLMResult, ImageStats } from '../../../models/image.js';
+import { ListImagesOptions } from './types.js';
+/**
+ * Insert a new image reference
+ *
+ * @param db - Database connection
+ * @param image - Image data (id and timestamps will be generated)
+ * @returns ImageReference - The created image with generated fields
+ */
+export declare function insertImage(db: Database.Database, image: CreateImageReference): ImageReference;
+/**
+ * Insert multiple images in a batch
+ *
+ * @param db - Database connection
+ * @param images - Array of image data to insert
+ * @returns ImageReference[] - Array of created images
+ */
+export declare function insertImageBatch(db: Database.Database, images: CreateImageReference[]): ImageReference[];
+/**
+ * Get an image by ID
+ *
+ * @param db - Database connection
+ * @param id - Image ID
+ * @returns ImageReference | null - The image or null if not found
+ */
+export declare function getImage(db: Database.Database, id: string): ImageReference | null;
+/**
+ * Get images for a document with optional filtering
+ *
+ * @param db - Database connection
+ * @param documentId - Document ID
+ * @param options - Optional filters: vlmStatus, limit
+ * @returns ImageReference[] - Array of images ordered by page and index
+ */
+export declare function getImagesByDocument(db: Database.Database, documentId: string, options?: {
+    vlmStatus?: string;
+    limit?: number;
+}): ImageReference[];
+/**
+ * Get all images for an OCR result
+ *
+ * @param db - Database connection
+ * @param ocrResultId - OCR result ID
+ * @returns ImageReference[] - Array of images ordered by page and index
+ */
+export declare function getImagesByOCRResult(db: Database.Database, ocrResultId: string): ImageReference[];
+/**
+ * Get pending images for VLM processing
+ *
+ * @param db - Database connection
+ * @param limit - Maximum number of images to return
+ * @returns ImageReference[] - Array of pending images ordered by creation time
+ */
+export declare function getPendingImages(db: Database.Database, limit?: number): ImageReference[];
+/**
+ * List images with optional filtering
+ *
+ * @param db - Database connection
+ * @param options - Optional filter options
+ * @returns ImageReference[] - Array of images
+ */
+export declare function listImages(db: Database.Database, options?: ListImagesOptions): ImageReference[];
+/**
+ * Update image VLM status to processing
+ *
+ * @param db - Database connection
+ * @param id - Image ID
+ */
+export declare function setImageProcessing(db: Database.Database, id: string): boolean;
+/**
+ * Update image with VLM results
+ *
+ * @param db - Database connection
+ * @param id - Image ID
+ * @param result - VLM processing result
+ */
+export declare function updateImageVLMResult(db: Database.Database, id: string, result: VLMResult): void;
+/**
+ * Mark image as complete but intentionally skipped by relevance filtering.
+ * Sets vlm_status='complete' with vlm_description='[SKIPPED]' so the image
+ * is not reprocessed by retry_failed, and does not inflate failure counts.
+ *
+ * @param db - Database connection
+ * @param id - Image ID
+ * @param skipReason - Reason the image was skipped (stored in error_message for diagnostics)
+ */
+export declare function setImageVLMSkipped(db: Database.Database, id: string, skipReason: string): void;
+/**
+ * Mark image VLM processing as failed
+ *
+ * @param db - Database connection
+ * @param id - Image ID
+ * @param errorMessage - Error message
+ */
+export declare function setImageVLMFailed(db: Database.Database, id: string, errorMessage: string): void;
+/**
+ * Update image context text
+ *
+ * @param db - Database connection
+ * @param id - Image ID
+ * @param contextText - Surrounding text from document
+ */
+export declare function updateImageContext(db: Database.Database, id: string, contextText: string): void;
+/**
+ * Update image provenance_id
+ *
+ * @param db - Database connection
+ * @param id - Image ID
+ * @param provenanceId - Provenance record ID to set
+ */
+export declare function updateImageProvenance(db: Database.Database, id: string, provenanceId: string): void;
+/**
+ * Get image statistics
+ *
+ * @param db - Database connection
+ * @returns ImageStats - Statistics about images in database
+ */
+export declare function getImageStats(db: Database.Database): ImageStats;
+/**
+ * Delete an image by ID
+ *
+ * @param db - Database connection
+ * @param id - Image ID
+ * @returns boolean - True if image was deleted
+ */
+export declare function deleteImage(db: Database.Database, id: string): boolean;
+/**
+ * Delete an image and all its derived data (embeddings, vectors, provenance).
+ * Performs a full cascade deletion to prevent orphaned records.
+ *
+ * @param db - Database connection
+ * @param imageId - Image ID to delete
+ */
+export declare function deleteImageCascade(db: Database.Database, imageId: string): void;
+/**
+ * Delete all images for a document and all their derived data (embeddings, vectors, provenance).
+ * Performs a full cascade deletion to prevent orphaned records.
+ *
+ * @param db - Database connection
+ * @param documentId - Document ID
+ * @returns number - Number of images deleted
+ */
+export declare function deleteImagesByDocumentCascade(db: Database.Database, documentId: string): number;
+/**
+ * Delete all images for a document
+ *
+ * @param db - Database connection
+ * @param documentId - Document ID
+ * @returns number - Number of images deleted
+ */
+export declare function deleteImagesByDocument(db: Database.Database, documentId: string): number;
+/**
+ * Count images by document
+ *
+ * @param db - Database connection
+ * @param documentId - Document ID
+ * @returns number - Number of images for this document
+ */
+export declare function countImagesByDocument(db: Database.Database, documentId: string): number;
+/**
+ * Reset VLM status to pending for failed images
+ *
+ * @param db - Database connection
+ * @param documentId - Optional document ID to filter
+ * @returns number - Number of images reset
+ */
+export declare function resetFailedImages(db: Database.Database, documentId?: string): number;
+/**
+ * Reset VLM status to pending for images stuck in 'processing' state
+ *
+ * @param db - Database connection
+ * @param documentId - Optional document ID to filter
+ * @returns number - Number of images reset
+ */
+export declare function resetProcessingImages(db: Database.Database, documentId?: string): number;
+/**
+ * Find a VLM-complete image with the same content hash (for deduplication).
+ * Returns the first matching image or null.
+ *
+ * @param db - Database connection
+ * @param contentHash - SHA-256 hash to search for
+ * @param excludeId - Optional image ID to exclude from results
+ * @returns ImageReference | null
+ */
+export declare function findByContentHash(db: Database.Database, contentHash: string, excludeId?: string): ImageReference | null;
+/**
+ * Copy VLM results from one image to another (deduplication).
+ * Sets vlm_status='complete', vlm_tokens_used=0 (no API call made).
+ *
+ * @param db - Database connection
+ * @param targetId - Image ID to copy results TO
+ * @param source - Source image to copy results FROM
+ */
+export declare function copyVLMResult(db: Database.Database, targetId: string, source: ImageReference): void;
+//# sourceMappingURL=image-operations.d.ts.map

package/dist/services/storage/database/image-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-operations.d.ts","sourceRoot":"","sources":["../../../../src/services/storage/database/image-operations.ts"],"names":[],"mappings":"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"}