brass-runtime 1.15.0 → 1.16.1

package/dist/perf/index.mjs

@@ -0,0 +1,141 @@
+import {
+  HTTP_PROFILE_VARIANTS,
+  captureMemorySnapshot,
+  comparePerfToBaseline,
+  compareRuntimeProfiles,
+  createPerfHistoryEntry,
+  defaultPerfHistoryDirectory,
+  diagnoseRuntimeProfile,
+  diffMemorySnapshots,
+  extractPerfMetrics,
+  forceGc,
+  formatHttpMemoryLabReport,
+  formatPerfBaselineComparison,
+  formatPerformanceReport,
+  formatRuntimeAbReport,
+  formatRuntimeSoakReport,
+  hasGc,
+  loadPerfBaseline,
+  makePerfRecorder,
+  profileHttpLayers,
+  profileHttpMemoryLab,
+  profileMemoryRetention,
+  profileRuntimeAb,
+  profileRuntimePrimitives,
+  profileRuntimeSoak,
+  readPerfHistory,
+  recommendPerformance,
+  recordPerfHistoryRun,
+  runBrassPerformanceProfile,
+  savePerfBaseline,
+  summarizePerfEvents,
+  writePerfHistoryEntry
+} from "../chunk-HLWLMW2F.mjs";
+import "../chunk-EOC4UHBS.mjs";
+import "../chunk-7CMJS3QE.mjs";
+import "../chunk-5VRJNBLZ.mjs";
+import "../chunk-MOO4L7F4.mjs";
+import "../chunk-FHQGHPMO.mjs";
+import "../chunk-B5JD23U7.mjs";
+import "../chunk-2HQTDLHF.mjs";
+import "../chunk-A2OM6NEH.mjs";
+import "../chunk-DNFO2EIZ.mjs";
+import "../chunk-MT3OWDPC.mjs";
+import "../chunk-EJ6BPYVR.mjs";
+import "../chunk-PWC3RBQE.mjs";
+import "../chunk-GYM3LLGS.mjs";
+import "../chunk-36I3M4UC.mjs";
+import "../chunk-DNFJLJMW.mjs";
+import "../chunk-Y6FXYEAI.mjs";
+
+// src/perf/budget.ts
+async function runRuntimePerfBudget(options = {}) {
+  const ab = await profileRuntimeAb({
+    ...options,
+    thresholds: {
+      maxRegressionPercent: options.thresholds?.maxRegressionPercent ?? 50,
+      minSignificantDeltaPercent: options.thresholds?.minSignificantDeltaPercent ?? 5
+    }
+  });
+  const minOpsPerSecond = positiveNumber(options.minOpsPerSecond, 1e4);
+  const maxHeapDeltaMb = positiveNumber(options.maxHeapDeltaMb, 32);
+  const violations = [];
+  for (const violation of ab.budgetViolations) {
+    violations.push({ area: "regression", message: violation });
+  }
+  for (const result of ab.candidate.results) {
+    if (result.units >= 1e3 && result.operationsPerSecond < minOpsPerSecond) {
+      violations.push({
+        area: "throughput",
+        message: `${result.name} throughput ${result.operationsPerSecond} ops/s is below ${minOpsPerSecond} ops/s`
+      });
+    }
+  }
+  if (ab.memory.delta.heapUsedMb > maxHeapDeltaMb) {
+    violations.push({
+      area: "memory",
+      message: `runtime A/B heap delta ${ab.memory.delta.heapUsedMb}MB exceeds ${maxHeapDeltaMb}MB`
+    });
+  }
+  return Object.freeze({
+    ab,
+    passed: violations.length === 0,
+    violations: Object.freeze(violations.map((item) => Object.freeze(item)))
+  });
+}
+function formatRuntimePerfBudgetReport(report) {
+  const lines = [];
+  lines.push(`Runtime performance budget: ${report.passed ? "pass" : "fail"}`);
+  lines.push(`baseline=${report.ab.baselineVariant} candidate=${report.ab.candidateVariant}`);
+  for (const comparison of report.ab.comparisons) {
+    const sign = comparison.deltaPercent >= 0 ? "+" : "";
+    lines.push(`- ${comparison.primitive}: ${sign}${comparison.deltaPercent}%`);
+  }
+  if (report.violations.length > 0) {
+    lines.push("");
+    lines.push("Violations");
+    for (const violation of report.violations) {
+      lines.push(`- [${violation.area}] ${violation.message}`);
+    }
+  }
+  return lines.join("\n");
+}
+function positiveNumber(value, fallback) {
+  if (value === void 0 || !Number.isFinite(value)) return fallback;
+  return Math.max(0, value);
+}
+export {
+  HTTP_PROFILE_VARIANTS,
+  captureMemorySnapshot,
+  comparePerfToBaseline,
+  compareRuntimeProfiles,
+  createPerfHistoryEntry,
+  defaultPerfHistoryDirectory,
+  diagnoseRuntimeProfile,
+  diffMemorySnapshots,
+  extractPerfMetrics,
+  forceGc,
+  formatHttpMemoryLabReport,
+  formatPerfBaselineComparison,
+  formatPerformanceReport,
+  formatRuntimeAbReport,
+  formatRuntimePerfBudgetReport,
+  formatRuntimeSoakReport,
+  hasGc,
+  loadPerfBaseline,
+  makePerfRecorder,
+  profileHttpLayers,
+  profileHttpMemoryLab,
+  profileMemoryRetention,
+  profileRuntimeAb,
+  profileRuntimePrimitives,
+  profileRuntimeSoak,
+  readPerfHistory,
+  recommendPerformance,
+  recordPerfHistoryRun,
+  runBrassPerformanceProfile,
+  runRuntimePerfBudget,
+  savePerfBaseline,
+  summarizePerfEvents,
+  writePerfHistoryEntry
+};

