@e22m4u/js-repository 0.6.4 → 0.7.0

package/src/definition/model/properties/property-transformer/builtin/index.d.ts

@@ -1,3 +0,0 @@
-export * from './trim-transformer.js';
-export * from './to-lower-case-transformer.js';
-export * from './to-upper-case-transformer.js';

package/src/definition/model/properties/property-transformer/builtin/index.js

@@ -1,3 +0,0 @@
-export * from './trim-transformer.js';
-export * from './to-lower-case-transformer.js';
-export * from './to-upper-case-transformer.js';

package/src/definition/model/properties/property-transformer/builtin/to-lower-case-transformer.d.ts

@@ -1,6 +0,0 @@
-import {PropertyTransformer} from '../property-transformer.js';
-
-/**
- * To lower case transformer.
- */
-export const toLowerCaseTransformer: PropertyTransformer;

package/src/definition/model/properties/property-transformer/builtin/to-lower-case-transformer.js

@@ -1,19 +0,0 @@
-import {InvalidArgumentError} from '../../../../../errors/index.js';
-
-/**
- * To lower case transformer.
- *
- * @param {*} value
- * @param {undefined} options
- * @param {object} context
- * @returns {string|undefined|null}
- */
-export function toLowerCaseTransformer(value, options, context) {
-  if (value == null) return value;
-  if (typeof value === 'string') return value.toLowerCase();
-  throw new InvalidArgumentError(
-    'The property transformer %v requires a String value, but %v was given.',
-    context.transformerName,
-    value,
-  );
-}

package/src/definition/model/properties/property-transformer/builtin/to-lower-case-transformer.spec.js

@@ -1,39 +0,0 @@
-import {expect} from 'chai';
-import {format} from '@e22m4u/js-format';
-import {toLowerCaseTransformer} from './to-lower-case-transformer.js';
-
-describe('toLowerCaseTransformer', function () {
-  it('returns undefined and null values as is', function () {
-    const res1 = toLowerCaseTransformer(undefined, undefined, {});
-    const res2 = toLowerCaseTransformer(null, undefined, {});
-    expect(res1).to.be.undefined;
-    expect(res2).to.be.null;
-  });
-
-  it('converts the given string to lower case', function () {
-    const res = toLowerCaseTransformer('TEST', undefined, {});
-    expect(res).to.be.eq('test');
-  });
-
-  it('throws an error if the given value is not a string', function () {
-    const throwable = v => () =>
-      toLowerCaseTransformer(v, undefined, {
-        transformerName: 'toLowerCase',
-      });
-    const error = v =>
-      format(
-        'The property transformer "toLowerCase" requires a String value, but %s was given.',
-        v,
-      );
-    expect(throwable(10)).to.throw(error('10'));
-    expect(throwable(0)).to.throw(error('0'));
-    expect(throwable(true)).to.throw(error('true'));
-    expect(throwable(false)).to.throw(error('false'));
-    expect(throwable({})).to.throw(error('Object'));
-    expect(throwable([])).to.throw(error('Array'));
-    throwable('str')();
-    throwable('')();
-    throwable(undefined)();
-    throwable(null)();
-  });
-});

package/src/definition/model/properties/property-transformer/builtin/to-upper-case-transformer.d.ts

@@ -1,6 +0,0 @@
-import {PropertyTransformer} from '../property-transformer.js';
-
-/**
- * To upper case transformer.
- */
-export const toUpperCaseTransformer: PropertyTransformer;

package/src/definition/model/properties/property-transformer/builtin/to-upper-case-transformer.js

@@ -1,19 +0,0 @@
-import {InvalidArgumentError} from '../../../../../errors/index.js';
-
-/**
- * To upper case transformer.
- *
- * @param {*} value
- * @param {undefined} options
- * @param {object} context
- * @returns {string|undefined|null}
- */
-export function toUpperCaseTransformer(value, options, context) {
-  if (value == null) return value;
-  if (typeof value === 'string') return value.toUpperCase();
-  throw new InvalidArgumentError(
-    'The property transformer %v requires a String value, but %v was given.',
-    context.transformerName,
-    value,
-  );
-}

