mppx 0.8.15 → 0.8.17

package/dist/Store.d.ts

@@ -1,3 +1,4 @@
+import type { MaybePromise } from './internal/types.js';
 export type StoreItemMap = Record<string, unknown>;
 /**
  * Describes the outcome of an atomic {@link Update} callback.
@@ -27,6 +28,13 @@ export type Change<value, result> = {
  * must be synchronous and free of side effects.
  */
 export type Update<itemMap extends StoreItemMap = StoreItemMap> = <key extends keyof itemMap & string, result>(key: key, fn: (current: itemMap[key] | null) => Change<itemMap[key], result>) => Promise<result>;
+/** Attempts to atomically record first use of a replay key through its expiry. */
+export type TryClaim<itemMap extends StoreItemMap = StoreItemMap> = <key extends keyof itemMap & string>(key: key, expires: number) => MaybePromise<boolean>;
+/** Persisted marker used by the {@link tryClaim} fallback. */
+export type ReplayMarker = {
+    expires: number;
+    type: 'mppx:replay';
+};
 /** Base key-value actions available on every {@link Store}. */
 export type StoreActions<itemMap extends StoreItemMap = StoreItemMap> = {
     get: <key extends keyof itemMap & string>(key: key) => Promise<itemMap[key] | null>;
@@ -36,6 +44,8 @@ export type StoreActions<itemMap extends StoreItemMap = StoreItemMap> = {
 /** Atomic actions that can be provided via the `extended` slot. */
 export type AtomicActions<itemMap extends StoreItemMap = StoreItemMap> = {
     update: Update<itemMap>;
+    /** Optional single-operation fast path for recording expiring replay keys. */
+    tryClaim?: TryClaim<itemMap> | undefined;
 };
 /**
  * Async key-value store.
@@ -54,6 +64,15 @@ export type Store<itemMap extends StoreItemMap = StoreItemMap, extended extends
  * Equivalent to `Store<itemMap, AtomicActions<itemMap>>`.
  */
 export type AtomicStore<itemMap extends StoreItemMap = StoreItemMap> = Store<itemMap, AtomicActions<itemMap>>;
+/**
+ * Attempts to atomically record first use of a replay key through its expiry.
+ *
+ * Returns `true` when this call recorded the key and `false` when it was already
+ * recorded and unexpired. `expires` is a Unix timestamp in milliseconds.
+ * Uses the adapter's optimized primitive when available and otherwise falls
+ * back to {@link AtomicStore.update}.
+ */
+export declare function tryClaim<itemMap extends StoreItemMap, key extends keyof itemMap & string>(store: AtomicStore<itemMap>, key: key, expires: number): MaybePromise<boolean>;
 /** Options shared by store constructors. */
 export type Options = {
     /** Prefix prepended to every backing store key. */

package/dist/Store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Store.d.ts","sourceRoot":"","sources":["../src/Store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Store.d.ts","sourceRoot":"","sources":["../src/Store.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAElD;;;;;;;;GAQG;AACH,MAAM,MAAM,MAAM,CAAC,KAAK,EAAE,MAAM,IAC5B;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpC;;;;;;GAMG;AACH,MAAM,MAAM,MAAM,CAAC,OAAO,SAAS,YAAY,GAAG,YAAY,IAAI,CAChE,GAAG,SAAS,MAAM,OAAO,GAAG,MAAM,EAClC,MAAM,EAEN,GAAG,EAAE,GAAG,EACR,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,KAAK,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,KAC/D,OAAO,CAAC,MAAM,CAAC,CAAA;AAEpB,kFAAkF;AAClF,MAAM,MAAM,QAAQ,CAAC,OAAO,SAAS,YAAY,GAAG,YAAY,IAAI,CAClE,GAAG,SAAS,MAAM,OAAO,GAAG,MAAM,EAElC,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,MAAM,KACZ,YAAY,CAAC,OAAO,CAAC,CAAA;AAE1B,8DAA8D;AAC9D,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,aAAa,CAAA;CACpB,CAAA;AAED,+DAA+D;AAC/D,MAAM,MAAM,YAAY,CAAC,OAAO,SAAS,YAAY,GAAG,YAAY,IAAI;IACtE,GAAG,EAAE,CAAC,GAAG,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAA;IACnF,GAAG,EAAE,CAAC,GAAG,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzF,MAAM,EAAE,CAAC,GAAG,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACxE,CAAA;AAED,mEAAmE;AACnE,MAAM,MAAM,aAAa,CAAC,OAAO,SAAS,YAAY,GAAG,YAAY,IAAI;IACvE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,SAAS,CAAA;CACzC,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,KAAK,CACf,OAAO,SAAS,YAAY,GAAG,YAAY,EAC3C,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,SAAS,IAC9D,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,GAAG,OAAO,CAAC,CAAA;AAE3F;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,CAAC,OAAO,SAAS,YAAY,GAAG,YAAY,IAAI,KAAK,CAC1E,OAAO,EACP,aAAa,CAAC,OAAO,CAAC,CACvB,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,OAAO,SAAS,YAAY,EAAE,GAAG,SAAS,MAAM,OAAO,GAAG,MAAM,EACvF,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,EAC3B,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,MAAM,GACd,YAAY,CAAC,OAAO,CAAC,CAWvB;AAaD,4CAA4C;AAC5C,MAAM,MAAM,OAAO,GAAG;IACpB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC/B,CAAA;AAID,+DAA+D;AAC/D,wBAAgB,IAAI,CAAC,KAAK,SAAS,WAAW,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,KAAK,CAAA;AAC5F,wBAAgB,IAAI,CAAC,KAAK,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,KAAK,CAAA;AAqEtF,uCAAuC;AACvC,wBAAgB,UAAU,CACxB,EAAE,EAAE,UAAU,CAAC,gBAAgB,EAC/B,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,GAC3B,WAAW,CAAA;AACd,wBAAgB,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,GAAG,KAAK,CAAA;AAqB1F,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,KAAY,OAAO,GAAG;QACpB,mDAAmD;QACnD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC/B,CAAA;IAED,KAAY,UAAU,GAAG;QACvB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;QACtC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;QAClD,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;QACtC,MAAM,CAAC,EAAE,CAAC,MAAM,EACd,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KACnD,OAAO,CAAC,MAAM,CAAC,CAAA;KACrB,CAAA;IAED,KAAY,gBAAgB,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG;QAC1D,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAA;KAC1C,CAAA;CACF;AAED,8FAA8F;AAC9F,wBAAgB,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,WAAW,CAgC5D;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,KAAY,OAAO,GAAG;QACpB,mDAAmD;QACnD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC/B,CAAA;CACF;AAED,mEAAmE;AACnE,wBAAgB,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,gBAAgB,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,WAAW,CAAA;AAC3F,wBAAgB,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAA;AAqB/E,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,KAAY,OAAO,GAAG;QACpB,mDAAmD;QACnD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC/B,CAAA;IAED,KAAY,UAAU,GAAG;QACvB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;QAC5C,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;QACrD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;QACtC,MAAM,CAAC,EAAE,CAAC,MAAM,EACd,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KACnD,OAAO,CAAC,MAAM,CAAC,CAAA;KACrB,CAAA;IAED,KAAY,gBAAgB,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG;QAC1D,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAA;KAC1C,CAAA;CACF;AAED,wDAAwD;AACxD,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,gBAAgB,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,GAAG,WAAW,CAAA;AAChG,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,GAAG,KAAK,CAAA;AAuBpF,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,KAAY,OAAO,GAAG;QACpB,mDAAmD;QACnD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC/B,CAAA;IAED,KAAY,UAAU,GAAG;QACvB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;QACtC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;QACtD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;QACtC,MAAM,CAAC,EAAE,CAAC,MAAM,EACd,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KACrD,OAAO,CAAC,MAAM,CAAC,CAAA;KACrB,CAAA;IAED,KAAY,gBAAgB,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG;QAC1D,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAA;KAC1C,CAAA;CACF"}

package/dist/Store.js

@@ -15,6 +15,35 @@
  * `AtomicActions`, just like Viem's `PublicClient = Client<..., PublicActions>`.
  */
 import { Json } from 'ox';
+/**
+ * Attempts to atomically record first use of a replay key through its expiry.
+ *
+ * Returns `true` when this call recorded the key and `false` when it was already
+ * recorded and unexpired. `expires` is a Unix timestamp in milliseconds.
+ * Uses the adapter's optimized primitive when available and otherwise falls
+ * back to {@link AtomicStore.update}.
+ */
+export function tryClaim(store, key, expires) {
+    if (store.tryClaim)
+        return store.tryClaim(key, expires);
+    return store.update(key, (current) => {
+        if (current !== null && (!isReplayMarker(current) || current.expires > Date.now()))
+            return { op: 'noop', result: false };
+        return {
+            op: 'set',
+            value: { expires, type: 'mppx:replay' },
+            result: true,
+        };
+    });
+}
+function isReplayMarker(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'expires' in value &&
+        typeof value.expires === 'number' &&
+        'type' in value &&
+        value.type === 'mppx:replay');
+}
 const keyPrefixCache = new WeakMap();
 export function from(store, options) {
     return withKeyPrefix(store, options?.keyPrefix);
@@ -44,6 +73,13 @@ function withKeyPrefix(store, keyPrefix = '') {
                 },
             }
             : {}),
+        ...('tryClaim' in store && typeof store.tryClaim === 'function'
+            ? {
+                tryClaim(key, expires) {
+                    return store.tryClaim(prefixedKey(key), expires);
+                },
+            }
+            : {}),
     });
     const cachedByPrefix = keyPrefixCache.get(store) ?? new Map();
     cachedByPrefix.set(keyPrefix, prefixed);
