Class ScratchOrgCache

A Time To Live configuration file where each entry is timestamped and removed once the TTL has expired.

Example

import { Duration } from '@salesforce/kit';
const config = await TTLConfig.create({
  isGlobal: false,
  ttl: Duration.days(1)
});

Hierarchy

TTLConfig<TTLConfig.Options, CachedOptions>
- ScratchOrgCache

Methods

access

access(perm?: number): Promise<boolean>
Determines if the config file is read/write accessible. Returns true if the user has capabilities specified by perm.
Parameters
- Optional perm: number
  
  The permission.
  
  See https://nodejs.org/dist/latest/docs/api/fs.html#fs_fs_access_path_mode_callback
Returns Promise<boolean>
Inherited from TTLConfig.access
- Defined in src/config/configFile.ts:123

accessSync

accessSync(perm?: number): boolean
Determines if the config file is read/write accessible. Returns true if the user has capabilities specified by perm.
Parameters
- Optional perm: number
  
  The permission.
  
  See https://nodejs.org/dist/latest/docs/api/fs.html#fs_fs_access_path_mode_callback
Returns boolean
Inherited from TTLConfig.accessSync
- Defined in src/config/configFile.ts:140

awaitEach

awaitEach(actionFn: ((key: string, value: AnyJson) => Promise<void>)): Promise<void>
Asynchronously invokes actionFn once for each key-value pair present in the config object.

Returns
Parameters
- actionFn: ((key: string, value: AnyJson) => Promise<void>)
  
  The function (key: string, value: ConfigValue) => Promise<void> to be called for each element.
  - - (key: string, value: AnyJson): Promise<void>
    - Parameters
      
      key: string
      
      value: AnyJson
      
      Returns Promise<void>
Returns Promise<void>
Inherited from TTLConfig.awaitEach
- Defined in src/config/configStore.ts:291

clear

clear(): void
Removes all key/value pairs from the config object.

Returns void
Inherited from TTLConfig.clear
- Defined in src/config/configStore.ts:229

entries

entries(): ConfigEntry[]
Returns an array of ConfigEntry for each element in the config.

Returns ConfigEntry[]
Inherited from TTLConfig.entries
- Defined in src/config/configStore.ts:106

exists

exists(): Promise<boolean>
Check to see if the config file exists. Returns true if the config file exists and has access, false otherwise.

Returns Promise<boolean>
Inherited from TTLConfig.exists
- Defined in src/config/configFile.ts:268

existsSync

existsSync(): boolean
Check to see if the config file exists. Returns true if the config file exists and has access, false otherwise.

Returns boolean
Inherited from TTLConfig.existsSync
- Defined in src/config/configFile.ts:275

forEach

forEach(actionFn: ((key: string, value: AnyJson) => void)): void
Invokes actionFn once for each key-value pair present in the config object.
Parameters
- actionFn: ((key: string, value: AnyJson) => void)
  
  The function (key: string, value: ConfigValue) => void to be called for each element.
  - - (key: string, value: AnyJson): void
    - Parameters
      
      key: string
      
      value: AnyJson
      
      Returns void
Returns void
Inherited from TTLConfig.forEach
- Defined in src/config/configStore.ts:277

get

get<K>(key: K, decrypt?: boolean): Entry<CachedOptions>
Returns the value associated to the key, or undefined if there is none.
Type Parameters
- K extends string
Parameters
- key: K
  
  The key. Supports query key like a.b[0].
- Optional decrypt: boolean
  
  If it is an encrypted key, decrypt the value. If the value is an object, a clone will be returned.
Returns Entry<CachedOptions>
Inherited from TTLConfig.get
- Defined in src/config/configStore.ts:117
get<V>(key: string, decrypt?: boolean): V
Type Parameters
- V = AnyJson
Parameters
- key: string
- Optional decrypt: boolean
Returns V
Inherited from TTLConfig.get
- Defined in src/config/configStore.ts:118

getContents

