@relaybus/core 0.3.0 → 0.3.1

package/dist/internal/index.cjs

@@ -1,18 +1,23 @@
 'use strict';
 
-var chunk3OHMEMZA_cjs = require('../chunk-3OHMEMZA.cjs');
+var chunkJ76M7XTS_cjs = require('../chunk-J76M7XTS.cjs');
+
+// src/internal/validation.ts
+function assertPositiveInteger(value, name) {
+  return chunkJ76M7XTS_cjs.PositiveInteger.of(value, name);
+}
 
 // src/internal/field-extractors.ts
 function fromHeader(name) {
   if (name.length === 0) {
-    throw new chunk3OHMEMZA_cjs.ConfigurationError("fromHeader needs a header name");
+    throw new chunkJ76M7XTS_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 chunk3OHMEMZA_cjs.ConfigurationError(
+    throw new chunkJ76M7XTS_cjs.ConfigurationError(
       `fromPayloadField needs a dotted path of non-empty names, received '${path}'`
     );
   }
@@ -57,7 +62,7 @@ function createCloudEventReaders(invalid) {
     },
     assertValidType: (type, label) => {
       try {
-        chunk3OHMEMZA_cjs.assertEventType(type);
+        chunkJ76M7XTS_cjs.assertEventType(type);
       } catch (error) {
         throw invalid(`${label} is not a valid event type: ${error.message}`);
       }
@@ -85,7 +90,7 @@ function writeStructuredCloudEvent(envelope, { time, data }) {
   return `${JSON.stringify(attributes).slice(0, -1)},"data":${data}}`;
 }
 
-// src/internal/json-envelope.ts
+// src/internal/json-envelope-plan.ts
 var OPTIONAL_NAMES = [
   "key",
   "source",
@@ -93,22 +98,10 @@ var OPTIONAL_NAMES = [
   "correlationId",
   "causationId"
 ];
-var MAXIMUM_RFC3339_YEAR = 9999;
-var RFC3339_PATTERN = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/i;
 var ARRAY_INDEX = /^(?:0|[1-9]\d*)$/;
-function createJsonEnvelopeFormat(mapping, {
-  transportIds,
-  failures
-}) {
-  const plan = compile(mapping, transportIds);
-  return {
-    write: (envelope) => writeMessage(envelope, { plan, failures }),
-    read: (message) => readMessage(message, { plan, failures })
-  };
-}
 function compile(mapping, transportIds) {
   if (!isJsonObject(mapping)) {
-    throw new chunk3OHMEMZA_cjs.ConfigurationError("jsonEnvelope needs a mapping object");
+    throw new chunkJ76M7XTS_cjs.ConfigurationError("jsonEnvelope needs a mapping object");
   }
   const optional = {};
   for (const name of OPTIONAL_NAMES) {
@@ -129,11 +122,11 @@ function compile(mapping, transportIds) {
 }
 function compileType(type) {
   if (isJsonObject(type) && typeof type["fixed"] === "string") {
-    chunk3OHMEMZA_cjs.assertEventType(type["fixed"]);
+    chunkJ76M7XTS_cjs.assertEventType(type["fixed"]);
     return { fixed: type["fixed"] };
   }
   if (type === void 0) {
-    throw new chunk3OHMEMZA_cjs.ConfigurationError("jsonEnvelope needs a type: { body }, { header } or { fixed }");
+    throw new chunkJ76M7XTS_cjs.ConfigurationError("jsonEnvelope needs a type: { body }, { header } or { fixed }");
   }
   return toLocation(type, "type");
 }
@@ -142,7 +135,7 @@ function compileId(id, transportIds) {
     return void 0;
   }
   if (!isJsonObject(id)) {
-    throw new chunk3OHMEMZA_cjs.ConfigurationError(
+    throw new chunkJ76M7XTS_cjs.ConfigurationError(
       `jsonEnvelope needs an id: { body }, { header } or one of ${transportIds.map((name) => `'${name}'`).join(", ")}`
     );
   }
@@ -153,7 +146,7 @@ function compilePayload(payload) {
     return void 0;
   }
   if (!isJsonObject(payload) || typeof payload["body"] !== "string") {
-    throw new chunk3OHMEMZA_cjs.ConfigurationError(
+    throw new chunkJ76M7XTS_cjs.ConfigurationError(
       "jsonEnvelope needs a payload: { body: '<path>' } or 'whole-body'"
     );
   }
@@ -164,7 +157,7 @@ function compileHeaders(headers) {
     return void 0;
   }
   if (!isJsonObject(headers) || typeof headers["body"] !== "string") {
-    throw new chunk3OHMEMZA_cjs.ConfigurationError(
+    throw new chunkJ76M7XTS_cjs.ConfigurationError(
       "jsonEnvelope headers must be { body: '<path>' } or 'message-headers'"
     );
   }
@@ -177,14 +170,14 @@ function toLocation(field, label) {
   if (isJsonObject(field) && typeof field["body"] === "string") {
     return { label, path: toPath(field["body"], label) };
   }
-  throw new chunk3OHMEMZA_cjs.ConfigurationError(
+  throw new chunkJ76M7XTS_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 chunk3OHMEMZA_cjs.ConfigurationError(
+    throw new chunkJ76M7XTS_cjs.ConfigurationError(
       `jsonEnvelope ${label} needs a dotted path of non-empty names, received '${path}'`
     );
   }
@@ -197,7 +190,7 @@ function assertDisjoint(plan) {
   const headers = locations.flatMap((location) => "header" in location ? [location.header] : []);
   const duplicate = headers.find((name, index) => headers.indexOf(name) !== index);
   if (duplicate !== void 0) {
-    throw new chunk3OHMEMZA_cjs.ConfigurationError(`jsonEnvelope maps header '${duplicate}' twice`);
+    throw new chunkJ76M7XTS_cjs.ConfigurationError(`jsonEnvelope maps header '${duplicate}' twice`);
   }
   const paths = [
     ...locations.flatMap((location) => "path" in location ? [location.path] : []),
@@ -217,12 +210,117 @@ 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 chunk3OHMEMZA_cjs.ConfigurationError(`jsonEnvelope body paths ${both} overlap`);
+    throw new chunkJ76M7XTS_cjs.ConfigurationError(`jsonEnvelope body paths ${both} overlap`);
   }
   if (ARRAY_INDEX.test(path[parting]) !== ARRAY_INDEX.test(other[parting])) {
-    throw new chunk3OHMEMZA_cjs.ConfigurationError(`jsonEnvelope body paths ${both} mix an array index and a name`);
+    throw new chunkJ76M7XTS_cjs.ConfigurationError(`jsonEnvelope body paths ${both} mix an array index and a name`);
+  }
+}
+
+// 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;
+function readMessage(message, context) {
+  const { plan, failures } = context;
+  if (plan.payload !== void 0 && !isJsonObject(message.body)) {
+    throw failures.invalid("The message body must be a JSON object");
+  }
+  const read = (location) => location === void 0 ? void 0 : readText(message, { location, failures });
+  const fields = {
+    id: plan.id === void 0 ? void 0 : requireText(read(plan.id), { location: plan.id, failures }),
+    type: readType(message, context),
+    payload: readPayload(message.body, context),
+    key: read(plan.optional.key),
+    source: read(plan.optional.source),
+    headers: readEventHeaders(message, plan),
+    correlationId: read(plan.optional.correlationId) ?? null,
+    causationId: read(plan.optional.causationId) ?? null,
+    occurredAt: readTime(read(plan.optional.occurredAt), failures)
+  };
+  return Object.fromEntries(
+    Object.entries(fields).filter((entry) => entry[1] !== void 0)
+  );
+}
+function readType(message, { plan, failures }) {
+  if ("fixed" in plan.type) {
+    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;
+}
+function readPayload(body, { plan, failures }) {
+  if (plan.payload === void 0) {
+    return body;
+  }
+  const payload = valueAt(body, plan.payload);
+  if (payload === void 0) {
+    throw failures.invalid(`The message has no payload at '${plan.payload.join(".")}'`);
+  }
+  return payload;
+}
+function readEventHeaders(message, plan) {
+  if (plan.headers === void 0) {
+    return Object.fromEntries(
+      Object.entries(message.headers).filter(([name]) => !plan.mappedHeaders.has(name))
+    );
   }
+  const headers = valueAt(message.body, plan.headers);
+  return isJsonObject(headers) ? Object.fromEntries(
+    Object.entries(headers).filter(
+      (entry) => typeof entry[1] === "string"
+    )
+  ) : {};
 }
+function readTime(text, failures) {
+  if (text === void 0) {
+    return void 0;
+  }
+  const time = new Date(text);
+  if (!RFC3339_PATTERN.test(text) || Number.isNaN(time.getTime())) {
+    throw failures.invalid(`The event time is not an RFC 3339 timestamp: '${text}'`);
+  }
+  return time;
+}
+function readText(message, { location, failures }) {
+  const value = "header" in location ? Object.hasOwn(message.headers, location.header) ? message.headers[location.header] : void 0 : valueAt(message.body, location.path);
+  if (value === void 0 || value === null || value === "") {
+    return void 0;
+  }
+  if (typeof value === "string") {
+    return value;
+  }
+  if (typeof value === "number" && Number.isSafeInteger(value)) {
+    return String(value);
+  }
+  throw failures.invalid(`The ${location.label} at ${describe(location)} must be a string`);
+}
+function requireText(value, { location, failures }) {
+  if (value === void 0) {
+    throw failures.invalid(`The message has no ${location.label} at ${describe(location)}`);
+  }
+  return value;
+}
+function describe(location) {
+  return "header" in location ? `header '${location.header}'` : `'${location.path.join(".")}'`;
+}
+function valueAt(body, path) {
+  let value = body;
+  for (const segment of path) {
+    if (typeof value !== "object" || value === null || !Object.hasOwn(value, segment)) {
+      return void 0;
+    }
+    value = value[segment];
+  }
+  return value;
+}
+
+// src/internal/json-envelope-write.ts
+var MAXIMUM_RFC3339_YEAR = 9999;
 function writeMessage(envelope, { plan, failures }) {
   const root = {};
   const headers = [];
@@ -321,124 +419,244 @@ function defineValue(target, { name, value }) {
     configurable: true
   });
 }
-function readMessage(message, context) {
-  const { plan, failures } = context;
-  if (plan.payload !== void 0 && !isJsonObject(message.body)) {
-    throw failures.invalid("The message body must be a JSON object");
-  }
-  const read = (location) => location === void 0 ? void 0 : readText(message, { location, failures });
-  const fields = {
-    id: plan.id === void 0 ? void 0 : requireText(read(plan.id), { location: plan.id, failures }),
-    type: readType(message, context),
-    payload: readPayload(message.body, context),
-    key: read(plan.optional.key),
-    source: read(plan.optional.source),
-    headers: readEventHeaders(message, plan),
-    correlationId: read(plan.optional.correlationId) ?? null,
-    causationId: read(plan.optional.causationId) ?? null,
-    occurredAt: readTime(read(plan.optional.occurredAt), failures)
+
+// src/internal/json-envelope.ts
+function createJsonEnvelopeFormat(mapping, {
+  transportIds,
+  failures
+}) {
+  const plan = compile(mapping, transportIds);
+  return {
+    write: (envelope) => writeMessage(envelope, { plan, failures }),
+    read: (message) => readMessage(message, { plan, failures })
   };
-  return Object.fromEntries(
-    Object.entries(fields).filter((entry) => entry[1] !== void 0)
-  );
 }
-function readType(message, { plan, failures }) {
-  if ("fixed" in plan.type) {
-    return plan.type.fixed;
-  }
-  const location = plan.type;
-  const type = requireText(readText(message, { location, failures }), { location, failures });
-  try {
-    chunk3OHMEMZA_cjs.assertEventType(type);
-  } catch (error) {
-    throw failures.invalid(`The event type is not a valid event type: ${error.message}`);
-  }
-  return type;
-}
-function readPayload(body, { plan, failures }) {
-  if (plan.payload === void 0) {
-    return body;
+
+// src/store-kit/handed-out-ledger.ts
+var HandedOutLedger = class {
+  #entries = /* @__PURE__ */ new Map();
+  register(lease, entry) {
+    this.#entries.set(chunkJ76M7XTS_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));
+  }
+  /** Forgets every entry `settled` says is settled. */
+  forgetWhere(settled) {
+    for (const [identity, entry] of this.#entries) {
+      if (settled(entry, identity)) {
+        this.#entries.delete(identity);
+      }
+    }
   }
-  const payload = valueAt(body, plan.payload);
-  if (payload === void 0) {
-    throw failures.invalid(`The message has no payload at '${plan.payload.join(".")}'`);
+  /** The entries handed out to `owner`. */
+  entriesOf(owner) {
+    return [...this.#entries.values()].filter((entry) => entry.owner === owner);
   }
-  return payload;
-}
-function readEventHeaders(message, plan) {
-  if (plan.headers === void 0) {
-    return Object.fromEntries(
-      Object.entries(message.headers).filter(([name]) => !plan.mappedHeaders.has(name))
+};
+
+// src/store-kit/owner-serialized-claims.ts
+var OwnerSerializedClaims = class {
+  /** The last claim of each owner still running; the next one waits for it. */
+  #queues = /* @__PURE__ */ new Map();
+  claim(request) {
+    if (this.claimsNothing(request)) {
+      return Promise.resolve([]);
+    }
+    return this.#serialized(request.leaseOwner, () => this.claimInTurn(request));
+  }
+  /** Whether the request cannot claim anything: no handlers, or a limit that is not above 0. */
+  claimsNothing(request) {
+    return request.handlers.length === 0 || !(request.limit > 0);
+  }
+  #serialized(owner, work) {
+    const previous = this.#queues.get(owner) ?? Promise.resolve();
+    const run = previous.then(work, work);
+    const tail = run.then(
+      () => void 0,
+      () => void 0
     );
+    this.#queues.set(owner, tail);
+    void tail.then(() => {
+      if (this.#queues.get(owner) === tail) {
+        this.#queues.delete(owner);
+      }
+    });
+    return run;
   }
-  const headers = valueAt(message.body, plan.headers);
-  return isJsonObject(headers) ? Object.fromEntries(
-    Object.entries(headers).filter(
-      (entry) => typeof entry[1] === "string"
-    )
-  ) : {};
-}
-function readTime(text, failures) {
-  if (text === void 0) {
-    return void 0;
-  }
-  const time = new Date(text);
-  if (!RFC3339_PATTERN.test(text) || Number.isNaN(time.getTime())) {
-    throw failures.invalid(`The event time is not an RFC 3339 timestamp: '${text}'`);
-  }
-  return time;
-}
-function readText(message, { location, failures }) {
-  const value = "header" in location ? Object.hasOwn(message.headers, location.header) ? message.headers[location.header] : void 0 : valueAt(message.body, location.path);
-  if (value === void 0 || value === null || value === "") {
-    return void 0;
+};
+
+// src/transport-kit/decoded-event-reader.ts
+function observeRejection(value) {
+  if (typeof value === "object" && value !== null && "then" in value) {
+    Promise.resolve(value).catch(() => void 0);
+  }
+}
+var DecodedEventReader = class {
+  /**
+   * Fills the fields a decoder left out and guards against a decoder that returned no object,
+   * which would otherwise surface as a retried `TypeError` instead of a malformed message.
+   */
+  complete(decoded, message) {
+    if (typeof decoded !== "object" || decoded === null) {
+      throw this.invalid("The decoder must return an event object synchronously");
+    }
+    if ("then" in decoded) {
+      observeRejection(decoded);
+      throw this.invalid("The decoder must return an event object synchronously");
+    }
+    const event = decoded;
+    return {
+      id: event.id,
+      type: event.type,
+      source: event.source ?? this.defaultSource(message),
+      key: event.key === void 0 ? this.defaultKey(message) : event.key,
+      payload: event.payload,
+      headers: event.headers ?? {},
+      correlationId: event.correlationId ?? null,
+      causationId: event.causationId ?? null,
+      occurredAt: event.occurredAt ?? this.defaultTime(message)
+    };
+  }
+  /** The text an option gives for `plain`; undefined when it gives none or `''`. */
+  text(option, { plain, name }) {
+    const value = typeof option === "function" ? option(plain) : option;
+    if (value === void 0 || value === null) {
+      return void 0;
+    }
+    if (typeof value !== "string") {
+      observeRejection(value);
+      throw this.invalid(`The ${name} option returned ${typeof value}, expected a string`);
+    }
+    return value.length === 0 ? void 0 : value;
   }
-  if (typeof value === "string") {
+};
+
+// src/transport-kit/subscribing-transport.ts
+var SubscribingTransport = class {
+  /**
+   * Subscribes to `destinations`. Not async itself: the subscription's own promise is returned
+   * as it is, so its checks reject rather than throw.
+   */
+  // eslint-disable-next-line relaybus/max-two-params -- the Transport.subscribe signature
+  subscribe(destinations, onMessage, hooks) {
+    return this.openSubscription({ destinations, onMessage, hooks });
+  }
+};
+
+// src/values/bounded-integer.ts
+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(
+        `${name} must be an integer from ${minimum} to ${maximum}, received ${value}`
+      );
+    }
     return value;
   }
-  if (typeof value === "number" && Number.isSafeInteger(value)) {
-    return String(value);
+};
+
+// src/values/exponential-backoff.ts
+var ExponentialBackoff = class {
+  initialMs;
+  maxMs;
+  constructor({ initialMs, maxMs }) {
+    this.initialMs = initialMs;
+    this.maxMs = maxMs;
+  }
+  /** The delay after failed attempt `attempt` (1-based). */
+  delayFor(attempt) {
+    return Math.min(this.initialMs * 2 ** (attempt - 1), this.maxMs);
+  }
+};
+
+// src/values/lane-lease-token.ts
+var LANE_DIGITS = 3;
+var LaneLeaseTokenFormat = class {
+  #pattern;
+  #laneCount;
+  constructor(limits) {
+    this.#laneCount = limits.laneCount;
+    this.#pattern = new RegExp(
+      `^(\\d{1,${LANE_DIGITS}}):(\\d{1,${limits.epochDigits}}):(\\d{1,${limits.claimsDigits}})$`
+    );
   }
-  throw failures.invalid(`The ${location.label} at ${describe(location)} must be a string`);
-}
-function requireText(value, { location, failures }) {
-  if (value === void 0) {
-    throw failures.invalid(`The message has no ${location.label} at ${describe(location)}`);
+  format(lane, { epoch, claims }) {
+    return `${lane}:${epoch}:${claims}`;
   }
-  return value;
-}
-function describe(location) {
-  return "header" in location ? `header '${location.header}'` : `'${location.path.join(".")}'`;
-}
-function valueAt(body, path) {
-  let value = body;
-  for (const segment of path) {
-    if (typeof value !== "object" || value === null || !Object.hasOwn(value, segment)) {
+  /** The parts of `token`; undefined when the store cannot have issued it. */
+  parse(token) {
+    const match = this.#pattern.exec(token);
+    if (match === null || Number(match[1]) >= this.#laneCount) {
       return void 0;
     }
-    value = value[segment];
+    return { lane: Number(match[1]), epoch: match[2], claims: Number(match[3]) };
   }
-  return value;
-}
+};
+
+// src/values/non-empty-text.ts
+var NonEmptyText = class _NonEmptyText {
+  static of(value, name) {
+    if (value.length === 0) {
+      throw new chunkJ76M7XTS_cjs.ConfigurationError(`${name} must not be empty`);
+    }
+    return value;
+  }
+  /** Like {@link NonEmptyText.of}, for an option that may be left out. */
+  static optional(value, name) {
+    return value === void 0 ? void 0 : _NonEmptyText.of(value, name);
+  }
+};
 
-Object.defineProperty(exports, "assertPositiveInteger", {
+Object.defineProperty(exports, "CompositeKey", {
+  enumerable: true,
+  get: function () { return chunkJ76M7XTS_cjs.CompositeKey; }
+});
+Object.defineProperty(exports, "DeliveryLeaseIdentity", {
+  enumerable: true,
+  get: function () { return chunkJ76M7XTS_cjs.DeliveryLeaseIdentity; }
+});
+Object.defineProperty(exports, "LeaseSettlement", {
+  enumerable: true,
+  get: function () { return chunkJ76M7XTS_cjs.LeaseSettlement; }
+});
+Object.defineProperty(exports, "Milliseconds", {
+  enumerable: true,
+  get: function () { return chunkJ76M7XTS_cjs.Milliseconds; }
+});
+Object.defineProperty(exports, "PositiveInteger", {
   enumerable: true,
-  get: function () { return chunk3OHMEMZA_cjs.assertPositiveInteger; }
+  get: function () { return chunkJ76M7XTS_cjs.PositiveInteger; }
 });
 Object.defineProperty(exports, "schedule", {
   enumerable: true,
-  get: function () { return chunk3OHMEMZA_cjs.schedule; }
+  get: function () { return chunkJ76M7XTS_cjs.schedule; }
 });
 Object.defineProperty(exports, "sleep", {
   enumerable: true,
-  get: function () { return chunk3OHMEMZA_cjs.sleep; }
+  get: function () { return chunkJ76M7XTS_cjs.sleep; }
 });
+exports.BoundedInteger = BoundedInteger;
+exports.DecodedEventReader = DecodedEventReader;
+exports.ExponentialBackoff = ExponentialBackoff;
+exports.HandedOutLedger = HandedOutLedger;
+exports.LaneLeaseTokenFormat = LaneLeaseTokenFormat;
+exports.NonEmptyText = NonEmptyText;
+exports.OwnerSerializedClaims = OwnerSerializedClaims;
+exports.SubscribingTransport = SubscribingTransport;
+exports.assertPositiveInteger = assertPositiveInteger;
 exports.createCloudEventReaders = createCloudEventReaders;
 exports.createJsonEnvelopeFormat = createJsonEnvelopeFormat;
 exports.fromHeader = fromHeader;
 exports.fromPayloadField = fromPayloadField;
 exports.isJsonObject = isJsonObject;
 exports.mediaTypeOf = mediaTypeOf;
+exports.observeRejection = observeRejection;
 exports.writeStructuredCloudEvent = writeStructuredCloudEvent;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map