@piveau/dpi 0.2.0-alpha.6 → 0.2.0-alpha.8

package/dist/packages/dpi/src/data-provider-interface/composables/project-transformer/encodeProject.js

@@ -0,0 +1,330 @@
+import { pipe as s } from "effect";
+import * as n from "effect/Option";
+import { theProjectForm as C } from "./__tests__/fixtures/theProjectForm.js";
+import { PREFIXES as F } from "./shared.js";
+function Q(e, i) {
+  if (e)
+    return {
+      "@value": e,
+      "@type": i
+    };
+}
+function $(e) {
+  return (e ?? []).map((t) => {
+    var r, o;
+    return { name: (r = t.name) == null ? void 0 : r.trim(), url: (o = t.url) == null ? void 0 : o.trim() };
+  }).filter((t) => !!t.name && t.name.length > 0).map((t) => ({
+    "foaf:name": t.name,
+    ...t.url && t.url.length > 0 ? { "foaf:homepage": t.url } : {}
+  }));
+}
+function H(e, i) {
+  return e ? [{ "@value": e, "@language": i }] : void 0;
+}
+function X(e) {
+  return (i) => H(i, e);
+}
+function A(e) {
+  if (e)
+    return {
+      "@id": e
+    };
+}
+function U(e) {
+  return e != null;
+}
+function Z(e, i = "http://www.w3.org/2001/XMLSchema#string") {
+  return s(
+    n.fromNullable(e),
+    n.map((t) => t.trim()),
+    n.filter((t) => t.length > 0),
+    n.flatMap((t) => n.fromNullable(Q(t, i)))
+  );
+}
+const B = (e) => (e ?? "").trim(), q = (e) => e.length > 0;
+function m(e) {
+  return s(
+    n.fromNullable(e ?? void 0),
+    n.map(B),
+    n.filter(q)
+  );
+}
+function J(e) {
+  return s(
+    n.fromNullable(e),
+    n.map((i) => i.map(B).filter(q)),
+    n.filter((i) => i.length > 0),
+    n.map((i) => [...i])
+  );
+}
+function G(e) {
+  return s(
+    n.fromNullable(e),
+    n.map((i) => i.map((t) => A(t)).filter(U)),
+    n.filter((i) => i.length > 0),
+    n.map((i) => [...i])
+  );
+}
+function R(e, i) {
+  return s(
+    m(e),
+    n.flatMap((t) => n.fromNullable(i(t)))
+  );
+}
+function Y(e) {
+  return L(e).flatMap((i) => [...i]);
+}
+function V(e, i, t) {
+  return s(
+    n.fromNullable(e),
+    n.map((r) => r.map(i).filter(U)),
+    n.filter((r) => r.length > 0),
+    n.map((r) => M(r, t)),
+    n.filter((r) => r.length > 0),
+    n.map((r) => [...r])
+  );
+}
+function I(e) {
+  if (e == null || typeof e != "object")
+    return e;
+  if (Array.isArray(e))
+    return e.map((r) => I(r)).filter((r) => r != null);
+  const i = {};
+  for (const [t, r] of Object.entries(e)) {
+    if (r == null)
+      continue;
+    const o = I(r);
+    o != null && (i[t] = o);
+  }
+  return i;
+}
+function L(e) {
+  return e.map(n.getOrUndefined).filter(U);
+}
+function c(e) {
+  const i = e ? [...e] : [];
+  return i.length > 0 ? i : void 0;
+}
+function ee(e, i) {
+  const t = e ?? {}, r = [];
+  for (const [o, a] of Object.entries(i)) {
+    const f = s(
+      n.fromNullable(t[o]),
+      n.map((u) => u.trim()),
+      n.filter((u) => u.length > 0),
+      n.map((u) => ({
+        "@type": "schema:Question",
+        "schema:text": a,
+        "schema:acceptedAnswer": u
+      })),
+      n.getOrUndefined
+    );
+    f && r.push(f);
+  }
+  return r;
+}
+function D(e, i, t) {
+  const r = ee(e, t);
+  return r.length === 0 ? n.none() : n.some({
+    "@type": "schema:QAPage",
+    "dct:type": i,
+    "schema:question": r
+  });
+}
+function ne(e) {
+  return (e ?? []).map((t) => {
+    var r, o;
+    return { name: (r = t.name) == null ? void 0 : r.trim(), description: (o = t.description) == null ? void 0 : o.trim() };
+  }).filter((t) => !!t.name && t.name.length > 0 && !!t.description && t.description.length > 0).map((t) => ({
+    "@type": "prov:used",
+    "dct:title": t.name,
+    "dct:description": t.description
+  }));
+}
+function M(e, i) {
+  return (e ?? []).map((r) => ({
+    "@type": "rdfs:Resource",
+    "dct:type": i,
+    "schema:url": r.url,
+    "dct:title": r.name,
+    "dct:description": s(
+      n.fromNullable(r.description),
+      n.map((o) => o.trim()),
+      n.filter((o) => o.length > 0),
+      n.getOrUndefined
+    )
+  }));
+}
+function te(e) {
+  return (e ?? []).map((t) => ({
+    "@type": "pv:SoftwareLink",
+    "dct:identifier": t.id,
+    "schema:featureList": c((t.functionalities ?? []).map((r) => r == null ? void 0 : r.trim()).filter((r) => !!r && r.length > 0))
+  }));
+}
+function re(e) {
+  return (e ?? []).map((t) => ({
+    "@type": "dcat:Dataset",
+    "dct:identifier": t.id
+  }));
+}
+function ie(e, i) {
+  return (e ?? []).map((r) => {
+    var o;
+    return {
+      "@type": "ssn:Deployment",
+      "dct:identifier": "__TODO__",
+      "dct:description": s(
+        n.fromNullable(r.description),
+        n.map((a) => a.trim()),
+        n.filter((a) => a.length > 0),
+        n.flatMap((a) => n.fromNullable(i(a))),
+        n.getOrUndefined
+      ),
+      "ssn:deployedSystem": A(r.id),
+      "ssn:forProperty": c((r.forProperty ?? []).map((a) => a == null ? void 0 : a.trim()).filter((a) => !!a && a.length > 0)),
+      "sosa:hasLocation": c((r.locations ?? []).map((a) => ({
+        "@type": "dct:Location",
+        "geo:lat": a.lat,
+        "geo:long": a.lng
+      }))),
+      "foaf:depiction": c((r.depictions ?? []).map((a) => A(a)).filter(U)),
+      // Corresponds to functionalities of hardware;
+      // not to be confused with functionalities of software (schema:featureList)
+      "ssn-system:hasSystemCapability": c((r.functionalities ?? []).map((a) => a == null ? void 0 : a.trim()).filter((a) => !!a && a.length > 0)),
+      "dct:references": c(M((o = r.references) == null ? void 0 : o.map((a) => ({
+        name: a.name ?? "",
+        url: a.url ?? "",
+        description: a.description
+      })).filter((a) => a.url.length > 0 && ((a == null ? void 0 : a.name) || "").length > 0), "documentation"))
+    };
+  });
+}
+function P(e) {
+  var h, b, y;
+  const { prefixKey: i, activityLabel: t, input: r, toLanged: o } = e, a = `${i}/Grundlegende Informationen`, f = `${i}/Software`, u = `${i}/Datensätze`, j = `${i}/Hardware`, d = r[a], N = d == null ? void 0 : d.description, x = s(
+    n.fromNullable(N),
+    n.map((g) => g.trim()),
+    n.filter((g) => g.length > 0),
+    n.getOrUndefined
+  ), W = d == null ? void 0 : d.methods, z = d == null ? void 0 : d.links, v = (h = r[f]) == null ? void 0 : h.selected, w = (b = r[u]) == null ? void 0 : b.selected, S = (y = r[j]) == null ? void 0 : y.selected, p = [
+    ...te(v),
+    ...re(w),
+    ...ie(S, o)
+  ], k = {
+    "@type": "p-plan:Step",
+    "dct:identifier": "__TODO__",
+    "p-plan:Activity": t,
+    "dct:description": o(x ?? ""),
+    "prov:used": c(ne(W)),
+    "dct:references": c(M(z, "documentation")),
+    "p-plan:hasInputVar": p.length > 0 ? p : void 0
+  };
+  return n.some(k);
+}
+function ae(e, i) {
+  var v, w, S, p, k, h, b, y, g, K, T, _, E;
+  const t = {
+    "@type": "schema:Project"
+  }, r = (i == null ? void 0 : i.language) ?? "de", o = X(r);
+  t["dct:title"] = s(R((v = e["Grundlegende Informationen/Name"]) == null ? void 0 : v.projectName, o), n.getOrUndefined), t["dct:description"] = s(R((w = e["Grundlegende Informationen/Beschreibung"]) == null ? void 0 : w.projectDescription, o), n.getOrUndefined), t["dct:identifier"] = ["__TODO__"], t["dcat:theme"] = s(G((S = e["Auffindbarkeit/Kategorien"]) == null ? void 0 : S.categories), n.getOrUndefined), t["schema:application"] = s(G((p = e["Auffindbarkeit/Anwendungsbereiche"]) == null ? void 0 : p.applications), n.getOrUndefined), t["schema:status"] = s(m((k = e["Grundlegende Informationen/Projektstatus"]) == null ? void 0 : k.projectName), n.getOrUndefined), t["schema:amount"] = s(
+    Z((h = e["Optionale Daten"]) == null ? void 0 : h.budget, "http://www.w3.org/2001/XMLSchema#integer"),
+    n.map((l) => ({
+      "@type": "schema:MonetaryAmount",
+      "schema:currency": "EUR",
+      "schema:value": l
+    })),
+    n.getOrUndefined
+  ), t["schema:skills"] = s(J((b = e["Optionale Daten"]) == null ? void 0 : b.requiredExpertise), n.getOrUndefined), t["schema:startDate"] = s(m((y = e["Optionale Daten"]) == null ? void 0 : y.startDate), n.getOrUndefined), t["schema:endDate"] = s(m((g = e["Optionale Daten"]) == null ? void 0 : g.endDate), n.getOrUndefined);
+  const a = [
+    V(
+      (K = e["Optionale Daten"]) == null ? void 0 : K.links,
+      (l) => {
+        const O = s(m(l.url), n.getOrUndefined);
+        if (O)
+          return {
+            url: O,
+            name: s(m(l.name), n.getOrUndefined),
+            description: s(m(l.description), n.getOrUndefined)
+          };
+      },
+      "documentation"
+    ),
+    V(
+      (T = e["Optionale Daten"]) == null ? void 0 : T.references,
+      (l) => {
+        const O = s(m(l.homepage), n.getOrUndefined);
+        if (O)
+          return {
+            url: O,
+            name: void 0,
+            description: void 0
+          };
+      },
+      "image"
+    )
+  ], f = Y(a);
+  t["dct:references"] = f.length > 0 ? f : void 0, t["dcat:contactPoint"] = s(
+    n.fromNullable((_ = e["Grundlegende Informationen/Organisation"]) == null ? void 0 : _.contact),
+    n.map((l) => ({
+      "@type": "vcard:Kind",
+      "vcard:fn": l.name,
+      "vcard:hasEmail": l.mail,
+      "vcard:hasTelephone": l.phone
+    })),
+    n.map((l) => [l]),
+    n.getOrUndefined
+  ), t["dct:contributor"] = s(
+    n.fromNullable((E = e["Optionale Daten"]) == null ? void 0 : E.partners),
+    n.map((l) => $(l)),
+    n.filter((l) => l.length > 0),
+    n.getOrUndefined
+  );
+  const u = {
+    projectTriggers: "Was waren Ausloeser fuer das Projekt (z. B. rechtliche oder politische Vorgaben, intrinsische Motivation oder inspirierende Projekte aus anderen Kommunen)?",
+    involvedStakeholders: "Welche relevanten Akteure innerhalb oder ausserhalb Ihrer Organisation haben Sie fruehzeitig involviert (z. B. um politische Rueckendeckung sicherzustellen)?",
+    dataCollectionMethod: "Wie haben Sie den Bestand vorhandener Daten erhoben?",
+    budgetPlanning: "Wie haben Sie das erste Budget berechnet und nachhaltig gesichert?"
+  }, j = {
+    requirementsGatherings: "Wie haben Sie die Anforderungen erhoben und dokumentiert (z. B. durch Markterkundung, externe Berater oder Workshops)?",
+    tenderFormat: "Welche Ausschreibungsform haben Sie gewaehlt und warum? Gab es eine Vorlage oder Muster-Leistungsbeschreibung, die hilfreich war?",
+    tenderTips: "Welche Tipps haben Sie fuer eine erfolgreiche Ausschreibung?",
+    resourcePlanning: "Wie haben Sie die Ressourcenplanung fuer die Entwicklung und den Betrieb Ihres Digitalen Zwillings gestaltet und gesichert?"
+  }, d = {
+    projectTriggers: "Wie haben Sie die Zusammenarbeit mit den Dienstleistern organisiert und wie wurden relevante Stakeholder in Entscheidungsprozesse eingebunden?",
+    involvedStakeholders: "Gab es Verzoegerungen und wenn ja, was waren die Gruende?",
+    dataCollectionMethod: "Welche Schnittstellen wurden genutzt und traten technische Herausforderungen auf?",
+    budgetPlanning: "Welche Ueberlegungen sind in Ihre Entscheidung fuer eine Open-Source-Loesung eingeflossen und welche Erfahrungen haben Sie gemacht?"
+  }, N = {
+    projectTriggers: "Was sind Ihre wichtigsten Learnings aus dem Projekt? Was wuerden Sie beim naechsten Use Case anders machen?",
+    involvedStakeholders: "Wird die Wirksamkeit Ihres Projekts ueberwacht und wenn ja, wie? Ist der erwartete Nutzen eingetreten?",
+    dataCollectionMethod: "Gibt es Plaene fuer eine Skalierung oder Weiterentwicklung? Wenn ja, wie sichern Sie die Finanzierung dafuer?",
+    budgetPlanning: "Welche externen Unterstuetzungsangebote haben Ihnen geholfen oder auch gefehlt?"
+  }, x = L([
+    D(e["Projektphasen (optional)/Initiieren"], "Initiieren", u),
+    D(e["Projektphasen (optional)/Planen"], "Planen", j),
+    D(e["Projektphasen (optional)/Umsetzen"], "Umsetzen", d),
+    D(e["Projektphasen (optional)/Weiterdenken"], "Weiterdenken", N)
+  ]);
+  t["schema:hasPart"] = c(x);
+  const W = L([
+    P({ prefixKey: "1. Datenerfassung", activityLabel: "Data collection", input: e, toLanged: o }),
+    P({ prefixKey: "2. Datenverarbeitung", activityLabel: "Processing", input: e, toLanged: o }),
+    P({ prefixKey: "3. Datensimulation", activityLabel: "Simulation", input: e, toLanged: o }),
+    P({ prefixKey: "4. Datenvisualisierung", activityLabel: "Visualization", input: e, toLanged: o })
+  ]);
+  return t["p-plan:hasStep"] = c(W), {
+    "@context": {
+      ...F
+    },
+    "@graph": I(t)
+  };
+}
+console.log(JSON.stringify(ae(C), null, 2));
+export {
+  ae as encodeProject,
+  U as isNonNullable,
+  H as toLangedValue,
+  A as toNodeReference,
+  Q as toTypedValue
+};

