latitudesh-typescript-sdk 0.8.26 → 0.8.28

package/src/sdk/lks.ts

@@ -0,0 +1,258 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { lksCreateLKSCluster } from "../funcs/lksCreateLKSCluster.js";
+import { lksCreateLKSNodePool } from "../funcs/lksCreateLKSNodePool.js";
+import { lksDeleteLKSCluster } from "../funcs/lksDeleteLKSCluster.js";
+import { lksDeleteLKSNodePool } from "../funcs/lksDeleteLKSNodePool.js";
+import { lksGetLKSCluster } from "../funcs/lksGetLKSCluster.js";
+import { lksGetLKSClusterKubeconfig } from "../funcs/lksGetLKSClusterKubeconfig.js";
+import { lksGetLKSNodePool } from "../funcs/lksGetLKSNodePool.js";
+import { lksListLKSAvailableVersions } from "../funcs/lksListLKSAvailableVersions.js";
+import { lksListLKSClusters } from "../funcs/lksListLKSClusters.js";
+import { lksListLKSNodePools } from "../funcs/lksListLKSNodePools.js";
+import { lksListLKSSites } from "../funcs/lksListLKSSites.js";
+import { lksUpdateLKSCluster } from "../funcs/lksUpdateLKSCluster.js";
+import { lksUpdateLKSNodePool } from "../funcs/lksUpdateLKSNodePool.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Lks extends ClientSDK {
+  /**
+   * List LKS clusters
+   *
+   * @remarks
+   * Lists every LKS cluster of a project. The response is not paginated; `meta.total` is the number of clusters returned.
+   */
+  async listLksClusters(
+    request: operations.ListLksClustersRequest,
+    options?: RequestOptions,
+  ): Promise<models.LksClusters> {
+    return unwrapAsync(lksListLKSClusters(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Create an LKS cluster
+   *
+   * @remarks
+   * Creates an LKS cluster. The cluster is the control plane only — worker capacity is added separately through node pools (`POST /lks/clusters/{cluster_id}/nodepools`).
+   *
+   * `site` must be one of the slugs returned by `GET /lks/sites`, and `kubernetes_version` must be a patch listed by `GET /lks/available_versions` with `available_for_creation: true`.
+   *
+   * The cluster is returned immediately with `status: "provisioning"`. Poll `GET /lks/clusters/{id}` until `status` is `ready`, then fetch the kubeconfig.
+   */
+  async createLksCluster(
+    request: models.CreateLksCluster,
+    options?: RequestOptions,
+  ): Promise<models.LksCluster> {
+    return unwrapAsync(lksCreateLKSCluster(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get an LKS cluster
+   *
+   * @remarks
+   * Retrieves a single LKS cluster.
+   *
+   * `status` is an open enum sourced from the platform controller — `provisioning`, `ready`, `updating`, `scaling`, `upgrading`, `paused`, `deleting` and `deleted` are the values in use today, and new ones may appear without notice. `reason` and `message` carry the machine-readable and human-readable detail behind the current `status`.
+   */
+  async getLksCluster(
+    request: operations.GetLksClusterRequest,
+    options?: RequestOptions,
+  ): Promise<models.LksCluster> {
+    return unwrapAsync(lksGetLKSCluster(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Delete an LKS cluster
+   *
+   * @remarks
+   * Marks the cluster for deletion. The call returns as soon as the tombstone is written; the platform then tears the cluster and its node pools down asynchronously. A cluster that is already deleted, or that is paused, rejects the request.
+   */
+  async deleteLksCluster(
+    request: operations.DeleteLksClusterRequest,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(lksDeleteLKSCluster(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Update an LKS cluster
+   *
+   * @remarks
+   * Renames a cluster, edits its description, or upgrades the control plane. At least one of `name`, `description` or `kubernetes_version` must be provided.
+   *
+   * Setting a newer `kubernetes_version` consents to a control-plane upgrade; the value must be a patch listed by `GET /lks/available_versions` with `available_for_upgrade: true` and must not be lower than the current one. Node pools are upgraded separately and must never run a patch newer than the control plane.
+   *
+   * The cluster must be idle: a cluster that is provisioning, updating, scaling, upgrading, paused or deleting rejects the request with 409.
+   */
+  async updateLksCluster(
+    request: operations.UpdateLksClusterRequest,
+    options?: RequestOptions,
+  ): Promise<models.LksCluster> {
+    return unwrapAsync(lksUpdateLKSCluster(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get the cluster kubeconfig
+   *
+   * @remarks
+   * Returns the kubeconfig for the cluster. It only exists once the control plane is up, so this endpoint answers 409 `NOT_READY` while the cluster is still provisioning — poll `GET /lks/clusters/{id}` until `kubeconfig_url` is set.
+   */
+  async getLksClusterKubeconfig(
+    request: operations.GetLksClusterKubeconfigRequest,
+    options?: RequestOptions,
+  ): Promise<models.LksClusterKubeconfig> {
+    return unwrapAsync(lksGetLKSClusterKubeconfig(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List node pools
+   *
+   * @remarks
+   * Lists every node pool of an LKS cluster. The response is not paginated; `meta.total` is the number of node pools returned.
+   */
+  async listLksNodePools(
+    request: operations.ListLksNodePoolsRequest,
+    options?: RequestOptions,
+  ): Promise<models.LksNodePools> {
+    return unwrapAsync(lksListLKSNodePools(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Create a node pool
+   *
+   * @remarks
+   * Adds a node pool to an LKS cluster. The platform provisions `count` servers of `plan` from stock, so both fields are required.
+   *
+   * `kubernetes_version` defaults to the control-plane patch and may never be newer than it. `max_pods_per_node` is set once, here — it cannot be changed later.
+   */
+  async createLksNodePool(
+    request: operations.CreateLksNodePoolRequest,
+    options?: RequestOptions,
+  ): Promise<models.LksNodePool> {
+    return unwrapAsync(lksCreateLKSNodePool(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get a node pool
+   *
+   * @remarks
+   * Retrieves a single node pool of an LKS cluster. `ready_nodes` reports how many of the pool's `count` nodes have joined the cluster.
+   */
+  async getLksNodePool(
+    request: operations.GetLksNodePoolRequest,
+    options?: RequestOptions,
+  ): Promise<models.LksNodePool> {
+    return unwrapAsync(lksGetLKSNodePool(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Delete a node pool
+   *
+   * @remarks
+   * Marks the node pool for deletion. The call returns as soon as the tombstone is written; the platform then drains and releases the nodes asynchronously.
+   */
+  async deleteLksNodePool(
+    request: operations.DeleteLksNodePoolRequest,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(lksDeleteLKSNodePool(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Update a node pool
+   *
+   * @remarks
+   * Scales, renames, upgrades or re-labels a node pool. At least one attribute must be provided.
+   *
+   * `labels` and `taints` are declarative replacements, not merges: omit the field to leave it untouched, send the whole map/list to replace it, or send `{}` / `[]` to clear it.
+   *
+   * A newer `kubernetes_version` rolls a node-recreating upgrade; it must not be lower than the pool's current patch nor newer than the control-plane patch. `max_pods_per_node` is immutable — a PATCH that carries it is rejected with 422 even if the value is unchanged.
+   *
+   * The node pool must be idle: one that is provisioning, updating, scaling, upgrading, paused or deleting rejects the request with 409.
+   */
+  async updateLksNodePool(
+    request: operations.UpdateLksNodePoolRequest,
+    options?: RequestOptions,
+  ): Promise<models.LksNodePool> {
+    return unwrapAsync(lksUpdateLKSNodePool(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List available Kubernetes versions
+   *
+   * @remarks
+   * Lists the Kubernetes patches the platform offers, with their lifecycle flags. Use a version with `available_for_creation: true` when creating a cluster or a node pool, and one with `available_for_upgrade: true` when upgrading. Exactly one entry has `default: true`.
+   */
+  async listLksAvailableVersions(
+    options?: RequestOptions,
+  ): Promise<models.LksKubernetesVersions> {
+    return unwrapAsync(lksListLKSAvailableVersions(
+      this,
+      options,
+    ));
+  }
+
+  /**
+   * List sites available for LKS
+   *
+   * @remarks
+   * Lists the sites that can host an LKS cluster, one entry per site. Pass an entry's `id` (the site slug) as `site` when creating a cluster. `country` is null when the underlying site has no region assigned.
+   */
+  async listLksSites(
+    options?: RequestOptions,
+  ): Promise<models.LksSites> {
+    return unwrapAsync(lksListLKSSites(
+      this,
+      options,
+    ));
+  }
+}

package/src/sdk/objectstorage.ts

@@ -41,16 +41,16 @@ export class ObjectStorage extends ClientSDK {
   }
 
   /**
-   * Create access key
+   * List access keys
    *
    * @remarks
-   * Creates an object storage IAM access key for a project. The secret is returned only once, in this response, and cannot be retrieved again. The provider is selected by `storage_class`: `standard` provisions the key on Wasabi and `high_performance` provisions it on VAST.
+   * Lists object storage access keys for a project, grouped by storage class. Secrets are never returned by this endpoint.
    */
-  async postStorageAccessKeys(
-    request: operations.PostStorageAccessKeysRequest,
+  async getStorageAccessKeys(
+    request: operations.GetStorageAccessKeysRequest,
     options?: RequestOptions,
-  ): Promise<operations.PostStorageAccessKeysResponse> {
-    return unwrapAsync(objectStoragePostStorageAccessKeys(
+  ): Promise<operations.GetStorageAccessKeysResponse> {
+    return unwrapAsync(objectStorageGetStorageAccessKeys(
       this,
       request,
       options,
@@ -58,16 +58,16 @@ export class ObjectStorage extends ClientSDK {
   }
 
   /**
-   * List access keys
+   * Create access key
    *
    * @remarks
-   * Lists object storage access keys for a project, grouped by storage class. Secrets are never returned by this endpoint.
+   * Creates an object storage IAM access key for a project. The secret is returned only once, in this response, and cannot be retrieved again. The provider is selected by `storage_class`: `standard` provisions the key on Wasabi and `high_performance` provisions it on VAST.
    */
-  async getStorageAccessKeys(
-    request: operations.GetStorageAccessKeysRequest,
+  async postStorageAccessKeys(
+    request: operations.PostStorageAccessKeysRequest,
     options?: RequestOptions,
-  ): Promise<operations.GetStorageAccessKeysResponse> {
-    return unwrapAsync(objectStorageGetStorageAccessKeys(
+  ): Promise<operations.PostStorageAccessKeysResponse> {
+    return unwrapAsync(objectStoragePostStorageAccessKeys(
       this,
       request,
       options,

package/src/sdk/plans.ts

@@ -4,6 +4,7 @@
 
 import { plansGet } from "../funcs/plansGet.js";
 import { plansGetBandwidth } from "../funcs/plansGetBandwidth.js";
+import { plansGetLksPlans } from "../funcs/plansGetLksPlans.js";
 import { plansGetManagedDatabasePlans } from "../funcs/plansGetManagedDatabasePlans.js";
 import { plansList } from "../funcs/plansList.js";
 import { plansListStorage } from "../funcs/plansListStorage.js";
@@ -102,6 +103,22 @@ export class Plans extends ClientSDK {
     ));
   }
 
+  /**
+   * List LKS plans
+   *
+   * @remarks
+   * Lists bare metal plans available to LKS with per-site capacity for a node pool.
+   * `attributes.regions.locations.in_stock_count` gives the number of servers a node pool can get, keyed by site slug.
+   */
+  async getLksPlans(
+    options?: RequestOptions,
+  ): Promise<models.LksPlans> {
+    return unwrapAsync(plansGetLksPlans(
+      this,
+      options,
+    ));
+  }
+
   /**
    * List managed database plans
    */

package/src/sdk/privatenetworks.ts

@@ -53,16 +53,16 @@ export class PrivateNetworks extends ClientSDK {
   }
 
   /**
-   * Update VLAN
+   * Retrieve VLAN
    *
    * @remarks
-   * Update a Virtual Network.
+   * Retrieve a Virtual Network.
    */
-  async update(
-    request: operations.UpdateVirtualNetworkRequest,
+  async get(
+    request: operations.GetVirtualNetworkRequest,
     options?: RequestOptions,
   ): Promise<models.VirtualNetwork> {
-    return unwrapAsync(privateNetworksUpdate(
+    return unwrapAsync(privateNetworksGet(
       this,
       request,
       options,
@@ -70,16 +70,16 @@ export class PrivateNetworks extends ClientSDK {
   }
 
   /**
-   * Retrieve VLAN
+   * Update VLAN
    *
    * @remarks
-   * Retrieve a Virtual Network.
+   * Update a Virtual Network.
    */
-  async get(
-    request: operations.GetVirtualNetworkRequest,
+  async update(
+    request: operations.UpdateVirtualNetworkRequest,
     options?: RequestOptions,
   ): Promise<models.VirtualNetwork> {
-    return unwrapAsync(privateNetworksGet(
+    return unwrapAsync(privateNetworksUpdate(
       this,
       request,
       options,

package/src/sdk/projects.ts

@@ -51,13 +51,16 @@ export class Projects extends ClientSDK {
   }
 
   /**
-   * Update project
+   * Retrieve project
+   *
+   * @remarks
+   * Returns a single project belonging to the current team
    */
-  async update(
-    request: operations.UpdateProjectRequest,
+  async getProject(
+    request: operations.GetProjectRequest,
     options?: RequestOptions,
-  ): Promise<operations.UpdateProjectResponse> {
-    return unwrapAsync(projectsUpdate(
+  ): Promise<operations.GetProjectResponse> {
+    return unwrapAsync(projectsGetProject(
       this,
       request,
       options,
@@ -82,16 +85,13 @@ export class Projects extends ClientSDK {
   }
 
   /**
-   * Retrieve project
-   *
-   * @remarks
-   * Returns a single project belonging to the current team
+   * Update project
    */
-  async getProject(
-    request: operations.GetProjectRequest,
+  async update(
+    request: operations.UpdateProjectRequest,
     options?: RequestOptions,
-  ): Promise<operations.GetProjectResponse> {
-    return unwrapAsync(projectsGetProject(
+  ): Promise<operations.UpdateProjectResponse> {
+    return unwrapAsync(projectsUpdate(
       this,
       request,
       options,

package/src/sdk/sdk.ts

@@ -13,6 +13,7 @@ import { FilesystemStorage } from "./filesystemstorage.js";
 import { Firewalls } from "./firewalls.js";
 import { IpAddresses } from "./ipaddresses.js";
 import { KubernetesClusters } from "./kubernetesclusters.js";
+import { Lks } from "./lks.js";
 import { ManagedDatabases } from "./manageddatabases.js";
 import { MarketplaceApps } from "./marketplaceapps.js";
 import { ObjectStorage } from "./objectstorage.js";
@@ -93,6 +94,11 @@ export class Latitudesh extends ClientSDK {
     return (this._kubernetesClusters ??= new KubernetesClusters(this._options));
   }
 
+  private _lks?: Lks;
+  get lks(): Lks {
+    return (this._lks ??= new Lks(this._options));
+  }
+
   private _plans?: Plans;
   get plans(): Plans {
     return (this._plans ??= new Plans(this._options));

package/src/sdk/servers.ts

@@ -76,13 +76,13 @@ export class Servers extends ClientSDK {
   }
 
   /**
-   * Update server
+   * Remove server
    */
-  async update(
-    request: operations.UpdateServerRequest,
+  async delete(
+    request: operations.DestroyServerRequest,
     options?: RequestOptions,
-  ): Promise<models.Server> {
-    return unwrapAsync(serversUpdate(
+  ): Promise<void> {
+    return unwrapAsync(serversDelete(
       this,
       request,
       options,
@@ -90,13 +90,13 @@ export class Servers extends ClientSDK {
   }
 
   /**
-   * Remove server
+   * Update server
    */
-  async delete(
-    request: operations.DestroyServerRequest,
+  async update(
+    request: operations.UpdateServerRequest,
     options?: RequestOptions,
-  ): Promise<void> {
-    return unwrapAsync(serversDelete(
+  ): Promise<models.Server> {
+    return unwrapAsync(serversUpdate(
       this,
       request,
       options,
@@ -166,13 +166,13 @@ export class Servers extends ClientSDK {
   }
 
   /**
-   * Create out-of-band connection
+   * List out-of-band connections
    */
-  async startOutOfBandConnection(
-    request: operations.CreateServerOutOfBandRequest,
+  async getOutOfBand(
+    request: operations.GetServerOutOfBandRequest,
     options?: RequestOptions,
   ): Promise<models.OutOfBandConnection> {
-    return unwrapAsync(serversStartOutOfBandConnection(
+    return unwrapAsync(serversGetOutOfBand(
       this,
       request,
       options,
@@ -180,13 +180,13 @@ export class Servers extends ClientSDK {
   }
 
   /**
-   * List out-of-band connections
+   * Create out-of-band connection
    */
-  async getOutOfBand(
-    request: operations.GetServerOutOfBandRequest,
+  async startOutOfBandConnection(
+    request: operations.CreateServerOutOfBandRequest,
     options?: RequestOptions,
   ): Promise<models.OutOfBandConnection> {
-    return unwrapAsync(serversGetOutOfBand(
+    return unwrapAsync(serversStartOutOfBandConnection(
       this,
       request,
       options,

package/src/sdk/sshkeys.ts

@@ -56,18 +56,18 @@ export class SSHKeys extends ClientSDK {
   }
 
   /**
-   * Update Project SSH Key
+   * Delete Project SSH Key
    *
    * @remarks
-   * Allow you update SSH Key in a project. These keys can be used to access servers after deploy and reinstall actions.
+   * Allow you remove SSH Keys in a project. Remove a SSH Key from the project won't revoke the SSH Keys access for previously deploy and reinstall actions.
    *
    * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
    */
-  async modifyProjectKey(
-    request: operations.PutProjectSshKeyRequest,
+  async removeFromProject(
+    request: operations.DeleteProjectSshKeyRequest,
     options?: RequestOptions,
-  ): Promise<operations.PutProjectSshKeyResponse> {
-    return unwrapAsync(sshKeysModifyProjectKey(
+  ): Promise<void> {
+    return unwrapAsync(sshKeysRemoveFromProject(
       this,
       request,
       options,
@@ -75,18 +75,18 @@ export class SSHKeys extends ClientSDK {
   }
 
   /**
-   * Delete Project SSH Key
+   * Update Project SSH Key
    *
    * @remarks
-   * Allow you remove SSH Keys in a project. Remove a SSH Key from the project won't revoke the SSH Keys access for previously deploy and reinstall actions.
+   * Allow you update SSH Key in a project. These keys can be used to access servers after deploy and reinstall actions.
    *
    * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
    */
-  async removeFromProject(
-    request: operations.DeleteProjectSshKeyRequest,
+  async modifyProjectKey(
+    request: operations.PutProjectSshKeyRequest,
     options?: RequestOptions,
-  ): Promise<void> {
-    return unwrapAsync(sshKeysRemoveFromProject(
+  ): Promise<operations.PutProjectSshKeyResponse> {
+    return unwrapAsync(sshKeysModifyProjectKey(
       this,
       request,
       options,
@@ -145,16 +145,16 @@ export class SSHKeys extends ClientSDK {
   }
 
   /**
-   * Update SSH Key
+   * Delete SSH Key
    *
    * @remarks
-   * Allows you update SSH Key in a project. These keys can be used to access servers after deploy and reinstall actions.
+   * Allows you remove SSH Keys in a project. Remove a SSH Key from the project won't revoke the SSH Keys access for previously deploy and reinstall actions.
    */
-  async update(
-    request: operations.PutSshKeyRequest,
+  async delete(
+    request: operations.DeleteSshKeyRequest,
     options?: RequestOptions,
-  ): Promise<operations.PutSshKeyResponse> {
-    return unwrapAsync(sshKeysUpdate(
+  ): Promise<void> {
+    return unwrapAsync(sshKeysDelete(
       this,
       request,
       options,
@@ -162,16 +162,16 @@ export class SSHKeys extends ClientSDK {
   }
 
   /**
-   * Delete SSH Key
+   * Update SSH Key
    *
    * @remarks
-   * Allows you remove SSH Keys in a project. Remove a SSH Key from the project won't revoke the SSH Keys access for previously deploy and reinstall actions.
+   * Allows you update SSH Key in a project. These keys can be used to access servers after deploy and reinstall actions.
    */
-  async delete(
-    request: operations.DeleteSshKeyRequest,
+  async update(
+    request: operations.PutSshKeyRequest,
     options?: RequestOptions,
-  ): Promise<void> {
-    return unwrapAsync(sshKeysDelete(
+  ): Promise<operations.PutSshKeyResponse> {
+    return unwrapAsync(sshKeysUpdate(
       this,
       request,
       options,

package/src/sdk/tags.ts

@@ -45,16 +45,16 @@ export class Tags extends ClientSDK {
   }
 
   /**
-   * Update tag
+   * Delete tag
    *
    * @remarks
    * Update a Tag in the team.
    */
-  async update(
-    request: operations.UpdateTagRequest,
+  async delete(
+    request: operations.DestroyTagRequest,
     options?: RequestOptions,
-  ): Promise<models.CustomTag> {
-    return unwrapAsync(tagsUpdate(
+  ): Promise<void> {
+    return unwrapAsync(tagsDelete(
       this,
       request,
       options,
@@ -62,16 +62,16 @@ export class Tags extends ClientSDK {
   }
 
   /**
-   * Delete tag
+   * Update tag
    *
    * @remarks
    * Update a Tag in the team.
    */
-  async delete(
-    request: operations.DestroyTagRequest,
+  async update(
+    request: operations.UpdateTagRequest,
     options?: RequestOptions,
-  ): Promise<void> {
-    return unwrapAsync(tagsDelete(
+  ): Promise<models.CustomTag> {
+    return unwrapAsync(tagsUpdate(
       this,
       request,
       options,