@efa-one/sdk 1.10.1

package/backend/serviceClient.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serviceClient = exports.ServiceClient = void 0;
+function log(level, msg, extra) {
+    console.log(JSON.stringify({ level, msg, timestamp: new Date().toISOString(), ...extra }));
+}
+class ServiceClient {
+    constructor(options) {
+        this.gatewayUrl = (options?.gatewayUrl ?? process.env.CONVERGE_GATEWAY_URL ?? '').replace(/\/$/, '');
+        this.registryKey = options?.registryKey ?? process.env.SERVICE_AUTH_KEY ?? '';
+        this.fetchImpl = options?.fetchImpl ?? fetch;
+        this.retries = options?.retries ?? 2;
+        this.retryDelay = options?.retryDelayMs ?? 1000;
+    }
+    async call(serviceKey, method, path, body) {
+        if (!this.gatewayUrl) {
+            throw new Error('ServiceClient: CONVERGE_GATEWAY_URL nicht gesetzt');
+        }
+        const normalizedPath = path.startsWith('/') ? path.slice(1) : path;
+        const url = `${this.gatewayUrl}/api/gateway/${encodeURIComponent(serviceKey)}/${normalizedPath}`;
+        const headers = {
+            'Content-Type': 'application/json',
+            'Accept': 'application/json',
+        };
+        if (this.registryKey) {
+            headers['X-Service-Auth-Key'] = this.registryKey;
+        }
+        const fetchOptions = { method, headers };
+        if (body !== undefined && method !== 'GET' && method !== 'HEAD') {
+            fetchOptions.body = JSON.stringify(body);
+        }
+        for (let attempt = 1; attempt <= this.retries + 1; attempt++) {
+            try {
+                const res = await this.fetchImpl(url, fetchOptions);
+                if (res.status === 204) {
+                    return undefined;
+                }
+                if (!res.ok) {
+                    let errorMessage = `ServiceClient: ${serviceKey} ${method} ${path} → ${res.status}`;
+                    try {
+                        const errBody = await res.json();
+                        if (errBody.error)
+                            errorMessage = errBody.error;
+                    }
+                    catch { }
+                    if (res.status >= 400 && res.status < 500) {
+                        throw new Error(errorMessage);
+                    }
+                    if (attempt <= this.retries) {
+                        log('warn', 'ServiceClient: Retry nach Server-Fehler', {
+                            serviceKey, method, path, status: res.status, attempt,
+                        });
+                        await new Promise((r) => setTimeout(r, this.retryDelay));
+                        continue;
+                    }
+                    throw new Error(errorMessage);
+                }
+                return res.json();
+            }
+            catch (err) {
+                if (err instanceof Error && !err.message.startsWith('ServiceClient:')) {
+                    if (attempt <= this.retries) {
+                        log('warn', 'ServiceClient: Netzwerkfehler, Retry', {
+                            serviceKey, method, path, err: String(err), attempt,
+                        });
+                        await new Promise((r) => setTimeout(r, this.retryDelay));
+                        continue;
+                    }
+                }
+                throw err;
+            }
+        }
+        throw new Error(`ServiceClient: Alle Versuche fehlgeschlagen für ${serviceKey} ${method} ${path}`);
+    }
+}
+exports.ServiceClient = ServiceClient;
+exports.serviceClient = new ServiceClient();

package/backend/serviceDiscovery.d.ts

@@ -0,0 +1,28 @@
+export type RegistryStatus = 'running' | 'stopped' | 'not_found' | 'error';
+export interface ResolveServiceResponse {
+    serviceKey: string;
+    baseUrlInternal: string;
+    healthUrl: string;
+    openApiUrl: string | null;
+    status: RegistryStatus;
+}
+export interface RegistryServiceDetailResponse extends ResolveServiceResponse {
+    capabilities: Array<{
+        id: string;
+        serviceId: string;
+        capabilityKey: string;
+        endpointPath: string;
+        method: string;
+        version: string | null;
+    }>;
+}
+export declare function clearServiceDiscoveryCache(): void;
+export declare function resolveService(serviceKey: string, options?: {
+    registryBaseUrl?: string;
+    ttlMs?: number;
+    fetchImpl?: typeof fetch;
+}): Promise<ResolveServiceResponse>;
+export declare function resolveServiceDetail(serviceKey: string, options?: {
+    registryBaseUrl?: string;
+    fetchImpl?: typeof fetch;
+}): Promise<RegistryServiceDetailResponse>;

