@elaraai/e3-core 0.0.1-alpha.2

package/dist/src/workspaces.js

@@ -0,0 +1,390 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Workspace operations for e3 repositories.
+ *
+ * Workspaces are mutable working copies of packages. They allow:
+ * - Deploying a package to create a working environment
+ * - Modifying data (inputs/outputs)
+ * - Exporting changes back to a new package version
+ *
+ * State is stored in workspaces/<name>.beast2 as a single atomic file.
+ * No state file means the workspace does not exist.
+ */
+import * as fs from 'fs/promises';
+import { createWriteStream } from 'fs';
+import * as path from 'path';
+import yazl from 'yazl';
+import { decodeBeast2For, encodeBeast2For } from '@elaraai/east';
+import { PackageObjectType, WorkspaceStateType } from '@elaraai/e3-types';
+import { objectRead, objectWrite } from './objects.js';
+import { packageResolve, packageRead } from './packages.js';
+import { WorkspaceNotFoundError, WorkspaceNotDeployedError, WorkspaceExistsError, isNotFoundError, } from './errors.js';
+import { acquireWorkspaceLock } from './workspaceLock.js';
+/**
+ * Get the path to a workspace's state file.
+ */
+function statePath(repoPath, name) {
+    return path.join(repoPath, 'workspaces', `${name}.beast2`);
+}
+/**
+ * Atomically write workspace state.
+ */
+async function writeState(repoPath, name, state) {
+    const wsDir = path.join(repoPath, 'workspaces');
+    const stateFile = statePath(repoPath, name);
+    // Ensure workspaces directory exists
+    await fs.mkdir(wsDir, { recursive: true });
+    const encoder = encodeBeast2For(WorkspaceStateType);
+    const data = encoder(state);
+    // Write atomically: write to temp file, then rename
+    const randomSuffix = Math.random().toString(36).slice(2, 10);
+    const tempPath = path.join(wsDir, `.${name}.${Date.now()}.${randomSuffix}.tmp`);
+    await fs.writeFile(tempPath, data);
+    await fs.rename(tempPath, stateFile);
+}
+/**
+ * Read workspace state.
+ * Returns { exists: false } if workspace doesn't exist.
+ * Returns { exists: true, deployed: false } if workspace exists but not deployed.
+ * Returns { exists: true, deployed: true, state } if workspace is deployed.
+ */
+async function readState(repoPath, name) {
+    const stateFile = statePath(repoPath, name);
+    try {
+        const data = await fs.readFile(stateFile);
+        // Empty file means workspace exists but is not deployed
+        if (data.length === 0) {
+            return { exists: true, deployed: false };
+        }
+        const decoder = decodeBeast2For(WorkspaceStateType);
+        return { exists: true, deployed: true, state: decoder(data) };
+    }
+    catch (err) {
+        if (isNotFoundError(err)) {
+            return { exists: false };
+        }
+        throw err;
+    }
+}
+/**
+ * Read workspace state, throwing if workspace doesn't exist or is not deployed.
+ * @throws {WorkspaceNotFoundError} If workspace doesn't exist
+ * @throws {WorkspaceNotDeployedError} If workspace exists but has no package deployed
+ */
+async function readStateOrThrow(repoPath, name) {
+    const result = await readState(repoPath, name);
+    if (!result.exists) {
+        throw new WorkspaceNotFoundError(name);
+    }
+    if (!result.deployed) {
+        throw new WorkspaceNotDeployedError(name);
+    }
+    return result.state;
+}
+/**
+ * Create an empty workspace.
+ *
+ * Creates an undeployed workspace (state file with null package info).
+ * Use workspaceDeploy to deploy a package.
+ *
+ * @param repoPath - Path to .e3 repository
+ * @param name - Workspace name
+ * @throws {WorkspaceExistsError} If workspace already exists
+ */
+export async function workspaceCreate(repoPath, name) {
+    const stateFile = statePath(repoPath, name);
+    // Check if workspace already exists
+    try {
+        await fs.access(stateFile);
+        throw new WorkspaceExistsError(name);
+    }
+    catch (err) {
+        if (err instanceof WorkspaceExistsError)
+            throw err;
+        if (!isNotFoundError(err)) {
+            throw err;
+        }
+    }
+    // Create workspaces directory if needed
+    const wsDir = path.join(repoPath, 'workspaces');
+    await fs.mkdir(wsDir, { recursive: true });
+    // Create empty file to mark workspace as existing but not deployed
+    // We use an empty file rather than a state file since there's no valid state yet
+    await fs.writeFile(stateFile, '');
+}
+/**
+ * Remove a workspace.
+ *
+ * Objects remain until repoGc is run.
+ *
+ * Acquires a workspace lock to prevent removing a workspace while a dataflow
+ * is running. Throws WorkspaceLockError if the workspace is currently locked.
+ *
+ * @param repoPath - Path to .e3 repository
+ * @param name - Workspace name
+ * @param options - Optional settings including external lock
+ * @throws {WorkspaceNotFoundError} If workspace doesn't exist
+ * @throws {WorkspaceLockError} If workspace is locked by another process
+ */
+export async function workspaceRemove(repoPath, name, options = {}) {
+    // Acquire lock if not provided externally
+    const externalLock = options.lock;
+    const lock = externalLock ?? await acquireWorkspaceLock(repoPath, name);
+    try {
+        const stateFile = statePath(repoPath, name);
+        try {
+            await fs.unlink(stateFile);
+        }
+        catch (err) {
+            if (isNotFoundError(err)) {
+                throw new WorkspaceNotFoundError(name);
+            }
+            throw err;
+        }
+    }
+    finally {
+        // Only release the lock if we acquired it internally
+        if (!externalLock) {
+            await lock.release();
+        }
+    }
+}
+/**
+ * List workspace names.
+ *
+ * @param repoPath - Path to .e3 repository
+ * @returns Array of workspace names
+ */
+export async function workspaceList(repoPath) {
+    const workspacesDir = path.join(repoPath, 'workspaces');
+    const names = [];
+    try {
+        const entries = await fs.readdir(workspacesDir);
+        for (const entry of entries) {
+            if (entry.endsWith('.beast2')) {
+                names.push(entry.slice(0, -7)); // Remove .beast2 extension
+            }
+        }
+    }
+    catch {
+        // workspaces directory doesn't exist
+    }
+    return names;
+}
+/**
+ * Get the full state for a workspace.
+ *
+ * @param repoPath - Path to .e3 repository
+ * @param name - Workspace name
+ * @returns Workspace state, or null if workspace doesn't exist or is not deployed
+ */
+export async function workspaceGetState(repoPath, name) {
+    const result = await readState(repoPath, name);
+    if (!result.exists || !result.deployed) {
+        return null;
+    }
+    return result.state;
+}
+/**
+ * Get the deployed package for a workspace.
+ *
+ * @param repoPath - Path to .e3 repository
+ * @param name - Workspace name
+ * @returns Package name, version, and hash
+ * @throws {WorkspaceNotFoundError} If workspace doesn't exist
+ * @throws {WorkspaceNotDeployedError} If workspace exists but has no package deployed
+ */
+export async function workspaceGetPackage(repoPath, name) {
+    const state = await readStateOrThrow(repoPath, name);
+    return {
+        name: state.packageName,
+        version: state.packageVersion,
+        hash: state.packageHash,
+    };
+}
+/**
+ * Get the root tree hash for a workspace.
+ *
+ * @param repoPath - Path to .e3 repository
+ * @param name - Workspace name
+ * @returns Root tree object hash
+ * @throws {WorkspaceNotFoundError} If workspace doesn't exist
+ * @throws {WorkspaceNotDeployedError} If workspace exists but has no package deployed
+ */
+export async function workspaceGetRoot(repoPath, name) {
+    const state = await readStateOrThrow(repoPath, name);
+    return state.rootHash;
+}
+/**
+ * Atomically update the root tree hash for a workspace.
+ *
+ * @param repoPath - Path to .e3 repository
+ * @param name - Workspace name
+ * @param hash - New root tree object hash
+ * @throws {WorkspaceNotFoundError} If workspace doesn't exist
+ * @throws {WorkspaceNotDeployedError} If workspace exists but has no package deployed
+ */
+export async function workspaceSetRoot(repoPath, name, hash) {
+    const state = await readStateOrThrow(repoPath, name);
+    const newState = {
+        ...state,
+        rootHash: hash,
+        rootUpdatedAt: new Date(),
+    };
+    await writeState(repoPath, name, newState);
+}
+/**
+ * Deploy a package to a workspace.
+ *
+ * Creates the workspace if it doesn't exist. Writes state file atomically
+ * containing deployment info and root hash.
+ *
+ * Acquires a workspace lock to prevent conflicts with running dataflows
+ * or concurrent deploys. Throws WorkspaceLockError if the workspace is
+ * currently locked by another process.
+ *
+ * @param repoPath - Path to .e3 repository
+ * @param name - Workspace name
+ * @param pkgName - Package name
+ * @param pkgVersion - Package version
+ * @param options - Optional settings including external lock
+ * @throws {WorkspaceLockError} If workspace is locked by another process
+ */
+export async function workspaceDeploy(repoPath, name, pkgName, pkgVersion, options = {}) {
+    // Acquire lock if not provided externally
+    const externalLock = options.lock;
+    const lock = externalLock ?? await acquireWorkspaceLock(repoPath, name);
+    try {
+        // Resolve package hash and read package object
+        const packageHash = await packageResolve(repoPath, pkgName, pkgVersion);
+        const pkg = await packageRead(repoPath, pkgName, pkgVersion);
+        const now = new Date();
+        const state = {
+            packageName: pkgName,
+            packageVersion: pkgVersion,
+            packageHash,
+            deployedAt: now,
+            rootHash: pkg.data.value,
+            rootUpdatedAt: now,
+        };
+        await writeState(repoPath, name, state);
+    }
+    finally {
+        // Only release the lock if we acquired it internally
+        if (!externalLock) {
+            await lock.release();
+        }
+    }
+}
+/**
+ * Fixed mtime for deterministic zip output (Unix epoch)
+ */
+const DETERMINISTIC_MTIME = new Date(0);
+/**
+ * Export a workspace as a package.
+ *
+ * 1. Read workspace state
+ * 2. Read deployed package structure using stored packageHash
+ * 3. Create new PackageObject with data.value set to current rootHash
+ * 4. Collect all referenced objects
+ * 5. Write to .zip
+ *
+ * @param repoPath - Path to .e3 repository
+ * @param name - Workspace name
+ * @param zipPath - Path to write the .zip file
+ * @param outputName - Package name (default: deployed package name)
+ * @param version - Package version (default: <pkgVersion>-<rootHash[0..8]>)
+ * @returns Export result with package info
+ * @throws {WorkspaceNotFoundError} If workspace doesn't exist
+ * @throws {WorkspaceNotDeployedError} If workspace exists but has no package deployed
+ */
+export async function workspaceExport(repoPath, name, zipPath, outputName, version) {
+    const partialPath = `${zipPath}.partial`;
+    // Get workspace state
+    const state = await readStateOrThrow(repoPath, name);
+    // Read the deployed package object using the stored hash
+    const deployedPkgData = await objectRead(repoPath, state.packageHash);
+    const decoder = decodeBeast2For(PackageObjectType);
+    const deployedPkgObject = decoder(Buffer.from(deployedPkgData));
+    // Determine output name and version
+    const finalName = outputName ?? state.packageName;
+    const finalVersion = version ?? `${state.packageVersion}-${state.rootHash.slice(0, 8)}`;
+    // Create new PackageObject with updated root
+    const newPkgObject = {
+        tasks: deployedPkgObject.tasks,
+        data: {
+            structure: deployedPkgObject.data.structure,
+            value: state.rootHash,
+        },
+    };
+    // Encode and store the new package object
+    const encoder = encodeBeast2For(PackageObjectType);
+    const pkgData = encoder(newPkgObject);
+    const packageHash = await objectWrite(repoPath, pkgData);
+    // Create zip file
+    const zipfile = new yazl.ZipFile();
+    // Track which objects we've added to avoid duplicates
+    const addedObjects = new Set();
+    // Helper to add an object to the zip
+    const addObject = async (hash) => {
+        if (addedObjects.has(hash))
+            return;
+        addedObjects.add(hash);
+        const data = await objectRead(repoPath, hash);
+        const objPath = `objects/${hash.slice(0, 2)}/${hash.slice(2)}.beast2`;
+        zipfile.addBuffer(Buffer.from(data), objPath, { mtime: DETERMINISTIC_MTIME });
+    };
+    // Helper to collect children from a tree object (same as packages.ts)
+    const collectTreeChildren = async (treeData) => {
+        const dataStr = Buffer.from(treeData).toString('latin1');
+        const hashPattern = /[a-f0-9]{64}/g;
+        const matches = dataStr.matchAll(hashPattern);
+        for (const match of matches) {
+            const potentialHash = match[0];
+            if (addedObjects.has(potentialHash))
+                continue;
+            try {
+                await addObject(potentialHash);
+                const childData = await objectRead(repoPath, potentialHash);
+                await collectTreeChildren(childData);
+            }
+            catch {
+                addedObjects.delete(potentialHash);
+            }
+        }
+    };
+    // Add the package object
+    await addObject(packageHash);
+    // Collect all task objects
+    for (const taskHash of newPkgObject.tasks.values()) {
+        await addObject(taskHash);
+    }
+    // Collect the root tree and all its children
+    await addObject(state.rootHash);
+    const rootTreeData = await objectRead(repoPath, state.rootHash);
+    await collectTreeChildren(rootTreeData);
+    // Write the package ref
+    const refPath = `packages/${finalName}/${finalVersion}`;
+    zipfile.addBuffer(Buffer.from(packageHash + '\n'), refPath, { mtime: DETERMINISTIC_MTIME });
+    // Finalize and write zip to disk
+    await new Promise((resolve, reject) => {
+        const writeStream = createWriteStream(partialPath);
+        zipfile.outputStream.pipe(writeStream);
+        zipfile.outputStream.on('error', reject);
+        writeStream.on('error', reject);
+        writeStream.on('close', resolve);
+        zipfile.end();
+    });
+    // Atomic rename to final path
+    await fs.rename(partialPath, zipPath);
+    return {
+        packageHash,
+        objectCount: addedObjects.size,
+        name: finalName,
+        version: finalVersion,
+    };
+}
+//# sourceMappingURL=workspaces.js.map

