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

package/script/js/packages/trellis/npm/src/index.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StoreError = exports.RemoteError = exports.KVError = exports.AuthError = exports.TrellisDevice = exports.TrellisClient = exports.Result = exports.ok = exports.isOk = exports.isErr = exports.err = exports.defineServiceContract = exports.definePortalContract = exports.defineDeviceContract = exports.defineCliContract = exports.defineAppContract = exports.defineError = exports.HealthRpcSchema = exports.HealthResponseSchema = exports.HealthInfoSchema = exports.HealthCheckResultSchema = exports.HealthHeartbeatServiceSchema = exports.HealthHeartbeatSchema = exports.HealthHeartbeatHeaderSchema = exports.ServiceHealth = exports.runServiceHealthCheck = exports.runHealthCheck = exports.runAllServiceHealthChecks = exports.runAllHealthChecks = exports.createHealthHeartbeat = exports.unwrapSchema = exports.schema = exports.isJsonValue = exports.digestJson = exports.CONTRACT_FORMAT_V1 = exports.CATALOG_FORMAT_V1 = exports.canonicalizeJson = exports.signBytes = exports.natsConnectSigForBindingToken = exports.loadSessionKey = exports.isBindSuccessResponse = exports.hasSessionKey = exports.getPublicSessionKey = exports.getOrCreateSessionKey = exports.generateSessionKey = exports.createRpcProof = exports.createAuth = exports.clearSessionKey = exports.bindSession = exports.bindFlow = void 0;
+exports.Trellis = exports.OperationRef = exports.OperationInvoker = exports.controlSubject = exports.FileInfoSchema = exports.TypedStoreEntry = exports.TypedStore = exports.TypedKVEntry = exports.TypedKV = exports.ValidationError = exports.UnexpectedError = exports.TrellisError = exports.TransferError = void 0;
+require("./_dnt.polyfills.js");
+var auth_js_1 = require("./auth.js");
+Object.defineProperty(exports, "bindFlow", { enumerable: true, get: function () { return auth_js_1.bindFlow; } });
+Object.defineProperty(exports, "bindSession", { enumerable: true, get: function () { return auth_js_1.bindSession; } });
+Object.defineProperty(exports, "clearSessionKey", { enumerable: true, get: function () { return auth_js_1.clearSessionKey; } });
+Object.defineProperty(exports, "createAuth", { enumerable: true, get: function () { return auth_js_1.createAuth; } });
+Object.defineProperty(exports, "createRpcProof", { enumerable: true, get: function () { return auth_js_1.createRpcProof; } });
+Object.defineProperty(exports, "generateSessionKey", { enumerable: true, get: function () { return auth_js_1.generateSessionKey; } });
+Object.defineProperty(exports, "getOrCreateSessionKey", { enumerable: true, get: function () { return auth_js_1.getOrCreateSessionKey; } });
+Object.defineProperty(exports, "getPublicSessionKey", { enumerable: true, get: function () { return auth_js_1.getPublicSessionKey; } });
+Object.defineProperty(exports, "hasSessionKey", { enumerable: true, get: function () { return auth_js_1.hasSessionKey; } });
+Object.defineProperty(exports, "isBindSuccessResponse", { enumerable: true, get: function () { return auth_js_1.isBindSuccessResponse; } });
+Object.defineProperty(exports, "loadSessionKey", { enumerable: true, get: function () { return auth_js_1.loadSessionKey; } });
+Object.defineProperty(exports, "natsConnectSigForBindingToken", { enumerable: true, get: function () { return auth_js_1.natsConnectSigForBindingToken; } });
+Object.defineProperty(exports, "signBytes", { enumerable: true, get: function () { return auth_js_1.signBytes; } });
+var contracts_js_1 = require("./contracts.js");
+Object.defineProperty(exports, "canonicalizeJson", { enumerable: true, get: function () { return contracts_js_1.canonicalizeJson; } });
+Object.defineProperty(exports, "CATALOG_FORMAT_V1", { enumerable: true, get: function () { return contracts_js_1.CATALOG_FORMAT_V1; } });
+Object.defineProperty(exports, "CONTRACT_FORMAT_V1", { enumerable: true, get: function () { return contracts_js_1.CONTRACT_FORMAT_V1; } });
+Object.defineProperty(exports, "digestJson", { enumerable: true, get: function () { return contracts_js_1.digestJson; } });
+Object.defineProperty(exports, "isJsonValue", { enumerable: true, get: function () { return contracts_js_1.isJsonValue; } });
+Object.defineProperty(exports, "schema", { enumerable: true, get: function () { return contracts_js_1.schema; } });
+Object.defineProperty(exports, "unwrapSchema", { enumerable: true, get: function () { return contracts_js_1.unwrapSchema; } });
+var health_js_1 = require("./health.js");
+Object.defineProperty(exports, "createHealthHeartbeat", { enumerable: true, get: function () { return health_js_1.createHealthHeartbeat; } });
+Object.defineProperty(exports, "runAllHealthChecks", { enumerable: true, get: function () { return health_js_1.runAllHealthChecks; } });
+Object.defineProperty(exports, "runAllServiceHealthChecks", { enumerable: true, get: function () { return health_js_1.runAllServiceHealthChecks; } });
+Object.defineProperty(exports, "runHealthCheck", { enumerable: true, get: function () { return health_js_1.runHealthCheck; } });
+Object.defineProperty(exports, "runServiceHealthCheck", { enumerable: true, get: function () { return health_js_1.runServiceHealthCheck; } });
+Object.defineProperty(exports, "ServiceHealth", { enumerable: true, get: function () { return health_js_1.ServiceHealth; } });
+Object.defineProperty(exports, "HealthHeartbeatHeaderSchema", { enumerable: true, get: function () { return health_js_1.HealthHeartbeatHeaderSchema; } });
+Object.defineProperty(exports, "HealthHeartbeatSchema", { enumerable: true, get: function () { return health_js_1.HealthHeartbeatSchema; } });
+Object.defineProperty(exports, "HealthHeartbeatServiceSchema", { enumerable: true, get: function () { return health_js_1.HealthHeartbeatServiceSchema; } });
+Object.defineProperty(exports, "HealthCheckResultSchema", { enumerable: true, get: function () { return health_js_1.HealthCheckResultSchema; } });
+Object.defineProperty(exports, "HealthInfoSchema", { enumerable: true, get: function () { return health_js_1.HealthInfoSchema; } });
+Object.defineProperty(exports, "HealthResponseSchema", { enumerable: true, get: function () { return health_js_1.HealthResponseSchema; } });
+Object.defineProperty(exports, "HealthRpcSchema", { enumerable: true, get: function () { return health_js_1.HealthRpcSchema; } });
+var mod_js_1 = require("./contract_support/mod.js");
+Object.defineProperty(exports, "defineError", { enumerable: true, get: function () { return mod_js_1.defineError; } });
+var contract_js_1 = require("./contract.js");
+Object.defineProperty(exports, "defineAppContract", { enumerable: true, get: function () { return contract_js_1.defineAppContract; } });
+Object.defineProperty(exports, "defineCliContract", { enumerable: true, get: function () { return contract_js_1.defineCliContract; } });
+Object.defineProperty(exports, "defineDeviceContract", { enumerable: true, get: function () { return contract_js_1.defineDeviceContract; } });
+Object.defineProperty(exports, "definePortalContract", { enumerable: true, get: function () { return contract_js_1.definePortalContract; } });
+Object.defineProperty(exports, "defineServiceContract", { enumerable: true, get: function () { return contract_js_1.defineServiceContract; } });
+var result_1 = require("@qlever-llc/result");
+Object.defineProperty(exports, "err", { enumerable: true, get: function () { return result_1.err; } });
+Object.defineProperty(exports, "isErr", { enumerable: true, get: function () { return result_1.isErr; } });
+Object.defineProperty(exports, "isOk", { enumerable: true, get: function () { return result_1.isOk; } });
+Object.defineProperty(exports, "ok", { enumerable: true, get: function () { return result_1.ok; } });
+Object.defineProperty(exports, "Result", { enumerable: true, get: function () { return result_1.Result; } });
+var client_connect_js_1 = require("./client_connect.js");
+Object.defineProperty(exports, "TrellisClient", { enumerable: true, get: function () { return client_connect_js_1.TrellisClient; } });
+var device_js_1 = require("./device.js");
+Object.defineProperty(exports, "TrellisDevice", { enumerable: true, get: function () { return device_js_1.TrellisDevice; } });
+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, "StoreError", { enumerable: true, get: function () { return index_js_1.StoreError; } });
+Object.defineProperty(exports, "TransferError", { enumerable: true, get: function () { return index_js_1.TransferError; } });
+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; } });
+Object.defineProperty(exports, "TypedKVEntry", { enumerable: true, get: function () { return kv_js_1.TypedKVEntry; } });
+var store_js_1 = require("./store.js");
+Object.defineProperty(exports, "TypedStore", { enumerable: true, get: function () { return store_js_1.TypedStore; } });
+Object.defineProperty(exports, "TypedStoreEntry", { enumerable: true, get: function () { return store_js_1.TypedStoreEntry; } });
+var transfer_js_1 = require("./transfer.js");
+Object.defineProperty(exports, "FileInfoSchema", { enumerable: true, get: function () { return transfer_js_1.FileInfoSchema; } });
+var operations_js_1 = require("./operations.js");
+Object.defineProperty(exports, "controlSubject", { enumerable: true, get: function () { return operations_js_1.controlSubject; } });
+Object.defineProperty(exports, "OperationInvoker", { enumerable: true, get: function () { return operations_js_1.OperationInvoker; } });
+Object.defineProperty(exports, "OperationRef", { enumerable: true, get: function () { return operations_js_1.OperationRef; } });
+var trellis_js_1 = require("./trellis.js");
+Object.defineProperty(exports, "Trellis", { enumerable: true, get: function () { return trellis_js_1.Trellis; } });

