@camstack/server 1.2.93 → 1.2.95

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

@@ -1,220 +0,0 @@
-"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

@@ -1,73 +0,0 @@
-"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;
-    }
-}