@camstack/server 1.2.695 → 1.2.696

package/dist/boot/post-boot.service.js

@@ -4,6 +4,9 @@ exports.PostBootService = void 0;
 const node_crypto_1 = require("node:crypto");
 const system_1 = require("@camstack/system");
 const types_1 = require("@camstack/types");
+const release_identity_js_1 = require("../core/release-identity.js");
+const node_update_announcement_js_1 = require("../core/updates/node-update-announcement.js");
+const index_js_1 = require("../server-root/index.js");
 const reconcile_lifecycle_jobs_js_1 = require("./reconcile-lifecycle-jobs.js");
 class PostBootService {
     eventBus;
@@ -56,6 +59,9 @@ class PostBootService {
         // restart, …). `readPendingRestart` clears the marker atomically so
         // we never re-fire on a crash-loop boot.
         this.emitRestartCompletedIfPending(dataPath);
+        // A container that came up on a different image than its previous boot
+        // says so (`node-updating`): the old container is gone before this runs.
+        this.announceImageChangeIfAny(dataPath);
         // A certificate that changed underneath the operator is an alert, not
         // a boot line they will never scroll back to (D227).
         this.emitTlsCertChangedIfReissued(tlsCert);
@@ -97,6 +103,25 @@ class PostBootService {
             data: payload,
         });
     }
