@aws-mdaa/dataops-job-l3-construct 1.5.0 → 1.6.0

package/node_modules/@aws-mdaa/config/test/ref-value-transformer.test.ts

@@ -0,0 +1,304 @@
+/*!
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { Stack } from 'aws-cdk-lib';
+import { MdaaConfigRefValueTransformer } from '../lib/ref-value-transformer';
+
+describe('MdaaConfigRefValueTransformer', () => {
+  const baseProps = {
+    org: 'test-org',
+    env: 'dev',
+    domain: 'test-domain',
+    module_name: 'test-module',
+  };
+
+  test('returns unchanged value without refs', () => {
+    const transformer = new MdaaConfigRefValueTransformer(baseProps);
+    expect(transformer.transformValue('plain-value')).toBe('plain-value');
+  });
+
+  test('transforms org ref', () => {
+    const transformer = new MdaaConfigRefValueTransformer(baseProps);
+    expect(transformer.transformValue('{{org}}')).toBe('test-org');
+  });
+
+  test('transforms env ref', () => {
+    const transformer = new MdaaConfigRefValueTransformer(baseProps);
+    expect(transformer.transformValue('{{env}}')).toBe('dev');
+  });
+
+  test('transforms domain ref', () => {
+    const transformer = new MdaaConfigRefValueTransformer(baseProps);
+    expect(transformer.transformValue('{{domain}}')).toBe('test-domain');
+  });
+
+  test('transforms module_name ref', () => {
+    const transformer = new MdaaConfigRefValueTransformer(baseProps);
+    expect(transformer.transformValue('{{module_name}}')).toBe('test-module');
+  });
+
+  test('transforms partition ref with scope', () => {
+    const stack = new Stack();
+    const transformer = new MdaaConfigRefValueTransformer({ ...baseProps, scope: stack });
+    const result = transformer.transformValue('{{partition}}');
+    expect(result).toBeDefined();
+  });
+
+  test('transforms region ref with scope', () => {
+    const stack = new Stack();
+    const transformer = new MdaaConfigRefValueTransformer({ ...baseProps, scope: stack });
+    const result = transformer.transformValue('{{region}}');
+    expect(result).toBeDefined();
+  });
+
+  test('transforms account ref with scope', () => {
+    const stack = new Stack();
+    const transformer = new MdaaConfigRefValueTransformer({ ...baseProps, scope: stack });
+    const result = transformer.transformValue('{{account}}');
+    expect(result).toBeDefined();
+  });
+
+  test('transforms env_var ref', () => {
+    process.env.TEST_VAR = 'test-value';
+    const transformer = new MdaaConfigRefValueTransformer(baseProps);
+    expect(transformer.transformValue('{{env_var:TEST_VAR}}')).toBe('test-value');
+    delete process.env.TEST_VAR;
+  });
+
+  test('transforms context ref from scope', () => {
+    const stack = new Stack();
+    stack.node.setContext('test_key', 'test-value');
+    const transformer = new MdaaConfigRefValueTransformer({ ...baseProps, scope: stack });
+    expect(transformer.transformValue('{{context:test_key}}')).toBe('test-value');
+  });
+
+  test('transforms context ref from context prop', () => {
+    const transformer = new MdaaConfigRefValueTransformer({ ...baseProps, context: { test_key: 'test-value' } });
+    expect(transformer.transformValue('{{context:test_key}}')).toBe('test-value');
+  });
+
+  test('throws when context ref not found', () => {
+    const transformer = new MdaaConfigRefValueTransformer(baseProps);
+    expect(() => transformer.transformValue('{{context:missing_key}}')).toThrow(
+      'Failed to resolve context: missing_key',
+    );
+  });
+
+  test('throws when org ref without naming', () => {
+    const stack = new Stack();
+    const transformer = new MdaaConfigRefValueTransformer({ ...baseProps, scope: stack });
+    expect(() => transformer.transformValue('{{ssm-org:param}}')).toThrow(
+      'Unable to resolve ssm-org:param ssm param outside of a naming context',
+    );
+  });
+
+  test('throws when resolve:ssm without scope', () => {
+    const transformer = new MdaaConfigRefValueTransformer(baseProps);
+    expect(() => transformer.transformValue('{{resolve:ssm:/test/param}}')).toThrow(
+      'Unable to resolve ssm param outside of a Construct',
+    );
+  });
+
+  test('handles nested refs', () => {
+    const transformer = new MdaaConfigRefValueTransformer(baseProps);
+    expect(transformer.transformValue('prefix-{{org}}-{{env}}-suffix')).toBe('prefix-test-org-dev-suffix');
+  });
+
+  test('transforms partition ref with awsEnvironment', () => {
+    const transformer = new MdaaConfigRefValueTransformer({
+      ...baseProps,
+      awsEnvironment: { partition: 'aws-us-gov' },
+    });
+    expect(transformer.transformValue('{{partition}}')).toBe('aws-us-gov');
+  });
+
+  test('transforms region ref with awsEnvironment', () => {
+    const transformer = new MdaaConfigRefValueTransformer({
+      ...baseProps,
+      awsEnvironment: { region: 'us-west-2' },
+    });
+    expect(transformer.transformValue('{{region}}')).toBe('us-west-2');
+  });
+
+  test('transforms account ref with awsEnvironment', () => {
+    const transformer = new MdaaConfigRefValueTransformer({
+      ...baseProps,
+      awsEnvironment: { account: '123456789012' },
+    });
+    expect(transformer.transformValue('{{account}}')).toBe('123456789012');
+  });
+
+  test('returns undefined for missing env_var', () => {
+    const transformer = new MdaaConfigRefValueTransformer(baseProps);
+    expect(transformer.transformValue('{{env_var:MISSING_VAR}}')).toBe('{{env_var:MISSING_VAR}}');
+  });
+
+  test('resolves env_var JSON array to actual array', () => {
+    process.env.TEST_JSON_ARRAY = '["subnet-aaa","subnet-bbb"]';
+    const transformer = new MdaaConfigRefValueTransformer(baseProps);
+    expect(transformer.transformValue('{{env_var:TEST_JSON_ARRAY}}')).toEqual(['subnet-aaa', 'subnet-bbb']);
+    delete process.env.TEST_JSON_ARRAY;
+  });
+
+  test('resolves env_var JSON object to actual object', () => {
+    process.env.TEST_JSON_OBJ = '{"key":"value"}';
+    const transformer = new MdaaConfigRefValueTransformer(baseProps);
+    expect(transformer.transformValue('{{env_var:TEST_JSON_OBJ}}')).toEqual({ key: 'value' });
+    delete process.env.TEST_JSON_OBJ;
+  });
+
+  test('falls through to string for invalid JSON starting with [', () => {
+    process.env.TEST_BAD_JSON = '[not valid json';
+    const transformer = new MdaaConfigRefValueTransformer(baseProps);
+    expect(transformer.transformValue('{{env_var:TEST_BAD_JSON}}')).toBe('[not valid json');
+    delete process.env.TEST_BAD_JSON;
+  });
+
+  test('handles naked reference with object context', () => {
+    const transformer = new MdaaConfigRefValueTransformer({
+      ...baseProps,
+      context: { test_obj: { key: 'value' } },
+    });
+    const result = transformer.transformValue('{{context:test_obj}}');
+    expect(result).toEqual({ key: 'value' });
+  });
+
+  test('handles naked reference with array context', () => {
+    const transformer = new MdaaConfigRefValueTransformer({
+      ...baseProps,
+      context: { test_array: ['item1', 'item2'] },
+    });
+    const result = transformer.transformValue('{{context:test_array}}');
+    expect(result).toEqual(['item1', 'item2']);
+  });
+
+  test('throws when embedding object context in string', () => {
+    const transformer = new MdaaConfigRefValueTransformer({
+      ...baseProps,
+      context: { test_obj: { key: 'value' } },
+    });
+    expect(() => transformer.transformValue('prefix-{{context:test_obj}}-suffix')).toThrow(
+      'Cannot embed array or object context value in string',
+    );
+  });
+
+  test('throws when embedding array context in string', () => {
+    const transformer = new MdaaConfigRefValueTransformer({
+      ...baseProps,
+      context: { test_array: ['item1', 'item2'] },
+    });
+    expect(() => transformer.transformValue('prefix-{{context:test_array}}-suffix')).toThrow(
+      'Cannot embed array or object context value in string',
+    );
+  });
+
+  test('handles context with encoded object string', () => {
+    const stack = new Stack();
+    stack.node.setContext('test_key', '"obj:{"key":"value"}"');
+    const transformer = new MdaaConfigRefValueTransformer({ ...baseProps, scope: stack });
+    const result = transformer.transformValue('{{context:test_key}}');
+    expect(result).toEqual({ key: 'value' });
+  });
+
+  test('handles context with encoded list string', () => {
+    const stack = new Stack();
+    stack.node.setContext('test_key', '"list:["item1","item2"]"');
+    const transformer = new MdaaConfigRefValueTransformer({ ...baseProps, scope: stack });
+    const result = transformer.transformValue('{{context:test_key}}');
+    expect(result).toEqual(['item1', 'item2']);
+  });
+
+  test('converts number to string in substitution', () => {
+    const transformer = new MdaaConfigRefValueTransformer({
+      ...baseProps,
+      context: { test_num: 42 },
+    });
+    const result = transformer.transformValue('value-{{context:test_num}}');
+    expect(result).toBe('value-42');
+  });
+
+  test('converts boolean to string in substitution', () => {
+    const transformer = new MdaaConfigRefValueTransformer({
+      ...baseProps,
+      context: { test_bool: true },
+    });
+    const result = transformer.transformValue('value-{{context:test_bool}}');
+    expect(result).toBe('value-true');
+  });
+
+  test('handles ref: with attribute', () => {
+    const transformer = new MdaaConfigRefValueTransformer(baseProps);
+    const result = transformer.transformValue('{{ref:MyResource:Arn}}');
+    expect(result).toBeDefined();
+    expect(typeof result).toBe('string');
+  });
+
+  test('handles ref: without attribute', () => {
+    const transformer = new MdaaConfigRefValueTransformer(baseProps);
+    const result = transformer.transformValue('{{ref:MyResource}}');
+    expect(result).toBeDefined();
+    expect(typeof result).toBe('string');
+  });
+
+  test('handles ref: with leading slash', () => {
+    const transformer = new MdaaConfigRefValueTransformer(baseProps);
+    const result = transformer.transformValue('{{ref:/MyResource}}');
+    expect(result).toBeDefined();
+    expect(typeof result).toBe('string');
+  });
+
+  test('handles ref: with nested path', () => {
+    const transformer = new MdaaConfigRefValueTransformer(baseProps);
+    const result = transformer.transformValue('{{ref:Parent/Child}}');
+    expect(result).toBeDefined();
+  });
+
+  test('handles ssm-domain ref with naming', () => {
+    const mockNaming = {
+      ssmDomainPath: jest.fn().mockReturnValue('/test/domain/path'),
+    };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const transformer = new MdaaConfigRefValueTransformer({ ...baseProps, naming: mockNaming as any });
+    const result = transformer.transformValue('{{ssm-domain:param}}');
+    expect(result).toBe('{{resolve:ssm:/test/domain/path}}');
+    expect(mockNaming.ssmDomainPath).toHaveBeenCalledWith('param');
+  });
+
+  test('handles ssm-env ref with naming', () => {
+    const mockNaming = {
+      ssmEnvPath: jest.fn().mockReturnValue('/test/env/path'),
+    };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const transformer = new MdaaConfigRefValueTransformer({ ...baseProps, naming: mockNaming as any });
+    const result = transformer.transformValue('{{ssm-env:param}}');
+    expect(result).toBe('{{resolve:ssm:/test/env/path}}');
+    expect(mockNaming.ssmEnvPath).toHaveBeenCalledWith('param');
+  });
+
+  test('handles ssm-org ref with leading slash', () => {
+    const mockNaming = {
+      ssmOrgPath: jest.fn().mockReturnValue('/test/org/path'),
+    };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const transformer = new MdaaConfigRefValueTransformer({ ...baseProps, naming: mockNaming as any });
+    const result = transformer.transformValue('{{ssm-org:/param}}');
+    expect(result).toBe('{{resolve:ssm:/test/org/path}}');
+    expect(mockNaming.ssmOrgPath).toHaveBeenCalledWith('param');
+  });
+
+  test('handles resolve:ssm with ARN path', () => {
+    const stack = new Stack();
+    const transformer = new MdaaConfigRefValueTransformer({ ...baseProps, scope: stack });
+    const result = transformer.transformValue('{{resolve:ssm:arn:aws:ssm:us-east-1:123456789012:parameter/test}}');
+    expect(result).toBeDefined();
+  });
+
+  test('throws when getSsmValue called without scope', () => {
+    const transformer = new MdaaConfigRefValueTransformer(baseProps);
+    expect(() => transformer.transformValue('{{resolve:ssm:/test/param}}')).toThrow(
+      'Unable to resolve ssm param outside of a Construct',
+    );
+  });
+});

package/node_modules/@aws-mdaa/config/test/ssm-ref-transformer.test.d.ts

@@ -0,0 +1,5 @@
+/*!
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/node_modules/@aws-mdaa/config/test/ssm-ref-transformer.test.js

@@ -0,0 +1,66 @@
+"use strict";
+/*!
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const lib_1 = require("../lib");
+describe('MdaaConfigSSMValueTransformer', () => {
+    let transformer;
+    beforeEach(() => {
+        transformer = new lib_1.MdaaConfigSSMValueTransformer();
+    });
+    test('transforms ssm: prefix to resolve:ssm format', () => {
+        const result = transformer.transformValue('ssm:/my/param/name', 'some/path');
+        expect(result).toBe('{{resolve:ssm:/my/param/name}}');
+    });
+    test('handles whitespace after ssm: prefix', () => {
+        const result = transformer.transformValue('ssm:  /my/param/name', 'some/path');
+        expect(result).toBe('{{resolve:ssm:/my/param/name}}');
+    });
+    test('returns unchanged value without ssm: prefix', () => {
+        const result = transformer.transformValue('plain-value', 'some/path');
+        expect(result).toBe('plain-value');
+    });
+    test('returns unchanged value for empty string', () => {
+        const result = transformer.transformValue('', 'some/path');
+        expect(result).toBe('');
+    });
+    test('ignores ssm: values in policyDocument/Statement/Action path', () => {
+        const result = transformer.transformValue('ssm:GetParameter', 'policyDocument/Statement/Action');
+        expect(result).toBe('ssm:GetParameter');
+    });
+    test('ignores ssm: values in policyDocument/Statement/Action path (case insensitive)', () => {
+        const result = transformer.transformValue('ssm:GetParameter', 'PolicyDocument/Statement/ACTION');
+        expect(result).toBe('ssm:GetParameter');
+    });
+    test('ignores ssm: values when path ends with policyDocument/Statement/Action', () => {
+        const result = transformer.transformValue('ssm:PutParameter', 'some/nested/policyDocument/Statement/Action');
+        expect(result).toBe('ssm:PutParameter');
+    });
+    test('transforms ssm: values when path contains but does not end with ignored path', () => {
+        const result = transformer.transformValue('ssm:/my/param', 'policyDocument/Statement/Action/something');
+        expect(result).toBe('{{resolve:ssm:/my/param}}');
+    });
+    test('transforms ssm: values for non-ignored paths', () => {
+        const result = transformer.transformValue('ssm:/config/database/host', 'resources/database/config');
+        expect(result).toBe('{{resolve:ssm:/config/database/host}}');
+    });
+    test('handles ssm: prefix with no additional content', () => {
+        const result = transformer.transformValue('ssm:', 'some/path');
+        expect(result).toBe('{{resolve:ssm:}}');
+    });
+    test('does not transform values that contain ssm: but do not start with it', () => {
+        const result = transformer.transformValue('prefix-ssm:/param', 'some/path');
+        expect(result).toBe('prefix-ssm:/param');
+    });
+    test('handles complex SSM parameter paths', () => {
+        const result = transformer.transformValue('ssm:/org/env/domain/module/param-name', 'config/settings');
+        expect(result).toBe('{{resolve:ssm:/org/env/domain/module/param-name}}');
+    });
+    test('handles SSM parameter with special characters', () => {
+        const result = transformer.transformValue('ssm:/my-param_name.v1', 'some/path');
+        expect(result).toBe('{{resolve:ssm:/my-param_name.v1}}');
+    });
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3NtLXJlZi10cmFuc2Zvcm1lci50ZXN0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsic3NtLXJlZi10cmFuc2Zvcm1lci50ZXN0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQTs7O0dBR0c7O0FBRUgsZ0NBQXVEO0FBRXZELFFBQVEsQ0FBQywrQkFBK0IsRUFBRSxHQUFHLEVBQUU7SUFDN0MsSUFBSSxXQUEwQyxDQUFDO0lBRS9DLFVBQVUsQ0FBQyxHQUFHLEVBQUU7UUFDZCxXQUFXLEdBQUcsSUFBSSxtQ0FBNkIsRUFBRSxDQUFDO0lBQ3BELENBQUMsQ0FBQyxDQUFDO0lBRUgsSUFBSSxDQUFDLDhDQUE4QyxFQUFFLEdBQUcsRUFBRTtRQUN4RCxNQUFNLE1BQU0sR0FBRyxXQUFXLENBQUMsY0FBYyxDQUFDLG9CQUFvQixFQUFFLFdBQVcsQ0FBQyxDQUFDO1FBQzdFLE1BQU0sQ0FBQyxNQUFNLENBQUMsQ0FBQyxJQUFJLENBQUMsZ0NBQWdDLENBQUMsQ0FBQztJQUN4RCxDQUFDLENBQUMsQ0FBQztJQUVILElBQUksQ0FBQyxzQ0FBc0MsRUFBRSxHQUFHLEVBQUU7UUFDaEQsTUFBTSxNQUFNLEdBQUcsV0FBVyxDQUFDLGNBQWMsQ0FBQyxzQkFBc0IsRUFBRSxXQUFXLENBQUMsQ0FBQztRQUMvRSxNQUFNLENBQUMsTUFBTSxDQUFDLENBQUMsSUFBSSxDQUFDLGdDQUFnQyxDQUFDLENBQUM7SUFDeEQsQ0FBQyxDQUFDLENBQUM7SUFFSCxJQUFJLENBQUMsNkNBQTZDLEVBQUUsR0FBRyxFQUFFO1FBQ3ZELE1BQU0sTUFBTSxHQUFHLFdBQVcsQ0FBQyxjQUFjLENBQUMsYUFBYSxFQUFFLFdBQVcsQ0FBQyxDQUFDO1FBQ3RFLE1BQU0sQ0FBQyxNQUFNLENBQUMsQ0FBQyxJQUFJLENBQUMsYUFBYSxDQUFDLENBQUM7SUFDckMsQ0FBQyxDQUFDLENBQUM7SUFFSCxJQUFJLENBQUMsMENBQTBDLEVBQUUsR0FBRyxFQUFFO1FBQ3BELE1BQU0sTUFB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QUMsQ0FBQyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyohXG4gKiBDb3B5cmlnaHQgQW1hem9uLmNvbSwgSW5jLiBvciBpdHMgYWZmaWxpYXRlcy4gQWxsIFJpZ2h0cyBSZXNlcnZlZC5cbiAqIFNQRFgtTGljZW5zZS1JZGVudGlmaWVyOiBBcGFjaGUtMi4wXG4gKi9cblxuaW1wb3J0IHsgTWRhYUNvbmZpZ1NTTVZhbHVlVHJhbnNmb3JtZXIgfSBmcm9tICcuLi9saWInO1xuXG5kZXNjcmliZSgnTWRhYUNvbmZpZ1NTTVZhbHVlVHJhbnNmb3JtZXInLCAoKSA9PiB7XG4gIGxldCB0cmFuc2Zvcm1lcjogTWRhYUNvbmZpZ1NTTVZhbHVlVHJhbnNmb3JtZXI7XG5cbiAgYmVmb3JlRWFjaCgoKSA9PiB7XG4gICAgdHJhbnNmb3JtZXIgPSBuZXcgTWRhYUNvbmZpZ1NTTVZhbHVlVHJhbnNmb3JtZXIoKTtcbiAgfSk7XG5cbiAgdGVzdCgndHJhbnNmb3JtcyBzc206IHByZWZpeCB0byByZXNvbHZlOnNzbSBmb3JtYXQnLCAoKSA9PiB7XG4gICAgY29uc3QgcmVzdWx0ID0gdHJhbnNmb3JtZXIudHJhbnNmb3JtVmFsdWUoJ3NzbTovbXkvcGFyYW0vbmFtZScsICdzb21lL3BhdGgnKTtcbiAgICBleHBlY3QocmVzdWx0KS50b0JlKCd7e3Jlc29sdmU6c3NtOi9teS9wYXJhbS9uYW1lfX0nKTtcbiAgfSk7XG5cbiAgdGVzdCgnaGFuZGxlcyB3aGl0ZXNwYWNlIGFmdGVyIHNzbTogcHJlZml4JywgKCkgPT4ge1xuICAgIGNvbnN0IHJlc3VsdCA9IHRyYW5zZm9ybWVyLnRyYW5zZm9ybVZhbHVlKCdzc206ICAvbXkvcGFyYW0vbmFtZScsICdzb21lL3BhdGgnKTtcbiAgICBleHBlY3QocmVzdWx0KS50b0JlKCd7e3Jlc29sdmU6c3NtOi9teS9wYXJhbS9uYW1lfX0nKTtcbiAgfSk7XG5cbiAgdGVzdCgncmV0dXJucyB1bmNoYW5nZWQgdmFsdWUgd2l0aG91dCBzc206IHByZWZpeCcsICgpID0+IHtcbiAgICBjb25zdCByZXN1bHQgPSB0cmFuc2Zvcm1lci50cmFuc2Zvcm1WYWx1ZSgncGxhaW4tdmFsdWUnLCAnc29tZS9wYXRoJyk7XG4gICAgZXhwZWN0KHJlc3VsdCkudG9CZSgncGxhaW4tdmFsdWUnKTtcbiAgfSk7XG5cbiAgdGVzdCgncmV0dXJucyB1bmNoYW5nZWQgdmFsdWUgZm9yIGVtcHR5IHN0cmluZycsICgpID0+IHtcbiAgICBjb25zdCByZXN1bHQgPSB0cmFuc2Zvcm1lci50cmFuc2Zvcm1WYWx1ZSgnJywgJ3NvbWUvcGF0aCcpO1xuICAgIGV4cGVjdChyZXN1bHQpLnRvQmUoJycpO1xuICB9KTtcblxuICB0ZXN0KCdpZ25vcmVzIHNzbTogdmFsdWVzIGluIHBvbGljeURvY3VtZW50L1N0YXRlbWVudC9BY3Rpb24gcGF0aCcsICgpID0+IHtcbiAgICBjb25zdCByZXN1bHQgPSB0cmFuc2Zvcm1lci50cmFuc2Zvcm1WYWx1ZSgnc3NtOkdldFBhcmFtZXRlcicsICdwb2xpY3lEb2N1bWVudC9TdGF0ZW1lbnQvQWN0aW9uJyk7XG4gICAgZXhwZWN0KHJlc3VsdCkudG9CZSgnc3NtOkdldFBhcmFtZXRlcicpO1xuICB9KTtcblxuICB0ZXN0KCdpZ25vcmVzIHNzbTogdmFsdWVzIGluIHBvbGljeURvY3VtZW50L1N0YXRlbWVudC9BY3Rpb24gcGF0aCAoY2FzZSBpbnNlbnNpdGl2ZSknLCAoKSA9PiB7XG4gICAgY29uc3QgcmVzdWx0ID0gdHJhbnNmb3JtZXIudHJhbnNmb3JtVmFsdWUoJ3NzbTpHZXRQYXJhbWV0ZXInLCAnUG9saWN5RG9jdW1lbnQvU3RhdGVtZW50L0FDVElPTicpO1xuICAgIGV4cGVjdChyZXN1bHQpLnRvQmUoJ3NzbTpHZXRQYXJhbWV0ZXInKTtcbiAgfSk7XG5cbiAgdGVzdCgnaWdub3JlcyBzc206IHZhbHVlcyB3aGVuIHBhdGggZW5kcyB3aXRoIHBvbGljeURvY3VtZW50L1N0YXRlbWVudC9BY3Rpb24nLCAoKSA9PiB7XG4gICAgY29uc3QgcmVzdWx0ID0gdHJhbnNmb3JtZXIudHJhbnNmb3JtVmFsdWUoJ3NzbTpQdXRQYXJhbWV0ZXInLCAnc29tZS9uZXN0ZWQvcG9saWN5RG9jdW1lbnQvU3RhdGVtZW50L0FjdGlvbicpO1xuICAgIGV4cGVjdChyZXN1bHQpLnRvQmUoJ3NzbTpQdXRQYXJhbWV0ZXInKTtcbiAgfSk7XG5cbiAgdGVzdCgndHJhbnNmb3JtcyBzc206IHZhbHVlcyB3aGVuIHBhdGggY29udGFpbnMgYnV0IGRvZXMgbm90IGVuZCB3aXRoIGlnbm9yZWQgcGF0aCcsICgpID0+IHtcbiAgICBjb25zdCByZXN1bHQgPSB0cmFuc2Zvcm1lci50cmFuc2Zvcm1WYWx1ZSgnc3NtOi9teS9wYXJhbScsICdwb2xpY3lEb2N1bWVudC9TdGF0ZW1lbnQvQWN0aW9uL3NvbWV0aGluZycpO1xuICAgIGV4cGVjdChyZXN1bHQpLnRvQmUoJ3t7cmVzb2x2ZTpzc206L215L3BhcmFtfX0nKTtcbiAgfSk7XG5cbiAgdGVzdCgndHJhbnNmb3JtcyBzc206IHZhbHVlcyBmb3Igbm9uLWlnbm9yZWQgcGF0aHMnLCAoKSA9PiB7XG4gICAgY29uc3QgcmVzdWx0ID0gdHJhbnNmb3JtZXIudHJhbnNmb3JtVmFsdWUoJ3NzbTovY29uZmlnL2RhdGFiYXNlL2hvc3QnLCAncmVzb3VyY2VzL2RhdGFiYXNlL2NvbmZpZycpO1xuICAgIGV4cGVjdChyZXN1bHQpLnRvQmUoJ3t7cmVzb2x2ZTpzc206L2NvbmZpZy9kYXRhYmFzZS9ob3N0fX0nKTtcbiAgfSk7XG5cbiAgdGVzdCgnaGFuZGxlcyBzc206IHByZWZpeCB3aXRoIG5vIGFkZGl0aW9uYWwgY29udGVudCcsICgpID0+IHtcbiAgICBjb25zdCByZXN1bHQgPSB0cmFuc2Zvcm1lci50cmFuc2Zvcm1WYWx1ZSgnc3NtOicsICdzb21lL3BhdGgnKTtcbiAgICBleHBlY3QocmVzdWx0KS50b0JlKCd7e3Jlc29sdmU6c3NtOn19Jyk7XG4gIH0pO1xuXG4gIHRlc3QoJ2RvZXMgbm90IHRyYW5zZm9ybSB2YWx1ZXMgdGhhdCBjb250YWluIHNzbTogYnV0IGRvIG5vdCBzdGFydCB3aXRoIGl0JywgKCkgPT4ge1xuICAgIGNvbnN0IHJlc3VsdCA9IHRyYW5zZm9ybWVyLnRyYW5zZm9ybVZhbHVlKCdwcmVmaXgtc3NtOi9wYXJhbScsICdzb21lL3BhdGgnKTtcbiAgICBleHBlY3QocmVzdWx0KS50b0JlKCdwcmVmaXgtc3NtOi9wYXJhbScpO1xuICB9KTtcblxuICB0ZXN0KCdoYW5kbGVzIGNvbXBsZXggU1NNIHBhcmFtZXRlciBwYXRocycsICgpID0+IHtcbiAgICBjb25zdCByZXN1bHQgPSB0cmFuc2Zvcm1lci50cmFuc2Zvcm1WYWx1ZSgnc3NtOi9vcmcvZW52L2RvbWFpbi9tb2R1bGUvcGFyYW0tbmFtZScsICdjb25maWcvc2V0dGluZ3MnKTtcbiAgICBleHBlY3QocmVzdWx0KS50b0JlKCd7e3Jlc29sdmU6c3NtOi9vcmcvZW52L2RvbWFpbi9tb2R1bGUvcGFyYW0tbmFtZX19Jyk7XG4gIH0pO1xuXG4gIHRlc3QoJ2hhbmRsZXMgU1NNIHBhcmFtZXRlciB3aXRoIHNwZWNpYWwgY2hhcmFjdGVycycsICgpID0+IHtcbiAgICBjb25zdCByZXN1bHQgPSB0cmFuc2Zvcm1lci50cmFuc2Zvcm1WYWx1ZSgnc3NtOi9teS1wYXJhbV9uYW1lLnYxJywgJ3NvbWUvcGF0aCcpO1xuICAgIGV4cGVjdChyZXN1bHQpLnRvQmUoJ3t7cmVzb2x2ZTpzc206L215LXBhcmFtX25hbWUudjF9fScpO1xuICB9KTtcbn0pO1xuIl19

package/node_modules/@aws-mdaa/config/test/ssm-ref-transformer.test.ts

@@ -0,0 +1,79 @@
+/*!
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { MdaaConfigSSMValueTransformer } from '../lib';
+
+describe('MdaaConfigSSMValueTransformer', () => {
+  let transformer: MdaaConfigSSMValueTransformer;
+
+  beforeEach(() => {
+    transformer = new MdaaConfigSSMValueTransformer();
+  });
+
+  test('transforms ssm: prefix to resolve:ssm format', () => {
+    const result = transformer.transformValue('ssm:/my/param/name', 'some/path');
+    expect(result).toBe('{{resolve:ssm:/my/param/name}}');
+  });
+
+  test('handles whitespace after ssm: prefix', () => {
+    const result = transformer.transformValue('ssm:  /my/param/name', 'some/path');
+    expect(result).toBe('{{resolve:ssm:/my/param/name}}');
+  });
+
+  test('returns unchanged value without ssm: prefix', () => {
+    const result = transformer.transformValue('plain-value', 'some/path');
+    expect(result).toBe('plain-value');
+  });
+
+  test('returns unchanged value for empty string', () => {
+    const result = transformer.transformValue('', 'some/path');
+    expect(result).toBe('');
+  });
+
+  test('ignores ssm: values in policyDocument/Statement/Action path', () => {
+    const result = transformer.transformValue('ssm:GetParameter', 'policyDocument/Statement/Action');
+    expect(result).toBe('ssm:GetParameter');
+  });
+
+  test('ignores ssm: values in policyDocument/Statement/Action path (case insensitive)', () => {
+    const result = transformer.transformValue('ssm:GetParameter', 'PolicyDocument/Statement/ACTION');
+    expect(result).toBe('ssm:GetParameter');
+  });
+
+  test('ignores ssm: values when path ends with policyDocument/Statement/Action', () => {
+    const result = transformer.transformValue('ssm:PutParameter', 'some/nested/policyDocument/Statement/Action');
+    expect(result).toBe('ssm:PutParameter');
+  });
+
+  test('transforms ssm: values when path contains but does not end with ignored path', () => {
+    const result = transformer.transformValue('ssm:/my/param', 'policyDocument/Statement/Action/something');
+    expect(result).toBe('{{resolve:ssm:/my/param}}');
+  });
+
+  test('transforms ssm: values for non-ignored paths', () => {
+    const result = transformer.transformValue('ssm:/config/database/host', 'resources/database/config');
+    expect(result).toBe('{{resolve:ssm:/config/database/host}}');
+  });
+
+  test('handles ssm: prefix with no additional content', () => {
+    const result = transformer.transformValue('ssm:', 'some/path');
+    expect(result).toBe('{{resolve:ssm:}}');
+  });
+
+  test('does not transform values that contain ssm: but do not start with it', () => {
+    const result = transformer.transformValue('prefix-ssm:/param', 'some/path');
+    expect(result).toBe('prefix-ssm:/param');
+  });
+
+  test('handles complex SSM parameter paths', () => {
+    const result = transformer.transformValue('ssm:/org/env/domain/module/param-name', 'config/settings');
+    expect(result).toBe('{{resolve:ssm:/org/env/domain/module/param-name}}');
+  });
+
+  test('handles SSM parameter with special characters', () => {
+    const result = transformer.transformValue('ssm:/my-param_name.v1', 'some/path');
+    expect(result).toBe('{{resolve:ssm:/my-param_name.v1}}');
+  });
+});