@evinvest/sites-contract 0.1.2 → 0.1.3

package/README.md

@@ -11,14 +11,15 @@ src/generated/contract.ts  panel_core's shapes, vocabularies and limits (`nix ru
 src/generated/wire.ts      the protos as protojson: the envelope, every type's properties
 src/*.ts                   the one TS implementation of what both sides run, held to
                            contracts/vectors with panel_core:
-  pricing    checkPricingModel, priceOf
-  booking    checkBookingConfig, checkBookingUrl, bookingRequested, isLeadRef
+  price      priceOf: what a page runs        pricing         checkPricingModel
+  booking    bookingRequested, isLeadRef      booking-config  checkBookingConfig, checkBookingUrl
   place      checkPlaceLive: a place's live settings, field by field
   phone      normalizePhone, phoneProblem
   ingest     siteEvent, ingestBody, uuidV7, isOpaqueId: the only way a site builds an event
   experiments parseLiveExperiments, declarationProblem
 ```
 
+A page bundles what it runs and not the panel's checks: they sit in modules of their own.
 Checks answer `{ path, code }` problems, never words: a site logs them, the panel's editor says
 each code in its own copy.
 

package/dist/booking-config.d.ts

@@ -0,0 +1,22 @@
+import type { BookingCode } from "./generated/codes.js";
+import type { BookingConfig, PageProvider } from "./generated/types.js";
+/** One thing wrong with a place's `booking`: where below it (`""`, `default`, `providers.cal_com.url`) and why. */
+export interface BookingProblem {
+    path: string;
+    code: BookingCode;
+}
+/**
+ * Why `url` may not be `provider`'s booking page, or `null` (`contracts/vectors/booking/README.md`,
+ * normative): at most 2048 printable ASCII; the literal `https://`; no `#` and no `\`; an
+ * authority without `@`, `:` or `[`; a dotted DNS name whose last label is not a number; then
+ * the provider's own rule.
+ */
+export declare function checkBookingUrl(provider: PageProvider, url: string): BookingCode | null;
+/**
+ * A place's `booking` checked whole: every problem, and the config when there is none. `manual`
+ * is always available, so never a key of `providers`; the default is `manual` or one of them.
+ */
+export declare function checkBookingConfig(v: unknown): {
+    problems: BookingProblem[];
+    config: BookingConfig | null;
+};

package/dist/booking-config.js

