@substrate-system/crypto-stream 0.0.33

package/dist/src/keychain.js

@@ -0,0 +1,267 @@
+import { webcrypto } from '@substrate-system/one-webcrypto';
+import * as u from 'uint8arrays';
+import { decryptStream, decryptStreamRange, encryptStream, KEY_LENGTH, } from './ece.js';
+import { randomBuf, joinBufs, asBufferSource } from './util.js';
+export { encryptedSize, plaintextSize } from './ece.js';
+const IV_LENGTH = 12;
+const encoder = new TextEncoder();
+export class Keychain {
+    key;
+    salt;
+    mainKeyPromise;
+    metaKeyPromise;
+    authTokenPromise;
+    constructor(key, salt) {
+        this.key = decodeBits(key);
+        this.salt = decodeBits(salt);
+        this.mainKeyPromise = webcrypto.subtle.importKey('raw', this.key, 'HKDF', false, ['deriveBits', 'deriveKey']);
+        this.metaKeyPromise = this.mainKeyPromise
+            .then(mainKey => webcrypto.subtle.deriveKey({
+            name: 'HKDF',
+            hash: 'SHA-256',
+            salt: this.salt,
+            info: encoder.encode('metadata')
+        }, mainKey, {
+            name: 'AES-GCM',
+            length: 128
+        }, false, ['encrypt', 'decrypt']));
+        this.authTokenPromise = this.mainKeyPromise
+            .then(mainKey => webcrypto.subtle.deriveBits({
+            name: 'HKDF',
+            hash: 'SHA-256',
+            salt: this.salt,
+            info: encoder.encode('authentication')
+        }, mainKey, 128))
+            .then(authTokenBuf => new Uint8Array(authTokenBuf));
+    }
+    /**
+     * Get an authentication header as a static method.
+     */
+    static async AuthHeader(secretKey, salt) {
+        const key = decodeBits(secretKey);
+        const mainKey = await webcrypto.subtle.importKey('raw', key, 'HKDF', false, ['deriveBits', 'deriveKey']);
+        const token = await webcrypto.subtle.deriveBits({
+            name: 'HKDF',
+            hash: 'SHA-256',
+            salt: decodeBits(salt),
+            info: encoder.encode('authentication')
+        }, mainKey, 128);
+        return Keychain.Header(arrayToB64(new Uint8Array(token)));
+    }
+    static Header(writeToken) {
+        return `Bearer sync-v1 ${writeToken}`;
+    }
+    /**
+     * Get the main key as a `base64url` encoded string
+     */
+    get keyB64() {
+        return arrayToB64Url(this.key);
+    }
+    /**
+     * Get the salt as base64 string
+     */
+    get saltB64() {
+        return arrayToB64(this.salt);
+    }
+    /**
+     * get a promise for the auth token.
+     * @returns {Promise<Uint8Array>}
+     */
+    async authToken() {
+        return await this.authTokenPromise;
+    }
+    /**
+     * Get the auth token as a base64 string
+     */
+    async authTokenB64() {
+        const authToken = await this.authToken();
+        return arrayToB64(authToken);
+    }
+    /**
+     * Get a header string: `Bearer sync-v1 ${authTokenB64}`.
+     * Pass in a token, or else this will use the `authToken` derived from
+     * the main key.
+     */
+    async authHeader(tokenString) {
+        if (tokenString) {
+            return `Bearer sync-v1 ${tokenString}`;
+        }
+        const authTokenB64 = await this.authTokenB64();
+        return `Bearer sync-v1 ${authTokenB64}`;
+    }
+    /**
+     * Set the auth token
+     * @param authToken The new token
+     */
+    setAuthToken(authToken) {
+        this.authTokenPromise = Promise.resolve(decodeBits(authToken));
+    }
+    /**
+     * Take a stream, return an encrypted stream.
+     * @param stream Input stream
+     * @returns {Promise<ReadableStream>}
+     */
+    async encryptStream(stream) {
+        if (!(stream instanceof ReadableStream)) {
+            throw new TypeError('This is not a readable stream');
+        }
+        const mainKey = await this.mainKeyPromise;
+        return encryptStream(stream, mainKey);
+    }
+    /**
+     * Encrypt and return some data; don't stream.
+     *
+     * NOTE: This generates a new key each time it is called, via
+     * `this.generateKey`.
+     *
+     * @param bytes
+     * @param {{ iv?:Uint8Array, size?:number }} [opts] Optional params,
+     * `iv` and `size`. If `size` is omitted, default is 16 bytes. `iv` is
+     * a random 12 bits, will be generated if not passed in.
+     * @returns {Promise<Uint8Array>}
+     */
+    async encryptBytes(bytes, opts) {
+        const iv = opts?.iv || randomBuf(12);
+        const encryptedRecordBuf = await webcrypto.subtle.encrypt({
+            name: 'AES-GCM',
+            iv: asBufferSource(iv),
+        }, await this.generateKey(opts?.size), asBufferSource(bytes));
+        return joinBufs(iv, encryptedRecordBuf);
+    }
+    /**
+     * Decrypt in memory, not streaming.
+     */
+    async decryptBytes(bytes) {
+        const key = await this.generateKey();
+        // `iv` is prepended to the encrypted text
+        const iv = bytes.slice(0, 12);
+        const cipherBytes = bytes.slice(12);
+        const msgBuf = await webcrypto.subtle.decrypt({
+            name: 'AES-GCM',
+            iv
+        }, key, cipherBytes);
+        return msgBuf;
+    }
+    /**
+     * Derive a new AES-GCM key from the main key.
+     *
+     * @param {number} [keyLength] Optional size for the key, in bytes, eg,
+     * `16` or `32`.
+     * @returns {Promise<CryptoKey>}
+     */
+    async generateKey(keyLength) {
+        const keySize = (keyLength || KEY_LENGTH) * 8;
+        return webcrypto.subtle.deriveKey({
+            name: 'HKDF',
+            hash: 'SHA-256',
+            salt: this.salt,
+            info: encoder.encode('Content-Encoding: aes128gcm\0')
+        }, (await this.mainKeyPromise), {
+            name: 'AES-GCM',
+            length: keySize
+        }, false, ['encrypt', 'decrypt']);
+    }
+    /**
+     * Take an encrypted stream, return a decrypted stream.
+     * @param encryptedStream The input (encrypted) stream
+     * @returns The decrypted stream
+     */
+    async decryptStream(encryptedStream) {
+        if (!(encryptedStream instanceof ReadableStream)) {
+            throw new TypeError('encryptedStream is not a ReadableStream');
+        }
+        const mainKey = await this.mainKeyPromise;
+        return decryptStream(encryptedStream, mainKey);
+    }
+    /**
+     * Returns an object containing `ranges`, an array of objects
+     * containing `offset` and `length` integers specifying the encrypted byte
+     * ranges that are needed to decrypt the client's specified range, and a
+     * `decrypt` function.
+     *
+     * @param {number} offset Integer
+     * @param {number} length Integer
+     * @param {number} totalEncryptedLength Integer
+     * @returns {Promise<{ ranges, decrypt }>}
+     */
+    async decryptStreamRange(offset, length, totalEncryptedLength) {
+        if (!Number.isInteger(offset)) {
+            throw new TypeError('offset');
+        }
+        if (!Number.isInteger(length)) {
+            throw new TypeError('length');
+        }
+        if (!Number.isInteger(totalEncryptedLength)) {
+            throw new TypeError('totalEncryptedLength');
+        }
+        const mainKey = await this.mainKeyPromise;
+        return decryptStreamRange(mainKey, offset, length, totalEncryptedLength);
+    }
+    async encryptMeta(meta) {
+        if (!(meta instanceof Uint8Array)) {
+            throw new TypeError('`meta` should be Uint8Array');
+        }
+        const iv = webcrypto.getRandomValues(new Uint8Array(IV_LENGTH));
+        const metaKey = await this.metaKeyPromise;
+        const encryptedMetaBuf = await webcrypto.subtle.encrypt({
+            name: 'AES-GCM',
+            iv,
+            tagLength: 128
+        }, metaKey, asBufferSource(meta));
+        const encryptedMeta = new Uint8Array(encryptedMetaBuf);
+        const ivEncryptedMeta = new Uint8Array(IV_LENGTH + encryptedMeta.byteLength);
+        ivEncryptedMeta.set(iv, 0);
+        ivEncryptedMeta.set(encryptedMeta, IV_LENGTH);
+        return ivEncryptedMeta;
+    }
+    async decryptMeta(ivEncryptedMeta) {
+        if (!(ivEncryptedMeta instanceof Uint8Array)) {
+            throw new Error('ivEncryptedMeta');
+        }
+        const iv = ivEncryptedMeta.slice(0, IV_LENGTH);
+        const encryptedMeta = ivEncryptedMeta.slice(IV_LENGTH);
+        const metaKey = await this.metaKeyPromise;
+        const metaBuf = await webcrypto.subtle.decrypt({
+            name: 'AES-GCM',
+            iv,
+            tagLength: 128
+        }, metaKey, encryptedMeta);
+        const meta = new Uint8Array(metaBuf);
+        return meta;
+    }
+}
+function arrayToB64(array) {
+    return u.toString(array, 'base64pad');
+}
+/**
+ * Return the given Uint8Array as a base64url string.
+ * @param array Uint8Array
+ * @returns `base64url` encoded string
+ */
+function arrayToB64Url(array) {
+    return u.toString(array, 'base64url');
+}
+function b64ToArray(str) {
+    // Accept both base64 and base64url input by normalizing url-safe chars.
+    return u.fromString(str.replace(/-/g, '+').replace(/_/g, '/'), 'base64');
+}
+function decodeBits(bitsB64) {
+    let result;
+    if (bitsB64 instanceof Uint8Array) {
+        result = asBufferSource(bitsB64);
+    }
+    else if (typeof bitsB64 === 'string') {
+        result = b64ToArray(bitsB64);
+    }
+    else if (bitsB64 == null) {
+        result = webcrypto.getRandomValues(new Uint8Array(16));
+    }
+    else {
+        throw new Error('Must be Uint8Array, string, or nullish');
+    }
+    if (result.byteLength !== 16) {
+        throw new Error('Invalid byteLength: must be 16 bytes');
+    }
+    return result;
+}
+//# sourceMappingURL=keychain.js.map

