@aglyn/aglyn 1.0.0-beta.243 → 1.0.0-beta.246

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aglyn/aglyn",
-  "version": "1.0.0-beta.243",
+  "version": "1.0.0-beta.246",
   "license": "Apache-2.0",
   "homepage": "https://aglyn.com",
   "repository": {
@@ -37,16 +37,16 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@aglyn/shared-data-enums": "1.0.0-beta.243",
-    "@aglyn/shared-data-mdi": "1.0.0-beta.243",
-    "@aglyn/shared-data-types": "1.0.0-beta.243",
-    "@aglyn/shared-util-email": "1.0.0-beta.243",
-    "@aglyn/shared-util-first-touch": "1.0.0-beta.243",
-    "@aglyn/shared-util-http": "1.0.0-beta.243",
-    "@aglyn/shared-util-logger": "1.0.0-beta.243",
-    "@aglyn/shared-util-timestamp": "1.0.0-beta.243",
-    "@aglyn/shared-util-tools": "1.0.0-beta.243",
-    "@aglyn/shared-util-vendor": "1.0.0-beta.243",
+    "@aglyn/shared-data-enums": "1.0.0-beta.246",
+    "@aglyn/shared-data-mdi": "1.0.0-beta.246",
+    "@aglyn/shared-data-types": "1.0.0-beta.246",
+    "@aglyn/shared-util-email": "1.0.0-beta.246",
+    "@aglyn/shared-util-first-touch": "1.0.0-beta.246",
+    "@aglyn/shared-util-http": "1.0.0-beta.246",
+    "@aglyn/shared-util-logger": "1.0.0-beta.246",
+    "@aglyn/shared-util-timestamp": "1.0.0-beta.246",
+    "@aglyn/shared-util-tools": "1.0.0-beta.246",
+    "@aglyn/shared-util-vendor": "1.0.0-beta.246",
     "@data-driven-forms/react-form-renderer": "^4.2.0",
     "@msgpack/msgpack": "^3.1.3",
     "@types/unist": "^3.0.3",

package/src/lib/app-utils/browser-family.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * The coarse browser FAMILY an error report carries (AGL-3732).
+ *
+ * React #418 kept arriving from en-GB visitors on aglyn.com with no
+ * translator on the page and no way to reproduce it, and the report could not
+ * say what browser it came from. This answers that one question and nothing
+ * finer: one family out of seven, never the user-agent string and never a
+ * version, so it narrows a cluster without identifying a visitor.
+ *
+ * Order matters, and every test reads a token the browser itself puts there:
+ *
+ * - **webview first.** An Android WebView marks itself `; wv)`. On iOS every
+ *   browser is WebKit; Safari and the real third-party browsers say who they
+ *   are (`Safari/`, `CriOS`, `FxiOS`, `EdgiOS`), and an app's WKWebView —
+ *   Instagram, Facebook, a mail client — carries no `Safari/` token, or its
+ *   own `FBAN`/`Instagram` marker. An in-app browser injects into and
+ *   rewrites the DOM, which is exactly what a hydration mismatch looks like,
+ *   so it is its own family.
+ * - **edge and samsung before chrome**, because both also say `Chrome/`.
+ * - **firefox** on `Firefox/` and `FxiOS`.
+ * - **chrome** on `Chrome/`/`CriOS`/`Chromium`; Chromium brands that rename
+ *   themselves (Opera's `OPR/`, Yandex's `YaBrowser/`) are `other`.
+ * - **safari** last: `Safari/` with no Chromium token.
+ *
+ * Pure and total: anything it cannot place, including no string at all, is
+ * `other`. No `'use client'` — see the note atop `error-beacon.ts`; the
+ * ingest route imports {@link isBrowserFamily} on the server.
+ */
+export declare const BROWSER_FAMILIES: readonly ["safari", "chrome", "firefox", "edge", "samsung", "webview", "other"];
+export type BrowserFamily = (typeof BROWSER_FAMILIES)[number];
+/** True only for one of the seven values the beacon writes. */
+export declare function isBrowserFamily(value: unknown): value is BrowserFamily;
+export declare function browserFamily(userAgent: unknown): BrowserFamily;

package/src/lib/app-utils/browser-family.js

@@ -0,0 +1,78 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * The coarse browser FAMILY an error report carries (AGL-3732).
+ *
+ * React #418 kept arriving from en-GB visitors on aglyn.com with no
+ * translator on the page and no way to reproduce it, and the report could not
+ * say what browser it came from. This answers that one question and nothing
+ * finer: one family out of seven, never the user-agent string and never a
+ * version, so it narrows a cluster without identifying a visitor.
+ *
+ * Order matters, and every test reads a token the browser itself puts there:
+ *
+ * - **webview first.** An Android WebView marks itself `; wv)`. On iOS every
+ *   browser is WebKit; Safari and the real third-party browsers say who they
+ *   are (`Safari/`, `CriOS`, `FxiOS`, `EdgiOS`), and an app's WKWebView —
+ *   Instagram, Facebook, a mail client — carries no `Safari/` token, or its
+ *   own `FBAN`/`Instagram` marker. An in-app browser injects into and
+ *   rewrites the DOM, which is exactly what a hydration mismatch looks like,
+ *   so it is its own family.
+ * - **edge and samsung before chrome**, because both also say `Chrome/`.
+ * - **firefox** on `Firefox/` and `FxiOS`.
+ * - **chrome** on `Chrome/`/`CriOS`/`Chromium`; Chromium brands that rename
+ *   themselves (Opera's `OPR/`, Yandex's `YaBrowser/`) are `other`.
+ * - **safari** last: `Safari/` with no Chromium token.
+ *
+ * Pure and total: anything it cannot place, including no string at all, is
+ * `other`. No `'use client'` — see the note atop `error-beacon.ts`; the
+ * ingest route imports {@link isBrowserFamily} on the server.
+ */ export const BROWSER_FAMILIES = [
+    'safari',
+    'chrome',
+    'firefox',
+    'edge',
+    'samsung',
+    'webview',
+    'other'
+];
+const FAMILY_SET = new Set(BROWSER_FAMILIES);
+/** True only for one of the seven values the beacon writes. */ export function isBrowserFamily(value) {
+    return typeof value === 'string' && FAMILY_SET.has(value);
+}
+const IOS_DEVICE = /\b(?:iPhone|iPad|iPod)\b/;
+const IN_APP_MARKER = /\b(?:FBAN|FBAV|FB_IAB|Instagram|Line)[/\s]/;
+export function browserFamily(userAgent) {
+    if (typeof userAgent !== 'string' || !userAgent) return 'other';
+    const ua = userAgent;
+    if (/;\s*wv\)/.test(ua)) return 'webview';
+    if (IOS_DEVICE.test(ua)) {
+        if (IN_APP_MARKER.test(ua)) return 'webview';
+        if (/\bEdgiOS\//.test(ua)) return 'edge';
+        if (/\bFxiOS\//.test(ua)) return 'firefox';
+        if (/\bCriOS\//.test(ua)) return 'chrome';
+        return /\bSafari\//.test(ua) ? 'safari' : 'webview';
+    }
+    if (/\bEdg(?:e|A)?\//.test(ua)) return 'edge';
+    if (/\bSamsungBrowser\//.test(ua)) return 'samsung';
+    if (/\bFirefox\//.test(ua)) return 'firefox';
+    if (/\b(?:OPR|Opera|YaBrowser)\//.test(ua)) return 'other';
+    if (/\b(?:Chrome|Chromium)\//.test(ua)) return 'chrome';
+    if (/\bSafari\//.test(ua)) return 'safari';
+    return 'other';
+}
+
+//# sourceMappingURL=browser-family.js.map

package/src/lib/app-utils/browser-family.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/browser-family.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * The coarse browser FAMILY an error report carries (AGL-3732).\n *\n * React #418 kept arriving from en-GB visitors on aglyn.com with no\n * translator on the page and no way to reproduce it, and the report could not\n * say what browser it came from. This answers that one question and nothing\n * finer: one family out of seven, never the user-agent string and never a\n * version, so it narrows a cluster without identifying a visitor.\n *\n * Order matters, and every test reads a token the browser itself puts there:\n *\n * - **webview first.** An Android WebView marks itself `; wv)`. On iOS every\n *   browser is WebKit; Safari and the real third-party browsers say who they\n *   are (`Safari/`, `CriOS`, `FxiOS`, `EdgiOS`), and an app's WKWebView —\n *   Instagram, Facebook, a mail client — carries no `Safari/` token, or its\n *   own `FBAN`/`Instagram` marker. An in-app browser injects into and\n *   rewrites the DOM, which is exactly what a hydration mismatch looks like,\n *   so it is its own family.\n * - **edge and samsung before chrome**, because both also say `Chrome/`.\n * - **firefox** on `Firefox/` and `FxiOS`.\n * - **chrome** on `Chrome/`/`CriOS`/`Chromium`; Chromium brands that rename\n *   themselves (Opera's `OPR/`, Yandex's `YaBrowser/`) are `other`.\n * - **safari** last: `Safari/` with no Chromium token.\n *\n * Pure and total: anything it cannot place, including no string at all, is\n * `other`. No `'use client'` — see the note atop `error-beacon.ts`; the\n * ingest route imports {@link isBrowserFamily} on the server.\n */\n\nexport const BROWSER_FAMILIES = [\n  'safari',\n  'chrome',\n  'firefox',\n  'edge',\n  'samsung',\n  'webview',\n  'other',\n] as const\n\nexport type BrowserFamily = (typeof BROWSER_FAMILIES)[number]\n\nconst FAMILY_SET: ReadonlySet<string> = new Set(BROWSER_FAMILIES)\n\n/** True only for one of the seven values the beacon writes. */\nexport function isBrowserFamily(value: unknown): value is BrowserFamily {\n  return typeof value === 'string' && FAMILY_SET.has(value)\n}\n\nconst IOS_DEVICE = /\\b(?:iPhone|iPad|iPod)\\b/\nconst IN_APP_MARKER = /\\b(?:FBAN|FBAV|FB_IAB|Instagram|Line)[/\\s]/\n\nexport function browserFamily(userAgent: unknown): BrowserFamily {\n  if (typeof userAgent !== 'string' || !userAgent) return 'other'\n  const ua = userAgent\n  if (/;\\s*wv\\)/.test(ua)) return 'webview'\n  if (IOS_DEVICE.test(ua)) {\n    if (IN_APP_MARKER.test(ua)) return 'webview'\n    if (/\\bEdgiOS\\//.test(ua)) return 'edge'\n    if (/\\bFxiOS\\//.test(ua)) return 'firefox'\n    if (/\\bCriOS\\//.test(ua)) return 'chrome'\n    return /\\bSafari\\//.test(ua) ? 'safari' : 'webview'\n  }\n  if (/\\bEdg(?:e|A)?\\//.test(ua)) return 'edge'\n  if (/\\bSamsungBrowser\\//.test(ua)) return 'samsung'\n  if (/\\bFirefox\\//.test(ua)) return 'firefox'\n  if (/\\b(?:OPR|Opera|YaBrowser)\\//.test(ua)) return 'other'\n  if (/\\b(?:Chrome|Chromium)\\//.test(ua)) return 'chrome'\n  if (/\\bSafari\\//.test(ua)) return 'safari'\n  return 'other'\n}\n"],"names":["BROWSER_FAMILIES","FAMILY_SET","Set","isBrowserFamily","value","has","IOS_DEVICE","IN_APP_MARKER","browserFamily","userAgent","ua","test"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BC,GAED,OAAO,MAAMA,mBAAmB;IAC9B;IACA;IACA;IACA;IACA;IACA;IACA;CACD,CAAS;AAIV,MAAMC,aAAkC,IAAIC,IAAIF;AAEhD,6DAA6D,GAC7D,OAAO,SAASG,gBAAgBC,KAAc;IAC5C,OAAO,OAAOA,UAAU,YAAYH,WAAWI,GAAG,CAACD;AACrD;AAEA,MAAME,aAAa;AACnB,MAAMC,gBAAgB;AAEtB,OAAO,SAASC,cAAcC,SAAkB;IAC9C,IAAI,OAAOA,cAAc,YAAY,CAACA,WAAW,OAAO;IACxD,MAAMC,KAAKD;IACX,IAAI,WAAWE,IAAI,CAACD,KAAK,OAAO;IAChC,IAAIJ,WAAWK,IAAI,CAACD,KAAK;QACvB,IAAIH,cAAcI,IAAI,CAACD,KAAK,OAAO;QACnC,IAAI,aAAaC,IAAI,CAACD,KAAK,OAAO;QAClC,IAAI,YAAYC,IAAI,CAACD,KAAK,OAAO;QACjC,IAAI,YAAYC,IAAI,CAACD,KAAK,OAAO;QACjC,OAAO,aAAaC,IAAI,CAACD,MAAM,WAAW;IAC5C;IACA,IAAI,kBAAkBC,IAAI,CAACD,KAAK,OAAO;IACvC,IAAI,qBAAqBC,IAAI,CAACD,KAAK,OAAO;IAC1C,IAAI,cAAcC,IAAI,CAACD,KAAK,OAAO;IACnC,IAAI,8BAA8BC,IAAI,CAACD,KAAK,OAAO;IACnD,IAAI,0BAA0BC,IAAI,CAACD,KAAK,OAAO;IAC/C,IAAI,aAAaC,IAAI,CAACD,KAAK,OAAO;IAClC,OAAO;AACT"}

package/src/lib/app-utils/docs-help-sections.generated.js

@@ -73,7 +73,7 @@
     aiCrm: {
         '#draft-an-email': 'New timeline entry, a new or finished task, or an edited note makes the next summary a new one.',
         '#match-columns': 'R. What you type into the request is kept with the AI request, as every AI request is, and members of your workspace can see it in the list of AI jobs, so describe the email rather than pasting private details into…',
-        '#summarize-a-record': 'T, company, deal or lead, with a suggested next step.'
+        '#summarize-a-record': 'He columns of your file and the fields they fill. It can also set up the CRM from the Assist chat: your deal pipelines and their stages, and your custom fields.'
     },
     aiEmail: {
         '#where-to-start-it': 'Eaders to choose between. Ask for a campaign instead and it writes the same design plus the draft campaign that would send it.',
@@ -121,7 +121,7 @@
     },
     aiProducts: {
         '#propose-a-first-catalog': 'Criptions, search listings and tags with AI as they land. Once the import has created your products, their copy is written as above and waits in the review table on the products page.',
-        '#write-a-products-copy': 'Th AI Aglyn AI can write the copy for your products and help you set up a store.'
+        '#write-a-products-copy': 'Ur products and help you set up a store. Everything it does is a proposal: you review it, and nothing is saved to your catalog until you apply it.'
     },
     aiSeo: {
         '#fix-what-the-seo-check-finds': 'Sting section has the same Write with AI control. It proposes an SEO title and an SEO description from the product\'s name and description.',
@@ -200,8 +200,9 @@
         '#4-save-and-test': 'Ces](actions-builder.md#sequences) for the rest, including what a wait means for the emails sent after it.'
     },
     catalog: {
-        '#categories-and-tags': 'Eir prices left empty, and proposed discounts are created switched off.',
-        '#product-reviews': ', so that collection\'s grid is in price order — high to low if that is the sort chosen, low to high otherwise.'
+        '#categories-and-tags': 'Heir suggested prices, and proposed discounts are created switched off.',
+        '#review-moderation': 'Ff or change the delay on the Reviews card, and change its wording under Emails → Review request.',
+        '#review-settings': '1 to 5 and write a review in the Product reviews block on your product page template.'
     },
     commerce: {
         '#commerce-analytics': 'Hat was refunded, and leaves out test-mode orders. The card lists the five latest orders, and Open store takes you to the products hub.',
@@ -390,7 +391,7 @@
         '#form-crm-routing': 'Since the same signup form is often placed by more than one push.',
         '#form-details': 'Something in that card differs from what\'s saved, and saving one card never saves the other.',
         '#form-submissions': 'R.',
-        '#form-versions': 'Scribe* or marketing consent — counts even before you pick it as the consent field.',
+        '#form-versions': 'Ll walkthrough — the form, a live audience of everyone who submits it, and a reusable band that places it on any page — see Build a newsletter sign-up band.',
         '#inbox-card': 'Ad no email field cannot be replied to, and says so instead of offering a Send that would fail.',
         '#one-forms-own-page': 'Goes straight to that site\'s view, with no filter to set. Collaborators invited to particular sites don\'t see the organization\'s Inbox — they keep each site\'s own, which is unchanged.',
         '#replying-to-a-submission': 'Saved to Inbox on a form you bound to a dataset is the signal to go and check the dataset.',
@@ -563,7 +564,7 @@
     shipping: {
         '#carrier-accounts': 'Tment or suite, city, state or region, postal code, the two-letter country code and a phone number, saved beside the location\'s name.',
         '#shipping-labels': 'Account and not kept by Aglyn. Labels bought on your own account are billed to you by the carrier, so Aglyn charges nothing for them.',
-        '#where-parcels-ship-from': 'Te. The destination coverage rules explain what your zones make checkout ask and refuse.',
+        '#where-parcels-ship-from': 'Redits.',
         '#zones-and-rates': 'Ced from the zones and rates you save there, at the storefront\'s cart, on a product\'s Buy button, and on a draft order\'s payment link.'
     },
     shippingEasy: {