@relaybus/core 0.3.0 → 0.3.1

package/dist/internal/index.js

@@ -1,5 +1,10 @@
-import { ConfigurationError, assertEventType } from '../chunk-WS274DL3.js';
-export { assertPositiveInteger, schedule, sleep } from '../chunk-WS274DL3.js';
+import { PositiveInteger, ConfigurationError, assertEventType, DeliveryLeaseIdentity } from '../chunk-NOR5JHVN.js';
+export { CompositeKey, DeliveryLeaseIdentity, LeaseSettlement, Milliseconds, PositiveInteger, schedule, sleep } from '../chunk-NOR5JHVN.js';
+
+// src/internal/validation.ts
+function assertPositiveInteger(value, name) {
+  return PositiveInteger.of(value, name);
+}
 
 // src/internal/field-extractors.ts
 function fromHeader(name) {
@@ -84,7 +89,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",
@@ -92,19 +97,7 @@ 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 ConfigurationError("jsonEnvelope needs a mapping object");
@@ -222,6 +215,111 @@ function assertCompatiblePaths(path, other) {
     throw new 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 {
+    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 = [];
@@ -320,106 +418,200 @@ 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 {
-    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(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(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 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 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);
+  }
+};
 
-export { createCloudEventReaders, createJsonEnvelopeFormat, fromHeader, fromPayloadField, isJsonObject, mediaTypeOf, writeStructuredCloudEvent };
+export { BoundedInteger, DecodedEventReader, ExponentialBackoff, HandedOutLedger, LaneLeaseTokenFormat, NonEmptyText, OwnerSerializedClaims, SubscribingTransport, assertPositiveInteger, createCloudEventReaders, createJsonEnvelopeFormat, fromHeader, fromPayloadField, isJsonObject, mediaTypeOf, observeRejection, writeStructuredCloudEvent };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map