iss-ctrl 0.0.2 → 0.0.3

package/projects/iss/src/events/load/after-fetch.service.ts

@@ -0,0 +1,29 @@
+import {Injectable} from "@angular/core";
+import {FieldActionConfigFn, FieldEventArgument} from "../../shared/interfaces/field.interface";
+import {getPropertyByPath} from "../../shared/utilities/get-property-by-path.util";
+
+@Injectable({providedIn: "root"})
+export class AfterFetchService implements FieldActionConfigFn {
+  execute(args: FieldEventArgument) {
+    // set options from response in case of selectable fields
+    if (args.field.base === "select") {
+      args.field.options.set(args.field.response);
+    }
+
+    args.control.setValue(getPropertyByPath(args.field.response, args.action.config.setValueFromApiResponse) || args.field.response.data);
+
+    // if (args.action?.config?.setValueFromApiResponse) {
+    //   // setValue using specific property from response
+    // } else {
+    //   if (args.field.base === "input") {
+    //     args.control.setValue(args.field.response.data);
+    //   }
+    // }
+
+    if (args.action.config.disableAfterFetching) {
+      args.control.disable();
+    }
+
+    args.field.loading.set(false);
+  }
+}

package/projects/iss/src/events/load/load-event.service.ts

@@ -0,0 +1,26 @@
+import {inject, Injectable} from "@angular/core";
+import {FieldEventArgument} from "../../shared/interfaces/field.interface";
+import {HOST} from "../../shared/tokens/host.token";
+import {ReplaceApiKeysService} from "./replace-api-keys.service";
+
+@Injectable({providedIn: "root"})
+export class LoadEventService {
+  #replaceApiKeysService = inject(ReplaceApiKeysService);
+  #host: string = inject(HOST);
+
+  getApi(args: FieldEventArgument) {
+    let api;
+    if (args.action.config.fn) {
+      api = args.action.config.fn.execute(args);
+    } else {
+      api = this.#replaceApiKeysService.execute(args);
+    }
+
+    return `${this.#host}${api}`;
+  }
+
+  fetchErrorHandler(args: FieldEventArgument, err: any) {
+    console.error(err);
+    args.field.loading.set(false);
+  }
+}

package/projects/iss/src/events/load/load-options-event.service.ts

@@ -0,0 +1,51 @@
+import {inject, Injectable} from "@angular/core";
+import {Dto} from "../../shared/interfaces/dto.interface";
+import {FieldEvent, FieldEventArgument} from "../../shared/interfaces/field.interface";
+import {HOST} from "../../shared/tokens/host.token";
+import {getPropertyByPath} from "../../shared/utilities/get-property-by-path.util";
+import {IssHttp} from "../../shared/utilities/http.util.service";
+import {LoadEventService} from "./load-event.service";
+
+@Injectable({providedIn: "root"})
+export class LoadOptionsEventService implements FieldEvent {
+  loadEvent = inject(LoadEventService);
+  #http: IssHttp = inject(IssHttp);
+  #host: string = inject(HOST);
+
+  fire(args: FieldEventArgument) {
+    console.log(`${args.field.name} listens to ${args.action.trackedFieldName} =>` + "%c Load Event Fired", "color: green");
+    const api = this.loadEvent.getApi(args);
+
+    args.field.loading.set(true);
+    this.#http.get(api).subscribe({
+      next: (response: Dto) => {
+        args.field.response = response;
+        args.field.apiResponse.next(response.data);
+
+        if (args.action.config.afterFetchFn) {
+          args.action.config.afterFetchFn?.execute(args);
+        } else {
+          args.field.options.set(args.field.response.data);
+
+          if (args.action.config.setValueFromApiResponse) {
+            args.control.setValue(getPropertyByPath(args.field.response, args.action.config.setValueFromApiResponse));
+          }
+
+          if (args.action.config.disableAfterFetching) {
+            args.control.disable();
+          }
+        }
+        args.field.loading.set(false);
+      },
+      error: (err) => {
+        // todo handle errors
+        this.loadEvent.fetchErrorHandler(args, err);
+      },
+    });
+    args.action.triggered = true;
+  }
+
+  revert(args: FieldEventArgument) {
+    console.log(`${args.field.name} listens to ${args.action.trackedFieldName} =>` + "%c Load Event Reverted", "color: red");
+  }
+}

