@abyss-project/extract 0.0.0-stage → 1.0.0

package/src/types/enum/extract-bank.enum.ts

@@ -0,0 +1,363 @@
+// ──────────────────────────────────────────────
+// Extract — Formal catalogue of supported banks and versions.
+//
+// Mirrors the server-side registry (BANK_VERSIONS in abyss-tools/apps/api).
+// Use these enums whenever you reference a bank or version in hint mode,
+// UI dropdowns, or per-bank metrics. Adding a bank?
+//   1. Add the entry to BANK_VERSIONS in apps/api.
+//   2. Add the matching id here. CI will catch any mismatch.
+// ──────────────────────────────────────────────
+
+/**
+ * Stable id of a bank+version profile. The wire-format string used in
+ * `hint.bank` (POST /rcb/extract mode=hint) and returned in
+ * extraction.strategy_used.
+ */
+export enum ExtractBankVersionId {
+  BNP_CONNEXIS_DEFAULT = 'bnp-connexis-default',
+  BNP_PARIBAS_DEFAULT = 'bnp-paribas-default',
+  SOCIETE_GENERALE_DEFAULT = 'societe-generale-default',
+  CREDIT_AGRICOLE_DEFAULT = 'credit-agricole-default',
+  LCL_DEFAULT = 'lcl-default',
+  BOURSORAMA_DEFAULT = 'boursorama-default',
+  SPENDESK_DEFAULT = 'spendesk-default',
+  LA_BANQUE_POSTALE_DEFAULT = 'la-banque-postale-default',
+  CAISSE_EPARGNE_DEFAULT = 'caisse-epargne-default',
+  THEMIS_DEFAULT = 'themis-default',
+  CIC_EBICS_DEFAULT = 'cic-ebics-default',
+  CIC_DEFAULT = 'cic-default',
+  CREDIT_MUTUEL_DEFAULT = 'credit-mutuel-default',
+  N26_DEFAULT = 'n26-default',
+  REVOLUT_DEFAULT = 'revolut-default',
+  HSBC_DEFAULT = 'hsbc-default',
+  HSBC_UK_DEFAULT = 'hsbc-uk-default',
+  WISE_DEFAULT = 'wise-default',
+  CREDIT_DU_NORD_DEFAULT = 'cdn-default',
+  BRED_DEFAULT = 'bred-default',
+  QONTO_DEFAULT = 'qonto-default',
+  SHINE_DEFAULT = 'shine-default',
+  SWAN_DEFAULT = 'swan-default',
+  ROTHSCHILD_DEFAULT = 'rothschild-default',
+  FINOM_DEFAULT = 'finom-default',
+  TIIME_DEFAULT = 'tiime-default',
+  UBS_DEFAULT = 'ubs-default',
+  CAIXA_DEFAULT = 'caixa-default',
+  CDE_NET_DEFAULT = 'cde-net-default',
+  DELUBAC_DEFAULT = 'delubac-default',
+  AIRWALLEX_DEFAULT = 'airwallex-default',
+  PAYPAL_DEFAULT = 'paypal-default',
+  VIVA_WALLET_DEFAULT = 'viva-wallet-default',
+  PALATINE_DEFAULT = 'palatine-default',
+  NATIXIS_DEFAULT = 'natixis-default',
+  JPMORGAN_DEFAULT = 'jpmorgan-default',
+  LA_NEF_V1 = 'la-nef-v1',
+  LA_NEF_V2 = 'la-nef-v2',
+}
+
+/**
+ * Display catalogue — one entry per supported (bank, version) pair.
+ * Drives dropdowns, "supported banks" pages, and customer docs.
+ */
+export interface ExtractBankCatalogueEntry {
+  id: ExtractBankVersionId;
+  bank: string;
+  version: string;
+  country: 'FR' | 'UK' | 'CH' | 'US' | 'PT' | 'EU' | 'INTL';
+  type: 'retail' | 'business' | 'neobank' | 'fintech' | 'corporate';
+}
+
+export const EXTRACT_BANK_CATALOGUE: ReadonlyArray<ExtractBankCatalogueEntry> = [
+  // ─── French retail / business ─────────────
+  {
+    id: ExtractBankVersionId.BNP_CONNEXIS_DEFAULT,
+    bank: 'BNP Connexis',
+    version: 'default',
+    country: 'FR',
+    type: 'business',
+  },
+  {
+    id: ExtractBankVersionId.BNP_PARIBAS_DEFAULT,
+    bank: 'BNP Paribas',
+    version: 'default',
+    country: 'FR',
+    type: 'retail',
+  },
+  {
+    id: ExtractBankVersionId.SOCIETE_GENERALE_DEFAULT,
+    bank: 'Société Générale',
+    version: 'default',
+    country: 'FR',
+    type: 'retail',
+  },
+  {
+    id: ExtractBankVersionId.CREDIT_AGRICOLE_DEFAULT,
+    bank: 'Crédit Agricole',
+    version: 'default',
+    country: 'FR',
+    type: 'retail',
+  },
+  {
+    id: ExtractBankVersionId.LCL_DEFAULT,
+    bank: 'LCL',
+    version: 'default',
+    country: 'FR',
+    type: 'retail',
+  },
+  {
+    id: ExtractBankVersionId.BOURSORAMA_DEFAULT,
+    bank: 'Boursorama',
+    version: 'default',
+    country: 'FR',
+    type: 'retail',
+  },
+  {
+    id: ExtractBankVersionId.LA_BANQUE_POSTALE_DEFAULT,
+    bank: 'La Banque Postale',
+    version: 'default',
+    country: 'FR',
+    type: 'retail',
+  },
+  {
+    id: ExtractBankVersionId.CAISSE_EPARGNE_DEFAULT,
+    bank: "Caisse d'Épargne",
+    version: 'default',
+    country: 'FR',
+    type: 'retail',
+  },
+  {
+    id: ExtractBankVersionId.CIC_EBICS_DEFAULT,
+    bank: 'CIC',
+    version: 'ebics',
+    country: 'FR',
+    type: 'business',
+  },
+  {
+    id: ExtractBankVersionId.CIC_DEFAULT,
+    bank: 'CIC',
+    version: 'default',
+    country: 'FR',
+    type: 'retail',
+  },
+  {
+    id: ExtractBankVersionId.CREDIT_MUTUEL_DEFAULT,
+    bank: 'Crédit Mutuel',
+    version: 'default',
+    country: 'FR',
+    type: 'retail',
+  },
+  {
+    id: ExtractBankVersionId.BRED_DEFAULT,
+    bank: 'BRED',
+    version: 'default',
+    country: 'FR',
+    type: 'retail',
+  },
+  {
+    id: ExtractBankVersionId.CREDIT_DU_NORD_DEFAULT,
+    bank: 'Crédit du Nord',
+    version: 'default',
+    country: 'FR',
+    type: 'retail',
+  },
+  {
+    id: ExtractBankVersionId.CDE_NET_DEFAULT,
+    bank: 'CDE Net',
+    version: 'default',
+    country: 'FR',
+    type: 'business',
+  },
+  {
+    id: ExtractBankVersionId.DELUBAC_DEFAULT,
+    bank: 'Delubac',
+    version: 'default',
+    country: 'FR',
+    type: 'business',
+  },
+  {
+    id: ExtractBankVersionId.PALATINE_DEFAULT,
+    bank: 'Palatine',
+    version: 'default',
+    country: 'FR',
+    type: 'business',
+  },
+  {
+    id: ExtractBankVersionId.NATIXIS_DEFAULT,
+    bank: 'Natixis',
+    version: 'default',
+    country: 'FR',
+    type: 'corporate',
+  },
+  {
+    id: ExtractBankVersionId.THEMIS_DEFAULT,
+    bank: 'Themis Banque',
+    version: 'default',
+    country: 'FR',
+    type: 'business',
+  },
+  {
+    id: ExtractBankVersionId.ROTHSCHILD_DEFAULT,
+    bank: 'Rothschild Martin Maurel',
+    version: 'default',
+    country: 'FR',
+    type: 'corporate',
+  },
+  {
+    id: ExtractBankVersionId.LA_NEF_V1,
+    bank: 'La Nef',
+    version: 'v1',
+    country: 'FR',
+    type: 'retail',
+  },
+  {
+    id: ExtractBankVersionId.LA_NEF_V2,
+    bank: 'La Nef',
+    version: 'v2',
+    country: 'FR',
+    type: 'retail',
+  },
+
+  // ─── Neobanks / fintech ───────────────────
+  {
+    id: ExtractBankVersionId.QONTO_DEFAULT,
+    bank: 'Qonto',
+    version: 'default',
+    country: 'FR',
+    type: 'neobank',
+  },
+  {
+    id: ExtractBankVersionId.SHINE_DEFAULT,
+    bank: 'Shine',
+    version: 'default',
+    country: 'FR',
+    type: 'neobank',
+  },
+  {
+    id: ExtractBankVersionId.FINOM_DEFAULT,
+    bank: 'Finom',
+    version: 'default',
+    country: 'EU',
+    type: 'neobank',
+  },
+  {
+    id: ExtractBankVersionId.TIIME_DEFAULT,
+    bank: 'Tiime',
+    version: 'default',
+    country: 'FR',
+    type: 'neobank',
+  },
+  {
+    id: ExtractBankVersionId.SPENDESK_DEFAULT,
+    bank: 'Spendesk',
+    version: 'default',
+    country: 'FR',
+    type: 'fintech',
+  },
+  {
+    id: ExtractBankVersionId.SWAN_DEFAULT,
+    bank: 'Swan',
+    version: 'default',
+    country: 'FR',
+    type: 'fintech',
+  },
+  {
+    id: ExtractBankVersionId.N26_DEFAULT,
+    bank: 'N26',
+    version: 'default',
+    country: 'EU',
+    type: 'neobank',
+  },
+  {
+    id: ExtractBankVersionId.REVOLUT_DEFAULT,
+    bank: 'Revolut',
+    version: 'default',
+    country: 'EU',
+    type: 'neobank',
+  },
+  {
+    id: ExtractBankVersionId.WISE_DEFAULT,
+    bank: 'Wise',
+    version: 'default',
+    country: 'INTL',
+    type: 'fintech',
+  },
+  {
+    id: ExtractBankVersionId.PAYPAL_DEFAULT,
+    bank: 'PayPal',
+    version: 'default',
+    country: 'INTL',
+    type: 'fintech',
+  },
+  {
+    id: ExtractBankVersionId.AIRWALLEX_DEFAULT,
+    bank: 'Airwallex',
+    version: 'default',
+    country: 'INTL',
+    type: 'fintech',
+  },
+  {
+    id: ExtractBankVersionId.VIVA_WALLET_DEFAULT,
+    bank: 'Viva Wallet',
+    version: 'default',
+    country: 'EU',
+    type: 'fintech',
+  },
+
+  // ─── International retail / corporate ─────
+  {
+    id: ExtractBankVersionId.HSBC_DEFAULT,
+    bank: 'HSBC',
+    version: 'default',
+    country: 'FR',
+    type: 'retail',
+  },
+  {
+    id: ExtractBankVersionId.HSBC_UK_DEFAULT,
+    bank: 'HSBC UK',
+    version: 'default',
+    country: 'UK',
+    type: 'retail',
+  },
+  {
+    id: ExtractBankVersionId.UBS_DEFAULT,
+    bank: 'UBS',
+    version: 'default',
+    country: 'CH',
+    type: 'corporate',
+  },
+  {
+    id: ExtractBankVersionId.CAIXA_DEFAULT,
+    bank: 'Caixa',
+    version: 'default',
+    country: 'PT',
+    type: 'retail',
+  },
+  {
+    id: ExtractBankVersionId.JPMORGAN_DEFAULT,
+    bank: 'JPMorgan',
+    version: 'default',
+    country: 'US',
+    type: 'corporate',
+  },
+];
+
+/**
+ * Lookup by id (typed). Returns undefined for unknown ids — callers should
+ * treat that as "use auto mode" rather than crash.
+ */
+export function getExtractBankCatalogueEntry(id: string): ExtractBankCatalogueEntry | undefined {
+  return EXTRACT_BANK_CATALOGUE.find((e) => e.id === id);
+}
+
+/**
+ * Group catalogue entries by the bank display name. Useful for UIs that
+ * show "BNP Paribas" once with a sub-menu listing all supported versions.
+ */
+export function groupExtractCatalogueByBank(): Map<string, ExtractBankCatalogueEntry[]> {
+  const out = new Map<string, ExtractBankCatalogueEntry[]>();
+  for (const entry of EXTRACT_BANK_CATALOGUE) {
+    const list = out.get(entry.bank) ?? [];
+    list.push(entry);
+    out.set(entry.bank, list);
+  }
+  return out;
+}

