@elaraai/e3-core 0.0.1-beta.0

package/dist/src/formats.js

@@ -0,0 +1,115 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import * as fs from 'fs/promises';
+import { createWriteStream } from 'fs';
+import { Readable } from 'stream';
+import { pipeline } from 'stream/promises';
+import { encodeBeast2For, decodeBeast2For, parseFor, printFor, fromJSONFor, IRType, } from '@elaraai/east';
+/**
+ * Load IR from a file (.json, .east, or .beast2)
+ */
+export async function loadIR(filePath) {
+    const ext = filePath.slice(filePath.lastIndexOf('.'));
+    if (ext === '.json') {
+        // JSON format
+        const content = await fs.readFile(filePath, 'utf-8');
+        const jsonValue = JSON.parse(content);
+        const fromJSON = fromJSONFor(IRType);
+        return fromJSON(jsonValue);
+    }
+    else if (ext === '.east') {
+        // .east format
+        const content = await fs.readFile(filePath, 'utf-8');
+        const parser = parseFor(IRType);
+        const result = parser(content);
+        if (!result.success) {
+            throw new Error(`Failed to parse .east file: ${result.error}`);
+        }
+        return result.value;
+    }
+    else if (ext === '.beast2') {
+        // .beast2 format
+        const data = await fs.readFile(filePath);
+        const decoder = decodeBeast2For(IRType);
+        return decoder(data);
+    }
+    else {
+        throw new Error(`Unsupported file format: ${ext} (expected .json, .east, or .beast2)`);
+    }
+}
+/**
+ * Encode IR to Beast2 format
+ */
+export function irToBeast2(ir) {
+    const encoder = encodeBeast2For(IRType);
+    return encoder(ir);
+}
+/**
+ * Write a ReadableStream to a file
+ */
+export async function writeStreamToFile(stream, filePath) {
+    // Convert Web ReadableStream to Node.js Readable
+    const nodeStream = Readable.fromWeb(stream);
+    const writeStream = createWriteStream(filePath);
+    await pipeline(nodeStream, writeStream);
+}
+/**
+ * Load a value from Beast2 file
+ */
+export async function loadBeast2(filePath, type) {
+    const data = await fs.readFile(filePath);
+    const decoder = decodeBeast2For(type);
+    return decoder(data);
+}
+/**
+ * Format a value as .east format
+ */
+export function formatEast(value, type) {
+    const printer = printFor(type);
+    return printer(value);
+}
+/**
+ * Parse a value from .east format
+ */
+export function parseEast(text, type) {
+    const parser = parseFor(type);
+    const result = parser(text);
+    if (!result.success) {
+        throw new Error(`Failed to parse .east: ${result.error}`);
+    }
+    return result.value;
+}
+/**
+ * Load a value from any format (.json, .east, or .beast2)
+ */
+export async function loadValue(filePath, type) {
+    const ext = filePath.slice(filePath.lastIndexOf('.'));
+    if (ext === '.json') {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const jsonValue = JSON.parse(content);
+        const fromJSON = fromJSONFor(type);
+        return fromJSON(jsonValue);
+    }
+    else if (ext === '.east') {
+        const content = await fs.readFile(filePath, 'utf-8');
+        return parseEast(content, type);
+    }
+    else if (ext === '.beast2') {
+        const data = await fs.readFile(filePath);
+        const decoder = decodeBeast2For(type);
+        return decoder(data);
+    }
+    else {
+        throw new Error(`Unsupported file format: ${ext} (expected .json, .east, or .beast2)`);
+    }
+}
+/**
+ * Encode a value to Beast2 format
+ */
+export function valueToBeast2(value, type) {
+    const encoder = encodeBeast2For(type);
+    return encoder(value);
+}
+//# sourceMappingURL=formats.js.map

package/dist/src/formats.js.map

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

