tsv2-library 1.0.61-alpha.14 → 1.0.61-alpha.140

package/dist/src/utils/customMarker.util.d.ts

@@ -0,0 +1,64 @@
+import { Component } from 'vue';
+export type MarkerConfig = {
+    kind: 'pin';
+    pinOptions?: google.maps.marker.PinElementOptions;
+    title?: string;
+} | {
+    kind: 'img';
+    src: string;
+    title?: string;
+} | {
+    kind: 'svgString';
+    svg: string;
+    title?: string;
+} | {
+    kind: 'customElement';
+    createElement: () => HTMLElement;
+    title?: string;
+};
+export interface MapControl {
+    position?: google.maps.ControlPosition;
+    index?: number;
+    createElement: (ctx: {
+        map: google.maps.Map;
+    }) => HTMLElement;
+}
+export interface MapFocusConfig {
+    name: string;
+    featureType: google.maps.FeatureType;
+    featureStyleOptions: google.maps.FeatureStyleOptions;
+}
+export interface CustomMarkerOptions {
+    position: {
+        lat: number;
+        lng: number;
+    };
+    marker?: MarkerConfig;
+    title?: string;
+    popup?: string;
+    hoverable?: boolean;
+    draggable?: boolean;
+    clickable?: boolean;
+    onClick?: (marker: google.maps.marker.AdvancedMarkerElement) => void;
+    onDragEnd?: (marker: google.maps.marker.AdvancedMarkerElement) => void;
+    onHover?: (marker: google.maps.marker.AdvancedMarkerElement, isHovering: boolean) => void;
+}
+export declare const createMarker: (options: CustomMarkerOptions) => Promise<google.maps.marker.AdvancedMarkerElement>;
+type MarkerContext<T = unknown> = {
+    id: string;
+    marker: google.maps.marker.AdvancedMarkerElement;
+    data: T;
+};
+type UseMapMarkersReturn<T = unknown> = {
+    markers: Map<string, MarkerContext<T>>;
+    setMap: (nextMap: google.maps.Map) => void;
+    addMarker: (id: string, marker: google.maps.marker.AdvancedMarkerElement, data: T, onClick?: () => void) => void;
+    openMarker: (id: string, options?: {
+        component?: Component;
+        props?: Record<string, unknown>;
+        loadData?: () => Promise<Record<string, unknown>>;
+    }) => Promise<void>;
+    clearMarkers: () => void;
+};
+export declare const useMapMarkers: <T = unknown>() => UseMapMarkersReturn<T>;
+export {};

package/dist/src/utils/debounce.util.d.ts

@@ -0,0 +1 @@
+export declare const debounce: <T extends (...args: any[]) => void>(fn: T, delay?: number) => (...args: Parameters<T>) => void;

package/dist/src/utils/exportToExcel.util.d.ts

@@ -2,6 +2,7 @@ interface IExcelOptions {
     headers?: string[];
     data: object[];
     fileName: string;
+    preContentData?: (string | number)[][];
 }
 declare const exportToExcel: (options: IExcelOptions) => Promise<void>;
 export default exportToExcel;

package/dist/src/utils/getImageURL.util.d.ts

@@ -1,11 +1,11 @@
-export declare const buildFileURL: (name: string, width?: number, height?: number) => string;
-export declare const fetchBlobFile: (url: string, token: string) => Promise<Blob>;
+export declare const buildFileURL: (name?: string, width?: number, height?: number) => string;
 /**
  *
- * @param fileUrl The full URL
+ * @param name The full URL, or the file token as it appears on the server
  * @param fileName  Custom File name
  * @param immediateRevoke Immediately revoke the object URL after download - default to true
+ * @param viewNewTab View the file in a new tab - default to false
  * @returns
  */
