@bitblit/ratchet-common 4.0.128-alpha → 4.0.130-alpha

package/lib/third-party/google/google-recaptcha-ratchet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-recaptcha-ratchet.js","sourceRoot":"","sources":["../../../src/third-party/google/google-recaptcha-ratchet.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,MAAM,aAAa,CAAC;AAChC,MAAa,sBAAsB;IACzB,MAAM,CAAU,iBAAiB,GAAW,mFAAmF,CAAC;IAEjI,MAAM,CAAC,KAAK,CAAC,oBAAoB,CACtC,SAAiB,EACjB,KAAa,EACb,UAA+E,KAAK;QAEpF,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;QACtD,IAAI,IAAI,GAAY,IAAI,CAAC;QAEzB,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE;YACpC,MAAM,CAAC,IAAI,CAAC,kDAAkD,EAAE,KAAK,CAAC,CAAC;YACvE,OAAO,IAAI,CAAC;SACb;QAED,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE,KAAK,CAAC,CAAC;QAC/D,IAAI,GAAG,GAAW,sBAAsB,CAAC,iBAAiB,CAAC;QAC3D,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3C,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI;YACF,MAAM,IAAI,GAAa,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;YAC1C,MAAM,IAAI,GAAQ,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YACpC,IAAI,GAAG,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC;SAC7B;QAAC,OAAO,GAAG,EAAE;YACZ,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC;YACrD,IAAI,GAAG,KAAK,CAAC;SACd;QACD,OAAO,IAAI,CAAC;IACd,CAAC;;SA7BU,sBAAsB"}

package/lib/third-party/google/google-recaptcha-ratchet.spec.js

@@ -0,0 +1,21 @@
+import { GoogleRecaptchaRatchet } from './google-recaptcha-ratchet.js';
+import { jest } from '@jest/globals';
+const fakeFetch = jest.fn((input, init) => Promise.resolve({
+    json: () => Promise.resolve({ success: true }),
+}));
+const fakeFailFetch = jest.fn((input, init) => Promise.reject('Failed to read'));
+describe('#googleRecaptchaService', () => {
+    it('should validate a recaptcha token', async () => {
+        const res = await GoogleRecaptchaRatchet.verifyRecaptchaToken('anykey', 'anytoken', fakeFetch);
+        expect(res).toBeTruthy();
+    });
+    it('should fail with no token', async () => {
+        const res = await GoogleRecaptchaRatchet.verifyRecaptchaToken('anykey', null, fakeFetch);
+        expect(res).toBeFalsy();
+    });
+    it('should fail if http fails', async () => {
+        const res = await GoogleRecaptchaRatchet.verifyRecaptchaToken('anykey', 'anytoken', fakeFailFetch);
+        expect(res).toBeFalsy();
+    });
+});
+//# sourceMappingURL=google-recaptcha-ratchet.spec.js.map

package/lib/third-party/google/google-recaptcha-ratchet.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-recaptcha-ratchet.spec.js","sourceRoot":"","sources":["../../../src/third-party/google/google-recaptcha-ratchet.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAErC,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CACxC,OAAO,CAAC,OAAO,CAAC;IACd,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;CACnC,CAAC,CACf,CAAC;AAEF,MAAM,aAAa,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAEjF,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,GAAG,GAAQ,MAAM,sBAAsB,CAAC,oBAAoB,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;QACpG,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACzC,MAAM,GAAG,GAAQ,MAAM,sBAAsB,CAAC,oBAAoB,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAC9F,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACzC,MAAM,GAAG,GAAQ,MAAM,sBAAsB,CAAC,oBAAoB,CAAC,QAAQ,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;QACxG,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/third-party/twilio/twilio-ratchet.js

