@acms-subir/client 0.1.11 → 0.1.13

package/README.md

@@ -25,7 +25,10 @@ const english = client.withLocale('en');
 hosting prefix. All methods return **unwrapped `data`**; `openapi()` returns the
 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.
+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.
 
 | Method | Options / behavior |
 | --- | --- |
@@ -47,7 +50,7 @@ the cache and transport configuration with the original client.
 | `registerDevice({ token, platform, locale?, topics? })` | Register or refresh an Expo push token (call on every app start); `{ created, device }` |
 | `updateDevice(token, { topics?, locale? })` | Change a device's topics or language |
 | `unregisterDevice(token)` | Opt out (idempotent) |
-| `pushTopics()` | Topics to offer as notification toggles |
+| `pushTopics()` | Topics to offer as notification toggles, named in the client's language (built-in and the site's own, `kind: 'site'`) |
 | `links()` | The links page: profile, socials and visible blocks (`link`, `email`, `phone`, `contact`, `heading`, `text`, `spacer`, `live`, `embed`) |
 | `live()` | Live video: the current broadcast (`snapshot` or `null`), `serverNow` and the owner's `display` choices. Never cached; 404 while `site.features.live` is false |
 | `form(id)`, `submitForm(id, { answers, version?, idempotencyKey? })` | A published form's questions; send answers (checkbox groups as arrays). Each call makes one key; retries reuse it |

package/dist/index.js

@@ -25,7 +25,10 @@ export const endpoints = {
     requestGuestCode: { method: 'POST', path: '/guest/code' }, guestSignIn: { method: 'POST', path: '/guest/token' },
     guestBookings: { method: 'GET', path: '/guest/bookings' }, guestSignOut: { method: 'POST', path: '/guest/revoke' },
 };
-const localized = new Set(['home', 'page', 'content', 'contentById', 'search', 'events']);
+// site: its legal links; pushTopics: topic names
+const localized = new Set(['home', 'page', 'content', 'contentById', 'search', 'events', 'site', 'pushTopics']);
+// localized since core 0.3.32; older sites answer ?locale= with a 400, so ask them again without it
+const lateLocalized = new Set(['site', 'pushTopics']);
 function uuid() {
     if (globalThis.crypto?.randomUUID)
         return globalThis.crypto.randomUUID();
@@ -97,7 +100,7 @@ export function createClient(options) {
             if (v !== undefined)
                 url.searchParams.set(k, String(v));
         const locale = opts.locale ?? options.locale;
-        if (localized.has(name) && locale !== undefined)
+        if (localized.has(name) && locale !== undefined && !extra.noLocale)
             url.searchParams.set('locale', locale);
         const controller = new AbortController();
         const abort = () => controller.abort(new AcmsError(0, 'aborted', 'Request aborted.', undefined, undefined, key));
@@ -177,6 +180,9 @@ export function createClient(options) {
                     }
                     throw new AcmsError(res.status, res.ok ? 'invalid_response' : 'http_error', `HTTP ${res.status}: expected a JSON response.`, retryAfter, undefined, key);
                 }
+                // a site older than the client: unlocalized words beat no site info at all
+                if (res.status === 400 && lateLocalized.has(name) && url.searchParams.has('locale') && /locale/i.test(JSON.stringify(json?.error ?? '')))
+                    return await request(name, opts, query, param, payload, key, { ...extra, noLocale: true });
                 if (!res.ok)
                     throw new AcmsError(res.status, json?.error?.code ?? 'http_error', json?.error?.message ?? `HTTP ${res.status}`, retryAfter, json?.error?.issues, key);
                 if (name !== 'openapi' && (json?.version !== 1 || !Object.prototype.hasOwnProperty.call(json, 'data')))

package/dist/types.d.ts

@@ -806,10 +806,12 @@ export type DeviceRemoved = {
     "deleted": true;
 };
 export type PushTopics = {
+    "locale": string | null;
     "topics": Array<{
         "id": string;
         "label": string;
-        "kind": "general" | "collection" | "calendar";
+        "kind": "general" | "collection" | "calendar" | "site";
+        "description"?: string;
     }>;
 };
 export type LiveSnapshot = {

package/package.json

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