receipt-ocr 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cosplit.now
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,223 @@
+# ReceiptOCR
+
+一个可复用的 TypeScript 库，用于借助多模态大语言模型从购物小票图片中提取结构化商品数据。
+
+## 特性
+
+- 🚀 **函数式 API**：无状态、异步、可组合
+- 🎯 **类型安全**：完整的 TypeScript 类型定义
+- 🔌 **依赖注入**：验证逻辑由调用方提供
+- 📦 **双模块支持**：同时支持 ESM 和 CommonJS
+- 🤖 **Gemini 驱动**：使用 Google Gemini 多模态模型
+
+## 安装
+
+```bash
+npm install receipt-ocr
+# 或
+pnpm add receipt-ocr
+```
+
+## 环境配置
+
+在使用前，需要设置环境变量：
+
+```bash
+# 必需
+export GEMINI_API_KEY=your-gemini-api-key
+
+# 可选（默认：gemini-2.0-flash）
+export GEMINI_MODEL=gemini-2.0-flash
+```
+
+## 基础用法
+
+```typescript
+import { extractReceiptItems } from 'receipt-ocr';
+import fs from 'fs';
+
+// 从文件读取图片
+const imageBuffer = fs.readFileSync('receipt.jpg');
+
+// 提取商品信息
+const items = await extractReceiptItems(imageBuffer);
+
+console.log(items);
+// [
+//   {
+//     name: "有机牛奶 1L",
+//     price: 12.5,
+//     quantity: 1,
+//     hasTax: false
+//   },
+//   {
+//     name: "可口可乐瓶装",
+//     price: 3.5,
+//     quantity: 2,
+//     hasTax: true,
+//     taxAmount: 0.35,
+//     deposit: 0.5,      // 押金已自动合并
+//     discount: -0.5     // 折扣已自动合并
+//   },
+//   ...
+// ]
+```
+
+## 商品数据结构
+
+每个商品包含以下字段：
+
+```typescript
+interface ReceiptItem {
+  name: string;                  // 商品名称
+  price: number;                 // 单价
+  quantity: number;              // 数量（默认 1）
+  hasTax: boolean;               // 是否含税
+  taxAmount?: number;            // 税额（可选）
+  deposit?: number;              // 押金（可选，自动合并）
+  discount?: number;             // 折扣（可选，自动合并）
+}
+```
+
+### 附加费用自动合并
+
+库会自动识别并合并押金（Deposit）和折扣（TPD）到对应的商品中，而不是作为独立的商品项返回：
+
+- **押金（deposit）**：如 "Deposit VL"，会被合并到对应的瓶装商品中
+- **折扣（discount）**：如 "TPD"，会被合并到对应的商品中（通常为负数）
+
+这意味着您不需要手动处理这些附加费用，它们会自动关联到正确的商品上。
+
+## 高级用法
+
+### 1. 自动验证（推荐）
+
+使用 Google Search grounding 自动批量验证不确定的商品名称：
+
+```typescript
+import { extractReceiptItems } from 'receipt-ocr';
+
+const items = await extractReceiptItems(imageBuffer, {
+  autoVerify: true, // 启用自动验证
+});
+
+// 库会自动验证并补全模糊的商品名称
+// 如果验证失败，会保持原始名称
+```
+
+**优势**：
+- ✅ 批量处理，只需 1 次额外 API 调用
+- ✅ 使用 Google Search，覆盖面广
+- ✅ 自动处理，无需额外代码
+- ✅ 验证失败时自动保持原始数据
+
+详细文档：[自动验证功能](./docs/AUTO_VERIFICATION.md)
+
+### 2. 自定义验证回调
+
+当需要连接特定产品库时，可以使用自定义验证回调：
+
+```typescript
+import { extractReceiptItems } from 'receipt-ocr';
+
+const items = await extractReceiptItems(imageBuffer, {
+  verifyCallback: async (name, context) => {
+    // 调用外部搜索服务验证/补全商品名称
+    const result = await myProductDatabase.search(name);
+    
+    if (result) {
+      return { verifiedName: result.fullName };
+    }
+    
+    // 返回 null 保持原样
+    return null;
+  }
+});
+```
+
+### 3. 组合使用
+
+两种验证方式可以同时使用：
+
+```typescript
+const items = await extractReceiptItems(imageBuffer, {
+  autoVerify: true,           // 先用 Google Search 批量验证
+  verifyCallback: async (name, context) => {
+    // 如果自动验证失败，再用自定义逻辑
+    const result = await myProductDatabase.search(name);
+    return result ? { verifiedName: result.name } : null;
+  },
+});
+```
+
+验证回调接口：
+
+```typescript
+type VerificationCallback = (
+  name: string,
+  context: {
+    rawText: string;           // OCR 原始文本
+    allItems: ReceiptItem[];   // 所有已解析商品
+  }
+) => Promise<{ verifiedName: string } | null>;
+```
+
+## 图片输入格式
+
+支持以下三种格式：
+
+```typescript
+// 1. Buffer
+const buffer = fs.readFileSync('receipt.jpg');
+await extractReceiptItems(buffer);
+
+// 2. Base64 字符串
+const base64 = 'iVBORw0KGgoAAAANSUhEUgAA...';
+await extractReceiptItems(base64);
+
+// 3. 图片 URL
+const url = 'https://example.com/receipt.jpg';
+await extractReceiptItems(url);
+```
+
+## 策略接口（供扩展）
+
+库预留了完整的策略接口，方便未来扩展：
+
+```typescript
+import { VerificationStrategy } from 'receipt-ocr';
+
+const myStrategy: VerificationStrategy = {
+  verify: async (name, context) => {
+    const verified = await searchProductDB(name);
+    return { verifiedName: verified };
+  }
+};
+```
+
+## 开发
+
+```bash
+# 安装依赖
+npm install
+
+# 类型检查
+npm run type-check
+
+# 构建
+npm run build
+
+# 开发模式（监听变化）
+npm run dev
+```
+
+## 设计原则
+
+1. **无状态**：每次调用独立，无副作用
+2. **确定性**：不猜测不确定的数据，通过验证机制确保准确性
+3. **可组合性**：验证逻辑通过依赖注入提供
+4. **正确性优先**：内部处理不确定性，对外只返回可靠数据
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,393 @@
+'use strict';
+
+var generativeAi = require('@google/generative-ai');
+
+// src/adapters/gemini.ts
+
+// src/processors/image.ts
+function isUrl(input) {
+  return input.startsWith("http://") || input.startsWith("https://");
+}
+function isBase64(input) {
+  if (input.startsWith("data:")) {
+    return true;
+  }
+  return input.length > 100 && /^[A-Za-z0-9+/=]+$/.test(input);
+}
+function parseDataUri(dataUri) {
+  const match = dataUri.match(/^data:([^;,]+);base64,(.+)$/);
+  if (match) {
+    return {
+      mimeType: match[1],
+      data: match[2]
+    };
+  }
+  return {
+    mimeType: "image/jpeg",
+    data: dataUri
+  };
+}
+function getMimeTypeFromUrl(url) {
+  const lower = url.toLowerCase();
+  if (lower.includes(".png")) return "image/png";
+  if (lower.includes(".jpg") || lower.includes(".jpeg")) return "image/jpeg";
+  if (lower.includes(".webp")) return "image/webp";
+  if (lower.includes(".gif")) return "image/gif";
+  return "image/jpeg";
+}
+function processImage(image) {
+  if (Buffer.isBuffer(image)) {
+    return {
+      mimeType: "image/jpeg",
+      // 默认，实际中可能需要更精确的检测
+      data: image.toString("base64")
+    };
+  }
+  if (typeof image === "string") {
+    if (isUrl(image)) {
+      return {
+        mimeType: getMimeTypeFromUrl(image),
+        url: image
+      };
+    }
+    if (image.startsWith("data:")) {
+      const { mimeType, data } = parseDataUri(image);
+      return { mimeType, data };
+    }
+    if (isBase64(image)) {
+      return {
+        mimeType: "image/jpeg",
+        data: image
+      };
+    }
+    throw new Error("Unsupported image format: string is not a valid URL or base64");
+  }
+  throw new Error("Unsupported image input type");
+}
+
+// src/adapters/gemini.ts
+function getGeminiConfig() {
+  const apiKey = process.env.GEMINI_API_KEY;
+  if (!apiKey) {
+    throw new Error(
+      "GEMINI_API_KEY environment variable is not set. Please set it to use the Gemini adapter."
+    );
+  }
+  const model = process.env.GEMINI_MODEL || "gemini-2.0-flash";
+  return { apiKey, model };
+}
+async function callGemini(image, prompt, useGrounding) {
+  const { apiKey, model } = getGeminiConfig();
+  const genAI = new generativeAi.GoogleGenerativeAI(apiKey);
+  const geminiModel = genAI.getGenerativeModel({ model });
+  const processedImage = processImage(image);
+  const contents = [];
+  if (processedImage.url) {
+    contents.push({
+      fileData: {
+        mimeType: processedImage.mimeType,
+        fileUri: processedImage.url
+      }
+    });
+  } else if (processedImage.data) {
+    contents.push({
+      inlineData: {
+        mimeType: processedImage.mimeType,
+        data: processedImage.data
+      }
+    });
+  }
+  contents.push({
+    text: prompt
+  });
+  try {
+    const requestParams = {
+      contents: [{ role: "user", parts: contents }]
+    };
+    if (useGrounding) ;
+    const result = await geminiModel.generateContent(requestParams);
+    const response = result.response;
+    const text = response.text();
+    if (!text) {
+      throw new Error("Gemini API returned empty response");
+    }
+    return text;
+  } catch (error) {
+    if (error instanceof Error) {
+      throw new Error(`Gemini API call failed: ${error.message}`);
+    }
+    throw new Error("Gemini API call failed with unknown error");
+  }
+}
+function getGeminiConfig2() {
+  const apiKey = process.env.GEMINI_API_KEY;
+  if (!apiKey) {
+    throw new Error(
+      "GEMINI_API_KEY environment variable is not set. Please set it to use the Gemini adapter."
+    );
+  }
+  const model = process.env.GEMINI_MODEL || "gemini-2.0-flash";
+  return { apiKey, model };
+}
+function buildVerificationPrompt(items) {
+  const itemList = items.map((item, index) => `${index + 1}. "${item.name}"`).join("\n");
+  return `\u8FD9\u662F\u4ECE Costco \u8D85\u5E02\u5C0F\u7968\u4E2D\u8BC6\u522B\u51FA\u7684\u5546\u54C1\u540D\u79F0\uFF0C\u90E8\u5206\u540D\u79F0\u53EF\u80FD\u4E0D\u5B8C\u6574\u6216\u6709\u7F29\u5199\u3002
+\u8BF7\u4F7F\u7528 Google Search \u67E5\u627E\u5E76\u8865\u5168\u8FD9\u4E9B\u5546\u54C1\u7684\u5B8C\u6574\u6B63\u786E\u540D\u79F0\u3002
+
+\u9700\u8981\u9A8C\u8BC1\u7684\u5546\u54C1\uFF1A
+${itemList}
+
+\u9A8C\u8BC1\u65B9\u6CD5\u5EFA\u8BAE\uFF1A
+- \u5728\u641C\u7D22\u5F15\u64CE\u4E2D\u8F93\u5165\uFF1A\u5546\u54C1\u539F\u540D + "Costco"\uFF08\u4F8B\u5982\uFF1A"CEMOI 6X Costco"\uFF09
+- \u8FD9\u6837\u80FD\u66F4\u51C6\u786E\u5730\u627E\u5230 Costco \u9500\u552E\u7684\u5BF9\u5E94\u5546\u54C1
+- \u6CE8\u610F\u786E\u8BA4\u5546\u54C1\u7684\u5305\u88C5\u89C4\u683C\uFF08\u5982\u6570\u91CF\u3001\u5BB9\u91CF\u7B49\uFF09
+
+\u8BF7\u8FD4\u56DE JSON \u6570\u7EC4\u683C\u5F0F\uFF0C\u6BCF\u4E2A\u5546\u54C1\u5305\u542B\uFF1A
+- index: \u5E8F\u53F7\uFF081-based\uFF09
+- originalName: \u539F\u59CB\u540D\u79F0
+- verifiedName: \u9A8C\u8BC1\u540E\u7684\u5B8C\u6574\u540D\u79F0\uFF08\u5982\u679C\u627E\u5230\uFF09
+- found: \u662F\u5426\u627E\u5230\u5339\u914D\uFF08\u5E03\u5C14\u503C\uFF09
+
+\u793A\u4F8B\u8F93\u51FA\uFF1A
+[
+  {"index": 1, "originalName": "ORG MLK", "verifiedName": "Kirkland Signature Organic 2% Milk 1L", "found": true},
+  {"index": 2, "originalName": "CEM\u039F\u0399 6\u03A7", "verifiedName": "CEMOI 82% Dark Chocolate Bars, 6 \xD7 100 g", "found": true}
+]
+
+\u53EA\u8FD4\u56DE JSON \u6570\u7EC4\uFF0C\u4E0D\u8981\u5176\u4ED6\u6587\u5B57\u3002`;
+}
+function parseVerificationResponse(responseText) {
+  try {
+    let cleaned = responseText.trim();
+    const codeBlockMatch = cleaned.match(/```(?:json)?\s*([\s\S]*?)```/);
+    if (codeBlockMatch) {
+      cleaned = codeBlockMatch[1].trim();
+    }
+    const parsed = JSON.parse(cleaned);
+    if (!Array.isArray(parsed)) {
+      throw new Error("Response is not an array");
+    }
+    return parsed;
+  } catch (error) {
+    console.error("Failed to parse verification response:", error);
+    return [];
+  }
+}
+async function batchVerifyItems(items) {
+  if (items.length === 0) {
+    return /* @__PURE__ */ new Map();
+  }
+  const { apiKey, model } = getGeminiConfig2();
+  const genAI = new generativeAi.GoogleGenerativeAI(apiKey);
+  const geminiModel = genAI.getGenerativeModel({ model });
+  const prompt = buildVerificationPrompt(items);
+  try {
+    const result = await geminiModel.generateContent({
+      contents: [{ role: "user", parts: [{ text: prompt }] }],
+      tools: [{ googleSearch: {} }]
+    });
+    const response = result.response;
+    const text = response.text();
+    if (!text) {
+      console.warn("Verification returned empty response");
+      return /* @__PURE__ */ new Map();
+    }
+    const verificationResults = parseVerificationResponse(text);
+    const resultMap = /* @__PURE__ */ new Map();
+    verificationResults.forEach((result2) => {
+      if (result2.found && result2.verifiedName) {
+        resultMap.set(result2.originalName, result2.verifiedName);
+      }
+    });
+    return resultMap;
+  } catch (error) {
+    console.error("Batch verification failed:", error);
+    return /* @__PURE__ */ new Map();
+  }
+}
+
+// src/utils/prompt.ts
+var EXTRACTION_PROMPT = `\u5206\u6790\u8FD9\u5F20\u8D2D\u7269\u5C0F\u7968\u56FE\u7247\uFF0C\u63D0\u53D6\u6240\u6709\u5546\u54C1\u4FE1\u606F\u3002
+
+\u8F93\u51FA\u683C\u5F0F\u4E3A JSON \u6570\u7EC4\uFF0C\u6BCF\u4E2A\u5546\u54C1\u5305\u542B\uFF1A
+- name: \u5546\u54C1\u540D\u79F0\uFF08\u5B57\u7B26\u4E32\uFF09
+- price: \u5355\u4EF7\uFF08\u6570\u5B57\uFF09
+- quantity: \u6570\u91CF\uFF08\u6570\u5B57\uFF0C\u9ED8\u8BA4 1\uFF09
+- needsVerification: \u662F\u5426\u9700\u8981\u9A8C\u8BC1\uFF08\u5E03\u5C14\u503C\uFF09
+- hasTax: \u662F\u5426\u542B\u7A0E\uFF08\u5E03\u5C14\u503C\uFF09
+- taxAmount: \u7A0E\u989D\uFF08\u6570\u5B57\uFF0C\u53EF\u9009\uFF09
+
+\u5173\u4E8E needsVerification \u7684\u5224\u65AD\u89C4\u5219\uFF1A
+- \u5982\u679C\u5546\u54C1\u540D\u79F0\u662F\u7F29\u5199\u3001\u4E0D\u5B8C\u6574\u3001\u88AB\u622A\u65AD\u6216\u5B58\u5728\u6B67\u4E49\uFF0C\u8BBE\u4E3A true
+- \u5982\u679C\u5546\u54C1\u540D\u79F0\u6E05\u6670\u5B8C\u6574\uFF0C\u8BBE\u4E3A false
+- \u4E0D\u8981\u731C\u6D4B\u4E0D\u786E\u5B9A\u7684\u540D\u79F0\uFF0C\u800C\u662F\u4FDD\u7559\u539F\u6837\u5E76\u8BBE needsVerification \u4E3A true
+
+**\u91CD\u8981\uFF1A\u9644\u52A0\u8D39\u7528\u5904\u7406\u89C4\u5219**
+\u5BF9\u4E8E\u62BC\u91D1\uFF08Deposit\u3001deposit\u3001\u62BC\u91D1\u7B49\uFF09\u548C\u6298\u6263\uFF08TPD\u3001discount\u3001\u6298\u6263\u7B49\uFF09\u8FD9\u7C7B\u9644\u52A0\u8D39\u7528\uFF1A
+- \u6DFB\u52A0\u989D\u5916\u5B57\u6BB5 isAttachment: true
+- \u6DFB\u52A0 attachmentType: "deposit" \u6216 "discount"
+- **\u91CD\u8981**\uFF1A\u5C06\u9644\u52A0\u8D39\u7528\u7D27\u8DDF\u5728\u5B83\u6240\u5C5E\u7684\u5546\u54C1\u540E\u9762\u6392\u5217
+- \u7CFB\u7EDF\u4F1A\u81EA\u52A8\u5C06\u9644\u52A0\u8D39\u7528\u5408\u5E76\u5230\u5B83\u524D\u9762\u7684\u5546\u54C1\u4E2D
+- \u8FD9\u4E9B\u9644\u52A0\u8D39\u7528\u4E0D\u4F1A\u4F5C\u4E3A\u72EC\u7ACB\u5546\u54C1\u8FD4\u56DE
+
+\u5F52\u5C5E\u89C4\u5219\uFF08\u6309\u7167\u8FD9\u4E2A\u987A\u5E8F\u6392\u5217\uFF09\uFF1A
+- \u5546\u54C1A
+- \u5546\u54C1A\u7684\u62BC\u91D1\uFF08\u5982\u679C\u6709\uFF09
+- \u5546\u54C1A\u7684\u6298\u6263\uFF08\u5982\u679C\u6709\uFF09
+- \u5546\u54C1B
+- \u5546\u54C1B\u7684\u62BC\u91D1\uFF08\u5982\u679C\u6709\uFF09
+- ...
+
+\u53EA\u8FD4\u56DE JSON \u6570\u7EC4\uFF0C\u4E0D\u8981\u5176\u4ED6\u6587\u5B57\u3002
+
+\u793A\u4F8B\u8F93\u51FA\uFF1A
+[
+  {"name": "\u6709\u673A\u725B\u5976 1L", "price": 12.5, "quantity": 1, "needsVerification": false, "hasTax": false},
+  {"name": "\u53EF\u53E3\u53EF\u4E50\u74F6\u88C5", "price": 3.5, "quantity": 2, "needsVerification": false, "hasTax": true, "taxAmount": 0.35},
+  {"name": "Deposit VL", "price": 0.5, "quantity": 2, "needsVerification": false, "hasTax": false, "isAttachment": true, "attachmentType": "deposit"},
+  {"name": "TPD", "price": -0.5, "quantity": 1, "needsVerification": false, "hasTax": false, "isAttachment": true, "attachmentType": "discount"},
+  {"name": "ORG BRD", "price": 8.0, "quantity": 1, "needsVerification": true, "hasTax": true, "taxAmount": 0.8}
+]`;
+
+// src/processors/parser.ts
+function extractJson(text) {
+  let cleaned = text.trim();
+  const codeBlockMatch = cleaned.match(/```(?:json)?\s*([\s\S]*?)```/);
+  if (codeBlockMatch) {
+    cleaned = codeBlockMatch[1].trim();
+  }
+  return cleaned;
+}
+function normalizeRawItem(raw) {
+  if (!raw || typeof raw !== "object") {
+    throw new Error("Invalid item: not an object");
+  }
+  if (typeof raw.name !== "string" || !raw.name) {
+    throw new Error("Invalid item: missing or invalid name field");
+  }
+  if (typeof raw.price !== "number" || raw.price < 0) {
+    throw new Error("Invalid item: missing or invalid price field");
+  }
+  return {
+    name: raw.name,
+    price: raw.price,
+    quantity: typeof raw.quantity === "number" ? raw.quantity : 1,
+    needsVerification: Boolean(raw.needsVerification),
+    hasTax: Boolean(raw.hasTax),
+    taxAmount: typeof raw.taxAmount === "number" ? raw.taxAmount : void 0,
+    deposit: typeof raw.deposit === "number" ? raw.deposit : void 0,
+    discount: typeof raw.discount === "number" ? raw.discount : void 0,
+    // 保留附加费用标记用于后续处理
+    isAttachment: raw.isAttachment === true ? true : void 0,
+    attachmentType: raw.attachmentType,
+    attachedTo: typeof raw.attachedTo === "number" ? raw.attachedTo : void 0
+  };
+}
+function mergeAttachments(items) {
+  const result = [];
+  let currentItem = null;
+  for (let i = 0; i < items.length; i++) {
+    const item = items[i];
+    if (!item.isAttachment) {
+      if (currentItem) {
+        result.push(currentItem);
+      }
+      currentItem = { ...item };
+    } else {
+      if (currentItem) {
+        if (item.attachmentType === "deposit") {
+          currentItem.deposit = (currentItem.deposit || 0) + item.price * item.quantity;
+        } else if (item.attachmentType === "discount") {
+          currentItem.discount = (currentItem.discount || 0) + item.price;
+        }
+      }
+    }
+  }
+  if (currentItem) {
+    result.push(currentItem);
+  }
+  return result.map((item) => {
+    const { isAttachment, attachmentType, attachedTo, ...cleanItem } = item;
+    return cleanItem;
+  });
+}
+function parseResponse(responseText) {
+  try {
+    const jsonText = extractJson(responseText);
+    const parsed = JSON.parse(jsonText);
+    if (!Array.isArray(parsed)) {
+      throw new Error("Response is not an array");
+    }
+    const items = parsed.map((raw, index) => {
+      try {
+        return normalizeRawItem(raw);
+      } catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        throw new Error(`Invalid item at index ${index}: ${message}`);
+      }
+    });
+    const mergedItems = mergeAttachments(items);
+    return mergedItems;
+  } catch (error) {
+    if (error instanceof Error) {
+      throw new Error(`Failed to parse LLM response: ${error.message}
+
+Response:
+${responseText}`);
+    }
+    throw new Error(`Failed to parse LLM response with unknown error
+
+Response:
+${responseText}`);
+  }
+}
+
+// src/extract.ts
+async function extractReceiptItems(image, options) {
+  const responseText = await callGemini(image, EXTRACTION_PROMPT);
+  const parsedItems = parseResponse(responseText);
+  const itemsNeedingVerification = parsedItems.filter((item) => item.needsVerification);
+  if (options?.autoVerify && itemsNeedingVerification.length > 0) {
+    try {
+      const verificationMap = await batchVerifyItems(itemsNeedingVerification);
+      for (const item of parsedItems) {
+        if (item.needsVerification) {
+          const verifiedName = verificationMap.get(item.name);
+          if (verifiedName) {
+            item.name = verifiedName;
+            item.needsVerification = false;
+          }
+        }
+      }
+    } catch (error) {
+      console.error("Auto verification failed:", error);
+    }
+  }
+  if (options?.verifyCallback) {
+    const publicItems = parsedItems.map(({ needsVerification, ...item }) => item);
+    const verificationContext = {
+      rawText: responseText,
+      allItems: publicItems
+    };
+    for (const item of parsedItems) {
+      if (item.needsVerification) {
+        try {
+          const result = await options.verifyCallback(item.name, verificationContext);
+          if (result && result.verifiedName) {
+            item.name = result.verifiedName;
+            item.needsVerification = false;
+          }
+        } catch (error) {
+          console.error(`Verification failed for item "${item.name}":`, error);
+        }
+      }
+    }
+  }
+  const finalItems = parsedItems.map(({ needsVerification, ...item }) => item);
+  return finalItems;
+}
+
+exports.batchVerifyItems = batchVerifyItems;
+exports.extractReceiptItems = extractReceiptItems;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map