package/dist/src/gc.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Options for garbage collection
+ */
+export interface GcOptions {
+    /**
+     * Minimum age in milliseconds for files to be considered for deletion.
+     * Files younger than this are skipped to avoid race conditions with concurrent writes.
+     * Default: 60000 (1 minute)
+     */
+    minAge?: number;
+    /**
+     * If true, only report what would be deleted without actually deleting.
+     * Default: false
+     */
+    dryRun?: boolean;
+}
+/**
+ * Result of garbage collection
+ */
+export interface GcResult {
+    /**
+     * Number of objects deleted
+     */
+    deletedObjects: number;
+    /**
+     * Number of orphaned staging files deleted
+     */
+    deletedPartials: number;
+    /**
+     * Number of objects retained
+     */
+    retainedObjects: number;
+    /**
+     * Number of files skipped due to being too young
+     */
+    skippedYoung: number;
+    /**
+     * Total bytes freed
+     */
+    bytesFreed: number;
+}
+/**
+ * Run garbage collection on an e3 repository.
+ *
+ * @param repoPath - Path to .e3 repository
+ * @param options - GC options
+ * @returns GC result with statistics
+ */
+export declare function repoGc(repoPath: string, options?: GcOptions): Promise<GcResult>;
+//# sourceMappingURL=gc.d.ts.map

package/dist/src/gc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gc.d.ts","sourceRoot":"","sources":["../../src/gc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAsB,MAAM,CAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,SAAc,GACtB,OAAO,CAAC,QAAQ,CAAC,CAkBnB"}

package/dist/src/gc.js

