@startinblox/components-ds4go 3.0.2 → 3.1.0

package/src/helpers/mappings/dsp-mapping-config.ts

@@ -1,545 +0,0 @@
-/**
- * DSP (Dataspace Protocol) Mapping Configuration
- *
- * Defines how DSP catalog datasets are mapped to TEMS-compatible resources.
- *
- * Source structure (simplified):
- * {
- *   '@id': 'urn:uuid:dataset-id',
- *   'dcat:distribution': [{
- *     'dct:title': 'Dataset Name',
- *     'dct:description': 'Description',
- *     'dcat:keyword': ['keyword1', 'keyword2'],
- *     'dcat:endpointURL': 'https://service.com/endpoint',
- *     'foaf:thumbnail': { 'rdf:resource': 'https://image.com/logo.png' },
- *     'dcterms:creator': {
- *       'foaf:name': 'Creator Name',
- *       'foaf:thumbnail': { 'rdf:resource': 'https://creator.com/logo.png' }
- *     }
- *   }],
- *   'odrl:hasPolicy': { ... }
- * }
- *
- * Note: Properties can be at dataset level OR in dcat:distribution[0]
- */
-
-import {
-  type MappingContext,
-  processPolicyTransform,
-  type ResourceMapperConfig,
-  stripUrnPrefix,
-} from "@helpers/components/ResourceMapper";
-
-/**
- * Get properties from dataset, checking distribution first, then dataset level, then EDC properties
- */
-function getProperties(source: any): any {
-  return source["dcat:distribution"]?.[0] || source["properties"] || source;
-}
-
-/**
- * Get EDC-style endpoint URL from properties
- * Priority: source-level dcat:endpointUrl (actual data endpoint) first
- */
-function getEndpointUrl(source: any): string {
-  const props = getProperties(source);
-  // Check source-level first (EDC catalog returns actual endpoint at top level)
-  return (
-    source["dcat:endpointUrl"] ||
-    source["dcat:endpointURL"] ||
-    source["http://www.w3.org/ns/dcat#endpointUrl"] ||
-    source["endpointUrl"] ||
-    source["endpointURL"] ||
-    // Then check distribution/props level
-    props["http://www.w3.org/ns/dcat#endpointUrl"] ||
-    props["dcat:endpointUrl"] ||
-    props["dcat:endpointURL"] ||
-    props["dcat:accessService"]?.["dcat:endpointURL"] ||
-    props["endpointURL"] ||
-    props["endpointUrl"] ||
-    ""
-  );
-}
-
-/**
- * Get content type from EDC properties
- * Priority: source-level fields first
- */
-function getContentType(source: any): string {
-  const props = getProperties(source);
-  // Check source-level first (EDC catalog returns these at top level)
-  return (
-    source["contenttype"] ||
-    source["contentType"] ||
-    source["http://www.w3.org/ns/dcat#mediaType"] ||
-    source["dcat:mediaType"] ||
-    // Then check distribution/props level
-    props["contenttype"] ||
-    props["contentType"] ||
-    props["http://www.w3.org/ns/dcat#mediaType"] ||
-    props["dcat:mediaType"] ||
-    ""
-  );
-}
-
-/**
- * Get field with multiple fallback paths
- */
-// function getFieldWithFallbacks(source: any, paths: string[][]): any {
-//   for (const path of paths) {
-//     const value = getNestedValue(source, path);
-//     if (value !== undefined && value !== null && value !== "") {
-//       return value;
-//     }
-//   }
-//   return undefined;
-// }
-
-export const dspMappingConfig: ResourceMapperConfig = {
-  baseFields: {
-    "@id": {
-      source: ["@id"],
-      transform: (value, source, context: MappingContext) => {
-        const stripped = stripUrnPrefix(value || source["id"] || "");
-        const slug = stripped || value?.split("/").pop() || "unknown";
-        // Include providerParticipantId in the @id to make it unique per provider
-        // This prevents collision when different providers have assets with the same ID
-        const providerPrefix = context.providerParticipantId
-          ? `${encodeURIComponent(context.providerParticipantId)}/`
-          : "";
-        // FIXME: Avoid magic strings
-        return `${context.temsServiceBase || "https://api.tems.example.com/services/"}${providerPrefix}${encodeURIComponent(slug)}/`;
-      },
-    },
-    "@type": {
-      source: [],
-      defaultValue: "tems:Service",
-    },
-    name: {
-      source: [],
-      transform: (_, source) => {
-        const props = getProperties(source);
-        // Check multiple possible locations for the asset name
-        // Priority: source-level fields > DCAT/DCTERMS fields > EDC namespace fields > id fields
-        return (
-          // Source-level fields (EDC catalog returns these at top level)
-          source["name"] ||
-          source["title"] ||
-          source["dct:title"] ||
-          source["dcterms:title"] ||
-          // EDC namespace fields at source level
-          source["https://w3id.org/edc/v0.0.1/ns/name"] ||
-          source["edc:name"] ||
-          // Distribution/props level
-          props["dct:title"] ||
-          props["dcterms:title"] ||
-          props["title"] ||
-          props["https://w3id.org/edc/v0.0.1/ns/name"] ||
-          props["edc:name"] ||
-          props["name"] ||
-          // Fall back to ID but extract meaningful part
-          (source["@id"]?.startsWith("urn:uuid:")
-            ? source["@id"]
-            : source["@id"]?.split("/").pop() || source["@id"]) ||
-          source["id"] ||
-          ""
-        );
-      },
-    },
-    description: {
-      source: [],
-      transform: (_, source) => {
-        const props = getProperties(source);
-        // Check multiple possible locations for description
-        // Priority: source-level fields first
-        return (
-          // Source-level fields (EDC catalog returns these at top level)
-          source["description"] ||
-          source["dct:description"] ||
-          source["dcterms:description"] ||
-          source["https://w3id.org/edc/v0.0.1/ns/description"] ||
-          source["edc:description"] ||
-          // Distribution/props level
-          props["dct:description"] ||
-          props["dcterms:description"] ||
-          props["description"] ||
-          props["https://w3id.org/edc/v0.0.1/ns/description"] ||
-          props["edc:description"] ||
-          ""
-        );
-      },
-    },
-    long_description: {
-      source: [],
-      transform: (_, source) => {
-        const props = getProperties(source);
-        const keywords = Array.isArray(props["dcat:keyword"])
-          ? props["dcat:keyword"]
-          : props["dcat:keyword"]
-            ? [props["dcat:keyword"]]
-            : [];
-        const description =
-          props["dct:description"] ||
-          props["dcterms:description"] ||
-          props["description"] ||
-          "";
-        return keywords.length > 0
-          ? `Keywords: ${keywords.join(", ")}`
-          : description;
-      },
-    },
-    url: {
-      source: [],
-      transform: (_, source) => getEndpointUrl(source),
-    },
-    endpointUrl: {
-      source: [],
-      transform: (_, source) => getEndpointUrl(source),
-    },
-    contentType: {
-      source: [],
-      transform: (_, source) => getContentType(source),
-    },
-    activation_status: {
-      source: [],
-      transform: (_, source) => {
-        const props = getProperties(source);
-        const endpointURL =
-          props["dcat:endpointURL"] ||
-          props["dcat:accessService"]?.["dcat:endpointURL"] ||
-          props["endpointURL"] ||
-          "";
-        return endpointURL.trim().length > 0;
-      },
-    },
-    is_in_app: {
-      source: [],
-      transform: (_, source) => {
-        const props = getProperties(source);
-        const endpointURL =
-          props["dcat:endpointURL"] ||
-          props["dcat:accessService"]?.["dcat:endpointURL"] ||
-          props["endpointURL"] ||
-          "";
-        return endpointURL.trim().length > 0;
-      },
-    },
-    is_external: {
-      source: [],
-      transform: (_, source) => {
-        const props = getProperties(source);
-        const endpointURL =
-          props["dcat:endpointURL"] ||
-          props["dcat:accessService"]?.["dcat:endpointURL"] ||
-          props["endpointURL"] ||
-          "";
-        return endpointURL.trim().length > 0;
-      },
-    },
-    is_api: {
-      source: [],
-      transform: (_, source) => {
-        const props = getProperties(source);
-        const endpointURL =
-          props["dcat:endpointURL"] ||
-          props["dcat:accessService"]?.["dcat:endpointURL"] ||
-          props["endpointURL"] ||
-          "";
-        return endpointURL.trim().length > 0;
-      },
-    },
-    contact_url: {
-      source: [],
-      transform: (_, source) => {
-        const props = getProperties(source);
-        return (
-          props["dcat:endpointDescription"] || props["dct:conformsTo"] || ""
-        );
-      },
-    },
-    documentation_url: {
-      source: [],
-      transform: (_, source) => {
-        const props = getProperties(source);
-        return (
-          props["dcat:endpointDescription"] || props["dct:conformsTo"] || ""
-        );
-      },
-    },
-    creation_date: {
-      source: [],
-      transform: (_, source) => {
-        const props = getProperties(source);
-        return (
-          props["dct:issued"] ||
-          props["dcterms:issued"] ||
-          new Date().toISOString()
-        );
-      },
-    },
-    update_date: {
-      source: [],
-      transform: (_, source) => {
-        const props = getProperties(source);
-        const creationDate =
-          props["dct:issued"] ||
-          props["dcterms:issued"] ||
-          new Date().toISOString();
-        return (
-          props["dct:modified"] || props["dcterms:modified"] || creationDate
-        );
-      },
-    },
-    release_date: {
-      source: [],
-      transform: (_, source) => {
-        const props = getProperties(source);
-        return (
-          props["dct:issued"] ||
-          props["dcterms:issued"] ||
-          new Date().toISOString()
-        );
-      },
-    },
-    last_update: {
-      source: [],
-      transform: (_, source) => {
-        const props = getProperties(source);
-        const creationDate =
-          props["dct:issued"] ||
-          props["dcterms:issued"] ||
-          new Date().toISOString();
-        return (
-          props["dct:modified"] || props["dcterms:modified"] || creationDate
-        );
-      },
-    },
-    activation_date: {
-      source: [],
-      defaultValue: null,
-    },
-    licence: {
-      source: [],
-      defaultValue: null,
-    },
-    developper: {
-      source: [],
-      defaultValue: null,
-    },
-    data_offers: {
-      source: [],
-      defaultValue: [],
-    },
-  },
-
-  containerFields: {
-    categories: {
-      source: [],
-      containerType: "ldp:Container",
-      itemType: "tems:Category",
-      transform: (_, source) => {
-        const props = getProperties(source);
-        const keywords = props["dcat:keyword"];
-        if (!keywords) return [];
-        return Array.isArray(keywords) ? keywords : [keywords];
-      },
-      itemFields: {
-        "@id": (kw, _index, context) =>
-          `${context.temsCategoryBase || "https://api.tems.example.com/categories/"}${encodeURIComponent(kw)}/`,
-        name: (kw) => kw,
-      },
-    },
-    images: {
-      source: [],
-      containerType: "ldp:Container",
-      itemType: "tems:Image",
-      transform: (_, source) => {
-        const props = getProperties(source);
-        const imageUrls: string[] = [];
-
-        // Check for thumbnail in properties
-        if (props["foaf:thumbnail"]?.["rdf:resource"]) {
-          imageUrls.push(props["foaf:thumbnail"]["rdf:resource"]);
-        }
-
-        // Check for creator thumbnail
-        if (props["dcterms:creator"]?.["foaf:thumbnail"]?.["rdf:resource"]) {
-          imageUrls.push(
-            props["dcterms:creator"]["foaf:thumbnail"]["rdf:resource"],
-          );
-        }
-
-        return imageUrls;
-      },
-      itemFields: {
-        "@id": (url, index, context) => {
-          const filename = url.split("/").pop() || `image-${index}`;
-          // FIXME: Avoid magic strings
-          return `${context.temsImageBase || "https://api.tems.example.com/images/"}${encodeURIComponent(filename)}/`;
-        },
-        url: (url) => url,
-        iframe: () => false,
-        name: (url) => url.split("/").pop() || "image",
-      },
-    },
-  },
-
-  nestedObjects: {
-    provider: {
-      source: [],
-      type: "tems:Provider",
-      fields: {
-        "@id": {
-          source: [],
-          transform: (_, _source, context: MappingContext) => {
-            // Provider info comes from context (DSPProviderConfig)
-            const providerSlug =
-              context.providerParticipantId ||
-              context.providerName ||
-              "unknown";
-            // FIXME: Avoid magic strings
-            return `${context.temsProviderBase || "https://api.tems.example.com/providers/"}${encodeURIComponent(providerSlug)}/`;
-          },
-        },
-        name: {
-          source: [],
-          transform: (_, source, context: MappingContext) => {
-            const props = getProperties(source);
-            return (
-              props["dcterms:creator"]?.["foaf:name"] ||
-              context.providerName ||
-              ""
-            );
-          },
-        },
-        image: {
-          source: [],
-          transform: (_, source, context: MappingContext) => {
-            const props = getProperties(source);
-            const logoUrl =
-              props["dcterms:creator"]?.["foaf:thumbnail"]?.["rdf:resource"];
-
-            if (!logoUrl) return undefined;
-
-            const filename = logoUrl.split("/").pop() || "provider-logo";
-            return {
-              // FIXME: Avoid magic strings
-              "@id": `${context.temsImageBase || "https://api.tems.example.com/images/"}${encodeURIComponent(filename)}/`,
-              "@type": "tems:Image",
-              iframe: false,
-              url: logoUrl,
-              name: filename,
-            };
-          },
-        },
-      },
-    },
-  },
-
-  contractFields: {
-    counterPartyAddress: {
-      source: [],
-      transform: (_, _source, context: MappingContext) =>
-        context.providerAddress,
-    },
-    counterPartyId: {
-      source: [],
-      transform: (_, _source, context: MappingContext) =>
-        context.providerParticipantId || context.providerName,
-    },
-    assetId: {
-      source: ["@id"],
-      transform: (value, source) => stripUrnPrefix(value || source["id"] || ""),
-    },
-    datasetId: {
-      source: ["@id"],
-      transform: (value, source) => stripUrnPrefix(value || source["id"] || ""),
-    },
-    // Index endpoint URL for index assets - try multiple property variations
-    // Priority: source-level dcat:endpointUrl (index endpoint) over props-level dcat:endpointURL (protocol URL)
-    indexEndpointUrl: {
-      source: [],
-      transform: (_, source, context: MappingContext) => {
-        const props = getProperties(source);
-        // DEBUG: Log all possible sources for endpoint URL
-        console.log("[DSP Mapping] indexEndpointUrl extraction for:", {
-          assetId: source["@id"] || source["id"],
-          assetName: source["name"] || props["name"] || props["dct:title"],
-          provider: context.providerName,
-          providerParticipantId: context.providerParticipantId,
-          "source.dcat:endpointUrl": source["dcat:endpointUrl"],
-          "props.dcat:endpointUrl": props["dcat:endpointUrl"],
-          "source.dcat:endpointURL": source["dcat:endpointURL"],
-          "props.dcat:accessService": props["dcat:accessService"],
-        });
-        // Prioritize source-level (lowercase Url) which contains the actual index endpoint
-        // over props-level (uppercase URL) which may contain the protocol URL
-        const result =
-          source["dcat:endpointUrl"] ||
-          props["dcat:endpointUrl"] ||
-          source["dcat:endpointURL"] ||
-          props["dcat:accessService"]?.["dcat:endpointUrl"] ||
-          props["dcat:accessService"]?.["dcat:endpointURL"] ||
-          props["endpointUrl"] ||
-          props["endpointURL"] ||
-          undefined;
-        console.log("[DSP Mapping] indexEndpointUrl result:", result);
-        return result;
-      },
-    },
-    policy: {
-      source: ["odrl:hasPolicy"],
-      fallback: (source) => source["hasPolicy"],
-      transform: (policy, source, context) => {
-        if (!policy) return undefined;
-
-        // Use the processPolicyTransform helper
-        const processed = processPolicyTransform(policy, source, context);
-
-        // Additional processing for permissions, prohibitions, obligations
-        if (processed) {
-          const processRules = (rules: any) => {
-            if (Array.isArray(rules)) {
-              return rules.map((rule) => {
-                if (rule["@id"]) {
-                  rule["@id"] = stripUrnPrefix(rule["@id"]);
-                }
-                return rule;
-              });
-            }
-            return rules;
-          };
-
-          if (processed["odrl:permission"]) {
-            processed["odrl:permission"] = processRules(
-              processed["odrl:permission"],
-            );
-          }
-          if (processed["odrl:prohibition"]) {
-            processed["odrl:prohibition"] = processRules(
-              processed["odrl:prohibition"],
-            );
-          }
-          if (processed["odrl:obligation"]) {
-            processed["odrl:obligation"] = processRules(
-              processed["odrl:obligation"],
-            );
-          }
-        }
-
-        return processed;
-      },
-    },
-  },
-
-  // Post-processing to add provider metadata fields
-  postProcess: (resource, _source, context: MappingContext) => {
-    return {
-      ...resource,
-      _provider: context.providerName,
-      _providerAddress: context.providerAddress,
-      _providerColor: context.providerColor || "#1976d2",
-      _providerParticipantId: context.providerParticipantId,
-    };
-  },
-};