@insiderfinance/totalfinance 0.1.0

package/modules/core/dist/schema/payloads.js

@@ -0,0 +1,323 @@
+/**
+ * Runtime schemas for core market-data payloads (spec §6, §7.6).
+ *
+ * Lives under `@insiderfinance/totalfinance/core/schema` so it never burdens hot compute paths. These are the canonical
+ * payload schemas; domain packages re-export the relevant ones (e.g. `@insiderfinance/totalfinance/options` re-exports
+ * `OptionContractSchema`).
+ */
+import { requireRateCurveData } from '../market-data.js';
+import { validateResolvedExpiry } from '../time.js';
+import { schema, transformSchema } from './schema.js';
+/**
+ * Recursively freeze a parsed artifact. `Object.freeze` is shallow — a "FROZEN" contract whose
+ * `deliverable` (and its `shares[]`) stayed mutable is an immutability lie: an engine could
+ * validate the artifact and then have its economics edited underneath it. Schema output is a
+ * fresh tree (no cycles, no shared references), so a plain recursive walk is exact.
+ */
+function deepFreeze(value) {
+    if (value !== null && typeof value === 'object') {
+        for (const child of Object.values(value))
+            deepFreeze(child);
+        Object.freeze(value);
+    }
+    return value;
+}
+const symbolId = schema.string().nonempty();
+const epochMs = schema.number();
+const conditions = schema.array(schema.string());
+export const BarSchema = schema.object({
+    symbol: symbolId,
+    timestampMs: epochMs,
+    open: schema.number(),
+    high: schema.number(),
+    low: schema.number(),
+    close: schema.number(),
+    volume: schema.number().nonnegative().optional(),
+    vwap: schema.number().optional(),
+    adjusted: schema.boolean().optional(),
+});
+export const QuoteSchema = schema.object({
+    symbol: symbolId,
+    timestampMs: epochMs,
+    bid: schema.number(),
+    ask: schema.number(),
+    bidSize: schema.number().nonnegative().optional(),
+    askSize: schema.number().nonnegative().optional(),
+    exchange: schema.string().optional(),
+    conditions: conditions.optional(),
+});
+export const TradeSchema = schema.object({
+    symbol: symbolId,
+    timestampMs: epochMs,
+    price: schema.number(),
+    size: schema.number(),
+    exchange: schema.string().optional(),
+    conditions: conditions.optional(),
+    sequence: schema.number().optional(),
+});
+/**
+ * D2 decision: this schema validates the RESOLVED pricing artifact — what the option builders
+ * return and engines consume — not an unresolved DTO. The label accepts everything the builders
+ * accept (date-only or zoned datetime), and the resolved `expiresAt` + `expiryConvention` are
+ * REQUIRED: a contract without its instant is not a contract yet (build it first).
+ */
+const OptionContractShapeSchema = schema.object({
+    underlying: schema.string().nonempty(),
+    type: schema.enum(['call', 'put']),
+    style: schema.enum(['european', 'american']),
+    strike: schema.number().positive(),
+    expiry: schema
+        .string()
+        // Mirrors core's expiry grammar exactly (incl. RFC-3339 lowercase t/z) so a builder-accepted
+        // label always validates here — one expiry law, one grammar.
+        .regex(/^\d{4}-\d{2}-\d{2}([Tt ]\d{2}:\d{2}(:\d{2}(\.\d+)?)?([Zz]|[+-]\d{2}:?\d{2}))?$/)
+        .describe("Display label: 'YYYY-MM-DD' or a zoned ISO datetime (matches the builders)"),
+    expiresAt: epochMs.describe('Resolved expiration instant (epoch ms) — stamped by the builders'),
+    expiryConvention: schema
+        .enum(['us-equity-close', 'explicit-instant'])
+        .describe('How the label resolved to the instant'),
+    multiplier: schema.number().positive().optional(),
+    settlement: schema.enum(['physical', 'cash']).optional(),
+    exerciseTime: schema.enum(['AM', 'PM']).optional(),
+    currency: schema.string().optional(),
+    root: schema.string().optional(),
+    occSymbol: schema.string().optional(),
+    deliverable: schema
+        .object({
+        cash: schema.number().optional(),
+        shares: schema
+            .array(schema.object({ symbol: schema.string().nonempty(), quantity: schema.number() }))
+            .optional(),
+        notes: schema.string().optional(),
+    })
+        .optional(),
+    adjusted: schema.boolean().optional(),
+});
+/**
+ * E2 — the contract schema validates the RESOLVED ARTIFACT cross-field, not just field shapes:
+ * after the structural parse, `validateResolvedExpiry` confirms the label ↔ instant ↔ convention
+ * triple is internally consistent (impossible dates, mismatched epochs, and contradictory
+ * conventions all reject), and the parsed value is DEEP-frozen — the artifact (including
+ * `deliverable` and its `shares[]`) stays immutable through the schema boundary exactly as it
+ * left the builders.
+ */
+export const OptionContractSchema = transformSchema(OptionContractShapeSchema, (contract) => {
+    validateResolvedExpiry('OptionContractSchema', contract.expiry, contract.expiresAt, contract.expiryConvention);
+    return deepFreeze(contract);
+}, { errorPath: ['expiresAt'] });
+export const OptionQuoteSchema = schema.object({
+    contract: OptionContractSchema,
+    timestampMs: epochMs,
+    bid: schema.number().optional(),
+    ask: schema.number().optional(),
+    bidSize: schema.number().nonnegative().optional(),
+    askSize: schema.number().nonnegative().optional(),
+    mid: schema.number().optional(),
+    last: schema.number().optional(),
+    mark: schema.number().optional(),
+    volume: schema.number().nonnegative().optional(),
+    openInterest: schema.number().nonnegative().optional(),
+    underlyingPrice: schema.number().positive().optional(),
+    impliedVolatility: schema.number().nonnegative().optional(),
+    greeks: schema
+        .object({
+        delta: schema.number(),
+        gamma: schema.number().optional(),
+        theta: schema.number().optional(),
+        vega: schema.number().optional(),
+        rho: schema.number().optional(),
+        provenance: schema
+            .object({
+            source: schema.string(),
+            model: schema.string().optional(),
+            timestampMs: epochMs.optional(),
+        })
+            .optional(),
+    })
+        .optional()
+        .describe('Per-share Greeks in display units (theta per day, vega per vol point, rho per 1%), with optional provenance'),
+    exchange: schema.string().optional(),
+    conditions: conditions.optional(),
+});
+export const DividendSchema = schema.object({
+    symbol: symbolId,
+    exDate: schema.string().date(),
+    payDate: schema.string().date().optional(),
+    amount: schema.number(),
+    currency: schema.string().optional(),
+    type: schema.enum(['regular', 'special', 'returnOfCapital', 'unknown']).optional(),
+});
+/**
+ * Runtime member lists DERIVED from core's one conventions grammar in `time.ts` (2026-08-23,
+ * fourth external review). The exported types are the source of truth and `satisfies
+ * Record<…, true>` makes drift a COMPILE error in both directions: a member added to the type
+ * breaks the record (missing key); a member misspelled or retired here breaks excess-property
+ * checking. Never a second hand-maintained list.
+ */
+const DAY_COUNT_MEMBERS = {
+    'ACT/365F': true,
+    'ACT/360': true,
+    '30/360': true,
+};
+const DAY_COUNTS = Object.keys(DAY_COUNT_MEMBERS);
+const NAMED_COMPOUNDING_MEMBERS = {
+    simple: true,
+    continuous: true,
+    annual: true,
+    semiannual: true,
+    quarterly: true,
+    monthly: true,
+};
+const NAMED_COMPOUNDINGS = Object.keys(NAMED_COMPOUNDING_MEMBERS);
+/**
+ * The FULL `InterestCompounding` grammar as a schema: the six named forms plus the periodic
+ * object form. The periodic object is `.open()` because the runtime validator checks only
+ * `type`/`periodsPerYear` and tolerates decoration — the shape must never refuse what the
+ * semantic door accepts.
+ */
+const InterestCompoundingSchema = schema
+    .union([
+    schema.enum(NAMED_COMPOUNDINGS),
+    schema
+        .object({
+        type: schema.literal('periodic'),
+        periodsPerYear: schema.number().positive(),
+    })
+        .open(),
+])
+    .describe("Interest compounding convention: 'simple' | 'continuous' | 'annual' | 'semiannual' | 'quarterly' | 'monthly' or { type: 'periodic', periodsPerYear }");
+/**
+ * OPEN (2026-08-23, fourth external review): `RateCurvePoint` entries are documented "open to
+ * vendor decoration (Law 12)" and the runtime curve validator accepts a decorated pillar, but
+ * this schema was CLOSED — the one schema-vs-runtime openness misstatement in this module.
+ * `.open()` validates the declared pillar shape and preserves decoration, and the emitted JSON
+ * Schema now says `additionalProperties: true` instead of lying `false`.
+ */
+export const RateCurvePointSchema = schema
+    .object({
+    date: schema.string().date().describe("Pillar date, 'YYYY-MM-DD'"),
+    zeroRate: schema
+        .number()
+        .describe("Decimal zero rate quoted under the curve's own compounding/dayCount"),
+})
+    .open();
+/**
+ * The `RateCurve` schema is a structured-open shape ROUTED through core's ONE semantic validator
+ * — a value must pass BOTH (2026-08-23, fourth external review; the routing itself dates to the
+ * second review, when a purely structural schema drifted from the runtime on three counts).
+ *
+ * Division of labor, so neither half can lie:
+ *   - STRUCTURE via the `.open()` shape below: field presence and types, the real `dayCount` and
+ *     compounding grammars (derived from `time.ts`, above), the pillar item shape. This is what
+ *     `toJSONSchema()` emits — complete `properties`/`required`/enums with
+ *     `additionalProperties: true` — so MCP tools, agents, and generated forms see the actual
+ *     contract; the old `record(unknown())` inner shape emitted a shapeless `{ type: 'object' }`.
+ *   - SEMANTICS via `requireRateCurveData` (the same door the Gate B snapshot spine and Gate C
+ *     pricing protocol use): pillar nonemptiness, strict date ascension, at-or-after-`asOf`,
+ *     representable discount factors under the curve's own conventions, non-empty
+ *     `interpolation`. The shape deliberately does NOT duplicate these laws, so their refusals
+ *     keep the semantic validator's own teaching and the two doors cannot drift.
+ */
+const RateCurveShapeSchema = schema
+    .object({
+    currency: schema
+        .string()
+        .nonempty()
+        .describe("Currency the curve discounts in (e.g. 'USD') — the curve states its own"),
+    asOf: epochMs.describe('Curve valuation instant (epoch ms); every pillar is at or after it'),
+    dayCount: schema
+        .enum(DAY_COUNTS)
+        .describe('Day-count convention the zero rates are quoted under'),
+    compounding: InterestCompoundingSchema,
+    points: schema
+        .array(RateCurvePointSchema)
+        .describe('Pillar points — nonempty and strictly ascending by date (refused with teaching by the semantic validator)'),
+    interpolation: schema
+        .string()
+        .optional()
+        .describe("Interpolation-name string when present (e.g. 'linearZero')"),
+})
+    .open();
+export const RateCurveSchema = transformSchema(RateCurveShapeSchema, (curve) => requireRateCurveData('RateCurveSchema', 'curve', curve)).describe("A stored RateCurve as plain data: { currency, asOf, dayCount, compounding, points: [{ date: 'YYYY-MM-DD', zeroRate }...], interpolation? } — structural shape above, semantics by core requireRateCurveData (nonempty strictly-ascending pillars at/after asOf, representable discount factors, open to vendor decoration)");
+export const OptionTradeSchema = schema.object({
+    // OptionQuote base (OptionTrade extends OptionQuote) …
+    contract: OptionContractSchema,
+    timestampMs: epochMs,
+    bid: schema.number().optional(),
+    ask: schema.number().optional(),
+    bidSize: schema.number().nonnegative().optional(),
+    askSize: schema.number().nonnegative().optional(),
+    mid: schema.number().optional(),
+    last: schema.number().optional(),
+    mark: schema.number().optional(),
+    volume: schema.number().nonnegative().optional(),
+    openInterest: schema.number().nonnegative().optional(),
+    underlyingPrice: schema.number().positive().optional(),
+    impliedVolatility: schema.number().nonnegative().optional(),
+    exchange: schema.string().optional(),
+    conditions: conditions.optional(),
+    // … plus the trade fields.
+    price: schema.number(),
+    size: schema.number(),
+    sequence: schema.number().optional(),
+    aggressorSide: schema.enum(['buy', 'sell', 'unknown']).optional(),
+    premium: schema.number().optional(),
+    notional: schema.number().optional(),
+    openingLikely: schema.boolean().optional(),
+});
+export const CorporateActionSchema = schema.object({
+    symbol: symbolId,
+    effectiveDate: schema.string().date(),
+    type: schema.enum([
+        'split',
+        'reverseSplit',
+        'dividend',
+        'symbolChange',
+        'merger',
+        'spinoff',
+        'other',
+    ]),
+    ratio: schema.number().optional(),
+    cash: schema.number().optional(),
+    newSymbol: schema.string().optional(),
+    details: schema.record(schema.unknown()).optional(),
+});
+export const OrderBookLevelSchema = schema.object({
+    price: schema.number(),
+    size: schema.number().nonnegative(),
+    exchange: schema.string().optional(),
+});
+export const OrderBookSchema = schema.object({
+    symbol: symbolId,
+    timestampMs: epochMs,
+    bids: schema.array(OrderBookLevelSchema),
+    asks: schema.array(OrderBookLevelSchema),
+});
+export const RawFundamentalsRecordSchema = schema.object({
+    symbol: symbolId,
+    fiscalPeriod: schema.string().optional(),
+    asOf: epochMs.optional(),
+    // Matches the `RawFundamentalsRecord` interface: values are scalar-or-null, NOT arbitrary objects/booleans
+    // (the old `record(unknown())` silently accepted `{ pe: { nested: true } }` and drifted from the type).
+    fields: schema.record(schema.union([schema.number(), schema.string(), schema.null()])),
+});
+/**
+ * Convenience namespace of the core payload schemas. Covers every exported market-data object type,
+ * so the schema/interface drift test (`schema-parity.test.ts`) can enumerate it exhaustively (WS3.10).
+ */
+export const coreSchemas = {
+    Bar: BarSchema,
+    Quote: QuoteSchema,
+    Trade: TradeSchema,
+    OptionContract: OptionContractSchema,
+    OptionQuote: OptionQuoteSchema,
+    OptionTrade: OptionTradeSchema,
+    Dividend: DividendSchema,
+    CorporateAction: CorporateActionSchema,
+    RateCurvePoint: RateCurvePointSchema,
+    RateCurve: RateCurveSchema,
+    OrderBookLevel: OrderBookLevelSchema,
+    OrderBook: OrderBookSchema,
+    RawFundamentalsRecord: RawFundamentalsRecordSchema,
+};
+//# sourceMappingURL=payloads.js.map