package/src/definition/model/properties/property-transformer/builtin/to-upper-case-transformer.spec.js

@@ -1,39 +0,0 @@
-import {expect} from 'chai';
-import {format} from '@e22m4u/js-format';
-import {toUpperCaseTransformer} from './to-upper-case-transformer.js';
-
-describe('toUpperCaseTransformer', function () {
-  it('returns undefined and null values as is', function () {
-    const res1 = toUpperCaseTransformer(undefined, undefined, {});
-    const res2 = toUpperCaseTransformer(null, undefined, {});
-    expect(res1).to.be.undefined;
-    expect(res2).to.be.null;
-  });
-
-  it('converts the given string to upper case', function () {
-    const res = toUpperCaseTransformer('test', undefined, {});
-    expect(res).to.be.eq('TEST');
-  });
-
-  it('throws an error if the given value is not a string', function () {
-    const throwable = v => () =>
-      toUpperCaseTransformer(v, undefined, {
-        transformerName: 'toUpperCase',
-      });
-    const error = v =>
-      format(
-        'The property transformer "toUpperCase" requires a String value, but %s was given.',
-        v,
-      );
-    expect(throwable(10)).to.throw(error('10'));
-    expect(throwable(0)).to.throw(error('0'));
-    expect(throwable(true)).to.throw(error('true'));
-    expect(throwable(false)).to.throw(error('false'));
-    expect(throwable({})).to.throw(error('Object'));
-    expect(throwable([])).to.throw(error('Array'));
-    throwable('str')();
-    throwable('')();
-    throwable(undefined)();
-    throwable(null)();
-  });
-});

package/src/definition/model/properties/property-transformer/builtin/trim-transformer.d.ts

@@ -1,6 +0,0 @@
-import {PropertyTransformer} from '../property-transformer.js';
-
-/**
- * Trim transformer.
- */
-export declare type trimTransformer = PropertyTransformer;

package/src/definition/model/properties/property-transformer/builtin/trim-transformer.js

@@ -1,19 +0,0 @@
-import {InvalidArgumentError} from '../../../../../errors/index.js';
-
-/**
- * Trim transformer.
- *
- * @param {*} value
- * @param {undefined} options
- * @param {object} context
- * @returns {string|undefined|null}
- */
-export function trimTransformer(value, options, context) {
-  if (value == null) return value;
-  if (typeof value === 'string') return value.trim();
-  throw new InvalidArgumentError(
-    'The property transformer %v requires a String value, but %v was given.',
-    context.transformerName,
-    value,
-  );
-}

package/src/definition/model/properties/property-transformer/builtin/trim-transformer.spec.js

@@ -1,39 +0,0 @@
-import {expect} from 'chai';
-import {format} from '@e22m4u/js-format';
-import {trimTransformer} from './trim-transformer.js';
-
-describe('trimTransformer', function () {
-  it('returns undefined and null values as is', function () {
-    const res1 = trimTransformer(undefined, undefined, {});
-    const res2 = trimTransformer(null, undefined, {});
-    expect(res1).to.be.undefined;
-    expect(res2).to.be.null;
-  });
-
-  it('trims the given string', function () {
-    const res = trimTransformer(' test ', undefined, {});
-    expect(res).to.be.eq('test');
-  });
-
-  it('throws an error if the given value is not a string', function () {
-    const throwable = v => () =>
-      trimTransformer(v, undefined, {
-        transformerName: 'trim',
-      });
-    const error = v =>
-      format(
-        'The property transformer "trim" requires a String value, but %s was given.',
-        v,
-      );
-    expect(throwable(10)).to.throw(error('10'));
-    expect(throwable(0)).to.throw(error('0'));
-    expect(throwable(true)).to.throw(error('true'));
-    expect(throwable(false)).to.throw(error('false'));
-    expect(throwable({})).to.throw(error('Object'));
-    expect(throwable([])).to.throw(error('Array'));
-    throwable('str')();
-    throwable('')();
-    throwable(undefined)();
-    throwable(null)();
-  });
-});

