@agoric/internal 0.3.3-dev-17b5fb3.0.17b5fb3 → 0.3.3-dev-999dc44.0.999dc44

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/internal",
-  "version": "0.3.3-dev-17b5fb3.0.17b5fb3",
+  "version": "0.3.3-dev-999dc44.0.999dc44",
   "description": "Externally unsupported utilities internal to agoric-sdk",
   "repository": {
     "type": "git",
@@ -24,7 +24,7 @@
     "lint:types": "yarn run -T tsgo --tsBuildInfoFile tsconfig.tsgo.tsbuildinfo"
   },
   "dependencies": {
-    "@agoric/base-zone": "0.1.1-dev-17b5fb3.0.17b5fb3",
+    "@agoric/base-zone": "0.1.1-dev-999dc44.0.999dc44",
     "@endo/cache-map": "^1.1.0",
     "@endo/common": "^1.4.0",
     "@endo/compartment-mapper": "^2.3.0",
@@ -42,7 +42,7 @@
     "jessie.js": "^0.3.4"
   },
   "devDependencies": {
-    "@agoric/cosmic-proto": "0.4.1-dev-17b5fb3.0.17b5fb3",
+    "@agoric/cosmic-proto": "0.4.1-dev-999dc44.0.999dc44",
     "@endo/exo": "^1.7.0",
     "@endo/init": "^1.1.13",
     "@endo/ses-ava": "^1.4.2",
@@ -68,7 +68,7 @@
     "access": "public"
   },
   "typeCoverage": {
-    "atLeast": 92.84
+    "atLeast": 95.63
   },
-  "gitHead": "17b5fb32d8d34f53397845a6ab61b5f5066f0931"
+  "gitHead": "999dc4420f28ba9d27ba2f0dce7d12e3ff78ccbe"
 }

package/src/build-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-cache.d.ts","sourceRoot":"","sources":["build-cache.js"],"names":[],"mappings":"AAUO,0CAFI,mBAAmB;oBAkEjB,MAAM,QACN,MAAM,OAAO,CAAC,GAAG,CAAC;EAsF9B;AAgBM,kEAVI;IACN,EAAE,EAAE,IAAI,CAAC,cAAc,kBAAkB,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC,CAAC;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb,iBASH;yCAlLsD,wBAAwB"}
+{"version":3,"file":"build-cache.d.ts","sourceRoot":"","sources":["build-cache.js"],"names":[],"mappings":"AAUO,0CAFI,mBAAmB;oBAmEjB,MAAM,QACN,MAAM,OAAO,CAAC,GAAG,CAAC;EAsF9B;AAgBM,kEAVI;IACN,EAAE,EAAE,IAAI,CAAC,cAAc,kBAAkB,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC,CAAC;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb,iBASH;yCAnLsD,wBAAwB"}

package/src/build-cache.js

@@ -20,6 +20,7 @@ export const makeDirectoryLock = powers => {
     acquireTimeoutMs,
     onEvent = () => {},
   } = powers;
