typekro 0.22.1 → 0.23.0

package/dist/factories/clickhouse/resources/installation.js

@@ -0,0 +1,316 @@
+/**
+ * ClickHouseInstallation (CHI) Factory
+ *
+ * Compiles a high-level typed config into a `clickhouse.altinity.com/v1`
+ * ClickHouseInstallation managed by the Altinity clickhouse-operator.
+ *
+ * THE POINT of this typed factory is the zone-pinned layout: the operator's
+ * `podDistribution` supports only the `kubernetes.io/hostname` topologyKey
+ * (Altinity/clickhouse-operator#772), so per-zone spreading must be compiled
+ * as a per-replica `layout.replicas:` list with zone-pinned pod templates.
+ * On EKS, EBS volumes are zonal — a replica rescheduled into another AZ
+ * strands its PVC (production incident) — so `zones` should be set for any
+ * multi-replica production CHI.
+ *
+ * CHI shape follows the official examples
+ * (docs/chi-examples/01-simple-layout-01-1shard-1repl.yaml and
+ * 14-zones-distribution-01.yaml in the operator repo).
+ */
+import { isCelExpression, isKubernetesRef } from '../../../utils/type-guards.js';
+import { createResource } from '../../shared.js';
+import { assertPositiveIntegerCount } from '../utils/validation.js';
+import { compileZonePinnedLayout } from '../utils/zone-layout.js';
+/**
+ * Known CHI/CHK reconcile status strings.
+ *
+ * Source: clickhouse-operator `pkg/apis/clickhouse.altinity.com/v1/type_status.go`
+ * (StatusInProgress/StatusCompleted/StatusAborted/StatusTerminating). The
+ * operator writes them to `status.status`; `Completed` means the installation
+ * is fully reconciled.
+ */
+export const CHI_STATUS = {
+    IN_PROGRESS: 'InProgress',
+    COMPLETED: 'Completed',
+    ABORTED: 'Aborted',
+    TERMINATING: 'Terminating',
+};
+/**
+ * CHI/CHK Readiness Evaluator
+ *
+ * Keys off the operator-reported `status.status` reconcile state (see
+ * CHI_STATUS). Unlike condition-based CRDs, the clickhouse-operator reports a
+ * single status string plus host progress counters.
+ */
+export function chiReadinessEvaluator(liveResource) {
+    const resource = liveResource;
+    const status = resource?.status;
+    if (!status || status.status === undefined) {
+        return {
+            ready: false,
+            message: 'Installation has no status yet',
+            reason: 'StatusMissing',
+        };
+    }
+    if (status.status === CHI_STATUS.COMPLETED) {
+        return {
+            ready: true,
+            message: `Installation reconciled (${status.hostsCompletedCount ?? status.hostsCount ?? 0}/${status.hostsCount ?? 0} hosts)`,
+            reason: 'Completed',
+        };
+    }
+    if (status.status === CHI_STATUS.IN_PROGRESS) {
+        return {
+            ready: false,
+            message: `Reconcile in progress (${status.hostsCompletedCount ?? 0}/${status.hostsCount ?? 0} hosts)`,
+            reason: 'InProgress',
+        };
+    }
+    if (status.status === CHI_STATUS.ABORTED) {
+        return {
+            ready: false,
+            message: `Reconcile aborted${status.errors?.length ? `: ${status.errors[0]}` : ''}`,
+            reason: 'Aborted',
+        };
+    }
+    if (status.status === CHI_STATUS.TERMINATING) {
+        return {
+            ready: false,
+            message: 'Installation is terminating',
+            reason: 'Terminating',
+        };
+    }
+    return {
+        ready: false,
+        message: `Unknown installation status: ${status.status}`,
+        reason: 'UnknownStatus',
+    };
+}
+/** Default ClickHouse server image repository. */
+const DEFAULT_CLICKHOUSE_IMAGE_REPOSITORY = 'clickhouse/clickhouse-server';
+/**
+ * Default logical cluster name.
+ *
+ * SIGNOZ COMPATIBILITY: SigNoz's ClickHouse migrations hardcode the cluster
+ * name `cluster`, so a CHI consumed by SigNoz MUST keep this default.
+ */
+export const DEFAULT_CHI_CLUSTER_NAME = 'cluster';
+/** Name of the generated data volume claim template. */
+const DATA_VOLUME_TEMPLATE = 'data-volume';
+/** Base name for generated pod templates. */
+const POD_TEMPLATE_BASE = 'clickhouse';
+/** True when the value is a graph reference (KubernetesRef or CEL expression). */
+function isGraphRef(value) {
+    return isKubernetesRef(value) || isCelExpression(value);
+}
+/**
+ * LOUD build-time validation: the CHI compiler BRANCHES on these fields
+ * (zone round-robin, template enumeration, path-keyed user settings), so a
+ * KubernetesRef/CEL expression here can never work — it would either crash
+ * graph construction or serialize garbage paths. Fail fast with a pointer to
+ * the build-time constructor instead of leaking `__KUBERNETES_REF__` markers.
+ */
+function assertConcreteTopology(config) {
+    const reject = (field) => {
+        throw new Error(`clickHouseInstallation: '${field}' is a BUILD-TIME topology field and received a ` +
+            `schema reference or CEL expression. The compiler enumerates pod templates and ` +
+            `per-replica layout entries from it, so it must be a concrete JS value. ` +
+            `For schema-driven compositions, fix the topology at construction time with ` +
+            `makeClickHouseCluster({ zones, replicas, shards, users }) and pass only runtime ` +
+            `fields (name, version, storage, credentials, keeper host) through the spec.`);
+    };
+    if (isGraphRef(config.shards))
+        reject('shards');
+    if (isGraphRef(config.replicas))
+        reject('replicas');
+    if (isGraphRef(config.zones))
+        reject('zones');
+    if (Array.isArray(config.zones)) {
+        for (const zone of config.zones) {
+            if (isGraphRef(zone))
+                reject('zones[]');
+        }
+    }
+    if (isGraphRef(config.users))
+        reject('users');
+    if (Array.isArray(config.users)) {
+        config.users.forEach((user, index) => {
+            if (isGraphRef(user))
+                reject(`users[${index}]`);
+            if (isGraphRef(user.name))
+                reject(`users[${index}].name`);
+        });
+    }
+}
+/**
+ * Flatten the typed users ARRAY to the operator's path-keyed format.
+ *
+ * User names become path fragments (`<user>/password_sha256_hex`) — they are
+ * validated concrete by `assertConcreteTopology`. The password hash and
+ * networks are plain VALUES and may be schema references (they serialize to
+ * CEL cleanly).
+ */
+function compileUsers(users) {
+    const compiled = {};
+    for (const user of users) {
+        if (user.passwordSha256Hex !== undefined) {
+            compiled[`${user.name}/password_sha256_hex`] = user.passwordSha256Hex;
+        }
+        if (user.networksIp !== undefined) {
+            compiled[`${user.name}/networks/ip`] = user.networksIp;
+        }
+    }
+    return compiled;
+}
+/** Compile the high-level config into a full CHI spec. */
+function compileInstallationSpec(config) {
+    assertConcreteTopology(config);
+    const shards = config.shards ?? 1;
+    const replicas = config.replicas ?? 1;
+    // SHARED count validation for BOTH layout paths: the plain homogeneous
+    // layout would otherwise emit `shardsCount: 0` / `replicasCount: 0` —
+    // invalid operator input the zone-pinned path already rejected.
+    assertPositiveIntegerCount('clickHouseInstallation', 'shards', shards);
+    assertPositiveIntegerCount('clickHouseInstallation', 'replicas', replicas);
+    const clusterName = config.clusterName ?? DEFAULT_CHI_CLUSTER_NAME;
+    const image = config.image ?? `${DEFAULT_CLICKHOUSE_IMAGE_REPOSITORY}:${config.version}`;
+    const zones = config.zones ?? [];
+    // Shared ClickHouse server pod spec (per-zone templates add affinity).
+    const podSpec = {
+        containers: [
+            {
+                name: 'clickhouse',
+                image,
+                ...(config.podResources && { resources: config.podResources }),
+            },
+        ],
+    };
+    // Storage claim: only storageClassName is set from input. On EKS the class
+    // should be a WaitForFirstConsumer + allowVolumeExpansion gp3 StorageClass
+    // so the PVC binds in the zone the scheduler picks (and can expand later);
+    // WaitForFirstConsumer is a StorageClass property, not a PVC field.
+    const volumeClaimTemplates = [
+        {
+            name: DATA_VOLUME_TEMPLATE,
+            spec: {
+                accessModes: ['ReadWriteOnce'],
+                resources: { requests: { storage: config.storage.size } },
+                ...(config.storage.storageClassName && {
+                    storageClassName: config.storage.storageClassName,
+                }),
+            },
+        },
+    ];
+    let layout;
+    let podTemplates;
+    let defaultPodTemplate;
+    if (zones.length > 0) {
+        // Zone-pinned per-replica layout: NO replicasCount — the explicit
+        // replicas list defines the replica count, and each replica references
+        // its zone's nodeAffinity-pinned pod template (round-robin across zones
+        // when replicas > zones.length). See utils/zone-layout.ts.
+        const zonePinned = compileZonePinnedLayout({
+            replicaCount: replicas,
+            zones,
+            podTemplateBaseName: POD_TEMPLATE_BASE,
+            podSpec,
+        });
+        podTemplates = zonePinned.podTemplates;
+        layout = {
+            clusters: [
+                {
+                    name: clusterName,
+                    layout: {
+                        shardsCount: shards,
+                        replicas: zonePinned.replicas,
+                    },
+                },
+            ],
+        };
+    }
+    else {
+        // Plain homogeneous layout: shardsCount x replicasCount with one shared
+        // pod template applied via defaults.
+        podTemplates = [{ name: POD_TEMPLATE_BASE, spec: podSpec }];
+        defaultPodTemplate = POD_TEMPLATE_BASE;
+        layout = {
+            clusters: [
+                {
+                    name: clusterName,
+                    layout: {
+                        shardsCount: shards,
+                        replicasCount: replicas,
+                    },
+                },
+            ],
+        };
+    }
+    return {
+        defaults: {
+            templates: {
+                ...(defaultPodTemplate && { podTemplate: defaultPodTemplate }),
+                dataVolumeClaimTemplate: DATA_VOLUME_TEMPLATE,
+            },
+        },
+        configuration: {
+            ...layout,
+            // The operator's `zookeeper` section serves clickhouse-keeper too.
+            ...(config.keeper && {
+                zookeeper: {
+                    nodes: [
+                        { host: config.keeper.host, port: config.keeper.port ?? 2181 },
+                    ],
+                },
+            }),
+            ...(config.users && { users: compileUsers(config.users) }),
+        },
+        templates: {
+            podTemplates,
+            volumeClaimTemplates,
+        },
+    };
+}
+/**
+ * ClickHouseInstallation Factory (LOW-LEVEL, concrete topology)
+ *
+ * Creates a ClickHouse cluster managed by the Altinity clickhouse-operator.
+ *
+ * BUILD-TIME topology fields (`shards`, `replicas`, `zones`, user names) must
+ * be concrete JS values — the factory throws loudly if any receives a schema
+ * reference (the compiler enumerates templates/replica entries from them).
+ * Prefer `makeClickHouseCluster()` in compositions: it fixes the topology at
+ * construction time and exposes only proxy-safe runtime spec.
+ *
+ * @param config - High-level installation configuration
+ * @returns Enhanced ClickHouseInstallation resource with readiness evaluation
+ *
+ * @example
+ * ```typescript
+ * const chi = clickHouseInstallation({
+ *   name: 'signoz-clickhouse',
+ *   namespace: 'observability',
+ *   version: '25.12.5',                     // SigNoz-coupled server version
+ *   shards: 1,
+ *   replicas: 2,
+ *   zones: ['us-east-2a', 'us-east-2b'],    // zone-pinned replicas (EBS is zonal)
+ *   storage: { size: '100Gi', storageClassName: 'gp3-expandable' },
+ *   users: [{ name: 'signoz', passwordSha256Hex: '...', networksIp: ['::/0'] }],
+ *   keeper: { host: 'keeper-signoz.observability.svc.cluster.local' },
+ *   id: 'signozClickhouse',
+ * });
+ * ```
+ */
+function createClickHouseInstallationResource(config) {
+    const spec = compileInstallationSpec(config);
+    return createResource({
+        apiVersion: 'clickhouse.altinity.com/v1',
+        kind: 'ClickHouseInstallation',
+        metadata: {
+            name: config.name,
+            ...(config.namespace && { namespace: config.namespace }),
+        },
+        spec,
+        ...(config.id && { id: config.id }),
+    }, { scope: 'namespaced', dnsAddressable: true }).withReadinessEvaluator(chiReadinessEvaluator);
+}
+export const clickHouseInstallation = createClickHouseInstallationResource;
+//# sourceMappingURL=installation.js.map

