ig-types 6.24.3 → 6.24.4

package/Promise.js

@@ -795,6 +795,7 @@ object.Constructor('ProxyPromise', Promise, {
 
 //---------------------------------------------------------------------
 
+// XXX should this support async generators???
 var syncAllProxy = 
 function(name){
 	return function(lst){
@@ -809,6 +810,7 @@ function(name){
 			: Promise[name](lst) } }
 
 // XXX REVISE/TEST...
+// XXX should this support async generators???
 var syncAnyProxy =
 function(name){
 	return function(lst){
@@ -837,6 +839,8 @@ object.Constructor('SyncPromise', Promise, {
 		return new this(function(resolve){ resolve(value) }) },
 	reject: function(error){
 		return new this(function(_, reject){ reject(error) }) },
+	// NOTE: these essentially add a special case where the inputs are
+	// 		either not promises or SyncPromise instances...
 	all: syncAllProxy('all'),
 	allSettled: syncAllProxy('allSettled'),
 	any: syncAnyProxy('any'),
@@ -944,9 +948,12 @@ object.Mixin('PromiseProtoMixin', 'soft', {
 	as: ProxyPromise,
 	iter: function(handler=undefined){
 		return IterablePromise(this, handler) },
+	// XXX should we try and return a sync value if normal promise is resolved???
+	// 		...sould need to hook .then(..) to do this...
 	sync: function(error='throw'){
 		if(this instanceof SyncPromise){
-			if('error' in this){
+			if(error !== false 
+					&& 'error' in this){
 				if(typeof(error) != 'function'){
 					throw this.error }
 				return error(this.error) }

package/README.md

@@ -2034,10 +2034,29 @@ Example:
 -->
 
 
-#### `<promise>.sync()`
+#### `<promise>.sync(..)`
 
 Synchronously return the resolved value if `<sync-promise>` resolved, and
-if it _rejected_ then re-throw the `<error>`.
+if it _rejected_ then re-throw the `<error>`. Normal promises will return self.
+
+```bnf
+<promise>.sync()
+	-> <value>
+	-> <promise>
+```
+
+To suppress errors pass `false` to `.sync(..)` and to handle them differently 
+pass an error handler function.
+```bnf
+<promise>.sync(false)
+	-> <value>
+
+<promise>.sync(<onerror>)
+	-> <value>
+
+<onerror>(<error>)
+	-> <value>
+```
 
 
 #### `<sync-promise>.value` / `<sync-promise>.error`
@@ -2048,8 +2067,8 @@ rejection `.error`.
 
 #### `Promise.sync.all(..)` / `Promise.sync.allSettled(..)` / `Promise.sync.any(..)` / `Promise.sync.race(..)`
 
-Equivalents to `Promise`'s version but will run sync if the relevant 
-items in the input are either non-promises or `<sync-promise>`s.
+Equivalents to `Promise`'s respective versions but will run sync if the 
+relevant items in the input are either non-promises or `<sync-promise>`s.
 
 
 

package/package.json

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