@nats-kit/rpc 0.3.0

package/dist/commonjs/errors.d.ts

@@ -0,0 +1,58 @@
+/**
+ * RPC error taxonomy (design §2.3, wire spec §4.5–§4.6).
+ *
+ * - `transport`: never touched the network (no-responders, timeout,
+ *   connection lost, local abort), synthesised entirely by the client.
+ * - `service`: an ADR-32 header error (`Nats-Service-Error-Code`) — bad
+ *   envelope, auth, or a server-side crash. Counted in micro's `num_errors`.
+ * - `domain`: an application outcome carried in the response BODY
+ *   (`{ok:false,error:{code,...}}`). Never touches micro's error counter.
+ */
+export type RpcErrorKind = "transport" | "service" | "domain";
+export interface RpcErrorInit {
+    code: string;
+    message: string;
+    kind: RpcErrorKind;
+    details?: unknown;
+    /** ADR-32 numeric code, present only when `kind === "service"`. */
+    serviceCode?: number;
+    subject?: string;
+    requestId?: string;
+    cause?: unknown;
+}
+/** The single error type every `RpcClient` method call rejects with. */
+export declare class RpcError extends Error {
+    readonly code: string;
+    readonly kind: RpcErrorKind;
+    readonly details?: unknown;
+    readonly serviceCode?: number;
+    readonly subject?: string;
+    readonly requestId?: string;
+    constructor(init: RpcErrorInit);
+}
+export declare function isRpcError(e: unknown): e is RpcError;
+export declare function isTransportError(e: unknown): e is RpcError;
+export declare function isDomainError<C extends string>(e: unknown, code?: C): e is RpcError;
+/** Reserved transport codes (§4.6) — never appear on the wire. */
+export declare const TRANSPORT_ERROR_CODES: {
+    readonly NO_RESPONDERS: "NO_RESPONDERS";
+    readonly TIMEOUT: "TIMEOUT";
+    readonly CONNECTION_LOST: "CONNECTION_LOST";
+    readonly ABORTED: "ABORTED";
+};
+/** Reserved service codes (§2.3) — the numeric-to-string mapping from §4.6. */
+export declare const SERVICE_ERROR_CODES: {
+    readonly BAD_REQUEST: "BAD_REQUEST";
+    readonly UNAUTHENTICATED: "UNAUTHENTICATED";
+    readonly FORBIDDEN: "FORBIDDEN";
+    readonly NOT_IMPLEMENTED: "NOT_IMPLEMENTED";
+    readonly INTERNAL: "INTERNAL";
+    readonly UNAVAILABLE: "UNAVAILABLE";
+    readonly MALFORMED_REPLY: "MALFORMED_REPLY";
+    readonly SERVICE_ERROR: "SERVICE_ERROR";
+};
+/** §4.6 client normalisation step (2): ADR-32 numeric code -> reserved string code. */
+export declare const SERVICE_CODE_BY_STATUS: Record<number, string>;
+/** Server-side reverse mapping: a domain/service code back to its wire status (§2.4). */
+export declare const STATUS_BY_SERVICE_CODE: Partial<Record<string, number>>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/commonjs/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE9D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wEAAwE;AACxE,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhB,IAAI,EAAE,YAAY;CAU/B;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,QAAQ,CAEpD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,QAAQ,CAE1D;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAC5C,CAAC,EAAE,OAAO,EACV,IAAI,CAAC,EAAE,CAAC,GACP,CAAC,IAAI,QAAQ,CAGf;AAED,kEAAkE;AAClE,eAAO,MAAM,qBAAqB;;;;;CAKxB,CAAC;AAEX,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB;;;;;;;;;CAStB,CAAC;AAEX,uFAAuF;AACvF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOzD,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,sBAAsB,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOlE,CAAC"}

