@relaybus/testing 0.3.1 → 0.4.1

package/dist/index.d.cts

@@ -1,4 +1,6 @@
 import { NewDelivery, EventEnvelope, EventStore, Clock, Transport, TransportMessageHandler } from '@relaybus/core';
+import { KafkaCodecContractOptions, RabbitMqCodecContractOptions } from './codec-contract.cjs';
+export { BodyComparison, CodecContractError, KafkaCapturedRecord, KafkaCodecCase, KafkaDeliveredRecord, KafkaWrittenRecord, RabbitMqCapturedMessage, RabbitMqCodecCase, RabbitMqDeliveredMessage, RabbitMqWrittenMessage, TestFramework, WireBytes, assertKafkaCodecCase, assertRabbitMqCodecCase, kafkaCodecMismatches, rabbitMqCodecMismatches, registerKafkaCodecContract, registerRabbitMqCodecContract } from './codec-contract.cjs';
 
 declare function at(offsetMs: number): Date;
 declare function createEnvelope(overrides?: Partial<EventEnvelope>): EventEnvelope;
@@ -83,4 +85,10 @@ declare class InMemoryTransport implements Transport {
     close(): Promise<void>;
 }
 
-export { type EventStoreContractOptions, FakeClock, InMemoryTransport, type PublishedMessage, at, createDelivery, createEnvelope, eventStoreContract };
+/** Registers one Vitest test per captured Kafka record (see `registerKafkaCodecContract`). */
+declare function kafkaCodecContract(name: string, options: KafkaCodecContractOptions): void;
+/** Registers one Vitest test per captured RabbitMQ message (see `registerRabbitMqCodecContract`). */
+declare function rabbitMqCodecContract(name: string, options: RabbitMqCodecContractOptions): void;
+
+export { FakeClock, InMemoryTransport, KafkaCodecContractOptions, RabbitMqCodecContractOptions, at, createDelivery, createEnvelope, eventStoreContract, kafkaCodecContract, rabbitMqCodecContract };
+export type { EventStoreContractOptions, PublishedMessage };

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 import { NewDelivery, EventEnvelope, EventStore, Clock, Transport, TransportMessageHandler } from '@relaybus/core';
+import { KafkaCodecContractOptions, RabbitMqCodecContractOptions } from './codec-contract.js';
+export { BodyComparison, CodecContractError, KafkaCapturedRecord, KafkaCodecCase, KafkaDeliveredRecord, KafkaWrittenRecord, RabbitMqCapturedMessage, RabbitMqCodecCase, RabbitMqDeliveredMessage, RabbitMqWrittenMessage, TestFramework, WireBytes, assertKafkaCodecCase, assertRabbitMqCodecCase, kafkaCodecMismatches, rabbitMqCodecMismatches, registerKafkaCodecContract, registerRabbitMqCodecContract } from './codec-contract.js';
 
 declare function at(offsetMs: number): Date;
 declare function createEnvelope(overrides?: Partial<EventEnvelope>): EventEnvelope;
@@ -83,4 +85,10 @@ declare class InMemoryTransport implements Transport {
     close(): Promise<void>;
 }
 
-export { type EventStoreContractOptions, FakeClock, InMemoryTransport, type PublishedMessage, at, createDelivery, createEnvelope, eventStoreContract };
+/** Registers one Vitest test per captured Kafka record (see `registerKafkaCodecContract`). */
+declare function kafkaCodecContract(name: string, options: KafkaCodecContractOptions): void;
+/** Registers one Vitest test per captured RabbitMQ message (see `registerRabbitMqCodecContract`). */
+declare function rabbitMqCodecContract(name: string, options: RabbitMqCodecContractOptions): void;
+
+export { FakeClock, InMemoryTransport, KafkaCodecContractOptions, RabbitMqCodecContractOptions, at, createDelivery, createEnvelope, eventStoreContract, kafkaCodecContract, rabbitMqCodecContract };
+export type { EventStoreContractOptions, PublishedMessage };

package/dist/index.js

@@ -1,7 +1,8 @@
+import { registerKafkaCodecContract, registerRabbitMqCodecContract } from './chunk-ZZZXYZJ3.js';
+export { CodecContractError, assertKafkaCodecCase, assertRabbitMqCodecCase, kafkaCodecMismatches, rabbitMqCodecMismatches, registerKafkaCodecContract, registerRabbitMqCodecContract } from './chunk-ZZZXYZJ3.js';
 import { describe, beforeEach, afterEach, it, expect } from 'vitest';
 import { createUuidV7 } from '@relaybus/core';
 
