@corp-products/app-core 2.0.4 → 2.0.6

package/eslint.config.js

@@ -0,0 +1,48 @@
+const nx = require('@nx/eslint-plugin');
+const baseConfig = require('../../eslint.config.js');
+
+module.exports = [
+  ...baseConfig,
+  {
+    files: ['**/*.json'],
+    rules: {
+      '@nx/dependency-checks': [
+        'error',
+        {
+          ignoredFiles: ['{projectRoot}/eslint.config.{js,cjs,mjs}'],
+        },
+      ],
+    },
+    languageOptions: {
+      parser: require('jsonc-eslint-parser'),
+    },
+  },
+  ...nx.configs['flat/angular'],
+  ...nx.configs['flat/angular-template'],
+  {
+    files: ['**/*.ts'],
+    rules: {
+      '@angular-eslint/directive-selector': [
+        'error',
+        {
+          type: 'attribute',
+          prefix: 'app',
+          style: 'camelCase',
+        },
+      ],
+      '@angular-eslint/component-selector': [
+        'error',
+        {
+          type: 'element',
+          prefix: 'app',
+          style: 'kebab-case',
+        },
+      ],
+    },
+  },
+  {
+    files: ['**/*.html'],
+    // Override or add rules here
+    rules: {},
+  },
+];

package/ng-package.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "../../node_modules/ng-packagr/ng-package.schema.json",
+  "dest": "../../dist/libs/core",
+  "lib": {
+    "entryFile": "src/index.ts"
+  }
+}

package/package.json

