Class EncryptedDrive

Hierarchy (view full)

Drive
- EncryptedDrive

Constructors

constructor

new EncryptedDrive(signer, publisher): EncryptedDrive
Parameters
- signer: Signer
- publisher: Publisher
Returns EncryptedDrive
Inherited from Drive.constructor
- Defined in src/Drive.ts:129

Properties

`Protected` _metadata

_metadata: DriveMetadata = ...

`Private` decoder

decoder: TextDecoder = ...

`Private` encoder

encoder: TextEncoder = ...

`Optional` event

event?: EventTemplate | SignedEvent

locked

locked: boolean = true

logn

logn: number = DEFAULT_SCRYPT_LOGN

modified

modified: boolean = false

whether the drive has been modified and needs to be saved

publisher

publisher: Publisher

signer

signer: Signer

tree

tree: TreeFolder

`Static` prefixed

prefixed: string | boolean

Accessors

address

get address(): "" | `naddr1${string}`
Returns "" | `naddr1${string}`
Inherited from Drive.address
- Defined in src/Drive.ts:112

description

get description(): string
Returns string
Inherited from Drive.description
- Defined in src/Drive.ts:92
set description(v): void
Parameters
- v: string
Returns void
Inherited from Drive.description
- Defined in src/Drive.ts:95

identifier

get identifier(): string
Returns string
Inherited from Drive.identifier
- Defined in src/Drive.ts:76
set identifier(v): void
Parameters
- v: string
Returns void
Inherited from Drive.identifier
- Defined in src/Drive.ts:79

name

get name(): string
Returns string
Inherited from Drive.name
- Defined in src/Drive.ts:84
set name(v): void
Parameters
- v: string
Returns void
Inherited from Drive.name
- Defined in src/Drive.ts:87

pubkey

get pubkey(): undefined | string
Returns undefined | string
Inherited from Drive.pubkey
- Defined in src/Drive.ts:73

servers

get servers(): string[]
Returns string[]
Inherited from Drive.servers
- Defined in src/Drive.ts:100
set servers(v): void
Parameters
- v: string[]
Returns void
Inherited from Drive.servers
- Defined in src/Drive.ts:103

Methods

[iterator]

[iterator](): IterableIterator<TreeFile | TreeFolder>

Iterate over the files

Returns IterableIterator<TreeFile | TreeFolder>

Example

for(let fileOrFolder of drive){
  if(fileOrFolder instanceof TreeFolder){
    // keep looping
  }
  else if(fileOrFolder instanceof TreeFile){
    console.log(fileOrFolder.path)
  }
}

addListener

addListener<T>(event, fn, context?): this
Type Parameters
- T extends keyof EventMap
Parameters
- event: T
- fn: ((...args) => void)
  - - (...args): void
    - Parameters
      Rest ...args: ArgumentMap<EventMap>[Extract<T, keyof EventMap>]
      Returns void
- Optional context: any
Returns this
Inherited from Drive.addListener
- Defined in node_modules/eventemitter3/index.d.ts:45

`Protected` createEventTemplate

createEventTemplate(): EventTemplate
Returns EventTemplate
Overrides Drive.createEventTemplate
- Defined in src/EncryptedDrive.ts:72

decryptBlob

decryptBlob(blob, type?): Promise<Blob>
Decrypt a Blob with the drives password
Parameters
- blob: Blob
- Optional type: string
Returns Promise<Blob>
- Defined in src/EncryptedDrive.ts:122

downloadFile

downloadFile(path, additionalServers?): Promise<null | File>
Download and Decrypt a file at the provided path
Parameters
- path: Path
- additionalServers: string[] = []
Returns Promise<null | File>
Overrides Drive.downloadFile
- Defined in src/EncryptedDrive.ts:133

emit

emit<T>(event, ...args): boolean
Calls each of the listeners registered for a given event.
Type Parameters
- T extends keyof EventMap
Parameters
- event: T
- Rest ...args: ArgumentMap<EventMap>[Extract<T, keyof EventMap>]
Returns boolean
Inherited from Drive.emit
- Defined in node_modules/eventemitter3/index.d.ts:32

