@resourcexjs/core 2.18.0 → 2.20.0

package/dist/index.d.ts

@@ -434,52 +434,6 @@ interface SourceLoader {
 	load(source: string): Promise<RXS>;
 }
 /**
-* Default ResourceLoader implementation for loading resources from folders.
-*
-* Expected folder structure:
-* ```
-* folder/
-* ├── resource.json    # Resource metadata (required)
-* └── ...              # Any other files/directories (content)
-* ```
-*
-* resource.json format:
-* ```json
-* {
-*   "name": "resource-name",      // required
-*   "type": "text",               // required
-*   "tag": "1.0.0",              // optional, defaults to "latest"
-*   "registry": "localhost",      // optional
-*   "path": "optional/path"       // optional
-* }
-* ```
-*
-* All files in the folder (except resource.json) will be packaged into the RXA.
-*/
-declare class FolderLoader implements ResourceLoader {
-	canLoad(source: string): Promise<boolean>;
-	load(folderPath: string): Promise<RXR>;
-	/**
-	* Recursively read all files in a folder, returning a map of relative paths to buffers.
-	*/
-	private readFolderFiles;
-}
-/**
-* FolderSourceLoader - Loads raw files from a folder into RXS.
-*
-* Unlike FolderLoader (which requires resource.json and produces RXR),
-* FolderSourceLoader loads ALL files from a folder without interpreting them.
-* Type detection happens downstream via TypeDetectorChain.
-*/
-declare class FolderSourceLoader implements SourceLoader {
-	canLoad(source: string): Promise<boolean>;
-	load(source: string): Promise<RXS>;
-	/**
-	* Recursively read all files in a folder.
-	*/
-	private readFolderFiles;
-}
-/**
 * GitHubSourceLoader - Loads raw files from a GitHub directory into RXS.
 *
 * Fetches files via the GitHub Contents API (no authentication required
@@ -502,60 +456,50 @@ declare class GitHubSourceLoader implements SourceLoader {
 */
 interface LoadResourceConfig {
 	/**
-	* Custom loader to use. If not provided, defaults to FolderLoader.
+	* Loader to use. Required — environment-specific loaders are provided by the provider.
+	* For Node.js/Bun: use FolderLoader from @resourcexjs/node-provider.
 	*/
-	loader?: ResourceLoader;
+	loader: ResourceLoader;
 }
 /**
 * Load a resource from a given source using a ResourceLoader.
 *
-* By default, uses FolderLoader which expects:
-* ```
-* folder/
-* ├── resource.json    # Resource metadata
-* └── content          # Resource content
-* ```
-*
-* You can provide a custom loader via config.loader to support other formats
-* (e.g., zip, tar.gz, URLs).
-*
 * @param source - Source path or identifier
-* @param config - Optional configuration
+* @param config - Configuration with loader
 * @returns Complete RXR object ready for registry.link()
 * @throws ResourceXError if the source cannot be loaded
 *
 * @example
 * ```typescript
-* // Load from folder (default)
-* const rxr = await loadResource("./my-resource");
-* await registry.link(rxr);
+* import { FolderLoader } from "@resourcexjs/node-provider";
 *
-* // Load with custom loader
-* const rxr = await loadResource("resource.zip", {
-*   loader: new ZipLoader()
+* const rxr = await loadResource("./my-resource", {
+*   loader: new FolderLoader()
 * });
 * ```
 */
