@naylence/runtime 0.3.4 → 0.3.5-test.0

package/dist/esm/src/naylence/fame/util/util.js

@@ -0,0 +1,346 @@
+/**
+ * General utility functions for JSON handling, string manipulation,
+ * path normalization, base64 encoding, hashing, and more.
+ */
+import { sha256 } from '@noble/hashes/sha2.js';
+import { color, AnsiColor, formatTimestamp } from './formatter.js';
+export const ENV_VAR_SHOW_ENVELOPES = 'FAME_SHOW_ENVELOPES';
+export function isEnvelopeLoggingEnabled() {
+    return (typeof process !== 'undefined' &&
+        process.env?.[ENV_VAR_SHOW_ENVELOPES] === 'true');
+}
+export const showEnvelopes = isEnvelopeLoggingEnabled();
+export function formatTimestampForConsole() {
+    return color(formatTimestamp(), AnsiColor.GRAY);
+}
+export function prettyModel(value) {
+    try {
+        return jsonDumps(value);
+    }
+    catch (error) {
+        return String(error);
+    }
+}
+/**
+ * Default JSON encoder for non-standard types.
+ */
+export function defaultJsonEncoder(obj) {
+    if (obj instanceof Date) {
+        return obj.toISOString().replace(/\.\d{3}Z$/, 'Z'); // Remove milliseconds for Python compatibility
+    }
+    throw new TypeError(`Object of type ${typeof obj} is not JSON serializable`);
+}
+/**
+ * Capitalize the first letter of a string.
+ */
+export function capitalizeFirstLetter(text) {
+    if (!text) {
+        return text;
+    }
+    return text[0].toUpperCase() + text.slice(1);
+}
+/**
+ * Convert a value to pretty-printed JSON string.
+ */
+export function jsonDumps(value) {
+    const seen = new WeakSet();
+    const replacer = (_key, val) => {
+        try {
+            return defaultJsonEncoder(val);
+        }
+        catch {
+            // ignore – fall through to default handling below
+        }
+        if (typeof val === 'bigint') {
+            return val.toString();
+        }
+        if (typeof val === 'object' && val !== null) {
+            if (seen.has(val)) {
+                return '[Circular]';
+            }
+            seen.add(val);
+        }
+        return val;
+    };
+    return JSON.stringify(value, replacer, 2);
+}
+/**
+ * Extract an ID from an object (either from object property or 'id' key).
+ */
+export function extractId(obj) {
+    if (typeof obj === 'object' && obj !== null) {
+        if ('id' in obj) {
+            return obj.id;
+        }
+    }
+    return null;
+}
+/**
+ * Maybe await a value that could be a Promise or regular value.
+ */
+export async function maybeAwait(valueOrPromise) {
+    if (valueOrPromise instanceof Promise) {
+        return await valueOrPromise;
+    }
+    return valueOrPromise;
+}
+/**
+ * Convert an object to JSON bytes.
+ */
+export function objectToBytes(obj) {
+    const jsonString = JSON.stringify(obj);
+    return new TextEncoder().encode(jsonString);
+}
+/**
+ * Decode Fame data payload based on codec.
+ */
+export function decodeFameDataPayload(frame) {
+    if (frame.codec === 'b64') {
+        // Decode base64 to bytes
+        const base64 = frame.payload;
+        const binaryString = atob(base64);
+        const bytes = new Uint8Array(binaryString.length);
+        for (let i = 0; i < binaryString.length; i++) {
+            bytes[i] = binaryString.charCodeAt(i);
+        }
+        return bytes;
+    }
+    return frame.payload;
+}
+/**
+ * Normalize a path by removing leading slashes.
+ */
+export function normalizePath(path) {
+    return path.replace(/^\/+/, '');
+}
+/**
+ * Cache for compiled path patterns.
+ */
+const pathPatternCache = new Map();
+/**
+ * Translate a shell-style wildcard pattern into a compiled regex
+ * and cache the result for speed.
+ */
+export function compiledPathPattern(pattern) {
+    let compiled = pathPatternCache.get(pattern);
+    if (!compiled) {
+        // Convert shell wildcard to regex
+        const regexPattern = pattern
+            .replace(/[.+^${}()|[\]\\]/g, '\\$&') // Escape regex special chars
+            .replace(/\*/g, '.*') // * becomes .*
+            .replace(/\?/g, '.'); // ? becomes .
+        compiled = new RegExp(`^${regexPattern}$`);
+        // Limit cache size to prevent memory leaks
+        if (pathPatternCache.size > 256) {
+            pathPatternCache.clear();
+        }
+        pathPatternCache.set(pattern, compiled);
+    }
+    return compiled;
+}
+// Base62 characters: 0–9, a–z, A–Z
+const BASE62_CHARS = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
+const BASE62_BASE = BigInt(BASE62_CHARS.length);
+/**
+ * Convert a number to base62 string.
+ */
+function toBase62(num) {
+    if (num === 0n) {
+        return BASE62_CHARS[0];
+    }
+    const result = [];
+    let value = num;
+    while (value > 0n) {
+        const remainder = value % BASE62_BASE;
+        result.push(BASE62_CHARS[Number(remainder)]);
+        value = value / BASE62_BASE;
+    }
+    return result.reverse().join('');
+}
+/**
+ * Create a secure digest of a string.
+ * @param s Input string
+ * @param bits Number of bits to include in digest (default: 128)
+ * @returns Base62-encoded digest
+ */
+export function secureDigest(s, bits = 128) {
+    try {
+        const digest = sha256(new TextEncoder().encode(s));
+        const desiredBytes = Math.min(digest.length, Math.max(1, Math.ceil(bits / 8)));
+        let value = 0n;
+        for (let i = 0; i < desiredBytes; i += 1) {
+            value = (value << 8n) | BigInt(digest[i]);
+        }
+        return toBase62(value);
+    }
+    catch {
+        // Fallback for environments without TextEncoder support
+        let hash = 0;
+        for (let i = 0; i < s.length; i += 1) {
+            const char = s.charCodeAt(i);
+            hash = (hash << 5) - hash + char;
+            hash = hash & hash; // Convert to 32bit integer
+        }
+        return toBase62(BigInt(Math.abs(hash)));
+    }
+}
+/**
+ * URL-safe base64 encode (without padding).
+ */
+export function urlsafeBase64Encode(data) {
+    // Convert Uint8Array to string for btoa
+    let binaryString = '';
+    for (let i = 0; i < data.length; i++) {
+        binaryString += String.fromCharCode(data[i]);
+    }
+    return btoa(binaryString)
+        .replace(/\+/g, '-')
+        .replace(/\//g, '_')
+        .replace(/=+$/, '');
+}
+export function urlsafeBase64Decode(value) {
+    const normalized = value.replace(/-/g, '+').replace(/_/g, '/');
+    const padded = normalized.padEnd(Math.ceil(normalized.length / 4) * 4, '=');
+    if (typeof atob === 'function') {
+        const binary = atob(padded);
+        const bytes = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i++) {
+            bytes[i] = binary.charCodeAt(i);
+        }
+        return bytes;
+    }
+    if (typeof Buffer !== 'undefined') {
+        return new Uint8Array(Buffer.from(padded, 'base64'));
+    }
+    throw new Error('Base64 decoding is not available in this environment');
+}
+/**
+ * Convert CamelCase string to snake_case.
+ */
+export function camelToSnakeCase(name) {
+    // Insert underscore before uppercase letters that follow lowercase letters or digits
+    let result = name.replace(/([a-z0-9])([A-Z])/g, '$1_$2');
+    // Insert underscore before uppercase letters that are followed by lowercase letters
+    result = result.replace(/([A-Z])([A-Z][a-z])/g, '$1_$2');
+    return result.toLowerCase();
+}
+/**
+ * Create a shallow copy of an object's top-level properties and add
+ * snake_case aliases for any camelCase keys while also adding camelCase
+ * aliases for snake_case keys when missing. Existing keys always win.
+ */
+export function withLegacySnakeCaseKeys(descriptor) {
+    const augmented = { ...descriptor };
+    for (const [key, value] of Object.entries(descriptor)) {
+        const snakeCaseKey = key.includes('_') ? key : camelToSnakeCase(key);
+        const camelCaseKey = key.includes('_') ? snakeToCamelCase(key) : key;
+        if (snakeCaseKey !== key && !(snakeCaseKey in augmented)) {
+            augmented[snakeCaseKey] = value;
+        }
+        if (camelCaseKey !== key && !(camelCaseKey in augmented)) {
+            augmented[camelCaseKey] = value;
+        }
+    }
+    return augmented;
+}
+/**
+ * Convert snake_case string to CamelCase.
+ */
+export function snakeToCamelCase(name) {
+    return name.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+/**
+ * Check if a value is a plain object (not an array, Date, etc.).
+ */
+export function isPlainObject(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        value.constructor === Object &&
+        Object.prototype.toString.call(value) === '[object Object]');
+}
+/**
+ * Deep merge two objects.
+ */
+export function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key in source) {
+        if (source.hasOwnProperty(key)) {
+            const sourceValue = source[key];
+            const targetValue = result[key];
+            if (isPlainObject(sourceValue) && isPlainObject(targetValue)) {
+                result[key] = deepMerge(targetValue, sourceValue);
+            }
+            else {
+                result[key] = sourceValue;
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Create a debounced version of a function.
+ */
+export function debounce(func, wait) {
+    let timeout;
+    return function (...args) {
+        const later = () => {
+            timeout = undefined;
+            func.apply(this, args);
+        };
+        clearTimeout(timeout);
+        timeout = setTimeout(later, wait);
+    };
+}
+/**
+ * Create a throttled version of a function.
+ */
+export function throttle(func, wait) {
+    let timeout;
+    let previous = 0;
+    return function (...args) {
+        const now = Date.now();
+        const remaining = wait - (now - previous);
+        if (remaining <= 0 || remaining > wait) {
+            if (timeout) {
+                clearTimeout(timeout);
+                timeout = undefined;
+            }
+            previous = now;
+            func.apply(this, args);
+        }
+        else if (!timeout) {
+            timeout = setTimeout(() => {
+                previous = Date.now();
+                timeout = undefined;
+                func.apply(this, args);
+            }, remaining);
+        }
+    };
+}
+/**
+ * Sleep for a specified number of milliseconds.
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Retry a function with exponential backoff.
+ */
+export async function retryWithBackoff(fn, maxRetries = 3, baseDelay = 1000, maxDelay = 10000) {
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (attempt === maxRetries) {
+                throw lastError;
+            }
+            const delay = Math.min(baseDelay * Math.pow(2, attempt), maxDelay);
+            await sleep(delay);
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=util.js.map

package/dist/esm/src/naylence/fame/util/util.js.map

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

package/dist/esm/src/naylence/fame/welcome/default-welcome-service-factory.js

@@ -0,0 +1,85 @@
+import { AuthorizerFactory } from '../security/auth/authorizer-factory.js';
+import { TokenIssuerFactory } from '../security/auth/token-issuer-factory.js';
+import { NodePlacementStrategyFactory } from '../placement/node-placement-strategy-factory.js';
+import { TransportProvisionerFactory } from '../transport/transport-provisioner.js';
+import { DefaultWelcomeService, } from './default-welcome-service.js';
+import { WELCOME_SERVICE_FACTORY_BASE_TYPE, WelcomeServiceFactory, } from './welcome-service-factory.js';
+export const FACTORY_META = {
+    base: WELCOME_SERVICE_FACTORY_BASE_TYPE,
+    key: 'DefaultWelcomeService',
+};
+export class DefaultWelcomeServiceFactory extends WelcomeServiceFactory {
+    constructor() {
+        super(...arguments);
+        this.type = 'DefaultWelcomeService';
+        this.isDefault = true;
+    }
+    async create(config, ...factoryArgs) {
+        const normalized = normalizeConfig(config);
+        const placementStrategy = await NodePlacementStrategyFactory.createNodePlacementStrategy(normalized.placementConfig ?? null, factoryArgs.length > 0 ? { factoryArgs } : undefined);
+        const transportProvisioner = await TransportProvisionerFactory.createTransportProvisioner(normalized.transportConfig ?? null, factoryArgs.length > 0 ? { factoryArgs } : undefined);
+        const tokenIssuer = await TokenIssuerFactory.createTokenIssuer(normalized.tokenIssuerConfig ?? null, factoryArgs.length > 0 ? { factoryArgs } : undefined);
+        let authorizer = null;
+        if (normalized.authorizerConfig) {
+            authorizer =
+                (await AuthorizerFactory.createAuthorizer(normalized.authorizerConfig, {
+                    factoryArgs,
+                })) ?? null;
+        }
+        const options = {
+            placementStrategy,
+            transportProvisioner,
+            tokenIssuer,
+            authorizer,
+        };
+        if (normalized.ttlSec !== undefined) {
+            options.ttlSec = normalized.ttlSec;
+        }
+        return new DefaultWelcomeService(options);
+    }
+}
+function normalizeConfig(config) {
+    if (!config) {
+        return {};
+    }
+    const source = config;
+    const ttlCandidate = typeof source.ttlSec === 'number'
+        ? source.ttlSec
+        : typeof source.ttl_sec === 'number'
+            ? source.ttl_sec
+            : undefined;
+    const normalized = {};
+    const placementResult = resolveConfigEntry(source, ['placement', 'placementConfig', 'placement_config']);
+    if (placementResult.found && placementResult.value !== undefined) {
+        normalized.placementConfig = placementResult.value ?? null;
+    }
+    const transportResult = resolveConfigEntry(source, ['transport', 'transportProvisioner', 'transport_provisioner']);
+    if (transportResult.found && transportResult.value !== undefined) {
+        normalized.transportConfig = transportResult.value ?? null;
+    }
+    const tokenResult = resolveConfigEntry(source, ['tokenIssuer', 'token_issuer']);
+    if (tokenResult.found && tokenResult.value !== undefined) {
+        normalized.tokenIssuerConfig = tokenResult.value ?? null;
+    }
+    const authorizerResult = resolveConfigEntry(source, ['authorizer', 'authorizerConfig', 'authorizer_config']);
+    if (authorizerResult.found && authorizerResult.value !== undefined) {
+        normalized.authorizerConfig = authorizerResult.value ?? null;
+    }
+    if (ttlCandidate !== undefined && Number.isFinite(ttlCandidate)) {
+        normalized.ttlSec = ttlCandidate;
+    }
+    return normalized;
+}
+function resolveConfigEntry(source, keys) {
+    for (const key of keys) {
+        if (Object.prototype.hasOwnProperty.call(source, key)) {
+            return {
+                found: true,
+                value: source[key],
+            };
+        }
+    }
+    return { found: false, value: undefined };
+}
+export default DefaultWelcomeServiceFactory;
+//# sourceMappingURL=default-welcome-service-factory.js.map

package/dist/esm/src/naylence/fame/welcome/default-welcome-service-factory.js.map

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

package/dist/esm/src/naylence/fame/welcome/default-welcome-service.js

@@ -0,0 +1,229 @@
+import { generateId, } from '@naylence/core';
+import { color, AnsiColor, formatTimestamp } from '../util/formatter.js';
+import { jsonDumps } from '../util/util.js';
+import { validateHostLogicals } from '../util/logicals.js';
+import { getLogger } from '../util/logging.js';
+const logger = getLogger('naylence.fame.welcome.default_welcome_service');
+const ENV_VAR_SHOW_ENVELOPES = 'FAME_SHOW_ENVELOPES';
+const DEFAULT_TTL_SEC = 3600;
+const showEnvelopes = typeof process !== 'undefined' && resolveShowEnvelopesFlag(process.env);
+function nowUtc() {
+    return new Date();
+}
+function formatTimestampForConsole() {
+    return color(formatTimestamp(), AnsiColor.GRAY);
+}
+function prettyModel(value) {
+    try {
+        return jsonDumps(value);
+    }
+    catch (error) {
+        return String(error);
+    }
+}
+function coercePlacementMetadataValue(metadata, camelCaseKey, snakeCaseKey) {
+    if (!metadata) {
+        return undefined;
+    }
+    const candidate = metadata[camelCaseKey];
+    if (candidate !== undefined) {
+        return candidate;
+    }
+    const snakeCandidate = metadata[snakeCaseKey];
+    if (snakeCandidate !== undefined) {
+        return snakeCandidate;
+    }
+    return undefined;
+}
+export class DefaultWelcomeService {
+    constructor(options) {
+        this.placementStrategy = options.placementStrategy;
+        this.transportProvisioner = options.transportProvisioner;
+        this.tokenIssuer = options.tokenIssuer;
+        this.authorizer = options.authorizer ?? null;
+        this.ttlSec = resolveTtlSeconds(options);
+    }
+    async handleHello(hello, metadata) {
+        const fullMetadata = metadata
+            ? { ...metadata }
+            : {};
+        const trimmedSystemId = typeof hello.systemId === 'string' ? hello.systemId.trim() : '';
+        const systemId = trimmedSystemId.length > 0 ? trimmedSystemId : generateId();
+        const wasAssigned = trimmedSystemId.length === 0;
+        const normalizedHello = {
+            ...hello,
+            systemId,
+        };
+        if (showEnvelopes) {
+            // eslint-disable-next-line no-console
+            console.log(`\n${formatTimestampForConsole()} - ${color('Received envelope 📨', AnsiColor.BLUE)}\n${prettyModel(normalizedHello)}`);
+        }
+        logger.debug('starting_hello_frame_processing', {
+            instanceId: normalizedHello.instanceId,
+            systemId,
+            logicals: normalizedHello.logicals,
+            capabilities: normalizedHello.capabilities,
+            ttlSec: this.ttlSec,
+        });
+        const now = nowUtc();
+        const expiry = new Date(now.getTime() + this.ttlSec * 1000);
+        if (fullMetadata.instanceId === undefined && normalizedHello.instanceId) {
+            fullMetadata.instanceId = normalizedHello.instanceId;
+        }
+        if (fullMetadata.instance_id === undefined && normalizedHello.instanceId) {
+            fullMetadata.instance_id = normalizedHello.instanceId;
+        }
+        logger.debug('system_id_assignment_completed', {
+            systemId,
+            wasAssigned,
+        });
+        if (normalizedHello.logicals?.length) {
+            logger.debug('validating_logicals_for_dns_compatibility', {
+                logicals: normalizedHello.logicals,
+            });
+            const [pathsValid, pathError] = validateHostLogicals(normalizedHello.logicals);
+            if (!pathsValid) {
+                logger.error('logical_validation_failed', {
+                    error: pathError,
+                    logicals: normalizedHello.logicals,
+                });
+                throw new Error(`Invalid logical format: ${pathError}`);
+            }
+            logger.debug('logicals_validation_successful');
+        }
+        logger.debug('requesting_node_placement', { systemId });
+        const placementResult = await this.placementStrategy.place(normalizedHello);
+        if (!placementResult.accept) {
+            logger.error('node_placement_rejected', {
+                systemId,
+                reason: placementResult.reason,
+            });
+            throw new Error(placementResult.reason || 'Node not accepted');
+        }
+        const assignedPath = placementResult.assignedPath;
+        logger.debug('node_placement_accepted', {
+            systemId,
+            assignedPath,
+            targetPhysicalPath: placementResult.targetPhysicalPath ?? null,
+            targetSystemId: placementResult.targetSystemId ?? null,
+        });
+        const acceptedCapabilities = coercePlacementMetadataValue(placementResult.metadata, 'acceptedCapabilities', 'accepted_capabilities') ??
+            normalizedHello.capabilities ??
+            null;
+        const acceptedLogicals = coercePlacementMetadataValue(placementResult.metadata, 'acceptedLogicals', 'accepted_logicals') ??
+            normalizedHello.logicals ??
+            null;
+        logger.debug('processing_placement_result_metadata', {
+            acceptedCapabilities,
+            acceptedLogicals,
+            hasPlacementMetadata: placementResult.metadata !== undefined &&
+                placementResult.metadata !== null,
+        });
+        const connectionGrants = [];
+        if (placementResult.targetSystemId) {
+            logger.debug('issuing_node_attach_token', {
+                systemId,
+                assignedPath,
+            });
+            const nodeAttachToken = await this.tokenIssuer.issue({
+                aud: placementResult.targetPhysicalPath,
+                system_id: systemId,
+                parent_path: placementResult.targetPhysicalPath,
+                assigned_path: placementResult.assignedPath,
+                accepted_logicals: acceptedLogicals,
+                instance_id: (typeof fullMetadata.instanceId === 'string' &&
+                    fullMetadata.instanceId) ||
+                    (typeof fullMetadata.instance_id === 'string' &&
+                        fullMetadata.instance_id) ||
+                    normalizedHello.instanceId ||
+                    generateId(),
+            });
+            logger.debug('token_issued_successfully');
+            logger.debug('provisioning_transport', { systemId });
+            const transportInfo = await this.transportProvisioner.provision(placementResult, normalizedHello, fullMetadata, nodeAttachToken);
+            logger.debug('transport_provisioned_successfully', {
+                systemId,
+                directiveType: transportInfo.connectionGrant &&
+                    typeof transportInfo.connectionGrant === 'object'
+                    ? (transportInfo.connectionGrant.type ??
+                        'Unknown')
+                    : 'Unknown',
+            });
+            connectionGrants.push(transportInfo.connectionGrant);
+        }
+        const welcomeFrame = {
+            type: 'NodeWelcome',
+            systemId,
+            targetSystemId: placementResult.targetSystemId ?? undefined,
+            targetPhysicalPath: placementResult.targetPhysicalPath ?? undefined,
+            instanceId: normalizedHello.instanceId,
+            assignedPath,
+            acceptedCapabilities: acceptedCapabilities ?? undefined,
+            acceptedLogicals: acceptedLogicals ?? undefined,
+            rejectedLogicals: undefined,
+            connectionGrants,
+            metadata: Object.keys(fullMetadata).length > 0 ? fullMetadata : undefined,
+            expiresAt: expiry.toISOString(),
+        };
+        logger.debug('hello_frame_processing_completed_successfully', {
+            systemId,
+            assignedPath,
+            acceptedLogicals,
+            acceptedCapabilities,
+            expiresAt: welcomeFrame.expiresAt,
+            instanceId: normalizedHello.instanceId,
+        });
+        if (showEnvelopes) {
+            // eslint-disable-next-line no-console
+            console.log(`\n${formatTimestampForConsole()} - ${color('Sent envelope', AnsiColor.BLUE)} 🚀\n${prettyModel(welcomeFrame)}`);
+        }
+        return welcomeFrame;
+    }
+}
+function toCamelAlias(snakeKey) {
+    return snakeKey
+        .toLowerCase()
+        .replace(/_([a-z])/g, (_match, char) => char.toUpperCase());
+}
+function readEnvValue(env, snakeKey) {
+    if (!env) {
+        return undefined;
+    }
+    if (env[snakeKey] !== undefined) {
+        return env[snakeKey];
+    }
+    const lowerKey = snakeKey.toLowerCase();
+    if (env[lowerKey] !== undefined) {
+        return env[lowerKey];
+    }
+    const camelKey = toCamelAlias(snakeKey);
+    if (env[camelKey] !== undefined) {
+        return env[camelKey];
+    }
+    const pascalKey = camelKey.length > 0
+        ? camelKey[0].toUpperCase() + camelKey.slice(1)
+        : camelKey;
+    if (pascalKey && env[pascalKey] !== undefined) {
+        return env[pascalKey];
+    }
+    return undefined;
+}
+export function resolveShowEnvelopesFlag(env) {
+    const candidate = readEnvValue(env, ENV_VAR_SHOW_ENVELOPES);
+    if (typeof candidate !== 'string') {
+        return false;
+    }
+    return candidate.trim().toLowerCase() === 'true';
+}
+function resolveTtlSeconds(options) {
+    const candidate = typeof options.ttlSec === 'number'
+        ? options.ttlSec
+        : typeof options.ttl_sec === 'number'
+            ? options.ttl_sec
+            : undefined;
+    if (typeof candidate === 'number' && Number.isFinite(candidate)) {
+        return Math.max(0, candidate);
+    }
+    return DEFAULT_TTL_SEC;
+}
+//# sourceMappingURL=default-welcome-service.js.map