@checkpointvcs/longtail-addon 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,116 @@
+interface HandleStatus {
+    currentStep: string;
+    changingStep: boolean;
+    canceled: boolean;
+    completed: boolean;
+    error: number;
+}
+/** Opaque native handle — do not inspect directly */
+type NativeHandle = object;
+export type LongtailLogLevel = "debug" | "info" | "warn" | "error" | "off";
+export interface Modification {
+    delete: boolean;
+    path: string;
+    oldPath?: string;
+}
+export interface SubmitAsyncOptions {
+    branchName: string;
+    message: string;
+    targetChunkSize: number;
+    targetBlockSize: number;
+    maxChunksPerBlock: number;
+    minBlockUsagePercent: number;
+    hashingAlgo: string;
+    compressionAlgo: string;
+    enableMmapIndexing: boolean;
+    enableMmapBlockStore: boolean;
+    localRootPath: string;
+    remoteBasePath: string;
+    filerUrl: string;
+    backendUrl: string;
+    jwt: string;
+    jwtExpirationMs: number;
+    apiJwt: string;
+    keepCheckedOut: boolean;
+    workspaceId: string;
+    modifications: Modification[];
+    logLevel: number;
+}
+export interface PullAsyncOptions {
+    versionIndex: string;
+    enableMmapIndexing: boolean;
+    enableMmapBlockStore: boolean;
+    localRootPath: string;
+    remoteBasePath: string;
+    filerUrl: string;
+    jwt: string;
+    jwtExpirationMs: number;
+    logLevel: number;
+}
+export interface MergeAsyncOptions {
+    remoteBasePath: string;
+    filerUrl: string;
+    jwt: string;
+    storeIndexBuffer: Buffer;
+    logLevel: number;
+}
+export interface ReadFileFromVersionAsyncOptions {
+    filePath: string;
+    versionIndexName: string;
+    remoteBasePath: string;
+    filerUrl: string;
+    jwt: string;
+    jwtExpirationMs: number;
+    logLevel: number;
+}
+export { HandleStatus, NativeHandle };
+export declare function GetLogLevel(value: LongtailLogLevel): number;
+export declare function submitAsync(options: SubmitAsyncOptions): NativeHandle;
+export declare function pullAsync(options: PullAsyncOptions): NativeHandle;
+export declare function mergeAsync(options: MergeAsyncOptions): NativeHandle;
+export declare function readFileFromVersionAsync(options: ReadFileFromVersionAsyncOptions): NativeHandle;
+export declare function getHandleStatus(handle: NativeHandle): HandleStatus;
+export declare function getHandleResult(handle: NativeHandle): any;
+export declare function cancelHandle(handle: NativeHandle): void;
+export declare function freeHandle(handle: NativeHandle): void;
+export declare function getReadFileData(handle: NativeHandle): Buffer;
+export declare function getReadFileSize(handle: NativeHandle): number;
+export declare function freeReadFileHandle(handle: NativeHandle): void;
+export interface PollOptions {
+    /** Polling interval in milliseconds (default: 10) */
+    intervalMs?: number;
+    /** Callback invoked on each step change */
+    onStep?: (step: string) => void;
+}
+/**
+ * Polls an async handle until completion. Returns the final status and
+ * optionally the parsed result.
+ *
+ * Usage:
+ * ```ts
+ * const handle = submitAsync({ ... });
+ * const { status, result } = await pollHandle(handle, {
+ *   onStep: (step) => console.log("Step:", step),
+ * });
+ * freeHandle(handle);
+ * ```
+ */
+export declare function pollHandle(handle: NativeHandle, options?: PollOptions): Promise<{
+    status: HandleStatus;
+    result: any;
+}>;
+/**
+ * Polls a read-file handle until completion. Returns the file data as a Buffer.
+ *
+ * Usage:
+ * ```ts
+ * const handle = readFileFromVersionAsync({ ... });
+ * const { data, size } = await pollReadFileHandle(handle);
+ * freeReadFileHandle(handle);
+ * ```
+ */
+export declare function pollReadFileHandle(handle: NativeHandle, options?: PollOptions): Promise<{
+    data: Buffer;
+    size: number;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,143 @@
+"use strict";
+// TypeScript bindings for the longtail-addon N-API module.
+// Drop-in replacement for the Bun FFI-based longtail.ts utilities.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetLogLevel = GetLogLevel;
+exports.submitAsync = submitAsync;
+exports.pullAsync = pullAsync;
+exports.mergeAsync = mergeAsync;
+exports.readFileFromVersionAsync = readFileFromVersionAsync;
+exports.getHandleStatus = getHandleStatus;
+exports.getHandleResult = getHandleResult;
+exports.cancelHandle = cancelHandle;
+exports.freeHandle = freeHandle;
+exports.getReadFileData = getReadFileData;
+exports.getReadFileSize = getReadFileSize;
+exports.freeReadFileHandle = freeReadFileHandle;
+exports.pollHandle = pollHandle;
+exports.pollReadFileHandle = pollReadFileHandle;
+// The native addon — resolved at runtime from the build output
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const addon = require("../build/longtail_addon.node");
+// --------------------------------------------------------------------------
+// Utility functions (matching the old longtail.ts API)
+// --------------------------------------------------------------------------
+function GetLogLevel(value) {
+    switch (value.toLowerCase().trim()) {
+        case "debug":
+            return 0;
+        case "info":
+            return 1;
+        case "warn":
+        case "warning":
+            return 2;
+        case "error":
+            return 3;
+        case "off":
+        default:
+            return 4;
+    }
+}
+// --------------------------------------------------------------------------
+// Async operation wrappers
+// --------------------------------------------------------------------------
+function submitAsync(options) {
+    return addon.submitAsync(options);
+}
+function pullAsync(options) {
+    return addon.pullAsync(options);
+}
+function mergeAsync(options) {
+    return addon.mergeAsync(options);
+}
+function readFileFromVersionAsync(options) {
+    return addon.readFileFromVersionAsync(options);
+}
+// --------------------------------------------------------------------------
+// Handle operations
+// --------------------------------------------------------------------------
+function getHandleStatus(handle) {
+    return addon.getHandleStatus(handle);
+}
+function getHandleResult(handle) {
+    return addon.getHandleResult(handle);
+}
+function cancelHandle(handle) {
+    addon.cancelHandle(handle);
+}
+function freeHandle(handle) {
+    addon.freeHandle(handle);
+}
+function getReadFileData(handle) {
+    return addon.getReadFileData(handle);
+}
+function getReadFileSize(handle) {
+    return addon.getReadFileSize(handle);
+}
+function freeReadFileHandle(handle) {
+    addon.freeReadFileHandle(handle);
+}
+/**
+ * Polls an async handle until completion. Returns the final status and
+ * optionally the parsed result.
+ *
+ * Usage:
+ * ```ts
+ * const handle = submitAsync({ ... });
+ * const { status, result } = await pollHandle(handle, {
+ *   onStep: (step) => console.log("Step:", step),
+ * });
+ * freeHandle(handle);
+ * ```
+ */
+async function pollHandle(handle, options = {}) {
+    const intervalMs = options.intervalMs ?? 10;
+    let lastStep = "";
+    while (true) {
+        const status = getHandleStatus(handle);
+        if (status.currentStep !== lastStep) {
+            lastStep = status.currentStep;
+            if (options.onStep) {
+                options.onStep(status.currentStep);
+            }
+        }
+        if (status.completed) {
+            const result = getHandleResult(handle);
+            return { status, result };
+        }
+        await new Promise((resolve) => setTimeout(resolve, intervalMs));
+    }
+}
+/**
+ * Polls a read-file handle until completion. Returns the file data as a Buffer.
+ *
+ * Usage:
+ * ```ts
+ * const handle = readFileFromVersionAsync({ ... });
+ * const { data, size } = await pollReadFileHandle(handle);
+ * freeReadFileHandle(handle);
+ * ```
+ */
+async function pollReadFileHandle(handle, options = {}) {
+    const intervalMs = options.intervalMs ?? 10;
+    let lastStep = "";
+    while (true) {
+        const status = getHandleStatus(handle);
+        if (status.currentStep !== lastStep) {
+            lastStep = status.currentStep;
+            if (options.onStep) {
+                options.onStep(status.currentStep);
+            }
+        }
+        if (status.completed) {
+            if (status.error !== 0) {
+                throw new Error(`ReadFileFromVersion failed: ${status.currentStep} (error: ${status.error})`);
+            }
+            const data = getReadFileData(handle);
+            const size = getReadFileSize(handle);
+            return { data, size };
+        }
+        await new Promise((resolve) => setTimeout(resolve, intervalMs));
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@checkpointvcs/longtail-addon",
+  "version": "0.0.1",
+  "description": "Node.js N-API addon for the Longtail C++ wrapper",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "license": "(Elastic-2.0 OR AGPL-3.0)",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/checkpointvcs/checkpoint.git",
+    "directory": "src/longtail/addon"
+  },
+  "files": [
+    "dist",
+    "prebuilds"
+  ],
+  "packageManager": "yarn@4.13.0",
+  "scripts": {
+    "build:native": "cmake-js build --config Release",
+    "build:native:msvc": "cmd /c build-msvc.bat",
+    "build:native:msvc:debug": "cmd /c build-msvc.bat debug",
+    "build:ts": "tsc",
+    "build": "yarn run build:native && yarn run build:ts",
+    "clean": "cmake-js clean"
+  },
+  "devDependencies": {
+    "@types/node": "*",
+    "cmake-js": "^8.0.0",
+    "node-addon-api": "^8.3.1",
+    "typescript": "^5.9.3"
+  }
+}