@sera4/essentia 3.0.13 → 3.0.14

package/dist/ts/paginator/sql-pagination.js

@@ -0,0 +1,157 @@
+class SequelizePaginator {
+    constructor() {
+        this.paginateIn = {
+            size: "page_size",
+            index: "page_index"
+        };
+        this.paginateOut = {
+            current_page: "current_page",
+            first_page: "first_page",
+            last_page: "last_page",
+            next_page: "next_page",
+            out_of_bounds: "out_of_bounds",
+            page_size: "page_size",
+            previous_page: "previous_page",
+            total_pages: "total_pages",
+            total_size: "total_size",
+            links: "",
+        };
+        this.zeroBasedOffset = true;
+        this.paginationHeader = "tws-pagination";
+        this.headersOnly = false;
+        this.paginationTag = "_pagination";
+        this.collectionTag = "_collection";
+    }
+    paginate(Model, resource = "") {
+        const model = Model.instance || Model;
+        const DEFAULT_PAGINATION = { limit: 15, offset: 0 };
+        let pagination = { limit: 15, offset: 0 };
+        let response = null;
+        const using = (options, resp) => {
+            response = resp;
+            let limit = DEFAULT_PAGINATION.limit;
+            let offset = DEFAULT_PAGINATION.offset;
+            if (options && options[this.paginateIn.size]) {
+                limit = parseInt(options[this.paginateIn.size]);
+            }
+            if (options && options[this.paginateIn.index]) {
+                offset = parseInt(options[this.paginateIn.index]);
+            }
+            if (!Number.isInteger(limit) || limit < 1) {
+                limit = 1;
+            }
+            if (!Number.isInteger(offset) || offset < 0) {
+                offset = 0;
+            }
+            if (!this.zeroBasedOffset) {
+                offset = offset <= 1 ? 0 : offset - 1;
+            }
+            pagination.limit = limit;
+            pagination.offset = offset;
+            return model;
+        };
+        const paginate = (options = {}) => {
+            options.limit = pagination.limit;
+            options.offset = pagination.limit * pagination.offset;
+            return new Promise((resolve, reject) => {
+                model.findAndCountAll(options)
+                    .then((r) => {
+                    const paginationData = getPaginationData(r);
+                    if (response) {
+                        response.set(this.paginationHeader, JSON.stringify(paginationData));
+                    }
+                    let data = {};
+                    if (this.headersOnly) {
+                        data = r.rows;
+                    }
+                    else {
+                        data[this.paginationTag] = addLinks(paginationData);
+                        data[this.collectionTag] = r.rows;
+                    }
+                    resolve(data);
+                }).catch((e) => reject(e));
+            });
+        };
+        const addLinks = (data) => {
+            let linksKey = null;
+            if (this.paginateOut.links === true) {
+                linksKey = "links";
+            }
+            else if (this.paginateOut.links) {
+                linksKey = this.paginateOut.links;
+            }
+            if (data && linksKey && !data[this.paginateOut.out_of_bounds]) {
+                const links = {};
+                const firstPageIndex = this.zeroBasedOffset ? 0 : 1;
+                const lastPageIndex = this.zeroBasedOffset ? data[this.paginateOut.total_pages] - 1 : data[this.paginateOut.total_pages];
+                links[this.paginateOut.first_page] = `${resource}?${this.paginateIn.index}=${firstPageIndex}&${this.paginateIn.size}=${data[this.paginateOut.page_size]}`;
+                links[this.paginateOut.last_page] = `${resource}?${this.paginateIn.index}=${lastPageIndex}&${this.paginateIn.size}=${data[this.paginateOut.page_size]}`;
+                if (data[this.paginateOut.previous_page]) {
+                    const prevPageIndex = this.zeroBasedOffset ? data[this.paginateOut.previous_page] - 1 : data[this.paginateOut.previous_page];
+                    links[this.paginateOut.previous_page] = `${resource}?${this.paginateIn.index}=${prevPageIndex}&${this.paginateIn.size}=${data[this.paginateOut.page_size]}`;
+                }
+                if (data[this.paginateOut.next_page]) {
+                    const nextPageIndex = this.zeroBasedOffset ? data[this.paginateOut.next_page] - 1 : data[this.paginateOut.next_page];
+                    links[this.paginateOut.next_page] = `${resource}?${this.paginateIn.index}=${nextPageIndex}&${this.paginateIn.size}=${data[this.paginateOut.page_size]}`;
+                }
+                data[linksKey] = links;
+            }
+            return data;
+        };
+        const getPaginationData = (result) => {
+            const totalSize = result.count;
+            const pageSize = pagination.limit;
+            const currentPage = Math.floor(pagination.offset / pageSize) + 1;
+            const totalPages = Math.ceil(totalSize / pageSize);
+            const outOfBounds = currentPage > totalPages || currentPage < 1;
+            const paginationData = {
+                [this.paginateOut.current_page]: currentPage,
+                [this.paginateOut.first_page]: currentPage === 1,
+                [this.paginateOut.last_page]: currentPage === totalPages,
+                [this.paginateOut.out_of_bounds]: outOfBounds,
+                [this.paginateOut.page_size]: pageSize,
+                [this.paginateOut.total_pages]: totalPages,
+                [this.paginateOut.total_size]: totalSize,
+            };
+            if (!outOfBounds) {
+                if (currentPage > 1) {
+                    paginationData[this.paginateOut.previous_page] = currentPage - 1;
+                }
+                if (currentPage < totalPages) {
+                    paginationData[this.paginateOut.next_page] = currentPage + 1;
+                }
+            }
+            return paginationData;
+        };
+        return {
+            using,
+            paginate
+        };
+    }
+    configure(options) {
+        if (options.paginateIn) {
+            this.paginateIn = { ...this.paginateIn, ...options.paginateIn };
+        }
+        if (options.paginateOut) {
+            this.paginateOut = { ...this.paginateOut, ...options.paginateOut };
+        }
+        if (options.zeroBasedOffset !== undefined) {
+            this.zeroBasedOffset = options.zeroBasedOffset;
+        }
+        if (options.paginationHeader) {
+            this.paginationHeader = options.paginationHeader;
+        }
+        if (options.headersOnly !== undefined) {
+            this.headersOnly = options.headersOnly;
+        }
+        if (options.paginationTag) {
+            this.paginationTag = options.paginationTag;
+        }
+        if (options.collectionTag) {
+            this.collectionTag = options.collectionTag;
+        }
+    }
+}
+const sqlPaginator = new SequelizePaginator();
+export default sqlPaginator;
+//# sourceMappingURL=sql-pagination.js.map

