@wabot-dev/framework 0.1.0-beta.4 → 0.1.0-beta.40

package/dist/src/core/env/Env.js

@@ -0,0 +1,39 @@
+import { __decorate, __metadata } from 'tslib';
+import { singleton } from '../injection/index.js';
+
+let Env = class Env {
+    envType;
+    constructor() {
+        this.envType = process.env.WABOT_ENV ?? 'development';
+    }
+    isDevelopment() {
+        return this.envType === 'development';
+    }
+    isProduction() {
+        return this.envType === 'production';
+    }
+    isTesting() {
+        return this.envType === 'testing';
+    }
+    requireString(varName, options) {
+        const value = process.env[varName] ?? options?.default;
+        if (!value)
+            throw new Error(`Env Variable ${varName} is required`);
+        return value;
+    }
+    requireNumber(varName, options) {
+        const strValue = this.requireString(varName, {
+            default: options?.default != null ? String(options.default) : undefined,
+        });
+        const value = Number(strValue);
+        if (isNaN(value))
+            throw new Error(`Env Variable ${varName} should have number format`);
+        return value;
+    }
+};
+Env = __decorate([
+    singleton(),
+    __metadata("design:paramtypes", [])
+], Env);
+
+export { Env };

package/dist/src/core/error/CustomError.js

@@ -0,0 +1,15 @@
+class CustomError extends Error {
+    humanMessage;
+    code;
+    httpCode;
+    info;
+    constructor(data) {
+        super(data.message, { cause: data.cause });
+        this.humanMessage = data.humanMessage;
+        this.code = data.code;
+        this.httpCode = data.httpCode;
+        this.info = data.info;
+    }
+}
+
+export { CustomError };

package/dist/src/core/injection/index.js

@@ -0,0 +1,4 @@
+await import('reflect-metadata');
+const { injectable, container, singleton, inject, scoped, Lifecycle } = await import('tsyringe');
+
+export { Lifecycle, container, inject, injectable, scoped, singleton };

package/dist/src/core/mapper/Mapper.js

@@ -0,0 +1,42 @@
+import { Storable } from '../storable/Storable.js';
+import { CustomError } from '../error/CustomError.js';
+import '../injection/index.js';
+import '../validation/metadata/ValidationMetadataStore.js';
+import { validate } from '../validation/validate.js';
+
+function deepCopyWithStorable(obj) {
+    if (obj === null || typeof obj !== 'object') {
+        return obj;
+    }
+    if (obj instanceof Date) {
+        return obj.getTime();
+    }
+    if (obj instanceof Storable) {
+        return deepCopyWithStorable(obj['data']);
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item) => deepCopyWithStorable(item));
+    }
+    const copy = {};
+    for (const key in obj) {
+        if (Object.prototype.hasOwnProperty.call(obj, key)) {
+            copy[key] = deepCopyWithStorable(obj[key]);
+        }
+    }
+    return copy;
+}
+class Mapper {
+    map(data, ctor) {
+        const validationResult = validate(deepCopyWithStorable(data), ctor);
+        if (validationResult.error) {
+            throw new CustomError({
+                httpCode: 500,
+                message: `Cant map value to ${ctor.name}`,
+                info: validationResult.error,
+            });
+        }
+        return validationResult.value;
+    }
+}
+
+export { Mapper };

package/dist/src/core/random/Random.js

