@qlever-llc/trellis 0.5.1

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@qlever-llc/trellis",
+  "version": "0.5.1",
+  "description": "Client-side Trellis runtime, models, and contract helpers for TypeScript applications.",
+  "homepage": "https://github.com/Qlever-LLC/trellis#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Qlever-LLC/trellis"
+  },
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/Qlever-LLC/trellis/issues"
+  },
+  "main": "./script/trellis/index.js",
+  "module": "./esm/trellis/index.js",
+  "exports": {
+    ".": {
+      "import": "./esm/trellis/index.js",
+      "require": "./script/trellis/index.js"
+    },
+    "./browser": {
+      "import": "./esm/trellis/browser.js",
+      "require": "./script/trellis/browser.js"
+    },
+    "./tracing": {
+      "import": "./esm/trellis/tracing.js",
+      "require": "./script/trellis/tracing.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@nats-io/jetstream": "^3.3.0",
+    "@nats-io/kv": "^3.2.0",
+    "@nats-io/nats-core": "^3.3.1",
+    "pino": "^9.11.0",
+    "ts-deepmerge": "^7.0.3",
+    "typebox": "^1.0.15",
+    "ulid": "^3.0.1",
+    "@qlever-llc/trellis-contracts": "^0.5.1",
+    "@qlever-llc/trellis-result": "^0.5.1",
+    "@qlever-llc/trellis-telemetry": "^0.5.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.9.0"
+  },
+  "_generatedBy": "dnt@dev"
+}

package/script/_dnt.polyfills.d.ts

@@ -0,0 +1,7 @@
+declare global {
+    interface Error {
+        cause?: unknown;
+    }
+}
+export {};
+//# sourceMappingURL=_dnt.polyfills.d.ts.map

package/script/_dnt.polyfills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.polyfills.d.ts","sourceRoot":"","sources":["../src/_dnt.polyfills.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,KAAK;QACb,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CACF;AAED,OAAO,EAAE,CAAC"}

package/script/_dnt.polyfills.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/script/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/script/trellis/browser.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Browser-safe exports for @qlever-llc/trellis
+ */
+import "../_dnt.polyfills.js";
+export { Trellis } from "./trellis.js";
+export type { TrellisAuth } from "./trellis.js";
+export { TypedKV, TypedKVEntry } from "./kv.js";
+export type { WatchEvent, WatchOptions } from "./kv.js";
+export { AuthError, KVError, RemoteError, UnexpectedError, ValidationError, } from "./errors/index.js";
+export type { TrellisErrorInstance } from "./errors/index.js";
+//# sourceMappingURL=browser.d.ts.map

package/script/trellis/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/trellis/browser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,sBAAsB,CAAC;AAE9B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGxD,OAAO,EACL,SAAS,EACT,OAAO,EACP,WAAW,EACX,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/script/trellis/browser.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Browser-safe exports for @qlever-llc/trellis
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationError = exports.UnexpectedError = exports.RemoteError = exports.KVError = exports.AuthError = exports.TypedKVEntry = exports.TypedKV = exports.Trellis = void 0;
+// Core Trellis client class (browser-safe)
+require("../_dnt.polyfills.js");
+var trellis_js_1 = require("./trellis.js");
+Object.defineProperty(exports, "Trellis", { enumerable: true, get: function () { return trellis_js_1.Trellis; } });
+// KV utilities (browser-safe)
+var kv_js_1 = require("./kv.js");
+Object.defineProperty(exports, "TypedKV", { enumerable: true, get: function () { return kv_js_1.TypedKV; } });
+Object.defineProperty(exports, "TypedKVEntry", { enumerable: true, get: function () { return kv_js_1.TypedKVEntry; } });
+// Error types (browser-safe)
+var index_js_1 = require("./errors/index.js");
+Object.defineProperty(exports, "AuthError", { enumerable: true, get: function () { return index_js_1.AuthError; } });
+Object.defineProperty(exports, "KVError", { enumerable: true, get: function () { return index_js_1.KVError; } });
+Object.defineProperty(exports, "RemoteError", { enumerable: true, get: function () { return index_js_1.RemoteError; } });
+Object.defineProperty(exports, "UnexpectedError", { enumerable: true, get: function () { return index_js_1.UnexpectedError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return index_js_1.ValidationError; } });

