@agoric/notifier 0.6.3-upgrade-14-dev-c8f9e7b.0 → 0.6.3-upgrade-16-fi-dev-8879538.0

package/exported.js

@@ -1,3 +1,2 @@
-// @jessie-check
-
-import './src/types-ambient.js';
+// Dummy file for .d.ts twin to declare ambients
+export {};

package/package.json

@@ -1,23 +1,23 @@
 {
   "name": "@agoric/notifier",
-  "version": "0.6.3-upgrade-14-dev-c8f9e7b.0+c8f9e7b",
+  "version": "0.6.3-upgrade-16-fi-dev-8879538.0+8879538",
   "description": "Notifier allows services to update clients about state changes using a stream of promises",
   "type": "module",
   "main": "src/index.js",
   "engines": {
-    "node": ">=14.15.0"
+    "node": "^18.12 || ^20.9"
   },
   "scripts": {
     "build": "exit 0",
-    "prepack": "echo \"export {}; \" | cat - src/types-ambient.js > src/types.js && tsc --build jsconfig.build.json",
-    "postpack": "git clean -f '*.d.ts*' src/types.js",
+    "prepack": "tsc --build tsconfig.build.json",
+    "postpack": "git clean -f '*.d.ts*'",
     "test": "ava",
     "test:c8": "c8 $C8_OPTIONS ava --config=ava-nesm.config.js",
     "test:xs": "exit 0",
     "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"
   },
   "repository": {
     "type": "git",
@@ -33,21 +33,23 @@
   },
   "homepage": "https://github.com/Agoric/agoric-sdk#readme",
   "dependencies": {
-    "@agoric/assert": "0.6.1-upgrade-14-dev-c8f9e7b.0+c8f9e7b",
-    "@agoric/internal": "0.4.0-upgrade-14-dev-c8f9e7b.0+c8f9e7b",
-    "@agoric/store": "0.9.3-upgrade-14-dev-c8f9e7b.0+c8f9e7b",
-    "@agoric/swing-store": "0.9.2-upgrade-14-dev-c8f9e7b.0+c8f9e7b",
-    "@agoric/swingset-vat": "0.32.3-upgrade-14-dev-c8f9e7b.0+c8f9e7b",
-    "@agoric/vat-data": "0.5.3-upgrade-14-dev-c8f9e7b.0+c8f9e7b",
-    "@endo/far": "0.2.18",
-    "@endo/marshal": "0.8.5",
-    "@endo/promise-kit": "0.2.56"
+    "@agoric/assert": "0.6.1-upgrade-16-fi-dev-8879538.0+8879538",
+    "@agoric/internal": "0.3.3-upgrade-16-fi-dev-8879538.0+8879538",
+    "@agoric/vat-data": "0.5.3-upgrade-16-fi-dev-8879538.0+8879538",
+    "@endo/far": "^1.1.2",
+    "@endo/marshal": "^1.5.0",
+    "@endo/patterns": "^1.4.0",
+    "@endo/promise-kit": "^1.1.2"
   },
   "devDependencies": {
-    "@endo/init": "0.5.56",
-    "@endo/ses-ava": "0.2.40",
-    "ava": "^5.2.0",
-    "c8": "^7.13.0"
+    "@agoric/kmarshal": "0.1.1-upgrade-16-fi-dev-8879538.0+8879538",
+    "@agoric/swing-store": "0.9.2-upgrade-16-fi-dev-8879538.0+8879538",
+    "@agoric/swingset-liveslots": "0.10.3-upgrade-16-fi-dev-8879538.0+8879538",
+    "@agoric/swingset-vat": "0.32.3-upgrade-16-fi-dev-8879538.0+8879538",
+    "@endo/init": "^1.1.2",
+    "@endo/ses-ava": "^1.2.2",
+    "ava": "^5.3.0",
+    "c8": "^9.1.0"
   },
   "exports": {
     ".": "./src/index.js",
@@ -66,9 +68,15 @@
   },
   "ava": {
     "files": [
-      "test/**/test-*.js"
+      "test/**/*.test.*"
+    ],
+    "require": [
+      "@endo/init/debug.js"
     ],
     "timeout": "2m"
   },
-  "gitHead": "c8f9e7be1645e0be23f47de197409a7d4874add5"
+  "typeCoverage": {
+    "atLeast": 90.34
+  },
+  "gitHead": "8879538cd1d125a08346f02dd5701d0d70c90bb8"
 }

