From a19021aee559d1156352d8548d89ec306e747561 Mon Sep 17 00:00:00 2001 From: "aegir[bot]" Date: Wed, 23 Oct 2024 14:57:25 +0000 Subject: [PATCH] docs: update documentation [skip ci] --- functions/_helia_verified_fetch.createVerifiedFetch.html | 2 +- functions/_helia_verified_fetch.verifiedFetch-1.html | 4 ++-- interfaces/_helia_verified_fetch.CIDDetail.html | 4 ++-- interfaces/_helia_verified_fetch.CIDDetailError.html | 4 ++-- interfaces/_helia_verified_fetch.ContentTypeParser.html | 2 +- .../_helia_verified_fetch.CreateVerifiedFetchInit.html | 8 ++++---- .../_helia_verified_fetch.CreateVerifiedFetchOptions.html | 8 ++++---- interfaces/_helia_verified_fetch.ResourceDetail.html | 4 ++-- interfaces/_helia_verified_fetch.VerifiedFetch.html | 4 ++-- interfaces/_helia_verified_fetch.VerifiedFetchInit.html | 8 ++++---- types/_helia_verified_fetch.BubbledProgressEvents.html | 2 +- types/_helia_verified_fetch.Resource.html | 2 +- ..._helia_verified_fetch.VerifiedFetchProgressEvents.html | 2 +- 13 files changed, 27 insertions(+), 27 deletions(-) diff --git a/functions/_helia_verified_fetch.createVerifiedFetch.html b/functions/_helia_verified_fetch.createVerifiedFetch.html index 95807ec8..8cff7f55 100644 --- a/functions/_helia_verified_fetch.createVerifiedFetch.html +++ b/functions/_helia_verified_fetch.createVerifiedFetch.html @@ -1,2 +1,2 @@ createVerifiedFetch | Helia Verified Fetch

Function createVerifiedFetch

Settings

Member Visibility

Theme

\ No newline at end of file +

Parameters

Returns Promise<VerifiedFetch>

Settings

Member Visibility

Theme

\ No newline at end of file diff --git a/functions/_helia_verified_fetch.verifiedFetch-1.html b/functions/_helia_verified_fetch.verifiedFetch-1.html index d046daa2..af4356bd 100644 --- a/functions/_helia_verified_fetch.verifiedFetch-1.html +++ b/functions/_helia_verified_fetch.verifiedFetch-1.html @@ -1,3 +1,3 @@ -verifiedFetch | Helia Verified Fetch

Function verifiedFetch

Methods

start +verifiedFetch | Helia Verified Fetch

Function verifiedFetch

Methods

start stop -

Methods

start

stop

Settings

Member Visibility

Theme

On This Page

startstop
\ No newline at end of file +

Methods

start

stop

Settings

Member Visibility

Theme

On This Page

startstop
\ No newline at end of file diff --git a/interfaces/_helia_verified_fetch.CIDDetail.html b/interfaces/_helia_verified_fetch.CIDDetail.html index c74102da..459d7c43 100644 --- a/interfaces/_helia_verified_fetch.CIDDetail.html +++ b/interfaces/_helia_verified_fetch.CIDDetail.html @@ -1,3 +1,3 @@ -CIDDetail | Helia Verified Fetch

Interface CIDDetail

interface CIDDetail {
    cid: CID<unknown, number, number, Version>;
    path: string;
}

Hierarchy (view full)

Properties

cid +CIDDetail | Helia Verified Fetch

Interface CIDDetail

interface CIDDetail {
    cid: CID<unknown, number, number, Version>;
    path: string;
}

Hierarchy (view full)

Properties

cid path -

Properties

cid

cid: CID<unknown, number, number, Version>

path

path: string

Settings

Member Visibility

Theme

On This Page

cidpath
\ No newline at end of file +

Properties

cid

cid: CID<unknown, number, number, Version>

path

path: string

Settings

Member Visibility

