nmce-func 0.0.4 → 0.0.8

package/src/_func/dateFunc.ts

@@ -1,385 +0,0 @@
-import moment from 'moment';
-
-export class DateFunc {
-
-	/**
-	 * Transform UTC DateTime to local date without H, M and S. For example, the month day of 2018-01-23T22:00:00Z is 24 in Australia.
-	 * @param dtUtc
-	 * @param offsetMinutes if not defined, it will be new Date().getTimezoneOffset(). //https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/getTimezoneOffset
-	 */
-	static dateTimeUtcToLocalDateNumber(dtUtc: Date): number {
-		if (!dtUtc) {
-			return 0; //0 is better for calculation by the clients.
-		}
-
-		const localDt = DateFunc.dateTimeUtcToLocalDateTime(dtUtc);
-		const localDNum = localDt.setHours(0, 0, 0, 0);
-
-		return localDNum;
-	}
-
-	/**
-	 * Date only. However, the date may still be in UTC.
-	 * @param dtUtc
-	 */
-	static dateTimeUtcToLocalDate(dtUtc: Date): Date {
-		if (!dtUtc) {
-			return dtUtc;
-		}
-
-		const localDt = DateFunc.dateTimeUtcToLocalDateTime(dtUtc);
-		const localD = localDt.setHours(0, 0, 0, 0);
-		return new Date(localD);
-	}
-
-	static localISODateString(dtUtc: Date): string {
-		const dt = moment(dtUtc).local();
-		return dt.format('YYYY-MM-DD');
-	}
-
-	/**
-	 * locate date ONLY (no time) to UTC date.
-	 * @param dt if dt contain time info, it will become dt.setHours(0, 0, 0, 0)
-	 */
-	static localDateToUtc(d: Date | number | string): Date | undefined {
-		if (!d) {
-			return undefined;
-		}
-
-		const dt = moment(d).toDate();
-		const n = dt.setHours(0, 0, 0, 0);
-		const offset = dt.getTimezoneOffset() * 60000;
-		return new Date(n + offset);
-	}
-
-	static getTimezoneOffset(): number {
-		const dt = this.today;
-		return dt.getTimezoneOffset();
-	}
-
-	/**
-	 * Transform UTC DateTime to local dateTime.
-	 * @param dtUtc
-	 * @param offsetMinutes if not defined, it will be new Date().getTimezoneOffset(). //https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/getTimezoneOffset
-	 */
-	static dateTimeUtcToLocalDateTime(dtUtc: Date): Date {
-		if (!dtUtc) {
-			return dtUtc;
-		}
-
-		const stillUtc = moment.utc(dtUtc).toDate();
-		return moment(stillUtc).local().toDate();
-	}
-
-	static dateTimeUtcToLocaMoment(dtUtc: Date): moment.Moment {
-		if (!dtUtc) {
-			return dtUtc;
-		}
-
-		const stillUtc = moment.utc(dtUtc);
-		return stillUtc.local();
-	}
-
-	static getEndOfWeek(dt: Date | number) {
-		//  return new Date(dt.getFullYear(), dt.getMonth(), dt.getDate() + 6 - dt.getDay(), 23, 59, 59, 999);
-		return moment(dt).endOf('isoWeek').toDate();
-	}
-
-	static getStartOfWeek(dt: Date | number) {
-		return moment(dt).startOf('isoWeek').toDate();
-	}
-
-	static getEndOfMonth(dt: Date | number) {
-		//  return new Date(dt.getFullYear(), dt.getMonth() + 1, 0, 23, 59, 59, 999);
-		return moment(dt).endOf('month').toDate();
-	}
-
-	static getStartOfMonth(dt: Date | number) {
-		return moment(dt).startOf('month').toDate();
-	}
-
-	static getDaysBetweenDates(dt1: Date, dt2: Date) {
-		//const timeDiff = Math.abs(dt2.getTime() - dt1.getTime());
-		//return Math.trunc(timeDiff / (1000 * 3600 * 24));
-		return this.getDaysBetween(dt1, dt2);
-	}
-
-	static getEndOfDate(dt: Date): Date {
-		return new Date(dt.setHours(23, 59, 59, 999));
-	}
-
-	static getStartOfDate(dt: Date): Date {
-		return moment(dt).startOf('day').toDate();
-	}
-
-	static getEndOfToday(): Date {
-		//	return new Date((new Date(Date.now())).setHours(23, 59, 59, 999));
-		return moment(Date.now()).endOf('day').toDate();
-
-	}
-
-	static getStartOfToday(): Date {
-		//	return new Date((new Date(Date.now())).setHours(0, 0, 0, 0));
-		return moment(Date.now()).startOf('day').toDate();
-	}
-
-	//inspired https://stackoverflow.com/questions/563406/add-days-to-javascript-date
-	static addDays(dt: Date, days: number) {
-		const dat = moment(dt);
-		dat.add(days, 'days');
-		return dat.toDate();
-	}
-
-	static subtractDays(dt: Date, days: number) {
-		const dat = moment(dt);
-		dat.subtract(days, 'days');
-		return dat.toDate();
-	}
-
-	/**
-	 * Start of today
-	 */
-	static get today(): Date {
-		return this.getStartOfToday();
-	}
-
-	static get now(): Date {
-		return new Date(Date.now());
-	}
-
-	static getNext5MinuteMark(): Date {
-		const m = moment().set('second', 0).set('millisecond', 0);
-		const minute = m.minute();
-		const mod = minute % 5;
-		if (mod) {
-			const delta = 5 - mod;
-			return m.add(delta, 'm').toDate();
-		}
-
-		return m.toDate();
-	}
-
-	static getYMD(d: Date) {
-		return moment(d).format('YYYYMMDD');
-	}
-
-	static getDMYWithSlash(d: Date) {
-		return moment(d).format('DD/MM/YYYY');
-	}
-
-	static getDMYHmWithSlash(d: Date) {
-		return moment(d).format('DD/MM/YYYY HH:mm');
-	}
-
-	static getMcpTime(dt: Date) {
-		return moment(dt).format('HH:mm:ss.SSSZ');
-	}
-
-	/**
-	 * In 24 hour format
-	 * @param dtUtc
-	 */
-	static getLocalDMYHmWithSlash(dtUtc: Date) {
-		const d = DateFunc.dateTimeUtcToLocalDateTime(dtUtc);
-		return moment(d).format('DD/MM/YYYY HH:mm');
-	}
-
-	/**
-	 * Offset minutes comparing with today
-	 */
-	static getOffsetMinutes(dtUtc: Date | number): number {
-		const dm1 = moment(dtUtc);
-		const dm2 = moment(new Date().setHours(0, 0, 0, 0));
-		return dm1.diff(dm2, 'minutes');
-	}
-
-	static getDaysBetween(d1: Date | number, d2: Date | number): number {
-		const dm1 = moment(d1);
-		const dm2 = moment(d2);
-		return dm2.diff(dm1, 'days');
-	}
-
-	/**
-	 * Get hour of the date. If Date is not defined, the hour will be current hour.
-	 * @param dtUtc
-	 */
-	static getHour(dtUtc: Date | number): number {
-		const m = moment(dtUtc);
-		return m.hours();
-	}
-
-	static getMinute(dtUtc: Date | number): number {
-		const m = moment(dtUtc);
-		return m.minutes();
-	}
-
-	static composeDateTime(dt: Date, h: number, minute?: number): Date {
-		if (!dt) {
-			return dt;
-		}
-
-		const mt = moment(dt);
-		return new Date(mt.toDate().setHours(h, minute, 0, 0));
-	}
-
-	static olderThan24Hours(d: Date): boolean {
-		const m = moment(d);
-		return moment().diff(m, 'hours') >= 24;
-	}
-
-	static olderThan24HoursUtc(dtUtc: Date): boolean {
-		return DateFunc.getHourAgeUtc(dtUtc) >= 24;
-	}
-
-	static olderThanHours(d: Date, hours: number) {
-		const m = moment(d);
-		return moment().diff(m, 'hours') >= hours;
-	}
-
-	static olderThanHoursUtc(dtUtc: Date, hours: number): boolean {
-		return DateFunc.getHourAgeUtc(dtUtc) >= hours;
-	}
-
-	static olderThanMinutes(d: Date, minutes: number) {
-		const m = moment(d);
-		return moment().diff(m, 'minutes') >= minutes;
-	}
-
-	/**
-	 * It could be 11PM yesterday, and 1 AM today. Actually based on local today.
-	 */
-	static olderThan1Day(dtUtc: Date): boolean {
-		return DateFunc.getDayAgeUtc(dtUtc) > 0;
-	}
-
-	static getHourAge(d: Date) {
-		const m = moment(d);
-		return moment().diff(m, 'hours');
-	}
-
-	static getHourAgeUtc(dtUtc: Date) {
-		const m = moment.utc(dtUtc);
-		return moment.utc().diff(m, 'hours');
-	}
-
-	/**
-	 * Compare utc date with utc now.
-	 * @param dtUtc
-	 */
-	static getDayAgeUtc(dtUtc: Date) {
-		const m = moment.utc(dtUtc);
-		return moment.utc().diff(m, 'days');
-	}
-
-	static getAge(d: Date) {
-		const m = moment(d);
-		return moment().diff(m, 'years');
-	}
-
-	static getYear(d: Date) {
-		const m = moment(d);
-		return m.year();
-	}
-
-	static getUtcNow(): Date {
-		return moment.utc().toDate();
-	}
-
-	static addMinutes(d: Date, m: number): Date {
-		return moment(d).add(m, 'm').toDate();
-	}
-
-	static addMonth(d: Date, m: number): Date {
-		return moment(d).add(m, 'M').toDate();
-	}
-
-	static getDuration(d1: Date, d2: Date) {
-		const md1 = moment(d1);
-		const md2 = moment(d2);
-		return moment.duration(md2.diff(md1));
-	}
-
-	/**
-	 * Convert minutes from midnight to HH:mm text
-	 * @param mins
-	 */
-	static getHMFromMins(mins: number): string {
-		// do not include the first validation check if you want, for example,
-		// getTimeFromMins(1530) to equal getTimeFromMins(90) (i.e. mins rollover)
-		if (mins >= 24 * 60 || mins < 0) {
-			throw new RangeError('Valid input should be greater than or equal to 0 and less than 1440.');
-		}
-		const h = mins / 60 | 0,
-			m = mins % 60 | 0;
-		return moment.utc().hours(h).minutes(m).format('HH:mm');
-	}
-
-	static getMinutesSinceMidnight(d: Date) {
-		const m = moment(d);
-		const midnight = moment(d).startOf('day'); //Mutates the original moment by setting it to the start of a unit of time. So I have better not to use m which wil be changed by calling this function
-		return m.diff(midnight, 'minutes');
-	}
-
-	static getMinutesBetween(start: Date, end: Date) {
-		const m = moment(start);
-		const m2 = moment(end);
-		return m2.diff(m, 'minutes');
-	}
-
-	/**
-	 * Parse json string with date serialized into string, and get proper date object back
-	 * @param s
-	 */
-	static dateSafeJsonParse(s: string) {
-		return JSON.parse(s, this.dateReviver);
-	}
-
-	private static dateReviver(key: string, value: any) {
-		if (DateFunc.isSerializedDate(value)) {
-			return (new Date(value));
-		}
-
-		// If it's not a date-string, we want to return the value as-is. If we fail to return
-		// a value, it will be omitted from the resultant data structure.
-		return (value);
-
-	}
-
-
-	// I determine if the given value is a string that matches the serialized-date pattern.
-	private static isSerializedDate(value: any): boolean {
-		// Dates are serialized in TZ format, example: '1981-12-20T04:00:14.000Z'.
-		const datePattern = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/;
-		return (DateFunc.isString(value) && datePattern.test(value));
-	}
-
-
-	// I determine if the given value is a String.
-	private static isString(value: any): boolean {
-		return ({}.toString.call(value) === '[object String]');
-	}
-
-	static dateSafeParse(s: string | Date) {
-		const m = moment(s);
-		return m.toDate();
-	}
-
-	static composeDateWithMinutes(d: Date, minute: number): Date {
-		const m = moment(d);
-		const midnight = moment(d).startOf('day'); // Mutates the original moment by setting it to the start of a unit of time. So I have better not to use m which wil be changed by calling this function
-		midnight.add(minute, 'minutes');
-		return midnight.toDate();
-	}
-
-	/**
-	 * Safe compare since date data may be considered as string rather than date.
-	 * @param d1
-	 * @param d2
-	 */
-	static compare(d1: Date, d2: Date): number {
-		const dd1 = (new Date(d1)).valueOf();
-		const dd2 = (new Date(d2)).valueOf();
-		return dd1 - dd2;
-	}
-}
-

