@agoric/notifier 0.7.0-upgrade-17-dev-a1453b2.0 → 0.7.0-upgrade-18-dev-bf39b10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/notifier",
-  "version": "0.7.0-upgrade-17-dev-a1453b2.0+a1453b2",
+  "version": "0.7.0-upgrade-18-dev-bf39b10.0+bf39b10",
   "description": "Notifier allows services to update clients about state changes using a stream of promises",
   "type": "module",
   "main": "src/index.js",
@@ -10,7 +10,7 @@
   "scripts": {
     "build": "exit 0",
     "prepack": "tsc --build tsconfig.build.json",
-    "postpack": "git clean -f '*.d.ts*'",
+    "postpack": "git clean -f '*.d.ts*' '*.tsbuildinfo'",
     "test": "ava",
     "test:c8": "c8 $C8_OPTIONS ava --config=ava-nesm.config.js",
     "test:xs": "exit 0",
@@ -33,21 +33,21 @@
   },
   "homepage": "https://github.com/Agoric/agoric-sdk#readme",
   "dependencies": {
-    "@agoric/internal": "0.4.0-upgrade-17-dev-a1453b2.0+a1453b2",
-    "@agoric/vat-data": "0.5.3-upgrade-17-dev-a1453b2.0+a1453b2",
-    "@endo/errors": "^1.2.5",
-    "@endo/far": "^1.1.5",
-    "@endo/marshal": "^1.5.3",
-    "@endo/patterns": "^1.4.3",
-    "@endo/promise-kit": "^1.1.5"
+    "@agoric/internal": "0.4.0-upgrade-18-dev-bf39b10.0+bf39b10",
+    "@agoric/vat-data": "0.5.3-upgrade-18-dev-bf39b10.0+bf39b10",
+    "@endo/errors": "^1.2.7",
+    "@endo/far": "^1.1.8",
+    "@endo/marshal": "^1.6.1",
+    "@endo/patterns": "^1.4.6",
+    "@endo/promise-kit": "^1.1.7"
   },
   "devDependencies": {
-    "@agoric/kmarshal": "0.1.1-upgrade-17-dev-a1453b2.0+a1453b2",
-    "@agoric/swing-store": "0.9.2-upgrade-17-dev-a1453b2.0+a1453b2",
-    "@agoric/swingset-liveslots": "0.10.3-upgrade-17-dev-a1453b2.0+a1453b2",
-    "@agoric/swingset-vat": "0.33.0-upgrade-17-dev-a1453b2.0+a1453b2",
-    "@endo/init": "^1.1.4",
-    "@endo/ses-ava": "^1.2.5",
+    "@agoric/kmarshal": "0.1.1-upgrade-18-dev-bf39b10.0+bf39b10",
+    "@agoric/swing-store": "0.10.0-upgrade-18-dev-bf39b10.0+bf39b10",
+    "@agoric/swingset-liveslots": "0.10.3-upgrade-18-dev-bf39b10.0+bf39b10",
+    "@agoric/swingset-vat": "0.33.0-upgrade-18-dev-bf39b10.0+bf39b10",
+    "@endo/init": "^1.1.6",
+    "@endo/ses-ava": "^1.2.7",
     "ava": "^5.3.0",
     "c8": "^9.1.0"
   },
@@ -76,7 +76,7 @@
     "timeout": "2m"
   },
   "typeCoverage": {
-    "atLeast": 90.33
+    "atLeast": 90.71
   },
-  "gitHead": "a1453b2877b017a7f5b43a92364067d001901953"
+  "gitHead": "bf39b100f0da4380bab0ce2464aaca1988f0b76a"
 }

package/src/asyncIterableAdaptor.d.ts

