@cap-js/process 0.0.0 → 0.1.0

package/dist/lib/api/local-workflow-store.js

@@ -0,0 +1,85 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.localWorkflowStore = exports.LocalWorkflowStore = void 0;
+const workflow_client_1 = require("./workflow-client");
+const cds_1 = __importDefault(require("@sap/cds"));
+class LocalWorkflowStore {
+    instances = [];
+    startWorkflow(params) {
+        const { definitionId, businessKey, context = {} } = params;
+        const instance = {
+            id: cds_1.default.utils.uuid(),
+            definitionId,
+            businessKey,
+            status: workflow_client_1.WorkflowStatus.RUNNING,
+            context,
+            attributes: [
+                {
+                    id: 'ExampleCustomAttribute',
+                    label: 'Example of custom attribute',
+                    value: 'PRO_247',
+                    type: 'string',
+                },
+                {
+                    id: 'Cur',
+                    label: 'Currency',
+                    value: 'EUR',
+                    type: 'string',
+                },
+            ],
+            outputs: {
+                processedBy: 'system-admin',
+                completionStatus: 'success',
+            },
+            createdAt: new Date(),
+            updatedAt: new Date(),
+        };
+        this.instances.push(instance);
+        return {
+            id: instance.id,
+            success: true,
+        };
+    }
+    getInstancesByBusinessKey(businessKey, status) {
+        let filtered = this.instances.filter((i) => i.businessKey === businessKey);
+        if (status) {
+            filtered = filtered.filter((i) => status.includes(i.status));
+        }
+        return filtered;
+    }
+    getInstance(instanceId) {
+        return this.instances.find((i) => i.id === instanceId);
+    }
+    updateStatus(instanceId, status) {
+        const instance = this.getInstance(instanceId);
+        if (!instance) {
+            return {
+                id: instanceId,
+                success: false,
+            };
+        }
+        instance.status = status;
+        instance.updatedAt = new Date();
+        return {
+            id: instanceId,
+            success: true,
+        };
+    }
+    updateMultipleStatus(instanceIds, status) {
+        return instanceIds.map((id) => this.updateStatus(id, status));
+    }
+    getAttributes(instanceId) {
+        const instance = this.getInstance(instanceId);
+        return instance?.attributes;
+    }
+    getOutputs(instanceId) {
+        const instance = this.getInstance(instanceId);
+        return instance?.outputs;
+    }
+}
+exports.LocalWorkflowStore = LocalWorkflowStore;
+exports.localWorkflowStore = new LocalWorkflowStore();
+//# sourceMappingURL=local-workflow-store.js.map

package/dist/lib/api/local-workflow-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-workflow-store.js","sourceRoot":"","sources":["../../../lib/api/local-workflow-store.ts"],"names":[],"mappings":"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"}

package/dist/lib/api/process-api-client.js

