@cjser/p-debounce 5.1.0-cjser.2 → 5.1.1-cjser.2

package/dist-cjser/index.cjs

@@ -16,7 +16,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// packages/@cjser/p-debounce/index.js
+// packages/@cjser/p-debounce.tmp-26-1789230473445/index.js
 var index_exports = {};
 __export(index_exports, {
   default: () => index_default
@@ -107,10 +107,12 @@ pDebounce.promise = (function_, options = {}) => {
     currentPromise = (async () => {
       let result;
       let initialError;
+      let didReject = false;
       try {
         result = await function_.apply(this, arguments_);
       } catch (error) {
         initialError = error;
+        didReject = true;
       }
       while (queuedCall) {
         const call = queuedCall;
@@ -126,7 +128,7 @@ pDebounce.promise = (function_, options = {}) => {
           }
         }
       }
-      if (initialError) {
+      if (didReject) {
         throw initialError;
       }
       return result;

package/index.d.ts

@@ -9,7 +9,7 @@ export type Options = {
 	/**
 	An `AbortSignal` to cancel the debounced function.
 	*/
-	readonly signal?: AbortSignal;
+	readonly signal?: AbortSignal | undefined;
 };
 
 export type PromiseOptions = {

package/index.js

@@ -110,11 +110,13 @@ pDebounce.promise = (function_, options = {}) => {
 		currentPromise = (async () => {
 			let result;
 			let initialError;
+			let didReject = false;
 
 			try {
 				result = await function_.apply(this, arguments_);
 			} catch (error) {
 				initialError = error;
+				didReject = true;
 			}
 
 			// Process queued calls regardless of initial result
@@ -135,7 +137,7 @@ pDebounce.promise = (function_, options = {}) => {
 				}
 			}
 
-			if (initialError) {
+			if (didReject) {
 				throw initialError;
 			}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cjser/p-debounce",
-  "version": "5.1.0-cjser.2",
+  "version": "5.1.1-cjser.2",
   "description": "Debounce promise-returning & async functions",
   "license": "MIT",
   "repository": {
@@ -58,11 +58,11 @@
   "types": "./index.d.ts",
   "main": "./dist-cjser/index.cjs",
   "cjser": {
-    "sourceVersion": "5.1.0",
+    "sourceVersion": "5.1.1",
     "cjserVersion": 2,
     "original": {
       "name": "p-debounce",
-      "version": "5.1.0",
+      "version": "5.1.1",
       "exports": {
         "types": "./index.d.ts",
         "default": "./index.js"

package/readme.md

@@ -127,6 +127,35 @@ debouncedSave('data2'); // This will run after the first save completes
 //=> Saved: data2
 ```
 
+## Recipes
+
+### Autosave
+
+For autosave, combine trailing debounce with serialization to prevent concurrent saves from racing:
+
+```js
+import pDebounce from 'p-debounce';
+
+const saveDocument = async content => {
+	await fetch('/api/save', {
+		method: 'POST',
+		body: JSON.stringify({content}),
+	});
+};
+
+// Serialize saves, then debounce keystrokes
+const serializedSave = pDebounce.promise(saveDocument, {after: true});
+const autosave = pDebounce(serializedSave, 1000);
+
+textArea.addEventListener('input', () => {
+	autosave(textArea.value);
+});
+
+// 1. Waits 1s after typing stops
+// 2. If user types during save, queues next save with latest content
+// 3. Prevents race conditions where slow saves overwrite newer data
+```
+
 ## Related
 
 - [p-throttle](https://github.com/sindresorhus/p-throttle) - Throttle promise-returning & async functions