@@ -0,0 +1,37 @@
+import { randomBytes } from 'node:crypto';
+
+const DIGITS = '0123456789';
+const CHARSET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+class Random {
+    static slug(name, options) {
+        const base = name
+            .toLowerCase()
+            .trim()
+            .replace(/[\s\_]+/g, '-') // spaces/underscores to hyphens
+            .replace(/[^a-z0-9\-]/g, '') // remove non-alphanumeric except hyphens
+            .replace(/\-+/g, '-') // collapse multiple hyphens
+            .replace(/^\-+|\-+$/g, ''); // trim hyphens from ends
+        const random = this.string(options.randomLength);
+        return `${base}-${random}`;
+    }
+    static string(length) {
+        const bytes = randomBytes(length);
+        let result = '';
+        for (let i = 0; i < length; i++) {
+            const index = bytes[i] % CHARSET.length;
+            result += CHARSET[index];
+        }
+        return result;
+    }
+    static numberCode(length) {
+        const bytes = randomBytes(length);
+        let result = '';
+        for (let i = 0; i < length; i++) {
+            const index = bytes[i] % 10; // 0–9
+            result += DIGITS[index];
+        }
+        return result;
+    }
+}
+
+export { Random };

package/dist/src/core/storable/Storable.js

@@ -0,0 +1,8 @@
+class Storable {
+    data;
+    constructor(data) {
+        this.data = data;
+    }
+}
+
+export { Storable };

package/dist/src/core/validation/metadata/@isArray.js

@@ -0,0 +1,18 @@
+import { container } from '../../injection/index.js';
+import { validateArray } from '../validators/validateArray.js';
+import { ValidationMetadataStore } from './ValidationMetadataStore.js';
+
+function isArray(options) {
+    return function (target, propertyKey) {
+        const propertyName = propertyKey.toString();
+        const store = container.resolve(ValidationMetadataStore);
+        store.saveValidatorMetadata({
+            modelConstructor: target.constructor,
+            propertyName,
+            validator: validateArray,
+            validatorOptions: options,
+        });
+    };
+}
+
+export { isArray };

package/dist/src/core/validation/metadata/@isModel.js

@@ -0,0 +1,18 @@
+import { container } from '../../injection/index.js';
+import { validateModel } from '../validators/validateModel.js';
+import { ValidationMetadataStore } from './ValidationMetadataStore.js';
+
+function isModel(model) {
+    return function (target, propertyKey) {
+        const propertyName = propertyKey.toString();
+        const store = container.resolve(ValidationMetadataStore);
+        store.saveValidatorMetadata({
+            modelConstructor: target.constructor,
+            propertyName,
+            validator: validateModel,
+            validatorOptions: store.getModelValidatorsInfo(model),
+        });
+    };
+}
+
+export { isModel };

package/dist/src/core/validation/metadata/@isOptional.js

@@ -0,0 +1,17 @@
+import { container } from '../../injection/index.js';
+import { ValidationMetadataStore } from './ValidationMetadataStore.js';
+import { _IS_OPTIONAL_DUMMY_VALIDATOR_ } from '../validators/validateIsOptional.js';
+
+function isOptional() {
+    return function (target, propertyKey) {
+        const propertyName = propertyKey.toString();
+        const store = container.resolve(ValidationMetadataStore);
+        store.saveValidatorMetadata({
+            modelConstructor: target.constructor,
+            propertyName,
+            validator: _IS_OPTIONAL_DUMMY_VALIDATOR_,
+        });
+    };
+}
+
+export { isOptional };

package/dist/src/core/validation/metadata/ValidationMetadataStore.js