package/dist/ts/paginator/sql-pagination.js.map

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

package/dist/ts/paper-trail/helpers.d.ts

@@ -0,0 +1,14 @@
+interface DiffResult {
+    kind: string;
+    path: string[];
+    lhs?: any;
+    rhs?: any;
+}
+declare const _default: {
+    capitalizeFirstLetter: (string: string) => string;
+    toUnderscored: (obj: Record<string, string>) => Record<string, string>;
+    calcDelta: (current: Record<string, any>, next: Record<string, any>, exclude: string[], strict: boolean, DEBUG?: boolean) => DiffResult[] | null;
+    diffToString: (val: any) => string;
+};
+export default _default;
+export type { DiffResult };

package/dist/ts/paper-trail/helpers.js

@@ -0,0 +1,74 @@
+import pkg from 'deep-diff';
+import _ from 'lodash';
+const { diff } = pkg;
+const capitalizeFirstLetter = (string) => string.charAt(0).toUpperCase() + string.slice(1);
+const toUnderscored = (obj) => {
+    _.forEach(obj, (k, v) => {
+        obj[k] = v
+            .replace(/(?:^|\.?)([A-Z])/g, (x, y) => `_${y.toLowerCase()}`)
+            .replace(/^_/, '');
+    });
+    return obj;
+};
+const calcDelta = (current, next, exclude, strict, DEBUG = false) => {
+    if (DEBUG) {
+        console.log('current', current);
+        console.log('next', next);
+        console.log('exclude', exclude);
+    }
+    const di = diff(current, next);
+    if (DEBUG) {
+        console.log('di', di);
+        let diffs2 = [];
+        if (di) {
+            diffs2 = di.map((i) => JSON.parse(JSON.stringify(i).replace('"__data",', '')));
+        }
+        console.log('diffs2', diffs2);
+        console.log('filter1', diffs2.filter(i => i.path.join(',').indexOf('_') === -1));
+        console.log('filter2', diffs2.filter(i => exclude.every(x => i.path.indexOf(x) === -1)));
+    }
+    let diffs = [];
+    if (di) {
+        diffs = di
+            .map((i) => JSON.parse(JSON.stringify(i).replace('"__data",', '')))
+            .filter((i) => {
+            if (!strict && i.kind === 'E') {
+                // eslint-disable-next-line eqeqeq
+                if (i.lhs != i.rhs)
+                    return i;
+            }
+            else
+                return i;
+            return false;
+        })
+            .filter((i) => exclude.every((x) => i.path.indexOf(x) === -1));
+    }
+    if (diffs.length > 0) {
+        return diffs;
+    }
+    return null;
+};
+const diffToString = (val) => {
+    if (typeof val === 'undefined' || val === null)
+        return '';
+    if (val === true)
+        return '1';
+    if (val === false)
+        return '0';
+    if (typeof val === 'string')
+        return val;
+    if (!Number.isNaN(Number(val)))
+        return `${String(val)}`;
+    if ((typeof val === 'undefined' ? 'undefined' : typeof val) === 'object')
+        return `${JSON.stringify(val)}`;
+    if (Array.isArray(val))
+        return `${JSON.stringify(val)}`;
+    return '';
+};
+export default {
+    capitalizeFirstLetter,
+    toUnderscored,
+    calcDelta,
+    diffToString
+};
+//# sourceMappingURL=helpers.js.map

