@embedpdf/engines 1.0.26 → 1.1.0

package/dist/{engine-BH98VpS7.js → engine-Cm-940a0.js}

@@ -53,16 +53,22 @@ function isValidCustomKey(key) {
   }
   return true;
 }
+const DEFAULT_CONFIG = {
+  pageTtl: 5e3,
+  // 5 seconds
+  maxPagesPerDocument: 10
+};
 class PdfCache {
-  constructor(pdfium) {
+  constructor(pdfium, config = {}) {
     this.pdfium = pdfium;
     this.docs = /* @__PURE__ */ new Map();
+    this.config = { ...DEFAULT_CONFIG, ...config };
   }
   /** Open (or re-use) a document */
   setDocument(id, filePtr, docPtr) {
     let ctx = this.docs.get(id);
     if (!ctx) {
-      ctx = new DocumentContext(filePtr, docPtr, this.pdfium);
+      ctx = new DocumentContext(filePtr, docPtr, this.pdfium, this.config);
       this.docs.set(id, ctx);
     }
   }
@@ -78,12 +84,41 @@ class PdfCache {
     this.docs.delete(docId);
     return true;
   }
+  /** Close all documents */
+  closeAllDocuments() {
+    for (const ctx of this.docs.values()) {
+      ctx.dispose();
+    }
+    this.docs.clear();
+  }
+  /** Update cache configuration for all existing documents */
+  updateConfig(newConfig) {
+    Object.assign(this.config, newConfig);
+    for (const ctx of this.docs.values()) {
+      ctx.updateConfig(this.config);
+    }
+  }
+  /** Get current cache statistics */
+  getCacheStats() {
+    const pagesByDocument = {};
+    let totalPages = 0;
+    for (const [docId, ctx] of this.docs.entries()) {
+      const pageCount = ctx.getCacheSize();
+      pagesByDocument[docId] = pageCount;
+      totalPages += pageCount;
+    }
+    return {
+      documents: this.docs.size,
+      totalPages,
+      pagesByDocument
+    };
+  }
 }
 class DocumentContext {
-  constructor(filePtr, docPtr, pdfium) {
+  constructor(filePtr, docPtr, pdfium, config) {
     this.filePtr = filePtr;
     this.docPtr = docPtr;
-    this.pageCache = new PageCache(pdfium, docPtr);
+    this.pageCache = new PageCache(pdfium, docPtr, config);
   }
   /** Main accessor for pages */
   acquirePage(pageIdx) {
@@ -93,6 +128,14 @@ class DocumentContext {
   borrowPage(pageIdx, fn) {
     return this.pageCache.borrowPage(pageIdx, fn);
   }
+  /** Update cache configuration */
+  updateConfig(config) {
+    this.pageCache.updateConfig(config);
+  }
+  /** Get number of pages currently in cache */
+  getCacheSize() {
+    return this.pageCache.size();
+  }
   /** Tear down all pages + this document */
   dispose() {
     this.pageCache.forceReleaseAll();
@@ -101,25 +144,30 @@ class DocumentContext {
   }
 }
 class PageCache {
-  constructor(pdf, docPtr) {
+  constructor(pdf, docPtr, config) {
     this.pdf = pdf;
     this.docPtr = docPtr;
     this.cache = /* @__PURE__ */ new Map();
+    this.accessOrder = [];
+    this.config = config;
   }
   acquire(pageIdx) {
     let ctx = this.cache.get(pageIdx);
     if (!ctx) {
+      this.evictIfNeeded();
       const pagePtr = this.pdf.FPDF_LoadPage(this.docPtr, pageIdx);
-      ctx = new PageContext(this.pdf, this.docPtr, pageIdx, pagePtr, () => {
+      ctx = new PageContext(this.pdf, this.docPtr, pageIdx, pagePtr, this.config.pageTtl, () => {
         this.cache.delete(pageIdx);
+        this.removeFromAccessOrder(pageIdx);
       });
       this.cache.set(pageIdx, ctx);
     }
+    this.updateAccessOrder(pageIdx);
     ctx.clearExpiryTimer();
     ctx.bumpRefCount();
     return ctx;
   }
-  /** Helper: run a function “scoped” to a page.
+  /** Helper: run a function "scoped" to a page.
    *    – if the page was already cached  → .release() (keeps TTL logic)
    *    – if the page was loaded just now → .disposeImmediate() (free right away)
    */
@@ -137,11 +185,55 @@ class PageCache {
       ctx.disposeImmediate();
     }
     this.cache.clear();
+    this.accessOrder.length = 0;
+  }
+  /** Update cache configuration */
+  updateConfig(config) {
+    this.config = config;
+    for (const ctx of this.cache.values()) {
+      ctx.updateTtl(config.pageTtl);
+    }
+    this.evictIfNeeded();
+  }
+  /** Get current cache size */
+  size() {
+    return this.cache.size;
+  }
+  /** Evict least recently used pages if cache exceeds max size */
+  evictIfNeeded() {
+    while (this.cache.size >= this.config.maxPagesPerDocument) {
+      const lruPageIdx = this.accessOrder[0];
+      if (lruPageIdx !== void 0) {
+        const ctx = this.cache.get(lruPageIdx);
+        if (ctx) {
+          if (ctx.getRefCount() === 0) {
+            ctx.disposeImmediate();
+          } else {
+            break;
+          }
+        } else {
+          this.removeFromAccessOrder(lruPageIdx);
+        }
+      } else {
+        break;
+      }
+    }
+  }
+  /** Update the access order for LRU tracking */
+  updateAccessOrder(pageIdx) {
+    this.removeFromAccessOrder(pageIdx);
+    this.accessOrder.push(pageIdx);
+  }
+  /** Remove a page from the access order array */
+  removeFromAccessOrder(pageIdx) {
+    const index = this.accessOrder.indexOf(pageIdx);
+    if (index > -1) {
+      this.accessOrder.splice(index, 1);
+    }
   }
 }
-const PAGE_TTL = 5e3;
 class PageContext {
-  constructor(pdf, docPtr, pageIdx, pagePtr, onFinalDispose) {
+  constructor(pdf, docPtr, pageIdx, pagePtr, ttl, onFinalDispose) {
     this.pdf = pdf;
     this.docPtr = docPtr;
     this.pageIdx = pageIdx;
@@ -149,12 +241,17 @@ class PageContext {
     this.onFinalDispose = onFinalDispose;
     this.refCount = 0;
     this.disposed = false;
+    this.ttl = ttl;
   }
   /** Called by PageCache.acquire() */
   bumpRefCount() {
     if (this.disposed) throw new Error("Context already disposed");
     this.refCount++;
   }
+  /** Get current reference count */
+  getRefCount() {
+    return this.refCount;
+  }
   /** Called by PageCache.acquire() */
   clearExpiryTimer() {
     if (this.expiryTimer) {
@@ -162,18 +259,27 @@ class PageContext {
       this.expiryTimer = void 0;
     }
   }
+  /** Update TTL configuration */
+  updateTtl(newTtl) {
+    this.ttl = newTtl;
+    if (this.expiryTimer && this.refCount === 0) {
+      this.clearExpiryTimer();
+      this.expiryTimer = setTimeout(() => this.disposeImmediate(), this.ttl);
+    }
+  }
   /** Called by PageCache.release() internally */
   release() {
     if (this.disposed) return;
     this.refCount--;
     if (this.refCount === 0) {
-      this.expiryTimer = setTimeout(() => this.disposeImmediate(), PAGE_TTL);
+      this.expiryTimer = setTimeout(() => this.disposeImmediate(), this.ttl);
     }
   }
   /** Tear down _all_ sub-pointers & the page. */
   disposeImmediate() {
     if (this.disposed) return;
     this.disposed = true;
+    this.clearExpiryTimer();
     if (this.textPagePtr !== void 0) {
       this.pdf.FPDFText_ClosePage(this.textPagePtr);
     }
@@ -365,6 +471,7 @@ class PdfiumEngine {
    */
   constructor(pdfiumModule, options = {}) {
     this.pdfiumModule = pdfiumModule;
+    this.memoryLeakCheckInterval = null;
     const {
       logger = new NoopLogger(),
       imageDataConverter = browserImageDataToBlobConverter
@@ -374,7 +481,7 @@ class PdfiumEngine {
     this.imageDataConverter = imageDataConverter;
     this.memoryManager = new MemoryManager(this.pdfiumModule, this.logger);
     if (this.logger.isEnabled("debug")) {
-      setInterval(() => {
+      this.memoryLeakCheckInterval = setInterval(() => {
         this.memoryManager.checkLeaks();
       }, 1e4);
     }
@@ -400,6 +507,10 @@ class PdfiumEngine {
     this.logger.debug(LOG_SOURCE, LOG_CATEGORY, "destroy");
     this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `Destroy`, "Begin", "General");
     this.pdfiumModule.FPDF_DestroyLibrary();
+    if (this.memoryLeakCheckInterval) {
+      clearInterval(this.memoryLeakCheckInterval);
+      this.memoryLeakCheckInterval = null;
+    }
     this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `Destroy`, "End", "General");
     return PdfTaskHelper.resolve(true);
   }
@@ -2026,6 +2137,18 @@ class PdfiumEngine {
     this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `CloseDocument`, "End", doc.id);
     return PdfTaskHelper.resolve(true);
   }
+  /**
+   * {@inheritDoc @embedpdf/models!PdfEngine.closeAllDocuments}
+   *
+   * @public
+   */
+  closeAllDocuments() {
+    this.logger.debug(LOG_SOURCE, LOG_CATEGORY, "closeAllDocuments");
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `CloseAllDocuments`, "Begin");
+    this.cache.closeAllDocuments();
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `CloseAllDocuments`, "End");
+    return PdfTaskHelper.resolve(true);
+  }
   /**
    * Add text content to annotation
    * @param page - page info
@@ -6502,4 +6625,4 @@ export {
   isValidCustomKey as i,
   readString as r
 };
-//# sourceMappingURL=engine-BH98VpS7.js.map
+//# sourceMappingURL=engine-Cm-940a0.js.map