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

package/dist/telemetry/greptime/greptime.client.js

@@ -0,0 +1,352 @@
+"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 GreptimeClient_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GreptimeClient = exports.GREPTIME_PING_TIMEOUT_MS = exports.GREPTIME_CONNECT_TIMEOUT_MS = exports.GREPTIME_ADMIN_POOL_MAX = exports.GREPTIME_READER_POOL_MAX = void 0;
+exports.greptimeTypeParser = greptimeTypeParser;
+exports.quoteIdent = quoteIdent;
+exports.quoteLiteral = quoteLiteral;
+exports.rowsAsObjects = rowsAsObjects;
+const common_1 = require("@nestjs/common");
+const pg_1 = require("pg");
+const telemetry_connection_service_1 = require("../connection/telemetry-connection.service");
+const greptime_errors_1 = require("./greptime.errors");
+const greptime_host_1 = require("./greptime-host");
+/** Pool sizes. Small on purpose: telemetry reads are admin-only and rare. */
+exports.GREPTIME_READER_POOL_MAX = 4;
+exports.GREPTIME_ADMIN_POOL_MAX = 1;
+/** How long to wait for a TCP connection + authentication before giving up. */
+exports.GREPTIME_CONNECT_TIMEOUT_MS = 5_000;
+/** Timeout for `ping()`. */
+exports.GREPTIME_PING_TIMEOUT_MS = 5_000;
+/** Type OIDs whose text form is kept verbatim instead of parsed by `pg`. */
+const KEEP_AS_TEXT_OIDS = new Set([
+    20, // int8 — beyond Number.MAX_SAFE_INTEGER in practice (durations in ns)
+    1700, // numeric — how UInt64 columns arrive
+    1082, // date
+    1083, // time
+    1114, // timestamp
+    1184, // timestamptz
+    1266, // timetz
+]);
+/**
+ * Per-pool type parser: the types above come back as the server's text,
+ * everything else as `pg` would parse it (booleans, int2/int4, floats, json).
+ */
+function greptimeTypeParser(oid, format) {
+    if (KEEP_AS_TEXT_OIDS.has(oid)) {
+        return (value) => value;
+    }
+    return pg_1.types.getTypeParser(oid, format ?? 'text');
+}
+/**
+ * Double-quotes an SQL identifier. Only for a value that was already
+ * validated (from configuration, or checked against `information_schema`) —
+ * quoting makes an identifier unambiguous, it does not make an arbitrary
+ * string safe to accept.
+ */
+function quoteIdent(name) {
+    return `"${name.replace(/"/g, '""')}"`;
+}
+/** Single-quotes an SQL string literal. Same caveat as `quoteIdent`. */
+function quoteLiteral(value) {
+    return `'${value.replace(/'/g, "''")}'`;
+}
+/** `rows` as objects keyed by field name. Only when the names are unique. */
+function rowsAsObjects(result) {
+    return result.rows.map((row) => Object.fromEntries(result.fields.map((field, index) => [field.name, row[index]])));
+}
+/**
+ * The telemetry store's client: a read-only reader pool and an admin pool,
+ * built from the runtime connection and rebuilt when it changes. Exported by
+ * `TelemetryModule`.
+ *
+ * @stability experimental
+ */
+let GreptimeClient = GreptimeClient_1 = class GreptimeClient {
+    connection;
+    logger = new common_1.Logger(GreptimeClient_1.name);
+    pools = {};
+    /** A pool being built (its password is being read), so concurrent calls share it. */
+    building = {};
+    /** @internal */
+    constructor(connection) {
+        this.connection = connection;
+    }
+    /** Whether the reader connection is configured (admin UI or deployment default). */
+    isConfigured() {
+        return this.connection.isConfigured();
+    }
+    /**
+     * Why the reader connection cannot be used, in administrator language, or
+     * null — set only for the GreptimeDB deployed with this application, when
+     * the deployment provisions no reader login (issue #570).
+     */
+    configurationProblem() {
+        return this.connection.configurationProblem('reader');
+    }
+    /** Whether the admin connection is configured as well (retention, `SHOW CREATE DATABASE`). */
+    isAdminConfigured() {
+        return this.connection.isAdminConfigured();
+    }
+    /** The GreptimeDB database telemetry is written to (default `public`). */
+    get database() {
+        return this.connection.database;
+    }
+    /**
+     * Runs one statement as the read-only user. The SQL is sent as-is: see the
+     * header for why there are no parameters.
+     */
+    async queryReader(sql, options) {
+        return this.run('reader', sql, options);
+    }
+    /**
+     * Runs one statement as the admin user. NEVER with caller-supplied SQL: this
+     * connection can alter retention and drop data.
+     */
+    async queryAdmin(sql, options) {
+        return this.run('admin', sql, options);
+    }
+    /** Reachability probe over the reader connection. Never throws. */
+    async ping() {
+        if (!this.isConfigured()) {
+            return { reachable: false, error: this.configurationProblem() ?? new greptime_errors_1.TelemetryNotConfiguredError('reader').message };
+        }
+        try {
+            const result = await this.queryReader('SELECT version()', { timeoutMs: exports.GREPTIME_PING_TIMEOUT_MS });
+            const version = result.rows[0]?.[0];
+            return { reachable: true, ...(typeof version === 'string' ? { version } : {}) };
+        }
+        catch (error) {
+            return { reachable: false, error: describeError(error) };
+        }
+    }
+    /** Closes both pools. */
+    async onModuleDestroy() {
+        const pools = Object.values(this.pools).map((entry) => entry.pool);
+        for (const role of Object.keys(this.pools)) {
+            delete this.pools[role];
+        }
+        await Promise.all(pools.map((pool) => pool.end().catch((error) => {
+            this.logger.warn(`Closing a GreptimeDB pool failed: ${describeError(error)}`);
+        })));
+    }
+    /** Builds a pool. A seam for tests; production code never overrides it. */
+    createPool(config) {
+        return new pg_1.Pool(config);
+    }
+    /**
+     * `null` when `host` resolves (or the check is inconclusive), else why it
+     * does not. Only consulted after a connect TIMED OUT. A seam for tests;
+     * production code never overrides it.
+     */
+    resolveHost(host, options) {
+        return (0, greptime_host_1.checkHostResolves)(host, undefined, undefined, options);
+    }
+    // ---------------------------------------------------------------------------
+    async run(role, sql, { timeoutMs, signal }) {
+        if (signal?.aborted)
+            throw new greptime_errors_1.TelemetryQueryAbortedError();
+        const keyed = await this.pool(role);
+        const client = await this.connect(keyed);
+        if (signal?.aborted) {
+            client.release();
+            throw new greptime_errors_1.TelemetryQueryAbortedError();
+        }
+        let timer;
+        let timedOut = false;
+        let onAbort;
+        const query = client.query({ text: sql, rowMode: 'array' });
+        const timeout = new Promise((_, reject) => {
+            timer = setTimeout(() => {
+                timedOut = true;
+                reject(new greptime_errors_1.TelemetryQueryTimeoutError(timeoutMs));
+            }, timeoutMs);
+            timer.unref?.();
+        });
+        // Abandoned like a timeout: `timedOut` routes it to the destroy branch.
+        const aborted = new Promise((_, reject) => {
+            if (!signal)
+                return;
+            onAbort = () => {
+                timedOut = true;
+                reject(new greptime_errors_1.TelemetryQueryAbortedError());
+            };
+            signal.addEventListener('abort', onAbort, { once: true });
+        });
+        try {
+            const result = await Promise.race([query, timeout, aborted]);
+            client.release();
+            if (Array.isArray(result)) {
+                throw new greptime_errors_1.TelemetryMultiStatementError();
+            }
+            return {
+                fields: result.fields.map((field) => ({ name: field.name, dataTypeID: field.dataTypeID })),
+                rows: result.rows,
+            };
+        }
+        catch (error) {
+            if (timedOut) {
+                // The query is still in flight on this socket: destroy it, and make
+                // sure its eventual rejection (the socket closing under it) is not an
+                // unhandled one.
+                query.catch(() => undefined);
+                client.release(true);
+                throw error;
+            }
+            if (error instanceof greptime_errors_1.TelemetryMultiStatementError) {
+                throw error;
+            }
+            // A server-side error (it has a `severity`) leaves the connection
+            // usable; anything else (a reset socket) does not.
+            const fromServer = isServerError(error);
+            client.release(fromServer ? undefined : true);
+            throw new greptime_errors_1.TelemetryQueryFailedError(describeError(error), sqlState(error), fromServer ? 'server' : 'connection');
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+            if (onAbort)
+                signal?.removeEventListener('abort', onAbort);
+        }
+    }
+    async connect(target) {
+        try {
+            return await target.pool.connect();
+        }
+        catch (error) {
+            throw new greptime_errors_1.TelemetryQueryFailedError(`Could not connect to GreptimeDB: ${await this.connectFailureReason(target, error)}`, sqlState(error), 'connection');
+        }
+    }
+    /**
+     * Why a connect failed. A DNS error names the host; a timeout may be a DNS
+     * failure that lost the race, so the host is looked up once more under a
+     * longer ceiling before "timeout" is believed (#564). Never throws.
+     */
+    async connectFailureReason({ host, automaticHost }, error) {
+        const options = { automatic: automaticHost };
+        if ((0, greptime_host_1.isDnsError)(error))
+            return (0, greptime_host_1.hostNotFoundMessage)(host, error, options);
+        if (isConnectTimeout(error)) {
+            const notFound = await this.resolveHost(host, options).catch(() => null);
+            if (notFound)
+                return notFound;
+        }
+        return describeError(error);
+    }
+    /**
+     * The pool for this login, for the connection in force NOW. Rebuilt when
+     * the connection's fingerprint moved since the pool was made (an admin save,
+     * a credential rotation, a reset to the deployment default).
+     */
+    async pool(role) {
+        const fingerprint = this.connection.fingerprint(role);
+        if (!fingerprint) {
+            // No longer configured: drop a pool left over from when it was.
+            this.retire(role);
+            throw new greptime_errors_1.TelemetryNotConfiguredError(role);
+        }
+        const existing = this.pools[role];
+        if (existing && existing.fingerprint === fingerprint)
+            return existing;
+        const inFlight = this.building[role];
+        if (inFlight)
+            return inFlight;
+        const building = this.build(role).finally(() => {
+            delete this.building[role];
+        });
+        this.building[role] = building;
+        return building;
+    }
+    async build(role) {
+        let credentials;
+        try {
+            credentials = await this.connection.resolveCredentials(role);
+        }
+        catch (error) {
+            // A credential-store read failed (database down, or a password that no
+            // longer decrypts). The message never carries the secret.
+            throw new greptime_errors_1.TelemetryQueryFailedError(`Could not read the GreptimeDB ${role} credential: ${describeError(error)}`, undefined, 'connection');
+        }
+        if (!credentials) {
+            throw new greptime_errors_1.TelemetryNotConfiguredError(role);
+        }
+        const pool = this.createPool({
+            host: credentials.host,
+            port: credentials.port,
+            database: credentials.database,
+            user: credentials.user,
+            password: credentials.password,
+            max: role === 'reader' ? exports.GREPTIME_READER_POOL_MAX : exports.GREPTIME_ADMIN_POOL_MAX,
+            application_name: `api-telemetry-${role}`,
+            connectionTimeoutMillis: exports.GREPTIME_CONNECT_TIMEOUT_MS,
+            idleTimeoutMillis: 30_000,
+            allowExitOnIdle: true,
+            types: { getTypeParser: greptimeTypeParser },
+        });
+        // An idle client's socket dying emits `error` on the pool; unhandled, that
+        // is an uncaught exception that would take the API down with it.
+        pool.on('error', (error) => {
+            this.logger.warn(`GreptimeDB ${role} connection error: ${describeError(error)}`);
+        });
+        const replaced = this.pools[role];
+        const keyed = {
+            pool,
+            fingerprint: credentials.fingerprint,
+            host: credentials.host,
+            automaticHost: credentials.automaticHost,
+        };
+        this.pools[role] = keyed;
+        if (replaced) {
+            this.logger.log(`GreptimeDB ${role} connection changed; replacing its pool`);
+            this.endInBackground(role, replaced.pool);
+        }
+        return keyed;
+    }
+    /** Forget this login's pool and close it in the background. */
+    retire(role) {
+        const existing = this.pools[role];
+        if (!existing)
+            return;
+        delete this.pools[role];
+        this.endInBackground(role, existing.pool);
+    }
+    /**
+     * `end()` waits for checked-out clients to be released, so it is never
+     * awaited on the query path: in-flight statements on the old pool finish
+     * (or time out) on their own, and nothing new is handed out from it.
+     */
+    endInBackground(role, pool) {
+        void pool.end().catch((error) => {
+            this.logger.warn(`Closing a stale GreptimeDB ${role} pool failed: ${describeError(error)}`);
+        });
+    }
+};
+exports.GreptimeClient = GreptimeClient;
+exports.GreptimeClient = GreptimeClient = GreptimeClient_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [telemetry_connection_service_1.TelemetryConnectionService])
+], GreptimeClient);
+function describeError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** pg's connect-timeout errors ("timeout expired", "… due to connection timeout"). */
+function isConnectTimeout(error) {
+    return /timeout/i.test(describeError(error));
+}
+function isServerError(error) {
+    return typeof error === 'object' && error !== null && 'severity' in error;
+}
+function sqlState(error) {
+    const code = typeof error === 'object' && error !== null ? error.code : undefined;
+    return typeof code === 'string' ? code : undefined;
+}
+//# sourceMappingURL=greptime.client.js.map

