@camstack/server 1.2.637 → 1.2.638

package/dist/api/core/cap-providers.js

@@ -1679,6 +1679,7 @@ function buildAddonsProvider(ar, ps, ls, moleculer, configService, ctx, agentReg
             return { success: true };
         },
         getVersions: async (input) => ps.getPackageVersions(input.name),
+        getPackageDocs: async (input) => ps.getPackageDocs(input.name, input.version),
         restartAddon: async (input) => ar.restartAddon(input.addonId),
         retryLoad: async (input) => {
             await ar.retryAddonLoad(input.packageName);

package/dist/api/trpc/generated-cap-mounts.js

@@ -2,7 +2,7 @@
 // AUTO-GENERATED by scripts/generate-cap-mounts.ts — DO NOT EDIT
 // Re-run: npx tsx scripts/generate-cap-mounts.ts
 //
-// Mounted: 179    Skipped (legacy): 3
+// Mounted: 180    Skipped (legacy): 3
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LEGACY_SHAPE_SKIP = void 0;
 exports.mountAllCaps = mountAllCaps;
@@ -293,6 +293,7 @@ function mountAllCaps(services) {
             null, remoteCapProxy),
         flood: (0, generated_cap_routers_js_1.createCapRouter_flood)((_ctx) => (0, cap_mount_helpers_js_1.requireDeviceScoped)(reg, 'flood'), remoteCapProxy),
         gas: (0, generated_cap_routers_js_1.createCapRouter_gas)((_ctx) => (0, cap_mount_helpers_js_1.requireDeviceScoped)(reg, 'gas'), remoteCapProxy),
+        groupCommands: (0, generated_cap_routers_js_1.createCapRouter_groupCommands)((_ctx) => (0, cap_mount_helpers_js_1.requireDeviceScoped)(reg, 'group-commands'), remoteCapProxy),
         groupStatus: (0, generated_cap_routers_js_1.createCapRouter_groupStatus)((_ctx) => (0, cap_mount_helpers_js_1.requireDeviceScoped)(reg, 'group-status'), remoteCapProxy),
         heatingValve: (0, generated_cap_routers_js_1.createCapRouter_heatingValve)((_ctx) => (0, cap_mount_helpers_js_1.requireDeviceScoped)(reg, 'heating-valve'), remoteCapProxy),
         humidifier: (0, generated_cap_routers_js_1.createCapRouter_humidifier)((_ctx) => (0, cap_mount_helpers_js_1.requireDeviceScoped)(reg, 'humidifier'), remoteCapProxy),

package/dist/api/trpc/generated-cap-routers.js

@@ -2,7 +2,7 @@
 // AUTO-GENERATED by scripts/generate-cap-routers.ts — DO NOT EDIT
 // Re-run: npx tsx scripts/generate-cap-routers.ts
 //
-// Capabilities: 182
+// Capabilities: 183
 /* eslint-disable */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.requireCapProvider = requireCapProvider;
@@ -80,6 +80,7 @@ exports.createCapRouter_featureProbe = createCapRouter_featureProbe;
 exports.createCapRouter_filesystemBrowse = createCapRouter_filesystemBrowse;
 exports.createCapRouter_flood = createCapRouter_flood;
 exports.createCapRouter_gas = createCapRouter_gas;
+exports.createCapRouter_groupCommands = createCapRouter_groupCommands;
 exports.createCapRouter_groupStatus = createCapRouter_groupStatus;
 exports.createCapRouter_heatingValve = createCapRouter_heatingValve;
 exports.createCapRouter_humidifier = createCapRouter_humidifier;
@@ -704,6 +705,14 @@ function createCapRouter_addons(getProvider, _createRemoteProxy) {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
             return p.getVersions(input);
         }),
+        getPackageDocs: trpc_middleware_js_1.adminProcedure
+            .input(types_11.addonsCapability.methods.getPackageDocs.input.loose())
+            .output(types_11.addonsCapability.methods.getPackageDocs.output)
+            .query(async ({ input, ctx }) => {
+            const p = requireCapProvider('addons', () => getProvider(ctx));
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
+            return p.getPackageDocs(input);
+        }),
         restartAddon: trpc_middleware_js_1.adminProcedure
             .input(types_11.addonsCapability.methods.restartAddon.input.loose())
             .output(types_11.addonsCapability.methods.restartAddon.output)
