@tasenor/common-node 1.9.32 → 1.9.34

package/dist/src/plugins/plugins.js.map

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

package/dist/src/process/Process.d.ts

@@ -0,0 +1,108 @@
+import { ProcessFile } from './ProcessFile';
+import { ProcessingSystem } from './ProcessingSystem';
+import { ProcessStep } from './ProcessStep';
+import { ProcessName, ProcessConfig, ProcessStatus, ID, ImportAction, ImportState } from '@tasenor/common';
+import { KnexDatabase } from '../database';
+/**
+ * Overall description of the process.
+ */
+export interface ProcessInfo {
+    name: ProcessName;
+    config: ProcessConfig;
+    complete: boolean;
+    successful: boolean | undefined;
+    currentStep: number | undefined;
+    status: ProcessStatus;
+    error?: string;
+}
+/**
+ * A complete description of the process state and steps taken.
+ */
+export declare class Process {
+    system: ProcessingSystem;
+    id: ID;
+    name: ProcessName;
+    config: ProcessConfig;
+    complete: boolean;
+    successful: boolean | undefined;
+    currentStep: number | undefined;
+    status: ProcessStatus;
+    files: ProcessFile[];
+    steps: ProcessStep[];
+    error: string | undefined;
+    constructor(system: ProcessingSystem, name: ProcessName | null, config?: ProcessConfig);
+    toString(): string;
+    /**
+     * Get the loaded process information as JSON object.
+     * @returns
+     */
+    toJSON(): ProcessInfo;
+    /**
+     * Append a file to this process and link its ID.
+     * @param file
+     */
+    addFile(file: ProcessFile): void;
+    /**
+     * Append a step to this process and link its ID.
+     * @param step
+     */
+    addStep(step: ProcessStep): Promise<void>;
+    /**
+     * Load the current step if not yet loaded and return it.
+     */
+    getCurrentStep(): Promise<ProcessStep>;
+    /**
+     * Mark the current state as completed and create new additional step with the new state.
+     * @param state
+     */
+    proceedToState(action: ImportAction, state: ImportState): Promise<void>;
+    /**
+     * Get a reference to the database.
+     */
+    get db(): KnexDatabase;
+    /**
+     * Save the process info to the database.
+     */
+    save(): Promise<ID>;
+    /**
+     * Load the process data and its files. Note that current step is not yet loaded here, but when using getCurrentStep().
+     * @param id
+     */
+    load(id: ID): Promise<void>;
+    /**
+     * Load the step with the given number from the database.
+     * @param number
+     * @returns
+     */
+    loadStep(number: number): Promise<ProcessStep>;
+    /**
+     * Check if the process can be run.
+     */
+    canRun(): boolean;
+    /**
+     * Execute process as long as it is completed, failed or requires additional input.
+     */
+    run(): Promise<void>;
+    /**
+     * Record the error and mark the process as finished with an error.
+     * @param err
+     */
+    crashed(err: Error): Promise<void>;
+    /**
+     * Resolve the status of the process and update it to the database.
+     */
+    updateStatus(): Promise<void>;
+    /**
+     * Get the state of the current step of the process.
+     */
+    get state(): ImportState;
+    /**
+     * Handle external input coming in.
+     * @param action
+     */
+    input(action: ImportAction): Promise<void>;
+    /**
+     * Roll back the process.
+     */
+    rollback(): Promise<boolean>;
+}

package/dist/src/process/Process.js