Theme

On This Page

cidpath
\ No newline at end of file diff --git a/interfaces/_helia_verified_fetch.CIDDetailError.html b/interfaces/_helia_verified_fetch.CIDDetailError.html index e5ed95bb..38a76f26 100644 --- a/interfaces/_helia_verified_fetch.CIDDetailError.html +++ b/interfaces/_helia_verified_fetch.CIDDetailError.html @@ -1,4 +1,4 @@ -CIDDetailError | Helia Verified Fetch

Interface CIDDetailError

interface CIDDetailError {
    cid: CID<unknown, number, number, Version>;
    error: Error;
    path: string;
}

Hierarchy (view full)

Properties

cid +CIDDetailError | Helia Verified Fetch

Interface CIDDetailError

interface CIDDetailError {
    cid: CID<unknown, number, number, Version>;
    error: Error;
    path: string;
}

Hierarchy (view full)

Properties

cid error path -

Properties

cid

cid: CID<unknown, number, number, Version>

error

error: Error

path

path: string

Settings

Member Visibility

Theme

On This Page

ciderrorpath
\ No newline at end of file +

Properties

cid

cid: CID<unknown, number, number, Version>

error

error: Error

path

path: string

Settings

Member Visibility

Theme

On This Page

ciderrorpath
\ No newline at end of file diff --git a/interfaces/_helia_verified_fetch.ContentTypeParser.html b/interfaces/_helia_verified_fetch.ContentTypeParser.html index c038e2b0..f444e2c6 100644 --- a/interfaces/_helia_verified_fetch.ContentTypeParser.html +++ b/interfaces/_helia_verified_fetch.ContentTypeParser.html @@ -4,4 +4,4 @@ undefined, application/octet-stream will be used.

interface ContentTypeParser ((bytes, fileName?) => undefined | string | Promise<undefined | string>)

Settings

Member Visibility

Theme

\ No newline at end of file +

Parameters

Returns undefined | string | Promise<undefined | string>

Settings

Member Visibility

Theme

\ No newline at end of file diff --git a/interfaces/_helia_verified_fetch.CreateVerifiedFetchInit.html b/interfaces/_helia_verified_fetch.CreateVerifiedFetchInit.html index 7b32c55c..4747fca7 100644 --- a/interfaces/_helia_verified_fetch.CreateVerifiedFetchInit.html +++ b/interfaces/_helia_verified_fetch.CreateVerifiedFetchInit.html @@ -1,6 +1,6 @@ CreateVerifiedFetchInit | Helia Verified Fetch

Interface CreateVerifiedFetchInit

Instead of passing a Helia instance, you can pass a list of gateways and routers, and a HeliaHTTP instance will be created for you.

-
interface CreateVerifiedFetchInit {
    allowInsecure?: boolean;
    allowLocal?: boolean;
    dnsResolvers?: DNSResolver[] | DNSResolvers;
    gateways: string[];
    routers?: string[];
}

Properties

allowInsecure? +
interface CreateVerifiedFetchInit {
    allowInsecure?: boolean;
    allowLocal?: boolean;
    dnsResolvers?: DNSResolver[] | DNSResolvers;
    gateways: string[];
    routers?: string[];
}

Properties

allowInsecure? allowLocal? dnsResolvers? gateways @@ -13,18 +13,18 @@ useful in testing environments.

Default

false
-

Optional allowLocal

allowLocal?: boolean

By default we will not connect to any HTTP Gateways providers over local or +

Optional allowLocal

allowLocal?: boolean

By default we will not connect to any HTTP Gateways providers over local or loopback addresses, this is because they are typically running on remote peers that have published private addresses by mistate.

Pass true here to connect to local Gateways as well, this may be useful in testing environments.

Default

false
-

Optional dnsResolvers

dnsResolvers?: DNSResolver[] | DNSResolvers

In order to parse DNSLink records, we need to resolve DNS queries. You can +