@@ -0,0 +1,103 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchProcessHeader = fetchProcessHeader;
+exports.fetchArtifact = fetchArtifact;
+exports.fetchAllDataTypes = fetchAllDataTypes;
+exports.createProcessApiClient = createProcessApiClient;
+const cds_1 = __importDefault(require("@sap/cds"));
+const constants_1 = require("../constants");
+const LOG = cds_1.default.log(constants_1.PROCESS_LOGGER_PREFIX);
+const BASE_PATH = '/public/unified/v1';
+// ============ Implementation Functions ============
+async function fetchJson(url, jwt) {
+    LOG.debug('Invoking url: ' + url);
+    const response = await fetch(url, {
+        method: 'GET',
+        headers: { Authorization: `Bearer ${jwt}` },
+    });
+    if (!response.ok) {
+        const body = await response.text();
+        const errorMessage = `API request failed to fetch JSON: ${body || response.statusText || 'Unknown error'}`;
+        throw cds_1.default.error(response.status, errorMessage);
+    }
+    return response.json();
+}
+async function fetchProcessHeader(serviceUrl, jwt, projectId, processId) {
+    const url = `${serviceUrl}${BASE_PATH}/projects/${encodeURIComponent(projectId)}/artifacts/${encodeURIComponent(processId)}`;
+    return fetchJson(url, jwt);
+}
+async function fetchArtifact(serviceUrl, jwt, projectId, artifactUid) {
+    const url = `${serviceUrl}${BASE_PATH}/projects/${encodeURIComponent(projectId)}/artifacts/${encodeURIComponent(artifactUid)}`;
+    return fetchJson(url, jwt);
+}
+async function fetchAllDataTypes(serviceUrl, jwt, projectId, dependencies) {
+    const result = [];
+    const fetched = new Set();
+    let currentBatch = dependencies.filter((d) => {
+        if (d.type === 'content') {
+            LOG.debug(`Skipping content dependency: ${d.artifactUid}`);
+            return false;
+        }
+        return !fetched.has(d.artifactUid);
+    });
+    while (currentBatch.length > 0) {
+        currentBatch.forEach((d) => fetched.add(d.artifactUid));
+        const fetchPromises = currentBatch.map(async (dep) => {
+            try {
+                const artifact = await fetchArtifact(serviceUrl, jwt, projectId, dep.artifactUid);
+                return { status: 'fulfilled', artifact, dep };
+            }
+            catch (error) {
+                return { status: 'rejected', error, dep };
+            }
+        });
+        // eslint-disable-next-line no-await-in-loop -- Intentional: must await batch to collect nested dependencies for next iteration
+        const responses = await Promise.all(fetchPromises);
+        const nextBatch = [];
+        for (const response of responses) {
+            if (response.status === 'rejected') {
+                LOG.warn(`Could not fetch artifact ${response.dep.artifactUid}: ${response.error}`);
+                continue;
+            }
+            const artifact = response.artifact;
+            if (artifact.type === 'datatype' || artifact.type === 'bpi.datatype') {
+                LOG.debug(`Fetched data type: ${artifact.name}`);
+                result.push(artifact);
+                artifact.dependencies
+                    ?.filter((d) => !fetched.has(d.artifactUid) && d.type !== 'content')
+                    .forEach((d) => nextBatch.push(d));
+            }
+        }
+        // prepare for next iteration
+        currentBatch = [];
+        const seen = new Set();
+        for (const d of nextBatch) {
+            if (!seen.has(d.artifactUid)) {
+                seen.add(d.artifactUid);
+                currentBatch.push(d);
+            }
+        }
+    }
+    return result;
+}
+// ============ Factory Function ============
+function createProcessApiClient(serviceUrl, getToken) {
+    return {
+        fetchProcessHeader: async (projectId, processId) => {
+            const jwt = await getToken();
+            return fetchProcessHeader(serviceUrl, jwt, projectId, processId);
+        },
+        fetchArtifact: async (projectId, artifactUid) => {
+            const jwt = await getToken();
+            return fetchArtifact(serviceUrl, jwt, projectId, artifactUid);
+        },
+        fetchAllDataTypes: async (projectId, dependencies) => {
+            const jwt = await getToken();
+            return fetchAllDataTypes(serviceUrl, jwt, projectId, dependencies);
+        },
+    };
+}
+//# sourceMappingURL=process-api-client.js.map

package/dist/lib/api/process-api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-api-client.js","sourceRoot":"","sources":["../../../lib/api/process-api-client.ts"],"names":[],"mappings":"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"}

package/dist/lib/api/workflow-client.js