package/src/asyncIterableAdaptor.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @import {ERef} from '@endo/far';
+ * @import {BaseNotifier, IterationObserver, LatestTopic} from '../src/types.js';
+ */
 /**
  * @deprecated Use `subscribeLatest` from `@agoric/notifier/subscribe.js` instead.
  *
@@ -30,11 +34,14 @@
  * @returns {ForkableAsyncIterable<T>}
  */
 export const makeAsyncIterableFromNotifier: <T_1>(topic: ERef<LatestTopic<T_1>>) => {
-    [Symbol.asyncIterator]: () => ForkableAsyncIterableIterator<T_1, T_1, undefined>;
-} & import("@endo/eventual-send").RemotableBrand<{}, {
-    [Symbol.asyncIterator]: () => ForkableAsyncIterableIterator<T_1, T_1, undefined>;
+    [Symbol.asyncIterator]: () => import("../src/types.js").ForkableAsyncIterableIterator<T_1, T_1>;
+} & import("@endo/pass-style").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
+    [Symbol.asyncIterator]: () => import("../src/types.js").ForkableAsyncIterableIterator<T_1, T_1>;
 }>;
 export function observeIterator<T_1>(asyncIteratorP: ERef<AsyncIterator<T_1, any, undefined>>, iterationObserver: Partial<IterationObserver<T_1>>): Promise<undefined>;
 export function observeIteration<T_1>(asyncIterableP: ERef<AsyncIterable<T_1>>, iterationObserver: Partial<IterationObserver<T_1>>): Promise<undefined>;
 export function observeNotifier<T_1>(notifierP: ERef<LatestTopic<T_1>>, iterationObserver: Partial<IterationObserver<T_1>>): Promise<undefined>;
+import type { LatestTopic } from '../src/types.js';
+import type { ERef } from '@endo/far';
+import type { IterationObserver } from '../src/types.js';
 //# sourceMappingURL=asyncIterableAdaptor.d.ts.map

package/src/asyncIterableAdaptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asyncIterableAdaptor.d.ts","sourceRoot":"","sources":["asyncIterableAdaptor.js"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH;;;;GAA6D;AAatD,oJAFM,QAAQ,SAAS,CAAC,CAyB9B;AAaM,qIAFM,QAAQ,SAAS,CAAC,CAK9B;AAaM,6HAFM,QAAQ,SAAS,CAAC,CAGkC"}
+{"version":3,"file":"asyncIterableAdaptor.d.ts","sourceRoot":"","sources":["asyncIterableAdaptor.js"],"names":[],"mappings":"AAKA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH;;;;GAA6D;AAatD,gCAH8B,GAAC,iHACzB,OAAO,CAAC,SAAS,CAAC,CAyB9B;AAaM,iCAH8B,GAAC,iGACzB,OAAO,CAAC,SAAS,CAAC,CAK9B;AAaM,gCAH8B,GAAC,0FACzB,OAAO,CAAC,SAAS,CAAC,CAGkC;iCApGF,iBAAiB;0BADzD,WAAW;uCAC6B,iBAAiB"}

package/src/asyncIterableAdaptor.js

@@ -1,9 +1,12 @@
-/// <reference types="ses"/>
+/// <reference types="ses" />
 
 import { E } from '@endo/far';
 import { subscribeLatest } from './subscribe.js';
 