package/dist/src/keychain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keychain.js","sourceRoot":"","sources":["../../src/keychain.ts"],"names":[],"mappings":"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"}

package/dist/src/slice-transformer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Tranform stream that outputs chunks of a specific size. Final chunk may be
+ * less than the desired size.
+ *
+ * firstChunkSize: The size of the first chunk
+ * restChunkSize:  The size of all subsequent chunks, optional. If omitted, the
+ *                 size of subsequenct chunks will be same as `firstChunkSize`
+ */
+export declare class SliceTransformer {
+    chunkSize: number;
+    restChunkSize: number;
+    partialChunk: Uint8Array;
+    offset: number;
+    constructor(firstChunkSize: number, restChunkSize?: number);
+    send(record: Uint8Array, controller: TransformStreamDefaultController): void;
+    transform(chunk: Uint8Array, controller: TransformStreamDefaultController): void;
+    flush(controller: TransformStreamDefaultController): void;
+}
+//# sourceMappingURL=slice-transformer.d.ts.map

package/dist/src/slice-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slice-transformer.d.ts","sourceRoot":"","sources":["../../src/slice-transformer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qBAAa,gBAAgB;IACzB,SAAS,EAAC,MAAM,CAAA;IAChB,aAAa,EAAC,MAAM,CAAA;IACpB,YAAY,EAAC,UAAU,CAAA;IACvB,MAAM,EAAC,MAAM,CAAA;gBAEA,cAAc,EAAC,MAAM,EAAE,aAAa,CAAC,EAAC,MAAM;IAQzD,IAAI,CAAE,MAAM,EAAC,UAAU,EAAE,UAAU,EAAC,gCAAgC,GAAE,IAAI;IAO1E,SAAS,CACL,KAAK,EAAC,UAAU,EAChB,UAAU,EAAC,gCAAgC,GAC7C,IAAI;IA6BN,KAAK,CAAE,UAAU,EAAC,gCAAgC,GAAE,IAAI;CAK3D"}

