@volter/twin-googlefonts 0.0.0-stage → 1.0.2

package/dist/src/semantics/shared.d.ts

@@ -0,0 +1,9 @@
+import type { HandlerContext } from '@volter/world-core';
+export declare const FONT = "webfont", CATALOG = "_font_catalog", CSS = "_stylesheet", FILE = "_font_file", KEY = "_api_key";
+export declare const object: (value: unknown) => Record<string, unknown>;
+export declare const assetKey: (value: string) => string;
+export declare const cssKey: (ctx: HandlerContext, family: string, subset: string, userAgent: string) => string;
+export declare const css2Query: (query: URLSearchParams) => Array<[string, string]> | undefined;
+export declare const css2Key: (ctx: HandlerContext, pairs: Array<[string, string]>, userAgent: string) => string;
+export declare const googleError: (status: number, message: string, kind?: string) => Response;
+export declare const htmlError: (status: number, message: string) => Response;

package/dist/src/semantics/shared.js

@@ -0,0 +1,23 @@
+export const FONT = 'webfont', CATALOG = '_font_catalog', CSS = '_stylesheet', FILE = '_font_file', KEY = '_api_key';
+export const object = (value) => value !== null && typeof value === 'object' && !Array.isArray(value) ? value : {};
+export const assetKey = (value) => {
+    const url = new URL(value);
+    url.hash = '';
+    if (url.hostname !== 'fonts.gstatic.com' || url.username || url.password || !['http:', 'https:'].includes(url.protocol))
+        throw new Error('Invalid font URL');
+    url.searchParams.sort();
+    return url.pathname + url.search;
+};
+export const cssKey = (ctx, family, subset, userAgent) => ctx.crypto.digest('sha256', JSON.stringify([family, subset, userAgent]));
+// A CSS2 request is its ordered query pairs; family may repeat, text and display may not.
+export const css2Query = (query) => {
+    const pairs = [...query.entries()];
+    const once = (name) => pairs.filter(([k]) => k === name).length <= 1;
+    if (!pairs.some(([k, v]) => k === 'family' && v) || pairs.some(([k]) => !['family', 'text', 'display'].includes(k)) ||
+        !once('text') || !once('display'))
+        return undefined;
+    return pairs;
+};
+export const css2Key = (ctx, pairs, userAgent) => ctx.crypto.digest('sha256', JSON.stringify(['css2', pairs, userAgent]));
+export const googleError = (status, message, kind = status === 403 ? 'PERMISSION_DENIED' : 'INVALID_ARGUMENT') => Response.json({ error: { code: status, message, status: kind } }, { status });
+export const htmlError = (status, message) => new Response('<!doctype html><title>' + status + '</title><p>' + message.replace(/[<>&]/g, c => ({ '<': '&lt;', '>': '&gt;', '&': '&amp;' }[c])) + '</p>', { status, headers: { 'content-type': 'text/html; charset=UTF-8' } });

package/dist/src/server.d.ts

@@ -0,0 +1,7 @@
+import { type PackFetchOptions } from '@volter/world-core';
+export declare function createGooglefontsTwinServer(options?: PackFetchOptions & {
+    port?: number;
+}): Promise<{
+    port: number;
+    stop: () => void;
+}>;

package/dist/src/server.js

@@ -0,0 +1,7 @@
+// FETCH-FIRST (runtime contract R12b): a fixed file, the kernel's serve seam around the pack's fetch (./fetch.ts).
+import { serveHttp } from '@volter/world-core';
+import { createGooglefontsFetch } from "./fetch.js";
+export async function createGooglefontsTwinServer(options = {}) {
+    const server = await serveHttp({ port: options.port ?? 0, idleTimeout: 60, fetch: createGooglefontsFetch(options) });
+    return { port: server.port ?? options.port ?? 0, stop: () => server.stop(true) };
+}

package/generated/pack-facts.json

@@ -0,0 +1,68 @@
+{
+  "//": "GENERATED by twin-standard facts from the pack descriptor; no prior-artifact entries are retained.",
+  "packs": {
+    "googlefonts": {
+      "adoption": {
+        "sdks": [],
+        "envStems": [
+          "GOOGLE_FONTS"
+        ],
+        "modules": [
+          "next/font/google"
+        ]
+      },
+      "hosts": [
+        {
+          "host": "www.googleapis.com",
+          "pathPattern": "^/webfonts/v1/webfonts$"
+        },
+        {
+          "host": "webfonts.googleapis.com",
+          "pathPattern": "^/v1/webfonts$"
+        },
+        {
+          "host": "fonts.googleapis.com",
+          "pathPattern": "^/css2?$"
+        },
+        {
+          "host": "fonts.gstatic.com",
+          "pathPattern": "^/(s/|l/font$)"
+        }
+      ],
+      "archetype": "crud",
+      "protocol": {
+        "declared": "3",
+        "major": 3,
+        "standing": "current"
+      },
+      "transport": "rest",
+      "resources": [
+        "webfont",
+        "_api_key",
+        "_font_catalog",
+        "_stylesheet",
+        "_font_file"
+      ],
+      "endpointEnvNone": "Pinned helper hardcodes the vendor API and CSS hosts, then downloads their returned gstatic URLs. Scoped host routing preserves these URLs.",
+      "credentialDoor": {
+        "path": "/_twin/app-credentials",
+        "body": {},
+        "account": {
+          "field": "account",
+          "tenancy": "Google Cloud project",
+          "source": "https://developers.google.com/fonts/docs/developer_api"
+        },
+        "deployment": {
+          "field": "deployment",
+          "object": "Project API key",
+          "source": "https://docs.cloud.google.com/docs/authentication/api-keys"
+        },
+        "fill": {
+          "GOOGLE_FONTS_API_KEY": "api_key"
+        }
+      },
+      "serveExport": "createGooglefontsTwinServer"
+    }
+  },
+  "undeclared": []
+}