@@ -34,9 +34,9 @@
  * @returns {ForkableAsyncIterable<T>}
  */
 export const makeAsyncIterableFromNotifier: <T_1>(topic: ERef<LatestTopic<T_1>>) => {
-    [Symbol.asyncIterator]: () => import("../src/types.js").ForkableAsyncIterableIterator<T_1, T_1>;
+    [Symbol.asyncIterator]: () => import("./types-index.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>;
+    [Symbol.asyncIterator]: () => import("./types-index.js").ForkableAsyncIterableIterator<T_1, T_1>;
 }>;
 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>;

package/src/index.d.ts

@@ -1,7 +1,7 @@
 export { makePinnedHistoryTopic } from "./topic.js";
 export * from "./storesub.js";
 export * from "./stored-notifier.js";
-export * from "./types.js";
+export * from "./types-index.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

@@ -28,5 +28,5 @@ export {
 export * from './storesub.js';
 export * from './stored-notifier.js';
 
-// eslint-disable-next-line import/export -- doesn't know types
-export * from './types.js';
+// eslint-disable-next-line import/export
+export * from './types-index.js'; // no named exports in JS

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

@@ -1 +1 @@
-{"version":3,"file":"publish-kit.d.ts","sourceRoot":"","sources":["publish-kit.js"],"names":[],"mappings":"AAuBA;;;;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;;yBA3JsB,WAAW;;;;;;;;;;GAsOjD;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;;gCAjPsI,iBAAiB;+BAAjB,iBAAiB"}
+{"version":3,"file":"publish-kit.d.ts","sourceRoot":"","sources":["publish-kit.js"],"names":[],"mappings":"AAuBA;;;;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;;;;;;;;;;;;GA2EhB;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;;gCAjPsI,iBAAiB;+BAAjB,iBAAiB"}

package/src/subscribe.d.ts

@@ -1,28 +1,28 @@
 export function subscribe<T>(itP: ERef<AsyncIterableIterator<T>>): {
     [Symbol.asyncIterator]: () => {
-        [Symbol.asyncIterator]: () => any & import("@endo/marshal").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, any>;
+        [Symbol.asyncIterator]: () => any & import("@endo/pass-style").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, any>;
         next: () => Promise<IteratorResult<T, 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>;
+    } & import("@endo/pass-style").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
+        [Symbol.asyncIterator]: () => any & import("@endo/pass-style").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, any>;
         next: () => Promise<IteratorResult<T, any>>;
     }>;
-} & import("@endo/marshal").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
+} & import("@endo/pass-style").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
     [Symbol.asyncIterator]: () => {
-        [Symbol.asyncIterator]: () => any & import("@endo/marshal").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, any>;
+        [Symbol.asyncIterator]: () => any & import("@endo/pass-style").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, any>;
         next: () => Promise<IteratorResult<T, 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>;
+    } & import("@endo/pass-style").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
+        [Symbol.asyncIterator]: () => any & import("@endo/pass-style").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>;
-} & import("@endo/marshal").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
+} & import("@endo/pass-style").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>;
-} & import("@endo/marshal").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
+} & import("@endo/pass-style").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
     [Symbol.asyncIterator]: () => ForkableAsyncIterableIterator<T, T>;
 }>;
 import type { ERef } from '@endo/far';

package/src/types-index.d.ts

@@ -0,0 +1,2 @@
+// Export all the types this package provides
+export type * from './types.js';

package/src/types-index.js

@@ -0,0 +1,2 @@
+// Empty JS file to correspond with its .d.ts twin
+export {};

package/src/types.d.ts

@@ -1,3 +1,4 @@
+import type { StoredFacet, Unserializer, VStorageKey } from '@agoric/internal/src/lib-chainStorage.js';
 /**
  * An AsyncIterator that can be forked at a given position
  * into multiple independent ForkableAsyncIterators starting from that position.
@@ -135,11 +136,11 @@ export type StoredPublishKit<T> = {
  * 'mandatory' is the only currently-supported value, and others must not be
  * enabled without test coverage.
  */
