resourcexjs 2.8.0 → 2.10.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.8.0";
+var VERSION = "2.10.0";
 export {
   textSemantic,
   httpsTransport,
@@ -546,4 +546,4 @@ export {
   ARP
 };
 
-//# debugId=7C82395D8392B4D364756E2164756E21
+//# debugId=0D21EF07F3A6E51764756E2164756E21

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.8.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=A29CE647E53652E264756E2164756E21\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.10.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=95067844D155004064756E2164756E21\n"
   ],
   "mappings": "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",
-  "debugId": "7C82395D8392B4D364756E2164756E21",
+  "debugId": "0D21EF07F3A6E51764756E2164756E21",
   "names": []
 }

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { BundledType as BundledType2, IsolatorType as IsolatorType2, ProviderConfig, ProviderStores, ResolveSourceConfig, ResourceXProvider as ResourceXProvider2, RXA, RXD, RXL, RXM, 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, TypeDetector } from "@resourcexjs/core";
+import { BundledType, IsolatorType, RXL, RXMArchive, RXMDefinition, RXMSource, TypeDetector } from "@resourcexjs/core";
 /**
 * ResourceX configuration.
 */
@@ -62,15 +62,13 @@ interface ResourceXConfig {
 }
 /**
 * Resource - user-facing resource object.
+* Structured by RX primitives: definition, archive, source.
 */
 interface Resource {
 	locator: string;
-	registry?: string;
-	path?: string;
-	name: string;
-	type: string;
-	tag: string;
-	files?: string[];
+	definition: RXMDefinition;
+	archive: RXMArchive;
+	source: RXMSource;
 }
 /**
 * ResourceX interface - unified API for resource management.
@@ -81,7 +79,7 @@ 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>;
@@ -96,4 +94,4 @@ interface ResourceX {
 */
 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, RXM, RXL, RXD, RXA, ProviderStores, ProviderConfig, IsolatorType2 as IsolatorType, GitHubSourceLoader, FolderSourceLoader, 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, 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 };