package/src/_func/helperFunc.ts

@@ -1,27 +0,0 @@
-import { v4 as uuid } from 'uuid'; //todo: somehow  the system could not recognize v5.
-// import { v5 as uuid } from 'uuid/v5 causes ERROR in src / app / _func / helperFunc.ts(1, 10): error TS2305: Module '"C:/VSProjects/ApsCloudTrunk/APS.WebPos.NGCli/NGSource/node_modules/@types/uuid/v5"' has no exported member 'v5'
-// https://github.com/DefinitelyTyped/DefinitelyTyped/pull/28439
-
-export class HelperFunc {
-	static loadExternalScript(scriptUrl: string) {
-		return new Promise((resolve, reject) => {
-			const scriptElement = document.createElement('script');
-			scriptElement.src = scriptUrl;
-			scriptElement.onload = resolve;
-			document.body.appendChild(scriptElement);
-		});
-	}
-
-	/**
-	 * 36 UUID string including 4 hyphens. MySql stores GUID as 36 bytes anyway rather than 16bytes.
-	 */
-	static newUUID(): string {
-//		return uuid('medilink.com.au', 'apscloud');
-		return uuid();
-	}
-
-	static newUUIDStartWith0() {
-		const s = uuid();
-		return '0000' + s.slice(4);
-	}
-}

