@qlever-llc/trellis 0.7.0-rc.5 → 0.7.0

package/script/js/packages/trellis/errors/AuthError.d.ts

@@ -0,0 +1,30 @@
+import Type, { type Static } from "typebox";
+import { TrellisError } from "./TrellisError.ts";
+export declare const AuthErrorDataSchema: Type.TObject<{
+    id: Type.TString;
+    type: Type.TLiteral<"AuthError">;
+    message: Type.TString;
+    reason: Type.TUnion<[Type.TLiteral<"invalid_request">, Type.TLiteral<"missing_session_key">, Type.TLiteral<"missing_proof">, Type.TLiteral<"session_not_found">, Type.TLiteral<"session_expired">, Type.TLiteral<"invalid_signature">, Type.TLiteral<"user_not_found">, Type.TLiteral<"user_inactive">, Type.TLiteral<"unknown_device">, Type.TLiteral<"device_profile_not_found">, Type.TLiteral<"device_profile_disabled">, Type.TLiteral<"device_activation_revoked">, Type.TLiteral<"unknown_service">, Type.TLiteral<"service_disabled">, Type.TLiteral<"iat_out_of_range">, Type.TLiteral<"invalid_binding_token">, Type.TLiteral<"session_corrupted">, Type.TLiteral<"session_already_bound">, Type.TLiteral<"authtoken_already_used">, Type.TLiteral<"oauth_session_key_mismatch">, Type.TLiteral<"service_role_on_user">, Type.TLiteral<"reply_subject_mismatch">, Type.TLiteral<"insufficient_permissions">, Type.TLiteral<"forbidden">, Type.TLiteral<"missing_flow_id">, Type.TLiteral<"missing_profile_id">, Type.TLiteral<"device_activation_flow_not_found">, Type.TLiteral<"device_activation_flow_expired">, Type.TLiteral<"device_activation_rejected">, Type.TLiteral<"device_identity_key_mismatch">, Type.TLiteral<"invalid_device_qr_mac">]>;
+    context: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+    traceId: Type.TOptional<Type.TString>;
+}>;
+export type AuthErrorData = Static<typeof AuthErrorDataSchema>;
+/**
+ * Error for authentication and authorization failures.
+ */
+export declare class AuthError extends TrellisError<AuthErrorData> {
+    readonly name: "AuthError";
+    readonly reason: AuthErrorData["reason"];
+    constructor(options: ErrorOptions & {
+        reason: AuthErrorData["reason"];
+        context?: Record<string, unknown>;
+        id?: string;
+    });
+    /**
+     * Serializes error to a plain object.
+     *
+     * @returns Plain object representation of the error
+     */
+    toSerializable(): AuthErrorData;
+}
+//# sourceMappingURL=AuthError.d.ts.map

package/script/js/packages/trellis/errors/AuthError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthError.d.ts","sourceRoot":"","sources":["../../../../../../errors/AuthError.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,mBAAmB;;;;;;;EAuC9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAE/D;;GAEG;AACH,qBAAa,SAAU,SAAQ,YAAY,CAAC,aAAa,CAAC;IACxD,SAAkB,IAAI,cAAwB;IAC9C,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;gBAGvC,OAAO,EAAE,YAAY,GAAG;QACtB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;QAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,EAAE,CAAC,EAAE,MAAM,CAAC;KACb;IAOH;;;;OAIG;IACM,cAAc,IAAI,aAAa;CAOzC"}

package/script/js/packages/trellis/errors/AuthError.js

