@agoric/vow 0.1.1-dev-3aa5d66.0 → 0.1.1-dev-80db38c.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/vow",
-  "version": "0.1.1-dev-3aa5d66.0+3aa5d66",
+  "version": "0.1.1-dev-80db38c.0+80db38c",
   "description": "Remote (shortening and disconnection-tolerant) Promise-likes",
   "type": "module",
   "main": "src/index.js",
@@ -20,8 +20,8 @@
     "lint:types": "tsc"
   },
   "dependencies": {
-    "@agoric/base-zone": "0.1.1-dev-3aa5d66.0+3aa5d66",
-    "@agoric/internal": "0.3.3-dev-3aa5d66.0+3aa5d66",
+    "@agoric/base-zone": "0.1.1-dev-80db38c.0+80db38c",
+    "@agoric/internal": "0.3.3-dev-80db38c.0+80db38c",
     "@endo/env-options": "^1.1.4",
     "@endo/eventual-send": "^1.2.2",
     "@endo/pass-style": "^1.4.0",
@@ -53,5 +53,5 @@
   "typeCoverage": {
     "atLeast": 89.6
   },
-  "gitHead": "3aa5d6635dd781372c3c43ae04512773bf4a84c0"
+  "gitHead": "80db38cafed64c67a087c38bda5dd3373564e50e"
 }

package/src/tools.d.ts

@@ -5,6 +5,7 @@ export function prepareVowTools(zone: Zone, powers?: {
     watch: <T = any, TResult1 = T, TResult2 = never, C extends any[] = any[]>(specimenP: import("./types.js").ERef<T | import("./types.js").Vow<T>>, watcher?: import("./types.js").Watcher<T, TResult1, TResult2, C> | undefined, ...watcherArgs: C) => import("./types.js").Vow<Exclude<TResult1, void> | Exclude<TResult2, void> extends never ? TResult1 : Exclude<TResult1, void> | Exclude<TResult2, void>>;
     makeVowKit: <T>() => import("./types.js").VowKit<T>;
     allVows: (vows: unknown[]) => import("./types.js").Vow<any[]>;
+    asVow: <T extends unknown>(fn: (...args: any[]) => import("./types.js").Vow<Awaited<T>> | Awaited<T>) => import("./types.js").Vow<Awaited<T>>;
 };
 export type VowTools = ReturnType<typeof prepareVowTools>;
 import type { Zone } from '@agoric/base-zone';

package/src/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["tools.js"],"names":[],"mappings":"AAcO,sCAJI,IAAI;;;;;;oBAgBF,OAAO,EAAE;EAKrB;uBAGa,UAAU,CAAC,OAAO,eAAe,CAAC;0BA5BxB,mBAAmB;uCACN,YAAY"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["tools.js"],"names":[],"mappings":"AAeO,sCAJI,IAAI;;;;;;oBAiBF,OAAO,EAAE;oCAS0zC,GAAG;EAJl1C;uBAGa,UAAU,CAAC,OAAO,eAAe,CAAC;0BA7BxB,mBAAmB;uCACN,YAAY"}

package/src/tools.js

@@ -3,6 +3,7 @@ import { makeWhen } from './when.js';
 import { prepareVowKit } from './vow.js';
 import { prepareWatch } from './watch.js';
 import { prepareWatchUtils } from './watch-utils.js';
+import { makeAsVow } from './vow-utils.js';
 
 /** @import {Zone} from '@agoric/base-zone' */
 /** @import {IsRetryableReason} from './types.js' */
@@ -20,6 +21,7 @@ export const prepareVowTools = (zone, powers = {}) => {
   const watch = prepareWatch(zone, makeVowKit, isRetryableReason);
   const makeWatchUtils = prepareWatchUtils(zone, watch, makeVowKit);
   const watchUtils = makeWatchUtils();
+  const asVow = makeAsVow(makeVowKit);
 
   /**
    * Vow-tolerant implementation of Promise.all.
@@ -28,7 +30,7 @@ export const prepareVowTools = (zone, powers = {}) => {
    */
   const allVows = vows => watchUtils.all(vows);
 
-  return harden({ when, watch, makeVowKit, allVows });
+  return harden({ when, watch, makeVowKit, allVows, asVow });
 };
 harden(prepareVowTools);
 

package/src/vow-utils.d.ts

@@ -3,8 +3,10 @@ export const VowShape: import("@endo/patterns").Matcher;
 export function isVow(specimen: unknown): specimen is Vow;
 export function getVowPayload<T>(specimen: any): VowPayload<T> | undefined;
 export function toPassableCap(k: PassableCap | Vow): PassableCap;
+export function makeAsVow(makeVowKit: MakeVowKit): <T extends unknown>(fn: (...args: any[]) => Vow<Awaited<T>> | Awaited<T>) => Vow<Awaited<T>>;
 import { E as basicE } from '@endo/eventual-send';
 import type { Vow } from './types.js';
 import type { VowPayload } from './types.js';
 import type { PassableCap } from '@endo/pass-style';