@@ -0,0 +1,98 @@
+import { __decorate } from 'tslib';
+import { singleton } from '../../injection/index.js';
+import { _IS_OPTIONAL_DUMMY_VALIDATOR_ } from '../validators/validateIsOptional.js';
+import { validateArray } from '../validators/validateArray.js';
+
+function getClassHierarchy(cls) {
+    const classes = [];
+    let proto = Object.getPrototypeOf(cls.prototype);
+    while (proto && proto.constructor !== Object) {
+        classes.push(proto.constructor);
+        proto = Object.getPrototypeOf(proto);
+    }
+    return classes;
+}
+let ValidationMetadataStore = class ValidationMetadataStore {
+    validators = new Map();
+    saveValidatorMetadata(validatorMetadata) {
+        let modelValidators = this.validators.get(validatorMetadata.modelConstructor);
+        if (!modelValidators) {
+            this.validators.set(validatorMetadata.modelConstructor, (modelValidators = new Map()));
+        }
+        let propertyValidators = modelValidators.get(validatorMetadata.propertyName);
+        if (!propertyValidators) {
+            propertyValidators = [];
+            modelValidators.set(validatorMetadata.propertyName, propertyValidators);
+        }
+        propertyValidators.unshift(validatorMetadata);
+        const arrayValidatorMetadata = propertyValidators.find((x) => x.validator === validateArray);
+        if (!arrayValidatorMetadata) {
+            return;
+        }
+        if (!arrayValidatorMetadata.validatorOptions) {
+            arrayValidatorMetadata.validatorOptions = {};
+        }
+        const arrayValidatorOptions = arrayValidatorMetadata.validatorOptions;
+        if (!arrayValidatorOptions.itemsValidator) {
+            arrayValidatorOptions.itemsValidator = [];
+        }
+        const removeValidatorsMetadata = [];
+        for (const validatorMetadata of propertyValidators) {
+            if (validatorMetadata.validator === validateArray ||
+                validatorMetadata.validator === _IS_OPTIONAL_DUMMY_VALIDATOR_) {
+                continue;
+            }
+            arrayValidatorOptions.itemsValidator.push({
+                options: validatorMetadata.validatorOptions,
+                validator: validatorMetadata.validator,
+            });
+            removeValidatorsMetadata.push(validatorMetadata);
+        }
+        for (const toRemove of removeValidatorsMetadata) {
+            const indexToRemove = propertyValidators.indexOf(toRemove);
+            propertyValidators.splice(indexToRemove, 1);
+        }
+    }
+    getModelValidatorsInfo(modelConstructor) {
+        const constructors = getClassHierarchy(modelConstructor);
+        constructors.unshift(modelConstructor);
+        const modelValidators = {
+            modelConstructor: modelConstructor,
+            properties: Object.assign({}, ...constructors.map((x) => this.getConstructorPropertiesValidatorsInfo(x))),
+        };
+        return modelValidators;
+    }
+    getConstructorPropertiesValidatorsInfo(modelConstructor) {
+        const properties = {};
+        [...(this.validators.get(modelConstructor)?.values() ?? [])].forEach((propertyValidatorsMetadata) => {
+            const propertyName = propertyValidatorsMetadata.at(0)?.propertyName;
+            if (!propertyName) {
+                return;
+            }
+            let propertyInfo = properties[propertyName];
+            if (!propertyInfo) {
+                propertyInfo = {};
+                properties[propertyName] = propertyInfo;
+            }
+            let validators = propertyInfo.validators;
+            if (!validators) {
+                validators = [];
+                propertyInfo.validators = validators;
+            }
+            propertyValidatorsMetadata.forEach((propertyValidatorMetadata) => {
+                if (propertyValidatorMetadata.validator === _IS_OPTIONAL_DUMMY_VALIDATOR_) {
+                    propertyInfo.isOptional = true;
+                }
+                else {
+                    validators.push(propertyValidatorMetadata);
+                }
+            });
+        });
+        return properties;
+    }
+};
+ValidationMetadataStore = __decorate([
+    singleton()
+], ValidationMetadataStore);
+
+export { ValidationMetadataStore };

package/dist/src/core/validation/modelInfo.js

@@ -0,0 +1,9 @@
+import { container } from '../injection/index.js';
+import { ValidationMetadataStore } from './metadata/ValidationMetadataStore.js';
+
+function modelInfo(modelConstructor) {
+    const metadataStore = container.resolve(ValidationMetadataStore);
+    return metadataStore.getModelValidatorsInfo(modelConstructor);
+}
+
+export { modelInfo };

package/dist/src/core/validation/validate.js

@@ -0,0 +1,11 @@
+import { container } from '../injection/index.js';
+import { ValidationMetadataStore } from './metadata/ValidationMetadataStore.js';
+import { validateModel } from './validators/validateModel.js';
+
+function validate(value, modelConstructor) {
+    const metadataStore = container.resolve(ValidationMetadataStore);
+    const info = metadataStore.getModelValidatorsInfo(modelConstructor);
+    return validateModel(value, info);
+}
+
+export { validate };

