@greensecurity/javascript-sdk 0.45.0-beta.0 → 0.45.0-beta.10

package/src/funcs/invoicesConvertQuote.ts

@@ -0,0 +1,190 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { GreenSecurityCore } from "../core.js";
+import { encodeSimple } from "../lib/encodings.js";
+import { matchStatusCode } from "../lib/http.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.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 { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Convert a quote into an invoice
+ *
+ * @remarks
+ * Converts a quote into the real invoice its caller will be charged for, and
+ * returns the new invoice with its calculated totals. Any `VendorCredential`
+ * linked to the quote is re-pointed at the new invoice.
+ *
+ * The operation is idempotent: converting a quote that has already been
+ * processed returns the invoice previously created from it rather than
+ * creating a second one, so a retried request is safe.
+ *
+ * The referenced invoice must actually be a quote — a non-quote invoice id
+ * responds `400`. Requires a caller whose access scope permits creating
+ * invoices; a caller allowed to create the invoice but not to update the
+ * linked `VendorCredential` responds `401`.
+ *
+ * Takes no request body.
+ *
+ * If set, this operation will use {@link Security.bearerJwt} from the global security.
+ */
+export function invoicesConvertQuote(
+  client: GreenSecurityCore,
+  request: operations.ConvertQuoteRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    operations.ConvertQuoteConvertQuoteOk,
+    | errors.ApiErrorResponse
+    | GreenSecurityError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: GreenSecurityCore,
+  request: operations.ConvertQuoteRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      operations.ConvertQuoteConvertQuoteOk,
+      | errors.ApiErrorResponse
+      | GreenSecurityError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => operations.ConvertQuoteRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    id: encodeSimple("id", payload.id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/invoices/{id}/convert")(pathParams);
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const securityInput = await extractSecurity(client._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput, [1]);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "convertQuote",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.security,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    isErrorStatusCode: (statusCode: number) =>
+      matchStatusCode({ status: statusCode } as Response, ["4XX", "5XX"]),
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    operations.ConvertQuoteConvertQuoteOk,
+    | errors.ApiErrorResponse
+    | GreenSecurityError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, operations.ConvertQuoteConvertQuoteOk$inboundSchema),
+    M.jsonErr([400, 401, 403, 404], errors.ApiErrorResponse$inboundSchema),
+    M.fail("4XX"),
+    M.fail([500, "5XX"]),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/funcs/usersPostAuthenticate.ts

@@ -186,6 +186,7 @@ async function $do(
     M.json(200, operations.PostAuthenticateResponse$inboundSchema),
     M.json(202, operations.PostAuthenticateResponse$inboundSchema),
     M.jsonErr([400, 401, 403, 404], errors.ApiErrorResponse$inboundSchema),
+    M.jsonErr(503, errors.ApiErrorResponse$inboundSchema),
     M.fail("4XX"),
     M.fail([500, "5XX"]),
   )(response, req, { extraFields: responseFields });

package/src/funcs/vendorsGetVendorCredentialDetails.ts

@@ -36,6 +36,7 @@ import { Result } from "../types/fp.js";
  *   - vendor_credential.credential
  *   - vendor_credential.vendor
  *   - vendor_credential.invoice
+ *   - vendor_credential.quote
  *   - vendor_credential.vendor_credential_files
  *   - vendor_credential.latest_vendor_credential_id
  *   - vendor_credential.previously_approved

package/src/funcs/vendorsVendorsExport.ts

@@ -32,7 +32,10 @@ import { Result } from "../types/fp.js";
  *
  * @remarks
  * Enqueues an asynchronous job to generate a CSV export of vendors based on the
- * provided filters (the same filters supported by the vendors list endpoint).
+ * provided filters (the same filters supported by the vendors list endpoint), in the same
+ * credential-inclusive format as the portal's "Download Full Report" button - one column per
+ * applicable credential (status, due date, expiration), plus counts and percentage approved,
+ * alongside the vendor's identity, contact, and company details.
  * Returns a `status_url` to poll until the export is ready, plus a
  * `download_url` and `status_id`.
  *
@@ -114,6 +117,8 @@ async function $do(
     "desc": payload.desc,
     "email_like": payload.email_like,
     "expand": payload.expand,
+    "externally_managed_by_company_id":
+      payload.externally_managed_by_company_id,
     "first_name_like": payload.first_name_like,
     "full_name_like": payload.full_name_like,
     "items_per_page": payload.items_per_page,

package/src/lib/config.ts

@@ -80,8 +80,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "0.44.0",
-  sdkVersion: "0.45.0-beta.0",
-  genVersion: "2.932.9",
+  sdkVersion: "0.45.0-beta.10",
+  genVersion: "2.934.1",
   userAgent:
-    "speakeasy-sdk/typescript 0.45.0-beta.0 2.932.9 0.44.0 @greensecurity/javascript-sdk",
+    "speakeasy-sdk/typescript 0.45.0-beta.10 2.934.1 0.44.0 @greensecurity/javascript-sdk",
 } as const;

package/src/lib/encodings.ts

@@ -12,10 +12,41 @@ export class EncodingError extends Error {
   }
 }
 
