@axorum/client 0.0.0-stage → 1.0.0

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/failover.d.ts

@@ -0,0 +1,197 @@
+/**
+ * Failing over between the service's API URLs: a mirror of `acton-service-client`
+ * 0.2.1's endpoint failover, which the Rust SDK uses, so both SDKs fail over alike.
+ *
+ * A clustered deployment serves the agent plane on every replica, and only the primary
+ * accepts a write: a follower answers `421 not_primary`. Given every replica's API URL
+ * ({@link AxorumClientOptions.failoverUrls}), a request that retries apply to moves on to
+ * the next URL, at once, when an attempt ends in a **rotation outcome**: a status the
+ * request lists (`authorize` lists `421`),
+ * a connection that never opened, or an attempt timeout. A status that is retriable by
+ * default (`429`, `502`, `503`, `504`, and `423` with `Retry-After`) is retried on the
+ * **same** URL after the policy's pause, and anything else ends the call. After a full
+ * cycle of rotations the client pauses before the next cycle. One deadline covers every
+ * attempt on every URL, and the client never sends to an origin outside the set.
+ *
+ * Every decision here is a pure function of the attempt history, the time remaining and
+ * the jitter draw: `acton-service-client`'s `spec/fixtures/endpoint-failover-v1.json`
+ * pins it for every port.
+ *
+ * @packageDocumentation
+ */
+import { type RetryPolicy } from "./retry.js";
+/**
+ * Why an attempt moved on (or would have): the same shape as the fixture's
+ * `{"kind":"status","status":N} | {"kind":"connect"} | {"kind":"timeout"}`.
+ */
+export type RotationReason = 
+/** The endpoint answered with this status. */
+{
+    readonly kind: "status";
+    readonly status: number;
+}
+/** The connection was never established, so no byte of the request left the process. */
+ | {
+    readonly kind: "connect";
+}
+/** The attempt ran out of time before an answer arrived. It may have been applied. */
+ | {
+    readonly kind: "timeout";
+};
+/**
+ * The counter the Rust SDK adds one to for every rotation, labelled `reason`
+ * ({@link rotationLabel}). The TypeScript SDK takes no metrics dependency: count
+ * {@link AxorumClientOptions.onRotation} under this name to put both SDKs on one
+ * dashboard.
+ */
+export declare const ROTATIONS_COUNTER = "acton_service_client.endpoint.rotations";
+/**
+ * The counter the Rust SDK adds one to for every re-send to the same endpoint, labelled
+ * `reason` like {@link ROTATIONS_COUNTER}. Count {@link AxorumClientOptions.onRetry}
+ * under it. A client with one URL only ever re-sends in place, so a deployment answering
+ * `421` to it shows up here.
+ */
+export declare const RETRIES_COUNTER = "acton_service_client.endpoint.retries";
+/**
+ * A short, stable label for a reason: the status code (`"421"`), `"connect"` or
+ * `"timeout"`. The same label the Rust SDK's rotation counter carries. Pure.
+ */
+export declare function rotationLabel(reason: RotationReason): string;
+/**
+ * One attempt of a request, in the order sent. A status carries the status only: the
+ * transport re-sends on the status alone and keeps no body, so a re-sent status never
+ * shows the code that would prove the attempt wrote nothing.
+ */
+export interface EndpointAttempt {
+    /** The origin the attempt was sent to, `scheme://host:port`. */
+    readonly endpoint: string;
+    /** How it ended. */
+    readonly outcome: RotationReason;
+    /**
+     * Whether the next attempt went to the next endpoint because of this outcome (`false`
+     * for a re-send to the same endpoint, and for the last attempt).
+     */
+    readonly rotated: boolean;
+}
+/** One attempt as prose: `origin: status 421`. Pure. */
+export declare function describeAttempt(attempt: EndpointAttempt): string;
+/**
+ * Why a failover set was refused, by the fixture's `error` shape. The base URL is
+ * endpoint 0; failover URLs are numbered from 1.
+ */
+export type EndpointSetRefusal = {
+    readonly kind: "not_an_origin";
+    readonly index: number;
+    readonly url: string;
+    readonly reason: string;
+} | {
+    readonly kind: "mixed_scheme";
+    readonly index: number;
+    readonly expected: string;
+    readonly found: string;
+} | {
+    readonly kind: "duplicate_origin";
+    readonly origin: string;
+    readonly first: number;
+    readonly duplicate: number;
+};
+/** A refusal as prose. Pure. */
+export declare function describeRefusal(refusal: EndpointSetRefusal): string;
+/**
+ * The endpoint set: the base URL's origin, then each failover URL's, normalized to
+ * `scheme://host:port`, or why it is refused. Each failover URL is checked in order: a
+ * bare http(s) origin, then the base URL's scheme, then a new origin. Pure.
+ */
+export declare function endpointSet(baseUrl: string, failovers: readonly string[]): {
+    readonly endpoints: readonly string[];
+} | {
+    readonly refusal: EndpointSetRefusal;
+};
+/** `url` with its origin replaced by `origin` (`scheme://host:port`). Pure. */
+export declare function onEndpoint(url: string, origin: string): string;
+/**
+ * How one attempt that did not succeed bears on the next: another try on the next
+ * endpoint (`rotate`), another on the same one (`retry`), or none (`final`).
+ */
+export type AttemptOutcome = {
+    readonly kind: "rotate";
+    readonly reason: RotationReason;
+    readonly retryAfterMs: number | undefined;
+} | {
+    readonly kind: "retry";
+    readonly status: number;
+    readonly retryAfterMs: number | undefined;
+} | {
+    readonly kind: "final";
+};
+/**
+ * Classifies a non-success response. A status in `retryOn` rotates (checked before
+ * `accepted`); otherwise an unaccepted status that is retriable by default retries in
+ * place. Pure.
+ */
+export declare function outcomeOfStatus(status: number, retryAfterMs: number | undefined, accepted: boolean, retryOn: readonly number[]): AttemptOutcome;
+/**
+ * Classifies a transport failure: a connection that never opened, then an attempt
+ * timeout, rotate; anything else (a connection broken after the request went out) is
+ * final. Pure.
+ */
+export declare function outcomeOfTransport(connect: boolean, timeout: boolean): AttemptOutcome;
+/**
+ * Why a call stopped without a success: the deadline passed before the first attempt
+ * (`nothing_sent`), the last outcome is returned as it is (`raw`), or the budget ran out
+ * after at least one rotation and the trace is returned (`exhausted`).
+ */
+export type Stop = "nothing_sent" | "raw" | "exhausted";
+/**
+ * How an attempt re-sends the previous one, as the observer hears of it: to the next
+ * endpoint, leaving `from`, or to the same endpoint again.
+ */
+export type Resend = {
+    readonly kind: "rotation";
+    readonly from: number;
+    readonly reason: RotationReason;
+} | {
+    readonly kind: "retry";
+    readonly reason: RotationReason;
+};
+/** The next attempt to send: its endpoint, its number in the call (from 1), and how it re-sends. */
+export interface Attempt {
+    readonly endpoint: number;
+    readonly number: number;
+    readonly resend: Resend | undefined;
+}
+/** When the next attempt goes out: at once (a rotation within a cycle), or after a pause. */
+export type Next = {
+    readonly kind: "now";
+} | {
+    readonly kind: "after";
+    readonly pauseMs: number;
+};
+/**
+ * The failover state of one call: which endpoint is next, and the counts every decision
+ * depends on. Deterministic: time and randomness are passed in.
+ *
+ * With one endpoint every decision is exactly the single-endpoint retry loop's.
+ */
+export declare class Failover {
+    #private;
+    /** A call over `len` endpoints (at least one) starting at `start`. */
+    constructor(len: number, start: number);
+    /** Attempts sent so far. */
+    get attempts(): number;
+    /** Before each send, with the time `remainingMs` before the deadline: the attempt, or why to stop. */
+    begin(remainingMs: number | undefined): Attempt | {
+        readonly stop: Stop;
+    };
+    /**
+     * After an attempt that did not succeed: when to send the next one, or why to stop.
+     * `policy` is `undefined` when retries do not apply to the request. `draw` is called
+     * only when a computed pause needs it.
+     */
+    after(outcome: AttemptOutcome, policy: RetryPolicy | undefined, draw: () => number, remainingMs: number | undefined): Next | {
+        readonly stop: Stop;
+    };
+    /** The trace so far, naming endpoints by `origins`. */
+    trace(origins: readonly string[]): EndpointAttempt[];
+}
+//# sourceMappingURL=failover.d.ts.map

