@onecx/integration-interface 8.0.0-rc.1 → 8.0.0-rc.11

package/src/lib/utils/portal-message.utils.d.ts

@@ -0,0 +1,54 @@
+export type PortalMessage = {
+    summaryKey?: string;
+    summaryParameters?: object;
+    detailKey?: string;
+    detailParameters?: object;
+    id?: any;
+    key?: string;
+    life?: number;
+    sticky?: boolean;
+    closable?: boolean;
+    data?: any;
+    icon?: string;
+    contentStyleClass?: string;
+    styleClass?: string;
+};
+type TranslateFn = (key: string, params?: object) => Promise<string> | string | undefined;
+/**
+ * Builds a portal message payload with resolved summary and detail.
+ *
+ * @param severity - Message severity.
+ * @param message - Original message payload.
+ * @param summary - Resolved summary string.
+ * @param detail - Resolved detail string.
+ * @returns Message payload ready for publish.
+ */
+declare const buildPortalMessagePayload: (severity: string, message: PortalMessage, summary?: string, detail?: string) => PortalMessage & {
+    severity: string;
+    summary?: string;
+    detail?: string;
+};
+/**
+ * Resolves a translated string for the given message key.
+ *
+ * @param translate - Translation function to use.
+ * @param key - Translation key.
+ * @param params - Translation parameters.
+ * @returns Translated string or undefined when no key exists.
+ */
+declare const resolveTranslation: (translate: TranslateFn | undefined, key?: string, params?: object) => Promise<string | undefined>;
+/**
+ * Builds a translated message payload with resolved summary and detail.
+ *
+ * @param severity - Message severity.
+ * @param message - Original message payload.
+ * @param translate - Optional translation helper.
+ * @returns Message payload ready for publish.
+ */
+declare const buildTranslatedMessage: (severity: string, message: PortalMessage, translate?: TranslateFn) => Promise<PortalMessage & {
+    severity: string;
+    summary?: string;
+    detail?: string;
+}>;
+export { buildPortalMessagePayload, buildTranslatedMessage, resolveTranslation };
+export type { TranslateFn };

package/src/lib/utils/portal-message.utils.js

@@ -0,0 +1,49 @@
+/**
+ * Builds a portal message payload with resolved summary and detail.
+ *
+ * @param severity - Message severity.
+ * @param message - Original message payload.
+ * @param summary - Resolved summary string.
+ * @param detail - Resolved detail string.
+ * @returns Message payload ready for publish.
+ */
+const buildPortalMessagePayload = (severity, message, summary, detail) => ({
+    ...message,
+    severity,
+    summary,
+    detail,
+});
+/**
+ * Resolves a translated string for the given message key.
+ *
+ * @param translate - Translation function to use.
+ * @param key - Translation key.
+ * @param params - Translation parameters.
+ * @returns Translated string or undefined when no key exists.
+ */
+const resolveTranslation = async (translate, key, params) => {
+    if (!key) {
+        return undefined;
+    }
+    if (!translate) {
+        return key;
+    }
+    return await translate(key, params);
+};
+/**
+ * Builds a translated message payload with resolved summary and detail.
+ *
+ * @param severity - Message severity.
+ * @param message - Original message payload.
+ * @param translate - Optional translation helper.
+ * @returns Message payload ready for publish.
+ */
+const buildTranslatedMessage = async (severity, message, translate) => {
+    const [summary, detail] = await Promise.all([
+        resolveTranslation(translate, message.summaryKey, message.summaryParameters),
+        resolveTranslation(translate, message.detailKey, message.detailParameters),
+    ]);
+    return buildPortalMessagePayload(severity, message, summary, detail);
+};
+export { buildPortalMessagePayload, buildTranslatedMessage, resolveTranslation };
+//# sourceMappingURL=portal-message.utils.js.map