package/projects/iss/src/events/load/load-value-event.service.ts

@@ -0,0 +1,50 @@
+import {inject, Injectable} from "@angular/core";
+import {Dto} from "../../shared/interfaces/dto.interface";
+import {FieldEvent, FieldEventArgument} from "../../shared/interfaces/field.interface";
+import {getPropertyByPath} from "../../shared/utilities/get-property-by-path.util";
+import {IssHttp} from "../../shared/utilities/http.util.service";
+import {LoadEventService} from "./load-event.service";
+
+@Injectable({providedIn: "root"})
+export class LoadValueEventService implements FieldEvent {
+  loadEvent = inject(LoadEventService);
+  #http: IssHttp = inject(IssHttp);
+
+  fire(args: FieldEventArgument) {
+    console.log(`${args.field.name} listens to ${args.action.trackedFieldName} =>` + "%c Load Event Fired", "color: green");
+    const api = this.loadEvent.getApi(args);
+
+    args.field.loading.set(true);
+    this.#http.get(api).subscribe({
+      next: (response: Dto) => {
+        args.field.response = response;
+        args.field.apiResponse.next(response.data);
+
+        if (args.action.config.afterFetchFn) {
+          args.action.config.afterFetchFn?.execute(args);
+        } else {
+          if (args.action?.config?.setValueFromApiResponse) {
+            args.control.setValue(getPropertyByPath(args.field.response, args.action.config.setValueFromApiResponse));
+          } else {
+            args.control.setValue(args.field.response.data);
+          }
+
+          if (args.action.config.disableAfterFetching) {
+            args.control.disable();
+          }
+        }
+
+        args.field.loading.set(false);
+      },
+      error: (err) => {
+        // todo handle errors
+        this.loadEvent.fetchErrorHandler(args, err);
+      },
+    });
+    args.action.triggered = true;
+  }
+
+  revert(args: FieldEventArgument) {
+    console.log(`${args.field.name} listens to ${args.action.trackedFieldName} =>` + "%c Load Event Reverted", "color: red");
+  }
+}

package/projects/iss/src/events/load/replace-api-keys.service.ts

@@ -0,0 +1,55 @@
+import {Injectable} from "@angular/core";
+import {PLACEHOLDER_REGEX} from "../../shared/constants/regex.const";
+import {FieldActionConfigFn, FieldEventArgument} from "../../shared/interfaces/field.interface";
+import {getPropertyByPath} from "../../shared/utilities/get-property-by-path.util";
+import {replacePlaceholders} from "../../shared/utilities/replace-placeholder.util";
+
+@Injectable({providedIn: "root"})
+export class ReplaceApiKeysService implements FieldActionConfigFn {
+  // todo replace {key} with tracked field value [will be deprecated]
+  execute(args: FieldEventArgument): string {
+    // console.log("Replace API keys - Default Implementation");
+    const api = args.field.api();
+    const matches = api.match(PLACEHOLDER_REGEX);
+    if (matches) {
+      const replacements: any = {};
+      matches.forEach((match) => {
+        const replacement = match.replace("{", "").replace("}", "");
+
+        if (replacement.includes(".")) {
+          const path = this.getPath(replacement);
+
+          if (replacement.includes(args.change.trackedField.name)) {
+            replacements[replacement] = getPropertyByPath(args.change.trackedField, path);
+          }
+
+          if (replacement.includes("loggedInUser")) {
+            const loggedInUserProfileStr = localStorage.getItem("profile");
+            if (loggedInUserProfileStr) {
+              const loggedInUserProfile = JSON.parse(loggedInUserProfileStr);
+              replacements[replacement] = getPropertyByPath(loggedInUserProfile, path);
+            } else {
+              throw new Error("User profile not found in localStorage. Make sure that localStorage has profile key with user profile.");
+            }
+          }
+
+          if (replacement.includes("requestDto")) {
+            // todo replace {fromRequestDto}
+            // todo from where to get requestDto?
+          }
+        } else {
+          replacements[replacement] = args.form.get(replacement)?.getRawValue();
+        }
+      });
+      return replacePlaceholders(api, replacements);
+    }
+
+    return api;
+  }
+
+  getPath(replacement: string): string {
+    const arr = replacement.split(".");
+    arr.shift();
+    return arr.join(".");
+  }
+}

