@woosh/meep-engine 2.81.4 → 2.83.0

package/src/core/collection/map/AsyncRemoteHashMap.js

@@ -1,358 +0,0 @@
-import { assert } from "../../assert.js";
-import { BinaryBuffer } from "../../binary/BinaryBuffer.js";
-import { AbstractAsyncMap } from "./AbstractAsyncMap.js";
-
-/**
- * @template Key,Value
- */
-export class AsyncRemoteHashMap extends AbstractAsyncMap {
-
-    /**
-     *
-     * @param keyHashFunction
-     * @param keyEqualityFunction
-     * @param {BinaryClassSerializationAdapter} keySerializationAdapter
-     * @param {BinaryClassSerializationAdapter} valueSerializationAdapter
-     * @param storageKeyPrefix
-     * @param {Storage} storage
-     */
-    constructor({
-                    keyHashFunction,
-                    keyEqualityFunction,
-                    keySerializationAdapter,
-                    valueSerializationAdapter,
-                    storageKeyPrefix,
-                    storage
-                }) {
-        super();
-
-        assert.isString(storageKeyPrefix, 'storageKeyPrefix');
-
-        this._keyHashFunction = keyHashFunction;
-        this._keyEqualityFunction = keyEqualityFunction;
-        this._keySerializationAdapter = keySerializationAdapter;
-        this._valueSerializationAdapter = valueSerializationAdapter;
-        this._storageKeyPrefix = storageKeyPrefix;
-        this._storage = storage;
-
-        /**
-         *
-         * @type {Map<number,Promise>}
-         * @private
-         */
-        this._bucket_locks = new Map();
-    }
-
-    /**
-     *
-     * @param {Storage} storage
-     */
-    attach_storage(storage) {
-        this._storage = storage;
-    }
-
-    detach_storage() {
-        this._storage = null;
-    }
-
-    async __get_bucket_lock(hash) {
-        let source_lock = this._bucket_locks.get(hash);
-        if (source_lock === undefined) {
-            source_lock = Promise.resolve();
-        }
-
-        let is_resolved = false;
-        const lock_object = {
-            release() {
-                is_resolved = true;
-            }
-        };
-
-        const release_promise = new Promise((resolve, reject) => {
-            lock_object.release = resolve;
-
-            if (is_resolved) {
-                resolve();
-            }
-        });
-
-        const new_lock = source_lock.then(() => release_promise);
-
-        this._bucket_locks.set(hash, new_lock);
-
-        await source_lock;
-
-        return lock_object;
-    }
-
-    /**
-     * @param {number} hash
-     * @return {Promise<ArrayBuffer|undefined>}
-     * @private
-     */
-    __get_bucket_binary(hash) {
-        return this._storage.promiseLoadBinary(this.__compute_bucket_storage_key(hash)).catch(() => {
-            return undefined;
-        });
-    }
-
-    __compute_bucket_storage_key(hash) {
-        return `${this._storageKeyPrefix}/${hash}`;
-    }
-
-    /**
-     *
-     * @param {number} hash
-     * @param {ArrayBuffer} bucket
-     * @return {Promise}
-     * @private
-     */
-    __set_bucket_binary(hash, bucket) {
-        return this._storage.promiseStoreBinary(this.__compute_bucket_storage_key(hash), bucket);
-    }
-
-    /**
-     *
-     * @param {Key} key
-     * @param {Value|undefined} value
-     * @param {ArrayBuffer} buffer
-     * @return {ArrayBuffer}
-     * @private
-     */
-    __set_value_by_key_in_bucket(key, value, buffer) {
-        const source = new BinaryBuffer();
-        source.fromArrayBuffer(buffer);
-
-        const record_count = buffer.byteLength >= 2 ? source.readUint16() : 0;
-
-        let new_record_count = record_count;
-
-        // first attempt to find the key
-        const existing_value_address = this.__get_value_offset_from_bucket_by_key(key, buffer);
-
-        if (existing_value_address === -1) {
-            new_record_count++;
-        }
-
-        const destination = new BinaryBuffer();
-        destination.writeUint16(new_record_count);
-
-        let destination_data_offset = 2 + 16 * new_record_count;
-        let write_cursor = 0;
-        // copy old record over
-        for (let i = 0; i < record_count; i++) {
-            source.position = 2 + i * 16;
-
-            const key_position = source.readUint32();
-            const key_length = source.readUint32();
-            const value_position = source.readUint32();
-            const value_length = source.readUint32();
-
-            if (existing_value_address !== -1 && value_position === existing_value_address) {
-                // skip
-                continue;
-            }
-
-            // write key + value
-            destination.position = 2 + write_cursor * 16;
-
-            // write header section
-            destination.writeUint32(destination_data_offset);
-            destination.writeUint32(key_length);
-            destination.writeUint32(destination_data_offset + key_length);
-            destination.writeUint32(value_length);
-
-            destination.position = destination_data_offset;
-            source.position = key_position;
-            BinaryBuffer.copyBytes(source, destination, key_length);
-
-            destination_data_offset += key_length;
-
-            destination.position = destination_data_offset;
-            source.position = value_position;
-            BinaryBuffer.copyBytes(source, destination, value_length);
-
-            destination_data_offset += value_length;
-
-            write_cursor++;
-        }
-
-        const inserted_key_address = destination_data_offset;
-        const inserted_key_length = this.__encode_object(destination, inserted_key_address, key, this._keySerializationAdapter);
-
-        destination_data_offset += inserted_key_length;
-        const inserted_value_address = destination_data_offset;
-        const inserted_value_length = this.__encode_object(destination, inserted_value_address, value, this._valueSerializationAdapter);
-
-
-        // write section for the new value
-        destination.position = 2 + 16 * write_cursor;
-        destination.writeUint32(inserted_key_address);
-        destination.writeUint32(inserted_key_length);
-        destination.writeUint32(inserted_value_address);
-        destination.writeUint32(inserted_value_length);
-
-        // restore position
-        destination.position = inserted_value_address + inserted_value_length;
-
-        destination.trim();
-
-        return destination.data;
-    }
-
-    /**
-     *
-     * @param {Key} key
-     * @param {ArrayBuffer} buffer
-     * @return {number} -1 if not found, otherwise address within the buffer where the value can be read
-     * @private
-     */
-    __get_value_offset_from_bucket_by_key(key, buffer) {
-        const binary = new BinaryBuffer();
-        binary.fromArrayBuffer(buffer);
-
-        if (binary.length < 2) {
-            return -1;
-        }
-
-        const record_count = binary.readUint16();
-
-        if (record_count === 0) {
-            return -1;
-        }
-
-        const key_offsets = new Uint32Array(record_count);
-        const value_offsets = new Uint32Array(record_count);
-
-        // read record offsets
-        for (let i = 0; i < record_count; i++) {
-            const key_offset = binary.readUint32();
-            const key_length = binary.readUint32();
-
-            const value_offset = binary.readUint32();
-            const value_length = binary.readUint32();
-
-            key_offsets[i] = key_offset;
-            value_offsets[i] = value_offset;
-        }
-
-        // read key
-        for (let i = 0; i < record_count; i++) {
-            const key_address = key_offsets[i];
-
-            const stored_key = this.__decode_object(binary, key_address, this._keySerializationAdapter);
-
-            if (this._keyEqualityFunction(stored_key, key)) {
-                return value_offsets[i]
-            }
-        }
-
-        return -1;
-    }
-
-    /**
-     *
-     * @param {BinaryBuffer} buffer
-     * @param {number} address
-     * @param {BinaryClassSerializationAdapter} adapter
-     * @return {Value}
-     * @private
-     */
-    __decode_object(buffer, address, adapter) {
-
-        buffer.position = address;
-
-        const ValueKlass = adapter.getClass();
-
-        const value = new ValueKlass();
-
-        adapter.deserialize(buffer, value);
-
-        return value;
-    }
-
-    /**
-     * @template T
-     * @param {BinaryBuffer} buffer
-     * @param {number} address
-     * @param {T} value
-     * @param {BinaryClassSerializationAdapter} adapter
-     * @returns {number} bytes written
-     * @private
-     */
-    __encode_object(buffer, address, value, adapter) {
-        buffer.position = address;
-
-        adapter.serialize(buffer, value);
-
-        const bytes_written = buffer.position - address;
-
-        return bytes_written;
-    }
-
-    /**
-     *
-     * @param {BinaryBuffer} buffer
-     * @param {number} address
-     * @return {Value}
-     * @private
-     */
-    __decode_value(buffer, address) {
-        return this.__decode_object(buffer, address, this._valueSerializationAdapter);
-    }
-
-    /**
-     *
-     * @param {Key} key
-     * @return {Promise<Value|undefined>}
-     */
-    async get(key) {
-        // hash the key to identify bucket to load
-        const key_hash = this._keyHashFunction(key);
-
-        const lock = await this.__get_bucket_lock(key_hash);
-
-        const bucket_buffer = await this.__get_bucket_binary(key_hash);
-
-        lock.release();
-
-        if (bucket_buffer === undefined) {
-            return;
-        }
-
-        const value_address = this.__get_value_offset_from_bucket_by_key(key, bucket_buffer);
-
-        if (value_address === -1) {
-            return;
-        }
-
-        const binary = new BinaryBuffer();
-        binary.fromArrayBuffer(bucket_buffer);
-
-        return this.__decode_value(binary, value_address);
-    }
-
-    /**
-     *
-     * @param {Key} key
-     * @param {Value} value
-     * @return {Promise<void>}
-     */
-    async set(key, value) {
-        const key_hash = this._keyHashFunction(key);
-
-        const lock = await this.__get_bucket_lock(key_hash);
-
-        let bucket_buffer = await this.__get_bucket_binary(key_hash);
-
-        if (bucket_buffer === undefined) {
-            bucket_buffer = new ArrayBuffer(0);
-        }
-
-        const updated_buffer = this.__set_value_by_key_in_bucket(key, value, bucket_buffer);
-
-        await this.__set_bucket_binary(key_hash, updated_buffer);
-
-        lock.release();
-    }
-}

