hybridtm 0.7.1 → 0.9.0

package/dist/cli/restoreCommand.js

@@ -0,0 +1,100 @@
+/*******************************************************************************
+ * 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 { existsSync, unlinkSync } from "node:fs";
+import { BackupReader, HybridTMFactory } from '../index.js';
+import { CliUtils } from './cliUtils.js';
+export class RestoreCommand {
+    static 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)');
+    }
+    static async run(args) {
+        if (CliUtils.hasFlag(args, '-help')) {
+            RestoreCommand.usage();
+            return;
+        }
+        const rawFile = CliUtils.getFlag(args, '-file');
+        if (!rawFile) {
+            RestoreCommand.usage();
+            CliUtils.fail('Missing required -file.');
+        }
+        const filePath = CliUtils.requireExistingFile(rawFile, 'Backup file');
+        const target = CliUtils.hasFlag(args, '-create')
+            ? await RestoreCommand.createTargetInstance(args, filePath)
+            : RestoreCommand.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();
+        }
+    }
+    static getExistingTargetInstance(args) {
+        const name = CliUtils.getFlag(args, '-name');
+        if (!name) {
+            RestoreCommand.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 };
+    }
+    static async createTargetInstance(args, filePath) {
+        const rawPath = CliUtils.getFlag(args, '-path');
+        if (!rawPath) {
+            RestoreCommand.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 RestoreCommand.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 };
+    }
+    static async 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/cli/serveCommand.d.ts

@@ -0,0 +1,17 @@
+/*******************************************************************************
+ * 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
+ *******************************************************************************/
+export declare class ServeCommand {
+    static usage(): void;
+    static run(args: string[]): Promise<void>;
+    private static waitForServer;
+    private static pingServer;
+}

package/dist/cli/serveCommand.js

@@ -0,0 +1,87 @@
+/*******************************************************************************
+ * 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 { spawn } from "node:child_process";
+import { request } from "node:http";
+import { fileURLToPath } from "node:url";
+import { CliUtils } from './cliUtils.js';
+const DEFAULT_PORT = 8050;
+const LOCALHOST = '127.0.0.1';
+const ALL_INTERFACES = '0.0.0.0';
+const STARTUP_TIMEOUT_MS = 5000;
+const POLL_INTERVAL_MS = 100;
+export class ServeCommand {
+    static usage() {
+        console.log('Usage: hybridtm serve [-port <number>] [-network]');
+        console.log();
+        console.log('  Starts the HybridTM HTTP server.');
+        console.log();
+        console.log('  -port      Port to listen on (default: ' + DEFAULT_PORT + ')');
+        console.log('  -network   Accept connections from other machines on the network');
+        console.log('             (default: only this machine). The server has no');
+        console.log('             authentication, so only use this on a trusted network.');
+    }
+    static async run(args) {
+        if (CliUtils.hasFlag(args, '-help')) {
+            ServeCommand.usage();
+            return;
+        }
+        const port = CliUtils.parseIntFlag(args, '-port', DEFAULT_PORT, 1, 65535);
+        const host = CliUtils.hasFlag(args, '-network') ? ALL_INTERFACES : LOCALHOST;
+        const serverPath = fileURLToPath(new URL('../server/hybridtmServerMain.js', import.meta.url));
+        const child = spawn(process.execPath, [serverPath, String(port), host], {
+            detached: true,
+            stdio: 'ignore'
+        });
+        child.unref();
+        try {
+            await ServeCommand.waitForServer(host, port, STARTUP_TIMEOUT_MS);
+            console.log('HybridTM server started on ' + host + ':' + port);
+        }
+        catch (error) {
+            console.error('HybridTM server failed to start on ' + host + ':' + port);
+            process.exit(1);
+        }
+    }
+    static waitForServer(host, port, timeoutMs) {
+        return new Promise((resolve, reject) => {
+            const startTime = Date.now();
+            const check = () => {
+                if (Date.now() - startTime > timeoutMs) {
+                    reject(new Error('Server did not start within ' + timeoutMs + 'ms'));
+                    return;
+                }
+                ServeCommand.pingServer(host, port)
+                    .then(() => resolve())
+                    .catch(() => setTimeout(check, POLL_INTERVAL_MS));
+            };
+            check();
+        });
+    }
+    static pingServer(host, port) {
+        return new Promise((resolve, reject) => {
+            const client = request({
+                host: host,
+                port: port,
+                method: 'POST',
+                path: '/',
+                headers: { 'Content-Type': 'application/json' }
+            }, (res) => {
+                res.on('data', () => { });
+                res.on('end', () => resolve());
+            });
+            client.on('error', (error) => reject(error));
+            client.write('{}');
+            client.end();
+        });
+    }
+}
+//# sourceMappingURL=serveCommand.js.map

package/dist/cli/serveCommand.js.map

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

package/dist/cli/stopCommand.d.ts

@@ -0,0 +1,15 @@
+/*******************************************************************************
+ * 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
+ *******************************************************************************/
+export declare class StopCommand {
+    static usage(): void;
+    static run(args: string[]): Promise<void>;
+}

package/dist/cli/stopCommand.js

@@ -0,0 +1,73 @@
+/*******************************************************************************
+ * 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 { request } from "node:http";
+import { CliUtils } from './cliUtils.js';
+const DEFAULT_PORT = 8050;
+export class StopCommand {
+    static usage() {
+        console.log('Usage: hybridtm stop [-port <number>]');
+        console.log();
+        console.log('  Stops the HybridTM HTTP server (default port: ' + DEFAULT_PORT + ').');
+        console.log('  Pass -port if the server was started with a non-default -port.');
+    }
+    static async run(args) {
+        if (CliUtils.hasFlag(args, '-help')) {
+            StopCommand.usage();
+            return;
+        }
+        const port = CliUtils.parseIntFlag(args, '-port', DEFAULT_PORT, 1, 65535);
+        const body = JSON.stringify({ command: 'stop' });
+        const response = await new Promise((resolve, reject) => {
+            const req = request({
+                hostname: '127.0.0.1',
+                port: port,
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Content-Length': Buffer.byteLength(body)
+                }
+            }, (res) => {
+                const chunks = [];
+                res.on('data', (chunk) => {
+                    chunks.push(chunk);
+                });
+                res.on('end', () => {
+                    try {
+                        resolve(JSON.parse(Buffer.concat(chunks).toString('utf-8')));
+                    }
+                    catch (error) {
+                        reject(error);
+                    }
+                });
+            });
+            req.on('error', (error) => {
+                if (error.code === 'ECONNREFUSED') {
+                    reject(new Error('HybridTM server is not running on port ' + port + '.'));
+                }
+                else {
+                    reject(error);
+                }
+            });
+            req.write(body);
+            req.end();
+        });
+        const status = response && typeof response === 'object' ? response.status : undefined;
+        if (status === 'success') {
+            console.log('HybridTM server stopped.');
+        }
+        else {
+            const reason = response && typeof response === 'object' ? response.reason : undefined;
+            console.error('Failed to stop HybridTM server: ' + (typeof reason === 'string' ? reason : 'Server did not confirm a successful stop.'));
+        }
+    }
+}
+//# sourceMappingURL=stopCommand.js.map

package/dist/cli/stopCommand.js.map

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

package/dist/hybridtm.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
  *
@@ -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;
 }