latitudesh-typescript-sdk 0.3.7 → 0.3.8

package/src/models/kubernetesclusterupdateresponse.ts

@@ -17,14 +17,15 @@ export type KubernetesClusterUpdateResponseType = ClosedEnum<
 >;
 
 /**
- * The update status. 'scaling' indicates nodes are being added or removed. 'unchanged' indicates the requested count matches the current count.
+ * The update status. 'scaling' indicates nodes are being added or removed. 'upgrading' indicates a version upgrade is in progress. 'unchanged' indicates no change was needed.
  */
 export const KubernetesClusterUpdateResponseStatus = {
   Scaling: "scaling",
+  Upgrading: "upgrading",
   Unchanged: "unchanged",
 } as const;
 /**
- * The update status. 'scaling' indicates nodes are being added or removed. 'unchanged' indicates the requested count matches the current count.
+ * The update status. 'scaling' indicates nodes are being added or removed. 'upgrading' indicates a version upgrade is in progress. 'unchanged' indicates no change was needed.
  */
 export type KubernetesClusterUpdateResponseStatus = ClosedEnum<
   typeof KubernetesClusterUpdateResponseStatus
@@ -36,7 +37,7 @@ export type KubernetesClusterUpdateResponseAttributes = {
    */
   name?: string | undefined;
   /**
-   * The update status. 'scaling' indicates nodes are being added or removed. 'unchanged' indicates the requested count matches the current count.
+   * The update status. 'scaling' indicates nodes are being added or removed. 'upgrading' indicates a version upgrade is in progress. 'unchanged' indicates no change was needed.
    */
   status?: KubernetesClusterUpdateResponseStatus | undefined;
   /**
@@ -47,6 +48,10 @@ export type KubernetesClusterUpdateResponseAttributes = {
    * The requested number of control plane nodes. Present when scaling control plane.
    */
   controlPlaneCount?: number | null | undefined;
+  /**
+   * The target Kubernetes version. Present when upgrading version.
+   */
+  kubernetesVersion?: string | null | undefined;
 };
 
 export type KubernetesClusterUpdateResponseData = {
@@ -91,10 +96,12 @@ export const KubernetesClusterUpdateResponseAttributes$inboundSchema: z.ZodType<
   status: KubernetesClusterUpdateResponseStatus$inboundSchema.optional(),
   worker_count: z.nullable(z.number().int()).optional(),
   control_plane_count: z.nullable(z.number().int()).optional(),
+  kubernetes_version: z.nullable(z.string()).optional(),
 }).transform((v) => {
   return remap$(v, {
     "worker_count": "workerCount",
     "control_plane_count": "controlPlaneCount",
+    "kubernetes_version": "kubernetesVersion",
   });
 });
 /** @internal */
@@ -103,6 +110,7 @@ export type KubernetesClusterUpdateResponseAttributes$Outbound = {
   status?: string | undefined;
   worker_count?: number | null | undefined;
   control_plane_count?: number | null | undefined;
+  kubernetes_version?: string | null | undefined;
 };
 
 /** @internal */
@@ -116,10 +124,12 @@ export const KubernetesClusterUpdateResponseAttributes$outboundSchema:
     status: KubernetesClusterUpdateResponseStatus$outboundSchema.optional(),
     workerCount: z.nullable(z.number().int()).optional(),
     controlPlaneCount: z.nullable(z.number().int()).optional(),
+    kubernetesVersion: z.nullable(z.string()).optional(),
   }).transform((v) => {
     return remap$(v, {
       workerCount: "worker_count",
       controlPlaneCount: "control_plane_count",
+      kubernetesVersion: "kubernetes_version",
     });
   });
 

package/src/models/updatekubernetescluster.ts

@@ -17,27 +17,31 @@ export type UpdateKubernetesClusterType = ClosedEnum<
 >;
 
 /**
- * Exactly one of worker_count or control_plane_count must be provided. These parameters are mutually exclusive.
+ * Provide one of: worker_count, control_plane_count (for scaling), or kubernetes_version (for upgrades). These are mutually exclusive operations.
  */
 export type UpdateKubernetesClusterAttributes = {
   /**
-   * Desired number of worker nodes. Must be between 0 and 10. Mutually exclusive with control_plane_count.
+   * Desired number of worker nodes. Must be between 0 and 10. Mutually exclusive with control_plane_count and kubernetes_version.
    */
   workerCount?: number | undefined;
   /**
-   * Desired number of control plane nodes. Minimum 1. Mutually exclusive with worker_count.
+   * Desired number of control plane nodes. Minimum 1. Mutually exclusive with worker_count and kubernetes_version.
    */
   controlPlaneCount?: number | undefined;
   /**
    * Plan slug for worker nodes. Required when scaling from 0 workers. Ignored when scaling an existing deployment.
    */
   workerPlan?: string | null | undefined;
+  /**
+   * Target Kubernetes version for upgrade (e.g., v1.35.0+rke2r1). Mutually exclusive with scaling operations. Must be one minor version higher than current.
+   */
+  kubernetesVersion?: string | undefined;
 };
 
 export type UpdateKubernetesClusterData = {
   type: UpdateKubernetesClusterType;
   /**
-   * Exactly one of worker_count or control_plane_count must be provided. These parameters are mutually exclusive.
+   * Provide one of: worker_count, control_plane_count (for scaling), or kubernetes_version (for upgrades). These are mutually exclusive operations.
    */
   attributes: UpdateKubernetesClusterAttributes;
 };
