Release 23.2

Author: lucasbraun

LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2017, 2022, Oracle and/or its affiliates.
+Copyright (c) 2017, 2023, Oracle and/or its affiliates.
 
 The Universal Permissive License (UPL), Version 1.0
 

README.md

@@ -1,37 +1,44 @@
 # MLE Modules
-The Oracle Database Multilingual Engine (MLE) enables [JavaScript execution in Oracle Database as of version 21c][1].
+The Oracle Database Multilingual Engine (MLE) enables [JavaScript execution in Oracle Database][1].
 In this database JavaScript environment, there exist some JavaScript modules that are available out of the box.
-This repository contains documentation and interface definitions (in the form of TypeScript declarations) for those pre-defined modules.
+This repository contains documentation and interface definitions (in the form of TypeScript declarations) for those predefined modules.
 While the documentation contains set of human-readable, linked pages, the TypeScript declaration files are typically consumed by an IDE for improving auto-completion.
 This is particularly useful in a scenario where JavaScript code gets developed locally in an IDE and then deployed to the database.
 
 The following JavaScript modules are currently available:
 - MLE SQL Driver: [mle-js-oracledb][mle-js-oracledb]
 - MLE Bindings: [mle-js-bindings][mle-js-bindings]
-- MLE PL/SQL Types [mle-js-plsqltypes][mle-js-plsqltypes]
+- MLE PL/SQL Types: [mle-js-plsqltypes][mle-js-plsqltypes]
+- MLE Fetch API polyfill: [mle-js-fetch][mle-js-fetch]
 
 ## Installation
 You need an Oracle Database to make use of the JavaScript modules provided in the Oracle Database Multilingual Engine (MLE).
 A very convenient way of getting an Oracle Database instance is to create an always-free Oracle Cloud account and set up a free autonomous database instance there as our [blog article][2] explains in great detail.
 
-The declaration files can conveniently be installed into your project directory using NPM:
+You can install all relevant declarations of these modules plus the declarations of all global symbols (`Polyglot`, `console`, `session`, `soda`, `oracledb`, `OracleNumber`, etc.) in one bundle.
+You can conveniently install `mle-js` from NPM and then reference it in the beginning of your JavaScript code using the `<reference>` tag:
 
 ```
-npm install mle-js-oracledb
-npm install mle-js-bindings
-npm install mle-js-plsqltypes
+npm install mle-js
+/// <reference types="mle-js" />
 ```
 
-Alternatively, you can also download `mle-js` which is a single bundled ambient file for all these module declarations in one.
-In addition, this bundle also contains declarations for GraalVM JavaScript builtins, concretely `Polyglot` and `console`.
-You can conveniently install it from NPM and then reference it in the beginning of your JavaScript code using the `<reference>` tag:
+If you only need declarations of a particular module, you can also just install them individually:
+
 ```
-npm install mle-js
-/// <reference types="mle-js" />
+npm install mle-js-oracledb
+npm install mle-js-bindings
+npm install mle-js-plsqltypes
+npm install mle-js-fetch
 ```
 
 ## Documentation
 
+### All-In-One bundle for MLE modules (mle-js)
+This bundle contains all relevant declarations of predefined JavaScript modules that ship with the database plus the declarations of all global symbols.
+
+[Continue reading...][mle-js]
+
 ### MLE SQL Driver (mle-js-oracledb)
 If JavaScript is executed inside the database, SQL statements can be executed using an easy to use SQL driver.
 This driver is built-in into the JavaScript engine in the database.
@@ -52,6 +59,12 @@ The mle-js-plsqltypes module contains JavaScript APIs for such JavaScript object
 
 [Continue reading...][mle-js-plsqltypes]
 
+### MLE Fetch API polyfill (mle-js-fetch)
+MLE offers the following functionality to fetch and upload resources asynchronously across the network: fetch, Headers, Request, Response.
+In order to make the Fetch API available, it needs to be imported first.
+
+[Continue reading...][mle-js-fetch]
+
 ### Oracle Database
 Oracle Database is the world's most popular database.
 Available on cloud and on-premises platforms, Oracle Database 19c is the most recent long term release, with an extended support window.