-import './types-ambient.js';
+/**
+ * @import {ERef} from '@endo/far';
+ * @import {BaseNotifier, IterationObserver, LatestTopic} from '../src/types.js';
+ */
 
 /**
  * @deprecated Use `subscribeLatest` from `@agoric/notifier/subscribe.js` instead.

package/src/index.d.ts

@@ -1,5 +1,7 @@
+export { makePinnedHistoryTopic } from "./topic.js";
 export * from "./storesub.js";
 export * from "./stored-notifier.js";
+export * from "./types.js";
 export { makePublishKit, prepareDurablePublishKit, ForkableAsyncIterableIteratorShape, IterableEachTopicI, IterableLatestTopicI, SubscriberShape } from "./publish-kit.js";
 export { subscribeEach, subscribeLatest } from "./subscribe.js";
 export { makeNotifier, makeNotifierKit, makeNotifierFromAsyncIterable, makeNotifierFromSubscriber } from "./notifier.js";

package/src/index.js

@@ -1,4 +1,5 @@
 // @jessie-check
+/// <reference types="@agoric/internal/exported" />
 
 export {
   makePublishKit,
@@ -16,6 +17,7 @@ export {
   makeNotifierFromSubscriber,
 } from './notifier.js';
 export { makeSubscription, makeSubscriptionKit } from './subscriber.js';
+export { makePinnedHistoryTopic } from './topic.js';
 export {
   observeNotifier,
   observeIterator,
@@ -25,3 +27,6 @@ export {
 } from './asyncIterableAdaptor.js';
 export * from './storesub.js';
 export * from './stored-notifier.js';
+
+// eslint-disable-next-line import/export -- doesn't know types
+export * from './types.js';

package/src/notifier.d.ts

@@ -1,5 +1,9 @@
-export function makeNotifier<T>(sharableInternalsP: ERef<LatestTopic<T>>): Notifier<T>;
-export function makeNotifierFromSubscriber<T>(subscriber: ERef<Subscriber<T>>): Notifier<T>;
+export function makeNotifier<T>(sharableInternalsP: globalThis.ERef<LatestTopic<T>>): Notifier<T>;
+export function makeNotifierFromSubscriber<T>(subscriber: globalThis.ERef<Subscriber<T>>): Notifier<T>;
 export function makeNotifierKit<T>(...initialStateArr: [] | [T]): NotifierRecord<T>;
 export function makeNotifierFromAsyncIterable<T>(asyncIterableP: ERef<AsyncIterable<T>>): Notifier<T>;
+import type { LatestTopic } from './types.js';
+import type { Notifier } from './types.js';
+import type { Subscriber } from './types.js';
+import type { NotifierRecord } from './types.js';
 //# sourceMappingURL=notifier.d.ts.map

package/src/notifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notifier.d.ts","sourceRoot":"","sources":["notifier.js"],"names":[],"mappings":"AAcO,uFAsBN;AAOM,4FAeN;AAoBM,oFAoBN;AAcM,sGAqEN"}
+{"version":3,"file":"notifier.d.ts","sourceRoot":"","sources":["notifier.js"],"names":[],"mappings":"AAiBO,6BAFe,CAAC,oEAwBtB;AAOM,2CAFe,CAAC,2DAiBtB;AAoBM,gCAFqB,CAAC,sBADlB,EAAE,GAAG,CACY,CAAC,AADX,CAAC,qBAuBlB;AAcM,8CAFe,CAAC,kBADZ,IAAI,CAAC,aAAa,CACP,CAAC,AADQ,CAAC,CAAC,eAwEhC;iCA/K6F,YAAY;8BAAZ,YAAY;gCAAZ,YAAY;oCAAZ,YAAY"}

package/src/notifier.js

@@ -1,12 +1,15 @@
-/// <reference types="ses"/>
+/// <reference types="ses" />
 
 import { assert } from '@agoric/assert';
 import { E, Far } from '@endo/far';
 
-import './types-ambient.js';
 import { makePublishKit } from './publish-kit.js';
 import { subscribeLatest } from './subscribe.js';
 
+/**
+ * @import {LatestTopic, Notifier, NotifierRecord, PublishKit, Subscriber, UpdateRecord} from './types.js';
+ */
+
 /**
  * @template T
  * @param {ERef<LatestTopic<T>>} sharableInternalsP

package/src/publish-kit.d.ts

@@ -1,27 +1,34 @@
-export const PublisherI: import("@endo/patterns").InterfaceGuard;
+export const PublisherI: import("@endo/patterns").InterfaceGuard<{
+    publish: import("@endo/patterns").MethodGuard;
+    finish: import("@endo/patterns").MethodGuard;
+    fail: import("@endo/patterns").MethodGuard;
+}>;
 export const UpdateCountShape: import("@endo/patterns").Matcher;
-export const SubscriberI: import("@endo/patterns").InterfaceGuard;
+export const SubscriberI: import("@endo/patterns").InterfaceGuard<{
+    subscribeAfter: import("@endo/patterns").MethodGuard;
+    getUpdateSince: import("@endo/patterns").MethodGuard;
+}>;
 export namespace publishKitIKit {
     export { PublisherI as publisher };
     export { SubscriberI as subscriber };
 }
-export const ForkableAsyncIterableIteratorShape: import("@endo/patterns").InterfaceGuard;
-export const IterableEachTopicI: import("@endo/patterns").InterfaceGuard;
-export const IterableLatestTopicI: import("@endo/patterns").InterfaceGuard;
+export const ForkableAsyncIterableIteratorShape: import("@endo/patterns").InterfaceGuard<{
+    fork: import("@endo/patterns").MethodGuard;
+    [Symbol.asyncIterator]: import("@endo/patterns").MethodGuard;
+    next: import("@endo/patterns").MethodGuard;
+}>;
+export const IterableEachTopicI: import("@endo/patterns").InterfaceGuard<{
+    subscribeAfter: import("@endo/patterns").MethodGuard;
+    [Symbol.asyncIterator]: import("@endo/patterns").MethodGuard;
+}>;
+export const IterableLatestTopicI: import("@endo/patterns").InterfaceGuard<{
+    getUpdateSince: import("@endo/patterns").MethodGuard;
+    [Symbol.asyncIterator]: import("@endo/patterns").MethodGuard;
+}>;
 export function makePublishKit<T>(): PublishKit<T>;
-export function prepareDurablePublishKit(baggage: MapStore<string, unknown>, kindName: string): (options?: {
+export function prepareDurablePublishKit(baggage: import("@agoric/swingset-liveslots").Baggage, kindName: string): (options?: {
     valueDurability?: "mandatory" | undefined;
-} | undefined) => {
-    publisher: {
-        publish(value: any): void;
-        finish(finalValue: any): void;
-        fail(reason: any): void;
-    };
-    subscriber: {
-        subscribeAfter(publishCount?: bigint): Promise<any>;
-        getUpdateSince(updateCount: any): any;
-    };
-} & import("@endo/eventual-send").RemotableBrand<{}, {
+} | undefined) => import("@endo/exo").GuardedKit<{
     publisher: {
         publish(value: any): void;
         finish(finalValue: any): void;
@@ -33,7 +40,11 @@ export function prepareDurablePublishKit(baggage: MapStore<string, unknown>, kin
     };
 }>;
 export const SubscriberShape: import("@endo/patterns").Matcher;
-export type DurablePublishKitEphemeralKey = Publisher<any>;
+export type DurablePublishKitEphemeralKey = {
+    publish: (nonFinalValue: any) => void;
+    finish: (completion: any) => void;
+    fail: (reason: any) => void;
+};
 export type DurablePublishKitEphemeralData = {
     /**
      * The current-result promise
@@ -50,4 +61,5 @@ export type DurablePublishKitEphemeralData = {
      */
     tailR: ((value: any) => void) | undefined;
 };
