@marinoscar/platform-api 0.0.0-stage → 0.1.0-next.11

package/dist/exports/writers/xlsx.writer.js

@@ -0,0 +1,105 @@
+"use strict";
+// =============================================================================
+// The `xlsx` export writer: one sheet per dataset (issue #744; EvoPath
+// `writers/xlsx.writer.ts`, H7 #191)
+// =============================================================================
+//
+// One worksheet per dataset, named by its title (the characters Excel forbids
+// replaced, 31 characters at most, deduplicated). Row 1 is the bold, frozen
+// header of column labels. Numbers are numbers, booleans booleans, text is
+// text: exceljs never writes a string cell as a formula, so there is no
+// injection concern. Written with exceljs' streaming workbook writer, row by
+// row, each row committed as it is added.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XLSX_EXPORT_WRITER = void 0;
+exports.xlsxSheetName = xlsxSheetName;
+const platform_sources_1 = require("./platform-sources");
+const exceljs_1 = require("exceljs");
+const export_stream_1 = require("../export-stream");
+const json_writer_1 = require("./json.writer");
+/** Excel's hard limit on the characters in one cell. */
+const XLSX_MAX_CELL_CHARS = 32_767;
+/**
+ * A sheet name Excel accepts: `\ / ? * [ ] :` replaced by `-`, 31 characters
+ * at most, and unique within the workbook (`Title (2)`).
+ *
+ * @param title - the dataset title.
+ * @param taken - the names already used (lowercase); updated.
+ * @returns the sheet name.
+ *
+ * @stability experimental
+ */
+function xlsxSheetName(title, taken) {
+    const base = (title.replace(/[\\/?*[\]:]/g, '-').trim() || 'Sheet').slice(0, 31);
+    let name = base;
+    for (let n = 2; taken.has(name.toLowerCase()); n += 1) {
+        const suffix = ` (${n})`;
+        name = base.slice(0, 31 - suffix.length) + suffix;
+    }
+    taken.add(name.toLowerCase());
+    return name;
+}
+/**
+ * The built-in XLSX writer: one sheet per dataset
+ * (`application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`, `.xlsx`).
+ *
+ * @stability experimental
+ */
+exports.XLSX_EXPORT_WRITER = {
+    id: 'xlsx',
+    label: 'Excel workbook',
+    mimeType: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+    extension: 'xlsx',
+    // Offered on the platform sources by attachment, like any app writer; an app
+    // source lists these ids in its `formats`.
+    attachTo: platform_sources_1.PLATFORM_SOURCE_IDS,
+    async write(tables, out, ctx) {
+        const rowCounts = {};
+        const finished = new Promise((resolve, reject) => {
+            out.once('finish', resolve);
+            out.on('error', reject);
+        });
+        finished.catch(() => undefined);
+        try {
+            const workbook = new exceljs_1.stream.xlsx.WorkbookWriter({ stream: out, useStyles: true, useSharedStrings: false });
+            workbook.creator = ctx.appSlug;
+            workbook.created = ctx.exportedAt;
+            const taken = new Set();
+            for await (const table of tables) {
+                (0, json_writer_1.assertDataset)(table.dataset, rowCounts);
+                const sheet = workbook.addWorksheet(xlsxSheetName(table.title, taken), { views: [{ state: 'frozen', ySplit: 1 }] });
+                sheet.columns = table.columns.map((column) => ({
+                    header: column.label,
+                    key: column.key,
+                    width: Math.min(40, Math.max(10, column.label.length + 2)),
+                }));
+                sheet.getRow(1).font = { bold: true };
+                sheet.getRow(1).commit();
+                let count = 0;
+                for await (const row of table.rows) {
+                    const values = {};
+                    for (const column of table.columns) {
+                        const value = row[column.key] ?? null;
+                        values[column.key] = typeof value === 'string' ? value.slice(0, XLSX_MAX_CELL_CHARS) : value;
+                    }
+                    sheet.addRow(values).commit();
+                    count += 1;
+                    // Let the zip stream drain every so often: exceljs queues rows in
+                    // its worksheet stream until the event loop turns.
+                    if (count % 500 === 0)
+                        await new Promise((resolve) => setImmediate(resolve));
+                }
+                rowCounts[table.dataset] = count;
+                sheet.commit();
+            }
+            await workbook.commit();
+            await finished;
+            return { rowCounts };
+        }
+        catch (error) {
+            throw (0, export_stream_1.failStream)(out, error);
+        }
+    },
+};
+//# sourceMappingURL=xlsx.writer.js.map