package/script/js/packages/trellis/npm/src/kv.d.ts

@@ -0,0 +1,72 @@
+import { type KV, type KvEntry } from "@nats-io/kv";
+import type { NatsConnection } from "@nats-io/nats-core/internal";
+import { Result } from "@qlever-llc/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();
+    private static fromParts;
+    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>>;
+    private serialize;
+    create(key: string, value: unknown): Promise<Result<void, KVError>>;
+    put(key: string, value: unknown): 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;
+    private schema;
+    private kv;
+    private entry;
+    constructor(schema: S, kv: KV, entry: KvEntry, value: unknown);
+    get value(): StaticDecode<S>;
+    static create<S extends TSchema>(schema: S, kv: KV, entry: KvEntry): Promise<Result<TypedKVEntry<S>, ValidationError>>;
+    get key(): string;
+    get revision(): number;
+    get createdAt(): Date;
+    /**
+     * 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: unknown, vcc?: boolean): Promise<Result<void, KVError | ValidationError>>;
+    put(value: unknown, vcc?: boolean): Promise<Result<void, KVError>>;
+    delete(vcc?: boolean): Promise<Result<void, KVError>>;
+}
+//# sourceMappingURL=kv.d.ts.map

package/script/js/packages/trellis/npm/src/kv.d.ts.map

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

package/script/js/packages/trellis/npm/src/kv.js

@@ -0,0 +1,383 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+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 _TypedKVEntry_value;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypedKVEntry = exports.TypedKV = void 0;
+const kv_1 = require("@nats-io/kv");
+const result_1 = require("@qlever-llc/result");
+const value_1 = __importStar(require("typebox/value"));
+const index_js_1 = require("./errors/index.js");
+const helpers_js_1 = require("./helpers.js");
+function externalizeValue(value) {
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (Array.isArray(value)) {
+        return value.map(externalizeValue);
+    }
+    if (value !== null && typeof value === "object") {
+        const out = {};
+        for (const [key, entry] of Object.entries(value)) {
+            if (entry !== undefined) {
+                out[key] = externalizeValue(entry);
+            }
+        }
+        return out;
+    }
+    return value;
+}
+function parseExternalValue(schema, value) {
+    if (value_1.default.HasCodec(schema)) {
+        return value_1.default.Decode(schema, value);
+    }
+    return value_1.default.Parse(schema, value);
+}
+function serializeValue(schema, value) {
+    return JSON.stringify(value_1.default.Parse(schema, externalizeValue(value)));
+}
+function serializeExternalValue(schema, value) {
+    return serializeValue(schema, value);
+}
+function isPlainObject(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function mergeUnknown(target, source) {
+    if (!isPlainObject(target) || !isPlainObject(source)) {
+        return source;
+    }
+    const out = { ...target };
+    for (const [key, entry] of Object.entries(source)) {
+        if (entry === undefined)
+            continue;
+        out[key] = mergeUnknown(target[key], entry);
+    }
+    return out;
+}
+class TypedKV {
+    constructor(schema, kv) {
+        Object.defineProperty(this, "schema", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: schema
+        });
+        Object.defineProperty(this, "kv", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: kv
+        });
+    }
+    static fromParts(schema, kv) {
+        return new TypedKV(schema, kv);
+    }
+    static async open(nats, name, schema, options) {
+        try {
+            const kvm = new kv_1.Kvm(nats);
+            const kv = options.bindOnly
+                ? await kvm.open(name)
+                : await kvm.create(name, {
+                    history: options.history ?? 1,
+                    ttl: options.ttl ?? 0,
+                    ...(options.maxValueBytes ? { maxValueSize: options.maxValueBytes } : {}),
+                });
+            const typedKv = TypedKV.fromParts(schema, kv);
+            return result_1.Result.ok(typedKv);
+        }
+        catch (cause) {
+            return result_1.Result.err(new index_js_1.KVError({ operation: "open", cause }));
+        }
+    }
+    async get(key) {
+        let s;
+        try {
+            s = await this.kv.get((0, helpers_js_1.escapeKvKey)(key));
+        }
+        catch (cause) {
+            return result_1.Result.err(new index_js_1.KVError({ operation: "get", cause, context: { key } }));
+        }
+        if (!s) {
+            return result_1.Result.err(new index_js_1.KVError({
+                operation: "get",
+                context: { key, reason: "not found" },
+            }));
+        }
+        const result = await createTypedKvEntry(this.schema, this.kv, s);
+        return result;
+    }
+    serialize(value) {
+        return serializeExternalValue(this.schema, value);
+    }
+    async create(key, value) {
+        try {
+            await this.kv.create((0, helpers_js_1.escapeKvKey)(key), this.serialize(value));
+            return result_1.Result.ok(undefined);
+        }
+        catch (cause) {
+            return result_1.Result.err(new index_js_1.KVError({ operation: "create", cause, context: { key } }));
+        }
+    }
+    async put(key, value) {
+        try {
+            await this.kv.put((0, helpers_js_1.escapeKvKey)(key), this.serialize(value));
+            return result_1.Result.ok(undefined);
+        }
+        catch (cause) {
+            return result_1.Result.err(new index_js_1.KVError({ operation: "put", cause, context: { key } }));
+        }
+    }
+    async delete(key) {
+        try {
+            await this.kv.delete((0, helpers_js_1.escapeKvKey)(key));
+            return result_1.Result.ok(undefined);
+        }
+        catch (cause) {
+            return result_1.Result.err(new index_js_1.KVError({ operation: "delete", cause, context: { key } }));
+        }
+    }
+    async keys(filter = ">") {
+        try {
+            return result_1.Result.ok(await this.kv.keys(filter));
+        }
+        catch (cause) {
+            return result_1.Result.err(new index_js_1.KVError({ operation: "keys", cause, context: { filter } }));
+        }
+    }
+    async status() {
+        try {
+            const status = await this.kv.status();
+            return result_1.Result.ok({ values: status.values });
+        }
+        catch (cause) {
+            return result_1.Result.err(new index_js_1.KVError({ operation: "status", cause }));
+        }
+    }
+}
+exports.TypedKV = TypedKV;
+class TypedKVEntry {
+    constructor(schema, kv, entry, value) {
+        Object.defineProperty(this, "schema", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: schema
+        });
+        Object.defineProperty(this, "kv", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: kv
+        });
+        Object.defineProperty(this, "entry", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: entry
+        });
+        _TypedKVEntry_value.set(this, void 0);
+        __classPrivateFieldSet(this, _TypedKVEntry_value, value, "f");
+    }
+    get value() {
+        return __classPrivateFieldGet(this, _TypedKVEntry_value, "f");
+    }
+    static async create(schema, kv, entry) {
+        const result = await createTypedKvEntry(schema, kv, entry);
+        return result;
+    }
+    get key() {
+        return (0, helpers_js_1.decodeSubject)(this.entry.key);
+    }
+    get revision() {
+        return this.entry.revision;
+    }
+    get createdAt() {
+        return this.entry.created;
+    }
+    /**
+     * 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
+     */
+    async watch(callback, opts) {
+        const watcher = await this.kv.watch({
+            key: this.entry.key,
+            include: opts?.includeDeletes ? "history" : "updates",
+        });
+        const abortController = new AbortController();
+        // Start the async iteration in the background
+        (async () => {
+            for await (const entry of watcher) {
+                if (abortController.signal.aborted)
+                    break;
+                if (entry.operation === "DEL" || entry.operation === "PURGE") {
+                    if (opts?.includeDeletes) {
+                        callback({
+                            type: "delete",
+                            key: (0, helpers_js_1.decodeSubject)(entry.key),
+                            revision: entry.revision,
+                            timestamp: entry.created,
+                        });
+                    }
+                }
+                else {
+                    let validated;
+                    try {
+                        const json = entry.json();
+                        validated = parseExternalValue(this.schema, json);
+                    }
+                    catch {
+                        try {
+                            await this.kv.delete(entry.key, {
+                                previousSeq: entry.revision,
+                            });
+                        }
+                        catch {
+                            // Best-effort cleanup of invalid entries.
+                        }
+                        continue;
+                    }
+                    callback({
+                        type: "update",
+                        key: (0, helpers_js_1.decodeSubject)(entry.key),
+                        value: validated,
+                        revision: entry.revision,
+                        timestamp: entry.created,
+                    });
+                }
+            }
+        })();
+        return () => {
+            abortController.abort();
+            watcher.stop();
+        };
+    }
+    async merge(value, vcc) {
+        const mergedData = mergeUnknown(__classPrivateFieldGet(this, _TypedKVEntry_value, "f"), value);
+        const mergeResult = result_1.Result.try(() => serializeExternalValue(this.schema, mergedData));
+        if (mergeResult.isErr()) {
+            const cause = mergeResult.error.cause;
+            if (cause instanceof value_1.ParseError) {
+                const errors = value_1.default.Errors(this.schema, externalizeValue(mergedData));
+                return result_1.Result.err(new index_js_1.ValidationError({ errors, cause }));
+            }
+            return result_1.Result.err(new index_js_1.KVError({ operation: "merge", cause: mergeResult.error, context: { key: this.key } }));
+        }
+        return this.put(mergedData, vcc);
+    }
+    async put(value, vcc) {
+        const serialized = serializeValue(this.schema, value);
+        try {
+            await this.kv.put(this.entry.key, serialized, {
+                previousSeq: vcc ? this.entry.revision : undefined,
+            });
+            return result_1.Result.ok(undefined);
+        }
+        catch (cause) {
+            return result_1.Result.err(new index_js_1.KVError({ operation: "put", cause, context: { key: this.key } }));
+        }
+    }
+    async delete(vcc) {
+        try {
+            await this.kv.delete(this.entry.key, {
+                previousSeq: vcc ? this.entry.revision : undefined,
+            });
+            return result_1.Result.ok(undefined);
+        }
+        catch (cause) {
+            return result_1.Result.err(new index_js_1.KVError({ operation: "delete", cause, context: { key: this.key } }));
+        }
+    }
+}
+exports.TypedKVEntry = TypedKVEntry;
+_TypedKVEntry_value = new WeakMap();
+async function createTypedKvEntry(schema, kv, entry) {
+    async function deleteInvalidEntry(reason) {
+        try {
+            await kv.delete(entry.key, {
+                previousSeq: entry.revision,
+            });
+            return {
+                key: (0, helpers_js_1.decodeSubject)(entry.key),
+                revision: entry.revision,
+                invalidEntryDeleted: true,
+                invalidEntryReason: reason,
+            };
+        }
+        catch (cause) {
+            return {
+                key: (0, helpers_js_1.decodeSubject)(entry.key),
+                revision: entry.revision,
+                invalidEntryDeleted: false,
+                invalidEntryDeleteError: cause instanceof Error ? cause.message : String(cause),
+                invalidEntryReason: reason,
+            };
+        }
+    }
+    const jsonResult = result_1.Result.try(() => entry.json());
+    if (jsonResult.isErr()) {
+        const context = await deleteInvalidEntry(`decode failed: ${jsonResult.error.message}`);
+        return result_1.Result.err(new index_js_1.ValidationError({
+            errors: [{ path: "", message: `Failed to decode KV value: ${jsonResult.error.message}` }],
+            cause: jsonResult.error,
+            context,
+        }));
+    }
+    const json = jsonResult.take();
+    const parseResult = result_1.Result.try(() => {
+        if (value_1.default.HasCodec(schema)) {
+            return value_1.default.Decode(schema, json);
+        }
+        return value_1.default.Parse(schema, json);
+    });
+    if (parseResult.isErr()) {
+        const cause = parseResult.error.cause;
+        if (cause instanceof value_1.ParseError) {
+            const errors = value_1.default.Errors(schema, json);
+            const context = await deleteInvalidEntry("schema parse failed");
+            return result_1.Result.err(new index_js_1.ValidationError({ errors, cause, context }));
+        }
+        const context = await deleteInvalidEntry(parseResult.error.message);
+        return result_1.Result.err(new index_js_1.ValidationError({
+            errors: [{ path: "", message: parseResult.error.message }],
+            cause: parseResult.error,
+            context,
+        }));
+    }
+    const typedEntry = new TypedKVEntry(schema, kv, entry, parseResult.take());
+    return result_1.Result.ok(typedEntry);
+}