package/dist/factories/clickhouse/resources/installation.js.map

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

package/dist/factories/clickhouse/resources/keeper.d.ts

@@ -0,0 +1,40 @@
+/**
+ * ClickHouseKeeperInstallation (CHK) Factory
+ *
+ * Minimal typed factory for the `clickhouse-keeper.altinity.com/v1`
+ * ClickHouseKeeperInstallation CRD (coordination service for replicated
+ * ClickHouse tables — the modern replacement for ZooKeeper), managed by the
+ * same Altinity clickhouse-operator install as CHI resources.
+ */
+import type { Composable, Enhanced, ResourceStatus } from '../../../core/types/index.js';
+import type { ClickHouseKeeperInstallationConfig, ClickHouseKeeperInstallationSpec, ClickHouseKeeperInstallationStatus } from '../types.js';
+/**
+ * CHK Readiness Evaluator
+ *
+ * CHK reports the same `status.status` reconcile state machine as CHI
+ * ('InProgress' | 'Completed' | 'Aborted' | 'Terminating' — shared operator
+ * status code), so the CHI evaluator applies verbatim.
+ */
+export declare function chkReadinessEvaluator(liveResource: unknown): ResourceStatus;
+/**
+ * ClickHouseKeeperInstallation Factory
+ *
+ * @param config - High-level keeper configuration
+ * @returns Enhanced ClickHouseKeeperInstallation resource with readiness
+ *   evaluation
+ *
+ * @example
+ * ```typescript
+ * const keeper = clickHouseKeeperInstallation({
+ *   name: 'keeper',
+ *   namespace: 'observability',
+ *   replicas: 3, // odd count for quorum
+ *   storage: { size: '10Gi', storageClassName: 'gp3-expandable' },
+ *   id: 'clickhouseKeeper',
+ * });
+ * ```
+ */
+declare function createClickHouseKeeperInstallationResource(config: Composable<ClickHouseKeeperInstallationConfig>): Enhanced<ClickHouseKeeperInstallationSpec, ClickHouseKeeperInstallationStatus>;
+export declare const clickHouseKeeperInstallation: typeof createClickHouseKeeperInstallationResource;
+export {};
+//# sourceMappingURL=keeper.d.ts.map

