@resourcexjs/core 2.12.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.
@@ -765,6 +800,14 @@ interface ProviderDefaults {
 	registry?: string;
 }
 /**
+* Registry entry in configuration.
+*/
+interface RegistryEntry {
+	name: string;
+	url: string;
+	default?: boolean;
+}
+/**
 * ResourceX Provider - Platform implementation interface.
 *
 * Platforms implement this interface to provide storage and loading
@@ -797,6 +840,22 @@ interface ResourceXProvider {
 	* Priority: explicit config > env vars > config file > undefined
 	*/
 	getDefaults?(config: ProviderConfig): ProviderDefaults;
+	/**
+	* List configured registries (optional).
+	*/
+	getRegistries?(config: ProviderConfig): RegistryEntry[];
+	/**
+	* Add a registry to configuration (optional).
+	*/
+	addRegistry?(config: ProviderConfig, name: string, url: string, setDefault?: boolean): void;
+	/**
+	* Remove a registry from configuration (optional).
+	*/
+	removeRegistry?(config: ProviderConfig, name: string): void;
+	/**
+	* Set a registry as the default (optional).
+	*/
+	setDefaultRegistry?(config: ProviderConfig, name: string): void;
 }
 /**
 * Well-known discovery response format.
@@ -882,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
 	*/
@@ -1273,4 +1337,4 @@ declare class TypeHandlerChain {
 	*/
 	clear(): void;
 }
-export { wrap, withDomainValidation, textType, resource, resolveSource, parse, manifest, locate, loadResource, jsonType, isValidDigest, generateDefinition, format, extract, discoverRegistry, define, computeDigest, bundleResourceType, builtinTypes, binaryType, archive, WellKnownResponse, TypeHandlerChain, TypeDetectorChain, TypeDetector, TypeDetectionResult, StoredRXM, SourceLoaderChain, SourceLoader, SkillDetector, SearchOptions, ResourceXProvider, ResourceXError, ResourceTypeError, ResourceType, ResourceResolver, ResourceLoader, ResourceJsonDetector, ResolvedResource, ResolveSourceConfig, ResolveContext, RegistryMiddleware, RegistryError, Registry, RXS, RXR, RXMStore, RXMSource, RXMSearchOptions, RXMDefinition, RXMArchive, RXM, RXL, RXI, RXD, RXAStore, RXA, ProviderStores, ProviderDefaults, ProviderConfig, MemoryRXMStore, MemoryRXAStore, ManifestError, LocatorError, LoadResourceConfig, LinkedRegistry, JSONSchemaProperty, JSONSchema, IsolatorType, GitHubSourceLoader, FolderSourceLoader, FolderLoader, FileTree, FileEntry, DomainValidation, DiscoveryResult, DefinitionError, ContentError, CASRegistry, BundledType };
+export { wrap, withDomainValidation, textType, resource, resolveSource, parse, manifest, locate, loadResource, jsonType, isValidDigest, generateDefinition, format, extract, discoverRegistry, define, computeDigest, bundleResourceType, builtinTypes, binaryType, archive, WellKnownResponse, TypeHandlerChain, TypeDetectorChain, TypeDetector, TypeDetectionResult, StoredRXM, SourceLoaderChain, SourceLoader, SkillDetector, SearchOptions, ResourceXProvider, ResourceXError, ResourceTypeError, ResourceType, ResourceResolver, ResourceLoader, ResourceJsonDetector, ResolvedResource, ResolveSourceConfig, ResolveContext, RegistryMiddleware, RegistryError, RegistryEntry, Registry, RXS, RXR, RXMStore, RXMSource, RXMSearchOptions, RXMDefinition, RXMArchive, RXM, RXL, RXI, RXD, RXAStore, RXA, ProviderStores, ProviderDefaults, ProviderConfig, MemoryRXMStore, MemoryRXAStore, ManifestError, LocatorError, LoadResourceConfig, LinkedRegistry, JSONSchemaProperty, JSONSchema, IsolatorType, GitHubSourceLoader, FolderSourceLoader, FolderLoader, FileTree, FileEntry, DomainValidation, DiscoveryResult, DefinitionError, ContentError, CASRegistry, BundledType };

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