@aligent/microservice-util-lib 0.2.1 → 1.0.0

package/dist/getAwsIdFromArn/getAwsIdFromArn.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Get the AWS ID from its resource ARN
+ * @param resourceArn the ARN of the AWS resource
+ * @returns the ID (if present in the ARN) of the AWS resource/execution
+ * @throws when the provided ARN is empty
+ * @example
+ * ```ts
+ * getAwsIdFromArn('arn:aws:states:ap-southeast-2:123123123:execution:prj-int-entity-ac-dc-dev-machine-name:this-is-the-id')
+ * ```
+ */
+declare const getAwsIdFromArn: (resourceArn: string) => string;
+export default getAwsIdFromArn;

package/dist/getAwsIdFromArn/getAwsIdFromArn.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Get the AWS ID from its resource ARN
+ * @param resourceArn the ARN of the AWS resource
+ * @returns the ID (if present in the ARN) of the AWS resource/execution
+ * @throws when the provided ARN is empty
+ * @example
+ * ```ts
+ * getAwsIdFromArn('arn:aws:states:ap-southeast-2:123123123:execution:prj-int-entity-ac-dc-dev-machine-name:this-is-the-id')
+ * ```
+ */
+var getAwsIdFromArn = function (resourceArn) {
+    if (resourceArn.length === 0) {
+        throw new Error('Received an empty resourceArn, unable to get an ID.');
+    }
+    var startIdx = resourceArn.lastIndexOf(':') + 1;
+    return resourceArn.substring(startIdx);
+};
+exports.default = getAwsIdFromArn;
+//# sourceMappingURL=getAwsIdFromArn.js.map

package/dist/getAwsIdFromArn/getAwsIdFromArn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAwsIdFromArn.js","sourceRoot":"","sources":["../../src/getAwsIdFromArn/getAwsIdFromArn.ts"],"names":[],"mappings":";;AAAA;;;;;;;;;GASG;AACH,IAAM,eAAe,GAAG,UAAC,WAAmB;IAC1C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE;QAC5B,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;KACxE;IACD,IAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClD,OAAO,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AACzC,CAAC,CAAC;AACF,kBAAe,eAAe,CAAC"}

package/dist/getAwsIdFromArn/getAwsIdFromArn.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/getAwsIdFromArn/getAwsIdFromArn.test.js

@@ -0,0 +1,20 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var getAwsIdFromArn_1 = __importDefault(require("./getAwsIdFromArn"));
+describe('getAWsIdFromArn', function () {
+    it('should return the short execution ID when given a valid ARN', function () {
+        expect((0, getAwsIdFromArn_1.default)('arn:aws:states:ap-southeast-2:123123123:execution:prj-int-entity-ac-dc-dev-machine-name:this-is-the-id')).toEqual('this-is-the-id');
+    });
+    it('should throw an error when an empty string is given', function () {
+        expect(function () {
+            (0, getAwsIdFromArn_1.default)('');
+        }).toThrowError('Received an empty resourceArn, unable to get an ID.');
+    });
+    it('returns the provided string where it is assumed to be already a short ID', function () {
+        expect((0, getAwsIdFromArn_1.default)('my-execution')).toEqual('my-execution');
+    });
+});
+//# sourceMappingURL=getAwsIdFromArn.test.js.map

package/dist/getAwsIdFromArn/getAwsIdFromArn.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAwsIdFromArn.test.js","sourceRoot":"","sources":["../../src/getAwsIdFromArn/getAwsIdFromArn.test.ts"],"names":[],"mappings":";;;;;AAAA,sEAAgD;AAEhD,QAAQ,CAAC,iBAAiB,EAAE;IAC1B,EAAE,CAAC,6DAA6D,EAAE;QAChE,MAAM,CACJ,IAAA,yBAAe,EACb,wGAAwG,CACzG,CACF,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE;QACxD,MAAM,CAAC;YACL,IAAA,yBAAe,EAAC,EAAE,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC,YAAY,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAC3E;QACE,MAAM,CAAC,IAAA,yBAAe,EAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -4,4 +4,5 @@ import retryWrapper, { RetryConfig } from './retryWrapper/retryWrapper';
 import fetchSsmParams from './fetchSsmParams/fetchSsmParams';
 import S3Dao from './s3/s3';
 import hasDefinedProperties from './hasPropertiesDefined/hasPropertiesDefined';