package/dist/commonjs/errors.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STATUS_BY_SERVICE_CODE = exports.SERVICE_CODE_BY_STATUS = exports.SERVICE_ERROR_CODES = exports.TRANSPORT_ERROR_CODES = exports.RpcError = void 0;
+exports.isRpcError = isRpcError;
+exports.isTransportError = isTransportError;
+exports.isDomainError = isDomainError;
+/** The single error type every `RpcClient` method call rejects with. */
+class RpcError extends Error {
+    code;
+    kind;
+    details;
+    serviceCode;
+    subject;
+    requestId;
+    constructor(init) {
+        super(init.message, init.cause !== undefined ? { cause: init.cause } : undefined);
+        this.name = "RpcError";
+        this.code = init.code;
+        this.kind = init.kind;
+        this.details = init.details;
+        this.serviceCode = init.serviceCode;
+        this.subject = init.subject;
+        this.requestId = init.requestId;
+    }
+}
+exports.RpcError = RpcError;
+function isRpcError(e) {
+    return e instanceof RpcError;
+}
+function isTransportError(e) {
+    return isRpcError(e) && e.kind === "transport";
+}
+function isDomainError(e, code) {
+    if (!isRpcError(e) || e.kind !== "domain")
+        return false;
+    return code === undefined || e.code === code;
+}
+/** Reserved transport codes (§4.6) — never appear on the wire. */
+exports.TRANSPORT_ERROR_CODES = {
+    NO_RESPONDERS: "NO_RESPONDERS",
+    TIMEOUT: "TIMEOUT",
+    CONNECTION_LOST: "CONNECTION_LOST",
+    ABORTED: "ABORTED",
+};
+/** Reserved service codes (§2.3) — the numeric-to-string mapping from §4.6. */
+exports.SERVICE_ERROR_CODES = {
+    BAD_REQUEST: "BAD_REQUEST",
+    UNAUTHENTICATED: "UNAUTHENTICATED",
+    FORBIDDEN: "FORBIDDEN",
+    NOT_IMPLEMENTED: "NOT_IMPLEMENTED",
+    INTERNAL: "INTERNAL",
+    UNAVAILABLE: "UNAVAILABLE",
+    MALFORMED_REPLY: "MALFORMED_REPLY",
+    SERVICE_ERROR: "SERVICE_ERROR",
+};
+/** §4.6 client normalisation step (2): ADR-32 numeric code -> reserved string code. */
+exports.SERVICE_CODE_BY_STATUS = {
+    400: exports.SERVICE_ERROR_CODES.BAD_REQUEST,
+    401: exports.SERVICE_ERROR_CODES.UNAUTHENTICATED,
+    403: exports.SERVICE_ERROR_CODES.FORBIDDEN,
+    404: exports.SERVICE_ERROR_CODES.NOT_IMPLEMENTED,
+    500: exports.SERVICE_ERROR_CODES.INTERNAL,
+    503: exports.SERVICE_ERROR_CODES.UNAVAILABLE,
+};
+/** Server-side reverse mapping: a domain/service code back to its wire status (§2.4). */
+exports.STATUS_BY_SERVICE_CODE = {
+    [exports.SERVICE_ERROR_CODES.BAD_REQUEST]: 400,
+    [exports.SERVICE_ERROR_CODES.UNAUTHENTICATED]: 401,
+    [exports.SERVICE_ERROR_CODES.FORBIDDEN]: 403,
+    [exports.SERVICE_ERROR_CODES.NOT_IMPLEMENTED]: 404,
+    [exports.SERVICE_ERROR_CODES.INTERNAL]: 500,
+    [exports.SERVICE_ERROR_CODES.UNAVAILABLE]: 503,
+};
+//# sourceMappingURL=errors.js.map

package/dist/commonjs/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";;;AA6CA,gCAEC;AAED,4CAEC;AAED,sCAMC;AAnCD,wEAAwE;AACxE,MAAa,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAS;IACb,IAAI,CAAe;IACnB,OAAO,CAAW;IAClB,WAAW,CAAU;IACrB,OAAO,CAAU;IACjB,SAAS,CAAU;IAE5B,YAAY,IAAkB;QAC5B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAClF,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAClC,CAAC;CACF;AAlBD,4BAkBC;AAED,SAAgB,UAAU,CAAC,CAAU;IACnC,OAAO,CAAC,YAAY,QAAQ,CAAC;AAC/B,CAAC;AAED,SAAgB,gBAAgB,CAAC,CAAU;IACzC,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC;AACjD,CAAC;AAED,SAAgB,aAAa,CAC3B,CAAU,EACV,IAAQ;IAER,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACxD,OAAO,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC;AAC/C,CAAC;AAED,kEAAkE;AACrD,QAAA,qBAAqB,GAAG;IACnC,aAAa,EAAE,eAAe;IAC9B,OAAO,EAAE,SAAS;IAClB,eAAe,EAAE,iBAAiB;IAClC,OAAO,EAAE,SAAS;CACV,CAAC;AAEX,+EAA+E;AAClE,QAAA,mBAAmB,GAAG;IACjC,WAAW,EAAE,aAAa;IAC1B,eAAe,EAAE,iBAAiB;IAClC,SAAS,EAAE,WAAW;IACtB,eAAe,EAAE,iBAAiB;IAClC,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,aAAa;IAC1B,eAAe,EAAE,iBAAiB;IAClC,aAAa,EAAE,eAAe;CACtB,CAAC;AAEX,uFAAuF;AAC1E,QAAA,sBAAsB,GAA2B;IAC5D,GAAG,EAAE,2BAAmB,CAAC,WAAW;IACpC,GAAG,EAAE,2BAAmB,CAAC,eAAe;IACxC,GAAG,EAAE,2BAAmB,CAAC,SAAS;IAClC,GAAG,EAAE,2BAAmB,CAAC,eAAe;IACxC,GAAG,EAAE,2BAAmB,CAAC,QAAQ;IACjC,GAAG,EAAE,2BAAmB,CAAC,WAAW;CACrC,CAAC;AAEF,yFAAyF;AAC5E,QAAA,sBAAsB,GAAoC;IACrE,CAAC,2BAAmB,CAAC,WAAW,CAAC,EAAE,GAAG;IACtC,CAAC,2BAAmB,CAAC,eAAe,CAAC,EAAE,GAAG;IAC1C,CAAC,2BAAmB,CAAC,SAAS,CAAC,EAAE,GAAG;IACpC,CAAC,2BAAmB,CAAC,eAAe,CAAC,EAAE,GAAG;IAC1C,CAAC,2BAAmB,CAAC,QAAQ,CAAC,EAAE,GAAG;IACnC,CAAC,2BAAmB,CAAC,WAAW,CAAC,EAAE,GAAG;CACvC,CAAC"}