package/dist/factories/clickhouse/resources/keeper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keeper.d.ts","sourceRoot":"","sources":["../../../../src/factories/clickhouse/resources/keeper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGzF,OAAO,KAAK,EACV,kCAAkC,EAClC,gCAAgC,EAChC,kCAAkC,EACnC,MAAM,aAAa,CAAC;AAOrB;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,OAAO,GAAG,cAAc,CAE3E;AA2DD;;;;;;;;;;;;;;;;;GAiBG;AACH,iBAAS,0CAA0C,CACjD,MAAM,EAAE,UAAU,CAAC,kCAAkC,CAAC,GACrD,QAAQ,CAAC,gCAAgC,EAAE,kCAAkC,CAAC,CAmBhF;AAED,eAAO,MAAM,4BAA4B,mDAA6C,CAAC"}

package/dist/factories/clickhouse/resources/keeper.js

@@ -0,0 +1,107 @@
+/**
+ * ClickHouseKeeperInstallation (CHK) Factory
+ *
+ * Minimal typed factory for the `clickhouse-keeper.altinity.com/v1`
+ * ClickHouseKeeperInstallation CRD (coordination service for replicated
+ * ClickHouse tables — the modern replacement for ZooKeeper), managed by the
+ * same Altinity clickhouse-operator install as CHI resources.
+ */
+import { isCelExpression, isKubernetesRef } from '../../../utils/type-guards.js';
+import { createResource } from '../../shared.js';
+import { assertPositiveIntegerCount } from '../utils/validation.js';
+import { chiReadinessEvaluator } from './installation.js';
+/** Name of the generated keeper data volume claim template. */
+const KEEPER_DATA_VOLUME_TEMPLATE = 'data-volume';
+/**
+ * CHK Readiness Evaluator
+ *
+ * CHK reports the same `status.status` reconcile state machine as CHI
+ * ('InProgress' | 'Completed' | 'Aborted' | 'Terminating' — shared operator
+ * status code), so the CHI evaluator applies verbatim.
+ */
+export function chkReadinessEvaluator(liveResource) {
+    return chiReadinessEvaluator(liveResource);
+}
+/** Compile the high-level config into a CHK spec. */
+function compileKeeperSpec(config) {
+    // LOUD build-time validation: the compiler BRANCHES on these (storage
+    // presence selects the volume-claim template block; replicas defaults via
+    // `?? 1`), so schema refs here would silently mis-compile. Storage SIZE and
+    // class are plain values and may be refs.
+    for (const field of ['storage', 'replicas']) {
+        if (isKubernetesRef(config[field]) || isCelExpression(config[field])) {
+            throw new Error(`clickHouseKeeperInstallation: '${field}' is a BUILD-TIME field and received a ` +
+                `schema reference or CEL expression — pass a concrete value (the compiler ` +
+                `branches on it at graph-construction time).`);
+        }
+    }
+    const replicas = config.replicas ?? 1;
+    // A CHK layout with `replicasCount: 0` (or a fractional/negative count) is
+    // invalid operator input — same shared validation as the CHI paths.
+    assertPositiveIntegerCount('clickHouseKeeperInstallation', 'replicas', replicas);
+    return {
+        configuration: {
+            clusters: [
+                {
+                    name: config.name,
+                    layout: { replicasCount: replicas },
+                },
+            ],
+        },
+        ...(config.storage && {
+            defaults: {
+                templates: {
+                    dataVolumeClaimTemplate: KEEPER_DATA_VOLUME_TEMPLATE,
+                },
+            },
+            templates: {
+                volumeClaimTemplates: [
+                    {
+                        name: KEEPER_DATA_VOLUME_TEMPLATE,
+                        spec: {
+                            accessModes: ['ReadWriteOnce'],
+                            resources: { requests: { storage: config.storage.size } },
+                            // On EKS: use a WaitForFirstConsumer + expandable gp3 class.
+                            ...(config.storage.storageClassName && {
+                                storageClassName: config.storage.storageClassName,
+                            }),
+                        },
+                    },
+                ],
+            },
+        }),
+    };
+}
+/**
+ * ClickHouseKeeperInstallation Factory
+ *
+ * @param config - High-level keeper configuration
+ * @returns Enhanced ClickHouseKeeperInstallation resource with readiness
+ *   evaluation
+ *
+ * @example
+ * ```typescript
+ * const keeper = clickHouseKeeperInstallation({
+ *   name: 'keeper',
+ *   namespace: 'observability',
+ *   replicas: 3, // odd count for quorum
+ *   storage: { size: '10Gi', storageClassName: 'gp3-expandable' },
+ *   id: 'clickhouseKeeper',
+ * });
+ * ```
+ */
+function createClickHouseKeeperInstallationResource(config) {
+    const spec = compileKeeperSpec(config);
+    return createResource({
+        apiVersion: 'clickhouse-keeper.altinity.com/v1',
+        kind: 'ClickHouseKeeperInstallation',
+        metadata: {
+            name: config.name,
+            ...(config.namespace && { namespace: config.namespace }),
+        },
+        spec,
+        ...(config.id && { id: config.id }),
+    }, { scope: 'namespaced', dnsAddressable: true }).withReadinessEvaluator(chkReadinessEvaluator);
+}
+export const clickHouseKeeperInstallation = createClickHouseKeeperInstallationResource;
+//# sourceMappingURL=keeper.js.map

