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

package/dist/doctor/doctor-check.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-check.interface.js","sourceRoot":"","sources":["../../src/doctor/doctor-check.interface.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,iEAAiE;AACjE,gFAAgF;AAChF,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,+EAA+E;AAC/E,iDAAiD;AACjD,EAAE;AACF,iEAAiE;AACjE,4EAA4E;AAC5E,4EAA4E;AAC5E,wEAAwE;AACxE,8EAA8E;AAC9E,EAAE;AACF,0CAA0C;AAC1C,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,4EAA4E;AAC5E,2EAA2E;AAC3E,mDAAmD;AACnD,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,wEAAwE;AACxE,4EAA4E;AAC5E,gFAAgF;AAChF,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,gDAAgD;AAChD,2DAA2D;AAC3D,oEAAoE;AACpE,sDAAsD;AACtD,8EAA8E;AAC9E,qEAAqE;AACrE,4DAA4D;AAC5D,kDAAkD;AAClD,4EAA4E;AAC5E,EAAE;AACF,sEAAsE;AACtE,0EAA0E;AAC1E,0EAA0E;AAC1E,gEAAgE;AAChE,EAAE;AACF,6DAA6D;AAC7D,8EAA8E;AAC9E,0CAA0C;AAC1C,4EAA4E;AAC5E,8EAA8E;AAC9E,+EAA+E;AAC/E,qCAAqC;AACrC,EAAE;AACF,iEAAiE;AACjE,iEAAiE;AACjE,wEAAwE;AACxE,uEAAuE;AACvE,gEAAgE;AAChE,gFAAgF;;;AAOhF,+DAA2F;AAAlF,yGAAA,eAAe,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAG5C;;;;;;GAMG;AACU,QAAA,0BAA0B,GAAG;IACxC,MAAM;IACN,MAAM;IACN,aAAa;IACb,SAAS;IACT,OAAO;IACP,MAAM;IACN,IAAI;IACJ,MAAM;IACN,OAAO;IACP,QAAQ;IACR,WAAW;IACX,SAAS;CACD,CAAC;AAEX;;;;;GAKG;AACU,QAAA,iBAAiB,GAAG,kCAA0B,CAAC"}

package/dist/doctor/doctor-check.registry.d.ts

@@ -0,0 +1,37 @@
+import { OnApplicationBootstrap } from '@nestjs/common';
+import { DoctorCheck } from './doctor-check.interface';
+/**
+ * The checks `GET /api/admin/doctor` runs. Provided (globally) by
+ * `DoctorModule.forRoot()`; a feature module's check injects it and registers
+ * itself from `onModuleInit`.
+ *
+ * @stability stable
+ */
+export declare class DoctorCheckRegistry implements OnApplicationBootstrap {
+    private readonly checks;
+    /**
+     * Adds `check`. Call it from the check's own `onModuleInit`.
+     *
+     * @param check - the check; its `id` must be unique across the application.
+     * @throws RegistryError `DUPLICATE_ID` when another check already uses its id
+     *   (`Duplicate doctor check id "<id>": <A> and <B> both register it. Check ids must be unique.`),
+     *   `FROZEN` after the application has bootstrapped.
+     *
+     * @example
+     * ```ts
+     * onModuleInit(): void {
+     *   this.registry.register(this);
+     * }
+     * ```
+     *
+     * @extensionPoint registry
+     */
+    register(check: DoctorCheck): void;
+    /** The check registered under `id`, or `undefined`. */
+    get(id: string): DoctorCheck | undefined;
+    /** Every registered check, in registration order. */
+    list(): DoctorCheck[];
+    /** Refuses further registrations once every module's `onModuleInit` has run. */
+    onApplicationBootstrap(): void;
+}
+//# sourceMappingURL=doctor-check.registry.d.ts.map

package/dist/doctor/doctor-check.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-check.registry.d.ts","sourceRoot":"","sources":["../../src/doctor/doctor-check.registry.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAc,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAGpE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD;;;;;;GAMG;AACH,qBACa,mBAAoB,YAAW,sBAAsB;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAMpB;IAEH;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAIlC,uDAAuD;IACvD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIxC,qDAAqD;IACrD,IAAI,IAAI,WAAW,EAAE;IAIrB,gFAAgF;IAChF,sBAAsB,IAAI,IAAI;CAG/B"}

package/dist/doctor/doctor-check.registry.js