package/dist/commonjs/eslint/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ESLint flat-config snippet (design §2.8): a lint-level nudge, not a
+ * guarantee — `no-restricted-properties` is purely syntactic. Spread into a
+ * consumer's flat config:
+ *
+ * ```js
+ * import { rpcBoundaryRules } from "@nats-kit/rpc/eslint";
+ * export default [{ files: ["src/**\/*.ts"], rules: { ...rpcBoundaryRules } }];
+ * ```
+ */
+export declare const rpcBoundaryRules: {
+    "no-restricted-properties": (string | {
+        property: string;
+        message: string;
+        object?: undefined;
+    } | {
+        object: string;
+        property: string;
+        message: string;
+    })[];
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/commonjs/eslint/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/eslint/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;CAmB5B,CAAC"}

package/dist/commonjs/eslint/index.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rpcBoundaryRules = void 0;
+/**
+ * ESLint flat-config snippet (design §2.8): a lint-level nudge, not a
+ * guarantee — `no-restricted-properties` is purely syntactic. Spread into a
+ * consumer's flat config:
+ *
+ * ```js
+ * import { rpcBoundaryRules } from "@nats-kit/rpc/eslint";
+ * export default [{ files: ["src/**\/*.ts"], rules: { ...rpcBoundaryRules } }];
+ * ```
+ */
+exports.rpcBoundaryRules = {
+    "no-restricted-properties": [
+        "error",
+        {
+            property: "respondError",
+            message: "Return fail(...) or throw RpcError from an RPC handler; the rpc layer owns ADR-32 error headers.",
+        },
+        {
+            object: "nc",
+            property: "request",
+            message: "Use a typed createRpcClient() method instead of raw nc.request().",
+        },
+        {
+            object: "msg",
+            property: "respond",
+            message: "Raw msg.respond() bypasses the RPC envelope. Use an RPC handler.",
+        },
+    ],
+};
+//# sourceMappingURL=index.js.map

package/dist/commonjs/eslint/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/eslint/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACU,QAAA,gBAAgB,GAAG;IAC9B,0BAA0B,EAAE;QAC1B,OAAO;QACP;YACE,QAAQ,EAAE,cAAc;YACxB,OAAO,EACL,kGAAkG;SACrG;QACD;YACE,MAAM,EAAE,IAAI;YACZ,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,mEAAmE;SAC7E;QACD;YACE,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,kEAAkE;SAC5E;KACF;CACF,CAAC"}

package/dist/commonjs/events.d.ts

@@ -0,0 +1,55 @@
+import { type MsgHdrs, type NatsConnectionLike, type NatsConnectionRunner, type PubAck } from "@nats-kit/core";
+import { z } from "zod";
+/** A CloudEvents-shaped event definition (§2.5, §4.8). */
+export interface EventContract<T extends z.ZodType> {
+    /** `<app>.<entity>.<event>` — also the CloudEvents `type` and the subject. */
+    type: string;
+    /** CloudEvents `source`, e.g. "urn:anki:sandbox". */
+    source: string;
+    data: T;
+}
+export declare function defineEvent<T extends z.ZodType>(def: EventContract<T>): EventContract<T>;
+/**
+ * `publishEvent` needs a JetStream client to get a `PubAck` (design §2.5);
+ * `NatsConnectionLike` alone is Core-NATS-only, so we widen it with just the
+ * one extra accessor both `NatsConnectionRunner` and the NestJS `NatsService`
+ * (which delegates to it) already expose.
+ */
+export interface PublishEventOptions {
+    nats: NatsConnectionLike & Pick<NatsConnectionRunner, "getJetStream">;
+    /** CloudEvents `id` and `Nats-Msg-Id`. Defaults to a nuid. */
+    id?: string;
+    /** RFC3339. Defaults to `new Date().toISOString()`. */
+    time?: string;
+    /** CloudEvents optional `subject` attribute (a resource id, NOT the NATS subject). */
+    subject?: string;
+    traceparent?: string;
+    /** Override the publish subject. Defaults to `event.type`. */
+    natsSubject?: string;
+}
+interface CloudEventEnvelope<T> {
+    specversion: "1.0";
+    id: string;
+    source: string;
+    type: string;
+    time: string;
+    subject?: string;
+    datacontenttype: "application/json";
+    data: T;
+}
+export type CloudEvent<T> = CloudEventEnvelope<T>;
+/**
+ * Publish a CloudEvents 1.0 structured-mode envelope (§4.8) via JetStream,
+ * with `Nats-Msg-Id` set to the CloudEvents `id` for stream-level dedup.
+ */
+export declare function publishEvent<T extends z.ZodType>(event: EventContract<T>, data: z.input<T>, options: PublishEventOptions): Promise<PubAck>;
+/**
+ * Parse a received JetStream/Core message as a CloudEvents envelope,
+ * validating the full envelope (not just `data`) per §4.8.
+ */
+export declare function parseEvent<T extends z.ZodType>(event: EventContract<T>, msg: {
+    data: Uint8Array;
+    headers?: MsgHdrs;
+}): CloudEvent<z.output<T>>;
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/commonjs/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/events.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,MAAM,EACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,0DAA0D;AAC1D,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO;IAChD,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;CACT;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAExF;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAAC,oBAAoB,EAAE,cAAc,CAAC,CAAC;IACtE,8DAA8D;IAC9D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,kBAAkB,CAAC,CAAC;IAC5B,WAAW,EAAE,KAAK,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,kBAAkB,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAAC;AAuClD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EACpD,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAChB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAwBjB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAC5C,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,GAAG,EAAE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3C,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAKzB"}

package/dist/commonjs/events.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineEvent = defineEvent;
+exports.publishEvent = publishEvent;
+exports.parseEvent = parseEvent;
+const nuid_1 = require("@nats-io/nuid");
+const core_1 = require("@nats-kit/core");
+const zod_1 = require("zod");
+function defineEvent(def) {
+    return def;
+}
+/** Validates the envelope shape (§4.8) around an arbitrary `data` payload. */
+const CloudEventEnvelopeSchema = zod_1.z.object({
+    specversion: zod_1.z.literal("1.0"),
+    id: zod_1.z.string().min(1),
+    source: zod_1.z.string().min(1),
+    type: zod_1.z.string().min(1),
+    time: zod_1.z.string().min(1),
+    subject: zod_1.z.string().optional(),
+    datacontenttype: zod_1.z.literal("application/json"),
+    data: zod_1.z.unknown(),
+});
+/**
+ * JSON has no representation for `NaN`/`Infinity` — `JSON.stringify` silently
+ * turns them into `null`, which would silently corrupt an event's data on
+ * the wire. Walk the value and reject before that can happen.
+ */
+function assertJsonSafe(value, path = "$") {
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new Error(`publishEvent: non-finite number (${String(value)}) at ${path} is not valid JSON`);
+        }
+        return;
+    }
+    if (Array.isArray(value)) {
+        value.forEach((v, i) => assertJsonSafe(v, `${path}[${i}]`));
+        return;
+    }
+    if (value !== null && typeof value === "object") {
+        for (const [k, v] of Object.entries(value)) {
+            assertJsonSafe(v, `${path}.${k}`);
+        }
+    }
+}
+/**
+ * Publish a CloudEvents 1.0 structured-mode envelope (§4.8) via JetStream,
+ * with `Nats-Msg-Id` set to the CloudEvents `id` for stream-level dedup.
+ */
+async function publishEvent(event, data, options) {
+    const parsed = event.data.parse(data);
+    assertJsonSafe(parsed);
+    const id = options.id ?? nuid_1.nuid.next();
+    const envelope = {
+        specversion: "1.0",
+        id,
+        source: event.source,
+        type: event.type,
+        time: options.time ?? new Date().toISOString(),
+        subject: options.subject,
+        datacontenttype: "application/json",
+        data: parsed,
+    };
+    const h = (0, core_1.headers)();
+    if (options.traceparent !== undefined) {
+        h.set("traceparent", options.traceparent);
+    }
+    const body = new TextEncoder().encode(JSON.stringify(envelope));
+    await options.nats.waitForReady();
+    const js = options.nats.getJetStream();
+    return js.publish(options.natsSubject ?? event.type, body, { msgID: id, headers: h });
+}
+/**
+ * Parse a received JetStream/Core message as a CloudEvents envelope,
+ * validating the full envelope (not just `data`) per §4.8.
+ */
+function parseEvent(event, msg) {
+    const raw = JSON.parse(new TextDecoder().decode(msg.data));
+    const envelope = CloudEventEnvelopeSchema.parse(raw);
+    const data = event.data.parse(envelope.data);
+    return { ...envelope, data };
+}
+//# sourceMappingURL=events.js.map