package/dist/src/slice-transformer.js

@@ -0,0 +1,58 @@
+/**
+ * Tranform stream that outputs chunks of a specific size. Final chunk may be
+ * less than the desired size.
+ *
+ * firstChunkSize: The size of the first chunk
+ * restChunkSize:  The size of all subsequent chunks, optional. If omitted, the
+ *                 size of subsequenct chunks will be same as `firstChunkSize`
+ */
+export class SliceTransformer {
+    chunkSize;
+    restChunkSize;
+    partialChunk;
+    offset;
+    constructor(firstChunkSize, restChunkSize) {
+        this.chunkSize = firstChunkSize;
+        this.restChunkSize = restChunkSize || firstChunkSize;
+        this.partialChunk = new Uint8Array(this.chunkSize);
+        this.offset = 0; // offset into `partialChunk`
+    }
+    send(record, controller) {
+        controller.enqueue(record);
+        this.chunkSize = this.restChunkSize;
+        this.partialChunk = new Uint8Array(this.chunkSize);
+        this.offset = 0;
+    }
+    transform(chunk, controller) {
+        let i = 0; // offset into `chunk`
+        if (this.offset > 0) {
+            const len = Math.min(chunk.byteLength, this.chunkSize - this.offset);
+            this.partialChunk.set(chunk.subarray(0, len), this.offset);
+            this.offset += len;
+            i += len;
+            if (this.offset === this.chunkSize) {
+                this.send(this.partialChunk, controller);
+            }
+        }
+        while (i < chunk.byteLength) {
+            const remainingBytes = chunk.byteLength - i;
+            if (remainingBytes >= this.chunkSize) {
+                const record = chunk.slice(i, i + this.chunkSize);
+                i += this.chunkSize;
+                this.send(record, controller);
+            }
+            else {
+                const end = chunk.slice(i, i + remainingBytes);
+                i += end.byteLength;
+                this.partialChunk.set(end);
+                this.offset = end.byteLength;
+            }
+        }
+    }
+    flush(controller) {
+        if (this.offset > 0) {
+            controller.enqueue(this.partialChunk.subarray(0, this.offset));
+        }
+    }
+}
+//# sourceMappingURL=slice-transformer.js.map