package/dist/schedule-CK3Ml_7p.d.ts

@@ -0,0 +1,259 @@
+import { A as Async, R as RuntimeHooks, a as RuntimeEmitContext } from './effect-DIUHZ9IN.js';
+
+type CircuitBreakerState = "closed" | "open" | "half-open";
+type CircuitBreakerError = {
+    readonly _tag: "CircuitBreakerOpen";
+    readonly openSince: number;
+    readonly failures: number;
+};
+type CircuitBreakerConfig = {
+    /** Number of consecutive failures before opening the circuit. Default: 5 */
+    readonly failureThreshold?: number;
+    /** Time in ms to wait before transitioning from OPEN to HALF_OPEN. Default: 30000 */
+    readonly resetTimeoutMs?: number;
+    /** Number of successes in HALF_OPEN needed to close the circuit. Default: 1 */
+    readonly successThreshold?: number;
+    /** Custom predicate: should this error count as a failure? Default: all errors count. */
+    readonly isFailure?: (error: unknown) => boolean;
+    /** Called on state transitions (for observability). */
+    readonly onStateChange?: (from: CircuitBreakerState, to: CircuitBreakerState) => void;
+};
+type CircuitBreakerStats = {
+    readonly state: CircuitBreakerState;
+    readonly failures: number;
+    readonly successes: number;
+    readonly totalRequests: number;
+    readonly totalFailures: number;
+    readonly totalSuccesses: number;
+    readonly totalRejected: number;
+    readonly lastFailureTime: number | null;
+    readonly lastSuccessTime: number | null;
+};
+type CircuitBreaker = {
+    /** Current state of the circuit breaker. */
+    readonly state: () => CircuitBreakerState;
+    /** Run an effect through the circuit breaker. */
+    readonly protect: <R, E, A>(effect: Async<R, E, A>) => Async<R, E | CircuitBreakerError, A>;
+    /** Get current stats. */
+    readonly stats: () => CircuitBreakerStats;
+    /** Manually reset to closed state. */
+    readonly reset: () => void;
+};
+/**
+ * Creates a circuit breaker.
+ *
+ * ```ts
+ * const breaker = makeCircuitBreaker({ failureThreshold: 3, resetTimeoutMs: 10000 });
+ *
+ * // Protect an effect:
+ * const result = await run(breaker.protect(callExternalService()));
+ * // Throws CircuitBreakerOpen if circuit is open
+ * ```
+ */
+declare function makeCircuitBreaker(config?: CircuitBreakerConfig): CircuitBreaker;
+
+type RuntimeTimerId = unknown;
+type RuntimeClock = {
+    readonly now: () => number;
+    readonly setTimeout: (task: () => void, ms: number) => RuntimeTimerId;
+    readonly clearTimeout: (timer: RuntimeTimerId) => void;
+};
+type RuntimeClockEnv = {
+    readonly brass?: {
+        readonly clock?: RuntimeClock;
+    };
+};
+declare const liveClock: RuntimeClock;
+declare function runtimeClockFromEnv(env: unknown): RuntimeClock;
+
+type ScheduleDecision = {
+    readonly continue: boolean;
+    readonly delayMs: number;
+    readonly attempt?: number;
+    readonly elapsedMs?: number;
+    readonly reason?: string;
+    readonly name?: string;
+};
+type ScheduleJitterOptions = {
+    /** 1 means full jitter in [0, delay], 0.2 means +/-20% around delay. */
+    readonly factor?: number;
+    /** Deterministic hook for tests. Defaults to Math.random. */
+    readonly random?: () => number;
+};
+type ScheduleStepContext = {
+    readonly clock: RuntimeClock;
+    readonly startedAtMs: number;
+    readonly attempt: number;
+    readonly name?: string;
+};
+type ScheduleObserverEvent<I, O> = {
+    readonly name?: string;
+    readonly input: I;
+    readonly output: O;
+    readonly decision: ScheduleDecision;
+    readonly attempt: number;
+    readonly elapsedMs: number;
+    readonly state: unknown;
+    readonly nextState: unknown;
+    readonly timestamp: number;
+};
+type ScheduleObserver<I, O> = (event: ScheduleObserverEvent<I, O>) => void;
+type ScheduleDriverDecision<O> = {
+    readonly continue: boolean;
+    readonly delayMs: number;
+    readonly output: O;
+    readonly decision: ScheduleDecision;
+    readonly attempt: number;
+    readonly elapsedMs: number;
+    readonly state: unknown;
+};
+type ScheduleDriverSnapshot<O = unknown> = {
+    readonly name?: string;
+    readonly attempt: number;
+    readonly elapsedMs: number;
+    readonly state: unknown;
+    readonly last?: ScheduleDriverDecision<O>;
+};
+type ScheduleDriverOptions<I = unknown, O = unknown> = {
+    readonly name?: string;
+    readonly clock?: RuntimeClock;
+    readonly startedAtMs?: number;
+    readonly onDecision?: ScheduleObserver<I, O>;
+    readonly hooks?: RuntimeHooks;
+    readonly emitContext?: RuntimeEmitContext;
+    readonly captureInput?: boolean;
+    readonly captureOutput?: boolean;
+};
+type ScheduleDriver<I, O> = {
+    readonly next: (input: I) => ScheduleDriverDecision<O>;
+    readonly reset: () => void;
+    readonly snapshot: () => ScheduleDriverSnapshot<O>;
+    readonly state: () => unknown;
+    readonly last: () => ScheduleDriverDecision<O> | undefined;
+};
+/** Retry/repeat up to N times with no delay. */
+declare function recurs(n: number): Schedule<unknown, number>;
+/** Continue forever with no delay. */
+declare function forever(): Schedule<unknown, number>;
+/** Never continue. */
+declare function never(): Schedule<unknown, number>;
+/** Continue exactly once. */
+declare function once(): Schedule<unknown, number>;
+/** Fixed delay between each retry/repeat. */
+declare function fixed(delayMs: number): Schedule<unknown, number>;
+/** Alias for fixed delay schedules. */
+declare const spaced: typeof fixed;
+/** Exponential backoff: delay doubles each time, capped at maxDelayMs. */
+declare function exponential(baseMs: number, maxMs?: number): Schedule<unknown, number>;
+/** Linear backoff: base, 2*base, 3*base... capped at maxDelayMs. */
+declare function linear(baseMs: number, maxMs?: number): Schedule<unknown, number>;
+/** Fibonacci backoff: base, base, 2*base, 3*base, 5*base, capped at maxDelayMs. */
+declare function fibonacci(baseMs: number, maxMs?: number): Schedule<unknown, number>;
+/** Exponential backoff with full jitter (random in [0, delay]). */
+declare function jittered(baseMs: number, maxMs?: number): Schedule<unknown, number>;
+/** Stop after a total elapsed time. */
+declare function elapsed(maxMs: number): Schedule<unknown, number>;
+/** Only continue while a predicate holds on the input. */
+declare function whileInput<I>(pred: (input: I) => boolean): Schedule<I, I>;
+/** Continue until the input predicate becomes true. */
+declare function untilInput<I>(pred: (input: I) => boolean): Schedule<I, I>;
+/** Limit a schedule to N repetitions. */
+declare function take<I, O>(schedule: Schedule<I, O>, n: number): Schedule<I, O>;
+/** Transform schedule output while preserving decisions and state. */
+declare function map<I, O, O2>(schedule: Schedule<I, O>, f: (output: O) => O2): Schedule<I, O2>;
+/** Transform schedule input before it reaches the wrapped schedule. */
+declare function contramap<I0, I, O>(schedule: Schedule<I, O>, f: (input: I0) => I): Schedule<I0, O>;
+/** Add jitter to any schedule's delay. */
+declare function jitteredSchedule<I, O>(schedule: Schedule<I, O>, options?: number | ScheduleJitterOptions): Schedule<I, O>;
+declare const jitter: typeof jitteredSchedule;
+/**
+ * Reset a schedule's internal state after a rolling time window.
+ * Useful for retry/polling policies that should forgive old bursts.
+ */
+declare function windowed<I, O>(schedule: Schedule<I, O>, windowMs: number, clock?: () => number): Schedule<I, O>;
+/** Cap a schedule's delay without changing its state or output. */
+declare function maxDelay<I, O>(schedule: Schedule<I, O>, maxMs: number): Schedule<I, O>;
+/** Stop a schedule after a total elapsed runtime-clock budget. */
+declare function maxElapsed<I, O>(schedule: Schedule<I, O>, maxMs: number): Schedule<I, O>;
+declare const upTo: typeof maxElapsed;
+/** Continue while a predicate holds on the wrapped schedule output. */
+declare function whileOutput<I, O>(schedule: Schedule<I, O>, pred: (output: O) => boolean): Schedule<I, O>;
+/** Continue until a predicate holds on the wrapped schedule output. */
+declare function untilOutput<I, O>(schedule: Schedule<I, O>, pred: (output: O) => boolean): Schedule<I, O>;
+/** Attach an observability name to a schedule. */
+declare function named<I, O>(name: string, schedule: Schedule<I, O>): Schedule<I, O>;
+/** Observe each schedule decision without changing semantics. */
+declare function tapDecision<I, O>(schedule: Schedule<I, O>, tap: ScheduleObserver<I, O>): Schedule<I, O>;
+/** Compose two schedules: use the first, then switch to the second. */
+declare function andThen<I, O1, O2>(first: Schedule<I, O1>, second: Schedule<I, O2>): Schedule<I, O1 | O2>;
+/** Run both schedules and continue while BOTH say continue. Use max delay. */
+declare function intersect<I, O1, O2>(left: Schedule<I, O1>, right: Schedule<I, O2>): Schedule<I, [O1, O2]>;
+/** Run both schedules and continue while EITHER says continue. Use min delay. */
+declare function union<I, O1, O2>(left: Schedule<I, O1>, right: Schedule<I, O2>): Schedule<I, [O1, O2]>;
+declare function makeScheduleDriver<I, O>(schedule: Schedule<I, O>, options?: ScheduleDriverOptions<I, O>): ScheduleDriver<I, O>;
+declare const scheduleDriver: typeof makeScheduleDriver;
+declare function runSchedule<I, O>(schedule: Schedule<I, O>, inputs: Iterable<I>, options?: ScheduleDriverOptions<I, O>): ScheduleDriverDecision<O>[];
+/**
+ * Retry an effect according to a schedule.
+ * The schedule receives the error as input on each failure.
+ */
+declare function retryWithSchedule<R, E, A, O>(effect: Async<R, E, A>, schedule: Schedule<E, O>, options?: ScheduleDriverOptions<E, O>): Async<R, E, A>;
+declare const retry: typeof retryWithSchedule;
+/**
+ * Repeat an effect according to a schedule.
+ * The schedule receives the success value as input on each iteration.
+ * Returns the last successful value.
+ */
+declare function repeatWithSchedule<R, E, A, O>(effect: Async<R, E, A>, schedule: Schedule<A, O>, options?: ScheduleDriverOptions<A, O>): Async<R, E, A>;
+declare const repeat: typeof repeatWithSchedule;
+declare const poll: typeof repeatWithSchedule;
+/**
+ * A Schedule<I, O> takes an input I (typically the error or output of an effect)
+ * and decides whether to continue and with what delay.
+ */
+type Schedule<I, O> = {
+    readonly _tag: "Schedule";
+    readonly name?: string;
+    /** Initial state */
+    readonly initial: (context?: ScheduleStepContext) => any;
+    /** Given current state and input, produce a decision and next state */
+    readonly step: (state: any, input: I, context?: ScheduleStepContext) => [ScheduleDecision, any, O];
+};
+declare const Schedule: Readonly<{
+    driver: typeof makeScheduleDriver;
+    run: typeof runSchedule;
+    recurs: typeof recurs;
+    forever: typeof forever;
+    never: typeof never;
+    once: typeof once;
+    fixed: typeof fixed;
+    spaced: typeof fixed;
+    linear: typeof linear;
+    exponential: typeof exponential;
+    fibonacci: typeof fibonacci;
+    jittered: typeof jittered;
+    jitteredSchedule: typeof jitteredSchedule;
+    jitter: typeof jitteredSchedule;
+    elapsed: typeof elapsed;
+    whileInput: typeof whileInput;
+    untilInput: typeof untilInput;
+    whileOutput: typeof whileOutput;
+    untilOutput: typeof untilOutput;
+    take: typeof take;
+    map: typeof map;
+    contramap: typeof contramap;
+    maxDelay: typeof maxDelay;
+    maxElapsed: typeof maxElapsed;
+    upTo: typeof maxElapsed;
+    windowed: typeof windowed;
+    named: typeof named;
+    tapDecision: typeof tapDecision;
+    andThen: typeof andThen;
+    intersect: typeof intersect;
+    union: typeof union;
+    retry: typeof retryWithSchedule;
+    repeat: typeof repeatWithSchedule;
+    poll: typeof repeatWithSchedule;
+}>;
+
+export { upTo as $, liveClock as A, makeCircuitBreaker as B, type CircuitBreakerError as C, makeScheduleDriver as D, map as E, maxDelay as F, maxElapsed as G, named as H, never as I, once as J, poll as K, recurs as L, repeatWithSchedule as M, repeat as N, retryWithSchedule as O, retry as P, runSchedule as Q, type RuntimeClock as R, Schedule as S, runtimeClockFromEnv as T, scheduleDriver as U, spaced as V, take as W, tapDecision as X, union as Y, untilInput as Z, untilOutput as _, type ScheduleObserver as a, whileInput as a0, whileOutput as a1, windowed as a2, type CircuitBreakerStats as b, type CircuitBreaker as c, type CircuitBreakerConfig as d, type CircuitBreakerState as e, type RuntimeClockEnv as f, type RuntimeTimerId as g, type ScheduleDecision as h, type ScheduleDriver as i, type ScheduleDriverDecision as j, type ScheduleDriverOptions as k, type ScheduleDriverSnapshot as l, type ScheduleObserverEvent as m, type ScheduleStepContext as n, andThen as o, contramap as p, elapsed as q, exponential as r, fibonacci as s, fixed as t, forever as u, intersect as v, jitter as w, jittered as x, jitteredSchedule as y, linear as z };