@@ -0,0 +1,96 @@
+"use strict";
+// =============================================================================
+// Doctor check registry (issue #634; packaged by #696)
+// =============================================================================
+//
+// The one place that knows which checks `GET /api/admin/doctor` runs.
+// `DoctorService` holds this and nothing else; it has no import of any check
+// and no reason to change when a capability adds one.
+//
+// EXPLICIT SELF-REGISTRATION, the same mechanism and for the same reasons as
+// the app's `jobs/job-handler.registry.ts` (read its header): each check is an
+// `@Injectable()` in its OWNING feature module, injects this registry, and calls
+// `this.registry.register(this)` from its own `onModuleInit`. "Why does the
+// doctor run this check?" has a grep-able answer — one `register(this)` line —
+// and a check nobody wired up is a missing line in a diff rather than a
+// decorator scan that silently matched nothing.
+//
+// The lifecycle consequence is the one the job registry documents: every
+// `onModuleInit` has run before the first HTTP request is served, so the
+// doctor never races a registration. (Nothing here runs at boot.)
+//
+// ⚠ DUPLICATE IDS THROW, where the job registry overwrites. The difference is
+// deliberate: a job `type` is a persisted contract a fork may legitimately
+// shadow with its own handler, while a check id only names a line in a report.
+// Two checks claiming one id is always a copy-paste mistake, and reporting one
+// of them while silently dropping the other would hide exactly the check its
+// author thought they had added. Failing at boot is loud and trivially fixed.
+//
+// Built on the generic registry primitive (the `core` slice, issue #675): an
+// INSTANCE registry with the primitive's default duplicate policy (throw), kept
+// in registration order, and frozen in `onApplicationBootstrap`, after every
+// check's `onModuleInit` has registered it. A check that registers any later is
+// a wiring mistake and fails with `FROZEN`.
+// =============================================================================
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DoctorCheckRegistry = void 0;
+const common_1 = require("@nestjs/common");
+const index_1 = require("../core/index");
+/**
+ * The checks `GET /api/admin/doctor` runs. Provided (globally) by
+ * `DoctorModule.forRoot()`; a feature module's check injects it and registers
+ * itself from `onModuleInit`.
+ *
+ * @stability stable
+ */
+let DoctorCheckRegistry = class DoctorCheckRegistry {
+    checks = new index_1.Registry({
+        name: 'doctor-checks',
+        idOf: (check) => check.id,
+        describeDuplicate: (existing, incoming) => `Duplicate doctor check id "${incoming.id}": ${existing.constructor.name} and ` +
+            `${incoming.constructor.name} both register it. Check ids must be unique.`,
+    });
+    /**
+     * Adds `check`. Call it from the check's own `onModuleInit`.
+     *
+     * @param check - the check; its `id` must be unique across the application.
+     * @throws RegistryError `DUPLICATE_ID` when another check already uses its id
+     *   (`Duplicate doctor check id "<id>": <A> and <B> both register it. Check ids must be unique.`),
+     *   `FROZEN` after the application has bootstrapped.
+     *
+     * @example
+     * ```ts
+     * onModuleInit(): void {
+     *   this.registry.register(this);
+     * }
+     * ```
+     *
+     * @extensionPoint registry
+     */
+    register(check) {
+        this.checks.register(check);
+    }
+    /** The check registered under `id`, or `undefined`. */
+    get(id) {
+        return this.checks.get(id);
+    }
+    /** Every registered check, in registration order. */
+    list() {
+        return this.checks.list();
+    }
+    /** Refuses further registrations once every module's `onModuleInit` has run. */
+    onApplicationBootstrap() {
+        this.checks.freeze();
+    }
+};
+exports.DoctorCheckRegistry = DoctorCheckRegistry;
+exports.DoctorCheckRegistry = DoctorCheckRegistry = __decorate([
+    (0, common_1.Injectable)()
+], DoctorCheckRegistry);
+//# sourceMappingURL=doctor-check.registry.js.map

