@greensecurity/javascript-sdk 0.43.1-beta.3 → 0.43.1-beta.30

package/src/models/components/vendorscanscreeninganswer.ts

@@ -0,0 +1,80 @@
+/*
+ * 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 * 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 { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export const AnswerType = {
+  Preset: "preset",
+  Date: "date",
+  ShortAnswer: "short answer",
+  LongAnswer: "long answer",
+} as const;
+export type AnswerType = OpenEnum<typeof AnswerType>;
+
+/**
+ * Reduced set of attributes for a screening answer, used in vendor_scan context. Matches the fields returned by ScreeningAnswer#api_json when context: :vendor_scan is applied.
+ *
+ * @remarks
+ */
+export type VendorScanScreeningAnswer = {
+  id: number;
+  answer?: string | null | undefined;
+  answerType?: AnswerType | null | undefined;
+  priority?: number | null | undefined;
+  showConfirmation?: boolean | undefined;
+  confirmationText?: string | null | undefined;
+  answerTitle?: string | null | undefined;
+  allowEmptyAnswer?: boolean | undefined;
+  emptyAnswerErrorMessage?: string | null | undefined;
+};
+
+/** @internal */
+export const AnswerType$inboundSchema: z.ZodType<
+  AnswerType,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(AnswerType);
+
+/** @internal */
+export const VendorScanScreeningAnswer$inboundSchema: z.ZodType<
+  VendorScanScreeningAnswer,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: types.number(),
+  answer: z.nullable(types.string()).optional(),
+  answer_type: z.nullable(AnswerType$inboundSchema).optional(),
+  priority: z.nullable(types.number()).optional(),
+  show_confirmation: types.optional(types.boolean()),
+  confirmation_text: z.nullable(types.string()).optional(),
+  answer_title: z.nullable(types.string()).optional(),
+  allow_empty_answer: types.optional(types.boolean()),
+  empty_answer_error_message: z.nullable(types.string()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "answer_type": "answerType",
+    "show_confirmation": "showConfirmation",
+    "confirmation_text": "confirmationText",
+    "answer_title": "answerTitle",
+    "allow_empty_answer": "allowEmptyAnswer",
+    "empty_answer_error_message": "emptyAnswerErrorMessage",
+  });
+});
+
+export function vendorScanScreeningAnswerFromJSON(
+  jsonString: string,
+): SafeParseResult<VendorScanScreeningAnswer, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => VendorScanScreeningAnswer$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'VendorScanScreeningAnswer' from JSON`,
+  );
+}

package/src/models/components/vendorscanscreeningquestion.ts

@@ -0,0 +1,100 @@
+/*
+ * 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 * 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 { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  VendorScanScreeningAnswer,
+  VendorScanScreeningAnswer$inboundSchema,
+} from "./vendorscanscreeninganswer.js";
+
+/**
+ * The display format for presenting this question.
+ */
+export const PresetDisplayAs = {
+  FloatingButtons: "floating buttons",
+  LineButtons: "line buttons",
+  Radio: "radio",
+  Select: "select",
+  Checkbox: "checkbox",
+  Checkbox2Column: "checkbox (2-column)",
+} as const;
+/**
+ * The display format for presenting this question.
+ */
+export type PresetDisplayAs = OpenEnum<typeof PresetDisplayAs>;
+
+/**
+ * Reduced set of attributes for a screening question, used in vendor_scan context. Contains only the fields required for rendering the next question in the vendor screening workflow.
+ *
+ * @remarks
+ */
+export type VendorScanScreeningQuestion = {
+  /**
+   * The unique ID of the screening question.
+   */
+  id: number;
+  /**
+   * The text of the screening question.
+   */
+  question?: string | null | undefined;
+  /**
+   * The display format for presenting this question.
+   */
+  presetDisplayAs?: PresetDisplayAs | null | undefined;
+  /**
+   * The ID of the screening answer selected by default, if any.
+   *
+   * @remarks
+   */
+  screeningAnswerId?: number | null | undefined;
+  /**
+   * The list of possible answers for this question.
+   */
+  screeningAnswers?: Array<VendorScanScreeningAnswer> | undefined;
+};
+
+/** @internal */
+export const PresetDisplayAs$inboundSchema: z.ZodType<
+  PresetDisplayAs,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(PresetDisplayAs);
+
+/** @internal */
+export const VendorScanScreeningQuestion$inboundSchema: z.ZodType<
+  VendorScanScreeningQuestion,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: types.number(),
+  question: z.nullable(types.string()).optional(),
+  preset_display_as: z.nullable(PresetDisplayAs$inboundSchema).optional(),
+  screening_answer_id: z.nullable(types.number()).optional(),
+  screening_answers: types.optional(
+    z.array(VendorScanScreeningAnswer$inboundSchema),
+  ),
+}).transform((v) => {
+  return remap$(v, {
+    "preset_display_as": "presetDisplayAs",
+    "screening_answer_id": "screeningAnswerId",
+    "screening_answers": "screeningAnswers",
+  });
+});
+
+export function vendorScanScreeningQuestionFromJSON(
+  jsonString: string,
+): SafeParseResult<VendorScanScreeningQuestion, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => VendorScanScreeningQuestion$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'VendorScanScreeningQuestion' from JSON`,
+  );
+}