@@ -0,0 +1,83 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthError = exports.AuthErrorDataSchema = void 0;
+const typebox_1 = __importDefault(require("typebox"));
+const TrellisError_ts_1 = require("./TrellisError.js");
+exports.AuthErrorDataSchema = typebox_1.default.Object({
+    id: typebox_1.default.String(),
+    type: typebox_1.default.Literal("AuthError"),
+    message: typebox_1.default.String(),
+    reason: typebox_1.default.Union([
+        typebox_1.default.Literal("invalid_request"),
+        typebox_1.default.Literal("missing_session_key"),
+        typebox_1.default.Literal("missing_proof"),
+        typebox_1.default.Literal("session_not_found"),
+        typebox_1.default.Literal("session_expired"),
+        typebox_1.default.Literal("invalid_signature"),
+        typebox_1.default.Literal("user_not_found"),
+        typebox_1.default.Literal("user_inactive"),
+        typebox_1.default.Literal("unknown_device"),
+        typebox_1.default.Literal("device_profile_not_found"),
+        typebox_1.default.Literal("device_profile_disabled"),
+        typebox_1.default.Literal("device_activation_revoked"),
+        typebox_1.default.Literal("unknown_service"),
+        typebox_1.default.Literal("service_disabled"),
+        typebox_1.default.Literal("iat_out_of_range"),
+        typebox_1.default.Literal("invalid_binding_token"),
+        typebox_1.default.Literal("session_corrupted"),
+        typebox_1.default.Literal("session_already_bound"),
+        typebox_1.default.Literal("authtoken_already_used"),
+        typebox_1.default.Literal("oauth_session_key_mismatch"),
+        typebox_1.default.Literal("service_role_on_user"),
+        typebox_1.default.Literal("reply_subject_mismatch"),
+        typebox_1.default.Literal("insufficient_permissions"),
+        typebox_1.default.Literal("forbidden"),
+        typebox_1.default.Literal("missing_flow_id"),
+        typebox_1.default.Literal("missing_profile_id"),
+        typebox_1.default.Literal("device_activation_flow_not_found"),
+        typebox_1.default.Literal("device_activation_flow_expired"),
+        typebox_1.default.Literal("device_activation_rejected"),
+        typebox_1.default.Literal("device_identity_key_mismatch"),
+        typebox_1.default.Literal("invalid_device_qr_mac"),
+    ]),
+    context: typebox_1.default.Optional(typebox_1.default.Record(typebox_1.default.String(), typebox_1.default.Unknown())),
+    traceId: typebox_1.default.Optional(typebox_1.default.String()),
+});
+/**
+ * Error for authentication and authorization failures.
+ */
+class AuthError extends TrellisError_ts_1.TrellisError {
+    constructor(options) {
+        const { reason, ...baseOptions } = options;
+        super(`Auth failed: ${reason}`, baseOptions);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "AuthError"
+        });
+        Object.defineProperty(this, "reason", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.reason = reason;
+    }
+    /**
+     * Serializes error to a plain object.
+     *
+     * @returns Plain object representation of the error
+     */
+    toSerializable() {
+        return {
+            ...this.baseSerializable(),
+            type: this.name,
+            reason: this.reason,
+        };
+    }
+}
+exports.AuthError = AuthError;

package/script/js/packages/trellis/errors/KVError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KVError.d.ts","sourceRoot":"","sources":["../../../../../../errors/KVError.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,iBAAiB;;;;;;;EAO5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE3D;;;GAGG;AACH,qBAAa,OAAQ,SAAQ,YAAY,CAAC,WAAW,CAAC;IACpD,SAAkB,IAAI,YAAsB;IAC5C,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;IAQH;;;;OAIG;IACM,cAAc,IAAI,WAAW;CAOvC"}

package/script/js/packages/trellis/errors/KVError.js

@@ -0,0 +1,53 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KVError = exports.KVErrorDataSchema = void 0;
+const typebox_1 = __importDefault(require("typebox"));
+const TrellisError_ts_1 = require("./TrellisError.js");
+exports.KVErrorDataSchema = typebox_1.default.Object({
+    id: typebox_1.default.String(),
+    type: typebox_1.default.Literal("KVError"),
+    message: typebox_1.default.String(),
+    operation: typebox_1.default.Optional(typebox_1.default.String()),
+    context: typebox_1.default.Optional(typebox_1.default.Record(typebox_1.default.String(), typebox_1.default.Unknown())),
+    traceId: typebox_1.default.Optional(typebox_1.default.String()),
+});
+/**
+ * Error for KV storage operations.
+ * Used when key-value store operations fail.
+ */
+class KVError extends TrellisError_ts_1.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,
+        };
+    }
+}
+exports.KVError = KVError;

