@meetkai/mka1 0.51.8 → 0.51.9

package/src/react-query/servingRecipesGet.ts

@@ -0,0 +1,141 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  InvalidateQueryFilters,
+  QueryClient,
+  useQuery,
+  UseQueryResult,
+  useSuspenseQuery,
+  UseSuspenseQueryResult,
+} from "@tanstack/react-query";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKError } from "../models/errors/sdkerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { useSDKContext } from "./_context.js";
+import {
+  QueryHookOptions,
+  SuspenseQueryHookOptions,
+  TupleToPrefixes,
+} from "./_types.js";
+import {
+  buildServingRecipesGetQuery,
+  prefetchServingRecipesGet,
+  queryKeyServingRecipesGet,
+  ServingRecipesGetQueryData,
+} from "./servingRecipesGet.core.js";
+export {
+  buildServingRecipesGetQuery,
+  prefetchServingRecipesGet,
+  queryKeyServingRecipesGet,
+  type ServingRecipesGetQueryData,
+};
+
+export type ServingRecipesGetQueryError =
+  | errors.ServingError
+  | errors.ServingHTTPValidationError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Get a serving recipe
+ *
+ * @remarks
+ * Get one recipe catalog record. Tenants can read enabled recipes; disabled recipes are visible to cluster administrators only.
+ */
+export function useServingRecipesGet(
+  request: operations.GetServingRecipeRequest,
+  options?: QueryHookOptions<
+    ServingRecipesGetQueryData,
+    ServingRecipesGetQueryError
+  >,
+): UseQueryResult<ServingRecipesGetQueryData, ServingRecipesGetQueryError> {
+  const client = useSDKContext();
+  return useQuery({
+    ...buildServingRecipesGetQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * Get a serving recipe
+ *
+ * @remarks
+ * Get one recipe catalog record. Tenants can read enabled recipes; disabled recipes are visible to cluster administrators only.
+ */
+export function useServingRecipesGetSuspense(
+  request: operations.GetServingRecipeRequest,
+  options?: SuspenseQueryHookOptions<
+    ServingRecipesGetQueryData,
+    ServingRecipesGetQueryError
+  >,
+): UseSuspenseQueryResult<
+  ServingRecipesGetQueryData,
+  ServingRecipesGetQueryError
+> {
+  const client = useSDKContext();
+  return useSuspenseQuery({
+    ...buildServingRecipesGetQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+export function setServingRecipesGetData(
+  client: QueryClient,
+  queryKeyBase: [
+    name: string,
+    parameters: { xOnBehalfOf?: string | undefined },
+  ],
+  data: ServingRecipesGetQueryData,
+): ServingRecipesGetQueryData | undefined {
+  const key = queryKeyServingRecipesGet(...queryKeyBase);
+
+  return client.setQueryData<ServingRecipesGetQueryData>(key, data);
+}
+
+export function invalidateServingRecipesGet(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<
+    [name: string, parameters: { xOnBehalfOf?: string | undefined }]
+  >,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "recipes", "get", ...queryKeyBase],
+  });
+}
+
+export function invalidateAllServingRecipesGet(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "recipes", "get"],
+  });
+}

package/src/react-query/servingRecipesList.core.ts

