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

package/dist/telemetry/stack/telemetry-stack-deploy.handler.js

@@ -0,0 +1,160 @@
+"use strict";
+// =============================================================================
+// `telemetry.stack.deploy` job handler (issue #567, epic #528)
+// =============================================================================
+//
+// Asks the VPS `stack-agent` sidecar to start the telemetry services
+// (GreptimeDB and the OTel collector) — `POST /v1/telemetry/up` — and records
+// what it said. Enqueued only by `POST /api/admin/telemetry/stack/deploy`
+// ("Deploy GreptimeDB" on /admin/settings/telemetry).
+//
+// A JOB, NOT AN HTTP CALL: the agent may pull images, which can take up to
+// ten minutes — far longer than an admin request may stay open (CLAUDE.md,
+// queue rule 1). The admin page polls `GET /api/admin/telemetry/stack`, which
+// reads this job's row.
+//
+// SINGLE-FLIGHT: enqueued with no subject, so its dedup key is constant for the
+// type and `jobs_active_dedup_uniq_idx` guarantees at most one pending/running
+// deploy; a second click returns the job already in flight.
+//
+// THE RESULT is written onto the job's own `payload.result` as
+// `{ ok, exitCode, output }` — `output` capped at `STACK_DEPLOY_OUTPUT_MAX_BYTES`,
+// keeping the TAIL (where compose prints what went wrong). A failure is also
+// thrown, so the row ends `failed` with the reason in `lastError`.
+//
+// NEVER AUTO-RETRIED (`maxAttempts: 1`): a failed `up` is a deployment problem
+// an administrator must read, and re-running a ten-minute pull on the queue's
+// retry budget would only hide it.
+//
+// SERVER-ONLY, PERMANENTLY: no `nodeResultSchema`/`persistNodeResult`. The
+// stack-agent listens only on the deployment's internal network, which a
+// worker node cannot reach, and its bearer token controls the host's Docker
+// daemon — a node must never hold it (CLAUDE.md, queue rule 3). Do not add a
+// `nodeSecretBroker` either.
+//
+// AFTER A SUCCESSFUL DEPLOY the telemetry connection is nudged so the admin
+// page turns green on its next poll: the connection snapshot is re-read, the
+// export gate re-applied, and a `telemetry.retention.apply` job queued (a new
+// GreptimeDB has no TTL yet). All best effort — none can fail the deploy.
+// =============================================================================
+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); }
+};
+var TelemetryStackDeployHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryStackDeployHandler = exports.STACK_DEPLOY_OUTPUT_MAX_BYTES = exports.TELEMETRY_STACK_DEPLOY_TYPE = void 0;
+exports.capOutput = capOutput;
+const common_1 = require("@nestjs/common");
+const ports_1 = require("../ports");
+const telemetry_connection_service_1 = require("../connection/telemetry-connection.service");
+const telemetry_retention_handler_1 = require("../handlers/telemetry-retention.handler");
+const telemetry_settings_service_1 = require("../telemetry-settings.service");
+const stack_agent_client_1 = require("./stack-agent.client");
+/**
+ * The job type. PERMANENT once rows of it exist.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_STACK_DEPLOY_TYPE = 'telemetry.stack.deploy';
+/** Cap on the stored agent output, in UTF-8 bytes. */
+exports.STACK_DEPLOY_OUTPUT_MAX_BYTES = 4096;
+/**
+ * The last `maxBytes` bytes of `output` (UTF-8), prefixed with an ellipsis
+ * line when anything was cut. Never splits a multi-byte character.
+ */
+function capOutput(output, maxBytes = exports.STACK_DEPLOY_OUTPUT_MAX_BYTES) {
+    const bytes = Buffer.from(output, 'utf8');
+    if (bytes.length <= maxBytes)
+        return output;
+    const marker = '…(truncated)\n';
+    const budget = maxBytes - Buffer.byteLength(marker, 'utf8');
+    let tail = bytes.subarray(bytes.length - budget);
+    // Skip UTF-8 continuation bytes (10xxxxxx) so the tail starts on a character.
+    let skip = 0;
+    while (skip < tail.length && (tail[skip] & 0xc0) === 0x80)
+        skip += 1;
+    tail = tail.subarray(skip);
+    return marker + tail.toString('utf8');
+}
+let TelemetryStackDeployHandler = TelemetryStackDeployHandler_1 = class TelemetryStackDeployHandler {
+    agent;
+    jobs;
+    connection;
+    settings;
+    logger = new common_1.Logger(TelemetryStackDeployHandler_1.name);
+    type = exports.TELEMETRY_STACK_DEPLOY_TYPE;
+    label = 'Telemetry services deploy';
+    /** An image pull can take ten minutes; never retried automatically. */
+    profile = { maxRuntimeMs: 15 * 60 * 1000, maxAttempts: 1 };
+    // Deliberately NO `nodeResultSchema` / `persistNodeResult` — see the header.
+    constructor(agent, jobs, connection, settings) {
+        this.agent = agent;
+        this.jobs = jobs;
+        this.connection = connection;
+        this.settings = settings;
+    }
+    onModuleInit() {
+        this.jobs.registerHandler(this);
+    }
+    /** Throws to fail; the row's `payload.result` is written either way when the agent answered. */
+    async process(job) {
+        const outcome = await this.agent.telemetryUp();
+        if (!outcome.ok) {
+            if (outcome.error === 'failed') {
+                await this.recordResult(job, {
+                    ok: false,
+                    exitCode: outcome.exitCode ?? null,
+                    output: capOutput(outcome.output ?? ''),
+                });
+            }
+            throw new Error(`Deploying the telemetry services failed (${outcome.error}): ${outcome.message}`);
+        }
+        await this.recordResult(job, { ok: true, exitCode: outcome.exitCode, output: capOutput(outcome.output) });
+        this.logger.log(`Telemetry services started by stack-agent (job ${job.id})`);
+        await this.nudgeTelemetry();
+    }
+    /** Merges `result` into the job's own payload. Best effort: never fails the job by itself. */
+    async recordResult(job, result) {
+        const base = job.payload && typeof job.payload === 'object' && !Array.isArray(job.payload)
+            ? job.payload
+            : {};
+        try {
+            await this.jobs.updatePayload(job.id, { ...base, result: { ...result } });
+        }
+        catch (error) {
+            this.logger.warn(`Could not record the deploy result on job ${job.id}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /** So the admin page turns green quickly. See the header; nothing here may throw. */
+    async nudgeTelemetry() {
+        try {
+            await this.connection.refreshSafely();
+            await this.settings.refreshGate();
+        }
+        catch (error) {
+            this.logger.warn(`Telemetry refresh after deploy failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        await this.jobs.enqueueHousekeepingJob({
+            logger: this.logger,
+            type: telemetry_retention_handler_1.TELEMETRY_RETENTION_TYPE,
+            what: 'telemetry retention',
+        });
+    }
+};
+exports.TelemetryStackDeployHandler = TelemetryStackDeployHandler;
+exports.TelemetryStackDeployHandler = TelemetryStackDeployHandler = TelemetryStackDeployHandler_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Inject)(ports_1.TELEMETRY_JOBS)),
+    __metadata("design:paramtypes", [stack_agent_client_1.StackAgentClient, Object, telemetry_connection_service_1.TelemetryConnectionService,
+        telemetry_settings_service_1.TelemetrySettingsService])
+], TelemetryStackDeployHandler);
+//# sourceMappingURL=telemetry-stack-deploy.handler.js.map