package/modules/core/dist/schema/payloads.js.map

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

package/modules/core/dist/schema/schema.d.ts

@@ -0,0 +1,282 @@
+/**
+ * TotalFinance schema facade — a tiny, zero-dependency runtime validator (spec §6).
+ *
+ * Design goals that drove the 0.0.1 schema decision (see docs/adr/schema-library.md):
+ *   - zero runtime dependencies, so `@insiderfinance/totalfinance/core` keeps its zero-dep guarantee;
+ *   - native `toJSONSchema()` for MCP tools, docs, and adapters;
+ *   - excellent TypeScript inference via `Infer<typeof schema>`;
+ *   - errors map to `InputError` with stable codes;
+ *   - Standard Schema (https://standardschema.dev) compatibility for ecosystem interop;
+ *   - small enough to never threaten compute-entrypoint bundle budgets — and, critically, it lives in
+ *     a SEPARATE entrypoint so hot paths never import it.
+ *
+ * It is intentionally a *facade*: the public surface (`parse`/`safeParse`/`toJSONSchema`/`~standard`)
+ * is what users depend on, so the underlying implementation can be swapped for Zod/Valibot later
+ * without breaking callers.
+ */
+import { InputError } from '../errors.js';
+import type { JSONSchema } from './json-schema.js';
+import type { StandardSchemaV1, StandardSchemaV1Props } from './standard.js';
+/** Marker so the bundle harness can prove this module never leaks into a compute entrypoint. */
+export declare const __TOTALFINANCE_SCHEMA_FACADE__ = "totalfinance/schema";
+export type ValidationMode = 'strict' | 'coerce' | 'passthrough' | 'off';
+export interface ParseOptions {
+    /** Validation strictness (spec §6). Defaults to `strict`. */
+    mode?: ValidationMode;
+}
+export interface SchemaIssue {
+    code: string;
+    message: string;
+    path: (string | number)[];
+}
+export type SafeParseResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    issues: SchemaIssue[];
+    error: InputError;
+};
+/** Public schema interface. Concrete builder implementations stay internal. */
+export interface Schema<Output> extends StandardSchemaV1<unknown, Output> {
+    readonly kind: string;
+    readonly isOptional: boolean;
+    parse(input: unknown, options?: ParseOptions): Output;
+    safeParse(input: unknown, options?: ParseOptions): SafeParseResult<Output>;
+    toJSONSchema(): JSONSchema;
+    optional(): Schema<Output | undefined>;
+    describe(description: string): this;
+}
+/** Extract the validated output type of a schema. */
+export type Infer<S> = S extends Schema<infer O> ? O : never;
+/**
+ * The validation context threaded through every schema's `_check` — exported so a consumer
+ * subclassing {@link Schema} can NAME the parameter of the method they must implement (3B.2
+ * nameability: an abstract method whose parameter type is unexported is a contract a consumer
+ * can satisfy only by structural accident).
+ */
+export interface SchemaCheckContext {
+    mode: ValidationMode;
+    path: (string | number)[];
+}
+type CheckResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    issues: SchemaIssue[];
+};
+declare abstract class BaseSchema<Output> implements Schema<Output> {
+    abstract readonly kind: string;
+    readonly isOptional: boolean;
+    description: string | undefined;
+    /** @internal */
+    abstract _check(input: unknown, context: SchemaCheckContext): CheckResult<Output>;
+    /** @internal */
+    abstract _toJSONSchema(): JSONSchema;
+    parse(input: unknown, options?: ParseOptions): Output;
+    safeParse(input: unknown, options?: ParseOptions): SafeParseResult<Output>;
+    toJSONSchema(): JSONSchema;
+    optional(): OptionalSchema<Output>;
+    /**
+     * Structural copy with the same prototype, so chainable refiners (`.describe()`, `.positive()`,
+     * `.min()`, …) return a NEW schema instead of mutating `this`. Refiners replace their internal
+     * constraint object wholesale (never mutate it in place), so the shallow copy is safe.
+     * @internal
+     */
+    protected clone(): this;
+    describe(description: string): this;
+    get ['~standard'](): StandardSchemaV1Props<unknown, Output>;
+}
+export interface NumberConstraints {
+    integer?: boolean;
+    min?: number;
+    max?: number;
+    exclusiveMin?: number;
+    exclusiveMax?: number;
+}
+declare class NumberSchema extends BaseSchema<number> {
+    readonly kind = "number";
+    private c;
+    constructor(constraints?: NumberConstraints);
+    private withConstraints;
+    integer(): this;
+    positive(): this;
+    nonnegative(): this;
+    min(value: number): this;
+    max(value: number): this;
+    gt(value: number): this;
+    lt(value: number): this;
+    /** @internal */
+    _check(input: unknown, context: SchemaCheckContext): CheckResult<number>;
+    /** @internal */
+    _toJSONSchema(): JSONSchema;
+}
+export interface StringConstraints {
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: 'date' | 'date-time' | string;
+}
+declare class StringSchema extends BaseSchema<string> {
+    readonly kind = "string";
+    private c;
+    constructor(constraints?: StringConstraints);
+    private withConstraints;
+    min(length: number): this;
+    max(length: number): this;
+    nonempty(): this;
+    regex(pattern: RegExp | string): this;
+    date(): this;
+    datetime(): this;
+    /** @internal */
+    _check(input: unknown, context: SchemaCheckContext): CheckResult<string>;
+    /** @internal */
+    _toJSONSchema(): JSONSchema;
+}
+declare class BooleanSchema extends BaseSchema<boolean> {
+    readonly kind = "boolean";
+    /** @internal */
+    _check(input: unknown, context: SchemaCheckContext): CheckResult<boolean>;
+    /** @internal */
+    _toJSONSchema(): JSONSchema;
+}
+declare class LiteralSchema<V extends string | number | boolean> extends BaseSchema<V> {
+    private readonly value;
+    readonly kind = "literal";
+    constructor(value: V);
+    /** @internal */
+    _check(input: unknown, context: SchemaCheckContext): CheckResult<V>;
+    /** @internal */
+    _toJSONSchema(): JSONSchema;
+}
+declare class EnumSchema<V extends string> extends BaseSchema<V> {
+    readonly kind = "enum";
+    private readonly values;
+    constructor(values: readonly V[]);
+    /** @internal */
+    _check(input: unknown, context: SchemaCheckContext): CheckResult<V>;
+    /** @internal */
+    _toJSONSchema(): JSONSchema;
+}
+declare class ArraySchema<Item> extends BaseSchema<Item[]> {
+    private readonly item;
+    private bounds;
+    readonly kind = "array";
+    constructor(item: BaseSchema<Item>, bounds?: {
+        min?: number;
+        max?: number;
+    });
+    min(minimum: number): this;
+    max(maximum: number): this;
+    /** @internal */
+    _check(input: unknown, context: SchemaCheckContext): CheckResult<Item[]>;
+    /** @internal */
+    _toJSONSchema(): JSONSchema;
+}
+declare class OptionalSchema<T> extends BaseSchema<T | undefined> {
+    private readonly inner;
+    readonly isOptional = true;
+    readonly kind = "optional";
+    constructor(inner: BaseSchema<T>);
+    /** @internal */
+    _check(input: unknown, context: SchemaCheckContext): CheckResult<T | undefined>;
+    /** @internal */
+    _toJSONSchema(): JSONSchema;
+    optional(): OptionalSchema<T | undefined>;
+}
+/** @internal Compose a cross-field validator/transform with any schema. */
+export declare function transformSchema<Input, Output>(schema: Schema<Input>, transform: (value: Input) => Output, options?: {
+    errorPath?: readonly (string | number)[];
+}): Schema<Output>;
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type OptionalShapeKeys<Shape> = {
+    [K in keyof Shape]: Shape[K] extends {
+        isOptional: true;
+    } ? K : never;
+}[keyof Shape];
+type RequiredShapeKeys<Shape> = Exclude<keyof Shape, OptionalShapeKeys<Shape>>;
+export type InferObject<Shape extends Record<string, Schema<unknown>>> = Prettify<{
+    [K in RequiredShapeKeys<Shape>]: Infer<Shape[K]>;
+} & {
+    [K in OptionalShapeKeys<Shape>]?: Exclude<Infer<Shape[K]>, undefined>;
+}>;
+declare class ObjectSchema<Shape extends Record<string, Schema<unknown>>> extends BaseSchema<InferObject<Shape>> {
+    private readonly shape;
+    readonly kind = "object";
+    private readonly entries;
+    private allowsUnknownKeys;
+    constructor(shape: Shape);
+    /**
+     * Structured-OPEN object mode (2026-08-23, fourth external review). The declared shape is still
+     * fully validated, but unknown keys are ALLOWED and preserved — the schema form for a payload
+     * whose contract documents vendor decoration (Law 12: entries stay open). `toJSONSchema()` then
+     * emits the complete `properties`/`required` map with `additionalProperties: true`, so MCP
+     * tools, agents, and generated forms see the real field shape instead of a shapeless object.
+     *
+     * Distinct from parse-time `mode: 'passthrough'` on purpose: openness declared here is a
+     * property of the PAYLOAD's contract (every caller, every mode, and the emitted JSON Schema all
+     * agree), while `passthrough` is one caller's per-parse leniency toward a schema that itself
+     * remains closed. Like every refiner, returns a NEW schema; the receiver stays closed.
+     */
+    open(): this;
+    /** @internal */
+    _check(input: unknown, context: SchemaCheckContext): CheckResult<InferObject<Shape>>;
+    /** @internal */
+    _toJSONSchema(): JSONSchema;
+}
+declare class UnionSchema<T> extends BaseSchema<T> {
+    private readonly members;
+    readonly kind = "union";
+    constructor(members: BaseSchema<T>[]);
+    /** @internal */
+    _check(input: unknown, context: SchemaCheckContext): CheckResult<T>;
+    /** @internal */
+    _toJSONSchema(): JSONSchema;
+}
+/** Accepts any value unchanged. For genuinely open payloads (e.g. `Record<string, unknown>` maps). */
+declare class UnknownSchema extends BaseSchema<unknown> {
+    readonly kind = "unknown";
+    /** @internal */
+    _check(input: unknown): CheckResult<unknown>;
+    /** @internal */
+    _toJSONSchema(): JSONSchema;
+}
+/** Accepts only the literal `null` (JSON's explicit null value; distinct from `undefined`/absent). */
+declare class NullSchema extends BaseSchema<null> {
+    readonly kind = "null";
+    /** @internal */
+    _check(input: unknown, context: SchemaCheckContext): CheckResult<null>;
+    /** @internal */
+    _toJSONSchema(): JSONSchema;
+}
+/** An object with arbitrary string keys whose values all satisfy `value` (e.g. `Fundamentals.fields`). */
+declare class RecordSchema<V> extends BaseSchema<Record<string, V>> {
+    private readonly value;
+    readonly kind = "record";
+    constructor(value: BaseSchema<V>);
+    /** @internal */
+    _check(input: unknown, context: SchemaCheckContext): CheckResult<Record<string, V>>;
+    /** @internal */
+    _toJSONSchema(): JSONSchema;
+}
+/** The schema builder. Returns typed schemas with `parse`/`safeParse`/`toJSONSchema`. */
+export declare const schema: {
+    readonly number: () => NumberSchema;
+    readonly string: () => StringSchema;
+    readonly boolean: () => BooleanSchema;
+    readonly literal: <V extends string | number | boolean>(value: V) => LiteralSchema<V>;
+    readonly enum: <V extends string>(values: readonly V[]) => EnumSchema<V>;
+    readonly array: <Item>(item: Schema<Item>) => ArraySchema<Item>;
+    readonly object: <Shape extends Record<string, Schema<unknown>>>(shape: Shape) => ObjectSchema<Shape>;
+    readonly union: <Members extends readonly Schema<unknown>[]>(members: Members) => UnionSchema<Infer<Members[number]>>;
+    readonly record: <V>(value: Schema<V>) => RecordSchema<V>;
+    readonly unknown: () => UnknownSchema;
+    readonly null: () => NullSchema;
+};
+/** Validate `input` against `schema`, returning a typed `SafeParseResult`. */
+export declare function validate<Output>(schema: Schema<Output>, input: unknown, options?: ParseOptions): SafeParseResult<Output>;
+export type { NumberSchema, StringSchema, BooleanSchema, LiteralSchema, EnumSchema, ArraySchema, ObjectSchema, OptionalSchema, UnionSchema, RecordSchema, UnknownSchema, };
+//# sourceMappingURL=schema.d.ts.map

