@greensecurity/javascript-sdk 0.47.0-beta.1 → 0.47.0-beta.11

package/src/admin-funcs/vendorCredentialGetFormLineItems.ts

@@ -1,12 +1,17 @@
 import { APIPromise } from "../types/async.js";
+import { RequestOptions } from "../lib/sdks.js";
 import { $doPost, internalApiResult } from "./doAdmin.js";
 
 export function vendorCredentialGetFormLineItems(
   vendorCredentialId: number,
   jsonData: string,
+  /** Carries the caller's AbortSignal: the form re-prices as it is filled in, so a
+   *  superseded request has to be droppable in flight. */
+  options?: RequestOptions,
 ): internalApiResult {
   return new APIPromise($doPost(
     `/vendors/credentials/${vendorCredentialId}/line-items`,
     { json_data: jsonData },
+    options,
   ));
 }

package/src/admin-funcs/zoneDevicesDelete.ts

@@ -0,0 +1,8 @@
+import { APIPromise } from "../types/async.js";
+import { $doDelete, internalApiResult } from "./doAdmin.js";
+
+// Removes a gateway from the Gatekeeper device details screen and revokes its AWS IoT thing.
+// Internal for the same reason as zoneDevicesCreate. 404 covers a gateway outside the caller's scope.
+export function zoneDevicesDelete(zoneDeviceId: number): internalApiResult {
+  return new APIPromise($doDelete(`/zone-devices/${zoneDeviceId}`));
+}

package/src/admin-funcs/zoneDevicesList.ts