@@ -0,0 +1,335 @@
+import clone from 'clone';
+import { BadState, DatabaseError, InvalidArgument, isAskUI } from '../error';
+import { ProcessFile } from './ProcessFile';
+import { ProcessStep } from './ProcessStep';
+import { Directions } from '@tasenor/common';
+/**
+ * A complete description of the process state and steps taken.
+ */
+export class Process {
+    system;
+    id;
+    name;
+    config;
+    complete;
+    successful;
+    currentStep;
+    status;
+    files;
+    steps;
+    error;
+    constructor(system, name, config = {}) {
+        this.system = system;
+        this.id = null;
+        this.config = config;
+        this.name = name || '[no name]';
+        this.complete = false;
+        this.successful = undefined;
+        this.files = [];
+        this.steps = [];
+        this.currentStep = undefined;
+        this.status = 'INCOMPLETE';
+    }
+    toString() {
+        return `Process #${this.id} ${this.name}`;
+    }
+    /**
+     * Get the loaded process information as JSON object.
+     * @returns
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            config: this.config,
+            complete: this.complete,
+            successful: this.successful,
+            currentStep: this.currentStep,
+            status: this.status,
+            error: this.error
+        };
+    }
+    /**
+     * Append a file to this process and link its ID.
+     * @param file
+     */
+    addFile(file) {
+        file.processId = this.id;
+        this.files.push(file);
+    }
+    /**
+     * Append a step to this process and link its ID.
+     * @param step
+     */
+    async addStep(step) {
+        step.processId = this.id;
+        step.process = this;
+        this.steps.push(step);
+    }
+    /**
+     * Load the current step if not yet loaded and return it.
+     */
+    async getCurrentStep() {
+        if (this.currentStep === null || this.currentStep === undefined) {
+            throw new BadState(`Process #${this.id} ${this.name} has invalid current step.`);
+        }
+        if (this.steps[this.currentStep]) {
+            return this.steps[this.currentStep];
+        }
+        return this.loadStep(this.currentStep);
+    }
+    /**
+     * Mark the current state as completed and create new additional step with the new state.
+     * @param state
+     */
+    async proceedToState(action, state) {
+        const current = await this.getCurrentStep();
+        const handler = this.system.getHandler(current.handler);
+        current.action = action;
+        current.finished = new Date();
+        current.save();
+        const nextStep = new ProcessStep({
+            number: current.number + 1,
+            state,
+            handler: handler.name
+        });
+        this.addStep(nextStep);
+        this.currentStep = (this.currentStep || 0) + 1;
+        this.system.logger.info(`Proceeding ${this} to new step ${this.currentStep}.`);
+        this.save();
+        await nextStep.save();
+        await this.system.checkFinishAndFindDirections(handler, nextStep);
+    }
+    /**
+     * Get a reference to the database.
+     */
+    get db() {
+        return this.system.db;
+    }
+    /**
+     * Save the process info to the database.
+     */
+    async save() {
+        if (this.id) {
+            await this.db('processes').update(this.toJSON()).where({ id: this.id });
+            return this.id;
+        }
+        else {
+            this.id = (await this.db('processes').insert(this.toJSON()).returning('id'))[0].id;
+            if (this.id)
+                return this.id;
+            throw new DatabaseError(`Saving process ${JSON.stringify(this.toJSON)} failed.`);
+        }
+    }
+    /**
+     * Load the process data and its files. Note that current step is not yet loaded here, but when using getCurrentStep().
+     * @param id
+     */
+    async load(id) {
+        // Load basic info.
+        const data = await this.db('processes').select('*').where({ id }).first();
+        if (!data) {
+            throw new InvalidArgument(`Cannot find process #${id}`);
+        }
+        Object.assign(this, data);
+        this.id = id;
+        // Load files.
+        this.files = (await this.db('process_files').select('*').where({ processId: this.id })).map(fileData => {
+            const file = new ProcessFile(fileData);
+            file.id = fileData.id;
+            return file;
+        });
+        // Load current step.
+        await this.getCurrentStep();
+    }
+    /**
+     * Load the step with the given number from the database.
+     * @param number
+     * @returns
+     */
+    async loadStep(number) {
+        if (!this.id) {
+            throw new BadState(`Cannot load steps, if the process have no ID ${JSON.stringify(this.toJSON())}.`);
+        }
+        if (this.currentStep === undefined) {
+            throw new BadState(`Cannot load any steps, since process have no current step ${JSON.stringify(this.toJSON())}.`);
+        }
+        const data = await this.db('process_steps').where({ processId: this.id, number }).first();
+        if (!data) {
+            throw new BadState(`Cannot find step ${this.currentStep} for process ${JSON.stringify(this.toJSON())}.`);
+        }
+        this.steps[this.currentStep] = new ProcessStep(data);
+        this.steps[this.currentStep].id = data.id;
+        this.steps[this.currentStep].process = this;
+        return this.steps[this.currentStep];
+    }
+    /**
+     * Check if the process can be run.
+     */
+    canRun() {
+        return !this.complete && (this.status === 'INCOMPLETE' || this.status === 'WAITING');
+    }
+    /**
+     * Execute process as long as it is completed, failed or requires additional input.
+     */
+    async run() {
+        let step;
+        let MAX_RUNS = 100;
+        while (true) {
+            MAX_RUNS--;
+            if (MAX_RUNS < 0) {
+                this.system.logger.error(`Maximum number of executions reached for the process ${this}.`);
+                break;
+            }
+            step = await this.getCurrentStep();
+            if (!step.directions) {
+                this.system.logger.info(`No new directions for the process ${this}.`);
+                break;
+            }
+            if (!step.directions.isImmediate()) {
+                this.system.logger.info(`Waiting for more input for the process ${this}.`);
+                await this.updateStatus();
+                break;
+            }
+            const handler = this.system.getHandler(step.handler);
+            const state = clone(step.state);
+            const action = clone(step.directions.action);
+            try {
+                if (action) {
+                    const nextState = await handler.action(this, action, state, this.files);
+                    await this.proceedToState(action, nextState);
+                }
+                else {
+                    throw new BadState(`Process step ${step} has no action.`);
+                }
+            }
+            catch (err) {
+                return await this.crashed(err);
+            }
+        }
+    }
+    /**
+     * Record the error and mark the process as finished with an error.
+     * @param err
+     */
+    async crashed(err) {
+        if (isAskUI(err)) {
+            // Postpone the action we tried. Instead, create query for UI to add more configuration for later retry.
+            const directions = new Directions({
+                type: 'ui',
+                element: err.element
+            });
+            const step = await this.getCurrentStep();
+            step.directions = directions;
+            await step.save();
+            await this.updateStatus();
+            return;
+        }
+        this.system.logger.error(`Processing of ${this} failed:`, err);
+        if (this.currentStep !== undefined && this.currentStep !== null) {
+            const step = await this.loadStep(this.currentStep);
+            step.finished = new Date();
+            await step.save();
+        }
+        this.error = err.stack ? err.stack : `${err.name}: ${err.message}`;
+        await this.save();
+        await this.updateStatus();
+    }
+    /**
+     * Resolve the status of the process and update it to the database.
+     */
+    async updateStatus() {
+        let status = 'INCOMPLETE';
+        if (this.error) {
+            status = 'CRASHED';
+        }
+        else {
+            if (this.currentStep === null || this.currentStep === undefined) {
+                throw new BadState(`Cannot check status when there is no current step loaded for ${this}`);
+            }
+            const step = this.steps[this.currentStep];
+            if (step.finished) {
+                if (this.successful === true)
+                    status = 'SUCCEEDED';
+                if (this.successful === false)
+                    status = 'FAILED';
+            }
+            if (step.directions) {
+                status = step.directions.isImmediate() ? 'INCOMPLETE' : 'WAITING';
+            }
+        }
+        if (this.status !== status) {
+            this.system.logger.info(`Process ${this} is now ${status}`);
+        }
+        this.status = status;
+        await this.db('processes').update({ status }).where({ id: this.id });
+        let directions, state;
+        switch (status) {
+            case 'SUCCEEDED':
+                await this.system.connector.success(this.state);
+                break;
+            case 'CRASHED':
+                await this.system.connector.fail(this.error);
+                break;
+            case 'FAILED':
+                await this.system.connector.fail(this.state);
+                break;
+            default:
+                directions = this.currentStep ? this.steps[this.currentStep].directions : null;
+                state = this.currentStep ? this.steps[this.currentStep].state : null;
+                await this.system.connector.waiting(state, directions);
+        }
+    }
+    /**
+     * Get the state of the current step of the process.
+     */
+    get state() {
+        if (this.currentStep === null || this.currentStep === undefined) {
+            throw new BadState(`Cannot check state when there is no current step loaded for ${this}`);
+        }
+        const step = this.steps[this.currentStep];
+        return step.state;
+    }
+    /**
+     * Handle external input coming in.
+     * @param action
+     */
+    async input(action) {
+        this.system.logger.info(`Handling input ${JSON.stringify(action)} on process ${this}.`);
+        const step = await this.getCurrentStep();
+        const handler = this.system.getHandler(step.handler);
+        let nextState;
+        try {
+            nextState = await handler.action(this, action, clone(step.state), this.files);
+        }
+        catch (err) {
+            return this.crashed(err);
+        }
+        await this.proceedToState(action, nextState);
+    }
+    /**
+     * Roll back the process.
+     */
+    async rollback() {
+        if (this.currentStep === null || this.currentStep === undefined) {
+            throw new BadState('Cannot rollback when there is no current step.');
+        }
+        if (this.currentStep < 1) {
+            throw new BadState('Cannot rollback when there is only initial step in the process.');
+        }
+        const step = await this.getCurrentStep();
+        this.system.logger.info(`Attempt of rolling back '${step}' from '${this}'.`);
+        const handler = this.system.getHandler(step.handler);
+        await handler.rollback(this, this.state);
+        const current = await this.getCurrentStep();
+        current.action = { rollback: true };
+        current.finished = new Date();
+        current.save();
+        this.system.logger.info(`Proceeding ${this} to new step ${this.currentStep}.`);
+        this.save();
+        this.status = 'ROLLEDBACK';
+        await this.db('processes').update({ status: this.status }).where({ id: this.id });
+        this.system.logger.info(`Roll back of '${this}' successful.`);
+        return true;
+    }
+}
+//# sourceMappingURL=Process.js.map