package/dist/commonjs/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/events.ts"],"names":[],"mappings":";;AAmBA,kCAEC;AA2ED,oCA4BC;AAMD,gCAQC;AA1ID,wCAAqC;AACrC,yCAMwB;AACxB,6BAAwB;AAWxB,SAAgB,WAAW,CAAsB,GAAqB;IACpE,OAAO,GAAG,CAAC;AACb,CAAC;AAkCD,8EAA8E;AAC9E,MAAM,wBAAwB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,WAAW,EAAE,OAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC7B,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,eAAe,EAAE,OAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;IAC9C,IAAI,EAAE,OAAC,CAAC,OAAO,EAAE;CAClB,CAAC,CAAC;AAEH;;;;GAIG;AACH,SAAS,cAAc,CAAC,KAAc,EAAE,IAAI,GAAG,GAAG;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,oCAAoC,MAAM,CAAC,KAAK,CAAC,QAAQ,IAAI,oBAAoB,CAClF,CAAC;QACJ,CAAC;QACD,OAAO;IACT,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5D,OAAO;IACT,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,cAAc,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,YAAY,CAChC,KAAuB,EACvB,IAAgB,EAChB,OAA4B;IAE5B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,cAAc,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,WAAI,CAAC,IAAI,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAgC;QAC5C,WAAW,EAAE,KAAK;QAClB,EAAE;QACF,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC9C,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,eAAe,EAAE,kBAAkB;QACnC,IAAI,EAAE,MAAM;KACb,CAAC;IAEF,MAAM,CAAC,GAAY,IAAA,cAAY,GAAE,CAAC;IAClC,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACtC,CAAC,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChE,MAAM,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;IAClC,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;IACvC,OAAO,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,IAAI,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;AACxF,CAAC;AAED;;;GAGG;AACH,SAAgB,UAAU,CACxB,KAAuB,EACvB,GAA4C;IAE5C,MAAM,GAAG,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,wBAAwB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC/B,CAAC"}