getContents(decrypt?: boolean): Contents<CachedOptions>
Returns the entire config contents.

NOTE: Data will still be encrypted unless decrypt is passed in. A clone of the data will be returned to prevent storing un-encrypted data in memory and potentially saving to the file system.
Parameters
- decrypt: boolean = false
Returns Contents<CachedOptions>
Inherited from TTLConfig.getContents
- Defined in src/config/configStore.ts:250

getKeysByValue

getKeysByValue(value: AnyJson): string[]
Returns the list of keys that contain a value.
Parameters
- value: AnyJson
  
  The value to filter keys on.
Returns string[]
Inherited from TTLConfig.getKeysByValue
- Defined in src/config/configStore.ts:138

getLatestEntry

getLatestEntry(): Nullable<[string, Entry<CachedOptions>]>
Returns Nullable<[string, Entry<CachedOptions>]>
Inherited from TTLConfig.getLatestEntry
- Defined in src/config/ttlConfig.ts:29

getLatestKey

getLatestKey(): Nullable<string>
Returns Nullable<string>
Inherited from TTLConfig.getLatestKey
- Defined in src/config/ttlConfig.ts:37

getPath

getPath(): string
Returns the absolute path to the config file.

The first time getPath is called, the path is resolved and becomes immutable. This allows implementers to override options properties, like filePath, on the init method for async creation. If that is required for creation, the config files can not be synchronously created.

Returns string
Inherited from TTLConfig.getPath
- Defined in src/config/configFile.ts:332

has

has(key: string): boolean
Returns a boolean asserting whether a value has been associated to the key in the config object or not.
Parameters
- key: string
  
  The key. Supports query key like a.b[0].
Returns boolean
Inherited from TTLConfig.has
- Defined in src/config/configStore.ts:149

isExpired

isExpired(dateTime: number, value: CachedOptions & {
timestamp: string;
}): boolean
Parameters
- dateTime: number
- value: CachedOptions & {
  timestamp: string;
  }
Returns boolean
Inherited from TTLConfig.isExpired
- Defined in src/config/ttlConfig.ts:42

isGlobal

isGlobal(): boolean
Returns true if this config is using the global path, false otherwise.

Returns boolean
Inherited from TTLConfig.isGlobal
- Defined in src/config/configFile.ts:355

keys

keys(): string[]
Returns an array that contains the keys for each element in the config object.

Returns string[]
Inherited from TTLConfig.keys
- Defined in src/config/configStore.ts:156

read

read(throwOnNotFound??: boolean, force??: boolean): Promise<Contents<CachedOptions>>
Read the config file and set the config contents. Returns the config contents of the config file. As an optimization, files are only read once per process and updated in memory and via write(). To force a read from the filesystem pass force=true. Throws SfError{ name: 'UnexpectedJsonFileFormat' } There was a problem reading or parsing the file.
Parameters
- Optional throwOnNotFound: boolean = false
- Optional force: boolean = false
Returns Promise<Contents<CachedOptions>>
Inherited from TTLConfig.read
- Defined in src/config/configFile.ts:158

readSync

readSync(throwOnNotFound??: boolean, force??: boolean): Contents<CachedOptions>
Read the config file and set the config contents. Returns the config contents of the config file. As an optimization, files are only read once per process and updated in memory and via write(). To force a read from the filesystem pass force=true. Throws SfError{ name: 'UnexpectedJsonFileFormat' } There was a problem reading or parsing the file.
Parameters
- Optional throwOnNotFound: boolean = false
- Optional force: boolean = false
Returns Contents<CachedOptions>
Inherited from TTLConfig.readSync
- Defined in src/config/configFile.ts:194

set

set(key: string, value: Partial<Entry<CachedOptions>>): void
Sets the value for the key in the config object. This will override the existing value. To do a partial update, use BaseConfigStore.update.
Parameters
- key: string
  
  The key. Supports query key like a.b[0].
