[NodeJS Templating] Expose adaptivecards-templating version

source/nodejs/adaptivecards-templating/src/template-engine.ts

@@ -1,19 +1,23 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 import * as AEL from "adaptive-expressions";
+const pkg = require('./../package.json');
 
 class EvaluationContext {
-    private static readonly _reservedFields = ["$data", "$when", "$root", "$index", "$host"];
+    private static readonly _reservedFields = ["$data", "$when", "$root", "$index", "$host", "$_acTemplateVersion"];
 
     private _stateStack: Array<{ $data: any, $index: any }> = [];
     private _$data: any;
 
     $root: any;
     $host: any;
     $index: number;
+    $_acTemplateVersion: any;
 
     constructor(context?: IEvaluationContext) {
         if (context !== undefined) {
+            this.$_acTemplateVersion = this.generateVersionJson();
+
             this.$root = context.$root;
             this.$host = context.$host;
         }
@@ -49,6 +53,23 @@ class EvaluationContext {
     set $data(value: any) {
         this._$data = value;
     }
+
+    generateVersionJson() {
+        const version = pkg.version;
+        const versionSplit = version.split('.');
+
+        let patchSplit = [];
+        if (versionSplit[2]) {
+            patchSplit = versionSplit[2].split('-');
+        }
+
+        return {
+            "major": parseInt(versionSplit[0]),
+            "minor": parseInt(versionSplit[1]),
+            "patch": parseInt(patchSplit[0]),
+            "suffix": patchSplit[1] || "",
+        }
+    }
 }
 
 class TemplateObjectMemory implements AEL.MemoryInterface {
@@ -58,6 +79,7 @@ class TemplateObjectMemory implements AEL.MemoryInterface {
     $data: any;
     $index: any;
     $host: any;
+    $_acTemplateVersion: any;
 
     constructor() {
         this._memory = new AEL.SimpleObjectMemory(this);
@@ -166,6 +188,7 @@ export class Template {
         memory.$data = context.$data;
         memory.$index = context.$index;
         memory.$host = context.$host;
+        memory.$_acTemplateVersion = context.$_acTemplateVersion;
 
         let options: AEL.Options | undefined = undefined;
 

source/nodejs/tests/unit-tests/src/unit-tests.test.ts

@@ -147,6 +147,11 @@ describe("Test Templating Library", () => {
             loadFile("template-test-resources/complex-template-host.data.json"),
             loadFile("template-test-resources/complex-template-host.host.json"));
     });
+
+    it("TemplatingVersion", () => {
+        runTest(loadFile("template-test-resources/version-template.json"),
+            loadFile("template-test-resources/version-template.output.json"));           
+    });    
 });
 
 function runTest(templatePayload: any, expectedOutput: any, data?: any, host?: any) {

source/nodejs/tests/unit-tests/template-test-resources/version-template.json

@@ -0,0 +1,21 @@
+{
+    "type": "AdaptiveCard",
+    "version": "1.0",
+    "body": [
+        {
+            "$when": "${$_acTemplateVersion.major >= 2}",
+            "type": "TextBlock",
+            "text": "$_acTemplateVersion.major >= 2"
+        },
+        {
+            "$when": "${$_acTemplateVersion.minor >= 0}",
+            "type": "TextBlock",
+            "text": "$_acTemplateVersion.minor >= 0"
+        },
+        {
+            "$when": "${$_acTemplateVersion.patch >= 0}",
+            "type": "TextBlock",
+            "text": "$_acTemplateVersion.patch >= 0"
+        }
+    ]
+}

source/nodejs/tests/unit-tests/template-test-resources/version-template.output.json

@@ -0,0 +1,18 @@
+{
+    "type": "AdaptiveCard",
+    "version": "1.0",
+    "body": [
+        {
+            "type": "TextBlock",
+            "text": "$_acTemplateVersion.major >= 2"
+        },
+        {
+            "type": "TextBlock",
+            "text": "$_acTemplateVersion.minor >= 0"
+        },
+        {
+            "type": "TextBlock",
+            "text": "$_acTemplateVersion.patch >= 0"
+        }
+    ]
+}