blob: 3f55095d015980754f8b8cb2734132fc841aef5a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
|
import { BaseHashInput, IBaseHashOptions } from './hash-fn';
import { IHashReader } from './hash-reader';
/**
* A blake3 hash. Quite similar to Node's crypto hashing.
*
* Note that you must call {@link IHash#dispose} or {@link IHash#done} when
* you're finished with it to free memory.
*/
export interface IHasher<T> {
/**
* Adds the given data to the hash.
* @throws {Error} if {@link IHash#digest} has already been called.
*/
update(data: BaseHashInput): this;
/**
* Returns a digest of the hash.
*
* If `dispose: false` is given in the options, the hash will not
* automatically be disposed of, allowing you to continue updating
* it after obtaining the current reader.
*/
digest(options?: IBaseHashOptions & {
dispose?: boolean;
}): T;
/**
* Returns a {@link HashReader} for the current hash.
*
* If `dispose: false` is given in the options, the hash will not
* automatically be disposed of, allowing you to continue updating
* it after obtaining the current reader.
*/
reader(options?: {
dispose?: boolean;
}): IHashReader<T>;
/**
* Frees data associated with the hash. This *must* be called if
* {@link IHash#digest} is not called in order to free memory.
*/
dispose(): void;
}
/**
* @hidden
*/
export interface IInternalHash<Reader> {
free(): void;
reader(): Reader;
update(bytes: Uint8Array): void;
digest(into: Uint8Array): void;
}
export interface IHasherDigestOptions extends IBaseHashOptions {
dispose?: boolean;
}
/**
* Base implementation of hashing.
*/
export declare class BaseHash<Binary extends Uint8Array, InternalReader, Reader extends IHashReader<Binary>> implements IHasher<Binary> {
private readonly alloc;
private readonly getReader;
private hash;
constructor(implementation: IInternalHash<InternalReader>, alloc: (length: number) => Binary, getReader: (internal: InternalReader) => Reader);
/**
* @inheritdoc
*/
update(data: BaseHashInput): this;
/**
* @inheritdoc
*/
digest({ length, dispose }?: IHasherDigestOptions): Binary;
/**
* @inheritdoc
*/
reader({ dispose }?: {
dispose?: boolean;
}): Reader;
/**
* @inheritdoc
*/
dispose(): void;
}
|
