@naylence/runtime 0.3.3 → 0.3.5-test.0

package/dist/cjs/src/naylence/fame/node/admission/welcome-service-client.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WelcomeServiceClient = void 0;
+const core_1 = require("@naylence/core");
+const logging_js_1 = require("../../util/logging.js");
+const util_js_1 = require("../../util/util.js");
+const logger = (0, logging_js_1.getLogger)('naylence.fame.node.admission.welcome_service_client');
+class WelcomeServiceClient {
+    constructor(options) {
+        this.hasUpstream = options.hasUpstream ?? options.has_upstream ?? false;
+        this.url = options.url;
+        const transportsSource = options.supportedTransports ?? options.supported_transports ?? [];
+        if (!Array.isArray(transportsSource)) {
+            throw new Error('supportedTransports must be provided as an array');
+        }
+        this.supportedTransports = transportsSource.map((value, index) => {
+            if (typeof value !== 'string' || value.trim().length === 0) {
+                throw new Error(`supportedTransports[${index}] must be a non-empty string`);
+            }
+            return value;
+        });
+        this.authStrategyFactory =
+            options.authStrategyFactory ?? options.auth_strategy_factory;
+        this.fetchImpl = options.fetchImpl ?? options.fetch_impl;
+    }
+    async hello(systemId, instanceId, requestedLogicals) {
+        const fetchFn = this.resolveFetch();
+        const helloFrame = {
+            type: 'NodeHello',
+            systemId,
+            instanceId,
+            logicals: requestedLogicals ?? [],
+            supportedTransports: Array.from(this.supportedTransports),
+        };
+        const envelope = (0, core_1.createFameEnvelope)({ frame: helloFrame });
+        const serialized = (0, core_1.serializeEnvelope)(envelope, { safeLog: false });
+        // Convert envelope keys to snake_case, but keep frame content in camelCase
+        const { frame, ...envelopeFields } = serialized;
+        const payload = JSON.stringify({
+            ...convertKeysToSnakeCase(envelopeFields),
+            frame, // Keep frame in camelCase as per Fame protocol
+        });
+        const authHeaders = {};
+        let authStrategy;
+        try {
+            if (this.authStrategyFactory) {
+                authStrategy = await this.authStrategyFactory();
+                if (authStrategy) {
+                    await authStrategy.apply(authHeaders);
+                }
+            }
+            const headers = {
+                'Content-Type': 'application/json',
+                ...authHeaders,
+            };
+            logger.debug('welcome_service_hello_request', {
+                url: this.url,
+                systemId,
+                instanceId,
+                requestedLogicals,
+                headers: Object.keys(headers),
+            });
+            const response = await fetchFn(this.url, {
+                method: 'POST',
+                headers,
+                body: payload,
+            });
+            const responseText = await response.text();
+            if (!response.ok) {
+                throw new Error(`WelcomeServiceClient request failed (${response.status} ${response.statusText}): ${responseText}`);
+            }
+            let data;
+            try {
+                data = responseText ? JSON.parse(responseText) : {};
+            }
+            catch (error) {
+                throw new Error(`Failed to parse welcome service response: ${error.message}`);
+            }
+            if (!isRecord(data)) {
+                throw new Error('Welcome service response is not a JSON object');
+            }
+            const camelData = convertKeysToCamelCase(data);
+            // Convert ISO timestamp string to Date object if present
+            if (typeof camelData.ts === 'string') {
+                camelData.ts = new Date(camelData.ts);
+            }
+            const parsedEnvelope = core_1.FameEnvelopeSchema.parse(camelData);
+            if (!parsedEnvelope.frame ||
+                parsedEnvelope.frame.type !== 'NodeWelcome') {
+                throw new Error(`Unexpected frame type '${parsedEnvelope.frame?.type ?? 'unknown'}'`);
+            }
+            logger.debug('welcome_service_hello_success', {
+                systemId: parsedEnvelope.frame.systemId,
+                targetSystemId: parsedEnvelope.frame.targetSystemId,
+                assignedPath: parsedEnvelope.frame.assignedPath,
+                acceptedLogicals: parsedEnvelope.frame.acceptedLogicals,
+            });
+            return parsedEnvelope;
+        }
+        finally {
+            if (authStrategy) {
+                await authStrategy.cleanup();
+            }
+        }
+    }
+    async close() {
+        // WelcomeServiceClient performs per-request auth setup; nothing to close.
+    }
+    resolveFetch() {
+        if (this.fetchImpl) {
+            return this.fetchImpl;
+        }
+        if (typeof fetch === 'function') {
+            return fetch.bind(globalThis);
+        }
+        throw new Error('Global fetch implementation is not available. Provide fetchImpl in options.');
+    }
+}
+exports.WelcomeServiceClient = WelcomeServiceClient;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function convertKeysToSnakeCase(value) {
+    if (Array.isArray(value)) {
+        return value.map(convertKeysToSnakeCase);
+    }
+    if (!isRecord(value)) {
+        return value;
+    }
+    const result = {};
+    for (const [key, val] of Object.entries(value)) {
+        const snakeKey = (0, util_js_1.camelToSnakeCase)(key);
+        result[snakeKey] = convertKeysToSnakeCase(val);
+    }
+    return result;
+}
+function convertKeysToCamelCase(value) {
+    if (Array.isArray(value)) {
+        return value.map(convertKeysToCamelCase);
+    }
+    if (!isRecord(value)) {
+        return value;
+    }
+    const result = {};
+    for (const [key, val] of Object.entries(value)) {
+        const camelKey = (0, util_js_1.snakeToCamelCase)(key);
+        result[camelKey] = convertKeysToCamelCase(val);
+    }
+    return result;
+}
+//# sourceMappingURL=welcome-service-client.js.map

