watchable-promise 2.0.1 → 2.1.1

package/README.md

@@ -67,6 +67,27 @@ npm install watchable-promise
     console.log(promise.value); // "foo"
     ```
 
+- You can call `.resolve()` or `.reject()` on a `WatchablePromise` instance to resolve or reject it externally:
+
+    ```javascript
+    import WatchablePromise from "watchable-promise";
+
+    // Resolving
+    const p1 = new WatchablePromise(resolve => {});
+    p1.resolve("foo");
+    const val = await p1;
+    console.log(val) // "foo"
+
+    // Rejecting
+    const p2 = new WatchablePromise((resolve, reject) => {});
+    p2.reject("bar");
+    try {
+        await p2;
+    } catch (err) {
+        console.log(err) // "bar"
+    }
+    ```
+
 ## License
 
 `watchable-promise` is released under the Apache 2.0 License. See the enclosed [`LICENSE`](./LICENSE) for details.

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 declare class WatchablePromise<T> extends Promise<T> {
     #private;
     constructor(executor: (resolve: (value: T | PromiseLike<T>) => void, reject: (reason?: any) => void) => void);
+    resolve(value: T): void;
+    reject(reason?: any): void;
     get settled(): boolean;
     get state(): "pending" | "fulfilled" | "rejected";
     get value(): any;

package/dist/index.js

@@ -3,6 +3,8 @@ var WatchablePromise = class _WatchablePromise extends Promise {
   #settled = false;
   #state = "pending";
   #value;
+  #resolve;
+  #reject;
   constructor(executor) {
     let resolve;
     let reject;
@@ -10,6 +12,8 @@ var WatchablePromise = class _WatchablePromise extends Promise {
       resolve = res;
       reject = rej;
     });
+    this.#resolve = resolve;
+    this.#reject = reject;
     this.then(
       (value) => {
         this.#state = "fulfilled";
@@ -22,7 +26,19 @@ var WatchablePromise = class _WatchablePromise extends Promise {
         this.#settled = true;
       }
     );
-    executor(resolve, reject);
+    executor(this.#resolve, this.#reject);
+  }
+  resolve(value) {
+    this.#state = "fulfilled";
+    this.#value = value;
+    this.#settled = true;
+    this.#resolve(value);
+  }
+  reject(reason) {
+    this.#state = "rejected";
+    this.#value = reason;
+    this.#settled = true;
+    this.#reject(reason);
   }
   get settled() {
     return this.#settled;

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["class WatchablePromise<T> extends Promise<T> {\n  #settled = false;\n  #state: \"pending\" | \"fulfilled\" | \"rejected\" = \"pending\";\n  #value: T | any;\n\n  constructor(\n    executor: (\n      resolve: (value: T | PromiseLike<T>) => void,\n      reject: (reason?: any) => void,\n    ) => void,\n  ) {\n    let resolve: (value: T | PromiseLike<T>) => void;\n    let reject: (reason?: any) => void;\n\n    super((res, rej) => {\n      resolve = res;\n      reject = rej;\n    });\n\n    this.then(\n      (value) => {\n        this.#state = \"fulfilled\";\n        this.#value = value;\n        this.#settled = true;\n      },\n      (reason) => {\n        this.#state = \"rejected\";\n        this.#value = reason;\n        this.#settled = true;\n      },\n    );\n\n    // @ts-ignore\n    executor(resolve, reject);\n  }\n\n  get settled() {\n    return this.#settled;\n  }\n\n  get state() {\n    return this.#state;\n  }\n\n  get value() {\n    return this.#value;\n  }\n\n  static from<T>(existingPromise: Promise<T>): WatchablePromise<T> {\n    return new WatchablePromise<T>((resolve, reject) => {\n      existingPromise.then(resolve, reject);\n    });\n  }\n\n  static withResolvers<T>() {\n    let resolve: (value: T | PromiseLike<T>) => void;\n    let reject: (reason?: any) => void;\n    const promise = new WatchablePromise<T>((res, rej) => {\n      resolve = res;\n      reject = rej;\n    });\n    // @ts-ignore\n    return { promise, resolve, reject };\n  }\n\n  static get [Symbol.species]() {\n    return Promise;\n  }\n\n  get [Symbol.toStringTag]() {\n    return \"WatchablePromise\";\n  }\n}\n\nexport default WatchablePromise;\n"],
-  "mappings": ";AAAA,IAAM,mBAAN,MAAM,0BAA4B,QAAW;AAAA,EAC3C,WAAW;AAAA,EACX,SAA+C;AAAA,EAC/C;AAAA,EAEA,YACE,UAIA;AACA,QAAI;AACJ,QAAI;AAEJ,UAAM,CAAC,KAAK,QAAQ;AAClB,gBAAU;AACV,eAAS;AAAA,IACX,CAAC;AAED,SAAK;AAAA,MACH,CAAC,UAAU;AACT,aAAK,SAAS;AACd,aAAK,SAAS;AACd,aAAK,WAAW;AAAA,MAClB;AAAA,MACA,CAAC,WAAW;AACV,aAAK,SAAS;AACd,aAAK,SAAS;AACd,aAAK,WAAW;AAAA,MAClB;AAAA,IACF;AAGA,aAAS,SAAS,MAAM;AAAA,EAC1B;AAAA,EAEA,IAAI,UAAU;AACZ,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,QAAQ;AACV,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,QAAQ;AACV,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,OAAO,KAAQ,iBAAkD;AAC/D,WAAO,IAAI,kBAAoB,CAAC,SAAS,WAAW;AAClD,sBAAgB,KAAK,SAAS,MAAM;AAAA,IACtC,CAAC;AAAA,EACH;AAAA,EAEA,OAAO,gBAAmB;AACxB,QAAI;AACJ,QAAI;AACJ,UAAM,UAAU,IAAI,kBAAoB,CAAC,KAAK,QAAQ;AACpD,gBAAU;AACV,eAAS;AAAA,IACX,CAAC;AAED,WAAO,EAAE,SAAS,SAAS,OAAO;AAAA,EACpC;AAAA,EAEA,YAAY,OAAO,OAAO,IAAI;AAC5B,WAAO;AAAA,EACT;AAAA,EAEA,KAAK,OAAO,WAAW,IAAI;AACzB,WAAO;AAAA,EACT;AACF;AAEA,IAAO,gBAAQ;",
+  "sourcesContent": ["class WatchablePromise<T> extends Promise<T> {\n  #settled = false;\n  #state: \"pending\" | \"fulfilled\" | \"rejected\" = \"pending\";\n  #value: T | any;\n  #resolve: (value: T | PromiseLike<T>) => void;\n  #reject: (reason?: any) => void;\n\n  constructor(\n    executor: (\n      resolve: (value: T | PromiseLike<T>) => void,\n      reject: (reason?: any) => void,\n    ) => void,\n  ) {\n    let resolve: (value: T | PromiseLike<T>) => void;\n    let reject: (reason?: any) => void;\n\n    super((res, rej) => {\n      resolve = res;\n      reject = rej;\n    });\n\n    // @ts-ignore\n    this.#resolve = resolve;\n    // @ts-ignore\n    this.#reject = reject;\n\n    this.then(\n      (value) => {\n        this.#state = \"fulfilled\";\n        this.#value = value;\n        this.#settled = true;\n      },\n      (reason) => {\n        this.#state = \"rejected\";\n        this.#value = reason;\n        this.#settled = true;\n      },\n    );\n\n    executor(this.#resolve, this.#reject);\n  }\n\n  resolve(value: T) {\n    this.#state = \"fulfilled\";\n    this.#value = value;\n    this.#settled = true;\n    this.#resolve(value);\n  }\n\n  reject(reason?: any) {\n    this.#state = \"rejected\";\n    this.#value = reason;\n    this.#settled = true;\n    this.#reject(reason);\n  }\n\n  get settled() {\n    return this.#settled;\n  }\n\n  get state() {\n    return this.#state;\n  }\n\n  get value() {\n    return this.#value;\n  }\n\n  static from<T>(existingPromise: Promise<T>): WatchablePromise<T> {\n    return new WatchablePromise<T>((resolve, reject) => {\n      existingPromise.then(resolve, reject);\n    });\n  }\n\n  static withResolvers<T>() {\n    let resolve: (value: T | PromiseLike<T>) => void;\n    let reject: (reason?: any) => void;\n    const promise = new WatchablePromise<T>((res, rej) => {\n      resolve = res;\n      reject = rej;\n    });\n    // @ts-ignore\n    return { promise, resolve, reject };\n  }\n\n  static get [Symbol.species]() {\n    return Promise;\n  }\n\n  get [Symbol.toStringTag]() {\n    return \"WatchablePromise\";\n  }\n}\n\nexport default WatchablePromise;\n"],
+  "mappings": ";AAAA,IAAM,mBAAN,MAAM,0BAA4B,QAAW;AAAA,EAC3C,WAAW;AAAA,EACX,SAA+C;AAAA,EAC/C;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YACE,UAIA;AACA,QAAI;AACJ,QAAI;AAEJ,UAAM,CAAC,KAAK,QAAQ;AAClB,gBAAU;AACV,eAAS;AAAA,IACX,CAAC;AAGD,SAAK,WAAW;AAEhB,SAAK,UAAU;AAEf,SAAK;AAAA,MACH,CAAC,UAAU;AACT,aAAK,SAAS;AACd,aAAK,SAAS;AACd,aAAK,WAAW;AAAA,MAClB;AAAA,MACA,CAAC,WAAW;AACV,aAAK,SAAS;AACd,aAAK,SAAS;AACd,aAAK,WAAW;AAAA,MAClB;AAAA,IACF;AAEA,aAAS,KAAK,UAAU,KAAK,OAAO;AAAA,EACtC;AAAA,EAEA,QAAQ,OAAU;AAChB,SAAK,SAAS;AACd,SAAK,SAAS;AACd,SAAK,WAAW;AAChB,SAAK,SAAS,KAAK;AAAA,EACrB;AAAA,EAEA,OAAO,QAAc;AACnB,SAAK,SAAS;AACd,SAAK,SAAS;AACd,SAAK,WAAW;AAChB,SAAK,QAAQ,MAAM;AAAA,EACrB;AAAA,EAEA,IAAI,UAAU;AACZ,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,QAAQ;AACV,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,QAAQ;AACV,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,OAAO,KAAQ,iBAAkD;AAC/D,WAAO,IAAI,kBAAoB,CAAC,SAAS,WAAW;AAClD,sBAAgB,KAAK,SAAS,MAAM;AAAA,IACtC,CAAC;AAAA,EACH;AAAA,EAEA,OAAO,gBAAmB;AACxB,QAAI;AACJ,QAAI;AACJ,UAAM,UAAU,IAAI,kBAAoB,CAAC,KAAK,QAAQ;AACpD,gBAAU;AACV,eAAS;AAAA,IACX,CAAC;AAED,WAAO,EAAE,SAAS,SAAS,OAAO;AAAA,EACpC;AAAA,EAEA,YAAY,OAAO,OAAO,IAAI;AAC5B,WAAO;AAAA,EACT;AAAA,EAEA,KAAK,OAAO,WAAW,IAAI;AACzB,WAAO;AAAA,EACT;AACF;AAEA,IAAO,gBAAQ;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "watchable-promise",
-  "version": "2.0.1",
+  "version": "2.1.1",
   "description": "A Promise whose state and value you can read",
   "type": "module",
   "module": "dist/index.js",