@@ -0,0 +1,101 @@
+import { isBookingProvider, isPageProvider } from "./booking.js";
+import { BOOKING_LIMITS as LIMIT } from "./generated/booking.js";
+import { at, isObject } from "./text.js";
+const CAL_SEGMENT = /* @__PURE__ */ new RegExp(LIMIT.calComSegment);
+const LABEL = /^[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?$/;
+const APPOINTMENTS = "/calendar/appointments/";
+/**
+ * Why `url` may not be `provider`'s booking page, or `null` (`contracts/vectors/booking/README.md`,
+ * normative): at most 2048 printable ASCII; the literal `https://`; no `#` and no `\`; an
+ * authority without `@`, `:` or `[`; a dotted DNS name whose last label is not a number; then
+ * the provider's own rule.
+ */
+export function checkBookingUrl(provider, url) {
+    if (url.length === 0 || url.length > LIMIT.maxUrl || !/^[\x21-\x7e]+$/.test(url))
+        return "format";
+    if (!url.startsWith("https://"))
+        return "scheme";
+    if (url.includes("#"))
+        return "fragment";
+    if (url.includes("\\"))
+        return "backslash";
+    const rest = url.slice("https://".length);
+    const split = rest.search(/[/?]/);
+    const host = split < 0 ? rest : rest.slice(0, split);
+    if (host.includes("@"))
+        return "userinfo";
+    if (host.startsWith("["))
+        return "ip";
+    if (host.includes(":"))
+        return "port";
+    const labels = host.split(".");
+    if (host.length > 253 || labels.length < 2 || !labels.every(l => LABEL.test(l)))
+        return "host";
+    const last = (labels.at(-1) ?? "").toLowerCase();
+    // A WHATWG parser reads a host whose last label is a number as an IPv4 address.
+    if (/^\d+$/.test(last) || last.startsWith("0x"))
+        return "ip";
+    const name = host.toLowerCase();
+    const path = (split < 0 ? "" : rest.slice(split)).split("?")[0] ?? "";
+    switch (provider) {
+        case "link":
+            return null;
+        case "google_calendar":
+            return (name === "calendar.app.google" && path.length > 1) || (name === "calendar.google.com" && path.length > APPOINTMENTS.length && path.startsWith(APPOINTMENTS)) ? null : "google";
+        case "cal_com": {
+            if (!LIMIT.calComHosts.some(h => h === name))
+                return "cal_host";
+            const segments = path.replace(/^\//, "").split("/");
+            return path.startsWith("/") && segments.length === 2 && segments.every(s => CAL_SEGMENT.test(s)) ? null : "cal_path";
+        }
+    }
+}
+/**
+ * A place's `booking` checked whole: every problem, and the config when there is none. `manual`
+ * is always available, so never a key of `providers`; the default is `manual` or one of them.
+ */
+export function checkBookingConfig(v) {
+    const problems = [];
+    const fail = (path, code) => problems.push({ path, code });
+    if (!isObject(v))
+        return { problems: [{ path: "", code: "shape" }], config: null };
+    if (Object.keys(v).some(k => k !== "default" && k !== "providers"))
+        fail("", "unknown_key");
+    const def = isBookingProvider(v.default) ? v.default : null;
+    if (!Object.hasOwn(v, "default"))
+        fail("default", "required");
+    else if (def === null)
+        fail("default", "default_unknown");
+    const providers = {};
+    if (!Object.hasOwn(v, "providers"))
+        fail("providers", "required");
+    else if (!isObject(v.providers))
+        fail("providers", "shape");
+    else
+        for (const [name, conf] of Object.entries(v.providers)) {
+            const path = at("providers", name);
+            if (!isBookingProvider(name))
+                fail(path, "provider_unknown");
+            else if (!isObject(conf))
+                fail(path, "provider_shape");
+            else if (Object.keys(conf).some(k => k !== "url"))
+                fail(path, "provider_extra");
+            else if (!isPageProvider(name))
+                fail(path, "manual");
+            else if (!Object.hasOwn(conf, "url"))
+                fail(at(path, "url"), "required");
+            else if (typeof conf.url !== "string")
+                fail(at(path, "url"), "url_type");
+            else {
+                const bad = checkBookingUrl(name, conf.url);
+                if (bad)
+                    fail(at(path, "url"), bad);
+                else
+                    providers[name] = { url: conf.url };
+            }
+        }
+    // A default whose own entry is refused is blamed there, not twice.
+    if (isPageProvider(def) && !Object.hasOwn(providers, def) && !problems.some(p => p.path.startsWith(at("providers", def))))
+        fail("default", "default_unset");
+    return problems.length > 0 || def === null ? { problems, config: null } : { problems, config: { default: def, providers } };
+}

package/dist/booking.d.ts

@@ -1,31 +1,10 @@
 import { type DayPart } from "./generated/booking.js";
-import type { BookingCode } from "./generated/codes.js";
-import type { BookingConfig, BookingProvider, PageProvider } from "./generated/types.js";
+import type { BookingProvider, PageProvider } from "./generated/types.js";
 import type { BookingRequestedV1 } from "./generated/wire.js";
-/** One thing wrong with a place's `booking`: where below it (`""`, `default`, `providers.cal_com.url`) and why. */
-export interface BookingProblem {
-    path: string;
-    code: BookingCode;
-}
 export declare const isBookingProvider: (v: unknown) => v is BookingProvider;
 export declare const isPageProvider: (v: unknown) => v is PageProvider;
 /** `lead-<row>-<8 lowercase hex>`, the row 1 or more: the panel's lead id for a site's lead. */
 export declare const isLeadRef: (v: unknown) => v is string;
-/**
- * Why `url` may not be `provider`'s booking page, or `null` (`contracts/vectors/booking/README.md`,
- * normative): at most 2048 printable ASCII; the literal `https://`; no `#` and no `\`; an
- * authority without `@`, `:` or `[`; a dotted DNS name whose last label is not a number; then
- * the provider's own rule.
- */
-export declare function checkBookingUrl(provider: PageProvider, url: string): BookingCode | null;
-/**
- * A place's `booking` checked whole: every problem, and the config when there is none. `manual`
- * is always available, so never a key of `providers`; the default is `manual` or one of them.
- */
-export declare function checkBookingConfig(v: unknown): {
-    problems: BookingProblem[];
-    config: BookingConfig | null;
-};
 /** `booking.requested@1`'s properties, their vocabularies as the panel checks them. */
 export type BookingRequested = BookingRequestedV1 & {
     provider: BookingProvider;

package/dist/booking.js

@@ -1,108 +1,10 @@
 import { BOOKING_LIMITS as LIMIT, BOOKING_PROVIDERS, DAY_PARTS, PAGE_PROVIDERS } from "./generated/booking.js";
-import { at, isDate, isObject } from "./text.js";
+import { isDate, isObject } from "./text.js";
 export const isBookingProvider = (v) => BOOKING_PROVIDERS.some(p => p === v);
 export const isPageProvider = (v) => PAGE_PROVIDERS.some(p => p === v);
 const LEAD_REF = /* @__PURE__ */ new RegExp(LIMIT.leadRef);
-const CAL_SEGMENT = /* @__PURE__ */ new RegExp(LIMIT.calComSegment);
-const LABEL = /^[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?$/;
-const APPOINTMENTS = "/calendar/appointments/";
 /** `lead-<row>-<8 lowercase hex>`, the row 1 or more: the panel's lead id for a site's lead. */
 export const isLeadRef = (v) => typeof v === "string" && LEAD_REF.test(v);
-/**
- * Why `url` may not be `provider`'s booking page, or `null` (`contracts/vectors/booking/README.md`,
- * normative): at most 2048 printable ASCII; the literal `https://`; no `#` and no `\`; an
- * authority without `@`, `:` or `[`; a dotted DNS name whose last label is not a number; then
- * the provider's own rule.
- */
-export function checkBookingUrl(provider, url) {
-    if (url.length === 0 || url.length > LIMIT.maxUrl || !/^[\x21-\x7e]+$/.test(url))
-        return "format";
-    if (!url.startsWith("https://"))
-        return "scheme";
-    if (url.includes("#"))
-        return "fragment";
-    if (url.includes("\\"))
-        return "backslash";
-    const rest = url.slice("https://".length);
-    const split = rest.search(/[/?]/);
-    const host = split < 0 ? rest : rest.slice(0, split);
-    if (host.includes("@"))
-        return "userinfo";
-    if (host.startsWith("["))
-        return "ip";
-    if (host.includes(":"))
-        return "port";
-    const labels = host.split(".");
-    if (host.length > 253 || labels.length < 2 || !labels.every(l => LABEL.test(l)))
-        return "host";
-    const last = (labels.at(-1) ?? "").toLowerCase();
-    // A WHATWG parser reads a host whose last label is a number as an IPv4 address.
-    if (/^\d+$/.test(last) || last.startsWith("0x"))
-        return "ip";
-    const name = host.toLowerCase();
-    const path = (split < 0 ? "" : rest.slice(split)).split("?")[0] ?? "";
-    switch (provider) {
-        case "link":
-            return null;
-        case "google_calendar":
-            return (name === "calendar.app.google" && path.length > 1) || (name === "calendar.google.com" && path.length > APPOINTMENTS.length && path.startsWith(APPOINTMENTS)) ? null : "google";
-        case "cal_com": {
-            if (!LIMIT.calComHosts.some(h => h === name))
-                return "cal_host";
-            const segments = path.replace(/^\//, "").split("/");
-            return path.startsWith("/") && segments.length === 2 && segments.every(s => CAL_SEGMENT.test(s)) ? null : "cal_path";
-        }
-    }
-}
-/**
- * A place's `booking` checked whole: every problem, and the config when there is none. `manual`
- * is always available, so never a key of `providers`; the default is `manual` or one of them.
- */
-export function checkBookingConfig(v) {
-    const problems = [];
-    const fail = (path, code) => problems.push({ path, code });
-    if (!isObject(v))
-        return { problems: [{ path: "", code: "shape" }], config: null };
-    if (Object.keys(v).some(k => k !== "default" && k !== "providers"))
-        fail("", "unknown_key");
-    const def = isBookingProvider(v.default) ? v.default : null;
-    if (!Object.hasOwn(v, "default"))
-        fail("default", "required");
-    else if (def === null)
-        fail("default", "default_unknown");
-    const providers = {};
-    if (!Object.hasOwn(v, "providers"))
-        fail("providers", "required");
-    else if (!isObject(v.providers))
-        fail("providers", "shape");
-    else
-        for (const [name, conf] of Object.entries(v.providers)) {
-            const path = at("providers", name);
-            if (!isBookingProvider(name))
-                fail(path, "provider_unknown");
-            else if (!isObject(conf))
-                fail(path, "provider_shape");
-            else if (Object.keys(conf).some(k => k !== "url"))
-                fail(path, "provider_extra");
-            else if (!isPageProvider(name))
-                fail(path, "manual");
-            else if (!Object.hasOwn(conf, "url"))
-                fail(at(path, "url"), "required");
-            else if (typeof conf.url !== "string")
-                fail(at(path, "url"), "url_type");
-            else {
-                const bad = checkBookingUrl(name, conf.url);
-                if (bad)
-                    fail(at(path, "url"), bad);
-                else
-                    providers[name] = { url: conf.url };
-            }
-        }
-    // A default whose own entry is refused is blamed there, not twice.
-    if (isPageProvider(def) && !Object.hasOwn(providers, def) && !problems.some(p => p.path.startsWith(at("providers", def))))
-        fail("default", "default_unset");
-    return problems.length > 0 || def === null ? { problems, config: null } : { problems, config: { default: def, providers } };
-}
 const isDayPart = (v) => DAY_PARTS.some(p => p === v);
 /**
  * `booking.requested@1`'s properties, or `null` when the panel would refuse them: a lead ref, a

package/dist/index.d.ts

@@ -6,9 +6,11 @@ export * from "./generated/place.js";
 export * from "./generated/pricing.js";
 export type * from "./generated/types.js";
 export * from "./generated/wire.js";
-export { checkBookingConfig, checkBookingUrl, bookingRequested, isBookingProvider, isLeadRef, isPageProvider, preferredDateInWindow, type BookingProblem, type BookingRequested } from "./booking.js";
+export { bookingRequested, isBookingProvider, isLeadRef, isPageProvider, preferredDateInWindow, type BookingRequested } from "./booking.js";
+export { checkBookingConfig, checkBookingUrl, type BookingProblem } from "./booking-config.js";
 export { declarationProblem, parseLiveExperiments, type DeclarationProblem } from "./experiments.js";
 export { ingestBody, isOpaqueId, siteEvent, uuidV7, type LeadCreated, type SiteEvent, type SiteEventHead, type SiteProperties } from "./ingest.js";
 export { normalizePhone, phoneProblem } from "./phone.js";
 export { checkPlaceLive, isInstant, type PlaceProblem } from "./place.js";
-export { checkPricingModel, mulBp, priceOf, roundTo, type Price, type PriceLine, type PricingInputs, type PricingLabels, type PricingProblem } from "./pricing.js";
+export { mulBp, priceOf, roundTo, type Price, type PriceLine, type PricingInputs, type PricingLabels } from "./price.js";
+export { checkPricingModel, type PricingProblem } from "./pricing.js";

package/dist/index.js

@@ -5,9 +5,11 @@ export * from "./generated/lead.js";
 export * from "./generated/place.js";
 export * from "./generated/pricing.js";
 export * from "./generated/wire.js";
-export { checkBookingConfig, checkBookingUrl, bookingRequested, isBookingProvider, isLeadRef, isPageProvider, preferredDateInWindow } from "./booking.js";
+export { bookingRequested, isBookingProvider, isLeadRef, isPageProvider, preferredDateInWindow } from "./booking.js";
+export { checkBookingConfig, checkBookingUrl } from "./booking-config.js";
 export { declarationProblem, parseLiveExperiments } from "./experiments.js";
 export { ingestBody, isOpaqueId, siteEvent, uuidV7 } from "./ingest.js";
 export { normalizePhone, phoneProblem } from "./phone.js";
 export { checkPlaceLive, isInstant } from "./place.js";
-export { checkPricingModel, mulBp, priceOf, roundTo } from "./pricing.js";
+export { mulBp, priceOf, roundTo } from "./price.js";
+export { checkPricingModel } from "./pricing.js";

package/dist/place.js

@@ -1,4 +1,4 @@
-import { checkBookingConfig } from "./booking.js";
+import { checkBookingConfig } from "./booking-config.js";
 import { DAYS, MESSENGERS, PLACE_LIMITS as LIMIT } from "./generated/place.js";
 import { at, charCount, hasControl, hasWhitespace, isDate, isObject, trim } from "./text.js";
 const E164 = /* @__PURE__ */ new RegExp(LIMIT.e164);

package/dist/price.d.ts

@@ -0,0 +1,57 @@
+import type { PricingInputKind } from "./generated/pricing.js";
+import type { PricingInput, PricingModel } from "./generated/types.js";
+/** The answers to an estimate's inputs: input id → option id. */
+export type PricingInputs = Readonly<Record<string, string>>;
+/** The labels of an input or an option, by locale. */
+export type PricingLabels = PricingInput["labels"];
+/** The effect of each option of an input, in the unit its kind says. */
+export declare function effects(input: PricingInput): {
+    id: string;
+    effect: number;
+}[];
+/**
+ * `cents × bp / 10 000`, rounded half up to the cent. Integers throughout: the product is exact
+ * (the model's limits keep it under 2^53), and the division is done on the remainder.
+ */
+export declare function mulBp(cents: number, bp: number): number;
+/** Half up to a multiple of `step` (≥ 1). */
+export declare function roundTo(cents: number, step: number): number;
+/**
+ * One line of how a price was reached; `cents` is what the line changed, so the lines add up to
+ * the total. `base` is the need's base (or the fixed price); `rounding` and `minimum` appear only
+ * when they changed something.
+ */
+export type PriceLine = {
+    kind: "base";
+    cents: number;
+} | {
+    kind: PricingInputKind;
+    input: string;
+    option: string;
+    cents: number;
+} | {
+    kind: "rounding";
+    cents: number;
+} | {
+    kind: "minimum";
+    cents: number;
+};
+export interface Price {
+    cents: number;
+    breakdown: readonly PriceLine[];
+}
+/**
+ * What a need costs for these answers (`contracts/vectors/pricing/README.md`, normative):
+ *
+ * 1. the need's base, plus every `add` input, in the need's input order;
+ * 2. times every `multiply` input, in order, each product rounded half up to the cent at once;
+ * 3. every `discount` input, in order, as a multiplication by `10 000 − discountBp`, rounded the
+ *    same way;
+ * 4. the total rounded half up to a multiple of `roundToCents`;
+ * 5. raised to `minimumCents`.
+ *
+ * A `fixed` need is its price, as is. `null`: the need is not priced, or an input is unanswered
+ * or answered with an option it does not have — never a guess. Answers to inputs the need does
+ * not ask are ignored.
+ */
+export declare function priceOf(model: PricingModel, need: string, inputs: PricingInputs): Price | null;

package/dist/price.js

@@ -0,0 +1,78 @@
+/** The effect of each option of an input, in the unit its kind says. */
+export function effects(input) {
+    switch (input.kind) {
+        case "add":
+            return input.options.map(o => ({ id: o.id, effect: o.addCents }));
+        case "multiply":
+            return input.options.map(o => ({ id: o.id, effect: o.multiplyBp }));
+        case "discount":
+            return input.options.map(o => ({ id: o.id, effect: o.discountBp }));
+    }
+}
+const BP = 10_000;
+/**
+ * `cents × bp / 10 000`, rounded half up to the cent. Integers throughout: the product is exact
+ * (the model's limits keep it under 2^53), and the division is done on the remainder.
+ */
+export function mulBp(cents, bp) {
+    const n = cents * bp + BP / 2;
+    return (n - (n % BP)) / BP;
+}
+/** Half up to a multiple of `step` (≥ 1). */
+export function roundTo(cents, step) {
+    const rest = cents % step;
+    return rest * 2 >= step ? cents - rest + step : cents - rest;
+}
+/**
+ * What a need costs for these answers (`contracts/vectors/pricing/README.md`, normative):
+ *
+ * 1. the need's base, plus every `add` input, in the need's input order;
+ * 2. times every `multiply` input, in order, each product rounded half up to the cent at once;
+ * 3. every `discount` input, in order, as a multiplication by `10 000 − discountBp`, rounded the
+ *    same way;
+ * 4. the total rounded half up to a multiple of `roundToCents`;
+ * 5. raised to `minimumCents`.
+ *
+ * A `fixed` need is its price, as is. `null`: the need is not priced, or an input is unanswered
+ * or answered with an option it does not have — never a guess. Answers to inputs the need does
+ * not ask are ignored.
+ */
+export function priceOf(model, need, inputs) {
+    const pricing = Object.hasOwn(model.needs, need) ? model.needs[need] : undefined;
+    if (!pricing)
+        return null;
+    if (pricing.kind === "fixed")
+        return { cents: pricing.cents, breakdown: [{ kind: "base", cents: pricing.cents }] };
+    const answers = [];
+    for (const id of pricing.inputs) {
+        const input = model.inputs.find(i => i.id === id);
+        const answer = Object.hasOwn(inputs, id) ? inputs[id] : undefined;
+        const option = input && effects(input).find(o => o.id === answer);
+        if (!input || !option)
+            return null;
+        answers.push({ input, option: option.id, effect: option.effect });
+    }
+    const lines = [{ kind: "base", cents: pricing.baseCents }];
+    let total = pricing.baseCents;
+    const step = (kind, apply) => {
+        for (const a of answers) {
+            if (a.input.kind !== kind)
+                continue;
+            const next = apply(total, a.effect);
+            lines.push({ kind, input: a.input.id, option: a.option, cents: next - total });
+            total = next;
+        }
+    };
+    step("add", (t, cents) => t + cents);
+    step("multiply", (t, bp) => mulBp(t, bp));
+    step("discount", (t, bp) => mulBp(t, BP - bp));
+    const rounded = roundTo(total, model.roundToCents);
+    if (rounded !== total)
+        lines.push({ kind: "rounding", cents: rounded - total });
+    total = rounded;
+    if (total < model.minimumCents) {
+        lines.push({ kind: "minimum", cents: model.minimumCents - total });
+        total = model.minimumCents;
+    }
+    return { cents: total, breakdown: lines };
+}

package/dist/pricing.d.ts

@@ -1,6 +1,5 @@
 import type { PricingCode } from "./generated/codes.js";
-import { type PricingInputKind } from "./generated/pricing.js";
-import type { PricingInput, PricingModel } from "./generated/types.js";
+import type { PricingModel } from "./generated/types.js";
 /**
  * One thing wrong with a model: its path from the model's root (`inputs[0].options[2].addCents`,
  * `""` for the model itself), the code the panel names it by too, and what the code's words
@@ -11,10 +10,6 @@ export interface PricingProblem {
     code: PricingCode;
     vars: Readonly<Record<string, string | number>>;
 }
-/** The answers to an estimate's inputs: input id → option id. */
-export type PricingInputs = Readonly<Record<string, string>>;
-/** The labels of an input or an option, by locale. */
-export type PricingLabels = PricingInput["labels"];
 /**
  * Every reason `value` is not a pricing model, and the model rebuilt from what was checked when
  * there is none: taken whole or not at all, unknown fields refused rather than ignored. With
@@ -24,49 +19,3 @@ export declare function checkPricingModel(value: unknown, locales?: readonly str
     problems: PricingProblem[];
     model: PricingModel | null;
 };
-/**
- * `cents × bp / 10 000`, rounded half up to the cent. Integers throughout: the product is exact
- * (the model's limits keep it under 2^53), and the division is done on the remainder.
- */
-export declare function mulBp(cents: number, bp: number): number;
-/** Half up to a multiple of `step` (≥ 1). */
-export declare function roundTo(cents: number, step: number): number;
-/**
- * One line of how a price was reached; `cents` is what the line changed, so the lines add up to
- * the total. `base` is the need's base (or the fixed price); `rounding` and `minimum` appear only
- * when they changed something.
- */
-export type PriceLine = {
-    kind: "base";
-    cents: number;
-} | {
-    kind: PricingInputKind;
-    input: string;
-    option: string;
-    cents: number;
-} | {
-    kind: "rounding";
-    cents: number;
-} | {
-    kind: "minimum";
-    cents: number;
-};
-export interface Price {
-    cents: number;
-    breakdown: readonly PriceLine[];
-}
-/**
- * What a need costs for these answers (`contracts/vectors/pricing/README.md`, normative):
- *
- * 1. the need's base, plus every `add` input, in the need's input order;
- * 2. times every `multiply` input, in order, each product rounded half up to the cent at once;
- * 3. every `discount` input, in order, as a multiplication by `10 000 − discountBp`, rounded the
- *    same way;
- * 4. the total rounded half up to a multiple of `roundToCents`;
- * 5. raised to `minimumCents`.
- *
- * A `fixed` need is its price, as is. `null`: the need is not priced, or an input is unanswered
- * or answered with an option it does not have — never a guess. Answers to inputs the need does
- * not ask are ignored.
- */
-export declare function priceOf(model: PricingModel, need: string, inputs: PricingInputs): Price | null;

package/dist/pricing.js

@@ -1,4 +1,5 @@
 import { INPUT_KINDS, PRICING_CURRENCY, PRICING_FORMAT, PRICING_LIMITS as LIMIT } from "./generated/pricing.js";
+import { effects, mulBp } from "./price.js";
 import { at, isDate, isObject, trim } from "./text.js";
 const SLUG = /* @__PURE__ */ new RegExp(LIMIT.slug);
 const LOCALE = /* @__PURE__ */ new RegExp(LIMIT.locale);
@@ -116,17 +117,6 @@ function need(c, path, v, inputs) {
             c.fail(at(at(path, "inputs"), i), "noInput", { id });
     return { kind: "estimate", baseCents, inputs: ids };
 }
-/** The effect of each option of an input, in the unit its kind says. */
-function effects(input) {
-    switch (input.kind) {
-        case "add":
-            return input.options.map(o => ({ id: o.id, effect: o.addCents }));
-        case "multiply":
-            return input.options.map(o => ({ id: o.id, effect: o.multiplyBp }));
-        case "discount":
-            return input.options.map(o => ({ id: o.id, effect: o.discountBp }));
-    }
-}
 /**
  * The dearest answer to every input — each effect only raises the price with its value, and
  * rounding half up is monotonic — walked step by step: if no step of it passes the cap, no
@@ -204,70 +194,3 @@ export function checkPricingModel(value, locales = []) {
         return { problems: c.problems, model: null };
     return { problems: [], model: { format: PRICING_FORMAT, currency: PRICING_CURRENCY, validFrom: String(value.validFrom), roundToCents, minimumCents, inputs, needs } };
 }
-const BP = 10_000;
-/**
- * `cents × bp / 10 000`, rounded half up to the cent. Integers throughout: the product is exact
- * (the model's limits keep it under 2^53), and the division is done on the remainder.
- */
-export function mulBp(cents, bp) {
-    const n = cents * bp + BP / 2;
-    return (n - (n % BP)) / BP;
-}
-/** Half up to a multiple of `step` (≥ 1). */
-export function roundTo(cents, step) {
-    const rest = cents % step;
-    return rest * 2 >= step ? cents - rest + step : cents - rest;
-}
-/**
- * What a need costs for these answers (`contracts/vectors/pricing/README.md`, normative):
- *
- * 1. the need's base, plus every `add` input, in the need's input order;
- * 2. times every `multiply` input, in order, each product rounded half up to the cent at once;
- * 3. every `discount` input, in order, as a multiplication by `10 000 − discountBp`, rounded the
- *    same way;
- * 4. the total rounded half up to a multiple of `roundToCents`;
- * 5. raised to `minimumCents`.
- *
- * A `fixed` need is its price, as is. `null`: the need is not priced, or an input is unanswered
- * or answered with an option it does not have — never a guess. Answers to inputs the need does
- * not ask are ignored.
- */
-export function priceOf(model, need, inputs) {
-    const pricing = Object.hasOwn(model.needs, need) ? model.needs[need] : undefined;
-    if (!pricing)
-        return null;
-    if (pricing.kind === "fixed")
-        return { cents: pricing.cents, breakdown: [{ kind: "base", cents: pricing.cents }] };
-    const answers = [];
-    for (const id of pricing.inputs) {
-        const input = model.inputs.find(i => i.id === id);
-        const answer = Object.hasOwn(inputs, id) ? inputs[id] : undefined;
-        const option = input && effects(input).find(o => o.id === answer);
-        if (!input || !option)
-            return null;
-        answers.push({ input, option: option.id, effect: option.effect });
-    }
-    const lines = [{ kind: "base", cents: pricing.baseCents }];
-    let total = pricing.baseCents;
-    const step = (kind, apply) => {
-        for (const a of answers) {
-            if (a.input.kind !== kind)
-                continue;
-            const next = apply(total, a.effect);
-            lines.push({ kind, input: a.input.id, option: a.option, cents: next - total });
-            total = next;
-        }
-    };
-    step("add", (t, cents) => t + cents);
-    step("multiply", (t, bp) => mulBp(t, bp));
-    step("discount", (t, bp) => mulBp(t, BP - bp));
-    const rounded = roundTo(total, model.roundToCents);
-    if (rounded !== total)
-        lines.push({ kind: "rounding", cents: rounded - total });
-    total = rounded;
-    if (total < model.minimumCents) {
-        lines.push({ kind: "minimum", cents: model.minimumCents - total });
-        total = model.minimumCents;
-    }
-    return { cents: total, breakdown: lines };
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evinvest/sites-contract",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "The Service-Arb sites ↔ panel contract in TS: the shapes and vocabularies generated from the panel's Rust and protos, and the one TS implementation of what both sides run — pricing, booking and place checks, phone numbers, the ingest events a site sends.",
   "license": "BlueOak-1.0.0",
   "publishConfig": {