extractia-sdk 1.0.6 → 1.1.0

package/README.md

@@ -1,9 +1,33 @@
 # Extractia SDK
 
-A JavaScript SDK for interacting with the Extractia API.
+JavaScript SDK for the [Extractia](https://extractia.info) document-extraction API.
+Works in Node.js ≥ 18 and modern browsers via the provided UMD build.
 
-> **Note:** This SDK is designed for the implementation of the [extractia.info](https://extractia.info) public API.  
-> You must have an Extractia account and a valid API token to use it.
+> **Requires** an Extractia account and a valid API token.  
+> Generate one at **Settings → API Keys** in the Extractia dashboard.
+
+---
+
+## Table of Contents
+
+1. [Installation](#installation)
+2. [Quick Start](#quick-start)
+3. [Authentication](#authentication)
+4. [Error Handling](#error-handling)
+5. [API Reference](#api-reference)
+   - [Profile & Webhook](#profile--webhook)
+   - [Templates](#templates)
+   - [Documents](#documents)
+   - [Processing Images](#processing-images)
+   - [AI Features](#ai-features)
+   - [Exports](#exports)
+   - [OCR Tools](#ocr-tools)
+   - [Credits & Analytics](#credits--analytics)
+6. [TypeScript](#typescript)
+7. [Rate Limits & Quotas](#rate-limits--quotas)
+8. [Changelog](#changelog)
+
+---
 
 ## Installation
 
@@ -11,58 +35,784 @@ A JavaScript SDK for interacting with the Extractia API.
 npm install extractia-sdk
 ```
 
-## Usage
+Or using yarn / pnpm:
+
+```sh
+yarn add extractia-sdk
+pnpm add extractia-sdk
+```
+
+**Browser (IIFE build):**
+
+```html
+<script src="https://unpkg.com/extractia-sdk/dist/extractia-sdk.browser.js"></script>
+<script>
+  ExtractiaSDK.default.setToken("YOUR_API_TOKEN");
+</script>
+```
+
+---
+
+## Quick Start
 
 ```js
-import { setToken, getMyProfile, getTemplates, processImage } from 'extractia-sdk';
+import { setToken, suggestFields, createTemplate, processImage } from "extractia-sdk";
 
-// Set your API token
-setToken('YOUR_API_TOKEN');
+// 1. Authenticate
+setToken("ext_YOUR_API_TOKEN_HERE");
 
-// Get user profile
-const profile = await getMyProfile();
+// 2. Let AI suggest fields for your document type
+const fields = await suggestFields("Invoice", "header data plus all line items with product and quantity");
 
-// Get all templates
-const templates = await getTemplates();
+// 3. Create a template from the suggestions
+const template = await createTemplate({ label: "Invoice", fields });
+
+// 4. Process an image
+import { readFileSync } from "fs";
+const base64 = readFileSync("./invoice.png").toString("base64");
+const doc = await processImage(template.id, base64);
+
+console.log(JSON.parse(doc.rawJson));
+// → { "Vendor": "Acme Corp", "Total": "1500.00", "Line Items": [...] }
+```
+
+---
 
-// Process an image with a template
-const result = await processImage(templateId, base64Image);
+## Authentication
+
+Every SDK method requires a valid API token. Call `setToken` **once** at
+application startup — it is stored in module scope and attached automatically as
+a `Bearer` header on every subsequent request.
+
+```js
+import { setToken } from "extractia-sdk";
+
+setToken(process.env.EXTRACTIA_TOKEN);
+```
+
+> **Security**: Never hard-code your token in client-side code. Use environment
+> variables or a secrets manager. Tokens can be rotated from the dashboard at any
+> time.
+
+---
+
+## Error Handling
+
+The SDK maps every HTTP error to a typed exception. Catch the specific subclass
+you need, or catch the base `ExtractiaError` for a generic fallback.
+
+```js
+import {
+  processImage,
+  AuthError,
+  TierError,
+  RateLimitError,
+  NotFoundError,
+  ExtractiaError,
+} from "extractia-sdk";
+
+try {
+  const doc = await processImage(templateId, base64Image);
+} catch (err) {
+  if (err instanceof AuthError) {
+    // 401 — token is missing, expired, or revoked
+    console.error("Authentication failed:", err.message);
+  } else if (err instanceof TierError) {
+    // 402/403 — monthly quota exhausted or plan doesn't allow this action
+    console.error("Upgrade your plan:", err.message);
+  } else if (err instanceof RateLimitError) {
+    // 429 — too many requests in a short window
+    console.warn("Rate limited. Retrying in 60s...");
+    await new Promise((r) => setTimeout(r, 60_000));
+  } else if (err instanceof NotFoundError) {
+    // 404 — template or document does not exist
+    console.error("Not found:", err.message);
+  } else if (err instanceof ExtractiaError) {
+    // Fallback for any other API error
+    console.error(`API error [${err.status}]:`, err.message);
+  } else {
+    throw err; // Re-throw network / unexpected errors
+  }
+}
 ```
 
+### Error class hierarchy
+
+| Class            | HTTP status | When thrown                                       |
+| ---------------- | ----------- | ------------------------------------------------- |
+| `ExtractiaError` | any         | Base class; fallback for unexpected codes         |
+| `AuthError`      | 401         | Missing, expired, or revoked token                |
+| `ForbiddenError` | 403         | Unconfirmed account or sub-user permission denied |
+| `TierError`      | 402 / 403   | Monthly document quota exhausted                  |
+| `RateLimitError` | 429         | Too many requests in time window                  |
+| `NotFoundError`  | 404         | Template or document not found                    |
+
+---
+
 ## API Reference
 
-### Authentication
+### Profile & Webhook
+
+#### `setToken(token)`
+
+Sets the Bearer token used for all requests. Must be called before any other method.
+
+| Parameter | Type     | Required | Description                        |
+| --------- | -------- | -------- | ---------------------------------- |
+| `token`   | `string` | ✅       | Your Extractia API token (`ext_…`) |
 
-- `setToken(token)` – Set the API token for requests.
-- `getMyProfile()` – Get the authenticated user's profile.
-- `updateWebhook(url)` – Update the webhook URL for the user.
+```js
+setToken("ext_abc123");
+```
+
+---
+
+#### `getMyProfile()`
+
+Returns the profile and usage metrics of the authenticated user.
+
+**Returns:** `Promise<AppUserProfile>`
+
+```js
+const profile = await getMyProfile();
+console.log(profile.email);             // 'user@example.com'
+console.log(profile.formTemplatesCount); // 5
+console.log(profile.documentsCount);    // 42
+```
+
+---
+
+#### `updateWebhook(url)`
+
+Updates the webhook URL. After each successful extraction, Extractia
+sends a `POST` to this URL with the document payload.
+
+| Parameter | Type     | Required | Description                                  |
+| --------- | -------- | -------- | -------------------------------------------- |
+| `url`     | `string` | ✅       | Webhook URL (pass empty string `""` to remove) |
+
+**Returns:** `Promise<void>`
+
+```js
+await updateWebhook("https://myapp.example.com/hooks/extractia");
+await updateWebhook(""); // remove webhook
+```
+
+**Webhook POST payload:**
+
+```json
+{
+  "documentId": "abc123",
+  "templateId": "tpl456",
+  "rawJson": "{ \"Total\": \"150.00\" }",
+  "createdAt": "2025-01-05T10:30:00Z"
+}
+```
+
+---
 
 ### Templates
 
-- `getTemplates()` – Retrieve all templates.
-- `getTemplateById(id)` – Get a template by its ID.
-- `getTemplateByName(name)` – Get a template by its name.
-- `createTemplate(template)` – Create a new template.
-- `updateTemplate(id, template)` – Update an existing template.
-- `deleteTemplate(id)` – Delete a template.
-- `deleteAllTemplateDocuments(id)` – Delete all documents for a template.
+A **template** defines the fields to extract from a document.
+
+**Supported field types:** `TEXT` | `NUMBER` | `PERCENTAGE` | `DATE` | `BOOLEAN` | `EMAIL` | `PHONE` | `ADDRESS` | `CURRENCY` | `LIST`
+
+---
+
+#### `getTemplates()`
+
+Returns all templates owned by the authenticated user.
+
+```js
+const templates = await getTemplates();
+templates.forEach((t) => console.log(t.id, t.label));
+```
+
+---
+
+#### `getTemplateById(id)`
+
+Returns a single template by its ID. Throws `NotFoundError` if missing.
+
+```js
+const template = await getTemplateById("tpl_abc123");
+```
+
+---
+
+#### `getTemplateByName(name)`
+
+Returns a template matched by its label name. Throws `NotFoundError` if missing.
+
+```js
+const invoice = await getTemplateByName("Invoice");
+```
+
+---
+
+#### `suggestFields(templateName, extractionContext?)`
+
+Uses AI to suggest extraction field definitions for a given document type.
+Results can be passed directly to `createTemplate`.
+
+**Consumes AI credits.**
+
+| Parameter           | Type     | Required | Description                                                        |
+| ------------------- | -------- | -------- | ------------------------------------------------------------------ |
+| `templateName`      | `string` | ✅       | Document type name (e.g. `"Invoice"`, `"Driver's License"`)        |
+| `extractionContext` | `string` | —        | Natural-language hint about what to extract or detect              |
+
+```js
+// Basic usage
+const fields = await suggestFields("Receipt");
+
+// With context — AI will only return what you describe
+const fields = await suggestFields(
+  "Purchase Order",
+  "I need the supplier name, PO number, and all ordered products with quantity and unit price"
+);
+
+const template = await createTemplate({ label: "Purchase Order", fields });
+```
+
+The returned array follows the `FormField` shape:
+```json
+[
+  { "label": "PO Number",   "type": "TEXT",     "required": true },
+  { "label": "Supplier",    "type": "TEXT",     "required": true },
+  { "label": "Order Items", "type": "LIST",     "required": false, "listLabel": "Product" }
+]
+```
+
+---
+
+#### `createTemplate(template)`
+
+Creates a new template.
+
+```js
+const template = await createTemplate({
+  label: "Purchase Order",
+  fields: [
+    { label: "PO Number",    type: "TEXT",     required: true },
+    { label: "Vendor",       type: "TEXT",     required: true },
+    { label: "Total Amount", type: "CURRENCY", required: true },
+    { label: "Order Date",   type: "DATE",     required: false },
+    { label: "Line Items",   type: "LIST",     required: false, listLabel: "Product" },
+  ],
+});
+console.log(template.id); // 'tpl_newid'
+```
+
+---
+
+#### `updateTemplate(id, template)`
+
+Updates an existing template's label and/or fields.
+
+```js
+const updated = await updateTemplate("tpl_abc123", {
+  fields: [
+    { label: "Vendor",     type: "TEXT",     required: true },
+    { label: "Total",      type: "CURRENCY", required: true },
+    { label: "Due Date",   type: "DATE",     required: false },
+  ],
+});
+```
+
+---
+
+#### `deleteTemplate(id)`
+
+Deletes a template. Returns a `409 Conflict` error if the template has
+associated documents — call `deleteAllTemplateDocuments` first.
+
+```js
+await deleteAllTemplateDocuments("tpl_abc123");
+await deleteTemplate("tpl_abc123");
+```
+
+---
+
+#### `deleteAllTemplateDocuments(id)`
+
+Deletes all documents associated with a template in one call.
+
+```js
+await deleteAllTemplateDocuments("tpl_abc123");
+```
+
+---
 
 ### Documents
 
-- `getDocumentsByTemplateId(templateId, options)` – Get documents for a template.
-  - `options`:  
-    ```js
-    {
-      preconformed?: boolean,
-      index?: number,        // Paging index (each page contains 10 documents)
-      sort?: number,         // 1 for ascending, -1 for descending
-      includeImage?: boolean
-    }
-    ```
-- `deleteDocument(documentId)` – Delete a document.
-- `processImage(templateId, base64Image)` – Process a single image.
-- `processImagesMultipage(templateId, base64ImagesArray)` – Process multiple images (multipage).
+#### `getDocumentsByTemplateId(templateId, options?)`
+
+Returns a paginated list of documents for a given template (newest first by default).
+
+| Option         | Type      | Default | Description                                       |
+| -------------- | --------- | ------- | ------------------------------------------------- |
+| `preconformed` | `boolean` | —       | Filter: reviewed (`true`) or unreviewed (`false`) |
+| `index`        | `number`  | `0`     | Zero-based page index (10 docs per page)          |
+| `sort`         | `string`  | `"-1"`  | Sort direction: `"1"` = ASC, `"-1"` = DESC        |
+| `includeImage` | `boolean` | `false` | Include base64 source image in results            |
+
+```js
+const page = await getDocumentsByTemplateId("tpl_abc123", {
+  preconformed: false,  // only unreviewed
+  index: 0,
+});
+
+console.log(`Page 1 of ${page.totalPages}`);
+for (const doc of page.content) {
+  const fields = JSON.parse(doc.rawJson);
+  console.log("Total:", fields["Total Amount"]);
+}
+```
+
+---
+
+#### `getDocumentById(templateId, docId, options?)`
+
+Returns a single document by template and document ID.
+
+| Option         | Type      | Default | Description                        |
+| -------------- | --------- | ------- | ---------------------------------- |
+| `includeImage` | `boolean` | `false` | Include the base64 source image    |
+
+```js
+const doc = await getDocumentById("tpl_abc123", "doc_xyz789", { includeImage: true });
+console.log(doc.imageBase64); // the original scan
+```
+
+---
+
+#### `getRecentDocuments(size?)`
+
+Returns the N most-recent documents across **all templates**. Useful for dashboard feeds.
+
+```js
+const recent = await getRecentDocuments(5);
+recent.forEach(doc => console.log(doc.createdAt, doc.formTemplateId));
+```
+
+---
+
+#### `deleteDocument(documentId)`
+
+Permanently deletes a single document.
+
+```js
+await deleteDocument("doc_xyz789");
+```
+
+---
+
+#### `updateDocumentStatus(docId, status)`
+
+Updates the workflow status of a document. You define the status values — common
+choices are `"PENDING"`, `"REVIEWED"`, `"APPROVED"`, `"REJECTED"`.
+
+```js
+await updateDocumentStatus("doc_xyz789", "APPROVED");
+```
+
+---
+
+#### `updateDocumentNotes(docId, notes)`
+
+Saves reviewer annotations on a document. Pass `""` to clear.
+
+```js
+await updateDocumentNotes("doc_xyz789", "Verified against original: amounts match.");
+await updateDocumentNotes("doc_xyz789", ""); // clear notes
+```
+
+---
+
+#### `updateDocumentData(docId, data, options?)`
+
+Corrects or overwrites the extracted field data programmatically. Optionally
+marks the document as preconformed (reviewed) in the same call.
+
+| Option          | Type      | Default | Description                              |
+| --------------- | --------- | ------- | ---------------------------------------- |
+| `preconformed`  | `boolean` | `false` | Mark document as reviewed/confirmed      |
+
+```js
+// Fix a wrong extraction and confirm
+await updateDocumentData(
+  "doc_xyz789",
+  { "Total Amount": 1250.00, "Invoice Number": "INV-1042" },
+  { preconformed: true }
+);
+```
+
+---
+
+#### `bulkPreconform(ids)`
+
+Marks multiple documents as reviewed/confirmed in a single API call. Returns
+the count of documents actually updated.
+
+```js
+const { updated } = await bulkPreconform(["doc_1", "doc_2", "doc_3"]);
+console.log(`${updated} documents confirmed`);
+```
+
+---
+
+### Processing Images
+
+#### `processImage(templateId, base64Image)`
+
+Processes a **single image** — ideal for one-page documents.
+
+Max image size: **5 MB** decoded. Supported formats: PNG, JPEG, WEBP, BMP.
+
+```js
+// Node.js
+import { readFileSync } from "fs";
+const base64 = readFileSync("./invoice.jpg").toString("base64");
+const doc = await processImage("tpl_invoice_id", base64);
+const fields = JSON.parse(doc.rawJson);
+console.log("Vendor:", fields["Vendor"]);
+console.log("Total:", fields["Total Amount"]);
+```
+
+```js
+// Browser — convert a File input to base64
+function fileToBase64(file) {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onload = () => resolve(reader.result.split(",")[1]);
+    reader.onerror = reject;
+    reader.readAsDataURL(file);
+  });
+}
+
+const file = document.querySelector("#fileInput").files[0];
+const base64 = await fileToBase64(file);
+const doc = await processImage(templateId, base64);
+```
+
+---
+
+#### `processImagesMultipage(templateId, base64ImagesArray)`
+
+Processes **multiple images** as a single multi-page document. All pages are
+merged into one result. Use this for PDFs split into images or multi-page scans.
+
+```js
+import { readdirSync, readFileSync } from "fs";
+import path from "path";
+
+const pages = readdirSync("./scan-pages")
+  .sort()
+  .map((f) => readFileSync(path.join("./scan-pages", f)).toString("base64"));
+
+const doc = await processImagesMultipage("tpl_contract_id", pages);
+const result = JSON.parse(doc.rawJson);
+console.log("Contract Date:", result["Contract Date"]);
+```
+
+---
+
+### AI Features
+
+#### `generateDocumentSummary(docId)`
+
+Asks the AI to generate a concise bullet-point summary of a document's
+extracted data. Returns natural language — not JSON.
+
+**Consumes AI credits.**
+
+```js
+const { summary } = await generateDocumentSummary("doc_xyz789");
+console.log(summary);
+// • Invoice #1042 was issued by Acme Corp on January 5 2025.
+// • The total amount due is $1,250.00, payable by February 4 2025.
+// • The order includes 3 line items for a total of 15 units.
+```
+
+---
+
+### Exports
+
+Export all documents in a template to a file format for offline processing,
+spreadsheet import, or archiving.
+
+#### `exportDocumentsCsv(templateId, options?)`
+
+Returns all extracted data as a UTF-8 CSV string with BOM (Excel-compatible).
+Each row is one document; columns are the extracted fields plus `preconformed`
+and `uploadedAt`.
+
+| Option    | Type       | Description                                       |
+| --------- | ---------- | ------------------------------------------------- |
+| `fields`  | `string[]` | Optional column subset. Dot-notation for nested.  |
+
+```js
+// Export everything
+const csv = await exportDocumentsCsv("tpl_abc123");
+fs.writeFileSync("invoices.csv", csv);
+
+// Export a specific column subset
+const csv = await exportDocumentsCsv("tpl_abc123", {
+  fields: ["Invoice Number", "Vendor", "Total Amount", "Issue Date"],
+});
+```
+
+---
+
+#### `exportDocumentsJson(templateId)`
+
+Returns all documents as a plain JSON array. Each element is the extracted
+field map plus three metadata keys:
+
+- `_id` — document ID  
+- `_preconformed` — whether the document was reviewed  
+- `_uploadedAt` — ISO timestamp
+
+```js
+const records = await exportDocumentsJson("tpl_abc123");
+records.forEach(doc => {
+  console.log(doc._id, doc["Invoice Number"], doc["Total Amount"]);
+});
+
+// Save to file
+import { writeFileSync } from "fs";
+writeFileSync("invoices.json", JSON.stringify(records, null, 2));
+```
+
+---
+
+### OCR Tools
+
+OCR Tools let you ask AI yes/no questions, classify documents into labels, or
+extract free-form text from any image — without a template.
+
+#### `getOcrTools()`
+
+Returns all OCR tool configurations owned by the authenticated user.
+
+```js
+const tools = await getOcrTools();
+tools.forEach(t => console.log(t.id, t.name, t.outputType));
+```
+
+---
+
+#### `createOcrTool(config)`
+
+Creates a new OCR tool configuration.
+
+| Field        | Type                           | Required | Description                                        |
+| ------------ | ------------------------------ | -------- | -------------------------------------------------- |
+| `name`       | `string`                       | ✅       | Human-friendly display name                        |
+| `prompt`     | `string`                       | ✅       | Natural-language instruction for the AI            |
+| `outputType` | `"YES_NO" \| "LABEL" \| "TEXT"` | ✅       | Expected output shape                              |
+| `labels`     | `string[]`                     | ⚠️      | Required when `outputType === "LABEL"`             |
+
+```js
+// YES/NO check
+const checker = await createOcrTool({
+  name: "Proof of Residence Check",
+  prompt: "Does this document appear to be a valid proof of residence? Look for an address, official stamp, and the person's name.",
+  outputType: "YES_NO",
+});
+
+// Document classifier
+const classifier = await createOcrTool({
+  name: "Document Type Classifier",
+  prompt: "What type of document is this?",
+  outputType: "LABEL",
+  labels: ["invoice", "id_card", "receipt", "proof_of_residence", "contract", "other"],
+});
+
+// Free-form extraction
+const extractor = await createOcrTool({
+  name: "Serial Number Extractor",
+  prompt: "Extract the serial number or product code printed on the label. Return only the code, nothing else.",
+  outputType: "TEXT",
+});
+```
+
+---
+
+#### `updateOcrTool(id, config)`
+
+Updates an existing OCR tool configuration.
+
+```js
+await updateOcrTool("tool_abc", {
+  prompt: "Does this document show a current address dated within the last 3 months?",
+});
+```
+
+---
+
+#### `deleteOcrTool(id)`
+
+Deletes an OCR tool configuration.
+
+```js
+await deleteOcrTool("tool_abc");
+```
+
+---
+
+#### `runOcrTool(id, base64Image)`
+
+Runs an OCR tool against a base64-encoded image. Max image size: **5 MB**.
+
+**Consumes AI credits.**
+
+```js
+import { readFileSync } from "fs";
+const image = readFileSync("./id-card.jpg").toString("base64");
+
+const result = await runOcrTool("tool_residence_check", image);
+console.log(result.answer);      // "YES"
+console.log(result.explanation); // "The document shows a full address, an official municipal stamp, and the applicant's name."
+
+// Document classification
+const type = await runOcrTool("tool_classifier", image);
+console.log(type.answer); // "id_card"
+
+// Full workflow: classify first, then extract
+const { answer: docType } = await runOcrTool("tool_classifier", invoiceBase64);
+if (docType === "invoice") {
+  const doc = await processImage(invoiceTemplateId, invoiceBase64);
+}
+```
+
+---
+
+### Credits & Analytics
+
+#### `getCreditsBalance()`
+
+Returns the current AI-credit balance for the authenticated user.
+
+```js
+const balance = await getCreditsBalance();
+console.log(`Monthly credits: ${balance.monthlyBalance}`);
+console.log(`Add-on credits:  ${balance.addonBalance}`);
+console.log(`Total available: ${balance.totalBalance}`);
+```
+
+---
+
+#### `getCreditsHistory(options?)`
+
+Returns a paginated history of AI credit consumption events (newest first).
+
+| Option  | Type     | Default | Description               |
+| ------- | -------- | ------- | ------------------------- |
+| `page`  | `number` | `0`     | Zero-based page index     |
+| `size`  | `number` | `20`    | Page size (max 100)       |
+
+```js
+const history = await getCreditsHistory({ page: 0, size: 10 });
+history.content.forEach(entry => {
+  console.log(entry.timestamp, entry.operation, entry.creditsConsumed);
+});
+```
+
+---
+
+## TypeScript
+
+The SDK ships with a full `index.d.ts` declaration file — no `@types` package needed.
+
+```ts
+import {
+  setToken,
+  processImage,
+  runOcrTool,
+  suggestFields,
+  exportDocumentsJson,
+  UserDocument,
+  OcrRunResult,
+  FormField,
+  TierError,
+  RateLimitError,
+} from "extractia-sdk";
+
+setToken(process.env.EXTRACTIA_TOKEN!);
+
+async function classifyAndExtract(
+  templateId: string,
+  ocrToolId: string,
+  imagePath: string,
+): Promise<UserDocument | null> {
+  const { readFileSync } = await import("fs");
+  const base64 = readFileSync(imagePath).toString("base64");
+
+  // Classify first
+  const check: OcrRunResult = await runOcrTool(ocrToolId, base64);
+  if (check.answer !== "YES") {
+    console.log("Document rejected:", check.explanation);
+    return null;
+  }
+
+  // Extract with template
+  return processImage(templateId, base64);
+}
+```
+
+---
+
+## Rate Limits & Quotas
+
+| Limit              | Value                                                |
+| ------------------ | ---------------------------------------------------- |
+| Max image size     | 5 MB decoded                                         |
+| Processing timeout | 60 seconds                                           |
+| Monthly documents  | Depends on plan (Free / Pro / Business / Enterprise) |
+| Active API keys    | 10 per account                                       |
+
+When the monthly quota is exhausted, processing calls throw a `TierError`.
+Purchase extra document packs or upgrade your plan from the dashboard to continue.
+
+---
+
+## Changelog
+
+### v1.1.0
+
+- **New:** `suggestFields(templateName, context?)` — AI-powered field suggestions
+- **New:** `getDocumentById(templateId, docId)` — fetch a single document
+- **New:** `getRecentDocuments(size?)` — latest documents across all templates
+- **New:** `generateDocumentSummary(docId)` — AI bullet-point summary of a document
+- **New:** `updateDocumentStatus(docId, status)` — set workflow status
+- **New:** `updateDocumentNotes(docId, notes)` — save reviewer annotations
+- **New:** `updateDocumentData(docId, data, opts?)` — correct extracted data
+- **New:** `bulkPreconform(ids)` — confirm multiple documents in one call
+- **New:** `exportDocumentsCsv(templateId, opts?)` — export to CSV
+- **New:** `exportDocumentsJson(templateId)` — export to JSON array
+- **New:** `getOcrTools()` / `createOcrTool()` / `updateOcrTool()` / `deleteOcrTool()` / `runOcrTool(id, image)` — full OCR Tools API
+- **New:** `getCreditsBalance()` / `getCreditsHistory(opts?)` — AI credits tracking
+- Extended `FieldType` with `BOOLEAN`, `EMAIL`, `PHONE`, `ADDRESS`, `CURRENCY`
+- Full TypeScript declarations updated for all new methods
+
+### v1.0.6
+
+- Added `processImagesMultipage` for multi-page document support
+- Added typed error classes (`AuthError`, `TierError`, `RateLimitError`, `NotFoundError`, `ForbiddenError`)
+- Added TypeScript declaration file (`index.d.ts`)
+- Added `deleteAllTemplateDocuments` helper
+- Added browser IIFE build
+
+### v1.0.0
+
+- Initial release: `setToken`, `getMyProfile`, `updateWebhook`, `getTemplates`,
+  `createTemplate`, `updateTemplate`, `deleteTemplate`, `getDocumentsByTemplateId`,
+  `deleteDocument`, `processImage`
+
+---
 
 ## License
 
-ISC
+MIT