@omen.foundation/node-microservice-runtime 0.1.0

package/dist/env.d.ts

@@ -0,0 +1,4 @@
+import type { EnvironmentConfig } from './types.js';
+export declare function loadEnvironmentConfig(): EnvironmentConfig;
+export declare function ensureWritableTempDirectory(): string;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAqFpD,wBAAgB,qBAAqB,IAAI,iBAAiB,CA4BzD;AAED,wBAAgB,2BAA2B,IAAI,MAAM,CAMpD"}

package/dist/env.js

@@ -0,0 +1,108 @@
+import { existsSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { getDefaultRoutingKeyForMachine } from './routing.js';
+function getBoolean(name, defaultValue = false) {
+    const raw = process.env[name];
+    if (!raw) {
+        return defaultValue;
+    }
+    return ['1', 'true', 'yes', 'on'].includes(raw.toLowerCase());
+}
+function getNumber(name, defaultValue) {
+    const raw = process.env[name];
+    if (!raw) {
+        return defaultValue;
+    }
+    const parsed = Number(raw);
+    return Number.isFinite(parsed) ? parsed : defaultValue;
+}
+function resolveHealthPort() {
+    // Always default to 6565 if HEALTH_PORT is not explicitly set
+    // This ensures the health check server starts in deployed environments
+    // even if container detection fails or HEALTH_PORT env var is missing
+    const preferred = getNumber('HEALTH_PORT', 6565);
+    if (preferred > 0) {
+        return preferred;
+    }
+    // Use PID-scoped pseudo random port to avoid collisions on dev machines.
+    const base = 45000;
+    const span = 2000;
+    const candidate = base + (process.pid % span);
+    return candidate;
+}
+function resolveRoutingKey() {
+    const raw = process.env.NAME_PREFIX ?? process.env.ROUTING_KEY;
+    if (raw && raw.trim().length > 0) {
+        return raw.trim();
+    }
+    // For deployed services (in containers), routing key should be undefined (None in Scala)
+    // Beamable sets CID, PID, HOST, SECRET in containers but NOT routing key
+    // If we have the required Beamable env vars but no routing key, we're in a deployed container
+    const hasBeamableEnvVars = process.env.CID && process.env.PID && process.env.HOST && process.env.SECRET;
+    const hasNoRoutingKey = !raw || raw.trim().length === 0;
+    if (hasBeamableEnvVars && hasNoRoutingKey) {
+        // We're in a deployed container - return undefined (becomes None in Scala)
+        // This allows the gateway to find bindings without routing key filter
+        return undefined;
+    }
+    // Local development - try to get a routing key
+    try {
+        return getDefaultRoutingKeyForMachine();
+    }
+    catch (error) {
+        throw new Error(`Unable to determine routing key automatically. Set NAME_PREFIX environment variable. ${error.message}`);
+    }
+}
+function resolveSdkVersionExecution() {
+    return process.env.BEAMABLE_SDK_VERSION_EXECUTION ?? '';
+}
+function resolveLogLevel() {
+    const candidate = process.env.LOG_LEVEL ?? 'info';
+    const allowed = new Set(['fatal', 'error', 'warn', 'info', 'debug', 'trace']);
+    return allowed.has(candidate.toLowerCase()) ? candidate.toLowerCase() : 'info';
+}
+function resolveWatchToken() {
+    const value = process.env.WATCH_TOKEN;
+    if (value === undefined) {
+        return false;
+    }
+    return getBoolean('WATCH_TOKEN', false);
+}
+function resolveBeamInstanceCount() {
+    return getNumber('BEAM_INSTANCE_COUNT', 1);
+}
+export function loadEnvironmentConfig() {
+    const cid = process.env.CID ?? '';
+    const pid = process.env.PID ?? '';
+    const host = process.env.HOST ?? '';
+    if (!cid || !pid || !host) {
+        throw new Error('Missing required Beamable environment variables (CID, PID, HOST).');
+    }
+    const config = {
+        cid,
+        pid,
+        host,
+        secret: process.env.SECRET ?? undefined,
+        refreshToken: process.env.REFRESH_TOKEN ?? undefined,
+        routingKey: resolveRoutingKey(),
+        accountId: getNumber('USER_ACCOUNT_ID', 0) || undefined,
+        accountEmail: process.env.USER_EMAIL ?? undefined,
+        logLevel: resolveLogLevel(),
+        healthPort: resolveHealthPort(),
+        disableCustomInitializationHooks: getBoolean('DISABLE_CUSTOM_INITIALIZATION_HOOKS', false),
+        watchToken: resolveWatchToken(),
+        sdkVersionExecution: resolveSdkVersionExecution(),
+        beamInstanceCount: resolveBeamInstanceCount(),
+        logTruncateLimit: getNumber('LOG_TRUNCATE_LIMIT', 1000),
+    };
+    return config;
+}
+export function ensureWritableTempDirectory() {
+    const candidate = process.env.LOG_PATH ?? join(tmpdir(), 'beamable-node-runtime');
+    if (!existsSync(candidate)) {
+        return candidate;
+    }
+    return candidate;
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync } from 'node:fs';\r\nimport { tmpdir } from 'node:os';\r\nimport { join } from 'node:path';\r\nimport type { EnvironmentConfig } from './types.js';\r\nimport { getDefaultRoutingKeyForMachine } from './routing.js';\r\n\r\nfunction getBoolean(name: string, defaultValue = false): boolean {\r\n  const raw = process.env[name];\r\n  if (!raw) {\r\n    return defaultValue;\r\n  }\r\n  return ['1', 'true', 'yes', 'on'].includes(raw.toLowerCase());\r\n}\r\n\r\nfunction getNumber(name: string, defaultValue: number): number {\r\n  const raw = process.env[name];\r\n  if (!raw) {\r\n    return defaultValue;\r\n  }\r\n  const parsed = Number(raw);\r\n  return Number.isFinite(parsed) ? parsed : defaultValue;\r\n}\r\n\r\nfunction resolveHealthPort(): number {\r\n  // Always default to 6565 if HEALTH_PORT is not explicitly set\r\n  // This ensures the health check server starts in deployed environments\r\n  // even if container detection fails or HEALTH_PORT env var is missing\r\n  const preferred = getNumber('HEALTH_PORT', 6565);\r\n  if (preferred > 0) {\r\n    return preferred;\r\n  }\r\n  // Use PID-scoped pseudo random port to avoid collisions on dev machines.\r\n  const base = 45000;\r\n  const span = 2000;\r\n  const candidate = base + (process.pid % span);\r\n  return candidate;\r\n}\r\n\r\nfunction resolveRoutingKey(): string | undefined {\r\n  const raw = process.env.NAME_PREFIX ?? process.env.ROUTING_KEY;\r\n  if (raw && raw.trim().length > 0) {\r\n    return raw.trim();\r\n  }\r\n\r\n  // For deployed services (in containers), routing key should be undefined (None in Scala)\r\n  // Beamable sets CID, PID, HOST, SECRET in containers but NOT routing key\r\n  // If we have the required Beamable env vars but no routing key, we're in a deployed container\r\n  const hasBeamableEnvVars = process.env.CID && process.env.PID && process.env.HOST && process.env.SECRET;\r\n  const hasNoRoutingKey = !raw || raw.trim().length === 0;\r\n  \r\n  if (hasBeamableEnvVars && hasNoRoutingKey) {\r\n    // We're in a deployed container - return undefined (becomes None in Scala)\r\n    // This allows the gateway to find bindings without routing key filter\r\n    return undefined;\r\n  }\r\n\r\n  // Local development - try to get a routing key\r\n  try {\r\n    return getDefaultRoutingKeyForMachine();\r\n  } catch (error) {\r\n    throw new Error(\r\n      `Unable to determine routing key automatically. Set NAME_PREFIX environment variable. ${(error as Error).message}`,\r\n    );\r\n  }\r\n}\r\n\r\nfunction resolveSdkVersionExecution(): string {\r\n  return process.env.BEAMABLE_SDK_VERSION_EXECUTION ?? '';\r\n}\r\n\r\nfunction resolveLogLevel(): string {\r\n  const candidate = process.env.LOG_LEVEL ?? 'info';\r\n  const allowed = new Set(['fatal', 'error', 'warn', 'info', 'debug', 'trace']);\r\n  return allowed.has(candidate.toLowerCase()) ? candidate.toLowerCase() : 'info';\r\n}\r\n\r\nfunction resolveWatchToken(): boolean {\r\n  const value = process.env.WATCH_TOKEN;\r\n  if (value === undefined) {\r\n    return false;\r\n  }\r\n  return getBoolean('WATCH_TOKEN', false);\r\n}\r\n\r\nfunction resolveBeamInstanceCount(): number {\r\n  return getNumber('BEAM_INSTANCE_COUNT', 1);\r\n}\r\n\r\nexport function loadEnvironmentConfig(): EnvironmentConfig {\r\n  const cid = process.env.CID ?? '';\r\n  const pid = process.env.PID ?? '';\r\n  const host = process.env.HOST ?? '';\r\n\r\n  if (!cid || !pid || !host) {\r\n    throw new Error('Missing required Beamable environment variables (CID, PID, HOST).');\r\n  }\r\n\r\n  const config: EnvironmentConfig = {\r\n    cid,\r\n    pid,\r\n    host,\r\n    secret: process.env.SECRET ?? undefined,\r\n    refreshToken: process.env.REFRESH_TOKEN ?? undefined,\r\n    routingKey: resolveRoutingKey(),\r\n    accountId: getNumber('USER_ACCOUNT_ID', 0) || undefined,\r\n    accountEmail: process.env.USER_EMAIL ?? undefined,\r\n    logLevel: resolveLogLevel(),\r\n    healthPort: resolveHealthPort(),\r\n    disableCustomInitializationHooks: getBoolean('DISABLE_CUSTOM_INITIALIZATION_HOOKS', false),\r\n    watchToken: resolveWatchToken(),\r\n    sdkVersionExecution: resolveSdkVersionExecution(),\r\n    beamInstanceCount: resolveBeamInstanceCount(),\r\n    logTruncateLimit: getNumber('LOG_TRUNCATE_LIMIT', 1000),\r\n  };\r\n\r\n  return config;\r\n}\r\n\r\nexport function ensureWritableTempDirectory(): string {\r\n  const candidate = process.env.LOG_PATH ?? join(tmpdir(), 'beamable-node-runtime');\r\n  if (!existsSync(candidate)) {\r\n    return candidate;\r\n  }\r\n  return candidate;\r\n}\r\n"]}

package/dist/errors.cjs

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidConfigurationError = exports.SerializationError = exports.UnknownRouteError = exports.UnauthorizedUserError = exports.MissingScopesError = exports.TimeoutError = exports.AuthenticationError = exports.BeamableRuntimeError = void 0;
+class BeamableRuntimeError extends Error {
+    constructor(code, message, cause) {
+        var _a;
+        super(message);
+        this.code = code;
+        if (cause !== undefined) {
+            this.cause = cause;
+        }
+        this.name = this.constructor.name;
+        (_a = Error.captureStackTrace) === null || _a === void 0 ? void 0 : _a.call(Error, this, this.constructor);
+    }
+}
+exports.BeamableRuntimeError = BeamableRuntimeError;
+class AuthenticationError extends BeamableRuntimeError {
+    constructor(message, cause) {
+        super('AUTHENTICATION_FAILED', message, cause);
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+class TimeoutError extends BeamableRuntimeError {
+    constructor(message, cause) {
+        super('TIMEOUT', message, cause);
+    }
+}
+exports.TimeoutError = TimeoutError;
+class MissingScopesError extends BeamableRuntimeError {
+    constructor(requiredScopes) {
+        super('MISSING_SCOPES', `Missing required scopes: ${Array.from(requiredScopes).join(', ')}`);
+    }
+}
+exports.MissingScopesError = MissingScopesError;
+class UnauthorizedUserError extends BeamableRuntimeError {
+    constructor(route) {
+        super('UNAUTHORIZED_USER', `Route "${route}" requires an authenticated user.`);
+    }
+}
+exports.UnauthorizedUserError = UnauthorizedUserError;
+class UnknownRouteError extends BeamableRuntimeError {
+    constructor(route) {
+        super('UNKNOWN_ROUTE', `No callable registered for route "${route}".`);
+    }
+}
+exports.UnknownRouteError = UnknownRouteError;
+class SerializationError extends BeamableRuntimeError {
+    constructor(message, cause) {
+        super('SERIALIZATION_ERROR', message, cause);
+    }
+}
+exports.SerializationError = SerializationError;
+class InvalidConfigurationError extends BeamableRuntimeError {
+    constructor(message, cause) {
+        super('INVALID_CONFIGURATION', message, cause);
+    }
+}
+exports.InvalidConfigurationError = InvalidConfigurationError;

package/dist/errors.d.ts

@@ -0,0 +1,26 @@
+export declare class BeamableRuntimeError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string, cause?: unknown);
+}
+export declare class AuthenticationError extends BeamableRuntimeError {
+    constructor(message: string, cause?: unknown);
+}
+export declare class TimeoutError extends BeamableRuntimeError {
+    constructor(message: string, cause?: unknown);
+}
+export declare class MissingScopesError extends BeamableRuntimeError {
+    constructor(requiredScopes: Iterable<string>);
+}
+export declare class UnauthorizedUserError extends BeamableRuntimeError {
+    constructor(route: string);
+}
+export declare class UnknownRouteError extends BeamableRuntimeError {
+    constructor(route: string);
+}
+export declare class SerializationError extends BeamableRuntimeError {
+    constructor(message: string, cause?: unknown);
+}
+export declare class InvalidConfigurationError extends BeamableRuntimeError {
+    constructor(message: string, cause?: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAS3D;AAED,qBAAa,mBAAoB,SAAQ,oBAAoB;gBAC/C,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED,qBAAa,YAAa,SAAQ,oBAAoB;gBACxC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED,qBAAa,kBAAmB,SAAQ,oBAAoB;gBAC9C,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC;CAG7C;AAED,qBAAa,qBAAsB,SAAQ,oBAAoB;gBACjD,KAAK,EAAE,MAAM;CAG1B;AAED,qBAAa,iBAAkB,SAAQ,oBAAoB;gBAC7C,KAAK,EAAE,MAAM;CAG1B;AAED,qBAAa,kBAAmB,SAAQ,oBAAoB;gBAC9C,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C;AAED,qBAAa,yBAA0B,SAAQ,oBAAoB;gBACrD,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAG7C"}

package/dist/errors.js

@@ -0,0 +1,48 @@
+export class BeamableRuntimeError extends Error {
+    code;
+    constructor(code, message, cause) {
+        super(message);
+        this.code = code;
+        if (cause !== undefined) {
+            this.cause = cause;
+        }
+        this.name = this.constructor.name;
+        Error.captureStackTrace?.(this, this.constructor);
+    }
+}
+export class AuthenticationError extends BeamableRuntimeError {
+    constructor(message, cause) {
+        super('AUTHENTICATION_FAILED', message, cause);
+    }
+}
+export class TimeoutError extends BeamableRuntimeError {
+    constructor(message, cause) {
+        super('TIMEOUT', message, cause);
+    }
+}
+export class MissingScopesError extends BeamableRuntimeError {
+    constructor(requiredScopes) {
+        super('MISSING_SCOPES', `Missing required scopes: ${Array.from(requiredScopes).join(', ')}`);
+    }
+}
+export class UnauthorizedUserError extends BeamableRuntimeError {
+    constructor(route) {
+        super('UNAUTHORIZED_USER', `Route "${route}" requires an authenticated user.`);
+    }
+}
+export class UnknownRouteError extends BeamableRuntimeError {
+    constructor(route) {
+        super('UNKNOWN_ROUTE', `No callable registered for route "${route}".`);
+    }
+}
+export class SerializationError extends BeamableRuntimeError {
+    constructor(message, cause) {
+        super('SERIALIZATION_ERROR', message, cause);
+    }
+}
+export class InvalidConfigurationError extends BeamableRuntimeError {
+    constructor(message, cause) {
+        super('INVALID_CONFIGURATION', message, cause);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7B,IAAI,CAAS;IAE7B,YAAY,IAAY,EAAE,OAAe,EAAE,KAAe;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACvB,IAA4B,CAAC,KAAK,GAAG,KAAK,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,KAAK,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,oBAAoB;IAC3D,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,uBAAuB,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,oBAAoB;IACpD,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,oBAAoB;IAC1D,YAAY,cAAgC;QAC1C,KAAK,CAAC,gBAAgB,EAAE,4BAA4B,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/F,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,oBAAoB;IAC7D,YAAY,KAAa;QACvB,KAAK,CAAC,mBAAmB,EAAE,UAAU,KAAK,mCAAmC,CAAC,CAAC;IACjF,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,oBAAoB;IACzD,YAAY,KAAa;QACvB,KAAK,CAAC,eAAe,EAAE,qCAAqC,KAAK,IAAI,CAAC,CAAC;IACzE,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,oBAAoB;IAC1D,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,qBAAqB,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,oBAAoB;IACjE,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,uBAAuB,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;CACF","sourcesContent":["export class BeamableRuntimeError extends Error {\r\n  public readonly code: string;\r\n\r\n  constructor(code: string, message: string, cause?: unknown) {\r\n    super(message);\r\n    this.code = code;\r\n    if (cause !== undefined) {\r\n      (this as { cause?: unknown }).cause = cause;\r\n    }\r\n    this.name = this.constructor.name;\r\n    Error.captureStackTrace?.(this, this.constructor);\r\n  }\r\n}\r\n\r\nexport class AuthenticationError extends BeamableRuntimeError {\r\n  constructor(message: string, cause?: unknown) {\r\n    super('AUTHENTICATION_FAILED', message, cause);\r\n  }\r\n}\r\n\r\nexport class TimeoutError extends BeamableRuntimeError {\r\n  constructor(message: string, cause?: unknown) {\r\n    super('TIMEOUT', message, cause);\r\n  }\r\n}\r\n\r\nexport class MissingScopesError extends BeamableRuntimeError {\r\n  constructor(requiredScopes: Iterable<string>) {\r\n    super('MISSING_SCOPES', `Missing required scopes: ${Array.from(requiredScopes).join(', ')}`);\r\n  }\r\n}\r\n\r\nexport class UnauthorizedUserError extends BeamableRuntimeError {\r\n  constructor(route: string) {\r\n    super('UNAUTHORIZED_USER', `Route \"${route}\" requires an authenticated user.`);\r\n  }\r\n}\r\n\r\nexport class UnknownRouteError extends BeamableRuntimeError {\r\n  constructor(route: string) {\r\n    super('UNKNOWN_ROUTE', `No callable registered for route \"${route}\".`);\r\n  }\r\n}\r\n\r\nexport class SerializationError extends BeamableRuntimeError {\r\n  constructor(message: string, cause?: unknown) {\r\n    super('SERIALIZATION_ERROR', message, cause);\r\n  }\r\n}\r\n\r\nexport class InvalidConfigurationError extends BeamableRuntimeError {\r\n  constructor(message: string, cause?: unknown) {\r\n    super('INVALID_CONFIGURATION', message, cause);\r\n  }\r\n}\r\n"]}

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);
+}