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

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

@@ -0,0 +1,194 @@
+"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 TelemetryQueryService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryQueryService = exports.TELEMETRY_AUDIT_SQL_MAX = exports.TELEMETRY_QUERY_AUDIT_ACTIONS = void 0;
+exports.columnTypeName = columnTypeName;
+exports.toJsonSafe = toJsonSafe;
+const common_1 = require("@nestjs/common");
+const greptime_client_1 = require("../greptime/greptime.client");
+const ports_1 = require("../ports");
+const telemetry_settings_service_1 = require("../telemetry-settings.service");
+const sql_guard_1 = require("./sql-guard");
+const telemetry_availability_1 = require("./telemetry-availability");
+const telemetry_query_errors_1 = require("./telemetry-query.errors");
+/** Audit `action` per source. */
+exports.TELEMETRY_QUERY_AUDIT_ACTIONS = {
+    explorer: 'telemetry:query',
+    export: 'telemetry:export',
+    assistant: 'telemetry:assistant_query',
+};
+/** How much of the SQL text an audit row keeps. */
+exports.TELEMETRY_AUDIT_SQL_MAX = 4_000;
+/** PostgreSQL type OID → the simplified name the explorer shows. */
+const TYPE_NAMES = {
+    16: 'bool',
+    17: 'bytea',
+    20: 'int8',
+    21: 'int2',
+    23: 'int4',
+    25: 'text',
+    114: 'json',
+    700: 'float4',
+    701: 'float8',
+    1043: 'text',
+    1082: 'date',
+    1083: 'time',
+    1114: 'timestamp',
+    1184: 'timestamp',
+    1700: 'numeric',
+    3802: 'json',
+};
+function columnTypeName(dataTypeID) {
+    return TYPE_NAMES[dataTypeID] ?? 'unknown';
+}
+/**
+ * A wire value as something `JSON.stringify` reproduces faithfully:
+ * Buffer → base64, bigint → decimal string, Date → ISO string, non-finite
+ * number → its name (JSON would silently turn it into null), arrays and
+ * plain objects recursively. `int8`/`numeric`/timestamps already arrive as
+ * strings from `GreptimeClient` and stay that way.
+ */
+function toJsonSafe(value) {
+    if (value === null || value === undefined)
+        return null;
+    switch (typeof value) {
+        case 'string':
+        case 'boolean':
+            return value;
+        case 'number':
+            return Number.isFinite(value) ? value : String(value);
+        case 'bigint':
+            return value.toString();
+        case 'object':
+            break;
+        default:
+            return String(value);
+    }
+    if (Buffer.isBuffer(value))
+        return value.toString('base64');
+    if (value instanceof Uint8Array)
+        return Buffer.from(value).toString('base64');
+    if (value instanceof Date)
+        return Number.isNaN(value.getTime()) ? null : value.toISOString();
+    if (Array.isArray(value))
+        return value.map(toJsonSafe);
+    return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, toJsonSafe(v)]));
+}
+/**
+ * The one entry point for caller-supplied SQL (the explorer, the export and
+ * the assistant): the SQL guard, the row cap, the timeout and an audit row.
+ * Exported by `TelemetryModule`.
+ *
+ * @stability experimental
+ */
+let TelemetryQueryService = TelemetryQueryService_1 = class TelemetryQueryService {
+    greptime;
+    settings;
+    auditSink;
+    logger = new common_1.Logger(TelemetryQueryService_1.name);
+    constructor(greptime, settings, auditSink) {
+        this.greptime = greptime;
+        this.settings = settings;
+        this.auditSink = auditSink;
+    }
+    /**
+     * Runs one read-only statement for `userId`. Throws `TelemetryHttpError`
+     * (see `telemetry-query.errors.ts`) for every expected failure.
+     */
+    async run(userId, sql, opts = {}) {
+        const source = opts.source ?? 'explorer';
+        // Preconditions are not audited: nothing was attempted against the store.
+        const policy = await (0, telemetry_availability_1.requireQueryablePolicy)(this.greptime, this.settings);
+        const maxRows = clampRows(opts.maxRows, policy.query.maxRows);
+        const started = Date.now();
+        let outcome;
+        try {
+            const statement = (0, sql_guard_1.analyzeStatement)(sql);
+            const capped = (0, sql_guard_1.applyRowCap)(statement, maxRows + 1);
+            // 'client-only': the server may return more than maxRows + 1 rows. The
+            // slice below still caps the RESPONSE; the rows are held in memory in
+            // the meantime, bounded only by the policy timeout. Streaming rows off
+            // the socket and hanging up past the cap was considered and not done:
+            // it would replace `GreptimeClient.run`'s one-shot query (and its
+            // multi-statement check) for statements that are rare — `LIMIT ALL`,
+            // `LIMIT <expression>`, `FETCH FIRST`, SHOW/DESCRIBE/EXPLAIN.
+            if (capped.strategy === 'client-only' && statement.kind === 'select') {
+                this.logger.debug('Telemetry query has no server-side row cap; capping client-side');
+            }
+            const result = await this.greptime.queryReader(capped.sql, {
+                timeoutMs: policy.query.timeoutSeconds * 1000,
+                signal: opts.signal,
+            });
+            const elapsedMs = Date.now() - started;
+            const truncated = result.rows.length > maxRows;
+            const rows = (truncated ? result.rows.slice(0, maxRows) : result.rows).map((row) => row.map(toJsonSafe));
+            outcome = {
+                columns: result.fields.map((field) => ({ name: field.name, type: columnTypeName(field.dataTypeID) })),
+                rows,
+                rowCount: rows.length,
+                truncated,
+                elapsedMs,
+            };
+        }
+        catch (error) {
+            const mapped = (0, telemetry_availability_1.toTelemetryHttpError)(error);
+            const elapsedMs = Date.now() - started;
+            await this.audit(userId, source, sql, {
+                rowCount: 0,
+                truncated: false,
+                elapsedMs,
+                error: error instanceof Error ? error.message : String(error),
+                ...(mapped instanceof telemetry_query_errors_1.TelemetryHttpError ? { reason: mapped.reason } : {}),
+            }).catch((auditError) => {
+                // Never let a failed audit write replace the error the caller needs.
+                this.logger.warn(`Could not audit a failed telemetry query: ${auditError instanceof Error ? auditError.message : String(auditError)}`);
+            });
+            throw mapped;
+        }
+        // Outside the try: a failed audit write is a 500, not a "failed query".
+        await this.audit(userId, source, sql, {
+            rowCount: outcome.rowCount,
+            truncated: outcome.truncated,
+            elapsedMs: outcome.elapsedMs,
+        });
+        return outcome;
+    }
+    async audit(userId, source, sql, meta) {
+        await this.auditSink.record({
+            actorUserId: userId,
+            action: exports.TELEMETRY_QUERY_AUDIT_ACTIONS[source],
+            targetType: 'telemetry_store',
+            targetId: this.greptime.database,
+            meta: {
+                sql: sql.length > exports.TELEMETRY_AUDIT_SQL_MAX ? `${sql.slice(0, exports.TELEMETRY_AUDIT_SQL_MAX)}…` : sql,
+                ...(sql.length > exports.TELEMETRY_AUDIT_SQL_MAX ? { sqlLength: sql.length } : {}),
+                source,
+                ...meta,
+            },
+        });
+    }
+};
+exports.TelemetryQueryService = TelemetryQueryService;
+exports.TelemetryQueryService = TelemetryQueryService = TelemetryQueryService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(2, (0, common_1.Inject)(ports_1.TELEMETRY_AUDIT_SINK)),
+    __metadata("design:paramtypes", [greptime_client_1.GreptimeClient,
+        telemetry_settings_service_1.TelemetrySettingsService, Object])
+], TelemetryQueryService);
+function clampRows(requested, ceiling) {
+    const wanted = requested !== undefined && Number.isFinite(requested) ? Math.floor(requested) : ceiling;
+    return Math.max(1, Math.min(wanted, ceiling));
+}
+//# sourceMappingURL=telemetry-query.service.js.map

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

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