@@ -1,36 +1,20 @@
-{
-  "name": "@corp-products/app-core",
-  "version": "2.0.4",
-  "author": "shireen Omar",
-  "description": "shared core services across our apps",
-  "peerDependencies": {
-    "@angular/common": "^18.2.0",
-    "@angular/core": "^18.2.0",
-    "primeng": "^17.6.0"
-  },
-  "keywords": [
-    "angular",
-    "library"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "license": "MIT",
-  "sideEffects": false,
-  "module": "fesm2022/corp-products-app-core.mjs",
-  "typings": "index.d.ts",
-  "exports": {
-    "./package.json": {
-      "default": "./package.json"
-    },
-    ".": {
-      "types": "./index.d.ts",
-      "esm2022": "./esm2022/corp-products-app-core.mjs",
-      "esm": "./esm2022/corp-products-app-core.mjs",
-      "default": "./fesm2022/corp-products-app-core.mjs"
-    }
-  },
-  "dependencies": {
-    "tslib": "^2.3.0"
-  }
-}
+{
+  "name": "@corp-products/app-core",
+  "version": "2.0.6",
+  "author": "shireen Omar",
+  "description": "shared core services across our apps",
+  "peerDependencies": {
+    "@angular/common": ">=18.0.0 <19.0.0",
+    "@angular/core": ">=18.0.0 <19.0.0",
+    "primeng": "^17.6.0"
+  },
+  "keywords": [
+    "angular",
+    "library"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "sideEffects": false
+}

package/project.json

@@ -0,0 +1,29 @@
+{
+  "name": "core",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "libs/core/src",
+  "prefix": "",
+  "projectType": "library",
+  "tags": [],
+  "targets": {
+    "build": {
+      "executor": "@nx/angular:package",
+      "outputs": ["{workspaceRoot}/dist/{projectRoot}"],
+      "options": {
+        "project": "libs/core/ng-package.json"
+      },
+      "configurations": {
+        "production": {
+          "tsConfig": "libs/core/tsconfig.lib.prod.json"
+        },
+        "development": {
+          "tsConfig": "libs/core/tsconfig.lib.json"
+        }
+      },
+      "defaultConfiguration": "production"
+    },
+    "lint": {
+      "executor": "@nx/eslint:lint"
+    }
+  }
+}

package/{index.d.ts → src/index.ts}

@@ -1,10 +1,10 @@
-export * from "./lib/core/services/base-pagination-service";
-export * from "./lib/core/components";
-export * from "./lib/core/services";
-export * from "./lib/core/interfaces";
-export * from "./lib/core/guards";
-export * from "./lib/core/interceptors";
-export * from "./lib/core/enums";
-export * from "./lib/core/directives";
-export * from "./lib/core/core-config";
-export * from "./lib/core/handlers";
+export * from "./lib/core/services/base-pagination-service";
+export * from "./lib/core/components";
+export * from "./lib/core/services";
+export * from "./lib/core/interfaces";
+export * from "./lib/core/guards";
+export * from "./lib/core/interceptors";
+export * from "./lib/core/enums";
+export * from "./lib/core/directives";
+export * from "./lib/core/core-config";
+export * from "./lib/core/handlers";

package/src/lib/core/components/global-loader/global-loader.component.html

@@ -0,0 +1,18 @@
+@if (loaderService.isLoading$ | async; as data) {
+  @if (data.show) {
+    <div
+      class="fixed inset-0 z-[1111] flex justify-center items-center"
+      [ngClass]="{
+       'bg-white/75': data?.isSystemLoader,
+       'absolute': !data?.isSystemLoader
+     }"
+      >
+      <div class="text-center flex flex-col gap-5 items-center">
+        <div
+          class="animate-spin inline-block w-12 h-12 border-[3px] border-current border-t-transparent text-gray-800 rounded-full">
+        </div>
+        <span>{{ 'loading' | translate }}</span>
+      </div>
+    </div>
+  }
+}

package/src/lib/core/components/global-loader/global-loader.component.spec.ts

@@ -0,0 +1,24 @@
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+
+import { GlobalLoaderComponent } from 'libs/core/src/lib/core/components/global-loader/global-loader.component';
+
+describe("LoaderComponent", () => {
+  let component: GlobalLoaderComponent;
+  let fixture: ComponentFixture<GlobalLoaderComponent>;
+
+  beforeEach(async () => {
+    await TestBed.configureTestingModule({
+      declarations: [GlobalLoaderComponent]
+    }).compileComponents();
+  });
+
+  beforeEach(() => {
+    fixture = TestBed.createComponent(GlobalLoaderComponent);
+    component = fixture.componentInstance;
+    fixture.detectChanges();
+  });
+
+  it("should create", () => {
+    expect(component).toBeTruthy();
+  });
+});

package/src/lib/core/components/global-loader/global-loader.component.ts

@@ -0,0 +1,16 @@
+import { AsyncPipe, NgClass } from '@angular/common';
+import { Component, Input } from '@angular/core';
+import {TranslatePipe} from "@ngx-translate/core";
+import {LoaderService} from "../../services";
+
+@Component({
+  selector: "global-loader",
+  templateUrl: "./global-loader.component.html",
+  styleUrls: ["./global-loader.component.scss"],
+  standalone: true,
+  imports: [AsyncPipe, NgClass, TranslatePipe]
+})
+export class GlobalLoaderComponent {
+  @Input() color: string;
+  constructor(public loaderService: LoaderService) {}
+}

package/{lib/core/components/index.d.ts → src/lib/core/components/index.ts}

@@ -1 +1 @@
-export * from "./global-loader/global-loader.component";
+export * from "./global-loader/global-loader.component";

package/src/lib/core/components/no-access/no-access.component.html

@@ -0,0 +1,9 @@
+<div class="flex items-center justify-center flex-col h-full gap-4 w-full">
+  <img [src]="imageSrc" alt="no-access" class="h-[300px]" />
+  <strong class="text-secondary font-size-22">{{ "oops" | translate }}</strong>
+  <p class="font-size-22 text-gray-500">{{ "do_not_have_permission" | translate }}</p>
+
+  <!-- @if (authService.isUserLoggedIn$ | async) {
+    <app-button (click)="router.navigate(['/'])" [title]="'home' | translate"/>
+  } -->
+</div>

package/src/lib/core/components/no-access/no-access.component.ts

@@ -0,0 +1,17 @@
+import { Component, inject } from "@angular/core";
+import { Router } from "@angular/router";
+import { AuthService } from "../../services/auth.service";
+import { AsyncPipe } from "@angular/common";
+import { TranslatePipe } from "@ngx-translate/core";
+
+@Component({
+  selector: "app-no-access",
+  templateUrl: "./no-access.component.html",
+  imports: [AsyncPipe, TranslatePipe],
+  standalone: true
+})
+export class NoAccessComponent {
+  imageSrc: string = "assets/images/no-access.svg";
+  authService = inject(AuthService);
+  public router = inject(Router);
+}

package/src/lib/core/core-config.ts

@@ -0,0 +1,21 @@
+import { InjectionToken } from "@angular/core";
+import { ToasterOptions } from "./interfaces";
+
+export interface CoreConfig {
+  apiPrefix: string;
+  production: boolean;
+  gatewayUrl: string;
+  loginUrl: string;
+  logoutEndpoint: string;
+}
+
+export const CORE_CONFIG = new InjectionToken<CoreConfig>("CoreConfig");
+
+
+export interface ToasterInterface {
+  success(options:ToasterOptions): void;
+  error(options:ToasterOptions): void;
+  warning(options:ToasterOptions): void;
+  info(options:ToasterOptions): void;
+}
+export const TOASTER_SERVICE = new InjectionToken<ToasterInterface>("ToasterService");

package/src/lib/core/directives/index.ts

@@ -0,0 +1,2 @@
+export * from './permissions.directive';
+export * from './responsive-element.directive';

package/src/lib/core/directives/permissions.directive.ts

@@ -0,0 +1,114 @@
+import {
+  Directive,
+  Input,
+  OnDestroy,
+  OnInit,
+  TemplateRef,
+  ViewContainerRef,
+} from '@angular/core';
+import { PermissionsService } from '../services';
+import { PermissionsActions, UserPermissionsEnum } from '../enums';
+import { Subscription } from 'rxjs';
+
+@Directive({
+  selector: '[hasPermissions]',
+  standalone: true
+})
+export class HasPermissionsDirective implements OnInit, OnDestroy {
+  private _actions: string[];
+  private _key: string;
+  private _newPermissions: string[];
+  private _isDomain: boolean;
+
+  private isViewCreated = false;
+  private subscription: Subscription;
+
+  constructor(
+    private permissionsService: PermissionsService,
+    private viewContainer: ViewContainerRef,
+    private templateRef: TemplateRef<unknown>
+  ) {}
+
+  /**
+   *  make sure that the key value looks like the UserPermissionsEnum enum
+   *  usage: *permissions="[PermissionsActions.EDIT]; key: LOOKUPS
+   */
+
+  @Input({ required: true }) set hasPermissions(actions: string[]) {
+    if (this.arraysChanged(this._actions, actions)) {
+      this._actions = actions;
+      this.updateView();
+    }
+  }
+
+  @Input({ required: true }) set hasPermissionsKey(key: string) {
+    if (this._key !== key) {
+      this._key = key;
+      this.updateView();
+    }
+  }
+
+  @Input() set hasPermissionsNewPermissions(newPermissions: string[]) {
+    if (this.arraysChanged(this._newPermissions, newPermissions)) {
+      this._newPermissions = newPermissions;
+      this.updateView();
+    }
+  }
+
+  @Input() set hasPermissionsIsDomain(isDomain: boolean) {
+    if (this._isDomain !== isDomain) {
+      this._isDomain = isDomain;
+      this.updateView();
+    }
+  }
+
+  ngOnInit(): void {
+    this.subscription = this.permissionsService.domainPermissions$.subscribe(() => {
+      if (this._isDomain) {
+        this.updateView();
+      }
+    });
+  }
+
+  ngOnDestroy(): void {
+    this.subscription?.unsubscribe();
+  }
+
+  private updateView() {
+    const canShow = this._actions.some(action => this.hasPermission(action));
+
+    if (canShow && !this.isViewCreated) {
+      this.viewContainer.createEmbeddedView(this.templateRef);
+      this.isViewCreated = true;
+    } else if (!canShow && this.isViewCreated) {
+      this.clearView();
+    }
+  }
+
+  private hasPermission(action: string): boolean {
+    if (this._isDomain) {
+      return this.permissionsService.checkDomainHasPermission(
+        this._key as UserPermissionsEnum,
+        action as PermissionsActions
+      );
+    }
+
+    return this.permissionsService.checkKeyHasPermission(
+      this._key as UserPermissionsEnum,
+      action as PermissionsActions,
+      this._newPermissions
+    );
+  }
+
+  private clearView() {
+    this.viewContainer.clear();
+    this.isViewCreated = false;
+  }
+
+  private arraysChanged(a?: string[], b?: string[]): boolean {
+    if (a === b) return false;
+    if (!a || !b) return true;
+    if (a.length !== b.length) return true;
+    return a.some((v, i) => v !== b[i]);
+  }
+}

package/src/lib/core/directives/responsive-element.directive.ts

@@ -0,0 +1,46 @@
+import { Directive, Input, OnDestroy, OnInit, TemplateRef, ViewContainerRef } from "@angular/core";
+import { Subscription } from "rxjs";
+import { DetectDeviceService } from "../services/detect-device.service";
+import { DisplayTypesEnum } from "../enums/display-types.enum";
+
+/*
+ * Usage:
+ * <div *responsiveElement="DisplayTypes.WEB_ONLY">Web</div>
+ * <div *responsiveElement="DisplayTypes.MOBILE_ONLY">Mobile</div>
+ * */
+
+@Directive({
+  selector: "[responsiveElement]",
+  standalone: true
+})
+export class ResponsiveElementDirective implements OnInit, OnDestroy {
+  @Input("responsiveElement") displayFor: DisplayTypesEnum.WEB_ONLY | DisplayTypesEnum.MOBILE_ONLY;
+
+  private resizeSubscription: Subscription = new Subscription();
+
+  constructor(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    private templateRef: TemplateRef<any>,
+    private viewContainer: ViewContainerRef,
+    private detectDeviceServiceService: DetectDeviceService
+  ) {}
+
+  ngOnInit() {
+    this.resizeSubscription.add(this.detectDeviceServiceService.onResize$.subscribe(this.checkWidth.bind(this)));
+  }
+
+  ngOnDestroy() {
+    this.resizeSubscription.unsubscribe();
+  }
+
+  private checkWidth() {
+    const shouldDisplay =
+      (this.displayFor === DisplayTypesEnum.WEB_ONLY && !this.detectDeviceServiceService.isMobile()) ||
+      (this.displayFor === DisplayTypesEnum.MOBILE_ONLY && this.detectDeviceServiceService.isMobile());
+    if (shouldDisplay) {
+      this.viewContainer.length === 0 && this.viewContainer.createEmbeddedView(this.templateRef);
+    } else {
+      this.viewContainer.clear();
+    }
+  }
+}

package/src/lib/core/enums/date-formatter.enum.ts

@@ -0,0 +1,16 @@
+export enum DateFormatter {
+  FULL_DATE_TIME = "dd MMM yyyy - hh:mm a",
+  DATE_TIME_ZONE = "yyyy-MM-dd'T'HH:mm:ssxxx",
+  DATE_UTC = "yyyy-MM-dd'T'HH:mm:ss'Z'",
+  dd_MM_yyyy = "dd-MM-yyyy",
+  yyyy_MM_dd = "yyyy-MM-dd",
+  MMM_dd_yyyy = "MMM dd ,yyyy",
+  MM_D_yyy = "MM dd ,yyy",
+  MMM_D_YYY_Time = "MMM dd ,YYYY - hh:mm a",
+  MMM_d_y_Time = "MMM d, y, h:mm a",
+  d_MM_y = "d MMM y",
+  MMM_D_Y = "MMM d, y",
+  DD_MM = "dd MMM",
+  DATE_PICKER = "dd/MM/yyyy",
+  DATE_FULL_YEAR = "yyyy"
+}

package/src/lib/core/enums/display-types.enum.ts

@@ -0,0 +1,4 @@
+export enum DisplayTypesEnum {
+  WEB_ONLY = "webOnly",
+  MOBILE_ONLY = "mobileOnly"
+}

package/src/lib/core/enums/index.ts

@@ -0,0 +1,4 @@
+export * from './user-permissions.enum';
+export * from './date-formatter.enum';
+export * from './display-types.enum';
+export * from './localization.enum';

package/src/lib/core/enums/localization.enum.ts

@@ -0,0 +1,9 @@
+export enum Language {
+  AR = "ar",
+  EN = "en"
+}
+
+export enum AppDirection {
+  RTL = "rtl",
+  LTR = "ltr"
+}

package/src/lib/core/enums/user-permissions.enum.ts

@@ -0,0 +1,36 @@
+export enum UserPermissionsEnum {
+  BOD = "BOD",
+  BOARD_COMMITTEES = "BOARD_COMMITTEES",
+  BOARD_MEETINGS = "BOARD_MEETINGS",
+  MEETING_INSIDE_THE_BOD = "MEETING_INSIDE_THE_BOD",
+  COMMITTEE = "COMMITTEE",
+  MEETING_INSIDE_THE_COMMITTEE = "MEETING_INSIDE_THE_COMMITTEE",
+  MEETING = "MEETING",
+  DECISION = "DECISION",
+  RECOMMENDATION = "RECOMMENDATION",
+  TASK = "TASK",
+  VOTING = "VOTING",
+  VOTING_SECRETARY_RESULTS = "VOTING_SECRETARY_RESULTS",
+  VOTING_RESULTS = "VOTING_RESULTS",
+  DRAFT_MOM = "DRAFT_MOM",
+  FINAL_MOM = "FINAL_MOM",
+  MOM = "MOM",
+  AGENDA = "AGENDA",
+  ATTENDEES = "ATTENDEES",
+  COMMENT = "COMMENT"
+}
+
+export enum PermissionsActions {
+  VIEW = "VIEW",
+  CREATE = "CREATE",
+  EDIT = "EDIT",
+  DELETE = "DELETE",
+  REORDER = "REORDER",
+  DOWNLOAD = "DOWNLOAD",
+  MARK = "MARK",
+  GENERATE = "GENERATE",
+  TERMINATE = "TERMINATE",
+  START = "START",
+  END = "END",
+  ACTIVATE = "ACTIVATE"
+}

package/src/lib/core/guards/auth.guard.ts

@@ -0,0 +1,17 @@
+import { inject } from "@angular/core";
+import { CanActivateFn } from "@angular/router";
+import { AuthService } from "../services";
+import { CORE_CONFIG, CoreConfig } from "../core-config";
+
+export const authGuard: CanActivateFn = () => {
+  const appConfig = inject<CoreConfig>(CORE_CONFIG);
+  const authService = inject(AuthService);
+  const token: string | null = authService.getUserToken();
+
+  if (!token) {
+    window.location.href = appConfig.loginUrl;
+    return false;
+  }
+
+  return true;
+};

package/{lib/core/guards/index.d.ts → src/lib/core/guards/index.ts}

@@ -1,2 +1,2 @@
-export * from './auth.guard';
-export * from './permissions.guard';
+export * from './auth.guard';
+export * from './permissions.guard';

package/src/lib/core/guards/permissions.guard.ts

@@ -0,0 +1,17 @@
+import { inject } from "@angular/core";
+import { CanActivateFn, Router } from "@angular/router";
+import { PermissionsService } from "../services";
+import { RoutePermissionsInfo } from "../interfaces";
+
+export const permissionsGuard: CanActivateFn = (route) => {
+  const permissionsService = inject(PermissionsService);
+  const router = inject(Router);
+  const { key, action }: RoutePermissionsInfo = route.data["permissions"];
+
+  if (!route.data["permissions"] || (route.data["permissions"] && permissionsService.routeGuardChecker(key, action))) {
+    return true;
+  } else {
+    router.navigate(["no-access"]);
+    return false;
+  }
+};

package/src/lib/core/handlers/http-context-handler.ts

@@ -0,0 +1,14 @@
+import { HttpContext, HttpContextToken } from "@angular/common/http";
+
+export const IS_SYSTEM_LOADER = new HttpContextToken<boolean>(() => true); // set default loader
+export const USE_API_PREFIX = new HttpContextToken<boolean>(() => true); // set default loader
+
+export class HttpContextHandler {
+  static setLoaderType(isSystemLoader: boolean) {
+    return new HttpContext().set(IS_SYSTEM_LOADER, isSystemLoader);
+  }
+
+  static useApiPrefix(hasBaseSegment: boolean) {
+    return new HttpContext().set(USE_API_PREFIX, hasBaseSegment);
+  }
+}

package/{lib/core/handlers/index.d.ts → src/lib/core/handlers/index.ts}

@@ -1,3 +1,3 @@
-export * from "./http-context-handler";
-export * from "./storage-handler";
-export * from "./stortage";
+export * from "./http-context-handler";
+export * from "./storage-handler";
+export * from "./stortage";

package/src/lib/core/handlers/storage-handler.ts

@@ -0,0 +1,37 @@
+// Important for global context
+import { LocalStorageKeys, SessionStorageKeys, StorageEnum } from "./stortage";
+
+const setLocalStorage = (key: string, value: string) => localStorage.setItem(key, value);
+const getLocalStorage = (key: string) => localStorage.getItem(key);
+const clearLocalStorage = () => localStorage.clear();
+const setSessionStorage = (key: string, value: string) => sessionStorage.setItem(key, value);
+const getSessionStorage = (key: string) => sessionStorage.getItem(key);
+const clearSessionStorage = () => sessionStorage.clear();
+
+export class StorageHandler {
+  public static local = {
+    set: (key: LocalStorageKeys, value: unknown) => this.setItem(key, value, setLocalStorage),
+    get: <T>(key: LocalStorageKeys) => this.getItem<T>(key, getLocalStorage),
+    clear: () => this.clearStorage(clearLocalStorage)
+  };
+  public static session = {
+    set: (key: SessionStorageKeys, value: unknown) => this.setItem(key, value, setSessionStorage),
+    get: <T>(key: SessionStorageKeys) => this.getItem<T>(key, getSessionStorage),
+    clear: () => this.clearStorage(clearSessionStorage)
+  };
+
+  private static setItem(key: StorageEnum, value: unknown, set: (key: string, value: string) => void): void {
+    if (!key) return;
+    set(key as string, typeof value === "string" ? value : JSON.stringify(value));
+  }
+
+  private static getItem<T>(key: StorageEnum, get: (key: string) => string | null, withParsing = false): T | null {
+    const data: string | null = get(key as string) ?? null;
+    if (data) return withParsing ? JSON.parse(data) as T : data as T;
+    return null;
+  }
+
+  private static clearStorage(clear: () => void): void {
+    clear();
+  }
+}

package/src/lib/core/handlers/stortage.ts

@@ -0,0 +1,7 @@
+export enum LocalStorageKeys {
+  LANGUAGE = "LANGUAGE",
+  TOKEN = "TOKEN"
+}
+
+export enum SessionStorageKeys {}
+export type StorageEnum = SessionStorageKeys | LocalStorageKeys;

package/src/lib/core/interceptors/app-http-config.ts

@@ -0,0 +1,8 @@
+export const COMMON_BASE_URL = "common/api/v1";
+export const APP_HTTP_CONFIG = {
+  BOARD_BASE_URL: "board-acl/private/v1",
+  MEETING_BASE_URL: "meeting-acl/private/v1",
+  IGATE_BASE_URL: COMMON_BASE_URL + "/igate-users",
+  LOV_BASE_URL: COMMON_BASE_URL + "/lov",
+  ATTACHMENT_BASE_URL: COMMON_BASE_URL + "/attachment"
+};