resourcexjs 2.9.0 → 2.11.0

package/README.md

@@ -34,14 +34,15 @@ console.log(content);
 
 ## Core Concepts
 
-ResourceX uses four core primitives:
+ResourceX uses five core primitives:
 
 | Primitive | Description                                         |
 | --------- | --------------------------------------------------- |
-| **RXL**   | Resource Locator - unique identifier for a resource |
+| **RXI**   | Resource Identifier - structured `{ registry?, path?, name, tag }` |
+| **RXL**   | Resource Locator - unified locator string (RXI string, path, or URL) |
 | **RXM**   | Resource Manifest - metadata (name, type, version)  |
 | **RXA**   | Resource Archive - content container (tar.gz)       |
-| **RXR**   | Resource - complete object (RXL + RXM + RXA)        |
+| **RXR**   | Resource - complete object (RXI + RXM + RXA)        |
 
 ### Locator Format
 
@@ -189,7 +190,7 @@ await rx.remove("hello:1.0.0");
 
 #### rx.resolve(locator)
 
-Load and prepare a resource for execution from RXL locator.
+Load and prepare a resource for execution from an RXL locator string.
 
 ```typescript
 const executable = await rx.resolve<string>("hello:1.0.0");
@@ -305,13 +306,13 @@ For advanced use cases, you can work with core primitives directly:
 ```typescript
 import { parse, format, manifest, archive, resource, extract, wrap } from "resourcexjs";
 
-// Parse locator string to RXL
-const rxl = parse("hello:1.0.0");
-console.log(rxl.name); // "hello"
-console.log(rxl.tag); // "1.0.0"
+// Parse locator string to RXI
+const rxi = parse("hello:1.0.0");
+console.log(rxi.name); // "hello"
+console.log(rxi.tag); // "1.0.0"
 