Optional dnsResolvers

dnsResolvers?: DNSResolver[] | DNSResolvers

In order to parse DNSLink records, we need to resolve DNS queries. You can pass a list of DNS resolvers that we will provide to the @helia/ipns instance for you. You must construct them using the dnsJsonOverHttps or dnsOverHttps functions exported from @helia/ipns/dns-resolvers.

We use cloudflare and google's dnsJsonOverHttps resolvers by default.

Default

[dnsJsonOverHttps('https://cloudflare-dns.com/dns-query'),dnsJsonOverHttps('https://dns.google/resolve')]
-

gateways

gateways: string[]

Optional routers

routers?: string[]

Settings

Member Visibility

Theme

On This Page

allowInsecureallowLocaldnsResolversgatewaysrouters
\ No newline at end of file +

gateways

gateways: string[]

Optional routers

routers?: string[]

Settings

Member Visibility

Theme

On This Page

allowInsecureallowLocaldnsResolversgatewaysrouters
\ No newline at end of file diff --git a/interfaces/_helia_verified_fetch.CreateVerifiedFetchOptions.html b/interfaces/_helia_verified_fetch.CreateVerifiedFetchOptions.html index 2515d26e..d8a05d27 100644 --- a/interfaces/_helia_verified_fetch.CreateVerifiedFetchOptions.html +++ b/interfaces/_helia_verified_fetch.CreateVerifiedFetchOptions.html @@ -1,4 +1,4 @@ -CreateVerifiedFetchOptions | Helia Verified Fetch

Interface CreateVerifiedFetchOptions

interface CreateVerifiedFetchOptions {
    contentTypeParser?: ContentTypeParser;
    sessionCacheSize?: number;
    sessionTTLms?: number;
}

Properties

contentTypeParser? +CreateVerifiedFetchOptions | Helia Verified Fetch

Interface CreateVerifiedFetchOptions

interface CreateVerifiedFetchOptions {
    contentTypeParser?: ContentTypeParser;
    sessionCacheSize?: number;
    sessionTTLms?: number;
}

Properties

contentTypeParser? sessionCacheSize? sessionTTLms?

Properties

Optional contentTypeParser

contentTypeParser?: ContentTypeParser

A function to handle parsing content type from bytes. The function you @@ -7,12 +7,12 @@ Content-Type header in the response.

Default

undefined
-

Optional sessionCacheSize

sessionCacheSize?: number

Blockstore sessions are cached for reuse with requests with the same +

Optional sessionCacheSize

sessionCacheSize?: number

Blockstore sessions are cached for reuse with requests with the same base URL or CID. This parameter controls how many to cache. Once this limit is reached older/less used sessions will be evicted from the cache.

Default

100
-

Optional sessionTTLms

sessionTTLms?: number

How long each blockstore session should stay in the cache for.

+

Optional sessionTTLms

sessionTTLms?: number

How long each blockstore session should stay in the cache for.

Default

60000
-

Settings

Member Visibility

Theme

On This Page

contentTypeParsersessionCacheSizesessionTTLms
\ No newline at end of file +

Settings

Member Visibility

Theme

On This Page

contentTypeParsersessionCacheSizesessionTTLms
\ No newline at end of file diff --git a/interfaces/_helia_verified_fetch.ResourceDetail.html b/interfaces/_helia_verified_fetch.ResourceDetail.html index bda78303..6a35bdc9 100644 --- a/interfaces/_helia_verified_fetch.ResourceDetail.html +++ b/interfaces/_helia_verified_fetch.ResourceDetail.html @@ -1,2 +1,2 @@ -ResourceDetail | Helia Verified Fetch

Interface ResourceDetail

interface ResourceDetail {
    resource: Resource;
}

Properties

resource -

Properties

resource

resource: Resource

Settings

Member Visibility

Theme

On This Page

resource
\ No newline at end of file +ResourceDetail | Helia Verified Fetch

Interface ResourceDetail

