chore: @value snippets

README.md

@@ -63,6 +63,8 @@ The snippets are generally broken up into functional areas, with each folder cov
   - [executable](executable) - How GraphQL _executable documents_ can be registered and used with a schema or endpoint.
 - @supplies
   - [routing](routing)
+- @value
+  - [value](value)
 
 ### General topics
 

value/README.md

@@ -0,0 +1,12 @@
+# @value
+
+The `@value` directive defines a value that can be applied in various contexts, each with specific behaviors.
+  - When applied to a field, selecting the field will return the specified value.
+
+If no arguments are provided (`@value`) then the value is `null`.
+
+View the [documentation](https://www.ibm.com/docs/en/api-connect/ace/saas?topic=directives-directive-value) on the custom directive `@value`.
+
+## Snippets
+
+- [arguments](arguments) shows how sets the element to a constant value

value/arguments/api.graphql

@@ -0,0 +1,43 @@
+# A `@value` directive defines a value that can be applied in various contexts
+# To establish a constant value within a type or query, we can utilize this directive.
+# If no arguments are provided (@value) then the value is null.
+
+type Customer {
+  name: String!
+  city: String!
+}
+
+# To establish a constant value for the state, utilize `@value` and provide the constant value.
+extend type Customer{
+  state:String @value(const:"Florida")
+}
+
+
+type Query {
+   emptyCustomer(id: ID): Customer @value # return null value
+   customer(id: ID): Customer # set the default value
+   @value(
+      script: {
+        src: """
+        Object({name:'John Doe',city:'Miami'})
+        """
+        language: ECMASCRIPT
+      }
+    )
+    # To pass a constant value directly in a query and return the result
+    pi:Float! @value(const:3.14159)
+
+  # To sum a and b using the @value directive within src in jsonata,
+  sum(a: Int!, b: Int!): Int! @value(script: {src: "a+b", language: JSONATA})
+
+    # To concatenate strings using @value in jsonata
+  concat(a: String, b: String): String
+    @value(
+      script: {
+        src: """
+        $join([a,b], "-")
+        """
+        language: JSONATA
+      }
+    )
+}

value/arguments/index.graphql

@@ -0,0 +1,3 @@
+schema @sdl(files: ["api.graphql"]) {
+  query: Query
+}

value/arguments/stepzen.config.json

@@ -0,0 +1,3 @@
+{
+ "endpoint": "api/miscellaneous"
+}

value/arguments/tests/Test.js

@@ -0,0 +1,38 @@
+const {
+    deployAndRun,
+    stepzen,
+    getTestDescription,
+  } = require("../../../tests/gqltest.js");
+
+  testDescription = getTestDescription("snippets", __dirname);
+
+  describe(testDescription, function () {
+    const tests = [
+      { label: "emptyCustomer with return null",
+        query: '{emptyCustomer(id:1){name city }}',
+        expected: {emptyCustomer: null},
+      },
+      { label: "customer(1)",
+        query: '{customer(id:1){name city }}',
+        expected: {customer: {name:'John Doe',city:'Miami'}},
+      },
+      { label: "customer(2) with pass default state value",
+        query: '{customer(id:2){name city state }}',
+        expected: {customer: {name:'John Doe',city:'Miami',state:"Florida"}},
+      },
+      { label: "return pi const value 3.14159",
+        query: '{pi}',
+        expected: {pi:3.14159},
+      },
+      { label: "return sum of two input using @value with script-json",
+        query: '{sum(a: 10, b: 10)}',
+        expected: {sum: 20},
+      },
+      { label: "concat string",
+        query: '{concat(a: "Steve",b:"Jobs" )}',
+        expected: {concat: 'Steve-Jobs'},
+      },
+    ]
+    return deployAndRun(__dirname, tests, stepzen.admin);
+  });
+