@resourcexjs/registry 2.0.0 → 2.1.1

package/dist/index.d.ts

@@ -188,20 +188,25 @@ import { ResourceXError } from "@resourcexjs/core";
 * Registry-specific error.
 */
 declare class RegistryError extends ResourceXError {
-	constructor(message: string);
+	constructor(message: string, options?: ErrorOptions);
 }
 import { RXR as RXR2, RXL as RXL2 } from "@resourcexjs/core";
 import { ResourceType as ResourceType2, ResolvedResource as ResolvedResource2 } from "@resourcexjs/type";
 /**
 * Local filesystem-based registry implementation.
-* Uses Node.js fs module directly for storage operations.
+* Uses ARP file transport for I/O operations.
 */
 declare class LocalRegistry implements Registry {
 	private readonly basePath;
 	private readonly typeHandler;
+	private readonly arp;
 	constructor(config?: LocalRegistryConfig);
 	supportType(type: ResourceType2): void;
 	/**
+	* Create ARP URL for a file path.
+	*/
+	private toArpUrl;
+	/**
 	* Build filesystem path for a resource.
 	*
 	* Storage structure:
@@ -241,10 +246,6 @@ declare class LocalRegistry implements Registry {
 	delete(locator: string): Promise<void>;
 	search(options?: SearchOptions): Promise<RXL2[]>;
 	/**
-	* Recursively list all files in a directory.
-	*/
-	private listRecursive;
-	/**
 	* Parse a local entry path to RXL.
 	* Entry format: {name}.{type}/{version}/manifest.json
 	*/
@@ -290,36 +291,35 @@ declare class RemoteRegistry implements Registry {
 declare function discoverRegistry(domain: string): Promise<DiscoveryResult>;
 import { RXR as RXR4, RXL as RXL4 } from "@resourcexjs/core";
 import { ResourceType as ResourceType4, ResolvedResource as ResolvedResource4 } from "@resourcexjs/type";
-/**
-* Git-based registry implementation.
-* Clones a git repository and reads resources from it.
-*/
 declare class GitRegistry implements Registry {
 	private readonly url;
 	private readonly ref;
 	private readonly basePath;
 	private readonly cacheDir;
 	private readonly typeHandler;
-	private readonly trustedDomain?;
+	private readonly arp;
+	private readonly isLocal;
 	constructor(config: GitRegistryConfig);
 	/**
-	* Check if URL is a remote git URL (not local path).
-	*/
-	private isRemoteUrl;
-	/**
 	* Build cache directory name from git URL.
 	* git@github.com:Deepractice/Registry.git → github.com-Deepractice-Registry
 	*/
 	private buildCacheDir;
 	supportType(type: ResourceType4): void;
 	/**
+	* Create ARP URL for a file path.
+	*/
+	private toArpUrl;
+	/**
 	* Ensure the repository is cloned and up to date.
+	* For local paths, just verify the .git directory exists.
+	* For remote URLs, includes retry logic for transient network errors.
 	*/
 	private ensureCloned;
 	/**
-	* Execute git command in the cache directory.
+	* Get the default branch name (main or master).
 	*/
-	private gitExec;
+	private getDefaultBranch;
 	/**
 	* Build filesystem path for a resource in the cloned repo.
 	* Path structure: {cacheDir}/{basePath}/{domain}/{path}/{name}.{type}/{version}
@@ -332,7 +332,6 @@ declare class GitRegistry implements Registry {
 	>(locator: string): Promise<ResolvedResource4<TArgs, TResult>>;
 	exists(locator: string): Promise<boolean>;
 	search(options?: SearchOptions): Promise<RXL4[]>;
-	private listRecursive;
 	private parseEntryToRXL;
 	pull(_locator: string, _options?: PullOptions): Promise<void>;
 	publish(_resource: RXR4, _options: PublishOptions): Promise<void>;
@@ -342,6 +341,9 @@ declare class GitRegistry implements Registry {
 /**
 * Create a registry instance.
 *
+* When a `domain` is provided in GitRegistryConfig, the registry is automatically
+* wrapped with DomainValidation middleware for security.
+*
 * @param config - Registry configuration
 *   - No config or LocalRegistryConfig: Creates LocalRegistry (filesystem-based)
 *   - RemoteRegistryConfig: Creates RemoteRegistry (HTTP-based)
@@ -355,11 +357,67 @@ declare class GitRegistry implements Registry {
 * // Remote registry
 * const registry3 = createRegistry({ endpoint: "https://registry.deepractice.ai/v1" });
 *
-* // Git registry
+* // Git registry (requires domain for remote URLs)
 * const registry4 = createRegistry({
 *   type: "git",
 *   url: "git@github.com:Deepractice/Registry.git",
+*   domain: "deepractice.ai",  // Auto-wrapped with DomainValidation
 * });
 */
 declare function createRegistry(config?: RegistryConfig): Registry;
-export { isRemoteConfig, isGitConfig, discoverRegistry, createRegistry, WellKnownResponse, SearchOptions, RemoteRegistryConfig, RemoteRegistry, RegistryError, RegistryConfig, Registry, PullOptions, PublishTarget, PublishOptions, LocalRegistryConfig, LocalRegistry, GitRegistryConfig, GitRegistry, DiscoveryResult };
+import { RXR as RXR5, RXL as RXL5 } from "@resourcexjs/core";
+import { ResourceType as ResourceType5, ResolvedResource as ResolvedResource5 } from "@resourcexjs/type";
+/**
+* Base class for Registry middleware.
+* Delegates all operations to the inner registry.
+* Override specific methods to add custom behavior.
+*/
+declare abstract class RegistryMiddleware implements Registry {
+	protected readonly inner: Registry;
+	constructor(inner: Registry);
+	supportType(type: ResourceType5): void;
+	pull(locator: string, options?: PullOptions): Promise<void>;
+	publish(resource: RXR5, options: PublishOptions): Promise<void>;
+	link(resource: RXR5): Promise<void>;
+	get(locator: string): Promise<RXR5>;
+	resolve<
+		TArgs = void,
+		TResult = unknown
+	>(locator: string): Promise<ResolvedResource5<TArgs, TResult>>;
+	exists(locator: string): Promise<boolean>;
+	delete(locator: string): Promise<void>;
+	search(options?: SearchOptions): Promise<RXL5[]>;
+}
+import { RXR as RXR6 } from "@resourcexjs/core";
+import { ResolvedResource as ResolvedResource6 } from "@resourcexjs/type";
+/**
+* Domain validation middleware.
+* Ensures all resources from this registry match the trusted domain.
+*/
+declare class DomainValidation extends RegistryMiddleware {
+	private readonly trustedDomain;
+	constructor(inner: Registry, trustedDomain: string);
+	/**
+	* Validate that manifest domain matches trusted domain.
+	*/
+	private validateDomain;
+	/**
+	* Get resource and validate domain.
+	*/
+	get(locator: string): Promise<RXR6>;
+	/**
+	* Resolve resource and validate domain.
+	*/
+	resolve<
+		TArgs = void,
+		TResult = unknown
+	>(locator: string): Promise<ResolvedResource6<TArgs, TResult>>;
+}
+/**
+* Factory function to create domain validation middleware.
+*
+* @example
+* const registry = withDomainValidation(gitRegistry, "deepractice.ai");
+*/
+declare function withDomainValidation(registry: Registry, trustedDomain: string): Registry;
+export { withDomainValidation, isRemoteConfig, isGitConfig, discoverRegistry, createRegistry, WellKnownResponse, SearchOptions, RemoteRegistryConfig, RemoteRegistry, RegistryMiddleware, RegistryError, RegistryConfig, Registry, PullOptions, PublishTarget, PublishOptions, LocalRegistryConfig, LocalRegistry, GitRegistryConfig, GitRegistry, DomainValidation, DiscoveryResult };