interface ResourceDetail {
    resource: Resource;
}

Properties

resource +

Properties

resource

resource: Resource

Settings

Member Visibility

Theme

On This Page

resource
\ No newline at end of file diff --git a/interfaces/_helia_verified_fetch.VerifiedFetch.html b/interfaces/_helia_verified_fetch.VerifiedFetch.html index 05f93916..52f64ccd 100644 --- a/interfaces/_helia_verified_fetch.VerifiedFetch.html +++ b/interfaces/_helia_verified_fetch.VerifiedFetch.html @@ -1,3 +1,3 @@ -VerifiedFetch | Helia Verified Fetch

Interface VerifiedFetch

interface VerifiedFetch {
    start(): Promise<void>;
    stop(): Promise<void>;
    (resource, options?): Promise<Response>;
}

Methods

start +VerifiedFetch | Helia Verified Fetch

Interface VerifiedFetch

interface VerifiedFetch {
    start(): Promise<void>;
    stop(): Promise<void>;
    (resource, options?): Promise<Response>;
}

Methods

start stop -

Methods

start

stop

Settings

Member Visibility

Theme

On This Page

startstop
\ No newline at end of file +

Methods

start

stop

Settings

Member Visibility

Theme

On This Page

startstop
\ No newline at end of file diff --git a/interfaces/_helia_verified_fetch.VerifiedFetchInit.html b/interfaces/_helia_verified_fetch.VerifiedFetchInit.html index c7f18b73..732a9b70 100644 --- a/interfaces/_helia_verified_fetch.VerifiedFetchInit.html +++ b/interfaces/_helia_verified_fetch.VerifiedFetchInit.html @@ -2,7 +2,7 @@

This interface contains all the same fields as the options object passed to fetch in browsers, plus an onProgress option to listen for progress events.

-
interface VerifiedFetchInit {
    allowInsecure?: boolean;
    allowLocal?: boolean;
    body?: null | BodyInit;
    cache?: RequestCache;
    credentials?: RequestCredentials;
    headers?: HeadersInit;
    integrity?: string;
    keepalive?: boolean;
    method?: string;
    mode?: RequestMode;
    onProgress?: ((evt) => void);
    priority?: RequestPriority;
    redirect?: RequestRedirect;
    referrer?: string;
    referrerPolicy?: ReferrerPolicy;
    session?: boolean;
    signal?: null | AbortSignal;
    window?: null;
}

Hierarchy

Properties

allowInsecure? +
interface VerifiedFetchInit {
    allowInsecure?: boolean;
    allowLocal?: boolean;
    body?: null | BodyInit;
    cache?: RequestCache;
    credentials?: RequestCredentials;
    headers?: HeadersInit;
    integrity?: string;
    keepalive?: boolean;
    method?: string;
    mode?: RequestMode;
    onProgress?: ((evt) => void);
    priority?: RequestPriority;
    redirect?: RequestRedirect;
    referrer?: string;
    referrerPolicy?: ReferrerPolicy;
    session?: boolean;
    signal?: null | AbortSignal;
    window?: null;
}

Hierarchy

Properties

allowInsecure? allowLocal? body? cache? @@ -28,14 +28,14 @@ useful in testing environments.

Default

false
-

Optional allowLocal

allowLocal?: boolean

By default we will not connect to any HTTP Gateways providers over local or +

Optional allowLocal

allowLocal?: boolean

By default we will not connect to any HTTP Gateways providers over local or loopback addresses, this is because they are typically running on remote peers that have published private addresses by mistate.

Pass true here to connect to local Gateways as well, this may be useful in testing environments.

Default

false
-

Optional body

body?: null | BodyInit

A BodyInit object or null to set request's body.

+

Optional body

body?: null | BodyInit

A BodyInit object or null to set request's body.

Optional cache

cache?: RequestCache

A string indicating how the request will interact with the browser's cache to set request's cache.

Optional credentials

