@qlever-llc/trellis 0.7.0 → 0.8.0-rc.2

package/esm/npm/src/errors/KVError.js

@@ -0,0 +1,46 @@
+import Type from "typebox";
+import { TrellisError } from "./TrellisError.js";
+export const KVErrorDataSchema = Type.Object({
+    id: Type.String(),
+    type: Type.Literal("KVError"),
+    message: Type.String(),
+    operation: Type.Optional(Type.String()),
+    context: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
+    traceId: Type.Optional(Type.String()),
+});
+/**
+ * Error for KV storage operations.
+ * Used when key-value store operations fail.
+ */
+export class KVError extends TrellisError {
+    constructor(options) {
+        const { operation, ...baseOptions } = options;
+        const msg = `KV ${operation || ""} failed`;
+        super(msg, baseOptions);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "KVError"
+        });
+        Object.defineProperty(this, "operation", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.operation = operation;
+    }
+    /**
+     * Serializes error to a plain object.
+     *
+     * @returns Plain object representation of the error
+     */
+    toSerializable() {
+        return {
+            ...this.baseSerializable(),
+            type: this.name,
+            operation: this.operation,
+        };
+    }
+}

package/esm/npm/src/errors/RemoteError.d.ts

@@ -0,0 +1,54 @@
+import { Result, type UnexpectedError, type UnexpectedErrorData } from "@qlever-llc/result";
+import Type, { type Static } from "typebox";
+import type { AuthErrorData } from "./AuthError.js";
+import type { KVErrorData } from "./KVError.js";
+import type { StoreErrorData } from "./StoreError.js";
+import type { TrellisErrorData } from "../models/trellis/TrellisError.js";
+import type { TransportErrorData } from "./TransportError.js";
+import type { TransferErrorData } from "./TransferError.js";
+import { TrellisError } from "./TrellisError.js";
+import { ValidationError } from "./ValidationError.js";
+import type { ValidationErrorData } from "./ValidationError.js";
+export declare const RemoteErrorDataSchema: Type.TObject<{
+    id: Type.TString;
+    type: Type.TLiteral<"RemoteError">;
+    message: Type.TString;
+    remoteError: Type.TAny;
+    context: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+    traceId: Type.TOptional<Type.TString>;
+}>;
+export type RemoteErrorData = Static<typeof RemoteErrorDataSchema>;
+export type TransportableTrellisErrorData = UnexpectedErrorData | AuthErrorData | ValidationErrorData | KVErrorData | StoreErrorData | TransportErrorData | TransferErrorData | TrellisErrorData;
+/**
+ * Error for wrapping errors received from remote Trellis services.
+ * This is the only error type with parseJSON/parseObject methods for deserializing remote errors.
+ */
+export declare class RemoteError extends TrellisError<RemoteErrorData> {
+    readonly name: "RemoteError";
+    readonly remoteError: TransportableTrellisErrorData;
+    constructor(options: ErrorOptions & {
+        error: TransportableTrellisErrorData;
+        context?: Record<string, unknown>;
+        id?: string;
+    });
+    /**
+     * Serializes error to a plain object.
+     *
+     * @returns Plain object representation of the error
+     */
+    toSerializable(): RemoteErrorData;
+    /**
+     * Parses and validates a plain object as TrellisErrorData.
+     * Use this to deserialize errors received from remote services.
+     *
+     * @param obj - Plain object to validate
+     * @returns Result containing validated TrellisError or a ValidationError or UnexpectedError
+     */
+    static parse(data: unknown): Result<TransportableTrellisErrorData, ValidationError | UnexpectedError>;
+    /**
+     * Alias for parse() - parses JSON string or object as TrellisErrorData.
+     * @see parse
+     */
+    static parseJSON: typeof RemoteError.parse;
+}
+//# sourceMappingURL=RemoteError.d.ts.map