@@ -0,0 +1,174 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowStatus = void 0;
+exports.startWorkflow = startWorkflow;
+exports.getWorkflowsByBusinessKey = getWorkflowsByBusinessKey;
+exports.updateWorkflowStatus = updateWorkflowStatus;
+exports.updateMultipleWorkflowStatus = updateMultipleWorkflowStatus;
+exports.getAttributes = getAttributes;
+exports.getOutputs = getOutputs;
+exports.createWorkflowInstanceClient = createWorkflowInstanceClient;
+const cds_1 = __importDefault(require("@sap/cds"));
+const constants_1 = require("../constants");
+const LOG = cds_1.default.log(constants_1.PROCESS_LOGGER_PREFIX);
+const BASE_PATH = '/public/workflow/rest';
+// ============ Types & Enums ============
+var WorkflowStatus;
+(function (WorkflowStatus) {
+    WorkflowStatus["RUNNING"] = "RUNNING";
+    WorkflowStatus["SUSPENDED"] = "SUSPENDED";
+    WorkflowStatus["CANCELED"] = "CANCELED";
+    WorkflowStatus["ERRONEOUS"] = "ERRONEOUS";
+    WorkflowStatus["COMPLETED"] = "COMPLETED";
+})(WorkflowStatus || (exports.WorkflowStatus = WorkflowStatus = {}));
+// ============ Implementation Functions ============
+async function startWorkflow(serviceUrl, jwt, definitionId, context) {
+    const url = `${serviceUrl}${BASE_PATH}/v1/workflow-instances`;
+    LOG.debug('Invoking url: ' + url);
+    const res = await fetch(url, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${jwt}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({ definitionId, context }),
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        const errorMessage = `Failed to start workflow: ${body || res.statusText || 'Unknown error'}`;
+        throw cds_1.default.error(res.status, errorMessage);
+    }
+    const workflowInstance = await res.json();
+    LOG.debug(`Workflow instance started with ID: ${workflowInstance.id}`);
+    return { id: workflowInstance.id, success: true };
+}
+async function getWorkflowsByBusinessKey(serviceUrl, jwt, businessKey, status) {
+    const encodedBusinessKey = encodeURIComponent(businessKey);
+    let queryUrl = `${serviceUrl}${BASE_PATH}/v1/workflow-instances?businessKey=${encodedBusinessKey}`;
+    status.forEach((s) => {
+        queryUrl += `&status=${s}`;
+    });
+    LOG.debug('Invoking url: ' + queryUrl);
+    const res = await fetch(queryUrl, {
+        method: 'GET',
+        headers: {
+            Authorization: `Bearer ${jwt}`,
+            'Content-Type': 'application/json',
+        },
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        const errorMessage = `Failed to retrieve workflow instances: ${body || res.statusText || 'Unknown error'}`;
+        throw cds_1.default.error(res.status, errorMessage);
+    }
+    return await res.json();
+}
+async function updateWorkflowStatus(serviceUrl, jwt, instanceId, status, cascade) {
+    const url = `${serviceUrl}${BASE_PATH}/v1/workflow-instances/${instanceId}`;
+    LOG.debug('Invoking url: ' + url);
+    const res = await fetch(url, {
+        method: 'PATCH',
+        headers: {
+            Authorization: `Bearer ${jwt}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({ status, cascade }),
+    });
+    if (!res.ok) {
+        const errorBody = await res.text();
+        const errorMessage = `Failed to update workflow instance: ${errorBody || res.statusText || 'Unknown error'}`;
+        throw cds_1.default.error(res.status, errorMessage);
+    }
+    return { id: instanceId, success: true };
+}
+async function updateMultipleWorkflowStatus(serviceUrl, jwt, instances, status, cascade) {
+    const results = await Promise.all(instances.map((instance) => updateWorkflowStatus(serviceUrl, jwt, instance.id, status, cascade).catch(() => {
+        return { id: instance.id, success: false };
+    })));
+    const successCount = results.filter((r) => r.success).length;
+    const failedCount = instances.length - successCount;
+    if (failedCount > 0) {
+        LOG.warn(`Updated ${successCount}/${instances.length} workflow instances to status ${status}. ${failedCount} failed.`);
+    }
+    else {
+        LOG.debug(`Successfully updated all ${successCount} workflow instances to status ${status}`);
+    }
+    return results;
+}
+async function getAttributes(serviceUrl, jwt, instanceId) {
+    const url = `${serviceUrl}${BASE_PATH}/v1/workflow-instances/${instanceId}/attributes`;
+    LOG.debug('Invoking url: ' + url);
+    const res = await fetch(url, {
+        method: 'GET',
+        headers: {
+            Authorization: `Bearer ${jwt}`,
+            'Content-Type': 'application/json',
+        },
+    });
+    if (!res.ok) {
+        const errorBody = await res.text();
+        const errorMessage = `Failed to get workflow instance attributes: ${errorBody || res.statusText || 'Unknown error'}`;
+        throw cds_1.default.error(res.status, errorMessage);
+    }
+    const responseText = await res.text();
+    if (!responseText || responseText.trim() === '') {
+        LOG.debug(`No attributes available for workflow instance ${instanceId}`);
+        return [];
+    }
+    return JSON.parse(responseText);
+}
+async function getOutputs(serviceUrl, jwt, instanceId) {
+    const url = `${serviceUrl}${BASE_PATH}/v1/workflow-instances/${instanceId}/outputs`;
+    LOG.debug('Invoking url: ' + url);
+    const res = await fetch(url, {
+        method: 'GET',
+        headers: {
+            Authorization: `Bearer ${jwt}`,
+            'Content-Type': 'application/json',
+        },
+    });
+    if (!res.ok) {
+        const errorBody = await res.text();
+        const errorMessage = `Failed to get workflow instance outputs: ${errorBody || res.statusText || 'Unknown error'}`;
+        throw cds_1.default.error(res.status, errorMessage);
+    }
+    const responseText = await res.text();
+    if (!responseText || responseText.trim() === '') {
+        LOG.debug(`No outputs available for workflow instance ${instanceId}`);
+        return {};
+    }
+    return JSON.parse(responseText);
+}
+// ============ Factory Function ============
+function createWorkflowInstanceClient(serviceUrl, getToken) {
+    return {
+        startWorkflow: async (definitionId, context) => {
+            const jwt = await getToken();
+            return startWorkflow(serviceUrl, jwt, definitionId, context);
+        },
+        getWorkflowsByBusinessKey: async (businessKey, status) => {
+            const jwt = await getToken();
+            return getWorkflowsByBusinessKey(serviceUrl, jwt, businessKey, status);
+        },
+        updateWorkflowStatus: async (instanceId, status, cascade) => {
+            const jwt = await getToken();
+            return updateWorkflowStatus(serviceUrl, jwt, instanceId, status, cascade);
+        },
+        updateMultipleWorkflowStatus: async (instances, status, cascade) => {
+            const jwt = await getToken();
+            return updateMultipleWorkflowStatus(serviceUrl, jwt, instances, status, cascade);
+        },
+        getAttributes: async (instanceId) => {
+            const jwt = await getToken();
+            return getAttributes(serviceUrl, jwt, instanceId);
+        },
+        getOutputs: async (instanceId) => {
+            const jwt = await getToken();
+            return getOutputs(serviceUrl, jwt, instanceId);
+        },
+    };
+}
+//# sourceMappingURL=workflow-client.js.map

package/dist/lib/api/workflow-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-client.js","sourceRoot":"","sources":["../../../lib/api/workflow-client.ts"],"names":[],"mappings":"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"}

package/dist/lib/auth/credentials.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getServiceCredentials = void 0;
+const cds_1 = __importDefault(require("@sap/cds"));
+/**
+ * Gets service credentials from CDS environment configuration.
+ * @param name - The service name to look up
+ * @returns The credentials object or undefined if not found
+ */
+const getServiceCredentials = (name) => {
+    return cds_1.default?.env?.requires?.[name]?.credentials;
+};
+exports.getServiceCredentials = getServiceCredentials;
+//# sourceMappingURL=credentials.js.map

package/dist/lib/auth/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../../lib/auth/credentials.ts"],"names":[],"mappings":";;;;;;AAAA,mDAA2B;AAY3B;;;;GAIG;AACI,MAAM,qBAAqB,GAAG,CAAC,IAAY,EAA6B,EAAE;IAC/E,OAAO,aAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;AACjD,CAAC,CAAC;AAFW,QAAA,qBAAqB,yBAEhC"}

package/dist/lib/auth/index.js

@@ -0,0 +1,11 @@
+"use strict";
+// Auth module - centralized authentication utilities
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createXsuaaTokenProvider = exports.CachingTokenProvider = exports.getServiceCredentials = void 0;
+var credentials_1 = require("./credentials");
+Object.defineProperty(exports, "getServiceCredentials", { enumerable: true, get: function () { return credentials_1.getServiceCredentials; } });
+var token_cache_1 = require("./token-cache");
+Object.defineProperty(exports, "CachingTokenProvider", { enumerable: true, get: function () { return token_cache_1.CachingTokenProvider; } });
+var token_provider_1 = require("./token-provider");
+Object.defineProperty(exports, "createXsuaaTokenProvider", { enumerable: true, get: function () { return token_provider_1.createXsuaaTokenProvider; } });
+//# sourceMappingURL=index.js.map

package/dist/lib/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/auth/index.ts"],"names":[],"mappings":";AAAA,qDAAqD;;;AAErD,6CAAsD;AAA7C,oHAAA,qBAAqB,OAAA;AAC9B,6CAAqD;AAA5C,mHAAA,oBAAoB,OAAA;AAC7B,mDAAyF;AAAnD,0HAAA,wBAAwB,OAAA"}

package/dist/lib/auth/token-cache.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CachingTokenProvider = void 0;
+const cds_1 = __importDefault(require("@sap/cds"));
+const constants_1 = require("../constants");
+const LOG = cds_1.default.log(constants_1.PROCESS_LOGGER_PREFIX);
+class CachingTokenProvider {
+    cache;
+    pendingFetches;
+    tokenProvider;
+    constructor(tokenProvider) {
+        this.cache = new Map();
+        this.pendingFetches = new Map();
+        this.tokenProvider = tokenProvider;
+    }
+    async getToken(tenantId) {
+        const cacheKey = tenantId ?? 'single-tenant';
+        // check cache first
+        const cachedToken = this.getCached(cacheKey);
+        if (cachedToken) {
+            LOG.debug(`Using cached token for tenant: ${cacheKey}`);
+            return cachedToken;
+        }
+        // check if a fetch is already in progress for this tenant
+        const pendingFetch = this.pendingFetches.get(cacheKey);
+        if (pendingFetch) {
+            LOG.debug(`Waiting for pending token fetch for tenant: ${cacheKey}`);
+            return pendingFetch;
+        }
+        // start new fetch and track the promise
+        const fetchPromise = this.fetchAndCache(cacheKey, tenantId);
+        this.pendingFetches.set(cacheKey, fetchPromise);
+        try {
+            return await fetchPromise;
+        }
+        finally {
+            LOG.debug(`Deleting fetch promise from pending fetches for tenant: ${cacheKey}`);
+            this.pendingFetches.delete(cacheKey);
+        }
+    }
+    getCached(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            LOG.debug(`No token found for ${key}.`);
+            return undefined;
+        }
+        if (Date.now() >= entry.expiresAt) {
+            this.cache.delete(key);
+            LOG.debug(`Token expired for tenant: ${key}`);
+            return undefined;
+        }
+        LOG.debug(`Token retrieved for key: ${key}.`);
+        return entry.token;
+    }
+    async fetchAndCache(cacheKey, tenantId) {
+        const { jwt, expires_in } = await this.tokenProvider.fetchToken(tenantId);
+        const expiresAt = Date.now() + expires_in * 1000;
+        this.cache.set(cacheKey, { token: jwt, expiresAt });
+        LOG.debug(`Token fetched and cached for tenant: ${cacheKey}, expires in ${expires_in} seconds.`);
+        return jwt;
+    }
+}
+exports.CachingTokenProvider = CachingTokenProvider;
+//# sourceMappingURL=token-cache.js.map

package/dist/lib/auth/token-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-cache.js","sourceRoot":"","sources":["../../../lib/auth/token-cache.ts"],"names":[],"mappings":";;;;;;AAAA,mDAA2B;AAC3B,4CAAqD;AAGrD,MAAM,GAAG,GAAG,aAAG,CAAC,GAAG,CAAC,iCAAqB,CAAC,CAAC;AAO3C,MAAa,oBAAoB;IACvB,KAAK,CAA0B;IAC/B,cAAc,CAA+B;IAC7C,aAAa,CAAiB;IAEtC,YAAY,aAA6B;QACvC,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,cAAc,GAAG,IAAI,GAAG,EAAE,CAAC;QAChC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAiB;QAC9B,MAAM,QAAQ,GAAG,QAAQ,IAAI,eAAe,CAAC;QAE7C,oBAAoB;QACpB,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,WAAW,EAAE,CAAC;YAChB,GAAG,CAAC,KAAK,CAAC,kCAAkC,QAAQ,EAAE,CAAC,CAAC;YACxD,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,0DAA0D;QAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvD,IAAI,YAAY,EAAE,CAAC;YACjB,GAAG,CAAC,KAAK,CAAC,+CAA+C,QAAQ,EAAE,CAAC,CAAC;YACrE,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,wCAAwC;QACxC,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC5D,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAEhD,IAAI,CAAC;YACH,OAAO,MAAM,YAAY,CAAC;QAC5B,CAAC;gBAAS,CAAC;YACT,GAAG,CAAC,KAAK,CAAC,2DAA2D,QAAQ,EAAE,CAAC,CAAC;YACjF,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAEO,SAAS,CAAC,GAAW;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAC,sBAAsB,GAAG,GAAG,CAAC,CAAC;YACxC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,GAAG,CAAC,KAAK,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;YAC9C,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,GAAG,CAAC,KAAK,CAAC,4BAA4B,GAAG,GAAG,CAAC,CAAC;QAC9C,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,QAAgB,EAAE,QAAiB;QAC7D,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAgB,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACvF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,IAAI,CAAC;QACjD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QACpD,GAAG,CAAC,KAAK,CACP,wCAAwC,QAAQ,gBAAgB,UAAU,WAAW,CACtF,CAAC;QACF,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAlED,oDAkEC"}

package/dist/lib/auth/token-provider.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createXsuaaTokenProvider = createXsuaaTokenProvider;
+const xssec_1 = require("@sap/xssec");
+const cds_1 = __importDefault(require("@sap/cds"));
+const constants_1 = require("../constants");
+const LOG = cds_1.default.log(constants_1.PROCESS_LOGGER_PREFIX);
+// ============ XSUAA Implementation ============
+async function fetchXsuaaToken(uaaCredentials, tenantId) {
+    const xsuaaService = new xssec_1.XsuaaService(uaaCredentials);
+    const { access_token: jwt, expires_in } = await xsuaaService.fetchClientCredentialsToken({
+        ...(tenantId && { zid: tenantId }),
+    });
+    if (!jwt) {
+        throw new Error('Empty JWT returned from XSUAA authorization service.');
+    }
+    LOG.debug('XSUAA token fetched successfully');
+    return { jwt, expires_in };
+}
+// ============ Factory ============
+function createXsuaaTokenProvider(credentials) {
+    if (!credentials?.uaa) {
+        throw new Error('Missing UAA credentials for XSUAA token provider.');
+    }
+    return {
+        fetchToken: (tenantId) => fetchXsuaaToken(credentials.uaa, tenantId),
+    };
+}
+//# sourceMappingURL=token-provider.js.map

package/dist/lib/auth/token-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-provider.js","sourceRoot":"","sources":["../../../lib/auth/token-provider.ts"],"names":[],"mappings":";;;;;AA+CA,4DAQC;AAvDD,sCAA0C;AAC1C,mDAA2B;AAC3B,4CAAqD;AASrD,MAAM,GAAG,GAAG,aAAG,CAAC,GAAG,CAAC,iCAAqB,CAAC,CAAC;AAe3C,iDAAiD;AAEjD,KAAK,UAAU,eAAe,CAC5B,cAA8B,EAC9B,QAAiB;IAEjB,MAAM,YAAY,GAAG,IAAI,oBAAY,CAAC,cAAc,CAAC,CAAC;IACtD,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,MAAM,YAAY,CAAC,2BAA2B,CAAC;QACvF,GAAG,CAAC,QAAQ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;KACnC,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IAED,GAAG,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAC9C,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;AAC7B,CAAC;AAED,oCAAoC;AAEpC,SAAgB,wBAAwB,CAAC,WAAsC;IAC7E,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,OAAO;QACL,UAAU,EAAE,CAAC,QAAiB,EAAE,EAAE,CAAC,eAAe,CAAC,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC;KAC9E,CAAC;AACJ,CAAC"}

package/dist/lib/build/constants.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Build validation message constants.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WARNING_INPUTS_NOT_VALIDATED = exports.WARNING_INPUT_PATH_NOT_IN_ENTITY = exports.ERROR_MISSING_MANDATORY_PROCESS_INPUT = exports.WARNING_MANDATORY_MISMATCH = exports.ERROR_MISSING_PROCESS_INPUT = exports.WARNING_ARRAY_MISMATCH = exports.WARNING_TYPE_MISMATCH = exports.WARNING_ATTRIBUTE_NOT_IN_PROCESS_DEF = exports.ERROR_CASCADE_MUST_BE_BOOLEAN = exports.ERROR_BUSINESS_KEY_REQUIRED = exports.ERROR_ON_REQUIRED = exports.ERROR_ANNOTATION_REQUIRES_OTHER = exports.WARNING_NO_PROCESS_DEFINITION = exports.ERROR_START_ID_MUST_BE_STRING = exports.ERROR_START_ID_REQUIRES_ON = exports.ERROR_START_ON_REQUIRES_ID = exports.ERROR_BUSINESS_KEY_MUST_BE_EXPRESSION = exports.ERROR_IF_MUST_BE_EXPRESSION = exports.ERROR_ANNOTATION_MUST_BE_EVENT_OR_ACTION = exports.ERROR_ANNOTATION_MUST_BE_STRING = exports.WARNING_UNKNOWN_ANNOTATION = void 0;
+// =============================================================================
+// Annotation Validation Messages
+// =============================================================================
+const WARNING_UNKNOWN_ANNOTATION = (entityName, key, allowedAnnotations) => {
+    return `${entityName}: Unknown annotation '${key}'. Allowed annotations are: ${allowedAnnotations.join(', ')}`;
+};
+exports.WARNING_UNKNOWN_ANNOTATION = WARNING_UNKNOWN_ANNOTATION;
+const ERROR_ANNOTATION_MUST_BE_STRING = (entityName, annotationOn) => {
+    return `${entityName}: ${annotationOn} must be a string representing a lifecycle event or action name`;
+};
+exports.ERROR_ANNOTATION_MUST_BE_STRING = ERROR_ANNOTATION_MUST_BE_STRING;
+const ERROR_ANNOTATION_MUST_BE_EVENT_OR_ACTION = (entityName, annotationOn) => {
+    return `${entityName}: ${annotationOn} must be either a lifecycle event (CREATE, UPDATE, DELETE) or an action defined on the entity`;
+};
+exports.ERROR_ANNOTATION_MUST_BE_EVENT_OR_ACTION = ERROR_ANNOTATION_MUST_BE_EVENT_OR_ACTION;
+const ERROR_IF_MUST_BE_EXPRESSION = (entityName, annotationIf) => {
+    return `${entityName}: ${annotationIf} must be a valid expression`;
+};
+exports.ERROR_IF_MUST_BE_EXPRESSION = ERROR_IF_MUST_BE_EXPRESSION;
+const ERROR_BUSINESS_KEY_MUST_BE_EXPRESSION = (entityName, annotationBKey) => {
+    return `${entityName}: ${annotationBKey} must be a valid expression`;
+};
+exports.ERROR_BUSINESS_KEY_MUST_BE_EXPRESSION = ERROR_BUSINESS_KEY_MUST_BE_EXPRESSION;
+// =============================================================================
+// Start Annotation Validation Messages
+// =============================================================================
+const ERROR_START_ON_REQUIRES_ID = (entityName, annotationOn, annotationId) => {
+    return `${entityName}: ${annotationOn} requires ${annotationId}`;
+};
+exports.ERROR_START_ON_REQUIRES_ID = ERROR_START_ON_REQUIRES_ID;
+const ERROR_START_ID_REQUIRES_ON = (entityName, annotationId, annotationOn) => {
+    return `${entityName}: ${annotationId} requires ${annotationOn}`;
+};
+exports.ERROR_START_ID_REQUIRES_ON = ERROR_START_ID_REQUIRES_ON;
+const ERROR_START_ID_MUST_BE_STRING = (entityName, annotationId) => {
+    return `${entityName}: ${annotationId} must be a string`;
+};
+exports.ERROR_START_ID_MUST_BE_STRING = ERROR_START_ID_MUST_BE_STRING;
+const WARNING_NO_PROCESS_DEFINITION = (entityName, annotationId, processId) => {
+    return `${entityName}: No process definition found for ${annotationId} '${processId}'. Process inputs cannot be validated!`;
+};
+exports.WARNING_NO_PROCESS_DEFINITION = WARNING_NO_PROCESS_DEFINITION;
+// =============================================================================
+// Generic Lifecycle Annotation Validation Messages
+// =============================================================================
+const ERROR_ANNOTATION_REQUIRES_OTHER = (entityName, annotation, requiredAnnotation) => {
+    return `${entityName}: ${annotation} requires ${requiredAnnotation}`;
+};
+exports.ERROR_ANNOTATION_REQUIRES_OTHER = ERROR_ANNOTATION_REQUIRES_OTHER;
+const ERROR_ON_REQUIRED = (entityName, annotationPrefix, annotationOn) => {
+    return `${entityName}: ${annotationPrefix} requires ${annotationOn} to be defined`;
+};
+exports.ERROR_ON_REQUIRED = ERROR_ON_REQUIRED;
+const ERROR_BUSINESS_KEY_REQUIRED = (entityName, annotationPrefix) => `Entity "${entityName}" must have a business key defined when using the "${annotationPrefix}" annotation.`;
+exports.ERROR_BUSINESS_KEY_REQUIRED = ERROR_BUSINESS_KEY_REQUIRED;
+const ERROR_CASCADE_MUST_BE_BOOLEAN = (entityName, annotationCascade) => {
+    return `${entityName}: ${annotationCascade} must be a boolean`;
+};
+exports.ERROR_CASCADE_MUST_BE_BOOLEAN = ERROR_CASCADE_MUST_BE_BOOLEAN;
+// =============================================================================
+// Input Validation Messages
+// =============================================================================
+const WARNING_ATTRIBUTE_NOT_IN_PROCESS_DEF = (entityName, attributeKey, processDefId) => {
+    return `${entityName}: Entity attribute '${attributeKey}' is not defined in process definition '${processDefId}'`;
+};
+exports.WARNING_ATTRIBUTE_NOT_IN_PROCESS_DEF = WARNING_ATTRIBUTE_NOT_IN_PROCESS_DEF;
+const WARNING_TYPE_MISMATCH = (entityName, key, entityType, processType) => {
+    return `${entityName}: Type mismatch for '${key}': entity has '${entityType}' but process definition expects '${processType}'`;
+};
+exports.WARNING_TYPE_MISMATCH = WARNING_TYPE_MISMATCH;
+const WARNING_ARRAY_MISMATCH = (entityName, key, entityIsArray, processIsArray) => {
+    const entityText = entityIsArray ? 'an array' : 'not an array';
+    const processText = processIsArray ? 'an array' : 'a single value';
+    return `${entityName}: Array mismatch for '${key}': entity is ${entityText} but process definition expects ${processText}`;
+};
+exports.WARNING_ARRAY_MISMATCH = WARNING_ARRAY_MISMATCH;
+const ERROR_MISSING_PROCESS_INPUT = (entityName, processDefId, inputKey) => {
+    return `${entityName}: Process definition '${processDefId}' expects input '${inputKey}' but it is not provided by the entity`;
+};
+exports.ERROR_MISSING_PROCESS_INPUT = ERROR_MISSING_PROCESS_INPUT;
+const WARNING_MANDATORY_MISMATCH = (entityName, key, processDefId) => {
+    return `${entityName}: Input '${key}' is mandatory in process definition '${processDefId}' but not marked as @mandatory in the entity`;
+};
+exports.WARNING_MANDATORY_MISMATCH = WARNING_MANDATORY_MISMATCH;
+const ERROR_MISSING_MANDATORY_PROCESS_INPUT = (entityName, processDefId, inputKey) => {
+    return `${entityName}: Mandatory input '${inputKey}' from process definition '${processDefId}' is missing in the entity`;
+};
+exports.ERROR_MISSING_MANDATORY_PROCESS_INPUT = ERROR_MISSING_MANDATORY_PROCESS_INPUT;
+const WARNING_INPUT_PATH_NOT_IN_ENTITY = (entityName, inputPath) => {
+    return `${entityName}: Input path '${inputPath}' does not exist on the entity. If this is a virtual field added at runtime, you can ignore this warning.`;
+};
+exports.WARNING_INPUT_PATH_NOT_IN_ENTITY = WARNING_INPUT_PATH_NOT_IN_ENTITY;
+// =============================================================================
+// Misc Build Warnings
+// =============================================================================
+const WARNING_INPUTS_NOT_VALIDATED = (entityName, processDefId) => {
+    return `Inputs for ${entityName} are not validated against process definition ${processDefId}`;
+};
+exports.WARNING_INPUTS_NOT_VALIDATED = WARNING_INPUTS_NOT_VALIDATED;
+//# sourceMappingURL=constants.js.map