+    announceImageChangeIfAny(dataDir) {
+        try {
+            (0, node_update_announcement_js_1.announceProductVersionChange)({
+                dataDir,
+                productVersion: (0, release_identity_js_1.blankToNull)(process.env[release_identity_js_1.PRODUCT_VERSION_ENV]),
+                underDesktopShell: (process.env[index_js_1.ELECTRON_APP_VERSION_ENV] ?? '').length > 0,
+                bus: this.eventBus,
+                sourceId: 'system',
+                nodeId: process.env['CAMSTACK_NODE_ID'] ?? 'hub',
+                logger: this.logger,
+            });
+        }
+        catch (err) {
+            // Telemetry (D8): never block the boot.
+            this.logger.warn('image change check failed', {
+                meta: { error: err instanceof Error ? err.message : String(err) },
+            });
+        }
+    }
     emitRestartCompletedIfPending(dataDir) {
         const marker = (0, system_1.readPendingRestart)(dataDir);
         if (marker === null)

package/dist/core/server-update/server-update.service.js

@@ -53,6 +53,7 @@ exports.ServerUpdateService = void 0;
  */
 const path = __importStar(require("node:path"));
 const index_js_1 = require("../../server-root/index.js");
+const node_update_announcement_js_1 = require("../updates/node-update-announcement.js");
 const update_availability_emitter_js_1 = require("../update-availability-emitter.js");
 const system_ensure_prebuilds_js_1 = require("./system-ensure-prebuilds.js");
 const system_apply_closure_patches_js_1 = require("./system-apply-closure-patches.js");
@@ -103,6 +104,24 @@ class ServerUpdateService extends index_js_1.RootUpdateService {
             applyClosurePatches: options.applyClosurePatches ?? (0, system_apply_closure_patches_js_1.buildSystemApplyClosurePatches)(options.logger),
             env: options.env,
             now: options.now,
+            ...(options.readWrapperProbes !== undefined
+                ? { readWrapperProbes: options.readWrapperProbes }
+                : {}),
+            // The shell is about to replace itself, and this node with it: tell the
+            // operator now (D723's `node-updating`), not after the node is gone.
+            onDesktopInstallRequested: (info) => {
+                const bus = options.eventBus;
+                if (bus === undefined)
+                    return;
+                (0, node_update_announcement_js_1.emitNodeUpdateAnnouncement)(bus, 'server-update-service', 
+                // The node, as `AddonPackageService.restartServer` names it (D723).
+                options.env?.['CAMSTACK_NODE_ID'] ?? process.env['CAMSTACK_NODE_ID'] ?? nodeId, (0, node_update_announcement_js_1.buildNodeUpdateAnnouncement)({
+                    what: 'desktop-shell',
+                    fromVersion: info.fromVersion,
+                    ...(info.toVersion !== null ? { toVersion: info.toVersion } : {}),
+                    requestedAt: Date.now(),
+                }));
+            },
             ...(options.updatePreflight !== undefined
                 ? { updatePreflight: options.updatePreflight }
                 : {}),

package/dist/core/updates/node-update-announcement.js

@@ -0,0 +1,129 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildNodeUpdateAnnouncement = buildNodeUpdateAnnouncement;
+exports.emitNodeUpdateAnnouncement = emitNodeUpdateAnnouncement;
+exports.detectProductVersionChange = detectProductVersionChange;
+exports.announceProductVersionChange = announceProductVersionChange;
+/**
+ * The announcements of an update that is NOT the `@camstack/server` closure
+ * (D723 covered that one): the Electron shell replacing itself, and a container
+ * that booted on a different image than its previous boot.
+ *
+ * Both travel as the same `system.restarting` payload the closure update uses,
+ * so the notification centre's one split (`restartIsUpdate`) turns them into
+ * `node-updating` with no new kind and no new event. `what` says which part is
+ * being replaced; `packageName` is its operator-facing name.
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_crypto_1 = require("node:crypto");
+const types_1 = require("@camstack/types");
+/** Operator-facing name of what each non-closure update replaces. */
+const UPDATE_TARGET_LABEL = {
+    'desktop-shell': 'CamStack desktop app',
+    'container-image': 'CamStack container image',
+};
+/** Where a boot records the product version it ran, to compare with the next boot. */
+const LAST_BOOT_PRODUCT_VERSION_FILE = 'last-boot-product-version';
+function buildNodeUpdateAnnouncement(input) {
+    return {
+        kind: 'framework-update',
+        what: input.what,
+        packageName: UPDATE_TARGET_LABEL[input.what],
+        ...(input.fromVersion !== undefined ? { fromVersion: input.fromVersion } : {}),
+        ...(input.toVersion !== undefined ? { toVersion: input.toVersion } : {}),
+        requestedAt: input.requestedAt,
+    };
+}
+/** Emit the announcement through the node's event bus (telemetry, D8: never throws). */
+function emitNodeUpdateAnnouncement(bus, sourceId, nodeId, payload) {
+    bus.emit({
+        id: (0, node_crypto_1.randomUUID)(),
+        timestamp: new Date(),
+        source: { type: 'core', id: sourceId },
+        category: types_1.EventCategory.SystemRestarting,
+        data: { ...payload, nodeId },
+    });
+}
+/**
+ * Compare the product version this boot runs (`CAMSTACK_PRODUCT_VERSION`, set
+ * by the image) with the one the previous boot recorded, then record this one.
+ * The record is ONE small file in the data dir: the image is replaced under the
+ * node, so the data dir is the only thing that remembers the old one.
+ *
+ * `null` for the first boot, an unchanged version, or an unknown current
+ * version (a dev workspace leaves it unset — absence, not a change; the record
+ * is left alone then).
+ */
+function detectProductVersionChange(dataDir, current) {
+    if (current === null)
+        return null;
+    const file = path.join(dataDir, LAST_BOOT_PRODUCT_VERSION_FILE);
+    let previous = null;
+    try {
+        const raw = fs.readFileSync(file, 'utf-8').trim();
+        previous = raw.length > 0 ? raw : null;
+    }
+    catch {
+        previous = null;
+    }
+    if (previous === current)
+        return null;
+    fs.mkdirSync(dataDir, { recursive: true });
+    fs.writeFileSync(file, `${current}\n`, 'utf-8');
+    return previous === null ? null : { from: previous, to: current };
+}
+/**
+ * At boot: when the container runs a different image than the previous boot,
+ * say so as a `node-updating`. The old container is gone before this process
+ * exists, so this is the earliest the change can be known. The record is
+ * updated either way; under the desktop shell nothing is announced (the shell
+ * announces its own install, and its product version moves with it).
+ */
+function announceProductVersionChange(input) {
+    const change = detectProductVersionChange(input.dataDir, input.productVersion);
+    if (change === null || input.underDesktopShell)
+        return;
+    input.logger.info('container image changed since the previous boot', {
+        meta: { nodeId: input.nodeId, from: change.from, to: change.to },
+    });
+    emitNodeUpdateAnnouncement(input.bus, input.sourceId, input.nodeId, buildNodeUpdateAnnouncement({
+        what: 'container-image',
+        fromVersion: change.from,
+        toVersion: change.to,
+        requestedAt: (input.now ?? Date.now)(),
+    }));
+}

package/dist/server-root/index.js

@@ -1239,6 +1239,7 @@ var require_dist = __commonJS({
       env;
       readWrapperProbesFn;
       now;
+      onDesktopInstallRequested;
       sleep;
       runningPackageJsonPath;
       workspaceProbeDir;
@@ -1282,6 +1283,7 @@ var require_dist = __commonJS({
         this.env = options.env ?? process.env;
         this.readWrapperProbesFn = options.readWrapperProbes ?? readWrapperProbes;
         this.now = options.now ?? Date.now;
+        this.onDesktopInstallRequested = options.onDesktopInstallRequested;
         this.sleep = options.sleep ?? ((ms) => new Promise((resolve3) => {
           setTimeout(resolve3, ms);
         }));
@@ -1952,6 +1954,19 @@ var require_dist = __commonJS({
             updateVersion: desktopApp.update.version
           }
         });
+        try {
+          this.onDesktopInstallRequested?.({
+            fromVersion: desktopApp.version,
+            toVersion: desktopApp.update.version
+          });
+        } catch (err) {
+          this.logger.warn("desktop update announcement failed", {
+            tags: this.logTags,
+            meta: {
+              error: err instanceof Error ? err.message : String(err)
+            }
+          });
+        }
         return {
           accepted: true,
           reason: null

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/server",
-  "version": "1.2.695",
+  "version": "1.2.696",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -50,20 +50,20 @@
     ]
   },
   "dependencies": {
-    "@camstack/addon-admin-ui": "1.2.522",
-    "@camstack/addon-agent-ui": "1.2.295",
+    "@camstack/addon-admin-ui": "1.2.523",
+    "@camstack/addon-agent-ui": "1.2.296",
     "@camstack/addon-auth": "1.2.170",
-    "@camstack/addon-benchmark": "1.2.294",
+    "@camstack/addon-benchmark": "1.2.295",
     "@camstack/addon-decoder-nodeav": "1.2.144",
     "@camstack/addon-notifiers": "1.2.623",
     "@camstack/addon-pipeline": "1.2.634",
     "@camstack/addon-pipeline-orchestrator": "1.2.640",
-    "@camstack/addon-post-analysis": "1.2.651",
+    "@camstack/addon-post-analysis": "1.2.652",
     "@camstack/develop": "0.1.39",
     "@camstack/sdk": "1.2.154",
-    "@camstack/system": "1.2.521",
-    "@camstack/types": "1.2.447",
-    "@camstack/ui-library": "1.2.353",
+    "@camstack/system": "1.2.522",
+    "@camstack/types": "1.2.448",
+    "@camstack/ui-library": "1.2.354",
     "@fastify/compress": "^9.0.0",
     "@fastify/cookie": "^11.0.2",
     "@fastify/cors": "^11.2.0",