package/dist/failover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failover.d.ts","sourceRoot":"","sources":["../src/failover.ts"],"names":[],"mappings":"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"}

package/dist/failover.js

@@ -0,0 +1,289 @@
+/**
+ * Failing over between the service's API URLs: a mirror of `acton-service-client`
+ * 0.2.1's endpoint failover, which the Rust SDK uses, so both SDKs fail over alike.
+ *
+ * A clustered deployment serves the agent plane on every replica, and only the primary
+ * accepts a write: a follower answers `421 not_primary`. Given every replica's API URL
+ * ({@link AxorumClientOptions.failoverUrls}), a request that retries apply to moves on to
+ * the next URL, at once, when an attempt ends in a **rotation outcome**: a status the
+ * request lists (`authorize` lists `421`),
+ * a connection that never opened, or an attempt timeout. A status that is retriable by
+ * default (`429`, `502`, `503`, `504`, and `423` with `Retry-After`) is retried on the
+ * **same** URL after the policy's pause, and anything else ends the call. After a full
+ * cycle of rotations the client pauses before the next cycle. One deadline covers every
+ * attempt on every URL, and the client never sends to an origin outside the set.
+ *
+ * Every decision here is a pure function of the attempt history, the time remaining and
+ * the jitter draw: `acton-service-client`'s `spec/fixtures/endpoint-failover-v1.json`
+ * pins it for every port.
+ *
+ * @packageDocumentation
+ */
+import { fitsBefore, isRetriableStatus, pause, shouldRetry } from "./retry.js";
+/**
+ * The counter the Rust SDK adds one to for every rotation, labelled `reason`
+ * ({@link rotationLabel}). The TypeScript SDK takes no metrics dependency: count
+ * {@link AxorumClientOptions.onRotation} under this name to put both SDKs on one
+ * dashboard.
+ */
+export const ROTATIONS_COUNTER = "acton_service_client.endpoint.rotations";
+/**
+ * The counter the Rust SDK adds one to for every re-send to the same endpoint, labelled
+ * `reason` like {@link ROTATIONS_COUNTER}. Count {@link AxorumClientOptions.onRetry}
+ * under it. A client with one URL only ever re-sends in place, so a deployment answering
+ * `421` to it shows up here.
+ */
+export const RETRIES_COUNTER = "acton_service_client.endpoint.retries";
+/**
+ * A short, stable label for a reason: the status code (`"421"`), `"connect"` or
+ * `"timeout"`. The same label the Rust SDK's rotation counter carries. Pure.
+ */
+export function rotationLabel(reason) {
+    return reason.kind === "status" ? String(reason.status) : reason.kind;
+}
+/** One attempt as prose: `origin: status 421`. Pure. */
+export function describeAttempt(attempt) {
+    const { outcome } = attempt;
+    const how = outcome.kind === "status"
+        ? `status ${outcome.status}`
+        : outcome.kind === "connect"
+            ? "connection never opened"
+            : "attempt timed out";
+    return `${attempt.endpoint}: ${how}`;
+}
+/** A refusal as prose. Pure. */
+export function describeRefusal(refusal) {
+    switch (refusal.kind) {
+        case "not_an_origin":
+            return `failover endpoint ${refusal.index} ('${refusal.url}') is not a bare http(s) origin: ${refusal.reason}`;
+        case "mixed_scheme":
+            return (`failover endpoint ${refusal.index} uses ${refusal.found}, but the base URL uses ` +
+                `${refusal.expected}; every endpoint must share one scheme`);
+        case "duplicate_origin":
+            return `endpoint ${refusal.duplicate} repeats endpoint ${refusal.first} (${refusal.origin})`;
+    }
+}
+/**
+ * The endpoint set: the base URL's origin, then each failover URL's, normalized to
+ * `scheme://host:port`, or why it is refused. Each failover URL is checked in order: a
+ * bare http(s) origin, then the base URL's scheme, then a new origin. Pure.
+ */
+export function endpointSet(baseUrl, failovers) {
+    const base = new URL(baseUrl);
+    const origins = [originOf(base)];
+    const scheme = schemeOf(base);
+    for (const [offset, raw] of failovers.entries()) {
+        const index = offset + 1;
+        const parsed = bareOrigin(raw);
+        if (typeof parsed === "string") {
+            return { refusal: { kind: "not_an_origin", index, url: raw, reason: parsed } };
+        }
+        if (schemeOf(parsed) !== scheme) {
+            return { refusal: { kind: "mixed_scheme", index, expected: scheme, found: schemeOf(parsed) } };
+        }
+        const origin = originOf(parsed);
+        const first = origins.indexOf(origin);
+        if (first !== -1) {
+            return { refusal: { kind: "duplicate_origin", origin, first, duplicate: index } };
+        }
+        origins.push(origin);
+    }
+    return { endpoints: origins };
+}
+/** `url` with its origin replaced by `origin` (`scheme://host:port`). Pure. */
+export function onEndpoint(url, origin) {
+    const moved = new URL(url);
+    const target = new URL(origin);
+    moved.protocol = target.protocol;
+    moved.hostname = target.hostname;
+    moved.port = target.port;
+    return moved.toString();
+}
+/** `raw` parsed as a bare `http(s)://host[:port]`, or the reason it is not one. */
+function bareOrigin(raw) {
+    let url;
+    try {
+        url = new URL(raw);
+    }
+    catch {
+        return "it is not a valid absolute URL";
+    }
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        return "its scheme must be http or https";
+    }
+    if (url.username !== "" || url.password !== "") {
+        return "it carries user info";
+    }
+    if (url.pathname !== "/" && url.pathname !== "") {
+        return "it has a path";
+    }
+    // `URL` drops an empty `?` and `#`; the raw text still carries them.
+    if (url.search !== "" || /\?/.test(raw)) {
+        return "it has a query";
+    }
+    if (url.hash !== "" || raw.includes("#")) {
+        return "it has a fragment";
+    }
+    if (url.hostname === "") {
+        return "it has no host";
+    }
+    return url;
+}
+function schemeOf(url) {
+    return url.protocol.replace(/:$/, "");
+}
+/** `scheme://host:port`, the default port filled in, the host lower-cased. */
+function originOf(url) {
+    const port = url.port !== "" ? url.port : url.protocol === "https:" ? "443" : "80";
+    return `${schemeOf(url)}://${url.hostname}:${port}`;
+}
+/**
+ * Classifies a non-success response. A status in `retryOn` rotates (checked before
+ * `accepted`); otherwise an unaccepted status that is retriable by default retries in
+ * place. Pure.
+ */
+export function outcomeOfStatus(status, retryAfterMs, accepted, retryOn) {
+    if (retryOn.includes(status)) {
+        return { kind: "rotate", reason: { kind: "status", status }, retryAfterMs };
+    }
+    if (!accepted && isRetriableStatus(status, retryAfterMs !== undefined)) {
+        return { kind: "retry", status, retryAfterMs };
+    }
+    return { kind: "final" };
+}
+/**
+ * Classifies a transport failure: a connection that never opened, then an attempt
+ * timeout, rotate; anything else (a connection broken after the request went out) is
+ * final. Pure.
+ */
+export function outcomeOfTransport(connect, timeout) {
+    if (connect) {
+        return { kind: "rotate", reason: { kind: "connect" }, retryAfterMs: undefined };
+    }
+    if (timeout) {
+        return { kind: "rotate", reason: { kind: "timeout" }, retryAfterMs: undefined };
+    }
+    return { kind: "final" };
+}
+/**
+ * The failover state of one call: which endpoint is next, and the counts every decision
+ * depends on. Deterministic: time and randomness are passed in.
+ *
+ * With one endpoint every decision is exactly the single-endpoint retry loop's.
+ */
+export class Failover {
+    #len;
+    #current;
+    #attempts = 0;
+    #pauses = 0;
+    /** Consecutive rotations since the last pause or same-endpoint retry. */
+    #streak = 0;
+    /**
+     * Over the rotations of the current cycle: `undefined` before the first, then the
+     * smallest `Retry-After` while every one carried one, and `null` once one did not.
+     */
+    #cycleRetryAfter = undefined;
+    /** A re-send decided but not yet sent (reported when the next attempt is sent). */
+    #pending = undefined;
+    #trace = [];
+    /** A call over `len` endpoints (at least one) starting at `start`. */
+    constructor(len, start) {
+        this.#len = Math.max(len, 1);
+        this.#current = start % this.#len;
+    }
+    /** Attempts sent so far. */
+    get attempts() {
+        return this.#attempts;
+    }
+    /** Before each send, with the time `remainingMs` before the deadline: the attempt, or why to stop. */
+    begin(remainingMs) {
+        if (remainingMs === 0) {
+            return { stop: this.#attempts === 0 ? "nothing_sent" : this.#spent() };
+        }
+        const resend = this.#pending;
+        this.#pending = undefined;
+        const left = this.#trace.at(-1);
+        if (resend?.kind === "rotation" && left !== undefined) {
+            left.rotated = true;
+        }
+        this.#attempts += 1;
+        return { endpoint: this.#current, number: this.#attempts, resend };
+    }
+    /**
+     * After an attempt that did not succeed: when to send the next one, or why to stop.
+     * `policy` is `undefined` when retries do not apply to the request. `draw` is called
+     * only when a computed pause needs it.
+     */
+    after(outcome, policy, draw, remainingMs) {
+        if (outcome.kind === "final") {
+            return { stop: "raw" };
+        }
+        const reason = outcome.kind === "rotate" ? outcome.reason : { kind: "status", status: outcome.status };
+        this.#trace.push({ endpoint: this.#current, outcome: reason, rotated: false });
+        if (policy === undefined) {
+            return { stop: "raw" };
+        }
+        if (!shouldRetry(policy, this.#attempts)) {
+            return { stop: this.#spent() };
+        }
+        if (this.#len > 1 && outcome.kind === "rotate") {
+            return this.#rotate(policy, reason, outcome.retryAfterMs, draw, remainingMs);
+        }
+        this.#streak = 0;
+        this.#cycleRetryAfter = undefined;
+        const pauseMs = this.#pause(policy, outcome.retryAfterMs, draw, remainingMs);
+        if (typeof pauseMs !== "number") {
+            return pauseMs;
+        }
+        this.#pending = { kind: "retry", reason };
+        return { kind: "after", pauseMs };
+    }
+    /** The trace so far, naming endpoints by `origins`. */
+    trace(origins) {
+        return this.#trace.flatMap((entry) => {
+            const endpoint = origins[entry.endpoint];
+            return endpoint === undefined ? [] : [{ endpoint, outcome: entry.outcome, rotated: entry.rotated }];
+        });
+    }
+    #rotate(policy, reason, retryAfterMs, draw, remainingMs) {
+        this.#streak += 1;
+        const carried = retryAfterMs ?? null;
+        this.#cycleRetryAfter =
+            this.#cycleRetryAfter === undefined
+                ? carried
+                : this.#cycleRetryAfter === null || carried === null
+                    ? null
+                    : Math.min(this.#cycleRetryAfter, carried);
+        let next = { kind: "now" };
+        if (this.#streak % this.#len === 0) {
+            const server = this.#cycleRetryAfter ?? undefined;
+            this.#cycleRetryAfter = undefined;
+            const pauseMs = this.#pause(policy, server, draw, remainingMs);
+            if (typeof pauseMs !== "number") {
+                return pauseMs;
+            }
+            next = { kind: "after", pauseMs };
+        }
+        this.#pending = { kind: "rotation", from: this.#current, reason };
+        this.#current = (this.#current + 1) % this.#len;
+        return next;
+    }
+    /** The server's `Retry-After` if given, else the policy's backoff, if it ends before the deadline. */
+    #pause(policy, retryAfterMs, draw, remainingMs) {
+        // Drawn only when a jittered pause needs it: with `jitter: "none"` the draw is
+        // unused, as the fixture pins.
+        const pauseMs = retryAfterMs === undefined
+            ? pause(policy, this.#pauses + 1, policy.jitter === "full" ? draw() : 0, remainingMs)
+            : fitsBefore(retryAfterMs, remainingMs);
+        if (pauseMs === undefined) {
+            return { stop: this.#spent() };
+        }
+        this.#pauses += 1;
+        return pauseMs;
+    }
+    /** The budget is spent: the trace once the call has rotated, the last outcome otherwise. */
+    #spent() {
+        return this.#trace.some((entry) => entry.rotated) ? "exhausted" : "raw";
+    }
+}
+//# sourceMappingURL=failover.js.map

package/dist/failover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failover.js","sourceRoot":"","sources":["../src/failover.ts"],"names":[],"mappings":"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"}

package/dist/freshness.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Whether an attestation will still be valid for as long as a submission may take.
+ *
+ * The service checks one thing about time: `now < exp`, with no leeway. A token that
+ * expires while a submission is being re-sent is refused on the late attempt, possibly
+ * after an earlier one committed. So `authorize` bounds each submission, every send and
+ * every wait between sends, by a deadline {@link ATTESTATION_CLOCK_ALLOWANCE_MS} before
+ * the token's `exp` ({@link submissionDeadline}); a wait that would reach it ends the
+ * re-sends. The call's own budget ({@link AUTHORIZE_DEADLINE_MS}) bounds the submission
+ * too: it ends at whichever of the two comes first. Before it sends, it checks that at
+ * least {@link ATTESTATION_MIN_REMAINING_MS} is left, and asks for a fresh token when less
+ * is.
+ *
+ * The payload is read, never verified: the signature is the service's to check.
+ *
+ * @packageDocumentation
+ */
+/**
+ * How long before a token's `exp` a submission stops sending: room for the clocks of
+ * the issuer, this process and the service to disagree, since the service allows none.
+ */
+export declare const ATTESTATION_CLOCK_ALLOWANCE_MS = 30000;
+/**
+ * How long a token must still be valid when a submission starts (45 s): the whole
+ * {@link AUTHORIZE_DEADLINE_MS} plus the {@link ATTESTATION_CLOCK_ALLOWANCE_MS}. The
+ * submission's deadline is the earlier of the call's and the token's `exp` less the
+ * allowance ({@link submissionDeadline}), so a token that passes this check never cuts a
+ * submission shorter than the call's own budget does.
+ */
+export declare const ATTESTATION_MIN_REMAINING_MS: number;
+/**
+ * The deadline of a submission whose attestation expires at `expMs` (epoch
+ * milliseconds): `expMs` less {@link ATTESTATION_CLOCK_ALLOWANCE_MS}, read against the
+ * wall clock once (`wallNowMs`) and returned on the monotonic clock `monoNowMs` is read
+ * from, so a wall-clock step does not move it. `undefined` when that point has passed,
+ * and nothing may be sent. Pure.
+ */
+export declare function submissionDeadline(expMs: number, wallNowMs: number, monoNowMs: number): number | undefined;
+/**
+ * The token's `exp` in epoch milliseconds, or why its claims cannot be read. Pure; never
+ * verifies the signature.
+ */
+export declare function attestationExpiryMs(token: string): number | string;
+/** What {@link attestationFreshness} found. */
+export type Freshness = {
+    readonly state: "fresh";
+    readonly expiresAt: string;
+} | {
+    readonly state: "expiring";
+    readonly expiresAt: string;
+} | {
+    readonly state: "unreadable";
+    readonly problem: string;
+};
+/**
+ * Whether `token` is valid for at least `minRemainingMs` after `nowMs`, compared in whole
+ * milliseconds (digits of `exp` below a millisecond truncate). Pure; the same rule as the
+ * Rust SDK, pinned by `spec/fixtures/attestation-freshness-v1.json`.
+ */
+export declare function attestationFreshness(token: string, nowMs: number, minRemainingMs: number): Freshness;
+/** Milliseconds since the epoch for an RFC 3339 date-time, or `undefined`. Pure. */
+export declare function parseRfc3339Ms(text: string): number | undefined;
+/** `YYYY-MM-DDTHH:MM:SS[.mmm]Z`, the milliseconds only when not zero. Pure. */
+export declare function formatUtcMs(ms: number): string;
+//# sourceMappingURL=freshness.d.ts.map

package/dist/freshness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness.d.ts","sourceRoot":"","sources":["../src/freshness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH;;;GAGG;AACH,eAAO,MAAM,8BAA8B,QAAS,CAAC;AAErD;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,QAAyD,CAAC;AAEnG;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG1G;AAaD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAUlE;AAED,+CAA+C;AAC/C,MAAM,MAAM,SAAS,GACjB;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAK/D;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,SAAS,CAOpG;AA0CD,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAgC/D;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE9C"}