@volter/twin-googlefonts 1.0.2 → 1.0.3

package/api/src/semantics/doors.ts

@@ -1,6 +1,6 @@
 // Google supplies catalog records and keys outside the read-only Fonts API.
 import type { HandlerContext } from '@volter/world-core';
-import { FONT, CATALOG, CSS, FILE, KEY, object, assetKey, cssKey, css2Key, css2Query, googleError } from './shared.ts';
+import { FONT, CATALOG, CSS, FILE, KEY, object, assetKey, browserClass, cssKey, css2Key, css2Query, googleError } from './shared.ts';
 
 // source: https://developers.google.com/fonts/docs/developer_api
 export async function appCredentials(ctx: HandlerContext): Promise<Response> {
@@ -83,8 +83,9 @@ export async function publishCatalog(ctx: HandlerContext): Promise<Response> {
       if (!font || !(font.variants as string[]).includes(variant) ||
           sheet.subset.split(',').some(s => !(font.subsets as string[]).includes(s)))
         throw new Error('Stylesheet request must name a published font, variant and subset');
+      // a stylesheet is one browser class's representation (shared.ts browserClass): its user agent is that class's sample
       const key = cssKey(ctx, sheet.family, sheet.subset, sheet.userAgent);
-      if (representations.has(key)) throw new Error('Duplicate stylesheet request');
+      if (representations.has(key)) throw new Error('Duplicate stylesheet request for browser class ' + browserClass(sheet.userAgent));
       representations.add(key);
       const urls = [...sheet.css.matchAll(/url\((https?:\/\/[^)]+)\)/g)].map(m => m[1]!);
       if (urls.length === 0 || urls.some(url => !decoded.has(assetKey(url))))
@@ -95,7 +96,7 @@ export async function publishCatalog(ctx: HandlerContext): Promise<Response> {
       if (!pairs || typeof sheet.userAgent !== 'string' || typeof sheet.css !== 'string' || !sheet.css.includes('@font-face'))
         throw new Error('Invalid CSS2 stylesheet representation');
       const key = css2Key(ctx, pairs, sheet.userAgent);
-      if (representations.has(key)) throw new Error('Duplicate stylesheet request');
+      if (representations.has(key)) throw new Error('Duplicate stylesheet request for browser class ' + browserClass(sheet.userAgent));
       representations.add(key);
       const urls = [...sheet.css.matchAll(/url\((https?:\/\/[^)]+)\)/g)].map(m => m[1]!);
       if (urls.length === 0 || urls.some(url => !decoded.has(assetKey(url))))
@@ -122,13 +123,13 @@ export async function publishCatalog(ctx: HandlerContext): Promise<Response> {
     const key = cssKey(ctx, sheet.family as string, sheet.subset as string, sheet.userAgent as string);
     const blob = 'css-' + ctx.crypto.digest('sha256', sheet.css as string);
     await ctx.blobs.put(blob, new TextEncoder().encode(sheet.css as string));
-    await ctx.record(CSS, { family: sheet.family, subset: sheet.subset, userAgent: sheet.userAgent, blob }, fingerprint + ':' + key);
+    await ctx.record(CSS, { family: sheet.family, subset: sheet.subset, userAgent: sheet.userAgent, browserClass: browserClass(sheet.userAgent as string), blob }, fingerprint + ':' + key);
   }
   for (const sheet of sheets2) {
     const key = css2Key(ctx, css2Query(new URLSearchParams(sheet.query as string))!, sheet.userAgent as string);
     const blob = 'css-' + ctx.crypto.digest('sha256', sheet.css as string);
     await ctx.blobs.put(blob, new TextEncoder().encode(sheet.css as string));
-    await ctx.record(CSS, { query: sheet.query, userAgent: sheet.userAgent, blob }, fingerprint + ':' + key);
+    await ctx.record(CSS, { query: sheet.query, userAgent: sheet.userAgent, browserClass: browserClass(sheet.userAgent as string), blob }, fingerprint + ':' + key);
   }
   await ctx.record(CATALOG, { families: [...names], fingerprint }, 'published');
   return Response.json({ families: [...names] }, { status: 201 });

package/api/src/semantics/index.ts

@@ -1,4 +1,4 @@
-// GENERATED by scripts/create-pack.ts --index: the handler map, by operationId, from the families' files (each
+// GENERATED by twin-standard create --index: the handler map, by operationId, from the families' files (each
 // handler named as its operation). Do not edit; add a handler to its family's file and generate again.
 import type { Handler } from '@volter/world-core';
 import * as webfonts from './webfonts.ts';

package/assets/src/semantics/index.ts

@@ -1,4 +1,4 @@
-// GENERATED by scripts/create-pack.ts --index: the handler map, by operationId, from the families' files (each
+// GENERATED by twin-standard create --index: the handler map, by operationId, from the families' files (each
 // handler named as its operation). Do not edit; add a handler to its family's file and generate again.
 import type { Handler } from '@volter/world-core';
 import * as l from './l.ts';

package/css/spec/SOURCE.md

@@ -10,8 +10,14 @@ calls GET /css2?family=Noto+Sans+SC:wght@<weight>&text=<text>, both from a serve
 without a browser User-Agent, and read the truetype src URL. next/font/google's build (Rallly's and
 Cal.diy's `next build`) calls GET /css2?family=Inter:wght@100..900&display=swap with a Chrome User-Agent and
 reads each woff2 src URL of its unicode-range faces.
+Twenty's front end (twentyhq/twenty 323e664, packages/twenty-front/index.html:33,37) links
+GET /css2?family=Inter:wght@400;500;600&display=swap and GET /css2?family=DM+Mono:wght@400;500;600&display=swap
+from the browser, which loads the woff2 faces its text needs.
+A representation is published for a browser class (src/semantics/shared.ts browserClass): Google serves any
+browser, choosing WOFF 2.0 and unicode-range subsets by the browser its User-Agent names, and the classes are
+the agents Google answered the same bytes (vendor/browser-classes.json).
 The supplied representations retain actual vendor CSS. Requests without a
-published representation answer a refusal, never an invented font format.
+representation published for their class answer a refusal, never an invented font format.
 text/display/effect on /css are outside this client's demand.
 
 SHA-256 `openapi.json`: bf7b9a3b70c3a75712fb784e22bfe07c0008dd55e1aa93b31cba8da26a64fb60

package/css/src/semantics/css.ts

@@ -1,5 +1,5 @@
 import type { HandlerContext } from '@volter/world-core';
-import { CATALOG, CSS, cssKey, htmlError } from './shared.ts';
+import { browserClass, CATALOG, CSS, cssKey, htmlError } from './shared.ts';
 
 // source: spec:getStylesheet "The representation is selected for the requesting browser."
 export async function getStylesheet(ctx: HandlerContext): Promise<Response> {
@@ -8,11 +8,13 @@ export async function getStylesheet(ctx: HandlerContext): Promise<Response> {
   if (!family || [...query.keys()].some(k => !['family','subset'].includes(k)))
     return htmlError(400, 'Bad font request');
   const generation = ctx.row(CATALOG, 'published')?.fingerprint;
-  const key = cssKey(ctx, family, subset, ctx.call.request.headers.get('user-agent') ?? '');
+  // the representation published for the browser class the agent belongs to (shared.ts browserClass)
+  const userAgent = ctx.call.request.headers.get('user-agent') ?? '';
+  const key = cssKey(ctx, family, subset, userAgent);
   const row = generation === undefined ? undefined : ctx.row(CSS, String(generation) + ':' + key);
   // Where the documentation stops: no supplied representation is a named
   // refusal, not an invented conversion or another browser's font format.
-  if (!row) return htmlError(400, 'Font family or browser representation is not published');
+  if (!row) return htmlError(400, 'Font family or browser representation is not published (' + browserClass(userAgent) + ')');
   const body = await ctx.blobs.get(String(row.blob));
   if (!body) return htmlError(404, 'Font stylesheet not found');
   return new Response(Uint8Array.from(body).buffer, { headers: { 'content-type': 'text/css; charset=utf-8', 'content-length': String(body.length), 'vary': 'User-Agent' } });

package/css/src/semantics/css2.ts

@@ -1,5 +1,5 @@
 import type { HandlerContext } from '@volter/world-core';
-import { CATALOG, CSS, css2Key, css2Query, htmlError } from './shared.ts';
+import { browserClass, CATALOG, CSS, css2Key, css2Query, htmlError } from './shared.ts';
 
 // source: spec:getStylesheet2 "To request multiple families, specify the family= param for each family."
 export async function getStylesheet2(ctx: HandlerContext): Promise<Response> {
@@ -7,13 +7,14 @@ export async function getStylesheet2(ctx: HandlerContext): Promise<Response> {
   if (!pairs) return htmlError(400, 'Bad font request');
   const generation = ctx.row(CATALOG, 'published')?.fingerprint;
   const userAgent = ctx.call.request.headers.get('user-agent') ?? '';
-  const sheet = (agent: string) => generation === undefined ? undefined : ctx.row(CSS, String(generation) + ':' + css2Key(ctx, pairs, agent));
-  // Where the evidence stops: Google answered the same truetype stylesheet to no User-Agent, "node" and "undici"
-  // (vendor/inter.json). A request whose agent is not a browser's ("Mozilla/...") and has no representation of its
-  // own reads the one published for no agent; a browser without its own representation is refused, never sent
-  // another browser's format.
-  const row = sheet(userAgent) ?? (userAgent.startsWith('Mozilla/') ? undefined : sheet(''));
-  if (!row) return htmlError(400, 'Font family or browser representation is not published');
+  // The representation is the one published for the browser class the agent belongs to (shared.ts browserClass): a
+  // request with no browser's agent ("node", "undici", none) reads the truetype class, as Google answered the same CSS
+  // to all three (vendor/inter.json).
+  // source: spec:getStylesheet2 "The representation is selected for the requesting browser."
+  const row = generation === undefined ? undefined : ctx.row(CSS, String(generation) + ':' + css2Key(ctx, pairs, userAgent));
+  // Where the documentation stops: a class with no published representation is a named refusal, never another
+  // class's font format.
+  if (!row) return htmlError(400, 'Font family or browser representation is not published (' + browserClass(userAgent) + ')');
   const body = await ctx.blobs.get(String(row.blob));
   if (!body) return htmlError(404, 'Font stylesheet not found');
   return new Response(Uint8Array.from(body).buffer, { headers: { 'content-type': 'text/css; charset=utf-8', 'content-length': String(body.length), 'access-control-allow-origin': '*' } });

package/css/src/semantics/index.ts

@@ -1,4 +1,4 @@
-// GENERATED by scripts/create-pack.ts --index: the handler map, by operationId, from the families' files (each
+// GENERATED by twin-standard create --index: the handler map, by operationId, from the families' files (each
 // handler named as its operation). Do not edit; add a handler to its family's file and generate again.
 import type { Handler } from '@volter/world-core';
 import * as css from './css.ts';

package/dist/api/src/semantics/doors.js

@@ -1,4 +1,4 @@
-import { FONT, CATALOG, CSS, FILE, KEY, object, assetKey, cssKey, css2Key, css2Query, googleError } from "./shared.js";
+import { FONT, CATALOG, CSS, FILE, KEY, object, assetKey, browserClass, cssKey, css2Key, css2Query, googleError } from "./shared.js";
 // source: https://developers.google.com/fonts/docs/developer_api
 export async function appCredentials(ctx) {
     // An app's key is a standard API key, made on a Google Cloud project's Credentials page and associating each request
@@ -82,9 +82,10 @@ export async function publishCatalog(ctx) {
             if (!font || !font.variants.includes(variant) ||
                 sheet.subset.split(',').some(s => !font.subsets.includes(s)))
                 throw new Error('Stylesheet request must name a published font, variant and subset');
+            // a stylesheet is one browser class's representation (shared.ts browserClass): its user agent is that class's sample
             const key = cssKey(ctx, sheet.family, sheet.subset, sheet.userAgent);
             if (representations.has(key))
-                throw new Error('Duplicate stylesheet request');
+                throw new Error('Duplicate stylesheet request for browser class ' + browserClass(sheet.userAgent));
             representations.add(key);
             const urls = [...sheet.css.matchAll(/url\((https?:\/\/[^)]+)\)/g)].map(m => m[1]);
             if (urls.length === 0 || urls.some(url => !decoded.has(assetKey(url))))
@@ -96,7 +97,7 @@ export async function publishCatalog(ctx) {
                 throw new Error('Invalid CSS2 stylesheet representation');
             const key = css2Key(ctx, pairs, sheet.userAgent);
             if (representations.has(key))
-                throw new Error('Duplicate stylesheet request');
+                throw new Error('Duplicate stylesheet request for browser class ' + browserClass(sheet.userAgent));
             representations.add(key);
             const urls = [...sheet.css.matchAll(/url\((https?:\/\/[^)]+)\)/g)].map(m => m[1]);
             if (urls.length === 0 || urls.some(url => !decoded.has(assetKey(url))))
@@ -129,13 +130,13 @@ export async function publishCatalog(ctx) {
         const key = cssKey(ctx, sheet.family, sheet.subset, sheet.userAgent);
         const blob = 'css-' + ctx.crypto.digest('sha256', sheet.css);
         await ctx.blobs.put(blob, new TextEncoder().encode(sheet.css));
-        await ctx.record(CSS, { family: sheet.family, subset: sheet.subset, userAgent: sheet.userAgent, blob }, fingerprint + ':' + key);
+        await ctx.record(CSS, { family: sheet.family, subset: sheet.subset, userAgent: sheet.userAgent, browserClass: browserClass(sheet.userAgent), blob }, fingerprint + ':' + key);
     }
     for (const sheet of sheets2) {
         const key = css2Key(ctx, css2Query(new URLSearchParams(sheet.query)), sheet.userAgent);
         const blob = 'css-' + ctx.crypto.digest('sha256', sheet.css);
         await ctx.blobs.put(blob, new TextEncoder().encode(sheet.css));
-        await ctx.record(CSS, { query: sheet.query, userAgent: sheet.userAgent, blob }, fingerprint + ':' + key);
+        await ctx.record(CSS, { query: sheet.query, userAgent: sheet.userAgent, browserClass: browserClass(sheet.userAgent), blob }, fingerprint + ':' + key);
     }
     await ctx.record(CATALOG, { families: [...names], fingerprint }, 'published');
     return Response.json({ families: [...names] }, { status: 201 });

package/dist/css/spec/SOURCE.md

@@ -10,8 +10,14 @@ calls GET /css2?family=Noto+Sans+SC:wght@<weight>&text=<text>, both from a serve
 without a browser User-Agent, and read the truetype src URL. next/font/google's build (Rallly's and
 Cal.diy's `next build`) calls GET /css2?family=Inter:wght@100..900&display=swap with a Chrome User-Agent and
 reads each woff2 src URL of its unicode-range faces.
+Twenty's front end (twentyhq/twenty 323e664, packages/twenty-front/index.html:33,37) links
+GET /css2?family=Inter:wght@400;500;600&display=swap and GET /css2?family=DM+Mono:wght@400;500;600&display=swap
+from the browser, which loads the woff2 faces its text needs.
+A representation is published for a browser class (src/semantics/shared.ts browserClass): Google serves any
+browser, choosing WOFF 2.0 and unicode-range subsets by the browser its User-Agent names, and the classes are
+the agents Google answered the same bytes (vendor/browser-classes.json).
 The supplied representations retain actual vendor CSS. Requests without a
-published representation answer a refusal, never an invented font format.
+representation published for their class answer a refusal, never an invented font format.
 text/display/effect on /css are outside this client's demand.
 
 SHA-256 `openapi.json`: bf7b9a3b70c3a75712fb784e22bfe07c0008dd55e1aa93b31cba8da26a64fb60

package/dist/css/src/semantics/css.js

@@ -1,4 +1,4 @@
-import { CATALOG, CSS, cssKey, htmlError } from "./shared.js";
+import { browserClass, CATALOG, CSS, cssKey, htmlError } from "./shared.js";
 // source: spec:getStylesheet "The representation is selected for the requesting browser."
 export async function getStylesheet(ctx) {
     const query = new URL(ctx.call.request.url).searchParams;
@@ -6,12 +6,14 @@ export async function getStylesheet(ctx) {
     if (!family || [...query.keys()].some(k => !['family', 'subset'].includes(k)))
         return htmlError(400, 'Bad font request');
     const generation = ctx.row(CATALOG, 'published')?.fingerprint;
-    const key = cssKey(ctx, family, subset, ctx.call.request.headers.get('user-agent') ?? '');
+    // the representation published for the browser class the agent belongs to (shared.ts browserClass)
+    const userAgent = ctx.call.request.headers.get('user-agent') ?? '';
+    const key = cssKey(ctx, family, subset, userAgent);
     const row = generation === undefined ? undefined : ctx.row(CSS, String(generation) + ':' + key);
     // Where the documentation stops: no supplied representation is a named
     // refusal, not an invented conversion or another browser's font format.
     if (!row)
-        return htmlError(400, 'Font family or browser representation is not published');
+        return htmlError(400, 'Font family or browser representation is not published (' + browserClass(userAgent) + ')');
     const body = await ctx.blobs.get(String(row.blob));
     if (!body)
         return htmlError(404, 'Font stylesheet not found');

package/dist/css/src/semantics/css2.js

@@ -1,4 +1,4 @@
-import { CATALOG, CSS, css2Key, css2Query, htmlError } from "./shared.js";
+import { browserClass, CATALOG, CSS, css2Key, css2Query, htmlError } from "./shared.js";
 // source: spec:getStylesheet2 "To request multiple families, specify the family= param for each family."
 export async function getStylesheet2(ctx) {
     const pairs = css2Query(new URL(ctx.call.request.url).searchParams);
@@ -6,14 +6,15 @@ export async function getStylesheet2(ctx) {
         return htmlError(400, 'Bad font request');
     const generation = ctx.row(CATALOG, 'published')?.fingerprint;
     const userAgent = ctx.call.request.headers.get('user-agent') ?? '';
-    const sheet = (agent) => generation === undefined ? undefined : ctx.row(CSS, String(generation) + ':' + css2Key(ctx, pairs, agent));
-    // Where the evidence stops: Google answered the same truetype stylesheet to no User-Agent, "node" and "undici"
-    // (vendor/inter.json). A request whose agent is not a browser's ("Mozilla/...") and has no representation of its
-    // own reads the one published for no agent; a browser without its own representation is refused, never sent
-    // another browser's format.
-    const row = sheet(userAgent) ?? (userAgent.startsWith('Mozilla/') ? undefined : sheet(''));
+    // The representation is the one published for the browser class the agent belongs to (shared.ts browserClass): a
+    // request with no browser's agent ("node", "undici", none) reads the truetype class, as Google answered the same CSS
+    // to all three (vendor/inter.json).
+    // source: spec:getStylesheet2 "The representation is selected for the requesting browser."
+    const row = generation === undefined ? undefined : ctx.row(CSS, String(generation) + ':' + css2Key(ctx, pairs, userAgent));
+    // Where the documentation stops: a class with no published representation is a named refusal, never another
+    // class's font format.
     if (!row)
-        return htmlError(400, 'Font family or browser representation is not published');
+        return htmlError(400, 'Font family or browser representation is not published (' + browserClass(userAgent) + ')');
     const body = await ctx.blobs.get(String(row.blob));
     if (!body)
         return htmlError(404, 'Font stylesheet not found');

package/dist/journeys/decisions.json

@@ -13,14 +13,14 @@
       "lane": "css",
       "mechanism": "handler",
       "demand": "All five pinned config.ts UAs",
-      "why": "Use exact published CSS per request/UA, with the real font-family/style/weight/src consumed by fetchCSS; first-use downloads every returned src. Unsupported representations answer a refusal."
+      "why": "Use the exact published CSS per request and browser class (src/semantics/shared.ts browserClass; each of the five pinned config.ts UAs is one class's sample), with the real font-family/style/weight/src consumed by fetchCSS; first-use downloads every returned src. A class with no published representation answers a refusal."
     },
     {
       "operation": "getStylesheet2",
       "lane": "css",
       "mechanism": "handler",
-      "demand": "Dub's Inter weights and Rallly's CJK text subsets, both from a server; Rallly's and Cal.diy's next/font/google build of Inter's variable weights, with next/font's browser User-Agent",
-      "why": "Use the exact published CSS per ordered CSS2 query and User-Agent; a non-browser agent without its own representation reads the one published for no agent, as Google answered the same CSS to none, node and undici. Unpublished families, text subsets and browser representations answer a refusal; text= and display= given twice, or another parameter, are a bad request."
+      "demand": "Dub's Inter weights and Rallly's CJK text subsets, both from a server; Rallly's and Cal.diy's next/font/google build of Inter's variable weights, with next/font's browser User-Agent; Twenty's front end's Inter and DM Mono stylesheets, from a Chromium browser",
+      "why": "Use the exact published CSS per ordered CSS2 query and browser class (src/semantics/shared.ts browserClass, the classes of Google's answers in vendor/browser-classes.json): Google serves any browser, choosing WOFF 2.0 and unicode-range by the browser, and a non-browser agent is the truetype class, as Google answered the same CSS to none, node and undici. A class without a published representation, and unpublished families and text subsets, answer a refusal; text= and display= given twice, or another parameter, are a bad request."
     },
     {
       "operation": "getFontFile",

package/dist/journeys/demand.json

@@ -95,6 +95,28 @@
           "evidence": "the same build"
         }
       ]
+    },
+    {
+      "name": "twentyhq/twenty",
+      "commit": "323e66433ee5b0878f43bc6c54abe4b1ac9be64b",
+      "client": "the front end in a browser (Playwright 1.63's Chromium 153 headless shell in the bench task twenty-20877), its own User-Agent",
+      "backend": [
+        {
+          "call": "GET fonts.googleapis.com/css2?family=Inter:wght@400;500;600&display=swap",
+          "operation": "getStylesheet2",
+          "evidence": "packages/twenty-front/index.html:33 (a stylesheet link, until 3aeb2b0d self-hosts the fonts)"
+        },
+        {
+          "call": "GET fonts.googleapis.com/css2?family=DM+Mono:wght@400;500;600&display=swap",
+          "operation": "getStylesheet2",
+          "evidence": "packages/twenty-front/index.html:37"
+        },
+        {
+          "call": "GET fonts.gstatic.com/s/{inter,dmmono}/... woff2, the faces the page's text needs",
+          "operation": "getFontFile",
+          "evidence": "the browser loads each unicode-range face its text uses"
+        }
+      ]
     }
   ],
   "notDemanded": "OAuth, font submission/publishing UI, effects and advanced catalog capabilities are outside these client paths."

package/dist/src/manifest.js

@@ -11,7 +11,7 @@ export const manifest = {
         protocol: '3', transport: 'rest', archetype: 'crud', bin: 'world-googlefonts',
         resources: ['webfont', '_api_key', '_font_catalog', '_stylesheet', '_font_file'],
         specSource: 'api/spec/SOURCE.md: unchanged Google Discovery; css/spec/SOURCE.md and assets/spec/SOURCE.md: Google documentation and retained font responses',
-        description: 'Google Fonts catalog, exact published CSS representations and genuine font bytes; a World-issued query API key. Seed data is the attributed Antic reference catalog and the CSS2 weights 500-700 of Inter, not the complete live Google catalog.',
+        description: 'Google Fonts catalog, exact published CSS representations and genuine font bytes; a World-issued query API key. Seed data is the attributed Antic reference catalog, the CSS2 weights 500-700 of Inter, the variable weights of Inter and the Inter and DM Mono stylesheets Twenty links, not the complete live Google catalog.',
         // next/font/google fetches the font's stylesheet and files from Google at an app's build (twin-world architecture,
         // Selection: a module that reaches the vendor by itself is evidence, as an SDK is)
         adoption: { sdks: [], envStems: ['GOOGLE_FONTS'], modules: ['next/font/google'] },