@@ -0,0 +1,75 @@
+import fetch from 'cross-fetch';
+import { RequireRatchet } from '../../lang/require-ratchet.js';
+import { Base64Ratchet } from '../../lang/base64-ratchet.js';
+import { StringRatchet } from '../../lang/string-ratchet.js';
+import { Logger } from '../../logger/logger.js';
+class TwilioRatchet {
+    accountSid;
+    authToken;
+    outBoundNumber;
+    static TWILLIO_BASE_API_URL = 'https://api.twilio.com/2010-04-01';
+    constructor(accountSid, authToken, outBoundNumber) {
+        this.accountSid = accountSid;
+        this.authToken = authToken;
+        this.outBoundNumber = outBoundNumber;
+        RequireRatchet.notNullOrUndefined(accountSid, 'accountSid');
+        RequireRatchet.notNullOrUndefined(authToken, 'authToken');
+        RequireRatchet.notNullOrUndefined(outBoundNumber, 'outBoundNumber');
+        RequireRatchet.true(TwilioRatchet.isValidE164Number(outBoundNumber), 'outBoundNumber invalid format');
+    }
+    static async sendMessageDirect(accountSid, authToken, outBoundNumber, recipientPhoneNumbers, message) {
+        const ratchet = new TwilioRatchet(accountSid, authToken, outBoundNumber);
+        const rval = await ratchet.sendMessage(recipientPhoneNumbers, message);
+        return rval;
+    }
+    static generateTwilioBasicAuth(sid, authToken) {
+        const authHeader = 'Basic ' + Base64Ratchet.generateBase64VersionOfString(sid + ':' + authToken);
+        return authHeader;
+    }
+    async sendMessage(recipientPhoneNumbers, message) {
+        const rval = [];
+        RequireRatchet.notNullOrUndefined(recipientPhoneNumbers, 'recipientPhoneNumbers');
+        RequireRatchet.notNullOrUndefined(StringRatchet.trimToNull(message), 'message');
+        RequireRatchet.true(recipientPhoneNumbers.length > 0, 'recipientPhoneNumbers non-empty');
+        recipientPhoneNumbers.forEach((p) => {
+            RequireRatchet.true(TwilioRatchet.isValidE164Number(p), p + ' is not valid');
+        });
+        if (!!recipientPhoneNumbers && recipientPhoneNumbers.length > 0 && !!StringRatchet.trimToNull(message)) {
+            Logger.info('Sending %s to %j', message, recipientPhoneNumbers);
+            for (let i = 0; i < recipientPhoneNumbers.length; i++) {
+                const phoneNumber = recipientPhoneNumbers[i];
+                Logger.info('To: %s', phoneNumber);
+                if (!TwilioRatchet.isValidE164Number(phoneNumber)) {
+                    throw new Error('number must be E164 format!');
+                }
+                const body = 'Body=' +
+                    encodeURIComponent(message) +
+                    '&From=' +
+                    encodeURIComponent(this.outBoundNumber) +
+                    '&To=' +
+                    encodeURIComponent(phoneNumber);
+                const post = {
+                    method: 'post',
+                    headers: {
+                        authorization: TwilioRatchet.generateTwilioBasicAuth(this.accountSid, this.authToken),
+                        'Content-Type': 'application/x-www-form-urlencoded',
+                    },
+                    body: body,
+                };
+                const res = await fetch(TwilioRatchet.TWILLIO_BASE_API_URL + '/Accounts/' + this.accountSid + '/Messages.json', post);
+                const parsedResponse = await res.json();
+                Logger.debug('TwilioRatchet: For %s got %j', phoneNumber, parsedResponse);
+                rval.push(parsedResponse);
+            }
+        }
+        else {
+            Logger.warn('Not sending empty message / empty recipients');
+        }
+        return rval;
+    }
+    static isValidE164Number(num) {
+        return /^\+?[1-9]\d{1,14}$/.test(num);
+    }
+}
+export { TwilioRatchet };
+//# sourceMappingURL=twilio-ratchet.js.map

package/lib/third-party/twilio/twilio-ratchet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"twilio-ratchet.js","sourceRoot":"","sources":["../../../src/third-party/twilio/twilio-ratchet.ts"],"names":[],"mappings":"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"}

package/lib/transform/built-in-transforms.js

