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

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

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../../src/codec.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,UAAU,EAEhB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAErD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAErE,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IACA,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,CAAC;AAUJ,wBAAgB,KAAK,CAAC,CAAC,SAAS,OAAO,EACrC,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,SAAS,GACd,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,eAAe,GAAG,eAAe,CAAC,CAU5D;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,UAAU,EAC9C,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,SAAS,GACd,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,GAAG,eAAe,CAAC,CAa/D;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,SAAS,GACd,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,CAAC,CAWpD;AAED,wBAAgB,MAAM,CAAC,CAAC,SAAS,OAAO,EACtC,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,OAAO,GACZ,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAAC,CAUnD;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,OAAO,GACZ,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAAC,CAWnD"}

package/esm/npm/src/codec.js

@@ -0,0 +1,73 @@
+import { unwrapSchema, } from "./contracts.js";
+import { Result } from "@qlever-llc/result";
+import { EncodeError, ParseError, Value } from "typebox/value";
+import { UnexpectedError, ValidationError } from "./errors/index.js";
+function parseWithSchema(schema, data) {
+    return Value.Parse(schema, data);
+}
+function encodeWithSchema(schema, data) {
+    return JSON.stringify(Value.Encode(schema, data));
+}
+export function parse(schema, data) {
+    try {
+        return Result.ok(parseWithSchema(schema, data));
+    }
+    catch (cause) {
+        if (cause instanceof ParseError) {
+            const errors = Value.Errors(schema, data);
+            return Result.err(new ValidationError({ errors, cause }));
+        }
+        return Result.err(new UnexpectedError({ cause }));
+    }
+}
+export function parseSchema(schema, data) {
+    const raw = unwrapSchema(schema);
+    try {
+        return Result.ok(parseWithSchema(raw, data));
+    }
+    catch (cause) {
+        if (cause instanceof ParseError) {
+            const errors = Value.Errors(raw, data);
+            return Result.err(new ValidationError({ errors, cause }));
+        }
+        return Result.err(new UnexpectedError({ cause }));
+    }
+}
+export function parseUnknownSchema(schema, data) {
+    const raw = unwrapSchema(schema);
+    try {
+        return Result.ok(parseWithSchema(raw, data));
+    }
+    catch (cause) {
+        if (cause instanceof ParseError) {
+            const errors = Value.Errors(raw, data);
+            return Result.err(new ValidationError({ errors, cause }));
+        }
+        return Result.err(new UnexpectedError({ cause }));
+    }
+}
+export function encode(schema, data) {
+    try {
+        return Result.ok(encodeWithSchema(schema, data));
+    }
+    catch (cause) {
+        if (cause instanceof EncodeError) {
+            const errors = Value.Errors(schema, data);
+            return Result.err(new ValidationError({ errors, cause }));
+        }
+        return Result.err(new UnexpectedError({ cause }));
+    }
+}
+export function encodeSchema(schema, data) {
+    const raw = unwrapSchema(schema);
+    try {
+        return Result.ok(encodeWithSchema(raw, data));
+    }
+    catch (cause) {
+        if (cause instanceof EncodeError) {
+            const errors = Value.Errors(raw, data);
+            return Result.err(new ValidationError({ errors, cause }));
+        }
+        return Result.err(new UnexpectedError({ cause }));
+    }
+}

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