package/src/definition/model/properties/property-transformer/index.d.ts

@@ -1,2 +0,0 @@
-export * from './property-transformer.js';
-export * from './property-transformer-registry.js';

package/src/definition/model/properties/property-transformer/index.js

@@ -1,2 +0,0 @@
-export * from './property-transformer.js';
-export * from './property-transformer-registry.js';

package/src/definition/model/properties/property-transformer/property-transformer-registry.d.ts

@@ -1,29 +0,0 @@
-import {Service} from '@e22m4u/js-service';
-import {PropertyTransformer} from './property-transformer.js';
-
-/**
- * Property transformer registry.
- */
-export declare class PropertyTransformerRegistry extends Service {
-  /**
-   * Add transformer.
-   *
-   * @param name
-   * @param transformer
-   */
-  addTransformer(name: string, transformer: PropertyTransformer): this;
-
-  /**
-   * Has transformer.
-   *
-   * @param name
-   */
-  hasTransformer(name: string): boolean;
-
-  /**
-   * Get transformer.
-   *
-   * @param name
-   */
-  getTransformer(name: string): PropertyTransformer;
-}

package/src/definition/model/properties/property-transformer/property-transformer-registry.js

@@ -1,76 +0,0 @@
-import {Service} from '@e22m4u/js-service';
-import {trimTransformer} from './builtin/index.js';
-import {toUpperCaseTransformer} from './builtin/index.js';
-import {toLowerCaseTransformer} from './builtin/index.js';
-import {InvalidArgumentError} from '../../../../errors/index.js';
-
-/**
- * Property transformer registry.
- */
-export class PropertyTransformerRegistry extends Service {
-  /**
-   * Transformers.
-   *
-   * @type {object}
-   */
-  _transformers = {
-    trim: trimTransformer,
-    toUpperCase: toUpperCaseTransformer,
-    toLowerCase: toLowerCaseTransformer,
-  };
-
-  /**
-   * Add transformer.
-   *
-   * @param {string} name
-   * @param {Function} transformer
-   * @returns {PropertyTransformerRegistry}
-   */
-  addTransformer(name, transformer) {
-    if (!name || typeof name !== 'string')
-      throw new InvalidArgumentError(
-        'A name of the property transformer must ' +
-          'be a non-empty String, but %v was given.',
-        name,
-      );
-    if (name in this._transformers)
-      throw new InvalidArgumentError(
-        'The property transformer %v is already defined.',
-        name,
-      );
-    if (typeof transformer !== 'function')
-      throw new InvalidArgumentError(
-        'The property transformer %v must be a Function, but %v was given.',
-        name,
-        transformer,
-      );
-    this._transformers[name] = transformer;
-    return this;
-  }
-
-  /**
-   * Has transformer.
-   *
-   * @param {string} name
-   * @returns {boolean}
-   */
-  hasTransformer(name) {
-    return Boolean(this._transformers[name]);
-  }
-
-  /**
-   * Get transformer.
-   *
-   * @param {string} name
-   * @returns {Function}
-   */
-  getTransformer(name) {
-    const transformer = this._transformers[name];
-    if (!transformer)
-      throw new InvalidArgumentError(
-        'The property transformer %v is not defined.',
-        name,
-      );
-    return transformer;
-  }
-}

package/src/definition/model/properties/property-transformer/property-transformer-registry.spec.js