package/esm/npm/src/errors/RemoteError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteError.d.ts","sourceRoot":"","sources":["../../../../src/errors/RemoteError.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,IAAI,EAAE,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,eAAO,MAAM,qBAAqB;;;;;;;EAOhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEnE,MAAM,MAAM,6BAA6B,GACrC,mBAAmB,GACnB,aAAa,GACb,mBAAmB,GACnB,WAAW,GACX,cAAc,GACd,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,CAAC;AAErB;;;GAGG;AACH,qBAAa,WAAY,SAAQ,YAAY,CAAC,eAAe,CAAC;IAC5D,SAAkB,IAAI,EAAG,aAAa,CAAU;IAChD,QAAQ,CAAC,WAAW,EAAE,6BAA6B,CAAC;gBAGlD,OAAO,EAAE,YAAY,GAAG;QACtB,KAAK,EAAE,6BAA6B,CAAC;QACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,EAAE,CAAC,EAAE,MAAM,CAAC;KACb;IAOH;;;;OAIG;IACM,cAAc,IAAI,eAAe;IAQ1C;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CACV,IAAI,EAAE,OAAO,GACZ,MAAM,CAAC,6BAA6B,EAAE,eAAe,GAAG,eAAe,CAAC;IAyB3E;;;OAGG;IACH,MAAM,CAAC,SAAS,2BAAqB;CACtC"}

package/esm/npm/src/errors/RemoteError.js

@@ -0,0 +1,81 @@
+import { Result, } from "@qlever-llc/result";
+import Type from "typebox";
+import { ParseError, Value } from "typebox/value";
+import { TrellisErrorDataSchema } from "../models/trellis/TrellisError.js";
+import { TrellisError } from "./TrellisError.js";
+import { ValidationError } from "./ValidationError.js";
+export const RemoteErrorDataSchema = Type.Object({
+    id: Type.String(),
+    type: Type.Literal("RemoteError"),
+    message: Type.String(),
+    remoteError: Type.Any(),
+    context: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
+    traceId: Type.Optional(Type.String()),
+});
+/**
+ * Error for wrapping errors received from remote Trellis services.
+ * This is the only error type with parseJSON/parseObject methods for deserializing remote errors.
+ */
+export class RemoteError extends TrellisError {
+    constructor(options) {
+        const { error, ...baseOptions } = options;
+        super(`Remote error: ${error.message}`, baseOptions);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "RemoteError"
+        });
+        Object.defineProperty(this, "remoteError", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.remoteError = error;
+    }
+    /**
+     * Serializes error to a plain object.
+     *
+     * @returns Plain object representation of the error
+     */
+    toSerializable() {
+        return {
+            ...this.baseSerializable(),
+            type: this.name,
+            remoteError: this.remoteError,
+        };
+    }
+    /**
+     * Parses and validates a plain object as TrellisErrorData.
+     * Use this to deserialize errors received from remote services.
+     *
+     * @param obj - Plain object to validate
+     * @returns Result containing validated TrellisError or a ValidationError or UnexpectedError
+     */
+    static parse(data) {
+        return Result.try(() => typeof data === "string" ? JSON.parse(data) : data)
+            .andThen((obj) => {
+            const parseResult = Result.try(() => Value.Parse(TrellisErrorDataSchema, obj));
+            if (parseResult.isErr()) {
+                const cause = parseResult.error.cause;
+                if (cause instanceof ParseError) {
+                    const errors = Value.Errors(TrellisErrorDataSchema, obj);
+                    return Result.err(new ValidationError({ errors, cause }));
+                }
+                return Result.err(parseResult.error);
+            }
+            return Result.ok(parseResult.take());
+        });
+    }
+}
+/**
+ * Alias for parse() - parses JSON string or object as TrellisErrorData.
+ * @see parse
+ */
+Object.defineProperty(RemoteError, "parseJSON", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: RemoteError.parse
+});

package/esm/npm/src/errors/StoreError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StoreError.d.ts","sourceRoot":"","sources":["../../../../src/errors/StoreError.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,EAAE,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,eAAO,MAAM,oBAAoB;;;;;;;EAO/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEjE,qBAAa,UAAW,SAAQ,YAAY,CAAC,cAAc,CAAC;IAC1D,SAAkB,IAAI,EAAG,YAAY,CAAU;IAC/C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAG1B,OAAO,EAAE,YAAY,GAAG;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,EAAE,CAAC,EAAE,MAAM,CAAC;KACb;IAQM,cAAc,IAAI,cAAc;CAW1C"}

package/esm/npm/src/errors/StoreError.js