package/src/_func/htmlFunc.ts

@@ -1,46 +0,0 @@
-export class HtmlFunc {
-	/**
-	 * Print with buillt-in CSS for internal reports
-	 * @param htmlTags
-	 * @param baseRef
-	 */
-	static printWithCSS(htmlTags: string, baseRef: string) {
-		if (window) {
-			const htmlToPrint = `<html><head>
-<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"/>
-<link rel="stylesheet" type="text/css" href="${baseRef}scripts/print190826.css" media="screen,print"/>
-</head><body onload="window.print()">${htmlTags}</body></html>`;
-
-			const popup = window.open('', '_blank', 'width=1024,height=768');
-			popup?.document.open();
-			popup?.document.write(htmlToPrint);
-
-			popup?.document.close();
-		}
-		return true;
-	}
-
-	/**
-	 * Print for external documents.
-	 * @param htmlTags
-	 */
-	static print(htmlTags: string) {
-		if (window) {
-			const htmlToPrint = `<html><head>
-<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"/>
-</head><body onload="window.print()">${htmlTags}</body></html>`;
-
-			const popup = window.open('', '_blank', 'width=1024,height=768');
-			popup?.document.open();
-			popup?.document.write(htmlToPrint);
-
-			popup?.document.close();
-		}
-		return true;
-	}
-
-	static printImage(url: string) {
-		const imageTags = `<img src="${url}" alt="Image from URL"/>`;
-		HtmlFunc.print(imageTags);
-	}
-}

