@qlever-llc/trellis 0.5.1

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

@@ -0,0 +1,51 @@
+import type { TLocalizedValidationError } from "typebox/error";
+import Type, { type Static } from "typebox";
+import { TrellisError } from "./TrellisError.js";
+export type ValidationErrorInput = TLocalizedValidationError | {
+    path: string;
+    message: string;
+};
+/**
+ * Schema for validation issue in ValidationError.
+ */
+export declare const ValidationIssueSchema: Type.TObject<{
+    path: Type.TString;
+    message: Type.TString;
+}>;
+export type ValidationIssue = Static<typeof ValidationIssueSchema>;
+/**
+ * Schema for ValidationError serialization.
+ */
+export declare const ValidationErrorDataSchema: Type.TObject<{
+    id: Type.TString;
+    type: Type.TLiteral<"ValidationError">;
+    message: Type.TString;
+    issues: Type.TArray<Type.TObject<{
+        path: Type.TString;
+        message: Type.TString;
+    }>>;
+    context: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+    traceId: Type.TOptional<Type.TString>;
+}>;
+export type ValidationErrorData = Static<typeof ValidationErrorDataSchema>;
+/**
+ * Error for data validation failures.
+ * Includes schema validation and missing required data.
+ */
+export declare class ValidationError extends TrellisError<ValidationErrorData> {
+    #private;
+    readonly name: "ValidationError";
+    constructor(options: ErrorOptions & {
+        errors: Iterable<ValidationErrorInput>;
+        context?: Record<string, unknown>;
+        id?: string;
+    });
+    /**
+     * Serializes error to a plain object.
+     * Transforms internal errors array to issues array for serialization.
+     *
+     * @returns Plain object representation of the error
+     */
+    toSerializable(): ValidationErrorData;
+}
+//# sourceMappingURL=ValidationError.d.ts.map

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

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

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

@@ -0,0 +1,38 @@
+import { AuthError } from "./AuthError.js";
+import { ValidationError } from "./ValidationError.js";
+import { RemoteError } from "./RemoteError.js";
+import { KVError } from "./KVError.js";
+export { UnexpectedError } from "@qlever-llc/trellis-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 { 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";
+/**
+ * Single source of truth for all Trellis errors.
+ * This object is used for compile-time type inference.
+ */
+declare const TRELLIS_ERRORS: {
+    readonly UnexpectedError: any;
+    readonly AuthError: typeof AuthError;
+    readonly ValidationError: typeof ValidationError;
+    readonly RemoteError: typeof RemoteError;
+    readonly KVError: typeof KVError;
+};
+/**
+ * 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 TrellisErrorName = keyof TrellisErrorMap;
+export type TrellisErrorInstance = TrellisErrorMap[TrellisErrorName];
+export type MapErrorNamesToTypes<T extends readonly TrellisErrorName[]> = {
+    [K in keyof T]: T[K] extends TrellisErrorName ? TrellisErrorMap[T[K]] : never;
+}[number];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/trellis/errors/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,KAAK,aAAa,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EACL,KAAK,mBAAmB,EACxB,yBAAyB,EACzB,KAAK,eAAe,EACpB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,eAAe,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,KAAK,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEnE;;;GAGG;AACH,QAAA,MAAM,cAAc;;;;;;CAMV,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;KAC3B,CAAC,IAAI,MAAM,OAAO,cAAc,GAAG,YAAY,CAAC,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;CAC7E,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,eAAe,CAAC;AACrD,MAAM,MAAM,oBAAoB,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAC;AACrE,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,SAAS,gBAAgB,EAAE,IAAI;KACvE,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,gBAAgB,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK;CAC9E,CAAC,MAAM,CAAC,CAAC"}

package/script/trellis/errors/index.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KVErrorDataSchema = exports.RemoteErrorDataSchema = exports.ValidationIssueSchema = exports.ValidationErrorDataSchema = exports.AuthErrorDataSchema = exports.KVError = exports.RemoteError = exports.ValidationError = exports.AuthError = exports.TrellisError = exports.UnexpectedError = void 0;
+const trellis_result_1 = require("@qlever-llc/trellis-result");
+const AuthError_js_1 = require("./AuthError.js");
+const ValidationError_js_1 = require("./ValidationError.js");
+const RemoteError_js_1 = require("./RemoteError.js");
+const KVError_js_1 = require("./KVError.js");
+var trellis_result_2 = require("@qlever-llc/trellis-result");
+Object.defineProperty(exports, "UnexpectedError", { enumerable: true, get: function () { return trellis_result_2.UnexpectedError; } });
+var TrellisError_js_1 = require("./TrellisError.js");
+Object.defineProperty(exports, "TrellisError", { enumerable: true, get: function () { return TrellisError_js_1.TrellisError; } });
+var AuthError_js_2 = require("./AuthError.js");
+Object.defineProperty(exports, "AuthError", { enumerable: true, get: function () { return AuthError_js_2.AuthError; } });
+var ValidationError_js_2 = require("./ValidationError.js");
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return ValidationError_js_2.ValidationError; } });
+var RemoteError_js_2 = require("./RemoteError.js");
+Object.defineProperty(exports, "RemoteError", { enumerable: true, get: function () { return RemoteError_js_2.RemoteError; } });
+var KVError_js_2 = require("./KVError.js");
+Object.defineProperty(exports, "KVError", { enumerable: true, get: function () { return KVError_js_2.KVError; } });
+var AuthError_js_3 = require("./AuthError.js");
+Object.defineProperty(exports, "AuthErrorDataSchema", { enumerable: true, get: function () { return AuthError_js_3.AuthErrorDataSchema; } });
+var ValidationError_js_3 = require("./ValidationError.js");
+Object.defineProperty(exports, "ValidationErrorDataSchema", { enumerable: true, get: function () { return ValidationError_js_3.ValidationErrorDataSchema; } });
+Object.defineProperty(exports, "ValidationIssueSchema", { enumerable: true, get: function () { return ValidationError_js_3.ValidationIssueSchema; } });
+var RemoteError_js_3 = require("./RemoteError.js");
+Object.defineProperty(exports, "RemoteErrorDataSchema", { enumerable: true, get: function () { return RemoteError_js_3.RemoteErrorDataSchema; } });
+var KVError_js_3 = require("./KVError.js");
+Object.defineProperty(exports, "KVErrorDataSchema", { enumerable: true, get: function () { return KVError_js_3.KVErrorDataSchema; } });
+/**
+ * Single source of truth for all Trellis errors.
+ * This object is used for compile-time type inference.
+ */
+const TRELLIS_ERRORS = {
+    UnexpectedError: trellis_result_1.UnexpectedError,
+    AuthError: AuthError_js_1.AuthError,
+    ValidationError: ValidationError_js_1.ValidationError,
+    RemoteError: RemoteError_js_1.RemoteError,
+    KVError: KVError_js_1.KVError,
+};