package/dist/doctor/doctor-check.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-check.registry.js","sourceRoot":"","sources":["../../src/doctor/doctor-check.registry.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,uDAAuD;AACvD,gFAAgF;AAChF,EAAE;AACF,sEAAsE;AACtE,6EAA6E;AAC7E,sDAAsD;AACtD,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,iFAAiF;AACjF,4EAA4E;AAC5E,+EAA+E;AAC/E,wEAAwE;AACxE,gDAAgD;AAChD,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AACzE,kEAAkE;AAClE,EAAE;AACF,8EAA8E;AAC9E,2EAA2E;AAC3E,+EAA+E;AAC/E,+EAA+E;AAC/E,6EAA6E;AAC7E,8EAA8E;AAC9E,EAAE;AACF,6EAA6E;AAC7E,gFAAgF;AAChF,6EAA6E;AAC7E,gFAAgF;AAChF,4CAA4C;AAC5C,gFAAgF;;;;;;;;;AAEhF,2CAAoE;AAEpE,yCAAyC;AAGzC;;;;;;GAMG;AAEI,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IACb,MAAM,GAAG,IAAI,gBAAQ,CAAc;QAClD,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE;QACzB,iBAAiB,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,CACxC,8BAA8B,QAAQ,CAAC,EAAE,MAAM,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO;YAC/E,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,8CAA8C;KAC7E,CAAC,CAAC;IAEH;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,KAAkB;QACzB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,uDAAuD;IACvD,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,qDAAqD;IACrD,IAAI;QACF,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,gFAAgF;IAChF,sBAAsB;QACpB,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;CACF,CAAA;AA5CY,kDAAmB;8BAAnB,mBAAmB;IAD/B,IAAA,mBAAU,GAAE;GACA,mBAAmB,CA4C/B"}

package/dist/doctor/doctor.controller.factory.d.ts

@@ -0,0 +1,29 @@
+import type { DoctorReport } from '@marinoscar/platform-contract/doctor';
+import { Type } from '@nestjs/common';
+import type { ResolvedDoctorModuleOptions } from './doctor.options';
+import { DoctorQueryDto } from './dto/doctor-query.dto';
+/**
+ * The shape of the controller class {@link createDoctorController} returns.
+ *
+ * @stability experimental
+ */
+export interface DoctorControllerInstance {
+    /**
+     * `GET <path>`: runs the checks (or one category) and returns the report.
+     *
+     * @param query - the validated query (`category`, `refresh`).
+     */
+    getReport(query: DoctorQueryDto): Promise<DoctorReport>;
+}
+/**
+ * Creates the Doctor's controller class for one set of options: the route at
+ * `options.path`, guarded by `options.host.access.requirePermissions([options.permission])`.
+ * `DoctorModule.forRoot()` calls it; an app never needs to.
+ *
+ * @param options - the resolved module options.
+ * @returns a controller class named `DoctorController` with a `getReport` handler.
+ *
+ * @stability experimental
+ */
+export declare function createDoctorController(options: ResolvedDoctorModuleOptions): Type<DoctorControllerInstance>;
+//# sourceMappingURL=doctor.controller.factory.d.ts.map

package/dist/doctor/doctor.controller.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.controller.factory.d.ts","sourceRoot":"","sources":["../../src/doctor/doctor.controller.factory.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAAkC,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAItE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACzD;AAwBD;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAAC,wBAAwB,CAAC,CAsC3G"}

package/dist/doctor/doctor.controller.factory.js