package/dist/factories/clickhouse/resources/keeper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keeper.js","sourceRoot":"","sources":["../../../../src/factories/clickhouse/resources/keeper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAMjD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,+DAA+D;AAC/D,MAAM,2BAA2B,GAAG,aAAa,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,YAAqB;IACzD,OAAO,qBAAqB,CAAC,YAAY,CAAC,CAAC;AAC7C,CAAC;AAED,qDAAqD;AACrD,SAAS,iBAAiB,CACxB,MAAsD;IAEtD,sEAAsE;IACtE,0EAA0E;IAC1E,4EAA4E;IAC5E,0CAA0C;IAC1C,KAAK,MAAM,KAAK,IAAI,CAAC,SAAS,EAAE,UAAU,CAAU,EAAE,CAAC;QACrD,IAAI,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CACb,kCAAkC,KAAK,yCAAyC;gBAC9E,2EAA2E;gBAC3E,6CAA6C,CAChD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;IACtC,2EAA2E;IAC3E,oEAAoE;IACpE,0BAA0B,CAAC,8BAA8B,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAEjF,OAAO;QACL,aAAa,EAAE;YACb,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,MAAM,EAAE,EAAE,aAAa,EAAE,QAAQ,EAAE;iBACpC;aACF;SACF;QACD,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI;YACpB,QAAQ,EAAE;gBACR,SAAS,EAAE;oBACT,uBAAuB,EAAE,2BAA2B;iBACrD;aACF;YACD,SAAS,EAAE;gBACT,oBAAoB,EAAE;oBACpB;wBACE,IAAI,EAAE,2BAA2B;wBACjC,IAAI,EAAE;4BACJ,WAAW,EAAE,CAAC,eAAe,CAAC;4BAC9B,SAAS,EAAE,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE;4BACzD,6DAA6D;4BAC7D,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,IAAI;gCACrC,gBAAgB,EAAE,MAAM,CAAC,OAAO,CAAC,gBAAgB;6BAClD,CAAC;yBACH;qBACF;iBACF;aACF;SACF,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAS,0CAA0C,CACjD,MAAsD;IAEtD,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAEvC,OAAO,cAAc,CACnB;QACE,UAAU,EAAE,mCAAmC;QAC/C,IAAI,EAAE,8BAA8B;QACpC,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;SACzD;QACD,IAAI;QACJ,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;KACpC,EACD,EAAE,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,IAAI,EAAE,CAC9C,CAAC,sBAAsB,CAAC,qBAAqB,CAG7C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,4BAA4B,GAAG,0CAA0C,CAAC"}