-export type DurablePublishKitValueDurability = "mandatory" | "opportunistic" | "ignored";
+export type DurablePublishKitValueDurability = 'mandatory' | 'opportunistic' | 'ignored';
 export type DurablePublishKitState = {
     valueDurability: DurablePublishKitValueDurability;
     publishCount: bigint;
-    status: "live" | "finished" | "failed";
+    status: 'live' | 'finished' | 'failed';
     /**
      * hasValue indicates the presence of value. It starts off false,
      * and can be reset to false when a durable publish kit is restored and
@@ -172,7 +173,7 @@ export type NotifierInternals<T> = BaseNotifier<T>;
 /**
  * an object that can be used to get the current state or updates
  */
-export type Notifier<T> = import("@endo/marshal").RemotableObject & NotifierInternals<T> & ForkableAsyncIterable<T, T> & SharableNotifier<T>;
+export type Notifier<T> = import('@endo/marshal').RemotableObject & NotifierInternals<T> & ForkableAsyncIterable<T, T> & SharableNotifier<T>;
 export type SharableNotifier<T> = {
     /**
      * Used to replicate the multicast values at other sites. To manually create a
@@ -193,7 +194,7 @@ export type NotifierRecord<T> = {
     /**
      * the (closely-held) notifier producer
      */
-    updater: import("@endo/marshal").RemotableObject & IterationObserver<T>;
+    updater: import('@endo/marshal').RemotableObject & IterationObserver<T>;
     /**
      * the (widely-held) notifier consumer
      */
@@ -227,6 +228,4 @@ export type StoredSubscription<T> = Subscription<T> & {
     getUnserializer: () => Unserializer;
 };
 export type StoredSubscriber<T> = Subscriber<T> & StoredFacet;
-import type { Unserializer } from '@agoric/internal/src/lib-chainStorage.js';
-import type { StoredFacet } from '@agoric/internal/src/lib-chainStorage.js';
 //# sourceMappingURL=types.d.ts.map

package/src/types.d.ts.map

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

package/src/types.ts

@@ -0,0 +1,254 @@
+/* eslint-disable no-use-before-define */
+import type {
+  StoredFacet,
+  Unserializer,
+  VStorageKey,
+} from '@agoric/internal/src/lib-chainStorage.js';
+
+/**
+ * An AsyncIterator that can be forked at a given position
+ * into multiple independent ForkableAsyncIterators starting from that position.
+ */
+export type ForkableAsyncIterator<
+  T,
+  TReturn = any,
+  TNext = undefined,
+> = AsyncIterator<T, TReturn, TNext> & {
+  fork(): ForkableAsyncIterator<T, TReturn, TNext>;
+};
+export type AsyncIterableOnly<T, TReturn = any, TNext = undefined> = {
+  [Symbol.asyncIterator](): AsyncIterableIterator<T, TReturn, TNext>;
+};
+export type ForkableAsyncIterableIterator<
+  T,
+  TReturn = any,
+  TNext = undefined,
+> = {
+  [Symbol.asyncIterator](): ForkableAsyncIterableIterator<T, TReturn, TNext>;
+  fork(): ForkableAsyncIterableIterator<T, TReturn, TNext>;
+} & ForkableAsyncIterator<T, TReturn, TNext>;
+/**
+ * An AsyncIterable that produces ForkableAsyncIterators.
+ */
+export type ForkableAsyncIterable<T, TReturn = any, TNext = undefined> = {
+  [Symbol.asyncIterator]: () => ForkableAsyncIterator<T, TReturn, TNext>;
+};
+/**
+ * A valid sequence of calls to the methods of an `IterationObserver`
+ * represents an iteration. A valid sequence consists of any number of calls
+ * to `updateState` with the successive non-final values, followed by a
+ * final call to either `finish` with a successful `completion` value
+ * or `fail` with the alleged `reason` for failure. After at most one
+ * terminating calls, no further calls to these methods are valid and must be
+ * rejected.
+ */
+export type IterationObserver<T> = {
+  updateState: (nonFinalValue: T) => void;
+  finish: (completion: T) => void;
+  fail: (reason: unknown) => void;
+};
+/**
+ * Will be shared between machines, so it must be safe to expose. But software
+ * outside the current package should consider it opaque, not depending on its
+ * internal structure.
+ */
+export type PublicationRecord<T> = {
+  head: IteratorResult<T>;
+  /**
+   * starts at 1 for the first result
+   * and advances by 1 for each subsequent result
+   */
+  publishCount: bigint;
+  tail: Promise<PublicationRecord<T>>;
+};
+export type EachTopic<T> = {
+  /**
+   * Returns a promise for a "current" PublicationRecord (referencing its
+   * immediate successor via a `tail` promise) that is later than the
+   * provided publishCount.
+   * Used to make forward-lossless ("each") iterators.
+   */
+  subscribeAfter: (publishCount?: bigint) => Promise<PublicationRecord<T>>;
+};
+/**
+ * An EachTopic with default asyncIterable behaviour.
+ *
+ * NOTE: the publication records and iterators returned by this object are
+ * ephemeral and will be severed during upgrade.  A caller should use
+ * `subscribeEach` to wrap this topic in a local iterable which automatically
+ * attempts to reconnect upon being severed.
+ */
+export type IterableEachTopic<T> = ForkableAsyncIterable<T, T> & EachTopic<T>;
+/**
+ * A LatestTopic with default asyncIterable behaviour.
+ *
+ * NOTE: the iterators returned by this object are ephemeral and will be severed
+ * during upgrade.  A caller should use `subscribeLatest` to wrap this topic in
+ * a local iterable which automatically attempts to reconnect upon being
+ * severed.
+ */
+export type IterableLatestTopic<T> = AsyncIterableOnly<T, T> & LatestTopic<T>;
+export type LatestTopic<T> = {
+  /**
+   * Returns a promise for an update record as of an update count.
+   * If the `updateCount` argument is omitted or differs from the current update count,
+   * the promise promptly resolves to the current record.
+   * Otherwise, after the next state change, the promise resolves to the resulting record.
+   * This is an attenuated form of `subscribeAfter` whose return value stands alone and
+   * does not allow consumers to pin a chain of historical PublicationRecords.
+   * Used to make lossy ("latest") iterators.
+   * NOTE: Use of `number` as an `updateCount` is deprecated.
+   */
+  getUpdateSince: (updateCount?: bigint | number) => Promise<UpdateRecord<T>>;
+};
+/**
+ * This type is deprecated but is still
+ * used externally.
+ */
+export type BaseNotifier<T> = LatestTopic<T>;
+/**
+ * A stream of results that allows consumers to configure
+ * forward-lossless "each" iteration with `subscribeEach` and
+ * lossy "latest" iteration with `subscribeLatest`.
+ */
+export type Subscriber<T> = LatestTopic<T> & EachTopic<T>;
+/**
+ * A valid sequence of calls to the methods of an `IterationObserver`
+ * represents an iteration. A valid sequence consists of any number of calls
+ * to `publish` with the successive non-final values, followed by a
+ * final call to either `finish` with a successful `completion` value
+ * or `fail` with the alleged `reason` for failure. After at most one
+ * terminating calls, no further calls to these methods are valid and must be
+ * rejected.
+ */
+export type Publisher<T> = {
+  publish: (nonFinalValue: T) => void;
+  finish: (completion: T) => void;
+  fail: (reason: any) => void;
+};
+export type PublishObserver<T> = Partial<Publisher<T>>;
+export type PublishKit<T> = {
+  publisher: Publisher<T>;
+  subscriber: Subscriber<T>;
+};
+export type StoredPublishKit<T> = {
+  publisher: Publisher<T>;
+  subscriber: StoredSubscriber<T>;
+};
+/**
+ * Durability configures constraints on non-terminal values that can be
+ * published to a durable publish kit (terminal values sent to finish or fail
+ * must always be durable).
+ * - 'mandatory' means that each value must be durable, so it can be restored
+ *   on upgrade.
+ * - 'opportunistic' means that a durable value is persisted for post-upgrade
+ *   restoration, but a non-durable value is still accepted (and will result in
+ *   valueless restoration).
+ * - 'ignored' means that a value is not persisted for restoration even if it
+ *   is durable.
+ *
+ * 'mandatory' is the only currently-supported value, and others must not be
+ * enabled without test coverage.
+ */
+export type DurablePublishKitValueDurability =
+  | 'mandatory'
+  | 'opportunistic'
+  | 'ignored';
+export type DurablePublishKitState = {
+  valueDurability: DurablePublishKitValueDurability;
+  publishCount: bigint;
+  status: 'live' | 'finished' | 'failed';
+  /**
+   * hasValue indicates the presence of value. It starts off false,
+   * and can be reset to false when a durable publish kit is restored and
+   * the previous value was not durable, or non-terminal and valueDurablity is 'ignored'.
+   */
+  hasValue: boolean;
+  /**
+   * value holds either a non-terminal value from `publish` or a terminal value
+   * from `finish` or `fail`, depending upon the value in status.
+   */
+  value: any;
+};
+export type UpdateRecord<T> = {
+  /**
+   * is whatever state the service wants to publish
+   */
+  value: T;
+  /**
+   * is a value that identifies the update.  For
+   * the last update, it is `undefined`.
+   */
+  updateCount?: bigint | undefined;
+};
+/**
+ * Will be shared between machines,
+ * so it must be safe to expose. But other software should avoid depending on
+ * its internal structure.
+ */
+export type NotifierInternals<T> = BaseNotifier<T>;
+/**
+ * an object that can be used to get the current state or updates
+ */
+export type Notifier<T> = import('@endo/marshal').RemotableObject &
+  NotifierInternals<T> &
+  ForkableAsyncIterable<T, T> &
+  SharableNotifier<T>;
+export type SharableNotifier<T> = {
+  /**
+   * Used to replicate the multicast values at other sites. To manually create a
+   * local representative of a Notification, do
+   * ```js
+   * localIterable =
+   *   makeNotifier(E(remoteIterable).getSharableNotifierInternals());
+   * ```
+   * The resulting `localIterable` also supports such remote use, and
+   * will return access to the same representation.
+   */
+  getSharableNotifierInternals: () => Promise<NotifierInternals<T>>;
+};
+/**
+ * the produced notifier/updater pair
+ */
+export type NotifierRecord<T> = {
+  /**
+   * the (closely-held) notifier producer
+   */
+  updater: import('@endo/marshal').RemotableObject & IterationObserver<T>;
+  /**
+   * the (widely-held) notifier consumer
+   */
+  notifier: Notifier<T>;
+};
+/**
+ * A form of AsyncIterable supporting distributed and multicast usage.
+ */
+export type Subscription<T> = IterableEachTopic<T> &
+  EachTopic<T> &
+  SharableSubscription<T>;
+export type SharableSubscription<T> = {
+  /**
+   * Used to replicate the multicast values at other sites. To manually create a
+   * local representative of a Subscription, do
+   * ```js
+   * localIterable =
+   *   makeSubscription(E(remoteIterable).getSharableSubscriptionInternals());
+   * ```
+   * The resulting `localIterable` also supports such remote use, and
+   * will return access to the same representation.
+   */
+  getSharableSubscriptionInternals: () => Promise<EachTopic<T>>;
+};
+export type SubscriptionRecord<T> = {
+  publication: IterationObserver<T>;
+  subscription: Subscription<T>;
+};
+export type StoredSubscription<T> = Subscription<T> & {
+  getStoreKey: () => Promise<
+    VStorageKey & {
+      subscription: Subscription<T>;
+    }
+  >;
+  getUnserializer: () => Unserializer;
+};
+export type StoredSubscriber<T> = Subscriber<T> & StoredFacet;

package/src/types.js

@@ -1,300 +0,0 @@
-// @jessie-check
-
-/**
- * @import {StoredFacet, Unserializer} from '@agoric/internal/src/lib-chainStorage.js';
- */
-
-// Ensure this is a module.
-export {};
-
-/**
- * @template T
- * @template [TReturn=any]
- * @template [TNext=undefined]
- * @typedef {AsyncIterator<T, TReturn, TNext> & {
- *   fork(): ForkableAsyncIterator<T, TReturn, TNext>
- * }} ForkableAsyncIterator An AsyncIterator that can be forked at a given position
- * into multiple independent ForkableAsyncIterators starting from that position.
- */
-
-/**
- * @template T
- * @template [TReturn=any]
- * @template [TNext=undefined]
- * @typedef {{ [Symbol.asyncIterator](): AsyncIterableIterator<T, TReturn, TNext> }} AsyncIterableOnly
- */
-
-/**
- * @template T
- * @template [TReturn=any]
- * @template [TNext=undefined]
- * @typedef {{
- *   [Symbol.asyncIterator](): ForkableAsyncIterableIterator<T, TReturn, TNext>,
- *   fork(): ForkableAsyncIterableIterator<T, TReturn, TNext> } &
- *   ForkableAsyncIterator<T, TReturn, TNext>
- * } ForkableAsyncIterableIterator
- */
-
-/**
- * @template T
- * @template [TReturn=any]
- * @template [TNext=undefined]
- * @typedef {{
- *   [Symbol.asyncIterator]: () => ForkableAsyncIterator<T, TReturn, TNext>
- * }} ForkableAsyncIterable
- * An AsyncIterable that produces ForkableAsyncIterators.
- */
-
-/**
- * @template T
- * @typedef {object} IterationObserver
- * A valid sequence of calls to the methods of an `IterationObserver`
- * represents an iteration. A valid sequence consists of any number of calls
- * to `updateState` with the successive non-final values, followed by a
- * final call to either `finish` with a successful `completion` value
- * or `fail` with the alleged `reason` for failure. After at most one
- * terminating calls, no further calls to these methods are valid and must be
- * rejected.
- * @property {(nonFinalValue: T) => void} updateState
- * @property {(completion: T) => void} finish
- * @property {(reason: unknown) => void} fail
- */
-
-// /////////////////////////////////////////////////////////////////////////////
-
-/**
- * @template T
- * @typedef {object} PublicationRecord
- * Will be shared between machines, so it must be safe to expose. But software
- * outside the current package should consider it opaque, not depending on its
- * internal structure.
- * @property {IteratorResult<T>} head
- * @property {bigint} publishCount starts at 1 for the first result
- *   and advances by 1 for each subsequent result
- * @property {Promise<PublicationRecord<T>>} tail
- */
-
-/**
- * @template T
- * @typedef {object} EachTopic
- * @property {(publishCount?: bigint) => Promise<PublicationRecord<T>>} subscribeAfter
- * Returns a promise for a "current" PublicationRecord (referencing its
- * immediate successor via a `tail` promise) that is later than the
- * provided publishCount.
- * Used to make forward-lossless ("each") iterators.
- */
-
-/**
- * @template T
- * @typedef {ForkableAsyncIterable<T, T> & EachTopic<T>} IterableEachTopic
- * An EachTopic with default asyncIterable behaviour.
- *
- * NOTE: the publication records and iterators returned by this object are
- * ephemeral and will be severed during upgrade.  A caller should use
- * `subscribeEach` to wrap this topic in a local iterable which automatically
- * attempts to reconnect upon being severed.
- */
-
-/**
- * @template T
- * @typedef {AsyncIterableOnly<T, T> & LatestTopic<T>} IterableLatestTopic
- * A LatestTopic with default asyncIterable behaviour.
- *
- * NOTE: the iterators returned by this object are ephemeral and will be severed
- * during upgrade.  A caller should use `subscribeLatest` to wrap this topic in
- * a local iterable which automatically attempts to reconnect upon being
- * severed.
- */
-
-/**
- * @template T
- * @typedef {object} LatestTopic
- * @property {(updateCount?: bigint | number) => Promise<UpdateRecord<T>>} getUpdateSince
- * Returns a promise for an update record as of an update count.
- * If the `updateCount` argument is omitted or differs from the current update count,
- * the promise promptly resolves to the current record.
- * Otherwise, after the next state change, the promise resolves to the resulting record.
- * This is an attenuated form of `subscribeAfter` whose return value stands alone and
- * does not allow consumers to pin a chain of historical PublicationRecords.
- * Used to make lossy ("latest") iterators.
- * NOTE: Use of `number` as an `updateCount` is deprecated.
- */
-
-/**
- * @template T
- * @typedef {LatestTopic<T>} BaseNotifier This type is deprecated but is still
- * used externally.
- */
-
-/**
- * @template T
- * @typedef {LatestTopic<T> & EachTopic<T>} Subscriber
- * A stream of results that allows consumers to configure
- * forward-lossless "each" iteration with `subscribeEach` and
- * lossy "latest" iteration with `subscribeLatest`.
- */
-
-/**
- * @template T
- * @typedef {object} Publisher
- * A valid sequence of calls to the methods of an `IterationObserver`
- * represents an iteration. A valid sequence consists of any number of calls
- * to `publish` with the successive non-final values, followed by a
- * final call to either `finish` with a successful `completion` value
- * or `fail` with the alleged `reason` for failure. After at most one
- * terminating calls, no further calls to these methods are valid and must be
- * rejected.
- * @property {(nonFinalValue: T) => void} publish
- * @property {(completion: T) => void} finish
- * @property {(reason: any) => void} fail
- */
-
-/**
- * @template T
- * @typedef {Partial<Publisher<T>>} PublishObserver
- */
-
-/**
- * @template T
- * @typedef {object} PublishKit
- * @property {Publisher<T>} publisher
- * @property {Subscriber<T>} subscriber
- */
-
-/**
- * @template T
- * @typedef {object} StoredPublishKit
- * @property {Publisher<T>} publisher
- * @property {StoredSubscriber<T>} subscriber
- */
-
-// /////////////////////////////////////////////////////////////////////////////
-
-/**
- * @typedef {'mandatory' | 'opportunistic' | 'ignored'} DurablePublishKitValueDurability
- *
- * Durability configures constraints on non-terminal values that can be
- * published to a durable publish kit (terminal values sent to finish or fail
- * must always be durable).
- * - 'mandatory' means that each value must be durable, so it can be restored
- *   on upgrade.
- * - 'opportunistic' means that a durable value is persisted for post-upgrade
- *   restoration, but a non-durable value is still accepted (and will result in
- *   valueless restoration).
- * - 'ignored' means that a value is not persisted for restoration even if it
- *   is durable.
- *
- * 'mandatory' is the only currently-supported value, and others must not be
- * enabled without test coverage.
- */
-
-/**
- * @typedef {object} DurablePublishKitState
- *
- * @property {DurablePublishKitValueDurability} valueDurability
- *
- * @property {bigint} publishCount
- *
- * @property {'live' | 'finished' | 'failed'} status
- *
- * @property {boolean} hasValue
- * hasValue indicates the presence of value. It starts off false,
- * and can be reset to false when a durable publish kit is restored and
- * the previous value was not durable, or non-terminal and valueDurablity is 'ignored'.
- *
- * @property {any} value
- * value holds either a non-terminal value from `publish` or a terminal value
- * from `finish` or `fail`, depending upon the value in status.
- */
-
-// /////////////////////////////////////////////////////////////////////////////
-
-/**
- * @template T
- * @typedef {object} UpdateRecord
- * @property {T} value is whatever state the service wants to publish
- * @property {bigint} [updateCount] is a value that identifies the update.  For
- * the last update, it is `undefined`.
- */
-
-/**
- * @template T
- * @typedef {BaseNotifier<T>} NotifierInternals Will be shared between machines,
- * so it must be safe to expose. But other software should avoid depending on
- * its internal structure.
- */
-
-/**
- * @template T
- * @typedef {import('@endo/marshal').RemotableObject & NotifierInternals<T> &
- *   ForkableAsyncIterable<T, T> &
- *   SharableNotifier<T>
- * } Notifier an object that can be used to get the current state or updates
- */
-
-/**
- * @template T
- * @typedef {object} SharableNotifier
- * @property {() => Promise<NotifierInternals<T>>} getSharableNotifierInternals
- * Used to replicate the multicast values at other sites. To manually create a
- * local representative of a Notification, do
- * ```js
- * localIterable =
- *   makeNotifier(E(remoteIterable).getSharableNotifierInternals());
- * ```
- * The resulting `localIterable` also supports such remote use, and
- * will return access to the same representation.
- */
-
-/**
- * @template T
- * @typedef {object} NotifierRecord the produced notifier/updater pair
- * @property {import('@endo/marshal').RemotableObject & IterationObserver<T>} updater the (closely-held) notifier producer
- * @property {Notifier<T>} notifier the (widely-held) notifier consumer
- */
-
-// /////////////////////////////////////////////////////////////////////////////
-
-/**
- * @template T
- * @typedef {IterableEachTopic<T> & EachTopic<T> &
- *   SharableSubscription<T>} Subscription
- * A form of AsyncIterable supporting distributed and multicast usage.
- */
-
-/**
- * @template T
- * @typedef {object} SharableSubscription
- * @property {() => Promise<EachTopic<T>>} getSharableSubscriptionInternals
- * Used to replicate the multicast values at other sites. To manually create a
- * local representative of a Subscription, do
- * ```js
- * localIterable =
- *   makeSubscription(E(remoteIterable).getSharableSubscriptionInternals());
- * ```
- * The resulting `localIterable` also supports such remote use, and
- * will return access to the same representation.
- */
-
-/**
- * @template T
- * @typedef {object} SubscriptionRecord
- * @property {IterationObserver<T>} publication
- * @property {Subscription<T>} subscription
- */
-
-// /////////////////////////////////////////////////////////////////////////////
-
-/**
- * @deprecated use StoredSubscriber
- * @template T
- * @typedef {Subscription<T> & {
- *   getStoreKey: () => Promise<VStorageKey & { subscription: Subscription<T> }>,
- *   getUnserializer: () => Unserializer,
- * }} StoredSubscription
- */
-
-/**
- * @template T
- * @typedef {Subscriber<T> & StoredFacet} StoredSubscriber
- */