package/dist/telemetry/stack/telemetry-stack-deploy.handler.js.map

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

package/dist/telemetry/stack/telemetry-stack.controller.d.ts

@@ -0,0 +1,14 @@
+import { Type } from '@nestjs/common';
+import type { ResolvedTelemetryModuleOptions } from '../telemetry.options';
+/**
+ * Creates the `TelemetryStackController` class for one set of module options: its routes
+ * guarded by the app's access decorators (`options.host.access`), the caller
+ * resolved by `options.actorId`. `TelemetryModule.forRoot()` calls it.
+ *
+ * @param options - the resolved module options.
+ * @returns the controller class.
+ *
+ * @stability experimental
+ */
+export declare function createTelemetryStackController(options: ResolvedTelemetryModuleOptions): Type<unknown>;
+//# sourceMappingURL=telemetry-stack.controller.d.ts.map

package/dist/telemetry/stack/telemetry-stack.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-stack.controller.d.ts","sourceRoot":"","sources":["../../../src/telemetry/stack/telemetry-stack.controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuD,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAM3F,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AAiB3E;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,8BAA8B,GAAG,IAAI,CAAC,OAAO,CAAC,CAiDrG"}

package/dist/telemetry/stack/telemetry-stack.controller.js

@@ -0,0 +1,107 @@
+"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 __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.createTelemetryStackController = createTelemetryStackController;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const index_1 = require("../../core/index");
+const telemetry_stack_dto_1 = require("./dto/telemetry-stack.dto");
+const telemetry_stack_service_1 = require("./telemetry-stack.service");
+const telemetry_permissions_1 = require("../telemetry.permissions");
+// =============================================================================
+// TelemetryStackController (issue #567, epic #528)
+// =============================================================================
+//
+//   GET  /api/admin/telemetry/stack          system_settings:read
+//   POST /api/admin/telemetry/stack/deploy   system_settings:write  (202, idempotent)
+//
+// WHY `system_settings:*` AND NOT `telemetry:*`: starting containers on the
+// host through the stack-agent is a DEPLOYMENT action, not a telemetry policy
+// edit — the same reach as the rest of the deployment-wide system settings.
+// The Telemetry services section of /admin/settings/telemetry gates its
+// content and its "Deploy GreptimeDB" button on these exact strings.
+// =============================================================================
+/**
+ * Creates the `TelemetryStackController` class for one set of module options: its routes
+ * guarded by the app's access decorators (`options.host.access`), the caller
+ * resolved by `options.actorId`. `TelemetryModule.forRoot()` calls it.
+ *
+ * @param options - the resolved module options.
+ * @returns the controller class.
+ *
+ * @stability experimental
+ */
+function createTelemetryStackController(options) {
+    const access = options.host.access;
+    const ActorId = options.actorIdParam;
+    let TelemetryStackController = class TelemetryStackController {
+        stack;
+        constructor(stack) {
+            this.stack = stack;
+        }
+        async getStatus() {
+            return this.stack.getStatus();
+        }
+        async deploy(userId) {
+            return this.stack.deploy(userId);
+        }
+    };
+    __decorate([
+        (0, common_1.Get)(),
+        (access.requirePermissions([telemetry_permissions_1.TELEMETRY_HOST_PERMISSIONS.SYSTEM_SETTINGS_READ])),
+        (0, swagger_1.ApiOperation)({
+            summary: 'Get the telemetry services status (Admin only)',
+            description: 'The state of each telemetry container (GreptimeDB, the OTel collector) as reported by the ' +
+                'deployment\'s stack agent, and the most recent `telemetry.stack.deploy` job.\n\n' +
+                '**Always 200.** `agent` is `available` (the agent answered), `unavailable` (configured ' +
+                'but unreachable within five seconds, or an unexpected answer), `unauthorized` (it refused ' +
+                'the API\'s token) or `not_configured` (this deployment has no stack agent). `agentError` ' +
+                'says why the agent is `unavailable` or `unauthorized` (never the token), else null. `services` is ' +
+                'empty unless `agent` is `available`. `deploy` is null when no deploy was ever requested; ' +
+                '`deploy.output` is the tail (at most 4 KB) of what the agent printed.',
+        }),
+        (0, swagger_1.ApiResponse)({ status: 200, description: 'The telemetry services status', type: telemetry_stack_dto_1.TelemetryStackStatusDto }),
+        __metadata("design:type", Function),
+        __metadata("design:paramtypes", []),
+        __metadata("design:returntype", Promise)
+    ], TelemetryStackController.prototype, "getStatus", null);
+    __decorate([
+        (0, common_1.Post)('deploy'),
+        (access.requirePermissions([telemetry_permissions_1.TELEMETRY_HOST_PERMISSIONS.SYSTEM_SETTINGS_WRITE])),
+        (0, common_1.HttpCode)(common_1.HttpStatus.ACCEPTED),
+        (0, swagger_1.ApiOperation)({
+            summary: 'Deploy the telemetry services (Admin only)',
+            description: 'Queues a `telemetry.stack.deploy` job, which asks the stack agent to start GreptimeDB and ' +
+                'the OTel collector (pulling their images if needed — up to ten minutes), and returns at ' +
+                'once with **202**. Poll `GET /api/admin/telemetry/stack` for `deploy.status`.\n\n' +
+                '**Idempotent:** while a deploy is pending or running, the call returns that job\'s id ' +
+                'instead of queueing another. **409** with `details.reason` `STACK_AGENT_NOT_CONFIGURED` ' +
+                'when this deployment has no stack agent.',
+        }),
+        (0, swagger_1.ApiResponse)({ status: 202, description: 'The deploy job (new, or the one already in flight)', type: telemetry_stack_dto_1.TelemetryStackDeployStartedDto }),
+        (0, swagger_1.ApiResponse)({ status: 409, description: '`STACK_AGENT_NOT_CONFIGURED`', type: index_1.ErrorDto }),
+        __param(0, ActorId()),
+        __metadata("design:type", Function),
+        __metadata("design:paramtypes", [String]),
+        __metadata("design:returntype", Promise)
+    ], TelemetryStackController.prototype, "deploy", null);
+    TelemetryStackController = __decorate([
+        (0, swagger_1.ApiTags)('Telemetry'),
+        (0, common_1.Controller)('admin/telemetry/stack'),
+        __param(0, (0, common_1.Inject)(telemetry_stack_service_1.TelemetryStackService)),
+        __metadata("design:paramtypes", [telemetry_stack_service_1.TelemetryStackService])
+    ], TelemetryStackController);
+    return TelemetryStackController;
+}
+//# sourceMappingURL=telemetry-stack.controller.js.map

