@xyo-network/huri 2.107.3 → 2.107.4

package/dist/browser/index.cjs

@@ -1,2 +1,133 @@
-"use strict";var a=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var p=(o,t)=>a(o,"name",{value:t,configurable:!0});var P=(o,t)=>{for(var i in t)a(o,i,{get:t[i],enumerable:!0})},I=(o,t,i,s)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of u(t))!m.call(o,r)&&r!==i&&a(o,r,{get:()=>t[r],enumerable:!(s=g(t,r))||s.enumerable});return o};var $=o=>I(a({},"__esModule",{value:!0}),o);var y={};P(y,{Huri:()=>e});module.exports=$(y);var h=require("@xylabs/assert"),l=require("@xylabs/axios"),f=require("@xylabs/hex"),d=require("@xyo-network/account");var e=class o{static{p(this,"Huri")}archive;archivist;hash;originalHref;protocol;token;isHuri=!0;constructor(t,{archivistUri:i,token:s}={}){let r=o.isHuri(t)?.href??(typeof t=="string"?t:t instanceof ArrayBuffer?new d.AddressValue(t).hex:t.href);this.originalHref=r;let n=o.parseProtocol(r);this.protocol=n??"https";let v=(0,h.assertEx)(o.parsePath(r),()=>"Missing path");if(this.hash=(0,h.assertEx)(this.parsePath(v,n!==void 0),()=>"Missing hash"),(0,h.assertEx)((0,f.isHash)(this.hash),()=>`Invalid hash [${this.hash}]`),i){let c=i.split("://");this.protocol=c[0],this.archivist=c[1]}this.token=s,this.validateParse()}get href(){let t=[];return this.protocol&&t.push(`${this.protocol}:/`),this.archive&&t.push(`${this.archive}`),this.archivist&&t.push(`${this.archivist}`),t.push(this.hash),t.join("/")}static async fetch(t){let i=t.token?{Authorization:`Bearer ${t.token}`}:void 0;return(await l.axios.get(t.href,{headers:i})).data}static isHuri(t){if(typeof t=="object")return t.isHuri?t:void 0}static parsePath(t){let i=t.split("//");if((0,h.assertEx)(i.length<=2,()=>`Invalid format [${t}]`),i.length===1)return t;if(i.length===2)return i[1]}static parseProtocol(t){let i=t.split("//");(0,h.assertEx)(i.length<=2,()=>`Invalid second protocol [${i[2]}]`);let s=i.length===2?i.shift():void 0;if(s){let r=s?.split(":");return(0,h.assertEx)(r.length===2,()=>`Invalid protocol format [${s}]`),(0,h.assertEx)(r[1].length===0,()=>`Invalid protocol format (post :) [${s}]`),r.shift()}}async fetch(){return await o.fetch(this)}toString(){return this.href}parsePath(t,i){let s=t.split("/");(0,h.assertEx)(!(i&&s[0].length===0),()=>"Invalid protocol separator"),s[0].length===0&&s.shift();let r=(0,h.assertEx)(s.pop(),()=>"No hash specified");return this.archivist=s.shift()??"api.archivist.xyo.network",this.archive=s.pop(),(0,h.assertEx)(s.length===0,()=>"Too many path parts"),r}validateParse(){(0,h.assertEx)(this.archivist?.length!==0,()=>"Invalid archivist length"),(0,h.assertEx)(this.archive?.length!==0,()=>"Invalid archive length"),(0,h.assertEx)(!(this.archive&&!this.archivist),()=>"If specifying archive, archivist is also required")}};
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  Huri: () => Huri
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/Huri.ts
+var import_assert = require("@xylabs/assert");
+var import_axios = require("@xylabs/axios");
+var import_hex = require("@xylabs/hex");
+var import_account = require("@xyo-network/account");
+var Huri = class _Huri {
+  static {
+    __name(this, "Huri");
+  }
+  archive;
+  archivist;
+  hash;
+  originalHref;
+  protocol;
+  token;
+  isHuri = true;
+  constructor(huri, { archivistUri, token } = {}) {
+    const huriString = _Huri.isHuri(huri)?.href ?? (typeof huri === "string" ? huri : huri instanceof ArrayBuffer ? new import_account.AddressValue(huri).hex : huri.href);
+    this.originalHref = huriString;
+    const protocol = _Huri.parseProtocol(huriString);
+    this.protocol = protocol ?? "https";
+    const path = (0, import_assert.assertEx)(_Huri.parsePath(huriString), () => "Missing path");
+    this.hash = (0, import_assert.assertEx)(this.parsePath(path, protocol !== void 0), () => "Missing hash");
+    (0, import_assert.assertEx)((0, import_hex.isHash)(this.hash), () => `Invalid hash [${this.hash}]`);
+    if (archivistUri) {
+      const archivistUriParts = archivistUri.split("://");
+      this.protocol = archivistUriParts[0];
+      this.archivist = archivistUriParts[1];
+    }
+    this.token = token;
+    this.validateParse();
+  }
+  /*
+  The full href or the hash
+  */
+  get href() {
+    const parts = [];
+    if (this.protocol) {
+      parts.push(`${this.protocol}:/`);
+    }
+    if (this.archive) {
+      parts.push(`${this.archive}`);
+    }
+    if (this.archivist) {
+      parts.push(`${this.archivist}`);
+    }
+    parts.push(this.hash);
+    return parts.join("/");
+  }
+  static async fetch(huri) {
+    const AuthHeader = huri.token ? {
+      Authorization: `Bearer ${huri.token}`
+    } : void 0;
+    return (await import_axios.axios.get(huri.href, {
+      headers: AuthHeader
+    })).data;
+  }
+  static isHuri(value) {
+    if (typeof value === "object") {
+      return value.isHuri ? value : void 0;
+    }
+  }
+  static parsePath(huri) {
+    const protocolSplit = huri.split("//");
+    (0, import_assert.assertEx)(protocolSplit.length <= 2, () => `Invalid format [${huri}]`);
+    if (protocolSplit.length === 1) {
+      return huri;
+    }
+    if (protocolSplit.length === 2) {
+      return protocolSplit[1];
+    }
+  }
+  static parseProtocol(huri) {
+    const protocolSplit = huri.split("//");
+    (0, import_assert.assertEx)(protocolSplit.length <= 2, () => `Invalid second protocol [${protocolSplit[2]}]`);
+    const rawProtocol = protocolSplit.length === 2 ? protocolSplit.shift() : void 0;
+    if (rawProtocol) {
+      const protocolParts = rawProtocol?.split(":");
+      (0, import_assert.assertEx)(protocolParts.length === 2, () => `Invalid protocol format [${rawProtocol}]`);
+      (0, import_assert.assertEx)(protocolParts[1].length === 0, () => `Invalid protocol format (post :) [${rawProtocol}]`);
+      return protocolParts.shift();
+    }
+  }
+  async fetch() {
+    return await _Huri.fetch(this);
+  }
+  toString() {
+    return this.href;
+  }
+  parsePath(path, hasProtocol) {
+    const pathParts = path.split("/");
+    (0, import_assert.assertEx)(!(hasProtocol && pathParts[0].length === 0), () => "Invalid protocol separator");
+    pathParts[0].length === 0 ? pathParts.shift() : null;
+    const hash = (0, import_assert.assertEx)(pathParts.pop(), () => "No hash specified");
+    this.archivist = pathParts.shift() ?? "api.archivist.xyo.network";
+    this.archive = pathParts.pop();
+    (0, import_assert.assertEx)(pathParts.length === 0, () => "Too many path parts");
+    return hash;
+  }
+  validateParse() {
+    (0, import_assert.assertEx)(this.archivist?.length !== 0, () => "Invalid archivist length");
+    (0, import_assert.assertEx)(this.archive?.length !== 0, () => "Invalid archive length");
+    (0, import_assert.assertEx)(!(this.archive && !this.archivist), () => "If specifying archive, archivist is also required");
+  }
+};
 //# sourceMappingURL=index.cjs.map