@@ -0,0 +1,121 @@
+"use strict";
+// =============================================================================
+// GET /api/admin/doctor, created per app (issue #634; packaged by #696)
+// =============================================================================
+//
+// THE CONTROLLER-FACTORY RECIPE (core README, "Host ports"). A packaged
+// controller cannot import the app's `@Auth()`, and Nest applies decorators
+// when a class is defined, before any container exists. So the class is
+// defined HERE, inside a function `DoctorModule.forRoot()` calls, with the
+// decorators the app's host supplies (`options.host.access`). The package
+// owns the route, the OpenAPI text and the handler; the app owns the policy.
+//
+// ⚠ THE OPENAPI DOCUMENT MUST NOT CHANGE when an app moves from its own
+// controller to this one:
+//   - the class is named `DoctorController` and the handler `getReport`, which
+//     the app's operationId factory turns into `doctor_getReport`;
+//   - the decorators are applied in the order the app's controller used
+//     (`@Get`, access, `@ApiOperation`, the two `@ApiQuery`, the two
+//     `@ApiResponse`);
+//   - the description text is generated from the options, and with the
+//     defaults it is word for word what it was.
+//
+// `@Inject(DoctorService)` is explicit so dependency injection never depends
+// on the decorator metadata of a class declared in a closure.
+// =============================================================================
+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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDoctorController = createDoctorController;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const doctor_service_1 = require("./doctor.service");
+const doctor_query_dto_1 = require("./dto/doctor-query.dto");
+const doctor_report_dto_1 = require("./dto/doctor-report.dto");
+/** The operation description, generated from the options (identical with the defaults). */
+function describeOperation(options) {
+    return ('Runs a read-only check of every capability this deployment has — database, ' +
+        'authentication, maintenance mode, object storage, email, Web Push, AI, the job queue, ' +
+        'worker nodes, database backups and telemetry — and returns one row per check with a ' +
+        '`status` (`pass`, `warn`, `fail`, `skip`), a one-line `detail`, and on `warn`/`fail` a ' +
+        '`remedy` plus the `settingsPath` of the page that fixes it.\n\n' +
+        '**Always answers `200`.** A failing check is a row, not an error status.\n\n' +
+        '**Read-only.** No check writes an object, a row or an audit event, sends mail or a ' +
+        'push, or calls a model; the explicit "Test" buttons on each settings page remain the ' +
+        'way to exercise a capability end to end.\n\n' +
+        `**Bounded.** Checks run in parallel; each is cut off after ${options.defaultTimeoutMs} ms ` +
+        'unless it declares otherwise, and a check whose dependency failed or was skipped is ' +
+        'reported as `skip` without running.\n\n' +
+        `**Cached** for ${options.cacheTtlMs / 1000} s per \`category\`; pass \`refresh=true\` to run ` +
+        'again now. `generatedAt` says when the report was produced.\n\n' +
+        '`verdict` is the worst status present, ordered `pass` < `skip` < `warn` < `fail`.\n\n' +
+        `Requires \`${options.permission}\`.`);
+}
+/**
+ * Creates the Doctor's controller class for one set of options: the route at
+ * `options.path`, guarded by `options.host.access.requirePermissions([options.permission])`.
+ * `DoctorModule.forRoot()` calls it; an app never needs to.
+ *
+ * @param options - the resolved module options.
+ * @returns a controller class named `DoctorController` with a `getReport` handler.
+ *
+ * @stability experimental
+ */
+function createDoctorController(options) {
+    const requireAccess = options.host.access.requirePermissions([options.permission]);
+    let DoctorController = class DoctorController {
+        doctor;
+        constructor(doctor) {
+            this.doctor = doctor;
+        }
+        async getReport(query) {
+            const { category, refresh } = query;
+            return this.doctor.run({ category, refresh: refresh === true });
+        }
+    };
+    __decorate([
+        (0, common_1.Get)(),
+        requireAccess,
+        (0, swagger_1.ApiOperation)({
+            summary: 'Run the configuration and health checks (Admin only)',
+            description: describeOperation(options),
+        }),
+        (0, swagger_1.ApiQuery)({
+            name: 'category',
+            required: false,
+            type: String,
+            description: `Only the checks in this category. Shipped categories: ${options.categoryOrder.join(', ')}. ` +
+                'An unknown category returns an empty report.',
+        }),
+        (0, swagger_1.ApiQuery)({
+            name: 'refresh',
+            required: false,
+            enum: ['true', 'false'],
+            description: '`true` bypasses the report cache.',
+        }),
+        (0, swagger_1.ApiResponse)({ status: 200, description: 'The doctor report.', type: doctor_report_dto_1.DoctorReportDto }),
+        (0, swagger_1.ApiResponse)({ status: 400, description: 'Invalid query parameter' }),
+        __param(0, (0, common_1.Query)()),
+        __metadata("design:type", Function),
+        __metadata("design:paramtypes", [doctor_query_dto_1.DoctorQueryDto]),
+        __metadata("design:returntype", Promise)
+    ], DoctorController.prototype, "getReport", null);
+    DoctorController = __decorate([
+        (0, swagger_1.ApiTags)('Doctor'),
+        (0, common_1.Controller)(options.path),
+        __param(0, (0, common_1.Inject)(doctor_service_1.DoctorService)),
+        __metadata("design:paramtypes", [doctor_service_1.DoctorService])
+    ], DoctorController);
+    return DoctorController;
+}
+//# sourceMappingURL=doctor.controller.factory.js.map