package/dist/telemetry/stack/telemetry-stack.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-stack.controller.js","sourceRoot":"","sources":["../../../src/telemetry/stack/telemetry-stack.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAiCA,wEAiDC;AAlFD,2CAA2F;AAC3F,6CAAqE;AAErE,4CAA4C;AAC5C,mEAAoG;AACpG,uEAAkE;AAElE,oEAAsE;AAEtE,gFAAgF;AAChF,mDAAmD;AACnD,gFAAgF;AAChF,EAAE;AACF,kEAAkE;AAClE,sFAAsF;AACtF,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,4EAA4E;AAC5E,wEAAwE;AACxE,qEAAqE;AACrE,gFAAgF;AAEhF;;;;;;;;;GASG;AACH,SAAgB,8BAA8B,CAAC,OAAuC;IACpF,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;IACnC,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;IAErC,IAEM,wBAAwB,GAF9B,MAEM,wBAAwB;QACgC;QAA5D,YAA4D,KAA4B;YAA5B,UAAK,GAAL,KAAK,CAAuB;QAAG,CAAC;QAiBtF,AAAN,KAAK,CAAC,SAAS;YACb,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QAChC,CAAC;QAiBK,AAAN,KAAK,CAAC,MAAM,CAAY,MAAc;YACpC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;KACF,CAAA;IAtBO;QAfL,IAAA,YAAG,GAAE;QACL,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,kDAA0B,CAAC,oBAAoB,CAAC,CAAC,CAAC;QAC9E,IAAA,sBAAY,EAAC;YACZ,OAAO,EAAE,gDAAgD;YACzD,WAAW,EACT,4FAA4F;gBAC5F,kFAAkF;gBAClF,yFAAyF;gBACzF,4FAA4F;gBAC5F,2FAA2F;gBAC3F,oGAAoG;gBACpG,2FAA2F;gBAC3F,uEAAuE;SAC1E,CAAC;QACD,IAAA,qBAAW,EAAC,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,+BAA+B,EAAE,IAAI,EAAE,6CAAuB,EAAE,CAAC;;;;6DAGzG;IAiBK;QAfL,IAAA,aAAI,EAAC,QAAQ,CAAC;QACd,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,kDAA0B,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAC/E,IAAA,iBAAQ,EAAC,mBAAU,CAAC,QAAQ,CAAC;QAC7B,IAAA,sBAAY,EAAC;YACZ,OAAO,EAAE,4CAA4C;YACrD,WAAW,EACT,4FAA4F;gBAC5F,0FAA0F;gBAC1F,mFAAmF;gBACnF,wFAAwF;gBACxF,0FAA0F;gBAC1F,0CAA0C;SAC7C,CAAC;QACD,IAAA,qBAAW,EAAC,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,oDAAoD,EAAE,IAAI,EAAE,oDAA8B,EAAE,CAAC;QACrI,IAAA,qBAAW,EAAC,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,8BAA8B,EAAE,IAAI,EAAE,gBAAQ,EAAE,CAAC;QAC5E,WAAA,OAAO,EAAE,CAAA;;;;0DAEtB;IAvCG,wBAAwB;QAF7B,IAAA,iBAAO,EAAC,WAAW,CAAC;QACpB,IAAA,mBAAU,EAAC,uBAAuB,CAAC;QAErB,WAAA,IAAA,eAAM,EAAC,+CAAqB,CAAC,CAAA;yCAAyB,+CAAqB;OADpF,wBAAwB,CAwC7B;IAED,OAAO,wBAAwB,CAAC;AAClC,CAAC"}

