@webqit/observer 1.7.6 → 2.0.1

package/webpack.config.cjs

@@ -1,6 +1,6 @@
-
-module.exports = {
-	mode: process.argv.includes('--dev') ? 'development' : 'production',
-	entry: './src/browser-entry.js',
-	devtool: 'source-map',
+
+module.exports = {
+	mode: process.argv.includes('--dev') ? 'development' : 'production',
+	entry: './src/browser-entry.js',
+	devtool: 'source-map',
 };

package/src/actions/_exec.js

@@ -1,33 +0,0 @@
-
-/**
- * @imports
- */
-import { _isTypeObject } from '@webqit/util/js/index.js';
-import Interceptors from '../core/Interceptors.js';
-import _unproxy from '../actors/unproxy.js';
-
-/**
- * Runs a Reflect operation of the specified type.
- *
- * @param string		type
- * @param array|object	target
- * @param object		payload
- * @param object		params
- *
- * @return array
- */
-export default function(type, target, payload = {}, params = {}) {
-	if (!target || !_isTypeObject(target)) {
-		throw new Error('Target must be of type object!');
-	}
-	target = _unproxy(target);
-	// ---------------------------------
-	// Execute any "keys" traps, otherwise "test" the default way
-	var interceptors, defaultHandler = function(_val) {
-		return arguments.length ? _val : Reflect[type](target, ...Object.values(payload));
-	};
-	if (interceptors = Interceptors.getFirebase(target, false, params.namespace)) {
-		return interceptors.fire({ type, ...payload }, defaultHandler);
-	}
-	return defaultHandler();
-}

package/src/actions/_setOrDefine.js

@@ -1,136 +0,0 @@
-
-/**
- * @imports
- */
-import {
-	_isObject, _isTypeObject, _internals,
-	_isNumber, _isArray, _isString
-} from '@webqit/util/js/index.js';
-import { _from as _arrFrom } from '@webqit/util/arr/index.js';
-import build, { isUserObject } from '../connectors/build.js';
-import Interceptors from '../core/Interceptors.js';
-import Observers from '../core/Observers.js';
-import Event from '../core/Event.js';
-import unlink from '../connectors/unlink.js';
-import link from '../connectors/link.js';
-import _unproxy from '../actors/unproxy.js';
-import _has from './has.js';
-import _get from './get.js';
-
-/**
- * Executes a "_setProp" type of operation on a target.
- * Fires any observers for the specific type that may be bound to target.
- *
- * @param bool			define
- * @param array|object	target
- * @param object		payload
- * @param Object		params
- *
- * @return Event
- */
-export default function(define, target, payload, params = {}) {
-	target = payload.receiver || target;
-	var keysOrPayload = payload.keysOrPayload;
-	var value = payload.value;
-	if (!target || !_isTypeObject(target)) {
-		throw new Error('Target must be of type object!');
-	}
-	if (_isObject(keysOrPayload)) {
-		params = value || {};
-		value = null;
-	}
-	// ----------
-	target = _unproxy(target);
-	var interceptors = Interceptors.getFirebase(target, false, params.namespace),
-		observers = Observers.getFirebase(target, false, params.namespace);
-	// ----------
-	const handleSet = (key, value, related, detail) => {
-		var type = 'set', descriptor;
-		if (define) {
-			type = 'defineProperty';
-			descriptor = value || {};
-			value = descriptor.value;
-		}
-		// ---------------------------------
-		// The event object
-		var isUpdate = false, oldValue;
-		if (_has(target, key, params)) {
-			isUpdate = true;
-			oldValue = _get(target, key, payload.receiver, params);
-		}
-		var e = {
-			name: key,
-			type,
-			value,
-			receiver: payload.receiver,
-			related,
-			detail,
-			isUpdate,
-			oldValue,
-		};
-		// ---------------------------------
-		// The set operation
-		var defaultSet = function(_success) {
-			if (arguments.length) {
-				if (descriptor) {
-					descriptor = _success;
-				} else {
-					value = _success;
-				}
-			}
-			if (descriptor) {
-				if (_internals(target, 'accessorizedProps', false).has(key)
-				&& !_internals(target, 'accessorizedProps').get(key).restore()) {
-					return false;
-				}
-				Object.defineProperty(target, key, descriptor);
-				return true;
-			}
-			if (_internals(target, 'accessorizedProps', false).has(key)) {
-				return _internals(target, 'accessorizedProps').get(key).set(value);
-			}
-			target[key] = value;
-			return true;
-		};
-		if (interceptors) {
-			var eventObject = descriptor 
-				? {type: 'defineProperty', name: key, descriptor, receiver: payload.receiver, related, detail, isUpdate, oldValue} 
-				: {type: 'set', name: key, value, receiver: payload.receiver, related, detail, isUpdate, oldValue};
-			e.success = interceptors.fire(eventObject, defaultSet);
-		} else {
-			e.success = defaultSet();
-		}
-		// ---------------------------------
-		if (e.success && e.value !== e.oldValue) {
-			// Unobserve outgoing value for bubbling
-			if (_isTypeObject(e.oldValue)) {
-				unlink(target, key, e.oldValue, null, params);
-			}
-			// Observe incoming value for bubbling
-			if (_isTypeObject(e.value)) {
-				link(target, key, e.value, null, params);
-				if (observers && (observers.subBuild || (observers.build && isUserObject(e.value)))) {
-					build(e.value, observers.subBuild, observers.build, params.namespace);
-				}
-			}
-		}
-		return e;
-	};
-	// ---------------------------------
-	var keys, events = [];
-	if (_isArray(keysOrPayload) || ((_isString(keysOrPayload) || _isNumber(keysOrPayload)) && (keys = _arrFrom(keysOrPayload)))) {
-		events = keys.map(key => handleSet(key, value, keys, params.detail));
-	} else if (_isObject(keysOrPayload) && (keys = Object.keys(keysOrPayload))) {
-		events = keys.map(key => handleSet(key, keysOrPayload[key], keys, params.detail));
-	}
-	var successfulEvents = events.filter(e => e.success !== false);
-	// ---------------------------------
-	var evt;
-	if (observers) {
-		evt = observers.fire(successfulEvents, params.cancellable);
-		evt.successCount = successfulEvents.length;
-	} else if (params.eventTypeReturn) {
-		evt = new Event(target);
-	}
-	return params.eventTypeReturn ? evt : successfulEvents.length > 0;
-}

package/src/actions/apply.js

@@ -1,19 +0,0 @@
-
-/**
- * @imports
- */
-import _exec from './_exec.js';
-
-/**
- * Runs an "apply" operation on a target.
- *
- * @param array|object	target
- * @param object		thisArgument
- * @param array			argumentsList
- * @param object		params
- *
- * @return array
- */
-export default function(target, thisArgument, argumentsList, params = {}) {
-	return _exec('apply', target, { thisArgument, argumentsList }, params);
-}

package/src/actions/construct.js

@@ -1,19 +0,0 @@
-
-/**
- * @imports
- */
-import _exec from './_exec.js';
-
-/**
- * Runs a "construct" operation on a target.
- *
- * @param array|object	target
- * @param array			argumentsList
- * @param object		newTarget
- * @param object		params
- *
- * @return array
- */
-export default function(target, argumentsList, newTarget = null, params = {}) {
-	return _exec('construct', target, arguments.length > 2 ? { argumentsList, newTarget } : { argumentsList }, params);
-}

package/src/actions/defineProperty.js

@@ -1,20 +0,0 @@
-
-/**
- * @imports
- */
-import _setOrDefine from './_setOrDefine.js';
-
-/**
- * Executes a "defineProperty" operation on a target.
- * Fires any observers that may be bound to target.
- *
- * @param array|object	target
- * @param string|array	keysOrPayload
- * @param mixed			value
- * @param object		params
- *
- * @return bool
- */
-export default function(target, keysOrPayload, value = null, params = {}) {
-	return _setOrDefine(true/*define*/, target, { keysOrPayload, value }, params);
-}

package/src/actions/deleteProperty.js

@@ -1,80 +0,0 @@
-
-/**
- * @imports
- */
-import { _from as _arrFrom } from '@webqit/util/arr/index.js';
-import { _isTypeObject, _internals } from '@webqit/util/js/index.js';
-import Interceptors from '../core/Interceptors.js';
-import Observers from '../core/Observers.js';
-import Event from '../core/Event.js';
-import unlink from '../connectors/unlink.js';
-import _unproxy from '../actors/unproxy.js';
-import _has from './has.js';
-import _get from './get.js';
-
-/**
- * Executes a "deleteProperty" operation on a target.
- * Fires any observers that may be bound to target.
- *
- * @param array|object	target
- * @param string|array	keys
- * @param object		params
- *
- * @return Event
- */
-export default function(target, keys, params = {}) {
-	if (!target || !_isTypeObject(target)) {
-		throw new Error('Target must be of type object!');
-	}
-	target = _unproxy(target);
-	var _keys = _arrFrom(keys);
-	var events = _keys.map(key => {
-		// ---------------------------------
-		// The event object
-		var oldValue;
-		if (_has(target, key, params)) {
-			oldValue = _get(target, key, null, params);
-		}
-		var e = {
-			name: key,
-			type: 'deleteProperty',
-			related: _keys,
-			detail: params.detail,
-			oldValue,
-		};
-		// ---------------------------------
-		// Execute any "del" traps, otherwise "del" the default way
-		var interceptors, defaultDel = function(_success) {
-			if (arguments.length) {
-				return _success;
-			}
-			if (_internals(target, 'accessorizedProps', false).has(key)
-			&& !_internals(target, 'accessorizedProps').get(key).restore()) {
-				return false;
-			}
-			delete target[key];
-			return true;
-		};
-		if (interceptors = Interceptors.getFirebase(target, false, params.namespace)) {
-			e.success = interceptors.fire({type: 'deleteProperty', name:key, oldValue, related: _keys}, defaultDel);
-		} else {
-			e.success = defaultDel();
-		}
-		// ---------------------------------
-		// Unobserve outgoing value for bubbling
-		if (e.success && _isTypeObject(e.oldValue)) {
-			unlink(target, key, e.oldValue, null, params);
-		}
-		return e;
-	});
-	var successfulEvents = events.filter(e => e.success !== false);
-	// ---------------------------------
-	var observers, evt;
-	if (observers = Observers.getFirebase(target, false, params.namespace)) {
-		evt = observers.fire(successfulEvents, params.cancellable);
-		evt.successCount = successfulEvents.length;
-	} else if (params.eventTypeReturn) {
-		evt = new Event(target);
-	}
-	return params.eventTypeReturn ? evt : successfulEvents.length > 0;
-}

package/src/actions/get.js

@@ -1,53 +0,0 @@
-
-/**
- * @imports
- */
-import {
-	_isArray, _isNumeric, _isClass,
-	_isFunction, _isTypeObject, _internals
-} from '@webqit/util/js/index.js';
-import { _from as _objFrom } from '@webqit/util/obj/index.js';
-import { _from as _arrFrom } from '@webqit/util/arr/index.js';
-import Interceptors from '../core/Interceptors.js';
-import _unproxy from '../actors/unproxy.js';
-
-/**
- * Runs a "get" operation on a target.
- * Fires any such query observers that may be bound to target.
- *
- * @param array|object	target
- * @param string|array	keys
- * @param object		receiver
- * @param object		params
- *
- * @return mixed
- */
-export default function(target, keys, receiver = null, params = {}) {
-	target = receiver || target;
-	if (!target || !_isTypeObject(target)) {
-		throw new Error('Target must be of type object!');
-	}
-	target = _unproxy(target);
-	// ---------------------------------
-	var _keys = _arrFrom(keys);
-	var values = _keys.map(key => {
-		// Execute any "get" traps, otherwise "get" the default way
-		var interceptors, defaultGet = function(_value) {
-			if (arguments.length) {
-				return _value;
-			}
-			if (_internals(target, 'accessorizedProps').has(key) && _internals(target, 'accessorizedProps').get(key).touch(true)) {
-				return _internals(target, 'accessorizedProps').get(key).get();
-			}
-			return receiver 
-				? Reflect.get(target, key, receiver) 
-				: Reflect.get(target, key);
-		};
-		if (interceptors = Interceptors.getFirebase(target, true, params.namespace)) {
-			return interceptors.fire({type:'get', name: key, related: _keys, receiver}, defaultGet);
-		}
-		return defaultGet();
-	});
-	// ---------------------------------
-	return _isArray(keys) ? values : values[0];
-}

package/src/actions/getOwnPropertyDescriptor.js

@@ -1,18 +0,0 @@
-
-/**
- * @imports
- */
-import _exec from './_exec.js';
-
-/**
- * Runs a "getOwnPropertyDescriptor" operation on a target.
- *
- * @param array|object	target
- * @param string|number name
- * @param object		params
- *
- * @return array
- */
-export default function(target, name, params = {}) {
-	return _exec('getOwnPropertyDescriptor', target, { name }, params);
-}

package/src/actions/getPrototypeOf.js

@@ -1,17 +0,0 @@
-
-/**
- * @imports
- */
-import _exec from './_exec.js';
-
-/**
- * Runs a "getPrototypeOf" operation on a target.
- *
- * @param array|object	target
- * @param object		params
- *
- * @return array
- */
-export default function(target, params = {}) {
-	return _exec('getPrototypeOf', target, {}, params);
-}

package/src/actions/has.js

@@ -1,18 +0,0 @@
-
-/**
- * @imports
- */
-import _exec from './_exec.js';
-
-/**
- * Runs a "has" operation on a target.
- *
- * @param array|object	target
- * @param string		name
- * @param object		params
- *
- * @return array
- */
-export default function(target, name, params = {}) {
-	return _exec('has', target, { name }, params);
-}

package/src/actions/isExtensible.js

@@ -1,17 +0,0 @@
-
-/**
- * @imports
- */
-import _exec from './_exec.js';
-
-/**
- * Runs a "isExtensible" operation on a target.
- *
- * @param array|object	target
- * @param object		params
- *
- * @return array
- */
-export default function(target, params = {}) {
-	return _exec('isExtensible', target, {}, params);
-}

package/src/actions/ownKeys.js

@@ -1,17 +0,0 @@
-
-/**
- * @imports
- */
-import _exec from './_exec.js';
-
-/**
- * Runs a "ownKeys" operation on a target.
- *
- * @param array|object	target
- * @param object		params
- *
- * @return array
- */
-export default function(target, params = {}) {
-	return _exec('ownKeys', target, {}, params);
-}

package/src/actions/preventExtensions.js

@@ -1,17 +0,0 @@
-
-/**
- * @imports
- */
-import _exec from './_exec.js';
-
-/**
- * Runs a "preventExtensions" operation on a target.
- *
- * @param array|object	target
- * @param object		params
- *
- * @return array
- */
-export default function(target, params = {}) {
-	return _exec('preventExtensions', target, {}, params);
-}

package/src/actions/set.js

@@ -1,21 +0,0 @@
-
-/**
- * @imports
- */
-import _setOrDefine from './_setOrDefine.js';
-
-/**
- * Executes a "set" operation on a target.
- * Fires any observers that may be bound to target.
- *
- * @param array|object	target
- * @param string|array	keysOrPayload
- * @param mixed			value
- * @param object		receiver
- * @param object		params
- *
- * @return bool
- */
-export default function(target, keysOrPayload, value = null, receiver = null, params = {}) {
-	return _setOrDefine(false/*define*/, target, arguments.length > 3 ? { keysOrPayload, value, receiver } : { keysOrPayload, value }, params);
-}

package/src/actions/setPrototypeOf.js

@@ -1,18 +0,0 @@
-
-/**
- * @imports
- */
-import _exec from './_exec.js';
-
-/**
- * Runs a "setPrototypeOf" operation on a target.
- *
- * @param array|object	target
- * @param object		prototype
- * @param object		params
- *
- * @return array
- */
-export default function(target, prototype, params = {}) {
-	return _exec('setPrototypeOf', target, { prototype }, params);
-}

package/src/actors/accessorize.js

@@ -1,162 +0,0 @@
-
-/**
- * @imports
- */
-import { _isArray, _internals } from '@webqit/util/js/index.js';
-import { _isObject } from '@webqit/util/js/index.js';
-import { _from as _arrFrom } from '@webqit/util/arr/index.js';
-import _get from '../actions/get.js';
-import _set from '../actions/set.js';
-
-/**
- * Initializes "Reflxive getter/setter" traps on the target.
- *
- * @param array|object	target
- * @param string|array	keys
- * @param object		params
- *
- * @return bool|array
- */
-export default function(target, keys = [], params = {}) {
-	params = _isObject(keys) ? keys : params;
-	var successFlags = (arguments.length === 1 ? Object.keys(target) : _arrFrom(keys)).map(key => {
-		if (_internals(target, 'accessorizedProps').has(key) && _internals(target, 'accessorizedProps').get(key).touch(true)) {
-			return false;
-		}
-		// ----------
-		const getDescriptorDeep = () => {
-			var descriptor, proto = target;
-			while (!descriptor && (proto = Object.getPrototypeOf(proto))) {
-				descriptor = Object.getOwnPropertyDescriptor(proto, key);
-			}
-			return descriptor;
-		};
-		// ----------
-		var originalOwnDescriptor = Object.getOwnPropertyDescriptor(target, key),
-			altOriginalOwnDescriptor,
-			activeIsAltOriginalOwnDescriptor;
-		if (!originalOwnDescriptor) {
-			// Not an own property
-			// and maybe not even defined at all in the prototype chain
-			altOriginalOwnDescriptor = {
-				writable: true,
-				enumerable: key in target ? false/* existing but inherited*/ : true,
-				configurable: params.configurable !== false,
-			};
-		}
-		// ----------
-		var reactiveOwnDescriptor = { ...(originalOwnDescriptor || altOriginalOwnDescriptor) };
-		if ('value' in reactiveOwnDescriptor) {
-			delete reactiveOwnDescriptor.value;
-		}
-		if ('writable' in reactiveOwnDescriptor) {
-			delete reactiveOwnDescriptor.writable;
-		}
-		// ----------
-		reactiveOwnDescriptor.get = () => {
-			if (controlObject.ongoingGets.length) {
-				// .touch(true)
-				return controlObject.get();
-			}
-			// _get() will return here
-			// but to call controlObject.get();
-			controlObject.ongoingGets.push(1);
-			var value = _get(target, key, null, params);
-			controlObject.ongoingGets.pop();
-			return value;
-		};
-		var setting;
-		reactiveOwnDescriptor.set = newValue => {
-			if (controlObject.ongoingSets.length) {
-				return controlObject.set(newValue);
-			}
-			// _set() will return here
-			// but to call controlObject.set();
-			controlObject.ongoingSets.push(1);
-			var operation = _set(target, key, newValue, null, params);
-			controlObject.ongoingSets.pop();
-			return operation;
-		};
-		// ----------
-		var controlObject = {
-			ongoingGets: [],
-			ongoingSets: [],
-			get: function() {
-				// ---------------------
-				var descriptor = originalOwnDescriptor;
-				if (!descriptor) {
-					if (activeIsAltOriginalOwnDescriptor) {
-						// Already switched to altOriginalOwnDescriptor
-						descriptor = altOriginalOwnDescriptor;
-					} else {
-						// getDescriptorDeep() or altOriginalOwnDescriptor
-						descriptor = getDescriptorDeep() || altOriginalOwnDescriptor;
-					}
-				}
-				// ---------------------
-				return descriptor.get ? descriptor.get.call(target) : descriptor.value;
-			},
-			set: function(value) {
-				// ---------------------
-				var descriptor = originalOwnDescriptor;
-				if (!descriptor) {
-					if (activeIsAltOriginalOwnDescriptor) {
-						// Already switched to altOriginalOwnDescriptor
-						descriptor = altOriginalOwnDescriptor;
-					} else if (descriptor = getDescriptorDeep()) {
-						if (('value' in descriptor)) {
-							// Deep is data property.
-							// We should rather switch to altOriginalOwnDescriptor
-							descriptor = altOriginalOwnDescriptor;
-							activeIsAltOriginalOwnDescriptor = true;
-						}
-					} else {
-						// Not yet switched to altOriginalOwnDescriptor
-						// and no getDescriptorDeep()
-						descriptor = altOriginalOwnDescriptor;
-						activeIsAltOriginalOwnDescriptor = true;
-					}
-				}
-				// ---------------------
-				if (descriptor.set || descriptor.get) {
-					if (!descriptor.set) {
-						return false;
-					}
-					// Can sometimes return undefined
-					return descriptor.set.call(target, value);
-				}
-				descriptor.value = value;
-				return true;
-			},
-			restore: function() {
-				try {
-					if (this.intact()) {
-						if (originalOwnDescriptor || activeIsAltOriginalOwnDescriptor /* switched */) {
-							Object.defineProperty(target, key, originalOwnDescriptor || altOriginalOwnDescriptor /* switch target */);
-						} else {
-							delete target[key];
-						}
-						_internals(target, 'accessorizedProps').delete(key);
-					}
-					return true;
-				} catch(e) {}
-				return false;
-			},
-			intact: function() {
-				return (Object.getOwnPropertyDescriptor(target, key) || {}).get === reactiveOwnDescriptor.get;
-			},
-			touch: function(attemptRestore = false) {
-				// If intact, or not intact but not restorable, return true - "valid"
-				return this.intact() || (attemptRestore ? !this.restore() : false);
-			},
-		}
-		// ----------
-		try {
-			Object.defineProperty(target, key, reactiveOwnDescriptor);
-			_internals(target, 'accessorizedProps').set(key, controlObject);
-			return true;
-		} catch(e) {}
-		return false;
-	});
-	return _isArray(keys) ? successFlags : successFlags[0];
-}