package/dist/telemetry/greptime/greptime.client.js.map

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

package/dist/telemetry/greptime/greptime.errors.d.ts

@@ -0,0 +1,59 @@
+/** Base of every error `GreptimeClient` throws on purpose. */
+export declare class TelemetryStoreError extends Error {
+    constructor(message: string);
+}
+/**
+ * The connection this call needs is not configured — neither saved at
+ * /admin/settings/telemetry nor supplied by the `GREPTIME_*` deployment
+ * default, or the admin login missing for an admin call. Not a fault: a
+ * deployment without a telemetry store is a supported state.
+ */
+export declare class TelemetryNotConfiguredError extends TelemetryStoreError {
+    readonly role: 'reader' | 'admin';
+    constructor(role: 'reader' | 'admin');
+}
+/**
+ * The statement did not finish within `timeoutMs`. Enforced CLIENT-SIDE: the
+ * read-only user cannot `SET statement_timeout`, and GreptimeDB ignores the
+ * startup parameter (spike #529). The connection that ran it has already been
+ * destroyed when this is thrown; the server may still be finishing the query.
+ */
+export declare class TelemetryQueryTimeoutError extends TelemetryStoreError {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number);
+}
+/**
+ * The SQL string produced more than one result set. The simple query
+ * protocol runs every statement in a multi-statement string (spike #529), so
+ * the client refuses to hand such a result back; the explorer's guard (#535)
+ * should reject the text before it is ever sent.
+ */
+export declare class TelemetryMultiStatementError extends TelemetryStoreError {
+    constructor();
+}
+/**
+ * GreptimeDB (or the network) refused or failed the statement.
+ *
+ * `origin` tells the two apart: `server` is GreptimeDB answering with an
+ * error (bad SQL, permission refused — the caller's statement is at fault and
+ * the message is safe to show), `connection` is the store not answering at
+ * all (refused/reset socket, failed authentication handshake).
+ */
+export declare class TelemetryQueryFailedError extends TelemetryStoreError {
+    /** SQLSTATE when the server supplied one (or a Node error code for a socket failure). */
+    readonly code?: string | undefined;
+    readonly origin: 'server' | 'connection';
+    constructor(message: string, 
+    /** SQLSTATE when the server supplied one (or a Node error code for a socket failure). */
+    code?: string | undefined, origin?: 'server' | 'connection');
+}
+/**
+ * The caller's `AbortSignal` fired while the statement was in flight (the
+ * assistant's client disconnected, issue #536). Like a timeout, the
+ * connection that ran it has already been destroyed; the server may still be
+ * finishing the query.
+ */
+export declare class TelemetryQueryAbortedError extends TelemetryStoreError {
+    constructor();
+}
+//# sourceMappingURL=greptime.errors.d.ts.map