package/src/_func/index.ts

@@ -1,9 +0,0 @@
-export * from './addressFunc';
-export * from './authentication.service';
-export * from './currencyFunc';
-export * from './dateFunc';
-export * from './helperFunc';
-export * from './htmlFunc';
-export * from './jsFunc';
-export * from './stringFunc';
-

package/src/_func/jsFunc.ts

@@ -1,48 +0,0 @@
-import { DateFunc} from './dateFunc';
-
-export class JSFunc {
-	static groupBy<T>(array: Array<T>, propertyName: string) {
-		return array.reduce(function(acc: any, obj: any) {
-			const key = obj[propertyName];
-			if (!acc[key]) {
-				acc[key] = [];
-			}
-			acc[key].push(obj);
-			return acc;
-		}, {});
-	}
-
-	/**
-	 * Group by a date property. The key is always of string type and representing milliseconds. The client should convert the string to number.
-	 * Angular date pipe could actually consume such string without explicitly converting to number.
-	 * @param array
-	 * @param propertyName
-	 */
-	static groupByDate<T>(array: Array<T>, propertyName: string) {
-		return array.reduce(function(acc: any, obj: any) {
-			const key = DateFunc.dateTimeUtcToLocalDateNumber(obj[propertyName]);
-			if (!acc[key]) {
-				acc[key] = [];
-			}
-			acc[key].push(obj);
-			return acc;
-		}, {});
-	}
-
-	static removeNullOrEmptyFields(obj: any) {
-		for (const f in obj) {
-			if (obj[f] === null || obj[f]==='') {
-				delete obj[f];
-			}
-		}
-	}
-
-	static removeNullFields(obj: any) {
-		for (const f in obj) {
-			if (obj[f] === null) {
-				delete obj[f];
-			}
-		}
-	}
-
-}

