@greensecurity/javascript-sdk 0.45.0-beta.26 → 0.45.0-beta.28

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,

package/src/react-query/eventsListFeed.ts

@@ -75,9 +75,21 @@ export type EventsListFeedQueryError =
  * List events feed
  *
  * @remarks
- * List events feed
+ * List events feed.
+ *
+ * **Permissions.** Requires a valid token. This endpoint is not gated on a named permission -
+ * the caller's role and their relationship to the record decide what is returned.
+ *
+ * Returns `Event` items with the `event.creator` and `event.invitees` scopes already applied,
+ * so `event_creator`, `event_creator_img_url` and `invitees` are populated — the fields this
+ * feed has always carried. SDK builds below `0.55.0-beta.1` receive the older `Feed` shape
+ * instead, in which `facility` and `department` are name strings rather than ids; the server
+ * chooses by the `X-SDK-User-Agent` header the SDK sends, so an existing client keeps the
+ * shape it was generated against until it is regenerated.
  *
- * **Permissions.** Requires a valid token. This endpoint is not gated on a named permission - the caller's role and their relationship to the record decide what is returned.
+ * The boundary is the prerelease build `0.55.0-beta.1`, not the `0.55.0` release, so
+ * `0.55.0-beta.1` itself already receives `Event`. See the `Event` schema for exactly how a
+ * build is compared against it.
  */
 export function useEventsListFeed(
   request: operations.ListFeedRequest,
@@ -98,9 +110,21 @@ export function useEventsListFeed(
  * List events feed
  *
  * @remarks
- * List events feed
+ * List events feed.
+ *
+ * **Permissions.** Requires a valid token. This endpoint is not gated on a named permission -
+ * the caller's role and their relationship to the record decide what is returned.
+ *
+ * Returns `Event` items with the `event.creator` and `event.invitees` scopes already applied,
+ * so `event_creator`, `event_creator_img_url` and `invitees` are populated — the fields this
+ * feed has always carried. SDK builds below `0.55.0-beta.1` receive the older `Feed` shape
+ * instead, in which `facility` and `department` are name strings rather than ids; the server
+ * chooses by the `X-SDK-User-Agent` header the SDK sends, so an existing client keeps the
+ * shape it was generated against until it is regenerated.
  *
- * **Permissions.** Requires a valid token. This endpoint is not gated on a named permission - the caller's role and their relationship to the record decide what is returned.
+ * The boundary is the prerelease build `0.55.0-beta.1`, not the `0.55.0` release, so
+ * `0.55.0-beta.1` itself already receives `Event`. See the `Event` schema for exactly how a
+ * build is compared against it.
  */
 export function useEventsListFeedSuspense(
   request: operations.ListFeedRequest,
@@ -124,9 +148,21 @@ export function useEventsListFeedSuspense(
  * List events feed
  *
  * @remarks
- * List events feed
+ * List events feed.
+ *
+ * **Permissions.** Requires a valid token. This endpoint is not gated on a named permission -
+ * the caller's role and their relationship to the record decide what is returned.
+ *
+ * Returns `Event` items with the `event.creator` and `event.invitees` scopes already applied,
+ * so `event_creator`, `event_creator_img_url` and `invitees` are populated — the fields this
+ * feed has always carried. SDK builds below `0.55.0-beta.1` receive the older `Feed` shape
+ * instead, in which `facility` and `department` are name strings rather than ids; the server
+ * chooses by the `X-SDK-User-Agent` header the SDK sends, so an existing client keeps the
+ * shape it was generated against until it is regenerated.
  *
- * **Permissions.** Requires a valid token. This endpoint is not gated on a named permission - the caller's role and their relationship to the record decide what is returned.
+ * The boundary is the prerelease build `0.55.0-beta.1`, not the `0.55.0` release, so
+ * `0.55.0-beta.1` itself already receives `Event`. See the `Event` schema for exactly how a
+ * build is compared against it.
  */
 export function useEventsListFeedInfinite(
   request: operations.ListFeedRequest,
@@ -161,9 +197,21 @@ export function useEventsListFeedInfinite(
  * List events feed
  *
  * @remarks
- * List events feed
+ * List events feed.
+ *
+ * **Permissions.** Requires a valid token. This endpoint is not gated on a named permission -
+ * the caller's role and their relationship to the record decide what is returned.
+ *
+ * Returns `Event` items with the `event.creator` and `event.invitees` scopes already applied,
+ * so `event_creator`, `event_creator_img_url` and `invitees` are populated — the fields this
+ * feed has always carried. SDK builds below `0.55.0-beta.1` receive the older `Feed` shape
+ * instead, in which `facility` and `department` are name strings rather than ids; the server
+ * chooses by the `X-SDK-User-Agent` header the SDK sends, so an existing client keeps the
+ * shape it was generated against until it is regenerated.
  *
- * **Permissions.** Requires a valid token. This endpoint is not gated on a named permission - the caller's role and their relationship to the record decide what is returned.
+ * The boundary is the prerelease build `0.55.0-beta.1`, not the `0.55.0` release, so
+ * `0.55.0-beta.1` itself already receives `Event`. See the `Event` schema for exactly how a
+ * build is compared against it.
  */
 export function useEventsListFeedInfiniteSuspense(
   request: operations.ListFeedRequest,

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

@@ -81,6 +81,8 @@ export function buildEventsListOrSearchVendorInviteesQuery(
       itemsPerPage: request.itemsPerPage,
       expand: request.expand,
       search: request.search,
+      vendorId: request.vendorId,
+      facilityId: request.facilityId,
     }),
     queryFn: async function eventsListOrSearchVendorInviteesQueryFn(
       ctx,
@@ -126,6 +128,8 @@ export function buildEventsListOrSearchVendorInviteesInfiniteQuery(
       itemsPerPage: request.itemsPerPage,
       expand: request.expand,
       search: request.search,
+      vendorId: request.vendorId,
+      facilityId: request.facilityId,
     }),
     queryFn: async function eventsListOrSearchVendorInviteesQuery(
       ctx,
@@ -169,6 +173,8 @@ export function queryKeyEventsListOrSearchVendorInvitees(
     itemsPerPage?: number | undefined;
     expand?: Array<components.Expand> | undefined;
     search?: string | undefined;
+    vendorId?: number | undefined;
+    facilityId?: number | undefined;
   },
 ): QueryKey {
   return [
@@ -187,6 +193,8 @@ export function queryKeyEventsListOrSearchVendorInviteesInfinite(
     itemsPerPage?: number | undefined;
     expand?: Array<components.Expand> | undefined;
     search?: string | undefined;
+    vendorId?: number | undefined;
+    facilityId?: number | undefined;
   },
 ): QueryKey {
   return [

package/src/react-query/eventsListOrSearchVendorInvitees.ts

@@ -261,6 +261,8 @@ export function setEventsListOrSearchVendorInviteesData(
       itemsPerPage?: number | undefined;
       expand?: Array<components.Expand> | undefined;
       search?: string | undefined;
+      vendorId?: number | undefined;
+      facilityId?: number | undefined;
     },
   ],
   data: EventsListOrSearchVendorInviteesQueryData,
@@ -283,6 +285,8 @@ export function invalidateEventsListOrSearchVendorInvitees(
       itemsPerPage?: number | undefined;
       expand?: Array<components.Expand> | undefined;
       search?: string | undefined;
+      vendorId?: number | undefined;
+      facilityId?: number | undefined;
     }]
   >,
   filters?: Omit<InvalidateQueryFilters, "queryKey" | "predicate" | "exact">,

package/src/react-query/eventsListPendingInvitations.ts

@@ -75,9 +75,21 @@ export type EventsListPendingInvitationsQueryError =
  * List pending invitations
  *
  * @remarks
- * List pending invitations
+ * List pending invitations.
+ *
+ * **Permissions.** Requires a valid token. This endpoint is not gated on a named permission -
+ * the caller's role and their relationship to the record decide what is returned.
+ *
+ * Returns `Invite` items with the `invite.event` and `invite.invitee` scopes already applied,
+ * so `event` is the expanded `{ id, name }` summary rather than a bare id, and `invitee` is
+ * populated — the appointment and the recipient this list has always named. This endpoint
+ * takes no `expand` parameter; both scopes are applied on every call and cannot be turned off.
+ * SDK builds below `0.55.0-beta.1` receive the older `PendingInvitation` shape instead, which
+ * embeds the appointment.
  *
- * **Permissions.** Requires a valid token. This endpoint is not gated on a named permission - the caller's role and their relationship to the record decide what is returned.
+ * The boundary is the prerelease build `0.55.0-beta.1`, not the `0.55.0` release, so
+ * `0.55.0-beta.1` itself already receives `Invite`. See the `Invite` schema for exactly how a
+ * build is compared against it.
  */
 export function useEventsListPendingInvitations(
   request: operations.ListPendingInvitationsRequest,
@@ -104,9 +116,21 @@ export function useEventsListPendingInvitations(
  * List pending invitations
  *
  * @remarks
- * List pending invitations
+ * List pending invitations.
+ *
+ * **Permissions.** Requires a valid token. This endpoint is not gated on a named permission -
+ * the caller's role and their relationship to the record decide what is returned.
+ *
+ * Returns `Invite` items with the `invite.event` and `invite.invitee` scopes already applied,
+ * so `event` is the expanded `{ id, name }` summary rather than a bare id, and `invitee` is
+ * populated — the appointment and the recipient this list has always named. This endpoint
+ * takes no `expand` parameter; both scopes are applied on every call and cannot be turned off.
+ * SDK builds below `0.55.0-beta.1` receive the older `PendingInvitation` shape instead, which
+ * embeds the appointment.
  *
- * **Permissions.** Requires a valid token. This endpoint is not gated on a named permission - the caller's role and their relationship to the record decide what is returned.
+ * The boundary is the prerelease build `0.55.0-beta.1`, not the `0.55.0` release, so
+ * `0.55.0-beta.1` itself already receives `Invite`. See the `Invite` schema for exactly how a
+ * build is compared against it.
  */
 export function useEventsListPendingInvitationsSuspense(
   request: operations.ListPendingInvitationsRequest,
@@ -133,9 +157,21 @@ export function useEventsListPendingInvitationsSuspense(
  * List pending invitations
  *
  * @remarks
- * List pending invitations
+ * List pending invitations.
+ *
+ * **Permissions.** Requires a valid token. This endpoint is not gated on a named permission -
+ * the caller's role and their relationship to the record decide what is returned.
+ *
+ * Returns `Invite` items with the `invite.event` and `invite.invitee` scopes already applied,
+ * so `event` is the expanded `{ id, name }` summary rather than a bare id, and `invitee` is
+ * populated — the appointment and the recipient this list has always named. This endpoint
+ * takes no `expand` parameter; both scopes are applied on every call and cannot be turned off.
+ * SDK builds below `0.55.0-beta.1` receive the older `PendingInvitation` shape instead, which
+ * embeds the appointment.
  *
- * **Permissions.** Requires a valid token. This endpoint is not gated on a named permission - the caller's role and their relationship to the record decide what is returned.
+ * The boundary is the prerelease build `0.55.0-beta.1`, not the `0.55.0` release, so
+ * `0.55.0-beta.1` itself already receives `Invite`. See the `Invite` schema for exactly how a
+ * build is compared against it.
  */
 export function useEventsListPendingInvitationsInfinite(
   request: operations.ListPendingInvitationsRequest,
@@ -176,9 +212,21 @@ export function useEventsListPendingInvitationsInfinite(
  * List pending invitations
  *
  * @remarks
- * List pending invitations
+ * List pending invitations.
+ *
+ * **Permissions.** Requires a valid token. This endpoint is not gated on a named permission -
+ * the caller's role and their relationship to the record decide what is returned.
+ *
+ * Returns `Invite` items with the `invite.event` and `invite.invitee` scopes already applied,
+ * so `event` is the expanded `{ id, name }` summary rather than a bare id, and `invitee` is
+ * populated — the appointment and the recipient this list has always named. This endpoint
+ * takes no `expand` parameter; both scopes are applied on every call and cannot be turned off.
+ * SDK builds below `0.55.0-beta.1` receive the older `PendingInvitation` shape instead, which
+ * embeds the appointment.
  *
- * **Permissions.** Requires a valid token. This endpoint is not gated on a named permission - the caller's role and their relationship to the record decide what is returned.
+ * The boundary is the prerelease build `0.55.0-beta.1`, not the `0.55.0` release, so
+ * `0.55.0-beta.1` itself already receives `Invite`. See the `Invite` schema for exactly how a
+ * build is compared against it.
  */
 export function useEventsListPendingInvitationsInfiniteSuspense(
   request: operations.ListPendingInvitationsRequest,