-export { chunkBy, remap, Remap, ObjectMap, retryWrapper, RetryConfig, fetchSsmParams, S3Dao, hasDefinedProperties };
+import getAwsIdFromArn from './getAwsIdFromArn/getAwsIdFromArn';
+export { chunkBy, remap, Remap, ObjectMap, retryWrapper, RetryConfig, fetchSsmParams, S3Dao, hasDefinedProperties, getAwsIdFromArn };

package/dist/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasDefinedProperties = exports.S3Dao = exports.fetchSsmParams = exports.retryWrapper = exports.remap = exports.chunkBy = void 0;
+exports.getAwsIdFromArn = exports.hasDefinedProperties = exports.S3Dao = exports.fetchSsmParams = exports.retryWrapper = exports.remap = exports.chunkBy = void 0;
 var chunkBy_1 = __importDefault(require("./chunkBy/chunkBy"));
 exports.chunkBy = chunkBy_1.default;
 var remap_1 = __importDefault(require("./remap/remap"));
@@ -16,4 +16,6 @@ var s3_1 = __importDefault(require("./s3/s3"));
 exports.S3Dao = s3_1.default;
 var hasPropertiesDefined_1 = __importDefault(require("./hasPropertiesDefined/hasPropertiesDefined"));
 exports.hasDefinedProperties = hasPropertiesDefined_1.default;
+var getAwsIdFromArn_1 = __importDefault(require("./getAwsIdFromArn/getAwsIdFromArn"));
+exports.getAwsIdFromArn = getAwsIdFromArn_1.default;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,8DAAwC;AAQtC,kBARK,iBAAO,CAQL;AAPT,wDAAwD;AAQtD,gBARK,eAAK,CAQL;AAPP,6EAAwE;AAUtE,uBAVK,sBAAY,CAUL;AATd,mFAA6D;AAW3D,yBAXK,wBAAc,CAWL;AAVhB,+CAA4B;AAW1B,gBAXK,YAAK,CAWL;AAVP,qGAA+E;AAW7E,+BAXK,8BAAoB,CAWL"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,8DAAwC;AAStC,kBATK,iBAAO,CASL;AART,wDAAwD;AAStD,gBATK,eAAK,CASL;AARP,6EAAwE;AAWtE,uBAXK,sBAAY,CAWL;AAVd,mFAA6D;AAY3D,yBAZK,wBAAc,CAYL;AAXhB,+CAA4B;AAY1B,gBAZK,YAAK,CAYL;AAXP,qGAA+E;AAY7E,+BAZK,8BAAoB,CAYL;AAXtB,sFAAgE;AAY9D,0BAZK,yBAAe,CAYL"}

package/dist/s3/s3.d.ts

@@ -34,10 +34,7 @@ declare class S3Dao {
     fetchChunks<T>(chunks: GetObjectCommandInput[]): AsyncGenerator<{
         chunk: T;
         s3Object: GetObjectCommandInput;
-    }, {
-        chunk: T;
-        s3Object: GetObjectCommandInput;
-    }, unknown>;
+    }, Awaited<T>, unknown>;
     /**
      * Delete an object from the S3 bucket
      * @param objectDetails the object to delete

package/dist/s3/s3.js

@@ -124,13 +124,16 @@ var S3Dao = /** @class */ (function () {
      */
     S3Dao.prototype.fetchData = function (objectDetails) {
         return __awaiter(this, void 0, void 0, function () {
-            var data;
+            var data, body;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0: return [4 /*yield*/, this.s3.send(new client_s3_1.GetObjectCommand(objectDetails))];
                     case 1:
                         data = _a.sent();
-                        return [2 /*return*/, JSON.parse(data.Body.toString())];
+                        return [4 /*yield*/, data.Body.transformToString()];
+                    case 2:
+                        body = _a.sent();
+                        return [2 /*return*/, JSON.parse(body)];
                 }
             });
         });
