@acms-subir/client 0.1.12 → 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 |
 | --- | --- |

package/dist/index.js

@@ -27,6 +27,8 @@ export const endpoints = {
 };
 // 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();
@@ -98,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));
@@ -178,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/package.json

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