@qlever-llc/trellis 0.7.0 → 0.8.0-rc.3

package/esm/npm/src/errors/index.js

@@ -0,0 +1,137 @@
+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 { TransportError } from "./TransportError.js";
+import { TransportErrorDataSchema } from "./TransportError.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 { TransportError } from "./TransportError.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 { TransportErrorDataSchema, } from "./TransportError.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,
+    TransportError,
+    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,
+            });
+        },
+    },
+    TransportError: {
+        type: "TransportError",
+        schema: schema(TransportErrorDataSchema),
+        fromSerializable(data) {
+            return new TransportError({
+                code: data.code,
+                message: data.message,
+                hint: data.hint,
+                id: data.id,
+                context: data.context,
+                traceId: data.traceId,
+            });
+        },
+    },
+    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/npm/src/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/npm/src/globals.js

@@ -0,0 +1,16 @@
+function createNoopLogger() {
+    const noop = () => { };
+    const logger = {
+        child: () => logger,
+        trace: noop,
+        debug: noop,
+        info: noop,
+        warn: noop,
+        error: noop,
+    };
+    return logger;
+}
+// Keep the root package browser-safe: importing `@qlever-llc/trellis` must not
+// pull in `pino` or Node-only side effects. Server-only entrypoints can inject
+// a real logger, while the shared runtime defaults to a no-op logger here.
+export const logger = createNoopLogger();

package/esm/npm/src/health.d.ts

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

package/esm/npm/src/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,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,EACzB,cAAc,EACd,qBAAqB,EACrB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,qBAAqB,EACrB,4BAA4B,EAC5B,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,GAChB,MAAM,4BAA4B,CAAC"}

package/esm/npm/src/health.js

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

package/esm/npm/src/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,CAWnD"}

package/esm/npm/src/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/npm/src/host/mod.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Legacy service host entry point.
+ *
+ * @module
+ */
+import "../_dnt.polyfills.js";
+export * from "../service/mod.js";
+//# sourceMappingURL=mod.d.ts.map

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

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

package/esm/npm/src/host/mod.js

@@ -0,0 +1,7 @@
+/**
+ * Legacy service host entry point.
+ *
+ * @module
+ */
+import "../_dnt.polyfills.js";
+export * from "../service/mod.js";

package/esm/npm/src/host/node.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Legacy Node service host entry point.
+ *
+ * @module
+ */
+import "../_dnt.polyfills.js";
+export * from "../service/node.js";
+//# sourceMappingURL=node.d.ts.map

package/esm/npm/src/host/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../../src/host/node.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,sBAAsB,CAAC;AAG9B,cAAc,oBAAoB,CAAC"}

package/esm/npm/src/host/node.js

@@ -0,0 +1,7 @@
+/**
+ * Legacy Node service host entry point.
+ *
+ * @module
+ */
+import "../_dnt.polyfills.js";
+export * from "../service/node.js";

package/esm/npm/src/index.d.ts