package/dist/telemetry/query/telemetry-schema.service.d.ts

@@ -0,0 +1,36 @@
+import type { TelemetrySchema, TelemetrySchemaTable } from '../dto/telemetry-query.dto';
+import { GreptimeClient } from '../greptime/greptime.client';
+import { TelemetrySettingsService } from '../telemetry-settings.service';
+export declare const TELEMETRY_SCHEMA_CACHE_MS = 30000;
+/**
+ * The telemetry store's tables and columns, cached briefly. Exported by
+ * `TelemetryModule`.
+ *
+ * @stability experimental
+ */
+export declare class TelemetrySchemaService {
+    private readonly greptime;
+    private readonly settings;
+    private cache;
+    private inflight;
+    constructor(greptime: GreptimeClient, settings: TelemetrySettingsService);
+    /** Every table with its columns, both sorted by name / position. */
+    getSchema(opts?: {
+        fresh?: boolean;
+    }): Promise<TelemetrySchema>;
+    /** Whether `name` is exactly (case-sensitively) a table of the telemetry database. */
+    tableExists(name: string): Promise<boolean>;
+    /** One table's schema, or null when there is no such table. */
+    describeTable(name: string): Promise<TelemetrySchemaTable | null>;
+    /** Drops the cached schema so the next read asks the store. */
+    invalidateCache(): void;
+    private read;
+}
+/**
+ * Builds the response from `[table_name, table_rows]` and
+ * `[table_name, column_name, data_type, semantic_type, ordinal_position]`
+ * rows. A column whose table is not in the table list still gets its table
+ * (a view, or a table created between the two reads).
+ */
+export declare function groupSchema(tableRows: unknown[][], columnRows: unknown[][]): TelemetrySchema;
+//# sourceMappingURL=telemetry-schema.service.d.ts.map

