@colijnit/sharedcomponents 1.0.2 → 1.0.5

package/projects/sharedcomponents/src/lib/factory/decorators/boolean.decorator.ts

@@ -1,113 +0,0 @@
-import {GetYesNoDbBooleanValue} from "@colijnit/articleapi/build/enum/yes-no-db-type.enum";
-import {GetTrueFalseDbBooleanValue} from "@colijnit/articleapi/build/enum/true-false-db-type.enum";
-import {GetOneZeroDbBooleanValue} from "@colijnit/articleapi/build/enum/one-zero-bool-db-type.enum";
-import {DbBooleanValueType, GetLogicalBooleanValue} from "@colijnit/articleapi/build/enum/db-boolean-value-type.enum";
-
-const PROP_META_KEY_JN: string = "booleanTextJN";
-const PROP_META_KEY_TF: string = "booleanTextTF";
-const PROP_META_KEY_10: string = "booleanText10";
-
-/**
- * There are 'J', 'T', 'N', 'F', 0 and 1 'boolean values' in the database. These should be translated to true and false boolean values in
- * our client application.
- *
- * The values 'J' and 'N' seem to be most commonly used. This is the default setting when using this decorator.
- * You can pass 'T' or 1 for the other variants as follows:
- *
- * Usage:
- *
- * @BooleanText() or @BooleanText("J") (the default, uses YesNoDbType char values)
- * public foo: boolean // 'J' and 'N' become true and false after BusinessObjectFactoryService and -SerializerService processing
- *
- * @BooleanText('T') (uses TrueFalseDbType char values)
- * public bar: boolean // 'T' and 'F' become true and false after BusinessObjectFactoryService and -SerializerService processing
- *
- * @BooleanText(1)
- * public baz: boolean // 1 and 0 become true and false after BusinessObjectFactoryService and -SerializerService processing
- */
-export function BooleanText(type?: "J" | "T" | 1): PropertyDecorator {
-    return function (target: any, propertyKey: string): void {
-        if (!target || !propertyKey) {
-            return;
-        }
-        // by default, it's a J N boolean text
-        if (!type || type === "J") {
-            Reflect.defineMetadata(PROP_META_KEY_JN, true, target, propertyKey);
-        } else if (type === "T") {
-            Reflect.defineMetadata(PROP_META_KEY_TF, true, target, propertyKey);
-        } else if (type === 1) {
-            Reflect.defineMetadata(PROP_META_KEY_10, true, target, propertyKey);
-        }
-    };
-}
-
-// Utility function holder of the BooleanTextDecorator decorator.
-export class BooleanTextDecorator {
-
-    /**
-     * Returns whether given property (as a string) on given object is a boolean text field. That is, it's a field that is decorated
-     * with the @BooleanText decorator.
-     */
-    public static IsBooleanTextField(target: Object, propertyKey: string): boolean {
-        if (!target || !propertyKey || typeof target !== "object") {
-            return false;
-        }
-        return (
-            Reflect.getMetadata(PROP_META_KEY_JN, target, propertyKey) === true
-            ||
-            Reflect.getMetadata(PROP_META_KEY_TF, target, propertyKey) === true
-            ||
-            Reflect.getMetadata(PROP_META_KEY_10, target, propertyKey) === true
-        );
-    }
-
-    /**
-     * Returns the logical true or false value of given character ('J', 'N', 'T' or 'F') or number (0 or 1).
-     * Returns UNDEFINED if given boolChar was not recognised as a boolean text.
-     */
-    public static GetLogicalBooleanValue(dbBoolChar: DbBooleanValueType | string): boolean {
-        return GetLogicalBooleanValue(dbBoolChar);
-    }
-
-    /**
-     * Returns the boolean character / number of given logical bool property on target object. Uses its @BooleanText() annotation to decide
-     * what character / number to return.
-     * Used in BusinessObjectSerializerServiceService to convert logical bools to their original boolean character.
-     * @returns {string|number} The original, reverse-engineered boolean character (or number) of given object property, or undefined.
-     */
-    public static GetDbBooleanValue(target: Object, propertyKey: string): DbBooleanValueType {
-        if (!target || !propertyKey || typeof target !== "object") {
-            return undefined;
-        }
-
-        let dbBoolVal: any = undefined;
-
-        const curBoolVal: boolean = target[propertyKey];
-
-        if (BooleanTextDecorator._IsJaNeeProp(target, propertyKey)) {
-            dbBoolVal = GetYesNoDbBooleanValue(curBoolVal);
-        } else if (BooleanTextDecorator._IsTrueFalseProp(target, propertyKey)) {
-            dbBoolVal = GetTrueFalseDbBooleanValue(curBoolVal);
-        } else if (BooleanTextDecorator._IsZeroOneProp(target, propertyKey)) {
-            dbBoolVal = GetOneZeroDbBooleanValue(curBoolVal);
-        }
-
-        return dbBoolVal as any as DbBooleanValueType;
-    }
-
-    private static _IsJaNeeProp(target: Object, propertyKey: string): boolean {
-        return BooleanTextDecorator._IsProp(PROP_META_KEY_JN, target, propertyKey);
-    }
-
-    private static _IsTrueFalseProp(target: Object, propertyKey: string): boolean {
-        return BooleanTextDecorator._IsProp(PROP_META_KEY_TF, target, propertyKey);
-    }
-
-    private static _IsZeroOneProp(target: Object, propertyKey: string): boolean {
-        return BooleanTextDecorator._IsProp(PROP_META_KEY_10, target, propertyKey);
-    }
-
-    private static _IsProp(prop: string, target: Object, propertyKey: string): boolean {
-        return !!target && !!propertyKey && typeof target === "object" && Reflect.hasMetadata(prop, target, propertyKey);
-    }
-}

