cdk-aws-lambda-powertools-blueprint 0.1.0

package/.nvmrc

@@ -0,0 +1 @@
+24

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# cdk-aws-lambda-powertools-blueprint
+
+## 0.1.0
+
+### Minor Changes
+
+- Initial version of library

package/CONTRIBUTING.md

@@ -0,0 +1,82 @@
+# Contributing Guidelines
+
+Thank you for your interest in contributing to our project. Whether it's a bug report, new feature, correction, or additional
+documentation, we greatly value feedback and contributions from our community.
+
+Please read through this document before submitting any issues or pull requests to ensure we have all the necessary
+information to effectively respond to your bug report or contribution.
+
+## Reporting Bugs/Feature Requests
+
+We welcome you to use the GitHub issue tracker to report bugs or suggest features.
+
+When filing an issue, please check existing open, or recently closed, issues to make sure somebody else hasn't already
+reported the issue. Please try to include as much information as you can. Details like these are incredibly useful:
+
+- A reproducible test case or series of steps
+- The version of our code being used
+- Any modifications you've made relevant to the bug
+- Anything unusual about your environment or deployment
+
+## Contributing via Pull Requests
+
+### Pull Request Checklist
+
+- [ ] Testing
+  - Unit test added (prefer not to modify an existing test, otherwise, it's probably a breaking change)
+- [ ] Docs
+  - **README**: README updated if necessary
+  - **JSDocs**: Inline JSDocs updated if necessary
+- [ ] Title and Description
+  - **Change type**: title prefixed with **fix**, **feat** and module name in parens, which will appear in changelog
+  - **Title**: use lower-case and doesn't end with a period
+  - **Breaking?**: last paragraph: "BREAKING CHANGE: <describe what changed + link for details>"
+  - **Issues**: Indicate issues fixed via: "**Fixes #xxx**" or "**Closes #xxx**"
+
+Contributions via pull requests are much appreciated. Before sending us a pull request, please ensure that:
+
+1. You are working against the latest source on the _main_ branch.
+
+---
+
+### Step 1: Open Issue
+
+If there isn't one already, open an issue describing what you intend to contribute. It's useful to communicate in advance, because sometimes, someone is already working in this space, so maybe it's worth collaborating with them instead of duplicating the efforts.
+
+### Step 2: Fork the repository
+
+GitHub provides additional document on [forking a repository](https://help.github.com/articles/fork-a-repo/). Make sure you are working against the latest source on the _main_ branch.
+
+### Step 3: Setup
+
+The following tools need to be installed on your system prior to building `cdk-aws-lambda-powertools-blueprint` locally:
+
+- [Node.js >= 22.0.0](https://nodejs.org/download/release/latest-v22.x/)
+  - We recommend using a version in [Active LTS](https://nodejs.org/en/about/releases/)
+
+Install dependencies
+
+- `npm install`
+
+### Step 4: Develop
+
+1. Change code
+2. If relevant, add [tests](./test/)
+3. Run tests
+   - `npm run test`
+4. Build
+   - `npm run build`
+5. Update relevant documentation
+6. Create the commit with relevant files
+
+### Step 5: Make the pull request
+
+Send us a [pull request](https://help.github.com/articles/creating-a-pull-request/), answering any default questions in the pull request interface. Pay attention to any automated CI failures reported in the pull request, and stay involved in the conversation.
+
+## Finding contributions to work on
+
+Looking at the existing issues is a great way to find something to contribute on. Looking at any 'help wanted' issues is a great place to start.
+
+## Licensing
+
+See the [LICENSE](./LICENSE) file for the project's licensing.

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) 2026 Miles Bardon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice (including the next paragraph) shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,126 @@
+# CDK AWS Lambda Powertools Blueprint
+
+This [Blueprint](https://docs.aws.amazon.com/cdk/v2/guide/blueprints.html) enables Function constructs defined in your Stack to have all the necessary properties configured to take advantage of [Powertools for AWS Lambda](https://docs.aws.amazon.com/powertools/).
+
+## Benefits
+
+Including the `PowertoolsFunctionDefaults` in your property injectors will apply the following defaults to all Functions in your Stacks.
+
+- The official [Powertools Lambda Layer](https://docs.aws.amazon.com/powertools/typescript/latest/getting-started/lambda-layers/) (only on NodeJS and Python runtimes).
+- The POWERTOOLS_SERVICE_NAME environment variable automatically set to the provided `functionName`.
+
+## Usage
+
+Different Lambda Function runtimes will take advantage of different behaviour, demonstrated in each section.
+
+### NodeJS Functions
+
+Both `Function` and `NodejsFunction` constructs are supported with the `NODEJS` Runtime Family. If you opt to use the latter, you will also benefit from the `bundling` props being updated to exclude the `@aws-lambda-powertools/*` modules from the final bundle. This will have the benefit of reducing the final bundle size, which can lead to performance improvements.
+
+```ts
+import { App } from "aws-cdk-lib";
+import { Runtime } from "aws-cdk-lib/aws-lambda";
+import { NodejsFunction } from "aws-cdk-lib/aws-lambda-nodejs";
+
+import { PowertoolsFunctionDefaults } from "cdk-aws-lambda-powertools-blueprint";
+
+const app = new App({
+  propertyInjectors: [new PowertoolsFunctionDefaults()],
+});
+
+const stack = new Stack(app, "MyStack");
+
+const fn = new NodejsFunction(stack, "MyFunction", {
+  functionName: "service-my-function",
+  runtime: Runtime.NODEJS_22_X,
+});
+```
+
+You can also select a specific Powertools version if you don't want to use the `latest` version of the Lambda Layer. For example;
+
+```ts
+import { App } from "aws-cdk-lib";
+
+import { PowertoolsFunctionDefaults } from "cdk-aws-lambda-powertools-blueprint";
+
+const app = new App({
+  propertyInjectors: [
+    new PowertoolsFunctionDefaults({
+      powertoolsVersion: "2.30.0",
+    }),
+  ],
+});
+```
+
+### Python Functions
+
+All `Function` constructs with the `PYTHON` Runtime Family will have the latest [Lambda Layer](https://docs.aws.amazon.com/powertools/python/latest/getting-started/install/#lambda-layer) appropriate to the configured architecture applied. If no `architecture` is applied, the function will fall back to `x86_64` architecture and a warning will be added to your stack annotations.
+
+```ts
+import { App } from "aws-cdk-lib";
+import { Function, Runtime } from "aws-cdk-lib/aws-lambda";
+
+import { PowertoolsFunctionDefaults } from "cdk-aws-lambda-powertools-blueprint";
+
+const app = new App({
+  propertyInjectors: [new PowertoolsFunctionDefaults()],
+});
+
+const stack = new Stack(app, "MyStack");
+
+const fn = new Function(stack, "MyFunction", {
+  functionName: "service-my-function",
+  runtime: Runtime.PYTHON_3_13,
+});
+```
+
+### All other runtimes
+
+Every Function runtime is supported, but at the time of writing no others have a Lambda Layer to apply to the function. As a result, only the POWERTOOLS_SERVICE_NAME environment variable will be added to any function that is configured with a different runtime than NodeJS or Python.
+
+```ts
+import { App } from "aws-cdk-lib";
+import { Function, Runtime } from "aws-cdk-lib/aws-lambda";
+
+import { PowertoolsFunctionDefaults } from "cdk-aws-lambda-powertools-blueprint";
+
+const app = new App({
+  propertyInjectors: [new PowertoolsFunctionDefaults()],
+});
+
+const stack = new Stack(app, "MyStack");
+
+const fn = new Function(stack, "MyFunction", {
+  functionName: "service-my-function",
+  runtime: Runtime.JAVA_21,
+});
+```
+
+## Development
+
+If you wish to contribute to this project, please follow the [Contribution guidelines](./CONTRIBUTING.md).
+
+Install dependencies
+
+```sh
+npm install
+```
+
+Build the package
+
+```sh
+npm run build
+```
+
+Run unit tests
+
+```sh
+npm run test
+```
+
+Run linting checks and fix linting issues
+
+```sh
+npm run lint
+npm run lint:fix
+```

package/biome.json

@@ -0,0 +1,34 @@
+{
+	"$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
+	"vcs": {
+		"enabled": true,
+		"clientKind": "git",
+		"useIgnoreFile": true
+	},
+	"files": {
+		"ignoreUnknown": false
+	},
+	"formatter": {
+		"enabled": true,
+		"indentStyle": "tab"
+	},
+	"linter": {
+		"enabled": true,
+		"rules": {
+			"recommended": true
+		}
+	},
+	"javascript": {
+		"formatter": {
+			"quoteStyle": "double"
+		}
+	},
+	"assist": {
+		"enabled": true,
+		"actions": {
+			"source": {
+				"organizeImports": "on"
+			}
+		}
+	}
+}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import { type InjectionContext, type IPropertyInjector } from "aws-cdk-lib";
+export interface PowertoolsFunctionDefaultsProps {
+    /**
+     * The Powertools package version to load into the Lambda.
+     * Only provide this value if you don't want the latest version.
+     *
+     * Setting this field will only have an effect on NodeJS Functions.
+     *
+     * @default "latest"
+     */
+    readonly powertoolsVersion?: string;
+}
+/**
+ * Applies Powertools-specific defaults to Functions in your Stack.
+ *
+ * For NodeJS and Python Functions, also applies the official Lambda Layer
+ * for the appropriate runtime and architecture.
+ *
+ * NodeJS Functions will also have the '@aws-lambda-powertools/*' modules
+ * excluded from being bundled to minimise the bundle size.
+ */
+export declare class PowertoolsFunctionDefaults implements IPropertyInjector {
+    readonly constructUniqueId: string;
+    private powertoolsVersion;
+    constructor(props?: PowertoolsFunctionDefaultsProps);
+    inject(originalProps: any, context: InjectionContext): any;
+}

package/dist/index.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PowertoolsFunctionDefaults = void 0;
+const JSII_RTTI_SYMBOL_1 = Symbol.for("jsii.rtti");
+const aws_cdk_lib_1 = require("aws-cdk-lib");
+const aws_lambda_1 = require("aws-cdk-lib/aws-lambda");
+const aws_lambda_nodejs_1 = require("aws-cdk-lib/aws-lambda-nodejs");
+const aws_ssm_1 = require("aws-cdk-lib/aws-ssm");
+/**
+ * Applies Powertools-specific defaults to Functions in your Stack.
+ *
+ * For NodeJS and Python Functions, also applies the official Lambda Layer
+ * for the appropriate runtime and architecture.
+ *
+ * NodeJS Functions will also have the '@aws-lambda-powertools/*' modules
+ * excluded from being bundled to minimise the bundle size.
+ */
+class PowertoolsFunctionDefaults {
+    static [JSII_RTTI_SYMBOL_1] = { fqn: "cdk-aws-lambda-powertools-blueprint.PowertoolsFunctionDefaults", version: "0.1.0" };
+    constructUniqueId;
+    powertoolsVersion;
+    constructor(props) {
+        this.constructUniqueId = aws_lambda_1.Function.PROPERTY_INJECTION_ID;
+        this.powertoolsVersion = props?.powertoolsVersion ?? "latest";
+    }
+    inject(originalProps, context) {
+        const originalFunctionProps = originalProps;
+        const scope = context.scope;
+        let powertoolsLayerParameterName = "";
+        // Determine if the Function runtime has a layer available
+        switch (originalFunctionProps.runtime?.family) {
+            case aws_lambda_1.RuntimeFamily.NODEJS: {
+                // https://docs.aws.amazon.com/powertools/typescript/latest/getting-started/lambda-layers/#lookup-layer-arn-via-aws-ssm-parameter-store
+                powertoolsLayerParameterName = `/aws/service/powertools/typescript/generic/all/${this.powertoolsVersion}`;
+                break;
+            }
+            case aws_lambda_1.RuntimeFamily.PYTHON: {
+                const architecture = originalFunctionProps.architecture ?? aws_lambda_1.Architecture.X86_64;
+                if (!originalFunctionProps.architecture) {
+                    aws_cdk_lib_1.Annotations.of(scope).addWarningV2("cdk-aws-lambda-powertools-blueprint:Blueprint.missingArchitecture", `Function ${context.id} has no specified Architecture and will fall back to ${aws_lambda_1.Architecture.X86_64.name}.`);
+                }
+                // https://docs.aws.amazon.com/powertools/python/latest/getting-started/install/#using-ssm-parameter-store
+                powertoolsLayerParameterName = `/aws/service/powertools/python/${architecture.name}/${originalFunctionProps.runtime.name}/latest`;
+                break;
+            }
+            default: {
+                aws_cdk_lib_1.Annotations.of(scope).addInfo(`Function ${context.id} is configured with runtime ${originalFunctionProps.runtime} and will not have the Powertools Lambda Layer applied.`);
+            }
+        }
+        let powertoolsLayer;
+        const layers = originalFunctionProps.layers ?? [];
+        if (powertoolsLayerParameterName) {
+            // Create the LayerVersion construct to apply to the Function
+            powertoolsLayer = aws_lambda_1.LayerVersion.fromLayerVersionArn(scope, `${context.id}-PowertoolsLayer`, aws_ssm_1.StringParameter.valueForStringParameter(scope, powertoolsLayerParameterName));
+            // Apply the Powertools layer to the end of the layers array
+            layers.push(powertoolsLayer);
+            // For NodejsFunction Constructs, we also want to override the bundling to make sure the Lambda bundle is as small as possible
+            if (context.scope instanceof aws_lambda_nodejs_1.NodejsFunction) {
+                const originalNodejsProps = originalFunctionProps;
+                return {
+                    ...originalNodejsProps,
+                    layers,
+                    bundling: {
+                        ...originalNodejsProps.bundling,
+                        externalModules: [
+                            ...(originalNodejsProps.bundling?.externalModules ?? []),
+                            "@aws-sdk/*",
+                            "@aws-lambda-powertools/*",
+                        ],
+                    },
+                };
+            }
+        }
+        return {
+            ...originalProps,
+            layers,
+        };
+    }
+}
+exports.PowertoolsFunctionDefaults = PowertoolsFunctionDefaults;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9saWIvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7OztBQUFBLDZDQUlxQjtBQUNyQix1REFPZ0M7QUFDaEMscUVBR3VDO0FBQ3ZDLGlEQUFzRDtBQWN0RDs7Ozs7Ozs7R0FRRztBQUNILE1BQWEsMEJBQTBCOztJQUN0QixpQkFBaUIsQ0FBUztJQUVsQyxpQkFBaUIsQ0FBUztJQUVsQyxZQUFZLEtBQXVDO1FBQ2xELElBQUksQ0FBQyxpQkFBaUIsR0FBRyxxQkFBYyxDQUFDLHFCQUFxQixDQUFDO1FBRTlELElBQUksQ0FBQyxpQkFBaUIsR0FBRyxLQUFLLEVBQUUsaUJBQWlCLElBQUksUUFBUSxDQUFDO0lBQy9ELENBQUM7SUFFTSxNQUFNLENBQUMsYUFBa0IsRUFBRSxPQUF5QjtRQUMxRCxNQUFNLHFCQUFxQixHQUMxQixhQUFhLENBQUM7UUFFZixNQUFNLEtBQUssR0FBRyxPQUFPLENBQUMsS0FBdUIsQ0FBQztRQUU5QyxJQUFJLDRCQUE0QixHQUFHLEVBQUUsQ0FBQztRQUV0QywwREFBMEQ7UUFDMUQsUUFBUSxxQkFBcUIsQ0FBQyxPQUFPLEVBQUUsTUFBTSxFQUFFLENBQUM7WUFDL0MsS0FBSywwQkFBYSxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUM7Z0JBQzNCLHVJQUF1STtnQkFDdkksNEJBQTRCLEdBQUcsa0RBQWtELElBQUksQ0FBQyxpQkFBaUIsRUFBRSxDQUFDO2dCQUMxRyxNQUFNO1lBQ1AsQ0FBQztZQUNELEtBQUssMEJBQWEsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDO2dCQUMzQixNQUFNLFlBQVksR0FDakIscUJBQXFCLENBQUMsWUFBWSxJQUFJLHlCQUFZLENBQUMsTUFBTSxDQUFDO2dCQUUzRCxJQUFJLENBQUMscUJBQXFCLENBQUMsWUFBWSxFQUFFLENBQUM7b0JBQ3pDLHlCQUFXLENBQUMsRUFBRSxDQUFDLEtBQUssQ0FBQyxDQUFDLFlBQVksQ0FDakMsbUVBQW1FLEVBQ25FLFlBQVksT0FBTyxDQUFDLEVBQUUsd0RBQXdELHlCQUFZLENBQUMsTUFBTSxDQUFDLElBQUksR0FBRyxDQUN6RyxDQUFDO2dCQUNILENBQUM7Z0JBRUQsMEdBQTBHO2dCQUMxRyw0QkFBNEIsR0FBRyxrQ0FBa0MsWUFBWSxDQUFDLElBQUksSUFBSSxxQkFBcUIsQ0FBQyxPQUFPLENBQUMsSUFBSSxTQUFTLENBQUM7Z0JBQ2xJLE1BQU07WUFDUCxDQUFDO1lBQ0QsT0FBTyxDQUFDLENBQUMsQ0FBQztnQkFDVCx5QkFBVyxDQUFDLEVBQUUsQ0FBQyxLQUFLLENBQUMsQ0FBQyxPQUFPLENBQzVCLFlBQVksT0FBTyxDQUFDLEVBQUUsK0JBQStCLHFCQUFxQixDQUFDLE9BQU8seURBQXlELENBQzNJLENBQUM7WUFDSCxDQUFDO1FBQ0YsQ0FBQztRQUVELElBQUksZUFBMEMsQ0FBQztRQUUvQyxNQUFNLE1BQU0sR0FBRyxxQkFBcUIsQ0FBQyxNQUFNLElBQUksRUFBRSxDQUFDO1FBRWxELElBQUksNEJBQTRCLEVBQUUsQ0FBQztZQUNsQyw2REFBNkQ7WUFDN0QsZUFBZSxHQUFHLHlCQUFZLENBQUMsbUJBQW1CLENBQ2pELEtBQUssRUFDTCxHQUFHLE9BQU8sQ0FBQyxFQUFFLGtCQUFrQixFQUMvQix5QkFBZSxDQUFDLHVCQUF1QixDQUN0QyxLQUFLLEVBQ0wsNEJBQTRCLENBQzVCLENBQ0QsQ0FBQztZQUVGLDREQUE0RDtZQUM1RCxNQUFNLENBQUMsSUFBSSxDQUFDLGVBQWUsQ0FBQyxDQUFDO1lBRTdCLDhIQUE4SDtZQUM5SCxJQUFJLE9BQU8sQ0FBQyxLQUFLLFlBQVksa0NBQWMsRUFBRSxDQUFDO2dCQUM3QyxNQUFNLG1CQUFtQixHQUF3QixxQkFBcUIsQ0FBQztnQkFFdkUsT0FBTztvQkFDTixHQUFHLG1CQUFtQjtvQkFDdEIsTUFBTTtvQkFDTixRQUFRLEVBQUU7d0JBQ1QsR0FBRyxtQkFBbUIsQ0FBQyxRQUFRO3dCQUMvQixlQUFlLEVBQUU7NEJBQ2hCLEdBQUcsQ0FBQyxtQkFBbUIsQ0FBQyxRQUFRLEVBQUUsZUFBZSxJQUFJLEVBQUUsQ0FBQzs0QkFDeEQsWUFBWTs0QkFDWiwwQkFBMEI7eUJBQzFCO3FCQUNEO2lCQUNELENBQUM7WUFDSCxDQUFDO1FBQ0YsQ0FBQztRQUVELE9BQU87WUFDTixHQUFHLGFBQWE7WUFDaEIsTUFBTTtTQUNOLENBQUM7SUFDSCxDQUFDOztBQXpGRixnRUEwRkMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQge1xuXHRBbm5vdGF0aW9ucyxcblx0dHlwZSBJbmplY3Rpb25Db250ZXh0LFxuXHR0eXBlIElQcm9wZXJ0eUluamVjdG9yLFxufSBmcm9tIFwiYXdzLWNkay1saWJcIjtcbmltcG9ydCB7XG5cdEFyY2hpdGVjdHVyZSxcblx0dHlwZSBGdW5jdGlvblByb3BzLFxuXHR0eXBlIElMYXllclZlcnNpb24sXG5cdEZ1bmN0aW9uIGFzIExhbWJkYUZ1bmN0aW9uLFxuXHRMYXllclZlcnNpb24sXG5cdFJ1bnRpbWVGYW1pbHksXG59IGZyb20gXCJhd3MtY2RrLWxpYi9hd3MtbGFtYmRhXCI7XG5pbXBvcnQge1xuXHROb2RlanNGdW5jdGlvbixcblx0dHlwZSBOb2RlanNGdW5jdGlvblByb3BzLFxufSBmcm9tIFwiYXdzLWNkay1saWIvYXdzLWxhbWJkYS1ub2RlanNcIjtcbmltcG9ydCB7IFN0cmluZ1BhcmFtZXRlciB9IGZyb20gXCJhd3MtY2RrLWxpYi9hd3Mtc3NtXCI7XG5cbmV4cG9ydCBpbnRlcmZhY2UgUG93ZXJ0b29sc0Z1bmN0aW9uRGVmYXVsdHNQcm9wcyB7XG5cdC8qKlxuXHQgKiBUaGUgUG93ZXJ0b29scyBwYWNrYWdlIHZlcnNpb24gdG8gbG9hZCBpbnRvIHRoZSBMYW1iZGEuXG5cdCAqIE9ubHkgcHJvdmlkZSB0aGlzIHZhbHVlIGlmIHlvdSBkb24ndCB3YW50IHRoZSBsYXRlc3QgdmVyc2lvbi5cblx0ICpcblx0ICogU2V0dGluZyB0aGlzIGZpZWxkIHdpbGwgb25seSBoYXZlIGFuIGVmZmVjdCBvbiBOb2RlSlMgRnVuY3Rpb25zLlxuXHQgKlxuXHQgKiBAZGVmYXVsdCBcImxhdGVzdFwiXG5cdCAqL1xuXHRyZWFkb25seSBwb3dlcnRvb2xzVmVyc2lvbj86IHN0cmluZztcbn1cblxuLyoqXG4gKiBBcHBsaWVzIFBvd2VydG9vbHMtc3BlY2lmaWMgZGVmYXVsdHMgdG8gRnVuY3Rpb25zIGluIHlvdXIgU3RhY2suXG4gKlxuICogRm9yIE5vZGVKUyBhbmQgUHl0aG9uIEZ1bmN0aW9ucywgYWxzbyBhcHBsaWVzIHRoZSBvZmZpY2lhbCBMYW1iZGEgTGF5ZXJcbiAqIGZvciB0aGUgYXBwcm9wcmlhdGUgcnVudGltZSBhbmQgYXJjaGl0ZWN0dXJlLlxuICpcbiAqIE5vZGVKUyBGdW5jdGlvbnMgd2lsbCBhbHNvIGhhdmUgdGhlICdAYXdzLWxhbWJkYS1wb3dlcnRvb2xzLyonIG1vZHVsZXNcbiAqIGV4Y2x1ZGVkIGZyb20gYmVpbmcgYnVuZGxlZCB0byBtaW5pbWlzZSB0aGUgYnVuZGxlIHNpemUuXG4gKi9cbmV4cG9ydCBjbGFzcyBQb3dlcnRvb2xzRnVuY3Rpb25EZWZhdWx0cyBpbXBsZW1lbnRzIElQcm9wZXJ0eUluamVjdG9yIHtcblx0cHVibGljIHJlYWRvbmx5IGNvbnN0cnVjdFVuaXF1ZUlkOiBzdHJpbmc7XG5cblx0cHJpdmF0ZSBwb3dlcnRvb2xzVmVyc2lvbjogc3RyaW5nO1xuXG5cdGNvbnN0cnVjdG9yKHByb3BzPzogUG93ZXJ0b29sc0Z1bmN0aW9uRGVmYXVsdHNQcm9wcykge1xuXHRcdHRoaXMuY29uc3RydWN0VW5pcXVlSWQgPSBMYW1iZGFGdW5jdGlvbi5QUk9QRVJUWV9JTkpFQ1RJT05fSUQ7XG5cblx0XHR0aGlzLnBvd2VydG9vbHNWZXJzaW9uID0gcHJvcHM/LnBvd2VydG9vbHNWZXJzaW9uID8/IFwibGF0ZXN0XCI7XG5cdH1cblxuXHRwdWJsaWMgaW5qZWN0KG9yaWdpbmFsUHJvcHM6IGFueSwgY29udGV4dDogSW5qZWN0aW9uQ29udGV4dCkge1xuXHRcdGNvbnN0IG9yaWdpbmFsRnVuY3Rpb25Qcm9wczogRnVuY3Rpb25Qcm9wcyB8IE5vZGVqc0Z1bmN0aW9uUHJvcHMgPVxuXHRcdFx0b3JpZ2luYWxQcm9wcztcblxuXHRcdGNvbnN0IHNjb3BlID0gY29udGV4dC5zY29wZSBhcyBMYW1iZGFGdW5jdGlvbjtcblxuXHRcdGxldCBwb3dlcnRvb2xzTGF5ZXJQYXJhbWV0ZXJOYW1lID0gXCJcIjtcblxuXHRcdC8vIERldGVybWluZSBpZiB0aGUgRnVuY3Rpb24gcnVudGltZSBoYXMgYSBsYXllciBhdmFpbGFibGVcblx0XHRzd2l0Y2ggKG9yaWdpbmFsRnVuY3Rpb25Qcm9wcy5ydW50aW1lPy5mYW1pbHkpIHtcblx0XHRcdGNhc2UgUnVudGltZUZhbWlseS5OT0RFSlM6IHtcblx0XHRcdFx0Ly8gaHR0cHM6Ly9kb2NzLmF3cy5hbWF6b24uY29tL3Bvd2VydG9vbHMvdHlwZXNjcmlwdC9sYXRlc3QvZ2V0dGluZy1zdGFydGVkL2xhbWJkYS1sYXllcnMvI2xvb2t1cC1sYXllci1hcm4tdmlhLWF3cy1zc20tcGFyYW1ldGVyLXN0b3JlXG5cdFx0XHRcdHBvd2VydG9vbHNMYXllclBhcmFtZXRlck5hbWUgPSBgL2F3cy9zZXJ2aWNlL3Bvd2VydG9vbHMvdHlwZXNjcmlwdC9nZW5lcmljL2FsbC8ke3RoaXMucG93ZXJ0b29sc1ZlcnNpb259YDtcblx0XHRcdFx0YnJlYWs7XG5cdFx0XHR9XG5cdFx0XHRjYXNlIFJ1bnRpbWVGYW1pbHkuUFlUSE9OOiB7XG5cdFx0XHRcdGNvbnN0IGFyY2hpdGVjdHVyZSA9XG5cdFx0XHRcdFx0b3JpZ2luYWxGdW5jdGlvblByb3BzLmFyY2hpdGVjdHVyZSA/PyBBcmNoaXRlY3R1cmUuWDg2XzY0O1xuXG5cdFx0XHRcdGlmICghb3JpZ2luYWxGdW5jdGlvblByb3BzLmFyY2hpdGVjdHVyZSkge1xuXHRcdFx0XHRcdEFubm90YXRpb25zLm9mKHNjb3BlKS5hZGRXYXJuaW5nVjIoXG5cdFx0XHRcdFx0XHRcImNkay1hd3MtbGFtYmRhLXBvd2VydG9vbHMtYmx1ZXByaW50OkJsdWVwcmludC5taXNzaW5nQXJjaGl0ZWN0dXJlXCIsXG5cdFx0XHRcdFx0XHRgRnVuY3Rpb24gJHtjb250ZXh0LmlkfSBoYXMgbm8gc3BlY2lmaWVkIEFyY2hpdGVjdHVyZSBhbmQgd2lsbCBmYWxsIGJhY2sgdG8gJHtBcmNoaXRlY3R1cmUuWDg2XzY0Lm5hbWV9LmAsXG5cdFx0XHRcdFx0KTtcblx0XHRcdFx0fVxuXG5cdFx0XHRcdC8vIGh0dHBzOi8vZG9jcy5hd3MuYW1hem9uLmNvbS9wb3dlcnRvb2xzL3B5dGhvbi9sYXRlc3QvZ2V0dGluZy1zdGFydGVkL2luc3RhbGwvI3VzaW5nLXNzbS1wYXJhbWV0ZXItc3RvcmVcblx0XHRcdFx0cG93ZXJ0b29sc0xheWVyUGFyYW1ldGVyTmFtZSA9IGAvYXdzL3NlcnZpY2UvcG93ZXJ0b29scy9weXRob24vJHthcmNoaXRlY3R1cmUubmFtZX0vJHtvcmlnaW5hbEZ1bmN0aW9uUHJvcHMucnVudGltZS5uYW1lfS9sYXRlc3RgO1xuXHRcdFx0XHRicmVhaztcblx0XHRcdH1cblx0XHRcdGRlZmF1bHQ6IHtcblx0XHRcdFx0QW5ub3RhdGlvbnMub2Yoc2NvcGUpLmFkZEluZm8oXG5cdFx0XHRcdFx0YEZ1bmN0aW9uICR7Y29udGV4dC5pZH0gaXMgY29uZmlndXJlZCB3aXRoIHJ1bnRpbWUgJHtvcmlnaW5hbEZ1bmN0aW9uUHJvcHMucnVudGltZX0gYW5kIHdpbGwgbm90IGhhdmUgdGhlIFBvd2VydG9vbHMgTGFtYmRhIExheWVyIGFwcGxpZWQuYCxcblx0XHRcdFx0KTtcblx0XHRcdH1cblx0XHR9XG5cblx0XHRsZXQgcG93ZXJ0b29sc0xheWVyOiBJTGF5ZXJWZXJzaW9uIHwgdW5kZWZpbmVkO1xuXG5cdFx0Y29uc3QgbGF5ZXJzID0gb3JpZ2luYWxGdW5jdGlvblByb3BzLmxheWVycyA/PyBbXTtcblxuXHRcdGlmIChwb3dlcnRvb2xzTGF5ZXJQYXJhbWV0ZXJOYW1lKSB7XG5cdFx0XHQvLyBDcmVhdGUgdGhlIExheWVyVmVyc2lvbiBjb25zdHJ1Y3QgdG8gYXBwbHkgdG8gdGhlIEZ1bmN0aW9uXG5cdFx0XHRwb3dlcnRvb2xzTGF5ZXIgPSBMYXllclZlcnNpb24uZnJvbUxheWVyVmVyc2lvbkFybihcblx0XHRcdFx0c2NvcGUsXG5cdFx0XHRcdGAke2NvbnRleHQuaWR9LVBvd2VydG9vbHNMYXllcmAsXG5cdFx0XHRcdFN0cmluZ1BhcmFtZXRlci52YWx1ZUZvclN0cmluZ1BhcmFtZXRlcihcblx0XHRcdFx0XHRzY29wZSxcblx0XHRcdFx0XHRwb3dlcnRvb2xzTGF5ZXJQYXJhbWV0ZXJOYW1lLFxuXHRcdFx0XHQpLFxuXHRcdFx0KTtcblxuXHRcdFx0Ly8gQXBwbHkgdGhlIFBvd2VydG9vbHMgbGF5ZXIgdG8gdGhlIGVuZCBvZiB0aGUgbGF5ZXJzIGFycmF5XG5cdFx0XHRsYXllcnMucHVzaChwb3dlcnRvb2xzTGF5ZXIpO1xuXG5cdFx0XHQvLyBGb3IgTm9kZWpzRnVuY3Rpb24gQ29uc3RydWN0cywgd2UgYWxzbyB3YW50IHRvIG92ZXJyaWRlIHRoZSBidW5kbGluZyB0byBtYWtlIHN1cmUgdGhlIExhbWJkYSBidW5kbGUgaXMgYXMgc21hbGwgYXMgcG9zc2libGVcblx0XHRcdGlmIChjb250ZXh0LnNjb3BlIGluc3RhbmNlb2YgTm9kZWpzRnVuY3Rpb24pIHtcblx0XHRcdFx0Y29uc3Qgb3JpZ2luYWxOb2RlanNQcm9wczogTm9kZWpzRnVuY3Rpb25Qcm9wcyA9IG9yaWdpbmFsRnVuY3Rpb25Qcm9wcztcblxuXHRcdFx0XHRyZXR1cm4ge1xuXHRcdFx0XHRcdC4uLm9yaWdpbmFsTm9kZWpzUHJvcHMsXG5cdFx0XHRcdFx0bGF5ZXJzLFxuXHRcdFx0XHRcdGJ1bmRsaW5nOiB7XG5cdFx0XHRcdFx0XHQuLi5vcmlnaW5hbE5vZGVqc1Byb3BzLmJ1bmRsaW5nLFxuXHRcdFx0XHRcdFx0ZXh0ZXJuYWxNb2R1bGVzOiBbXG5cdFx0XHRcdFx0XHRcdC4uLihvcmlnaW5hbE5vZGVqc1Byb3BzLmJ1bmRsaW5nPy5leHRlcm5hbE1vZHVsZXMgPz8gW10pLFxuXHRcdFx0XHRcdFx0XHRcIkBhd3Mtc2RrLypcIixcblx0XHRcdFx0XHRcdFx0XCJAYXdzLWxhbWJkYS1wb3dlcnRvb2xzLypcIixcblx0XHRcdFx0XHRcdF0sXG5cdFx0XHRcdFx0fSxcblx0XHRcdFx0fTtcblx0XHRcdH1cblx0XHR9XG5cblx0XHRyZXR1cm4ge1xuXHRcdFx0Li4ub3JpZ2luYWxQcm9wcyxcblx0XHRcdGxheWVycyxcblx0XHR9O1xuXHR9XG59XG4iXX0=