package/dist/ts/paper-trail/helpers.js.map

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

package/dist/ts/paper-trail/index.d.ts

@@ -0,0 +1,54 @@
+interface PaperTrailOptions {
+    debug?: boolean;
+    log?: any;
+    exclude?: string[];
+    excludeExtras?: string[];
+    excludeVirtualAttributes?: boolean;
+    censor?: string[];
+    revisionAttribute?: string;
+    revisionModel?: string;
+    revisionChangeModel?: string;
+    enableRevisionChangeModel?: boolean;
+    UUID?: boolean;
+    mixedDocumentReference?: boolean;
+    underscored?: boolean;
+    underscoredAttributes?: boolean;
+    includeReferences?: string[];
+    defaultAttributes?: {
+        documentId: string;
+        revisionId: string;
+        autoGenerated: string;
+        documentUuid?: string;
+    };
+    als?: any;
+    userModel?: boolean;
+    userModelAttribute?: string;
+    tenantModel?: boolean;
+    tenantModelAttribute?: string;
+    enableCompression?: boolean;
+    enableMigration?: boolean;
+    enableStrictDiff?: boolean;
+    continuationNamespace?: any;
+    continuationKey?: string;
+    continuationTenantKey?: string;
+    metaDataFields?: any;
+    metaDataContinuationKey?: string;
+    mysql?: boolean;
+}
+interface ModelInstance {
+    get: (key?: string) => Record<string, any> | any;
+    set: (key: string, value: any) => void;
+    save: () => Promise<any>;
+    [key: string]: any;
+}
+interface ModelOptions {
+    noPaperTrail?: boolean;
+    [key: string]: any;
+}
+declare const paperTrail: {
+    init: (sequelize: any, sequelizePackage: any, optionsArg?: PaperTrailOptions) => void;
+    hasPaperTrail: () => boolean;
+    defineModels: (db: any) => void;
+};
+export default paperTrail;
+export type { PaperTrailOptions, ModelInstance, ModelOptions };