@@ -0,0 +1,192 @@
+import { Logger } from '../logger/logger.js';
+import { NumberRatchet } from '../lang/number-ratchet.js';
+import { DateTime } from 'luxon';
+export class BuiltInTransforms {
+    static keysOnly(rule) {
+        return {
+            transform(value, isKey, context) {
+                return isKey ? rule.transform(value, isKey, context) : value;
+            },
+        };
+    }
+    static valuesOnly(rule) {
+        return {
+            transform(value, isKey, context) {
+                return !isKey ? rule.transform(value, isKey, context) : value;
+            },
+        };
+    }
+    static stringReplaceTransform(input, output) {
+        return {
+            transform(value, isKey, context) {
+                return value == input ? output : value;
+            },
+        };
+    }
+    static stripStringTransform(input) {
+        return {
+            transform(value, isKey, context) {
+                return value == input ? null : value;
+            },
+        };
+    }
+    static retainAll(input) {
+        return {
+            transform(value, isKey, context) {
+                return input.indexOf(value) == -1 ? null : value;
+            },
+        };
+    }
+    static removeAll(input) {
+        return {
+            transform(value, isKey, context) {
+                return input.indexOf(value) > -1 ? null : value;
+            },
+        };
+    }
+    static snakeToCamelCase() {
+        return {
+            transform(value, isKey, context) {
+                let rval = value;
+                if (typeof value == 'string') {
+                    rval = value.replace(/_([a-z0-9])/gi, function (s, group1) {
+                        return group1.toUpperCase();
+                    });
+                }
+                return rval;
+            },
+        };
+    }
+    static stringToNumber() {
+        return {
+            transform(value, isKey, context) {
+                let rval = value;
+                if (typeof value == 'string') {
+                    const num = NumberRatchet.safeNumber(value);
+                    if (num !== null) {
+                        rval = num;
+                    }
+                }
+                return rval;
+            },
+        };
+    }
+    static camelToSnakeCase() {
+        return {
+            transform(value, isKey, context) {
+                let rval = value;
+                if (typeof value == 'string') {
+                    rval = value
+                        .replace(/\.?([A-Z]+)/g, function (x, y) {
+                        return '_' + y.toLowerCase();
+                    })
+                        .replace(/^_/, '');
+                }
+                return rval;
+            },
+        };
+    }
+    static concatenateToNewField(newFieldName, oldFieldNamesInOrder, abortIfFieldMissing = true) {
+        return {
+            transform(value, isKey, context) {
+                if (typeof value == 'object') {
+                    let rval = '';
+                    oldFieldNamesInOrder.forEach((n) => {
+                        if (rval != null) {
+                            const temp = value[n];
+                            if (temp == null && abortIfFieldMissing) {
+                                rval = null;
+                            }
+                            else {
+                                rval = temp == null ? rval : rval + String(temp);
+                            }
+                        }
+                    });
+                    if (rval != null) {
+                        value[newFieldName] = rval;
+                        oldFieldNamesInOrder.forEach((n) => delete value[n]);
+                    }
+                }
+                return value;
+            },
+        };
+    }
+    static numberToBool(fieldNames) {
+        return {
+            transform(value, isKey, context) {
+                if (typeof value == 'object') {
+                    fieldNames.forEach((n) => {
+                        const oldVal = value[n];
+                        if (typeof oldVal == 'number') {
+                            const newVal = 0 != oldVal;
+                            value[n] = newVal;
+                        }
+                    });
+                }
+                return value;
+            },
+        };
+    }
+    static boolToNumber(fieldNames) {
+        return {
+            transform(value, isKey, context) {
+                if (typeof value == 'object') {
+                    fieldNames.forEach((n) => {
+                        const oldVal = value[n];
+                        if (typeof oldVal == 'boolean') {
+                            const newVal = oldVal ? 1 : 0;
+                            value[n] = newVal;
+                        }
+                    });
+                }
+                return value;
+            },
+        };
+    }
+    static makeDuplicateField(oldName, newName) {
+        return {
+            transform(value, isKey, context) {
+                if (typeof value == 'object') {
+                    const oldVal = value[oldName];
+                    if (oldVal != null) {
+                        value[newName] = oldVal;
+                    }
+                }
+                return value;
+            },
+        };
+    }
+    static addField(name, valueToAdd) {
+        return {
+            transform(value, isKey, context) {
+                if (typeof value == 'object') {
+                    value[name] = valueToAdd;
+                }
+                return value;
+            },
+        };
+    }
+    static reformatDateFields(fieldNames, oldFormat, newFormat) {
+        return {
+            transform(value, isKey, context) {
+                if (typeof value == 'object') {
+                    fieldNames.forEach((key) => {
+                        const oldValue = value[key];
+                        if (oldValue != null) {
+                            try {
+                                const parsed = DateTime.fromFormat(oldValue, oldFormat);
+                                const newValue = parsed.toFormat(newFormat);
+                                value[key] = newValue;
+                            }
+                            catch (err) {
+                                Logger.warn('Failed to reparse date %s in format %s : %s', oldValue, oldFormat, err);
+                            }
+                        }
+                    });
+                }
+                return value;
+            },
+        };
+    }
+}
+//# sourceMappingURL=built-in-transforms.js.map