-// src/event-store-contract.ts
 function createDeferred() {
   let resolve;
   const promise = new Promise((onResolve) => {
@@ -1242,6 +1243,60 @@ function lostLeasesContract(suite) {
     });
   });
 }
+function unsortedPayload() {
+  return {
+    zulu: "last letter first",
+    b: { yankee: [{ zz: 1, a: 2, mm: { q: null, c: true } }, [], {}], alpha: {} },
+    longestKeyOfTheObject: 1,
+    a: '\xE7\u011F\u0131\xF6\u015F\xFC \u{1F680} \u2028 "quoted" \\ tab	',
+    exponent: 1e21,
+    tiny: 5e-324,
+    fraction: 0.1 + 0.2,
+    negative: -42.5,
+    maxSafe: Number.MAX_SAFE_INTEGER,
+    minSafe: Number.MIN_SAFE_INTEGER,
+    emptyObject: {},
+    emptyArray: [],
+    "7": "integer-like key",
+    mixed: ["z", { d: 4, c: 3 }, 0, false, null]
+  };
+}
+function payloadFidelityContract(suite) {
+  const { append, claim } = suite;
+  describe("payload fidelity", () => {
+    it("hands out the payload and headers with their key order, as published", async () => {
+      const event = createEnvelope({
+        payload: unsortedPayload(),
+        headers: { zz: "last", traceparent: "00-abc-def-01", a: "first", tenant: "acme" }
+      });
+      await append([{ event, deliveries: [createDelivery("handler-a")] }]);
+      const [claimed] = await claim(["handler-a"]);
+      expect(JSON.stringify(claimed.event.payload)).toBe(JSON.stringify(event.payload));
+      expect(JSON.stringify(claimed.event.headers)).toBe(JSON.stringify(event.headers));
+    });
+    it("keeps the order of a payload appended in a batch and of a top-level array", async () => {
+      const object = createEnvelope({ payload: unsortedPayload() });
+      const list = createEnvelope({ payload: [{ zz: 1, a: { y: 2, b: 1 } }, "x", 1e21] });
+      const scalar = createEnvelope({ payload: "plain text" });
+      await append([
+        { event: object, deliveries: [createDelivery("handler-a", at(1))] },
+        { event: list, deliveries: [createDelivery("handler-a", at(2))] },
+        { event: scalar, deliveries: [createDelivery("handler-a", at(3))] }
+      ]);
+      const claimed = await claim(["handler-a"], at(10));
+      expect(claimed.map((delivery) => JSON.stringify(delivery.event.payload))).toEqual(
+        [object, list, scalar].map((event) => JSON.stringify(event.payload))
+      );
+    });
+    it("keeps the order for a handler added to an event that already exists", async () => {
+      const event = createEnvelope({ payload: unsortedPayload() });
+      await append([{ event, deliveries: [createDelivery("handler-a")] }]);
+      await append([{ event, deliveries: [createDelivery("handler-b")] }]);
+      const [claimed] = await claim(["handler-b"]);
+      expect(JSON.stringify(claimed.event.payload)).toBe(JSON.stringify(event.payload));
+    });
+  });
+}
 
 // src/event-store-contract.ts
 function eventStoreContract(name, options) {
@@ -1290,6 +1345,7 @@ function eventStoreContract(name, options) {
     orderingAndLeasesContract(suite);
     completionContract(suite);
     lostLeasesContract(suite);
+    payloadFidelityContract(suite);
   });
 }
 
@@ -1415,7 +1471,13 @@ async function deliverWithRedeliveries(handler, delivery) {
     }
   }
 }
+function kafkaCodecContract(name, options) {
+  registerKafkaCodecContract({ describe: describe, it: it }, { name, options });
+}
+function rabbitMqCodecContract(name, options) {
+  registerRabbitMqCodecContract({ describe: describe, it: it }, { name, options });
+}
 
-export { FakeClock, InMemoryTransport, at, createDelivery, createEnvelope, eventStoreContract };
+export { FakeClock, InMemoryTransport, at, createDelivery, createEnvelope, eventStoreContract, kafkaCodecContract, rabbitMqCodecContract };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map