package/dist/src/workspaces.js.map

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

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@elaraai/e3-core",
+  "version": "0.0.1-alpha.2",
+  "type": "module",
+  "description": "East Execution Engine Core - Programmatic API for e3 repository operations",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    },
+    "./test": {
+      "types": "./dist/src/test-helpers.d.ts",
+      "default": "./dist/src/test-helpers.js"
+    }
+  },
+  "files": [
+    "dist/src",
+    "!dist/src/**/*.spec.*",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc --build",
+    "test": "npm run build && node --enable-source-maps --test 'dist/src/**/*.spec.js'",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
+  },
+  "keywords": [
+    "east",
+    "e3",
+    "core",
+    "library"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elaraai/e3",
+    "directory": "packages/e3-core"
+  },
+  "dependencies": {
+    "@elaraai/e3": "*",
+    "@elaraai/e3-types": "*",
+    "@elaraai/east": "^0.0.1-beta.14",
+    "yauzl": "^3.2.0",
+    "yazl": "^2.5.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/yauzl": "^2.10.3",
+    "@types/yazl": "^2.4.5",
+    "@typescript-eslint/eslint-plugin": "^8.47.0",
+    "@typescript-eslint/parser": "^8.47.0",
+    "eslint": "^9.0.0",
+    "eslint-plugin-headers": "^1.3.3",
+    "typescript": "^5.6.0"
+  }
+}