encryptBlob

encryptBlob(blob): Promise<Blob>
Encrypt a Blob with the drives password
Parameters
- blob: Blob
Returns Promise<Blob>
- Defined in src/EncryptedDrive.ts:111

eventNames

eventNames(): (keyof EventMap)[]
Return an array listing the events for which the emitter has registered listeners.

Returns (keyof EventMap)[]
Inherited from Drive.eventNames
- Defined in node_modules/eventemitter3/index.d.ts:15

getFile

getFile(path): TreeFile
Parameters
- path: Path
Returns TreeFile
Inherited from Drive.getFile
- Defined in src/Drive.ts:231

getFileURL

getFileURL(path, additionalServers?): string
Parameters
- path: Path
- additionalServers: string[] = []
Returns string
Inherited from Drive.getFileURL
- Defined in src/Drive.ts:235

getFolder

getFolder(path, create?): TreeFolder
Gets the folder at the path, pass create=true in to create an empty folder
Parameters
- path: Path
- create: boolean = false
Returns TreeFolder
Inherited from Drive.getFolder
- Defined in src/Drive.ts:226

getPath

getPath(path, create?): TreeFile | TreeFolder
Gets the file or folder at the path
Parameters
- path: Path
- create: boolean = false
Returns TreeFile | TreeFolder
Inherited from Drive.getPath
- Defined in src/Drive.ts:221

hasHash

hasHash(sha256): boolean
Checks if there is a file with a matching sha256 hash
Parameters
- sha256: string
Returns boolean
Inherited from Drive.hasHash
- Defined in src/Drive.ts:286

listenerCount

listenerCount(event): number
Return the number of listeners listening to a given event.
Parameters
- event: keyof EventMap
Returns number
Inherited from Drive.listenerCount
- Defined in node_modules/eventemitter3/index.d.ts:27

listeners

listeners<T>(event): ((...args) => void)[]
Return the listeners registered for a given event.
Type Parameters
- T extends keyof EventMap
Parameters
- event: T
Returns ((...args) => void)[]
Inherited from Drive.listeners
- Defined in node_modules/eventemitter3/index.d.ts:20

lock

lock(): void
Returns void
- Defined in src/EncryptedDrive.ts:42

move

move(src, dest): void
Moves the file or folder from src to dest
Parameters
- src: Path
- dest: Path
Returns void
Inherited from Drive.move
- Defined in src/Drive.ts:271

off

off<T>(event, fn?, context?, once?): this
Type Parameters
- T extends keyof EventMap
Parameters
- event: T
- Optional fn: ((...args) => void)
  - - (...args): void
    - Parameters
      Rest ...args: ArgumentMap<EventMap>[Extract<T, keyof EventMap>]
      Returns void
- Optional context: any
- Optional once: boolean
Returns this
Inherited from Drive.off
- Defined in node_modules/eventemitter3/index.d.ts:69

on

on<T>(event, fn, context?): this
Add a listener for a given event.
Type Parameters
- T extends keyof EventMap
Parameters
- event: T
- fn: ((...args) => void)
  - - (...args): void
    - Parameters
      Rest ...args: ArgumentMap<EventMap>[Extract<T, keyof EventMap>]
      Returns void
- Optional context: any
Returns this
Inherited from Drive.on
- Defined in node_modules/eventemitter3/index.d.ts:40

once

once<T>(event, fn, context?): this
Add a one-time listener for a given event.
Type Parameters
- T extends keyof EventMap
Parameters
- event: T
- fn: ((...args) => void)
  - - (...args): void
    - Parameters
      Rest ...args: ArgumentMap<EventMap>[Extract<T, keyof EventMap>]
      Returns void
- Optional context: any
Returns this
Inherited from Drive.once
- Defined in node_modules/eventemitter3/index.d.ts:54

`Protected` readEvent

readEvent(event): DriveMetadata
Parameters
- event: EventTemplate | SignedEvent
Returns DriveMetadata
Overrides Drive.readEvent
- Defined in src/EncryptedDrive.ts:59

