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

package/src/types-ambient.d.ts

@@ -1,301 +0,0 @@
-type ERef<T> = import('@endo/far').ERef<T>;
-type PromiseKit<T> = import('@endo/promise-kit').PromiseKit<T>;
-/**
- * Deprecated. Use PromiseKit instead.
- */
-type PromiseRecord<T> = import('@endo/promise-kit').PromiseRecord<T>;
-/**
- * An AsyncIterator that can be forked at a given position
- * into multiple independent ForkableAsyncIterators starting from that position.
- */
-type ForkableAsyncIterator<T, TReturn = any, TNext = undefined> = AsyncIterator<T, TReturn, TNext> & {
-    fork(): ForkableAsyncIterator<T, TReturn, TNext>;
-};
-type AsyncIterableOnly<T, TReturn = any, TNext = undefined> = {
-    [Symbol.asyncIterator](): AsyncIterableIterator<T, TReturn, TNext>;
-};
-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.
- */
-type ForkableAsyncIterable<T, TReturn = any, TNext = undefined> = {
-    [Symbol.asyncIterator]: () => ForkableAsyncIterator<T, TReturn, TNext>;
-};
-/**
- * <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 `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.
- */
-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.
- */
-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>>;
-};
-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.
- */
-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.
- */
-type IterableLatestTopic<T> = AsyncIterableOnly<T, T> & LatestTopic<T>;
-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.
- */
-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`.
- */
-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.
- */
-type Publisher<T> = {
-    publish: (nonFinalValue: T) => void;
-    finish: (completion: T) => void;
-    fail: (reason: any) => void;
-};
-type PublishObserver<T> = Partial<Publisher<T>>;
-/**
- * <T>
- */
-type PublishKit<T> = {
-    publisher: Publisher<T>;
-    subscriber: Subscriber<T>;
-};
-/**
- * <T>
- */
-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.
- */
-type DurablePublishKitValueDurability = 'mandatory' | 'opportunistic' | 'ignored';
-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;
-};
-/**
- * <T>
- */
-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.
- */
-type NotifierInternals<T> = BaseNotifier<T>;
-/**
- * <T> an object that can be used to get the current state or updates
- */
-type Notifier<T> = NotifierInternals<T> & ForkableAsyncIterable<T, T> & SharableNotifier<T>;
-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>>;
-};
-/**
- * <T> the produced notifier/updater pair
- */
-type NotifierRecord<T> = {
-    /**
-     * the (closely-held) notifier producer
-     */
-    updater: IterationObserver<T>;
-    /**
-     * the (widely-held) notifier consumer
-     */
-    notifier: Notifier<T>;
-};
-/**
- * <T>
- * A form of AsyncIterable supporting distributed and multicast usage.
- */
-type Subscription<T> = IterableEachTopic<T> & EachTopic<T> & SharableSubscription<T>;
-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>>;
-};
-/**
- * <T>
- */
-type SubscriptionRecord<T> = {
-    publication: IterationObserver<T>;
-    subscription: Subscription<T>;
-};
-type Marshaller<Slot = unknown> = import('@endo/marshal').Marshal<Slot>;
-type Unserializer = Pick<Marshaller, 'fromCapData'>;
-/**
- * Defined by vstorageStoreKey in vstorage.go
- */
-type VStorageKey = {
-    storeName: string;
-    storeSubkey: string;
-    dataPrefixBytes: string;
-    noDataValue?: string | undefined;
-};
-/**
- * This represents a node in an IAVL tree.
- *
- * The active implementation is x/vstorage, an Agoric extension of the Cosmos SDK.
- *
- * Vstorage is a hierarchical externally-reachable storage structure that
- * identifies children by restricted ASCII name and is associated with arbitrary
- * string-valued data for each node, defaulting to the empty string.
- */
-type StorageNode = {
-    /**
-     * publishes some data (append to the node)
-     */
-    setValue: (data: string) => Promise<void>;
-    /**
-     * the chain storage path at which the node was constructed
-     */
-    getPath: () => string;
-    /**
-     * DEPRECATED use getPath
-     */
-    getStoreKey: () => Promise<VStorageKey>;
-    makeChildNode: (subPath: string, options?: {
-        sequence?: boolean;
-    }) => StorageNode;
-};
-type StoredFacet = {
-    /**
-     * the chain storage path at which the node was constructed
-     */
-    getPath: () => Promise<string>;
-    /**
-     * DEPRECATED use getPath
-     */
-    getStoreKey: StorageNode['getStoreKey'];
-    /**
-     * get the unserializer for the stored data
-     */
-    getUnserializer: () => Unserializer;
-};
-type StoredSubscription<T> = Subscription<T> & {
-    getStoreKey: () => Promise<VStorageKey & {
-        subscription: Subscription<T>;
-    }>;
-    getUnserializer: () => Unserializer;
-};
-type StoredSubscriber<T> = Subscriber<T> & StoredFacet;
-//# sourceMappingURL=types-ambient.d.ts.map

package/src/types-ambient.d.ts.map

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

package/src/types-ambient.js

@@ -1,346 +0,0 @@
-// @jessie-check
-
-/**
- * @template T
- * @typedef {import('@endo/far').ERef<T>} ERef
- */
-
-/**
- * @template T
- * @typedef {import('@endo/promise-kit').PromiseKit<T>} PromiseKit
- */
-
-/**
- * Deprecated. Use PromiseKit instead.
- *
- * @template T
- * @typedef {import('@endo/promise-kit').PromiseRecord<T>} PromiseRecord
- */
-
-/**
- * @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<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 `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<T>
- * @property {Publisher<T>} publisher
- * @property {Subscriber<T>} subscriber
- */
-
-/**
- * @template T
- * @typedef {object} StoredPublishKit<T>
- * @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<T>
- * @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 {NotifierInternals<T> &
- *   ForkableAsyncIterable<T, T> &
- *   SharableNotifier<T>
- * } Notifier<T> 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<T> the produced notifier/updater pair
- * @property {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<T>
- * 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<T>
- * @property {IterationObserver<T>} publication
- * @property {Subscription<T>} subscription
- */
-
-// /////////////////////////////////////////////////////////////////////////////
-
-/** @template [Slot=unknown] @typedef {import('@endo/marshal').Marshal<Slot>} Marshaller */
-/** @typedef {Pick<Marshaller, 'fromCapData'>} Unserializer */
-
-/**
- * Defined by vstorageStoreKey in vstorage.go
- *
- * @typedef VStorageKey
- * @property {string} storeName
- * @property {string} storeSubkey
- * @property {string} dataPrefixBytes
- * @property {string} [noDataValue]
- */
-
-/**
- * This represents a node in an IAVL tree.
- *
- * The active implementation is x/vstorage, an Agoric extension of the Cosmos SDK.
- *
- * Vstorage is a hierarchical externally-reachable storage structure that
- * identifies children by restricted ASCII name and is associated with arbitrary
- * string-valued data for each node, defaulting to the empty string.
- *
- * @typedef {object} StorageNode
- * @property {(data: string) => Promise<void>} setValue publishes some data (append to the node)
- * @property {() => string} getPath the chain storage path at which the node was constructed
- * @property {() => Promise<VStorageKey>} getStoreKey DEPRECATED use getPath
- * @property {(subPath: string, options?: {sequence?: boolean}) => StorageNode} makeChildNode
- */
-
-/**
- * @typedef {object} StoredFacet
- * @property {() => Promise<string>} getPath the chain storage path at which the node was constructed
- * @property {StorageNode['getStoreKey']} getStoreKey DEPRECATED use getPath
- * @property {() => Unserializer} getUnserializer get the unserializer for the stored data
- */
-
-/**
- * @deprecated use StoredSubscriber
- * @template T
- * @typedef {Subscription<T> & {
- *   getStoreKey: () => Promise<VStorageKey & { subscription: Subscription<T> }>,
- *   getUnserializer: () => Unserializer,
- * }} StoredSubscription
- */
-
-/**
- * @template T
- * @typedef {Subscriber<T> & StoredFacet} StoredSubscriber
- */