hybridtm 0.7.0 → 0.8.0

package/dist/cli/restoreCommand.js

@@ -0,0 +1,98 @@
+/*******************************************************************************
+ * Copyright (c) 2025-2026 Maxprograms.
+ *
+ * This program and the accompanying materials
+ * are made available under the terms of the Eclipse   License 1.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 { existsSync, unlinkSync } from "node:fs";
+import { BackupReader, HybridTMFactory } from '../index.js';
+import { CliUtils } from './cliUtils.js';
+export function usage() {
+    console.log('Usage: hybridtm restore -file <path> -name <name>');
+    console.log('       hybridtm restore -file <path> -create -path <dir> [-name <name>] [-model compact|standard|large|<model id>]');
+    console.log();
+    console.log('  -file     Backup XML file to restore (required)');
+    console.log('  -name     Existing instance to restore into, appending its entries. With');
+    console.log('            -create, the name for the new instance (default: the name');
+    console.log('            recorded in the backup file)');
+    console.log('  -create   Create a fresh instance before restoring, instead of appending');
+    console.log('            to an existing one');
+    console.log('  -path     Directory for the new instance\'s LanceDB data (required with -create)');
+    console.log('  -model    Embedding model for the new instance (default: the model recorded');
+    console.log('            in the backup file)');
+}
+export async function runRestoreCommand(args) {
+    if (CliUtils.hasFlag(args, '-help')) {
+        usage();
+        return;
+    }
+    const rawFile = CliUtils.getFlag(args, '-file');
+    if (!rawFile) {
+        usage();
+        CliUtils.fail('Missing required -file.');
+    }
+    const filePath = CliUtils.requireExistingFile(rawFile, 'Backup file');
+    const target = CliUtils.hasFlag(args, '-create')
+        ? await createTargetInstance(args, filePath)
+        : getExistingTargetInstance(args);
+    try {
+        const count = await target.tm.restore(filePath);
+        console.log('Restored ' + count + ' entries from ' + filePath + ' into "' + target.name + '".');
+    }
+    catch (error) {
+        CliUtils.fail(error instanceof Error ? error.message : String(error));
+    }
+    finally {
+        await target.tm.close();
+    }
+}
+function getExistingTargetInstance(args) {
+    const name = CliUtils.getFlag(args, '-name');
+    if (!name) {
+        usage();
+        CliUtils.fail('Missing required -name (or pass -create to make a new instance).');
+    }
+    const tm = HybridTMFactory.getInstance(name);
+    if (!tm) {
+        CliUtils.fail('No instance named "' + name + '". Run "hybridtm create" or "hybridtm list" first.');
+    }
+    return { tm, name };
+}
+async function createTargetInstance(args, filePath) {
+    const rawPath = CliUtils.getFlag(args, '-path');
+    if (!rawPath) {
+        usage();
+        CliUtils.fail('Missing required -path when using -create.');
+    }
+    const resolvedPath = CliUtils.resolvePath(rawPath);
+    let name = CliUtils.getFlag(args, '-name');
+    const modelAlias = CliUtils.getFlag(args, '-model');
+    let modelName = modelAlias ? CliUtils.resolveModelName(modelAlias) : undefined;
+    if (!name || !modelName) {
+        const header = await peekBackupHeader(filePath);
+        name = name || header.name || undefined;
+        modelName = modelName || header.model || undefined;
+    }
+    if (!name) {
+        CliUtils.fail('Could not determine an instance name; pass -name or restore from a backup file with a recorded name.');
+    }
+    if (!modelName) {
+        CliUtils.fail('Could not determine an embedding model; pass -model or restore from a backup file with a recorded model.');
+    }
+    const tm = HybridTMFactory.createInstance(name, resolvedPath, modelName);
+    return { tm, name };
+}
+async function peekBackupHeader(filePath) {
+    const reader = new BackupReader(filePath);
+    await reader.parse();
+    if (existsSync(reader.getTempFilePath())) {
+        unlinkSync(reader.getTempFilePath());
+    }
+    return { name: reader.getBackupName(), model: reader.getBackupModel() };
+}
+//# sourceMappingURL=restoreCommand.js.map

package/dist/cli/restoreCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoreCommand.js","sourceRoot":"","sources":["../../ts/cli/restoreCommand.ts"],"names":[],"mappings":"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"}

package/dist/hybridtm.d.ts

@@ -16,14 +16,15 @@ import { Match } from './match.js';
 import { PendingEntry } from './pendingEntry.js';
 import { MetadataFilter, TranslationSearchFilters } from './searchFilters.js';
 export declare class HybridTM {
-    static readonly SPEED_MODEL: string;
-    static readonly QUALITY_MODEL: string;
-    static readonly RESOURCE_MODEL: string;
+    static readonly COMPACT_MODEL: string;
+    static readonly STANDARD_MODEL: string;
+    static readonly LARGE_MODEL: string;
     private name;
     private db;
     private table;
     private dbPath;
     private embedder;
+    private embedderPromise;
     private modelName;
     private initialized;
     private initializationPromise;
@@ -32,6 +33,7 @@ export declare class HybridTM {
     private initialize;
     private initializeDatabase;
     private initializeEmbedder;
+    private loadEmbedder;
     private generateEmbedding;
     private ensureInitialized;
     private ensureTable;
@@ -64,4 +66,9 @@ export declare class HybridTM {
     importXLIFF(filePath: string, options?: ImportOptions): Promise<number>;
     importTMX(filePath: string, options?: ImportOptions): Promise<number>;
     importSDLTM(filePath: string, options?: ImportOptions): Promise<number>;
+    restore(filePath: string): Promise<number>;
+    backup(outputPath: string): Promise<number>;
+    private buildBackupEntryElement;
+    private buildBackupMetadataElement;
+    private appendTextElement;
 }