@@ -0,0 +1,35 @@
+import "./_dnt.polyfills.js";
+export { bindFlow, clearSessionKey, createAuth, createRpcProof, generateSessionKey, getOrCreateSessionKey, getPublicSessionKey, hasSessionKey, isBindSuccessResponse, loadSessionKey, signBytes, } from "./auth.js";
+export type { BindResponse, BindSuccessResponse, NatsConnectOptions, SessionKeyHandle, } from "./auth.js";
+export { canonicalizeJson, CATALOG_FORMAT_V1, CONTRACT_FORMAT_V1, digestJson, isJsonValue, schema, unwrapSchema, } from "./contracts.js";
+export type { InferSchemaType, JsonValue, TrellisAPI } from "./contracts.js";
+export { TrellisConnection } from "./connection.js";
+export type { TrellisConnectionStatus } from "./connection.js";
+export type { HealthCheckFn, HealthCheckResult, HealthHeartbeat, HealthResponse, ServiceHealthCheck, ServiceHealthCheckFn, ServiceHealthInfo, ServiceHealthInfoFn, } from "./health.js";
+export { createHealthHeartbeat, HealthCheckResultSchema, HealthHeartbeatHeaderSchema, HealthHeartbeatSchema, HealthHeartbeatServiceSchema, HealthInfoSchema, HealthResponseSchema, HealthRpcSchema, runAllHealthChecks, runAllServiceHealthChecks, runHealthCheck, runServiceHealthCheck, ServiceHealth, } from "./health.js";
+export { defineError } from "./contract_support/mod.js";
+export type { ErrorClass, InferRuntimeRpcError, RpcErrorClass, RuntimeRpcErrorDesc, SerializableErrorData, } from "./contract_support/mod.js";
+export { defineAgentContract, defineAppContract, defineDeviceContract, defineServiceContract, } from "./contract.js";
+export type { ContractApiViews, ContractDependencyUse, ContractModule, ContractUseFn, DefineContractInput, EmptyApi, SdkContractModule, TrellisApiLike, TrellisContractV1, UseSpec, } from "./contract.js";
+export { AsyncResult, BaseError, err, isErr, isOk, ok, Result, } from "@qlever-llc/result";
+export type { MaybeAsync } from "@qlever-llc/result";
+export type { ClientOpts } from "./client.js";
+export type { ClientAuthContinuation, ClientAuthOptions, ClientAuthRequiredContext, TrellisClientConnectArgs, } from "./client_connect.js";
+export { ClientAuthHandledError, TrellisClient } from "./client_connect.js";
+export { TrellisDevice } from "./device.js";
+export type { TrellisErrorInstance } from "./errors/index.js";
+export { AuthError, KVError, RemoteError, StoreError, TransferError, TransportError, TrellisError, UnexpectedError, ValidationError, } from "./errors/index.js";
+export { ActiveJob, JobLogEntrySchema, JobProgressSchema, JobQueue, JobRef, JobWorkerHostAdapter, } from "./jobs.js";
+export type { Job, JobFilter, JobIdentity, JobLogEntry, JobProgress, JobsFacade, JobsFacadeOf, JobsHealth, JobSnapshot, JobState, JobTypeMetadata, JobWorkerHost, ServiceInfo, TerminalJob, WorkerInfo, } from "./jobs.js";
+export { TypedKV, TypedKVEntry } from "./kv.js";
+export type { WatchEvent, WatchOptions } from "./kv.js";
+export { TypedStore, TypedStoreEntry } from "./store.js";
+export type { StoreBody, StoreInfo, StoreOpenOptions, StorePutOptions, StoreStatus, StoreWaitOptions, } from "./store.js";
+export { createTransferHandle, FileInfoSchema } from "./transfer.js";
+export type { FileInfo, ReceiveTransferGrant, ReceiveTransferHandle, SendTransferGrant, SendTransferHandle, TransferBody, TransferGrant, } from "./transfer.js";
+export type { AcceptedOperationEvent, CancelledOperationEvent, CompletedOperationEvent, CompletedTransfer, FailedOperationEvent, OperationEvent, OperationInputBuilder, OperationObserverCallbacks, OperationRef, OperationRefData, OperationSnapshot, OperationState, OperationTransferProgress, ProgressOperationEvent, ProgressOperationSnapshot, StartedOperationEvent, StartedTransfer, TerminalOperation, TransferCapableOperationInputBuilder, TransferOperationBuilder, TransferOperationEvent, TransferOperationSnapshot, } from "./operations.js";
+export { controlSubject, OperationInvoker } from "./operations.js";
+export type { AcceptedOperation, ClientTrellis, ConnectedTrellisClient, EventHandler, EventName, EventOpts, EventPayload, EventType, HandlerJobQueue, HandlerJobsFacade, HandlerKvFacade, HandlerStoreHandle, HandlerTrellis, HandlerTrellisForContract, MapStateStoreClient, OperationHandlerContext, OperationRegistration, OperationTransferContextOf, OperationTransferHandle, RequestOpts, RpcArgs, RpcHandlerContext, RpcHandlerErrorOf, RpcHandlerFn, RpcInputOf, RpcMethodNameOf, RpcOutputOf, RpcRequestErrorOf, RpcResult, RuntimeStateStoresForContract, RuntimeStateStoreShape, StateFacade, TrellisFor, ValueStateStoreClient, } from "./trellis.js";
+export { Trellis } from "./trellis.js";
+export type { TrellisDeviceConnection } from "./device.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/npm/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AAC7B,OAAO,EACL,QAAQ,EACR,eAAe,EACf,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,SAAS,GACV,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,MAAM,EACN,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,qBAAqB,EACrB,4BAA4B,EAC5B,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,yBAAyB,EACzB,cAAc,EACd,qBAAqB,EACrB,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,YAAY,EACV,UAAU,EACV,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,QAAQ,EACR,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,OAAO,GACR,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,WAAW,EACX,SAAS,EACT,GAAG,EACH,KAAK,EACL,IAAI,EACJ,EAAE,EACF,MAAM,GACP,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EACV,sBAAsB,EACtB,iBAAiB,EACjB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EACL,SAAS,EACT,OAAO,EACP,WAAW,EACX,UAAU,EACV,aAAa,EACb,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,EACR,MAAM,EACN,oBAAoB,GACrB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,GAAG,EACH,SAAS,EACT,WAAW,EACX,WAAW,EACX,WAAW,EACX,UAAU,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,QAAQ,EACR,eAAe,EACf,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACzD,YAAY,EACV,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACrE,YAAY,EACV,QAAQ,EACR,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACrB,0BAA0B,EAC1B,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,oCAAoC,EACpC,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnE,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACtB,YAAY,EACZ,SAAS,EACT,SAAS,EACT,YAAY,EACZ,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,yBAAyB,EACzB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,EACvB,WAAW,EACX,OAAO,EACP,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,6BAA6B,EAC7B,sBAAsB,EACtB,WAAW,EACX,UAAU,EACV,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC"}

