resourcexjs 2.4.1 → 2.5.0

package/dist/index.d.ts

@@ -1,21 +1,121 @@
-import { ResourceXError, LocatorError, ManifestError, ContentError } from "@resourcexjs/core";
-import { ResourceTypeError } from "@resourcexjs/type";
+import { BundledType, IsolatorType } from "@resourcexjs/type";
+/**
+* ResourceX configuration.
+*/
+interface ResourceXConfig {
+	/**
+	* Base path for local storage.
+	* Default: ~/.resourcex
+	*/
+	path?: string;
+	domain?: string;
+	/**
+	* Central registry URL.
+	* Required for push/pull operations.
+	*/
+	registry?: string;
+	/**
+	* Additional custom resource types.
+	* Built-in types (text, json, binary) are always included.
+	*/
+	types?: BundledType[];
+	/**
+	* Isolator type for resolver execution.
+	* - "none": No isolation (default)
+	* - "srt": OS-level isolation
+	* - "cloudflare": Container isolation
+	* - "e2b": MicroVM isolation
+	*/
+	isolator?: IsolatorType;
+}
+/**
+* Executable resource - result of resolve().
+*/
+interface Executable<T = unknown> {
+	/**
+	* Execute the resource resolver.
+	*/
+	execute: (args?: unknown) => Promise<T>;
+	/**
+	* JSON schema for arguments (if any).
+	*/
+	schema?: unknown;
+}
+/**
+* ResourceX interface - unified API for resource management.
+*
+* Users interact only with:
+* - path: local directory
+* - locator: resource identifier string (e.g., "hello.text@1.0.0")
+*/
+interface ResourceX {
+	/**
+	* Add resource from directory to local storage.
+	*/
+	add(path: string): Promise<void>;
+	/**
+	* Link development directory (symlink for live editing).
+	*/
+	link(path: string): Promise<void>;
+	/**
+	* Check if resource exists locally.
+	*/
+	has(locator: string): Promise<boolean>;
+	/**
+	* Remove resource from local storage.
+	*/
+	remove(locator: string): Promise<void>;
+	/**
+	* Resolve resource and return executable.
+	* Checks: linked → hosted → cache → remote
+	*/
+	resolve<T = unknown>(locator: string): Promise<Executable<T>>;
+	/**
+	* Search local resources.
+	* @returns Array of locator strings
+	*/
+	search(query?: string): Promise<string[]>;
+	/**
+	* Push resource from directory to remote registry.
+	*/
+	push(path: string): Promise<void>;
+	/**
+	* Pull resource from remote to local cache.
+	*/
+	pull(locator: string): Promise<void>;
+	/**
+	* Add support for custom resource type.
+	*/
+	supportType(type: BundledType): void;
+}
+/**
+* Create a ResourceX client instance.
+*
+* @example
+* ```typescript
+* const rx = createResourceX({
+*   domain: "mycompany.com",
+*   registry: "https://registry.mycompany.com"
+* });
+*
+* // Add from directory to local
+* await rx.add("./my-prompt");
+*
+* // Resolve and execute
+* const result = await rx.resolve("my-prompt.text@1.0.0");
+* await result.execute();
+*
+* // Push to remote registry
+* await rx.push("./my-prompt");
+*
+* // Pull from remote registry
+* await rx.pull("my-prompt.text@1.0.0");
+* ```
+*/
+declare function createResourceX(config?: ResourceXConfig): ResourceX;
 import { RegistryError } from "@resourcexjs/registry";
-import { RXL } from "@resourcexjs/core";
-import { parseRXL } from "@resourcexjs/core";
-import { RXM, ManifestData } from "@resourcexjs/core";
-import { createRXM } from "@resourcexjs/core";
-import { RXA, RXP, RXAInput, PathNode } from "@resourcexjs/core";
-import { createRXA } from "@resourcexjs/core";
-import { RXR } from "@resourcexjs/core";
-import { ResourceType, ResourceResolver, ResolvedResource, JSONSchema, BundledType, IsolatorType } from "@resourcexjs/type";
-import { TypeHandlerChain, bundleResourceType } from "@resourcexjs/type";
-import { textType, jsonType, binaryType, builtinTypes } from "@resourcexjs/type";
-import { ResourceLoader } from "@resourcexjs/loader";
-import { loadResource, FolderLoader } from "@resourcexjs/loader";
-import { LoadResourceConfig } from "@resourcexjs/loader";
-import { Registry, RegistryConfig, ClientRegistryConfig, ServerRegistryConfig, CreateRegistryConfig, DiscoveryResult, WellKnownResponse, Storage, SearchOptions } from "@resourcexjs/registry";
-import { DefaultRegistry, createRegistry, discoverRegistry, LocalStorage } from "@resourcexjs/registry";
-import { RegistryMiddleware, DomainValidation, withDomainValidation } from "@resourcexjs/registry";
+import { ResourceTypeError } from "@resourcexjs/type";
+import { BundledType as BundledType2, IsolatorType as IsolatorType2 } from "@resourcexjs/type";
+import { bundleResourceType } from "@resourcexjs/type";
 declare const VERSION: string;
-export { withDomainValidation, textType, parseRXL, loadResource, jsonType, discoverRegistry, createRegistry, createRXM, createRXA, bundleResourceType, builtinTypes, binaryType, WellKnownResponse, VERSION, TypeHandlerChain, Storage, ServerRegistryConfig, SearchOptions, ResourceXError, ResourceTypeError, ResourceType, ResourceResolver, ResourceLoader, ResolvedResource, RegistryMiddleware, RegistryError, RegistryConfig, Registry, RXR, RXP, RXM, RXL, RXAInput, RXA, PathNode, ManifestError, ManifestData, LocatorError, LocalStorage, LoadResourceConfig, JSONSchema, IsolatorType, FolderLoader, DomainValidation, DiscoveryResult, DefaultRegistry, CreateRegistryConfig, ContentError, ClientRegistryConfig, BundledType };
+export { createResourceX, bundleResourceType, VERSION, ResourceXConfig, ResourceX, ResourceTypeError, RegistryError, IsolatorType2 as IsolatorType, Executable, BundledType2 as BundledType };