package/dist/ts/paper-trail/index.js

@@ -0,0 +1,236 @@
+import _ from 'lodash';
+import helpers from './helpers.js';
+const censorText = "**********";
+let failHard = false;
+let Sequelize = null;
+const paperTrail = {
+    init: (sequelize, sequelizePackage, optionsArg) => {
+        Sequelize = sequelizePackage;
+        // In case that options is being parsed as a readonly attribute.
+        // Or it is not passed at all
+        const optsArg = _.cloneDeep(optionsArg || {});
+        const defaultOptions = {
+            debug: false,
+            log: null,
+            exclude: [
+                'id',
+                'createdAt',
+                'updatedAt',
+                'deletedAt',
+                'created_at',
+                'updated_at',
+                'deleted_at',
+                'audit_source',
+                'revision',
+            ],
+            // additional fields to exclude on a global basis
+            excludeExtras: [],
+            excludeVirtualAttributes: true, // by default do not record these
+            censor: ["password", "password_salt", "temp_secret", "mfa_totp_secret"],
+            revisionAttribute: 'revision',
+            revisionModel: 'Revision',
+            revisionChangeModel: 'RevisionChange',
+            enableRevisionChangeModel: false,
+            UUID: false,
+            // does this project use int's and UUIDs for some references (postgres)
+            mixedDocumentReference: false,
+            underscored: false,
+            underscoredAttributes: false,
+            // always store these keys in a reference value if seen
+            includeReferences: [],
+            defaultAttributes: {
+                documentId: 'documentId',
+                revisionId: 'revisionId',
+                autoGenerated: 'autoGenerated'
+            },
+            als: null,
+            userModel: false,
+            userModelAttribute: 'userId',
+            tenantModel: false,
+            tenantModelAttribute: 'tenantId',
+            enableCompression: false,
+            enableMigration: false,
+            enableStrictDiff: true,
+            continuationNamespace: null,
+            continuationKey: 'userId',
+            continuationTenantKey: 'tenantId',
+            metaDataFields: null,
+            metaDataContinuationKey: 'metaData',
+            mysql: false,
+        };
+        if (optsArg.mixedDocumentReference)
+            defaultOptions.defaultAttributes.documentUuid = "documentUuid";
+        if (optsArg.underscoredAttributes) {
+            helpers.toUnderscored(defaultOptions.defaultAttributes);
+        }
+        // deals with not wanting to overwrite the initial ones, just add some
+        if (optsArg.excludeExtras) {
+            if (optsArg.exclude) {
+                optsArg.exclude = [...optsArg.exclude, ...optsArg.excludeExtras];
+            }
+            else {
+                optsArg.exclude = [...defaultOptions.exclude, ...optsArg.excludeExtras];
+            }
+        }
+        const options = _.defaults(optsArg, defaultOptions);
+        const log = options.log || console.log;
+        function createBeforeHook(operation) {
+            const beforeHook = function beforeHook(instance, opt) {
+                if (options.debug) {
+                    log('beforeHook called');
+                    log('instance:', instance);
+                    log('opt:', opt);
+                }
+                if (opt.noPaperTrail) {
+                    if (options.debug) {
+                        log('noPaperTrail set, skipping');
+                    }
+                    return;
+                }
+                // Store the original values for comparison
+                const originalValues = instance.get();
+                instance.set('_paperTrailOriginalValues', originalValues);
+            };
+            return beforeHook;
+        }
+        function createAfterHook(operation) {
+            const afterHook = function afterHook(instance, opt) {
+                if (options.debug) {
+                    log('afterHook called');
+                    log('instance:', instance);
+                    log('opt:', opt);
+                }
+                if (opt.noPaperTrail) {
+                    if (options.debug) {
+                        log('noPaperTrail set, skipping');
+                    }
+                    return;
+                }
+                // Get the original values and current values
+                const originalValues = instance.get('_paperTrailOriginalValues') || {};
+                const currentValues = instance.get();
+                // Remove the temporary field
+                delete currentValues._paperTrailOriginalValues;
+                // Calculate differences
+                const differences = helpers.calcDelta(originalValues, currentValues, options.exclude || [], options.enableStrictDiff || false, options.debug);
+                if (differences && differences.length > 0) {
+                    // Create revision record
+                    const revisionData = {
+                        documentId: instance.get(options.defaultAttributes.documentId),
+                        revision: instance.get(options.revisionAttribute),
+                        document: JSON.stringify(currentValues),
+                        operation: operation,
+                        changes: JSON.stringify(differences),
+                        createdAt: new Date()
+                    };
+                    // Add user information if available
+                    if (options.userModel && options.als) {
+                        const user = options.als.get(options.continuationKey);
+                        if (user) {
+                            revisionData[options.userModelAttribute] = user;
+                        }
+                    }
+                    // Add tenant information if available
+                    if (options.tenantModel && options.als) {
+                        const tenant = options.als.get(options.continuationTenantKey);
+                        if (tenant) {
+                            revisionData[options.tenantModelAttribute] = tenant;
+                        }
+                    }
+                    // Save revision
+                    const Revision = sequelize.models[options.revisionModel];
+                    if (Revision) {
+                        Revision.create(revisionData).catch((err) => {
+                            if (failHard) {
+                                throw err;
+                            }
+                            else {
+                                log('Error creating revision:', err);
+                            }
+                        });
+                    }
+                }
+            };
+            return afterHook;
+        }
+        // Add hooks to all models
+        Object.keys(sequelize.models).forEach(modelName => {
+            const model = sequelize.models[modelName];
+            // Add before hooks
+            model.addHook('beforeCreate', createBeforeHook('create'));
+            model.addHook('beforeUpdate', createBeforeHook('update'));
+            model.addHook('beforeDestroy', createBeforeHook('destroy'));
+            // Add after hooks
+            model.addHook('afterCreate', createAfterHook('create'));
+            model.addHook('afterUpdate', createAfterHook('update'));
+            model.addHook('afterDestroy', createAfterHook('destroy'));
+        });
+    },
+    hasPaperTrail: function hasPaperTrail() {
+        return Sequelize !== null;
+    },
+    defineModels: function defineModels(db) {
+        if (!Sequelize) {
+            throw new Error('PaperTrail not initialized. Call paperTrail.init() first.');
+        }
+        const Revision = db.define('Revision', {
+            id: {
+                type: Sequelize.INTEGER,
+                primaryKey: true,
+                autoIncrement: true
+            },
+            documentId: {
+                type: Sequelize.STRING,
+                allowNull: false
+            },
+            revision: {
+                type: Sequelize.INTEGER,
+                allowNull: false
+            },
+            document: {
+                type: Sequelize.TEXT,
+                allowNull: false
+            },
+            operation: {
+                type: Sequelize.STRING,
+                allowNull: false
+            },
+            changes: {
+                type: Sequelize.TEXT,
+                allowNull: true
+            },
+            userId: {
+                type: Sequelize.INTEGER,
+                allowNull: true
+            },
+            tenantId: {
+                type: Sequelize.INTEGER,
+                allowNull: true
+            },
+            createdAt: {
+                type: Sequelize.DATE,
+                allowNull: false
+            }
+        }, {
+            tableName: 'revisions',
+            timestamps: false
+        });
+        // Add associations if user and tenant models exist
+        if (db.models.User) {
+            Revision.belongsTo(db.models.User, { foreignKey: 'userId' });
+        }
+        if (db.models.Tenant) {
+            Revision.belongsTo(db.models.Tenant, { foreignKey: 'tenantId' });
+        }
+        Revision.associate = function associate(models) {
+            if (models.User) {
+                Revision.belongsTo(models.User, { foreignKey: 'userId' });
+            }
+            if (models.Tenant) {
+                Revision.belongsTo(models.Tenant, { foreignKey: 'tenantId' });
+            }
+        };
+    }
+};
+export default paperTrail;
+//# sourceMappingURL=index.js.map

