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

package/src/callback.js

@@ -4,7 +4,14 @@ import { E } from '@endo/far';
 import { isPrimitive, isPassableSymbol } from '@endo/pass-style';
 import { getInterfaceMethodKeys } from '@endo/patterns';
 
-/** @import {ERef} from '@endo/far' */
+/**
+ * @import {ERef} from '@endo/far'
+ * @import {Methods} from '@endo/exo';
+ * @import {Farable} from '@endo/exo';
+ * @import {Zone} from '@agoric/base-zone';
+ * @import {InterfaceGuard} from '@endo/patterns';
+ * @import {MethodGuard} from '@endo/patterns';
+ */
 /** @import {Callback, SyncCallback} from './types.js' */
 
 const { fromEntries } = Object;
@@ -16,10 +23,10 @@ const ownKeys =
   );
 
 /**
- * @template {import('@endo/exo').Methods} T
+ * @template {Methods} T
  * @typedef {(
- *   ...args: Parameters<ReturnType<prepareAttenuator>>
- * ) => import('@endo/exo').Farable<T>} MakeAttenuator
+ *   ...args: Parameters<ReturnType<typeof prepareAttenuator>>
+ * ) => Farable<T>} MakeAttenuator
  */
 
 /**
@@ -185,12 +192,11 @@ harden(isCallback);
  * Prepare an attenuator class whose methods can be redirected via callbacks.
  *
  * @template {PropertyKey} M
- * @param {import('@agoric/base-zone').Zone} zone The zone in which to allocate
- *   attenuators.
+ * @param {Zone} zone The zone in which to allocate attenuators.
  * @param {M[]} methodNames Methods to forward.
  * @param {object} opts
- * @param {import('@endo/patterns').InterfaceGuard<{
- *   [K in M]: import('@endo/patterns').MethodGuard;
+ * @param {InterfaceGuard<{
+ *   [K in M]: MethodGuard;
  * }>} [opts.interfaceGuard]
  *   An interface guard for the new attenuator.
  * @param {string} [opts.tag] A tag for the new attenuator exoClass.
@@ -299,8 +305,8 @@ harden(prepareAttenuator);
 /**
  * Prepare an attenuator whose methodNames are derived from the interfaceGuard.
  *
- * @template {import('@endo/patterns').InterfaceGuard} G
- * @param {import('@agoric/base-zone').Zone} zone
+ * @template {InterfaceGuard} G
+ * @param {Zone} zone
  * @param {G} interfaceGuard
  * @param {object} [opts]
  * @param {string} [opts.tag]

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;;;;GAIG;AACH,2BAA4B,aAAa,CAAC;AAC1C,kCAAmC,mBAAmB,CAAC;AACvD,oCAAqC,qBAAqB,CAAC;AAC3D,yBAA0B,YAAY,CAAC;AACvC,qBAAsB,QAAQ,CAAC;AAC/B,sBAAuB,SAAS,CAAC;AACjC,sBAAuB,SAAS,CAAC;AACjC,qBAAsB,WAAW,CAAC;AAClC,0BAA2B,YAAY,CAAC"}
+{"version":3,"file":"chain-storage-paths.d.ts","sourceRoot":"","sources":["chain-storage-paths.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,2BAA4B,aAAa,CAAC;AAC1C,kCAAmC,mBAAmB,CAAC;AACvD,oCAAqC,qBAAqB,CAAC;AAC3D,yBAA0B,YAAY,CAAC;AACvC,qBAAsB,QAAQ,CAAC;AAC/B,sBAAuB,SAAS,CAAC;AACjC,sBAAuB,SAAS,CAAC;AACjC,qBAAsB,WAAW,CAAC;AAClC,0BAA2B,YAAY,CAAC"}

package/src/chain-storage-paths.js

@@ -1,5 +1,3 @@
-// @jessie-check
-
 /**
  * These identify top-level paths for SwingSet chain storage (and serve as
  * prefixes). To avoid collisions, they should remain synchronized with

package/src/chain-utils.d.ts

@@ -6,7 +6,7 @@ export type BlockInfo = {
      * POSIX Seconds Since the Epoch
      */
     blockTime: number;
