@kerusiweb/core 2.0.0

package/dist/kerusi/kerusi-state.model.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Kerusi availability document types, transcribed from the Kerusi Seat Map and
+ * Availability Format v1.0.0-draft, §5. These describe the dynamic, per-seat
+ * booking status that is merged onto a static {@link KerusiMap} by `Seat.id`.
+ */
+/** Per-seat availability status (§5.1). */
+export interface SeatStatus {
+    /** REQUIRED. */
+    status: 'available' | 'held' | 'booked' | 'blocked';
+    /** RFC 3339 date-time (§5.1.1). Meaningful only when `status === "held"`. */
+    holdExpires?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * A complete availability snapshot (§5.1). A seat absent from `seats` MUST be
+ * interpreted as `"available"` — this sparse convention keeps state documents
+ * small for large venues.
+ */
+export interface KerusiState {
+    /** REQUIRED. */
+    kerusi: '1.0';
+    /**
+     * Matches `KerusiSession.id`. RECOMMENDED when the referenced map is reused
+     * across many events (§5.3).
+     */
+    sessionId?: string;
+    /**
+     * Matches `KerusiMap.id` directly, for documents with no separate session
+     * concept. Exactly one of `sessionId`/`mapId` MUST be present.
+     */
+    mapId?: string;
+    /** REQUIRED. RFC 3339 date-time (§5.1.1). */
+    updatedAt: string;
+    /** REQUIRED. Keyed by `Seat.id`. Only non-default entries need be included. */
+    seats: Record<string, SeatStatus>;
+}
+/**
+ * An incremental update over a push transport (§5.2). Unlike {@link KerusiState},
+ * EVERY entry in `changes` is an explicit change and omission means "unchanged"
+ * — the opposite of KerusiState's sparse rule.
+ */
+export interface KerusiStateDelta {
+    /** REQUIRED. */
+    kerusi: '1.0';
+    /** Same either/or rule as {@link KerusiState}. */
+    sessionId?: string;
+    mapId?: string;
+    /**
+     * REQUIRED. RFC 3339 date-time (§5.1.1), strictly increasing per session/map
+     * so a consumer can detect and discard an out-of-order delta.
+     */
+    updatedAt: string;
+    /**
+     * REQUIRED. Keyed by `Seat.id`. Every entry IS a change; an explicit
+     * `{ "status": "available" }` signals a seat reverting. A seat's absence
+     * means "unchanged".
+     */
+    changes: Record<string, SeatStatus>;
+}
+/**
+ * The optional join between a specific event/showtime/flight and a reusable
+ * {@link KerusiMap} (§5.3). `KerusiState`/`KerusiStateDelta` reference the
+ * session via `sessionId` when a session exists.
+ */
+export interface KerusiSession {
+    /** REQUIRED. */
+    kerusi: '1.0';
+    /** REQUIRED. Unique session id, e.g. "MH123-2026-08-17". */
+    id: string;
+    /** REQUIRED. References the reusable `KerusiMap.id`. */
+    mapId: string;
+    /** e.g. "Dune: Part Three — 7:30pm", "MH123, 17 Aug 2026". */
+    label?: string;
+    /** RFC 3339 date-time (§5.1.1) — showtime / departure / event start. */
+    startsAt?: string;
+    endsAt?: string;
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=kerusi-state.model.d.ts.map

package/dist/kerusi/kerusi-state.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kerusi-state.model.d.ts","sourceRoot":"","sources":["../../src/kerusi/kerusi-state.model.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB,gBAAgB;IAChB,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IACpD,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,gBAAgB;IAChB,MAAM,EAAE,KAAK,CAAC;IACd;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB;IAChB,MAAM,EAAE,KAAK,CAAC;IACd,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,gBAAgB;IAChB,MAAM,EAAE,KAAK,CAAC;IACd,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/kerusi/kerusi-state.model.js

@@ -0,0 +1,7 @@
+/**
+ * Kerusi availability document types, transcribed from the Kerusi Seat Map and
+ * Availability Format v1.0.0-draft, §5. These describe the dynamic, per-seat
+ * booking status that is merged onto a static {@link KerusiMap} by `Seat.id`.
+ */
+export {};
+//# sourceMappingURL=kerusi-state.model.js.map

package/dist/kerusi/kerusi-state.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kerusi-state.model.js","sourceRoot":"","sources":["../../src/kerusi/kerusi-state.model.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/kerusi/kerusi-validator.d.ts

@@ -0,0 +1,96 @@
+import { KerusiMap } from './kerusi-map.model.js';
+import { KerusiSession, KerusiState, KerusiStateDelta } from './kerusi-state.model.js';
+import { KerusiViolation } from './kerusi-violation.js';
+export { errorsOf } from './kerusi-violation.js';
+export type { KerusiViolation, ViolationSeverity } from './kerusi-violation.js';
+/**
+ * Thrown when a Kerusi document violates a MUST-level rule in the standard.
+ * The message names the failing rule and the id that triggered it, so a
+ * malformed document is diagnosable rather than surfacing as a generic parse
+ * error (spec §4.6, §7).
+ *
+ * `violations` carries every finding from the same pass, not just the one that
+ * was thrown — useful when reporting a document's problems all at once. Use the
+ * non-throwing `checkKerusi*` functions when that is the primary goal.
+ */
+export declare class KerusiValidationError extends Error {
+    /** Short slug of the violated rule, e.g. "seat-type-reference". */
+    readonly rule: string;
+    /** The id (seat, section, tier, ...) that triggered the failure, if any. */
+    readonly id?: string | undefined;
+    /** Every violation found in the same pass, in document order. */
+    readonly violations: readonly KerusiViolation[];
+    constructor(message: string, 
+    /** Short slug of the violated rule, e.g. "seat-type-reference". */
+    rule: string, 
+    /** The id (seat, section, tier, ...) that triggered the failure, if any. */
+    id?: string | undefined, 
+    /** Every violation found in the same pass, in document order. */
+    violations?: readonly KerusiViolation[]);
+}
+/**
+ * Collects every conformance violation in a {@link KerusiMap}, in document
+ * order, without throwing. An empty array means the map is valid.
+ *
+ * Accepts `unknown` so it can be pointed at freshly parsed JSON: a value that
+ * isn't a usable map yields a shape violation rather than a crash.
+ */
+export declare function checkKerusiMap(map: unknown): readonly KerusiViolation[];
+/** Collects every violation in a {@link KerusiState} without throwing. */
+export declare function checkKerusiState(state: unknown): readonly KerusiViolation[];
+/** Collects every violation in a {@link KerusiStateDelta} without throwing. */
+export declare function checkKerusiStateDelta(delta: unknown): readonly KerusiViolation[];
+/** Collects every violation in a {@link KerusiSession} without throwing (§5.3). */
+export declare function checkKerusiSession(session: unknown): readonly KerusiViolation[];
+/**
+ * Validates a map together with the session and/or state that reference it,
+ * checking the joins the individual validators cannot see (§5.1, §5.3): a
+ * state's `mapId` must be the map's id, its `sessionId` the session's, and the
+ * session's `mapId` the map's.
+ */
+export declare function validateDocumentSet(docs: {
+    map: KerusiMap;
+    state?: KerusiState;
+    session?: KerusiSession;
+}): readonly KerusiViolation[];
+/**
+ * Validates a {@link KerusiMap} against the MUST-level rules of spec §4.
+ * Throws {@link KerusiValidationError} on the first violation; returns the map
+ * unchanged when valid, so it can be used inline.
+ *
+ * Enforced rules:
+ *  - Required members present: `kerusi`, `id`, `legend`, `sections` (§4), and
+ *    `kerusi` declares a supported major version.
+ *  - Every seat has `col`, or `x`+`y`, or both — never neither (§4.3.1) — and
+ *    conforms to its section's declared or inferred `layout` mode (§4.5).
+ *  - Section, seat and element ids are unique (§4.1, §4.3, §4.4).
+ *  - Every `Seat.type` resolves to a `SeatType.id` in `legend` (§4.6).
+ *  - Every `Seat.priceTier` resolves to a `PriceTier.id` (§4.6).
+ *  - Every `Seat.row` resolves to a `RowMeta.id` when the section declares
+ *    `rows`; opaque free-text otherwise (§4.6).
+ *  - Every `Seat.companions[]` entry resolves to another seat in the SAME
+ *    section, and the relationship is symmetric (§4.6).
+ *  - Every `Element` has the required `id` and `kind` (§4.4), is positioned in
+ *    its section's own layout mode, and — in a grid section — carries integer
+ *    column and row spans that stay inside the section's rows (§4.4.1, §4.6).
+ *  - All resolved currencies across the map are identical (§4.9).
+ *
+ * Advisory findings never throw; use {@link checkKerusiMap} to see them.
+ */
+export declare function validateKerusiMap(map: KerusiMap): KerusiMap;
+/**
+ * Validates a {@link KerusiState} against the MUST-level rules of spec §5.1,
+ * including the RFC 3339 timestamp profile of §5.1.1:
+ * `kerusi` present and supported, `updatedAt` present, exactly one of
+ * `sessionId`/`mapId`, and a `seats` object.
+ */
+export declare function validateKerusiState(state: KerusiState): KerusiState;
+/**
+ * Validates a {@link KerusiStateDelta} against the MUST-level rules of §5.2:
+ * `kerusi` present and supported, `updatedAt` present, exactly one of
+ * `sessionId`/`mapId`, and a `changes` object.
+ */
+export declare function validateKerusiStateDelta(delta: KerusiStateDelta): KerusiStateDelta;
+/** Validates a {@link KerusiSession} against §5.3. */
+export declare function validateKerusiSession(session: KerusiSession): KerusiSession;
+//# sourceMappingURL=kerusi-validator.d.ts.map

package/dist/kerusi/kerusi-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kerusi-validator.d.ts","sourceRoot":"","sources":["../../src/kerusi/kerusi-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,SAAS,EAAiB,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAc,MAAM,yBAAyB,CAAC;AAUnG,OAAO,EAAmB,eAAe,EAAW,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAQhF;;;;;;;;;GASG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAG5C,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM;IACpB,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE;gBAN/C,OAAO,EAAE,MAAM;IACf,mEAAmE;IAC1D,IAAI,EAAE,MAAM;IACrB,4EAA4E;IACnE,EAAE,CAAC,EAAE,MAAM,YAAA;IACpB,iEAAiE;IACxD,UAAU,GAAE,SAAS,eAAe,EAAO;CAKvD;AAID;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,eAAe,EAAE,CAEvE;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,eAAe,EAAE,CAS3E;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,eAAe,EAAE,CAWhF;AA2BD,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,eAAe,EAAE,CAqC/E;AAyCD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB,GAAG,SAAS,eAAe,EAAE,CAyC7B;AAID;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,CAG3D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAGnE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAGlF;AAED,sDAAsD;AACtD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAG3E"}