package/src/_func/stringFunc.spec.ts

@@ -1,142 +0,0 @@
-import { StringFunc } from './stringFunc';
-
-class MyStatus {
-	static description = '12AB';
-	static integer = 8;
-	static something: string; //without instance, this does not count
-	static something2: string=undefined!; //this count
-
-	private static _currentCalendarView = '';
-	static get currentCalendarView(): string {
-		const v = MyStatus._currentCalendarView;
-		return v ? v : 'month';
-	}
-	static set currentCalendarView(v: string) {
-		MyStatus._currentCalendarView = v;
-	}
-
-	static clear() {
-		for (const key in MyStatus) {
-			const p =key as keyof MyStatus;
- {/* 
-  // @ts-ignore */}
-   			MyStatus[p] = undefined;
-		}
-	}
-}
-
-describe('1st tests', () => {
-	it('true is true', () => expect(true).toBe(true));
-
-	it('static variable', () => {
-		const staticKeys = Object.keys(MyStatus);
-		expect(staticKeys.length).toEqual(4); // something is not counted.
-		const p = staticKeys[0] as keyof MyStatus;
-		expect(MyStatus[p]).toEqual('12AB');
-		expect(MyStatus.something).toBeUndefined();
-	});
-
-	it('static variable clear', () => {
-		const staticKeys = Object.keys(MyStatus);
-		MyStatus.currentCalendarView = 'kkkkk';
-
-		MyStatus.clear();
-
-		expect(MyStatus.description).toBeUndefined();
-		expect(staticKeys.length).toEqual(4); // something is not counted
-		const p = staticKeys[0] as keyof MyStatus;
-		expect(MyStatus[p]).toBeUndefined();
-		expect(MyStatus.currentCalendarView).toEqual('month');
-
-		MyStatus.description = '12AB'; // sometimes this test runs first, causing the first test failed.
-	})
-});
-
-describe('stringFunc', () => {
-	it('getAbbr', () => {
-		expect(StringFunc.getAbbr('John Smith')).toEqual('JS');
-		expect(StringFunc.getAbbr('Huang, Zijian')).toEqual('ZH');
-		expect(StringFunc.getAbbr('')).toEqual('');
-		expect(StringFunc.getAbbr('John')).toEqual('J');
-	});
-
-	it('getOneLineDigest', () => {
-		expect(StringFunc.getOneLineDigest('', 32)).toEqual('');
-		expect(StringFunc.getOneLineDigest(undefined, 32)).toBe('');
-		expect(StringFunc.getOneLineDigest(null, 32)).toBe('');
-		expect(StringFunc.getOneLineDigest('Abcd efg', 32)).toEqual('Abcd efg');
-		expect(StringFunc.getOneLineDigest('Abcd\nefg', 32)).toEqual('Abcd efg');
-		expect(StringFunc.getOneLineDigest('123456789 123456789 123456789 123456789 ', 32)).toEqual('123456789 123456789 123456789 12...');
-		expect(StringFunc.getOneLineDigest('123456789\n123456789\n123456789\n123456789 ', 32)).toEqual('123456789 123456789 123456789 12...');
-	});
-
-	it('capitalize', () => {
-		expect(StringFunc.capitalizeWords('some thing')).toBe('Some Thing');
-		expect(StringFunc.capitalizeWords('3ome thing')).toBe('3ome Thing');
-		expect(StringFunc.capitalizeWords('località àtilacol')).toBe('Località Àtilacol');
-		expect(StringFunc.capitalizeWords('中文 好')).toBe('中文 好');
-		expect(StringFunc.capitalizeWords('')).toBe('');
-		expect(StringFunc.capitalizeWords(undefined)).toBeUndefined();
-		expect(StringFunc.capitalizeWords(null)).toBeNull();
-	});
-
-	it('validateMedicare', () => {
-		expect(StringFunc.validateMedicare('2950974202')).toBeNull();
-		expect(StringFunc.validateMedicare('3950386862')).toBeNull();
-		expect(StringFunc.validateMedicare('2950974392')).toBeNull();
-		expect(StringFunc.validateMedicare('3950386952')).toBeNull();
-
-		expect(StringFunc.validateMedicare('950386952')?.code).toBe(1);
-		expect(StringFunc.validateMedicare('33950386952')?.code).toBe(1);
-		expect(StringFunc.validateMedicare('aaaaaaaaaa')?.code).toBe(2);
-		expect(StringFunc.validateMedicare('3333333333')?.code).toBe(3);
-		expect(StringFunc.validateMedicare('3950386923')?.code).toBe(3);
-	});
-
-	it('validateProviderCode', () => {
-		expect(StringFunc.validateMedicareProviderNumber('2426591T')).toBeNull();
-		expect(StringFunc.validateMedicareProviderNumber('2426601H')).toBeNull();
-		expect(StringFunc.validateMedicareProviderNumber('2423391B')).toBeNull();
-		expect(StringFunc.validateMedicareProviderNumber('3323391B')?.code).toBe(2);
-		expect(StringFunc.validateMedicareProviderNumber('3391B')?.code).toBe(1);
-	});
-
-	it('validateTFN', () => {
-		expect(StringFunc.validateTFN('123456782')).toBeNull();
-		expect(StringFunc.validateTFN('123 456-782')).toBeNull();
-		expect(StringFunc.validateTFN('a3323391B')?.code).toBe(1);
-		expect(StringFunc.validateTFN('3391')?.code).toBe(2);
-		expect(StringFunc.validateTFN('123456783')?.code).toBe(3);
-	});
-
-	it('validateABN', () => {
-		expect(StringFunc.validateABN('51824753556')).toBeNull();
-		expect(StringFunc.validateABN('51 824 753 556')).toBeNull();
-		expect(StringFunc.validateABN('51-824 753 556')).toBeNull();
-		expect(StringFunc.validateABN('5182475355')?.code).toBe(1);
-		expect(StringFunc.validateABN('51824753557')?.code).toBe(2);
-	});
-
-	it('validateACN', () => {
-		expect(StringFunc.validateACN('003 249 992')).toBeNull();
-		expect(StringFunc.validateACN('005999977')).toBeNull();
-		expect(StringFunc.validateACN('010.499-966')).toBeNull();
-		expect(StringFunc.validateACN('00599997')?.code).toBe(1);
-		expect(StringFunc.validateACN('005999979')?.code).toBe(2);
-	});
-
-	it('validateDVAFileNumber', () => {
-		expect(StringFunc.validateDVAFileNumber('QX901533')).toBeNull();
-		expect(StringFunc.validateDVAFileNumber('W 1')).toBeNull();
-		expect(StringFunc.validateDVAFileNumber('SCGW1234')).toBeNull();
-		expect(StringFunc.validateDVAFileNumber('SCGW1234B')).toBeNull();
-		expect(StringFunc.validateDVAFileNumber('ZX901533')?.code).toBe(1);
-		expect(StringFunc.validateDVAFileNumber('QX90153C')).toBeNull();
-		expect(StringFunc.validateDVAFileNumber('NKKK1533')?.code).toBe(3);
-		expect(StringFunc.validateDVAFileNumber('WK153344')?.code).toBe(3);
-		expect(StringFunc.validateDVAFileNumber('TX1533444')?.code).toBe(4);
-		expect(StringFunc.validateDVAFileNumber('VXabcde')?.code).toBe(2);
-	});
-
-
-});