-declare function loadResource(source: string, config?: LoadResourceConfig): Promise<RXR>;
+declare function loadResource(source: string, config: LoadResourceConfig): Promise<RXR>;
 /**
 * SourceLoaderChain - Chain of source loaders.
 *
 * Follows the same pattern as TypeDetectorChain:
-* - Static create() factory with built-in loaders
+* - Static create() factory with built-in environment-agnostic loaders
 * - Extensible via register()
 * - First match wins
 *
-* Loading order:
-* 1. FolderSourceLoader (local directories)
-* 2. GitHubSourceLoader (GitHub URLs)
-* 3. NpmSourceLoader (npm: prefixed packages)
-* 4. Custom loaders (registered in order)
+* Built-in loaders (environment-agnostic):
+* 1. GitHubSourceLoader (GitHub URLs via fetch)
+*
+* Provider-registered loaders (environment-specific):
+* - FolderSourceLoader (local directories) — via node-provider
+* - NpmSourceLoader (npm: prefixed packages) — via node-provider
 */
 declare class SourceLoaderChain {
 	private readonly loaders;
 	private constructor();
 	/**
-	* Create a new SourceLoaderChain with built-in loaders.
+	* Create a new SourceLoaderChain with built-in environment-agnostic loaders.
+	* Environment-specific loaders (folder, npm) are registered by the provider.
 	*/
 	static create(): SourceLoaderChain;
 	/**
@@ -794,9 +738,10 @@ interface ResourceXProvider {
 	*/
 	createStores(config: ProviderConfig): ProviderStores;
 	/**
-	* Create source loader for auto-detection pipeline (optional).
+	* Create source loaders for auto-detection pipeline (optional).
+	* Returns environment-specific loaders to register on the chain.
 	*/
-	createSourceLoader?(config: ProviderConfig): SourceLoader;
+	createSourceLoaders?(config: ProviderConfig): SourceLoader[];
 	/**
 	* Resolve platform-specific defaults (optional).
 	*
@@ -936,59 +881,6 @@ declare class CASRegistry implements Registry {
 	putBlob(data: Buffer): Promise<string>;
 }
 /**
-* LinkedRegistry - Registry for development symlinks.
-*
-* Creates symlinks to development directories so changes are reflected immediately.
-* Unlike HostedRegistry/MirrorRegistry, it doesn't use Storage layer directly.
-* Instead, it manages symlinks in a base directory.
-*
-* Storage structure:
-*   {basePath}/{registry}/{path}/{name}/{tag} → /path/to/dev/folder
-*/
-declare class LinkedRegistry implements Registry {
-	private readonly basePath;
-	constructor(basePath: string);
-	/**
-	* Build symlink path for a resource.
-	*/
-	private buildLinkPath;
-	/**
-	* Check if a path is a symlink.
-	*/
-	private isSymlink;
-	get(rxi: RXI): Promise<RXR>;
-	/**
-	* Put is not typically used for LinkedRegistry.
-	* Use link() instead to create symlinks.
-	*/
-	put(_rxr: RXR): Promise<RXM>;
-	has(rxi: RXI): Promise<boolean>;
-	remove(rxi: RXI): Promise<void>;
-	list(options?: SearchOptions): Promise<RXI[]>;
-	/**
-	* Link a development directory.
-	* Creates a symlink so changes are reflected immediately.
-	*
-	* @param devPath - Path to development directory (must contain resource.json)
-	* @returns The RXI of the linked resource
-	*/
-	link(devPath: string): Promise<RXI>;
-	/**
-	* Unlink a development directory.
-	* Alias for remove().
-	*/
-	unlink(rxi: RXI): Promise<void>;
-	/**
-	* Recursively scan for symlinks.
-	*/
-	private scanSymlinks;
-	/**
-	* Parse relative path to RXI.
-	* Path format: {registry}/{path}/{name}/{tag}
-	*/
-	private parsePathToRXI;
-}
-/**
 * Base class for Registry middleware.
 * Delegates all operations to the inner registry.
 * Override specific methods to add custom behavior.
@@ -1028,10 +920,14 @@ declare function withRegistryValidation(registry: Registry, trustedRegistry: str
 declare const DomainValidation: typeof RegistryValidation;
 declare const withDomainValidation: typeof withRegistryValidation;
 /**
+* Digest utilities for Content-Addressable Storage.
+* Uses Web Crypto API for environment-agnostic SHA-256 hashing.
+*/
+/**
 * Compute SHA-256 digest of data.
 * Returns string in format "sha256:{hex}"
 */
-declare function computeDigest(data: Buffer): string;
+declare function computeDigest(data: Buffer): Promise<string>;
 /**
 * Validate digest format.
 */
@@ -1072,16 +968,11 @@ declare class MemoryRXMStore implements RXMStore {
 }
 /**
 * Isolator type for resolver execution.
-* Matches SandboX isolator types directly.
-* Configured at Registry level, not per-type.
 *
-* - "none": No isolation, fastest (~10ms), for development
-* - "srt": OS-level isolation (~50ms), secure local dev
-* - "cloudflare": Container isolation (~100ms), local Docker or edge
-* - "e2b": MicroVM isolation (~150ms), production (planned)
-* - "custom": User-provided executor function
+* - "none": No isolation, direct eval execution (default)
+* - "custom": User-provided executor function (e.g., QuickJS Wasm for Workers)
 */
-type IsolatorType = "none" | "srt" | "cloudflare" | "e2b" | "custom";
+type IsolatorType = "none" | "custom";
 /**
 * Custom executor function for resolver execution.
 * Used when isolator is set to "custom".
@@ -1255,19 +1146,6 @@ declare const prototypeType: BundledType;
 */
 declare const builtinTypes: BundledType[];
 /**
-* Bundle a resource type from a source file.
-*
-* @param sourcePath - Path to the .type.ts file
-* @param basePath - Base path for resolving relative paths (defaults to cwd)
-* @returns BundledType ready for registry
-*
-* @example
-* ```typescript
-* const promptType = await bundleResourceType("./prompt.type.ts");
-* ```
-*/
-declare function bundleResourceType(sourcePath: string, basePath?: string): Promise<BundledType>;
-/**
 * Resource type related error.
 */
 declare class ResourceTypeError extends ResourceXError {
@@ -1323,4 +1201,4 @@ declare class TypeHandlerChain {
 	*/
 	clear(): void;
 }
-export { wrap, withDomainValidation, textType, skillType, resource, resolveSource, prototypeType, 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, PrototypeDetector, MemoryRXMStore, MemoryRXAStore, ManifestError, LocatorError, LoadResourceConfig, LinkedRegistry, JSONSchemaProperty, JSONSchema, IsolatorType, GitHubSourceLoader, FolderSourceLoader, FolderLoader, FileTree, FileEntry, DomainValidation, DiscoveryResult, DefinitionError, CustomExecutor, ContentError, CASRegistry, BundledType };
+export { wrap, withDomainValidation, textType, skillType, resource, resolveSource, prototypeType, parse, manifest, locate, loadResource, jsonType, isValidDigest, generateDefinition, format, extract, discoverRegistry, define, computeDigest, 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, PrototypeDetector, MemoryRXMStore, MemoryRXAStore, ManifestError, LocatorError, LoadResourceConfig, JSONSchemaProperty, JSONSchema, IsolatorType, GitHubSourceLoader, FileTree, FileEntry, DomainValidation, DiscoveryResult, DefinitionError, CustomExecutor, ContentError, CASRegistry, BundledType };