package/dist/src/core/validation/validators/validateArray.js

@@ -0,0 +1,51 @@
+function validateArray(value, options) {
+    if (!Array.isArray(value)) {
+        return {
+            error: { description: 'Should be an array', items: [] },
+        };
+    }
+    if (options?.minLength != null && value.length < options.minLength) {
+        return {
+            error: { description: 'exceeds the established min length limit', items: [] },
+        };
+    }
+    if (options?.maxLength != null && value.length > options.maxLength) {
+        return {
+            error: { description: 'exceeds the established max length limit', items: [] },
+        };
+    }
+    const { itemsValidator } = options ?? {};
+    const valueOut = [];
+    const errorItems = [];
+    for (const item of value) {
+        let itemOut = item;
+        const itemErrors = [];
+        for (const itemValidator of itemsValidator ?? []) {
+            const { error, value } = itemValidator.validator(itemOut, itemValidator.options);
+            if (error) {
+                itemErrors.push(error);
+            }
+            else {
+                itemOut = value;
+            }
+        }
+        if (itemErrors.length == 0) {
+            valueOut.push(itemOut);
+            errorItems.push(null);
+        }
+        else {
+            valueOut.push(null);
+            errorItems.push(itemErrors);
+        }
+    }
+    if (errorItems.some((x) => x != null)) {
+        return {
+            error: { description: 'Error on some items', items: errorItems },
+        };
+    }
+    return {
+        value: valueOut,
+    };
+}
+
+export { validateArray };

package/dist/src/core/validation/validators/validateIsOptional.js

@@ -0,0 +1,5 @@
+const _IS_OPTIONAL_DUMMY_VALIDATOR_ = (value) => {
+    return { value, errors: [] };
+};
+
+export { _IS_OPTIONAL_DUMMY_VALIDATOR_ };

package/dist/src/core/validation/validators/validateModel.js

@@ -0,0 +1,36 @@
+function validateModel(value, info) {
+    if (typeof value !== 'object' || value === null) {
+        return { error: { description: 'Invalid object', properties: {} } };
+    }
+    let propertiesErrors = {};
+    let resultValue = new info.modelConstructor();
+    for (const propertyName in info.properties) {
+        const propertyInfo = info.properties[propertyName];
+        const propertyValidators = propertyInfo.validators ?? [];
+        resultValue[propertyName] = propertyInfo.isOptional
+            ? (value[propertyName] ?? resultValue[propertyName])
+            : value[propertyName];
+        if (resultValue[propertyName] == null && propertyInfo.isOptional) {
+            resultValue[propertyName] = undefined;
+            continue;
+        }
+        for (let propertyValidatorInfo of propertyValidators) {
+            const propertyValidatorResult = propertyValidatorInfo.validator(resultValue[propertyName], propertyValidatorInfo.validatorOptions);
+            resultValue[propertyName] = propertyValidatorResult.value;
+            if (propertyValidatorResult.error) {
+                let propertyErrors = propertiesErrors[propertyName];
+                if (!propertyErrors) {
+                    propertyErrors = [];
+                    propertiesErrors[propertyName] = propertyErrors;
+                }
+                propertyErrors.push(propertyValidatorResult.error.description);
+            }
+        }
+    }
+    if (Object.keys(propertiesErrors).length > 0) {
+        return { error: { description: 'Invalid properties', properties: propertiesErrors } };
+    }
+    return { value: resultValue };
+}
+
+export { validateModel };

package/dist/src/feature/async/@command.js

@@ -0,0 +1,11 @@
+import { CommandMetadataStore } from './CommandMetadataStore.js';
+import { container } from '../../core/injection/index.js';
+
+function command(config) {
+    return function (target) {
+        const handlerContainer = container.resolve(CommandMetadataStore);
+        handlerContainer.registerCommand(target, config?.name ?? target.name);
+    };
+}
+
+export { command };

