@h3ravel/support 0.16.1 → 0.17.0-alpha.1

package/dist/index.cjs

@@ -1,68 +1,11 @@
-//#region rolldown:runtime
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (all, symbols) => {
-	let target = {};
-	for (var name in all) {
-		__defProp(target, name, {
-			get: all[name],
-			enumerable: true
-		});
-	}
-	if (symbols) {
-		__defProp(target, Symbol.toStringTag, { value: "Module" });
-	}
-	return target;
-};
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") {
-		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-			key = keys[i];
-			if (!__hasOwnProp.call(to, key) && key !== except) {
-				__defProp(to, key, {
-					get: ((k) => from[k]).bind(null, key),
-					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-				});
-			}
-		}
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
-const require_RuntimeException = require('./RuntimeException-CmsL83ow.cjs');
+const require_Time = require('./Time-H1gLMvCJ.cjs');
+const require_RuntimeException = require('./RuntimeException-BlF2onMq.cjs');
 let __h3ravel_collect_js = require("@h3ravel/collect.js");
 let crypto$1 = require("crypto");
 let process = require("process");
-process = __toESM(process);
+process = require_Time.__toESM(process);
 let util = require("util");
-util = __toESM(util);
-let dayjs = require("dayjs");
-dayjs = __toESM(dayjs);
-let dayjs_plugin_advancedFormat_js = require("dayjs/plugin/advancedFormat.js");
-dayjs_plugin_advancedFormat_js = __toESM(dayjs_plugin_advancedFormat_js);
-let dayjs_plugin_customParseFormat_js = require("dayjs/plugin/customParseFormat.js");
-dayjs_plugin_customParseFormat_js = __toESM(dayjs_plugin_customParseFormat_js);
-let dayjs_plugin_dayOfYear_js = require("dayjs/plugin/dayOfYear.js");
-dayjs_plugin_dayOfYear_js = __toESM(dayjs_plugin_dayOfYear_js);
-let dayjs_plugin_isBetween_js = require("dayjs/plugin/isBetween.js");
-dayjs_plugin_isBetween_js = __toESM(dayjs_plugin_isBetween_js);
-let dayjs_plugin_isLeapYear_js = require("dayjs/plugin/isLeapYear.js");
-dayjs_plugin_isLeapYear_js = __toESM(dayjs_plugin_isLeapYear_js);
-let dayjs_plugin_relativeTime_js = require("dayjs/plugin/relativeTime.js");
-dayjs_plugin_relativeTime_js = __toESM(dayjs_plugin_relativeTime_js);
-let dayjs_plugin_timezone_js = require("dayjs/plugin/timezone.js");
-dayjs_plugin_timezone_js = __toESM(dayjs_plugin_timezone_js);
-let dayjs_plugin_utc_js = require("dayjs/plugin/utc.js");
-dayjs_plugin_utc_js = __toESM(dayjs_plugin_utc_js);
+util = require_Time.__toESM(util);
 let node_net = require("node:net");
 let __h3ravel_shared = require("@h3ravel/shared");
 let node_fs_promises = require("node:fs/promises");