package/dist/telemetry/stack/telemetry-stack.service.d.ts

@@ -0,0 +1,19 @@
+import { type TelemetryAuditSink, type TelemetryJobRecord, type TelemetryJobsPort } from '../ports';
+import type { TelemetryStackDeploy, TelemetryStackStatus } from './dto/telemetry-stack.dto';
+import { StackAgentClient } from './stack-agent.client';
+export declare const TELEMETRY_STACK_DEPLOY_AUDIT_ACTION = "telemetry:stack_deploy";
+export declare class TelemetryStackService {
+    private readonly agent;
+    private readonly jobs;
+    private readonly auditSink;
+    private readonly logger;
+    constructor(agent: StackAgentClient, jobs: TelemetryJobsPort, auditSink: TelemetryAuditSink);
+    getStatus(): Promise<TelemetryStackStatus>;
+    /** Queues a deploy (or returns the one in flight) and audits the request. */
+    deploy(userId: string): Promise<{
+        jobId: string;
+    }>;
+}
+/** The API shape of one deploy job. `output` comes from the handler's `payload.result`. */
+export declare function toDeploy(job: Pick<TelemetryJobRecord, 'id' | 'status' | 'createdAt' | 'finishedAt' | 'lastError' | 'payload'>): TelemetryStackDeploy;
+//# sourceMappingURL=telemetry-stack.service.d.ts.map

