@qooxdoo/framework 7.0.0-beta.6 → 7.0.0

package/source/class/qx/io/exception/Cancel.js

@@ -19,16 +19,15 @@
 /**
  *  A class for representing a user-initiated cancellation of a request.
  */
-qx.Class.define("qx.io.exception.Cancel",
-{
-  extend : qx.io.exception.Exception,
+qx.Class.define("qx.io.exception.Cancel", {
+  extend: qx.io.exception.Exception,
 
   /**
    * Constructor
    * @param message {String}
    * @param data {*|null}
    */
-  construct: function(message, data) {
-    this.base(arguments, message, qx.io.exception.Transport.CANCELLED, data);
+  construct(message, data) {
+    super(message, qx.io.exception.Transport.CANCELLED, data);
   }
 });

package/source/class/qx/io/exception/Exception.js

@@ -19,9 +19,8 @@
 /**
  * A generic class for representing exceptions that occur during io operations.
  */
-qx.Class.define("qx.io.exception.Exception",
-{
-  extend : qx.type.BaseError,
+qx.Class.define("qx.io.exception.Exception", {
+  extend: qx.type.BaseError,
 
   /**
    * Constructor
@@ -29,8 +28,8 @@ qx.Class.define("qx.io.exception.Exception",
    * @param code {Number}
    * @param data {*|null}
    */
-  construct: function(message, code, data) {
-    this.base(arguments, "", message);
+  construct(message, code, data) {
+    super("", message);
     this.code = code;
     this.data = data;
     this.name = this.classname;

package/source/class/qx/io/exception/Protocol.js

@@ -20,7 +20,6 @@
  * A class for representing errors that occurred on server and are handled
  * according to the service protocol (JSON-RPC, GraphQL, etc.)
  */
-qx.Class.define("qx.io.exception.Protocol",
-{
-  extend : qx.io.exception.Exception
+qx.Class.define("qx.io.exception.Protocol", {
+  extend: qx.io.exception.Exception
 });

package/source/class/qx/io/exception/Transport.js

@@ -20,20 +20,19 @@
  *  A class for representing errors that occurred during the request transport.
  *  In the context of HTTP requests, the error code is the HTTP error code.
  */
-qx.Class.define("qx.io.exception.Transport",
-{
-  extend : qx.io.exception.Exception,
+qx.Class.define("qx.io.exception.Transport", {
+  extend: qx.io.exception.Exception,
   statics: {
-    TIMEOUT          : 1,
-    ABORTED          : 2,
-    NO_DATA          : 3,
-    INVALID_MSG_DATA : 4,
-    CANCELLED        : 5,
-    INVALID_URI      : 6,
-    FAILED           : 7,
-    INVALID_ID       : 8, // JSON-RPC
-    INVALID_JSON     : 9, // JSON-RPC
-    DUPLICATE_ID     : 10, // JSON-RPC
-    UNKNOWN_ID       : 11 // JSON-RPC
+    TIMEOUT: 1,
+    ABORTED: 2,
+    NO_DATA: 3,
+    INVALID_MSG_DATA: 4,
+    CANCELLED: 5,
+    INVALID_URI: 6,
+    FAILED: 7,
+    INVALID_ID: 8, // JSON-RPC
+    INVALID_JSON: 9, // JSON-RPC
+    DUPLICATE_ID: 10, // JSON-RPC
+    UNKNOWN_ID: 11 // JSON-RPC
   }
 });

package/source/class/qx/io/graphql/Client.js

@@ -25,11 +25,10 @@
  * @experimental The API might change. Feedback is appreciated.
  */
 qx.Class.define("qx.io.graphql.Client", {
-
   extend: qx.io.transport.AbstractClient,
 
   statics: {
-    registerTransport : qx.io.transport.AbstractClient.registerTransport
+    registerTransport: qx.io.transport.AbstractClient.registerTransport
   },
 
   events: {
@@ -38,7 +37,7 @@ qx.Class.define("qx.io.graphql.Client", {
      * {@link qx.io.exception.Transport}, {@link qx.io.exception.Protocol},
      * or {@link qx.io.exception.Cancel}.
      */
-    "error" : "qx.event.type.Data"
+    error: "qx.event.type.Data"
   },
 
   /**
@@ -47,13 +46,12 @@ qx.Class.define("qx.io.graphql.Client", {
    *    or a string URI, which will trigger auto-detection of transport, as long as an
    *    appropriate transport has been registered with the static `registerTransport()` function.
    */
-  construct: function (transportOrUri) {
-    this.base(arguments);
+  construct(transportOrUri) {
+    super();
     this.selectTransport(transportOrUri);
   },
 
   members: {
-
     /**
      * Send the given GraphQl query. See https://graphql.org/learn/queries/
      *
@@ -64,12 +62,15 @@ qx.Class.define("qx.io.graphql.Client", {
       let transport = this.getTransport();
       return new qx.Promise((resolve, reject) => {
         transport.addListenerOnce("message", evt => {
-          try{
+          try {
             if (qx.core.Environment.get("qx.io.graphql.debug")) {
-              this.debug( "<<< Received: " + evt.getData());
+              this.debug("<<< Received: " + evt.getData());
             }
             let responseData = qx.lang.Json.parse(evt.getData());
-            let graphQlResponse = new qx.io.graphql.protocol.Response(responseData);
+            let graphQlResponse = new qx.io.graphql.protocol.Response(
+              responseData
+            );
+
             if (graphQlResponse.getErrors()) {
               return reject(this._handleErrors(graphQlResponse));
             }
@@ -99,14 +100,23 @@ qx.Class.define("qx.io.graphql.Client", {
     _handleErrors(response) {
       let errors = response.getErrors();
       errors.forEach(error => {
-        let exception = new qx.io.exception.Protocol(error.message, null, response.toObject());
+        let exception = new qx.io.exception.Protocol(
+          error.message,
+          null,
+          response.toObject()
+        );
+
         this.fireDataEvent("error", exception);
       });
-      return new qx.io.exception.Protocol(errors[0].message, null, response.toObject());
+      return new qx.io.exception.Protocol(
+        errors[0].message,
+        null,
+        response.toObject()
+      );
     }
   },
 
   environment: {
-    "qx.io.graphql.debug" : false
+    "qx.io.graphql.debug": false
   }
 });

package/source/class/qx/io/graphql/protocol/Message.js

@@ -27,13 +27,13 @@ qx.Class.define("qx.io.graphql.protocol.Message", {
    * Constructor
    * @param {Object} data
    */
-  construct: function(data) {
-    this.base(arguments);
+  construct(data) {
+    super();
     qx.core.Assert.assertObject(data);
     this.set(data);
   },
 
-  members : {
+  members: {
     /**
      * Return the message data in a spec-conformant native object
      */

package/source/class/qx/io/graphql/protocol/Request.js

@@ -22,15 +22,14 @@
  * a HTTP request (https://graphql.org/learn/serving-over-http)
  * @experimental The API might change. Feedback is appreciated.
  */
-qx.Class.define("qx.io.graphql.protocol.Request",{
+qx.Class.define("qx.io.graphql.protocol.Request", {
   extend: qx.io.graphql.protocol.Message,
   properties: {
-
     /**
      * An optional field that only needs to be provided if multiple operations are present in the query
      */
     operationName: {
-      check:"String",
+      check: "String",
       nullable: true,
       event: "changeOperationName"
     },
@@ -38,7 +37,7 @@ qx.Class.define("qx.io.graphql.protocol.Request",{
     /**
      * The query as a string which will be parsed and executed on the server
      */
-    query : {
+    query: {
       check: "String",
       nullable: false,
       init: "",
@@ -48,7 +47,7 @@ qx.Class.define("qx.io.graphql.protocol.Request",{
     /**
      * A qooxdoo object that maps variable names to variable values
      */
-    variables : {
+    variables: {
       check: "qx.core.Object",
       nullable: true,
       event: "changeVariables",
@@ -63,7 +62,7 @@ qx.Class.define("qx.io.graphql.protocol.Request",{
       return qx.lang.Json.stringify(this.toObject(), this._jsonReplacer);
     },
 
-    _jsonReplacer: function(key, value) {
+    _jsonReplacer(key, value) {
       if (key === "variables" || key === "operationName") {
         return value !== null ? value : undefined;
       }
@@ -71,12 +70,11 @@ qx.Class.define("qx.io.graphql.protocol.Request",{
       return value;
     },
 
-
     /**
      * Transforms the variables object to a qooxdoo model. Called automaticaly
      * when the variables property is set.
      */
-    _transformVariables: function(val) {
+    _transformVariables(val) {
       let model = null;
       if (![null, undefined].includes(val)) {
         model = qx.data.marshal.Json.createModel(val);
@@ -84,8 +82,8 @@ qx.Class.define("qx.io.graphql.protocol.Request",{
       return model;
     },
 
-    _validateVariables: function(val) {
-      if (!qx.lang.Type.isObject(val) && (val !== null)) {
+    _validateVariables(val) {
+      if (!qx.lang.Type.isObject(val) && val !== null) {
         throw new qx.core.ValidationError(
           "Validation Error: " + val + " is not an object or null."
         );

package/source/class/qx/io/graphql/protocol/Response.js

@@ -20,11 +20,10 @@
  * An Object modelling a GraphQL response (see http://spec.graphql.org/draft/#sec-Response-Format)
  * @experimental The API might change. Feedback is appreciated.
  */
-qx.Class.define("qx.io.graphql.protocol.Response",{
+qx.Class.define("qx.io.graphql.protocol.Response", {
   extend: qx.io.graphql.protocol.Message,
 
   properties: {
-
     /**
      * "The data entry in the response will be the result of the execution
      * of the requested operation. If the operation was a query, this
@@ -35,7 +34,7 @@ qx.Class.define("qx.io.graphql.protocol.Response",{
      * If an error was encountered during the execution that prevented
      * a valid response, the data entry in the response should be null"
      */
-    data : {
+    data: {
       check: "Object",
       nullable: true,
       init: null
@@ -53,8 +52,11 @@ qx.Class.define("qx.io.graphql.protocol.Response",{
      * response may contain any errors that occurred during execution. If
      * errors occurred during execution, it should contain those errors."
      */
-    errors : {
-      check: value => qx.lang.Type.isArray(value) && value.length && value.every(item => Boolean(item.message)),
+    errors: {
+      check: value =>
+        qx.lang.Type.isArray(value) &&
+        value.length &&
+        value.every(item => Boolean(item.message)),
       nullable: true
     }
   }

package/source/class/qx/io/jsonrpc/Client.js

@@ -20,23 +20,22 @@
  * This class provides a JSON-RPC client object with auto-configuration of the
  * transport used (based on the URI passed).
  */
-qx.Class.define("qx.io.jsonrpc.Client",
-{
-  extend : qx.io.transport.AbstractClient,
+qx.Class.define("qx.io.jsonrpc.Client", {
+  extend: qx.io.transport.AbstractClient,
 
   statics: {
     // statics are not inherited from parent class
-    registerTransport : qx.io.transport.AbstractClient.registerTransport
+    registerTransport: qx.io.transport.AbstractClient.registerTransport
   },
 
-  events : {
+  events: {
     /**
      * Event fired before a request message is sent to the server.
      * Event data is the {@link qx.io.jsonrpc.protocol.Message} to
      * be sent. This also allows listeners to configure the transport
      * object beforehand.
      */
-    "outgoingRequest": "qx.event.type.Data",
+    outgoingRequest: "qx.event.type.Data",
 
     /**
      * Event fired when a request results in an error. Event data is an instance of
@@ -45,7 +44,7 @@ qx.Class.define("qx.io.jsonrpc.Client",
      * Event fired when a message is received from the endpoint. Event data
      * is an UTF-8 encoded string
      */
-    "error" : "qx.event.type.Data",
+    error: "qx.event.type.Data",
 
     /**
      * Event fired when a peer-originated JSON-RPC message has been
@@ -53,7 +52,7 @@ qx.Class.define("qx.io.jsonrpc.Client",
      * qx.io.jsonrpc.message.Batch}, {@link qx.io.jsonrpc.message.Request}
      * or {@link qx.io.jsonrpc.protocol.Notification}.
      */
-    "incomingRequest" : "qx.event.type.Data"
+    incomingRequest: "qx.event.type.Data"
   },
 
   /**
@@ -66,11 +65,14 @@ qx.Class.define("qx.io.jsonrpc.Client",
    * @param {qx.io.jsonrpc.protocol.Parser?} parser
    *    Optional parser object, which needs to be an instance of a subclass of {@link qx.io.jsonrpc.protocol.Parser}
    */
-  construct : function(transportOrUri, methodPrefix, parser) {
-    this.base(arguments);
+  construct(transportOrUri, methodPrefix, parser) {
+    super();
     this.selectTransport(transportOrUri);
     // listen for incoming messages
-    this.getTransport().addListener("message", evt => this.handleIncoming(evt.getData()));
+    this.getTransport().addListener("message", evt =>
+      this.handleIncoming(evt.getData())
+    );
+
     if (!methodPrefix) {
       methodPrefix = "";
     }
@@ -82,33 +84,29 @@ qx.Class.define("qx.io.jsonrpc.Client",
     this.__requests = [];
   },
 
-  properties :
-  {
+  properties: {
     /**
      * An optional string which is prepended to the method name by the {@link #sendRequest}
      * and {@link #sendNotification} methods
      */
-    methodPrefix :
-    {
-      check : "String",
-      nullable : true
+    methodPrefix: {
+      check: "String",
+      nullable: true
     },
 
     /**
      * The parser object, which must be a subclass of {@link qx.io.jsonrpc.protocol.Parser}
-      */
+     */
     parser: {
-      check : "qx.io.jsonrpc.protocol.Parser"
+      check: "qx.io.jsonrpc.protocol.Parser"
     }
   },
 
-  members :
-  {
-
+  members: {
     /**
      * A cache of the requests which have been sent out and are still pending
      */
-    __requests : null,
+    __requests: null,
 
     /**
      * If a service name has been configured, prepend it to the method name,
@@ -151,19 +149,35 @@ qx.Class.define("qx.io.jsonrpc.Client",
      * when there is an error or a cancellation up to that point.
      */
     async send(message) {
-      if (!(message instanceof qx.io.jsonrpc.protocol.Message || message instanceof qx.io.jsonrpc.protocol.Batch)) {
-        throw new Error("Argument must be instanceof qx.io.jsonrpc.protocol.Message or qx.io.jsonrpc.protocol.Batch");
+      if (
+        !(
+          message instanceof qx.io.jsonrpc.protocol.Message ||
+          message instanceof qx.io.jsonrpc.protocol.Batch
+        )
+      ) {
+        throw new Error(
+          "Argument must be instanceof qx.io.jsonrpc.protocol.Message or qx.io.jsonrpc.protocol.Batch"
+        );
       }
 
       // filter by type
-      let messages = message instanceof qx.io.jsonrpc.protocol.Batch ? message.getBatch().toArray() : [message];
-      let requests = messages.filter(message => message instanceof qx.io.jsonrpc.protocol.Request);
+      let messages =
+        message instanceof qx.io.jsonrpc.protocol.Batch
+          ? message.getBatch().toArray()
+          : [message];
+      let requests = messages.filter(
+        message => message instanceof qx.io.jsonrpc.protocol.Request
+      );
 
       // store requests
       requests.forEach(request => {
         let id = request.getId();
         if (this.__requests[id] !== undefined) {
-          throw new qx.io.exception.Transport(`Request ID ${id} is already in use`, qx.io.exception.Transport.INVALID_ID, {request: message.toObject()});
+          throw new qx.io.exception.Transport(
+            `Request ID ${id} is already in use`,
+            qx.io.exception.Transport.INVALID_ID,
+            { request: message.toObject() }
+          );
         }
         this.__requests[id] = request;
       });
@@ -189,7 +203,11 @@ qx.Class.define("qx.io.jsonrpc.Client",
      * and rejects with an exception in the {@link qx.io.jsonrpc.exception} namespace.
      */
     async sendRequest(method, params) {
-      const request = new qx.io.jsonrpc.protocol.Request(this._prependMethodPrefix(method), params);
+      const request = new qx.io.jsonrpc.protocol.Request(
+        this._prependMethodPrefix(method),
+        params
+      );
+
       await this.send(request);
       return await request.getPromise();
     },
@@ -202,7 +220,11 @@ qx.Class.define("qx.io.jsonrpc.Client",
      * notification has been sent out (which is synchronous)
      */
     async sendNotification(method, params) {
-      const notification = new qx.io.jsonrpc.protocol.Notification(this._prependMethodPrefix(method), params);
+      const notification = new qx.io.jsonrpc.protocol.Notification(
+        this._prependMethodPrefix(method),
+        params
+      );
+
       await this.send(notification);
     },
 
@@ -215,7 +237,11 @@ qx.Class.define("qx.io.jsonrpc.Client",
     async sendBatch(batch) {
       qx.core.Assert.assertInstance(batch, qx.io.jsonrpc.protocol.Batch);
       if (this.getMethodPrefix()) {
-        batch.getBatch().forEach(message => message.setMethod(this._prependMethodPrefix(message.getMethod())));
+        batch
+          .getBatch()
+          .forEach(message =>
+            message.setMethod(this._prependMethodPrefix(message.getMethod()))
+          );
       }
       await this.send(batch);
       return await qx.Promise.all(batch.getPromises());
@@ -269,7 +295,10 @@ qx.Class.define("qx.io.jsonrpc.Client",
       qx.core.Assert.assertInstance(message, qx.io.jsonrpc.protocol.Message);
       let request;
       let id;
-      if (message instanceof qx.io.jsonrpc.protocol.Result || message instanceof qx.io.jsonrpc.protocol.Error) {
+      if (
+        message instanceof qx.io.jsonrpc.protocol.Result ||
+        message instanceof qx.io.jsonrpc.protocol.Error
+      ) {
         // handle results and errors, which are responses to sent requests
         id = message.getId();
         request = this.__requests[id];
@@ -284,9 +313,9 @@ qx.Class.define("qx.io.jsonrpc.Client",
         if (request === true) {
           // the request has already been responded to
           throw new qx.io.exception.Transport(
-              `Invalid jsonrpc response data: multiple responses with same id ${id}.`,
-              qx.io.exception.Transport.DUPLICATE_ID,
-              message.toObject()
+            `Invalid jsonrpc response data: multiple responses with same id ${id}.`,
+            qx.io.exception.Transport.DUPLICATE_ID,
+            message.toObject()
           );
         }
       }
@@ -295,18 +324,21 @@ qx.Class.define("qx.io.jsonrpc.Client",
         // resolve the individual promise
         request.getPromise().resolve(message.getResult());
       } else if (message instanceof qx.io.jsonrpc.protocol.Error) {
-
         let error = message.getError();
         let ex = new qx.io.exception.Protocol(
           error.message,
           error.code,
           message.toObject()
         );
+
         // inform listeners
         this.fireDataEvent("error", ex);
         // reject the individual promise
         request.getPromise().reject(ex);
-      } else if (message instanceof qx.io.jsonrpc.protocol.Request || message instanceof qx.io.jsonrpc.protocol.Notification) {
+      } else if (
+        message instanceof qx.io.jsonrpc.protocol.Request ||
+        message instanceof qx.io.jsonrpc.protocol.Notification
+      ) {
         // handle peer-originated requests and notifications
         this.fireDataEvent("incomingRequest", message);
       } else {
@@ -318,6 +350,6 @@ qx.Class.define("qx.io.jsonrpc.Client",
   },
 
   environment: {
-    "qx.io.jsonrpc.debug" : false
+    "qx.io.jsonrpc.debug": false
   }
 });

package/source/class/qx/io/jsonrpc/__init__.js

@@ -9,7 +9,7 @@
  * Other transports based on websockets or other mechanisms can be added later.</p>
  *
  * <p>Please refer to
- * <a href="https://github.com/qooxdoo/incubator.qx.io.jsonrpc/blob/master/readme.md#usage">
+ * <a href="https://qooxdoo.org/documentation/v7.0/#/communication/">
  *    the documentation on GitHub
  *  </a></p>
  */

package/source/class/qx/io/jsonrpc/protocol/Batch.js

@@ -25,19 +25,19 @@
  *  - {@link qx.io.jsonrpc.protocol.Error}
  *  @see https://www.jsonrpc.org/specification#batch
  */
-qx.Class.define("qx.io.jsonrpc.protocol.Batch",{
+qx.Class.define("qx.io.jsonrpc.protocol.Batch", {
   extend: qx.core.Object,
   properties: {
-    batch : {
+    batch: {
       check: "qx.data.Array"
     }
   },
+
   construct() {
-    this.base(arguments);
+    super();
     this.setBatch(new qx.data.Array());
   },
   members: {
-
     /**
      * Adds a request or notification to the batch
      * @param {qx.io.jsonrpc.protocol.Message} message
@@ -55,7 +55,7 @@ qx.Class.define("qx.io.jsonrpc.protocol.Batch",{
      * @param method
      * @param params
      */
-    addRequest(method,params) {
+    addRequest(method, params) {
       this.add(new qx.io.jsonrpc.protocol.Request(method, params));
       return this;
     },
@@ -65,7 +65,7 @@ qx.Class.define("qx.io.jsonrpc.protocol.Batch",{
      * @param method
      * @param params
      */
-    addNotification(method,params) {
+    addNotification(method, params) {
       this.add(new qx.io.jsonrpc.protocol.Notification(method, params));
       return this;
     },
@@ -83,7 +83,9 @@ qx.Class.define("qx.io.jsonrpc.protocol.Batch",{
      * @return {*}
      */
     toObject() {
-      return this.getBatch().toArray().map(message => message.toObject());
+      return this.getBatch()
+        .toArray()
+        .map(message => message.toObject());
     },
 
     /**
@@ -91,7 +93,11 @@ qx.Class.define("qx.io.jsonrpc.protocol.Batch",{
      * @return {String}
      */
     toString() {
-      return JSON.stringify(this.getBatch().toArray().map(message => message.toObject()));
+      return JSON.stringify(
+        this.getBatch()
+          .toArray()
+          .map(message => message.toObject())
+      );
     }
   }
 });

package/source/class/qx/io/jsonrpc/protocol/Error.js

@@ -21,26 +21,28 @@
  * indicating a failure during the processing of the request on the server.
  * @see https://www.jsonrpc.org/specification#error_object
  */
-qx.Class.define("qx.io.jsonrpc.protocol.Error",{
+qx.Class.define("qx.io.jsonrpc.protocol.Error", {
   extend: qx.io.jsonrpc.protocol.Message,
   properties: {
-
     /**
      * The integer id of the request
      * @var {Number}
      */
-    id : {
-      check: value => qx.lang.Type.isNumber(value) && parseInt(value, 10) === value
+    id: {
+      check: value =>
+        qx.lang.Type.isNumber(value) && parseInt(value, 10) === value
     },
 
     /**
      * The error object
      * @var {Object}
      */
-    error : {
-      check : value => qx.lang.Type.isObject(value) && "code" in value && "message" in value
+    error: {
+      check: value =>
+        qx.lang.Type.isObject(value) && "code" in value && "message" in value
     }
   },
+
   /**
    * The response messsage constructor
    * @param {Number} id^
@@ -49,12 +51,12 @@ qx.Class.define("qx.io.jsonrpc.protocol.Error",{
    * @param {*?} data
    */
   construct(id, code, message, data) {
-    this.base(arguments);
+    super();
     this.setId(id);
-    if (!qx.lang.Type.isNumber(code) || parseInt(code, 10) !== code ) {
+    if (!qx.lang.Type.isNumber(code) || parseInt(code, 10) !== code) {
       throw new Error("Code must be an integer");
     }
-    let errorObj = {code, message};
+    let errorObj = { code, message };
     if (data) {
       errorObj.data = data;
     }