@agoric/notifier 0.6.2 → 0.6.3-calypso-dev-84eb287.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.2",
+  "version": "0.6.3-calypso-dev-84eb287.0+84eb287",
   "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.0",
-    "@agoric/internal": "^0.3.2",
-    "@agoric/store": "^0.9.2",
-    "@agoric/swing-store": "^0.9.1",
-    "@agoric/swingset-vat": "^0.32.2",
-    "@agoric/vat-data": "^0.5.2",
-    "@endo/far": "^0.2.18",
-    "@endo/marshal": "^0.8.5",
-    "@endo/promise-kit": "^0.2.56"
+    "@agoric/assert": "0.6.1-calypso-dev-84eb287.0+84eb287",
+    "@agoric/internal": "0.3.3-calypso-dev-84eb287.0+84eb287",
+    "@agoric/vat-data": "0.5.3-calypso-dev-84eb287.0+84eb287",
+    "@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-calypso-dev-84eb287.0+84eb287",
+    "@agoric/swing-store": "0.9.2-calypso-dev-84eb287.0+84eb287",
+    "@agoric/swingset-liveslots": "0.10.3-calypso-dev-84eb287.0+84eb287",
+    "@agoric/swingset-vat": "0.32.3-calypso-dev-84eb287.0+84eb287",
+    "@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": "b66bf7c881ae462fcb617cd6e8d41b5c40ec58ef"
+  "typeCoverage": {
+    "atLeast": 90.34
+  },
+  "gitHead": "84eb287915c8255d68e845a9b6e10c790f0d54cb"
 }

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 observeIterator<T_1>(asyncIteratorP: ERef<AsyncIterator<T_1>>, 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,qDAJI,KAAK,aAAa,CAAC,GAAC,CAAC,CAAC,qBACtB,OAAO,CAAC,kBAAkB,GAAC,CAAC,CAAC,GAC3B,OAAO,CAAC,SAAS,CAAC,CAyB9B;AAaM,sDAJI,KAAK,aAAa,CAAC,GAAC,CAAC,CAAC,qBACtB,OAAO,CAAC,kBAAkB,GAAC,CAAC,CAAC,GAC3B,OAAO,CAAC,SAAS,CAAC,CAK9B;AAaM,gDAJI,KAAK,YAAY,GAAC,CAAC,CAAC,qBACpB,OAAO,CAAC,kBAAkB,GAAC,CAAC,CAAC,GAC3B,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

@@ -2,4 +2,8 @@ export function makeNotifier<T>(sharableInternalsP: ERef<LatestTopic<T>>): Notif
 export function makeNotifierFromSubscriber<T>(subscriber: 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,6BAJM,CAAC,sBACH,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,GAClB,SAAS,CAAC,CAAC,CAwBvB;AAOM,2CAJM,CAAC,cACH,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,GACjB,SAAS,CAAC,CAAC,CAiBvB;AAoBM,gCAJM,CAAC,sBACH,EAAE,GAAG,CAAC,CAAC,CAAC,GACN,eAAe,CAAC,CAAC,CAsB7B;AAcM,8CAJM,CAAC,kBACH,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GACpB,SAAS,CAAC,CAAC,CAuEvB;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;
@@ -50,4 +57,6 @@ export type DurablePublishKitEphemeralData = {
      */
     tailR: ((value: any) => void) | undefined;
 };
+import type { PublishKit } from '../src/types.js';
+import type { Publisher } 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,+BA2CQ,CAAC,KA7CH,WAAW,CAAC,CAAC,CA4FzB;AA6MM,kDAHI,OAAO,4BAA4B,EAAE,OAAO,YAC5C,MAAM;;yBA/JwB,WACzC;;;;;;;;;;GAyOC;AAGD,+DAAyD;4CAlP3C,UAAU,GAAC,CAAC;;;;;;cASZ,OAAO,CAAC,GAAC,CAAC,GAAG,SAAS;;;;WAEtB,OAAO,CAAC,GAAC,CAAC;;;;;WACV,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC,GAAG,SAAS;;gCAnPsI,iBAAiB;+BAAjB,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,10 @@
-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<Marshaller>): 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 { Marshaller } 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,mCANoB,CAAC,SAAf,WAAa,YACf,KAAK,SAAS,CAAC,CAAC,CAAC,eACjB,KAAK,WAAW,CAAC,cACjB,KAAK,UAAU,CAAC,GACd,cAAc,CAAC,CAAC,CAAC,CAiC7B;2BAlDY,CAAC,IACD,aAAa,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC;iCALhB,kBAAkB;8BAFxB,YAAY;0BAD9B,WAAW;iCAEmC,0CAA0C;gCAA1C,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,30 @@
 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<ReturnType<typeof makeMarshal>>): 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 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<Marshaller>): 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 { Marshaller } from '@agoric/internal/src/lib-chainStorage.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,yCAJM,CAAC,cACH,WAAW,CAAC,CAAC,gBACb,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,iBAcxB;AAiBM,qCAN4C,CAAC,SAAvC,OAAQ,eAAe,EAAE,WAAY,cACvC,WAAW,CAAC,CAAC,eACb,KAAK,WAAW,CAAC,cACjB,KAAK,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,GAClC,iBAAiB,CAAC,CAAC,CA6B/B;AAkBM,uCANM,CAAC,gBACH,aAAa,CAAC,CAAC;;;;;iBAGb,mBAAmB,CAAC,CAAC,CAqEjC;AAoBM,uCANO,CAAC;;;;;iDAIF,kBAAkB,CAAC,CAAC,CAAC,CAoBjC;AAgBM,qCALO,CAAC,yBACJ,KAAK,WAAW,CAAC,cACjB,KAAK,UAAU,CAAC,GACd,iBAAiB,CAAC,CAAC,CAU/B;+BAzDY,CAAC;gBAEA,mBAAmB,CAAC,CAAC;eACrB,kBAAkB,CAAC,CAAC;;gCAjKmL,iBAAiB;iCAC9K,0CAA0C;0BAF3E,WAAW;4BATN,eAAe;sCAU0K,iBAAiB;kCAAjB,iBAAiB;wCAAjB,iBAAiB;gCAC9K,0CAA0C;sCADmH,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,0BAHM,CAAC,OACH,KAAK,qBAAqB,CAAC,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;GAYrC;AAuEG,8BAHM,CAAC,SACH,KAAK,UAAU,CAAC,CAAC,CAAC;;;;GAU5B;AAsGM,gCAHM,CAAC,SACH,KAAK,YAAY,CAAC,CAAC,CAAC;;;;GAO9B;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,3 +1,6 @@
