@bananapus/nana-sdk-core 6.2.0 → 6.3.0

package/dist/cjs/review/confirming.d.ts

@@ -0,0 +1,8 @@
+/**
+ * How long a claimed `onConfirmed` notice stays pending unless its claimant
+ * renews it: only a claim whose tab closed or crashed mid-delivery lapses.
+ */
+export declare const CONFIRMING_STALE_MS: number;
+/** How often a claimant still delivering renews its claim. */
+export declare const CONFIRMING_RENEW_MS: number;
+//# sourceMappingURL=confirming.d.ts.map

package/dist/cjs/review/confirming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirming.d.ts","sourceRoot":"","sources":["../../../src/review/confirming.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAAa,CAAC;AAC9C,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB,QAA0B,CAAC"}

package/dist/cjs/review/confirming.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIRMING_RENEW_MS = exports.CONFIRMING_STALE_MS = void 0;
+/**
+ * How long a claimed `onConfirmed` notice stays pending unless its claimant
+ * renews it: only a claim whose tab closed or crashed mid-delivery lapses.
+ */
+exports.CONFIRMING_STALE_MS = 5 * 60_000;
+/** How often a claimant still delivering renews its claim. */
+exports.CONFIRMING_RENEW_MS = exports.CONFIRMING_STALE_MS / 5;
+//# sourceMappingURL=confirming.js.map

package/dist/cjs/review/confirming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirming.js","sourceRoot":"","sources":["../../../src/review/confirming.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,mBAAmB,GAAG,CAAC,GAAG,MAAM,CAAC;AAC9C,8DAA8D;AACjD,QAAA,mBAAmB,GAAG,2BAAmB,GAAG,CAAC,CAAC"}

package/dist/cjs/review/locks.d.ts

