@relaybus/core 0.3.0 → 0.4.0

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,8 @@ 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 TIME_FORMATS = ["rfc3339", "epoch-millis", "epoch-seconds"];
 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");
@@ -116,16 +110,55 @@ function compile(mapping, transportIds) {
       optional[name] = toLocation(field, name);
     }
   }
+  const payload = compilePayload(mapping.payload);
+  const topLevelHeaders = mapping.headers === "top-level-fields";
+  if (topLevelHeaders && payload === void 0) {
+    throw new ConfigurationError("jsonEnvelope headers 'top-level-fields' needs a body payload");
+  }
   const plan = {
     type: compileType(mapping.type),
     id: compileId(mapping.id, transportIds),
+    idWhenMissing: isJsonObject(mapping.id) && "whenMissing" in mapping.id,
     optional,
-    payload: compilePayload(mapping.payload),
-    headers: compileHeaders(mapping.headers),
-    mappedHeaders: /* @__PURE__ */ new Set()
+    payload,
+    headers: topLevelHeaders ? void 0 : compileHeaders(mapping.headers),
+    topLevelHeaders,
+    topLevelNames: /* @__PURE__ */ new Set(),
+    mappedHeaders: /* @__PURE__ */ new Set(),
+    timeFormat: compileTimeFormat(mapping.occurredAt),
+    ...compileExtras(mapping, payload !== void 0)
   };
   return assertDisjoint(plan);
 }
