Skip to content

Classes

RegistryClient

Defined in: index.ts:145

Constructors

new RegistryClient()
new RegistryClient(options): RegistryClient

Defined in: index.ts:149

Parameters
options

RegistryClientOptions

Returns

RegistryClient

Properties

agent
agent: RetryAgent

Defined in: index.ts:146

cache
cache: Cache

Defined in: index.ts:147

Methods

login()
login(registry): Promise<void>

Defined in: index.ts:249

Log into the registry specified

Does not return the token or expose it, just saves to the auth keychain and returns void if it worked. Otherwise, error is raised.

Parameters
registry

string

Returns

Promise<void>

logout()
logout(registry): Promise<void>

Defined in: index.ts:217

Log out from the registry specified, attempting to destroy the token if the registry supports that endpoint.

Parameters
registry

string

Returns

Promise<void>

request()
request(url, options): Promise<CacheEntry>

Defined in: index.ts:331

Parameters
url

string | URL

options

RegistryClientRequestOptions = {}

Returns

Promise<CacheEntry>

scroll()
scroll<T>(
url,
options,
seek?): Promise<T[]>

Defined in: index.ts:186

Fetch the entire set of a paginated list of objects

Type Parameters

T

Parameters
url

string | URL

options

RegistryClientRequestOptions = {}

seek?

(obj) => boolean

Returns

Promise<T[]>

seek()
seek<T>(
url,
seek,
options): Promise<undefined | T>

Defined in: index.ts:205

find a given item in a paginated set

Type Parameters

T

Parameters
url

string | URL

seek

(obj) => boolean

options

RegistryClientRequestOptions = {}

Returns

Promise<undefined | T>

webAuthOpener()
webAuthOpener(__namedParameters): Promise<TokenResponse>

Defined in: index.ts:286

Given a WebAuthChallenge, open the loginUrl in a browser and hang on the doneUrl until it returns a TokenResponse object.

Parameters
__namedParameters

WebAuthChallenge

Returns

Promise<TokenResponse>

Type Aliases

RegistryClientOptions

type RegistryClientOptions = object

Defined in: index.ts:42

Type declaration

cache?
optional cache: string;

Path on disk where the cache should be stored

Default

$HOME/.config/vlt/cache

fetch-retries?
optional fetch-retries: number;

Number of retries to perform when encountering network errors or likely-transient errors from git hosts.

fetch-retry-factor?
optional fetch-retry-factor: number;

The exponential backoff factor to use when retrying git hosts

fetch-retry-maxtimeout?
optional fetch-retry-maxtimeout: number;

Maximum number of milliseconds between two retries

fetch-retry-mintimeout?
optional fetch-retry-mintimeout: number;

Number of milliseconds before starting first retry


RegistryClientRequestOptions

type RegistryClientRequestOptions = Omit<
Dispatcher.RequestOptions,
'method' | 'path'
> &
object

Defined in: index.ts:61

Type declaration

cache?
optional cache: false;

Set to false to suppress ANY lookups from cache. This will also prevent storing the result to the cache.

integrity?
optional integrity: Integrity;

Provide an SRI string to verify integrity of the item being fetched.

This is only relevant when it must make a request to the registry. Once in the local disk cache, items are assumed to be trustworthy.

maxRedirections?
optional maxRedirections: number;

Follow up to 10 redirections by default. Set this to 0 to just return the 3xx response. If the max redirections are expired, and we still get a redirection response, then fail the request. Redirection cycles are always treated as an error.

method?
optional method: Dispatcher.DispatchOptions["method"];

Method is optional, defaults to ‘GET’

path?
optional path: string;

path should not be set when using the RegistryClient. It will be overwritten with the path on the URL being requested. This only here for compliance with the DispatchOptions base type.

Deprecated

Token

type Token = `Bearer ${string}` | `Basic ${string}`

Defined in: auth.ts:3


TokenResponse

type TokenResponse = object

Defined in: token-response.ts:1

Type declaration

token
token: string

WebAuthChallenge

type WebAuthChallenge = object

Defined in: web-auth-challenge.ts:1

Type declaration

doneUrl
doneUrl: string
loginUrl
loginUrl: string

Variables

kc

const kc: Keychain<Token>

Defined in: auth.ts:6


userAgent

const userAgent: string

Defined in: index.ts:125

References

CacheEntry

Re-exports CacheEntry

JSONObj

Re-exports JSONObj