@greensecurity/javascript-sdk 0.43.1-beta.9 → 0.43.1-beta.92

package/src/react-query/usersGetLinkedUsers.ts

@@ -0,0 +1,119 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  InvalidateQueryFilters,
+  QueryClient,
+  useQuery,
+  UseQueryResult,
+  useSuspenseQuery,
+  UseSuspenseQueryResult,
+} from "@tanstack/react-query";
+import * as operations from "../models/operations/index.js";
+import { useGreenSecurityContext } from "./_context.js";
+import {
+  QueryHookOptions,
+  SuspenseQueryHookOptions,
+  TupleToPrefixes,
+} from "./_types.js";
+import {
+  buildUsersGetLinkedUsersQuery,
+  prefetchUsersGetLinkedUsers,
+  queryKeyUsersGetLinkedUsers,
+  UsersGetLinkedUsersQueryData,
+} from "./usersGetLinkedUsers.core.js";
+export {
+  buildUsersGetLinkedUsersQuery,
+  prefetchUsersGetLinkedUsers,
+  queryKeyUsersGetLinkedUsers,
+  type UsersGetLinkedUsersQueryData,
+};
+
+/**
+ * Get linked users
+ *
+ * @remarks
+ * Returns a list of users linked to the authenticated user.
+ *
+ * For regular users, returns their own linked users.
+ *
+ * For API users, the `user_id` parameter is required. The API user must
+ * have an active app activation for the requested user.
+ */
+export function useUsersGetLinkedUsers(
+  request: operations.GetLinkedUsersRequest,
+  options?: QueryHookOptions<UsersGetLinkedUsersQueryData>,
+): UseQueryResult<UsersGetLinkedUsersQueryData, Error> {
+  const client = useGreenSecurityContext();
+  return useQuery({
+    ...buildUsersGetLinkedUsersQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * Get linked users
+ *
+ * @remarks
+ * Returns a list of users linked to the authenticated user.
+ *
+ * For regular users, returns their own linked users.
+ *
+ * For API users, the `user_id` parameter is required. The API user must
+ * have an active app activation for the requested user.
+ */
+export function useUsersGetLinkedUsersSuspense(
+  request: operations.GetLinkedUsersRequest,
+  options?: SuspenseQueryHookOptions<UsersGetLinkedUsersQueryData>,
+): UseSuspenseQueryResult<UsersGetLinkedUsersQueryData, Error> {
+  const client = useGreenSecurityContext();
+  return useSuspenseQuery({
+    ...buildUsersGetLinkedUsersQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+export function setUsersGetLinkedUsersData(
+  client: QueryClient,
+  queryKeyBase: [parameters: { userId?: number | undefined }],
+  data: UsersGetLinkedUsersQueryData,
+): UsersGetLinkedUsersQueryData | undefined {
+  const key = queryKeyUsersGetLinkedUsers(...queryKeyBase);
+
+  return client.setQueryData<UsersGetLinkedUsersQueryData>(key, data);
+}
+
+export function invalidateUsersGetLinkedUsers(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<[parameters: { userId?: number | undefined }]>,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: [
+      "@greensecurity/javascript-sdk",
+      "users",
+      "getLinkedUsers",
+      ...queryKeyBase,
+    ],
+  });
+}
+
+export function invalidateAllUsersGetLinkedUsers(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@greensecurity/javascript-sdk", "users", "getLinkedUsers"],
+  });
+}

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

@@ -0,0 +1,87 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  QueryClient,
+  QueryFunctionContext,
+  QueryKey,
+} from "@tanstack/react-query";
+import { GreenSecurityCore } from "../core.js";
+import { vendorScansGetNextScreeningQuestion } from "../funcs/vendorScansGetNextScreeningQuestion.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 VendorScansGetNextScreeningQuestionQueryData =
+  operations.GetNextScreeningQuestionResponseBody;
+
+export function prefetchVendorScansGetNextScreeningQuestion(
+  queryClient: QueryClient,
+  client$: GreenSecurityCore,
+  request: operations.GetNextScreeningQuestionRequest,
+  options?: RequestOptions,
+): Promise<void> {
+  return queryClient.prefetchQuery({
+    ...buildVendorScansGetNextScreeningQuestionQuery(
+      client$,
+      request,
+      options,
+    ),
+  });
+}
+
+export function buildVendorScansGetNextScreeningQuestionQuery(
+  client$: GreenSecurityCore,
+  request: operations.GetNextScreeningQuestionRequest,
+  options?: RequestOptions,
+): {
+  queryKey: QueryKey;
+  queryFn: (
+    context: QueryFunctionContext,
+  ) => Promise<VendorScansGetNextScreeningQuestionQueryData>;
+} {
+  return {
+    queryKey: queryKeyVendorScansGetNextScreeningQuestion(request.id, {
+      expand: request.expand,
+      vendorId: request.vendorId,
+    }),
+    queryFn: async function vendorScansGetNextScreeningQuestionQueryFn(
+      ctx,
+    ): Promise<VendorScansGetNextScreeningQuestionQueryData> {
+      const sig = combineSignals(
+        ctx.signal,
+        options?.signal,
+        options?.fetchOptions?.signal,
+      );
+      const mergedOptions = {
+        ...options?.fetchOptions,
+        ...options,
+        signal: sig,
+      };
+
+      return unwrapAsync(vendorScansGetNextScreeningQuestion(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}
+
+export function queryKeyVendorScansGetNextScreeningQuestion(
+  id: number,
+  parameters: {
+    expand?: Array<components.Expand> | undefined;
+    vendorId?: number | undefined;
+  },
+): QueryKey {
+  return [
+    "@greensecurity/javascript-sdk",
+    "vendor_scans",
+    "getNextScreeningQuestion",
+    id,
+    parameters,
+  ];
+}

package/src/react-query/vendorScansGetNextScreeningQuestion.ts

@@ -0,0 +1,143 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  InvalidateQueryFilters,
+  QueryClient,
+  useQuery,
+  UseQueryResult,
+  useSuspenseQuery,
+  UseSuspenseQueryResult,
+} from "@tanstack/react-query";
+import * as components from "../models/components/index.js";
+import * as operations from "../models/operations/index.js";
+import { useGreenSecurityContext } from "./_context.js";
+import {
+  QueryHookOptions,
+  SuspenseQueryHookOptions,
+  TupleToPrefixes,
+} from "./_types.js";
+import {
+  buildVendorScansGetNextScreeningQuestionQuery,
+  prefetchVendorScansGetNextScreeningQuestion,
+  queryKeyVendorScansGetNextScreeningQuestion,
+  VendorScansGetNextScreeningQuestionQueryData,
+} from "./vendorScansGetNextScreeningQuestion.core.js";
+export {
+  buildVendorScansGetNextScreeningQuestionQuery,
+  prefetchVendorScansGetNextScreeningQuestion,
+  queryKeyVendorScansGetNextScreeningQuestion,
+  type VendorScansGetNextScreeningQuestionQueryData,
+};
+
+/**
+ * Get the next unanswered screening questions for a vendor scan
+ *
+ * @remarks
+ * Retrieve the next unanswered screening question for the specified vendor scan.
+ * If a question exists, the endpoint returns the question and its available answers.
+ *
+ * Available `expand` scopes are:
+ *
+ * screening_question.screening_answers
+ */
+export function useVendorScansGetNextScreeningQuestion(
+  request: operations.GetNextScreeningQuestionRequest,
+  options?: QueryHookOptions<VendorScansGetNextScreeningQuestionQueryData>,
+): UseQueryResult<VendorScansGetNextScreeningQuestionQueryData, Error> {
+  const client = useGreenSecurityContext();
+  return useQuery({
+    ...buildVendorScansGetNextScreeningQuestionQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * Get the next unanswered screening questions for a vendor scan
+ *
+ * @remarks
+ * Retrieve the next unanswered screening question for the specified vendor scan.
+ * If a question exists, the endpoint returns the question and its available answers.
+ *
+ * Available `expand` scopes are:
+ *
+ * screening_question.screening_answers
+ */
+export function useVendorScansGetNextScreeningQuestionSuspense(
+  request: operations.GetNextScreeningQuestionRequest,
+  options?: SuspenseQueryHookOptions<
+    VendorScansGetNextScreeningQuestionQueryData
+  >,
+): UseSuspenseQueryResult<VendorScansGetNextScreeningQuestionQueryData, Error> {
+  const client = useGreenSecurityContext();
+  return useSuspenseQuery({
+    ...buildVendorScansGetNextScreeningQuestionQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+export function setVendorScansGetNextScreeningQuestionData(
+  client: QueryClient,
+  queryKeyBase: [
+    id: number,
+    parameters: {
+      expand?: Array<components.Expand> | undefined;
+      vendorId?: number | undefined;
+    },
+  ],
+  data: VendorScansGetNextScreeningQuestionQueryData,
+): VendorScansGetNextScreeningQuestionQueryData | undefined {
+  const key = queryKeyVendorScansGetNextScreeningQuestion(...queryKeyBase);
+
+  return client.setQueryData<VendorScansGetNextScreeningQuestionQueryData>(
+    key,
+    data,
+  );
+}
+
+export function invalidateVendorScansGetNextScreeningQuestion(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<
+    [
+      id: number,
+      parameters: {
+        expand?: Array<components.Expand> | undefined;
+        vendorId?: number | undefined;
+      },
+    ]
+  >,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: [
+      "@greensecurity/javascript-sdk",
+      "vendor_scans",
+      "getNextScreeningQuestion",
+      ...queryKeyBase,
+    ],
+  });
+}
+
+export function invalidateAllVendorScansGetNextScreeningQuestion(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: [
+      "@greensecurity/javascript-sdk",
+      "vendor_scans",
+      "getNextScreeningQuestion",
+    ],
+  });
+}

package/src/react-query/vendorScansSubmitScreeningResponse.ts

@@ -0,0 +1,97 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { GreenSecurityCore } from "../core.js";
+import { vendorScansSubmitScreeningResponse } from "../funcs/vendorScansSubmitScreeningResponse.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+import { useGreenSecurityContext } from "./_context.js";
+import { MutationHookOptions } from "./_types.js";
+
+export type VendorScansSubmitScreeningResponseMutationVariables = {
+  request: operations.SubmitScreeningResponseRequest;
+  options?: RequestOptions;
+};
+
+export type VendorScansSubmitScreeningResponseMutationData =
+  operations.SubmitScreeningResponseResponseBody;
+
+/**
+ * Create a screening response for a vendor scan
+ *
+ * @remarks
+ * Submits a response to a screening question for the specified vendor scan.
+ * The response may contain a single selected answer, multiple answer IDs
+ * (for multi-select questions), or a custom free-text answer. The endpoint
+ * also executes any triggered actions associated with the response and
+ * indicates whether there is a next screening question.
+ */
+export function useVendorScansSubmitScreeningResponseMutation(
+  options?: MutationHookOptions<
+    VendorScansSubmitScreeningResponseMutationData,
+    Error,
+    VendorScansSubmitScreeningResponseMutationVariables
+  >,
+): UseMutationResult<
+  VendorScansSubmitScreeningResponseMutationData,
+  Error,
+  VendorScansSubmitScreeningResponseMutationVariables
+> {
+  const client = useGreenSecurityContext();
+  return useMutation({
+    ...buildVendorScansSubmitScreeningResponseMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyVendorScansSubmitScreeningResponse(): MutationKey {
+  return [
+    "@greensecurity/javascript-sdk",
+    "vendor_scans",
+    "submitScreeningResponse",
+  ];
+}
+
+export function buildVendorScansSubmitScreeningResponseMutation(
+  client$: GreenSecurityCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: VendorScansSubmitScreeningResponseMutationVariables,
+  ) => Promise<VendorScansSubmitScreeningResponseMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyVendorScansSubmitScreeningResponse(),
+    mutationFn: function vendorScansSubmitScreeningResponseMutationFn({
+      request,
+      options,
+    }): Promise<VendorScansSubmitScreeningResponseMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(vendorScansSubmitScreeningResponse(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/react-query/vendorsChangeSubscription.ts

@@ -28,7 +28,10 @@ export type VendorsChangeSubscriptionMutationData =
  * Change subscription
  *
  * @remarks
- * Calculate subscription price
+ * Change a vendor's credentialing subscription by updating the vendor type
+ * and/or target facilities. If the new selection increases the subscription
+ * price, an invoice is created and the payment profile is charged; the
+ * response includes the invoice id.
  */
 export function useVendorsChangeSubscriptionMutation(
   options?: MutationHookOptions<

package/src/react-query/vendorsGetVendorInvoiceDetails.ts

@@ -41,6 +41,7 @@ export {
  *
  * invoice.line_items
  * invoice.invoice_transactions
+ * invoice.may_pay_invoice
  */
 export function useVendorsGetVendorInvoiceDetails(
   request: operations.GetVendorInvoiceDetailsRequest,
@@ -67,6 +68,7 @@ export function useVendorsGetVendorInvoiceDetails(
  *
  * invoice.line_items
  * invoice.invoice_transactions
+ * invoice.may_pay_invoice
  */
 export function useVendorsGetVendorInvoiceDetailsSuspense(
   request: operations.GetVendorInvoiceDetailsRequest,

package/src/react-query/vendorsListVendorAdditionalFacilityFields.ts

@@ -53,7 +53,9 @@ export {
  * List of vendor's additional facility fields
  *
  * @remarks
- * List of vendor's additional facility fields
+ * Deprecated. Use /vendors/{vendor_id_or_me}/custom-fields.
+ *
+ * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
  */
 export function useVendorsListVendorAdditionalFacilityFields(
   request: operations.ListVendorAdditionalFacilityFieldsRequest,
@@ -76,7 +78,9 @@ export function useVendorsListVendorAdditionalFacilityFields(
  * List of vendor's additional facility fields
  *
  * @remarks
- * List of vendor's additional facility fields
+ * Deprecated. Use /vendors/{vendor_id_or_me}/custom-fields.
+ *
+ * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
  */
 export function useVendorsListVendorAdditionalFacilityFieldsSuspense(
   request: operations.ListVendorAdditionalFacilityFieldsRequest,
@@ -102,7 +106,9 @@ export function useVendorsListVendorAdditionalFacilityFieldsSuspense(
  * List of vendor's additional facility fields
  *
  * @remarks
- * List of vendor's additional facility fields
+ * Deprecated. Use /vendors/{vendor_id_or_me}/custom-fields.
+ *
+ * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
  */
 export function useVendorsListVendorAdditionalFacilityFieldsInfinite(
   request: operations.ListVendorAdditionalFacilityFieldsRequest,
@@ -142,7 +148,9 @@ export function useVendorsListVendorAdditionalFacilityFieldsInfinite(
  * List of vendor's additional facility fields
  *
  * @remarks
- * List of vendor's additional facility fields
+ * Deprecated. Use /vendors/{vendor_id_or_me}/custom-fields.
+ *
+ * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
  */
 export function useVendorsListVendorAdditionalFacilityFieldsInfiniteSuspense(
   request: operations.ListVendorAdditionalFacilityFieldsRequest,

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

@@ -80,6 +80,7 @@ export function buildVendorsListVendorCredentialsQuery(
       page: request.page,
       itemsPerPage: request.itemsPerPage,
       credentialStatus: request.credentialStatus,
+      nameLike: request.nameLike,
       facilityId: request.facilityId,
       includeVc: request.includeVc,
       includeCc: request.includeCc,
@@ -129,6 +130,7 @@ export function buildVendorsListVendorCredentialsInfiniteQuery(
       page: request.page,
       itemsPerPage: request.itemsPerPage,
       credentialStatus: request.credentialStatus,
+      nameLike: request.nameLike,
       facilityId: request.facilityId,
       includeVc: request.includeVc,
       includeCc: request.includeCc,
@@ -177,6 +179,7 @@ export function queryKeyVendorsListVendorCredentials(
     page?: number | undefined;
     itemsPerPage?: number | undefined;
     credentialStatus?: components.CredentialStatus | undefined;
+    nameLike?: string | undefined;
     facilityId?: number | null | undefined;
     includeVc?: number | undefined;
     includeCc?: number | undefined;
@@ -201,6 +204,7 @@ export function queryKeyVendorsListVendorCredentialsInfinite(
     page?: number | undefined;
     itemsPerPage?: number | undefined;
     credentialStatus?: components.CredentialStatus | undefined;
+    nameLike?: string | undefined;
     facilityId?: number | null | undefined;
     includeVc?: number | undefined;
     includeCc?: number | undefined;

package/src/react-query/vendorsListVendorCredentials.ts

@@ -181,6 +181,7 @@ export function setVendorsListVendorCredentialsData(
       page?: number | undefined;
       itemsPerPage?: number | undefined;
       credentialStatus?: components.CredentialStatus | undefined;
+      nameLike?: string | undefined;
       facilityId?: number | null | undefined;
       includeVc?: number | undefined;
       includeCc?: number | undefined;
@@ -206,6 +207,7 @@ export function invalidateVendorsListVendorCredentials(
         page?: number | undefined;
         itemsPerPage?: number | undefined;
         credentialStatus?: components.CredentialStatus | undefined;
+        nameLike?: string | undefined;
         facilityId?: number | null | undefined;
         includeVc?: number | undefined;
         includeCc?: number | undefined;