package/dist/src/slice-transformer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slice-transformer.js","sourceRoot":"","sources":["../../src/slice-transformer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,OAAO,gBAAgB;IACzB,SAAS,CAAO;IAChB,aAAa,CAAO;IACpB,YAAY,CAAW;IACvB,MAAM,CAAO;IAEb,YAAa,cAAqB,EAAE,aAAqB;QACrD,IAAI,CAAC,SAAS,GAAG,cAAc,CAAA;QAC/B,IAAI,CAAC,aAAa,GAAG,aAAa,IAAI,cAAc,CAAA;QAEpD,IAAI,CAAC,YAAY,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAClD,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA,CAAE,6BAA6B;IAClD,CAAC;IAED,IAAI,CAAE,MAAiB,EAAE,UAA2C;QAChE,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,aAAa,CAAA;QACnC,IAAI,CAAC,YAAY,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAClD,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA;IACnB,CAAC;IAED,SAAS,CACL,KAAgB,EAChB,UAA2C;QAE3C,IAAI,CAAC,GAAG,CAAC,CAAA,CAAE,sBAAsB;QAEjC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAA;YACpE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;YAC1D,IAAI,CAAC,MAAM,IAAI,GAAG,CAAA;YAClB,CAAC,IAAI,GAAG,CAAA;YAER,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;gBACjC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAA;YAC5C,CAAC;QACL,CAAC;QAED,OAAO,CAAC,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;YAC1B,MAAM,cAAc,GAAG,KAAK,CAAC,UAAU,GAAG,CAAC,CAAA;YAC3C,IAAI,cAAc,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAA;gBACjD,CAAC,IAAI,IAAI,CAAC,SAAS,CAAA;gBACnB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;YACjC,CAAC;iBAAM,CAAC;gBACJ,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,CAAA;gBAC9C,CAAC,IAAI,GAAG,CAAC,UAAU,CAAA;gBACnB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;gBAC1B,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,UAAU,CAAA;YAChC,CAAC;QACL,CAAC;IACL,CAAC;IAED,KAAK,CAAE,UAA2C;QAC9C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClB,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;QAClE,CAAC;IACL,CAAC;CACJ"}