@@ -1,133 +0,0 @@
-import {expect} from 'chai';
-import {format} from '@e22m4u/js-format';
-import {trimTransformer} from './builtin/index.js';
-import {toUpperCaseTransformer} from './builtin/index.js';
-import {toLowerCaseTransformer} from './builtin/index.js';
-import {PropertyTransformerRegistry} from './property-transformer-registry.js';
-
-describe('PropertyTransformerRegistry', function () {
-  describe('addTransformer', function () {
-    it('has builtin transformers', function () {
-      const ptr = new PropertyTransformerRegistry();
-      expect(ptr['_transformers']).to.be.eql({
-        trim: trimTransformer,
-        toUpperCase: toUpperCaseTransformer,
-        toLowerCase: toLowerCaseTransformer,
-      });
-    });
-
-    it('adds a given transformer with the name', function () {
-      const ptr = new PropertyTransformerRegistry();
-      const myTransformer = () => undefined;
-      const res = ptr.addTransformer('myTransformer', myTransformer);
-      expect(res).to.be.eq(ptr);
-      expect(ptr['_transformers']['myTransformer']).to.be.eq(myTransformer);
-    });
-
-    it('requires the given name to be a non-empty string', function () {
-      const ptr = new PropertyTransformerRegistry();
-      const throwable = v => () => ptr.addTransformer(v, () => undefined);
-      const error = v =>
-        format(
-          'A name of the property transformer must ' +
-            'be a non-empty String, but %s was given.',
-          v,
-        );
-      expect(throwable('')).to.throw(error('""'));
-      expect(throwable(10)).to.throw(error('10'));
-      expect(throwable(0)).to.throw(error('0'));
-      expect(throwable(false)).to.throw(error('false'));
-      expect(throwable(undefined)).to.throw(error('undefined'));
-      expect(throwable(null)).to.throw(error('null'));
-      expect(throwable({})).to.throw(error('Object'));
-      expect(throwable([])).to.throw(error('Array'));
-      expect(throwable(() => undefined)).to.throw(error('Function'));
-      throwable('str')();
-    });
-
-    it('throws an error if the given name already exists', function () {
-      const ptr = new PropertyTransformerRegistry();
-      ptr.addTransformer('test', () => undefined);
-      const throwable = () => ptr.addTransformer('test', () => undefined);
-      expect(throwable).to.throw(
-        'The property transformer "test" is already defined.',
-      );
-    });
-
-    it('requires the given transformer to be a function', function () {
-      const ptr = new PropertyTransformerRegistry();
-      const throwable = v => () => ptr.addTransformer('test', v);
-      const error = v =>
-        format(
-          'The property transformer "test" must be a Function, but %s was given.',
-          v,
-        );
-      expect(throwable('str')).to.throw(error('"str"'));
-      expect(throwable('')).to.throw(error('""'));
-      expect(throwable(10)).to.throw(error('10'));
-      expect(throwable(0)).to.throw(error('0'));
-      expect(throwable(false)).to.throw(error('false'));
-      expect(throwable(undefined)).to.throw(error('undefined'));
-      expect(throwable(null)).to.throw(error('null'));
-      expect(throwable({})).to.throw(error('Object'));
-      expect(throwable([])).to.throw(error('Array'));
-      throwable(() => undefined)();
-    });
-  });
-
-  describe('hasTransformer', function () {
-    it('returns false for a not existing name', function () {
-      const ptr = new PropertyTransformerRegistry();
-      expect(ptr.hasTransformer('str')).to.be.false;
-      expect(ptr.hasTransformer('')).to.be.false;
-      expect(ptr.hasTransformer(10)).to.be.false;
-      expect(ptr.hasTransformer(0)).to.be.false;
-      expect(ptr.hasTransformer(true)).to.be.false;
-      expect(ptr.hasTransformer(false)).to.be.false;
-      expect(ptr.hasTransformer(null)).to.be.false;
-      expect(ptr.hasTransformer(undefined)).to.be.false;
-      expect(ptr.hasTransformer({})).to.be.false;
-      expect(ptr.hasTransformer([])).to.be.false;
-      expect(ptr.hasTransformer(() => undefined)).to.be.false;
-    });
-
-    it('returns true for an existing name', function () {
-      const ptr = new PropertyTransformerRegistry();
-      expect(ptr.hasTransformer('test')).to.be.false;
-      ptr.addTransformer('test', () => undefined);
-      expect(ptr.hasTransformer('test')).to.be.true;
-    });
-  });
-
-  describe('getTransformer', function () {
-    it('returns transformer by its name', function () {
-      const ptr = new PropertyTransformerRegistry();
-      const myTransformer1 = () => undefined;
-      const myTransformer2 = () => undefined;
-      ptr.addTransformer('foo', myTransformer1);
-      ptr.addTransformer('bar', myTransformer2);
-      const res1 = ptr.getTransformer('foo');
-      const res2 = ptr.getTransformer('bar');
-      expect(res1).to.be.eq(myTransformer1);
-      expect(res2).to.be.eq(myTransformer2);
-    });
-
-    it('throws an error for a not existed name', function () {
-      const ptr = new PropertyTransformerRegistry();
-      const throwable = v => () => ptr.getTransformer(v);
-      const error = v =>
-        format('The property transformer %s is not defined.', v);
-      expect(throwable('str')).to.throw(error('"str"'));
-      expect(throwable('')).to.throw(error('""'));
-      expect(throwable(10)).to.throw(error('10'));
-      expect(throwable(0)).to.throw(error('0'));
-      expect(throwable(true)).to.throw(error('true'));
-      expect(throwable(false)).to.throw(error('false'));
-      expect(throwable(null)).to.throw(error('null'));
-      expect(throwable(undefined)).to.throw(error('undefined'));
-      expect(throwable({})).to.throw(error('Object'));
-      expect(throwable([])).to.throw(error('Array'));
-      expect(throwable(() => undefined)).to.throw(error('Function'));
-    });
-  });
-});

