@greensecurity/javascript-sdk 0.46.0 → 0.47.0-beta.0

package/src/react-query/appsListAppSecrets.ts

@@ -0,0 +1,408 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  InfiniteData,
+  InvalidateQueryFilters,
+  QueryClient,
+  QueryKey,
+  useInfiniteQuery,
+  UseInfiniteQueryResult,
+  useQuery,
+  UseQueryResult,
+  useSuspenseInfiniteQuery,
+  UseSuspenseInfiniteQueryResult,
+  useSuspenseQuery,
+  UseSuspenseQueryResult,
+} from "@tanstack/react-query";
+import * as components from "../models/components/index.js";
+import { GreenSecurityError } from "../models/errors/greensecurityerror.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 { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { useGreenSecurityContext } from "./_context.js";
+import {
+  InfiniteQueryHookOptions,
+  QueryHookOptions,
+  SuspenseInfiniteQueryHookOptions,
+  SuspenseQueryHookOptions,
+  TupleToPrefixes,
+} from "./_types.js";
+import {
+  AppsListAppSecretsInfiniteQueryData,
+  AppsListAppSecretsPageParams,
+  AppsListAppSecretsQueryData,
+  buildAppsListAppSecretsInfiniteQuery,
+  buildAppsListAppSecretsQuery,
+  prefetchAppsListAppSecrets,
+  prefetchAppsListAppSecretsInfinite,
+  queryKeyAppsListAppSecrets,
+  queryKeyAppsListAppSecretsInfinite,
+} from "./appsListAppSecrets.core.js";
+export {
+  type AppsListAppSecretsInfiniteQueryData,
+  type AppsListAppSecretsPageParams,
+  type AppsListAppSecretsQueryData,
+  buildAppsListAppSecretsInfiniteQuery,
+  buildAppsListAppSecretsQuery,
+  prefetchAppsListAppSecrets,
+  prefetchAppsListAppSecretsInfinite,
+  queryKeyAppsListAppSecrets,
+  queryKeyAppsListAppSecretsInfinite,
+};
+
+export type AppsListAppSecretsQueryError =
+  | errors.ApiErrorResponse
+  | errors.AppSecretsUnprocessable
+  | GreenSecurityError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * List app secrets
+ *
+ * @remarks
+ * Lists the secrets in one scope of your app's activation. Payloads are never included; use
+ * `GET /apps/secrets/find` with `expand=payload` to read one. Expired secrets are not
+ * listed.
+ *
+ * Sorted by `name` unless `sort` says otherwise, ascending unless `desc` is set.
+ *
+ * **Permissions.** Send one of these as `Authorization: Bearer`; any other token is refused
+ * with `403`.
+ *
+ * - **An app token**: an app user token (`gsu_`) or an app installation token (`gsi_`). The
+ *   activation comes from the token, so leave `activation_id` out; if you send it, it must be
+ *   the token's own activation (`403` otherwise). Either token may read the `installation`
+ *   scope. For the `user` scope:
+ *   - an app user token reaches only its own user (`user_id` may be left out);
+ *   - an installation token the host minted for one of your views reaches only that view's
+ *     viewer (`user_id` may be left out);
+ *   - an installation token from `client_credentials` reaches any user its activation
+ *     covers, and `user_id` is required.
+ * - **Your app's service account**: its permanent token, or a short-lived OAuth access token
+ *   issued to it without `scope` (by `client_credentials` without `activation_id`, or by the
+ *   `refresh_token` grant). A token issued with `scope` is refused with `403`, and any other
+ *   kind of token, such as a one-time sign-in link token, with `403` "This kind of token may
+ *   not access app secrets". It has no activation of its own, so `activation_id` is required
+ *   (`422` without it) and must be one of your app's activations (`403` otherwise). Its `user`
+ *   scope reaches any user the activation covers, and `user_id` is required.
+ *
+ * A `user_id` that does not exist and one the token may not reach get the same `403` "This
+ * credential may not access secrets of that user", so the endpoint never reveals which user
+ * ids exist.
+ *
+ * Whatever the token, your app must hold the platform permission `app_secrets.write`: list
+ * it in the manifest's `permissions` and upload. Until then every Secret Store call is
+ * refused with `403` "This app has not been granted app_secrets.write." For the service
+ * account this is checked before `activation_id` is looked at, so an app without the
+ * permission gets that answer whether or not it sent an `activation_id`.
+ *
+ * Every response carries `Cache-Control: no-store`, errors included, so no cache keeps a
+ * secret.
+ */
+export function useAppsListAppSecrets(
+  request: operations.ListAppSecretsRequest,
+  options?: QueryHookOptions<
+    AppsListAppSecretsQueryData,
+    AppsListAppSecretsQueryError
+  >,
+): UseQueryResult<AppsListAppSecretsQueryData, AppsListAppSecretsQueryError> {
+  const client = useGreenSecurityContext();
+  return useQuery({
+    ...buildAppsListAppSecretsQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * List app secrets
+ *
+ * @remarks
+ * Lists the secrets in one scope of your app's activation. Payloads are never included; use
+ * `GET /apps/secrets/find` with `expand=payload` to read one. Expired secrets are not
+ * listed.
+ *
+ * Sorted by `name` unless `sort` says otherwise, ascending unless `desc` is set.
+ *
+ * **Permissions.** Send one of these as `Authorization: Bearer`; any other token is refused
+ * with `403`.
+ *
+ * - **An app token**: an app user token (`gsu_`) or an app installation token (`gsi_`). The
+ *   activation comes from the token, so leave `activation_id` out; if you send it, it must be
+ *   the token's own activation (`403` otherwise). Either token may read the `installation`
+ *   scope. For the `user` scope:
+ *   - an app user token reaches only its own user (`user_id` may be left out);
+ *   - an installation token the host minted for one of your views reaches only that view's
+ *     viewer (`user_id` may be left out);
+ *   - an installation token from `client_credentials` reaches any user its activation
+ *     covers, and `user_id` is required.
+ * - **Your app's service account**: its permanent token, or a short-lived OAuth access token
+ *   issued to it without `scope` (by `client_credentials` without `activation_id`, or by the
+ *   `refresh_token` grant). A token issued with `scope` is refused with `403`, and any other
+ *   kind of token, such as a one-time sign-in link token, with `403` "This kind of token may
+ *   not access app secrets". It has no activation of its own, so `activation_id` is required
+ *   (`422` without it) and must be one of your app's activations (`403` otherwise). Its `user`
+ *   scope reaches any user the activation covers, and `user_id` is required.
+ *
+ * A `user_id` that does not exist and one the token may not reach get the same `403` "This
+ * credential may not access secrets of that user", so the endpoint never reveals which user
+ * ids exist.
+ *
+ * Whatever the token, your app must hold the platform permission `app_secrets.write`: list
+ * it in the manifest's `permissions` and upload. Until then every Secret Store call is
+ * refused with `403` "This app has not been granted app_secrets.write." For the service
+ * account this is checked before `activation_id` is looked at, so an app without the
+ * permission gets that answer whether or not it sent an `activation_id`.
+ *
+ * Every response carries `Cache-Control: no-store`, errors included, so no cache keeps a
+ * secret.
+ */
+export function useAppsListAppSecretsSuspense(
+  request: operations.ListAppSecretsRequest,
+  options?: SuspenseQueryHookOptions<
+    AppsListAppSecretsQueryData,
+    AppsListAppSecretsQueryError
+  >,
+): UseSuspenseQueryResult<
+  AppsListAppSecretsQueryData,
+  AppsListAppSecretsQueryError
+> {
+  const client = useGreenSecurityContext();
+  return useSuspenseQuery({
+    ...buildAppsListAppSecretsQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * List app secrets
+ *
+ * @remarks
+ * Lists the secrets in one scope of your app's activation. Payloads are never included; use
+ * `GET /apps/secrets/find` with `expand=payload` to read one. Expired secrets are not
+ * listed.
+ *
+ * Sorted by `name` unless `sort` says otherwise, ascending unless `desc` is set.
+ *
+ * **Permissions.** Send one of these as `Authorization: Bearer`; any other token is refused
+ * with `403`.
+ *
+ * - **An app token**: an app user token (`gsu_`) or an app installation token (`gsi_`). The
+ *   activation comes from the token, so leave `activation_id` out; if you send it, it must be
+ *   the token's own activation (`403` otherwise). Either token may read the `installation`
+ *   scope. For the `user` scope:
+ *   - an app user token reaches only its own user (`user_id` may be left out);
+ *   - an installation token the host minted for one of your views reaches only that view's
+ *     viewer (`user_id` may be left out);
+ *   - an installation token from `client_credentials` reaches any user its activation
+ *     covers, and `user_id` is required.
+ * - **Your app's service account**: its permanent token, or a short-lived OAuth access token
+ *   issued to it without `scope` (by `client_credentials` without `activation_id`, or by the
+ *   `refresh_token` grant). A token issued with `scope` is refused with `403`, and any other
+ *   kind of token, such as a one-time sign-in link token, with `403` "This kind of token may
+ *   not access app secrets". It has no activation of its own, so `activation_id` is required
+ *   (`422` without it) and must be one of your app's activations (`403` otherwise). Its `user`
+ *   scope reaches any user the activation covers, and `user_id` is required.
+ *
+ * A `user_id` that does not exist and one the token may not reach get the same `403` "This
+ * credential may not access secrets of that user", so the endpoint never reveals which user
+ * ids exist.
+ *
+ * Whatever the token, your app must hold the platform permission `app_secrets.write`: list
+ * it in the manifest's `permissions` and upload. Until then every Secret Store call is
+ * refused with `403` "This app has not been granted app_secrets.write." For the service
+ * account this is checked before `activation_id` is looked at, so an app without the
+ * permission gets that answer whether or not it sent an `activation_id`.
+ *
+ * Every response carries `Cache-Control: no-store`, errors included, so no cache keeps a
+ * secret.
+ */
+export function useAppsListAppSecretsInfinite(
+  request: operations.ListAppSecretsRequest,
+  options?: InfiniteQueryHookOptions<
+    AppsListAppSecretsInfiniteQueryData,
+    AppsListAppSecretsQueryError
+  >,
+): UseInfiniteQueryResult<
+  InfiniteData<
+    AppsListAppSecretsInfiniteQueryData,
+    AppsListAppSecretsPageParams
+  >,
+  AppsListAppSecretsQueryError
+> {
+  const client = useGreenSecurityContext();
+  return useInfiniteQuery<
+    AppsListAppSecretsInfiniteQueryData,
+    AppsListAppSecretsQueryError,
+    InfiniteData<
+      AppsListAppSecretsInfiniteQueryData,
+      AppsListAppSecretsPageParams
+    >,
+    QueryKey,
+    AppsListAppSecretsPageParams
+  >({
+    ...buildAppsListAppSecretsInfiniteQuery(
+      client,
+      request,
+      options,
+    ),
+    initialPageParam: options?.initialPageParam,
+    getNextPageParam: (previousPage) => previousPage["~next"],
+    ...options,
+  });
+}
+
+/**
+ * List app secrets
+ *
+ * @remarks
+ * Lists the secrets in one scope of your app's activation. Payloads are never included; use
+ * `GET /apps/secrets/find` with `expand=payload` to read one. Expired secrets are not
+ * listed.
+ *
+ * Sorted by `name` unless `sort` says otherwise, ascending unless `desc` is set.
+ *
+ * **Permissions.** Send one of these as `Authorization: Bearer`; any other token is refused
+ * with `403`.
+ *
+ * - **An app token**: an app user token (`gsu_`) or an app installation token (`gsi_`). The
+ *   activation comes from the token, so leave `activation_id` out; if you send it, it must be
+ *   the token's own activation (`403` otherwise). Either token may read the `installation`
+ *   scope. For the `user` scope:
+ *   - an app user token reaches only its own user (`user_id` may be left out);
+ *   - an installation token the host minted for one of your views reaches only that view's
+ *     viewer (`user_id` may be left out);
+ *   - an installation token from `client_credentials` reaches any user its activation
+ *     covers, and `user_id` is required.
+ * - **Your app's service account**: its permanent token, or a short-lived OAuth access token
+ *   issued to it without `scope` (by `client_credentials` without `activation_id`, or by the
+ *   `refresh_token` grant). A token issued with `scope` is refused with `403`, and any other
+ *   kind of token, such as a one-time sign-in link token, with `403` "This kind of token may
+ *   not access app secrets". It has no activation of its own, so `activation_id` is required
+ *   (`422` without it) and must be one of your app's activations (`403` otherwise). Its `user`
+ *   scope reaches any user the activation covers, and `user_id` is required.
+ *
+ * A `user_id` that does not exist and one the token may not reach get the same `403` "This
+ * credential may not access secrets of that user", so the endpoint never reveals which user
+ * ids exist.
+ *
+ * Whatever the token, your app must hold the platform permission `app_secrets.write`: list
+ * it in the manifest's `permissions` and upload. Until then every Secret Store call is
+ * refused with `403` "This app has not been granted app_secrets.write." For the service
+ * account this is checked before `activation_id` is looked at, so an app without the
+ * permission gets that answer whether or not it sent an `activation_id`.
+ *
+ * Every response carries `Cache-Control: no-store`, errors included, so no cache keeps a
+ * secret.
+ */
+export function useAppsListAppSecretsInfiniteSuspense(
+  request: operations.ListAppSecretsRequest,
+  options?: SuspenseInfiniteQueryHookOptions<
+    AppsListAppSecretsInfiniteQueryData,
+    AppsListAppSecretsQueryError
+  >,
+): UseSuspenseInfiniteQueryResult<
+  InfiniteData<
+    AppsListAppSecretsInfiniteQueryData,
+    AppsListAppSecretsPageParams
+  >,
+  AppsListAppSecretsQueryError
+> {
+  const client = useGreenSecurityContext();
+  return useSuspenseInfiniteQuery<
+    AppsListAppSecretsInfiniteQueryData,
+    AppsListAppSecretsQueryError,
+    InfiniteData<
+      AppsListAppSecretsInfiniteQueryData,
+      AppsListAppSecretsPageParams
+    >,
+    QueryKey,
+    AppsListAppSecretsPageParams
+  >({
+    ...buildAppsListAppSecretsInfiniteQuery(
+      client,
+      request,
+      options,
+    ),
+    initialPageParam: options?.initialPageParam,
+    getNextPageParam: (previousPage) => previousPage["~next"],
+    ...options,
+  });
+}
+
+export function setAppsListAppSecretsData(
+  client: QueryClient,
+  queryKeyBase: [
+    parameters: {
+      scope: components.AppSecretScope;
+      activationId?: number | undefined;
+      page?: number | undefined;
+      itemsPerPage?: number | undefined;
+      desc?: components.Desc | undefined;
+      sort?: operations.ListAppSecretsQueryParamSort | undefined;
+    },
+  ],
+  data: AppsListAppSecretsQueryData,
+): AppsListAppSecretsQueryData | undefined {
+  const key = queryKeyAppsListAppSecrets(...queryKeyBase);
+
+  return client.setQueryData<AppsListAppSecretsQueryData>(key, data);
+}
+
+export function invalidateAppsListAppSecrets(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<
+    [parameters: {
+      scope: components.AppSecretScope;
+      activationId?: number | undefined;
+      page?: number | undefined;
+      itemsPerPage?: number | undefined;
+      desc?: components.Desc | undefined;
+      sort?: operations.ListAppSecretsQueryParamSort | undefined;
+    }]
+  >,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: [
+      "@greensecurity/javascript-sdk",
+      "apps",
+      "listAppSecrets",
+      ...queryKeyBase,
+    ],
+  });
+}
+
+export function invalidateAllAppsListAppSecrets(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@greensecurity/javascript-sdk", "apps", "listAppSecrets"],
+  });
+}

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

@@ -0,0 +1,73 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  QueryClient,
+  QueryFunctionContext,
+  QueryKey,
+} from "@tanstack/react-query";
+import { GreenSecurityCore } from "../core.js";
+import { appsListAppVersions } from "../funcs/appsListAppVersions.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 AppsListAppVersionsQueryData = {
+  [k: string]: components.AppVersionInstalls;
+};
+
+export function prefetchAppsListAppVersions(
+  queryClient: QueryClient,
+  client$: GreenSecurityCore,
+  request: operations.ListAppVersionsRequest,
+  options?: RequestOptions,
+): Promise<void> {
+  return queryClient.prefetchQuery({
+    ...buildAppsListAppVersionsQuery(
+      client$,
+      request,
+      options,
+    ),
+  });
+}
+
+export function buildAppsListAppVersionsQuery(
+  client$: GreenSecurityCore,
+  request: operations.ListAppVersionsRequest,
+  options?: RequestOptions,
+): {
+  queryKey: QueryKey;
+  queryFn: (
+    context: QueryFunctionContext,
+  ) => Promise<AppsListAppVersionsQueryData>;
+} {
+  return {
+    queryKey: queryKeyAppsListAppVersions(request.appId),
+    queryFn: async function appsListAppVersionsQueryFn(
+      ctx,
+    ): Promise<AppsListAppVersionsQueryData> {
+      const sig = combineSignals(
+        ctx.signal,
+        options?.signal,
+        options?.fetchOptions?.signal,
+      );
+      const mergedOptions = {
+        ...options?.fetchOptions,
+        ...options,
+        signal: sig,
+      };
+
+      return unwrapAsync(appsListAppVersions(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}
+
+export function queryKeyAppsListAppVersions(appId: number): QueryKey {
+  return ["@greensecurity/javascript-sdk", "apps", "listAppVersions", appId];
+}

package/src/react-query/appsListAppVersions.ts

@@ -0,0 +1,183 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  InvalidateQueryFilters,
+  QueryClient,
+  useQuery,
+  UseQueryResult,
+  useSuspenseQuery,
+  UseSuspenseQueryResult,
+} from "@tanstack/react-query";
+import { GreenSecurityError } from "../models/errors/greensecurityerror.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 { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { useGreenSecurityContext } from "./_context.js";
+import {
+  QueryHookOptions,
+  SuspenseQueryHookOptions,
+  TupleToPrefixes,
+} from "./_types.js";
+import {
+  AppsListAppVersionsQueryData,
+  buildAppsListAppVersionsQuery,
+  prefetchAppsListAppVersions,
+  queryKeyAppsListAppVersions,
+} from "./appsListAppVersions.core.js";
+export {
+  type AppsListAppVersionsQueryData,
+  buildAppsListAppVersionsQuery,
+  prefetchAppsListAppVersions,
+  queryKeyAppsListAppVersions,
+};
+
+export type AppsListAppVersionsQueryError =
+  | errors.ApiErrorResponse
+  | errors.UnprocessableEntityOrValidationError
+  | GreenSecurityError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * List app versions with installation counts
+ *
+ * @remarks
+ * Lists every uploaded version of the app, with the review status of each and the number of
+ * installations that run it. `apps-cli status` shows the same information.
+ *
+ * The response is an object keyed by version string, in the order the versions were first
+ * uploaded. Every version is listed, including versions that are in review or
+ * rejected, which no installation runs. An app that hasn't been uploaded since review began has
+ * no versions yet, and the response is `{}`.
+ *
+ * A version that's uploaded more than once has one key. Its `status` is the status of the
+ * latest upload, and its counts cover every installation that runs an accepted upload of that
+ * version. A manifest without a `version` is listed under the key `""`.
+ *
+ * Each installation counts under the version it runs, which is the version its administrators
+ * last approved (see [Existing installations keep their version](/apps/security-and-review#existing-installations-keep-their-version)).
+ * **Site-wide installations aren't counted.** An installation for a whole site covers every
+ * user, company, facility, and health system in it, so the counts leave it out.
+ *
+ * **Permissions.** Accepts the app service account's permanent token, or the developer CLI
+ * token (`gsd_`, from `apps-cli login`) of an `owner` or `developer` of the app, as
+ * `Authorization: Bearer`. Any other app token gets `403`. Anyone else gets `404`, the same
+ * response as for an app id that doesn't exist. That includes a developer signed in with a
+ * browser session.
+ */
+export function useAppsListAppVersions(
+  request: operations.ListAppVersionsRequest,
+  options?: QueryHookOptions<
+    AppsListAppVersionsQueryData,
+    AppsListAppVersionsQueryError
+  >,
+): UseQueryResult<AppsListAppVersionsQueryData, AppsListAppVersionsQueryError> {
+  const client = useGreenSecurityContext();
+  return useQuery({
+    ...buildAppsListAppVersionsQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * List app versions with installation counts
+ *
+ * @remarks
+ * Lists every uploaded version of the app, with the review status of each and the number of
+ * installations that run it. `apps-cli status` shows the same information.
+ *
+ * The response is an object keyed by version string, in the order the versions were first
+ * uploaded. Every version is listed, including versions that are in review or
+ * rejected, which no installation runs. An app that hasn't been uploaded since review began has
+ * no versions yet, and the response is `{}`.
+ *
+ * A version that's uploaded more than once has one key. Its `status` is the status of the
+ * latest upload, and its counts cover every installation that runs an accepted upload of that
+ * version. A manifest without a `version` is listed under the key `""`.
+ *
+ * Each installation counts under the version it runs, which is the version its administrators
+ * last approved (see [Existing installations keep their version](/apps/security-and-review#existing-installations-keep-their-version)).
+ * **Site-wide installations aren't counted.** An installation for a whole site covers every
+ * user, company, facility, and health system in it, so the counts leave it out.
+ *
+ * **Permissions.** Accepts the app service account's permanent token, or the developer CLI
+ * token (`gsd_`, from `apps-cli login`) of an `owner` or `developer` of the app, as
+ * `Authorization: Bearer`. Any other app token gets `403`. Anyone else gets `404`, the same
+ * response as for an app id that doesn't exist. That includes a developer signed in with a
+ * browser session.
+ */
+export function useAppsListAppVersionsSuspense(
+  request: operations.ListAppVersionsRequest,
+  options?: SuspenseQueryHookOptions<
+    AppsListAppVersionsQueryData,
+    AppsListAppVersionsQueryError
+  >,
+): UseSuspenseQueryResult<
+  AppsListAppVersionsQueryData,
+  AppsListAppVersionsQueryError
+> {
+  const client = useGreenSecurityContext();
+  return useSuspenseQuery({
+    ...buildAppsListAppVersionsQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+export function setAppsListAppVersionsData(
+  client: QueryClient,
+  queryKeyBase: [appId: number],
+  data: AppsListAppVersionsQueryData,
+): AppsListAppVersionsQueryData | undefined {
+  const key = queryKeyAppsListAppVersions(...queryKeyBase);
+
+  return client.setQueryData<AppsListAppVersionsQueryData>(key, data);
+}
+
+export function invalidateAppsListAppVersions(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<[appId: number]>,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: [
+      "@greensecurity/javascript-sdk",
+      "apps",
+      "listAppVersions",
+      ...queryKeyBase,
+    ],
+  });
+}
+
+export function invalidateAllAppsListAppVersions(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@greensecurity/javascript-sdk", "apps", "listAppVersions"],
+  });
+}