package/projects/iss/src/events/set-value/get-value-to-set.service.ts

@@ -0,0 +1,29 @@
+import {Injectable} from "@angular/core";
+import {map, Observable, of} from "rxjs";
+import {FieldActionConfigFn, FieldEventArgument} from "../../shared/interfaces/field.interface";
+import {getPropertyByPath} from "../../shared/utilities/get-property-by-path.util";
+
+@Injectable({providedIn: "root"})
+export class GetValueToSetService implements FieldActionConfigFn {
+  execute(args: FieldEventArgument): Observable<string> {
+    if (args.action?.config?.setValueFromJsonValue) {
+      return of(getPropertyByPath(args.field.ctrlJsonValue(), args.action.config.setValueFromJsonValue));
+    }
+
+    if (args.action?.config?.setValueFromApiResponse) {
+      return args.field.apiResponse.pipe(
+        map((value: any) => getPropertyByPath(value, args.action.config.setValueFromApiResponse))
+      );
+    }
+
+    if (args.action?.config?.setValueFromLoggedInUser) {
+
+    }
+
+    if (args.action?.config?.setValueFromRequestDto) {
+
+    }
+
+    return of(args.change.value);
+  }
+}

package/projects/iss/src/events/set-value/set-value-event.service.ts

@@ -0,0 +1,33 @@
+import {inject, Injectable} from "@angular/core";
+import {FieldEvent, FieldEventArgument} from "../../shared/interfaces/field.interface";
+import {GetValueToSetService} from "./get-value-to-set.service";
+
+@Injectable({providedIn: "root"})
+export class SetValueEventService implements FieldEvent {
+  getValueToSetService = inject(GetValueToSetService);
+
+  fire(args: FieldEventArgument) {
+    console.log(`${args.field.name} listens to ${args.action.trackedFieldName} =>` + "%c Set Value Event Fired", "color: green");
+    let valueToSet;
+    if (args.action.config.fn) {
+      valueToSet = args.action.config.fn.execute(args);
+    } else {
+      valueToSet = this.getValueToSetService.execute(args);
+    }
+
+    valueToSet.subscribe((value: string) => {
+      args.control.setValue(value, {emitEvent: false});
+    });
+
+    if (args.action.config.disableAfterSetValue) {
+      args.control.disable();
+    }
+    args.action.triggered = true;
+  }
+
+  revert(args: FieldEventArgument) {
+    console.log(`${args.field.name} listens to ${args.action.trackedFieldName} =>` + "%c Set Value Event Reverted", "color: red");
+    args.control.setValue(null);
+    args.action.triggered = false;
+  }
+}

package/projects/iss/src/events/show/show-event.service.ts

@@ -0,0 +1,11 @@
+import {Injectable} from "@angular/core";
+import {FieldEvent, FieldEventArgument} from "../../shared/interfaces/field.interface";
+
+@Injectable({providedIn: "root"})
+export class ShowEventService implements FieldEvent {
+  fire(args: FieldEventArgument) {
+    console.log("show works");
+  }
+
+  revert(args: FieldEventArgument) { }
+}

package/projects/iss/src/events/triggers/action-trigger-manager.service.ts

