Implement hello app. (#1)

Author: kinyoklion

.circleci/config.yml

@@ -0,0 +1,38 @@
+version: 2.1
+
+workflows:
+  test:
+    jobs:
+    - do-test:
+        context: hello-world-demos
+
+  test-daily:
+    triggers:
+    - schedule:
+        cron: "0 6 * * *"
+        filters:
+          branches:
+            only: main
+    jobs:
+    - do-test:
+        context: hello-world-demos
+
+jobs:
+  do-test:
+    docker:
+      - image: cimg/node:14.19
+    environment:
+      SOURCE_FILE_NAME: index.js
+    steps:
+      - checkout
+      - run:
+          name: insert SDK key and flag key into demo code
+          command: |
+            sed -i.bak "s/sdkKey *= *''/sdkKey = '${LD_HELLO_WORLD_SDK_KEY}'/" ${SOURCE_FILE_NAME}
+            sed -i.bak "s/featureFlagKey *= *'.*'/featureFlagKey = '${LD_HELLO_WORLD_FLAG_KEY_WITH_TRUE_VALUE}'/" ${SOURCE_FILE_NAME}
+      - run:
+          name: run demo
+          command: |
+            npm i
+            npm start | tee output.txt
+            grep "is true for this user" output.txt || (echo "Flag did not evaluate to expected true value" && exit 1)

.gitignore

@@ -0,0 +1,3 @@
+package-lock.json
+node_modules/
+index.js.bak

LICENSE.txt

@@ -0,0 +1,13 @@
+Copyright 2022 Catamorphic, Co.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

README.md

@@ -0,0 +1,25 @@
+# LaunchDarkly sample OpenFeature Server-Side Node.js application
+
+We've built a simple console that demonstrates how LaunchDarkly's OpenFeature provider works.
+
+The LaunchDarkly OpenFeature provider for the Server-Side SDK for Node.js is designed primarily for use in multi-user systems such as web servers and applications. It follows the server-side LaunchDarkly model for multi-user contexts. It is not intended for use in desktop, browser, and embedded systems applications.
+
+## Supported Node versions
+
+This sample is compatible with Node.js versions 14 and above.
+
+## Build instructions
+
+1. Install dependencies using `npm install`.
+
+2. Edit `index.js` and set the value of `sdkKey` to your LaunchDarkly SDK key. If there is an existing boolean feature flag in your LaunchDarkly project that you want to evaluate, set `featureFlagKey` to the flag key.
+
+```
+const sdkKey = '1234567890abcdef';
+
+const featureFlagKey = 'my-flag';
+```
+
+3. On the command line, run `npm start`
+
+You should receive the message ”Feature flag ‘<flag key>’ is <true/false> for this user”.

index.js

@@ -0,0 +1,34 @@
+import { OpenFeature } from '@openfeature/js-sdk';
+import { init } from 'launchdarkly-node-server-sdk';
+import { LaunchDarklyProvider } from '@launchdarkly/openfeature-node-server';
+
+// Set sdkKey to your LaunchDarkly SDK key.
+const sdkKey = '';
+
+// Set featureFlagKey to the feature flag key you want to evaluate
+const featureFlagKey = 'my-boolean-flag';
+
+// Set up the user properties. This user should appear on your LaunchDarkly users dashboard
+// soon after you run the demo.
+// Remember when using OpenFeature to use `targetingKey` instead of `key`.
+const context = {
+  targetingKey: 'example-user-key'
+};
+
+const ldClient = init(sdkKey);
+await ldClient.waitForInitialization();
+
+OpenFeature.setProvider(new LaunchDarklyProvider(ldClient));
+const client = OpenFeature.getClient();
+
+const flagValue = await client.getBooleanValue(featureFlagKey, false, context);
+
+console.log(`Feature flag '${featureFlagKey}' is ${flagValue} for this user`);
+
+// Here we ensure that the SDK shuts down cleanly and has a chance to deliver analytics
+// events to LaunchDarkly before the program exits. If analytics events are not delivered,
+// the user properties and flag usage statistics will not appear on your dashboard. In a
+// normal long-running application, the SDK would continue running and events would be
+// delivered automatically in the background.
+await ldClient.flush();
+ldClient.close();

package.json

@@ -0,0 +1,26 @@
+{
+  "name": "hello-openfeature-node-server",
+  "version": "1.0.0",
+  "description": "Minimal Example using LaunchDarkly with OpenFeature",
+  "main": "index.js",
+  "keywords": [
+    "launchdarkly",
+    "launch",
+    "darkly",
+    "node",
+    "sdk",
+    "openfeature",
+    "provider"
+  ],
+  "scripts": {
+    "start": "node index.js"
+  },
+  "type": "module",
+  "author": "LaunchDarkly <team@launchdarkly.com>",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@launchdarkly/openfeature-node-server": ">= 0.1.6",
+    "@openfeature/js-sdk": "^1.x",
+    "launchdarkly-node-server-sdk": ">= 6.4.3"
+  }
+}