package/lib/transform/built-in-transforms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in-transforms.js","sourceRoot":"","sources":["../../src/transform/built-in-transforms.ts"],"names":[],"mappings":"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"}

package/lib/transform/transform-rule.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transform-rule.js.map

package/lib/transform/transform-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-rule.js","sourceRoot":"","sources":["../../src/transform/transform-rule.ts"],"names":[],"mappings":""}

package/lib/tx/transaction-configuration.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transaction-configuration.js.map

package/lib/tx/transaction-configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-configuration.js","sourceRoot":"","sources":["../../src/tx/transaction-configuration.ts"],"names":[],"mappings":""}

package/lib/tx/transaction-final-state.js

@@ -0,0 +1,7 @@
+export var TransactionFinalState;
+(function (TransactionFinalState) {
+    TransactionFinalState["Success"] = "Success";
+    TransactionFinalState["RolledBack"] = "RolledBack";
+    TransactionFinalState["RollbackFailed"] = "RollbackFailed";
+})(TransactionFinalState || (TransactionFinalState = {}));
+//# sourceMappingURL=transaction-final-state.js.map

package/lib/tx/transaction-final-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-final-state.js","sourceRoot":"","sources":["../../src/tx/transaction-final-state.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,qBAIX;AAJD,WAAY,qBAAqB;IAC/B,4CAAmB,CAAA;IACnB,kDAAyB,CAAA;IACzB,0DAAiC,CAAA;AACnC,CAAC,EAJW,qBAAqB,KAArB,qBAAqB,QAIhC"}

package/lib/tx/transaction-ratchet.js

@@ -0,0 +1,77 @@
+import { Logger } from '../logger/logger.js';
+import { RequireRatchet } from '../lang/require-ratchet.js';
+import { LoggerLevelName } from '../logger/logger-level-name.js';
+import { TransactionFinalState } from './transaction-final-state.js';
+export class TransactionRatchet {
+    static async execute(steps, initialContext, inConfiguration) {
+        RequireRatchet.notNullOrUndefined(steps, 'steps');
+        RequireRatchet.notNullOrUndefined(initialContext, 'initialContext');
+        RequireRatchet.true(steps.length > 0, 'steps may not be empty');
+        const config = Object.assign({}, inConfiguration || {});
+        config.stepLogLevel = config.stepLogLevel || LoggerLevelName.info;
+        const rval = {
+            finalContext: initialContext,
+            finalState: null,
+        };
+        const stepNames = steps.map((s, idx) => s.name || 'Step ' + idx);
+        Logger.info('Beginning transaction of %d steps', steps.length);
+        let idx = 0;
+        do {
+            Logger.logByLevel(config.stepLogLevel, 'Processing step %d of %d (%s)', idx + 1, steps.length, stepNames[idx]);
+            try {
+                await steps[idx].execute(rval.finalContext, idx);
+                idx++;
+            }
+            catch (err) {
+                Logger.error('Failure detected on step %d : %s : %s : Rolling back', idx, stepNames[idx], err, err);
+                rval.error = err;
+                rval.errorStep = idx;
+            }
+        } while (!rval.error && idx < steps.length);
+        if (rval.error) {
+            do {
+                Logger.logByLevel(config.stepLogLevel, 'Rolling back step %d of %d (%s)', idx + 1, steps.length, stepNames[idx]);
+                try {
+                    if (steps[idx].rollback) {
+                        await steps[idx].rollback(rval.finalContext, idx);
+                    }
+                    else {
+                        Logger.info('Skipping - no rollback defined');
+                    }
+                }
+                catch (err) {
+                    Logger.error('Very bad - rollback code failed on step %d : %s : Aborting in invalid state: %s', idx, stepNames[idx], err, err);
+                    rval.rollbackError = err;
+                    rval.rollbackErrorStep = idx;
+                }
+                idx--;
+            } while (idx >= 0);
+        }
+        rval.finalState = rval.rollbackError
+            ? TransactionFinalState.RollbackFailed
+            : rval.error
+                ? TransactionFinalState.RolledBack
+                : TransactionFinalState.Success;
+        Logger.info('Transaction completed with status : %s', rval.finalState);
+        if (config?.executeAfterRollback && rval.finalState !== TransactionFinalState.Success) {
+            try {
+                Logger.info('Applying executeAfterRollback');
+                await config.executeAfterRollback(rval);
+            }
+            catch (err) {
+                Logger.error('Very bad - failure in executeAfterRollback : %s', err, err);
+            }
+        }
+        if (config?.executeAfterRollbackFailure && rval.finalState !== TransactionFinalState.Success) {
+            try {
+                Logger.info('Applying executeAfterRollbackFailure');
+                await config.executeAfterRollbackFailure(rval);
+            }
+            catch (err) {
+                Logger.error('Very bad - failure in executeAfterRollbackFailure : %s', err, err);
+            }
+        }
+        return rval;
+    }
+}
+//# sourceMappingURL=transaction-ratchet.js.map