package/src/lib/utils/portal-message.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-message.utils.js","sourceRoot":"","sources":["../../../../../../libs/integration-interface/src/lib/utils/portal-message.utils.ts"],"names":[],"mappings":"AAkBA;;;;;;;;GAQG;AACH,MAAM,yBAAyB,GAAG,CAChC,QAAgB,EAChB,OAAsB,EACtB,OAAgB,EAChB,MAAe,EAC0D,EAAE,CAAC,CAAC;IAC7E,GAAG,OAAO;IACV,QAAQ;IACR,OAAO;IACP,MAAM;CACP,CAAC,CAAA;AAEF;;;;;;;GAOG;AACH,MAAM,kBAAkB,GAAG,KAAK,EAC9B,SAAkC,EAClC,GAAY,EACZ,MAAe,EACc,EAAE;IAC/B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,OAAO,MAAM,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;AACrC,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,sBAAsB,GAAG,KAAK,EAClC,QAAgB,EAChB,OAAsB,EACtB,SAAuB,EAC2D,EAAE;IACpF,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC1C,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,iBAAiB,CAAC;QAC5E,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,gBAAgB,CAAC;KAC3E,CAAC,CAAA;IAEF,OAAO,yBAAyB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;AACtE,CAAC,CAAA;AAED,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,CAAA"}

package/src/lib/utils/shell-capability.utils.d.ts

@@ -0,0 +1,21 @@
+import { ShellCapability } from '../models/shell-capability.model';
+/**
+ * Registers shell capabilities globally for the host application.
+ *
+ * @param capabilities - List of capabilities provided by the host shell.
+ */
+declare const setShellCapabilities: (capabilities: ShellCapability[]) => void;
+/**
+ * Returns currently registered shell capabilities.
+ *
+ * @returns Capability list or undefined.
+ */
+declare const getShellCapabilities: () => ShellCapability[] | undefined;
+/**
+ * Checks if the host application provides a capability.
+ *
+ * @param capability - Capability to verify.
+ * @returns True if capability is present.
+ */
+declare const hasShellCapability: (capability: ShellCapability) => boolean;
+export { getShellCapabilities, hasShellCapability, setShellCapabilities };

package/src/lib/utils/shell-capability.utils.js

@@ -0,0 +1,30 @@
+const SHELL_CAPABILITIES_KEY = 'onecx-shell-capabilities';
+/**
+ * Registers shell capabilities globally for the host application.
+ *
+ * @param capabilities - List of capabilities provided by the host shell.
+ */
+const setShellCapabilities = (capabilities) => {
+    ;
+    globalThis[SHELL_CAPABILITIES_KEY] =
+        capabilities;
+};
+/**
+ * Returns currently registered shell capabilities.
+ *
+ * @returns Capability list or undefined.
+ */
+const getShellCapabilities = () => {
+    return globalThis[SHELL_CAPABILITIES_KEY];
+};
+/**
+ * Checks if the host application provides a capability.
+ *
+ * @param capability - Capability to verify.
+ * @returns True if capability is present.
+ */
+const hasShellCapability = (capability) => {
+    return getShellCapabilities()?.includes(capability) ?? false;
+};
+export { getShellCapabilities, hasShellCapability, setShellCapabilities };
+//# sourceMappingURL=shell-capability.utils.js.map

package/src/lib/utils/shell-capability.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-capability.utils.js","sourceRoot":"","sources":["../../../../../../libs/integration-interface/src/lib/utils/shell-capability.utils.ts"],"names":[],"mappings":"AAEA,MAAM,sBAAsB,GAAG,0BAA0B,CAAA;AAEzD;;;;GAIG;AACH,MAAM,oBAAoB,GAAG,CAAC,YAA+B,EAAQ,EAAE;IACrE,CAAC;IAAC,UAAmF,CAAC,sBAAsB,CAAC;QAC3G,YAAY,CAAA;AAChB,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,oBAAoB,GAAG,GAAkC,EAAE;IAC/D,OAAQ,UAAmF,CAAC,sBAAsB,CAAC,CAAA;AACrH,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,kBAAkB,GAAG,CAAC,UAA2B,EAAW,EAAE;IAClE,OAAO,oBAAoB,EAAE,EAAE,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAA;AAC9D,CAAC,CAAA;AAED,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,CAAA"}

package/src/lib/utils/user-language.utils.d.ts