package/esm/npm/src/index.js

@@ -0,0 +1,17 @@
+import "./_dnt.polyfills.js";
+export { bindFlow, clearSessionKey, createAuth, createRpcProof, generateSessionKey, getOrCreateSessionKey, getPublicSessionKey, hasSessionKey, isBindSuccessResponse, loadSessionKey, signBytes, } from "./auth.js";
+export { canonicalizeJson, CATALOG_FORMAT_V1, CONTRACT_FORMAT_V1, digestJson, isJsonValue, schema, unwrapSchema, } from "./contracts.js";
+export { TrellisConnection } from "./connection.js";
+export { createHealthHeartbeat, HealthCheckResultSchema, HealthHeartbeatHeaderSchema, HealthHeartbeatSchema, HealthHeartbeatServiceSchema, HealthInfoSchema, HealthResponseSchema, HealthRpcSchema, runAllHealthChecks, runAllServiceHealthChecks, runHealthCheck, runServiceHealthCheck, ServiceHealth, } from "./health.js";
+export { defineError } from "./contract_support/mod.js";
+export { defineAgentContract, defineAppContract, defineDeviceContract, defineServiceContract, } from "./contract.js";
+export { AsyncResult, BaseError, err, isErr, isOk, ok, Result, } from "@qlever-llc/result";
+export { ClientAuthHandledError, TrellisClient } from "./client_connect.js";
+export { TrellisDevice } from "./device.js";
+export { AuthError, KVError, RemoteError, StoreError, TransferError, TransportError, TrellisError, UnexpectedError, ValidationError, } from "./errors/index.js";
+export { ActiveJob, JobLogEntrySchema, JobProgressSchema, JobQueue, JobRef, JobWorkerHostAdapter, } from "./jobs.js";
+export { TypedKV, TypedKVEntry } from "./kv.js";
+export { TypedStore, TypedStoreEntry } from "./store.js";
+export { createTransferHandle, FileInfoSchema } from "./transfer.js";
+export { controlSubject, OperationInvoker } from "./operations.js";
+export { Trellis } from "./trellis.js";

package/esm/npm/src/jobs.d.ts

