@elaraai/e3-core 0.0.2-beta.4 → 0.0.2-beta.40

package/dist/src/workspaces.d.ts

@@ -3,18 +3,27 @@
  * Licensed under BSL 1.1. See LICENSE for details.
  */
 import type { WorkspaceState } from '@elaraai/e3-types';
-import { type WorkspaceLockHandle } from './workspaceLock.js';
+import type { StorageBackend, LockHandle } from './storage/interfaces.js';
+/**
+ * List workspace names.
+ *
+ * @param storage - Storage backend
+ * @param repo - Repository identifier
+ * @returns Array of workspace names
+ */
+export declare function workspaceList(storage: StorageBackend, repo: string): Promise<string[]>;
 /**
  * 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 storage - Storage backend
+ * @param repo - Repository identifier
  * @param name - Workspace name
  * @throws {WorkspaceExistsError} If workspace already exists
  */
-export declare function workspaceCreate(repoPath: string, name: string): Promise<void>;
+export declare function workspaceCreate(storage: StorageBackend, repo: string, name: string): Promise<void>;
 /**
  * Options for workspace removal.
  */
@@ -24,7 +33,7 @@ export interface WorkspaceRemoveOptions {
      * for releasing the lock after the operation. If not provided, workspaceRemove
      * will acquire and release a lock internally.
      */
-    lock?: WorkspaceLockHandle;
+    lock?: LockHandle;
 }
 /**
  * Remove a workspace.
@@ -34,62 +43,38 @@ export interface WorkspaceRemoveOptions {
  * 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 storage - Storage backend
+ * @param repo - Repository identifier
  * @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 declare function workspaceRemove(repoPath: string, name: string, options?: WorkspaceRemoveOptions): Promise<void>;
-/**
- * List workspace names.
- *
- * @param repoPath - Path to .e3 repository
- * @returns Array of workspace names
- */
-export declare function workspaceList(repoPath: string): Promise<string[]>;
+export declare function workspaceRemove(storage: StorageBackend, repo: string, name: string, options?: WorkspaceRemoveOptions): Promise<void>;
 /**
  * Get the full state for a workspace.
  *
- * @param repoPath - Path to .e3 repository
+ * @param storage - Storage backend
+ * @param repo - Repository identifier
  * @param name - Workspace name
  * @returns Workspace state, or null if workspace doesn't exist or is not deployed
  */
-export declare function workspaceGetState(repoPath: string, name: string): Promise<WorkspaceState | null>;
+export declare function workspaceGetState(storage: StorageBackend, repo: string, name: string): Promise<WorkspaceState | null>;
 /**
  * Get the deployed package for a workspace.
  *
- * @param repoPath - Path to .e3 repository
+ * @param storage - Storage backend
+ * @param repo - Repository identifier
  * @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 declare function workspaceGetPackage(repoPath: string, name: string): Promise<{
+export declare function workspaceGetPackage(storage: StorageBackend, repo: string, name: string): Promise<{
     name: string;
     version: string;
     hash: string;
 }>;
-/**
- * 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 declare function workspaceGetRoot(repoPath: string, name: string): Promise<string>;
-/**
- * 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 declare function workspaceSetRoot(repoPath: string, name: string, hash: string): Promise<void>;
 /**
  * Options for workspace deployment.
  */
@@ -99,26 +84,28 @@ export interface WorkspaceDeployOptions {
      * for releasing the lock after the operation. If not provided, workspaceDeploy
      * will acquire and release a lock internally.
      */
-    lock?: WorkspaceLockHandle;
+    lock?: LockHandle;
 }
 /**
  * Deploy a package to a workspace.
  *
  * Creates the workspace if it doesn't exist. Writes state file atomically
- * containing deployment info and root hash.
+ * containing deployment info. Initializes per-dataset ref files from the
+ * package's data/ directory.
  *
  * 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 storage - Storage backend
+ * @param repo - Repository identifier
  * @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 declare function workspaceDeploy(repoPath: string, name: string, pkgName: string, pkgVersion: string, options?: WorkspaceDeployOptions): Promise<void>;
+export declare function workspaceDeploy(storage: StorageBackend, repo: string, name: string, pkgName: string, pkgVersion: string, options?: WorkspaceDeployOptions): Promise<void>;
 /**
  * Result of exporting a workspace
  */
@@ -133,18 +120,19 @@ export interface WorkspaceExportResult {
  *
  * 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
+ * 3. Create new PackageObject with current structure
+ * 4. Collect all referenced objects from dataset refs
+ * 5. Write per-dataset refs and objects to .zip
  *
- * @param repoPath - Path to .e3 repository
+ * @param storage - Storage backend
+ * @param repo - Repository identifier
  * @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]>)
+ * @param version - Package version (default: <pkgVersion>-<short hash>)
  * @returns Export result with package info
  * @throws {WorkspaceNotFoundError} If workspace doesn't exist
  * @throws {WorkspaceNotDeployedError} If workspace exists but has no package deployed
  */
-export declare function workspaceExport(repoPath: string, name: string, zipPath: string, outputName?: string, version?: string): Promise<WorkspaceExportResult>;
+export declare function workspaceExport(storage: StorageBackend, repo: string, name: string, zipPath: string, outputName?: string, version?: string): Promise<WorkspaceExportResult>;
 //# sourceMappingURL=workspaces.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../../src/workspaces.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoBH,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,mBAAmB,CAAC;AASvE,OAAO,EAAwB,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AA6EpF;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC5B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAgBnB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAMhC;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAO1D;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAOD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,qBAAqB,CAAC,CAqGhC"}
+{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../../src/workspaces.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH,OAAO,KAAK,EAAiB,cAAc,EAA0B,MAAM,mBAAmB,CAAC;AAS/F,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1E;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE5F;AA0DD;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAMhC;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAO1D;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAyCf;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAOD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,qBAAqB,CAAC,CAmMhC"}