-export declare const downloadFile: (fileUrl: string, fileName: string, immediateRevoke?: boolean) => Promise<string>;
+export declare const downloadFile: (name: string, customFileName?: string, immediateRevoke?: boolean, viewNewTab?: boolean) => Promise<string>;
 export declare const getImageURL: (name?: string | null, width?: number, height?: number, returnURLOnly?: boolean) => Promise<string | undefined>;

package/dist/src/utils/googleMapLoader.util.d.ts

@@ -0,0 +1 @@
+export declare const googleMapLoader: () => Promise<void>;

package/dist/src/utils/index.d.ts

@@ -1,10 +1,10 @@
-import { formatUserName, formatVowelSoundLabel } from './textFormater.util';
+import { formatUserName, formatVowelSoundLabel, formatDisplayAssetId, formatDisplayAssetName } from './textFormater.util';
 import handleTokenExpiration from './handleTokenExpiration.util';
 import exportToExcel from './exportToExcel.util';
 import { formatGoDate, formatDate, formatDateReadable, getUserLocale } from './date.util';
 import useToast from './toast.util';
-import { getImageURL } from './getImageURL.util';
-import { getTransactionRole, getSystemRole, hasSystemRole, hasTransactionRole, checkRouteAccess, hasApprovalRole, hasManagerRole, hasAnyManagerRole, hasAnyMonitoringReportRole, hasMonitoringReportRole, hasStaffRole } from './role.util';
+import { getImageURL, downloadFile } from './getImageURL.util';
+import { getTransactionRole, getSystemRole, hasSystemRole, hasTransactionRole, checkRouteAccess, hasApprovalRole, hasManagerRole, hasAnyManagerRole, hasAnyMonitoringReportRole, hasMonitoringReportRole, hasStaffRole, hasAccessToAssetDetail } from './role.util';
 import { getCurrency, formatCurrency } from './currency.util';
 import { unListenSidebarChanges, listenSidebarChanges } from './listenSidebarChanges.util';
 import { getBaseURL, getHostName } from './getBaseURL.util';
@@ -13,6 +13,10 @@ import { getSeverityByAssetStatus } from './getSeverityByAssetStatus.util';
 import clearStorage from './clearStorage.util';
 import forceLogout from './forceLogout.util';
 import reLogin from './reLogin.util';
+import { isValidJSONString } from './json.util';
+import { buildBodyParams } from './request.util';
+import { formatLogResponseData } from './changelog.util';
+import { googleMapLoader } from './googleMapLoader.util';
 declare const isObjectEmpty: (object: object) => boolean;
 declare const getNestedProperyValue: (object: object, property: string) => string | boolean | number | object;
-export { isObjectEmpty, getNestedProperyValue, handleTokenExpiration, getImageURL, formatUserName, formatVowelSoundLabel, exportToExcel, formatGoDate, formatDate, getUserLocale, formatDateReadable, useToast, listenSidebarChanges, unListenSidebarChanges, getCurrency, formatCurrency, getBaseURL, getHostName, useI18n, getSeverityByAssetStatus, clearStorage, forceLogout, reLogin, getTransactionRole, getSystemRole, hasSystemRole, hasTransactionRole, checkRouteAccess, hasApprovalRole, hasManagerRole, hasAnyManagerRole, hasMonitoringReportRole, hasAnyMonitoringReportRole, hasStaffRole, };
+export { isObjectEmpty, getNestedProperyValue, handleTokenExpiration, getImageURL, downloadFile, formatUserName, formatVowelSoundLabel, formatDisplayAssetId, formatDisplayAssetName, exportToExcel, formatGoDate, formatDate, getUserLocale, formatDateReadable, useToast, listenSidebarChanges, unListenSidebarChanges, getCurrency, formatCurrency, getBaseURL, getHostName, useI18n, getSeverityByAssetStatus, clearStorage, forceLogout, reLogin, isValidJSONString, buildBodyParams, formatLogResponseData, googleMapLoader, getTransactionRole, getSystemRole, hasSystemRole, hasTransactionRole, checkRouteAccess, hasApprovalRole, hasManagerRole, hasAnyManagerRole, hasMonitoringReportRole, hasAnyMonitoringReportRole, hasStaffRole, hasAccessToAssetDetail, };