@@ -0,0 +1,30 @@
+import type { UserProfile } from '../topics/user-profile/v1/user-profile.model';
+type GetNormalizedBrowserLocales = () => string[];
+type DetermineBrowserLanguage = () => string | undefined;
+/**
+ * Determines the browser language using globalThis.
+ *
+ * @returns Browser language code or undefined when unavailable.
+ */
+declare const determineBrowserLanguage: () => string | undefined;
+/**
+ * Resolves legacy language settings from the profile.
+ *
+ * @param profile - User profile payload.
+ * @param defaultLang - Default language fallback.
+ * @param determineLang - Optional browser language resolver.
+ * @returns Resolved language code.
+ */
+declare const resolveLegacyLanguage: (profile: UserProfile, defaultLang: string, determineLang?: DetermineBrowserLanguage) => string;
+/**
+ * Resolves the preferred language from the profile settings.
+ *
+ * @param profile - User profile payload.
+ * @param defaultLang - Default language fallback.
+ * @param getNormalizedLocales - Function returning normalized browser locales.
+ * @param determineLang - Optional browser language resolver.
+ * @returns Resolved language code.
+ */
+declare const resolveProfileLanguage: (profile: UserProfile, defaultLang: string, getNormalizedLocales: GetNormalizedBrowserLocales, determineLang?: DetermineBrowserLanguage) => string;
+export { determineBrowserLanguage, resolveLegacyLanguage, resolveProfileLanguage };
+export type { DetermineBrowserLanguage, GetNormalizedBrowserLocales };

package/src/lib/utils/user-language.utils.js

@@ -0,0 +1,56 @@
+/**
+ * Determines the browser language using globalThis.
+ *
+ * @returns Browser language code or undefined when unavailable.
+ */
+const determineBrowserLanguage = () => {
+    const windowRef = globalThis.window;
+    if (!windowRef || !windowRef.navigator) {
+        return undefined;
+    }
+    let browserLang = windowRef.navigator.languages?.[0];
+    browserLang = browserLang || windowRef.navigator.language;
+    if (!browserLang) {
+        return undefined;
+    }
+    if (browserLang.includes('-')) {
+        browserLang = browserLang.split('-')[0];
+    }
+    if (browserLang.includes('_')) {
+        browserLang = browserLang.split('_')[0];
+    }
+    return browserLang;
+};
+/**
+ * Resolves legacy language settings from the profile.
+ *
+ * @param profile - User profile payload.
+ * @param defaultLang - Default language fallback.
+ * @param determineLang - Optional browser language resolver.
+ * @returns Resolved language code.
+ */
+const resolveLegacyLanguage = (profile, defaultLang, determineLang = determineBrowserLanguage) => {
+    return profile.accountSettings?.localeAndTimeSettings?.locale ?? determineLang() ?? defaultLang;
+};
+/**
+ * Resolves the preferred language from the profile settings.
+ *
+ * @param profile - User profile payload.
+ * @param defaultLang - Default language fallback.
+ * @param getNormalizedLocales - Function returning normalized browser locales.
+ * @param determineLang - Optional browser language resolver.
+ * @returns Resolved language code.
+ */
+const resolveProfileLanguage = (profile, defaultLang, getNormalizedLocales, determineLang = determineBrowserLanguage) => {
+    let locales = profile.settings?.locales;
+    if (!locales) {
+        return resolveLegacyLanguage(profile, defaultLang, determineLang);
+    }
+    if (locales.length === 0) {
+        locales = getNormalizedLocales();
+    }
+    const firstLang = locales.find((lang) => lang.length === 2);
+    return firstLang ?? defaultLang;
+};
+export { determineBrowserLanguage, resolveLegacyLanguage, resolveProfileLanguage };
+//# sourceMappingURL=user-language.utils.js.map

package/src/lib/utils/user-language.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-language.utils.js","sourceRoot":"","sources":["../../../../../../libs/integration-interface/src/lib/utils/user-language.utils.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,wBAAwB,GAAG,GAAuB,EAAE;IACxD,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAA;IACnC,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QACvC,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,IAAI,WAAW,GAAuB,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAA;IACxE,WAAW,GAAG,WAAW,IAAI,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAA;IAEzD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,IAAI,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACzC,CAAC;IAED,IAAI,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACzC,CAAC;IAED,OAAO,WAAW,CAAA;AACpB,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,qBAAqB,GAAG,CAC5B,OAAoB,EACpB,WAAmB,EACnB,gBAA0C,wBAAwB,EAC1D,EAAE;IACV,OAAO,OAAO,CAAC,eAAe,EAAE,qBAAqB,EAAE,MAAM,IAAI,aAAa,EAAE,IAAI,WAAW,CAAA;AACjG,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,sBAAsB,GAAG,CAC7B,OAAoB,EACpB,WAAmB,EACnB,oBAAiD,EACjD,gBAA0C,wBAAwB,EAC1D,EAAE;IACV,IAAI,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAA;IAEvC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,aAAa,CAAC,CAAA;IACnE,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,GAAG,oBAAoB,EAAE,CAAA;IAClC,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAA;IAC3D,OAAO,SAAS,IAAI,WAAW,CAAA;AACjC,CAAC,CAAA;AAED,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,CAAA"}