package/dist/src/process/Process.js.map

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

package/dist/src/process/ProcessConnector.d.ts

@@ -0,0 +1,24 @@
+import { ID } from '@tasenor/common';
+/**
+ * A connector interface for querying information, applying results and running various hooks.
+ */
+export interface ProcessConnector {
+    initialize(server: unknown): Promise<void>;
+    getTranslation(text: string, language: string): Promise<string>;
+    resultExists(processId: ID, args: unknown): Promise<boolean>;
+    applyResult(processId: ID, args: unknown): Promise<Record<string, unknown>>;
+    rollback(processId: ID): Promise<boolean>;
+    success(state: unknown): Promise<void>;
+    waiting(state: unknown, directions: any): Promise<void>;
+    fail(state: unknown): Promise<void>;
+}
+export declare const defaultConnector: {
+    initialize(): Promise<void>;
+    resultExists(processId: ID, args: unknown): Promise<boolean>;
+    applyResult(): Promise<Record<string, unknown>>;
+    success(): Promise<void>;
+    waiting(): Promise<void>;
+    fail(): Promise<void>;
+    getTranslation(text: string): Promise<string>;
+    rollback(processId: ID): Promise<boolean>;
+};

package/dist/src/process/ProcessConnector.js

@@ -0,0 +1,28 @@
+export const defaultConnector = {
+    async initialize() {
+        console.log(new Date(), 'Connector initialized.');
+    },
+    async resultExists(processId, args) {
+        return false;
+    },
+    async applyResult() {
+        console.log(new Date(), 'Result received.');
+        return {};
+    },
+    async success() {
+        console.log(new Date(), 'Process completed.');
+    },
+    // eslint-disable-next-line @typescript-eslint/no-empty-function
+    async waiting() {
+    },
+    async fail() {
+        console.error(new Date(), 'Process failed.');
+    },
+    async getTranslation(text) {
+        return text;
+    },
+    async rollback(processId) {
+        return true;
+    }
+};
+//# sourceMappingURL=ProcessConnector.js.map

