@resourcexjs/core 2.13.0 → 2.14.0

package/dist/index.d.ts

@@ -415,6 +415,21 @@ interface SourceLoader {
 	* @throws ResourceXError if loading fails
 	*/
 	load(source: string): Promise<RXS>;
+	/**
+	* Check if cached content for this source is still fresh.
+	*
+	* Each loader implements its own strategy:
+	* - FolderSourceLoader: compare file mtime against cachedAt
+	* - GitHubSourceLoader: not implemented (always stale)
+	*
+	* Loaders that don't implement this are treated as always stale,
+	* causing a full reload on every ingest.
+	*
+	* @param source - Source path or identifier
+	* @param cachedAt - When the resource was last cached
+	* @returns true if cache is still fresh, false if stale
+	*/
+	isFresh?(source: string, cachedAt: Date): Promise<boolean>;
 }
 /**
 * Default ResourceLoader implementation for loading resources from folders.
@@ -458,6 +473,15 @@ declare class FolderSourceLoader implements SourceLoader {
 	canLoad(source: string): Promise<boolean>;
 	load(source: string): Promise<RXS>;
 	/**
+	* Check if cached content is still fresh by comparing file mtimes.
+	* Returns true only if no file in the directory has been modified since cachedAt.
+	*/
+	isFresh(source: string, cachedAt: Date): Promise<boolean>;
+	/**
+	* Get the most recent mtime across all files in a folder (recursive).
+	*/
+	private getMaxMtime;
+	/**
 	* Recursively read all files in a folder.
 	*/
 	private readFolderFiles;
@@ -560,6 +584,17 @@ declare class SourceLoaderChain {
 	* @throws ResourceXError if no loader matches
 	*/
 	load(source: string): Promise<RXS>;
+	/**
+	* Check if cached content for a source is still fresh.
+	*
+	* Delegates to the matching loader's isFresh method.
+	* Returns false if the loader doesn't implement isFresh (always reload).
+	*
+	* @param source - Source path or identifier
+	* @param cachedAt - When the resource was last cached
+	* @returns true if cache is still fresh
+	*/
+	isFresh(source: string, cachedAt: Date): Promise<boolean>;
 }
 /**
 * Configuration for resolveSource.
@@ -906,6 +941,11 @@ declare class CASRegistry implements Registry {
 	remove(rxi: RXI): Promise<void>;
 	list(options?: SearchOptions): Promise<RXI[]>;
 	/**
+	* Get stored manifest metadata without extracting file contents.
+	* Useful for freshness checks (accessing updatedAt) without the cost of blob retrieval.
+	*/
+	getStoredManifest(rxi: RXI): Promise<StoredRXM | null>;
+	/**
 	* Clear cached resources (resources with registry).
 	* @param registry - If provided, only clear resources from this registry
 	*/

package/dist/index.js

@@ -15008,6 +15008,31 @@ class FolderSourceLoader {
     const files = await this.readFolderFiles(source);
     return { source, files };
   }
+  async isFresh(source, cachedAt) {
+    try {
+      const maxMtime = await this.getMaxMtime(source);
+      return maxMtime <= cachedAt;
+    } catch {
+      return false;
+    }
+  }
+  async getMaxMtime(folderPath) {
+    let max = new Date(0);
+    const entries = await readdir2(folderPath, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = join2(folderPath, entry.name);
+      if (entry.isFile()) {
+        const stats = await stat2(fullPath);
+        if (stats.mtime > max)
+          max = stats.mtime;
+      } else if (entry.isDirectory()) {
+        const subMax = await this.getMaxMtime(fullPath);
+        if (subMax > max)
+          max = subMax;
+      }
+    }
+    return max;
+  }
   async readFolderFiles(folderPath, basePath = folderPath) {
     const files = {};
     const entries = await readdir2(folderPath, { withFileTypes: true });
@@ -15129,6 +15154,17 @@ class SourceLoaderChain {
     }
     throw new ResourceXError(`Cannot load source: ${source}`);
   }
+  async isFresh(source, cachedAt) {
+    for (const loader of this.loaders) {
+      if (await loader.canLoad(source)) {
+        if (loader.isFresh) {
+          return loader.isFresh(source, cachedAt);
+        }
+        return false;
+      }
+    }
+    return false;
+  }
 }
 
 // src/loader/resolveSource.ts
@@ -15337,6 +15373,10 @@ class CASRegistry {
       tag: m.tag
     }));
   }
+  async getStoredManifest(rxi) {
+    const tag = await this.resolveTag(rxi.name, rxi.tag ?? "latest", rxi.registry);
+    return this.rxmStore.get(rxi.name, tag, rxi.registry);
+  }
   async clearCache(registry2) {
     if (registry2) {
       await this.rxmStore.deleteByRegistry(registry2);
@@ -15864,4 +15904,4 @@ export {
   CASRegistry
 };
 
-//# debugId=8AF33945E518861764756E2164756E21
+//# debugId=B122DF8CA052DA8364756E2164756E21