package/dist/schema/index.cjs

@@ -0,0 +1,29 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+
+
+
+
+
+
+var _chunkCZIVE6NTcjs = require('../chunk-CZIVE6NT.cjs');
+require('../chunk-OBGZSXTJ.cjs');
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.ConfigValidationError = _chunkCZIVE6NTcjs.ConfigValidationError; exports.Schema = _chunkCZIVE6NTcjs.Schema; exports.SchemaValidationException = _chunkCZIVE6NTcjs.SchemaValidationException; exports.formatConfigError = _chunkCZIVE6NTcjs.formatConfigError; exports.formatIssues = _chunkCZIVE6NTcjs.formatIssues; exports.isConfigValidationError = _chunkCZIVE6NTcjs.isConfigValidationError; exports.isSchema = _chunkCZIVE6NTcjs.isSchema; exports.makeSchemaIssue = _chunkCZIVE6NTcjs.makeSchemaIssue; exports.parseConfig = _chunkCZIVE6NTcjs.parseConfig; exports.s = _chunkCZIVE6NTcjs.s; exports.schema = _chunkCZIVE6NTcjs.schema; exports.validateValue = _chunkCZIVE6NTcjs.validateValue;

package/dist/schema/index.d.ts

@@ -0,0 +1,179 @@
+type SchemaPathPart = string | number;
+type SchemaIssue = {
+    readonly path: readonly SchemaPathPart[];
+    readonly expected: string;
+    readonly received: string;
+    readonly message: string;
+};
+type SchemaResult<A> = {
+    readonly success: true;
+    readonly data: A;
+} | {
+    readonly success: false;
+    readonly issues: readonly SchemaIssue[];
+};
+type AnySchema = Schema<any, any>;
+type InferSchema<S> = S extends Schema<infer A, any> ? A : never;
+type SchemaShape = Record<string, AnySchema>;
+type OptionalKeys<Shape extends SchemaShape> = {
+    [K in keyof Shape]: Shape[K] extends Schema<any, true> ? K : never;
+}[keyof Shape];
+type RequiredKeys<Shape extends SchemaShape> = Exclude<keyof Shape, OptionalKeys<Shape>>;
+type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type InferObject<Shape extends SchemaShape> = Simplify<{
+    [K in RequiredKeys<Shape>]: InferSchema<Shape[K]>;
+} & {
+    [K in OptionalKeys<Shape>]?: Exclude<InferSchema<Shape[K]>, undefined>;
+}>;
+type JsonValidatorResult<A> = {
+    readonly success: true;
+    readonly data: A;
+} | {
+    readonly success: false;
+    readonly error: string;
+    readonly issues?: readonly SchemaIssue[];
+};
+type JsonValidator<A> = (data: unknown) => JsonValidatorResult<A>;
+type JsonSchemaLike<A> = Schema<A, any> | JsonValidator<A>;
+type AnyJsonSchemaLike = JsonSchemaLike<any>;
+type InferJsonSchema<V> = V extends Schema<infer A, any> ? A : V extends JsonValidator<infer A> ? A : never;
+type StringSchemaOptions = {
+    readonly minLength?: number;
+    readonly maxLength?: number;
+    readonly pattern?: RegExp;
+    readonly name?: string;
+};
+type NumberSchemaOptions = {
+    readonly min?: number;
+    readonly max?: number;
+    readonly int?: boolean;
+    readonly finite?: boolean;
+    readonly name?: string;
+};
+type ObjectSchemaOptions = {
+    readonly unknownKeys?: "strip" | "passthrough" | "strict";
+    readonly name?: string;
+};
+declare class SchemaValidationException extends Error {
+    readonly issues: readonly SchemaIssue[];
+    constructor(issues: readonly SchemaIssue[]);
+}
+declare class ConfigValidationError extends Error {
+    readonly _tag = "ConfigValidationError";
+    readonly configName: string;
+    readonly issues: readonly SchemaIssue[];
+    constructor(configName: string, issues: readonly SchemaIssue[]);
+}
+declare function isConfigValidationError(error: unknown): error is ConfigValidationError;
+declare function formatConfigError(error: unknown): string;
+declare const makeSchemaIssue: (path: readonly SchemaPathPart[], expected: string, received: unknown, message?: string) => SchemaIssue;
+declare function formatIssues(issues: readonly SchemaIssue[]): string;
+declare function stringSchema(options?: StringSchemaOptions): Schema<string>;
+declare function nonEmptyStringSchema(options?: Omit<StringSchemaOptions, "minLength">): Schema<string>;
+declare function emailSchema(): Schema<string>;
+declare function uuidSchema(): Schema<string>;
+declare function urlSchema(): Schema<string>;
+declare function dateIsoSchema(): Schema<string>;
+declare function numberSchema(options?: NumberSchemaOptions): Schema<number>;
+declare function intSchema(options?: Omit<NumberSchemaOptions, "int">): Schema<number>;
+declare function positiveSchema(options?: NumberSchemaOptions): Schema<number>;
+declare function booleanSchema(name?: string): Schema<boolean>;
+declare function unknownSchema(): Schema<unknown>;
+declare function anySchema(): Schema<any>;
+declare function literalSchema<const Value extends string | number | boolean | null>(value: Value): Schema<Value>;
+declare function enumSchema<const Values extends readonly [string | number, ...(string | number)[]]>(values: Values): Schema<Values[number]>;
+declare function arraySchema<S extends AnySchema>(item: S): Schema<Array<InferSchema<S>>>;
+declare function objectSchema<Shape extends SchemaShape>(shape: Shape, options?: ObjectSchemaOptions): Schema<InferObject<Shape>>;
+declare function recordSchema<S extends AnySchema>(valueSchema: S): Schema<Record<string, InferSchema<S>>>;
+declare function unionSchema<const Members extends readonly [AnySchema, AnySchema, ...AnySchema[]]>(members: Members): Schema<InferSchema<Members[number]>>;
+declare function customSchema<A>(guard: (input: unknown) => input is A, expected: string, message?: string): Schema<A>;
+declare const schema: Readonly<{
+    string: typeof stringSchema;
+    nonEmptyString: typeof nonEmptyStringSchema;
+    email: typeof emailSchema;
+    url: typeof urlSchema;
+    uuid: typeof uuidSchema;
+    dateIso: typeof dateIsoSchema;
+    number: typeof numberSchema;
+    int: typeof intSchema;
+    positive: typeof positiveSchema;
+    boolean: typeof booleanSchema;
+    literal: typeof literalSchema;
+    enum: typeof enumSchema;
+    array: typeof arraySchema;
+    object: typeof objectSchema;
+    record: typeof recordSchema;
+    union: typeof unionSchema;
+    optional: <S extends AnySchema>(inner: S) => Schema<InferSchema<S> | undefined, true>;
+    nullable: <S extends AnySchema>(inner: S) => Schema<InferSchema<S> | null, S["isOptional"]>;
+    unknown: typeof unknownSchema;
+    any: typeof anySchema;
+    custom: typeof customSchema;
+}>;
+declare const s: Readonly<{
+    string: typeof stringSchema;
+    nonEmptyString: typeof nonEmptyStringSchema;
+    email: typeof emailSchema;
+    url: typeof urlSchema;
+    uuid: typeof uuidSchema;
+    dateIso: typeof dateIsoSchema;
+    number: typeof numberSchema;
+    int: typeof intSchema;
+    positive: typeof positiveSchema;
+    boolean: typeof booleanSchema;
+    literal: typeof literalSchema;
+    enum: typeof enumSchema;
+    array: typeof arraySchema;
+    object: typeof objectSchema;
+    record: typeof recordSchema;
+    union: typeof unionSchema;
+    optional: <S extends AnySchema>(inner: S) => Schema<InferSchema<S> | undefined, true>;
+    nullable: <S extends AnySchema>(inner: S) => Schema<InferSchema<S> | null, S["isOptional"]>;
+    unknown: typeof unknownSchema;
+    any: typeof anySchema;
+    custom: typeof customSchema;
+}>;
+type Schema<A, Optional extends boolean = false> = {
+    readonly _tag: "Schema";
+    readonly kind: string;
+    readonly name?: string;
+    readonly isOptional: Optional;
+    readonly _parse: (input: unknown, path: readonly SchemaPathPart[]) => SchemaResult<A>;
+    readonly safeParse: (input: unknown) => SchemaResult<A>;
+    readonly parse: (input: unknown) => A;
+    readonly optional: () => Schema<A | undefined, true>;
+    readonly nullable: () => Schema<A | null, Optional>;
+    readonly array: () => Schema<A[], false>;
+    readonly refine: (predicate: (value: A) => boolean, message?: string) => Schema<A, Optional>;
+    readonly transform: <B>(fn: (value: A) => B, expected?: string) => Schema<B, false>;
+};
+declare const Schema: Readonly<{
+    string: typeof stringSchema;
+    nonEmptyString: typeof nonEmptyStringSchema;
+    email: typeof emailSchema;
+    url: typeof urlSchema;
+    uuid: typeof uuidSchema;
+    dateIso: typeof dateIsoSchema;
+    number: typeof numberSchema;
+    int: typeof intSchema;
+    positive: typeof positiveSchema;
+    boolean: typeof booleanSchema;
+    literal: typeof literalSchema;
+    enum: typeof enumSchema;
+    array: typeof arraySchema;
+    object: typeof objectSchema;
+    record: typeof recordSchema;
+    union: typeof unionSchema;
+    optional: <S extends AnySchema>(inner: S) => Schema<InferSchema<S> | undefined, true>;
+    nullable: <S extends AnySchema>(inner: S) => Schema<InferSchema<S> | null, S["isOptional"]>;
+    unknown: typeof unknownSchema;
+    any: typeof anySchema;
+    custom: typeof customSchema;
+}>;
+declare function isSchema(value: unknown): value is AnySchema;
+declare function validateValue<A>(data: unknown, validator: JsonSchemaLike<A>): SchemaResult<A>;
+declare function parseConfig<A>(configName: string, validator: JsonSchemaLike<A>, value: unknown): A;
+
+export { type AnyJsonSchemaLike, type AnySchema, ConfigValidationError, type InferJsonSchema, type InferObject, type InferSchema, type JsonSchemaLike, type JsonValidator, type JsonValidatorResult, type NumberSchemaOptions, type ObjectSchemaOptions, Schema, type SchemaIssue, type SchemaPathPart, type SchemaResult, type SchemaShape, SchemaValidationException, type StringSchemaOptions, formatConfigError, formatIssues, isConfigValidationError, isSchema, makeSchemaIssue, parseConfig, s, schema, validateValue };