@@ -148,7 +151,7 @@ var S3Dao = /** @class */ (function () {
                         i = 0;
                         _a.label = 1;
                     case 1:
-                        if (!(i < chunks.length)) return [3 /*break*/, 8];
+                        if (!(i < chunks.length)) return [3 /*break*/, 6];
                         return [4 /*yield*/, __await(this.fetchData(chunks[i]))];
                     case 2:
                         chunk = _a.sent();
@@ -156,18 +159,16 @@ var S3Dao = /** @class */ (function () {
                             chunk: chunk,
                             s3Object: chunks[i]
                         };
-                        if (!(i === chunks.length - 1)) return [3 /*break*/, 4];
                         return [4 /*yield*/, __await(response)];
-                    case 3: return [2 /*return*/, _a.sent()];
-                    case 4: return [4 /*yield*/, __await(response)];
-                    case 5: return [4 /*yield*/, _a.sent()];
-                    case 6:
+                    case 3: return [4 /*yield*/, _a.sent()];
+                    case 4:
                         _a.sent();
-                        _a.label = 7;
-                    case 7:
+                        _a.label = 5;
+                    case 5:
                         i++;
                         return [3 /*break*/, 1];
-                    case 8: return [2 /*return*/];
+                    case 6: return [4 /*yield*/, __await(null)];
+                    case 7: return [2 /*return*/, _a.sent()];
                 }
             });
         });

package/dist/s3/s3.js.map

