@greensecurity/javascript-sdk 0.45.0-beta.25 → 0.45.0-beta.27

package/src/models/components/invite.ts

@@ -0,0 +1,168 @@
+/*
+ * 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 { smartUnion } from "../../types/smartUnion.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type Event2 = {
+  id: number;
+  name: string | null;
+};
+
+/**
+ * The event id, or a summary when `invite.event` is passed to `expand`.
+ */
+export type InviteEvent = Event2 | number;
+
+export const InviteStatus = {
+  Pending: "Pending",
+  Accepted: "Accepted",
+  Declined: "Declined",
+} as const;
+export type InviteStatus = OpenEnum<typeof InviteStatus>;
+
+export const InviteType = {
+  User: "user",
+  Department: "department",
+  Company: "company",
+} as const;
+export type InviteType = OpenEnum<typeof InviteType>;
+
+/**
+ * Who the invitation is addressed to. Populated when `invite.invitee` is passed to `expand`.
+ */
+export type Invitee = {
+  id?: number | undefined;
+  name?: string | null | undefined;
+  type?: InviteType | undefined;
+};
+
+/**
+ * An invitation to an appointment, in the shape served to SDK builds `0.55.0-beta.1` and above. SDK builds below `0.55.0-beta.1` receive `PendingInvitation` instead.
+ *
+ * @remarks
+ *
+ * The boundary is the prerelease build `0.55.0-beta.1`, not the `0.55.0` release. A build is compared to it by semantic-version ordering, in which a prerelease sorts below its own release: so `0.55.0-beta.1` itself, every later prerelease (`0.55.0-beta.2`, `0.55.0-rc.1`) and every release from `0.55.0` up receive this shape, while an earlier prerelease of the same release — `0.55.0-alpha.1` — does not.
+ */
+export type Invite = {
+  id?: number | undefined;
+  /**
+   * The event id, or a summary when `invite.event` is passed to `expand`.
+   */
+  event?: Event2 | number | undefined;
+  userId?: number | null | undefined;
+  companyId?: number | null | undefined;
+  departmentId?: number | null | undefined;
+  status?: InviteStatus | null | undefined;
+  dateReviewed?: string | null | undefined;
+  /**
+   * Who the invitation is addressed to. Populated when `invite.invitee` is passed to `expand`.
+   */
+  invitee?: Invitee | null | undefined;
+};
+
+/** @internal */
+export const Event2$inboundSchema: z.ZodType<Event2, z.ZodTypeDef, unknown> = z
+  .object({
+    id: types.number(),
+    name: types.nullable(types.string()),
+  });
+
+export function event2FromJSON(
+  jsonString: string,
+): SafeParseResult<Event2, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Event2$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Event2' from JSON`,
+  );
+}
+
+/** @internal */
+export const InviteEvent$inboundSchema: z.ZodType<
+  InviteEvent,
+  z.ZodTypeDef,
+  unknown
+> = smartUnion([z.lazy(() => Event2$inboundSchema), types.number()]);
+
+export function inviteEventFromJSON(
+  jsonString: string,
+): SafeParseResult<InviteEvent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => InviteEvent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'InviteEvent' from JSON`,
+  );
+}
+
+/** @internal */
+export const InviteStatus$inboundSchema: z.ZodType<
+  InviteStatus,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(InviteStatus);
+
+/** @internal */
+export const InviteType$inboundSchema: z.ZodType<
+  InviteType,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(InviteType);
+
+/** @internal */
+export const Invitee$inboundSchema: z.ZodType<Invitee, z.ZodTypeDef, unknown> =
+  z.object({
+    id: types.optional(types.number()),
+    name: z.nullable(types.string()).optional(),
+    type: types.optional(InviteType$inboundSchema),
+  });
+
+export function inviteeFromJSON(
+  jsonString: string,
+): SafeParseResult<Invitee, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Invitee$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Invitee' from JSON`,
+  );
+}
+
+/** @internal */
+export const Invite$inboundSchema: z.ZodType<Invite, z.ZodTypeDef, unknown> = z
+  .object({
+    id: types.optional(types.number()),
+    event: types.optional(
+      smartUnion([z.lazy(() => Event2$inboundSchema), types.number()]),
+    ),
+    user_id: z.nullable(types.number()).optional(),
+    company_id: z.nullable(types.number()).optional(),
+    department_id: z.nullable(types.number()).optional(),
+    status: z.nullable(InviteStatus$inboundSchema).optional(),
+    date_reviewed: z.nullable(types.string()).optional(),
+    invitee: z.nullable(z.lazy(() => Invitee$inboundSchema)).optional(),
+  }).transform((v) => {
+    return remap$(v, {
+      "user_id": "userId",
+      "company_id": "companyId",
+      "department_id": "departmentId",
+      "date_reviewed": "dateReviewed",
+    });
+  });
+
+export function inviteFromJSON(
+  jsonString: string,
+): SafeParseResult<Invite, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Invite$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Invite' from JSON`,
+  );
+}