package/src/core/function/Functions.js

@@ -1,103 +0,0 @@
-/**
- * Collection of useful pure function. Saves having to allocate memory for new anonymous or arrow function. They also come with useful names.
- * @author Alex Goldring
- * @copyright Alex Goldring 2018
- */
-
-/**
- * No-operation function. Does nothing. Useful when a callback is required to avoid checks for a missing function.
- * @param {*} arguments
- */
-export function noop() {
-}
-
-/**
- * Returns boolean true value.
- * @returns {boolean} always true
- */
-export function returnTrue() {
-    return true;
-}
-
-/**
- * Returns boolean false value.
- * @returns {boolean} always false
- */
-export function returnFalse() {
-    return false;
-}
-
-/**
- *
- * @returns {number} always 0
- */
-export function returnZero() {
-    return 0;
-}
-
-/**
- *
- * @returns {number} always 1
- */
-export function returnOne() {
-    return 1;
-}
-
-
-/**
- * @template T
- * @returns {T[]}
- */
-export function returnEmptyArray() {
-    return [];
-}
-
-/**
- * @template T
- * @param {T} v
- * @returns {function():T}
- */
-export function makeReturnValue(v) {
-    return () => v;
-}
-
-/**
- * @template A
- * @param {A} a
- * @returns {A}
- */
-export function passThrough(a) {
-    return a;
-}
-
-/**
- * @template A
- * @param {A} a
- * @param {A} b
- * @returns {boolean}
- */
-export function strictEquals(a, b) {
-    return a === b;
-}
-
-/**
- *
- * @param {...function} processes
- * @returns {function(*): *}
- */
-export function chainFunctions(...processes) {
-    const numProcesses = processes.length;
-
-    return function chain(v) {
-        let result = v;
-
-        for (let i = 0; i < numProcesses; i++) {
-            const process = processes[i];
-            result = process(result);
-        }
-
-        return result;
-    }
-}
-
-