package/dist/src/feature/async/@commandHandler.js

@@ -0,0 +1,12 @@
+import { CommandMetadataStore } from './CommandMetadataStore.js';
+import { container, injectable } from '../../core/injection/index.js';
+
+function commandHandler(config) {
+    return function (target) {
+        const handlerContainer = container.resolve(CommandMetadataStore);
+        handlerContainer.registerHandler(config.command, target);
+        injectable()(target);
+    };
+}
+
+export { commandHandler };

package/dist/src/feature/async/Async.js

@@ -0,0 +1,38 @@
+import { __decorate, __metadata } from 'tslib';
+import { singleton } from '../../core/injection/index.js';
+import { CommandMetadataStore } from './CommandMetadataStore.js';
+import { Job } from './Job.js';
+import { JobRepository } from './JobRepository.js';
+import { JobsEventsHub } from './JobsEventsHub.js';
+
+let Async = class Async {
+    jobRepository;
+    handlerContainer;
+    jobsEventsHub;
+    constructor(jobRepository, handlerContainer, jobsEventsHub) {
+        this.jobRepository = jobRepository;
+        this.handlerContainer = handlerContainer;
+        this.jobsEventsHub = jobsEventsHub;
+    }
+    async run(command) {
+        const commandName = this.handlerContainer.getCommandName(command.constructor);
+        if (!commandName) {
+            throw new Error(`${command.constructor.name} is not registered as command`);
+        }
+        const job = new Job({
+            commandName,
+            commandData: command['data'],
+        });
+        await this.jobRepository.create(job);
+        this.jobsEventsHub.notifyJobCreated(job);
+        return job;
+    }
+};
+Async = __decorate([
+    singleton(),
+    __metadata("design:paramtypes", [JobRepository,
+        CommandMetadataStore,
+        JobsEventsHub])
+], Async);
+
+export { Async };

package/dist/src/feature/async/Command.js

@@ -0,0 +1,9 @@
+import { Storable } from '../../core/storable/Storable.js';
+
+class Command extends Storable {
+    getData() {
+        return this.data;
+    }
+}
+
+export { Command };

package/dist/src/feature/async/CommandMetadataStore.js

@@ -0,0 +1,38 @@
+import { __decorate } from 'tslib';
+import { singleton } from '../../core/injection/index.js';
+
+let CommandMetadataStore = class CommandMetadataStore {
+    handlersMap = new Map();
+    handlersInverseMap = new Map();
+    commandsMap = new Map();
+    commandsInverseMap = new Map();
+    registerCommand(command, commandName) {
+        this.commandsMap.set(commandName, command);
+        this.commandsInverseMap.set(command, commandName);
+    }
+    registerHandler(command, handlerConstructor) {
+        let commandName = this.commandsInverseMap.get(command);
+        if (!commandName) {
+            throw new Error(`Should use @command decorator on command class ${command.name}`);
+        }
+        this.handlersMap.set(commandName, handlerConstructor);
+        this.handlersInverseMap.set(handlerConstructor, commandName);
+    }
+    getHandlerForCommandName(commandName) {
+        return this.handlersMap.get(commandName) ?? null;
+    }
+    getCommandNameForHandler(handlerConstructor) {
+        return this.handlersInverseMap.get(handlerConstructor) ?? null;
+    }
+    getCommandName(command) {
+        return this.commandsInverseMap.get(command) ?? null;
+    }
+    getCommandForCommandName(commandName) {
+        return this.commandsMap.get(commandName) ?? null;
+    }
+};
+CommandMetadataStore = __decorate([
+    singleton()
+], CommandMetadataStore);
+
+export { CommandMetadataStore };

package/dist/src/feature/async/Job.js