package/projects/sharedcomponents/src/lib/factory/decorators/complex-array.decorator.ts

@@ -1,61 +0,0 @@
-import {notNill} from "@colijnit/articleapi/build/utils/function/not-nill.function";
-import {ObjectUtils} from "@colijnit/articleapi/build/utils/object-utils";
-
-const PROP_META_KEY: string = "complexArray";
-
-/**
- * !! just a TAG DECORATOR for now, there is no code that uses this meta data within the ione connector lib itself.
- */
-
-/**
- * Property decorator for properties of businessobject classes that are an array of other strongly typed businessobjects.
- * Ensures that the BusinessObjectFactoryService makes properly typed objects from incoming raw persistence data. Otherwise we couldn't add methods
- * to our own businessobjects and use them, since all fields would be flat data without methods after BusinessObjectFactoryService creation.
- *
- * Usage:
- *
- * @ComplexArray(TransactionLine)
- * public transactionLines: TransactionLine[]
- */
-export function ComplexArray(type: any): PropertyDecorator {
-    return function (target: any, propertyKey: string): void {
-        if (!target || !propertyKey || typeof target !== "object") {
-            return;
-        }
-        // warn the programmer if given type was undefined; it's probably an import order glitch that caused this, because decorators seem
-        // to be immediately processed when a class is first imported
-        if (!type) {
-            console.warn(`@ComplexArray(type): type was UNDEFINED. Called on prop (${ObjectUtils.GetClassName(target)}, ${propertyKey}). ` +
-                `Class will not properly serialize and deserialize now. We've always been able to fix this by CHANGING IMPORT ORDERS ` +
-                `where both classes and their dependencies are used, e.g. factory, repository or models..`);
-            return;
-        }
-        Reflect.defineMetadata(PROP_META_KEY, type, target, propertyKey);
-    };
-}
-
-// Utility function holder of the ComplexArrayDecorator decorator.
-export class ComplexArrayDecorator {
-    /**
-     * Returns whether given property (as a string) on given object is a complex array. A complex array is an array field that is decorated
-     * with the @ComplexArray decorator.
-     */
-    public static IsComplexArray(target: Object, propertyKey: string): boolean {
-        if (!target || !propertyKey || typeof target !== "object") {
-            return false;
-        }
-
-        return (notNill(Reflect.getMetadata(PROP_META_KEY, target, propertyKey)));
-    }
-
-    /**
-     * Returns the VALUE of the @ComplexArray(VALUE) property decorator on the given propertyKey on the given modelobject.
-     */
-    public static GetComplexArrayType(target: Object, propertyKey: string): any {
-        if (!target || !propertyKey || typeof target !== "object") {
-            return undefined;
-        }
-
-        return Reflect.getMetadata(PROP_META_KEY, target, propertyKey);
-    }
-}

