Merge pull request #9 from cloudnode-pro/patch/browser

Include credentials in `fetch()` if operation requires token

README.md

@@ -33,7 +33,15 @@ const newsletter = await cloudnode.newsletter.get("newsletter_123asd");
 ```
 
 #### Browser
-Coming soon!
+Download the browser SDK from `browser/Cloudnode.js` or use our hosted version.
+```html
+<script src="https://cloudnode.pro/assets/js/sdk.min.js"></script>
+const cloudnode = new Cloudnode();
+
+// get a newsletter
+const newsletter = await cloudnode.newsletter.get("newsletter_123asd");
+```
+> **Warning**: You most likely don't want to set your private token in a public front-end website, as this will allow anyone who sees your front-end JavaScript code to use it for possibly malicious purposes. We advise you use a back-end server to proxy requests to our API, so you do not expose your token to the public.
 
 ### TypeScript
 ```ts

README.template.md

@@ -33,7 +33,15 @@ const newsletter = await {{config.instanceName}}.newsletter.get("newsletter_123a
 ```
 
 #### Browser
-Coming soon!
+Download the browser SDK from `browser/{{config.name}}.js` or use our hosted version.
+```html
+<script src="{{{config.browserSdkUrl}}}"></script>
+const {{config.instanceName}} = new {{config.name}}();
+
+// get a newsletter
+const newsletter = await {{config.instanceName}}.newsletter.get("newsletter_123asd");
+```
+> **Warning**: You most likely don't want to set your private token in a public front-end website, as this will allow anyone who sees your front-end JavaScript code to use it for possibly malicious purposes. We advise you use a back-end server to proxy requests to our API, so you do not expose your token to the public.
 
 ### TypeScript
 ```ts

browser/Cloudnode.js

@@ -47,8 +47,10 @@ class Cloudnode {
             options.body = JSON.stringify(body);
             options.headers["Content-Type"] = "application/json";
         }
-        if (this.#token)
+        if (this.#token && operation.token !== undefined)
             options.headers["Authorization"] = `Bearer ${this.#token}`;
+        if (operation.token !== undefined)
+            options.credentials = "include";
         const response = await fetch(url.toString(), options);
         if (response.status === 204)
             return undefined;

gen/Config.ts

@@ -18,4 +18,9 @@ export interface Config {
      * Version of the API this client was generated for
      */
     apiVersion: string;
+
+    /**
+     * Link to hosted browser SDK
+     */
+    browserSdkUrl: string;
 }

gen/config.json

@@ -2,5 +2,6 @@
   "name": "Cloudnode",
   "instanceName": "cloudnode",
   "baseUrl": "https://api.cloudnode.pro/v5/",
-  "apiVersion": "5.6.2"
+  "apiVersion": "5.6.2",
+  "browserSdkUrl": "https://cloudnode.pro/assets/js/sdk.min.js"
 }

gen/templates/main.mustache

@@ -52,8 +52,10 @@ class {{config.name}} {
             options.body = JSON.stringify(body);
             options.headers["Content-Type"] = "application/json";
         }
-        if (this.#token)
+        if (this.#token && operation.token !== undefined)
             options.headers["Authorization"] = `Bearer ${this.#token}`;
+        if (operation.token !== undefined)
+            options.credentials = "include";
         const response = await fetch(url.toString(), options);
         if (response.status === 204) return undefined as any;
         if (response.headers.get("Content-Type")?.startsWith("application/json")) {

src/Cloudnode.js

@@ -47,8 +47,10 @@ class Cloudnode {
             options.body = JSON.stringify(body);
             options.headers["Content-Type"] = "application/json";
         }
-        if (this.#token)
+        if (this.#token && operation.token !== undefined)
             options.headers["Authorization"] = `Bearer ${this.#token}`;
+        if (operation.token !== undefined)
+            options.credentials = "include";
         const response = await fetch(url.toString(), options);
         if (response.status === 204)
             return undefined;

src/Cloudnode.ts

@@ -52,8 +52,10 @@ class Cloudnode {
             options.body = JSON.stringify(body);
             options.headers["Content-Type"] = "application/json";
         }
-        if (this.#token)
+        if (this.#token && operation.token !== undefined)
             options.headers["Authorization"] = `Bearer ${this.#token}`;
+        if (operation.token !== undefined)
+            options.credentials = "include";
         const response = await fetch(url.toString(), options);
         if (response.status === 204) return undefined as any;
         if (response.headers.get("Content-Type")?.startsWith("application/json")) {