@h3ravel/support 0.12.0 → 0.13.0

package/dist/index.js

@@ -3,14 +3,14 @@ import { createHash, createHmac, randomBytes, randomUUID } from "crypto";
 import process from "process";
 import util from "util";
 import dayjs from "dayjs";
-import advancedFormat from "dayjs/plugin/advancedFormat";
-import customParseFormat from "dayjs/plugin/customParseFormat";
-import dayOfYear from "dayjs/plugin/dayOfYear";
-import isBetween from "dayjs/plugin/isBetween";
-import isLeapYear from "dayjs/plugin/isLeapYear";
-import relativeTime from "dayjs/plugin/relativeTime";
-import timezone from "dayjs/plugin/timezone";
-import utc from "dayjs/plugin/utc";
+import advancedFormat from "dayjs/plugin/advancedFormat.js";
+import customParseFormat from "dayjs/plugin/customParseFormat.js";
+import dayOfYear from "dayjs/plugin/dayOfYear.js";
+import isBetween from "dayjs/plugin/isBetween.js";
+import isLeapYear from "dayjs/plugin/isLeapYear.js";
+import relativeTime from "dayjs/plugin/relativeTime.js";
+import timezone from "dayjs/plugin/timezone.js";
+import utc from "dayjs/plugin/utc.js";
 
 //#region src/Helpers/Arr.ts
 var Arr_exports = /* @__PURE__ */ __export({
@@ -30,7 +30,8 @@ var Arr_exports = /* @__PURE__ */ __export({
 	range: () => range,
 	reverse: () => reverse,
 	shift: () => shift,
-	take: () => take
+	take: () => take,
+	wrap: () => wrap
 });
 /**
 * Splits an array into chunks of a specified size.
@@ -128,6 +129,16 @@ const flatten = (arr) => {
 	recurse(arr);
 	return result;
 };
+/**
+* If the given value is not an array and not null, wrap it in one.
+*
+* @param  {Array}  value
+* @return array
+*/
+const wrap = (value) => {
+	if (value === null) return [];
+	return Array.isArray(value) ? value : [value];
+};
 
 //#endregion
 //#region src/Helpers/Crypto.ts
@@ -667,6 +678,164 @@ const slugifyKeys = (obj, only = [], separator = "_") => {
 	return Object.fromEntries(entries.map(([key, value]) => [slugify(key), value]));
 };
 
+//#endregion
+//#region src/Helpers/Time.ts
+dayjs.extend(utc);
+dayjs.extend(timezone);
+dayjs.extend(dayOfYear);
+dayjs.extend(isBetween);
+dayjs.extend(isLeapYear);
+dayjs.extend(relativeTime);
+dayjs.extend(advancedFormat);
+dayjs.extend(customParseFormat);
+const phpToDayjsTokens = (format$1) => format$1.replace(/Y/g, "YYYY").replace(/m/g, "MM").replace(/d/g, "DD").replace(/H/g, "HH").replace(/i/g, "mm").replace(/s/g, "ss");
+function format(date, fmt) {
+	return dayjs(date).format(phpToDayjsTokens(fmt));
+}
+const TimeClass = class {};
+var DateTime = class DateTime extends TimeClass {
+	instance;
+	constructor(config) {
+		super(config);
+		this.instance = dayjs(config);
+		return new Proxy(this, { get: (target, prop, receiver) => {
+			if (prop in target) return Reflect.get(target, prop, receiver);
+			const value = Reflect.get(this.instance, prop, receiver);
+			if (typeof value === "function") return (...args) => {
+				const result = value.apply(this.instance, args);
+				return dayjs.isDayjs(result) ? new DateTime(result) : result;
+			};
+			return value;
+		} });
+	}
+	/**
+	* Start time of a specific unit.
+	* 
+	* @returns 
+	*/
+	start(unit = "days") {
+		return this.startOf(unit);
+	}
+	/**
+	* End time of a specific unit.
+	* 
+	* @returns 
+	*/
+	end(unit = "days") {
+		return this.endOf(unit);
+	}
+	/**
+	* Get the first day of the month of the given date
+	* 
+	* @returns 
+	*/
+	firstDayOfMonth() {
+		return new DateTime(new Date(Date.UTC(this.year(), this.month(), 1)));
+	}
+	carbonFormat(template) {
+		return template ? this.format(phpToDayjsTokens(template)) : this.format();
+	}
+	/**
+	* Get the last day of the month of the given date
+	* 
+	* @returns 
+	*/
+	lastDayOfMonth() {
+		return new DateTime(new Date(Date.UTC(this.year(), this.month() + 1, 0)));
+	}
+	/**
+	* Get a random time between the specified hour and minute.
+	* 
+	* @param startHour 
+	* @param startMinute 
+	* @param endHour 
+	* @param endMinute 
+	* @returns 
+	*/
+	randomTime(startHour = 9, startMinute = 0, endHour = 17, endMinute = 0) {
+		const today = /* @__PURE__ */ new Date();
+		const startMinutes = startHour * 60 + startMinute;
+		const endMinutes = endHour * 60 + endMinute;
+		const randomMinutes = Math.floor(Math.random() * (endMinutes - startMinutes)) + startMinutes;
+		const hour = Math.floor(randomMinutes / 60);
+		const minute = randomMinutes % 60;
+		const date = new Date(today);
+		date.setHours(hour, minute, 0, 0);
+		return new DateTime(date);
+	}
+	/**
+	* Create a date for a given timestamp.
+	*
+	* @param timestamp - Unix timestamp
+	* 
+	* @return {Date} object
+	*/
+	static fromTimestamp(timestamp) {
+		return /* @__PURE__ */ new Date(timestamp * 1e3);
+	}
+	/**
+	* Get current time instance.
+	*
+	* @returns Current time
+	*/
+	static now() {
+		return new DateTime();
+	}
+	/**
+	* Parse the time
+	* 
+	* @param date 
+	* @returns 
+	*/
+	static parse(date) {
+		return new DateTime(date);
+	}
+	/**
+	* Get the formatted date according to the string of tokens passed in.
+	* 
+	* To escape characters, wrap them in square brackets (e.g. [MM]).
+	*
+	* @param time - current time
+	* @param template - time format
+	*/
+	static format(time, template) {
+		return new DateTime(time).format(template);
+	}
+	/**
+	* Get the difference in days from today.
+	*
+	* @param time 
+	* @param startHour 
+	* @param startMinute 
+	* @param endHour 
+	* @param endMinute 
+	* @returns 
+	*/
+	static randomTime(time, startHour, startMinute, endHour, endMinute) {
+		return new DateTime(time).randomTime(startHour, startMinute, endHour, endMinute);
+	}
+	/**
+	* Get the first day of the month of the given date
+	* 
+	* @param time 
+	* 
+	* @returns 
+	*/
+	static firstDayOfMonth(time) {
+		return new DateTime(time).firstDayOfMonth();
+	}
+	/**
+	* Get the last day of the month of the given date
+	* 
+	* @param time 
+	* 
+	* @returns 
+	*/
+	static lastDayOfMonth(time) {
+		return new DateTime(time).lastDayOfMonth();
+	}
+};
+
 //#endregion
 //#region src/Helpers/Str.ts
 let Mode = /* @__PURE__ */ function(Mode$1) {
@@ -5006,164 +5175,6 @@ function matchCase(value, comparison) {
 	return value;
 }
 
-//#endregion
-//#region src/Helpers/Time.ts
-dayjs.extend(utc);
-dayjs.extend(timezone);
-dayjs.extend(dayOfYear);
-dayjs.extend(isBetween);
-dayjs.extend(isLeapYear);
-dayjs.extend(relativeTime);
-dayjs.extend(advancedFormat);
-dayjs.extend(customParseFormat);
-const phpToDayjsTokens = (format$1) => format$1.replace(/Y/g, "YYYY").replace(/m/g, "MM").replace(/d/g, "DD").replace(/H/g, "HH").replace(/i/g, "mm").replace(/s/g, "ss");
-function format(date, fmt) {
-	return dayjs(date).format(phpToDayjsTokens(fmt));
-}
-const TimeClass = class {};
-var Time = class Time extends TimeClass {
-	instance;
-	constructor(config) {
-		super(config);
-		this.instance = dayjs(config);
-		return new Proxy(this, { get: (target, prop, receiver) => {
-			if (prop in target) return Reflect.get(target, prop, receiver);
-			const value = Reflect.get(this.instance, prop, receiver);
-			if (typeof value === "function") return (...args) => {
-				const result = value.apply(this.instance, args);
-				return dayjs.isDayjs(result) ? new Time(result) : result;
-			};
-			return value;
-		} });
-	}
-	/**
-	* Start time of a specific unit.
-	* 
-	* @returns 
-	*/
-	start(unit = "days") {
-		return this.startOf(unit);
-	}
-	/**
-	* End time of a specific unit.
-	* 
-	* @returns 
-	*/
-	end(unit = "days") {
-		return this.endOf(unit);
-	}
-	/**
-	* Get the first day of the month of the given date
-	* 
-	* @returns 
-	*/
-	firstDayOfMonth() {
-		return new Time(new Date(Date.UTC(this.year(), this.month(), 1)));
-	}
-	carbonFormat(template) {
-		return template ? this.format(phpToDayjsTokens(template)) : this.format();
-	}
-	/**
-	* Get the last day of the month of the given date
-	* 
-	* @returns 
-	*/
-	lastDayOfMonth() {
-		return new Time(new Date(Date.UTC(this.year(), this.month() + 1, 0)));
-	}
-	/**
-	* Get a random time between the specified hour and minute.
-	* 
-	* @param startHour 
-	* @param startMinute 
-	* @param endHour 
-	* @param endMinute 
-	* @returns 
-	*/
-	randomTime(startHour = 9, startMinute = 0, endHour = 17, endMinute = 0) {
-		const today = /* @__PURE__ */ new Date();
-		const startMinutes = startHour * 60 + startMinute;
-		const endMinutes = endHour * 60 + endMinute;
-		const randomMinutes = Math.floor(Math.random() * (endMinutes - startMinutes)) + startMinutes;
-		const hour = Math.floor(randomMinutes / 60);
-		const minute = randomMinutes % 60;
-		const date = new Date(today);
-		date.setHours(hour, minute, 0, 0);
-		return new Time(date);
-	}
-	/**
-	* Create a date for a given timestamp.
-	*
-	* @param timestamp - Unix timestamp
-	* 
-	* @return {Date} object
-	*/
-	static fromTimestamp(timestamp) {
-		return /* @__PURE__ */ new Date(timestamp * 1e3);
-	}
-	/**
-	* Get current time instance.
-	*
-	* @returns Current time
-	*/
-	static now() {
-		return new Time();
-	}
-	/**
-	* Parse the time
-	* 
-	* @param date 
-	* @returns 
-	*/
-	static parse(date) {
-		return new Time(date);
-	}
-	/**
-	* Get the formatted date according to the string of tokens passed in.
-	* 
-	* To escape characters, wrap them in square brackets (e.g. [MM]).
-	*
-	* @param time - current time
-	* @param template - time format
-	*/
-	static format(time, template) {
-		return new Time(time).format(template);
-	}
-	/**
-	* Get the difference in days from today.
-	*
-	* @param time 
-	* @param startHour 
-	* @param startMinute 
-	* @param endHour 
-	* @param endMinute 
-	* @returns 
-	*/
-	static randomTime(time, startHour, startMinute, endHour, endMinute) {
-		return new Time(time).randomTime(startHour, startMinute, endHour, endMinute);
-	}
-	/**
-	* Get the first day of the month of the given date
-	* 
-	* @param time 
-	* 
-	* @returns 
-	*/
-	static firstDayOfMonth(time) {
-		return new Time(time).firstDayOfMonth();
-	}
-	/**
-	* Get the last day of the month of the given date
-	* 
-	* @param time 
-	* 
-	* @returns 
-	*/
-	static lastDayOfMonth(time) {
-		return new Time(time).lastDayOfMonth();
-	}
-};
-
 //#endregion
 //#region src/GlobalBootstrap.ts
 /**
@@ -5195,7 +5206,7 @@ function loadHelpers(target = globalThis) {
 		Number: Number_exports,
 		Obj: Obj_exports,
 		Str,
-		Time,
+		DateTime,
 		DumpDie: DumpDie_exports,
 		apa: Str.apa,
 		title: Str.title,
@@ -5241,13 +5252,13 @@ function loadHelpers(target = globalThis) {
 		checksum,
 		verifyChecksum,
 		caesarCipher,
-		now: Time.now,
-		format: Time.format,
-		fromTimestamp: Time.fromTimestamp,
-		parse: Time.parse,
-		randomTime: Time.randomTime,
-		firstDayOfMonth: Time.firstDayOfMonth,
-		lastDayOfMonth: Time.lastDayOfMonth,
+		now: DateTime.now,
+		format: DateTime.format,
+		fromTimestamp: DateTime.fromTimestamp,
+		parse: DateTime.parse,
+		randomTime: DateTime.randomTime,
+		firstDayOfMonth: DateTime.firstDayOfMonth,
+		lastDayOfMonth: DateTime.lastDayOfMonth,
 		abbreviate,
 		humanize,
 		toBytes,
@@ -5345,5 +5356,5 @@ function cleanHelpers(target = globalThis) {
 }
 
 //#endregion
-export { Arr_exports as Arr, Crypto_exports as Crypto, DumpDie_exports as DumpDie, HtmlString, Mode, Number_exports as Number, Obj_exports as Obj, Str, Stringable, Time, abbreviate, alternate, base64Decode, base64Encode, caesarCipher, checksum, chunk, cleanHelpers, collapse, combine, dd, dot, dump, extractProperties, find, first, flatten, forget, format, getValue, hash, hmac, humanize, isEmpty, isNotEmpty, last, loadHelpers, modObj, pop, prepend, random, randomColor, randomPassword, randomSecure, range, reverse, safeDot, secureToken, setNested, shift, slugifyKeys, str, take, toBytes, toHumanTime, uuid, verifyChecksum, xor };
+export { Arr_exports as Arr, Crypto_exports as Crypto, DateTime, DumpDie_exports as DumpDie, HtmlString, Mode, Number_exports as Number, Obj_exports as Obj, Str, Stringable, abbreviate, alternate, base64Decode, base64Encode, caesarCipher, checksum, chunk, cleanHelpers, collapse, combine, dd, dot, dump, extractProperties, find, first, flatten, forget, format, getValue, hash, hmac, humanize, isEmpty, isNotEmpty, last, loadHelpers, modObj, pop, prepend, random, randomColor, randomPassword, randomSecure, range, reverse, safeDot, secureToken, setNested, shift, slugifyKeys, str, take, toBytes, toHumanTime, uuid, verifyChecksum, wrap, xor };
 //# sourceMappingURL=index.js.map