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

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

@@ -0,0 +1,44 @@
+import { telemetryExportRequestSchema, telemetryQueryRequestSchema, telemetryQueryResultSchema, telemetrySchemaSchema, type TelemetryQueryResult } from '@marinoscar/platform-contract/telemetry';
+export { TELEMETRY_COLUMN_TYPES, TELEMETRY_EXPORT_FORMATS, TELEMETRY_QUERY_MAX_ROWS_CEILING, TELEMETRY_SQL_MAX_LENGTH, telemetryColumnSchema, telemetrySchemaColumnSchema, telemetrySchemaTableSchema, } from '@marinoscar/platform-contract/telemetry';
+export { telemetryExportRequestSchema, telemetryQueryRequestSchema, telemetryQueryResultSchema, telemetrySchemaSchema };
+export type { TelemetryColumn, TelemetryColumnType, TelemetryExportFormat, TelemetrySchema, TelemetrySchemaTable, } from '@marinoscar/platform-contract/telemetry';
+/** The `POST /api/admin/telemetry/query` response (the contract's `TelemetryQueryResult`). */
+export type TelemetryQueryRunResult = TelemetryQueryResult;
+declare const TelemetryQueryRequestDto_base: import("nestjs-zod").ZodDto<import("zod").ZodObject<{
+    sql: import("zod").ZodString;
+    maxRows: import("zod").ZodOptional<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, false>;
+export declare class TelemetryQueryRequestDto extends TelemetryQueryRequestDto_base {
+}
+declare const TelemetryQueryResultDto_base: import("nestjs-zod").ZodDto<import("zod").ZodObject<{
+    columns: import("zod").ZodArray<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        type: import("zod").ZodEnum<import("@marinoscar/platform-contract/telemetry").TelemetryEnumEntries<"unknown" | "date" | "time" | "text" | "bool" | "int2" | "int4" | "int8" | "float4" | "float8" | "numeric" | "bytea" | "timestamp" | "json">>;
+    }, import("zod/v4/core").$strip>>;
+    rows: import("zod").ZodArray<import("zod").ZodArray<import("zod").ZodUnknown>>;
+    rowCount: import("zod").ZodNumber;
+    truncated: import("zod").ZodBoolean;
+    elapsedMs: import("zod").ZodNumber;
+}, import("zod/v4/core").$strip>, false>;
+export declare class TelemetryQueryResultDto extends TelemetryQueryResultDto_base {
+}
+declare const TelemetrySchemaDto_base: import("nestjs-zod").ZodDto<import("zod").ZodObject<{
+    tables: import("zod").ZodArray<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        rows: import("zod").ZodNullable<import("zod").ZodNumber>;
+        columns: import("zod").ZodArray<import("zod").ZodObject<{
+            name: import("zod").ZodString;
+            type: import("zod").ZodString;
+            semanticType: import("zod").ZodNullable<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, false>;
+export declare class TelemetrySchemaDto extends TelemetrySchemaDto_base {
+}
+declare const TelemetryExportRequestDto_base: import("nestjs-zod").ZodDto<import("zod").ZodObject<{
+    sql: import("zod").ZodString;
+    format: import("zod").ZodEnum<import("@marinoscar/platform-contract/telemetry").TelemetryEnumEntries<"csv" | "ndjson" | "xlsx" | "parquet">>;
+}, import("zod/v4/core").$strip>, false>;
+export declare class TelemetryExportRequestDto extends TelemetryExportRequestDto_base {
+}
+//# sourceMappingURL=telemetry-query.dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-query.dto.d.ts","sourceRoot":"","sources":["../../../src/telemetry/dto/telemetry-query.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,KAAK,oBAAoB,EAC1B,MAAM,yCAAyC,CAAC;AAejD,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,gCAAgC,EAChC,wBAAwB,EACxB,qBAAqB,EACrB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,CAAC;AACxH,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,oBAAoB,GACrB,MAAM,yCAAyC,CAAC;AACjD,8FAA8F;AAC9F,MAAM,MAAM,uBAAuB,GAAG,oBAAoB,CAAC;;;;;AAE3D,qBAAa,wBAAyB,SAAQ,6BAAyC;CAAG;;;;;;;;;;;AAC1F,qBAAa,uBAAwB,SAAQ,4BAAwC;CAAG;;;;;;;;;;;;AACxF,qBAAa,kBAAmB,SAAQ,uBAAmC;CAAG;;;;;AAC9E,qBAAa,yBAA0B,SAAQ,8BAA0C;CAAG"}

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

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryExportRequestDto = exports.TelemetrySchemaDto = exports.TelemetryQueryResultDto = exports.TelemetryQueryRequestDto = exports.telemetrySchemaSchema = exports.telemetryQueryResultSchema = exports.telemetryQueryRequestSchema = exports.telemetryExportRequestSchema = exports.telemetrySchemaTableSchema = exports.telemetrySchemaColumnSchema = exports.telemetryColumnSchema = exports.TELEMETRY_SQL_MAX_LENGTH = exports.TELEMETRY_QUERY_MAX_ROWS_CEILING = exports.TELEMETRY_EXPORT_FORMATS = exports.TELEMETRY_COLUMN_TYPES = void 0;
+const nestjs_zod_1 = require("nestjs-zod");
+const telemetry_1 = require("@marinoscar/platform-contract/telemetry");
+Object.defineProperty(exports, "telemetryExportRequestSchema", { enumerable: true, get: function () { return telemetry_1.telemetryExportRequestSchema; } });
+Object.defineProperty(exports, "telemetryQueryRequestSchema", { enumerable: true, get: function () { return telemetry_1.telemetryQueryRequestSchema; } });
+Object.defineProperty(exports, "telemetryQueryResultSchema", { enumerable: true, get: function () { return telemetry_1.telemetryQueryResultSchema; } });
+Object.defineProperty(exports, "telemetrySchemaSchema", { enumerable: true, get: function () { return telemetry_1.telemetrySchemaSchema; } });
+// =============================================================================
+// Telemetry explorer — request and response shapes (issue #535, epic #528)
+// =============================================================================
+//
+//   POST /api/admin/telemetry/query    TelemetryQueryRequestDto  → TelemetryQueryResultDto
+//   GET  /api/admin/telemetry/schema                              → TelemetrySchemaDto
+//   POST /api/admin/telemetry/export   TelemetryExportRequestDto → file (binary)
+//
+// The schemas and limits live in `@marinoscar/platform-contract/telemetry`
+// (#702); this file wraps them as nestjs-zod DTOs and re-exports the names
+// services import.
+// =============================================================================
+var telemetry_2 = require("@marinoscar/platform-contract/telemetry");
+Object.defineProperty(exports, "TELEMETRY_COLUMN_TYPES", { enumerable: true, get: function () { return telemetry_2.TELEMETRY_COLUMN_TYPES; } });
+Object.defineProperty(exports, "TELEMETRY_EXPORT_FORMATS", { enumerable: true, get: function () { return telemetry_2.TELEMETRY_EXPORT_FORMATS; } });
+Object.defineProperty(exports, "TELEMETRY_QUERY_MAX_ROWS_CEILING", { enumerable: true, get: function () { return telemetry_2.TELEMETRY_QUERY_MAX_ROWS_CEILING; } });
+Object.defineProperty(exports, "TELEMETRY_SQL_MAX_LENGTH", { enumerable: true, get: function () { return telemetry_2.TELEMETRY_SQL_MAX_LENGTH; } });
+Object.defineProperty(exports, "telemetryColumnSchema", { enumerable: true, get: function () { return telemetry_2.telemetryColumnSchema; } });
+Object.defineProperty(exports, "telemetrySchemaColumnSchema", { enumerable: true, get: function () { return telemetry_2.telemetrySchemaColumnSchema; } });
+Object.defineProperty(exports, "telemetrySchemaTableSchema", { enumerable: true, get: function () { return telemetry_2.telemetrySchemaTableSchema; } });
+class TelemetryQueryRequestDto extends (0, nestjs_zod_1.createZodDto)(telemetry_1.telemetryQueryRequestSchema) {
+}
+exports.TelemetryQueryRequestDto = TelemetryQueryRequestDto;
+class TelemetryQueryResultDto extends (0, nestjs_zod_1.createZodDto)(telemetry_1.telemetryQueryResultSchema) {
+}
+exports.TelemetryQueryResultDto = TelemetryQueryResultDto;
+class TelemetrySchemaDto extends (0, nestjs_zod_1.createZodDto)(telemetry_1.telemetrySchemaSchema) {
+}
+exports.TelemetrySchemaDto = TelemetrySchemaDto;
+class TelemetryExportRequestDto extends (0, nestjs_zod_1.createZodDto)(telemetry_1.telemetryExportRequestSchema) {
+}
+exports.TelemetryExportRequestDto = TelemetryExportRequestDto;
+//# sourceMappingURL=telemetry-query.dto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-query.dto.js","sourceRoot":"","sources":["../../../src/telemetry/dto/telemetry-query.dto.ts"],"names":[],"mappings":";;;AAAA,2CAA0C;AAE1C,uEAMiD;AAwBxC,6GA7BP,wCAA4B,OA6BO;AAAE,4GA5BrC,uCAA2B,OA4BqC;AAAE,2GA3BlE,sCAA0B,OA2BkE;AAAE,sGA1B9F,iCAAqB,OA0B8F;AAtBrH,gFAAgF;AAChF,2EAA2E;AAC3E,gFAAgF;AAChF,EAAE;AACF,2FAA2F;AAC3F,uFAAuF;AACvF,iFAAiF;AACjF,EAAE;AACF,2EAA2E;AAC3E,2EAA2E;AAC3E,mBAAmB;AACnB,gFAAgF;AAEhF,qEAQiD;AAP/C,mHAAA,sBAAsB,OAAA;AACtB,qHAAA,wBAAwB,OAAA;AACxB,6HAAA,gCAAgC,OAAA;AAChC,qHAAA,wBAAwB,OAAA;AACxB,kHAAA,qBAAqB,OAAA;AACrB,wHAAA,2BAA2B,OAAA;AAC3B,uHAAA,0BAA0B,OAAA;AAa5B,MAAa,wBAAyB,SAAQ,IAAA,yBAAY,EAAC,uCAA2B,CAAC;CAAG;AAA1F,4DAA0F;AAC1F,MAAa,uBAAwB,SAAQ,IAAA,yBAAY,EAAC,sCAA0B,CAAC;CAAG;AAAxF,0DAAwF;AACxF,MAAa,kBAAmB,SAAQ,IAAA,yBAAY,EAAC,iCAAqB,CAAC;CAAG;AAA9E,gDAA8E;AAC9E,MAAa,yBAA0B,SAAQ,IAAA,yBAAY,EAAC,wCAA4B,CAAC;CAAG;AAA5F,8DAA4F"}

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

@@ -0,0 +1,22 @@
+import { telemetryStatusSchema, telemetryTableSchema, telemetryTtlSchema } from '@marinoscar/platform-contract/telemetry';
+export { telemetryStatusSchema, telemetryTableSchema, telemetryTtlSchema };
+export type { TelemetryStatus, TelemetryTtl } from '@marinoscar/platform-contract/telemetry';
+declare const TelemetryStatusDto_base: import("nestjs-zod").ZodDto<import("zod").ZodObject<{
+    configured: import("zod").ZodBoolean;
+    reachable: import("zod").ZodBoolean;
+    version: import("zod").ZodNullable<import("zod").ZodString>;
+    database: import("zod").ZodString;
+    ttl: import("zod").ZodNullable<import("zod").ZodObject<{
+        raw: import("zod").ZodString;
+        days: import("zod").ZodNullable<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+    retentionDays: import("zod").ZodNumber;
+    tables: import("zod").ZodArray<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        rows: import("zod").ZodNullable<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+    error: import("zod").ZodNullable<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, false>;
+export declare class TelemetryStatusDto extends TelemetryStatusDto_base {
+}
+//# sourceMappingURL=telemetry-status.dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-status.dto.d.ts","sourceRoot":"","sources":["../../../src/telemetry/dto/telemetry-status.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAY1H,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,CAAC;AAC3E,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;;;;;;;;;;;;;;;;;AAE7F,qBAAa,kBAAmB,SAAQ,uBAAmC;CAAG"}

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

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryStatusDto = exports.telemetryTtlSchema = exports.telemetryTableSchema = exports.telemetryStatusSchema = void 0;
+const nestjs_zod_1 = require("nestjs-zod");
+const telemetry_1 = require("@marinoscar/platform-contract/telemetry");
+Object.defineProperty(exports, "telemetryStatusSchema", { enumerable: true, get: function () { return telemetry_1.telemetryStatusSchema; } });
+Object.defineProperty(exports, "telemetryTableSchema", { enumerable: true, get: function () { return telemetry_1.telemetryTableSchema; } });
+Object.defineProperty(exports, "telemetryTtlSchema", { enumerable: true, get: function () { return telemetry_1.telemetryTtlSchema; } });
+class TelemetryStatusDto extends (0, nestjs_zod_1.createZodDto)(telemetry_1.telemetryStatusSchema) {
+}
+exports.TelemetryStatusDto = TelemetryStatusDto;
+//# sourceMappingURL=telemetry-status.dto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-status.dto.js","sourceRoot":"","sources":["../../../src/telemetry/dto/telemetry-status.dto.ts"],"names":[],"mappings":";;;AAAA,2CAA0C;AAE1C,uEAA0H;AAYjH,sGAZA,iCAAqB,OAYA;AAAE,qGAZA,gCAAoB,OAYA;AAAE,mGAZA,8BAAkB,OAYA;AAGxE,MAAa,kBAAmB,SAAQ,IAAA,yBAAY,EAAC,iCAAqB,CAAC;CAAG;AAA9E,gDAA8E"}

package/dist/telemetry/export/parquet-writer.loader.d.ts

@@ -0,0 +1,13 @@
+export interface ParquetColumn {
+    name: string;
+    data: unknown[];
+    type: 'BOOLEAN' | 'DOUBLE' | 'STRING';
+    nullable?: boolean;
+}
+export interface ParquetWriterModule {
+    parquetWriteBuffer(options: {
+        columnData: ParquetColumn[];
+    }): ArrayBuffer;
+}
+export declare function loadParquetWriter(): Promise<ParquetWriterModule>;
+//# sourceMappingURL=parquet-writer.loader.d.ts.map

package/dist/telemetry/export/parquet-writer.loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parquet-writer.loader.d.ts","sourceRoot":"","sources":["../../../src/telemetry/export/parquet-writer.loader.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,CAAC,OAAO,EAAE;QAAE,UAAU,EAAE,aAAa,EAAE,CAAA;KAAE,GAAG,WAAW,CAAC;CAC3E;AAID,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAOhE"}

package/dist/telemetry/export/parquet-writer.loader.js

@@ -0,0 +1,29 @@
+"use strict";
+// =============================================================================
+// Loading `hyparquet-writer` from CommonJS (issue #535)
+// =============================================================================
+//
+// `hyparquet-writer` is ESM-only. The API compiles to CommonJS with
+// `module: NodeNext`, under which TypeScript leaves a dynamic `import()` in a
+// CommonJS file AS A REAL `import()` (it does not rewrite it to `require`), so
+// this works in the built API on any supported Node — verified against the
+// compiled output.
+//
+// It is isolated in this one-function module for Jest: Jest runs specs in a
+// CommonJS VM that rejects a native `import()` (see test/jest.config.js), so a
+// spec `jest.mock`s this file instead of the package. The real writer is
+// exercised by `telemetry-export.parquet.spec.ts`, in a child Node process.
+//
+// Loaded on first use and memoised: most deployments never export Parquet.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadParquetWriter = loadParquetWriter;
+let loading = null;
+function loadParquetWriter() {
+    loading ??= import('hyparquet-writer').catch((error) => {
+        loading = null;
+        throw error;
+    });
+    return loading;
+}
+//# sourceMappingURL=parquet-writer.loader.js.map

package/dist/telemetry/export/parquet-writer.loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parquet-writer.loader.js","sourceRoot":"","sources":["../../../src/telemetry/export/parquet-writer.loader.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,wDAAwD;AACxD,gFAAgF;AAChF,EAAE;AACF,oEAAoE;AACpE,8EAA8E;AAC9E,+EAA+E;AAC/E,2EAA2E;AAC3E,mBAAmB;AACnB,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,yEAAyE;AACzE,4EAA4E;AAC5E,EAAE;AACF,2EAA2E;AAC3E,gFAAgF;;AAehF,8CAOC;AATD,IAAI,OAAO,GAAwC,IAAI,CAAC;AAExD,SAAgB,iBAAiB;IAC/B,OAAO,KAAM,MAAM,CAAC,kBAAkB,CAA6C,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC3G,OAAO,GAAG,IAAI,CAAC;QACf,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,39 @@
+import type { TelemetryExportFormat, TelemetryQueryRunResult } from '../dto/telemetry-query.dto';
+import { TelemetryQueryService } from '../query/telemetry-query.service';
+import { TelemetrySettingsService } from '../telemetry-settings.service';
+import { type ParquetColumn } from './parquet-writer.loader';
+export interface TelemetryExportFile {
+    buffer: Buffer;
+    contentType: string;
+    filename: string;
+    rowCount: number;
+    truncated: boolean;
+}
+export declare const TELEMETRY_EXPORT_CONTENT_TYPES: Record<TelemetryExportFormat, string>;
+/** Excel's hard limit on the characters in one cell. */
+export declare const XLSX_MAX_CELL_CHARS = 32767;
+export declare class TelemetryExportService {
+    private readonly query;
+    private readonly settings;
+    constructor(query: TelemetryQueryService, settings: TelemetrySettingsService);
+    export(userId: string, sql: string, format: TelemetryExportFormat, now?: Date): Promise<TelemetryExportFile>;
+}
+export declare function renderExport(result: TelemetryQueryRunResult, format: TelemetryExportFormat): Promise<Buffer>;
+/** `telemetry-20260927-142501.csv` (UTC). */
+export declare function exportFilename(format: TelemetryExportFormat, now: Date): string;
+export declare function toCsv(result: TelemetryQueryRunResult): string;
+/** Column names made unique: the second `host` becomes `host_2`, and so on. */
+export declare function uniqueColumnNames(names: string[]): string[];
+export declare function toNdjson(result: TelemetryQueryRunResult): string;
+export declare function toXlsx(result: TelemetryQueryRunResult): Promise<Buffer>;
+/**
+ * `value` as a JS number when that loses nothing: a finite number, or a
+ * decimal string whose double prints back identically. So `9007199254740993`
+ * and `18446744073709551615` (beyond a double's exact integers) stay strings,
+ * as does `1.50` (not canonical; kept verbatim rather than reformatted).
+ */
+export declare function exactNumber(value: unknown): number | null;
+/** The column data handed to `parquetWriteBuffer`. Exported for tests. */
+export declare function buildParquetColumns(result: TelemetryQueryRunResult): ParquetColumn[];
+export declare function toParquet(result: TelemetryQueryRunResult): Promise<Buffer>;
+//# sourceMappingURL=telemetry-export.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-export.service.d.ts","sourceRoot":"","sources":["../../../src/telemetry/export/telemetry-export.service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAuB,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACtH,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAmChF,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAKhF,CAAC;AAEF,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAI1C,qBACa,sBAAsB;IAE/B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,wBAAwB;IAG/C,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,EAAE,GAAG,OAAa,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAYzH;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAWlH;AAED,6CAA6C;AAC7C,wBAAgB,cAAc,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAO/E;AAID,wBAAgB,KAAK,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAc7D;AAYD,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAW3D;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAMhE;AAID,wBAAsB,MAAM,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyB7E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAOzD;AAID,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,uBAAuB,GAAG,aAAa,EAAE,CAwBpF;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAIhF"}

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

@@ -0,0 +1,185 @@
+"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.TelemetryExportService = exports.XLSX_MAX_CELL_CHARS = exports.TELEMETRY_EXPORT_CONTENT_TYPES = void 0;
+exports.renderExport = renderExport;
+exports.exportFilename = exportFilename;
+exports.toCsv = toCsv;
+exports.uniqueColumnNames = uniqueColumnNames;
+exports.toNdjson = toNdjson;
+exports.toXlsx = toXlsx;
+exports.exactNumber = exactNumber;
+exports.buildParquetColumns = buildParquetColumns;
+exports.toParquet = toParquet;
+const common_1 = require("@nestjs/common");
+const exceljs_1 = require("exceljs");
+const telemetry_query_service_1 = require("../query/telemetry-query.service");
+const telemetry_settings_service_1 = require("../telemetry-settings.service");
+const csv_1 = require("../internal/csv");
+const parquet_writer_loader_1 = require("./parquet-writer.loader");
+exports.TELEMETRY_EXPORT_CONTENT_TYPES = {
+    csv: 'text/csv; charset=utf-8',
+    ndjson: 'application/x-ndjson; charset=utf-8',
+    xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+    parquet: 'application/vnd.apache.parquet',
+};
+/** Excel's hard limit on the characters in one cell. */
+exports.XLSX_MAX_CELL_CHARS = 32_767;
+const NUMERIC_TYPES = new Set(['int2', 'int4', 'int8', 'float4', 'float8', 'numeric']);
+let TelemetryExportService = class TelemetryExportService {
+    query;
+    settings;
+    constructor(query, settings) {
+        this.query = query;
+        this.settings = settings;
+    }
+    async export(userId, sql, format, now = new Date()) {
+        const policy = await this.settings.getPolicy();
+        const result = await this.query.run(userId, sql, { source: 'export', maxRows: policy.query.maxRows });
+        return {
+            buffer: await renderExport(result, format),
+            contentType: exports.TELEMETRY_EXPORT_CONTENT_TYPES[format],
+            filename: exportFilename(format, now),
+            rowCount: result.rowCount,
+            truncated: result.truncated,
+        };
+    }
+};
+exports.TelemetryExportService = TelemetryExportService;
+exports.TelemetryExportService = TelemetryExportService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [telemetry_query_service_1.TelemetryQueryService,
+        telemetry_settings_service_1.TelemetrySettingsService])
+], TelemetryExportService);
+async function renderExport(result, format) {
+    switch (format) {
+        case 'csv':
+            return Buffer.from(toCsv(result), 'utf8');
+        case 'ndjson':
+            return Buffer.from(toNdjson(result), 'utf8');
+        case 'xlsx':
+            return toXlsx(result);
+        case 'parquet':
+            return toParquet(result);
+    }
+}
+/** `telemetry-20260927-142501.csv` (UTC). */
+function exportFilename(format, now) {
+    const pad = (n) => String(n).padStart(2, '0');
+    const stamp = `${now.getUTCFullYear()}${pad(now.getUTCMonth() + 1)}${pad(now.getUTCDate())}-` +
+        `${pad(now.getUTCHours())}${pad(now.getUTCMinutes())}${pad(now.getUTCSeconds())}`;
+    return `telemetry-${stamp}.${format}`;
+}
+// --- CSV ---------------------------------------------------------------------
+function toCsv(result) {
+    const numeric = result.columns.map((column) => NUMERIC_TYPES.has(column.type));
+    const lines = [result.columns.map((column) => (0, csv_1.csvField)((0, csv_1.neutralizeFormula)(column.name)))];
+    for (const row of result.rows) {
+        lines.push(row.map((value, index) => {
+            const text = cellText(value);
+            return (0, csv_1.csvField)(numeric[index] ? text : (0, csv_1.neutralizeFormula)(text));
+        }));
+    }
+    return csv_1.UTF8_BOM + lines.map((fields) => fields.join(',')).join('\r\n') + '\r\n';
+}
+/** A value as text: null → empty, objects/arrays → JSON. */
+function cellText(value) {
+    if (value === null || value === undefined)
+        return '';
+    if (typeof value === 'object')
+        return JSON.stringify(value);
+    return String(value);
+}
+// --- NDJSON ------------------------------------------------------------------
+/** Column names made unique: the second `host` becomes `host_2`, and so on. */
+function uniqueColumnNames(names) {
+    const taken = new Set();
+    return names.map((name) => {
+        let candidate = name;
+        for (let n = 2; taken.has(candidate); n += 1) {
+            candidate = `${name}_${n}`;
+        }
+        taken.add(candidate);
+        return candidate;
+    });
+}
+function toNdjson(result) {
+    const keys = uniqueColumnNames(result.columns.map((column) => column.name));
+    return result.rows
+        .map((row) => JSON.stringify(Object.fromEntries(keys.map((key, index) => [key, row[index] ?? null]))) + '\n')
+        .join('');
+}
+// --- XLSX --------------------------------------------------------------------
+async function toXlsx(result) {
+    const workbook = new exceljs_1.Workbook();
+    workbook.creator = 'telemetry explorer';
+    const sheet = workbook.addWorksheet('results');
+    const numeric = result.columns.map((column) => NUMERIC_TYPES.has(column.type));
+    sheet.addRow(result.columns.map((column) => column.name));
+    sheet.getRow(1).font = { bold: true };
+    for (const row of result.rows) {
+        sheet.addRow(row.map((value, index) => {
+            if (value === null || value === undefined)
+                return null;
+            if (typeof value === 'boolean')
+                return value;
+            if (numeric[index]) {
+                const exact = exactNumber(value);
+                if (exact !== null)
+                    return exact;
+            }
+            return cellText(value).slice(0, exports.XLSX_MAX_CELL_CHARS);
+        }));
+    }
+    return Buffer.from(await workbook.xlsx.writeBuffer());
+}
+/**
+ * `value` as a JS number when that loses nothing: a finite number, or a
+ * decimal string whose double prints back identically. So `9007199254740993`
+ * and `18446744073709551615` (beyond a double's exact integers) stay strings,
+ * as does `1.50` (not canonical; kept verbatim rather than reformatted).
+ */
+function exactNumber(value) {
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? value : null;
+    if (typeof value !== 'string' || !/^-?\d+(\.\d+)?(e[+-]?\d+)?$/i.test(value))
+        return null;
+    const n = Number(value);
+    return Number.isFinite(n) && String(n) === value ? n : null;
+}
+// --- Parquet -----------------------------------------------------------------
+/** The column data handed to `parquetWriteBuffer`. Exported for tests. */
+function buildParquetColumns(result) {
+    const names = uniqueColumnNames(result.columns.map((column) => column.name));
+    return result.columns.map((column, index) => {
+        const values = result.rows.map((row) => row[index] ?? null);
+        if (column.type === 'bool' && values.every((v) => v === null || typeof v === 'boolean')) {
+            return { name: names[index], type: 'BOOLEAN', data: values, nullable: true };
+        }
+        if (NUMERIC_TYPES.has(column.type)) {
+            const numbers = values.map((v) => (v === null ? null : exactNumber(v)));
+            if (numbers.every((n, i) => n !== null || values[i] === null)) {
+                return { name: names[index], type: 'DOUBLE', data: numbers, nullable: true };
+            }
+        }
+        return {
+            name: names[index],
+            type: 'STRING',
+            data: values.map((v) => (v === null ? null : cellText(v))),
+            nullable: true,
+        };
+    });
+}
+async function toParquet(result) {
+    const { parquetWriteBuffer } = await (0, parquet_writer_loader_1.loadParquetWriter)();
+    return Buffer.from(parquetWriteBuffer({ columnData: buildParquetColumns(result) }));
+}
+//# sourceMappingURL=telemetry-export.service.js.map

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

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

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

@@ -0,0 +1,27 @@
+import { OnModuleInit } from '@nestjs/common';
+import { type TelemetryStore } from '../stores/telemetry-store';
+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;
+export { retentionStatement } from '../stores/greptime/greptime.retention';
+export declare class TelemetryRetentionHandler implements TelemetryJobHandler, OnModuleInit {
+    private readonly jobs;
+    private readonly systemSettings;
+    private readonly store;
+    private readonly logger;
+    readonly type = "telemetry.retention.apply";
+    readonly label = "Telemetry retention";
+    /** One metadata statement; a minute is generous. Retried like any housekeeping job. */
+    readonly profile: TelemetryJobExecutionProfile;
+    constructor(jobs: TelemetryJobsPort, systemSettings: TelemetrySettingsStore, store: TelemetryStore);
+    onModuleInit(): void;
+    /** Throws to fail (the store 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":"AAmCA,OAAO,EAA8B,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACjF,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;AAI/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAE3E,qBACa,yBAA0B,YAAW,mBAAmB,EAAE,YAAY;IAavD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACX,OAAO,CAAC,QAAQ,CAAC,cAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK;IAdjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;IAErE,QAAQ,CAAC,IAAI,+BAA4B;IAEzC,QAAQ,CAAC,KAAK,yBAAyB;IAEvC,uFAAuF;IACvF,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAA4C;gBAK/C,IAAI,EAAE,iBAAiB,EACb,cAAc,EAAE,sBAAsB,EAC/C,KAAK,EAAE,cAAc;IAGjE,YAAY,IAAI,IAAI;IAIpB,wFAAwF;IAClF,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CAkCvC"}

package/dist/telemetry/handlers/telemetry-retention.handler.js

@@ -0,0 +1,114 @@
+"use strict";
+// =============================================================================
+// `telemetry.retention.apply` job handler (issue #534, epic #528; PP-14.11)
+// =============================================================================
+//
+// Makes the telemetry store's retention match `telemetry.retentionDays` through
+// the store's retention control (`TelemetryStore.retention`). For the built-in
+// GreptimeDB store that is
+//
+//     ALTER DATABASE <database> SET 'ttl'='<N>d'
+//
+// (`stores/greptime/greptime.retention.ts` owns the statement and its
+// identifier rule). GreptimeDB enforces the TTL itself during compaction; this
+// job only states the policy, it deletes nothing directly.
+//
+// IDEMPOTENT: setting the retention to the value it already has is a no-op, so
+// a retry, a duplicate run, or the daily re-assertion (`TelemetryRetentionTask`)
+// are all harmless. Enqueued by that cron and by every successful
+// `PUT /api/admin/telemetry/config`.
+//
+// NOT GATED ON `telemetry.enabled`. Retention is a data-hygiene policy: a
+// deployment that switched collection off still wants what it already
+// collected to age out.
+//
+// A DEPLOYMENT WITHOUT A STORE (or whose store cannot change retention right
+// now, e.g. the GreptimeDB admin credential is missing, or a store with no
+// retention control) completes as a NO-OP with a log line rather than failing:
+// that is a supported configuration, and failing would put a red row in the
+// jobs dashboard every night for a feature the operator never deployed.
+//
+// SERVER-ONLY, PERMANENTLY: no `nodeResultSchema`/`persistNodeResult`. The
+// built-in statement needs the GreptimeDB ADMIN credential — one able to change
+// retention and drop telemetry — and a worker node must never hold it
+// (CLAUDE.md, queue rule 3).
+// =============================================================================
+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 TelemetryRetentionHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryRetentionHandler = exports.retentionStatement = exports.TELEMETRY_RETENTION_STATEMENT_TIMEOUT_MS = exports.TELEMETRY_RETENTION_TYPE = void 0;
+const common_1 = require("@nestjs/common");
+const telemetry_store_1 = require("../stores/telemetry-store");
+const ports_1 = require("../ports");
+/**
+ * The job type. PERMANENT once rows of it exist.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_RETENTION_TYPE = 'telemetry.retention.apply';
+/** Client-side ceiling on the ALTER. It is a metadata change; seconds, not minutes. */
+exports.TELEMETRY_RETENTION_STATEMENT_TIMEOUT_MS = 30_000;
+// The statement lives with the built-in store; re-exported for the callers
+// (and the tests) that pinned its text here.
+var greptime_retention_1 = require("../stores/greptime/greptime.retention");
+Object.defineProperty(exports, "retentionStatement", { enumerable: true, get: function () { return greptime_retention_1.retentionStatement; } });
+let TelemetryRetentionHandler = TelemetryRetentionHandler_1 = class TelemetryRetentionHandler {
+    jobs;
+    systemSettings;
+    store;
+    logger = new common_1.Logger(TelemetryRetentionHandler_1.name);
+    type = exports.TELEMETRY_RETENTION_TYPE;
+    label = 'Telemetry retention';
+    /** One metadata statement; a minute is generous. Retried like any housekeeping job. */
+    profile = { maxRuntimeMs: 60_000, maxAttempts: 3 };
+    // Deliberately NO `nodeResultSchema` / `persistNodeResult` — see the header.
+    constructor(jobs, systemSettings, store) {
+        this.jobs = jobs;
+        this.systemSettings = systemSettings;
+        this.store = store;
+    }
+    onModuleInit() {
+        this.jobs.registerHandler(this);
+    }
+    /** Throws to fail (the store unreachable or refusing), so the queue's retry applies. */
+    async process(job) {
+        if (!this.store.isConfigured()) {
+            this.logger.log(`Telemetry retention skipped: no telemetry store is configured (see /admin/settings/telemetry) (job ${job.id})`);
+            return;
+        }
+        const retention = this.store.retention;
+        if (!retention) {
+            this.logger.log(`Telemetry retention skipped: the "${this.store.id}" store has no retention control (job ${job.id})`);
+            return;
+        }
+        if (!retention.isApplicable()) {
+            this.logger.warn('Telemetry retention skipped: the telemetry store cannot change retention right now ' +
+                '(for GreptimeDB, the admin login is not configured: set it at /admin/settings/telemetry), ' +
+                `so the database TTL cannot be changed (job ${job.id})`);
+            return;
+        }
+        const { retentionDays } = await this.systemSettings.getTelemetryPolicy();
+        await retention.apply(retentionDays, { timeoutMs: exports.TELEMETRY_RETENTION_STATEMENT_TIMEOUT_MS });
+        this.logger.log(`Telemetry retention applied: database "${this.store.database}" retention is ${retentionDays} day(s) (job ${job.id})`);
+    }
+};
+exports.TelemetryRetentionHandler = TelemetryRetentionHandler;
+exports.TelemetryRetentionHandler = TelemetryRetentionHandler = TelemetryRetentionHandler_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(ports_1.TELEMETRY_JOBS)),
+    __param(1, (0, common_1.Inject)(ports_1.TELEMETRY_SETTINGS_STORE)),
+    __param(2, (0, common_1.Inject)(telemetry_store_1.TELEMETRY_STORE)),
+    __metadata("design:paramtypes", [Object, Object, Object])
+], TelemetryRetentionHandler);
+//# sourceMappingURL=telemetry-retention.handler.js.map