package/dist/src/transform-stream.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Pipe a readable stream through a transformer. Returns a result, where
+ * result.readable is the readable end of the TransformStream and
+ * result.done is a promise that fulfills or rejects once the stream is done.
+ * Includes a shim for environments where TransformStream is not available.
+ */
+export declare function transformStream(sourceReadable: ReadableStream, transformer: Transformer): {
+    readable: ReadableStream;
+    done: Promise<unknown>;
+};
+//# sourceMappingURL=transform-stream.d.ts.map

package/dist/src/transform-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-stream.d.ts","sourceRoot":"","sources":["../../src/transform-stream.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,eAAe,CAC3B,cAAc,EAAC,cAAc,EAC7B,WAAW,EAAC,WAAW,GACzB;IACE,QAAQ,EAAC,cAAc,CAAC;IACxB,IAAI,EAAC,OAAO,CAAC,OAAO,CAAC,CAAA;CACxB,CAyCA"}

package/dist/src/transform-stream.js

@@ -0,0 +1,136 @@
+/**
+ * Pipe a readable stream through a transformer. Returns a result, where
+ * result.readable is the readable end of the TransformStream and
+ * result.done is a promise that fulfills or rejects once the stream is done.
+ * Includes a shim for environments where TransformStream is not available.
+ */
+export function transformStream(sourceReadable, transformer) {
+    let transformedReadable;
+    let done;
+    if (typeof TransformStream !== 'undefined') {
+        // Chrome, Edge, Safari 14.1+
+        const transform = new TransformStream(transformer);
+        // .pipeTo
+        //  returns a Promise that fulfills when the piping process
+        //  completes successfully
+        done = sourceReadable.pipeTo(transform.writable);
+        transformedReadable = transform.readable;
+    }
+    else {
+        // Firefox, Safari 14 and older
+        let resolveDone;
+        let rejectDone;
+        done = new Promise((resolve, reject) => {
+            resolveDone = resolve;
+            rejectDone = reject;
+        });
+        const transformSource = new TransformStreamSource(sourceReadable, transformer, {
+            resolveDone,
+            rejectDone
+        });
+        transformedReadable = new ReadableStream(transformSource);
+    }
+    // Ensure the caller doesn't need to catch errors
+    done.catch(() => { });
+    return {
+        readable: transformedReadable,
+        done
+    };
+}
+class TransformStreamSource {
+    readable;
+    transformer;
+    resolveDone;
+    rejectDone;
+    reader;
+    progressMade;
+    wrappedController;
+    type = 'bytes';
+    constructor(readable, transformer, { resolveDone, rejectDone }) {
+        this.readable = readable;
+        this.transformer = transformer;
+        this.resolveDone = resolveDone;
+        this.rejectDone = rejectDone;
+        this.reader = readable.getReader();
+        this.progressMade = false; // reset on each pull
+        this.wrappedController = null;
+    }
+    // async start (controller:ReadableStreamController<T>) {
+    async start(controller) {
+        this.wrappedController = {
+            desiredSize: controller.desiredSize,
+            enqueue: (value) => {
+                this.progressMade = true;
+                controller.enqueue(value);
+            },
+            error: (reason) => {
+                this.progressMade = true;
+                if (!(reason instanceof Error)) {
+                    reason = new Error(`stream errored; reason: ${reason}`);
+                }
+                controller.error(reason);
+                this.reader.cancel(reason).catch(() => { });
+                this.rejectDone(reason);
+            },
+            terminate: () => {
+                this.progressMade = true;
+                controller.close();
+                this.reader.cancel(new Error('stream terminated')).catch(() => { });
+                this.resolveDone();
+            }
+        };
+        if (this.transformer.start) {
+            try {
+                await this.transformer.start(this.wrappedController);
+            }
+            catch (err) {
+                this.rejectDone(err);
+                throw err;
+            }
+        }
+    }
+    async pull(controller) {
+        this.progressMade = false;
+        // eslint-disable-next-line no-unmodified-loop-condition
+        while (!this.progressMade) {
+            try {
+                const data = await this.reader.read();
+                if (!this.wrappedController) {
+                    throw new Error('not this.wrappedController');
+                }
+                if (data.done) {
+                    if (this.transformer.flush) {
+                        await this.transformer.flush(this.wrappedController);
+                    }
+                    controller.close();
+                    this.resolveDone();
+                    return;
+                }
+                if (this.transformer.transform) {
+                    await this.transformer.transform(data.value, this.wrappedController);
+                }
+                else {
+                    if (!this.wrappedController) {
+                        throw new Error('not wrapped controller');
+                    }
+                    this.wrappedController.enqueue(data.value);
+                }
+            }
+            catch (err) {
+                this.rejectDone(err);
+                this.reader.cancel(err).catch(() => { });
+                throw err;
+            }
+        }
+    }
+    async cancel(reason) {
+        await this.reader.cancel(reason);
+        if (reason instanceof Error) {
+            this.rejectDone(reason);
+        }
+        else {
+            this.rejectDone(new Error(`stream cancelled; reason: ${reason}`));
+        }
+    }
+}
+//# sourceMappingURL=transform-stream.js.map