+function compileTimeFormat(field) {
+  const format = isJsonObject(field) ? field["format"] : void 0;
+  if (format === void 0) {
+    return "rfc3339";
+  }
+  if (!TIME_FORMATS.includes(format)) {
+    throw new ConfigurationError(
+      `jsonEnvelope occurredAt format must be one of ${TIME_FORMATS.map((name) => `'${name}'`).join(", ")}`
+    );
+  }
+  return format;
+}
+function compileExtras(mapping, hasBody) {
+  const extra = mapping.extra ?? {};
+  const bodyOrder = mapping.bodyOrder ?? [];
+  if (!hasBody && (extra.body !== void 0 || bodyOrder.length > 0)) {
+    throw new ConfigurationError(
+      "jsonEnvelope with a whole-body payload has no body for extra values or a body order"
+    );
+  }
+  return {
+    extraBody: Object.entries(extra.body ?? {}).map(([path, value]) => ({
+      path: toPath(path, "extra body value"),
+      value
+    })),
+    extraHeaders: Object.entries(extra.headers ?? {}),
+    bodyOrder
+  };
+}
 function compileType(type) {
   if (isJsonObject(type) && typeof type["fixed"] === "string") {
     assertEventType(type["fixed"]);
@@ -140,11 +173,15 @@ function compileId(id, transportIds) {
   if (typeof id === "string" && transportIds.includes(id)) {
     return void 0;
   }
+  const names = transportIds.map((name) => `'${name}'`).join(", ");
   if (!isJsonObject(id)) {
     throw new ConfigurationError(
-      `jsonEnvelope needs an id: { body }, { header } or one of ${transportIds.map((name) => `'${name}'`).join(", ")}`
+      `jsonEnvelope needs an id: { body }, { header } or one of ${names}`
     );
   }
+  if ("whenMissing" in id && !transportIds.includes(id["whenMissing"])) {
+    throw new ConfigurationError(`jsonEnvelope id whenMissing must be one of ${names}`);
+  }
   return toLocation(id, "id");
 }
 function compilePayload(payload) {
@@ -193,17 +230,25 @@ function assertDisjoint(plan) {
   const locations = [plan.type, plan.id, ...Object.values(plan.optional)].filter(
     (location) => location !== void 0 && !("fixed" in location)
   );
-  const headers = locations.flatMap((location) => "header" in location ? [location.header] : []);
+  const headers = [
+    ...locations.flatMap((location) => "header" in location ? [location.header] : []),
+    ...plan.extraHeaders.map(([name]) => name)
+  ];
   const duplicate = headers.find((name, index) => headers.indexOf(name) !== index);
   if (duplicate !== void 0) {
     throw new ConfigurationError(`jsonEnvelope maps header '${duplicate}' twice`);
   }
   const paths = [
     ...locations.flatMap((location) => "path" in location ? [location.path] : []),
-    ...[plan.payload, plan.headers].filter((path) => path !== void 0)
+    ...[plan.payload, plan.headers].filter((path) => path !== void 0),
+    ...plan.extraBody.map(({ path }) => path)
   ];
   assertNoNestedPaths(paths);
-  return { ...plan, mappedHeaders: new Set(headers) };
+  return {
+    ...plan,
+    mappedHeaders: new Set(headers),
+    topLevelNames: new Set(paths.map((path) => path[0]))
+  };
 }
 function assertNoNestedPaths(paths) {
   paths.forEach((path, index) => {
@@ -222,44 +267,198 @@ 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;
+var EPOCH_PATTERN = /^\d+$/;
+var MILLISECONDS_PER_SECOND = 1e3;
+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: readId(read(plan.id), context),
+    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), context)
+  };
+  return Object.fromEntries(
+    Object.entries(fields).filter((entry) => entry[1] !== void 0)
+  );
+}
+function readId(id, { plan, failures }) {
+  if (plan.id === void 0 || plan.idWhenMissing) {
+    return id;
+  }
+  return requireText(id, { location: plan.id, failures });
+}
+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.topLevelHeaders) {
+    return textEntries(
+      Object.entries(message.body).filter(
+        ([name]) => !plan.topLevelNames.has(name)
+      )
+    );
+  }
+  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) ? textEntries(Object.entries(headers)) : {};
+}
+function textEntries(entries) {
+  return Object.fromEntries(
+    entries.filter((entry) => typeof entry[1] === "string")
+  );
+}
+function readTime(text, { plan, failures }) {
+  if (text === void 0) {
+    return void 0;
+  }
+  if (plan.timeFormat !== "rfc3339") {
+    const time2 = new Date(
+      Number(text) * (plan.timeFormat === "epoch-seconds" ? MILLISECONDS_PER_SECOND : 1)
+    );
+    if (!EPOCH_PATTERN.test(text) || Number.isNaN(time2.getTime())) {
+      throw failures.invalid(`The event time is not a whole ${plan.timeFormat} number: '${text}'`);
+    }
+    return time2;
+  }
+  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;
+var MILLISECONDS_PER_SECOND2 = 1e3;
 function writeMessage(envelope, { plan, failures }) {
   const root = {};
   const headers = [];
   const put = (location, value) => {
     if ("header" in location) {
-      headers.push([location.header, value]);
+      headers.push([location.header, String(value)]);
     } else {
       setAt(root, { path: location.path, value });
     }
   };
-  if ("fixed" in plan.type) {
-    if (envelope.type !== plan.type.fixed) {
-      throw failures.unencodable(
-        `Event ${envelope.id} has type '${envelope.type}', but this route carries only '${plan.type.fixed}'`
-      );
-    }
-  } else {
-    put(plan.type, envelope.type);
+  const typeAt = typeLocation(envelope, { plan, failures });
+  if (typeAt !== void 0) {
+    put(typeAt, envelope.type);
   }
   if (plan.id !== void 0) {
     put(plan.id, envelope.id);
   }
-  for (const [name, value] of optionalValues(envelope, failures)) {
+  for (const [name, value] of optionalValues(envelope, { plan, failures })) {
     const location = plan.optional[name];
     if (location !== void 0 && value !== null) {
       put(location, value);
     }
   }
+  const body = writeBody(envelope, { plan, root });
+  if (plan.topLevelHeaders) {
+    spreadHeaders(envelope, { plan, failures, root: body });
+  }
   return {
-    body: writeBody(envelope, { plan, root }),
-    headers: Object.fromEntries([...eventHeaderEntries(envelope, { plan, failures }), ...headers])
+    body,
+    headers: Object.fromEntries([
+      ...eventHeaderEntries(envelope, { plan, failures }),
+      ...headers,
+      ...extraHeaderEntries(envelope, plan)
+    ])
   };
 }
-function optionalValues(envelope, failures) {
+function typeLocation(envelope, { plan, failures }) {
+  if (!("fixed" in plan.type)) {
+    return plan.type;
+  }
+  if (envelope.type !== plan.type.fixed) {
+    throw failures.unencodable(
+      `Event ${envelope.id} has type '${envelope.type}', but this route carries only '${plan.type.fixed}'`
+    );
+  }
+  return void 0;
+}
+function extraHeaderEntries(envelope, plan) {
+  return plan.extraHeaders.map(([name, value]) => [
+    name,
+    typeof value === "function" ? value(envelope) : value
+  ]);
+}
+function optionalValues(envelope, { plan, failures }) {
   return [
     ["key", envelope.key],
     ["source", envelope.source],
-    ["occurredAt", formatTime(envelope, failures)],
+    [
+      "occurredAt",
+      timeValue(formatTime(envelope, failures), { envelope, format: plan.timeFormat })
+    ],
     ["correlationId", envelope.correlationId],
     ["causationId", envelope.causationId]
   ];
@@ -275,10 +474,43 @@ function writeBody(envelope, { plan, root }) {
       value: Object.fromEntries(Object.entries(envelope.headers))
     });
   }
-  return root;
+  for (const { path, value } of plan.extraBody) {
+    setAt(root, { path, value: typeof value === "function" ? value(envelope) : value });
+  }
+  return ordered(root, plan.bodyOrder);
+}
+function spreadHeaders(envelope, { plan, failures, root }) {
+  for (const [name, value] of Object.entries(envelope.headers)) {
+    if (plan.topLevelNames.has(name)) {
+      throw failures.unencodable(
+        `Event ${envelope.id} has a header '${name}', which the mapping uses for another body field`
+      );
+    }
+    setAt(root, { path: [name], value });
+  }
+}
+function timeValue(text, { envelope, format }) {
+  const milliseconds = envelope.occurredAt.getTime();
+  if (format === "epoch-millis") {
+    return milliseconds;
+  }
+  return format === "epoch-seconds" ? Math.floor(milliseconds / MILLISECONDS_PER_SECOND2) : text;
+}
+function ordered(root, order) {
+  if (order.length === 0) {
+    return root;
+  }
+  const result = {};
+  const names = [...order.filter((name) => Object.hasOwn(root, name)), ...Object.keys(root)];
+  for (const name of names) {
+    if (!Object.hasOwn(result, name)) {
+      defineValue(result, { name, value: root[name] });
+    }
+  }
+  return result;
 }
 function eventHeaderEntries(envelope, { plan, failures }) {
-  if (plan.headers !== void 0) {
+  if (plan.headers !== void 0 || plan.topLevelHeaders) {
     return [];
   }
   const entries = Object.entries(envelope.headers);
@@ -320,106 +552,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