package/dist/telemetry/stack/telemetry-stack.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-stack.service.d.ts","sourceRoot":"","sources":["../../../src/telemetry/stack/telemetry-stack.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAA4B,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAoBxD,eAAO,MAAM,mCAAmC,2BAA2B,CAAC;AAE5E,qBACa,qBAAqB;IAI9B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACE,OAAO,CAAC,QAAQ,CAAC,IAAI;IACf,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;gBAG9C,KAAK,EAAE,gBAAgB,EACC,IAAI,EAAE,iBAAiB,EACjB,SAAS,EAAE,kBAAkB;IAGxE,SAAS,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAwBhD,6EAA6E;IACvE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CA+BzD;AAED,2FAA2F;AAC3F,wBAAgB,QAAQ,CACtB,GAAG,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,CAAC,GACpG,oBAAoB,CActB"}

package/dist/telemetry/stack/telemetry-stack.service.js

@@ -0,0 +1,122 @@
+"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 __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); }
+};
+var TelemetryStackService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryStackService = exports.TELEMETRY_STACK_DEPLOY_AUDIT_ACTION = void 0;
+exports.toDeploy = toDeploy;
+const common_1 = require("@nestjs/common");
+const ports_1 = require("../ports");
+const stack_agent_client_1 = require("./stack-agent.client");
+const telemetry_stack_deploy_handler_1 = require("./telemetry-stack-deploy.handler");
+// =============================================================================
+// TelemetryStackService — GET /api/admin/telemetry/stack and
+// POST /api/admin/telemetry/stack/deploy (issue #567, epic #528)
+// =============================================================================
+//
+// The status read asks the stack-agent for each telemetry container's state
+// (bounded to five seconds) and reads the most recent deploy job. It always
+// answers: an agent that is missing, unreachable or refusing the token is a
+// state, not an error.
+//
+// The deploy enqueues `telemetry.stack.deploy` — never calls the agent inline
+// (an image pull can take ten minutes). The job has no subject, so the queue's
+// active-dedup index makes the enqueue idempotent: while one is pending or
+// running, the call returns that job. Refused with 409 when this deployment
+// has no stack-agent, since the job could only fail.
+// =============================================================================
+exports.TELEMETRY_STACK_DEPLOY_AUDIT_ACTION = 'telemetry:stack_deploy';
+let TelemetryStackService = TelemetryStackService_1 = class TelemetryStackService {
+    agent;
+    jobs;
+    auditSink;
+    logger = new common_1.Logger(TelemetryStackService_1.name);
+    constructor(agent, jobs, auditSink) {
+        this.agent = agent;
+        this.jobs = jobs;
+        this.auditSink = auditSink;
+    }
+    async getStatus() {
+        const [status, latest] = await Promise.all([
+            this.agent.telemetryStatus(),
+            this.jobs.findLatest(telemetry_stack_deploy_handler_1.TELEMETRY_STACK_DEPLOY_TYPE),
+        ]);
+        let agent;
+        if (status.ok) {
+            agent = 'available';
+        }
+        else if (status.error === 'not_configured' || status.error === 'unauthorized') {
+            agent = status.error;
+        }
+        else {
+            agent = 'unavailable';
+        }
+        return {
+            agent,
+            // The client's message: origin and failure, never the token.
+            agentError: !status.ok && (agent === 'unavailable' || agent === 'unauthorized') ? status.message : null,
+            services: status.ok ? status.services : [],
+            deploy: latest ? toDeploy(latest) : null,
+        };
+    }
+    /** Queues a deploy (or returns the one in flight) and audits the request. */
+    async deploy(userId) {
+        if (!this.agent.isConfigured()) {
+            throw new common_1.ConflictException({
+                message: 'GreptimeDB cannot be deployed from here: this deployment has no stack agent ' +
+                    '(STACK_AGENT_URL and STACK_AGENT_TOKEN are not set).',
+                details: { reason: 'STACK_AGENT_NOT_CONFIGURED' },
+            });
+        }
+        const job = await this.jobs.enqueue({
+            type: telemetry_stack_deploy_handler_1.TELEMETRY_STACK_DEPLOY_TYPE,
+            // A person asking for the stack to be (re)started.
+            reason: 'rerun',
+            // GLOBAL — no subject — so the dedup key is constant for the type and
+            // at most one deploy is ever pending or running.
+            payload: { requestedByUserId: userId },
+        });
+        await this.auditSink.record({
+            actorUserId: userId,
+            action: exports.TELEMETRY_STACK_DEPLOY_AUDIT_ACTION,
+            targetType: 'job',
+            targetId: job.id,
+            meta: { type: telemetry_stack_deploy_handler_1.TELEMETRY_STACK_DEPLOY_TYPE, status: job.status },
+        });
+        this.logger.log(`Telemetry stack deploy requested by ${userId} (job ${job.id}, ${job.status})`);
+        return { jobId: job.id };
+    }
+};
+exports.TelemetryStackService = TelemetryStackService;
+exports.TelemetryStackService = TelemetryStackService = TelemetryStackService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Inject)(ports_1.TELEMETRY_JOBS)),
+    __param(2, (0, common_1.Inject)(ports_1.TELEMETRY_AUDIT_SINK)),
+    __metadata("design:paramtypes", [stack_agent_client_1.StackAgentClient, Object, Object])
+], TelemetryStackService);
+/** The API shape of one deploy job. `output` comes from the handler's `payload.result`. */
+function toDeploy(job) {
+    const payload = job.payload;
+    const output = payload && typeof payload === 'object' ? payload.result?.output : undefined;
+    return {
+        jobId: job.id,
+        // The queue's own status strings (`JobStatus`), which the wire enum mirrors.
+        status: job.status,
+        createdAt: job.createdAt.toISOString(),
+        finishedAt: job.finishedAt ? job.finishedAt.toISOString() : null,
+        // A succeeded job's `lastError` is history from an earlier attempt, not its outcome.
+        error: job.status === 'succeeded' ? null : (job.lastError ?? null),
+        output: typeof output === 'string' ? output : null,
+    };
+}
+//# sourceMappingURL=telemetry-stack.service.js.map