@@ -0,0 +1,91 @@
+import type { NatsConnection } from "@nats-io/nats-core";
+import { type LoggerLike } from "./globals.js";
+/** Identifies the Trellis runtime that owns a connection. */
+export type TrellisConnectionKind = "client" | "device" | "service";
+/** Framework-neutral lifecycle phase for an observed Trellis transport. */
+export type TrellisConnectionPhase = "connected" | "disconnected" | "reconnecting" | "error" | "closed";
+/** Diagnostic metadata copied from the underlying transport without exposing raw handles. */
+export type TrellisConnectionTransportMetadata = {
+    readonly name?: string;
+    readonly event?: string;
+    readonly server?: string;
+    readonly data?: unknown;
+    readonly error?: unknown;
+};
+/** Current framework-neutral connection status. */
+export type TrellisConnectionStatus = {
+    readonly kind: TrellisConnectionKind;
+    readonly phase: TrellisConnectionPhase;
+    readonly observedAt: Date;
+    readonly transport?: TrellisConnectionTransportMetadata;
+};
+/** Receives connection status changes. */
+export type TrellisConnectionStatusListener = (status: TrellisConnectionStatus) => void;
+/** Narrow transport shape used by Trellis connection lifecycle observation. */
+export type TrellisConnectionStatusTransport = {
+    status?: () => AsyncIterable<unknown>;
+    closed: () => Promise<void | Error>;
+    close: () => Promise<void>;
+    isClosed?: () => boolean;
+    getServer?: () => string | undefined;
+};
+/** Options for constructing a manually controlled Trellis connection lifecycle. */
+export type TrellisConnectionOptions = {
+    kind: TrellisConnectionKind;
+    initialStatus?: TrellisConnectionStatus;
+    close?: () => Promise<void>;
+    stopObserving?: () => void;
+    log?: LoggerLike | false;
+};
+/** Options for observing a transport-backed Trellis connection lifecycle. */
+export type ObserveTrellisConnectionOptions = {
+    kind: TrellisConnectionKind;
+    transport: TrellisConnectionStatusTransport;
+    transportName?: string;
+    log?: LoggerLike | false;
+    lifecycleLog?: TrellisConnectionLifecycleLogOptions;
+};
+/** Options for observing a NATS-backed Trellis connection lifecycle. */
+export type ObserveNatsTrellisConnectionOptions = {
+    kind: TrellisConnectionKind;
+    nc: NatsConnection;
+    log?: LoggerLike | false;
+    lifecycleLog?: TrellisConnectionLifecycleLogOptions;
+};
+/** Options for logging transport lifecycle events with Trellis runtime context. */
+export type TrellisConnectionLifecycleLogOptions = {
+    log: LoggerLike;
+    context: Record<string, unknown>;
+};
+/**
+ * Framework-neutral Trellis connection lifecycle handle.
+ *
+ * The class stores the latest transport-neutral status, delivers it immediately
+ * to subscribers, and owns lifecycle cleanup without exposing raw transport
+ * handles to framework adapters.
+ */
+export declare class TrellisConnection {
+    #private;
+    /** Creates a Trellis connection lifecycle handle. */
+    constructor(options: TrellisConnectionOptions);
+    /** Returns the latest observed connection status. */
+    get status(): TrellisConnectionStatus;
+    /**
+     * Subscribes to status changes and immediately delivers the current status.
+     *
+     * The returned function removes the listener. Calling it more than once is
+     * safe.
+     */
+    subscribe(listener: TrellisConnectionStatusListener): () => void;
+    /** Stops status observation without closing the underlying transport. */
+    stopObserving(): void;
+    /** Closes the underlying transport and publishes a terminal closed status. */
+    close(): Promise<void>;
+    /** Publishes a new status to all active listeners. */
+    setStatus(status: TrellisConnectionStatus): void;
+}
+/** Observes a narrow transport status stream as a Trellis connection lifecycle. */
+export declare function observeTrellisConnection(options: ObserveTrellisConnectionOptions): TrellisConnection;
+/** Observes a NATS connection without exposing the raw NATS handle publicly. */
+export declare function observeNatsTrellisConnection(options: ObserveNatsTrellisConnectionOptions): TrellisConnection;
+//# sourceMappingURL=connection.d.ts.map

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

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

package/esm/npm/src/connection.js

