@forklaunch/core 0.2.36 → 0.3.0

package/lib/dtoMapper/index.js

@@ -0,0 +1,230 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/dtoMapper/index.ts
+var dtoMapper_exports = {};
+__export(dtoMapper_exports, {
+  RequestDtoMapper: () => RequestDtoMapper,
+  ResponseDtoMapper: () => ResponseDtoMapper
+});
+module.exports = __toCommonJS(dtoMapper_exports);
+
+// src/dtoMapper/models/baseDtoMapper.model.ts
+function construct(self, schemaValidator) {
+  return new self(schemaValidator || {});
+}
+var BaseDtoMapper = class {
+  /**
+   * The schema validator exact type.
+   * @type {SV}
+   * @protected
+   */
+  _SV;
+  /**
+   * The schema validator as a general type.
+   * @type {SchemaValidator}
+   * @protected
+   */
+  schemaValidator;
+  /**
+   * The Data Transfer Object (DTO).
+   * @type {Schema<this['schema'], SV>}
+   */
+  _dto = {};
+  /**
+   * Creates an instance of BaseDtoMapper.
+   *
+   * @param {SV} schemaValidator - The schema provider.
+   */
+  constructor(schemaValidator) {
+    this.schemaValidator = schemaValidator;
+  }
+  /**
+   * Validates and sets the Data Transfer Object (DTO).
+   *
+   * @param {this['_dto']} dto - The Data Transfer Object (DTO).
+   * @throws {Error} - Throws an error if the DTO is invalid.
+   */
+  set dto(_dto) {
+    const parsedSchema = this.schemaValidator.parse(
+      this.schemaValidator.schemify(this.schema),
+      _dto
+    );
+    if (!parsedSchema.ok) {
+      throw new Error(`Invalid DTO: ${parsedSchema.error}`);
+    }
+    this._dto = _dto;
+  }
+  /**
+   * Validates and gets the Data Transfer Object (DTO).
+   *
+   * @returns {this['_dto']} - The Data Transfer Object (DTO).
+   */
+  get dto() {
+    return this._dto;
+  }
+  /**
+   * Gets the schema of a T.
+   *
+   * @template T - A type that extends BaseDtoMapper.
+   * @template SV - A type that extends AnySchemaValidator.
+   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+   * @returns {T['schema']} - The schema of the T.
+   */
+  static schema() {
+    return construct(this).schema;
+  }
+};
+
+// src/dtoMapper/models/requestDtoMapper.model.ts
+var RequestDtoMapper = class extends BaseDtoMapper {
+  /**
+   * The entity type.
+   * @type {Entity}
+   * @protected
+   */
+  _Entity;
+  /**
+   * Populates the DTO with data from a JSON object.
+   *
+   * @param {this['_dto']} json - The JSON object.
+   * @returns {this} - The instance of the RequestDtoMapper.
+   */
+  fromDto(json) {
+    const parsedSchema = this.schemaValidator.parse(
+      this.schemaValidator.schemify(this.schema),
+      json
+    );
+    if (!parsedSchema.ok) {
+      throw new Error(`Invalid DTO: ${parsedSchema.error}`);
+    }
+    this.dto = json;
+    return this;
+  }
+  /**
+   * Deserializes a JSON object to an entity.
+   *
+   * @param {this['_dto']} json - The JSON object.
+   * @param {...unknown[]} additionalArgs - Additional arguments.
+   * @returns {Entity} - The entity.
+   */
+  deserializeDtoToEntity(json, ...additionalArgs) {
+    return this.fromDto(json).toEntity(...additionalArgs);
+  }
+  /**
+   * Creates an instance of a RequestDtoMapper from a JSON object.
+   *
+   * @template T - A type that extends RequestDtoMapper.
+   * @template SV - A type that extends AnySchemaValidator.
+   * @template JsonType - The type of the JSON object.
+   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+   * @param {SV} schemaValidator - The schema provider.
+   * @param {JsonType} json - The JSON object.
+   * @returns {T} - An instance of the T.
+   */
+  static fromDto(schemaValidator, json) {
+    return construct(this, schemaValidator).fromDto(json);
+  }
+  /**
+   * Deserializes a JSON object to an entity.
+   *
+   * @template T - A type that extends RequestDtoMapper.
+   * @template SV - A type that extends AnySchemaValidator.
+   * @template JsonType - The type of the JSON object.
+   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+   * @param {SV} schemaValidator - The schema provider.
+   * @param {JsonType} json - The JSON object.
+   * @param {...unknown[]} additionalArgs - Additional arguments.
+   * @returns {T['_Entity']} - The entity.
+   */
+  static deserializeDtoToEntity(schemaValidator, json, ...additionalArgs) {
+    return construct(this, schemaValidator).fromDto(json).toEntity(...additionalArgs);
+  }
+};
+
+// src/dtoMapper/models/responseDtoMapper.model.ts
+var ResponseDtoMapper = class extends BaseDtoMapper {
+  /**
+   * The entity type.
+   * @type {Entity}
+   * @protected
+   */
+  _Entity;
+  /**
+   * Converts the underlying DTO to a JSON object.
+   *
+   * @returns {this['_dto']} - The JSON object.
+   * @throws {Error} - Throws an error if the DTO is invalid.
+   */
+  toDto() {
+    const parsedSchema = this.schemaValidator.parse(
+      this.schemaValidator.schemify(this.schema),
+      this.dto
+    );
+    if (!parsedSchema.ok) {
+      throw new Error(`Invalid DTO: ${parsedSchema.error}`);
+    }
+    return this.dto;
+  }
+  /**
+   * Serializes an entity to a JSON object.
+   *
+   * @param {Entity} entity - The entity to serialize.
+   * @returns {this['_dto']} - The JSON object.
+   * @throws {Error} - Throws an error if the DTO is invalid.
+   */
+  serializeEntityToDto(...[entity, ...additionalArgs]) {
+    return this.fromEntity(entity, ...additionalArgs).toDto();
+  }
+  /**
+   * Populates entity mapper with DTO from an entity.
+   *
+   * @template T - A type that extends ResponseDtoMapper.
+   * @template SV - A type that extends AnySchemaValidator.
+   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+   * @param {SV} schemaValidator - The schema provider.
+   * @param {T['_Entity']} entity - The entity to convert.
+   * @returns {T} - An instance of the T.
+   */
+  static fromEntity(schemaValidator, ...[entity, ...additionalArgs]) {
+    return construct(this, schemaValidator).fromEntity(
+      entity,
+      ...additionalArgs
+    );
+  }
+  /**
+   * Serializes an entity to a JSON object.
+   *
+   * @template T - A type that extends ResponseDtoMapper.
+   * @template SV - A type that extends AnySchemaValidator.
+   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+   * @param {SV} schemaValidator - The schema provider.
+   * @param {T['_Entity']} entity - The entity to serialize.
+   * @returns {T['_dto']} - The JSON object.
+   * @throws {Error} - Throws an error if the DTO is invalid.
+   */
+  static serializeEntityToDto(schemaValidator, ...[entity, ...additionalArgs]) {
+    return construct(this, schemaValidator).fromEntity(entity, ...additionalArgs).toDto();
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RequestDtoMapper,
+  ResponseDtoMapper
+});

