add akri vscode extension samples (#164)

## Purpose
<!-- Describe the intention of the changes being proposed. What problem
does it solve or functionality does it add? -->
* ... This PR adds the akri samples needed to test the akri connectors
vscode extension.

## Does this introduce a breaking change?
<!-- Mark one with an "x". -->
```
[ ] Yes
[x] No
```

## Pull Request Type
What kind of change does this Pull Request introduce?
<!-- Please check the one that applies to this PR using "x". -->
```
[ ] Bugfix
[ ] Feature
[ ] Code style update (formatting, local variables)
[ ] Refactoring (no functional changes, no api changes)
[x] Documentation content changes
[ ] Other... Please describe:
```

## How to Test
*  Get the code

```
git clone [repo-address]
cd [repo-name]
git checkout [branch-name]
npm install
```

* Test the code
<!-- Add steps to run the tests suite and/or manually test -->
```
```

## What to Check
Verify that the following are valid
* ...

## Other Information
<!-- Add any other helpful information that may be needed here. -->

Author: machavarapun

samples/akri-vscode-extension/rest-server-custom-resources/rest-server-asset1-definition.yaml

@@ -0,0 +1,33 @@
+apiVersion: namespaces.deviceregistry.microsoft.com/v1
+kind: Asset
+metadata:
+  name: my-rest-thermostat-asset1
+  namespace: azure-iot-operations
+spec:
+  attributes:
+    assetId: my-rest-thermostat-asset1
+    assetType: rest-thermostat-asset
+  datasets:
+    - name: thermostat_status
+      dataPoints:
+        - dataSource: /api/thermostat/current
+          name: currentTemperature
+          dataPointConfiguration: |-
+           {
+              "HttpRequestMethod": "GET",
+           }
+        - dataSource: /api/thermostat/desired
+          name: desiredTemperature
+          dataPointConfiguration: |-
+           {
+              "HttpRequestMethod": "GET",
+           }
+      dataSource: /thermostat
+      destinations:
+        - configuration:
+            topic: mqtt/machine/asset1/status
+          target: Mqtt
+  deviceRef:
+    deviceName: my-rest-thermostat-device-name
+    endpointName: my-rest-thermostat-endpoint-name
+  version: 1

samples/akri-vscode-extension/rest-server-custom-resources/rest-server-asset2-definition.yaml

@@ -0,0 +1,33 @@
+apiVersion: namespaces.deviceregistry.microsoft.com/v1
+kind: Asset
+metadata:
+  name: my-rest-thermostat-asset2
+  namespace: azure-iot-operations
+spec:
+  attributes:
+    assetId: my-rest-thermostat-asset2
+    assetType: rest-thermostat-asset
+  datasets:
+    - name: thermostat_status
+      dataPoints:
+        - dataSource: /api/thermostat/current
+          name: currentTemperature
+          dataPointConfiguration: |-
+           {
+              "HttpRequestMethod": "GET",
+           }
+        - dataSource: /api/thermostat/desired
+          name: desiredTemperature
+          dataPointConfiguration: |-
+           {
+              "HttpRequestMethod": "GET",
+           }
+      dataSource: /thermostat
+      destinations:
+        - configuration:
+            key: RestThermostatKey
+          target: BrokerStateStore
+  deviceRef:
+    deviceName: my-rest-thermostat-device-name
+    endpointName: my-rest-thermostat-endpoint-name
+  version: 1

samples/akri-vscode-extension/rest-server-custom-resources/rest-server-device-definition.yaml

@@ -0,0 +1,20 @@
+apiVersion: namespaces.deviceregistry.microsoft.com/v1
+kind: Device
+metadata:
+  name: my-rest-thermostat-device-name
+  namespace: azure-iot-operations
+spec:
+  attributes:
+    deviceId: my-thermostat
+    deviceType: thermostat-device-type
+  enabled: true
+  endpoints:
+    inbound:
+      my-rest-thermostat-endpoint-name:
+        additionalConfiguration: '{}'
+        address: http://restserver:3000
+        authentication:
+          method: Anonymous
+        endpointType: rest-thermostat-endpoint-type
+  uuid: 1234-5678-9012-3456
+  version: 2

samples/akri-vscode-extension/sample-rest-server/Dockerfile

@@ -0,0 +1,10 @@
+# Dockerfile
+FROM node:18
+
+WORKDIR /usr/src/app
+COPY package*.json ./
+RUN npm install
+COPY . .
+
+EXPOSE 3000
+CMD ["node", "server.js"]

samples/akri-vscode-extension/sample-rest-server/README.md

@@ -0,0 +1,10 @@
+# Sample Rest Server
+
+Run the following commands to build a sample rest server docker image:
+
+```bash
+    cd preview/akri-connectors-extension/SampleRestServer 
+    docker build -t rest-server:latest .
+```
+
+**NOTE:**: This rest server is unauthenticated and it should be accessible at port 3000 during container run.

samples/akri-vscode-extension/sample-rest-server/package.json

@@ -0,0 +1,18 @@
+{
+    "name": "rest-server",
+    "version": "1.0.0",
+    "description": "Test REST Service",
+    "main": "server.js",
+    "scripts": {
+        "test": "echo \"Error: no test specified\" && exit 1",
+        "start": "node server.js"
+    },
+    "author": "",
+    "license": "ISC",
+    "dependencies": {
+        "auth": "^1.1.1",
+        "basic": "^2.0.3",
+        "basic-auth": "^2.0.1",
+        "express": "^4.19.2"
+    }
+}

samples/akri-vscode-extension/sample-rest-server/server.js

@@ -0,0 +1,60 @@
+// server.js
+const express = require("express");
+const app = express();
+
+const port = process.env.PORT || 3000;
+
+// Function to generate random temperature values in Fahrenheit
+function getRandomTemperature(min, max) {
+    return (Math.random() * (max - min) + min).toFixed(2);
+}
+
+let desiredTemperature = getRandomTemperature(68, 77); // Approx 20-25�C in Fahrenheit
+let currentTemperature = getRandomTemperature(68, 77);
+let thermostatPower = "on";
+
+// Get Current Temperature
+app.get("/api/thermostat/current", (req, res) => {
+    currentTemperature = getRandomTemperature(68, 77);
+    res.json({ currentTemperature: parseFloat(currentTemperature) });
+});
+
+// Get Desired Temperature
+app.get("/api/thermostat/desired", (req, res) => {
+    res.json({ desiredTemperature: parseFloat(desiredTemperature) });
+});
+
+// Set Desired Temperature
+app.post("/api/thermostat/desired", express.json(), (req, res) => {
+    if (req.body.desiredTemperature) {
+        desiredTemperature = req.body.desiredTemperature;
+        res.json({ message: "Desired temperature set successfully" });
+    } else {
+        res.status(400).json({ message: "Desired temperature is required" });
+    }
+});
+
+// Get Thermostat Status
+app.get("/api/thermostat/status", (req, res) => {
+    currentTemperature = getRandomTemperature(68, 77);
+    let status = desiredTemperature > currentTemperature ? "heating" : "cooling";
+    res.json({
+        status: status,
+        currentTemperature: parseFloat(currentTemperature),
+        desiredTemperature: parseFloat(desiredTemperature),
+    });
+});
+
+// Toggle Thermostat Power
+app.post("/api/thermostat/power", express.json(), (req, res) => {
+    if (req.body.power === "on" || req.body.power === "off") {
+        thermostatPower = req.body.power;
+        res.json({ message: `Thermostat power turned ${thermostatPower}` });
+    } else {
+        res.status(400).json({ message: "Power state must be 'on' or 'off'" });
+    }
+});
+
+app.listen(port, () => {
+    console.log(`Thermostat API server running on port ${port}`);
+});