package/dist/telemetry/stack/telemetry-stack.service.js.map

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

package/dist/telemetry/stores/dto/telemetry-store.dto.d.ts

@@ -0,0 +1,73 @@
+import { telemetryStoreResponseSchema, telemetryStoreSummarySchema, updateTelemetryStoreSchema } from '@marinoscar/platform-contract/telemetry';
+export { telemetryStoreResponseSchema, telemetryStoreSummarySchema, updateTelemetryStoreSchema };
+export type { TelemetryStoreResponse, TelemetryStoreSummary, UpdateTelemetryStoreInput, } from '@marinoscar/platform-contract/telemetry';
+declare const TelemetryStoreResponseDto_base: import("nestjs-zod").ZodDto<import("zod").ZodObject<{
+    active: import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        label: import("zod").ZodString;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    stores: import("zod").ZodArray<import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        label: import("zod").ZodString;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+    descriptor: import("zod").ZodNullable<import("zod").ZodObject<{
+        kind: import("zod").ZodString;
+        id: import("zod").ZodString;
+        label: import("zod").ZodString;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+        fields: import("zod").ZodArray<import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+            kind: import("zod").ZodLiteral<"boolean">;
+            name: import("zod").ZodString;
+            label: import("zod").ZodString;
+            help: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            kind: import("zod").ZodLiteral<"enum">;
+            options: import("zod").ZodArray<import("zod").ZodString>;
+            name: import("zod").ZodString;
+            label: import("zod").ZodString;
+            help: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            kind: import("zod").ZodLiteral<"number">;
+            min: import("zod").ZodOptional<import("zod").ZodNumber>;
+            max: import("zod").ZodOptional<import("zod").ZodNumber>;
+            integer: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            name: import("zod").ZodString;
+            label: import("zod").ZodString;
+            help: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            kind: import("zod").ZodLiteral<"string">;
+            maxLength: import("zod").ZodOptional<import("zod").ZodNumber>;
+            name: import("zod").ZodString;
+            label: import("zod").ZodString;
+            help: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            kind: import("zod").ZodLiteral<"other">;
+            name: import("zod").ZodString;
+            label: import("zod").ZodString;
+            help: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            kind: import("zod").ZodLiteral<"secret">;
+            hasValue: import("zod").ZodBoolean;
+            required: import("zod").ZodBoolean;
+            name: import("zod").ZodString;
+            label: import("zod").ZodString;
+            help: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>], "kind">>;
+    }, import("zod/v4/core").$strip>>;
+    settings: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+    ready: import("zod").ZodBoolean;
+    error: import("zod").ZodNullable<import("zod").ZodString>;
+    version: import("zod").ZodNumber;
+    updatedAt: import("zod").ZodNullable<import("zod").ZodISODateTime>;
+}, import("zod/v4/core").$strip>, false>;
+export declare class TelemetryStoreResponseDto extends TelemetryStoreResponseDto_base {
+}
+declare const UpdateTelemetryStoreDto_base: import("nestjs-zod").ZodDto<import("zod").ZodObject<{
+    settings: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+    secrets: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNullable<import("zod").ZodString>>>;
+}, import("zod/v4/core").$strip>, false>;
+export declare class UpdateTelemetryStoreDto extends UpdateTelemetryStoreDto_base {
+}
+//# sourceMappingURL=telemetry-store.dto.d.ts.map