package/src/lib/utils/workspace.utils.d.ts

@@ -0,0 +1,76 @@
+import { Endpoint } from '../topics/current-workspace/v1/endpoint.model';
+import { Route } from '../topics/current-workspace/v1/route.model';
+import type { Workspace } from '../topics/current-workspace/v1/workspace.model';
+type EndpointParameters = Record<string, unknown>;
+type WarnHandler = (message: string) => void;
+/**
+ * Builds the base URL from the workspace, with warnings on missing values.
+ *
+ * @param workspace - Workspace definition.
+ * @returns Base URL string or empty string if missing.
+ */
+declare const constructBaseUrlFromWorkspace: (workspace: Workspace, warn: WarnHandler) => string;
+/**
+ * Finds a route entry for a product/app pair.
+ *
+ * @param routes - Available route definitions.
+ * @param appId - Application identifier.
+ * @param productName - Product name identifier.
+ * @returns Matched route or undefined.
+ */
+declare const filterRouteFromList: (routes: Array<Route> | undefined, appId: string, productName: string, warn: WarnHandler) => Route | undefined;
+/**
+ * Resolves endpoint aliases to the final endpoint definition.
+ *
+ * @param endpointName - Endpoint name or alias.
+ * @param endpoints - Available endpoint definitions.
+ * @returns Resolved endpoint or undefined.
+ */
+declare const dissolveEndpoint: (endpointName: string, endpoints: Array<Endpoint>) => Endpoint | undefined;
+/**
+ * Normalizes parameter values into strings for URL interpolation.
+ *
+ * @param value - Parameter value to normalize.
+ * @returns Normalized string value.
+ */
+declare const getStringFromUnknown: (value: unknown) => string;
+/**
+ * Replaces path parameters with the provided endpoint parameter values.
+ *
+ * @param path - Endpoint path template.
+ * @param endpointParameters - Parameters to inject.
+ * @returns Path with parameters resolved, or empty string on failure.
+ */
+declare const fillParamsForPath: (path: string, endpointParameters: EndpointParameters, warn: WarnHandler) => string;
+/**
+ * Constructs a URL path for a concrete endpoint, resolving aliases and params.
+ *
+ * @param route - Route definition.
+ * @param endpointName - Endpoint name or alias.
+ * @param endpointParameters - Endpoint parameters for interpolation.
+ * @returns Endpoint URL path string.
+ */
+declare const constructEndpointUrl: (route: Route, endpointName: string, endpointParameters: EndpointParameters | undefined, warn?: WarnHandler) => string;
+/**
+ * Constructs a full route URL for a workspace, app, and optional endpoint.
+ *
+ * @param workspace - Workspace definition.
+ * @param appId - Application identifier.
+ * @param productName - Product name identifier.
+ * @param endpointName - Optional endpoint name.
+ * @param endpointParameters - Optional endpoint parameters.
+ * @returns Resolved route URL string.
+ */
+declare const constructRouteUrl: (workspace: Workspace, appId: string, productName: string, endpointName?: string, endpointParameters?: EndpointParameters, warn?: WarnHandler) => string;
+/**
+ * Checks whether a route or endpoint URL exists for the given identifiers.
+ *
+ * @param workspace - Workspace definition.
+ * @param productName - Product name identifier.
+ * @param appId - Application identifier.
+ * @param endpointName - Optional endpoint name to validate.
+ * @returns True if the URL exists.
+ */
+declare const doesUrlExistForWorkspace: (workspace: Workspace, productName: string, appId: string, endpointName?: string, warn?: WarnHandler) => boolean;
+export type { EndpointParameters };
+export { constructBaseUrlFromWorkspace, constructEndpointUrl, constructRouteUrl, doesUrlExistForWorkspace, dissolveEndpoint, fillParamsForPath, filterRouteFromList, getStringFromUnknown, };

package/src/lib/utils/workspace.utils.js