package/dist/src/process/ProcessConnector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessConnector.js","sourceRoot":"","sources":["../../../src/process/ProcessConnector.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,KAAK,CAAC,UAAU;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,wBAAwB,CAAC,CAAA;IACnD,CAAC;IACD,KAAK,CAAC,YAAY,CAAC,SAAa,EAAE,IAAa;QAC7C,OAAO,KAAK,CAAA;IACd,CAAC;IACD,KAAK,CAAC,WAAW;QACf,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,kBAAkB,CAAC,CAAA;QAC3C,OAAO,EAAE,CAAA;IACX,CAAC;IACD,KAAK,CAAC,OAAO;QACX,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,oBAAoB,CAAC,CAAA;IAC/C,CAAC;IACD,gEAAgE;IAChE,KAAK,CAAC,OAAO;IACb,CAAC;IACD,KAAK,CAAC,IAAI;QACR,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,iBAAiB,CAAC,CAAA;IAC9C,CAAC;IACD,KAAK,CAAC,cAAc,CAAC,IAAY;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,KAAK,CAAC,QAAQ,CAAC,SAAa;QAC1B,OAAO,IAAI,CAAA;IACb,CAAC;CAEF,CAAA"}

package/dist/src/process/ProcessFile.d.ts

@@ -0,0 +1,69 @@
+import { ID, FileEncoding } from '@tasenor/common';
+import { KnexDatabase } from '../database';
+/**
+ * A data structure containing input data for the process.
+ */
+export interface ProcessFileData {
+    processId?: ID;
+    name: string;
+    type?: string;
+    encoding: FileEncoding;
+    data: string;
+}
+/**
+ * An instance of input data for processing.
+ */
+export declare class ProcessFile {
+    id: ID;
+    processId: ID;
+    name: string;
+    type?: string;
+    encoding: FileEncoding;
+    data: string;
+    _decoded?: string;
+    constructor(obj: ProcessFileData);
+    toString(): string;
+    /**
+     * Get the loaded process information as JSON object.
+     * @returns
+     */
+    toJSON(): ProcessFileData;
+    /**
+     * Save the file to the database.
+     */
+    save(db: KnexDatabase): Promise<ID>;
+    /**
+     * Check if the first line of the text file matches to the regular expression.
+     * @param re
+     */
+    firstLineMatch(re: RegExp): boolean;
+    /**
+     * Check if the second line of the text file matches to the regular expression.
+     * @param re
+     */
+    secondLineMatch(re: RegExp): boolean;
+    /**
+     * Check if the third line of the text file matches to the regular expression.
+     * @param re
+     */
+    thirdLineMatch(re: RegExp): boolean;
+    /**
+     * Check if the file begins with the given string.
+     */
+    startsWith(s: string): boolean;
+    /**
+     * Find out if the content is binary or text.
+     *
+     * The mime type has to start with `text/`.
+     */
+    isTextFile(): boolean;
+    /**
+     * Convert chardet encoding to the supported buffer encoding
+     * "ascii" | "utf8" | "utf-8" | "utf16le" | "ucs2" | "ucs-2" | "base64" | "latin1" | "binary" | "hex"
+     */
+    parseEncoding(encoding: string): 'ascii' | 'utf8' | 'utf-8' | 'utf16le' | 'ucs2' | 'ucs-2' | 'base64' | 'latin1' | 'binary' | 'hex';
+    /**
+     * Try to recognize the file content and decode if it is a recognizable text format.
+     */
+    decode(): string;
+}