package/script/trellis/client.d.ts

@@ -0,0 +1,31 @@
+import type { NatsConnection } from "@nats-io/nats-core";
+import type { TrellisAPI } from "@qlever-llc/trellis-contracts";
+import type { Logger } from "pino";
+import type { TrellisAuth } from "./trellis.js";
+import { Trellis } from "./trellis.js";
+type NoResponderRetryOpts = {
+    maxAttempts?: number;
+    baseDelayMs?: number;
+};
+export type ClientOpts = {
+    /**
+     * Logical name for this client instance (used for logs and consumer names).
+     * Defaults to "client".
+     */
+    name?: string;
+    log?: Logger;
+    timeout?: number;
+    stream?: string;
+    noResponderRetry?: NoResponderRetryOpts;
+};
+type ClientContract<TApi> = {
+    API: {
+        trellis: TApi;
+    };
+};
+/**
+ * Create a Trellis client typed from a contract module's derived outbound surface.
+ */
+export declare function createClient<TApi extends TrellisAPI>(contract: ClientContract<TApi>, nats: NatsConnection, auth: TrellisAuth, opts?: ClientOpts): Trellis<TApi>;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/script/trellis/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/trellis/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,KAAK,oBAAoB,GAAG;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;CACzC,CAAC;AAEF,KAAK,cAAc,CAAC,IAAI,IAAI;IAC1B,GAAG,EAAE;QACH,OAAO,EAAE,IAAI,CAAC;KACf,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,SAAS,UAAU,EAClD,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,EAC9B,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,WAAW,EACjB,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/script/trellis/client.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createClient = createClient;
+const trellis_js_1 = require("./trellis.js");
+/**
+ * Create a Trellis client typed from a contract module's derived outbound surface.
+ */
+function createClient(contract, nats, auth, opts) {
+    return new trellis_js_1.Trellis(opts?.name ?? "client", nats, auth, {
+        log: opts?.log,
+        timeout: opts?.timeout,
+        stream: opts?.stream,
+        noResponderRetry: opts?.noResponderRetry,
+        api: contract.API.trellis,
+    });
+}

package/script/trellis/codec.d.ts

@@ -0,0 +1,12 @@
+import { type InferSchemaType, type SchemaLike } from "@qlever-llc/trellis-contracts";
+import { Result } from "@qlever-llc/trellis-result";
+import type { StaticDecode, TSchema } from "typebox";
+import { UnexpectedError, ValidationError } from "./errors/index.js";
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export declare function parse<T extends TSchema>(schema: T, data: JsonValue): Result<StaticDecode<T>, ValidationError | UnexpectedError>;
+export declare function parseSchema<S extends SchemaLike>(schema: S, data: JsonValue): Result<InferSchemaType<S>, ValidationError | UnexpectedError>;
+export declare function encode<T extends TSchema>(schema: T, data: unknown): Result<string, ValidationError | UnexpectedError>;
+export declare function encodeSchema<S extends SchemaLike>(schema: S, data: unknown): Result<string, ValidationError | UnexpectedError>;
+//# sourceMappingURL=codec.d.ts.map

package/script/trellis/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../src/trellis/codec.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,UAAU,EAEhB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAErD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAErE,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IACA,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,CAAC;AAUJ,wBAAgB,KAAK,CAAC,CAAC,SAAS,OAAO,EACrC,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,SAAS,GACd,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,eAAe,GAAG,eAAe,CAAC,CAU5D;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,UAAU,EAC9C,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,SAAS,GACd,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,GAAG,eAAe,CAAC,CAW/D;AAED,wBAAgB,MAAM,CAAC,CAAC,SAAS,OAAO,EACtC,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,OAAO,GACZ,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAAC,CAUnD;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,UAAU,EAC/C,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,OAAO,GACZ,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAAC,CAWnD"}

