@greensecurity/javascript-sdk 0.45.0-beta.9 → 0.45.0

package/src/react-query/lookupsLookupPostalCode.ts

@@ -0,0 +1,177 @@
+/*
+ * 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 {
+  buildLookupsLookupPostalCodeQuery,
+  LookupsLookupPostalCodeQueryData,
+  prefetchLookupsLookupPostalCode,
+  queryKeyLookupsLookupPostalCode,
+} from "./lookupsLookupPostalCode.core.js";
+export {
+  buildLookupsLookupPostalCodeQuery,
+  type LookupsLookupPostalCodeQueryData,
+  prefetchLookupsLookupPostalCode,
+  queryKeyLookupsLookupPostalCode,
+};
+
+export type LookupsLookupPostalCodeQueryError =
+  | errors.ApiErrorResponse
+  | GreenSecurityError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Check a postal code against a state and country
+ *
+ * @remarks
+ * Cross-checks a postal code against a state/province and country, the same check
+ * every write path that stores a US or Canadian address enforces server-side (e.g.
+ * `PUT /users/{id}`, `PUT /vendors/{vendor_id_or_me}`). Useful for validating an
+ * address before submitting it elsewhere.
+ *
+ * `status` is one of:
+ * - `ok` — the postal code belongs to the given state/province.
+ * - `invalid` — the postal code is not shaped like a real one for the given country.
+ * - `mismatch` — the postal code is well-formed but belongs to a different state or
+ *   province. `expected_states` names the state(s) it actually maps to.
+ * - `unknown` — nothing to check against (an unsupported country, or a postal code
+ *   absent from the US ZIP dataset). Treated as acceptable by every write path that
+ *   uses this check.
+ *
+ * Only the US and Canada have a real code-to-subdivision map; every other country
+ * always returns `unknown`.
+ */
+export function useLookupsLookupPostalCode(
+  request: operations.LookupPostalCodeRequest,
+  options?: QueryHookOptions<
+    LookupsLookupPostalCodeQueryData,
+    LookupsLookupPostalCodeQueryError
+  >,
+): UseQueryResult<
+  LookupsLookupPostalCodeQueryData,
+  LookupsLookupPostalCodeQueryError
+> {
+  const client = useGreenSecurityContext();
+  return useQuery({
+    ...buildLookupsLookupPostalCodeQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * Check a postal code against a state and country
+ *
+ * @remarks
+ * Cross-checks a postal code against a state/province and country, the same check
+ * every write path that stores a US or Canadian address enforces server-side (e.g.
+ * `PUT /users/{id}`, `PUT /vendors/{vendor_id_or_me}`). Useful for validating an
+ * address before submitting it elsewhere.
+ *
+ * `status` is one of:
+ * - `ok` — the postal code belongs to the given state/province.
+ * - `invalid` — the postal code is not shaped like a real one for the given country.
+ * - `mismatch` — the postal code is well-formed but belongs to a different state or
+ *   province. `expected_states` names the state(s) it actually maps to.
+ * - `unknown` — nothing to check against (an unsupported country, or a postal code
+ *   absent from the US ZIP dataset). Treated as acceptable by every write path that
+ *   uses this check.
+ *
+ * Only the US and Canada have a real code-to-subdivision map; every other country
+ * always returns `unknown`.
+ */
+export function useLookupsLookupPostalCodeSuspense(
+  request: operations.LookupPostalCodeRequest,
+  options?: SuspenseQueryHookOptions<
+    LookupsLookupPostalCodeQueryData,
+    LookupsLookupPostalCodeQueryError
+  >,
+): UseSuspenseQueryResult<
+  LookupsLookupPostalCodeQueryData,
+  LookupsLookupPostalCodeQueryError
+> {
+  const client = useGreenSecurityContext();
+  return useSuspenseQuery({
+    ...buildLookupsLookupPostalCodeQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+export function setLookupsLookupPostalCodeData(
+  client: QueryClient,
+  queryKeyBase: [
+    parameters: { postalCode: string; state: string; country: string },
+  ],
+  data: LookupsLookupPostalCodeQueryData,
+): LookupsLookupPostalCodeQueryData | undefined {
+  const key = queryKeyLookupsLookupPostalCode(...queryKeyBase);
+
+  return client.setQueryData<LookupsLookupPostalCodeQueryData>(key, data);
+}
+
+export function invalidateLookupsLookupPostalCode(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<
+    [parameters: { postalCode: string; state: string; country: string }]
+  >,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: [
+      "@greensecurity/javascript-sdk",
+      "lookups",
+      "lookupPostalCode",
+      ...queryKeyBase,
+    ],
+  });
+}
+
+export function invalidateAllLookupsLookupPostalCode(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: ["@greensecurity/javascript-sdk", "lookups", "lookupPostalCode"],
+  });
+}

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

@@ -53,6 +53,7 @@ export function buildOrganizationsExportCompanyTargetFacilitiesQuery(
         stateLike: request.stateLike,
         addressLike: request.addressLike,
         systemNameLike: request.systemNameLike,
+        systemIds: request.systemIds,
         searchLike: request.searchLike,
         sort: request.sort,
         desc: request.desc,
@@ -93,6 +94,7 @@ export function queryKeyOrganizationsExportCompanyTargetFacilities(
     stateLike?: string | undefined;
     addressLike?: string | undefined;
     systemNameLike?: string | undefined;
+    systemIds?: Array<number> | undefined;
     searchLike?: string | undefined;
     sort?: operations.ExportCompanyTargetFacilitiesQueryParamSort | undefined;
     desc?: operations.Desc | undefined;

package/src/react-query/organizationsExportCompanyTargetFacilities.ts

@@ -135,6 +135,7 @@ export function setOrganizationsExportCompanyTargetFacilitiesData(
       stateLike?: string | undefined;
       addressLike?: string | undefined;
       systemNameLike?: string | undefined;
+      systemIds?: Array<number> | undefined;
       searchLike?: string | undefined;
       sort?: operations.ExportCompanyTargetFacilitiesQueryParamSort | undefined;
       desc?: operations.Desc | undefined;
@@ -168,6 +169,7 @@ export function invalidateOrganizationsExportCompanyTargetFacilities(
         stateLike?: string | undefined;
         addressLike?: string | undefined;
         systemNameLike?: string | undefined;
+        systemIds?: Array<number> | undefined;
         searchLike?: string | undefined;
         sort?:
           | operations.ExportCompanyTargetFacilitiesQueryParamSort

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

@@ -89,6 +89,7 @@ export function buildOrganizationsListCompanyTargetFacilitiesQuery(
         stateLike: request.stateLike,
         addressLike: request.addressLike,
         systemNameLike: request.systemNameLike,
+        systemIds: request.systemIds,
         searchLike: request.searchLike,
         sort: request.sort,
         desc: request.desc,
@@ -146,6 +147,7 @@ export function buildOrganizationsListCompanyTargetFacilitiesInfiniteQuery(
         stateLike: request.stateLike,
         addressLike: request.addressLike,
         systemNameLike: request.systemNameLike,
+        systemIds: request.systemIds,
         searchLike: request.searchLike,
         sort: request.sort,
         desc: request.desc,
@@ -200,6 +202,7 @@ export function queryKeyOrganizationsListCompanyTargetFacilities(
     stateLike?: string | undefined;
     addressLike?: string | undefined;
     systemNameLike?: string | undefined;
+    systemIds?: Array<number> | undefined;
     searchLike?: string | undefined;
     sort?: operations.QueryParamSort | undefined;
     desc?: components.Desc | undefined;
@@ -229,6 +232,7 @@ export function queryKeyOrganizationsListCompanyTargetFacilitiesInfinite(
     stateLike?: string | undefined;
     addressLike?: string | undefined;
     systemNameLike?: string | undefined;
+    systemIds?: Array<number> | undefined;
     searchLike?: string | undefined;
     sort?: operations.QueryParamSort | undefined;
     desc?: components.Desc | undefined;

package/src/react-query/organizationsListCompanyTargetFacilities.ts

@@ -300,6 +300,7 @@ export function setOrganizationsListCompanyTargetFacilitiesData(
       stateLike?: string | undefined;
       addressLike?: string | undefined;
       systemNameLike?: string | undefined;
+      systemIds?: Array<number> | undefined;
       searchLike?: string | undefined;
       sort?: operations.QueryParamSort | undefined;
       desc?: components.Desc | undefined;
@@ -337,6 +338,7 @@ export function invalidateOrganizationsListCompanyTargetFacilities(
         stateLike?: string | undefined;
         addressLike?: string | undefined;
         systemNameLike?: string | undefined;
+        systemIds?: Array<number> | undefined;
         searchLike?: string | undefined;
         sort?: operations.QueryParamSort | undefined;
         desc?: components.Desc | undefined;

package/src/react-query/reportsGetFullReport.ts

@@ -72,9 +72,9 @@ export type ReportsGetFullReportQueryError =
  * | `404` | No such run, or it is outside your access scope. | Stop. |
  * | `403` | Your account is locked, or lacks the `scheduled_reports` view permission. | Stop. |
  *
- * **Bound your polling.** A `409` is not a promise that the run will finish. Report
- * generation has no terminal failure state today, so a run whose generation crashed part way
- * through stays in `processing` and keeps answering `409` indefinitely. Apply your own
+ * **Bound your polling.** A `409` is not a promise that the run will finish. A run that fails
+ * while generating is now recorded as `failed` and answers `422`, but a run whose worker died
+ * outright still stays in `processing` and keeps answering `409` indefinitely. Apply your own
  * timeout or maximum attempt count and treat exhaustion as a failure; do not retry forever.
  *
  * Access control: the URL's `full_report_id` must be in the caller's read scope for
@@ -122,9 +122,9 @@ export function useReportsGetFullReport(
  * | `404` | No such run, or it is outside your access scope. | Stop. |
  * | `403` | Your account is locked, or lacks the `scheduled_reports` view permission. | Stop. |
  *
- * **Bound your polling.** A `409` is not a promise that the run will finish. Report
- * generation has no terminal failure state today, so a run whose generation crashed part way
- * through stays in `processing` and keeps answering `409` indefinitely. Apply your own
+ * **Bound your polling.** A `409` is not a promise that the run will finish. A run that fails
+ * while generating is now recorded as `failed` and answers `422`, but a run whose worker died
+ * outright still stays in `processing` and keeps answering `409` indefinitely. Apply your own
  * timeout or maximum attempt count and treat exhaustion as a failure; do not retry forever.
  *
  * Access control: the URL's `full_report_id` must be in the caller's read scope for

package/src/react-query/usersPostAuthenticate.ts

@@ -81,6 +81,43 @@ export type UsersPostAuthenticateMutationError =
  * 3. Site redirects to your selected `return_url`
  * 4. The `user_token` will be appended as a query string parameter to your `return_url` - you must parse this token and store it
  * 5. Fetch the user object from `/users/me` using the token
+ *
+ * ## Finishing a "Login with Green Security" flow
+ *
+ * Green Security is also a SAML2 **identity provider**. When a third-party service provider sends a user to
+ * `/saml/idp/sso` to sign in with their Green Security account, the user lands on a Green Security login screen
+ * carrying an `sso_state` query string parameter. That parameter is a signed, five-minute record of which service
+ * provider is waiting, where its assertion consumer service lives, and what `RelayState` it sent.
+ *
+ * Authentication itself is unchanged - the user may still need a password, an MFA code, a magic link or a round trip
+ * to their own SAML IdP, and every `requires` value above applies as normal. The only difference is that you must
+ * echo `sso_state` back on **every** call in the sequence, unchanged, including the follow-up that carries the
+ * `mfa_code`.
+ *
+ * Each `202` response carries the verified blob back to you in its own top-level `sso_state` field. Send back the
+ * value from the response you just received rather than the one you started with. The two are normally the same
+ * string, but re-sending your original copy is how a blob the server has already rejected gets resent, and it forces
+ * you to hold login state you would otherwise not need.
+ *
+ * 1. Read `sso_state` from the query string of the login screen you were sent to
+ * 2. Run the login exactly as you would otherwise, adding `sso_state` to each request body and taking the value for
+ *    the next request from the previous `202` response
+ * 3. On the `200` response, read `sso.continue_url`
+ * 4. Navigate the browser to `sso.continue_url` - a full page navigation, not a background fetch. It answers with a
+ *    self-submitting form that delivers the signed `SAMLResponse` and the original `RelayState` to the service
+ *    provider
+ * 5. The service provider validates the assertion and the user is signed in on their side
+ *
+ * On the `password_reset` leg the blob is **also** appended to `redirect_url` as a query parameter, alongside
+ * `return_url`. The browser follows that redirect and leaves the JSON body behind, so anything the remaining legs of
+ * the login still need has to ride the URL. Preserve the query string exactly as given.
+ *
+ * An invalid `sso_state` never fails a login. A forged, edited or expired blob is silently dropped and the request is
+ * then treated as an ordinary login, so valid credentials still return `200` - just with no `sso` object. Check for
+ * `sso` explicitly rather than reading `200` as proof the hand-off survived. When it is absent, do not retry with the
+ * same blob; the user has to start again from the service provider. See the
+ * [Login with Green Security](https://greensecurity.apidocumentation.com/guides/sso-login-with-green-security)
+ * guide for the service provider half of this flow.
  */
 export function useUsersPostAuthenticateMutation(
   options?: MutationHookOptions<

package/src/react-query/usersUpdateUser.ts

@@ -56,6 +56,12 @@ export type UsersUpdateUserMutationError =
  * Only submitted fields are applied — unrecognised fields are silently ignored.
  * Changing `email` automatically resets `bounced_email` to `false`.
  *
+ * Submitting `zip`, `state`, or `country` cross-checks the postal code against the
+ * resulting state/country (using the existing value for any of the three left out
+ * of the request). A code that is not shaped like a real postal code, or that
+ * provably belongs to a different state, is rejected with `422` naming the correct
+ * state.
+ *
  * Each subkey of `email_preferences` is independently optional; sending
  * `{ "email_preferences": { "send_weekly_summary_email": true } }` flips
  * only that flag and leaves the others unchanged.

package/src/react-query/vendorsCreateVendor.ts

@@ -55,6 +55,10 @@ export type VendorsCreateVendorMutationError =
  * `company_id` is optional for company managers — it defaults to their own company.
  * All other callers must provide `company_id`. The caller must have access to the
  * specified company (verified via scoped access policy) and the `vendors:add` permission.
+ *
+ * `zip` is cross-checked against `state`: a code that is not shaped like a real postal
+ * code, or that provably belongs to a different state, is rejected with `422` naming
+ * the correct state.
  */
 export function useVendorsCreateVendorMutation(
   options?: MutationHookOptions<

package/src/react-query/vendorsGetVendorInvoiceDetails.ts

@@ -64,6 +64,7 @@ export type VendorsGetVendorInvoiceDetailsQueryError =
  * invoice.line_items
  * invoice.invoice_transactions
  * invoice.may_pay_invoice
+ * invoice.associated_credentials
  * invoice_transactions.payee
  */
 export function useVendorsGetVendorInvoiceDetails(
@@ -98,6 +99,7 @@ export function useVendorsGetVendorInvoiceDetails(
  * invoice.line_items
  * invoice.invoice_transactions
  * invoice.may_pay_invoice
+ * invoice.associated_credentials
  * invoice_transactions.payee
  */
 export function useVendorsGetVendorInvoiceDetailsSuspense(

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

@@ -0,0 +1,82 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  QueryClient,
+  QueryFunctionContext,
+  QueryKey,
+} from "@tanstack/react-query";
+import { GreenSecurityCore } from "../core.js";
+import { vendorsGetVendorScreeningQuestions } from "../funcs/vendorsGetVendorScreeningQuestions.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 VendorsGetVendorScreeningQuestionsQueryData =
+  operations.GetVendorScreeningQuestionsGetVendorScreeningQuestionsOk;
+
+export function prefetchVendorsGetVendorScreeningQuestions(
+  queryClient: QueryClient,
+  client$: GreenSecurityCore,
+  request: operations.GetVendorScreeningQuestionsRequest,
+  options?: RequestOptions,
+): Promise<void> {
+  return queryClient.prefetchQuery({
+    ...buildVendorsGetVendorScreeningQuestionsQuery(
+      client$,
+      request,
+      options,
+    ),
+  });
+}
+
+export function buildVendorsGetVendorScreeningQuestionsQuery(
+  client$: GreenSecurityCore,
+  request: operations.GetVendorScreeningQuestionsRequest,
+  options?: RequestOptions,
+): {
+  queryKey: QueryKey;
+  queryFn: (
+    context: QueryFunctionContext,
+  ) => Promise<VendorsGetVendorScreeningQuestionsQueryData>;
+} {
+  return {
+    queryKey: queryKeyVendorsGetVendorScreeningQuestions(request.vendorIdOrMe, {
+      facilityId: request.facilityId,
+    }),
+    queryFn: async function vendorsGetVendorScreeningQuestionsQueryFn(
+      ctx,
+    ): Promise<VendorsGetVendorScreeningQuestionsQueryData> {
+      const sig = combineSignals(
+        ctx.signal,
+        options?.signal,
+        options?.fetchOptions?.signal,
+      );
+      const mergedOptions = {
+        ...options?.fetchOptions,
+        ...options,
+        signal: sig,
+      };
+
+      return unwrapAsync(vendorsGetVendorScreeningQuestions(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}
+
+export function queryKeyVendorsGetVendorScreeningQuestions(
+  vendorIdOrMe: string,
+  parameters: { facilityId: number },
+): QueryKey {
+  return [
+    "@greensecurity/javascript-sdk",
+    "vendors",
+    "getVendorScreeningQuestions",
+    vendorIdOrMe,
+    parameters,
+  ];
+}

package/src/react-query/vendorsGetVendorScreeningQuestions.ts

@@ -0,0 +1,152 @@
+/*
+ * 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 {
+  buildVendorsGetVendorScreeningQuestionsQuery,
+  prefetchVendorsGetVendorScreeningQuestions,
+  queryKeyVendorsGetVendorScreeningQuestions,
+  VendorsGetVendorScreeningQuestionsQueryData,
+} from "./vendorsGetVendorScreeningQuestions.core.js";
+export {
+  buildVendorsGetVendorScreeningQuestionsQuery,
+  prefetchVendorsGetVendorScreeningQuestions,
+  queryKeyVendorsGetVendorScreeningQuestions,
+  type VendorsGetVendorScreeningQuestionsQueryData,
+};
+
+export type VendorsGetVendorScreeningQuestionsQueryError =
+  | errors.ApiErrorResponse
+  | GreenSecurityError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * List a vendor's target-facility screening questions and answers
+ *
+ * @remarks
+ * Returns every active target-facility screening question that currently applies to the vendor at the given facility, each paired with the vendor's answer when one has been given. Questions that have not been answered are included with a null answer. Read-only; used to review a rep's screening answers.
+ */
+export function useVendorsGetVendorScreeningQuestions(
+  request: operations.GetVendorScreeningQuestionsRequest,
+  options?: QueryHookOptions<
+    VendorsGetVendorScreeningQuestionsQueryData,
+    VendorsGetVendorScreeningQuestionsQueryError
+  >,
+): UseQueryResult<
+  VendorsGetVendorScreeningQuestionsQueryData,
+  VendorsGetVendorScreeningQuestionsQueryError
+> {
+  const client = useGreenSecurityContext();
+  return useQuery({
+    ...buildVendorsGetVendorScreeningQuestionsQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+/**
+ * List a vendor's target-facility screening questions and answers
+ *
+ * @remarks
+ * Returns every active target-facility screening question that currently applies to the vendor at the given facility, each paired with the vendor's answer when one has been given. Questions that have not been answered are included with a null answer. Read-only; used to review a rep's screening answers.
+ */
+export function useVendorsGetVendorScreeningQuestionsSuspense(
+  request: operations.GetVendorScreeningQuestionsRequest,
+  options?: SuspenseQueryHookOptions<
+    VendorsGetVendorScreeningQuestionsQueryData,
+    VendorsGetVendorScreeningQuestionsQueryError
+  >,
+): UseSuspenseQueryResult<
+  VendorsGetVendorScreeningQuestionsQueryData,
+  VendorsGetVendorScreeningQuestionsQueryError
+> {
+  const client = useGreenSecurityContext();
+  return useSuspenseQuery({
+    ...buildVendorsGetVendorScreeningQuestionsQuery(
+      client,
+      request,
+      options,
+    ),
+    ...options,
+  });
+}
+
+export function setVendorsGetVendorScreeningQuestionsData(
+  client: QueryClient,
+  queryKeyBase: [vendorIdOrMe: string, parameters: { facilityId: number }],
+  data: VendorsGetVendorScreeningQuestionsQueryData,
+): VendorsGetVendorScreeningQuestionsQueryData | undefined {
+  const key = queryKeyVendorsGetVendorScreeningQuestions(...queryKeyBase);
+
+  return client.setQueryData<VendorsGetVendorScreeningQuestionsQueryData>(
+    key,
+    data,
+  );
+}
+
+export function invalidateVendorsGetVendorScreeningQuestions(
+  client: QueryClient,
+  queryKeyBase: TupleToPrefixes<
+    [vendorIdOrMe: string, parameters: { facilityId: number }]
+  >,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: [
+      "@greensecurity/javascript-sdk",
+      "vendors",
+      "getVendorScreeningQuestions",
+      ...queryKeyBase,
+    ],
+  });
+}
+
+export function invalidateAllVendorsGetVendorScreeningQuestions(
+  client: QueryClient,
+  filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,
+): Promise<void> {
+  return client.invalidateQueries({
+    ...filters,
+    queryKey: [
+      "@greensecurity/javascript-sdk",
+      "vendors",
+      "getVendorScreeningQuestions",
+    ],
+  });
+}

package/src/react-query/vendorsUpdateVendorDetails.ts

@@ -56,7 +56,15 @@ export type VendorsUpdateVendorDetailsMutationError =
  * From `location` this endpoint reads only `timezone`, `address1`, `address2`,
  * `city`, `state`, `zip`, `phone`, `mobile_phone` and `fax`. The `address` and
  * `country` properties of the shared `UserLocation` schema are ignored here and
- * updating them is not supported.
+ * updating them is not supported. `state` accepts a US state or a Canadian
+ * province — the vendor's country, set only at registration, is not editable
+ * through this endpoint.
+ *
+ * Submitting `location.zip` or `location.state` cross-checks the postal code
+ * against the resulting state (using the vendor's existing value for whichever
+ * of the two is left out of the request). A code that is not shaped like a real
+ * postal code, or that provably belongs to a different state, is rejected with
+ * `422` naming the correct state.
  *
  * For `title`, the `supervisor` fields, and every `location` field except
  * `timezone`, the value sent is the value stored: omit a field to leave it

package/src/sdk/companies.ts

@@ -6,6 +6,7 @@ import { companiesAddCompanyManager } from "../funcs/companiesAddCompanyManager.
 import { companiesGetCompany } from "../funcs/companiesGetCompany.js";
 import { companiesListCompanyCredentials } from "../funcs/companiesListCompanyCredentials.js";
 import { companiesListCompanyCredits } from "../funcs/companiesListCompanyCredits.js";
+import { companiesListCompanyManagerContacts } from "../funcs/companiesListCompanyManagerContacts.js";
 import { companiesListCompanyManagers } from "../funcs/companiesListCompanyManagers.js";
 import { companiesListOrSearchCompanies } from "../funcs/companiesListOrSearchCompanies.js";
 import { companiesLookupCompanies } from "../funcs/companiesLookupCompanies.js";
@@ -152,4 +153,25 @@ export class Companies extends ClientSDK {
       options,
     ));
   }
+
+  /**
+   * List the contact details of a company's managers
+   *
+   * @remarks
+   * Deprecated in favor of `/lookups/company_managers`, which returns the same list. Kept so app builds released before the move keep working.
+   *
+   * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
+   */
+  async listCompanyManagerContacts(
+    request: operations.ListCompanyManagerContactsRequest,
+    options?: RequestOptions,
+  ): Promise<
+    operations.ListCompanyManagerContactsListCompanyManagerContactsOk
+  > {
+    return unwrapAsync(companiesListCompanyManagerContacts(
+      this,
+      request,
+      options,
+    ));
+  }
 }