@@ -0,0 +1,305 @@
+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 _TrellisConnection_status, _TrellisConnection_listeners, _TrellisConnection_closeTransport, _TrellisConnection_stopObserving, _TrellisConnection_log, _TrellisConnection_stopped;
+import { logger as noopLogger } from "./globals.js";
+/**
+ * Framework-neutral Trellis connection lifecycle handle.
+ *
+ * The class stores the latest transport-neutral status, delivers it immediately
+ * to subscribers, and owns lifecycle cleanup without exposing raw transport
+ * handles to framework adapters.
+ */
+export class TrellisConnection {
+    /** Creates a Trellis connection lifecycle handle. */
+    constructor(options) {
+        _TrellisConnection_status.set(this, void 0);
+        _TrellisConnection_listeners.set(this, new Set());
+        _TrellisConnection_closeTransport.set(this, void 0);
+        _TrellisConnection_stopObserving.set(this, void 0);
+        _TrellisConnection_log.set(this, void 0);
+        _TrellisConnection_stopped.set(this, false);
+        __classPrivateFieldSet(this, _TrellisConnection_status, options.initialStatus ??
+            createStatus(options.kind, "connected"), "f");
+        __classPrivateFieldSet(this, _TrellisConnection_closeTransport, options.close ?? (async () => { }), "f");
+        __classPrivateFieldSet(this, _TrellisConnection_stopObserving, options.stopObserving ?? (() => { }), "f");
+        __classPrivateFieldSet(this, _TrellisConnection_log, options.log === false ? noopLogger : options.log ?? noopLogger, "f");
+    }
+    /** Returns the latest observed connection status. */
+    get status() {
+        return __classPrivateFieldGet(this, _TrellisConnection_status, "f");
+    }
+    /**
+     * Subscribes to status changes and immediately delivers the current status.
+     *
+     * The returned function removes the listener. Calling it more than once is
+     * safe.
+     */
+    subscribe(listener) {
+        __classPrivateFieldGet(this, _TrellisConnection_listeners, "f").add(listener);
+        listener(__classPrivateFieldGet(this, _TrellisConnection_status, "f"));
+        return () => {
+            __classPrivateFieldGet(this, _TrellisConnection_listeners, "f").delete(listener);
+        };
+    }
+    /** Stops status observation without closing the underlying transport. */
+    stopObserving() {
+        if (__classPrivateFieldGet(this, _TrellisConnection_stopped, "f")) {
+            return;
+        }
+        __classPrivateFieldSet(this, _TrellisConnection_stopped, true, "f");
+        __classPrivateFieldGet(this, _TrellisConnection_stopObserving, "f").call(this);
+    }
+    /** Closes the underlying transport and publishes a terminal closed status. */
+    async close() {
+        this.stopObserving();
+        try {
+            await __classPrivateFieldGet(this, _TrellisConnection_closeTransport, "f").call(this);
+            this.setStatus(createStatus(__classPrivateFieldGet(this, _TrellisConnection_status, "f").kind, "closed"));
+        }
+        catch (error) {
+            this.setStatus(createStatus(__classPrivateFieldGet(this, _TrellisConnection_status, "f").kind, "error", { error }));
+            throw error;
+        }
+    }
+    /** Publishes a new status to all active listeners. */
+    setStatus(status) {
+        if (__classPrivateFieldGet(this, _TrellisConnection_stopped, "f") && status.phase !== "closed" && status.phase !== "error") {
+            return;
+        }
+        __classPrivateFieldSet(this, _TrellisConnection_status, status, "f");
+        __classPrivateFieldGet(this, _TrellisConnection_log, "f").debug({
+            kind: status.kind,
+            phase: status.phase,
+            transport: status.transport,
+        }, "Trellis connection status changed");
+        for (const listener of __classPrivateFieldGet(this, _TrellisConnection_listeners, "f")) {
+            listener(status);
+        }
+    }
+}
+_TrellisConnection_status = new WeakMap(), _TrellisConnection_listeners = new WeakMap(), _TrellisConnection_closeTransport = new WeakMap(), _TrellisConnection_stopObserving = new WeakMap(), _TrellisConnection_log = new WeakMap(), _TrellisConnection_stopped = new WeakMap();
+/** Observes a narrow transport status stream as a Trellis connection lifecycle. */
+export function observeTrellisConnection(options) {
+    let stopped = false;
+    const connection = new TrellisConnection({
+        kind: options.kind,
+        close: () => options.transport.close(),
+        stopObserving: () => {
+            stopped = true;
+        },
+        log: options.log,
+    });
+    const baseTransport = createTransportMetadata(options.transport, options.transportName);
+    const statusStream = options.transport.status;
+    if (typeof statusStream === "function") {
+        void (async () => {
+            try {
+                for await (const event of statusStream.call(options.transport)) {
+                    if (stopped) {
+                        return;
+                    }
+                    const status = statusFromTransportEvent(options.kind, event, baseTransport);
+                    if (status) {
+                        logTransportLifecycleEvent(options, event);
+                        connection.setStatus(status);
+                    }
+                }
+            }
+            catch (error) {
+                if (!stopped) {
+                    logTransportStatusWatcherFailure(options, error);
+                    connection.setStatus(createStatus(options.kind, "error", {
+                        ...baseTransport,
+                        error,
+                    }));
+                }
+            }
+        })();
+    }
+    void options.transport.closed().then((closedError) => {
+        if (stopped) {
+            return;
+        }
+        if (closedError instanceof Error) {
+            logTransportClosed(options, closedError);
+            connection.setStatus(createStatus(options.kind, "error", {
+                ...baseTransport,
+                error: closedError,
+            }));
+            return;
+        }
+        logTransportClosed(options);
+        connection.setStatus(createStatus(options.kind, "closed", baseTransport));
+    });
+    return connection;
+}
+/** Observes a NATS connection without exposing the raw NATS handle publicly. */
+export function observeNatsTrellisConnection(options) {
+    return observeTrellisConnection({
+        kind: options.kind,
+        transport: options.nc,
+        transportName: "nats",
+        log: options.log,
+        lifecycleLog: options.lifecycleLog,
+    });
+}
+function lifecycleLabel(kind) {
+    switch (kind) {
+        case "client":
+            return "Client";
+        case "device":
+            return "Device";
+        case "service":
+            return "Service";
+    }
+}
+function normalizeTransportError(error) {
+    const record = error;
+    return {
+        name: error.name,
+        message: error.message,
+        ...(typeof record.operation === "string"
+            ? { operation: record.operation }
+            : {}),
+        ...(typeof record.subject === "string" ? { subject: record.subject } : {}),
+        ...(typeof record.queue === "string" ? { queue: record.queue } : {}),
+    };
+}
+function normalizeTransportStatus(status) {
+    if (!status || typeof status !== "object") {
+        return { status };
+    }
+    const record = status;
+    return {
+        ...(typeof record.type === "string" ? { type: record.type } : {}),
+        ...(record.error instanceof Error
+            ? { error: normalizeTransportError(record.error) }
+            : {}),
+        ...(typeof record.data === "string" ? { data: record.data } : {}),
+        ...(record.data && typeof record.data === "object"
+            ? { data: record.data }
+            : {}),
+    };
+}
+function getNatsLifecycleLog(kind, event) {
+    if (!event || typeof event !== "object") {
+        return null;
+    }
+    const label = lifecycleLabel(kind);
+    switch (event.type) {
+        case "disconnect":
+            return { level: "warn", message: `${label} disconnected from NATS` };
+        case "reconnecting":
+            return { level: "warn", message: `${label} attempting NATS reconnect` };
+        case "forceReconnect":
+            return { level: "warn", message: `${label} forcing NATS reconnect` };
+        case "reconnect":
+            return { level: "info", message: `${label} reconnected to NATS` };
+        case "staleConnection":
+            return {
+                level: "warn",
+                message: `${label} NATS connection became stale`,
+            };
+        case "error":
+            return { level: "error", message: `${label} NATS error` };
+        default:
+            return null;
+    }
+}
+function logTransportLifecycleEvent(options, event) {
+    if (!options.lifecycleLog) {
+        return;
+    }
+    const lifecycleLog = getNatsLifecycleLog(options.kind, event);
+    if (!lifecycleLog) {
+        return;
+    }
+    options.lifecycleLog.log[lifecycleLog.level]({
+        ...options.lifecycleLog.context,
+        connection: normalizeTransportStatus(event),
+    }, lifecycleLog.message);
+}
+function logTransportStatusWatcherFailure(options, error) {
+    if (!options.lifecycleLog) {
+        return;
+    }
+    options.lifecycleLog.log.warn({ ...options.lifecycleLog.context, error }, `${lifecycleLabel(options.kind)} NATS status watcher failed`);
+}
+function logTransportClosed(options, error) {
+    if (!options.lifecycleLog) {
+        return;
+    }
+    const label = lifecycleLabel(options.kind);
+    if (error) {
+        options.lifecycleLog.log.error({ ...options.lifecycleLog.context, error }, `${label} NATS connection closed with error`);
+        return;
+    }
+    options.lifecycleLog.log.warn(options.lifecycleLog.context, `${label} NATS connection closed`);
+}
+function createStatus(kind, phase, transport) {
+    return {
+        kind,
+        phase,
+        observedAt: new Date(),
+        ...(transport ? { transport } : {}),
+    };
+}
+function createTransportMetadata(transport, name) {
+    return {
+        ...(name ? { name } : {}),
+        ...(typeof transport.getServer === "function"
+            ? { server: transport.getServer() }
+            : {}),
+    };
+}
+function statusFromTransportEvent(kind, event, baseTransport) {
+    const transportEvent = normalizeTransportEvent(event);
+    if (!transportEvent.type) {
+        return null;
+    }
+    const transport = {
+        ...baseTransport,
+        event: transportEvent.type,
+        ...(transportEvent.data === undefined ? {} : { data: transportEvent.data }),
+        ...(transportEvent.error === undefined
+            ? {}
+            : { error: transportEvent.error }),
+    };
+    switch (transportEvent.type) {
+        case "disconnect":
+        case "disconnected":
+            return createStatus(kind, "disconnected", transport);
+        case "reconnecting":
+        case "forceReconnect":
+        case "staleConnection":
+            return createStatus(kind, "reconnecting", transport);
+        case "reconnect":
+            return createStatus(kind, "connected", transport);
+        case "error":
+            return createStatus(kind, "error", transport);
+        case "closed":
+            return createStatus(kind, "closed", transport);
+        default:
+            return null;
+    }
+}
+function normalizeTransportEvent(event) {
+    if (!event || typeof event !== "object") {
+        return {};
+    }
+    const record = event;
+    return {
+        ...(typeof record.type === "string" ? { type: record.type } : {}),
+        ...("data" in record ? { data: record.data } : {}),
+        ...("error" in record ? { error: record.error } : {}),
+    };
+}

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