- value: Partial<Entry<CachedOptions>>
  
  The value.
Returns void
Inherited from TTLConfig.set
- Defined in src/config/ttlConfig.ts:25

setContents

setContents(contents?: Contents<CachedOptions>): void
Sets the entire config contents.
Parameters
- contents: Contents<CachedOptions> = ...
  
  The contents.
Returns void
Inherited from TTLConfig.setContents
- Defined in src/config/configStore.ts:265

setContentsFromObject

setContentsFromObject<U>(obj: U): void
Convert an object to a ConfigContents and set it as the config contents.
Type Parameters
- U extends JsonMap<U>
Parameters
- obj: U
  
  The object.
Returns void
Inherited from TTLConfig.setContentsFromObject
- Defined in src/config/configStore.ts:313

stat

stat(): Promise<Stats>
Get the stats of the file. Returns the stats of the file.

fs.stat

Returns Promise<Stats>
Inherited from TTLConfig.stat
- Defined in src/config/configFile.ts:284

statSync

statSync(): Stats
Get the stats of the file. Returns the stats of the file.

fs.stat

Returns Stats
Inherited from TTLConfig.statSync
- Defined in src/config/configFile.ts:293

toObject

toObject(): JsonMap
Convert the config object to a JSON object. Returns the config contents. Same as calling ConfigStore.getContents

Returns JsonMap
Inherited from TTLConfig.toObject
- Defined in src/config/configStore.ts:304

unlink

unlink(): Promise<void>
Delete the config file if it exists.

Throws Error{ name: 'TargetFileNotFound' } If the ConfigFile.getFilename file is not found. fs.unlink

Returns Promise<void>
Inherited from TTLConfig.unlink
- Defined in src/config/configFile.ts:303

unlinkSync

unlinkSync(): void
Delete the config file if it exists.

Throws Error{ name: 'TargetFileNotFound' } If the ConfigFile.getFilename file is not found. fs.unlink

Returns void
Inherited from TTLConfig.unlinkSync
- Defined in src/config/configFile.ts:317

unset

unset(key: string): boolean
Returns true if an element in the config object existed and has been removed, or false if the element does not exist. BaseConfigStore.has will return false afterwards.
Parameters
- key: string
  
  The key. Supports query key like a.b[0].
Returns boolean
Inherited from TTLConfig.unset
- Defined in src/config/configStore.ts:203

unsetAll

unsetAll(keys: string[]): boolean
Returns true if all elements in the config object existed and have been removed, or false if all the elements do not exist (some may have been removed). BaseConfigStore.has(key) will return false afterwards.
Parameters
- keys: string[]
  
  The keys. Supports query keys like a.b[0].
Returns boolean
Inherited from TTLConfig.unsetAll
- Defined in src/config/configStore.ts:222

update

update<K>(key: K, value: Partial<Entry<CachedOptions>>): void
Updates the value for the key in the config object. If the value is an object, it will be merged with the existing object.
Type Parameters
- K extends string
Parameters
- key: K
  
  The key. Supports query key like a.b[0].
- value: Partial<Entry<CachedOptions>>
  
  The value.
Returns void
Inherited from TTLConfig.update
- Defined in src/config/configStore.ts:187
update<V>(key: string, value: Partial<V>): void
Type Parameters
- V = AnyJson
Parameters
- key: string
- value: Partial<V>
Returns void
Inherited from TTLConfig.update
- Defined in src/config/configStore.ts:188

values

values(): AnyJson[]
Returns an array that contains the values for each element in the config object.

Returns AnyJson[]
Inherited from TTLConfig.values
- Defined in src/config/configStore.ts:236

write

write(newContents?: Contents<CachedOptions>): Promise<Contents<CachedOptions>>
Write the config file with new contents. If no new contents are provided it will write the existing config contents that were set from ConfigFile.read, or an empty file if ConfigFile.read was not called.
Parameters
- Optional newContents: Contents<CachedOptions>
  
  The new contents of the file.