@@ -4785,6 +4794,19 @@ function createCapRouter_gas(getProvider, createRemoteProxy) {
         }),
     });
 }
+function createCapRouter_groupCommands(getProvider, createRemoteProxy) {
+    return (0, trpc_middleware_js_1.trpcRouter)({
+        getStatus: trpc_middleware_js_1.protectedProcedure
+            .input(types_2.DEVICE_STATUS_METHOD.getStatus.input.loose())
+            .output(types_2.DEVICE_STATUS_METHOD.getStatus.output)
+            .query(async ({ input, ctx }) => {
+            const { nodeId, ...methodInput } = input;
+            const p = resolveProvider('group-commands', nodeId, () => getProvider(ctx), createRemoteProxy);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument
+            return p.getStatus(methodInput);
+        }),
+    });
+}
 function createCapRouter_groupStatus(getProvider, createRemoteProxy) {
     return (0, trpc_middleware_js_1.trpcRouter)({
         getStatus: trpc_middleware_js_1.protectedProcedure

package/dist/core/addon/addon-package.service.js

@@ -49,6 +49,8 @@ const types_2 = require("@camstack/types");
 const update_availability_emitter_js_1 = require("../update-availability-emitter.js");
 const update_check_scheduler_js_1 = require("../updates/update-check-scheduler.js");
 const restart_marker_js_1 = require("../updates/restart-marker.js");
+const package_docs_js_1 = require("./package-docs.js");
+const read_packed_file_js_1 = require("./read-packed-file.js");
 const package_dir_utils_js_1 = require("./package-dir-utils.js");
 const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
 /**
@@ -905,7 +907,7 @@ class AddonPackageService {
                 this.logger.debug('Registry returned non-ok status', {
                     meta: { name, status: response.status },
                 });
-                return [];
+                throw new Error(`registry GET ${name} → ${response.status}`);
             }
             const data = await fetchJsonObject(response);
             const distTags = asRecord(data['dist-tags']);
@@ -948,7 +950,62 @@ class AddonPackageService {
         catch (error) {
             const msg = (0, types_2.errMsg)(error);
             this.logger.warn('Failed to fetch versions', { meta: { name, error: msg } });
-            return cached?.versions ?? [];
+            if (cached)
+                return cached.versions;
+            throw error;
+        }
+    }
+    /**
+     * README (packument) and CHANGELOG (tarball) for one published package.
+     * Cached inside the reader. Registry failures stay typed on the document
+     * that failed — this method does not throw them away as an empty string.
+     */
+    async getPackageDocs(name, version) {
+        return this.docsReader().load(name, version);
+    }
+    packageDocsReader = null;
+    docsReader() {
+        if (this.packageDocsReader)
+            return this.packageDocsReader;
+        const reader = (0, package_docs_js_1.createPackageDocsReader)({
+            client: {
+                fetchPackument: (packageName) => this.fetchPackumentDocument(packageName),
+                fetchTarball: (url) => this.fetchTarballDocument(url),
+                readChangelog: (bytes) => (0, read_packed_file_js_1.readPackedChangelog)(bytes),
+            },
+        });
+        this.packageDocsReader = reader;
+        return reader;
+    }
+    async fetchPackumentDocument(name) {
+        const encodedName = name.replace('/', '%2F');
+        const url = `${this.resolveRegistryBase()}/${encodedName}`;
+        try {
+            const response = await fetch(url, {
+                signal: AbortSignal.timeout(AddonPackageService.REGISTRY_TIMEOUT_MS),
+            });
+            if (!response.ok) {
+                return { ok: false, message: `registry GET ${name} → ${response.status}` };
+            }
+            const body = await response.json();
+            return { ok: true, body };
+        }
+        catch (error) {
+            return { ok: false, message: (0, types_2.errMsg)(error) };
+        }
+    }
+    async fetchTarballDocument(url) {
+        try {
+            const response = await fetch(url, {
+                signal: AbortSignal.timeout(AddonPackageService.REGISTRY_TIMEOUT_MS),
+            });
+            if (!response.ok) {
+                return { ok: false, message: `tarball GET ${url} → ${response.status}` };
+            }
+            return { ok: true, bytes: Buffer.from(await response.arrayBuffer()) };
+        }
+        catch (error) {
+            return { ok: false, message: (0, types_2.errMsg)(error) };
         }
     }
     // =========================================================================

package/dist/core/addon/package-docs.js

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * README and CHANGELOG for one published package, read on the hub.
+ *
+ * README is the npm packument `readme` (the version's own field, else the
+ * packument root). CHANGELOG is `CHANGELOG.md` inside that version's tarball.
+ * A registry failure is a typed `error` on the side that failed — never an
+ * empty document. `missing` means the registry answered and the file was not
+ * there. Successful and missing answers are cached; errors are not, so the
+ * next open retries.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PACKAGE_DOCS_TTL_MS = void 0;
+exports.createPackageDocsReader = createPackageDocsReader;
+exports.PACKAGE_DOCS_TTL_MS = 10 * 60 * 1000;
+function asRecord(value) {
+    if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+        return { ...value };
+    }
+    return {};
+}
+function asString(value) {
+    return typeof value === 'string' ? value : '';
+}
+function docFromMarkdown(markdown) {
+    const trimmed = markdown.trim();
+    if (trimmed.length === 0)
+        return { status: 'missing' };
+    return { status: 'ok', markdown };
+}
+function errorDocs(name, version, message) {
+    const body = { status: 'error', message };
+    return { name, version, readme: body, changelog: body };
+}
+function resolvePackument(body, requested) {
+    const packument = asRecord(body);
+    const distTags = asRecord(packument['dist-tags']);
+    const versions = asRecord(packument['versions']);
+    const tagged = requested === undefined ? asString(distTags['latest']) : '';
+    const named = requested !== undefined && versions[requested] !== undefined ? requested : '';
+    const fromTag = requested !== undefined ? asString(distTags[requested]) : '';
+    const version = named || fromTag || tagged;
+    if (version.length === 0 || versions[version] === undefined) {
+        return {
+            status: 'error',
+            message: requested === undefined
+                ? 'packument has no latest version'
+                : `no version resolved for ${requested}`,
+        };
+    }
+    const meta = asRecord(versions[version]);
+    const dist = asRecord(meta['dist']);
+    const versionReadme = asString(meta['readme']);
+    const rootReadme = asString(packument['readme']);
+    const tarball = asString(dist['tarball']);
+    return {
+        status: 'ok',
+        version,
+        readme: versionReadme.length > 0 ? versionReadme : rootReadme,
+        tarballUrl: tarball.length > 0 ? tarball : null,
+    };
+}
+function cacheable(docs) {
+    return docs.readme.status !== 'error' && docs.changelog.status !== 'error';
+}
+function createPackageDocsReader(options) {
+    const cache = new Map();
+    const now = options.now ?? (() => Date.now());
+    const ttlMs = options.ttlMs ?? exports.PACKAGE_DOCS_TTL_MS;
+    async function load(name, requested) {
+        const directKey = requested !== undefined ? `${name}@${requested}` : `${name}@`;
+        const hit = cache.get(directKey);
+        if (hit !== undefined && hit.expiresAt > now())
+            return hit.docs;
+        const packument = await options.client.fetchPackument(name);
+        if (!packument.ok)
+            return errorDocs(name, requested ?? '', packument.message);
+        const resolved = resolvePackument(packument.body, requested);
+        if (resolved.status === 'error')
+            return errorDocs(name, requested ?? '', resolved.message);
+        const key = `${name}@${resolved.version}`;
+        const resolvedHit = cache.get(key);
+        if (resolvedHit !== undefined && resolvedHit.expiresAt > now())
+            return resolvedHit.docs;
+        const readme = docFromMarkdown(resolved.readme);
+        const changelog = await loadChangelog(name, resolved.version, resolved.tarballUrl, options.client);
+        const docs = { name, version: resolved.version, readme, changelog };
+        if (cacheable(docs)) {
+            const entry = { docs, expiresAt: now() + ttlMs };
+            cache.set(key, entry);
+            cache.set(directKey, entry);
+        }
+        return docs;
+    }
+    return { load };
+}
+async function loadChangelog(name, version, tarballUrl, client) {
+    if (tarballUrl === null) {
+        return { status: 'error', message: `no tarball url for ${name}@${version}` };
+    }
+    const tarball = await client.fetchTarball(tarballUrl);
+    if (!tarball.ok)
+        return { status: 'error', message: tarball.message };
+    try {
+        const text = await client.readChangelog(tarball.bytes);
+        if (text === null)
+            return { status: 'missing' };
+        return docFromMarkdown(text);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'changelog read failed';
+        return { status: 'error', message };
+    }
+}

package/dist/core/addon/read-packed-file.js

@@ -0,0 +1,91 @@
+"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.isPackedChangelogPath = isPackedChangelogPath;
+exports.readPackedChangelog = readPackedChangelog;
+/**
+ * Read one file out of an npm tarball without unpacking the rest.
+ *
+ * npm packs the package under a `package/` prefix. A changelog the registry
+ * page shows is `package/CHANGELOG.md` (or the same name at the archive root).
+ * Nested copies (`package/docs/CHANGELOG.md`) are not the package changelog.
+ */
+const node_child_process_1 = require("node:child_process");
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const node_util_1 = require("node:util");
+const node_crypto_1 = require("node:crypto");
+const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
+const TAR_TIMEOUT_MS = 30_000;
+const TAR_MAX_BUFFER = 2_000_000;
+/** True for `CHANGELOG.md` or `package/CHANGELOG.md`, any letter case. */
+function isPackedChangelogPath(entry) {
+    const parts = entry.split('/').filter((part) => part.length > 0);
+    if (parts.length !== 1 && parts.length !== 2)
+        return false;
+    const base = parts[parts.length - 1] ?? '';
+    return base.toLowerCase() === 'changelog.md';
+}
+/**
+ * Returns the changelog text, or `null` when the archive has no
+ * `CHANGELOG.md`. Throws when `tar` itself fails.
+ */
+async function readPackedChangelog(tgz) {
+    const tmpFile = path.join(os.tmpdir(), `camstack-docs-${(0, node_crypto_1.randomUUID)()}.tgz`);
+    fs.writeFileSync(tmpFile, tgz);
+    try {
+        const listed = await execFileAsync('tar', ['-tzf', tmpFile], {
+            timeout: TAR_TIMEOUT_MS,
+            maxBuffer: TAR_MAX_BUFFER,
+            encoding: 'utf8',
+        });
+        const entry = listed.stdout
+            .split('\n')
+            .map((line) => line.trim())
+            .find((line) => isPackedChangelogPath(line));
+        if (entry === undefined)
+            return null;
+        const extracted = await execFileAsync('tar', ['-xOzf', tmpFile, entry], {
+            timeout: TAR_TIMEOUT_MS,
+            maxBuffer: TAR_MAX_BUFFER,
+            encoding: 'utf8',
+        });
+        return extracted.stdout;
+    }
+    finally {
+        fs.rmSync(tmpFile, { force: true });
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/server",
-  "version": "1.2.637",
+  "version": "1.2.638",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -47,20 +47,20 @@
     ]
   },
   "dependencies": {
-    "@camstack/addon-admin-ui": "1.2.474",
-    "@camstack/addon-agent-ui": "1.2.272",
-    "@camstack/addon-auth": "1.2.168",
-    "@camstack/addon-benchmark": "1.2.271",
-    "@camstack/addon-decoder-nodeav": "1.2.142",
-    "@camstack/addon-notifiers": "1.2.621",
-    "@camstack/addon-pipeline": "1.2.628",
-    "@camstack/addon-pipeline-orchestrator": "1.2.630",
-    "@camstack/addon-post-analysis": "1.2.637",
+    "@camstack/addon-admin-ui": "1.2.475",
+    "@camstack/addon-agent-ui": "1.2.273",
+    "@camstack/addon-auth": "1.2.169",
+    "@camstack/addon-benchmark": "1.2.272",
+    "@camstack/addon-decoder-nodeav": "1.2.143",
+    "@camstack/addon-notifiers": "1.2.622",
+    "@camstack/addon-pipeline": "1.2.629",
+    "@camstack/addon-pipeline-orchestrator": "1.2.631",
+    "@camstack/addon-post-analysis": "1.2.638",
     "@camstack/develop": "0.1.36",
     "@camstack/sdk": "1.2.153",
-    "@camstack/system": "1.2.486",
-    "@camstack/types": "1.2.418",
-    "@camstack/ui-library": "1.2.328",
+    "@camstack/system": "1.2.487",
+    "@camstack/types": "1.2.419",
+    "@camstack/ui-library": "1.2.329",
     "@fastify/compress": "^9.0.0",
     "@fastify/cookie": "^11.0.2",
     "@fastify/cors": "^11.2.0",