@@ -0,0 +1,51 @@
+import {inject, Injectable} from "@angular/core";
+import {FieldAction} from "../../shared/classes/field-action";
+import {FormField} from "../../shared/classes/form-field";
+import {ActionTriggerFn} from "../../shared/interfaces/action.interface";
+import {FieldChange} from "../../shared/interfaces/field.interface";
+import {ActionTriggerService} from "./action-trigger.service";
+
+@Injectable({providedIn: "root"})
+export class ActionTriggerManagerService {
+  actionTriggerService = inject(ActionTriggerService);
+
+  async getActionsToBeTriggered(field: FormField, change: FieldChange): Promise<FieldAction[]> {
+    const actionsToBeTriggered: FieldAction[] = [];
+    for (const action of field.events) {
+      /* todo remove await from array and use allSettle instead or any other solution */
+      const isTruthy = await this.#filterCondition(field, action, change);
+      if (isTruthy) {
+        actionsToBeTriggered.push(action);
+      }
+    }
+    return actionsToBeTriggered;
+  }
+
+  async getActionsToBeReverted(field: FormField, change: FieldChange): Promise<FieldAction[]> {
+    const actionsToBeReverted: FieldAction[] = [];
+    for (const action of field.events) {
+      if (action.trackedFieldName !== change.trackedField.name) {
+        /* todo remove await from array and use allSettle instead or any other solution */
+        const isTruthy = await this.#filterCondition(field, action, change);
+
+        if (!isTruthy && action.triggered) {
+          actionsToBeReverted.push(action);
+        }
+      }
+    }
+    return actionsToBeReverted;
+  }
+
+  async #filterCondition(field: FormField, action: FieldAction, change: FieldChange) {
+    let triggerFn: ActionTriggerFn = action.config.triggerFn;
+    if (!triggerFn && action.config.triggerFnPromise) {
+      triggerFn = await action.config.triggerFnPromise;
+    }
+
+    if (triggerFn) {
+      return triggerFn.isTriggered(field, change, action);
+    }
+
+    return this.actionTriggerService.isTriggered(field, change, action);
+  }
+}

package/projects/iss/src/events/triggers/action-trigger.service.ts

@@ -0,0 +1,30 @@
+import {Injectable} from "@angular/core";
+import {FieldAction} from "../../shared/classes/field-action";
+import {FormField} from "../../shared/classes/form-field";
+import {ActionTriggerFn} from "../../shared/interfaces/action.interface";
+import {FieldChange} from "../../shared/interfaces/field.interface";
+
+@Injectable({providedIn: "root"})
+export class ActionTriggerService implements ActionTriggerFn {
+  isTriggered(field: FormField, change: FieldChange, action: FieldAction, masterField?: FormField): boolean {
+    if (field.name === action.trackedFieldName) {
+      return true;
+    }
+    return action.value.split(",").some((actionValue: string) => {
+      if (actionValue === "*" && change.value !== null && change.value !== undefined) {
+        return true;
+      }
+
+      if (!change) {
+        return false;
+      }
+
+      if (change.value === null || change.value === undefined) {
+        return false;
+      }
+
+      const changeValueArray: string[] = change?.value.toString().split(",").map((val) => val.trim());
+      return (changeValueArray?.includes(actionValue.trim()));
+    });
+  }
+}

package/projects/iss/src/events/triggers/trigger-based-on-json-value.service.ts

@@ -0,0 +1,19 @@
+import {Injectable} from "@angular/core";
+import {FieldAction} from "../../shared/classes/field-action";
+import {FormField} from "../../shared/classes/form-field";
+import {ActionTriggerFn} from "../../shared/interfaces/action.interface";
+import {FieldChange} from "../../shared/interfaces/field.interface";
+import {getPropertyByPath} from "../../shared/utilities/get-property-by-path.util";
+
+@Injectable({providedIn: "root"})
+export class TriggerBasedOnJsonValueService implements ActionTriggerFn {
+  isTriggered(field: FormField, change: FieldChange, action: FieldAction, masterField: FormField): boolean {
+    if (masterField) {
+      const actionTriggersOnAnyValue: boolean = action.value === "*" && (change.value !== null && change.value !== undefined);
+      const triggerValue = getPropertyByPath(masterField.ctrlJsonValue(), action.config?.triggerFromJsonValue);
+      const actionTriggersOnSpecificValue: boolean = triggerValue === action.value;
+      return actionTriggersOnAnyValue || actionTriggersOnSpecificValue;
+    }
+    return false;
+  }
+}

package/projects/iss/src/public-api.ts