package/script/trellis/codec.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parse = parse;
+exports.parseSchema = parseSchema;
+exports.encode = encode;
+exports.encodeSchema = encodeSchema;
+const trellis_contracts_1 = require("@qlever-llc/trellis-contracts");
+const trellis_result_1 = require("@qlever-llc/trellis-result");
+const value_1 = require("typebox/value");
+const index_js_1 = require("./errors/index.js");
+function parseWithSchema(schema, data) {
+    return value_1.Value.Parse(schema, data);
+}
+function encodeWithSchema(schema, data) {
+    return JSON.stringify(value_1.Value.Encode(schema, data));
+}
+function parse(schema, data) {
+    try {
+        return trellis_result_1.Result.ok(parseWithSchema(schema, data));
+    }
+    catch (cause) {
+        if (cause instanceof value_1.ParseError) {
+            const errors = value_1.Value.Errors(schema, data);
+            return trellis_result_1.Result.err(new index_js_1.ValidationError({ errors, cause }));
+        }
+        return trellis_result_1.Result.err(new index_js_1.UnexpectedError({ cause }));
+    }
+}
+function parseSchema(schema, data) {
+    const raw = (0, trellis_contracts_1.unwrapSchema)(schema);
+    try {
+        return trellis_result_1.Result.ok(parseWithSchema(raw, data));
+    }
+    catch (cause) {
+        if (cause instanceof value_1.ParseError) {
+            const errors = value_1.Value.Errors(raw, data);
+            return trellis_result_1.Result.err(new index_js_1.ValidationError({ errors, cause }));
+        }
+        return trellis_result_1.Result.err(new index_js_1.UnexpectedError({ cause }));
+    }
+}
+function encode(schema, data) {
+    try {
+        return trellis_result_1.Result.ok(encodeWithSchema(schema, data));
+    }
+    catch (cause) {
+        if (cause instanceof value_1.EncodeError) {
+            const errors = value_1.Value.Errors(schema, data);
+            return trellis_result_1.Result.err(new index_js_1.ValidationError({ errors, cause }));
+        }
+        return trellis_result_1.Result.err(new index_js_1.UnexpectedError({ cause }));
+    }
+}
+function encodeSchema(schema, data) {
+    const raw = (0, trellis_contracts_1.unwrapSchema)(schema);
+    try {
+        return trellis_result_1.Result.ok(encodeWithSchema(raw, data));
+    }
+    catch (cause) {
+        if (cause instanceof value_1.EncodeError) {
+            const errors = value_1.Value.Errors(raw, data);
+            return trellis_result_1.Result.err(new index_js_1.ValidationError({ errors, cause }));
+        }
+        return trellis_result_1.Result.err(new index_js_1.UnexpectedError({ cause }));
+    }
+}

package/script/trellis/env.d.ts

@@ -0,0 +1,2 @@
+export { getEnv } from "@qlever-llc/trellis-telemetry";
+//# sourceMappingURL=env.d.ts.map

package/script/trellis/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/trellis/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC"}

package/script/trellis/env.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEnv = void 0;
+var trellis_telemetry_1 = require("@qlever-llc/trellis-telemetry");
+Object.defineProperty(exports, "getEnv", { enumerable: true, get: function () { return trellis_telemetry_1.getEnv; } });

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

@@ -0,0 +1,30 @@
+import Type, { type Static } from "typebox";
+import { TrellisError } from "./TrellisError.js";
+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_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">]>;
+    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/trellis/errors/AuthError.d.ts.map

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

@@ -0,0 +1,72 @@
+"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_js_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_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"),
+    ]),
+    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_js_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/trellis/errors/KVError.d.ts