@@ -107,6 +143,13 @@ export function memory(options) {
                 store.delete(key);
             return change.result;
         },
+        tryClaim(key, expires) {
+            const current = store.has(key) ? Json.parse(store.get(key)) : null;
+            if (current !== null && (!isReplayMarker(current) || current.expires > Date.now()))
+                return false;
+            store.set(key, Json.stringify({ expires, type: 'mppx:replay' }));
+            return true;
+        },
     }, options);
 }
 export function redis(client, options) {

package/dist/Store.js.map

@@ -1 +1 @@
-{"version":3,"file":"Store.js","sourceRoot":"","sources":["../src/Store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAA;AA4EzB,MAAM,cAAc,GAAG,IAAI,OAAO,EAA2C,CAAA;AAK7E,MAAM,UAAU,IAAI,CAAC,KAA0B,EAAE,OAAiB;IAChE,OAAO,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,CAAA;AACjD,CAAC;AAED,SAAS,aAAa,CAAC,KAA0B,EAAE,SAAS,GAAG,EAAE;IAC/D,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAA;IAE5B,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,SAAS,CAAC,CAAA;IACxD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,MAAM,OAAO,GAAG,KAAc,CAAA;IAC9B,MAAM,WAAW,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,SAAS,GAAG,GAAG,EAAE,CAAA;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC;QACpB,KAAK,CAAC,GAAG,CAAC,GAAW;YACnB,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAqB,CAAA;QAC1D,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAc;YACnC,MAAM,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAA;QAC5C,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,GAAW;YACtB,MAAM,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAA;QACxC,CAAC;QACD,GAAG,CAAC,QAAQ,IAAI,KAAK;YACnB,CAAC,CAAC;gBACE,KAAK,CAAC,MAAM,CACV,GAAW,EACX,EAAwD;oBAExD,OAAQ,KAAqB,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAW,CAAC,CAAA;gBACrE,CAAC;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACsB,CAAC,CAAA;IAEhC,MAAM,cAAc,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,EAA+B,CAAA;IAC1F,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IACvC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,cAAc,CAAC,CAAA;IACzC,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAS,cAAc,CACrB,MAKa;IAEb,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAA;IACtB,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE;YAClB,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE;gBAC7B,MAAM,MAAM,GAAG,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAW,CAAA;gBACtE,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC,CAAA;gBACzB,IAAI,MAAM,CAAC,EAAE,KAAK,KAAK;oBAAE,OAAO,MAAM,CAAA;gBACtC,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;YAC3D,CAAC,CAAC,CAAA;QACJ,CAAC;KACsB,CAAA;AAC3B,CAAC;AAQD,MAAM,UAAU,UAAU,CAAC,EAAyB,EAAE,OAA4B;IAChF,OAAO,IAAI,CACT;QACE,KAAK,CAAC,GAAG,CAAC,GAAW;YACnB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAC7B,IAAI,GAAG,IAAI,IAAI;gBAAE,OAAO,IAAW,CAAA;YACnC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAa,CAAC,CAAA;QAClC,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAc;YACnC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;QAC1C,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,GAAW;YACtB,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACtB,CAAC;QACD,GAAG,cAAc,CAAC,EAAE,CAAC,MAAM,CAAC;KAC7B,EACD,OAAO,CACR,CAAA;AACH,CAAC;AAuBD,8FAA8F;AAC9F,MAAM,UAAU,MAAM,CAAC,OAAwB;IAC7C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAA;IACvC,OAAO,IAAI,CACT;QACE,KAAK,CAAC,GAAG,CAAC,GAAW;YACnB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAC1B,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,IAAW,CAAA;YACzC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACxB,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAc;YACnC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;QACvC,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,GAAW;YACtB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACnB,CAAC;QACD,KAAK,CAAC,MAAM,CAAS,GAAW,EAAE,EAAwD;YACxF,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAE,CAAW,CAAC,CAAC,CAAC,IAAI,CAAA;YAC9E,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,CAAA;YAC1B,IAAI,MAAM,CAAC,EAAE,KAAK,KAAK;gBAAE,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;YACrE,IAAI,MAAM,CAAC,EAAE,KAAK,QAAQ;gBAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAC7C,OAAO,MAAM,CAAC,MAAM,CAAA;QACtB,CAAC;KACF,EACD,OAAO,CACR,CAAA;AACH,CAAC;AAYD,MAAM,UAAU,KAAK,CAAC,MAAwB,EAAE,OAAuB;IACrE,OAAO,IAAI,CACT;QACE,KAAK,CAAC,GAAG,CAAC,GAAW;YACnB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YACjC,IAAI,GAAG,IAAI,IAAI;gBAAE,OAAO,IAAW,CAAA;YACnC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACxB,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAc;YACnC,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;QAC9C,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,GAAW;YACtB,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACvB,CAAC;QACD,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC;KACjC,EACD,OAAO,CACR,CAAA;AACH,CAAC;AA0BD,MAAM,UAAU,OAAO,CAAC,KAAyB,EAAE,OAAyB;IAC1E,OAAO,IAAI,CACT;QACE,KAAK,CAAC,GAAG,CAAC,GAAW;YACnB,OAAO,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAQ,CAAA;QACtC,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAc;YACnC,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAC7B,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,GAAW;YACtB,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACtB,CAAC;QACD,GAAG,CAAC,KAAK,CAAC,MAAM;YACd,CAAC,CAAC;gBACE,MAAM,EAAE,KAAK,CAAC,MAAgB;aAC/B;YACH,CAAC,CAAC,EAAE,CAAC;KACR,EACD,OAAO,CACR,CAAA;AACH,CAAC"}
+{"version":3,"file":"Store.js","sourceRoot":"","sources":["../src/Store.ts"],"names":[],"mappings":"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"}

package/dist/attestation/Client.d.ts

@@ -0,0 +1,17 @@
+import type * as Types from './Types.js';
+/**
+ * Combines request signers using one shared context per call.
+ *
+ * The returned signer creates a fresh context unless its caller supplies one,
+ * allowing every signature on one HTTP attempt to share a nonce and timestamp.
+ */
+export declare function composeSigners(...signers: readonly [Types.Signer, ...Types.Signer[]]): Types.Signer<'composed'>;
+/**
+ * Wraps a fetch implementation so every outbound request is attested.
+ *
+ * Configure this wrapper as the underlying `fetch` passed to `mppx/client`
+ * `Fetch.from()`. MPPX then uses it for both the initial request and its
+ * automatic request containing an `Authorization: Payment` credential.
+ */
+export declare function wrapFetch(fetch: typeof globalThis.fetch, signer: Types.Signer): typeof globalThis.fetch;
+//# sourceMappingURL=Client.d.ts.map

package/dist/attestation/Client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../../src/attestation/Client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AAExC;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,GAAG,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,GACrD,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAQ1B;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,EAC9B,MAAM,EAAE,KAAK,CAAC,MAAM,GACnB,OAAO,UAAU,CAAC,KAAK,CAEzB"}

package/dist/attestation/Client.js

@@ -0,0 +1,28 @@
+import * as SigningContext from './internal/SigningContext.js';
+/**
+ * Combines request signers using one shared context per call.
+ *
+ * The returned signer creates a fresh context unless its caller supplies one,
+ * allowing every signature on one HTTP attempt to share a nonce and timestamp.
+ */
+export function composeSigners(...signers) {
+    return {
+        protocol: 'composed',
+        async sign(request, context = SigningContext.create()) {
+            for (const signer of signers)
+                request = await signer.sign(request, context);
+            return request;
+        },
+    };
+}
+/**
+ * Wraps a fetch implementation so every outbound request is attested.
+ *
+ * Configure this wrapper as the underlying `fetch` passed to `mppx/client`
+ * `Fetch.from()`. MPPX then uses it for both the initial request and its
+ * automatic request containing an `Authorization: Payment` credential.
+ */
+export function wrapFetch(fetch, signer) {
+    return async (input, init) => fetch(await signer.sign(new Request(input, init)));
+}
+//# sourceMappingURL=Client.js.map

package/dist/attestation/Client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.js","sourceRoot":"","sources":["../../src/attestation/Client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,8BAA8B,CAAA;AAG9D;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAG,OAAmD;IAEtD,OAAO;QACL,QAAQ,EAAE,UAAU;QACpB,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAAC,MAAM,EAAE;YACnD,KAAK,MAAM,MAAM,IAAI,OAAO;gBAAE,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC3E,OAAO,OAAO,CAAA;QAChB,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CACvB,KAA8B,EAC9B,MAAoB;IAEpB,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;AAClF,CAAC"}

package/dist/attestation/Constants.d.ts

@@ -0,0 +1,15 @@
+/** RFC 9421 signature algorithms supported by request attestation. */
+export declare const Algorithms: {
+    /** EdDSA using the Ed25519 curve. */
+    readonly ed25519: 'ed25519';
+    /** RSASSA-PSS using SHA-512 and a 64-byte salt. */
+    readonly rsaPssSha512: 'rsa-pss-sha512';
+};
+/** HTTP headers defined by RFC 9421 for request-attestation signatures. */
+export declare const Headers: {
+    /** Carries the RFC 9421 signature bytes. */
+    readonly signature: 'Signature';
+    /** Carries the RFC 9421 covered components and signature parameters. */
+    readonly signatureInput: 'Signature-Input';
+};
+//# sourceMappingURL=Constants.d.ts.map

package/dist/attestation/Constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Constants.d.ts","sourceRoot":"","sources":["../../src/attestation/Constants.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,eAAO,MAAM,UAAU;IACrB,qCAAqC;aACrC,OAAO,EAAE,SAAS;IAClB,mDAAmD;aACnD,YAAY,EAAE,gBAAgB;CACtB,CAAA;AAEV,2EAA2E;AAC3E,eAAO,MAAM,OAAO;IAClB,4CAA4C;aAC5C,SAAS,EAAE,WAAW;IACtB,wEAAwE;aACxE,cAAc,EAAE,iBAAiB;CACzB,CAAA"}

package/dist/attestation/Constants.js

@@ -0,0 +1,15 @@
+/** RFC 9421 signature algorithms supported by request attestation. */
+export const Algorithms = {
+    /** EdDSA using the Ed25519 curve. */
+    ed25519: 'ed25519',
+    /** RSASSA-PSS using SHA-512 and a 64-byte salt. */
+    rsaPssSha512: 'rsa-pss-sha512',
+};
+/** HTTP headers defined by RFC 9421 for request-attestation signatures. */
+export const Headers = {
+    /** Carries the RFC 9421 signature bytes. */
+    signature: 'Signature',
+    /** Carries the RFC 9421 covered components and signature parameters. */
+    signatureInput: 'Signature-Input',
+};
+//# sourceMappingURL=Constants.js.map

package/dist/attestation/Constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Constants.js","sourceRoot":"","sources":["../../src/attestation/Constants.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,qCAAqC;IACrC,OAAO,EAAE,SAAS;IAClB,mDAAmD;IACnD,YAAY,EAAE,gBAAgB;CACtB,CAAA;AAEV,2EAA2E;AAC3E,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,4CAA4C;IAC5C,SAAS,EAAE,WAAW;IACtB,wEAAwE;IACxE,cAAc,EAAE,iBAAiB;CACzB,CAAA"}

package/dist/attestation/Server.d.ts

@@ -0,0 +1,4 @@
+import type * as Types from './Types.js';
+/** Verifies every configured request-attestation protocol. */
+export declare function verify<const verifiers extends Types.VerifierMap>(request: Request, verifiers: verifiers): Promise<Types.VerificationsFrom<verifiers>>;
+//# sourceMappingURL=Server.d.ts.map

package/dist/attestation/Server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Server.d.ts","sourceRoot":"","sources":["../../src/attestation/Server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AAExC,8DAA8D;AAC9D,wBAAsB,MAAM,CAAC,KAAK,CAAC,SAAS,SAAS,KAAK,CAAC,WAAW,EACpE,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAK7C"}

package/dist/attestation/Server.js

@@ -0,0 +1,8 @@
+/** Verifies every configured request-attestation protocol. */
+export async function verify(request, verifiers) {
+    const outcomes = {};
+    for (const [name, verifier] of Object.entries(verifiers))
+        outcomes[name] = await verifier.verify(request);
+    return outcomes;
+}
+//# sourceMappingURL=Server.js.map

package/dist/attestation/Server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Server.js","sourceRoot":"","sources":["../../src/attestation/Server.ts"],"names":[],"mappings":"AAEA,8DAA8D;AAC9D,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,OAAgB,EAChB,SAAoB;IAEpB,MAAM,QAAQ,GAAuC,EAAE,CAAA;IACvD,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;QACtD,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACjD,OAAO,QAA8C,CAAA;AACvD,CAAC"}

package/dist/attestation/Types.d.ts

@@ -0,0 +1,76 @@
+import type { MaybePromise } from '../internal/types.js';
+import type { Algorithms } from './Constants.js';
+/** RFC 9421 algorithms implemented by the request-attestation signer and verifier. */
+export type SignatureAlgorithm = (typeof Algorithms)[keyof typeof Algorithms];
+/** Resolves a trusted public key for a parsed request signature. */
+export type KeyResolver = (parameters: {
+    /** RFC 9421 algorithm declared by the signature. */
+    algorithm: SignatureAlgorithm;
+    /** Key identifier declared by the signature. */
+    keyId: string;
+    /** Request carrying the signature. */
+    request: Request;
+}) => MaybePromise<CryptoKey | undefined>;
+/**
+ * The complete outcome of attempting one protocol verifier.
+ *
+ * `absent` means the protocol did not appear on the request. `invalid` means
+ * it appeared but failed validation and must reject the request. `unverified`
+ * means key material or another required verification dependency was unavailable.
+ * `verified` carries protocol-specific data that is safe for callers to inspect.
+ */
+export type Verification<value = unknown> = {
+    status: 'absent';
+} | {
+    status: 'invalid';
+    reason: string;
+} | {
+    status: 'unverified';
+    reason: string;
+} | {
+    status: 'verified';
+    value: value;
+};
+/**
+ * Verifies one request-attestation protocol carried by an HTTP request.
+ *
+ * Verifiers are registered in a {@link VerifierMap}; each map key names the
+ * result returned to the caller.
+ */
+export type Verifier<value = unknown> = {
+    /** Validates the request and returns a complete protocol verification outcome. */
+    verify: (request: Request) => MaybePromise<Verification<value>>;
+};
+/** Maps each recognized protocol name to its verifier. */
+export type VerifierMap = Readonly<Record<string, Verifier>>;
+/** Preserves each configured protocol's complete verification outcome. */
+export type VerificationsFrom<verifiers extends VerifierMap> = {
+    readonly [protocol in keyof verifiers]: Awaited<ReturnType<verifiers[protocol]['verify']>>;
+};
+/**
+ * Values shared by every signer contributing to one HTTP request attempt.
+ *
+ * A caller may reuse this context across independent signature protocols so
+ * they describe the same attempt. A later network retry must use a new context.
+ */
+export type SigningContext = {
+    /** Unix timestamp, in seconds, at which the request attempt was created. */
+    readonly created: number;
+    /** Base64url-encoded random value identifying this request attempt. */
+    readonly nonce: string;
+};
+/**
+ * Signs each outbound HTTP request, including MPP payment retries.
+ *
+ * The protocol type preserves which adapter produced the signer for diagnostics
+ * and composition, without asserting that the signer alone authorizes payment.
+ */
+export type Signer<protocol extends string = string> = {
+    /** Protocol identifier used for diagnostics. */
+    protocol: protocol;
+    /** Returns a new request containing the protocol's signature material. */
+    sign: (request: Request, context?: SigningContext | undefined) => MaybePromise<Request>;
+};
+/** Maps application-defined names to request-attestation signers. */
+export type SignerMap = Readonly<Record<string, Signer>>;
+//# sourceMappingURL=Types.d.ts.map

package/dist/attestation/Types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Types.d.ts","sourceRoot":"","sources":["../../src/attestation/Types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD,sFAAsF;AACtF,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAA;AAE7E,oEAAoE;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,UAAU,EAAE;IACrC,oDAAoD;IACpD,SAAS,EAAE,kBAAkB,CAAA;IAC7B,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAA;IACb,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAA;CACjB,KAAK,YAAY,CAAC,SAAS,GAAG,SAAS,CAAC,CAAA;AAEzC;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,CAAC,KAAK,GAAG,OAAO,IACpC;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GACpB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAA;AAExC;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,CAAC,KAAK,GAAG,OAAO,IAAI;IACtC,kFAAkF;IAClF,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAA;CAChE,CAAA;AAED,0DAA0D;AAC1D,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;AAE5D,0EAA0E;AAC1E,MAAM,MAAM,iBAAiB,CAAC,SAAS,SAAS,WAAW,IAAI;IAC7D,QAAQ,EAAE,QAAQ,IAAI,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;CAC3F,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,MAAM,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,IAAI;IACrD,gDAAgD;IAChD,QAAQ,EAAE,QAAQ,CAAA;IAClB,0EAA0E;IAC1E,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,KAAK,YAAY,CAAC,OAAO,CAAC,CAAA;CACxF,CAAA;AAED,qEAAqE;AACrE,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA"}

package/dist/attestation/Types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Types.js.map

package/dist/attestation/Types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Types.js","sourceRoot":"","sources":["../../src/attestation/Types.ts"],"names":[],"mappings":""}

package/dist/attestation/index.d.ts

@@ -0,0 +1,6 @@
+export * as Client from './Client.js';
+export * as Server from './Server.js';
+export * as Store from '../Store.js';
+export * from './Constants.js';
+export * from './Types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/attestation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/attestation/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,aAAa,CAAA;AACpC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA"}

package/dist/attestation/index.js

@@ -0,0 +1,6 @@
+export * as Client from './Client.js';
+export * as Server from './Server.js';
+export * as Store from '../Store.js';
+export * from './Constants.js';
+export * from './Types.js';
+//# sourceMappingURL=index.js.map

package/dist/attestation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/attestation/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,aAAa,CAAA;AACpC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA"}

package/dist/attestation/internal/HttpMessageSignature.d.ts

@@ -0,0 +1,73 @@
+import type { BareItem } from 'structured-headers';
+import type { MaybePromise } from '../../internal/types.js';
+import * as Store from '../../Store.js';
+import type { KeyResolver, SignatureAlgorithm, SigningContext } from '../Types.js';
+/** RFC 9421 constants used by request-attestation signature profiles. */
+export declare const Constants: {
+    /** Derived request components supported by this narrow request profile. */
+    readonly components: {
+        /** The target host and non-default port. */
+        readonly authority: '@authority';
+        /** The request URL path without its query string. */
+        readonly path: '@path';
+        /** The lowercased `Signature-Agent` request header. */
+        readonly signatureAgent: 'signature-agent';
+        /** The signature's canonicalized covered-components and parameters. */
+        readonly signatureParams: '@signature-params';
+    };
+};
+/** A covered HTTP message component and its RFC 9421 component parameters. */
+export type Component = {
+    /** Derived component identifier or lowercased HTTP field name. */
+    id: string;
+    /** Parameters that qualify the component, such as `;key="agent"`. */
+    parameters?: ReadonlyMap<string, BareItem> | undefined;
+};
+/** Input accepted by signers; bare strings denote unparameterized components. */
+export type ComponentInput = string | Component;
+export type SignatureInput = {
+    algorithm: SignatureAlgorithm;
+    components: readonly Component[];
+    created: number;
+    expires: number;
+    keyId: string;
+    label: string;
+    nonce: string;
+    parameters: ReadonlyMap<string, BareItem>;
+    tag: string;
+};
+/** Result of validating one supported RFC 9421 signature. */
+export type VerificationResult = {
+    status: 'absent';
+} | {
+    status: 'invalid';
+    reason: string;
+} | {
+    status: 'unverified';
+    reason: string;
+} | {
+    status: 'verified';
+    input: SignatureInput;
+};
+/** Signs a request using the configured RFC 9421-derived component list. */
+export declare function sign(request: Request, options: {
+    components: readonly ComponentInput[];
+    expiresIn?: number | undefined;
+    keyId: string;
+    key: CryptoKey;
+    label: string;
+    context?: SigningContext | undefined;
+    tag: string;
+}): Promise<Request>;
+/** Verifies a request signature, its lifetime, and optionally its nonce. */
+export declare function verify(request: Request, options: {
+    keyResolver: KeyResolver;
+    maxAge: number;
+    nonceNamespace: string;
+    nonceStore: Store.AtomicStore;
+    requiredComponents: readonly string[];
+    tag: string | readonly string[];
+    validate?: ((input: SignatureInput, request: Request) => string | undefined) | undefined;
+    validateKey?: ((key: CryptoKey, input: SignatureInput, request: Request) => MaybePromise<string | undefined>) | undefined;
+}): Promise<VerificationResult>;
+//# sourceMappingURL=HttpMessageSignature.d.ts.map

package/dist/attestation/internal/HttpMessageSignature.d.ts.map

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