@agoric/internal 0.4.0-upgrade-14-dev-0169c7e.0 → 0.4.0-upgrade-16-dev-07b0130.0

package/README.md

@@ -10,11 +10,16 @@ Like all `@agoric` packages it follows Semantic Versioning. Unlike the others, i
 
 # Design
 
-It must be the lowest agoric-sdk package in any import graph. Therefore it must never depend on another agoric-sdk package. If there's a module in an another agoric-package that has no agoric-sdk dependencies, it can be moved into this package.
+It is meant to be a home for modules that have no Agoric-specific dependencies themselves. It does depend on a these other @agoric packages but they are all destined to migrate out of the repo,
+
+- base-zone
+- store
+- assert
+
+This package may not take dependencies on any others in this repository.
 
 It must never export ambient types.
 
 It should not be imported by deep imports. Eventually this will be enforced by [`exports`](https://nodejs.org/api/packages.html#exports) but the tooling isn't ready:
     - https://github.com/import-js/eslint-plugin-import/issues/1810
     - https://github.com/microsoft/TypeScript/issues/33079 (or some related problem with JSdoc types)
-

package/exported.js

@@ -0,0 +1,2 @@
+// Dummy file for .d.ts twin to declare ambients
+export {};

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@agoric/internal",
-  "version": "0.4.0-upgrade-14-dev-0169c7e.0+0169c7e",
+  "version": "0.4.0-upgrade-16-dev-07b0130.0+07b0130",
   "description": "Externally unsupported utilities internal to agoric-sdk",
   "type": "module",
   "main": "src/index.js",
   "engines": {
-    "node": ">=14.15.0"
+    "node": "^18.12 || ^20.9"
   },
   "scripts": {
     "build": "exit 0",
-    "prepack": "tsc --build jsconfig.build.json",
+    "prepack": "tsc --build tsconfig.build.json",
     "postpack": "git clean -f '*.d.ts*'",
     "test": "ava",
     "test:nyc": "exit 0",
@@ -17,30 +17,46 @@
     "lint-fix": "yarn lint:eslint --fix",
     "lint": "run-s --continue-on-error lint:*",
     "lint:eslint": "eslint .",
-    "lint:types": "tsc -p jsconfig.json"
+    "lint:types": "tsc"
   },
   "dependencies": {
-    "@agoric/zone": "0.2.3-upgrade-14-dev-0169c7e.0+0169c7e",
-    "@endo/far": "0.2.18",
-    "@endo/marshal": "0.8.5",
-    "@endo/patterns": "0.2.2",
-    "@endo/promise-kit": "0.2.56",
-    "@endo/stream": "0.3.25",
+    "@agoric/assert": "0.6.1-upgrade-16-dev-07b0130.0+07b0130",
+    "@agoric/base-zone": "0.1.1-upgrade-16-dev-07b0130.0+07b0130",
+    "@endo/common": "^1.2.2",
+    "@endo/far": "^1.1.2",
+    "@endo/init": "^1.1.2",
+    "@endo/marshal": "^1.5.0",
+    "@endo/pass-style": "^1.4.0",
+    "@endo/patterns": "^1.4.0",
+    "@endo/promise-kit": "^1.1.2",
+    "@endo/stream": "^1.2.2",
     "anylogger": "^0.21.0",
-    "jessie.js": "^0.3.2"
+    "jessie.js": "^0.3.4"
   },
   "devDependencies": {
-    "@endo/init": "0.5.56",
-    "ava": "^5.2.0",
-    "tsd": "^0.28.1"
+    "@endo/init": "^1.1.2",
+    "ava": "^5.3.0",
+    "tsd": "^0.30.7"
+  },
+  "ava": {
+    "require": [
+      "@endo/init/debug.js"
+    ],
+    "files": [
+      "test/**/*.test.*"
+    ]
   },
   "author": "Agoric",
   "license": "Apache-2.0",
   "files": [
-    "src"
+    "src",
+    "exported.js"
   ],
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "0169c7e505099fdcfa8e4d1436e5d3b372f1c320"
+  "typeCoverage": {
+    "atLeast": 93.89
+  },
+  "gitHead": "07b01308eaccca903919d495aded620c9849efc7"
 }

