@agoric/cache 0.3.3-other-dev-fbe72e7.0.fbe72e7 → 0.3.3-other-dev-d15096d.0.d15096d

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/cache",
-  "version": "0.3.3-other-dev-fbe72e7.0.fbe72e7",
+  "version": "0.3.3-other-dev-d15096d.0.d15096d",
   "description": "Agoric's simple cache interface",
   "type": "module",
   "main": "src/main.js",
@@ -19,15 +19,15 @@
   "author": "Agoric",
   "license": "Apache-2.0",
   "dependencies": {
-    "@agoric/internal": "0.3.3-other-dev-fbe72e7.0.fbe72e7",
-    "@agoric/notifier": "0.6.3-other-dev-fbe72e7.0.fbe72e7",
-    "@agoric/store": "0.9.3-other-dev-fbe72e7.0.fbe72e7",
-    "@agoric/vat-data": "0.5.3-other-dev-fbe72e7.0.fbe72e7",
+    "@agoric/internal": "0.3.3-other-dev-d15096d.0.d15096d",
+    "@agoric/notifier": "0.6.3-other-dev-d15096d.0.d15096d",
+    "@agoric/store": "0.9.3-other-dev-d15096d.0.d15096d",
+    "@agoric/vat-data": "0.5.3-other-dev-d15096d.0.d15096d",
     "@endo/far": "^1.1.14",
     "@endo/marshal": "^1.8.0"
   },
   "devDependencies": {
-    "@agoric/zoe": "0.26.3-other-dev-fbe72e7.0.fbe72e7",
+    "@agoric/zoe": "0.26.3-other-dev-d15096d.0.d15096d",
     "ava": "^5.3.0",
     "c8": "^10.1.3"
   },
@@ -49,5 +49,5 @@
   "typeCoverage": {
     "atLeast": 94.13
   },
-  "gitHead": "fbe72e72107f9997f788674e668c660d92ec4492"
+  "gitHead": "d15096dc4ff8b96e9b6cd11954c20d3a9efbb393"
 }

package/src/cache.js