package/modules/core/dist/schema/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/schema/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAa,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EAEtB,MAAM,eAAe,CAAC;AAEvB,gGAAgG;AAChG,eAAO,MAAM,8BAA8B,wBAAwB,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,GAAG,KAAK,CAAC;AAEzE,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CAC3B;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,IACzB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC;AAEjE,+EAA+E;AAC/E,MAAM,WAAW,MAAM,CAAC,MAAM,CAAE,SAAQ,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IACtD,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC3E,YAAY,IAAI,UAAU,CAAC;IAC3B,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,qDAAqD;AACrD,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CAC3B;AAED,KAAK,WAAW,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC;AAmBpF,uBAAe,UAAU,CAAC,MAAM,CAAE,YAAW,MAAM,CAAC,MAAM,CAAC;IACzD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAS;IACrC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAEhC,gBAAgB;IAChB,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAAC,MAAM,CAAC;IACjF,gBAAgB;IAChB,QAAQ,CAAC,aAAa,IAAI,UAAU;IAEpC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM;IAMrD,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC;IAY1E,YAAY,IAAI,UAAU;IAQ1B,QAAQ,IAAI,cAAc,CAAC,MAAM,CAAC;IAIlC;;;;;OAKG;IACH,SAAS,CAAC,KAAK,IAAI,IAAI;IAMvB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAMnC,IAAI,CAAC,WAAW,CAAC,IAAI,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,CAU1D;CACF;AAMD,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,cAAM,YAAa,SAAQ,UAAU,CAAC,MAAM,CAAC;IAC3C,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,CAAC,CAAoB;gBAEjB,WAAW,GAAE,iBAAsB;IAK/C,OAAO,CAAC,eAAe;IAKvB,OAAO,IAAI,IAAI;IAGf,QAAQ,IAAI,IAAI;IAGhB,WAAW,IAAI,IAAI;IAGnB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAGxB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAGxB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAGvB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIvB,gBAAgB;IAChB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAAC,MAAM,CAAC;IA+CxE,gBAAgB;IAChB,aAAa,IAAI,UAAU;CAQ5B;AAMD,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;CACxC;AAED,cAAM,YAAa,SAAQ,UAAU,CAAC,MAAM,CAAC;IAC3C,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,CAAC,CAAoB;gBAEjB,WAAW,GAAE,iBAAsB;IAK/C,OAAO,CAAC,eAAe;IAKvB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAGzB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAGzB,QAAQ,IAAI,IAAI;IAGhB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKrC,IAAI,IAAI,IAAI;IAGZ,QAAQ,IAAI,IAAI;IAIhB,gBAAgB;IAChB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAAC,MAAM,CAAC;IAuCxE,gBAAgB;IAChB,aAAa,IAAI,UAAU;CAQ5B;AAMD,cAAM,aAAc,SAAQ,UAAU,CAAC,OAAO,CAAC;IAC7C,QAAQ,CAAC,IAAI,aAAa;IAE1B,gBAAgB;IAChB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAAC,OAAO,CAAC;IAgBzE,gBAAgB;IAChB,aAAa,IAAI,UAAU;CAG5B;AAMD,cAAM,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;IAEhE,OAAO,CAAC,QAAQ,CAAC,KAAK;IADlC,QAAQ,CAAC,IAAI,aAAa;gBACG,KAAK,EAAE,CAAC;IAIrC,gBAAgB;IAChB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAAC,CAAC,CAAC;IAOnE,gBAAgB;IAChB,aAAa,IAAI,UAAU;CAG5B;AAMD,cAAM,UAAU,CAAC,CAAC,SAAS,MAAM,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,IAAI,UAAU;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAC1B,MAAM,EAAE,SAAS,CAAC,EAAE;IAKhC,gBAAgB;IAChB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAAC,CAAC,CAAC;IAmBnE,gBAAgB;IAChB,aAAa,IAAI,UAAU;CAG5B;AAMD,cAAM,WAAW,CAAC,IAAI,CAAE,SAAQ,UAAU,CAAC,IAAI,EAAE,CAAC;IAG9C,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,MAAM;IAHhB,QAAQ,CAAC,IAAI,WAAW;gBAEL,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,EAC/B,MAAM,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO;IAKrD,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK1B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM1B,gBAAgB;IAChB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IA4BxE,gBAAgB;IAChB,aAAa,IAAI,UAAU;CAM5B;AAMD,cAAM,cAAc,CAAC,CAAC,CAAE,SAAQ,UAAU,CAAC,CAAC,GAAG,SAAS,CAAC;IAG3C,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,SAAkB,UAAU,QAAQ;IACpC,QAAQ,CAAC,IAAI,cAAc;gBACE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;IAIjD,gBAAgB;IAChB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAAC,CAAC,GAAG,SAAS,CAAC;IAK/E,gBAAgB;IAChB,aAAa,IAAI,UAAU;IAIlB,QAAQ,IAAI,cAAc,CAAC,CAAC,GAAG,SAAS,CAAC;CAGnD;AAmED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAC3C,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EACrB,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,EACnC,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;CAAO,GACzD,MAAM,CAAC,MAAM,CAAC,CAEhB;AAQD,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAC;AAEjD,KAAK,iBAAiB,CAAC,KAAK,IAAI;KAC7B,CAAC,IAAI,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS;QAAE,UAAU,EAAE,IAAI,CAAA;KAAE,GAAG,CAAC,GAAG,KAAK;CACtE,CAAC,MAAM,KAAK,CAAC,CAAC;AACf,KAAK,iBAAiB,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;AAE/E,MAAM,MAAM,WAAW,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,QAAQ,CAC/E;KAAG,CAAC,IAAI,iBAAiB,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG;KAGpD,CAAC,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC;CACtE,CACF,CAAC;AAEF,cAAM,YAAY,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAE,SAAQ,UAAU,CAClF,WAAW,CAAC,KAAK,CAAC,CACnB;IAKa,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJlC,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,iBAAiB,CAAS;gBAEL,KAAK,EAAE,KAAK;IAKzC;;;;;;;;;;;OAWG;IACH,IAAI,IAAI,IAAI;IAMZ,gBAAgB;IAChB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IA4DpF,gBAAgB;IAChB,aAAa,IAAI,UAAU;CAiB5B;AAMD,cAAM,WAAW,CAAC,CAAC,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;IAE5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IADpC,QAAQ,CAAC,IAAI,WAAW;gBACK,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE;IAIrD,gBAAgB;IAChB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAAC,CAAC,CAAC;IAoBnE,gBAAgB;IAChB,aAAa,IAAI,UAAU;CAG5B;AAmED,sGAAsG;AACtG,cAAM,aAAc,SAAQ,UAAU,CAAC,OAAO,CAAC;IAC7C,QAAQ,CAAC,IAAI,aAAa;IAE1B,gBAAgB;IAChB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;IAI5C,gBAAgB;IAChB,aAAa,IAAI,UAAU;CAG5B;AAED,sGAAsG;AACtG,cAAM,UAAW,SAAQ,UAAU,CAAC,IAAI,CAAC;IACvC,QAAQ,CAAC,IAAI,UAAU;IAEvB,gBAAgB;IAChB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAAC,IAAI,CAAC;IAOtE,gBAAgB;IAChB,aAAa,IAAI,UAAU;CAG5B;AAED,0GAA0G;AAC1G,cAAM,YAAY,CAAC,CAAC,CAAE,SAAQ,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAE7C,OAAO,CAAC,QAAQ,CAAC,KAAK;IADlC,QAAQ,CAAC,IAAI,YAAY;gBACI,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;IAIjD,gBAAgB;IAChB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAmBnF,gBAAgB;IAChB,aAAa,IAAI,UAAU;CAG5B;AAMD,yFAAyF;AACzF,eAAO,MAAM,MAAM;2BAGP,YAAY;2BAGZ,YAAY;4BAGX,aAAa;uBAGhB,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,SAAS,CAAC,KAAG,aAAa,CAAC,CAAC,CAAC;oBAGnE,CAAC,SAAS,MAAM,UAAU,SAAS,CAAC,EAAE,KAAG,UAAU,CAAC,CAAC,CAAC;qBAGrD,IAAI,QAAQ,MAAM,CAAC,IAAI,CAAC,KAAG,WAAW,CAAC,IAAI,CAAC;sBAG3C,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,KAAK,KAAG,YAAY,CAAC,KAAK,CAAC;qBAGlF,OAAO,SAAS,SAAS,MAAM,CAAC,OAAO,CAAC,EAAE,WACrC,OAAO,KACf,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;sBAG/B,CAAC,SAAS,MAAM,CAAC,CAAC,CAAC,KAAG,YAAY,CAAC,CAAC,CAAC;4BAGjC,aAAa;yBAGhB,UAAU;CAGV,CAAC;AAEX,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,MAAM,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EACtB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,YAAY,GACrB,eAAe,CAAC,MAAM,CAAC,CAEzB;AAED,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,aAAa,EACb,UAAU,EACV,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,EACX,YAAY,EACZ,aAAa,GACd,CAAC"}