@bitblit/ratchet-common 4.0.420-alpha → 4.0.421-alpha

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/index.d.ts

@@ -0,0 +1,3 @@
+export * from './built-in-transforms.js';
+export * from './transform-ratchet.js';
+export * from './transform-rule.js';

package/lib/transform/index.js

@@ -0,0 +1,4 @@
+export * from './built-in-transforms.js';
+export * from './transform-ratchet.js';
+export * from './transform-rule.js';
+//# sourceMappingURL=index.js.map

package/lib/transform/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transform/index.ts"],"names":[],"mappings":"AAIA,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC"}

package/lib/transform/transform-ratchet.d.ts

@@ -0,0 +1,7 @@
+import { TransformRule } from './transform-rule.js';
+export declare class TransformRatchet {
+    static transform(toTransform: any, rules?: TransformRule[]): any;
+    private static transformGeneric;
+    private static applyTransformToObject;
+    private static applyTransformToPrimitive;
+}

package/lib/transform/transform-ratchet.js

@@ -0,0 +1,67 @@
+import { Logger } from '../logger/logger.js';
+export class TransformRatchet {
+    static transform(toTransform, rules = []) {
+        return TransformRatchet.transformGeneric(toTransform, rules, false, null);
+    }
+    static transformGeneric(toTransform, rules = [], isKey, context) {
+        let rval = null;
+        const type = typeof toTransform;
+        switch (type) {
+            case 'undefined':
+            case 'symbol':
+            case 'function':
+                rval = toTransform;
+                break;
+            case 'number':
+            case 'string':
+            case 'boolean':
+                rval = TransformRatchet.applyTransformToPrimitive(toTransform, rules, isKey, context);
+                break;
+            case 'object':
+                rval = TransformRatchet.applyTransformToObject(toTransform, rules, isKey, context);
+                break;
+            default:
+                throw new Error('Unrecognized type ' + type);
+        }
+        return rval;
+    }
+    static applyTransformToObject(toTransform, rules = [], isKey, context = null) {
+        Logger.silly('Tranform: %j, %s, %j', toTransform, isKey, context);
+        let rval = null;
+        if (toTransform != null) {
+            if (Array.isArray(toTransform)) {
+                rval = [];
+                toTransform.forEach((val) => {
+                    const newVal = TransformRatchet.transformGeneric(val, rules, isKey, toTransform);
+                    if (newVal != null) {
+                        rval.push(newVal);
+                    }
+                });
+            }
+            else {
+                rval = {};
+                Object.keys(toTransform).forEach((k) => {
+                    const oldValue = toTransform[k];
+                    const newKey = TransformRatchet.applyTransformToPrimitive(k, rules, true, toTransform);
+                    if (newKey != null) {
+                        let newValue = TransformRatchet.transformGeneric(oldValue, rules, false, toTransform);
+                        newValue = TransformRatchet.applyTransformToPrimitive(newValue, rules, false, toTransform);
+                        if (newValue != null) {
+                            rval[newKey] = newValue;
+                        }
+                    }
+                });
+                rval = TransformRatchet.applyTransformToPrimitive(rval, rules, false, toTransform);
+            }
+        }
+        return rval;
+    }
+    static applyTransformToPrimitive(toTransform, rules = [], isKey, context) {
+        let rval = toTransform;
+        rules.forEach((r) => {
+            rval = rval == null ? null : r.transform(rval, isKey, context);
+        });
+        return rval;
+    }
+}
+//# sourceMappingURL=transform-ratchet.js.map

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

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

package/lib/transform/transform-rule.d.ts

@@ -0,0 +1,3 @@
+export interface TransformRule {
+    transform(value: any, isKey: boolean, context: any): any;
+}

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/index.d.ts

@@ -0,0 +1,5 @@
+export * from './transaction-configuration.js';
+export * from './transaction-final-state.js';
+export * from './transaction-ratchet.js';
+export * from './transaction-result.js';
+export * from './transaction-step.js';