@@ -0,0 +1,81 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  QueryClient,
+  QueryFunctionContext,
+  QueryKey,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { servingRecipesList } from "../funcs/servingRecipesList.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+export type ServingRecipesListQueryData = components.PageServingRecipe;
+
+export function prefetchServingRecipesList(
+  queryClient: QueryClient,
+  client$: SDKCore,
+  request: operations.ListServingRecipesRequest,
+  options?: RequestOptions,
+): Promise<void> {
+  return queryClient.prefetchQuery({
+    ...buildServingRecipesListQuery(
+      client$,
+      request,
+      options,
+    ),
+  });
+}
+
+export function buildServingRecipesListQuery(
+  client$: SDKCore,
+  request: operations.ListServingRecipesRequest,
+  options?: RequestOptions,
+): {
+  queryKey: QueryKey;
+  queryFn: (
+    context: QueryFunctionContext,
+  ) => Promise<ServingRecipesListQueryData>;
+} {
+  return {
+    queryKey: queryKeyServingRecipesList({
+      cursor: request.cursor,
+      limit: request.limit,
+      xOnBehalfOf: request.xOnBehalfOf,
+    }),
+    queryFn: async function servingRecipesListQueryFn(
+      ctx,
+    ): Promise<ServingRecipesListQueryData> {
+      const sig = combineSignals(
+        ctx.signal,
+        options?.signal,
+        options?.fetchOptions?.signal,
+      );
+      const mergedOptions = {
+        ...options?.fetchOptions,
+        ...options,
+        signal: sig,
+      };
+
+      return unwrapAsync(servingRecipesList(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}
+
+export function queryKeyServingRecipesList(
+  parameters: {
+    cursor?: string | null | undefined;
+    limit?: number | undefined;
+    xOnBehalfOf?: string | undefined;
+  },
+): QueryKey {
+  return ["@meetkai/mka1", "recipes", "list", parameters];
+}

package/src/react-query/servingRecipesList.ts

@@ -0,0 +1,147 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  InvalidateQueryFilters,
+  QueryClient,
+  useQuery,
+  UseQueryResult,
+  useSuspenseQuery,
+  UseSuspenseQueryResult,
+} from "@tanstack/react-query";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKError } from "../models/errors/sdkerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { useSDKContext } from "./_context.js";
+import {
+  QueryHookOptions,
+  SuspenseQueryHookOptions,
+  TupleToPrefixes,
+} from "./_types.js";
+import {
+  buildServingRecipesListQuery,
+  prefetchServingRecipesList,
+  queryKeyServingRecipesList,
+  ServingRecipesListQueryData,
+} from "./servingRecipesList.core.js";
+export {
+  buildServingRecipesListQuery,
+  prefetchServingRecipesList,
+  queryKeyServingRecipesList,
+  type ServingRecipesListQueryData,
+};
+
+export type ServingRecipesListQueryError =
+  | errors.ServingHTTPValidationError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * List serving recipes
+ *
+ * @remarks
+ * List the cluster-global serving recipe catalog. Tenants see only enabled (deployable) recipes; cluster administrators see every registered recipe including disabled ones.
+ */
+export function useServingRecipesList(
+  request: operations.ListServingRecipesRequest,
+  options?: QueryHookOptions<
+    ServingRecipesListQueryData,
+    ServingRecipesListQueryError
+  >,
+): UseQueryResult<ServingRecipesListQueryData, ServingRecipesListQueryError> {
+  const client = useSDKContext();
+  return useQuery({
+    ...buildServingRecipesListQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * List serving recipes
+ *
+ * @remarks
+ * List the cluster-global serving recipe catalog. Tenants see only enabled (deployable) recipes; cluster administrators see every registered recipe including disabled ones.
+ */
+export function useServingRecipesListSuspense(
+  request: operations.ListServingRecipesRequest,
+  options?: SuspenseQueryHookOptions<
+    ServingRecipesListQueryData,
+    ServingRecipesListQueryError
+  >,
+): UseSuspenseQueryResult<
+  ServingRecipesListQueryData,
+  ServingRecipesListQueryError
+> {
+  const client = useSDKContext();
+  return useSuspenseQuery({
+    ...buildServingRecipesListQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+export function setServingRecipesListData(
+  client: QueryClient,
+  queryKeyBase: [
+    parameters: {
+      cursor?: string | null | undefined;
+      limit?: number | undefined;
+      xOnBehalfOf?: string | undefined;
+    },
+  ],
+  data: ServingRecipesListQueryData,
+): ServingRecipesListQueryData | undefined {
+  const key = queryKeyServingRecipesList(...queryKeyBase);
+
+  return client.setQueryData<ServingRecipesListQueryData>(key, data);
+}
+
+export function invalidateServingRecipesList(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<
+    [parameters: {
+      cursor?: string | null | undefined;
+      limit?: number | undefined;
+      xOnBehalfOf?: string | undefined;
+    }]
+  >,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "recipes", "list", ...queryKeyBase],
+  });
+}
+
+export function invalidateAllServingRecipesList(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@meetkai/mka1", "recipes", "list"],
+  });
+}

package/src/react-query/servingRecipesRegister.ts

@@ -0,0 +1,112 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { servingRecipesRegister } from "../funcs/servingRecipesRegister.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKError } from "../models/errors/sdkerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+import { useSDKContext } from "./_context.js";
+import { MutationHookOptions } from "./_types.js";
+
+export type ServingRecipesRegisterMutationVariables = {
+  request: operations.RegisterServingRecipeRequest;
+  options?: RequestOptions;
+};
+
+export type ServingRecipesRegisterMutationData = components.ServingRecipe;
+
+export type ServingRecipesRegisterMutationError =
+  | errors.ServingError
+  | errors.ServingHTTPValidationError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Register a serving recipe
+ *
+ * @remarks
+ * Register (or re-register) a digest-pinned recipe manifest in the catalog. A new recipe registers disabled; re-registration replaces the manifest and preserves enablement. Cluster administrators only.
+ */
+export function useServingRecipesRegisterMutation(
+  options?: MutationHookOptions<
+    ServingRecipesRegisterMutationData,
+    ServingRecipesRegisterMutationError,
+    ServingRecipesRegisterMutationVariables
+  >,
+): UseMutationResult<
+  ServingRecipesRegisterMutationData,
+  ServingRecipesRegisterMutationError,
+  ServingRecipesRegisterMutationVariables
+> {
+  const client = useSDKContext();
+  return useMutation({
+    ...buildServingRecipesRegisterMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyServingRecipesRegister(): MutationKey {
+  return ["@meetkai/mka1", "recipes", "register"];
+}
+
+export function buildServingRecipesRegisterMutation(
+  client$: SDKCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: ServingRecipesRegisterMutationVariables,
+  ) => Promise<ServingRecipesRegisterMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyServingRecipesRegister(),
+    mutationFn: function servingRecipesRegisterMutationFn({
+      request,
+      options,
+    }): Promise<ServingRecipesRegisterMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(servingRecipesRegister(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/servingRecipesSetEnabled.ts

@@ -0,0 +1,112 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { SDKCore } from "../core.js";
+import { servingRecipesSetEnabled } from "../funcs/servingRecipesSetEnabled.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKError } from "../models/errors/sdkerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+import { useSDKContext } from "./_context.js";
+import { MutationHookOptions } from "./_types.js";
+
+export type ServingRecipesSetEnabledMutationVariables = {
+  request: operations.SetServingRecipeEnabledRequest;
+  options?: RequestOptions;
+};
+
+export type ServingRecipesSetEnabledMutationData = components.ServingRecipe;
+
+export type ServingRecipesSetEnabledMutationError =
+  | errors.ServingError
+  | errors.ServingHTTPValidationError
+  | SDKError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Enable or disable a serving recipe
+ *
+ * @remarks
+ * Toggle cluster-wide deployability of a registered recipe. Disabling does not stop deployments already running the recipe. Cluster administrators only.
+ */
+export function useServingRecipesSetEnabledMutation(
+  options?: MutationHookOptions<
+    ServingRecipesSetEnabledMutationData,
+    ServingRecipesSetEnabledMutationError,
+    ServingRecipesSetEnabledMutationVariables
+  >,
+): UseMutationResult<
+  ServingRecipesSetEnabledMutationData,
+  ServingRecipesSetEnabledMutationError,
+  ServingRecipesSetEnabledMutationVariables
+> {
+  const client = useSDKContext();
+  return useMutation({
+    ...buildServingRecipesSetEnabledMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyServingRecipesSetEnabled(): MutationKey {
+  return ["@meetkai/mka1", "recipes", "setEnabled"];
+}
+
+export function buildServingRecipesSetEnabledMutation(
+  client$: SDKCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: ServingRecipesSetEnabledMutationVariables,
+  ) => Promise<ServingRecipesSetEnabledMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyServingRecipesSetEnabled(),
+    mutationFn: function servingRecipesSetEnabledMutationFn({
+      request,
+      options,
+    }): Promise<ServingRecipesSetEnabledMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(servingRecipesSetEnabled(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/sdk/recipes.ts

@@ -0,0 +1,100 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { servingRecipesDelete } from "../funcs/servingRecipesDelete.js";
+import { servingRecipesGet } from "../funcs/servingRecipesGet.js";
+import { servingRecipesList } from "../funcs/servingRecipesList.js";
+import { servingRecipesRegister } from "../funcs/servingRecipesRegister.js";
+import { servingRecipesSetEnabled } from "../funcs/servingRecipesSetEnabled.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Recipes extends ClientSDK {
+  /**
+   * List serving recipes
+   *
+   * @remarks
+   * List the cluster-global serving recipe catalog. Tenants see only enabled (deployable) recipes; cluster administrators see every registered recipe including disabled ones.
+   */
+  async list(
+    request: operations.ListServingRecipesRequest,
+    options?: RequestOptions,
+  ): Promise<components.PageServingRecipe> {
+    return unwrapAsync(servingRecipesList(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Delete a serving recipe
+   *
+   * @remarks
+   * Remove a recipe from the catalog. Rejected while any live deployment's active revision references the recipe. Cluster administrators only.
+   */
+  async delete(
+    request: operations.DeleteServingRecipeRequest,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(servingRecipesDelete(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get a serving recipe
+   *
+   * @remarks
+   * Get one recipe catalog record. Tenants can read enabled recipes; disabled recipes are visible to cluster administrators only.
+   */
+  async get(
+    request: operations.GetServingRecipeRequest,
+    options?: RequestOptions,
+  ): Promise<components.ServingRecipe> {
+    return unwrapAsync(servingRecipesGet(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Enable or disable a serving recipe
+   *
+   * @remarks
+   * Toggle cluster-wide deployability of a registered recipe. Disabling does not stop deployments already running the recipe. Cluster administrators only.
+   */
+  async setEnabled(
+    request: operations.SetServingRecipeEnabledRequest,
+    options?: RequestOptions,
+  ): Promise<components.ServingRecipe> {
+    return unwrapAsync(servingRecipesSetEnabled(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Register a serving recipe
+   *
+   * @remarks
+   * Register (or re-register) a digest-pinned recipe manifest in the catalog. A new recipe registers disabled; re-registration replaces the manifest and preserves enablement. Cluster administrators only.
+   */
+  async register(
+    request: operations.RegisterServingRecipeRequest,
+    options?: RequestOptions,
+  ): Promise<components.ServingRecipe> {
+    return unwrapAsync(servingRecipesRegister(
+      this,
+      request,
+      options,
+    ));
+  }
+}