@weatherboard/cms 0.8.0 → 0.10.0

package/README.md

@@ -42,10 +42,14 @@ when names match. The host keeps its repository data and chooses how to display
 the source. `menuQuery`, `parseMenuDocument` and `menuTags` remain the menu API.
 
 `openVacanciesQuery`, `parseVacancies` and `parseVacancyDocument` require the
-consumer's validator. The consumer can enforce its work-location choices and
-the note required for an `Other` choice. The package supplies no site-specific
-default. A-2463 will replace those choices with references to the client's
-`location` documents.
+consumer's validator, which receives each raw projected entry before display
+fields are derived. The query resolves `workLocation` to `{ _id, name }` and
+depends on both vacancy and location tags. The display label uses the resolved
+name, then a non-`Other` legacy `location`, then `locationNote`; a dangling
+reference falls through to the legacy fields. `locationId` is the resolved
+location's ID or `null`. An entry with no display label is structurally dropped.
+Legacy documents remain readable. Consumers whose validators require the legacy
+string must update them before migrating documents to references.
 
 ## Site hero
 
@@ -240,9 +244,11 @@ from a later caller read. The returned objects share no caller-owned data.
 CMS has no runtime dependency on the unpublished menu or schema packages.
 Compatibility is exercised with a copied, neutral café saved-shape fixture;
 there is no schema devDependency or menu test-fixture import. Publication tests
-resolve imports in source, all eight entry bundles and their build input paths,
+resolve imports in source, all ten entry bundles and their build input paths,
 including relative imports into either forbidden package root and type specifiers.
 Type-only test imports are refused too because the copied-fixture option was used.