package/script/js/packages/trellis/errors/RemoteError.d.ts

@@ -0,0 +1,53 @@
+import { Result, type UnexpectedError, type UnexpectedErrorData } from "@qlever-llc/result";
+import Type, { type Static } from "typebox";
+import type { AuthErrorData } from "./AuthError.ts";
+import type { KVErrorData } from "./KVError.ts";
+import type { StoreErrorData } from "./StoreError.ts";
+import type { TrellisErrorData } from "../models/trellis/TrellisError.ts";
+import type { TransferErrorData } from "./TransferError.ts";
+import { TrellisError } from "./TrellisError.ts";
+import { ValidationError } from "./ValidationError.ts";
+import type { ValidationErrorData } from "./ValidationError.ts";
+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 | 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/script/js/packages/trellis/errors/RemoteError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteError.d.ts","sourceRoot":"","sources":["../../../../../../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,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,iBAAiB,GACjB,gBAAgB,CAAC;AAErB;;;GAGG;AACH,qBAAa,WAAY,SAAQ,YAAY,CAAC,eAAe,CAAC;IAC5D,SAAkB,IAAI,gBAA0B;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;IAqB3E;;;OAGG;IACH,MAAM,CAAC,SAAS,2BAAqB;CACtC"}

package/script/js/packages/trellis/errors/RemoteError.js

@@ -0,0 +1,87 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemoteError = exports.RemoteErrorDataSchema = void 0;
+const result_1 = require("@qlever-llc/result");
+const typebox_1 = __importDefault(require("typebox"));
+const value_1 = require("typebox/value");
+const TrellisError_ts_1 = require("../models/trellis/TrellisError.js");
+const TrellisError_ts_2 = require("./TrellisError.js");
+const ValidationError_ts_1 = require("./ValidationError.js");
+exports.RemoteErrorDataSchema = typebox_1.default.Object({
+    id: typebox_1.default.String(),
+    type: typebox_1.default.Literal("RemoteError"),
+    message: typebox_1.default.String(),
+    remoteError: typebox_1.default.Any(),
+    context: typebox_1.default.Optional(typebox_1.default.Record(typebox_1.default.String(), typebox_1.default.Unknown())),
+    traceId: typebox_1.default.Optional(typebox_1.default.String()),
+});
+/**
+ * Error for wrapping errors received from remote Trellis services.
+ * This is the only error type with parseJSON/parseObject methods for deserializing remote errors.
+ */
+class RemoteError extends TrellisError_ts_2.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_1.Result.try(() => typeof data === "string" ? JSON.parse(data) : data).andThen((obj) => {
+            const parseResult = result_1.Result.try(() => value_1.Value.Parse(TrellisError_ts_1.TrellisErrorDataSchema, obj));
+            if (parseResult.isErr()) {
+                const cause = parseResult.error.cause;
+                if (cause instanceof value_1.ParseError) {
+                    const errors = value_1.Value.Errors(TrellisError_ts_1.TrellisErrorDataSchema, obj);
+                    return result_1.Result.err(new ValidationError_ts_1.ValidationError({ errors, cause }));
+                }
+                return result_1.Result.err(parseResult.error);
+            }
+            return result_1.Result.ok(parseResult.take());
+        });
+    }
+}
+exports.RemoteError = RemoteError;
+/**
+ * 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/script/js/packages/trellis/errors/StoreError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StoreError.d.ts","sourceRoot":"","sources":["../../../../../../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,eAAyB;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/script/js/packages/trellis/errors/StoreError.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StoreError = exports.StoreErrorDataSchema = void 0;
+const typebox_1 = __importDefault(require("typebox"));
+const TrellisError_ts_1 = require("./TrellisError.js");
+exports.StoreErrorDataSchema = typebox_1.default.Object({
+    id: typebox_1.default.String(),
+    type: typebox_1.default.Literal("StoreError"),
+    message: typebox_1.default.String(),
+    operation: typebox_1.default.Optional(typebox_1.default.String()),
+    context: typebox_1.default.Optional(typebox_1.default.Record(typebox_1.default.String(), typebox_1.default.Unknown())),
+    traceId: typebox_1.default.Optional(typebox_1.default.String()),
+});
+class StoreError extends TrellisError_ts_1.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 } : {}),
+        };
+    }
+}
+exports.StoreError = StoreError;

package/script/js/packages/trellis/errors/TransferError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransferError.d.ts","sourceRoot":"","sources":["../../../../../../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,kBAA4B;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/script/js/packages/trellis/errors/TransferError.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransferError = exports.TransferErrorDataSchema = void 0;
+const typebox_1 = __importDefault(require("typebox"));
+const TrellisError_ts_1 = require("./TrellisError.js");
+exports.TransferErrorDataSchema = typebox_1.default.Object({
+    id: typebox_1.default.String(),
+    type: typebox_1.default.Literal("TransferError"),
+    message: typebox_1.default.String(),
+    operation: typebox_1.default.Optional(typebox_1.default.String()),
+    context: typebox_1.default.Optional(typebox_1.default.Record(typebox_1.default.String(), typebox_1.default.Unknown())),
+    traceId: typebox_1.default.Optional(typebox_1.default.String()),
+});
+class TransferError extends TrellisError_ts_1.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 } : {}),
+        };
+    }
+}
+exports.TransferError = TransferError;

package/script/js/packages/trellis/errors/TrellisError.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Base class for all Trellis-specific errors.
+ * Extends BaseError and relies on the traceId getter being configured via initTracing.
+ */
+import { BaseError, type BaseErrorSchema } 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 declare abstract class TrellisError<TData extends BaseErrorSchema = BaseErrorSchema> extends BaseError<TData> {
+}
+//# sourceMappingURL=TrellisError.d.ts.map