package/src/definition/model/properties/property-transformer/property-transformer.d.ts

@@ -1,27 +0,0 @@
-import {ValueOrPromise} from '../../../../types.js';
-
-/**
- * Property transformer context.
- */
-export declare type PropertyTransformerContext = {
-  transformerName: string,
-  modelName: string,
-  propName: string,
-}
-
-/**
- * Property transformer.
- */
-export declare type PropertyTransformer = (
-  value: unknown,
-  options: unknown,
-  context: PropertyTransformerContext,
-) => ValueOrPromise<unknown>;
-
-/**
- * Property transform options.
- */
-export type PropertyTransformOptions =
-  | (string | PropertyTransformer)
-  | (string | PropertyTransformer)[]
-  | {[key: string]: unknown};

package/src/definition/model/properties/property-transformer/property-transformer.js

@@ -1 +0,0 @@
-export {};

package/src/definition/model/properties/property-validator/builtin/index.d.ts

@@ -1,3 +0,0 @@
-export * from './regexp-validator.js';
-export * from './max-length-validator.js';
-export * from './min-length-validator.js';

package/src/definition/model/properties/property-validator/builtin/index.js

@@ -1,3 +0,0 @@
-export * from './regexp-validator.js';
-export * from './max-length-validator.js';
-export * from './min-length-validator.js';

package/src/definition/model/properties/property-validator/builtin/max-length-validator.d.ts

@@ -1,6 +0,0 @@
-import {PropertyValidator} from '../property-validator.js';
-
-/**
- * Max length validator.
- */
-export const maxLengthValidator: PropertyValidator;

package/src/definition/model/properties/property-validator/builtin/max-length-validator.js

@@ -1,28 +0,0 @@
-import {InvalidArgumentError} from '../../../../../errors/index.js';
-
-/**
- * Max length validator.
- *
- * @param {*} value
- * @param {number|boolean} options
- * @param {object} context
- * @returns {boolean}
- */
-export function maxLengthValidator(value, options, context) {
-  if (value == null || options === false) return true;
-  if (typeof options !== 'number')
-    throw new InvalidArgumentError(
-      'The validator %v requires the "options" argument ' +
-        'as a Number, but %v was given.',
-      context.validatorName,
-      options,
-    );
-  if (typeof value === 'string' || Array.isArray(value))
-    return value.length <= options;
-  throw new InvalidArgumentError(
-    'The property validator %v requires a String ' +
-      'or an Array value, but %v was given.',
-    context.validatorName,
-    value,
-  );
-}