+When adding a public entry, run the package's whole suite (`pnpm --filter @weatherboard/cms test`)
+and release smoke (`pnpm --filter @weatherboard/cms smoke`) before publication (A-553).
 
 ```ts
 import { menuQuery, menuTags } from '@weatherboard/cms';

package/dist/contracts/facts.d.cts

@@ -0,0 +1,163 @@
+/** Public contracts only. Evidence and approval identities never enter the CMS document. */
+export declare const FACT_TYPES: readonly ["integer", "decimal", "boolean", "date", "string", "enum", "reference"];
+export declare const FACT_DISPLAY_RULES: readonly ["identity/v1", "floorHundredsPlus/v1"];
+export type FactDisplayRule = typeof FACT_DISPLAY_RULES[number];
+export declare const FACT_KEY: RegExp;
+export declare const FACT_ALIASES: Readonly<Record<string, string>>;
+export type FactValue = {
+    type: "integer";
+    value: number;
+} | {
+    type: "decimal";
+    value: string;
+} | {
+    type: "boolean";
+    value: boolean;
+} | {
+    type: "date" | "string";
+    value: string;
+} | {
+    type: "enum";
+    value: string;
+    allowedValues: readonly string[];
+} | {
+    type: "reference";
+    value: {
+        documentId: string;
+        documentRevision: string;
+    };
+};
+export type FactSource = {
+    kind: "computed" | "observed" | "attested";
+    definition: string;
+    version: string;
+};
+export type BusinessFact = {
+    key: string;
+    publicValue: FactValue;
+    unit: string | null;
+    timezone: string | null;
+    displayRule: FactDisplayRule;
+    source: FactSource;
+    accountableOwner: string;
+    freshness: "computed" | "operational" | "technical";
+    optional: boolean;
+    surfaces: readonly {
+        id: string;
+        semantics: "current" | "historical";
+        asOf: string | null;
+    }[];
+};
+export declare const FACT_EXPIRY_MS: {
+    readonly computed: number;
+    readonly operational: number;
+    readonly technical: number;
+};
+export type FactEvidence = {
+    reference: string;
+    digest: string;
+    observedAt: string;
+    expiresAt: string;
+    complete: boolean;
+    runId: string;
+};
+export type FactRevision = {
+    projectId: string;
+    revision: number;
+    baseRevision: number | null;
+    fact: BusinessFact;
+    evidence: FactEvidence;
+    effectiveAt: string;
+    expiresAt: string;
+};
+export type ApprovedFactRevision = FactRevision & {
+    hash: string;
+    approvedAt: string;
+    approval: {
+        kind: "signer";
+        signerId: string;
+    } | {
+        kind: "policy";
+        policyVersion: string;
+    };
+};
+export type FactPublicationReceipt = {
+    intentId: string;
+    projectId: string;
+    revision: number;
+    hash: string;
+    destination: {
+        projectId: string;
+        dataset: string;
+    };
+    expectedDocumentRevision: string | null;
+    cms: {
+        transactionId: string;
+        documentRevision: string;
+        readBackHash: string;
+        at: string;
+    } | null;
+    invalidation: {
+        deliveryKey: string;
+        target: string;
+        type: "businessFact";
+        id: string;
+        at: string;
+    } | null;
+    render: {
+        url: string;
+        deploymentId: string;
+        revision: number;
+        hash: string;
+        at: string;
+    } | null;
+};
+export type PublicBusinessFact = Pick<BusinessFact, "key" | "publicValue" | "unit" | "timezone" | "displayRule"> & {
+    _type: "businessFact";
+    _id: string;
+    approvedRevision: number;
+    approvedHash: string;
+    effectiveAt: string;
+    expiresAt: string;
+    provenanceSummary: string;
+};
+/** A request supplies one snapshot to every surface. Missing and unavailable are distinct from an empty snapshot. */
+export type FactSnapshot = Readonly<Record<string, PublicBusinessFact>>;
+export type FactReadResult = {
+    status: "available";
+    snapshot: FactSnapshot;
+} | {
+    status: "unavailable";
+    reason: string;
+};
+export type FactReader = () => Promise<FactReadResult>;
+export type FactPlaceholderContext = "htmlText" | "htmlAttribute" | "json";
+/** Stored Sanity projection: scalar unions use named slots, never private revision fields. */
+export type StoredFactValue = {
+    type: FactValue["type"];
+    numberValue?: number;
+    textValue?: string;
+    booleanValue?: boolean;
+    allowedValues?: readonly string[];
+    documentId?: string;
+    documentRevision?: string;
+};
+export declare function parseStoredFactValue(input: unknown): FactValue;
+export declare function storeFactValue(input: FactValue): StoredFactValue;
+export type StoredBusinessFact = Omit<PublicBusinessFact, "publicValue"> & {
+    publicValue: StoredFactValue;
+};
+export declare function assertFactKey(key: string): void;
+export declare function businessFactId(key: string): string;
+export declare function parseFactValue(input: unknown): FactValue;
+export declare function parseFactDisplayRule(input: unknown): FactDisplayRule;
+export declare function formatFact(input: FactValue, rule: FactDisplayRule): string;
+/** Escape each replacement, not the surrounding trusted template. JSON returns string content without quotes;
+ * callers serialize complete structured objects and keep numeric properties as exact values. Attributes must be quoted.
+ * Raw text/React children use the formatter directly; never HTML-unescape an expanded string.
+ */
+export declare function expandFactPlaceholders(template: string, values: Readonly<Record<string, string>>, context: FactPlaceholderContext): string;
+/** Fixed JSON domain, sorted object keys, array order preserved, finite numbers only. */
+export declare function canonicalFactJson(value: unknown): string;
+/** SHA-256 of contract fields only; unknown fields and approval are ignored. Instants use UTC milliseconds. */
+export declare function hashFactRevision(revision: FactRevision): Promise<string>;

package/dist/contracts/facts.d.mts

@@ -0,0 +1,163 @@
+/** Public contracts only. Evidence and approval identities never enter the CMS document. */
+export declare const FACT_TYPES: readonly ["integer", "decimal", "boolean", "date", "string", "enum", "reference"];
+export declare const FACT_DISPLAY_RULES: readonly ["identity/v1", "floorHundredsPlus/v1"];
+export type FactDisplayRule = typeof FACT_DISPLAY_RULES[number];
+export declare const FACT_KEY: RegExp;
+export declare const FACT_ALIASES: Readonly<Record<string, string>>;
+export type FactValue = {
+    type: "integer";
+    value: number;
+} | {
+    type: "decimal";
+    value: string;
+} | {
+    type: "boolean";
+    value: boolean;
+} | {
+    type: "date" | "string";
+    value: string;
+} | {
+    type: "enum";
+    value: string;
+    allowedValues: readonly string[];
+} | {
+    type: "reference";
+    value: {
+        documentId: string;
+        documentRevision: string;
+    };
+};
+export type FactSource = {
+    kind: "computed" | "observed" | "attested";
+    definition: string;
+    version: string;
+};
+export type BusinessFact = {
+    key: string;
+    publicValue: FactValue;
+    unit: string | null;
+    timezone: string | null;
+    displayRule: FactDisplayRule;
+    source: FactSource;
+    accountableOwner: string;
+    freshness: "computed" | "operational" | "technical";
+    optional: boolean;
+    surfaces: readonly {
+        id: string;
+        semantics: "current" | "historical";
+        asOf: string | null;
+    }[];
+};
+export declare const FACT_EXPIRY_MS: {
+    readonly computed: number;
+    readonly operational: number;
+    readonly technical: number;
+};
+export type FactEvidence = {
+    reference: string;
+    digest: string;
+    observedAt: string;
+    expiresAt: string;
+    complete: boolean;
+    runId: string;
+};
+export type FactRevision = {
+    projectId: string;
+    revision: number;
+    baseRevision: number | null;
+    fact: BusinessFact;
+    evidence: FactEvidence;
+    effectiveAt: string;
+    expiresAt: string;
+};
+export type ApprovedFactRevision = FactRevision & {
+    hash: string;
+    approvedAt: string;
+    approval: {
+        kind: "signer";
+        signerId: string;
+    } | {
+        kind: "policy";
+        policyVersion: string;
+    };
+};
+export type FactPublicationReceipt = {
+    intentId: string;
+    projectId: string;
+    revision: number;
+    hash: string;
+    destination: {
+        projectId: string;
+        dataset: string;
+    };
+    expectedDocumentRevision: string | null;
+    cms: {
+        transactionId: string;
+        documentRevision: string;
+        readBackHash: string;
+        at: string;
+    } | null;
+    invalidation: {
+        deliveryKey: string;
+        target: string;
+        type: "businessFact";
+        id: string;
+        at: string;
+    } | null;
+    render: {
+        url: string;
+        deploymentId: string;
+        revision: number;
+        hash: string;
+        at: string;
+    } | null;
+};
+export type PublicBusinessFact = Pick<BusinessFact, "key" | "publicValue" | "unit" | "timezone" | "displayRule"> & {
+    _type: "businessFact";
+    _id: string;
+    approvedRevision: number;
+    approvedHash: string;
+    effectiveAt: string;
+    expiresAt: string;
+    provenanceSummary: string;
+};
+/** A request supplies one snapshot to every surface. Missing and unavailable are distinct from an empty snapshot. */
+export type FactSnapshot = Readonly<Record<string, PublicBusinessFact>>;
+export type FactReadResult = {
+    status: "available";
+    snapshot: FactSnapshot;
+} | {
+    status: "unavailable";
+    reason: string;
+};
+export type FactReader = () => Promise<FactReadResult>;
+export type FactPlaceholderContext = "htmlText" | "htmlAttribute" | "json";
+/** Stored Sanity projection: scalar unions use named slots, never private revision fields. */
+export type StoredFactValue = {
+    type: FactValue["type"];
+    numberValue?: number;
+    textValue?: string;
+    booleanValue?: boolean;
+    allowedValues?: readonly string[];
+    documentId?: string;
+    documentRevision?: string;
+};
+export declare function parseStoredFactValue(input: unknown): FactValue;
+export declare function storeFactValue(input: FactValue): StoredFactValue;
+export type StoredBusinessFact = Omit<PublicBusinessFact, "publicValue"> & {
+    publicValue: StoredFactValue;
+};
+export declare function assertFactKey(key: string): void;
+export declare function businessFactId(key: string): string;
+export declare function parseFactValue(input: unknown): FactValue;
+export declare function parseFactDisplayRule(input: unknown): FactDisplayRule;
+export declare function formatFact(input: FactValue, rule: FactDisplayRule): string;
+/** Escape each replacement, not the surrounding trusted template. JSON returns string content without quotes;
+ * callers serialize complete structured objects and keep numeric properties as exact values. Attributes must be quoted.
+ * Raw text/React children use the formatter directly; never HTML-unescape an expanded string.
+ */
+export declare function expandFactPlaceholders(template: string, values: Readonly<Record<string, string>>, context: FactPlaceholderContext): string;
+/** Fixed JSON domain, sorted object keys, array order preserved, finite numbers only. */
+export declare function canonicalFactJson(value: unknown): string;
+/** SHA-256 of contract fields only; unknown fields and approval are ignored. Instants use UTC milliseconds. */
+export declare function hashFactRevision(revision: FactRevision): Promise<string>;

package/dist/contracts/facts.d.ts

@@ -0,0 +1,163 @@
+/** Public contracts only. Evidence and approval identities never enter the CMS document. */
+export declare const FACT_TYPES: readonly ["integer", "decimal", "boolean", "date", "string", "enum", "reference"];
+export declare const FACT_DISPLAY_RULES: readonly ["identity/v1", "floorHundredsPlus/v1"];
+export type FactDisplayRule = typeof FACT_DISPLAY_RULES[number];
+export declare const FACT_KEY: RegExp;
+export declare const FACT_ALIASES: Readonly<Record<string, string>>;
+export type FactValue = {
+    type: "integer";
+    value: number;
+} | {
+    type: "decimal";
+    value: string;
+} | {
+    type: "boolean";
+    value: boolean;
+} | {
+    type: "date" | "string";
+    value: string;
+} | {
+    type: "enum";
+    value: string;
+    allowedValues: readonly string[];
+} | {
+    type: "reference";
+    value: {
+        documentId: string;
+        documentRevision: string;
+    };
+};
+export type FactSource = {
+    kind: "computed" | "observed" | "attested";
+    definition: string;
+    version: string;
+};
+export type BusinessFact = {
+    key: string;
+    publicValue: FactValue;
+    unit: string | null;
+    timezone: string | null;
+    displayRule: FactDisplayRule;
+    source: FactSource;
+    accountableOwner: string;
+    freshness: "computed" | "operational" | "technical";
+    optional: boolean;
+    surfaces: readonly {
+        id: string;
+        semantics: "current" | "historical";
+        asOf: string | null;
+    }[];
+};
+export declare const FACT_EXPIRY_MS: {
+    readonly computed: number;
+    readonly operational: number;
+    readonly technical: number;
+};
+export type FactEvidence = {
+    reference: string;
+    digest: string;
+    observedAt: string;
+    expiresAt: string;
+    complete: boolean;
+    runId: string;
+};
+export type FactRevision = {
+    projectId: string;
+    revision: number;
+    baseRevision: number | null;
+    fact: BusinessFact;
+    evidence: FactEvidence;
+    effectiveAt: string;
+    expiresAt: string;
+};
+export type ApprovedFactRevision = FactRevision & {
+    hash: string;
+    approvedAt: string;
+    approval: {
+        kind: "signer";
+        signerId: string;
+    } | {
+        kind: "policy";
+        policyVersion: string;
+    };
+};
+export type FactPublicationReceipt = {
+    intentId: string;
+    projectId: string;
+    revision: number;
+    hash: string;
+    destination: {
+        projectId: string;
+        dataset: string;
+    };
+    expectedDocumentRevision: string | null;
+    cms: {
+        transactionId: string;
+        documentRevision: string;
+        readBackHash: string;
+        at: string;
+    } | null;
+    invalidation: {
+        deliveryKey: string;
+        target: string;
+        type: "businessFact";
+        id: string;
+        at: string;
+    } | null;
+    render: {
+        url: string;
+        deploymentId: string;
+        revision: number;
+        hash: string;
+        at: string;
+    } | null;
+};
+export type PublicBusinessFact = Pick<BusinessFact, "key" | "publicValue" | "unit" | "timezone" | "displayRule"> & {
+    _type: "businessFact";
+    _id: string;
+    approvedRevision: number;
+    approvedHash: string;
+    effectiveAt: string;
+    expiresAt: string;
+    provenanceSummary: string;
+};
+/** A request supplies one snapshot to every surface. Missing and unavailable are distinct from an empty snapshot. */
+export type FactSnapshot = Readonly<Record<string, PublicBusinessFact>>;
+export type FactReadResult = {
+    status: "available";
+    snapshot: FactSnapshot;
+} | {
+    status: "unavailable";
+    reason: string;
+};
+export type FactReader = () => Promise<FactReadResult>;
+export type FactPlaceholderContext = "htmlText" | "htmlAttribute" | "json";
+/** Stored Sanity projection: scalar unions use named slots, never private revision fields. */
+export type StoredFactValue = {
+    type: FactValue["type"];
+    numberValue?: number;
+    textValue?: string;
+    booleanValue?: boolean;
+    allowedValues?: readonly string[];
+    documentId?: string;
+    documentRevision?: string;
+};
+export declare function parseStoredFactValue(input: unknown): FactValue;
+export declare function storeFactValue(input: FactValue): StoredFactValue;
+export type StoredBusinessFact = Omit<PublicBusinessFact, "publicValue"> & {
+    publicValue: StoredFactValue;
+};
+export declare function assertFactKey(key: string): void;
+export declare function businessFactId(key: string): string;
+export declare function parseFactValue(input: unknown): FactValue;
+export declare function parseFactDisplayRule(input: unknown): FactDisplayRule;
+export declare function formatFact(input: FactValue, rule: FactDisplayRule): string;
+/** Escape each replacement, not the surrounding trusted template. JSON returns string content without quotes;
+ * callers serialize complete structured objects and keep numeric properties as exact values. Attributes must be quoted.
+ * Raw text/React children use the formatter directly; never HTML-unescape an expanded string.
+ */
+export declare function expandFactPlaceholders(template: string, values: Readonly<Record<string, string>>, context: FactPlaceholderContext): string;
+/** Fixed JSON domain, sorted object keys, array order preserved, finite numbers only. */
+export declare function canonicalFactJson(value: unknown): string;
+/** SHA-256 of contract fields only; unknown fields and approval are ignored. Instants use UTC milliseconds. */
+export declare function hashFactRevision(revision: FactRevision): Promise<string>;

package/dist/fact-guard.cjs

@@ -0,0 +1,2 @@
+"use strict";var n=Object.defineProperty;var i=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var o=(s,t)=>{for(var e in t)n(s,e,{get:t[e],enumerable:!0})},g=(s,t,e,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of c(t))!l.call(s,r)&&r!==e&&n(s,r,{get:()=>t[r],enumerable:!(a=i(t,r))||a.enumerable});return s};var d=s=>g(n({},"__esModule",{value:!0}),s);var f={};o(f,{FACT_SURFACE_MANIFEST_VERSION:()=>y});module.exports=d(f);var y=1;0&&(module.exports={FACT_SURFACE_MANIFEST_VERSION});
+//# sourceMappingURL=fact-guard.cjs.map

package/dist/fact-guard.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/fact-guard.ts"],
+  "sourcesContent": ["/** Registration seam for the later manifest guard; historical exclusions require evidence. */\nexport const FACT_SURFACE_MANIFEST_VERSION = 1 as const;\nexport type FactSurfaceManifest = {\n  facts: readonly { key: string; literals: readonly string[] }[];\n  surfaces: readonly { id: string; path: string; semantics: \"current\" | \"historical\" }[];\n  exclusions: readonly { path: string; literal: string; asOf: string; evidence: string }[];\n};\n"],
+  "mappings": "yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,mCAAAE,IAAA,eAAAC,EAAAH,GACO,IAAME,EAAgC",
+  "names": ["fact_guard_exports", "__export", "FACT_SURFACE_MANIFEST_VERSION", "__toCommonJS"]
+}

package/dist/fact-guard.d.cts

@@ -0,0 +1,19 @@
+/** Registration seam for the later manifest guard; historical exclusions require evidence. */
+export declare const FACT_SURFACE_MANIFEST_VERSION: 1;
+export type FactSurfaceManifest = {
+    facts: readonly {
+        key: string;
+        literals: readonly string[];
+    }[];
+    surfaces: readonly {
+        id: string;
+        path: string;
+        semantics: "current" | "historical";
+    }[];
+    exclusions: readonly {
+        path: string;
+        literal: string;
+        asOf: string;
+        evidence: string;
+    }[];
+};

package/dist/fact-guard.d.mts

@@ -0,0 +1,19 @@
+/** Registration seam for the later manifest guard; historical exclusions require evidence. */
+export declare const FACT_SURFACE_MANIFEST_VERSION: 1;
+export type FactSurfaceManifest = {
+    facts: readonly {
+        key: string;
+        literals: readonly string[];
+    }[];
+    surfaces: readonly {
+        id: string;
+        path: string;
+        semantics: "current" | "historical";
+    }[];
+    exclusions: readonly {
+        path: string;
+        literal: string;
+        asOf: string;
+        evidence: string;
+    }[];
+};

package/dist/fact-guard.d.ts

@@ -0,0 +1,19 @@
+/** Registration seam for the later manifest guard; historical exclusions require evidence. */
+export declare const FACT_SURFACE_MANIFEST_VERSION: 1;
+export type FactSurfaceManifest = {
+    facts: readonly {
+        key: string;
+        literals: readonly string[];
+    }[];
+    surfaces: readonly {
+        id: string;
+        path: string;
+        semantics: "current" | "historical";
+    }[];
+    exclusions: readonly {
+        path: string;
+        literal: string;
+        asOf: string;
+        evidence: string;
+    }[];
+};

package/dist/fact-guard.mjs

@@ -0,0 +1,2 @@
+var t=1;export{t as FACT_SURFACE_MANIFEST_VERSION};
+//# sourceMappingURL=fact-guard.mjs.map

package/dist/fact-guard.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/fact-guard.ts"],
+  "sourcesContent": ["/** Registration seam for the later manifest guard; historical exclusions require evidence. */\nexport const FACT_SURFACE_MANIFEST_VERSION = 1 as const;\nexport type FactSurfaceManifest = {\n  facts: readonly { key: string; literals: readonly string[] }[];\n  surfaces: readonly { id: string; path: string; semantics: \"current\" | \"historical\" }[];\n  exclusions: readonly { path: string; literal: string; asOf: string; evidence: string }[];\n};\n"],
+  "mappings": "AACO,IAAMA,EAAgC",
+  "names": ["FACT_SURFACE_MANIFEST_VERSION"]
+}

package/dist/facts.cjs

@@ -0,0 +1,2 @@
+"use strict";var d=Object.defineProperty;var x=Object.getOwnPropertyDescriptor;var R=Object.getOwnPropertyNames;var A=Object.prototype.hasOwnProperty;var S=(e,t)=>{for(var n in t)d(e,n,{get:t[n],enumerable:!0})},w=(e,t,n,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let a of R(t))!A.call(e,a)&&a!==n&&d(e,a,{get:()=>t[a],enumerable:!(r=x(t,a))||r.enumerable});return e};var h=e=>w(d({},"__esModule",{value:!0}),e);var k={};S(k,{FACT_ALIASES:()=>g,FACT_DISPLAY_RULES:()=>I,FACT_EXPIRY_MS:()=>m,FACT_KEY:()=>y,FACT_TYPES:()=>V,assertFactKey:()=>p,businessFactId:()=>D,canonicalFactJson:()=>l,expandFactPlaceholders:()=>P,formatFact:()=>v,hashFactRevision:()=>_,parseFactDisplayRule:()=>b,parseFactValue:()=>c,parseStoredFactValue:()=>O,storeFactValue:()=>j});module.exports=h(k);var V=["integer","decimal","boolean","date","string","enum","reference"],I=["identity/v1","floorHundredsPlus/v1"],y=/^[a-z][a-zA-Z0-9]*(?:\.[a-zA-Z][a-zA-Z0-9]*)*$/,g={pubCount:"coverage.pubCount"},m={computed:72*36e5,operational:30*864e5,technical:90*864e5};function O(e){let t=f(e),n=t.type==="integer"?t.numberValue:t.type==="boolean"?t.booleanValue:t.type==="reference"?{documentId:t.documentId,documentRevision:t.documentRevision}:t.textValue;return c({type:t.type,value:n,allowedValues:t.allowedValues})}function j(e){let t=c(e);return t.type==="integer"?{type:t.type,numberValue:t.value}:t.type==="boolean"?{type:t.type,booleanValue:t.value}:t.type==="reference"?{type:t.type,...t.value}:t.type==="enum"?{type:t.type,textValue:t.value,allowedValues:t.allowedValues}:{type:t.type,textValue:t.value}}function s(){throw new Error("Invalid business fact contract")}function f(e){return!e||typeof e!="object"||Array.isArray(e)?s():e}function o(e){return typeof e=="string"&&e.trim()!==""?e:s()}function p(e){(e.length>48||!y.test(e))&&s()}function D(e){return p(e),"businessFact-"+Array.from(new TextEncoder().encode(e),t=>t.toString(16).padStart(2,"0")).join("")}function c(e){let t=f(e),n=t.value;switch(t.type){case"integer":return Number.isSafeInteger(n)?{type:"integer",value:n}:s();case"decimal":return typeof n=="string"&&/^(?:0|-?[1-9]\d*)(?:\.\d*[1-9])?$|^-0\.\d*[1-9]$/.test(n)?{type:"decimal",value:n}:s();case"boolean":return typeof n=="boolean"?{type:"boolean",value:n}:s();case"string":return typeof n=="string"?{type:"string",value:n}:s();case"date":return typeof n=="string"&&/^\d{4}-\d{2}-\d{2}$/.test(n)&&!Number.isNaN(Date.parse(n))&&new Date(n).toISOString().slice(0,10)===n?{type:"date",value:n}:s();case"enum":{let r=t.allowedValues;return!Array.isArray(r)||!r.length||!r.every(a=>typeof a=="string"&&a!=="")||new Set(r).size!==r.length||!r.includes(n)?s():{type:"enum",value:o(n),allowedValues:[...r].sort()}}case"reference":{let r=f(n);return{type:"reference",value:{documentId:o(r.documentId),documentRevision:o(r.documentRevision)}}}default:return s()}}function b(e){return e!=="identity/v1"&&e!=="floorHundredsPlus/v1"?s():e}function v(e,t){let n=c(e);return b(t)==="floorHundredsPlus/v1"?n.type!=="integer"||n.value<0?s():n.value<100?String(n.value):`${(Math.floor(n.value/100)*100).toLocaleString("en-GB")}+`:n.type==="reference"?n.value.documentId:String(n.value)}function P(e,t,n){return["htmlText","htmlAttribute","json"].includes(n)?e.replace(/\{([^{}]*)\}/g,(r,a)=>{p(a);let u=Object.hasOwn(g,a)?g[a]:a;if(!Object.hasOwn(t,u))throw new Error(`Unknown fact placeholder: ${a}`);let i=t[u];return n==="json"?JSON.stringify(i).slice(1,-1).replace(/</g,"\\u003c").replace(/>/g,"\\u003e").replace(/&/g,"\\u0026").replace(/\u2028/g,"\\u2028").replace(/\u2029/g,"\\u2029"):i.replace(/[&<>"']/g,F=>({"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;"})[F])}):s()}function l(e){return e===null||typeof e=="boolean"||typeof e=="string"||typeof e=="number"&&Number.isFinite(e)?JSON.stringify(e):Array.isArray(e)?`[${Array.from(e,l).join(",")}]`:typeof e!="object"||e===null||Object.getPrototypeOf(e)!==Object.prototype?s():`{${Object.entries(e).sort(([t],[n])=>t<n?-1:t>n?1:0).map(([t,n])=>`${JSON.stringify(t)}:${l(n)}`).join(",")}}`}async function _(e){let t=e.fact;p(t.key);let n=c(t.publicValue);v(n,t.displayRule),(!Number.isSafeInteger(e.revision)||e.revision<1||e.baseRevision!==null&&(!Number.isSafeInteger(e.baseRevision)||e.baseRevision<1||e.baseRevision>=e.revision))&&s(),o(e.projectId),o(t.accountableOwner),o(t.source.definition),o(t.source.version),(!["computed","observed","attested"].includes(t.source.kind)||!Object.hasOwn(m,t.freshness)||typeof t.optional!="boolean"||t.unit!==null&&typeof t.unit!="string")&&s(),t.timezone!==null&&new Intl.DateTimeFormat("en-GB",{timeZone:o(t.timezone)});let r=i=>((!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$/.test(i)||!Number.isFinite(Date.parse(i))||new Date(i).toISOString()!==i.replace(/(?<=:\d{2})Z$/,".000Z"))&&s(),Date.parse(i));(r(e.expiresAt)<=r(e.effectiveAt)||r(e.evidence.expiresAt)<=r(e.evidence.observedAt)||!/^[0-9a-f]{64}$/.test(e.evidence.digest)||typeof e.evidence.complete!="boolean")&&s(),o(e.evidence.reference),o(e.evidence.runId);for(let i of t.surfaces)o(i.id),i.semantics==="historical"?c({type:"date",value:i.asOf}):(i.semantics!=="current"||i.asOf!==null)&&s();let a={projectId:e.projectId,revision:e.revision,baseRevision:e.baseRevision,fact:{key:t.key,publicValue:n,unit:t.unit,timezone:t.timezone,displayRule:t.displayRule,source:{kind:t.source.kind,definition:t.source.definition,version:t.source.version},accountableOwner:t.accountableOwner,freshness:t.freshness,optional:t.optional,surfaces:t.surfaces.map(i=>({id:i.id,semantics:i.semantics,asOf:i.asOf}))},evidence:{reference:e.evidence.reference,digest:e.evidence.digest,complete:e.evidence.complete,runId:e.evidence.runId,observedAt:new Date(r(e.evidence.observedAt)).toISOString(),expiresAt:new Date(r(e.evidence.expiresAt)).toISOString()},effectiveAt:new Date(r(e.effectiveAt)).toISOString(),expiresAt:new Date(r(e.expiresAt)).toISOString()},u=await crypto.subtle.digest("SHA-256",new TextEncoder().encode(l(a)));return Array.from(new Uint8Array(u),i=>i.toString(16).padStart(2,"0")).join("")}0&&(module.exports={FACT_ALIASES,FACT_DISPLAY_RULES,FACT_EXPIRY_MS,FACT_KEY,FACT_TYPES,assertFactKey,businessFactId,canonicalFactJson,expandFactPlaceholders,formatFact,hashFactRevision,parseFactDisplayRule,parseFactValue,parseStoredFactValue,storeFactValue});
+//# sourceMappingURL=facts.cjs.map