package/dist/packages/dpi/src/data-provider-interface/composables/project-transformer/shared.js

@@ -0,0 +1,37 @@
+import { pipe as s } from "effect";
+import * as w from "effect/Option";
+const p = {
+  dcat: "http://www.w3.org/ns/dcat#",
+  dcatap: "http://data.europa.eu/r5r/",
+  dct: "http://purl.org/dc/terms/",
+  ex: "http://example.org/",
+  foaf: "http://xmlns.com/foaf/0.1/",
+  geo: "http://www.w3.org/2003/01/geo/wgs84_pos#",
+  lcon: "http://www.w3.org/ns/locn#",
+  owl: "http://www.w3.org/2002/07/owl#",
+  "p-plan": "http://www.opmw.org/model/p-plan/",
+  prov: "http://www.w3.org/ns/prov#",
+  pv: "https://piveau.eu/ns/voc#",
+  rdf: "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
+  rdfs: "http://www.w3.org/2000/01/rdf-schema#",
+  schema: "https://schema.org/",
+  sh: "http://www.w3.org/ns/shacl#",
+  skos: "http://www.w3.org/2004/02/skos/core#",
+  sosa: "http://www.w3.org/ns/sosa/",
+  ssn: "http://www.w3.org/ns/ssn/",
+  "ssn-system": "http://www.w3.org/ns/ssn/systems/",
+  vcard: "http://www.w3.org/2006/vcard/ns#",
+  xsd: "http://www.w3.org/2001/XMLSchema#"
+};
+function n(o) {
+  return s(
+    w.fromNullable(o),
+    w.map((t) => t.trim()),
+    w.filter((t) => t.length > 0),
+    w.getOrUndefined
+  );
+}
+export {
+  p as PREFIXES,
+  n as nonEmpty
+};