package/dist/doctor/doctor.controller.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.controller.factory.js","sourceRoot":"","sources":["../../src/doctor/doctor.controller.factory.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,wEAAwE;AACxE,gFAAgF;AAChF,EAAE;AACF,wEAAwE;AACxE,4EAA4E;AAC5E,wEAAwE;AACxE,2EAA2E;AAC3E,0EAA0E;AAC1E,6EAA6E;AAC7E,EAAE;AACF,wEAAwE;AACxE,0BAA0B;AAC1B,+EAA+E;AAC/E,mEAAmE;AACnE,wEAAwE;AACxE,qEAAqE;AACrE,uBAAuB;AACvB,uEAAuE;AACvE,gDAAgD;AAChD,EAAE;AACF,6EAA6E;AAC7E,8DAA8D;AAC9D,gFAAgF;;;;;;;;;;;;;;AAyDhF,wDAsCC;AA5FD,2CAAsE;AACtE,6CAA+E;AAE/E,qDAAiD;AAEjD,6DAAwD;AACxD,+DAA0D;AAgB1D,2FAA2F;AAC3F,SAAS,iBAAiB,CAAC,OAAoC;IAC7D,OAAO,CACL,6EAA6E;QAC7E,wFAAwF;QACxF,sFAAsF;QACtF,yFAAyF;QACzF,iEAAiE;QACjE,8EAA8E;QAC9E,qFAAqF;QACrF,uFAAuF;QACvF,8CAA8C;QAC9C,8DAA8D,OAAO,CAAC,gBAAgB,MAAM;QAC5F,sFAAsF;QACtF,yCAAyC;QACzC,kBAAkB,OAAO,CAAC,UAAU,GAAG,IAAI,oDAAoD;QAC/F,iEAAiE;QACjE,uFAAuF;QACvF,cAAc,OAAO,CAAC,UAAU,KAAK,CACtC,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,sBAAsB,CAAC,OAAoC;IACzE,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAEnF,IAEM,gBAAgB,GAFtB,MAEM,gBAAgB;QACgC;QAApD,YAAoD,MAAqB;YAArB,WAAM,GAAN,MAAM,CAAe;QAAG,CAAC;QAwBvE,AAAN,KAAK,CAAC,SAAS,CAAU,KAAqB;YAC5C,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,KAAiD,CAAC;YAEhF,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;KACF,CAAA;IALO;QAtBL,IAAA,YAAG,GAAE;QACL,aAAa;QACb,IAAA,sBAAY,EAAC;YACZ,OAAO,EAAE,sDAAsD;YAC/D,WAAW,EAAE,iBAAiB,CAAC,OAAO,CAAC;SACxC,CAAC;QACD,IAAA,kBAAQ,EAAC;YACR,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,MAAM;YACZ,WAAW,EACT,yDAAyD,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;gBAC7F,8CAA8C;SACjD,CAAC;QACD,IAAA,kBAAQ,EAAC;YACR,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;YACvB,WAAW,EAAE,mCAAmC;SACjD,CAAC;QACD,IAAA,qBAAW,EAAC,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,oBAAoB,EAAE,IAAI,EAAE,mCAAe,EAAE,CAAC;QACtF,IAAA,qBAAW,EAAC,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,yBAAyB,EAAE,CAAC;QACpD,WAAA,IAAA,cAAK,GAAE,CAAA;;yCAAQ,iCAAc;;qDAI7C;IA7BG,gBAAgB;QAFrB,IAAA,iBAAO,EAAC,QAAQ,CAAC;QACjB,IAAA,mBAAU,EAAC,OAAO,CAAC,IAAI,CAAC;QAEV,WAAA,IAAA,eAAM,EAAC,8BAAa,CAAC,CAAA;yCAA0B,8BAAa;OADrE,gBAAgB,CA8BrB;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}

package/dist/doctor/doctor.module.d.ts

@@ -0,0 +1,78 @@
+import { DynamicModule } from '@nestjs/common';
+import type { PlatformHost } from '../core/index';
+import type { SupportBundleOptions } from './support-bundle/support-bundle.options';
+/**
+ * The permission `GET /api/admin/doctor` requires unless an app passes another:
+ * the existing `system_settings:read`. The report describes the deployment's
+ * configuration, which is exactly what that permission already covers, and
+ * every check is read-only, so there is no new capability to grant (no
+ * `doctor:read`). A web settings card reaching the route must declare this same
+ * literal (Settings UI Pattern rule 3).
+ *
+ * @stability stable
+ */
+export declare const DEFAULT_DOCTOR_PERMISSION = "system_settings:read";
+/**
+ * The route path under the app's global prefix unless an app passes another.
+ *
+ * @stability stable
+ */
+export declare const DEFAULT_DOCTOR_PATH = "admin/doctor";
+/**
+ * What an app passes to {@link DoctorModule.forRoot}.
+ *
+ * @extensionPoint option
+ * @stability experimental
+ */
+export interface DoctorModuleOptions {
+    /** From definePlatformHost(); required. Without it forRoot throws: the route is never public. */
+    host: PlatformHost;
+    /** Permission required to read the report. Default {@link DEFAULT_DOCTOR_PERMISSION}. Must be a permission the app's RBAC grants. */
+    permission?: string;
+    /** Route path under the global prefix. Default {@link DEFAULT_DOCTOR_PATH} (`'admin/doctor'`). */
+    path?: string;
+    /** Category display/sort order. Default `PLATFORM_DOCTOR_CATEGORIES`; unknown categories sort after, in registration order. */
+    categoryOrder?: readonly string[];
+    /** Per-check ceiling when a check declares none, in milliseconds. Default 5_000. */
+    defaultTimeoutMs?: number;
+    /** Report cache TTL, in milliseconds. Default 15_000. */
+    cacheTtlMs?: number;
+    /**
+     * The support bundle (`GET <path>/support-bundle`): the filename slug, how
+     * the caller is resolved, the per-section timeout. Pass `false` for no
+     * bundle route and no built-in sections (`SupportBundleRegistry` is still
+     * provided, so sections an app registers need no change). Default: enabled.
+     */
+    supportBundle?: SupportBundleOptions | false;
+}
+/**
+ * The admin Doctor: `GET /api/admin/doctor`, the check registry and the
+ * service that runs it. Import it once, with {@link DoctorModule.forRoot}.
+ *
+ * @stability stable
+ */
+export declare class DoctorModule {
+    /**
+     * The Doctor, configured for one app: a global module providing
+     * `DoctorCheckRegistry`, `DoctorService`, `DOCTOR_MODULE_OPTIONS`,
+     * `EgressRegistry`, `SupportBundleRegistry` and `SupportBundleService`, with
+     * the Doctor's and the support bundle's controllers created from the app's
+     * host access decorators. The built-in `meta`, `doctor` and `egress` bundle
+     * sections register themselves.
+     *
+     * @param options - see {@link DoctorModuleOptions}; `host` is required.
+     * @returns the dynamic module to import in the app's root module.
+     * @throws Error when `host` is missing or invalid (the route is never
+     *   public), or an option is malformed.
+     *
+     * @example
+     * ```ts
+     * // apps/api/src/doctor/doctor.config.ts
+     * export const doctorModule = DoctorModule.forRoot({ host: platformHost });
+     * ```
+     *
+     * @extensionPoint option
+     */
+    static forRoot(options: DoctorModuleOptions): DynamicModule;
+}
+//# sourceMappingURL=doctor.module.d.ts.map

