exupery-core-async 0.1.12 → 0.1.14

package/dist/Safe_Query_Result.d.ts

@@ -11,8 +11,8 @@ export interface Safe_Query_Result<T> {
      * @param handle_value callback that transforms the actual value into a new Async_Value
      */
     then<NT>(handle_value: ($: T) => Safe_Query_Result<NT>): Safe_Query_Result<NT>;
-    execute_safe_command(handle_value: ($: T) => Safe_Command_Result): Safe_Command_Result;
-    execute_unsafe_command<E>(handle_value: ($: T) => Unsafe_Command_Result<E>): Unsafe_Command_Result<E>;
+    process_safe(handle_value: ($: T) => Safe_Command_Result): Safe_Command_Result;
+    process_unsafe<E>(handle_value: ($: T) => Unsafe_Command_Result<E>): Unsafe_Command_Result<E>;
     /**
      * This method is only to be used by resources
      */

package/dist/Unsafe_Query_Result.d.ts

@@ -1,3 +1,4 @@
+import { Safe_Command_Result } from "./Safe_Command_Result";
 import { Safe_Query_Result } from "./Safe_Query_Result";
 import { Unsafe_Command_Result } from "./Unsafe_Command_Result";
 export interface Unsafe_Query_Result<T, E> {
@@ -5,6 +6,19 @@ export interface Unsafe_Query_Result<T, E> {
     map_exception<NE>(handle_exception: ($: E) => NE): Unsafe_Query_Result<T, NE>;
     then<NT>(handle_value: ($: T) => Unsafe_Query_Result<NT, E>): Unsafe_Query_Result<NT, E>;
     catch(handle_exception: ($: E) => T): Safe_Query_Result<T>;
-    execute_unsafe_command(handle_value: ($: T) => Unsafe_Command_Result<E>): Unsafe_Command_Result<E>;
+    /**
+     * processes the queried data by executing a command.
+     *
+     * if the result on which this method is called is in an exception state, the command will not be executed.
+     * instead, the 2 other handlers will be called.
+     * first, the exception handler will be called, to report the exception.
+     * secondly, the exception will be mapped into a new exception value that has the same type as the command's exception type.
+     *
+     * @param handle_value the handler that will be called to process the queried data, if no exception has occurred
+     * @param handle_exception the handler that will process an exception if the query is in an exception state to allow reporting the exception
+     * @param map_exception the handler that will map the exception of the query into a new exception value of the command's exception type
+     *
+     */
+    process<NE>(handle_value: ($: T) => Unsafe_Command_Result<NE>, handle_exception: ($: E) => Safe_Command_Result, map_exception: ($: E) => NE): Unsafe_Command_Result<NE>;
     __start(on_value: ($: T) => void, on_exception: ($: E) => void): void;
 }

package/dist/run_safe_query.js

@@ -25,7 +25,7 @@ class Safe_Query_Result_Class {
             }
         });
     }
-    execute_safe_command(handle_value) {
+    process_safe(handle_value) {
         return (0, execute_safe_command_1.__execute_safe_command)({
             'execute': (on_success) => {
                 this.executer.execute((value) => {
@@ -34,7 +34,7 @@ class Safe_Query_Result_Class {
             }
         });
     }
-    execute_unsafe_command(handle_value) {
+    process_unsafe(handle_value) {
         return (0, execute_unsafe_command_1.__execute_unsafe_command)({
             'execute': (on_success, on_exception) => {
                 this.executer.execute((value) => {

package/dist/run_unsafe_query.js

@@ -43,12 +43,14 @@ class Unsafe_Query_Result_Class {
             }
         });
     }
-    execute_unsafe_command(handle_value) {
+    process(handle_value, handle_exception, map_exception) {
         return (0, execute_unsafe_command_1.__execute_unsafe_command)({
             'execute': (on_success, on_exception) => {
                 this.executer.execute((value) => {
                     handle_value(value).__start(on_success, on_exception);
-                }, on_exception);
+                }, (exception) => {
+                    handle_exception(exception).__start(() => on_exception(map_exception(exception)));
+                });
             }
         });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "exupery-core-async",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "license": "Apache-2.0",
   "author": "Corno",
   "description": "async types for Exupery",