@@ -0,0 +1,199 @@
+const aliasStart = '[[';
+const aliasEnd = ']]';
+const paramStart = '{';
+const paramEnd = '}';
+/**
+ * Joins base and path segments with a single slash.
+ *
+ * @param base - Base URL segment.
+ * @param path - Path segment to append.
+ * @returns Joined URL string.
+ */
+const joinWithSlash = (base, path) => {
+    let normalizedBase = base;
+    let normalizedPath = path;
+    if (!normalizedBase.endsWith('/')) {
+        normalizedBase += '/';
+    }
+    if (normalizedPath.startsWith('/')) {
+        normalizedPath = normalizedPath.slice(1);
+    }
+    return normalizedBase + normalizedPath;
+};
+/**
+ * Builds the base URL from the workspace, with warnings on missing values.
+ *
+ * @param workspace - Workspace definition.
+ * @returns Base URL string or empty string if missing.
+ */
+const constructBaseUrlFromWorkspace = (workspace, warn) => {
+    if (workspace.baseUrl === undefined) {
+        warn('There was no baseUrl for received workspace.');
+        return '';
+    }
+    return workspace.baseUrl;
+};
+/**
+ * Finds a route entry for a product/app pair.
+ *
+ * @param routes - Available route definitions.
+ * @param appId - Application identifier.
+ * @param productName - Product name identifier.
+ * @returns Matched route or undefined.
+ */
+const filterRouteFromList = (routes, appId, productName, warn) => {
+    if (!routes) {
+        return undefined;
+    }
+    const productRoutes = routes.filter((route) => route.appId === appId && route.productName === productName);
+    if (productRoutes.length === 0) {
+        return undefined;
+    }
+    if (productRoutes.length > 1) {
+        warn('There were more than one route. First route has been used.');
+    }
+    return productRoutes[0];
+};
+/**
+ * Resolves endpoint aliases to the final endpoint definition.
+ *
+ * @param endpointName - Endpoint name or alias.
+ * @param endpoints - Available endpoint definitions.
+ * @returns Resolved endpoint or undefined.
+ */
+const dissolveEndpoint = (endpointName, endpoints) => {
+    let endpoint = endpoints.find((ep) => ep.name === endpointName);
+    if (!endpoint) {
+        return undefined;
+    }
+    while (endpoint.path?.includes(aliasStart)) {
+        const path = endpoint.path;
+        const startIdx = path.indexOf(aliasStart) + aliasStart.length;
+        const endIdx = path.lastIndexOf(aliasEnd);
+        if (endIdx <= startIdx) {
+            return undefined;
+        }
+        const aliasName = path.substring(startIdx, endIdx);
+        endpoint = endpoints.find((ep) => ep.name === aliasName);
+        if (!endpoint) {
+            return undefined;
+        }
+    }
+    return endpoint;
+};
+/**
+ * Normalizes parameter values into strings for URL interpolation.
+ *
+ * @param value - Parameter value to normalize.
+ * @returns Normalized string value.
+ */
+const getStringFromUnknown = (value) => {
+    if (value === null || value === undefined) {
+        return '';
+    }
+    if (typeof value === 'string') {
+        return value;
+    }
+    return String(value);
+};
+/**
+ * Replaces path parameters with the provided endpoint parameter values.
+ *
+ * @param path - Endpoint path template.
+ * @param endpointParameters - Parameters to inject.
+ * @returns Path with parameters resolved, or empty string on failure.
+ */
+const fillParamsForPath = (path, endpointParameters, warn) => {
+    while (path.includes(paramStart)) {
+        const paramName = path.substring(path.indexOf(paramStart) + paramStart.length, path.indexOf(paramEnd));
+        const paramValue = getStringFromUnknown(endpointParameters[paramName]);
+        if (paramValue && paramValue.length > 0) {
+            path = path.replace(paramStart.concat(paramName).concat(paramEnd), paramValue);
+        }
+        else {
+            warn(`Searched param "${paramName}" was not found in given param list `);
+            return '';
+        }
+    }
+    return path;
+};
+/**
+ * Constructs a URL path for a concrete endpoint, resolving aliases and params.
+ *
+ * @param route - Route definition.
+ * @param endpointName - Endpoint name or alias.
+ * @param endpointParameters - Endpoint parameters for interpolation.
+ * @returns Endpoint URL path string.
+ */
+const constructEndpointUrl = (route, endpointName, endpointParameters, warn = console.warn) => {
+    if (!route.endpoints) {
+        return '';
+    }
+    const finalEndpoint = dissolveEndpoint(endpointName, route.endpoints);
+    if (!finalEndpoint?.path) {
+        warn('No endpoint or endpoint.path could be found');
+        return '';
+    }
+    const paramsFilled = fillParamsForPath(finalEndpoint.path, endpointParameters ?? {}, warn);
+    if (paramsFilled === undefined) {
+        warn('Params could not be filled correctly');
+        return '';
+    }
+    return paramsFilled;
+};
+/**
+ * Constructs a full route URL for a workspace, app, and optional endpoint.
+ *
+ * @param workspace - Workspace definition.
+ * @param appId - Application identifier.
+ * @param productName - Product name identifier.
+ * @param endpointName - Optional endpoint name.
+ * @param endpointParameters - Optional endpoint parameters.
+ * @returns Resolved route URL string.
+ */
+const constructRouteUrl = (workspace, appId, productName, endpointName, endpointParameters, warn = console.warn) => {
+    const route = filterRouteFromList(workspace.routes, appId, productName, warn);
+    let url = constructBaseUrlFromWorkspace(workspace, warn);
+    if (!route) {
+        warn(`No route.baseUrl could be found for given appId "${appId}" and productName "${productName}"`);
+        return url;
+    }
+    if (route.baseUrl?.length) {
+        url = route.baseUrl;
+    }
+    if (endpointName == undefined) {
+        return url;
+    }
+    const endpointPath = constructEndpointUrl(route, endpointName, endpointParameters, warn);
+    if (!endpointPath.length) {
+        return url;
+    }
+    url = joinWithSlash(url, endpointPath);
+    return url;
+};
+/**
+ * Checks whether a route or endpoint URL exists for the given identifiers.
+ *
+ * @param workspace - Workspace definition.
+ * @param productName - Product name identifier.
+ * @param appId - Application identifier.
+ * @param endpointName - Optional endpoint name to validate.
+ * @returns True if the URL exists.
+ */
+const doesUrlExistForWorkspace = (workspace, productName, appId, endpointName, warn = console.warn) => {
+    const checkEndpoint = endpointName !== undefined && endpointName.length > 0;
+    if (!workspace.routes) {
+        return false;
+    }
+    const route = filterRouteFromList(workspace.routes, appId, productName, warn);
+    if (checkEndpoint) {
+        if (!route?.endpoints?.length) {
+            return false;
+        }
+        const endpoint = route.endpoints.find((ep) => ep.name === endpointName);
+        return !!endpoint?.path?.length;
+    }
+    return !!route?.baseUrl?.length;
+};
+export { constructBaseUrlFromWorkspace, constructEndpointUrl, constructRouteUrl, doesUrlExistForWorkspace, dissolveEndpoint, fillParamsForPath, filterRouteFromList, getStringFromUnknown, };
+//# sourceMappingURL=workspace.utils.js.map

