extractia-sdk 1.0.6 → 1.2.0

package/build.js

@@ -1,35 +1,40 @@
 // build.js
-import fs from 'fs';
-import { build } from 'esbuild';
+import fs from "fs";
+import { build } from "esbuild";
 
-if (!fs.existsSync('./dist')) {
-  fs.mkdirSync('./dist');
+if (!fs.existsSync("./dist")) {
+  fs.mkdirSync("./dist");
 }
 
 const sharedConfig = {
-  entryPoints: ['./src/index.js'],
+  entryPoints: ["./src/index.js"],
   bundle: true,
   minify: false,
   sourcemap: true,
-  target: ['es2017'],
+  target: ["es2017"],
 };
 
 Promise.all([
   build({
     ...sharedConfig,
-    outfile: './dist/extractia-sdk.esm.js',
-    format: 'esm',
+    outfile: "./dist/extractia-sdk.esm.js",
+    format: "esm",
   }),
   build({
     ...sharedConfig,
-    outfile: './dist/extractia-sdk.cjs.js',
-    format: 'cjs',
+    outfile: "./dist/extractia-sdk.cjs.js",
+    format: "cjs",
   }),
   build({
     ...sharedConfig,
-    entryPoints: ['./src/browser-entry.js'], // <-- usa el entry especial
-    outfile: './dist/extractia-sdk.browser.js',
-    format: 'iife',
-    globalName: 'ExtractiaSDK',
+    entryPoints: ["./src/browser-entry.js"], // <-- usa el entry especial
+    outfile: "./dist/extractia-sdk.browser.js",
+    format: "iife",
+    globalName: "ExtractiaSDK",
   }),
-]).catch(() => process.exit(1));
+])
+  .then(() => {
+    // Copy TypeScript declarations to dist so the `types` field in package.json resolves correctly.
+    fs.copyFileSync("./src/index.d.ts", "./dist/index.d.ts");
+  })
+  .catch(() => process.exit(1));

package/dist/extractia-sdk.browser.js