+import type { MakeVowKit } from './vow.js';
 //# sourceMappingURL=vow-utils.d.ts.map

package/src/vow-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vow-utils.d.ts","sourceRoot":"","sources":["vow-utils.js"],"names":[],"mappings":";AAYA,wDAKE;AAMK,gCAHI,OAAO,GACL,QAAQ,IAAI,GAAG,CAGyB;AAc9C,8BAJM,CAAC,YACH,GAAG,GACD,WAAW,CAAC,CAAC,GAAG,SAAS,CASrC;AAoBM,iCAHI,WAAW,GAAG,GAAG,GACf,WAAW,CAUvB;4BAxE2B,qBAAqB;yBAMf,YAAY;gCAAZ,YAAY;iCADhB,kBAAkB"}
+{"version":3,"file":"vow-utils.d.ts","sourceRoot":"","sources":["vow-utils.js"],"names":[],"mappings":";AAaA,wDAKE;AAMK,gCAHI,OAAO,GACL,QAAQ,IAAI,GAAG,CAGyB;AAc9C,8BAJM,CAAC,YACH,GAAG,GACD,WAAW,CAAC,CAAC,GAAG,SAAS,CASrC;AAoBM,iCAHI,WAAW,GAAG,GAAG,GACf,WAAW,CAUvB;AAIM,sCADK,UAAU,IAKD,CAAC,sBACT,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAC9C,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,CAiB7B;4BApG2B,qBAAqB;yBAMf,YAAY;gCAAZ,YAAY;iCADhB,kBAAkB;gCAEnB,UAAU"}

package/src/vow-utils.js

@@ -4,8 +4,9 @@ import { isPassable } from '@endo/pass-style';
 import { M, matches } from '@endo/patterns';
 
 /**
- * @import {PassableCap} from '@endo/pass-style'
- * @import {VowPayload, Vow} from './types.js'
+ * @import {PassableCap} from '@endo/pass-style';
+ * @import {VowPayload, Vow} from './types.js';
+ * @import {MakeVowKit} from './vow.js';
  */
 
 export { basicE };
@@ -73,3 +74,30 @@ export const toPassableCap = k => {
   return vowV0;
 };
 harden(toPassableCap);
+
+/** @param {MakeVowKit} makeVowKit */
+export const makeAsVow = makeVowKit => {
+  /**
+   * Helper function that coerces the result of a function to a Vow. Helpful
+   * for scenarios like a synchronously thrown error.
+   * @template {any} T
+   * @param {(...args: any[]) => Vow<Awaited<T>> | Awaited<T>} fn
+   * @returns {Vow<Awaited<T>>}
+   */
+  const asVow = fn => {
+    let result;
+    try {
+      result = fn();
+    } catch (e) {
+      result = Promise.reject(e);
+    }
+    if (isVow(result)) {
+      return result;
+    }
+    const kit = makeVowKit();
+    kit.resolver.resolve(result);
+    return kit.vow;
+  };
+  return harden(asVow);
+};
+harden(makeAsVow);

package/src/vow.d.ts

@@ -1,5 +1,6 @@
 export function prepareVowKit(zone: Zone): <T>() => VowKit<T>;
 export type VowEphemera = Partial<PromiseKit<any>> & Pick<PromiseKit<any>, "promise">;
+export type MakeVowKit = ReturnType<typeof prepareVowKit>;
 import type { Zone } from '@agoric/base-zone';
 import type { VowKit } from './types.js';
 import type { PromiseKit } from '@endo/promise-kit';

package/src/vow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vow.d.ts","sourceRoot":"","sources":["vow.js"],"names":[],"mappings":"AAuBO,oCAFI,IAAI,IA+HA,CAAC,OACD,OAAO,CAAC,CAAC,CASvB;0BA9IY,OAAO,CAAC,WAAW,GAAG,CAAC,CAAC,GACpC,IAAQ,CAAC,WAAW,GAAG,CAAC,EAAE,SAAS,CAAC;0BATd,mBAAmB;4BACJ,YAAY;gCAFrB,mBAAmB"}
+{"version":3,"file":"vow.d.ts","sourceRoot":"","sources":["vow.js"],"names":[],"mappings":"AAuBO,oCAFI,IAAI,IA+HA,CAAC,OACD,OAAO,CAAC,CAAC,CASvB;0BA9IY,OAAO,CAAC,WAAW,GAAG,CAAC,CAAC,GACpC,IAAQ,CAAC,WAAW,GAAG,CAAC,EAAE,SAAS,CAAC;yBA8IvB,UAAU,CAAC,OAAO,aAAa,CAAC;0BAvJvB,mBAAmB;4BACJ,YAAY;gCAFrB,mBAAmB"}

package/src/vow.js

@@ -157,5 +157,6 @@ export const prepareVowKit = zone => {
 
   return makeVowKit;
 };
+/** @typedef {ReturnType<typeof prepareVowKit>} MakeVowKit */
 
 harden(prepareVowKit);