package/src/lib/utils/workspace.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.utils.js","sourceRoot":"","sources":["../../../../../../libs/integration-interface/src/lib/utils/workspace.utils.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,GAAG,IAAI,CAAA;AACvB,MAAM,QAAQ,GAAG,IAAI,CAAA;AACrB,MAAM,UAAU,GAAG,GAAG,CAAA;AACtB,MAAM,QAAQ,GAAG,GAAG,CAAA;AAEpB;;;;;;GAMG;AACH,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,IAAY,EAAU,EAAE;IAC3D,IAAI,cAAc,GAAG,IAAI,CAAA;IACzB,IAAI,cAAc,GAAG,IAAI,CAAA;IAEzB,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,cAAc,IAAI,GAAG,CAAA;IACvB,CAAC;IACD,IAAI,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,cAAc,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAC1C,CAAC;IACD,OAAO,cAAc,GAAG,cAAc,CAAA;AACxC,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,6BAA6B,GAAG,CAAC,SAAoB,EAAE,IAAiB,EAAU,EAAE;IACxF,IAAI,SAAS,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACpC,IAAI,CAAC,8CAA8C,CAAC,CAAA;QACpD,OAAO,EAAE,CAAA;IACX,CAAC;IACD,OAAO,SAAS,CAAC,OAAO,CAAA;AAC1B,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,mBAAmB,GAAG,CAC1B,MAAgC,EAChC,KAAa,EACb,WAAmB,EACnB,IAAiB,EACE,EAAE;IACrB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,IAAI,KAAK,CAAC,WAAW,KAAK,WAAW,CAAC,CAAA;IAE1G,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC,4DAA4D,CAAC,CAAA;IACpE,CAAC;IAED,OAAO,aAAa,CAAC,CAAC,CAAC,CAAA;AACzB,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,gBAAgB,GAAG,CAAC,YAAoB,EAAE,SAA0B,EAAwB,EAAE;IAClG,IAAI,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,YAAY,CAAC,CAAA;IAE/D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAW,QAAQ,CAAC,IAAI,CAAA;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC,MAAM,CAAA;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;QACzC,IAAI,MAAM,IAAI,QAAQ,EAAE,CAAC;YACvB,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAClD,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAA;QAExD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,SAAS,CAAA;QAClB,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAU,EAAE;IACtD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,EAAE,CAAA;IACX,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;AACtB,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAE,kBAAsC,EAAE,IAAiB,EAAU,EAAE;IAC5G,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAA;QACtG,MAAM,UAAU,GAAG,oBAAoB,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAA;QACtE,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAA;QAChF,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,mBAAmB,SAAS,sCAAsC,CAAC,CAAA;YACxE,OAAO,EAAE,CAAA;QACX,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,oBAAoB,GAAG,CAC3B,KAAY,EACZ,YAAoB,EACpB,kBAAkD,EAClD,OAAoB,OAAO,CAAC,IAAI,EACxB,EAAE;IACV,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACrB,OAAO,EAAE,CAAA;IACX,CAAC;IACD,MAAM,aAAa,GAAG,gBAAgB,CAAC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,CAAA;IACrE,IAAI,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC;QACzB,IAAI,CAAC,6CAA6C,CAAC,CAAA;QACnD,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,YAAY,GAAG,iBAAiB,CAAC,aAAa,CAAC,IAAI,EAAE,kBAAkB,IAAI,EAAE,EAAE,IAAI,CAAC,CAAA;IAC1F,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC,sCAAsC,CAAC,CAAA;QAC5C,OAAO,EAAE,CAAA;IACX,CAAC;IAED,OAAO,YAAY,CAAA;AACrB,CAAC,CAAA;AAED;;;;;;;;;GASG;AACH,MAAM,iBAAiB,GAAG,CACxB,SAAoB,EACpB,KAAa,EACb,WAAmB,EACnB,YAAqB,EACrB,kBAAuC,EACvC,OAAoB,OAAO,CAAC,IAAI,EACxB,EAAE;IACV,MAAM,KAAK,GAAG,mBAAmB,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,CAAA;IAC7E,IAAI,GAAG,GAAG,6BAA6B,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;IACxD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,IAAI,CAAC,oDAAoD,KAAK,sBAAsB,WAAW,GAAG,CAAC,CAAA;QAEnG,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAC1B,GAAG,GAAG,KAAK,CAAC,OAAO,CAAA;IACrB,CAAC;IACD,IAAI,YAAY,IAAI,SAAS,EAAE,CAAC;QAC9B,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,MAAM,YAAY,GAAG,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,IAAI,CAAC,CAAA;IACxF,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;QACzB,OAAO,GAAG,CAAA;IACZ,CAAC;IACD,GAAG,GAAG,aAAa,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;IACtC,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,wBAAwB,GAAG,CAC/B,SAAoB,EACpB,WAAmB,EACnB,KAAa,EACb,YAAqB,EACrB,OAAoB,OAAO,CAAC,IAAI,EACvB,EAAE;IACX,MAAM,aAAa,GAAG,YAAY,KAAK,SAAS,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,CAAA;IAE3E,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QACtB,OAAO,KAAK,CAAA;IACd,CAAC;IACD,MAAM,KAAK,GAAG,mBAAmB,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,CAAA;IAE7E,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAA;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,YAAY,CAAC,CAAA;QACvE,OAAO,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAA;IACjC,CAAC;IAED,OAAO,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAA;AACjC,CAAC,CAAA;AAGD,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,EACpB,iBAAiB,EACjB,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,GACrB,CAAA"}

