@omen.foundation/node-microservice-runtime 0.1.76 → 0.1.78

package/dist/federation.cjs

@@ -0,0 +1,356 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FederationRegistry = void 0;
+exports.FederationComponent = FederationComponent;
+exports.getFederationComponents = getFederationComponents;
+exports.FederatedInventory = FederatedInventory;
+exports.getFederatedInventoryMetadata = getFederatedInventoryMetadata;
+const FEDERATION_COMPONENTS = new Map();
+const FEDERATED_INVENTORY_MAP = new Map();
+function FederationComponent(descriptor) {
+    validateDescriptor(descriptor);
+    return (target) => {
+        var _a;
+        const existing = (_a = FEDERATION_COMPONENTS.get(target)) !== null && _a !== void 0 ? _a : [];
+        existing.push({
+            federationNamespace: descriptor.federationNamespace,
+            federationType: descriptor.federationType,
+            localSettings: descriptor.localSettings,
+        });
+        FEDERATION_COMPONENTS.set(target, existing);
+    };
+}
+function getFederationComponents(target) {
+    var _a;
+    return (_a = FEDERATION_COMPONENTS.get(target)) !== null && _a !== void 0 ? _a : [];
+}
+function FederatedInventory(options) {
+    var _a, _b, _c;
+    const authenticate = (_a = options.authenticate) !== null && _a !== void 0 ? _a : 'Authenticate';
+    const getInventoryState = (_b = options.getInventoryState) !== null && _b !== void 0 ? _b : 'GetInventoryState';
+    const startInventoryTransaction = (_c = options.startInventoryTransaction) !== null && _c !== void 0 ? _c : 'StartInventoryTransaction';
+    return (target) => {
+        var _a;
+        const identityInstance = new options.identity();
+        if (!identityInstance || typeof identityInstance.getUniqueName !== 'function') {
+            throw new Error('@FederatedInventory identity must implement getUniqueName().');
+        }
+        const identityName = identityInstance.getUniqueName();
+        if (!identityName || !identityName.trim()) {
+            throw new Error('@FederatedInventory identity must provide a non-empty unique name.');
+        }
+        const existing = (_a = FEDERATED_INVENTORY_MAP.get(target)) !== null && _a !== void 0 ? _a : [];
+        existing.push({
+            identityCtor: options.identity,
+            identityName: identityName.trim(),
+            methods: {
+                authenticate,
+                getInventoryState,
+                startInventoryTransaction,
+            },
+        });
+        FEDERATED_INVENTORY_MAP.set(target, existing);
+    };
+}
+function getFederatedInventoryMetadata(target) {
+    var _a;
+    return (_a = FEDERATED_INVENTORY_MAP.get(target)) !== null && _a !== void 0 ? _a : [];
+}
+function validateDescriptor(descriptor) {
+    if (!descriptor.federationNamespace || !descriptor.federationNamespace.trim()) {
+        throw new Error('@FederationComponent requires a non-empty federationNamespace.');
+    }
+    if (!descriptor.federationType || !descriptor.federationType.trim()) {
+        throw new Error('@FederationComponent requires a non-empty federationType.');
+    }
+}
+class FederationRegistry {
+    constructor(logger) {
+        this.manualComponents = new Map();
+        this.autoComponents = new Map();
+        this.routeHandlers = new Map();
+        this.logger = logger.child({ component: 'FederationRegistry' });
+    }
+    register(component) {
+        var _a;
+        validateDescriptor(component);
+        const namespace = component.federationNamespace.trim();
+        const type = component.federationType.trim();
+        const existing = (_a = this.manualComponents.get(namespace)) !== null && _a !== void 0 ? _a : new Set();
+        existing.add(type);
+        this.manualComponents.set(namespace, existing);
+        this.logger.debug({ component }, 'Registered federation component.');
+    }
+    registerInventoryHandlers(service, metadata) {
+        for (const entry of metadata) {
+            const identity = entry.identityName;
+            this.addAutoComponent(identity, 'IFederatedInventory');
+            this.addAutoComponent(identity, 'IFederatedLogin');
+            const authenticateHandler = this.createInventoryHandler(service, entry.methods.authenticate, identity, 'authenticate');
+            const stateHandler = this.createInventoryHandler(service, entry.methods.getInventoryState, identity, 'inventory-state');
+            const transactionHandler = this.createInventoryHandler(service, entry.methods.startInventoryTransaction, identity, 'inventory-transaction');
+            this.routeHandlers.set(`${identity.toLowerCase()}/authenticate`, authenticateHandler);
+            this.routeHandlers.set(`${identity.toLowerCase()}/inventory/state`, stateHandler);
+            this.routeHandlers.set(`${identity.toLowerCase()}/inventory/put`, transactionHandler);
+        }
+    }
+    list() {
+        const components = [];
+        for (const [namespace, types] of this.manualComponents.entries()) {
+            for (const type of types) {
+                components.push({ federationNamespace: namespace, federationType: type });
+            }
+        }
+        for (const [namespace, types] of this.autoComponents.entries()) {
+            for (const type of types) {
+                components.push({ federationNamespace: namespace, federationType: type });
+            }
+        }
+        return components;
+    }
+    resolve(path) {
+        return this.routeHandlers.get(path.toLowerCase());
+    }
+    addAutoComponent(namespace, type) {
+        var _a;
+        const existing = (_a = this.autoComponents.get(namespace)) !== null && _a !== void 0 ? _a : new Set();
+        existing.add(type);
+        this.autoComponents.set(namespace, existing);
+    }
+    createInventoryHandler(service, methodName, identity, type) {
+        const method = service[methodName];
+        if (typeof method !== 'function') {
+            throw new Error(`Federated inventory method "${methodName}" is not defined on service "${service.constructor.name}".`);
+        }
+        const paramTypes = getMethodParameterTypes(service, methodName);
+        return {
+            identityName: identity,
+            type,
+            invoke: async (ctx) => {
+                const federatedCtx = {
+                    ...ctx,
+                    federation: { identity },
+                };
+                switch (type) {
+                    case 'authenticate':
+                        return invokeFederatedAuthenticate(method, service, federatedCtx, normalizeAuthenticationRequest(ctx.body), paramTypes);
+                    case 'inventory-state':
+                        return invokeFederatedGetInventoryState(method, service, federatedCtx, normalizeInventoryStateRequest(ctx.body), paramTypes);
+                    case 'inventory-transaction':
+                        return invokeFederatedStartInventoryTransaction(method, service, federatedCtx, normalizeInventoryTransactionRequest(ctx.body), paramTypes);
+                    default:
+                        throw new Error(`Unsupported federated handler type: ${type}`);
+                }
+            },
+        };
+    }
+}
+exports.FederationRegistry = FederationRegistry;
+function normalizeAuthenticationRequest(payload) {
+    if (!payload || typeof payload !== 'object') {
+        return {};
+    }
+    const body = payload;
+    return {
+        token: typeof body.token === 'string' ? body.token : undefined,
+        challenge: typeof body.challenge === 'string' ? body.challenge : undefined,
+        solution: typeof body.solution === 'string' ? body.solution : undefined,
+    };
+}
+function normalizeInventoryStateRequest(payload) {
+    if (!payload || typeof payload !== 'object' || typeof payload.id !== 'string') {
+        throw new Error('Federated inventory state requests must include an "id" property.');
+    }
+    const body = payload;
+    return { id: String(body.id) };
+}
+function normalizeInventoryTransactionRequest(payload) {
+    if (!payload || typeof payload !== 'object') {
+        throw new Error('Federated inventory transaction requests require a JSON body.');
+    }
+    const body = payload;
+    if (typeof body.id !== 'string') {
+        throw new Error('Federated inventory transaction requests must include an "id" property.');
+    }
+    if (typeof body.transaction !== 'string') {
+        throw new Error('Federated inventory transaction requests must include a "transaction" property.');
+    }
+    return {
+        id: body.id,
+        transaction: body.transaction,
+        currencies: normalizeRecordOfNumbers(body.currencies),
+        newItems: normalizeFederatedCreateRequests(body.newItems),
+        deleteItems: normalizeFederatedDeleteRequests(body.deleteItems),
+        updateItems: normalizeFederatedUpdateRequests(body.updateItems),
+    };
+}
+function normalizeRecordOfNumbers(value) {
+    if (!value || typeof value !== 'object') {
+        return undefined;
+    }
+    const record = {};
+    for (const [key, raw] of Object.entries(value)) {
+        const numeric = Number(raw);
+        if (Number.isFinite(numeric)) {
+            record[key] = numeric;
+        }
+    }
+    return Object.keys(record).length > 0 ? record : undefined;
+}
+function normalizeFederatedCreateRequests(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const normalized = [];
+    for (const item of value) {
+        if (!item || typeof item !== 'object') {
+            continue;
+        }
+        const record = item;
+        if (typeof record.contentId !== 'string') {
+            continue;
+        }
+        const properties = record.properties && typeof record.properties === 'object'
+            ? Object.fromEntries(Object.entries(record.properties).map(([propKey, propVal]) => [
+                propKey,
+                String(propVal),
+            ]))
+            : undefined;
+        normalized.push({
+            contentId: record.contentId,
+            requestId: typeof record.requestId === 'string' ? record.requestId : undefined,
+            properties,
+        });
+    }
+    return normalized.length > 0 ? normalized : undefined;
+}
+function normalizeFederatedDeleteRequests(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const normalized = [];
+    for (const item of value) {
+        if (!item || typeof item !== 'object') {
+            continue;
+        }
+        const record = item;
+        if (typeof record.contentId !== 'string' || typeof record.proxyId !== 'string') {
+            continue;
+        }
+        normalized.push({
+            contentId: record.contentId,
+            proxyId: record.proxyId,
+        });
+    }
+    return normalized.length > 0 ? normalized : undefined;
+}
+function normalizeFederatedUpdateRequests(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const normalized = [];
+    for (const item of value) {
+        if (!item || typeof item !== 'object') {
+            continue;
+        }
+        const record = item;
+        if (typeof record.contentId !== 'string' || typeof record.proxyId !== 'string') {
+            continue;
+        }
+        const properties = record.properties && typeof record.properties === 'object'
+            ? Object.fromEntries(Object.entries(record.properties).map(([propKey, propVal]) => [
+                propKey,
+                String(propVal),
+            ]))
+            : undefined;
+        normalized.push({
+            contentId: record.contentId,
+            proxyId: record.proxyId,
+            properties,
+        });
+    }
+    return normalized.length > 0 ? normalized : undefined;
+}
+function getMethodParameterTypes(service, methodName) {
+    var _a;
+    const prototype = Object.getPrototypeOf(service);
+    if (!prototype || typeof Reflect.getMetadata !== 'function') {
+        return [];
+    }
+    return (_a = Reflect.getMetadata('design:paramtypes', prototype, methodName)) !== null && _a !== void 0 ? _a : [];
+}
+function isStringType(type) {
+    return type === String;
+}
+function invokeFederatedAuthenticate(method, service, ctx, request, paramTypes) {
+    const argsWithoutContext = [request.token, request.challenge, request.solution];
+    if (method.length === argsWithoutContext.length) {
+        return method.call(service, ...argsWithoutContext);
+    }
+    if (method.length === argsWithoutContext.length + 1) {
+        return method.call(service, ctx, ...argsWithoutContext);
+    }
+    if (method.length === 1) {
+        const firstType = paramTypes[0];
+        if (isStringType(firstType)) {
+            return method.call(service, ...argsWithoutContext);
+        }
+        return method.call(service, request);
+    }
+    if (method.length === 2) {
+        const secondType = paramTypes[1];
+        if (isStringType(secondType)) {
+            return method.call(service, ctx, ...argsWithoutContext);
+        }
+        return method.call(service, ctx, request);
+    }
+    return method.call(service, ctx, request);
+}
+function invokeFederatedGetInventoryState(method, service, ctx, request, paramTypes) {
+    const argsWithoutContext = [request.id];
+    if (method.length === argsWithoutContext.length) {
+        const firstType = paramTypes[0];
+        if (isStringType(firstType)) {
+            return method.call(service, ...argsWithoutContext);
+        }
+        return method.call(service, request);
+    }
+    if (method.length === argsWithoutContext.length + 1) {
+        const secondType = paramTypes[1];
+        if (isStringType(secondType)) {
+            return method.call(service, ctx, ...argsWithoutContext);
+        }
+        return method.call(service, ctx, request);
+    }
+    if (method.length === 1) {
+        return method.call(service, request);
+    }
+    if (method.length === 2) {
+        return method.call(service, ctx, request);
+    }
+    return method.call(service, ctx, request);
+}
+function invokeFederatedStartInventoryTransaction(method, service, ctx, request, _paramTypes) {
+    var _a, _b, _c, _d;
+    const argsWithoutContext = [
+        request.id,
+        request.transaction,
+        (_a = request.currencies) !== null && _a !== void 0 ? _a : {},
+        (_b = request.newItems) !== null && _b !== void 0 ? _b : [],
+        (_c = request.deleteItems) !== null && _c !== void 0 ? _c : [],
+        (_d = request.updateItems) !== null && _d !== void 0 ? _d : [],
+    ];
+    if (method.length === argsWithoutContext.length) {
+        return method.call(service, ...argsWithoutContext);
+    }
+    if (method.length === argsWithoutContext.length + 1) {
+        return method.call(service, ctx, ...argsWithoutContext);
+    }
+    if (method.length === 1) {
+        return method.call(service, request);
+    }
+    if (method.length === 2) {
+        return method.call(service, ctx, request);
+    }
+    return method.call(service, ctx, request);
+}