package/dist/doctor/doctor.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.module.d.ts","sourceRoot":"","sources":["../../src/doctor/doctor.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,MAAM,gBAAgB,CAAC;AAGvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAYlD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAoBpF;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,iGAAiG;IACjG,IAAI,EAAE,YAAY,CAAC;IACnB,qIAAqI;IACrI,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kGAAkG;IAClG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+HAA+H;IAC/H,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,oBAAoB,GAAG,KAAK,CAAC;CAC9C;AA4CD;;;;;GAKG;AACH,qBACa,YAAY;IACvB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa;CAgC5D"}

package/dist/doctor/doctor.module.js

@@ -0,0 +1,158 @@
+"use strict";
+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 DoctorModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DoctorModule = exports.DEFAULT_DOCTOR_PATH = exports.DEFAULT_DOCTOR_PERMISSION = void 0;
+const common_1 = require("@nestjs/common");
+const index_1 = require("../core/index");
+const doctor_check_interface_1 = require("./doctor-check.interface");
+const doctor_check_registry_1 = require("./doctor-check.registry");
+const doctor_controller_factory_1 = require("./doctor.controller.factory");
+const doctor_options_1 = require("./doctor.options");
+const doctor_service_1 = require("./doctor.service");
+const egress_registry_1 = require("./egress/egress.registry");
+const doctor_section_1 = require("./support-bundle/sections/doctor.section");
+const egress_section_1 = require("./support-bundle/sections/egress.section");
+const meta_section_1 = require("./support-bundle/sections/meta.section");
+const support_bundle_controller_1 = require("./support-bundle/support-bundle.controller");
+const support_bundle_options_1 = require("./support-bundle/support-bundle.options");
+const support_bundle_registry_1 = require("./support-bundle/support-bundle.registry");
+const support_bundle_service_1 = require("./support-bundle/support-bundle.service");
+// =============================================================================
+// DoctorModule.forRoot() (issue #634; packaged by #696)
+// =============================================================================
+//
+// GLOBAL, so a feature module contributes a check by providing it — the check
+// injects `DoctorCheckRegistry` and registers itself — WITHOUT importing this
+// module. That keeps every edge one-way: features know the registry, the
+// doctor knows no feature. Importing a feature module here instead would put
+// the doctor in the middle of every module graph in the application.
+//
+// This module imports nothing of the app. The checks live in the app's owning
+// modules, under `<module>/doctor/`, and reach their services through those
+// modules' own providers. The route's access check comes from the app's host
+// (`options.host`); without one, `forRoot` throws: the route is never public.
+// =============================================================================
+/**
+ * The permission `GET /api/admin/doctor` requires unless an app passes another:
+ * the existing `system_settings:read`. The report describes the deployment's
+ * configuration, which is exactly what that permission already covers, and
+ * every check is read-only, so there is no new capability to grant (no
+ * `doctor:read`). A web settings card reaching the route must declare this same
+ * literal (Settings UI Pattern rule 3).
+ *
+ * @stability stable
+ */
+exports.DEFAULT_DOCTOR_PERMISSION = 'system_settings:read';
+/**
+ * The route path under the app's global prefix unless an app passes another.
+ *
+ * @stability stable
+ */
+exports.DEFAULT_DOCTOR_PATH = 'admin/doctor';
+function invalid(why) {
+    throw new Error(`DoctorModule.forRoot: ${why}.`);
+}
+function positive(value, name, fallback) {
+    if (value === undefined)
+        return fallback;
+    if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0)
+        invalid(`\`${name}\` must be a positive number of milliseconds`);
+    return value;
+}
+/** Validates the options and applies every default. */
+function resolveOptions(options) {
+    if (!options || typeof options !== 'object' || options.host === undefined || options.host === null) {
+        invalid('`host` is required (pass the app\'s definePlatformHost(...)). Without it the doctor route would have ' +
+            'no access check, and the route is never public');
+    }
+    const host = (0, index_1.definePlatformHost)(options.host);
+    const permission = options.permission ?? exports.DEFAULT_DOCTOR_PERMISSION;
+    if (typeof permission !== 'string' || permission.trim() === '')
+        invalid('`permission` must be a non-empty string');
+    const path = options.path ?? exports.DEFAULT_DOCTOR_PATH;
+    if (typeof path !== 'string' || path.trim() === '')
+        invalid('`path` must be a non-empty string');
+    const categoryOrder = options.categoryOrder ?? doctor_check_interface_1.PLATFORM_DOCTOR_CATEGORIES;
+    if (!Array.isArray(categoryOrder) || categoryOrder.some((c) => typeof c !== 'string' || c === '')) {
+        invalid('`categoryOrder` must be an array of non-empty strings');
+    }
+    return Object.freeze({
+        host,
+        permission,
+        path,
+        categoryOrder: Object.freeze([...categoryOrder]),
+        defaultTimeoutMs: positive(options.defaultTimeoutMs, 'defaultTimeoutMs', doctor_service_1.DOCTOR_DEFAULT_TIMEOUT_MS),
+        cacheTtlMs: positive(options.cacheTtlMs, 'cacheTtlMs', doctor_service_1.DOCTOR_CACHE_TTL_MS),
+        supportBundle: (0, support_bundle_options_1.resolveSupportBundleOptions)(options.supportBundle, invalid),
+    });
+}
+/**
+ * The admin Doctor: `GET /api/admin/doctor`, the check registry and the
+ * service that runs it. Import it once, with {@link DoctorModule.forRoot}.
+ *
+ * @stability stable
+ */
+let DoctorModule = DoctorModule_1 = class DoctorModule {
+    /**
+     * The Doctor, configured for one app: a global module providing
+     * `DoctorCheckRegistry`, `DoctorService`, `DOCTOR_MODULE_OPTIONS`,
+     * `EgressRegistry`, `SupportBundleRegistry` and `SupportBundleService`, with
+     * the Doctor's and the support bundle's controllers created from the app's
+     * host access decorators. The built-in `meta`, `doctor` and `egress` bundle
+     * sections register themselves.
+     *
+     * @param options - see {@link DoctorModuleOptions}; `host` is required.
+     * @returns the dynamic module to import in the app's root module.
+     * @throws Error when `host` is missing or invalid (the route is never
+     *   public), or an option is malformed.
+     *
+     * @example
+     * ```ts
+     * // apps/api/src/doctor/doctor.config.ts
+     * export const doctorModule = DoctorModule.forRoot({ host: platformHost });
+     * ```
+     *
+     * @extensionPoint option
+     */
+    static forRoot(options) {
+        const resolved = resolveOptions(options);
+        const bundle = resolved.supportBundle.enabled;
+        return {
+            global: true,
+            module: DoctorModule_1,
+            controllers: [(0, doctor_controller_factory_1.createDoctorController)(resolved), ...(bundle ? [(0, support_bundle_controller_1.createSupportBundleController)(resolved)] : [])],
+            providers: [
+                { provide: doctor_options_1.DOCTOR_MODULE_OPTIONS, useValue: resolved },
+                doctor_check_registry_1.DoctorCheckRegistry,
+                doctor_service_1.DoctorService,
+                // The egress inventory (#773): the registry every module's contributor
+                // registers with. The `network.egress` check that reads it is the
+                // app's to provide (`NetworkEgressDoctorCheck`), like every check.
+                egress_registry_1.EgressRegistry,
+                support_bundle_registry_1.SupportBundleRegistry,
+                ...(bundle
+                    ? [support_bundle_service_1.SupportBundleService, meta_section_1.MetaSupportBundleSection, doctor_section_1.DoctorSupportBundleSection, egress_section_1.EgressSupportBundleSection]
+                    : []),
+            ],
+            exports: [
+                doctor_check_registry_1.DoctorCheckRegistry,
+                doctor_service_1.DoctorService,
+                doctor_options_1.DOCTOR_MODULE_OPTIONS,
+                egress_registry_1.EgressRegistry,
+                support_bundle_registry_1.SupportBundleRegistry,
+                ...(bundle ? [support_bundle_service_1.SupportBundleService] : []),
+            ],
+        };
+    }
+};
+exports.DoctorModule = DoctorModule;
+exports.DoctorModule = DoctorModule = DoctorModule_1 = __decorate([
+    (0, common_1.Module)({})
+], DoctorModule);
+//# sourceMappingURL=doctor.module.js.map

