Release 23.6

Author: lucasbraun

README.md

@@ -129,6 +129,9 @@ recommend to read our blog post on [Linting MLE JavaScript Modules in Continuous
 Integration Pipelines][4].
 
 ## Changelog
+- **Oracle 23.6**
+    - improved documentation for OracleNumber
+    [infix operators](https://oracle-samples.github.io/mle-modules/docs/mle-js-plsqltypes/23ai/classes/OracleNumber.html).
 - **Oracle 23.5**
     - support for
     [sql-template-tag](https://www.npmjs.com/package/sql-template-tag#oracledb)

declarations/mle-encode-base64/package.json

@@ -3,7 +3,7 @@
   "description": "MLE functions to work with base64 encoded data",
   "types": "mle-encode-base64.d.ts",
   "author": "Oracle",
-  "version": "23.5.0",
+  "version": "23.6.0",
   "license": "UPL-1.0",
   "homepage": "https://oracle-samples.github.io/mle-modules",
   "repository": {

declarations/mle-js-bindings/package.json

@@ -3,7 +3,7 @@
   "description": "MLE Bindings for Oracle Database DBMS_MLE",
   "types": "mle-js-bindings.d.ts",
   "author": "Oracle",
-  "version": "23.5.0",
+  "version": "23.6.0",
   "license": "UPL-1.0",
   "homepage": "https://oracle-samples.github.io/mle-modules",
   "repository": {

declarations/mle-js-encodings/package.json

@@ -3,7 +3,7 @@
   "description": "MLE text encoding API",
   "types": "index.d.ts",
   "author": "Oracle",
-  "version": "23.5.0",
+  "version": "23.6.0",
   "license": "UPL-1.0",
   "homepage": "https://oracle-samples.github.io/mle-modules",
   "repository": {

declarations/mle-js-fetch/package.json

@@ -3,7 +3,7 @@
   "description": "MLE Fetch API polyfill",
   "types": "index.d.ts",
   "author": "Oracle",
-  "version": "23.5.0",
+  "version": "23.6.0",
   "license": "UPL-1.0",
   "homepage": "https://oracle-samples.github.io/mle-modules",
   "repository": {

declarations/mle-js-oracledb/api.d.ts

@@ -478,8 +478,6 @@ export declare abstract class IConnection {
      * it conforms to the {@link IExecuteArgs} interface
      * and contains the SQL statement to be executed and the bind values.
      *
-     * This object exposes the SQL statement and values properties to retrieve the SQL string and bind values
-     * The statement may contain bind parameters.
      * @param bindParams needed if there are bind parameters in the SQL
      * statement, see {@link BindParameters}.
      * @param options an optional parameter to execute() that may be used to

declarations/mle-js-oracledb/package.json

@@ -3,7 +3,7 @@
   "description": "MLE SQL Driver",
   "types": "index.d.ts",
   "author": "Oracle",
-  "version": "23.5.0",
+  "version": "23.6.0",
   "license": "UPL-1.0",
   "homepage": "https://oracle-samples.github.io/mle-modules",
   "repository": {

declarations/mle-js-plsqltypes/mle-js-plsqltypes.d.ts

@@ -36,7 +36,8 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 */
 /**
- * declare Operators object
+ * Class which implements infix operators for Oracle Number
+ * arithmetics: +, -, /, *, etc.
  *
  * @since Oracle 23.5
  */
@@ -66,7 +67,8 @@ export declare const OracleClob: IOracleClob;
  */
 export declare const OracleDate: IOracleDate;
 /**
- * JavaScript API for Oracle type NUMBER.
+ * JavaScript API for Oracle type NUMBER. Since Oracle 23.5, this class also
+ * supports infix operator arithmetics: +, -, /, *, etc.
  */
 export declare class OracleNumber extends OracleNumberOperators {
     private impl;
@@ -117,30 +119,40 @@ export declare class OracleNumber extends OracleNumberOperators {
      * Adds an Oracle number to another Oracle number
      * @param other - the other Oracle number
      * @returns returns the sum of the two Oracle NUMBERs
+     *
+     * Note: since Oracle 23.5, `this + other` can be used instead.
      */
     add(other: OracleNumber): OracleNumber;
     /**
      * Subtracts an Oracle number from the Oracle number and returns the resulting Oracle number
      * @param other - the other number to be subtracted from the OracleNumber
      * @returns the result of the subtraction as OracleNumber
+     *
+     * Note: since Oracle 23.5, `this - other` can be used instead.
      */
     sub(other: OracleNumber): OracleNumber;
     /**
      * Multiplies the Oracle number with another Oracle number
      * @param other - the other Oracle number
      * @returns the result of the multiplication as Oracle number
+     *
+     * Note: since Oracle 23.5, `this * other` can be used instead.
      */
     mul(other: OracleNumber): OracleNumber;
     /**
      * Divides two Oracle numbers
      * @param other - divisor
      * @returns the result of the division as Oracle number
+     *
+     * Note: since Oracle 23.5, `this / other` can be used instead.
      */
     div(other: OracleNumber): OracleNumber;
     /**
      * Computes the modulus of two Oracle numbers.
      * @param other - the other Oracle number
      * @returns this number modulo the other number
+     *
+     * Note: since Oracle 23.5, `this % other` can be used instead.
      */
     mod(other: OracleNumber): OracleNumber;
     /**
@@ -198,12 +210,16 @@ export declare class OracleNumber extends OracleNumberOperators {
      * Compares two Oracle numbers.
      * Returns -1 if this < other, 0 if they are equal, and 1 if this > other.
      * @returns the result of the comparison as a number between -1 and +1.
+     *
+     * Note: since Oracle 23.5, `<, <=, >=, >` can be used instead.
      */
     compare(other: OracleNumber): number;
     /**
      * Checks if the Oracle number is equal to another Oracle number
      * @param other - the other Oracle number
      * @returns true if both Oracle numbers are equal, otherwise false
+     *
+     * Note: since Oracle 23.5, `==` or `!=` can be used instead.
      */
     equals(other: OracleNumber): boolean;
     /**
@@ -214,6 +230,8 @@ export declare class OracleNumber extends OracleNumberOperators {
     /**
      * Raises this Oracle number to the given exponent
      * @returns the result of the exponentiation
+     *
+     * Note: since Oracle 23.5, `this ** other` can be used instead.
      */
     power(exp: OracleNumber | number): OracleNumber;
     /**
@@ -250,6 +268,8 @@ export declare class OracleNumber extends OracleNumberOperators {
     /**
      * Negates the number
      * @returns the negated Oracle number
+     *
+     * Note: since Oracle 23.5, `-this` can be used instead.
      */
     neg(): OracleNumber;
     /**
@@ -278,6 +298,8 @@ export declare class OracleNumber extends OracleNumberOperators {
      * Shifts the number by the specified number of decimal places
      * @param digits - number of decimal places to shift. It can be negative. Positive values shift the decimal place to the right and negative values to the left. For example, if NUMBER corresponds to 1234.5 and digits == -1, the new NUMBER object will correspond to 123.45.
      * @returns an Oracle number containing the shifted result
+     *
+     * Note: since Oracle 23.5, `this >> other` or `this << -other` can be used instead.
      */
     shift(digits: OracleNumber | number): OracleNumber;
     /**

declarations/mle-js-plsqltypes/package.json

@@ -3,7 +3,7 @@
   "description": "MLE PL/SQL Types",
   "types": "mle-js-plsqltypes.d.ts",
   "author": "Oracle",
-  "version": "23.5.0",
+  "version": "23.6.0",
   "license": "UPL-1.0",
   "homepage": "https://oracle-samples.github.io/mle-modules",
   "repository": {

declarations/mle-js/mle-js.d.ts

@@ -135,14 +135,16 @@ declare namespace __mle_js_plsqltypes {
 
 
 /**
- * declare Operators object
+ * Class which implements infix operators for Oracle Number
+ * arithmetics: +, -, /, *, etc.
  *
  * @since Oracle 23.5
  */
 const OracleNumberOperators: any;
 
 /**
- * JavaScript API for Oracle type NUMBER.
+ * JavaScript API for Oracle type NUMBER. Since Oracle 23.5, this class also
+ * supports infix operator arithmetics: +, -, /, *, etc.
  */
 export class OracleNumber extends OracleNumberOperators {
     private impl;
@@ -193,30 +195,40 @@ export class OracleNumber extends OracleNumberOperators {
      * Adds an Oracle number to another Oracle number
      * @param other - the other Oracle number
      * @returns returns the sum of the two Oracle NUMBERs
+     *
+     * Note: since Oracle 23.5, `this + other` can be used instead.
      */
     add(other: OracleNumber): OracleNumber;
     /**
      * Subtracts an Oracle number from the Oracle number and returns the resulting Oracle number
      * @param other - the other number to be subtracted from the OracleNumber
      * @returns the result of the subtraction as OracleNumber
+     *
+     * Note: since Oracle 23.5, `this - other` can be used instead.
      */
     sub(other: OracleNumber): OracleNumber;
     /**
      * Multiplies the Oracle number with another Oracle number
      * @param other - the other Oracle number
      * @returns the result of the multiplication as Oracle number
+     *
+     * Note: since Oracle 23.5, `this * other` can be used instead.
      */
     mul(other: OracleNumber): OracleNumber;
     /**
      * Divides two Oracle numbers
      * @param other - divisor
      * @returns the result of the division as Oracle number
+     *
+     * Note: since Oracle 23.5, `this / other` can be used instead.
      */
     div(other: OracleNumber): OracleNumber;
     /**
      * Computes the modulus of two Oracle numbers.
      * @param other - the other Oracle number
      * @returns this number modulo the other number
+     *
+     * Note: since Oracle 23.5, `this % other` can be used instead.
      */
     mod(other: OracleNumber): OracleNumber;
     /**
@@ -274,12 +286,16 @@ export class OracleNumber extends OracleNumberOperators {
      * Compares two Oracle numbers.
      * Returns -1 if this < other, 0 if they are equal, and 1 if this > other.
      * @returns the result of the comparison as a number between -1 and +1.
+     *
+     * Note: since Oracle 23.5, `<, <=, >=, >` can be used instead.
      */
     compare(other: OracleNumber): number;
     /**
      * Checks if the Oracle number is equal to another Oracle number
      * @param other - the other Oracle number
      * @returns true if both Oracle numbers are equal, otherwise false
+     *
+     * Note: since Oracle 23.5, `==` or `!=` can be used instead.
      */
     equals(other: OracleNumber): boolean;
     /**
@@ -290,6 +306,8 @@ export class OracleNumber extends OracleNumberOperators {
     /**
      * Raises this Oracle number to the given exponent
      * @returns the result of the exponentiation
+     *
+     * Note: since Oracle 23.5, `this ** other` can be used instead.
      */
     power(exp: OracleNumber | number): OracleNumber;
     /**
@@ -326,6 +344,8 @@ export class OracleNumber extends OracleNumberOperators {
     /**
      * Negates the number
      * @returns the negated Oracle number
+     *
+     * Note: since Oracle 23.5, `-this` can be used instead.
      */
     neg(): OracleNumber;
     /**
@@ -354,6 +374,8 @@ export class OracleNumber extends OracleNumberOperators {
      * Shifts the number by the specified number of decimal places
      * @param digits - number of decimal places to shift. It can be negative. Positive values shift the decimal place to the right and negative values to the left. For example, if NUMBER corresponds to 1234.5 and digits == -1, the new NUMBER object will correspond to 123.45.
      * @returns an Oracle number containing the shifted result
+     *
+     * Note: since Oracle 23.5, `this >> other` or `this << -other` can be used instead.
      */
     shift(digits: OracleNumber | number): OracleNumber;
     /**
@@ -2286,8 +2308,6 @@ export abstract class IConnection {
      * it conforms to the {@link IExecuteArgs} interface
      * and contains the SQL statement to be executed and the bind values.
      *
-     * This object exposes the SQL statement and values properties to retrieve the SQL string and bind values
-     * The statement may contain bind parameters.
      * @param bindParams needed if there are bind parameters in the SQL
      * statement, see {@link BindParameters}.
      * @param options an optional parameter to execute() that may be used to