package/dist/telemetry/greptime/greptime.errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"greptime.errors.d.ts","sourceRoot":"","sources":["../../../src/telemetry/greptime/greptime.errors.ts"],"names":[],"mappings":"AAaA,8DAA8D;AAC9D,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,mBAAmB;IACtD,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO;gBAAxB,IAAI,EAAE,QAAQ,GAAG,OAAO;CAS9C;AAED;;;;;GAKG;AACH,qBAAa,0BAA2B,SAAQ,mBAAmB;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;CAGvC;AAED;;;;;GAKG;AACH,qBAAa,4BAA6B,SAAQ,mBAAmB;;CAIpE;AAED;;;;;;;GAOG;AACH,qBAAa,yBAA0B,SAAQ,mBAAmB;IAG9D,yFAAyF;IACzF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,YAAY;gBAHxC,OAAO,EAAE,MAAM;IACf,yFAAyF;IAChF,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,MAAM,GAAE,QAAQ,GAAG,YAAuB;CAItD;AAED;;;;;GAKG;AACH,qBAAa,0BAA2B,SAAQ,mBAAmB;;CAIlE"}

package/dist/telemetry/greptime/greptime.errors.js

@@ -0,0 +1,100 @@
+"use strict";
+// =============================================================================
+// Typed failures of the GreptimeDB client (issue #534, epic #528)
+// =============================================================================
+//
+// One base class so a caller (the status service here; the explorer's query
+// service in #535; the assistant's tools in #536) can catch "anything the
+// telemetry store did" in one clause and map the subclasses to its own
+// response. NONE OF THESE MESSAGES CARRIES A CREDENTIAL: they are built from
+// fixed text plus, for `TelemetryQueryFailedError`, the server's own error
+// message, which GreptimeDB builds from the SQL it was given — never from the
+// connection's password.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryQueryAbortedError = exports.TelemetryQueryFailedError = exports.TelemetryMultiStatementError = exports.TelemetryQueryTimeoutError = exports.TelemetryNotConfiguredError = exports.TelemetryStoreError = void 0;
+/** Base of every error `GreptimeClient` throws on purpose. */
+class TelemetryStoreError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+    }
+}
+exports.TelemetryStoreError = TelemetryStoreError;
+/**
+ * The connection this call needs is not configured — neither saved at
+ * /admin/settings/telemetry nor supplied by the `GREPTIME_*` deployment
+ * default, or the admin login missing for an admin call. Not a fault: a
+ * deployment without a telemetry store is a supported state.
+ */
+class TelemetryNotConfiguredError extends TelemetryStoreError {
+    role;
+    constructor(role) {
+        super(role === 'admin'
+            ? 'The GreptimeDB admin connection is not configured. Set the admin user and password at ' +
+                '/admin/settings/telemetry (or GREPTIME_ADMIN_USER / GREPTIME_ADMIN_PASSWORD as the deployment default).'
+            : 'GreptimeDB is not configured. Configure the connection at /admin/settings/telemetry ' +
+                '(or GREPTIME_HOST / GREPTIME_READER_USER / GREPTIME_READER_PASSWORD as the deployment default).');
+        this.role = role;
+    }
+}
+exports.TelemetryNotConfiguredError = TelemetryNotConfiguredError;
+/**
+ * The statement did not finish within `timeoutMs`. Enforced CLIENT-SIDE: the
+ * read-only user cannot `SET statement_timeout`, and GreptimeDB ignores the
+ * startup parameter (spike #529). The connection that ran it has already been
+ * destroyed when this is thrown; the server may still be finishing the query.
+ */
+class TelemetryQueryTimeoutError extends TelemetryStoreError {
+    timeoutMs;
+    constructor(timeoutMs) {
+        super(`The telemetry query did not finish within ${timeoutMs} ms and was abandoned.`);
+        this.timeoutMs = timeoutMs;
+    }
+}
+exports.TelemetryQueryTimeoutError = TelemetryQueryTimeoutError;
+/**
+ * The SQL string produced more than one result set. The simple query
+ * protocol runs every statement in a multi-statement string (spike #529), so
+ * the client refuses to hand such a result back; the explorer's guard (#535)
+ * should reject the text before it is ever sent.
+ */
+class TelemetryMultiStatementError extends TelemetryStoreError {
+    constructor() {
+        super('Exactly one SQL statement may be executed per telemetry query.');
+    }
+}
+exports.TelemetryMultiStatementError = TelemetryMultiStatementError;
+/**
+ * GreptimeDB (or the network) refused or failed the statement.
+ *
+ * `origin` tells the two apart: `server` is GreptimeDB answering with an
+ * error (bad SQL, permission refused — the caller's statement is at fault and
+ * the message is safe to show), `connection` is the store not answering at
+ * all (refused/reset socket, failed authentication handshake).
+ */
+class TelemetryQueryFailedError extends TelemetryStoreError {
+    code;
+    origin;
+    constructor(message, 
+    /** SQLSTATE when the server supplied one (or a Node error code for a socket failure). */
+    code, origin = 'server') {
+        super(message);
+        this.code = code;
+        this.origin = origin;
+    }
+}
+exports.TelemetryQueryFailedError = TelemetryQueryFailedError;
+/**
+ * The caller's `AbortSignal` fired while the statement was in flight (the
+ * assistant's client disconnected, issue #536). Like a timeout, the
+ * connection that ran it has already been destroyed; the server may still be
+ * finishing the query.
+ */
+class TelemetryQueryAbortedError extends TelemetryStoreError {
+    constructor() {
+        super('The telemetry query was cancelled.');
+    }
+}
+exports.TelemetryQueryAbortedError = TelemetryQueryAbortedError;
+//# sourceMappingURL=greptime.errors.js.map