package/src/models/errors/apierrorresponse.ts

@@ -15,7 +15,7 @@ import { GreenSecurityError } from "./greensecurityerror.js";
  */
 export type ApiErrorResponseData = {
   error: string;
-  success: boolean;
+  success?: boolean | undefined;
   code?: number | null | undefined;
 };
 
@@ -28,7 +28,7 @@ export type ApiErrorResponseData = {
  */
 export class ApiErrorResponse extends GreenSecurityError {
   error: string;
-  success: boolean;
+  success?: boolean | undefined;
   code?: number | null | undefined;
 
   /** The original data that was passed to this error instance. */
@@ -44,7 +44,7 @@ export class ApiErrorResponse extends GreenSecurityError {
     super(message, httpMeta);
     this.data$ = err;
     this.error = err.error;
-    this.success = err.success;
+    if (err.success != null) this.success = err.success;
     if (err.code != null) this.code = err.code;
 
     this.name = "ApiErrorResponse";
@@ -58,7 +58,7 @@ export const ApiErrorResponse$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   error: types.string(),
-  success: types.boolean(),
+  success: types.optional(types.boolean()),
   code: z.nullable(types.number()).optional(),
   request$: z.instanceof(Request),
   response$: z.instanceof(Response),

package/src/models/operations/getnextscreeningquestion.ts

@@ -0,0 +1,91 @@
+/*
+ * 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 * as components from "../components/index.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type GetNextScreeningQuestionRequest = {
+  /**
+   * The identifier of the object
+   */
+  id: number;
+  /**
+   * An array-style parameter to identify which sections of an object to expand. See documentation for the endpoint for a list of valid expansion values.
+   */
+  expand?: Array<components.Expand> | undefined;
+  /**
+   * Vendor ID to use when a company manager is making the request.
+   *
+   * @remarks
+   * If omitted, the system falls back to the logged-in vendor.
+   */
+  vendorId?: number | undefined;
+};
+
+/**
+ * The request was successful, and the server has returned the requested resource in the response body.
+ */
+export type GetNextScreeningQuestionResponseBody = {
+  success?: boolean | undefined;
+  question?: components.VendorScanScreeningQuestion | null | undefined;
+};
+
+/** @internal */
+export type GetNextScreeningQuestionRequest$Outbound = {
+  id: number;
+  expand?: Array<string> | undefined;
+  vendor_id?: number | undefined;
+};
+
+/** @internal */
+export const GetNextScreeningQuestionRequest$outboundSchema: z.ZodType<
+  GetNextScreeningQuestionRequest$Outbound,
+  z.ZodTypeDef,
+  GetNextScreeningQuestionRequest
+> = z.object({
+  id: z.number().int(),
+  expand: z.array(components.Expand$outboundSchema).optional(),
+  vendorId: z.number().int().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    vendorId: "vendor_id",
+  });
+});
+
+export function getNextScreeningQuestionRequestToJSON(
+  getNextScreeningQuestionRequest: GetNextScreeningQuestionRequest,
+): string {
+  return JSON.stringify(
+    GetNextScreeningQuestionRequest$outboundSchema.parse(
+      getNextScreeningQuestionRequest,
+    ),
+  );
+}
+
+/** @internal */
+export const GetNextScreeningQuestionResponseBody$inboundSchema: z.ZodType<
+  GetNextScreeningQuestionResponseBody,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  success: types.optional(types.boolean()),
+  question: z.nullable(components.VendorScanScreeningQuestion$inboundSchema)
+    .optional(),
+});
+
+export function getNextScreeningQuestionResponseBodyFromJSON(
+  jsonString: string,
+): SafeParseResult<GetNextScreeningQuestionResponseBody, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      GetNextScreeningQuestionResponseBody$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetNextScreeningQuestionResponseBody' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -28,6 +28,7 @@ export * from "./deletevendormanagedbycompany.js";
 export * from "./expeditetimeremaining.js";
 export * from "./getfacility.js";
 export * from "./getfhirconfig.js";