@@ -64,10 +77,11 @@ The following table shows which version of module documentation and declarations
 
 | Oracle Database  | Modules |
 | ---------------- | --------|
-| 21.3, 21.4, etc. | [[email protected]][mle-js-oracledb] <br/> [[email protected]][mle-js-bindings] <br/> [[email protected]][mle-js-plsqltypes] |
+| 23c | [[email protected]][mle-js] <br/> [[email protected]][mle-js-oracledb] <br/> [[email protected]][mle-js-bindings] <br/> [[email protected]][mle-js-plsqltypes] <br/> [[email protected]][mle-js-fetch] |
+| 21c | [[email protected]][mle-js-oracledb-21c] <br/> [[email protected]][mle-js-bindings-21c] <br/> [[email protected]][mle-js-plsqltypes-21c] |
 
 ## Examples
-The following code snippet exemplifies the usage of all MLE modules combined.
+The following code snippet exemplifies the usage of some of these MLE modules combined.
 For additional examples, please check the module documentation pages or have a look at our [blog article][2].
 
 ```JavaScript
@@ -106,9 +120,14 @@ Copyright (c) 2022 Oracle and/or its affiliates.
 
 Released under the Universal Permissive License v1.0 as shown at <https://oss.oracle.com/licenses/upl/>.
 
-[mle-js-oracledb]: http://oracle-samples.github.io/mle-modules/docs/mle-js-oracledb/21c "[email protected]"
-[mle-js-bindings]: http://oracle-samples.github.io/mle-modules/docs/mle-js-bindings/21c "[email protected]"
-[mle-js-plsqltypes]: http://oracle-samples.github.io/mle-modules/docs/mle-js-plsqltypes/21c "[email protected]"
-[1]: https://medium.com/graalvm/mle-executing-javascript-in-oracle-database-c545feb1a010 "Multilingual Engine: Executing JavaScript in Oracle Database"
+[mle-js]: http://oracle-samples.github.io/mle-modules/docs/mle-js/23c "[email protected]"
+[mle-js-oracledb]: http://oracle-samples.github.io/mle-modules/docs/mle-js-oracledb/23c "[email protected]"
+[mle-js-bindings]: http://oracle-samples.github.io/mle-modules/docs/mle-js-bindings/23c "[email protected]"
+[mle-js-plsqltypes]: http://oracle-samples.github.io/mle-modules/docs/mle-js-plsqltypes/23c "[email protected]"
+[mle-js-fetch]: http://oracle-samples.github.io/mle-modules/docs/mle-js-fetch/23c "[email protected]"
+[mle-js-oracledb-21c]: http://oracle-samples.github.io/mle-modules/docs/mle-js-oracledb/21c "[email protected]"
+[mle-js-bindings-21c]: http://oracle-samples.github.io/mle-modules/docs/mle-js-bindings/21c "[email protected]"
+[mle-js-plsqltypes-21c]: http://oracle-samples.github.io/mle-modules/docs/mle-js-plsqltypes/21c "[email protected]"
+[1]: https://blogs.oracle.com/developers/post/introduction-javascript-oracle-database-23c-free-developer-release "Introduction to JavaScript in Oracle Database 23c Free - Developer Release"
 [2]: https://blogs.oracle.com/apex/post/mle-and-the-future-of-server-side-programming-in-oracle-apex "MLE and the Future of Server-Side Programming in Oracle APEX"
-[3]: https://docs.oracle.com/en/database/oracle/oracle-database/21/index.html "Oracle Database 21c"
+[3]: https://docs.oracle.com/en/database/oracle/oracle-database/23/index.html "Oracle Database 23c"

declarations/mle-js-bindings/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2017, 2022, Oracle and/or its affiliates.
+Copyright (c) 2017, 2023, Oracle and/or its affiliates.
 
 The Universal Permissive License (UPL), Version 1.0
 

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

@@ -1,5 +1,5 @@
 /**
-Copyright (c) 2019, 2021, Oracle and/or its affiliates.
+Copyright (c) 2019, 2022, Oracle and/or its affiliates.
 
 The Universal Permissive License (UPL), Version 1.0
 
@@ -44,10 +44,6 @@ export declare enum JSTypes {
     DATE = 2,
     /** Type Boolean */
     BOOLEAN = 3,
-    /** Type CLOB */
-    CLOB = 4,
-    /** Type BLOB */
-    BLOB = 5,
     /** Type Object */
     OBJECT = 6,
     /** UINT8ARRAY */
@@ -67,7 +63,9 @@ export declare enum JSTypes {
     /** Type OracleCLOB */
     ORACLE_CLOB = 14,
     /** Type OracleBLOB */
-    ORACLE_BLOB = 15
+    ORACLE_BLOB = 15,
+    /** Type DbTypeJson */
+    DB_TYPE_JSON = 16
 }
 /**
  * Import a value exported from PL/SQL into the current context

declarations/mle-js-bindings/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mle-js-bindings",
-  "version": "21.3.0",
+  "version": "23.2.0",
   "description": "MLE Bindings for Oracle Database DBMS_MLE",
   "types": "mle-js-bindings.d.ts",
   "author": "Oracle",
@@ -11,4 +11,4 @@
     "url": "git://github.com/oracle-samples/mle-modules"
   },
   "bugs": "https://github.com/oracle-samples/mle-modules/issues"
-}
+}

declarations/mle-js-fetch/LICENSE.txt

@@ -0,0 +1,36 @@
+Copyright (c) 2022, 2023, Oracle and/or its affiliates.
+
+The Universal Permissive License (UPL), Version 1.0
+
+Subject to the condition set forth below, permission is hereby granted to any
+person obtaining a copy of this software, associated documentation and/or data
+(collectively the "Software"), free of charge and under any and all copyright
+rights in the Software, and any and all patent rights owned or freely
+licensable by each licensor hereunder covering either (i) the unmodified
+Software as contributed to or provided by such licensor, or (ii) the Larger
+Works (as defined below), to deal in both
+
+(a) the Software, and
+(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
+one is included with the Software (each a "Larger Work" to which the Software
+is contributed by such licensors),
+
+without restriction, including without limitation the rights to copy, create
+derivative works of, display, perform, and distribute the Software and make,
+use, sell, offer for sale, import, export, have made, and have sold the
+Software and the Larger Work(s), and to sublicense the foregoing rights on
+either these or other terms.
+
+This license is subject to the following condition:
+The above copyright notice and either this complete permission notice or at
+a minimum a reference to the UPL must be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

declarations/mle-js-fetch/README.md

@@ -0,0 +1 @@
+Please consult install instructions and documentation on https://oracle-samples.github.io/mle-modules.

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

@@ -0,0 +1,70 @@
+/**
+Copyright (c) 2022, 2023, Oracle and/or its affiliates.
+
+The Universal Permissive License (UPL), Version 1.0
+
+Subject to the condition set forth below, permission is hereby granted to any
+person obtaining a copy of this software, associated documentation and/or data
+(collectively the "Software"), free of charge and under any and all copyright
+rights in the Software, and any and all patent rights owned or freely
+licensable by each licensor hereunder covering either (i) the unmodified
+Software as contributed to or provided by such licensor, or (ii) the Larger
+Works (as defined below), to deal in both
+
+(a) the Software, and
+(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
+one is included with the Software (each a "Larger Work" to which the Software
+is contributed by such licensors),
+
+without restriction, including without limitation the rights to copy, create
+derivative works of, display, perform, and distribute the Software and make,
+use, sell, offer for sale, import, export, have made, and have sold the
+Software and the Larger Work(s), and to sublicense the foregoing rights on
+either these or other terms.
+
+This license is subject to the following condition:
+The above copyright notice and either this complete permission notice or at
+a minimum a reference to the UPL must be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+*/
+export declare class Body {
+    #private;
+    /**
+     * Check if the contents of the body have been consumed.
+     */
+    get bodyUsed(): boolean;
+    /**
+     * Retrieve the contents of the body.
+     */
+    get body(): string | null;
+    constructor(body?: string | Body | null);
+    /**
+     * Consume the contents of the body as JSON.
+     */
+    json(): Promise<any>;
+    /**
+     * Consume the contents of the body as text.
+     */
+    text(): Promise<string>;
+    /**
+     * Unsupported operation.
+     */
+    arrayBuffer(): void;
+    /**
+     * Unsupported operation.
+     */
+    blob(): void;
+    /**
+     * Unsupported operation.
+     */
+    formData(): void;
+    protected _cloneBodyContent(): string | null;
+}

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

@@ -0,0 +1,42 @@
+/**
+Copyright (c) 2022, 2023, Oracle and/or its affiliates.
+
+The Universal Permissive License (UPL), Version 1.0
+
+Subject to the condition set forth below, permission is hereby granted to any
+person obtaining a copy of this software, associated documentation and/or data
+(collectively the "Software"), free of charge and under any and all copyright
+rights in the Software, and any and all patent rights owned or freely
+licensable by each licensor hereunder covering either (i) the unmodified
+Software as contributed to or provided by such licensor, or (ii) the Larger
+Works (as defined below), to deal in both
+
+(a) the Software, and
+(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
+one is included with the Software (each a "Larger Work" to which the Software
+is contributed by such licensors),
+
+without restriction, including without limitation the rights to copy, create
+derivative works of, display, perform, and distribute the Software and make,
+use, sell, offer for sale, import, export, have made, and have sold the
+Software and the Larger Work(s), and to sublicense the foregoing rights on
+either these or other terms.
+
+This license is subject to the following condition:
+The above copyright notice and either this complete permission notice or at
+a minimum a reference to the UPL must be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+*/
+export declare type InitiatorType = 'audio' | 'beacon' | 'body' | 'css' | 'early-hint' | 'embed' | 'fetch' | 'font' | 'frame' | 'iframe' | 'image' | 'img' | 'input' | 'link' | 'object' | 'ping' | 'script' | 'track' | 'video' | 'xmlhttprequest' | 'other';
+export declare type ServiceWorkersMode = 'all' | 'none';
+export declare type Initiator = '' | 'download' | 'imageset' | 'manifest' | 'prefetch' | 'prerender' | 'xslt';
+export declare type Destination = '' | 'audio' | 'audioworklet' | 'document' | 'embed' | 'font' | 'frame' | 'iframe' | 'image' | 'manifest' | 'object' | 'paintworklet' | 'report' | 'script' | 'serviceworker' | 'sharedworker' | 'style' | 'track' | 'video' | 'worker' | 'xslt';
+export declare type ResponseTainting = 'basic' | 'cors' | 'opaque';

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

@@ -0,0 +1,47 @@
+/**
+Copyright (c) 2022, 2023, Oracle and/or its affiliates.
+
+The Universal Permissive License (UPL), Version 1.0
+
+Subject to the condition set forth below, permission is hereby granted to any
+person obtaining a copy of this software, associated documentation and/or data
+(collectively the "Software"), free of charge and under any and all copyright
+rights in the Software, and any and all patent rights owned or freely
+licensable by each licensor hereunder covering either (i) the unmodified
+Software as contributed to or provided by such licensor, or (ii) the Larger
+Works (as defined below), to deal in both
+
+(a) the Software, and
+(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
+one is included with the Software (each a "Larger Work" to which the Software
+is contributed by such licensors),
+
+without restriction, including without limitation the rights to copy, create
+derivative works of, display, perform, and distribute the Software and make,
+use, sell, offer for sale, import, export, have made, and have sold the
+Software and the Larger Work(s), and to sublicense the foregoing rights on
+either these or other terms.
+
+This license is subject to the following condition:
+The above copyright notice and either this complete permission notice or at
+a minimum a reference to the UPL must be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+*/
+import { RequestInit, RequestInfo } from './request';
+import { Response } from './response';
+/**
+ * Make a request to the specified resource.
+ *
+ * @param input a path to the resource or a {@link Request} object that configures the retrieval
+ * @param init additional configuration for the retrieval
+ * @returns a {@link Response} that contains the result of resource retrieval
+ */
+export declare function fetch(input: RequestInfo, init?: RequestInit): Promise<Response>;