credentials?: RequestCredentials

A string indicating whether credentials will be sent with the request always, never, or only when sent to a same-origin URL. Sets request's credentials.

Optional headers

headers?: HeadersInit

A Headers object, an object literal, or an array of two-item arrays to set request's headers.

@@ -57,6 +57,6 @@ argument is true for both fetch requests.

Default

true
-

Optional signal

signal?: null | AbortSignal

An AbortSignal to set request's signal.

+

Optional signal

signal?: null | AbortSignal

An AbortSignal to set request's signal.

Optional window

window?: null

Can only be null. Used to disassociate request from any Window.

Settings

Member Visibility

Theme

On This Page

allowInsecureallowLocalbodycachecredentialsheadersintegritykeepalivemethodmodeonProgresspriorityredirectreferrerreferrerPolicysessionsignalwindow
\ No newline at end of file diff --git a/types/_helia_verified_fetch.BubbledProgressEvents.html b/types/_helia_verified_fetch.BubbledProgressEvents.html index 1977b388..af1465b2 100644 --- a/types/_helia_verified_fetch.BubbledProgressEvents.html +++ b/types/_helia_verified_fetch.BubbledProgressEvents.html @@ -1 +1 @@ -BubbledProgressEvents | Helia Verified Fetch

Type alias BubbledProgressEvents

BubbledProgressEvents: ExporterProgressEvents | GetBlockProgressEvents | ResolveDNSLinkProgressEvents

Settings

Member Visibility

Theme

\ No newline at end of file +BubbledProgressEvents | Helia Verified Fetch

Type alias BubbledProgressEvents

BubbledProgressEvents: ExporterProgressEvents | GetBlockProgressEvents | ResolveDNSLinkProgressEvents

Settings

Member Visibility

Theme

\ No newline at end of file diff --git a/types/_helia_verified_fetch.Resource.html b/types/_helia_verified_fetch.Resource.html index 963e4e73..9318cc99 100644 --- a/types/_helia_verified_fetch.Resource.html +++ b/types/_helia_verified_fetch.Resource.html @@ -1,2 +1,2 @@ Resource | Helia Verified Fetch

Type alias Resource

Resource: string | CID

The types for the first argument of the verifiedFetch function.

-

Settings

Member Visibility

Theme

\ No newline at end of file +

Settings

Member Visibility

Theme

\ No newline at end of file diff --git a/types/_helia_verified_fetch.VerifiedFetchProgressEvents.html b/types/_helia_verified_fetch.VerifiedFetchProgressEvents.html index 6032b954..a7ceaef9 100644 --- a/types/_helia_verified_fetch.VerifiedFetchProgressEvents.html +++ b/types/_helia_verified_fetch.VerifiedFetchProgressEvents.html @@ -1 +1 @@ -VerifiedFetchProgressEvents | Helia Verified Fetch

Type alias VerifiedFetchProgressEvents

VerifiedFetchProgressEvents: ProgressEvent<"verified-fetch:request:start", CIDDetail> | ProgressEvent<"verified-fetch:request:info", string> | ProgressEvent<"verified-fetch:request:progress:chunk", CIDDetail> | ProgressEvent<"verified-fetch:request:end", CIDDetail> | ProgressEvent<"verified-fetch:request:error", CIDDetailError>

Settings

Member Visibility

Theme

\ No newline at end of file +VerifiedFetchProgressEvents | Helia Verified Fetch

Type alias VerifiedFetchProgressEvents

VerifiedFetchProgressEvents: ProgressEvent<"verified-fetch:request:start", CIDDetail> | ProgressEvent<"verified-fetch:request:info", string> | ProgressEvent<"verified-fetch:request:progress:chunk", CIDDetail> | ProgressEvent<"verified-fetch:request:end", CIDDetail> | ProgressEvent<"verified-fetch:request:error", CIDDetailError>

Settings

Member Visibility

Theme

\ No newline at end of file