package/dist/telemetry/stores/dto/telemetry-store.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-store.dto.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/stores/dto/telemetry-store.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,yCAAyC,CAAC;AAYjD,OAAO,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,CAAC;AACjG,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,yCAAyC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEjD,qBAAa,yBAA0B,SAAQ,8BAA0C;CAAG;;;;;AAC5F,qBAAa,uBAAwB,SAAQ,4BAAwC;CAAG"}

package/dist/telemetry/stores/dto/telemetry-store.dto.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateTelemetryStoreDto = exports.TelemetryStoreResponseDto = exports.updateTelemetryStoreSchema = exports.telemetryStoreSummarySchema = exports.telemetryStoreResponseSchema = void 0;
+const nestjs_zod_1 = require("nestjs-zod");
+const telemetry_1 = require("@marinoscar/platform-contract/telemetry");
+Object.defineProperty(exports, "telemetryStoreResponseSchema", { enumerable: true, get: function () { return telemetry_1.telemetryStoreResponseSchema; } });
+Object.defineProperty(exports, "telemetryStoreSummarySchema", { enumerable: true, get: function () { return telemetry_1.telemetryStoreSummarySchema; } });
+Object.defineProperty(exports, "updateTelemetryStoreSchema", { enumerable: true, get: function () { return telemetry_1.updateTelemetryStoreSchema; } });
+class TelemetryStoreResponseDto extends (0, nestjs_zod_1.createZodDto)(telemetry_1.telemetryStoreResponseSchema) {
+}
+exports.TelemetryStoreResponseDto = TelemetryStoreResponseDto;
+class UpdateTelemetryStoreDto extends (0, nestjs_zod_1.createZodDto)(telemetry_1.updateTelemetryStoreSchema) {
+}
+exports.UpdateTelemetryStoreDto = UpdateTelemetryStoreDto;
+//# sourceMappingURL=telemetry-store.dto.js.map