package/lib/tx/transaction-ratchet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-ratchet.js","sourceRoot":"","sources":["../../src/tx/transaction-ratchet.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AASrE,MAAM,OAAO,kBAAkB;IACtB,MAAM,CAAC,KAAK,CAAC,OAAO,CACzB,KAA2B,EAC3B,cAAiB,EACjB,eAA6C;QAE7C,cAAc,CAAC,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAClD,cAAc,CAAC,kBAAkB,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;QACpE,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,wBAAwB,CAAC,CAAC;QAIhE,MAAM,MAAM,GAAgC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,eAAe,IAAI,EAAE,CAAC,CAAC;QACrF,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,eAAe,CAAC,IAAI,CAAC;QAElE,MAAM,IAAI,GAAyB;YACjC,YAAY,EAAE,cAAc;YAC5B,UAAU,EAAE,IAAI;SACjB,CAAC;QAEF,MAAM,SAAS,GAAa,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,OAAO,GAAG,GAAG,CAAC,CAAC;QAE3E,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAC/D,IAAI,GAAG,GAAW,CAAC,CAAC;QACpB,GAAG;YACD,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,YAAY,EAAE,+BAA+B,EAAE,GAAG,GAAG,CAAC,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/G,IAAI;gBACF,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;gBACjD,GAAG,EAAE,CAAC;aACP;YAAC,OAAO,GAAG,EAAE;gBACZ,MAAM,CAAC,KAAK,CAAC,sDAAsD,EAAE,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBACpG,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC;gBACjB,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;aACtB;SACF,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE;QAE5C,IAAI,IAAI,CAAC,KAAK,EAAE;YAEd,GAAG;gBACD,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,YAAY,EAAE,iCAAiC,EAAE,GAAG,GAAG,CAAC,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;gBACjH,IAAI;oBACF,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;wBACvB,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;qBACnD;yBAAM;wBACL,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;qBAC/C;iBACF;gBAAC,OAAO,GAAG,EAAE;oBACZ,MAAM,CAAC,KAAK,CAAC,iFAAiF,EAAE,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;oBAC/H,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC;oBACzB,IAAI,CAAC,iBAAiB,GAAG,GAAG,CAAC;iBAC9B;gBACD,GAAG,EAAE,CAAC;aACP,QAAQ,GAAG,IAAI,CAAC,EAAE;SACpB;QAED,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,aAAa;YAClC,CAAC,CAAC,qBAAqB,CAAC,cAAc;YACtC,CAAC,CAAC,IAAI,CAAC,KAAK;gBACZ,CAAC,CAAC,qBAAqB,CAAC,UAAU;gBAClC,CAAC,CAAC,qBAAqB,CAAC,OAAO,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAEvE,IAAI,MAAM,EAAE,oBAAoB,IAAI,IAAI,CAAC,UAAU,KAAK,qBAAqB,CAAC,OAAO,EAAE;YACrF,IAAI;gBACF,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;gBAC7C,MAAM,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;aACzC;YAAC,OAAO,GAAG,EAAE;gBACZ,MAAM,CAAC,KAAK,CAAC,iDAAiD,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;aAC3E;SACF;QAED,IAAI,MAAM,EAAE,2BAA2B,IAAI,IAAI,CAAC,UAAU,KAAK,qBAAqB,CAAC,OAAO,EAAE;YAC5F,IAAI;gBACF,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;gBACpD,MAAM,MAAM,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC;aAChD;YAAC,OAAO,GAAG,EAAE;gBACZ,MAAM,CAAC,KAAK,CAAC,wDAAwD,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;aAClF;SACF;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/lib/tx/transaction-ratchet.spec.js