package/src/types/enum/extract-field-format.enum.ts

@@ -0,0 +1,16 @@
+// ──────────────────────────────────────────────
+// ExtractFieldFormat — the shape of a published field value, so a client can
+// display it without knowing each key.
+// ──────────────────────────────────────────────
+
+export enum ExtractFieldFormat {
+  /** Integer amount in cents; the currency is the `currency` field. */
+  AMOUNT = 'amount',
+  /** ISO 8601 date (`YYYY-MM-DD`). */
+  DATE = 'date',
+  /** The percent itself: `9` for 9 %. */
+  PERCENT = 'percent',
+  BOOLEAN = 'boolean',
+  /** Free text or identifier (IBAN, SIRET, VAT number…), to display as is. */
+  TEXT = 'text',
+}

package/src/types/enum/extract-field-key.enum.ts

@@ -0,0 +1,77 @@
+// ──────────────────────────────────────────────
+// ExtractFieldKey — every field key AbyssExtract can publish for a known
+// document type (`generic` excluded: its fields are defined by the client).
+// The value is the key found in `fields` of an extraction result. Which type
+// publishes which key, and in which format: `EXTRACT_PUBLISHABLE_FIELDS`.
+// A valid machine-readable zone publishes its fields and `mrzValid` whatever
+// the document type.
+// ──────────────────────────────────────────────
+
+export enum ExtractFieldKey {
+  // Amounts
+  TOTAL_TTC = 'totalTtc',
+  TOTAL_HT = 'totalHt',
+  TOTAL_VAT = 'totalVat',
+  TOTAL = 'total',
+  VAT = 'vat',
+  OPENING_BALANCE = 'openingBalance',
+  CLOSING_BALANCE = 'closingBalance',
+  TOTAL_ACTIF = 'totalActif',
+  TOTAL_PASSIF = 'totalPassif',
+  FIXED_ASSETS = 'fixedAssets',
+  CURRENT_ASSETS = 'currentAssets',
+  CREDITORS_WITHIN_ONE_YEAR = 'creditorsWithinOneYear',
+  NET_CURRENT_LIABILITIES = 'netCurrentLiabilities',
+  TOTAL_ASSETS_LESS_CURRENT_LIABILITIES = 'totalAssetsLessCurrentLiabilities',
+  NET_ASSETS = 'netAssets',
+  CALLED_UP_SHARE_CAPITAL = 'calledUpShareCapital',
+  PROFIT_AND_LOSS_ACCOUNT = 'profitAndLossAccount',
+  TOTAL_SHAREHOLDERS_FUNDS = 'totalShareholdersFunds',
+  NET_CENTS = 'netCents',
+  GROSS_CENTS = 'grossCents',
+  NET_TAXABLE_CENTS = 'netTaxableCents',
+  PAS_AMOUNT_CENTS = 'pasAmountCents',
+  // Dates
+  INVOICE_DATE = 'invoiceDate',
+  DUE_DATE = 'dueDate',
+  DATE = 'date',
+  PERIOD_START = 'periodStart',
+  PERIOD_END = 'periodEnd',
+  FISCAL_YEAR_END = 'fiscalYearEnd',
+  BIRTH_DATE = 'birthDate',
+  EXPIRY_DATE = 'expiryDate',
+  ISSUE_DATE = 'issueDate',
+  // Percentages
+  PAS_RATE_PCT = 'pasRatePct',
+  // Identifiers
+  IBAN = 'iban',
+  BIC = 'bic',
+  SIRET = 'siret',
+  SIREN = 'siren',
+  VAT_NUMBER = 'vatNumber',
+  INVOICE_NUMBER = 'invoiceNumber',
+  DOCUMENT_NUMBER = 'documentNumber',
+  REGISTRATION_NUMBER = 'registrationNumber',
+  // Names and labels
+  SUPPLIER = 'supplier',
+  SUPPLIER_LEGAL_NAME = 'supplierLegalName',
+  MARKETPLACE = 'marketplace',
+  MERCHANT = 'merchant',
+  HOLDER_NAME = 'holderName',
+  BANK_NAME = 'bankName',
+  COMPANY = 'company',
+  EMPLOYER = 'employer',
+  LAST_NAME = 'lastName',
+  FIRST_NAMES = 'firstNames',
+  NATIONALITY = 'nationality',
+  /** ISO 4217 code of the published amounts. */
+  CURRENCY = 'currency',
+  /** Payslip period label: an ISO month (`2026-06`) or a day range (`2026-06-01..2026-06-30`). */
+  PERIOD = 'period',
+  // Machine-readable zone of an identity document
+  SEX = 'sex',
+  ISSUING_COUNTRY = 'issuingCountry',
+  DOCUMENT_KIND = 'documentKind',
+  /** Whether the check digits of the machine-readable zone are correct. */
+  MRZ_VALID = 'mrzValid',
+}