@@ -0,0 +1,136 @@
+import { AsyncResult, type BaseError, Result } from "@qlever-llc/result";
+import { type StaticDecode, Type } from "typebox";
+export declare const JobLogEntrySchema: Type.TObject<{
+    timestamp: Type.TString;
+    level: Type.TUnion<[Type.TLiteral<"info">, Type.TLiteral<"warn">, Type.TLiteral<"error">]>;
+    message: Type.TString;
+}>;
+export declare const JobProgressSchema: Type.TObject<{
+    step: Type.TOptional<Type.TString>;
+    message: Type.TOptional<Type.TString>;
+    current: Type.TOptional<Type.TInteger>;
+    total: Type.TOptional<Type.TInteger>;
+}>;
+export type JobProgress = StaticDecode<typeof JobProgressSchema>;
+export type JobLogEntry = StaticDecode<typeof JobLogEntrySchema>;
+export type JobState = "pending" | "active" | "retry" | "completed" | "failed" | "cancelled" | "expired" | "dead" | "dismissed";
+export type JobIdentity = {
+    service: string;
+    jobType: string;
+    id: string;
+};
+export type JobSnapshot<TPayload, TResult> = {
+    id: string;
+    service: string;
+    type: string;
+    state: JobState;
+    payload: TPayload;
+    result?: TResult;
+    createdAt: string;
+    updatedAt: string;
+    startedAt?: string;
+    completedAt?: string;
+    tries: number;
+    maxTries: number;
+    lastError?: string;
+    deadline?: string;
+    progress?: JobProgress;
+    logs?: JobLogEntry[];
+};
+export type Job<TPayload = unknown, TResult = unknown> = JobSnapshot<TPayload, TResult>;
+export type TerminalJob<TPayload, TResult> = JobSnapshot<TPayload, TResult> & {
+    state: "completed" | "failed" | "cancelled" | "expired" | "dead" | "dismissed";
+};
+export type JobFilter = {
+    service?: string;
+    jobType?: string;
+    state?: JobState | JobState[];
+    since?: string;
+    limit?: number;
+};
+export type WorkerInfo = {
+    service: string;
+    jobType: string;
+    instanceId: string;
+    concurrency?: number;
+    version?: string;
+    timestamp: string;
+};
+export type ServiceInfo = {
+    name: string;
+    workers: WorkerInfo[];
+    healthy: boolean;
+};
+export type JobsHealth = {
+    status: "healthy" | "unhealthy" | "degraded";
+    service: string;
+    timestamp: string;
+    checks: Array<{
+        name: string;
+        status: "ok" | "failed";
+        latencyMs: number;
+        error?: string;
+    }>;
+};
+export type JobTypeMetadata = {
+    payload: unknown;
+    result: unknown;
+};
+export declare class JobRef<TPayload, TResult> {
+    #private;
+    readonly id: string;
+    readonly service: string;
+    readonly type: string;
+    constructor(ref: JobIdentity, impl: {
+        get: () => AsyncResult<JobSnapshot<TPayload, TResult>, BaseError>;
+        wait: () => AsyncResult<TerminalJob<TPayload, TResult>, BaseError>;
+        cancel: () => AsyncResult<JobSnapshot<TPayload, TResult>, BaseError>;
+    });
+    get(): AsyncResult<JobSnapshot<TPayload, TResult>, BaseError>;
+    wait(): AsyncResult<TerminalJob<TPayload, TResult>, BaseError>;
+    cancel(): AsyncResult<JobSnapshot<TPayload, TResult>, BaseError>;
+}
+export declare class ActiveJob<TPayload, TResult> {
+    #private;
+    readonly ref: JobRef<TPayload, TResult>;
+    readonly payload: TPayload;
+    constructor(ref: JobRef<TPayload, TResult>, payload: TPayload, cancelled: boolean | (() => boolean), impl: {
+        heartbeat: () => AsyncResult<void, BaseError>;
+        progress: (value: JobProgress) => AsyncResult<void, BaseError>;
+        log: (entry: JobLogEntry) => AsyncResult<void, BaseError>;
+        redeliveryCount?: number;
+    });
+    get cancelled(): boolean;
+    heartbeat(): AsyncResult<void, BaseError>;
+    progress(value: JobProgress): AsyncResult<void, BaseError>;
+    log(entry: JobLogEntry): AsyncResult<void, BaseError>;
+    redeliveryCount(): number;
+    isRedelivery(): boolean;
+}
+export declare class JobQueue<TPayload, TResult> {
+    #private;
+    constructor(impl: {
+        create: (payload: TPayload) => AsyncResult<JobRef<TPayload, TResult>, BaseError>;
+        handle: (handler: (job: ActiveJob<TPayload, TResult>) => Promise<Result<TResult, BaseError>>) => void;
+    });
+    create(payload: TPayload): AsyncResult<JobRef<TPayload, TResult>, BaseError>;
+    handle(handler: (job: ActiveJob<TPayload, TResult>) => Promise<Result<TResult, BaseError>>): void;
+}
+export interface JobWorkerHost {
+    stop(): AsyncResult<void, BaseError>;
+    join(): AsyncResult<void, BaseError>;
+}
+export declare class JobWorkerHostAdapter implements JobWorkerHost {
+    #private;
+    constructor(impl: {
+        stop: () => AsyncResult<void, BaseError>;
+        join: () => AsyncResult<void, BaseError>;
+    });
+    stop(): AsyncResult<void, BaseError>;
+    join(): AsyncResult<void, BaseError>;
+}
+export type JobsFacade = {};
+export type JobsFacadeOf<TJobs extends Record<string, JobTypeMetadata>> = {
+    [K in keyof TJobs]: JobQueue<TJobs[K]["payload"], TJobs[K]["result"]>;
+} & JobsFacade;
+//# sourceMappingURL=jobs.d.ts.map

package/esm/npm/src/jobs.d.ts.map

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