@acms-subir/client 0.1.15 → 0.1.17

package/README.md

@@ -27,8 +27,11 @@ raw document. Every method accepts `locale` and `signal` in its options object.
 Locale is sent only for routes that support translations. `withLocale` shares
 the cache and transport configuration with the original client. `site()` and
 `pushTopics()` take a language since core 0.3.32; an older site rejects it, so
-the client asks once more without it and gets the main language. Update the
-site before shipping an app build with a newer client.
+the client asks once more without it and gets the main language. `book()`
+sends the client's `locale` in its body, so the booking's emails (and the links
+in them) speak the app's language; a site before core 0.3.38 refuses that field,
+so the client books once more without it, with the same key, in the site's main
+language. Update the site before shipping an app build with a newer client.
 
 | Method | Options / behavior |
 | --- | --- |
@@ -45,8 +48,8 @@ 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` |
-| `rsvpStatus(slug, { start })` | One event date's RSVP status: `open` or `reason` (`disabled`, `ended`, `cancelled`, `full`), live `going`/`left`, `maxSeats` for one RSVP right now, `autoConfirm`, 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), optional `idempotencyKey` |
+| `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`, `maxSeats` for one RSVP right now, `autoConfirm`, 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), optional `idempotencyKey`; sends the client's `locale` (or `opts.locale`) for its emails |
 | `openapi()` | Raw OpenAPI document |
 | `registerDevice({ token, platform, locale?, topics?, channels? })` | Register or refresh an Expo push token (call on every app start); `{ created, device }`. `channels`: Android channels the app created (e.g. `['urgent']`) |
 | `updateDevice(token, { topics?, locale?, channels? })` | Change a device's topics, language or channels |
@@ -118,6 +121,7 @@ if (status.open) {
     // required when the event asks questions: a changed form answers 409, so read the status again
     ...(status.form ? { formVersion: status.form.version } : {}),
   };
+  // an email that already has an RSVP for this date: AcmsError 409 with code 'duplicate' (its link is emailed again)
   const result = await client.book({ ...rsvp, idempotencyKey: crypto.randomUUID() });
   // pending when the organiser approves RSVPs; status.form?.confirmation is the thank-you text.
   // result.manageToken changes or cancels it later (manageBooking, cancelBooking), like the email's link:

package/dist/index.d.ts

@@ -255,6 +255,7 @@ export interface AcmsClient {
      * RSVP with `book({ event, start, seats, name, email, answers, formVersion: form.version })`.
      */
     rsvpStatus(slug: string, o: RsvpStatusOptions): Promise<RsvpStatus>;
+    /** 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>;
     /** Register or refresh this device's Expo push token. Call on every app start. Requires push on the site. */

package/dist/index.js

@@ -280,10 +280,22 @@ 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),
-        book: (o) => {
-            const { locale, signal, idempotencyKey, ...body } = o;
+        async book(o) {
+            const { locale = options.locale, signal, idempotencyKey, ...body } = o;
             const key = idempotencyKey ?? defaultHeaders.get('Idempotency-Key') ?? uuid();
-            return request('book', { locale, signal }, {}, undefined, body, key);
+            // the client's language rides in the body: the booking's emails and links speak it
+            if (locale === undefined)
+                return request('book', { signal }, {}, undefined, body, key);
+            try {
+                return await request('book', { signal }, {}, undefined, { ...body, locale }, key);
+            }
+            catch (error) {
+                // sites before core 0.3.38 refuse the field (and one the site doesn't have): book without it, in
+                // the site's main language. A refused request doesn't use up the key.
+                if (!(error instanceof AcmsError) || error.status !== 400 || !/locale/i.test(JSON.stringify([error.message, error.issues ?? []])))
+                    throw error;
+                return request('book', { signal }, {}, undefined, body, key);
+            }
         },
         openapi: (o = {}) => request('openapi', o),
         registerDevice: (input, o = {}) => request('registerDevice', o, {}, undefined, input),

package/dist/types.d.ts

@@ -221,6 +221,8 @@ export type Event = {
         "capacity": number;
         "autoConfirm": boolean;
         "maxSeats": number;
+        "closesAt": string | null;
+        "closeBefore": number;
         "form"?: {
             "title": string;
             "intro": string;
@@ -251,6 +253,9 @@ export type Event = {
         "name": string;
         "color": string;
     }>;
+    "notify": {
+        "changes": Array<string>;
+    };
 };
 export type Events = {
     "locale": string | null;
@@ -308,6 +313,8 @@ export type Events = {
                 "capacity": number;
                 "autoConfirm": boolean;
                 "maxSeats": number;
+                "closesAt": string | null;
+                "closeBefore": number;
                 "form"?: {
                     "title": string;
                     "intro": string;
@@ -338,6 +345,9 @@ export type Events = {
                 "name": string;
                 "color": string;
             }>;
+            "notify": {
+                "changes": Array<string>;
+            };
         };
     }>;
 };
@@ -444,6 +454,8 @@ export type SearchResults = {
                 "capacity": number;
                 "autoConfirm": boolean;
                 "maxSeats": number;
+                "closesAt": string | null;
+                "closeBefore": number;
                 "form"?: {
                     "title": string;
                     "intro": string;
@@ -474,6 +486,9 @@ export type SearchResults = {
                 "name": string;
                 "color": string;
             }>;
+            "notify": {
+                "changes": Array<string>;
+            };
         };
     }>;
     "more": {
@@ -601,12 +616,13 @@ export type RsvpStatus = {
     "start": string;
     "end": string;
     "open": boolean;
-    "reason": ("disabled" | "ended" | "cancelled" | "full") | (null);
+    "reason": ("disabled" | "ended" | "closed" | "cancelled" | "full") | (null);
     "going": number;
     "left": (number) | (null);
     "capacity": number;
     "maxSeats": number;
     "autoConfirm": boolean;
+    "closesAt": (string) | (null);
     "form": ({
         "version": string;
         "title": string;
@@ -958,7 +974,7 @@ export type LiveStatus = {
 export type ApiErrorResponse = {
     "version": 1;
     "error": {
-        "code": "invalid_request" | "unauthorized" | "forbidden" | "not_found" | "method_not_allowed" | "conflict" | "gone" | "payload_too_large" | "unsupported_media_type" | "rate_limited" | "upstream_error" | "internal_error";
+        "code": "invalid_request" | "unauthorized" | "forbidden" | "not_found" | "method_not_allowed" | "conflict" | "duplicate" | "gone" | "payload_too_large" | "unsupported_media_type" | "rate_limited" | "upstream_error" | "internal_error";
         "message": string;
         "issues"?: Array<{
             "path": Array<string | number>;
@@ -1144,6 +1160,8 @@ export type EditorDocument = {
             "capacity": number;
             "autoConfirm": boolean;
             "maxSeats": number;
+            "closesAt": string | null;
+            "closeBefore": number;
             "form"?: {
                 "title": string;
                 "intro": string;
@@ -1963,6 +1981,7 @@ export type BookingInput = ({
     "answers"?: {
         [key: string]: (string) | (Array<string>);
     };
+    "locale"?: string;
     "resource": string;
     "link": string;
     "minutes"?: number;
@@ -1974,6 +1993,7 @@ export type BookingInput = ({
     "answers"?: {
         [key: string]: (string) | (Array<string>);
     };
+    "locale"?: string;
     "event": string;
     "seats"?: number;
     "formVersion"?: string;
@@ -2072,6 +2092,8 @@ export type EditorSaveInput = {
             "capacity": number;
             "autoConfirm": boolean;
             "maxSeats": number;
+            "closesAt"?: (string) | (null);
+            "closeBefore"?: number;
             "form"?: {
                 "title"?: string;
                 "intro"?: string;

package/package.json

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