package/projects/sharedcomponents/src/lib/factory/decorators/complex-field.decorator.ts

@@ -1,63 +0,0 @@
-import {notNill} from "@colijnit/articleapi/build/utils/function/not-nill.function";
-import {ObjectUtils} from "@colijnit/articleapi/build/utils/object-utils";
-
-const PROP_META_KEY: string = "complexField";
-
-/**
- * !! just a TAG DECORATOR for now, there is no code that uses this meta data within the ione connector lib itself.
- */
-
-/**
- * Property decorator for properties of businessobject classes that are other strongly typed businessobjects.
- * Ensures that the BusinessObjectFactoryService makes properly typed objects from incoming raw persistence data. Otherwise we couldn't add methods
- * to our own businessobjects and use them, since all fields would be flat data without methods after BusinessObjectFactoryService creation.
- *
- * Usage:
- *
- * @ComplexField(Transaction)
- * public transaction: Transaction
- *
- * Also keeps track of a "complexFieldProps" metadata on the class-level, as a reflect-metadata workaround to be able to
- * retrieve all properties that have the @ComplexField(..) decorator (impossible with current Reflect API).
- */
-export function ComplexField(type: any): PropertyDecorator {
-    return function (target: any, propertyKey: string): void {
-        if (!target || !propertyKey) {
-            return;
-        }
-
-        // warn the programmer if given type was undefined; it's probably an import order glitch that caused this, because decorators seem
-        // to be immediately processed when a class is first imported
-        if (!type) {
-          // eslint-disable-next-line no-console
-            console.warn(`@ComplexField(type): type was UNDEFINED. Called on prop (${ObjectUtils.GetClassName(target)}, ${propertyKey}). ` +
-                `Class will not properly serialize and deserialize now. We've always been able to fix this by CHANGING IMPORT ORDERS ` +
-                `where both classes and their dependencies are used, e.g. factory, repository or models..`);
-            return;
-        }
-        Reflect.defineMetadata(PROP_META_KEY, type, target, propertyKey);
-    };
-}
-
-// Utility function holder of the ComplexFieldDecorator decorator.
-export class ComplexFieldDecorator {
-
-    /**
-     * Returns whether given property (as a string) on given object is a complex field. A complex field is a field that is decorated
-     * with the @ComplexField decorator.
-     */
-    public static IsComplexField(target: Object, propertyKey: string): boolean {
-        if (!target || !propertyKey || typeof target !== "object") {
-            return false;
-        }
-        return (notNill(Reflect.getMetadata(PROP_META_KEY, target, propertyKey)));
-    }
-
-    // Returns the VALUE of the @ComplexField(VALUE) property decorator on the given propertyKey on the given modelObject.
-    public static GetComplexFieldType(target: Object, propertyKey: string): any {
-        if (!target || !propertyKey || typeof target !== "object") {
-            return undefined;
-        }
-        return Reflect.getMetadata(PROP_META_KEY, target, propertyKey);
-    }
-}

package/projects/sharedcomponents/src/lib/factory/decorators/date-field.decorator.ts

@@ -1,41 +0,0 @@
-import {DateUtils} from "@colijnit/articleapi/build/utils/date-utils";
-
-const PROP_META_KEY: string = "dateField";
-
-/**
- * !! just a TAG DECORATOR for now, there is no code that uses this meta data within the ione connector lib itself.
- */
-
-/**
- * Property decorator for properties of businessobject classes that are of type Date, but are sent to us as strings.
- * Ensures that the BusinessObjectFactory makes proper JavaScript Date objects from incoming strings for @DateField() decorated properties.
- *
- * Usage:
- *
- * @DateField()
- * public expectedDeliveryDate: Date
- */
-export function DateField(): PropertyDecorator {
-    return function (target: any, propertyKey: string): void {
-        if (!target || !propertyKey) {
-            return;
-        }
-        Reflect.defineMetadata(PROP_META_KEY, undefined, target, propertyKey);
-    };
-}
-
-// Utility function holder of the @DateField() decorator.
-export class DateFieldFieldDecorator {
-
-    // Returns whether given property (as a string) on given object is decorated with @DateField().
-    public static IsDateField(target: Object, propertyKey: string): boolean {
-        if (!target || !propertyKey || typeof target !== "object") {
-            return false;
-        }
-        return Reflect.hasMetadata(PROP_META_KEY, target, propertyKey);
-    }
-
-    public static StringAsDate(str: string): Date {
-        return DateUtils.StringAsDate(str);
-    }
-}