@@ -7,6 +7,7 @@ import { makeScalarStoreCoordinator } from './store.js';
 /**
  * @import {Passable, RemotableObject} from '@endo/pass-style';
  * @import {Key, Pattern} from '@endo/patterns';
+ * @import {Coordinator} from './types.js';
  */
 
 /**
@@ -17,7 +18,7 @@ import { makeScalarStoreCoordinator } from './store.js';
  */
 
 /**
- * @param {ERef<import('./types.js').Coordinator>} [coordinator]
+ * @param {ERef<Coordinator>} [coordinator]
  */
 export const makeCache = (coordinator = makeScalarStoreCoordinator()) => {
   /**

package/src/main.js

@@ -1,5 +1,5 @@
 // @jessie-check
-/// <reference types="@agoric/internal/exported" />
+/// <reference types="@agoric/internal/exported.js" />
 
 // eslint-disable-next-line import/export
 export * from './types.js';

package/src/state.js

@@ -1,5 +1,9 @@
 // @jessie-check
 
+/**
+ * @import {State} from './state.js';
+ */
+
 /**
  * @typedef {object} State
  * @property {bigint} generation
@@ -30,7 +34,7 @@ export const makeState = (value, priorState = GROUND_STATE) =>
 /**
  * Wrap a state store to have a default value using the GROUND_STATE
  *
- * @param {MapStore<string, import('./state.js').State>} stateStore
+ * @param {MapStore<string, State>} stateStore
  */
 export const withGroundState = stateStore => ({
   ...stateStore,

package/src/store.js

@@ -6,8 +6,12 @@ import { untilTrue } from '@agoric/internal';
 import { withGroundState, makeState } from './state.js';
 
 /**
+ * @import {ERemote} from '@agoric/internal'
+ * @import {EMarshaller} from '@agoric/internal/src/marshal/wrap-marshaller.js';
  * @import {Passable, RemotableObject} from '@endo/pass-style';
  * @import {Key, Pattern} from '@endo/patterns';
+ * @import {State} from './state.js';
+ * @import {Coordinator} from './types.js';
  */
 
 /**
@@ -45,9 +49,9 @@ const makeKeyToString = (sanitize = obj => obj) => {
  * @param {(obj: Passable) => Passable} sanitize Process keys and values with
  * this function before storing them
  * @param {{
- * get(key: string): import('./state.js').State;
- * set(key: string, value: import('./state.js').State): void;
- * init(key: string, value: import('./state.js').State): void;
+ * get(key: string): State;
+ * set(key: string, value: State): void;
+ * init(key: string, value: State): void;
  * }} stateStore
  * @returns {Promise<Passable>} the value of the updated state
  */
@@ -61,8 +65,8 @@ const applyCacheTransaction = async (
   /**
    * Retrieve a potential updated state from the transaction.
    *
-   * @param {import('./state.js').State} basisState
-   * @returns {Promise<import('./state.js').State | null>} the updated state, or null if no longer applicable
+   * @param {State} basisState
+   * @returns {Promise<State | null>} the updated state, or null if no longer applicable
    */
   const getUpdatedState = async basisState => {
     const { value } = basisState;
@@ -111,8 +115,8 @@ const applyCacheTransaction = async (
 };
 
 /**
- * @param {MapStore<string, import('./state.js').State>} stateStore
- * @param {ERef<Marshaller>} marshaller
+ * @param {MapStore<string, State>} stateStore
+ * @param {ERemote<EMarshaller>} marshaller
  * @returns {Promise<string>}
  */
 const stringifyStateStore = async (stateStore, marshaller) => {
@@ -130,7 +134,7 @@ const stringifyStateStore = async (stateStore, marshaller) => {
  * Make a cache coordinator backed by a MapStore.  This coordinator doesn't
  * currently enforce any cache eviction, but that would be a useful feature.
  *
- * @param {MapStore<string, import('./state.js').State>} [stateStore]
+ * @param {MapStore<string, State>} [stateStore]
  * @param {(obj: Passable) => Passable} [sanitize] Process keys and values with
  * this function before storing them. Defaults to deeplyFulfilled.
  */
@@ -142,7 +146,7 @@ export const makeScalarStoreCoordinator = (
 
   const defaultStateStore = withGroundState(stateStore);
 
-  /** @type {import('./types.js').Coordinator} */
+  /** @type {Coordinator} */
   const coord = Far('store cache coordinator', {
     getRecentValue: async key => {
       const keyStr = await serializePassable(key);
@@ -175,9 +179,9 @@ export const makeScalarStoreCoordinator = (
 /**
  * Don't write any marshalled value that's older than what's already pushed
  *
- * @param {MapStore<string, import('./state.js').State>} stateStore
- * @param {ERef<Marshaller>} marshaller
- * @param {ERef<StorageNode>} storageNode
+ * @param {MapStore<string, State>} stateStore
+ * @param {ERemote<EMarshaller>} marshaller
+ * @param {ERemote<StorageNode>} storageNode
  * @returns {<T>(storedValue: T) => Promise<T>}
  */
 const makeLastWinsUpdater = (stateStore, marshaller, storageNode) => {
@@ -205,8 +209,8 @@ const makeLastWinsUpdater = (stateStore, marshaller, storageNode) => {
  * Make a cache coordinator backed by a MapStore.  This coordinator doesn't
  * currently enforce any cache eviction, but that would be a useful feature.
  *
- * @param {ERef<StorageNode>} storageNode
- * @param {ERef<Marshaller>} marshaller
+ * @param {ERemote<StorageNode>} storageNode
+ * @param {ERemote<EMarshaller>} marshaller
  */
 export const makeChainStorageCoordinator = (storageNode, marshaller) => {
   const stateStore = makeScalarBigMapStore('stateKey');
@@ -222,7 +226,7 @@ export const makeChainStorageCoordinator = (storageNode, marshaller) => {
     storageNode,
   );
 
-  /** @type {import('./types.js').Coordinator} */
+  /** @type {Coordinator} */
   const coord = Far('store cache coordinator', {
     getRecentValue: async key => {
       const keyStr = await serializePassable(key);