@acms-subir/client 0.1.20 → 0.1.21

package/README.md

@@ -49,6 +49,7 @@ language. Update the site before shipping an app build with a newer client.
 | `calendars()` | Public calendars |
 | `resources(opts)`, `resource(slug, opts)` | Public resources; slug lookup scans list pages |
 | `availability(opts)` | Required `resource`, `link`; optional `from`, `days`, `minutes` |
+| `roomFree({ room, start, end })` | Free or busy for a room the site lets people check, with the busy times and no names; never cached (core 0.3.45+) |
 | `rsvpStatus(slug, { start })` | One event date's RSVP status: `open` or `reason` (`disabled`, `ended`, `closed` past the event's deadline, `cancelled`, `full`), `closesAt` (when RSVPs to the date close, or `null`: open until it ends), live `going`/`left` (held waitlist spots count as taken), `maxSeats` for one RSVP right now, `autoConfirm`, `waitlist` (`enabled`: a full date takes places in line; `waiting` people for `seats` seats; `maxSeats` for one place in line), and `form` (questions and `version`, or `null`). `start` is the occurrence's start exactly as `events()` returns it (a UTC ISO string such as `2026-10-05T14:00:00.000Z`). Never cached |
 | `book(opts)` | Resource booking or RSVP input (`RsvpInput` for an RSVP; `waitlist: true` joins a full date's waitlist, status `waitlisted`), optional `idempotencyKey`; sends the client's `locale` (or `opts.locale`) for its emails |
 | `openapi()` | Raw OpenAPI document |

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import type { Site, Theme, Page, Content, Post, ContentList, SearchResults, Links, Form, FormReceipt, FormResponseInput, ManagedBooking, RescheduleInput, ManageAvailabilityQuery, GuestCodeSent, GuestToken, GuestBookings, GuestBookingsQuery, GuestSignedOut, Events, Event, Calendars, Resources, Resource, Availability, BookingInput, BookingResult, RsvpStatus, Device, DeviceInput, DeviceUpdate, DeviceRegistration, DeviceRemoved, StaffLink, PushTopics, LiveStatus, Announcements, AnnouncementDetail, EventDetail } from './types.js';
+import type { Site, Theme, Page, Content, Post, ContentList, SearchResults, Links, Form, FormReceipt, FormResponseInput, ManagedBooking, RescheduleInput, ManageAvailabilityQuery, GuestCodeSent, GuestToken, GuestBookings, GuestBookingsQuery, GuestSignedOut, Events, Event, Calendars, Resources, Resource, Availability, BookingInput, BookingResult, RsvpStatus, Device, DeviceInput, DeviceUpdate, DeviceRegistration, DeviceRemoved, StaffLink, PushTopics, LiveStatus, Announcements, AnnouncementDetail, EventDetail, RoomFree } from './types.js';
 export { AcmsError, isAcmsError } from './errors.js';
 export type * from './types.js';
 export * from './editor.js';
@@ -60,6 +60,12 @@ export interface AvailabilityOptions extends RequestOptions {
 export interface RsvpStatusOptions extends RequestOptions {
     start: string;
 }
+/** A room's slug and a span: each bound a site-local day (its midnight) or an ISO date-time with a zone; at most 31 days. */
+export interface RoomFreeOptions extends RequestOptions {
+    room: string;
+    start: EventBound | (string & {});
+    end: EventBound | (string & {});
+}
 export type BookOptions = BookingInput & RequestOptions & {
     idempotencyKey?: string;
 };
@@ -145,6 +151,10 @@ export declare const endpoints: {
         readonly method: "GET";
         readonly path: "/availability";
     };
+    readonly roomFree: {
+        readonly method: "GET";
+        readonly path: "/rooms/free";
+    };
     readonly book: {
         readonly method: "POST";
         readonly path: "/bookings";
@@ -276,6 +286,11 @@ export interface AcmsClient {
      * RSVP with `book({ event, start, seats, name, email, answers, formVersion: form.version })`.
      */
     rsvpStatus(slug: string, o: RsvpStatusOptions): Promise<RsvpStatus>;
+    /**
+     * Whether a room is free over a span (`free`), and its taken times (`busy`), never what or who. Only rooms the site
+     * lets people check answer; others are a 404. Never cached; 30 checks a minute. Requires bookings and core 0.3.45.
+     */
+    roomFree(o: RoomFreeOptions): Promise<RoomFree>;
     /** A room booking or an RSVP. Sends the client's `locale` (or `o.locale`), so its emails and links speak it. */
     book(o: BookOptions): Promise<BookingResult>;
     openapi(o?: RequestOptions): Promise<OpenApiDocument>;

package/dist/index.js

@@ -11,6 +11,8 @@ export const endpoints = {
     // an event date's RSVP status: live seats and questions (never cached); RSVP with book()
     rsvpStatus: { method: 'GET', path: '/events/{slug}/rsvp' },
     resources: { method: 'GET', path: '/resources' }, availability: { method: 'GET', path: '/availability' },
+    // free or busy for a room people may request (no names; never cached)
+    roomFree: { method: 'GET', path: '/rooms/free' },
     book: { method: 'POST', path: '/bookings' }, openapi: { method: 'GET', path: '/openapi.json' },
     // push notifications (only when the site enables push; 404 otherwise)
     registerDevice: { method: 'POST', path: '/devices' }, updateDevice: { method: 'PUT', path: '/devices/{token}' },
@@ -119,7 +121,7 @@ export function createClient(options) {
         const timer = setTimeout(() => controller.abort(new AcmsError(0, 'timeout', 'Request timed out.', undefined, undefined, key)), timeoutMs);
         const signal = controller.signal;
         // availability, live status and RSVP seats are never served from the cache
-        const cacheable = endpoint.method === 'GET' && name !== 'availability' && name !== 'live' && name !== 'rsvpStatus' && !extra.headers && cache;
+        const cacheable = endpoint.method === 'GET' && name !== 'availability' && name !== 'live' && name !== 'rsvpStatus' && name !== 'roomFree' && !extra.headers && cache;
         // only replay what the server treats as repeatable: a lost reply to a code
         // exchange or a move must not run it twice
         const replayable = endpoint.method !== 'POST' || !!key || name === 'registerDevice';
@@ -293,6 +295,7 @@ export function createClient(options) {
         calendars: (o = {}) => request('calendars', o),
         availability: (o) => request('availability', o, { resource: o.resource, link: o.link, from: o.from, days: o.days, minutes: o.minutes }),
         rsvpStatus: (slug, o) => request('rsvpStatus', o, { start: o.start }, slug),
+        roomFree: (o) => request('roomFree', o, { room: o.room, start: o.start, end: o.end }),
         async book(o) {
             const { locale = options.locale, signal, idempotencyKey, ...body } = o;
             const key = idempotencyKey ?? defaultHeaders.get('Idempotency-Key') ?? uuid();

package/dist/types.d.ts

@@ -181,6 +181,11 @@ export type Page = {
         };
     }>;
 };
+export type EventRoom = {
+    "slug": string;
+    "name": string;
+    "color": string | null;
+};
 export type Event = {
     "id": string;
     "slug": string;
@@ -254,6 +259,11 @@ export type Event = {
         "name": string;
         "color": string;
     }>;
+    "rooms": Array<{
+        "slug": string;
+        "name": string;
+        "color": string | null;
+    }>;
     "notify": {
         "changes": Array<string>;
     };
@@ -274,6 +284,11 @@ export type Events = {
         "end": string;
         "allDay": boolean;
         "cancelled": boolean;
+        "rooms": Array<{
+            "slug": string;
+            "name": string;
+            "color": string | null;
+        }>;
         "event": {
             "id": string;
             "slug": string;
@@ -347,6 +362,11 @@ export type Events = {
                 "name": string;
                 "color": string;
             }>;
+            "rooms": Array<{
+                "slug": string;
+                "name": string;
+                "color": string | null;
+            }>;
             "notify": {
                 "changes": Array<string>;
             };
@@ -361,6 +381,11 @@ export type EventDetail = {
         "end": string;
         "allDay": boolean;
         "cancelled": boolean;
+        "rooms": Array<{
+            "slug": string;
+            "name": string;
+            "color": string | null;
+        }>;
     }) | (null);
     "event": {
         "id": string;
@@ -435,6 +460,11 @@ export type EventDetail = {
             "name": string;
             "color": string;
         }>;
+        "rooms": Array<{
+            "slug": string;
+            "name": string;
+            "color": string | null;
+        }>;
         "notify": {
             "changes": Array<string>;
         };
@@ -502,6 +532,11 @@ export type SearchResults = {
             "end": string;
             "allDay": boolean;
             "cancelled": boolean;
+            "rooms": Array<{
+                "slug": string;
+                "name": string;
+                "color": string | null;
+            }>;
         }) | (null);
         "event": {
             "id": string;
@@ -576,6 +611,11 @@ export type SearchResults = {
                 "name": string;
                 "color": string;
             }>;
+            "rooms": Array<{
+                "slug": string;
+                "name": string;
+                "color": string | null;
+            }>;
             "notify": {
                 "changes": Array<string>;
             };
@@ -876,6 +916,19 @@ export type Resources = {
         }>;
     }>;
 };
+export type RoomFree = {
+    "room": {
+        "slug": string;
+        "name": string;
+    };
+    "start": string;
+    "end": string;
+    "free": boolean;
+    "busy": Array<{
+        "start": string;
+        "end": string;
+    }>;
+};
 export type Availability = {
     "timezone": string;
     "mode": "slots" | "day" | "range";
@@ -1739,6 +1792,9 @@ export type EditorResource = {
     "notifyEmails": Array<string>;
     "visibility": "public" | "unlisted";
     "showOnCalendar": boolean;
+    "color": string;
+    "showOnEvents": boolean;
+    "requestable": boolean;
     "placeId": string;
     "order": number;
     "createdAt": string;
@@ -1873,6 +1929,9 @@ export type EditorResourceList = {
         "notifyEmails": Array<string>;
         "visibility": "public" | "unlisted";
         "showOnCalendar": boolean;
+        "color": string;
+        "showOnEvents": boolean;
+        "requestable": boolean;
         "placeId": string;
         "order": number;
         "createdAt": string;
@@ -2336,6 +2395,9 @@ export type EditorResourceInput = {
     "visibility"?: "public" | "unlisted";
     "showOnCalendar"?: boolean;
     "placeId"?: string;
+    "color"?: ("") | (string);
+    "showOnEvents"?: boolean;
+    "requestable"?: boolean;
     "busyFeeds"?: Array<string>;
     "notifyEmails"?: Array<string>;
 };
@@ -2390,6 +2452,9 @@ export type EditorResourcePatch = {
     "visibility"?: "public" | "unlisted";
     "showOnCalendar"?: boolean;
     "placeId"?: string;
+    "color"?: ("") | (string);
+    "showOnEvents"?: boolean;
+    "requestable"?: boolean;
     "busyFeeds"?: Array<string>;
     "notifyEmails"?: Array<string>;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acms-subir/client",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "description": "Typed, dependency-free client for the ACMS public mobile API.",
   "type": "module",
   "license": "MIT",