package/projects/sharedcomponents/src/lib/factory/decorators/string-number.decorator.ts

@@ -1,48 +0,0 @@
-import {NumberUtils} from "@colijnit/articleapi/build/utils/number-utils";
-
-const PROP_META_KEY: string = "stringNumber";
-/**
- * !! just a TAG DECORATOR for now, there is no code that uses this meta data within the ione connector lib itself.
- */
-
-/**
- * Decorator for properties of businessobjects that are sent to us as strings from the database, but which we want to use as a number in the client.
- *
- * Can be handy for incongruent backend api cases, where id data types are communicated wrongly via strings instead of numbers
- * (e.g. on EmployeeFullObject.district, points to a District which has a number id, but in employee it's a string representation of that number...)
- *
- * Used by business object factory and -serializer.
- *
- * Usage:
- *
- * @StringNumber()
- * public rights: UserRightType
- */
-export function StringNumber(): PropertyDecorator {
-    return function (target: any, propertyKey: string): void {
-        if (!target || !propertyKey) {
-            return;
-        }
-        Reflect.defineMetadata(PROP_META_KEY, undefined, target, propertyKey);
-    };
-}
-
-// Utility function holder of the @StringNumber() decorator.
-export class StringNumberDecorator {
-
-    // Returns whether given property (as a string) on given object is decorated with @StringNumber().
-    public static IsStringNumber(target: Object, propertyKey: string): boolean {
-        if (!target || !propertyKey || typeof target !== "object") {
-            return false;
-        }
-        return Reflect.hasMetadata(PROP_META_KEY, target, propertyKey);
-    }
-
-    public static StringAsNumber(str: string): number {
-        return NumberUtils.ParseFloatKeepPrecision(str);
-    }
-
-    public static NumberAsString(nr: number): string {
-        return "" + nr;
-    }
-}

package/projects/sharedcomponents/src/lib/model/business-object.ts

@@ -1,85 +0,0 @@
-/**
- * This type represents the concept of a business object ID type. ID's of business objects can be a primary number, a simple string or a
- * object for a composite key.
- *
- * Simply to prevent type declarations of 'number | string | Object' for BO ID data all over the application.
- */
-import {MapPropertyDecorator} from "@colijnit/articleapi/build/factory/decorators/map-property.decorator";
-import {BooleanTextDecorator} from "@colijnit/articleapi/build/factory/decorators/boolean.decorator";
-import {JsonFieldFieldDecorator} from "@colijnit/articleapi/build/factory/decorators/json.decorator";
-import {ComplexArrayDecorator} from "@colijnit/articleapi/build/factory/decorators/complex-array.decorator";
-
-export type BusinessObjectIDType = number | string | Object;
-
-export abstract class BusinessObject {
-    // The ID of the model.
-    public id: BusinessObjectIDType;
-
-    // Overridable. Returns the ID of the model. Concrete model classes often override this method to provide their specific ID getter.
-    public getId(): BusinessObjectIDType {
-        return this.id;
-    }
-
-    constructor() {
-    }
-
-    protected setOwnMappedPropsFromRawData(rawData: any = {}): void {
-        if (!rawData) {
-            return;
-        }
-        Object.keys(this).forEach((key) => {
-            // check if property needs to be mapped
-            if (MapPropertyDecorator.IsMapProperty(this, key)) {
-                const mapKeys: string[] = MapPropertyDecorator.GetMapProperty(this, key).split(",");
-                const len: number = mapKeys.length;
-                for (let i: number = 0; i < len; i++) {
-                  // eslint-disable-next-line
-                    const mapKey = mapKeys[i].trim();
-                    const objProp: any = rawData[mapKey];
-                    let decorated: boolean = false;
-                    if (rawData.hasOwnProperty(mapKey)) {
-                        if (BooleanTextDecorator.IsBooleanTextField(this, key)) {
-                            this[key] = BooleanTextDecorator.GetLogicalBooleanValue(objProp);
-                            decorated = true;
-                        }
-                        if (JsonFieldFieldDecorator.IsJsonField(this, key)) {
-                            this[key] = JsonFieldFieldDecorator.StringAsJson(objProp);
-                            decorated = true;
-                        }
-                        if (ComplexArrayDecorator.IsComplexArray(this, key)) {
-                            const arrayClass: any = ComplexArrayDecorator.GetComplexArrayType(this, key);
-                          // eslint-disable-next-line
-                            const origArray = this[key];
-                          // eslint-disable-next-line
-                            const newArray = [];
-                          // eslint-disable-next-line @typescript-eslint/prefer-for-of
-                            for (let j = 0; j < origArray.length; j++) {
-                              // eslint-disable-next-line
-                                const item = new arrayClass(origArray[j]);
-                                newArray.push(item);
-                            }
-                            this[key] = newArray;
-                        } else {
-                            if (!decorated) {
-                                this[key] = objProp;
-                            }
-                        }
-                        break;
-                    }
-                }
-            } else {
-                if (rawData.hasOwnProperty(key)) {
-                    const objProp: any = rawData[key];
-                    if (BooleanTextDecorator.IsBooleanTextField(this, key)) {
-                        this[key] = BooleanTextDecorator.GetLogicalBooleanValue(objProp);
-                    } else if (JsonFieldFieldDecorator.IsJsonField(this, key)) {
-                        this[key] = JsonFieldFieldDecorator.StringAsJson(objProp);
-                    } else {
-                        this[key] = objProp;
-                    }
-                }
-            }
-        });
-    }
-
-}

