extractia-sdk 1.0.6 → 1.2.0

package/src/index.d.ts

@@ -0,0 +1,746 @@
+// ─── Extractia SDK v1.1 — TypeScript type declarations ───────────────────────
+// Keep in sync with JavaScript source files.
+
+// ─── Primitives ───────────────────────────────────────────────────────────────
+
+/** Supported field types for a FormField. */
+export type FieldType =
+  | 'TEXT'
+  | 'NUMBER'
+  | 'PERCENTAGE'
+  | 'DATE'
+  | 'BOOLEAN'
+  | 'EMAIL'
+  | 'PHONE'
+  | 'ADDRESS'
+  | 'CURRENCY'
+  | 'LIST';
+
+/** A single field definition within a FormTemplate. */
+export interface FormField {
+  /** Display label shown in the UI (e.g. "Invoice Date"). */
+  label: string;
+  /** Data type used for extraction and rendering. */
+  type: FieldType;
+  /** Whether the field is required for extraction. */
+  required?: boolean;
+  /**
+   * Only present on LIST-type fields.
+   * Short singular noun for one item in the list (e.g. "Product", "LineItem").
+   */
+  listLabel?: string;
+}
+
+/** A template that defines the structure of documents to extract. */
+export interface FormTemplate {
+  id: string;
+  /** Template name shown in the UI. */
+  label: string;
+  /** Ordered list of fields to extract from each document. */
+  fields: FormField[];
+  /** MongoDB ID of the owning user. */
+  userId: string;
+  createdAt?: string;
+}
+
+/** Extracted JSON from a single document. Keys match the template's field labels. */
+export type ExtractionResult = Record<string, string | number | boolean | ExtractionResult | ExtractionResult[]>;
+
+/** A processed document stored in the platform. */
+export interface UserDocument {
+  id: string;
+  formTemplateId: string;
+  /** Raw AI extraction result (may be wrapped in markdown fences). */
+  rawJson?: string;
+  /** User-reviewed and potentially edited JSON. `null` if unreviewed. */
+  reviewedJson?: string | null;
+  /** Base64-encoded source image (only returned when `includeImage=1`). */
+  imageBase64?: string | null;
+  /** Whether the document has been reviewed/confirmed by a user. */
+  preconformed?: boolean;
+  /** Reviewer notes or annotations. */
+  notes?: string | null;
+  /** Document workflow status (e.g. "REVIEWED", "PENDING"). */
+  status?: string | null;
+  createdAt?: string;
+}
+
+/** Paginated document list response. */
+export interface DocumentPage {
+  content: UserDocument[];
+  totalPages: number;
+}
+
+/** Authenticated user profile returned by `/me`. */
+export interface AppUserProfile {
+  userId: string;
+  name?: string;
+  email: string;
+  signupDate?: string;
+  /** URL to receive webhook POST calls after document processing. */
+  webhook?: string | null;
+  /** Number of form templates owned. */
+  formTemplatesCount?: number;
+  /** Total documents processed (lifetime). */
+  documentsCount?: number;
+  /** Documents remaining in the current billing cycle (plan quota). */
+  documentsAvailableThisMonth?: number;
+  /** Extra/add-on documents available (purchased separately). */
+  extraDocsAvailable?: number;
+  tier?: object;
+  subscription?: object;
+}
+
+/** A single document processing audit entry (upload history). */
+export interface DocumentAuditEntry {
+  id?: string;
+  userId: string;
+  templateId?: string | null;
+  templateName?: string | null;
+  /** "SUCCESS" or "FAILURE". */
+  status: string;
+  uploadDate: string;
+  processingTimeMs?: number;
+  /** Number of pages processed. */
+  pages?: number;
+  /** Number of template fields. */
+  fields?: number;
+  errorMessage?: string | null;
+}
+
+/** A sub-user belonging to an account. */
+export interface SubUser {
+  username: string;
+  /** Granted permission strings (e.g. "upload", "view", "template", "settings", "export", "api"). */
+  permissions: string[];
+  /** Whether the sub-user is currently suspended. */
+  suspended: boolean;
+  /** Last known geographic location ("lat,lng" format). */
+  lastKnownLocation?: string | null;
+  lastLocationAt?: string | null;
+}
+
+/** AI credit balance. */
+export interface CreditsBalance {
+  monthlyBalance: number;
+  addonBalance: number;
+  totalBalance: number;
+}
+
+/** A single AI credit consumption log entry. */
+export interface CreditLogEntry {
+  id: string;
+  userId: string;
+  timestamp: string;
+  operation: string;
+  operationDetail?: string | null;
+  inputTokens?: number;
+  outputTokens?: number;
+  totalTokens?: number;
+  creditsConsumed: number;
+  /** Sub-user or API user who triggered the action. */
+  performedBy?: string | null;
+}
+
+/** OCR Tool output types. */
+export type OcrOutputType = 'YES_NO' | 'LABEL' | 'TEXT';
+
+/** An OCR Tool configuration. */
+export interface OcrToolConfig {
+  id?: string;
+  /** Human-friendly display name (e.g. "Proof of Residence Check"). */
+  name: string;
+  /**
+   * Natural-language instruction evaluated against the document image. Max 3 000 characters
+   * (after parameter substitution). May contain {{?1}}, {{?2}}, … placeholders.
+   */
+  prompt: string;
+  /** Expected output shape. */
+  outputType: OcrOutputType;
+  /**
+   * Required when `outputType === 'LABEL'`.
+   * List of possible labels the AI must pick from.
+   */
+  labels?: string[];
+  /**
+   * Dynamic parameter definitions for {{?N}} placeholders in `prompt`.
+   * At run time the caller supplies a value for each placeholder via `runOcrTool` `options.params`.
+   */
+  parameterDefinitions?: OcrParameterDefinition[];
+  createdAt?: string;
+}
+
+/** Configuration for a single dynamic {{?N}} placeholder in an OCR tool prompt. */
+export interface OcrParameterDefinition {
+  /** 1-based index matching the {{?N}} placeholder in the prompt. */
+  key: number;
+  /** Human-readable label shown in the UI and used in validation error messages. */
+  label: string;
+  /** Optional hint text displayed to the user when filling in this parameter. */
+  description?: string;
+  /**
+   * Maximum character count for this parameter's value (1–500, default 200).
+   * Affects the total substituted prompt length limit of 3 000 characters.
+   */
+  maxChars?: number;
+}
+
+/** Options accepted by {@link runOcrTool}. */
+export interface OcrRunOptions {
+  /**
+   * Values for {{?N}} placeholders, keyed by the string form of the placeholder index (e.g. `"1"`, `"2"`).
+   * Each value must not exceed the parameter's `maxChars` limit.
+   */
+  params?: Record<string, string>;
+}
+
+/** Result returned after running an OCR tool. */
+export interface OcrRunResult {
+  /** The AI's answer (e.g. "YES", "invoice", or free-form text). */
+  answer: string;
+  /** Short rationale explaining the answer. */
+  explanation: string;
+}
+
+// ─── Error classes ────────────────────────────────────────────────────────────
+
+/** Base error class for all Extractia SDK errors. */
+export class ExtractiaError extends Error {
+  /** HTTP status code associated with the error. */
+  status: number;
+  constructor(message: string, status: number);
+}
+
+/** Thrown when the API token is missing or invalid (HTTP 401). */
+export class AuthError extends ExtractiaError {
+  constructor(message?: string);
+}
+
+/** Thrown when the account lacks permission to perform the action (HTTP 403). */
+export class ForbiddenError extends ExtractiaError {
+  constructor(message?: string);
+}
+
+/** Thrown when the active plan does not allow the requested operation (HTTP 402). */
+export class TierError extends ExtractiaError {
+  constructor(message?: string, status?: number);
+}
+
+/** Thrown when the API rate limit is exceeded (HTTP 429). */
+export class RateLimitError extends ExtractiaError {
+  /** Seconds to wait before the next request. */
+  retryAfter?: number;
+  constructor(message?: string);
+}
+
+/** Thrown when a requested resource was not found (HTTP 404). */
+export class NotFoundError extends ExtractiaError {
+  constructor(message?: string);
+}
+
+// ─── Setup ────────────────────────────────────────────────────────────────────
+
+/**
+ * Sets the Bearer API token used for all subsequent requests.
+ * **Must be called before any SDK method.**
+ *
+ * @param token Your Extractia API token (from Account → API Tokens).
+ *
+ * @example
+ * import { setToken } from 'extractia-sdk';
+ * setToken('ext_live_...');
+ */
+export function setToken(token: string): void;
+
+/**
+ * Configures SDK options.
+ * @param opts
+ * @param [opts.baseURL] Override the default API base URL (useful for self-hosted instances).
+ */
+export function configure(opts: { baseURL?: string }): void;
+
+// ─── Auth / Profile ───────────────────────────────────────────────────────────
+
+/**
+ * Returns the profile and usage metrics of the authenticated user.
+ *
+ * @example
+ * const me = await getMyProfile();
+ * console.log(me.email, me.formTemplatesCount);
+ */
+export function getMyProfile(): Promise<AppUserProfile>;
+
+/**
+ * Updates the webhook URL for the authenticated user.
+ * All document processing completions will POST to this URL.
+ *
+ * @param url The new webhook URL. Pass an empty string to remove it.
+ *
+ * @example
+ * await updateWebhook('https://my-app.com/webhooks/extractia');
+ */
+export function updateWebhook(url: string): Promise<void>;
+
+// ─── Templates ────────────────────────────────────────────────────────────────
+
+/** Returns all templates belonging to the authenticated user. */
+export function getTemplates(): Promise<FormTemplate[]>;
+
+/**
+ * Returns a single template by its ID.
+ * @param id Template ID.
+ */
+export function getTemplateById(id: string): Promise<FormTemplate>;
+
+/**
+ * Returns a template by its label name.
+ * @param name Template label (case-sensitive).
+ */
+export function getTemplateByName(name: string): Promise<FormTemplate>;
+
+/**
+ * Creates a new template.
+ * @param template Template definition (omit `id` and `userId`).
+ *
+ * @example
+ * const tpl = await createTemplate({
+ *   label: 'Invoice',
+ *   fields: [
+ *     { label: 'Invoice Number', type: 'TEXT', required: true },
+ *     { label: 'Total Amount',   type: 'CURRENCY', required: true },
+ *     { label: 'Issue Date',     type: 'DATE',     required: false },
+ *   ]
+ * });
+ */
+export function createTemplate(template: Omit<FormTemplate, 'id' | 'userId'>): Promise<FormTemplate>;
+
+/**
+ * Updates an existing template.
+ * @param id       Template ID.
+ * @param template Partial template definition to merge.
+ */
+export function updateTemplate(id: string, template: Partial<FormTemplate>): Promise<FormTemplate>;
+
+/**
+ * Deletes a template by its ID.
+ * Templates with associated documents cannot be deleted — delete the documents first.
+ * @param id Template ID.
+ */
+export function deleteTemplate(id: string): Promise<void>;
+
+/**
+ * Deletes all documents associated with a template (does not delete the template itself).
+ * @param id Template ID.
+ */
+export function deleteAllTemplateDocuments(id: string): Promise<void>;
+
+/**
+ * Uses AI to suggest extraction field definitions for a given document type.
+ *
+ * @param templateName        Document type name (e.g. "Invoice", "Driver's License").
+ * @param extractionContext   Optional natural-language description of what to extract
+ *                            (e.g. "I need the line items including product name and quantity").
+ * @returns Array of field suggestions ready to use in `createTemplate`.
+ *
+ * @example
+ * const fields = await suggestFields('Purchase Order', 'list all ordered products');
+ * const tpl = await createTemplate({ label: 'Purchase Order', fields });
+ */
+export function suggestFields(
+  templateName: string,
+  extractionContext?: string
+): Promise<FormField[]>;
+
+// ─── Documents ────────────────────────────────────────────────────────────────
+
+/**
+ * Retrieves documents associated with a template (paginated, newest first).
+ *
+ * @param templateId Template ID.
+ * @param options    Query options.
+ *
+ * @example
+ * const page = await getDocumentsByTemplateId('tpl_123', { index: 0, preconformed: true });
+ */
+export function getDocumentsByTemplateId(
+  templateId: string,
+  options?: {
+    /** Filter by preconfirmed/reviewed status. */
+    preconformed?: boolean;
+    /** Zero-based page index. */
+    index?: number;
+    /** Sort direction: "1" = ASC, "-1" = DESC (default). */
+    sort?: string;
+    /** Whether to include the base64 source image in results. */
+    includeImage?: boolean;
+  }
+): Promise<DocumentPage>;
+
+/**
+ * Returns a single document by template ID and document ID.
+ *
+ * @param templateId   Template ID.
+ * @param docId        Document ID.
+ * @param options
+ * @param [options.includeImage] Whether to include the base64 source image.
+ */
+export function getDocumentById(
+  templateId: string,
+  docId: string,
+  options?: { includeImage?: boolean }
+): Promise<UserDocument>;
+
+/**
+ * Returns the N most-recent documents across all templates.
+ *
+ * @param size Maximum number of documents to return (default 10, max 50).
+ */
+export function getRecentDocuments(size?: number): Promise<UserDocument[]>;
+
+/**
+ * Deletes a document by its ID.
+ * @param documentId Document ID.
+ */
+export function deleteDocument(documentId: string): Promise<void>;
+
+/**
+ * Processes a single base64-encoded image against a template.
+ * AI extracts the fields defined in the template and stores the result.
+ *
+ * @param templateId  Template ID.
+ * @param base64Image Base64-encoded image (with or without `data:` prefix). Max 5 MB.
+ *
+ * @example
+ * const doc = await processImage('tpl_123', base64String);
+ * console.log(doc.rawJson); // Extracted JSON
+ */
+export function processImage(templateId: string, base64Image: string): Promise<UserDocument>;
+
+/**
+ * Processes multiple base64-encoded images as a multi-page document.
+ * All pages are merged into a single `UserDocument`.
+ *
+ * @param templateId       Template ID.
+ * @param base64ImagesArray Array of base64-encoded images (one per page, max 5 MB each).
+ */
+export function processImagesMultipage(
+  templateId: string,
+  base64ImagesArray: string[]
+): Promise<UserDocument>;
+
+/**
+ * Generates an AI bullet-point summary for the extracted data of a document.
+ * Consumes AI credits.
+ *
+ * @param docId Document ID.
+ *
+ * @example
+ * const { summary } = await generateDocumentSummary('doc_456');
+ * console.log(summary); // "• Invoice #1042 issued on Jan 5 2025..."
+ */
+export function generateDocumentSummary(docId: string): Promise<{ summary: string }>;
+
+/**
+ * Updates the workflow status of a document.
+ *
+ * @param docId  Document ID.
+ * @param status New status string (e.g. "REVIEWED", "APPROVED", "REJECTED").
+ */
+export function updateDocumentStatus(
+  docId: string,
+  status: string
+): Promise<{ id: string; status: string }>;
+
+/**
+ * Saves or clears reviewer notes on a document.
+ *
+ * @param docId  Document ID.
+ * @param notes  Annotation text. Pass an empty string to clear existing notes.
+ */
+export function updateDocumentNotes(
+  docId: string,
+  notes: string
+): Promise<{ id: string; notes: string }>;
+
+/**
+ * Updates the extracted JSON data of a document and optionally marks it as reviewed.
+ *
+ * Use this to correct AI extraction errors programmatically or to mark a document
+ * as confirmed.
+ *
+ * @param docId   Document ID.
+ * @param data    New extracted data as a plain object.
+ * @param options
+ * @param [options.preconformed=false] Mark the document as reviewed/confirmed.
+ *
+ * @example
+ * await updateDocumentData('doc_456', { 'Total Amount': 1250.00 }, { preconformed: true });
+ */
+export function updateDocumentData(
+  docId: string,
+  data: Record<string, unknown>,
+  options?: { preconformed?: boolean }
+): Promise<UserDocument>;
+
+/**
+ * Marks multiple documents as preconformed (reviewed) in a single request.
+ *
+ * @param ids Array of document IDs.
+ * @returns Object with the count of documents actually updated.
+ */
+export function bulkPreconform(ids: string[]): Promise<{ updated: number }>;
+
+/**
+ * Exports all documents of a template as raw CSV text.
+ *
+ * The CSV includes all extracted fields plus `preconformed` and `uploadedAt` columns.
+ *
+ * @param templateId Template ID.
+ * @param options
+ * @param [options.fields] Optional subset of column names to include (dot-notation for nested).
+ *
+ * @example
+ * const csv = await exportDocumentsCsv('tpl_123');
+ * fs.writeFileSync('documents.csv', csv);
+ */
+export function exportDocumentsCsv(
+  templateId: string,
+  options?: { fields?: string[] }
+): Promise<string>;
+
+/**
+ * Exports all documents of a template as a JSON array.
+ *
+ * Each element contains the extracted field map plus three metadata keys:
+ * `_id`, `_preconformed`, and `_uploadedAt`.
+ *
+ * @param templateId Template ID.
+ *
+ * @example
+ * const data = await exportDocumentsJson('tpl_123');
+ * data.forEach(doc => console.log(doc._id, doc['Invoice Number']));
+ */
+export function exportDocumentsJson(templateId: string): Promise<Record<string, unknown>[]>;
+
+// ─── Analytics / Credits ──────────────────────────────────────────────────────
+
+/**
+ * Returns the current AI-credit balance for the authenticated user.
+ *
+ * @example
+ * const balance = await getCreditsBalance();
+ * console.log(`You have ${balance.totalBalance} credits remaining.`);
+ */
+export function getCreditsBalance(): Promise<CreditsBalance>;
+
+/**
+ * Returns a paginated history of AI credit consumption events.
+ *
+ * @param options
+ * @param [options.page=0]  Zero-based page index.
+ * @param [options.size=20] Page size (max 100).
+ */
+export function getCreditsHistory(options?: {
+  page?: number;
+  size?: number;
+}): Promise<{
+  content: CreditLogEntry[];
+  totalPages: number;
+  totalElements: number;
+}>;
+
+/**
+ * Returns a paginated history of document processing events
+ * (uploads, OCR tool runs, both successes and failures).
+ *
+ * @param options
+ * @param [options.page=0]  Zero-based page index.
+ * @param [options.size=20] Page size (max 100).
+ *
+ * @example
+ * const history = await getDocumentHistory({ size: 50 });
+ * history.content.forEach(e => console.log(e.templateName, e.status, e.uploadDate));
+ */
+export function getDocumentHistory(options?: {
+  page?: number;
+  size?: number;
+}): Promise<{
+  content: DocumentAuditEntry[];
+  totalPages: number;
+  totalElements: number;
+}>;
+
+// ─── OCR Tools ────────────────────────────────────────────────────────────────
+
+/**
+ * Returns all OCR tool configurations belonging to the authenticated user.
+ *
+ * @example
+ * const tools = await getOcrTools();
+ */
+export function getOcrTools(): Promise<OcrToolConfig[]>;
+
+/**
+ * Creates a new OCR tool configuration.
+ *
+ * @example
+ * const tool = await createOcrTool({
+ *   name: 'Proof of Residence Check',
+ *   prompt: 'Does this document appear to be a valid proof of residence?',
+ *   outputType: 'YES_NO',
+ * });
+ */
+export function createOcrTool(config: Omit<OcrToolConfig, 'id' | 'createdAt'>): Promise<OcrToolConfig>;
+
+/**
+ * Updates an existing OCR tool configuration.
+ *
+ * @param id     OCR tool ID.
+ * @param config Updated fields.
+ */
+export function updateOcrTool(id: string, config: Partial<Omit<OcrToolConfig, 'id' | 'createdAt'>>): Promise<OcrToolConfig>;
+
+/**
+ * Deletes an OCR tool configuration.
+ * @param id OCR tool ID.
+ */
+export function deleteOcrTool(id: string): Promise<void>;
+
+/**
+ * Runs an OCR tool against a base64-encoded image.
+ *
+ * The image may include a data-URL prefix (e.g. `data:image/jpeg;base64,...`)
+ * or be a plain base64 string. Max image size is 5 MB.
+ *
+ * Each run deducts **1 document credit** from the user's quota plus AI credits
+ * based on token usage (`ceil(totalTokens / 1000)` credits).
+ * The AI responds in the same language as the prompt / parameter values.
+ *
+ * @param id          OCR tool ID.
+ * @param base64Image Base64-encoded image.
+ * @param options     Optional run options, including dynamic parameter values.
+ *
+ * @throws {ExtractiaError} 400 — missing/invalid parameter or prompt too long after substitution.
+ * @throws {TierError}      402 — document quota or AI credits exhausted.
+ *
+ * @example
+ * const result = await runOcrTool('tool_789', base64String);
+ * if (result.answer === 'YES') console.log('Proof of residence confirmed');
+ *
+ * // With dynamic parameters:
+ * const result = await runOcrTool('ownership_tool', base64String, {
+ *   params: { "1": "123 Main St", "2": "Jane Doe" }
+ * });
+ */
+export function runOcrTool(id: string, base64Image: string, options?: OcrRunOptions): Promise<OcrRunResult>;
+
+// ─── Sub-Users ────────────────────────────────────────────────────────────────
+
+/**
+ * Returns all sub-users for the authenticated account.
+ * Only available on plans that support sub-users (Pro and above).
+ */
+export function getSubUsers(): Promise<SubUser[]>;
+
+/**
+ * Creates a new sub-user.
+ *
+ * Available permissions: `"upload"`, `"view"`, `"template"`, `"settings"`, `"export"`, `"api"`.
+ *
+ * @throws {ForbiddenError} 403 if the plan does not support sub-users or the limit is reached.
+ * @throws {ExtractiaError} 409 if the username is already taken.
+ *
+ * @example
+ * await createSubUser({
+ *   username: 'agent_bob',
+ *   password: 'SecurePass1',
+ *   permissions: ['upload', 'view'],
+ * });
+ */
+export function createSubUser(subUser: {
+  username: string;
+  password: string;
+  permissions: string[];
+}): Promise<{ username: string; permissions: string[] }>;
+
+/**
+ * Deletes a sub-user by username.
+ * @param username The sub-user's username.
+ * @throws {NotFoundError} 404 if the sub-user does not exist.
+ */
+export function deleteSubUser(username: string): Promise<{ deleted: string }>;
+
+/**
+ * Updates the permissions and/or password of a sub-user.
+ * Only the provided fields are changed.
+ *
+ * @param username The sub-user's username.
+ * @param updates  Fields to update.
+ * @throws {NotFoundError} 404 if the sub-user does not exist.
+ */
+export function updateSubUser(
+  username: string,
+  updates: { permissions?: string[]; password?: string }
+): Promise<{ username: string; updated: boolean }>;
+
+/**
+ * Toggles the suspended state of a sub-user.
+ * A suspended sub-user cannot log in until unsuspended.
+ *
+ * @param username The sub-user's username.
+ * @throws {NotFoundError} 404 if the sub-user does not exist.
+ */
+export function toggleSuspendSubUser(username: string): Promise<{ username: string; suspended: boolean }>;
+
+// ─── Default export ───────────────────────────────────────────────────────────
+
+/** Namespace object bundling all SDK methods for UMD / CommonJS consumers. */
+declare const extractia: {
+  // Setup
+  setToken: typeof setToken;
+  configure: typeof configure;
+  // Auth
+  getMyProfile: typeof getMyProfile;
+  updateWebhook: typeof updateWebhook;
+  // Templates
+  getTemplates: typeof getTemplates;
+  getTemplateById: typeof getTemplateById;
+  getTemplateByName: typeof getTemplateByName;
+  createTemplate: typeof createTemplate;
+  updateTemplate: typeof updateTemplate;
+  deleteTemplate: typeof deleteTemplate;
+  deleteAllTemplateDocuments: typeof deleteAllTemplateDocuments;
+  suggestFields: typeof suggestFields;
+  // Documents
+  getDocumentsByTemplateId: typeof getDocumentsByTemplateId;
+  getDocumentById: typeof getDocumentById;
+  getRecentDocuments: typeof getRecentDocuments;
+  deleteDocument: typeof deleteDocument;
+  processImage: typeof processImage;
+  processImagesMultipage: typeof processImagesMultipage;
+  generateDocumentSummary: typeof generateDocumentSummary;
+  updateDocumentStatus: typeof updateDocumentStatus;
+  updateDocumentNotes: typeof updateDocumentNotes;
+  updateDocumentData: typeof updateDocumentData;
+  bulkPreconform: typeof bulkPreconform;
+  exportDocumentsCsv: typeof exportDocumentsCsv;
+  exportDocumentsJson: typeof exportDocumentsJson;
+  // Analytics
+  getCreditsBalance: typeof getCreditsBalance;
+  getCreditsHistory: typeof getCreditsHistory;
+  getDocumentHistory: typeof getDocumentHistory;
+  // OCR Tools
+  getOcrTools: typeof getOcrTools;
+  createOcrTool: typeof createOcrTool;
+  updateOcrTool: typeof updateOcrTool;
+  deleteOcrTool: typeof deleteOcrTool;
+  runOcrTool: typeof runOcrTool;
+  // Sub-users
+  getSubUsers: typeof getSubUsers;
+  createSubUser: typeof createSubUser;
+  deleteSubUser: typeof deleteSubUser;
+  updateSubUser: typeof updateSubUser;
+  toggleSuspendSubUser: typeof toggleSuspendSubUser;
+};
+
+export default extractia;