package/dist/doctor/doctor.module.js.map

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

package/dist/doctor/doctor.options.d.ts

@@ -0,0 +1,39 @@
+import type { PlatformHost } from '../core/index';
+import type { ResolvedSupportBundleOptions } from './support-bundle/support-bundle.options';
+/**
+ * Injection token of the Doctor's resolved options ({@link ResolvedDoctorModuleOptions}).
+ * Inject it in a provider of the app that needs the configured permission,
+ * path, category order, timeout or cache TTL.
+ *
+ * @example
+ * ```ts
+ * constructor(@Inject(DOCTOR_MODULE_OPTIONS) private readonly doctor: ResolvedDoctorModuleOptions) {}
+ * ```
+ *
+ * @extensionPoint token
+ * @stability experimental
+ */
+export declare const DOCTOR_MODULE_OPTIONS: unique symbol;
+/**
+ * `DoctorModuleOptions` with every default applied, as `DoctorModule.forRoot`
+ * provides it under {@link DOCTOR_MODULE_OPTIONS}.
+ *
+ * @stability experimental
+ */
+export interface ResolvedDoctorModuleOptions {
+    /** The validated, frozen platform host. */
+    readonly host: PlatformHost;
+    /** The permission `GET <path>` requires. */
+    readonly permission: string;
+    /** The route path under the global prefix. */
+    readonly path: string;
+    /** Category display and sort order. */
+    readonly categoryOrder: readonly string[];
+    /** Per-check ceiling when a check declares none, in milliseconds. */
+    readonly defaultTimeoutMs: number;
+    /** How long a report is served from memory, in milliseconds. */
+    readonly cacheTtlMs: number;
+    /** The support bundle's resolved options (`GET <path>/support-bundle`). */
+    readonly supportBundle: ResolvedSupportBundleOptions;
+}
+//# sourceMappingURL=doctor.options.d.ts.map