package/dist/packages/dpi/src/data-provider-interface/schema/projectLdSchema.js

@@ -0,0 +1,114 @@
+import { schemaDateField as s, takeFirst as e, schemaFoafAgent as i, schemaContactPoint as p, schemaIriString as o, schemaLanguageContainer as a, schemaTypedLiteral as c } from "@piveau/jsonld";
+import * as t from "zod/v4";
+const r = t.object({
+  "@id": t.string().optional(),
+  "@type": t.string().optional(),
+  "dct:type": t.preprocess(e, t.string().optional()),
+  "schema:url": t.preprocess(e, t.string().optional()),
+  "dct:title": t.preprocess(e, t.string().optional()),
+  "dct:description": t.preprocess(e, t.string().optional())
+}), l = t.object({
+  "dct:title": t.preprocess(e, t.string().optional()),
+  "dct:description": t.preprocess(e, t.string().optional())
+}), n = t.object({
+  "@type": t.preprocess(e, t.string().optional())
+}), d = n.extend({
+  "@type": t.literal("pv:SoftwareLink"),
+  "dct:identifier": t.preprocess(e, t.string().optional()),
+  "schema:featureList": t.array(t.string()).optional()
+}), y = n.extend({
+  "@type": t.literal("dcat:Dataset"),
+  "dct:identifier": t.preprocess(e, t.string().optional())
+}), m = t.object({
+  "@type": t.string().optional(),
+  "geo:lat": t.preprocess(e, t.string().optional()),
+  "geo:long": t.preprocess(e, t.string().optional())
+}), g = n.extend({
+  "@type": t.literal("ssn:Deployment"),
+  "dct:description": t.array(a).optional(),
+  "ssn:deployedSystem": t.preprocess(e, o.optional()),
+  /**
+   * The purpose of the hardware instance ("Zwecke")
+   */
+  "ssn:forProperty": t.array(t.string()).optional(),
+  "sosa:hasLocation": t.array(m).optional(),
+  "foaf:depiction": t.array(o).optional(),
+  "dct:references": t.array(r).optional(),
+  /**
+   * Corresponds to functionalities of hardware;
+   * not to be confused with schema:featureList of software
+   */
+  "ssn-system:hasSystemCapability": t.array(t.string()).optional()
+}), h = t.discriminatedUnion("@type", [
+  d,
+  y,
+  g
+]), f = t.object({
+  "@type": t.string(),
+  "schema:text": t.preprocess(e, t.string().optional()),
+  "schema:acceptedAnswer": t.preprocess(e, t.string().optional())
+}), j = t.object({
+  "@type": t.string(),
+  "dct:identifier": t.preprocess(e, t.string().optional()),
+  "dct:type": t.preprocess(e, t.string().optional()),
+  "schema:question": t.array(f).optional(),
+  "p-plan:isPrecededBy": t.preprocess(e, o.optional()),
+  "dct:references": t.array(r).optional()
+}), u = t.object({
+  "@type": t.string(),
+  "dct:identifier": t.preprocess(e, t.string().optional()),
+  "p-plan:Activity": t.preprocess(e, t.string().optional()),
+  "dct:description": t.array(a).optional(),
+  "schema:about": t.array(t.string()).optional(),
+  "p-plan:isPrecededBy": t.preprocess(e, o.optional()),
+  "prov:used": t.array(l).optional(),
+  "p-plan:hasInputVar": t.array(h).optional(),
+  "dct:references": t.array(r).optional()
+}), P = t.object({
+  "@type": t.string(),
+  "schema:currency": t.preprocess(e, t.string().optional()),
+  "schema:value": t.preprocess(e, c.optional())
+}), L = t.object({
+  "@id": t.string().optional(),
+  "@type": t.string(),
+  // Core identifiers and labels
+  "dct:identifier": t.array(t.string()).optional(),
+  "dct:title": t.array(a).optional(),
+  "dct:description": t.array(a).optional(),
+  // Themes/categories as simple IRI nodes
+  "dcat:theme": t.array(o).optional(),
+  // Applications and status as literals
+  "schema:application": t.array(o).optional(),
+  "schema:status": t.preprocess(e, t.string().optional()),
+  // Optional dates (date/dateTime)
+  "schema:startDate": s,
+  "schema:endDate": s,
+  // Optional skills (literals)
+  "schema:skills": t.array(t.string()).optional(),
+  // Contact and partners
+  "dcat:contactPoint": t.array(p).optional(),
+  "dct:contributor": t.array(i).optional(),
+  // Optional budget
+  "schema:amount": t.preprocess(e, P.optional()),
+  // Organizational and technical steps
+  "schema:hasPart": t.array(j).optional(),
+  "p-plan:hasStep": t.array(u).optional(),
+  // References and last modified
+  "dct:references": t.array(r).optional(),
+  "prov:generatedAtTime": s
+});
+export {
+  y as schemaDatasetLink,
+  g as schemaHardwareInstance,
+  m as schemaHardwareLocation,
+  L as schemaProject,
+  h as schemaProjectInputLink,
+  n as schemaProjectInputLinkBase,
+  l as schemaProjectMethodsUsed,
+  P as schemaProjectMonetaryAmount,
+  j as schemaProjectQAPage,
+  f as schemaProjectQuestionAnswer,
+  r as schemaProjectResource,
+  u as schemaProjectTechnicalStep,
+  d as schemaSoftwareLink
+};