@resourcexjs/registry 1.0.0 → 1.2.0

package/README.md

@@ -175,9 +175,29 @@ await registry.delete("localhost/my-prompt.text@1.0.0");
 
 Publish resource to remote registry (TODO: not yet implemented).
 
-#### `search(query: string): Promise<RXL[]>`
+#### `search(options?): Promise<RXL[]>`
 
-Search for resources (TODO: not yet implemented).
+Search for resources in local registry.
+
+**Parameters:**
+
+- `options?: SearchOptions`
+  - `query?: string` - Filter by locator substring
+  - `limit?: number` - Max results to return
+  - `offset?: number` - Skip first N results
+
+**Returns**: `Promise<RXL[]>` - Array of matching locators
+
+```typescript
+// Search by name
+const results = await registry.search({ query: "assistant" });
+
+// With pagination
+const page = await registry.search({ query: "prompt", limit: 10, offset: 20 });
+
+// List all resources
+const all = await registry.search();
+```
 
 ## Storage Structure
 

package/dist/index.d.ts

@@ -15,6 +15,23 @@ interface RegistryConfig {
 	types?: ResourceType[];
 }
 /**
+* Search options for querying resources.
+*/
+interface SearchOptions {
+	/**
+	* Search query string (matches against name, domain, path).
+	*/
+	query?: string;
+	/**
+	* Maximum number of results to return.
+	*/
+	limit?: number;
+	/**
+	* Number of results to skip (for pagination).
+	*/
+	offset?: number;
+}
+/**
 * Registry interface for resource storage and retrieval.
 */
 interface Registry {
@@ -40,9 +57,11 @@ interface Registry {
 	*/
 	delete(locator: string): Promise<void>;
 	/**
-	* Search for resources matching query.
+	* Search for resources matching options.
+	* @param options - Search options (query, limit, offset)
+	* @returns Array of matching resource locators
 	*/
-	search(query: string): Promise<RXL[]>;
+	search(options?: SearchOptions): Promise<RXL[]>;
 }
 import { ResourceXError } from "@resourcexjs/core";
 /**
@@ -70,11 +89,16 @@ declare class ARPRegistry implements Registry {
 	resolve(locator: string): Promise<RXR2>;
 	exists(locator: string): Promise<boolean>;
 	delete(locator: string): Promise<void>;
-	search(_query: string): Promise<RXL2[]>;
+	search(options?: SearchOptions): Promise<RXL2[]>;
+	/**
+	* Parse a file entry path to RXL.
+	* Entry format: {domain}/{path}/{name}.{type}@{version}/manifest.json
+	*/
+	private parseEntryToRXL;
 }
 /**
 * Create a registry instance.
 * Uses ARP protocol for storage operations.
 */
 declare function createRegistry(config?: RegistryConfig): Registry;
-export { createRegistry, RegistryError, RegistryConfig, Registry, ARPRegistry };
+export { createRegistry, SearchOptions, RegistryError, RegistryConfig, Registry, ARPRegistry };