package/src/models/operations/createevent.ts

@@ -32,6 +32,23 @@ export type CreateEventRequestBody = {
   inviteeUserIds?: Array<number> | undefined;
   inviteeDepartmentIds?: Array<number> | undefined;
   notes?: string | undefined;
+  /**
+   * The user the appointment is booked for. Defaults to the authenticated user, which
+   *
+   * @remarks
+   * is what a vendor or a facility user means. An API service account has no calendar
+   * of its own, so it names one here; the user must be a contact of the selected
+   * facility (or of its system), or a vendor targeting it.
+   */
+  organizerUserId?: number | undefined;
+  /**
+   * The time zone `begin_date`/`begin_time` and `end_date`/`end_time` are given in, as
+   *
+   * @remarks
+   * a Rails time zone name (e.g. "Central Time (US & Canada)"). Defaults to the
+   * organizer's own time zone.
+   */
+  timezone?: string | undefined;
 };
 
 /**
@@ -57,6 +74,8 @@ export type CreateEventRequestBody$Outbound = {
   invitee_user_ids?: Array<number> | undefined;
   invitee_department_ids?: Array<number> | undefined;
   notes?: string | undefined;
+  organizer_user_id?: number | undefined;
+  timezone?: string | undefined;
 };
 
 /** @internal */
@@ -78,6 +97,8 @@ export const CreateEventRequestBody$outboundSchema: z.ZodType<
   inviteeUserIds: z.array(z.number().int()).optional(),
   inviteeDepartmentIds: z.array(z.number().int()).optional(),
   notes: z.string().optional(),
+  organizerUserId: z.number().int().optional(),
+  timezone: z.string().optional(),
 }).transform((v) => {
   return remap$(v, {
     facilityId: "facility_id",
@@ -91,6 +112,7 @@ export const CreateEventRequestBody$outboundSchema: z.ZodType<
     endDate: "end_date",
     inviteeUserIds: "invitee_user_ids",
     inviteeDepartmentIds: "invitee_department_ids",
+    organizerUserId: "organizer_user_id",
   });
 });
 

package/src/models/operations/getevent.ts

@@ -3,13 +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";
-import { smartUnion } from "../../types/smartUnion.js";
 import * as components from "../components/index.js";