@@ -64,11 +68,13 @@ export const UpdateKubernetesClusterAttributes$inboundSchema: z.ZodType<
   worker_count: z.number().int().optional(),
   control_plane_count: z.number().int().optional(),
   worker_plan: z.nullable(z.string()).optional(),
+  kubernetes_version: z.string().optional(),
 }).transform((v) => {
   return remap$(v, {
     "worker_count": "workerCount",
     "control_plane_count": "controlPlaneCount",
     "worker_plan": "workerPlan",
+    "kubernetes_version": "kubernetesVersion",
   });
 });
 /** @internal */
@@ -76,6 +82,7 @@ export type UpdateKubernetesClusterAttributes$Outbound = {
   worker_count?: number | undefined;
   control_plane_count?: number | undefined;
   worker_plan?: string | null | undefined;
+  kubernetes_version?: string | undefined;
 };
 
 /** @internal */
@@ -87,11 +94,13 @@ export const UpdateKubernetesClusterAttributes$outboundSchema: z.ZodType<
   workerCount: z.number().int().optional(),
   controlPlaneCount: z.number().int().optional(),
   workerPlan: z.nullable(z.string()).optional(),
+  kubernetesVersion: z.string().optional(),
 }).transform((v) => {
   return remap$(v, {
     workerCount: "worker_count",
     controlPlaneCount: "control_plane_count",
     workerPlan: "worker_plan",
+    kubernetesVersion: "kubernetes_version",
   });
 });
 

package/src/sdk/kubernetesclusters.ts

@@ -6,6 +6,7 @@ import { kubernetesClustersCreateKubernetesCluster } from "../funcs/kubernetesCl
 import { kubernetesClustersDeleteKubernetesCluster } from "../funcs/kubernetesClustersDeleteKubernetesCluster.js";
 import { kubernetesClustersGetKubernetesCluster } from "../funcs/kubernetesClustersGetKubernetesCluster.js";
 import { kubernetesClustersGetKubernetesClusterKubeconfig } from "../funcs/kubernetesClustersGetKubernetesClusterKubeconfig.js";
+import { kubernetesClustersListKubernetesAvailableVersions } from "../funcs/kubernetesClustersListKubernetesAvailableVersions.js";
 import { kubernetesClustersListKubernetesClusters } from "../funcs/kubernetesClustersListKubernetesClusters.js";
 import { kubernetesClustersUpdateKubernetesCluster } from "../funcs/kubernetesClustersUpdateKubernetesCluster.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
@@ -50,6 +51,27 @@ export class KubernetesClusters extends ClientSDK {
     ));
   }
 
+  /**
+   * List Available Kubernetes Versions
+   *
+   * @remarks
+   * Returns the list of available Kubernetes versions for cluster creation and upgrades. Versions are sourced from the RKE2 release channels and cached for 24 hours.
+   *
+   * Each version object includes:
+   * - `version`: The full version string (e.g., `v1.35.3+rke2r1`)
+   * - `minor`: The minor version number (e.g., `1.35`)
+   *
+   * The API returns the latest 5 supported minor versions. When upgrading clusters, you can only upgrade one minor version at a time (e.g., from 1.34 to 1.35).
+   */
+  async listKubernetesAvailableVersions(
+    options?: RequestOptions,
+  ): Promise<models.KubernetesAvailableVersions> {
+    return unwrapAsync(kubernetesClustersListKubernetesAvailableVersions(
+      this,
+      options,
+    ));
+  }
+
   /**
    * Get a Kubernetes Cluster
    *
@@ -85,10 +107,12 @@ export class KubernetesClusters extends ClientSDK {
   }
 
   /**
-   * Scale Kubernetes Cluster
+   * Update Kubernetes Cluster
    *
    * @remarks
-   * Scales the worker nodes or control plane nodes of a Kubernetes cluster. The cluster must be in `Provisioned` phase to accept updates.
+   * Updates a Kubernetes cluster by scaling nodes or upgrading the Kubernetes version. The cluster must be in `Provisioned` phase to accept updates.
+   *
+   * ## Scaling Operations
    *
    * Exactly one of `worker_count` or `control_plane_count` must be provided per request. You cannot scale workers and control plane nodes in the same request.
    *
@@ -98,7 +122,16 @@ export class KubernetesClusters extends ClientSDK {
    *
    * Control plane scaling has a minimum of 1 node. You cannot scale control plane nodes to zero.
    *
-   * Returns 202 Accepted when a scaling operation is triggered. Poll the GET endpoint to monitor progress. Returns 200 OK if the requested count matches the current count (no-op).
+   * ## Version Upgrades
+   *
+   * Provide a `kubernetes_version` parameter to upgrade the cluster to a new Kubernetes version. Version upgrades follow these rules:
+   *
+   * - **No downgrades**: You cannot downgrade to a lower version than currently installed
+   * - **One minor version at a time**: You can only upgrade one minor version at a time (e.g., from 1.34 to 1.35, not from 1.34 to 1.36)
+   * - **Mutually exclusive**: Version upgrades cannot be combined with scaling operations in the same request
+   * - **Available versions only**: The target version must be in the list returned by `GET /kubernetes_clusters/available_versions`
+   *
+   * Returns 202 Accepted when an update operation is triggered. Poll the GET endpoint to monitor progress. Returns 200 OK if no change is needed (no-op).
    */
   async updateKubernetesCluster(
     request: operations.UpdateKubernetesClusterRequest,