-    params: import("@agoric/cosmic-proto/swingset/swingset.js").ParamsSDKType;
+    params: JsonSafe<ParamsSDKType>;
 };
 /**
  * cosmosInitAction fields that are subject to consensus. See cosmosInitAction
@@ -21,5 +21,7 @@ export type InitMsg = BlockInfo & {
         amount: NatString;
     }[];
 };
+import type { ParamsSDKType } from '@agoric/cosmic-proto/swingset/swingset.js';
+import type { JsonSafe } from '@agoric/cosmic-proto/json-safe';
 import * as _ActionType from './action-types.js';
 //# sourceMappingURL=chain-utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"chain-utils.d.ts","sourceRoot":"","sources":["chain-utils.js"],"names":[],"mappings":"AAsCO,wCAHI,GAAG,GACD,OAAO,CAoBnB;wBA1Ca,GAAG,MAAM,EAAE;;iBAIX,MAAM;;;;eACN,MAAM;YACN,OAAO,2CAA2C,EAAE,aAAa;;;;;;sBAIlE,SAAS,GAAG;IACpB,IAAI,EAAE,OAAO,WAAW,CAAC,cAAc,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,CAAA;KAAE,EAAE,CAAC;CACrD;6BAjByB,mBAAmB"}
+{"version":3,"file":"chain-utils.d.ts","sourceRoot":"","sources":["chain-utils.js"],"names":[],"mappings":"AA2CO,wCAHI,GAAG,GACD,OAAO,CAoBnB;wBA/Ca,GAAG,MAAM,EAAE;;iBASX,MAAM;;;;eACN,MAAM;YACN,SAAS,aAAa,CAAC;;;;;;sBAIxB,SAAS,GAAG;IACpB,IAAI,EAAE,OAAO,WAAW,CAAC,cAAc,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,CAAA;KAAE,EAAE,CAAC;CACrD;mCAjB4B,2CAA2C;8BAChD,gCAAgC;6BAN9B,mBAAmB"}

package/src/chain-utils.js

@@ -14,11 +14,16 @@ import * as _ActionType from './action-types.js';
 
 /** @typedef {`${bigint}`} NatString */
 
+/**
+ * @import {ParamsSDKType} from '@agoric/cosmic-proto/swingset/swingset.js'
+ * @import {JsonSafe} from '@agoric/cosmic-proto/json-safe'
+ */
+
 /**
  * @typedef {object} BlockInfo
  * @property {number} blockHeight
  * @property {number} blockTime POSIX Seconds Since the Epoch
- * @property {import('@agoric/cosmic-proto/swingset/swingset.js').ParamsSDKType} params
+ * @property {JsonSafe<ParamsSDKType>} params
  */
 
 /**

package/src/config.d.ts

@@ -17,9 +17,9 @@ export namespace CosmosInitKeyToBridgeId {
     let vbankPort: "bank";
     let vibcPort: "dibc";
 }
-export namespace WalletName {
-    let depositFacet: "depositFacet";
-}
+export const WalletName: import("./keyMirror.js").KeyMirrorResult<{
+    depositFacet: null;
+}>;
 export namespace VBankAccount {
     namespace reserve {
         let module: "vbank/reserve";
@@ -32,4 +32,23 @@ export namespace VBankAccount {
         export { address_1 as address };
     }
 }
+/**
+ * ClusterName specifies a collection of networks. The specific networks
+ * associated with a particular name may vary from context to context, and may
+ * also overlap (e.g. a "local" cluster may connect to the same remote networks
+ * as a "testnet" cluster), but this type nevertheless supports cross-package
+ * coordination where the values associated with static labels are subject to
+ * choice of cluster. Some examples:
+ *
+ * - the chain ID for a static label like "Agoric" or "Ethereum"
+ * - the cryptographic hash for a static label like "BLD" or "USDC"
+ * - the URL for a service like "Agoric RPC" or "Axelar" or "Spectrum"
+ *
+ * "mainnet" should always include the Agoric network described by
+ * https://main.agoric.net/network-config rather than some other alternative.
+ *
+ * XXX This actually belongs somewhere else, possibly with refactoring.
+ * https://github.com/Agoric/agoric-sdk/pull/12185#discussion_r2500123226
+ */
+export type ClusterName = "local" | "testnet" | "mainnet";
 //# 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":";;;uBAkBU,CAAC,OAAO,QAAQ,EAAE,MAAM,OAAO,QAAQ,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["config.js"],"names":[],"mappings":";;;uBAwCU,CAAC,OAAO,QAAQ,EAAE,MAAM,OAAO,QAAQ,CAAC;;;;;;;;;;;;;;;;AAsBlD;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BA9BU,OAAO,GAAG,SAAS,GAAG,SAAS"}