@@ -0,0 +1,232 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Garbage collection for e3 repositories.
+ *
+ * Uses mark-and-sweep algorithm:
+ * 1. Mark: Find all root refs (packages, executions, workspaces) and trace reachable objects
+ * 2. Sweep: Delete unreachable objects and orphaned staging files
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { decodeBeast2For } from '@elaraai/east';
+import { WorkspaceStateType } from '@elaraai/e3-types';
+import { objectRead } from './objects.js';
+/**
+ * Run garbage collection on an e3 repository.
+ *
+ * @param repoPath - Path to .e3 repository
+ * @param options - GC options
+ * @returns GC result with statistics
+ */
+export async function repoGc(repoPath, options = {}) {
+    const minAge = options.minAge ?? 60000; // Default 1 minute
+    const dryRun = options.dryRun ?? false;
+    const now = Date.now();
+    // Step 1: Collect all root hashes
+    const roots = await collectRoots(repoPath);
+    // Step 2: Mark all reachable objects starting from roots
+    const reachable = new Set();
+    for (const root of roots) {
+        await markReachable(repoPath, root, reachable);
+    }
+    // Step 3: Sweep - enumerate all objects and delete unreachable ones
+    const result = await sweep(repoPath, reachable, minAge, now, dryRun);
+    return result;
+}
+/**
+ * Collect all root hashes from refs in packages, executions, and workspaces.
+ */
+async function collectRoots(repoPath) {
+    const roots = new Set();
+    // Collect from packages/<name>/<version> files
+    const packagesDir = path.join(repoPath, 'packages');
+    await collectRefsFromDir(packagesDir, roots, 2); // depth 2: packages/<name>/<version>
+    // Collect from executions/<taskHash>/<inputsHash>/output files
+    const executionsDir = path.join(repoPath, 'executions');
+    await collectRefsFromDir(executionsDir, roots, 3); // depth 3: executions/<taskHash>/<inputsHash>/output
+    // Collect from workspaces/<name>/state.beast2 files
+    const workspacesDir = path.join(repoPath, 'workspaces');
+    await collectWorkspaceRoots(workspacesDir, roots);
+    return roots;
+}
+/**
+ * Collect root hashes from workspace state files.
+ */
+async function collectWorkspaceRoots(workspacesDir, roots) {
+    try {
+        const entries = await fs.readdir(workspacesDir);
+        for (const entry of entries) {
+            if (!entry.endsWith('.beast2'))
+                continue;
+            const stateFile = path.join(workspacesDir, entry);
+            try {
+                const data = await fs.readFile(stateFile);
+                // Skip empty files (undeployed workspaces)
+                if (data.length === 0)
+                    continue;
+                const decoder = decodeBeast2For(WorkspaceStateType);
+                const state = decoder(data);
+                // Add both the package hash and root hash as roots
+                roots.add(state.packageHash);
+                roots.add(state.rootHash);
+            }
+            catch {
+                // State file can't be parsed - skip
+            }
+        }
+    }
+    catch {
+        // Workspaces directory doesn't exist
+    }
+}
+/**
+ * Recursively collect hashes from ref files in a directory.
+ *
+ * @param dir - Directory to scan
+ * @param roots - Set to add found hashes to
+ * @param maxDepth - Maximum depth to traverse
+ */
+async function collectRefsFromDir(dir, roots, maxDepth, currentDepth = 0) {
+    try {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const entryPath = path.join(dir, entry.name);
+            if (entry.isDirectory() && currentDepth < maxDepth) {
+                await collectRefsFromDir(entryPath, roots, maxDepth, currentDepth + 1);
+            }
+            else if (entry.isFile()) {
+                // Read the ref file - it contains a hash
+                try {
+                    const content = await fs.readFile(entryPath, 'utf-8');
+                    const hash = content.trim();
+                    // Validate it looks like a SHA256 hash
+                    if (/^[a-f0-9]{64}$/.test(hash)) {
+                        roots.add(hash);
+                    }
+                }
+                catch {
+                    // Skip files we can't read
+                }
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist or can't be read - that's fine
+    }
+}
+/**
+ * Mark all objects reachable from a root hash.
+ *
+ * Traverses the object graph by scanning for hash patterns in the data.
+ */
+async function markReachable(repoPath, hash, reachable) {
+    // Already visited?
+    if (reachable.has(hash)) {
+        return;
+    }
+    // Try to load the object
+    try {
+        const data = await objectRead(repoPath, hash);
+        reachable.add(hash);
+        // Scan for hash patterns in the data
+        const dataStr = Buffer.from(data).toString('latin1');
+        const hashPattern = /[a-f0-9]{64}/g;
+        const matches = dataStr.matchAll(hashPattern);
+        for (const match of matches) {
+            const potentialHash = match[0];
+            if (!reachable.has(potentialHash)) {
+                // Recursively mark if it exists
+                await markReachable(repoPath, potentialHash, reachable);
+            }
+        }
+    }
+    catch {
+        // Object doesn't exist - not an error, just means this hash
+        // wasn't actually a reference to an object
+    }
+}
+/**
+ * Sweep unreachable objects and orphaned staging files.
+ */
+async function sweep(repoPath, reachable, minAge, now, dryRun) {
+    const objectsDir = path.join(repoPath, 'objects');
+    const result = {
+        deletedObjects: 0,
+        deletedPartials: 0,
+        retainedObjects: 0,
+        skippedYoung: 0,
+        bytesFreed: 0,
+    };
+    try {
+        // Iterate through objects/xx/ directories
+        const subdirs = await fs.readdir(objectsDir);
+        for (const subdir of subdirs) {
+            // Skip if not a 2-char hex directory
+            if (!/^[a-f0-9]{2}$/.test(subdir)) {
+                continue;
+            }
+            const subdirPath = path.join(objectsDir, subdir);
+            const stat = await fs.stat(subdirPath);
+            if (!stat.isDirectory()) {
+                continue;
+            }
+            const files = await fs.readdir(subdirPath);
+            for (const file of files) {
+                const filePath = path.join(subdirPath, file);
+                try {
+                    const fileStat = await fs.stat(filePath);
+                    // Check age - skip young files to avoid race with concurrent writes
+                    const age = now - fileStat.mtimeMs;
+                    if (age < minAge) {
+                        result.skippedYoung++;
+                        continue;
+                    }
+                    // Handle .partial staging files
+                    if (file.endsWith('.partial')) {
+                        if (!dryRun) {
+                            await fs.unlink(filePath);
+                        }
+                        result.deletedPartials++;
+                        result.bytesFreed += fileStat.size;
+                        continue;
+                    }
+                    // Handle .beast2 object files
+                    if (file.endsWith('.beast2')) {
+                        // Reconstruct the hash: subdir (2 chars) + filename without extension
+                        const hash = subdir + file.slice(0, -7); // -7 removes '.beast2'
+                        if (reachable.has(hash)) {
+                            result.retainedObjects++;
+                        }
+                        else {
+                            if (!dryRun) {
+                                await fs.unlink(filePath);
+                            }
+                            result.deletedObjects++;
+                            result.bytesFreed += fileStat.size;
+                        }
+                    }
+                }
+                catch {
+                    // Skip files we can't stat or delete
+                }
+            }
+            // Try to remove empty subdirectory
+            if (!dryRun) {
+                try {
+                    await fs.rmdir(subdirPath);
+                }
+                catch {
+                    // Directory not empty, that's fine
+                }
+            }
+        }
+    }
+    catch {
+        // Objects directory doesn't exist or can't be read
+    }
+    return result;
+}
+//# sourceMappingURL=gc.js.map

package/dist/src/gc.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * e3 Core - Programmatic API for e3 repository operations
+ *
+ * This package provides the filesystem-based business logic for e3,
+ * similar to libgit2 for git. It has no UI dependencies and can be
+ * used programmatically.
+ */
+export { repoInit, repoFind, repoGet, type InitRepositoryResult, } from './repository.js';
+export { repoGc, type GcOptions, type GcResult } from './gc.js';
+export { computeHash, objectWrite, objectWriteStream, objectRead, objectExists, objectPath, objectAbbrev, } from './objects.js';
+export { packageImport, packageExport, packageRemove, packageList, packageResolve, packageRead, type PackageImportResult, type PackageExportResult, } from './packages.js';
+export { workspaceCreate, workspaceRemove, workspaceList, workspaceGetState, workspaceGetPackage, workspaceGetRoot, workspaceSetRoot, workspaceDeploy, workspaceExport, type WorkspaceExportResult, } from './workspaces.js';
+export { treeRead, treeWrite, datasetRead, datasetWrite, type TreeObject, } from './trees.js';
+export { packageListTree, packageGetDataset, workspaceListTree, workspaceGetDataset, workspaceGetDatasetHash, workspaceSetDataset, workspaceSetDatasetByHash, } from './trees.js';
+export { packageListTasks, packageGetTask, workspaceListTasks, workspaceGetTask, workspaceGetTaskHash, } from './tasks.js';
+export { inputsHash, executionPath, executionGet, executionGetOutput, executionListForTask, executionList, executionReadLog, type LogReadOptions, type LogChunk, evaluateCommandIr, isProcessAlive, taskExecute, type ExecuteOptions, type ExecutionResult, } from './executions.js';
+export { dataflowExecute, dataflowGetGraph, type DataflowOptions, type DataflowResult, type TaskExecutionResult, } from './dataflow.js';
+export { E3Error, RepositoryNotFoundError, WorkspaceNotFoundError, WorkspaceNotDeployedError, WorkspaceExistsError, PackageNotFoundError, PackageInvalidError, PackageExistsError, DatasetNotFoundError, TaskNotFoundError, ObjectNotFoundError, ObjectCorruptError, ExecutionCorruptError, DataflowError, PermissionDeniedError, isNotFoundError, isPermissionError, isExistsError, wrapError, } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AAGH,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,MAAM,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGhE,OAAO,EACL,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,UAAU,EACV,YAAY,GACb,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,WAAW,EACX,cAAc,EACd,WAAW,EACX,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,eAAe,EACf,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,KAAK,qBAAqB,GAC3B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,QAAQ,EACR,SAAS,EACT,WAAW,EACX,YAAY,EACZ,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAEL,UAAU,EACV,aAAa,EAEb,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EAEb,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,QAAQ,EAEb,iBAAiB,EAEjB,cAAc,EAEd,WAAW,EACX,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAEL,OAAO,EAEP,uBAAuB,EAEvB,sBAAsB,EACtB,yBAAyB,EACzB,oBAAoB,EAEpB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAElB,oBAAoB,EAEpB,iBAAiB,EAEjB,mBAAmB,EACnB,kBAAkB,EAElB,qBAAqB,EAErB,aAAa,EAEb,qBAAqB,EAErB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,SAAS,GACV,MAAM,aAAa,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,68 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * e3 Core - Programmatic API for e3 repository operations
+ *
+ * This package provides the filesystem-based business logic for e3,
+ * similar to libgit2 for git. It has no UI dependencies and can be
+ * used programmatically.
+ */
+// Repository management
+export { repoInit, repoFind, repoGet, } from './repository.js';
+// Garbage collection
+export { repoGc } from './gc.js';
+// Object storage
+export { computeHash, objectWrite, objectWriteStream, objectRead, objectExists, objectPath, objectAbbrev, } from './objects.js';
+// Package operations
+export { packageImport, packageExport, packageRemove, packageList, packageResolve, packageRead, } from './packages.js';
+// Workspace operations
+export { workspaceCreate, workspaceRemove, workspaceList, workspaceGetState, workspaceGetPackage, workspaceGetRoot, workspaceSetRoot, workspaceDeploy, workspaceExport, } from './workspaces.js';
+// Tree and dataset operations (low-level, by hash)
+export { treeRead, treeWrite, datasetRead, datasetWrite, } from './trees.js';
+// Tree and dataset operations (high-level, by path)
+export { packageListTree, packageGetDataset, workspaceListTree, workspaceGetDataset, workspaceGetDatasetHash, workspaceSetDataset, workspaceSetDatasetByHash, } from './trees.js';
+// Task operations
+export { packageListTasks, packageGetTask, workspaceListTasks, workspaceGetTask, workspaceGetTaskHash, } from './tasks.js';
+// Execution operations
+export { 
+// Identity
+inputsHash, executionPath, 
+// Status
+executionGet, executionGetOutput, executionListForTask, executionList, 
+// Logs
+executionReadLog, 
+// Command IR evaluation
+evaluateCommandIr, 
+// Process detection
+isProcessAlive, 
+// Execution
+taskExecute, } from './executions.js';
+// Dataflow execution
+export { dataflowExecute, dataflowGetGraph, } from './dataflow.js';
+// Errors
+export { 
+// Base
+E3Error, 
+// Repository
+RepositoryNotFoundError, 
+// Workspace
+WorkspaceNotFoundError, WorkspaceNotDeployedError, WorkspaceExistsError, 
+// Package
+PackageNotFoundError, PackageInvalidError, PackageExistsError, 
+// Dataset
+DatasetNotFoundError, 
+// Task
+TaskNotFoundError, 
+// Object
+ObjectNotFoundError, ObjectCorruptError, 
+// Execution
+ExecutionCorruptError, 
+// Dataflow
+DataflowError, 
+// Generic
+PermissionDeniedError, 
+// Helpers
+isNotFoundError, isPermissionError, isExistsError, wrapError, } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AAEH,wBAAwB;AACxB,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,OAAO,GAER,MAAM,iBAAiB,CAAC;AAEzB,qBAAqB;AACrB,OAAO,EAAE,MAAM,EAAiC,MAAM,SAAS,CAAC;AAEhE,iBAAiB;AACjB,OAAO,EACL,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,UAAU,EACV,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,qBAAqB;AACrB,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,WAAW,EACX,cAAc,EACd,WAAW,GAGZ,MAAM,eAAe,CAAC;AAEvB,uBAAuB;AACvB,OAAO,EACL,eAAe,EACf,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,eAAe,GAEhB,MAAM,iBAAiB,CAAC;AAEzB,mDAAmD;AACnD,OAAO,EACL,QAAQ,EACR,SAAS,EACT,WAAW,EACX,YAAY,GAEb,MAAM,YAAY,CAAC;AAEpB,oDAAoD;AACpD,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,kBAAkB;AAClB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,uBAAuB;AACvB,OAAO;AACL,WAAW;AACX,UAAU,EACV,aAAa;AACb,SAAS;AACT,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,aAAa;AACb,OAAO;AACP,gBAAgB;AAGhB,wBAAwB;AACxB,iBAAiB;AACjB,oBAAoB;AACpB,cAAc;AACd,YAAY;AACZ,WAAW,GAGZ,MAAM,iBAAiB,CAAC;AAEzB,qBAAqB;AACrB,OAAO,EACL,eAAe,EACf,gBAAgB,GAIjB,MAAM,eAAe,CAAC;AAEvB,SAAS;AACT,OAAO;AACL,OAAO;AACP,OAAO;AACP,aAAa;AACb,uBAAuB;AACvB,YAAY;AACZ,sBAAsB,EACtB,yBAAyB,EACzB,oBAAoB;AACpB,UAAU;AACV,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB;AAClB,UAAU;AACV,oBAAoB;AACpB,OAAO;AACP,iBAAiB;AACjB,SAAS;AACT,mBAAmB,EACnB,kBAAkB;AAClB,YAAY;AACZ,qBAAqB;AACrB,WAAW;AACX,aAAa;AACb,UAAU;AACV,qBAAqB;AACrB,UAAU;AACV,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,SAAS,GACV,MAAM,aAAa,CAAC"}

package/dist/src/objects.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Calculate SHA256 hash of data
+ */
+export declare function computeHash(data: Uint8Array): string;
+/**
+ * Atomically write an object to the repository
+ *
+ * @param repoPath - Path to .e3 repository
+ * @param data - Data to store
+ * @returns SHA256 hash of the data
+ */
+export declare function objectWrite(repoPath: string, data: Uint8Array): Promise<string>;
+/**
+ * Atomically write a stream to the repository
+ *
+ * @param repoPath - Path to .e3 repository
+ * @param stream - Stream to store
+ * @returns SHA256 hash of the data
+ */
+export declare function objectWriteStream(repoPath: string, stream: ReadableStream<Uint8Array>): Promise<string>;
+/**
+ * Read an object from the repository
+ *
+ * @param repoPath - Path to .e3 repository
+ * @param hash - SHA256 hash of the object
+ * @returns Object data
+ * @throws {ObjectNotFoundError} If object not found
+ */
+export declare function objectRead(repoPath: string, hash: string): Promise<Uint8Array>;
+/**
+ * Check if an object exists in the repository
+ *
+ * @param repoPath - Path to .e3 repository
+ * @param hash - SHA256 hash of the object
+ * @returns true if object exists
+ */
+export declare function objectExists(repoPath: string, hash: string): Promise<boolean>;
+/**
+ * Get the filesystem path for an object
+ *
+ * @param repoPath - Path to .e3 repository
+ * @param hash - SHA256 hash of the object
+ * @returns Filesystem path: objects/<hash[0..2]>/<hash[2..]>.beast2
+ */
+export declare function objectPath(repoPath: string, hash: string): string;
+/**
+ * Get the minimum unambiguous prefix length for an object hash.
+ *
+ * Scans the object store to find the shortest prefix of the given hash
+ * that uniquely identifies it among all stored objects.
+ *
+ * @param repoPath - Path to .e3 repository
+ * @param hash - Full SHA256 hash of the object
+ * @param minLength - Minimum prefix length to return (default: 4)
+ * @returns Minimum unambiguous prefix length
+ */
+export declare function objectAbbrev(repoPath: string, hash: string, minLength?: number): Promise<number>;
+//# sourceMappingURL=objects.d.ts.map

package/dist/src/objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../../src/objects.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEpD;AA4BD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,MAAM,CAAC,CAiDjB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GACjC,OAAO,CAAC,MAAM,CAAC,CAuDjB;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,UAAU,CAAC,CAerB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC,CASlB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIjE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,MAAU,GACpB,OAAO,CAAC,MAAM,CAAC,CAwCjB"}