@numa-tech/numa 1.12.10 → 1.13.0

package/dist/clusters/client.d.ts

@@ -0,0 +1,436 @@
+import type { AuthConfig } from "../config.js";
+import { type KeycloakTokenProvider } from "../oauth.js";
+import { type ClusterAdoptRequest, type ClusterIgnoreRequest, type ClusterLinkRequest, type ClusterObservationBatchRequest, type ClusterSourceCreate, type ClusterSourceUpdate } from "./schemas.js";
+export declare const CLUSTER_CONTROL_PLANE_API_ROOT = "/api/v1/cluster-control-plane";
+export declare const CLUSTER_CONTROL_PLANE_CONTRACT_VERSION = "v1";
+export interface ClusterControlPlaneClientDependencies {
+    fetch?: typeof fetch;
+    tokenProvider?: KeycloakTokenProvider;
+}
+export interface ClusterCandidateListOptions {
+    status?: string;
+    sourceKey?: string;
+    page?: number;
+    size?: number;
+}
+export interface ClusterObservationListOptions {
+    sourceKey?: string;
+    candidateKey?: string;
+    page?: number;
+    size?: number;
+}
+export declare class ClusterControlPlaneClient {
+    private readonly config;
+    private readonly fetchImpl;
+    private readonly tokenProvider;
+    constructor(config: AuthConfig, dependencies?: ClusterControlPlaneClientDependencies);
+    private authenticatedFetch;
+    private json;
+    private mutation;
+    listClusters(): Promise<{
+        id?: string | undefined;
+        clusterKey: string;
+        code: string;
+        name: string;
+        provider: string;
+        providerClusterId?: string | null | undefined;
+        region?: string | null | undefined;
+        status: string;
+        identityStatus: string;
+        endpointFingerprintPrefix?: string | null | undefined;
+        lastObservedAt?: string | null | undefined;
+        version: number;
+    }[]>;
+    getCluster(clusterKey: string): Promise<{
+        cluster: {
+            id?: string | undefined;
+            clusterKey: string;
+            code: string;
+            name: string;
+            provider: string;
+            providerClusterId?: string | null | undefined;
+            region?: string | null | undefined;
+            status: string;
+            identityStatus: string;
+            endpointFingerprintPrefix?: string | null | undefined;
+            lastObservedAt?: string | null | undefined;
+            version: number;
+        };
+        description?: string | null | undefined;
+        fingerprintKinds: string[];
+        linkedCandidateKeys: string[];
+    }>;
+    listSources(): Promise<{
+        id?: string | undefined;
+        sourceKey: string;
+        sourceType: "ALIYUN_ACK_ASSUME_ROLE" | "KUBECONFIG_CLI";
+        displayName: string;
+        aliyunAccountId?: string | null | undefined;
+        aliyunAssumeRoleId?: string | null | undefined;
+        regions: string[];
+        enabled: boolean;
+        status: "ACTIVE" | "DISABLED" | "ERROR";
+        lastObservedAt?: string | null | undefined;
+        observationCount: number;
+        lastErrorCode?: string | null | undefined;
+        lastErrorMessage?: string | null | undefined;
+        version: number;
+    }[]>;
+    getSource(sourceKey: string): Promise<{
+        id?: string | undefined;
+        sourceKey: string;
+        sourceType: "ALIYUN_ACK_ASSUME_ROLE" | "KUBECONFIG_CLI";
+        displayName: string;
+        aliyunAccountId?: string | null | undefined;
+        aliyunAssumeRoleId?: string | null | undefined;
+        regions: string[];
+        enabled: boolean;
+        status: "ACTIVE" | "DISABLED" | "ERROR";
+        lastObservedAt?: string | null | undefined;
+        observationCount: number;
+        lastErrorCode?: string | null | undefined;
+        lastErrorMessage?: string | null | undefined;
+        version: number;
+    }>;
+    listCandidates(options?: ClusterCandidateListOptions): Promise<{
+        items: {
+            candidateKey: string;
+            sourceKey: string;
+            status: "ADOPTED" | "AMBIGUOUS" | "IGNORED" | "LINKED" | "MATCHED" | "PENDING";
+            matchKind: string;
+            matchedClusterKey?: string | null | undefined;
+            observedName?: string | null | undefined;
+            provider: string;
+            providerClusterId?: string | null | undefined;
+            region?: string | null | undefined;
+            kubernetesVersion?: string | null | undefined;
+            evidence: {
+                kind: string;
+                fingerprintPrefix: string;
+                strength: string;
+                matched: boolean;
+            }[];
+            firstObservedAt?: string | null | undefined;
+            lastObservedAt?: string | null | undefined;
+            observationCount: number;
+            resolutionReason?: string | null | undefined;
+            reviewedBy?: string | null | undefined;
+            reviewedAt?: string | null | undefined;
+            version: number;
+        }[];
+        total: number;
+        page: number;
+        size: number;
+        totalPages: number;
+    }>;
+    getCandidate(candidateKey: string): Promise<{
+        candidateKey: string;
+        sourceKey: string;
+        status: "ADOPTED" | "AMBIGUOUS" | "IGNORED" | "LINKED" | "MATCHED" | "PENDING";
+        matchKind: string;
+        matchedClusterKey?: string | null | undefined;
+        observedName?: string | null | undefined;
+        provider: string;
+        providerClusterId?: string | null | undefined;
+        region?: string | null | undefined;
+        kubernetesVersion?: string | null | undefined;
+        evidence: {
+            kind: string;
+            fingerprintPrefix: string;
+            strength: string;
+            matched: boolean;
+        }[];
+        firstObservedAt?: string | null | undefined;
+        lastObservedAt?: string | null | undefined;
+        observationCount: number;
+        resolutionReason?: string | null | undefined;
+        reviewedBy?: string | null | undefined;
+        reviewedAt?: string | null | undefined;
+        version: number;
+    }>;
+    listObservations(options?: ClusterObservationListOptions): Promise<{
+        items: {
+            observationKey: string;
+            sourceKey: string;
+            candidateKey: string;
+            observedName?: string | null | undefined;
+            provider: string;
+            providerClusterId?: string | null | undefined;
+            region?: string | null | undefined;
+            kubernetesVersion?: string | null | undefined;
+            evidence: {
+                kind: string;
+                fingerprintPrefix: string;
+                strength: string;
+                matched: boolean;
+            }[];
+            evidenceSource: "ACK_API" | "KUBECONFIG_CLI";
+            observedAt?: string | null | undefined;
+            receivedAt?: string | null | undefined;
+            disposition?: string | null | undefined;
+        }[];
+        total: number;
+        page: number;
+        size: number;
+        totalPages: number;
+    }>;
+    getObservation(observationKey: string): Promise<{
+        observationKey: string;
+        sourceKey: string;
+        candidateKey: string;
+        observedName?: string | null | undefined;
+        provider: string;
+        providerClusterId?: string | null | undefined;
+        region?: string | null | undefined;
+        kubernetesVersion?: string | null | undefined;
+        evidence: {
+            kind: string;
+            fingerprintPrefix: string;
+            strength: string;
+            matched: boolean;
+        }[];
+        evidenceSource: "ACK_API" | "KUBECONFIG_CLI";
+        observedAt?: string | null | undefined;
+        receivedAt?: string | null | undefined;
+        disposition?: string | null | undefined;
+    }>;
+    createSource(input: ClusterSourceCreate, idempotencyKey: string): Promise<{
+        id?: string | undefined;
+        sourceKey: string;
+        sourceType: "ALIYUN_ACK_ASSUME_ROLE" | "KUBECONFIG_CLI";
+        displayName: string;
+        aliyunAccountId?: string | null | undefined;
+        aliyunAssumeRoleId?: string | null | undefined;
+        regions: string[];
+        enabled: boolean;
+        status: "ACTIVE" | "DISABLED" | "ERROR";
+        lastObservedAt?: string | null | undefined;
+        observationCount: number;
+        lastErrorCode?: string | null | undefined;
+        lastErrorMessage?: string | null | undefined;
+        version: number;
+    }>;
+    updateSource(sourceKey: string, input: ClusterSourceUpdate, idempotencyKey: string): Promise<{
+        id?: string | undefined;
+        sourceKey: string;
+        sourceType: "ALIYUN_ACK_ASSUME_ROLE" | "KUBECONFIG_CLI";
+        displayName: string;
+        aliyunAccountId?: string | null | undefined;
+        aliyunAssumeRoleId?: string | null | undefined;
+        regions: string[];
+        enabled: boolean;
+        status: "ACTIVE" | "DISABLED" | "ERROR";
+        lastObservedAt?: string | null | undefined;
+        observationCount: number;
+        lastErrorCode?: string | null | undefined;
+        lastErrorMessage?: string | null | undefined;
+        version: number;
+    }>;
+    discoverSource(sourceKey: string, idempotencyKey: string): Promise<{
+        runNo: string;
+        sourceKey: string;
+        state: string;
+        discoveredCount: number;
+        candidateCount: number;
+        errorCode?: string | null | undefined;
+        errorMessage?: string | null | undefined;
+        startedAt?: string | null | undefined;
+        completedAt?: string | null | undefined;
+    }>;
+    getRun(runNo: string): Promise<{
+        runNo: string;
+        sourceKey: string;
+        state: string;
+        discoveredCount: number;
+        candidateCount: number;
+        errorCode?: string | null | undefined;
+        errorMessage?: string | null | undefined;
+        startedAt?: string | null | undefined;
+        completedAt?: string | null | undefined;
+    }>;
+    submitObservations(sourceKey: string, input: ClusterObservationBatchRequest, idempotencyKey: string): Promise<{
+        items: {
+            observation: {
+                observationKey: string;
+                sourceKey: string;
+                candidateKey: string;
+                observedName?: string | null | undefined;
+                provider: string;
+                providerClusterId?: string | null | undefined;
+                region?: string | null | undefined;
+                kubernetesVersion?: string | null | undefined;
+                evidence: {
+                    kind: string;
+                    fingerprintPrefix: string;
+                    strength: string;
+                    matched: boolean;
+                }[];
+                evidenceSource: "ACK_API" | "KUBECONFIG_CLI";
+                observedAt?: string | null | undefined;
+                receivedAt?: string | null | undefined;
+                disposition?: string | null | undefined;
+            };
+            candidate: {
+                candidateKey: string;
+                sourceKey: string;
+                status: "ADOPTED" | "AMBIGUOUS" | "IGNORED" | "LINKED" | "MATCHED" | "PENDING";
+                matchKind: string;
+                matchedClusterKey?: string | null | undefined;
+                observedName?: string | null | undefined;
+                provider: string;
+                providerClusterId?: string | null | undefined;
+                region?: string | null | undefined;
+                kubernetesVersion?: string | null | undefined;
+                evidence: {
+                    kind: string;
+                    fingerprintPrefix: string;
+                    strength: string;
+                    matched: boolean;
+                }[];
+                firstObservedAt?: string | null | undefined;
+                lastObservedAt?: string | null | undefined;
+                observationCount: number;
+                resolutionReason?: string | null | undefined;
+                reviewedBy?: string | null | undefined;
+                reviewedAt?: string | null | undefined;
+                version: number;
+            };
+            replayed: boolean;
+        }[];
+        observationCount: number;
+        candidateCount: number;
+        replayed: boolean;
+    }>;
+    adoptCandidate(candidateKey: string, input: ClusterAdoptRequest, idempotencyKey: string): Promise<{
+        action: "ADOPT" | "IGNORE" | "LINK";
+        candidate: {
+            candidateKey: string;
+            sourceKey: string;
+            status: "ADOPTED" | "AMBIGUOUS" | "IGNORED" | "LINKED" | "MATCHED" | "PENDING";
+            matchKind: string;
+            matchedClusterKey?: string | null | undefined;
+            observedName?: string | null | undefined;
+            provider: string;
+            providerClusterId?: string | null | undefined;
+            region?: string | null | undefined;
+            kubernetesVersion?: string | null | undefined;
+            evidence: {
+                kind: string;
+                fingerprintPrefix: string;
+                strength: string;
+                matched: boolean;
+            }[];
+            firstObservedAt?: string | null | undefined;
+            lastObservedAt?: string | null | undefined;
+            observationCount: number;
+            resolutionReason?: string | null | undefined;
+            reviewedBy?: string | null | undefined;
+            reviewedAt?: string | null | undefined;
+            version: number;
+        };
+        cluster?: {
+            id?: string | undefined;
+            clusterKey: string;
+            code: string;
+            name: string;
+            provider: string;
+            providerClusterId?: string | null | undefined;
+            region?: string | null | undefined;
+            status: string;
+            identityStatus: string;
+            endpointFingerprintPrefix?: string | null | undefined;
+            lastObservedAt?: string | null | undefined;
+            version: number;
+        } | null | undefined;
+        replayed: boolean;
+        decidedAt: string;
+    }>;
+    linkCandidate(candidateKey: string, input: ClusterLinkRequest, idempotencyKey: string): Promise<{
+        action: "ADOPT" | "IGNORE" | "LINK";
+        candidate: {
+            candidateKey: string;
+            sourceKey: string;
+            status: "ADOPTED" | "AMBIGUOUS" | "IGNORED" | "LINKED" | "MATCHED" | "PENDING";
+            matchKind: string;
+            matchedClusterKey?: string | null | undefined;
+            observedName?: string | null | undefined;
+            provider: string;
+            providerClusterId?: string | null | undefined;
+            region?: string | null | undefined;
+            kubernetesVersion?: string | null | undefined;
+            evidence: {
+                kind: string;
+                fingerprintPrefix: string;
+                strength: string;
+                matched: boolean;
+            }[];
+            firstObservedAt?: string | null | undefined;
+            lastObservedAt?: string | null | undefined;
+            observationCount: number;
+            resolutionReason?: string | null | undefined;
+            reviewedBy?: string | null | undefined;
+            reviewedAt?: string | null | undefined;
+            version: number;
+        };
+        cluster?: {
+            id?: string | undefined;
+            clusterKey: string;
+            code: string;
+            name: string;
+            provider: string;
+            providerClusterId?: string | null | undefined;
+            region?: string | null | undefined;
+            status: string;
+            identityStatus: string;
+            endpointFingerprintPrefix?: string | null | undefined;
+            lastObservedAt?: string | null | undefined;
+            version: number;
+        } | null | undefined;
+        replayed: boolean;
+        decidedAt: string;
+    }>;
+    ignoreCandidate(candidateKey: string, input: ClusterIgnoreRequest, idempotencyKey: string): Promise<{
+        action: "ADOPT" | "IGNORE" | "LINK";
+        candidate: {
+            candidateKey: string;
+            sourceKey: string;
+            status: "ADOPTED" | "AMBIGUOUS" | "IGNORED" | "LINKED" | "MATCHED" | "PENDING";
+            matchKind: string;
+            matchedClusterKey?: string | null | undefined;
+            observedName?: string | null | undefined;
+            provider: string;
+            providerClusterId?: string | null | undefined;
+            region?: string | null | undefined;
+            kubernetesVersion?: string | null | undefined;
+            evidence: {
+                kind: string;
+                fingerprintPrefix: string;
+                strength: string;
+                matched: boolean;
+            }[];
+            firstObservedAt?: string | null | undefined;
+            lastObservedAt?: string | null | undefined;
+            observationCount: number;
+            resolutionReason?: string | null | undefined;
+            reviewedBy?: string | null | undefined;
+            reviewedAt?: string | null | undefined;
+            version: number;
+        };
+        cluster?: {
+            id?: string | undefined;
+            clusterKey: string;
+            code: string;
+            name: string;
+            provider: string;
+            providerClusterId?: string | null | undefined;
+            region?: string | null | undefined;
+            status: string;
+            identityStatus: string;
+            endpointFingerprintPrefix?: string | null | undefined;
+            lastObservedAt?: string | null | undefined;
+            version: number;
+        } | null | undefined;
+        replayed: boolean;
+        decidedAt: string;
+    }>;
+}