package/dist/src/utils/json.util.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Checks if a given value is a valid JSON string that represents an object or array.
+ *
+ * @param value - The value to be checked
+ * @returns `true` if the value is a non-empty string that can be parsed into a valid JSON object or array,
+ *          `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * isValidJSONString('{"name": "John"}') // returns true
+ * isValidJSONString('[1, 2, 3]') // returns true
+ * isValidJSONString('123') // returns false (not an object/array)
+ * isValidJSONString('invalid json') // returns false
+ * isValidJSONString(null) // returns false
+ * ```
+ */
+export declare const isValidJSONString: (value: unknown) => boolean;

package/dist/src/utils/request.util.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Builds and transforms body parameters by parsing JSON strings if valid.
+ * @param params - Optional record of key-value pairs where values can be of any type
+ * @returns A new record with the same keys but JSON strings parsed into objects
+ *
+ * @example
+ * ```typescript
+ * // With JSON string value
+ * buildBodyParams({ data: '{"foo": "bar"}' })
+ * // Returns: { data: { foo: "bar" } }
+ *
+ * // With non-JSON value
+ * buildBodyParams({ data: "plain string" })
+ * // Returns: { data: "plain string" }
+ * ```
+ */
+export declare const buildBodyParams: (params?: Record<string, unknown>) => Record<string, unknown>;

package/dist/src/utils/role.util.d.ts

@@ -28,5 +28,23 @@ declare const hasAnyMonitoringReportRole: () => boolean;
 declare const hasStaffRole: (name: TransactionAttribute) => boolean;
 declare const hasMonitoringReportRole: (name: TransactionAttribute) => boolean;
 declare const hasApprovalRole: (name: TransactionAttribute) => boolean;
+/**
+ * Vue Router navigation guard that checks user access based on the route's metadata
+ * and the user's type retrieved from local storage.
+ *
+ * Access is granted if:
+ * 1. The user is currently logging out (flag checked by `checkLogoutFlag`).
+ * 2. The route's `meta.hasAccess` is true AND the user is an 'Admin'.
+ * 3. The route's `meta.hasAccess` is true AND the route is a special exemption path
+ * ('handover-confirmation' or 'my-profile').
+ *
+ * If access is denied, navigation is redirected to '/not-found'.
+ *
+ * @param {RouteLocationNormalized} to - The target route location object.
+ * @param {RouteLocationNormalized} from - The current route location object.
+ * @param {NavigationGuardNext} next - The function to call to resolve the hook.
+ * @returns {void}
+ */
 declare const checkRouteAccess: (to: RouteLocationNormalized, from: RouteLocationNormalized, next: NavigationGuardNext) => void;
-export { getTransactionRole, getSystemRole, hasTransactionRole, hasApprovalRole, hasSystemRole, checkRouteAccess, hasManagerRole, hasAnyManagerRole, hasMonitoringReportRole, hasAnyMonitoringReportRole, hasStaffRole, };
+declare const hasAccessToAssetDetail: () => boolean;
+export { getTransactionRole, getSystemRole, hasTransactionRole, hasApprovalRole, hasSystemRole, checkRouteAccess, hasManagerRole, hasAnyManagerRole, hasMonitoringReportRole, hasAnyMonitoringReportRole, hasStaffRole, hasAccessToAssetDetail, };

package/dist/src/utils/textFormater.util.d.ts

@@ -1,4 +1,7 @@
+import { Asset } from '../types/assets.type';
 export declare const formatVowelSoundLabel: (label?: string) => string;
 export declare const formatUserName: (name?: string) => string;
 export declare const formatTagCode: (tagCode?: string) => string;
+export declare const formatDisplayAssetName: (asset: Asset) => string;
+export declare const formatDisplayAssetId: (asset: Asset) => string;
 export default formatUserName;