@noeldemartin/solid-utils 0.5.0 → 0.6.0-next.cccdc9c7e033588e2df9d1887ceae49788344d84

package/dist/noeldemartin-solid-utils.js

@@ -0,0 +1,590 @@
+var Z = Object.defineProperty;
+var tt = (e, t, r) => t in e ? Z(e, t, { enumerable: !0, configurable: !0, writable: !0, value: r }) : e[t] = r;
+var l = (e, t, r) => tt(e, typeof t != "symbol" ? t + "" : t, r);
+import { JSError as p, parseDate as g, stringMatch as et, arrayFilter as N, objectWithoutEmpty as y, stringMatchAll as k, arr as v, tap as L, arrayReplace as rt, silenced as M, urlRoot as nt, urlRoute as st, urlParentDirectory as U, arrayUnique as at, objectDeepClone as ot, urlParse as it, uuid as Q, isObject as S, isArray as ct, urlResolve as ut, requireUrlParentDirectory as O } from "@noeldemartin/utils";
+import lt from "md5";
+import { Parser as W, Writer as z, BlankNode as dt, Quad as ft } from "n3";
+import { compact as ht, toRDF as pt, fromRDF as wt } from "jsonld";
+function mt(e, t, r) {
+  return e ? `Malformed ${t} document found at ${e} - ${r}` : `Malformed ${t} document - ${r}`;
+}
+var T = /* @__PURE__ */ ((e) => (e.Turtle = "Turtle", e))(T || {});
+class B extends p {
+  constructor(r, n, s) {
+    super(mt(r, n, s));
+    l(this, "documentUrl");
+    l(this, "documentFormat");
+    l(this, "malformationDetails");
+    this.documentUrl = r, this.documentFormat = n, this.malformationDetails = s;
+  }
+}
+class yt extends p {
+  constructor(r, n) {
+    super(`Request failed trying to fetch ${r}`, n);
+    l(this, "url");
+    this.url = r;
+  }
+}
+class b extends p {
+  constructor(r) {
+    super(`Document with '${r}' url not found`);
+    l(this, "url");
+    this.url = r;
+  }
+}
+function gt(e, t) {
+  return `Unauthorized${t === 403 ? " (Forbidden)" : ""}: ${e}`;
+}
+class I extends p {
+  constructor(r, n) {
+    super(gt(r, n));
+    l(this, "url");
+    l(this, "responseStatus");
+    this.url = r, this.responseStatus = n;
+  }
+  get forbidden() {
+    return typeof this.responseStatus < "u" ? this.responseStatus === 403 : void 0;
+  }
+}
+function vt(e, t) {
+  return t = t ?? e, typeof e == "string" ? `${e} (returned ${t.status} status code)` : `Request to ${t.url} returned ${t.status} status code`;
+}
+class _t extends p {
+  constructor(r, n) {
+    super(vt(r, n));
+    l(this, "response");
+    this.response = n ?? r;
+  }
+}
+class bt extends p {
+  constructor(r, n, s) {
+    super(`The resource at ${r} is using an unsupported authorization protocol (${n})`, s);
+    l(this, "url");
+    l(this, "protocol");
+    this.url = r, this.protocol = n;
+  }
+}
+const F = {
+  acl: "http://www.w3.org/ns/auth/acl#",
+  foaf: "http://xmlns.com/foaf/0.1/",
+  ldp: "http://www.w3.org/ns/ldp#",
+  pim: "http://www.w3.org/ns/pim/space#",
+  purl: "http://purl.org/dc/terms/",
+  rdf: "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
+  rdfs: "http://www.w3.org/2000/01/rdf-schema#",
+  schema: "https://schema.org/",
+  solid: "http://www.w3.org/ns/solid/terms#",
+  vcard: "http://www.w3.org/2006/vcard/ns#"
+};
+function Jt(e, t) {
+  F[e] = t;
+}
+function f(e, t = {}) {
+  var s;
+  if (e.startsWith("http"))
+    return e;
+  const [r, n] = e.split(":");
+  if (r && n) {
+    const a = F[r] ?? ((s = t.extraContext) == null ? void 0 : s[r]) ?? null;
+    if (!a)
+      throw new Error(`Can't expand IRI with unknown prefix: '${e}'`);
+    return a + n;
+  }
+  if (!t.defaultPrefix)
+    throw new Error(`Can't expand IRI without a default prefix: '${e}'`);
+  return t.defaultPrefix + r;
+}
+class It {
+  constructor(t, r) {
+    l(this, "url");
+    l(this, "quads");
+    this.url = t, this.quads = r;
+  }
+  value(t) {
+    var r;
+    return (r = this.quads.find((n) => n.predicate.value === f(t))) == null ? void 0 : r.object.value;
+  }
+  values(t) {
+    return this.quads.filter((r) => r.predicate.value === f(t)).map((r) => r.object.value);
+  }
+}
+class H {
+  constructor(t = []) {
+    l(this, "quads");
+    this.quads = t;
+  }
+  isEmpty() {
+    return this.statements.length === 0;
+  }
+  getQuads() {
+    return this.quads.slice(0);
+  }
+  addQuads(t) {
+    this.quads.push(...t);
+  }
+  statements(t, r, n) {
+    return this.quads.filter(
+      (s) => (!n || this.termMatches(s.object, n)) && (!t || this.termMatches(s.subject, t)) && (!r || this.termMatches(s.predicate, r))
+    );
+  }
+  statement(t, r, n) {
+    return this.quads.find(
+      (a) => (!n || this.termMatches(a.object, n)) && (!t || this.termMatches(a.subject, t)) && (!r || this.termMatches(a.predicate, r))
+    ) ?? null;
+  }
+  contains(t, r, n) {
+    return this.statement(t, r, n) !== null;
+  }
+  getThing(t) {
+    const r = this.statements(t);
+    return new It(t, r);
+  }
+  expandIRI(t) {
+    return f(t);
+  }
+  termMatches(t, r) {
+    return typeof r == "string" ? this.expandIRI(r) === t.value : t.termType === t.termType && t.value === r.value;
+  }
+}
+var xt = /* @__PURE__ */ ((e) => (e.Read = "read", e.Write = "write", e.Append = "append", e.Control = "control", e))(xt || {});
+class _ extends H {
+  constructor(r, n, s) {
+    super(n);
+    l(this, "url");
+    l(this, "headers");
+    this.url = r, this.headers = s;
+  }
+  isACPResource() {
+    var r;
+    return !!((r = this.headers.get("Link")) != null && r.match(/<http:\/\/www\.w3\.org\/ns\/solid\/acp#AccessControlResource>;[^,]+rel="type"/));
+  }
+  isPersonalProfile() {
+    return !!this.statement(this.url, f("rdf:type"), f("foaf:PersonalProfileDocument"));
+  }
+  isStorage() {
+    var r;
+    return !!((r = this.headers.get("Link")) != null && r.match(/<http:\/\/www\.w3\.org\/ns\/pim\/space#Storage>;[^,]+rel="type"/));
+  }
+  isUserWritable() {
+    return this.getUserPermissions().includes(
+      "write"
+      /* Write */
+    );
+  }
+  getUserPermissions() {
+    return this.getPermissionsFromWAC("user");
+  }
+  getPublicPermissions() {
+    return this.getPermissionsFromWAC("public");
+  }
+  getLastModified() {
+    var r;
+    return g(this.headers.get("last-modified")) ?? g((r = this.statement(this.url, "purl:modified")) == null ? void 0 : r.object.value) ?? this.getLatestDocumentDate() ?? null;
+  }
+  expandIRI(r) {
+    return f(r, { defaultPrefix: this.url });
+  }
+  getLatestDocumentDate() {
+    const r = [...this.statements(void 0, "purl:modified"), ...this.statements(void 0, "purl:created")].map((n) => g(n.object.value)).filter((n) => n !== null);
+    return r.length > 0 ? r.reduce((n, s) => n > s ? n : s) : null;
+  }
+  getPermissionsFromWAC(r) {
+    var a;
+    const n = this.headers.get("WAC-Allow") ?? "", s = ((a = et(n, new RegExp(`${r}="([^"]+)"`))) == null ? void 0 : a[1]) ?? "";
+    return N([
+      s.includes("read") && "read",
+      s.includes("write") && "write",
+      s.includes("append") && "append",
+      s.includes("control") && "control"
+      /* Control */
+    ]);
+  }
+}
+async function Gt(e) {
+  const t = await ht(e, {});
+  return "@graph" in t ? t : "@id" in t ? { "@graph": [t] } : { "@graph": [] };
+}
+function Tt(e) {
+  return "@graph" in e;
+}
+const R = "anonymous://", Rt = R.length;
+async function Pt(e, t) {
+  const r = {
+    headers: { Accept: "text/turtle" }
+  };
+  t != null && t.cache && (r.cache = t.cache);
+  try {
+    const s = await ((t == null ? void 0 : t.fetch) ?? window.fetch)(e, r);
+    if (s.status === 404) throw new b(e);
+    if ([401, 403].includes(s.status)) throw new I(e, s.status);
+    return {
+      body: await s.text(),
+      headers: s.headers
+    };
+  } catch (n) {
+    throw n instanceof I || n instanceof b ? n : new yt(e, { cause: n });
+  }
+}
+function jt(e) {
+  const t = e.slice(0), r = {}, n = v(e).flatMap((s, a) => L(
+    N([
+      s.object.termType === "BlankNode" ? s.object.value : null,
+      s.subject.termType === "BlankNode" ? s.subject.value : null
+    ]),
+    (u) => u.forEach((o) => (r[o] ?? (r[o] = /* @__PURE__ */ new Set())).add(a))
+  )).filter().unique();
+  for (const s of n) {
+    const a = r[s], u = lt(
+      v(a).map((o) => e[o]).filter(({ subject: { termType: o, value: i } }) => o === "BlankNode" && i === s).map(({ predicate: o, object: i }) => i.termType === "BlankNode" ? o.value : o.value + i.value).sorted().join()
+    );
+    for (const o of a) {
+      const i = t[o], c = {
+        subject: i.subject,
+        object: i.object
+      };
+      for (const [w, d] of Object.entries(c))
+        d.termType !== "BlankNode" || d.value !== s || (c[w] = new dt(u));
+      rt(
+        t,
+        i,
+        new ft(c.subject, i.predicate, c.object)
+      );
+    }
+  }
+  return t;
+}
+function J(e) {
+  return e.map((t) => "    " + St(t)).sort().join(`
+`);
+}
+function $t(e) {
+  var t;
+  (t = e["@id"]) != null && t.startsWith("#") && (e["@id"] = R + e["@id"]);
+}
+function qt(e) {
+  for (const t of e)
+    t.subject.value.startsWith(R) && (t.subject.value = t.subject.value.slice(Rt));
+}
+async function At(e, t, r) {
+  r = r ?? window.fetch.bind(window);
+  const n = await P(t);
+  return await r(e, {
+    method: "PUT",
+    headers: { "Content-Type": "text/turtle" },
+    body: t
+  }), new _(e, n, new Headers({}));
+}
+async function h(e, t) {
+  const { body: r, headers: n } = await Pt(e, t), s = await P(r, { baseIRI: e });
+  return new _(e, s, n);
+}
+async function Ct(e, t) {
+  try {
+    return await h(e, t);
+  } catch (r) {
+    if (!(r instanceof b)) throw r;
+    return null;
+  }
+}
+async function Et(e, t) {
+  if (Tt(e))
+    return (await Promise.all(e["@graph"].map((s) => Et(s, t)))).flat();
+  $t(e);
+  const r = await pt(e, { base: t });
+  return qt(r), r;
+}
+function Vt(e) {
+  const t = Nt(e);
+  return Object.entries(t).reduce((r, [n, s]) => {
+    const a = J(s);
+    return r.concat(`${n.toUpperCase()} DATA {
+${a}
+}`);
+  }, []).join(` ;
+`);
+}
+function Xt(e) {
+  const t = G(e);
+  return J(t);
+}
+function Ut(e, t = {}) {
+  const r = y({ baseIRI: t.baseIRI }), n = new W(r), s = {
+    quads: [],
+    containsRelativeIRIs: !1
+  };
+  return new Promise((a, u) => {
+    const o = n._resolveRelativeIRI;
+    n._resolveRelativeIRI = (...i) => (s.containsRelativeIRIs = !0, n._resolveRelativeIRI = o, n._resolveRelativeIRI(...i)), n.parse(e, (i, c) => {
+      if (i) {
+        u(
+          new B(t.baseIRI ?? null, T.Turtle, i.message)
+        );
+        return;
+      }
+      if (!c) {
+        a(s);
+        return;
+      }
+      s.quads.push(c);
+    });
+  });
+}
+async function Yt(e) {
+  return {
+    "@graph": await wt(e)
+  };
+}
+function Kt(e) {
+  return new z().quadsToString(e);
+}
+function St(e) {
+  return new z().quadsToString([e]).slice(0, -1);
+}
+async function Dt(e, t) {
+  try {
+    return !(await h(e, t)).isEmpty();
+  } catch {
+    return !1;
+  }
+}
+async function Zt(e, t = {}) {
+  const r = k(e, /(\w+) DATA {([^}]+)}/g), n = {};
+  return await Promise.all(
+    [...r].map(async (s) => {
+      const a = s[1].toLowerCase(), u = s[2];
+      n[a] = await P(u, t);
+    })
+  ), n;
+}
+function Nt(e, t = {}) {
+  const r = k(e, /(\w+) DATA {([^}]+)}/g), n = {};
+  for (const s of r) {
+    const a = s[1].toLowerCase(), u = s[2];
+    n[a] = G(u, t);
+  }
+  return n;
+}
+async function P(e, t = {}) {
+  const { quads: r } = await Ut(e, t);
+  return r;
+}
+function G(e, t = {}) {
+  const r = y({ baseIRI: t.baseIRI }), n = new W(r);
+  try {
+    const s = n.parse(e);
+    return t.normalizeBlankNodes ? jt(s) : s;
+  } catch (s) {
+    throw new B(
+      t.baseIRI ?? null,
+      T.Turtle,
+      s.message ?? ""
+    );
+  }
+}
+async function kt(e, t, r) {
+  r = r ?? window.fetch.bind(window), await r(e, {
+    method: "PATCH",
+    headers: { "Content-Type": "application/sparql-update" },
+    body: t
+  });
+}
+async function Lt(e, t) {
+  var u;
+  const r = new H(e.getQuads()), n = { [e.url]: e }, s = (o) => {
+    o.statements(void 0, "foaf:isPrimaryTopicOf").map((i) => i.object.value).forEach((i) => n[i] = n[i] ?? null), o.statements(void 0, "foaf:primaryTopic").map((i) => i.subject.value).forEach((i) => n[i] = n[i] ?? null);
+  }, a = async () => {
+    for (const [o, i] of Object.entries(n))
+      if (i === null)
+        try {
+          const c = await h(o, t);
+          n[o] = c, r.addQuads(c.getQuads()), s(c);
+        } catch (c) {
+          if (c instanceof I) {
+            n[o] = !1;
+            continue;
+          }
+          throw c;
+        }
+  };
+  s(e);
+  do
+    await a();
+  while (Object.values(n).some((o) => o === null));
+  return {
+    store: r,
+    cloaked: Object.values(n).some((o) => o === !1),
+    writableProfileUrl: e.isUserWritable() ? e.url : ((u = Object.values(n).find(
+      (o) => !!o && o.isUserWritable()
+    )) == null ? void 0 : u.url) ?? null
+  };
+}
+async function D(e, t = {}) {
+  var j, $, q, A, C, E;
+  const r = {
+    fetch: t.fetch,
+    // Needed for CSS v7.1.3.
+    // See https://github.com/CommunitySolidServer/CommunitySolidServer/issues/1972
+    cache: "no-store"
+  }, n = st(e), s = await h(n, r);
+  if (!s.isPersonalProfile() && !s.contains(e, "solid:oidcIssuer"))
+    throw new Error(`${e} is not a valid webId.`);
+  const { store: a, writableProfileUrl: u, cloaked: o } = await Lt(s, t), i = a.statements(e, "pim:storage").map((m) => m.object.value), c = a.statement(e, "solid:publicTypeIndex"), w = a.statement(e, "solid:privateTypeIndex");
+  let d = U(n);
+  for (; d && i.length === 0; ) {
+    const m = await M(h(d, r));
+    if (m != null && m.isStorage()) {
+      i.push(d);
+      break;
+    }
+    d = U(d);
+  }
+  if (i.length === 0)
+    throw new Error(`Could not find any storage for ${e}.`);
+  return await ((j = t.onLoaded) == null ? void 0 : j.call(t, a)), {
+    webId: e,
+    cloaked: o,
+    writableProfileUrl: u,
+    storageUrls: at(i),
+    ...y({
+      name: (($ = a.statement(e, "vcard:fn")) == null ? void 0 : $.object.value) ?? ((q = a.statement(e, "foaf:name")) == null ? void 0 : q.object.value),
+      avatarUrl: ((A = a.statement(e, "vcard:hasPhoto")) == null ? void 0 : A.object.value) ?? ((C = a.statement(e, "foaf:img")) == null ? void 0 : C.object.value),
+      oidcIssuerUrl: (E = a.statement(e, "solid:oidcIssuer")) == null ? void 0 : E.object.value,
+      publicTypeIndexUrl: c == null ? void 0 : c.object.value,
+      privateTypeIndexUrl: w == null ? void 0 : w.object.value
+    })
+  };
+}
+async function te(e, t = {}) {
+  if (t.required)
+    return D(e, t);
+  const r = M((n) => D(n, t));
+  return await r(e) ?? await r(e.replace(/\/$/, "").concat("/profile/card#me")) ?? await r(nt(e).concat("/profile/card#me"));
+}
+function Mt(e) {
+  return !e.path || !e.path.startsWith("/") ? null : e.path.match(/^\/[^/]*$/) ? "/" : `/${v(e.path.split("/")).filter().slice(0, -1).join("/")}/`.replace("//", "/");
+}
+function Qt(e) {
+  const t = Mt(e);
+  return e.protocol && e.domain ? `${e.protocol}://${e.domain}${t ?? "/"}` : t;
+}
+function x(e) {
+  if (!(!("@type" in e) || "@value" in e)) {
+    e["@id"] = e["@id"] ?? Q();
+    for (const t of Object.values(e))
+      S(t) && x(t), ct(t) && t.forEach((r) => S(r) && x(r));
+  }
+}
+function ee(e) {
+  return L(ot(e), (t) => x(t));
+}
+function re(e) {
+  const t = it(e);
+  return t ? y({
+    containerUrl: Qt(t),
+    documentName: t.path ? t.path.split("/").pop() : null,
+    resourceHash: t.fragment
+  }) : {};
+}
+async function Ot(e, t, r) {
+  r = r ?? window.fetch.bind(r);
+  const n = e.storageUrls[0], s = `${n}settings/${t}TypeIndex`;
+  return await Dt(s, { fetch: r }) ? `${n}settings/${t}TypeIndex-${Q()}` : s;
+}
+async function V(e, t, r) {
+  if (e.writableProfileUrl === null)
+    throw new Error("Can't create type index without a writable profile document");
+  r = r ?? window.fetch.bind(r);
+  const n = await Ot(e, t, r), s = t === "public" ? "<> a <http://www.w3.org/ns/solid/terms#TypeIndex> ." : `
+            <> a
+                <http://www.w3.org/ns/solid/terms#TypeIndex>,
+                <http://www.w3.org/ns/solid/terms#UnlistedDocument> .
+        `, a = `
+        INSERT DATA {
+            <${e.webId}> <http://www.w3.org/ns/solid/terms#${t}TypeIndex> <${n}> .
+        }
+    `;
+  return await At(n, s, r), await kt(e.writableProfileUrl, a, r), n;
+}
+async function X(e, t, r, n) {
+  const s = await h(e, { fetch: n });
+  return (Array.isArray(t) ? t : [t]).map((u) => s.statements(void 0, "rdf:type", "solid:TypeRegistration").filter((o) => s.contains(o.subject.value, "solid:forClass", u)).map((o) => s.statements(o.subject.value, r)).flat().map((o) => o.object.value).filter((o) => !!o)).flat();
+}
+async function ne(e, t) {
+  return V(e, "public", t);
+}
+async function se(e, t) {
+  return V(e, "private", t);
+}
+async function ae(e, t, r) {
+  return X(e, t, "solid:instanceContainer", r);
+}
+async function oe(e, t, r) {
+  return X(e, t, "solid:instance", r);
+}
+async function Y(e, t) {
+  var a;
+  t = t ?? window.fetch.bind(window);
+  const s = ((a = ((await t(e, { method: "HEAD" })).headers.get("Link") ?? "").match(/<([^>]+)>;\s*rel="acl"/)) == null ? void 0 : a[1]) ?? null;
+  if (!s)
+    throw new Error(`Could not find ACL Resource for '${e}'`);
+  return ut(O(e), s);
+}
+async function K(e, t, r) {
+  r = r ?? await Y(e, t);
+  const n = await Ct(r ?? "", { fetch: t });
+  if (!n)
+    return K(O(e), t);
+  if (n.isACPResource())
+    throw new bt(e, "ACP");
+  return n;
+}
+async function ie(e, t) {
+  const r = await Y(e, t), n = await K(e, t, r);
+  return y({
+    url: r,
+    effectiveUrl: n.url,
+    document: n
+  });
+}
+export {
+  B as MalformedSolidDocumentError,
+  yt as NetworkRequestError,
+  b as NotFoundError,
+  _ as SolidDocument,
+  T as SolidDocumentFormat,
+  xt as SolidDocumentPermission,
+  H as SolidStore,
+  It as SolidThing,
+  I as UnauthorizedError,
+  _t as UnsuccessfulNetworkRequestError,
+  bt as UnsupportedAuthorizationProtocolError,
+  Gt as compactJsonLDGraph,
+  se as createPrivateTypeIndex,
+  ne as createPublicTypeIndex,
+  At as createSolidDocument,
+  Jt as defineIRIPrefix,
+  f as expandIRI,
+  te as fetchLoginUserProfile,
+  h as fetchSolidDocument,
+  ie as fetchSolidDocumentACL,
+  Ct as fetchSolidDocumentIfFound,
+  ae as findContainerRegistrations,
+  oe as findInstanceRegistrations,
+  Tt as isJsonLDGraph,
+  Et as jsonldToQuads,
+  ee as mintJsonLDIdentifiers,
+  Vt as normalizeSparql,
+  Xt as normalizeTurtle,
+  re as parseResourceSubject,
+  Ut as parseTurtle,
+  St as quadToTurtle,
+  Yt as quadsToJsonLD,
+  Kt as quadsToTurtle,
+  Dt as solidDocumentExists,
+  Zt as sparqlToQuads,
+  Nt as sparqlToQuadsSync,
+  P as turtleToQuads,
+  G as turtleToQuadsSync,
+  kt as updateSolidDocument
+};
+//# sourceMappingURL=noeldemartin-solid-utils.js.map