package/dist/clusters/client.js

@@ -0,0 +1,207 @@
+import { resolveBackendUrl } from "../backend.js";
+import { ensureAccessToken, fetchWithKeycloakIdentity } from "../oauth.js";
+import { ClusterError } from "./errors.js";
+import { ClusterAdoptRequestSchema, ClusterApiErrorSchema, ClusterCandidateDecisionViewSchema, ClusterCandidatePageSchema, ClusterCandidateViewSchema, ClusterDetailSchema, ClusterDiscoveryRunViewSchema, ClusterIgnoreRequestSchema, ClusterLinkRequestSchema, ClusterObservationBatchReceiptSchema, ClusterObservationBatchRequestSchema, ClusterObservationPageSchema, ClusterObservationViewSchema, ClusterSourceCreateSchema, ClusterSourceListSchema, ClusterSourceUpdateSchema, ClusterSourceViewSchema, ClusterSummaryListSchema } from "./schemas.js";
+export const CLUSTER_CONTROL_PLANE_API_ROOT = "/api/v1/cluster-control-plane";
+export const CLUSTER_CONTROL_PLANE_CONTRACT_VERSION = "v1";
+function safeIdentifier(value, label) {
+    const trimmed = value.trim();
+    if (!trimmed || trimmed.length > 256 || !/^[A-Za-z0-9][A-Za-z0-9._:-]*$/u.test(trimmed)) {
+        throw new ClusterError(`${label} must be a stable platform identifier.`, "CLUSTER_CLI_INPUT_INVALID");
+    }
+    return trimmed;
+}
+function safeIdempotencyKey(value) {
+    const trimmed = value.trim();
+    if (!trimmed || trimmed.length > 200 || !/^[A-Za-z0-9][A-Za-z0-9._:/+-]*$/u.test(trimmed)) {
+        throw new ClusterError("idempotency-key must be 1-200 safe opaque characters.", "CLUSTER_IDEMPOTENCY_INVALID");
+    }
+    return trimmed;
+}
+function positiveInteger(value, label, maximum) {
+    if (value == null)
+        return undefined;
+    if (!Number.isInteger(value) || value < 1 || value > maximum) {
+        throw new ClusterError(`${label} must be an integer between 1 and ${maximum}.`, "CLUSTER_CLI_INPUT_INVALID");
+    }
+    return value;
+}
+function queryPath(path, values) {
+    const query = new URLSearchParams();
+    for (const [key, value] of Object.entries(values)) {
+        if (value != null && value !== "")
+            query.set(key, String(value));
+    }
+    return query.size ? `${path}?${query.toString()}` : path;
+}
+async function responseBody(response) {
+    const text = await response.text();
+    if (!text)
+        return {};
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+function requestIdFrom(response, body) {
+    if (body && typeof body === "object" && "requestId" in body && typeof body.requestId === "string")
+        return body.requestId;
+    return response.headers.get("x-request-id") ?? undefined;
+}
+function apiFailure(response, body) {
+    const parsed = ClusterApiErrorSchema.safeParse(body);
+    return new ClusterError(parsed.success && parsed.data.message
+        ? `Cluster Control Plane HTTP ${response.status}: ${parsed.data.message}`
+        : `Cluster Control Plane request failed with HTTP ${response.status}.`, parsed.success ? parsed.data.code ?? "CLUSTER_API_ERROR" : "CLUSTER_API_ERROR", response.status, requestIdFrom(response, body), parsed.success ? parsed.data.details : undefined);
+}
+function shouldRetryUnknown(error) {
+    if (error instanceof ClusterError) {
+        return [502, 503, 504].includes(error.status ?? 0) || /RESULT_UNKNOWN/u.test(error.code);
+    }
+    return error instanceof TypeError || (error instanceof Error && error.name === "AbortError");
+}
+export class ClusterControlPlaneClient {
+    config;
+    fetchImpl;
+    tokenProvider;
+    constructor(config, dependencies = {}) {
+        this.config = config;
+        this.fetchImpl = dependencies.fetch ?? fetch;
+        this.tokenProvider = dependencies.tokenProvider ?? ensureAccessToken;
+    }
+    async authenticatedFetch(path, init = {}) {
+        const method = String(init.method ?? "GET").toUpperCase();
+        const url = resolveBackendUrl(this.config, { method, path });
+        const headers = new Headers(init.headers);
+        headers.set("Accept", "application/json");
+        headers.set("X-Numa-Cluster-Contract", CLUSTER_CONTROL_PLANE_CONTRACT_VERSION);
+        if (init.body != null)
+            headers.set("Content-Type", "application/json");
+        return fetchWithKeycloakIdentity(this.config, url, () => ({ ...init, headers }), {
+            fetch: this.fetchImpl,
+            tokenProvider: this.tokenProvider
+        });
+    }
+    async json(path, schema, init = {}, expectedStatuses) {
+        const response = await this.authenticatedFetch(path, init);
+        const body = await responseBody(response);
+        if (!response.ok)
+            throw apiFailure(response, body);
+        if (expectedStatuses && !expectedStatuses.includes(response.status)) {
+            throw new ClusterError(`Cluster Control Plane returned HTTP ${response.status}; expected ${expectedStatuses.join(" or ")}.`, "CLUSTER_INVALID_RESPONSE", response.status, requestIdFrom(response, body));
+        }
+        const parsed = schema.safeParse(body);
+        if (!parsed.success) {
+            throw new ClusterError(`Cluster Control Plane returned an invalid response: ${parsed.error.message}`, "CLUSTER_INVALID_RESPONSE", response.status, requestIdFrom(response, body));
+        }
+        return parsed.data;
+    }
+    async mutation(path, schema, method, body, idempotencyKey, expectedStatuses) {
+        const key = safeIdempotencyKey(idempotencyKey);
+        const serialized = body == null ? undefined : JSON.stringify(body);
+        let lastError;
+        for (let attempt = 0; attempt < 2; attempt++) {
+            try {
+                return await this.json(path, schema, {
+                    method,
+                    headers: { "Idempotency-Key": key },
+                    ...(serialized == null ? {} : { body: serialized })
+                }, expectedStatuses);
+            }
+            catch (error) {
+                lastError = error;
+                if (!shouldRetryUnknown(error) || attempt === 1)
+                    break;
+            }
+        }
+        if (shouldRetryUnknown(lastError)) {
+            throw new ClusterError("Cluster mutation result is unknown. Retry the same command with the same Idempotency-Key and unchanged input.", "CLUSTER_RESULT_UNKNOWN", lastError instanceof ClusterError ? lastError.status : undefined, lastError instanceof ClusterError ? lastError.requestId : undefined);
+        }
+        throw lastError;
+    }
+    listClusters() {
+        return this.json(`${CLUSTER_CONTROL_PLANE_API_ROOT}/clusters`, ClusterSummaryListSchema);
+    }
+    getCluster(clusterKey) {
+        return this.json(`${CLUSTER_CONTROL_PLANE_API_ROOT}/clusters/${encodeURIComponent(safeIdentifier(clusterKey, "cluster-key"))}`, ClusterDetailSchema);
+    }
+    listSources() {
+        return this.json(`${CLUSTER_CONTROL_PLANE_API_ROOT}/sources`, ClusterSourceListSchema);
+    }
+    getSource(sourceKey) {
+        return this.json(`${CLUSTER_CONTROL_PLANE_API_ROOT}/sources/${encodeURIComponent(safeIdentifier(sourceKey, "source-key"))}`, ClusterSourceViewSchema);
+    }
+    listCandidates(options = {}) {
+        return this.json(queryPath(`${CLUSTER_CONTROL_PLANE_API_ROOT}/candidates`, {
+            status: options.status,
+            sourceKey: options.sourceKey,
+            page: positiveInteger(options.page, "page", 1_000_000),
+            size: positiveInteger(options.size, "size", 100)
+        }), ClusterCandidatePageSchema);
+    }
+    getCandidate(candidateKey) {
+        return this.json(`${CLUSTER_CONTROL_PLANE_API_ROOT}/candidates/${encodeURIComponent(safeIdentifier(candidateKey, "candidate-key"))}`, ClusterCandidateViewSchema);
+    }
+    listObservations(options = {}) {
+        return this.json(queryPath(`${CLUSTER_CONTROL_PLANE_API_ROOT}/observations`, {
+            sourceKey: options.sourceKey,
+            candidateKey: options.candidateKey,
+            page: positiveInteger(options.page, "page", 1_000_000),
+            size: positiveInteger(options.size, "size", 100)
+        }), ClusterObservationPageSchema);
+    }
+    getObservation(observationKey) {
+        return this.json(`${CLUSTER_CONTROL_PLANE_API_ROOT}/observations/${encodeURIComponent(safeIdentifier(observationKey, "observation-key"))}`, ClusterObservationViewSchema);
+    }
+    createSource(input, idempotencyKey) {
+        const parsed = ClusterSourceCreateSchema.safeParse(input);
+        if (!parsed.success)
+            throw new ClusterError(`Source input is invalid: ${parsed.error.message}`, "CLUSTER_CLI_INPUT_INVALID");
+        return this.mutation(`${CLUSTER_CONTROL_PLANE_API_ROOT}/sources`, ClusterSourceViewSchema, "POST", parsed.data, idempotencyKey, [201]);
+    }
+    updateSource(sourceKey, input, idempotencyKey) {
+        const parsed = ClusterSourceUpdateSchema.safeParse(input);
+        if (!parsed.success)
+            throw new ClusterError(`Source update is invalid: ${parsed.error.message}`, "CLUSTER_CLI_INPUT_INVALID");
+        const source = encodeURIComponent(safeIdentifier(sourceKey, "source-key"));
+        return this.mutation(`${CLUSTER_CONTROL_PLANE_API_ROOT}/sources/${source}`, ClusterSourceViewSchema, "PUT", parsed.data, idempotencyKey, [200]);
+    }
+    discoverSource(sourceKey, idempotencyKey) {
+        const source = encodeURIComponent(safeIdentifier(sourceKey, "source-key"));
+        return this.mutation(`${CLUSTER_CONTROL_PLANE_API_ROOT}/sources/${source}/discover`, ClusterDiscoveryRunViewSchema, "POST", undefined, idempotencyKey, [202]);
+    }
+    getRun(runNo) {
+        return this.json(`${CLUSTER_CONTROL_PLANE_API_ROOT}/runs/${encodeURIComponent(safeIdentifier(runNo, "run-no"))}`, ClusterDiscoveryRunViewSchema);
+    }
+    submitObservations(sourceKey, input, idempotencyKey) {
+        const parsed = ClusterObservationBatchRequestSchema.safeParse(input);
+        if (!parsed.success)
+            throw new ClusterError(`Observation plan is invalid: ${parsed.error.message}`, "CLUSTER_PLAN_INVALID");
+        const source = encodeURIComponent(safeIdentifier(sourceKey, "source-key"));
+        return this.mutation(`${CLUSTER_CONTROL_PLANE_API_ROOT}/sources/${source}/observations`, ClusterObservationBatchReceiptSchema, "POST", parsed.data, idempotencyKey, [202]);
+    }
+    adoptCandidate(candidateKey, input, idempotencyKey) {
+        const parsed = ClusterAdoptRequestSchema.safeParse(input);
+        if (!parsed.success)
+            throw new ClusterError(`Adopt input is invalid: ${parsed.error.message}`, "CLUSTER_CLI_INPUT_INVALID");
+        const candidate = encodeURIComponent(safeIdentifier(candidateKey, "candidate-key"));
+        return this.mutation(`${CLUSTER_CONTROL_PLANE_API_ROOT}/candidates/${candidate}/adopt`, ClusterCandidateDecisionViewSchema, "POST", parsed.data, idempotencyKey, [200]);
+    }
+    linkCandidate(candidateKey, input, idempotencyKey) {
+        const parsed = ClusterLinkRequestSchema.safeParse(input);
+        if (!parsed.success)
+            throw new ClusterError(`Link input is invalid: ${parsed.error.message}`, "CLUSTER_CLI_INPUT_INVALID");
+        const candidate = encodeURIComponent(safeIdentifier(candidateKey, "candidate-key"));
+        return this.mutation(`${CLUSTER_CONTROL_PLANE_API_ROOT}/candidates/${candidate}/link`, ClusterCandidateDecisionViewSchema, "POST", parsed.data, idempotencyKey, [200]);
+    }
+    ignoreCandidate(candidateKey, input, idempotencyKey) {
+        const parsed = ClusterIgnoreRequestSchema.safeParse(input);
+        if (!parsed.success)
+            throw new ClusterError(`Ignore input is invalid: ${parsed.error.message}`, "CLUSTER_CLI_INPUT_INVALID");
+        const candidate = encodeURIComponent(safeIdentifier(candidateKey, "candidate-key"));
+        return this.mutation(`${CLUSTER_CONTROL_PLANE_API_ROOT}/candidates/${candidate}/ignore`, ClusterCandidateDecisionViewSchema, "POST", parsed.data, idempotencyKey, [200]);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/clusters/client.js.map

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

package/dist/clusters/commands.d.ts

@@ -0,0 +1,11 @@
+import type { Command } from "commander";
+import { ClusterControlPlaneClient } from "./client.js";
+import { type KubeconfigDiscoveryOptions, type LocalKubeconfigDiscoveryPlan } from "./kubeconfig-discovery.js";
+export interface ClusterCommandDependencies {
+    clientFactory?: () => ClusterControlPlaneClient;
+    discoverKubeconfig?: (options: KubeconfigDiscoveryOptions) => Promise<LocalKubeconfigDiscoveryPlan>;
+    readPlan?: (path: string) => Promise<unknown>;
+}
+export declare function parseClusterIdentifier(value: string | undefined, label: string): string;
+export declare function parseClusterIdempotencyKey(value: string | undefined): string;
+export declare function registerClusterCommands(program: Command, dependencies?: ClusterCommandDependencies): void;