-// Format RXL back to string
-const str = format(rxl); // "hello:1.0.0"
+// Format RXI back to string
+const str = format(rxi); // "hello:1.0.0"
 
 // Create manifest from definition
 const rxm = manifest({
@@ -447,7 +448,7 @@ Error hierarchy:
 
 ```
 ResourceXError (base)
-├── LocatorError      # RXL parsing errors
+├── LocatorError      # RXI parsing errors
 ├── ManifestError     # RXM validation errors
 ├── ContentError      # RXA operations errors
 └── DefinitionError   # RXD validation errors

package/dist/arp.js

@@ -526,7 +526,7 @@ class ARP {
 function createARP(config) {
   return new ARP(config);
 }
-var VERSION = "2.9.0";
+var VERSION = "2.11.0";
 export {
   textSemantic,
   httpsTransport,
@@ -546,4 +546,4 @@ export {
   ARP
 };
 
-//# debugId=41987E49544A3B4264756E2164756E21
+//# debugId=6F64DDE965E4BA0D64756E2164756E21

package/dist/arp.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../arp/dist/index.js"],
   "sourcesContent": [
-    "// src/errors.ts\nclass ARPError extends Error {\n  constructor(message, options) {\n    super(message, options);\n    this.name = \"ARPError\";\n  }\n}\n\nclass ParseError extends ARPError {\n  url;\n  constructor(message, url) {\n    super(message);\n    this.url = url;\n    this.name = \"ParseError\";\n  }\n}\n\nclass TransportError extends ARPError {\n  transport;\n  constructor(message, transport, options) {\n    super(message, options);\n    this.transport = transport;\n    this.name = \"TransportError\";\n  }\n}\n\nclass SemanticError extends ARPError {\n  semantic;\n  constructor(message, semantic, options) {\n    super(message, options);\n    this.semantic = semantic;\n    this.name = \"SemanticError\";\n  }\n}\n\n// src/ARL.ts\nclass ARL {\n  semantic;\n  transport;\n  location;\n  resolver;\n  constructor(semantic, transport, location, resolver) {\n    this.semantic = semantic;\n    this.transport = transport;\n    this.location = location;\n    this.resolver = resolver;\n  }\n  createContext(params) {\n    return {\n      url: this.toString(),\n      semantic: this.semantic,\n      transport: this.transport,\n      location: this.location,\n      timestamp: new Date,\n      params\n    };\n  }\n  async resolve(params) {\n    const transport = this.resolver.getTransportHandler(this.transport);\n    const semantic = this.resolver.getSemanticHandler(this.semantic);\n    const context = this.createContext(params);\n    return semantic.resolve(transport, this.location, context);\n  }\n  async deposit(data, params) {\n    const transport = this.resolver.getTransportHandler(this.transport);\n    const semantic = this.resolver.getSemanticHandler(this.semantic);\n    const context = this.createContext(params);\n    if (!semantic.deposit) {\n      throw new SemanticError(`Semantic \"${semantic.name}\" does not support deposit operation`, this.semantic);\n    }\n    await semantic.deposit(transport, this.location, data, context);\n  }\n  async exists() {\n    const transport = this.resolver.getTransportHandler(this.transport);\n    const semantic = this.resolver.getSemanticHandler(this.semantic);\n    const context = this.createContext();\n    if (semantic.exists) {\n      return semantic.exists(transport, this.location, context);\n    }\n    return transport.exists(this.location);\n  }\n  async delete() {\n    const transport = this.resolver.getTransportHandler(this.transport);\n    const semantic = this.resolver.getSemanticHandler(this.semantic);\n    const context = this.createContext();\n    if (semantic.delete) {\n      return semantic.delete(transport, this.location, context);\n    }\n    await transport.delete(this.location);\n  }\n  async list(options) {\n    const transport = this.resolver.getTransportHandler(this.transport);\n    if (!transport.list) {\n      throw new TransportError(`Transport \"${transport.name}\" does not support list operation`, this.transport);\n    }\n    return transport.list(this.location, options);\n  }\n  async mkdir() {\n    const transport = this.resolver.getTransportHandler(this.transport);\n    if (!transport.mkdir) {\n      throw new TransportError(`Transport \"${transport.name}\" does not support mkdir operation`, this.transport);\n    }\n    await transport.mkdir(this.location);\n  }\n  toString() {\n    return `arp:${this.semantic}:${this.transport}://${this.location}`;\n  }\n}\n\n// src/semantic/binary.ts\nfunction toBuffer(data) {\n  if (Buffer.isBuffer(data)) {\n    return data;\n  }\n  if (data instanceof Uint8Array) {\n    return Buffer.from(data);\n  }\n  if (data instanceof ArrayBuffer) {\n    return Buffer.from(data);\n  }\n  if (Array.isArray(data)) {\n    return Buffer.from(data);\n  }\n  throw new SemanticError(`Unsupported binary input type`, \"binary\");\n}\n\nclass BinarySemanticHandler {\n  name = \"binary\";\n  async resolve(transport, location, context) {\n    const result = await transport.get(location, context.params);\n    const meta = {\n      url: context.url,\n      semantic: context.semantic,\n      transport: context.transport,\n      location: context.location,\n      size: result.metadata?.size ?? result.content.length,\n      resolvedAt: context.timestamp.toISOString(),\n      type: result.metadata?.type\n    };\n    return {\n      type: \"binary\",\n      content: result.content,\n      meta\n    };\n  }\n  async deposit(transport, location, data, context) {\n    const buffer = toBuffer(data);\n    try {\n      await transport.set(location, buffer, context.params);\n    } catch (error) {\n      throw new SemanticError(`Failed to deposit binary to \"${location}\": ${error.message}`, this.name, { cause: error });\n    }\n  }\n  async exists(transport, location, _context) {\n    return transport.exists(location);\n  }\n  async delete(transport, location, _context) {\n    try {\n      await transport.delete(location);\n    } catch (error) {\n      throw new SemanticError(`Failed to delete \"${location}\": ${error.message}`, this.name, { cause: error });\n    }\n  }\n}\nvar binarySemantic = new BinarySemanticHandler;\n// src/semantic/text.ts\nclass TextSemanticHandler {\n  name = \"text\";\n  async resolve(transport, location, context) {\n    const result = await transport.get(location, context.params);\n    if (result.metadata?.type === \"directory\") {\n      const meta2 = {\n        url: context.url,\n        semantic: context.semantic,\n        transport: context.transport,\n        location: context.location,\n        size: result.content.length,\n        encoding: \"utf-8\",\n        mimeType: \"application/json\",\n        resolvedAt: context.timestamp.toISOString(),\n        type: \"directory\"\n      };\n      return {\n        type: \"text\",\n        content: result.content.toString(\"utf-8\"),\n        meta: meta2\n      };\n    }\n    const text = result.content.toString(\"utf-8\");\n    const meta = {\n      url: context.url,\n      semantic: context.semantic,\n      transport: context.transport,\n      location: context.location,\n      size: result.metadata?.size ?? result.content.length,\n      encoding: \"utf-8\",\n      mimeType: \"text/plain\",\n      resolvedAt: context.timestamp.toISOString(),\n      type: \"file\"\n    };\n    return {\n      type: \"text\",\n      content: text,\n      meta\n    };\n  }\n  async deposit(transport, location, data, context) {\n    const buffer = Buffer.from(data, \"utf-8\");\n    try {\n      await transport.set(location, buffer, context.params);\n    } catch (error) {\n      throw new SemanticError(`Failed to deposit text to \"${location}\": ${error.message}`, this.name, { cause: error });\n    }\n  }\n  async exists(transport, location, _context) {\n    return transport.exists(location);\n  }\n  async delete(transport, location, _context) {\n    try {\n      await transport.delete(location);\n    } catch (error) {\n      throw new SemanticError(`Failed to delete \"${location}\": ${error.message}`, this.name, { cause: error });\n    }\n  }\n}\nvar textSemantic = new TextSemanticHandler;\n// src/transport/file.ts\nimport { access, mkdir, readdir, readFile, rm, stat, writeFile } from \"node:fs/promises\";\nimport { dirname, join, resolve } from \"node:path\";\nclass FileTransportHandler {\n  name = \"file\";\n  resolvePath(location) {\n    return resolve(process.cwd(), location);\n  }\n  async get(location, params) {\n    const filePath = this.resolvePath(location);\n    try {\n      const stats = await stat(filePath);\n      if (stats.isDirectory()) {\n        return this.getDirectory(filePath, stats, params);\n      } else {\n        return this.getFile(filePath, stats);\n      }\n    } catch (error) {\n      const err = error;\n      throw new TransportError(`File get error: ${err.code} - ${filePath}`, this.name, {\n        cause: err\n      });\n    }\n  }\n  async getFile(filePath, stats) {\n    const content = await readFile(filePath);\n    return {\n      content,\n      metadata: {\n        type: \"file\",\n        size: Number(stats.size),\n        modifiedAt: stats.mtime\n      }\n    };\n  }\n  async getDirectory(dirPath, stats, params) {\n    const recursive = params?.recursive === \"true\";\n    const pattern = params?.pattern;\n    let entries;\n    if (recursive) {\n      entries = await this.listRecursive(dirPath, dirPath);\n    } else {\n      entries = await readdir(dirPath);\n    }\n    if (pattern) {\n      entries = this.filterByPattern(entries, pattern);\n    }\n    const content = Buffer.from(JSON.stringify(entries));\n    return {\n      content,\n      metadata: {\n        type: \"directory\",\n        modifiedAt: stats.mtime\n      }\n    };\n  }\n  async listRecursive(basePath, currentPath) {\n    const entries = await readdir(currentPath, { withFileTypes: true });\n    const results = [];\n    for (const entry of entries) {\n      const fullPath = join(currentPath, entry.name);\n      const relativePath = fullPath.substring(basePath.length + 1);\n      if (entry.isDirectory()) {\n        const subEntries = await this.listRecursive(basePath, fullPath);\n        results.push(...subEntries);\n      } else {\n        results.push(relativePath);\n      }\n    }\n    return results;\n  }\n  filterByPattern(entries, pattern) {\n    const regexPattern = pattern.replace(/\\./g, \"\\\\.\").replace(/\\*/g, \".*\").replace(/\\?/g, \".\");\n    const regex = new RegExp(`^${regexPattern}$`);\n    return entries.filter((entry) => {\n      const filename = entry.split(\"/\").pop() || entry;\n      return regex.test(filename);\n    });\n  }\n  async set(location, content, _params) {\n    const filePath = this.resolvePath(location);\n    try {\n      await mkdir(dirname(filePath), { recursive: true });\n      await writeFile(filePath, content);\n    } catch (error) {\n      const err = error;\n      throw new TransportError(`File set error: ${err.code} - ${filePath}`, this.name, {\n        cause: err\n      });\n    }\n  }\n  async exists(location) {\n    const filePath = this.resolvePath(location);\n    try {\n      await access(filePath);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n  async delete(location) {\n    const filePath = this.resolvePath(location);\n    try {\n      await rm(filePath, { recursive: true });\n    } catch (error) {\n      const err = error;\n      if (err.code === \"ENOENT\") {\n        return;\n      }\n      throw new TransportError(`File delete error: ${err.code} - ${filePath}`, this.name, {\n        cause: err\n      });\n    }\n  }\n  async list(location, options) {\n    const dirPath = this.resolvePath(location);\n    try {\n      let entries;\n      if (options?.recursive) {\n        entries = await this.listRecursive(dirPath, dirPath);\n      } else {\n        entries = await readdir(dirPath);\n      }\n      if (options?.pattern) {\n        entries = this.filterByPattern(entries, options.pattern);\n      }\n      return entries;\n    } catch (error) {\n      const err = error;\n      throw new TransportError(`File list error: ${err.code} - ${dirPath}`, this.name, {\n        cause: err\n      });\n    }\n  }\n  async mkdir(location) {\n    const dirPath = this.resolvePath(location);\n    try {\n      await mkdir(dirPath, { recursive: true });\n    } catch (error) {\n      const err = error;\n      throw new TransportError(`File mkdir error: ${err.code} - ${dirPath}`, this.name, {\n        cause: err\n      });\n    }\n  }\n}\nvar fileTransport = new FileTransportHandler;\n// src/transport/http.ts\nclass HttpTransportHandler {\n  name;\n  protocol;\n  constructor(protocol = \"https\") {\n    this.protocol = protocol;\n    this.name = protocol;\n  }\n  async get(location, params) {\n    const url = this.buildUrl(location, params);\n    try {\n      const response = await fetch(url);\n      if (!response.ok) {\n        throw new TransportError(`HTTP ${response.status}: ${response.statusText} - ${url}`, this.name);\n      }\n      const arrayBuffer = await response.arrayBuffer();\n      const content = Buffer.from(arrayBuffer);\n      const contentType = response.headers.get(\"content-type\");\n      const contentLength = response.headers.get(\"content-length\");\n      const lastModified = response.headers.get(\"last-modified\");\n      return {\n        content,\n        metadata: {\n          type: \"file\",\n          size: contentLength ? parseInt(contentLength, 10) : content.length,\n          modifiedAt: lastModified ? new Date(lastModified) : undefined,\n          contentType\n        }\n      };\n    } catch (error) {\n      if (error instanceof TransportError) {\n        throw error;\n      }\n      throw new TransportError(`Network error: ${url}`, this.name, {\n        cause: error\n      });\n    }\n  }\n  buildUrl(location, params) {\n    const url = new URL(`${this.protocol}://${location}`);\n    if (params) {\n      for (const [key, value] of Object.entries(params)) {\n        url.searchParams.set(key, value);\n      }\n    }\n    return url.toString();\n  }\n  async set(_location, _content, _params) {\n    throw new TransportError(\"HTTP transport is read-only, set not supported\", this.name);\n  }\n  async exists(location) {\n    const url = `${this.protocol}://${location}`;\n    try {\n      const response = await fetch(url, { method: \"HEAD\" });\n      return response.ok;\n    } catch {\n      return false;\n    }\n  }\n  async delete(_location) {\n    throw new TransportError(\"HTTP transport is read-only, delete not supported\", this.name);\n  }\n}\nvar httpsTransport = new HttpTransportHandler(\"https\");\nvar httpTransport = new HttpTransportHandler(\"http\");\n// src/ARP.ts\nclass ARP {\n  transports;\n  semantics;\n  constructor(config = {}) {\n    this.transports = new Map;\n    this.semantics = new Map;\n    const defaultTransports = [fileTransport, httpTransport, httpsTransport];\n    const defaultSemantics = [textSemantic, binarySemantic];\n    for (const handler of defaultTransports) {\n      this.transports.set(handler.name, handler);\n    }\n    for (const handler of defaultSemantics) {\n      this.semantics.set(handler.name, handler);\n    }\n    if (config.transports) {\n      for (const handler of config.transports) {\n        this.transports.set(handler.name, handler);\n      }\n    }\n    if (config.semantics) {\n      for (const handler of config.semantics) {\n        this.semantics.set(handler.name, handler);\n      }\n    }\n  }\n  registerTransport(handler) {\n    this.transports.set(handler.name, handler);\n  }\n  registerSemantic(handler) {\n    this.semantics.set(handler.name, handler);\n  }\n  getTransportHandler(name) {\n    const handler = this.transports.get(name);\n    if (!handler) {\n      throw new TransportError(`Unsupported transport type: ${name}`, name);\n    }\n    return handler;\n  }\n  getSemanticHandler(name) {\n    const handler = this.semantics.get(name);\n    if (!handler) {\n      throw new SemanticError(`Unsupported semantic type: ${name}`, name);\n    }\n    return handler;\n  }\n  parse(url) {\n    if (!url.startsWith(\"arp:\")) {\n      throw new ParseError(`Invalid ARP URL: must start with \"arp:\"`, url);\n    }\n    const content = url.substring(4);\n    const separatorIndex = content.indexOf(\"://\");\n    if (separatorIndex === -1) {\n      throw new ParseError(`Invalid ARP URL: missing \"://\"`, url);\n    }\n    const typePart = content.substring(0, separatorIndex);\n    const location = content.substring(separatorIndex + 3);\n    const colonIndex = typePart.indexOf(\":\");\n    if (colonIndex === -1) {\n      throw new ParseError(`Invalid ARP URL: must have exactly 2 types (semantic:transport)`, url);\n    }\n    const semantic = typePart.substring(0, colonIndex);\n    const transport = typePart.substring(colonIndex + 1);\n    if (!semantic) {\n      throw new ParseError(`Invalid ARP URL: semantic type cannot be empty`, url);\n    }\n    if (!transport) {\n      throw new ParseError(`Invalid ARP URL: transport type cannot be empty`, url);\n    }\n    if (!location) {\n      throw new ParseError(`Invalid ARP URL: location cannot be empty`, url);\n    }\n    this.getTransportHandler(transport);\n    this.getSemanticHandler(semantic);\n    return new ARL(semantic, transport, location, this);\n  }\n}\nfunction createARP(config) {\n  return new ARP(config);\n}\n\n// src/index.ts\nvar VERSION = \"2.9.0\";\nexport {\n  textSemantic,\n  httpsTransport,\n  httpTransport,\n  fileTransport,\n  createARP,\n  binarySemantic,\n  VERSION,\n  TransportError,\n  TextSemanticHandler,\n  SemanticError,\n  ParseError,\n  HttpTransportHandler,\n  FileTransportHandler,\n  BinarySemanticHandler,\n  ARPError,\n  ARP\n};\n\n//# debugId=197EBCEB7581CB0E64756E2164756E21\n"
+    "// src/errors.ts\nclass ARPError extends Error {\n  constructor(message, options) {\n    super(message, options);\n    this.name = \"ARPError\";\n  }\n}\n\nclass ParseError extends ARPError {\n  url;\n  constructor(message, url) {\n    super(message);\n    this.url = url;\n    this.name = \"ParseError\";\n  }\n}\n\nclass TransportError extends ARPError {\n  transport;\n  constructor(message, transport, options) {\n    super(message, options);\n    this.transport = transport;\n    this.name = \"TransportError\";\n  }\n}\n\nclass SemanticError extends ARPError {\n  semantic;\n  constructor(message, semantic, options) {\n    super(message, options);\n    this.semantic = semantic;\n    this.name = \"SemanticError\";\n  }\n}\n\n// src/ARL.ts\nclass ARL {\n  semantic;\n  transport;\n  location;\n  resolver;\n  constructor(semantic, transport, location, resolver) {\n    this.semantic = semantic;\n    this.transport = transport;\n    this.location = location;\n    this.resolver = resolver;\n  }\n  createContext(params) {\n    return {\n      url: this.toString(),\n      semantic: this.semantic,\n      transport: this.transport,\n      location: this.location,\n      timestamp: new Date,\n      params\n    };\n  }\n  async resolve(params) {\n    const transport = this.resolver.getTransportHandler(this.transport);\n    const semantic = this.resolver.getSemanticHandler(this.semantic);\n    const context = this.createContext(params);\n    return semantic.resolve(transport, this.location, context);\n  }\n  async deposit(data, params) {\n    const transport = this.resolver.getTransportHandler(this.transport);\n    const semantic = this.resolver.getSemanticHandler(this.semantic);\n    const context = this.createContext(params);\n    if (!semantic.deposit) {\n      throw new SemanticError(`Semantic \"${semantic.name}\" does not support deposit operation`, this.semantic);\n    }\n    await semantic.deposit(transport, this.location, data, context);\n  }\n  async exists() {\n    const transport = this.resolver.getTransportHandler(this.transport);\n    const semantic = this.resolver.getSemanticHandler(this.semantic);\n    const context = this.createContext();\n    if (semantic.exists) {\n      return semantic.exists(transport, this.location, context);\n    }\n    return transport.exists(this.location);\n  }\n  async delete() {\n    const transport = this.resolver.getTransportHandler(this.transport);\n    const semantic = this.resolver.getSemanticHandler(this.semantic);\n    const context = this.createContext();\n    if (semantic.delete) {\n      return semantic.delete(transport, this.location, context);\n    }\n    await transport.delete(this.location);\n  }\n  async list(options) {\n    const transport = this.resolver.getTransportHandler(this.transport);\n    if (!transport.list) {\n      throw new TransportError(`Transport \"${transport.name}\" does not support list operation`, this.transport);\n    }\n    return transport.list(this.location, options);\n  }\n  async mkdir() {\n    const transport = this.resolver.getTransportHandler(this.transport);\n    if (!transport.mkdir) {\n      throw new TransportError(`Transport \"${transport.name}\" does not support mkdir operation`, this.transport);\n    }\n    await transport.mkdir(this.location);\n  }\n  toString() {\n    return `arp:${this.semantic}:${this.transport}://${this.location}`;\n  }\n}\n\n// src/semantic/binary.ts\nfunction toBuffer(data) {\n  if (Buffer.isBuffer(data)) {\n    return data;\n  }\n  if (data instanceof Uint8Array) {\n    return Buffer.from(data);\n  }\n  if (data instanceof ArrayBuffer) {\n    return Buffer.from(data);\n  }\n  if (Array.isArray(data)) {\n    return Buffer.from(data);\n  }\n  throw new SemanticError(`Unsupported binary input type`, \"binary\");\n}\n\nclass BinarySemanticHandler {\n  name = \"binary\";\n  async resolve(transport, location, context) {\n    const result = await transport.get(location, context.params);\n    const meta = {\n      url: context.url,\n      semantic: context.semantic,\n      transport: context.transport,\n      location: context.location,\n      size: result.metadata?.size ?? result.content.length,\n      resolvedAt: context.timestamp.toISOString(),\n      type: result.metadata?.type\n    };\n    return {\n      type: \"binary\",\n      content: result.content,\n      meta\n    };\n  }\n  async deposit(transport, location, data, context) {\n    const buffer = toBuffer(data);\n    try {\n      await transport.set(location, buffer, context.params);\n    } catch (error) {\n      throw new SemanticError(`Failed to deposit binary to \"${location}\": ${error.message}`, this.name, { cause: error });\n    }\n  }\n  async exists(transport, location, _context) {\n    return transport.exists(location);\n  }\n  async delete(transport, location, _context) {\n    try {\n      await transport.delete(location);\n    } catch (error) {\n      throw new SemanticError(`Failed to delete \"${location}\": ${error.message}`, this.name, { cause: error });\n    }\n  }\n}\nvar binarySemantic = new BinarySemanticHandler;\n// src/semantic/text.ts\nclass TextSemanticHandler {\n  name = \"text\";\n  async resolve(transport, location, context) {\n    const result = await transport.get(location, context.params);\n    if (result.metadata?.type === \"directory\") {\n      const meta2 = {\n        url: context.url,\n        semantic: context.semantic,\n        transport: context.transport,\n        location: context.location,\n        size: result.content.length,\n        encoding: \"utf-8\",\n        mimeType: \"application/json\",\n        resolvedAt: context.timestamp.toISOString(),\n        type: \"directory\"\n      };\n      return {\n        type: \"text\",\n        content: result.content.toString(\"utf-8\"),\n        meta: meta2\n      };\n    }\n    const text = result.content.toString(\"utf-8\");\n    const meta = {\n      url: context.url,\n      semantic: context.semantic,\n      transport: context.transport,\n      location: context.location,\n      size: result.metadata?.size ?? result.content.length,\n      encoding: \"utf-8\",\n      mimeType: \"text/plain\",\n      resolvedAt: context.timestamp.toISOString(),\n      type: \"file\"\n    };\n    return {\n      type: \"text\",\n      content: text,\n      meta\n    };\n  }\n  async deposit(transport, location, data, context) {\n    const buffer = Buffer.from(data, \"utf-8\");\n    try {\n      await transport.set(location, buffer, context.params);\n    } catch (error) {\n      throw new SemanticError(`Failed to deposit text to \"${location}\": ${error.message}`, this.name, { cause: error });\n    }\n  }\n  async exists(transport, location, _context) {\n    return transport.exists(location);\n  }\n  async delete(transport, location, _context) {\n    try {\n      await transport.delete(location);\n    } catch (error) {\n      throw new SemanticError(`Failed to delete \"${location}\": ${error.message}`, this.name, { cause: error });\n    }\n  }\n}\nvar textSemantic = new TextSemanticHandler;\n// src/transport/file.ts\nimport { access, mkdir, readdir, readFile, rm, stat, writeFile } from \"node:fs/promises\";\nimport { dirname, join, resolve } from \"node:path\";\nclass FileTransportHandler {\n  name = \"file\";\n  resolvePath(location) {\n    return resolve(process.cwd(), location);\n  }\n  async get(location, params) {\n    const filePath = this.resolvePath(location);\n    try {\n      const stats = await stat(filePath);\n      if (stats.isDirectory()) {\n        return this.getDirectory(filePath, stats, params);\n      } else {\n        return this.getFile(filePath, stats);\n      }\n    } catch (error) {\n      const err = error;\n      throw new TransportError(`File get error: ${err.code} - ${filePath}`, this.name, {\n        cause: err\n      });\n    }\n  }\n  async getFile(filePath, stats) {\n    const content = await readFile(filePath);\n    return {\n      content,\n      metadata: {\n        type: \"file\",\n        size: Number(stats.size),\n        modifiedAt: stats.mtime\n      }\n    };\n  }\n  async getDirectory(dirPath, stats, params) {\n    const recursive = params?.recursive === \"true\";\n    const pattern = params?.pattern;\n    let entries;\n    if (recursive) {\n      entries = await this.listRecursive(dirPath, dirPath);\n    } else {\n      entries = await readdir(dirPath);\n    }\n    if (pattern) {\n      entries = this.filterByPattern(entries, pattern);\n    }\n    const content = Buffer.from(JSON.stringify(entries));\n    return {\n      content,\n      metadata: {\n        type: \"directory\",\n        modifiedAt: stats.mtime\n      }\n    };\n  }\n  async listRecursive(basePath, currentPath) {\n    const entries = await readdir(currentPath, { withFileTypes: true });\n    const results = [];\n    for (const entry of entries) {\n      const fullPath = join(currentPath, entry.name);\n      const relativePath = fullPath.substring(basePath.length + 1);\n      if (entry.isDirectory()) {\n        const subEntries = await this.listRecursive(basePath, fullPath);\n        results.push(...subEntries);\n      } else {\n        results.push(relativePath);\n      }\n    }\n    return results;\n  }\n  filterByPattern(entries, pattern) {\n    const regexPattern = pattern.replace(/\\./g, \"\\\\.\").replace(/\\*/g, \".*\").replace(/\\?/g, \".\");\n    const regex = new RegExp(`^${regexPattern}$`);\n    return entries.filter((entry) => {\n      const filename = entry.split(\"/\").pop() || entry;\n      return regex.test(filename);\n    });\n  }\n  async set(location, content, _params) {\n    const filePath = this.resolvePath(location);\n    try {\n      await mkdir(dirname(filePath), { recursive: true });\n      await writeFile(filePath, content);\n    } catch (error) {\n      const err = error;\n      throw new TransportError(`File set error: ${err.code} - ${filePath}`, this.name, {\n        cause: err\n      });\n    }\n  }\n  async exists(location) {\n    const filePath = this.resolvePath(location);\n    try {\n      await access(filePath);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n  async delete(location) {\n    const filePath = this.resolvePath(location);\n    try {\n      await rm(filePath, { recursive: true });\n    } catch (error) {\n      const err = error;\n      if (err.code === \"ENOENT\") {\n        return;\n      }\n      throw new TransportError(`File delete error: ${err.code} - ${filePath}`, this.name, {\n        cause: err\n      });\n    }\n  }\n  async list(location, options) {\n    const dirPath = this.resolvePath(location);\n    try {\n      let entries;\n      if (options?.recursive) {\n        entries = await this.listRecursive(dirPath, dirPath);\n      } else {\n        entries = await readdir(dirPath);\n      }\n      if (options?.pattern) {\n        entries = this.filterByPattern(entries, options.pattern);\n      }\n      return entries;\n    } catch (error) {\n      const err = error;\n      throw new TransportError(`File list error: ${err.code} - ${dirPath}`, this.name, {\n        cause: err\n      });\n    }\n  }\n  async mkdir(location) {\n    const dirPath = this.resolvePath(location);\n    try {\n      await mkdir(dirPath, { recursive: true });\n    } catch (error) {\n      const err = error;\n      throw new TransportError(`File mkdir error: ${err.code} - ${dirPath}`, this.name, {\n        cause: err\n      });\n    }\n  }\n}\nvar fileTransport = new FileTransportHandler;\n// src/transport/http.ts\nclass HttpTransportHandler {\n  name;\n  protocol;\n  constructor(protocol = \"https\") {\n    this.protocol = protocol;\n    this.name = protocol;\n  }\n  async get(location, params) {\n    const url = this.buildUrl(location, params);\n    try {\n      const response = await fetch(url);\n      if (!response.ok) {\n        throw new TransportError(`HTTP ${response.status}: ${response.statusText} - ${url}`, this.name);\n      }\n      const arrayBuffer = await response.arrayBuffer();\n      const content = Buffer.from(arrayBuffer);\n      const contentType = response.headers.get(\"content-type\");\n      const contentLength = response.headers.get(\"content-length\");\n      const lastModified = response.headers.get(\"last-modified\");\n      return {\n        content,\n        metadata: {\n          type: \"file\",\n          size: contentLength ? parseInt(contentLength, 10) : content.length,\n          modifiedAt: lastModified ? new Date(lastModified) : undefined,\n          contentType\n        }\n      };\n    } catch (error) {\n      if (error instanceof TransportError) {\n        throw error;\n      }\n      throw new TransportError(`Network error: ${url}`, this.name, {\n        cause: error\n      });\n    }\n  }\n  buildUrl(location, params) {\n    const url = new URL(`${this.protocol}://${location}`);\n    if (params) {\n      for (const [key, value] of Object.entries(params)) {\n        url.searchParams.set(key, value);\n      }\n    }\n    return url.toString();\n  }\n  async set(_location, _content, _params) {\n    throw new TransportError(\"HTTP transport is read-only, set not supported\", this.name);\n  }\n  async exists(location) {\n    const url = `${this.protocol}://${location}`;\n    try {\n      const response = await fetch(url, { method: \"HEAD\" });\n      return response.ok;\n    } catch {\n      return false;\n    }\n  }\n  async delete(_location) {\n    throw new TransportError(\"HTTP transport is read-only, delete not supported\", this.name);\n  }\n}\nvar httpsTransport = new HttpTransportHandler(\"https\");\nvar httpTransport = new HttpTransportHandler(\"http\");\n// src/ARP.ts\nclass ARP {\n  transports;\n  semantics;\n  constructor(config = {}) {\n    this.transports = new Map;\n    this.semantics = new Map;\n    const defaultTransports = [fileTransport, httpTransport, httpsTransport];\n    const defaultSemantics = [textSemantic, binarySemantic];\n    for (const handler of defaultTransports) {\n      this.transports.set(handler.name, handler);\n    }\n    for (const handler of defaultSemantics) {\n      this.semantics.set(handler.name, handler);\n    }\n    if (config.transports) {\n      for (const handler of config.transports) {\n        this.transports.set(handler.name, handler);\n      }\n    }\n    if (config.semantics) {\n      for (const handler of config.semantics) {\n        this.semantics.set(handler.name, handler);\n      }\n    }\n  }\n  registerTransport(handler) {\n    this.transports.set(handler.name, handler);\n  }\n  registerSemantic(handler) {\n    this.semantics.set(handler.name, handler);\n  }\n  getTransportHandler(name) {\n    const handler = this.transports.get(name);\n    if (!handler) {\n      throw new TransportError(`Unsupported transport type: ${name}`, name);\n    }\n    return handler;\n  }\n  getSemanticHandler(name) {\n    const handler = this.semantics.get(name);\n    if (!handler) {\n      throw new SemanticError(`Unsupported semantic type: ${name}`, name);\n    }\n    return handler;\n  }\n  parse(url) {\n    if (!url.startsWith(\"arp:\")) {\n      throw new ParseError(`Invalid ARP URL: must start with \"arp:\"`, url);\n    }\n    const content = url.substring(4);\n    const separatorIndex = content.indexOf(\"://\");\n    if (separatorIndex === -1) {\n      throw new ParseError(`Invalid ARP URL: missing \"://\"`, url);\n    }\n    const typePart = content.substring(0, separatorIndex);\n    const location = content.substring(separatorIndex + 3);\n    const colonIndex = typePart.indexOf(\":\");\n    if (colonIndex === -1) {\n      throw new ParseError(`Invalid ARP URL: must have exactly 2 types (semantic:transport)`, url);\n    }\n    const semantic = typePart.substring(0, colonIndex);\n    const transport = typePart.substring(colonIndex + 1);\n    if (!semantic) {\n      throw new ParseError(`Invalid ARP URL: semantic type cannot be empty`, url);\n    }\n    if (!transport) {\n      throw new ParseError(`Invalid ARP URL: transport type cannot be empty`, url);\n    }\n    if (!location) {\n      throw new ParseError(`Invalid ARP URL: location cannot be empty`, url);\n    }\n    this.getTransportHandler(transport);\n    this.getSemanticHandler(semantic);\n    return new ARL(semantic, transport, location, this);\n  }\n}\nfunction createARP(config) {\n  return new ARP(config);\n}\n\n// src/index.ts\nvar VERSION = \"2.11.0\";\nexport {\n  textSemantic,\n  httpsTransport,\n  httpTransport,\n  fileTransport,\n  createARP,\n  binarySemantic,\n  VERSION,\n  TransportError,\n  TextSemanticHandler,\n  SemanticError,\n  ParseError,\n  HttpTransportHandler,\n  FileTransportHandler,\n  BinarySemanticHandler,\n  ARPError,\n  ARP\n};\n\n//# debugId=575AC5D22BBB2C2A64756E2164756E21\n"
   ],
   "mappings": "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",
-  "debugId": "41987E49544A3B4264756E2164756E21",
+  "debugId": "6F64DDE965E4BA0D64756E2164756E21",
   "names": []
 }

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { BundledType as BundledType2, FileEntry, FileTree, IsolatorType as IsolatorType2, ProviderConfig, ProviderStores, ResolveSourceConfig, ResourceXProvider as ResourceXProvider2, RXA, RXD, RXL, RXM, RXMArchive as RXMArchive2, RXMDefinition as RXMDefinition2, RXMSource as RXMSource2, RXR, RXS, SourceLoader, TypeDetectionResult, TypeDetector as TypeDetector2 } from "@resourcexjs/core";
+import { BundledType as BundledType2, FileEntry, FileTree, IsolatorType as IsolatorType2, ProviderConfig, ProviderStores, ResolveSourceConfig, ResourceXProvider as ResourceXProvider2, RXA, RXD, RXI, RXL as RXL2, RXM, RXMArchive as RXMArchive2, RXMDefinition as RXMDefinition2, RXMSource as RXMSource2, RXR, RXS, SourceLoader, TypeDetectionResult, TypeDetector as TypeDetector2 } from "@resourcexjs/core";
 import { archive, bundleResourceType, extract, FolderSourceLoader, format, GitHubSourceLoader, generateDefinition, manifest, parse, RegistryError, ResourceJsonDetector, ResourceTypeError, resolveSource, resource, SkillDetector, SourceLoaderChain, TypeDetectorChain, wrap } from "@resourcexjs/core";
 import { ResourceXProvider } from "@resourcexjs/core";
 /**
@@ -30,7 +30,7 @@ declare function hasProvider(): boolean;
 * Clear the provider (for testing).
 */
 declare function clearProvider(): void;
