Merge branch 'main' into fix/issue1212

Author: lukas-reining

.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

.github/workflows/ci.yml

@@ -31,9 +31,9 @@ jobs:
       - run: git branch --track main origin/main || true
 
       - run: if ! npx nx format:check ; then echo "Format check failed. Please run 'npx nx format:write'."; fi
-      - run: npx nx affected --target=lint --parallel=3
-      - run: npx nx affected --target=test --parallel=3 --ci --code-coverage
-      - run: npx nx affected --target=build --parallel=3
+      - run: npx nx affected --target=lint --parallel=3 --exclude=js-sdk-contrib
+      - run: npx nx affected --target=test --parallel=3 --ci --code-coverage --exclude=js-sdk-contrib
+      - run: npx nx affected --target=build --parallel=3 --exclude=js-sdk-contrib
 
   e2e:
       runs-on: ubuntu-latest

.gitignore

@@ -46,3 +46,7 @@ proto
 # yalc stuff
 .yalc
 yalc.lock
+
+
+# Generated by @nx/js
+.verdaccio

.release-please-manifest.json

@@ -2,7 +2,7 @@
   "libs/hooks/open-telemetry": "0.4.0",
   "libs/providers/go-feature-flag": "0.7.6",
   "libs/providers/flagd": "0.13.3",
-  "libs/providers/flagd-web": "0.7.2",
+  "libs/providers/flagd-web": "0.7.3",
   "libs/providers/env-var": "0.3.1",
   "libs/providers/config-cat": "0.7.4",
   "libs/providers/launchdarkly-client": "0.3.2",
@@ -12,13 +12,14 @@
   "libs/providers/ofrep": "0.2.1",
   "libs/providers/ofrep-web": "0.3.2",
   "libs/providers/flipt": "0.1.2",
-  "libs/providers/flagsmith-client": "0.1.2",
+  "libs/providers/flagsmith-client": "0.1.3",
   "libs/providers/flipt-web": "0.1.2",
   "libs/providers/multi-provider": "0.1.2",
   "libs/providers/multi-provider-web": "0.0.3",
   "libs/providers/growthbook-client": "0.1.2",
   "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.2"
 }

assets/aws-ssm/create-param.png

@@ -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}"]
+          }
+        ]
+      }
+    }
+  ]
+}

assets/aws-ssm/search.png

@@ -0,0 +1,15 @@
+# Changelog
+
+## [0.1.2](https://github.com/open-feature/js-sdk-contrib/compare/aws-ssm-provider-v0.1.1...aws-ssm-provider-v0.1.2) (2025-03-27)
+
+
+### ✨ New Features
+
+* **aws-ssm:** add decryption support for `SecureString` parameters ([#1241](https://github.com/open-feature/js-sdk-contrib/issues/1241)) ([043be44](https://github.com/open-feature/js-sdk-contrib/commit/043be44de1442b89876e9857478afe619fcf0b04))
+
+## [0.1.1](https://github.com/open-feature/js-sdk-contrib/compare/aws-ssm-provider-v0.1.0...aws-ssm-provider-v0.1.1) (2025-03-20)
+
+
+### ✨ New Features
+
+* **aws-ssm:** implement AWS SSM provider ([#1221](https://github.com/open-feature/js-sdk-contrib/issues/1221)) ([819a247](https://github.com/open-feature/js-sdk-contrib/commit/819a247c41112c2873aa025ac0abd3c62eb53aca))

assets/aws-ssm/ssm-menu.png

@@ -0,0 +1,73 @@
+# 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
+    },
+  })
+);
+```
+
+# AWS SSM Provider Configuration
+
+## AwsSsmProviderConfig
+
+| Property         | Type               | Description                                  | Default |
+|-----------------|--------------------|----------------------------------------------|---------|
+| `ssmClientConfig` | `SSMClientConfig` | AWS SSM Client configuration options.       | See [here](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ssm/)    |
+| `enableDecryption`      | `boolean`   | Enable decryption for SecureString parameters      | false |
+| `cacheOpts`      | `LRUCacheConfig`   | Configuration for the local LRU cache.      | See below |
+
+## LRUCacheConfig
+
+| Property  | Type    | Description                                    | Default |
+|-----------|--------|------------------------------------------------|---------|
+| `enabled` | `boolean` | Whether caching is enabled.                 | `false`  |
+| `ttl`     | `number`  | Time-to-live (TTL) for cached items (in ms). | `300000` (5 minutes) |
+| `size`    | `number`  | Maximum number of items in the cache.       | `1000`  |
+
+
+
+
+## Retrieve Feature Flag!
+
+Open your AWS Management Console and go to AWS System Manager service  
+
+![SSM-Menu](../../../assets/aws-ssm/search.png)  
+
+Go to Parameter Store  
+
+![Parameter-Store](../../../assets/aws-ssm/ssm-menu.png)  
+
+Create a new SSM Param called 'my-feature-flag' in your AWS Account and then retrieve it via OpenFeature Client!  
+
+![Create-Param](../../../assets/aws-ssm/create-param.png)  
+
+```
+const featureFlags = OpenFeature.getClient();
+const flagValue = await featureFlags.getBooleanValue('my-feature-flag', false);
+console.log(`Feature flag value: ${flagValue}`);
+```