@cap-js/ord 1.7.0 → 1.9.0

package/lib/templates.js

@@ -1,613 +0,0 @@
-const defaults = require("./defaults");
-const _ = require("lodash");
-const {
-    DATA_PRODUCT_ANNOTATION,
-    DATA_PRODUCT_SIMPLE_ANNOTATION,
-    DATA_PRODUCT_TYPE,
-    DESCRIPTION_PREFIX,
-    ENTITY_RELATIONSHIP_ANNOTATION,
-    LEVEL,
-    ORD_EXTENSIONS_PREFIX,
-    ORD_ODM_ENTITY_NAME_ANNOTATION,
-    ORD_RESOURCE_TYPE,
-    RESOURCE_VISIBILITY,
-    ALLOWED_VISIBILITY,
-    SUPPORTED_IMPLEMENTATIONSTANDARD_VERSIONS,
-    SEM_VERSION_REGEX,
-    SHORT_DESCRIPTION_PREFIX,
-    CONTENT_MERGE_KEY,
-    CDS_ELEMENT_KIND,
-    ORD_API_PROTOCOL,
-    MCP_RESOURCE_DEFINITION_TYPE,
-} = require("./constants");
-const Logger = require("./logger");
-const { ensureAccessStrategies } = require("./access-strategies");
-const { resolveApiResourceProtocol } = require("./protocol-resolver");
-
-function unflatten(flattedObject) {
-    let result = {};
-    _.keys(flattedObject).forEach(function (key) {
-        _.set(result, key, flattedObject[key]);
-    });
-    return result;
-}
-
-function readORDExtensions(model) {
-    const ordExtensions = {};
-    for (const key in model) {
-        if (key.startsWith(ORD_EXTENSIONS_PREFIX)) {
-            const ordKey = key.replace(ORD_EXTENSIONS_PREFIX, "");
-            ordExtensions[ordKey] = model[key];
-        }
-    }
-    return unflatten(ordExtensions);
-}
-
-/**
- * This is a template function to create item of entityTypeMappings array.
- *
- * @param {string} entity The entity definition.
- * @returns {Object} An entry of the entityTypeMappings array.
- */
-const createEntityTypeMappingsItemTemplate = (entity) => {
-    const results = [];
-    if (entity[ORD_ODM_ENTITY_NAME_ANNOTATION]) {
-        results.push({
-            ordId: `sap.odm:entityType:${entity[ORD_ODM_ENTITY_NAME_ANNOTATION]}:v1`,
-            entityName: entity[ORD_ODM_ENTITY_NAME_ANNOTATION],
-            isODMMapping: true,
-            ...entity,
-        });
-    }
-    if (entity[ENTITY_RELATIONSHIP_ANNOTATION]) {
-        const ordIdParts = entity[ENTITY_RELATIONSHIP_ANNOTATION].split(":");
-        const namespace = ordIdParts[0];
-        const entityName = ordIdParts[1];
-        const version = ordIdParts[2] || "v1";
-        results.push({
-            ordId: `${namespace}:entityType:${entityName}:${version}`,
-            entityName,
-            ...entity,
-        });
-    }
-    if (results.length === 0) return;
-    return results;
-};
-
-function _getGroupID(serviceDefinition, groupTypeId = defaults.groupTypeId, appConfig) {
-    return `${groupTypeId}:${appConfig.ordNamespace}:${_getCleanServiceName(serviceDefinition, appConfig)}`;
-}
-
-function _startsWithNamespace(name, namespace) {
-    if (!name.startsWith(namespace)) return false;
-    const rest = name.substring(namespace.length);
-    return rest === "" || rest.startsWith(".");
-}
-
-function _getCleanServiceName({ name }, appConfig) {
-    let sortedName = name;
-    if (appConfig.internalNamespace && _startsWithNamespace(name, appConfig.internalNamespace)) {
-        sortedName = name.substring(appConfig.internalNamespace.length);
-    } else if (_startsWithNamespace(name, appConfig.ordNamespace)) {
-        sortedName = name.substring(appConfig.ordNamespace.length);
-    }
-    if (sortedName.startsWith(".")) {
-        sortedName = sortedName.substring(1);
-    }
-    return sortedName;
-}
-
-/**
- * This is a function to resolve the title of the service group.
- *
- * @param {string} srv The name of the service.
- * @returns {string} The title of the service group.
- */
-function _getTitleFromServiceName(srv) {
-    let serviceName = srv.substring(srv.lastIndexOf(".") + 1);
-    let index = serviceName.indexOf("Service");
-    if (index >= 0) {
-        return `${serviceName.substring(0, index)} Service`;
-    } else {
-        return `${serviceName} Service`;
-    }
-}
-
-/**
- * This is a function to get the version of the entity,
- * validate it and log if it is not a valid semantical version.
- *
- * @param {object} entity An entity object.
- * @returns Version of the entity with '1.0.0' as fallback value.
- */
-function _getEntityVersion(entity) {
-    const entityVersion = entity.ordId.split(":").pop();
-    const version = entityVersion.replace("v", "") + ".0.0"; // TODO: version can be stated/overwritten by annotation
-    if (!SEM_VERSION_REGEX.test(version)) {
-        Logger.warn("Entity version", version, "is not a valid semantic version.");
-    }
-    return version;
-}
-
-/**
- * Pure template function for creating ORD resource definitions.
- * This function does not make assumptions about access strategies - they must be provided explicitly.
- * Access strategies are validated and will fallback to 'open' in non-strict mode if missing.
- *
- * @param {string} resourceType The type of the resource.
- * @param {string} mediaType The media type of the resource.
- * @param {string} ordId The ordId of the resource.
- * @param {string} serviceName The name of the service.
- * @param {string} fileExtension The file extension of the resource.
- * @param {Array} accessStrategies The array of accessStrategies objects (required, no default)
- * @returns {Object} A resource definition object.
- * @private
- */
-function _getResourceDefinition(resourceType, mediaType, ordId, serviceName, fileExtension, accessStrategies) {
-    // Validate and ensure access strategies are present
-    // In non-strict mode, this will log error and fallback to 'open'
-    // In strict mode (cds.env.ord.strictAccessStrategies = true), this will throw
-    const validatedStrategies = ensureAccessStrategies(accessStrategies, {
-        resourceName: `${serviceName} (${resourceType})`,
-    });
-
-    return {
-        type: resourceType,
-        mediaType: `application/${mediaType}`,
-        url: `/ord/v1/${ordId}/${serviceName}.${fileExtension}`,
-        accessStrategies: validatedStrategies,
-    };
-}
-
-/**
- * This is a template function to create group object of a service for groups array in ORD doc.
- *
- * @param {string} serviceName The name of the service.
- * @param {object} serviceDefinition The definition of the service
- * @param {object} appConfig - The application configuration.
- * @returns {Object} A group object.
- */
-const createGroupsTemplateForService = (serviceName, serviceDefinition, appConfig) => {
-    const ordExtensions = readORDExtensions(serviceDefinition);
-
-    if (!serviceDefinition) {
-        Logger.warn("Unable to find service definition:", serviceName);
-        return undefined;
-    }
-
-    const visibility = _handleVisibility(ordExtensions, serviceDefinition, appConfig.env?.defaultVisibility);
-    if (visibility === RESOURCE_VISIBILITY.private) {
-        // If the visibility of the service is private, do not create a group
-        Logger.info("Skipping group creation for private service:", serviceName);
-        return undefined;
-    }
-
-    const groupId = _getGroupID(serviceDefinition, defaults.groupTypeId, appConfig);
-    return {
-        groupId: groupId,
-        groupTypeId: defaults.groupTypeId,
-        title: ordExtensions.title ?? _getTitleFromServiceName(serviceName),
-    };
-};
-
-/**
- * This is a template function to create EntityType object for EntityTypes Array.
- * Ensures correct visibility assignment based on referenced resources.
- *
- * @param { object } appConfig  The configuration object.
- * @param { Array } packageIds The available package identifiers.
- * @param { object } entity The entity definition.
- * @returns { object } An object for the EntityType.
- */
-const createEntityTypeTemplate = (appConfig, packageIds, entity) => {
-    if (entity.isODMMapping) {
-        // ODM mappings are not created as entity types, they are only used in entityTypeMappings
-        return [];
-    }
-    if (appConfig.hasSAPPolicyLevel) {
-        // If SAP policy level is present, don't create entity type, they must be in the central repository
-        return [];
-    }
-
-    const ordExtensions = readORDExtensions(entity);
-    const visibility = ordExtensions.visibility || RESOURCE_VISIBILITY.public;
-
-    if (visibility === RESOURCE_VISIBILITY.private) {
-        return [];
-    }
-
-    const packageId = _getPackageID(appConfig.ordNamespace, packageIds, ORD_RESOURCE_TYPE.entityType, visibility);
-
-    return {
-        ordId: entity.ordId,
-        localId: entity.entityName,
-        title: entity["@title"] ?? entity["@Common.Label"] ?? entity.entityName,
-        shortDescription: SHORT_DESCRIPTION_PREFIX + entity.entityName,
-        description: DESCRIPTION_PREFIX + entity.entityName,
-        version: _getEntityVersion(entity),
-        lastUpdate: appConfig.lastUpdate,
-        visibility,
-        partOfPackage: packageId,
-        releaseStatus: "active",
-        level: entity["@ObjectModel.compositionRoot"] || entity["@ODM.root"] ? LEVEL.rootEntity : LEVEL.subEntity,
-        extensible: { supported: "no" },
-        ...ordExtensions,
-    };
-};
-
-/**
- * Determines the visibility of a resource based on provided extensions, definition, and default visibility.
- *
- * The function checks for custom visibility values, validates the default visibility,
- * and applies specific rules based on the resource's definition and extensions.
- *
- * @param {Object} ordExtensions - Extensions object containing resource metadata.
- * @param {Object} definition - The resource definition object.
- * @param {string} [defaultVisibility=RESOURCE_VISIBILITY.public] - The default visibility value.
- * @returns {string} The resolved visibility value for the resource.
- */
-function _handleVisibility(ordExtensions, definition, defaultVisibility = RESOURCE_VISIBILITY.public) {
-    let visibility;
-    //check for supported custom visibility value in defaultVisibility variable
-    if (!ALLOWED_VISIBILITY.includes(defaultVisibility)) {
-        Logger.warn(
-            "Default visibility",
-            defaultVisibility,
-            "is not supported. Using",
-            RESOURCE_VISIBILITY.public,
-            "as fallback.",
-        );
-        defaultVisibility = RESOURCE_VISIBILITY.public;
-    }
-    // Determine visibility
-    if (isPrimaryDataProductService(definition)) {
-        visibility = RESOURCE_VISIBILITY.internal;
-    } else if (ordExtensions.visibility) {
-        visibility = ordExtensions.visibility;
-    } else if (definition[ORD_EXTENSIONS_PREFIX + "visibility"]) {
-        visibility = definition[ORD_EXTENSIONS_PREFIX + "visibility"];
-    } else if (SUPPORTED_IMPLEMENTATIONSTANDARD_VERSIONS.includes(ordExtensions.implementationStandard)) {
-        // if the implementationStandard is for example sap:ord-document-api:v1, it should be public by default
-        visibility = RESOURCE_VISIBILITY.public;
-    } else if (ALLOWED_VISIBILITY.includes(defaultVisibility)) {
-        // Default visibility from config file
-        visibility = defaultVisibility;
-    }
-    return visibility;
-}
-
-/**
- * This is a template function to create API Resource object for API Resource Array.
- * Properties of an API resource can be overwritten by the ORD extensions. Example: visibility.
- * Ensures proper visibility compliance by checking associated EntityTypes.
- * @param {string} serviceName The name of the service.
- * @param {object} serviceDefinition The definition of the service
- * @param {object} appConfig - The application configuration.
- * @param {Array} packageIds - The available package identifiers.
- * @param {Array} accessStrategies The array of accessStrategies objects
- * @returns {Array} An array of objects for the API Resources.
- */
-const createAPIResourceTemplate = (serviceName, serviceDefinition, appConfig, packageIds, accessStrategies) => {
-    const ordExtensions = readORDExtensions(serviceDefinition);
-    const visibility = _handleVisibility(ordExtensions, serviceDefinition, appConfig.env?.defaultVisibility);
-    const packageId = _getPackageID(appConfig.ordNamespace, packageIds, ORD_RESOURCE_TYPE.api, visibility);
-
-    const protocolResults = resolveApiResourceProtocol(serviceName, serviceDefinition, {
-        isPrimaryDataProduct: isPrimaryDataProductService,
-    });
-    const apiResources = [];
-
-    // If no protocols were generated, skip this service
-    if (protocolResults.length === 0) {
-        Logger.info(`No supported protocols for service '${serviceName}', skipping API resource generation.`);
-        return apiResources;
-    }
-
-    // Handle version suffix extraction for primary data product services
-    let cleanServiceName,
-        version,
-        semanticVersion,
-        extracted = null;
-    if (isPrimaryDataProductService(serviceDefinition)) {
-        extracted = _extractVersionFromServiceName(serviceDefinition.name);
-        if (extracted) {
-            // Create a temporary service definition with the clean name for namespace processing
-            const versionExtractedServiceDefinition = { ...serviceDefinition, name: extracted.cleanName };
-            cleanServiceName = _getCleanServiceName(versionExtractedServiceDefinition, appConfig);
-            version = extracted.version;
-            semanticVersion = extracted.semanticVersion;
-        } else {
-            // Invalid pattern - use current behavior
-            cleanServiceName = _getCleanServiceName(serviceDefinition, appConfig);
-            version = "v1";
-            semanticVersion = "1.0.0";
-        }
-    } else {
-        // Non-data product - use current behavior
-        cleanServiceName = _getCleanServiceName(serviceDefinition, appConfig);
-        version = "v1";
-        semanticVersion = "1.0.0";
-    }
-
-    const ordId = `${appConfig.ordNamespace}:apiResource:${cleanServiceName}:${version}`;
-
-    protocolResults.forEach((protocolResult) => {
-        const { apiProtocol, entryPoints, hasResourceDefinitions } = protocolResult;
-
-        // Build resource definitions based on protocol
-        let resourceDefinitions = [];
-        if (hasResourceDefinitions) {
-            if (apiProtocol === ORD_API_PROTOCOL.SAP_DATA_SUBSCRIPTION) {
-                // Data product services use CSN
-                resourceDefinitions = [
-                    _getResourceDefinition(
-                        "sap-csn-interop-effective-v1",
-                        "json",
-                        ordId,
-                        serviceName,
-                        "csn.json",
-                        accessStrategies,
-                    ),
-                ];
-            } else if (apiProtocol === ORD_API_PROTOCOL.REST) {
-                // REST only has OpenAPI, no EDMX
-                resourceDefinitions = [
-                    _getResourceDefinition("openapi-v3", "json", ordId, serviceName, "oas3.json", accessStrategies),
-                ];
-            } else if (apiProtocol === ORD_API_PROTOCOL.MCP) {
-                resourceDefinitions = [
-                    _getResourceDefinition(
-                        MCP_RESOURCE_DEFINITION_TYPE,
-                        "json",
-                        ordId,
-                        serviceName,
-                        "mcp.json",
-                        accessStrategies,
-                    ),
-                ];
-            } else if (apiProtocol === ORD_API_PROTOCOL.GRAPHQL) {
-                // GraphQL only has GraphQL SDL
-                resourceDefinitions = [
-                    {
-                        type: "graphql-sdl",
-                        mediaType: "text/plain",
-                        url: `/ord/v1/${ordId}/${serviceName}.graphql`,
-                        accessStrategies: ensureAccessStrategies(accessStrategies, {
-                            resourceName: `${serviceName} (graphql-sdl)`,
-                        }),
-                    },
-                ];
-            } else if (apiProtocol === ORD_API_PROTOCOL.ODATA_V2) {
-                // openapi-v3 is not supported for OData V2, only EDMX
-                resourceDefinitions = [
-                    _getResourceDefinition("edmx", "xml", ordId, serviceName, "edmx", accessStrategies),
-                ];
-            } else {
-                // odata-v4 and others have both OpenAPI and EDMX
-                resourceDefinitions = [
-                    _getResourceDefinition("openapi-v3", "json", ordId, serviceName, "oas3.json", accessStrategies),
-                    _getResourceDefinition("edmx", "xml", ordId, serviceName, "edmx", accessStrategies),
-                ];
-            }
-        }
-
-        const exposedEntityTypes = _getExposedEntityTypes(serviceDefinition);
-
-        let obj = {
-            ordId,
-            title: serviceDefinition["@title"] ?? serviceDefinition["@Common.Label"] ?? serviceName,
-            shortDescription: SHORT_DESCRIPTION_PREFIX + serviceName,
-            description: serviceDefinition["@Core.Description"] ?? DESCRIPTION_PREFIX + serviceName,
-            version: semanticVersion,
-            lastUpdate: appConfig.lastUpdate,
-            visibility,
-            partOfPackage: packageId,
-            partOfGroups: [_getGroupID(serviceDefinition, defaults.groupTypeId, appConfig)],
-            releaseStatus: "active",
-            apiProtocol,
-            resourceDefinitions,
-            entryPoints,
-            extensible: {
-                supported: "no",
-            },
-            ...(exposedEntityTypes ? { exposedEntityTypes } : []),
-            ...ordExtensions,
-        };
-
-        // Special handling for data product services
-        if (isPrimaryDataProductService(serviceDefinition)) {
-            obj.direction = "outbound";
-            if (extracted) {
-                // Overwrite partOfGroups
-                obj.partOfGroups = [`${defaults.groupTypeId}:${appConfig.ordNamespace}:${cleanServiceName}`];
-            }
-        }
-
-        if (obj.visibility !== RESOURCE_VISIBILITY.private) {
-            apiResources.push(obj);
-        }
-    });
-
-    return apiResources;
-};
-
-/**
- * This is a template function to create Event Resource object for Event Resource Array.
- * There can be only one event resource per service because all events are using the same protocol, they are always Cloud Events.
- * Properties of an event resource can be overwritten by the ORD extensions. Example: visibility.
- * Ensures proper visibility compliance by checking associated EntityTypes.
- *
- * @param {string} serviceName The name of the service.
- * @param {object} serviceDefinition The definition of the service
- * @param {object} appConfig - The application configuration.
- * @param {Array} packageIds - The available package identifiers.
- * @param {Array} accessStrategies The array of accessStrategies objects
- * @returns {Array} An single-item array of objects for the Event Resources.
- */
-const createEventResourceTemplate = (serviceName, serviceDefinition, appConfig, packageIds, accessStrategies) => {
-    const ordExtensions = readORDExtensions(serviceDefinition);
-    const visibility = _handleVisibility(ordExtensions, serviceDefinition, appConfig.env?.defaultVisibility);
-    const packageId = _getPackageID(appConfig.ordNamespace, packageIds, ORD_RESOURCE_TYPE.event, visibility);
-    const ordId = `${appConfig.ordNamespace}:eventResource:${_getCleanServiceName(serviceDefinition, appConfig)}:v1`;
-    const exposedEntityTypes = _getExposedEntityTypes(serviceDefinition);
-
-    let obj = {
-        ordId,
-        title:
-            serviceDefinition["@title"] ??
-            serviceDefinition["@Common.Label"] ??
-            `ODM ${appConfig.appName.replace(/[^a-zA-Z0-9]/g, "")} Events`,
-        shortDescription: `${serviceName} event resource`,
-        description:
-            serviceDefinition["@description"] ??
-            serviceDefinition["@Core.Description"] ??
-            "CAP Event resource describing events / messages.",
-        version: "1.0.0",
-        lastUpdate: appConfig.lastUpdate,
-        releaseStatus: "active",
-        partOfPackage: packageId,
-        partOfGroups: [_getGroupID(serviceDefinition, defaults.groupTypeId, appConfig)],
-        visibility,
-        resourceDefinitions: [
-            _getResourceDefinition("asyncapi-v2", "json", ordId, serviceName, "asyncapi2.json", accessStrategies),
-        ],
-        extensible: { supported: "no" },
-        ...(exposedEntityTypes ? { exposedEntityTypes } : []),
-        ...ordExtensions,
-    };
-
-    return obj.visibility === RESOURCE_VISIBILITY.public || obj.visibility === RESOURCE_VISIBILITY.internal
-        ? [obj]
-        : [];
-};
-
-function isPrimaryDataProductService(serviceDefinition) {
-    return (
-        serviceDefinition[DATA_PRODUCT_ANNOTATION] === DATA_PRODUCT_TYPE.primary ||
-        !!serviceDefinition[DATA_PRODUCT_SIMPLE_ANNOTATION]
-    );
-}
-
-function _getExposedEntityTypes(definitionObj) {
-    if (!definitionObj.entities) {
-        return;
-    }
-    const entities = Object.values(definitionObj.entities).flatMap((entity) => {
-        const entityData = _flattenEntityGraph(entity).flatMap(createEntityTypeMappingsItemTemplate).filter(Boolean);
-        return _.uniqBy(entityData, CONTENT_MERGE_KEY);
-    });
-    const exposedEntityTypes = _.uniqBy(entities, CONTENT_MERGE_KEY)
-        .filter((entity) => entity !== undefined)
-        .map(({ ordId }) => ({
-            ordId,
-        }));
-
-    if (exposedEntityTypes.length > 0) {
-        return exposedEntityTypes;
-    }
-}
-
-function _flattenEntityGraph(currentEntity, processedEntities = []) {
-    if (!currentEntity.associations) {
-        return [currentEntity];
-    }
-    const entityAssociationTargets = Object.values(currentEntity.associations).map((association) => ({
-        target: association.target,
-        entity: association._target,
-    }));
-
-    const assertionsTodo = [];
-    entityAssociationTargets.forEach(({ target, entity }) => {
-        if (processedEntities.includes(target)) {
-            return;
-        }
-        assertionsTodo.push(entity);
-
-        /*
-        the next line operates on heap memory so that the same entity is not processed again
-        heap memory is used so that the check is the same in:
-        a > b > c > b scenario (runs first)
-        a > d > c > ... scenario (runs later and does not process c again)
-        */
-        processedEntities.push(target);
-    });
-
-    return [currentEntity, ...assertionsTodo.flatMap((entity) => _flattenEntityGraph(entity, processedEntities))];
-}
-
-/**
- * Extracts version suffix from service name for data product services.
- * Only accepts pattern: .v<number> (e.g., .v0, .v1, .v2, .v10)
- * Rejects patterns like: .v1.1, .v1.0, .version1, .beta
- *
- * @param {string} serviceName The full service name
- * @returns {Object|null} Object with cleanName, version, and semanticVersion, or null if invalid pattern
- */
-function _extractVersionFromServiceName(serviceName) {
-    // Only match pattern: .v<number> (where number is 1 or more digits)
-    const versionPattern = /\.v(\d+)$/;
-    const match = serviceName.match(versionPattern);
-
-    if (!match) {
-        return null; // No valid version suffix found
-    }
-
-    const versionNumber = parseInt(match[1], 10);
-
-    return {
-        cleanName: serviceName.replace(versionPattern, ""),
-        version: `v${versionNumber}`,
-        semanticVersion: `${versionNumber}.0.0`,
-    };
-}
-
-function _getPackageID(namespace, packageIds, resourceType, visibility = RESOURCE_VISIBILITY.public) {
-    if (!packageIds) return;
-
-    if (resourceType) {
-        return (
-            packageIds.find((id) => {
-                if (visibility === RESOURCE_VISIBILITY.public) {
-                    return id.includes(resourceType) && !id.includes("-internal") && !id.includes("-private");
-                } else {
-                    return id.includes(`${resourceType}-${visibility}`);
-                }
-            }) || packageIds.find((id) => id.includes(namespace))
-        );
-    }
-
-    return packageIds.find((id) => id.includes(`-${resourceType}-`)) || packageIds.find((id) => id.includes(namespace));
-}
-
-function _propagateORDVisibility(model) {
-    for (const [name, def] of Object.entries(model.definitions)) {
-        if (def.kind === CDS_ELEMENT_KIND.service && def[ORD_EXTENSIONS_PREFIX + "visibility"]) {
-            const serviceName = name;
-            const serviceVisibility = def[ORD_EXTENSIONS_PREFIX + "visibility"];
-            for (const serviceChildrenDef of model.definitions) {
-                if (
-                    serviceChildrenDef.name.startsWith(serviceName + ".") &&
-                    !serviceChildrenDef[ORD_EXTENSIONS_PREFIX + "visibility"]
-                ) {
-                    serviceChildrenDef[ORD_EXTENSIONS_PREFIX + "visibility"] = serviceVisibility;
-                }
-            }
-        }
-    }
-
-    return model;
-}
-
-module.exports = {
-    createEntityTypeTemplate,
-    createEntityTypeMappingsItemTemplate,
-    createGroupsTemplateForService,
-    createAPIResourceTemplate,
-    createEventResourceTemplate,
-    readORDExtensions,
-    _getPackageID,
-    _getExposedEntityTypes,
-    _propagateORDVisibility,
-    _handleVisibility,
-    isPrimaryDataProductService,
-};