package/dist/browser/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/Huri.ts"],"sourcesContent":["export * from './Huri'\n","import { assertEx } from '@xylabs/assert'\nimport { axios } from '@xylabs/axios'\nimport { Address, Hash, isHash } from '@xylabs/hex'\nimport { AddressValue } from '@xyo-network/account'\nimport { Payload } from '@xyo-network/payload-model'\n\nexport type ObjectCategory = 'block' | 'payload'\n\nexport type HuriFetchFunction = (huri: Huri) => Promise<Payload | undefined>\n\n/* \n  Valid Huri:\n\n  [<protocol>://][<archivist>/[<archive>/]]<hash>\n\n  defaults:\n    protocol: https\n    archivist: api.archivist.xyo.network\n*/\n\nexport interface HuriOptions {\n  archivistUri?: string\n  token?: string\n}\n\nexport interface FetchedPayload<T extends Payload = Payload> {\n  huri?: Huri\n  payload: T\n}\n\nexport class Huri<T extends Payload = Payload> {\n  archive?: string\n  archivist?: Address | string\n  hash: Hash\n  originalHref: string\n  protocol?: string\n  token?: string\n\n  private isHuri = true\n\n  constructor(huri: Hash | Huri | string, { archivistUri, token }: HuriOptions = {}) {\n    const huriString =\n      Huri.isHuri(huri)?.href ??\n      (typeof huri === 'string' ? (huri as string)\n      : huri instanceof ArrayBuffer ? new AddressValue(huri).hex\n      : huri.href)\n    this.originalHref = huriString\n\n    const protocol = Huri.parseProtocol(huriString)\n    this.protocol = protocol ?? 'https'\n\n    const path = assertEx(Huri.parsePath(huriString), () => 'Missing path')\n    this.hash = assertEx(this.parsePath(path, protocol !== undefined), () => 'Missing hash') as Hash\n\n    assertEx(isHash(this.hash), () => `Invalid hash [${this.hash}]`)\n\n    //if archivistUri sent, overwrite protocol and archivist\n    if (archivistUri) {\n      const archivistUriParts = archivistUri.split('://')\n      this.protocol = archivistUriParts[0]\n      this.archivist = archivistUriParts[1]\n    }\n\n    this.token = token\n\n    this.validateParse()\n  }\n\n  /*\n  The full href or the hash\n  */\n  get href() {\n    const parts: string[] = []\n    if (this.protocol) {\n      parts.push(`${this.protocol}:/`)\n    }\n    if (this.archive) {\n      parts.push(`${this.archive}`)\n    }\n    if (this.archivist) {\n      parts.push(`${this.archivist}`)\n    }\n    parts.push(this.hash)\n    return parts.join('/')\n  }\n\n  static async fetch<T extends Payload = Payload>(huri: Huri): Promise<T | undefined> {\n    const AuthHeader = huri.token ? { Authorization: `Bearer ${huri.token}` } : undefined\n    return (await axios.get<T>(huri.href, { headers: AuthHeader })).data\n  }\n\n  static isHuri(value: unknown) {\n    if (typeof value === 'object') {\n      return (value as Huri).isHuri ? (value as Huri) : undefined\n    }\n  }\n\n  private static parsePath(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid format [${huri}]`)\n    if (protocolSplit.length === 1) {\n      return huri\n    }\n    if (protocolSplit.length === 2) {\n      return protocolSplit[1]\n    }\n  }\n\n  private static parseProtocol(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid second protocol [${protocolSplit[2]}]`)\n    const rawProtocol = protocolSplit.length === 2 ? protocolSplit.shift() : undefined\n    if (rawProtocol) {\n      const protocolParts = rawProtocol?.split(':')\n      assertEx(protocolParts.length === 2, () => `Invalid protocol format [${rawProtocol}]`)\n      assertEx(protocolParts[1].length === 0, () => `Invalid protocol format (post :) [${rawProtocol}]`)\n      return protocolParts.shift()\n    }\n  }\n\n  async fetch(): Promise<T | undefined> {\n    return await Huri.fetch<T>(this)\n  }\n\n  toString() {\n    return this.href\n  }\n\n  private parsePath(path: string, hasProtocol: boolean) {\n    const pathParts = path.split('/')\n\n    //if the protocol was found, then there is not allowed to be a leading /\n    assertEx(!(hasProtocol && pathParts[0].length === 0), () => 'Invalid protocol separator')\n\n    //remove leading '/' if needed\n    pathParts[0].length === 0 ? pathParts.shift() : null\n\n    //hash is assumed to be the last part\n    const hash = assertEx(pathParts.pop(), () => 'No hash specified')\n\n    //archivist is assumed to be the first part\n    this.archivist = pathParts.shift() ?? 'api.archivist.xyo.network'\n\n    //the archive is whatever is left\n    this.archive = pathParts.pop()\n\n    //after we pull off all the path parts, there should be nothing left\n    assertEx(pathParts.length === 0, () => 'Too many path parts')\n\n    return hash\n  }\n\n  private validateParse() {\n    //the archivist should not be zero length\n    assertEx(this.archivist?.length !== 0, () => 'Invalid archivist length')\n\n    //the archivist should not be zero length (can be undefined)\n    assertEx(this.archive?.length !== 0, () => 'Invalid archive length')\n\n    //the archive should not be set if the archivist is not set\n    assertEx(!(this.archive && !this.archivist), () => 'If specifying archive, archivist is also required')\n  }\n}\n"],"mappings":"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","names":["src_exports","__export","Huri","__toCommonJS","import_assert","import_axios","import_hex","import_account","Huri","archive","archivist","hash","originalHref","protocol","token","isHuri","constructor","huri","archivistUri","huriString","href","ArrayBuffer","AddressValue","hex","parseProtocol","path","assertEx","parsePath","undefined","isHash","archivistUriParts","split","validateParse","parts","push","join","fetch","AuthHeader","Authorization","axios","get","headers","data","value","protocolSplit","length","rawProtocol","shift","protocolParts","toString","hasProtocol","pathParts","pop"]}
+{"version":3,"sources":["../../src/index.ts","../../src/Huri.ts"],"sourcesContent":["export * from './Huri'\n","import { assertEx } from '@xylabs/assert'\nimport { axios } from '@xylabs/axios'\nimport { Address, Hash, isHash } from '@xylabs/hex'\nimport { AddressValue } from '@xyo-network/account'\nimport { Payload } from '@xyo-network/payload-model'\n\nexport type ObjectCategory = 'block' | 'payload'\n\nexport type HuriFetchFunction = (huri: Huri) => Promise<Payload | undefined>\n\n/* \n  Valid Huri:\n\n  [<protocol>://][<archivist>/[<archive>/]]<hash>\n\n  defaults:\n    protocol: https\n    archivist: api.archivist.xyo.network\n*/\n\nexport interface HuriOptions {\n  archivistUri?: string\n  token?: string\n}\n\nexport interface FetchedPayload<T extends Payload = Payload> {\n  huri?: Huri\n  payload: T\n}\n\nexport class Huri<T extends Payload = Payload> {\n  archive?: string\n  archivist?: Address | string\n  hash: Hash\n  originalHref: string\n  protocol?: string\n  token?: string\n\n  private isHuri = true\n\n  constructor(huri: Hash | Huri | string, { archivistUri, token }: HuriOptions = {}) {\n    const huriString =\n      Huri.isHuri(huri)?.href ??\n      (typeof huri === 'string' ? (huri as string)\n      : huri instanceof ArrayBuffer ? new AddressValue(huri).hex\n      : huri.href)\n    this.originalHref = huriString\n\n    const protocol = Huri.parseProtocol(huriString)\n    this.protocol = protocol ?? 'https'\n\n    const path = assertEx(Huri.parsePath(huriString), () => 'Missing path')\n    this.hash = assertEx(this.parsePath(path, protocol !== undefined), () => 'Missing hash') as Hash\n\n    assertEx(isHash(this.hash), () => `Invalid hash [${this.hash}]`)\n\n    //if archivistUri sent, overwrite protocol and archivist\n    if (archivistUri) {\n      const archivistUriParts = archivistUri.split('://')\n      this.protocol = archivistUriParts[0]\n      this.archivist = archivistUriParts[1]\n    }\n\n    this.token = token\n\n    this.validateParse()\n  }\n\n  /*\n  The full href or the hash\n  */\n  get href() {\n    const parts: string[] = []\n    if (this.protocol) {\n      parts.push(`${this.protocol}:/`)\n    }\n    if (this.archive) {\n      parts.push(`${this.archive}`)\n    }\n    if (this.archivist) {\n      parts.push(`${this.archivist}`)\n    }\n    parts.push(this.hash)\n    return parts.join('/')\n  }\n\n  static async fetch<T extends Payload = Payload>(huri: Huri): Promise<T | undefined> {\n    const AuthHeader = huri.token ? { Authorization: `Bearer ${huri.token}` } : undefined\n    return (await axios.get<T>(huri.href, { headers: AuthHeader })).data\n  }\n\n  static isHuri(value: unknown) {\n    if (typeof value === 'object') {\n      return (value as Huri).isHuri ? (value as Huri) : undefined\n    }\n  }\n\n  private static parsePath(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid format [${huri}]`)\n    if (protocolSplit.length === 1) {\n      return huri\n    }\n    if (protocolSplit.length === 2) {\n      return protocolSplit[1]\n    }\n  }\n\n  private static parseProtocol(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid second protocol [${protocolSplit[2]}]`)\n    const rawProtocol = protocolSplit.length === 2 ? protocolSplit.shift() : undefined\n    if (rawProtocol) {\n      const protocolParts = rawProtocol?.split(':')\n      assertEx(protocolParts.length === 2, () => `Invalid protocol format [${rawProtocol}]`)\n      assertEx(protocolParts[1].length === 0, () => `Invalid protocol format (post :) [${rawProtocol}]`)\n      return protocolParts.shift()\n    }\n  }\n\n  async fetch(): Promise<T | undefined> {\n    return await Huri.fetch<T>(this)\n  }\n\n  toString() {\n    return this.href\n  }\n\n  private parsePath(path: string, hasProtocol: boolean) {\n    const pathParts = path.split('/')\n\n    //if the protocol was found, then there is not allowed to be a leading /\n    assertEx(!(hasProtocol && pathParts[0].length === 0), () => 'Invalid protocol separator')\n\n    //remove leading '/' if needed\n    pathParts[0].length === 0 ? pathParts.shift() : null\n\n    //hash is assumed to be the last part\n    const hash = assertEx(pathParts.pop(), () => 'No hash specified')\n\n    //archivist is assumed to be the first part\n    this.archivist = pathParts.shift() ?? 'api.archivist.xyo.network'\n\n    //the archive is whatever is left\n    this.archive = pathParts.pop()\n\n    //after we pull off all the path parts, there should be nothing left\n    assertEx(pathParts.length === 0, () => 'Too many path parts')\n\n    return hash\n  }\n\n  private validateParse() {\n    //the archivist should not be zero length\n    assertEx(this.archivist?.length !== 0, () => 'Invalid archivist length')\n\n    //the archivist should not be zero length (can be undefined)\n    assertEx(this.archive?.length !== 0, () => 'Invalid archive length')\n\n    //the archive should not be set if the archivist is not set\n    assertEx(!(this.archive && !this.archivist), () => 'If specifying archive, archivist is also required')\n  }\n}\n"],"mappings":"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","names":["Huri","archive","archivist","hash","originalHref","protocol","token","isHuri","constructor","huri","archivistUri","huriString","href","ArrayBuffer","AddressValue","hex","parseProtocol","path","assertEx","parsePath","undefined","isHash","archivistUriParts","split","validateParse","parts","push","join","fetch","AuthHeader","Authorization","axios","get","headers","data","value","protocolSplit","length","rawProtocol","shift","protocolParts","toString","hasProtocol","pathParts","pop"]}

package/dist/browser/index.js

@@ -1,2 +1,112 @@
-var l=Object.defineProperty;var n=(h,t)=>l(h,"name",{value:t,configurable:!0});import{assertEx as r}from"@xylabs/assert";import{axios as f}from"@xylabs/axios";import{isHash as d}from"@xylabs/hex";import{AddressValue as v}from"@xyo-network/account";var c=class h{static{n(this,"Huri")}archive;archivist;hash;originalHref;protocol;token;isHuri=!0;constructor(t,{archivistUri:i,token:s}={}){let o=h.isHuri(t)?.href??(typeof t=="string"?t:t instanceof ArrayBuffer?new v(t).hex:t.href);this.originalHref=o;let a=h.parseProtocol(o);this.protocol=a??"https";let p=r(h.parsePath(o),()=>"Missing path");if(this.hash=r(this.parsePath(p,a!==void 0),()=>"Missing hash"),r(d(this.hash),()=>`Invalid hash [${this.hash}]`),i){let e=i.split("://");this.protocol=e[0],this.archivist=e[1]}this.token=s,this.validateParse()}get href(){let t=[];return this.protocol&&t.push(`${this.protocol}:/`),this.archive&&t.push(`${this.archive}`),this.archivist&&t.push(`${this.archivist}`),t.push(this.hash),t.join("/")}static async fetch(t){let i=t.token?{Authorization:`Bearer ${t.token}`}:void 0;return(await f.get(t.href,{headers:i})).data}static isHuri(t){if(typeof t=="object")return t.isHuri?t:void 0}static parsePath(t){let i=t.split("//");if(r(i.length<=2,()=>`Invalid format [${t}]`),i.length===1)return t;if(i.length===2)return i[1]}static parseProtocol(t){let i=t.split("//");r(i.length<=2,()=>`Invalid second protocol [${i[2]}]`);let s=i.length===2?i.shift():void 0;if(s){let o=s?.split(":");return r(o.length===2,()=>`Invalid protocol format [${s}]`),r(o[1].length===0,()=>`Invalid protocol format (post :) [${s}]`),o.shift()}}async fetch(){return await h.fetch(this)}toString(){return this.href}parsePath(t,i){let s=t.split("/");r(!(i&&s[0].length===0),()=>"Invalid protocol separator"),s[0].length===0&&s.shift();let o=r(s.pop(),()=>"No hash specified");return this.archivist=s.shift()??"api.archivist.xyo.network",this.archive=s.pop(),r(s.length===0,()=>"Too many path parts"),o}validateParse(){r(this.archivist?.length!==0,()=>"Invalid archivist length"),r(this.archive?.length!==0,()=>"Invalid archive length"),r(!(this.archive&&!this.archivist),()=>"If specifying archive, archivist is also required")}};export{c as Huri};
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/Huri.ts
+import { assertEx } from "@xylabs/assert";
+import { axios } from "@xylabs/axios";
+import { isHash } from "@xylabs/hex";
+import { AddressValue } from "@xyo-network/account";
+var Huri = class _Huri {
+  static {
+    __name(this, "Huri");
+  }
+  archive;
+  archivist;
+  hash;
+  originalHref;
+  protocol;
+  token;
+  isHuri = true;
+  constructor(huri, { archivistUri, token } = {}) {
+    const huriString = _Huri.isHuri(huri)?.href ?? (typeof huri === "string" ? huri : huri instanceof ArrayBuffer ? new AddressValue(huri).hex : huri.href);
+    this.originalHref = huriString;
+    const protocol = _Huri.parseProtocol(huriString);
+    this.protocol = protocol ?? "https";
+    const path = assertEx(_Huri.parsePath(huriString), () => "Missing path");
+    this.hash = assertEx(this.parsePath(path, protocol !== void 0), () => "Missing hash");
+    assertEx(isHash(this.hash), () => `Invalid hash [${this.hash}]`);
+    if (archivistUri) {
+      const archivistUriParts = archivistUri.split("://");
+      this.protocol = archivistUriParts[0];
+      this.archivist = archivistUriParts[1];
+    }
+    this.token = token;
+    this.validateParse();
+  }
+  /*
+  The full href or the hash
+  */
+  get href() {
+    const parts = [];
+    if (this.protocol) {
+      parts.push(`${this.protocol}:/`);
+    }
+    if (this.archive) {
+      parts.push(`${this.archive}`);
+    }
+    if (this.archivist) {
+      parts.push(`${this.archivist}`);
+    }
+    parts.push(this.hash);
+    return parts.join("/");
+  }
+  static async fetch(huri) {
+    const AuthHeader = huri.token ? {
+      Authorization: `Bearer ${huri.token}`
+    } : void 0;
+    return (await axios.get(huri.href, {
+      headers: AuthHeader
+    })).data;
+  }
+  static isHuri(value) {
+    if (typeof value === "object") {
+      return value.isHuri ? value : void 0;
+    }
+  }
+  static parsePath(huri) {
+    const protocolSplit = huri.split("//");
+    assertEx(protocolSplit.length <= 2, () => `Invalid format [${huri}]`);
+    if (protocolSplit.length === 1) {
+      return huri;
+    }
+    if (protocolSplit.length === 2) {
+      return protocolSplit[1];
+    }
+  }
+  static parseProtocol(huri) {
+    const protocolSplit = huri.split("//");
+    assertEx(protocolSplit.length <= 2, () => `Invalid second protocol [${protocolSplit[2]}]`);
+    const rawProtocol = protocolSplit.length === 2 ? protocolSplit.shift() : void 0;
+    if (rawProtocol) {
+      const protocolParts = rawProtocol?.split(":");
+      assertEx(protocolParts.length === 2, () => `Invalid protocol format [${rawProtocol}]`);
+      assertEx(protocolParts[1].length === 0, () => `Invalid protocol format (post :) [${rawProtocol}]`);
+      return protocolParts.shift();
+    }
+  }
+  async fetch() {
+    return await _Huri.fetch(this);
+  }
+  toString() {
+    return this.href;
+  }
+  parsePath(path, hasProtocol) {
+    const pathParts = path.split("/");
+    assertEx(!(hasProtocol && pathParts[0].length === 0), () => "Invalid protocol separator");
+    pathParts[0].length === 0 ? pathParts.shift() : null;
+    const hash = assertEx(pathParts.pop(), () => "No hash specified");
+    this.archivist = pathParts.shift() ?? "api.archivist.xyo.network";
+    this.archive = pathParts.pop();
+    assertEx(pathParts.length === 0, () => "Too many path parts");
+    return hash;
+  }
+  validateParse() {
+    assertEx(this.archivist?.length !== 0, () => "Invalid archivist length");
+    assertEx(this.archive?.length !== 0, () => "Invalid archive length");
+    assertEx(!(this.archive && !this.archivist), () => "If specifying archive, archivist is also required");
+  }
+};
+export {
+  Huri
+};
 //# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/Huri.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { axios } from '@xylabs/axios'\nimport { Address, Hash, isHash } from '@xylabs/hex'\nimport { AddressValue } from '@xyo-network/account'\nimport { Payload } from '@xyo-network/payload-model'\n\nexport type ObjectCategory = 'block' | 'payload'\n\nexport type HuriFetchFunction = (huri: Huri) => Promise<Payload | undefined>\n\n/* \n  Valid Huri:\n\n  [<protocol>://][<archivist>/[<archive>/]]<hash>\n\n  defaults:\n    protocol: https\n    archivist: api.archivist.xyo.network\n*/\n\nexport interface HuriOptions {\n  archivistUri?: string\n  token?: string\n}\n\nexport interface FetchedPayload<T extends Payload = Payload> {\n  huri?: Huri\n  payload: T\n}\n\nexport class Huri<T extends Payload = Payload> {\n  archive?: string\n  archivist?: Address | string\n  hash: Hash\n  originalHref: string\n  protocol?: string\n  token?: string\n\n  private isHuri = true\n\n  constructor(huri: Hash | Huri | string, { archivistUri, token }: HuriOptions = {}) {\n    const huriString =\n      Huri.isHuri(huri)?.href ??\n      (typeof huri === 'string' ? (huri as string)\n      : huri instanceof ArrayBuffer ? new AddressValue(huri).hex\n      : huri.href)\n    this.originalHref = huriString\n\n    const protocol = Huri.parseProtocol(huriString)\n    this.protocol = protocol ?? 'https'\n\n    const path = assertEx(Huri.parsePath(huriString), () => 'Missing path')\n    this.hash = assertEx(this.parsePath(path, protocol !== undefined), () => 'Missing hash') as Hash\n\n    assertEx(isHash(this.hash), () => `Invalid hash [${this.hash}]`)\n\n    //if archivistUri sent, overwrite protocol and archivist\n    if (archivistUri) {\n      const archivistUriParts = archivistUri.split('://')\n      this.protocol = archivistUriParts[0]\n      this.archivist = archivistUriParts[1]\n    }\n\n    this.token = token\n\n    this.validateParse()\n  }\n\n  /*\n  The full href or the hash\n  */\n  get href() {\n    const parts: string[] = []\n    if (this.protocol) {\n      parts.push(`${this.protocol}:/`)\n    }\n    if (this.archive) {\n      parts.push(`${this.archive}`)\n    }\n    if (this.archivist) {\n      parts.push(`${this.archivist}`)\n    }\n    parts.push(this.hash)\n    return parts.join('/')\n  }\n\n  static async fetch<T extends Payload = Payload>(huri: Huri): Promise<T | undefined> {\n    const AuthHeader = huri.token ? { Authorization: `Bearer ${huri.token}` } : undefined\n    return (await axios.get<T>(huri.href, { headers: AuthHeader })).data\n  }\n\n  static isHuri(value: unknown) {\n    if (typeof value === 'object') {\n      return (value as Huri).isHuri ? (value as Huri) : undefined\n    }\n  }\n\n  private static parsePath(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid format [${huri}]`)\n    if (protocolSplit.length === 1) {\n      return huri\n    }\n    if (protocolSplit.length === 2) {\n      return protocolSplit[1]\n    }\n  }\n\n  private static parseProtocol(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid second protocol [${protocolSplit[2]}]`)\n    const rawProtocol = protocolSplit.length === 2 ? protocolSplit.shift() : undefined\n    if (rawProtocol) {\n      const protocolParts = rawProtocol?.split(':')\n      assertEx(protocolParts.length === 2, () => `Invalid protocol format [${rawProtocol}]`)\n      assertEx(protocolParts[1].length === 0, () => `Invalid protocol format (post :) [${rawProtocol}]`)\n      return protocolParts.shift()\n    }\n  }\n\n  async fetch(): Promise<T | undefined> {\n    return await Huri.fetch<T>(this)\n  }\n\n  toString() {\n    return this.href\n  }\n\n  private parsePath(path: string, hasProtocol: boolean) {\n    const pathParts = path.split('/')\n\n    //if the protocol was found, then there is not allowed to be a leading /\n    assertEx(!(hasProtocol && pathParts[0].length === 0), () => 'Invalid protocol separator')\n\n    //remove leading '/' if needed\n    pathParts[0].length === 0 ? pathParts.shift() : null\n\n    //hash is assumed to be the last part\n    const hash = assertEx(pathParts.pop(), () => 'No hash specified')\n\n    //archivist is assumed to be the first part\n    this.archivist = pathParts.shift() ?? 'api.archivist.xyo.network'\n\n    //the archive is whatever is left\n    this.archive = pathParts.pop()\n\n    //after we pull off all the path parts, there should be nothing left\n    assertEx(pathParts.length === 0, () => 'Too many path parts')\n\n    return hash\n  }\n\n  private validateParse() {\n    //the archivist should not be zero length\n    assertEx(this.archivist?.length !== 0, () => 'Invalid archivist length')\n\n    //the archivist should not be zero length (can be undefined)\n    assertEx(this.archive?.length !== 0, () => 'Invalid archive length')\n\n    //the archive should not be set if the archivist is not set\n    assertEx(!(this.archive && !this.archivist), () => 'If specifying archive, archivist is also required')\n  }\n}\n"],"mappings":"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","names":["assertEx","axios","isHash","AddressValue","Huri","archive","archivist","hash","originalHref","protocol","token","isHuri","constructor","huri","archivistUri","huriString","href","ArrayBuffer","AddressValue","hex","parseProtocol","path","assertEx","parsePath","undefined","isHash","archivistUriParts","split","validateParse","parts","push","join","fetch","AuthHeader","Authorization","axios","get","headers","data","value","protocolSplit","length","rawProtocol","shift","protocolParts","toString","hasProtocol","pathParts","pop"]}
+{"version":3,"sources":["../../src/Huri.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { axios } from '@xylabs/axios'\nimport { Address, Hash, isHash } from '@xylabs/hex'\nimport { AddressValue } from '@xyo-network/account'\nimport { Payload } from '@xyo-network/payload-model'\n\nexport type ObjectCategory = 'block' | 'payload'\n\nexport type HuriFetchFunction = (huri: Huri) => Promise<Payload | undefined>\n\n/* \n  Valid Huri:\n\n  [<protocol>://][<archivist>/[<archive>/]]<hash>\n\n  defaults:\n    protocol: https\n    archivist: api.archivist.xyo.network\n*/\n\nexport interface HuriOptions {\n  archivistUri?: string\n  token?: string\n}\n\nexport interface FetchedPayload<T extends Payload = Payload> {\n  huri?: Huri\n  payload: T\n}\n\nexport class Huri<T extends Payload = Payload> {\n  archive?: string\n  archivist?: Address | string\n  hash: Hash\n  originalHref: string\n  protocol?: string\n  token?: string\n\n  private isHuri = true\n\n  constructor(huri: Hash | Huri | string, { archivistUri, token }: HuriOptions = {}) {\n    const huriString =\n      Huri.isHuri(huri)?.href ??\n      (typeof huri === 'string' ? (huri as string)\n      : huri instanceof ArrayBuffer ? new AddressValue(huri).hex\n      : huri.href)\n    this.originalHref = huriString\n\n    const protocol = Huri.parseProtocol(huriString)\n    this.protocol = protocol ?? 'https'\n\n    const path = assertEx(Huri.parsePath(huriString), () => 'Missing path')\n    this.hash = assertEx(this.parsePath(path, protocol !== undefined), () => 'Missing hash') as Hash\n\n    assertEx(isHash(this.hash), () => `Invalid hash [${this.hash}]`)\n\n    //if archivistUri sent, overwrite protocol and archivist\n    if (archivistUri) {\n      const archivistUriParts = archivistUri.split('://')\n      this.protocol = archivistUriParts[0]\n      this.archivist = archivistUriParts[1]\n    }\n\n    this.token = token\n\n    this.validateParse()\n  }\n\n  /*\n  The full href or the hash\n  */\n  get href() {\n    const parts: string[] = []\n    if (this.protocol) {\n      parts.push(`${this.protocol}:/`)\n    }\n    if (this.archive) {\n      parts.push(`${this.archive}`)\n    }\n    if (this.archivist) {\n      parts.push(`${this.archivist}`)\n    }\n    parts.push(this.hash)\n    return parts.join('/')\n  }\n\n  static async fetch<T extends Payload = Payload>(huri: Huri): Promise<T | undefined> {\n    const AuthHeader = huri.token ? { Authorization: `Bearer ${huri.token}` } : undefined\n    return (await axios.get<T>(huri.href, { headers: AuthHeader })).data\n  }\n\n  static isHuri(value: unknown) {\n    if (typeof value === 'object') {\n      return (value as Huri).isHuri ? (value as Huri) : undefined\n    }\n  }\n\n  private static parsePath(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid format [${huri}]`)\n    if (protocolSplit.length === 1) {\n      return huri\n    }\n    if (protocolSplit.length === 2) {\n      return protocolSplit[1]\n    }\n  }\n\n  private static parseProtocol(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid second protocol [${protocolSplit[2]}]`)\n    const rawProtocol = protocolSplit.length === 2 ? protocolSplit.shift() : undefined\n    if (rawProtocol) {\n      const protocolParts = rawProtocol?.split(':')\n      assertEx(protocolParts.length === 2, () => `Invalid protocol format [${rawProtocol}]`)\n      assertEx(protocolParts[1].length === 0, () => `Invalid protocol format (post :) [${rawProtocol}]`)\n      return protocolParts.shift()\n    }\n  }\n\n  async fetch(): Promise<T | undefined> {\n    return await Huri.fetch<T>(this)\n  }\n\n  toString() {\n    return this.href\n  }\n\n  private parsePath(path: string, hasProtocol: boolean) {\n    const pathParts = path.split('/')\n\n    //if the protocol was found, then there is not allowed to be a leading /\n    assertEx(!(hasProtocol && pathParts[0].length === 0), () => 'Invalid protocol separator')\n\n    //remove leading '/' if needed\n    pathParts[0].length === 0 ? pathParts.shift() : null\n\n    //hash is assumed to be the last part\n    const hash = assertEx(pathParts.pop(), () => 'No hash specified')\n\n    //archivist is assumed to be the first part\n    this.archivist = pathParts.shift() ?? 'api.archivist.xyo.network'\n\n    //the archive is whatever is left\n    this.archive = pathParts.pop()\n\n    //after we pull off all the path parts, there should be nothing left\n    assertEx(pathParts.length === 0, () => 'Too many path parts')\n\n    return hash\n  }\n\n  private validateParse() {\n    //the archivist should not be zero length\n    assertEx(this.archivist?.length !== 0, () => 'Invalid archivist length')\n\n    //the archivist should not be zero length (can be undefined)\n    assertEx(this.archive?.length !== 0, () => 'Invalid archive length')\n\n    //the archive should not be set if the archivist is not set\n    assertEx(!(this.archive && !this.archivist), () => 'If specifying archive, archivist is also required')\n  }\n}\n"],"mappings":"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","names":["assertEx","axios","isHash","AddressValue","Huri","archive","archivist","hash","originalHref","protocol","token","isHuri","constructor","huri","archivistUri","huriString","href","ArrayBuffer","AddressValue","hex","parseProtocol","path","assertEx","parsePath","undefined","isHash","archivistUriParts","split","validateParse","parts","push","join","fetch","AuthHeader","Authorization","axios","get","headers","data","value","protocolSplit","length","rawProtocol","shift","protocolParts","toString","hasProtocol","pathParts","pop"]}

package/dist/neutral/index.cjs

@@ -1,2 +1,133 @@
-"use strict";var a=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var p=(o,t)=>a(o,"name",{value:t,configurable:!0});var P=(o,t)=>{for(var i in t)a(o,i,{get:t[i],enumerable:!0})},I=(o,t,i,s)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of u(t))!m.call(o,r)&&r!==i&&a(o,r,{get:()=>t[r],enumerable:!(s=g(t,r))||s.enumerable});return o};var $=o=>I(a({},"__esModule",{value:!0}),o);var y={};P(y,{Huri:()=>e});module.exports=$(y);var h=require("@xylabs/assert"),l=require("@xylabs/axios"),f=require("@xylabs/hex"),d=require("@xyo-network/account");var e=class o{static{p(this,"Huri")}archive;archivist;hash;originalHref;protocol;token;isHuri=!0;constructor(t,{archivistUri:i,token:s}={}){let r=o.isHuri(t)?.href??(typeof t=="string"?t:t instanceof ArrayBuffer?new d.AddressValue(t).hex:t.href);this.originalHref=r;let n=o.parseProtocol(r);this.protocol=n??"https";let v=(0,h.assertEx)(o.parsePath(r),()=>"Missing path");if(this.hash=(0,h.assertEx)(this.parsePath(v,n!==void 0),()=>"Missing hash"),(0,h.assertEx)((0,f.isHash)(this.hash),()=>`Invalid hash [${this.hash}]`),i){let c=i.split("://");this.protocol=c[0],this.archivist=c[1]}this.token=s,this.validateParse()}get href(){let t=[];return this.protocol&&t.push(`${this.protocol}:/`),this.archive&&t.push(`${this.archive}`),this.archivist&&t.push(`${this.archivist}`),t.push(this.hash),t.join("/")}static async fetch(t){let i=t.token?{Authorization:`Bearer ${t.token}`}:void 0;return(await l.axios.get(t.href,{headers:i})).data}static isHuri(t){if(typeof t=="object")return t.isHuri?t:void 0}static parsePath(t){let i=t.split("//");if((0,h.assertEx)(i.length<=2,()=>`Invalid format [${t}]`),i.length===1)return t;if(i.length===2)return i[1]}static parseProtocol(t){let i=t.split("//");(0,h.assertEx)(i.length<=2,()=>`Invalid second protocol [${i[2]}]`);let s=i.length===2?i.shift():void 0;if(s){let r=s?.split(":");return(0,h.assertEx)(r.length===2,()=>`Invalid protocol format [${s}]`),(0,h.assertEx)(r[1].length===0,()=>`Invalid protocol format (post :) [${s}]`),r.shift()}}async fetch(){return await o.fetch(this)}toString(){return this.href}parsePath(t,i){let s=t.split("/");(0,h.assertEx)(!(i&&s[0].length===0),()=>"Invalid protocol separator"),s[0].length===0&&s.shift();let r=(0,h.assertEx)(s.pop(),()=>"No hash specified");return this.archivist=s.shift()??"api.archivist.xyo.network",this.archive=s.pop(),(0,h.assertEx)(s.length===0,()=>"Too many path parts"),r}validateParse(){(0,h.assertEx)(this.archivist?.length!==0,()=>"Invalid archivist length"),(0,h.assertEx)(this.archive?.length!==0,()=>"Invalid archive length"),(0,h.assertEx)(!(this.archive&&!this.archivist),()=>"If specifying archive, archivist is also required")}};
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  Huri: () => Huri
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/Huri.ts
+var import_assert = require("@xylabs/assert");
+var import_axios = require("@xylabs/axios");
+var import_hex = require("@xylabs/hex");
+var import_account = require("@xyo-network/account");
+var Huri = class _Huri {
+  static {
+    __name(this, "Huri");
+  }
+  archive;
+  archivist;
+  hash;
+  originalHref;
+  protocol;
+  token;
+  isHuri = true;
+  constructor(huri, { archivistUri, token } = {}) {
+    const huriString = _Huri.isHuri(huri)?.href ?? (typeof huri === "string" ? huri : huri instanceof ArrayBuffer ? new import_account.AddressValue(huri).hex : huri.href);
+    this.originalHref = huriString;
+    const protocol = _Huri.parseProtocol(huriString);
+    this.protocol = protocol ?? "https";
+    const path = (0, import_assert.assertEx)(_Huri.parsePath(huriString), () => "Missing path");
+    this.hash = (0, import_assert.assertEx)(this.parsePath(path, protocol !== void 0), () => "Missing hash");
+    (0, import_assert.assertEx)((0, import_hex.isHash)(this.hash), () => `Invalid hash [${this.hash}]`);
+    if (archivistUri) {
+      const archivistUriParts = archivistUri.split("://");
+      this.protocol = archivistUriParts[0];
+      this.archivist = archivistUriParts[1];
+    }
+    this.token = token;
+    this.validateParse();
+  }
+  /*
+  The full href or the hash
+  */
+  get href() {
+    const parts = [];
+    if (this.protocol) {
+      parts.push(`${this.protocol}:/`);
+    }
+    if (this.archive) {
+      parts.push(`${this.archive}`);
+    }
+    if (this.archivist) {
+      parts.push(`${this.archivist}`);
+    }
+    parts.push(this.hash);
+    return parts.join("/");
+  }
+  static async fetch(huri) {
+    const AuthHeader = huri.token ? {
+      Authorization: `Bearer ${huri.token}`
+    } : void 0;
+    return (await import_axios.axios.get(huri.href, {
+      headers: AuthHeader
+    })).data;
+  }
+  static isHuri(value) {
+    if (typeof value === "object") {
+      return value.isHuri ? value : void 0;
+    }
+  }
+  static parsePath(huri) {
+    const protocolSplit = huri.split("//");
+    (0, import_assert.assertEx)(protocolSplit.length <= 2, () => `Invalid format [${huri}]`);
+    if (protocolSplit.length === 1) {
+      return huri;
+    }
+    if (protocolSplit.length === 2) {
+      return protocolSplit[1];
+    }
+  }
+  static parseProtocol(huri) {
+    const protocolSplit = huri.split("//");
+    (0, import_assert.assertEx)(protocolSplit.length <= 2, () => `Invalid second protocol [${protocolSplit[2]}]`);
+    const rawProtocol = protocolSplit.length === 2 ? protocolSplit.shift() : void 0;
+    if (rawProtocol) {
+      const protocolParts = rawProtocol?.split(":");
+      (0, import_assert.assertEx)(protocolParts.length === 2, () => `Invalid protocol format [${rawProtocol}]`);
+      (0, import_assert.assertEx)(protocolParts[1].length === 0, () => `Invalid protocol format (post :) [${rawProtocol}]`);
+      return protocolParts.shift();
+    }
+  }
+  async fetch() {
+    return await _Huri.fetch(this);
+  }
+  toString() {
+    return this.href;
+  }
+  parsePath(path, hasProtocol) {
+    const pathParts = path.split("/");
+    (0, import_assert.assertEx)(!(hasProtocol && pathParts[0].length === 0), () => "Invalid protocol separator");
+    pathParts[0].length === 0 ? pathParts.shift() : null;
+    const hash = (0, import_assert.assertEx)(pathParts.pop(), () => "No hash specified");
+    this.archivist = pathParts.shift() ?? "api.archivist.xyo.network";
+    this.archive = pathParts.pop();
+    (0, import_assert.assertEx)(pathParts.length === 0, () => "Too many path parts");
+    return hash;
+  }
+  validateParse() {
+    (0, import_assert.assertEx)(this.archivist?.length !== 0, () => "Invalid archivist length");
+    (0, import_assert.assertEx)(this.archive?.length !== 0, () => "Invalid archive length");
+    (0, import_assert.assertEx)(!(this.archive && !this.archivist), () => "If specifying archive, archivist is also required");
+  }
+};
 //# sourceMappingURL=index.cjs.map