@@ -0,0 +1,41 @@
+import Type from "typebox";
+import { TrellisError } from "./TrellisError.js";
+export const StoreErrorDataSchema = Type.Object({
+    id: Type.String(),
+    type: Type.Literal("StoreError"),
+    message: Type.String(),
+    operation: Type.Optional(Type.String()),
+    context: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
+    traceId: Type.Optional(Type.String()),
+});
+export class StoreError extends TrellisError {
+    constructor(options) {
+        const { operation, ...baseOptions } = options;
+        const message = `Store ${operation || ""} failed`;
+        super(message, baseOptions);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "StoreError"
+        });
+        Object.defineProperty(this, "operation", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.operation = operation;
+    }
+    toSerializable() {
+        const base = this.baseSerializable();
+        return {
+            id: base.id,
+            type: this.name,
+            message: base.message,
+            ...(this.operation !== undefined ? { operation: this.operation } : {}),
+            ...(base.context !== undefined ? { context: base.context } : {}),
+            ...(base.traceId !== undefined ? { traceId: base.traceId } : {}),
+        };
+    }
+}

package/esm/npm/src/errors/TransferError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransferError.d.ts","sourceRoot":"","sources":["../../../../src/errors/TransferError.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,EAAE,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,eAAO,MAAM,uBAAuB;;;;;;;EAOlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAEvE,qBAAa,aAAc,SAAQ,YAAY,CAAC,iBAAiB,CAAC;IAChE,SAAkB,IAAI,EAAG,eAAe,CAAU;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAG1B,OAAO,EAAE,YAAY,GAAG;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,EAAE,CAAC,EAAE,MAAM,CAAC;KACb;IAQM,cAAc,IAAI,iBAAiB;CAW7C"}

package/esm/npm/src/errors/TransferError.js

@@ -0,0 +1,41 @@
+import Type from "typebox";
+import { TrellisError } from "./TrellisError.js";
+export const TransferErrorDataSchema = Type.Object({
+    id: Type.String(),
+    type: Type.Literal("TransferError"),
+    message: Type.String(),
+    operation: Type.Optional(Type.String()),
+    context: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
+    traceId: Type.Optional(Type.String()),
+});
+export class TransferError extends TrellisError {
+    constructor(options) {
+        const { operation, ...baseOptions } = options;
+        const message = `Transfer ${operation || "operation"} failed`;
+        super(message, baseOptions);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "TransferError"
+        });
+        Object.defineProperty(this, "operation", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.operation = operation;
+    }
+    toSerializable() {
+        const base = this.baseSerializable();
+        return {
+            id: base.id,
+            type: this.name,
+            message: base.message,
+            ...(this.operation !== undefined ? { operation: this.operation } : {}),
+            ...(base.context !== undefined ? { context: base.context } : {}),
+            ...(base.traceId !== undefined ? { traceId: base.traceId } : {}),
+        };
+    }
+}

package/esm/npm/src/errors/TransportError.d.ts

@@ -0,0 +1,30 @@
+import Type, { type Static } from "typebox";
+import { TrellisError } from "./TrellisError.js";
+export declare const TransportErrorDataSchema: Type.TObject<{
+    id: Type.TString;
+    type: Type.TLiteral<"TransportError">;
+    message: Type.TString;
+    code: Type.TString;
+    hint: Type.TString;
+    context: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+    traceId: Type.TOptional<Type.TString>;
+}>;
+export type TransportErrorData = Static<typeof TransportErrorDataSchema>;
+/**
+ * Error for Trellis runtime transport failures.
+ */
+export declare class TransportError extends TrellisError<TransportErrorData> {
+    readonly name: "TransportError";
+    readonly code: string;
+    readonly hint: string;
+    constructor(options: ErrorOptions & {
+        code: string;
+        message: string;
+        hint: string;
+        context?: Record<string, unknown>;
+        id?: string;
+        traceId?: string;
+    });
+    toSerializable(): TransportErrorData;
+}
+//# sourceMappingURL=TransportError.d.ts.map

package/esm/npm/src/errors/TransportError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransportError.d.ts","sourceRoot":"","sources":["../../../../src/errors/TransportError.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,EAAE,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,eAAO,MAAM,wBAAwB;;;;;;;;EAQnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEzE;;GAEG;AACH,qBAAa,cAAe,SAAQ,YAAY,CAAC,kBAAkB,CAAC;IAClE,SAAkB,IAAI,EAAG,gBAAgB,CAAU;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGpB,OAAO,EAAE,YAAY,GAAG;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;IAQM,cAAc,IAAI,kBAAkB;CAQ9C"}

