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

package/esm/errors/AuthError.js

@@ -0,0 +1,76 @@
+import Type from "typebox";
+import { TrellisError } from "./TrellisError.js";
+export const AuthErrorDataSchema = Type.Object({
+    id: Type.String(),
+    type: Type.Literal("AuthError"),
+    message: Type.String(),
+    reason: Type.Union([
+        Type.Literal("invalid_request"),
+        Type.Literal("missing_session_key"),
+        Type.Literal("missing_proof"),
+        Type.Literal("session_not_found"),
+        Type.Literal("session_expired"),
+        Type.Literal("invalid_signature"),
+        Type.Literal("user_not_found"),
+        Type.Literal("user_inactive"),
+        Type.Literal("unknown_device"),
+        Type.Literal("device_profile_not_found"),
+        Type.Literal("device_profile_disabled"),
+        Type.Literal("device_activation_revoked"),
+        Type.Literal("unknown_service"),
+        Type.Literal("service_disabled"),
+        Type.Literal("iat_out_of_range"),
+        Type.Literal("invalid_binding_token"),
+        Type.Literal("session_corrupted"),
+        Type.Literal("session_already_bound"),
+        Type.Literal("authtoken_already_used"),
+        Type.Literal("oauth_session_key_mismatch"),
+        Type.Literal("service_role_on_user"),
+        Type.Literal("reply_subject_mismatch"),
+        Type.Literal("insufficient_permissions"),
+        Type.Literal("forbidden"),
+        Type.Literal("missing_flow_id"),
+        Type.Literal("missing_profile_id"),
+        Type.Literal("device_activation_flow_not_found"),
+        Type.Literal("device_activation_flow_expired"),
+        Type.Literal("device_activation_rejected"),
+        Type.Literal("device_identity_key_mismatch"),
+        Type.Literal("invalid_device_qr_mac"),
+    ]),
+    context: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
+    traceId: Type.Optional(Type.String()),
+});
+/**
+ * Error for authentication and authorization failures.
+ */
+export class AuthError extends 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,
+        };
+    }
+}

package/esm/errors/KVError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KVError.d.ts","sourceRoot":"","sources":["../../src/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/esm/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.js";
+import type { KVErrorData } from "./KVError.js";
+import type { StoreErrorData } from "./StoreError.js";
+import type { TrellisErrorData } from "../models/trellis/TrellisError.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 | 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/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,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/esm/errors/RemoteError.js

@@ -0,0 +1,80 @@
+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/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,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/esm/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,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/esm/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/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,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/esm/errors/index.d.ts