package/lib/tx/index.js

@@ -0,0 +1,6 @@
+export * from './transaction-configuration.js';
+export * from './transaction-final-state.js';
+export * from './transaction-ratchet.js';
+export * from './transaction-result.js';
+export * from './transaction-step.js';
+//# sourceMappingURL=index.js.map

package/lib/tx/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tx/index.ts"],"names":[],"mappings":"AAIA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}

package/lib/tx/transaction-configuration.d.ts

@@ -0,0 +1,7 @@
+import { TransactionResult } from './transaction-result.js';
+import { LoggerLevelName } from '../logger/logger-level-name.js';
+export interface TransactionConfiguration<T> {
+    stepLogLevel?: LoggerLevelName;
+    executeAfterRollback?(result: TransactionResult<T>): Promise<void>;
+    executeAfterRollbackFailure?(result: TransactionResult<T>): Promise<void>;
+}

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.d.ts

@@ -0,0 +1,6 @@
+export declare const TransactionFinalState: {
+    Success: string;
+    RolledBack: string;
+    RollbackFailed: string;
+};
+export type TransactionFinalState = (typeof TransactionFinalState)[keyof typeof TransactionFinalState];

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

@@ -0,0 +1,6 @@
+export const TransactionFinalState = {
+    Success: 'Success',
+    RolledBack: 'RolledBack',
+    RollbackFailed: 'RollbackFailed',
+};
+//# 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":"AACA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;IACxB,cAAc,EAAE,gBAAgB;CACjC,CAAC"}

package/lib/tx/transaction-ratchet.d.ts

@@ -0,0 +1,6 @@
+import { TransactionStep } from './transaction-step.js';
+import { TransactionResult } from './transaction-result.js';
+import { TransactionConfiguration } from './transaction-configuration.js';
+export declare class TransactionRatchet {
+    static execute<T>(steps: TransactionStep<T>[], initialContext: T, inConfiguration?: TransactionConfiguration<T>): Promise<TransactionResult<T>>;
+}

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":"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"}

package/lib/tx/transaction-result.d.ts

@@ -0,0 +1,9 @@
+import { TransactionFinalState } from './transaction-final-state.js';
+export interface TransactionResult<T> {
+    finalContext: T;
+    finalState: TransactionFinalState;
+    error?: any;
+    rollbackError?: any;
+    errorStep?: number;
+    rollbackErrorStep?: number;
+}

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.d.ts

@@ -0,0 +1,5 @@
+export interface TransactionStep<T> {
+    execute(context: T, stepNumber?: number): Promise<void>;
+    rollback?(context: T, stepNumber?: number): Promise<void>;
+    name?: string;
+}

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,18 +1,17 @@
 {
   "name": "@bitblit/ratchet-common",
-  "version": "4.0.420-alpha",
+  "version": "4.0.421-alpha",
   "description": "Common tools for general use",
   "type": "module",
   "files": [
     "lib/**",
     "bin/**"
   ],
-  "module": "./lib/index.mjs",
-  "types": "./lib/types.d.ts",
   "exports": {
-    ".": {
-      "types": "./lib/types.d.ts",
-      "import": "./lib/index.mjs"
+    "./package.json": "./package.json",
+    "./*": {
+      "import": "./lib/*.js",
+      "types": "./lib/*.d.ts"
     }
   },
   "contributors": [
@@ -29,11 +28,6 @@
       "pre-commit": "pretty-quick --staged"
     }
   },
-  "prettier": {
-    "printWidth": 140,
-    "singleQuote": true,
-    "arrowParens": "always"
-  },
   "config": {},
   "repository": {
     "type": "git",
@@ -54,7 +48,7 @@
     "node": ">=14.18"
   },
   "license": "Apache-2.0",
-  "dependencies": {
+  "optionalDependencies": {
     "jsonwebtoken": "9.0.2",
     "ts-enum-util": "4.1.0"
   },