package/src/batched-deliver.d.ts

@@ -1,15 +1,18 @@
 /**
- * @typedef {(message: any[], ackNum: number) => void} DeliverMessages
+ * @typedef {(message: unknown[], ackNum: number) => Promise<void>} DeliverMessages
  */
 /**
  * @param {DeliverMessages} deliver
- * @param {{ clearTimeout: NodeJS.clearTimeout, setTimeout: NodeJS.setTimeout }} io
+ * @param {{
+ *   clearTimeout: import('node:timers').clearTimeout;
+ *   setTimeout: import('node:timers').setTimeout;
+ * }} io
  * @param {number} batchTimeoutMs
  */
 export function makeBatchedDeliver(deliver: DeliverMessages, { clearTimeout, setTimeout }: {
-    clearTimeout: NodeJS.clearTimeout;
-    setTimeout: NodeJS.setTimeout;
-}, batchTimeoutMs?: number): (newMessages: any[], ackNum: number) => void;
+    clearTimeout: typeof globalThis.clearTimeout;
+    setTimeout: typeof globalThis.setTimeout;
+}, batchTimeoutMs?: number): (message: unknown[], ackNum: number) => Promise<void>;
 export const DEFAULT_BATCH_TIMEOUT_MS: 1000;
-export type DeliverMessages = (message: any[], ackNum: number) => void;
+export type DeliverMessages = (message: unknown[], ackNum: number) => Promise<void>;
 //# sourceMappingURL=batched-deliver.d.ts.map

package/src/batched-deliver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"batched-deliver.d.ts","sourceRoot":"","sources":["batched-deliver.js"],"names":[],"mappings":"AAIA;;GAEG;AAEH;;;;GAIG;AACH,4CAJW,eAAe,gCACf;IAAE,kCAAkC;IAAC,8BAA6B;CAAE,mBACpE,MAAM,gDAsChB;AA/CD,4CAA6C;wCAGtB,GAAG,EAAE,UAAU,MAAM,KAAK,IAAI"}
+{"version":3,"file":"batched-deliver.d.ts","sourceRoot":"","sources":["batched-deliver.js"],"names":[],"mappings":"AAKA;;GAEG;AAEH;;;;;;;GAOG;AACH,4CAPW,eAAe,gCACf;IACV,YAAgB,EAAE,8BAAkC,CAAC;IACrD,UAAc,EAAE,4BAAgC,CAAC;CAC9C,mBACO,MAAM,aATM,OAAO,EAAE,UAAU,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAiDjE;AApDD,4CAA6C;8BAGhC,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC"}

package/src/batched-deliver.js

@@ -1,14 +1,18 @@
 // @jessie-check