package/dist/schema/index.js

@@ -0,0 +1,29 @@
+import {
+  ConfigValidationError,
+  Schema,
+  SchemaValidationException,
+  formatConfigError,
+  formatIssues,
+  isConfigValidationError,
+  isSchema,
+  makeSchemaIssue,
+  parseConfig,
+  s,
+  schema,
+  validateValue
+} from "../chunk-C3MDXTRZ.js";
+import "../chunk-3RG5ZIWI.js";
+export {
+  ConfigValidationError,
+  Schema,
+  SchemaValidationException,
+  formatConfigError,
+  formatIssues,
+  isConfigValidationError,
+  isSchema,
+  makeSchemaIssue,
+  parseConfig,
+  s,
+  schema,
+  validateValue
+};

package/dist/schema/index.mjs

@@ -0,0 +1,29 @@
+import {
+  ConfigValidationError,
+  Schema,
+  SchemaValidationException,
+  formatConfigError,
+  formatIssues,
+  isConfigValidationError,
+  isSchema,
+  makeSchemaIssue,
+  parseConfig,
+  s,
+  schema,
+  validateValue
+} from "../chunk-DNFJLJMW.mjs";
+import "../chunk-Y6FXYEAI.mjs";
+export {
+  ConfigValidationError,
+  Schema,
+  SchemaValidationException,
+  formatConfigError,
+  formatIssues,
+  isConfigValidationError,
+  isSchema,
+  makeSchemaIssue,
+  parseConfig,
+  s,
+  schema,
+  validateValue
+};