package/src/version.d.ts

@@ -0,0 +1,2 @@
+export declare const LIB_NAME = "@onecx/integration-interface";
+export declare const LIB_VERSION = "8.0.0-rc.11";

package/src/version.js

@@ -0,0 +1,3 @@
+export const LIB_NAME = '@onecx/integration-interface';
+export const LIB_VERSION = '8.0.0-rc.11';
+//# sourceMappingURL=version.js.map

package/src/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../../libs/integration-interface/src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG,8BAA8B,CAAA;AACtD,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAA"}

package/migrations/index.d.ts

@@ -1,3 +0,0 @@
-export * from './v6/migrate-onecx-to-v6';
-export * from './v5/warn-for-events-topic-navigated';
-export * from './v5/warn-for-events-publisher-navigated';

package/migrations/index.js

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./v6/migrate-onecx-to-v6"), exports);
-tslib_1.__exportStar(require("./v5/warn-for-events-topic-navigated"), exports);
-tslib_1.__exportStar(require("./v5/warn-for-events-publisher-navigated"), exports);
-//# sourceMappingURL=index.js.map

package/migrations/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/integration-interface/migrations/index.ts"],"names":[],"mappings":";;;AAAA,mEAAwC;AACxC,+EAAoD;AACpD,mFAAwD"}