package/dist/telemetry/greptime/greptime.errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"greptime.errors.js","sourceRoot":"","sources":["../../../src/telemetry/greptime/greptime.errors.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,kEAAkE;AAClE,gFAAgF;AAChF,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,uEAAuE;AACvE,6EAA6E;AAC7E,2EAA2E;AAC3E,8EAA8E;AAC9E,yBAAyB;AACzB,gFAAgF;;;AAEhF,8DAA8D;AAC9D,MAAa,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF;AALD,kDAKC;AAED;;;;;GAKG;AACH,MAAa,2BAA4B,SAAQ,mBAAmB;IAC7C;IAArB,YAAqB,IAAwB;QAC3C,KAAK,CACH,IAAI,KAAK,OAAO;YACd,CAAC,CAAC,wFAAwF;gBACtF,yGAAyG;YAC7G,CAAC,CAAC,sFAAsF;gBACpF,iGAAiG,CACxG,CAAC;QAPiB,SAAI,GAAJ,IAAI,CAAoB;IAQ7C,CAAC;CACF;AAVD,kEAUC;AAED;;;;;GAKG;AACH,MAAa,0BAA2B,SAAQ,mBAAmB;IAC5C;IAArB,YAAqB,SAAiB;QACpC,KAAK,CAAC,6CAA6C,SAAS,wBAAwB,CAAC,CAAC;QADnE,cAAS,GAAT,SAAS,CAAQ;IAEtC,CAAC;CACF;AAJD,gEAIC;AAED;;;;;GAKG;AACH,MAAa,4BAA6B,SAAQ,mBAAmB;IACnE;QACE,KAAK,CAAC,gEAAgE,CAAC,CAAC;IAC1E,CAAC;CACF;AAJD,oEAIC;AAED;;;;;;;GAOG;AACH,MAAa,yBAA0B,SAAQ,mBAAmB;IAIrD;IACA;IAJX,YACE,OAAe;IACf,yFAAyF;IAChF,IAAa,EACb,SAAkC,QAAQ;QAEnD,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,SAAI,GAAJ,IAAI,CAAS;QACb,WAAM,GAAN,MAAM,CAAoC;IAGrD,CAAC;CACF;AATD,8DASC;AAED;;;;;GAKG;AACH,MAAa,0BAA2B,SAAQ,mBAAmB;IACjE;QACE,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAC9C,CAAC;CACF;AAJD,gEAIC"}