package/src/types/enum/extraction-feedback-issue-type.enum.ts

@@ -0,0 +1,10 @@
+// Global, document-type-agnostic feedback issue taxonomy for AbyssExtract.
+// fieldKey localizes the issue to a specific extracted field when relevant.
+export enum ExtractionFeedbackIssueType {
+  WRONG_VALUE = 'WRONG_VALUE',
+  MISSING_FIELD = 'MISSING_FIELD',
+  WRONG_DOCUMENT_TYPE = 'WRONG_DOCUMENT_TYPE',
+  EXTRA_RECORD = 'EXTRA_RECORD',
+  WRONG_RECORD = 'WRONG_RECORD',
+  OTHER = 'OTHER',
+}

package/src/types/enum/extraction-step-status.enum.ts

@@ -0,0 +1,7 @@
+/** Terminal disposition of a single plan pass in the execution trace (P1). Mirrors server. */
+export enum ExtractionStepStatus {
+  RAN = 'ran',
+  SKIPPED_BY_GATE = 'skippedByGate',
+  TIMEOUT = 'timeout',
+  FAILED = 'failed',
+}

package/src/types/enum/extraction-warning.enum.ts

@@ -0,0 +1,78 @@
+// ──────────────────────────────────────────────
+// ExtractionWarningCode — structured warning codes emitted by the extraction
+// orchestrator. The `code` is the i18n key suffix; `data` carries numeric/
+// string values the UI formats locally (currencies, dates, etc.).
+// ──────────────────────────────────────────────
+
+export enum ExtractionWarningCode {
+  NO_RECORDS = 'no_records',
+  NO_IBAN = 'no_iban',
+  NO_BALANCES = 'no_balances',
+  BALANCE_MISMATCH = 'balance_mismatch',
+  /**
+   * A coherence validation error produced by an adapter's `validate()` call.
+   * `data.type` carries the adapter-specific error/warning type (e.g.
+   * `ACTIF_PASSIF_MISMATCH`, `TOTAL_MISMATCH`, `MRZ_INVALID`) and
+   * `data.message` carries the human-readable explanation. This allows
+   * arbitrary adapter validation results to surface without extending the
+   * enum for each domain-specific rule.
+   */
+  ADAPTER_VALIDATION_ERROR = 'adapter_validation_error',
+  /**
+   * A field was extracted but NOT published, because its calibrated confidence
+   * fell below the publish floor for its (documentType, fieldKey).
+   *
+   * This is deliberately its own code rather than an `ADAPTER_VALIDATION_ERROR`
+   * carrying a `data.type`. Suppression is a first-class product behaviour a
+   * client must be able to detect reliably — «did the engine find nothing, or
+   * did it find something it judged not worth sending?» are two different
+   * questions, and a client should not have to parse a free-text field to tell
+   * them apart.
+   *
+   * `data.fieldKey` names the field, `data.confidence` its calibrated value and
+   * `data.floor` the threshold it missed. The value itself is never in the
+   * warning: it stays in `provenance`, flagged `suppressed`.
+   */
+  FIELD_BELOW_PUBLISH_FLOOR = 'field_below_publish_floor',
+  /**
+   * A date field was extracted but NOT published, because nothing besides its
+   * format supported it: no label next to it, and it did not sit in the page
+   * band the document type expects for that field (#575).
+   *
+   * This is deliberately its own code rather than folded into
+   * `FIELD_BELOW_PUBLISH_FLOOR`: the confidence can sit ABOVE the field's
+   * publish floor (corroboration alone can carry a format-only date from 0.42
+   * to 0.565) and still not be published — a client checking only the floor
+   * would see no reason for the field's absence. Suppression is a first-class
+   * product behaviour a client must be able to detect reliably, here as much
+   * as for a below-floor drop.
+   *
+   * `data.fieldKey` names the field, `data.confidence` its calibrated value.
+   * The value itself is never in the warning: it stays in internal
+   * traceability only (`suppressedFields`, reason `format_only_date`), which
+   * is neither persisted nor returned to the client — only this warning is.
+   */
+  FIELD_FORMAT_ONLY_DATE = 'field_format_only_date',
+  /**
+   * A field of an identity document's machine-readable zone was read but NOT
+   * published, because its value lies outside the domain the zone allows
+   * (#614): a sex other than `M`, `F` or `X`, or a nationality or issuing
+   * state that is neither an ISO 3166-1 alpha-3 code nor one of the special
+   * codes of ICAO Doc 9303 part 3 (`D`, `UNO`, `XXA`, `RKS`…).
+   *
+   * These three fields are covered by no check digit, not even the composite
+   * one: a misread letter there leaves every key closing. The domain is the
+   * only check the zone itself offers for them, and a value that fails it is
+   * withheld rather than published at full confidence.
+   *
+   * This is deliberately its own code: the zone is valid and its other fields
+   * are published, so neither `FIELD_BELOW_PUBLISH_FLOOR` nor an
+   * `ADAPTER_VALIDATION_ERROR` of type `MRZ_INVALID` would tell the client why
+   * this one field is missing.
+   *
+   * `data.fieldKey` names the field. The value itself is never in the warning:
+   * it stays in internal traceability only (`suppressedFields`, reason
+   * `mrz_out_of_domain`), which is neither persisted nor returned to the client.
+   */
+  FIELD_MRZ_OUT_OF_DOMAIN = 'field_mrz_out_of_domain',
+}