-import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type GetEventRequest = {
   /**
@@ -22,81 +16,6 @@ export type GetEventRequest = {
   expand?: Array<components.Expand> | undefined;
 };
 
-export type Facility2 = {};
-
-/**
- * The facility ID, or the expanded facility object when `event.facility` is passed to `expand`.
- */
-export type Facility = number | Facility2;
-
-export type Department2 = {};
-
-/**
- * The department ID, or the expanded department object when `event.department` is passed to `expand`.
- */
-export type Department = number | Department2;
-
-export type Invitees = {
-  id?: number | undefined;
-  userId?: number | null | undefined;
-  companyId?: number | null | undefined;
-  departmentId?: number | null | undefined;
-  status?: string | undefined;
-  dateReviewed?: string | null | undefined;
-};
-
-/**
- * The request was successful, and the server has returned the requested resource in the response body.
- */
-export type GetEventGetEventOk = {
-  id?: number | undefined;
-  /**
-   * The event name.
-   */
-  title?: string | undefined;
-  /**
-   * Date and time in 12-hour format with 15-minute precision.
-   *
-   * @remarks
-   * Format: MM/DD/YYYY h:mm am/pm (e.g., "07/18/2025 12:15 pm" or "7:15 pm").
-   * - Hours: 1 to 12 (zero-padded or not)
-   * - Minutes: 00, 15, 30, or 45
-   * - AM/PM in lowercase
-   */
-  start?: string | undefined;
-  /**
-   * Date and time in 12-hour format with 15-minute precision.
-   *
-   * @remarks
-   * Format: MM/DD/YYYY h:mm am/pm (e.g., "07/18/2025 12:15 pm" or "7:15 pm").
-   * - Hours: 1 to 12 (zero-padded or not)
-   * - Minutes: 00, 15, 30, or 45
-   * - AM/PM in lowercase
-   */
-  end?: string | undefined;
-  allDay?: boolean | undefined;
-  standingAppt?: boolean | undefined;
-  bringingFood?: boolean | undefined;
-  notes?: string | null | undefined;
-  status?: string | undefined;
-  /**
-   * ISO 8601 date-time when the event was approved.
-   */
-  dateApproved?: string | null | undefined;
-  /**
-   * The facility ID, or the expanded facility object when `event.facility` is passed to `expand`.
-   */
-  facility?: number | Facility2 | undefined;
-  /**
-   * The department ID, or the expanded department object when `event.department` is passed to `expand`.
-   */
-  department?: number | Department2 | undefined;
-  /**
-   * Populated when `event.invitees` is passed to `expand`.
-   */
-  invitees?: Array<Invitees> | null | undefined;
-};
-
 /** @internal */
 export type GetEventRequest$Outbound = {
   id: number;
@@ -118,145 +37,3 @@ export function getEventRequestToJSON(
 ): string {
   return JSON.stringify(GetEventRequest$outboundSchema.parse(getEventRequest));
 }
-
-/** @internal */
-export const Facility2$inboundSchema: z.ZodType<
-  Facility2,
-  z.ZodTypeDef,
-  unknown
-> = z.object({});
-
-export function facility2FromJSON(
-  jsonString: string,
-): SafeParseResult<Facility2, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => Facility2$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'Facility2' from JSON`,
-  );
-}
-
-/** @internal */
-export const Facility$inboundSchema: z.ZodType<
-  Facility,
-  z.ZodTypeDef,
-  unknown
-> = smartUnion([types.number(), z.lazy(() => Facility2$inboundSchema)]);
-
-export function facilityFromJSON(
-  jsonString: string,
-): SafeParseResult<Facility, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => Facility$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'Facility' from JSON`,
-  );
-}
-
-/** @internal */
-export const Department2$inboundSchema: z.ZodType<
-  Department2,
-  z.ZodTypeDef,
-  unknown
-> = z.object({});
-
-export function department2FromJSON(
-  jsonString: string,
-): SafeParseResult<Department2, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => Department2$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'Department2' from JSON`,
-  );
-}
-
-/** @internal */
-export const Department$inboundSchema: z.ZodType<
-  Department,
-  z.ZodTypeDef,
-  unknown
-> = smartUnion([types.number(), z.lazy(() => Department2$inboundSchema)]);
-
-export function departmentFromJSON(
-  jsonString: string,
-): SafeParseResult<Department, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => Department$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'Department' from JSON`,
-  );
-}
-
-/** @internal */
-export const Invitees$inboundSchema: z.ZodType<
-  Invitees,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  id: types.optional(types.number()),
-  user_id: z.nullable(types.number()).optional(),
-  company_id: z.nullable(types.number()).optional(),
-  department_id: z.nullable(types.number()).optional(),
-  status: types.optional(types.string()),
-  date_reviewed: z.nullable(types.string()).optional(),
-}).transform((v) => {
-  return remap$(v, {
-    "user_id": "userId",
-    "company_id": "companyId",
-    "department_id": "departmentId",
-    "date_reviewed": "dateReviewed",
-  });
-});
-
-export function inviteesFromJSON(
-  jsonString: string,
-): SafeParseResult<Invitees, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => Invitees$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'Invitees' from JSON`,
-  );
-}
-
-/** @internal */
-export const GetEventGetEventOk$inboundSchema: z.ZodType<
-  GetEventGetEventOk,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  id: types.optional(types.number()),
-  title: types.optional(types.string()),
-  start: types.optional(types.string()),
-  end: types.optional(types.string()),
-  all_day: types.optional(types.boolean()),
-  standing_appt: types.optional(types.boolean()),
-  bringing_food: types.optional(types.boolean()),
-  notes: z.nullable(types.string()).optional(),
-  status: types.optional(types.string()),
-  date_approved: z.nullable(types.string()).optional(),
-  facility: types.optional(
-    smartUnion([types.number(), z.lazy(() => Facility2$inboundSchema)]),
-  ),
-  department: types.optional(
-    smartUnion([types.number(), z.lazy(() => Department2$inboundSchema)]),
-  ),
-  invitees: z.nullable(z.array(z.lazy(() => Invitees$inboundSchema)))
-    .optional(),
-}).transform((v) => {
-  return remap$(v, {
-    "all_day": "allDay",
-    "standing_appt": "standingAppt",
-    "bringing_food": "bringingFood",
-    "date_approved": "dateApproved",
-  });
-});
-
-export function getEventGetEventOkFromJSON(
-  jsonString: string,
-): SafeParseResult<GetEventGetEventOk, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => GetEventGetEventOk$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'GetEventGetEventOk' from JSON`,
-  );
-}