remove

remove(path): void
Removes the file or folder at the path
Parameters
- path: Path
Returns void
Inherited from Drive.remove
- Defined in src/Drive.ts:264

removeAllListeners

removeAllListeners(event?): this
Remove all listeners, or those of the specified event.
Parameters
- Optional event: keyof EventMap
Returns this
Inherited from Drive.removeAllListeners
- Defined in node_modules/eventemitter3/index.d.ts:79

removeListener

removeListener<T>(event, fn?, context?, once?): this
Remove the listeners of a given event.
Type Parameters
- T extends keyof EventMap
Parameters
- event: T
- Optional fn: ((...args) => void)
  - - (...args): void
    - Parameters
      Rest ...args: ArgumentMap<EventMap>[Extract<T, keyof EventMap>]
      Returns void
- Optional context: any
- Optional once: boolean
Returns this
Inherited from Drive.removeListener
- Defined in node_modules/eventemitter3/index.d.ts:63

reset

reset(): void
Reset any pending changes

Returns void
Inherited from Drive.reset
- Defined in src/Drive.ts:212

`Protected` resetFromEvent

resetFromEvent(): void
Returns void
Inherited from Drive.resetFromEvent
- Defined in src/Drive.ts:204

save

save(): Promise<undefined | SignedEvent>
Save any pending changes to nostr

Returns Promise<undefined | SignedEvent>
Inherited from Drive.save
- Defined in src/Drive.ts:185

setFile

setFile(path, metadata): TreeFile
Updates or creates a new file at the path
Parameters
- path: Path
- metadata: FileMetadata
Returns TreeFile
Inherited from Drive.setFile
- Defined in src/Drive.ts:278

setPassword

setPassword(password, logn?): void
Used to set the password on new drives
Parameters
- password: string
- logn: number = DEFAULT_SCRYPT_LOGN
Returns void
- Defined in src/EncryptedDrive.ts:52

unlock

unlock(password): Promise<void>
Attempts to decrypt the drive with the provided password If successful it will set locked=false and save the password in memory
Parameters
- password: string
Returns Promise<void>
- Defined in src/EncryptedDrive.ts:29

update

update(event): boolean
Parameters
- event: EventTemplate | SignedEvent
Returns boolean
Overrides Drive.update
- Defined in src/EncryptedDrive.ts:88

`Static` fromEvent

fromEvent(event, signer, publisher): Drive
Parameters
- event: SignedEvent
- signer: Signer
- publisher: Publisher
Returns Drive
Inherited from Drive.fromEvent
- Defined in src/Drive.ts:123

Class EncryptedDrive

Hierarchy (view full)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns EncryptedDrive

Properties

Protected _metadata

Private decoder

Private encoder

Optional event

locked

logn

modified

publisher

signer

tree

Static prefixed

Accessors

address

Returns "" | `naddr1${string}`

description

Returns string

Parameters

Returns void

identifier

Returns string

Parameters

Returns void

name

Returns string

Parameters

Returns void

pubkey

Returns undefined | string

servers

Returns string[]

Parameters

Returns void

Methods

[iterator]

Returns IterableIterator<TreeFile | TreeFolder>

Example

addListener

Type Parameters

Parameters

Parameters

Returns void

Returns this

Protected createEventTemplate

Returns EventTemplate

decryptBlob

Parameters

Returns Promise<Blob>

downloadFile

Parameters

Returns Promise<null | File>

emit

Type Parameters

Parameters

Returns boolean

encryptBlob

Parameters

Returns Promise<Blob>

eventNames

Returns (keyof EventMap)[]

getFile

Parameters

Returns TreeFile

getFileURL

Parameters

Returns string

getFolder

Parameters

Returns TreeFolder

`Protected` _metadata

`Private` decoder

`Private` encoder

`Optional` event

`Static` prefixed

`Protected` createEventTemplate

`Protected` readEvent

`Protected` resetFromEvent

`Static` fromEvent