@middy/ssm 2.5.0 → 2.5.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +5 -5
  2. package/index.d.ts +2 -13
  3. package/package.json +4 -4
package/README.md CHANGED
@@ -47,16 +47,16 @@ npm install --save @middy/ssm
47
47
 
48
48
  ## Options
49
49
 
50
- - `AwsClient` (object) (default `AWS.SSM`): AWS.SSM class constructor (e.g. that has been instrumented with AWS XRay). Must be from `aws-sdk` v2.
50
+ - `AwsClient` (object) (default `AWS.SSM`): AWS.SSM class constructor (e.g. that has been instrumented with AWS X-Ray). Must be from `aws-sdk` v2.
51
51
  - `awsClientOptions` (object) (optional): Options to pass to AWS.SSM class constructor.
52
52
  - `awsClientAssumeRole` (string) (optional): Internal key where role tokens are stored. See [@middy/sts](/packages/sts/README.md) on to set this.
53
- - `awsClientCapture` (function) (optional): Enable XRay by passing `captureAWSClient` from `aws-xray-sdk` in.
53
+ - `awsClientCapture` (function) (optional): Enable AWS X-Ray by passing `captureAWSClient` from `aws-xray-sdk` in.
54
54
  - `fetchData` (object) (required): Mapping of internal key name to API request parameter `Names`/`Path`. `SecureString` are automatically decrypted.
55
55
  - `disablePrefetch` (boolean) (default `false`): On cold start requests will trigger early if they can. Setting `awsClientAssumeRole` disables prefetch.
56
56
  - `cacheKey` (string) (default `ssm`): Cache key for the fetched data responses. Must be unique across all middleware.
57
57
  - `cacheExpiry` (number) (default `-1`): How long fetch data responses should be cached for. `-1`: cache forever, `0`: never cache, `n`: cache for n ms.
58
58
  - `setToEnv` (boolean) (default `false`): Store role tokens to `process.env`. **Storing secrets in `process.env` is considered security bad practice**
59
- - `setToContext` (boolean) (default `false`): Store role tokes to `request.context`.
59
+ - `setToContext` (boolean) (default `false`): Store role tokens to `request.context`.
60
60
 
61
61
  NOTES:
62
62
  - Lambda is required to have IAM permission for `ssm:GetParameters` and/or `ssm:GetParametersByPath` depending on what you're requesting.
@@ -79,7 +79,7 @@ handler
79
79
  .use(ssm({
80
80
  fetchData: {
81
81
  accessToken: '/dev/service_name/access_token', // single value
82
- dbParams: '/dev/service_name/database/', // object of values, key for each path
82
+ dbParams: '/dev/service_name/database/', // object of values, key for each path
83
83
  defaults: '/dev/defaults'
84
84
  },
85
85
  setToContext: true
@@ -109,7 +109,7 @@ handler
109
109
  .use(ssm({
110
110
  fetchData: {
111
111
  accessToken: '/dev/service_name/access_token', // single value
112
- dbParams: '/dev/service_name/database/', // object of values, key for each path
112
+ dbParams: '/dev/service_name/database/', // object of values, key for each path
113
113
  },
114
114
  cacheExpiry: 15*60*1000,
115
115
  cacheKey: 'ssm-secrets'
package/index.d.ts CHANGED
@@ -1,19 +1,8 @@
1
1
  import { SSM } from 'aws-sdk'
2
- import { captureAWSClient } from 'aws-xray-sdk'
2
+ import { Options as MiddyOptions } from '@middy/util'
3
3
  import middy from '@middy/core'
4
4
 
5
- interface Options<S = SSM> {
6
- AwsClient?: new() => S
7
- awsClientOptions?: Partial<SSM.Types.ClientConfiguration>
8
- awsClientAssumeRole?: string
9
- awsClientCapture?: typeof captureAWSClient
10
- fetchData?: { [key: string]: string }
11
- disablePrefetch?: boolean
12
- cacheKey?: string
13
- cacheExpiry?: number
14
- setToEnv?: boolean
15
- setToContext?: boolean
16
- }
5
+ interface Options<S = SSM> extends MiddyOptions<S, SSM.Types.ClientConfiguration> {}
17
6
 
18
7
  declare function ssm (options?: Options): middy.MiddlewareObj
19
8
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@middy/ssm",
3
- "version": "2.5.0",
3
+ "version": "2.5.4",
4
4
  "description": "SSM (EC2 Systems Manager) parameters middleware for the middy framework",
5
5
  "type": "commonjs",
6
6
  "engines": {
@@ -46,12 +46,12 @@
46
46
  },
47
47
  "homepage": "https://github.com/middyjs/middy#readme",
48
48
  "dependencies": {
49
- "@middy/util": "^2.5.0"
49
+ "@middy/util": "^2.5.4"
50
50
  },
51
51
  "devDependencies": {
52
- "@middy/core": "^2.5.0",
52
+ "@middy/core": "^2.5.4",
53
53
  "aws-sdk": "^2.939.0",
54
54
  "aws-xray-sdk": "^3.3.3"
55
55
  },
56
- "gitHead": "76d2bc02b48a4bbd054904538f5c4798ba3c4f7f"
56
+ "gitHead": "a4134a579c757a9fdfed3006877ba2c0ec8a2cfa"
57
57
  }