odsl-javascript-sdk 1.0.0 → 1.0.2

package/README.md

@@ -1,2 +1,74 @@
 # odsl-javascript-sdk
-Javascript SDK for OpenDataDSL
+The Javascript SDK for the [OpenDataDSL](https://opendatadsl.com) data management platform
+
+## Installation
+You can install the ODSL Javascript SDK from [npm](https://www.npmjs.com/package/odsl-javascript-sdk):
+
+    npm i odsl-javascript-sdk
+
+## About
+This javascript SDK for OpenDataDSL has the following features:
+
+* Find any data in OpenDataDSL using the ```list``` command
+* Retrieve any data using the ```get``` command
+* Update any data (if you have permission) using the ```update``` command
+
+Check out our [demo repository](https://github.com/OpenDataDSL/odsl-javascript-sdk-demo) for examples of real-world usage.
+
+## Usage
+
+### Logging in and getting started
+
+#### Logging in using a client credentials flow (client secret)
+```js
+import ODSL from '../src/sdk.js'
+import "dotenv/config";
+
+var config = {
+    auth: {
+        clientId: process.env.clientId,
+        authority: process.env.authority,
+        clientSecret: process.env.clientSecret
+    }
+};
+
+ODSL.loginWithSecret(config).then(function(odsl) {
+	# Do Something
+});
+```
+
+### Finding master data
+
+```js
+objects = ODSL.list('object', 'public', {"source":"ECB"})
+print(objects[0])
+```
+
+### Getting master data
+
+```js
+obj = ODSL.get('object', 'public', '#ECB')
+print(obj['description'])
+```
+
+### Getting a timeseries
+```js
+ts = ODSL.get('data', 'public', '#ABN_FX.EURUSD:SPOT')
+print(ts)
+```
+
+### Updating some private master data
+```js
+var body = {
+	"_id":"AAA.JS",
+	"name": "Javascript Update Object"
+}
+ODSL.update('object', 'private', body)
+```
+
+### Reading and updating some private master data
+```js
+po = ODSL.get('object', 'private', 'AAA.TEST')
+po['description'] = 'Updated from Javascript'
+ODSL.update('object', 'private', po)
+```

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "odsl-javascript-sdk",
   "type": "module",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Javascript SDK for OpenDataDSL",
   "main": "src/sdk.js",
   "scripts": {
-    "test": "mocha test/test.js"
+    "test": "mocha test/test.js",
+    "testUpdate": "mocha test/testUpdate.js",
+    "npm:publish": "npm publish"
   },
   "repository": {
     "type": "git",
@@ -24,12 +26,11 @@
   },
   "homepage": "https://github.com/OpenDataDSL/odsl-javascript-sdk#readme",
   "dependencies": {
-    "@azure/msal-browser": "^3.11.1",
     "@azure/msal-node": "^2.6.6",
-    "mocha": "^10.4.0",
     "xmlhttprequest": "^1.8.0"
   },
   "devDependencies": {
+    "mocha": "^10.4.0",
     "dotenv": "^16.4.5"
   }
 }

package/src/sdk.js

@@ -45,23 +45,16 @@ export default class ODSL {
 	get(service, source, id) {
 		try {
 			var xhttp = new XMLHttpRequest();
-			var url = this.host + service + "/v1/" + source + "/" + id;
+			id = encodeURIComponent(id);
+			var url = new URL(this.host + service + "/v1/" + source + "/" + id);
 			xhttp.open("GET", url, false);
 			xhttp.setRequestHeader("Authorization", "Bearer " + this.token);
 			xhttp.responseType = "json";
 			xhttp.send();
-			if (xhttp.status != 200) {
-				return {
-					status: xhttp.status,
-					statusText: xhttp.getResponseHeader("x-odsl-error"),
-					body: undefined
-				};	
+			if (xhttp.status < 200 || xhttp.status >= 300) {
+				throw xhttp.getResponseHeader("x-odsl-error");
 			}
-			return {
-				status: xhttp.status,
-				statusText: xhttp.statusText,
-				body: JSON.parse(xhttp.responseText)
-			};
+			return JSON.parse(xhttp.responseText);
 		} catch (err) {
 			console.log("GET request Failed: " + err);			
 		}
@@ -69,28 +62,56 @@ export default class ODSL {
 	getAsync(service, source, id, callback) {
 		try {
 			var xhttp = new XMLHttpRequest();
-			var url = this.host + service + "/v1/" + source + "/" + id;
+			id = encodeURIComponent(id);
+			var url = new URL(this.host + service + "/v1/" + source + "/" + id);
 			xhttp.open("GET", url);
 			xhttp.setRequestHeader("Authorization", "Bearer " + this.token);
 			xhttp.responseType = "json";
 			xhttp.send();
 			xhttp.onload = function() {
-				if (xhttp.status != 200) {
-					callback({
-						status: xhttp.status,
-						statusText: xhttp.getResponseHeader("x-odsl-error"),
-						body: undefined
-					});	
+				if (xhttp.status < 200 || xhttp.status >= 300) {
+					throw xhttp.getResponseHeader("x-odsl-error");
 				} else {
-					callback({
-						status: xhttp.status,
-						statusText: xhttp.statusText,
-						body: JSON.parse(xhttp.responseText)
-					});
+					callback(JSON.parse(xhttp.responseText));
 				}
 			}
 		} catch (err) {
 			console.log("GET request Failed: " + err);			
 		}
 	}
+	list(service, source, filter) {
+		try {
+			var xhttp = new XMLHttpRequest();
+			var url = new URL(this.host + service + "/v1/" + source);
+			if (filter != undefined) {
+				url.searchParams.set("_filter", JSON.stringify(filter));
+			}
+			xhttp.open("GET", url, false);
+			xhttp.setRequestHeader("Authorization", "Bearer " + this.token);
+			xhttp.responseType = "json";
+			xhttp.send();
+			if (xhttp.status < 200 || xhttp.status >= 300) {
+				throw xhttp.getResponseHeader("x-odsl-error");
+			}
+			return JSON.parse(xhttp.responseText);
+		} catch (err) {
+			console.log("GET request Failed: " + err);			
+		}
+	}
+	update(service, source, body) {
+		try {
+			var xhttp = new XMLHttpRequest();
+			var url = new URL(this.host + service + "/v1/" + source);
+			xhttp.open("POST", url, false);
+			xhttp.setRequestHeader("Authorization", "Bearer " + this.token);
+			xhttp.responseType = "json";
+			xhttp.send(JSON.stringify(body));
+			if (xhttp.status < 200 || xhttp.status >= 300) {
+				throw xhttp.getResponseHeader("x-odsl-error");
+			}
+			return JSON.parse(xhttp.responseText);
+		} catch (err) {
+			console.log("GET request Failed: " + err);			
+		}
+	}
 }

package/.vscode/launch.json

@@ -1,15 +0,0 @@
-{
-	// Use IntelliSense to learn about possible attributes.
-	// Hover to view descriptions of existing attributes.
-	// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-	"version": "0.2.0",
-	"configurations": [
-		{
-			"type": "chrome",
-			"request": "launch",
-			"name": "Launch Chrome against localhost",
-			"url": "http://localhost:8080",
-			"webRoot": "${workspaceFolder}/test/web"
-		}
-	]
-}

package/test/test.js

@@ -1,33 +0,0 @@
-'use strict';
-
-import ODSL from '../src/sdk.js'
-import "dotenv/config";
-
-var config = {
-    auth: {
-        clientId: process.env.clientId,
-        authority: process.env.authority,
-        clientSecret: process.env.clientSecret
-    }
-};
-
-console.log("Asynchronous GET");
-ODSL.loginWithSecret(config).then(function(odsl) {
-	odsl.getAsync('object', 'private', 'AAA', function(r) {
-        if (r.status == 200) {
-            console.log(r.body);
-        } else {
-            console.log(r.status + ": " + r.statusText);
-        }
-    });
-});
-
-console.log("Synchronous GET");
-ODSL.loginWithSecret(config).then(function(odsl) {
-    var r = odsl.get('object', 'private', 'AAA');
-    if (r.status == 200) {
-        console.log(r.body);
-    } else {
-        console.log(r.status + ": " + r.statusText);
-    }
-});