+  /** @param {BuildCacheEvent} event */
   const safeEmit = event => {
     try {
       onEvent(event);

package/src/debug.d.ts

@@ -1,5 +1,5 @@
-export function makeTracer(label: string, enable?: boolean | "verbose"): ((..._args: any[]) => void) & {
-    sub: (subLabel: any, subEnable?: boolean | "verbose") => ((..._args: any[]) => void) & /*elided*/ any;
+export function makeTracer(label: string, enable?: boolean | "verbose"): ((..._args: unknown[]) => void) & {
+    sub: (subLabel: string, subEnable?: boolean | "verbose") => ((..._args: unknown[]) => void) & /*elided*/ any;
 };
 export type TraceLogger = ReturnType<typeof makeTracer>;
 //# sourceMappingURL=debug.d.ts.map

package/src/debug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["debug.js"],"names":[],"mappings":"AAQO,kCAHI,MAAM,WACN,OAAO,GAAG,SAAS;;EAwC7B;0BAIY,UAAU,CAAC,OAAO,UAAU,CAAC"}
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["debug.js"],"names":[],"mappings":"AAQO,kCAHI,MAAM,WACN,OAAO,GAAG,SAAS,eAcT,OAAO,EAAA;oBAVf,MAAM,cACN,OAAO,GAAG,SAAS,iBASX,OAAO,EAAA;EA0C3B;0BAIY,UAAU,CAAC,OAAO,UAAU,CAAC"}

package/src/debug.js

@@ -7,6 +7,10 @@ let debugInstance = 1;
  * @param {boolean | 'verbose'} enable
  */
 export const makeTracer = (label, enable = true) => {
+  /**
+   * @param {string} subLabel
+   * @param {boolean | 'verbose'} [subEnable]
+   */
   const sub = (subLabel, subEnable = enable) =>
     makeTracer(`${label}.${subLabel}`, subEnable);
   const key = `----- ${label},${debugInstance} `;
@@ -14,17 +18,23 @@ export const makeTracer = (label, enable = true) => {
   // the cases below define a named variable to provide better debug info
   switch (enable) {
     case false: {
+      /** @param {...unknown} _args */
       const logDisabled = (..._args) => {};
       return harden(Object.assign(logDisabled, { sub }));
     }
     case 'verbose': {
+      /**
+       * @param {unknown} optLog
+       * @param {...unknown} args
+       */
       const infoTick = (optLog, ...args) => {
         // XXX Sniff tests such as this are inherently unreliable and smell bad.
         // Even aside from the security hazard of
         // https://github.com/Agoric/agoric-sdk/issues/11845
         // an object intended as a normal logging argument may accidentally
         // pass this sniff test, causing confusion.
-        if (typeof optLog?.log === 'function') {
+        const maybeLogger = /** @type {{ log?: unknown }} */ (optLog);
+        if (typeof maybeLogger?.log === 'function') {
           console.info(key, ...args);
         } else {
           console.info(key, optLog, ...args);
@@ -33,10 +43,16 @@ export const makeTracer = (label, enable = true) => {
       return harden(Object.assign(infoTick, { sub }));
     }
     default: {
+      /**
+       * @param {unknown} optLog
+       * @param {...unknown} args
+       */
       const debugTick = (optLog, ...args) => {
         // Another unreliable sniff test like the one above
-        if (typeof optLog?.log === 'function') {
-          optLog.log(key, ...args);
+        const maybeLogger =
+          /** @type {{ log?: (...args: unknown[]) => void }} */ (optLog);
+        if (typeof maybeLogger?.log === 'function') {
+          maybeLogger.log(key, ...args);
         } else {
           console.info(key, optLog, ...args);
         }

package/src/keyMirror.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keyMirror.d.ts","sourceRoot":"","sources":["keyMirror.js"],"names":[],"mappings":"AA0BO,0BAJoF,IAAI,SAAjF,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,KAAK,CAAE,UAC/E,IAAI,GAAG,EAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,IAAI,GAAG,CAAC,GAAE,GACpE,eAAe,CAAC,IAAI,CAAC,CAqBjC;4BAxC0F,IAAI,SAAjF,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,KAAK,CAAE,IAC7E,EAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,IAAI,GAAG,CAAC,GAAE"}
+{"version":3,"file":"keyMirror.d.ts","sourceRoot":"","sources":["keyMirror.js"],"names":[],"mappings":"AA0BO,0BAJoF,IAAI,SAAjF,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,KAAK,CAAE,UAC/E,IAAI,GAAG,EAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,IAAI,GAAG,CAAC,GAAE,GACpE,eAAe,CAAC,IAAI,CAAC,CAkBjC;4BArC0F,IAAI,SAAjF,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,KAAK,CAAE,IAC7E,EAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,IAAI,GAAG,CAAC,GAAE"}

package/src/keyMirror.js

@@ -30,10 +30,7 @@ export const keyMirror = record => {
   }
 
   /** @type {Record<string, string>} */
-  const mirrored = {
-    // @ts-expect-error Record confused by null prototype
-    __proto__: null,
-  };
+  const mirrored = Object.create(null);
   for (const [key, value] of entries(record)) {
     if (value !== null && value !== key) {
       throw TypeError(

package/src/kv-store.d.ts

@@ -20,7 +20,7 @@
  * @returns {KVStore}
  */
 export function makeKVStore(db: Database, beforeMutation: () => void, trace: (...args: string[]) => void): KVStore;
-export function compareByCodePoints(left: any, right: any): 0 | 1 | -1;
+export function compareByCodePoints(left: string, right: string): 0 | 1 | -1;
 export function makeKVStoreFromMap<T = unknown>(map: Map<string, T>): KVStore<T>;
 export type KVStore<T = string> = {
     has: (key: string) => boolean;

package/src/kv-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kv-store.d.ts","sourceRoot":"","sources":["kv-store.js"],"names":[],"mappings":"AAGA;;GAEG;AAEH;;;;;;;;;GASG;AAEH;;;;;;;GAOG;AAEH,gCARW,QAAQ,kBACR,MAAM,IAAI,SAEV,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,GAEzB,OAAO,CA0InB;AAOM,uEAoBN;AAOM,mCAJO,CAAC,iBACJ,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,GACZ,OAAO,CAAC,CAAC,CAAC,CA8DtB;oBAxPa,CAAC,aACF;IACR,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,GAAG,SAAS,CAAC;IACpC,UAAU,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACxD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IACrC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;8BAXuB,gBAAgB"}
+{"version":3,"file":"kv-store.d.ts","sourceRoot":"","sources":["kv-store.js"],"names":[],"mappings":"AAGA;;GAEG;AAEH;;;;;;;;;GASG;AAEH;;;;;;;GAOG;AAEH,gCARW,QAAQ,kBACR,MAAM,IAAI,SAEV,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,GAEzB,OAAO,CA0InB;AAWM,0CAHI,MAAM,SACN,MAAM,cAsBhB;AAOM,mCAJO,CAAC,iBACJ,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,GACZ,OAAO,CAAC,CAAC,CAAC,CAkEtB;oBAhQa,CAAC,aACF;IACR,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,GAAG,SAAS,CAAC;IACpC,UAAU,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACxD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IACrC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;8BAXuB,gBAAgB"}

package/src/kv-store.js

@@ -167,6 +167,10 @@ export function makeKVStore(db, beforeMutation, trace) {
 // available.
 // https://github.com/Agoric/agoric-sdk/pull/10299
 
+/**
+ * @param {string} left
+ * @param {string} right
+ */
 export const compareByCodePoints = (left, right) => {
   const leftIter = left[Symbol.iterator]();
   const rightIter = right[Symbol.iterator]();
@@ -195,8 +199,11 @@ export const compareByCodePoints = (left, right) => {
  * @returns {KVStore<T>}
  */
 export const makeKVStoreFromMap = map => {
+  /** @type {string[] | undefined} */
   let sortedKeys;
+  /** @type {string | undefined} */
   let priorKeyReturned;
+  /** @type {number} */
   let priorKeyIndex;
 
   const ensureSorted = () => {
@@ -222,6 +229,7 @@ export const makeKVStoreFromMap = map => {
     getNextKey: priorKey => {
       assert.typeof(priorKey, 'string');
       ensureSorted();
+      assert(sortedKeys, 'sortedKeys should be defined after ensureSorted');
       const start =
         priorKeyReturned === undefined
           ? 0

package/src/lib-nodejs/ava-unhandled-rejection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ava-unhandled-rejection.d.ts","sourceRoot":"","sources":["ava-unhandled-rejection.js"],"names":[],"mappings":"AAOA;;GAEG;AAEH,4DAA4D;AAC5D,qDACE,wCAAwC,CAAC;AAC3C,iCAAiC;AACjC,uFACyC;AA2ElC,qCAJI,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,qBAEhC;IAAoC,aAAa,EAAzC,MAAM,OAAO,CAAC,IAAI,CAAC;CAC7B;;;;GA4BA;AAeM,6CARM,CAAC,wCAEX;IAA0B,IAAI,EAAtB,OAAO,CAAC,CAAC;IACQ,UAAU;IACZ,aAAa,EAA5B,MAAM;CACd,GAAU,CAAE,iBAAiB,EAAE,MAAM,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EACzE,iBAAqB,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAkEpC;AASM,kDANO,CAAC,kDAEZ;IAA0B,IAAI,EAAtB,OAAO,CAAC,CAAC;IACQ,UAAU;IACZ,aAAa,EAA5B,MAAM;CAChB,IAiBS,cAJG,MAIS,EAAE,aAHX,MAAM,CAAC,EAAE,CAAC,CAGW,KAFnB,MAAM,CAAC,EAAE,CAAC,CAAC,CAmCzB;4BAvP2F,KAAK;sCAAL,KAAK;2BAAL,KAAK"}
+{"version":3,"file":"ava-unhandled-rejection.d.ts","sourceRoot":"","sources":["ava-unhandled-rejection.js"],"names":[],"mappings":"AAOA;;GAEG;AAEH,4DAA4D;AAC5D,qDACE,wCAAwC,CAAC;AAC3C,iCAAiC;AACjC,uFACyC;AAkFlC,qCAJI,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,qBAEhC;IAAoC,aAAa,EAAzC,MAAM,OAAO,CAAC,IAAI,CAAC;CAC7B;;;;GA4BA;AAeM,6CARM,CAAC,wCAEX;IAA0B,IAAI,EAAtB,OAAO,CAAC,CAAC;IACQ,UAAU;IACZ,aAAa,EAA5B,MAAM;CACd,GAAU,CAAE,iBAAiB,EAAE,MAAM,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EACzE,iBAAqB,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAkEpC;AASM,kDANO,CAAC,kDAEZ;IAA0B,IAAI,EAAtB,OAAO,CAAC,CAAC;IACQ,UAAU;IACZ,aAAa,EAA5B,MAAM;CAChB,IAiBS,cAJG,MAIS,EAAE,aAHX,MAAM,CAAC,EAAE,CAAC,CAGW,KAFnB,MAAM,CAAC,EAAE,CAAC,CAAC,CAmCzB;4BA9P2F,KAAK;sCAAL,KAAK;2BAAL,KAAK"}

package/src/lib-nodejs/ava-unhandled-rejection.js

@@ -22,7 +22,9 @@ const settleUnhandled = async () => {
   await delayTurn();
 };
 
+/** @param {'unhandledRejection' | 'rejectionHandled'} event */
 const stripListeners = event => {
+  // @ts-expect-error the overload is per specific event name and can't handle the union
   const listeners = process.listeners(event);
   for (const listener of listeners) {
     process.off(event, listener);
@@ -52,6 +54,10 @@ const makeUnhandledTracker = () => {
     }
   });
 
+  /**
+   * @param {unknown} _reason
+   * @param {Promise<unknown>} promise
+   */
   const onUnhandled = (_reason, promise) => {
     seenUnhandled += 1;
     const token = Symbol('unhandledRejection');
@@ -60,6 +66,7 @@ const makeUnhandledTracker = () => {
     registry.register(promise, token, token);
   };
 
+  /** @param {Promise<unknown>} promise */
   const onHandledLate = promise => {
     const token = tokenByPromise.get(promise);
     tokenByPromise.delete(promise);

package/src/lib-nodejs/gc-and-finalize.d.ts

@@ -1,2 +1,3 @@
-export function makeGcAndFinalize(gcPower: any): () => Promise<void>;
+/** @param {(() => void) | false} gcPower */
+export function makeGcAndFinalize(gcPower: (() => void) | false): () => Promise<void>;
 //# sourceMappingURL=gc-and-finalize.d.ts.map

package/src/lib-nodejs/gc-and-finalize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gc-and-finalize.d.ts","sourceRoot":"","sources":["gc-and-finalize.js"],"names":[],"mappings":"AAkEA,qEAwBC"}
+{"version":3,"file":"gc-and-finalize.d.ts","sourceRoot":"","sources":["gc-and-finalize.js"],"names":[],"mappings":"AAkEA,4CAA4C;AAC5C,2CADY,CAAC,MAAM,IAAI,CAAC,GAAG,KAAK,uBAyB/B"}

package/src/lib-nodejs/gc-and-finalize.js

@@ -64,6 +64,7 @@
  * dummy pre-resolved Promise.
  */
 
+/** @param {(() => void) | false} gcPower */
 export function makeGcAndFinalize(gcPower) {
   if (typeof gcPower !== 'function') {
     if (gcPower !== false) {

package/src/lib-nodejs/spawnSubprocessWorker.d.ts

@@ -1,11 +1,18 @@
-export function startSubprocessWorker(execPath: any, procArgs?: any[], { netstringMaxChunkSize }?: {
-    netstringMaxChunkSize?: undefined;
+/**
+ * @param {string} execPath
+ * @param {readonly string[]} [procArgs]
+ * @param {{ netstringMaxChunkSize?: number }} [options]
+ */
+export function startSubprocessWorker(execPath: string, procArgs?: readonly string[], { netstringMaxChunkSize }?: {
+    netstringMaxChunkSize?: number;
 }): {
     fromChild: {
-        on: (...args: any[]) => import("stream").Transform;
+        /** @param {...unknown} args */
+        on: (...args: unknown[]) => import("stream").Transform;
     };
     toChild: {
-        write: (...args: any[]) => boolean;
+        /** @param {...unknown} args */
+        write: (...args: unknown[]) => boolean;
     };
     terminate: () => void;
     done: Promise<any>;

package/src/lib-nodejs/spawnSubprocessWorker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spawnSubprocessWorker.d.ts","sourceRoot":"","sources":["spawnSubprocessWorker.js"],"names":[],"mappings":"AA+BA;;;;;;;;;;;EA0DC"}
+{"version":3,"file":"spawnSubprocessWorker.d.ts","sourceRoot":"","sources":["spawnSubprocessWorker.js"],"names":[],"mappings":"AAmCA;;;;GAIG;AACH,gDAJW,MAAM,aACN,SAAS,MAAM,EAAE,8BACjB;IAAE,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAAE;;QAyCzC,+BAA+B;sBAAhB,OAAO,EAAA;;;QAQtB,+BAA+B;yBAAhB,OAAO,EAAA;;;;EAazB"}

package/src/lib-nodejs/spawnSubprocessWorker.js

@@ -18,6 +18,10 @@ import {
 // toChild, fromChild } pair of Streams which accept/emit hardened Arrays of
 // JSON-serializable data.
 
+/**
+ * @param {unknown} _first
+ * @param {...unknown} _args
+ */
 function parentLog(_first, ..._args) {
   // console.error(`--parent: ${_first}`, ..._args);
 }
@@ -29,6 +33,11 @@ function parentLog(_first, ..._args) {
 /** @type {IOType[]} */
 const stdio = harden(['inherit', 'inherit', 'inherit', 'pipe', 'pipe']);
 
+/**
+ * @param {string} execPath
+ * @param {readonly string[]} [procArgs]
+ * @param {{ netstringMaxChunkSize?: number }} [options]
+ */
 export function startSubprocessWorker(
   execPath,
   procArgs = [],
@@ -68,6 +77,7 @@ export function startSubprocessWorker(
   // that get used
   /* @type {typeof fromChild} */
   const wrappedFromChild = {
+    /** @param {...unknown} args */
     on: (...args) =>
       fromChild.on(
         .../** @type {Parameters<(typeof fromChild)['on']>} */ (args),
@@ -75,6 +85,7 @@ export function startSubprocessWorker(
   };
   /* @type {typeof toChild} */
   const wrappedToChild = {
+    /** @param {...unknown} args */
     write: (...args) =>
       toChild.write(
         .../** @type {Parameters<(typeof toChild)['write']>} */ (args),

package/src/metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["metrics.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4CAqH2C,MAAM,EAAE;;;;;;;;;;gCAQrC,CAAC,OAAO,iBAAiB,EAAE,MAAM,OAAO,iBAAiB,CAAC;;;;;;AAiBjE,iDAPI,MAAM,cACN,MAAM,GACJ,MAAM,CACd,iBAAiB,EACrB;IAAM,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAC5C,CAoBH;AA0BM,iCARe,SAAS,SAAlB,MAAQ,mDAElB;IAA0B,SAAS,EAA3B,SAAS;IACM,UAAU,EAAzB,MAAM;IACS,UAAU,EAAzB,MAAM;IACyB,OAAO;CAC9C,GAAU,YAAY,CAAC,SAAS,CAAC,CA8GnC;AAQD;;;;;;;;GAQG;AACH,qDAAqD;AACrD,uCADW,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,EAAE,CAkF/C;AAEF,qDAAqD;AACrD,0CADW,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,EAAE,CA4D/C;AAGF,iCAAiC;AACjC,mCADW,gBAAgB,EAAE,CAI1B;yBA3SmB,SAAS,SAAlB,MAAQ;;;;;iBAEP,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,IAAI;mBAE5C,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,IAAI;;;;;eAC5C,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI;;;;;eAE1C,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI;;yBA+H1C,CAAC,OAAO,UAAU,EAAE,MAAM,OAAO,UAAU,CAAC;;SAO5C,MAAM;UACN,MAAM;;mBACO,MAAM;eAAS,MAAM;;iBAClC,MAAM;;gBAEN,UAAU;;AAnRxB,6DACuD;AApBvD;;;GAGG;AAEH,wDAaE;sCAjBqD,oBAAoB;wCAApB,oBAAoB"}
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["metrics.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4CAqH2C,MAAM,EAAE;;;;;;;;;;gCAQrC,CAAC,OAAO,iBAAiB,EAAE,MAAM,OAAO,iBAAiB,CAAC;;;;;;AAiBjE,iDAPI,MAAM,cACN,MAAM,GACJ,MAAM,CACd,iBAAiB,EACrB;IAAM,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAC5C,CAoBH;AA0BM,iCARe,SAAS,SAAlB,MAAQ,mDAElB;IAA0B,SAAS,EAA3B,SAAS;IACM,UAAU,EAAzB,MAAM;IACS,UAAU,EAAzB,MAAM;IACyB,OAAO;CAC9C,GAAU,YAAY,CAAC,SAAS,CAAC,CAmHnC;AAQD;;;;;;;;GAQG;AACH,qDAAqD;AACrD,uCADW,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,EAAE,CAkF/C;AAEF,qDAAqD;AACrD,0CADW,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,EAAE,CA4D/C;AAGF,iCAAiC;AACjC,mCADW,gBAAgB,EAAE,CAI1B;yBAhTmB,SAAS,SAAlB,MAAQ;;;;;iBAEP,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,IAAI;mBAE5C,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,IAAI;;;;;eAC5C,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI;;;;;eAE1C,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI;;yBAoI1C,CAAC,OAAO,UAAU,EAAE,MAAM,OAAO,UAAU,CAAC;;SAO5C,MAAM;UACN,MAAM;;mBACO,MAAM;eAAS,MAAM;;iBAClC,MAAM;;gBAEN,UAAU;;AAxRxB,6DACuD;AApBvD;;;GAGG;AAEH,wDAaE;sCAjBqD,oBAAoB;wCAApB,oBAAoB"}

package/src/metrics.js

@@ -230,6 +230,11 @@ export const makeQueueMetrics = ({
 
   let ready = false;
   const lengths = /** @type {TotalMap<string, number>} */ (new Map());
+  /**
+   * @param {string} queueName
+   * @param {number} delta
+   * @param {boolean} [init]
+   */
   const nudge = (queueName, delta, init = false) => {
     if (!lengths.has(queueName)) {
       if (!init) console?.warn('Unknown queue', queueName);

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

@@ -1 +1 @@
-{"version":3,"file":"module-utils.d.ts","sourceRoot":"","sources":["module-utils.js"],"names":[],"mappings":"AAcO,sCAHI,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAc3B;AAWM,yCAJI,MAAM,WACN,MAAM,GACJ,MAAM,CAMlB"}
+{"version":3,"file":"module-utils.d.ts","sourceRoot":"","sources":["module-utils.js"],"names":[],"mappings":"AAcO,sCAHI,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAe3B;AAWM,yCAJI,MAAM,WACN,MAAM,GACJ,MAAM,CAMlB"}

package/src/module-utils.js

@@ -15,6 +15,7 @@ import { Fail } from '@endo/errors';
 export const getSpecifier = async fileUrl => {
   // eslint-disable-next-line no-new
   new URL(fileUrl); // validates fileUrl
+  /** @param {string} location */
   const read = async location => {
     const path = fileURLToPath(new URL(location, fileUrl));
     return readFile(path);

package/src/natural-sort.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"natural-sort.d.ts","sourceRoot":"","sources":["natural-sort.js"],"names":[],"mappings":"AAgDO,kCAJI,MAAM,KACN,MAAM,GACJ,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAmCtB"}
+{"version":3,"file":"natural-sort.d.ts","sourceRoot":"","sources":["natural-sort.js"],"names":[],"mappings":"AAoDO,kCAJI,MAAM,KACN,MAAM,GACJ,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAmCtB"}

package/src/natural-sort.js

@@ -15,13 +15,17 @@ const compareNats = (a, b) => {
     (Number.isFinite(diff) && diff) ||
     (a === b ? 0 : Number(BigInt(a) - BigInt(b)) || a.length - b.length);
 
-  // @ts-expect-error this call really does return -1 | 0 | 1
-  return Math.sign(finiteDiff);
+  return /** @type {-1 | 0 | 1} */ (Math.sign(finiteDiff));
 };
 
 // TODO: compareByCodePoints
 // https://github.com/endojs/endo/pull/2008
 
+/**
+ * @param {string} a
+ * @param {string} b
+ * @returns {-1 | 0 | 1}
+ */
 const compareStrings = (a, b) => (a > b ? 1 : a < b ? -1 : 0);
 
 const rCaptureDigits = /([0-9]+)/;

package/src/node/createBundles.d.ts

@@ -1,4 +1,8 @@
-export function createBundlesFromAbsolute(sourceBundles: any): Promise<void>;
-export function createBundles(sourceBundles: any, dirname?: string): Promise<void>;
-export function extractProposalBundles(dirProposalBuilder: any, dirname?: string): Promise<void>;
+export function createBundlesFromAbsolute(sourceBundles: Iterable<readonly [srcPath: string, bundlePath: string]>): Promise<void>;
+export function createBundles(sourceBundles: Array<readonly [srcPath: string, bundlePath: string]>, dirname?: string): Promise<void>;
+export function extractProposalBundles(dirProposalBuilder: Array<readonly [dir: string, proposalBuilder: ProposalBuilder]>, dirname?: string): Promise<void>;
+export type ProposalBuilder = (powers: {
+    publishRef: (x: unknown) => unknown;
+    install: (src: string, bundleName?: string) => Promise<void>;
+}) => Promise<unknown>;
 //# sourceMappingURL=createBundles.d.ts.map

package/src/node/createBundles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createBundles.d.ts","sourceRoot":"","sources":["createBundles.js"],"names":[],"mappings":"AAUO,6EAgCN;AAEM,mFAMN;AAEM,iGAkCN"}
+{"version":3,"file":"createBundles.d.ts","sourceRoot":"","sources":["createBundles.js"],"names":[],"mappings":"AAWO,yDADK,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,iBAiCnE;AAMM,6CAHI,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,YACrD,MAAM,iBAWhB;AAYM,2DAHI,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,eAAe,CAAC,CAAC,YAC/D,MAAM,iBA0ChB;8BAjDY,CAAC,MAAM,EAAE;IACjB,UAAU,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;IACpC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D,KAAK,OAAO,CAAC,OAAO,CAAC"}

package/src/node/createBundles.js

@@ -8,6 +8,7 @@ import { Fail, q } from '@endo/errors';
 const BUNDLE_SOURCE_PROGRAM = 'bundle-source';
 const req = createRequire(import.meta.url);
 
+/** @param {Iterable<readonly [srcPath: string, bundlePath: string]>} sourceBundles */
 export const createBundlesFromAbsolute = async sourceBundles => {
   const prog = req.resolve(`.bin/${BUNDLE_SOURCE_PROGRAM}`);
 
@@ -42,24 +43,47 @@ export const createBundlesFromAbsolute = async sourceBundles => {
   }
 };
 
+/**
+ * @param {Array<readonly [srcPath: string, bundlePath: string]>} sourceBundles
+ * @param {string} [dirname]
+ */
 export const createBundles = async (sourceBundles, dirname = '.') => {
-  const absBundleSources = sourceBundles.map(([srcPath, bundlePath]) => [
-    req.resolve(srcPath, { paths: [dirname] }),
-    path.resolve(dirname, bundlePath),
-  ]);
+  const absBundleSources = sourceBundles.map(
+    ([srcPath, bundlePath]) =>
+      /** @type {readonly [string, string]} */ ([
+        req.resolve(srcPath, { paths: [dirname] }),
+        path.resolve(dirname, bundlePath),
+      ]),
+  );
   return createBundlesFromAbsolute(absBundleSources);
 };
 
+/**
+ * @typedef {(powers: {
+ *   publishRef: (x: unknown) => unknown,
+ *   install: (src: string, bundleName?: string) => Promise<void>,
+ * }) => Promise<unknown>} ProposalBuilder
+ */
+/**
+ * @param {Array<readonly [dir: string, proposalBuilder: ProposalBuilder]>} dirProposalBuilder
+ * @param {string} [dirname]
+ */
 export const extractProposalBundles = async (
   dirProposalBuilder,
   dirname = '.',
 ) => {
+  /** @type {Map<string, string>} */
   const toBundle = new Map();
 
   await Promise.all(
     dirProposalBuilder.map(async ([dir, proposalBuilder]) => {
       const home = path.resolve(dirname, dir);
+      /** @param {unknown} x */
       const publishRef = x => x;
+      /**
+       * @param {string} src
+       * @param {string} [bundleName]
+       */
       const install = async (src, bundleName) => {
         if (bundleName) {
           const bundlePath = path.resolve(home, bundleName);

package/src/node/fs-stream.d.ts

@@ -1,11 +1,12 @@
 export function fsStreamReady(stream: StreamLike): Promise<void>;
 export function makeFsStreamWriter(filePath: string | undefined | null): Promise<{
-    write: (data: any) => Promise<void>;
+    write: (data: string | Uint8Array) => Promise<void>;
     flush: () => Promise<void>;
     close: () => Promise<void>;
 } | undefined>;
 export type StreamLike = ReadStream | WriteStream | Socket;
 export type EventName = "drain" | "ready";
+export type WriteBufferIsFull = boolean;
 export type FsStreamWriter = NonNullable<Awaited<ReturnType<typeof makeFsStreamWriter>>>;
 import type { ReadStream } from 'node:fs';
 import type { WriteStream } from 'node:fs';

package/src/node/fs-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs-stream.d.ts","sourceRoot":"","sources":["fs-stream.js"],"names":[],"mappings":"AAgBO,sCAHI,UAAU,GACR,OAAO,CAAC,IAAI,CAAC,CAgCtB;AA8GG,6CADK,MAAM,GAAG,SAAS,GAAG,IAAI;;;;eAsEpC;yBAxNa,UAAU,GAAG,WAAW,GAAG,MAAM;wBACjC,OAAO,GAAG,OAAO;6BAgJjB,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC;gCArJ/B,SAAS;iCAAT,SAAS;4BAC1B,UAAU"}
+{"version":3,"file":"fs-stream.d.ts","sourceRoot":"","sources":["fs-stream.js"],"names":[],"mappings":"AAiBO,sCAHI,UAAU,GACR,OAAO,CAAC,IAAI,CAAC,CAgCtB;AA6GG,6CADK,MAAM,GAAG,SAAS,GAAG,IAAI;kBA0CvB,MAAM,GAAG,UAAU;;;eAgChC;yBA5Na,UAAU,GAAG,WAAW,GAAG,MAAM;wBACjC,OAAO,GAAG,OAAO;gCACjB,OAAO;6BA+IP,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC;gCArJ/B,SAAS;iCAAT,SAAS;4BAC1B,UAAU"}

package/src/node/fs-stream.js

@@ -9,6 +9,7 @@ import { promisify } from 'node:util';
 
 /** @typedef {ReadStream | WriteStream | Socket} StreamLike */
 /** @typedef {'drain' | 'ready'} EventName */
+/** @typedef {boolean} WriteBufferIsFull */
 
 /**
  * @param {StreamLike} stream
@@ -134,13 +135,12 @@ const onceWithError = makeMemoizedOnceWithError(subscribeOnceWithError);
 /**
  * @param {WriteStream | Socket} stream
  * @param {string | Uint8Array} data
- * @returns {Promise<boolean>} whether caller must await drain
+ * @returns {Promise<WriteBufferIsFull>} whether caller must await drain
  */
 const writeChunk = (stream, data) =>
   new Promise((resolve, reject) => {
-    let waitForDrain;
     try {
-      waitForDrain = !stream.write(data, err => {
+      const waitForDrain = !stream.write(data, err => {
         if (err) {
           reject(err);
           return;
@@ -174,15 +174,18 @@ export const makeFsStreamWriter = async filePath => {
       ? undefined
       : promisify(/** @type {WriteStream} */ (stream).close.bind(stream));
 
-  let flushed = Promise.resolve();
+  /** @type {Promise<WriteBufferIsFull>} */
+  let flushed = Promise.resolve(false);
   let closed = false;
 
+  /** @param {Promise<WriteBufferIsFull>} p */
   const updateFlushed = p => {
     flushed = flushed.then(
       () => p,
       err =>
         p.then(
           () => Promise.reject(err),
+          /** @param {Error} pError */
           pError =>
             Promise.reject(
               pError !== err ? AggregateError([err, pError]) : err,
@@ -192,6 +195,7 @@ export const makeFsStreamWriter = async filePath => {
     flushed.catch(() => {});
   };
 
+  /** @param {string | Uint8Array} data */
   const write = async data => {
     const written = closed
       ? Promise.reject(Error('Stream closed'))

package/src/node/shutdown.d.ts

@@ -1,8 +1,10 @@
 export function makeFreshShutdown(verbose?: boolean): {
-    registerShutdown: (thunk: any) => () => void;
+    /** @param {(isSigInt: boolean) => unknown} thunk */
+    registerShutdown: (thunk: (isSigInt: boolean) => unknown) => () => void;
 };
-export function makeCachedShutdown(...args: any[]): {
-    registerShutdown: (thunk: any) => () => void;
+export function makeCachedShutdown(verbose?: boolean | undefined): {
+    /** @param {(isSigInt: boolean) => unknown} thunk */
+    registerShutdown: (thunk: (isSigInt: boolean) => unknown) => () => void;
 };
 export { makeCachedShutdown as makeShutdown };
 //# sourceMappingURL=shutdown.d.ts.map

package/src/node/shutdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["shutdown.js"],"names":[],"mappings":"AAKO;;EA8DN;AAIM;;EAON"}
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["shutdown.js"],"names":[],"mappings":"AAKO;IA4DH,oDAAoD;8BAAxC,CAAC,QAAQ,EAAE,OAAO,KAAK,OAAO;EAQ7C;AAKM;IAbH,oDAAoD;8BAAxC,CAAC,QAAQ,EAAE,OAAO,KAAK,OAAO;EAoB7C"}

package/src/node/shutdown.js

@@ -4,6 +4,7 @@ import anylogger from '../../vendor/anylogger.js';
 const console = anylogger('shutdown');
 
 export const makeFreshShutdown = (verbose = true) => {
+  /** @type {Set<(isSigInt: boolean) => unknown>} */
   const shutdownThunks = new Set();
 
   let shuttingDown = false;
@@ -40,12 +41,16 @@ export const makeFreshShutdown = (verbose = true) => {
       .catch(error => verbose && console.warn('Error shutting down', error))
       .finally(() => {
         // Let `beforeExit` exit cleanly
+        // `code` may be a signal string; the loose `>=` comparison is
+        // intentional. The cast is type-only (erased at runtime), so it
+        // preserves the original comparison semantics.
         if (!(code >= 0)) {
           process.exit();
         }
       });
   };
 
+  /** @type {NodeJS.UncaughtExceptionListener} */
   const uncaughtShutdown = e => {
     console.error(e);
     shutdown(-1);
@@ -58,6 +63,7 @@ export const makeFreshShutdown = (verbose = true) => {
   process.on('uncaughtException', uncaughtShutdown);
 
   return {
+    /** @param {(isSigInt: boolean) => unknown} thunk */
     registerShutdown: thunk => {
       shutdownThunks.add(thunk);
       return () => {
@@ -69,6 +75,7 @@ export const makeFreshShutdown = (verbose = true) => {
 
 /** @type {ReturnType<typeof makeFreshShutdown> | null} */
 let cachedShutdown = null;
+/** @param {Parameters<typeof makeFreshShutdown>} args */
 export const makeCachedShutdown = (...args) => {
   // It's possible our caller has specified different arguments.
   // Since they control verbosity only, first-one-wins is acceptable.

package/src/priority-senders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"priority-senders.d.ts","sourceRoot":"","sources":["priority-senders.js"],"names":[],"mappings":"AAUA,4CAA4C;AAC5C,uCADW,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAMtC;AAQK,wDAFI,KAAK,WAAW,CAAC;IA0CxB;;;;OAIG;wBAHQ,MAAM,WACN,MAAM,KACJ,OAAO,CAAC,IAAI,CAAC;IAe1B;;;;OAIG;2BAHQ,MAAM,WACN,MAAM,KACJ,OAAO,CAAC,IAAI,CAAC;;IArB1B;;;;OAIG;wBAHQ,MAAM,WACN,MAAM,KACJ,OAAO,CAAC,IAAI,CAAC;IAe1B;;;;OAIG;2BAHQ,MAAM,WACN,MAAM,KACJ,OAAO,CAAC,IAAI,CAAC;GAuB7B;qCAGa,UAAU,CAAC,OAAO,0BAA0B,CAAC;iCA1G7B,uBAAuB;0BAD9B,WAAW"}
+{"version":3,"file":"priority-senders.d.ts","sourceRoot":"","sources":["priority-senders.js"],"names":[],"mappings":"AAUA,4CAA4C;AAC5C,uCADW,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAMtC;AAQK,wDAFI,KAAK,WAAW,CAAC;IA2CxB;;;;OAIG;wBAHQ,MAAM,WACN,MAAM,KACJ,OAAO,CAAC,IAAI,CAAC;IAe1B;;;;OAIG;2BAHQ,MAAM,WACN,MAAM,KACJ,OAAO,CAAC,IAAI,CAAC;;IArB1B;;;;OAIG;wBAHQ,MAAM,WACN,MAAM,KACJ,OAAO,CAAC,IAAI,CAAC;IAe1B;;;;OAIG;2BAHQ,MAAM,WACN,MAAM,KACJ,OAAO,CAAC,IAAI,CAAC;GAuB7B;qCAGa,UAAU,CAAC,OAAO,0BAA0B,CAAC;iCA3G7B,uBAAuB;0BAD9B,WAAW"}

package/src/priority-senders.js

@@ -47,6 +47,7 @@ export const makePrioritySendersManager = sendersNode => {
     );
   };
 
+  /** @param {string} address */
   const provideRecordForAddress = async address => {
     const extant = addressRecords.get(address);
     if (extant) {

package/src/queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["queue.js"],"names":[],"mappings":"AAMO,kCA2BqB,OAFf,CAEoB,MAKH,GAAG,MAHlB,UAAU,CAAC,CAAC,CAGU,KAFpB,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAkB/C"}
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["queue.js"],"names":[],"mappings":"AAMO,kCAoCqB,OAFf,CAEoB,MAKH,GAAG,MAHlB,UAAU,CAAC,CAAC,CAGU,KAFpB,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAmB/C"}

package/src/queue.js

@@ -5,6 +5,15 @@ import { makePromiseKit } from '@endo/promise-kit';
  * of them (in order) is running at a time.
  */
 export const makeWithQueue = () => {
+  /**
+   * @type {Array<
+   *   [
+   *     thunk: (value?: unknown) => unknown,
+   *     resolve: (value: unknown) => void,
+   *     reject: (reason?: unknown) => void,
+   *   ]
+   * >}
+   */
   const queue = [];
 
   // Execute the thunk at the front of the queue.
@@ -39,6 +48,7 @@ export const makeWithQueue = () => {
     return function queueCall(...args) {
       // Curry the arguments into the inner function, and
       // resolve/reject with whatever the inner function does.
+      /** @param {unknown} _ */
       const thunk = _ => inner(...args);
       const pr = makePromiseKit();
       queue.push([thunk, pr.resolve, pr.reject]);

package/src/scratch.d.ts

@@ -1,19 +1,41 @@
 export default function makeScratchPad(): {
-    delete: (keyP: any) => Promise<void>;
-    get: (keyP: any) => Promise<any>;
-    lookup: (...path: any[]) => any;
-    init: (keyP: any, objP: any) => Promise<any>;
+    /** @param {import('@endo/far').ERef<unknown>} keyP */
+    delete: (keyP: import("@endo/far").ERef<unknown>) => Promise<void>;
+    /** @param {import('@endo/far').ERef<unknown>} keyP */
+    get: (keyP: import("@endo/far").ERef<unknown>) => Promise<any>;
+    /** @param {...unknown} path */
+    lookup: (...path: unknown[]) => any;
+    /**
+     * @param {import('@endo/far').ERef<unknown>} keyP
+     * @param {import('@endo/far').ERef<unknown>} objP
+     */
+    init: (keyP: import("@endo/far").ERef<unknown>, objP: import("@endo/far").ERef<unknown>) => Promise<unknown>;
     keys: () => Promise<any[]>;
     list: () => Promise<any[]>;
-    set: (keyP: any, objP: any) => Promise<any>;
+    /**
+     * @param {import('@endo/far').ERef<unknown>} keyP
+     * @param {import('@endo/far').ERef<unknown>} objP
+     */
+    set: (keyP: import("@endo/far").ERef<unknown>, objP: import("@endo/far").ERef<unknown>) => Promise<unknown>;
 } & import("@endo/pass-style").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
-    delete: (keyP: any) => Promise<void>;
-    get: (keyP: any) => Promise<any>;
-    lookup: (...path: any[]) => any;
-    init: (keyP: any, objP: any) => Promise<any>;
+    /** @param {import('@endo/far').ERef<unknown>} keyP */
+    delete: (keyP: import("@endo/far").ERef<unknown>) => Promise<void>;
+    /** @param {import('@endo/far').ERef<unknown>} keyP */
+    get: (keyP: import("@endo/far").ERef<unknown>) => Promise<any>;
+    /** @param {...unknown} path */
+    lookup: (...path: unknown[]) => any;
+    /**
+     * @param {import('@endo/far').ERef<unknown>} keyP
+     * @param {import('@endo/far').ERef<unknown>} objP
+     */
+    init: (keyP: import("@endo/far").ERef<unknown>, objP: import("@endo/far").ERef<unknown>) => Promise<unknown>;
     keys: () => Promise<any[]>;
     list: () => Promise<any[]>;
-    set: (keyP: any, objP: any) => Promise<any>;
+    /**
+     * @param {import('@endo/far').ERef<unknown>} keyP
+     * @param {import('@endo/far').ERef<unknown>} objP
+     */
+    set: (keyP: import("@endo/far").ERef<unknown>, objP: import("@endo/far").ERef<unknown>) => Promise<unknown>;
 }>;
 export type ScratchPad = ReturnType<typeof makeScratchPad>;
 //# sourceMappingURL=scratch.d.ts.map

package/src/scratch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scratch.d.ts","sourceRoot":"","sources":["scratch.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgDC;yBACa,UAAU,CAAC,OAAO,cAAc,CAAC"}
+{"version":3,"file":"scratch.d.ts","sourceRoot":"","sources":["scratch.js"],"names":[],"mappings":"AAEA;IASI,sDAAsD;mBAA1C,OAAO,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC;IAK7C,sDAAsD;gBAA1C,OAAO,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC;IAK7C,+BAA+B;sBAAhB,OAAO,EAAA;IActB;;;OAGG;iBAFQ,OAAO,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,QACjC,OAAO,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC;;;IAa5C;;;OAGG;gBAFQ,OAAO,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,QACjC,OAAO,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC;;IAzC5C,sDAAsD;mBAA1C,OAAO,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC;IAK7C,sDAAsD;gBAA1C,OAAO,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC;IAK7C,+BAA+B;sBAAhB,OAAO,EAAA;IActB;;;OAGG;iBAFQ,OAAO,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,QACjC,OAAO,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC;;;IAa5C;;;OAGG;gBAFQ,OAAO,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,QACjC,OAAO,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC;GAS/C;yBACa,UAAU,CAAC,OAAO,cAAc,CAAC"}

package/src/scratch.js

@@ -9,14 +9,17 @@ export default function makeScratchPad() {
   };
 
   const scratch = Far('scratchPad', {
+    /** @param {import('@endo/far').ERef<unknown>} keyP */
     delete: async keyP => {
       const key = await keyP;
       map.delete(key);
     },
+    /** @param {import('@endo/far').ERef<unknown>} keyP */
     get: async keyP => {
       const key = await keyP;
       return map.get(key);
     },
+    /** @param {...unknown} path */
     lookup: (...path) => {
       if (path.length === 0) {
         return scratch;
@@ -30,6 +33,10 @@ export default function makeScratchPad() {
     },
     // Initialize a key only if it doesn't already exist.  Needed for atomicity
     // between multiple invocations.
+    /**
+     * @param {import('@endo/far').ERef<unknown>} keyP
+     * @param {import('@endo/far').ERef<unknown>} objP
+     */
     init: async (keyP, objP) => {
       const [key, obj] = await Promise.all([keyP, objP]);
       if (map.has(key)) {
@@ -41,6 +48,10 @@ export default function makeScratchPad() {
     keys,
     // Legacy alias for `keys`.
     list: keys,
+    /**
+     * @param {import('@endo/far').ERef<unknown>} keyP
+     * @param {import('@endo/far').ERef<unknown>} objP
+     */
     set: async (keyP, objP) => {
       const [key, obj] = await Promise.all([keyP, objP]);
       map.set(key, obj);

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

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

package/src/ses-utils.js

@@ -183,7 +183,8 @@ export const tryJsonParse = (jsonText, onError) => {
   const transformError =
     typeof onError === 'function'
       ? onError
-      : err => Fail([`${onError}: ${err.message} for input `, ''], jsonText);
+      : /** @param {Error} err */
+        err => Fail([`${onError}: ${err.message} for input `, ''], jsonText);
   return tryNow(() => {
     const type = typeof jsonText;
     type === 'string' || Fail`Input must be a string, not ${b(type)}`;

package/src/work-pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"work-pool.d.ts","sourceRoot":"","sources":["work-pool.js"],"names":[],"mappings":"AAgFO,6BAlBM,CAAC,EACA,CAAC,MACsB,CAAC,SAAxB,KAAK,GAAG,YAAa,kBACxB,aAAa,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,UAC9B,SAAS,GACb,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GACrB;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,CAAA;CAAE,iBAC3B,CACN,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EACjB,KAAK,CAAC,EAAE,MAAM,KACX,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAC3B,cAAc,CAC1B,CACM,CAAC,SAAS,YAAY,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAC5E,MAAY,CACP,CACF,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,KAAK,CAAA;CAAE,CA0JnD;uBAtNY,CAAC;aAEA,CAAC,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI;YACnC,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI;aACrB,OAAO,CAAC,CAAC,CAAC"}
+{"version":3,"file":"work-pool.d.ts","sourceRoot":"","sources":["work-pool.js"],"names":[],"mappings":"AAgFO,6BAlBM,CAAC,EACA,CAAC,MACsB,CAAC,SAAxB,KAAK,GAAG,YAAa,kBACxB,aAAa,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,UAC9B,SAAS,GACb,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GACrB;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,CAAA;CAAE,iBAC3B,CACN,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EACjB,KAAK,CAAC,EAAE,MAAM,KACX,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAC3B,cAAc,CAC1B,CACM,CAAC,SAAS,YAAY,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAC5E,MAAY,CACP,CACF,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,KAAK,CAAA;CAAE,CAiKnD;uBA7NY,CAAC;aAEA,CAAC,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI;YACnC,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI;aACrB,OAAO,CAAC,CAAC,CAAC"}

package/src/work-pool.js

@@ -93,8 +93,15 @@ export const makeWorkPool = (
     throw RangeError('mode must be "all" or "allSettled"');
   }
 
-  // Normalize source into an `inputs` iterator.
-  const makeInputs = source[Symbol.asyncIterator] || source[Symbol.iterator];
+  // Normalize source into an `inputs` iterator. `source` is an async- or
+  // sync-iterable; type the fallback (`Symbol.iterator`) as present so `||`
+  // yields a defined factory.
+  const iterableSource =
+    /** @type {{ [Symbol.asyncIterator]?: () => AsyncIterator<Awaited<T>>; [Symbol.iterator]: () => Iterator<Awaited<T>> }} */ (
+      source
+    );
+  const makeInputs =
+    iterableSource[Symbol.asyncIterator] || iterableSource[Symbol.iterator];
   const inputs =
     /** @type {AsyncIterator<Awaited<T>> | Iterator<Awaited<T>>} */ (
       Reflect.apply(makeInputs, source, [])