package/esm/npm/src/errors/TransportError.js

@@ -0,0 +1,48 @@
+import Type from "typebox";
+import { TrellisError } from "./TrellisError.js";
+export const TransportErrorDataSchema = Type.Object({
+    id: Type.String(),
+    type: Type.Literal("TransportError"),
+    message: Type.String(),
+    code: Type.String(),
+    hint: Type.String(),
+    context: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
+    traceId: Type.Optional(Type.String()),
+});
+/**
+ * Error for Trellis runtime transport failures.
+ */
+export class TransportError extends TrellisError {
+    constructor(options) {
+        const { code, message, hint, ...baseOptions } = options;
+        super(message, baseOptions);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "TransportError"
+        });
+        Object.defineProperty(this, "code", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "hint", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.code = code;
+        this.hint = hint;
+    }
+    toSerializable() {
+        return {
+            ...this.baseSerializable(),
+            type: this.name,
+            code: this.code,
+            hint: this.hint,
+        };
+    }
+}

package/esm/npm/src/errors/TrellisError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrellisError.d.ts","sourceRoot":"","sources":["../../../../src/errors/TrellisError.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErE;;;;;;;GAOG;AACH,8BAAsB,YAAY,CAChC,KAAK,SAAS,eAAe,GAAG,eAAe,CAC/C,SAAQ,SAAS,CAAC,KAAK,CAAC;CAGzB"}

package/esm/npm/src/errors/TrellisError.js

@@ -0,0 +1,15 @@
+/**
+ * Base class for all Trellis-specific errors.
+ * Extends BaseError and relies on the traceId getter being configured via initTracing.
+ */
+import { BaseError } from "@qlever-llc/result";
+/**
+ * Abstract base class for Trellis errors.
+ * Trellis errors automatically include traceId when initTracing() has been called
+ * and a span is active in the current context.
+ *
+ * The traceId integration is configured by the tracing module's initTracing() function,
+ * which sets up BaseError.traceIdGetter to retrieve the traceId from the active span.
+ */
+export class TrellisError extends BaseError {
+}

package/esm/npm/src/errors/ValidationError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationError.d.ts","sourceRoot":"","sources":["../../../../src/errors/ValidationError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,IAAI,EAAE,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,MAAM,oBAAoB,GAC5B,yBAAyB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAWtC;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;EAGhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;EAOpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE3E;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,YAAY,CAAC,mBAAmB,CAAC;;IACpE,SAAkB,IAAI,EAAG,iBAAiB,CAAU;gBAIlD,OAAO,EAAE,YAAY,GAAG;QACtB,MAAM,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAC;QACvC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,EAAE,CAAC,EAAE,MAAM,CAAC;KACb;IAWH;;;;;OAKG;IACM,cAAc,IAAI,mBAAmB;CAU/C"}

package/esm/npm/src/errors/ValidationError.js

@@ -0,0 +1,77 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _ValidationError_normalizedErrors;
+import Type from "typebox";
+import { TrellisError } from "./TrellisError.js";
+function normalizeError(e) {
+    if ("schemaPath" in e) {
+        return { schemaPath: e.schemaPath, message: e.message ?? "Invalid value" };
+    }
+    return { schemaPath: e.path, message: e.message };
+}
+/**
+ * Schema for validation issue in ValidationError.
+ */
+export const ValidationIssueSchema = Type.Object({
+    path: Type.String(),
+    message: Type.String(),
+});
+/**
+ * Schema for ValidationError serialization.
+ */
+export const ValidationErrorDataSchema = Type.Object({
+    id: Type.String(),
+    type: Type.Literal("ValidationError"),
+    message: Type.String(),
+    issues: Type.Array(ValidationIssueSchema),
+    context: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
+    traceId: Type.Optional(Type.String()),
+});
+/**
+ * Error for data validation failures.
+ * Includes schema validation and missing required data.
+ */
+export class ValidationError extends TrellisError {
+    constructor(options) {
+        const { errors: rawErrors, ...baseOptions } = options;
+        const errors = [...rawErrors].map(normalizeError);
+        const msg = errors
+            .map((e) => `Validation failed. ${e.schemaPath}: ${e.message}.`)
+            .join("\n");
+        super(msg.length ? msg : "Data validation failed.", baseOptions);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "ValidationError"
+        });
+        _ValidationError_normalizedErrors.set(this, void 0);
+        __classPrivateFieldSet(this, _ValidationError_normalizedErrors, errors, "f");
+    }
+    /**
+     * Serializes error to a plain object.
+     * Transforms internal errors array to issues array for serialization.
+     *
+     * @returns Plain object representation of the error
+     */
+    toSerializable() {
+        return {
+            ...this.baseSerializable(),
+            type: this.name,
+            issues: __classPrivateFieldGet(this, _ValidationError_normalizedErrors, "f").map((e) => ({
+                path: e.schemaPath,
+                message: e.message,
+            })),
+        };
+    }
+}
+_ValidationError_normalizedErrors = new WeakMap();