package/lib/dtoMapper/index.mjs

@@ -0,0 +1,202 @@
+// src/dtoMapper/models/baseDtoMapper.model.ts
+function construct(self, schemaValidator) {
+  return new self(schemaValidator || {});
+}
+var BaseDtoMapper = class {
+  /**
+   * The schema validator exact type.
+   * @type {SV}
+   * @protected
+   */
+  _SV;
+  /**
+   * The schema validator as a general type.
+   * @type {SchemaValidator}
+   * @protected
+   */
+  schemaValidator;
+  /**
+   * The Data Transfer Object (DTO).
+   * @type {Schema<this['schema'], SV>}
+   */
+  _dto = {};
+  /**
+   * Creates an instance of BaseDtoMapper.
+   *
+   * @param {SV} schemaValidator - The schema provider.
+   */
+  constructor(schemaValidator) {
+    this.schemaValidator = schemaValidator;
+  }
+  /**
+   * Validates and sets the Data Transfer Object (DTO).
+   *
+   * @param {this['_dto']} dto - The Data Transfer Object (DTO).
+   * @throws {Error} - Throws an error if the DTO is invalid.
+   */
+  set dto(_dto) {
+    const parsedSchema = this.schemaValidator.parse(
+      this.schemaValidator.schemify(this.schema),
+      _dto
+    );
+    if (!parsedSchema.ok) {
+      throw new Error(`Invalid DTO: ${parsedSchema.error}`);
+    }
+    this._dto = _dto;
+  }
+  /**
+   * Validates and gets the Data Transfer Object (DTO).
+   *
+   * @returns {this['_dto']} - The Data Transfer Object (DTO).
+   */
+  get dto() {
+    return this._dto;
+  }
+  /**
+   * Gets the schema of a T.
+   *
+   * @template T - A type that extends BaseDtoMapper.
+   * @template SV - A type that extends AnySchemaValidator.
+   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+   * @returns {T['schema']} - The schema of the T.
+   */
+  static schema() {
+    return construct(this).schema;
+  }
+};
+
+// src/dtoMapper/models/requestDtoMapper.model.ts
+var RequestDtoMapper = class extends BaseDtoMapper {
+  /**
+   * The entity type.
+   * @type {Entity}
+   * @protected
+   */
+  _Entity;
+  /**
+   * Populates the DTO with data from a JSON object.
+   *
+   * @param {this['_dto']} json - The JSON object.
+   * @returns {this} - The instance of the RequestDtoMapper.
+   */
+  fromDto(json) {
+    const parsedSchema = this.schemaValidator.parse(
+      this.schemaValidator.schemify(this.schema),
+      json
+    );
+    if (!parsedSchema.ok) {
+      throw new Error(`Invalid DTO: ${parsedSchema.error}`);
+    }
+    this.dto = json;
+    return this;
+  }
+  /**
+   * Deserializes a JSON object to an entity.
+   *
+   * @param {this['_dto']} json - The JSON object.
+   * @param {...unknown[]} additionalArgs - Additional arguments.
+   * @returns {Entity} - The entity.
+   */
+  deserializeDtoToEntity(json, ...additionalArgs) {
+    return this.fromDto(json).toEntity(...additionalArgs);
+  }
+  /**
+   * Creates an instance of a RequestDtoMapper from a JSON object.
+   *
+   * @template T - A type that extends RequestDtoMapper.
+   * @template SV - A type that extends AnySchemaValidator.
+   * @template JsonType - The type of the JSON object.
+   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+   * @param {SV} schemaValidator - The schema provider.
+   * @param {JsonType} json - The JSON object.
+   * @returns {T} - An instance of the T.
+   */
+  static fromDto(schemaValidator, json) {
+    return construct(this, schemaValidator).fromDto(json);
+  }
+  /**
+   * Deserializes a JSON object to an entity.
+   *
+   * @template T - A type that extends RequestDtoMapper.
+   * @template SV - A type that extends AnySchemaValidator.
+   * @template JsonType - The type of the JSON object.
+   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+   * @param {SV} schemaValidator - The schema provider.
+   * @param {JsonType} json - The JSON object.
+   * @param {...unknown[]} additionalArgs - Additional arguments.
+   * @returns {T['_Entity']} - The entity.
+   */
+  static deserializeDtoToEntity(schemaValidator, json, ...additionalArgs) {
+    return construct(this, schemaValidator).fromDto(json).toEntity(...additionalArgs);
+  }
+};
+
+// src/dtoMapper/models/responseDtoMapper.model.ts
+var ResponseDtoMapper = class extends BaseDtoMapper {
+  /**
+   * The entity type.
+   * @type {Entity}
+   * @protected
+   */
+  _Entity;
+  /**
+   * Converts the underlying DTO to a JSON object.
+   *
+   * @returns {this['_dto']} - The JSON object.
+   * @throws {Error} - Throws an error if the DTO is invalid.
+   */
+  toDto() {
+    const parsedSchema = this.schemaValidator.parse(
+      this.schemaValidator.schemify(this.schema),
+      this.dto
+    );
+    if (!parsedSchema.ok) {
+      throw new Error(`Invalid DTO: ${parsedSchema.error}`);
+    }
+    return this.dto;
+  }
+  /**
+   * Serializes an entity to a JSON object.
+   *
+   * @param {Entity} entity - The entity to serialize.
+   * @returns {this['_dto']} - The JSON object.
+   * @throws {Error} - Throws an error if the DTO is invalid.
+   */
+  serializeEntityToDto(...[entity, ...additionalArgs]) {
+    return this.fromEntity(entity, ...additionalArgs).toDto();
+  }
+  /**
+   * Populates entity mapper with DTO from an entity.
+   *
+   * @template T - A type that extends ResponseDtoMapper.
+   * @template SV - A type that extends AnySchemaValidator.
+   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+   * @param {SV} schemaValidator - The schema provider.
+   * @param {T['_Entity']} entity - The entity to convert.
+   * @returns {T} - An instance of the T.
+   */
+  static fromEntity(schemaValidator, ...[entity, ...additionalArgs]) {
+    return construct(this, schemaValidator).fromEntity(
+      entity,
+      ...additionalArgs
+    );
+  }
+  /**
+   * Serializes an entity to a JSON object.
+   *
+   * @template T - A type that extends ResponseDtoMapper.
+   * @template SV - A type that extends AnySchemaValidator.
+   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+   * @param {SV} schemaValidator - The schema provider.
+   * @param {T['_Entity']} entity - The entity to serialize.
+   * @returns {T['_dto']} - The JSON object.
+   * @throws {Error} - Throws an error if the DTO is invalid.
+   */
+  static serializeEntityToDto(schemaValidator, ...[entity, ...additionalArgs]) {
+    return construct(this, schemaValidator).fromEntity(entity, ...additionalArgs).toDto();
+  }
+};
+export {
+  RequestDtoMapper,
+  ResponseDtoMapper
+};