@greensecurity/javascript-sdk 0.44.0-beta.2 → 0.44.0-beta.21

package/src/react-query/organizationsListFacilityVendors.ts

@@ -0,0 +1,351 @@
+/*
+ * 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 {
+  buildOrganizationsListFacilityVendorsInfiniteQuery,
+  buildOrganizationsListFacilityVendorsQuery,
+  OrganizationsListFacilityVendorsInfiniteQueryData,
+  OrganizationsListFacilityVendorsPageParams,
+  OrganizationsListFacilityVendorsQueryData,
+  prefetchOrganizationsListFacilityVendors,
+  prefetchOrganizationsListFacilityVendorsInfinite,
+  queryKeyOrganizationsListFacilityVendors,
+  queryKeyOrganizationsListFacilityVendorsInfinite,
+} from "./organizationsListFacilityVendors.core.js";
+export {
+  buildOrganizationsListFacilityVendorsInfiniteQuery,
+  buildOrganizationsListFacilityVendorsQuery,
+  type OrganizationsListFacilityVendorsInfiniteQueryData,
+  type OrganizationsListFacilityVendorsPageParams,
+  type OrganizationsListFacilityVendorsQueryData,
+  prefetchOrganizationsListFacilityVendors,
+  prefetchOrganizationsListFacilityVendorsInfinite,
+  queryKeyOrganizationsListFacilityVendors,
+  queryKeyOrganizationsListFacilityVendorsInfinite,
+};
+
+export type OrganizationsListFacilityVendorsQueryError =
+  | errors.ApiErrorResponse
+  | GreenSecurityError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * List vendors targeting a facility
+ *
+ * @remarks
+ * Powers the Company Portal → Facility Details page. Returns the
+ * paginated list of company-scoped vendor reps that are targeting the
+ * given facility, with each row carrying the rep's name + email, their
+ * last visit to this facility, their facility access status, and any
+ * company custom fields the company has flagged `show_to_vendor` (which
+ * is where the "Employee ID" column on the UI lives).
+ *
+ * Filtering: pass `status=approved|pending|denied` to scope the rows to a
+ * single status tab. Pass `search=<term>` for a single search box that
+ * matches first name, last name, full name, email, OR any visible custom
+ * field value (covering the "search by name / email / Employee ID"
+ * requirement).
+ *
+ * Access control:
+ *   * Regular users: the URL's `:id` must be in the caller's read scope for
+ *     Facility (resolved via `has_facility_access_policy`). Out-of-scope or
+ *     soft-deleted facilities return `404 Facility not found`.
+ *   * API users: must pass `company_id`. Both the company and the facility
+ *     must be activated for the caller's marketplace app
+ *     (`MarketplaceAppActivation`).
+ */
+export function useOrganizationsListFacilityVendors(
+  request: operations.ListFacilityVendorsRequest,
+  options?: QueryHookOptions<
+    OrganizationsListFacilityVendorsQueryData,
+    OrganizationsListFacilityVendorsQueryError
+  >,
+): UseQueryResult<
+  OrganizationsListFacilityVendorsQueryData,
+  OrganizationsListFacilityVendorsQueryError
+> {
+  const client = useGreenSecurityContext();
+  return useQuery({
+    ...buildOrganizationsListFacilityVendorsQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * List vendors targeting a facility
+ *
+ * @remarks
+ * Powers the Company Portal → Facility Details page. Returns the
+ * paginated list of company-scoped vendor reps that are targeting the
+ * given facility, with each row carrying the rep's name + email, their
+ * last visit to this facility, their facility access status, and any
+ * company custom fields the company has flagged `show_to_vendor` (which
+ * is where the "Employee ID" column on the UI lives).
+ *
+ * Filtering: pass `status=approved|pending|denied` to scope the rows to a
+ * single status tab. Pass `search=<term>` for a single search box that
+ * matches first name, last name, full name, email, OR any visible custom
+ * field value (covering the "search by name / email / Employee ID"
+ * requirement).
+ *
+ * Access control:
+ *   * Regular users: the URL's `:id` must be in the caller's read scope for
+ *     Facility (resolved via `has_facility_access_policy`). Out-of-scope or
+ *     soft-deleted facilities return `404 Facility not found`.
+ *   * API users: must pass `company_id`. Both the company and the facility
+ *     must be activated for the caller's marketplace app
+ *     (`MarketplaceAppActivation`).
+ */
+export function useOrganizationsListFacilityVendorsSuspense(
+  request: operations.ListFacilityVendorsRequest,
+  options?: SuspenseQueryHookOptions<
+    OrganizationsListFacilityVendorsQueryData,
+    OrganizationsListFacilityVendorsQueryError
+  >,
+): UseSuspenseQueryResult<
+  OrganizationsListFacilityVendorsQueryData,
+  OrganizationsListFacilityVendorsQueryError
+> {
+  const client = useGreenSecurityContext();
+  return useSuspenseQuery({
+    ...buildOrganizationsListFacilityVendorsQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * List vendors targeting a facility
+ *
+ * @remarks
+ * Powers the Company Portal → Facility Details page. Returns the
+ * paginated list of company-scoped vendor reps that are targeting the
+ * given facility, with each row carrying the rep's name + email, their
+ * last visit to this facility, their facility access status, and any
+ * company custom fields the company has flagged `show_to_vendor` (which
+ * is where the "Employee ID" column on the UI lives).
+ *
+ * Filtering: pass `status=approved|pending|denied` to scope the rows to a
+ * single status tab. Pass `search=<term>` for a single search box that
+ * matches first name, last name, full name, email, OR any visible custom
+ * field value (covering the "search by name / email / Employee ID"
+ * requirement).
+ *
+ * Access control:
+ *   * Regular users: the URL's `:id` must be in the caller's read scope for
+ *     Facility (resolved via `has_facility_access_policy`). Out-of-scope or
+ *     soft-deleted facilities return `404 Facility not found`.
+ *   * API users: must pass `company_id`. Both the company and the facility
+ *     must be activated for the caller's marketplace app
+ *     (`MarketplaceAppActivation`).
+ */
+export function useOrganizationsListFacilityVendorsInfinite(
+  request: operations.ListFacilityVendorsRequest,
+  options?: InfiniteQueryHookOptions<
+    OrganizationsListFacilityVendorsInfiniteQueryData,
+    OrganizationsListFacilityVendorsQueryError
+  >,
+): UseInfiniteQueryResult<
+  InfiniteData<
+    OrganizationsListFacilityVendorsInfiniteQueryData,
+    OrganizationsListFacilityVendorsPageParams
+  >,
+  OrganizationsListFacilityVendorsQueryError
+> {
+  const client = useGreenSecurityContext();
+  return useInfiniteQuery<
+    OrganizationsListFacilityVendorsInfiniteQueryData,
+    OrganizationsListFacilityVendorsQueryError,
+    InfiniteData<
+      OrganizationsListFacilityVendorsInfiniteQueryData,
+      OrganizationsListFacilityVendorsPageParams
+    >,
+    QueryKey,
+    OrganizationsListFacilityVendorsPageParams
+  >({
+    ...buildOrganizationsListFacilityVendorsInfiniteQuery(
+      client,
+      request,
+      options,
+    ),
+    initialPageParam: options?.initialPageParam,
+    getNextPageParam: (previousPage) => previousPage["~next"],
+    ...options,
+  });
+}
+
+/**
+ * List vendors targeting a facility
+ *
+ * @remarks
+ * Powers the Company Portal → Facility Details page. Returns the
+ * paginated list of company-scoped vendor reps that are targeting the
+ * given facility, with each row carrying the rep's name + email, their
+ * last visit to this facility, their facility access status, and any
+ * company custom fields the company has flagged `show_to_vendor` (which
+ * is where the "Employee ID" column on the UI lives).
+ *
+ * Filtering: pass `status=approved|pending|denied` to scope the rows to a
+ * single status tab. Pass `search=<term>` for a single search box that
+ * matches first name, last name, full name, email, OR any visible custom
+ * field value (covering the "search by name / email / Employee ID"
+ * requirement).
+ *
+ * Access control:
+ *   * Regular users: the URL's `:id` must be in the caller's read scope for
+ *     Facility (resolved via `has_facility_access_policy`). Out-of-scope or
+ *     soft-deleted facilities return `404 Facility not found`.
+ *   * API users: must pass `company_id`. Both the company and the facility
+ *     must be activated for the caller's marketplace app
+ *     (`MarketplaceAppActivation`).
+ */
+export function useOrganizationsListFacilityVendorsInfiniteSuspense(
+  request: operations.ListFacilityVendorsRequest,
+  options?: SuspenseInfiniteQueryHookOptions<
+    OrganizationsListFacilityVendorsInfiniteQueryData,
+    OrganizationsListFacilityVendorsQueryError
+  >,
+): UseSuspenseInfiniteQueryResult<
+  InfiniteData<
+    OrganizationsListFacilityVendorsInfiniteQueryData,
+    OrganizationsListFacilityVendorsPageParams
+  >,
+  OrganizationsListFacilityVendorsQueryError
+> {
+  const client = useGreenSecurityContext();
+  return useSuspenseInfiniteQuery<
+    OrganizationsListFacilityVendorsInfiniteQueryData,
+    OrganizationsListFacilityVendorsQueryError,
+    InfiniteData<
+      OrganizationsListFacilityVendorsInfiniteQueryData,
+      OrganizationsListFacilityVendorsPageParams
+    >,
+    QueryKey,
+    OrganizationsListFacilityVendorsPageParams
+  >({
+    ...buildOrganizationsListFacilityVendorsInfiniteQuery(
+      client,
+      request,
+      options,
+    ),
+    initialPageParam: options?.initialPageParam,
+    getNextPageParam: (previousPage) => previousPage["~next"],
+    ...options,
+  });
+}
+
+export function setOrganizationsListFacilityVendorsData(
+  client: QueryClient,
+  queryKeyBase: [
+    id: number,
+    parameters: {
+      companyId?: number | undefined;
+      status?: operations.ListFacilityVendorsQueryParamStatus | undefined;
+      search?: string | undefined;
+      page?: number | undefined;
+      itemsPerPage?: number | undefined;
+      sort?: operations.ListFacilityVendorsQueryParamSort | undefined;
+      desc?: components.Desc | undefined;
+    },
+  ],
+  data: OrganizationsListFacilityVendorsQueryData,
+): OrganizationsListFacilityVendorsQueryData | undefined {
+  const key = queryKeyOrganizationsListFacilityVendors(...queryKeyBase);
+
+  return client.setQueryData<OrganizationsListFacilityVendorsQueryData>(
+    key,
+    data,
+  );
+}
+
+export function invalidateOrganizationsListFacilityVendors(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<
+    [
+      id: number,
+      parameters: {
+        companyId?: number | undefined;
+        status?: operations.ListFacilityVendorsQueryParamStatus | undefined;
+        search?: string | undefined;
+        page?: number | undefined;
+        itemsPerPage?: number | undefined;
+        sort?: operations.ListFacilityVendorsQueryParamSort | undefined;
+        desc?: components.Desc | undefined;
+      },
+    ]
+  >,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: [
+      "@greensecurity/javascript-sdk",
+      "organizations",
+      "listFacilityVendors",
+      ...queryKeyBase,
+    ],
+  });
+}
+
+export function invalidateAllOrganizationsListFacilityVendors(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: [
+      "@greensecurity/javascript-sdk",
+      "organizations",
+      "listFacilityVendors",
+    ],
+  });
+}

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

@@ -87,6 +87,7 @@ export function buildOrganizationsListOrSearchFacilitiesQuery(
       status: request.status,
       latitude: request.latitude,
       longitude: request.longitude,
+      targeted: request.targeted,
     }),
     queryFn: async function organizationsListOrSearchFacilitiesQueryFn(
       ctx,
@@ -137,6 +138,7 @@ export function buildOrganizationsListOrSearchFacilitiesInfiniteQuery(
       status: request.status,
       latitude: request.latitude,
       longitude: request.longitude,
+      targeted: request.targeted,
     }),
     queryFn: async function organizationsListOrSearchFacilitiesQuery(
       ctx,
@@ -185,6 +187,7 @@ export function queryKeyOrganizationsListOrSearchFacilities(
     status?: components.ActiveStatus | undefined;
     latitude?: number | undefined;
     longitude?: number | undefined;
+    targeted?: operations.Targeted | undefined;
   },
 ): QueryKey {
   return [
@@ -208,6 +211,7 @@ export function queryKeyOrganizationsListOrSearchFacilitiesInfinite(
     status?: components.ActiveStatus | undefined;
     latitude?: number | undefined;
     longitude?: number | undefined;
+    targeted?: operations.Targeted | undefined;
   },
 ): QueryKey {
   return [

package/src/react-query/organizationsListOrSearchFacilities.ts

@@ -274,6 +274,7 @@ export function setOrganizationsListOrSearchFacilitiesData(
       status?: components.ActiveStatus | undefined;
       latitude?: number | undefined;
       longitude?: number | undefined;
+      targeted?: operations.Targeted | undefined;
     },
   ],
   data: OrganizationsListOrSearchFacilitiesQueryData,
@@ -301,6 +302,7 @@ export function invalidateOrganizationsListOrSearchFacilities(
       status?: components.ActiveStatus | undefined;
       latitude?: number | undefined;
       longitude?: number | undefined;
+      targeted?: operations.Targeted | undefined;
     }]
   >,
   filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,

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

@@ -0,0 +1,86 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  QueryClient,
+  QueryFunctionContext,
+  QueryKey,
+} from "@tanstack/react-query";
+import { GreenSecurityCore } from "../core.js";
+import {
+  DownloadVendorScansExportAcceptEnum,
+  vendorScansDownloadVendorScansExport,
+} from "../funcs/vendorScansDownloadVendorScansExport.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";
+export type VendorScansDownloadVendorScansExportQueryData =
+  | operations.DownloadVendorScansExportResponse
+  | undefined;
+
+export function prefetchVendorScansDownloadVendorScansExport(
+  queryClient: QueryClient,
+  client$: GreenSecurityCore,
+  request: operations.DownloadVendorScansExportRequest,
+  options?: RequestOptions & {
+    acceptHeaderOverride?: DownloadVendorScansExportAcceptEnum;
+  },
+): Promise<void> {
+  return queryClient.prefetchQuery({
+    ...buildVendorScansDownloadVendorScansExportQuery(
+      client$,
+      request,
+      options,
+    ),
+  });
+}
+
+export function buildVendorScansDownloadVendorScansExportQuery(
+  client$: GreenSecurityCore,
+  request: operations.DownloadVendorScansExportRequest,
+  options?: RequestOptions & {
+    acceptHeaderOverride?: DownloadVendorScansExportAcceptEnum;
+  },
+): {
+  queryKey: QueryKey;
+  queryFn: (
+    context: QueryFunctionContext,
+  ) => Promise<VendorScansDownloadVendorScansExportQueryData>;
+} {
+  return {
+    queryKey: queryKeyVendorScansDownloadVendorScansExport(request.id),
+    queryFn: async function vendorScansDownloadVendorScansExportQueryFn(
+      ctx,
+    ): Promise<VendorScansDownloadVendorScansExportQueryData> {
+      const sig = combineSignals(
+        ctx.signal,
+        options?.signal,
+        options?.fetchOptions?.signal,
+      );
+      const mergedOptions = {
+        ...options?.fetchOptions,
+        ...options,
+        signal: sig,
+      };
+
+      return unwrapAsync(vendorScansDownloadVendorScansExport(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}
+
+export function queryKeyVendorScansDownloadVendorScansExport(
+  id: string,
+): QueryKey {
+  return [
+    "@greensecurity/javascript-sdk",
+    "vendor_scans",
+    "downloadVendorScansExport",
+    id,
+  ];
+}

package/src/react-query/vendorScansDownloadVendorScansExport.ts

@@ -0,0 +1,154 @@
+/*
+ * 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 {
+  buildVendorScansDownloadVendorScansExportQuery,
+  prefetchVendorScansDownloadVendorScansExport,
+  queryKeyVendorScansDownloadVendorScansExport,
+  VendorScansDownloadVendorScansExportQueryData,
+} from "./vendorScansDownloadVendorScansExport.core.js";
+export {
+  buildVendorScansDownloadVendorScansExportQuery,
+  prefetchVendorScansDownloadVendorScansExport,
+  queryKeyVendorScansDownloadVendorScansExport,
+  type VendorScansDownloadVendorScansExportQueryData,
+};
+
+export type VendorScansDownloadVendorScansExportQueryError =
+  | errors.ApiErrorResponse
+  | GreenSecurityError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+export { DownloadVendorScansExportAcceptEnum } from "../funcs/vendorScansDownloadVendorScansExport.js";
+
+/**
+ * Download vendor scans CSV
+ *
+ * @remarks
+ * Returns the exported vendor scans CSV via a 302 redirect to a short-lived presigned S3 URL.
+ * If the export is still being generated, returns 202 with a JSON `{ ready: false }` payload.
+ */
+export function useVendorScansDownloadVendorScansExport(
+  request: operations.DownloadVendorScansExportRequest,
+  options?: QueryHookOptions<
+    VendorScansDownloadVendorScansExportQueryData,
+    VendorScansDownloadVendorScansExportQueryError
+  >,
+): UseQueryResult<
+  VendorScansDownloadVendorScansExportQueryData,
+  VendorScansDownloadVendorScansExportQueryError
+> {
+  const client = useGreenSecurityContext();
+  return useQuery({
+    ...buildVendorScansDownloadVendorScansExportQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * Download vendor scans CSV
+ *
+ * @remarks
+ * Returns the exported vendor scans CSV via a 302 redirect to a short-lived presigned S3 URL.
+ * If the export is still being generated, returns 202 with a JSON `{ ready: false }` payload.
+ */
+export function useVendorScansDownloadVendorScansExportSuspense(
+  request: operations.DownloadVendorScansExportRequest,
+  options?: SuspenseQueryHookOptions<
+    VendorScansDownloadVendorScansExportQueryData,
+    VendorScansDownloadVendorScansExportQueryError
+  >,
+): UseSuspenseQueryResult<
+  VendorScansDownloadVendorScansExportQueryData,
+  VendorScansDownloadVendorScansExportQueryError
+> {
+  const client = useGreenSecurityContext();
+  return useSuspenseQuery({
+    ...buildVendorScansDownloadVendorScansExportQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+export function setVendorScansDownloadVendorScansExportData(
+  client: QueryClient,
+  queryKeyBase: [id: string],
+  data: VendorScansDownloadVendorScansExportQueryData,
+): VendorScansDownloadVendorScansExportQueryData | undefined {
+  const key = queryKeyVendorScansDownloadVendorScansExport(...queryKeyBase);
+
+  return client.setQueryData<VendorScansDownloadVendorScansExportQueryData>(
+    key,
+    data,
+  );
+}
+
+export function invalidateVendorScansDownloadVendorScansExport(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<[id: string]>,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: [
+      "@greensecurity/javascript-sdk",
+      "vendor_scans",
+      "downloadVendorScansExport",
+      ...queryKeyBase,
+    ],
+  });
+}
+
+export function invalidateAllVendorScansDownloadVendorScansExport(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: [
+      "@greensecurity/javascript-sdk",
+      "vendor_scans",
+      "downloadVendorScansExport",
+    ],
+  });
+}