@@ -0,0 +1,102 @@
+// controls
+export * from "./components/controls/checkbox/checkbox.control";
+export * from "./components/controls/chips/chips.control";
+export * from "./components/controls/date-picker/date-picker.control";
+export * from "./components/controls/date-range-picker/date-range-picker.control";
+export * from "./components/controls/datetime-picker/datetime-picker.control";
+export * from "./components/controls/file-picker/file-picker.control";
+export * from "./components/controls/input/input.control";
+export * from "./components/controls/mobile/mobile.control";
+export * from "./components/controls/plate/plate.control";
+export * from "./components/controls/radio/radio.control";
+export * from "./components/controls/select/select.control";
+export * from "./components/controls/slide-toggle/slide-toggle.control";
+export * from "./components/controls/textarea/textarea.control";
+export * from "./components/controls/time-picker/time-picker.control";
+export * from "./components/controls/toggle-button/toggle-button.control";
+export * from "./components/controls/base/control.base";
+
+// outlet
+export * from "./components/outlet/outlet";
+
+// wrappers
+// Todo: exporting wrappers after refactor.
+export * from "./components/controls/base/wrapper.base";
+
+// viewers
+// Todo: exporting viewers after wrappers refactor.
+
+// classes
+// Todo: exporting classes after refactor.
+
+// constants
+export * from "./shared/constants/countries.const";
+export * from "./shared/constants/date.const";
+export * from "./shared/constants/plate-letters.const";
+export * from "./shared/constants/provider.const";
+export * from "./shared/constants/regex.const";
+export * from "./shared/constants/validation.const";
+
+// indexes
+export * from "./shared/indexes/components.index";
+export * from "./shared/indexes/services.index";
+export * from "./shared/indexes/validators.index";
+
+// interfaces
+export * from "./shared/interfaces/action.interface";
+export * from "./shared/interfaces/attachment.interface";
+export * from "./shared/interfaces/country.interface";
+export * from "./shared/interfaces/date-range.interface";
+export * from "./shared/interfaces/field.interface";
+export * from "./shared/interfaces/file.interface";
+export * from "./shared/interfaces/hint.interface";
+export * from "./shared/interfaces/i18n.interface";
+export * from "./shared/interfaces/import.interface";
+export * from "./shared/interfaces/mobile.interface";
+export * from "./shared/interfaces/option.interface";
+export * from "./shared/interfaces/outlet.interface";
+export * from "./shared/interfaces/plate-letter.interface";
+export * from "./shared/interfaces/datetime.interface";
+export * from "./shared/interfaces/validation.interface";
+
+// tokens
+export * from "./shared/tokens/attachment.token";
+export * from "./shared/tokens/field.token";
+export * from "./shared/tokens/language.token";
+export * from "./shared/tokens/url.token";
+
+// types
+export * from "./shared/types/iso2.type";
+export * from "./shared/types/validation.type";
+
+// components
+export * from "./components/shared/hints.component";
+export * from "./components/shared/validation-message.component";
+
+// directives
+export * from "./components/controls/file-picker/droppable.directive";
+
+// pipes
+export * from "./shared/pipes/arabic-number.pipe";
+export * from "./components/outlet/field-data-injector.pipe";
+export * from "./components/controls/plate/plate-letter.pipe";
+export * from "./shared/pipes/select-status.pipe";
+export * from "./shared/pipes/translate.pipe";
+
+// services
+export * from "./components/controls/user-picker/employee.service";
+export * from "./components/controls/file-picker/file-handler.service";
+export * from "./shared/services/form-engine.service";
+export * from "./shared/services/loader.service";
+export * from "./components/controls/mobile/phone.service";
+
+// utilities
+export * from "./shared/utilities/array-from.util";
+export * from "./shared/utilities/format-file-size.util";
+export * from "./shared/utilities/get-property-by-path.util";
+export * from "./shared/utilities/replace-placeholder.util";
+
+// validators
+export * from "./validators/core.validator";
+export * from "./validators/file.validator";
+export * from "./validators/time.validator";

package/projects/iss/src/shared/classes/field-action-config.ts

