Merge pull request #379 from sasjs/js-services

chore: add instructions for bundling js services

Author: allanbowe

README.md

@@ -1,11 +1,13 @@
 # Overview
+
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
+
 [![All Contributors](https://img.shields.io/badge/all_contributors-7-orange.svg?style=flat-square)](#contributors-)
+
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 This React seed app provides a wrapper for `@sasjs/adapter`, a lightning fast adapter for talking to SAS - on Viya, EBI, or SASjs Server.
 
-
 ## Frontend Web
 
 If you are running on SAS 9 you need to set `serverType` to SAS9 in `sasContext.tsx`.
@@ -18,14 +20,14 @@ If you are running locally you will also need to whitelist `localhost` on the se
 
 ## Backend Services
 
-The best way to deploy SAS services is using the [SASjs CLI](https://cli.sasjs.io).  Simply [install](https://cli.sasjs.io/installation/), update the `defaultTarget` attribute in the [sasjsconfig.json](https://github.com/sasjs/react-seed-app/blob/main/sasjs/sasjsconfig.json) file, and run the following commands:
+The best way to deploy SAS services is using the [SASjs CLI](https://cli.sasjs.io). Simply [install](https://cli.sasjs.io/installation/), update the `defaultTarget` attribute in the [sasjsconfig.json](https://github.com/sasjs/react-seed-app/blob/main/sasjs/sasjsconfig.json) file, and run the following commands:
 
 ```bash
-sasjs auth 
+sasjs auth
 sasjs cbd
 ```
 
-This will first authenticate to your target (follow the prompts) and after that you can just run `sasjs cbd` to rebuild and deploy your services.  If you set `streamweb:true` in the sasjsconfig.json it will also deploy your frontend as a streaming app (no need for a web server).
+This will first authenticate to your target (follow the prompts) and after that you can just run `sasjs cbd` to rebuild and deploy your services. If you set `streamweb:true` in the sasjsconfig.json it will also deploy your frontend as a streaming app (no need for a web server).
 
 If you are just looking to build quickly and don't have time to install NPM then you can also create the web services on ANY version of SAS by running the code below.
 
@@ -60,6 +62,15 @@ This app will work on all versions of SAS Viya, in SAS 9 EBI from 9.3 and above,
 
 It will not work on SAS University edition.
 
+## Backend Services in JavaScript
+
+If you are writing services in JS and your service depends on any third party library/package then you need to bundle that service before deploying it to sasjs server otherwise the service wouldn't work. You can choose any bundler for this process. One possible option could be `webpack`. And if you choose webpack then you can use it like:<br/>
+`npx webpack --mode none --target node --entry <path-of-file-to-bundle/build> --output-path <path-of-output-folder> --output-filename <name-of-output-file>`
+<br/>
+
+In our case we have a mock service at path `sasjs/mocks/appinit.js` and we want to build and make it ready for deployment. So, we have to run following in terminal:<br/>
+`npx webpack --mode none --target node --entry ./sasjs/mocks/appinit.js --output-path sasjsbuild/mocks --output-filename appinit.js`
+
 ### Code Style
 
 This project uses Prettier to format code.

package-lock.json

@@ -27,7 +27,7 @@
     "@material-ui/lab": "^4.0.0-alpha.60",
     "@mui/icons-material": "^5.8.2",
     "@mui/material": "^5.2.6",
-    "@sasjs/adapter": "3.10.14",
+    "@sasjs/adapter": "3.10.16",
     "@sasjs/core": "4.34.2",
     "@sasjs/utils": "^2.47.0",
     "axios": "^0.27.2",
@@ -54,6 +54,7 @@
     "babel-loader": "^8.2.3",
     "copy-webpack-plugin": "^10.2.4",
     "css-loader": "^6.7.1",
+    "date-and-time": "2.4.1",
     "dotenv": "^16.0.1",
     "file-loader": "^6.2.0",
     "html-webpack-plugin": "5.5.0",

package.json

@@ -0,0 +1,24 @@
+const date = require('date-and-time')
+
+const now = new Date()
+
+_webout = {
+  SYSDATE: date.format(now, 'DDMMMYY'),
+  SYSTIME: date.format(now, 'HH:mm'),
+  areas: [
+    { AREA: 'Adak' },
+    { AREA: 'Adel' },
+    { AREA: 'Afognak' },
+    { AREA: 'Ajo' },
+    { AREA: 'Albany' },
+    { AREA: 'Albuquerque' },
+    { AREA: 'Alturas' },
+    { AREA: 'Ashton' },
+    { AREA: 'Atka' },
+    { AREA: 'Atlanta' },
+    { AREA: 'Attu' },
+    { AREA: 'Aztec' }
+  ]
+}
+
+_webout = JSON.stringify(_webout)