@resourcexjs/core 2.20.0 → 2.22.0

package/dist/index.d.ts

@@ -853,6 +853,14 @@ declare class CASRegistry implements Registry {
 	remove(rxi: RXI): Promise<void>;
 	list(options?: SearchOptions): Promise<RXI[]>;
 	/**
+	* Get a single file from a resource by filename.
+	* Looks up the file's digest in the manifest, then retrieves the blob directly.
+	* Much cheaper than get() — no archive reassembly needed.
+	*
+	* @returns File content as Buffer, or null if resource or file not found.
+	*/
+	getFile(rxi: RXI, file: string): Promise<Buffer | null>;
+	/**
 	* Get stored manifest metadata without extracting file contents.
 	* Useful for freshness checks (accessing updatedAt) without the cost of blob retrieval.
 	*/
@@ -867,6 +875,18 @@ declare class CASRegistry implements Registry {
 	*/
 	gc(): Promise<number>;
 	/**
+	* Append files to an existing resource without re-archiving.
+	*
+	* Leverages per-file CAS storage: only new files are written to blob store,
+	* then the manifest's file map is extended and the digest recomputed.
+	*
+	* @param rxi - Resource identifier (name + tag)
+	* @param newFiles - Files to append: relative path → content
+	* @returns Updated StoredRXM
+	* @throws RegistryError if resource not found
+	*/
+	append(rxi: RXI, newFiles: Record<string, Buffer>): Promise<StoredRXM>;
+	/**
 	* Check if a digest exists in the blob store.
 	* Useful for "instant upload" - skip uploading if server already has it.
 	*/

package/dist/index.js

@@ -15348,6 +15348,16 @@ class CASRegistry {
       tag: m.tag
     }));
   }
+  async getFile(rxi, file2) {
+    const tag = await this.resolveTag(rxi.name, rxi.tag ?? "latest", rxi.registry);
+    const storedRxm = await this.rxmStore.get(rxi.name, tag, rxi.registry);
+    if (!storedRxm)
+      return null;
+    const digest = storedRxm.files[file2];
+    if (!digest)
+      return null;
+    return this.rxaStore.get(digest);
+  }
   async getStoredManifest(rxi) {
     const tag = await this.resolveTag(rxi.name, rxi.tag ?? "latest", rxi.registry);
     return this.rxmStore.get(rxi.name, tag, rxi.registry);
@@ -15382,6 +15392,26 @@ class CASRegistry {
     }
     return deleted;
   }
+  async append(rxi, newFiles) {
+    const tag = await this.resolveTag(rxi.name, rxi.tag ?? "latest", rxi.registry);
+    const existing = await this.rxmStore.get(rxi.name, tag, rxi.registry);
+    if (!existing) {
+      throw new RegistryError(`Resource not found: ${format(rxi)}`);
+    }
+    const mergedFiles = { ...existing.files };
+    for (const [filename, content] of Object.entries(newFiles)) {
+      mergedFiles[filename] = await this.rxaStore.put(content);
+    }
+    const digest = await computeArchiveDigest(mergedFiles);
+    const updated = {
+      ...existing,
+      digest,
+      files: mergedFiles,
+      updatedAt: new Date
+    };
+    await this.rxmStore.put(updated);
+    return updated;
+  }
   async hasBlob(digest) {
     return this.rxaStore.has(digest);
   }
@@ -15740,4 +15770,4 @@ export {
   CASRegistry
 };
 
-//# debugId=72D5E1C3B1B1B3BE64756E2164756E21
+//# debugId=22A475515B34B19264756E2164756E21