hybridtm 0.7.1 → 0.9.0

package/README.md

@@ -1,15 +1,17 @@
 # HybridTM
 
-HybridTM is a semantic translation memory engine that stores bilingual content in LanceDB and scores matches by combining semantic embeddings (Xenova/Transformers.js) with the built-in MatchQuality fuzzy metric.
+HybridTM is a semantic translation memory engine that stores bilingual content in LanceDB and scores matches by combining semantic embeddings (Hugging Face Transformers.js) with the built-in MatchQuality fuzzy metric.
 
 ## Highlights
 
 - Imports XLIFF 2.x, TMX 1.4b, and SDLTM files, preserving metadata, notes, and custom properties
-- Generates semantic vectors with any Xenova-compatible text model (default: `HybridTM.QUALITY_MODEL`, LaBSE)
+- Generates semantic vectors with any Transformers.js-compatible text model — ships three ready-to-use presets (`compact`/`standard`/`large`, default: `HybridTM.LARGE_MODEL`) plus support for bringing your own model id (see [Choosing an embedding model](#choosing-an-embedding-model))
 - Provides `semanticTranslationSearch`, `semanticSearch`, and `concordanceSearch` APIs with metadata-aware filtering
 - Streams data into LanceDB through a JSONL-based batch importer to keep memory usage predictable
 - Prevents duplicate segments by rewriting entries with deterministic IDs (`fileId:unitId:segmentIndex:lang`)
-- Ships a `hybridtm` command-line tool for creating instances, importing files, and enriching XLIFF files with TM match candidates from the shell
+- Backs up any instance to a single format-agnostic XML file and restores it into an existing or brand-new instance, optionally under a different embedding model
+- Ships a `hybridtm` command-line tool for creating instances, importing files, backing up/restoring data, and enriching XLIFF files with TM match candidates from the shell
+- Runs as a JSON-over-HTTP server too (`hybridtm serve`, or embed `HybridTMServer` directly), for CAT tool and editor integrations that want to keep an instance and its loaded model open across many requests, with ticketed handling for long-running imports and matches, and a `storeXliffUnit` command for persisting a single confirmed unit as the user works
 
 Models download automatically the first time you initialize an instance and are cached in the standard Hugging Face directory.
 
@@ -36,7 +38,7 @@ const DB_PATH = path.resolve('.hybridtm', INSTANCE_NAME + '.lancedb');
 
 function getOrCreateTM(): HybridTM {
   return HybridTMFactory.getInstance(INSTANCE_NAME)
-    ?? HybridTMFactory.createInstance(INSTANCE_NAME, DB_PATH, HybridTM.QUALITY_MODEL);
+    ?? HybridTMFactory.createInstance(INSTANCE_NAME, DB_PATH, HybridTM.LARGE_MODEL);
 }
 
 async function main(): Promise<void> {
@@ -73,6 +75,25 @@ await tm.importSDLTM('./translations/legacy.sdltm');
 
 `semanticTranslationSearch` automatically pairs every source hit with its matching target segment (same `fileId`, `unitId`, and `segmentIndex`), making the output ready for CAT integrations.
 
+## Choosing an embedding model
+
+HybridTM ships three ready-to-use presets, but it is **not limited to them** — the `modelName` constructor argument (and the CLI's `-model` flag) accepts *any* Hugging Face `feature-extraction`-compatible model id, so you can bring your own (e.g. `-model intfloat/multilingual-e5-large`) if none of the presets fit.
+
+| Preset | Constant | Model | Dimensions |
+| --- | --- | --- | --- |
+| `compact` | `HybridTM.COMPACT_MODEL` | `Xenova/multilingual-e5-small` | 384 |
+| `standard` | `HybridTM.STANDARD_MODEL` | `Xenova/paraphrase-multilingual-MiniLM-L12-v2` | 384 |
+| `large` (default) | `HybridTM.LARGE_MODEL` | `onnx-community/gte-multilingual-base` | 768 |
+
+The names describe model **size/footprint**, not a quality ranking — an internal benchmark across English, Spanish, Japanese, and Finnish content found no preset winning on every language: `standard` led on English/Spanish/Japanese while matching or beating `large` on accuracy, `large` was the clear leader specifically on Finnish (a highly inflected language), and `compact` had the smallest footprint but never won outright on accuracy in that test. This is because HybridTM's translation matching pairs source and target segments by `fileId`/`unitId`/`segmentIndex` structure, not by comparing embeddings across languages — so model choice mostly affects how well a model clusters semantically similar text *within* the language you search in, and that can vary a lot by language family and script.
+
+Practical guidance:
+
+- **Unsure, or mostly Western European languages?** Start with `standard` — smallest footprint tier, and it matched or beat `large` in our tests while being faster.
+- **Morphologically rich languages** (e.g. Finnish, other Uralic or heavily case-inflected languages)? `large` is worth its extra latency and storage — it was the clear leader there.
+- **Memory/disk is the binding constraint?** `compact` is the smallest option, but treat it as a deliberate tradeoff, not a safe default — it trailed on accuracy in every language we tested.
+- Our benchmark was small (dozens of queries per language, a handful of language pairs) — informative, not exhaustive. If model choice matters a lot for your deployment, benchmark with your own representative content and target languages using `semanticSearch`/`semanticTranslationSearch` before committing, especially for languages we didn't test.
+
 ## Command-line interface
 
 Installing HybridTM globally also adds a `hybridtm` command:
@@ -80,9 +101,11 @@ Installing HybridTM globally also adds a `hybridtm` command:
 ```bash
 npm install -g hybridtm
 
-hybridtm create -name project -path ./project.lancedb
-hybridtm import -name project -file ./translations/project.xlf
-hybridtm match  -name project -file ./new-content.xlf -output ./new-content.matches.xlf
+hybridtm create  -name project -path ./project.lancedb
+hybridtm import  -name project -file ./translations/project.xlf
+hybridtm match   -name project -file ./new-content.xlf -similarity 60 -output ./new-content.matches.xlf
+hybridtm backup  -name project -file ./project-backup.xml
+hybridtm restore -file ./project-backup.xml -name project
 hybridtm list
 hybridtm remove -name project
 ```
@@ -99,6 +122,8 @@ see [05 · Command-Line Interface](docs/05-command-line-interface.md).
 - [03 · Search and Filtering](docs/03-search-and-filtering.md)
 - [04 · Sample Scenarios](docs/04-sample-scenarios.md)
 - [05 · Command-Line Interface](docs/05-command-line-interface.md)
+- [06 · Backup and Restore](docs/06-backup-and-restore.md)
+- [07 · HTTP Server](docs/07-http-server.md)
 
 Each guide is short and task-oriented, so you can jump directly to the workflow you need.
 
@@ -125,14 +150,10 @@ If you copy `samples/` elsewhere, update `samples/package.json` so the `hybridtm
 - `dist/` – compiled JavaScript and declarations (`npm run build`)
 - `docs/` – task-focused tutorials referenced above
 - `samples/` – standalone TypeScript project with runnable workflows
-- `models/` – local cache for pre-downloaded Xenova models (optional)
 
 ## Development
 
 - `npm run build` – compile TypeScript to `dist/`
-- `node dist/tmxtest.js` and `node dist/xlifftest.js` – regression checks for the TMX and XLIFF importers (run after building)
-
-Contributions should include unit or integration coverage when you touch importer or search logic. Use `HybridTMFactory.removeInstance(name)` to clean up any throwaway databases you create during manual tests.
 
 ## License
 

package/dist/backupHandler.d.ts

@@ -0,0 +1,60 @@
+/*******************************************************************************
+ * Copyright (c) 2025-2026 Maxprograms.
+ *
+ * This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * https://www.eclipse.org/org/documents/epl-v10.html
+ *
+ * Contributors:
+ *     Maxprograms - initial API and implementation
+ *******************************************************************************/
+import { Catalog, ContentHandler, Grammar, XMLAttribute } from "typesxml";
+export declare class BackupHandler implements ContentHandler {
+    private writeStream;
+    private readonly completionPromise;
+    private entryCount;
+    private name;
+    private model;
+    private date;
+    private inEntry;
+    private stack;
+    private entryChildren;
+    private entryLanguage;
+    private entryFileId;
+    private entryOriginal;
+    private entryUnitId;
+    private entrySegmentIndex;
+    private entrySegmentCount;
+    constructor(tempFilePath: string);
+    getEntryCount(): number;
+    waitForCompletion(): Promise<void>;
+    getBackupName(): string;
+    getBackupModel(): string;
+    getBackupDate(): string;
+    setGrammar(grammar: Grammar | undefined): void;
+    getGrammar(): Grammar | undefined;
+    initialize(): void;
+    setCatalog(catalog: Catalog): void;
+    startDocument(): void;
+    endDocument(): void;
+    xmlDeclaration(version: string, encoding: string, standalone: string | undefined): void;
+    startElement(name: string, atts: Array<XMLAttribute>): void;
+    endElement(name: string): void;
+    internalSubset(declaration: string): void;
+    characters(ch: string): void;
+    ignorableWhitespace(ch: string): void;
+    comment(ch: string): void;
+    processingInstruction(target: string, data: string): void;
+    startCDATA(): void;
+    endCDATA(): void;
+    startDTD(name: string, publicId: string, systemId: string): void;
+    endDTD(): void;
+    skippedEntity(name: string): void;
+    getCurrentText(): string;
+    private emitEntry;
+    private parseMetadataElement;
+    private parseSegmentElement;
+    private parseOptionalNumber;
+    private parseNumber;
+}

package/dist/backupHandler.js

@@ -0,0 +1,335 @@
+/*******************************************************************************
+ * Copyright (c) 2025-2026 Maxprograms.
+ *
+ * This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * https://www.eclipse.org/org/documents/epl-v10.html
+ *
+ * Contributors:
+ *     Maxprograms - initial API and implementation
+ *******************************************************************************/
+import { createWriteStream } from "node:fs";
+import { XMLElement } from "typesxml";
+export class BackupHandler {
+    writeStream;
+    completionPromise;
+    entryCount = 0;
+    name = '';
+    model = '';
+    date = '';
+    inEntry = false;
+    stack = [];
+    entryChildren = [];
+    entryLanguage = '';
+    entryFileId = '';
+    entryOriginal = '';
+    entryUnitId = '';
+    entrySegmentIndex = 0;
+    entrySegmentCount = 1;
+    constructor(tempFilePath) {
+        this.writeStream = createWriteStream(tempFilePath, { encoding: 'utf8' });
+        this.completionPromise = new Promise((resolve, reject) => {
+            this.writeStream.once('finish', resolve);
+            this.writeStream.once('error', reject);
+        });
+    }
+    getEntryCount() {
+        return this.entryCount;
+    }
+    waitForCompletion() {
+        return this.completionPromise;
+    }
+    getBackupName() {
+        return this.name;
+    }
+    getBackupModel() {
+        return this.model;
+    }
+    getBackupDate() {
+        return this.date;
+    }
+    setGrammar(grammar) {
+        // do nothing
+    }
+    getGrammar() {
+        return undefined;
+    }
+    initialize() {
+        this.stack = [];
+        this.entryChildren = [];
+        this.inEntry = false;
+    }
+    setCatalog(catalog) {
+        // do nothing
+    }
+    startDocument() {
+        // do nothing
+    }
+    endDocument() {
+        this.writeStream.end();
+    }
+    xmlDeclaration(version, encoding, standalone) {
+        // do nothing
+    }
+    startElement(name, atts) {
+        if ('backup' === name) {
+            const element = new XMLElement(name);
+            atts.forEach((att) => element.setAttribute(att));
+            this.name = element.getAttribute('name')?.getValue() ?? '';
+            this.model = element.getAttribute('model')?.getValue() ?? '';
+            this.date = element.getAttribute('date')?.getValue() ?? '';
+            return;
+        }
+        if ('entry' === name) {
+            const element = new XMLElement(name);
+            atts.forEach((att) => element.setAttribute(att));
+            this.inEntry = true;
+            this.stack = [];
+            this.entryChildren = [];
+            this.entryLanguage = element.getAttribute('language')?.getValue() ?? '';
+            this.entryFileId = element.getAttribute('fileId')?.getValue() ?? '';
+            this.entryOriginal = element.getAttribute('original')?.getValue() ?? '';
+            this.entryUnitId = element.getAttribute('unitId')?.getValue() ?? '';
+            this.entrySegmentIndex = this.parseNumber(element.getAttribute('segmentIndex')?.getValue(), 0);
+            this.entrySegmentCount = this.parseNumber(element.getAttribute('segmentCount')?.getValue(), 1);
+            return;
+        }
+        if (!this.inEntry) {
+            return;
+        }
+        const element = new XMLElement(name);
+        atts.forEach((att) => element.setAttribute(att));
+        if (this.stack.length > 0) {
+            this.stack[this.stack.length - 1].addElement(element);
+        }
+        this.stack.push(element);
+    }
+    endElement(name) {
+        if ('backup' === name) {
+            return;
+        }
+        if ('entry' === name) {
+            this.emitEntry();
+            this.inEntry = false;
+            this.stack = [];
+            this.entryChildren = [];
+            return;
+        }
+        if (!this.inEntry) {
+            return;
+        }
+        const finished = this.stack.pop();
+        if (finished && this.stack.length === 0) {
+            this.entryChildren.push(finished);
+        }
+    }
+    internalSubset(declaration) {
+        // do nothing
+    }
+    characters(ch) {
+        if (!this.inEntry || this.stack.length === 0) {
+            return;
+        }
+        this.stack[this.stack.length - 1].addString(ch);
+    }
+    ignorableWhitespace(ch) {
+        this.characters(ch);
+    }
+    comment(ch) {
+        // do nothing
+    }
+    processingInstruction(target, data) {
+        // do nothing
+    }
+    startCDATA() {
+        // do nothing
+    }
+    endCDATA() {
+        // do nothing
+    }
+    startDTD(name, publicId, systemId) {
+        // do nothing
+    }
+    endDTD() {
+        // do nothing
+    }
+    skippedEntity(name) {
+        // do nothing
+    }
+    getCurrentText() {
+        return '';
+    }
+    emitEntry() {
+        const pureTextElement = this.entryChildren.find((child) => child.getName() === 'pureText');
+        const elementWrapper = this.entryChildren.find((child) => child.getName() === 'element');
+        const metadataElement = this.entryChildren.find((child) => child.getName() === 'metadata');
+        if (!pureTextElement || !elementWrapper) {
+            return;
+        }
+        const innerElements = elementWrapper.getChildren();
+        if (innerElements.length === 0) {
+            return;
+        }
+        const jsonEntry = {
+            language: this.entryLanguage,
+            fileId: this.entryFileId,
+            original: this.entryOriginal,
+            unitId: this.entryUnitId,
+            pureText: pureTextElement.getText(),
+            element: innerElements[0].toString(),
+            segmentIndex: this.entrySegmentIndex,
+            segmentCount: this.entrySegmentCount
+        };
+        if (metadataElement) {
+            const metadata = this.parseMetadataElement(metadataElement);
+            if (Object.keys(metadata).length > 0) {
+                jsonEntry.metadata = metadata;
+            }
+        }
+        this.writeStream.write(JSON.stringify(jsonEntry) + '\n');
+        this.entryCount++;
+    }
+    parseMetadataElement(metadataElement) {
+        const metadata = {};
+        const childText = (childName) => {
+            const child = metadataElement.getChild(childName);
+            if (!child) {
+                return undefined;
+            }
+            const text = child.getText();
+            return text.length > 0 ? text : undefined;
+        };
+        const state = childText('state');
+        const validStates = ['initial', 'translated', 'reviewed', 'final'];
+        if (state && validStates.includes(state)) {
+            metadata.state = state;
+        }
+        const subState = childText('subState');
+        if (subState) {
+            metadata.subState = subState;
+        }
+        const quality = this.parseOptionalNumber(childText('quality'));
+        if (quality !== undefined) {
+            metadata.quality = quality;
+        }
+        const creationDate = childText('creationDate');
+        if (creationDate) {
+            metadata.creationDate = creationDate;
+        }
+        const creationId = childText('creationId');
+        if (creationId) {
+            metadata.creationId = creationId;
+        }
+        const changeDate = childText('changeDate');
+        if (changeDate) {
+            metadata.changeDate = changeDate;
+        }
+        const changeId = childText('changeId');
+        if (changeId) {
+            metadata.changeId = changeId;
+        }
+        const creationTool = childText('creationTool');
+        if (creationTool) {
+            metadata.creationTool = creationTool;
+        }
+        const creationToolVersion = childText('creationToolVersion');
+        if (creationToolVersion) {
+            metadata.creationToolVersion = creationToolVersion;
+        }
+        const context = childText('context');
+        if (context) {
+            metadata.context = context;
+        }
+        const usageCount = this.parseOptionalNumber(childText('usageCount'));
+        if (usageCount !== undefined) {
+            metadata.usageCount = usageCount;
+        }
+        const lastUsageDate = childText('lastUsageDate');
+        if (lastUsageDate) {
+            metadata.lastUsageDate = lastUsageDate;
+        }
+        const notesElement = metadataElement.getChild('notes');
+        if (notesElement) {
+            const notes = notesElement.getChildren()
+                .filter((child) => child.getName() === 'note')
+                .map((child) => child.getText())
+                .filter((text) => text.length > 0);
+            if (notes.length > 0) {
+                metadata.notes = notes;
+            }
+        }
+        const propertiesElement = metadataElement.getChild('properties');
+        if (propertiesElement) {
+            const properties = {};
+            propertiesElement.getChildren().forEach((child) => {
+                if (child.getName() === 'property') {
+                    const key = child.getAttribute('name')?.getValue();
+                    if (key && key.length > 0) {
+                        properties[key] = child.getText();
+                    }
+                }
+            });
+            if (Object.keys(properties).length > 0) {
+                metadata.properties = properties;
+            }
+        }
+        const segmentElement = metadataElement.getChild('segment');
+        if (segmentElement) {
+            const segment = this.parseSegmentElement(segmentElement);
+            if (Object.keys(segment).length > 0) {
+                metadata.segment = segment;
+            }
+        }
+        return metadata;
+    }
+    parseSegmentElement(segmentElement) {
+        const segment = {};
+        const attr = (attrName) => segmentElement.getAttribute(attrName)?.getValue();
+        const provider = attr('provider');
+        if (provider) {
+            segment.provider = provider;
+        }
+        const fileHash = attr('fileHash');
+        if (fileHash) {
+            segment.fileHash = fileHash;
+        }
+        const fileId = attr('fileId');
+        if (fileId) {
+            segment.fileId = fileId;
+        }
+        const unitId = attr('unitId');
+        if (unitId) {
+            segment.unitId = unitId;
+        }
+        const segmentId = attr('segmentId');
+        if (segmentId) {
+            segment.segmentId = segmentId;
+        }
+        const segmentKey = attr('segmentKey');
+        if (segmentKey) {
+            segment.segmentKey = segmentKey;
+        }
+        const segmentIndex = this.parseOptionalNumber(attr('segmentIndex'));
+        if (segmentIndex !== undefined) {
+            segment.segmentIndex = segmentIndex;
+        }
+        const segmentCount = this.parseOptionalNumber(attr('segmentCount'));
+        if (segmentCount !== undefined) {
+            segment.segmentCount = segmentCount;
+        }
+        return segment;
+    }
+    parseOptionalNumber(value) {
+        if (!value) {
+            return undefined;
+        }
+        const parsed = Number(value);
+        return Number.isNaN(parsed) ? undefined : parsed;
+    }
+    parseNumber(value, fallback) {
+        const parsed = this.parseOptionalNumber(value);
+        return parsed !== undefined ? parsed : fallback;
+    }
+}
+//# sourceMappingURL=backupHandler.js.map

package/dist/backupHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backupHandler.js","sourceRoot":"","sources":["../ts/backupHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;iFAUiF;AAEjF,OAAO,EAAE,iBAAiB,EAAe,MAAM,SAAS,CAAC;AACzD,OAAO,EAAkD,UAAU,EAAE,MAAM,UAAU,CAAC;AAItF,MAAM,OAAO,aAAa;IAEd,WAAW,CAAc;IAChB,iBAAiB,CAAgB;IAC1C,UAAU,GAAW,CAAC,CAAC;IAEvB,IAAI,GAAW,EAAE,CAAC;IAClB,KAAK,GAAW,EAAE,CAAC;IACnB,IAAI,GAAW,EAAE,CAAC;IAElB,OAAO,GAAY,KAAK,CAAC;IACzB,KAAK,GAAsB,EAAE,CAAC;IAC9B,aAAa,GAAsB,EAAE,CAAC;IACtC,aAAa,GAAW,EAAE,CAAC;IAC3B,WAAW,GAAW,EAAE,CAAC;IACzB,aAAa,GAAW,EAAE,CAAC;IAC3B,WAAW,GAAW,EAAE,CAAC;IACzB,iBAAiB,GAAW,CAAC,CAAC;IAC9B,iBAAiB,GAAW,CAAC,CAAC;IAEtC,YAAY,YAAoB;QAC5B,IAAI,CAAC,WAAW,GAAG,iBAAiB,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,iBAAiB,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3D,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACzC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACP,CAAC;IAED,aAAa;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,iBAAiB;QACb,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAClC,CAAC;IAED,aAAa;QACT,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,cAAc;QACV,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,aAAa;QACT,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,UAAU,CAAC,OAA4B;QACnC,aAAa;IACjB,CAAC;IAED,UAAU;QACN,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,UAAU;QACN,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,UAAU,CAAC,OAAgB;QACvB,aAAa;IACjB,CAAC;IAED,aAAa;QACT,aAAa;IACjB,CAAC;IAED,WAAW;QACP,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED,cAAc,CAAC,OAAe,EAAE,QAAgB,EAAE,UAA8B;QAC5E,aAAa;IACjB,CAAC;IAED,YAAY,CAAC,IAAY,EAAE,IAAyB;QAChD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpB,MAAM,OAAO,GAAe,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;YACjD,IAAI,CAAC,OAAO,CAAC,CAAC,GAAiB,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/D,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC3D,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC7D,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC3D,OAAO;QACX,CAAC;QACD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACnB,MAAM,OAAO,GAAe,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;YACjD,IAAI,CAAC,OAAO,CAAC,CAAC,GAAiB,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/D,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;YACxB,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACxE,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACpE,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACxE,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACpE,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;YAC/F,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;YAC/F,OAAO;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAChB,OAAO;QACX,CAAC;QACD,MAAM,OAAO,GAAe,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,CAAC,CAAC,GAAiB,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/D,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,UAAU,CAAC,IAAY;QACnB,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO;QACX,CAAC;QACD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACnB,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;YACrB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;YACxB,OAAO;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAChB,OAAO;QACX,CAAC;QACD,MAAM,QAAQ,GAA2B,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC1D,IAAI,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;IACL,CAAC;IAED,cAAc,CAAC,WAAmB;QAC9B,aAAa;IACjB,CAAC;IAED,UAAU,CAAC,EAAU;QACjB,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3C,OAAO;QACX,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,mBAAmB,CAAC,EAAU;QAC1B,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,CAAC,EAAU;QACd,aAAa;IACjB,CAAC;IAED,qBAAqB,CAAC,MAAc,EAAE,IAAY;QAC9C,aAAa;IACjB,CAAC;IAED,UAAU;QACN,aAAa;IACjB,CAAC;IAED,QAAQ;QACJ,aAAa;IACjB,CAAC;IAED,QAAQ,CAAC,IAAY,EAAE,QAAgB,EAAE,QAAgB;QACrD,aAAa;IACjB,CAAC;IAED,MAAM;QACF,aAAa;IACjB,CAAC;IAED,aAAa,CAAC,IAAY;QACtB,aAAa;IACjB,CAAC;IAED,cAAc;QACV,OAAO,EAAE,CAAC;IACd,CAAC;IAEO,SAAS;QACb,MAAM,eAAe,GAA2B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,KAAiB,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,UAAU,CAAC,CAAC;QAC/H,MAAM,cAAc,GAA2B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,KAAiB,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,SAAS,CAAC,CAAC;QAC7H,MAAM,eAAe,GAA2B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,KAAiB,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,UAAU,CAAC,CAAC;QAC/H,IAAI,CAAC,eAAe,IAAI,CAAC,cAAc,EAAE,CAAC;YACtC,OAAO;QACX,CAAC;QACD,MAAM,aAAa,GAAsB,cAAc,CAAC,WAAW,EAAE,CAAC;QACtE,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO;QACX,CAAC;QAED,MAAM,SAAS,GAA4B;YACvC,QAAQ,EAAE,IAAI,CAAC,aAAa;YAC5B,MAAM,EAAE,IAAI,CAAC,WAAW;YACxB,QAAQ,EAAE,IAAI,CAAC,aAAa;YAC5B,MAAM,EAAE,IAAI,CAAC,WAAW;YACxB,QAAQ,EAAE,eAAe,CAAC,OAAO,EAAE;YACnC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YACpC,YAAY,EAAE,IAAI,CAAC,iBAAiB;YACpC,YAAY,EAAE,IAAI,CAAC,iBAAiB;SACvC,CAAC;QAEF,IAAI,eAAe,EAAE,CAAC;YAClB,MAAM,QAAQ,GAAkB,IAAI,CAAC,oBAAoB,CAAC,eAAe,CAAC,CAAC;YAC3E,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnC,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAClC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,UAAU,EAAE,CAAC;IACtB,CAAC;IAEO,oBAAoB,CAAC,eAA2B;QACpD,MAAM,QAAQ,GAAkB,EAAE,CAAC;QAEnC,MAAM,SAAS,GAAG,CAAC,SAAiB,EAAsB,EAAE;YACxD,MAAM,KAAK,GAA2B,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YAC1E,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,OAAO,SAAS,CAAC;YACrB,CAAC;YACD,MAAM,IAAI,GAAW,KAAK,CAAC,OAAO,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9C,CAAC,CAAC;QAEF,MAAM,KAAK,GAAuB,SAAS,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,WAAW,GAAa,CAAC,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAC7E,IAAI,KAAK,IAAI,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACvC,QAAQ,CAAC,KAAK,GAAG,KAAyB,CAAC;QAC/C,CAAC;QACD,MAAM,QAAQ,GAAuB,SAAS,CAAC,UAAU,CAAC,CAAC;QAC3D,IAAI,QAAQ,EAAE,CAAC;YACX,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACjC,CAAC;QACD,MAAM,OAAO,GAAuB,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;QACnF,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACxB,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;QAC/B,CAAC;QACD,MAAM,YAAY,GAAuB,SAAS,CAAC,cAAc,CAAC,CAAC;QACnE,IAAI,YAAY,EAAE,CAAC;YACf,QAAQ,CAAC,YAAY,GAAG,YAAY,CAAC;QACzC,CAAC;QACD,MAAM,UAAU,GAAuB,SAAS,CAAC,YAAY,CAAC,CAAC;QAC/D,IAAI,UAAU,EAAE,CAAC;YACb,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;QACrC,CAAC;QACD,MAAM,UAAU,GAAuB,SAAS,CAAC,YAAY,CAAC,CAAC;QAC/D,IAAI,UAAU,EAAE,CAAC;YACb,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;QACrC,CAAC;QACD,MAAM,QAAQ,GAAuB,SAAS,CAAC,UAAU,CAAC,CAAC;QAC3D,IAAI,QAAQ,EAAE,CAAC;YACX,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACjC,CAAC;QACD,MAAM,YAAY,GAAuB,SAAS,CAAC,cAAc,CAAC,CAAC;QACnE,IAAI,YAAY,EAAE,CAAC;YACf,QAAQ,CAAC,YAAY,GAAG,YAAY,CAAC;QACzC,CAAC;QACD,MAAM,mBAAmB,GAAuB,SAAS,CAAC,qBAAqB,CAAC,CAAC;QACjF,IAAI,mBAAmB,EAAE,CAAC;YACtB,QAAQ,CAAC,mBAAmB,GAAG,mBAAmB,CAAC;QACvD,CAAC;QACD,MAAM,OAAO,GAAuB,SAAS,CAAC,SAAS,CAAC,CAAC;QACzD,IAAI,OAAO,EAAE,CAAC;YACV,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;QAC/B,CAAC;QACD,MAAM,UAAU,GAAuB,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC;QACzF,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC3B,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;QACrC,CAAC;QACD,MAAM,aAAa,GAAuB,SAAS,CAAC,eAAe,CAAC,CAAC;QACrE,IAAI,aAAa,EAAE,CAAC;YAChB,QAAQ,CAAC,aAAa,GAAG,aAAa,CAAC;QAC3C,CAAC;QAED,MAAM,YAAY,GAA2B,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/E,IAAI,YAAY,EAAE,CAAC;YACf,MAAM,KAAK,GAAa,YAAY,CAAC,WAAW,EAAE;iBAC7C,MAAM,CAAC,CAAC,KAAiB,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,MAAM,CAAC;iBACzD,GAAG,CAAC,CAAC,KAAiB,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;iBAC3C,MAAM,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC/C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnB,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;YAC3B,CAAC;QACL,CAAC;QAED,MAAM,iBAAiB,GAA2B,eAAe,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACzF,IAAI,iBAAiB,EAAE,CAAC;YACpB,MAAM,UAAU,GAA2B,EAAE,CAAC;YAC9C,iBAAiB,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,CAAC,KAAiB,EAAE,EAAE;gBAC1D,IAAI,KAAK,CAAC,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;oBACjC,MAAM,GAAG,GAAuB,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;oBACvE,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACxB,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;oBACtC,CAAC;gBACL,CAAC;YACL,CAAC,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrC,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;YACrC,CAAC;QACL,CAAC;QAED,MAAM,cAAc,GAA2B,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACnF,IAAI,cAAc,EAAE,CAAC;YACjB,MAAM,OAAO,GAAoB,IAAI,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC;YAC1E,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClC,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;YAC/B,CAAC;QACL,CAAC;QAED,OAAO,QAAQ,CAAC;IACpB,CAAC;IAEO,mBAAmB,CAAC,cAA0B;QAClD,MAAM,OAAO,GAAoB,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,CAAC,QAAgB,EAAsB,EAAE,CAAC,cAAc,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;QAEzG,MAAM,QAAQ,GAAuB,IAAI,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,QAAQ,EAAE,CAAC;YACX,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAChC,CAAC;QACD,MAAM,QAAQ,GAAuB,IAAI,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,QAAQ,EAAE,CAAC;YACX,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAChC,CAAC;QACD,MAAM,MAAM,GAAuB,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,MAAM,EAAE,CAAC;YACT,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;QAC5B,CAAC;QACD,MAAM,MAAM,GAAuB,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,MAAM,EAAE,CAAC;YACT,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;QAC5B,CAAC;QACD,MAAM,SAAS,GAAuB,IAAI,CAAC,WAAW,CAAC,CAAC;QACxD,IAAI,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;QAClC,CAAC;QACD,MAAM,UAAU,GAAuB,IAAI,CAAC,YAAY,CAAC,CAAC;QAC1D,IAAI,UAAU,EAAE,CAAC;YACb,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC;QACpC,CAAC;QACD,MAAM,YAAY,GAAuB,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;QACxF,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,CAAC,YAAY,GAAG,YAAY,CAAC;QACxC,CAAC;QACD,MAAM,YAAY,GAAuB,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;QACxF,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,CAAC,YAAY,GAAG,YAAY,CAAC;QACxC,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;IAEO,mBAAmB,CAAC,KAAyB;QACjD,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,MAAM,MAAM,GAAW,MAAM,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;IACrD,CAAC;IAEO,WAAW,CAAC,KAAyB,EAAE,QAAgB;QAC3D,MAAM,MAAM,GAAuB,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACnE,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;IACpD,CAAC;CACJ"}

package/dist/backupReader.d.ts

@@ -0,0 +1,26 @@
+/*******************************************************************************
+ * Copyright (c) 2025-2026 Maxprograms.
+ *
+ * This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * https://www.eclipse.org/org/documents/epl-v10.html
+ *
+ * Contributors:
+ *     Maxprograms - initial API and implementation
+ *******************************************************************************/
+import { SAXParser } from "typesxml";
+import { BackupHandler } from './backupHandler.js';
+export declare class BackupReader {
+    parser: SAXParser;
+    filePath: string;
+    handler: BackupHandler;
+    jsonlTempPath: string;
+    constructor(filePath: string);
+    parse(): Promise<void>;
+    getTempFilePath(): string;
+    getEntryCount(): number;
+    getBackupName(): string;
+    getBackupModel(): string;
+    getBackupDate(): string;
+}

package/dist/backupReader.js

@@ -0,0 +1,55 @@
+/*******************************************************************************
+ * Copyright (c) 2025-2026 Maxprograms.
+ *
+ * This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * https://www.eclipse.org/org/documents/epl-v10.html
+ *
+ * Contributors:
+ *     Maxprograms - initial API and implementation
+ *******************************************************************************/
+import { tmpdir } from "node:os";
+import { join } from 'node:path';
+import { SAXParser } from "typesxml";
+import { BackupHandler } from './backupHandler.js';
+export class BackupReader {
+    parser;
+    filePath;
+    handler;
+    jsonlTempPath;
+    constructor(filePath) {
+        this.filePath = filePath;
+        const tempDir = tmpdir();
+        const tempFileName = 'backup_' + Date.now() + '_' + Math.random().toString(36).substring(7) + '.jsonl';
+        this.jsonlTempPath = join(tempDir, tempFileName);
+        this.parser = new SAXParser();
+        this.handler = new BackupHandler(this.jsonlTempPath);
+        this.parser.setContentHandler(this.handler);
+    }
+    async parse() {
+        try {
+            this.parser.parseFile(this.filePath);
+            await this.handler.waitForCompletion();
+        }
+        catch (error) {
+            throw error instanceof Error ? error : new Error(String(error));
+        }
+    }
+    getTempFilePath() {
+        return this.jsonlTempPath;
+    }
+    getEntryCount() {
+        return this.handler.getEntryCount();
+    }
+    getBackupName() {
+        return this.handler.getBackupName();
+    }
+    getBackupModel() {
+        return this.handler.getBackupModel();
+    }
+    getBackupDate() {
+        return this.handler.getBackupDate();
+    }
+}
+//# sourceMappingURL=backupReader.js.map

package/dist/backupReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backupReader.js","sourceRoot":"","sources":["../ts/backupReader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;iFAUiF;AAEjF,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,OAAO,YAAY;IAErB,MAAM,CAAY;IAClB,QAAQ,CAAS;IACjB,OAAO,CAAgB;IACvB,aAAa,CAAS;IAEtB,YAAY,QAAgB;QACxB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC;QACzB,MAAM,YAAY,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC;QACvG,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAEjD,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,KAAK;QACP,IAAI,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrC,MAAM,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACpE,CAAC;IACL,CAAC;IAED,eAAe;QACX,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED,aAAa;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;IACxC,CAAC;IAED,aAAa;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;IACxC,CAAC;IAED,cAAc;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;IACzC,CAAC;IAED,aAAa;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;IACxC,CAAC;CACJ"}

package/dist/batchImporter.d.ts

@@ -2,7 +2,7 @@
  * Copyright (c) 2025-2026 Maxprograms.
  *
  * This program and the accompanying materials
- * are made available under the terms of the Eclipse   License 1.0
+ * are made available under the terms of the Eclipse Public License v1.0
  * which accompanies this distribution, and is available at
  * https://www.eclipse.org/org/documents/epl-v10.html
  *

package/dist/batchImporter.js

@@ -2,7 +2,7 @@
  * Copyright (c) 2025-2026 Maxprograms.
  *
  * This program and the accompanying materials
- * are made available under the terms of the Eclipse   License 1.0
+ * are made available under the terms of the Eclipse Public License v1.0
  * which accompanies this distribution, and is available at
  * https://www.eclipse.org/org/documents/epl-v10.html
  *
@@ -101,13 +101,14 @@ export class BatchImporter {
             console.log('Total entries imported: ' + totalProcessed.toLocaleString());
             console.log('Total time: ' + minutes + 'm ' + seconds + 's');
             console.log('Average rate: ' + avgRate.toFixed(1) + ' entries/sec');
-            // Clean up the temporary file
-            await this.cleanup();
         }
         catch (err) {
             console.error('Error during batch import:', err);
             throw err;
         }
+        finally {
+            await this.cleanup();
+        }
     }
     parseMetadata(metadata) {
         if (!metadata || typeof metadata !== 'object') {