latitudesh-typescript-sdk 0.3.5 → 0.3.7

package/src/funcs/kubernetesClustersUpdateKubernetesCluster.ts

@@ -0,0 +1,199 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { LatitudeshCore } from "../core.js";
+import { encodeJSON, encodeSimple } from "../lib/encodings.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { LatitudeshError } from "../models/errors/latitudesherror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Scale 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.
+ *
+ * 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.
+ *
+ * When scaling up, the API validates that sufficient server stock is available for the requested delta (e.g., scaling from 2 to 5 workers checks for 3 available servers).
+ *
+ * When scaling from 0 workers, you must provide a `worker_plan` since there is no existing configuration to inherit the plan from.
+ *
+ * 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).
+ */
+export function kubernetesClustersUpdateKubernetesCluster(
+  client: LatitudeshCore,
+  request: operations.UpdateKubernetesClusterRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    models.KubernetesClusterUpdateResponse,
+    | errors.ErrorObject
+    | LatitudeshError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: LatitudeshCore,
+  request: operations.UpdateKubernetesClusterRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      models.KubernetesClusterUpdateResponse,
+      | errors.ErrorObject
+      | LatitudeshError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.UpdateKubernetesClusterRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = encodeJSON("body", payload.update_kubernetes_cluster, {
+    explode: true,
+  });
+
+  const pathParams = {
+    kubernetes_cluster_id: encodeSimple(
+      "kubernetes_cluster_id",
+      payload.kubernetes_cluster_id,
+      { explode: false, charEncoding: "percent" },
+    ),
+  };
+  const path = pathToFunc("/kubernetes_clusters/{kubernetes_cluster_id}")(
+    pathParams,
+  );
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/vnd.api+json",
+    Accept: "application/vnd.api+json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.bearer);
+  const securityInput = secConfig == null ? {} : { bearer: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "update-kubernetes-cluster",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.bearer,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "PATCH",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    errorCodes: ["400", "403", "404", "422", "4XX", "503", "5XX"],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    models.KubernetesClusterUpdateResponse,
+    | errors.ErrorObject
+    | LatitudeshError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json([200, 202], models.KubernetesClusterUpdateResponse$inboundSchema, {
+      ctype: "application/vnd.api+json",
+    }),
+    M.jsonErr([400, 403, 404, 422], errors.ErrorObject$inboundSchema, {
+      ctype: "application/vnd.api+json",
+    }),
+    M.jsonErr(503, errors.ErrorObject$inboundSchema, {
+      ctype: "application/vnd.api+json",
+    }),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/funcs/serversReinstall.ts

@@ -18,6 +18,7 @@ import {
   RequestTimeoutError,
   UnexpectedClientError,
 } from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
 import { LatitudeshError } from "../models/errors/latitudesherror.js";
 import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
 import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
@@ -35,6 +36,7 @@ export function serversReinstall(
 ): APIPromise<
   Result<
     void,
+    | errors.ErrorObject
     | LatitudeshError
     | ResponseValidationError
     | ConnectionError
@@ -60,6 +62,7 @@ async function $do(
   [
     Result<
       void,
+      | errors.ErrorObject
       | LatitudeshError
       | ResponseValidationError
       | ConnectionError
@@ -94,7 +97,7 @@ async function $do(
 
   const headers = new Headers(compactMap({
     "Content-Type": "application/json",
-    Accept: "*/*",
+    Accept: "application/vnd.api+json",
   }));
 
   const secConfig = await extractSecurity(client._options.bearer);
@@ -133,7 +136,7 @@ async function $do(
 
   const doResult = await client._do(req, {
     context,
-    errorCodes: ["4XX", "5XX"],
+    errorCodes: ["404", "422", "4XX", "5XX"],
     retryConfig: context.retryConfig,
     retryCodes: context.retryCodes,
   });
@@ -142,8 +145,13 @@ async function $do(
   }
   const response = doResult.value;
 
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
   const [result] = await M.match<
     void,
+    | errors.ErrorObject
     | LatitudeshError
     | ResponseValidationError
     | ConnectionError
@@ -154,9 +162,12 @@ async function $do(
     | SDKValidationError
   >(
     M.nil(201, z.void()),
+    M.jsonErr([404, 422], errors.ErrorObject$inboundSchema, {
+      ctype: "application/vnd.api+json",
+    }),
     M.fail("4XX"),
     M.fail("5XX"),
-  )(response, req);
+  )(response, req, { extraFields: responseFields });
   if (!result.ok) {
     return [result, { status: "complete", request: req, response }];
   }

package/src/lib/config.ts

@@ -74,8 +74,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "2023-06-01",
-  sdkVersion: "0.3.5",
-  genVersion: "2.869.25",
+  sdkVersion: "0.3.7",
+  genVersion: "2.879.6",
   userAgent:
-    "speakeasy-sdk/typescript 0.3.5 2.869.25 2023-06-01 latitudesh-typescript-sdk",
+    "speakeasy-sdk/typescript 0.3.7 2.879.6 2023-06-01 latitudesh-typescript-sdk",
 } as const;

package/src/lib/security.ts

@@ -240,8 +240,9 @@ function applyBearer(
 
 export function resolveGlobalSecurity(
   security: Partial<models.Security> | null | undefined,
+  allowedFields?: number[],
 ): SecurityState | null {
-  return resolveSecurity(
+  let inputs: SecurityInput[][] = [
     [
       {
         fieldName: "Authorization",
@@ -249,7 +250,18 @@ export function resolveGlobalSecurity(
         value: security?.bearer ?? env().LATITUDESH_BEARER,
       },
     ],
-  );
+  ];
+
+  if (allowedFields) {
+    inputs = allowedFields.map((i) => {
+      if (i < 0 || i >= inputs.length) {
+        throw new RangeError(`invalid allowedFields index ${i}`);
+      }
+      return inputs[i]!;
+    });
+  }
+
+  return resolveSecurity(...inputs);
 }
 
 export async function extractSecurity<

package/src/mcp-server/mcp-server.ts

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.3.5",
+    currentVersion: "0.3.7",
   },
 });
 

package/src/mcp-server/server.ts

@@ -41,6 +41,7 @@ import { tool$kubernetesClustersDeleteKubernetesCluster } from "./tools/kubernet
 import { tool$kubernetesClustersGetKubernetesCluster } from "./tools/kubernetesClustersGetKubernetesCluster.js";
 import { tool$kubernetesClustersGetKubernetesClusterKubeconfig } from "./tools/kubernetesClustersGetKubernetesClusterKubeconfig.js";
 import { tool$kubernetesClustersListKubernetesClusters } from "./tools/kubernetesClustersListKubernetesClusters.js";
+import { tool$kubernetesClustersUpdateKubernetesCluster } from "./tools/kubernetesClustersUpdateKubernetesCluster.js";
 import { tool$operatingSystemsListPlans } from "./tools/operatingSystemsListPlans.js";
 import { tool$plansGet } from "./tools/plansGet.js";
 import { tool$plansGetBandwidth } from "./tools/plansGetBandwidth.js";
@@ -152,7 +153,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Latitudesh",
-    version: "0.3.5",
+    version: "0.3.7",
   });
 
   const client = new LatitudeshCore({
@@ -215,6 +216,7 @@ export function createMCPServer(deps: {
   tool(tool$kubernetesClustersCreateKubernetesCluster);
   tool(tool$kubernetesClustersGetKubernetesCluster);
   tool(tool$kubernetesClustersDeleteKubernetesCluster);
+  tool(tool$kubernetesClustersUpdateKubernetesCluster);
   tool(tool$kubernetesClustersGetKubernetesClusterKubeconfig);
   tool(tool$plansList);
   tool(tool$plansGet);

package/src/mcp-server/tools/kubernetesClustersUpdateKubernetesCluster.ts

@@ -0,0 +1,50 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { kubernetesClustersUpdateKubernetesCluster } from "../../funcs/kubernetesClustersUpdateKubernetesCluster.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.UpdateKubernetesClusterRequest$inboundSchema,
+};
+
+export const tool$kubernetesClustersUpdateKubernetesCluster: ToolDefinition<
+  typeof args
+> = {
+  name: "kubernetes-clusters-update-kubernetes-cluster",
+  description: `Scale Kubernetes Cluster
+
+Scales the worker nodes or control plane nodes of a Kubernetes cluster. The cluster must be in \`Provisioned\` phase to accept updates.
+
+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.
+
+When scaling up, the API validates that sufficient server stock is available for the requested delta (e.g., scaling from 2 to 5 workers checks for 3 available servers).
+
+When scaling from 0 workers, you must provide a \`worker_plan\` since there is no existing configuration to inherit the plan from.
+
+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).
+`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await kubernetesClustersUpdateKubernetesCluster(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/models/index.ts

@@ -37,6 +37,7 @@ export * from "./kubernetesclusterdata.js";
 export * from "./kubernetesclusterkubeconfig.js";
 export * from "./kubernetesclusters.js";
 export * from "./kubernetesclustersummarydata.js";
+export * from "./kubernetesclusterupdateresponse.js";
 export * from "./membership.js";
 export * from "./objectstoragedata.js";
 export * from "./objectstorages.js";
@@ -73,6 +74,7 @@ export * from "./traffic.js";
 export * from "./trafficquota.js";
 export * from "./updateapikey.js";
 export * from "./updateelasticip.js";
+export * from "./updatekubernetescluster.js";
 export * from "./user.js";
 export * from "./userdata.js";
 export * from "./userdataobject.js";

package/src/models/kubernetesclusterdata.ts

@@ -44,6 +44,33 @@ export type Workers = {
   availableReplicas?: number | undefined;
 };
 
+/**
+ * Current status of worker nodes. 'idle' when 0 workers, 'ready' when all workers are ready, 'scaling' when workers are being provisioned/removed, 'error' when a worker has failed.
+ */
+export const WorkerStatus = {
+  Idle: "idle",
+  Ready: "ready",
+  Scaling: "scaling",
+  Error: "error",
+} as const;
+/**
+ * Current status of worker nodes. 'idle' when 0 workers, 'ready' when all workers are ready, 'scaling' when workers are being provisioned/removed, 'error' when a worker has failed.
+ */
+export type WorkerStatus = ClosedEnum<typeof WorkerStatus>;
+
+/**
+ * Current status of control plane nodes. 'ready' when control plane is operational, 'scaling' when nodes are being provisioned/removed, 'error' when a control plane node has failed.
+ */
+export const ControlPlaneStatus = {
+  Ready: "ready",
+  Scaling: "scaling",
+  Error: "error",
+} as const;
+/**
+ * Current status of control plane nodes. 'ready' when control plane is operational, 'scaling' when nodes are being provisioned/removed, 'error' when a control plane node has failed.
+ */
+export type ControlPlaneStatus = ClosedEnum<typeof ControlPlaneStatus>;
+
 /**
  * Step identifier
  */
@@ -231,6 +258,14 @@ export type KubernetesClusterDataAttributes = {
    * Worker nodes status information
    */
   workers?: Workers | null | undefined;
+  /**
+   * Current status of worker nodes. 'idle' when 0 workers, 'ready' when all workers are ready, 'scaling' when workers are being provisioned/removed, 'error' when a worker has failed.
+   */
+  workerStatus?: WorkerStatus | null | undefined;
+  /**
+   * Current status of control plane nodes. 'ready' when control plane is operational, 'scaling' when nodes are being provisioned/removed, 'error' when a control plane node has failed.
+   */
+  controlPlaneStatus?: ControlPlaneStatus | undefined;
   /**
    * Whether the underlying infrastructure is ready
    */
@@ -384,6 +419,22 @@ export function workersFromJSON(
   );
 }
 
+/** @internal */
+export const WorkerStatus$inboundSchema: z.ZodNativeEnum<typeof WorkerStatus> =
+  z.nativeEnum(WorkerStatus);
+/** @internal */
+export const WorkerStatus$outboundSchema: z.ZodNativeEnum<typeof WorkerStatus> =
+  WorkerStatus$inboundSchema;
+
+/** @internal */
+export const ControlPlaneStatus$inboundSchema: z.ZodNativeEnum<
+  typeof ControlPlaneStatus
+> = z.nativeEnum(ControlPlaneStatus);
+/** @internal */
+export const ControlPlaneStatus$outboundSchema: z.ZodNativeEnum<
+  typeof ControlPlaneStatus
+> = ControlPlaneStatus$inboundSchema;
+
 /** @internal */
 export const KubernetesClusterDataName$inboundSchema: z.ZodNativeEnum<
   typeof KubernetesClusterDataName
@@ -595,6 +646,8 @@ export const KubernetesClusterDataAttributes$inboundSchema: z.ZodType<
   control_plane: z.nullable(z.lazy(() => ControlPlane$inboundSchema))
     .optional(),
   workers: z.nullable(z.lazy(() => Workers$inboundSchema)).optional(),
+  worker_status: z.nullable(WorkerStatus$inboundSchema).optional(),
+  control_plane_status: ControlPlaneStatus$inboundSchema.optional(),
   infrastructure_ready: z.boolean().optional(),
   control_plane_ready: z.boolean().optional(),
   message: z.string().optional(),
@@ -618,6 +671,8 @@ export const KubernetesClusterDataAttributes$inboundSchema: z.ZodType<
     "control_plane_count": "controlPlaneCount",
     "worker_count": "workerCount",
     "control_plane": "controlPlane",
+    "worker_status": "workerStatus",
+    "control_plane_status": "controlPlaneStatus",
     "infrastructure_ready": "infrastructureReady",
     "control_plane_ready": "controlPlaneReady",
     "last_status_change": "lastStatusChange",
@@ -642,6 +697,8 @@ export type KubernetesClusterDataAttributes$Outbound = {
   worker_count?: number | undefined;
   control_plane?: ControlPlane$Outbound | null | undefined;
   workers?: Workers$Outbound | null | undefined;
+  worker_status?: string | null | undefined;
+  control_plane_status?: string | undefined;
   infrastructure_ready?: boolean | undefined;
   control_plane_ready?: boolean | undefined;
   message?: string | undefined;
@@ -675,6 +732,8 @@ export const KubernetesClusterDataAttributes$outboundSchema: z.ZodType<
   controlPlane: z.nullable(z.lazy(() => ControlPlane$outboundSchema))
     .optional(),
   workers: z.nullable(z.lazy(() => Workers$outboundSchema)).optional(),
+  workerStatus: z.nullable(WorkerStatus$outboundSchema).optional(),
+  controlPlaneStatus: ControlPlaneStatus$outboundSchema.optional(),
   infrastructureReady: z.boolean().optional(),
   controlPlaneReady: z.boolean().optional(),
   message: z.string().optional(),
@@ -697,6 +756,8 @@ export const KubernetesClusterDataAttributes$outboundSchema: z.ZodType<
     controlPlaneCount: "control_plane_count",
     workerCount: "worker_count",
     controlPlane: "control_plane",
+    workerStatus: "worker_status",
+    controlPlaneStatus: "control_plane_status",
     infrastructureReady: "infrastructure_ready",
     controlPlaneReady: "control_plane_ready",
     lastStatusChange: "last_status_change",