@botejs/core 0.5.0 → 0.7.0

package/dist/validate.d.ts

@@ -1,23 +1,9 @@
 import type { StandardSchemaV1 } from '@standard-schema/spec';
-import type { PathFaultCode } from '@botejs/native';
-export type { StandardSchemaV1, PathFaultCode };
-export type Segment = string | number;
-export type Path = readonly Segment[];
-export declare class ValidationError extends Error {
-    readonly issues: readonly StandardSchemaV1.Issue[];
-    readonly path: Path;
-    constructor(issues: readonly StandardSchemaV1.Issue[], path: Path);
-}
-export declare class PathError extends Error {
-    readonly path: Path;
-    /** The fault kind; stable across versions, safe to branch on. */
-    readonly code: PathFaultCode;
-    constructor(path: Path, code: PathFaultCode, segment?: number);
-}
+import { type Path } from './path.ts';
+export type { StandardSchemaV1 };
 export declare function runStandardSchema<O>(schema: StandardSchemaV1<unknown, O>, value: unknown, path: Path): Promise<O>;
 export declare function validateItem<O>(schema: StandardSchemaV1<unknown, O>, value: unknown, path: Path, onInvalid: 'throw' | 'skip'): Promise<{
     skip: true;
 } | {
     value: O;
 }>;
-export declare function formatPath(path: Path): string;

package/dist/validate.js

@@ -1,64 +1,18 @@
-export class ValidationError extends Error {
-    issues;
-    path;
-    constructor(issues, path) {
-        super(`bote: schema validation failed at ${formatPath(path)}: ${issues[0]?.message ?? 'unknown'}`);
-        this.name = 'ValidationError';
-        this.issues = issues;
-        this.path = path;
-    }
-}
-/** Human message per fault kind. The native layer ships only the code (and the
- *  offending `segment` where it matters), so this is the single source of the
- *  user-facing prose. Keyed by the Rust-generated [`PathFaultCode`]. */
-const PATH_FAULT_MESSAGE = {
-    through_scalar: (segment) => `path traverses a non-container value at segment ${segment}`,
-    wrong_kind: (segment) => `path segment ${segment} does not match the container kind`,
-    scalar_target: () => 'target value is not a container',
-};
-export class PathError extends Error {
-    path;
-    /** The fault kind; stable across versions, safe to branch on. */
-    code;
-    constructor(path, code, segment) {
-        const reason = (PATH_FAULT_MESSAGE[code] ?? (() => code))(segment);
-        super(`bote: cannot resolve ${formatPath(path)}: ${reason}`);
-        this.name = 'PathError';
-        this.path = path;
-        this.code = code;
-    }
-}
+import { ValidationError } from "./error.js";
 export async function runStandardSchema(schema, value, path) {
     const result = await schema['~standard'].validate(value);
-    if (result.issues)
+    if (result.issues) {
         throw new ValidationError(result.issues, path);
+    }
     return result.value;
 }
 export async function validateItem(schema, value, path, onInvalid) {
     const result = await schema['~standard'].validate(value);
     if (result.issues) {
-        if (onInvalid === 'skip')
+        if (onInvalid === 'skip') {
             return { skip: true };
+        }
         throw new ValidationError(result.issues, path);
     }
     return { value: result.value };
 }
-export function formatPath(path) {
-    if (path.length === 0)
-        return '(root)';
-    let out = '';
-    for (let i = 0; i < path.length; i++) {
-        const seg = path[i];
-        if (typeof seg === 'number') {
-            out += `[${seg}]`;
-            continue;
-        }
-        if (/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(seg)) {
-            out += i === 0 ? seg : `.${seg}`;
-        }
-        else {
-            out += `[${JSON.stringify(seg)}]`;
-        }
-    }
-    return out;
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botejs/core",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -31,11 +31,12 @@
     "build": "tsc",
     "build:debug": "tsc --sourceMap",
     "test": "node --test __test__/*.spec.ts",
+    "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p __test__/tsconfig.json",
     "lint": "oxlint src",
     "prepublishOnly": "cp ../../README.md ./README.md && tsc"
   },
   "dependencies": {
-    "@botejs/native": "^0.5.0"
+    "@botejs/native": "^0.7.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/dist/decode.d.ts

@@ -1,3 +0,0 @@
-import { type Path } from './validate.ts';
-export declare function deserializeError(err: unknown, path: Path): unknown;
-export declare function parseValue(text: string, path: Path): unknown;

package/dist/decode.js

@@ -1,20 +0,0 @@
-import { PathError, formatPath } from "./validate.js";
-const NATIVE_PATH_ERROR = /^bote:path:([a-z_]+)(?::(\d+))?$/;
-export function deserializeError(err, path) {
-    if (err instanceof Error && !(err instanceof PathError)) {
-        const match = NATIVE_PATH_ERROR.exec(err.message);
-        if (match) {
-            const segment = match[2] === undefined ? undefined : Number(match[2]);
-            return new PathError(path, match[1], segment);
-        }
-    }
-    return err;
-}
-export function parseValue(text, path) {
-    try {
-        return JSON.parse(text);
-    }
-    catch {
-        throw new Error(`bote: malformed JSON value at ${formatPath(path)}`);
-    }
-}

package/dist/sources.d.ts

@@ -1,39 +0,0 @@
-/**
- * A handle on an opened seekable byte stream. The reader owns whatever
- * resources back the stream (a file handle, an `AbortController`, etc.) and
- * surfaces them through `close()`. Constructed by `Source.open()`; never by
- * library callers directly.
- */
-export interface SourceReader {
-    /** Total length of the underlying byte stream. */
-    readonly size: number;
-    /** Preferred read granularity in bytes. Must be a non-zero multiple of 64. */
-    readonly chunkBytes?: number;
-    /**
-     * Read up to `length` bytes starting at `offset` and resolve with the
-     * bytes read. The returned `Uint8Array`'s `.byteLength` is the actual
-     * count, which must be `<= length`.
-     */
-    read(offset: number, length: number): Promise<Uint8Array>;
-    /** Release resources held by the reader. Driven once by the `open()` lifecycle. */
-    close?(): Promise<void> | void;
-}
-/**
- * Describes how to obtain a seekable byte stream. Provide your own object implementing
- * this interface to plug in custom backends.
- */
-export interface Source {
-    /** Acquire the stream. Resolves to a `SourceReader` that owns any underlying resources. */
-    open(): Promise<SourceReader>;
-}
-export interface FactoryOptions {
-    /** Override the factory's default chunk size. Must be a non-zero multiple of 64. */
-    chunkBytes?: number;
-}
-export interface HttpRangeOptions extends FactoryOptions {
-    /** Merged into every request (headers, credentials, signal, etc.). */
-    init?: RequestInit;
-}
-export declare function fromBuffer(buf: Uint8Array | ArrayBuffer, options?: FactoryOptions): Source;
-export declare function fromFile(path: string, options?: FactoryOptions): Source;
-export declare function fromHttpRange(url: string, options?: HttpRangeOptions): Source;