@noeldemartin/solid-utils 0.5.0 → 0.6.0-next.8a6a0b585adc7a1c329fb0fed5c420bb72cdccda

package/dist/noeldemartin-solid-utils.js

@@ -0,0 +1,590 @@
+var tt = Object.defineProperty;
+var et = (e, t, r) => t in e ? tt(e, t, { enumerable: !0, configurable: !0, writable: !0, value: r }) : e[t] = r;
+var l = (e, t, r) => et(e, typeof t != "symbol" ? t + "" : t, r);
+import { JSError as p, parseDate as g, stringMatch as rt, arrayFilter as k, objectWithoutEmpty as y, stringMatchAll as L, arr as v, tap as M, arrayReplace as nt, silenced as Q, urlRoot as st, urlRoute as at, urlParentDirectory as S, arrayUnique as ot, objectDeepClone as it, urlParse as ct, uuid as O, isObject as D, isArray as ut, urlResolve as lt, requireUrlParentDirectory as W } from "@noeldemartin/utils";
+import * as T from "jsonld";
+import dt from "md5";
+import { Parser as z, Writer as B, BlankNode as ft, Quad as ht } from "n3";
+function pt(e, t, r) {
+  return e ? `Malformed ${t} document found at ${e} - ${r}` : `Malformed ${t} document - ${r}`;
+}
+var R = /* @__PURE__ */ ((e) => (e.Turtle = "Turtle", e))(R || {});
+class F extends p {
+  constructor(r, n, s) {
+    super(pt(r, n, s));
+    l(this, "documentUrl");
+    l(this, "documentFormat");
+    l(this, "malformationDetails");
+    this.documentUrl = r, this.documentFormat = n, this.malformationDetails = s;
+  }
+}
+class wt 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 mt(e, t) {
+  return `Unauthorized${t === 403 ? " (Forbidden)" : ""}: ${e}`;
+}
+class I extends p {
+  constructor(r, n) {
+    super(mt(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 yt(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 Bt extends p {
+  constructor(r, n) {
+    super(yt(r, n));
+    l(this, "response");
+    this.response = n ?? r;
+  }
+}
+class gt 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 H = {
+  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 Ft(e, t) {
+  H[e] = t;
+}
+function f(e, t = {}) {
+  var s;
+  if (e.startsWith("http"))
+    return e;
+  const [r, n] = e.split(":");
+  if (r && n) {
+    const a = H[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 vt {
+  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 _ {
+  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 vt(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 bt = /* @__PURE__ */ ((e) => (e.Read = "read", e.Write = "write", e.Append = "append", e.Control = "control", e))(bt || {});
+class J extends _ {
+  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 = rt(n, new RegExp(`${r}="([^"]+)"`))) == null ? void 0 : a[1]) ?? "";
+    return k([
+      s.includes("read") && "read",
+      s.includes("write") && "write",
+      s.includes("append") && "append",
+      s.includes("control") && "control"
+      /* Control */
+    ]);
+  }
+}
+async function Ht(e) {
+  const t = await T.compact(e, {});
+  return "@graph" in t ? t : "@id" in t ? { "@graph": [t] } : { "@graph": [] };
+}
+function It(e) {
+  return "@graph" in e;
+}
+const P = "anonymous://", xt = P.length;
+async function Tt(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 wt(e, { cause: n });
+  }
+}
+function Rt(e) {
+  const t = e.slice(0), r = {}, n = v(e).flatMap((s, a) => M(
+    k([
+      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 = dt(
+      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 ft(u));
+      nt(
+        t,
+        i,
+        new ht(c.subject, i.predicate, c.object)
+      );
+    }
+  }
+  return t;
+}
+function G(e) {
+  return e.map((t) => "    " + Et(t)).sort().join(`
+`);
+}
+function Pt(e) {
+  var t;
+  (t = e["@id"]) != null && t.startsWith("#") && (e["@id"] = P + e["@id"]);
+}
+function jt(e) {
+  for (const t of e)
+    t.subject.value.startsWith(P) && (t.subject.value = t.subject.value.slice(xt));
+}
+async function $t(e, t, r) {
+  r = r ?? window.fetch.bind(window);
+  const n = await j(t);
+  return await r(e, {
+    method: "PUT",
+    headers: { "Content-Type": "text/turtle" },
+    body: t
+  }), new J(e, n, new Headers({}));
+}
+async function h(e, t) {
+  const { body: r, headers: n } = await Tt(e, t), s = await j(r, { baseIRI: e });
+  return new J(e, s, n);
+}
+async function qt(e, t) {
+  try {
+    return await h(e, t);
+  } catch (r) {
+    if (!(r instanceof b)) throw r;
+    return null;
+  }
+}
+async function At(e, t) {
+  if (It(e))
+    return (await Promise.all(e["@graph"].map((s) => At(s, t)))).flat();
+  Pt(e);
+  const r = await T.toRDF(e, { base: t });
+  return jt(r), r;
+}
+function _t(e) {
+  const t = St(e);
+  return Object.entries(t).reduce((r, [n, s]) => {
+    const a = G(s);
+    return r.concat(`${n.toUpperCase()} DATA {
+${a}
+}`);
+  }, []).join(` ;
+`);
+}
+function Jt(e) {
+  const t = V(e);
+  return G(t);
+}
+function Ct(e, t = {}) {
+  const r = y({ baseIRI: t.baseIRI }), n = new z(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 F(t.baseIRI ?? null, R.Turtle, i.message)
+        );
+        return;
+      }
+      if (!c) {
+        a(s);
+        return;
+      }
+      s.quads.push(c);
+    });
+  });
+}
+async function Gt(e) {
+  return {
+    "@graph": await T.fromRDF(e)
+  };
+}
+function Vt(e) {
+  return new B().quadsToString(e);
+}
+function Et(e) {
+  return new B().quadsToString([e]).slice(0, -1);
+}
+async function Ut(e, t) {
+  try {
+    return !(await h(e, t)).isEmpty();
+  } catch {
+    return !1;
+  }
+}
+async function Xt(e, t = {}) {
+  const r = L(e, /(\w+) DATA {([^}]+)}/g), n = {};
+  return await Promise.all(
+    [...r].map(async (s) => {
+      const a = s[1].toLowerCase(), u = s[2];
+      n[a] = await j(u, t);
+    })
+  ), n;
+}
+function St(e, t = {}) {
+  const r = L(e, /(\w+) DATA {([^}]+)}/g), n = {};
+  for (const s of r) {
+    const a = s[1].toLowerCase(), u = s[2];
+    n[a] = V(u, t);
+  }
+  return n;
+}
+async function j(e, t = {}) {
+  const { quads: r } = await Ct(e, t);
+  return r;
+}
+function V(e, t = {}) {
+  const r = y({ baseIRI: t.baseIRI }), n = new z(r);
+  try {
+    const s = n.parse(e);
+    return t.normalizeBlankNodes ? Rt(s) : s;
+  } catch (s) {
+    throw new F(
+      t.baseIRI ?? null,
+      R.Turtle,
+      s.message ?? ""
+    );
+  }
+}
+async function Dt(e, t, r) {
+  r = r ?? window.fetch.bind(window), await r(e, {
+    method: "PATCH",
+    headers: { "Content-Type": "application/sparql-update" },
+    body: t
+  });
+}
+async function Nt(e, t) {
+  var u;
+  const r = new _(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 N(e, t = {}) {
+  var $, q, A, C, E, U;
+  const r = {
+    fetch: t.fetch,
+    // Needed for CSS v7.1.3.
+    // See https://github.com/CommunitySolidServer/CommunitySolidServer/issues/1972
+    cache: "no-store"
+  }, n = at(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 Nt(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 = S(n);
+  for (; d && i.length === 0; ) {
+    const m = await Q(h(d, r));
+    if (m != null && m.isStorage()) {
+      i.push(d);
+      break;
+    }
+    d = S(d);
+  }
+  if (i.length === 0)
+    throw new Error(`Could not find any storage for ${e}.`);
+  return await (($ = t.onLoaded) == null ? void 0 : $.call(t, a)), {
+    webId: e,
+    cloaked: o,
+    writableProfileUrl: u,
+    storageUrls: ot(i),
+    ...y({
+      name: ((q = a.statement(e, "vcard:fn")) == null ? void 0 : q.object.value) ?? ((A = a.statement(e, "foaf:name")) == null ? void 0 : A.object.value),
+      avatarUrl: ((C = a.statement(e, "vcard:hasPhoto")) == null ? void 0 : C.object.value) ?? ((E = a.statement(e, "foaf:img")) == null ? void 0 : E.object.value),
+      oidcIssuerUrl: (U = a.statement(e, "solid:oidcIssuer")) == null ? void 0 : U.object.value,
+      publicTypeIndexUrl: c == null ? void 0 : c.object.value,
+      privateTypeIndexUrl: w == null ? void 0 : w.object.value
+    })
+  };
+}
+async function Yt(e, t = {}) {
+  if (t.required)
+    return N(e, t);
+  const r = Q((n) => N(n, t));
+  return await r(e) ?? await r(e.replace(/\/$/, "").concat("/profile/card#me")) ?? await r(st(e).concat("/profile/card#me"));
+}
+function kt(e) {
+  return !e.path || !e.path.startsWith("/") ? null : e.path.match(/^\/[^/]*$/) ? "/" : `/${v(e.path.split("/")).filter().slice(0, -1).join("/")}/`.replace("//", "/");
+}
+function Lt(e) {
+  const t = kt(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"] ?? O();
+    for (const t of Object.values(e))
+      D(t) && x(t), ut(t) && t.forEach((r) => D(r) && x(r));
+  }
+}
+function Kt(e) {
+  return M(it(e), (t) => x(t));
+}
+function Zt(e) {
+  const t = ct(e);
+  return t ? y({
+    containerUrl: Lt(t),
+    documentName: t.path ? t.path.split("/").pop() : null,
+    resourceHash: t.fragment
+  }) : {};
+}
+async function Mt(e, t, r) {
+  r = r ?? window.fetch.bind(r);
+  const n = e.storageUrls[0], s = `${n}settings/${t}TypeIndex`;
+  return await Ut(s, { fetch: r }) ? `${n}settings/${t}TypeIndex-${O()}` : s;
+}
+async function X(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 Mt(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 $t(n, s, r), await Dt(e.writableProfileUrl, a, r), n;
+}
+async function Y(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 te(e, t) {
+  return X(e, "public", t);
+}
+async function ee(e, t) {
+  return X(e, "private", t);
+}
+async function re(e, t, r) {
+  return Y(e, t, "solid:instanceContainer", r);
+}
+async function ne(e, t, r) {
+  return Y(e, t, "solid:instance", r);
+}
+async function K(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 lt(W(e), s);
+}
+async function Z(e, t, r) {
+  r = r ?? await K(e, t);
+  const n = await qt(r ?? "", { fetch: t });
+  if (!n)
+    return Z(W(e), t);
+  if (n.isACPResource())
+    throw new gt(e, "ACP");
+  return n;
+}
+async function se(e, t) {
+  const r = await K(e, t), n = await Z(e, t, r);
+  return y({
+    url: r,
+    effectiveUrl: n.url,
+    document: n
+  });
+}
+export {
+  F as MalformedSolidDocumentError,
+  wt as NetworkRequestError,
+  b as NotFoundError,
+  J as SolidDocument,
+  R as SolidDocumentFormat,
+  bt as SolidDocumentPermission,
+  _ as SolidStore,
+  vt as SolidThing,
+  I as UnauthorizedError,
+  Bt as UnsuccessfulNetworkRequestError,
+  gt as UnsupportedAuthorizationProtocolError,
+  Ht as compactJsonLDGraph,
+  ee as createPrivateTypeIndex,
+  te as createPublicTypeIndex,
+  $t as createSolidDocument,
+  Ft as defineIRIPrefix,
+  f as expandIRI,
+  Yt as fetchLoginUserProfile,
+  h as fetchSolidDocument,
+  se as fetchSolidDocumentACL,
+  qt as fetchSolidDocumentIfFound,
+  re as findContainerRegistrations,
+  ne as findInstanceRegistrations,
+  It as isJsonLDGraph,
+  At as jsonldToQuads,
+  Kt as mintJsonLDIdentifiers,
+  _t as normalizeSparql,
+  Jt as normalizeTurtle,
+  Zt as parseResourceSubject,
+  Ct as parseTurtle,
+  Et as quadToTurtle,
+  Gt as quadsToJsonLD,
+  Vt as quadsToTurtle,
+  Ut as solidDocumentExists,
+  Xt as sparqlToQuads,
+  St as sparqlToQuadsSync,
+  j as turtleToQuads,
+  V as turtleToQuadsSync,
+  Dt as updateSolidDocument
+};
+//# sourceMappingURL=noeldemartin-solid-utils.js.map