@@ -6,6 +6,7 @@ export type zoneDevicesListSortField = "id" | "name";
 export type zoneDevicesListRequest = {
   facilityId?: number;
   zoneId?: number;
+  networkId?: number;
   page?: number;
   itemsPerPage?: number;
   sort?: zoneDevicesListSortField;
@@ -36,6 +37,9 @@ export function zoneDevicesList(
   if (request.zoneId !== undefined) {
     query["zone_id"] = request.zoneId;
   }
+  if (request.networkId !== undefined) {
+    query["network_id"] = request.networkId;
+  }
   if (request.page !== undefined) {
     query["page"] = request.page;
   }

package/src/admin-funcs/zoneDevicesProvisioning.ts

@@ -0,0 +1,12 @@
+import { APIPromise } from "../types/async.js";
+import { $doPost, internalApiResult } from "./doAdmin.js";
+
+// Everything the Gatekeeper app writes to a gateway when it provisions it over the gateway's own
+// Wi-Fi: the admin password, the AWS IoT certificate and broker, and the settings and
+// secrets of the network it joins. The first call mints the password and certificate, hence POST.
+//
+// Internal for the same reason as zoneDevicesCreate. The response carries secrets: callers keep it
+// in memory for the provisioning run and never persist or log it.
+export function zoneDevicesProvisioning(zoneDeviceId: number): internalApiResult {
+  return new APIPromise($doPost(`/zone-devices/${zoneDeviceId}/provisioning`, {}));
+}

package/src/admin-funcs/zoneDevicesUpdate.ts

@@ -0,0 +1,21 @@
+import { APIPromise } from "../types/async.js";
+import { $doPut, internalApiResult } from "./doAdmin.js";
+import type { zoneDeviceConnectionType } from "./zoneDevicesCreate.js";
+
+// Wire names, posted verbatim like zoneDevicesCreateRequest. Every field is optional: only what
+// the edit changed is sent.
+export type zoneDevicesUpdateRequest = {
+  zone_id?: number;
+  network_id?: number;
+  connection_type?: zoneDeviceConnectionType;
+  name?: string;
+};
+
+// Edits a gateway from the Gatekeeper device details screen. This only updates the record; the
+// app pushes the new network to the hardware using zoneDevicesProvisioning.
+//
+// Internal for the same reason as zoneDevicesCreate. 404 covers a gateway, zone or network outside
+// the caller's scope, and a network not linked to the zone's facility.
+export function zoneDevicesUpdate(zoneDeviceId: number, request: zoneDevicesUpdateRequest): internalApiResult {
+  return new APIPromise($doPut(`/zone-devices/${zoneDeviceId}`, request));
+}

package/src/apps/components.ts

@@ -8,6 +8,11 @@
  *
  * Styling is tokens only. There is no `style`, `className` or colour value an app can pass, and
  * every URL-shaped prop is typed so the host can refuse what the manifest did not grant.
+ *
+ * The Apps guides show screenshots of representative states and options for each component
+ * (not every contract state, such as a disabled Link, is pictured). A new component, or a change to
+ * how one looks or behaves, needs new or recaptured pictures in the same change; see
+ * .github/instructions/app-platform-ui.instructions.md.
  */
 
 import { isHttpsUrl } from "./url.js";

package/src/funcs/vendorsGetVendorTargetFacilities.ts

@@ -44,8 +44,11 @@ import {
  *
  * - `vendor_target_facility.facility`
  * - `vendor_target_facility.has_screening_responses`
+ * - `vendor_target_facility.expiring_credential_count`
  *
  * The endpoint rejects any other value with `422 Unprocessable Entity`.
+ *
+ * Pass `include_status_counts=true` to also receive `status_counts`, the number of approved and not approved rows. The counts honor `active_facilities_only` and `facility_id`, and ignore the search, name, and status filters.
  */
 export function vendorsGetVendorTargetFacilities(
   client: GreenSecurityCore,
@@ -126,8 +129,11 @@ async function $do(
       "expand": payload.expand,
     }, { explode: false }),
     encodeFormQuery({
+      "active_facilities_only": payload.active_facilities_only,
       "desc": payload.desc,
+      "facility_id": payload.facility_id,
       "facility_name_like": payload.facility_name_like,
+      "include_status_counts": payload.include_status_counts,
       "items_per_page": payload.items_per_page,
       "page": payload.page,
       "search_like": payload.search_like,

package/src/index.extras.ts

@@ -66,6 +66,12 @@ import { zoneDevicesList } from "./admin-funcs/zoneDevicesList.js";
 import { zoneDevicesGet } from "./admin-funcs/zoneDevicesGet.js";
 import { zoneDevicesCreate } from "./admin-funcs/zoneDevicesCreate.js";
 import { zoneDevicesMacAvailability } from "./admin-funcs/zoneDevicesMacAvailability.js";
+import { zoneDevicesUpdate } from "./admin-funcs/zoneDevicesUpdate.js";
+import { zoneDevicesProvisioning } from "./admin-funcs/zoneDevicesProvisioning.js";
+import { zoneDevicesDelete } from "./admin-funcs/zoneDevicesDelete.js";
+import { lookupsAddressValidation } from "./admin-funcs/lookupsAddressValidation.js";
+import { lookupsAddressAutocomplete } from "./admin-funcs/lookupsAddressAutocomplete.js";
+import { lookupsAddressPlace } from "./admin-funcs/lookupsAddressPlace.js";
 
 // Third-party app platform contract (surfaces, manifest, host/sandbox protocol, components).
 export * as apps from "./apps/index.js";
@@ -139,6 +145,12 @@ export const __internal = {
     dismiss: dismissCommunication
   },
 
+  lookups: {
+    validateAddress: lookupsAddressValidation,
+    autocompleteAddress: lookupsAddressAutocomplete,
+    getAddressPlace: lookupsAddressPlace
+  },
+
   // Third-party app platform host (web-mobile-client, docs/third-party-apps/plan.md C8).
   apps: {
     listInstalledApps: appsListInstalledApps,
@@ -181,6 +193,9 @@ export const __internal = {
     list: zoneDevicesList,
     get: zoneDevicesGet,
     create: zoneDevicesCreate,
+    update: zoneDevicesUpdate,
+    provisioning: zoneDevicesProvisioning,
+    delete: zoneDevicesDelete,
     macAvailability: zoneDevicesMacAvailability
   }
 };

package/src/lib/config.ts

@@ -80,8 +80,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "0.46.0",
-  sdkVersion: "0.47.0-beta.1",
-  genVersion: "2.943.0",
+  sdkVersion: "0.47.0-beta.11",
+  genVersion: "2.948.4",
   userAgent:
-    "speakeasy-sdk/typescript 0.47.0-beta.1 2.943.0 0.46.0 @greensecurity/javascript-sdk",
+    "speakeasy-sdk/typescript 0.47.0-beta.11 2.948.4 0.46.0 @greensecurity/javascript-sdk",
 } as const;

package/src/models/components/expand.ts

@@ -19,6 +19,8 @@ export const Expand = {
   VendorTargetFacilityFacility: "vendor_target_facility.facility",
   VendorTargetFacilityHasScreeningResponses:
     "vendor_target_facility.has_screening_responses",
+  VendorTargetFacilityExpiringCredentialCount:
+    "vendor_target_facility.expiring_credential_count",
   ContactFacility: "contact.facility",
   ContactSystem: "contact.system",
   ContactDepartment: "contact.department",

package/src/models/components/index.ts

@@ -177,6 +177,7 @@ export * from "./vendorscrubdetails.js";
 export * from "./vendorscrubpurchase.js";
 export * from "./vendortargetfacility.js";
 export * from "./vendortargetfacilityscreeningresponse.js";
+export * from "./vendortargetfacilitystatuscounts.js";
 export * from "./vendortype.js";
 export * from "./visitorcheckin.js";
 export * from "./webhookconsumers.js";

package/src/models/components/vendortargetfacility.ts

@@ -40,6 +40,10 @@ export type VendorTargetFacility = {
    * Whether the vendor has answered at least one target-facility screening question for this facility. Present only when you pass `vendor_target_facility.has_screening_responses` to `expand`. Combined with `questions_answered` it distinguishes "View" (answered some) from "None" (no questions answered) in the individual's subscription view.
    */
   hasScreeningResponses?: boolean | undefined;
+  /**
+   * How many credentials the facility requires from the vendor have an approved version that expires within 30 days, with no newer version approved or waiting for approval. Company-owned credentials are left out when the caller is a vendor whose company has company managers. Present only when you pass `vendor_target_facility.expiring_credential_count` to `expand`.
+   */
+  expiringCredentialCount?: number | undefined;
   /**
    * The date and time the target facility was added to the vendor, in ISO 8601 format, or `null` if not available.
    */
@@ -76,11 +80,13 @@ export const VendorTargetFacility$inboundSchema: z.ZodType<
   status: types.nullable(types.string()),
   questions_answered: types.nullable(types.boolean()),
   has_screening_responses: types.optional(types.boolean()),
+  expiring_credential_count: types.optional(types.number()),
   date_created: z.nullable(types.date()).optional(),
 }).transform((v) => {
   return remap$(v, {
     "questions_answered": "questionsAnswered",
     "has_screening_responses": "hasScreeningResponses",
+    "expiring_credential_count": "expiringCredentialCount",
     "date_created": "dateCreated",
   });
 });

package/src/models/components/vendortargetfacilitystatuscounts.ts

@@ -0,0 +1,53 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * How many of a vendor's target facility rows are approved and not approved. Returned when you pass `include_status_counts=true`.
+ */
+export type VendorTargetFacilityStatusCounts = {
+  /**
+   * Rows with the `Approved` status.
+   */
+  approved: number;
+  /**
+   * Rows with any other status, including no status.
+   */
+  notApproved: number;
+  /**
+   * All rows the counts cover.
+   */
+  total: number;
+};
+
+/** @internal */
+export const VendorTargetFacilityStatusCounts$inboundSchema: z.ZodType<
+  VendorTargetFacilityStatusCounts,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  approved: types.number(),
+  not_approved: types.number(),
+  total: types.number(),
+}).transform((v) => {
+  return remap$(v, {
+    "not_approved": "notApproved",
+  });
+});
+
+export function vendorTargetFacilityStatusCountsFromJSON(
+  jsonString: string,
+): SafeParseResult<VendorTargetFacilityStatusCounts, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => VendorTargetFacilityStatusCounts$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'VendorTargetFacilityStatusCounts' from JSON`,
+  );
+}

package/src/models/operations/createinvoice.ts

@@ -58,6 +58,10 @@ export type Five = {
    * A campaign opt-in code, taken from the link that carried the offer Deliberately not an enumeration. The server decides which codes are live, what each one grants, and who qualifies for it. These decisions change as campaigns come and go. The server ignores an unrecognized code, or one the account does not qualify for, and creates the invoice as if the code were absent, never returning an error. The server adds any line item the code earns, and it appears on the quote.
    */
   promo?: string | undefined;
+  /**
+   * Set to `true` when the payer intends to settle this order from their credit balance before their payment method is charged. This affects only how the convenience fee is calculated: the fee pays for card processing, so it is assessed on the amount the card is left to cover once credits have been applied, and an order a balance covers in full carries none. No credits are debited here, and the balance is read from the payer's own ledger rather than taken from this request. Settle the credits with `POST /invoices/{id}/payment` and `use_credits: true`.
+   */
+  useCredits?: boolean | undefined;
 };
 
 export const CreateInvoiceRequestBodyInvoicesPaymentHandler = {
@@ -105,6 +109,10 @@ export type Four = {
    * A campaign opt-in code, taken from the link that carried the offer Deliberately not an enumeration. The server decides which codes are live, what each one grants, and who qualifies for it. These decisions change as campaigns come and go. The server ignores an unrecognized code, or one the account does not qualify for, and creates the invoice as if the code were absent, never returning an error. The server adds any line item the code earns, and it appears on the quote.
    */
   promo?: string | undefined;
+  /**
+   * Set to `true` when the payer intends to settle this order from their credit balance before their payment method is charged. This affects only how the convenience fee is calculated: the fee pays for card processing, so it is assessed on the amount the card is left to cover once credits have been applied, and an order a balance covers in full carries none. No credits are debited here, and the balance is read from the payer's own ledger rather than taken from this request. Settle the credits with `POST /invoices/{id}/payment` and `use_credits: true`.
+   */
+  useCredits?: boolean | undefined;
 };
 
 export const CreateInvoiceRequestBodyPaymentHandler = {
@@ -152,6 +160,10 @@ export type Three = {
    * A campaign opt-in code, taken from the link that carried the offer Deliberately not an enumeration. The server decides which codes are live, what each one grants, and who qualifies for it. These decisions change as campaigns come and go. The server ignores an unrecognized code, or one the account does not qualify for, and creates the invoice as if the code were absent, never returning an error. The server adds any line item the code earns, and it appears on the quote.
    */
   promo?: string | undefined;
+  /**
+   * Set to `true` when the payer intends to settle this order from their credit balance before their payment method is charged. This affects only how the convenience fee is calculated: the fee pays for card processing, so it is assessed on the amount the card is left to cover once credits have been applied, and an order a balance covers in full carries none. No credits are debited here, and the balance is read from the payer's own ledger rather than taken from this request. Settle the credits with `POST /invoices/{id}/payment` and `use_credits: true`.
+   */
+  useCredits?: boolean | undefined;
 };
 
 export const RequestBodyPaymentHandler = {
@@ -197,6 +209,10 @@ export type CreateInvoiceRequestBody2 = {
    * A campaign opt-in code, taken from the link that carried the offer Deliberately not an enumeration. The server decides which codes are live, what each one grants, and who qualifies for it. These decisions change as campaigns come and go. The server ignores an unrecognized code, or one the account does not qualify for, and creates the invoice as if the code were absent, never returning an error. The server adds any line item the code earns, and it appears on the quote.
    */
   promo?: string | undefined;
+  /**
+   * Set to `true` when the payer intends to settle this order from their credit balance before their payment method is charged. This affects only how the convenience fee is calculated: the fee pays for card processing, so it is assessed on the amount the card is left to cover once credits have been applied, and an order a balance covers in full carries none. No credits are debited here, and the balance is read from the payer's own ledger rather than taken from this request. Settle the credits with `POST /invoices/{id}/payment` and `use_credits: true`.
+   */
+  useCredits?: boolean | undefined;
 };
 
 export const PaymentHandler = {
@@ -240,6 +256,10 @@ export type RequestBody1 = {
    * A campaign opt-in code, taken from the link that carried the offer Deliberately not an enumeration. The server decides which codes are live, what each one grants, and who qualifies for it. These decisions change as campaigns come and go. The server ignores an unrecognized code, or one the account does not qualify for, and creates the invoice as if the code were absent, never returning an error. The server adds any line item the code earns, and it appears on the quote.
    */
   promo?: string | undefined;
+  /**
+   * Set to `true` when the payer intends to settle this order from their credit balance before their payment method is charged. This affects only how the convenience fee is calculated: the fee pays for card processing, so it is assessed on the amount the card is left to cover once credits have been applied, and an order a balance covers in full carries none. No credits are debited here, and the balance is read from the payer's own ledger rather than taken from this request. Settle the credits with `POST /invoices/{id}/payment` and `use_credits: true`.
+   */
+  useCredits?: boolean | undefined;
 };
 
 /**
@@ -336,6 +356,7 @@ export type Five$Outbound = {
   credential_pricing_ids?: Array<number> | null | undefined;
   invoice_type?: string | undefined;
   promo?: string | undefined;
+  use_credits: boolean;
 };
 
 /** @internal */
@@ -350,11 +371,13 @@ export const Five$outboundSchema: z.ZodType<Five$Outbound, z.ZodTypeDef, Five> =
       CreateInvoiceRequestBodyInvoicesRequestInvoiceType$outboundSchema
         .optional(),
     promo: z.string().optional(),
+    useCredits: z.boolean().default(false),
   }).transform((v) => {
     return remap$(v, {
       vendorCredentialId: "vendor_credential_id",
       credentialPricingIds: "credential_pricing_ids",
       invoiceType: "invoice_type",
+      useCredits: "use_credits",
     });
   });
 
@@ -432,6 +455,7 @@ export type Four$Outbound = {
   credential_pricing_ids?: Array<number> | null | undefined;
   invoice_type?: string | undefined;
   promo?: string | undefined;
+  use_credits: boolean;
 };
 
 /** @internal */
@@ -445,11 +469,13 @@ export const Four$outboundSchema: z.ZodType<Four$Outbound, z.ZodTypeDef, Four> =
     invoiceType: CreateInvoiceRequestBodyInvoicesInvoiceType$outboundSchema
       .optional(),
     promo: z.string().optional(),
+    useCredits: z.boolean().default(false),
   }).transform((v) => {
     return remap$(v, {
       systemId: "system_id",
       credentialPricingIds: "credential_pricing_ids",
       invoiceType: "invoice_type",
+      useCredits: "use_credits",
     });
   });
 
@@ -529,6 +555,7 @@ export type Three$Outbound = {
   credential_pricing_ids?: Array<number> | null | undefined;
   invoice_type?: string | undefined;
   promo?: string | undefined;
+  use_credits: boolean;
 };
 
 /** @internal */
@@ -543,11 +570,13 @@ export const Three$outboundSchema: z.ZodType<
   credentialPricingIds: z.nullable(z.array(z.number().int())).optional(),
   invoiceType: CreateInvoiceRequestBodyInvoiceType$outboundSchema.optional(),
   promo: z.string().optional(),
+  useCredits: z.boolean().default(false),
 }).transform((v) => {
   return remap$(v, {
     facilityId: "facility_id",
     credentialPricingIds: "credential_pricing_ids",
     invoiceType: "invoice_type",
+    useCredits: "use_credits",
   });
 });
 
@@ -622,6 +651,7 @@ export type CreateInvoiceRequestBody2$Outbound = {
   credential_pricing_ids?: Array<number> | null | undefined;
   invoice_type?: string | undefined;
   promo?: string | undefined;
+  use_credits: boolean;
 };
 
 /** @internal */
@@ -635,11 +665,13 @@ export const CreateInvoiceRequestBody2$outboundSchema: z.ZodType<
   credentialPricingIds: z.nullable(z.array(z.number().int())).optional(),
   invoiceType: RequestBodyInvoiceType$outboundSchema.optional(),
   promo: z.string().optional(),
+  useCredits: z.boolean().default(false),
 }).transform((v) => {
   return remap$(v, {
     companyId: "company_id",
     credentialPricingIds: "credential_pricing_ids",
     invoiceType: "invoice_type",
+    useCredits: "use_credits",
   });
 });
 
@@ -713,6 +745,7 @@ export type RequestBody1$Outbound = {
   credential_pricing_ids?: Array<number> | null | undefined;
   invoice_type?: string | undefined;
   promo?: string | undefined;
+  use_credits: boolean;
 };
 
 /** @internal */
@@ -726,11 +759,13 @@ export const RequestBody1$outboundSchema: z.ZodType<
   credentialPricingIds: z.nullable(z.array(z.number().int())).optional(),
   invoiceType: InvoiceType$outboundSchema.optional(),
   promo: z.string().optional(),
+  useCredits: z.boolean().default(false),
 }).transform((v) => {
   return remap$(v, {
     vendorId: "vendor_id",
     credentialPricingIds: "credential_pricing_ids",
     invoiceType: "invoice_type",
+    useCredits: "use_credits",
   });
 });
 

package/src/models/operations/getvendortargetfacilities.ts

@@ -7,26 +7,52 @@ import { remap as remap$ } from "../../lib/primitives.js";
 import { safeParse } from "../../lib/schemas.js";
 import { ClosedEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
 import * as components from "../components/index.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 /**
- * Filters to target facilities with this status.
+ * Filters to target facilities with this status. `not_approved` matches every status other than `Approved`, including no status.
  */
 export const GetVendorTargetFacilitiesQueryParamStatus = {
   Pending: "pending",
   Approved: "approved",
   Denied: "denied",
+  NotApproved: "not_approved",
 } as const;
 /**
- * Filters to target facilities with this status.
+ * Filters to target facilities with this status. `not_approved` matches every status other than `Approved`, including no status.
  */
 export type GetVendorTargetFacilitiesQueryParamStatus = ClosedEnum<
   typeof GetVendorTargetFacilitiesQueryParamStatus
 >;
 
 /**
- * The field to sort results by. Defaults to `facility_name`.
+ * When `true`, leaves out target facilities whose facility is not active.
+ */
+export const ActiveFacilitiesOnly = {
+  True: "true",
+  False: "false",
+} as const;
+/**
+ * When `true`, leaves out target facilities whose facility is not active.
+ */
+export type ActiveFacilitiesOnly = ClosedEnum<typeof ActiveFacilitiesOnly>;
+
+/**
+ * When `true`, the response also includes `status_counts`.
+ */
+export const IncludeStatusCounts = {
+  True: "true",
+  False: "false",
+} as const;
+/**
+ * When `true`, the response also includes `status_counts`.
+ */
+export type IncludeStatusCounts = ClosedEnum<typeof IncludeStatusCounts>;
+
+/**
+ * The field to sort results by. Defaults to `facility_name`. `not_approved_first` lists the systems with the most rows that are not approved first, then by system name; within a system it puts the rows that are not approved first, then sorts by facility name. `not_approved_first` ignores `desc`.
  */
 export const GetVendorTargetFacilitiesQueryParamSort = {
   FacilityName: "facility_name",
@@ -34,9 +60,10 @@ export const GetVendorTargetFacilitiesQueryParamSort = {
   Status: "status",
   QuestionsAnswered: "questions_answered",
   DateCreated: "date_created",
+  NotApprovedFirst: "not_approved_first",
 } as const;
 /**
- * The field to sort results by. Defaults to `facility_name`.
+ * The field to sort results by. Defaults to `facility_name`. `not_approved_first` lists the systems with the most rows that are not approved first, then by system name; within a system it puts the rows that are not approved first, then sorts by facility name. `not_approved_first` ignores `desc`.
  */
 export type GetVendorTargetFacilitiesQueryParamSort = ClosedEnum<
   typeof GetVendorTargetFacilitiesQueryParamSort
@@ -62,13 +89,25 @@ export type GetVendorTargetFacilitiesRequest = {
    */
   systemNameLike?: string | undefined;
   /**
-   * Search across facility name and system name.
+   * Search across facility name, street address, city, state (code or full name), ZIP code, and system name.
    */
   searchLike?: string | undefined;
   /**
-   * Filters to target facilities with this status.
+   * Filters to target facilities with this status. `not_approved` matches every status other than `Approved`, including no status.
    */
   status?: GetVendorTargetFacilitiesQueryParamStatus | undefined;
+  /**
+   * Filters to the target facility row of this facility.
+   */
+  facilityId?: number | undefined;
+  /**
+   * When `true`, leaves out target facilities whose facility is not active.
+   */
+  activeFacilitiesOnly?: ActiveFacilitiesOnly | undefined;
+  /**
+   * When `true`, the response also includes `status_counts`.
+   */
+  includeStatusCounts?: IncludeStatusCounts | undefined;
   /**
    * The page number of results to return, starting at 1.
    */
@@ -78,7 +117,7 @@ export type GetVendorTargetFacilitiesRequest = {
    */
   itemsPerPage?: number | undefined;
   /**
-   * The field to sort results by. Defaults to `facility_name`.
+   * The field to sort results by. Defaults to `facility_name`. `not_approved_first` lists the systems with the most rows that are not approved first, then by system name; within a system it puts the rows that are not approved first, then sorts by facility name. `not_approved_first` ignores `desc`.
    */
   sort?: GetVendorTargetFacilitiesQueryParamSort | undefined;
   /**
@@ -100,6 +139,10 @@ export type GetVendorTargetFacilitiesGetVendorTargetFacilitiesOk = {
    */
   pager: components.Pager;
   items: Array<components.VendorTargetFacility>;
+  /**
+   * How many of a vendor's target facility rows are approved and not approved. Returned when you pass `include_status_counts=true`.
+   */
+  statusCounts?: components.VendorTargetFacilityStatusCounts | undefined;
 };
 
 export type GetVendorTargetFacilitiesResponse = {
@@ -111,6 +154,16 @@ export const GetVendorTargetFacilitiesQueryParamStatus$outboundSchema:
   z.ZodNativeEnum<typeof GetVendorTargetFacilitiesQueryParamStatus> = z
     .nativeEnum(GetVendorTargetFacilitiesQueryParamStatus);
 
+/** @internal */
+export const ActiveFacilitiesOnly$outboundSchema: z.ZodNativeEnum<
+  typeof ActiveFacilitiesOnly
+> = z.nativeEnum(ActiveFacilitiesOnly);
+
+/** @internal */
+export const IncludeStatusCounts$outboundSchema: z.ZodNativeEnum<
+  typeof IncludeStatusCounts
+> = z.nativeEnum(IncludeStatusCounts);
+
 /** @internal */
 export const GetVendorTargetFacilitiesQueryParamSort$outboundSchema:
   z.ZodNativeEnum<typeof GetVendorTargetFacilitiesQueryParamSort> = z
@@ -123,6 +176,9 @@ export type GetVendorTargetFacilitiesRequest$Outbound = {
   system_name_like?: string | undefined;
   search_like?: string | undefined;
   status?: string | undefined;
+  facility_id?: number | undefined;
+  active_facilities_only?: string | undefined;
+  include_status_counts?: string | undefined;
   page?: number | undefined;
   items_per_page?: number | undefined;
   sort?: string | undefined;
@@ -141,6 +197,9 @@ export const GetVendorTargetFacilitiesRequest$outboundSchema: z.ZodType<
   systemNameLike: z.string().optional(),
   searchLike: z.string().optional(),
   status: GetVendorTargetFacilitiesQueryParamStatus$outboundSchema.optional(),
+  facilityId: z.number().int().optional(),
+  activeFacilitiesOnly: ActiveFacilitiesOnly$outboundSchema.optional(),
+  includeStatusCounts: IncludeStatusCounts$outboundSchema.optional(),
   page: z.number().int().optional(),
   itemsPerPage: z.number().int().optional(),
   sort: GetVendorTargetFacilitiesQueryParamSort$outboundSchema.optional(),
@@ -152,6 +211,9 @@ export const GetVendorTargetFacilitiesRequest$outboundSchema: z.ZodType<
     facilityNameLike: "facility_name_like",
     systemNameLike: "system_name_like",
     searchLike: "search_like",
+    facilityId: "facility_id",
+    activeFacilitiesOnly: "active_facilities_only",
+    includeStatusCounts: "include_status_counts",
     itemsPerPage: "items_per_page",
   });
 });
@@ -175,6 +237,13 @@ export const GetVendorTargetFacilitiesGetVendorTargetFacilitiesOk$inboundSchema:
   > = z.object({
     pager: components.Pager$inboundSchema,
     items: z.array(components.VendorTargetFacility$inboundSchema),
+    status_counts: types.optional(
+      components.VendorTargetFacilityStatusCounts$inboundSchema,
+    ),
+  }).transform((v) => {
+    return remap$(v, {
+      "status_counts": "statusCounts",
+    });
   });
 
 export function getVendorTargetFacilitiesGetVendorTargetFacilitiesOkFromJSON(

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

@@ -79,6 +79,9 @@ export function buildVendorsGetVendorTargetFacilitiesQuery(
       systemNameLike: request.systemNameLike,
       searchLike: request.searchLike,
       status: request.status,
+      facilityId: request.facilityId,
+      activeFacilitiesOnly: request.activeFacilitiesOnly,
+      includeStatusCounts: request.includeStatusCounts,
       page: request.page,
       itemsPerPage: request.itemsPerPage,
       sort: request.sort,
@@ -129,6 +132,9 @@ export function buildVendorsGetVendorTargetFacilitiesInfiniteQuery(
         systemNameLike: request.systemNameLike,
         searchLike: request.searchLike,
         status: request.status,
+        facilityId: request.facilityId,
+        activeFacilitiesOnly: request.activeFacilitiesOnly,
+        includeStatusCounts: request.includeStatusCounts,
         page: request.page,
         itemsPerPage: request.itemsPerPage,
         sort: request.sort,
@@ -177,6 +183,9 @@ export function queryKeyVendorsGetVendorTargetFacilities(
     systemNameLike?: string | undefined;
     searchLike?: string | undefined;
     status?: operations.GetVendorTargetFacilitiesQueryParamStatus | undefined;
+    facilityId?: number | undefined;
+    activeFacilitiesOnly?: operations.ActiveFacilitiesOnly | undefined;
+    includeStatusCounts?: operations.IncludeStatusCounts | undefined;
     page?: number | undefined;
     itemsPerPage?: number | undefined;
     sort?: operations.GetVendorTargetFacilitiesQueryParamSort | undefined;
@@ -200,6 +209,9 @@ export function queryKeyVendorsGetVendorTargetFacilitiesInfinite(
     systemNameLike?: string | undefined;
     searchLike?: string | undefined;
     status?: operations.GetVendorTargetFacilitiesQueryParamStatus | undefined;
+    facilityId?: number | undefined;
+    activeFacilitiesOnly?: operations.ActiveFacilitiesOnly | undefined;
+    includeStatusCounts?: operations.IncludeStatusCounts | undefined;
     page?: number | undefined;
     itemsPerPage?: number | undefined;
     sort?: operations.GetVendorTargetFacilitiesQueryParamSort | undefined;