package/src/config.js

@@ -1,5 +1,6 @@
 // @ts-check
-// @jessie-check
+
+import { keyMirror } from './keyMirror.js';
 
 /**
  * @file
@@ -13,6 +14,27 @@
  *   package are placed here.
  */
 
+/**
+ * ClusterName specifies a collection of networks. The specific networks
+ * associated with a particular name may vary from context to context, and may
+ * also overlap (e.g. a "local" cluster may connect to the same remote networks
+ * as a "testnet" cluster), but this type nevertheless supports cross-package
+ * coordination where the values associated with static labels are subject to
+ * choice of cluster. Some examples:
+ *
+ * - the chain ID for a static label like "Agoric" or "Ethereum"
+ * - the cryptographic hash for a static label like "BLD" or "USDC"
+ * - the URL for a service like "Agoric RPC" or "Axelar" or "Spectrum"
+ *
+ * "mainnet" should always include the Agoric network described by
+ * https://main.agoric.net/network-config rather than some other alternative.
+ *
+ * XXX This actually belongs somewhere else, possibly with refactoring.
+ * https://github.com/Agoric/agoric-sdk/pull/12185#discussion_r2500123226
+ *
+ * @typedef {'local' | 'testnet' | 'mainnet'} ClusterName
+ */
+
 /**
  * Event source ids used by the bridge device.
  *
@@ -38,8 +60,8 @@ export const CosmosInitKeyToBridgeId = {
 };
 harden(CosmosInitKeyToBridgeId);
 
-export const WalletName = /** @type {const} */ ({
-  depositFacet: 'depositFacet',
+export const WalletName = keyMirror({
+  depositFacet: null,
 });
 harden(WalletName);
 

package/src/debug.d.ts

@@ -1,2 +1,5 @@
-export function makeTracer(name: string, enable?: boolean | "verbose"): (..._args: any[]) => void;
+export function makeTracer(label: string, enable?: boolean | "verbose"): ((..._args: any[]) => void) & {
+    sub: (subLabel: any, subEnable?: boolean | "verbose") => ((..._args: any[]) => 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,iCAHI,MAAM,WACN,OAAO,GAAG,SAAS,6BAiC7B"}
+{"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"}

package/src/debug.js

@@ -1,41 +1,52 @@
-// @jessie-check
-
+// See https://github.com/Agoric/agoric-sdk/issues/11844
+// See https://github.com/Agoric/agoric-sdk/issues/11845
 let debugInstance = 1;
 
 /**
- * @param {string} name
+ * @param {string} label
  * @param {boolean | 'verbose'} enable
  */
-export const makeTracer = (name, enable = true) => {
+export const makeTracer = (label, enable = true) => {
+  const sub = (subLabel, subEnable = enable) =>
+    makeTracer(`${label}.${subLabel}`, subEnable);
+  const key = `----- ${label},${debugInstance} `;
   debugInstance += 1;
-  let debugCount = 1;
-  const key = `----- ${name}.${debugInstance} `;
   // the cases below define a named variable to provide better debug info
   switch (enable) {
     case false: {
       const logDisabled = (..._args) => {};
-      return logDisabled;
+      return harden(Object.assign(logDisabled, { sub }));
     }
     case 'verbose': {
       const infoTick = (optLog, ...args) => {
-        if (optLog.log) {
-          console.info(key, (debugCount += 1), ...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') {
+          console.info(key, ...args);
         } else {
-          console.info(key, (debugCount += 1), optLog, ...args);
+          console.info(key, optLog, ...args);
         }
       };
-      return infoTick;
+      return harden(Object.assign(infoTick, { sub }));
     }
     default: {
       const debugTick = (optLog, ...args) => {
-        if (optLog.log) {
-          optLog.log(key, (debugCount += 1), ...args);
+        // Another unreliable sniff test like the one above
+        if (typeof optLog?.log === 'function') {
+          optLog.log(key, ...args);
         } else {
-          console.info(key, (debugCount += 1), optLog, ...args);
+          console.info(key, optLog, ...args);
         }
       };
-      return debugTick;
+      return harden(Object.assign(debugTick, { sub }));
     }
   }
 };
 harden(makeTracer);
+
+/**
+ * @typedef {ReturnType<typeof makeTracer>} TraceLogger
+ */

package/src/index.d.ts

@@ -3,6 +3,7 @@ export * from "./config.js";
 export * from "./debug.js";
 export * from "./errors.js";
 export * from "./js-utils.js";
+export * from "./keyMirror.js";
 export * from "./method-tools.js";
 export * from "./metrics.js";
 export * from "./natural-sort.js";
@@ -11,5 +12,5 @@ export * from "./tmpDir.js";
 export * from "./typeCheck.js";
 export * from "./typeGuards.js";
 export * from "./types-index.js";
-export { pureDataMarshaller } from "./marshal.js";
+export { pureDataMarshaller } from "./marshal/pure-data.js";
 //# sourceMappingURL=index.d.ts.map

package/src/index.js

@@ -1,13 +1,20 @@
-// @jessie-check
-
 /// <reference types="ses" />
 
+// NOTE: Because @endo/bundle-source does not do tree-shaking (at least as of
+// September 2025), bundles for sources that import from '@agoric/internal' will
+// include each of these files even if none of their own exports are used.
+// To keep the size of bundles down, deep imports from @agoric/internal are
+// preferred.
+// HOWEVER, there are still occasional imports of '@agoric/internal', so be
+// judicious about what to include here!
+
 export * from './cli-utils.js';
 export * from './config.js';
 export * from './debug.js';
 export * from './errors.js';
 export * from './js-utils.js';
-export { pureDataMarshaller } from './marshal.js';
+export * from './keyMirror.js';
+export { pureDataMarshaller } from './marshal/pure-data.js';
 export * from './method-tools.js';
 export * from './metrics.js';
 export * from './natural-sort.js';

package/src/js-utils.d.ts

@@ -3,7 +3,10 @@ export const TRUE: true;
 /**
  * @typedef {<O extends Record<string, unknown>>(
  *   obj: O,
- * ) => { [K in keyof O]: K extends string ? [K, O[K]] : never }[keyof O][]} TypedEntries
+ * ) => Exclude<
+ *   { [K in keyof O]: K extends string ? [K, O[K]] : never }[keyof O],
+ *   undefined
+ * >[]} TypedEntries
  */
 export const typedEntries: TypedEntries;
 /**
@@ -26,13 +29,14 @@ export function deepCopyJsonable<T>(value: T): T;
 export function deepMapObject<O extends Record<string, unknown>, M>(obj: O, mapper: <T extends Record<string, unknown>, K extends string & keyof T>(value: T[K], name: K, record: T) => T[K] | M): O | { [K_1 in keyof O]: K_1 extends string ? O[K_1] | M : never; };
 export function defineName<F extends Function>(name: string, fn: F): F;
 export function objectMapMutable<O extends Record<string, unknown>, M>(obj: O, mapper: <K extends keyof O>(value: O[K], key: K) => M): { [K in keyof O]: K extends string ? M : never; };
-export function provideLazyMap<K, V>(map: K extends WeakKey ? WeakMap<K, V> : Map<K, V>, key: K, makeValue: (key: K) => V): V;
+export function partialMap<T, U>(arr: T[], mapOrDrop: (value: T, index: number, arr: T[]) => U | undefined | false): U[];
+export function provideLazyMap<K, V>(map: [K] extends [WeakKey] ? WeakMap<K, V> : Map<K, V>, key: K, makeValue: (key: K) => V): V;
 export function makeMeasureSeconds(currentTimeMillisec: () => number): <T>(fn: () => Promise<T>) => Promise<{
     result: T;
     duration: number;
 }>;
 export function unprefixedProperties<P extends string, K extends string, V>(obj: Record<`${P}${K}`, V>, prefix: P): Record<K, V>;
-export type TypedEntries = <O extends Record<string, unknown>>(obj: O) => { [K in keyof O]: K extends string ? [K, O[K]] : never; }[keyof O][];
+export type TypedEntries = <O extends Record<string, unknown>>(obj: O) => Exclude<{ [K in keyof O]: K extends string ? [K, O[K]] : never; }[keyof O], undefined>[];
 export type FromTypedEntries = <const Entries extends ReadonlyArray<readonly [PropertyKey, unknown]>>(entries: Entries) => { [Entry in Entries[number] as Entry[0]]: Entry[1]; };
 export type TypedMap = <A extends unknown[], V>(arr: A, mapper: <K extends number>(el: A[K], idx: K, arr: A) => V) => V[];
 export type LogLevel = (typeof logLevels)[keyof readonly ["debug", "log", "info", "warn", "error"] & number];

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

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

package/src/js-utils.js

@@ -1,5 +1,4 @@
 // @ts-check
-// @jessie-check
 /**
  * @file Pure JavaScript utility functions that are compatible with but not
  *   dependent upon a hardened environment.
@@ -13,7 +12,10 @@ export const TRUE = /** @type {const} */ (true);
 /**
  * @typedef {<O extends Record<string, unknown>>(
  *   obj: O,
- * ) => { [K in keyof O]: K extends string ? [K, O[K]] : never }[keyof O][]} TypedEntries
+ * ) => Exclude<
+ *   { [K in keyof O]: K extends string ? [K, O[K]] : never }[keyof O],
+ *   undefined
+ * >[]} TypedEntries
  */
 export const typedEntries = /** @type {TypedEntries} */ (Object.entries);
 
@@ -172,6 +174,25 @@ export const objectMapMutable = (obj, mapper) => {
   return /** @type {any} */ (newObj);
 };
 
+/**
+ * Map the elements of an array to new values, skipping elements for which the
+ * mapping results in either `undefined` or `false`.
+ *
+ * @template T
+ * @template U
+ * @param {T[]} arr
+ * @param {(value: T, index: number, arr: T[]) => U | undefined | false} mapOrDrop
+ * @returns {U[]}
+ */
+export const partialMap = (arr, mapOrDrop) =>
+  arr.reduce((results, el, i, arrArg) => {
+    const result = mapOrDrop(el, i, arrArg);
+    if (result !== undefined && result !== false) {
+      results.push(result);
+    }
+    return results;
+  }, /** @type {U[]} */ ([]));
+
 /**
  * Return the value from `map` associated with `key`. If there is not yet such a
  * value, get one from `makeValue(key)` and update `map` before returning the
@@ -179,7 +200,7 @@ export const objectMapMutable = (obj, mapper) => {
  *
  * @template K
  * @template V
- * @param {K extends WeakKey ? WeakMap<K, V> : Map<K, V>} map
+ * @param {[K] extends [WeakKey] ? WeakMap<K, V> : Map<K, V>} map
  * @param {K} key
  * @param {(key: K) => V} makeValue
  * @returns {V}

package/src/keyMirror.d.ts

@@ -0,0 +1,3 @@
+export function keyMirror<Init extends Record<string, string | null> & Record<Exclude<PropertyKey, string>, never>>(record: Init & { readonly [K in keyof Init]: Init[K] extends null ? null : K; }): KeyMirrorResult<Init>;
+export type KeyMirrorResult<Init extends Record<string, string | null> & Record<Exclude<PropertyKey, string>, never>> = { readonly [K in keyof Init]: K; };
+//# sourceMappingURL=keyMirror.d.ts.map

package/src/keyMirror.d.ts.map

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

@@ -0,0 +1,45 @@
+// @ts-check
+
+const { freeze, entries } = Object;
+
+/**
+ * @template {Record<string, string | null> & Record<Exclude<PropertyKey, string>, never>} Init
+ * @typedef {{ readonly [K in keyof Init]: K }} KeyMirrorResult
+ */
+
+/**
+ * Mirror the keys of an object to string values that match the key names. This
+ * works well to define a TypeScript enum type compatible with erasable syntax:
+ *
+ *    `@enum {(typeof MyEnum)[keyof typeof MyEnum]}`
+ *
+ * The provided record must only map property names to either `null` or the
+ * property name itself. The returned object has identical keys whose values are
+ * the string form of the key.
+ *
+ * @template {Record<string, string | null> & Record<Exclude<PropertyKey, string>, never>} Init
+ * @param {Init & { readonly [K in keyof Init]: Init[K] extends null ? null : K }} record
+ * @returns {KeyMirrorResult<Init>}
+ */
+export const keyMirror = record => {
+  if (record === null || typeof record !== 'object') {
+    throw TypeError('keyMirror expects a record of string keys.');
+  }
+
+  /** @type {Record<string, string>} */
+  const mirrored = {
+    // @ts-expect-error Record confused by null prototype
+    __proto__: null,
+  };
+  for (const [key, value] of entries(record)) {
+    if (value !== null && value !== key) {
+      throw TypeError(
+        `Value for key "${key}" must be null or the key string; got ${String(value)}.`,
+      );
+    }
+    mirrored[key] = key;
+  }
+  return /** @type {KeyMirrorResult<Init>} */ (freeze(mirrored));
+};
+
+freeze(keyMirror);

package/src/kv-store.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @import {Database} from 'better-sqlite3';
+ */
+/**
+ * @template [T=string]
+ * @typedef {{
+ *   has: (key: string) => boolean;
+ *   get: (key: string) => T | undefined;
+ *   getNextKey: (previousKey: string) => string | undefined;
+ *   set: (key: string, value: T) => void;
+ *   delete: (key: string) => void;
+ * }} KVStore
+ */
+/**
+ * @param {Database} db The SQLite database connection.
+ * @param {() => void} beforeMutation Called before mutating methods to
+ *   establish a DB transaction if needed
+ * @param {(...args: string[]) => void} trace Called after set/delete to record
+ *   a debug log
+ * @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 makeKVStoreFromMap<T = unknown>(map: Map<string, T>): KVStore<T>;
+export type KVStore<T = string> = {
+    has: (key: string) => boolean;
+    get: (key: string) => T | undefined;
+    getNextKey: (previousKey: string) => string | undefined;
+    set: (key: string, value: T) => void;
+    delete: (key: string) => void;
+};
+import type { Database } from 'better-sqlite3';
+//# sourceMappingURL=kv-store.d.ts.map

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

@@ -0,0 +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"}