@cadenza.io/service 2.17.5 → 2.17.7

package/dist/index.d.mts

@@ -320,6 +320,8 @@ declare class ServiceRegistry {
     private markTransportClientCreated;
     private registerDependee;
     private unregisterDependee;
+    private reconcileBootstrapPlaceholderInstance;
+    private adoptBootstrapPlaceholderInstanceId;
     private getHeartbeatMisses;
     private shouldRequireReadinessFromCommunicationTypes;
     private resolveRuntimeStatusSnapshot;
@@ -23166,6 +23168,7 @@ interface ServiceInstanceDescriptor {
     health: AnyObject;
     isFrontend: boolean;
     isDatabase?: boolean;
+    isBootstrapPlaceholder?: boolean;
     transports: ServiceTransportDescriptor[];
     clientCreatedTransportIds?: string[];
 }

package/dist/index.d.ts

@@ -320,6 +320,8 @@ declare class ServiceRegistry {
     private markTransportClientCreated;
     private registerDependee;
     private unregisterDependee;
+    private reconcileBootstrapPlaceholderInstance;
+    private adoptBootstrapPlaceholderInstanceId;
     private getHeartbeatMisses;
     private shouldRequireReadinessFromCommunicationTypes;
     private resolveRuntimeStatusSnapshot;
@@ -23166,6 +23168,7 @@ interface ServiceInstanceDescriptor {
     health: AnyObject;
     isFrontend: boolean;
     isDatabase?: boolean;
+    isBootstrapPlaceholder?: boolean;
     transports: ServiceTransportDescriptor[];
     clientCreatedTransportIds?: string[];
 }

package/dist/index.js

@@ -531,6 +531,9 @@ function normalizeServiceInstanceDescriptor(value) {
     health: raw.health ?? {},
     isFrontend: Boolean(raw.isFrontend ?? raw.is_frontend ?? false),
     isDatabase: Boolean(raw.isDatabase ?? raw.is_database ?? false),
+    isBootstrapPlaceholder: Boolean(
+      raw.isBootstrapPlaceholder ?? raw.is_bootstrap_placeholder ?? false
+    ),
     transports,
     clientCreatedTransportIds: Array.isArray(raw.clientCreatedTransportIds) ? raw.clientCreatedTransportIds.map((entry) => normalizeString2(entry)).filter((entry) => entry.length > 0) : void 0
   };
@@ -944,6 +947,7 @@ var ServiceRegistry = class _ServiceRegistry {
             health: ctx.health ?? ctx.__health ?? {},
             numberOfRunningGraphs: ctx.numberOfRunningGraphs ?? ctx.__numberOfRunningGraphs ?? 0,
             isPrimary: false,
+            isBootstrapPlaceholder: !!ctx.isBootstrapPlaceholder,
             transports: ctx.transports ?? []
           } : void 0)
         );
@@ -998,6 +1002,9 @@ var ServiceRegistry = class _ServiceRegistry {
           trackedInstance.acceptingWork = snapshot.acceptingWork;
           trackedInstance.reportedAt = trackedInstance.reportedAt ?? (/* @__PURE__ */ new Date()).toISOString();
         }
+        if (!serviceInstance.isBootstrapPlaceholder) {
+          this.reconcileBootstrapPlaceholderInstance(serviceName, uuid5, emit);
+        }
         if (this.serviceName === serviceName) {
           return false;
         }
