@relaybus/core 0.4.0 → 0.5.0

package/dist/internal/index.cjs

@@ -1,23 +1,23 @@
 'use strict';
 
-var chunkJ76M7XTS_cjs = require('../chunk-J76M7XTS.cjs');
+var chunk2E6NSHGE_cjs = require('../chunk-2E6NSHGE.cjs');
 
 // src/internal/validation.ts
 function assertPositiveInteger(value, name) {
-  return chunkJ76M7XTS_cjs.PositiveInteger.of(value, name);
+  return chunk2E6NSHGE_cjs.PositiveInteger.of(value, name);
 }
 
 // src/internal/field-extractors.ts
 function fromHeader(name) {
   if (name.length === 0) {
-    throw new chunkJ76M7XTS_cjs.ConfigurationError("fromHeader needs a header name");
+    throw new chunk2E6NSHGE_cjs.ConfigurationError("fromHeader needs a header name");
   }
   return (message) => Object.hasOwn(message.headers, name) ? message.headers[name] : void 0;
 }
 function fromPayloadField(path) {
   const segments = path.split(".");
   if (segments.some((segment) => segment.length === 0)) {
-    throw new chunkJ76M7XTS_cjs.ConfigurationError(
+    throw new chunk2E6NSHGE_cjs.ConfigurationError(
       `fromPayloadField needs a dotted path of non-empty names, received '${path}'`
     );
   }
@@ -62,7 +62,7 @@ function createCloudEventReaders(invalid) {
     },
     assertValidType: (type, label) => {
       try {
-        chunkJ76M7XTS_cjs.assertEventType(type);
+        chunk2E6NSHGE_cjs.assertEventType(type);
       } catch (error) {
         throw invalid(`${label} is not a valid event type: ${error.message}`);
       }
@@ -90,6 +90,93 @@ function writeStructuredCloudEvent(envelope, { time, data }) {
   return `${JSON.stringify(attributes).slice(0, -1)},"data":${data}}`;
 }
 
+// src/internal/json-envelope-wire-types.ts
+function compileWireTypes(wireTypes, { fixed }) {
+  if (wireTypes === void 0) {
+    return { wireTypes: /* @__PURE__ */ new Map(), eventTypes: /* @__PURE__ */ new Map() };
+  }
+  if (!isJsonObject(wireTypes) || fixed) {
+    throw new chunk2E6NSHGE_cjs.ConfigurationError(
+      "jsonEnvelope wireTypes must be an object of event type to wire name, with a type at { body } or { header }"
+    );
+  }
+  const entries = Object.entries(wireTypes);
+  const eventTypes = /* @__PURE__ */ new Map();
+  for (const [type, wire] of entries) {
+    chunk2E6NSHGE_cjs.assertEventType(type);
+    if (typeof wire !== "string" || wire.length === 0 || eventTypes.has(wire)) {
+      throw new chunk2E6NSHGE_cjs.ConfigurationError(
+        `jsonEnvelope wireTypes needs a non-empty wire name for '${type}' that no other type uses`
+      );
+    }
+    eventTypes.set(wire, type);
+  }
+  return { wireTypes: new Map(entries), eventTypes };
+}
+function wireTypeOf(envelope, { plan, failures }) {
+  const wire = plan.wireTypes.get(envelope.type);
+  if (wire !== void 0) {
+    return wire;
+  }
+  const other = plan.eventTypes.get(envelope.type);
+  if (other !== void 0) {
+    throw failures.unencodable(
+      `Event ${envelope.id} has type '${envelope.type}', which wireTypes uses as the wire name of '${other}'`
+    );
+  }
+  return envelope.type;
+}
+function eventTypeOf(wire, { plan, failures }) {
+  const type = plan.eventTypes.get(wire);
+  if (type !== void 0) {
+    return type;
+  }
+  try {
+    chunk2E6NSHGE_cjs.assertEventType(wire);
+  } catch (error) {
+    throw failures.invalid(`The event type is not a valid event type: ${error.message}`);
+  }
+  return wire;
+}
+function withDeclaredWireTypes(codec, {
+  wireTypes,
+  transport
+}) {
+  if (codec.withWireTypes === void 0) {
+    throw new chunk2E6NSHGE_cjs.WireTypesUnsupportedError(
+      `The codec of transport '${transport}' cannot map event types to wire names; use jsonEnvelope with a type at { body } or { header }`
+    );
+  }
+  return codec.withWireTypes(wireTypes);
+}
+function mergeWireTypes(mapping, declared) {
+  if (isJsonObject(mapping.type) && "fixed" in mapping.type) {
+    throw new chunk2E6NSHGE_cjs.WireTypesUnsupportedError(
+      "A jsonEnvelope with a fixed type writes no type, so it has no wire names to declare"
+    );
+  }
+  const merged = new Map(Object.entries(mapping.wireTypes ?? {}));
+  for (const [type, wire] of Object.entries(declared)) {
+    assertDeclarable(merged, { type, wire });
+    merged.set(type, wire);
+  }
+  return Object.fromEntries(merged);
+}
+function assertDeclarable(wireTypes, { type, wire }) {
+  const current = wireTypes.get(type);
+  if (current !== void 0 && current !== wire) {
+    throw new chunk2E6NSHGE_cjs.WireTypeCollisionError(
+      `Event type '${type}' has the wire name '${current}' in the wireTypes of the codec and '${wire}' from a route or catalog`
+    );
+  }
+  const owner = [...wireTypes].find(([other, name]) => name === wire && other !== type);
+  if (owner !== void 0) {
+    throw new chunk2E6NSHGE_cjs.WireTypeCollisionError(
+      `Event types '${owner[0]}' and '${type}' share the wire name '${wire}' in the codec and a route or catalog`
+    );
+  }
+}
+
 // src/internal/json-envelope-plan.ts
 var OPTIONAL_NAMES = [
   "key",
@@ -102,7 +189,7 @@ var TIME_FORMATS = ["rfc3339", "epoch-millis", "epoch-seconds"];
 var ARRAY_INDEX = /^(?:0|[1-9]\d*)$/;
 function compile(mapping, transportIds) {
   if (!isJsonObject(mapping)) {
-    throw new chunkJ76M7XTS_cjs.ConfigurationError("jsonEnvelope needs a mapping object");
+    throw new chunk2E6NSHGE_cjs.ConfigurationError("jsonEnvelope needs a mapping object");
   }
   const optional = {};
   for (const name of OPTIONAL_NAMES) {
@@ -114,10 +201,11 @@ function compile(mapping, transportIds) {
   const payload = compilePayload(mapping.payload);
   const topLevelHeaders = mapping.headers === "top-level-fields";
   if (topLevelHeaders && payload === void 0) {
-    throw new chunkJ76M7XTS_cjs.ConfigurationError("jsonEnvelope headers 'top-level-fields' needs a body payload");
+    throw new chunk2E6NSHGE_cjs.ConfigurationError("jsonEnvelope headers 'top-level-fields' needs a body payload");
   }
+  const type = compileType(mapping.type);
   const plan = {
-    type: compileType(mapping.type),
+    type,
     id: compileId(mapping.id, transportIds),
     idWhenMissing: isJsonObject(mapping.id) && "whenMissing" in mapping.id,
     optional,
@@ -127,6 +215,8 @@ function compile(mapping, transportIds) {
     topLevelNames: /* @__PURE__ */ new Set(),
     mappedHeaders: /* @__PURE__ */ new Set(),
     timeFormat: compileTimeFormat(mapping.occurredAt),
+    otherFields: compileOtherFields(mapping, payload !== void 0),
+    ...compileWireTypes(mapping.wireTypes, { fixed: "fixed" in type }),
     ...compileExtras(mapping, payload !== void 0)
   };
   return assertDisjoint(plan);
@@ -137,7 +227,7 @@ function compileTimeFormat(field) {
     return "rfc3339";
   }
   if (!TIME_FORMATS.includes(format)) {
-    throw new chunkJ76M7XTS_cjs.ConfigurationError(
+    throw new chunk2E6NSHGE_cjs.ConfigurationError(
       `jsonEnvelope occurredAt format must be one of ${TIME_FORMATS.map((name) => `'${name}'`).join(", ")}`
     );
   }
@@ -147,7 +237,7 @@ function compileExtras(mapping, hasBody) {
   const extra = mapping.extra ?? {};
   const bodyOrder = mapping.bodyOrder ?? [];
   if (!hasBody && (extra.body !== void 0 || bodyOrder.length > 0)) {
-    throw new chunkJ76M7XTS_cjs.ConfigurationError(
+    throw new chunk2E6NSHGE_cjs.ConfigurationError(
       "jsonEnvelope with a whole-body payload has no body for extra values or a body order"
     );
   }
@@ -160,13 +250,27 @@ function compileExtras(mapping, hasBody) {
     bodyOrder
   };
 }
+function compileOtherFields(mapping, hasBody) {
+  const otherFields = mapping.otherFields;
+  if (otherFields === void 0) {
+    return void 0;
+  }
+  if (!hasBody) {
+    throw new chunk2E6NSHGE_cjs.ConfigurationError("jsonEnvelope otherFields needs a body payload");
+  }
+  const field = isJsonObject(otherFields) ? otherFields["payloadField"] : void 0;
+  if (typeof field !== "string" || field.length === 0) {
+    throw new chunk2E6NSHGE_cjs.ConfigurationError("jsonEnvelope otherFields must be { payloadField: '<name>' }");
+  }
+  return field;
+}
 function compileType(type) {
   if (isJsonObject(type) && typeof type["fixed"] === "string") {
-    chunkJ76M7XTS_cjs.assertEventType(type["fixed"]);
+    chunk2E6NSHGE_cjs.assertEventType(type["fixed"]);
     return { fixed: type["fixed"] };
   }
   if (type === void 0) {
-    throw new chunkJ76M7XTS_cjs.ConfigurationError("jsonEnvelope needs a type: { body }, { header } or { fixed }");
+    throw new chunk2E6NSHGE_cjs.ConfigurationError("jsonEnvelope needs a type: { body }, { header } or { fixed }");
   }
   return toLocation(type, "type");
 }
@@ -176,12 +280,12 @@ function compileId(id, transportIds) {
   }
   const names = transportIds.map((name) => `'${name}'`).join(", ");
   if (!isJsonObject(id)) {
-    throw new chunkJ76M7XTS_cjs.ConfigurationError(
+    throw new chunk2E6NSHGE_cjs.ConfigurationError(
       `jsonEnvelope needs an id: { body }, { header } or one of ${names}`
     );
   }
   if ("whenMissing" in id && !transportIds.includes(id["whenMissing"])) {
-    throw new chunkJ76M7XTS_cjs.ConfigurationError(`jsonEnvelope id whenMissing must be one of ${names}`);
+    throw new chunk2E6NSHGE_cjs.ConfigurationError(`jsonEnvelope id whenMissing must be one of ${names}`);
   }
   return toLocation(id, "id");
 }
@@ -190,7 +294,7 @@ function compilePayload(payload) {
     return void 0;
   }
   if (!isJsonObject(payload) || typeof payload["body"] !== "string") {
-    throw new chunkJ76M7XTS_cjs.ConfigurationError(
+    throw new chunk2E6NSHGE_cjs.ConfigurationError(
       "jsonEnvelope needs a payload: { body: '<path>' } or 'whole-body'"
     );
   }
@@ -201,7 +305,7 @@ function compileHeaders(headers) {
     return void 0;
   }
   if (!isJsonObject(headers) || typeof headers["body"] !== "string") {
-    throw new chunkJ76M7XTS_cjs.ConfigurationError(
+    throw new chunk2E6NSHGE_cjs.ConfigurationError(
       "jsonEnvelope headers must be { body: '<path>' } or 'message-headers'"
     );
   }
@@ -214,14 +318,14 @@ function toLocation(field, label) {
   if (isJsonObject(field) && typeof field["body"] === "string") {
     return { label, path: toPath(field["body"], label) };
   }
-  throw new chunkJ76M7XTS_cjs.ConfigurationError(
+  throw new chunk2E6NSHGE_cjs.ConfigurationError(
     `jsonEnvelope ${label} must be { body: '<path>' } or { header: '<name>' }`
   );
 }
 function toPath(path, label) {
   const segments = path.split(".");
   if (segments.some((segment) => segment.length === 0)) {
-    throw new chunkJ76M7XTS_cjs.ConfigurationError(
+    throw new chunk2E6NSHGE_cjs.ConfigurationError(
       `jsonEnvelope ${label} needs a dotted path of non-empty names, received '${path}'`
     );
   }
@@ -237,7 +341,7 @@ function assertDisjoint(plan) {
   ];
   const duplicate = headers.find((name, index) => headers.indexOf(name) !== index);
   if (duplicate !== void 0) {
-    throw new chunkJ76M7XTS_cjs.ConfigurationError(`jsonEnvelope maps header '${duplicate}' twice`);
+    throw new chunk2E6NSHGE_cjs.ConfigurationError(`jsonEnvelope maps header '${duplicate}' twice`);
   }
   const paths = [
     ...locations.flatMap((location) => "path" in location ? [location.path] : []),
@@ -262,13 +366,63 @@ function assertCompatiblePaths(path, other) {
   const parting = path.findIndex((segment, position) => segment !== other[position]);
   const both = `'${path.join(".")}' and '${other.join(".")}'`;
   if (parting === -1 || parting === other.length) {
-    throw new chunkJ76M7XTS_cjs.ConfigurationError(`jsonEnvelope body paths ${both} overlap`);
+    throw new chunk2E6NSHGE_cjs.ConfigurationError(`jsonEnvelope body paths ${both} overlap`);
   }
   if (ARRAY_INDEX.test(path[parting]) !== ARRAY_INDEX.test(other[parting])) {
-    throw new chunkJ76M7XTS_cjs.ConfigurationError(`jsonEnvelope body paths ${both} mix an array index and a name`);
+    throw new chunk2E6NSHGE_cjs.ConfigurationError(`jsonEnvelope body paths ${both} mix an array index and a name`);
   }
 }
 
+// src/internal/json-envelope-other-fields.ts
+function unusedFields(body, { plan }) {
+  return Object.entries(body).filter(
+    ([name, value]) => !plan.topLevelNames.has(name) && !(plan.topLevelHeaders && typeof value === "string")
+  );
+}
+function withOtherFields(payload, { body, context }) {
+  const field = context.plan.otherFields;
+  if (field === void 0) {
+    return payload;
+  }
+  const fields = unusedFields(body, context);
+  if (!isJsonObject(payload) && fields.length === 0) {
+    return payload;
+  }
+  if (!isJsonObject(payload) || Object.hasOwn(payload, field)) {
+    throw context.failures.invalid(
+      `otherFields keeps the unused top-level fields under the payload field '${field}', but the payload is not an object without that field`
+    );
+  }
+  return Object.fromEntries([...Object.entries(payload), [field, Object.fromEntries(fields)]]);
+}
+function splitOtherFields(envelope, context) {
+  const field = context.plan.otherFields;
+  const { payload } = envelope;
+  if (field === void 0 || !isJsonObject(payload) || !Object.hasOwn(payload, field)) {
+    return { payload, fields: [] };
+  }
+  const others = payload[field];
+  if (!isJsonObject(others)) {
+    throw context.failures.unencodable(
+      `Event ${envelope.id} has a payload field '${field}' that is not an object of top-level fields`
+    );
+  }
+  const fields = Object.entries(others);
+  const refused = fields.find((entry) => isRefused(entry, context));
+  if (refused !== void 0) {
+    throw context.failures.unencodable(
+      `Event ${envelope.id} keeps a top-level field '${refused[0]}' under '${field}' that the mapping reads as another value`
+    );
+  }
+  return {
+    payload: Object.fromEntries(Object.entries(payload).filter(([name]) => name !== field)),
+    fields
+  };
+}
+function isRefused([name, value], { plan }) {
+  return plan.topLevelNames.has(name) || plan.topLevelHeaders && typeof value === "string";
+}
+
 // src/internal/json-envelope-read.ts
 var RFC3339_PATTERN = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/i;
 var EPOCH_PATTERN = /^\d+$/;
@@ -305,13 +459,8 @@ function readType(message, { plan, failures }) {
     return plan.type.fixed;
   }
   const location = plan.type;
-  const type = requireText(readText(message, { location, failures }), { location, failures });
-  try {
-    chunkJ76M7XTS_cjs.assertEventType(type);
-  } catch (error) {
-    throw failures.invalid(`The event type is not a valid event type: ${error.message}`);
-  }
-  return type;
+  const wire = requireText(readText(message, { location, failures }), { location, failures });
+  return eventTypeOf(wire, { plan, failures });
 }
 function readPayload(body, { plan, failures }) {
   if (plan.payload === void 0) {
@@ -321,7 +470,10 @@ function readPayload(body, { plan, failures }) {
   if (payload === void 0) {
     throw failures.invalid(`The message has no payload at '${plan.payload.join(".")}'`);
   }
-  return payload;
+  return withOtherFields(payload, {
+    body,
+    context: { plan, failures }
+  });
 }
 function readEventHeaders(message, plan) {
   if (plan.topLevelHeaders) {
@@ -411,7 +563,7 @@ function writeMessage(envelope, { plan, failures }) {
   };
   const typeAt = typeLocation(envelope, { plan, failures });
   if (typeAt !== void 0) {
-    put(typeAt, envelope.type);
+    put(typeAt, wireTypeOf(envelope, { plan, failures }));
   }
   if (plan.id !== void 0) {
     put(plan.id, envelope.id);
@@ -422,12 +574,8 @@ function writeMessage(envelope, { plan, failures }) {
       put(location, value);
     }
   }
-  const body = writeBody(envelope, { plan, root });
-  if (plan.topLevelHeaders) {
-    spreadHeaders(envelope, { plan, failures, root: body });
-  }
   return {
-    body,
+    body: writeBody(envelope, { plan, failures, root }),
     headers: Object.fromEntries([
       ...eventHeaderEntries(envelope, { plan, failures }),
       ...headers,
@@ -464,11 +612,12 @@ function optionalValues(envelope, { plan, failures }) {
     ["causationId", envelope.causationId]
   ];
 }
-function writeBody(envelope, { plan, root }) {
+function writeBody(envelope, { plan, failures, root }) {
+  const { payload, fields } = splitOtherFields(envelope, { plan, failures });
   if (plan.payload === void 0) {
-    return envelope.payload;
+    return payload;
   }
-  setAt(root, { path: plan.payload, value: envelope.payload });
+  setAt(root, { path: plan.payload, value: payload });
   if (plan.headers !== void 0) {
     setAt(root, {
       path: plan.headers,
@@ -478,6 +627,10 @@ function writeBody(envelope, { plan, root }) {
   for (const { path, value } of plan.extraBody) {
     setAt(root, { path, value: typeof value === "function" ? value(envelope) : value });
   }
+  if (plan.topLevelHeaders) {
+    spreadHeaders(envelope, { plan, failures, root });
+  }
+  spreadOtherFields(envelope, { failures, fields, root });
   return ordered(root, plan.bodyOrder);
 }
 function spreadHeaders(envelope, { plan, failures, root }) {
@@ -490,6 +643,20 @@ function spreadHeaders(envelope, { plan, failures, root }) {
     setAt(root, { path: [name], value });
   }
 }
+function spreadOtherFields(envelope, {
+  failures,
+  fields,
+  root
+}) {
+  for (const [name, value] of fields) {
+    if (Object.hasOwn(root, name)) {
+      throw failures.unencodable(
+        `Event ${envelope.id} keeps a top-level field '${name}' that an event header also writes`
+      );
+    }
+    setAt(root, { path: [name], value });
+  }
+}
 function timeValue(text, { envelope, format }) {
   const milliseconds = envelope.occurredAt.getTime();
   if (format === "epoch-millis") {
@@ -570,14 +737,14 @@ function createJsonEnvelopeFormat(mapping, {
 var HandedOutLedger = class {
   #entries = /* @__PURE__ */ new Map();
   register(lease, entry) {
-    this.#entries.set(chunkJ76M7XTS_cjs.DeliveryLeaseIdentity.of(lease.deliveryId, lease.leaseToken), entry);
+    this.#entries.set(chunk2E6NSHGE_cjs.DeliveryLeaseIdentity.of(lease.deliveryId, lease.leaseToken), entry);
   }
   /** Whether the claim with this identity ({@link DeliveryLeaseIdentity.of}) is handed out. */
   has(identity) {
     return this.#entries.has(identity);
   }
   forget(lease) {
-    this.#entries.delete(chunkJ76M7XTS_cjs.DeliveryLeaseIdentity.of(lease.deliveryId, lease.leaseToken));
+    this.#entries.delete(chunk2E6NSHGE_cjs.DeliveryLeaseIdentity.of(lease.deliveryId, lease.leaseToken));
   }
   /** Forgets every entry `settled` says is settled. */
   forgetWhere(settled) {
@@ -687,7 +854,7 @@ var BoundedInteger = class {
   /** Returns `value` when it is an integer within the bounds, else throws a {@link ConfigurationError}. */
   static of(value, { name, minimum, maximum }) {
     if (!Number.isInteger(value) || value < minimum || value > maximum) {
-      throw new chunkJ76M7XTS_cjs.ConfigurationError(
+      throw new chunk2E6NSHGE_cjs.ConfigurationError(
         `${name} must be an integer from ${minimum} to ${maximum}, received ${value}`
       );
     }
@@ -737,7 +904,7 @@ var LaneLeaseTokenFormat = class {
 var NonEmptyText = class _NonEmptyText {
   static of(value, name) {
     if (value.length === 0) {
-      throw new chunkJ76M7XTS_cjs.ConfigurationError(`${name} must not be empty`);
+      throw new chunk2E6NSHGE_cjs.ConfigurationError(`${name} must not be empty`);
     }
     return value;
   }
@@ -749,31 +916,31 @@ var NonEmptyText = class _NonEmptyText {
 
 Object.defineProperty(exports, "CompositeKey", {
   enumerable: true,
-  get: function () { return chunkJ76M7XTS_cjs.CompositeKey; }
+  get: function () { return chunk2E6NSHGE_cjs.CompositeKey; }
 });
 Object.defineProperty(exports, "DeliveryLeaseIdentity", {
   enumerable: true,
-  get: function () { return chunkJ76M7XTS_cjs.DeliveryLeaseIdentity; }
+  get: function () { return chunk2E6NSHGE_cjs.DeliveryLeaseIdentity; }
 });
 Object.defineProperty(exports, "LeaseSettlement", {
   enumerable: true,
-  get: function () { return chunkJ76M7XTS_cjs.LeaseSettlement; }
+  get: function () { return chunk2E6NSHGE_cjs.LeaseSettlement; }
 });
 Object.defineProperty(exports, "Milliseconds", {
   enumerable: true,
-  get: function () { return chunkJ76M7XTS_cjs.Milliseconds; }
+  get: function () { return chunk2E6NSHGE_cjs.Milliseconds; }
 });
 Object.defineProperty(exports, "PositiveInteger", {
   enumerable: true,
-  get: function () { return chunkJ76M7XTS_cjs.PositiveInteger; }
+  get: function () { return chunk2E6NSHGE_cjs.PositiveInteger; }
 });
 Object.defineProperty(exports, "schedule", {
   enumerable: true,
-  get: function () { return chunkJ76M7XTS_cjs.schedule; }
+  get: function () { return chunk2E6NSHGE_cjs.schedule; }
 });
 Object.defineProperty(exports, "sleep", {
   enumerable: true,
-  get: function () { return chunkJ76M7XTS_cjs.sleep; }
+  get: function () { return chunk2E6NSHGE_cjs.sleep; }
 });
 exports.BoundedInteger = BoundedInteger;
 exports.DecodedEventReader = DecodedEventReader;
@@ -790,7 +957,9 @@ exports.fromHeader = fromHeader;
 exports.fromPayloadField = fromPayloadField;
 exports.isJsonObject = isJsonObject;
 exports.mediaTypeOf = mediaTypeOf;
+exports.mergeWireTypes = mergeWireTypes;
 exports.observeRejection = observeRejection;
+exports.withDeclaredWireTypes = withDeclaredWireTypes;
 exports.writeStructuredCloudEvent = writeStructuredCloudEvent;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map