package/projects/sharedcomponents/src/lib/service/ione-connector-adapter.service.ts

@@ -1,49 +0,0 @@
-import {Articles} from "@colijnit/articleapi/build/articles";
-import {Injectable} from "@angular/core";
-import {ArticleExtended} from "@colijnit/articleapi/build/model/article-extended.bo";
-import {DataServiceResponseData} from "@colijnit/articleapi/build/model/data-service-response-data";
-import {BusinessObjectFactory} from "../factory/business-object-factory";
-
-
-@Injectable({
-  providedIn: "root"
-})
-
-export class IoneConnectorAdapterService {
-  public options: any;
-  public connector: Articles
-
-  private _boFactory: BusinessObjectFactory = new BusinessObjectFactory();
-
-
-  constructor() {
-  }
-
-  public async connect(options: any): Promise<void> {
-    if (this.options === undefined) {
-      this.options = options;
-      this.connector = new Articles(options);
-      this.options.session = this.connector.session;
-    }
-  }
-
-  public async disconnect(): Promise<void> {
-    this.options = undefined;
-  }
-
-  public async getArticleFullObject(goodId: number): Promise<ArticleExtended> {
-    return new Promise((resolve: Function, reject: Function) => {
-      return this.connector.getArticleFullObject(goodId).then((result: DataServiceResponseData) => {
-        if (result.validationResult && result.validationResult.success) {
-          if (result.resultObject) {
-            resolve(this._boFactory.makeWithRawBackendData(ArticleExtended, result.resultObject));
-          }
-        } else {
-          reject(result.validationMessagesAsString);
-        }
-      });
-    });
-  }
-
-
-}

package/projects/sharedcomponents/src/lib/service/stock.service.ts

@@ -1,40 +0,0 @@
-import {Injectable} from "@angular/core";
-import {IoneConnectorAdapterService} from "./ione-connector-adapter.service";
-
-@Injectable()
-export class StockService {
-
-
-  constructor(
-    private _connector: IoneConnectorAdapterService,
-  ) {
-
-  }
-
-  public connectConnector(options: any): void {
-    this._connector.connect(options);
-  }
-
-  // public async getStock(goodId: number): Promise<ArticleFullObject> {
-  //   return await this._connector.getArticleFullObject(goodId);
-  // }
-
-  // public async getStockHistory(): Promise<GetStockHistoryRequest> {
-  //
-  // }
-
-  // public async getStockWarehouses(goodId: number): Promise<getWarehouses>
-
-  public async loadStockLocations(goodId: number): Promise<void> {
-    // await this._connector.getArticleFullObject(goodId);
-  }
-
-  private async _loadInOrders(): Promise<void> {
-    //this.inOrderInformation = await ...
-  }
-
-  private async _loadStockOrders(): Promise<void> {
-    // this.orderInformation =  await ...
-  }
-
-}