+export * from "./getnextscreeningquestion.js";
 export * from "./getnextunansweredscreeningquestion.js";
 export * from "./getsecurityzone.js";
 export * from "./getsubscription.js";
@@ -78,6 +79,7 @@ export * from "./purchasescrubcredits.js";
 export * from "./rotateapikey.js";
 export * from "./securityzonecheckin.js";
 export * from "./senddownloadcode.js";
+export * from "./submitscreeningresponse.js";
 export * from "./submitvendorcredential.js";
 export * from "./updatedatarequest.js";
 export * from "./updateevent.js";

package/src/models/operations/securityzonecheckin.ts

@@ -81,6 +81,25 @@ export const Requires = {
 } as const;
 export type Requires = ClosedEnum<typeof Requires>;
 
+/**
+ * Reduced list of attributes of Handoff record
+ */
+export type HandoffHandoff = {
+  id?: number | undefined;
+  /**
+   * Reduced list of attributes of Zone record
+   */
+  zone?: components.Zone | undefined;
+  qrCode?: string | null | undefined;
+  dateCreated?: string | null | undefined;
+  dateReceived?: string | null | undefined;
+  dateCompleted?: string | null | undefined;
+  status?: string | null | undefined;
+  gpsCheckin?: boolean | undefined;
+};
+
+export type Handoff = HandoffHandoff | number;
+
 export type Results = {
   hasValidPaymentProfile?: boolean | undefined;
   subscriptionExpires?: string | null | undefined;
@@ -110,10 +129,7 @@ export type Results = {
 export type SecurityZoneCheckinSecurityZoneCheckinOk = {
   success?: boolean | undefined;
   requires?: Requires | undefined;
-  /**
-   * Reduced list of attributes of Handoff record
-   */
-  handoff?: components.Handoff | null | undefined;
+  handoff?: HandoffHandoff | number | null | undefined;
   results?: Results | undefined;
 };
 
@@ -278,6 +294,54 @@ export function securityZoneCheckinRequestBodyToJSON(
 export const Requires$inboundSchema: z.ZodNativeEnum<typeof Requires> = z
   .nativeEnum(Requires);
 
+/** @internal */
+export const HandoffHandoff$inboundSchema: z.ZodType<
+  HandoffHandoff,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: types.optional(types.number()),
+  zone: types.optional(components.Zone$inboundSchema),
+  qr_code: z.nullable(types.string()).optional(),
+  date_created: z.nullable(types.string()).optional(),
+  date_received: z.nullable(types.string()).optional(),
+  date_completed: z.nullable(types.string()).optional(),
+  status: z.nullable(types.string()).optional(),
+  gps_checkin: types.optional(types.boolean()),
+}).transform((v) => {
+  return remap$(v, {
+    "qr_code": "qrCode",
+    "date_created": "dateCreated",
+    "date_received": "dateReceived",
+    "date_completed": "dateCompleted",
+    "gps_checkin": "gpsCheckin",
+  });
+});
+
+export function handoffHandoffFromJSON(
+  jsonString: string,
+): SafeParseResult<HandoffHandoff, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => HandoffHandoff$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'HandoffHandoff' from JSON`,
+  );
+}
+
+/** @internal */
+export const Handoff$inboundSchema: z.ZodType<Handoff, z.ZodTypeDef, unknown> =
+  smartUnion([z.lazy(() => HandoffHandoff$inboundSchema), types.number()]);
+
+export function handoffFromJSON(
+  jsonString: string,
+): SafeParseResult<Handoff, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Handoff$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Handoff' from JSON`,
+  );
+}
+
 /** @internal */
 export const Results$inboundSchema: z.ZodType<Results, z.ZodTypeDef, unknown> =
   z.object({
@@ -334,7 +398,9 @@ export const SecurityZoneCheckinSecurityZoneCheckinOk$inboundSchema: z.ZodType<
 > = z.object({
   success: types.optional(types.boolean()),
   requires: types.optional(Requires$inboundSchema),
-  handoff: z.nullable(components.Handoff$inboundSchema).optional(),
+  handoff: z.nullable(
+    smartUnion([z.lazy(() => HandoffHandoff$inboundSchema), types.number()]),
+  ).optional(),
   results: types.optional(z.lazy(() => Results$inboundSchema)),
 });
 

package/src/models/operations/submitscreeningresponse.ts

@@ -0,0 +1,169 @@
+/*
+ * 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 * as components from "../components/index.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type SubmitScreeningResponseRequestBody = {
+  /**
+   * ID of the screening question being answered.
+   */
+  screeningQuestionId: number;
+  /**
+   * ID of the selected screening answer for single-select questions.
+   */
+  screeningAnswerId?: number | null | undefined;
+  /**
+   * IDs of the selected screening answers for multi-select questions.
+   *
+   * @remarks
+   */
+  multipleScreeningAnswerIds?: Array<number> | null | undefined;
+  /**
+   * Optional vendor ID. Used when the authenticated user is a company manager submitting a response on behalf of a vendor
+   *
+   * @remarks
+   */
+  vendorId?: number | null | undefined;
+  /**
+   * Custom free-text answer for questions that accept typed input.
+   */
+  customAnswer?: string | null | undefined;
+};
+
+export type SubmitScreeningResponseRequest = {
+  /**
+   * The identifier of the object
+   */
+  id: number;
+  requestBody: SubmitScreeningResponseRequestBody;
+};
+
+/**
+ * Response returned after a screening question answer is submitted.
+ *
+ * @remarks
+ */
+export type SubmitScreeningResponseResponseBody = {
+  success?: boolean | undefined;
+  /**
+   * Indicates whether there is another unanswered screening question available, assuming triggered actions do not stop the flow.
+   *
+   * @remarks
+   */
+  hasNextQuestion?: boolean | undefined;
+  /**
+   * List of actions triggered by this screening response. Present only when there is no next question (i.e., `has_next_question` is false).
+   *
+   * @remarks
+   */
+  triggeredActions?:
+    | Array<components.ScreeningAnswerActionSummary>
+    | null
+    | undefined;
+};
+
+/** @internal */
+export type SubmitScreeningResponseRequestBody$Outbound = {
+  screening_question_id: number;
+  screening_answer_id?: number | null | undefined;
+  multiple_screening_answer_ids?: Array<number> | null | undefined;
+  vendor_id?: number | null | undefined;
+  custom_answer?: string | null | undefined;
+};
+
+/** @internal */
+export const SubmitScreeningResponseRequestBody$outboundSchema: z.ZodType<
+  SubmitScreeningResponseRequestBody$Outbound,
+  z.ZodTypeDef,
+  SubmitScreeningResponseRequestBody
+> = z.object({
+  screeningQuestionId: z.number().int(),
+  screeningAnswerId: z.nullable(z.number().int()).optional(),
+  multipleScreeningAnswerIds: z.nullable(z.array(z.number().int())).optional(),
+  vendorId: z.nullable(z.number().int()).optional(),
+  customAnswer: z.nullable(z.string()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    screeningQuestionId: "screening_question_id",
+    screeningAnswerId: "screening_answer_id",
+    multipleScreeningAnswerIds: "multiple_screening_answer_ids",
+    vendorId: "vendor_id",
+    customAnswer: "custom_answer",
+  });
+});
+
+export function submitScreeningResponseRequestBodyToJSON(
+  submitScreeningResponseRequestBody: SubmitScreeningResponseRequestBody,
+): string {
+  return JSON.stringify(
+    SubmitScreeningResponseRequestBody$outboundSchema.parse(
+      submitScreeningResponseRequestBody,
+    ),
+  );
+}
+
+/** @internal */
+export type SubmitScreeningResponseRequest$Outbound = {
+  id: number;
+  RequestBody: SubmitScreeningResponseRequestBody$Outbound;
+};
+
+/** @internal */
+export const SubmitScreeningResponseRequest$outboundSchema: z.ZodType<
+  SubmitScreeningResponseRequest$Outbound,
+  z.ZodTypeDef,
+  SubmitScreeningResponseRequest
+> = z.object({
+  id: z.number().int(),
+  requestBody: z.lazy(() => SubmitScreeningResponseRequestBody$outboundSchema),
+}).transform((v) => {
+  return remap$(v, {
+    requestBody: "RequestBody",
+  });
+});
+
+export function submitScreeningResponseRequestToJSON(
+  submitScreeningResponseRequest: SubmitScreeningResponseRequest,
+): string {
+  return JSON.stringify(
+    SubmitScreeningResponseRequest$outboundSchema.parse(
+      submitScreeningResponseRequest,
+    ),
+  );
+}
+
+/** @internal */
+export const SubmitScreeningResponseResponseBody$inboundSchema: z.ZodType<
+  SubmitScreeningResponseResponseBody,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  success: types.optional(types.boolean()),
+  has_next_question: types.optional(types.boolean()),
+  triggered_actions: z.nullable(
+    z.array(components.ScreeningAnswerActionSummary$inboundSchema),
+  ).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "has_next_question": "hasNextQuestion",
+    "triggered_actions": "triggeredActions",
+  });
+});
+
+export function submitScreeningResponseResponseBodyFromJSON(
+  jsonString: string,
+): SafeParseResult<SubmitScreeningResponseResponseBody, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      SubmitScreeningResponseResponseBody$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SubmitScreeningResponseResponseBody' from JSON`,
+  );
+}

package/src/react-query/_types.ts

@@ -160,3 +160,16 @@ export type MutationHookOptions<
     "mutationKey" | "mutationFn" | keyof RequestOptions
   >
   & RequestOptions;
+
+/**
+ * Removes non-serializable properties (functions and symbols) from a PageIterator for SSR hydration.
+ * React Server Components cannot serialize functions or Symbol properties across the server/client boundary.
+ */
+export function pageIteratorToJSON<T extends { "~next"?: unknown }>(
+  page: T,
+): T {
+  const { next: _, ...rest } = page as T & { next?: unknown };
+  // Symbol properties are copied by spread but can't be serialized for RSC
+  delete (rest as Record<symbol, unknown>)[Symbol.asyncIterator];
+  return rest as T;
+}