package/dist/cjs/src/naylence/fame/node/admission/welcome-service-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome-service-client.js","sourceRoot":"","sources":["../../../../../../../src/naylence/fame/node/admission/welcome-service-client.ts"],"names":[],"mappings":"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"}

package/dist/cjs/src/naylence/fame/node/binding-manager.js

@@ -0,0 +1,513 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BindingManager = exports.BindingStoreEntryRecord = void 0;
+const core_1 = require("@naylence/core");
+const in_memory_channel_js_1 = require("../channel/in-memory/in-memory-channel.js");
+const in_memory_storage_js_1 = require("../storage/in-memory-storage.js");
+const envelope_context_js_1 = require("../util/envelope-context.js");
+const logging_js_1 = require("../util/logging.js");
+const logicals_js_1 = require("../util/logicals.js");
+const logger = (0, logging_js_1.getLogger)('naylence.fame.node.binding_manager');
+const SYSTEM_INBOX = '__sys__';
+const DEFAULT_ACK_TIMEOUT_MS = 20000;
+class BindingStoreEntryRecord {
+    constructor(address, encryptionKeyId = null, physicalPath = null) {
+        this.address = address;
+        this.encryptionKeyId = encryptionKeyId;
+        this.physicalPath = physicalPath;
+    }
+}
+exports.BindingStoreEntryRecord = BindingStoreEntryRecord;
+function toKey(address) {
+    return address.toString();
+}
+class BindingManager {
+    constructor(options) {
+        this.bindings = new Map();
+        this.capabilitiesByAddress = new Map();
+        const hasUpstream = options.hasUpstream ?? options.has_upstream ?? false;
+        const getId = options.getId ?? options.get_id;
+        if (!getId) {
+            throw new Error('BindingManager requires getId callback');
+        }
+        const getPhysicalPath = options.getPhysicalPath ?? options.get_physical_path;
+        if (!getPhysicalPath) {
+            throw new Error('BindingManager requires getPhysicalPath callback');
+        }
+        const getAcceptedLogicals = options.getAcceptedLogicals ?? options.get_accepted_logicals;
+        if (!getAcceptedLogicals) {
+            throw new Error('BindingManager requires getAcceptedLogicals callback');
+        }
+        const forwardUpstream = options.forwardUpstream ?? options.forward_upstream;
+        if (!forwardUpstream) {
+            throw new Error('BindingManager requires forwardUpstream function');
+        }
+        const envelopeFactory = options.envelopeFactory ?? options.envelope_factory;
+        if (!envelopeFactory) {
+            throw new Error('BindingManager requires envelopeFactory');
+        }
+        const deliveryTracker = options.deliveryTracker ?? options.delivery_tracker;
+        if (!deliveryTracker) {
+            throw new Error('BindingManager requires deliveryTracker');
+        }
+        const getEncryptionKeyId = options.getEncryptionKeyId ?? options.get_encryption_key_id;
+        const bindingStore = options.bindingStore ??
+            options.binding_store ??
+            new in_memory_storage_js_1.InMemoryKeyValueStore();
+        const bindingFactory = options.bindingFactory ??
+            options.binding_factory ??
+            ((address) => this.defaultBindingFactory(address));
+        const ackTimeoutMs = options.ackTimeoutMs ?? options.ack_timeout_ms ?? DEFAULT_ACK_TIMEOUT_MS;
+        this.hasUpstream = hasUpstream;
+        this.getId = getId;
+        this.getPhysicalPath = getPhysicalPath;
+        this.getAcceptedLogicalsFn = getAcceptedLogicals;
+        this.forwardUpstream = forwardUpstream;
+        this.getEncryptionKeyId = getEncryptionKeyId;
+        this.bindingStore = bindingStore;
+        this.bindingFactory = bindingFactory;
+        this.envelopeFactory = envelopeFactory;
+        this.deliveryTracker = deliveryTracker;
+        this.ackTimeoutMs = ackTimeoutMs;
+    }
+    getBinding(address) {
+        const key = toKey(address);
+        const direct = this.bindings.get(key);
+        if (direct) {
+            return direct;
+        }
+        return this.matchPool(address.toString());
+    }
+    getAddresses() {
+        return Array.from(this.bindings.values()).map((binding) => binding.address);
+    }
+    hasBinding(address) {
+        return this.getBinding(address) !== undefined;
+    }
+    async restore() {
+        const stored = await this.bindingStore.list();
+        for (const entry of Object.values(stored)) {
+            if (!entry?.address) {
+                continue;
+            }
+            const key = entry.address;
+            if (!this.bindings.has(key)) {
+                const binding = this.bindingFactory(new core_1.FameAddress(key));
+                this.bindings.set(key, binding);
+                logger.debug('restored_binding', { address: key });
+            }
+        }
+        if (!this.hasUpstream) {
+            return;
+        }
+        await this.rebindAddressesUpstream();
+        await this.readvertiseCapabilitiesUpstream();
+    }
+    async bind(participant, capabilities) {
+        logger.debug('binding_participant', { participant });
+        const { prefixAddress, addresses, propagateAddress, capabilityAddress } = this.computeBindingAddresses(participant);
+        for (const address of addresses) {
+            if (!this.bindings.has(address)) {
+                const binding = this.bindingFactory(new core_1.FameAddress(address));
+                this.bindings.set(address, binding);
+                logger.debug('bound_address', { address, participant });
+            }
+        }
+        let propagatedAddress = null;
+        if (propagateAddress && this.hasUpstream) {
+            propagatedAddress = propagateAddress;
+            try {
+                await this.bindAddressUpstream(propagatedAddress);
+            }
+            catch (error) {
+                for (const address of addresses) {
+                    this.bindings.delete(address);
+                }
+                throw error;
+            }
+        }
+        if (capabilities &&
+            capabilities.length &&
+            this.hasUpstream &&
+            capabilityAddress) {
+            try {
+                await this.advertiseCapabilities(capabilityAddress, capabilities);
+            }
+            catch (error) {
+                if (propagatedAddress) {
+                    try {
+                        await this.unbindAddressUpstream(propagatedAddress);
+                    }
+                    catch (rollbackError) {
+                        logger.error('bind_rollback_failed', {
+                            address: propagatedAddress.toString(),
+                            error: rollbackError.message,
+                        });
+                    }
+                }
+                for (const address of addresses) {
+                    this.bindings.delete(address);
+                }
+                throw error;
+            }
+        }
+        for (const address of addresses) {
+            await this.bindingStore.set(address, {
+                address,
+                encryptionKeyId: null,
+                physicalPath: null,
+            });
+        }
+        logger.debug('bind_success', {
+            participant,
+            address: prefixAddress.toString(),
+            capabilities,
+            totalBindings: this.bindings.size,
+        });
+        const binding = this.bindings.get(prefixAddress.toString());
+        if (!binding) {
+            throw new Error('Binding was not created');
+        }
+        if (capabilities && capabilities.length && capabilityAddress) {
+            const key = capabilityAddress.toString();
+            const current = this.capabilitiesByAddress.get(key) ?? new Set();
+            capabilities.forEach((cap) => current.add(cap));
+            this.capabilitiesByAddress.set(key, current);
+        }
+        return binding;
+    }
+    async unbind(participant) {
+        const { prefixAddress, instanceAddress, addresses, propagateAddress, capabilityAddress, } = this.computeBindingAddresses(participant, { requireExisting: true });
+        if (this.hasUpstream && capabilityAddress) {
+            const key = capabilityAddress.toString();
+            const caps = Array.from(this.capabilitiesByAddress.get(key) ?? []);
+            if (caps.length) {
+                await this.withdrawCapabilities(capabilityAddress, caps);
+                this.capabilitiesByAddress.delete(key);
+            }
+        }
+        if (this.hasUpstream && propagateAddress) {
+            await this.unbindAddressUpstream(propagateAddress);
+        }
+        for (const address of addresses) {
+            if (this.bindings.delete(address)) {
+                await this.bindingStore.delete(address);
+            }
+        }
+        logger.debug('unbind_success', {
+            participant,
+            address: prefixAddress.toString(),
+            totalBindings: this.bindings.size,
+        });
+        if (instanceAddress) {
+            this.capabilitiesByAddress.delete(instanceAddress.toString());
+        }
+    }
+    async clear() {
+        this.bindings.clear();
+        this.capabilitiesByAddress.clear();
+        const entries = await this.bindingStore.list();
+        await Promise.all(Object.keys(entries).map((key) => this.bindingStore.delete(key)));
+    }
+    async handleAck(envelope, context) {
+        await this.deliveryTracker.onEnvelopeDelivered(SYSTEM_INBOX, envelope, context);
+    }
+    async rebindAddressesUpstream() {
+        if (!this.hasUpstream) {
+            return;
+        }
+        for (const address of this.bindings.keys()) {
+            if (!this.shouldRebind(address)) {
+                continue;
+            }
+            try {
+                await this.bindAddressUpstream(new core_1.FameAddress(address));
+            }
+            catch (error) {
+                logger.error('rebind_failed', {
+                    address,
+                    error: error.message,
+                });
+            }
+        }
+    }
+    async readvertiseCapabilitiesUpstream() {
+        if (!this.hasUpstream) {
+            return;
+        }
+        for (const [address, capabilities,] of this.capabilitiesByAddress.entries()) {
+            if (!capabilities.size) {
+                continue;
+            }
+            try {
+                await this.advertiseCapabilities(new core_1.FameAddress(address), Array.from(capabilities));
+            }
+            catch (error) {
+                logger.error('capability_replay_failed', {
+                    address,
+                    error: error.message,
+                });
+            }
+        }
+    }
+    matchPool(address) {
+        const [name] = (0, core_1.parseAddress)(address);
+        try {
+            const [, host] = (0, core_1.parseAddressComponents)(address);
+            if (!host) {
+                return undefined;
+            }
+            return this.matchHostPool(name, host);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    matchHostPool(name, host) {
+        const candidates = [];
+        for (const [storedAddress, binding] of this.bindings.entries()) {
+            try {
+                const [storedName, storedHost] = (0, core_1.parseAddressComponents)(storedAddress);
+                if (storedName !== name || !storedHost || !(0, logicals_js_1.isPoolLogical)(storedHost)) {
+                    continue;
+                }
+                if (!(0, logicals_js_1.matchesPoolLogical)(host, storedHost)) {
+                    continue;
+                }
+                const specificity = storedHost.split('.').length;
+                candidates.push({ specificity, binding });
+            }
+            catch {
+                continue;
+            }
+        }
+        if (!candidates.length) {
+            return undefined;
+        }
+        candidates.sort((a, b) => b.specificity - a.specificity);
+        return candidates[0]?.binding;
+    }
+    computeBindingAddresses(participant, options = {}) {
+        let name;
+        let location;
+        if (participant.includes('@')) {
+            [name, location] = (0, core_1.parseAddress)(participant);
+        }
+        else {
+            name = participant;
+            location = this.getPhysicalPath();
+        }
+        const baseAddress = (0, core_1.formatAddress)(name, location);
+        let host = null;
+        let isHostBased = false;
+        try {
+            const [, parsedHost] = (0, core_1.parseAddressComponents)(baseAddress.toString());
+            if (parsedHost) {
+                host = parsedHost;
+                isHostBased = true;
+            }
+        }
+        catch {
+            // ignore parse errors and treat as path-based
+        }
+        const acceptedLogicals = this.getAcceptedLogicalsSnapshot();
+        let poolClaim = null;
+        let logical = null;
+        if (isHostBased && host) {
+            // For host-based addresses (e.g., "svc@api.service"), check the host portion
+            logical = host;
+            if (!this.isAcceptedLogicalHost(logical, acceptedLogicals)) {
+                poolClaim = this.findHostPoolClaim(acceptedLogicals, host);
+                logical = null; // Not a logical, might be a pool
+            }
+        }
+        else {
+            // For path-based addresses (e.g., "svc@/path"), check the name portion
+            // This allows binding like bind("svc") to work when "svc" is in requestedLogicals
+            if (this.isAcceptedLogicalHost(name, acceptedLogicals)) {
+                logical = name;
+            }
+        }
+        let prefixAddress;
+        let instanceAddress = null;
+        if (poolClaim) {
+            prefixAddress = (0, core_1.formatAddressFromComponents)(name, poolClaim);
+            const targetHost = host && host.includes('*')
+                ? host.replace('*', this.getId())
+                : poolClaim.replace('*', this.getId());
+            instanceAddress = (0, core_1.formatAddressFromComponents)(name, targetHost);
+        }
+        else if (logical &&
+            this.isAcceptedLogicalHost(logical, acceptedLogicals)) {
+            prefixAddress = baseAddress;
+        }
+        else if (location === this.getPhysicalPath()) {
+            prefixAddress = baseAddress;
+        }
+        else {
+            if (options.requireExisting !== true) {
+                throw new Error(`Cannot bind '${participant}': location '${location}' not permitted`);
+            }
+            prefixAddress = baseAddress;
+        }
+        const addresses = new Set();
+        addresses.add(prefixAddress.toString());
+        if (instanceAddress) {
+            addresses.add(instanceAddress.toString());
+        }
+        const propagateAddress = this.hasUpstream
+            ? this.computePropagateAddress(prefixAddress, poolClaim, logical)
+            : null;
+        const capabilityAddress = instanceAddress ?? prefixAddress;
+        return {
+            prefixAddress,
+            instanceAddress,
+            addresses,
+            propagateAddress,
+            capabilityAddress,
+        };
+    }
+    computePropagateAddress(prefixAddress, poolClaim, logical) {
+        if (!this.hasUpstream) {
+            return null;
+        }
+        // Only propagate pool claims or accepted logical addresses upstream
+        // Physical addresses are NEVER propagated (matches Python implementation)
+        if (poolClaim) {
+            const [name] = (0, core_1.parseAddress)(prefixAddress.toString());
+            return (0, core_1.formatAddressFromComponents)(name, poolClaim);
+        }
+        // Check if this is an accepted logical address (non-pool)
+        if (logical &&
+            this.isAcceptedLogicalHost(logical, this.getAcceptedLogicalsSnapshot())) {
+            return prefixAddress;
+        }
+        // Physical addresses or non-accepted logicals are not propagated
+        return null;
+    }
+    async bindAddressUpstream(address) {
+        const frame = {
+            type: 'AddressBind',
+            address: address.toString(),
+            physicalPath: this.getPhysicalPath(),
+            encryptionKeyId: this.getEncryptionKeyId
+                ? (this.getEncryptionKeyId() ?? undefined)
+                : undefined,
+        };
+        const ackEnvelope = await this.sendAndWaitForAck(frame);
+        const ack = ackEnvelope.frame;
+        if (!ack.ok) {
+            throw new Error(`Bind to '${address}' was rejected`);
+        }
+    }
+    async unbindAddressUpstream(address) {
+        const frame = {
+            type: 'AddressUnbind',
+            address: address.toString(),
+        };
+        const ackEnvelope = await this.sendAndWaitForAck(frame);
+        const ack = ackEnvelope.frame;
+        if (!ack.ok) {
+            throw new Error(`Unbind of '${address}' was rejected`);
+        }
+    }
+    async advertiseCapabilities(address, capabilities) {
+        if (!capabilities.length) {
+            return;
+        }
+        const frame = {
+            type: 'CapabilityAdvertise',
+            address: address.toString(),
+            capabilities,
+        };
+        const ackEnvelope = await this.sendAndWaitForAck(frame);
+        const ack = ackEnvelope.frame;
+        if (!ack.ok) {
+            throw new Error(`Capability advertise rejected: ${capabilities.join(', ')}`);
+        }
+    }
+    async withdrawCapabilities(address, capabilities) {
+        if (!capabilities.length) {
+            return;
+        }
+        const frame = {
+            type: 'CapabilityWithdraw',
+            address: address.toString(),
+            capabilities,
+        };
+        const ackEnvelope = await this.sendAndWaitForAck(frame);
+        const ack = ackEnvelope.frame;
+        if (!ack.ok) {
+            throw new Error(`Capability withdraw rejected: ${capabilities.join(', ')}`);
+        }
+        const key = address.toString();
+        const existing = this.capabilitiesByAddress.get(key);
+        if (!existing) {
+            return;
+        }
+        capabilities.forEach((cap) => existing.delete(cap));
+        if (!existing.size) {
+            this.capabilitiesByAddress.delete(key);
+        }
+    }
+    async sendAndWaitForAck(frame) {
+        const corrId = (0, core_1.generateId)();
+        const replyTo = (0, core_1.formatAddress)(SYSTEM_INBOX, this.getPhysicalPath());
+        const traceId = (0, envelope_context_js_1.currentTraceId)();
+        const envelopeOptions = {
+            frame,
+            corrId,
+            replyTo,
+        };
+        if (traceId) {
+            envelopeOptions.traceId = traceId;
+        }
+        const envelope = this.envelopeFactory.createEnvelope(envelopeOptions);
+        await this.deliveryTracker.track(envelope, {
+            timeoutMs: this.ackTimeoutMs,
+            expectedResponseType: core_1.FameResponseType.ACK,
+        });
+        envelope.rtype = core_1.FameResponseType.ACK;
+        const ackPromise = this.deliveryTracker.awaitAck(envelope.id);
+        await this.forwardUpstream(envelope, (0, core_1.localDeliveryContext)(this.getId()));
+        return ackPromise;
+    }
+    findHostPoolClaim(acceptedLogicals, logical) {
+        for (const pattern of acceptedLogicals) {
+            if ((0, logicals_js_1.isPoolLogical)(pattern) && (0, logicals_js_1.matchesPoolLogical)(logical, pattern)) {
+                return pattern;
+            }
+        }
+        return null;
+    }
+    isAcceptedLogicalHost(logical, acceptedLogicals) {
+        return acceptedLogicals.has(logical) && !(0, logicals_js_1.isPoolLogical)(logical);
+    }
+    shouldRebind(address) {
+        try {
+            const [, host] = (0, core_1.parseAddressComponents)(address);
+            if (!host) {
+                return false;
+            }
+            const accepted = this.getAcceptedLogicalsSnapshot();
+            const poolClaim = this.findHostPoolClaim(accepted, host);
+            const exact = this.isAcceptedLogicalHost(host, accepted);
+            return Boolean(poolClaim || exact);
+        }
+        catch {
+            return false;
+        }
+    }
+    getAcceptedLogicalsSnapshot() {
+        const values = this.getAcceptedLogicalsFn();
+        return values instanceof Set
+            ? new Set(values)
+            : new Set(Array.from(values));
+    }
+    defaultBindingFactory(address) {
+        const channel = new in_memory_channel_js_1.InMemoryReadWriteChannel();
+        return new core_1.Binding(channel, address);
+    }
+}
+exports.BindingManager = BindingManager;
+//# sourceMappingURL=binding-manager.js.map