@@ -1 +1 @@
-{"version":3,"file":"s3.js","sourceRoot":"","sources":["../../src/s3/s3.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAM4B;AAC5B,4DAA+B;AAC/B,+DAAyC;AAEzC,4CAA4C;AAC5C;IAIE;;OAEG;IACH,eAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,GAAG,IAAI,oBAAQ,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACU,yBAAS,GAAtB,UACE,IAAO,EACP,IAAa;;;;;;wBAEb,IAAI,OAAO,IAAI,KAAK,WAAW,EAAE;4BAC/B,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;yBACtC;wBAEK,SAAS,GAA0B;4BACvC,MAAM,EAAE,IAAI,CAAC,MAAM;4BACnB,GAAG,EAAE,IAAI,IAAI,IAAA,qBAAI,EAAC,IAAW,CAAC;yBAC/B,CAAC;wBAEF,qBAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,4BAAgB,uBAClC,SAAS,KACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAC1B,CAAC,EAAA;;wBAHH,SAGG,CAAC;wBAEJ,sBAAO,SAAS,EAAC;;;;KAClB;IAED;;;;;OAKG;IACU,4BAAY,GAAzB,UAA2C,IAAO,EAAE,SAAiB;;;;;gBAC7D,MAAM,GAAG,IAAA,iBAAO,EAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBACxC,sBAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,UAAA,KAAK,IAAI,OAAA,KAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAArB,CAAqB,CAAC,CAAC,EAAC;;;KAChE;IAED;;;;OAIG;IACU,yBAAS,GAAtB,UAA0B,aAAoC;;;;;4BAC/C,qBAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,4BAAgB,CAAC,aAAa,CAAC,CAAC,EAAA;;wBAA9D,IAAI,GAAG,SAAuD;wBACpE,sBAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAC;;;;KACzC;IAED;;;OAGG;IACW,2BAAW,GAAzB,UAA6B,MAA+B;;;;;;wBACjD,CAAC,GAAG,CAAC;;;6BAAE,CAAA,CAAC,GAAG,MAAM,CAAC,MAAM,CAAA;wBACd,6BAAM,IAAI,CAAC,SAAS,CAAI,MAAM,CAAC,CAAC,CAAC,CAAC,GAAA;;wBAA7C,KAAK,GAAM,SAAkC;wBAE7C,QAAQ,GAAG;4BACf,KAAK,OAAA;4BACL,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;yBACpB,CAAC;6BAEE,CAAA,CAAC,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC,CAAA,EAAvB,wBAAuB;qDAClB,QAAQ;4BAAf,iCAAgB;yDAEZ,QAAQ;4BAAd,gCAAc;;wBAAd,SAAc,CAAC;;;wBAXkB,CAAC,EAAE,CAAA;;;;;;KAavC;IAED;;;OAGG;IACU,0BAAU,GAAvB,UAAwB,aAAoC;;;gBAC1D,sBAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,+BAAmB,CAAC,aAAa,CAAC,CAAC,EAAC;;;KAC7D;IACH,YAAC;AAAD,CAAC,AAvFD,IAuFC;AAED,kBAAe,KAAK,CAAC"}
+{"version":3,"file":"s3.js","sourceRoot":"","sources":["../../src/s3/s3.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAM4B;AAC5B,4DAA+B;AAC/B,+DAAyC;AAEzC,4CAA4C;AAC5C;IAIE;;OAEG;IACH,eAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,GAAG,IAAI,oBAAQ,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACU,yBAAS,GAAtB,UACE,IAAO,EACP,IAAa;;;;;;wBAEb,IAAI,OAAO,IAAI,KAAK,WAAW,EAAE;4BAC/B,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;yBACtC;wBAEK,SAAS,GAA0B;4BACvC,MAAM,EAAE,IAAI,CAAC,MAAM;4BACnB,GAAG,EAAE,IAAI,IAAI,IAAA,qBAAI,EAAC,IAAW,CAAC;yBAC/B,CAAC;wBAEF,qBAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,4BAAgB,uBAClC,SAAS,KACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAC1B,CAAC,EAAA;;wBAHH,SAGG,CAAC;wBAEJ,sBAAO,SAAS,EAAC;;;;KAClB;IAED;;;;;OAKG;IACU,4BAAY,GAAzB,UAA2C,IAAO,EAAE,SAAiB;;;;;gBAC7D,MAAM,GAAG,IAAA,iBAAO,EAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBACxC,sBAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,UAAA,KAAK,IAAI,OAAA,KAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAArB,CAAqB,CAAC,CAAC,EAAC;;;KAChE;IAED;;;;OAIG;IACU,yBAAS,GAAtB,UAA0B,aAAoC;;;;;4BAC/C,qBAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,4BAAgB,CAAC,aAAa,CAAC,CAAC,EAAA;;wBAA9D,IAAI,GAAG,SAAuD;wBACvD,qBAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAA;;wBAA1C,IAAI,GAAG,SAAmC;wBAChD,sBAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAC;;;;KACzB;IAED;;;OAGG;IACW,2BAAW,GAAzB,UAA6B,MAA+B;;;;;;wBACjD,CAAC,GAAG,CAAC;;;6BAAE,CAAA,CAAC,GAAG,MAAM,CAAC,MAAM,CAAA;wBACd,6BAAM,IAAI,CAAC,SAAS,CAAI,MAAM,CAAC,CAAC,CAAC,CAAC,GAAA;;wBAA7C,KAAK,GAAM,SAAkC;wBAE7C,QAAQ,GAAG;4BACf,KAAK,OAAA;4BACL,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;yBACpB,CAAC;qDAEI,QAAQ;4BAAd,gCAAc;;wBAAd,SAAc,CAAC;;;wBARkB,CAAC,EAAE,CAAA;;yDAW/B,IAAS;4BAAhB,iCAAiB;;;;KAClB;IAED;;;OAGG;IACU,0BAAU,GAAvB,UAAwB,aAAoC;;;gBAC1D,sBAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,+BAAmB,CAAC,aAAa,CAAC,CAAC,EAAC;;;KAC7D;IACH,YAAC;AAAD,CAAC,AAvFD,IAuFC;AAED,kBAAe,KAAK,CAAC"}

package/dist/s3/s3.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/s3/s3.test.js

@@ -0,0 +1,126 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var s3_1 = __importDefault(require("./s3"));
+var client_s3_1 = require("@aws-sdk/client-s3");
+var aws_sdk_client_mock_1 = require("aws-sdk-client-mock");
+var util_stream_node_1 = require("@aws-sdk/util-stream-node");
+var stream_1 = require("stream");
+var s3Mock = (0, aws_sdk_client_mock_1.mockClient)(client_s3_1.S3Client);
+var Bucket = 'bucket_name';
+beforeEach(function () {
+    s3Mock.reset();
+});
+describe('fetchChunks', function () {
+    it('should yield all file contents in a for await ... of loop ', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var iterations, chunks, data, responses, s3, result, _a, _b, _c, response, e_1_1;
+        var _d, e_1, _e, _f;
+        return __generator(this, function (_g) {
+            switch (_g.label) {
+                case 0:
+                    iterations = [0, 1, 2, 3];
+                    chunks = iterations.map(function (n) { return ({
+                        Bucket: Bucket,
+                        Key: "file_".concat(n)
+                    }); });
+                    data = iterations.map(function (n) { return ({ value: n }); });
+                    responses = data.map(function (d) {
+                        var stream = new stream_1.Readable();
+                        stream.push(JSON.stringify(d));
+                        stream.push(null);
+                        return { Body: (0, util_stream_node_1.sdkStreamMixin)(stream) };
+                    });
+                    iterations.forEach(function (n) {
+                        s3Mock.on(client_s3_1.GetObjectCommand, chunks[n]).resolvesOnce(responses[n]);
+                    });
+                    s3 = new s3_1.default(Bucket);
+                    result = [];
+                    _g.label = 1;
+                case 1:
+                    _g.trys.push([1, 6, 7, 12]);
+                    _a = true, _b = __asyncValues(s3.fetchChunks(chunks));
+                    _g.label = 2;
+                case 2: return [4 /*yield*/, _b.next()];
+                case 3:
+                    if (!(_c = _g.sent(), _d = _c.done, !_d)) return [3 /*break*/, 5];
+                    _f = _c.value;
+                    _a = false;
+                    try {
+                        response = _f;
+                        result.push(response.chunk);
+                    }
+                    finally {
+                        _a = true;
+                    }
+                    _g.label = 4;
+                case 4: return [3 /*break*/, 2];
+                case 5: return [3 /*break*/, 12];
+                case 6:
+                    e_1_1 = _g.sent();
+                    e_1 = { error: e_1_1 };
+                    return [3 /*break*/, 12];
+                case 7:
+                    _g.trys.push([7, , 10, 11]);
+                    if (!(!_a && !_d && (_e = _b.return))) return [3 /*break*/, 9];
+                    return [4 /*yield*/, _e.call(_b)];
+                case 8:
+                    _g.sent();
+                    _g.label = 9;
+                case 9: return [3 /*break*/, 11];
+                case 10:
+                    if (e_1) throw e_1.error;
+                    return [7 /*endfinally*/];
+                case 11: return [7 /*endfinally*/];
+                case 12:
+                    expect(result).toEqual(data);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+});
+//# sourceMappingURL=s3.test.js.map

package/dist/s3/s3.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.test.js","sourceRoot":"","sources":["../../src/s3/s3.test.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAAyB;AACzB,gDAAgE;AAChE,2DAAiD;AACjD,8DAA2D;AAC3D,iCAAkC;AAGlC,IAAM,MAAM,GAAG,IAAA,gCAAU,EAAC,oBAAQ,CAAC,CAAC;AAEpC,IAAM,MAAM,GAAG,aAAa,CAAC;AAE7B,UAAU,CAAC;IACT,MAAM,CAAC,KAAK,EAAE,CAAC;AACjB,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE;IACtB,EAAE,CAAC,4DAA4D,EAAE;;;;;;oBACzD,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;oBAC1B,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,UAAA,CAAC,IAAI,OAAA,CAAC;wBAClC,MAAM,QAAA;wBACN,GAAG,EAAE,eAAQ,CAAC,CAAE;qBACjB,CAAC,EAHiC,CAGjC,CAAC,CAAC;oBACE,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,UAAA,CAAC,IAAI,OAAA,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAd,CAAc,CAAC,CAAC;oBAI3C,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,UAAA,CAAC;wBAC1B,IAAM,MAAM,GAAG,IAAI,iBAAQ,EAAE,CAAC;wBAC9B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;wBAC/B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBAClB,OAAO,EAAE,IAAI,EAAE,IAAA,iCAAc,EAAC,MAAM,CAAC,EAAE,CAAC;oBAC1C,CAAC,CAAC,CAAC;oBAEH,UAAU,CAAC,OAAO,CAAC,UAAA,CAAC;wBAClB,MAAM,CAAC,EAAE,CAAC,4BAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;oBACpE,CAAC,CAAC,CAAC;oBAEG,EAAE,GAAG,IAAI,YAAK,CAAC,MAAM,CAAC,CAAC;oBAEvB,MAAM,GAAG,EAAE,CAAC;;;;+BACW,KAAA,cAAA,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;;;;;oBAAtB,cAAsB;oBAAtB,WAAsB;;wBAAlC,QAAQ,KAAA,CAAA;wBACvB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;oBAG9B,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;;;;SAC9B,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/docs/classes/S3Dao.md

@@ -37,7 +37,7 @@ A data access object for an S3 bucket
 
 #### Defined in
 
-[s3/s3.ts:19](https://bitbucket.org/aligent/microservice-util-lib/src/e10251f/src/s3/s3.ts#lines-19)
+[s3/s3.ts:19](https://bitbucket.org/aligent/microservice-util-lib/src/5ba81bd/src/s3/s3.ts#lines-19)
 
 ## Properties
 
@@ -47,7 +47,7 @@ A data access object for an S3 bucket
 
 #### Defined in
 
-[s3/s3.ts:14](https://bitbucket.org/aligent/microservice-util-lib/src/e10251f/src/s3/s3.ts#lines-14)
+[s3/s3.ts:14](https://bitbucket.org/aligent/microservice-util-lib/src/5ba81bd/src/s3/s3.ts#lines-14)
 
 ___
 
@@ -57,7 +57,7 @@ ___
 
 #### Defined in
 
-[s3/s3.ts:13](https://bitbucket.org/aligent/microservice-util-lib/src/e10251f/src/s3/s3.ts#lines-13)
+[s3/s3.ts:13](https://bitbucket.org/aligent/microservice-util-lib/src/5ba81bd/src/s3/s3.ts#lines-13)
 
 ## Methods
 
@@ -79,13 +79,13 @@ Delete an object from the S3 bucket
 
 #### Defined in
 
-[s3/s3.ts:96](https://bitbucket.org/aligent/microservice-util-lib/src/e10251f/src/s3/s3.ts#lines-96)
+[s3/s3.ts:96](https://bitbucket.org/aligent/microservice-util-lib/src/5ba81bd/src/s3/s3.ts#lines-96)
 
 ___
 
 ### <a id="fetchchunks" name="fetchchunks"></a> fetchChunks
 
-▸ **fetchChunks**<`T`\>(`chunks`): `AsyncGenerator`<{ `chunk`: `T` ; `s3Object`: `GetObjectCommandInput`  }, { `chunk`: `T` ; `s3Object`: `GetObjectCommandInput`  }, `unknown`\>
+▸ **fetchChunks**<`T`\>(`chunks`): `AsyncGenerator`<{ `chunk`: `T` ; `s3Object`: `GetObjectCommandInput`  }, `Awaited`<`T`\>, `unknown`\>
 
 Generator to fetch chunked data, chunk by chunk
 
@@ -103,11 +103,11 @@ Generator to fetch chunked data, chunk by chunk
 
 #### Returns
 
-`AsyncGenerator`<{ `chunk`: `T` ; `s3Object`: `GetObjectCommandInput`  }, { `chunk`: `T` ; `s3Object`: `GetObjectCommandInput`  }, `unknown`\>
+`AsyncGenerator`<{ `chunk`: `T` ; `s3Object`: `GetObjectCommandInput`  }, `Awaited`<`T`\>, `unknown`\>
 
 #### Defined in
 
-[s3/s3.ts:76](https://bitbucket.org/aligent/microservice-util-lib/src/e10251f/src/s3/s3.ts#lines-76)
+[s3/s3.ts:77](https://bitbucket.org/aligent/microservice-util-lib/src/5ba81bd/src/s3/s3.ts#lines-77)
 
 ___
 
@@ -137,7 +137,7 @@ the body of the object
 
 #### Defined in
 
-[s3/s3.ts:67](https://bitbucket.org/aligent/microservice-util-lib/src/e10251f/src/s3/s3.ts#lines-67)
+[s3/s3.ts:67](https://bitbucket.org/aligent/microservice-util-lib/src/5ba81bd/src/s3/s3.ts#lines-67)
 
 ___
 
@@ -168,7 +168,7 @@ an array of objects which can be used to fetch the chunks
 
 #### Defined in
 
-[s3/s3.ts:57](https://bitbucket.org/aligent/microservice-util-lib/src/e10251f/src/s3/s3.ts#lines-57)
+[s3/s3.ts:57](https://bitbucket.org/aligent/microservice-util-lib/src/5ba81bd/src/s3/s3.ts#lines-57)
 
 ___
 
@@ -203,4 +203,4 @@ an object which can be used to fetch the data
 
 #### Defined in
 
-[s3/s3.ts:30](https://bitbucket.org/aligent/microservice-util-lib/src/e10251f/src/s3/s3.ts#lines-30)
+[s3/s3.ts:30](https://bitbucket.org/aligent/microservice-util-lib/src/5ba81bd/src/s3/s3.ts#lines-30)

package/docs/interfaces/RetryConfig.md

@@ -27,7 +27,7 @@ The amount to increase the delay by each retry (in ms)
 
 #### Defined in
 
-[retryWrapper/retryWrapper.ts:17](https://bitbucket.org/aligent/microservice-util-lib/src/e10251f/src/retryWrapper/retryWrapper.ts#lines-17)
+[retryWrapper/retryWrapper.ts:17](https://bitbucket.org/aligent/microservice-util-lib/src/5ba81bd/src/retryWrapper/retryWrapper.ts#lines-17)
 
 ___
 
@@ -43,7 +43,7 @@ The base delay between retries (in ms)
 
 #### Defined in
 
-[retryWrapper/retryWrapper.ts:12](https://bitbucket.org/aligent/microservice-util-lib/src/e10251f/src/retryWrapper/retryWrapper.ts#lines-12)
+[retryWrapper/retryWrapper.ts:12](https://bitbucket.org/aligent/microservice-util-lib/src/5ba81bd/src/retryWrapper/retryWrapper.ts#lines-12)
 
 ___
 
@@ -71,7 +71,7 @@ A callback to run before each retry
 
 #### Defined in
 
-[retryWrapper/retryWrapper.ts:24](https://bitbucket.org/aligent/microservice-util-lib/src/e10251f/src/retryWrapper/retryWrapper.ts#lines-24)
+[retryWrapper/retryWrapper.ts:24](https://bitbucket.org/aligent/microservice-util-lib/src/5ba81bd/src/retryWrapper/retryWrapper.ts#lines-24)
 
 ___
 
@@ -87,4 +87,4 @@ The number of retries to attempt after the first run
 
 #### Defined in
 
-[retryWrapper/retryWrapper.ts:7](https://bitbucket.org/aligent/microservice-util-lib/src/e10251f/src/retryWrapper/retryWrapper.ts#lines-7)
+[retryWrapper/retryWrapper.ts:7](https://bitbucket.org/aligent/microservice-util-lib/src/5ba81bd/src/retryWrapper/retryWrapper.ts#lines-7)

package/docs/modules.md

@@ -21,6 +21,7 @@
 
 - [chunkBy](modules.md#chunkby)
 - [fetchSsmParams](modules.md#fetchssmparams)
+- [getAwsIdFromArn](modules.md#getawsidfromarn)
 - [hasDefinedProperties](modules.md#hasdefinedproperties)
 - [remap](modules.md#remap-1)
 - [retryWrapper](modules.md#retrywrapper)
@@ -35,7 +36,7 @@ A list of keys to keys, with an optional transformer function
 
 #### Defined in
 
-[remap/remap.ts:15](https://bitbucket.org/aligent/microservice-util-lib/src/e10251f/src/remap/remap.ts#lines-15)
+[remap/remap.ts:15](https://bitbucket.org/aligent/microservice-util-lib/src/5ba81bd/src/remap/remap.ts#lines-15)
 
 ___
 
@@ -52,7 +53,7 @@ ___
 
 #### Defined in
 
-[remap/remap.ts:159](https://bitbucket.org/aligent/microservice-util-lib/src/e10251f/src/remap/remap.ts#lines-159)
+[remap/remap.ts:159](https://bitbucket.org/aligent/microservice-util-lib/src/5ba81bd/src/remap/remap.ts#lines-159)
 
 ## Functions
 
@@ -87,7 +88,7 @@ chunkBy([1, 2, 3, 4, 5, 6, 7], 2) // [[1, 2], [3, 4], [5, 6], [7]]
 
 #### Defined in
 
-[chunkBy/chunkBy.ts:10](https://bitbucket.org/aligent/microservice-util-lib/src/e10251f/src/chunkBy/chunkBy.ts#lines-10)
+[chunkBy/chunkBy.ts:10](https://bitbucket.org/aligent/microservice-util-lib/src/5ba81bd/src/chunkBy/chunkBy.ts#lines-10)
 
 ___
 
@@ -109,7 +110,7 @@ Fetch one SSM parameter
 
 #### Defined in
 
-[fetchSsmParams/fetchSsmParams.ts:14](https://bitbucket.org/aligent/microservice-util-lib/src/e10251f/src/fetchSsmParams/fetchSsmParams.ts#lines-14)
+[fetchSsmParams/fetchSsmParams.ts:14](https://bitbucket.org/aligent/microservice-util-lib/src/5ba81bd/src/fetchSsmParams/fetchSsmParams.ts#lines-14)
 
 ▸ **fetchSsmParams**(`...params`): `Promise`<`Parameter`[]\>
 
@@ -127,7 +128,41 @@ Fetch a list of SSM parameters
 
 #### Defined in
 
-[fetchSsmParams/fetchSsmParams.ts:21](https://bitbucket.org/aligent/microservice-util-lib/src/e10251f/src/fetchSsmParams/fetchSsmParams.ts#lines-21)
+[fetchSsmParams/fetchSsmParams.ts:21](https://bitbucket.org/aligent/microservice-util-lib/src/5ba81bd/src/fetchSsmParams/fetchSsmParams.ts#lines-21)
+
+___
+
+### <a id="getawsidfromarn" name="getawsidfromarn"></a> getAwsIdFromArn
+
+▸ **getAwsIdFromArn**(`resourceArn`): `string`
+
+Get the AWS ID from its resource ARN
+
+**`Throws`**
+
+when the provided ARN is empty
+
+**`Example`**
+
+```ts
+getAwsIdFromArn('arn:aws:states:ap-southeast-2:123123123:execution:prj-int-entity-ac-dc-dev-machine-name:this-is-the-id')
+```
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `resourceArn` | `string` | the ARN of the AWS resource |
+
+#### Returns
+
+`string`
+
+the ID (if present in the ARN) of the AWS resource/execution
+
+#### Defined in
+
+[getAwsIdFromArn/getAwsIdFromArn.ts:11](https://bitbucket.org/aligent/microservice-util-lib/src/5ba81bd/src/getAwsIdFromArn/getAwsIdFromArn.ts#lines-11)
 
 ___
 
@@ -173,7 +208,7 @@ obj is SimplifyIntersection<Required<Pick<T, K\>\> & Omit<T, K\>\>
 
 #### Defined in
 
-[hasPropertiesDefined/hasPropertiesDefined.ts:22](https://bitbucket.org/aligent/microservice-util-lib/src/e10251f/src/hasPropertiesDefined/hasPropertiesDefined.ts#lines-22)
+[hasPropertiesDefined/hasPropertiesDefined.ts:22](https://bitbucket.org/aligent/microservice-util-lib/src/5ba81bd/src/hasPropertiesDefined/hasPropertiesDefined.ts#lines-22)
 
 ___
 
@@ -240,7 +275,7 @@ the remapped object
 
 #### Defined in
 
-[remap/remap.ts:198](https://bitbucket.org/aligent/microservice-util-lib/src/e10251f/src/remap/remap.ts#lines-198)
+[remap/remap.ts:198](https://bitbucket.org/aligent/microservice-util-lib/src/5ba81bd/src/remap/remap.ts#lines-198)
 
 ___
 
@@ -278,4 +313,4 @@ retryWrapper(someAsyncFunction, {
 
 #### Defined in
 
-[retryWrapper/retryWrapper.ts:78](https://bitbucket.org/aligent/microservice-util-lib/src/e10251f/src/retryWrapper/retryWrapper.ts#lines-78)
+[retryWrapper/retryWrapper.ts:78](https://bitbucket.org/aligent/microservice-util-lib/src/5ba81bd/src/retryWrapper/retryWrapper.ts#lines-78)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aligent/microservice-util-lib",
-  "version": "0.2.1",
+  "version": "1.0.0",
   "description": "A set of utility functions for Aligent Microservices",
   "main": "dist/index.js",
   "scripts": {