package/backend/serviceDiscovery.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearServiceDiscoveryCache = clearServiceDiscoveryCache;
+exports.resolveService = resolveService;
+exports.resolveServiceDetail = resolveServiceDetail;
+const cache = new Map();
+function normalizeRegistryBaseUrl(registryBaseUrl) {
+    return registryBaseUrl.replace(/\/$/, '');
+}
+function clearServiceDiscoveryCache() {
+    cache.clear();
+}
+async function resolveService(serviceKey, options) {
+    const ttlMs = options?.ttlMs ?? 60000;
+    const now = Date.now();
+    const cached = cache.get(serviceKey);
+    if (cached && cached.expiresAt > now)
+        return cached.value;
+    const fetchImpl = options?.fetchImpl ?? fetch;
+    const baseUrl = normalizeRegistryBaseUrl(options?.registryBaseUrl ?? process.env.CONVERGE_REGISTRY_URL ?? '');
+    if (!baseUrl) {
+        throw new Error('CONVERGE_REGISTRY_URL ist nicht gesetzt');
+    }
+    const headers = { Accept: 'application/json' };
+    const registryKey = process.env.SERVICE_AUTH_KEY;
+    if (registryKey)
+        headers['X-Service-Auth-Key'] = registryKey;
+    const response = await fetchImpl(`${baseUrl}/api/registry/resolve/${encodeURIComponent(serviceKey)}`, {
+        method: 'GET',
+        headers,
+    });
+    if (!response.ok) {
+        throw new Error(`Service-Aufloesung fehlgeschlagen (${response.status})`);
+    }
+    const resolved = await response.json();
+    cache.set(serviceKey, { value: resolved, expiresAt: now + ttlMs });
+    return resolved;
+}
+async function resolveServiceDetail(serviceKey, options) {
+    const fetchImpl = options?.fetchImpl ?? fetch;
+    const baseUrl = normalizeRegistryBaseUrl(options?.registryBaseUrl ?? process.env.CONVERGE_REGISTRY_URL ?? '');
+    if (!baseUrl) {
+        throw new Error('CONVERGE_REGISTRY_URL ist nicht gesetzt');
+    }
+    const detailHeaders = { Accept: 'application/json' };
+    const detailRegistryKey = process.env.SERVICE_AUTH_KEY;
+    if (detailRegistryKey)
+        detailHeaders['X-Service-Auth-Key'] = detailRegistryKey;
+    const response = await fetchImpl(`${baseUrl}/api/registry/services/${encodeURIComponent(serviceKey)}`, {
+        method: 'GET',
+        headers: detailHeaders,
+    });
+    if (!response.ok) {
+        throw new Error(`Service-Details konnten nicht geladen werden (${response.status})`);
+    }
+    return response.json();
+}

package/frontend/DevHeader.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+interface DevHeaderProps {
+    appName: string;
+    onBack: () => void;
+    onSettings: () => void;
+}
+export default function DevHeader({ appName, onBack, onSettings }: DevHeaderProps): React.JSX.Element | null;
+export {};

package/frontend/DevHeader.js

@@ -0,0 +1,42 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export default function DevHeader({ appName, onBack, onSettings }) {
+    if (window.self !== window.top)
+        return null;
+    return (_jsxs("header", { style: {
+            display: 'flex',
+            alignItems: 'center',
+            gap: '12px',
+            padding: '0 16px',
+            height: '52px',
+            background: '#1e293b',
+            color: '#f1f5f9',
+            flexShrink: 0,
+            fontFamily: 'system-ui, sans-serif',
+            fontSize: '14px',
+        }, children: [_jsx("span", { style: {
+                    background: '#f59e0b',
+                    color: '#1c1917',
+                    fontSize: '11px',
+                    fontWeight: 700,
+                    padding: '2px 8px',
+                    borderRadius: '4px',
+                    letterSpacing: '0.05em',
+                    flexShrink: 0,
+                }, children: "DEV MODE" }), _jsx("button", { onClick: onBack, title: "Back to dashboard", style: {
+                    background: 'transparent',
+                    border: '1px solid #475569',
+                    color: '#94a3b8',
+                    borderRadius: '6px',
+                    padding: '4px 10px',
+                    cursor: 'pointer',
+                    fontSize: '13px',
+                }, children: "\u2190 Back" }), _jsx("span", { style: { fontWeight: 600, color: '#f1f5f9', flex: 1 }, children: appName }), _jsx("button", { onClick: onSettings, title: "Settings", style: {
+                    background: 'transparent',
+                    border: 'none',
+                    color: '#94a3b8',
+                    cursor: 'pointer',
+                    fontSize: '18px',
+                    padding: '4px 8px',
+                    borderRadius: '6px',
+                }, children: "\u2699" })] }));
+}

package/frontend/i18n.d.ts

@@ -0,0 +1,3 @@
+import i18n from 'i18next';
+export declare function initI18n(defaultLanguage?: string): typeof i18n;
+export { i18n };

package/frontend/i18n.js

@@ -0,0 +1,16 @@
+import i18n from 'i18next';
+import { initReactI18next } from 'react-i18next';
+import HttpBackend from 'i18next-http-backend';
+export function initI18n(defaultLanguage = 'de') {
+    i18n
+        .use(HttpBackend)
+        .use(initReactI18next)
+        .init({
+        lng: defaultLanguage,
+        fallbackLng: 'de',
+        interpolation: { escapeValue: false },
+        backend: { loadPath: '/locales/{{lng}}/translation.json' },
+    });
+    return i18n;
+}
+export { i18n };

