@xemahq/service-registry-nest 0.3.2 → 0.4.0

package/dist/index.d.ts

@@ -13,4 +13,9 @@ export { KernelStateServiceRegistry } from './lib/service-registry-impl';
 export { EnvServiceTokenProvider, SERVICE_TOKEN_ENV_VAR, type ServiceTokenProvider, } from './lib/service-token-provider';
 export { ServiceUnavailableError } from './lib/service-unavailable.error';
 export { TypedServiceClient, TypedServiceClientMethod, type TypedServiceClientOptions, type ScopedRequestInit, } from './lib/typed-service-client';
+export { RegistryFederationBridge, FEDERATED_LABEL, FEDERATED_ORIGIN_REGION_LABEL, type RegistryFederationBridgeOptions, type FederationSyncResult, } from './lib/registry-federation-bridge';
+export { isMeshCgnatHost, isMeshUrl, selectMeshEndpoint, buildMeshHttpEndpoint, type MeshEndpointOptions, } from './lib/mesh-endpoint';
+export { resolveFederatedRealmTrust, parseFederatedRealmTrustFromEnv, type FederatedRealmTrust, type MultiRealmTrust, } from './lib/cross-realm-trust';
+export { parseFederationConfigFromEnv, DEFAULT_FEDERATION_SYNC_INTERVAL_MS, type FederationPeerConfig, type RegistryFederationConfig, } from './lib/registry-federation.config';
+export { RegistryFederationModule, RegistryFederationService, REGISTRY_FEDERATION_CONFIG, } from './lib/registry-federation.module';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,gCAAgC,EAChC,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,wBAAwB,EACxB,+BAA+B,EAC/B,wBAAwB,EACxB,KAAK,UAAU,GAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,aAAa,EACb,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,kBAAkB,EAClB,KAAK,kBAAkB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,KAAK,iCAAiC,EACtC,KAAK,4BAA4B,GAClC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,kCAAkC,EAClC,KAAK,mBAAmB,GACzB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACjG,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,gCAAgC,EAChC,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,wBAAwB,EACxB,+BAA+B,EAC/B,wBAAwB,EACxB,KAAK,UAAU,GAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,aAAa,EACb,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,kBAAkB,EAClB,KAAK,kBAAkB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,KAAK,iCAAiC,EACtC,KAAK,4BAA4B,GAClC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,kCAAkC,EAClC,KAAK,mBAAmB,GACzB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACjG,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,6BAA6B,EAC7B,KAAK,+BAA+B,EACpC,KAAK,oBAAoB,GAC1B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,KAAK,mBAAmB,EACxB,KAAK,eAAe,GACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,4BAA4B,EAC5B,mCAAmC,EACnC,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,GAC9B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,kCAAkC,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TypedServiceClientMethod = exports.TypedServiceClient = exports.ServiceUnavailableError = exports.SERVICE_TOKEN_ENV_VAR = exports.EnvServiceTokenProvider = exports.KernelStateServiceRegistry = exports.resolveHttpUrlEagerly = exports.resolveHttpUrl = exports.parseKernelStateProfile = exports.createOpenApiStubRegistry = exports.openApiExtractionStubUrl = exports.isOpenApiExtraction = exports.OPENAPI_EXTRACTION_ENV_VAR = exports.IdentityBackedServiceTokenProvider = exports.SERVICE_TOKEN_PROVIDER_TOKEN = exports.SERVICE_REGISTRY_TOKEN = exports.ServiceRegistryModule = exports.ServiceRegistryBootstrap = exports.KERNEL_STATE_TOKEN = exports.typedServiceClientToken = exports.InjectService = exports.resolveServiceInstanceId = exports.buildSelfHttpEndpointUrlFromEnv = exports.buildSelfHttpEndpointUrl = exports.resolveAdapterKind = exports.SERVICE_REGISTRY_ADAPTER_ENV_VAR = exports.ServiceRegistryAdapterKind = void 0;
+exports.REGISTRY_FEDERATION_CONFIG = exports.RegistryFederationService = exports.RegistryFederationModule = exports.DEFAULT_FEDERATION_SYNC_INTERVAL_MS = exports.parseFederationConfigFromEnv = exports.parseFederatedRealmTrustFromEnv = exports.resolveFederatedRealmTrust = exports.buildMeshHttpEndpoint = exports.selectMeshEndpoint = exports.isMeshUrl = exports.isMeshCgnatHost = exports.FEDERATED_ORIGIN_REGION_LABEL = exports.FEDERATED_LABEL = exports.RegistryFederationBridge = exports.TypedServiceClientMethod = exports.TypedServiceClient = exports.ServiceUnavailableError = exports.SERVICE_TOKEN_ENV_VAR = exports.EnvServiceTokenProvider = exports.KernelStateServiceRegistry = exports.resolveHttpUrlEagerly = exports.resolveHttpUrl = exports.parseKernelStateProfile = exports.createOpenApiStubRegistry = exports.openApiExtractionStubUrl = exports.isOpenApiExtraction = exports.OPENAPI_EXTRACTION_ENV_VAR = exports.IdentityBackedServiceTokenProvider = exports.SERVICE_TOKEN_PROVIDER_TOKEN = exports.SERVICE_REGISTRY_TOKEN = exports.ServiceRegistryModule = exports.ServiceRegistryBootstrap = exports.KERNEL_STATE_TOKEN = exports.typedServiceClientToken = exports.InjectService = exports.resolveServiceInstanceId = exports.buildSelfHttpEndpointUrlFromEnv = exports.buildSelfHttpEndpointUrl = exports.resolveAdapterKind = exports.SERVICE_REGISTRY_ADAPTER_ENV_VAR = exports.ServiceRegistryAdapterKind = void 0;
 var adapter_kind_1 = require("./lib/adapter-kind");
 Object.defineProperty(exports, "ServiceRegistryAdapterKind", { enumerable: true, get: function () { return adapter_kind_1.ServiceRegistryAdapterKind; } });
 Object.defineProperty(exports, "SERVICE_REGISTRY_ADAPTER_ENV_VAR", { enumerable: true, get: function () { return adapter_kind_1.SERVICE_REGISTRY_ADAPTER_ENV_VAR; } });