package/script/js/packages/trellis/npm/src/models/trellis/TrellisError.d.ts

@@ -0,0 +1,20 @@
+import Type, { type StaticDecode } from "typebox";
+/**
+ * Open transport schema for Trellis RPC error payloads.
+ *
+ * Error payloads must always carry the base error fields, but service-local contract
+ * errors may add arbitrary additional properties. The client validates declared local
+ * errors against their contract schema before reconstructing runtime `Error` instances.
+ */
+export declare const TrellisErrorDataSchema: Type.TObject<{
+    id: Type.TString;
+    type: Type.TString;
+    message: Type.TString;
+    context: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+    traceId: Type.TOptional<Type.TString>;
+}>;
+/**
+ * Type for validated transport error data.
+ */
+export type TrellisErrorData = StaticDecode<typeof TrellisErrorDataSchema>;
+//# sourceMappingURL=TrellisError.d.ts.map

package/script/js/packages/trellis/npm/src/models/trellis/TrellisError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrellisError.d.ts","sourceRoot":"","sources":["../../../../../../../../src/models/trellis/TrellisError.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,EAAE,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAElD;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB;;;;;;EAMD,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/script/js/packages/trellis/npm/src/models/trellis/TrellisError.js

@@ -0,0 +1,21 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TrellisErrorDataSchema = void 0;
+const typebox_1 = __importDefault(require("typebox"));
+/**
+ * Open transport schema for Trellis RPC error payloads.
+ *
+ * Error payloads must always carry the base error fields, but service-local contract
+ * errors may add arbitrary additional properties. The client validates declared local
+ * errors against their contract schema before reconstructing runtime `Error` instances.
+ */
+exports.TrellisErrorDataSchema = typebox_1.default.Object({
+    id: typebox_1.default.String(),
+    type: typebox_1.default.String(),
+    message: 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()),
+}, { additionalProperties: true });