package/src/models/operations/listfeed.ts

@@ -6,7 +6,6 @@ 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";
 
@@ -85,7 +84,7 @@ export type ListFeedListFeedOk = {
    * Pagination information for a pageable list
    */
   pager: components.Pager;
-  items: Array<components.Feed | null>;
+  items: Array<components.Event>;
 };
 
 export type ListFeedResponse = {
@@ -165,7 +164,7 @@ export const ListFeedListFeedOk$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   pager: components.Pager$inboundSchema,
-  items: z.array(types.nullable(components.Feed$inboundSchema)),
+  items: z.array(components.Event$inboundSchema),
 });
 
 export function listFeedListFeedOkFromJSON(

package/src/models/operations/listorsearchvendorinvitees.ts

@@ -35,6 +35,21 @@ export type ListOrSearchVendorInviteesRequest = {
    * Search for objects by the search string
    */
   search?: string | undefined;
+  /**
+   * The vendor whose invitable directory to search. Required when the caller is not itself a
+   *
+   * @remarks
+   * vendor; it is resolved through the caller's own access scope, so it can only name a vendor
+   * the caller may already read. Ignored for a vendor caller, which always searches its own.
+   */
+  vendorId?: number | undefined;
+  /**
+   * Narrows the search to one of the vendor's approved, calendaring-enabled target facilities.
+   *
+   * @remarks
+   * A facility the vendor does not target yields no results rather than widening the search.
+   */
+  facilityId?: number | undefined;
 };
 
 /**
@@ -60,6 +75,8 @@ export type ListOrSearchVendorInviteesRequest$Outbound = {
   items_per_page?: number | undefined;
   expand?: Array<string> | undefined;
   search?: string | undefined;
+  vendor_id?: number | undefined;
+  facility_id?: number | undefined;
 };
 
 /** @internal */
@@ -74,9 +91,13 @@ export const ListOrSearchVendorInviteesRequest$outboundSchema: z.ZodType<
   itemsPerPage: z.number().int().optional(),
   expand: z.array(components.Expand$outboundSchema).optional(),
   search: z.string().optional(),
+  vendorId: z.number().int().optional(),
+  facilityId: z.number().int().optional(),
 }).transform((v) => {
   return remap$(v, {
     itemsPerPage: "items_per_page",
+    vendorId: "vendor_id",
+    facilityId: "facility_id",
   });
 });
 