package/dist/commonjs/headers.d.ts

@@ -0,0 +1,53 @@
+import { type MsgHdrs } from "@nats-kit/core";
+import { type RpcCaller } from "./types.js";
+/** Header names (D5, §4.2). Never mint a bare `Nats-*` header — that prefix is server/ADR-32 territory. */
+export declare const HEADER_REQUEST_ID = "Nk-Request-Id";
+export declare const HEADER_CALLER_KIND = "Nk-Caller-Kind";
+export declare const HEADER_CALLER_ID = "Nk-Caller-Id";
+export declare const HEADER_CALLER_ROLE = "Nk-Caller-Role";
+export declare const HEADER_DEADLINE = "Nk-Deadline";
+export declare const HEADER_CONTENT_TYPE = "Content-Type";
+export declare const HEADER_TRACEPARENT = "traceparent";
+export declare const HEADER_TRACESTATE = "tracestate";
+export declare const CONTENT_TYPE_JSON = "application/json";
+export interface BuildRequestHeadersInit {
+    requestId: string;
+    caller: RpcCaller;
+    deadlineMs?: number;
+    traceparent?: string;
+    tracestate?: string;
+    /** Extra `Nk-*` headers. `Nats-*` and reserved names are rejected by the caller (client.ts). */
+    extra?: Record<string, string>;
+}
+/** Build the request `MsgHdrs` per §4.2. */
+export declare function buildRequestHeaders(init: BuildRequestHeadersInit): MsgHdrs;
+/**
+ * Parse `Nk-Caller-Role` per §4.2: comma-separated, no spaces, absent/empty
+ * means an empty set. Guards the classic `"".split(",")` trap, which yields
+ * `[""]` rather than `[]`.
+ */
+export declare function parseRoles(headerValue: string | undefined | null): readonly string[];
+export declare function isValidRole(role: string): boolean;
+export declare function isValidRequestId(id: string): boolean;
+export interface ParsedRequestHeaders {
+    requestId: string;
+    callerKind: "user" | "service";
+    callerId?: string;
+    roles: readonly string[];
+    deadlineMs?: number;
+    traceparent?: string;
+}
+export type ParseHeadersResult = {
+    ok: true;
+    value: ParsedRequestHeaders;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * Parse and validate the required/conditional request headers per §4.2.
+ * Used by `createRpcServer` as dispatch step 1 (missing/malformed -> 400;
+ * `user` with no `Nk-Caller-Id` -> handled by the caller as 401).
+ */
+export declare function parseRequestHeaders(h: MsgHdrs | undefined): ParseHeadersResult;
+//# sourceMappingURL=headers.d.ts.map

package/dist/commonjs/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../../src/headers.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGvE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,2GAA2G;AAC3G,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AACjD,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAC/C,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAC7C,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAClD,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAChD,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAE9C,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AAKpD,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gGAAgG;IAChG,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,4CAA4C;AAC5C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CA0B1E;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,MAAM,EAAE,CAGpF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,GACzC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,kBAAkB,CAmD9E"}

package/dist/commonjs/headers.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONTENT_TYPE_JSON = exports.HEADER_TRACESTATE = exports.HEADER_TRACEPARENT = exports.HEADER_CONTENT_TYPE = exports.HEADER_DEADLINE = exports.HEADER_CALLER_ROLE = exports.HEADER_CALLER_ID = exports.HEADER_CALLER_KIND = exports.HEADER_REQUEST_ID = void 0;
+exports.buildRequestHeaders = buildRequestHeaders;
+exports.parseRoles = parseRoles;
+exports.isValidRole = isValidRole;
+exports.isValidRequestId = isValidRequestId;
+exports.parseRequestHeaders = parseRequestHeaders;
+const core_1 = require("@nats-kit/core");
+const nats_core_1 = require("@nats-io/nats-core");
+/** Header names (D5, §4.2). Never mint a bare `Nats-*` header — that prefix is server/ADR-32 territory. */
+exports.HEADER_REQUEST_ID = "Nk-Request-Id";
+exports.HEADER_CALLER_KIND = "Nk-Caller-Kind";
+exports.HEADER_CALLER_ID = "Nk-Caller-Id";
+exports.HEADER_CALLER_ROLE = "Nk-Caller-Role";
+exports.HEADER_DEADLINE = "Nk-Deadline";
+exports.HEADER_CONTENT_TYPE = "Content-Type";
+exports.HEADER_TRACEPARENT = "traceparent";
+exports.HEADER_TRACESTATE = "tracestate";
+exports.CONTENT_TYPE_JSON = "application/json";
+const ROLE_RE = /^[A-Za-z0-9_:-]{1,64}$/;
+const REQUEST_ID_RE = /^[A-Za-z0-9_-]{1,64}$/;
+/** Build the request `MsgHdrs` per §4.2. */
+function buildRequestHeaders(init) {
+    const h = (0, core_1.headers)();
+    h.set(exports.HEADER_CONTENT_TYPE, exports.CONTENT_TYPE_JSON);
+    h.set(exports.HEADER_REQUEST_ID, init.requestId);
+    h.set(exports.HEADER_CALLER_KIND, init.caller.kind);
+    if (init.caller.id !== undefined) {
+        h.set(exports.HEADER_CALLER_ID, init.caller.id);
+    }
+    if (init.caller.roles && init.caller.roles.length > 0) {
+        h.set(exports.HEADER_CALLER_ROLE, init.caller.roles.join(","));
+    }
+    if (init.deadlineMs !== undefined) {
+        h.set(exports.HEADER_DEADLINE, String(Math.trunc(init.deadlineMs)));
+    }
+    if (init.traceparent !== undefined) {
+        h.set(exports.HEADER_TRACEPARENT, init.traceparent);
+    }
+    if (init.tracestate !== undefined) {
+        h.set(exports.HEADER_TRACESTATE, init.tracestate);
+    }
+    if (init.extra) {
+        for (const [k, v] of Object.entries(init.extra)) {
+            h.set(k, v);
+        }
+    }
+    return h;
+}
+/**
+ * Parse `Nk-Caller-Role` per §4.2: comma-separated, no spaces, absent/empty
+ * means an empty set. Guards the classic `"".split(",")` trap, which yields
+ * `[""]` rather than `[]`.
+ */
+function parseRoles(headerValue) {
+    if (!headerValue)
+        return [];
+    return headerValue.split(",").filter((r) => r.length > 0);
+}
+function isValidRole(role) {
+    return ROLE_RE.test(role);
+}
+function isValidRequestId(id) {
+    return REQUEST_ID_RE.test(id);
+}
+/**
+ * Parse and validate the required/conditional request headers per §4.2.
+ * Used by `createRpcServer` as dispatch step 1 (missing/malformed -> 400;
+ * `user` with no `Nk-Caller-Id` -> handled by the caller as 401).
+ */
+function parseRequestHeaders(h) {
+    if (!h) {
+        return { ok: false, message: "missing required headers" };
+    }
+    const contentType = h.get(exports.HEADER_CONTENT_TYPE, nats_core_1.Match.IgnoreCase);
+    if (contentType && contentType !== exports.CONTENT_TYPE_JSON) {
+        return { ok: false, message: `unsupported ${exports.HEADER_CONTENT_TYPE}: "${contentType}"` };
+    }
+    const requestId = h.get(exports.HEADER_REQUEST_ID, nats_core_1.Match.IgnoreCase);
+    if (!requestId || !isValidRequestId(requestId)) {
+        return { ok: false, message: `missing or malformed ${exports.HEADER_REQUEST_ID}` };
+    }
+    const callerKind = h.get(exports.HEADER_CALLER_KIND, nats_core_1.Match.IgnoreCase);
+    if (callerKind !== "user" && callerKind !== "service") {
+        return { ok: false, message: `missing or invalid ${exports.HEADER_CALLER_KIND}` };
+    }
+    const rawCallerId = h.get(exports.HEADER_CALLER_ID, nats_core_1.Match.IgnoreCase) || undefined;
+    if (rawCallerId !== undefined && (rawCallerId.length < 1 || rawCallerId.length > 256)) {
+        return { ok: false, message: `${exports.HEADER_CALLER_ID} must be 1-256 chars` };
+    }
+    const callerId = rawCallerId;
+    const rawRoles = h.get(exports.HEADER_CALLER_ROLE, nats_core_1.Match.IgnoreCase);
+    const roles = parseRoles(rawRoles);
+    if (rawRoles) {
+        for (const role of roles) {
+            if (!isValidRole(role)) {
+                return { ok: false, message: `malformed role in ${exports.HEADER_CALLER_ROLE}: "${role}"` };
+            }
+        }
+    }
+    const rawDeadline = h.get(exports.HEADER_DEADLINE, nats_core_1.Match.IgnoreCase);
+    let deadlineMs;
+    if (rawDeadline) {
+        if (!/^\d+$/.test(rawDeadline)) {
+            return { ok: false, message: `malformed ${exports.HEADER_DEADLINE}` };
+        }
+        deadlineMs = Number(rawDeadline);
+    }
+    const traceparent = h.get(exports.HEADER_TRACEPARENT, nats_core_1.Match.IgnoreCase) || undefined;
+    return {
+        ok: true,
+        value: { requestId, callerKind, callerId, roles, deadlineMs, traceparent },
+    };
+}
+//# sourceMappingURL=headers.js.map

package/dist/commonjs/headers.js.map

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

package/dist/commonjs/index.d.ts

@@ -0,0 +1,15 @@
+export { defineService, method, methodSubject, serviceName, groupSubject, SUBJECT_SEGMENT_RE, } from "./contract.js";
+export type { RpcMethodDef, ServiceContract } from "./contract.js";
+export { createRpcClient } from "./client.js";
+export type { RpcCaller, RpcCallOptions, RpcClient, RpcClientOptions, } from "./types.js";
+export { createRpcServer, ok, fail, newRequestId } from "./server.js";
+export type { RpcContext, RpcResult, RpcHandlers, RpcAuthorize, RpcServerOptions, RpcServerHandle, } from "./types.js";
+export { RpcError, isRpcError, isDomainError, isTransportError, TRANSPORT_ERROR_CODES, SERVICE_ERROR_CODES, } from "./errors.js";
+export type { RpcErrorKind, RpcErrorInit } from "./errors.js";
+export { HEADER_REQUEST_ID, HEADER_CALLER_KIND, HEADER_CALLER_ID, HEADER_CALLER_ROLE, HEADER_DEADLINE, HEADER_CONTENT_TYPE, HEADER_TRACEPARENT, HEADER_TRACESTATE, CONTENT_TYPE_JSON, parseRoles, parseRequestHeaders, } from "./headers.js";
+export { defineEvent, publishEvent, parseEvent } from "./events.js";
+export type { EventContract, PublishEventOptions, CloudEvent } from "./events.js";
+export { defineKvValue } from "./kv.js";
+export type { KvValueContract } from "./kv.js";
+export { ServiceError } from "@nats-io/services";
+//# sourceMappingURL=index.d.ts.map

package/dist/commonjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,aAAa,EACb,MAAM,EACN,aAAa,EACb,WAAW,EACX,YAAY,EACZ,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGnE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EACV,SAAS,EACT,cAAc,EACd,SAAS,EACT,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,eAAe,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACtE,YAAY,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,QAAQ,EACR,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI9D,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACpE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGlF,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/commonjs/index.js

@@ -0,0 +1,61 @@
+"use strict";
+// Public surface of @nats-kit/rpc — typed request/reply RPC over NATS,
+// built on @nats-io/services (ADR-32) with a reconnect supervisor.
+//
+// See docs/spec/nats-kit-wire-spec.md for the language-neutral wire spec this
+// package implements (mirrors design doc §4).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceError = exports.defineKvValue = exports.parseEvent = exports.publishEvent = exports.defineEvent = exports.parseRequestHeaders = exports.parseRoles = exports.CONTENT_TYPE_JSON = exports.HEADER_TRACESTATE = exports.HEADER_TRACEPARENT = exports.HEADER_CONTENT_TYPE = exports.HEADER_DEADLINE = exports.HEADER_CALLER_ROLE = exports.HEADER_CALLER_ID = exports.HEADER_CALLER_KIND = exports.HEADER_REQUEST_ID = exports.SERVICE_ERROR_CODES = exports.TRANSPORT_ERROR_CODES = exports.isTransportError = exports.isDomainError = exports.isRpcError = exports.RpcError = exports.newRequestId = exports.fail = exports.ok = exports.createRpcServer = exports.createRpcClient = exports.SUBJECT_SEGMENT_RE = exports.groupSubject = exports.serviceName = exports.methodSubject = exports.method = exports.defineService = void 0;
+// Contract
+var contract_js_1 = require("./contract.js");
+Object.defineProperty(exports, "defineService", { enumerable: true, get: function () { return contract_js_1.defineService; } });
+Object.defineProperty(exports, "method", { enumerable: true, get: function () { return contract_js_1.method; } });
+Object.defineProperty(exports, "methodSubject", { enumerable: true, get: function () { return contract_js_1.methodSubject; } });
+Object.defineProperty(exports, "serviceName", { enumerable: true, get: function () { return contract_js_1.serviceName; } });
+Object.defineProperty(exports, "groupSubject", { enumerable: true, get: function () { return contract_js_1.groupSubject; } });
+Object.defineProperty(exports, "SUBJECT_SEGMENT_RE", { enumerable: true, get: function () { return contract_js_1.SUBJECT_SEGMENT_RE; } });
+// Client
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "createRpcClient", { enumerable: true, get: function () { return client_js_1.createRpcClient; } });
+// Server
+var server_js_1 = require("./server.js");
+Object.defineProperty(exports, "createRpcServer", { enumerable: true, get: function () { return server_js_1.createRpcServer; } });
+Object.defineProperty(exports, "ok", { enumerable: true, get: function () { return server_js_1.ok; } });
+Object.defineProperty(exports, "fail", { enumerable: true, get: function () { return server_js_1.fail; } });
+Object.defineProperty(exports, "newRequestId", { enumerable: true, get: function () { return server_js_1.newRequestId; } });
+// Errors
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "RpcError", { enumerable: true, get: function () { return errors_js_1.RpcError; } });
+Object.defineProperty(exports, "isRpcError", { enumerable: true, get: function () { return errors_js_1.isRpcError; } });
+Object.defineProperty(exports, "isDomainError", { enumerable: true, get: function () { return errors_js_1.isDomainError; } });
+Object.defineProperty(exports, "isTransportError", { enumerable: true, get: function () { return errors_js_1.isTransportError; } });
+Object.defineProperty(exports, "TRANSPORT_ERROR_CODES", { enumerable: true, get: function () { return errors_js_1.TRANSPORT_ERROR_CODES; } });
+Object.defineProperty(exports, "SERVICE_ERROR_CODES", { enumerable: true, get: function () { return errors_js_1.SERVICE_ERROR_CODES; } });
+// Headers (exposed for consumers building their own low-level tooling, e.g.
+// the interop test harness or a Go-side test client written in TS).
+var headers_js_1 = require("./headers.js");
+Object.defineProperty(exports, "HEADER_REQUEST_ID", { enumerable: true, get: function () { return headers_js_1.HEADER_REQUEST_ID; } });
+Object.defineProperty(exports, "HEADER_CALLER_KIND", { enumerable: true, get: function () { return headers_js_1.HEADER_CALLER_KIND; } });
+Object.defineProperty(exports, "HEADER_CALLER_ID", { enumerable: true, get: function () { return headers_js_1.HEADER_CALLER_ID; } });
+Object.defineProperty(exports, "HEADER_CALLER_ROLE", { enumerable: true, get: function () { return headers_js_1.HEADER_CALLER_ROLE; } });
+Object.defineProperty(exports, "HEADER_DEADLINE", { enumerable: true, get: function () { return headers_js_1.HEADER_DEADLINE; } });
+Object.defineProperty(exports, "HEADER_CONTENT_TYPE", { enumerable: true, get: function () { return headers_js_1.HEADER_CONTENT_TYPE; } });
+Object.defineProperty(exports, "HEADER_TRACEPARENT", { enumerable: true, get: function () { return headers_js_1.HEADER_TRACEPARENT; } });
+Object.defineProperty(exports, "HEADER_TRACESTATE", { enumerable: true, get: function () { return headers_js_1.HEADER_TRACESTATE; } });
+Object.defineProperty(exports, "CONTENT_TYPE_JSON", { enumerable: true, get: function () { return headers_js_1.CONTENT_TYPE_JSON; } });
+Object.defineProperty(exports, "parseRoles", { enumerable: true, get: function () { return headers_js_1.parseRoles; } });
+Object.defineProperty(exports, "parseRequestHeaders", { enumerable: true, get: function () { return headers_js_1.parseRequestHeaders; } });
+// Events
+var events_js_1 = require("./events.js");
+Object.defineProperty(exports, "defineEvent", { enumerable: true, get: function () { return events_js_1.defineEvent; } });
+Object.defineProperty(exports, "publishEvent", { enumerable: true, get: function () { return events_js_1.publishEvent; } });
+Object.defineProperty(exports, "parseEvent", { enumerable: true, get: function () { return events_js_1.parseEvent; } });
+// KV
+var kv_js_1 = require("./kv.js");
+Object.defineProperty(exports, "defineKvValue", { enumerable: true, get: function () { return kv_js_1.defineKvValue; } });
+// Re-export the ADR-32 error class from `@nats-io/services` so consumers can
+// `instanceof`-check it without a direct dependency (mirrors the core
+// barrel's `@nats-io/*` re-export rule).
+var services_1 = require("@nats-io/services");
+Object.defineProperty(exports, "ServiceError", { enumerable: true, get: function () { return services_1.ServiceError; } });
+//# sourceMappingURL=index.js.map

