From 8017f2653a9ef6d78bb206b37a8e1f21cb00af2b Mon Sep 17 00:00:00 2001 From: delchev Date: Sun, 12 Jul 2026 10:23:02 +0300 Subject: [PATCH] feat(resources): Partner shell (/services/web/partner/) + application-partner-perspectives A third Harmonia shell for external partners (customers, distributors, suppliers), mirroring the My shell: a resources-partner module serving /services/web/partner/, reusing the shared application-core/shell runtime. It aggregates ONLY the new application-partner-perspectives extension point. The separation is the safety property: each shell fetches exactly one extension point, so a perspective appears in the Partner portal iff it explicitly registers on application-partner-perspectives. A personal (my) or application perspective can never leak in - it is never even fetched. A UI meant for both shells registers on both points, deliberately. The separate URI also makes access a single entry-point authz decision. This is the container only: partner-scoping of data, external auth, and partner writes are follow-ups. Verified: /services/web/partner/ serves; the partner perspectives service returns only the 'partner' group; the personal service is unchanged (My Expenses/Vacations/Timesheets), disjoint; Partner is listed in platform-shells. Co-Authored-By: Claude Opus 4.8 --- components/group/group-ui/pom.xml | 4 + components/pom.xml | 6 + .../resources/resources-partner/pom.xml | 21 + .../partner/configs/partner-group.js | 24 + .../dirigible/partner/configs/shell.js | 19 + .../META-INF/dirigible/partner/css/app.css | 16 + .../partner-perspective.extensionpoint | 4 + .../extensions/partner-group.extension | 5 + .../partner/extensions/shell.extension | 5 + .../META-INF/dirigible/partner/index.html | 339 ++++++++++ .../META-INF/dirigible/partner/js/appShell.js | 590 ++++++++++++++++++ .../META-INF/dirigible/partner/js/config.js | 18 + .../dirigible/partner/views/_settings.html | 143 +++++ 13 files changed, 1194 insertions(+) create mode 100644 components/resources/resources-partner/pom.xml create mode 100644 components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/configs/partner-group.js create mode 100644 components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/configs/shell.js create mode 100644 components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/css/app.css create mode 100644 components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/extension-points/partner-perspective.extensionpoint create mode 100644 components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/extensions/partner-group.extension create mode 100644 components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/extensions/shell.extension create mode 100644 components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/index.html create mode 100644 components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/js/appShell.js create mode 100644 components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/js/config.js create mode 100644 components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/views/_settings.html diff --git a/components/group/group-ui/pom.xml b/components/group/group-ui/pom.xml index 6b828ad45b1..56ac3b12de4 100644 --- a/components/group/group-ui/pom.xml +++ b/components/group/group-ui/pom.xml @@ -39,6 +39,10 @@ org.eclipse.dirigible dirigible-components-resources-my + + org.eclipse.dirigible + dirigible-components-resources-partner + org.eclipse.dirigible dirigible-components-resources-inbox diff --git a/components/pom.xml b/components/pom.xml index 6b45fc7c1dd..d28a137c176 100644 --- a/components/pom.xml +++ b/components/pom.xml @@ -252,6 +252,7 @@ resources/resources-dashboard resources/resources-application resources/resources-my + resources/resources-partner resources/resources-inbox resources/resources-documents resources/resources-karavan-libs @@ -1381,6 +1382,11 @@ dirigible-components-resources-my ${project.version} + + org.eclipse.dirigible + dirigible-components-resources-partner + ${project.version} + org.eclipse.dirigible dirigible-components-resources-inbox diff --git a/components/resources/resources-partner/pom.xml b/components/resources/resources-partner/pom.xml new file mode 100644 index 00000000000..7e5e9735a7c --- /dev/null +++ b/components/resources/resources-partner/pom.xml @@ -0,0 +1,21 @@ + + 4.0.0 + + + org.eclipse.dirigible + dirigible-components-parent + 14.0.0-SNAPSHOT + ../../pom.xml + + + Components - Resources - Partner + dirigible-components-resources-partner + jar + + + ../../../licensing-header.txt + ../../../ + + + diff --git a/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/configs/partner-group.js b/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/configs/partner-group.js new file mode 100644 index 00000000000..8cd92c3043a --- /dev/null +++ b/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/configs/partner-group.js @@ -0,0 +1,24 @@ +/* + * Copyright (c) 2010-2026 Eclipse Dirigible contributors + * + * All rights reserved. This program and the accompanying materials + * are made available under the terms of the Eclipse Public License v2.0 + * which accompanies this distribution, and is available at + * http://www.eclipse.org/legal/epl-v20.html + * + * SPDX-FileCopyrightText: Eclipse Dirigible contributors + * SPDX-License-Identifier: EPL-2.0 + */ +/* + * The single navigation group of the Partner shell: every partner perspective declares + * groupId 'partner', defined once here (the same one-definition pattern as the application shell's + * navigation groups). + */ +exports.getPerspectiveGroup = () => ({ + id: 'partner', + label: 'Partner', + order: 10, + // The service classifies a group by the presence of `items` - the aggregated personal + // perspectives are pushed into it by groupId. + items: [] +}); diff --git a/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/configs/shell.js b/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/configs/shell.js new file mode 100644 index 00000000000..f4e9a781530 --- /dev/null +++ b/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/configs/shell.js @@ -0,0 +1,19 @@ +/* + * Copyright (c) 2026 Eclipse Dirigible contributors + * + * All rights reserved. This program and the accompanying materials + * are made available under the terms of the Eclipse Public License v2.0 + * which accompanies this distribution, and is available at + * http://www.eclipse.org/legal/epl-v20.html + * + * SPDX-FileCopyrightText: Eclipse Dirigible contributors + * SPDX-License-Identifier: EPL-2.0 + */ +const shellData = { + id: 'partnerShell', + path: '/services/web/partner/index.html', + label: 'Partner' +}; +if (typeof exports !== 'undefined') { + exports.getShell = () => shellData; +} diff --git a/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/css/app.css b/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/css/app.css new file mode 100644 index 00000000000..10ef13221ea --- /dev/null +++ b/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/css/app.css @@ -0,0 +1,16 @@ +/* + * Copyright (c) 2010-2026 Eclipse Dirigible contributors + * SPDX-License-Identifier: EPL-2.0 + * + * Minimal shell styles on top of Harmonia. Layout is Harmonia's (vbox/hbox/size-full/x-h-*); this + * only hides x-cloak content until Alpine initialises and ensures the hosted iframe fills its panel. + */ +[x-cloak] { + display: none !important; +} + +html, +body { + height: 100%; + margin: 0; +} diff --git a/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/extension-points/partner-perspective.extensionpoint b/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/extension-points/partner-perspective.extensionpoint new file mode 100644 index 00000000000..8d902821272 --- /dev/null +++ b/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/extension-points/partner-perspective.extensionpoint @@ -0,0 +1,4 @@ +{ + "name": "application-partner-perspectives", + "description": "Extension Point for the External partner perspective providers, aggregated by the Partner shell" +} diff --git a/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/extensions/partner-group.extension b/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/extensions/partner-group.extension new file mode 100644 index 00000000000..c1d56c064f6 --- /dev/null +++ b/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/extensions/partner-group.extension @@ -0,0 +1,5 @@ +{ + "module": "partner/configs/partner-group.js", + "extensionPoint": "application-partner-perspectives", + "description": "Partner Shell - the 'partner' navigation group" +} diff --git a/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/extensions/shell.extension b/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/extensions/shell.extension new file mode 100644 index 00000000000..b63d66d9c25 --- /dev/null +++ b/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/extensions/shell.extension @@ -0,0 +1,5 @@ +{ + "module": "partner/configs/shell.js", + "extensionPoint": "platform-shells", + "description": "Partner Shell" +} diff --git a/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/index.html b/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/index.html new file mode 100644 index 00000000000..a05cdda5eba --- /dev/null +++ b/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/index.html @@ -0,0 +1,339 @@ + + + + + + + + + + + + Partner + + + + + + + + + + + +
+
+
+ + +
+ + +
+
+ +
+ + +
+ +
+ +
+
+
+
    + +
  • + +
    • +
+
+
+ + +
+
+ + + +
+ + +
+
    +
  • + +
    • +
+
+
+
+ + +
+
+
+ + +
+ + + + +
+
+ +
+ +
+
+
    + +
+
+ + + +
    +
    +
    +
    +
    +
    +
    +
    +
  • + +
    • +
+
+ + +
+ +
+
+ +
+
+
+ +
+ + +
+
+
+

+ +
+
+ +
+
+
+ + +
+
+
+

+ +
+
+ +
+
+
+ + +
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/js/appShell.js b/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/js/appShell.js new file mode 100644 index 00000000000..08001dabf22 --- /dev/null +++ b/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/js/appShell.js @@ -0,0 +1,590 @@ +/* + * Copyright (c) 2010-2026 Eclipse Dirigible contributors + * SPDX-License-Identifier: EPL-2.0 + * + * The Harmonia application shell controller. It reuses the shared Harmonia runtime + * (/services/web/application-core/shell) for the built-in pages (Dashboard/Inbox/Documents/Reports, + * Pinecone-routed into #app) and aggregates the `application-perspectives` extension point for the + * domain apps, which it hosts in an iframe (their generated SPA in embedded mode). + * + * Only NAMED perspective groups are shown (the platform's ungrouped/utility AngularJS perspectives - + * e.g. the old Settings - are intentionally excluded; this is the pure-Harmonia application layer). + */ +const PERSPECTIVES_URL = '/services/js/platform-core/extension-services/perspectives.js?extensionPoints=application-partner-perspectives'; +const PROJECTIONS_URL = '/services/js/platform-core/extension-services/projections.js?extensionPoints=partner-shell-no-projections'; +// Last selected projection, persisted like the theme/language flags (shared localStorage convention). +const PROJECTION_KEY = 'codbex.harmonia.projection'; + +document.addEventListener('alpine:init', () => { + window.PineconeRouter.settings({ + basePath: (App.config && App.config.basePath) || '', + hash: true + }); + + Alpine.data('app', () => ({ + hiddenPanels: { left: false }, + isOpen: false, + currentPath: '/dashboard', + loading: true, + groups: [], + // Projections: named lenses over the deployed module set (the `application-projections` + // extension point). With 2+ the sidebar header becomes a Harmonia product switcher and the + // selected projection filters the sidebar groups / reports / dashboard tiles / settings. + // With 0 or 1 no switcher is shown (a single projection still filters). + projections: [], + projectionId: '', + // The currently hosted domain app (a perspective). When set, the iframe is shown instead of #app. + hostedUrl: '', + hostedId: '', + // Settings: the SETTING entities from every app (the 'settings' perspective group), surfaced as a + // single footer entry + master-detail page (list left, the selected setting hosted in an iframe). + settingsItems: [], + settingsMode: false, + settingsSelected: '', + settingsUrl: '', + // Region & Language: the platform-wide language flag (the shared locale store), offered here + // because the shell's Settings is where users look for it. The offered codes are the PLATFORM's + // supported set (DIRIGIBLE_APPLICATION_LANGUAGES via the locale store) - modules never define + // what the stack supports. Each app's generated js/config.js declares which languages it + // PROVIDES translations for; apps missing a platform language are listed as warnings so + // developers know where translations are still needed (data falls back to the default language). + language: 'en', + appLanguages: [], + // Tenant Configuration: a built-in settings entry showing the predefined, per-tenant-overridable + // properties (the branding properties for now). Backed by the platform endpoint + // /services/core/configurations/tenant; requires ADMINISTRATOR/OPERATOR (a 403 is surfaced as a + // read-only notice). Each entry is { key, value }; an empty value means "not overridden". + tenantConfig: [], + tenantConfigLoading: false, + tenantConfigSaving: false, + tenantConfigError: null, + + /** A human-friendly label for a predefined key, derived from its DIRIGIBLE_BRANDING_* name. */ + tenantConfigLabel(key) { + return key.replace(/^DIRIGIBLE_BRANDING_/, '') + .toLowerCase() + .replace(/_/g, ' ') + .replace(/\b\w/g, (c) => c.toUpperCase()); + }, + + /** Load the predefined properties and the current tenant's value for each. */ + async loadTenantConfig() { + this.tenantConfigLoading = true; + this.tenantConfigError = null; + try { + const res = await fetch('/services/core/configurations/tenant/predefined', { + credentials: 'same-origin', + headers: { 'Accept': 'application/json' } + }); + if (res.status === 403) { + this.tenantConfig = []; + this.tenantConfigError = 'forbidden'; + return; + } + if (!res.ok) throw new Error('HTTP ' + res.status); + const data = await res.json(); + this.tenantConfig = data.map((e) => ({ key: e.key, value: e.value == null ? '' : e.value })); + } catch (e) { + console.error('tenant-configuration: failed to load', e); + this.tenantConfig = []; + this.tenantConfigError = 'load'; + } finally { + this.tenantConfigLoading = false; + this.refreshIcons(); + } + }, + + /** Persist the edited values: a non-empty value is stored (PUT), an emptied one is cleared (DELETE). */ + async saveTenantConfig() { + this.tenantConfigSaving = true; + this.tenantConfigError = null; + try { + for (const entry of this.tenantConfig) { + const value = (entry.value || '').trim(); + if (value.length) { + const res = await fetch('/services/core/configurations/tenant', { + method: 'PUT', + credentials: 'same-origin', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ key: entry.key, value: value }) + }); + if (!res.ok) throw new Error('PUT ' + entry.key + ' -> HTTP ' + res.status); + } else { + const res = await fetch('/services/core/configurations/tenant?key=' + encodeURIComponent(entry.key), { + method: 'DELETE', + credentials: 'same-origin' + }); + if (!res.ok && res.status !== 404) throw new Error('DELETE ' + entry.key + ' -> HTTP ' + res.status); + } + } + await this.loadTenantConfig(); + } catch (e) { + console.error('tenant-configuration: failed to save', e); + this.tenantConfigError = 'save'; + } finally { + this.tenantConfigSaving = false; + } + }, + + // Language coverage of the embedded apps: which languages each generated app PROVIDES + // translations for (its js/config.js carries `languages: [...]` from the intent; the config is + // a JS file, so the array is read with a targeted match rather than executed). One entry per + // project; an app without a readable declaration counts as providing only the default language. + async loadLanguageCoverage(perspectives) { + const bases = new Map(); + const collect = (item) => { + const path = item && item.path; + const match = typeof path === 'string' && path.match(/^\/services\/web\/([^\/]+)\/([^#?]*\/)?index\.html/); + if (match && !bases.has(match[1])) bases.set(match[1], '/services/web/' + match[1] + '/' + (match[2] || '')); + }; + (perspectives || []).forEach(g => Array.isArray(g.items) ? g.items.forEach(collect) : collect(g)); + const coverage = await Promise.all([...bases].map(async ([app, base]) => { + let provided = ['en']; + try { + const res = await fetch(base + 'js/config.js', { credentials: 'same-origin' }); + if (res.ok) { + const match = (await res.text()).match(/languages:\s*(\[[^\]]*\])/); + if (match) { + const codes = JSON.parse(match[1].replace(/'/g, '"')); + if (Array.isArray(codes) && codes.length) provided = codes; + } + } + } catch (e) { /* undeclared coverage counts as default-language only */ } + return { app, provided }; + })); + this.appLanguages = coverage; + }, + + // Apps that do not provide every platform language - the developers' to-do list for missing + // translation content. Reactive on both the coverage scan and the platform set. + languageWarnings() { + const platform = Alpine.store('locale').languages(); + return this.appLanguages + .map(({ app, provided }) => ({ app, missing: platform.filter(code => !provided.includes(code)) })) + .filter(({ missing }) => missing.length > 0); + }, + + // The platform's language codes with display names for the Settings picker. + languageOptions() { + const locale = Alpine.store('locale'); + return locale.languages().map(code => ({ value: code, text: locale.displayName(code) })); + }, + + async init() { + const projectionsLoaded = this.loadProjections(); + try { + const res = await fetch(PERSPECTIVES_URL, { headers: { 'Accept': 'application/json' } }); + if (res.ok) { + const data = await res.json(); + // Domain apps live in named groups; skip the platform's 'undefined-group' and utilities + // (those are the legacy AngularJS perspectives, which do not belong in the Harmonia shell). + // Every app's SETTING entities are shown under the dedicated Settings footer entry, never in + // the sidebar - whether they were declared inside a nav group or with no group at all. A + // perspective is a setting when its kind is SETTING (from the generator); the legacy 'settings' + // group id is a fallback for apps generated before the kind tag existed. + const all = Array.isArray(data.perspectives) ? data.perspectives : []; + const settings = []; + const appGroups = []; + // App entities declared without a navigation group come back as standalone PRIMARY + // perspectives (no `items`); collect them into a catch-all "Other" section so they are + // still reachable from the shared shell instead of being silently dropped. SETTING ones go to + // the Settings footer; the shell's own built-ins (dashboard/inbox/documents - no `kind`) are + // rendered natively and must not be re-listed here. + const ungrouped = []; + all.forEach(g => { + if (Array.isArray(g.items)) { + // A navigation group: pull its SETTING entities into Settings, keep the rest in the sidebar. + const isSetting = (it) => it.kind === 'SETTING' || g.id === 'settings'; + settings.push(...g.items.filter(isSetting)); + const keep = g.items.filter(it => !isSetting(it)); + if (g.id !== 'undefined-group' && keep.length) { + appGroups.push(Object.assign({}, g, { items: keep })); + } + } else if (g.path && g.kind === 'SETTING') { + // A standalone setting perspective declared with no navigation group. + settings.push(g); + } else if (g.path && g.kind === 'PRIMARY') { + // A standalone (un-grouped) app entity perspective. + ungrouped.push(g); + } + }); + // Settings entities are listed alphabetically by label. + settings.sort((a, b) => (a.label || '').toLowerCase().localeCompare((b.label || '').toLowerCase())); + // Append the catch-all "Other" group last, after the named navigation groups, sorted by the + // perspective's declared order then label so output is stable. + if (ungrouped.length) { + ungrouped.sort((a, b) => (a.order || 0) - (b.order || 0) + || (a.label || '').toLowerCase().localeCompare((b.label || '').toLowerCase())); + appGroups.push({ id: 'other', label: 'Other', tkey: 'application-core:shell.nav.other', items: ungrouped }); + } + this.groups = appGroups; + this.settingsItems = settings; + // Fire-and-forget: load the contributing apps' i18n catalogs so the sidebar / dashboard / + // Settings entries translate. Each perspective's tkey is ':' - the project + // is the catalog namespace, which the shell (having no project of its own) must add. + if (window.AppI18nAddNamespaces) { + const namespaces = [...new Set(all.flatMap(g => Array.isArray(g.items) ? g.items : [g]) + .map(it => (it.tkey || '').split(':')[0]) + .filter(ns => ns && ns !== 'application-core'))]; + AppI18nAddNamespaces(namespaces); + } + // Fire-and-forget: scan which languages each embedded app provides translations for + // (drives the missing-translations warnings in Settings). + this.loadLanguageCoverage(all); + } + } catch (e) { + console.error('Failed to load application perspectives', e); + } + await projectionsLoaded; + this.loading = false; + + // Mirror the shared locale store so the Settings picker has a plain bindable property; + // persisting goes through the store (the fetch client sends it as Accept-Language). + const locale = Alpine.store('locale'); + if (locale) { + this.language = locale.value; + this.$watch('language', (v) => locale.set(v)); + } + + // Reports are discovered asynchronously (the store walks the registry). Once its items arrive, + // re-resolve a deep-linked /reports/ so a refresh on that URL lands on the right report + // instead of the "Select a report" empty state. + this.$watch('$store.reports.loaded', () => { + if (this.currentPath === '/reports' || this.currentPath.indexOf('/reports/') === 0) { + this.selectReportByName(this.currentPath.indexOf('/reports/') === 0 + ? decodeURIComponent(this.currentPath.slice('/reports/'.length)) + : ''); + } + }); + + // Resolve shell state from the current route. Hosted domain apps are addressable as + // /app/[/]; everything else is a built-in page rendered into #app. + // The inner route is the iframe app's own hash route (e.g. /SalesInvoice/42/edit), so the top + // URL stays in sync with what the embedded app shows and is deep-linkable. + const applyRoute = () => { + // Read the live URL hash, not PineconeRouter.context.path: for a template-less route (our + // /app/:id route) Pinecone fires pinecone:end BEFORE it assigns the new context, so context + // would be stale here - but history.pushState has already updated the hash by then. + const h = window.location.hash || ''; + let p = (h.charAt(0) === '#' ? h.slice(1) : h) || '/'; + if (p === '/') p = '/dashboard'; + this.currentPath = p; + // Landing on the dashboard: re-pull the KPI widget values so freshly entered records show + // without a full browser refresh (the reports store memoizes, so force a reload). + if (p === '/dashboard') { + const reports = Alpine.store('reports'); + if (reports) reports.loadWidgets(true); + } + if (p === '/settings' || p.indexOf('/settings/') === 0) { + // Settings master-detail: /settings (list only) or /settings/ (one selected). + this.settingsMode = true; + this.hostedId = ''; + this.hostedUrl = ''; + const rest = p.indexOf('/settings/') === 0 ? p.slice('/settings/'.length) : ''; + if (rest) { + const item = this.findSettingItem(decodeURIComponent(rest)); + if (item) { + this.settingsSelected = item.id; + this.settingsUrl = item.path || ''; + if (item.id === 'tenant-configuration') this.loadTenantConfig(); + } + } + } else { + this.settingsMode = false; + const match = p.match(/^\/app\/([^/]+)(?:\/(.*))?$/); + if (match) { + const id = decodeURIComponent(match[1]); + const inner = match[2] ? '/' + match[2] : ''; + // Only (re)point the iframe when the app changes - while the same app is hosted the iframe + // owns its inner route, so we must not reset its src (that would reload it and lose state). + if (this.hostedId !== id) { + const item = this.findItem(id); + if (item) { this.hostedId = id; this.hostedUrl = this.appUrl(item, inner); } + } + } else { + this.hostedId = ''; + this.hostedUrl = ''; + // Reports deep-link: /reports/ selects that report so a browser refresh restores it. + // The store may still be loading (its items arrive asynchronously) - the `$store.reports.loaded` + // watcher below re-resolves once they do. + if (p === '/reports' || p.indexOf('/reports/') === 0) { + this.selectReportByName(p.indexOf('/reports/') === 0 ? decodeURIComponent(p.slice('/reports/'.length)) : ''); + } + } + } + this.refreshIcons(); + }; + window.addEventListener('popstate', applyRoute); + document.addEventListener('pinecone:end', applyRoute); + // Resolve the initial route now that the perspectives are loaded (handles deep links / reloads). + applyRoute(); + + this._bp = Harmonia.getBreakpointListener((isNarrow) => { + this.hiddenPanels.left = isNarrow; + if (isNarrow) { + this.$refs.overlay.appendChild(this.$refs.sidebar); + } else { + this.$refs.sidebarPanel.appendChild(this.$refs.sidebar); + } + }, 1024); + + this.$nextTick(() => this.refreshIcons()); + }, + + destroy() { if (this._bp) this._bp.remove(); }, + + /** Navigate to a built-in page (Pinecone route into #app); applyRoute clears any hosted app. */ + navigate(route) { + this.settingsMode = false; + window.PineconeRouter.navigate(route); + this.closeSideNav(); + }, + + /** Open a discovered report deep-linkably: the report name goes in the URL (/reports/) so a + * refresh restores it. applyRoute (and the reports-loaded watcher) resolve the store selection. */ + openReport(report) { + this.navigate('/reports/' + encodeURIComponent(report.name)); + }, + + /** Select the discovered report with this name (from the shared reports store) for the Reports page. + * A blank name (bare /reports) clears the selection so the empty state shows; an unknown name (the + * store not loaded yet) leaves it null until the loaded watcher re-resolves. */ + selectReportByName(name) { + const store = Alpine.store('reports'); + if (!store) { + return; + } + store.selected = name ? (store.items || []).find(r => r.name === name) || null : null; + }, + + /** Host a domain app (a perspective) in the iframe. Swap the iframe synchronously on click (do not + * wait for the router's pinecone:end - for a template-less route it can fire before the context is + * ready, leaving the pane stale), then update the URL. applyRoute then no-ops (hostedId already set). */ + openApp(item) { + // Re-clicking the already-hosted app is a no-op: leave its inner route (and the URL) untouched. + if (this.hostedId !== item.id || this.settingsMode) { + this.settingsMode = false; + this.hostedId = item.id; + this.hostedUrl = this.appUrl(item, ''); + this.currentPath = '/app/' + encodeURIComponent(item.id); + window.PineconeRouter.navigate('/app/' + encodeURIComponent(item.id)); + this.refreshIcons(); + } + this.closeSideNav(); + }, + + /** Build the iframe src for a perspective, overriding its hash with `inner` (e.g. /SalesInvoice/42/edit). */ + appUrl(item, inner) { + const path = item.path || ''; + const hashAt = path.indexOf('#'); + const base = hashAt === -1 ? path : path.slice(0, hashAt); + const defaultHash = hashAt === -1 ? '' : path.slice(hashAt + 1); + // Normalize to exactly one leading slash: the inner route is stored without it (mirrorInner + // strips it), but the embedded app's hash router matches "/Entity/:id", so "#Entity/1" misses. + const hash = (inner || defaultHash || '').replace(/^\/+/, ''); + return hash ? base + '#/' + hash : base; + }, + + /** Wire the hosted iframe so its inner navigation is mirrored into the shell's address bar. */ + onIframeLoad(e) { + const win = e.target && e.target.contentWindow; + if (!win) return; + const mirror = () => this.mirrorInner(win); + // The embedded app routes with Pinecone (history.pushState, no hashchange) and signals every + // navigation with a `pinecone:end` event on its own document; popstate covers in-app back/forward. + try { + win.document.addEventListener('pinecone:end', mirror); + win.addEventListener('popstate', mirror); + } catch (err) { return; } // cross-origin guard + win.addEventListener('hashchange', mirror); // fallback for non-Pinecone embedded apps + mirror(); + }, + + /** Reflect the embedded app's current hash route into the top URL as /app//. */ + mirrorInner(win) { + if (!this.hostedId) return; + let hash; + try { hash = win.location.hash || ''; } catch (e) { return; } // cross-origin guard + const inner = hash.replace(/^#\/?/, ''); + const top = '/app/' + encodeURIComponent(this.hostedId) + (inner ? '/' + inner : ''); + const newHash = '#' + top; + if (window.location.hash !== newHash) { + // replaceState updates the address bar without re-triggering the shell router (no reload loop). + history.replaceState(history.state, '', newHash); + this.currentPath = top; + } + }, + + /** Open the Settings master-detail (the aggregated SETTING entities from every app). */ + openSettings() { + this.settingsMode = true; + this.hostedId = ''; + this.hostedUrl = ''; + this.currentPath = '/settings'; + window.PineconeRouter.navigate('/settings'); + this.refreshIcons(); + this.closeSideNav(); + }, + + /** Select a setting entity: host its app at that entity's route in the settings detail iframe. + * Update the URL with replaceState (no Pinecone re-render) so the master-detail split keeps the + * layout it computed when first shown; the detail iframe just swaps its src. */ + selectSetting(item) { + if (this.settingsSelected !== item.id) { + this.settingsSelected = item.id; + this.settingsUrl = item.path || ''; + this.currentPath = '/settings/' + encodeURIComponent(item.id); + const url = '#/settings/' + encodeURIComponent(item.id); + if (window.location.hash !== url && window.history && window.history.replaceState) { + window.history.replaceState(window.history.state, '', url); + } + if (item.id === 'tenant-configuration') this.loadTenantConfig(); + this.refreshIcons(); + } + }, + + isSettingActive(item) { return this.settingsMode && this.settingsSelected === item.id; }, + + /** Find a setting entity (perspective) by id. 'region-language' is the built-in shell entry + * (the platform language preference) - it has no app path; its detail renders locally. */ + findSettingItem(id) { + if (id === 'region-language') return { id: 'region-language' }; + if (id === 'tenant-configuration') return { id: 'tenant-configuration' }; + return (this.settingsItems || []).find(i => i.id === id) || null; + }, + + /** Open the task behind a (task-derived) notification, and mark it read. */ + openNotification(n) { + if (n && n.task) { + this.$store.processTasks.openTask(n.task); + n.unread = false; + } + }, + + /** Find a loaded perspective by id across all groups. */ + findItem(id) { + for (const g of this.groups) { + const item = (g.items || []).find(i => i.id === id); + if (item) return item; + } + return null; + }, + + /** Load the application-projections extension point and restore the persisted selection. + * Role-gated projections are filtered server-side, so what arrives here is what may be offered. */ + async loadProjections() { + try { + const res = await fetch(PROJECTIONS_URL, { headers: { 'Accept': 'application/json' } }); + if (res.ok) { + const data = await res.json(); + this.projections = Array.isArray(data.projections) ? data.projections : []; + } + } catch (e) { + console.error('Failed to load application projections', e); + } + let saved = ''; + try { saved = localStorage.getItem(PROJECTION_KEY) || ''; } catch (e) { /* no storage */ } + this.projectionId = this.projections.some(p => p.id === saved) + ? saved + : (this.projections.length ? this.projections[0].id : ''); + }, + + /** The currently selected projection entry (for the product-switch header), or null. */ + selectedProjection() { return this.projections.find(p => p.id === this.projectionId) || null; }, + + /** The projection that FILTERS the shell: null when none is selected or the selected one is + * the declared "everything" entry (all: true), in which case nothing is filtered. */ + activeProjection() { + const p = this.selectedProjection(); + return p && !p.all ? p : null; + }, + + /** Switch the product-switch selection; persist it and leave a now-hidden hosted app. */ + selectProjection(p) { + if (this.projectionId === p.id) return; + this.projectionId = p.id; + try { localStorage.setItem(PROJECTION_KEY, p.id); } catch (e) { /* no storage */ } + if (this.hostedId && !this.visibleGroups().some(g => (g.items || []).some(i => i.id === this.hostedId))) { + this.navigate('/dashboard'); + } + this.refreshIcons(); + }, + + projectionLabel() { + const p = this.selectedProjection(); + return p ? (p.tkey ? T(p.tkey, p.label) : p.label) : ''; + }, + + /** Second line under the product name; the instance brand is the default. */ + projectionSubtitle() { + const p = this.selectedProjection(); + return (p && p.description) || Alpine.store('branding').name || ''; + }, + + /** The sidebar groups the active projection keeps: listed groups wholesale, plus any group + * reduced to its cherry-picked `items` (Employee-Portal-style selections keep their familiar + * group heading); empty groups vanish. No active projection = everything. */ + visibleGroups() { + const proj = this.activeProjection(); + if (!proj) return this.groups; + const groupIds = proj.groups || []; + const itemIds = proj.items || []; + const visible = []; + for (const g of this.groups) { + if (groupIds.includes(g.id)) { + visible.push(g); + continue; + } + const picked = (g.items || []).filter(i => itemIds.includes(i.id)); + if (picked.length) visible.push(Object.assign({}, g, { items: picked })); + } + return visible; + }, + + /** The projects contributing the visible perspectives — the projection's reach, used to scope + * reports, dashboard tiles and settings to the apps actually shown. */ + projectionProjects() { + const projects = new Set(); + this.visibleGroups().forEach(g => (g.items || []).forEach(item => { + const match = typeof item.path === 'string' && item.path.match(/^\/services\/web\/([^/]+)\//); + if (match) projects.add(match[1]); + })); + return projects; + }, + + /** Whether a URL (report page, setting entity) belongs to a project inside the active + * projection. Unattributable URLs stay visible — filtering must not hide what it can't place. */ + inProjection(url) { + if (!this.activeProjection()) return true; + const match = typeof url === 'string' && url.match(/^\/services\/web\/([^/]+)\//); + return match ? this.projectionProjects().has(match[1]) : true; + }, + + visibleReports() { return Alpine.store('reports').items.filter(r => this.inProjection(r.url)); }, + dashKpiReports() { return Alpine.store('reports').kpiReports().filter(r => this.inProjection(r.url)); }, + dashPreviewReports() { return Alpine.store('reports').previewReports().filter(r => this.inProjection(r.url)); }, + + /** Settings entities scoped to the projection: explicitly cherry-picked ones always show. */ + visibleSettingsItems() { + const proj = this.activeProjection(); + if (!proj) return this.settingsItems; + const itemIds = proj.items || []; + return this.settingsItems.filter(it => itemIds.includes(it.id) || this.inProjection(it.path)); + }, + + isBuiltinActive(route) { return !this.hostedUrl && this.currentPath === route; }, + isAppActive(item) { return this.hostedId === item.id; }, + // A report entry is active only while a report route is showing it — keying off the current route + // (not just $store.reports.selected) so navigating to an entity/inbox/documents clears its highlight. + isReportActive(report) { + const selected = Alpine.store('reports').selected; + return !this.hostedUrl && this.currentPath.indexOf('/reports') === 0 && selected && selected.url === report.url; + }, + isSvgIcon(icon) { return !!icon && /\.svg(\?|#|$)/i.test(icon); }, + isImageIcon(icon) { return !!icon && !this.isSvgIcon(icon) && (icon.indexOf('/') !== -1 || icon.indexOf('.') !== -1 || icon.indexOf('http') === 0); }, + + openSideNav() { this.isOpen = true; }, + closeSideNav() { if (window.matchMedia('(max-width: 1024px)').matches) this.isOpen = false; }, + refreshIcons() {}, // no-op: Lucide icons render via the x-h-lucide directive (harmonia-lucide bundle) + })); +}, { once: true }); diff --git a/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/js/config.js b/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/js/config.js new file mode 100644 index 00000000000..c225a7f5ce3 --- /dev/null +++ b/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/js/config.js @@ -0,0 +1,18 @@ +/* + * Copyright (c) 2010-2026 Eclipse Dirigible contributors + * SPDX-License-Identifier: EPL-2.0 + * + * Runtime configuration for the partner Harmonia shell. The shared shell runtime + * (/services/web/application-core/shell/...) reads its wiring from window.App.config, exactly like a + * generated app does. The Partner shell surfaces the external partner's perspectives and serves the + * built-in pages itself, so it has no own REST entities. + */ +window.App = window.App || {}; +App.config = { + projectName: 'partner', + basePath: '/services/web/partner', + // No own entities; the built-in stores (inbox/documents) call platform services directly. + restBase: '', + // The Partner shell is an external-surfaces shell - it does not aggregate reports across apps. + aggregateReports: false +}; diff --git a/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/views/_settings.html b/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/views/_settings.html new file mode 100644 index 00000000000..32d5e0d1335 --- /dev/null +++ b/components/resources/resources-partner/src/main/resources/META-INF/dirigible/partner/views/_settings.html @@ -0,0 +1,143 @@ + +
+
+
+ + + + + + +
+
+
+
+
+
+
+
+
+
+ +
+
+
+ + +
+
+ +
+ +
+ +
+
+
+ +
+ + +
+
+ + +
+
+ + +
+
+ + +
+
+ + +
+ +
+
+ +
+
+
+ + +
+ + + +
+
+ +
+