@@ -0,0 +1,20 @@
+import { type ContractApiViews, type ContractDependencyUse, type ContractExports, type ContractJobsMetadata, type ContractModule, type ContractState, type ContractStateKind, type ContractStateMetadata, type ContractStateStore, type ContractUseFn, type DefineContractInput, type DefinedContract as BaseDefinedContract, type EmptyApi, type SdkContractModule, type TrellisApiLike, type TrellisContractV1, type UseSpec } from "./contract_support/mod.js";
+export type DefinedContract<TOwnedApi extends {
+    rpc: Record<string, unknown>;
+    operations: Record<string, unknown>;
+    events: Record<string, unknown>;
+    subjects: Record<string, unknown>;
+}, TUsedApi extends {
+    rpc: Record<string, unknown>;
+    operations: Record<string, unknown>;
+    events: Record<string, unknown>;
+    subjects: Record<string, unknown>;
+}, TTrellisApi extends {
+    rpc: Record<string, unknown>;
+    operations: Record<string, unknown>;
+    events: Record<string, unknown>;
+    subjects: Record<string, unknown>;
+}, TContractId extends string = string, TJobs extends ContractJobsMetadata = {}, TState extends ContractStateMetadata = {}> = BaseDefinedContract<TOwnedApi, TUsedApi, TTrellisApi, TContractId, TJobs, TState>;
+export { defineAgentContract, defineAppContract, defineDeviceContract, defineServiceContract, } from "./contract_support/mod.js";
+export type { ContractApiViews, ContractDependencyUse, ContractExports, ContractModule, ContractState, ContractStateKind, ContractStateStore, ContractUseFn, DefineContractInput, EmptyApi, SdkContractModule, TrellisApiLike, TrellisContractV1, UseSpec, };
+//# sourceMappingURL=contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/contract.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,eAAe,IAAI,mBAAmB,EAC3C,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,OAAO,EACb,MAAM,2BAA2B,CAAC;AASnC,MAAM,MAAM,eAAe,CACzB,SAAS,SAAS;IAChB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,EACD,QAAQ,SAAS;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,EACD,WAAW,SAAS;IAClB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,EACD,WAAW,SAAS,MAAM,GAAG,MAAM,EACnC,KAAK,SAAS,oBAAoB,GAAG,EAAE,EACvC,MAAM,SAAS,qBAAqB,GAAG,EAAE,IACvC,mBAAmB,CACrB,SAAS,EACT,QAAQ,EACR,WAAW,EACX,WAAW,EACX,KAAK,EACL,MAAM,CACP,CAAC;AAEF,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,QAAQ,EACR,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,OAAO,GACR,CAAC"}

package/esm/npm/src/contract.js

@@ -0,0 +1 @@
+export { defineAgentContract, defineAppContract, defineDeviceContract, defineServiceContract, } from "./contract_support/mod.js";

package/esm/npm/src/contract_support/canonical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../../../../src/contract_support/canonical.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,SAAS,EAAE,GACX;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE/B,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAiB9D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAoBzD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAKnD;AAMD,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAsIxD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOnE;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAID"}