@@ -0,0 +1,131 @@
+import { TransactionRatchet } from './transaction-ratchet.js';
+import { TransactionFinalState } from './transaction-final-state.js';
+import { LoggerLevelName } from '../logger/logger-level-name.js';
+class TestTransactionStep {
+    async execute(context, stepNumber) {
+        context.runningTotal += stepNumber;
+        if (stepNumber === context?.failStep) {
+            throw new Error('Forced error at step ' + stepNumber);
+        }
+    }
+    async rollback(context, stepNumber) {
+        context.runningTotal -= stepNumber;
+        if (stepNumber === context?.failRollbackStep) {
+            throw new Error('Forced rollback error at step ' + stepNumber);
+        }
+    }
+}
+describe('#TransactionRatchet.execute', function () {
+    it('should return the right value when it executes successfully', async () => {
+        const steps = [new TestTransactionStep(), new TestTransactionStep(), new TestTransactionStep()];
+        const ctx = { runningTotal: 0 };
+        const result = await TransactionRatchet.execute(steps, ctx);
+        expect(result).not.toBeNull();
+        expect(result.error).toBeUndefined();
+        expect(result.finalState).toEqual(TransactionFinalState.Success);
+        expect(result.finalContext.runningTotal).toEqual(3);
+    });
+    it('should return the right value when it rolls back successfully fail step 2', async () => {
+        const steps = [new TestTransactionStep(), new TestTransactionStep(), new TestTransactionStep()];
+        const ctx = { runningTotal: 0, failStep: 2 };
+        const result = await TransactionRatchet.execute(steps, ctx);
+        expect(result).not.toBeUndefined();
+        expect(result.finalState).toEqual(TransactionFinalState.RolledBack);
+        expect(result.errorStep).toEqual(2);
+        expect(result.error).not.toBeUndefined();
+        expect(result.finalContext.runningTotal).toEqual(0);
+    });
+    it('should return the right value when it rolls back successfully fail step 1', async () => {
+        const steps = [new TestTransactionStep(), new TestTransactionStep(), new TestTransactionStep()];
+        const ctx = { runningTotal: 0, failStep: 2 };
+        const result = await TransactionRatchet.execute(steps, ctx);
+        expect(result).not.toBeUndefined();
+        expect(result.finalState).toEqual(TransactionFinalState.RolledBack);
+        expect(result.errorStep).toEqual(2);
+        expect(result.error).not.toBeUndefined();
+        expect(result.finalContext.runningTotal).toEqual(0);
+    });
+    it('should return the right value the rollback fails', async () => {
+        const steps = [new TestTransactionStep(), new TestTransactionStep(), new TestTransactionStep()];
+        const ctx = { runningTotal: 0, failStep: 2, failRollbackStep: 1 };
+        const result = await TransactionRatchet.execute(steps, ctx);
+        expect(result).not.toBeUndefined();
+        expect(result.finalState).toEqual(TransactionFinalState.RollbackFailed);
+        expect(result.finalContext.runningTotal).toEqual(0);
+        expect(result.errorStep).toEqual(2);
+        expect(result.rollbackErrorStep).toEqual(1);
+        expect(result.error).not.toBeUndefined();
+        expect(result.rollbackError).not.toBeUndefined();
+    });
+    it('should run the post-error handler when a failure happens', async () => {
+        const steps = [new TestTransactionStep(), new TestTransactionStep(), new TestTransactionStep()];
+        const ctx = { runningTotal: 0, failStep: 2 };
+        const result = await TransactionRatchet.execute(steps, ctx, {
+            executeAfterRollback: async (res) => {
+                res.finalContext.postTxTracker = 1;
+            },
+        });
+        expect(result).not.toBeUndefined();
+        expect(result.finalState).toEqual(TransactionFinalState.RolledBack);
+        expect(result.errorStep).toEqual(2);
+        expect(result.error).not.toBeUndefined();
+        expect(result.finalContext.postTxTracker).toEqual(1);
+    });
+    it('should run both post-error handler when a failure happens in both error and rollback', async () => {
+        const steps = [new TestTransactionStep(), new TestTransactionStep(), new TestTransactionStep()];
+        const ctx = { runningTotal: 0, failStep: 2, failRollbackStep: 1 };
+        const result = await TransactionRatchet.execute(steps, ctx, {
+            executeAfterRollback: async (res) => {
+                res.finalContext.postTxTracker = 1;
+            },
+            executeAfterRollbackFailure: async (res) => {
+                res.finalContext.postTxTracker += 1;
+            },
+        });
+        expect(result).not.toBeUndefined();
+        expect(result.finalState).toEqual(TransactionFinalState.RollbackFailed);
+        expect(result.errorStep).toEqual(2);
+        expect(result.error).not.toBeUndefined();
+        expect(result.finalContext.postTxTracker).toEqual(2);
+    });
+    it('should still return if a post-tx executor fails', async () => {
+        const steps = [new TestTransactionStep(), new TestTransactionStep(), new TestTransactionStep()];
+        const ctx = { runningTotal: 0, failStep: 2, failRollbackStep: 1 };
+        const result = await TransactionRatchet.execute(steps, ctx, {
+            executeAfterRollback: async (res) => {
+                res.finalContext.postTxTracker = 1;
+            },
+            executeAfterRollbackFailure: async (res) => {
+                res.finalContext.postTxTracker += 1;
+                throw new Error('Forced tracker failure');
+            },
+        });
+        expect(result).not.toBeUndefined();
+        expect(result.finalState).toEqual(TransactionFinalState.RollbackFailed);
+        expect(result.errorStep).toEqual(2);
+        expect(result.error).not.toBeUndefined();
+        expect(result.finalContext.postTxTracker).toEqual(2);
+    });
+    it('should work with transaction configuration that only provides read log level access', async () => {
+        const steps = [new TestTransactionStep(), new TestTransactionStep(), new TestTransactionStep()];
+        const ctx = { runningTotal: 0, failStep: 2, failRollbackStep: 1 };
+        const result = await TransactionRatchet.execute(steps, ctx, {
+            get stepLogLevel() {
+                return LoggerLevelName.info;
+            },
+            executeAfterRollback: async (res) => {
+                res.finalContext.postTxTracker = 1;
+            },
+            executeAfterRollbackFailure: async (res) => {
+                res.finalContext.postTxTracker += 1;
+                throw new Error('Forced tracker failure');
+            },
+        });
+        expect(result).not.toBeUndefined();
+        expect(result.finalState).toEqual(TransactionFinalState.RollbackFailed);
+        expect(result.errorStep).toEqual(2);
+        expect(result.error).not.toBeUndefined();
+        expect(result.finalContext.postTxTracker).toEqual(2);
+    });
+});
+//# sourceMappingURL=transaction-ratchet.spec.js.map

