feat(aws-ssm): implement AWS SSM provider (#1221)

Signed-off-by: Giovanni De Giorgio <[email protected]>
Signed-off-by: Todd Baert <[email protected]>
Co-authored-by: Todd Baert <[email protected]>

Author: gdegiorgio

.github/component_owners.yml

@@ -3,6 +3,8 @@ components:
   libs/hooks/open-telemetry:
     - beeme1mr
     - toddbaert
+  libs/providers/aws-ssm:
+    - gdegiorgio
   libs/providers/config-cat:
     - lukas-reining
     - adams85

.release-please-manifest.json

@@ -20,5 +20,6 @@
   "libs/providers/config-cat-web": "0.1.5",
   "libs/shared/config-cat-core": "0.1.1",
   "libs/providers/unleash-web": "0.1.1",
-  "libs/providers/growthbook": "0.1.2"
+  "libs/providers/growthbook": "0.1.2",
+  "libs/providers/aws-ssm": "0.1.0"
 }

libs/providers/aws-ssm/.eslintrc.json

@@ -0,0 +1,30 @@
+{
+  "extends": ["../../../.eslintrc.json"],
+  "ignorePatterns": ["!**/*"],
+  "overrides": [
+    {
+      "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.ts", "*.tsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.js", "*.jsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.json"],
+      "parser": "jsonc-eslint-parser",
+      "rules": {
+        "@nx/dependency-checks": [
+          "error",
+          {
+            "ignoredFiles": ["{projectRoot}/eslint.config.{js,cjs,mjs}"]
+          }
+        ]
+      }
+    }
+  ]
+}

libs/providers/aws-ssm/README.md

@@ -0,0 +1,41 @@
+# AWS SSM Provider
+
+## What is AWS SSM?
+AWS Systems Manager (SSM) is a service provided by Amazon Web Services (AWS) that enables users to manage and automate operational tasks across their AWS infrastructure. One of its key components is AWS Systems Manager Parameter Store, which allows users to store, retrieve, and manage configuration data and secrets securely.
+SSM Parameter Store can be used to manage application configuration settings, database connection strings, API keys, and other sensitive information. It provides integration with AWS Identity and Access Management (IAM) to control access and encryption through AWS Key Management Service (KMS).
+The aws-ssm provider for OpenFeature allows applications to fetch feature flag configurations from AWS SSM Parameter Store, enabling centralized and dynamic configuration management.
+
+## Installation
+
+```
+$ npm install @openfeature/aws-ssm-provider
+```
+
+## Set AWS Provider
+
+```
+OpenFeature.setProvider(
+  new AwsSsmProvider({
+    ssmClientConfig: {
+      region: 'eu-west-1', // Change this to your desired AWS region
+      // You can setup your aws credentials here or it will be automatically retrieved from env vars
+      // See https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/setting-credentials-node.html
+    },
+    // Use an LRUCache for improve performance and optimize AWS SDK Calls to SSM (cost awareness)
+    cacheOpts: {
+      enabled: true, // Enable caching
+      size: 1, // Cache size
+      ttl: 10, // Time-to-live in seconds
+    },
+  })
+);
+```
+## Retrieve Feature Flag!
+
+Create a new SSM Param called 'my-feature-flag' in your AWS Account and then retrieve it via OpenFeature Client!
+
+```
+const featureFlags = OpenFeature.getClient();
+const flagValue = await featureFlags.getBooleanValue('my-feature-flag', false);
+console.log(`Feature flag value: ${flagValue}`);
+```

libs/providers/aws-ssm/babel.config.json

@@ -0,0 +1,3 @@
+{
+  "presets": [["minify", { "builtIns": false }]]
+}

libs/providers/aws-ssm/jest.config.ts

@@ -0,0 +1,16 @@
+/* eslint-disable */
+export default {
+  displayName: 'aws-ssm',
+  preset: '../../../jest.preset.js',
+  globals: {
+    'ts-jest': {
+      tsconfig: '<rootDir>/tsconfig.spec.json',
+    },
+  },
+  transform: {
+    '^.+\\.[tj]s$': 'ts-jest',
+  },
+  moduleFileExtensions: ['ts', 'js', 'html'],
+  coverageDirectory: '../../../coverage/libs/providers/aws-ssm',
+  testEnvironment: 'node',
+};