package/frontend/index.d.ts

@@ -0,0 +1,3 @@
+export * from './ipc';
+export * from './i18n';
+export { default as DevHeader } from './DevHeader';

package/frontend/index.js

@@ -0,0 +1,3 @@
+export * from './ipc';
+export * from './i18n';
+export { default as DevHeader } from './DevHeader';

package/frontend/ipc.d.ts

@@ -0,0 +1,11 @@
+export declare function getParentOrigin(): string;
+export declare function isFromPlatformParent(event: MessageEvent): boolean;
+export declare function sendAtStart(): void;
+export declare function sendDeclareAppInfo(payload: {
+    appName: string;
+    version: string;
+}): void;
+export declare function navigateToApp(serviceKey: string, options?: {
+    path?: string;
+}): void;
+export declare function notifyRouteChange(path: string): void;

package/frontend/ipc.js

@@ -0,0 +1,39 @@
+function isEmbedded() {
+    try {
+        return window.parent !== window;
+    }
+    catch {
+        return false;
+    }
+}
+export function getParentOrigin() {
+    try {
+        return window.location.ancestorOrigins?.[0] ?? window.location.origin;
+    }
+    catch {
+        return window.location.origin;
+    }
+}
+export function isFromPlatformParent(event) {
+    return event.source === window.parent;
+}
+export function sendAtStart() {
+    if (!isEmbedded())
+        return;
+    window.parent.postMessage({ type: 'CONVERGE_AT_START' }, getParentOrigin());
+}
+export function sendDeclareAppInfo(payload) {
+    if (!isEmbedded())
+        return;
+    window.parent.postMessage({ type: 'CONVERGE_DECLARE_APP_INFO', payload }, getParentOrigin());
+}
+export function navigateToApp(serviceKey, options) {
+    if (!isEmbedded())
+        return;
+    window.parent.postMessage({ type: 'CONVERGE_NAVIGATE_TO_APP', payload: { serviceKey, path: options?.path } }, getParentOrigin());
+}
+export function notifyRouteChange(path) {
+    if (!isEmbedded())
+        return;
+    window.parent.postMessage({ type: 'CONVERGE_ROUTE_CHANGED', path }, getParentOrigin());
+}

package/frontend/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "@efa-one/sdk",
+  "version": "1.10.1",
+  "description": "Offizielles SDK für efa-one-Apps: Auth/Session, Service-Discovery, Gateway-Client, Audit/Reporting/Mail/Notifications, Permission- und Capability-Registrierung sowie das Frontend-IPC-/i18n-Toolkit.",
+  "license": "Apache-2.0",
+  "type": "commonjs",
+  "exports": {
+    "./backend": {
+      "types": "./backend/index.d.ts",
+      "require": "./backend/index.js",
+      "default": "./backend/index.js"
+    },
+    "./backend/*": {
+      "types": "./backend/*.d.ts",
+      "require": "./backend/*.js",
+      "default": "./backend/*.js"
+    },
+    "./frontend": {
+      "types": "./frontend/index.d.ts",
+      "import": "./frontend/index.js",
+      "default": "./frontend/index.js"
+    },
+    "./frontend/*": {
+      "types": "./frontend/*.d.ts",
+      "import": "./frontend/*.js",
+      "default": "./frontend/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "backend",
+    "frontend",
+    "NOTICE"
+  ],
+  "scripts": {
+    "clean": "rm -rf backend frontend",
+    "build:backend": "tsc -p tsconfig.backend.json",
+    "build:frontend": "tsc -p tsconfig.frontend.json && node -e \"require('fs').writeFileSync('frontend/package.json', JSON.stringify({type:'module'}))\"",
+    "build": "npm run clean && npm run build:backend && npm run build:frontend",
+    "typecheck": "tsc -p tsconfig.backend.json --noEmit && tsc -p tsconfig.frontend.json --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "express": ">=4",
+    "i18next": ">=23",
+    "i18next-http-backend": ">=2",
+    "jsonwebtoken": ">=9",
+    "pg": ">=8",
+    "react": ">=18",
+    "react-i18next": ">=13"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    },
+    "pg": {
+      "optional": true
+    },
+    "jsonwebtoken": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "i18next": {
+      "optional": true
+    },
+    "i18next-http-backend": {
+      "optional": true
+    },
+    "react-i18next": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/jsonwebtoken": "^9.0.6",
+    "@types/node": "^20.14.0",
+    "@types/pg": "^8.11.0",
+    "@types/react": "^18.2.46",
+    "express": "^4.19.2",
+    "i18next": "^23.11.0",
+    "i18next-http-backend": "^2.7.3",
+    "jsonwebtoken": "^9.0.2",
+    "pg": "^8.12.0",
+    "react": "^18.2.0",
+    "react-i18next": "^13.5.0",
+    "typescript": "7.0.2"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}