+// @ts-check
 
 export const DEFAULT_BATCH_TIMEOUT_MS = 1000;
 
 /**
- * @typedef {(message: any[], ackNum: number) => void} DeliverMessages
+ * @typedef {(message: unknown[], ackNum: number) => Promise<void>} DeliverMessages
  */
 
 /**
  * @param {DeliverMessages} deliver
- * @param {{ clearTimeout: NodeJS.clearTimeout, setTimeout: NodeJS.setTimeout }} io
+ * @param {{
+ *   clearTimeout: import('node:timers').clearTimeout;
+ *   setTimeout: import('node:timers').setTimeout;
+ * }} io
  * @param {number} batchTimeoutMs
  */
 export function makeBatchedDeliver(
@@ -16,8 +20,10 @@ export function makeBatchedDeliver(
   { clearTimeout, setTimeout },
   batchTimeoutMs = DEFAULT_BATCH_TIMEOUT_MS,
 ) {
+  /** @type {unknown[]} */
   let batchedMessages = [];
   let latestAckNum = 0;
+  /** @type {NodeJS.Timeout} */
   let deliverTimeout;
 
   /**
@@ -34,7 +40,7 @@ export function makeBatchedDeliver(
         // Transfer the batched messages to the deliver function.
         const msgs = batchedMessages;
         batchedMessages = [];
-        deliver(msgs, latestAckNum);
+        void deliver(msgs, latestAckNum);
       }, batchTimeoutMs);
     }
 

package/src/callback.d.ts

@@ -1,23 +1,30 @@
-export function callSync<I extends (...args: unknown[]) => any>(callback: import("./types").SyncCallback<I>, ...args: Parameters<I>): ReturnType<I>;
-export function callE<I extends (...args: unknown[]) => any>(callback: import("./types").Callback<I>, ...args: Parameters<I>): Promise<Awaited<ReturnType<I>>>;
-export function makeSyncFunctionCallback<I extends (...args: unknown[]) => any, T extends (...args: [...B, ...Parameters<I>]) => ReturnType<I> = I, B extends unknown[] = []>(target: T, ...bound: B): import("./types").SyncCallback<I>;
-export function makeFunctionCallback<I extends (...args: unknown[]) => any, T extends import("@endo/far").ERef<(...args: [...B, ...Parameters<I>]) => ReturnType<I>> = import("@endo/far").ERef<I>, B extends unknown[] = []>(target: T, ...bound: B): import("./types").Callback<I>;
-export function makeSyncMethodCallback<I extends (...args: unknown[]) => any, P extends PropertyKey, T extends { [x in P]: (...args: [...B, ...Parameters<I>]) => ReturnType<I>; } = { [x_1 in P]: I; }, B extends unknown[] = []>(target: T, methodName: P, ...bound: B): import("./types").SyncCallback<I>;
-export function makeMethodCallback<I extends (...args: unknown[]) => any, P extends PropertyKey, T extends import("@endo/far").ERef<{ [x in P]: (...args: [...B, ...Parameters<I>]) => ReturnType<I>; }> = import("@endo/far").ERef<{ [x_1 in P]: I; }>, B extends unknown[] = []>(target: T, methodName: P, ...bound: B): import("./types").Callback<I>;
-export function isCallback(callback: any): callback is import("./types").Callback<any>;
-export function prepareAttenuator<M extends PropertyKey>(zone: import('@agoric/zone').Zone, methodNames: M[], { interfaceGuard, tag }?: {
-    interfaceGuard?: InterfaceGuard | undefined;
+export function callSync<I extends (...args: unknown[]) => any>(callback: SyncCallback<I>, ...args: Parameters<I>): ReturnType<I>;
+export function callE<I extends (...args: unknown[]) => any>(callback: Callback<I>, ...args: Parameters<I>): Promise<Awaited<ReturnType<I>>>;
+export function makeSyncFunctionCallback<I extends (...args: unknown[]) => any, T extends (...args: [...B, ...Parameters<I>]) => ReturnType<I> = I, B extends unknown[] = []>(target: T, ...bound: B): SyncCallback<I>;
+export function makeFunctionCallback<I extends (...args: unknown[]) => any, T extends ERef<(...args: [...B, ...Parameters<I>]) => ReturnType<I>> = ERef<I>, B extends unknown[] = []>(target: T, ...bound: B): Callback<I>;
+export function makeSyncMethodCallback<I extends (...args: unknown[]) => any, P extends PropertyKey, T extends { [x in P]: (...args: [...B, ...Parameters<I>]) => ReturnType<I>; } = { [x in P]: I; }, B extends unknown[] = []>(target: T, methodName: P, ...bound: B): SyncCallback<I>;
+export function makeMethodCallback<I extends (...args: unknown[]) => any, P extends PropertyKey, T extends ERef<{ [x in P]: (...args: [...B, ...Parameters<I>]) => ReturnType<I>; }> = ERef<{ [x in P]: I; }>, B extends unknown[] = []>(target: T, methodName: P, ...bound: B): Callback<I>;
+export function isCallback(callback: any): callback is Callback<any>;
+export function prepareAttenuator<M extends PropertyKey>(zone: import("@agoric/base-zone").Zone, methodNames: M[], { interfaceGuard, tag }?: {
+    interfaceGuard?: import("@endo/patterns").InterfaceGuard<{ [K in M]: import("@endo/patterns").MethodGuard; }> | undefined;
     tag?: string | undefined;
 }): (args_0: {
     target?: any;
     isSync?: boolean | undefined;
-    overrides?: { [K in M]?: import("./types").Callback<any> | null | undefined; } | undefined;
-}) => { [K_1 in M]: (this: any, ...args: unknown[]) => any; } & import("@endo/eventual-send").RemotableBrand<{}, { [K_1 in M]: (this: any, ...args: unknown[]) => any; }>;
-export function prepareGuardedAttenuator(zone: import('@agoric/zone').Zone, interfaceGuard: InterfaceGuard, opts?: {
+    overrides?: { [K_1 in M]?: Callback<any> | null | undefined; } | undefined;
+}) => import("@endo/exo").Guarded<{ [K_2 in M]: (this: any, ...args: unknown[]) => any; }>;
+export function prepareGuardedAttenuator<G extends import("@endo/patterns").InterfaceGuard>(zone: import("@agoric/base-zone").Zone, interfaceGuard: G, opts?: {
     tag?: string | undefined;
 } | undefined): MakeAttenuator<any>;
-export type MakeAttenuator<T> = MakeAttenuator<T>;
-export type Callback<I extends (...args: unknown[]) => any> = import('./types').Callback<I>;
-export type SyncCallback<I extends (...args: unknown[]) => any> = import('./types').SyncCallback<I>;
-export type Farable<T> = import('@endo/eventual-send').RemotableBrand<{}, T> & T;
+export type MakeAttenuator<T extends import("@endo/exo").Methods> = (...args: Parameters<ReturnType<(<M extends PropertyKey>(zone: import("@agoric/base-zone").Zone, methodNames: M[], { interfaceGuard, tag }?: {
+    interfaceGuard?: import("@endo/patterns").InterfaceGuard<{ [K in M]: import("@endo/patterns").MethodGuard; }> | undefined;
+    tag?: string | undefined;
+}) => (args_0: {
+    target?: any;
+    isSync?: boolean | undefined;
+    overrides?: { [K_1 in M]?: Callback<any> | null | undefined; } | undefined;
+}) => import("@endo/exo").Guarded<{ [K_2 in M]: (this: any, ...args: unknown[]) => any; }>)>>) => import("@endo/exo").Farable<T>;
+import type { SyncCallback } from './types.js';
+import type { Callback } from './types.js';
+import type { ERef } from '@endo/far';
 //# sourceMappingURL=callback.d.ts.map

package/src/callback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"callback.d.ts","sourceRoot":"","sources":["callback.js"],"names":[],"mappings":"AAuDO,6CALiB,OAAO,EAAE,KAAK,GAAG,sFAWxC;AAWM,0CALiB,OAAO,EAAE,KAAK,GAAG,oGAWxC;AAaM,6DAPiB,OAAO,EAAE,KAAK,GAAG,2JAaxC;AAeM,yDATiB,OAAO,EAAE,KAAK,GAAG,2MAexC;AAiBM,2DAXiB,OAAO,EAAE,KAAK,GAAG,iOAoBxC;AAiBM,uDAXiB,OAAO,EAAE,KAAK,GAAG,iRAmBxC;AAOM,qCAHI,GAAG,+CAeb;AAcM,+DAPI,OAAO,cAAc,EAAE,IAAI;IAGL,cAAc;IAEtB,GAAG;;aAkEb,GAAG;;;2BAxDgB,GAAG,WAAW,OAAO,EAAE,KAAK,GAAG,4EAA/B,GAAG,WAAW,OAAO,EAAE,KAAK,GAAG,KA2FhE;AAWM,+CALI,OAAO,cAAc,EAAE,IAAI,kBAC3B,cAAc;;oCAYxB;;yCA5SuB,OAAO,EAAE,KAAK,GAAG,IAC5B,OAAO,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;6CAIlB,OAAO,EAAE,KAAK,GAAG,IAC5B,OAAO,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;yBAGpB,OAAO,qBAAqB,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC"}
+{"version":3,"file":"callback.d.ts","sourceRoot":"","sources":["callback.js"],"names":[],"mappings":"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"}

package/src/callback.js

@@ -1,6 +1,10 @@
 // @ts-check
 import { E } from '@endo/far';
 import { isObject, isPassableSymbol } from '@endo/marshal';
+import { getInterfaceMethodKeys } from '@endo/patterns';
+
+/** @import {ERef} from '@endo/far' */
+/** @import {Callback, SyncCallback} from './types.js' */
 
 const { Fail, quote: q } = assert;
 
@@ -8,31 +12,21 @@ const { fromEntries } = Object;
 
 const { ownKeys: rawOwnKeys } = Reflect;
 const ownKeys =
-  /** @type {<T extends PropertyKey>(obj: {[K in T]?: unknown}) => T[]} */ (
+  /** @type {<T extends PropertyKey>(obj: { [K in T]?: unknown }) => T[]} */ (
     rawOwnKeys
   );
 
 /**
- * @template T
- * @typedef {(...args: Parameters<ReturnType<prepareAttenuator>>) => Farable<T>} MakeAttenuator
- */
-
-/**
- * @template {(...args: unknown[]) => any} I
- * @typedef {import('./types').Callback<I>} Callback
- */
-
-/**
- * @template {(...args: unknown[]) => any} I
- * @typedef {import('./types').SyncCallback<I>} SyncCallback
+ * @template {import('@endo/exo').Methods} T
+ * @typedef {(
+ *   ...args: Parameters<ReturnType<prepareAttenuator>>
+ * ) => import('@endo/exo').Farable<T>} MakeAttenuator
  */
 
-/** @template T @typedef {import('@endo/eventual-send').RemotableBrand<{}, T> & T} Farable */
-
 /**
  * @param {unknown} key
  * @returns {key is PropertyKey} FIXME: should be just `PropertyKey` but TS
- * complains it can't be used as an index type.
+ *   complains it can't be used as an index type.
  */
 const isPropertyKey = key => {
   switch (typeof key) {
@@ -102,9 +96,7 @@ harden(makeSyncFunctionCallback);
  * Create a callback from a potentially far function.
  *
  * @template {(...args: unknown[]) => any} I
- * @template {import('@endo/far').ERef<
- *   (...args: [...B, ...Parameters<I>]) => ReturnType<I>
- * >} [T=import('@endo/far').ERef<I>]
+ * @template {ERef<(...args: [...B, ...Parameters<I>]) => ReturnType<I>>} [T=ERef<I>]
  * @template {unknown[]} [B=[]]
  * @param {T} target
  * @param {B} bound
@@ -125,7 +117,7 @@ harden(makeFunctionCallback);
  * @template {(...args: unknown[]) => any} I
  * @template {PropertyKey} P
  * @template {{
- *   [x in P]: (...args: [...B, ...Parameters<I>]) => ReturnType<I>
+ *   [x in P]: (...args: [...B, ...Parameters<I>]) => ReturnType<I>;
  * }} [T={ [x in P]: I }]
  * @template {unknown[]} [B=[]]
  * @param {T} target
@@ -150,9 +142,9 @@ harden(makeSyncMethodCallback);
  *
  * @template {(...args: unknown[]) => any} I
  * @template {PropertyKey} P
- * @template {import('@endo/far').ERef<{
- *   [x in P]: (...args: [...B, ...Parameters<I>]) => ReturnType<I>
- * }>} [T=import('@endo/far').ERef<{ [x in P]: I }>]
+ * @template {ERef<{
+ *   [x in P]: (...args: [...B, ...Parameters<I>]) => ReturnType<I>;
+ * }>} [T=ERef<{ [x in P]: I }>]
  * @template {unknown[]} [B=[]]
  * @param {T} target
  * @param {P} methodName
@@ -193,11 +185,14 @@ harden(isCallback);
  * Prepare an attenuator class whose methods can be redirected via callbacks.
  *
  * @template {PropertyKey} M
- * @param {import('@agoric/zone').Zone} zone The zone in which to allocate attenuators.
+ * @param {import('@agoric/base-zone').Zone} zone The zone in which to allocate
+ *   attenuators.
  * @param {M[]} methodNames Methods to forward.
  * @param {object} opts
- * @param {InterfaceGuard} [opts.interfaceGuard] An interface guard for the
- * new attenuator.
+ * @param {import('@endo/patterns').InterfaceGuard<{
+ *   [K in M]: import('@endo/patterns').MethodGuard;
+ * }>} [opts.interfaceGuard]
+ *   An interface guard for the new attenuator.
  * @param {string} [opts.tag] A tag for the new attenuator exoClass.
  */
 export const prepareAttenuator = (
@@ -207,7 +202,9 @@ export const prepareAttenuator = (
 ) => {
   /**
    * @typedef {(this: any, ...args: unknown[]) => any} Method
-   * @typedef {{ [K in M]?: Callback<any> | null}} Overrides
+   *
+   * @typedef {{ [K in M]?: Callback<any> | null }} Overrides
+   *
    * @typedef {{ [K in M]: (this: any, ...args: unknown[]) => any }} Methods
    */
   const methods = /** @type {Methods} */ (
@@ -250,14 +247,13 @@ export const prepareAttenuator = (
    * and/or individual method override callbacks.
    *
    * @param {object} opts
-   * @param {unknown} [opts.target] The target for any methods that
-   * weren't specified in `opts.overrides`.
+   * @param {unknown} [opts.target] The target for any methods that weren't
+   *   specified in `opts.overrides`.
    * @param {boolean} [opts.isSync=false] Whether the target should be treated
-   * as synchronously available.
-   * @param {Overrides} [opts.overrides] Set individual
-   * callbacks for methods (whose names must be defined in the
-   * `prepareAttenuator` or `prepareGuardedAttenuator` call).  Nullish overrides
-   * mean to throw.
+   *   as synchronously available.
+   * @param {Overrides} [opts.overrides] Set individual callbacks for methods
+   *   (whose names must be defined in the `prepareAttenuator` or
+   *   `prepareGuardedAttenuator` call). Nullish overrides mean to throw.
    */
   const makeAttenuator = zone.exoClass(
     tag,
@@ -265,7 +261,7 @@ export const prepareAttenuator = (
     /**
      * @param {object} opts
      * @param {any} [opts.target]
-     * @param {boolean} [opts.isSync=false]
+     * @param {boolean} [opts.isSync]
      * @param {Overrides} [opts.overrides]
      */
     ({
@@ -305,14 +301,14 @@ harden(prepareAttenuator);
 /**
  * Prepare an attenuator whose methodNames are derived from the interfaceGuard.
  *
- * @param {import('@agoric/zone').Zone} zone
- * @param {InterfaceGuard} interfaceGuard
+ * @template {import('@endo/patterns').InterfaceGuard} G
+ * @param {import('@agoric/base-zone').Zone} zone
+ * @param {G} interfaceGuard
  * @param {object} [opts]
  * @param {string} [opts.tag]
  */
 export const prepareGuardedAttenuator = (zone, interfaceGuard, opts = {}) => {
-  const { methodGuards } = interfaceGuard;
-  const methodNames = ownKeys(methodGuards);
+  const methodNames = getInterfaceMethodKeys(interfaceGuard);
   const makeAttenuator = prepareAttenuator(zone, methodNames, {
     ...opts,
     interfaceGuard,

package/src/chain-storage-paths.d.ts

@@ -1,7 +1,6 @@
 /**
- * These identify top-level paths for SwingSet chain storage
- * (and serve as prefixes).
- * To avoid collisions, they should remain synchronized with
+ * These identify top-level paths for SwingSet chain storage (and serve as
+ * prefixes). To avoid collisions, they should remain synchronized with
  * golang/cosmos/x/swingset/keeper/keeper.go
  */
 export const ACTION_QUEUE: "actionQueue";

package/src/chain-storage-paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chain-storage-paths.d.ts","sourceRoot":"","sources":["chain-storage-paths.js"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,yCAA0C;AAC1C,sDAAuD;AACvD,0DAA2D;AAC3D,sCAAuC;AACvC,8BAA+B;AAC/B,gCAAiC;AACjC,gCAAiC;AACjC,iCAAkC;AAClC,uCAAwC"}
+{"version":3,"file":"chain-storage-paths.d.ts","sourceRoot":"","sources":["chain-storage-paths.js"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,yCAA0C;AAC1C,sDAAuD;AACvD,0DAA2D;AAC3D,sCAAuC;AACvC,8BAA+B;AAC/B,gCAAiC;AACjC,gCAAiC;AACjC,iCAAkC;AAClC,uCAAwC"}

package/src/chain-storage-paths.js

@@ -1,9 +1,8 @@
 // @jessie-check
 
 /**
- * These identify top-level paths for SwingSet chain storage
- * (and serve as prefixes).
- * To avoid collisions, they should remain synchronized with
+ * These identify top-level paths for SwingSet chain storage (and serve as
+ * prefixes). To avoid collisions, they should remain synchronized with
  * golang/cosmos/x/swingset/keeper/keeper.go
  */
 export const ACTION_QUEUE = 'actionQueue';

package/src/config.d.ts

@@ -1,25 +1,36 @@
 export namespace BridgeId {
-    const BANK: string;
-    const CORE: string;
-    const DIBC: string;
-    const STORAGE: string;
-    const PROVISION: string;
-    const PROVISION_SMART_WALLET: string;
-    const WALLET: string;
+    let BANK: "bank";
+    let CORE: "core";
+    let DIBC: "dibc";
+    let STORAGE: "storage";
+    let PROVISION: "provision";
+    let PROVISION_SMART_WALLET: "provisionWallet";
+    let VLOCALCHAIN: "vlocalchain";
+    let VTRANSFER: "vtransfer";
+    let WALLET: "wallet";
+}
+/** @typedef {(typeof BridgeId)[keyof typeof BridgeId]} BridgeIdValue */
+export const VTRANSFER_IBC_EVENT: "VTRANSFER_IBC_EVENT";
+export namespace CosmosInitKeyToBridgeId {
+    import vbankPort = BANK;
+    export { vbankPort };
+    import vibcPort = DIBC;
+    export { vibcPort };
 }
 export namespace WalletName {
-    const depositFacet: string;
+    let depositFacet: "depositFacet";
 }
 export namespace VBankAccount {
     namespace reserve {
-        const module: string;
-        const address: string;
+        let module: "vbank/reserve";
+        let address: "agoric1ae0lmtzlgrcnla9xjkpaarq5d5dfez63h3nucl";
     }
     namespace provision {
-        const module_1: string;
+        let module_1: "vbank/provision";
         export { module_1 as module };
-        const address_1: string;
+        let address_1: "agoric1megzytg65cyrgzs6fvzxgrcqvwwl7ugpt62346";
         export { address_1 as address };
     }
 }
+export type BridgeIdValue = (typeof BridgeId)[keyof typeof BridgeId];
 //# sourceMappingURL=config.d.ts.map

package/src/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["config.js"],"names":[],"mappings":""}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["config.js"],"names":[],"mappings":";;;;;;;;;;;AA8BA,wEAAwE;AAExE,wDAAyD;;;;;;;;;;;;;;;;;;;;;;4BAF3C,CAAC,OAAO,QAAQ,EAAE,MAAM,OAAO,QAAQ,CAAC"}

package/src/config.js

@@ -4,34 +4,46 @@
 /**
  * @file
  *
- * Some of this config info may make more sense in a particular package. However
- * due to https://github.com/Agoric/agoric-sdk/issues/4620 and our lax package
- * dependency graph, sometimes rational placements cause type resolution errors.
+ *   Some of this config info may make more sense in a particular package. However
+ *   due to https://github.com/Agoric/agoric-sdk/issues/4620 and our lax package
+ *   dependency graph, sometimes rational placements cause type resolution
+ *   errors.
  *
- * So as a work-around some constants that need access from more than one package are placed here.
+ *   So as a work-around some constants that need access from more than one
+ *   package are placed here.
  */
 
 /**
  * Event source ids used by the bridge device.
  */
-export const BridgeId = {
+export const BridgeId = /** @type {const} */ ({
   BANK: 'bank',
   CORE: 'core',
   DIBC: 'dibc',
   STORAGE: 'storage',
   PROVISION: 'provision',
   PROVISION_SMART_WALLET: 'provisionWallet',
+  VLOCALCHAIN: 'vlocalchain',
+  VTRANSFER: 'vtransfer',
   WALLET: 'wallet',
-};
+});
 harden(BridgeId);
+/** @typedef {(typeof BridgeId)[keyof typeof BridgeId]} BridgeIdValue */
 
-export const WalletName = {
-  depositFacet: 'depositFacet',
+export const VTRANSFER_IBC_EVENT = 'VTRANSFER_IBC_EVENT';
+
+export const CosmosInitKeyToBridgeId = {
+  vbankPort: BridgeId.BANK,
+  vibcPort: BridgeId.DIBC,
 };
+
+export const WalletName = /** @type {const} */ ({
+  depositFacet: 'depositFacet',
+});
 harden(WalletName);
 
 // defined in golang/cosmos/x/vbank
-export const VBankAccount = {
+export const VBankAccount = /** @type {const} */ ({
   reserve: {
     module: 'vbank/reserve',
     address: 'agoric1ae0lmtzlgrcnla9xjkpaarq5d5dfez63h3nucl',
@@ -40,5 +52,5 @@ export const VBankAccount = {
     module: 'vbank/provision',
     address: 'agoric1megzytg65cyrgzs6fvzxgrcqvwwl7ugpt62346',
   },
-};
+});
 harden(VBankAccount);

package/src/debug.d.ts

@@ -1,2 +1,2 @@
-export function makeTracer(name: string, enable?: boolean | 'verbose'): (..._args: any[]) => void;
+export function makeTracer(name: string, enable?: boolean | "verbose"): (..._args: any[]) => void;
 //# sourceMappingURL=debug.d.ts.map

package/src/index.d.ts

@@ -3,4 +3,7 @@ export * from "./debug.js";
 export * from "./utils.js";
 export * from "./method-tools.js";
 export * from "./typeGuards.js";
+export * from "./types.js";
+export { objectMap } from "@endo/common/object-map.js";
+export { fromUniqueEntries } from "@endo/common/from-unique-entries.js";
 //# sourceMappingURL=index.d.ts.map

package/src/index.js

@@ -1,9 +1,15 @@
 // @jessie-check
 
-/// <reference types="ses"/>
+/// <reference types="ses" />
 
 export * from './config.js';
 export * from './debug.js';
 export * from './utils.js';
 export * from './method-tools.js';
 export * from './typeGuards.js';
+
+// eslint-disable-next-line import/export -- just types
+export * from './types.js';
+
+export { objectMap } from '@endo/common/object-map.js';
+export { fromUniqueEntries } from '@endo/common/from-unique-entries.js';

package/src/install-ses-debug.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=install-ses-debug.d.ts.map

package/src/install-ses-debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-ses-debug.d.ts","sourceRoot":"","sources":["install-ses-debug.js"],"names":[],"mappings":""}

package/src/install-ses-debug.js

@@ -0,0 +1,6 @@
+// This is like `@endo/init` but sacrificing safety to optimize
+// for debugging and testing. The difference is only the lockdown options.
+// The setting below are *unsafe* and should not be used in contact with
+// genuinely malicious code.
+
+import '@endo/init/debug.js';