package/dist/src/transform-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-stream.js","sourceRoot":"","sources":["../../src/transform-stream.ts"],"names":[],"mappings":"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"}

package/dist/src/util.d.ts

@@ -0,0 +1,27 @@
+export declare function generateSalt(len: number): Uint8Array<ArrayBuffer>;
+/**
+ * Return a `Uint8Array` of the given length filled with random bytes.
+ * @param length Number of random bytes to return
+ * @returns {Uint8Array<ArrayBuffer>}
+ */
+export declare function randomBuf(length: number): Uint8Array<ArrayBuffer>;
+/**
+ * Concatenate two buffers into a single `Uint8Array`.
+ * @param fst The first buffer
+ * @param snd The second buffer
+ * @returns {Uint8Array<ArrayBuffer>}
+ */
+export declare function joinBufs(fst: ArrayBuffer | Uint8Array, snd: ArrayBuffer | Uint8Array): Uint8Array<ArrayBuffer>;
+/**
+ * Return a `Uint8Array` backed by a plain `ArrayBuffer`.
+ *
+ * The WebCrypto and `Blob` APIs require a `BufferSource` backed by an
+ * `ArrayBuffer`, but the default `Uint8Array` type is backed by
+ * `ArrayBufferLike` (which includes `SharedArrayBuffer`). Copy only when
+ * the backing buffer is not already a plain `ArrayBuffer`.
+ *
+ * @param data The buffer to coerce
+ * @returns {Uint8Array<ArrayBuffer>}
+ */
+export declare function asBufferSource(data: ArrayBuffer | Uint8Array): Uint8Array<ArrayBuffer>;
+//# sourceMappingURL=util.d.ts.map