package/dist/doctor/doctor.options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.options.d.ts","sourceRoot":"","sources":["../../src/doctor/doctor.options.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AAE5F;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAO,MAAwE,CAAC;AAEpH;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,qEAAqE;IACrE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,gEAAgE;IAChE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,EAAE,4BAA4B,CAAC;CACtD"}

package/dist/doctor/doctor.options.js

@@ -0,0 +1,21 @@
+"use strict";
+// The Doctor module's resolved options and their injection token (issue #696).
+// Kept apart from doctor.module.ts so the service and the controller factory
+// can read them without importing the module that imports them.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DOCTOR_MODULE_OPTIONS = void 0;
+/**
+ * Injection token of the Doctor's resolved options ({@link ResolvedDoctorModuleOptions}).
+ * Inject it in a provider of the app that needs the configured permission,
+ * path, category order, timeout or cache TTL.
+ *
+ * @example
+ * ```ts
+ * constructor(@Inject(DOCTOR_MODULE_OPTIONS) private readonly doctor: ResolvedDoctorModuleOptions) {}
+ * ```
+ *
+ * @extensionPoint token
+ * @stability experimental
+ */
+exports.DOCTOR_MODULE_OPTIONS = Symbol.for('@marinoscar/platform/doctor/DOCTOR_MODULE_OPTIONS');
+//# sourceMappingURL=doctor.options.js.map

package/dist/doctor/doctor.options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.options.js","sourceRoot":"","sources":["../../src/doctor/doctor.options.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,6EAA6E;AAC7E,gEAAgE;;;AAKhE;;;;;;;;;;;;GAYG;AACU,QAAA,qBAAqB,GAAkB,MAAM,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC"}