@sparkletree/core 0.1.0

package/dist/client.js

@@ -0,0 +1,251 @@
+/**
+ * The client: fetch `/content` for first paint, then open the stream and feed
+ * every event into the choreographer.
+ *
+ * The event dispatch below is the ONLY place in the SDK that knows event
+ * names, and every name it knows comes from the generated contract. A server
+ * that starts emitting something newer than this build is not an error — it is
+ * an older client, which the protocol explicitly supports — so unknown events
+ * are ignored rather than warned about.
+ */
+import { CONTENT_SOURCES, COPY_MODES, EVENT_PROTOCOL_UNSUPPORTED, PROTOCOL_CURRENT, isWireEvent, } from "./wire.js";
+import { isSecureApiBase, safeActionUrl } from "./safeUrl.js";
+import { buildContentUrl, buildStreamUrl, negotiatedProtocol, } from "./protocol.js";
+import { readSseStream } from "./sse.js";
+import { CopyChoreographer, } from "./state.js";
+/** Which copy field an event name addresses, if any. */
+function copyFieldOf(event) {
+    const [field] = event.split("-");
+    if (field === "greeting" || field === "headline" || field === "body" || field === "cta") {
+        return field;
+    }
+    return null;
+}
+function parseData(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === "object" ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function str(value, fallback = "") {
+    return typeof value === "string" ? value : fallback;
+}
+/**
+ * Fetch the first-paint content.
+ *
+ * Content-first, rewrite-once: this is what the SDK paints BEFORE any stream
+ * exists, so there is never a skeleton on screen. If it fails, the consumer's
+ * `fallback` prop is what stands in — which is why that prop is required
+ * rather than optional.
+ */
+export async function fetchContent(target, options = {}) {
+    const doFetch = options.fetchImpl ?? fetch;
+    // An apiBase that is neither https nor loopback http is a misconfiguration,
+    // not a request worth making: the content path degrades to the consumer's
+    // fallback, which is real copy by contract.
+    if (!isSecureApiBase(target.apiBase))
+        return null;
+    try {
+        // No custom headers: the protocol version already rides the URL
+        // (buildContentUrl), and a bare GET is a CORS "simple request" — no
+        // preflight to allowlist, no OPTIONS round-trip before first paint.
+        const response = await doFetch(buildContentUrl(target), {
+            signal: options.signal,
+        });
+        if (!response.ok)
+            return null;
+        // The body is untrusted: a proxy or a misconfigured edge can answer 200
+        // with HTML or a bare string, and casting that to ContentSnapshot would
+        // paint garbage instead of falling back.
+        const body = await response.json();
+        return body && typeof body === "object" ? body : null;
+    }
+    catch {
+        // A failed first-paint fetch is not an error state: the consumer's
+        // fallback is real copy and the stream may still arrive.
+        return null;
+    }
+}
+/**
+ * Open an island stream and choreograph it.
+ *
+ * Returns immediately with a handle; `finished` resolves with the terminal
+ * state. It never rejects — a broken stream leaves whatever was painted on
+ * screen and reports `phase: "failed"`, because throwing from inside a
+ * customer's render tree is a worse outcome than a creative that stopped
+ * adapting.
+ */
+export function openStream(options) {
+    const { target, onState, onProtocolUnsupported } = options;
+    const doFetch = options.fetchImpl ?? fetch;
+    const choreographer = new CopyChoreographer(options);
+    if (onState)
+        choreographer.subscribe(onState);
+    // Refuse to open a stream to an apiBase that is neither https nor loopback
+    // http. Not a throw — a throw inside a customer's render tree is the one
+    // outcome this package exists to avoid — just the failed state the same
+    // consumer already handles for a dead transport.
+    if (!isSecureApiBase(target.apiBase)) {
+        choreographer.failed("apiBase must be https (http is allowed for localhost only)");
+        return {
+            choreographer,
+            finished: Promise.resolve(choreographer.getState()),
+            close: () => choreographer.dispose(),
+        };
+    }
+    const controller = new AbortController();
+    const abort = () => controller.abort();
+    // A signal that is ALREADY aborted never fires "abort" again, so wiring the
+    // listener alone would leak the stream open. Abort our controller up front.
+    if (options.signal?.aborted)
+        controller.abort();
+    else
+        options.signal?.addEventListener("abort", abort, { once: true });
+    const finished = (async () => {
+        try {
+            // `Accept` is a CORS-safelisted header and the protocol version rides
+            // the URL, so this stays a simple request: no preflight stands between
+            // a page and its stream. (The st-protocol REQUEST header is for
+            // consumer-supplied transports; ours never needs it.)
+            const response = await doFetch(buildStreamUrl(target), {
+                signal: controller.signal,
+                headers: { Accept: "text/event-stream" },
+            });
+            if (!response.ok) {
+                choreographer.failed(`stream request failed (${response.status})`);
+                return choreographer.getState();
+            }
+            const served = negotiatedProtocol(response);
+            choreographer.streamOpened();
+            await readSseStream(response, {
+                signal: controller.signal,
+                onMessage: (message) => {
+                    const data = parseData(message.data);
+                    if (message.event === EVENT_PROTOCOL_UNSUPPORTED) {
+                        const supported = Array.isArray(data.supported)
+                            ? data.supported.map(Number).filter(Number.isFinite)
+                            : [];
+                        onProtocolUnsupported?.({
+                            requested: typeof data.requested === "number" ? data.requested : PROTOCOL_CURRENT,
+                            supported,
+                        });
+                        // Not `failed`: nothing went wrong, this deployment is simply
+                        // older than this build. First paint stands, and we do not retry
+                        // — the same version would be refused again.
+                        choreographer.done({ contentSource: "static", protocolUnsupported: true });
+                        return;
+                    }
+                    // Unknown events are ignored by design: a newer server may emit
+                    // things this build predates, and the contract guarantees they are
+                    // additive.
+                    if (!isWireEvent(message.event))
+                        return;
+                    dispatch(choreographer, message.event, data, served);
+                },
+            });
+            // A stream that ends without `done` ended badly — but quietly, and
+            // whatever is painted stays painted. Two exceptions: a stream that
+            // already reported WHY it failed keeps that reason ("Campaign not
+            // found" tells someone what to fix; overwriting it here would throw
+            // away the only useful thing the server said), and a stream ended by
+            // our OWN controller — a deliberate `close()` — is not a failure at
+            // all, just a component unmounting.
+            const phase = choreographer.getState().phase;
+            if (!controller.signal.aborted && phase !== "settled" && phase !== "failed") {
+                choreographer.failed("stream ended without a done event");
+            }
+        }
+        catch (error) {
+            if (!controller.signal.aborted) {
+                choreographer.failed(error instanceof Error ? error.message : String(error));
+            }
+        }
+        finally {
+            options.signal?.removeEventListener("abort", abort);
+        }
+        return choreographer.getState();
+    })();
+    return {
+        choreographer,
+        finished,
+        close: () => {
+            abort();
+            choreographer.dispose();
+        },
+    };
+}
+function dispatch(choreographer, event, data, _protocol) {
+    switch (event) {
+        case "theme-ready":
+            choreographer.themeReady(data.colors ?? {}, data.sources ?? {});
+            return;
+        case "experience-ready":
+            choreographer.layoutReady(str(data.layout), data.experienceManifest);
+            return;
+        case "layout-ready":
+            choreographer.layoutReady(str(data.layout));
+            return;
+        case "background-ready":
+            choreographer.backgroundReady(str(data.bgImage));
+            return;
+        case "sequence-ready":
+            choreographer.sequenceReady(Array.isArray(data.frames) ? data.frames : [], typeof data.heroIndex === "number" ? data.heroIndex : 0, typeof data.fps === "number" ? data.fps : 8);
+            return;
+        case "video-ready":
+            choreographer.videoReady(str(data.videoUrl));
+            return;
+        case "cta-style-ready":
+            choreographer.ctaStyleReady(data.style);
+            return;
+        case "cta-ready":
+            // The action is rendered as an <a href> in the customer's origin, so it
+            // is vetted before it ever reaches state: a server-supplied
+            // `javascript:` URL is click-XSS, and `undefined` degrades to a plain
+            // button rather than a poisoned link.
+            choreographer.ctaReady(str(data.text), data.style, safeActionUrl(str(data.action) || undefined));
+            return;
+        case "done":
+            choreographer.done(data.meta ?? {});
+            return;
+        case "error":
+            choreographer.failed(str(data.error, "stream error"));
+            return;
+        default:
+            break;
+    }
+    const field = copyFieldOf(event);
+    if (!field)
+        return;
+    if (event.endsWith("-start")) {
+        // An unlabelled start is an older edge revision mid-rollout: null mode
+        // takes the replay path, which is byte-identical to pre-negotiation
+        // behaviour. `static` is the honest default for undeclared provenance —
+        // silence must never be read as evidence of generation.
+        //
+        // Both enums are validated against the contract vocabularies rather than
+        // cast: the wire is untrusted, and an unknown string landing in the
+        // public typed state would drive trust chrome off a value the contract
+        // never defined. Unknown mode → null (unlabelled path); unknown source →
+        // "static" (the no-claim default).
+        const mode = typeof data.mode === "string" && COPY_MODES.includes(data.mode)
+            ? data.mode
+            : null;
+        const source = typeof data.contentSource === "string" &&
+            CONTENT_SOURCES.includes(data.contentSource)
+            ? data.contentSource
+            : "static";
+        choreographer.copyStart(field, mode, source);
+        return;
+    }
+    if (event.endsWith("-chunk")) {
+        choreographer.copyChunk(field, str(data.text));
+        return;
+    }
+    if (event.endsWith("-done")) {
+        choreographer.copyDone(field, str(data.text));
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/context.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Declared-context canonicalization — the TS arm of `ctxhash`.
+ *
+ * One algorithm, two implementations: this file and
+ * `mosaic-edge-serve/internal/ctxhash`. The shared vectors in
+ * `sdk/parity/fixtures/ctxhash/vectors.json` are the contract; a change here
+ * that is not mirrored in Go fails both parity suites.
+ *
+ * The vocabulary is CLOSED on purpose: it is simultaneously the cardinality
+ * fence (the cache-key space is the product of small enums) and the injection
+ * defense (attacker-reachable strings never key a shared cache entry).
+ * Unknown keys are dropped at both ends, by contract. An unknown value for a
+ * known enum is dropped from the hash — never a new bucket, never a
+ * generation.
+ *
+ * The client's hash is a cache hint. The server re-canonicalizes from raw
+ * dims and its own hash is the identity for generation, billing, and
+ * admission — nobody gets to pre-poison a bucket.
+ */
+/** Platform intent vocabulary. */
+export declare const CONTEXT_INTENTS: readonly ["signup", "signin", "retain", "upsell", "reassure", "explain", "browse", "convert"];
+/** Dayparts — the timecontext classification, lowercased for the hash. */
+export declare const CONTEXT_DAYPARTS: readonly ["earlymorning", "morning", "latemorning", "midday", "afternoon", "evening", "lateevening", "latenight"];
+export declare const CONTEXT_DAY_TYPES: readonly ["weekday", "weekend"];
+export declare const CONTEXT_WEATHER: readonly ["clear", "cloudy", "rainy", "snowy"];
+export declare const CONTEXT_TEMP_BANDS: readonly ["cold", "mild", "warm", "hot"];
+export declare const CONTEXT_DEVICES: readonly ["mobile", "tablet", "desktop", "signage"];
+/** Existing platform surface-type vocabulary (mosaic/lib/surface-types.ts). */
+export declare const CONTEXT_SURFACE_TYPES: readonly ["vending", "retail", "transit", "stadium", "mall", "outdoor_billboard", "indoor_display", "point_of_sale", "lobby", "speaker", "kiosk", "ar", "web", "other", "grocery", "convenience", "restaurant", "cafe", "bar"];
+export declare const MAX_CUSTOM_DIMS = 4;
+export declare const MAX_NOTES_LENGTH = 280;
+/** Canonical dim map: short keys, normalized lowercase values. */
+export type CanonicalDims = Record<string, string>;
+/** Developer-declared placement, the public shape (long field names). */
+export interface DeclaredContext {
+    /** Declared page class, `[a-z0-9-]{1,32}`. Never a URL or path. */
+    page?: string;
+    /** Platform intent enum. */
+    intent?: string;
+    /** Placement descriptor, never a user identifier. */
+    audience?: string;
+    /**
+     * Free text, ≤280 chars, describing the placement — never the visitor.
+     * Hashed in full: a distinct notes value is a distinct context.
+     */
+    notes?: string;
+    /** Org-declared custom dims: `{ tier: "pro" }` becomes dim `x.tier`. */
+    custom?: Record<string, string>;
+}
+/**
+ * Normalizes the free-text `notes` dim. Returns undefined when the field is
+ * empty after scrubbing or matches a rejected shape (emails, phone numbers,
+ * long token-like runs) — the field is dropped, never partially kept.
+ */
+export declare function normalizeNotes(raw: string): string | undefined;
+export interface NormalizeResult {
+    dims: CanonicalDims;
+    /** Keys (or `key=value` pairs) removed during normalization, for dev warnings. */
+    dropped: string[];
+}
+/**
+ * Normalizes a raw dim map into canonical dims: unknown keys dropped, enum
+ * values validated, tokens pattern-checked, custom dims capped at
+ * MAX_CUSTOM_DIMS (bytewise-first wins, deterministically), notes scrubbed.
+ */
+export declare function normalizeDims(raw: Record<string, unknown>): NormalizeResult;
+/** Maps the public DeclaredContext shape onto short-key dims. */
+export declare function declaredToDims(declared: DeclaredContext): Record<string, unknown>;
+/**
+ * Canonical form: drop absent/unknown keys → lowercase → sort keys bytewise →
+ * join "k:v|k:v". Already-normalized dims only; run normalizeDims first.
+ */
+export declare function canonicalContextString(dims: CanonicalDims): string;
+/** sha256(canonical) → hex, truncated to 16 chars (64 bits). */
+export declare function computeContextHash(dims: CanonicalDims): Promise<string>;
+/** Length-budget floors per kind — ceilings on the ceiling (spec §2.6). They
+ * cap the case where a developer's fallback is a single word. */
+export declare const FRAGMENT_KIND_FLOORS: Record<string, number>;
+/**
+ * ceil(max(len(fallback) × 1.3, floor(kind))). The developer's own fallback
+ * defines the layout envelope, which is what makes CLS zero by construction.
+ * Server twin: mosaic/services/fragments/fragmentService.ts computeFieldBudget
+ * — the server recomputes and never trusts the client's number.
+ */
+export declare function computeFieldBudget(fallback: string, kind: string): number;
+/**
+ * Schema hash: keys + kinds + budgets, never the fallback prose (prose in the
+ * GET URL would make the CDN object private and delete the cost story). MUST
+ * stay byte-identical to mosaic/services/fragments/fragmentService.ts
+ * computeSchemaHash; the shared vectors in
+ * sdk/parity/fixtures/ctxhash/schema-vectors.json are the contract.
+ */
+export declare function computeSchemaHash(fields: readonly {
+    key: string;
+    kind: string;
+    budget: number;
+}[]): Promise<string>;
+/** Convenience: declared shape → normalized dims → hash. */
+export declare function hashDeclaredContext(declared: DeclaredContext, environment?: Record<string, unknown>): Promise<{
+    dims: CanonicalDims;
+    hash: string;
+    dropped: string[];
+}>;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,kCAAkC;AAClC,eAAO,MAAM,eAAe,+FASlB,CAAC;AAEX,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,mHASnB,CAAC;AAEX,eAAO,MAAM,iBAAiB,iCAAkC,CAAC;AACjE,eAAO,MAAM,eAAe,gDAAiD,CAAC;AAC9E,eAAO,MAAM,kBAAkB,0CAA2C,CAAC;AAC3E,eAAO,MAAM,eAAe,qDAAsD,CAAC;AAEnF,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,gOAoBxB,CAAC;AAUX,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,kEAAkE;AAClE,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEnD,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAmBD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAe9D;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,kFAAkF;IAClF,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAiE3E;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUjF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAOlE;AAaD,gEAAgE;AAChE,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAE7E;AAID;iEACiE;AACjE,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMvD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGzE;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,GAC/D,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED,4DAA4D;AAC5D,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,eAAe,EACzB,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACxC,OAAO,CAAC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAGnE"}

package/dist/context.js

@@ -0,0 +1,277 @@
+/**
+ * Declared-context canonicalization — the TS arm of `ctxhash`.
+ *
+ * One algorithm, two implementations: this file and
+ * `mosaic-edge-serve/internal/ctxhash`. The shared vectors in
+ * `sdk/parity/fixtures/ctxhash/vectors.json` are the contract; a change here
+ * that is not mirrored in Go fails both parity suites.
+ *
+ * The vocabulary is CLOSED on purpose: it is simultaneously the cardinality
+ * fence (the cache-key space is the product of small enums) and the injection
+ * defense (attacker-reachable strings never key a shared cache entry).
+ * Unknown keys are dropped at both ends, by contract. An unknown value for a
+ * known enum is dropped from the hash — never a new bucket, never a
+ * generation.
+ *
+ * The client's hash is a cache hint. The server re-canonicalizes from raw
+ * dims and its own hash is the identity for generation, billing, and
+ * admission — nobody gets to pre-poison a bucket.
+ */
+/** Platform intent vocabulary. */
+export const CONTEXT_INTENTS = [
+    "signup",
+    "signin",
+    "retain",
+    "upsell",
+    "reassure",
+    "explain",
+    "browse",
+    "convert",
+];
+/** Dayparts — the timecontext classification, lowercased for the hash. */
+export const CONTEXT_DAYPARTS = [
+    "earlymorning",
+    "morning",
+    "latemorning",
+    "midday",
+    "afternoon",
+    "evening",
+    "lateevening",
+    "latenight",
+];
+export const CONTEXT_DAY_TYPES = ["weekday", "weekend"];
+export const CONTEXT_WEATHER = ["clear", "cloudy", "rainy", "snowy"];
+export const CONTEXT_TEMP_BANDS = ["cold", "mild", "warm", "hot"];
+export const CONTEXT_DEVICES = ["mobile", "tablet", "desktop", "signage"];
+/** Existing platform surface-type vocabulary (mosaic/lib/surface-types.ts). */
+export const CONTEXT_SURFACE_TYPES = [
+    "vending",
+    "retail",
+    "transit",
+    "stadium",
+    "mall",
+    "outdoor_billboard",
+    "indoor_display",
+    "point_of_sale",
+    "lobby",
+    "speaker",
+    "kiosk",
+    "ar",
+    "web",
+    "other",
+    "grocery",
+    "convenience",
+    "restaurant",
+    "cafe",
+    "bar",
+];
+/** Org-declared token dims (`p`, `a`) and custom-dim values. */
+const TOKEN_PATTERN = /^[a-z0-9-]{1,32}$/;
+/** Custom dim keys: `x.` + a short token. */
+const CUSTOM_KEY_PATTERN = /^x\.[a-z0-9-]{1,24}$/;
+/** Loose BCP-47 shape, lowercased. */
+const LOCALE_PATTERN = /^[a-z]{2,3}(-[a-z0-9]{2,8})*$/;
+const COUNTRY_PATTERN = /^[a-z]{2}$/;
+export const MAX_CUSTOM_DIMS = 4;
+export const MAX_NOTES_LENGTH = 280;
+const ENUM_DIMS = {
+    i: CONTEXT_INTENTS,
+    t: CONTEXT_DAYPARTS,
+    y: CONTEXT_DAY_TYPES,
+    w: CONTEXT_WEATHER,
+    b: CONTEXT_TEMP_BANDS,
+    d: CONTEXT_DEVICES,
+    s: CONTEXT_SURFACE_TYPES,
+};
+const MARKUP_PATTERN = /<[^>]*>/g;
+const URL_PATTERN = /(?:https?:\/\/|www\.)\S+/gi;
+/** Shapes that indicate visitor data or secrets: reject the whole field. */
+const EMAIL_PATTERN = /\S+@\S+/;
+const PHONE_PATTERN = /(?:\d[\s().+-]*){7,}/;
+const TOKEN_SHAPE_PATTERN = /[a-z0-9_-]{24,}/;
+/**
+ * Normalizes the free-text `notes` dim. Returns undefined when the field is
+ * empty after scrubbing or matches a rejected shape (emails, phone numbers,
+ * long token-like runs) — the field is dropped, never partially kept.
+ */
+export function normalizeNotes(raw) {
+    let value = raw
+        .replace(MARKUP_PATTERN, " ")
+        .replace(URL_PATTERN, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+        .toLowerCase();
+    // Cap by code points, matching the Go arm's rune slicing.
+    const points = Array.from(value);
+    if (points.length > MAX_NOTES_LENGTH)
+        value = points.slice(0, MAX_NOTES_LENGTH).join("").trim();
+    if (value.length === 0)
+        return undefined;
+    if (EMAIL_PATTERN.test(value) || PHONE_PATTERN.test(value) || TOKEN_SHAPE_PATTERN.test(value)) {
+        return undefined;
+    }
+    return value;
+}
+/**
+ * Normalizes a raw dim map into canonical dims: unknown keys dropped, enum
+ * values validated, tokens pattern-checked, custom dims capped at
+ * MAX_CUSTOM_DIMS (bytewise-first wins, deterministically), notes scrubbed.
+ */
+export function normalizeDims(raw) {
+    const dims = {};
+    const dropped = [];
+    const customKeys = [];
+    for (const [rawKey, rawValue] of Object.entries(raw)) {
+        if (rawValue === undefined || rawValue === null || rawValue === "")
+            continue;
+        const key = rawKey.toLowerCase();
+        const value = String(rawValue).toLowerCase().trim();
+        if (value === "")
+            continue;
+        if (key === "n") {
+            const notes = normalizeNotes(String(rawValue));
+            if (notes === undefined)
+                dropped.push(key);
+            else
+                dims.n = notes;
+            continue;
+        }
+        if (key === "p" || key === "a") {
+            if (TOKEN_PATTERN.test(value))
+                dims[key] = value;
+            else
+                dropped.push(`${key}=${value}`);
+            continue;
+        }
+        if (key === "l") {
+            if (LOCALE_PATTERN.test(value)) {
+                dims.l = value;
+            }
+            else {
+                // Fall back to the primary language subtag (en-US-x-foo → en).
+                const subtag = value.split("-")[0];
+                if (/^[a-z]{2,3}$/.test(subtag))
+                    dims.l = subtag;
+                else
+                    dropped.push(`l=${value}`);
+            }
+            continue;
+        }
+        if (key === "c") {
+            if (COUNTRY_PATTERN.test(value))
+                dims.c = value;
+            else
+                dropped.push(`c=${value}`);
+            continue;
+        }
+        const enumValues = ENUM_DIMS[key];
+        if (enumValues) {
+            if (enumValues.includes(value))
+                dims[key] = value;
+            else
+                dropped.push(`${key}=${value}`);
+            continue;
+        }
+        if (CUSTOM_KEY_PATTERN.test(key)) {
+            if (TOKEN_PATTERN.test(value)) {
+                customKeys.push(key);
+                dims[key] = value;
+            }
+            else {
+                dropped.push(`${key}=${value}`);
+            }
+            continue;
+        }
+        dropped.push(key);
+    }
+    if (customKeys.length > MAX_CUSTOM_DIMS) {
+        customKeys.sort();
+        for (const key of customKeys.slice(MAX_CUSTOM_DIMS)) {
+            delete dims[key];
+            dropped.push(key);
+        }
+    }
+    return { dims, dropped };
+}
+/** Maps the public DeclaredContext shape onto short-key dims. */
+export function declaredToDims(declared) {
+    const raw = {};
+    if (declared.page !== undefined)
+        raw.p = declared.page;
+    if (declared.intent !== undefined)
+        raw.i = declared.intent;
+    if (declared.audience !== undefined)
+        raw.a = declared.audience;
+    if (declared.notes !== undefined)
+        raw.n = declared.notes;
+    for (const [name, value] of Object.entries(declared.custom ?? {})) {
+        raw[`x.${name.toLowerCase()}`] = value;
+    }
+    return raw;
+}
+/**
+ * Canonical form: drop absent/unknown keys → lowercase → sort keys bytewise →
+ * join "k:v|k:v". Already-normalized dims only; run normalizeDims first.
+ */
+export function canonicalContextString(dims) {
+    return Object.entries(dims)
+        .filter(([, value]) => value !== undefined && value !== null && value !== "")
+        .map(([key, value]) => [key.toLowerCase(), value.toLowerCase()])
+        .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+        .map(([key, value]) => `${key}:${value}`)
+        .join("|");
+}
+/** sha256(input) → hex, truncated to 16 chars (64 bits). WebCrypto, so it
+ * works unchanged in browsers, workers, and Node 18+. */
+async function sha256Hex16(input) {
+    const bytes = new TextEncoder().encode(input);
+    const digest = await globalThis.crypto.subtle.digest("SHA-256", bytes);
+    return Array.from(new Uint8Array(digest))
+        .map((byte) => byte.toString(16).padStart(2, "0"))
+        .join("")
+        .slice(0, 16);
+}
+/** sha256(canonical) → hex, truncated to 16 chars (64 bits). */
+export async function computeContextHash(dims) {
+    return sha256Hex16(canonicalContextString(dims));
+}
+// --- Fragment schema hashing (Declarative Context rung 2) -------------------
+/** Length-budget floors per kind — ceilings on the ceiling (spec §2.6). They
+ * cap the case where a developer's fallback is a single word. */
+export const FRAGMENT_KIND_FLOORS = {
+    cta: 24,
+    label: 32,
+    headline: 64,
+    body: 160,
+    "empty-state": 160,
+};
+/**
+ * ceil(max(len(fallback) × 1.3, floor(kind))). The developer's own fallback
+ * defines the layout envelope, which is what makes CLS zero by construction.
+ * Server twin: mosaic/services/fragments/fragmentService.ts computeFieldBudget
+ * — the server recomputes and never trusts the client's number.
+ */
+export function computeFieldBudget(fallback, kind) {
+    const floor = FRAGMENT_KIND_FLOORS[kind] ?? FRAGMENT_KIND_FLOORS.body;
+    return Math.ceil(Math.max(fallback.length * 1.3, floor));
+}
+/**
+ * Schema hash: keys + kinds + budgets, never the fallback prose (prose in the
+ * GET URL would make the CDN object private and delete the cost story). MUST
+ * stay byte-identical to mosaic/services/fragments/fragmentService.ts
+ * computeSchemaHash; the shared vectors in
+ * sdk/parity/fixtures/ctxhash/schema-vectors.json are the contract.
+ */
+export async function computeSchemaHash(fields) {
+    const canonical = [...fields]
+        .map((field) => `${field.key.toLowerCase()}:${field.kind}:${field.budget}`)
+        .sort()
+        .join("|");
+    return sha256Hex16(canonical);
+}
+/** Convenience: declared shape → normalized dims → hash. */
+export async function hashDeclaredContext(declared, environment = {}) {
+    const { dims, dropped } = normalizeDims({ ...environment, ...declaredToDims(declared) });
+    return { dims, hash: await computeContextHash(dims), dropped };
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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"}