diff --git a/CHANGES.md b/CHANGES.md index 2d6119e36..4eecd267f 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -192,9 +192,15 @@ To be released. loader, including portable `ap://`, `ap+ef61://`, and FEP-ef61-compatible HTTPS identifiers. Errors cloning embedded history propagate instead of triggering fallback. [[#1250], [#1396] by Jiwon Kwon\] + - Fixed ancestor discovery losing a loaded object's loader and verifier + defaults when its parsed target serializes differently from the loader + document. Rejected loads cannot transfer their defaults to embedded + targets with matching serialization. [[#1423], [#1445] by Jiwon Kwon\] [#1252]: https://github.com/fedify-dev/fedify/issues/1252 [#1416]: https://github.com/fedify-dev/fedify/pull/1416 +[#1423]: https://github.com/fedify-dev/fedify/issues/1423 +[#1445]: https://github.com/fedify-dev/fedify/pull/1445 ### @fedify/cfworkers @@ -624,6 +630,12 @@ To be released. into JSON-LD. The values are not verified, so validate them before use. [[#1272], [#1356]] + - Added `onAcceptedDocument` to plural dereferencing accessors. The + synchronous callback receives each newly fetched, accepted target and its + exact `RemoteDocument` before caching or yielding. Embedded targets and + cache hits do not trigger it. The `AcceptedDocumentCallback` type is + also exported. [[#1423], [#1445] by Jiwon Kwon\] + - Added the `attributionDomains` property to `Application`, `Group`, `Organization`, `Person`, and `Service`, so applications can publish the domains an actor claims for Mastodon's `fediverse:creator` link credits @@ -714,6 +726,9 @@ To be released. `@fedify/vocab-tools`. The writers accept the same `RawPropertyValue` shapes as the read functions, copy supplied JSON values, and reject malformed or cyclic input before decoding properties. [[#1355], [#1420]] + - Added the `AcceptedDocumentCallback` type for callbacks that receive a + fetched vocabulary target and the exact loader response accepted for it. + [[#1423], [#1445] by Jiwon Kwon\] - Added the [FEP-f799] context to the preloaded JSON-LD contexts. The default document loader now resolves locally, so otherwise valid inbound documents can be parsed or verified without @@ -734,6 +749,9 @@ To be released. can now use `"@container": "@set"` or `"@container": "@list"` to match their published JSON-LD contexts, while existing term definitions keep validating as before. [[#1234], [#1353]] + - Added an `onAcceptedDocument` option to generated plural dereferencing + accessors so applications can associate fetched targets with their exact + accepted loader responses. [[#1423], [#1445] by Jiwon Kwon\] - Added non-functional `redundantProperties` support with ordered fallback to the first non-empty value set, preserving lists and graphs without merging synonyms. Added `redundantPropertiesWrite: canonical` to write diff --git a/changes.d/backfill/accepted-ancestor-documents.md b/changes.d/backfill/accepted-ancestor-documents.md new file mode 100644 index 000000000..319d3d923 --- /dev/null +++ b/changes.d/backfill/accepted-ancestor-documents.md @@ -0,0 +1,9 @@ +--- +links: + '#1423': https://github.com/fedify-dev/fedify/issues/1423 + '#1445': https://github.com/fedify-dev/fedify/pull/1445 +--- + - Fixed ancestor discovery losing a loaded object's loader and verifier + defaults when its parsed target serializes differently from the loader + document. Rejected loads cannot transfer their defaults to embedded + targets with matching serialization. [[#1423], [#1445] by Jiwon Kwon] diff --git a/changes.d/vocab-runtime/accepted-document-callback.md b/changes.d/vocab-runtime/accepted-document-callback.md new file mode 100644 index 000000000..74cd446c3 --- /dev/null +++ b/changes.d/vocab-runtime/accepted-document-callback.md @@ -0,0 +1,8 @@ +--- +links: + '#1423': https://github.com/fedify-dev/fedify/issues/1423 + '#1445': https://github.com/fedify-dev/fedify/pull/1445 +--- + - Added the `AcceptedDocumentCallback` type for callbacks that receive a + fetched vocabulary target and the exact loader response accepted for it. + [[#1423], [#1445] by Jiwon Kwon] diff --git a/changes.d/vocab-tools/accepted-documents.md b/changes.d/vocab-tools/accepted-documents.md new file mode 100644 index 000000000..96765c2f3 --- /dev/null +++ b/changes.d/vocab-tools/accepted-documents.md @@ -0,0 +1,8 @@ +--- +links: + '#1423': https://github.com/fedify-dev/fedify/issues/1423 + '#1445': https://github.com/fedify-dev/fedify/pull/1445 +--- + - Added an `onAcceptedDocument` option to generated plural dereferencing + accessors so applications can associate fetched targets with their exact + accepted loader responses. [[#1423], [#1445] by Jiwon Kwon] diff --git a/changes.d/vocab/accepted-documents.md b/changes.d/vocab/accepted-documents.md new file mode 100644 index 000000000..6ddd6483a --- /dev/null +++ b/changes.d/vocab/accepted-documents.md @@ -0,0 +1,10 @@ +--- +links: + '#1423': https://github.com/fedify-dev/fedify/issues/1423 + '#1445': https://github.com/fedify-dev/fedify/pull/1445 +--- + - Added `onAcceptedDocument` to plural dereferencing accessors. The + synchronous callback receives each newly fetched, accepted target and its + exact `RemoteDocument` before caching or yielding. Embedded targets and + cache hits do not trigger it. The `AcceptedDocumentCallback` type is + also exported. [[#1423], [#1445] by Jiwon Kwon] diff --git a/claude-plugin/skills/fedify/SKILL.md b/claude-plugin/skills/fedify/SKILL.md index c939d52a2..e91b37d3d 100644 --- a/claude-plugin/skills/fedify/SKILL.md +++ b/claude-plugin/skills/fedify/SKILL.md @@ -365,6 +365,15 @@ embedded or cached objects without fetching references. Singular accessors return `null` when fetching is required; plural accessors skip those values. Origin and portable-object trust checks still apply. The default is `true`. +Plural dereferencing accessors also accept +`onAcceptedDocument(target, response)` to report the exact accepted loader +response before caching or yielding a newly fetched target. Embedded and cached +targets produce no event; unverified portable claims report every fetch. Use a +synchronous callback: exceptions propagate even with `suppressError`, and +promises are not awaited. Custom overrides must forward the option or report +accepted fetches themselves. See *docs/manual/vocab.md*, “Observing accepted +documents,” for the contract. + `clone()` is shallow: it copies property arrays but shares nested vocabulary objects and URLs. In Fedify 2.5.0 and later, use synchronous `deepClone()` to resolve nested properties without hydrating the source's objects. Replacement diff --git a/docs/manual/backfill.md b/docs/manual/backfill.md index 7879ebcb9..e9ef3988b 100644 --- a/docs/manual/backfill.md +++ b/docs/manual/backfill.md @@ -190,6 +190,13 @@ Per-object loader and portable-object verifier defaults remain effective regardless of strategy order. Discovery does not hydrate the seed or loaded ancestor objects. +If you override a vocabulary object's `getReplyTargets()` accessor, forward +the `onAcceptedDocument` option to the superclass accessor. If your override +fetches targets itself, invoke the callback for each accepted fetch so discovery +can preserve the source object's defaults. See +[Observing accepted documents](./vocab.md#observing-accepted-documents) for the +callback contract. + Ancestor discovery deep-clones the seed and loaded ancestors, including their embedded object graphs. Large embedded collections can therefore increase memory use and copying time independently of `maxDepth`. Objects yielded by diff --git a/docs/manual/vocab.md b/docs/manual/vocab.md index b81a01607..2fa61f50a 100644 --- a/docs/manual/vocab.md +++ b/docs/manual/vocab.md @@ -873,6 +873,52 @@ require fetching for verification are skipped. [`fetch()`]: https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API +### Observing accepted documents + +In Fedify 2.5.0 and later, plural dereferencing accessors accept an +`onAcceptedDocument` callback. It receives the parsed target and the exact +`RemoteDocument` returned by the document loader. When a portable lookup uses +gateways, this is the response from the gateway that succeeded. The callback +runs synchronously once per newly fetched, accepted instance, before the +accessor caches or yields it. + +~~~~ typescript twoslash +import type { Note, RemoteDocument } from "@fedify/vocab"; +declare const note: Note; +// ---cut-before--- +const acceptedResponses = new WeakMap(); +for await (const target of note.getReplyTargets({ + onAcceptedDocument(target, response) { + acceptedResponses.set(target, response); + }, +})) { + const response = acceptedResponses.get(target); + console.log(target.id?.href, response?.documentUrl); +} +~~~~ + +Embedded targets, cache hits, rejected documents, and calls with +`dereference: false` produce no callback. Only plural accessors support the +option: fetching through a singular accessor first also means a later plural +cache hit produces no callback. Install the callback before the first fetch +and retain your own target-to-response map if you need the association later. +The callback option is not inherited by fetched children. + +Acceptance does not imply proof verification. Unverified portable claims +that the accessor accepts are reported on every fetching pass because they +are not cached. + +Callback exceptions propagate even with `suppressError: true`. The target +remains uncached in the parent, so retrying fetches it again. Use a synchronous +callback: returned promises are not awaited, and their rejections are not +handled. + +Custom accessor overrides must forward the option when calling the superclass +accessor. An override that fetches and parses targets itself must invoke the +callback after accepting each target and before caching or yielding it. The +shared callback type, `AcceptedDocumentCallback`, is exported from +`@fedify/vocab` and `@fedify/vocab-runtime`. + Property hydration ------------------ diff --git a/packages/backfill/src/backfill.test.ts b/packages/backfill/src/backfill.test.ts index a5d4164d1..2f54e47ad 100644 --- a/packages/backfill/src/backfill.test.ts +++ b/packages/backfill/src/backfill.test.ts @@ -708,6 +708,66 @@ describe("ancestor collection discovery", () => { strictEqual(verifications, 1); }); + test("custom portable serialization retains the loaded ancestor's verifier", async () => { + const portableParent = parseIri("ap://did:key:z6Mkabc/parent"); + const portableRoot = parseIri("ap://did:key:z6Mkabc/root"); + let verifications = 0; + class Parent extends Note { + override toJsonLd() { + return Promise.resolve({ + "@context": "https://www.w3.org/ns/activitystreams", + type: "Note", + id: portableParent.href, + inReplyTo: portableRoot.href, + }); + } + } + let acceptedTarget: Note | undefined; + let acceptedDocument: unknown; + class Seed extends Note { + override async *getReplyTargets( + options: Parameters[0] = {}, + ) { + yield* super.getReplyTargets({ + ...options, + onAcceptedDocument: (target, response) => { + ok(target instanceof Note); + acceptedTarget = target; + acceptedDocument = response.document; + options.onAcceptedDocument?.(target, response); + }, + }); + } + } + const parent = new Parent( + { id: portableParent, replyTarget: portableRoot }, + { + verifyPortableObject: () => { + verifications++; + return Promise.resolve({ verified: false }); + }, + }, + ); + const context = loader([ + [parentId.href, parent], + [portableRoot.href, new Note({ id: portableRoot })], + ]); + const results = await collect( + context, + new Seed({ replyTarget: parentId }), + { + contextDiscovery: "ancestors", + }, + ); + ok(acceptedTarget != null); + const serialized = JSON.stringify(await acceptedTarget.toJsonLd()); + strictEqual(serialized === JSON.stringify(acceptedDocument), false); + ok(serialized.includes("ap+ef61://")); + deepStrictEqual(results, []); + deepStrictEqual(context.requests, [parentId.href, portableRoot.href]); + strictEqual(verifications, 1); + }); + test("custom fetching accessors retain source defaults without caching targets", async () => { const historyId = parseIri("ap://did:key:z6Mkabc/history"); const parent = await Note.fromJsonLd( @@ -732,7 +792,53 @@ describe("ancestor collection discovery", () => { ) { ok(options.documentLoader != null); const document = await options.documentLoader(parentId.href); - yield await Note.fromJsonLd(document.document); + const target = await Note.fromJsonLd(document.document); + options.onAcceptedDocument?.(target, document); + yield target; + } + } + const context = loader([[parentId.href, parent]]); + const results = await collect(context, new FetchingReply({}), { + contextDiscovery: "ancestors", + contextSource: "history-first", + }); + deepStrictEqual(results, []); + deepStrictEqual(context.requests, [parentId.href, historyId.href]); + }); + + test("accepted response identity preserves source policy when target serialization differs", async () => { + const historyId = parseIri("ap://did:key:z6Mkabc/history"); + const parent = await Note.fromJsonLd( + { + "@context": [ + "https://www.w3.org/ns/activitystreams", + "https://w3id.org/fep/171b", + ], + type: "Note", + id: parentId.href, + contextHistory: { + type: "OrderedCollection", + id: historyId.href, + orderedItems: [{ type: "Note", id: sibling.id!.href }], + }, + }, + { verifyPortableObject: () => Promise.resolve({ verified: false }) }, + ); + class FetchingReply extends Note { + override async *getReplyTargets( + options: Parameters[0] = {}, + ) { + ok(options.documentLoader != null); + const document = await options.documentLoader(parentId.href); + const parsed = await Note.fromJsonLd(document.document); + const target = parsed.clone({ content: "Transformed by the accessor" }); + strictEqual( + JSON.stringify(await target.toJsonLd()) === + JSON.stringify(document.document), + false, + ); + options.onAcceptedDocument?.(target, document); + yield target; } } const context = loader([[parentId.href, parent]]); diff --git a/packages/backfill/src/backfill.ts b/packages/backfill/src/backfill.ts index e59462175..10fbcb58e 100644 --- a/packages/backfill/src/backfill.ts +++ b/packages/backfill/src/backfill.ts @@ -7,12 +7,10 @@ import { Object as APObject, OrderedCollection, OrderedCollectionPage, + type RemoteDocument, } from "@fedify/vocab"; import { fromCompatibleEf61Id, parseIri } from "@fedify/vocab-runtime"; -import { - copyPortableProvenance, - isUnverifiedPortableClaim, -} from "@fedify/vocab-runtime/internal/portable-dereference"; +import { copyPortableProvenance } from "@fedify/vocab-runtime/internal/portable-dereference"; import type { BackfillContext, @@ -574,21 +572,16 @@ async function* getReplyTargets( | MaxRequestsExceeded | IntervalConfigurationError | undefined; - const loadedObjects = new Map(); - const observesGeneratedCache = - object.getReplyTargets === APObject.prototype.getReplyTargets; - let replyTargetIdsBeforeLoad: readonly URL[] | undefined; + const loadedObjects = + budget.discovery == null + ? undefined + : new WeakMap(); try { for await (const target of object.getReplyTargets({ // Skip vocabulary-level failures per target rather than closing the // iterator before its remaining reply targets can be explored. suppressError: true, documentLoader: async (url) => { - loadedObjects.clear(); - replyTargetIdsBeforeLoad = - budget.discovery == null || !observesGeneratedCache - ? undefined - : object.replyTargetIds; if (traversalError != null) throw traversalError; try { return await loadCollectionItemDocument( @@ -599,10 +592,10 @@ async function* getReplyTargets( skipIds, { onLoaded: - budget.discovery == null + loadedObjects == null ? undefined : (object, document) => { - loadedObjects.set(JSON.stringify(document), object); + loadedObjects.set(document, object); }, // Let suppressError skip unavailable references without caching // successful placeholders that would prevent later retries. @@ -623,34 +616,21 @@ async function* getReplyTargets( throw error; } }, + // Capture the source only after acceptance, and retain it across cached + // passes through ancestor discovery and reply-tree. + onAcceptedDocument: + loadedObjects == null + ? undefined + : (target, response) => { + const source = loadedObjects.get(response); + if (source != null && target instanceof APObject) { + budget.discovery?.sources.set(target, source); + } + }, crossOrigin: "trust", })) { budget.signal?.throwIfAborted(); if (traversalError != null) throw traversalError; - // Record provenance only after the vocabulary accessor accepts a target. - // Keep it across strategy passes, including targets cached by reply-tree. - // Match documents rather than IDs to support anonymous targets. - if (loadedObjects.size > 0 && target instanceof APObject) { - // A successful fetch changes cached URL identities, unless the target - // is an unverified portable claim. Otherwise, discard the stale source. - // Custom accessors keep their existing behavior pending exact association: - // https://github.com/fedify-dev/fedify/issues/1423 - const previousIds = replyTargetIdsBeforeLoad; - const currentIds = observesGeneratedCache ? object.replyTargetIds : []; - const fetched = - !observesGeneratedCache || - isUnverifiedPortableClaim(target) || - (previousIds != null && - (currentIds.length !== previousIds.length || - currentIds.some((id, i) => id !== previousIds[i]))); - if (fetched) { - const source = loadedObjects.get( - JSON.stringify(await target.toJsonLd()), - ); - if (source != null) budget.discovery?.sources.set(target, source); - } - } - loadedObjects.clear(); yield target; } budget.signal?.throwIfAborted(); @@ -883,7 +863,7 @@ async function loadCollectionItemDocument( onLoaded, skipUnavailable = true, }: { - onLoaded?: (object: APObject, document: unknown) => void; + onLoaded?: (object: APObject, response: RemoteDocument) => void; skipUnavailable?: boolean; } = {}, ) { @@ -909,12 +889,13 @@ async function loadCollectionItemDocument( return skippedCollectionItemDocument(url); } const document = await object.toJsonLd(); - onLoaded?.(object, document); - return { + const response: RemoteDocument = { contextUrl: null, documentUrl: url, document, }; + onLoaded?.(object, response); + return response; } function skippedCollectionItemDocument(url: string) { diff --git a/packages/vocab-runtime/src/docloader.ts b/packages/vocab-runtime/src/docloader.ts index b91aaa0de..9c5325455 100644 --- a/packages/vocab-runtime/src/docloader.ts +++ b/packages/vocab-runtime/src/docloader.ts @@ -224,6 +224,32 @@ async function bufferErrorResponse( }); } +/** + * Reports the exact loader response accepted for a fetched target. + * + * Called synchronously by plural accessors before caching or yielding a newly + * fetched target. Receives the original loader response, including the + * winning gateway's response for portable objects. Unverified portable + * claims trigger it on every fetch; acceptance does not imply verification. + * + * Not called for embedded targets, cache hits (including after a singular + * fetch), or `dereference: false`. Overrides must forward the option; + * fetched children do not inherit it. + * + * Exceptions propagate even with `suppressError`, leaving the target uncached + * so a retry fetches again. Use a synchronous callback: returned promises + * are not awaited, and their rejections are not handled. + * + * @typeParam T The target's vocabulary type. + * @param target The parsed target accepted by the accessor. + * @param response Loader response accepted for a fetched target. + * @since 2.5.0 + */ +export type AcceptedDocumentCallback = ( + target: T, + response: RemoteDocument, +) => void; + /** * Gets a {@link RemoteDocument} from the given response. * @param url The URL of the document to load. diff --git a/packages/vocab-runtime/src/internal/portable-dereference.ts b/packages/vocab-runtime/src/internal/portable-dereference.ts index 83c450d10..ce487e98e 100644 --- a/packages/vocab-runtime/src/internal/portable-dereference.ts +++ b/packages/vocab-runtime/src/internal/portable-dereference.ts @@ -735,6 +735,11 @@ export interface DereferencePortableIriOptions { * otherwise acceptable, in which case the next gateway is tried. */ observer?: DereferenceObserver; + /** + * Return exact response with the given callback. + * @since 2.5.0 + */ + onAcceptedResponse?: (response: RemoteDocument) => void; } /** @@ -1038,6 +1043,7 @@ export async function dereferencePortableIri( if (gateway != null) { span?.setAttribute("activitypub.gateway", gateway.href); } + options.onAcceptedResponse?.(remoteDocument); return object; } catch (error) { signal?.throwIfAborted(); diff --git a/packages/vocab-runtime/src/mod.ts b/packages/vocab-runtime/src/mod.ts index b3df2aa95..cba0b142f 100644 --- a/packages/vocab-runtime/src/mod.ts +++ b/packages/vocab-runtime/src/mod.ts @@ -15,6 +15,7 @@ export { type GetDocumentLoaderOptions, getRemoteDocument, type RemoteDocument, + type AcceptedDocumentCallback, resolveDocumentLoaderTimeout, withDocumentLoaderTimeout, } from "./docloader.ts"; diff --git a/packages/vocab-tools/src/__snapshots__/class.test.ts.deno.snap b/packages/vocab-tools/src/__snapshots__/class.test.ts.deno.snap index 35fa7f5fd..c0b4ac582 100644 --- a/packages/vocab-tools/src/__snapshots__/class.test.ts.deno.snap +++ b/packages/vocab-tools/src/__snapshots__/class.test.ts.deno.snap @@ -30,7 +30,8 @@ import { type PortableObjectVerifier, type RawPropertyValue, type RemoteDocument, - type VocabularyObject + type VocabularyObject, + type AcceptedDocumentCallback } from \\"@fedify/vocab-runtime\\"; import { compactJsonLdCache, @@ -10361,6 +10362,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -10411,6 +10413,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -10535,6 +10542,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -10693,6 +10704,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -10731,9 +10750,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAttachment(v, options); + await this.#fetchAttachment(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -10792,6 +10817,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -10842,6 +10868,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -10966,6 +10997,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -11288,6 +11323,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -11326,9 +11369,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAttribution(v, options); + await this.#fetchAttribution(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -11387,6 +11436,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -11437,6 +11487,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -11561,6 +11616,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -11821,6 +11880,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -11859,9 +11926,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAudience(v, options); + await this.#fetchAudience(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -11949,6 +12022,7 @@ get contents(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -11999,6 +12073,11 @@ get contents(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -12123,6 +12202,10 @@ get contents(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -12270,6 +12353,14 @@ get contents(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -12308,9 +12399,15 @@ get contents(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchContext(v, options); + await this.#fetchContext(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -12369,6 +12466,7 @@ get contents(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -12419,6 +12517,11 @@ get contents(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -12543,6 +12646,10 @@ get contents(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -12819,6 +12926,14 @@ get contents(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -12857,9 +12972,15 @@ get contents(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchContextHistory(v, options); + await this.#fetchContextHistory(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -12960,6 +13081,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -13010,6 +13132,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -13134,6 +13261,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -13275,6 +13406,14 @@ get names(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -13313,9 +13452,15 @@ get names(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchGenerator(v, options); + await this.#fetchGenerator(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -13374,6 +13519,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -13424,6 +13570,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -13548,6 +13699,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -13835,6 +13990,14 @@ get names(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -13873,9 +14036,15 @@ get names(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchIcon(v, options); + await this.#fetchIcon(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -13934,6 +14103,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -13984,6 +14154,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -14108,6 +14283,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -14395,6 +14574,14 @@ get names(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -14433,9 +14620,15 @@ get names(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchImage(v, options); + await this.#fetchImage(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -14494,6 +14687,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -14544,6 +14738,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -14668,6 +14867,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -14943,6 +15146,14 @@ get names(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -14981,9 +15192,15 @@ get names(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchReplyTarget(v, options); + await this.#fetchReplyTarget(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -15042,6 +15259,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -15092,6 +15310,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -15216,6 +15439,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -15491,6 +15718,14 @@ get names(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -15529,9 +15764,15 @@ get names(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchLocation(v, options); + await this.#fetchLocation(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -15590,6 +15831,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -15640,6 +15882,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -15764,6 +16011,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -16037,6 +16288,14 @@ get names(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -16075,9 +16334,15 @@ get names(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchPreview(v, options); + await this.#fetchPreview(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -16149,6 +16414,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -16199,6 +16465,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -16323,6 +16594,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -16544,6 +16819,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -16594,6 +16870,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -16718,6 +16999,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -16945,6 +17230,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -16995,6 +17281,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -17119,6 +17410,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -17346,6 +17641,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -17396,6 +17692,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -17520,6 +17821,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -17781,6 +18086,7 @@ get summaries(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -17831,6 +18137,11 @@ get summaries(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -17955,6 +18266,10 @@ get summaries(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -18099,6 +18414,14 @@ get summaries(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -18137,9 +18460,15 @@ get summaries(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchTag(v, options); + await this.#fetchTag(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -18232,6 +18561,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -18282,6 +18612,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -18406,6 +18741,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -18666,6 +19005,14 @@ get urls(): ((URL | Link))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -18704,9 +19051,15 @@ get urls(): ((URL | Link))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchTo(v, options); + await this.#fetchTo(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -18765,6 +19118,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -18815,6 +19169,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -18939,6 +19298,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -19199,6 +19562,14 @@ get urls(): ((URL | Link))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -19237,9 +19608,15 @@ get urls(): ((URL | Link))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchBto(v, options); + await this.#fetchBto(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -19298,6 +19675,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -19348,6 +19726,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -19472,6 +19855,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -19732,6 +20119,14 @@ get urls(): ((URL | Link))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -19770,9 +20165,15 @@ get urls(): ((URL | Link))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchCc(v, options); + await this.#fetchCc(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -19831,6 +20232,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -19881,6 +20283,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -20005,6 +20412,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -20265,6 +20676,14 @@ get urls(): ((URL | Link))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -20303,9 +20722,15 @@ get urls(): ((URL | Link))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchBcc(v, options); + await this.#fetchBcc(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -20428,6 +20853,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -20478,6 +20904,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -20602,6 +21033,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -20860,6 +21295,14 @@ get urls(): ((URL | Link))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -20898,9 +21341,15 @@ get urls(): ((URL | Link))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchProof(v, options); + await this.#fetchProof(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -20998,6 +21447,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -21048,6 +21498,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -21172,6 +21627,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -21393,6 +21852,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -21443,6 +21903,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -21567,6 +22032,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -21788,6 +22257,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -21838,6 +22308,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -21962,6 +22437,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -30560,6 +31039,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -30610,6 +31090,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -30734,6 +31219,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -30979,6 +31468,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -31029,6 +31519,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -31153,6 +31648,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -34187,6 +34686,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -34237,6 +34737,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -34361,6 +34866,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -34683,6 +35192,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -34721,9 +35238,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchActor(v, options); + await this.#fetchActor(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -34782,6 +35305,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -34832,6 +35356,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -34956,6 +35485,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -35218,6 +35751,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -35256,9 +35797,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchObject(v, options); + await this.#fetchObject(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -35317,6 +35864,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -35367,6 +35915,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -35491,6 +36044,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -35759,6 +36316,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -35797,9 +36362,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchTarget(v, options); + await this.#fetchTarget(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -35858,6 +36429,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -35908,6 +36480,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -36032,6 +36609,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -36294,6 +36875,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -36332,9 +36921,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchResult(v, options); + await this.#fetchResult(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -36393,6 +36988,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -36443,6 +37039,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -36567,6 +37168,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -36831,6 +37436,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -36869,9 +37482,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchOrigin(v, options); + await this.#fetchOrigin(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -36930,6 +37549,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -36980,6 +37600,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -37104,6 +37729,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -37364,6 +37993,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -37402,9 +38039,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchInstrument(v, options); + await this.#fetchInstrument(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -42508,6 +43151,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -42558,6 +43202,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -42682,6 +43331,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -42903,6 +43556,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -42953,6 +43607,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -43077,6 +43736,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -48823,6 +49486,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -48873,6 +49537,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -48997,6 +49666,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -49218,6 +49891,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -49268,6 +49942,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -49392,6 +50071,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -51500,6 +52183,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -51550,6 +52234,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -51674,6 +52363,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -51895,6 +52588,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -51945,6 +52639,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -52069,6 +52768,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -54177,6 +54880,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -54227,6 +54931,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -54351,6 +55060,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -54571,6 +55284,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -54621,6 +55335,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -54745,6 +55464,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -57767,6 +58490,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -57817,6 +58541,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -57941,6 +58670,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -58269,6 +59002,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -58307,9 +59048,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchTranslator(v, options); + await this.#fetchTranslator(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -60295,6 +61042,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -60345,6 +61093,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -60469,6 +61222,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -60688,6 +61445,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -60738,6 +61496,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -60862,6 +61625,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -65111,6 +65878,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -65161,6 +65929,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -65285,6 +66058,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -65506,6 +66283,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -65556,6 +66334,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -65680,6 +66463,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -65901,6 +66688,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -65951,6 +66739,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -66075,6 +66868,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -66296,6 +67093,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -66346,6 +67144,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -66470,6 +67273,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -66612,6 +67419,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -66650,9 +67465,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchItem(v, options); + await this.#fetchItem(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -66711,6 +67532,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -66761,6 +67583,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -66885,6 +67712,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -67105,6 +67936,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -67155,6 +67987,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -67279,6 +68116,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -67499,6 +68340,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -67549,6 +68391,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -67673,6 +68520,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -67893,6 +68744,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -67943,6 +68795,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -68067,6 +68924,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -68287,6 +69148,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -68337,6 +69199,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -68461,6 +69328,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -68681,6 +69552,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -68731,6 +69603,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -68855,6 +69732,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -69075,6 +69956,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -69125,6 +70007,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -69249,6 +70136,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -69469,6 +70360,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -69519,6 +70411,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -69643,6 +70540,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -72923,6 +73824,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -72973,6 +73875,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -73097,6 +74004,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -73239,6 +74150,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -73277,9 +74196,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchItem(v, options); + await this.#fetchItem(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -75672,6 +76597,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -75722,6 +76648,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -75846,6 +76777,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -76065,6 +77000,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -76115,6 +77051,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -76239,6 +77180,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -81788,6 +82733,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -81838,6 +82784,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -81962,6 +82913,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -83868,6 +84823,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -83918,6 +84874,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -84042,6 +85003,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -85792,6 +86757,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -85842,6 +86808,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -85966,6 +86937,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -100665,6 +101640,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -100715,6 +101691,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -100839,6 +101820,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -101095,6 +102080,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -101133,9 +102126,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchPublicKey(v, options); + await this.#fetchPublicKey(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -101194,6 +102193,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -101244,6 +102244,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -101368,6 +102373,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -101632,6 +102641,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -101670,9 +102687,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAssertionMethod(v, options); + await this.#fetchAssertionMethod(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -101777,6 +102800,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -101827,6 +102851,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -101951,6 +102980,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -102198,6 +103231,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -102248,6 +103282,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -102372,6 +103411,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -102616,6 +103659,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -102666,6 +103710,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -102790,6 +103839,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -103014,6 +104067,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -103064,6 +104118,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -103188,6 +104247,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -103415,6 +104478,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -103465,6 +104529,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -103589,6 +104658,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -103814,6 +104887,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -103864,6 +104938,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -103988,6 +105067,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -104211,6 +105294,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -104261,6 +105345,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -104385,6 +105474,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -104608,6 +105701,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -104658,6 +105752,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -104782,6 +105881,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -105002,6 +106105,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -105052,6 +106156,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -105176,6 +106285,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -105302,6 +106415,14 @@ get gateways(): (URL)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -105340,9 +106461,15 @@ get gateways(): (URL)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchStream(v, options); + await this.#fetchStream(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -105487,6 +106614,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -105537,6 +106665,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -105661,6 +106794,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -105940,6 +107077,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -105990,6 +107128,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -106114,6 +107257,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -106438,6 +107585,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -106476,9 +107631,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAlias(v, options); + await this.#fetchAlias(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -106537,6 +107698,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -106587,6 +107749,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -106711,6 +107878,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -106975,6 +108146,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -107013,9 +108192,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchService(v, options); + await this.#fetchService(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -113552,6 +114737,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -113602,6 +114788,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -113726,6 +114917,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -113971,6 +115166,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -114021,6 +115217,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -114145,6 +115346,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -119172,6 +120377,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -119222,6 +120428,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -119346,6 +120557,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -119567,6 +120782,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -119617,6 +120833,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -119741,6 +120962,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -119960,6 +121185,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -120010,6 +121236,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -120134,6 +121365,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -132798,6 +134033,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -132848,6 +134084,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -132972,6 +134213,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -133228,6 +134473,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -133266,9 +134519,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchPublicKey(v, options); + await this.#fetchPublicKey(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -133327,6 +134586,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -133377,6 +134637,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -133501,6 +134766,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -133765,6 +135034,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -133803,9 +135080,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAssertionMethod(v, options); + await this.#fetchAssertionMethod(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -133910,6 +135193,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -133960,6 +135244,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -134084,6 +135373,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -134331,6 +135624,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -134381,6 +135675,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -134505,6 +135804,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -134749,6 +136052,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -134799,6 +136103,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -134923,6 +136232,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -135147,6 +136460,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -135197,6 +136511,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -135321,6 +136640,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -135548,6 +136871,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -135598,6 +136922,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -135722,6 +137051,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -135947,6 +137280,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -135997,6 +137331,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -136121,6 +137460,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -136344,6 +137687,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -136394,6 +137738,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -136518,6 +137867,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -136741,6 +138094,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -136791,6 +138145,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -136915,6 +138274,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -137135,6 +138498,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -137185,6 +138549,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -137309,6 +138678,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -137435,6 +138808,14 @@ get gateways(): (URL)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -137473,9 +138854,15 @@ get gateways(): (URL)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchStream(v, options); + await this.#fetchStream(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -137620,6 +139007,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -137670,6 +139058,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -137794,6 +139187,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -138073,6 +139470,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -138123,6 +139521,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -138247,6 +139650,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -138571,6 +139978,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -138609,9 +140024,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAlias(v, options); + await this.#fetchAlias(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -138670,6 +140091,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -138720,6 +140142,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -138844,6 +140271,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -139108,6 +140539,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -139146,9 +140585,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchService(v, options); + await this.#fetchService(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -145887,6 +147332,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -145937,6 +147383,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -146061,6 +147512,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -146201,6 +147656,14 @@ get names(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -146239,9 +147702,15 @@ get names(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchPreview(v, options); + await this.#fetchPreview(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -154554,6 +156023,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -154604,6 +156074,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -154728,6 +156203,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -154973,6 +156452,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -155023,6 +156503,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -155147,6 +156632,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -156814,6 +158303,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -156864,6 +158354,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -156988,6 +158483,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -157130,6 +158629,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -157168,9 +158675,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchItem(v, options); + await this.#fetchItem(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -163273,6 +164786,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -163323,6 +164837,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -163447,6 +164966,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -163703,6 +165226,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -163741,9 +165272,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchPublicKey(v, options); + await this.#fetchPublicKey(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -163802,6 +165339,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -163852,6 +165390,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -163976,6 +165519,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -164240,6 +165787,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -164278,9 +165833,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAssertionMethod(v, options); + await this.#fetchAssertionMethod(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -164385,6 +165946,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -164435,6 +165997,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -164559,6 +166126,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -164806,6 +166377,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -164856,6 +166428,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -164980,6 +166557,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -165224,6 +166805,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -165274,6 +166856,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -165398,6 +166985,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -165622,6 +167213,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -165672,6 +167264,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -165796,6 +167393,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -166023,6 +167624,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -166073,6 +167675,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -166197,6 +167804,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -166422,6 +168033,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -166472,6 +168084,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -166596,6 +168213,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -166819,6 +168440,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -166869,6 +168491,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -166993,6 +168620,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -167216,6 +168847,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -167266,6 +168898,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -167390,6 +169027,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -167610,6 +169251,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -167660,6 +169302,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -167784,6 +169431,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -167910,6 +169561,14 @@ get gateways(): (URL)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -167948,9 +169607,15 @@ get gateways(): (URL)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchStream(v, options); + await this.#fetchStream(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -168095,6 +169760,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -168145,6 +169811,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -168269,6 +169940,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -168548,6 +170223,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -168598,6 +170274,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -168722,6 +170403,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -169046,6 +170731,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -169084,9 +170777,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAlias(v, options); + await this.#fetchAlias(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -169145,6 +170844,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -169195,6 +170895,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -169319,6 +171024,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -169583,6 +171292,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -169621,9 +171338,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchService(v, options); + await this.#fetchService(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -180170,6 +181893,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -180220,6 +181944,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -180344,6 +182073,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -180600,6 +182333,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -180638,9 +182379,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchPublicKey(v, options); + await this.#fetchPublicKey(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -180699,6 +182446,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -180749,6 +182497,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -180873,6 +182626,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -181137,6 +182894,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -181175,9 +182940,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAssertionMethod(v, options); + await this.#fetchAssertionMethod(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -181282,6 +183053,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -181332,6 +183104,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -181456,6 +183233,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -181703,6 +183484,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -181753,6 +183535,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -181877,6 +183664,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -182121,6 +183912,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -182171,6 +183963,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -182295,6 +184092,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -182519,6 +184320,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -182569,6 +184371,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -182693,6 +184500,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -182920,6 +184731,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -182970,6 +184782,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -183094,6 +184911,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -183319,6 +185140,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -183369,6 +185191,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -183493,6 +185320,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -183716,6 +185547,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -183766,6 +185598,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -183890,6 +185727,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -184113,6 +185954,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -184163,6 +186005,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -184287,6 +186134,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -184507,6 +186358,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -184557,6 +186409,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -184681,6 +186538,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -184807,6 +186668,14 @@ get gateways(): (URL)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -184845,9 +186714,15 @@ get gateways(): (URL)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchStream(v, options); + await this.#fetchStream(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -184992,6 +186867,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -185042,6 +186918,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -185166,6 +187047,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -185445,6 +187330,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -185495,6 +187381,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -185619,6 +187510,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -185943,6 +187838,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -185981,9 +187884,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAlias(v, options); + await this.#fetchAlias(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -186042,6 +187951,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -186092,6 +188002,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -186216,6 +188131,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -186480,6 +188399,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -186518,9 +188445,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchService(v, options); + await this.#fetchService(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -193767,6 +195700,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -193817,6 +195751,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -193941,6 +195880,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -196182,6 +198125,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -196232,6 +198176,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -196356,6 +198305,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -196484,6 +198437,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -196522,9 +198483,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchExclusiveOption(v, options); + await this.#fetchExclusiveOption(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -196583,6 +198550,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -196633,6 +198601,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -196757,6 +198730,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -196885,6 +198862,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -196923,9 +198908,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchInclusiveOption(v, options); + await this.#fetchInclusiveOption(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -197014,6 +199005,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -197064,6 +199056,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -197188,6 +199185,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -197433,6 +199434,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -197483,6 +199485,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -197607,6 +199614,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -201233,6 +203244,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -201283,6 +203295,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -201407,6 +203424,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -201630,6 +203651,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -201680,6 +203702,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -201804,6 +203831,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -202062,6 +204093,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -202100,9 +204139,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchObject(v, options); + await this.#fetchObject(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -202161,6 +204206,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -202211,6 +204257,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -202335,6 +204386,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -202597,6 +204652,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -202635,9 +204698,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchRelationship(v, options); + await this.#fetchRelationship(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -209495,6 +211564,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -209545,6 +211615,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -209669,6 +211744,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -209925,6 +212004,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -209963,9 +212050,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchPublicKey(v, options); + await this.#fetchPublicKey(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -210024,6 +212117,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -210074,6 +212168,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -210198,6 +212297,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -210462,6 +212565,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -210500,9 +212611,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAssertionMethod(v, options); + await this.#fetchAssertionMethod(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -210607,6 +212724,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -210657,6 +212775,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -210781,6 +212904,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -211028,6 +213155,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -211078,6 +213206,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -211202,6 +213335,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -211446,6 +213583,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -211496,6 +213634,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -211620,6 +213763,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -211844,6 +213991,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -211894,6 +214042,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -212018,6 +214171,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -212245,6 +214402,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -212295,6 +214453,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -212419,6 +214582,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -212644,6 +214811,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -212694,6 +214862,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -212818,6 +214991,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -213041,6 +215218,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -213091,6 +215269,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -213215,6 +215398,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -213438,6 +215625,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -213488,6 +215676,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -213612,6 +215805,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -213832,6 +216029,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -213882,6 +216080,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -214006,6 +216209,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -214132,6 +216339,14 @@ get gateways(): (URL)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -214170,9 +216385,15 @@ get gateways(): (URL)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchStream(v, options); + await this.#fetchStream(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -214317,6 +216538,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -214367,6 +216589,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -214491,6 +216718,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -214770,6 +217001,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -214820,6 +217052,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -214944,6 +217181,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -215268,6 +217509,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -215306,9 +217555,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAlias(v, options); + await this.#fetchAlias(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -215367,6 +217622,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -215417,6 +217673,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -215541,6 +217802,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -215805,6 +218070,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -215843,9 +218116,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchService(v, options); + await this.#fetchService(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { diff --git a/packages/vocab-tools/src/__snapshots__/class.test.ts.node.snap b/packages/vocab-tools/src/__snapshots__/class.test.ts.node.snap index ecb37c722..5ffcce5b4 100644 --- a/packages/vocab-tools/src/__snapshots__/class.test.ts.node.snap +++ b/packages/vocab-tools/src/__snapshots__/class.test.ts.node.snap @@ -28,7 +28,8 @@ import { type PortableObjectVerifier, type RawPropertyValue, type RemoteDocument, - type VocabularyObject + type VocabularyObject, + type AcceptedDocumentCallback } from \\"@fedify/vocab-runtime\\"; import { compactJsonLdCache, @@ -10359,6 +10360,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -10409,6 +10411,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -10533,6 +10540,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -10691,6 +10702,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -10729,9 +10748,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAttachment(v, options); + await this.#fetchAttachment(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -10790,6 +10815,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -10840,6 +10866,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -10964,6 +10995,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -11286,6 +11321,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -11324,9 +11367,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAttribution(v, options); + await this.#fetchAttribution(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -11385,6 +11434,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -11435,6 +11485,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -11559,6 +11614,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -11819,6 +11878,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -11857,9 +11924,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAudience(v, options); + await this.#fetchAudience(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -11947,6 +12020,7 @@ get contents(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -11997,6 +12071,11 @@ get contents(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -12121,6 +12200,10 @@ get contents(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -12268,6 +12351,14 @@ get contents(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -12306,9 +12397,15 @@ get contents(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchContext(v, options); + await this.#fetchContext(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -12367,6 +12464,7 @@ get contents(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -12417,6 +12515,11 @@ get contents(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -12541,6 +12644,10 @@ get contents(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -12817,6 +12924,14 @@ get contents(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -12855,9 +12970,15 @@ get contents(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchContextHistory(v, options); + await this.#fetchContextHistory(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -12958,6 +13079,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -13008,6 +13130,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -13132,6 +13259,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -13273,6 +13404,14 @@ get names(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -13311,9 +13450,15 @@ get names(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchGenerator(v, options); + await this.#fetchGenerator(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -13372,6 +13517,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -13422,6 +13568,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -13546,6 +13697,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -13833,6 +13988,14 @@ get names(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -13871,9 +14034,15 @@ get names(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchIcon(v, options); + await this.#fetchIcon(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -13932,6 +14101,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -13982,6 +14152,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -14106,6 +14281,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -14393,6 +14572,14 @@ get names(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -14431,9 +14618,15 @@ get names(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchImage(v, options); + await this.#fetchImage(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -14492,6 +14685,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -14542,6 +14736,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -14666,6 +14865,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -14941,6 +15144,14 @@ get names(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -14979,9 +15190,15 @@ get names(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchReplyTarget(v, options); + await this.#fetchReplyTarget(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -15040,6 +15257,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -15090,6 +15308,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -15214,6 +15437,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -15489,6 +15716,14 @@ get names(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -15527,9 +15762,15 @@ get names(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchLocation(v, options); + await this.#fetchLocation(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -15588,6 +15829,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -15638,6 +15880,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -15762,6 +16009,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -16035,6 +16286,14 @@ get names(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -16073,9 +16332,15 @@ get names(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchPreview(v, options); + await this.#fetchPreview(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -16147,6 +16412,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -16197,6 +16463,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -16321,6 +16592,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -16542,6 +16817,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -16592,6 +16868,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -16716,6 +16997,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -16943,6 +17228,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -16993,6 +17279,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -17117,6 +17408,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -17344,6 +17639,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -17394,6 +17690,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -17518,6 +17819,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -17779,6 +18084,7 @@ get summaries(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -17829,6 +18135,11 @@ get summaries(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -17953,6 +18264,10 @@ get summaries(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -18097,6 +18412,14 @@ get summaries(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -18135,9 +18458,15 @@ get summaries(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchTag(v, options); + await this.#fetchTag(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -18230,6 +18559,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -18280,6 +18610,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -18404,6 +18739,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -18664,6 +19003,14 @@ get urls(): ((URL | Link))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -18702,9 +19049,15 @@ get urls(): ((URL | Link))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchTo(v, options); + await this.#fetchTo(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -18763,6 +19116,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -18813,6 +19167,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -18937,6 +19296,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -19197,6 +19560,14 @@ get urls(): ((URL | Link))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -19235,9 +19606,15 @@ get urls(): ((URL | Link))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchBto(v, options); + await this.#fetchBto(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -19296,6 +19673,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -19346,6 +19724,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -19470,6 +19853,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -19730,6 +20117,14 @@ get urls(): ((URL | Link))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -19768,9 +20163,15 @@ get urls(): ((URL | Link))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchCc(v, options); + await this.#fetchCc(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -19829,6 +20230,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -19879,6 +20281,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -20003,6 +20410,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -20263,6 +20674,14 @@ get urls(): ((URL | Link))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -20301,9 +20720,15 @@ get urls(): ((URL | Link))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchBcc(v, options); + await this.#fetchBcc(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -20426,6 +20851,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -20476,6 +20902,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -20600,6 +21031,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -20858,6 +21293,14 @@ get urls(): ((URL | Link))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -20896,9 +21339,15 @@ get urls(): ((URL | Link))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchProof(v, options); + await this.#fetchProof(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -20996,6 +21445,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -21046,6 +21496,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -21170,6 +21625,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -21391,6 +21850,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -21441,6 +21901,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -21565,6 +22030,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -21786,6 +22255,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -21836,6 +22306,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -21960,6 +22435,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -30558,6 +31037,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -30608,6 +31088,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -30732,6 +31217,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -30977,6 +31466,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -31027,6 +31517,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -31151,6 +31646,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -34185,6 +34684,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -34235,6 +34735,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -34359,6 +34864,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -34681,6 +35190,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -34719,9 +35236,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchActor(v, options); + await this.#fetchActor(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -34780,6 +35303,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -34830,6 +35354,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -34954,6 +35483,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -35216,6 +35749,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -35254,9 +35795,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchObject(v, options); + await this.#fetchObject(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -35315,6 +35862,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -35365,6 +35913,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -35489,6 +36042,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -35757,6 +36314,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -35795,9 +36360,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchTarget(v, options); + await this.#fetchTarget(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -35856,6 +36427,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -35906,6 +36478,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -36030,6 +36607,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -36292,6 +36873,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -36330,9 +36919,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchResult(v, options); + await this.#fetchResult(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -36391,6 +36986,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -36441,6 +37037,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -36565,6 +37166,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -36829,6 +37434,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -36867,9 +37480,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchOrigin(v, options); + await this.#fetchOrigin(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -36928,6 +37547,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -36978,6 +37598,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -37102,6 +37727,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -37362,6 +37991,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -37400,9 +38037,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchInstrument(v, options); + await this.#fetchInstrument(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -42506,6 +43149,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -42556,6 +43200,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -42680,6 +43329,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -42901,6 +43554,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -42951,6 +43605,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -43075,6 +43734,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -48821,6 +49484,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -48871,6 +49535,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -48995,6 +49664,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -49216,6 +49889,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -49266,6 +49940,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -49390,6 +50069,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -51498,6 +52181,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -51548,6 +52232,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -51672,6 +52361,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -51893,6 +52586,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -51943,6 +52637,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -52067,6 +52766,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -54175,6 +54878,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -54225,6 +54929,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -54349,6 +55058,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -54569,6 +55282,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -54619,6 +55333,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -54743,6 +55462,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -57765,6 +58488,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -57815,6 +58539,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -57939,6 +58668,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -58267,6 +59000,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -58305,9 +59046,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchTranslator(v, options); + await this.#fetchTranslator(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -60293,6 +61040,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -60343,6 +61091,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -60467,6 +61220,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -60686,6 +61443,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -60736,6 +61494,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -60860,6 +61623,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -65109,6 +65876,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -65159,6 +65927,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -65283,6 +66056,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -65504,6 +66281,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -65554,6 +66332,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -65678,6 +66461,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -65899,6 +66686,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -65949,6 +66737,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -66073,6 +66866,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -66294,6 +67091,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -66344,6 +67142,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -66468,6 +67271,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -66610,6 +67417,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -66648,9 +67463,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchItem(v, options); + await this.#fetchItem(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -66709,6 +67530,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -66759,6 +67581,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -66883,6 +67710,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -67103,6 +67934,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -67153,6 +67985,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -67277,6 +68114,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -67497,6 +68338,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -67547,6 +68389,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -67671,6 +68518,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -67891,6 +68742,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -67941,6 +68793,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -68065,6 +68922,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -68285,6 +69146,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -68335,6 +69197,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -68459,6 +69326,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -68679,6 +69550,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -68729,6 +69601,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -68853,6 +69730,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -69073,6 +69954,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -69123,6 +70005,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -69247,6 +70134,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -69467,6 +70358,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -69517,6 +70409,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -69641,6 +70538,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -72921,6 +73822,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -72971,6 +73873,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -73095,6 +74002,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -73237,6 +74148,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -73275,9 +74194,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchItem(v, options); + await this.#fetchItem(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -75670,6 +76595,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -75720,6 +76646,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -75844,6 +76775,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -76063,6 +76998,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -76113,6 +77049,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -76237,6 +77178,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -81786,6 +82731,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -81836,6 +82782,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -81960,6 +82911,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -83866,6 +84821,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -83916,6 +84872,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -84040,6 +85001,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -85790,6 +86755,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -85840,6 +86806,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -85964,6 +86935,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -100663,6 +101638,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -100713,6 +101689,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -100837,6 +101818,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -101093,6 +102078,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -101131,9 +102124,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchPublicKey(v, options); + await this.#fetchPublicKey(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -101192,6 +102191,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -101242,6 +102242,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -101366,6 +102371,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -101630,6 +102639,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -101668,9 +102685,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAssertionMethod(v, options); + await this.#fetchAssertionMethod(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -101775,6 +102798,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -101825,6 +102849,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -101949,6 +102978,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -102196,6 +103229,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -102246,6 +103280,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -102370,6 +103409,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -102614,6 +103657,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -102664,6 +103708,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -102788,6 +103837,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -103012,6 +104065,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -103062,6 +104116,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -103186,6 +104245,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -103413,6 +104476,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -103463,6 +104527,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -103587,6 +104656,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -103812,6 +104885,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -103862,6 +104936,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -103986,6 +105065,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -104209,6 +105292,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -104259,6 +105343,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -104383,6 +105472,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -104606,6 +105699,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -104656,6 +105750,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -104780,6 +105879,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -105000,6 +106103,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -105050,6 +106154,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -105174,6 +106283,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -105300,6 +106413,14 @@ get gateways(): (URL)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -105338,9 +106459,15 @@ get gateways(): (URL)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchStream(v, options); + await this.#fetchStream(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -105485,6 +106612,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -105535,6 +106663,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -105659,6 +106792,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -105938,6 +107075,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -105988,6 +107126,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -106112,6 +107255,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -106436,6 +107583,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -106474,9 +107629,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAlias(v, options); + await this.#fetchAlias(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -106535,6 +107696,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -106585,6 +107747,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -106709,6 +107876,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -106973,6 +108144,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -107011,9 +108190,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchService(v, options); + await this.#fetchService(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -113550,6 +114735,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -113600,6 +114786,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -113724,6 +114915,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -113969,6 +115164,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -114019,6 +115215,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -114143,6 +115344,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -119170,6 +120375,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -119220,6 +120426,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -119344,6 +120555,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -119565,6 +120780,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -119615,6 +120831,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -119739,6 +120960,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -119958,6 +121183,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -120008,6 +121234,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -120132,6 +121363,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -132796,6 +134031,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -132846,6 +134082,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -132970,6 +134211,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -133226,6 +134471,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -133264,9 +134517,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchPublicKey(v, options); + await this.#fetchPublicKey(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -133325,6 +134584,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -133375,6 +134635,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -133499,6 +134764,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -133763,6 +135032,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -133801,9 +135078,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAssertionMethod(v, options); + await this.#fetchAssertionMethod(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -133908,6 +135191,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -133958,6 +135242,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -134082,6 +135371,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -134329,6 +135622,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -134379,6 +135673,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -134503,6 +135802,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -134747,6 +136050,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -134797,6 +136101,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -134921,6 +136230,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -135145,6 +136458,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -135195,6 +136509,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -135319,6 +136638,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -135546,6 +136869,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -135596,6 +136920,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -135720,6 +137049,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -135945,6 +137278,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -135995,6 +137329,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -136119,6 +137458,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -136342,6 +137685,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -136392,6 +137736,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -136516,6 +137865,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -136739,6 +138092,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -136789,6 +138143,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -136913,6 +138272,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -137133,6 +138496,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -137183,6 +138547,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -137307,6 +138676,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -137433,6 +138806,14 @@ get gateways(): (URL)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -137471,9 +138852,15 @@ get gateways(): (URL)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchStream(v, options); + await this.#fetchStream(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -137618,6 +139005,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -137668,6 +139056,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -137792,6 +139185,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -138071,6 +139468,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -138121,6 +139519,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -138245,6 +139648,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -138569,6 +139976,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -138607,9 +140022,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAlias(v, options); + await this.#fetchAlias(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -138668,6 +140089,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -138718,6 +140140,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -138842,6 +140269,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -139106,6 +140537,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -139144,9 +140583,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchService(v, options); + await this.#fetchService(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -145885,6 +147330,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -145935,6 +147381,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -146059,6 +147510,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -146199,6 +147654,14 @@ get names(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -146237,9 +147700,15 @@ get names(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchPreview(v, options); + await this.#fetchPreview(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -154552,6 +156021,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -154602,6 +156072,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -154726,6 +156201,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -154971,6 +156450,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -155021,6 +156501,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -155145,6 +156630,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -156812,6 +158301,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -156862,6 +158352,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -156986,6 +158481,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -157128,6 +158627,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -157166,9 +158673,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchItem(v, options); + await this.#fetchItem(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -163271,6 +164784,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -163321,6 +164835,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -163445,6 +164964,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -163701,6 +165224,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -163739,9 +165270,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchPublicKey(v, options); + await this.#fetchPublicKey(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -163800,6 +165337,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -163850,6 +165388,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -163974,6 +165517,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -164238,6 +165785,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -164276,9 +165831,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAssertionMethod(v, options); + await this.#fetchAssertionMethod(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -164383,6 +165944,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -164433,6 +165995,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -164557,6 +166124,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -164804,6 +166375,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -164854,6 +166426,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -164978,6 +166555,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -165222,6 +166803,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -165272,6 +166854,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -165396,6 +166983,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -165620,6 +167211,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -165670,6 +167262,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -165794,6 +167391,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -166021,6 +167622,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -166071,6 +167673,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -166195,6 +167802,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -166420,6 +168031,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -166470,6 +168082,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -166594,6 +168211,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -166817,6 +168438,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -166867,6 +168489,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -166991,6 +168618,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -167214,6 +168845,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -167264,6 +168896,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -167388,6 +169025,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -167608,6 +169249,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -167658,6 +169300,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -167782,6 +169429,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -167908,6 +169559,14 @@ get gateways(): (URL)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -167946,9 +169605,15 @@ get gateways(): (URL)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchStream(v, options); + await this.#fetchStream(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -168093,6 +169758,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -168143,6 +169809,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -168267,6 +169938,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -168546,6 +170221,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -168596,6 +170272,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -168720,6 +170401,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -169044,6 +170729,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -169082,9 +170775,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAlias(v, options); + await this.#fetchAlias(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -169143,6 +170842,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -169193,6 +170893,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -169317,6 +171022,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -169581,6 +171290,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -169619,9 +171336,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchService(v, options); + await this.#fetchService(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -180168,6 +181891,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -180218,6 +181942,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -180342,6 +182071,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -180598,6 +182331,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -180636,9 +182377,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchPublicKey(v, options); + await this.#fetchPublicKey(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -180697,6 +182444,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -180747,6 +182495,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -180871,6 +182624,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -181135,6 +182892,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -181173,9 +182938,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAssertionMethod(v, options); + await this.#fetchAssertionMethod(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -181280,6 +183051,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -181330,6 +183102,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -181454,6 +183231,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -181701,6 +183482,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -181751,6 +183533,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -181875,6 +183662,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -182119,6 +183910,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -182169,6 +183961,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -182293,6 +184090,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -182517,6 +184318,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -182567,6 +184369,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -182691,6 +184498,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -182918,6 +184729,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -182968,6 +184780,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -183092,6 +184909,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -183317,6 +185138,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -183367,6 +185189,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -183491,6 +185318,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -183714,6 +185545,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -183764,6 +185596,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -183888,6 +185725,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -184111,6 +185952,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -184161,6 +186003,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -184285,6 +186132,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -184505,6 +186356,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -184555,6 +186407,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -184679,6 +186536,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -184805,6 +186666,14 @@ get gateways(): (URL)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -184843,9 +186712,15 @@ get gateways(): (URL)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchStream(v, options); + await this.#fetchStream(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -184990,6 +186865,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -185040,6 +186916,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -185164,6 +187045,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -185443,6 +187328,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -185493,6 +187379,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -185617,6 +187508,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -185941,6 +187836,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -185979,9 +187882,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAlias(v, options); + await this.#fetchAlias(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -186040,6 +187949,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -186090,6 +188000,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -186214,6 +188129,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -186478,6 +188397,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -186516,9 +188443,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchService(v, options); + await this.#fetchService(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -193765,6 +195698,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -193815,6 +195749,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -193939,6 +195878,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -196180,6 +198123,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -196230,6 +198174,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -196354,6 +198303,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -196482,6 +198435,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -196520,9 +198481,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchExclusiveOption(v, options); + await this.#fetchExclusiveOption(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -196581,6 +198548,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -196631,6 +198599,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -196755,6 +198728,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -196883,6 +198860,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -196921,9 +198906,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchInclusiveOption(v, options); + await this.#fetchInclusiveOption(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -197012,6 +199003,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -197062,6 +199054,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -197186,6 +199183,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -197431,6 +199432,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -197481,6 +199483,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -197605,6 +199612,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -201231,6 +203242,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -201281,6 +203293,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -201405,6 +203422,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -201628,6 +203649,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -201678,6 +203700,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -201802,6 +203829,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -202060,6 +204091,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -202098,9 +204137,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchObject(v, options); + await this.#fetchObject(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -202159,6 +204204,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -202209,6 +204255,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -202333,6 +204384,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -202595,6 +204650,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -202633,9 +204696,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchRelationship(v, options); + await this.#fetchRelationship(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -209493,6 +211562,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -209543,6 +211613,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -209667,6 +211742,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -209923,6 +212002,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -209961,9 +212048,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchPublicKey(v, options); + await this.#fetchPublicKey(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -210022,6 +212115,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -210072,6 +212166,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -210196,6 +212295,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -210460,6 +212563,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -210498,9 +212609,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAssertionMethod(v, options); + await this.#fetchAssertionMethod(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -210605,6 +212722,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -210655,6 +212773,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -210779,6 +212902,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -211026,6 +213153,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -211076,6 +213204,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -211200,6 +213333,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -211444,6 +213581,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -211494,6 +213632,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -211618,6 +213761,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -211842,6 +213989,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -211892,6 +214040,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -212016,6 +214169,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -212243,6 +214400,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -212293,6 +214451,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -212417,6 +214580,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -212642,6 +214809,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -212692,6 +214860,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -212816,6 +214989,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -213039,6 +215216,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -213089,6 +215267,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -213213,6 +215396,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -213436,6 +215623,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -213486,6 +215674,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -213610,6 +215803,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -213830,6 +216027,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -213880,6 +216078,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -214004,6 +216207,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -214130,6 +216337,14 @@ get gateways(): (URL)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -214168,9 +216383,15 @@ get gateways(): (URL)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchStream(v, options); + await this.#fetchStream(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -214315,6 +216536,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -214365,6 +216587,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -214489,6 +216716,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -214768,6 +216999,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -214818,6 +217050,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -214942,6 +217179,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -215266,6 +217507,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -215304,9 +217553,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAlias(v, options); + await this.#fetchAlias(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -215365,6 +217620,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -215415,6 +217671,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -215539,6 +217800,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -215803,6 +218068,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -215841,9 +218114,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchService(v, options); + await this.#fetchService(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { diff --git a/packages/vocab-tools/src/__snapshots__/class.test.ts.snap b/packages/vocab-tools/src/__snapshots__/class.test.ts.snap index 10af7fefd..cfc185e7e 100644 --- a/packages/vocab-tools/src/__snapshots__/class.test.ts.snap +++ b/packages/vocab-tools/src/__snapshots__/class.test.ts.snap @@ -30,7 +30,8 @@ import { type PortableObjectVerifier, type RawPropertyValue, type RemoteDocument, - type VocabularyObject + type VocabularyObject, + type AcceptedDocumentCallback } from "@fedify/vocab-runtime"; import { compactJsonLdCache, @@ -10361,6 +10362,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -10411,6 +10413,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -10535,6 +10542,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -10693,6 +10704,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -10731,9 +10750,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAttachment(v, options); + await this.#fetchAttachment(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -10792,6 +10817,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -10842,6 +10868,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -10966,6 +10997,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -11288,6 +11323,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -11326,9 +11369,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAttribution(v, options); + await this.#fetchAttribution(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -11387,6 +11436,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -11437,6 +11487,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -11561,6 +11616,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -11821,6 +11880,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -11859,9 +11926,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAudience(v, options); + await this.#fetchAudience(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -11949,6 +12022,7 @@ get contents(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -11999,6 +12073,11 @@ get contents(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -12123,6 +12202,10 @@ get contents(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -12270,6 +12353,14 @@ get contents(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -12308,9 +12399,15 @@ get contents(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchContext(v, options); + await this.#fetchContext(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -12369,6 +12466,7 @@ get contents(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -12419,6 +12517,11 @@ get contents(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -12543,6 +12646,10 @@ get contents(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -12819,6 +12926,14 @@ get contents(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -12857,9 +12972,15 @@ get contents(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchContextHistory(v, options); + await this.#fetchContextHistory(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -12960,6 +13081,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -13010,6 +13132,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -13134,6 +13261,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -13275,6 +13406,14 @@ get names(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -13313,9 +13452,15 @@ get names(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchGenerator(v, options); + await this.#fetchGenerator(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -13374,6 +13519,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -13424,6 +13570,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -13548,6 +13699,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -13835,6 +13990,14 @@ get names(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -13873,9 +14036,15 @@ get names(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchIcon(v, options); + await this.#fetchIcon(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -13934,6 +14103,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -13984,6 +14154,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -14108,6 +14283,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -14395,6 +14574,14 @@ get names(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -14433,9 +14620,15 @@ get names(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchImage(v, options); + await this.#fetchImage(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -14494,6 +14687,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -14544,6 +14738,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -14668,6 +14867,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -14943,6 +15146,14 @@ get names(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -14981,9 +15192,15 @@ get names(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchReplyTarget(v, options); + await this.#fetchReplyTarget(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -15042,6 +15259,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -15092,6 +15310,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -15216,6 +15439,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -15491,6 +15718,14 @@ get names(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -15529,9 +15764,15 @@ get names(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchLocation(v, options); + await this.#fetchLocation(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -15590,6 +15831,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -15640,6 +15882,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -15764,6 +16011,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -16037,6 +16288,14 @@ get names(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -16075,9 +16334,15 @@ get names(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchPreview(v, options); + await this.#fetchPreview(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -16149,6 +16414,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -16199,6 +16465,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -16323,6 +16594,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -16544,6 +16819,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -16594,6 +16870,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -16718,6 +16999,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -16945,6 +17230,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -16995,6 +17281,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -17119,6 +17410,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -17346,6 +17641,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -17396,6 +17692,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -17520,6 +17821,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -17781,6 +18086,7 @@ get summaries(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -17831,6 +18137,11 @@ get summaries(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -17955,6 +18266,10 @@ get summaries(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -18099,6 +18414,14 @@ get summaries(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -18137,9 +18460,15 @@ get summaries(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchTag(v, options); + await this.#fetchTag(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -18232,6 +18561,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -18282,6 +18612,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -18406,6 +18741,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -18666,6 +19005,14 @@ get urls(): ((URL | Link))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -18704,9 +19051,15 @@ get urls(): ((URL | Link))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchTo(v, options); + await this.#fetchTo(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -18765,6 +19118,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -18815,6 +19169,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -18939,6 +19298,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -19199,6 +19562,14 @@ get urls(): ((URL | Link))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -19237,9 +19608,15 @@ get urls(): ((URL | Link))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchBto(v, options); + await this.#fetchBto(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -19298,6 +19675,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -19348,6 +19726,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -19472,6 +19855,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -19732,6 +20119,14 @@ get urls(): ((URL | Link))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -19770,9 +20165,15 @@ get urls(): ((URL | Link))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchCc(v, options); + await this.#fetchCc(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -19831,6 +20232,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -19881,6 +20283,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -20005,6 +20412,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -20265,6 +20676,14 @@ get urls(): ((URL | Link))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -20303,9 +20722,15 @@ get urls(): ((URL | Link))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchBcc(v, options); + await this.#fetchBcc(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -20428,6 +20853,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -20478,6 +20904,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -20602,6 +21033,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -20860,6 +21295,14 @@ get urls(): ((URL | Link))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -20898,9 +21341,15 @@ get urls(): ((URL | Link))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchProof(v, options); + await this.#fetchProof(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -20998,6 +21447,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -21048,6 +21498,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -21172,6 +21627,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -21393,6 +21852,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -21443,6 +21903,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -21567,6 +22032,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -21788,6 +22257,7 @@ get urls(): ((URL | Link))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -21838,6 +22308,11 @@ get urls(): ((URL | Link))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -21962,6 +22437,10 @@ get urls(): ((URL | Link))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -30560,6 +31039,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -30610,6 +31090,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -30734,6 +31219,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -30979,6 +31468,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -31029,6 +31519,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -31153,6 +31648,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -34187,6 +34686,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -34237,6 +34737,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -34361,6 +34866,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -34683,6 +35192,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -34721,9 +35238,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchActor(v, options); + await this.#fetchActor(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -34782,6 +35305,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -34832,6 +35356,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -34956,6 +35485,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -35218,6 +35751,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -35256,9 +35797,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchObject(v, options); + await this.#fetchObject(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -35317,6 +35864,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -35367,6 +35915,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -35491,6 +36044,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -35759,6 +36316,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -35797,9 +36362,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchTarget(v, options); + await this.#fetchTarget(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -35858,6 +36429,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -35908,6 +36480,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -36032,6 +36609,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -36294,6 +36875,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -36332,9 +36921,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchResult(v, options); + await this.#fetchResult(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -36393,6 +36988,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -36443,6 +37039,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -36567,6 +37168,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -36831,6 +37436,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -36869,9 +37482,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchOrigin(v, options); + await this.#fetchOrigin(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -36930,6 +37549,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -36980,6 +37600,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -37104,6 +37729,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -37364,6 +37993,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -37402,9 +38039,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchInstrument(v, options); + await this.#fetchInstrument(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -42508,6 +43151,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -42558,6 +43202,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -42682,6 +43331,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -42903,6 +43556,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -42953,6 +43607,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -43077,6 +43736,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -48823,6 +49486,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -48873,6 +49537,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -48997,6 +49666,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -49218,6 +49891,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -49268,6 +49942,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -49392,6 +50071,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -51500,6 +52183,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -51550,6 +52234,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -51674,6 +52363,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -51895,6 +52588,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -51945,6 +52639,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -52069,6 +52768,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -54177,6 +54880,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -54227,6 +54931,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -54351,6 +55060,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -54571,6 +55284,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -54621,6 +55335,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -54745,6 +55464,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -57767,6 +58490,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -57817,6 +58541,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -57941,6 +58670,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -58269,6 +59002,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -58307,9 +59048,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchTranslator(v, options); + await this.#fetchTranslator(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -60295,6 +61042,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -60345,6 +61093,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -60469,6 +61222,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -60688,6 +61445,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -60738,6 +61496,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -60862,6 +61625,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -65111,6 +65878,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -65161,6 +65929,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -65285,6 +66058,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -65506,6 +66283,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -65556,6 +66334,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -65680,6 +66463,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -65901,6 +66688,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -65951,6 +66739,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -66075,6 +66868,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -66296,6 +67093,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -66346,6 +67144,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -66470,6 +67273,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -66612,6 +67419,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -66650,9 +67465,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchItem(v, options); + await this.#fetchItem(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -66711,6 +67532,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -66761,6 +67583,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -66885,6 +67712,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -67105,6 +67936,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -67155,6 +67987,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -67279,6 +68116,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -67499,6 +68340,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -67549,6 +68391,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -67673,6 +68520,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -67893,6 +68744,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -67943,6 +68795,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -68067,6 +68924,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -68287,6 +69148,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -68337,6 +69199,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -68461,6 +69328,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -68681,6 +69552,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -68731,6 +69603,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -68855,6 +69732,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -69075,6 +69956,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -69125,6 +70007,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -69249,6 +70136,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -69469,6 +70360,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -69519,6 +70411,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -69643,6 +70540,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -72923,6 +73824,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -72973,6 +73875,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -73097,6 +74004,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -73239,6 +74150,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -73277,9 +74196,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchItem(v, options); + await this.#fetchItem(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -75672,6 +76597,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -75722,6 +76648,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -75846,6 +76777,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -76065,6 +77000,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -76115,6 +77051,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -76239,6 +77180,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -81788,6 +82733,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -81838,6 +82784,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -81962,6 +82913,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -83868,6 +84823,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -83918,6 +84874,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -84042,6 +85003,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -85792,6 +86757,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -85842,6 +86808,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -85966,6 +86937,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -100665,6 +101640,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -100715,6 +101691,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -100839,6 +101820,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -101095,6 +102080,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -101133,9 +102126,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchPublicKey(v, options); + await this.#fetchPublicKey(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -101194,6 +102193,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -101244,6 +102244,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -101368,6 +102373,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -101632,6 +102641,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -101670,9 +102687,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAssertionMethod(v, options); + await this.#fetchAssertionMethod(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -101777,6 +102800,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -101827,6 +102851,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -101951,6 +102980,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -102198,6 +103231,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -102248,6 +103282,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -102372,6 +103411,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -102616,6 +103659,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -102666,6 +103710,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -102790,6 +103839,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -103014,6 +104067,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -103064,6 +104118,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -103188,6 +104247,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -103415,6 +104478,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -103465,6 +104529,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -103589,6 +104658,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -103814,6 +104887,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -103864,6 +104938,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -103988,6 +105067,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -104211,6 +105294,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -104261,6 +105345,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -104385,6 +105474,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -104608,6 +105701,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -104658,6 +105752,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -104782,6 +105881,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -105002,6 +106105,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -105052,6 +106156,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -105176,6 +106285,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -105302,6 +106415,14 @@ get gateways(): (URL)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -105340,9 +106461,15 @@ get gateways(): (URL)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchStream(v, options); + await this.#fetchStream(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -105487,6 +106614,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -105537,6 +106665,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -105661,6 +106794,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -105940,6 +107077,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -105990,6 +107128,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -106114,6 +107257,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -106438,6 +107585,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -106476,9 +107631,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAlias(v, options); + await this.#fetchAlias(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -106537,6 +107698,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -106587,6 +107749,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -106711,6 +107878,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -106975,6 +108146,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -107013,9 +108192,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchService(v, options); + await this.#fetchService(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -113552,6 +114737,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -113602,6 +114788,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -113726,6 +114917,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -113971,6 +115166,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -114021,6 +115217,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -114145,6 +115346,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -119172,6 +120377,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -119222,6 +120428,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -119346,6 +120557,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -119567,6 +120782,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -119617,6 +120833,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -119741,6 +120962,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -119960,6 +121185,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -120010,6 +121236,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -120134,6 +121365,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -132798,6 +134033,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -132848,6 +134084,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -132972,6 +134213,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -133228,6 +134473,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -133266,9 +134519,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchPublicKey(v, options); + await this.#fetchPublicKey(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -133327,6 +134586,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -133377,6 +134637,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -133501,6 +134766,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -133765,6 +135034,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -133803,9 +135080,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAssertionMethod(v, options); + await this.#fetchAssertionMethod(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -133910,6 +135193,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -133960,6 +135244,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -134084,6 +135373,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -134331,6 +135624,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -134381,6 +135675,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -134505,6 +135804,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -134749,6 +136052,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -134799,6 +136103,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -134923,6 +136232,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -135147,6 +136460,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -135197,6 +136511,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -135321,6 +136640,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -135548,6 +136871,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -135598,6 +136922,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -135722,6 +137051,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -135947,6 +137280,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -135997,6 +137331,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -136121,6 +137460,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -136344,6 +137687,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -136394,6 +137738,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -136518,6 +137867,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -136741,6 +138094,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -136791,6 +138145,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -136915,6 +138274,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -137135,6 +138498,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -137185,6 +138549,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -137309,6 +138678,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -137435,6 +138808,14 @@ get gateways(): (URL)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -137473,9 +138854,15 @@ get gateways(): (URL)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchStream(v, options); + await this.#fetchStream(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -137620,6 +139007,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -137670,6 +139058,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -137794,6 +139187,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -138073,6 +139470,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -138123,6 +139521,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -138247,6 +139650,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -138571,6 +139978,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -138609,9 +140024,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAlias(v, options); + await this.#fetchAlias(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -138670,6 +140091,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -138720,6 +140142,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -138844,6 +140271,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -139108,6 +140539,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -139146,9 +140585,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchService(v, options); + await this.#fetchService(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -145887,6 +147332,7 @@ get names(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -145937,6 +147383,11 @@ get names(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -146061,6 +147512,10 @@ get names(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -146201,6 +147656,14 @@ get names(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -146239,9 +147702,15 @@ get names(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchPreview(v, options); + await this.#fetchPreview(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -154554,6 +156023,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -154604,6 +156074,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -154728,6 +156203,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -154973,6 +156452,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -155023,6 +156503,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -155147,6 +156632,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -156814,6 +158303,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -156864,6 +158354,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -156988,6 +158483,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -157130,6 +158629,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -157168,9 +158675,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchItem(v, options); + await this.#fetchItem(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -163273,6 +164786,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -163323,6 +164837,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -163447,6 +164966,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -163703,6 +165226,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -163741,9 +165272,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchPublicKey(v, options); + await this.#fetchPublicKey(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -163802,6 +165339,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -163852,6 +165390,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -163976,6 +165519,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -164240,6 +165787,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -164278,9 +165833,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAssertionMethod(v, options); + await this.#fetchAssertionMethod(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -164385,6 +165946,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -164435,6 +165997,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -164559,6 +166126,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -164806,6 +166377,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -164856,6 +166428,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -164980,6 +166557,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -165224,6 +166805,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -165274,6 +166856,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -165398,6 +166985,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -165622,6 +167213,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -165672,6 +167264,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -165796,6 +167393,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -166023,6 +167624,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -166073,6 +167675,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -166197,6 +167804,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -166422,6 +168033,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -166472,6 +168084,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -166596,6 +168213,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -166819,6 +168440,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -166869,6 +168491,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -166993,6 +168620,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -167216,6 +168847,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -167266,6 +168898,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -167390,6 +169027,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -167610,6 +169251,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -167660,6 +169302,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -167784,6 +169431,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -167910,6 +169561,14 @@ get gateways(): (URL)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -167948,9 +169607,15 @@ get gateways(): (URL)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchStream(v, options); + await this.#fetchStream(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -168095,6 +169760,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -168145,6 +169811,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -168269,6 +169940,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -168548,6 +170223,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -168598,6 +170274,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -168722,6 +170403,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -169046,6 +170731,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -169084,9 +170777,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAlias(v, options); + await this.#fetchAlias(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -169145,6 +170844,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -169195,6 +170895,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -169319,6 +171024,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -169583,6 +171292,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -169621,9 +171338,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchService(v, options); + await this.#fetchService(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -180170,6 +181893,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -180220,6 +181944,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -180344,6 +182073,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -180600,6 +182333,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -180638,9 +182379,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchPublicKey(v, options); + await this.#fetchPublicKey(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -180699,6 +182446,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -180749,6 +182497,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -180873,6 +182626,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -181137,6 +182894,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -181175,9 +182940,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAssertionMethod(v, options); + await this.#fetchAssertionMethod(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -181282,6 +183053,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -181332,6 +183104,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -181456,6 +183233,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -181703,6 +183484,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -181753,6 +183535,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -181877,6 +183664,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -182121,6 +183912,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -182171,6 +183963,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -182295,6 +184092,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -182519,6 +184320,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -182569,6 +184371,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -182693,6 +184500,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -182920,6 +184731,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -182970,6 +184782,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -183094,6 +184911,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -183319,6 +185140,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -183369,6 +185191,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -183493,6 +185320,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -183716,6 +185547,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -183766,6 +185598,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -183890,6 +185727,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -184113,6 +185954,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -184163,6 +186005,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -184287,6 +186134,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -184507,6 +186358,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -184557,6 +186409,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -184681,6 +186538,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -184807,6 +186668,14 @@ get gateways(): (URL)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -184845,9 +186714,15 @@ get gateways(): (URL)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchStream(v, options); + await this.#fetchStream(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -184992,6 +186867,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -185042,6 +186918,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -185166,6 +187047,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -185445,6 +187330,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -185495,6 +187381,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -185619,6 +187510,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -185943,6 +187838,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -185981,9 +187884,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAlias(v, options); + await this.#fetchAlias(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -186042,6 +187951,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -186092,6 +188002,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -186216,6 +188131,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -186480,6 +188399,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -186518,9 +188445,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchService(v, options); + await this.#fetchService(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -193767,6 +195700,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -193817,6 +195751,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -193941,6 +195880,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -196182,6 +198125,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -196232,6 +198176,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -196356,6 +198305,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -196484,6 +198437,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -196522,9 +198483,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchExclusiveOption(v, options); + await this.#fetchExclusiveOption(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -196583,6 +198550,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -196633,6 +198601,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -196757,6 +198730,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -196885,6 +198862,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -196923,9 +198908,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchInclusiveOption(v, options); + await this.#fetchInclusiveOption(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -197014,6 +199005,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -197064,6 +199056,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -197188,6 +199185,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -197433,6 +199434,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -197483,6 +199485,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -197607,6 +199614,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -201233,6 +203244,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -201283,6 +203295,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -201407,6 +203424,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -201630,6 +203651,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -201680,6 +203702,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -201804,6 +203831,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -202062,6 +204093,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -202100,9 +204139,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchObject(v, options); + await this.#fetchObject(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -202161,6 +204206,7 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -202211,6 +204257,11 @@ rawPropertyDescriptors.set(this.prototype, descriptors); verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -202335,6 +204386,10 @@ rawPropertyDescriptors.set(this.prototype, descriptors); // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -202597,6 +204652,14 @@ rawPropertyDescriptors.set(this.prototype, descriptors); * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -202635,9 +204698,15 @@ rawPropertyDescriptors.set(this.prototype, descriptors); } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchRelationship(v, options); + await this.#fetchRelationship(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -209495,6 +211564,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -209545,6 +211615,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -209669,6 +211744,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -209925,6 +212004,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -209963,9 +212050,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchPublicKey(v, options); + await this.#fetchPublicKey(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -210024,6 +212117,7 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -210074,6 +212168,11 @@ get preferredUsernames(): ((string | LanguageString))[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -210198,6 +212297,10 @@ get preferredUsernames(): ((string | LanguageString))[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -210462,6 +212565,14 @@ get preferredUsernames(): ((string | LanguageString))[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -210500,9 +212611,15 @@ get preferredUsernames(): ((string | LanguageString))[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAssertionMethod(v, options); + await this.#fetchAssertionMethod(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -210607,6 +212724,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -210657,6 +212775,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -210781,6 +212904,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -211028,6 +213155,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -211078,6 +213206,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -211202,6 +213335,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -211446,6 +213583,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -211496,6 +213634,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -211620,6 +213763,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -211844,6 +213991,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -211894,6 +214042,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -212018,6 +214171,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -212245,6 +214402,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -212295,6 +214453,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -212419,6 +214582,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -212644,6 +214811,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -212694,6 +214862,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -212818,6 +214991,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -213041,6 +215218,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -213091,6 +215269,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -213215,6 +215398,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -213438,6 +215625,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -213488,6 +215676,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -213612,6 +215805,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -213832,6 +216029,7 @@ get gateways(): (URL)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -213882,6 +216080,11 @@ get gateways(): (URL)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -214006,6 +216209,10 @@ get gateways(): (URL)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -214132,6 +216339,14 @@ get gateways(): (URL)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -214170,9 +216385,15 @@ get gateways(): (URL)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchStream(v, options); + await this.#fetchStream(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -214317,6 +216538,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -214367,6 +216589,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -214491,6 +216718,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -214770,6 +217001,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -214820,6 +217052,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -214944,6 +217181,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -215268,6 +217509,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -215306,9 +217555,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchAlias(v, options); + await this.#fetchAlias(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { @@ -215367,6 +217622,7 @@ get attributionDomains(): (string)[] { verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -215417,6 +217673,11 @@ get attributionDomains(): (string)[] { verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -215541,6 +217802,10 @@ get attributionDomains(): (string)[] { // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -215805,6 +218070,14 @@ get attributionDomains(): (string)[] { * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback; } = {} ): AsyncIterable { if (this._warning != null) { @@ -215843,9 +218116,15 @@ get attributionDomains(): (string)[] { } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetchService(v, options); + await this.#fetchService(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { diff --git a/packages/vocab-tools/src/class.ts b/packages/vocab-tools/src/class.ts index fa9c52fb5..8ab947688 100644 --- a/packages/vocab-tools/src/class.ts +++ b/packages/vocab-tools/src/class.ts @@ -97,6 +97,7 @@ const RUNTIME_IMPORTS = [ "type RawPropertyValue", "type RemoteDocument", "type VocabularyObject", + "type AcceptedDocumentCallback", ].join(",\n "); /** diff --git a/packages/vocab-tools/src/property.ts b/packages/vocab-tools/src/property.ts index 771c38ee5..f3bfb8caf 100644 --- a/packages/vocab-tools/src/property.ts +++ b/packages/vocab-tools/src/property.ts @@ -74,6 +74,7 @@ async function* generateProperty( verifyPortableObject?: PortableObjectVerifier; inheritPortableObjectVerifier?: boolean; } = {}, + accepted?: {response?: RemoteDocument} ): Promise<${getTypeNames(property.range, types)} | null> { const documentLoader = options.documentLoader ?? this._documentLoader ?? getDocumentLoader(); @@ -124,6 +125,11 @@ async function* generateProperty( verifyPortableObject: childVerifier, baseUrl: parseOptions.baseUrl, }), + onAcceptedResponse: accepted == null + ? undefined + : (response) => { + accepted.response = response; + }, }); if (obj != null) { span.setAttribute( @@ -248,6 +254,10 @@ async function* generateProperty( // @ts-ignore: obj.constructor always has a typeId. obj.constructor.typeId.href ); + // Store accepted document for + if (accepted != null) { + accepted.response = fetchResult; + } span.end(); return obj; } @@ -576,6 +586,14 @@ async function* generateProperty( * @since 2.4.0 */ inheritPortableObjectVerifier?: boolean; + /** + * Called synchronously before caching or yielding each newly + * fetched, accepted target. Not called for embedded or cached + * targets. See {@link AcceptedDocumentCallback} for the full + * callback contract. + * @since 2.5.0 + */ + onAcceptedDocument?: AcceptedDocumentCallback<${getTypeNames(property.range, types)}>; } = {} ): AsyncIterable<${getTypeNames(property.range, types)}> { if (this._warning != null) { @@ -619,9 +637,15 @@ async function* generateProperty( } if (v instanceof URL) { if (options.dereference === false) continue; + const accepted = options.onAcceptedDocument == null ? + undefined + : { response: undefined as RemoteDocument | undefined} const fetched = - await this.#fetch${pascalCase(property.singularName)}(v, options); + await this.#fetch${pascalCase(property.singularName)}(v, options, accepted); if (fetched == null) continue; + if (accepted?.response != null && options.onAcceptedDocument != null) { + options.onAcceptedDocument(fetched, accepted.response); + } // Not cached, so that it is verified when the portable object // policy applies later: if (isUnverifiedPortableClaim(fetched)) { diff --git a/packages/vocab/src/dereference.test.ts b/packages/vocab/src/dereference.test.ts index 218281f1b..252812417 100644 --- a/packages/vocab/src/dereference.test.ts +++ b/packages/vocab/src/dereference.test.ts @@ -3,12 +3,190 @@ import { mockDocumentLoader, test, } from "@fedify/fixture"; -import type { DocumentLoader } from "@fedify/vocab-runtime"; -import { deepStrictEqual, ok, strictEqual } from "node:assert/strict"; +import type { DocumentLoader, RemoteDocument } from "@fedify/vocab-runtime"; +import { deepStrictEqual, ok, rejects, strictEqual } from "node:assert/strict"; import { Create, Note } from "./vocab.ts"; const objectId = new URL("https://example.com/notes/1"); +test("onAcceptedDocument reports exact fetched instances without replaying cache hits", async () => { + const response: RemoteDocument = { + contextUrl: null, + documentUrl: objectId.href, + document: { + "@context": "https://www.w3.org/ns/activitystreams", + type: "Note", + id: objectId.href, + }, + }; + const activity = new Create({ object: objectId }); + const accepted: [unknown, RemoteDocument][] = []; + let loads = 0; + const options = { + documentLoader: () => { + loads++; + return Promise.resolve(response); + }, + contextLoader: mockDocumentLoader, + onAcceptedDocument: (target: unknown, document: RemoteDocument) => { + strictEqual(accepted.length, 0); + // The parent is not hydrated until after callback delivery. + strictEqual(activity.objectId, objectId); + accepted.push([target, document]); + }, + }; + const targets = await Array.fromAsync(activity.getObjects(options)); + strictEqual(targets.length, 1); + strictEqual(accepted.length, 1); + strictEqual(accepted[0][0], targets[0]); + strictEqual(accepted[0][1], response); + const cached = await Array.fromAsync(activity.getObjects(options)); + strictEqual(cached[0], targets[0]); + strictEqual(accepted.length, 1); + strictEqual(loads, 1); +}); + +test("onAcceptedDocument skips embedded targets, disabled fetches, and singular cache hits", async () => { + const embedded = new Note({ content: "Embedded" }); + const activity = new Create({ objects: [objectId, embedded] }); + let calls = 0; + let loads = 0; + const options = { + documentLoader: (url: string) => { + loads++; + return Promise.resolve({ + contextUrl: null, + documentUrl: url, + document: { + "@context": "https://www.w3.org/ns/activitystreams", + type: "Note", + id: url, + }, + }); + }, + contextLoader: mockDocumentLoader, + onAcceptedDocument: () => { + calls++; + }, + }; + deepStrictEqual( + await Array.fromAsync( + activity.getObjects({ ...options, dereference: false }), + ), + [embedded], + ); + strictEqual(loads, 0); + const fetched = await activity.getObject(options); + ok(fetched instanceof Note); + const targets = await Array.fromAsync(activity.getObjects(options)); + strictEqual(targets[0], fetched); + strictEqual(targets[1], embedded); + strictEqual(loads, 1); + strictEqual(calls, 0); +}); + +test("onAcceptedDocument ignores suppressed parse failures", async () => { + const activity = new Create({ object: objectId }); + let calls = 0; + let loads = 0; + const targets = await Array.fromAsync( + activity.getObjects({ + suppressError: true, + documentLoader: () => { + loads++; + return Promise.resolve({ + contextUrl: null, + documentUrl: objectId.href, + document: { + "@context": "https://www.w3.org/ns/activitystreams", + type: "Note", + id: 42, + }, + }); + }, + contextLoader: mockDocumentLoader, + onAcceptedDocument: () => { + calls++; + }, + }), + ); + deepStrictEqual(targets, []); + strictEqual(loads, 1); + strictEqual(calls, 0); +}); + +test("onAcceptedDocument exceptions propagate under suppressError and retries fetch again", async () => { + const activity = new Create({ object: objectId }); + const failure = new Error("Callback failed"); + let loads = 0; + let calls = 0; + const options = { + suppressError: true, + documentLoader: (url: string) => { + loads++; + return Promise.resolve({ + contextUrl: null, + documentUrl: url, + document: { + "@context": "https://www.w3.org/ns/activitystreams", + type: "Note", + id: url, + }, + }); + }, + contextLoader: mockDocumentLoader, + onAcceptedDocument: () => { + calls++; + if (calls === 1) throw failure; + }, + }; + await rejects( + Array.fromAsync(activity.getObjects(options)), + (error) => error === failure, + ); + strictEqual(loads, 1); + const targets = await Array.fromAsync(activity.getObjects(options)); + strictEqual(targets.length, 1); + strictEqual(loads, 2); + strictEqual(calls, 2); +}); + +test("onAcceptedDocument reports unverified portable claims on every fetching pass", async () => { + const activity = new Create({ object: objectId }); + const targets: unknown[] = []; + const responses: RemoteDocument[] = []; + let loads = 0; + const options = { + crossOrigin: "trust" as const, + documentLoader: (url: string) => { + loads++; + const response = { + contextUrl: null, + documentUrl: url, + document: { + "@context": "https://www.w3.org/ns/activitystreams", + type: "Note", + id: "ap://did:key:z6Mkabc/note", + }, + }; + responses.push(response); + return Promise.resolve(response); + }, + contextLoader: mockDocumentLoader, + onAcceptedDocument: (target: unknown, response: RemoteDocument) => { + strictEqual(response, responses[targets.length]); + targets.push(target); + }, + }; + for (let i = 0; i < 2; i++) { + const fetched = await Array.fromAsync(activity.getObjects(options)); + strictEqual(fetched.length, 1); + strictEqual(fetched[0], targets[i]); + strictEqual(targets.length, i + 1); + } + strictEqual(loads, 2); +}); + test("dereference: false skips references without lookup spans or hydration", async () => { const [tracerProvider, exporter] = createTestTracerProvider(); const requests: string[] = []; diff --git a/packages/vocab/src/gateway.test.ts b/packages/vocab/src/gateway.test.ts index eca3c22a4..5af392088 100644 --- a/packages/vocab/src/gateway.test.ts +++ b/packages/vocab/src/gateway.test.ts @@ -16,7 +16,7 @@ import { withGatewayHints, } from "@fedify/vocab-runtime"; import fetchMock from "fetch-mock"; -import { deepStrictEqual, ok, rejects } from "node:assert/strict"; +import { deepStrictEqual, ok, rejects, strictEqual } from "node:assert/strict"; import { lookupObject, traverseCollection } from "./lookup.ts"; import { assertInstanceOf } from "./utils.ts"; import { @@ -98,6 +98,83 @@ function createActivity(object: string = objectId): Promise { ); } +test("onAcceptedDocument reports only the exact winning gateway response", async () => { + const wrongIdentity = note(`ap://${did}/other`); + const rejected = note(); + const winner = note(); + const loader = createLoader({ + [`https://wrong.example${gatewayPath}`]: wrongIdentity, + [`https://rejected.example${gatewayPath}`]: rejected, + [`https://winner.example${gatewayPath}`]: winner, + }); + const responses: RemoteDocument[] = []; + const accepted: [unknown, RemoteDocument][] = []; + const verifiedDocuments: unknown[] = []; + const activity = await createActivity(); + const targets = await Array.fromAsync( + activity.getObjects({ + documentLoader: async (url) => { + const response = await loader(url); + responses.push(response); + return response; + }, + contextLoader: mockDocumentLoader, + gateways: [ + "https://wrong.example", + "https://rejected.example", + "https://winner.example", + ], + verifyPortableObject: (document) => { + verifiedDocuments.push(document); + return Promise.resolve({ verified: document === winner }); + }, + onAcceptedDocument: (target, response) => { + accepted.push([target, response]); + }, + }), + ); + strictEqual(targets.length, 1); + strictEqual(accepted.length, 1); + strictEqual(accepted[0][0], targets[0]); + strictEqual(accepted[0][1], responses[2]); + strictEqual(accepted[0][1].document, winner); + deepStrictEqual(verifiedDocuments, [rejected, winner]); + deepStrictEqual(loader.fetched, [ + `https://wrong.example${gatewayPath}`, + `https://rejected.example${gatewayPath}`, + `https://winner.example${gatewayPath}`, + ]); +}); + +test("onAcceptedDocument exceptions do not advance gateways and retries fetch again", async () => { + const first = `https://first.example${gatewayPath}`; + const second = `https://second.example${gatewayPath}`; + const loader = createLoader({ [first]: note(), [second]: note() }); + const activity = await createActivity(); + const failure = new Error("Callback failed"); + let calls = 0; + const options = { + suppressError: true, + documentLoader: loader, + contextLoader: mockDocumentLoader, + gateways: ["https://first.example", "https://second.example"], + verifyPortableObject: createVerifier(), + onAcceptedDocument: () => { + calls++; + if (calls === 1) throw failure; + }, + }; + await rejects( + Array.fromAsync(activity.getObjects(options)), + (error) => error === failure, + ); + deepStrictEqual(loader.fetched, [first]); + const targets = await Array.fromAsync(activity.getObjects(options)); + strictEqual(targets.length, 1); + strictEqual(calls, 2); + deepStrictEqual(loader.fetched, [first, first]); +}); + test("getObject() dereferences a portable IRI through explicit gateways", async () => { const document = note(); const documentLoader = createLoader({ diff --git a/packages/vocab/src/mod.ts b/packages/vocab/src/mod.ts index 0a6e270df..4d52c44b2 100644 --- a/packages/vocab/src/mod.ts +++ b/packages/vocab/src/mod.ts @@ -58,6 +58,7 @@ export * from "./type.ts"; export * from "./vocab.ts"; export { LanguageString } from "@fedify/vocab-runtime"; export type { + AcceptedDocumentCallback, Decimal, DocumentLoader, DocumentLoaderOptions,