ig-types 6.9.5 → 6.11.0

package/Promise.js

@@ -417,6 +417,58 @@ object.Constructor('CooperativePromise', Promise, {
 
 //---------------------------------------------------------------------
 
+var ProxyPromise =
+module.ProxyPromise =
+object.Constructor('ProxyPromise', Promise, {
+	__new__: function(context, constructor){
+		var proto = 'prototype' in constructor ?
+			constructor.prototype
+			: constructor
+		var obj = Reflect.construct(
+			ProxyPromise.__proto__, 
+			[function(resolve, reject){
+				context.then(resolve)
+				context.catch(reject) }], 
+			ProxyPromise) 
+		// populate...
+		// NOTE: we are not using object.deepKeys(..) here as we need 
+		// 		the key origin not to trigger property getters...
+		var seen = new Set()
+		while(proto != null){
+			Object.entries(Object.getOwnPropertyDescriptors(proto))
+				.forEach(function([key, value]){
+					// skip overloaded keys...
+					if(seen.has(key)){
+						return }
+					// skip non-functions...
+					if(typeof(value.value) != 'function'){
+						return }
+					// skip non-enumerable except for Object.prototype.run(..)...
+					if(!(key == 'run' 
+								&& Object.prototype.run === value.value) 
+							&& !value.enumerable){
+						return }
+					// proxy...
+					obj[key] = function(...args){
+						// XXX should we also .catch(..) here???
+						return context.then(function(res){
+							return res[key](...args) }) } })
+			proto = proto.__proto__ } 
+		return obj },
+})
+
+
+
+//---------------------------------------------------------------------
+
+// XXX EXPEREMENTAL...
+var PromiseProtoMixin =
+module.PromiseProtoMixin =
+object.Mixin('PromiseProtoMixin', 'soft', {
+	as: ProxyPromise,
+})
+
+
 var PromiseMixin =
 module.PromiseMixin =
 object.Mixin('PromiseMixin', 'soft', {
@@ -425,9 +477,11 @@ object.Mixin('PromiseMixin', 'soft', {
 	cooperative: CooperativePromise,
 })
 
-
 PromiseMixin(Promise)
 
+// XXX EXPEREMENTAL...
+PromiseProtoMixin(Promise.prototype)
+
 
 
 

package/README.md

@@ -74,6 +74,9 @@ Library of JavaScript type extensions, types and utilities.
       - [`<promise-iter>.flat(..)`](#promise-iterflat)
       - [`<promise-iter>.then(..)` / `<promise-iter>.catch(..)` / `<promise-iter>.finally(..)`](#promise-iterthen--promise-itercatch--promise-iterfinally)
       - [Advanced handler](#advanced-handler)
+    - [Promise proxies](#promise-proxies)
+      - [`<promise>.as(..)`](#promiseas)
+      - [`<promise-proxy>.<method>(..)`](#promise-proxymethod)
   - [Generator extensions and utilities](#generator-extensions-and-utilities)
     - [The basics](#the-basics)
       - [`generator.Generator`](#generatorgenerator)
@@ -1621,6 +1624,56 @@ var p = Promise.iter(
 ```
 
 
+### Promise proxies
+
+_Promise proxies_ generate a set of prototype methods returning promises that when the parent promise is resolved will resolve to a specific method call.
+
+Example:
+```javascript
+var o = {
+    method: function(...args){
+        console.log('method:', ...args)
+    },
+}
+
+var p = Peomise.cooperative().as(o)
+
+p.method(1, 2, 3) // returns a promise...
+
+// ...
+
+// resolving a promise will trigger all the proxy emthod execution, so 
+// here 'method: 1, 2, 3' will get printed...
+p.set(o)
+
+```
+
+#### `<promise>.as(..)`
+
+Create a promise proxy
+
+```bnf
+<promise>.as(<object>)
+<promise>.as(<constructor>)
+    -> <promise-proxy>
+```
+
+A proxy promise will be populated with proxy methods to all the methods of the `<object>` or `<constructor>.prototype`.
+
+#### `<promise-proxy>.<method>(..)`
+
+When `<promise>` resolves, call the `.<method>(..)` on the resolved value.
+
+```bnf
+<promise-proxy>.<method>(..)
+    -> <method-promise>
+```
+
+`<method-promise>` will resolve the the return value of the `<method>` when 
+the main `<promise>` is resolved.
+
+
+
 ## Generator extensions and utilities
 
 ```javascript

package/event.js

@@ -34,17 +34,17 @@ module.TRIGGER = module.EventCommand('TRIGGER')
 
 
 
-// Create an "eventfull" method...
+// Create an "eventful" method...
 //
 // The resulting method can be either called directly or via .trigger(..).
 // Handlrs can be bound to it via .on(..) and unbound via .off(..) and 
 // calling it will trigger the handlers either after the user func(..)
 // return or when the user calles the passed handler(..) function.
 //
-// 	Eventfull(name[, options])
+// 	Eventful(name[, options])
 // 		-> method
 //
-// 	Eventfull(name, func[, options])
+// 	Eventful(name, func[, options])
 // 		-> method
 //
 //
@@ -63,6 +63,11 @@ module.TRIGGER = module.EventCommand('TRIGGER')
 //		-> true
 //		-> false
 //
+//	trigger event handlers and overload handler arguments...
+//	handle(true, ...)
+//		-> true
+//		-> false
+//
 //	prevent event handlers from triggering...
 //	handle(false)
 //		-> undefined
@@ -88,9 +93,9 @@ module.TRIGGER = module.EventCommand('TRIGGER')
 //
 // NOTE: calling handle(false) will exiplicitly disable calling the 
 // 		handlers for that call...
-var Eventfull =
-module.Eventfull =
-object.Constructor('Eventfull', {
+var Eventful =
+module.Eventful =
+object.Constructor('Eventful', {
 
 	handlerLocation: 'context',
 
@@ -151,11 +156,15 @@ object.Constructor('Eventfull', {
 		// NOTE: to explicitly disable calling the handlers func must 
 		// 		call handle(false)
 		var did_handle = false
-		var handle = function(run=true){
+		var handle = function(run=true, ...alt_args){
 			did_handle = true
-			var a = args[0] instanceof EventCommand ?
-				args.slice(1)
+			var a = (run === true 
+					&& arguments.length > 1) ?
+				alt_args
 				: args
+			a = a[0] instanceof EventCommand ?
+				a.slice(1)
+				: a
 			return run ?
 				handlers
 					.reduce(function(res, handler){ 
@@ -189,7 +198,7 @@ object.Constructor('Eventfull', {
 })
 
 
-// Extends Eventfull(..) adding ability to bind events via the 
+// Extends Eventful(..) adding ability to bind events via the 
 // resulting method directly by passing it a function...
 //
 //	Event(name[, options])
@@ -225,7 +234,7 @@ object.Constructor('Eventfull', {
 // arg is a function or not...
 var Event =
 module.Event =
-object.Constructor('Event', Eventfull, {
+object.Constructor('Event', Eventful, {
 	toString: function(){
 		return this.orig_func ?
 			'Event '
@@ -241,7 +250,7 @@ object.Constructor('Event', Eventfull, {
 			// call the action...
 			: object.parentCall(Event.prototype.__call__, this, context, ...args)
 			// XXX workaround for above line -- remove when fully tested...
-			//: Eventfull.prototype.__call__.call(this, context, ...args)
+			//: Eventful.prototype.__call__.call(this, context, ...args)
 		return context }, 
 })
 
@@ -330,13 +339,13 @@ module.EventHandlerMixin = object.Mixin('EventHandlerMixin', {
 // 		instead...
 var EventDocMixin = 
 module.EventDocMixin = object.Mixin('EventDocMixin', {
-	get eventfull(){
+	get eventful(){
 		return object.deepKeys(this)
 			.filter(function(n){ 
 				// avoid triggering props...
 				return !object.values(this, n, function(){ return object.STOP }, true)[0].get
 					// XXX this is too strict...
-					&& (this[n] || {}).constructor === Eventfull}.bind(this)) },
+					&& (this[n] || {}).constructor === Eventful}.bind(this)) },
 	get events(){
 		return object.deepKeys(this)
 			.filter(function(n){ 

package/main.js

@@ -32,6 +32,7 @@ module.STOP = object.STOP
 
 // frequently used stuff...
 module.Generator = module.generator.Generator
+// XXX doc...
 module.iter = module.generator.iter
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ig-types",
-  "version": "6.9.5",
+  "version": "6.11.0",
   "description": "Generic JavaScript types and type extensions...",
   "main": "main.js",
   "scripts": {

package/test.js

@@ -381,19 +381,19 @@ Events.cases({
 
 					// blank events...
 					bareEventBlank: assert(
-						events.Eventfull('bareEventBlank'), 
-						'.Eventfull(..): blank'),
+						events.Eventful('bareEventBlank'), 
+						'.Eventful(..): blank'),
 					eventBlank: assert(
 						events.Event('eventBlank'), 
 						'.Event(..): blank'),
 
 					// normal events...
-					bareEvent: assert(events.Eventfull('bareEvent', 
+					bareEvent: assert(events.Eventful('bareEvent', 
 						function(handle, ...args){
 							called['bareEvent-call'] = true
-							assert(handle(), '.Eventfull(..) -> handle(..)')
+							assert(handle(), '.Eventful(..) -> handle(..)')
 							return 'bareEvent'
-						}), '.Eventfull(..)'),
+						}), '.Eventful(..)'),
 					event: assert(events.Event('event', 
 						function(handle, ...args){
 							called['event-call'] = true
@@ -408,7 +408,7 @@ Events.cases({
 
 		// test event list...
 		assert.array(obj.events, ['event', 'eventBlank'], '.events')
-		assert.array(obj.eventfull, ['bareEvent', 'bareEventBlank'], '.eventfull')
+		assert.array(obj.eventful, ['bareEvent', 'bareEventBlank'], '.eventful')
 
 		// bind...
 		var bind = function(evt){
@@ -418,7 +418,7 @@ Events.cases({
 
 		;['moo', 
 				...obj.events,
-				...obj.eventfull]
+				...obj.eventful]
 			.forEach(bind)
 
 		assert(obj.event(function(evt, ...args){