package/dist/exports/writers/xlsx.writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xlsx.writer.js","sourceRoot":"","sources":["../../../src/exports/writers/xlsx.writer.ts"],"names":[],"mappings":"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"}

package/dist/host/about/about-contributor.registry.d.ts

@@ -0,0 +1,64 @@
+import { type Registry } from '../../core/index';
+import type { BoundedFacts } from '../internal/bounded';
+/**
+ * The id pattern of an About contributor: lower-case, 2 to 48 characters,
+ * starting with a letter (`transcription`).
+ *
+ * @stability experimental
+ */
+export declare const ABOUT_CONTRIBUTOR_ID_PATTERN: RegExp;
+/**
+ * How long a contributor may take before its group is omitted.
+ *
+ * @stability experimental
+ */
+export declare const ABOUT_CONTRIBUTOR_TIMEOUT_MS = 2000;
+/**
+ * One About contributor.
+ *
+ * @stability experimental
+ */
+export interface AboutContributorDef {
+    /** The id. See {@link ABOUT_CONTRIBUTOR_ID_PATTERN}. */
+    readonly id: string;
+    /** The group's heading on the About page (at most 80 characters). */
+    readonly label: string;
+    /**
+     * The facts, read fresh on every request. Values are strings, numbers or
+     * booleans; the rest is dropped. Never a secret, and no network I/O beyond
+     * what the contributor can answer within {@link ABOUT_CONTRIBUTOR_TIMEOUT_MS}.
+     *
+     * @returns the facts.
+     */
+    describe(): Promise<BoundedFacts> | BoundedFacts;
+}
+/**
+ * Every registered About contributor, in registration order. Frozen when the
+ * application has bootstrapped.
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare const aboutContributorRegistry: Registry<AboutContributorDef>;
+/**
+ * Registers an About contributor. Call it at module load, before the
+ * application is created; a duplicate id throws.
+ *
+ * @param contributor - the contributor.
+ * @throws RegistryError `INVALID_ID`, `INVALID_ENTRY`, `DUPLICATE_ID` or `FROZEN`.
+ *
+ * @example
+ * ```ts
+ * // apps/api/src/app-registrations/host.ts
+ * registerAboutContributor({
+ *   id: 'transcription',
+ *   label: 'Transcription',
+ *   describe: async () => ({ provider: 'example-transcribe', regions: 2 }),
+ * });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare function registerAboutContributor(contributor: AboutContributorDef): void;
+//# sourceMappingURL=about-contributor.registry.d.ts.map

package/dist/host/about/about-contributor.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"about-contributor.registry.d.ts","sourceRoot":"","sources":["../../../src/host/about/about-contributor.registry.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,QAA2B,CAAC;AAErE;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAEjD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;CAClD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,mBAAmB,CAYjE,CAAC;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,mBAAmB,GAAG,IAAI,CAE/E"}

package/dist/host/about/about-contributor.registry.js

@@ -0,0 +1,79 @@
+"use strict";
+// =============================================================================
+// The About contributor registry (PP-14.13)
+// =============================================================================
+//
+// `GET /api/admin/about` reports the platform's facts (the API version, the
+// deploy document, the deployment mode, the database). An app has facts of its
+// own that belong on that page: which regions a provider is configured for, the
+// schema version of its data, a feature flag set. `registerAboutContributor`
+// adds a named group of facts, served as `extras: [{ id, label, facts }]` and
+// rendered by the web About page as one extra section per group.
+//
+// The route is admin-only (`system_settings:read`), but the facts are still
+// bounded and secret-filtered before they leave (`../internal/bounded.ts`: 16
+// keys, primitive values, 200-character strings, credential-looking keys
+// dropped), and ONE FAILING CONTRIBUTOR NEVER TAKES DOWN THE REPORT: a throw or
+// a timeout omits that group and logs a warning. The route keeps answering 200.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.aboutContributorRegistry = exports.ABOUT_CONTRIBUTOR_TIMEOUT_MS = exports.ABOUT_CONTRIBUTOR_ID_PATTERN = void 0;
+exports.registerAboutContributor = registerAboutContributor;
+const index_1 = require("../../core/index");
+/**
+ * The id pattern of an About contributor: lower-case, 2 to 48 characters,
+ * starting with a letter (`transcription`).
+ *
+ * @stability experimental
+ */
+exports.ABOUT_CONTRIBUTOR_ID_PATTERN = /^[a-z][a-z0-9-]{1,47}$/;
+/**
+ * How long a contributor may take before its group is omitted.
+ *
+ * @stability experimental
+ */
+exports.ABOUT_CONTRIBUTOR_TIMEOUT_MS = 2000;
+/**
+ * Every registered About contributor, in registration order. Frozen when the
+ * application has bootstrapped.
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+exports.aboutContributorRegistry = (0, index_1.defineRegistry)({
+    name: 'host.about-contributors',
+    idOf: (contributor) => contributor.id,
+    idPattern: exports.ABOUT_CONTRIBUTOR_ID_PATTERN,
+    validate: (contributor) => {
+        if (typeof contributor.label !== 'string' || contributor.label.trim() === '' || contributor.label.length > 80) {
+            throw new Error(`about contributor "${contributor.id}": label must be a non-empty string of at most 80 characters`);
+        }
+        if (typeof contributor.describe !== 'function') {
+            throw new Error(`about contributor "${contributor.id}": describe must be a function`);
+        }
+    },
+});
+/**
+ * Registers an About contributor. Call it at module load, before the
+ * application is created; a duplicate id throws.
+ *
+ * @param contributor - the contributor.
+ * @throws RegistryError `INVALID_ID`, `INVALID_ENTRY`, `DUPLICATE_ID` or `FROZEN`.
+ *
+ * @example
+ * ```ts
+ * // apps/api/src/app-registrations/host.ts
+ * registerAboutContributor({
+ *   id: 'transcription',
+ *   label: 'Transcription',
+ *   describe: async () => ({ provider: 'example-transcribe', regions: 2 }),
+ * });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+function registerAboutContributor(contributor) {
+    exports.aboutContributorRegistry.register(contributor);
+}
+//# sourceMappingURL=about-contributor.registry.js.map

package/dist/host/about/about-contributor.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"about-contributor.registry.js","sourceRoot":"","sources":["../../../src/host/about/about-contributor.registry.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,4CAA4C;AAC5C,gFAAgF;AAChF,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,gFAAgF;AAChF,6EAA6E;AAC7E,8EAA8E;AAC9E,iEAAiE;AACjE,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,yEAAyE;AACzE,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;;;AAiFhF,4DAEC;AAjFD,4CAAiE;AAGjE;;;;;GAKG;AACU,QAAA,4BAA4B,GAAG,wBAAwB,CAAC;AAErE;;;;GAIG;AACU,QAAA,4BAA4B,GAAG,IAAI,CAAC;AAsBjD;;;;;;GAMG;AACU,QAAA,wBAAwB,GAAkC,IAAA,sBAAc,EAAsB;IACzG,IAAI,EAAE,yBAAyB;IAC/B,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE;IACrC,SAAS,EAAE,oCAA4B;IACvC,QAAQ,EAAE,CAAC,WAAW,EAAE,EAAE;QACxB,IAAI,OAAO,WAAW,CAAC,KAAK,KAAK,QAAQ,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,WAAW,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YAC9G,MAAM,IAAI,KAAK,CAAC,sBAAsB,WAAW,CAAC,EAAE,8DAA8D,CAAC,CAAC;QACtH,CAAC;QACD,IAAI,OAAO,WAAW,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,sBAAsB,WAAW,CAAC,EAAE,gCAAgC,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,wBAAwB,CAAC,WAAgC;IACvE,gCAAwB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACjD,CAAC"}

package/dist/host/about/about-support-bundle.section.d.ts

@@ -0,0 +1,150 @@
+import { OnModuleInit } from '@nestjs/common';
+import { SupportBundleRegistry } from '../../doctor/index';
+import type { SupportBundleSection } from '../../doctor/index';
+import { z } from 'zod';
+import { AboutService } from './about.service';
+export declare const versionsSectionSchema: z.ZodObject<{
+    api: z.ZodObject<{
+        version: z.ZodString;
+        deploymentMode: z.ZodString;
+    }, z.core.$strict>;
+    app: z.ZodNullable<z.ZodObject<{
+        name: z.ZodNullable<z.ZodString>;
+        version: z.ZodNullable<z.ZodString>;
+        commitSha: z.ZodNullable<z.ZodString>;
+        ref: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    deployedBy: z.ZodNullable<z.ZodObject<{
+        cli: z.ZodNullable<z.ZodString>;
+        version: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    lastCommand: z.ZodNullable<z.ZodEnum<{
+        update: "update";
+        install: "install";
+    }>>;
+    installedAt: z.ZodNullable<z.ZodString>;
+    updatedAt: z.ZodNullable<z.ZodString>;
+    deployInfoStatus: z.ZodEnum<{
+        invalid: "invalid";
+        ok: "ok";
+        absent: "absent";
+    }>;
+    remote: z.ZodNullable<z.ZodObject<{
+        commitsBehind: z.ZodNullable<z.ZodNumber>;
+        checkedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    runtime: z.ZodObject<{
+        nodeVersion: z.ZodString;
+        environment: z.ZodNullable<z.ZodString>;
+        processStartedAt: z.ZodString;
+    }, z.core.$strict>;
+    database: z.ZodNullable<z.ZodObject<{
+        status: z.ZodString;
+    }, z.core.$strict>>;
+    host: z.ZodNullable<z.ZodObject<{
+        os: z.ZodNullable<z.ZodString>;
+        kernel: z.ZodNullable<z.ZodString>;
+        arch: z.ZodNullable<z.ZodString>;
+        cpus: z.ZodNullable<z.ZodNumber>;
+        memoryBytes: z.ZodNullable<z.ZodNumber>;
+        dockerVersion: z.ZodNullable<z.ZodString>;
+        composeVersion: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    proxy: z.ZodNullable<z.ZodObject<{
+        mode: z.ZodNullable<z.ZodEnum<{
+            host: "host";
+            container: "container";
+        }>>;
+    }, z.core.$strict>>;
+    history: z.ZodNullable<z.ZodObject<{
+        count: z.ZodNumber;
+        last: z.ZodNullable<z.ZodObject<{
+            at: z.ZodString;
+            command: z.ZodEnum<{
+                update: "update";
+                install: "install";
+            }>;
+            commitSha: z.ZodNullable<z.ZodString>;
+            cliVersion: z.ZodNullable<z.ZodString>;
+            durationMs: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type VersionsSectionData = z.infer<typeof versionsSectionSchema>;
+export declare class AboutSupportBundleSection implements SupportBundleSection<VersionsSectionData>, OnModuleInit {
+    private readonly registry;
+    private readonly about;
+    readonly id = "versions";
+    readonly label = "Versions";
+    readonly schema: z.ZodObject<{
+        api: z.ZodObject<{
+            version: z.ZodString;
+            deploymentMode: z.ZodString;
+        }, z.core.$strict>;
+        app: z.ZodNullable<z.ZodObject<{
+            name: z.ZodNullable<z.ZodString>;
+            version: z.ZodNullable<z.ZodString>;
+            commitSha: z.ZodNullable<z.ZodString>;
+            ref: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+        deployedBy: z.ZodNullable<z.ZodObject<{
+            cli: z.ZodNullable<z.ZodString>;
+            version: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+        lastCommand: z.ZodNullable<z.ZodEnum<{
+            update: "update";
+            install: "install";
+        }>>;
+        installedAt: z.ZodNullable<z.ZodString>;
+        updatedAt: z.ZodNullable<z.ZodString>;
+        deployInfoStatus: z.ZodEnum<{
+            invalid: "invalid";
+            ok: "ok";
+            absent: "absent";
+        }>;
+        remote: z.ZodNullable<z.ZodObject<{
+            commitsBehind: z.ZodNullable<z.ZodNumber>;
+            checkedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+        runtime: z.ZodObject<{
+            nodeVersion: z.ZodString;
+            environment: z.ZodNullable<z.ZodString>;
+            processStartedAt: z.ZodString;
+        }, z.core.$strict>;
+        database: z.ZodNullable<z.ZodObject<{
+            status: z.ZodString;
+        }, z.core.$strict>>;
+        host: z.ZodNullable<z.ZodObject<{
+            os: z.ZodNullable<z.ZodString>;
+            kernel: z.ZodNullable<z.ZodString>;
+            arch: z.ZodNullable<z.ZodString>;
+            cpus: z.ZodNullable<z.ZodNumber>;
+            memoryBytes: z.ZodNullable<z.ZodNumber>;
+            dockerVersion: z.ZodNullable<z.ZodString>;
+            composeVersion: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+        proxy: z.ZodNullable<z.ZodObject<{
+            mode: z.ZodNullable<z.ZodEnum<{
+                host: "host";
+                container: "container";
+            }>>;
+        }, z.core.$strict>>;
+        history: z.ZodNullable<z.ZodObject<{
+            count: z.ZodNumber;
+            last: z.ZodNullable<z.ZodObject<{
+                at: z.ZodString;
+                command: z.ZodEnum<{
+                    update: "update";
+                    install: "install";
+                }>;
+                commitSha: z.ZodNullable<z.ZodString>;
+                cliVersion: z.ZodNullable<z.ZodString>;
+                durationMs: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    constructor(registry: SupportBundleRegistry, about: AboutService);
+    onModuleInit(): void;
+    collect(): Promise<VersionsSectionData>;
+}
+//# sourceMappingURL=about-support-bundle.section.d.ts.map

package/dist/host/about/about-support-bundle.section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"about-support-bundle.section.d.ts","sourceRoot":"","sources":["../../../src/host/about/about-support-bundle.section.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAc,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAK/C,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0CvB,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAExE,qBACa,yBAA0B,YAAW,oBAAoB,CAAC,mBAAmB,CAAC,EAAE,YAAY;IAMrG,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IANxB,QAAQ,CAAC,EAAE,cAAc;IACzB,QAAQ,CAAC,KAAK,cAAc;IAC5B,QAAQ,CAAC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAAyB;gBAGrB,QAAQ,EAAE,qBAAqB,EAC/B,KAAK,EAAE,YAAY;IAGtC,YAAY,IAAI,IAAI;IAId,OAAO,IAAI,OAAO,CAAC,mBAAmB,CAAC;CAkD9C"}

package/dist/host/about/about-support-bundle.section.js

@@ -0,0 +1,156 @@
+"use strict";
+// =============================================================================
+// The `versions` support-bundle section (issue #772, PP-13.1)
+// =============================================================================
+//
+// The reference app's example of `SupportBundleRegistry.register`: a section
+// contributed by the module that owns the facts (About stays in the app until
+// it is packaged), registered from `onModuleInit` without importing the
+// Doctor module (it is global).
+//
+// ALLOWLIST, NEVER SPREAD. `AboutService.describe()` is copied field by field
+// into a new object, and the schema below is strict, so a field added to the
+// About report later never reaches a support bundle until someone adds it
+// here on purpose. Deliberately EXCLUDED:
+//   - `host.hostname` and `domain`: they identify the customer;
+//   - `deployInfoPath`: a local filesystem path;
+//   - `deployInfoError` and `databaseError`: free text that may echo file
+//     content or a connection string;
+//   - `proxy.container`, `proxy.certificateExpiresAt` and `bindPort`;
+//   - `run` (the last CLI run's step log);
+//   - `history` beyond its length and its last entry.
+//
+// The About report always answers with partial truth, and so does this
+// section: a missing deploy document is `deployInfoStatus: 'missing'` and
+// `null` fields, never an error.
+// =============================================================================
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AboutSupportBundleSection = exports.versionsSectionSchema = void 0;
+const common_1 = require("@nestjs/common");
+const index_1 = require("../../doctor/index");
+const zod_1 = require("zod");
+const about_service_1 = require("./about.service");
+const deploy_info_constants_1 = require("./deploy-info.constants");
+const nullableString = zod_1.z.string().nullable();
+exports.versionsSectionSchema = zod_1.z
+    .object({
+    api: zod_1.z.object({ version: zod_1.z.string(), deploymentMode: zod_1.z.string() }).strict(),
+    app: zod_1.z.object({ name: nullableString, version: nullableString, commitSha: nullableString, ref: nullableString }).strict().nullable(),
+    deployedBy: zod_1.z.object({ cli: nullableString, version: nullableString }).strict().nullable(),
+    lastCommand: zod_1.z.enum(['install', 'update']).nullable(),
+    installedAt: nullableString,
+    updatedAt: nullableString,
+    deployInfoStatus: zod_1.z.enum(deploy_info_constants_1.DEPLOY_INFO_STATUSES),
+    remote: zod_1.z.object({ commitsBehind: zod_1.z.number().nullable(), checkedAt: nullableString }).strict().nullable(),
+    runtime: zod_1.z.object({ nodeVersion: zod_1.z.string(), environment: nullableString, processStartedAt: zod_1.z.string() }).strict(),
+    database: zod_1.z.object({ status: zod_1.z.string() }).strict().nullable(),
+    host: zod_1.z
+        .object({
+        os: nullableString,
+        kernel: nullableString,
+        arch: nullableString,
+        cpus: zod_1.z.number().int().nullable(),
+        memoryBytes: zod_1.z.number().int().nullable(),
+        dockerVersion: nullableString,
+        composeVersion: nullableString,
+    })
+        .strict()
+        .nullable(),
+    proxy: zod_1.z.object({ mode: zod_1.z.enum(['container', 'host']).nullable() }).strict().nullable(),
+    history: zod_1.z
+        .object({
+        count: zod_1.z.number().int(),
+        last: zod_1.z
+            .object({
+            at: zod_1.z.string(),
+            command: zod_1.z.enum(['install', 'update']),
+            commitSha: nullableString,
+            cliVersion: nullableString,
+            durationMs: zod_1.z.number().nullable(),
+        })
+            .strict()
+            .nullable(),
+    })
+        .strict()
+        .nullable(),
+})
+    .strict();
+let AboutSupportBundleSection = class AboutSupportBundleSection {
+    registry;
+    about;
+    id = 'versions';
+    label = 'Versions';
+    schema = exports.versionsSectionSchema;
+    constructor(registry, about) {
+        this.registry = registry;
+        this.about = about;
+    }
+    onModuleInit() {
+        this.registry.register(this);
+    }
+    async collect() {
+        const report = await this.about.describe();
+        // Newest first, as the deploy document orders it (`deploy-info.ts`).
+        const last = report.history?.[0] ?? null;
+        return {
+            api: { version: report.api.version, deploymentMode: report.api.deploymentMode },
+            app: report.app
+                ? { name: report.app.name, version: report.app.version, commitSha: report.app.commitSha, ref: report.app.ref }
+                : null,
+            deployedBy: report.deployedBy ? { cli: report.deployedBy.cli, version: report.deployedBy.version } : null,
+            lastCommand: report.lastCommand,
+            installedAt: report.installedAt,
+            updatedAt: report.updatedAt,
+            deployInfoStatus: report.deployInfoStatus,
+            remote: report.remote ? { commitsBehind: report.remote.commitsBehind, checkedAt: report.remote.checkedAt } : null,
+            runtime: {
+                nodeVersion: report.runtime.nodeVersion,
+                environment: report.runtime.environment,
+                processStartedAt: report.runtime.processStartedAt,
+            },
+            database: report.database ? { status: report.database.status } : null,
+            host: report.host
+                ? {
+                    os: report.host.os,
+                    kernel: report.host.kernel,
+                    arch: report.host.arch,
+                    cpus: report.host.cpus,
+                    memoryBytes: report.host.memoryBytes,
+                    dockerVersion: report.host.dockerVersion,
+                    composeVersion: report.host.composeVersion,
+                }
+                : null,
+            proxy: report.proxy ? { mode: report.proxy.mode } : null,
+            history: report.history
+                ? {
+                    count: report.history.length,
+                    last: last
+                        ? {
+                            at: last.at,
+                            command: last.command,
+                            commitSha: last.commitSha,
+                            cliVersion: last.cliVersion,
+                            durationMs: last.durationMs,
+                        }
+                        : null,
+                }
+                : null,
+        };
+    }
+};
+exports.AboutSupportBundleSection = AboutSupportBundleSection;
+exports.AboutSupportBundleSection = AboutSupportBundleSection = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [index_1.SupportBundleRegistry,
+        about_service_1.AboutService])
+], AboutSupportBundleSection);
+//# sourceMappingURL=about-support-bundle.section.js.map

package/dist/host/about/about-support-bundle.section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"about-support-bundle.section.js","sourceRoot":"","sources":["../../../src/host/about/about-support-bundle.section.ts"],"names":[],"mappings":"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"}

package/dist/host/about/about.controller.d.ts

@@ -0,0 +1,58 @@
+import { type PlatformHost } from '../../core/index';
+import { AboutService } from './about.service';
+/**
+ * The permission `GET /api/admin/about` requires unless the app configures another.
+ *
+ * @stability experimental
+ */
+export declare const DEFAULT_ABOUT_PERMISSION: string;
+/**
+ * What `createAboutController` takes.
+ *
+ * @stability experimental
+ */
+export interface AboutControllerOptions {
+    /** The app's access decorators; omitted, the identity slice's `@Auth()`. */
+    host?: PlatformHost;
+    /** The permission the route requires. Default `system_settings:read`. */
+    permission?: string;
+}
+/**
+ * The about controller's handler.
+ *
+ * @stability experimental
+ */
+export interface AboutControllerInstance {
+    /**
+     * `GET /api/admin/about`. Resolves the deployment report (shape: the
+     * contract's `aboutResponseSchema`).
+     */
+    getAbout(): Promise<object>;
+}
+/**
+ * The about controller class.
+ *
+ * @stability experimental
+ */
+export type AboutControllerClass = new (about: AboutService) => AboutControllerInstance;
+/**
+ * Creates `GET /api/admin/about`'s controller, guarded by the app's access
+ * decorators (`PlatformHost.access`) and, by default, `system_settings:read`.
+ * `AboutModule.forRoot()` calls it.
+ *
+ * Exported for the reference app's wiring and tests; not a stable extension point (reach the report through `AboutModule.forRoot`).
+ *
+ * @param options - see {@link AboutControllerOptions}.
+ * @returns the controller class.
+ *
+ * @internal
+ */
+export declare function createAboutController(options?: AboutControllerOptions): AboutControllerClass;
+/**
+ * The about controller with the default permission and the identity slice's `@Auth()`.
+ *
+ * @internal
+ */
+export declare const AboutController: AboutControllerClass;
+export type AboutController = AboutControllerInstance;
+//# sourceMappingURL=about.controller.d.ts.map

package/dist/host/about/about.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"about.controller.d.ts","sourceRoot":"","sources":["../../../src/host/about/about.controller.ts"],"names":[],"mappings":"AA+DA,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAG7E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAqD,CAAC;AAE7F;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,KAAK,KAAK,EAAE,YAAY,KAAK,uBAAuB,CAAC;AAExF;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,GAAG,oBAAoB,CAqEhG;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,oBAA8C,CAAC;AAC7E,MAAM,MAAM,eAAe,GAAG,uBAAuB,CAAC"}