package/migrations/v5/warn-for-events-publisher-navigated.d.ts

@@ -1,2 +0,0 @@
-import { Tree } from '@nx/devkit';
-export default function warnForEventsPublisherNavigated(tree: Tree): Promise<void>;

package/migrations/v5/warn-for-events-publisher-navigated.js

@@ -1,33 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = warnForEventsPublisherNavigated;
-const nx_migration_utils_1 = require("@onecx/nx-migration-utils");
-function argsMatchExpectedPayload(callExpression) {
-    return callExpression.arguments.some((arg) => {
-        const argText = arg.getText();
-        return /type:\s*['"]navigated['"]/.test(argText);
-    });
-}
-async function warnForEventsPublisherNavigated(tree) {
-    const warningForPotentialMatches = '⚠️ EventsPublisher usages were detected. Please double-check if EventsPublisher is used for publishing navigation events and switch to CurrentLocationPublisher if so.';
-    const warningForExactMatches = '⚠️ You are using EventsPublisher to publish navigation events. Please switch to using CurrentLocationPublisher.';
-    const potentialMatches = (0, nx_migration_utils_1.detectMethodCallsInFiles)(tree, './src', 'publish', 'EventsPublisher');
-    const exactMatches = new Map();
-    const remainingPotentialMatches = new Map();
-    potentialMatches.forEach((calls, file) => {
-        const filteredCalls = calls.filter((call) => argsMatchExpectedPayload(call));
-        if (filteredCalls.length > 0) {
-            exactMatches.set(file, filteredCalls);
-        }
-        else {
-            remainingPotentialMatches.set(file, calls);
-        }
-    });
-    if (exactMatches.size > 0) {
-        (0, nx_migration_utils_1.printWarnings)(warningForExactMatches, Array.from(exactMatches.keys()));
-    }
-    if (remainingPotentialMatches.size > 0) {
-        (0, nx_migration_utils_1.printWarnings)(warningForPotentialMatches, Array.from(remainingPotentialMatches.keys()));
-    }
-}
-//# sourceMappingURL=warn-for-events-publisher-navigated.js.map

package/migrations/v5/warn-for-events-publisher-navigated.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"warn-for-events-publisher-navigated.js","sourceRoot":"","sources":["../../../../../libs/integration-interface/migrations/v5/warn-for-events-publisher-navigated.ts"],"names":[],"mappings":";;AAWA,kDA2BC;AArCD,kEAAmF;AAGnF,SAAS,wBAAwB,CAAC,cAA8B;IAC9D,OAAO,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;QAC3C,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,EAAE,CAAA;QAC7B,OAAO,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAClD,CAAC,CAAC,CAAA;AACJ,CAAC;AAEc,KAAK,UAAU,+BAA+B,CAAC,IAAU;IACtE,MAAM,0BAA0B,GAC9B,wKAAwK,CAAA;IAE1K,MAAM,sBAAsB,GAC1B,iHAAiH,CAAA;IAEnH,MAAM,gBAAgB,GAAG,IAAA,6CAAwB,EAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAA;IAE9F,MAAM,YAAY,GAAG,IAAI,GAAG,EAA4B,CAAA;IACxD,MAAM,yBAAyB,GAAG,IAAI,GAAG,EAA4B,CAAA;IAErE,gBAAgB,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACvC,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAA;QAC5E,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;QACvC,CAAC;aAAM,CAAC;YACN,yBAAyB,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QAC5C,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,IAAI,YAAY,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAC1B,IAAA,kCAAa,EAAC,sBAAsB,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IACxE,CAAC;IACD,IAAI,yBAAyB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACvC,IAAA,kCAAa,EAAC,0BAA0B,EAAE,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IACzF,CAAC;AACH,CAAC"}

package/migrations/v5/warn-for-events-topic-navigated.d.ts

@@ -1,2 +0,0 @@
-import { Tree } from '@nx/devkit';
-export default function warnForEventsTopicNavigated(tree: Tree): Promise<void>;