package/dist/telemetry/stores/dto/telemetry-store.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-store.dto.js","sourceRoot":"","sources":["../../../../src/telemetry/stores/dto/telemetry-store.dto.ts"],"names":[],"mappings":";;;AAAA,2CAA0C;AAE1C,uEAIiD;AAYxC,6GAfP,wCAA4B,OAeO;AAAE,4GAdrC,uCAA2B,OAcqC;AAAE,2GAblE,sCAA0B,OAakE;AAO9F,MAAa,yBAA0B,SAAQ,IAAA,yBAAY,EAAC,wCAA4B,CAAC;CAAG;AAA5F,8DAA4F;AAC5F,MAAa,uBAAwB,SAAQ,IAAA,yBAAY,EAAC,sCAA0B,CAAC;CAAG;AAAxF,0DAAwF"}

package/dist/telemetry/stores/greptime/greptime-host.d.ts

@@ -0,0 +1,44 @@
+/**
+ * How long a host lookup may take before it is treated as inconclusive.
+ *
+ * Deliberately far beyond Docker's ~5 s EAI_AGAIN retry window, and separate
+ * from `GREPTIME_CONNECT_TIMEOUT_MS`: the whole point is to outlast the
+ * resolver long enough to hear its verdict, which the connect timeout cannot.
+ * It only runs when the host is about to be (or was just) unreachable, so the
+ * wait costs nothing on a healthy connection.
+ */
+export declare const GREPTIME_DNS_TIMEOUT_MS = 15000;
+/** `getaddrinfo` / `dns` error codes that mean "no host by that name". */
+export declare const DNS_ERROR_CODES: ReadonlySet<string>;
+/** Resolves a host name; rejects with a `code`-carrying error when it cannot. */
+export type HostLookup = (host: string) => Promise<unknown>;
+/** Whether an error is a name-resolution failure (checks its `code`). */
+export declare function isDnsError(error: unknown): boolean;
+/**
+ * Whether the host being checked is the automatic (deployment) host or one the administrator typed.
+ *
+ * @stability experimental
+ */
+export interface HostCheckOptions {
+    /**
+     * `true` when the host is the deployment host an automatic (blank) host
+     * resolves to; `false` (the default) for a literal the administrator set.
+     */
+    automatic?: boolean;
+}
+/**
+ * The administrator-facing explanation of a DNS failure for `host`.
+ *
+ * ⚠ Shown in `/admin/settings/telemetry`. It must never tell an administrator
+ * to start compose files, edit files or run the CLI: GreptimeDB ships with
+ * every deployment, so an automatic host that does not resolve is fixed from
+ * this same page ("Deploy GreptimeDB" in its Telemetry services section, #567),
+ * and a custom one by correcting (or clearing) it.
+ */
+export declare function hostNotFoundMessage(host: string, error: unknown, options?: HostCheckOptions): string;
+/**
+ * Resolves `host` and returns a human message when it does not exist, else
+ * `null` (see the header for every `null` case). Never throws.
+ */
+export declare function checkHostResolves(host: string, lookup?: HostLookup, timeoutMs?: number, options?: HostCheckOptions): Promise<string | null>;
+//# sourceMappingURL=greptime-host.d.ts.map

package/dist/telemetry/stores/greptime/greptime-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"greptime-host.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/stores/greptime/greptime-host.ts"],"names":[],"mappings":"AA6BA;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAE9C,0EAA0E;AAC1E,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,CAM9C,CAAC;AAEH,iFAAiF;AACjF,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAI5D,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMlD;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM,CAexG;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,UAA0B,EAClC,SAAS,SAA0B,EACnC,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmCxB"}