@resourcexjs/registry 1.6.0 → 1.7.0

package/dist/index.d.ts

@@ -1,9 +1,10 @@
 import { RXR, RXL } from "@resourcexjs/core";
 import { ResourceType, ResolvedResource } from "@resourcexjs/type";
 /**
-* Registry configuration options.
+* Local registry configuration.
+* Uses filesystem for storage.
 */
-interface RegistryConfig {
+interface LocalRegistryConfig {
 	/**
 	* Local storage path. Defaults to ~/.resourcex
 	*/
@@ -15,6 +16,25 @@ interface RegistryConfig {
 	types?: ResourceType[];
 }
 /**
+* Remote registry configuration.
+* Uses HTTP API for access.
+*/
+interface RemoteRegistryConfig {
+	/**
+	* Remote registry API endpoint.
+	* Example: "https://registry.deepractice.ai/v1"
+	*/
+	endpoint: string;
+}
+/**
+* Registry configuration - either local or remote.
+*/
+type RegistryConfig = LocalRegistryConfig | RemoteRegistryConfig;
+/**
+* Type guard to check if config is for remote registry.
+*/
+declare function isRemoteConfig(config?: RegistryConfig): config is RemoteRegistryConfig;
+/**
 * Search options for querying resources.
 */
 interface SearchOptions {
@@ -49,6 +69,12 @@ interface Registry {
 	*/
 	link(resource: RXR): Promise<void>;
 	/**
+	* Get raw resource by locator string.
+	* Returns the RXR (locator + manifest + content) without resolving.
+	* Use this when you need access to raw resource content.
+	*/
+	get(locator: string): Promise<RXR>;
+	/**
 	* Resolve resource by locator string.
 	* Returns a ResolvedResource with execute function and original resource.
 	* Checks local first, then fetches from remote if not found.
@@ -82,23 +108,22 @@ declare class RegistryError extends ResourceXError {
 import { RXR as RXR2, RXL as RXL2 } from "@resourcexjs/core";
 import { ResourceType as ResourceType2, ResolvedResource as ResolvedResource2 } from "@resourcexjs/type";
 /**
-* ARP-based registry implementation.
-* Uses ARP protocol for atomic I/O operations.
-* Each instance has its own TypeHandlerChain for type handling.
+* Local filesystem-based registry implementation.
+* Uses Node.js fs module directly for storage operations.
 */
-declare class ARPRegistry implements Registry {
-	private readonly arp;
+declare class LocalRegistry implements Registry {
 	private readonly basePath;
 	private readonly typeHandler;
-	constructor(config?: RegistryConfig);
+	constructor(config?: LocalRegistryConfig);
 	supportType(type: ResourceType2): void;
 	/**
-	* Build ARP URL for a resource file.
-	* Path structure: {basePath}/{domain}/{path}/{name}.{type}/{version}/{filename}
+	* Build filesystem path for a resource.
+	* Path structure: {basePath}/{domain}/{path}/{name}.{type}/{version}
 	*/
-	private buildUrl;
+	private buildPath;
 	publish(_resource: RXR2): Promise<void>;
 	link(resource: RXR2): Promise<void>;
+	get(locator: string): Promise<RXR2>;
 	resolve<
 		TArgs = void,
 		TResult = unknown
@@ -107,14 +132,57 @@ declare class ARPRegistry implements Registry {
 	delete(locator: string): Promise<void>;
 	search(options?: SearchOptions): Promise<RXL2[]>;
 	/**
+	* Recursively list all files in a directory.
+	*/
+	private listRecursive;
+	/**
 	* Parse a file entry path to RXL.
 	* Entry format: {domain}/{path}/{name}.{type}/{version}/manifest.json
 	*/
 	private parseEntryToRXL;
 }
+import { RXR as RXR3, RXL as RXL3 } from "@resourcexjs/core";
+import { ResourceType as ResourceType3, ResolvedResource as ResolvedResource3 } from "@resourcexjs/type";
+/**
+* Remote registry implementation.
+* Uses HTTP API for resource access.
+*/
+declare class RemoteRegistry implements Registry {
+	private readonly endpoint;
+	private readonly typeHandler;
+	constructor(config: RemoteRegistryConfig);
+	supportType(type: ResourceType3): void;
+	publish(_resource: RXR3): Promise<void>;
+	link(_resource: RXR3): Promise<void>;
+	get(locator: string): Promise<RXR3>;
+	resolve<
+		TArgs = void,
+		TResult = unknown
+	>(locator: string): Promise<ResolvedResource3<TArgs, TResult>>;
+	exists(locator: string): Promise<boolean>;
+	delete(_locator: string): Promise<void>;
+	search(options?: SearchOptions): Promise<RXL3[]>;
+}
+/**
+* Discover registry endpoint for a domain using well-known.
+* @param domain - The domain to discover (e.g., "deepractice.ai")
+* @returns The registry endpoint URL
+*/
+declare function discoverRegistry(domain: string): Promise<string>;
 /**
 * Create a registry instance.
-* Uses ARP protocol for storage operations.
+*
+* @param config - Registry configuration
+*   - No config or LocalRegistryConfig: Creates LocalRegistry (filesystem-based)
+*   - RemoteRegistryConfig: Creates RemoteRegistry (HTTP-based)
+*
+* @example
+* // Local registry (default)
+* const registry = createRegistry();
+* const registry2 = createRegistry({ path: "./custom-path" });
+*
+* // Remote registry
+* const registry3 = createRegistry({ endpoint: "https://registry.deepractice.ai/v1" });
 */
 declare function createRegistry(config?: RegistryConfig): Registry;
-export { createRegistry, SearchOptions, RegistryError, RegistryConfig, Registry, ARPRegistry };
+export { isRemoteConfig, discoverRegistry, createRegistry, SearchOptions, RemoteRegistryConfig, RemoteRegistry, RegistryError, RegistryConfig, Registry, LocalRegistryConfig, LocalRegistry };