+import type { PublishKit } from '../src/types.js';
 //# sourceMappingURL=publish-kit.d.ts.map

package/src/publish-kit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publish-kit.d.ts","sourceRoot":"","sources":["publish-kit.js"],"names":[],"mappings":"AAqBA,iEAIG;AAGH,gEAA6D;AAC7D,kEAGG;;;;;AAMH,yFAOE;AAEF,yEAKG;AAEH,2EAKG;AA+CI,mDA0FN;AA6MM,uFAFI,MAAM;;;;;;;;;;;;;;;;;;;;;;GA2EhB;AAGD,+DAAyD;4CAlP3C,cAAY;;;;;;cASZ,YAAU,GAAG,SAAS;;;;WAEtB,YAAU;;;;;oBACD,GAAG,KAAK,IAAI"}
+{"version":3,"file":"publish-kit.d.ts","sourceRoot":"","sources":["publish-kit.js"],"names":[],"mappings":"AAwBA;;;;GAIG;AAGH,gEAA6D;AAC7D;;;GAGG;;;;;AAMH;;;;GAOE;AAEF;;;GAMG;AAEH;;;GAMG;AA+CI,+BAFiB,CAAC,mBA4FxB;AA6MM,kDAHI,OAAO,4BAA4B,EAAE,OAAO,YAC5C,MAAM;;;;;;;;;;;;GA2EhB;AAGD,+DAAyD;;;;;;;;;;;cAzO3C,OAAO,KAAG,GAAG,SAAS;;;;WAEtB,OAAO,KAAG;;;;;WACV,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC,GAAG,SAAS;;gCAnPsI,iBAAiB"}

package/src/publish-kit.js

@@ -1,11 +1,14 @@
-/// <reference types="ses"/>
+/// <reference types="ses" />
 
-import { makePromiseKit } from '@endo/promise-kit';
-import { E, Far } from '@endo/far';
-import { M } from '@agoric/store';
 import { canBeDurable, prepareExoClassKit } from '@agoric/vat-data';
+import { E, Far } from '@endo/far';
+import { M, getInterfaceGuardPayload } from '@endo/patterns';
+import { makePromiseKit } from '@endo/promise-kit';
 
-import './types-ambient.js';
+/**
+ * @import {ERef} from '@endo/far';
+ * @import {DurablePublishKitState, DurablePublishKitValueDurability, LatestTopic, Notifier, NotifierRecord, PublicationRecord, Publisher, PublishKit, Subscriber, UpdateRecord} from '../src/types.js';
+ */
 
 const { Fail, quote: q } = assert;
 