package/dist/src/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/util.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAE,GAAG,EAAC,MAAM,GAAE,UAAU,CAAC,WAAW,CAAC,CAIhE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAE,MAAM,EAAC,MAAM,GAAE,UAAU,CAAC,WAAW,CAAC,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACpB,GAAG,EAAC,WAAW,GAAC,UAAU,EAC1B,GAAG,EAAC,WAAW,GAAC,UAAU,GAC5B,UAAU,CAAC,WAAW,CAAC,CAOxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC1B,IAAI,EAAC,WAAW,GAAC,UAAU,GAC7B,UAAU,CAAC,WAAW,CAAC,CAQxB"}

package/dist/src/util.js

@@ -0,0 +1,49 @@
+import { webcrypto } from '@substrate-system/one-webcrypto';
+export function generateSalt(len) {
+    const salt = new Uint8Array(len);
+    webcrypto.getRandomValues(salt);
+    return salt;
+}
+/**
+ * Return a `Uint8Array` of the given length filled with random bytes.
+ * @param length Number of random bytes to return
+ * @returns {Uint8Array<ArrayBuffer>}
+ */
+export function randomBuf(length) {
+    return webcrypto.getRandomValues(new Uint8Array(length));
+}
+/**
+ * Concatenate two buffers into a single `Uint8Array`.
+ * @param fst The first buffer
+ * @param snd The second buffer
+ * @returns {Uint8Array<ArrayBuffer>}
+ */
+export function joinBufs(fst, snd) {
+    const view1 = new Uint8Array(fst);
+    const view2 = new Uint8Array(snd);
+    const joined = new Uint8Array(view1.length + view2.length);
+    joined.set(view1);
+    joined.set(view2, view1.length);
+    return joined;
+}
+/**
+ * Return a `Uint8Array` backed by a plain `ArrayBuffer`.
+ *
+ * The WebCrypto and `Blob` APIs require a `BufferSource` backed by an
+ * `ArrayBuffer`, but the default `Uint8Array` type is backed by
+ * `ArrayBufferLike` (which includes `SharedArrayBuffer`). Copy only when
+ * the backing buffer is not already a plain `ArrayBuffer`.
+ *
+ * @param data The buffer to coerce
+ * @returns {Uint8Array<ArrayBuffer>}
+ */
+export function asBufferSource(data) {
+    if (data instanceof ArrayBuffer) {
+        return new Uint8Array(data);
+    }
+    if (data.buffer instanceof ArrayBuffer) {
+        return data;
+    }
+    return new Uint8Array(data);
+}
+//# sourceMappingURL=util.js.map

package/dist/src/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAE3D,MAAM,UAAU,YAAY,CAAE,GAAU;IACpC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,CAAA;IAChC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;IAC/B,OAAO,IAAI,CAAA;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAE,MAAa;IACpC,OAAO,SAAS,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;AAC5D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CACpB,GAA0B,EAC1B,GAA0B;IAE1B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,CAAA;IACjC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,CAAA;IACjC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;IAC1D,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACjB,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/B,OAAO,MAAM,CAAA;AACjB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAC1B,IAA2B;IAE3B,IAAI,IAAI,YAAY,WAAW,EAAE,CAAC;QAC9B,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,YAAY,WAAW,EAAE,CAAC;QACrC,OAAO,IAA+B,CAAA;IAC1C,CAAC;IACD,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;AAC/B,CAAC"}