@@ -1,10 +1,29 @@
-/** Thrown by {@link LockHandle.assertHeld} once this tab no longer holds the lock. */
-export declare class LockLostError extends Error {
+import { ReviewFixedLineError } from "./lineError.js";
+/**
+ * Thrown by {@link LockHandle.assertHeld} once this tab no longer holds the
+ * lock. Its message is for logs; `errorLine` shows {@link LOCK_LOST_LINE}.
+ */
+export declare class LockLostError extends ReviewFixedLineError {
     readonly lock: string;
     readonly name = "LockLostError";
     readonly code = "LOCK_LOST";
+    get line(): string;
     constructor(lock: string);
 }
+/**
+ * How a receipt's `ended()` ends while its step's `onConfirmed` is queued
+ * behind the run's own locks (kept for one it lost, or another
+ * completion's claim waiting for one): it is told once that work ends,
+ * and only then acknowledged, so the wait never holds it up. Retry later;
+ * nothing is sent again. `errorLine` shows {@link CONFIRMATION_QUEUED_LINE}.
+ */
+export declare class ConfirmationQueuedError extends ReviewFixedLineError {
+    readonly step: number;
+    readonly name = "ConfirmationQueuedError";
+    readonly code = "CONFIRMATION_QUEUED";
+    get line(): string;
+    constructor(step: number);
+}
 /**
  * The lock {@link browserLocks} hands its work. Native Web Locks never lose
  * it. The IndexedDB lease can: a tab suspended past its lease (as while the
@@ -30,6 +49,40 @@ export type LockHandle = {
  * write under several locks: `await assertLocksHeld([a, b]); save()`.
  */
 export declare function assertLocksHeld(locks?: readonly (Pick<LockHandle, "assertHeld"> | null | undefined)[]): Promise<void>;
+/**
+ * Whether the work `lock` was handed may still be running: anything kept
+ * for its name (an outcome refused for it, or another's queued behind it)
+ * waits until it ends. Only a fenced handle can say it ended.
+ */
+export declare const lockWorkRunning: (lock: LockHandle) => boolean;
+/**
+ * Saves an outcome the work already has from outside (a wallet's hash, a
+ * definite rejection) under `locks`: `write()` runs now, and resolves true
+ * (once any lock's work ended, it is kept straight away, so it never runs
+ * ahead of an outcome kept before it).
+ * Its own writes check the locks right before writing. Refused for a lost
+ * lock (`LockLostError`), it resolves false and the outcome is kept: once
+ * the work under every one of `locks` has ended, each lock is taken again
+ * (the same handles read as held again) and, after a fresh check:
+ *
+ * - with `later`, it runs whenever the locks are free. `later` re-reads the
+ *   saved record, matches this attempt by its identity (its attempt or
+ *   reservation id, never the whole record) and merges the outcome into the
+ *   latest record, so another tab's unrelated update meanwhile stays;
+ * - without, `write()` runs again only if no other tab took the locks since,
+ *   so it can't touch a newer attempt's record.
+ *
+ * If any lock can't be taken back, or the write fails, the record stays as
+ * the lost lock left it and its recovery shows. `settled` is told once
+ * whether a kept outcome was applied in the end (a claim it consumed is
+ * then made for good, or given back so it stays retryable); one written
+ * at once resolves true without it.
+ *
+ * Any lock {@link fencedLocks} or {@link browserLocks} handed out is kept
+ * this way: a native one once its work ended, a lease also once it lapsed.
+ * Any other failure of `write` throws, as does a lost lock that isn't one.
+ */
+export declare function keepOutcome(locks: readonly LockHandle[] | undefined, write: () => unknown, later?: () => unknown, settled?: (applied: boolean) => unknown): Promise<boolean>;
 /** What {@link BrowserLocks} runs under the lock: `null` when `ifAvailable` found it taken. */
 export type LockWork<T> = (lock: LockHandle | null) => T | PromiseLike<T>;
 /**
@@ -42,15 +95,43 @@ export type BrowserLocks = {
 };
 type AnyLocks = Pick<LockManager, "request">;
 /**
- * Any Web Locks manager (`navigator.locks`, a test's) handing a
- * {@link LockHandle}: a handle it hands already passes through; any other
- * lock is never lost while its work runs.
+ * Any Web Locks manager (`navigator.locks`, a test's, the SDK's own) handing
+ * a {@link LockHandle}: one it hands already is read through; any other
+ * lock is never lost while its work runs. Each handle keeps the outcomes
+ * {@link keepOutcome} refused for it, the same for every backend, and
+ * stamps who took the lock last.
  */
 export declare function fencedLocks(locks: AnyLocks | BrowserLocks | RawLocks): BrowserLocks;
 type RawWork<T> = (lock: LockHandle | null) => Promise<T>;
-type RawLocks = {
+export type RawLocks = {
     request<T>(name: string, options: LockOptions, work: RawWork<T>): Promise<T>;
 };
+/** Writes one at a time per name within one tab, queued in `queues`. */
+declare function tabLocksOn(queues: Map<string, Promise<void>>): RawLocks;
+export declare const LEASE_MS = 15000;
+type Lease = {
+    owner: string;
+    expires: number;
+};
+type Claim = "take" | "renew";
+/** Where the origin's leases live: each call one atomic compare-and-set. */
+export type LeaseStore = {
+    claim(name: string, owner: string, claim: Claim): Promise<boolean>;
+    read(name: string): Promise<Lease | undefined>;
+    drop(name: string, owner: string): Promise<void>;
+};
+export declare function idbLeases(factory: IDBFactory, now: () => number): () => Promise<LeaseStore>;
+/**
+ * The origin's leases in memory, for tests: each call answers a task later,
+ * as IndexedDB's transactions do.
+ */
+export declare function memoryLeases(now: () => number): LeaseStore;
+/**
+ * Locks over the origin's `leases`, one at a time per name within the tab
+ * (`tab`), its clock `now`.
+ */
+export declare function leaseLocks(leases: () => Promise<LeaseStore>, tab?: RawLocks, now?: () => number): RawLocks;
+export { tabLocksOn };
 /**
  * The browser's Web Locks. Where a browser or wallet webview has none, an
  * IndexedDB lease shared by the origin's tabs (one transaction, no visible
@@ -65,5 +146,4 @@ type RawLocks = {
  * narrows that window to the time between the check and the write.
  */
 export declare function browserLocks(): BrowserLocks;
-export {};
 //# sourceMappingURL=locks.d.ts.map

package/dist/cjs/review/locks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locks.d.ts","sourceRoot":"","sources":["../../../src/review/locks.ts"],"names":[],"mappings":"AAEA,sFAAsF;AACtF,qBAAa,aAAc,SAAQ,KAAK;IAG1B,QAAQ,CAAC,IAAI,EAAE,MAAM;IAFjC,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,IAAI,eAAe;gBACP,IAAI,EAAE,MAAM;CAGlC;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,2DAA2D;IAC3D,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,oDAAoD;IACpD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,KAAK,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GACrE,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,+FAA+F;AAC/F,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,KAAK,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AAE1E;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,OAAO,CAAC,CAAC,EACP,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAChB,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;CACxB,CAAC;AAEF,KAAK,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AAiC7C;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,QAAQ,GAAG,YAAY,GAAG,QAAQ,GACxC,YAAY,CAkBd;AAED,KAAK,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAC1D,KAAK,QAAQ,GAAG;IACd,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC9E,CAAC;AAwKF;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,IAAI,YAAY,CAa3C"}
+{"version":3,"file":"locks.d.ts","sourceRoot":"","sources":["../../../src/review/locks.ts"],"names":[],"mappings":"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"}