@agoric/deploy-script-support 0.10.4-dev-35e67be.0 → 0.10.4-dev-872bb3b.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/deploy-script-support",
-  "version": "0.10.4-dev-35e67be.0+35e67be",
+  "version": "0.10.4-dev-872bb3b.0+872bb3b",
   "description": "Helpers and other support for writing deploy scripts",
   "type": "module",
   "main": "src/helpers.js",
@@ -13,7 +13,7 @@
     "test:xs": "exit 0",
     "lint-fix": "yarn lint:eslint --fix",
     "lint:eslint": "eslint .",
-    "lint:types": "tsc -p jsconfig.json",
+    "lint:types": "tsc",
     "lint": "run-s --continue-on-error lint:*"
   },
   "repository": {
@@ -34,14 +34,14 @@
   },
   "homepage": "https://github.com/Agoric/agoric-sdk#readme",
   "dependencies": {
-    "@agoric/assert": "0.6.1-dev-35e67be.0+35e67be",
-    "@agoric/ertp": "0.16.3-dev-35e67be.0+35e67be",
-    "@agoric/import-manager": "0.3.12-dev-35e67be.0+35e67be",
-    "@agoric/internal": "0.3.3-dev-35e67be.0+35e67be",
-    "@agoric/notifier": "0.6.3-dev-35e67be.0+35e67be",
-    "@agoric/store": "0.9.3-dev-35e67be.0+35e67be",
-    "@agoric/time": "0.3.3-dev-35e67be.0+35e67be",
-    "@agoric/zoe": "0.26.3-dev-35e67be.0+35e67be",
+    "@agoric/assert": "0.6.1-dev-872bb3b.0+872bb3b",
+    "@agoric/ertp": "0.16.3-dev-872bb3b.0+872bb3b",
+    "@agoric/import-manager": "0.3.12-dev-872bb3b.0+872bb3b",
+    "@agoric/internal": "0.3.3-dev-872bb3b.0+872bb3b",
+    "@agoric/notifier": "0.6.3-dev-872bb3b.0+872bb3b",
+    "@agoric/store": "0.9.3-dev-872bb3b.0+872bb3b",
+    "@agoric/time": "0.3.3-dev-872bb3b.0+872bb3b",
+    "@agoric/zoe": "0.26.3-dev-872bb3b.0+872bb3b",
     "@endo/base64": "^0.2.32",
     "@endo/bundle-source": "^2.5.2",
     "@endo/far": "^0.2.19",
@@ -51,7 +51,7 @@
     "@endo/zip": "^0.2.32"
   },
   "devDependencies": {
-    "@agoric/vats": "0.15.2-dev-35e67be.0+35e67be",
+    "@agoric/vats": "0.15.2-dev-872bb3b.0+872bb3b",
     "@endo/init": "^0.5.57",
     "ava": "^5.3.0",
     "import-meta-resolve": "^2.2.1"
@@ -69,5 +69,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "35e67bed9eae0896e32b549ad0d1fd02fb83a905"
+  "gitHead": "872bb3be25122001190a35d0155d942315c81238"
 }

package/src/externalTypes.js

@@ -30,7 +30,7 @@ export {};
  * @param {string} srcSpec
  * @param {string} bundlePath
  * @param {any} [opts]
- * @returns {ManifestBundleRef}
+ * @returns {Promise<ManifestBundleRef>}
  */
 
 /**

package/src/getBundlerMaker.js

@@ -13,6 +13,8 @@
 import { E } from '@endo/far';
 import url from 'url';
 
+/** @typedef {ReturnType<import('./endo-pieces-contract.js')['start']>['publicFacet']} BundleMaker */
+
 export const makeGetBundlerMaker =
   (homeP, { lookup, bundleSource }) =>
   async ({
@@ -20,6 +22,7 @@ export const makeGetBundlerMaker =
     log = console.log,
   } = {}) => {
     const { board: optionalBoard, zoe, scratch } = await homeP;
+    /** @type {() => Promise<BundleMaker>} */
     const lookupOrCreate = async () => {
       // Locate the bundler maker if any already exists at the given path.
       let bundlerMaker = await lookup(JSON.parse(BUNDLER_MAKER_LOOKUP));

package/src/writeCoreProposal.js

@@ -7,6 +7,25 @@ import { createBundles } from '@agoric/internal/src/node/createBundles.js';
 import { defangAndTrim, mergePermits, stringify } from './code-gen.js';
 import { makeCoreProposalBehavior, permits } from './coreProposalBehavior.js';
 
+/**
+ * @callback WriteCoreProposal
+ * @param {string} filePrefix
+ * @param {import('./externalTypes.js').ProposalBuilder} proposalBuilder
+ * @returns {Promise<void>}
+ */
+
+/**
+ *
+ * @param {*} homeP
+ * @param {*} endowments
+ * @param {{
+ *   getBundlerMaker: () => Promise<import('./getBundlerMaker.js').BundleMaker>,
+ *   getBundleSpec: (...args: *) => Promise<import('./externalTypes.js').ManifestBundleRef>,
+ *   log?: typeof console.log,
+ *   writeFile?: typeof fs.promises.writeFile
+ * }} io
+ * @returns {WriteCoreProposal}
+ */
 export const makeWriteCoreProposal = (
   homeP,
   endowments,
@@ -50,8 +69,18 @@ export const makeWriteCoreProposal = (
     };
   };
 
-  let mutex = Promise.resolve();
+  let mutex =
+    /** @type {Promise<import('./externalTypes.js').ManifestBundleRef | undefined>} */ (
+      Promise.resolve()
+    );
+  /** @type {WriteCoreProposal} */
   const writeCoreProposal = async (filePrefix, proposalBuilder) => {
+    /**
+     *
+     * @param {string} entrypoint
+     * @param {string} [bundlePath]
+     * @returns {Promise<NodeModule>}
+     */
     const getBundle = async (entrypoint, bundlePath) => {
       if (!bundlePath) {
         return bundleSource(pathResolve(entrypoint));
@@ -62,7 +91,14 @@ export const makeWriteCoreProposal = (
       return ns.default;
     };
 
-    // Install an entrypoint.
+    /**
+     * Install an entrypoint.
+     *
+     * @param {string} entrypoint
+     * @param {string} [bundlePath]
+     * @param [opts]
+     * @returns {Promise<import('./externalTypes.js').ManifestBundleRef>}
+     */
     const install = async (entrypoint, bundlePath, opts) => {
       const bundle = getBundle(entrypoint, bundlePath);
 
@@ -71,6 +107,7 @@ export const makeWriteCoreProposal = (
         // console.log('installing', { filePrefix, entrypoint, bundlePath });
         return getBundleSpec(bundle, getBundler, opts);
       });
+      // @ts-expect-error xxx mutex type narrowing
       return mutex;
     };