package/dist/telemetry/handlers/telemetry-retention.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-retention.handler.js","sourceRoot":"","sources":["../../../src/telemetry/handlers/telemetry-retention.handler.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,4EAA4E;AAC5E,gFAAgF;AAChF,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,2BAA2B;AAC3B,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,+EAA+E;AAC/E,2DAA2D;AAC3D,EAAE;AACF,+EAA+E;AAC/E,iFAAiF;AACjF,kEAAkE;AAClE,qCAAqC;AACrC,EAAE;AACF,0EAA0E;AAC1E,sEAAsE;AACtE,wBAAwB;AACxB,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,+EAA+E;AAC/E,4EAA4E;AAC5E,wEAAwE;AACxE,EAAE;AACF,2EAA2E;AAC3E,gFAAgF;AAChF,sEAAsE;AACtE,6BAA6B;AAC7B,gFAAgF;;;;;;;;;;;;;;;;AAEhF,2CAA0E;AAE1E,+DAAiF;AACjF,oCAQkB;AAElB;;;;GAIG;AACU,QAAA,wBAAwB,GAAG,2BAA2B,CAAC;AAEpE,uFAAuF;AAC1E,QAAA,wCAAwC,GAAG,MAAM,CAAC;AAE/D,2EAA2E;AAC3E,6CAA6C;AAC7C,4EAA2E;AAAlE,wHAAA,kBAAkB,OAAA;AAGpB,IAAM,yBAAyB,iCAA/B,MAAM,yBAAyB;IAaO;IACU;IACT;IAd3B,MAAM,GAAG,IAAI,eAAM,CAAC,2BAAyB,CAAC,IAAI,CAAC,CAAC;IAE5D,IAAI,GAAG,gCAAwB,CAAC;IAEhC,KAAK,GAAG,qBAAqB,CAAC;IAEvC,uFAAuF;IAC9E,OAAO,GAAiC,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;IAE1F,6EAA6E;IAE7E,YAC2C,IAAuB,EACb,cAAsC,EAC/C,KAAqB;QAFtB,SAAI,GAAJ,IAAI,CAAmB;QACb,mBAAc,GAAd,cAAc,CAAwB;QAC/C,UAAK,GAAL,KAAK,CAAgB;IAC9D,CAAC;IAEJ,YAAY;QACV,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,wFAAwF;IACxF,KAAK,CAAC,OAAO,CAAC,GAAQ;QACpB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,sGAAsG,GAAG,CAAC,EAAE,GAAG,CAChH,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;QAEvC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,qCAAqC,IAAI,CAAC,KAAK,CAAC,EAAE,yCAAyC,GAAG,CAAC,EAAE,GAAG,CACrG,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,qFAAqF;gBACnF,4FAA4F;gBAC5F,8CAA8C,GAAG,CAAC,EAAE,GAAG,CAC1D,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,kBAAkB,EAAE,CAAC;QAEzE,MAAM,SAAS,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,gDAAwC,EAAE,CAAC,CAAC;QAE9F,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,0CAA0C,IAAI,CAAC,KAAK,CAAC,QAAQ,kBAAkB,aAAa,gBAAgB,GAAG,CAAC,EAAE,GAAG,CACtH,CAAC;IACJ,CAAC;CACF,CAAA;AAzDY,8DAAyB;oCAAzB,yBAAyB;IADrC,IAAA,mBAAU,GAAE;IAcR,WAAA,IAAA,eAAM,EAAC,sBAAc,CAAC,CAAA;IACtB,WAAA,IAAA,eAAM,EAAC,gCAAwB,CAAC,CAAA;IAChC,WAAA,IAAA,eAAM,EAAC,iCAAe,CAAC,CAAA;;GAff,yBAAyB,CAyDrC"}