@@ -1287,9 +1294,23 @@ var ServiceRegistry = class _ServiceRegistry {
       (ctx, emit) => {
         const { serviceName, serviceInstanceId } = ctx;
         const serviceInstances = this.instances.get(serviceName);
-        const instance = serviceInstances?.find(
+        let instance = serviceInstances?.find(
           (i) => i.uuid === serviceInstanceId
         );
+        if (!instance && serviceName && serviceInstanceId) {
+          const bootstrapPlaceholder = serviceInstances?.find(
+            (candidate) => candidate.isBootstrapPlaceholder && (!ctx.serviceTransportId || candidate.transports.some(
+              (transport) => transport.uuid === ctx.serviceTransportId
+            ))
+          );
+          if (bootstrapPlaceholder) {
+            instance = this.adoptBootstrapPlaceholderInstanceId(
+              serviceName,
+              bootstrapPlaceholder.uuid,
+              serviceInstanceId
+            );
+          }
+        }
         if (!instance) {
           return false;
         }
@@ -2361,6 +2382,7 @@ var ServiceRegistry = class _ServiceRegistry {
       reportedAt: instance?.reportedAt ?? null,
       isDatabase: instance?.isDatabase,
       isFrontend: instance?.isFrontend,
+      isBootstrapPlaceholder: instance?.isBootstrapPlaceholder,
       transports: (instance?.transports ?? []).map((transport) => ({
         uuid: transport.uuid,
         role: transport.role,
@@ -2527,6 +2549,105 @@ var ServiceRegistry = class _ServiceRegistry {
     this.missedHeartbeatsByInstance.delete(serviceInstanceId);
     this.runtimeStatusFallbackInFlightByInstance.delete(serviceInstanceId);
   }
+  reconcileBootstrapPlaceholderInstance(serviceName, resolvedInstanceId, emit) {
+    const instances = this.instances.get(serviceName);
+    if (!instances?.length) {
+      return;
+    }
+    const placeholders = instances.filter(
+      (instance) => instance.uuid !== resolvedInstanceId && instance.isBootstrapPlaceholder
+    );
+    if (!placeholders.length) {
+      return;
+    }
+    for (const placeholder of placeholders) {
+      const wasDependee = this.dependeeByInstance.has(placeholder.uuid);
+      const requiredForReadiness = this.readinessDependeeByInstance.has(
+        placeholder.uuid
+      );
+      for (const transport of placeholder.transports) {
+        const transportKey = buildTransportClientKey(transport);
+        emit(`meta.socket_shutdown_requested:${transportKey}`, {});
+        emit(`meta.fetch.destroy_requested:${transportKey}`, {});
+      }
+      this.unregisterDependee(placeholder.uuid, serviceName);
+      if (wasDependee) {
+        this.registerDependee(serviceName, resolvedInstanceId, {
+          requiredForReadiness
+        });
+      }
+    }
+    this.instances.set(
+      serviceName,
+      instances.filter((instance) => !instance.isBootstrapPlaceholder)
+    );
+  }
+  adoptBootstrapPlaceholderInstanceId(serviceName, placeholderInstanceId, resolvedInstanceId) {
+    if (!serviceName || !placeholderInstanceId || !resolvedInstanceId) {
+      return void 0;
+    }
+    const instances = this.instances.get(serviceName);
+    if (!instances?.length) {
+      return void 0;
+    }
+    const resolvedInstance = instances.find(
+      (instance) => instance.uuid === resolvedInstanceId
+    );
+    if (resolvedInstance) {
+      return resolvedInstance;
+    }
+    const placeholder = instances.find(
+      (instance) => instance.uuid === placeholderInstanceId && instance.isBootstrapPlaceholder
+    );
+    if (!placeholder) {
+      return void 0;
+    }
+    const wasDependee = this.dependeeByInstance.has(placeholderInstanceId);
+    const dependeeServiceName = this.dependeeByInstance.get(placeholderInstanceId) ?? serviceName;
+    const requiredForReadiness = this.readinessDependeeByInstance.has(
+      placeholderInstanceId
+    );
+    const lastHeartbeatAt = this.lastHeartbeatAtByInstance.get(placeholderInstanceId) ?? Date.now();
+    const missedHeartbeats = this.missedHeartbeatsByInstance.get(placeholderInstanceId) ?? 0;
+    const inFlight = this.runtimeStatusFallbackInFlightByInstance.has(
+      placeholderInstanceId
+    );
+    this.dependeeByInstance.delete(placeholderInstanceId);
+    this.readinessDependeeByInstance.delete(placeholderInstanceId);
+    this.lastHeartbeatAtByInstance.delete(placeholderInstanceId);
+    this.missedHeartbeatsByInstance.delete(placeholderInstanceId);
+    this.runtimeStatusFallbackInFlightByInstance.delete(placeholderInstanceId);
+    placeholder.uuid = resolvedInstanceId;
+    placeholder.isBootstrapPlaceholder = false;
+    placeholder.transports = placeholder.transports.map((transport) => ({
+      ...transport,
+      serviceInstanceId: resolvedInstanceId
+    }));
+    if (wasDependee) {
+      this.dependeeByInstance.set(resolvedInstanceId, dependeeServiceName);
+      if (this.dependeesByService.has(dependeeServiceName)) {
+        this.dependeesByService.get(dependeeServiceName).delete(
+          placeholderInstanceId
+        );
+        this.dependeesByService.get(dependeeServiceName).add(resolvedInstanceId);
+      }
+      this.lastHeartbeatAtByInstance.set(resolvedInstanceId, lastHeartbeatAt);
+      this.missedHeartbeatsByInstance.set(resolvedInstanceId, missedHeartbeats);
+    }
+    if (requiredForReadiness) {
+      this.readinessDependeeByInstance.set(resolvedInstanceId, serviceName);
+      if (this.readinessDependeesByService.has(serviceName)) {
+        this.readinessDependeesByService.get(serviceName).delete(
+          placeholderInstanceId
+        );
+        this.readinessDependeesByService.get(serviceName).add(resolvedInstanceId);
+      }
+    }
+    if (inFlight) {
+      this.runtimeStatusFallbackInFlightByInstance.add(resolvedInstanceId);
+    }
+    return placeholder;
+  }
   getHeartbeatMisses(serviceInstanceId, now = Date.now()) {
     const observedMisses = this.missedHeartbeatsByInstance.get(serviceInstanceId) ?? 0;
     const lastHeartbeatAt = this.lastHeartbeatAtByInstance.get(serviceInstanceId) ?? 0;
@@ -9615,6 +9736,7 @@ var CadenzaService = class {
           isBlocked: false,
           health: {},
           isFrontend: false,
+          isBootstrapPlaceholder: true,
           transports: resolvedBootstrapEndpoint ? [
             this.createBootstrapTransport(
               "cadenza-db",
@@ -9642,6 +9764,7 @@ var CadenzaService = class {
           isBlocked: false,
           health: {},
           isFrontend: false,
+          isBootstrapPlaceholder: true,
           transports: relatedTransport ? [
             {
               uuid: `${service[0]}-${relatedTransport.role}`,