@@ -0,0 +1,178 @@
+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 { 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 { 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 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 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 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("../contract_support/runtime.js").Schema<UnexpectedErrorData>;
+        readonly fromSerializable: (data: UnexpectedErrorData) => any;
+    };
+    readonly AuthError: {
+        readonly type: "AuthError";
+        readonly schema: import("../contract_support/runtime.js").Schema<{
+            context?: import("typebox").StaticRecord<[], "Encode", {}, {
+                id: import("typebox").TString;
+                type: import("typebox").TLiteral<"AuthError">;
+                message: import("typebox").TString;
+                reason: import("typebox").TUnion<[import("typebox").TLiteral<"invalid_request">, import("typebox").TLiteral<"missing_session_key">, import("typebox").TLiteral<"missing_proof">, import("typebox").TLiteral<"session_not_found">, import("typebox").TLiteral<"session_expired">, import("typebox").TLiteral<"invalid_signature">, import("typebox").TLiteral<"user_not_found">, import("typebox").TLiteral<"user_inactive">, import("typebox").TLiteral<"unknown_device">, import("typebox").TLiteral<"device_profile_not_found">, import("typebox").TLiteral<"device_profile_disabled">, import("typebox").TLiteral<"device_activation_revoked">, import("typebox").TLiteral<"unknown_service">, import("typebox").TLiteral<"service_disabled">, import("typebox").TLiteral<"iat_out_of_range">, import("typebox").TLiteral<"invalid_binding_token">, import("typebox").TLiteral<"session_corrupted">, import("typebox").TLiteral<"session_already_bound">, import("typebox").TLiteral<"authtoken_already_used">, import("typebox").TLiteral<"oauth_session_key_mismatch">, import("typebox").TLiteral<"service_role_on_user">, import("typebox").TLiteral<"reply_subject_mismatch">, import("typebox").TLiteral<"insufficient_permissions">, import("typebox").TLiteral<"forbidden">, import("typebox").TLiteral<"missing_flow_id">, import("typebox").TLiteral<"missing_profile_id">, import("typebox").TLiteral<"device_activation_flow_not_found">, import("typebox").TLiteral<"device_activation_flow_expired">, import("typebox").TLiteral<"device_activation_rejected">, import("typebox").TLiteral<"device_identity_key_mismatch">, import("typebox").TLiteral<"invalid_device_qr_mac">]>;
+                context: import("typebox").TOptional<import("typebox").TRecord<"^.*$", import("typebox").TUnknown>>;
+                traceId: import("typebox").TOptional<import("typebox").TString>;
+            }, "^.*$", import("typebox").TUnknown> | 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_profile_not_found" | "device_profile_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" | "missing_profile_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 ValidationError: {
+        readonly type: "ValidationError";
+        readonly schema: import("../contract_support/runtime.js").Schema<{
+            context?: import("typebox").StaticRecord<[], "Encode", {}, {
+                id: import("typebox").TString;
+                type: import("typebox").TLiteral<"ValidationError">;
+                message: import("typebox").TString;
+                issues: import("typebox").TArray<import("typebox").TObject<{
+                    path: import("typebox").TString;
+                    message: import("typebox").TString;
+                }>>;
+                context: import("typebox").TOptional<import("typebox").TRecord<"^.*$", import("typebox").TUnknown>>;
+                traceId: import("typebox").TOptional<import("typebox").TString>;
+            }, "^.*$", import("typebox").TUnknown> | 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("../contract_support/runtime.js").Schema<{
+            context?: import("typebox").StaticRecord<[], "Encode", {}, {
+                id: import("typebox").TString;
+                type: import("typebox").TLiteral<"KVError">;
+                message: import("typebox").TString;
+                operation: import("typebox").TOptional<import("typebox").TString>;
+                context: import("typebox").TOptional<import("typebox").TRecord<"^.*$", import("typebox").TUnknown>>;
+                traceId: import("typebox").TOptional<import("typebox").TString>;
+            }, "^.*$", import("typebox").TUnknown> | 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("../contract_support/runtime.js").Schema<{
+            context?: import("typebox").StaticRecord<[], "Encode", {}, {
+                id: import("typebox").TString;
+                type: import("typebox").TLiteral<"StoreError">;
+                message: import("typebox").TString;
+                operation: import("typebox").TOptional<import("typebox").TString>;
+                context: import("typebox").TOptional<import("typebox").TRecord<"^.*$", import("typebox").TUnknown>>;
+                traceId: import("typebox").TOptional<import("typebox").TString>;
+            }, "^.*$", import("typebox").TUnknown> | 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("../contract_support/runtime.js").Schema<{
+            context?: import("typebox").StaticRecord<[], "Encode", {}, {
+                id: import("typebox").TString;
+                type: import("typebox").TLiteral<"TransferError">;
+                message: import("typebox").TString;
+                operation: import("typebox").TOptional<import("typebox").TString>;
+                context: import("typebox").TOptional<import("typebox").TRecord<"^.*$", import("typebox").TUnknown>>;
+                traceId: import("typebox").TOptional<import("typebox").TString>;
+            }, "^.*$", import("typebox").TUnknown> | 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/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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"}

package/esm/errors/index.js

@@ -0,0 +1,118 @@
+import "../_dnt.polyfills.js";
+import { UnexpectedError, UnexpectedErrorDataSchema, } from "@qlever-llc/result";
+import { schema } from "../contract_support/mod.js";
+import { AuthError } from "./AuthError.js";
+import { AuthErrorDataSchema } from "./AuthError.js";
+import { ValidationError } from "./ValidationError.js";
+import { ValidationErrorDataSchema } from "./ValidationError.js";
+import { RemoteError } from "./RemoteError.js";
+import { KVError } from "./KVError.js";
+import { KVErrorDataSchema } from "./KVError.js";
+import { StoreError } from "./StoreError.js";
+import { StoreErrorDataSchema } from "./StoreError.js";
+import { TransferError } from "./TransferError.js";
+import { TransferErrorDataSchema } from "./TransferError.js";
+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 { TransferError } from "./TransferError.js";
+export { AuthErrorDataSchema } from "./AuthError.js";
+export { ValidationErrorDataSchema, ValidationIssueSchema, } from "./ValidationError.js";
+export { RemoteErrorDataSchema } from "./RemoteError.js";
+export { KVErrorDataSchema } from "./KVError.js";
+export { StoreErrorDataSchema } from "./StoreError.js";
+export { TransferErrorDataSchema } from "./TransferError.js";
+/**
+ * Single source of truth for all Trellis errors.
+ * This object is used for compile-time type inference.
+ */
+const TRANSPORTABLE_TRELLIS_ERRORS = {
+    UnexpectedError,
+    AuthError,
+    ValidationError,
+    KVError,
+    StoreError,
+    TransferError,
+};
+const TRELLIS_ERRORS = {
+    ...TRANSPORTABLE_TRELLIS_ERRORS,
+    RemoteError,
+};
+export const BUILTIN_RPC_ERRORS = {
+    UnexpectedError: {
+        type: "UnexpectedError",
+        schema: schema(UnexpectedErrorDataSchema),
+        fromSerializable(data) {
+            return new UnexpectedError({
+                id: data.id,
+                context: data.context,
+                traceId: data.traceId,
+            });
+        },
+    },
+    AuthError: {
+        type: "AuthError",
+        schema: schema(AuthErrorDataSchema),
+        fromSerializable(data) {
+            return new AuthError({
+                reason: data.reason,
+                id: data.id,
+                context: data.context,
+            });
+        },
+    },
+    ValidationError: {
+        type: "ValidationError",
+        schema: schema(ValidationErrorDataSchema),
+        fromSerializable(data) {
+            return new ValidationError({
+                errors: data.issues.map((issue) => ({
+                    path: issue.path,
+                    message: issue.message,
+                })),
+                id: data.id,
+                context: data.context,
+            });
+        },
+    },
+    KVError: {
+        type: "KVError",
+        schema: schema(KVErrorDataSchema),
+        fromSerializable(data) {
+            return new KVError({
+                operation: data.operation,
+                id: data.id,
+                context: data.context,
+            });
+        },
+    },
+    StoreError: {
+        type: "StoreError",
+        schema: schema(StoreErrorDataSchema),
+        fromSerializable(data) {
+            return new StoreError({
+                operation: data.operation,
+                id: data.id,
+                context: data.context,
+            });
+        },
+    },
+    TransferError: {
+        type: "TransferError",
+        schema: schema(TransferErrorDataSchema),
+        fromSerializable(data) {
+            return new TransferError({
+                operation: data.operation,
+                id: data.id,
+                context: data.context,
+            });
+        },
+    },
+};
+export function getBuiltinRpcError(type) {
+    return BUILTIN_RPC_ERRORS[type];
+}

package/esm/globals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../src/globals.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC;IACrD,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACjC,CAAC;AAkBF,eAAO,MAAM,MAAM,EAAE,UAA+B,CAAC"}

package/esm/health.d.ts

@@ -0,0 +1,5 @@
+import "./_dnt.polyfills.js";
+export type { HealthHeartbeat, HealthCheckFn, HealthCheckResult, HealthResponse, ServiceHealthCheck, ServiceHealthCheckFn, ServiceHealthInfoFn, ServiceHealthInfo, } from "./server/health.js";
+export { createHealthHeartbeat, runAllHealthChecks, runAllServiceHealthChecks, runHealthCheck, runServiceHealthCheck, ServiceHealth, } from "./server/health.js";
+export { HealthHeartbeatHeaderSchema, HealthHeartbeatSchema, HealthHeartbeatServiceSchema, HealthCheckResultSchema, HealthInfoSchema, HealthResponseSchema, HealthRpcSchema, } from "./server/health_schemas.js";
+//# sourceMappingURL=health.d.ts.map

package/esm/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AAC7B,YAAY,EACV,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,EACzB,cAAc,EACd,qBAAqB,EACrB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,GAChB,MAAM,4BAA4B,CAAC"}

package/esm/health.js

@@ -0,0 +1,3 @@
+import "./_dnt.polyfills.js";
+export { createHealthHeartbeat, runAllHealthChecks, runAllServiceHealthChecks, runHealthCheck, runServiceHealthCheck, ServiceHealth, } from "./server/health.js";
+export { HealthHeartbeatHeaderSchema, HealthHeartbeatSchema, HealthHeartbeatServiceSchema, HealthCheckResultSchema, HealthInfoSchema, HealthResponseSchema, HealthRpcSchema, } from "./server/health_schemas.js";

package/esm/helpers.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Compute the subject template from the message itself
+ */
+export declare function template(template: string, data: Record<string, string | number | boolean>, opts?: {
+    allowWildcards: boolean;
+}): string;
+export declare function escapeNats(token: string): string;
+export declare function escapeKvKey(key: string): string;
+export declare function decodeSubject(token: string): string;
+//# sourceMappingURL=helpers.d.ts.map

package/esm/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAC/C,IAAI,GAAE;IAAE,cAAc,EAAE,OAAO,CAAA;CAA8B,GAC5D,MAAM,CAWR;AAGD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAYhD;AAGD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAW/C;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUnD"}

package/esm/helpers.js

@@ -0,0 +1,38 @@
+import { Pointer } from "typebox/value";
+/**
+ * Compute the subject template from the message itself
+ */
+export function template(template, data, opts = { allowWildcards: false }) {
+    return template.replace(/\{([^}]+)\}/g, (_, key) => {
+        const token = Pointer.Get(data, key);
+        const v = token ? escapeNats(`${token}`) : "*";
+        if (!opts.allowWildcards && v === "*") {
+            throw new Error("All option templates must have values at runtime.");
+        }
+        return v;
+    });
+}
+const NATS_SUBJECT_TOKEN_FORBIDDEN = /[\u0000\s.*>~]/gu;
+export function escapeNats(token) {
+    const out = token.replace(NATS_SUBJECT_TOKEN_FORBIDDEN, (ch) => `~${ch.codePointAt(0).toString(16).toUpperCase()}~`);
+    // Protect start with $ due to NATS internal use of it
+    if (out.length === 0 || out.startsWith("$")) {
+        return `_${out}`;
+    }
+    return out;
+}
+const NATS_KV_KEY_FORBIDDEN = /[\u0000\s*>~]/gu;
+export function escapeKvKey(key) {
+    const out = key.replace(NATS_KV_KEY_FORBIDDEN, (ch) => `~${ch.codePointAt(0).toString(16).toUpperCase()}~`);
+    if (out.length === 0 || out.startsWith("$")) {
+        return `_${out}`;
+    }
+    return out;
+}
+export function decodeSubject(token) {
+    const out = token.replace(/~([0-9A-F]{1,6})~/g, (_, hex) => String.fromCodePoint(Number.parseInt(hex, 16)));
+    if (out.startsWith("_$")) {
+        return out.slice(1);
+    }
+    return out;
+}

package/esm/host/deno.d.ts

@@ -0,0 +1,3 @@
+import "../_dnt.polyfills.js";
+export * from "../server/deno.js";
+//# sourceMappingURL=deno.d.ts.map

package/esm/host/deno.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deno.d.ts","sourceRoot":"","sources":["../../src/host/deno.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,cAAc,mBAAmB,CAAC"}

package/esm/host/deno.js

@@ -0,0 +1,2 @@
+import "../_dnt.polyfills.js";
+export * from "../server/deno.js";

package/esm/host/mod.d.ts

@@ -0,0 +1,3 @@
+import "../_dnt.polyfills.js";
+export * from "../server/mod.js";
+//# sourceMappingURL=mod.d.ts.map

package/esm/host/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/host/mod.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}

package/esm/host/mod.js

@@ -0,0 +1,2 @@
+import "../_dnt.polyfills.js";
+export * from "../server/mod.js";

package/esm/host/node.d.ts

@@ -0,0 +1,3 @@
+import "../_dnt.polyfills.js";
+export * from "../server/node.js";
+//# sourceMappingURL=node.d.ts.map