@agoric/internal 0.4.0 → 0.4.1-upgrade-23-dev-bd79330.0.bd79330

package/src/node/buffer-line-transform.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @import {TransformOptions} from 'node:stream';
+ * @import {TransformCallback} from 'node:stream';
+ */
 /**
  * @typedef {object} BufferLineTransformOptions
  * @property {Buffer | string | number} [break] line break matcher for
@@ -10,10 +14,9 @@ export default class BufferLineTransform extends Transform {
      * The BufferLineTransform is reading String or Buffer content from a Readable
      * stream and writing each line as a Buffer in object mode
      *
-     * @param {import('node:stream').TransformOptions &
-     *   BufferLineTransformOptions} [options]
+     * @param {TransformOptions & BufferLineTransformOptions} [options]
      */
-    constructor(options?: import("node:stream").TransformOptions & BufferLineTransformOptions);
+    constructor(options?: TransformOptions & BufferLineTransformOptions);
     _breakValue: string | number | Buffer<ArrayBufferLike>;
     _breakEncoding: BufferEncoding | undefined;
     _breakLength: number;
@@ -22,10 +25,10 @@ export default class BufferLineTransform extends Transform {
     /**
      * @param {any} chunk
      * @param {BufferEncoding | 'buffer'} encoding
-     * @param {import('node:stream').TransformCallback} cb
+     * @param {TransformCallback} cb
      * @override
      */
-    override _transform(chunk: any, encoding: BufferEncoding | "buffer", cb: import("node:stream").TransformCallback): void;
+    override _transform(chunk: any, encoding: BufferEncoding | "buffer", cb: TransformCallback): void;
     /** @param {Buffer} line */
     _writeItem(line: Buffer): void;
 }
@@ -42,4 +45,6 @@ export type BufferLineTransformOptions = {
     breakEncoding?: BufferEncoding | undefined;
 };
 import { Transform } from 'node:stream';
+import type { TransformCallback } from 'node:stream';
+import type { TransformOptions } from 'node:stream';
 //# sourceMappingURL=buffer-line-transform.d.ts.map

package/src/node/buffer-line-transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buffer-line-transform.d.ts","sourceRoot":"","sources":["buffer-line-transform.js"],"names":[],"mappings":"AAKA;;;;;;GAMG;AAEH;IACE;;;;;;OAMG;IACH,sBAHW,OAAO,aAAa,EAAE,gBAAgB,GAC5C,0BAA0B,EAyB9B;IAhBC,uDAAmC;IACnC,2CAAmC;IAWnC,qBAA+B;IAE/B,uBAAuB;IACvB,SADW,MAAM,EAAE,CACF;IAGnB;;;;;OAKG;IACH,2BALW,GAAG,YACH,cAAc,GAAG,QAAQ,MACzB,OAAO,aAAa,EAAE,iBAAiB,QAiDjD;IAeD,2BAA2B;IAC3B,iBADY,MAAM,QAOjB;CACF;;;;;;;;;;;;;0BAtHyB,aAAa"}
+{"version":3,"file":"buffer-line-transform.d.ts","sourceRoot":"","sources":["buffer-line-transform.js"],"names":[],"mappings":"AAKA;;;GAGG;AAEH;;;;;;GAMG;AAEH;IACE;;;;;OAKG;IACH,sBAFW,gBAAgB,GAAG,0BAA0B,EAyBvD;IAhBC,uDAAmC;IACnC,2CAAmC;IAWnC,qBAA+B;IAE/B,uBAAuB;IACvB,SADW,MAAM,EAAE,CACF;IAGnB;;;;;OAKG;IACH,2BALW,GAAG,YACH,cAAc,GAAG,QAAQ,MACzB,iBAAiB,QAiD3B;IAeD,2BAA2B;IAC3B,iBADY,MAAM,QAOjB;CACF;;;;;;;;;;;;;0BA1HyB,aAAa;uCAIH,aAAa;sCADd,aAAa"}

package/src/node/buffer-line-transform.js

@@ -3,6 +3,11 @@
 
 import { Transform } from 'node:stream';
 
