@elaraai/e3-core 0.0.1-beta.0

package/dist/src/objects.js

@@ -0,0 +1,245 @@
+/**
+ * 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 * as path from 'path';
+import * as crypto from 'crypto';
+import { Readable } from 'stream';
+import { pipeline } from 'stream/promises';
+import { createWriteStream } from 'fs';
+import { ObjectNotFoundError, isNotFoundError } from './errors.js';
+/**
+ * Calculate SHA256 hash of data
+ */
+export function computeHash(data) {
+    return crypto.createHash('sha256').update(data).digest('hex');
+}
+/**
+ * Calculate SHA256 hash of a stream
+ * @internal
+ */
+async function computeHashFromStream(stream) {
+    const hash = crypto.createHash('sha256');
+    const chunks = [];
+    const reader = stream.getReader();
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        hash.update(value);
+        chunks.push(value);
+    }
+    return {
+        hash: hash.digest('hex'),
+        data: chunks,
+    };
+}
+/**
+ * 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 async function objectWrite(repoPath, data) {
+    const extension = '.beast2';
+    const hash = computeHash(data);
+    // Split hash: first 2 chars as directory
+    const dirName = hash.slice(0, 2);
+    const fileName = hash.slice(2) + extension;
+    const dirPath = path.join(repoPath, 'objects', dirName);
+    const filePath = path.join(dirPath, fileName);
+    // Check if already exists
+    try {
+        await fs.access(filePath);
+        return hash; // Already exists
+    }
+    catch {
+        // Doesn't exist, continue
+    }
+    // Create directory if needed
+    await fs.mkdir(dirPath, { recursive: true });
+    // Write atomically: stage in same directory (same filesystem) + rename
+    // Staging files use .partial extension; gc can clean up any orphaned ones
+    // Use random suffix to avoid collisions with concurrent writes
+    const randomSuffix = Math.random().toString(36).slice(2, 10);
+    const stagingPath = path.join(dirPath, `${fileName}.${Date.now()}.${randomSuffix}.partial`);
+    await fs.writeFile(stagingPath, data);
+    try {
+        await fs.rename(stagingPath, filePath);
+    }
+    catch (err) {
+        // If rename fails because target exists (concurrent write won), that's fine
+        // Clean up our staging file
+        try {
+            await fs.unlink(stagingPath);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        // Verify the file exists (another writer should have created it)
+        try {
+            await fs.access(filePath);
+        }
+        catch {
+            // File doesn't exist and rename failed - re-throw original error
+            throw err;
+        }
+    }
+    return hash;
+}
+/**
+ * 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 async function objectWriteStream(repoPath, stream) {
+    const extension = '.beast2';
+    // First pass: compute hash while collecting data
+    const { hash, data } = await computeHashFromStream(stream);
+    // Split hash: first 2 chars as directory
+    const dirName = hash.slice(0, 2);
+    const fileName = hash.slice(2) + extension;
+    const dirPath = path.join(repoPath, 'objects', dirName);
+    const filePath = path.join(dirPath, fileName);
+    // Check if already exists
+    try {
+        await fs.access(filePath);
+        return hash; // Already exists
+    }
+    catch {
+        // Doesn't exist, continue
+    }
+    // Create directory if needed
+    await fs.mkdir(dirPath, { recursive: true });
+    // Write atomically: stage in same directory (same filesystem) + rename
+    // Staging files use .partial extension; gc can clean up any orphaned ones
+    // Use random suffix to avoid collisions with concurrent writes
+    const randomSuffix = Math.random().toString(36).slice(2, 10);
+    const stagingPath = path.join(dirPath, `${fileName}.${Date.now()}.${randomSuffix}.partial`);
+    // Reconstruct stream from collected chunks
+    const nodeStream = Readable.from(data);
+    const writeStream = createWriteStream(stagingPath);
+    await pipeline(nodeStream, writeStream);
+    try {
+        await fs.rename(stagingPath, filePath);
+    }
+    catch (err) {
+        // If rename fails because target exists (concurrent write won), that's fine
+        // Clean up our staging file
+        try {
+            await fs.unlink(stagingPath);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        // Verify the file exists (another writer should have created it)
+        try {
+            await fs.access(filePath);
+        }
+        catch {
+            // File doesn't exist and rename failed - re-throw original error
+            throw err;
+        }
+    }
+    return hash;
+}
+/**
+ * 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 async function objectRead(repoPath, hash) {
+    const extension = '.beast2';
+    const dirName = hash.slice(0, 2);
+    const fileName = hash.slice(2) + extension;
+    const filePath = path.join(repoPath, 'objects', dirName, fileName);
+    try {
+        return await fs.readFile(filePath);
+    }
+    catch (err) {
+        if (isNotFoundError(err)) {
+            throw new ObjectNotFoundError(hash);
+        }
+        throw err;
+    }
+}
+/**
+ * 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 async function objectExists(repoPath, hash) {
+    const filePath = objectPath(repoPath, hash);
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 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 function objectPath(repoPath, hash) {
+    const dirName = hash.slice(0, 2);
+    const fileName = hash.slice(2) + '.beast2';
+    return path.join(repoPath, 'objects', dirName, fileName);
+}
+/**
+ * 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 async function objectAbbrev(repoPath, hash, minLength = 4) {
+    const objectsDir = path.join(repoPath, 'objects');
+    const targetPrefix = hash.slice(0, 2);
+    // Collect all hashes that share the same 2-char prefix directory
+    const hashes = [];
+    try {
+        const dirPath = path.join(objectsDir, targetPrefix);
+        const entries = await fs.readdir(dirPath);
+        for (const entry of entries) {
+            if (entry.endsWith('.beast2') && !entry.includes('.partial')) {
+                // Reconstruct full hash: dir prefix + filename without extension
+                const fullHash = targetPrefix + entry.slice(0, -7); // remove '.beast2'
+                hashes.push(fullHash);
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist - hash is unique at minimum length
+        return minLength;
+    }
+    // Find minimum length that disambiguates from all other hashes
+    let length = minLength;
+    while (length < hash.length) {
+        const prefix = hash.slice(0, length);
+        const conflicts = hashes.filter((h) => h !== hash && h.startsWith(prefix));
+        if (conflicts.length === 0) {
+            return length;
+        }
+        length++;
+    }
+    return hash.length;
+}
+//# sourceMappingURL=objects.js.map

package/dist/src/objects.js.map

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

package/dist/src/packages.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import type { PackageObject } from '@elaraai/e3-types';
+/**
+ * Result of importing a package
+ */
+export interface PackageImportResult {
+    name: string;
+    version: string;
+    packageHash: string;
+    objectCount: number;
+}
+/**
+ * Import a package from a .zip file into the repository.
+ *
+ * Extracts objects to `objects/`, creates ref at `packages/<name>/<version>`.
+ *
+ * @param repoPath - Path to .e3 repository
+ * @param zipPath - Path to the .zip package file
+ * @returns Import result with package name, version, and stats
+ */
+export declare function packageImport(repoPath: string, zipPath: string): Promise<PackageImportResult>;
+/**
+ * Remove a package ref from the repository.
+ *
+ * Objects remain until gc is run.
+ *
+ * @param repoPath - Path to .e3 repository
+ * @param name - Package name
+ * @param version - Package version
+ * @throws {PackageNotFoundError} If package doesn't exist
+ */
+export declare function packageRemove(repoPath: string, name: string, version: string): Promise<void>;
+/**
+ * List all installed packages.
+ *
+ * @param repoPath - Path to .e3 repository
+ * @returns Array of (name, version) pairs
+ */
+export declare function packageList(repoPath: string): Promise<Array<{
+    name: string;
+    version: string;
+}>>;
+/**
+ * Resolve a package to its PackageObject hash.
+ *
+ * @param repoPath - Path to .e3 repository
+ * @param name - Package name
+ * @param version - Package version
+ * @returns PackageObject hash
+ * @throws {PackageNotFoundError} If package doesn't exist
+ */
+export declare function packageResolve(repoPath: string, name: string, version: string): Promise<string>;
+/**
+ * Read and parse a PackageObject.
+ *
+ * @param repoPath - Path to .e3 repository
+ * @param name - Package name
+ * @param version - Package version
+ * @returns Parsed PackageObject
+ * @throws {PackageNotFoundError} If package doesn't exist
+ */
+export declare function packageRead(repoPath: string, name: string, version: string): Promise<PackageObject>;
+/**
+ * Result of exporting a package
+ */
+export interface PackageExportResult {
+    packageHash: string;
+    objectCount: number;
+}
+/**
+ * Export a package to a .zip file.
+ *
+ * Collects the package object and all transitively referenced objects.
+ *
+ * @param repoPath - Path to .e3 repository
+ * @param name - Package name
+ * @param version - Package version
+ * @param zipPath - Path to write the .zip file
+ * @returns Export result with package hash and object count
+ */
+export declare function packageExport(repoPath: string, name: string, version: string, zipPath: string): Promise<PackageExportResult>;
+//# sourceMappingURL=packages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packages.d.ts","sourceRoot":"","sources":["../../src/packages.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAQvD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,CAAC,CAkE9B;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAqBnD;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,CAAC,CAKxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAOD;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,CAAC,CAoG9B"}