@arkyc/ocr 2.0.0 → 2.1.0

package/dist/checks.d.mts

@@ -1,15 +1,14 @@
 import { OcrFields } from "@arkyc/types";
-
 //#region src/checks.d.ts
 /** A deterministic inconsistency found on a document. */
-type DocumentIssueCode = 'mrz_check_digit' | 'mrz_visual_mismatch' | 'issue_after_expiry' | 'birth_after_issue' | 'birth_in_future' | 'implausible_age';
-interface DocumentIssue {
+export type DocumentIssueCode = 'mrz_check_digit' | 'mrz_visual_mismatch' | 'issue_after_expiry' | 'birth_after_issue' | 'birth_in_future' | 'implausible_age';
+export interface DocumentIssue {
   code: DocumentIssueCode;
   /** The fields involved. */
   fields: string[];
 }
 /** The parts of an OCR result the checks read. */
-interface DocumentCheckInput {
+export interface DocumentCheckInput {
   fields: OcrFields;
   /** The driver's raw payload; MRZ check results and visual-zone fields live here. */
   raw?: unknown;
@@ -19,7 +18,7 @@ interface DocumentCheckInput {
  * Deterministic document checks: MRZ check digits, MRZ against the visual zone,
  * and dates that cannot happen.
  */
-declare class DocumentChecks {
+export declare class DocumentChecks {
   /**
    * Every issue found on the document. An empty list means nothing was provably wrong.
    *
@@ -39,7 +38,6 @@ declare class DocumentChecks {
  * @param on
  * @returns
  */
-declare function ageOn(dateOfBirth: string, on?: Date): number | null;
+export declare function ageOn(dateOfBirth: string, on?: Date): number | null;
 //#endregion
-export { DocumentCheckInput, DocumentChecks, DocumentIssue, DocumentIssueCode, ageOn };
 //# sourceMappingURL=checks.d.mts.map

package/dist/checks.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"checks.d.mts","names":[],"sources":["../src/checks.ts"],"mappings":";;;;KAGY,iBAAA;AAAA,UAQK,aAAA;EACf,IAAA,EAAM,iBAAiB;;EAEvB,MAAA;AAAA;AAHF;AAAA,UAOiB,kBAAA;EACf,MAAA,EAAQ,SAAA;EAPe;EASvB,GAAA;EACA,GAAA,GAAM,IAAI;AAAA;;AARJ;AAIR;;cAmBa,cAAA;EAfD;;;;;;EAAA,OAsBH,OAAA,CAAQ,KAAA,EAAO,kBAAA,GAAqB,aAAa;EAAA,eAIzC,GAAA;EAAA,eAwBA,KAAA;EAnCU;EAAA,eAyDV,SAAA;AAAA;;;;;;;;iBAqBD,KAAA,CAAM,WAAA,UAAqB,EAAA,GAAI,IAAiB"}
+{"version":3,"file":"checks.d.mts","names":[],"sources":["../src/checks.ts"],"mappings":";;;YAGY;iBAQK;EACf,MAAM;;EAEN;;;iBAIe;EACf,QAAQ;;EAER;EACA,MAAM;;;;;;qBAeK;;;;;;;SAOJ,QAAQ,OAAO,qBAAqB;iBAI5B;iBAwBA;;iBAsBA;;;;;;;;;wBAqBD,MAAM,qBAAqB,KAAI"}

package/dist/drivers/ai.d.mts

@@ -1,19 +1,18 @@
 import { OcrDriver, OcrRequest } from "../types.mjs";
 import { DocumentType, OcrAuthenticity, OcrFields, OcrResultData } from "@arkyc/types";
-
 //#region src/drivers/ai.d.ts
 /**
  * A small, cheap vision model is plenty for reading printed/MRZ document text.
  */
-declare const DEFAULT_AI_MODEL = "claude-haiku-4-5-20251001";
+export declare const DEFAULT_AI_MODEL = "claude-haiku-4-5-20251001";
 /**
  * Default Cloudflare Workers AI model: Gemma 4 accepts image input and tool calls.
  */
-declare const DEFAULT_WORKERS_AI_MODEL = "@cf/google/gemma-4-26b-a4b-it";
+export declare const DEFAULT_WORKERS_AI_MODEL = "@cf/google/gemma-4-26b-a4b-it";
 /**
  * Which hosted vision API backs the `ai` driver.
  */
-type AiOcrProvider = 'anthropic' | 'workers-ai';
+export type AiOcrProvider = 'anthropic' | 'workers-ai';
 /**
  * A base64 image ready for the messages API, with its detected media type.
  */
@@ -24,7 +23,7 @@ interface PreparedImage {
 /**
  * Raw fields the vision model returned, before validation/scoring.
  */
-interface AiExtraction {
+export interface AiExtraction {
   fields: OcrFields;
   /** The model's own legibility self-assessment in [0, 1], if it gave one. */
   legibility?: number;
@@ -37,8 +36,8 @@ interface AiExtraction {
  * driver's scoring can be unit-tested without a network call; the default
  * implementation talks to the Anthropic messages API.
  */
-type AiVisionExtract = (request: OcrRequest, images: PreparedImage[]) => Promise<AiExtraction>;
-interface AnthropicOcrOptions {
+export type AiVisionExtract = (request: OcrRequest, images: PreparedImage[]) => Promise<AiExtraction>;
+export interface AnthropicOcrOptions {
   /** Vision backend; defaults to `anthropic`. */
   provider?: AiOcrProvider;
   /** Anthropic API key, or the Cloudflare API token for `workers-ai`. */
@@ -79,7 +78,7 @@ interface AnthropicOcrOptions {
  * {@link applyAuthenticity}) so a suspicious document routes to manual review —
  * an LLM's authenticity guess never auto-rejects a user on its own.
  */
-declare class AnthropicOcrDriver implements OcrDriver {
+export declare class AnthropicOcrDriver implements OcrDriver {
   readonly name = "ai";
   private readonly provider;
   private readonly model;
@@ -105,7 +104,7 @@ declare class AnthropicOcrDriver implements OcrDriver {
  * @param legibility
  * @returns
  */
-declare function scoreConfidence(fields: OcrFields, legibility?: number): number;
+export declare function scoreConfidence(fields: OcrFields, legibility?: number): number;
 /**
  * Fold the authenticity read into the field-derived confidence. Only ever lowers
  * the score, and only when a concrete flag fired — a genuine (or unassessed)
@@ -118,14 +117,14 @@ declare function scoreConfidence(fields: OcrFields, legibility?: number): number
  * @param authenticity
  * @returns
  */
-declare function applyAuthenticity(fieldScore: number, authenticity?: OcrAuthenticity): number;
+export declare function applyAuthenticity(fieldScore: number, authenticity?: OcrAuthenticity): number;
 /**
  * Build the default vision call against the Anthropic messages API.
  *
  * @param input
  * @returns
  */
-declare function anthropicVision(opts: {
+export declare function anthropicVision(opts: {
   apiKey: string;
   model: string;
   baseUrl: string;
@@ -141,13 +140,14 @@ declare function anthropicVision(opts: {
  * @param opts
  * @returns
  */
-declare function workersAiVision(opts: {
+export declare function workersAiVision(opts: {
   apiKey: string;
-  model: string; /** OpenAI-compatible base ending in `/v1`. */
+  model: string;
+  /** OpenAI-compatible base ending in `/v1`. */
   baseUrl: string;
   timeoutMs?: number;
   maxRetries?: number;
 }): AiVisionExtract;
 //#endregion
-export { AiExtraction, AiOcrProvider, AiVisionExtract, AnthropicOcrDriver, AnthropicOcrOptions, DEFAULT_AI_MODEL, DEFAULT_WORKERS_AI_MODEL, anthropicVision, applyAuthenticity, scoreConfidence, workersAiVision };
+export {};
 //# sourceMappingURL=ai.d.mts.map

package/dist/drivers/ai.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ai.d.mts","names":[],"sources":["../../src/drivers/ai.ts"],"mappings":";;;;;;AAaA;cAAa,gBAAA;;;AAAgB;cAKhB,wBAAA;;;;KAKD,aAAA;AAAZ;;;AAAA,UAsBU,aAAA;EACR,SAAA;EACA,IAAI;AAAA;;;AAAA;UAMW,YAAA;EACf,MAAA,EAAQ,SAAA;;EAER,UAAA;EACA,YAAA,GAAe,YAAA;EAEA;EAAf,YAAA,GAAe,eAAA;AAAA;;;;;;KAQL,eAAA,IAAmB,OAAA,EAAS,UAAA,EAAY,MAAA,EAAQ,aAAA,OAAoB,OAAA,CAAQ,YAAA;AAAA,UAEvE,mBAAA;EAVe;EAY9B,QAAA,GAAW,aAAA;EAJD;EAMV,MAAA;;EAEA,SAAA;EAR0D;EAU1D,KAAA;EAV8E;;;;;EAgB9E,OAAA;EAhBkD;EAkBlD,OAAA;EAlBsF;EAoBtF,SAAA;EApBkG;EAsBlG,UAAA;EApBkC;EAsBlC,OAAA,GAAU,eAAe;AAAA;;;;;;;;;;;;;AAAA;AAoB3B;;;;cAAa,kBAAA,YAA8B,SAAA;EAAA,SAChC,IAAA;EAAA,iBAEQ,QAAA;EAAA,iBACA,KAAA;EAAA,iBACA,OAAA;EAAA,iBACA,MAAA;cAEL,OAAA,GAAS,mBAAA;EAoCf,OAAA,CAAQ,OAAA,EAAS,UAAA,GAAa,OAAA,CAAQ,aAAA;EAzC3B;;;;;;EAAA,QAqEH,aAAA;AAAA;;;;;;;AAAa;AAyC7B;;;iBAAgB,eAAA,CAAgB,MAAA,EAAQ,SAAS,EAAE,UAAA;;;;;AAAmB;AAiCtE;;;;;;;iBAAgB,iBAAA,CAAkB,UAAA,UAAoB,YAAA,GAAe,eAAe;AAAA;AAkKpF;;;;;AAlKoF,iBAkKpE,eAAA,CAAgB,IAAA;EAC9B,MAAA;EACA,KAAA;EACA,OAAA;EACA,SAAA;EACA,UAAA;AAAA,IACE,eAAe;AAAA;AA4FnB;;;;;;;;AA5FmB,iBA4FH,eAAA,CAAgB,IAAA;EAC9B,MAAA;EACA,KAAA,UAKiB;EAHjB,OAAA;EACA,SAAA;EACA,UAAA;AAAA,IACE,eAAe"}
+{"version":3,"file":"ai.d.mts","names":[],"sources":["../../src/drivers/ai.ts"],"mappings":";;;;;;qBAaa;;;;qBAKA;;;;YAKD;;;;UAsBF;EACR;EACA;;;;;iBAMe;EACf,QAAQ;;EAER;EACA,eAAe;;EAEf,eAAe;;;;;;;YAQL,mBAAmB,SAAS,YAAY,QAAQ,oBAAoB,QAAQ;iBAEvE;;EAEf,WAAW;;EAEX;;EAEA;;EAEA;;;;;;EAMA;;EAEA;;EAEA;;EAEA;;EAEA,UAAU;;;;;;;;;;;;;;;;;;;qBAoBC,8BAA8B;WAChC;mBAEQ;mBACA;mBACA;mBACA;EAEL,YAAA,UAAS;EAoCf,QAAQ,SAAS,aAAa,QAAQ;;;;;;;UA4B9B;;;;;;;;;;;;wBAyCA,gBAAgB,QAAQ,WAAW;;;;;;;;;;;;;wBAiCnC,kBAAkB,oBAAoB,eAAe;;;;;;;wBAkKrD,gBAAgB;EAC9B;EACA;EACA;EACA;EACA;IACE;;;;;;;;;;wBA4FY,gBAAgB;EAC9B;EACA;;EAEA;EACA;EACA;IACE"}

package/dist/drivers/ai.mjs

@@ -138,13 +138,15 @@ function normalizeFields(fields) {
 * @returns
 */
 function scoreConfidence(fields, legibility) {
-	return clamp01([
+	const base = [
 		[present(fields.firstName) && present(fields.lastName) || present(fields.fullName), .28],
 		[isIsoDate(fields.dateOfBirth), .22],
 		[present(fields.documentNumber) && fields.documentNumber.trim().length >= 4, .22],
 		[isIsoDate(fields.expiryDate), .16],
 		[present(fields.nationality), .12]
-	].reduce((sum, [ok, weight]) => ok ? sum + weight : sum, 0) * (.85 + .15 * clamp01(legibility ?? 1)));
+	].reduce((sum, [ok, weight]) => ok ? sum + weight : sum, 0);
+	const legible = clamp01(legibility ?? 1);
+	return clamp01(base * (.85 + .15 * legible));
 }
 /**
 * Hard ceiling on OCR confidence once any authenticity flag fires. Below the

package/dist/drivers/ai.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ai.mjs","names":[],"sources":["../../src/drivers/ai.ts"],"sourcesContent":["import type { DocumentType, OcrAuthenticity, OcrFields, OcrResultData } from '@arkyc/types'\nimport type { OcrDriver, OcrRequest } from '../types'\n\nconst clamp01 = (n: number): number => Math.min(1, Math.max(0, n))\n\n/**\n * Anthropic's default API base; override for a gateway/proxy.\n */\nconst DEFAULT_BASE_URL = 'https://api.anthropic.com'\n\n/**\n * A small, cheap vision model is plenty for reading printed/MRZ document text.\n */\nexport const DEFAULT_AI_MODEL = 'claude-haiku-4-5-20251001'\n\n/**\n * Default Cloudflare Workers AI model: Gemma 4 accepts image input and tool calls.\n */\nexport const DEFAULT_WORKERS_AI_MODEL = '@cf/google/gemma-4-26b-a4b-it'\n\n/**\n * Which hosted vision API backs the `ai` driver.\n */\nexport type AiOcrProvider = 'anthropic' | 'workers-ai'\n\n/**\n * Longest edge (px) we upload. The API downsamples anything larger anyway and\n * bills by the resampled size, so this is a cost/bandwidth bound, not a quality\n * one — small enough to be cheap, large enough to keep the MRZ legible.\n */\nconst DEFAULT_MAX_EDGE = 1568\n\n/**\n * Per-attempt request timeout (ms) — a hung connection must not stall a worker.\n */\nconst DEFAULT_TIMEOUT_MS = 30_000\n\n/**\n * Bounded in-driver retries on rate-limit/overload; the job queue retries beyond.\n */\nconst DEFAULT_MAX_RETRIES = 2\n\n/**\n * A base64 image ready for the messages API, with its detected media type.\n */\ninterface PreparedImage {\n  mediaType: 'image/jpeg' | 'image/png' | 'image/webp'\n  data: string\n}\n\n/**\n * Raw fields the vision model returned, before validation/scoring.\n */\nexport interface AiExtraction {\n  fields: OcrFields\n  /** The model's own legibility self-assessment in [0, 1], if it gave one. */\n  legibility?: number\n  documentType?: DocumentType | null\n  /** Best-effort tamper/replay read; omitted when the model reported nothing. */\n  authenticity?: OcrAuthenticity\n}\n\n/**\n * Calls a vision model and returns the raw extracted fields. Injected so the\n * driver's scoring can be unit-tested without a network call; the default\n * implementation talks to the Anthropic messages API.\n */\nexport type AiVisionExtract = (request: OcrRequest, images: PreparedImage[]) => Promise<AiExtraction>\n\nexport interface AnthropicOcrOptions {\n  /** Vision backend; defaults to `anthropic`. */\n  provider?: AiOcrProvider\n  /** Anthropic API key, or the Cloudflare API token for `workers-ai`. */\n  apiKey?: string\n  /** Cloudflare account id; required for `workers-ai` unless `baseUrl` is set. */\n  accountId?: string\n  /** Model id; defaults to {@link DEFAULT_AI_MODEL} or {@link DEFAULT_WORKERS_AI_MODEL}. */\n  model?: string\n  /**\n   * API base URL. Anthropic: defaults to {@link DEFAULT_BASE_URL}. Workers AI: the\n   * OpenAI-compatible base ending in `/v1` (e.g. an AI Gateway URL), defaulting to\n   * the account's `/ai/v1` endpoint.\n   */\n  baseUrl?: string\n  /** Longest image edge (px) to upload; defaults to {@link DEFAULT_MAX_EDGE}. */\n  maxEdge?: number\n  /** Per-attempt request timeout (ms); defaults to {@link DEFAULT_TIMEOUT_MS}. */\n  timeoutMs?: number\n  /** Bounded retries on 429/529; defaults to {@link DEFAULT_MAX_RETRIES}. */\n  maxRetries?: number\n  /** Override the vision call (tests). When set, `apiKey` is not required. */\n  extract?: AiVisionExtract\n}\n\n/**\n * AI OCR driver: hands the document image(s) to a vision LLM (Claude by default,\n * or a Cloudflare Workers AI model with `provider: 'workers-ai'`) and maps the structured response onto {@link OcrResultData}.\n *\n * Confidence is **not** taken from the model's self-report — LLMs are poorly\n * calibrated and will state high confidence on hallucinated fields. Instead it's\n * derived deterministically from which fields came back and whether they're\n * structurally valid (see {@link scoreConfidence}), so the value feeding the\n * decision engine's `ocrConfidenceThreshold` is meaningful. The model's own\n * legibility read is folded in only as a small soft penalty.\n *\n * It also asks the model for a best-effort, image-only authenticity read\n * (screen-replay, photocopy, digital/physical tampering). That signal is\n * advisory: a fired flag only *caps* the OCR confidence (see\n * {@link applyAuthenticity}) so a suspicious document routes to manual review —\n * an LLM's authenticity guess never auto-rejects a user on its own.\n */\nexport class AnthropicOcrDriver implements OcrDriver {\n  readonly name = 'ai'\n\n  private readonly provider: AiOcrProvider\n  private readonly model: string\n  private readonly maxEdge: number\n  private readonly vision: AiVisionExtract\n\n  constructor(options: AnthropicOcrOptions = {}) {\n    this.provider = options.provider ?? 'anthropic'\n    if (!options.apiKey && !options.extract) {\n      throw new Error('AnthropicOcrDriver requires config.apiKey')\n    }\n    this.model = options.model ?? (this.provider === 'workers-ai' ? DEFAULT_WORKERS_AI_MODEL : DEFAULT_AI_MODEL)\n    this.maxEdge = options.maxEdge ?? DEFAULT_MAX_EDGE\n\n    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS\n    const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES\n    if (options.extract) {\n      this.vision = options.extract\n    } else if (this.provider === 'workers-ai') {\n      if (!options.accountId && !options.baseUrl) {\n        throw new Error('AnthropicOcrDriver (workers-ai) requires config.accountId')\n      }\n      this.vision = workersAiVision({\n        apiKey: options.apiKey as string,\n        model: this.model,\n        baseUrl: (\n          options.baseUrl ?? `https://api.cloudflare.com/client/v4/accounts/${options.accountId}/ai/v1`\n        ).replace(/\\/$/, ''),\n        timeoutMs,\n        maxRetries,\n      })\n    } else {\n      this.vision = anthropicVision({\n        apiKey: options.apiKey as string,\n        model: this.model,\n        baseUrl: (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, ''),\n        timeoutMs,\n        maxRetries,\n      })\n    }\n  }\n\n  async extract(request: OcrRequest): Promise<OcrResultData> {\n    const images = await this.prepareImages(request)\n    const raw = await this.vision(request, images)\n    const fields = normalizeFields(raw.fields)\n    const authenticity = raw.authenticity\n    const confidence = applyAuthenticity(scoreConfidence(fields, raw.legibility), authenticity)\n\n    return {\n      fields,\n      confidence,\n      ...(authenticity ? { authenticity } : {}),\n      raw: {\n        provider: 'ai',\n        backend: this.provider,\n        model: this.model,\n        legibility: raw.legibility ?? null,\n        documentType: raw.documentType ?? request.documentType ?? null,\n        authenticity: authenticity ?? null,\n      },\n    }\n  }\n\n  /**\n   * Resize (best-effort) and base64-encode the front + optional back images.\n   *\n   * @param input\n   * @returns\n   */\n  private async prepareImages(request: OcrRequest): Promise<PreparedImage[]> {\n    const sources = [request.image, request.backImage].filter((b): b is Uint8Array => !!b && b.length > 0)\n    return Promise.all(sources.map((bytes) => prepareImage(bytes, this.maxEdge)))\n  }\n}\n\nconst present = (v: unknown): v is string => typeof v === 'string' && v.trim().length > 0\nconst isIsoDate = (v: unknown): boolean => present(v) && /^\\d{4}-\\d{2}-\\d{2}$/.test(v) && !Number.isNaN(Date.parse(v))\n\n/**\n * Trim/blank-out the model's fields; drop anything empty so callers see `undefined`.\n *\n * @param input\n * @returns\n */\nfunction normalizeFields(fields: OcrFields): OcrFields {\n  const out: OcrFields = {}\n  const set = (key: keyof OcrFields, value: string | undefined) => {\n    if (present(value)) out[key] = value.trim()\n  }\n  set('firstName', fields.firstName)\n  set('lastName', fields.lastName)\n  set('fullName', fields.fullName)\n  set('dateOfBirth', fields.dateOfBirth)\n  set('documentNumber', fields.documentNumber)\n  set('expiryDate', fields.expiryDate)\n  set('issueDate', fields.issueDate)\n  set('nationality', fields.nationality)\n  return out\n}\n\n/**\n * Deterministic confidence in [0, 1] from field completeness + structural\n * validity. Weights sum to 1.0 when every field is present and well-formed; the\n * model's self-reported legibility can only pull the score down by up to 15%, so\n * trustworthy structure dominates an unreliable self-assessment.\n *\n * @param fields\n * @param legibility\n * @returns\n */\nexport function scoreConfidence(fields: OcrFields, legibility?: number): number {\n  const hasName = (present(fields.firstName) && present(fields.lastName)) || present(fields.fullName)\n  const checks: Array<[boolean, number]> = [\n    [hasName, 0.28],\n    [isIsoDate(fields.dateOfBirth), 0.22],\n    [present(fields.documentNumber) && fields.documentNumber!.trim().length >= 4, 0.22],\n    [isIsoDate(fields.expiryDate), 0.16],\n    [present(fields.nationality), 0.12],\n  ]\n  const base = checks.reduce((sum, [ok, weight]) => (ok ? sum + weight : sum), 0)\n  const legible = clamp01(legibility ?? 1)\n  return clamp01(base * (0.85 + 0.15 * legible))\n}\n\n/**\n * Hard ceiling on OCR confidence once any authenticity flag fires. Below the\n * default `ocrConfidenceThreshold` (0.8), so a flagged document routes to manual\n * review regardless of how cleanly its fields read.\n */\nconst SUSPECT_CONFIDENCE_CEILING = 0.5\n\n/**\n * Fold the authenticity read into the field-derived confidence. Only ever lowers\n * the score, and only when a concrete flag fired — a genuine (or unassessed)\n * document is returned untouched. A flagged document is capped at both the\n * model's own authenticity confidence and {@link SUSPECT_CONFIDENCE_CEILING},\n * which lands it in manual review rather than auto-approval. This is deliberately\n * conservative: the LLM's authenticity guess can demote, never reject outright.\n *\n * @param fieldScore\n * @param authenticity\n * @returns\n */\nexport function applyAuthenticity(fieldScore: number, authenticity?: OcrAuthenticity): number {\n  if (!authenticity || authenticity.genuine) return fieldScore\n  return Math.min(fieldScore, clamp01(authenticity.confidence), SUSPECT_CONFIDENCE_CEILING)\n}\n\nconst SYSTEM_PROMPT =\n  'You are an OCR engine for identity documents. Read the visible printed text and ' +\n  'the machine-readable zone (MRZ) if present, and return the fields exactly as ' +\n  'printed. Do not guess, infer, or correct values you cannot clearly read — omit a ' +\n  'field rather than fabricate it. Dates must be ISO 8601 (YYYY-MM-DD).\\n\\n' +\n  'Identity documents print BOTH a date of issue and a date of expiry — never ' +\n  'confuse them. `expiryDate` is only the expiry/expiration/\"valid until\"/\"date of ' +\n  'expiry\" value (in an MRZ, the second date field, not the first). `issueDate` is ' +\n  'the \"date of issue\"/\"issued\"/\"valid from\" value. The expiry is later than the ' +\n  'issue date. If a document shows only an issue date and no expiry, return the ' +\n  'issue date in `issueDate` and leave `expiryDate` empty — do not put the issue ' +\n  'date in `expiryDate`.\\n\\n' +\n  'ALSO assess document authenticity, to the best of your ability, from the image ' +\n  'alone — and report it. Be conservative: raise a flag only on a clear, visible ' +\n  'sign. A genuine document that was merely photographed imperfectly (blur, glare ' +\n  'on a glossy original, a shadow, a crop) must NOT be flagged. Set `screenReplay` ' +\n  'when the image looks like a photo of a screen — moiré or a visible pixel grid, ' +\n  'backlit glow, refresh banding, or a device bezel (a replay attack). Set ' +\n  '`photocopy` when it looks like a photo or scan of a printout/photocopy rather ' +\n  'than the physical document — flat matte paper, halftone dot printing, no ' +\n  'security features or hologram. Set `digitalTampering` for signs of digital ' +\n  'editing — mismatched fonts or kerning, misaligned or recoloured text, smudged ' +\n  'or cloned regions, a pasted-in portrait, or altered dates. Set ' +\n  '`physicalTampering` for a substituted photo, peeled or lifted laminate, or ' +\n  'scratched-out / overwritten fields. Give `authenticityConfidence` from 0 ' +\n  '(clearly fake or replayed) to 1 (clearly an authentic original), and list brief ' +\n  'supporting notes in `authenticityObservations`. You read and assess the ' +\n  'document; you do not make the final accept/reject decision.'\n\nconst READ_TOOL = {\n  name: 'read_document',\n  description: 'Return the identity fields read from the document image(s).',\n  input_schema: {\n    type: 'object',\n    properties: {\n      firstName: { type: 'string', description: 'Given name(s) as printed.' },\n      lastName: { type: 'string', description: 'Surname / family name as printed.' },\n      fullName: { type: 'string', description: 'Full name if given/surname cannot be separated.' },\n      dateOfBirth: { type: 'string', description: 'Date of birth, ISO 8601 YYYY-MM-DD.' },\n      documentNumber: { type: 'string', description: 'Document/serial number as printed.' },\n      issueDate: {\n        type: 'string',\n        description: 'Date of issue (\"issued\"/\"valid from\"/\"issue date\"), ISO 8601 YYYY-MM-DD. NOT the expiry.',\n      },\n      expiryDate: {\n        type: 'string',\n        description:\n          'Expiry date (\"date of expiry\"/\"valid until\"/\"expiry date\"), ISO 8601 YYYY-MM-DD. Must be the expiry, never the issue date; omit if the document shows no expiry.',\n      },\n      nationality: { type: 'string', description: 'ISO 3166-1 alpha-3 country code if determinable.' },\n      documentType: {\n        type: 'string',\n        enum: ['passport', 'id_card', 'drivers_license', 'residence_permit'],\n      },\n      legibility: {\n        type: 'number',\n        description: 'How clearly the document text could be read, 0 (illegible) to 1 (crisp).',\n      },\n      screenReplay: {\n        type: 'boolean',\n        description: 'Looks like a photo of a screen (moiré, pixel grid, backlit glow, refresh banding, bezel).',\n      },\n      photocopy: {\n        type: 'boolean',\n        description: 'Looks like a photo/scan of a printout or photocopy rather than the physical document.',\n      },\n      digitalTampering: {\n        type: 'boolean',\n        description:\n          'Signs of digital editing: mismatched fonts, misaligned/recoloured text, cloned regions, edited photo/dates.',\n      },\n      physicalTampering: {\n        type: 'boolean',\n        description:\n          'Signs of physical tampering: substituted photo, peeled laminate, scratched-out/overwritten fields.',\n      },\n      authenticityConfidence: {\n        type: 'number',\n        description: 'Authenticity confidence, 0 (clearly fake/replayed) to 1 (clearly an authentic original).',\n      },\n      authenticityObservations: {\n        type: 'array',\n        items: { type: 'string' },\n        description: 'Brief notes supporting any authenticity flag raised.',\n      },\n    },\n  },\n} as const\n\n/**\n * Minimal shape of the messages-API response we read.\n *\n */\ninterface AnthropicResponse {\n  content?: Array<{ type: string; name?: string; input?: Record<string, unknown> }>\n}\n\nconst DOCUMENT_TYPES: readonly DocumentType[] = ['passport', 'id_card', 'drivers_license', 'residence_permit']\n\n/**\n * HTTP statuses worth a bounded retry: rate-limited / overloaded / unavailable.\n */\nconst RETRYABLE_STATUS = new Set([429, 503, 529])\n\nconst sleep = (ms: number): Promise<void> => new Promise((resolve) => setTimeout(resolve, ms))\n\n/**\n * Exponential backoff (ms) for attempt 0, 1, 2…, capped at 8s.\n */\nconst backoffMs = (attempt: number): number => Math.min(8_000, 500 * 2 ** attempt)\n\n/**\n * Parse a `retry-after` header (seconds) into ms; null when absent/invalid.\n */\nfunction retryAfterMs(res: Response): number | null {\n  const header = res.headers.get('retry-after')\n  if (!header) return null\n  const seconds = Number(header)\n  return Number.isFinite(seconds) && seconds >= 0 ? seconds * 1000 : null\n}\n\n/**\n * POST with a per-attempt timeout and a bounded retry on 429/529 — honouring\n * `retry-after`, else exponential backoff. Timeouts/network errors retry too;\n * any other response is returned as-is for the caller to handle. The durable job\n * queue is the longer-term retry beyond {@link DEFAULT_MAX_RETRIES}.\n *\n * @param url\n * @param init\n * @param timeoutMs\n * @param maxRetries\n * @returns\n */\nasync function postWithRetry(url: string, init: RequestInit, timeoutMs: number, maxRetries: number): Promise<Response> {\n  for (let attempt = 0; ; attempt++) {\n    let res: Response\n    try {\n      res = await fetch(url, { ...init, signal: AbortSignal.timeout(timeoutMs) })\n    } catch (error) {\n      if (attempt >= maxRetries) throw error\n      await sleep(backoffMs(attempt))\n      continue\n    }\n    if (RETRYABLE_STATUS.has(res.status) && attempt < maxRetries) {\n      await sleep(retryAfterMs(res) ?? backoffMs(attempt))\n      continue\n    }\n    return res\n  }\n}\n\n/**\n * Build the default vision call against the Anthropic messages API.\n *\n * @param input\n * @returns\n */\nexport function anthropicVision(opts: {\n  apiKey: string\n  model: string\n  baseUrl: string\n  timeoutMs?: number\n  maxRetries?: number\n}): AiVisionExtract {\n  return async (request, images) => {\n    const hint = request.documentType ? ` The document is a ${request.documentType}.` : ''\n    const country = request.country ? ` Issuing country hint: ${request.country}.` : ''\n    const res = await postWithRetry(\n      `${opts.baseUrl}/v1/messages`,\n      {\n        method: 'POST',\n        headers: {\n          'x-api-key': opts.apiKey,\n          'anthropic-version': '2023-06-01',\n          'content-type': 'application/json',\n        },\n        body: JSON.stringify({\n          model: opts.model,\n          max_tokens: 1024,\n          system: SYSTEM_PROMPT,\n          tools: [READ_TOOL],\n          tool_choice: { type: 'tool', name: 'read_document' },\n          messages: [\n            {\n              role: 'user',\n              content: [\n                ...images.map((img) => ({\n                  type: 'image',\n                  source: { type: 'base64', media_type: img.mediaType, data: img.data },\n                })),\n                { type: 'text', text: `Read this identity document and return its fields.${hint}${country}` },\n              ],\n            },\n          ],\n        }),\n      },\n      opts.timeoutMs ?? DEFAULT_TIMEOUT_MS,\n      opts.maxRetries ?? DEFAULT_MAX_RETRIES,\n    )\n\n    if (!res.ok) {\n      throw new Error(`AnthropicOcrDriver request failed with status ${res.status}`)\n    }\n\n    const json = (await res.json()) as AnthropicResponse\n    const tool = json.content?.find((block) => block.type === 'tool_use' && block.name === 'read_document')\n    if (!tool?.input) {\n      throw new Error('AnthropicOcrDriver: model returned no structured fields')\n    }\n\n    return mapToolInput(tool.input)\n  }\n}\n\n/**\n * Minimal shape of the OpenAI-compatible chat-completions response we read.\n */\ninterface ChatCompletionResponse {\n  choices?: Array<{\n    message?: {\n      content?: string | null\n      tool_calls?: Array<{ function?: { name?: string; arguments?: string | Record<string, unknown> } }>\n    }\n  }>\n}\n\n/**\n * Parse a JSON object out of model text, tolerating a ```json fence. Null when\n * the text holds no object.\n *\n * @param text\n * @returns\n */\nfunction parseJsonObject(text: string | null | undefined): Record<string, unknown> | null {\n  if (!text) return null\n  const start = text.indexOf('{')\n  const end = text.lastIndexOf('}')\n  if (start < 0 || end <= start) return null\n  try {\n    const parsed = JSON.parse(text.slice(start, end + 1)) as unknown\n    return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? (parsed as Record<string, unknown>) : null\n  } catch {\n    return null\n  }\n}\n\n/**\n * Build the vision call against Cloudflare Workers AI's OpenAI-compatible chat\n * completions endpoint. Images go in as base64 data URLs and the model is forced\n * to call `read_document`; when a model answers in plain text instead, a JSON\n * object in the reply is accepted as the tool input.\n *\n * @param opts\n * @returns\n */\nexport function workersAiVision(opts: {\n  apiKey: string\n  model: string\n  /** OpenAI-compatible base ending in `/v1`. */\n  baseUrl: string\n  timeoutMs?: number\n  maxRetries?: number\n}): AiVisionExtract {\n  return async (request, images) => {\n    const hint = request.documentType ? ` The document is a ${request.documentType}.` : ''\n    const country = request.country ? ` Issuing country hint: ${request.country}.` : ''\n    const res = await postWithRetry(\n      `${opts.baseUrl}/chat/completions`,\n      {\n        method: 'POST',\n        headers: {\n          authorization: `Bearer ${opts.apiKey}`,\n          'content-type': 'application/json',\n        },\n        body: JSON.stringify({\n          model: opts.model,\n          max_completion_tokens: 2048,\n          temperature: 0,\n          tools: [\n            {\n              type: 'function',\n              function: {\n                name: READ_TOOL.name,\n                description: READ_TOOL.description,\n                parameters: READ_TOOL.input_schema,\n              },\n            },\n          ],\n          tool_choice: 'required',\n          messages: [\n            { role: 'system', content: SYSTEM_PROMPT },\n            {\n              role: 'user',\n              content: [\n                ...images.map((img) => ({\n                  type: 'image_url',\n                  image_url: { url: `data:${img.mediaType};base64,${img.data}` },\n                })),\n                { type: 'text', text: `Read this identity document and return its fields.${hint}${country}` },\n              ],\n            },\n          ],\n        }),\n      },\n      opts.timeoutMs ?? DEFAULT_TIMEOUT_MS,\n      opts.maxRetries ?? DEFAULT_MAX_RETRIES,\n    )\n\n    if (!res.ok) {\n      throw new Error(`AnthropicOcrDriver (workers-ai) request failed with status ${res.status}`)\n    }\n\n    const message = ((await res.json()) as ChatCompletionResponse).choices?.[0]?.message\n    const call = message?.tool_calls?.find((c) => c.function?.name === READ_TOOL.name) ?? message?.tool_calls?.[0]\n    const args = call?.function?.arguments\n    const input = typeof args === 'string' ? parseJsonObject(args) : (args ?? parseJsonObject(message?.content))\n    if (!input) {\n      throw new Error('AnthropicOcrDriver (workers-ai): model returned no structured fields')\n    }\n\n    return mapToolInput(input)\n  }\n}\n\n/**\n * Coerce the model's tool input into an {@link AiExtraction} (string-typed fields).\n *\n * @param input\n * @returns\n */\nfunction mapToolInput(input: Record<string, unknown>): AiExtraction {\n  const str = (v: unknown): string | undefined => (typeof v === 'string' && v.trim() ? v.trim() : undefined)\n  const docType = str(input.documentType)\n  return {\n    fields: {\n      firstName: str(input.firstName),\n      lastName: str(input.lastName),\n      fullName: str(input.fullName),\n      dateOfBirth: str(input.dateOfBirth),\n      documentNumber: str(input.documentNumber),\n      expiryDate: str(input.expiryDate),\n      nationality: str(input.nationality),\n    },\n    legibility: typeof input.legibility === 'number' ? input.legibility : undefined,\n    documentType: docType && (DOCUMENT_TYPES as readonly string[]).includes(docType) ? (docType as DocumentType) : null,\n    authenticity: mapAuthenticity(input),\n  }\n}\n\n/**\n * Build the {@link OcrAuthenticity} read from the model's tool input. Returns\n * `undefined` when the model reported nothing assessable (no flags, no\n * confidence, no notes) so a driver that can't see authenticity stays silent.\n *\n * @param input\n * @returns\n */\nfunction mapAuthenticity(input: Record<string, unknown>): OcrAuthenticity | undefined {\n  const bool = (v: unknown): boolean => v === true\n  const screenReplay = bool(input.screenReplay)\n  const photocopy = bool(input.photocopy)\n  const digitalTampering = bool(input.digitalTampering)\n  const physicalTampering = bool(input.physicalTampering)\n  const flagged = screenReplay || photocopy || digitalTampering || physicalTampering\n\n  const observations = Array.isArray(input.authenticityObservations)\n    ? input.authenticityObservations\n        .filter((o): o is string => typeof o === 'string' && o.trim().length > 0)\n        .map((o) => o.trim())\n        .slice(0, 6)\n    : []\n\n  const reported = typeof input.authenticityConfidence === 'number'\n  // The model said nothing about authenticity at all — don't fabricate a verdict.\n  if (!flagged && !reported && observations.length === 0) return undefined\n\n  // A flagged document with no explicit score defaults to clearly-suspect (0.2);\n  // an unflagged read defaults to clearly-genuine (1).\n  const confidence = clamp01(reported ? (input.authenticityConfidence as number) : flagged ? 0.2 : 1)\n\n  return { genuine: !flagged, confidence, screenReplay, photocopy, digitalTampering, physicalTampering, observations }\n}\n\n/**\n * Detect the media type from magic bytes; default to JPEG.\n *\n * @param bytes\n * @returns\n */\nfunction detectMediaType(bytes: Uint8Array): PreparedImage['mediaType'] {\n  if (bytes[0] === 0xff && bytes[1] === 0xd8) return 'image/jpeg'\n  if (bytes[0] === 0x89 && bytes[1] === 0x50) return 'image/png'\n  if (bytes[0] === 0x52 && bytes[1] === 0x49 && bytes[8] === 0x57) return 'image/webp'\n  return 'image/jpeg'\n}\n\ninterface SharpInstance {\n  metadata(): Promise<{ width?: number; height?: number }>\n  resize(options: { width?: number; height?: number; fit: string; withoutEnlargement: boolean }): SharpInstance\n  jpeg(options: { quality: number }): SharpInstance\n  toBuffer(): Promise<Buffer>\n}\ntype SharpFactory = (input: Buffer) => SharpInstance\n\nlet sharpFactory: SharpFactory | null | undefined\n\n/** Lazily resolve the optional `sharp` factory once; null when not installed. */\nasync function loadSharp(): Promise<SharpFactory | null> {\n  if (sharpFactory !== undefined) return sharpFactory\n  const moduleName = 'sharp'\n  try {\n    const mod = (await import(/* @vite-ignore */ moduleName)) as unknown as { default: SharpFactory }\n    sharpFactory = mod.default\n  } catch {\n    sharpFactory = null\n  }\n  return sharpFactory\n}\n\n/**\n * Downscale an image to `maxEdge` and re-encode as JPEG to bound the upload (and\n * therefore the model's image-token cost). Falls back to the original bytes when\n * `sharp` isn't installed or fails — the API caps oversized images itself.\n *\n * @param url\n * @param init\n * @param timeoutMs\n * @param maxRetries\n * @returns\n */\nasync function prepareImage(bytes: Uint8Array, maxEdge: number): Promise<PreparedImage> {\n  const sharp = await loadSharp()\n  if (sharp) {\n    try {\n      const input = Buffer.from(bytes)\n      const { width, height } = await sharp(input).metadata()\n      const longest = Math.max(width ?? 0, height ?? 0)\n      let pipe = sharp(input)\n      if (longest > maxEdge) {\n        pipe = pipe.resize({ width: maxEdge, height: maxEdge, fit: 'inside', withoutEnlargement: true })\n      }\n      const out = await pipe.jpeg({ quality: 85 }).toBuffer()\n      return { mediaType: 'image/jpeg', data: out.toString('base64') }\n    } catch {\n      // fall through to raw bytes\n    }\n  }\n  return { mediaType: detectMediaType(bytes), data: Buffer.from(bytes).toString('base64') }\n}\n"],"mappings":"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"}
+{"version":3,"file":"ai.mjs","names":[],"sources":["../../src/drivers/ai.ts"],"sourcesContent":["import type { DocumentType, OcrAuthenticity, OcrFields, OcrResultData } from '@arkyc/types'\nimport type { OcrDriver, OcrRequest } from '../types'\n\nconst clamp01 = (n: number): number => Math.min(1, Math.max(0, n))\n\n/**\n * Anthropic's default API base; override for a gateway/proxy.\n */\nconst DEFAULT_BASE_URL = 'https://api.anthropic.com'\n\n/**\n * A small, cheap vision model is plenty for reading printed/MRZ document text.\n */\nexport const DEFAULT_AI_MODEL = 'claude-haiku-4-5-20251001'\n\n/**\n * Default Cloudflare Workers AI model: Gemma 4 accepts image input and tool calls.\n */\nexport const DEFAULT_WORKERS_AI_MODEL = '@cf/google/gemma-4-26b-a4b-it'\n\n/**\n * Which hosted vision API backs the `ai` driver.\n */\nexport type AiOcrProvider = 'anthropic' | 'workers-ai'\n\n/**\n * Longest edge (px) we upload. The API downsamples anything larger anyway and\n * bills by the resampled size, so this is a cost/bandwidth bound, not a quality\n * one — small enough to be cheap, large enough to keep the MRZ legible.\n */\nconst DEFAULT_MAX_EDGE = 1568\n\n/**\n * Per-attempt request timeout (ms) — a hung connection must not stall a worker.\n */\nconst DEFAULT_TIMEOUT_MS = 30_000\n\n/**\n * Bounded in-driver retries on rate-limit/overload; the job queue retries beyond.\n */\nconst DEFAULT_MAX_RETRIES = 2\n\n/**\n * A base64 image ready for the messages API, with its detected media type.\n */\ninterface PreparedImage {\n  mediaType: 'image/jpeg' | 'image/png' | 'image/webp'\n  data: string\n}\n\n/**\n * Raw fields the vision model returned, before validation/scoring.\n */\nexport interface AiExtraction {\n  fields: OcrFields\n  /** The model's own legibility self-assessment in [0, 1], if it gave one. */\n  legibility?: number\n  documentType?: DocumentType | null\n  /** Best-effort tamper/replay read; omitted when the model reported nothing. */\n  authenticity?: OcrAuthenticity\n}\n\n/**\n * Calls a vision model and returns the raw extracted fields. Injected so the\n * driver's scoring can be unit-tested without a network call; the default\n * implementation talks to the Anthropic messages API.\n */\nexport type AiVisionExtract = (request: OcrRequest, images: PreparedImage[]) => Promise<AiExtraction>\n\nexport interface AnthropicOcrOptions {\n  /** Vision backend; defaults to `anthropic`. */\n  provider?: AiOcrProvider\n  /** Anthropic API key, or the Cloudflare API token for `workers-ai`. */\n  apiKey?: string\n  /** Cloudflare account id; required for `workers-ai` unless `baseUrl` is set. */\n  accountId?: string\n  /** Model id; defaults to {@link DEFAULT_AI_MODEL} or {@link DEFAULT_WORKERS_AI_MODEL}. */\n  model?: string\n  /**\n   * API base URL. Anthropic: defaults to {@link DEFAULT_BASE_URL}. Workers AI: the\n   * OpenAI-compatible base ending in `/v1` (e.g. an AI Gateway URL), defaulting to\n   * the account's `/ai/v1` endpoint.\n   */\n  baseUrl?: string\n  /** Longest image edge (px) to upload; defaults to {@link DEFAULT_MAX_EDGE}. */\n  maxEdge?: number\n  /** Per-attempt request timeout (ms); defaults to {@link DEFAULT_TIMEOUT_MS}. */\n  timeoutMs?: number\n  /** Bounded retries on 429/529; defaults to {@link DEFAULT_MAX_RETRIES}. */\n  maxRetries?: number\n  /** Override the vision call (tests). When set, `apiKey` is not required. */\n  extract?: AiVisionExtract\n}\n\n/**\n * AI OCR driver: hands the document image(s) to a vision LLM (Claude by default,\n * or a Cloudflare Workers AI model with `provider: 'workers-ai'`) and maps the structured response onto {@link OcrResultData}.\n *\n * Confidence is **not** taken from the model's self-report — LLMs are poorly\n * calibrated and will state high confidence on hallucinated fields. Instead it's\n * derived deterministically from which fields came back and whether they're\n * structurally valid (see {@link scoreConfidence}), so the value feeding the\n * decision engine's `ocrConfidenceThreshold` is meaningful. The model's own\n * legibility read is folded in only as a small soft penalty.\n *\n * It also asks the model for a best-effort, image-only authenticity read\n * (screen-replay, photocopy, digital/physical tampering). That signal is\n * advisory: a fired flag only *caps* the OCR confidence (see\n * {@link applyAuthenticity}) so a suspicious document routes to manual review —\n * an LLM's authenticity guess never auto-rejects a user on its own.\n */\nexport class AnthropicOcrDriver implements OcrDriver {\n  readonly name = 'ai'\n\n  private readonly provider: AiOcrProvider\n  private readonly model: string\n  private readonly maxEdge: number\n  private readonly vision: AiVisionExtract\n\n  constructor(options: AnthropicOcrOptions = {}) {\n    this.provider = options.provider ?? 'anthropic'\n    if (!options.apiKey && !options.extract) {\n      throw new Error('AnthropicOcrDriver requires config.apiKey')\n    }\n    this.model = options.model ?? (this.provider === 'workers-ai' ? DEFAULT_WORKERS_AI_MODEL : DEFAULT_AI_MODEL)\n    this.maxEdge = options.maxEdge ?? DEFAULT_MAX_EDGE\n\n    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS\n    const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES\n    if (options.extract) {\n      this.vision = options.extract\n    } else if (this.provider === 'workers-ai') {\n      if (!options.accountId && !options.baseUrl) {\n        throw new Error('AnthropicOcrDriver (workers-ai) requires config.accountId')\n      }\n      this.vision = workersAiVision({\n        apiKey: options.apiKey as string,\n        model: this.model,\n        baseUrl: (\n          options.baseUrl ?? `https://api.cloudflare.com/client/v4/accounts/${options.accountId}/ai/v1`\n        ).replace(/\\/$/, ''),\n        timeoutMs,\n        maxRetries,\n      })\n    } else {\n      this.vision = anthropicVision({\n        apiKey: options.apiKey as string,\n        model: this.model,\n        baseUrl: (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, ''),\n        timeoutMs,\n        maxRetries,\n      })\n    }\n  }\n\n  async extract(request: OcrRequest): Promise<OcrResultData> {\n    const images = await this.prepareImages(request)\n    const raw = await this.vision(request, images)\n    const fields = normalizeFields(raw.fields)\n    const authenticity = raw.authenticity\n    const confidence = applyAuthenticity(scoreConfidence(fields, raw.legibility), authenticity)\n\n    return {\n      fields,\n      confidence,\n      ...(authenticity ? { authenticity } : {}),\n      raw: {\n        provider: 'ai',\n        backend: this.provider,\n        model: this.model,\n        legibility: raw.legibility ?? null,\n        documentType: raw.documentType ?? request.documentType ?? null,\n        authenticity: authenticity ?? null,\n      },\n    }\n  }\n\n  /**\n   * Resize (best-effort) and base64-encode the front + optional back images.\n   *\n   * @param input\n   * @returns\n   */\n  private async prepareImages(request: OcrRequest): Promise<PreparedImage[]> {\n    const sources = [request.image, request.backImage].filter((b): b is Uint8Array => !!b && b.length > 0)\n    return Promise.all(sources.map((bytes) => prepareImage(bytes, this.maxEdge)))\n  }\n}\n\nconst present = (v: unknown): v is string => typeof v === 'string' && v.trim().length > 0\nconst isIsoDate = (v: unknown): boolean => present(v) && /^\\d{4}-\\d{2}-\\d{2}$/.test(v) && !Number.isNaN(Date.parse(v))\n\n/**\n * Trim/blank-out the model's fields; drop anything empty so callers see `undefined`.\n *\n * @param input\n * @returns\n */\nfunction normalizeFields(fields: OcrFields): OcrFields {\n  const out: OcrFields = {}\n  const set = (key: keyof OcrFields, value: string | undefined) => {\n    if (present(value)) out[key] = value.trim()\n  }\n  set('firstName', fields.firstName)\n  set('lastName', fields.lastName)\n  set('fullName', fields.fullName)\n  set('dateOfBirth', fields.dateOfBirth)\n  set('documentNumber', fields.documentNumber)\n  set('expiryDate', fields.expiryDate)\n  set('issueDate', fields.issueDate)\n  set('nationality', fields.nationality)\n  return out\n}\n\n/**\n * Deterministic confidence in [0, 1] from field completeness + structural\n * validity. Weights sum to 1.0 when every field is present and well-formed; the\n * model's self-reported legibility can only pull the score down by up to 15%, so\n * trustworthy structure dominates an unreliable self-assessment.\n *\n * @param fields\n * @param legibility\n * @returns\n */\nexport function scoreConfidence(fields: OcrFields, legibility?: number): number {\n  const hasName = (present(fields.firstName) && present(fields.lastName)) || present(fields.fullName)\n  const checks: Array<[boolean, number]> = [\n    [hasName, 0.28],\n    [isIsoDate(fields.dateOfBirth), 0.22],\n    [present(fields.documentNumber) && fields.documentNumber!.trim().length >= 4, 0.22],\n    [isIsoDate(fields.expiryDate), 0.16],\n    [present(fields.nationality), 0.12],\n  ]\n  const base = checks.reduce((sum, [ok, weight]) => (ok ? sum + weight : sum), 0)\n  const legible = clamp01(legibility ?? 1)\n  return clamp01(base * (0.85 + 0.15 * legible))\n}\n\n/**\n * Hard ceiling on OCR confidence once any authenticity flag fires. Below the\n * default `ocrConfidenceThreshold` (0.8), so a flagged document routes to manual\n * review regardless of how cleanly its fields read.\n */\nconst SUSPECT_CONFIDENCE_CEILING = 0.5\n\n/**\n * Fold the authenticity read into the field-derived confidence. Only ever lowers\n * the score, and only when a concrete flag fired — a genuine (or unassessed)\n * document is returned untouched. A flagged document is capped at both the\n * model's own authenticity confidence and {@link SUSPECT_CONFIDENCE_CEILING},\n * which lands it in manual review rather than auto-approval. This is deliberately\n * conservative: the LLM's authenticity guess can demote, never reject outright.\n *\n * @param fieldScore\n * @param authenticity\n * @returns\n */\nexport function applyAuthenticity(fieldScore: number, authenticity?: OcrAuthenticity): number {\n  if (!authenticity || authenticity.genuine) return fieldScore\n  return Math.min(fieldScore, clamp01(authenticity.confidence), SUSPECT_CONFIDENCE_CEILING)\n}\n\nconst SYSTEM_PROMPT =\n  'You are an OCR engine for identity documents. Read the visible printed text and ' +\n  'the machine-readable zone (MRZ) if present, and return the fields exactly as ' +\n  'printed. Do not guess, infer, or correct values you cannot clearly read — omit a ' +\n  'field rather than fabricate it. Dates must be ISO 8601 (YYYY-MM-DD).\\n\\n' +\n  'Identity documents print BOTH a date of issue and a date of expiry — never ' +\n  'confuse them. `expiryDate` is only the expiry/expiration/\"valid until\"/\"date of ' +\n  'expiry\" value (in an MRZ, the second date field, not the first). `issueDate` is ' +\n  'the \"date of issue\"/\"issued\"/\"valid from\" value. The expiry is later than the ' +\n  'issue date. If a document shows only an issue date and no expiry, return the ' +\n  'issue date in `issueDate` and leave `expiryDate` empty — do not put the issue ' +\n  'date in `expiryDate`.\\n\\n' +\n  'ALSO assess document authenticity, to the best of your ability, from the image ' +\n  'alone — and report it. Be conservative: raise a flag only on a clear, visible ' +\n  'sign. A genuine document that was merely photographed imperfectly (blur, glare ' +\n  'on a glossy original, a shadow, a crop) must NOT be flagged. Set `screenReplay` ' +\n  'when the image looks like a photo of a screen — moiré or a visible pixel grid, ' +\n  'backlit glow, refresh banding, or a device bezel (a replay attack). Set ' +\n  '`photocopy` when it looks like a photo or scan of a printout/photocopy rather ' +\n  'than the physical document — flat matte paper, halftone dot printing, no ' +\n  'security features or hologram. Set `digitalTampering` for signs of digital ' +\n  'editing — mismatched fonts or kerning, misaligned or recoloured text, smudged ' +\n  'or cloned regions, a pasted-in portrait, or altered dates. Set ' +\n  '`physicalTampering` for a substituted photo, peeled or lifted laminate, or ' +\n  'scratched-out / overwritten fields. Give `authenticityConfidence` from 0 ' +\n  '(clearly fake or replayed) to 1 (clearly an authentic original), and list brief ' +\n  'supporting notes in `authenticityObservations`. You read and assess the ' +\n  'document; you do not make the final accept/reject decision.'\n\nconst READ_TOOL = {\n  name: 'read_document',\n  description: 'Return the identity fields read from the document image(s).',\n  input_schema: {\n    type: 'object',\n    properties: {\n      firstName: { type: 'string', description: 'Given name(s) as printed.' },\n      lastName: { type: 'string', description: 'Surname / family name as printed.' },\n      fullName: { type: 'string', description: 'Full name if given/surname cannot be separated.' },\n      dateOfBirth: { type: 'string', description: 'Date of birth, ISO 8601 YYYY-MM-DD.' },\n      documentNumber: { type: 'string', description: 'Document/serial number as printed.' },\n      issueDate: {\n        type: 'string',\n        description: 'Date of issue (\"issued\"/\"valid from\"/\"issue date\"), ISO 8601 YYYY-MM-DD. NOT the expiry.',\n      },\n      expiryDate: {\n        type: 'string',\n        description:\n          'Expiry date (\"date of expiry\"/\"valid until\"/\"expiry date\"), ISO 8601 YYYY-MM-DD. Must be the expiry, never the issue date; omit if the document shows no expiry.',\n      },\n      nationality: { type: 'string', description: 'ISO 3166-1 alpha-3 country code if determinable.' },\n      documentType: {\n        type: 'string',\n        enum: ['passport', 'id_card', 'drivers_license', 'residence_permit'],\n      },\n      legibility: {\n        type: 'number',\n        description: 'How clearly the document text could be read, 0 (illegible) to 1 (crisp).',\n      },\n      screenReplay: {\n        type: 'boolean',\n        description: 'Looks like a photo of a screen (moiré, pixel grid, backlit glow, refresh banding, bezel).',\n      },\n      photocopy: {\n        type: 'boolean',\n        description: 'Looks like a photo/scan of a printout or photocopy rather than the physical document.',\n      },\n      digitalTampering: {\n        type: 'boolean',\n        description:\n          'Signs of digital editing: mismatched fonts, misaligned/recoloured text, cloned regions, edited photo/dates.',\n      },\n      physicalTampering: {\n        type: 'boolean',\n        description:\n          'Signs of physical tampering: substituted photo, peeled laminate, scratched-out/overwritten fields.',\n      },\n      authenticityConfidence: {\n        type: 'number',\n        description: 'Authenticity confidence, 0 (clearly fake/replayed) to 1 (clearly an authentic original).',\n      },\n      authenticityObservations: {\n        type: 'array',\n        items: { type: 'string' },\n        description: 'Brief notes supporting any authenticity flag raised.',\n      },\n    },\n  },\n} as const\n\n/**\n * Minimal shape of the messages-API response we read.\n *\n */\ninterface AnthropicResponse {\n  content?: Array<{ type: string; name?: string; input?: Record<string, unknown> }>\n}\n\nconst DOCUMENT_TYPES: readonly DocumentType[] = ['passport', 'id_card', 'drivers_license', 'residence_permit']\n\n/**\n * HTTP statuses worth a bounded retry: rate-limited / overloaded / unavailable.\n */\nconst RETRYABLE_STATUS = new Set([429, 503, 529])\n\nconst sleep = (ms: number): Promise<void> => new Promise((resolve) => setTimeout(resolve, ms))\n\n/**\n * Exponential backoff (ms) for attempt 0, 1, 2…, capped at 8s.\n */\nconst backoffMs = (attempt: number): number => Math.min(8_000, 500 * 2 ** attempt)\n\n/**\n * Parse a `retry-after` header (seconds) into ms; null when absent/invalid.\n */\nfunction retryAfterMs(res: Response): number | null {\n  const header = res.headers.get('retry-after')\n  if (!header) return null\n  const seconds = Number(header)\n  return Number.isFinite(seconds) && seconds >= 0 ? seconds * 1000 : null\n}\n\n/**\n * POST with a per-attempt timeout and a bounded retry on 429/529 — honouring\n * `retry-after`, else exponential backoff. Timeouts/network errors retry too;\n * any other response is returned as-is for the caller to handle. The durable job\n * queue is the longer-term retry beyond {@link DEFAULT_MAX_RETRIES}.\n *\n * @param url\n * @param init\n * @param timeoutMs\n * @param maxRetries\n * @returns\n */\nasync function postWithRetry(url: string, init: RequestInit, timeoutMs: number, maxRetries: number): Promise<Response> {\n  for (let attempt = 0; ; attempt++) {\n    let res: Response\n    try {\n      res = await fetch(url, { ...init, signal: AbortSignal.timeout(timeoutMs) })\n    } catch (error) {\n      if (attempt >= maxRetries) throw error\n      await sleep(backoffMs(attempt))\n      continue\n    }\n    if (RETRYABLE_STATUS.has(res.status) && attempt < maxRetries) {\n      await sleep(retryAfterMs(res) ?? backoffMs(attempt))\n      continue\n    }\n    return res\n  }\n}\n\n/**\n * Build the default vision call against the Anthropic messages API.\n *\n * @param input\n * @returns\n */\nexport function anthropicVision(opts: {\n  apiKey: string\n  model: string\n  baseUrl: string\n  timeoutMs?: number\n  maxRetries?: number\n}): AiVisionExtract {\n  return async (request, images) => {\n    const hint = request.documentType ? ` The document is a ${request.documentType}.` : ''\n    const country = request.country ? ` Issuing country hint: ${request.country}.` : ''\n    const res = await postWithRetry(\n      `${opts.baseUrl}/v1/messages`,\n      {\n        method: 'POST',\n        headers: {\n          'x-api-key': opts.apiKey,\n          'anthropic-version': '2023-06-01',\n          'content-type': 'application/json',\n        },\n        body: JSON.stringify({\n          model: opts.model,\n          max_tokens: 1024,\n          system: SYSTEM_PROMPT,\n          tools: [READ_TOOL],\n          tool_choice: { type: 'tool', name: 'read_document' },\n          messages: [\n            {\n              role: 'user',\n              content: [\n                ...images.map((img) => ({\n                  type: 'image',\n                  source: { type: 'base64', media_type: img.mediaType, data: img.data },\n                })),\n                { type: 'text', text: `Read this identity document and return its fields.${hint}${country}` },\n              ],\n            },\n          ],\n        }),\n      },\n      opts.timeoutMs ?? DEFAULT_TIMEOUT_MS,\n      opts.maxRetries ?? DEFAULT_MAX_RETRIES,\n    )\n\n    if (!res.ok) {\n      throw new Error(`AnthropicOcrDriver request failed with status ${res.status}`)\n    }\n\n    const json = (await res.json()) as AnthropicResponse\n    const tool = json.content?.find((block) => block.type === 'tool_use' && block.name === 'read_document')\n    if (!tool?.input) {\n      throw new Error('AnthropicOcrDriver: model returned no structured fields')\n    }\n\n    return mapToolInput(tool.input)\n  }\n}\n\n/**\n * Minimal shape of the OpenAI-compatible chat-completions response we read.\n */\ninterface ChatCompletionResponse {\n  choices?: Array<{\n    message?: {\n      content?: string | null\n      tool_calls?: Array<{ function?: { name?: string; arguments?: string | Record<string, unknown> } }>\n    }\n  }>\n}\n\n/**\n * Parse a JSON object out of model text, tolerating a ```json fence. Null when\n * the text holds no object.\n *\n * @param text\n * @returns\n */\nfunction parseJsonObject(text: string | null | undefined): Record<string, unknown> | null {\n  if (!text) return null\n  const start = text.indexOf('{')\n  const end = text.lastIndexOf('}')\n  if (start < 0 || end <= start) return null\n  try {\n    const parsed = JSON.parse(text.slice(start, end + 1)) as unknown\n    return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? (parsed as Record<string, unknown>) : null\n  } catch {\n    return null\n  }\n}\n\n/**\n * Build the vision call against Cloudflare Workers AI's OpenAI-compatible chat\n * completions endpoint. Images go in as base64 data URLs and the model is forced\n * to call `read_document`; when a model answers in plain text instead, a JSON\n * object in the reply is accepted as the tool input.\n *\n * @param opts\n * @returns\n */\nexport function workersAiVision(opts: {\n  apiKey: string\n  model: string\n  /** OpenAI-compatible base ending in `/v1`. */\n  baseUrl: string\n  timeoutMs?: number\n  maxRetries?: number\n}): AiVisionExtract {\n  return async (request, images) => {\n    const hint = request.documentType ? ` The document is a ${request.documentType}.` : ''\n    const country = request.country ? ` Issuing country hint: ${request.country}.` : ''\n    const res = await postWithRetry(\n      `${opts.baseUrl}/chat/completions`,\n      {\n        method: 'POST',\n        headers: {\n          authorization: `Bearer ${opts.apiKey}`,\n          'content-type': 'application/json',\n        },\n        body: JSON.stringify({\n          model: opts.model,\n          max_completion_tokens: 2048,\n          temperature: 0,\n          tools: [\n            {\n              type: 'function',\n              function: {\n                name: READ_TOOL.name,\n                description: READ_TOOL.description,\n                parameters: READ_TOOL.input_schema,\n              },\n            },\n          ],\n          tool_choice: 'required',\n          messages: [\n            { role: 'system', content: SYSTEM_PROMPT },\n            {\n              role: 'user',\n              content: [\n                ...images.map((img) => ({\n                  type: 'image_url',\n                  image_url: { url: `data:${img.mediaType};base64,${img.data}` },\n                })),\n                { type: 'text', text: `Read this identity document and return its fields.${hint}${country}` },\n              ],\n            },\n          ],\n        }),\n      },\n      opts.timeoutMs ?? DEFAULT_TIMEOUT_MS,\n      opts.maxRetries ?? DEFAULT_MAX_RETRIES,\n    )\n\n    if (!res.ok) {\n      throw new Error(`AnthropicOcrDriver (workers-ai) request failed with status ${res.status}`)\n    }\n\n    const message = ((await res.json()) as ChatCompletionResponse).choices?.[0]?.message\n    const call = message?.tool_calls?.find((c) => c.function?.name === READ_TOOL.name) ?? message?.tool_calls?.[0]\n    const args = call?.function?.arguments\n    const input = typeof args === 'string' ? parseJsonObject(args) : (args ?? parseJsonObject(message?.content))\n    if (!input) {\n      throw new Error('AnthropicOcrDriver (workers-ai): model returned no structured fields')\n    }\n\n    return mapToolInput(input)\n  }\n}\n\n/**\n * Coerce the model's tool input into an {@link AiExtraction} (string-typed fields).\n *\n * @param input\n * @returns\n */\nfunction mapToolInput(input: Record<string, unknown>): AiExtraction {\n  const str = (v: unknown): string | undefined => (typeof v === 'string' && v.trim() ? v.trim() : undefined)\n  const docType = str(input.documentType)\n  return {\n    fields: {\n      firstName: str(input.firstName),\n      lastName: str(input.lastName),\n      fullName: str(input.fullName),\n      dateOfBirth: str(input.dateOfBirth),\n      documentNumber: str(input.documentNumber),\n      expiryDate: str(input.expiryDate),\n      nationality: str(input.nationality),\n    },\n    legibility: typeof input.legibility === 'number' ? input.legibility : undefined,\n    documentType: docType && (DOCUMENT_TYPES as readonly string[]).includes(docType) ? (docType as DocumentType) : null,\n    authenticity: mapAuthenticity(input),\n  }\n}\n\n/**\n * Build the {@link OcrAuthenticity} read from the model's tool input. Returns\n * `undefined` when the model reported nothing assessable (no flags, no\n * confidence, no notes) so a driver that can't see authenticity stays silent.\n *\n * @param input\n * @returns\n */\nfunction mapAuthenticity(input: Record<string, unknown>): OcrAuthenticity | undefined {\n  const bool = (v: unknown): boolean => v === true\n  const screenReplay = bool(input.screenReplay)\n  const photocopy = bool(input.photocopy)\n  const digitalTampering = bool(input.digitalTampering)\n  const physicalTampering = bool(input.physicalTampering)\n  const flagged = screenReplay || photocopy || digitalTampering || physicalTampering\n\n  const observations = Array.isArray(input.authenticityObservations)\n    ? input.authenticityObservations\n        .filter((o): o is string => typeof o === 'string' && o.trim().length > 0)\n        .map((o) => o.trim())\n        .slice(0, 6)\n    : []\n\n  const reported = typeof input.authenticityConfidence === 'number'\n  // The model said nothing about authenticity at all — don't fabricate a verdict.\n  if (!flagged && !reported && observations.length === 0) return undefined\n\n  // A flagged document with no explicit score defaults to clearly-suspect (0.2);\n  // an unflagged read defaults to clearly-genuine (1).\n  const confidence = clamp01(reported ? (input.authenticityConfidence as number) : flagged ? 0.2 : 1)\n\n  return { genuine: !flagged, confidence, screenReplay, photocopy, digitalTampering, physicalTampering, observations }\n}\n\n/**\n * Detect the media type from magic bytes; default to JPEG.\n *\n * @param bytes\n * @returns\n */\nfunction detectMediaType(bytes: Uint8Array): PreparedImage['mediaType'] {\n  if (bytes[0] === 0xff && bytes[1] === 0xd8) return 'image/jpeg'\n  if (bytes[0] === 0x89 && bytes[1] === 0x50) return 'image/png'\n  if (bytes[0] === 0x52 && bytes[1] === 0x49 && bytes[8] === 0x57) return 'image/webp'\n  return 'image/jpeg'\n}\n\ninterface SharpInstance {\n  metadata(): Promise<{ width?: number; height?: number }>\n  resize(options: { width?: number; height?: number; fit: string; withoutEnlargement: boolean }): SharpInstance\n  jpeg(options: { quality: number }): SharpInstance\n  toBuffer(): Promise<Buffer>\n}\ntype SharpFactory = (input: Buffer) => SharpInstance\n\nlet sharpFactory: SharpFactory | null | undefined\n\n/** Lazily resolve the optional `sharp` factory once; null when not installed. */\nasync function loadSharp(): Promise<SharpFactory | null> {\n  if (sharpFactory !== undefined) return sharpFactory\n  const moduleName = 'sharp'\n  try {\n    const mod = (await import(/* @vite-ignore */ moduleName)) as unknown as { default: SharpFactory }\n    sharpFactory = mod.default\n  } catch {\n    sharpFactory = null\n  }\n  return sharpFactory\n}\n\n/**\n * Downscale an image to `maxEdge` and re-encode as JPEG to bound the upload (and\n * therefore the model's image-token cost). Falls back to the original bytes when\n * `sharp` isn't installed or fails — the API caps oversized images itself.\n *\n * @param url\n * @param init\n * @param timeoutMs\n * @param maxRetries\n * @returns\n */\nasync function prepareImage(bytes: Uint8Array, maxEdge: number): Promise<PreparedImage> {\n  const sharp = await loadSharp()\n  if (sharp) {\n    try {\n      const input = Buffer.from(bytes)\n      const { width, height } = await sharp(input).metadata()\n      const longest = Math.max(width ?? 0, height ?? 0)\n      let pipe = sharp(input)\n      if (longest > maxEdge) {\n        pipe = pipe.resize({ width: maxEdge, height: maxEdge, fit: 'inside', withoutEnlargement: true })\n      }\n      const out = await pipe.jpeg({ quality: 85 }).toBuffer()\n      return { mediaType: 'image/jpeg', data: out.toString('base64') }\n    } catch {\n      // fall through to raw bytes\n    }\n  }\n  return { mediaType: detectMediaType(bytes), data: Buffer.from(bytes).toString('base64') }\n}\n"],"mappings":"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"}

package/dist/drivers/external.d.mts

@@ -1,17 +1,15 @@
 import { OcrConfig, OcrDriver, OcrRequest } from "../types.mjs";
 import { OcrResultData } from "@arkyc/types";
-
 //#region src/drivers/external.d.ts
 /**
  * Generic HTTP OCR driver: POSTs the base64 image to a configured endpoint and
  * expects an {@link OcrResultData}-shaped JSON response.
  */
-declare class ExternalOcrDriver implements OcrDriver {
+export declare class ExternalOcrDriver implements OcrDriver {
   private readonly config;
   readonly name = "external";
   constructor(config: OcrConfig);
   extract(request: OcrRequest): Promise<OcrResultData>;
 }
 //#endregion
-export { ExternalOcrDriver };
 //# sourceMappingURL=external.d.mts.map

package/dist/drivers/external.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"external.d.mts","names":[],"sources":["../../src/drivers/external.ts"],"mappings":";;;;;;AAOA;;cAAa,iBAAA,YAA6B,SAAA;EAAA,iBAGX,MAAA;EAAA,SAFpB,IAAA;cAEoB,MAAA,EAAQ,SAAA;EAI/B,OAAA,CAAQ,OAAA,EAAS,UAAA,GAAa,OAAA,CAAQ,aAAA;AAAA"}
+{"version":3,"file":"external.d.mts","names":[],"sources":["../../src/drivers/external.ts"],"mappings":";;;;;;;qBAOa,6BAA6B;mBAGX;WAFpB;EAEoB,YAAA,QAAQ;EAI/B,QAAQ,SAAS,aAAa,QAAQ"}

package/dist/drivers/mock.d.mts

@@ -1,16 +1,14 @@
 import { OcrDriver, OcrRequest } from "../types.mjs";
 import { OcrResultData } from "@arkyc/types";
-
 //#region src/drivers/mock.d.ts
 /**
  * Deterministic OCR driver for development + tests. Returns fixed identity
  * fields; `hints` steer the confidence and expiry so a caller can drive a
  * session toward any decision.
  */
-declare class MockOcrDriver implements OcrDriver {
+export declare class MockOcrDriver implements OcrDriver {
   readonly name = "mock";
   extract(request: OcrRequest): Promise<OcrResultData>;
 }
 //#endregion
-export { MockOcrDriver };
 //# sourceMappingURL=mock.d.mts.map

package/dist/drivers/mock.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"mock.d.mts","names":[],"sources":["../../src/drivers/mock.ts"],"mappings":";;;;;;AAUA;;;cAAa,aAAA,YAAyB,SAAA;EAAA,SAC3B,IAAA;EAEH,OAAA,CAAQ,OAAA,EAAS,UAAA,GAAa,OAAA,CAAQ,aAAA;AAAA"}
+{"version":3,"file":"mock.d.mts","names":[],"sources":["../../src/drivers/mock.ts"],"mappings":";;;;;;;;qBAUa,yBAAyB;WAC3B;EAEH,QAAQ,SAAS,aAAa,QAAQ"}

package/dist/drivers/preprocess.d.mts

@@ -4,9 +4,9 @@
  * unchanged) bytes — a preprocessor must never throw; on failure it returns the
  * input so recognition still runs.
  */
-type OcrPreprocessor = (image: Uint8Array) => Promise<Uint8Array>;
+export type OcrPreprocessor = (image: Uint8Array) => Promise<Uint8Array>;
 /** Tunables for the default {@link sharpPreprocessor}. */
-interface PreprocessOptions {
+export interface PreprocessOptions {
   /**
    * Upscale images narrower than this (px) to give the engine more pixels per
    * glyph — the single biggest win for the small OCR-B MRZ band. Default 1600.
@@ -14,7 +14,7 @@ interface PreprocessOptions {
   minWidth?: number;
 }
 /** A no-op preprocessor: passes the original bytes through unchanged. */
-declare const passthrough: OcrPreprocessor;
+export declare const passthrough: OcrPreprocessor;
 /** Minimal structural type for the lazily-imported `sharp` module. */
 interface SharpInstance {
   metadata(): Promise<{
@@ -39,13 +39,13 @@ type SharpFactory = (input: Buffer) => SharpInstance;
  * document text and the OCR-B MRZ band without the aggressive binarisation that
  * destroys detail under uneven lighting. Any failure falls back to the original.
  */
-declare function buildSharpPreprocessor(sharp: SharpFactory, options?: PreprocessOptions): OcrPreprocessor;
+export declare function buildSharpPreprocessor(sharp: SharpFactory, options?: PreprocessOptions): OcrPreprocessor;
 /**
  * The default preprocessor, backed by the optional `sharp` package and resolved
  * once. If `sharp` isn't installed it degrades to {@link passthrough}, so OCR
  * still runs on the raw bytes (just without the legibility boost).
  */
-declare function defaultPreprocessor(options?: PreprocessOptions): Promise<OcrPreprocessor>;
+export declare function defaultPreprocessor(options?: PreprocessOptions): Promise<OcrPreprocessor>;
 //#endregion
-export { OcrPreprocessor, PreprocessOptions, buildSharpPreprocessor, defaultPreprocessor, passthrough };
+export {};
 //# sourceMappingURL=preprocess.d.mts.map

package/dist/drivers/preprocess.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"preprocess.d.mts","names":[],"sources":["../../src/drivers/preprocess.ts"],"mappings":";;AAKA;;;;KAAY,eAAA,IAAmB,KAAA,EAAO,UAAA,KAAe,OAAA,CAAQ,UAAA;;UAG5C,iBAAA;EAH2C;;;;EAQ1D,QAAQ;AAAA;AAR6D;AAAA,cAY1D,WAAA,EAAa,eAAwC;;UAGxD,aAAA;EACR,QAAA,IAAY,OAAA;IAAU,KAAA;IAAgB,MAAA;EAAA;EACtC,SAAA,IAAa,aAAA;EACb,SAAA,IAAa,aAAA;EACb,MAAA,CAAO,IAAA,WAAe,aAAA;EACtB,OAAA,IAAW,aAAA;EACX,MAAA,CAAO,OAAA;IAAW,KAAA;IAAe,kBAAA;EAAA,IAAgC,aAAA;EACjE,GAAA,IAAO,aAAA;EACP,QAAA,IAAY,OAAA,CAAQ,MAAA;AAAA;AAAA,KAEjB,YAAA,IAAgB,KAAA,EAAO,MAAA,KAAW,aAAa;;;;;;;iBAQpC,sBAAA,CAAuB,KAAA,EAAO,YAAA,EAAc,OAAA,GAAS,iBAAA,GAAyB,eAAA;;;;;;iBA0BxE,mBAAA,CAAoB,OAAA,GAAS,iBAAA,GAAyB,OAAA,CAAQ,eAAA"}
+{"version":3,"file":"preprocess.d.mts","names":[],"sources":["../../src/drivers/preprocess.ts"],"mappings":";;;;;;YAKY,mBAAmB,OAAO,eAAe,QAAQ;;iBAG5C;;;;;EAKf;;;qBAIW,aAAa;;UAGhB;EACR,YAAY;IAAU;IAAgB;;EACtC,aAAa;EACb,aAAa;EACb,OAAO,eAAe;EACtB,WAAW;EACX,OAAO;IAAW;IAAe;MAAgC;EACjE,OAAO;EACP,YAAY,QAAQ;;KAEjB,gBAAgB,OAAO,WAAW;;;;;;;wBAQvB,uBAAuB,OAAO,cAAc,UAAS,oBAAyB;;;;;;wBA0BxE,oBAAoB,UAAS,oBAAyB,QAAQ"}

package/dist/drivers/preprocess.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"preprocess.mjs","names":[],"sources":["../../src/drivers/preprocess.ts"],"sourcesContent":["/**\n * Transforms raw image bytes to improve OCR legibility. Returns the (possibly\n * unchanged) bytes — a preprocessor must never throw; on failure it returns the\n * input so recognition still runs.\n */\nexport type OcrPreprocessor = (image: Uint8Array) => Promise<Uint8Array>\n\n/** Tunables for the default {@link sharpPreprocessor}. */\nexport interface PreprocessOptions {\n  /**\n   * Upscale images narrower than this (px) to give the engine more pixels per\n   * glyph — the single biggest win for the small OCR-B MRZ band. Default 1600.\n   */\n  minWidth?: number\n}\n\n/** A no-op preprocessor: passes the original bytes through unchanged. */\nexport const passthrough: OcrPreprocessor = async (image) => image\n\n/** Minimal structural type for the lazily-imported `sharp` module. */\ninterface SharpInstance {\n  metadata(): Promise<{ width?: number; height?: number }>\n  grayscale(): SharpInstance\n  normalise(): SharpInstance\n  median(size: number): SharpInstance\n  sharpen(): SharpInstance\n  resize(options: { width: number; withoutEnlargement: boolean }): SharpInstance\n  png(): SharpInstance\n  toBuffer(): Promise<Buffer>\n}\ntype SharpFactory = (input: Buffer) => SharpInstance\n\n/**\n * Build a preprocessor over an injected `sharp` factory: grayscale → contrast\n * normalise → light denoise → sharpen → upscale small images. This lifts faint\n * document text and the OCR-B MRZ band without the aggressive binarisation that\n * destroys detail under uneven lighting. Any failure falls back to the original.\n */\nexport function buildSharpPreprocessor(sharp: SharpFactory, options: PreprocessOptions = {}): OcrPreprocessor {\n  const minWidth = options.minWidth ?? 1600\n  return async (image) => {\n    try {\n      const input = Buffer.from(image)\n      const base = sharp(input)\n      const { width } = await base.metadata()\n      let pipe = sharp(input).grayscale().normalise().median(1).sharpen()\n      if (width && width < minWidth) {\n        pipe = pipe.resize({ width: minWidth, withoutEnlargement: false })\n      }\n      const out = await pipe.png().toBuffer()\n      return new Uint8Array(out)\n    } catch {\n      return image\n    }\n  }\n}\n\nlet cached: OcrPreprocessor | undefined\n\n/**\n * The default preprocessor, backed by the optional `sharp` package and resolved\n * once. If `sharp` isn't installed it degrades to {@link passthrough}, so OCR\n * still runs on the raw bytes (just without the legibility boost).\n */\nexport async function defaultPreprocessor(options: PreprocessOptions = {}): Promise<OcrPreprocessor> {\n  if (cached) return cached\n  const moduleName = 'sharp'\n  try {\n    const mod = (await import(/* @vite-ignore */ moduleName)) as unknown as { default: SharpFactory }\n    cached = buildSharpPreprocessor(mod.default, options)\n  } catch {\n    cached = passthrough\n  }\n  return cached\n}\n"],"mappings":";;AAiBA,MAAa,cAA+B,OAAO,UAAU;;;;;;;AAqB7D,SAAgB,uBAAuB,OAAqB,UAA6B,CAAC,GAAoB;CAC5G,MAAM,WAAW,QAAQ,YAAY;CACrC,OAAO,OAAO,UAAU;EACtB,IAAI;GACF,MAAM,QAAQ,OAAO,KAAK,KAAK;GAE/B,MAAM,EAAE,UAAU,MADL,MAAM,KACQ,CAAC,CAAC,SAAS;GACtC,IAAI,OAAO,MAAM,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;GAClE,IAAI,SAAS,QAAQ,UACnB,OAAO,KAAK,OAAO;IAAE,OAAO;IAAU,oBAAoB;GAAM,CAAC;GAEnE,MAAM,MAAM,MAAM,KAAK,IAAI,CAAC,CAAC,SAAS;GACtC,OAAO,IAAI,WAAW,GAAG;EAC3B,QAAQ;GACN,OAAO;EACT;CACF;AACF;AAEA,IAAI;;;;;;AAOJ,eAAsB,oBAAoB,UAA6B,CAAC,GAA6B;CACnG,IAAI,QAAQ,OAAO;CACnB,MAAM,aAAa;CACnB,IAAI;EAEF,SAAS,wBAAuB,MADb;;GAA0B;GACT,SAAS,OAAO;CACtD,QAAQ;EACN,SAAS;CACX;CACA,OAAO;AACT"}
+{"version":3,"file":"preprocess.mjs","names":[],"sources":["../../src/drivers/preprocess.ts"],"sourcesContent":["/**\n * Transforms raw image bytes to improve OCR legibility. Returns the (possibly\n * unchanged) bytes — a preprocessor must never throw; on failure it returns the\n * input so recognition still runs.\n */\nexport type OcrPreprocessor = (image: Uint8Array) => Promise<Uint8Array>\n\n/** Tunables for the default {@link sharpPreprocessor}. */\nexport interface PreprocessOptions {\n  /**\n   * Upscale images narrower than this (px) to give the engine more pixels per\n   * glyph — the single biggest win for the small OCR-B MRZ band. Default 1600.\n   */\n  minWidth?: number\n}\n\n/** A no-op preprocessor: passes the original bytes through unchanged. */\nexport const passthrough: OcrPreprocessor = async (image) => image\n\n/** Minimal structural type for the lazily-imported `sharp` module. */\ninterface SharpInstance {\n  metadata(): Promise<{ width?: number; height?: number }>\n  grayscale(): SharpInstance\n  normalise(): SharpInstance\n  median(size: number): SharpInstance\n  sharpen(): SharpInstance\n  resize(options: { width: number; withoutEnlargement: boolean }): SharpInstance\n  png(): SharpInstance\n  toBuffer(): Promise<Buffer>\n}\ntype SharpFactory = (input: Buffer) => SharpInstance\n\n/**\n * Build a preprocessor over an injected `sharp` factory: grayscale → contrast\n * normalise → light denoise → sharpen → upscale small images. This lifts faint\n * document text and the OCR-B MRZ band without the aggressive binarisation that\n * destroys detail under uneven lighting. Any failure falls back to the original.\n */\nexport function buildSharpPreprocessor(sharp: SharpFactory, options: PreprocessOptions = {}): OcrPreprocessor {\n  const minWidth = options.minWidth ?? 1600\n  return async (image) => {\n    try {\n      const input = Buffer.from(image)\n      const base = sharp(input)\n      const { width } = await base.metadata()\n      let pipe = sharp(input).grayscale().normalise().median(1).sharpen()\n      if (width && width < minWidth) {\n        pipe = pipe.resize({ width: minWidth, withoutEnlargement: false })\n      }\n      const out = await pipe.png().toBuffer()\n      return new Uint8Array(out)\n    } catch {\n      return image\n    }\n  }\n}\n\nlet cached: OcrPreprocessor | undefined\n\n/**\n * The default preprocessor, backed by the optional `sharp` package and resolved\n * once. If `sharp` isn't installed it degrades to {@link passthrough}, so OCR\n * still runs on the raw bytes (just without the legibility boost).\n */\nexport async function defaultPreprocessor(options: PreprocessOptions = {}): Promise<OcrPreprocessor> {\n  if (cached) return cached\n  const moduleName = 'sharp'\n  try {\n    const mod = (await import(/* @vite-ignore */ moduleName)) as unknown as { default: SharpFactory }\n    cached = buildSharpPreprocessor(mod.default, options)\n  } catch {\n    cached = passthrough\n  }\n  return cached\n}\n"],"mappings":";;AAiBA,MAAa,cAA+B,OAAO,UAAU;;;;;;;AAqB7D,SAAgB,uBAAuB,OAAqB,UAA6B,CAAC,GAAoB;CAC5G,MAAM,WAAW,QAAQ,YAAY;CACrC,OAAO,OAAO,UAAU;EACtB,IAAI;GACF,MAAM,QAAQ,OAAO,KAAK,KAAK;GAE/B,MAAM,EAAE,UAAU,MADL,MAAM,KACQ,CAAC,CAAC,SAAS;GACtC,IAAI,OAAO,MAAM,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;GAClE,IAAI,SAAS,QAAQ,UACnB,OAAO,KAAK,OAAO;IAAE,OAAO;IAAU,oBAAoB;GAAM,CAAC;GAEnE,MAAM,MAAM,MAAM,KAAK,IAAI,CAAC,CAAC,SAAS;GACtC,OAAO,IAAI,WAAW,GAAG;EAC3B,QAAQ;GACN,OAAO;EACT;CACF;AACF;AAEA,IAAI;;;;;;AAOJ,eAAsB,oBAAoB,UAA6B,CAAC,GAA6B;CACnG,IAAI,QAAQ,OAAO;CACnB,MAAM,aAAa;CACnB,IAAI;EAEF,SAAS,wBAAuB,MADb;;GAA0B;EACV,CAAC,SAAS,OAAO;CACtD,QAAQ;EACN,SAAS;CACX;CACA,OAAO;AACT"}

package/dist/drivers/tesseract.d.mts

@@ -2,10 +2,9 @@ import { OcrDriver, OcrRequest } from "../types.mjs";
 import { DocumentParserRegistry } from "../parsers/registry.mjs";
 import { OcrPreprocessor } from "./preprocess.mjs";
 import { OcrResultData } from "@arkyc/types";
-
 //#region src/drivers/tesseract.d.ts
 /** Options for a single recognition pass. */
-interface RecognizeOptions {
+export interface RecognizeOptions {
   /**
    * Constrain recognition to the {@link MRZ_CHARSET}. This forces ambiguous OCR-B
    * glyphs into the machine-readable zone's alphabet (e.g. `O`→`0`, `I`→`1`),
@@ -14,11 +13,11 @@ interface RecognizeOptions {
   mrz?: boolean;
 }
 /** Reads text from an image; returns text + an engine confidence in [0, 100]. */
-type TesseractRecognize = (image: Uint8Array, language: string, options?: RecognizeOptions) => Promise<{
+export type TesseractRecognize = (image: Uint8Array, language: string, options?: RecognizeOptions) => Promise<{
   text: string;
   confidence: number;
 }>;
-interface TesseractOcrOptions {
+export interface TesseractOcrOptions {
   /** Recognition language(s), default `eng`. */
   language?: string;
   /**
@@ -40,7 +39,7 @@ interface TesseractOcrOptions {
  * runs it through the {@link DocumentParserRegistry} to extract structured fields.
  * `tesseract.js` is imported lazily so it is only loaded when this driver runs.
  */
-declare class TesseractOcrDriver implements OcrDriver {
+export declare class TesseractOcrDriver implements OcrDriver {
   readonly name = "tesseract";
   private readonly language;
   private readonly registry;
@@ -71,5 +70,4 @@ declare class TesseractOcrDriver implements OcrDriver {
   private loadRecognizer;
 }
 //#endregion
-export { RecognizeOptions, TesseractOcrDriver, TesseractOcrOptions, TesseractRecognize };
 //# sourceMappingURL=tesseract.d.mts.map

package/dist/drivers/tesseract.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"tesseract.d.mts","names":[],"sources":["../../src/drivers/tesseract.ts"],"mappings":";;;;;;;UAeiB,gBAAA;EAAA;;;;AAMZ;EAAH,GAAG;AAAA;;KAIO,kBAAA,IACV,KAAA,EAAO,UAAA,EACP,QAAA,UACA,OAAA,GAAU,gBAAA,KACP,OAAA;EAAU,IAAA;EAAc,UAAA;AAAA;AAAA,UA0BZ,mBAAA;EA7BR;EA+BP,QAAA;EA9BA;;;;EAmCA,QAAA,GAAW,sBAAA;EAjCgB;EAmC3B,SAAA,GAAY,kBAAA;EAnCyB;AA0BvC;;;;EAeE,UAAA,GAAa,eAAA;AAAA;;;;;;cAQF,kBAAA,YAA8B,SAAA;EAAA,SAChC,IAAA;EAAA,iBACQ,QAAA;EAAA,iBACA,QAAA;EAAA,iBACA,aAAA;EAAA,iBACA,gBAAA;EAAA,QACT,cAAA;cAEI,OAAA,GAAS,mBAAA;EAOf,OAAA,CAAQ,OAAA,EAAS,UAAA,GAAa,OAAA,CAAQ,aAAA;EAPvB;EAAA,QA2Db,MAAA;EApDoC;EAAA,QAgEpC,KAAA;EA/EiC;;;;;;;;;EAAA,QA0GjC,eAAA;;UAOM,YAAA;EAzGF;EAAA,QAuHE,UAAA;EAhHS;EAAA,QAyHT,cAAA;AAAA"}
+{"version":3,"file":"tesseract.d.mts","names":[],"sources":["../../src/drivers/tesseract.ts"],"mappings":";;;;;;iBAeiB;;;;;;EAMf;;;YAIU,sBACV,OAAO,YACP,kBACA,UAAU,qBACP;EAAU;EAAc;;iBA0BZ;;EAEf;;;;;EAKA,WAAW;;EAEX,YAAY;;;;;;EAMZ,aAAa;;;;;;;qBAQF,8BAA8B;WAChC;mBACQ;mBACA;mBACA;mBACA;UACT;EAEI,YAAA,UAAS;EAOf,QAAQ,SAAS,aAAa,QAAQ;;UAoDpC;;UAYA;;;;;;;;;;UA2BA;;UAOM;;UAcA;;UASA"}

package/dist/parsers/generic.d.mts

@@ -1,8 +1,6 @@
 import { DocumentParser } from "./types.mjs";
-
 //#region src/parsers/generic.d.ts
 /** The generic best-effort text parser. */
-declare function genericTextParser(): DocumentParser;
+export declare function genericTextParser(): DocumentParser;
 //#endregion
-export { genericTextParser };
 //# sourceMappingURL=generic.d.mts.map

package/dist/parsers/generic.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"generic.d.mts","names":[],"sources":["../../src/parsers/generic.ts"],"mappings":";;;;iBA0FgB,iBAAA,IAAqB,cAAc"}
+{"version":3,"file":"generic.d.mts","names":[],"sources":["../../src/parsers/generic.ts"],"mappings":";;;wBA0FgB,qBAAqB"}

package/dist/parsers/mrz.d.mts

@@ -1,8 +1,6 @@
 import { DocumentParser } from "./types.mjs";
-
 //#region src/parsers/mrz.d.ts
 /** The MRZ parser — a country-agnostic default for machine-readable documents. */
-declare function mrzParser(): DocumentParser;
+export declare function mrzParser(): DocumentParser;
 //#endregion
-export { mrzParser };
 //# sourceMappingURL=mrz.d.mts.map

package/dist/parsers/mrz.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"mrz.d.mts","names":[],"sources":["../../src/parsers/mrz.ts"],"mappings":";;;;iBAkKgB,SAAA,IAAa,cAAc"}
+{"version":3,"file":"mrz.d.mts","names":[],"sources":["../../src/parsers/mrz.ts"],"mappings":";;;wBAkKgB,aAAa"}

package/dist/parsers/registry.d.mts

@@ -1,9 +1,8 @@
 import { DocumentParser, ParseInput, ParseOutput } from "./types.mjs";
 import { DocumentType } from "@arkyc/types";
-
 //#region src/parsers/registry.d.ts
 /** Which stage of the pipeline produced a parse result. */
-type ParseStage = 'mrz' | 'custom' | 'generic';
+export type ParseStage = 'mrz' | 'custom' | 'generic';
 /**
  * A registry of document parsers, resolved in three stages for each document:
  *
@@ -15,7 +14,7 @@ type ParseStage = 'mrz' | 'custom' | 'generic';
  * Custom parsers declare the countries and document types they apply to; register
  * one per document layout the MRZ + generic stages can't read.
  */
-declare class DocumentParserRegistry {
+export declare class DocumentParserRegistry {
   private readonly primary;
   private readonly fallback;
   private readonly parsers;
@@ -45,10 +44,9 @@ declare class DocumentParserRegistry {
  * parser as the fallback. Register country/document-type-specific custom parsers
  * on top for documents the MRZ + generic stages can't read.
  */
-declare function createDocumentParserRegistry(options?: {
+export declare function createDocumentParserRegistry(options?: {
   primary?: DocumentParser;
   fallback?: DocumentParser;
 }): DocumentParserRegistry;
 //#endregion
-export { DocumentParserRegistry, ParseStage, createDocumentParserRegistry };
 //# sourceMappingURL=registry.d.mts.map

package/dist/parsers/registry.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.mts","names":[],"sources":["../../src/parsers/registry.ts"],"mappings":";;;;;KA0BY,UAAA;AAAZ;;;;AAAsB;AAatB;;;;;;AAbA,cAaa,sBAAA;EAAA,iBAQQ,OAAA;EAAA,iBACA,QAAA;EAAA,iBARF,OAAA;EA4CoB;;;;cArClB,OAAA,EAAS,cAAA,EACT,QAAA,EAAU,cAAA;;EAI7B,QAAA,CAAS,MAAA,EAAQ,cAAA;EALE;EAWnB,UAAA,CAAW,OAAA,kBAAyB,YAAA,GAAe,YAAA,UAAsB,cAAA;EAVtD;;;;EAAA,QAsBX,UAAA;EAZG;;;;;EA0BX,KAAA,CAAM,KAAA,EAAO,UAAA,GAAa,WAAA;AAAA;;;;AAAW;AAmCvC;iBAAgB,4BAAA,CACd,OAAA;EAAW,OAAA,GAAU,cAAA;EAAgB,QAAA,GAAW,cAAA;AAAA,IAC/C,sBAAA"}
+{"version":3,"file":"registry.d.mts","names":[],"sources":["../../src/parsers/registry.ts"],"mappings":";;;;YA0BY;;;;;;;;;;;;qBAaC;mBAQQ;mBACA;mBARF;;;;;EAOE,YAAA,SAAS,gBACT,UAAU;;EAI7B,SAAS,QAAQ;;EAMjB,WAAW,yBAAyB,eAAe,sBAAsB;;;;;UAYjE;;;;;;EAcR,MAAM,OAAO,aAAa;;;;;;;wBAmCZ,6BACd;EAAW,UAAU;EAAgB,WAAW;IAC/C"}

package/dist/parsers/types.d.mts

@@ -1,8 +1,7 @@
 import { DocumentType, OcrFields } from "@arkyc/types";
-
 //#region src/parsers/types.d.ts
 /** The OCR text + context handed to a document parser. */
-interface ParseInput {
+export interface ParseInput {
   /** Full OCR text for the document (raw engine output). */
   text: string;
   /** Pre-split lines; derived from `text` when omitted. */
@@ -13,7 +12,7 @@ interface ParseInput {
   country?: string | null;
 }
 /** A parser's structured result. */
-interface ParseOutput {
+export interface ParseOutput {
   fields: OcrFields;
   /** Confidence in this parse, 0–1. */
   confidence: number;
@@ -26,7 +25,7 @@ interface ParseOutput {
  * those against the user's selection to pick the most specific parser, and falls
  * back to the default when none match (or none can parse the text).
  */
-interface DocumentParser {
+export interface DocumentParser {
   readonly name: string;
   /**
    * ISO-3166 country codes (alpha-2 or alpha-3) this parser applies to. Omit (or
@@ -39,5 +38,4 @@ interface DocumentParser {
   parse(input: ParseInput): ParseOutput | null;
 }
 //#endregion
-export { DocumentParser, ParseInput, ParseOutput };
 //# sourceMappingURL=types.d.mts.map

package/dist/parsers/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/parsers/types.ts"],"mappings":";;;;UAGiB,UAAA;EAAA;EAEf,IAAA;;EAEA,KAAA;EAFA;EAIA,YAAA,GAAe,YAAY;EAA3B;EAEA,OAAA;AAAA;;UAIe,WAAA;EACf,MAAA,EAAQ,SAAS;EADS;EAG1B,UAAA;EAFiB;EAIjB,GAAA;AAAA;;;;AAAG;AASL;;UAAiB,cAAA;EAAA,SACN,IAAA;EASI;;;;EAAA,SAJJ,SAAA;EAAA;EAAA,SAEA,aAAA,YAAyB,YAAA;EAAA;EAElC,KAAA,CAAM,KAAA,EAAO,UAAA,GAAa,WAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/parsers/types.ts"],"mappings":";;;iBAGiB;;EAEf;;EAEA;;EAEA,eAAe;;EAEf;;;iBAIe;EACf,QAAQ;;EAER;;EAEA;;;;;;;;iBASe;WACN;;;;;WAKA;;WAEA,yBAAyB;;EAElC,MAAM,OAAO,aAAa"}

package/dist/registry.d.mts

@@ -1,12 +1,11 @@
 import { OcrConfig, OcrDriver } from "./types.mjs";
-
 //#region src/registry.d.ts
 /**
  * Selects an OCR driver from config. Call sites depend only on the
  * {@link OcrDriver} interface, so swapping `config.driver` changes behaviour
  * with no other changes.
  */
-declare class OcrDriverFactory {
+export declare class OcrDriverFactory {
   /**
    * Resolve the OCR driver named by `config`.
    *
@@ -16,5 +15,4 @@ declare class OcrDriverFactory {
   static create(config: OcrConfig): OcrDriver;
 }
 //#endregion
-export { OcrDriverFactory };
 //# sourceMappingURL=registry.d.mts.map

package/dist/registry.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.mts","names":[],"sources":["../src/registry.ts"],"mappings":";;;;;AAYA;;;cAAa,gBAAA;EAOJ;;;;;AAAoC;EAApC,OAAA,MAAA,CAAO,MAAA,EAAQ,SAAA,GAAY,SAAS;AAAA"}
+{"version":3,"file":"registry.d.mts","names":[],"sources":["../src/registry.ts"],"mappings":";;;;;;;qBAYa;;;;;;;SAOJ,OAAO,QAAQ,YAAY"}

package/dist/types.d.mts

@@ -1,9 +1,8 @@
 import { AiOcrProvider } from "./drivers/ai.mjs";
 import { DocumentType, OcrResultData } from "@arkyc/types";
-
 //#region src/types.d.ts
 /** The bytes + context handed to an OCR driver for extraction. */
-interface OcrRequest {
+export interface OcrRequest {
   /** Raw document-front image bytes. */
   image: Uint8Array;
   /**
@@ -28,14 +27,14 @@ interface OcrRequest {
   };
 }
 /** A pluggable OCR provider. */
-interface OcrDriver {
+export interface OcrDriver {
   readonly name: string;
   extract(request: OcrRequest): Promise<OcrResultData>;
 }
 /** Identifier for a registered OCR driver. */
-type OcrDriverName = 'mock' | 'tesseract' | 'external' | 'ai';
+export type OcrDriverName = 'mock' | 'tesseract' | 'external' | 'ai';
 /** Configuration selecting + parameterising the active OCR driver. */
-interface OcrConfig {
+export interface OcrConfig {
   driver: OcrDriverName;
   /** Base URL for the `external` driver, or API base override for `ai`. */
   endpoint?: string;
@@ -52,5 +51,4 @@ interface OcrConfig {
   maxEdge?: number;
 }
 //#endregion
-export { OcrConfig, OcrDriver, OcrDriverName, OcrRequest };
 //# sourceMappingURL=types.d.mts.map

package/dist/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;UAIiB,UAAA;EAAA;EAEf,KAAA,EAAO,UAAA;;;;;EAKP,SAAA,GAAY,UAAA;EAEe;EAA3B,YAAA,GAAe,YAAA;EAPR;EASP,OAAA;EAJY;;;;EASZ,KAAA;IACE,UAAA;IACA,OAAA;IACA,QAAA;IACA,WAAA;IACA,cAAA;EAAA;AAAA;AAKJ;AAAA,UAAiB,SAAA;EAAA,SACN,IAAA;EACT,OAAA,CAAQ,OAAA,EAAS,UAAA,GAAa,OAAA,CAAQ,aAAA;AAAA;;KAI5B,aAAA;;UAGK,SAAA;EACf,MAAA,EAAQ,aAAA;EARS;EAUjB,QAAA;EACA,MAAA;EAXsC;EAatC,QAAA;EAbmD;EAenD,UAAA,GAAa,aAAa;EAXH;EAavB,SAAA;EAbuB;EAevB,KAAA;EAZe;EAcf,OAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";;;;iBAIiB;;EAEf,OAAO;;;;;EAKP,YAAY;;EAEZ,eAAe;;EAEf;;;;;EAKA;IACE;IACA;IACA;IACA;IACA;;;;iBAKa;WACN;EACT,QAAQ,SAAS,aAAa,QAAQ;;;YAI5B;;iBAGK;EACf,QAAQ;;EAER;EACA;;EAEA;;EAEA,aAAa;;EAEb;;EAEA;;EAEA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkyc/ocr",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Driver-based OCR extraction",
   "license": "MIT",
   "keywords": [
@@ -37,7 +37,7 @@
     "dist"
   ],
   "dependencies": {
-    "@arkyc/types": "^2.0.0"
+    "@arkyc/types": "^2.1.0"
   },
   "optionalDependencies": {
     "sharp": "^0.33.5",