+/**
+ * @import {TransformOptions} from 'node:stream';
+ * @import {TransformCallback} from 'node:stream';
+ */
+
 /**
  * @typedef {object} BufferLineTransformOptions
  * @property {Buffer | string | number} [break] line break matcher for
@@ -16,8 +21,7 @@ export default class BufferLineTransform extends Transform {
    * The BufferLineTransform is reading String or Buffer content from a Readable
    * stream and writing each line as a Buffer in object mode
    *
-   * @param {import('node:stream').TransformOptions &
-   *   BufferLineTransformOptions} [options]
+   * @param {TransformOptions & BufferLineTransformOptions} [options]
    */
   constructor(options) {
     const {
@@ -47,7 +51,7 @@ export default class BufferLineTransform extends Transform {
   /**
    * @param {any} chunk
    * @param {BufferEncoding | 'buffer'} encoding
-   * @param {import('node:stream').TransformCallback} cb
+   * @param {TransformCallback} cb
    * @override
    */
   _transform(chunk, encoding, cb) {
@@ -99,7 +103,7 @@ export default class BufferLineTransform extends Transform {
   }
 
   /**
-   * @param {import('node:stream').TransformCallback} cb
+   * @param {TransformCallback} cb
    * @override
    */
   _flush(cb) {

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

@@ -1 +1 @@
-{"version":3,"file":"createBundles.d.ts","sourceRoot":"","sources":["createBundles.js"],"names":[],"mappings":"AAYO,6EAgCN;AAEM,mFAMN;AAEM,iGAkCN"}
+{"version":3,"file":"createBundles.d.ts","sourceRoot":"","sources":["createBundles.js"],"names":[],"mappings":"AAUO,6EAgCN;AAEM,mFAMN;AAEM,iGAkCN"}

package/src/node/createBundles.js

@@ -1,9 +1,7 @@
 /* eslint-env node */
-// Use modules not prefixed with `node:` since some deploy scripts may
-// still be running in esm emulation
-import path from 'path';
-import { spawnSync } from 'child_process';
-import { createRequire } from 'module';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { createRequire } from 'node:module';
 
 import { Fail, q } from '@endo/errors';
 

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

@@ -1,8 +1,11 @@
-export function fsStreamReady(stream: import("fs").ReadStream | import("fs").WriteStream | import("net").Socket): Promise<void>;
+export function fsStreamReady(stream: ReadStream | WriteStream | Socket): Promise<void>;
 export function makeFsStreamWriter(filePath: string | undefined | null): Promise<{
     write: (data: any) => Promise<void>;
     flush: () => Promise<void>;
     close: () => Promise<void>;
 } | undefined>;
 export type FsStreamWriter = NonNullable<Awaited<ReturnType<typeof makeFsStreamWriter>>>;
+import type { ReadStream } from 'fs';
+import type { WriteStream } from 'fs';
+import type { Socket } from 'net';
 //# sourceMappingURL=fs-stream.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"fs-stream.d.ts","sourceRoot":"","sources":["fs-stream.js"],"names":[],"mappings":"AAUO,sCALI,OAAO,IAAI,EAAE,UAAU,GAC3B,OAAO,IAAI,EAAE,WAAW,GACxB,OAAO,KAAK,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAgCtB;AAIG,6CADK,MAAM,GAAG,SAAS,GAAG,IAAI;;;;eAwEpC;6BAzEa,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"fs-stream.d.ts","sourceRoot":"","sources":["fs-stream.js"],"names":[],"mappings":"AAcO,sCAHI,UAAU,GAAG,WAAW,GAAG,MAAM,GAC/B,OAAO,CAAC,IAAI,CAAC,CAgCtB;AAmDG,6CADK,MAAM,GAAG,SAAS,GAAG,IAAI;;;;eAsEpC;6BAvEa,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC;gCAxF5C,IAAI;iCACH,IAAI;4BACT,KAAK"}

package/src/node/fs-stream.js

@@ -3,9 +3,13 @@ import process from 'node:process';
 import { promisify } from 'node:util';
 
 /**
- * @param {import('fs').ReadStream
- *   | import('fs').WriteStream
- *   | import('net').Socket} stream
+ * @import {ReadStream} from 'fs';
+ * @import {WriteStream} from 'fs';
+ * @import {Socket} from 'net';
+ */
+
+/**
+ * @param {ReadStream | WriteStream | Socket} stream
  * @returns {Promise<void>}
  */
 export const fsStreamReady = stream =>
@@ -40,6 +44,53 @@ export const fsStreamReady = stream =>
     stream.on('error', onError);
   });
 
+/**
+ * Wait for a stream event and reject on stream error first.
+ *
+ * @param {ReadStream | WriteStream | Socket} stream
+ * @param {'drain' | 'ready'} eventName
+ * @returns {Promise<void>}
+ */
+const onceWithError = (stream, eventName) =>
+  new Promise((resolve, reject) => {
+    const onEvent = () => {
+      cleanup();
+      resolve();
+    };
+    /** @param {Error} err */
+    const onError = err => {
+      cleanup();
+      reject(err);
+    };
+    const cleanup = () => {
+      stream.off(eventName, onEvent);
+      stream.off('error', onError);
+    };
+    stream.on(eventName, onEvent);
+    stream.on('error', onError);
+  });
+
+/**
+ * @param {WriteStream | Socket} stream
+ * @param {string | Uint8Array} data
+ * @returns {Promise<boolean>} whether caller must await drain
+ */
+const writeChunk = (stream, data) =>
+  new Promise((resolve, reject) => {
+    let waitForDrain;
+    try {
+      waitForDrain = !stream.write(data, err => {
+        if (err) {
+          reject(err);
+          return;
+        }
+        resolve(waitForDrain);
+      });
+    } catch (err) {
+      reject(err);
+    }
+  });
+
 /** @typedef {NonNullable<Awaited<ReturnType<typeof makeFsStreamWriter>>>} FsStreamWriter */
 /** @param {string | undefined | null} filePath */
 export const makeFsStreamWriter = async filePath => {
@@ -56,13 +107,11 @@ export const makeFsStreamWriter = async filePath => {
     return { handle: fh, stream: fh.createWriteStream({ flush: true }) };
   })();
   await fsStreamReady(stream);
-  const writeAsync = promisify(stream.write.bind(stream));
+  const waitForDrainAsync = () => onceWithError(stream, 'drain');
   const closeAsync =
     useStdout || !(/** @type {any} */ (stream).close)
       ? undefined
-      : promisify(
-          /** @type {import('fs').WriteStream} */ (stream).close.bind(stream),
-        );
+      : promisify(/** @type {WriteStream} */ (stream).close.bind(stream));
 
   let flushed = Promise.resolve();
   let closed = false;
@@ -85,11 +134,11 @@ export const makeFsStreamWriter = async filePath => {
   const write = async data => {
     const written = closed
       ? Promise.reject(Error('Stream closed'))
-      : writeAsync(data);
+      : writeChunk(stream, data);
     updateFlushed(written);
     const waitForDrain = await written;
     if (waitForDrain) {
-      await new Promise(resolve => stream.once('drain', resolve));
+      await waitForDrainAsync();
     }
   };
 

package/src/node/read-json.d.ts

@@ -0,0 +1,2 @@
+export function makeReadJsonFile<U = any>({ readFile }: Pick<typeof import("node:fs/promises"), "readFile">, resultReplacer?: (input: ReturnType<typeof JSON.parse>) => U): (path: string) => Promise<U>;
+//# sourceMappingURL=read-json.d.ts.map

package/src/node/read-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-json.d.ts","sourceRoot":"","sources":["read-json.js"],"names":[],"mappings":"AASO,iCAJO,CAAC,sBACJ,IAAI,CAAC,cAAc,kBAAkB,CAAC,EAAE,UAAU,CAAC,mBACnD,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAGlC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAOxC"}

package/src/node/read-json.js

@@ -0,0 +1,18 @@
+/* eslint-env node */
+
+/**
+ * Build a function that reads and parses a JSON file.
+ *
+ * @template [U=ReturnType<typeof JSON.parse>]
+ * @param {Pick<typeof import('node:fs/promises'), 'readFile'>} fsp
+ * @param {(input: ReturnType<typeof JSON.parse>) => U} [resultReplacer]
+ */
+export const makeReadJsonFile = ({ readFile }, resultReplacer) => {
+  /** @type {(path: string) => Promise<U>} */
+  const readJsonFile = async path => {
+    const text = await readFile(path, 'utf8');
+    const result = JSON.parse(text);
+    return resultReplacer ? resultReplacer(result) : /** @type {U} */ (result);
+  };
+  return readJsonFile;
+};

package/src/node/shutdown.js

@@ -1,5 +1,5 @@
 import process from 'node:process';
-import anylogger from 'anylogger';
+import anylogger from '../../vendor/anylogger.js';
 
 const console = anylogger('shutdown');
 

package/src/priority-senders.d.ts

@@ -1,6 +1,6 @@
 /** @type {(namespace: string) => string} */
 export const normalizeSenderNamespace: (namespace: string) => string;
-export function makePrioritySendersManager(sendersNode: ERef<import("./lib-chainStorage.js").StorageNode>): {
+export function makePrioritySendersManager(sendersNode: ERef<StorageNode>): {
     /**
      * @param {string} rawNamespace
      * @param {string} address
@@ -28,5 +28,6 @@ export function makePrioritySendersManager(sendersNode: ERef<import("./lib-chain
     remove: (rawNamespace: string, address: string) => Promise<void>;
 }>;
 export type PrioritySendersManager = ReturnType<typeof makePrioritySendersManager>;
+import type { StorageNode } from './lib-chainStorage.js';
 import type { ERef } from '@endo/far';
 //# sourceMappingURL=priority-senders.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"priority-senders.d.ts","sourceRoot":"","sources":["priority-senders.js"],"names":[],"mappings":"AAQA,4CAA4C;AAC5C,uCADW,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAMtC;AAQK,wDAFI,KAAK,OAAO,uBAAuB,EAAE,WAAW,CAAC;IA0CxD;;;;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;0BA1GnC,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;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"}

package/src/priority-senders.js

@@ -1,8 +1,10 @@
 import { Fail, q } from '@endo/errors';
 import { E, Far } from '@endo/far';
 
-/** @import {ERef} from '@endo/far'; */
-/** @import {StorageNode} from './lib-chainStorage.js'; */
+/**
+ * @import {ERef} from '@endo/far';
+ * @import {StorageNode} from './lib-chainStorage.js';
+ */
 
 const PRIORITY_SENDERS_NAMESPACE_RE = /^[a-zA-Z0-9_-]{1,50}$/;
 
@@ -18,7 +20,7 @@ harden(normalizeSenderNamespace);
 /**
  * XXX lets holder manage sender list for all namespaces
  *
- * @param {ERef<import('./lib-chainStorage.js').StorageNode>} sendersNode
+ * @param {ERef<StorageNode>} sendersNode
  */
 export const makePrioritySendersManager = sendersNode => {
   /**
@@ -35,7 +37,7 @@ export const makePrioritySendersManager = sendersNode => {
   /**
    * Write a list of namespaces into a storage node.
    *
-   * @param {import('./lib-chainStorage.js').StorageNode} node
+   * @param {StorageNode} node
    * @param {Set<string>} namespaces
    */
   const refreshVstorage = (node, namespaces) => {

package/src/queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["queue.js"],"names":[],"mappings":"AAQO,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,kCA2BqB,OAFf,CAEoB,MAKH,GAAG,MAHlB,UAAU,CAAC,CAAC,CAGU,KAFpB,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAkB/C"}

package/src/queue.js

@@ -1,5 +1,3 @@
-// @jessie-check
-
 import { makePromiseKit } from '@endo/promise-kit';
 
 /**

package/src/ses-utils.d.ts

@@ -18,9 +18,11 @@ export function makeLimitedConsole(makeLogger: (level: string) => (...args: unkn
  * @template T
  * @typedef {T extends PromiseLike<any>
  *     ? Awaited<T>
- *     : T extends {}
- *       ? Simplify<DeeplyAwaitedObject<T>>
- *       : Awaited<T>} DeeplyAwaited
+ *     : T extends RemotableBrand<any, any> | RemotableObject
+ *       ? T
+ *       : T extends {}
+ *         ? Simplify<DeeplyAwaitedObject<T>>
+ *         : Awaited<T>} DeeplyAwaited
  */
 /**
  * A more constrained version of {deeplyFulfilled} for type safety until
@@ -30,10 +32,27 @@ export function makeLimitedConsole(makeLogger: (level: string) => (...args: unkn
  * @type {<T extends {}>(unfulfilledTerms: T) => Promise<DeeplyAwaited<T>>}
  */
 export const deeplyFulfilledObject: <T extends {}>(unfulfilledTerms: T) => Promise<DeeplyAwaited<T>>;
+export function stripPrefix(prefix: string, str: string): string;
+export function throwErrorCode<Code extends string>(details: Parameters<typeof makeError>[0], code: Code, opts?: Parameters<typeof makeError>[2] & {
+    constructor?: Parameters<typeof makeError>[1];
+}): never;
+export function tryNow<F extends (...args: any[]) => any, U = ReturnType<F>>(fn: F, transformError: (err: Error) => U, ...args: Parameters<F>): ReturnType<F> | U;
+export function tryJsonParse(jsonText: string, onError: string | ((err: Error) => unknown)): any;
 export function PromiseAllOrErrors<T>(items: readonly (T | PromiseLike<T>)[]): Promise<T[]>;
 export function aggregateTryFinally<T>(trier: () => Promise<T>, finalizer: (error?: unknown) => Promise<unknown>): ReturnType<() => Promise<T>>;
 export function withDeferredCleanup<T>(fn: (addCleanup: (fn: (err?: unknown) => Promise<void>) => void) => Promise<T>): ReturnType<(addCleanup: (fn: (err?: unknown) => Promise<void>) => void) => Promise<T>>;
-export function assertAllDefined<T extends Record<string, unknown>>(obj: T): asserts obj is AllDefined<T>;
+/**
+ * @template {Record<string, unknown>} T
+ * @typedef {{ [P in keyof T]: Exclude<T[P], undefined> }} AllDefined
+ */
+/**
+ * Concise way to check values are available from object literal shorthand.
+ * Throws error message to specify the missing values.
+ *
+ * @type {<T extends Record<string, unknown>>(obj: T) => asserts obj is AllDefined<T>}
+ * @throws if any value in the object entries is not defined
+ */
+export const assertAllDefined: <T extends Record<string, unknown>>(obj: T) => asserts obj is AllDefined<T>;
 export function attenuate<T, P extends Permit<T>>(specimen: T, permit: P, transform?: <U, SubP extends Permit<U>>(attenuation: U, permit: SubP) => U): Attenuated<T, P>;
 export const forever: AsyncIterable<undefined>;
 export function whileTrue<T>(produce: () => T): AsyncIterable<Awaited<T>>;
@@ -55,14 +74,17 @@ export function synchronizedTee<T = unknown>(sourceStream: AsyncIterator<T, void
 export type Simplify<T> = { [KeyType in keyof T]: T[KeyType]; } & {};
 export type Callable = (...args: any[]) => any;
 export type DeeplyAwaitedObject<T extends {}> = { [K in keyof T]: T[K] extends Callable ? T[K] : DeeplyAwaited<T[K]>; };
-export type DeeplyAwaited<T> = T extends PromiseLike<any> ? Awaited<T> : T extends {} ? Simplify<DeeplyAwaitedObject<T>> : Awaited<T>;
+export type DeeplyAwaited<T> = T extends PromiseLike<any> ? Awaited<T> : T extends RemotableBrand<any, any> | RemotableObject ? T : T extends {} ? Simplify<DeeplyAwaitedObject<T>> : Awaited<T>;
 export type AllDefined<T extends Record<string, unknown>> = { [P in keyof T]: Exclude<T[P], undefined>; };
 import { objectMap } from '@endo/common/object-map.js';
 import { objectMetaMap } from '@endo/common/object-meta-map.js';
 import { fromUniqueEntries } from '@endo/common/from-unique-entries.js';
 import type { LimitedConsole } from './js-utils.js';
+import { makeError } from '@endo/errors';
 import type { Permit } from './types.js';
 import type { Attenuated } from './types.js';
 import type { ERef } from '@endo/far';
+import type { RemotableBrand } from '@endo/eventual-send';
+import type { RemotableObject } from '@endo/pass-style';
 export { objectMap, objectMetaMap, fromUniqueEntries };
 //# sourceMappingURL=ses-utils.d.ts.map

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

@@ -1,5 +1,4 @@
 // @ts-check
-// @jessie-check
 /**
  * @file Utility functions that are dependent upon a hardened environment,
  *   either directly or indirectly (e.g. by @endo imports).
@@ -8,7 +7,7 @@
 import { objectMap } from '@endo/common/object-map.js';
 import { objectMetaMap } from '@endo/common/object-meta-map.js';
 import { fromUniqueEntries } from '@endo/common/from-unique-entries.js';
-import { q, Fail, makeError, annotateError, X } from '@endo/errors';
+import { q, b, Fail, makeError, annotateError, X } from '@endo/errors';
 import { deeplyFulfilled, isPrimitive } from '@endo/pass-style';
 import { makePromiseKit } from '@endo/promise-kit';
 import { makeQueue } from '@endo/stream';
@@ -17,10 +16,15 @@ import { makeQueue } from '@endo/stream';
 import { asyncGenerate } from 'jessie.js';
 import { logLevels } from './js-utils.js';
 
-/** @import {LimitedConsole} from './js-utils.js'; */
+/**
+ * @import {LimitedConsole} from './js-utils.js';
+ * @import {AsyncQueue} from '@endo/stream';
+ * @import {PromiseKit} from '@endo/promise-kit';
+ */
 
 /** @import {ERef} from '@endo/far'; */
-/** @import {Primitive} from '@endo/pass-style'; */
+/** @import {RemotableBrand} from '@endo/eventual-send'; */
+/** @import {Primitive, RemotableObject} from '@endo/pass-style'; */
 /** @import {Permit, Attenuated} from './types.js'; */
 
 export { objectMap, objectMetaMap, fromUniqueEntries };
@@ -58,9 +62,11 @@ harden(makeLimitedConsole);
  * @template T
  * @typedef {T extends PromiseLike<any>
  *     ? Awaited<T>
- *     : T extends {}
- *       ? Simplify<DeeplyAwaitedObject<T>>
- *       : Awaited<T>} DeeplyAwaited
+ *     : T extends RemotableBrand<any, any> | RemotableObject
+ *       ? T
+ *       : T extends {}
+ *         ? Simplify<DeeplyAwaitedObject<T>>
+ *         : Awaited<T>} DeeplyAwaited
  */
 
 /**
@@ -90,6 +96,101 @@ const makeAggregateError =
         });
       };
 
+/**
+ * Assert that a string has a prefix, and return the part that follows it.
+ *
+ * @param {string} prefix
+ * @param {string} str
+ * @returns {string}
+ */
+export const stripPrefix = (prefix, str) => {
+  str.startsWith(prefix) || Fail`${str} is missing prefix ${q(prefix)}`;
+  return str.slice(prefix.length);
+};
+
+/**
+ * Throw an error with an own "code" data property, supporting identification
+ * without parsing `message`. Note that such errors are not Passable and thus
+ * cannot appear inside a Passable structure, and even at top level the "code"
+ * property will be silently dropped by marshalling.
+ *
+ * @template {string} Code
+ * @param {Parameters<typeof makeError>[0]} details
+ * @param {Code} code
+ * @param {Parameters<typeof makeError>[2] & {
+ *   constructor?: Parameters<typeof makeError>[1];
+ * }} [opts]
+ */
+export const throwErrorCode = (details, code, opts) => {
+  const err = makeError(details, opts?.constructor, {
+    ...opts,
+    sanitize: false,
+  });
+  Object.defineProperty(err, 'code', { value: code, enumerable: true });
+  harden(err);
+  throw err;
+};
+
+/**
+ * Synchronusly invoke a function with the opportunity to handle any error
+ * similarly to a Promise `catch` callback (e.g., substituting a non-error
+ * returned value or throwing a possibly-new error). This is useful for (among
+ * other things) replacing generic error messages with specific ones (as in
+ * {@link tryJsonParse}).
+ *
+ * @template {(...args: any[]) => any} F
+ * @template [U=ReturnType<F>]
+ * @param {F} fn to invoke
+ * @param {(err: Error) => U} transformError callback to receive any error from
+ *   invoking `fn` and either return a substitute value or throw a potentially
+ *   new error
+ * @param {Parameters<F>} args for `fn`
+ * @returns {ReturnType<F> | U}
+ */
+export const tryNow = (fn, transformError, ...args) => {
+  try {
+    return fn(...args);
+  } catch (err) {
+    try {
+      return transformError(err);
+    } catch (newErr) {
+      // Try to associate `err` with `newErr`.
+      if (!newErr.cause) {
+        const desc = {
+          value: err,
+          configurable: true,
+          enumerable: false,
+          writable: true,
+        };
+        if (!Reflect.defineProperty(newErr, 'cause', desc)) {
+          assert.note(newErr, err.message);
+        }
+      }
+      throw newErr;
+    }
+  }
+};
+
+/**
+ * Parse JSON text, or handle an error by e.g. substituting a default value or
+ * replacing it with one bearing a non-generic message.
+ *
+ * @param {string} jsonText
+ * @param {string | ((err: Error) => unknown)} onError an error message or
+ *   callback
+ */
+export const tryJsonParse = (jsonText, onError) => {
+  const transformError =
+    typeof onError === 'function'
+      ? onError
+      : 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)}`;
+    return JSON.parse(jsonText);
+  }, transformError);
+};
+
 /**
  * @template T
  * @param {readonly (T | PromiseLike<T>)[]} items
@@ -167,9 +268,7 @@ export const withDeferredCleanup = async fn => {
  * Concise way to check values are available from object literal shorthand.
  * Throws error message to specify the missing values.
  *
- * @template {Record<string, unknown>} T
- * @param {T} obj
- * @returns {asserts obj is AllDefined<T>}
+ * @type {<T extends Record<string, unknown>>(obj: T) => asserts obj is AllDefined<T>}
  * @throws if any value in the object entries is not defined
  */
 export const assertAllDefined = obj => {
@@ -320,7 +419,7 @@ export const synchronizedTee = (sourceStream, readerCount) => {
    *   (value: PromiseLike<IteratorResult<T>>) => void
    * >} QueuePayload
    */
-  /** @type {import('@endo/stream').AsyncQueue<QueuePayload>[]} */
+  /** @type {AsyncQueue<QueuePayload>[]} */
   const queues = [];
 
   /** @returns {Promise<void>} */
@@ -374,7 +473,7 @@ export const synchronizedTee = (sourceStream, readerCount) => {
   };
 
   const readers = Array.from({ length: readerCount }).map(() => {
-    /** @type {import('@endo/stream').AsyncQueue<QueuePayload>} */
+    /** @type {AsyncQueue<QueuePayload>} */
     const queue = makeQueue();
     queues.push(queue);
 
@@ -382,9 +481,7 @@ export const synchronizedTee = (sourceStream, readerCount) => {
     const reader = harden({
       async next() {
         /**
-         * @type {import('@endo/promise-kit').PromiseKit<
-         *   IteratorResult<T>
-         * >}
+         * @type {PromiseKit<IteratorResult<T>>}
          */
         const { promise, resolve } = makePromiseKit();
         queue.put({ value: resolve, done: false });
@@ -392,9 +489,7 @@ export const synchronizedTee = (sourceStream, readerCount) => {
       },
       async return() {
         /**
-         * @type {import('@endo/promise-kit').PromiseKit<
-         *   IteratorResult<T>
-         * >}
+         * @type {PromiseKit<IteratorResult<T>>}
          */
         const { promise, resolve } = makePromiseKit();
         queue.put({ value: resolve, done: true });
@@ -405,11 +500,11 @@ export const synchronizedTee = (sourceStream, readerCount) => {
         queue.put(rejection);
         return rejection;
       },
-      // eslint-disable-next-line no-restricted-globals
+
       [Symbol.asyncIterator]() {
         return reader;
       },
-      // eslint-disable-next-line no-restricted-globals
+
       async [Symbol.asyncDispose]() {
         await reader.return();
       },