@znight/messaging 0.0.0-stage → 0.1.1

package/dist/async-CFh_bvex.mjs

@@ -0,0 +1,216 @@
+import { ErrorCode, ZnightError } from "@znight/core";
+// src/errors.ts
+const NON_RETRYABLE = Symbol.for("znight.messaging.nonRetryable");
+/**
+* Thrown by a handler to dead-letter the message immediately, without further attempts (invalid
+* business data, permanent failure...). Subclass it for domain errors.
+*
+* ```ts
+* if (order.total < 0) throw new NonRetryableError('Negative order total')
+* ```
+*/
+var NonRetryableError = class extends Error {
+	constructor(message, options) {
+		super(message, options);
+		this.name = "NonRetryableError";
+	}
+};
+Object.defineProperty(NonRetryableError.prototype, NON_RETRYABLE, { value: true });
+/**
+* Whether retrying `error` is pointless: a {@link NonRetryableError} (also recognised across copies of
+* this package, through a global symbol brand).
+*/
+function isNonRetryable(error) {
+	return error instanceof NonRetryableError || error !== null && typeof error === "object" && error[NON_RETRYABLE] === true;
+}
+/** The payload does not match the `@Message(schema)` of the handler. Never retried. */
+var MessageValidationError = class extends NonRetryableError {
+	issues;
+	constructor(label, issues) {
+		super(`Invalid ${label}: ${formatIssues(issues)}`);
+		this.name = "MessageValidationError";
+		this.issues = issues;
+	}
+};
+/** The body cannot be decoded (malformed JSON...). Never retried. */
+var MessageDecodeError = class extends NonRetryableError {
+	constructor(message, options) {
+		super(message, options);
+		this.name = "MessageDecodeError";
+	}
+};
+/** No `@OnMessage` handler of the consumer matches the message type. Never retried. */
+var NoHandlerError = class extends NonRetryableError {
+	messageType;
+	constructor(consumer, type) {
+		super(type === void 0 ? `${consumer} has no default @OnMessage() handler for a message without type` : `${consumer} has no @OnMessage handler for message type "${type}"`);
+		this.name = "NoHandlerError";
+		this.messageType = type;
+	}
+};
+/** A delivery arrived after its last allowed attempt (e.g. redelivered after a dead-letter failure). */
+var AttemptsExhaustedError = class extends NonRetryableError {
+	constructor(attempt, maxAttempts) {
+		super(`Delivery attempt ${attempt} exceeds the ${maxAttempts} attempt(s) allowed by the retry policy`);
+		this.name = "AttemptsExhaustedError";
+	}
+};
+function formatIssues(issues) {
+	const shown = issues.slice(0, 5).map((issue) => issue.path === "" ? issue.message : `${issue.path}: ${issue.message}`);
+	const more = issues.length > 5 ? ` (+${issues.length - 5} more)` : "";
+	return `${shown.join("; ")}${more}`;
+}
+/** A messaging configuration error (ZNIGHT011): invalid consumer, retry policy, driver options... */
+function consumerError(message, hints) {
+	return new ZnightError(ErrorCode.InvalidConsumer, message, hints === void 0 ? {} : { hints });
+}
+/** An operation on the broker or a driver that is not available (not connected, closed...). */
+function brokerUnavailableError(message, cause) {
+	return new ZnightError(ErrorCode.LifecycleFailed, message, cause === void 0 ? {} : { cause });
+}
+// src/headers.ts
+/**
+* Header names used by Znight on the wire. They are plain message headers (AMQP headers, SQS message
+* attributes, Kafka record headers), so non-Znight producers and consumers can read and write them.
+*/
+const MessagingHeaders = Object.freeze({
+	Id: "x-znight-id",
+	Type: "x-znight-type",
+	ContentType: "content-type",
+	Attempt: "x-znight-attempt",
+	NotBefore: "x-znight-not-before",
+	Encoding: "x-znight-encoding",
+	DeadLetterReason: "x-znight-dead-letter-reason",
+	Error: "x-znight-error",
+	OriginalQueue: "x-znight-original-queue",
+	Attempts: "x-znight-attempts",
+	ConsumerGroup: "x-znight-consumer-group"
+});
+/** A record safe to fill with untrusted keys (`__proto__` is stored as a regular key). */
+function headerRecord() {
+	return Object.create(null);
+}
+/**
+* Reads a header: exact name first, then a case-insensitive match. Used by the code generated for
+* `@Headers('name')` parameters.
+*/
+function messageHeader(message, name) {
+	const headers = message.headers;
+	if (Object.hasOwn(headers, name)) return headers[name];
+	const lower = name.toLowerCase();
+	for (const key of Object.keys(headers)) if (key.toLowerCase() === lower) return headers[key];
+}
+/** Parses the {@link MessagingHeaders.Attempt} header: a positive integer, `1` when absent or invalid. */
+function attemptFromHeaders(headers) {
+	const value = Object.hasOwn(headers, MessagingHeaders.Attempt) ? headers[MessagingHeaders.Attempt] : void 0;
+	if (value === void 0) return 1;
+	const attempt = Number(value);
+	return Number.isSafeInteger(attempt) && attempt >= 1 ? attempt : 1;
+}
+// src/internal/async.ts
+/** Internal async helpers (not part of the public API). */
+/** Rejection reason of operations interrupted by an `AbortSignal`. */
+var AbortedError = class extends Error {
+	constructor(message = "The operation was aborted") {
+		super(message);
+		this.name = "AbortError";
+	}
+};
+/**
+* Longest delay of one timer (2^31 - 1 ms, about 24.8 days): longer `setTimeout` delays overflow and
+* fire after 1 ms. Longer waits chain several timers.
+*/
+const MAX_TIMER_DELAY_MS = 2147483647;
+/**
+* Resolves after `ms` milliseconds (any duration: long waits chain timers), or rejects with
+* {@link AbortedError} as soon as `signal` aborts.
+*/
+function sleep(ms, signal) {
+	if (signal?.aborted === true) return Promise.reject(new AbortedError());
+	if (ms <= 0 && signal === void 0) return Promise.resolve();
+	return new Promise((resolve, reject) => {
+		let timer;
+		const onAbort = () => {
+			clearTimeout(timer);
+			reject(new AbortedError());
+		};
+		const arm = (remaining) => {
+			const wait = Math.min(remaining, MAX_TIMER_DELAY_MS);
+			timer = setTimeout(() => {
+				if (remaining > wait) return arm(remaining - wait);
+				signal?.removeEventListener("abort", onAbort);
+				resolve();
+			}, wait);
+		};
+		arm(ms);
+		signal?.addEventListener("abort", onAbort, { once: true });
+	});
+}
+/**
+* Counting semaphore. `acquire()` resolves when a permit is available, in FIFO order, or rejects with
+* {@link AbortedError} when `signal` aborts while waiting.
+*/
+var Semaphore = class {
+	#available;
+	#waiters = [];
+	constructor(permits) {
+		this.#available = permits;
+	}
+	/** Permits currently available. */
+	get available() {
+		return this.#available;
+	}
+	/** Number of callers waiting for a permit. */
+	get waiting() {
+		return this.#waiters.length;
+	}
+	acquire(signal) {
+		if (signal?.aborted === true) return Promise.reject(new AbortedError());
+		if (this.#available > 0) {
+			this.#available--;
+			return Promise.resolve();
+		}
+		return new Promise((resolve, reject) => {
+			const waiter = {
+				resolve: () => {
+					signal?.removeEventListener("abort", onAbort);
+					resolve();
+				},
+				reject
+			};
+			const onAbort = () => {
+				const index = this.#waiters.indexOf(waiter);
+				if (index !== -1) this.#waiters.splice(index, 1);
+				reject(new AbortedError());
+			};
+			this.#waiters.push(waiter);
+			signal?.addEventListener("abort", onAbort, { once: true });
+		});
+	}
+	release() {
+		const next = this.#waiters.shift();
+		if (next === void 0) this.#available++;
+		else next.resolve();
+	}
+};
+/** Message of any thrown value. */
+function errorMessage(error) {
+	if (error instanceof Error) return error.message;
+	if (typeof error === "string") return error;
+	try {
+		return String(error);
+	} catch {
+		return Object.prototype.toString.call(error);
+	}
+}
+/** Truncates `text` to `max` characters (with an ellipsis). */
+function truncate(text, max) {
+	return text.length <= max ? text : `${text.slice(0, Math.max(0, max - 1))}…`;
+}
+/** Whether `value` is a positive integer. */
+function isPositiveInteger(value) {
+	return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+export { consumerError as _, sleep as a, attemptFromHeaders as c, AttemptsExhaustedError as d, MessageDecodeError as f, brokerUnavailableError as g, NonRetryableError as h, isPositiveInteger as i, headerRecord as l, NoHandlerError as m, Semaphore as n, truncate as o, MessageValidationError as p, errorMessage as r, MessagingHeaders as s, MAX_TIMER_DELAY_MS as t, messageHeader as u, isNonRetryable as v };
+
+//# sourceMappingURL=async-CFh_bvex.mjs.map

package/dist/async-CFh_bvex.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-CFh_bvex.mjs","names":[],"sources":["../src/errors.ts","../src/headers.ts","../src/internal/async.ts"],"sourcesContent":["import { ErrorCode, ZnightError } from '@znight/core'\n\nconst NON_RETRYABLE = Symbol.for('znight.messaging.nonRetryable')\n\n/**\n * Thrown by a handler to dead-letter the message immediately, without further attempts (invalid\n * business data, permanent failure...). Subclass it for domain errors.\n *\n * ```ts\n * if (order.total < 0) throw new NonRetryableError('Negative order total')\n * ```\n */\nexport class NonRetryableError extends Error {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options)\n    this.name = 'NonRetryableError'\n  }\n}\nObject.defineProperty(NonRetryableError.prototype, NON_RETRYABLE, { value: true })\n\n/**\n * Whether retrying `error` is pointless: a {@link NonRetryableError} (also recognised across copies of\n * this package, through a global symbol brand).\n */\nexport function isNonRetryable(error: unknown): boolean {\n  return (\n    error instanceof NonRetryableError ||\n    (error !== null && typeof error === 'object' && (error as Record<symbol, unknown>)[NON_RETRYABLE] === true)\n  )\n}\n\n/** One failed check of a `@Message(schema)` validation. */\nexport interface MessageValidationIssue {\n  /** Dotted path of the invalid value (`items.0.quantity`), empty for the root. */\n  readonly path: string\n  readonly message: string\n}\n\n/** The payload does not match the `@Message(schema)` of the handler. Never retried. */\nexport class MessageValidationError extends NonRetryableError {\n  readonly issues: readonly MessageValidationIssue[]\n\n  constructor(label: string, issues: readonly MessageValidationIssue[]) {\n    super(`Invalid ${label}: ${formatIssues(issues)}`)\n    this.name = 'MessageValidationError'\n    this.issues = issues\n  }\n}\n\n/** The body cannot be decoded (malformed JSON...). Never retried. */\nexport class MessageDecodeError extends NonRetryableError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options)\n    this.name = 'MessageDecodeError'\n  }\n}\n\n/** No `@OnMessage` handler of the consumer matches the message type. Never retried. */\nexport class NoHandlerError extends NonRetryableError {\n  readonly messageType: string | undefined\n\n  constructor(consumer: string, type: string | undefined) {\n    super(\n      type === undefined\n        ? `${consumer} has no default @OnMessage() handler for a message without type`\n        : `${consumer} has no @OnMessage handler for message type \"${type}\"`,\n    )\n    this.name = 'NoHandlerError'\n    this.messageType = type\n  }\n}\n\n/** A delivery arrived after its last allowed attempt (e.g. redelivered after a dead-letter failure). */\nexport class AttemptsExhaustedError extends NonRetryableError {\n  constructor(attempt: number, maxAttempts: number) {\n    super(`Delivery attempt ${attempt} exceeds the ${maxAttempts} attempt(s) allowed by the retry policy`)\n    this.name = 'AttemptsExhaustedError'\n  }\n}\n\nfunction formatIssues(issues: readonly MessageValidationIssue[]): string {\n  const shown = issues.slice(0, 5).map(issue => (issue.path === '' ? issue.message : `${issue.path}: ${issue.message}`))\n  const more = issues.length > 5 ? ` (+${issues.length - 5} more)` : ''\n  return `${shown.join('; ')}${more}`\n}\n\n/** A messaging configuration error (ZNIGHT011): invalid consumer, retry policy, driver options... */\nexport function consumerError(message: string, hints?: readonly string[]): ZnightError {\n  return new ZnightError(ErrorCode.InvalidConsumer, message, hints === undefined ? {} : { hints })\n}\n\n/** An operation on the broker or a driver that is not available (not connected, closed...). */\nexport function brokerUnavailableError(message: string, cause?: unknown): ZnightError {\n  return new ZnightError(ErrorCode.LifecycleFailed, message, cause === undefined ? {} : { cause })\n}\n","/**\n * Header names used by Znight on the wire. They are plain message headers (AMQP headers, SQS message\n * attributes, Kafka record headers), so non-Znight producers and consumers can read and write them.\n */\nexport const MessagingHeaders: {\n  /** Znight message id (Kafka and SQS; AMQP uses the `message-id` property). */\n  readonly Id: 'x-znight-id'\n  /** Message type used to select the handler (Kafka and SQS; AMQP uses the `type` property). */\n  readonly Type: 'x-znight-type'\n  /** Content type of the body (Kafka and SQS; AMQP uses the `content-type` property). */\n  readonly ContentType: 'content-type'\n  /** 1-based attempt number carried by republished retries (RabbitMQ, Kafka). */\n  readonly Attempt: 'x-znight-attempt'\n  /** Epoch milliseconds before which a Kafka retry record must not be processed. */\n  readonly NotBefore: 'x-znight-not-before'\n  /** Body encoding when the transport only carries text (SQS: `base64` for binary payloads). */\n  readonly Encoding: 'x-znight-encoding'\n  /** Why the message was dead-lettered (`DeadLetterReason`). */\n  readonly DeadLetterReason: 'x-znight-dead-letter-reason'\n  /** Message of the error that dead-lettered the message (truncated). */\n  readonly Error: 'x-znight-error'\n  /** Queue the dead-lettered message was consumed from. */\n  readonly OriginalQueue: 'x-znight-original-queue'\n  /** Number of attempts made before the message was dead-lettered. */\n  readonly Attempts: 'x-znight-attempts'\n  /** Kafka consumer group that dead-lettered the record. */\n  readonly ConsumerGroup: 'x-znight-consumer-group'\n} = Object.freeze({\n  Id: 'x-znight-id',\n  Type: 'x-znight-type',\n  ContentType: 'content-type',\n  Attempt: 'x-znight-attempt',\n  NotBefore: 'x-znight-not-before',\n  Encoding: 'x-znight-encoding',\n  DeadLetterReason: 'x-znight-dead-letter-reason',\n  Error: 'x-znight-error',\n  OriginalQueue: 'x-znight-original-queue',\n  Attempts: 'x-znight-attempts',\n  ConsumerGroup: 'x-znight-consumer-group',\n})\n\n/** A record safe to fill with untrusted keys (`__proto__` is stored as a regular key). */\nexport function headerRecord(): Record<string, string> {\n  return Object.create(null) as Record<string, string>\n}\n\n/**\n * Reads a header: exact name first, then a case-insensitive match. Used by the code generated for\n * `@Headers('name')` parameters.\n */\nexport function messageHeader(\n  message: { readonly headers: Readonly<Record<string, string>> },\n  name: string,\n): string | undefined {\n  const headers = message.headers\n  if (Object.hasOwn(headers, name)) return headers[name]\n  const lower = name.toLowerCase()\n  for (const key of Object.keys(headers)) {\n    if (key.toLowerCase() === lower) return headers[key]\n  }\n  return undefined\n}\n\n/** Parses the {@link MessagingHeaders.Attempt} header: a positive integer, `1` when absent or invalid. */\nexport function attemptFromHeaders(headers: Readonly<Record<string, string>>): number {\n  const value = Object.hasOwn(headers, MessagingHeaders.Attempt) ? headers[MessagingHeaders.Attempt] : undefined\n  if (value === undefined) return 1\n  const attempt = Number(value)\n  return Number.isSafeInteger(attempt) && attempt >= 1 ? attempt : 1\n}\n","/** Internal async helpers (not part of the public API). */\n\n/** Rejection reason of operations interrupted by an `AbortSignal`. */\nexport class AbortedError extends Error {\n  constructor(message = 'The operation was aborted') {\n    super(message)\n    this.name = 'AbortError'\n  }\n}\n\n/**\n * Longest delay of one timer (2^31 - 1 ms, about 24.8 days): longer `setTimeout` delays overflow and\n * fire after 1 ms. Longer waits chain several timers.\n */\nexport const MAX_TIMER_DELAY_MS = 2_147_483_647\n\n/**\n * Resolves after `ms` milliseconds (any duration: long waits chain timers), or rejects with\n * {@link AbortedError} as soon as `signal` aborts.\n */\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  if (signal?.aborted === true) return Promise.reject(new AbortedError())\n  if (ms <= 0 && signal === undefined) return Promise.resolve()\n  return new Promise((resolve, reject) => {\n    let timer: ReturnType<typeof setTimeout> | undefined\n    const onAbort = (): void => {\n      clearTimeout(timer)\n      reject(new AbortedError())\n    }\n    const arm = (remaining: number): void => {\n      const wait = Math.min(remaining, MAX_TIMER_DELAY_MS)\n      timer = setTimeout(() => {\n        if (remaining > wait) return arm(remaining - wait)\n        signal?.removeEventListener('abort', onAbort)\n        resolve()\n      }, wait)\n    }\n    arm(ms)\n    signal?.addEventListener('abort', onAbort, { once: true })\n  })\n}\n\n/**\n * Counting semaphore. `acquire()` resolves when a permit is available, in FIFO order, or rejects with\n * {@link AbortedError} when `signal` aborts while waiting.\n */\nexport class Semaphore {\n  #available: number\n  readonly #waiters: { resolve: () => void; reject: (error: unknown) => void }[] = []\n\n  constructor(permits: number) {\n    this.#available = permits\n  }\n\n  /** Permits currently available. */\n  get available(): number {\n    return this.#available\n  }\n\n  /** Number of callers waiting for a permit. */\n  get waiting(): number {\n    return this.#waiters.length\n  }\n\n  acquire(signal?: AbortSignal): Promise<void> {\n    if (signal?.aborted === true) return Promise.reject(new AbortedError())\n    if (this.#available > 0) {\n      this.#available--\n      return Promise.resolve()\n    }\n    return new Promise((resolve, reject) => {\n      const waiter = {\n        resolve: (): void => {\n          signal?.removeEventListener('abort', onAbort)\n          resolve()\n        },\n        reject,\n      }\n      const onAbort = (): void => {\n        const index = this.#waiters.indexOf(waiter)\n        if (index !== -1) this.#waiters.splice(index, 1)\n        reject(new AbortedError())\n      }\n      this.#waiters.push(waiter)\n      signal?.addEventListener('abort', onAbort, { once: true })\n    })\n  }\n\n  release(): void {\n    const next = this.#waiters.shift()\n    if (next === undefined) this.#available++\n    else next.resolve()\n  }\n}\n\n/** Message of any thrown value. */\nexport function errorMessage(error: unknown): string {\n  if (error instanceof Error) return error.message\n  if (typeof error === 'string') return error\n  try {\n    return String(error)\n  } catch {\n    return Object.prototype.toString.call(error)\n  }\n}\n\n/** Truncates `text` to `max` characters (with an ellipsis). */\nexport function truncate(text: string, max: number): string {\n  return text.length <= max ? text : `${text.slice(0, Math.max(0, max - 1))}…`\n}\n\n/** Whether `value` is a positive integer. */\nexport function isPositiveInteger(value: unknown): value is number {\n  return typeof value === 'number' && Number.isSafeInteger(value) && value > 0\n}\n"],"mappings":"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"}

package/dist/codec-Dku-NXXU.mjs

@@ -0,0 +1,83 @@
+import { f as MessageDecodeError } from "./async-CFh_bvex.mjs";
+// src/codec.ts
+const JSON_CONTENT_TYPE = "application/json";
+const TEXT_CONTENT_TYPE = "text/plain; charset=utf-8";
+const BINARY_CONTENT_TYPE = "application/octet-stream";
+const encoder = new TextEncoder();
+const decoder = new TextDecoder("utf-8");
+/** Body as text (UTF-8). */
+function bodyToText(body) {
+	return typeof body === "string" ? body : decoder.decode(body);
+}
+/** Body as bytes (UTF-8 for strings). */
+function bodyToBytes(body) {
+	return typeof body === "string" ? encoder.encode(body) : body;
+}
+/** Lower-cased media type without parameters (`application/json; charset=utf-8` → `application/json`). */
+function mediaType(contentType) {
+	if (contentType === void 0) return void 0;
+	const value = contentType.split(";", 1)[0]?.trim().toLowerCase();
+	return value === "" ? void 0 : value;
+}
+function isJson(type) {
+	return type === "application/json" || type.endsWith("+json");
+}
+/**
+* The default codec.
+*
+* - encode: `Uint8Array` → `application/octet-stream`; a `string` with an explicit text/binary
+*   `contentType` is sent as is; everything else is JSON (`application/json`), including strings.
+*   `undefined` is an empty JSON body.
+* - decode: JSON (`application/json`, `*+json`) is parsed (empty body → `undefined`; malformed →
+*   `MessageDecodeError`); `text/*` → string; other declared types → `Uint8Array`. Without content
+*   type, JSON is attempted and the text is returned when it is not valid JSON.
+*/
+const jsonCodec = Object.freeze({
+	encode(payload, contentType) {
+		const type = mediaType(contentType);
+		if (payload instanceof Uint8Array) return {
+			body: payload,
+			contentType: contentType ?? "application/octet-stream"
+		};
+		if (typeof payload === "string" && type !== void 0 && !isJson(type)) return {
+			body: payload,
+			contentType
+		};
+		if (payload === void 0) return {
+			body: "",
+			contentType: contentType ?? "application/json"
+		};
+		const json = JSON.stringify(payload);
+		if (json === void 0) throw new TypeError(`[znight] Cannot encode a ${typeof payload} payload as JSON`);
+		return {
+			body: json,
+			contentType: contentType ?? "application/json"
+		};
+	},
+	decode(body, contentType) {
+		const type = mediaType(contentType);
+		if (type === void 0) {
+			const text = bodyToText(body);
+			if (text === "") return void 0;
+			try {
+				return JSON.parse(text);
+			} catch {
+				return text;
+			}
+		}
+		if (isJson(type)) {
+			const text = bodyToText(body);
+			if (text.trim() === "") return void 0;
+			try {
+				return JSON.parse(text);
+			} catch (error) {
+				throw new MessageDecodeError(`Malformed JSON body: ${error.message}`, { cause: error });
+			}
+		}
+		if (type.startsWith("text/")) return bodyToText(body);
+		return bodyToBytes(body);
+	}
+});
+export { bodyToText as a, bodyToBytes as i, JSON_CONTENT_TYPE as n, jsonCodec as o, TEXT_CONTENT_TYPE as r, mediaType as s, BINARY_CONTENT_TYPE as t };
+
+//# sourceMappingURL=codec-Dku-NXXU.mjs.map

package/dist/codec-Dku-NXXU.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec-Dku-NXXU.mjs","names":[],"sources":["../src/codec.ts"],"sourcesContent":["import { MessageDecodeError } from './errors.ts'\n\n/** An encoded body and its content type. */\nexport interface EncodedBody {\n  readonly body: Uint8Array | string\n  readonly contentType: string\n}\n\n/**\n * Converts payloads to bodies and back. The default {@link jsonCodec} handles JSON, text and binary\n * payloads; provide your own (MessagePack, Avro...) with `MessagingPlugin.configure({ codec })`.\n */\nexport interface MessageCodec {\n  /**\n   * Encodes a payload for publication. `contentType` is the one requested by the publisher, if any\n   * (`publish(queue, payload, { contentType })`).\n   */\n  encode(payload: unknown, contentType: string | undefined): EncodedBody\n  /**\n   * Decodes a received body. Throw a {@link MessageDecodeError} (a `NonRetryableError`) for malformed\n   * bodies: the message is dead-lettered with reason `decode`.\n   */\n  decode(body: Uint8Array | string, contentType: string | undefined): unknown\n}\n\nexport const JSON_CONTENT_TYPE = 'application/json'\nexport const TEXT_CONTENT_TYPE = 'text/plain; charset=utf-8'\nexport const BINARY_CONTENT_TYPE = 'application/octet-stream'\n\nconst encoder = new TextEncoder()\nconst decoder = new TextDecoder('utf-8')\n\n/** Body as text (UTF-8). */\nexport function bodyToText(body: Uint8Array | string): string {\n  return typeof body === 'string' ? body : decoder.decode(body)\n}\n\n/** Body as bytes (UTF-8 for strings). */\nexport function bodyToBytes(body: Uint8Array | string): Uint8Array {\n  return typeof body === 'string' ? encoder.encode(body) : body\n}\n\n/** Lower-cased media type without parameters (`application/json; charset=utf-8` → `application/json`). */\nexport function mediaType(contentType: string | undefined): string | undefined {\n  if (contentType === undefined) return undefined\n  const value = contentType.split(';', 1)[0]?.trim().toLowerCase()\n  return value === '' ? undefined : value\n}\n\nfunction isJson(type: string): boolean {\n  return type === JSON_CONTENT_TYPE || type.endsWith('+json')\n}\n\n/**\n * The default codec.\n *\n * - encode: `Uint8Array` → `application/octet-stream`; a `string` with an explicit text/binary\n *   `contentType` is sent as is; everything else is JSON (`application/json`), including strings.\n *   `undefined` is an empty JSON body.\n * - decode: JSON (`application/json`, `*+json`) is parsed (empty body → `undefined`; malformed →\n *   `MessageDecodeError`); `text/*` → string; other declared types → `Uint8Array`. Without content\n *   type, JSON is attempted and the text is returned when it is not valid JSON.\n */\nexport const jsonCodec: MessageCodec = Object.freeze({\n  encode(payload: unknown, contentType: string | undefined): EncodedBody {\n    const type = mediaType(contentType)\n    if (payload instanceof Uint8Array) return { body: payload, contentType: contentType ?? BINARY_CONTENT_TYPE }\n    if (typeof payload === 'string' && type !== undefined && !isJson(type))\n      return { body: payload, contentType: contentType as string }\n    if (payload === undefined) return { body: '', contentType: contentType ?? JSON_CONTENT_TYPE }\n    const json = JSON.stringify(payload)\n    if (json === undefined) throw new TypeError(`[znight] Cannot encode a ${typeof payload} payload as JSON`)\n    return { body: json, contentType: contentType ?? JSON_CONTENT_TYPE }\n  },\n  decode(body: Uint8Array | string, contentType: string | undefined): unknown {\n    const type = mediaType(contentType)\n    if (type === undefined) {\n      const text = bodyToText(body)\n      if (text === '') return undefined\n      try {\n        return JSON.parse(text)\n      } catch {\n        return text\n      }\n    }\n    if (isJson(type)) {\n      const text = bodyToText(body)\n      if (text.trim() === '') return undefined\n      try {\n        return JSON.parse(text)\n      } catch (error) {\n        throw new MessageDecodeError(`Malformed JSON body: ${(error as Error).message}`, { cause: error })\n      }\n    }\n    if (type.startsWith('text/')) return bodyToText(body)\n    return bodyToBytes(body)\n  },\n})\n"],"mappings":";;AAyBA,MAAa,oBAAoB;AACjC,MAAa,oBAAoB;AACjC,MAAa,sBAAsB;AAEnC,MAAM,UAAU,IAAI,YAAY;AAChC,MAAM,UAAU,IAAI,YAAY,OAAO;;AAGvC,SAAgB,WAAW,MAAmC;CAC5D,OAAO,OAAO,SAAS,WAAW,OAAO,QAAQ,OAAO,IAAI;AAC9D;;AAGA,SAAgB,YAAY,MAAuC;CACjE,OAAO,OAAO,SAAS,WAAW,QAAQ,OAAO,IAAI,IAAI;AAC3D;;AAGA,SAAgB,UAAU,aAAqD;CAC7E,IAAI,gBAAgB,KAAA,GAAW,OAAO,KAAA;CACtC,MAAM,QAAQ,YAAY,MAAM,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,YAAY;CAC/D,OAAO,UAAU,KAAK,KAAA,IAAY;AACpC;AAEA,SAAS,OAAO,MAAuB;CACrC,OAAO,SAAA,sBAA8B,KAAK,SAAS,OAAO;AAC5D;;;;;;;;;;;AAYA,MAAa,YAA0B,OAAO,OAAO;CACnD,OAAO,SAAkB,aAA8C;EACrE,MAAM,OAAO,UAAU,WAAW;EAClC,IAAI,mBAAmB,YAAY,OAAO;GAAE,MAAM;GAAS,aAAa,eAAA;EAAmC;EAC3G,IAAI,OAAO,YAAY,YAAY,SAAS,KAAA,KAAa,CAAC,OAAO,IAAI,GACnE,OAAO;GAAE,MAAM;GAAsB;EAAsB;EAC7D,IAAI,YAAY,KAAA,GAAW,OAAO;GAAE,MAAM;GAAI,aAAa,eAAA;EAAiC;EAC5F,MAAM,OAAO,KAAK,UAAU,OAAO;EACnC,IAAI,SAAS,KAAA,GAAW,MAAM,IAAI,UAAU,4BAA4B,OAAO,QAAQ,iBAAiB;EACxG,OAAO;GAAE,MAAM;GAAM,aAAa,eAAA;EAAiC;CACrE;CACA,OAAO,MAA2B,aAA0C;EAC1E,MAAM,OAAO,UAAU,WAAW;EAClC,IAAI,SAAS,KAAA,GAAW;GACtB,MAAM,OAAO,WAAW,IAAI;GAC5B,IAAI,SAAS,IAAI,OAAO,KAAA;GACxB,IAAI;IACF,OAAO,KAAK,MAAM,IAAI;GACxB,QAAQ;IACN,OAAO;GACT;EACF;EACA,IAAI,OAAO,IAAI,GAAG;GAChB,MAAM,OAAO,WAAW,IAAI;GAC5B,IAAI,KAAK,KAAK,MAAM,IAAI,OAAO,KAAA;GAC/B,IAAI;IACF,OAAO,KAAK,MAAM,IAAI;GACxB,SAAS,OAAO;IACd,MAAM,IAAI,mBAAmB,wBAAyB,MAAgB,WAAW,EAAE,OAAO,MAAM,CAAC;GACnG;EACF;EACA,IAAI,KAAK,WAAW,OAAO,GAAG,OAAO,WAAW,IAAI;EACpD,OAAO,YAAY,IAAI;CACzB;AACF,CAAC"}

package/dist/compiler.d.mts

@@ -0,0 +1,75 @@
+import { Token } from "@znight/core";
+import { CompilerExtension, Location, StaticValue, ValueRef } from "@znight/compiler";
+/** A normalized `@Retry` policy (`MessageHandlerDefinition.retry`). */
+interface RetryPolicyData {
+  readonly attempts: number;
+  readonly backoff: "fixed" | "exponential";
+  readonly delay: number;
+  readonly maxDelay?: number;
+}
+/** How the invoker computes one argument of a handler. */
+type HandlerParamData = {
+  readonly kind: "payload";
+} | {
+  readonly kind: "validated";
+  readonly schema: ValueRef;
+} | {
+  readonly kind: "headers";
+} | {
+  readonly kind: "header";
+  readonly name: string;
+} | {
+  readonly kind: "message";
+  readonly narrow: boolean;
+} | {
+  readonly kind: "undefined";
+};
+/** One `@OnMessage` decorator of a method. */
+interface HandlerData {
+  readonly method: string;
+  /** `@OnMessage(type)`; `undefined` for the default handler. */
+  readonly type: string | undefined;
+  readonly retry: RetryPolicyData | undefined;
+  readonly params: readonly HandlerParamData[];
+  /** Display name of the class declaring the method (messages). */
+  readonly declaredBy: string;
+  /** Location of the `@OnMessage` decorator. */
+  readonly location: Location;
+}
+/** A `@Consumer` class. */
+interface ConsumerData {
+  readonly kind: "consumer";
+  /** Provider token of the consumer. */
+  readonly token: Token;
+  readonly identity: string;
+  readonly displayName: string;
+  /** Empty when the queue is invalid (a diagnostic was reported). */
+  readonly queue: string;
+  /** `@Consumer` options without `queue` and `scope` (`undefined` when empty). */
+  readonly options: Readonly<Record<string, StaticValue>> | undefined;
+  /** Handlers of the class and its analysable base classes, in declaration order (bases first). */
+  readonly handlers: readonly HandlerData[];
+  readonly errorHandler: string | undefined;
+  /** Identities of the class and of its analysable base classes (nearest first). */
+  readonly chain: readonly string[];
+  /** Location of the `@Consumer` decorator. */
+  readonly location: Location;
+}
+/** A class carrying messaging member decorators without `@Consumer` (a base class, or a mistake). */
+interface MemberClassData {
+  readonly kind: "members";
+  readonly identity: string;
+  readonly displayName: string;
+  readonly abstract: boolean;
+  /** Method decorators (`@OnMessage`, `@OnError`, `@Retry`), in source order. */
+  readonly decorators: readonly {
+    readonly name: string;
+    readonly location: Location;
+  }[];
+}
+/** Everything the extension stores. */
+type MessagingData = ConsumerData | MemberClassData;
+/** The `@znight/messaging` compiler extension. */
+export declare const messagingCompilerExtension: CompilerExtension<MessagingData>;
+export { type ConsumerData, type HandlerData, type HandlerParamData, type MemberClassData, type MessagingData, type RetryPolicyData, messagingCompilerExtension as default };
+//# sourceMappingURL=compiler.d.mts.map