package/src/definition/model/properties/property-validator/builtin/max-length-validator.spec.js

@@ -1,100 +0,0 @@
-import {expect} from 'chai';
-import {format} from '@e22m4u/js-format';
-import {maxLengthValidator} from './max-length-validator.js';
-
-describe('maxLengthValidator', function () {
-  it('returns true if the "options" argument is false', function () {
-    const res = maxLengthValidator('test', false, {});
-    expect(res).to.be.true;
-  });
-
-  it('returns true for undefined and null values', function () {
-    const res1 = maxLengthValidator(undefined, 10, {});
-    const res2 = maxLengthValidator(null, 10, {});
-    expect(res1).to.be.true;
-    expect(res2).to.be.true;
-  });
-
-  it('requires the "value" argument as a String or an Array', function () {
-    const throwable = v => () =>
-      maxLengthValidator(v, 10, {
-        validatorName: 'myValidator',
-      });
-    const error = v =>
-      format(
-        'The property validator "myValidator" requires a String ' +
-          'or an Array value, but %s was given.',
-        v,
-      );
-    expect(throwable(10)).to.throw(error('10'));
-    expect(throwable(0)).to.throw(error('0'));
-    expect(throwable(true)).to.throw(error('true'));
-    expect(throwable(false)).to.throw(error('false'));
-    expect(throwable({})).to.throw(error('Object'));
-    expect(throwable(() => undefined)).to.throw(error('Function'));
-    throwable('str')();
-    throwable('')();
-    throwable([1, 2, 3])();
-    throwable([])();
-    throwable(undefined)();
-    throwable(null)();
-  });
-
-  it('requires the "options" argument to be a number', function () {
-    const throwable = v => () =>
-      maxLengthValidator('test', v, {
-        validatorName: 'myValidator',
-      });
-    const error = v =>
-      format(
-        'The validator "myValidator" requires the "options" argument ' +
-          'as a Number, but %s was given.',
-        v,
-      );
-    expect(throwable('str')).to.throw(error('"str"'));
-    expect(throwable('')).to.throw(error('""'));
-    expect(throwable(true)).to.throw(error('true'));
-    expect(throwable(undefined)).to.throw(error('undefined'));
-    expect(throwable(null)).to.throw(error('null'));
-    expect(throwable({})).to.throw(error('Object'));
-    expect(throwable([])).to.throw(error('Array'));
-    expect(throwable(() => undefined)).to.throw(error('Function'));
-    throwable(10)();
-    throwable(0)();
-    throwable(false)();
-  });
-
-  describe('a string value', function () {
-    it('returns false if the value length is greater than the max length option', function () {
-      const res = maxLengthValidator('1234', 3, {});
-      expect(res).to.be.false;
-    });
-
-    it('returns true if the value length is equal to the max length option', function () {
-      const res = maxLengthValidator('123', 3, {});
-      expect(res).to.be.true;
-    });
-
-    it('returns true if the value length is lower than the max length option', function () {
-      const res = maxLengthValidator('12', 3, {});
-      expect(res).to.be.true;
-    });
-  });
-
-  describe('an array value', function () {
-    it('returns false if the value length is greater than the max length option', function () {
-      const res = maxLengthValidator([1, 2, 3, 4], 3, {});
-      expect(res).to.be.false;
-    });
-
-    it('returns true if the value length is equal to the max length option', function () {
-      const res = maxLengthValidator([1, 2, 3], 3, {});
-      expect(res).to.be.true;
-    });
-
-    it('returns true if the value length is lower than the max length option', function () {
-      const res = maxLengthValidator([1, 2], 3, {});
-      expect(res).to.be.true;
-    });
-  });
-});

package/src/definition/model/properties/property-validator/builtin/min-length-validator.d.ts

@@ -1,6 +0,0 @@
-import {PropertyValidator} from '../property-validator.js';
-
-/**
- * Min length validator.
- */
-export const minLengthValidator: PropertyValidator;