package/script/trellis/globals.d.ts

@@ -0,0 +1,2 @@
+export declare const logger: import("pino").Logger<never, boolean>;
+//# sourceMappingURL=globals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../../src/trellis/globals.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,MAAM,uCAGjB,CAAC"}

package/script/trellis/globals.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+const pino_1 = require("pino");
+const env_js_1 = require("./env.js");
+// Support Deno and browser (+ Svelte's strict TS rules)
+const level = (0, env_js_1.getEnv)("PINO_LEVEL") || "info";
+exports.logger = (0, pino_1.pino)({
+    level,
+    base: { library: "@qlever-llc/trellis" },
+});

package/script/trellis/helpers.d.ts

@@ -0,0 +1,12 @@
+import type { Paginated } from "@qlever-llc/trellis-contracts";
+/**
+ * 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;
+export declare function makePaginated(offset: number, limit: number, count: number): Paginated;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/trellis/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAG/D;;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;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,SAAS,CAQX"}

package/script/trellis/helpers.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.template = template;
+exports.escapeNats = escapeNats;
+exports.escapeKvKey = escapeKvKey;
+exports.decodeSubject = decodeSubject;
+exports.makePaginated = makePaginated;
+const value_1 = require("typebox/value");
+/**
+ * Compute the subject template from the message itself
+ */
+function template(template, data, opts = { allowWildcards: false }) {
+    return template.replace(/\{([^}]+)\}/g, (_, key) => {
+        const token = value_1.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;
+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;
+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;
+}
+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;
+}
+function makePaginated(offset, limit, count) {
+    return {
+        count,
+        offset,
+        limit,
+        next: offset + limit >= count ? undefined : offset + limit,
+        prev: offset - limit <= 0 ? undefined : offset - limit,
+    };
+}

package/script/trellis/index.d.ts