package/esm/npm/src/errors/index.d.ts

@@ -0,0 +1,159 @@
+import "../_dnt.polyfills.js";
+import { type UnexpectedErrorData } from "@qlever-llc/result";
+import { AuthError } from "./AuthError.js";
+import type { AuthErrorData } from "./AuthError.js";
+import { ValidationError } from "./ValidationError.js";
+import type { ValidationErrorData } from "./ValidationError.js";
+import { RemoteError } from "./RemoteError.js";
+import { KVError } from "./KVError.js";
+import type { KVErrorData } from "./KVError.js";
+import { StoreError } from "./StoreError.js";
+import type { StoreErrorData } from "./StoreError.js";
+import { TransportError } from "./TransportError.js";
+import type { TransportErrorData } from "./TransportError.js";
+import { TransferError } from "./TransferError.js";
+import type { TransferErrorData } from "./TransferError.js";
+type RuntimeRpcErrorDesc = {
+    type: string;
+    schema?: unknown;
+    fromSerializable(data: unknown): Error;
+};
+export { UnexpectedError } from "@qlever-llc/result";
+export { TrellisError } from "./TrellisError.js";
+export { AuthError } from "./AuthError.js";
+export { ValidationError } from "./ValidationError.js";
+export { RemoteError } from "./RemoteError.js";
+export { KVError } from "./KVError.js";
+export { StoreError } from "./StoreError.js";
+export { TransportError } from "./TransportError.js";
+export { TransferError } from "./TransferError.js";
+export { type AuthErrorData, AuthErrorDataSchema } from "./AuthError.js";
+export { type ValidationErrorData, ValidationErrorDataSchema, type ValidationIssue, ValidationIssueSchema, } from "./ValidationError.js";
+export { type RemoteErrorData, RemoteErrorDataSchema } from "./RemoteError.js";
+export { type KVErrorData, KVErrorDataSchema } from "./KVError.js";
+export { type StoreErrorData, StoreErrorDataSchema } from "./StoreError.js";
+export { type TransportErrorData, TransportErrorDataSchema, } from "./TransportError.js";
+export { type TransferErrorData, TransferErrorDataSchema, } from "./TransferError.js";
+/**
+ * Single source of truth for all Trellis errors.
+ * This object is used for compile-time type inference.
+ */
+declare const TRANSPORTABLE_TRELLIS_ERRORS: {
+    readonly UnexpectedError: any;
+    readonly TransportError: typeof TransportError;
+    readonly AuthError: typeof AuthError;
+    readonly ValidationError: typeof ValidationError;
+    readonly KVError: typeof KVError;
+    readonly StoreError: typeof StoreError;
+    readonly TransferError: typeof TransferError;
+};
+declare const TRELLIS_ERRORS: {
+    readonly RemoteError: typeof RemoteError;
+    readonly UnexpectedError: any;
+    readonly TransportError: typeof TransportError;
+    readonly AuthError: typeof AuthError;
+    readonly ValidationError: typeof ValidationError;
+    readonly KVError: typeof KVError;
+    readonly StoreError: typeof StoreError;
+    readonly TransferError: typeof TransferError;
+};
+/**
+ * Compile-time mapping from error names to their instance types.
+ * Derived from TRELLIS_ERRORS to ensure types stay in sync with runtime.
+ */
+export type TrellisErrorMap = {
+    [K in keyof typeof TRELLIS_ERRORS]: InstanceType<(typeof TRELLIS_ERRORS)[K]>;
+};
+export type TransportableTrellisErrorMap = {
+    [K in keyof typeof TRANSPORTABLE_TRELLIS_ERRORS]: InstanceType<(typeof TRANSPORTABLE_TRELLIS_ERRORS)[K]>;
+};
+export type TrellisErrorName = keyof TransportableTrellisErrorMap;
+export type TrellisErrorInstance = TrellisErrorMap[TrellisErrorName];
+export type MapErrorNamesToTypes<T extends readonly TrellisErrorName[]> = {
+    [K in keyof T]: T[K] extends TrellisErrorName ? TransportableTrellisErrorMap[T[K]] : never;
+}[number];
+export declare const BUILTIN_RPC_ERRORS: {
+    readonly UnexpectedError: {
+        readonly type: "UnexpectedError";
+        readonly schema: import("../contracts.js").Schema<UnexpectedErrorData>;
+        readonly fromSerializable: (data: UnexpectedErrorData) => any;
+    };
+    readonly AuthError: {
+        readonly type: "AuthError";
+        readonly schema: import("../contracts.js").Schema<{
+            context?: Record<string, unknown> | undefined;
+            traceId?: string | undefined;
+            type: "AuthError";
+            id: string;
+            reason: "invalid_request" | "missing_session_key" | "missing_proof" | "session_not_found" | "session_expired" | "invalid_signature" | "user_not_found" | "user_inactive" | "unknown_device" | "device_deployment_not_found" | "device_deployment_disabled" | "device_activation_revoked" | "unknown_service" | "service_disabled" | "iat_out_of_range" | "invalid_binding_token" | "session_corrupted" | "session_already_bound" | "authtoken_already_used" | "oauth_session_key_mismatch" | "service_role_on_user" | "reply_subject_mismatch" | "insufficient_permissions" | "forbidden" | "missing_flow_id" | "device_activation_flow_not_found" | "device_activation_flow_expired" | "device_activation_rejected" | "device_identity_key_mismatch" | "invalid_device_qr_mac";
+            message: string;
+        }>;
+        readonly fromSerializable: (data: AuthErrorData) => AuthError;
+    };
+    readonly TransportError: {
+        readonly type: "TransportError";
+        readonly schema: import("../contracts.js").Schema<{
+            context?: Record<string, unknown> | undefined;
+            traceId?: string | undefined;
+            type: "TransportError";
+            id: string;
+            message: string;
+            code: string;
+            hint: string;
+        }>;
+        readonly fromSerializable: (data: TransportErrorData) => TransportError;
+    };
+    readonly ValidationError: {
+        readonly type: "ValidationError";
+        readonly schema: import("../contracts.js").Schema<{
+            context?: Record<string, unknown> | undefined;
+            traceId?: string | undefined;
+            type: "ValidationError";
+            id: string;
+            message: string;
+            issues: {
+                message: string;
+                path: string;
+            }[];
+        }>;
+        readonly fromSerializable: (data: ValidationErrorData) => ValidationError;
+    };
+    readonly KVError: {
+        readonly type: "KVError";
+        readonly schema: import("../contracts.js").Schema<{
+            context?: Record<string, unknown> | undefined;
+            traceId?: string | undefined;
+            operation?: string | undefined;
+            type: "KVError";
+            id: string;
+            message: string;
+        }>;
+        readonly fromSerializable: (data: KVErrorData) => KVError;
+    };
+    readonly StoreError: {
+        readonly type: "StoreError";
+        readonly schema: import("../contracts.js").Schema<{
+            context?: Record<string, unknown> | undefined;
+            traceId?: string | undefined;
+            operation?: string | undefined;
+            type: "StoreError";
+            id: string;
+            message: string;
+        }>;
+        readonly fromSerializable: (data: StoreErrorData) => StoreError;
+    };
+    readonly TransferError: {
+        readonly type: "TransferError";
+        readonly schema: import("../contracts.js").Schema<{
+            context?: Record<string, unknown> | undefined;
+            traceId?: string | undefined;
+            operation?: string | undefined;
+            type: "TransferError";
+            id: string;
+            message: string;
+        }>;
+        readonly fromSerializable: (data: TransferErrorData) => TransferError;
+    };
+};
+export declare function getBuiltinRpcError(type: string): RuntimeRpcErrorDesc | undefined;
+//# sourceMappingURL=index.d.ts.map

package/esm/npm/src/errors/index.d.ts.map

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