package/src/models/operations/listpendinginvitations.ts

@@ -6,7 +6,6 @@ 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";
 
@@ -61,7 +60,7 @@ export type ListPendingInvitationsListPendingInvitationsOk = {
    * Pagination information for a pageable list
    */
   pager: components.Pager;
-  items: Array<components.PendingInvitation | null>;
+  items: Array<components.Invite>;
 };
 
 export type ListPendingInvitationsResponse = {
@@ -128,7 +127,7 @@ export const ListPendingInvitationsListPendingInvitationsOk$inboundSchema:
     unknown
   > = z.object({
     pager: components.Pager$inboundSchema,
-    items: z.array(types.nullable(components.PendingInvitation$inboundSchema)),
+    items: z.array(components.Invite$inboundSchema),
   });
 
 export function listPendingInvitationsListPendingInvitationsOkFromJSON(

package/src/models/operations/liststandingappointments.ts

@@ -6,7 +6,6 @@ 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";
 
@@ -85,7 +84,7 @@ export type ListStandingAppointmentsListStandingAppointmentsOk = {
    * Pagination information for a pageable list
    */
   pager: components.Pager;
-  items: Array<components.StandingAppointment | null>;
+  items: Array<components.Event>;
 };
 
 export type ListStandingAppointmentsResponse = {
@@ -170,9 +169,7 @@ export const ListStandingAppointmentsListStandingAppointmentsOk$inboundSchema:
     unknown
   > = z.object({
     pager: components.Pager$inboundSchema,
-    items: z.array(
-      types.nullable(components.StandingAppointment$inboundSchema),
-    ),
+    items: z.array(components.Event$inboundSchema),
   });
 
 export function listStandingAppointmentsListStandingAppointmentsOkFromJSON(

package/src/react-query/eventsCreateEvent.ts

@@ -36,6 +36,7 @@ export type EventsCreateEventMutationData = operations.CreateEventCreateEventOk;
 
 export type EventsCreateEventMutationError =
   | errors.ApiErrorResponse
+  | errors.ApiValidationErrorResponse
   | GreenSecurityError
   | ResponseValidationError
   | ConnectionError

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

@@ -14,7 +14,7 @@ import { RequestOptions } from "../lib/sdks.js";
 import * as components from "../models/components/index.js";
 import * as operations from "../models/operations/index.js";
 import { unwrapAsync } from "../types/fp.js";
-export type EventsGetEventQueryData = operations.GetEventGetEventOk;
+export type EventsGetEventQueryData = components.Event;
 
 export function prefetchEventsGetEvent(
   queryClient: QueryClient,

package/src/react-query/eventsGetEvent.ts

@@ -63,11 +63,18 @@ export type EventsGetEventQueryError =
  *
  * Available `expand` scopes are:
  *
- * - `event.facility`
- * - `event.department`
- * - `event.invitees`
+ * - event.facility
+ * - event.department
+ * - event.invitees
+ * - event.location
+ * - event.attendees
+ * - event.creator
  *
  * Unrecognised values are ignored.
+ *
+ * This route always returns the current `Event` shape, whatever SDK version is calling: it was
+ * introduced after the calendar list endpoints and has never served the older string-valued
+ * shape they did.
  */
 export function useEventsGetEvent(
   request: operations.GetEventRequest,
@@ -94,11 +101,18 @@ export function useEventsGetEvent(
  *
  * Available `expand` scopes are:
  *
- * - `event.facility`
- * - `event.department`
- * - `event.invitees`
+ * - event.facility
+ * - event.department
+ * - event.invitees
+ * - event.location
+ * - event.attendees
+ * - event.creator
  *
  * Unrecognised values are ignored.
+ *
+ * This route always returns the current `Event` shape, whatever SDK version is calling: it was
+ * introduced after the calendar list endpoints and has never served the older string-valued
+ * shape they did.
  */
 export function useEventsGetEventSuspense(
   request: operations.GetEventRequest,