@@ -110,7 +53,7 @@ var InvalidArgumentException = class extends Error {
 
 //#endregion
 //#region src/Helpers/Crypto.ts
-var Crypto_exports = /* @__PURE__ */ __export({
+var Crypto_exports = /* @__PURE__ */ require_Time.__export({
 	base64Decode: () => base64Decode,
 	base64Encode: () => base64Encode,
 	caesarCipher: () => caesarCipher,
@@ -283,7 +226,7 @@ const caesarCipher = (text, shift = 13) => {
 
 //#endregion
 //#region src/Helpers/DumpDie.ts
-var DumpDie_exports = /* @__PURE__ */ __export({
+var DumpDie_exports = /* @__PURE__ */ require_Time.__export({
 	dd: () => dd,
 	dump: () => dump
 });
@@ -318,7 +261,7 @@ const dump = (...args) => {
 
 //#endregion
 //#region src/Helpers/Number.ts
-var Number_exports = /* @__PURE__ */ __export({
+var Number_exports = /* @__PURE__ */ require_Time.__export({
 	abbreviate: () => abbreviate,
 	humanize: () => humanize,
 	toBytes: () => toBytes,
@@ -918,6 +861,24 @@ var Obj = class Obj {
 		});
 	}
 	/**
+	* Checks if an object is not empty
+	* 
+	* @param obj 
+	* @returns 
+	*/
+	static isNotEmpty(obj) {
+		return Object.keys(obj).length >= 1;
+	}
+	/**
+	* Checks if an object is empty
+	* 
+	* @param obj 
+	* @returns 
+	*/
+	static isEmpty(obj) {
+		return !this.isNotEmpty(obj);
+	}
+	/**
 	* Check if an object is associative (has at least one non-numeric key).
 	* 
 	* @param obj 
@@ -938,6 +899,36 @@ var Obj = class Obj {
 		return isPlainObject(value, allowArray);
 	}
 	/**
+	* Removes the last element from an object and returns it. 
+	* If the object is empty, undefined is returned and the object is not modified.
+	* 
+	* @param obj 
+	* @returns 
+	*/
+	static pop(obj) {
+		const keys = Object.keys(obj);
+		if (!keys.length) return void 0;
+		const lastKey = keys[keys.length - 1];
+		const value = obj[lastKey];
+		delete obj[lastKey];
+		return value;
+	}
+	/**
+	* Removes the first element from an array and returns it. 
+	* If the array is empty, undefined is returned and the array is not modified.
+	* 
+	* @param obj 
+	* @returns 
+	*/
+	static shift(obj) {
+		const keys = Object.keys(obj);
+		if (!keys.length) return void 0;
+		const firstKey = keys[0];
+		const value = obj[firstKey];
+		delete obj[firstKey];
+		return value;
+	}
+	/**
 	* Add a prefix to all keys of the object.
 	* 
 	* @param obj 
@@ -970,6 +961,16 @@ var Obj = class Obj {
 		return parts.join("&");
 	}
 	/**
+	* If the given value is not an associative object, wrap it in one.
+	* 
+	* @param value 
+	*/
+	static wrap(value) {
+		value = typeof value === "string" || typeof value === "number" ? this.arrayWrap(value) : value;
+		if (Array.isArray(value)) value = Object.fromEntries(value.map((e, i) => [i, e]));
+		return value;
+	}
+	/**
 	* undot
 	*
 	* Convert a dot-notated object back into nested structure.
@@ -980,9 +981,21 @@ var Obj = class Obj {
 	* @param obj 
 	* @returns 
 	*/
-	undot(obj) {
+	static undot(obj) {
 		return undot(obj);
 	}
+	/**
+	* If the given value is not an array and not null, wrap it in one.
+	* 
+	* Non-array values become [value]; null/undefined becomes [].
+	* 
+	* @param value 
+	* @returns 
+	*/
+	static arrayWrap(value) {
+		if (value === null || value === void 0) return [];
+		return Array.isArray(value) ? value : [value];
+	}
 };
 
 //#endregion
@@ -1669,173 +1682,6 @@ var Arr = class Arr {
 	}
 };
 
-//#endregion
-//#region src/Helpers/Time.ts
-dayjs.default.extend(dayjs_plugin_utc_js.default);
-dayjs.default.extend(dayjs_plugin_timezone_js.default);
-dayjs.default.extend(dayjs_plugin_dayOfYear_js.default);
-dayjs.default.extend(dayjs_plugin_isBetween_js.default);
-dayjs.default.extend(dayjs_plugin_isLeapYear_js.default);
-dayjs.default.extend(dayjs_plugin_relativeTime_js.default);
-dayjs.default.extend(dayjs_plugin_advancedFormat_js.default);
-dayjs.default.extend(dayjs_plugin_customParseFormat_js.default);
-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 (0, dayjs.default)(date).format(phpToDayjsTokens(fmt));
-}
-const TimeClass = class {};
-var DateTime = class DateTime extends TimeClass {
-	instance;
-	constructor(config, format$1, locale, strict) {
-		super(config);
-		this.instance = (0, dayjs.default)(config, format$1, locale, strict);
-		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.default.isDayjs(result) ? new DateTime(result) : result;
-			};
-			return value;
-		} });
-	}
-	/**
-	* Start time of a specific unit.
-	* 
-	* @returns 
-	*/
-	start(unit = "days") {
-		return this.startOf(unit);
-	}
-	/**
-	* Set the timezone for the instance
-	* 
-	* @param timezone 
-	* @returns 
-	*/
-	setTimezone(timezone$1, keepLocalTime) {
-		return new DateTime(this.tz(timezone$1, keepLocalTime));
-	}
-	/**
-	* 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 new DateTime(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) {
@@ -6071,12 +5917,12 @@ var Stringable = class Stringable {
 				break;
 			}
 			case "Z": {
-				const timezone$1 = now.toLocaleDateString("en-us", {
+				const timezone = now.toLocaleDateString("en-us", {
 					timeZoneName: "longOffset",
 					timeZone: tz ?? void 0
 				});
-				const symbol = timezone$1.match(/[+-]/);
-				const data = timezone$1.split(/[+-]/);
+				const symbol = timezone.match(/[+-]/);
+				const data = timezone.split(/[+-]/);
 				const sign = symbol ? symbol.pop() : "+";
 				const offset = data.length === 2 ? data[1] : "0:00";
 				const hours$1 = parseInt(offset.split(":")[0]);
@@ -6280,7 +6126,7 @@ function loadHelpers(target = globalThis) {
 		Number: Number_exports,
 		Obj,
 		Str,
-		DateTime,
+		DateTime: require_Time.DateTime,
 		DumpDie: DumpDie_exports,
 		apa: Str.apa,
 		title: Str.title,
@@ -6330,13 +6176,13 @@ function loadHelpers(target = globalThis) {
 		checksum,
 		verifyChecksum,
 		caesarCipher,
-		now: DateTime.now,
-		format: DateTime.format,
-		fromTimestamp: DateTime.fromTimestamp,
-		parse: DateTime.parse,
-		randomTime: DateTime.randomTime,
-		firstDayOfMonth: DateTime.firstDayOfMonth,
-		lastDayOfMonth: DateTime.lastDayOfMonth,
+		now: require_Time.DateTime.now,
+		format: require_Time.DateTime.format,
+		fromTimestamp: require_Time.DateTime.fromTimestamp,
+		parse: require_Time.DateTime.parse,
+		randomTime: require_Time.DateTime.randomTime,
+		firstDayOfMonth: require_Time.DateTime.firstDayOfMonth,
+		lastDayOfMonth: require_Time.DateTime.lastDayOfMonth,
 		abbreviate,
 		humanize,
 		toBytes,
@@ -7045,7 +6891,7 @@ Object.defineProperty(exports, 'Crypto', {
     return Crypto_exports;
   }
 });
-exports.DateTime = DateTime;
+exports.DateTime = require_Time.DateTime;
 exports.HigherOrderTapProxy = HigherOrderTapProxy;
 exports.HtmlString = HtmlString;
 exports.InvalidArgumentException = InvalidArgumentException;
@@ -7065,7 +6911,6 @@ exports.ServiceProvider = ServiceProvider;
 exports.Str = Str;
 exports.Stringable = Stringable;
 exports.Tappable = Tappable;
-exports.__toESM = __toESM;
 exports.abbreviate = abbreviate;
 exports.base64Decode = base64Decode;
 exports.base64Encode = base64Encode;
@@ -7082,7 +6927,7 @@ exports.dd = dd;
 exports.dot = dot;
 exports.dump = dump;
 exports.extractProperties = extractProperties;
-exports.format = format;
+exports.format = require_Time.format;
 exports.getValue = getValue;
 exports.hash = hash;
 exports.hmac = hmac;

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 /// <reference path="./app.globals.d.ts" />
+import { n as format, t as DateTime } from "./Time-DY_lqAIR.js";
 import "node:module";
 import { CallableConstructor, ClassConstructor, ConcreteConstructor, IApplication, IServiceProvider } from "@h3ravel/contracts";
-import { Collection as Collection$1 } from "@h3ravel/collect.js";
 import * as _h3ravel_shared0 from "@h3ravel/shared";
 import { DotFlatten, DotNestedKeys, DotNestedValue } from "@h3ravel/shared";
-import dayjs, { ConfigType, Dayjs, OpUnitType, OptionType } from "dayjs";
+import { Collection as Collection$1 } from "@h3ravel/collect.js";
 
 //#region rolldown:runtime
 //#endregion
@@ -466,7 +466,7 @@ declare function data_forget(obj: Record<string, any>, path: string | string[]):
  * @param allowArray
  * @returns
  */
-declare function isPlainObject<P = any>(value: P, allowArray?: boolean): value is P;
+declare function isPlainObject<P extends Record<string, unknown>>(value: unknown, allowArray?: boolean): value is P;
 declare class Obj {
   /**
    * Check if the value is a non-null object (associative/accessible).
@@ -553,13 +553,27 @@ declare class Obj {
    * @returns
    */
   static has<T$1 extends object, P extends DotPath<T$1>>(obj: T$1, keys: P | P[]): boolean;
+  /**
+   * Checks if an object is not empty
+   *
+   * @param obj
+   * @returns
+   */
+  static isNotEmpty<T$1 extends Record<string, unknown>>(obj: T$1): obj is T$1;
+  /**
+   * Checks if an object is empty
+   *
+   * @param obj
+   * @returns
+   */
+  static isEmpty<T$1 extends Record<string, unknown>>(obj: T$1): obj is never;
   /**
    * Check if an object is associative (has at least one non-numeric key).
    *
    * @param obj
    * @returns
    */
-  static isAssoc(obj: unknown): obj is Record<string, any>;
+  static isAssoc<T$1 extends Record<string, unknown>>(obj: unknown): obj is T$1;
   /**
    * Checks if a value is a plain object (not array, function, etc.)
    *
@@ -567,7 +581,23 @@ declare class Obj {
    * @param allowArray
    * @returns
    */
-  static isPlainObject<P = any>(value: P, allowArray?: boolean): value is P;
+  static isPlainObject<T$1 extends Record<string, unknown>>(value: unknown, allowArray?: boolean): value is T$1;
+  /**
+   * Removes the last element from an object and returns it.
+   * If the object is empty, undefined is returned and the object is not modified.
+   *
+   * @param obj
+   * @returns
+   */
+  static pop<T$1 extends Record<string, any>>(obj: T$1): T$1[keyof T$1] | undefined;
+  /**
+   * Removes the first element from an array and returns it.
+   * If the array is empty, undefined is returned and the array is not modified.
+   *
+   * @param obj
+   * @returns
+   */
+  static shift<T$1 extends Record<string, any>>(obj: T$1): T$1[keyof T$1] | undefined;
   /**
    * Add a prefix to all keys of the object.
    *
@@ -585,6 +615,12 @@ declare class Obj {
    * @returns
    */
   static query(obj: Record<string, any>): string;
+  /**
+   * If the given value is not an associative object, wrap it in one.
+   *
+   * @param value
+   */
+  static wrap<N = any>(value: N | Record<string, N> | N[]): Record<string, N>;
   /**
    * undot
    *
@@ -596,7 +632,16 @@ declare class Obj {
    * @param obj
    * @returns
    */
-  undot(obj: Record<string, any>): Record<string, any>;
+  static undot(obj: Record<string, any>): Record<string, any>;
+  /**
+   * If the given value is not an array and not null, wrap it in one.
+   *
+   * Non-array values become [value]; null/undefined becomes [].
+   *
+   * @param value
+   * @returns
+   */
+  private static arrayWrap;
 }
 //#endregion
 //#region src/Helpers/Arr.d.ts
@@ -651,7 +696,7 @@ declare class Arr {
    * Arr.divide(['a','b']) -> [[0,1], ['a','b']]
    * Arr.divide({x:1,y:2}) -> [['x','y'], [1,2]]
    */
-  static divide<A$1>(input: A$1[] | Record<string, A$1>): (number[] | A$1[])[] | (string[] | A$1[])[];
+  static divide<A$1>(input: A$1[] | Record<string, A$1>): (number[] | A$1[])[] | (A$1[] | string[])[];
   /**
    * Flatten a nested array/object structure into a single-level object
    * with dot-notated keys.
@@ -995,116 +1040,6 @@ declare class Arr {
   static unique<T$1 = any>(items: T$1[]): T$1[];
 }
 //#endregion
-//#region src/Helpers/Time.d.ts
-declare function format(date: ConfigType, fmt: string): string;
-declare const TimeClass: {
-  new (date?: dayjs.ConfigType): Dayjs;
-} & typeof Dayjs;
-declare class DateTime extends TimeClass {
-  private instance;
-  constructor(config?: ConfigType);
-  constructor(config?: ConfigType, format?: OptionType, locale?: boolean);
-  /**
-   * Start time of a specific unit.
-   *
-   * @returns
-   */
-  start(unit?: OpUnitType): dayjs.Dayjs;
-  /**
-   * Set the timezone for the instance
-   *
-   * @param timezone
-   * @returns
-   */
-  setTimezone(timezone?: string | undefined, keepLocalTime?: boolean | undefined): DateTime;
-  /**
-   * End time of a specific unit.
-   *
-   * @returns
-   */
-  end(unit?: OpUnitType): dayjs.Dayjs;
-  /**
-   * Get the first day of the month of the given date
-   *
-   * @returns
-   */
-  firstDayOfMonth(): DateTime;
-  carbonFormat(template?: string | undefined): string;
-  /**
-   * Get the last day of the month of the given date
-   *
-   * @returns
-   */
-  lastDayOfMonth(): DateTime;
-  /**
-   * Get a random time between the specified hour and minute.
-   *
-   * @param startHour
-   * @param startMinute
-   * @param endHour
-   * @param endMinute
-   * @returns
-   */
-  randomTime(startHour?: number, startMinute?: number, endHour?: number, endMinute?: number): DateTime;
-  /**
-   * Create a date for a given timestamp.
-   *
-   * @param timestamp - Unix timestamp
-   *
-   * @return {Date} object
-   */
-  static fromTimestamp(timestamp: number): DateTime;
-  /**
-   * Get current time instance.
-   *
-   * @returns Current time
-   */
-  static now(): DateTime;
-  /**
-   * Parse the time
-   *
-   * @param date
-   * @returns
-   */
-  static parse(date: dayjs.ConfigType): DateTime;
-  /**
-   * 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?: ConfigType, template?: string | undefined): string;
-  /**
-   * Get the difference in days from today.
-   *
-   * @param time
-   * @param startHour
-   * @param startMinute
-   * @param endHour
-   * @param endMinute
-   * @returns
-   */
-  static randomTime(time?: ConfigType, startHour?: number, startMinute?: number, endHour?: number, endMinute?: number): DateTime;
-  /**
-   * Get the first day of the month of the given date
-   *
-   * @param time
-   *
-   * @returns
-   */
-  static firstDayOfMonth(time: ConfigType): DateTime;
-  /**
-   * Get the last day of the month of the given date
-   *
-   * @param time
-   *
-   * @returns
-   */
-  static lastDayOfMonth(time: ConfigType): DateTime;
-}
-//#endregion
 //#region src/Helpers/Str.d.ts
 declare enum Mode {
   MB_CASE_UPPER = 0,