@automerge/automerge-repo 2.5.4 → 2.5.6

package/dist/DocHandle.d.ts

@@ -21,7 +21,7 @@ export declare class DocHandle<T> extends EventEmitter<DocHandleEvents<T>> {
     #private;
     documentId: DocumentId;
     /** @hidden */
-    constructor(documentId: DocumentId, options?: DocHandleOptions<T>);
+    constructor(documentId: DocumentId, refConstructor: <TDoc, TPath extends readonly PathInput[]>(handle: DocHandle<TDoc>, path: [...TPath]) => Ref<any>, options?: DocHandleOptions<T>);
     /** Our documentId in Automerge URL form.
      */
     get url(): AutomergeUrl;
@@ -57,7 +57,7 @@ export declare class DocHandle<T> extends EventEmitter<DocHandleEvents<T>> {
      */
     inState: (states: HandleState[]) => boolean;
     /** @hidden */
-    get state(): "unavailable" | "idle" | "loading" | "requesting" | "ready" | "unloaded" | "deleted";
+    get state(): "idle" | "loading" | "requesting" | "ready" | "unavailable" | "unloaded" | "deleted";
     /**
      * Returns promise that resolves when document is in one of the given states (default is 'ready' state)
      *
@@ -263,7 +263,8 @@ export type SyncInfo = {
     lastSyncTimestamp: number;
 };
 /** @hidden */
-export type DocHandleOptions<T> = {
+export type DocHandleOptions<T> = // NEW DOCUMENTS
+{
     /** If we know this is a new document (because we're creating it) this should be set to true. */
     isNew: true;
     /** The initial value of the document. */

package/dist/DocHandle.d.ts.map

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

package/dist/DocHandle.js

@@ -7,7 +7,6 @@ import { encode } from "./helpers/cbor.js";
 import { headsAreSame } from "./helpers/headsAreSame.js";
 import { withTimeout } from "./helpers/withTimeout.js";
 import { AbortError, isAbortErrorLike, } from "./helpers/abortable.js";
-import { RefImpl } from "./refs/ref.js";
 /**
  * A DocHandle is a wrapper around a single Automerge document that lets us listen for changes and
  * notify the network and storage of new changes.
@@ -39,10 +38,13 @@ export class DocHandle extends EventEmitter {
     #viewCache = new Map();
     /** Cache for ref instances, keyed by serialized path */
     #refCache = new Map();
+    /** Factory for creating Ref instances, injected by Repo to avoid circular imports */
+    #refConstructor;
     /** @hidden */
-    constructor(documentId, options = {}) {
+    constructor(documentId, refConstructor, options = {}) {
         super();
         this.documentId = documentId;
+        this.#refConstructor = refConstructor;
         if ("timeoutDelay" in options && options.timeoutDelay) {
             this.#timeoutDelay = options.timeoutDelay;
         }
@@ -367,7 +369,7 @@ export class DocHandle extends EventEmitter {
             return cachedHandle;
         }
         // Create a new handle with the same documentId but fixed heads
-        const handle = new DocHandle(this.documentId, {
+        const handle = new DocHandle(this.documentId, this.#refConstructor, {
             heads,
             timeoutDelay: this.#timeoutDelay,
         });
@@ -624,7 +626,7 @@ export class DocHandle extends EventEmitter {
             return existingRef;
         }
         // Create new ref and cache it
-        const newRef = new RefImpl(this, segments);
+        const newRef = this.#refConstructor(this, segments);
         this.#refCache.set(cacheKey, new WeakRef(newRef));
         return newRef;
     }

package/dist/Repo.d.ts.map

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

package/dist/Repo.js

@@ -5,11 +5,17 @@ import { binaryToDocumentId, encodeHeads, generateAutomergeUrl, interpretAsDocum
 import { DELETED, DocHandle, READY, UNAVAILABLE, UNLOADED, } from "./DocHandle.js";
 import { RemoteHeadsSubscriptions } from "./RemoteHeadsSubscriptions.js";
 import { headsAreSame } from "./helpers/headsAreSame.js";
-import { throttle } from "./helpers/throttle.js";
+import { asyncThrottle } from "./helpers/throttle.js";
 import { NetworkSubsystem } from "./network/NetworkSubsystem.js";
 import { StorageSubsystem } from "./storage/StorageSubsystem.js";
 import { CollectionSynchronizer } from "./synchronizer/CollectionSynchronizer.js";
 import { abortable, AbortError } from "./helpers/abortable.js";
+import { RefImpl } from "./refs/ref.js";
+import { foreverPromise } from "./helpers/foreverPromise.js";
+import { noop } from "./helpers/noop.js";
+import { truePromiseFactory } from "./helpers/truePromiseFactory.js";
+import { isPlainObject } from "./helpers/isPlainObject.js";
+import { hasAtLeastOneKey } from "./helpers/has-at-least-one-key.js";
 function randomPeerId() {
     return ("peer-" + Math.random().toString(36).slice(4));
 }
@@ -35,8 +41,8 @@ export class Repo extends EventEmitter {
     /** @hidden */
     synchronizer;
     #shareConfig = {
-        announce: async () => true,
-        access: async () => true,
+        announce: truePromiseFactory,
+        access: truePromiseFactory,
     };
     /** maps peer id to to persistence information (storageId, isEphemeral), access by collection synchronizer  */
     /** @hidden */
@@ -58,7 +64,7 @@ export class Repo extends EventEmitter {
         if (sharePolicy) {
             this.#shareConfig = {
                 announce: sharePolicy,
-                access: async () => true,
+                access: truePromiseFactory,
             };
         }
         if (shareConfig) {
@@ -102,16 +108,13 @@ export class Repo extends EventEmitter {
             this.#saveFn = ({ handle, doc }) => {
                 let fn = this.#saveFns[handle.documentId];
                 if (!fn) {
-                    fn = throttle(({ doc, handle }) => {
-                        void this.storageSubsystem.saveDoc(handle.documentId, doc);
-                    }, this.#saveDebounceRate);
-                    this.#saveFns[handle.documentId] = fn;
+                    fn = this.#saveFns[handle.documentId] = asyncThrottle(({ doc, handle, }) => this.storageSubsystem.saveDoc(handle.documentId, doc), this.#saveDebounceRate);
                 }
-                fn({ handle, doc });
+                void fn({ handle, doc });
             };
         }
         else {
-            this.#saveFn = () => { };
+            this.#saveFn = noop;
         }
         // NETWORK
         // The network subsystem deals with sending and receiving messages to and from peers.
@@ -250,11 +253,9 @@ export class Repo extends EventEmitter {
         }
         let handler = this.#throttledSaveSyncStateHandlers[storageId];
         if (!handler) {
-            handler = this.#throttledSaveSyncStateHandlers[storageId] = throttle(({ documentId, syncState }) => {
-                void this.storageSubsystem.saveSyncState(documentId, storageId, syncState);
-            }, this.#saveDebounceRate);
+            handler = this.#throttledSaveSyncStateHandlers[storageId] = asyncThrottle(({ documentId, syncState }) => this.storageSubsystem.saveSyncState(documentId, storageId, syncState), this.#saveDebounceRate);
         }
-        handler(payload);
+        void handler(payload);
     }
     /** Returns an existing handle if we have it; creates one otherwise. */
     #getHandle({ documentId, }) {
@@ -264,7 +265,7 @@ export class Repo extends EventEmitter {
         // If not, create a new handle, cache it, and return it
         if (!documentId)
             throw new Error(`Invalid documentId ${documentId}`);
-        const handle = new DocHandle(documentId);
+        const handle = new DocHandle(documentId, (handle, path) => new RefImpl(handle, path));
         this.#handleCache[documentId] = handle;
         return handle;
     }
@@ -305,7 +306,8 @@ export class Repo extends EventEmitter {
      */
     create(initialValue) {
         let initialDoc;
-        if (initialValue) {
+        // If the initial value is an empty object, use the empty change initialisation path instead of the from path
+        if (isPlainObject(initialValue) && hasAtLeastOneKey(initialValue)) {
             initialDoc = Automerge.from(initialValue);
         }
         else {
@@ -456,7 +458,7 @@ export class Repo extends EventEmitter {
         };
         progressSignal.notify(initial);
         // Start the loading process
-        void this.#loadDocumentWithProgress(id, documentId, handle, progressSignal, signal ? abortable(new Promise(() => { }), signal) : new Promise(() => { }));
+        void this.#loadDocumentWithProgress(id, documentId, handle, progressSignal, signal ? abortable(foreverPromise, signal) : foreverPromise);
         const result = {
             ...initial,
             peek: progressSignal.peek,

package/dist/helpers/abortable.d.ts

@@ -26,6 +26,7 @@ export declare const isAbortErrorLike: (candidate: unknown) => boolean;
  * @remarks
  * This utility wraps a Promise and rejects when the provided AbortSignal is aborted.
  * It's designed to make Promise awaits abortable.
+ * It is unnecessary for async APIs like `fetch()` that support abort already
  *
  * @example
  * ```typescript
@@ -40,6 +41,8 @@ export declare const isAbortErrorLike: (candidate: unknown) => boolean;
  *   }
  * }
  *
+ * // fetch already supports signal; so abortable() is NOT needed:
+ * const a = await fetch(url, { signal });
  * ```
  *
  * @param p - A Promise to wrap

package/dist/helpers/abortable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abortable.d.ts","sourceRoot":"","sources":["../../src/helpers/abortable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,qBAAa,UAAW,SAAQ,YAAY;gBAC9B,OAAO,CAAC,EAAE,MAAM;CAG7B;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,OAAO,KAAG,OAQrD,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EACb,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,CAAC,CAAC,CAsBZ;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB"}
+{"version":3,"file":"abortable.d.ts","sourceRoot":"","sources":["../../src/helpers/abortable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,qBAAa,UAAW,SAAQ,YAAY;gBAC9B,OAAO,CAAC,EAAE,MAAM;CAG7B;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,OAAO,KAAG,OAQrD,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EACb,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,CAAC,CAAC,CAuBZ;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB"}

package/dist/helpers/abortable.js

@@ -34,6 +34,7 @@ export const isAbortErrorLike = (candidate) => {
  * @remarks
  * This utility wraps a Promise and rejects when the provided AbortSignal is aborted.
  * It's designed to make Promise awaits abortable.
+ * It is unnecessary for async APIs like `fetch()` that support abort already
  *
  * @example
  * ```typescript
@@ -48,6 +49,8 @@ export const isAbortErrorLike = (candidate) => {
  *   }
  * }
  *
+ * // fetch already supports signal; so abortable() is NOT needed:
+ * const a = await fetch(url, { signal });
  * ```
  *
  * @param p - A Promise to wrap
@@ -57,13 +60,16 @@ export const isAbortErrorLike = (candidate) => {
  * @throws {DOMException} With name "AbortError" if aborted before p settles
  */
 export function abortable(p, signal) {
+    if (signal?.aborted)
+        return Promise.reject(signal.reason);
     let settled = false;
     return new Promise((resolve, reject) => {
-        signal?.addEventListener("abort", () => {
+        const onAbort = () => {
             if (!settled) {
                 reject(new AbortError());
             }
-        }, { once: true });
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
         p.then(result => {
             resolve(result);
         })
@@ -72,6 +78,9 @@ export function abortable(p, signal) {
         })
             .finally(() => {
             settled = true;
+            //listener is added with `{ once: true }`, but this is not enough if signal never receives abort.
+            //onAbort is noop once settled, but it is important to cleanup because of closure to Promise's reject
+            signal?.removeEventListener("abort", onAbort);
         });
     });
 }

package/dist/helpers/falsePromiseFactory.d.ts

@@ -0,0 +1,2 @@
+export declare const falsePromiseFactory: () => Promise<boolean>;
+//# sourceMappingURL=falsePromiseFactory.d.ts.map

package/dist/helpers/falsePromiseFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"falsePromiseFactory.d.ts","sourceRoot":"","sources":["../../src/helpers/falsePromiseFactory.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,mBAAmB,wBAAoB,CAAA"}

package/dist/helpers/falsePromiseFactory.js

@@ -0,0 +1,3 @@
+/* c8 ignore start */
+export const falsePromiseFactory = async () => false;
+/* c8 ignore end */

package/dist/helpers/foreverPromise.d.ts

@@ -0,0 +1,5 @@
+/**
+ * A promise that never settles
+ */
+export declare const foreverPromise: Promise<never>;
+//# sourceMappingURL=foreverPromise.d.ts.map

package/dist/helpers/foreverPromise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foreverPromise.d.ts","sourceRoot":"","sources":["../../src/helpers/foreverPromise.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,eAAO,MAAM,cAAc,gBAA+B,CAAA"}

package/dist/helpers/foreverPromise.js

@@ -0,0 +1,6 @@
+/* c8 ignore start */
+/**
+ * A promise that never settles
+ */
+export const foreverPromise = new Promise(() => { });
+/* c8 ignore end */

package/dist/helpers/has-at-least-one-key.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Test if object has at least one key
+ *
+ * @remarks
+ * Faster than `Object.keys(obj).length > 0` for large object
+ * - No Allocation: It doesn't create a massive array in memory.
+ * - Short-Circuiting: If the object has 10,000 keys, Object.keys() will visit all 10,000. This function stops at the 1st key.
+ *
+ * Like `Object.keys()`, only own enumerable properties are considered, so behaviour is identical to `Object.keys(obj).length > 0`.
+ */
+export declare const hasAtLeastOneKey: (obj: Record<string, unknown>) => boolean;
+//# sourceMappingURL=has-at-least-one-key.d.ts.map

package/dist/helpers/has-at-least-one-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-at-least-one-key.d.ts","sourceRoot":"","sources":["../../src/helpers/has-at-least-one-key.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAM/D,CAAA"}

package/dist/helpers/has-at-least-one-key.js

@@ -0,0 +1,18 @@
+/**
+ * Test if object has at least one key
+ *
+ * @remarks
+ * Faster than `Object.keys(obj).length > 0` for large object
+ * - No Allocation: It doesn't create a massive array in memory.
+ * - Short-Circuiting: If the object has 10,000 keys, Object.keys() will visit all 10,000. This function stops at the 1st key.
+ *
+ * Like `Object.keys()`, only own enumerable properties are considered, so behaviour is identical to `Object.keys(obj).length > 0`.
+ */
+export const hasAtLeastOneKey = (obj) => {
+    for (const _ in obj) {
+        //https://caniuse.com/mdn-javascript_builtins_object_hasown
+        if (Object.hasOwn(obj, _))
+            return true;
+    }
+    return false;
+};

package/dist/helpers/isPlainObject.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Checks if a value is a plain object.
+ *
+ * @param value - The value to check.
+ * @returns `true` if the value is a plain object, `false` otherwise.
+ */
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=isPlainObject.d.ts.map

package/dist/helpers/isPlainObject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isPlainObject.d.ts","sourceRoot":"","sources":["../../src/helpers/isPlainObject.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAElC"}

package/dist/helpers/isPlainObject.js

@@ -0,0 +1,9 @@
+/**
+ * Checks if a value is a plain object.
+ *
+ * @param value - The value to check.
+ * @returns `true` if the value is a plain object, `false` otherwise.
+ */
+export function isPlainObject(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}

package/dist/helpers/noop.d.ts

@@ -0,0 +1,2 @@
+export declare const noop: () => void;
+//# sourceMappingURL=noop.d.ts.map

package/dist/helpers/noop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.d.ts","sourceRoot":"","sources":["../../src/helpers/noop.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,IAAI,QAAO,IAAU,CAAA"}

package/dist/helpers/noop.js

@@ -0,0 +1,3 @@
+/* c8 ignore start */
+export const noop = () => { };
+/* c8 ignore end */

package/dist/helpers/pause.d.ts

@@ -1,2 +1,38 @@
-export declare const pause: (t?: number) => Promise<void>;
+/**
+ * Creates a promise that resolves after a specified number of milliseconds.
+ * The pause can be aborted using an AbortSignal.
+ *
+ * @param milliseconds - The number of milliseconds to pause. Defaults to 0.
+ * @param signal - An optional AbortSignal that can be used to cancel the pause.
+ * @returns A Promise that resolves after the specified delay, or rejects with an AbortError if cancelled.
+ *
+ * @throws {AbortError} Thrown when the pause is cancelled via the AbortSignal.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * await pause(1000); // Pause for 1 second
+ *
+ * // With abort signal
+ * const controller = new AbortController();
+ * setTimeout(() => controller.abort(), 500); // Cancel after 500ms
+ * await pause(1000, controller.signal); // Will be cancelled
+ * ```
+ *
+ * @remarks
+ * Multiple signals can be observed using the AbortSignal.any() static method.
+ * This allows you to pause until either the timeout completes or any of multiple
+ * abort signals are triggered.
+ *
+ * @example
+ * ```typescript
+ * const signal1 = new AbortController().signal;
+ * const signal2 = new AbortController().signal;
+ * const combinedSignal = AbortSignal.any([signal1, signal2]);
+ * await pause(5000, combinedSignal); // Pause until timeout or either signal aborts
+ * ```
+ */
+export declare const pause: (milliseconds?: number, options?: {
+    signal?: AbortSignal;
+}) => Promise<void>;
 //# sourceMappingURL=pause.d.ts.map

package/dist/helpers/pause.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pause.d.ts","sourceRoot":"","sources":["../../src/helpers/pause.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,KAAK,GAAI,UAAK,kBACmC,CAAA"}
+{"version":3,"file":"pause.d.ts","sourceRoot":"","sources":["../../src/helpers/pause.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,KAAK,GAChB,eAAc,MAAU,EACxB,UAAU;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,kBAuBnC,CAAA"}

package/dist/helpers/pause.js

@@ -1,3 +1,58 @@
 /* c8 ignore start */
-export const pause = (t = 0) => new Promise(resolve => setTimeout(() => resolve(), t));
+import { AbortError } from "./abortable.js";
+const abortEvent = "abort";
+/**
+ * Creates a promise that resolves after a specified number of milliseconds.
+ * The pause can be aborted using an AbortSignal.
+ *
+ * @param milliseconds - The number of milliseconds to pause. Defaults to 0.
+ * @param signal - An optional AbortSignal that can be used to cancel the pause.
+ * @returns A Promise that resolves after the specified delay, or rejects with an AbortError if cancelled.
+ *
+ * @throws {AbortError} Thrown when the pause is cancelled via the AbortSignal.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * await pause(1000); // Pause for 1 second
+ *
+ * // With abort signal
+ * const controller = new AbortController();
+ * setTimeout(() => controller.abort(), 500); // Cancel after 500ms
+ * await pause(1000, controller.signal); // Will be cancelled
+ * ```
+ *
+ * @remarks
+ * Multiple signals can be observed using the AbortSignal.any() static method.
+ * This allows you to pause until either the timeout completes or any of multiple
+ * abort signals are triggered.
+ *
+ * @example
+ * ```typescript
+ * const signal1 = new AbortController().signal;
+ * const signal2 = new AbortController().signal;
+ * const combinedSignal = AbortSignal.any([signal1, signal2]);
+ * await pause(5000, combinedSignal); // Pause until timeout or either signal aborts
+ * ```
+ */
+export const pause = (milliseconds = 0, options) => {
+    return new Promise((resolve, reject) => {
+        const { signal } = options ?? {};
+        if (signal?.aborted) {
+            reject(new AbortError());
+            return;
+        }
+        const abortListener = signal &&
+            (() => {
+                reject(new AbortError());
+                clearTimeout(id);
+            });
+        abortListener &&
+            signal?.addEventListener(abortEvent, abortListener, { once: true });
+        const id = setTimeout(() => {
+            resolve();
+            abortListener && signal?.removeEventListener(abortEvent, abortListener);
+        }, milliseconds);
+    });
+};
 /* c8 ignore end */

package/dist/helpers/throttle.d.ts

@@ -24,5 +24,46 @@
  * target.addEventListener('frequent-event', callback);
  *
  */
-export declare const throttle: <F extends (...args: Parameters<F>) => ReturnType<F>>(fn: F, delay: number) => (...args: Parameters<F>) => void;
+export declare const throttle: <F extends (...args: Parameters<F>) => ReturnType<F>>(fn: F, delay: number) => ((...args: Parameters<F>) => void);
+/**
+ * Throttles an async function to execute at most once per delay period
+ *
+ * Unlike regular throttle, this ensures:
+ * - Previous calls complete before new ones start (so there is no race with previous calls)
+ * - There's always a minimum delay between executions
+ * - The latest call always runs (canceling previous pending calls)
+ * - Each call waits for the previous execution to complete
+ *
+ * This creates a batching behavior that prevents flooding while ensuring
+ * the final state is always committed.
+ *
+ * **Note on AbortSignal**: If you need abort functionality, implement it as an
+ * argument to `fn`. The wrapped function is responsible for responding to the
+ * abort signal, not the throttle mechanism itself.
+ *
+ * @param fn - The async function to throttle
+ * @param delay - Minimum delay in milliseconds between executions
+ * @returns A throttled version of the function
+ *
+ * @example
+ * ```typescript
+ * const throttledSave = asyncThrottle(async (data) => {
+ *   await save(data)
+ * }, 100)
+ *
+ * // Multiple rapid calls will be throttled
+ * throttledSave(data1) // Waits 100ms, then executes
+ * throttledSave(data2) // Waits for data1 to complete + 100ms delay
+ * throttledSave(data3) // Cancels data2, waits for data1 + 100ms delay
+ *
+ * // Example with AbortSignal support
+ * const throttledFetch = asyncThrottle(async (url, signal) => {
+ *   return fetch(url, { signal })
+ * }, 100)
+ * const controller = new AbortController()
+ * throttledFetch('/api/data', controller.signal)
+ * controller.abort() // Aborts the fetch inside fn
+ * ```
+ */
+export declare const asyncThrottle: <TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => Promise<TReturn>, delay: number) => ((...args: TArgs) => Promise<TReturn>);
 //# sourceMappingURL=throttle.d.ts.map

package/dist/helpers/throttle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../src/helpers/throttle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,EAC1E,IAAI,CAAC,EACL,OAAO,MAAM,MAKI,GAAG,MAAM,UAAU,CAAC,CAAC,CAAC,SAQxC,CAAA"}
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../src/helpers/throttle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,EAC1E,IAAI,CAAC,EACL,OAAO,MAAM,KACZ,CAAC,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAYnC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,EAC5D,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,EACxC,OAAO,MAAM,KACZ,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,CAsCvC,CAAA"}

package/dist/helpers/throttle.js

@@ -37,3 +37,81 @@ export const throttle = (fn, delay) => {
         }, wait);
     };
 };
+/**
+ * Throttles an async function to execute at most once per delay period
+ *
+ * Unlike regular throttle, this ensures:
+ * - Previous calls complete before new ones start (so there is no race with previous calls)
+ * - There's always a minimum delay between executions
+ * - The latest call always runs (canceling previous pending calls)
+ * - Each call waits for the previous execution to complete
+ *
+ * This creates a batching behavior that prevents flooding while ensuring
+ * the final state is always committed.
+ *
+ * **Note on AbortSignal**: If you need abort functionality, implement it as an
+ * argument to `fn`. The wrapped function is responsible for responding to the
+ * abort signal, not the throttle mechanism itself.
+ *
+ * @param fn - The async function to throttle
+ * @param delay - Minimum delay in milliseconds between executions
+ * @returns A throttled version of the function
+ *
+ * @example
+ * ```typescript
+ * const throttledSave = asyncThrottle(async (data) => {
+ *   await save(data)
+ * }, 100)
+ *
+ * // Multiple rapid calls will be throttled
+ * throttledSave(data1) // Waits 100ms, then executes
+ * throttledSave(data2) // Waits for data1 to complete + 100ms delay
+ * throttledSave(data3) // Cancels data2, waits for data1 + 100ms delay
+ *
+ * // Example with AbortSignal support
+ * const throttledFetch = asyncThrottle(async (url, signal) => {
+ *   return fetch(url, { signal })
+ * }, 100)
+ * const controller = new AbortController()
+ * throttledFetch('/api/data', controller.signal)
+ * controller.abort() // Aborts the fetch inside fn
+ * ```
+ */
+export const asyncThrottle = (fn, delay) => {
+    let lastCall = Date.now();
+    let timeout;
+    let currentPromise;
+    return async function (...args) {
+        // Wait for any previous call to settle, so that there is not a race with
+        // throttled calls still running
+        if (currentPromise) {
+            try {
+                await currentPromise;
+            }
+            catch {
+                // noop if error thrown here (just waiting for it to settle)
+            }
+        }
+        // Clear any pending timeout
+        if (timeout) {
+            clearTimeout(timeout);
+        }
+        const wait = lastCall + delay - Date.now(); //if negative, executes immediately
+        return new Promise((resolve, reject) => {
+            timeout = setTimeout(async () => {
+                try {
+                    currentPromise = fn(...args);
+                    resolve(await currentPromise);
+                }
+                catch (error) {
+                    reject(error);
+                }
+                finally {
+                    lastCall = Date.now();
+                    currentPromise = undefined;
+                    timeout = undefined;
+                }
+            }, wait);
+        });
+    };
+};

package/dist/helpers/truePromiseFactory.d.ts

@@ -0,0 +1,2 @@
+export declare const truePromiseFactory: () => Promise<boolean>;
+//# sourceMappingURL=truePromiseFactory.d.ts.map

package/dist/helpers/truePromiseFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truePromiseFactory.d.ts","sourceRoot":"","sources":["../../src/helpers/truePromiseFactory.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,kBAAkB,wBAAmB,CAAA"}