resourcexjs 2.0.0 → 2.1.0

package/dist/arp.d.ts

@@ -1 +1,93 @@
-export * from "@resourcexjs/arp";
+import { ARP, ARPConfig } from "@resourcexjs/arp";
+import { ARP as ARP2, ARPConfig as ARPConfig2 } from "@resourcexjs/arp";
+import { VERSION } from "@resourcexjs/arp";
+import { ARPError, ParseError, TransportError, SemanticError } from "@resourcexjs/arp";
+import { TransportHandler as TransportHandler2, TransportResult as TransportResult2, TransportParams as TransportParams2, FileTransportHandler, fileTransport, HttpTransportHandler, httpsTransport, httpTransport } from "@resourcexjs/arp";
+import { Resource, SemanticHandler, ResourceMeta, SemanticContext, TextResource, BinaryResource, BinaryInput, TextSemanticHandler, textSemantic, BinarySemanticHandler, binarySemantic } from "@resourcexjs/arp";
+import { ARI, ARL } from "@resourcexjs/arp";
+import { TransportHandler, TransportResult, TransportParams } from "@resourcexjs/arp";
+/**
+* Minimal registry interface required by RxrTransport.
+* This allows RxrTransport to work without depending on the full Registry type.
+*/
+interface RxrTransportRegistry {
+	get(locator: string): Promise<{
+		content: {
+			files(): Promise<Map<string, Buffer>>
+		}
+	}>;
+}
+/**
+* RXR Transport - Access files inside a resource.
+*
+* Location format: {rxl}/{internal-path}
+* Example: deepractice.ai/nuwa.role@1.0.0/thought/first-principles.md
+*
+* The RXL portion ends at @version, and the internal path follows.
+*
+* When no registry is provided, automatically creates one based on domain:
+* - localhost: LocalRegistry
+* - Other domains: RemoteRegistry with well-known discovery
+*/
+declare class RxrTransport implements TransportHandler {
+	private registry?;
+	readonly name = "rxr";
+	constructor(registry?: RxrTransportRegistry);
+	/**
+	* Get file content from inside a resource.
+	*/
+	get(location: string, _params?: TransportParams): Promise<TransportResult>;
+	/**
+	* Set is not supported - RXR transport is read-only.
+	*/
+	set(_location: string, _content: Buffer, _params?: TransportParams): Promise<void>;
+	/**
+	* Check if a file exists inside a resource.
+	*/
+	exists(location: string): Promise<boolean>;
+	/**
+	* Delete is not supported - RXR transport is read-only.
+	*/
+	delete(_location: string): Promise<void>;
+	/**
+	* Get or create a registry for the given domain.
+	* - If a registry was provided in constructor, use it
+	* - localhost: create LocalRegistry
+	* - Other domains: discover endpoint via well-known and create appropriate registry
+	*/
+	private getRegistry;
+	/**
+	* Check if URL is a git repository URL.
+	*/
+	private isGitUrl;
+	/**
+	* Parse location into domain, RXL and internal path.
+	* Format: {domain}/{path}/{name}.{type}@{version}/{internal-path}
+	* Example: deepractice.ai/nuwa.role@1.0.0/thought/first-principles.md
+	*/
+	private parseLocation;
+}
+/**
+* Clear the registry cache. Useful for testing.
+*/
+declare function clearRegistryCache(): void;
+/**
+* Create an ARP instance with ResourceX integration.
+*
+* This enhanced version automatically registers the RXR transport,
+* which allows accessing files inside ResourceX resources.
+*
+* Default transports: file, http, https, rxr
+* Default semantics: text, binary
+*
+* @example
+* ```typescript
+* const arp = createARP();
+*
+* // Use rxr transport to access resource internals
+* const arl = arp.parse("arp:text:rxr://localhost/my-prompt.text@1.0.0/content");
+* const resource = await arl.resolve();
+* ```
+*/
+declare function createARP(config?: ARPConfig): ARP;
+export { textSemantic, httpsTransport, httpTransport, fileTransport, createARP, clearRegistryCache, binarySemantic, VERSION, TransportResult2 as TransportResult, TransportParams2 as TransportParams, TransportHandler2 as TransportHandler, TransportError, TextSemanticHandler, TextResource, SemanticHandler, SemanticError, SemanticContext, RxrTransportRegistry, RxrTransport, ResourceMeta, Resource, ParseError, HttpTransportHandler, FileTransportHandler, BinarySemanticHandler, BinaryResource, BinaryInput, ARPError, ARPConfig2 as ARPConfig, ARP2 as ARP, ARL, ARI };