@@ -0,0 +1,11 @@
+import "../_dnt.polyfills.js";
+export type { TrellisAPI } from "@qlever-llc/trellis-contracts";
+export { err, isErr, isOk, ok, Result } from "@qlever-llc/trellis-result";
+export type { ClientOpts } from "./client.js";
+export { createClient } from "./client.js";
+export type { TrellisErrorInstance } from "./errors/index.js";
+export { AuthError, KVError, RemoteError, TrellisError, UnexpectedError, ValidationError, } from "./errors/index.js";
+export { TypedKV } from "./kv.js";
+export type { TrellisAuth, TrellisSigner } from "./trellis.js";
+export { Trellis, TrellisServer } from "./trellis.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/trellis/index.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,YAAY,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAC1E,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EACL,SAAS,EACT,OAAO,EACP,WAAW,EACX,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/script/trellis/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TrellisServer = exports.Trellis = exports.TypedKV = exports.ValidationError = exports.UnexpectedError = exports.TrellisError = exports.RemoteError = exports.KVError = exports.AuthError = exports.createClient = exports.Result = exports.ok = exports.isOk = exports.isErr = exports.err = void 0;
+require("../_dnt.polyfills.js");
+var trellis_result_1 = require("@qlever-llc/trellis-result");
+Object.defineProperty(exports, "err", { enumerable: true, get: function () { return trellis_result_1.err; } });
+Object.defineProperty(exports, "isErr", { enumerable: true, get: function () { return trellis_result_1.isErr; } });
+Object.defineProperty(exports, "isOk", { enumerable: true, get: function () { return trellis_result_1.isOk; } });
+Object.defineProperty(exports, "ok", { enumerable: true, get: function () { return trellis_result_1.ok; } });
+Object.defineProperty(exports, "Result", { enumerable: true, get: function () { return trellis_result_1.Result; } });
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "createClient", { enumerable: true, get: function () { return client_js_1.createClient; } });
+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, "TrellisError", { enumerable: true, get: function () { return index_js_1.TrellisError; } });
+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; } });
+var kv_js_1 = require("./kv.js");
+Object.defineProperty(exports, "TypedKV", { enumerable: true, get: function () { return kv_js_1.TypedKV; } });
+var trellis_js_1 = require("./trellis.js");
+Object.defineProperty(exports, "Trellis", { enumerable: true, get: function () { return trellis_js_1.Trellis; } });
+Object.defineProperty(exports, "TrellisServer", { enumerable: true, get: function () { return trellis_js_1.TrellisServer; } });

package/script/trellis/kv.d.ts

@@ -0,0 +1,67 @@
+import { type KV, type KvEntry } from "@nats-io/kv";
+import type { NatsConnection } from "@nats-io/nats-core/internal";
+import { Result } from "@qlever-llc/trellis-result";
+import type { StaticDecode, TSchema } from "typebox";
+import { KVError, ValidationError } from "./errors/index.js";
+/**
+ * Represents a watch event emitted when a KV entry changes.
+ */
+export type WatchEvent<S extends TSchema> = {
+    /** The type of change: "update" for new/modified values, "delete" for deletions */
+    type: "update" | "delete";
+    /** The key that changed */
+    key: string;
+    /** The new value (only present for update events) */
+    value?: StaticDecode<S>;
+    /** The revision number of this change */
+    revision: number;
+    /** The timestamp when this change occurred */
+    timestamp: Date;
+};
+/**
+ * Options for the watch() method.
+ */
+export type WatchOptions = {
+    /** If true, include delete events in the watch stream. Defaults to false. */
+    includeDeletes?: boolean;
+};
+export declare class TypedKV<S extends TSchema> {
+    readonly schema: S;
+    readonly kv: KV;
+    private constructor();
+    static open<S extends TSchema>(nats: NatsConnection, name: string, schema: S, options: {
+        history?: number;
+        ttl?: number;
+        bindOnly?: boolean;
+        maxValueBytes?: number;
+    }): Promise<Result<TypedKV<S>, KVError>>;
+    get(key: string): Promise<Result<TypedKVEntry<S>, KVError | ValidationError>>;
+    create(key: string, value: StaticDecode<S>): Promise<Result<void, KVError>>;
+    put(key: string, value: StaticDecode<S>): Promise<Result<void, KVError>>;
+    delete(key: string): Promise<Result<void, KVError>>;
+    keys(filter?: string | string[]): Promise<Result<AsyncIterable<string>, KVError>>;
+    status(): Promise<Result<{
+        values: number;
+    }, KVError>>;
+}
+export declare class TypedKVEntry<S extends TSchema> {
+    private schema;
+    private kv;
+    private entry;
+    readonly value: StaticDecode<S>;
+    constructor(schema: S, kv: KV, entry: KvEntry, value: StaticDecode<S>);
+    static create<S extends TSchema>(schema: S, kv: KV, entry: KvEntry): Promise<Result<TypedKVEntry<S>, ValidationError>>;
+    get key(): string;
+    /**
+     * Watch this KV entry for changes.
+     *
+     * @param callback - Function called when the entry changes
+     * @param opts - Watch options (e.g., includeDeletes)
+     * @returns A function to stop watching
+     */
+    watch(callback: (event: WatchEvent<S>) => void, opts?: WatchOptions): Promise<() => void>;
+    merge(value: Partial<StaticDecode<S>>, vcc?: boolean): Promise<Result<void, KVError | ValidationError>>;
+    put(value: StaticDecode<S>, vcc?: boolean): Promise<Result<void, KVError>>;
+    delete(vcc?: boolean): Promise<Result<void, KVError>>;
+}
+//# sourceMappingURL=kv.d.ts.map

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

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