@@ -0,0 +1,31 @@
+import Type, { type Static } from "typebox";
+import { TrellisError } from "./TrellisError.js";
+export declare const KVErrorDataSchema: Type.TObject<{
+    id: Type.TString;
+    type: Type.TLiteral<"KVError">;
+    message: Type.TString;
+    operation: Type.TOptional<Type.TString>;
+    context: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+    traceId: Type.TOptional<Type.TString>;
+}>;
+export type KVErrorData = Static<typeof KVErrorDataSchema>;
+/**
+ * Error for KV storage operations.
+ * Used when key-value store operations fail.
+ */
+export declare class KVError extends TrellisError<KVErrorData> {
+    readonly name: "KVError";
+    readonly operation?: string;
+    constructor(options: ErrorOptions & {
+        operation?: string;
+        context?: Record<string, unknown>;
+        id?: string;
+    });
+    /**
+     * Serializes error to a plain object.
+     *
+     * @returns Plain object representation of the error
+     */
+    toSerializable(): KVErrorData;
+}
+//# sourceMappingURL=KVError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KVError.d.ts","sourceRoot":"","sources":["../../../src/trellis/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/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_js_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_js_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/trellis/errors/RemoteError.d.ts

@@ -0,0 +1,47 @@
+import { Result, UnexpectedError } from "@qlever-llc/trellis-result";
+import Type, { type Static } from "typebox";
+import { ValidationError } from "./ValidationError.js";
+import { TrellisError } from "./TrellisError.js";
+import type { TrellisErrorData } from "../models/trellis/TrellisError.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>;
+/**
+ * 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: TrellisErrorData;
+    constructor(options: ErrorOptions & {
+        error: TrellisErrorData;
+        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<TrellisErrorData, 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/trellis/errors/RemoteError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteError.d.ts","sourceRoot":"","sources":["../../../src/trellis/errors/RemoteError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,IAAI,EAAE,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAG1E,eAAO,MAAM,qBAAqB;;;;;;;EAOhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEnE;;;GAGG;AACH,qBAAa,WAAY,SAAQ,YAAY,CAAC,eAAe,CAAC;IAC5D,SAAkB,IAAI,gBAA0B;IAChD,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;gBAGrC,OAAO,EAAE,YAAY,GAAG;QACtB,KAAK,EAAE,gBAAgB,CAAC;QACxB,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,gBAAgB,EAAE,eAAe,GAAG,eAAe,CAAC;IAqB9D;;;OAGG;IACH,MAAM,CAAC,SAAS,2BAAqB;CACtC"}

package/script/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 trellis_result_1 = require("@qlever-llc/trellis-result");
+const typebox_1 = __importDefault(require("typebox"));
+const value_1 = require("typebox/value");
+const ValidationError_js_1 = require("./ValidationError.js");
+const TrellisError_js_1 = require("./TrellisError.js");
+const TrellisError_js_2 = require("../models/trellis/TrellisError.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_js_1.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 trellis_result_1.Result.try(() => typeof data === "string" ? JSON.parse(data) : data).andThen((obj) => {
+            const parseResult = trellis_result_1.Result.try(() => value_1.Value.Parse(TrellisError_js_2.TrellisErrorDataSchema, obj));
+            if (parseResult.isErr()) {
+                const cause = parseResult.error.cause;
+                if (cause instanceof value_1.ParseError) {
+                    const errors = value_1.Value.Errors(TrellisError_js_2.TrellisErrorDataSchema, obj);
+                    return trellis_result_1.Result.err(new ValidationError_js_1.ValidationError({ errors, cause }));
+                }
+                return trellis_result_1.Result.err(parseResult.error);
+            }
+            return trellis_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/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/trellis-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/trellis/errors/TrellisError.d.ts.map

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

package/script/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 mod_js_1 = require("@qlever-llc/trellis-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 mod_js_1.BaseError {
+}
+exports.TrellisError = TrellisError;