+export type CharEncoding = "percent" | "percentExceptReserved" | "none";
+
+const reservedEscapes = /%(2[346bcf]|3[abdf]|40|5[bd])/gi;
+
+function encodeKeyChars(
+  v: string,
+  charEncoding: CharEncoding | undefined,
+): string {
+  return encodeChars(
+    v,
+    charEncoding === "percentExceptReserved" ? "percent" : charEncoding,
+  );
+}
+
+function encodeChars(
+  v: string,
+  charEncoding: CharEncoding | undefined,
+): string {
+  switch (charEncoding) {
+    case "percent":
+      return encodeURIComponent(v);
+    case "percentExceptReserved":
+      return encodeURIComponent(v).replace(
+        reservedEscapes,
+        (m) => decodeURIComponent(m),
+      );
+    default:
+      return v;
+  }
+}
+
 export function encodeMatrix(
   key: string,
   value: unknown,
-  options?: { explode?: boolean; charEncoding?: "percent" | "none" },
+  options?: { explode?: boolean; charEncoding?: CharEncoding },
 ): string | undefined {
   let out = "";
   const pairs: [string, unknown][] = options?.explode
@@ -27,7 +58,7 @@ export function encodeMatrix(
   }
 
   const encodeString = (v: string) => {
-    return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    return encodeChars(v, options?.charEncoding);
   };
   const encodeValue = (v: unknown) => encodeString(serializeValue(v));
 
@@ -52,7 +83,7 @@ export function encodeMatrix(
       return;
     }
 
-    const keyPrefix = encodeString(pk);
+    const keyPrefix = encodeKeyChars(pk, options?.charEncoding);
     tmp = `${keyPrefix}=${encValue}`;
     // trim trailing '=' if value was empty
     if (tmp === `${keyPrefix}=`) {
@@ -73,7 +104,7 @@ export function encodeMatrix(
 export function encodeLabel(
   key: string,
   value: unknown,
-  options?: { explode?: boolean; charEncoding?: "percent" | "none" },
+  options?: { explode?: boolean; charEncoding?: CharEncoding },
 ): string | undefined {
   let out = "";
   const pairs: [string, unknown][] = options?.explode
@@ -85,7 +116,7 @@ export function encodeLabel(
   }
 
   const encodeString = (v: string) => {
-    return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    return encodeChars(v, options?.charEncoding);
   };
   const encodeValue = (v: unknown) => encodeString(serializeValue(v));
 
@@ -103,7 +134,7 @@ export function encodeLabel(
       encValue = mapped?.join("").slice(1);
     } else {
       const k = options?.explode && isPlainObject(value)
-        ? `${encodeString(pk)}=`
+        ? `${encodeKeyChars(pk, options?.charEncoding)}=`
         : "";
       encValue = `${k}${encodeValue(pv)}`;
     }
@@ -117,14 +148,14 @@ export function encodeLabel(
 type FormEncoder = (
   key: string,
   value: unknown,
-  options?: { explode?: boolean; charEncoding?: "percent" | "none" },
+  options?: { explode?: boolean; charEncoding?: CharEncoding },
 ) => string | undefined;
 
 function formEncoder(sep: string): FormEncoder {
   return (
     key: string,
     value: unknown,
-    options?: { explode?: boolean; charEncoding?: "percent" | "none" },
+    options?: { explode?: boolean; charEncoding?: CharEncoding },
   ) => {
     let out = "";
     const pairs: [string, unknown][] = options?.explode
@@ -136,7 +167,7 @@ function formEncoder(sep: string): FormEncoder {
     }
 
     const encodeString = (v: string) => {
-      return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+      return encodeChars(v, options?.charEncoding);
     };
 
     const encodeValue = (v: unknown) => encodeString(serializeValue(v));
@@ -163,7 +194,7 @@ function formEncoder(sep: string): FormEncoder {
         return;
       }
 
-      tmp = `${encodeString(pk)}=${encValue}`;
+      tmp = `${encodeKeyChars(pk, options?.charEncoding)}=${encValue}`;
 
       // If we end up with the nothing then skip forward
       if (!tmp || tmp === "=") {
@@ -184,7 +215,7 @@ export const encodePipeDelimited = formEncoder("|");
 export function encodeBodyForm(
   key: string,
   value: unknown,
-  options?: { explode?: boolean; charEncoding?: "percent" | "none" },
+  options?: { explode?: boolean; charEncoding?: CharEncoding },
 ): string {
   let out = "";
   const pairs: [string, unknown][] = options?.explode
@@ -192,7 +223,7 @@ export function encodeBodyForm(
     : [[key, value]];
 
   const encodeString = (v: string) => {
-    return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    return encodeChars(v, options?.charEncoding);
   };
 
   const encodeValue = (v: unknown) => encodeString(serializeValue(v));
@@ -211,7 +242,7 @@ export function encodeBodyForm(
       encValue = `${encodeValue(pv)}`;
     }
 
-    tmp = `${encodeString(pk)}=${encValue}`;
+    tmp = `${encodeKeyChars(pk, options?.charEncoding)}=${encValue}`;
 
     // If we end up with the nothing then skip forward
     if (!tmp || tmp === "=") {
@@ -227,7 +258,7 @@ export function encodeBodyForm(
 export function encodeDeepObject(
   key: string,
   value: unknown,
-  options?: { charEncoding?: "percent" | "none" },
+  options?: { charEncoding?: CharEncoding },
 ): string | undefined {
   if (value == null) {
     return;
@@ -245,7 +276,7 @@ export function encodeDeepObject(
 export function encodeDeepObjectObject(
   key: string,
   value: unknown,
-  options?: { charEncoding?: "percent" | "none" },
+  options?: { charEncoding?: CharEncoding },
 ): string | undefined {
   if (value == null) {
     return;
@@ -254,7 +285,7 @@ export function encodeDeepObjectObject(
   let out = "";
 
   const encodeString = (v: string) => {
-    return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    return encodeChars(v, options?.charEncoding);
   };
 
   if (!isPlainObject(value)) {
@@ -278,7 +309,9 @@ export function encodeDeepObjectObject(
 
     const pairs: unknown[] = Array.isArray(cv) ? cv : [cv];
     const encoded = mapDefined(pairs, (v) => {
-      return `${encodeString(pk)}=${encodeString(serializeValue(v))}`;
+      return `${encodeKeyChars(pk, options?.charEncoding)}=${
+        encodeString(serializeValue(v))
+      }`;
     })?.join("&");
 
     out += encoded == null ? "" : `&${encoded}`;
@@ -290,25 +323,27 @@ export function encodeDeepObjectObject(
 export function encodeJSON(
   key: string,
   value: unknown,
-  options?: { explode?: boolean; charEncoding?: "percent" | "none" },
+  options?: { explode?: boolean; charEncoding?: CharEncoding },
 ): string | undefined {
   if (typeof value === "undefined") {
     return;
   }
 
   const encodeString = (v: string) => {
-    return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    return encodeChars(v, options?.charEncoding);
   };
 
   const encVal = encodeString(JSON.stringify(value, jsonReplacer));
 
-  return options?.explode ? encVal : `${encodeString(key)}=${encVal}`;
+  return options?.explode
+    ? encVal
+    : `${encodeKeyChars(key, options?.charEncoding)}=${encVal}`;
 }
 
 export const encodeSimple = (
   key: string,
   value: unknown,
-  options?: { explode?: boolean; charEncoding?: "percent" | "none" },
+  options?: { explode?: boolean; charEncoding?: CharEncoding },
 ): string | undefined => {
   let out = "";
   const pairs: [string, unknown][] = options?.explode
@@ -320,7 +355,7 @@ export const encodeSimple = (
   }
 
   const encodeString = (v: string) => {
-    return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    return encodeChars(v, options?.charEncoding);
   };
   const encodeValue = (v: unknown) => encodeString(serializeValue(v));
 
@@ -426,7 +461,7 @@ export function queryJoin(...args: (string | undefined)[]): string {
 
 type QueryEncoderOptions = {
   explode?: boolean;
-  charEncoding?: "percent" | "none";
+  charEncoding?: CharEncoding;
   allowEmptyValue?: string[];
 };
 

package/src/models/components/companymanager.ts

@@ -5,6 +5,8 @@
 import * as z from "zod/v3";
 import { remap as remap$ } from "../../lib/primitives.js";
 import { safeParse } from "../../lib/schemas.js";
+import * as openEnums from "../../types/enums.js";
+import { OpenEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import * as types from "../../types/primitives.js";
 import { smartUnion } from "../../types/smartUnion.js";
@@ -17,6 +19,19 @@ import {
 } from "./paymentprofile.js";
 import { UserLocation, UserLocation$inboundSchema } from "./userlocation.js";
 
+/**
+ * The manager's status on the company.
+ */
+export const CompanyManagerStatus = {
+  Active: "Active",
+  Inactive: "Inactive",
+  Deleted: "Deleted",
+} as const;
+/**
+ * The manager's status on the company.
+ */
+export type CompanyManagerStatus = OpenEnum<typeof CompanyManagerStatus>;
+
 export type User1 = {
   id?: number | undefined;
   firstName?: string | null | undefined;
@@ -46,12 +61,22 @@ export type CompanyManagerPaymentProfile = PaymentProfile | number;
 
 export type CompanyManager = {
   id?: number | undefined;
-  status?: string | null | undefined;
+  /**
+   * The manager's status on the company.
+   */
+  status?: CompanyManagerStatus | null | undefined;
   user?: User1 | number | undefined;
   company?: Company | number | null | undefined;
   paymentProfile?: PaymentProfile | number | null | undefined;
 };
 
+/** @internal */
+export const CompanyManagerStatus$inboundSchema: z.ZodType<
+  CompanyManagerStatus,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(CompanyManagerStatus);
+
 /** @internal */
 export const User1$inboundSchema: z.ZodType<User1, z.ZodTypeDef, unknown> = z
   .object({
@@ -146,7 +171,7 @@ export const CompanyManager$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   id: types.optional(types.number()),
-  status: z.nullable(types.string()).optional(),
+  status: z.nullable(CompanyManagerStatus$inboundSchema).optional(),
   user: types.optional(
     smartUnion([z.lazy(() => User1$inboundSchema), types.number()]),
   ),

package/src/models/components/expand.ts

@@ -71,6 +71,7 @@ export const Expand = {
   VendorCredentialCredential: "vendor_credential.credential",
   VendorCredentialVendor: "vendor_credential.vendor",
   VendorCredentialInvoice: "vendor_credential.invoice",
+  VendorCredentialQuote: "vendor_credential.quote",
   VendorCredentialVendorCredentialFiles:
     "vendor_credential.vendor_credential_files",
   VendorCredentialLatestVendorCredentialId:

package/src/models/components/fhirconfig.ts

@@ -131,6 +131,22 @@ export type FhirConfig = {
    * See [JMESPath](https://jmespath.org/)
    */
   projection: string;
+  /**
+   * A JMESPath that decides whether a patient should be hidden (VIP, confidential, anonymized). When set it replaces the built-in checks, so a facility can describe its own rule instead of relying on the defaults. Some sites carry the anonymized marker on the encounter rather than the patient extension, which the built-ins do not look at.
+   *
+   * @remarks
+   *
+   * See [JMESPath](https://jmespath.org/)
+   */
+  restrictionFilter?: string | null | undefined;
+  /**
+   * A JMESPath that maps `{ patient, flags, encounter }` to the standard `{ isAnonymized, hasVipFlag }` shape. Takes precedence over restriction_filter, and covers the HL7 path as well as FHIR. Leave empty to fall back to restriction_filter or the built-in checks.
+   *
+   * @remarks
+   *
+   * See [JMESPath](https://jmespath.org/)
+   */
+  restrictionProjection?: string | null | undefined;
   /**
    * Whether to automatically create Room records for unmapped FHIR encounter locations
    */
@@ -273,6 +289,8 @@ export const FhirConfig$inboundSchema: z.ZodType<
   notes: types.optional(types.string()),
   entities: FhirExtraEntities$inboundSchema,
   projection: types.string(),
+  restriction_filter: z.nullable(types.string()).optional(),
+  restriction_projection: z.nullable(types.string()).optional(),
   auto_create_rooms: types.boolean().default(false),
   room_creation_jmespath: types.optional(types.string()),
 }).transform((v) => {
@@ -281,6 +299,8 @@ export const FhirConfig$inboundSchema: z.ZodType<
     "non_production_profile": "nonProductionProfile",
     "applies_to": "appliesTo",
     "active_profile": "activeProfile",
+    "restriction_filter": "restrictionFilter",
+    "restriction_projection": "restrictionProjection",
     "auto_create_rooms": "autoCreateRooms",
     "room_creation_jmespath": "roomCreationJmespath",
   });

package/src/models/components/fhirconfigcreate.ts

@@ -47,6 +47,22 @@ export type FhirConfigCreate = {
    */
   entities: FhirExtraEntities;
   projection?: string | undefined;
+  /**
+   * A JMESPath that decides whether a patient should be hidden (VIP, confidential, anonymized). When set it replaces the built-in checks, so a facility can describe its own rule instead of relying on the defaults. Some sites carry the anonymized marker on the encounter rather than the patient extension, which the built-ins do not look at.
+   *
+   * @remarks
+   *
+   * See [JMESPath](https://jmespath.org/)
+   */
+  restrictionFilter?: string | null | undefined;
+  /**
+   * A JMESPath that maps `{ patient, flags, encounter }` to the standard `{ isAnonymized, hasVipFlag }` shape. Takes precedence over restriction_filter, and covers the HL7 path as well as FHIR. Leave empty to fall back to restriction_filter or the built-in checks.
+   *
+   * @remarks
+   *
+   * See [JMESPath](https://jmespath.org/)
+   */
+  restrictionProjection?: string | null | undefined;
 };
 
 /** @internal */
@@ -173,6 +189,8 @@ export type FhirConfigCreate$Outbound = {
   notes?: string | undefined;
   entities: FhirExtraEntities$Outbound;
   projection?: string | undefined;
+  restriction_filter?: string | null | undefined;
+  restriction_projection?: string | null | undefined;
 };
 
 /** @internal */
@@ -192,12 +210,16 @@ export const FhirConfigCreate$outboundSchema: z.ZodType<
   notes: z.string().optional(),
   entities: FhirExtraEntities$outboundSchema,
   projection: z.string().optional(),
+  restrictionFilter: z.nullable(z.string()).optional(),
+  restrictionProjection: z.nullable(z.string()).optional(),
 }).transform((v) => {
   return remap$(v, {
     productionProfile: "production_profile",
     nonProductionProfile: "non_production_profile",
     appliesTo: "applies_to",
     activeProfile: "active_profile",
+    restrictionFilter: "restriction_filter",
+    restrictionProjection: "restriction_projection",
   });
 });
 

package/src/models/components/fhirextraentities.ts

@@ -3,6 +3,7 @@
  */
 
 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";
@@ -14,6 +15,14 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 export type FhirExtraEntities = {
   flags?: boolean | undefined;
   consents?: boolean | undefined;
+  /**
+   * Which Flag category a patient lookup should scope its search to. Epic refuses a Flag search that names no category, so a facility on Epic should set this or the search comes back rejected and the patient looks like they have no flags. Cerner and other servers allow a broad search and can leave it empty.
+   *
+   * @remarks
+   *
+   * Leave empty to let the client decide.
+   */
+  flagCategory?: string | null | undefined;
 };
 
 /** @internal */
@@ -24,11 +33,17 @@ export const FhirExtraEntities$inboundSchema: z.ZodType<
 > = z.object({
   flags: types.optional(types.boolean()),
   consents: types.optional(types.boolean()),
+  flag_category: z.nullable(types.string()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "flag_category": "flagCategory",
+  });
 });
 /** @internal */
 export type FhirExtraEntities$Outbound = {
   flags?: boolean | undefined;
   consents?: boolean | undefined;
+  flag_category?: string | null | undefined;
 };
 
 /** @internal */
@@ -39,6 +54,11 @@ export const FhirExtraEntities$outboundSchema: z.ZodType<
 > = z.object({
   flags: z.boolean().optional(),
   consents: z.boolean().optional(),
+  flagCategory: z.nullable(z.string()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    flagCategory: "flag_category",
+  });
 });
 
 export function fhirExtraEntitiesToJSON(