package/dist/telemetry/query/telemetry-schema.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-schema.service.d.ts","sourceRoot":"","sources":["../../../src/telemetry/query/telemetry-schema.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACxF,OAAO,EAAE,cAAc,EAAgB,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAuBzE,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD;;;;;GAKG;AACH,qBACa,sBAAsB;IAK/B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAL3B,OAAO,CAAC,KAAK,CAA2D;IACxE,OAAO,CAAC,QAAQ,CAAyC;gBAGtC,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,wBAAwB;IAGrD,oEAAoE;IAC9D,SAAS,CAAC,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAsBzE,sFAAsF;IAChF,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjD,+DAA+D;IACzD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAMvE,+DAA+D;IAC/D,eAAe,IAAI,IAAI;YAIT,IAAI;CAqBnB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,GAAG,eAAe,CAoC5F"}

package/dist/telemetry/query/telemetry-schema.service.js

@@ -0,0 +1,154 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetrySchemaService = exports.TELEMETRY_SCHEMA_CACHE_MS = void 0;
+exports.groupSchema = groupSchema;
+const common_1 = require("@nestjs/common");
+const greptime_client_1 = require("../greptime/greptime.client");
+const telemetry_settings_service_1 = require("../telemetry-settings.service");
+const telemetry_availability_1 = require("./telemetry-availability");
+// =============================================================================
+// TelemetrySchemaService — which tables and columns the store has
+// (issue #535, epic #528)
+// =============================================================================
+//
+// Feeds the explorer's schema tree and editor autocompletion, and — through
+// `tableExists` / `describeTable` — lets the assistant (#536) validate an
+// identifier before quoting it into SQL (there are no bind parameters, spike
+// #529).
+//
+// Two `information_schema` reads on the reader connection, filtered to the
+// configured database (from configuration, quoted). Cached for
+// `TELEMETRY_SCHEMA_CACHE_MS`: tables appear on first write and attribute
+// columns as new attributes arrive, so a short cache is fresh enough and saves
+// a round trip per keystroke of autocompletion.
+//
+// Not audited: this reads metadata, not telemetry. The same preconditions as
+// a query apply (503 unconfigured, 409 disabled).
+// =============================================================================
+exports.TELEMETRY_SCHEMA_CACHE_MS = 30_000;
+/**
+ * The telemetry store's tables and columns, cached briefly. Exported by
+ * `TelemetryModule`.
+ *
+ * @stability experimental
+ */
+let TelemetrySchemaService = class TelemetrySchemaService {
+    greptime;
+    settings;
+    cache = null;
+    inflight = null;
+    constructor(greptime, settings) {
+        this.greptime = greptime;
+        this.settings = settings;
+    }
+    /** Every table with its columns, both sorted by name / position. */
+    async getSchema(opts = {}) {
+        const policy = await (0, telemetry_availability_1.requireQueryablePolicy)(this.greptime, this.settings);
+        if (!opts.fresh && this.cache && Date.now() - this.cache.readAt < exports.TELEMETRY_SCHEMA_CACHE_MS) {
+            return this.cache.value;
+        }
+        // Concurrent callers share one read.
+        if (!this.inflight) {
+            this.inflight = this.read(policy.query.timeoutSeconds * 1000)
+                .then((value) => {
+                this.cache = { value, readAt: Date.now() };
+                return value;
+            })
+                .finally(() => {
+                this.inflight = null;
+            });
+        }
+        return this.inflight;
+    }
+    /** Whether `name` is exactly (case-sensitively) a table of the telemetry database. */
+    async tableExists(name) {
+        return (await this.describeTable(name)) !== null;
+    }
+    /** One table's schema, or null when there is no such table. */
+    async describeTable(name) {
+        const schema = await this.getSchema();
+        return schema.tables.find((table) => table.name === name) ?? null;
+    }
+    /** Drops the cached schema so the next read asks the store. */
+    invalidateCache() {
+        this.cache = null;
+    }
+    async read(timeoutMs) {
+        const database = (0, greptime_client_1.quoteLiteral)(this.greptime.database);
+        try {
+            const [tables, columns] = await Promise.all([
+                this.greptime.queryReader(`SELECT table_name, table_rows FROM information_schema.tables WHERE table_schema = ${database}`, { timeoutMs }),
+                this.greptime.queryReader('SELECT table_name, column_name, data_type, semantic_type, ordinal_position ' +
+                    `FROM information_schema.columns WHERE table_schema = ${database}`, { timeoutMs }),
+            ]);
+            return groupSchema(tables.rows, columns.rows);
+        }
+        catch (error) {
+            throw (0, telemetry_availability_1.toTelemetryHttpError)(error);
+        }
+    }
+};
+exports.TelemetrySchemaService = TelemetrySchemaService;
+exports.TelemetrySchemaService = TelemetrySchemaService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [greptime_client_1.GreptimeClient,
+        telemetry_settings_service_1.TelemetrySettingsService])
+], TelemetrySchemaService);
+/**
+ * Builds the response from `[table_name, table_rows]` and
+ * `[table_name, column_name, data_type, semantic_type, ordinal_position]`
+ * rows. A column whose table is not in the table list still gets its table
+ * (a view, or a table created between the two reads).
+ */
+function groupSchema(tableRows, columnRows) {
+    const tables = new Map();
+    const ensure = (name) => {
+        let table = tables.get(name);
+        if (!table) {
+            table = { rows: null, columns: [] };
+            tables.set(name, table);
+        }
+        return table;
+    };
+    for (const [name, rows] of tableRows) {
+        ensure(String(name)).rows = toCount(rows);
+    }
+    for (const [table, column, type, semantic, position] of columnRows) {
+        ensure(String(table)).columns.push({
+            name: String(column),
+            type: type === null || type === undefined ? 'unknown' : String(type),
+            semanticType: semantic === null || semantic === undefined || semantic === '' ? null : String(semantic),
+            position: toCount(position) ?? Number.MAX_SAFE_INTEGER,
+        });
+    }
+    return {
+        tables: [...tables.entries()]
+            .sort(([a], [b]) => compare(a, b))
+            .map(([name, table]) => ({
+            name,
+            rows: table.rows,
+            columns: table.columns
+                .sort((a, b) => a.position - b.position || compare(a.name, b.name))
+                .map(({ name: column, type, semanticType }) => ({ name: column, type, semanticType })),
+        })),
+    };
+}
+function compare(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+function toCount(value) {
+    if (value === null || value === undefined || value === '')
+        return null;
+    const n = typeof value === 'number' ? value : Number(value);
+    return Number.isFinite(n) ? n : null;
+}
+//# sourceMappingURL=telemetry-schema.service.js.map

package/dist/telemetry/query/telemetry-schema.service.js.map

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

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

@@ -0,0 +1,29 @@
+import { telemetryStackDeployStartedSchema, telemetryStackStatusSchema } from '@marinoscar/platform-contract/telemetry';
+export { TELEMETRY_STACK_AGENT_STATES, telemetryStackDeploySchema, telemetryStackServiceSchema, } from '@marinoscar/platform-contract/telemetry';
+export { telemetryStackDeployStartedSchema, telemetryStackStatusSchema };
+export type { TelemetryStackAgentState, TelemetryStackDeploy, TelemetryStackStatus, } from '@marinoscar/platform-contract/telemetry';
+declare const TelemetryStackStatusDto_base: import("nestjs-zod").ZodDto<import("zod").ZodObject<{
+    agent: import("zod").ZodEnum<import("@marinoscar/platform-contract/telemetry").TelemetryEnumEntries<"available" | "unavailable" | "unauthorized" | "not_configured">>;
+    agentError: import("zod").ZodNullable<import("zod").ZodString>;
+    services: import("zod").ZodArray<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        state: import("zod").ZodEnum<import("@marinoscar/platform-contract/telemetry").TelemetryEnumEntries<"running" | "restarting" | "exited" | "created" | "paused" | "dead" | "missing">>;
+        health: import("zod").ZodNullable<import("zod").ZodEnum<import("@marinoscar/platform-contract/telemetry").TelemetryEnumEntries<"healthy" | "unhealthy" | "starting">>>;
+    }, import("zod/v4/core").$strip>>;
+    deploy: import("zod").ZodNullable<import("zod").ZodObject<{
+        jobId: import("zod").ZodString;
+        status: import("zod").ZodEnum<import("@marinoscar/platform-contract/telemetry").TelemetryEnumEntries<"running" | "pending" | "succeeded" | "failed">>;
+        createdAt: import("zod").ZodISODateTime;
+        finishedAt: import("zod").ZodNullable<import("zod").ZodISODateTime>;
+        error: import("zod").ZodNullable<import("zod").ZodString>;
+        output: import("zod").ZodNullable<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, false>;
+export declare class TelemetryStackStatusDto extends TelemetryStackStatusDto_base {
+}
+declare const TelemetryStackDeployStartedDto_base: import("nestjs-zod").ZodDto<import("zod").ZodObject<{
+    jobId: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, false>;
+export declare class TelemetryStackDeployStartedDto extends TelemetryStackDeployStartedDto_base {
+}
+//# sourceMappingURL=telemetry-stack.dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-stack.dto.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/stack/dto/telemetry-stack.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iCAAiC,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAYxH,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,iCAAiC,EAAE,0BAA0B,EAAE,CAAC;AACzE,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,yCAAyC,CAAC;;;;;;;;;;;;;;;;;;AAEjD,qBAAa,uBAAwB,SAAQ,4BAAwC;CAAG;;;;AACxF,qBAAa,8BAA+B,SAAQ,mCAA+C;CAAG"}

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

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryStackDeployStartedDto = exports.TelemetryStackStatusDto = exports.telemetryStackStatusSchema = exports.telemetryStackDeployStartedSchema = exports.telemetryStackServiceSchema = exports.telemetryStackDeploySchema = exports.TELEMETRY_STACK_AGENT_STATES = void 0;
+const nestjs_zod_1 = require("nestjs-zod");
+const telemetry_1 = require("@marinoscar/platform-contract/telemetry");
+Object.defineProperty(exports, "telemetryStackDeployStartedSchema", { enumerable: true, get: function () { return telemetry_1.telemetryStackDeployStartedSchema; } });
+Object.defineProperty(exports, "telemetryStackStatusSchema", { enumerable: true, get: function () { return telemetry_1.telemetryStackStatusSchema; } });
+// =============================================================================
+// /api/admin/telemetry/stack — responses (issue #567, epic #528)
+// =============================================================================
+//
+// The schemas live in `@marinoscar/platform-contract/telemetry` (#702); this
+// file wraps them as nestjs-zod DTOs and re-exports the names services import.
+// A diagnosis, never an error: a deployment without a stack-agent is
+// `agent: 'not_configured'` with a 200.
+// =============================================================================
+var telemetry_2 = require("@marinoscar/platform-contract/telemetry");
+Object.defineProperty(exports, "TELEMETRY_STACK_AGENT_STATES", { enumerable: true, get: function () { return telemetry_2.TELEMETRY_STACK_AGENT_STATES; } });
+Object.defineProperty(exports, "telemetryStackDeploySchema", { enumerable: true, get: function () { return telemetry_2.telemetryStackDeploySchema; } });
+Object.defineProperty(exports, "telemetryStackServiceSchema", { enumerable: true, get: function () { return telemetry_2.telemetryStackServiceSchema; } });
+class TelemetryStackStatusDto extends (0, nestjs_zod_1.createZodDto)(telemetry_1.telemetryStackStatusSchema) {
+}
+exports.TelemetryStackStatusDto = TelemetryStackStatusDto;
+class TelemetryStackDeployStartedDto extends (0, nestjs_zod_1.createZodDto)(telemetry_1.telemetryStackDeployStartedSchema) {
+}
+exports.TelemetryStackDeployStartedDto = TelemetryStackDeployStartedDto;
+//# sourceMappingURL=telemetry-stack.dto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-stack.dto.js","sourceRoot":"","sources":["../../../../src/telemetry/stack/dto/telemetry-stack.dto.ts"],"names":[],"mappings":";;;AAAA,2CAA0C;AAE1C,uEAAwH;AAiB/G,kHAjBA,6CAAiC,OAiBA;AAAE,2GAjBA,sCAA0B,OAiBA;AAftE,gFAAgF;AAChF,iEAAiE;AACjE,gFAAgF;AAChF,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,qEAAqE;AACrE,wCAAwC;AACxC,gFAAgF;AAEhF,qEAIiD;AAH/C,yHAAA,4BAA4B,OAAA;AAC5B,uHAAA,0BAA0B,OAAA;AAC1B,wHAAA,2BAA2B,OAAA;AAS7B,MAAa,uBAAwB,SAAQ,IAAA,yBAAY,EAAC,sCAA0B,CAAC;CAAG;AAAxF,0DAAwF;AACxF,MAAa,8BAA+B,SAAQ,IAAA,yBAAY,EAAC,6CAAiC,CAAC;CAAG;AAAtG,wEAAsG"}

package/dist/telemetry/stack/stack-agent.client.d.ts

@@ -0,0 +1,76 @@
+import { ConfigService } from '@nestjs/config';
+import { z } from 'zod';
+/** Ceiling on a status read. The admin page waits on it. */
+export declare const STACK_AGENT_STATUS_TIMEOUT_MS = 5000;
+/**
+ * Ceiling on `POST /v1/telemetry/up`. The agent may pull images, which can
+ * take up to ten minutes; one more minute of slack, and still well inside the
+ * deploy job's 15-minute `maxRuntimeMs`.
+ */
+export declare const STACK_AGENT_UP_TIMEOUT_MS: number;
+export declare const STACK_SERVICE_STATES: readonly ["running", "restarting", "exited", "created", "paused", "dead", "missing"];
+export declare const STACK_SERVICE_HEALTH: readonly ["healthy", "unhealthy", "starting"];
+export declare const stackServiceSchema: z.ZodObject<{
+    name: z.ZodString;
+    state: z.ZodEnum<{
+        running: "running";
+        restarting: "restarting";
+        exited: "exited";
+        created: "created";
+        paused: "paused";
+        dead: "dead";
+        missing: "missing";
+    }>;
+    health: z.ZodNullable<z.ZodEnum<{
+        healthy: "healthy";
+        unhealthy: "unhealthy";
+        starting: "starting";
+    }>>;
+}, z.core.$strip>;
+export type StackService = z.infer<typeof stackServiceSchema>;
+/** Why a call did not produce what was asked for. */
+export type StackAgentErrorKind = 'not_configured' | 'unreachable' | 'unauthorized' | 'busy' | 'failed';
+export type StackAgentFailure = {
+    ok: false;
+    error: StackAgentErrorKind;
+    /** Human-readable detail. Never carries the token. */
+    message: string;
+    /** For `failed`: the agent's exit code, when it reported one. */
+    exitCode?: number | null;
+    /** For `failed`: the agent's command output, when it reported any. */
+    output?: string;
+};
+export type StackAgentStatusResult = {
+    ok: true;
+    services: StackService[];
+} | StackAgentFailure;
+export type StackAgentUpResult = {
+    ok: true;
+    exitCode: number;
+    output: string;
+} | StackAgentFailure;
+/** The subset of the global `fetch` this client uses; injectable for tests. */
+export type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+export declare class StackAgentClient {
+    private readonly logger;
+    private readonly baseUrl;
+    private readonly token;
+    /** Overridable in tests; the Node 24 global otherwise. */
+    protected fetchImpl: FetchLike;
+    constructor(config: ConfigService);
+    /** Both `STACK_AGENT_URL` and `STACK_AGENT_TOKEN` are set. */
+    isConfigured(): boolean;
+    /** `GET /v1/telemetry` — the state of each telemetry service. Never throws. */
+    telemetryStatus(): Promise<StackAgentStatusResult>;
+    /**
+     * `POST /v1/telemetry/up` — start (pulling if needed) the telemetry
+     * services. May take up to ten minutes. Never throws.
+     */
+    telemetryUp(): Promise<StackAgentUpResult>;
+    private request;
+    /** The URL's origin, for messages (never a path, query or credential). */
+    private origin;
+}
+/** A fetch failure in words: a timeout, a DNS/connect error (its `cause`), or the message. */
+export declare function describeFetchError(error: unknown, timeoutMs: number): string;
+//# sourceMappingURL=stack-agent.client.d.ts.map

package/dist/telemetry/stack/stack-agent.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-agent.client.d.ts","sourceRoot":"","sources":["../../../src/telemetry/stack/stack-agent.client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8BxB,4DAA4D;AAC5D,eAAO,MAAM,6BAA6B,OAAQ,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,QAAiB,CAAC;AAKxD,eAAO,MAAM,oBAAoB,sFAAiC,CAAC;AACnE,eAAO,MAAM,oBAAoB,+CAAiC,CAAC;AAEnE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;iBAI7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAW9D,qDAAqD;AACrD,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG,aAAa,GAAG,cAAc,GAAG,MAAM,GAAG,QAAQ,CAAC;AAExG,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,mBAAmB,CAAC;IAC3B,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,GAAG,iBAAiB,CAAC;AAEhG,MAAM,MAAM,kBAAkB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CAAC;AAEpG,+EAA+E;AAC/E,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEjF,qBACa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,0DAA0D;IAC1D,SAAS,CAAC,SAAS,EAAE,SAAS,CAAuC;gBAEzD,MAAM,EAAE,aAAa;IAOjC,8DAA8D;IAC9D,YAAY,IAAI,OAAO;IAIvB,+EAA+E;IACzE,eAAe,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAmBxD;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,kBAAkB,CAAC;YA+BlC,OAAO;IA2BrB,0EAA0E;IAC1E,OAAO,CAAC,MAAM;CAOf;AA8BD,8FAA8F;AAC9F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAa5E"}