package/src/types/enum/file-scan-status.enum.ts

@@ -0,0 +1,33 @@
+/**
+ * Antivirus scan verdict for a stored file, mirrored from AbyssStorage.
+ *
+ * Same vocabulary as `@abyss-project/storage`'s `FileScanStatus` enum
+ * (`application_files.scanStatus`): `pending_scan` | `clean` | `infected` |
+ * `skipped` | `error`. Intentionally re-declared here as a string union — NOT
+ * imported — because abyss-tools-core is standalone (does not depend on
+ * `@abyss-project/storage`), the same approach every other core package
+ * (abyss-main asset-core, abyss-banking-core, abyss-memories-core) takes for
+ * a mirrored external vocabulary. `BeamFileScanStatus` (beam.enum.ts) mirrors
+ * the SAME storage vocabulary as a real TS enum instead: that shape fits
+ * beam, which converts a single Map of live-read values at ONE serialization
+ * boundary (an explicit `Record<FileScanStatus, BeamFileScanStatus>`
+ * suffices there). This column is denormalized and WRITTEN from several call
+ * sites (webhook UPLOAD seed, webhook SCAN_RESULT update, cloud-import
+ * mirror, archive-upload seed) — a string union lets the backend assign a
+ * storage `FileScanStatus` enum value straight into it with no cast (a
+ * string-enum member is assignable to a matching string-literal union, but
+ * NOT to a distinct local enum with identical values), avoiding a repeated
+ * conversion Record at every one of those sites. Keep the members in sync
+ * with storage's enum.
+ *
+ * Storage-neutral posture (ADR-0038): this field is purely informational —
+ * exposed so the front can render an AbyssProbe indicator (clean / "en
+ * analyse" / infected). Nothing in abyss-tools purges an infected row,
+ * redacts a servable id, or blocks a read while pending; the front decides
+ * what to show (e.g. blurring a pending thumbnail).
+ *
+ * Used by BoardCardDocument, AtlasDocument and ExtractionFile (the last only
+ * for an archive-owned row — see ExtractionFile.scanStatus's own doc
+ * comment).
+ */
+export type FileScanStatus = 'pending_scan' | 'clean' | 'infected' | 'skipped' | 'error';