Returns Promise<Contents<CachedOptions>>
Inherited from TTLConfig.write
- Defined in src/config/configFile.ts:225

writeSync

writeSync(newContents?: Contents<CachedOptions>): Contents<CachedOptions>
Write the config file with new contents. If no new contents are provided it will write the existing config contents that were set from ConfigFile.read, or an empty file if ConfigFile.read was not called.
Parameters
- Optional newContents: Contents<CachedOptions>
  
  The new contents of the file.
Returns Contents<CachedOptions>
Inherited from TTLConfig.writeSync
- Defined in src/config/configFile.ts:248

`Static` getDefaultOptions

getDefaultOptions(): TTLConfig.Options
Returns the default options for the config file.

Returns TTLConfig.Options
Overrides TTLConfig.getDefaultOptions
- Defined in src/org/scratchOrgCache.ts:31

`Static` getFileName

getFileName(): string
Returns the config's filename.

Returns string
Overrides TTLConfig.getFileName
- Defined in src/org/scratchOrgCache.ts:27

`Static` resolveRootFolder

resolveRootFolder(isGlobal: boolean): Promise<string>
Helper used to determine what the local and global folder point to. Returns the file path of the root folder.
Parameters
- isGlobal: boolean
  
  True if the config should be global. False for local.
Returns Promise<string>
Inherited from TTLConfig.resolveRootFolder
- Defined in src/config/configFile.ts:102

`Static` resolveRootFolderSync

resolveRootFolderSync(isGlobal: boolean): string
Helper used to determine what the local and global folder point to. Returns the file path of the root folder.
Parameters
- isGlobal: boolean
  
  True if the config should be global. False for local.
Returns string
Inherited from TTLConfig.resolveRootFolderSync
- Defined in src/config/configFile.ts:111

`Static` unset

unset(key: string): Promise<void>
Parameters
- key: string
Returns Promise<void>
- Defined in src/org/scratchOrgCache.ts:41

Class ScratchOrgCache

Example

Hierarchy

Index

Methods

Methods

access

Parameters

Optional perm: number

Returns Promise<boolean>

accessSync

Parameters

Optional perm: number

Returns boolean

awaitEach

Returns

Parameters

actionFn: ((key: string, value: AnyJson) => Promise<void>)

Parameters

key: string

value: AnyJson

Returns Promise<void>

Returns Promise<void>

clear

Returns void

entries

Returns ConfigEntry[]

exists

Returns Promise<boolean>

existsSync

Returns boolean

forEach

Parameters

actionFn: ((key: string, value: AnyJson) => void)

Parameters

key: string

value: AnyJson

Returns void

Returns void

get

Type Parameters

K extends string

Parameters

key: K

Optional decrypt: boolean

Returns Entry<CachedOptions>

Type Parameters

V = AnyJson

Parameters

key: string

Optional decrypt: boolean

Returns V

getContents

Parameters

decrypt: boolean = false

Returns Contents<CachedOptions>

getKeysByValue

Parameters

value: AnyJson

Returns string[]

getLatestEntry

Returns Nullable<[string, Entry<CachedOptions>]>

getLatestKey

Returns Nullable<string>

getPath

Returns string

has

Parameters

key: string

Returns boolean

isExpired

Parameters

dateTime: number

value: CachedOptions & { timestamp: string; }

Returns boolean

isGlobal

Returns boolean

keys

Returns string[]

read

`Optional` perm: number

`Optional` perm: number

`Optional` decrypt: boolean

`Optional` decrypt: boolean

value: CachedOptions & {
timestamp: string;
}

`Optional` throwOnNotFound: boolean = false

`Optional` force: boolean = false

`Optional` throwOnNotFound: boolean = false

`Optional` force: boolean = false

`Optional` newContents: Contents<CachedOptions>

`Optional` newContents: Contents<CachedOptions>

`Static` getDefaultOptions

`Static` getFileName

`Static` resolveRootFolder