package/dist/neutral/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/Huri.ts"],"sourcesContent":["export * from './Huri'\n","import { assertEx } from '@xylabs/assert'\nimport { axios } from '@xylabs/axios'\nimport { Address, Hash, isHash } from '@xylabs/hex'\nimport { AddressValue } from '@xyo-network/account'\nimport { Payload } from '@xyo-network/payload-model'\n\nexport type ObjectCategory = 'block' | 'payload'\n\nexport type HuriFetchFunction = (huri: Huri) => Promise<Payload | undefined>\n\n/* \n  Valid Huri:\n\n  [<protocol>://][<archivist>/[<archive>/]]<hash>\n\n  defaults:\n    protocol: https\n    archivist: api.archivist.xyo.network\n*/\n\nexport interface HuriOptions {\n  archivistUri?: string\n  token?: string\n}\n\nexport interface FetchedPayload<T extends Payload = Payload> {\n  huri?: Huri\n  payload: T\n}\n\nexport class Huri<T extends Payload = Payload> {\n  archive?: string\n  archivist?: Address | string\n  hash: Hash\n  originalHref: string\n  protocol?: string\n  token?: string\n\n  private isHuri = true\n\n  constructor(huri: Hash | Huri | string, { archivistUri, token }: HuriOptions = {}) {\n    const huriString =\n      Huri.isHuri(huri)?.href ??\n      (typeof huri === 'string' ? (huri as string)\n      : huri instanceof ArrayBuffer ? new AddressValue(huri).hex\n      : huri.href)\n    this.originalHref = huriString\n\n    const protocol = Huri.parseProtocol(huriString)\n    this.protocol = protocol ?? 'https'\n\n    const path = assertEx(Huri.parsePath(huriString), () => 'Missing path')\n    this.hash = assertEx(this.parsePath(path, protocol !== undefined), () => 'Missing hash') as Hash\n\n    assertEx(isHash(this.hash), () => `Invalid hash [${this.hash}]`)\n\n    //if archivistUri sent, overwrite protocol and archivist\n    if (archivistUri) {\n      const archivistUriParts = archivistUri.split('://')\n      this.protocol = archivistUriParts[0]\n      this.archivist = archivistUriParts[1]\n    }\n\n    this.token = token\n\n    this.validateParse()\n  }\n\n  /*\n  The full href or the hash\n  */\n  get href() {\n    const parts: string[] = []\n    if (this.protocol) {\n      parts.push(`${this.protocol}:/`)\n    }\n    if (this.archive) {\n      parts.push(`${this.archive}`)\n    }\n    if (this.archivist) {\n      parts.push(`${this.archivist}`)\n    }\n    parts.push(this.hash)\n    return parts.join('/')\n  }\n\n  static async fetch<T extends Payload = Payload>(huri: Huri): Promise<T | undefined> {\n    const AuthHeader = huri.token ? { Authorization: `Bearer ${huri.token}` } : undefined\n    return (await axios.get<T>(huri.href, { headers: AuthHeader })).data\n  }\n\n  static isHuri(value: unknown) {\n    if (typeof value === 'object') {\n      return (value as Huri).isHuri ? (value as Huri) : undefined\n    }\n  }\n\n  private static parsePath(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid format [${huri}]`)\n    if (protocolSplit.length === 1) {\n      return huri\n    }\n    if (protocolSplit.length === 2) {\n      return protocolSplit[1]\n    }\n  }\n\n  private static parseProtocol(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid second protocol [${protocolSplit[2]}]`)\n    const rawProtocol = protocolSplit.length === 2 ? protocolSplit.shift() : undefined\n    if (rawProtocol) {\n      const protocolParts = rawProtocol?.split(':')\n      assertEx(protocolParts.length === 2, () => `Invalid protocol format [${rawProtocol}]`)\n      assertEx(protocolParts[1].length === 0, () => `Invalid protocol format (post :) [${rawProtocol}]`)\n      return protocolParts.shift()\n    }\n  }\n\n  async fetch(): Promise<T | undefined> {\n    return await Huri.fetch<T>(this)\n  }\n\n  toString() {\n    return this.href\n  }\n\n  private parsePath(path: string, hasProtocol: boolean) {\n    const pathParts = path.split('/')\n\n    //if the protocol was found, then there is not allowed to be a leading /\n    assertEx(!(hasProtocol && pathParts[0].length === 0), () => 'Invalid protocol separator')\n\n    //remove leading '/' if needed\n    pathParts[0].length === 0 ? pathParts.shift() : null\n\n    //hash is assumed to be the last part\n    const hash = assertEx(pathParts.pop(), () => 'No hash specified')\n\n    //archivist is assumed to be the first part\n    this.archivist = pathParts.shift() ?? 'api.archivist.xyo.network'\n\n    //the archive is whatever is left\n    this.archive = pathParts.pop()\n\n    //after we pull off all the path parts, there should be nothing left\n    assertEx(pathParts.length === 0, () => 'Too many path parts')\n\n    return hash\n  }\n\n  private validateParse() {\n    //the archivist should not be zero length\n    assertEx(this.archivist?.length !== 0, () => 'Invalid archivist length')\n\n    //the archivist should not be zero length (can be undefined)\n    assertEx(this.archive?.length !== 0, () => 'Invalid archive length')\n\n    //the archive should not be set if the archivist is not set\n    assertEx(!(this.archive && !this.archivist), () => 'If specifying archive, archivist is also required')\n  }\n}\n"],"mappings":"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","names":["src_exports","__export","Huri","__toCommonJS","import_assert","import_axios","import_hex","import_account","Huri","archive","archivist","hash","originalHref","protocol","token","isHuri","constructor","huri","archivistUri","huriString","href","ArrayBuffer","AddressValue","hex","parseProtocol","path","assertEx","parsePath","undefined","isHash","archivistUriParts","split","validateParse","parts","push","join","fetch","AuthHeader","Authorization","axios","get","headers","data","value","protocolSplit","length","rawProtocol","shift","protocolParts","toString","hasProtocol","pathParts","pop"]}
+{"version":3,"sources":["../../src/index.ts","../../src/Huri.ts"],"sourcesContent":["export * from './Huri'\n","import { assertEx } from '@xylabs/assert'\nimport { axios } from '@xylabs/axios'\nimport { Address, Hash, isHash } from '@xylabs/hex'\nimport { AddressValue } from '@xyo-network/account'\nimport { Payload } from '@xyo-network/payload-model'\n\nexport type ObjectCategory = 'block' | 'payload'\n\nexport type HuriFetchFunction = (huri: Huri) => Promise<Payload | undefined>\n\n/* \n  Valid Huri:\n\n  [<protocol>://][<archivist>/[<archive>/]]<hash>\n\n  defaults:\n    protocol: https\n    archivist: api.archivist.xyo.network\n*/\n\nexport interface HuriOptions {\n  archivistUri?: string\n  token?: string\n}\n\nexport interface FetchedPayload<T extends Payload = Payload> {\n  huri?: Huri\n  payload: T\n}\n\nexport class Huri<T extends Payload = Payload> {\n  archive?: string\n  archivist?: Address | string\n  hash: Hash\n  originalHref: string\n  protocol?: string\n  token?: string\n\n  private isHuri = true\n\n  constructor(huri: Hash | Huri | string, { archivistUri, token }: HuriOptions = {}) {\n    const huriString =\n      Huri.isHuri(huri)?.href ??\n      (typeof huri === 'string' ? (huri as string)\n      : huri instanceof ArrayBuffer ? new AddressValue(huri).hex\n      : huri.href)\n    this.originalHref = huriString\n\n    const protocol = Huri.parseProtocol(huriString)\n    this.protocol = protocol ?? 'https'\n\n    const path = assertEx(Huri.parsePath(huriString), () => 'Missing path')\n    this.hash = assertEx(this.parsePath(path, protocol !== undefined), () => 'Missing hash') as Hash\n\n    assertEx(isHash(this.hash), () => `Invalid hash [${this.hash}]`)\n\n    //if archivistUri sent, overwrite protocol and archivist\n    if (archivistUri) {\n      const archivistUriParts = archivistUri.split('://')\n      this.protocol = archivistUriParts[0]\n      this.archivist = archivistUriParts[1]\n    }\n\n    this.token = token\n\n    this.validateParse()\n  }\n\n  /*\n  The full href or the hash\n  */\n  get href() {\n    const parts: string[] = []\n    if (this.protocol) {\n      parts.push(`${this.protocol}:/`)\n    }\n    if (this.archive) {\n      parts.push(`${this.archive}`)\n    }\n    if (this.archivist) {\n      parts.push(`${this.archivist}`)\n    }\n    parts.push(this.hash)\n    return parts.join('/')\n  }\n\n  static async fetch<T extends Payload = Payload>(huri: Huri): Promise<T | undefined> {\n    const AuthHeader = huri.token ? { Authorization: `Bearer ${huri.token}` } : undefined\n    return (await axios.get<T>(huri.href, { headers: AuthHeader })).data\n  }\n\n  static isHuri(value: unknown) {\n    if (typeof value === 'object') {\n      return (value as Huri).isHuri ? (value as Huri) : undefined\n    }\n  }\n\n  private static parsePath(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid format [${huri}]`)\n    if (protocolSplit.length === 1) {\n      return huri\n    }\n    if (protocolSplit.length === 2) {\n      return protocolSplit[1]\n    }\n  }\n\n  private static parseProtocol(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid second protocol [${protocolSplit[2]}]`)\n    const rawProtocol = protocolSplit.length === 2 ? protocolSplit.shift() : undefined\n    if (rawProtocol) {\n      const protocolParts = rawProtocol?.split(':')\n      assertEx(protocolParts.length === 2, () => `Invalid protocol format [${rawProtocol}]`)\n      assertEx(protocolParts[1].length === 0, () => `Invalid protocol format (post :) [${rawProtocol}]`)\n      return protocolParts.shift()\n    }\n  }\n\n  async fetch(): Promise<T | undefined> {\n    return await Huri.fetch<T>(this)\n  }\n\n  toString() {\n    return this.href\n  }\n\n  private parsePath(path: string, hasProtocol: boolean) {\n    const pathParts = path.split('/')\n\n    //if the protocol was found, then there is not allowed to be a leading /\n    assertEx(!(hasProtocol && pathParts[0].length === 0), () => 'Invalid protocol separator')\n\n    //remove leading '/' if needed\n    pathParts[0].length === 0 ? pathParts.shift() : null\n\n    //hash is assumed to be the last part\n    const hash = assertEx(pathParts.pop(), () => 'No hash specified')\n\n    //archivist is assumed to be the first part\n    this.archivist = pathParts.shift() ?? 'api.archivist.xyo.network'\n\n    //the archive is whatever is left\n    this.archive = pathParts.pop()\n\n    //after we pull off all the path parts, there should be nothing left\n    assertEx(pathParts.length === 0, () => 'Too many path parts')\n\n    return hash\n  }\n\n  private validateParse() {\n    //the archivist should not be zero length\n    assertEx(this.archivist?.length !== 0, () => 'Invalid archivist length')\n\n    //the archivist should not be zero length (can be undefined)\n    assertEx(this.archive?.length !== 0, () => 'Invalid archive length')\n\n    //the archive should not be set if the archivist is not set\n    assertEx(!(this.archive && !this.archivist), () => 'If specifying archive, archivist is also required')\n  }\n}\n"],"mappings":"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","names":["Huri","archive","archivist","hash","originalHref","protocol","token","isHuri","constructor","huri","archivistUri","huriString","href","ArrayBuffer","AddressValue","hex","parseProtocol","path","assertEx","parsePath","undefined","isHash","archivistUriParts","split","validateParse","parts","push","join","fetch","AuthHeader","Authorization","axios","get","headers","data","value","protocolSplit","length","rawProtocol","shift","protocolParts","toString","hasProtocol","pathParts","pop"]}

package/dist/neutral/index.js

@@ -1,2 +1,112 @@
-var l=Object.defineProperty;var n=(h,t)=>l(h,"name",{value:t,configurable:!0});import{assertEx as r}from"@xylabs/assert";import{axios as f}from"@xylabs/axios";import{isHash as d}from"@xylabs/hex";import{AddressValue as v}from"@xyo-network/account";var c=class h{static{n(this,"Huri")}archive;archivist;hash;originalHref;protocol;token;isHuri=!0;constructor(t,{archivistUri:i,token:s}={}){let o=h.isHuri(t)?.href??(typeof t=="string"?t:t instanceof ArrayBuffer?new v(t).hex:t.href);this.originalHref=o;let a=h.parseProtocol(o);this.protocol=a??"https";let p=r(h.parsePath(o),()=>"Missing path");if(this.hash=r(this.parsePath(p,a!==void 0),()=>"Missing hash"),r(d(this.hash),()=>`Invalid hash [${this.hash}]`),i){let e=i.split("://");this.protocol=e[0],this.archivist=e[1]}this.token=s,this.validateParse()}get href(){let t=[];return this.protocol&&t.push(`${this.protocol}:/`),this.archive&&t.push(`${this.archive}`),this.archivist&&t.push(`${this.archivist}`),t.push(this.hash),t.join("/")}static async fetch(t){let i=t.token?{Authorization:`Bearer ${t.token}`}:void 0;return(await f.get(t.href,{headers:i})).data}static isHuri(t){if(typeof t=="object")return t.isHuri?t:void 0}static parsePath(t){let i=t.split("//");if(r(i.length<=2,()=>`Invalid format [${t}]`),i.length===1)return t;if(i.length===2)return i[1]}static parseProtocol(t){let i=t.split("//");r(i.length<=2,()=>`Invalid second protocol [${i[2]}]`);let s=i.length===2?i.shift():void 0;if(s){let o=s?.split(":");return r(o.length===2,()=>`Invalid protocol format [${s}]`),r(o[1].length===0,()=>`Invalid protocol format (post :) [${s}]`),o.shift()}}async fetch(){return await h.fetch(this)}toString(){return this.href}parsePath(t,i){let s=t.split("/");r(!(i&&s[0].length===0),()=>"Invalid protocol separator"),s[0].length===0&&s.shift();let o=r(s.pop(),()=>"No hash specified");return this.archivist=s.shift()??"api.archivist.xyo.network",this.archive=s.pop(),r(s.length===0,()=>"Too many path parts"),o}validateParse(){r(this.archivist?.length!==0,()=>"Invalid archivist length"),r(this.archive?.length!==0,()=>"Invalid archive length"),r(!(this.archive&&!this.archivist),()=>"If specifying archive, archivist is also required")}};export{c as Huri};
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/Huri.ts
+import { assertEx } from "@xylabs/assert";
+import { axios } from "@xylabs/axios";
+import { isHash } from "@xylabs/hex";
+import { AddressValue } from "@xyo-network/account";
+var Huri = class _Huri {
+  static {
+    __name(this, "Huri");
+  }
+  archive;
+  archivist;
+  hash;
+  originalHref;
+  protocol;
+  token;
+  isHuri = true;
+  constructor(huri, { archivistUri, token } = {}) {
+    const huriString = _Huri.isHuri(huri)?.href ?? (typeof huri === "string" ? huri : huri instanceof ArrayBuffer ? new AddressValue(huri).hex : huri.href);
+    this.originalHref = huriString;
+    const protocol = _Huri.parseProtocol(huriString);
+    this.protocol = protocol ?? "https";
+    const path = assertEx(_Huri.parsePath(huriString), () => "Missing path");
+    this.hash = assertEx(this.parsePath(path, protocol !== void 0), () => "Missing hash");
+    assertEx(isHash(this.hash), () => `Invalid hash [${this.hash}]`);
+    if (archivistUri) {
+      const archivistUriParts = archivistUri.split("://");
+      this.protocol = archivistUriParts[0];
+      this.archivist = archivistUriParts[1];
+    }
+    this.token = token;
+    this.validateParse();
+  }
+  /*
+  The full href or the hash
+  */
+  get href() {
+    const parts = [];
+    if (this.protocol) {
+      parts.push(`${this.protocol}:/`);
+    }
+    if (this.archive) {
+      parts.push(`${this.archive}`);
+    }
+    if (this.archivist) {
+      parts.push(`${this.archivist}`);
+    }
+    parts.push(this.hash);
+    return parts.join("/");
+  }
+  static async fetch(huri) {
+    const AuthHeader = huri.token ? {
+      Authorization: `Bearer ${huri.token}`
+    } : void 0;
+    return (await axios.get(huri.href, {
+      headers: AuthHeader
+    })).data;
+  }
+  static isHuri(value) {
+    if (typeof value === "object") {
+      return value.isHuri ? value : void 0;
+    }
+  }
+  static parsePath(huri) {
+    const protocolSplit = huri.split("//");
+    assertEx(protocolSplit.length <= 2, () => `Invalid format [${huri}]`);
+    if (protocolSplit.length === 1) {
+      return huri;
+    }
+    if (protocolSplit.length === 2) {
+      return protocolSplit[1];
+    }
+  }
+  static parseProtocol(huri) {
+    const protocolSplit = huri.split("//");
+    assertEx(protocolSplit.length <= 2, () => `Invalid second protocol [${protocolSplit[2]}]`);
+    const rawProtocol = protocolSplit.length === 2 ? protocolSplit.shift() : void 0;
+    if (rawProtocol) {
+      const protocolParts = rawProtocol?.split(":");
+      assertEx(protocolParts.length === 2, () => `Invalid protocol format [${rawProtocol}]`);
+      assertEx(protocolParts[1].length === 0, () => `Invalid protocol format (post :) [${rawProtocol}]`);
+      return protocolParts.shift();
+    }
+  }
+  async fetch() {
+    return await _Huri.fetch(this);
+  }
+  toString() {
+    return this.href;
+  }
+  parsePath(path, hasProtocol) {
+    const pathParts = path.split("/");
+    assertEx(!(hasProtocol && pathParts[0].length === 0), () => "Invalid protocol separator");
+    pathParts[0].length === 0 ? pathParts.shift() : null;
+    const hash = assertEx(pathParts.pop(), () => "No hash specified");
+    this.archivist = pathParts.shift() ?? "api.archivist.xyo.network";
+    this.archive = pathParts.pop();
+    assertEx(pathParts.length === 0, () => "Too many path parts");
+    return hash;
+  }
+  validateParse() {
+    assertEx(this.archivist?.length !== 0, () => "Invalid archivist length");
+    assertEx(this.archive?.length !== 0, () => "Invalid archive length");
+    assertEx(!(this.archive && !this.archivist), () => "If specifying archive, archivist is also required");
+  }
+};
+export {
+  Huri
+};
 //# sourceMappingURL=index.js.map

package/dist/neutral/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/Huri.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { axios } from '@xylabs/axios'\nimport { Address, Hash, isHash } from '@xylabs/hex'\nimport { AddressValue } from '@xyo-network/account'\nimport { Payload } from '@xyo-network/payload-model'\n\nexport type ObjectCategory = 'block' | 'payload'\n\nexport type HuriFetchFunction = (huri: Huri) => Promise<Payload | undefined>\n\n/* \n  Valid Huri:\n\n  [<protocol>://][<archivist>/[<archive>/]]<hash>\n\n  defaults:\n    protocol: https\n    archivist: api.archivist.xyo.network\n*/\n\nexport interface HuriOptions {\n  archivistUri?: string\n  token?: string\n}\n\nexport interface FetchedPayload<T extends Payload = Payload> {\n  huri?: Huri\n  payload: T\n}\n\nexport class Huri<T extends Payload = Payload> {\n  archive?: string\n  archivist?: Address | string\n  hash: Hash\n  originalHref: string\n  protocol?: string\n  token?: string\n\n  private isHuri = true\n\n  constructor(huri: Hash | Huri | string, { archivistUri, token }: HuriOptions = {}) {\n    const huriString =\n      Huri.isHuri(huri)?.href ??\n      (typeof huri === 'string' ? (huri as string)\n      : huri instanceof ArrayBuffer ? new AddressValue(huri).hex\n      : huri.href)\n    this.originalHref = huriString\n\n    const protocol = Huri.parseProtocol(huriString)\n    this.protocol = protocol ?? 'https'\n\n    const path = assertEx(Huri.parsePath(huriString), () => 'Missing path')\n    this.hash = assertEx(this.parsePath(path, protocol !== undefined), () => 'Missing hash') as Hash\n\n    assertEx(isHash(this.hash), () => `Invalid hash [${this.hash}]`)\n\n    //if archivistUri sent, overwrite protocol and archivist\n    if (archivistUri) {\n      const archivistUriParts = archivistUri.split('://')\n      this.protocol = archivistUriParts[0]\n      this.archivist = archivistUriParts[1]\n    }\n\n    this.token = token\n\n    this.validateParse()\n  }\n\n  /*\n  The full href or the hash\n  */\n  get href() {\n    const parts: string[] = []\n    if (this.protocol) {\n      parts.push(`${this.protocol}:/`)\n    }\n    if (this.archive) {\n      parts.push(`${this.archive}`)\n    }\n    if (this.archivist) {\n      parts.push(`${this.archivist}`)\n    }\n    parts.push(this.hash)\n    return parts.join('/')\n  }\n\n  static async fetch<T extends Payload = Payload>(huri: Huri): Promise<T | undefined> {\n    const AuthHeader = huri.token ? { Authorization: `Bearer ${huri.token}` } : undefined\n    return (await axios.get<T>(huri.href, { headers: AuthHeader })).data\n  }\n\n  static isHuri(value: unknown) {\n    if (typeof value === 'object') {\n      return (value as Huri).isHuri ? (value as Huri) : undefined\n    }\n  }\n\n  private static parsePath(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid format [${huri}]`)\n    if (protocolSplit.length === 1) {\n      return huri\n    }\n    if (protocolSplit.length === 2) {\n      return protocolSplit[1]\n    }\n  }\n\n  private static parseProtocol(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid second protocol [${protocolSplit[2]}]`)\n    const rawProtocol = protocolSplit.length === 2 ? protocolSplit.shift() : undefined\n    if (rawProtocol) {\n      const protocolParts = rawProtocol?.split(':')\n      assertEx(protocolParts.length === 2, () => `Invalid protocol format [${rawProtocol}]`)\n      assertEx(protocolParts[1].length === 0, () => `Invalid protocol format (post :) [${rawProtocol}]`)\n      return protocolParts.shift()\n    }\n  }\n\n  async fetch(): Promise<T | undefined> {\n    return await Huri.fetch<T>(this)\n  }\n\n  toString() {\n    return this.href\n  }\n\n  private parsePath(path: string, hasProtocol: boolean) {\n    const pathParts = path.split('/')\n\n    //if the protocol was found, then there is not allowed to be a leading /\n    assertEx(!(hasProtocol && pathParts[0].length === 0), () => 'Invalid protocol separator')\n\n    //remove leading '/' if needed\n    pathParts[0].length === 0 ? pathParts.shift() : null\n\n    //hash is assumed to be the last part\n    const hash = assertEx(pathParts.pop(), () => 'No hash specified')\n\n    //archivist is assumed to be the first part\n    this.archivist = pathParts.shift() ?? 'api.archivist.xyo.network'\n\n    //the archive is whatever is left\n    this.archive = pathParts.pop()\n\n    //after we pull off all the path parts, there should be nothing left\n    assertEx(pathParts.length === 0, () => 'Too many path parts')\n\n    return hash\n  }\n\n  private validateParse() {\n    //the archivist should not be zero length\n    assertEx(this.archivist?.length !== 0, () => 'Invalid archivist length')\n\n    //the archivist should not be zero length (can be undefined)\n    assertEx(this.archive?.length !== 0, () => 'Invalid archive length')\n\n    //the archive should not be set if the archivist is not set\n    assertEx(!(this.archive && !this.archivist), () => 'If specifying archive, archivist is also required')\n  }\n}\n"],"mappings":"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","names":["assertEx","axios","isHash","AddressValue","Huri","archive","archivist","hash","originalHref","protocol","token","isHuri","constructor","huri","archivistUri","huriString","href","ArrayBuffer","AddressValue","hex","parseProtocol","path","assertEx","parsePath","undefined","isHash","archivistUriParts","split","validateParse","parts","push","join","fetch","AuthHeader","Authorization","axios","get","headers","data","value","protocolSplit","length","rawProtocol","shift","protocolParts","toString","hasProtocol","pathParts","pop"]}
+{"version":3,"sources":["../../src/Huri.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { axios } from '@xylabs/axios'\nimport { Address, Hash, isHash } from '@xylabs/hex'\nimport { AddressValue } from '@xyo-network/account'\nimport { Payload } from '@xyo-network/payload-model'\n\nexport type ObjectCategory = 'block' | 'payload'\n\nexport type HuriFetchFunction = (huri: Huri) => Promise<Payload | undefined>\n\n/* \n  Valid Huri:\n\n  [<protocol>://][<archivist>/[<archive>/]]<hash>\n\n  defaults:\n    protocol: https\n    archivist: api.archivist.xyo.network\n*/\n\nexport interface HuriOptions {\n  archivistUri?: string\n  token?: string\n}\n\nexport interface FetchedPayload<T extends Payload = Payload> {\n  huri?: Huri\n  payload: T\n}\n\nexport class Huri<T extends Payload = Payload> {\n  archive?: string\n  archivist?: Address | string\n  hash: Hash\n  originalHref: string\n  protocol?: string\n  token?: string\n\n  private isHuri = true\n\n  constructor(huri: Hash | Huri | string, { archivistUri, token }: HuriOptions = {}) {\n    const huriString =\n      Huri.isHuri(huri)?.href ??\n      (typeof huri === 'string' ? (huri as string)\n      : huri instanceof ArrayBuffer ? new AddressValue(huri).hex\n      : huri.href)\n    this.originalHref = huriString\n\n    const protocol = Huri.parseProtocol(huriString)\n    this.protocol = protocol ?? 'https'\n\n    const path = assertEx(Huri.parsePath(huriString), () => 'Missing path')\n    this.hash = assertEx(this.parsePath(path, protocol !== undefined), () => 'Missing hash') as Hash\n\n    assertEx(isHash(this.hash), () => `Invalid hash [${this.hash}]`)\n\n    //if archivistUri sent, overwrite protocol and archivist\n    if (archivistUri) {\n      const archivistUriParts = archivistUri.split('://')\n      this.protocol = archivistUriParts[0]\n      this.archivist = archivistUriParts[1]\n    }\n\n    this.token = token\n\n    this.validateParse()\n  }\n\n  /*\n  The full href or the hash\n  */\n  get href() {\n    const parts: string[] = []\n    if (this.protocol) {\n      parts.push(`${this.protocol}:/`)\n    }\n    if (this.archive) {\n      parts.push(`${this.archive}`)\n    }\n    if (this.archivist) {\n      parts.push(`${this.archivist}`)\n    }\n    parts.push(this.hash)\n    return parts.join('/')\n  }\n\n  static async fetch<T extends Payload = Payload>(huri: Huri): Promise<T | undefined> {\n    const AuthHeader = huri.token ? { Authorization: `Bearer ${huri.token}` } : undefined\n    return (await axios.get<T>(huri.href, { headers: AuthHeader })).data\n  }\n\n  static isHuri(value: unknown) {\n    if (typeof value === 'object') {\n      return (value as Huri).isHuri ? (value as Huri) : undefined\n    }\n  }\n\n  private static parsePath(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid format [${huri}]`)\n    if (protocolSplit.length === 1) {\n      return huri\n    }\n    if (protocolSplit.length === 2) {\n      return protocolSplit[1]\n    }\n  }\n\n  private static parseProtocol(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid second protocol [${protocolSplit[2]}]`)\n    const rawProtocol = protocolSplit.length === 2 ? protocolSplit.shift() : undefined\n    if (rawProtocol) {\n      const protocolParts = rawProtocol?.split(':')\n      assertEx(protocolParts.length === 2, () => `Invalid protocol format [${rawProtocol}]`)\n      assertEx(protocolParts[1].length === 0, () => `Invalid protocol format (post :) [${rawProtocol}]`)\n      return protocolParts.shift()\n    }\n  }\n\n  async fetch(): Promise<T | undefined> {\n    return await Huri.fetch<T>(this)\n  }\n\n  toString() {\n    return this.href\n  }\n\n  private parsePath(path: string, hasProtocol: boolean) {\n    const pathParts = path.split('/')\n\n    //if the protocol was found, then there is not allowed to be a leading /\n    assertEx(!(hasProtocol && pathParts[0].length === 0), () => 'Invalid protocol separator')\n\n    //remove leading '/' if needed\n    pathParts[0].length === 0 ? pathParts.shift() : null\n\n    //hash is assumed to be the last part\n    const hash = assertEx(pathParts.pop(), () => 'No hash specified')\n\n    //archivist is assumed to be the first part\n    this.archivist = pathParts.shift() ?? 'api.archivist.xyo.network'\n\n    //the archive is whatever is left\n    this.archive = pathParts.pop()\n\n    //after we pull off all the path parts, there should be nothing left\n    assertEx(pathParts.length === 0, () => 'Too many path parts')\n\n    return hash\n  }\n\n  private validateParse() {\n    //the archivist should not be zero length\n    assertEx(this.archivist?.length !== 0, () => 'Invalid archivist length')\n\n    //the archivist should not be zero length (can be undefined)\n    assertEx(this.archive?.length !== 0, () => 'Invalid archive length')\n\n    //the archive should not be set if the archivist is not set\n    assertEx(!(this.archive && !this.archivist), () => 'If specifying archive, archivist is also required')\n  }\n}\n"],"mappings":"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","names":["assertEx","axios","isHash","AddressValue","Huri","archive","archivist","hash","originalHref","protocol","token","isHuri","constructor","huri","archivistUri","huriString","href","ArrayBuffer","AddressValue","hex","parseProtocol","path","assertEx","parsePath","undefined","isHash","archivistUriParts","split","validateParse","parts","push","join","fetch","AuthHeader","Authorization","axios","get","headers","data","value","protocolSplit","length","rawProtocol","shift","protocolParts","toString","hasProtocol","pathParts","pop"]}

package/dist/node/index.cjs

@@ -1,2 +1,138 @@
-"use strict";var e=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var P=Object.getOwnPropertyNames;var I=Object.prototype.hasOwnProperty;var f=(o,t)=>e(o,"name",{value:t,configurable:!0});var $=(o,t)=>{for(var i in t)e(o,i,{get:t[i],enumerable:!0})},y=(o,t,i,s)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of P(t))!I.call(o,r)&&r!==i&&e(o,r,{get:()=>t[r],enumerable:!(s=m(t,r))||s.enumerable});return o};var x=o=>y(e({},"__esModule",{value:!0}),o);var H={};$(H,{Huri:()=>n});module.exports=x(H);var h=require("@xylabs/assert"),d=require("@xylabs/axios"),v=require("@xylabs/hex"),g=require("@xyo-network/account");var a=class a{archive;archivist;hash;originalHref;protocol;token;isHuri=!0;constructor(t,{archivistUri:i,token:s}={}){var p;let r=((p=a.isHuri(t))==null?void 0:p.href)??(typeof t=="string"?t:t instanceof ArrayBuffer?new g.AddressValue(t).hex:t.href);this.originalHref=r;let c=a.parseProtocol(r);this.protocol=c??"https";let u=(0,h.assertEx)(a.parsePath(r),()=>"Missing path");if(this.hash=(0,h.assertEx)(this.parsePath(u,c!==void 0),()=>"Missing hash"),(0,h.assertEx)((0,v.isHash)(this.hash),()=>`Invalid hash [${this.hash}]`),i){let l=i.split("://");this.protocol=l[0],this.archivist=l[1]}this.token=s,this.validateParse()}get href(){let t=[];return this.protocol&&t.push(`${this.protocol}:/`),this.archive&&t.push(`${this.archive}`),this.archivist&&t.push(`${this.archivist}`),t.push(this.hash),t.join("/")}static async fetch(t){let i=t.token?{Authorization:`Bearer ${t.token}`}:void 0;return(await d.axios.get(t.href,{headers:i})).data}static isHuri(t){if(typeof t=="object")return t.isHuri?t:void 0}static parsePath(t){let i=t.split("//");if((0,h.assertEx)(i.length<=2,()=>`Invalid format [${t}]`),i.length===1)return t;if(i.length===2)return i[1]}static parseProtocol(t){let i=t.split("//");(0,h.assertEx)(i.length<=2,()=>`Invalid second protocol [${i[2]}]`);let s=i.length===2?i.shift():void 0;if(s){let r=s==null?void 0:s.split(":");return(0,h.assertEx)(r.length===2,()=>`Invalid protocol format [${s}]`),(0,h.assertEx)(r[1].length===0,()=>`Invalid protocol format (post :) [${s}]`),r.shift()}}async fetch(){return await a.fetch(this)}toString(){return this.href}parsePath(t,i){let s=t.split("/");(0,h.assertEx)(!(i&&s[0].length===0),()=>"Invalid protocol separator"),s[0].length===0&&s.shift();let r=(0,h.assertEx)(s.pop(),()=>"No hash specified");return this.archivist=s.shift()??"api.archivist.xyo.network",this.archive=s.pop(),(0,h.assertEx)(s.length===0,()=>"Too many path parts"),r}validateParse(){var t,i;(0,h.assertEx)(((t=this.archivist)==null?void 0:t.length)!==0,()=>"Invalid archivist length"),(0,h.assertEx)(((i=this.archive)==null?void 0:i.length)!==0,()=>"Invalid archive length"),(0,h.assertEx)(!(this.archive&&!this.archivist),()=>"If specifying archive, archivist is also required")}};f(a,"Huri");var n=a;0&&(module.exports={Huri});
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  Huri: () => Huri
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/Huri.ts
+var import_assert = require("@xylabs/assert");
+var import_axios = require("@xylabs/axios");
+var import_hex = require("@xylabs/hex");
+var import_account = require("@xyo-network/account");
+var _Huri = class _Huri {
+  archive;
+  archivist;
+  hash;
+  originalHref;
+  protocol;
+  token;
+  isHuri = true;
+  constructor(huri, { archivistUri, token } = {}) {
+    var _a;
+    const huriString = ((_a = _Huri.isHuri(huri)) == null ? void 0 : _a.href) ?? (typeof huri === "string" ? huri : huri instanceof ArrayBuffer ? new import_account.AddressValue(huri).hex : huri.href);
+    this.originalHref = huriString;
+    const protocol = _Huri.parseProtocol(huriString);
+    this.protocol = protocol ?? "https";
+    const path = (0, import_assert.assertEx)(_Huri.parsePath(huriString), () => "Missing path");
+    this.hash = (0, import_assert.assertEx)(this.parsePath(path, protocol !== void 0), () => "Missing hash");
+    (0, import_assert.assertEx)((0, import_hex.isHash)(this.hash), () => `Invalid hash [${this.hash}]`);
+    if (archivistUri) {
+      const archivistUriParts = archivistUri.split("://");
+      this.protocol = archivistUriParts[0];
+      this.archivist = archivistUriParts[1];
+    }
+    this.token = token;
+    this.validateParse();
+  }
+  /*
+  The full href or the hash
+  */
+  get href() {
+    const parts = [];
+    if (this.protocol) {
+      parts.push(`${this.protocol}:/`);
+    }
+    if (this.archive) {
+      parts.push(`${this.archive}`);
+    }
+    if (this.archivist) {
+      parts.push(`${this.archivist}`);
+    }
+    parts.push(this.hash);
+    return parts.join("/");
+  }
+  static async fetch(huri) {
+    const AuthHeader = huri.token ? {
+      Authorization: `Bearer ${huri.token}`
+    } : void 0;
+    return (await import_axios.axios.get(huri.href, {
+      headers: AuthHeader
+    })).data;
+  }
+  static isHuri(value) {
+    if (typeof value === "object") {
+      return value.isHuri ? value : void 0;
+    }
+  }
+  static parsePath(huri) {
+    const protocolSplit = huri.split("//");
+    (0, import_assert.assertEx)(protocolSplit.length <= 2, () => `Invalid format [${huri}]`);
+    if (protocolSplit.length === 1) {
+      return huri;
+    }
+    if (protocolSplit.length === 2) {
+      return protocolSplit[1];
+    }
+  }
+  static parseProtocol(huri) {
+    const protocolSplit = huri.split("//");
+    (0, import_assert.assertEx)(protocolSplit.length <= 2, () => `Invalid second protocol [${protocolSplit[2]}]`);
+    const rawProtocol = protocolSplit.length === 2 ? protocolSplit.shift() : void 0;
+    if (rawProtocol) {
+      const protocolParts = rawProtocol == null ? void 0 : rawProtocol.split(":");
+      (0, import_assert.assertEx)(protocolParts.length === 2, () => `Invalid protocol format [${rawProtocol}]`);
+      (0, import_assert.assertEx)(protocolParts[1].length === 0, () => `Invalid protocol format (post :) [${rawProtocol}]`);
+      return protocolParts.shift();
+    }
+  }
+  async fetch() {
+    return await _Huri.fetch(this);
+  }
+  toString() {
+    return this.href;
+  }
+  parsePath(path, hasProtocol) {
+    const pathParts = path.split("/");
+    (0, import_assert.assertEx)(!(hasProtocol && pathParts[0].length === 0), () => "Invalid protocol separator");
+    pathParts[0].length === 0 ? pathParts.shift() : null;
+    const hash = (0, import_assert.assertEx)(pathParts.pop(), () => "No hash specified");
+    this.archivist = pathParts.shift() ?? "api.archivist.xyo.network";
+    this.archive = pathParts.pop();
+    (0, import_assert.assertEx)(pathParts.length === 0, () => "Too many path parts");
+    return hash;
+  }
+  validateParse() {
+    var _a, _b;
+    (0, import_assert.assertEx)(((_a = this.archivist) == null ? void 0 : _a.length) !== 0, () => "Invalid archivist length");
+    (0, import_assert.assertEx)(((_b = this.archive) == null ? void 0 : _b.length) !== 0, () => "Invalid archive length");
+    (0, import_assert.assertEx)(!(this.archive && !this.archivist), () => "If specifying archive, archivist is also required");
+  }
+};
+__name(_Huri, "Huri");
+var Huri = _Huri;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Huri
+});
 //# sourceMappingURL=index.cjs.map