package/src/types/enum/index.ts

@@ -0,0 +1,12 @@
+export * from './api-error.enum';
+export * from './document-type.enum';
+export * from './extract-bank.enum';
+export * from './extraction-warning.enum';
+export * from './extract-field-key.enum';
+export * from './extract-field-format.enum';
+export * from './extraction-feedback-issue-type.enum';
+export * from './provider-kind.enum';
+export * from './interpreter-kind.enum';
+export * from './combine-strategy.enum';
+export * from './extraction-step-status.enum';
+export * from './file-scan-status.enum';

package/src/types/enum/interpreter-kind.enum.ts

@@ -0,0 +1,7 @@
+// Interpreter kind enum — mirror apps/api interpreter.interface.ts exactly.
+
+export enum InterpreterKind {
+  ALGORITHMIC = 'algorithmic',
+  TEMPLATE = 'template',
+  LLM = 'llm',
+}

package/src/types/enum/provider-kind.enum.ts

@@ -0,0 +1,13 @@
+// Provider kind and cost tier enums — mirror apps/api provider.interface.ts exactly.
+
+export enum ProviderKind {
+  TEXT = 'text',
+  OCR = 'ocr',
+  AI = 'ai',
+}
+
+export enum CostTier {
+  CHEAP = 'cheap',
+  MEDIUM = 'medium',
+  EXPENSIVE = 'expensive',
+}

package/src/types/index.ts

@@ -0,0 +1,2 @@
+export * from './interface';
+export * from './enum';

package/src/types/interface/api/index.ts

@@ -0,0 +1,5 @@
+export * from './requests';
+export * from './responses';
+export * from './type-message/response';
+export * from './type-message/api-error';
+export * from './type-message/base-paginate';