@@ -46,14 +49,16 @@ export const ForkableAsyncIterableIteratorShape = M.interface(
 );
 
 export const IterableEachTopicI = M.interface('IterableEachTopic', {
-  subscribeAfter: SubscriberI.methodGuards.subscribeAfter,
+  subscribeAfter:
+    getInterfaceGuardPayload(SubscriberI).methodGuards.subscribeAfter,
   [Symbol.asyncIterator]: M.call().returns(
     M.remotable('ForkableAsyncIterableIterator'),
   ),
 });
 
 export const IterableLatestTopicI = M.interface('IterableLatestTopic', {
-  getUpdateSince: SubscriberI.methodGuards.getUpdateSince,
+  getUpdateSince:
+    getInterfaceGuardPayload(SubscriberI).methodGuards.getUpdateSince,
   [Symbol.asyncIterator]: M.call().returns(
     M.remotable('ForkableAsyncIterableIterator'),
   ),
@@ -209,7 +214,7 @@ const DurablePublishKitStateShape = harden({
 
 /**
  * @param {object} [options]
- * @param {DurablePublishKitValueDurability & 'mandatory'} [options.valueDurability='mandatory']
+ * @param {DurablePublishKitValueDurability & 'mandatory'} [options.valueDurability]
  * @returns {DurablePublishKitState}
  */
 const initDurablePublishKitState = (options = {}) => {
@@ -396,7 +401,7 @@ const advanceDurablePublishKit = (context, value, targetStatus = 'live') => {
 };
 
 /**
- * @param {import('../../vat-data/src/types.js').Baggage} baggage
+ * @param {import('@agoric/swingset-liveslots').Baggage} baggage
  * @param {string} kindName
  */
 export const prepareDurablePublishKit = (baggage, kindName) => {

package/src/stored-notifier.d.ts

@@ -1,3 +1,39 @@
-export function makeStoredNotifier<T>(notifier: ERef<Notifier<T>>, storageNode: ERef<StorageNode>, marshaller: ERef<Marshaller>): StoredNotifier<T>;
-export type StoredNotifier<T> = BaseNotifier<T> & Omit<StoredFacet, 'getStoreKey'>;
+export function makeStoredNotifier<T extends PassableCap>(notifier: ERef<Notifier<T>>, storageNode: ERef<StorageNode>, marshaller: ERef<{
+    /**
+     * @import {ERef} from '@endo/far';
+     * @import {BaseNotifier, Notifier} from './types.js';
+     * @import {Marshaller, StoredFacet, StorageNode, Unserializer} from '@agoric/internal/src/lib-chainStorage.js';
+     * @import {PassableCap, RemotableObject} from '@endo/pass-style';
+     */
+    /**
+     * @template T
+     * @typedef {BaseNotifier<T> & Omit<StoredFacet, 'getStoreKey'>} StoredNotifier
+     */
+    /**
+     * Begin iterating the source, storing serialized iteration values.  If the
+     * storageNode's `setValue` operation rejects, no further writes to it will
+     * be attempted (but results will remain available from the subscriber).
+     *
+     * Returns a StoredNotifier that can be used by a client to directly follow
+     * the iteration themselves, or obtain information to subscribe to the stored
+     * data out-of-band.
+     *
+     * @template {PassableCap} T
+     * @param {ERef<Notifier<T>>} notifier
+     * @param {ERef<StorageNode>} storageNode
+     * @param {ERef<Marshaller>} marshaller
+     * @returns {StoredNotifier<T>}
+     */
+    toCapData: import("@endo/marshal").ToCapData<unknown>;
+    fromCapData: import("@endo/marshal").FromCapData<unknown>;
+    serialize: import("@endo/marshal").ToCapData<unknown>;
+    unserialize: import("@endo/marshal").FromCapData<unknown>;
+}>): StoredNotifier<T>;
+export type StoredNotifier<T> = BaseNotifier<T> & Omit<StoredFacet, "getStoreKey">;
+import type { PassableCap } from '@endo/pass-style';
+import type { Notifier } from './types.js';
+import type { ERef } from '@endo/far';
+import type { StorageNode } from '@agoric/internal/src/lib-chainStorage.js';
+import type { BaseNotifier } from './types.js';
+import type { StoredFacet } from '@agoric/internal/src/lib-chainStorage.js';
 //# sourceMappingURL=stored-notifier.d.ts.map

package/src/stored-notifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stored-notifier.d.ts","sourceRoot":"","sources":["stored-notifier.js"],"names":[],"mappings":"AA2BO,gFAJI,KAAK,WAAW,CAAC,cACjB,KAAK,UAAU,CAAC,qBAkC1B;gCAjDY,aAAa,CAAC,CAAC,GAAG,KAAK,WAAW,EAAE,aAAa,CAAC"}
+{"version":3,"file":"stored-notifier.d.ts","sourceRoot":"","sources":["stored-notifier.js"],"names":[],"mappings":"AAkCO,mCAFqB,CAAC;IAzB7B;;;;;OAKG;IAEH;;;OAGG;IAEH;;;;;;;;;;;;;;OAcG;;;;;KADU,cAAc,CAAC,CAAC,CAAC,CAiC7B;2BAjDyB,CAAC;iCALoB,kBAAkB;8BAFxB,YAAY;0BAD9B,WAAW;iCAEmC,0CAA0C;kCADtE,YAAY;iCACgB,0CAA0C"}

package/src/stored-notifier.js

@@ -5,6 +5,13 @@ import { makeSerializeToStorage } from '@agoric/internal/src/lib-chainStorage.js
 import { E, Far } from '@endo/far';
 import { observeNotifier } from './asyncIterableAdaptor.js';
 
+/**
+ * @import {ERef} from '@endo/far';
+ * @import {BaseNotifier, Notifier} from './types.js';
+ * @import {Marshaller, StoredFacet, StorageNode, Unserializer} from '@agoric/internal/src/lib-chainStorage.js';
+ * @import {PassableCap, RemotableObject} from '@endo/pass-style';
+ */
+
 /**
  * @template T
  * @typedef {BaseNotifier<T> & Omit<StoredFacet, 'getStoreKey'>} StoredNotifier
@@ -19,7 +26,7 @@ import { observeNotifier } from './asyncIterableAdaptor.js';
  * the iteration themselves, or obtain information to subscribe to the stored
  * data out-of-band.
  *
- * @template T
+ * @template {PassableCap} T
  * @param {ERef<Notifier<T>>} notifier
  * @param {ERef<StorageNode>} storageNode
  * @param {ERef<Marshaller>} marshaller

package/src/storesub.d.ts

@@ -1,16 +1,39 @@
 export function forEachPublicationRecord<T>(subscriber: Subscriber<T>, consumeValue: (v: T) => void): Promise<void>;
-export function makeStoredSubscriber<T>(subscriber: Subscriber<T>, storageNode: ERef<StorageNode>, marshaller: ERef<ReturnType<typeof makeMarshal>>): StoredSubscriber<T>;
+export function makeStoredSubscriber<T extends import("@endo/marshal").PassableCap>(subscriber: Subscriber<T>, storageNode: ERef<StorageNode>, marshaller: ERef<{
+    toCapData: import("@endo/marshal").ToCapData<unknown>;
+    fromCapData: import("@endo/marshal").FromCapData<unknown>;
+    serialize: import("@endo/marshal").ToCapData<unknown>;
+    unserialize: import("@endo/marshal").FromCapData<unknown>;
+}>): StoredSubscriber<T>;
 export function makeStoredSubscription<T>(subscription: Subscription<T>, storageNode?: ERef<StorageNode> | undefined, marshaller?: ERef<{
-    toCapData: import("@endo/marshal/src/marshal.js").ToCapData<unknown>;
-    fromCapData: import("@endo/marshal/src/marshal.js").FromCapData<unknown>;
-    serialize: import("@endo/marshal/src/marshal.js").ToCapData<unknown>;
-    unserialize: import("@endo/marshal/src/marshal.js").FromCapData<unknown>;
+    toCapData: import("@endo/marshal").ToCapData<unknown>;
+    fromCapData: import("@endo/marshal").FromCapData<unknown>;
+    serialize: import("@endo/marshal").ToCapData<unknown>;
+    unserialize: import("@endo/marshal").FromCapData<unknown>;
 }> | undefined): StoredSubscription<T>;
-export function makeStoredPublisherKit<T = unknown>(storageNode?: ERef<StorageNode> | undefined, marshaller?: ERef<Marshaller<unknown>> | undefined, childPath?: string | undefined): StoredPublisherKit<T>;
-export function makeStoredPublishKit<T = unknown>(storageNode: ERef<StorageNode>, marshaller: ERef<Marshaller>): StoredPublishKit<T>;
+export function makeStoredPublisherKit<T = unknown>(storageNode?: ERef<StorageNode> | undefined, marshaller?: ERef<{
+    toCapData: import("@endo/marshal").ToCapData<unknown>;
+    fromCapData: import("@endo/marshal").FromCapData<unknown>;
+    serialize: import("@endo/marshal").ToCapData<unknown>;
+    unserialize: import("@endo/marshal").FromCapData<unknown>;
+}> | undefined, childPath?: string | undefined): StoredPublisherKit<T>;
+export function makeStoredPublishKit<T = unknown>(storageNode: ERef<StorageNode>, marshaller: ERef<{
+    toCapData: import("@endo/marshal").ToCapData<unknown>;
+    fromCapData: import("@endo/marshal").FromCapData<unknown>;
+    serialize: import("@endo/marshal").ToCapData<unknown>;
+    unserialize: import("@endo/marshal").FromCapData<unknown>;
+}>): StoredPublishKit<T>;
 export type StoredPublisherKit<T> = {
     subscriber: StoredSubscription<T>;
     publisher: IterationObserver<T>;
 };
-import { makeMarshal } from "@endo/marshal";
+import type { Subscriber } from '../src/types.js';
+import type { StorageNode } from '@agoric/internal/src/lib-chainStorage.js';
+import type { ERef } from '@endo/far';
+import { makeMarshal } from '@endo/marshal';
+import type { StoredSubscriber } from '../src/types.js';
+import type { Subscription } from '../src/types.js';
+import type { StoredSubscription } from '../src/types.js';
+import type { StoredPublishKit } from '../src/types.js';
+import type { IterationObserver } from '../src/types.js';
 //# sourceMappingURL=storesub.d.ts.map

package/src/storesub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storesub.d.ts","sourceRoot":"","sources":["storesub.js"],"names":[],"mappings":"AAgBO,+FAFc,IAAI,iBAgBxB;AAiBM,gFAJI,KAAK,WAAW,CAAC,cACjB,KAAK,WAAW,kBAAkB,CAAC,CAAC,uBA8B9C;AAkBM;;;;;uCAmEN;AAoBM,4MAkBN;AAgBM,+DAJI,KAAK,WAAW,CAAC,cACjB,KAAK,UAAU,CAAC,uBAW1B;;gBAvDa,mBAAmB,CAAC,CAAC;eACrB,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"storesub.d.ts","sourceRoot":"","sources":["storesub.js"],"names":[],"mappings":"AAuBO,yCAFQ,CAAC,2CAAL,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,iBAcxB;AAiBM,qCAFuB,CAAC;;;;;yBA6B9B;AAkBM,uCAFyB,CAAC;;;;;uCAqEhC;AAoBM,uCAFyB,CAAC;;;;;iDAApB,kBAAkB,CAAC,CAAC,CAAC,CAoBjC;AAgBM,qCAFuB,CAAC;;;;;yBAU9B;+BAtD+B,CAAC;;;;gCAjKoL,iBAAiB;iCAC9K,0CAA0C;0BAF3E,WAAW;4BATN,eAAe;sCAU0K,iBAAiB;kCAAjB,iBAAiB;wCAAjB,iBAAiB;sCAAjB,iBAAiB;uCAAjB,iBAAiB"}

package/src/storesub.js

@@ -7,9 +7,16 @@ import { makePublishKit } from './publish-kit.js';
 import { makeSubscriptionKit } from './subscriber.js';
 import { subscribeEach } from './subscribe.js';
 
+/**
+ * @import {ERef} from '@endo/far';
+ * @import {IterationObserver, LatestTopic, Notifier, NotifierRecord, PublicationRecord, Publisher, PublishKit, StoredPublishKit, StoredSubscription, StoredSubscriber, Subscriber, Subscription, UpdateRecord} from '../src/types.js';
+ * @import {Marshaller, StorageNode, Unserializer} from '@agoric/internal/src/lib-chainStorage.js';
+ */
+
 /**
  * NB: does not yet survive upgrade https://github.com/Agoric/agoric-sdk/issues/6893
  *
+ * @alpha
  * @template T
  * @param {Subscriber<T>} subscriber
  * @param {(v: T) => void} consumeValue
@@ -20,11 +27,9 @@ export const forEachPublicationRecord = async (subscriber, consumeValue) => {
   const iterator = subscribeEach(subscriber)[Symbol.asyncIterator]();
 
   let finished = false;
+  await null;
   while (!finished) {
-    // Allow nested awaits (in loop) because it's safe for each to run in a turn
-    // eslint-disable-next-line no-await-in-loop, @jessie.js/no-nested-await
     const { value, done } = await iterator.next();
-    // eslint-disable-next-line no-await-in-loop, @jessie.js/no-nested-await
     await consumeValue(value);
     finished = !!done;
   }
@@ -39,7 +44,7 @@ export const forEachPublicationRecord = async (subscriber, consumeValue) => {
  * the iteration themselves, or obtain information to subscribe to the stored
  * data out-of-band.
  *
- * @template T
+ * @template {import('@endo/marshal').PassableCap} T
  * @param {Subscriber<T>} subscriber
  * @param {ERef<StorageNode>} storageNode
  * @param {ERef<ReturnType<typeof makeMarshal>>} marshaller
@@ -98,7 +103,7 @@ export const makeStoredSubscription = (
     serializeBodyFormat: 'smallcaps',
   }),
 ) => {
-  /** @type {Unserializer} */
+  /** @type {import('@agoric/internal/src/lib-chainStorage.js').Unserializer} */
   const unserializer = Far('unserializer', {
     fromCapData: data => E(marshaller).fromCapData(data),
     unserialize: data => E(marshaller).fromCapData(data),

package/src/subscribe.d.ts

@@ -1,28 +1,32 @@
 export function subscribe<T>(itP: ERef<AsyncIterableIterator<T>>): {
     [Symbol.asyncIterator]: () => {
-        [Symbol.asyncIterator]: () => any & import("@endo/eventual-send").RemotableBrand<{}, any>;
+        [Symbol.asyncIterator]: () => any & import("@endo/marshal").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, any>;
         next: () => Promise<IteratorResult<T, any>>;
-    } & import("@endo/eventual-send").RemotableBrand<{}, {
-        [Symbol.asyncIterator]: () => any & import("@endo/eventual-send").RemotableBrand<{}, any>;
+    } & import("@endo/marshal").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
+        [Symbol.asyncIterator]: () => any & import("@endo/marshal").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, any>;
         next: () => Promise<IteratorResult<T, any>>;
     }>;
-} & import("@endo/eventual-send").RemotableBrand<{}, {
+} & import("@endo/marshal").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
     [Symbol.asyncIterator]: () => {
-        [Symbol.asyncIterator]: () => any & import("@endo/eventual-send").RemotableBrand<{}, any>;
+        [Symbol.asyncIterator]: () => any & import("@endo/marshal").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, any>;
         next: () => Promise<IteratorResult<T, any>>;
-    } & import("@endo/eventual-send").RemotableBrand<{}, {
-        [Symbol.asyncIterator]: () => any & import("@endo/eventual-send").RemotableBrand<{}, any>;
+    } & import("@endo/marshal").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
+        [Symbol.asyncIterator]: () => any & import("@endo/marshal").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, any>;
         next: () => Promise<IteratorResult<T, any>>;
     }>;
 }>;
 export function subscribeEach<T>(topic: ERef<EachTopic<T>>): {
-    [Symbol.asyncIterator]: () => ForkableAsyncIterableIterator<T, T, undefined>;
-} & import("@endo/eventual-send").RemotableBrand<{}, {
-    [Symbol.asyncIterator]: () => ForkableAsyncIterableIterator<T, T, undefined>;
+    [Symbol.asyncIterator]: () => ForkableAsyncIterableIterator<T, T>;
+} & import("@endo/marshal").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
+    [Symbol.asyncIterator]: () => ForkableAsyncIterableIterator<T, T>;
 }>;
 export function subscribeLatest<T>(topic: ERef<LatestTopic<T>>): {
-    [Symbol.asyncIterator]: () => ForkableAsyncIterableIterator<T, T, undefined>;
-} & import("@endo/eventual-send").RemotableBrand<{}, {
-    [Symbol.asyncIterator]: () => ForkableAsyncIterableIterator<T, T, undefined>;
+    [Symbol.asyncIterator]: () => ForkableAsyncIterableIterator<T, T>;
+} & import("@endo/marshal").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
+    [Symbol.asyncIterator]: () => ForkableAsyncIterableIterator<T, T>;
 }>;
+import type { ERef } from '@endo/far';
+import type { EachTopic } from '../src/types.js';
+import type { ForkableAsyncIterableIterator } from '../src/types.js';
+import type { LatestTopic } from '../src/types.js';
 //# sourceMappingURL=subscribe.d.ts.map

package/src/subscribe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subscribe.d.ts","sourceRoot":"","sources":["subscribe.js"],"names":[],"mappings":"AAmEO;;;;;;;;;;;;;;;;GAUH;AAuEG;;;;GAQN;AAsGM;;;;GAKN"}
+{"version":3,"file":"subscribe.d.ts","sourceRoot":"","sources":["subscribe.js"],"names":[],"mappings":"AAqEO,0BAF+B,CAAC;;;;;;;;;;;;;;;;GAYnC;AAuEG,8BAFmB,CAAC;;;;GAU1B;AAsGM,gCAFqB,CAAC;;;;GAO5B;0BApQsB,WAAW;+BAC6N,iBAAiB;mDAAjB,iBAAiB;iCAAjB,iBAAiB"}

package/src/subscribe.js

@@ -2,7 +2,10 @@ import { E, Far } from '@endo/far';
 import { isObject } from '@endo/marshal';
 import { isUpgradeDisconnection } from '@agoric/internal/src/upgrade-api.js';
 
-import './types-ambient.js';
+/**
+ * @import {ERef} from '@endo/far';
+ * @import {IterationObserver, LatestTopic, Notifier, NotifierRecord, PublicationRecord, Publisher, PublishKit, StoredPublishKit, StoredSubscription, StoredSubscriber, Subscriber, Subscription, UpdateRecord, EachTopic, ForkableAsyncIterableIterator} from '../src/types.js';
+ */
 
 const { details: X, Fail } = assert;
 const sink = () => {};
@@ -24,7 +27,6 @@ const reconnectAsNeeded = async (getter, seed = []) => {
   for (let i = 0; ; i += 1) {
     try {
       const resultP = i < seed.length ? seed[i] : getter();
-      // eslint-disable-next-line no-await-in-loop, @jessie.js/no-nested-await
       const result = await resultP;
       return result;
     } catch (err) {
@@ -51,7 +53,7 @@ const reconnectAsNeeded = async (getter, seed = []) => {
             X`Attempting to recover from disconnection: ${disconnection}`,
           );
         } catch (_err) {
-          // eslint-disable-next-line no-empty
+          // noop
         }
       }
       throw err;

package/src/subscriber.d.ts

@@ -1,9 +1,12 @@
+/**
+ * @import {EachTopic, IterationObserver, LatestTopic, Notifier, NotifierRecord, SubscriptionRecord, Publisher, PublishKit, StoredPublishKit, StoredSubscription, StoredSubscriber, Subscriber, Subscription, UpdateRecord} from '../src/types.js';
+ */
 /**
  * @template T
  * @param {ERef<EachTopic<T>>} topic
  * @returns {Subscription<T>}
  */
-export function makeSubscription<T>(topic: ERef<EachTopic<T>>): Subscription<T>;
+export function makeSubscription<T>(topic: globalThis.ERef<EachTopic<T>>): Subscription<T>;
 /**
  * @deprecated Producers should use
  * ```js
@@ -23,4 +26,7 @@ export function makeSubscription<T>(topic: ERef<EachTopic<T>>): Subscription<T>;
  * @returns {SubscriptionRecord<T>}
  */
 export function makeSubscriptionKit<T>(): SubscriptionRecord<T>;
+import type { EachTopic } from '../src/types.js';
+import type { Subscription } from '../src/types.js';
+import type { SubscriptionRecord } from '../src/types.js';
 //# sourceMappingURL=subscriber.d.ts.map

package/src/subscriber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subscriber.d.ts","sourceRoot":"","sources":["subscriber.js"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,gFAgBC;AAID;;;;;;;;;;;;;;;;;GAiBG;AACH,gEAiBC"}
+{"version":3,"file":"subscriber.d.ts","sourceRoot":"","sources":["subscriber.js"],"names":[],"mappings":"AAUA;;GAEG;AAEH;;;;GAIG;AACH,iCAF0B,CAAC,yDAkB1B;AAID;;;;;;;;;;;;;;;;;GAiBG;AACH,oCAFgC,CAAC,2BAmBhC;+BA/DgO,iBAAiB;kCAAjB,iBAAiB;wCAAjB,iBAAiB"}