package/script/js/packages/trellis/errors/TrellisError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrellisError.d.ts","sourceRoot":"","sources":["../../../../../../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/script/js/packages/trellis/errors/TrellisError.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TrellisError = void 0;
+/**
+ * Base class for all Trellis-specific errors.
+ * Extends BaseError and relies on the traceId getter being configured via initTracing.
+ */
+const result_1 = require("@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.
+ */
+class TrellisError extends result_1.BaseError {
+}
+exports.TrellisError = TrellisError;

package/script/js/packages/trellis/errors/ValidationError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationError.d.ts","sourceRoot":"","sources":["../../../../../../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,oBAA8B;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/script/js/packages/trellis/errors/ValidationError.js

@@ -0,0 +1,84 @@
+"use strict";
+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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var _ValidationError_normalizedErrors;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationError = exports.ValidationErrorDataSchema = exports.ValidationIssueSchema = void 0;
+const typebox_1 = __importDefault(require("typebox"));
+const TrellisError_ts_1 = require("./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.
+ */
+exports.ValidationIssueSchema = typebox_1.default.Object({
+    path: typebox_1.default.String(),
+    message: typebox_1.default.String(),
+});
+/**
+ * Schema for ValidationError serialization.
+ */
+exports.ValidationErrorDataSchema = typebox_1.default.Object({
+    id: typebox_1.default.String(),
+    type: typebox_1.default.Literal("ValidationError"),
+    message: typebox_1.default.String(),
+    issues: typebox_1.default.Array(exports.ValidationIssueSchema),
+    context: typebox_1.default.Optional(typebox_1.default.Record(typebox_1.default.String(), typebox_1.default.Unknown())),
+    traceId: typebox_1.default.Optional(typebox_1.default.String()),
+});
+/**
+ * Error for data validation failures.
+ * Includes schema validation and missing required data.
+ */
+class ValidationError extends TrellisError_ts_1.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,
+            })),
+        };
+    }
+}
+exports.ValidationError = ValidationError;
+_ValidationError_normalizedErrors = new WeakMap();