@@ -43,4 +43,23 @@ Object.defineProperty(exports, "ServiceUnavailableError", { enumerable: true, ge
 var typed_service_client_1 = require("./lib/typed-service-client");
 Object.defineProperty(exports, "TypedServiceClient", { enumerable: true, get: function () { return typed_service_client_1.TypedServiceClient; } });
 Object.defineProperty(exports, "TypedServiceClientMethod", { enumerable: true, get: function () { return typed_service_client_1.TypedServiceClientMethod; } });
+var registry_federation_bridge_1 = require("./lib/registry-federation-bridge");
+Object.defineProperty(exports, "RegistryFederationBridge", { enumerable: true, get: function () { return registry_federation_bridge_1.RegistryFederationBridge; } });
+Object.defineProperty(exports, "FEDERATED_LABEL", { enumerable: true, get: function () { return registry_federation_bridge_1.FEDERATED_LABEL; } });
+Object.defineProperty(exports, "FEDERATED_ORIGIN_REGION_LABEL", { enumerable: true, get: function () { return registry_federation_bridge_1.FEDERATED_ORIGIN_REGION_LABEL; } });
+var mesh_endpoint_1 = require("./lib/mesh-endpoint");
+Object.defineProperty(exports, "isMeshCgnatHost", { enumerable: true, get: function () { return mesh_endpoint_1.isMeshCgnatHost; } });
+Object.defineProperty(exports, "isMeshUrl", { enumerable: true, get: function () { return mesh_endpoint_1.isMeshUrl; } });
+Object.defineProperty(exports, "selectMeshEndpoint", { enumerable: true, get: function () { return mesh_endpoint_1.selectMeshEndpoint; } });
+Object.defineProperty(exports, "buildMeshHttpEndpoint", { enumerable: true, get: function () { return mesh_endpoint_1.buildMeshHttpEndpoint; } });
+var cross_realm_trust_1 = require("./lib/cross-realm-trust");
+Object.defineProperty(exports, "resolveFederatedRealmTrust", { enumerable: true, get: function () { return cross_realm_trust_1.resolveFederatedRealmTrust; } });
+Object.defineProperty(exports, "parseFederatedRealmTrustFromEnv", { enumerable: true, get: function () { return cross_realm_trust_1.parseFederatedRealmTrustFromEnv; } });
+var registry_federation_config_1 = require("./lib/registry-federation.config");
+Object.defineProperty(exports, "parseFederationConfigFromEnv", { enumerable: true, get: function () { return registry_federation_config_1.parseFederationConfigFromEnv; } });
+Object.defineProperty(exports, "DEFAULT_FEDERATION_SYNC_INTERVAL_MS", { enumerable: true, get: function () { return registry_federation_config_1.DEFAULT_FEDERATION_SYNC_INTERVAL_MS; } });
+var registry_federation_module_1 = require("./lib/registry-federation.module");
+Object.defineProperty(exports, "RegistryFederationModule", { enumerable: true, get: function () { return registry_federation_module_1.RegistryFederationModule; } });
+Object.defineProperty(exports, "RegistryFederationService", { enumerable: true, get: function () { return registry_federation_module_1.RegistryFederationService; } });
+Object.defineProperty(exports, "REGISTRY_FEDERATION_CONFIG", { enumerable: true, get: function () { return registry_federation_module_1.REGISTRY_FEDERATION_CONFIG; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mDAI4B;AAH1B,0HAAA,0BAA0B,OAAA;AAC1B,gIAAA,gCAAgC,OAAA;AAChC,kHAAA,kBAAkB,OAAA;AAEpB,yEAKuC;AAJrC,mIAAA,wBAAwB,OAAA;AACxB,0IAAA,+BAA+B,OAAA;AAC/B,mIAAA,wBAAwB,OAAA;AAG1B,2EAGwC;AAFtC,yHAAA,aAAa,OAAA;AACb,mIAAA,uBAAuB,OAAA;AAEzB,+DAGkC;AAFhC,wHAAA,kBAAkB,OAAA;AAGpB,yEAOuC;AANrC,mIAAA,wBAAwB,OAAA;AACxB,gIAAA,qBAAqB,OAAA;AACrB,iIAAA,sBAAsB,OAAA;AACtB,uIAAA,4BAA4B,OAAA;AAI9B,uGAGsD;AAFpD,4JAAA,kCAAkC,OAAA;AAGpC,+DAIkC;AAHhC,gIAAA,0BAA0B,OAAA;AAC1B,yHAAA,mBAAmB,OAAA;AACnB,8HAAA,wBAAwB,OAAA;AAE1B,qEAAwE;AAA/D,kIAAA,yBAAyB,OAAA;AAClC,+EAA2E;AAAlE,qIAAA,uBAAuB,OAAA;AAChC,2DAAwD;AAA/C,kHAAA,cAAc,OAAA;AACvB,2EAAiG;AAAxF,iIAAA,qBAAqB,OAAA;AAC9B,qEAAyE;AAAhE,mIAAA,0BAA0B,OAAA;AACnC,uEAIsC;AAHpC,iIAAA,uBAAuB,OAAA;AACvB,+HAAA,qBAAqB,OAAA;AAGvB,6EAA0E;AAAjE,oIAAA,uBAAuB,OAAA;AAChC,mEAKoC;AAJlC,0HAAA,kBAAkB,OAAA;AAClB,gIAAA,wBAAwB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mDAI4B;AAH1B,0HAAA,0BAA0B,OAAA;AAC1B,gIAAA,gCAAgC,OAAA;AAChC,kHAAA,kBAAkB,OAAA;AAEpB,yEAKuC;AAJrC,mIAAA,wBAAwB,OAAA;AACxB,0IAAA,+BAA+B,OAAA;AAC/B,mIAAA,wBAAwB,OAAA;AAG1B,2EAGwC;AAFtC,yHAAA,aAAa,OAAA;AACb,mIAAA,uBAAuB,OAAA;AAEzB,+DAGkC;AAFhC,wHAAA,kBAAkB,OAAA;AAGpB,yEAOuC;AANrC,mIAAA,wBAAwB,OAAA;AACxB,gIAAA,qBAAqB,OAAA;AACrB,iIAAA,sBAAsB,OAAA;AACtB,uIAAA,4BAA4B,OAAA;AAI9B,uGAGsD;AAFpD,4JAAA,kCAAkC,OAAA;AAGpC,+DAIkC;AAHhC,gIAAA,0BAA0B,OAAA;AAC1B,yHAAA,mBAAmB,OAAA;AACnB,8HAAA,wBAAwB,OAAA;AAE1B,qEAAwE;AAA/D,kIAAA,yBAAyB,OAAA;AAClC,+EAA2E;AAAlE,qIAAA,uBAAuB,OAAA;AAChC,2DAAwD;AAA/C,kHAAA,cAAc,OAAA;AACvB,2EAAiG;AAAxF,iIAAA,qBAAqB,OAAA;AAC9B,qEAAyE;AAAhE,mIAAA,0BAA0B,OAAA;AACnC,uEAIsC;AAHpC,iIAAA,uBAAuB,OAAA;AACvB,+HAAA,qBAAqB,OAAA;AAGvB,6EAA0E;AAAjE,oIAAA,uBAAuB,OAAA;AAChC,mEAKoC;AAJlC,0HAAA,kBAAkB,OAAA;AAClB,gIAAA,wBAAwB,OAAA;AAI1B,+EAM0C;AALxC,sIAAA,wBAAwB,OAAA;AACxB,6HAAA,eAAe,OAAA;AACf,2IAAA,6BAA6B,OAAA;AAI/B,qDAM6B;AAL3B,gHAAA,eAAe,OAAA;AACf,0GAAA,SAAS,OAAA;AACT,mHAAA,kBAAkB,OAAA;AAClB,sHAAA,qBAAqB,OAAA;AAGvB,6DAKiC;AAJ/B,+HAAA,0BAA0B,OAAA;AAC1B,oIAAA,+BAA+B,OAAA;AAIjC,+EAK0C;AAJxC,0IAAA,4BAA4B,OAAA;AAC5B,iJAAA,mCAAmC,OAAA;AAIrC,+EAI0C;AAHxC,sIAAA,wBAAwB,OAAA;AACxB,uIAAA,yBAAyB,OAAA;AACzB,wIAAA,0BAA0B,OAAA"}

package/dist/lib/cross-realm-trust.d.ts

@@ -0,0 +1,15 @@
+export interface FederatedRealmTrust {
+    readonly discoveryBaseUrl: string;
+    readonly realms: readonly string[];
+}
+export interface MultiRealmTrust {
+    readonly discoveryBaseUrls: string[];
+    readonly allowedRealms: string[];
+}
+export declare function resolveFederatedRealmTrust(input: {
+    localDiscoveryBaseUrl: string;
+    localRealms: readonly string[];
+    peers: readonly FederatedRealmTrust[];
+}): MultiRealmTrust;
+export declare function parseFederatedRealmTrustFromEnv(env?: NodeJS.ProcessEnv): MultiRealmTrust | undefined;
+//# sourceMappingURL=cross-realm-trust.d.ts.map

package/dist/lib/cross-realm-trust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-realm-trust.d.ts","sourceRoot":"","sources":["../../src/lib/cross-realm-trust.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,mBAAmB;IAKlC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAGD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;CAClC;AAWD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACvC,GAAG,eAAe,CA8BlB;AASD,wBAAgB,+BAA+B,CAC7C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,eAAe,GAAG,SAAS,CA8B7B"}

package/dist/lib/cross-realm-trust.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveFederatedRealmTrust = resolveFederatedRealmTrust;
+exports.parseFederatedRealmTrustFromEnv = parseFederatedRealmTrustFromEnv;
+function resolveFederatedRealmTrust(input) {
+    if (input.localDiscoveryBaseUrl.trim() === '') {
+        throw new Error('[cross-realm-trust] localDiscoveryBaseUrl must be a non-empty string.');
+    }
+    const baseUrls = [normalizeBaseUrl(input.localDiscoveryBaseUrl)];
+    const realms = [...input.localRealms];
+    for (const peer of input.peers) {
+        if (peer.discoveryBaseUrl.trim() === '') {
+            throw new Error('[cross-realm-trust] a federated peer has an empty discoveryBaseUrl.');
+        }
+        if (peer.realms.length === 0) {
+            throw new Error(`[cross-realm-trust] federated peer "${peer.discoveryBaseUrl}" declares no realms — ` +
+                'an empty realm list would trust nothing; omit the peer instead.');
+        }
+        baseUrls.push(normalizeBaseUrl(peer.discoveryBaseUrl));
+        realms.push(...peer.realms);
+    }
+    return {
+        discoveryBaseUrls: dedupe(baseUrls),
+        allowedRealms: dedupe(realms),
+    };
+}
+function parseFederatedRealmTrustFromEnv(env = process.env) {
+    const raw = env['XEMA_FEDERATION_REALM_TRUST']?.trim();
+    if (raw === undefined || raw === '') {
+        return undefined;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (cause) {
+        throw new Error('[cross-realm-trust] XEMA_FEDERATION_REALM_TRUST is not valid JSON.', { cause: cause });
+    }
+    if (typeof parsed !== 'object' || parsed === null) {
+        throw new Error('[cross-realm-trust] XEMA_FEDERATION_REALM_TRUST must be a JSON object { discoveryBaseUrls, allowedRealms }.');
+    }
+    const obj = parsed;
+    return {
+        discoveryBaseUrls: requireStringArray(obj['discoveryBaseUrls'], 'XEMA_FEDERATION_REALM_TRUST.discoveryBaseUrls').map(normalizeBaseUrl),
+        allowedRealms: requireStringArray(obj['allowedRealms'], 'XEMA_FEDERATION_REALM_TRUST.allowedRealms'),
+    };
+}
+function requireStringArray(value, at) {
+    if (!Array.isArray(value) ||
+        value.length === 0 ||
+        value.some((v) => typeof v !== 'string' || v.trim() === '')) {
+        throw new Error(`[cross-realm-trust] ${at} must be a non-empty array of non-empty strings.`);
+    }
+    return value;
+}
+function normalizeBaseUrl(url) {
+    return url.replace(/\/+$/, '');
+}
+function dedupe(values) {
+    const seen = new Set();
+    const out = [];
+    for (const v of values) {
+        if (!seen.has(v)) {
+            seen.add(v);
+            out.push(v);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=cross-realm-trust.js.map

package/dist/lib/cross-realm-trust.js.map

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

package/dist/lib/mesh-endpoint.d.ts

@@ -0,0 +1,13 @@
+import { ServiceEndpointAuth, type ServiceEndpoint } from '@xemahq/kernel-contracts/service-registry';
+export interface MeshEndpointOptions {
+    readonly magicDnsSuffix?: string;
+}
+export declare function isMeshCgnatHost(host: string): boolean;
+export declare function isMeshUrl(url: string, options?: MeshEndpointOptions): boolean;
+export declare function selectMeshEndpoint(endpoints: readonly ServiceEndpoint[], options?: MeshEndpointOptions): ServiceEndpoint | undefined;
+export declare function buildMeshHttpEndpoint(input: {
+    meshHostOrIp: string;
+    port: number;
+    auth?: ServiceEndpointAuth;
+}): ServiceEndpoint;
+//# sourceMappingURL=mesh-endpoint.d.ts.map

package/dist/lib/mesh-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-endpoint.d.ts","sourceRoot":"","sources":["../../src/lib/mesh-endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EAEnB,KAAK,eAAe,EACrB,MAAM,2CAA2C,CAAC;AAwBnD,MAAM,WAAW,mBAAmB;IAKlC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAsBD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGrD;AAGD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAejF;AAOD,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,eAAe,EAAE,EACrC,OAAO,GAAE,mBAAwB,GAChC,eAAe,GAAG,SAAS,CAK7B;AAOD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC5B,GAAG,eAAe,CAMlB"}

package/dist/lib/mesh-endpoint.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMeshCgnatHost = isMeshCgnatHost;
+exports.isMeshUrl = isMeshUrl;
+exports.selectMeshEndpoint = selectMeshEndpoint;
+exports.buildMeshHttpEndpoint = buildMeshHttpEndpoint;
+const service_registry_1 = require("@xemahq/kernel-contracts/service-registry");
+const CGNAT_FIRST = 1_681_915_904;
+const CGNAT_LAST = 1_686_110_207;
+function ipv4ToInt(ip) {
+    const parts = ip.split('.');
+    if (parts.length !== 4) {
+        return null;
+    }
+    let acc = 0;
+    for (const part of parts) {
+        if (!/^\d{1,3}$/.test(part)) {
+            return null;
+        }
+        const n = Number(part);
+        if (n > 255) {
+            return null;
+        }
+        acc = acc * 256 + n;
+    }
+    return acc >>> 0;
+}
+function isMeshCgnatHost(host) {
+    const n = ipv4ToInt(host);
+    return n !== null && n >= CGNAT_FIRST && n <= CGNAT_LAST;
+}
+function isMeshUrl(url, options = {}) {
+    let host;
+    try {
+        host = new URL(url).hostname;
+    }
+    catch {
+        return false;
+    }
+    if (options.magicDnsSuffix !== undefined &&
+        options.magicDnsSuffix !== '' &&
+        host.endsWith(options.magicDnsSuffix)) {
+        return true;
+    }
+    return isMeshCgnatHost(host);
+}
+function selectMeshEndpoint(endpoints, options = {}) {
+    return endpoints.find((e) => e.protocol === service_registry_1.ServiceEndpointProtocol.Http && isMeshUrl(e.url, options));
+}
+function buildMeshHttpEndpoint(input) {
+    return {
+        protocol: service_registry_1.ServiceEndpointProtocol.Http,
+        url: `http://${input.meshHostOrIp}:${input.port}`,
+        auth: input.auth ?? service_registry_1.ServiceEndpointAuth.ServiceToken,
+    };
+}
+//# sourceMappingURL=mesh-endpoint.js.map

package/dist/lib/mesh-endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-endpoint.js","sourceRoot":"","sources":["../../src/lib/mesh-endpoint.ts"],"names":[],"mappings":";;AAwDA,0CAGC;AAGD,8BAeC;AAOD,gDAQC;AAOD,sDAUC;AA7GD,gFAImD;AAqBnD,MAAM,WAAW,GAAG,aAAa,CAAC;AAClC,MAAM,UAAU,GAAG,aAAa,CAAC;AAUjC,SAAS,SAAS,CAAC,EAAU;IAC3B,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QACD,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,CAAC;AACnB,CAAC;AAGD,SAAgB,eAAe,CAAC,IAAY;IAC1C,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,WAAW,IAAI,CAAC,IAAI,UAAU,CAAC;AAC3D,CAAC;AAGD,SAAgB,SAAS,CAAC,GAAW,EAAE,UAA+B,EAAE;IACtE,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IACE,OAAO,CAAC,cAAc,KAAK,SAAS;QACpC,OAAO,CAAC,cAAc,KAAK,EAAE;QAC7B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,EACrC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAOD,SAAgB,kBAAkB,CAChC,SAAqC,EACrC,UAA+B,EAAE;IAEjC,OAAO,SAAS,CAAC,IAAI,CACnB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,QAAQ,KAAK,0CAAuB,CAAC,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,CAC3E,CAAC;AACJ,CAAC;AAOD,SAAgB,qBAAqB,CAAC,KAIrC;IACC,OAAO;QACL,QAAQ,EAAE,0CAAuB,CAAC,IAAI;QACtC,GAAG,EAAE,UAAU,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,IAAI,EAAE;QACjD,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,sCAAmB,CAAC,YAAY;KACrD,CAAC;AACJ,CAAC"}

package/dist/lib/registry-federation-bridge.d.ts

@@ -0,0 +1,26 @@
+import { type ServiceEndpoint, type ServiceRegistry } from '@xemahq/kernel-contracts/service-registry';
+export interface RegistryFederationBridgeOptions {
+    readonly region: string;
+    readonly allowServiceNames: readonly string[];
+    readonly selectReachableEndpoint?: (endpoints: readonly ServiceEndpoint[]) => ServiceEndpoint | undefined;
+}
+export declare const FEDERATED_LABEL = "xema.federated";
+export declare const FEDERATED_ORIGIN_REGION_LABEL = "xema.origin-region";
+export interface FederationSyncResult {
+    readonly registered: number;
+    readonly renewed: number;
+    readonly pruned: number;
+}
+export declare class RegistryFederationBridge {
+    private readonly local;
+    private readonly peer;
+    private readonly options;
+    private readonly mirroredLeases;
+    private readonly allow;
+    private readonly selectEndpoint;
+    constructor(local: ServiceRegistry, peer: ServiceRegistry, options: RegistryFederationBridgeOptions);
+    syncOnce(): Promise<FederationSyncResult>;
+    get mirroredCount(): number;
+    private toMirrorDescriptor;
+}
+//# sourceMappingURL=registry-federation-bridge.d.ts.map

package/dist/lib/registry-federation-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-federation-bridge.d.ts","sourceRoot":"","sources":["../../src/lib/registry-federation-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,eAAe,EACrB,MAAM,2CAA2C,CAAC;AAwBnD,MAAM,WAAW,+BAA+B;IAE9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAKxB,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAM9C,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CACjC,SAAS,EAAE,SAAS,eAAe,EAAE,KAClC,eAAe,GAAG,SAAS,CAAC;CAClC;AAGD,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAEhD,eAAO,MAAM,6BAA6B,uBAAuB,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAQD,qBAAa,wBAAwB;IAUjC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAV1B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAE5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAEE;gBAGd,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,+BAA+B;IAarD,QAAQ,IAAI,OAAO,CAAC,oBAAoB,CAAC;IA6C/C,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,OAAO,CAAC,kBAAkB;CAwB3B"}

package/dist/lib/registry-federation-bridge.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RegistryFederationBridge = exports.FEDERATED_ORIGIN_REGION_LABEL = exports.FEDERATED_LABEL = void 0;
+const service_registry_1 = require("@xemahq/kernel-contracts/service-registry");
+exports.FEDERATED_LABEL = 'xema.federated';
+exports.FEDERATED_ORIGIN_REGION_LABEL = 'xema.origin-region';
+function defaultEndpointSelector(endpoints) {
+    return endpoints.find((e) => e.protocol === service_registry_1.ServiceEndpointProtocol.Http);
+}
+class RegistryFederationBridge {
+    local;
+    peer;
+    options;
+    mirroredLeases = new Map();
+    allow;
+    selectEndpoint;
+    constructor(local, peer, options) {
+        this.local = local;
+        this.peer = peer;
+        this.options = options;
+        this.allow = new Set(options.allowServiceNames);
+        this.selectEndpoint =
+            options.selectReachableEndpoint ?? defaultEndpointSelector;
+    }
+    async syncOnce() {
+        const peerServices = await this.peer.list();
+        const wanted = peerServices.filter((s) => this.allow.has(s.name));
+        const seen = new Set();
+        let registered = 0;
+        let renewed = 0;
+        for (const svc of wanted) {
+            const key = `${svc.name}:${svc.instanceId}`;
+            seen.add(key);
+            const existingLease = this.mirroredLeases.get(key);
+            if (existingLease !== undefined) {
+                try {
+                    const lease = await this.local.renew(existingLease);
+                    this.mirroredLeases.set(key, lease.leaseId);
+                    renewed += 1;
+                    continue;
+                }
+                catch {
+                    this.mirroredLeases.delete(key);
+                }
+            }
+            const lease = await this.local.register(this.toMirrorDescriptor(svc));
+            this.mirroredLeases.set(key, lease.leaseId);
+            registered += 1;
+        }
+        let pruned = 0;
+        for (const key of [...this.mirroredLeases.keys()]) {
+            if (!seen.has(key)) {
+                this.mirroredLeases.delete(key);
+                pruned += 1;
+            }
+        }
+        return { registered, renewed, pruned };
+    }
+    get mirroredCount() {
+        return this.mirroredLeases.size;
+    }
+    toMirrorDescriptor(svc) {
+        const endpoint = this.selectEndpoint(svc.endpoints);
+        if (endpoint === undefined) {
+            throw new Error(`[registry-federation] peer service "${svc.name}" (instance ${svc.instanceId}) ` +
+                `is whitelisted but advertises no selectable endpoint — cannot mirror it. ` +
+                `A federated service MUST expose a reachable (mesh) endpoint.`);
+        }
+        return {
+            name: svc.name,
+            semver: svc.semver,
+            instanceId: svc.instanceId,
+            endpoints: [endpoint],
+            exposesCapabilities: [...svc.descriptor.exposesCapabilities],
+            requiresServices: [...svc.descriptor.requiresServices],
+            region: this.options.region,
+            labels: {
+                ...svc.descriptor.labels,
+                [exports.FEDERATED_LABEL]: 'true',
+                [exports.FEDERATED_ORIGIN_REGION_LABEL]: this.options.region,
+            },
+        };
+    }
+}
+exports.RegistryFederationBridge = RegistryFederationBridge;
+//# sourceMappingURL=registry-federation-bridge.js.map

package/dist/lib/registry-federation-bridge.js.map

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

package/dist/lib/registry-federation.config.d.ts

@@ -0,0 +1,13 @@
+export interface FederationPeerConfig {
+    readonly region: string;
+    readonly etcdEndpoints: readonly string[];
+    readonly allowServiceNames: readonly string[];
+    readonly magicDnsSuffix?: string;
+}
+export interface RegistryFederationConfig {
+    readonly peers: readonly FederationPeerConfig[];
+    readonly syncIntervalMs: number;
+}
+export declare const DEFAULT_FEDERATION_SYNC_INTERVAL_MS = 10000;
+export declare function parseFederationConfigFromEnv(env?: NodeJS.ProcessEnv): RegistryFederationConfig;
+//# sourceMappingURL=registry-federation.config.d.ts.map

package/dist/lib/registry-federation.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-federation.config.d.ts","sourceRoot":"","sources":["../../src/lib/registry-federation.config.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,oBAAoB;IAEnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAE1C,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAE9C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAKhD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAGD,eAAO,MAAM,mCAAmC,QAAS,CAAC;AAY1D,wBAAgB,4BAA4B,CAC1C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,wBAAwB,CAiB1B"}

package/dist/lib/registry-federation.config.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_FEDERATION_SYNC_INTERVAL_MS = void 0;
+exports.parseFederationConfigFromEnv = parseFederationConfigFromEnv;
+exports.DEFAULT_FEDERATION_SYNC_INTERVAL_MS = 10_000;
+const PEERS_ENV = 'XEMA_FEDERATION_PEERS';
+const INTERVAL_ENV = 'XEMA_FEDERATION_SYNC_INTERVAL_MS';
+function parseFederationConfigFromEnv(env = process.env) {
+    const raw = env[PEERS_ENV]?.trim();
+    const peers = raw === undefined || raw === '' ? [] : parsePeers(raw);
+    const intervalRaw = env[INTERVAL_ENV]?.trim();
+    let syncIntervalMs = exports.DEFAULT_FEDERATION_SYNC_INTERVAL_MS;
+    if (intervalRaw !== undefined && intervalRaw !== '') {
+        const n = Number(intervalRaw);
+        if (!Number.isInteger(n) || n <= 0) {
+            throw new Error(`[registry-federation] ${INTERVAL_ENV} must be a positive integer (ms); got "${intervalRaw}".`);
+        }
+        syncIntervalMs = n;
+    }
+    return { peers, syncIntervalMs };
+}
+function parsePeers(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (cause) {
+        throw new Error(`[registry-federation] ${PEERS_ENV} is not valid JSON.`, { cause: cause });
+    }
+    if (!Array.isArray(parsed)) {
+        throw new Error(`[registry-federation] ${PEERS_ENV} must be a JSON array of peer configs.`);
+    }
+    return parsed.map((p, i) => validatePeer(p, i));
+}
+function validatePeer(value, index) {
+    const at = `${PEERS_ENV}[${index}]`;
+    if (typeof value !== 'object' || value === null) {
+        throw new Error(`[registry-federation] ${at} is not an object.`);
+    }
+    const p = value;
+    const region = requireNonEmptyString(p['region'], `${at}.region`);
+    const etcdEndpoints = requireNonEmptyStringArray(p['etcdEndpoints'], `${at}.etcdEndpoints`);
+    const allowServiceNames = requireNonEmptyStringArray(p['allowServiceNames'], `${at}.allowServiceNames`);
+    const magicDnsSuffix = p['magicDnsSuffix'];
+    if (magicDnsSuffix !== undefined && typeof magicDnsSuffix !== 'string') {
+        throw new Error(`[registry-federation] ${at}.magicDnsSuffix must be a string.`);
+    }
+    return {
+        region,
+        etcdEndpoints,
+        allowServiceNames,
+        ...(magicDnsSuffix !== undefined ? { magicDnsSuffix } : {}),
+    };
+}
+function requireNonEmptyString(value, at) {
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new Error(`[registry-federation] ${at} must be a non-empty string.`);
+    }
+    return value;
+}
+function requireNonEmptyStringArray(value, at) {
+    if (!Array.isArray(value) ||
+        value.length === 0 ||
+        value.some((v) => typeof v !== 'string' || v.trim() === '')) {
+        throw new Error(`[registry-federation] ${at} must be a non-empty array of non-empty strings.`);
+    }
+    return value;
+}
+//# sourceMappingURL=registry-federation.config.js.map

package/dist/lib/registry-federation.config.js.map

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

package/dist/lib/registry-federation.module.d.ts

@@ -0,0 +1,20 @@
+import { type DynamicModule, type OnApplicationBootstrap, type OnModuleDestroy } from '@nestjs/common';
+import type { ServiceRegistry } from '@xemahq/kernel-contracts/service-registry';
+import { type RegistryFederationConfig } from './registry-federation.config';
+export declare const REGISTRY_FEDERATION_CONFIG: unique symbol;
+export declare class RegistryFederationService implements OnApplicationBootstrap, OnModuleDestroy {
+    private readonly local;
+    private readonly config;
+    private readonly logger;
+    private readonly bridges;
+    private readonly peerRegistries;
+    private timer;
+    constructor(local: ServiceRegistry, config: RegistryFederationConfig);
+    onApplicationBootstrap(): Promise<void>;
+    reconcileOnce(): Promise<void>;
+    onModuleDestroy(): void;
+}
+export declare class RegistryFederationModule {
+    static forRoot(config?: RegistryFederationConfig): DynamicModule;
+}
+//# sourceMappingURL=registry-federation.module.d.ts.map

package/dist/lib/registry-federation.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-federation.module.d.ts","sourceRoot":"","sources":["../../src/lib/registry-federation.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAOjF,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,8BAA8B,CAAC;AAMtC,eAAO,MAAM,0BAA0B,eAEtC,CAAC;AAcF,qBACa,yBACX,YAAW,sBAAsB,EAAE,eAAe;IAShD,OAAO,CAAC,QAAQ,CAAC,KAAK;IAEtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IATzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;IACrE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoC;IACnE,OAAO,CAAC,KAAK,CAA6C;gBAIvC,KAAK,EAAE,eAAe,EAEtB,MAAM,EAAE,wBAAwB;IAG7C,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IA8CvC,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBpC,eAAe,IAAI,IAAI;CASxB;AAQD,qBACa,wBAAwB;IACnC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,wBAAwB,GAAG,aAAa;CAajE"}

package/dist/lib/registry-federation.module.js

@@ -0,0 +1,111 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var RegistryFederationService_1, RegistryFederationModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RegistryFederationModule = exports.RegistryFederationService = exports.REGISTRY_FEDERATION_CONFIG = void 0;
+const common_1 = require("@nestjs/common");
+const kernel_state_runtime_1 = require("@xemahq/kernel-state-runtime");
+const mesh_endpoint_1 = require("./mesh-endpoint");
+const registry_federation_config_1 = require("./registry-federation.config");
+const registry_federation_bridge_1 = require("./registry-federation-bridge");
+const service_registry_impl_1 = require("./service-registry-impl");
+const service_registry_module_1 = require("./service-registry.module");
+exports.REGISTRY_FEDERATION_CONFIG = Symbol.for('@xemahq/service-registry-nest/registry-federation-config');
+let RegistryFederationService = RegistryFederationService_1 = class RegistryFederationService {
+    local;
+    config;
+    logger = new common_1.Logger(RegistryFederationService_1.name);
+    bridges = [];
+    peerRegistries = [];
+    timer;
+    constructor(local, config) {
+        this.local = local;
+        this.config = config;
+    }
+    async onApplicationBootstrap() {
+        for (const peer of this.config.peers) {
+            const kernelState = (0, kernel_state_runtime_1.createKernelState)({
+                profile: kernel_state_runtime_1.KernelStateProfile.Cluster,
+                etcd: { endpoints: [...peer.etcdEndpoints] },
+            });
+            const peerRegistry = new service_registry_impl_1.KernelStateServiceRegistry(kernelState);
+            await peerRegistry.onModuleInit();
+            this.peerRegistries.push(peerRegistry);
+            this.bridges.push(new registry_federation_bridge_1.RegistryFederationBridge(this.local, peerRegistry, {
+                region: peer.region,
+                allowServiceNames: peer.allowServiceNames,
+                selectReachableEndpoint: (eps) => (0, mesh_endpoint_1.selectMeshEndpoint)(eps, peer.magicDnsSuffix !== undefined
+                    ? { magicDnsSuffix: peer.magicDnsSuffix }
+                    : {}),
+            }));
+        }
+        if (this.bridges.length === 0) {
+            this.logger.log('Registry federation: no peers configured — disabled.');
+            return;
+        }
+        this.logger.log(`Registry federation: ${this.bridges.length} peer(s), reconciling every ${this.config.syncIntervalMs}ms.`);
+        await this.reconcileOnce();
+        this.timer = setInterval(() => {
+            void this.reconcileOnce();
+        }, this.config.syncIntervalMs);
+        this.timer.unref?.();
+    }
+    async reconcileOnce() {
+        for (const bridge of this.bridges) {
+            try {
+                const result = await bridge.syncOnce();
+                this.logger.debug(`Federation sync: registered=${result.registered} renewed=${result.renewed} pruned=${result.pruned}`);
+            }
+            catch (error) {
+                this.logger.error(`Federation sync failed for a peer (will retry next interval): ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+    }
+    onModuleDestroy() {
+        if (this.timer !== undefined) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+        for (const reg of this.peerRegistries) {
+            reg.onModuleDestroy();
+        }
+    }
+};
+exports.RegistryFederationService = RegistryFederationService;
+exports.RegistryFederationService = RegistryFederationService = RegistryFederationService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(service_registry_module_1.SERVICE_REGISTRY_TOKEN)),
+    __param(1, (0, common_1.Inject)(exports.REGISTRY_FEDERATION_CONFIG)),
+    __metadata("design:paramtypes", [Object, Object])
+], RegistryFederationService);
+let RegistryFederationModule = RegistryFederationModule_1 = class RegistryFederationModule {
+    static forRoot(config) {
+        return {
+            module: RegistryFederationModule_1,
+            providers: [
+                {
+                    provide: exports.REGISTRY_FEDERATION_CONFIG,
+                    useValue: config ?? (0, registry_federation_config_1.parseFederationConfigFromEnv)(),
+                },
+                RegistryFederationService,
+            ],
+            exports: [RegistryFederationService],
+        };
+    }
+};
+exports.RegistryFederationModule = RegistryFederationModule;
+exports.RegistryFederationModule = RegistryFederationModule = RegistryFederationModule_1 = __decorate([
+    (0, common_1.Module)({})
+], RegistryFederationModule);
+//# sourceMappingURL=registry-federation.module.js.map

package/dist/lib/registry-federation.module.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/service-registry-nest",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "NestJS runtime SDK for the Xema OS Service Registry. Provides `ServiceRegistryModule.forRootAsync()` — registers the host service's `ServiceDescriptor` against KernelState at boot, renews the lease on a heartbeat, removes the entry on shutdown, and exposes the `@InjectService(name)` decorator that hands consumers a typed HTTP client whose base URL is resolved dynamically from the registry on every call. The SDK is adapter-agnostic; the `KernelState` instance is injected via a factory so the same code runs against a SQLite-backed dev adapter and an etcd-backed cluster adapter.",
   "license": "Apache-2.0",
   "author": "Neuralchowder Inc. <developer@xema.dev> (https://xema.dev)",
@@ -30,7 +30,7 @@
     "reflect-metadata": "0.2.2",
     "ts-jest": "^29.4.9",
     "typescript": "5.9.3",
-    "@xemahq/kernel-contracts": "^0.39.0"
+    "@xemahq/kernel-contracts": "^0.48.0"
   },
   "peerDependencies": {
     "@nestjs/common": "^10 || ^11",