package/dist/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,uEAAuE;AACvE,mEAAmE;AACnE,EAAE;AACF,8EAA8E;AAC9E,8CAA8C;;;AAE9C,WAAW;AACX,6CAOuB;AANrB,4GAAA,aAAa,OAAA;AACb,qGAAA,MAAM,OAAA;AACN,4GAAA,aAAa,OAAA;AACb,0GAAA,WAAW,OAAA;AACX,2GAAA,YAAY,OAAA;AACZ,iHAAA,kBAAkB,OAAA;AAIpB,SAAS;AACT,yCAA8C;AAArC,4GAAA,eAAe,OAAA;AAQxB,SAAS;AACT,yCAAsE;AAA7D,4GAAA,eAAe,OAAA;AAAE,+FAAA,EAAE,OAAA;AAAE,iGAAA,IAAI,OAAA;AAAE,yGAAA,YAAY,OAAA;AAUhD,SAAS;AACT,yCAOqB;AANnB,qGAAA,QAAQ,OAAA;AACR,uGAAA,UAAU,OAAA;AACV,0GAAA,aAAa,OAAA;AACb,6GAAA,gBAAgB,OAAA;AAChB,kHAAA,qBAAqB,OAAA;AACrB,gHAAA,mBAAmB,OAAA;AAIrB,4EAA4E;AAC5E,oEAAoE;AACpE,2CAYsB;AAXpB,+GAAA,iBAAiB,OAAA;AACjB,gHAAA,kBAAkB,OAAA;AAClB,8GAAA,gBAAgB,OAAA;AAChB,gHAAA,kBAAkB,OAAA;AAClB,6GAAA,eAAe,OAAA;AACf,iHAAA,mBAAmB,OAAA;AACnB,gHAAA,kBAAkB,OAAA;AAClB,+GAAA,iBAAiB,OAAA;AACjB,+GAAA,iBAAiB,OAAA;AACjB,wGAAA,UAAU,OAAA;AACV,iHAAA,mBAAmB,OAAA;AAGrB,SAAS;AACT,yCAAoE;AAA3D,wGAAA,WAAW,OAAA;AAAE,yGAAA,YAAY,OAAA;AAAE,uGAAA,UAAU,OAAA;AAG9C,KAAK;AACL,iCAAwC;AAA/B,sGAAA,aAAa,OAAA;AAGtB,6EAA6E;AAC7E,sEAAsE;AACtE,yCAAyC;AACzC,8CAAiD;AAAxC,wGAAA,YAAY,OAAA"}