@@ -0,0 +1,56 @@
+import {ActionTriggerFn} from "../interfaces/action.interface";
+import {FieldActionConfigFn} from "../interfaces/field.interface";
+import {LoaderService} from "../services/loader.service";
+
+export class FieldActionConfig {
+  operator: "or" | "and" | undefined;
+  setValueFromApiResponse: string | undefined;
+  setValueFromRequestDto: string | undefined;
+  setValueFromLoggedInUser: string | undefined;
+  setValueFromJsonValue: string | undefined;
+  triggerFromApiResponse: string | undefined;
+  triggerFromJsonValue: string | undefined;
+  replaceApiKeyFromField: string | undefined;
+  fn: FieldActionConfigFn | undefined = undefined;
+  fnPromise: Promise<FieldActionConfigFn> | undefined = undefined;
+  afterFetchFn: FieldActionConfigFn | undefined = undefined;
+  afterFetchFnPromise: Promise<FieldActionConfigFn> | undefined = undefined;
+  triggerFn!: ActionTriggerFn;
+  triggerFnPromise: Promise<ActionTriggerFn> | undefined = undefined;
+  disableAfterFetching: boolean | undefined = false;
+  disableAfterSetValue: boolean | undefined = false;
+
+  constructor(action: any, loader: LoaderService) {
+    this.operator = action.config?.operator;
+    this.setValueFromApiResponse = action.config?.setValueFromApiResponse;
+    this.setValueFromRequestDto = action.config?.setValueFromRequestDto;
+    this.setValueFromLoggedInUser = action.config?.setValueFromLoggedInUser;
+    this.setValueFromJsonValue = action.config?.setValueFromJsonValue;
+    this.triggerFromApiResponse = action.config?.fromApiResponse;
+    this.triggerFromJsonValue = action.config?.fromApiResponse;
+    this.replaceApiKeyFromField = action.config?.replaceApiKeyFromField;
+    this.disableAfterFetching = action.config?.disableAfterFetching ?? false;
+    this.disableAfterSetValue = action.config?.disableAfterSetValue ?? false;
+
+    if (action.config?.fn) {
+      const fn = loader.loadService<FieldActionConfigFn>(action.config.fn);
+      if (fn) {
+        this.fnPromise = fn();
+      }
+    }
+
+    if (action.config?.afterFetchFn) {
+      const fn = loader.loadService<FieldActionConfigFn>(action.config.afterFetchFn);
+      if (fn) {
+        this.afterFetchFnPromise = fn();
+      }
+    }
+
+    if (action.config?.triggerFn) {
+      const fn = loader.loadService<ActionTriggerFn>(action.config.triggerFn);
+      if (fn) {
+        this.triggerFnPromise = fn();
+      }
+    }
+  }
+}

package/projects/iss/src/shared/classes/field-action.ts

@@ -0,0 +1,28 @@
+import {FieldEvent} from "../interfaces/field.interface";
+import {LoaderService} from "../services/loader.service";
+import {FieldActionConfig} from "./field-action-config";
+
+export class FieldAction {
+  id: number;
+  name: string;
+  value: string;
+  trackedFieldName: string;
+  triggered: boolean;
+  config: FieldActionConfig;
+  fn: FieldEvent | undefined;
+  fnPromise: Promise<FieldEvent> | undefined = undefined;
+
+  constructor(action: any, loader: LoaderService) {
+    this.id = action.id;
+    this.name = action.name;
+    this.value = action.value;
+    this.trackedFieldName = action.eventSourceName;
+    this.triggered = false;
+    this.config = new FieldActionConfig(action, loader);
+    const actionFn = loader.loadService<FieldEvent>(action.name);
+    if (actionFn) {
+      this.fnPromise = actionFn();
+    }
+    this.fn = undefined;
+  }
+}

package/projects/iss/src/shared/classes/field-async-validation.ts

@@ -0,0 +1,7 @@
+export class FieldAsyncValidation {
+  alreadyExists: string | undefined;
+
+  constructor(asyncValidation: any) {
+    this.alreadyExists = asyncValidation?.alreadyExists;
+  }
+}