package/dist/index.cjs

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = exports.startCollectorAndWaitForReady = exports.startCollectorAsync = exports.setupCollectorBeforeLogging = exports.getCollectorProcessStatus = exports.addAuthEnvironmentVars = exports.fetchClickHouseCredentials = exports.getClickHouseCredentialsStatus = exports.isCollectorRunning = exports.FederatedInventory = exports.getFederationComponents = exports.FederationRegistry = exports.FederationComponent = exports.listRegisteredStorageObjects = exports.getStorageMetadata = exports.StorageObject = exports.StorageService = exports.createInventoryService = exports.InventoryUpdateBuilder = exports.runMicroservice = exports.MicroserviceRuntime = exports.BeamableRuntimeError = exports.loadEnvironmentConfig = exports.BEAMABLE_SERVICES_TOKEN = exports.REQUEST_CONTEXT_TOKEN = exports.ENVIRONMENT_CONFIG_TOKEN = exports.LOGGER_TOKEN = exports.ServiceLifetime = exports.DependencyBuilder = exports.BeamableServiceManager = exports.InitializeServices = exports.ConfigureServices = exports.SwaggerTags = exports.SwaggerCategory = exports.AdminCallable = exports.ServerCallable = exports.ClientCallable = exports.Callable = exports.Microservice = void 0;
+var decorators_js_1 = require("./decorators.js");
+Object.defineProperty(exports, "Microservice", { enumerable: true, get: function () { return decorators_js_1.Microservice; } });
+Object.defineProperty(exports, "Callable", { enumerable: true, get: function () { return decorators_js_1.Callable; } });
+Object.defineProperty(exports, "ClientCallable", { enumerable: true, get: function () { return decorators_js_1.ClientCallable; } });
+Object.defineProperty(exports, "ServerCallable", { enumerable: true, get: function () { return decorators_js_1.ServerCallable; } });
+Object.defineProperty(exports, "AdminCallable", { enumerable: true, get: function () { return decorators_js_1.AdminCallable; } });
+Object.defineProperty(exports, "SwaggerCategory", { enumerable: true, get: function () { return decorators_js_1.SwaggerCategory; } });
+Object.defineProperty(exports, "SwaggerTags", { enumerable: true, get: function () { return decorators_js_1.SwaggerTags; } });
+Object.defineProperty(exports, "ConfigureServices", { enumerable: true, get: function () { return decorators_js_1.ConfigureServices; } });
+Object.defineProperty(exports, "InitializeServices", { enumerable: true, get: function () { return decorators_js_1.InitializeServices; } });
+var services_js_1 = require("./services.js");
+Object.defineProperty(exports, "BeamableServiceManager", { enumerable: true, get: function () { return services_js_1.BeamableServiceManager; } });
+var dependency_js_1 = require("./dependency.js");
+Object.defineProperty(exports, "DependencyBuilder", { enumerable: true, get: function () { return dependency_js_1.DependencyBuilder; } });
+Object.defineProperty(exports, "ServiceLifetime", { enumerable: true, get: function () { return dependency_js_1.ServiceLifetime; } });
+Object.defineProperty(exports, "LOGGER_TOKEN", { enumerable: true, get: function () { return dependency_js_1.LOGGER_TOKEN; } });
+Object.defineProperty(exports, "ENVIRONMENT_CONFIG_TOKEN", { enumerable: true, get: function () { return dependency_js_1.ENVIRONMENT_CONFIG_TOKEN; } });
+Object.defineProperty(exports, "REQUEST_CONTEXT_TOKEN", { enumerable: true, get: function () { return dependency_js_1.REQUEST_CONTEXT_TOKEN; } });
+Object.defineProperty(exports, "BEAMABLE_SERVICES_TOKEN", { enumerable: true, get: function () { return dependency_js_1.BEAMABLE_SERVICES_TOKEN; } });
+var env_js_1 = require("./env.js");
+Object.defineProperty(exports, "loadEnvironmentConfig", { enumerable: true, get: function () { return env_js_1.loadEnvironmentConfig; } });
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "BeamableRuntimeError", { enumerable: true, get: function () { return errors_js_1.BeamableRuntimeError; } });
+var runtime_js_1 = require("./runtime.js");
+Object.defineProperty(exports, "MicroserviceRuntime", { enumerable: true, get: function () { return runtime_js_1.MicroserviceRuntime; } });
+Object.defineProperty(exports, "runMicroservice", { enumerable: true, get: function () { return runtime_js_1.runMicroservice; } });
+var inventory_js_1 = require("./inventory.js");
+Object.defineProperty(exports, "InventoryUpdateBuilder", { enumerable: true, get: function () { return inventory_js_1.InventoryUpdateBuilder; } });
+Object.defineProperty(exports, "createInventoryService", { enumerable: true, get: function () { return inventory_js_1.createInventoryService; } });
+var storage_js_1 = require("./storage.js");
+Object.defineProperty(exports, "StorageService", { enumerable: true, get: function () { return storage_js_1.StorageService; } });
+Object.defineProperty(exports, "StorageObject", { enumerable: true, get: function () { return storage_js_1.StorageObject; } });
+Object.defineProperty(exports, "getStorageMetadata", { enumerable: true, get: function () { return storage_js_1.getStorageMetadata; } });
+Object.defineProperty(exports, "listRegisteredStorageObjects", { enumerable: true, get: function () { return storage_js_1.listRegisteredStorageObjects; } });
+var federation_js_1 = require("./federation.js");
+Object.defineProperty(exports, "FederationComponent", { enumerable: true, get: function () { return federation_js_1.FederationComponent; } });
+Object.defineProperty(exports, "FederationRegistry", { enumerable: true, get: function () { return federation_js_1.FederationRegistry; } });
+Object.defineProperty(exports, "getFederationComponents", { enumerable: true, get: function () { return federation_js_1.getFederationComponents; } });
+Object.defineProperty(exports, "FederatedInventory", { enumerable: true, get: function () { return federation_js_1.FederatedInventory; } });
+var collector_manager_js_1 = require("./collector-manager.js");
+Object.defineProperty(exports, "isCollectorRunning", { enumerable: true, get: function () { return collector_manager_js_1.isCollectorRunning; } });
+Object.defineProperty(exports, "getClickHouseCredentialsStatus", { enumerable: true, get: function () { return collector_manager_js_1.getClickHouseCredentialsStatus; } });
+Object.defineProperty(exports, "fetchClickHouseCredentials", { enumerable: true, get: function () { return collector_manager_js_1.fetchClickHouseCredentials; } });
+Object.defineProperty(exports, "addAuthEnvironmentVars", { enumerable: true, get: function () { return collector_manager_js_1.addAuthEnvironmentVars; } });
+Object.defineProperty(exports, "getCollectorProcessStatus", { enumerable: true, get: function () { return collector_manager_js_1.getCollectorProcessStatus; } });
+Object.defineProperty(exports, "setupCollectorBeforeLogging", { enumerable: true, get: function () { return collector_manager_js_1.setupCollectorBeforeLogging; } });
+Object.defineProperty(exports, "startCollectorAsync", { enumerable: true, get: function () { return collector_manager_js_1.startCollectorAsync; } });
+Object.defineProperty(exports, "startCollectorAndWaitForReady", { enumerable: true, get: function () { return collector_manager_js_1.startCollectorAndWaitForReady; } });
+const fs_1 = require("fs");
+const module_1 = require("module");
+function getPackageVersion() {
+    try {
+        const require = (0, module_1.createRequire)(import.meta.url);
+        const packageJsonPath = require.resolve('../package.json');
+        const packageJson = JSON.parse((0, fs_1.readFileSync)(packageJsonPath, 'utf-8'));
+        return packageJson.version || '0.0.0';
+    }
+    catch (error) {
+        console.warn('[Runtime] Failed to read version from package.json, using fallback:', error instanceof Error ? error.message : String(error));
+        return '0.0.0';
+    }
+}
+exports.VERSION = getPackageVersion();