package/dist/telemetry/handlers/telemetry-retention.handler.d.ts

@@ -0,0 +1,27 @@
+import { OnModuleInit } from '@nestjs/common';
+import { GreptimeClient } from '../greptime/greptime.client';
+import { type TelemetryJobExecutionProfile, type TelemetryJobHandler, type TelemetryJobRecord as Job, type TelemetryJobsPort, type TelemetrySettingsStore } from '../ports';
+/**
+ * The job type. PERMANENT once rows of it exist.
+ *
+ * @stability stable
+ */
+export declare const TELEMETRY_RETENTION_TYPE = "telemetry.retention.apply";
+/** Client-side ceiling on the ALTER. It is a metadata change; seconds, not minutes. */
+export declare const TELEMETRY_RETENTION_STATEMENT_TIMEOUT_MS = 30000;
+/** The one statement this job runs. Exported so its text is pinned by a test. */
+export declare function retentionStatement(database: string, retentionDays: number): string;
+export declare class TelemetryRetentionHandler implements TelemetryJobHandler, OnModuleInit {
+    private readonly jobs;
+    private readonly systemSettings;
+    private readonly greptime;
+    private readonly logger;
+    readonly type = "telemetry.retention.apply";
+    /** One metadata statement; a minute is generous. Retried like any housekeeping job. */
+    readonly profile: TelemetryJobExecutionProfile;
+    constructor(jobs: TelemetryJobsPort, systemSettings: TelemetrySettingsStore, greptime: GreptimeClient);
+    onModuleInit(): void;
+    /** Throws to fail (GreptimeDB unreachable or refusing), so the queue's retry applies. */
+    process(job: Job): Promise<void>;
+}
+//# sourceMappingURL=telemetry-retention.handler.d.ts.map

package/dist/telemetry/handlers/telemetry-retention.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-retention.handler.d.ts","sourceRoot":"","sources":["../../../src/telemetry/handlers/telemetry-retention.handler.ts"],"names":[],"mappings":"AAsCA,OAAO,EAA8B,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAGL,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,IAAI,GAAG,EAC9B,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC5B,MAAM,UAAU,CAAC;AAElB;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,8BAA8B,CAAC;AAEpE,uFAAuF;AACvF,eAAO,MAAM,wCAAwC,QAAS,CAAC;AAK/D,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAalF;AAED,qBACa,yBAA0B,YAAW,mBAAmB,EAAE,YAAY;IAWvD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACX,OAAO,CAAC,QAAQ,CAAC,cAAc;IACjE,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAZ3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;IAErE,QAAQ,CAAC,IAAI,+BAA4B;IAEzC,uFAAuF;IACvF,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAA4C;gBAK/C,IAAI,EAAE,iBAAiB,EACb,cAAc,EAAE,sBAAsB,EACxE,QAAQ,EAAE,cAAc;IAG3C,YAAY,IAAI,IAAI;IAIpB,yFAAyF;IACnF,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CA0BvC"}