@camstack/server 1.2.88 → 1.2.90

package/dist/server-root/server-root-state.js

@@ -0,0 +1,220 @@
+"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.SERVER_ROOT_PACKAGE_NAME = exports.SERVER_ROOT_STATE_FILE = exports.SERVER_ROOT_DIRNAME = void 0;
+exports.emptyServerRootState = emptyServerRootState;
+exports.serverRootDir = serverRootDir;
+exports.versionsDir = versionsDir;
+exports.versionDir = versionDir;
+exports.serverPackageDir = serverPackageDir;
+exports.serverEntryPath = serverEntryPath;
+exports.stateFilePath = stateFilePath;
+exports.isServerRootState = isServerRootState;
+exports.readServerRootState = readServerRootState;
+exports.writeServerRootState = writeServerRootState;
+exports.minNodeMajorOf = minNodeMajorOf;
+exports.validateVersionDir = validateVersionDir;
+/**
+ * Data-dir server-root layout + state file — ZERO-DEP (node:fs/node:path only).
+ *
+ * Loaded by the baked STARTER before any node_modules resolution is trusted,
+ * so this module must never import from `@camstack/*` or any npm package.
+ * The hub-side `ServerUpdateService` imports the same module — one source of
+ * truth for the layout and the state shape.
+ *
+ * Layout (`<dataDir>/server-root/`):
+ *   versions/<semver>/              npm-installed closure for one version
+ *     node_modules/@camstack/server/dist/launcher.js   ← the loadable entry
+ *   state.json                      pointer file (ServerRootState, atomic)
+ *
+ * A POINTER FILE (state.json) is used instead of `current`/`previous`
+ * symlinks: atomic via tmp+rename, works on every fs, and carries the
+ * probation/rollback bookkeeping in the same durable record.
+ *
+ * Spec: docs/superpowers/specs/2026-07-12-runtime-updatable-node-packages-design.md
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+exports.SERVER_ROOT_DIRNAME = 'server-root';
+exports.SERVER_ROOT_STATE_FILE = 'state.json';
+exports.SERVER_ROOT_PACKAGE_NAME = '@camstack/server';
+function emptyServerRootState() {
+    return {
+        schemaVersion: 1,
+        currentVersion: null,
+        previousVersion: null,
+        pendingBoot: null,
+        rolledBack: null,
+    };
+}
+// ---------------------------------------------------------------------------
+// Layout helpers
+// ---------------------------------------------------------------------------
+function serverRootDir(dataDir) {
+    return path.join(dataDir, exports.SERVER_ROOT_DIRNAME);
+}
+function versionsDir(rootDir) {
+    return path.join(rootDir, 'versions');
+}
+function versionDir(rootDir, version) {
+    return path.join(versionsDir(rootDir), version);
+}
+function serverPackageDir(versionDirPath) {
+    return path.join(versionDirPath, 'node_modules', '@camstack', 'server');
+}
+function serverEntryPath(versionDirPath) {
+    return path.join(serverPackageDir(versionDirPath), 'dist', 'launcher.js');
+}
+function stateFilePath(rootDir) {
+    return path.join(rootDir, exports.SERVER_ROOT_STATE_FILE);
+}
+// ---------------------------------------------------------------------------
+// State IO (atomic, corruption-tolerant)
+// ---------------------------------------------------------------------------
+function isNullableString(v) {
+    return v === null || typeof v === 'string';
+}
+function isPendingBoot(v) {
+    if (typeof v !== 'object' || v === null)
+        return false;
+    const p = v;
+    return (typeof p['version'] === 'string' &&
+        isNullableString(p['fromVersion']) &&
+        typeof p['requestedAtMs'] === 'number' &&
+        typeof p['bootAttempts'] === 'number');
+}
+function isRollbackInfo(v) {
+    if (typeof v !== 'object' || v === null)
+        return false;
+    const r = v;
+    return (typeof r['fromVersion'] === 'string' &&
+        isNullableString(r['toVersion']) &&
+        typeof r['atMs'] === 'number' &&
+        typeof r['reason'] === 'string');
+}
+function isServerRootState(v) {
+    if (typeof v !== 'object' || v === null)
+        return false;
+    const s = v;
+    if (s['schemaVersion'] !== 1)
+        return false;
+    if (!isNullableString(s['currentVersion']))
+        return false;
+    if (!isNullableString(s['previousVersion']))
+        return false;
+    if (s['pendingBoot'] !== null && !isPendingBoot(s['pendingBoot']))
+        return false;
+    if (s['rolledBack'] !== null && !isRollbackInfo(s['rolledBack']))
+        return false;
+    return true;
+}
+/** Read + validate the state file. Returns null when missing/corrupt/mismatched. */
+function readServerRootState(rootDir) {
+    try {
+        const raw = JSON.parse(fs.readFileSync(stateFilePath(rootDir), 'utf-8'));
+        return isServerRootState(raw) ? raw : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Write the state file atomically (tmp sibling + rename). Creates rootDir. */
+function writeServerRootState(rootDir, state) {
+    fs.mkdirSync(rootDir, { recursive: true });
+    const target = stateFilePath(rootDir);
+    const tmp = `${target}.tmp`;
+    fs.writeFileSync(tmp, JSON.stringify(state, null, 2), 'utf-8');
+    fs.renameSync(tmp, target);
+}
+// ---------------------------------------------------------------------------
+// Version-dir validation
+// ---------------------------------------------------------------------------
+/**
+ * Extract the minimum required Node major from an `engines.node` range like
+ * `>=22`, `>= 22.12`, `^24.0.0`, `22.x`. Returns null when unparseable
+ * (validation is then permissive — a bogus range must not brick boot).
+ */
+function minNodeMajorOf(enginesNode) {
+    const match = /(\d+)/.exec(enginesNode);
+    if (match === null)
+        return null;
+    const major = Number.parseInt(match[1] ?? '', 10);
+    return Number.isNaN(major) ? null : major;
+}
+/**
+ * Validate that `versions/<version>` holds a loadable `@camstack/server`
+ * closure. Returns null when valid, else a human-readable reason. Checks:
+ *   1. the launcher entry file exists,
+ *   2. the package.json parses with the right `name` + `version`,
+ *   3. `engines.node` (when parseable) is satisfied by the running runtime —
+ *      the starter refuses a native-ABI mismatch with a clear error instead
+ *      of segfaulting (design risk: node bump vs shm-ring prebuilds).
+ */
+function validateVersionDir(rootDir, version, nodeMajor) {
+    const vDir = versionDir(rootDir, version);
+    const entry = serverEntryPath(vDir);
+    if (!fs.existsSync(entry)) {
+        return `server entry missing: ${entry}`;
+    }
+    const pkgJsonPath = path.join(serverPackageDir(vDir), 'package.json');
+    let pkg;
+    try {
+        const raw = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf-8'));
+        if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+            return `package.json malformed: ${pkgJsonPath}`;
+        }
+        pkg = raw;
+    }
+    catch {
+        return `package.json unreadable: ${pkgJsonPath}`;
+    }
+    if (pkg['name'] !== exports.SERVER_ROOT_PACKAGE_NAME) {
+        return `package name mismatch: expected ${exports.SERVER_ROOT_PACKAGE_NAME}, got ${String(pkg['name'])}`;
+    }
+    if (pkg['version'] !== version) {
+        return `package version mismatch: dir says ${version}, package.json says ${String(pkg['version'])}`;
+    }
+    const engines = pkg['engines'];
+    if (typeof engines === 'object' && engines !== null) {
+        const enginesNode = engines['node'];
+        if (typeof enginesNode === 'string') {
+            const minMajor = minNodeMajorOf(enginesNode);
+            if (minMajor !== null && nodeMajor < minMajor) {
+                return `engines.node "${enginesNode}" requires Node >= ${minMajor}, runtime is ${nodeMajor}`;
+            }
+        }
+    }
+    return null;
+}

package/dist/server-root/workspace-detect.js

@@ -0,0 +1,73 @@
+"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.detectWorkspaceRoot = detectWorkspaceRoot;
+/**
+ * Workspace-checkout detection for the starter — ZERO-DEP.
+ *
+ * The starter must defer to plain resolution in a dev checkout (`npm run
+ * dev:full` / `npm start` from the monorepo): the data-dir server root is a
+ * production mechanism and must never shadow freshly-built workspace code.
+ * Detection = any ancestor package.json declaring `workspaces` (the monorepo
+ * root has one; the baked image run-dir's `npm init -y` package.json and the
+ * data-dir version closures never do).
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+/**
+ * Walk up from `fromDir` looking for a package.json with a `workspaces`
+ * field. Returns the directory containing it, or null when none exists.
+ */
+function detectWorkspaceRoot(fromDir) {
+    let dir = path.resolve(fromDir);
+    for (;;) {
+        const pkgPath = path.join(dir, 'package.json');
+        try {
+            const raw = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+            if (typeof raw === 'object' &&
+                raw !== null &&
+                raw['workspaces'] !== undefined) {
+                return dir;
+            }
+        }
+        catch {
+            // missing / unreadable package.json — keep walking
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/server",
-  "version": "1.2.88",
+  "version": "1.2.90",
   "private": false,
   "files": [
     "dist",
@@ -33,19 +33,19 @@
     ]
   },
   "dependencies": {
-    "@camstack/addon-admin-ui": "1.2.42",
-    "@camstack/addon-agent-ui": "1.2.10",
-    "@camstack/addon-auth": "1.2.11",
-    "@camstack/addon-decoder-nodeav": "1.2.9",
-    "@camstack/addon-notifiers": "1.2.13",
-    "@camstack/addon-pipeline": "1.2.54",
-    "@camstack/addon-pipeline-orchestrator": "1.2.36",
-    "@camstack/addon-post-analysis": "1.2.56",
-    "@camstack/sdk": "1.2.11",
-    "@camstack/shm-ring": "1.1.9",
-    "@camstack/system": "1.2.75",
-    "@camstack/types": "1.2.55",
-    "@camstack/ui-library": "1.2.38",
+    "@camstack/addon-admin-ui": "*",
+    "@camstack/addon-agent-ui": "*",
+    "@camstack/addon-auth": "*",
+    "@camstack/addon-decoder-nodeav": "*",
+    "@camstack/addon-notifiers": "*",
+    "@camstack/addon-pipeline": "*",
+    "@camstack/addon-pipeline-orchestrator": "*",
+    "@camstack/addon-post-analysis": "*",
+    "@camstack/sdk": "*",
+    "@camstack/shm-ring": "*",
+    "@camstack/system": "*",
+    "@camstack/types": "*",
+    "@camstack/ui-library": "*",
     "@fastify/compress": "^9.0.0",
     "@fastify/cookie": "^11.0.2",
     "@fastify/cors": "^11.2.0",