@@ -0,0 +1,24 @@
+import { Entity } from '../../core/entity/Entity.js';
+import { CustomError } from '../../core/error/CustomError.js';
+
+class Job extends Entity {
+    get commandName() {
+        return this.data.commandName;
+    }
+    setAsStarted() {
+        this.data.startedAt = new Date().getTime();
+    }
+    setAsSuccess() {
+        this.data.successAt = new Date().getTime();
+    }
+    setAsFailed(error) {
+        this.data.failedAt = new Date().getTime();
+        this.data.error = {
+            message: error.message,
+            stack: error.stack,
+            info: error instanceof CustomError ? error.info : undefined,
+        };
+    }
+}
+
+export { Job };

package/dist/src/feature/async/JobRepository.js

@@ -0,0 +1,31 @@
+import { __decorate } from 'tslib';
+import { singleton } from '../../core/injection/index.js';
+
+let JobRepository = class JobRepository {
+    find(id) {
+        throw new Error('Method not implemented.');
+    }
+    findOrThrow(id) {
+        throw new Error('Method not implemented.');
+    }
+    findByIds(ids) {
+        throw new Error('Method not implemented.');
+    }
+    findAll(id) {
+        throw new Error('Method not implemented.');
+    }
+    create(item) {
+        throw new Error('Method not implemented.');
+    }
+    update(item) {
+        throw new Error('Method not implemented.');
+    }
+    discard(item) {
+        throw new Error('Method not implemented.');
+    }
+};
+JobRepository = __decorate([
+    singleton()
+], JobRepository);
+
+export { JobRepository };

package/dist/src/feature/async/JobRunner.js

@@ -0,0 +1,45 @@
+import { __decorate, __metadata } from 'tslib';
+import { CommandMetadataStore } from './CommandMetadataStore.js';
+import { JobRepository } from './JobRepository.js';
+import { singleton, container } from '../../core/injection/index.js';
+
+let JobRunner = class JobRunner {
+    jobRepository;
+    handlerContainer;
+    constructor(jobRepository, handlerContainer) {
+        this.jobRepository = jobRepository;
+        this.handlerContainer = handlerContainer;
+    }
+    async run(job) {
+        try {
+            const { commandName, commandData } = job['data'];
+            const handlerConstructor = this.handlerContainer.getHandlerForCommandName(commandName);
+            if (!handlerConstructor) {
+                throw new Error(`Not found handler for command '${commandName}'`);
+            }
+            const handler = container.resolve(handlerConstructor);
+            const commandConstructor = this.handlerContainer.getCommandForCommandName(commandName);
+            if (!commandConstructor) {
+                throw new Error(`Not found class for command name '${commandName}'`);
+            }
+            job.setAsStarted();
+            await this.jobRepository.update(job);
+            const command = new commandConstructor(commandData);
+            await handler.handle(command);
+            job.setAsSuccess();
+        }
+        catch (e) {
+            job.setAsFailed(e instanceof Error ? e : new Error('Invalid Job error'));
+        }
+        finally {
+            await this.jobRepository.update(job);
+        }
+    }
+};
+JobRunner = __decorate([
+    singleton(),
+    __metadata("design:paramtypes", [JobRepository,
+        CommandMetadataStore])
+], JobRunner);
+
+export { JobRunner };

package/dist/src/feature/async/JobsEventsHub.js

@@ -0,0 +1,24 @@
+import { __decorate } from 'tslib';
+import { singleton } from '../../core/injection/index.js';
+
+let JobsEventsHub = class JobsEventsHub {
+    jobsEventsListener = null;
+    notifyJobCreated(job) {
+        if (!this.jobsEventsListener) {
+            return;
+        }
+        this.jobsEventsListener({
+            jobId: job.id,
+            commandName: job.commandName,
+            type: 'created',
+        });
+    }
+    listenJobsEvents(listener) {
+        this.jobsEventsListener = listener;
+    }
+};
+JobsEventsHub = __decorate([
+    singleton()
+], JobsEventsHub);
+
+export { JobsEventsHub };