-import { BundledType, IsolatorType, RXMArchive, RXMDefinition, RXMSource, TypeDetector } from "@resourcexjs/core";
+import { BundledType, IsolatorType, RXL, RXMArchive, RXMDefinition, RXMSource, TypeDetector } from "@resourcexjs/core";
 /**
 * ResourceX configuration.
 */
@@ -71,6 +71,16 @@ interface Resource {
 	source: RXMSource;
 }
 /**
+* Options for push/pull operations.
+*/
+interface RegistryOptions {
+	/**
+	* Registry URL override for this operation.
+	* Takes precedence over the default registry.
+	*/
+	registry?: string;
+}
+/**
 * ResourceX interface - unified API for resource management.
 */
 interface ResourceX {
@@ -79,10 +89,10 @@ interface ResourceX {
 	info(locator: string): Promise<Resource>;
 	remove(locator: string): Promise<void>;
 	resolve<T = unknown>(locator: string, args?: unknown): Promise<T>;
-	ingest<T = unknown>(source: string, args?: unknown): Promise<T>;
+	ingest<T = unknown>(locator: RXL, args?: unknown): Promise<T>;
 	search(query?: string): Promise<string[]>;
-	push(locator: string): Promise<void>;
-	pull(locator: string): Promise<void>;
+	push(locator: string, options?: RegistryOptions): Promise<void>;
+	pull(locator: string, options?: RegistryOptions): Promise<void>;
 	clearCache(registry?: string): Promise<void>;
 	supportType(type: BundledType): void;
 }
@@ -91,7 +101,10 @@ interface ResourceX {
 *
 * Requires a provider to be set first via setProvider() or by importing
 * a platform entry point like 'resourcexjs/node'.
+*
+* When registry is not explicitly provided, the provider's getDefaults()
+* is consulted for environment variables and config file defaults.
 */
 declare function createResourceX(config?: ResourceXConfig): ResourceX;
 declare const VERSION: string;
-export { wrap, setProvider, resource, resolveSource, parse, manifest, hasProvider, getProvider, generateDefinition, format, extract, createResourceX, clearProvider, bundleResourceType, archive, VERSION, TypeDetectorChain, TypeDetector2 as TypeDetector, TypeDetectionResult, SourceLoaderChain, SourceLoader, SkillDetector, ResourceXProvider2 as ResourceXProvider, ResourceXConfig, ResourceX, ResourceTypeError, ResourceJsonDetector, Resource, ResolveSourceConfig, RegistryError, RXS, RXR, RXMSource2 as RXMSource, RXMDefinition2 as RXMDefinition, RXMArchive2 as RXMArchive, RXM, RXL, RXD, RXA, ProviderStores, ProviderConfig, IsolatorType2 as IsolatorType, GitHubSourceLoader, FolderSourceLoader, FileTree, FileEntry, BundledType2 as BundledType };
+export { wrap, setProvider, resource, resolveSource, parse, manifest, hasProvider, getProvider, generateDefinition, format, extract, createResourceX, clearProvider, bundleResourceType, archive, VERSION, TypeDetectorChain, TypeDetector2 as TypeDetector, TypeDetectionResult, SourceLoaderChain, SourceLoader, SkillDetector, ResourceXProvider2 as ResourceXProvider, ResourceXConfig, ResourceX, ResourceTypeError, ResourceJsonDetector, Resource, ResolveSourceConfig, RegistryOptions, RegistryError, RXS, RXR, RXMSource2 as RXMSource, RXMDefinition2 as RXMDefinition, RXMArchive2 as RXMArchive, RXM, RXL2 as RXL, RXI, RXD, RXA, ProviderStores, ProviderConfig, IsolatorType2 as IsolatorType, GitHubSourceLoader, FolderSourceLoader, FileTree, FileEntry, BundledType2 as BundledType };

package/dist/index.js

@@ -4709,17 +4709,17 @@ async function extract(rxa) {
   }
   return files2;
 }
-function format(rxl) {
+function format(rxi) {
   let result = "";
-  if (rxl.registry) {
-    result += `${rxl.registry}/`;
+  if (rxi.registry) {
+    result += `${rxi.registry}/`;
   }
-  if (rxl.path) {
-    result += `${rxl.path}/`;
+  if (rxi.path) {
+    result += `${rxi.path}/`;
   }
-  result += rxl.name;
-  if (rxl.tag && rxl.tag !== "latest") {
-    result += `:${rxl.tag}`;
+  result += rxi.name;
+  if (rxi.tag && rxi.tag !== "latest") {
+    result += `:${rxi.tag}`;
   }
   return result;
 }
@@ -4846,9 +4846,9 @@ function parse5(locator) {
   };
 }
 function resource(rxm, rxa) {
-  const rxl = locate(rxm);
+  const rxi = locate(rxm);
   return {
-    locator: rxl,
+    identifier: rxi,
     manifest: rxm,
     archive: rxa
   };
@@ -5237,17 +5237,17 @@ class RegistryMiddleware {
   constructor(inner) {
     this.inner = inner;
   }
-  get(rxl) {
-    return this.inner.get(rxl);
+  get(rxi) {
+    return this.inner.get(rxi);
   }
   put(rxr2) {
     return this.inner.put(rxr2);
   }
-  has(rxl) {
-    return this.inner.has(rxl);
+  has(rxi) {
+    return this.inner.has(rxi);
   }
-  remove(rxl) {
-    return this.inner.remove(rxl);
+  remove(rxi) {
+    return this.inner.remove(rxi);
   }
   list(options) {
     return this.inner.list(options);
@@ -5275,11 +5275,11 @@ class CASRegistry {
     }
     return tag;
   }
-  async get(rxl) {
-    const tag = await this.resolveTag(rxl.name, rxl.tag ?? "latest", rxl.registry);
-    const storedRxm = await this.rxmStore.get(rxl.name, tag, rxl.registry);
+  async get(rxi) {
+    const tag = await this.resolveTag(rxi.name, rxi.tag ?? "latest", rxi.registry);
+    const storedRxm = await this.rxmStore.get(rxi.name, tag, rxi.registry);
     if (!storedRxm) {
-      throw new RegistryError(`Resource not found: ${format(rxl)}`);
+      throw new RegistryError(`Resource not found: ${format(rxi)}`);
     }
     const files2 = {};
     for (const [filename, digest] of Object.entries(storedRxm.files)) {
@@ -5329,13 +5329,13 @@ class CASRegistry {
     await this.rxmStore.put(storedRxm);
     await this.rxmStore.setLatest(rxr2.manifest.definition.name, rxr2.manifest.definition.tag, rxr2.manifest.definition.registry);
   }
-  async has(rxl) {
-    const tag = await this.resolveTag(rxl.name, rxl.tag ?? "latest", rxl.registry);
-    return this.rxmStore.has(rxl.name, tag, rxl.registry);
+  async has(rxi) {
+    const tag = await this.resolveTag(rxi.name, rxi.tag ?? "latest", rxi.registry);
+    return this.rxmStore.has(rxi.name, tag, rxi.registry);
   }
-  async remove(rxl) {
-    const tag = rxl.tag ?? "latest";
-    await this.rxmStore.delete(rxl.name, tag, rxl.registry);
+  async remove(rxi) {
+    const tag = rxi.tag ?? "latest";
+    await this.rxmStore.delete(rxi.name, tag, rxi.registry);
   }
   async list(options) {
     const { query, limit, offset = 0 } = options ?? {};
@@ -5397,14 +5397,14 @@ class LinkedRegistry {
   constructor(basePath) {
     this.basePath = basePath;
   }
-  buildLinkPath(rxl) {
-    const registry2 = rxl.registry ?? "localhost";
-    const tag = rxl.tag ?? "latest";
+  buildLinkPath(rxi) {
+    const registry2 = rxi.registry ?? "localhost";
+    const tag = rxi.tag ?? "latest";
     let linkPath = join3(this.basePath, registry2);
-    if (rxl.path) {
-      linkPath = join3(linkPath, rxl.path);
+    if (rxi.path) {
+      linkPath = join3(linkPath, rxi.path);
     }
-    return join3(linkPath, rxl.name, tag);
+    return join3(linkPath, rxi.name, tag);
   }
   async isSymlink(path) {
     try {
@@ -5414,10 +5414,10 @@ class LinkedRegistry {
       return false;
     }
   }
-  async get(rxl) {
-    const linkPath = this.buildLinkPath(rxl);
+  async get(rxi) {
+    const linkPath = this.buildLinkPath(rxi);
     if (!await this.isSymlink(linkPath)) {
-      throw new RegistryError(`Linked resource not found: ${format(rxl)}`);
+      throw new RegistryError(`Linked resource not found: ${format(rxi)}`);
     }
     const targetPath = await readlink(linkPath);
     return loadResource(targetPath);
@@ -5425,29 +5425,29 @@ class LinkedRegistry {
   async put(_rxr) {
     throw new RegistryError("LinkedRegistry does not support put(). Use link() instead.");
   }
-  async has(rxl) {
-    const linkPath = this.buildLinkPath(rxl);
+  async has(rxi) {
+    const linkPath = this.buildLinkPath(rxi);
     return this.isSymlink(linkPath);
   }
-  async remove(rxl) {
-    const linkPath = this.buildLinkPath(rxl);
+  async remove(rxi) {
+    const linkPath = this.buildLinkPath(rxi);
     if (await this.isSymlink(linkPath)) {
       await rm(linkPath);
     }
   }
   async list(options) {
     const { query, limit, offset = 0 } = options ?? {};
-    const locators = [];
+    const identifiers = [];
     try {
-      await this.scanSymlinks(this.basePath, "", locators);
+      await this.scanSymlinks(this.basePath, "", identifiers);
     } catch {
       return [];
     }
-    let filtered = locators;
+    let filtered = identifiers;
     if (query) {
       const lowerQuery = query.toLowerCase();
-      filtered = locators.filter((rxl) => {
-        const searchText = `${rxl.registry ?? ""} ${rxl.path ?? ""} ${rxl.name}`.toLowerCase();
+      filtered = identifiers.filter((rxi) => {
+        const searchText = `${rxi.registry ?? ""} ${rxi.path ?? ""} ${rxi.name}`.toLowerCase();
         return searchText.includes(lowerQuery);
       });
     }
@@ -5459,7 +5459,7 @@ class LinkedRegistry {
   }
   async link(devPath) {
     const rxr2 = await loadResource(devPath);
-    const linkPath = this.buildLinkPath(rxr2.locator);
+    const linkPath = this.buildLinkPath(rxr2.identifier);
     try {
       const stats = await lstat(linkPath);
       if (stats.isSymbolicLink() || stats.isDirectory()) {
@@ -5470,12 +5470,12 @@ class LinkedRegistry {
     await mkdir(parentPath, { recursive: true });
     const absolutePath = resolvePath(devPath);
     await symlink(absolutePath, linkPath);
-    return rxr2.locator;
+    return rxr2.identifier;
   }
-  async unlink(rxl) {
-    return this.remove(rxl);
+  async unlink(rxi) {
+    return this.remove(rxi);
   }
-  async scanSymlinks(dirPath, relativePath, locators) {
+  async scanSymlinks(dirPath, relativePath, identifiers) {
     let entries;
     try {
       entries = await readdir3(dirPath);
@@ -5488,17 +5488,17 @@ class LinkedRegistry {
       try {
         const stats = await lstat(fullPath);
         if (stats.isSymbolicLink()) {
-          const rxl = this.parsePathToRXL(relPath);
-          if (rxl) {
-            locators.push(rxl);
+          const rxi = this.parsePathToRXI(relPath);
+          if (rxi) {
+            identifiers.push(rxi);
           }
         } else if (stats.isDirectory()) {
-          await this.scanSymlinks(fullPath, relPath, locators);
+          await this.scanSymlinks(fullPath, relPath, identifiers);
         }
       } catch {}
     }
   }
-  parsePathToRXL(relPath) {
+  parsePathToRXI(relPath) {
     const parts = relPath.split("/");
     if (parts.length < 3) {
       return null;
@@ -15488,8 +15488,8 @@ var init_dist = __esm(() => {
         throw new RegistryError(`Untrusted registry: resource claims "${rxr2.manifest.definition.registry}" but registry only trusts "${this.trustedRegistry}"`);
       }
     }
-    async get(rxl) {
-      const rxr2 = await this.inner.get(rxl);
+    async get(rxi) {
+      const rxr2 = await this.inner.get(rxi);
       this.validateRegistry(rxr2);
       return rxr2;
     }
@@ -31175,7 +31175,7 @@ class DefaultResourceX {
   }
   toResource(rxr2) {
     return {
-      locator: format(rxr2.locator),
+      locator: format(rxr2.identifier),
       definition: rxr2.manifest.definition,
       archive: rxr2.manifest.archive,
       source: rxr2.manifest.source
@@ -31213,7 +31213,7 @@ class DefaultResourceX {
     const fileTree = buildFileTree(filesRecord2);
     const preview = extractPreview(filesRecord2);
     return {
-      locator: format(rxr2.locator),
+      locator: format(rxr2.identifier),
       definition: rxr2.manifest.definition,
       archive: rxr2.manifest.archive,
       source: {
@@ -31230,13 +31230,13 @@ class DefaultResourceX {
     const executable = await this.prepareExecutable(locator);
     return executable.execute(args2);
   }
-  async ingest(source, args2) {
-    const isSource = await this.canLoadSource(source);
+  async ingest(locator, args2) {
+    const isSource = await this.canLoadSource(locator);
     if (isSource) {
-      const resource2 = await this.add(source);
+      const resource2 = await this.add(locator);
       return this.resolve(resource2.locator, args2);
     }
-    return this.resolve(source, args2);
+    return this.resolve(locator, args2);
   }
   async canLoadSource(source) {
     return this.loaderChain.canLoad(source);
@@ -31280,20 +31280,22 @@ class DefaultResourceX {
     const results = await this.cas.list(query ? { query } : undefined);
     return results.map((rxl) => format(rxl));
   }
-  async push(locator) {
-    if (!this.registryUrl) {
+  async push(locator, options) {
+    const registry2 = options?.registry ?? this.registryUrl;
+    if (!registry2) {
       throw new RegistryError("Registry URL not configured. Set 'registry' in config.");
     }
     const rxl = parse5(locator);
     const rxr2 = await this.cas.get(rxl);
-    await this.publishToRegistry(rxr2);
+    await this.publishToRegistry(rxr2, registry2);
   }
-  async pull(locator) {
-    if (!this.registryUrl) {
+  async pull(locator, options) {
+    const registry2 = options?.registry ?? this.registryUrl;
+    if (!registry2) {
       throw new RegistryError("Registry URL not configured. Set 'registry' in config.");
     }
-    const normalizedRegistry = normalizeRegistryUrl(this.registryUrl);
-    const rxr2 = await this.fetchFromRegistry(locator, this.registryUrl, normalizedRegistry);
+    const normalizedRegistry = normalizeRegistryUrl(registry2);
+    const rxr2 = await this.fetchFromRegistry(locator, registry2, normalizedRegistry);
     await this.cas.put(rxr2);
   }
   async clearCache(registry2) {
@@ -31311,11 +31313,11 @@ class DefaultResourceX {
     const rxr2 = await this.cas.get(rxl);
     return rxr2.archive.buffer();
   }
-  async publishToRegistry(rxr2) {
-    const baseUrl = this.registryUrl.replace(/\/$/, "");
+  async publishToRegistry(rxr2, registryUrl) {
+    const baseUrl = registryUrl.replace(/\/$/, "");
     const publishUrl = `${baseUrl}/api/v1/publish`;
     const formData = new FormData;
-    formData.append("locator", format(rxr2.locator));
+    formData.append("locator", format(rxr2.identifier));
     formData.append("manifest", new Blob([
       JSON.stringify({
         registry: rxr2.manifest.definition.registry,
@@ -31425,11 +31427,18 @@ function createResourceX2(config3) {
   if (!hasProvider()) {
     throw new Error('No ResourceX provider configured. Import a platform entry point (e.g., "resourcexjs/node") or call setProvider() first.');
   }
+  if (config3?.registry === undefined) {
+    const provider = getProvider();
+    const defaults = provider.getDefaults?.({ path: config3?.path });
+    if (defaults?.registry) {
+      config3 = { ...config3, registry: defaults.registry };
+    }
+  }
   return new DefaultResourceX(config3);
 }
 
 // src/index.ts
-var VERSION = "2.9.0";
+var VERSION = "2.11.0";
 export {
   wrap,
   setProvider,
@@ -31457,4 +31466,4 @@ export {
   FolderSourceLoader
 };
 
-//# debugId=C3CC99EA772701FD64756E2164756E21
+//# debugId=E9B6F26CD736E0DF64756E2164756E21