package/lib/tx/transaction-ratchet.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-ratchet.spec.js","sourceRoot":"","sources":["../../src/tx/transaction-ratchet.spec.ts"],"names":[],"mappings":"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"}

package/lib/tx/transaction-result.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transaction-result.js.map

package/lib/tx/transaction-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-result.js","sourceRoot":"","sources":["../../src/tx/transaction-result.ts"],"names":[],"mappings":""}

package/lib/tx/transaction-step.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transaction-step.js.map

package/lib/tx/transaction-step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-step.js","sourceRoot":"","sources":["../../src/tx/transaction-step.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitblit/ratchet-common",
-  "version": "4.0.128-alpha",
+  "version": "4.0.130-alpha",
   "description": "Common tools for general use",
   "type": "module",
   "files": [
@@ -40,7 +40,8 @@
     "lint": "eslint src/**/*.ts",
     "lint-fix": "eslint --fix src/**/*.ts",
     "generate-barrels": "barrelsby -q --delete -d src -e .*\\.spec\\.ts && sed -i 's/\\x27;/.js\\x27;/' src/index.ts",
-    "build": "yarn clean && yarn generate-barrels && rollup -c rollup.config.js",
+    "build": "yarn clean && yarn generate-barrels && tsc",
+    "_build": "yarn clean && yarn generate-barrels && rollup -c rollup.config.js",
     "force-build": "tsc --build --force"
   },
   "repository": {