package/dist/node/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/Huri.ts"],"sourcesContent":["export * from './Huri'\n","import { assertEx } from '@xylabs/assert'\nimport { axios } from '@xylabs/axios'\nimport { Address, Hash, isHash } from '@xylabs/hex'\nimport { AddressValue } from '@xyo-network/account'\nimport { Payload } from '@xyo-network/payload-model'\n\nexport type ObjectCategory = 'block' | 'payload'\n\nexport type HuriFetchFunction = (huri: Huri) => Promise<Payload | undefined>\n\n/* \n  Valid Huri:\n\n  [<protocol>://][<archivist>/[<archive>/]]<hash>\n\n  defaults:\n    protocol: https\n    archivist: api.archivist.xyo.network\n*/\n\nexport interface HuriOptions {\n  archivistUri?: string\n  token?: string\n}\n\nexport interface FetchedPayload<T extends Payload = Payload> {\n  huri?: Huri\n  payload: T\n}\n\nexport class Huri<T extends Payload = Payload> {\n  archive?: string\n  archivist?: Address | string\n  hash: Hash\n  originalHref: string\n  protocol?: string\n  token?: string\n\n  private isHuri = true\n\n  constructor(huri: Hash | Huri | string, { archivistUri, token }: HuriOptions = {}) {\n    const huriString =\n      Huri.isHuri(huri)?.href ??\n      (typeof huri === 'string' ? (huri as string)\n      : huri instanceof ArrayBuffer ? new AddressValue(huri).hex\n      : huri.href)\n    this.originalHref = huriString\n\n    const protocol = Huri.parseProtocol(huriString)\n    this.protocol = protocol ?? 'https'\n\n    const path = assertEx(Huri.parsePath(huriString), () => 'Missing path')\n    this.hash = assertEx(this.parsePath(path, protocol !== undefined), () => 'Missing hash') as Hash\n\n    assertEx(isHash(this.hash), () => `Invalid hash [${this.hash}]`)\n\n    //if archivistUri sent, overwrite protocol and archivist\n    if (archivistUri) {\n      const archivistUriParts = archivistUri.split('://')\n      this.protocol = archivistUriParts[0]\n      this.archivist = archivistUriParts[1]\n    }\n\n    this.token = token\n\n    this.validateParse()\n  }\n\n  /*\n  The full href or the hash\n  */\n  get href() {\n    const parts: string[] = []\n    if (this.protocol) {\n      parts.push(`${this.protocol}:/`)\n    }\n    if (this.archive) {\n      parts.push(`${this.archive}`)\n    }\n    if (this.archivist) {\n      parts.push(`${this.archivist}`)\n    }\n    parts.push(this.hash)\n    return parts.join('/')\n  }\n\n  static async fetch<T extends Payload = Payload>(huri: Huri): Promise<T | undefined> {\n    const AuthHeader = huri.token ? { Authorization: `Bearer ${huri.token}` } : undefined\n    return (await axios.get<T>(huri.href, { headers: AuthHeader })).data\n  }\n\n  static isHuri(value: unknown) {\n    if (typeof value === 'object') {\n      return (value as Huri).isHuri ? (value as Huri) : undefined\n    }\n  }\n\n  private static parsePath(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid format [${huri}]`)\n    if (protocolSplit.length === 1) {\n      return huri\n    }\n    if (protocolSplit.length === 2) {\n      return protocolSplit[1]\n    }\n  }\n\n  private static parseProtocol(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid second protocol [${protocolSplit[2]}]`)\n    const rawProtocol = protocolSplit.length === 2 ? protocolSplit.shift() : undefined\n    if (rawProtocol) {\n      const protocolParts = rawProtocol?.split(':')\n      assertEx(protocolParts.length === 2, () => `Invalid protocol format [${rawProtocol}]`)\n      assertEx(protocolParts[1].length === 0, () => `Invalid protocol format (post :) [${rawProtocol}]`)\n      return protocolParts.shift()\n    }\n  }\n\n  async fetch(): Promise<T | undefined> {\n    return await Huri.fetch<T>(this)\n  }\n\n  toString() {\n    return this.href\n  }\n\n  private parsePath(path: string, hasProtocol: boolean) {\n    const pathParts = path.split('/')\n\n    //if the protocol was found, then there is not allowed to be a leading /\n    assertEx(!(hasProtocol && pathParts[0].length === 0), () => 'Invalid protocol separator')\n\n    //remove leading '/' if needed\n    pathParts[0].length === 0 ? pathParts.shift() : null\n\n    //hash is assumed to be the last part\n    const hash = assertEx(pathParts.pop(), () => 'No hash specified')\n\n    //archivist is assumed to be the first part\n    this.archivist = pathParts.shift() ?? 'api.archivist.xyo.network'\n\n    //the archive is whatever is left\n    this.archive = pathParts.pop()\n\n    //after we pull off all the path parts, there should be nothing left\n    assertEx(pathParts.length === 0, () => 'Too many path parts')\n\n    return hash\n  }\n\n  private validateParse() {\n    //the archivist should not be zero length\n    assertEx(this.archivist?.length !== 0, () => 'Invalid archivist length')\n\n    //the archivist should not be zero length (can be undefined)\n    assertEx(this.archive?.length !== 0, () => 'Invalid archive length')\n\n    //the archive should not be set if the archivist is not set\n    assertEx(!(this.archive && !this.archivist), () => 'If specifying archive, archivist is also required')\n  }\n}\n"],"mappings":"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","names":["src_exports","__export","Huri","__toCommonJS","import_assert","import_axios","import_hex","import_account","Huri","archive","archivist","hash","originalHref","protocol","token","isHuri","constructor","huri","archivistUri","_a","huriString","href","ArrayBuffer","AddressValue","hex","parseProtocol","path","assertEx","parsePath","undefined","isHash","archivistUriParts","split","validateParse","parts","push","join","fetch","AuthHeader","Authorization","axios","get","headers","data","value","protocolSplit","length","rawProtocol","shift","protocolParts","toString","hasProtocol","pathParts","pop","_b","_Huri"]}
+{"version":3,"sources":["../../src/index.ts","../../src/Huri.ts"],"sourcesContent":["export * from './Huri'\n","import { assertEx } from '@xylabs/assert'\nimport { axios } from '@xylabs/axios'\nimport { Address, Hash, isHash } from '@xylabs/hex'\nimport { AddressValue } from '@xyo-network/account'\nimport { Payload } from '@xyo-network/payload-model'\n\nexport type ObjectCategory = 'block' | 'payload'\n\nexport type HuriFetchFunction = (huri: Huri) => Promise<Payload | undefined>\n\n/* \n  Valid Huri:\n\n  [<protocol>://][<archivist>/[<archive>/]]<hash>\n\n  defaults:\n    protocol: https\n    archivist: api.archivist.xyo.network\n*/\n\nexport interface HuriOptions {\n  archivistUri?: string\n  token?: string\n}\n\nexport interface FetchedPayload<T extends Payload = Payload> {\n  huri?: Huri\n  payload: T\n}\n\nexport class Huri<T extends Payload = Payload> {\n  archive?: string\n  archivist?: Address | string\n  hash: Hash\n  originalHref: string\n  protocol?: string\n  token?: string\n\n  private isHuri = true\n\n  constructor(huri: Hash | Huri | string, { archivistUri, token }: HuriOptions = {}) {\n    const huriString =\n      Huri.isHuri(huri)?.href ??\n      (typeof huri === 'string' ? (huri as string)\n      : huri instanceof ArrayBuffer ? new AddressValue(huri).hex\n      : huri.href)\n    this.originalHref = huriString\n\n    const protocol = Huri.parseProtocol(huriString)\n    this.protocol = protocol ?? 'https'\n\n    const path = assertEx(Huri.parsePath(huriString), () => 'Missing path')\n    this.hash = assertEx(this.parsePath(path, protocol !== undefined), () => 'Missing hash') as Hash\n\n    assertEx(isHash(this.hash), () => `Invalid hash [${this.hash}]`)\n\n    //if archivistUri sent, overwrite protocol and archivist\n    if (archivistUri) {\n      const archivistUriParts = archivistUri.split('://')\n      this.protocol = archivistUriParts[0]\n      this.archivist = archivistUriParts[1]\n    }\n\n    this.token = token\n\n    this.validateParse()\n  }\n\n  /*\n  The full href or the hash\n  */\n  get href() {\n    const parts: string[] = []\n    if (this.protocol) {\n      parts.push(`${this.protocol}:/`)\n    }\n    if (this.archive) {\n      parts.push(`${this.archive}`)\n    }\n    if (this.archivist) {\n      parts.push(`${this.archivist}`)\n    }\n    parts.push(this.hash)\n    return parts.join('/')\n  }\n\n  static async fetch<T extends Payload = Payload>(huri: Huri): Promise<T | undefined> {\n    const AuthHeader = huri.token ? { Authorization: `Bearer ${huri.token}` } : undefined\n    return (await axios.get<T>(huri.href, { headers: AuthHeader })).data\n  }\n\n  static isHuri(value: unknown) {\n    if (typeof value === 'object') {\n      return (value as Huri).isHuri ? (value as Huri) : undefined\n    }\n  }\n\n  private static parsePath(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid format [${huri}]`)\n    if (protocolSplit.length === 1) {\n      return huri\n    }\n    if (protocolSplit.length === 2) {\n      return protocolSplit[1]\n    }\n  }\n\n  private static parseProtocol(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid second protocol [${protocolSplit[2]}]`)\n    const rawProtocol = protocolSplit.length === 2 ? protocolSplit.shift() : undefined\n    if (rawProtocol) {\n      const protocolParts = rawProtocol?.split(':')\n      assertEx(protocolParts.length === 2, () => `Invalid protocol format [${rawProtocol}]`)\n      assertEx(protocolParts[1].length === 0, () => `Invalid protocol format (post :) [${rawProtocol}]`)\n      return protocolParts.shift()\n    }\n  }\n\n  async fetch(): Promise<T | undefined> {\n    return await Huri.fetch<T>(this)\n  }\n\n  toString() {\n    return this.href\n  }\n\n  private parsePath(path: string, hasProtocol: boolean) {\n    const pathParts = path.split('/')\n\n    //if the protocol was found, then there is not allowed to be a leading /\n    assertEx(!(hasProtocol && pathParts[0].length === 0), () => 'Invalid protocol separator')\n\n    //remove leading '/' if needed\n    pathParts[0].length === 0 ? pathParts.shift() : null\n\n    //hash is assumed to be the last part\n    const hash = assertEx(pathParts.pop(), () => 'No hash specified')\n\n    //archivist is assumed to be the first part\n    this.archivist = pathParts.shift() ?? 'api.archivist.xyo.network'\n\n    //the archive is whatever is left\n    this.archive = pathParts.pop()\n\n    //after we pull off all the path parts, there should be nothing left\n    assertEx(pathParts.length === 0, () => 'Too many path parts')\n\n    return hash\n  }\n\n  private validateParse() {\n    //the archivist should not be zero length\n    assertEx(this.archivist?.length !== 0, () => 'Invalid archivist length')\n\n    //the archivist should not be zero length (can be undefined)\n    assertEx(this.archive?.length !== 0, () => 'Invalid archive length')\n\n    //the archive should not be set if the archivist is not set\n    assertEx(!(this.archive && !this.archivist), () => 'If specifying archive, archivist is also required')\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;ACAA,oBAAyB;AACzB,mBAAsB;AACtB,iBAAsC;AACtC,qBAA6B;AA2BtB,IAAMA,QAAN,MAAMA,MAAAA;EACXC;EACAC;EACAC;EACAC;EACAC;EACAC;EAEQC,SAAS;EAEjBC,YAAYC,MAA4B,EAAEC,cAAcJ,MAAK,IAAkB,CAAC,GAAG;AAxCrF;AAyCI,UAAMK,eACJX,WAAKO,OAAOE,IAAAA,MAAZT,mBAAmBY,UAClB,OAAOH,SAAS,WAAYA,OAC3BA,gBAAgBI,cAAc,IAAIC,4BAAaL,IAAAA,EAAMM,MACrDN,KAAKG;AACT,SAAKR,eAAeO;AAEpB,UAAMN,WAAWL,MAAKgB,cAAcL,UAAAA;AACpC,SAAKN,WAAWA,YAAY;AAE5B,UAAMY,WAAOC,wBAASlB,MAAKmB,UAAUR,UAAAA,GAAa,MAAM,cAAA;AACxD,SAAKR,WAAOe,wBAAS,KAAKC,UAAUF,MAAMZ,aAAae,MAAAA,GAAY,MAAM,cAAA;AAEzEF,oCAASG,mBAAO,KAAKlB,IAAI,GAAG,MAAM,iBAAiB,KAAKA,IAAI,GAAG;AAG/D,QAAIO,cAAc;AAChB,YAAMY,oBAAoBZ,aAAaa,MAAM,KAAA;AAC7C,WAAKlB,WAAWiB,kBAAkB,CAAA;AAClC,WAAKpB,YAAYoB,kBAAkB,CAAA;IACrC;AAEA,SAAKhB,QAAQA;AAEb,SAAKkB,cAAa;EACpB;;;;EAKA,IAAIZ,OAAO;AACT,UAAMa,QAAkB,CAAA;AACxB,QAAI,KAAKpB,UAAU;AACjBoB,YAAMC,KAAK,GAAG,KAAKrB,QAAQ,IAAI;IACjC;AACA,QAAI,KAAKJ,SAAS;AAChBwB,YAAMC,KAAK,GAAG,KAAKzB,OAAO,EAAE;IAC9B;AACA,QAAI,KAAKC,WAAW;AAClBuB,YAAMC,KAAK,GAAG,KAAKxB,SAAS,EAAE;IAChC;AACAuB,UAAMC,KAAK,KAAKvB,IAAI;AACpB,WAAOsB,MAAME,KAAK,GAAA;EACpB;EAEA,aAAaC,MAAmCnB,MAAoC;AAClF,UAAMoB,aAAapB,KAAKH,QAAQ;MAAEwB,eAAe,UAAUrB,KAAKH,KAAK;IAAG,IAAIc;AAC5E,YAAQ,MAAMW,mBAAMC,IAAOvB,KAAKG,MAAM;MAAEqB,SAASJ;IAAW,CAAA,GAAIK;EAClE;EAEA,OAAO3B,OAAO4B,OAAgB;AAC5B,QAAI,OAAOA,UAAU,UAAU;AAC7B,aAAQA,MAAe5B,SAAU4B,QAAiBf;IACpD;EACF;EAEA,OAAeD,UAAUV,MAAc;AACrC,UAAM2B,gBAAgB3B,KAAKc,MAAM,IAAA;AACjCL,gCAASkB,cAAcC,UAAU,GAAG,MAAM,mBAAmB5B,IAAAA,GAAO;AACpE,QAAI2B,cAAcC,WAAW,GAAG;AAC9B,aAAO5B;IACT;AACA,QAAI2B,cAAcC,WAAW,GAAG;AAC9B,aAAOD,cAAc,CAAA;IACvB;EACF;EAEA,OAAepB,cAAcP,MAAc;AACzC,UAAM2B,gBAAgB3B,KAAKc,MAAM,IAAA;AACjCL,gCAASkB,cAAcC,UAAU,GAAG,MAAM,4BAA4BD,cAAc,CAAA,CAAE,GAAG;AACzF,UAAME,cAAcF,cAAcC,WAAW,IAAID,cAAcG,MAAK,IAAKnB;AACzE,QAAIkB,aAAa;AACf,YAAME,gBAAgBF,2CAAaf,MAAM;AACzCL,kCAASsB,cAAcH,WAAW,GAAG,MAAM,4BAA4BC,WAAAA,GAAc;AACrFpB,kCAASsB,cAAc,CAAA,EAAGH,WAAW,GAAG,MAAM,qCAAqCC,WAAAA,GAAc;AACjG,aAAOE,cAAcD,MAAK;IAC5B;EACF;EAEA,MAAMX,QAAgC;AACpC,WAAO,MAAM5B,MAAK4B,MAAS,IAAI;EACjC;EAEAa,WAAW;AACT,WAAO,KAAK7B;EACd;EAEQO,UAAUF,MAAcyB,aAAsB;AACpD,UAAMC,YAAY1B,KAAKM,MAAM,GAAA;AAG7BL,gCAAS,EAAEwB,eAAeC,UAAU,CAAA,EAAGN,WAAW,IAAI,MAAM,4BAAA;AAG5DM,cAAU,CAAA,EAAGN,WAAW,IAAIM,UAAUJ,MAAK,IAAK;AAGhD,UAAMpC,WAAOe,wBAASyB,UAAUC,IAAG,GAAI,MAAM,mBAAA;AAG7C,SAAK1C,YAAYyC,UAAUJ,MAAK,KAAM;AAGtC,SAAKtC,UAAU0C,UAAUC,IAAG;AAG5B1B,gCAASyB,UAAUN,WAAW,GAAG,MAAM,qBAAA;AAEvC,WAAOlC;EACT;EAEQqB,gBAAgB;AAxJ1B;AA0JIN,kCAAS,UAAKhB,cAAL,mBAAgBmC,YAAW,GAAG,MAAM,0BAAA;AAG7CnB,kCAAS,UAAKjB,YAAL,mBAAcoC,YAAW,GAAG,MAAM,wBAAA;AAG3CnB,gCAAS,EAAE,KAAKjB,WAAW,CAAC,KAAKC,YAAY,MAAM,mDAAA;EACrD;AACF;AApIaF;AAAN,IAAMA,OAAN;","names":["Huri","archive","archivist","hash","originalHref","protocol","token","isHuri","constructor","huri","archivistUri","huriString","href","ArrayBuffer","AddressValue","hex","parseProtocol","path","assertEx","parsePath","undefined","isHash","archivistUriParts","split","validateParse","parts","push","join","fetch","AuthHeader","Authorization","axios","get","headers","data","value","protocolSplit","length","rawProtocol","shift","protocolParts","toString","hasProtocol","pathParts","pop"]}

package/dist/node/index.js

@@ -1,2 +1,113 @@
-var d=Object.defineProperty;var c=(l,t)=>d(l,"name",{value:t,configurable:!0});import{assertEx as r}from"@xylabs/assert";import{axios as v}from"@xylabs/axios";import{isHash as g}from"@xylabs/hex";import{AddressValue as u}from"@xyo-network/account";var o=class o{archive;archivist;hash;originalHref;protocol;token;isHuri=!0;constructor(t,{archivistUri:i,token:s}={}){var e;let h=((e=o.isHuri(t))==null?void 0:e.href)??(typeof t=="string"?t:t instanceof ArrayBuffer?new u(t).hex:t.href);this.originalHref=h;let a=o.parseProtocol(h);this.protocol=a??"https";let f=r(o.parsePath(h),()=>"Missing path");if(this.hash=r(this.parsePath(f,a!==void 0),()=>"Missing hash"),r(g(this.hash),()=>`Invalid hash [${this.hash}]`),i){let n=i.split("://");this.protocol=n[0],this.archivist=n[1]}this.token=s,this.validateParse()}get href(){let t=[];return this.protocol&&t.push(`${this.protocol}:/`),this.archive&&t.push(`${this.archive}`),this.archivist&&t.push(`${this.archivist}`),t.push(this.hash),t.join("/")}static async fetch(t){let i=t.token?{Authorization:`Bearer ${t.token}`}:void 0;return(await v.get(t.href,{headers:i})).data}static isHuri(t){if(typeof t=="object")return t.isHuri?t:void 0}static parsePath(t){let i=t.split("//");if(r(i.length<=2,()=>`Invalid format [${t}]`),i.length===1)return t;if(i.length===2)return i[1]}static parseProtocol(t){let i=t.split("//");r(i.length<=2,()=>`Invalid second protocol [${i[2]}]`);let s=i.length===2?i.shift():void 0;if(s){let h=s==null?void 0:s.split(":");return r(h.length===2,()=>`Invalid protocol format [${s}]`),r(h[1].length===0,()=>`Invalid protocol format (post :) [${s}]`),h.shift()}}async fetch(){return await o.fetch(this)}toString(){return this.href}parsePath(t,i){let s=t.split("/");r(!(i&&s[0].length===0),()=>"Invalid protocol separator"),s[0].length===0&&s.shift();let h=r(s.pop(),()=>"No hash specified");return this.archivist=s.shift()??"api.archivist.xyo.network",this.archive=s.pop(),r(s.length===0,()=>"Too many path parts"),h}validateParse(){var t,i;r(((t=this.archivist)==null?void 0:t.length)!==0,()=>"Invalid archivist length"),r(((i=this.archive)==null?void 0:i.length)!==0,()=>"Invalid archive length"),r(!(this.archive&&!this.archivist),()=>"If specifying archive, archivist is also required")}};c(o,"Huri");var p=o;export{p as Huri};
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/Huri.ts
+import { assertEx } from "@xylabs/assert";
+import { axios } from "@xylabs/axios";
+import { isHash } from "@xylabs/hex";
+import { AddressValue } from "@xyo-network/account";
+var _Huri = class _Huri {
+  archive;
+  archivist;
+  hash;
+  originalHref;
+  protocol;
+  token;
+  isHuri = true;
+  constructor(huri, { archivistUri, token } = {}) {
+    var _a;
+    const huriString = ((_a = _Huri.isHuri(huri)) == null ? void 0 : _a.href) ?? (typeof huri === "string" ? huri : huri instanceof ArrayBuffer ? new AddressValue(huri).hex : huri.href);
+    this.originalHref = huriString;
+    const protocol = _Huri.parseProtocol(huriString);
+    this.protocol = protocol ?? "https";
+    const path = assertEx(_Huri.parsePath(huriString), () => "Missing path");
+    this.hash = assertEx(this.parsePath(path, protocol !== void 0), () => "Missing hash");
+    assertEx(isHash(this.hash), () => `Invalid hash [${this.hash}]`);
+    if (archivistUri) {
+      const archivistUriParts = archivistUri.split("://");
+      this.protocol = archivistUriParts[0];
+      this.archivist = archivistUriParts[1];
+    }
+    this.token = token;
+    this.validateParse();
+  }
+  /*
+  The full href or the hash
+  */
+  get href() {
+    const parts = [];
+    if (this.protocol) {
+      parts.push(`${this.protocol}:/`);
+    }
+    if (this.archive) {
+      parts.push(`${this.archive}`);
+    }
+    if (this.archivist) {
+      parts.push(`${this.archivist}`);
+    }
+    parts.push(this.hash);
+    return parts.join("/");
+  }
+  static async fetch(huri) {
+    const AuthHeader = huri.token ? {
+      Authorization: `Bearer ${huri.token}`
+    } : void 0;
+    return (await axios.get(huri.href, {
+      headers: AuthHeader
+    })).data;
+  }
+  static isHuri(value) {
+    if (typeof value === "object") {
+      return value.isHuri ? value : void 0;
+    }
+  }
+  static parsePath(huri) {
+    const protocolSplit = huri.split("//");
+    assertEx(protocolSplit.length <= 2, () => `Invalid format [${huri}]`);
+    if (protocolSplit.length === 1) {
+      return huri;
+    }
+    if (protocolSplit.length === 2) {
+      return protocolSplit[1];
+    }
+  }
+  static parseProtocol(huri) {
+    const protocolSplit = huri.split("//");
+    assertEx(protocolSplit.length <= 2, () => `Invalid second protocol [${protocolSplit[2]}]`);
+    const rawProtocol = protocolSplit.length === 2 ? protocolSplit.shift() : void 0;
+    if (rawProtocol) {
+      const protocolParts = rawProtocol == null ? void 0 : rawProtocol.split(":");
+      assertEx(protocolParts.length === 2, () => `Invalid protocol format [${rawProtocol}]`);
+      assertEx(protocolParts[1].length === 0, () => `Invalid protocol format (post :) [${rawProtocol}]`);
+      return protocolParts.shift();
+    }
+  }
+  async fetch() {
+    return await _Huri.fetch(this);
+  }
+  toString() {
+    return this.href;
+  }
+  parsePath(path, hasProtocol) {
+    const pathParts = path.split("/");
+    assertEx(!(hasProtocol && pathParts[0].length === 0), () => "Invalid protocol separator");
+    pathParts[0].length === 0 ? pathParts.shift() : null;
+    const hash = assertEx(pathParts.pop(), () => "No hash specified");
+    this.archivist = pathParts.shift() ?? "api.archivist.xyo.network";
+    this.archive = pathParts.pop();
+    assertEx(pathParts.length === 0, () => "Too many path parts");
+    return hash;
+  }
+  validateParse() {
+    var _a, _b;
+    assertEx(((_a = this.archivist) == null ? void 0 : _a.length) !== 0, () => "Invalid archivist length");
+    assertEx(((_b = this.archive) == null ? void 0 : _b.length) !== 0, () => "Invalid archive length");
+    assertEx(!(this.archive && !this.archivist), () => "If specifying archive, archivist is also required");
+  }
+};
+__name(_Huri, "Huri");
+var Huri = _Huri;
+export {
+  Huri
+};
 //# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/Huri.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { axios } from '@xylabs/axios'\nimport { Address, Hash, isHash } from '@xylabs/hex'\nimport { AddressValue } from '@xyo-network/account'\nimport { Payload } from '@xyo-network/payload-model'\n\nexport type ObjectCategory = 'block' | 'payload'\n\nexport type HuriFetchFunction = (huri: Huri) => Promise<Payload | undefined>\n\n/* \n  Valid Huri:\n\n  [<protocol>://][<archivist>/[<archive>/]]<hash>\n\n  defaults:\n    protocol: https\n    archivist: api.archivist.xyo.network\n*/\n\nexport interface HuriOptions {\n  archivistUri?: string\n  token?: string\n}\n\nexport interface FetchedPayload<T extends Payload = Payload> {\n  huri?: Huri\n  payload: T\n}\n\nexport class Huri<T extends Payload = Payload> {\n  archive?: string\n  archivist?: Address | string\n  hash: Hash\n  originalHref: string\n  protocol?: string\n  token?: string\n\n  private isHuri = true\n\n  constructor(huri: Hash | Huri | string, { archivistUri, token }: HuriOptions = {}) {\n    const huriString =\n      Huri.isHuri(huri)?.href ??\n      (typeof huri === 'string' ? (huri as string)\n      : huri instanceof ArrayBuffer ? new AddressValue(huri).hex\n      : huri.href)\n    this.originalHref = huriString\n\n    const protocol = Huri.parseProtocol(huriString)\n    this.protocol = protocol ?? 'https'\n\n    const path = assertEx(Huri.parsePath(huriString), () => 'Missing path')\n    this.hash = assertEx(this.parsePath(path, protocol !== undefined), () => 'Missing hash') as Hash\n\n    assertEx(isHash(this.hash), () => `Invalid hash [${this.hash}]`)\n\n    //if archivistUri sent, overwrite protocol and archivist\n    if (archivistUri) {\n      const archivistUriParts = archivistUri.split('://')\n      this.protocol = archivistUriParts[0]\n      this.archivist = archivistUriParts[1]\n    }\n\n    this.token = token\n\n    this.validateParse()\n  }\n\n  /*\n  The full href or the hash\n  */\n  get href() {\n    const parts: string[] = []\n    if (this.protocol) {\n      parts.push(`${this.protocol}:/`)\n    }\n    if (this.archive) {\n      parts.push(`${this.archive}`)\n    }\n    if (this.archivist) {\n      parts.push(`${this.archivist}`)\n    }\n    parts.push(this.hash)\n    return parts.join('/')\n  }\n\n  static async fetch<T extends Payload = Payload>(huri: Huri): Promise<T | undefined> {\n    const AuthHeader = huri.token ? { Authorization: `Bearer ${huri.token}` } : undefined\n    return (await axios.get<T>(huri.href, { headers: AuthHeader })).data\n  }\n\n  static isHuri(value: unknown) {\n    if (typeof value === 'object') {\n      return (value as Huri).isHuri ? (value as Huri) : undefined\n    }\n  }\n\n  private static parsePath(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid format [${huri}]`)\n    if (protocolSplit.length === 1) {\n      return huri\n    }\n    if (protocolSplit.length === 2) {\n      return protocolSplit[1]\n    }\n  }\n\n  private static parseProtocol(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid second protocol [${protocolSplit[2]}]`)\n    const rawProtocol = protocolSplit.length === 2 ? protocolSplit.shift() : undefined\n    if (rawProtocol) {\n      const protocolParts = rawProtocol?.split(':')\n      assertEx(protocolParts.length === 2, () => `Invalid protocol format [${rawProtocol}]`)\n      assertEx(protocolParts[1].length === 0, () => `Invalid protocol format (post :) [${rawProtocol}]`)\n      return protocolParts.shift()\n    }\n  }\n\n  async fetch(): Promise<T | undefined> {\n    return await Huri.fetch<T>(this)\n  }\n\n  toString() {\n    return this.href\n  }\n\n  private parsePath(path: string, hasProtocol: boolean) {\n    const pathParts = path.split('/')\n\n    //if the protocol was found, then there is not allowed to be a leading /\n    assertEx(!(hasProtocol && pathParts[0].length === 0), () => 'Invalid protocol separator')\n\n    //remove leading '/' if needed\n    pathParts[0].length === 0 ? pathParts.shift() : null\n\n    //hash is assumed to be the last part\n    const hash = assertEx(pathParts.pop(), () => 'No hash specified')\n\n    //archivist is assumed to be the first part\n    this.archivist = pathParts.shift() ?? 'api.archivist.xyo.network'\n\n    //the archive is whatever is left\n    this.archive = pathParts.pop()\n\n    //after we pull off all the path parts, there should be nothing left\n    assertEx(pathParts.length === 0, () => 'Too many path parts')\n\n    return hash\n  }\n\n  private validateParse() {\n    //the archivist should not be zero length\n    assertEx(this.archivist?.length !== 0, () => 'Invalid archivist length')\n\n    //the archivist should not be zero length (can be undefined)\n    assertEx(this.archive?.length !== 0, () => 'Invalid archive length')\n\n    //the archive should not be set if the archivist is not set\n    assertEx(!(this.archive && !this.archivist), () => 'If specifying archive, archivist is also required')\n  }\n}\n"],"mappings":"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","names":["assertEx","axios","isHash","AddressValue","Huri","archive","archivist","hash","originalHref","protocol","token","isHuri","constructor","huri","archivistUri","_a","huriString","href","ArrayBuffer","AddressValue","hex","parseProtocol","path","assertEx","parsePath","undefined","isHash","archivistUriParts","split","validateParse","parts","push","join","fetch","AuthHeader","Authorization","axios","get","headers","data","value","protocolSplit","length","rawProtocol","shift","protocolParts","toString","hasProtocol","pathParts","pop","_b","_Huri"]}
+{"version":3,"sources":["../../src/Huri.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { axios } from '@xylabs/axios'\nimport { Address, Hash, isHash } from '@xylabs/hex'\nimport { AddressValue } from '@xyo-network/account'\nimport { Payload } from '@xyo-network/payload-model'\n\nexport type ObjectCategory = 'block' | 'payload'\n\nexport type HuriFetchFunction = (huri: Huri) => Promise<Payload | undefined>\n\n/* \n  Valid Huri:\n\n  [<protocol>://][<archivist>/[<archive>/]]<hash>\n\n  defaults:\n    protocol: https\n    archivist: api.archivist.xyo.network\n*/\n\nexport interface HuriOptions {\n  archivistUri?: string\n  token?: string\n}\n\nexport interface FetchedPayload<T extends Payload = Payload> {\n  huri?: Huri\n  payload: T\n}\n\nexport class Huri<T extends Payload = Payload> {\n  archive?: string\n  archivist?: Address | string\n  hash: Hash\n  originalHref: string\n  protocol?: string\n  token?: string\n\n  private isHuri = true\n\n  constructor(huri: Hash | Huri | string, { archivistUri, token }: HuriOptions = {}) {\n    const huriString =\n      Huri.isHuri(huri)?.href ??\n      (typeof huri === 'string' ? (huri as string)\n      : huri instanceof ArrayBuffer ? new AddressValue(huri).hex\n      : huri.href)\n    this.originalHref = huriString\n\n    const protocol = Huri.parseProtocol(huriString)\n    this.protocol = protocol ?? 'https'\n\n    const path = assertEx(Huri.parsePath(huriString), () => 'Missing path')\n    this.hash = assertEx(this.parsePath(path, protocol !== undefined), () => 'Missing hash') as Hash\n\n    assertEx(isHash(this.hash), () => `Invalid hash [${this.hash}]`)\n\n    //if archivistUri sent, overwrite protocol and archivist\n    if (archivistUri) {\n      const archivistUriParts = archivistUri.split('://')\n      this.protocol = archivistUriParts[0]\n      this.archivist = archivistUriParts[1]\n    }\n\n    this.token = token\n\n    this.validateParse()\n  }\n\n  /*\n  The full href or the hash\n  */\n  get href() {\n    const parts: string[] = []\n    if (this.protocol) {\n      parts.push(`${this.protocol}:/`)\n    }\n    if (this.archive) {\n      parts.push(`${this.archive}`)\n    }\n    if (this.archivist) {\n      parts.push(`${this.archivist}`)\n    }\n    parts.push(this.hash)\n    return parts.join('/')\n  }\n\n  static async fetch<T extends Payload = Payload>(huri: Huri): Promise<T | undefined> {\n    const AuthHeader = huri.token ? { Authorization: `Bearer ${huri.token}` } : undefined\n    return (await axios.get<T>(huri.href, { headers: AuthHeader })).data\n  }\n\n  static isHuri(value: unknown) {\n    if (typeof value === 'object') {\n      return (value as Huri).isHuri ? (value as Huri) : undefined\n    }\n  }\n\n  private static parsePath(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid format [${huri}]`)\n    if (protocolSplit.length === 1) {\n      return huri\n    }\n    if (protocolSplit.length === 2) {\n      return protocolSplit[1]\n    }\n  }\n\n  private static parseProtocol(huri: string) {\n    const protocolSplit = huri.split('//')\n    assertEx(protocolSplit.length <= 2, () => `Invalid second protocol [${protocolSplit[2]}]`)\n    const rawProtocol = protocolSplit.length === 2 ? protocolSplit.shift() : undefined\n    if (rawProtocol) {\n      const protocolParts = rawProtocol?.split(':')\n      assertEx(protocolParts.length === 2, () => `Invalid protocol format [${rawProtocol}]`)\n      assertEx(protocolParts[1].length === 0, () => `Invalid protocol format (post :) [${rawProtocol}]`)\n      return protocolParts.shift()\n    }\n  }\n\n  async fetch(): Promise<T | undefined> {\n    return await Huri.fetch<T>(this)\n  }\n\n  toString() {\n    return this.href\n  }\n\n  private parsePath(path: string, hasProtocol: boolean) {\n    const pathParts = path.split('/')\n\n    //if the protocol was found, then there is not allowed to be a leading /\n    assertEx(!(hasProtocol && pathParts[0].length === 0), () => 'Invalid protocol separator')\n\n    //remove leading '/' if needed\n    pathParts[0].length === 0 ? pathParts.shift() : null\n\n    //hash is assumed to be the last part\n    const hash = assertEx(pathParts.pop(), () => 'No hash specified')\n\n    //archivist is assumed to be the first part\n    this.archivist = pathParts.shift() ?? 'api.archivist.xyo.network'\n\n    //the archive is whatever is left\n    this.archive = pathParts.pop()\n\n    //after we pull off all the path parts, there should be nothing left\n    assertEx(pathParts.length === 0, () => 'Too many path parts')\n\n    return hash\n  }\n\n  private validateParse() {\n    //the archivist should not be zero length\n    assertEx(this.archivist?.length !== 0, () => 'Invalid archivist length')\n\n    //the archivist should not be zero length (can be undefined)\n    assertEx(this.archive?.length !== 0, () => 'Invalid archive length')\n\n    //the archive should not be set if the archivist is not set\n    assertEx(!(this.archive && !this.archivist), () => 'If specifying archive, archivist is also required')\n  }\n}\n"],"mappings":"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","names":["assertEx","axios","isHash","AddressValue","Huri","archive","archivist","hash","originalHref","protocol","token","isHuri","constructor","huri","archivistUri","huriString","href","ArrayBuffer","AddressValue","hex","parseProtocol","path","assertEx","parsePath","undefined","isHash","archivistUriParts","split","validateParse","parts","push","join","fetch","AuthHeader","Authorization","axios","get","headers","data","value","protocolSplit","length","rawProtocol","shift","protocolParts","toString","hasProtocol","pathParts","pop"]}

package/package.json

@@ -13,13 +13,13 @@
     "@xylabs/assert": "^3.5.1",
     "@xylabs/axios": "^3.5.1",
     "@xylabs/hex": "^3.5.1",
-    "@xyo-network/account": "~2.107.3",
-    "@xyo-network/payload-model": "~2.107.3"
+    "@xyo-network/account": "~2.107.4",
+    "@xyo-network/payload-model": "~2.107.4"
   },
   "devDependencies": {
     "@xylabs/delay": "^3.5.1",
-    "@xylabs/ts-scripts-yarn3": "^3.11.9",
-    "@xylabs/tsconfig": "^3.11.9",
+    "@xylabs/ts-scripts-yarn3": "^3.11.10",
+    "@xylabs/tsconfig": "^3.11.10",
     "typescript": "^5.5.2"
   },
   "description": "Primary SDK for using XYO Protocol 2.0",
@@ -61,6 +61,6 @@
   },
   "sideEffects": false,
   "types": "dist/node/index.d.ts",
-  "version": "2.107.3",
+  "version": "2.107.4",
   "type": "module"
 }