package/dist/ts/paper-trail/index.js.map

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

package/dist/ts/prompts/index.d.ts

@@ -0,0 +1,21 @@
+import { ArgumentParser } from 'argparse';
+interface CLIInitOptions {
+    asyncFcns?: (() => Promise<void>)[];
+    extraFcns?: (() => void)[];
+    sleepTime?: number;
+}
+interface PromptOptions {
+    [key: string]: {
+        type: string;
+        description?: string;
+        required?: boolean;
+        default?: any;
+    };
+}
+declare const setupCLIParser: (description: string) => ArgumentParser;
+declare const commonCLIInit: (options?: CLIInitOptions) => Promise<void>;
+declare const promptCLIAsync: (options: PromptOptions) => Promise<Record<string, any>>;
+declare const waitCLIPrompt: PromptOptions;
+declare const continueCLIPrompt: PromptOptions;
+declare const cliSleep: (ms: number) => Promise<void>;
+export { commonCLIInit, continueCLIPrompt, promptCLIAsync, setupCLIParser, cliSleep, waitCLIPrompt, type CLIInitOptions, type PromptOptions };

package/dist/ts/prompts/index.js

@@ -0,0 +1,68 @@
+/* Essentia Common Prompt Functions */
+// This file contains common prompt functions that are used in CLI scripts
+//  that are run in the each project.  These functions are used to
+//  prompt the user for input and to wait for the user to press enter
+//  before continuing.  This is useful for scripts that are run in the
+//  command line and need to wait for the user to do something before
+//  continuing.
+import { S4Logger } from "../logger/s4-logger.js";
+import { ArgumentParser } from 'argparse';
+import prompt from "prompt";
+const logger = new S4Logger();
+// New common argument parser which makes parsing and setting up commandline options easier
+const setupCLIParser = (description) => {
+    logger.info(description);
+    return new ArgumentParser({ description });
+};
+// a common init function which waits for the command prompt to be delivered
+// a common use is for the awaiting of the queues to initialize before running
+const commonCLIInit = async (options = {}) => {
+    //add in defaults to options if they have not been specified or object is {}
+    const defaultOptions = {
+        asyncFcns: [],
+        extraFcns: [],
+        sleepTime: 1000,
+        ...options
+    };
+    // Sleep for 1 second to allow the prompt to be displayed
+    // at the end of bootstrap logs
+    await cliSleep(defaultOptions.sleepTime);
+    defaultOptions.extraFcns.forEach(fcn => {
+        fcn();
+    });
+    for (const fcn of defaultOptions.asyncFcns) {
+        await fcn();
+    }
+};
+const promptCLIAsync = async (options) => {
+    return new Promise((resolve, reject) => {
+        prompt.start();
+        prompt.get(options, (err, res) => {
+            if (err) {
+                reject(err);
+            }
+            else {
+                resolve(res);
+            }
+        });
+    });
+};
+// A predefined waitPrompt for use at the end of the scripts that use
+//  message queues.  Message Queues often take a bit to fire
+const waitCLIPrompt = {
+    "Push <enter> when done": {
+        type: "boolean"
+    }
+};
+const continueCLIPrompt = {
+    "Push <enter> to continue": {
+        type: "boolean"
+    }
+};
+const cliSleep = async (ms) => {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+};
+export { commonCLIInit, continueCLIPrompt, promptCLIAsync, setupCLIParser, cliSleep, waitCLIPrompt };
+//# sourceMappingURL=index.js.map