+/**
+ * @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
@@ -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,iCAJa,CAAC,SACH,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAChB,aAAa,CAAC,CAAC,CAkB3B;AAID;;;;;;;;;;;;;;;;;GAiBG;AACH,oCAHa,CAAC,KACD,mBAAmB,CAAC,CAAC,CAmBjC;+BA/DgO,iBAAiB;kCAAjB,iBAAiB;wCAAjB,iBAAiB"}

package/src/subscriber.js

@@ -1,6 +1,6 @@
 // @jessie-check
 
-/// <reference types="ses"/>
+/// <reference types="ses" />
 
 import { E, Far } from '@endo/far';
 import { subscribeEach } from './subscribe.js';
@@ -8,7 +8,9 @@ import { makePublishKit } from './publish-kit.js';
 
 import { makePinnedHistoryTopic } from './topic.js';
 
-import './types-ambient.js';
+/**
+ * @import {EachTopic, IterationObserver, LatestTopic, Notifier, NotifierRecord, SubscriptionRecord, Publisher, PublishKit, StoredPublishKit, StoredSubscription, StoredSubscriber, Subscriber, Subscription, UpdateRecord} from '../src/types.js';
+ */
 
 /**
  * @template T

package/src/topic.d.ts

@@ -1,2 +1,4 @@
 export function makePinnedHistoryTopic<T>(topic: EachTopic<T> & LatestTopic<T>): EachTopic<T> & LatestTopic<T>;
+import type { EachTopic } from '../src/types.js';
+import type { LatestTopic } from '../src/types.js';
 //# sourceMappingURL=topic.d.ts.map

package/src/topic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"topic.d.ts","sourceRoot":"","sources":["topic.js"],"names":[],"mappings":"AAcO,+GAkBN"}
+{"version":3,"file":"topic.d.ts","sourceRoot":"","sources":["topic.js"],"names":[],"mappings":"AAiBO,uCALM,CAAC,SACH,UAAU,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,GAE3B,UAAU,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAoBzC;+BA9BwC,iBAAiB;iCAAjB,iBAAiB"}

package/src/topic.js

@@ -1,7 +1,10 @@
 // @jessie-check
 
 import { Far } from '@endo/far';
-import './types-ambient.js';
+
+/**
+ * @import {EachTopic, LatestTopic} from '../src/types.js';
+ */
 
 /**
  * @deprecated A pinned-history topic preserves all of its published values in
@@ -9,7 +12,7 @@ import './types-ambient.js';
  *
  * @template T
  * @param {EachTopic<T> & LatestTopic<T>} topic needs to be near in order to
- * preserve subscription timings.  TODO: drop LatestTopic<T> requirement
+ * preserve subscription timings.  TODO: drop `LatestTopic<T>` requirement
  * @returns {EachTopic<T> & LatestTopic<T>}
  */
 export const makePinnedHistoryTopic = topic => {