@@ -91,6 +91,7 @@ var ExtractiaSDK = (() => {
   // src/auth.js
   var auth_exports = {};
   __export(auth_exports, {
+    configure: () => configure,
     getMyProfile: () => getMyProfile,
     setToken: () => setToken,
     updateWebhook: () => updateWebhook
@@ -2608,22 +2609,93 @@ var ExtractiaSDK = (() => {
     mergeConfig: mergeConfig2
   } = axios_default;
 
+  // src/errors.js
+  var ExtractiaError = class extends Error {
+    /** @param {string} message @param {number} status */
+    constructor(message, status) {
+      super(message);
+      this.name = "ExtractiaError";
+      this.status = status;
+    }
+  };
+  var AuthError = class extends ExtractiaError {
+    constructor(message = "Unauthorized. Check your API token.") {
+      super(message, 401);
+      this.name = "AuthError";
+    }
+  };
+  var ForbiddenError = class extends ExtractiaError {
+    constructor(message = "Forbidden. Insufficient permissions.") {
+      super(message, 403);
+      this.name = "ForbiddenError";
+    }
+  };
+  var TierError = class extends ExtractiaError {
+    constructor(message = "Tier limit reached. Upgrade your plan.", status = 402) {
+      super(message, status);
+      this.name = "TierError";
+    }
+  };
+  var RateLimitError = class extends ExtractiaError {
+    constructor(message = "Too many requests. Please slow down.") {
+      super(message, 429);
+      this.name = "RateLimitError";
+    }
+  };
+  var NotFoundError = class extends ExtractiaError {
+    constructor(message = "Resource not found.") {
+      super(message, 404);
+      this.name = "NotFoundError";
+    }
+  };
+  function mapAxiosError(err) {
+    var _a, _b;
+    const status = (_a = err.response) == null ? void 0 : _a.status;
+    const serverMessage = (_b = err.response) == null ? void 0 : _b.data;
+    const detail = typeof serverMessage === "string" ? serverMessage : void 0;
+    switch (status) {
+      case 401:
+        return new AuthError(detail);
+      case 402:
+        return new TierError(detail);
+      case 403:
+        return new ForbiddenError(detail);
+      case 404:
+        return new NotFoundError(detail);
+      case 429:
+        return new RateLimitError(detail);
+      default:
+        return new ExtractiaError(detail != null ? detail : err.message, status != null ? status : 0);
+    }
+  }
+
   // src/apiClient.js
   var token = null;
+  var DEFAULT_BASE_URL = "https://api.extractia.info/api/public";
   var api = axios_default.create({
-    baseURL: "https://www.extractia-api.cat/api/public",
-    timeout: 1e4
+    baseURL: DEFAULT_BASE_URL,
+    timeout: 6e4
+    // 60s — AI processing can take 10–30s
   });
   api.interceptors.request.use((config) => {
     if (!token) {
-      throw new Error("API token is required");
+      throw new Error(
+        "API token is required. Call setToken(yourApiToken) before making requests."
+      );
     }
     config.headers.Authorization = `Bearer ${token}`;
     return config;
   });
+  api.interceptors.response.use(
+    (response) => response,
+    (err) => Promise.reject(mapAxiosError(err))
+  );
   function setToken(newToken) {
     token = newToken;
   }
+  function configure({ baseURL } = {}) {
+    if (baseURL) api.defaults.baseURL = baseURL;
+  }
   var apiClient_default = api;
 
   // src/auth.js
@@ -2647,6 +2719,7 @@ var ExtractiaSDK = (() => {
     getTemplateById: () => getTemplateById,
     getTemplateByName: () => getTemplateByName,
     getTemplates: () => getTemplates,
+    suggestFields: () => suggestFields,
     updateTemplate: () => updateTemplate
   });
   async function getTemplates() {
@@ -2679,45 +2752,168 @@ var ExtractiaSDK = (() => {
     const res = await apiClient_default.delete(`/templates/${id}/documents`);
     return res.data;
   }
+  async function suggestFields(templateName, extractionContext = "") {
+    const res = await apiClient_default.post("/templates/suggest-fields", {
+      templateName,
+      extractionContext
+    });
+    return res.data;
+  }
 
   // src/documents.js
   var documents_exports = {};
   __export(documents_exports, {
+    bulkPreconform: () => bulkPreconform,
     deleteDocument: () => deleteDocument,
+    exportDocumentsCsv: () => exportDocumentsCsv,
+    exportDocumentsJson: () => exportDocumentsJson,
+    generateDocumentSummary: () => generateDocumentSummary,
+    getDocumentById: () => getDocumentById,
     getDocumentsByTemplateId: () => getDocumentsByTemplateId,
+    getRecentDocuments: () => getRecentDocuments,
     processImage: () => processImage,
-    processImagesMultipage: () => processImagesMultipage
+    processImagesMultipage: () => processImagesMultipage,
+    updateDocumentData: () => updateDocumentData,
+    updateDocumentNotes: () => updateDocumentNotes,
+    updateDocumentStatus: () => updateDocumentStatus
   });
   async function getDocumentsByTemplateId(templateId, options = {}) {
-    var _a, _b, _c;
-    const params = {
-      preconformed: (_a = options.preconformed) != null ? _a : null,
-      index: (_b = options.index) != null ? _b : 0,
-      sort: (_c = options.sort) != null ? _c : -1,
-      includeImage: options.includeImage ? 1 : 0
-    };
+    const params = {};
+    if (options.preconformed != null) params.preconformed = options.preconformed;
+    if (options.index != null) params.index = options.index;
+    if (options.sort != null) params.sort = options.sort;
+    params.includeImage = options.includeImage ? 1 : 0;
     const res = await apiClient_default.get(`/templates/${templateId}/documents`, { params });
     return res.data;
   }
+  async function getDocumentById(templateId, docId, options = {}) {
+    const params = { includeImage: options.includeImage ? 1 : 0 };
+    const res = await apiClient_default.get(`/templates/${templateId}/documents/${docId}`, {
+      params
+    });
+    return res.data;
+  }
+  async function getRecentDocuments(size = 10) {
+    const res = await apiClient_default.get("/documents/recent", {
+      params: { size: Math.min(size, 50) }
+    });
+    return res.data;
+  }
   async function deleteDocument(documentId) {
     const res = await apiClient_default.delete(`/documents/${documentId}`);
     return res.data;
   }
   async function processImage(templateId, base64Image) {
-    const res = await apiClient_default.post(`/public/templates/${templateId}/process`, {
+    const res = await apiClient_default.post(`/templates/${templateId}/process`, {
       image: base64Image
     });
     return res.data;
   }
   async function processImagesMultipage(templateId, base64ImagesArray) {
-    const res = await apiClient_default.post(`/public/templates/${templateId}/process-multipage`, {
+    const res = await apiClient_default.post(`/templates/${templateId}/process-multipage`, {
       images: base64ImagesArray
     });
     return res.data;
   }
+  async function generateDocumentSummary(docId) {
+    const res = await apiClient_default.post(`/documents/${docId}/summary`);
+    return res.data;
+  }
+  async function updateDocumentStatus(docId, status) {
+    const res = await apiClient_default.put(`/documents/${docId}/status`, { status });
+    return res.data;
+  }
+  async function updateDocumentNotes(docId, notes) {
+    const res = await apiClient_default.put(`/documents/${docId}/notes`, { notes });
+    return res.data;
+  }
+  async function updateDocumentData(docId, data, options = {}) {
+    var _a;
+    const res = await apiClient_default.put(`/documents/${docId}/data`, {
+      data,
+      preconformed: (_a = options.preconformed) != null ? _a : false
+    });
+    return res.data;
+  }
+  async function bulkPreconform(ids) {
+    const res = await apiClient_default.post("/documents/bulk-preconform", { ids });
+    return res.data;
+  }
+  async function exportDocumentsCsv(templateId, options = {}) {
+    const params = {};
+    if (options.fields && options.fields.length > 0)
+      params.fields = options.fields.join(",");
+    const res = await apiClient_default.get(`/templates/${templateId}/documents/export/csv`, {
+      params,
+      responseType: "text"
+    });
+    return res.data;
+  }
+  async function exportDocumentsJson(templateId) {
+    const res = await apiClient_default.get(`/templates/${templateId}/documents/export/json`);
+    return res.data;
+  }
+
+  // src/analytics.js
+  var analytics_exports = {};
+  __export(analytics_exports, {
+    getCreditsBalance: () => getCreditsBalance,
+    getCreditsHistory: () => getCreditsHistory,
+    getDocumentHistory: () => getDocumentHistory
+  });
+  async function getCreditsBalance() {
+    const res = await apiClient_default.get("/me/credits");
+    return res.data;
+  }
+  async function getCreditsHistory({ page = 0, size = 20 } = {}) {
+    const res = await apiClient_default.get("/me/credits/history", {
+      params: { page, size: Math.min(size, 100) }
+    });
+    return res.data;
+  }
+  async function getDocumentHistory({ page = 0, size = 20 } = {}) {
+    const res = await apiClient_default.get("/me/documents/history", {
+      params: { page, size: Math.min(size, 100) }
+    });
+    return res.data;
+  }
+
+  // src/ocrTools.js
+  var ocrTools_exports = {};
+  __export(ocrTools_exports, {
+    createOcrTool: () => createOcrTool,
+    deleteOcrTool: () => deleteOcrTool,
+    getOcrTools: () => getOcrTools,
+    runOcrTool: () => runOcrTool,
+    updateOcrTool: () => updateOcrTool
+  });
+  async function getOcrTools() {
+    const res = await apiClient_default.get("/ocr-tools");
+    return res.data;
+  }
+  async function createOcrTool(config) {
+    const res = await apiClient_default.post("/ocr-tools", config);
+    return res.data;
+  }
+  async function updateOcrTool(id, config) {
+    const res = await apiClient_default.put(`/ocr-tools/${id}`, config);
+    return res.data;
+  }
+  async function deleteOcrTool(id) {
+    const res = await apiClient_default.delete(`/ocr-tools/${id}`);
+    return res.data;
+  }
+  async function runOcrTool(id, base64Image, options = {}) {
+    const body = { image: base64Image };
+    if (options.params && Object.keys(options.params).length > 0) {
+      body.params = options.params;
+    }
+    const res = await apiClient_default.post(`/ocr-tools/${id}/run`, body);
+    return res.data;
+  }
 
   // src/browser-entry.js
-  var extractia = __spreadValues(__spreadValues(__spreadValues({}, auth_exports), templates_exports), documents_exports);
+  var extractia = __spreadValues(__spreadValues(__spreadValues(__spreadValues(__spreadValues({}, auth_exports), templates_exports), documents_exports), analytics_exports), ocrTools_exports);
   var browser_entry_default = extractia;
   return __toCommonJS(browser_entry_exports);
 })();