@kikiutils/shared 9.0.0

package/dist/datetime.d.ts

@@ -0,0 +1,79 @@
+import type { DateArg, Day, FormatOptions } from 'date-fns';
+export type DateRangeType = 'lastMonth' | 'lastWeek' | 'thisMonth' | 'thisWeek' | 'today' | 'yesterday';
+/**
+ * Formats a given date, timestamp, or date string into a specified format.
+ *
+ * This function is a wrapper around `date-fns/format`.
+ *
+ * @param {DateArg<Date>} date - The input date to format. Can be a Date object, a timestamp, or a string.
+ * @param {string} [format] - The target format string.
+ * @param {FormatOptions} [options] - Optional formatting options passed to `date-fns/format`.
+ * @returns {string} The formatted date string.
+ *
+ * @example
+ * ```typescript
+ * import { formatDate } from '@kikiutils/shared/datetime';
+ *
+ * // Format a Date object
+ * console.log(formatDate(new Date(), 'yyyy-MM-dd')); // 2024-07-10
+ *
+ * // Format a timestamp
+ * console.log(formatDate(1657814400000, 'yyyy-MM-dd')); // 2022-07-15
+ *
+ * // Format a date string
+ * console.log(formatDate('2024-07-10T00:00:00Z', 'yyyy-MM-dd')); // 2024-07-10
+ * ```
+ *
+ * @see https://date-fns.org/docs/format
+ */
+export declare function formatDate(date: DateArg<Date> & {}, format?: string, options?: FormatOptions): string;
+/**
+ * Get the date range (start and end) based on a given date and range type.
+ *
+ * Supports common range types like 'lastMonth', 'lastWeek', 'thisMonth', 'thisWeek', 'today', and 'yesterday'.
+ *
+ * @param {Date} date - The reference date.
+ * @param {DateRangeType} type - The range type to compute.
+ * @param {object} [options] - Optional settings.
+ * @param {boolean} [options.setEndDateToNextDayStart] - If true, set `endDate` to 00:00:00.000 of the next day.
+ * @param {Day} [options.weekStartsOn] - The start day of the week (0 = Sunday, 1 = Monday, ..., 6 = Saturday).
+ * @returns {{ startDate: Date, endDate: Date }} An object with `startDate` and `endDate`.
+ *
+ * @example
+ * ```typescript
+ * import { getDateRangeFromDate } from '@kikiutils/shared/datetime';
+ *
+ * // Get the date range for last month
+ * const date = new Date('2023-07-01');
+ * console.log(getDateRangeFromDate(date, 'lastMonth'));
+ * // { startDate: 2023-06-01T00:00:00.000Z, endDate: 2023-06-30T23:59:59.999Z }
+ *
+ * // Get this week's range with Sunday as the first day
+ * console.log(getDateRangeFromDate(date, 'thisWeek', { weekStartsOn: 0 }));
+ * // { startDate: 2023-06-25T00:00:00.000Z, endDate: 2023-07-01T23:59:59.999Z }
+ * ```
+ */
+export declare function getDateRangeFromDate(date: Date, type: DateRangeType, options?: {
+    setEndDateToNextDayStart?: boolean;
+    weekStartsOn?: Day;
+}): {
+    endDate: Date;
+    startDate: Date;
+};
+/**
+ * Returns a `Date` object set to midnight (00:00:00) of today, with an optional day offset.
+ *
+ * @param {number} [offsetDays] - Number of days to offset from today. Can be negative.
+ * @returns {Date} A `Date` object at 00:00:00 of the offset day.
+ *
+ * @example
+ * ```typescript
+ * import { getMidnightDateFromToday } from '@kikiutils/shared/datetime';
+ *
+ * console.log(getMidnightDateFromToday()); // today at 00:00:00
+ * console.log(getMidnightDateFromToday(3)); // 3 days from today at 00:00:00
+ * console.log(getMidnightDateFromToday(-1)); // yesterday at 00:00:00
+ * ```
+ */
+export declare function getMidnightDateFromToday(offsetDays?: number): Date;
+//# sourceMappingURL=datetime.d.ts.map

package/dist/datetime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../src/datetime.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACR,OAAO,EACP,GAAG,EACH,aAAa,EAChB,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;AAExG;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,GAAE,MAA8B,EAAE,OAAO,CAAC,EAAE,aAAa,UAEnH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAChC,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE;IACN,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,YAAY,CAAC,EAAE,GAAG,CAAC;CACtB;;;EAiDJ;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,GAAE,MAAU,QAK9D"}

package/dist/datetime.mjs

@@ -0,0 +1,127 @@
+import { format, subDays, endOfDay, startOfDay, endOfWeek, startOfWeek, endOfMonth, startOfMonth, subWeeks, subMonths } from 'date-fns';
+
+/**
+ * Formats a given date, timestamp, or date string into a specified format.
+ *
+ * This function is a wrapper around `date-fns/format`.
+ *
+ * @param {DateArg<Date>} date - The input date to format. Can be a Date object, a timestamp, or a string.
+ * @param {string} [format] - The target format string.
+ * @param {FormatOptions} [options] - Optional formatting options passed to `date-fns/format`.
+ * @returns {string} The formatted date string.
+ *
+ * @example
+ * ```typescript
+ * import { formatDate } from '@kikiutils/shared/datetime';
+ *
+ * // Format a Date object
+ * console.log(formatDate(new Date(), 'yyyy-MM-dd')); // 2024-07-10
+ *
+ * // Format a timestamp
+ * console.log(formatDate(1657814400000, 'yyyy-MM-dd')); // 2022-07-15
+ *
+ * // Format a date string
+ * console.log(formatDate('2024-07-10T00:00:00Z', 'yyyy-MM-dd')); // 2024-07-10
+ * ```
+ *
+ * @see https://date-fns.org/docs/format
+ */
+function formatDate(date, format$1 = 'yyyy-MM-dd HH:mm:ss', options) {
+    return format(date, format$1, options);
+}
+/**
+ * Get the date range (start and end) based on a given date and range type.
+ *
+ * Supports common range types like 'lastMonth', 'lastWeek', 'thisMonth', 'thisWeek', 'today', and 'yesterday'.
+ *
+ * @param {Date} date - The reference date.
+ * @param {DateRangeType} type - The range type to compute.
+ * @param {object} [options] - Optional settings.
+ * @param {boolean} [options.setEndDateToNextDayStart] - If true, set `endDate` to 00:00:00.000 of the next day.
+ * @param {Day} [options.weekStartsOn] - The start day of the week (0 = Sunday, 1 = Monday, ..., 6 = Saturday).
+ * @returns {{ startDate: Date, endDate: Date }} An object with `startDate` and `endDate`.
+ *
+ * @example
+ * ```typescript
+ * import { getDateRangeFromDate } from '@kikiutils/shared/datetime';
+ *
+ * // Get the date range for last month
+ * const date = new Date('2023-07-01');
+ * console.log(getDateRangeFromDate(date, 'lastMonth'));
+ * // { startDate: 2023-06-01T00:00:00.000Z, endDate: 2023-06-30T23:59:59.999Z }
+ *
+ * // Get this week's range with Sunday as the first day
+ * console.log(getDateRangeFromDate(date, 'thisWeek', { weekStartsOn: 0 }));
+ * // { startDate: 2023-06-25T00:00:00.000Z, endDate: 2023-07-01T23:59:59.999Z }
+ * ```
+ */
+function getDateRangeFromDate(date, type, options) {
+    let endDate;
+    let startDate;
+    switch (type) {
+        case 'lastMonth':
+            {
+                const lastMonth = subMonths(date, 1);
+                endDate = endOfMonth(lastMonth);
+                startDate = startOfMonth(lastMonth);
+            }
+            break;
+        case 'lastWeek':
+            {
+                const lastWeek = subWeeks(date, 1);
+                endDate = endOfWeek(lastWeek, { weekStartsOn: options?.weekStartsOn ?? 1 });
+                startDate = startOfWeek(lastWeek, { weekStartsOn: options?.weekStartsOn ?? 1 });
+            }
+            break;
+        case 'thisMonth':
+            endDate = endOfMonth(date);
+            startDate = startOfMonth(date);
+            break;
+        case 'thisWeek':
+            endDate = endOfWeek(date, { weekStartsOn: options?.weekStartsOn ?? 1 });
+            startDate = startOfWeek(date, { weekStartsOn: options?.weekStartsOn ?? 1 });
+            break;
+        case 'today':
+            endDate = endOfDay(date);
+            startDate = startOfDay(date);
+            break;
+        case 'yesterday':
+            {
+                const yesterday = subDays(date, 1);
+                endDate = endOfDay(yesterday);
+                startDate = startOfDay(yesterday);
+            }
+            break;
+        default: throw new Error(`Unsupported date range type: ${type}.`);
+    }
+    if (options?.setEndDateToNextDayStart)
+        endDate.setHours(24, 0, 0, 0);
+    return {
+        endDate,
+        startDate,
+    };
+}
+/**
+ * Returns a `Date` object set to midnight (00:00:00) of today, with an optional day offset.
+ *
+ * @param {number} [offsetDays] - Number of days to offset from today. Can be negative.
+ * @returns {Date} A `Date` object at 00:00:00 of the offset day.
+ *
+ * @example
+ * ```typescript
+ * import { getMidnightDateFromToday } from '@kikiutils/shared/datetime';
+ *
+ * console.log(getMidnightDateFromToday()); // today at 00:00:00
+ * console.log(getMidnightDateFromToday(3)); // 3 days from today at 00:00:00
+ * console.log(getMidnightDateFromToday(-1)); // yesterday at 00:00:00
+ * ```
+ */
+function getMidnightDateFromToday(offsetDays = 0) {
+    const date = new Date();
+    date.setDate(date.getDate() + offsetDays);
+    date.setHours(0, 0, 0, 0);
+    return date;
+}
+
+export { formatDate, getDateRangeFromDate, getMidnightDateFromToday };
+//# sourceMappingURL=datetime.mjs.map

package/dist/datetime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.mjs","sources":["../src/datetime.ts"],"sourcesContent":["import {\n    format as dateFnsFormat,\n    endOfDay,\n    endOfMonth,\n    endOfWeek,\n    startOfDay,\n    startOfMonth,\n    startOfWeek,\n    subDays,\n    subMonths,\n    subWeeks,\n} from 'date-fns';\nimport type {\n    DateArg,\n    Day,\n    FormatOptions,\n} from 'date-fns';\n\nexport type DateRangeType = 'lastMonth' | 'lastWeek' | 'thisMonth' | 'thisWeek' | 'today' | 'yesterday';\n\n/**\n * Formats a given date, timestamp, or date string into a specified format.\n *\n * This function is a wrapper around `date-fns/format`.\n *\n * @param {DateArg<Date>} date - The input date to format. Can be a Date object, a timestamp, or a string.\n * @param {string} [format] - The target format string.\n * @param {FormatOptions} [options] - Optional formatting options passed to `date-fns/format`.\n * @returns {string} The formatted date string.\n *\n * @example\n * ```typescript\n * import { formatDate } from '@kikiutils/shared/datetime';\n *\n * // Format a Date object\n * console.log(formatDate(new Date(), 'yyyy-MM-dd')); // 2024-07-10\n *\n * // Format a timestamp\n * console.log(formatDate(1657814400000, 'yyyy-MM-dd')); // 2022-07-15\n *\n * // Format a date string\n * console.log(formatDate('2024-07-10T00:00:00Z', 'yyyy-MM-dd')); // 2024-07-10\n * ```\n *\n * @see https://date-fns.org/docs/format\n */\nexport function formatDate(date: DateArg<Date> & {}, format: string = 'yyyy-MM-dd HH:mm:ss', options?: FormatOptions) {\n    return dateFnsFormat(date, format, options);\n}\n\n/**\n * Get the date range (start and end) based on a given date and range type.\n *\n * Supports common range types like 'lastMonth', 'lastWeek', 'thisMonth', 'thisWeek', 'today', and 'yesterday'.\n *\n * @param {Date} date - The reference date.\n * @param {DateRangeType} type - The range type to compute.\n * @param {object} [options] - Optional settings.\n * @param {boolean} [options.setEndDateToNextDayStart] - If true, set `endDate` to 00:00:00.000 of the next day.\n * @param {Day} [options.weekStartsOn] - The start day of the week (0 = Sunday, 1 = Monday, ..., 6 = Saturday).\n * @returns {{ startDate: Date, endDate: Date }} An object with `startDate` and `endDate`.\n *\n * @example\n * ```typescript\n * import { getDateRangeFromDate } from '@kikiutils/shared/datetime';\n *\n * // Get the date range for last month\n * const date = new Date('2023-07-01');\n * console.log(getDateRangeFromDate(date, 'lastMonth'));\n * // { startDate: 2023-06-01T00:00:00.000Z, endDate: 2023-06-30T23:59:59.999Z }\n *\n * // Get this week's range with Sunday as the first day\n * console.log(getDateRangeFromDate(date, 'thisWeek', { weekStartsOn: 0 }));\n * // { startDate: 2023-06-25T00:00:00.000Z, endDate: 2023-07-01T23:59:59.999Z }\n * ```\n */\nexport function getDateRangeFromDate(\n    date: Date,\n    type: DateRangeType,\n    options?: {\n        setEndDateToNextDayStart?: boolean;\n        weekStartsOn?: Day;\n    },\n) {\n    let endDate: Date;\n    let startDate: Date;\n    switch (type) {\n        case 'lastMonth':\n            {\n                const lastMonth = subMonths(date, 1);\n                endDate = endOfMonth(lastMonth);\n                startDate = startOfMonth(lastMonth);\n            }\n\n            break;\n        case 'lastWeek':\n            {\n                const lastWeek = subWeeks(date, 1);\n                endDate = endOfWeek(lastWeek, { weekStartsOn: options?.weekStartsOn ?? 1 });\n                startDate = startOfWeek(lastWeek, { weekStartsOn: options?.weekStartsOn ?? 1 });\n            }\n\n            break;\n        case 'thisMonth':\n            endDate = endOfMonth(date);\n            startDate = startOfMonth(date);\n            break;\n        case 'thisWeek':\n            endDate = endOfWeek(date, { weekStartsOn: options?.weekStartsOn ?? 1 });\n            startDate = startOfWeek(date, { weekStartsOn: options?.weekStartsOn ?? 1 });\n            break;\n        case 'today':\n            endDate = endOfDay(date);\n            startDate = startOfDay(date);\n            break;\n        case 'yesterday':\n            {\n                const yesterday = subDays(date, 1);\n                endDate = endOfDay(yesterday);\n                startDate = startOfDay(yesterday);\n            }\n\n            break;\n        default: throw new Error(`Unsupported date range type: ${type}.`);\n    }\n\n    if (options?.setEndDateToNextDayStart) endDate.setHours(24, 0, 0, 0);\n    return {\n        endDate,\n        startDate,\n    };\n}\n\n/**\n * Returns a `Date` object set to midnight (00:00:00) of today, with an optional day offset.\n *\n * @param {number} [offsetDays] - Number of days to offset from today. Can be negative.\n * @returns {Date} A `Date` object at 00:00:00 of the offset day.\n *\n * @example\n * ```typescript\n * import { getMidnightDateFromToday } from '@kikiutils/shared/datetime';\n *\n * console.log(getMidnightDateFromToday()); // today at 00:00:00\n * console.log(getMidnightDateFromToday(3)); // 3 days from today at 00:00:00\n * console.log(getMidnightDateFromToday(-1)); // yesterday at 00:00:00\n * ```\n */\nexport function getMidnightDateFromToday(offsetDays: number = 0) {\n    const date = new Date();\n    date.setDate(date.getDate() + offsetDays);\n    date.setHours(0, 0, 0, 0);\n    return date;\n}\n"],"names":["format","dateFnsFormat"],"mappings":";;AAoBA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBG;AACG,SAAU,UAAU,CAAC,IAAwB,EAAEA,QAAiB,GAAA,qBAAqB,EAAE,OAAuB,EAAA;IAChH,OAAOC,MAAa,CAAC,IAAI,EAAED,QAAM,EAAE,OAAO,CAAC;AAC/C;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBG;SACa,oBAAoB,CAChC,IAAU,EACV,IAAmB,EACnB,OAGC,EAAA;AAED,IAAA,IAAI,OAAa;AACjB,IAAA,IAAI,SAAe;IACnB,QAAQ,IAAI;AACR,QAAA,KAAK,WAAW;YACZ;gBACI,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;AACpC,gBAAA,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC;AAC/B,gBAAA,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC;;YAGvC;AACJ,QAAA,KAAK,UAAU;YACX;gBACI,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAClC,gBAAA,OAAO,GAAG,SAAS,CAAC,QAAQ,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,IAAI,CAAC,EAAE,CAAC;AAC3E,gBAAA,SAAS,GAAG,WAAW,CAAC,QAAQ,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,IAAI,CAAC,EAAE,CAAC;;YAGnF;AACJ,QAAA,KAAK,WAAW;AACZ,YAAA,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC;AAC1B,YAAA,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC;YAC9B;AACJ,QAAA,KAAK,UAAU;AACX,YAAA,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,IAAI,CAAC,EAAE,CAAC;AACvE,YAAA,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,IAAI,CAAC,EAAE,CAAC;YAC3E;AACJ,QAAA,KAAK,OAAO;AACR,YAAA,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC;AACxB,YAAA,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC;YAC5B;AACJ,QAAA,KAAK,WAAW;YACZ;gBACI,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AAClC,gBAAA,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC;AAC7B,gBAAA,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;;YAGrC;QACJ,SAAS,MAAM,IAAI,KAAK,CAAC,CAAgC,6BAAA,EAAA,IAAI,CAAG,CAAA,CAAA,CAAC;;IAGrE,IAAI,OAAO,EAAE,wBAAwB;QAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACpE,OAAO;QACH,OAAO;QACP,SAAS;KACZ;AACL;AAEA;;;;;;;;;;;;;;AAcG;AACa,SAAA,wBAAwB,CAAC,UAAA,GAAqB,CAAC,EAAA;AAC3D,IAAA,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE;IACvB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC;IACzC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AACzB,IAAA,OAAO,IAAI;AACf;;;;"}

package/dist/enum.cjs

@@ -0,0 +1,65 @@
+'use strict';
+
+/**
+ * Extracts the numeric values from an enumeration-like object.
+ *
+ * @param {Record<number | string, number | string>} data - The enumeration-like object to extract numeric values from.
+ * The keys can be numbers or strings, and the values can be numbers or strings.
+ * @returns {number[]} An array of numeric values extracted from the object.
+ *
+ * @example
+ * ```typescript
+ * import { getEnumNumberValues } from '@kikiutils/shared/enum';
+ *
+ * enum RecordType {
+ *   Receive = 0,
+ *   Send = 1,
+ *   Unknown = 'unknown'
+ * }
+ *
+ * console.log(getEnumNumberValues(RecordType)); // [0, 1]
+ * ```
+ */
+function getEnumNumberValues(data) {
+    return Object.values(data).filter((value) => typeof value === 'number');
+}
+/**
+ * Extracts the string values from an enumeration-like object.
+ *
+ * @param {Record<number | string, number | string>} data - The enumeration-like object to extract string values from.
+ * The keys can be numbers or strings, and the values can be numbers or strings.
+ * @returns {string[]} An array of string values extracted from the object.
+ *
+ * @example
+ * ```typescript
+ * import { getEnumStringValues } from '@kikiutils/shared/enum';
+ *
+ * enum RecordType {
+ *   Receive = 0,
+ *   Send = 1,
+ *   Unknown = 'unknown'
+ * }
+ *
+ * console.log(getEnumStringValues(RecordType)); // ['unknown']
+ * ```
+ */
+function getEnumStringValues(data) {
+    const keys = [];
+    const keysCount = {};
+    const values = [];
+    Object.entries(data).forEach(([key, value]) => {
+        keys.push(key);
+        values.push(value);
+        if (typeof value !== 'string')
+            return;
+        keysCount[key] = (keysCount[key] ?? 0) + 1;
+        keysCount[value] = (keysCount[value] ?? 0) + 1;
+    });
+    return values.filter((value) => {
+        return typeof value === 'string' && (!keys.includes(value) || (keysCount[value] && keysCount[value] > 1));
+    });
+}
+
+exports.getEnumNumberValues = getEnumNumberValues;
+exports.getEnumStringValues = getEnumStringValues;
+//# sourceMappingURL=enum.cjs.map

package/dist/enum.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum.cjs","sources":["../src/enum.ts"],"sourcesContent":["/**\n * Extracts the numeric values from an enumeration-like object.\n *\n * @param {Record<number | string, number | string>} data - The enumeration-like object to extract numeric values from.\n * The keys can be numbers or strings, and the values can be numbers or strings.\n * @returns {number[]} An array of numeric values extracted from the object.\n *\n * @example\n * ```typescript\n * import { getEnumNumberValues } from '@kikiutils/shared/enum';\n *\n * enum RecordType {\n *   Receive = 0,\n *   Send = 1,\n *   Unknown = 'unknown'\n * }\n *\n * console.log(getEnumNumberValues(RecordType)); // [0, 1]\n * ```\n */\nexport function getEnumNumberValues(data: Record<number | string, number | string>) {\n    return Object.values(data).filter((value) => typeof value === 'number');\n}\n\n/**\n * Extracts the string values from an enumeration-like object.\n *\n * @param {Record<number | string, number | string>} data - The enumeration-like object to extract string values from.\n * The keys can be numbers or strings, and the values can be numbers or strings.\n * @returns {string[]} An array of string values extracted from the object.\n *\n * @example\n * ```typescript\n * import { getEnumStringValues } from '@kikiutils/shared/enum';\n *\n * enum RecordType {\n *   Receive = 0,\n *   Send = 1,\n *   Unknown = 'unknown'\n * }\n *\n * console.log(getEnumStringValues(RecordType)); // ['unknown']\n * ```\n */\nexport function getEnumStringValues(data: Record<number | string, number | string>) {\n    const keys: string[] = [];\n    const keysCount: Record<string, number> = {};\n    const values: any[] = [];\n    Object.entries(data).forEach(([key, value]) => {\n        keys.push(key);\n        values.push(value);\n        if (typeof value !== 'string') return;\n        keysCount[key] = (keysCount[key] ?? 0) + 1;\n        keysCount[value] = (keysCount[value] ?? 0) + 1;\n    });\n\n    return values.filter((value) => {\n        return typeof value === 'string' && (!keys.includes(value) || (keysCount[value] && keysCount[value] > 1));\n    });\n}\n"],"names":[],"mappings":";;AAAA;;;;;;;;;;;;;;;;;;;AAmBG;AACG,SAAU,mBAAmB,CAAC,IAA8C,EAAA;AAC9E,IAAA,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,OAAO,KAAK,KAAK,QAAQ,CAAC;AAC3E;AAEA;;;;;;;;;;;;;;;;;;;AAmBG;AACG,SAAU,mBAAmB,CAAC,IAA8C,EAAA;IAC9E,MAAM,IAAI,GAAa,EAAE;IACzB,MAAM,SAAS,GAA2B,EAAE;IAC5C,MAAM,MAAM,GAAU,EAAE;AACxB,IAAA,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAI;AAC1C,QAAA,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACd,QAAA,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;QAClB,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE;AAC/B,QAAA,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;AAC1C,QAAA,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;AAClD,KAAC,CAAC;AAEF,IAAA,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,KAAI;AAC3B,QAAA,OAAO,OAAO,KAAK,KAAK,QAAQ,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7G,KAAC,CAAC;AACN;;;;;"}

package/dist/enum.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Extracts the numeric values from an enumeration-like object.
+ *
+ * @param {Record<number | string, number | string>} data - The enumeration-like object to extract numeric values from.
+ * The keys can be numbers or strings, and the values can be numbers or strings.
+ * @returns {number[]} An array of numeric values extracted from the object.
+ *
+ * @example
+ * ```typescript
+ * import { getEnumNumberValues } from '@kikiutils/shared/enum';
+ *
+ * enum RecordType {
+ *   Receive = 0,
+ *   Send = 1,
+ *   Unknown = 'unknown'
+ * }
+ *
+ * console.log(getEnumNumberValues(RecordType)); // [0, 1]
+ * ```
+ */
+export declare function getEnumNumberValues(data: Record<number | string, number | string>): number[];
+/**
+ * Extracts the string values from an enumeration-like object.
+ *
+ * @param {Record<number | string, number | string>} data - The enumeration-like object to extract string values from.
+ * The keys can be numbers or strings, and the values can be numbers or strings.
+ * @returns {string[]} An array of string values extracted from the object.
+ *
+ * @example
+ * ```typescript
+ * import { getEnumStringValues } from '@kikiutils/shared/enum';
+ *
+ * enum RecordType {
+ *   Receive = 0,
+ *   Send = 1,
+ *   Unknown = 'unknown'
+ * }
+ *
+ * console.log(getEnumStringValues(RecordType)); // ['unknown']
+ * ```
+ */
+export declare function getEnumStringValues(data: Record<number | string, number | string>): any[];
+//# sourceMappingURL=enum.d.ts.map

package/dist/enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum.d.ts","sourceRoot":"","sources":["../src/enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,YAEjF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,SAejF"}

package/dist/enum.mjs

@@ -0,0 +1,62 @@
+/**
+ * Extracts the numeric values from an enumeration-like object.
+ *
+ * @param {Record<number | string, number | string>} data - The enumeration-like object to extract numeric values from.
+ * The keys can be numbers or strings, and the values can be numbers or strings.
+ * @returns {number[]} An array of numeric values extracted from the object.
+ *
+ * @example
+ * ```typescript
+ * import { getEnumNumberValues } from '@kikiutils/shared/enum';
+ *
+ * enum RecordType {
+ *   Receive = 0,
+ *   Send = 1,
+ *   Unknown = 'unknown'
+ * }
+ *
+ * console.log(getEnumNumberValues(RecordType)); // [0, 1]
+ * ```
+ */
+function getEnumNumberValues(data) {
+    return Object.values(data).filter((value) => typeof value === 'number');
+}
+/**
+ * Extracts the string values from an enumeration-like object.
+ *
+ * @param {Record<number | string, number | string>} data - The enumeration-like object to extract string values from.
+ * The keys can be numbers or strings, and the values can be numbers or strings.
+ * @returns {string[]} An array of string values extracted from the object.
+ *
+ * @example
+ * ```typescript
+ * import { getEnumStringValues } from '@kikiutils/shared/enum';
+ *
+ * enum RecordType {
+ *   Receive = 0,
+ *   Send = 1,
+ *   Unknown = 'unknown'
+ * }
+ *
+ * console.log(getEnumStringValues(RecordType)); // ['unknown']
+ * ```
+ */
+function getEnumStringValues(data) {
+    const keys = [];
+    const keysCount = {};
+    const values = [];
+    Object.entries(data).forEach(([key, value]) => {
+        keys.push(key);
+        values.push(value);
+        if (typeof value !== 'string')
+            return;
+        keysCount[key] = (keysCount[key] ?? 0) + 1;
+        keysCount[value] = (keysCount[value] ?? 0) + 1;
+    });
+    return values.filter((value) => {
+        return typeof value === 'string' && (!keys.includes(value) || (keysCount[value] && keysCount[value] > 1));
+    });
+}
+
+export { getEnumNumberValues, getEnumStringValues };
+//# sourceMappingURL=enum.mjs.map

package/dist/enum.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum.mjs","sources":["../src/enum.ts"],"sourcesContent":["/**\n * Extracts the numeric values from an enumeration-like object.\n *\n * @param {Record<number | string, number | string>} data - The enumeration-like object to extract numeric values from.\n * The keys can be numbers or strings, and the values can be numbers or strings.\n * @returns {number[]} An array of numeric values extracted from the object.\n *\n * @example\n * ```typescript\n * import { getEnumNumberValues } from '@kikiutils/shared/enum';\n *\n * enum RecordType {\n *   Receive = 0,\n *   Send = 1,\n *   Unknown = 'unknown'\n * }\n *\n * console.log(getEnumNumberValues(RecordType)); // [0, 1]\n * ```\n */\nexport function getEnumNumberValues(data: Record<number | string, number | string>) {\n    return Object.values(data).filter((value) => typeof value === 'number');\n}\n\n/**\n * Extracts the string values from an enumeration-like object.\n *\n * @param {Record<number | string, number | string>} data - The enumeration-like object to extract string values from.\n * The keys can be numbers or strings, and the values can be numbers or strings.\n * @returns {string[]} An array of string values extracted from the object.\n *\n * @example\n * ```typescript\n * import { getEnumStringValues } from '@kikiutils/shared/enum';\n *\n * enum RecordType {\n *   Receive = 0,\n *   Send = 1,\n *   Unknown = 'unknown'\n * }\n *\n * console.log(getEnumStringValues(RecordType)); // ['unknown']\n * ```\n */\nexport function getEnumStringValues(data: Record<number | string, number | string>) {\n    const keys: string[] = [];\n    const keysCount: Record<string, number> = {};\n    const values: any[] = [];\n    Object.entries(data).forEach(([key, value]) => {\n        keys.push(key);\n        values.push(value);\n        if (typeof value !== 'string') return;\n        keysCount[key] = (keysCount[key] ?? 0) + 1;\n        keysCount[value] = (keysCount[value] ?? 0) + 1;\n    });\n\n    return values.filter((value) => {\n        return typeof value === 'string' && (!keys.includes(value) || (keysCount[value] && keysCount[value] > 1));\n    });\n}\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;AAmBG;AACG,SAAU,mBAAmB,CAAC,IAA8C,EAAA;AAC9E,IAAA,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,OAAO,KAAK,KAAK,QAAQ,CAAC;AAC3E;AAEA;;;;;;;;;;;;;;;;;;;AAmBG;AACG,SAAU,mBAAmB,CAAC,IAA8C,EAAA;IAC9E,MAAM,IAAI,GAAa,EAAE;IACzB,MAAM,SAAS,GAA2B,EAAE;IAC5C,MAAM,MAAM,GAAU,EAAE;AACxB,IAAA,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAI;AAC1C,QAAA,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACd,QAAA,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;QAClB,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE;AAC/B,QAAA,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;AAC1C,QAAA,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;AAClD,KAAC,CAAC;AAEF,IAAA,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,KAAI;AAC3B,QAAA,OAAO,OAAO,KAAK,KAAK,QAAQ,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7G,KAAC,CAAC;AACN;;;;"}

package/dist/env.cjs

@@ -0,0 +1,54 @@
+'use strict';
+
+/**
+ * Custom error class for handling missing environment variables.
+ *
+ * Extends the built-in `Error` class and includes the missing key.
+ *
+ * @extends {Error}
+ */
+class EnvironmentNotFoundError extends Error {
+    key;
+    /**
+     * Creates a new EnvironmentNotFoundError.
+     *
+     * @param {string} key - The missing environment variable key.
+     */
+    constructor(key) {
+        super(`Missing environment variable: ${key}`);
+        this.key = key;
+        this.name = this.constructor.name;
+        Error.captureStackTrace?.(this, this.constructor);
+    }
+}
+/**
+ * Retrieves the value of an environment variable, or throws an error if not set.
+ *
+ * @param {string} key - The environment variable key to check.
+ * @returns {string} The value of the environment variable.
+ * @throws {EnvironmentNotFoundError} If the environment variable is not defined.
+ *
+ * @example
+ * ```typescript
+ * import { checkAndGetEnvValue } from '@kikiutils/shared/env';
+ *
+ * // When the environment variable 'API_KEY' is set:
+ * console.log(checkAndGetEnvValue('API_KEY')); // value of API_KEY
+ *
+ * // When the environment variable 'API_KEY' is not set:
+ * try {
+ *   const apiKey = checkAndGetEnvValue('API_KEY');
+ * } catch (error) {
+ *   console.error(error); // Missing environment variable: API_KEY
+ * }
+ * ```
+ */
+function checkAndGetEnvValue(key) {
+    if (!process.env[key])
+        throw new EnvironmentNotFoundError(key);
+    return process.env[key];
+}
+
+exports.EnvironmentNotFoundError = EnvironmentNotFoundError;
+exports.checkAndGetEnvValue = checkAndGetEnvValue;
+//# sourceMappingURL=env.cjs.map

package/dist/env.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.cjs","sources":["../src/env.ts"],"sourcesContent":["/**\n * Custom error class for handling missing environment variables.\n *\n * Extends the built-in `Error` class and includes the missing key.\n *\n * @extends {Error}\n */\nexport class EnvironmentNotFoundError extends Error {\n    readonly key: string;\n\n    /**\n     * Creates a new EnvironmentNotFoundError.\n     *\n     * @param {string} key - The missing environment variable key.\n     */\n    constructor(key: string) {\n        super(`Missing environment variable: ${key}`);\n        this.key = key;\n        this.name = this.constructor.name;\n        Error.captureStackTrace?.(this, this.constructor);\n    }\n}\n\n/**\n * Retrieves the value of an environment variable, or throws an error if not set.\n *\n * @param {string} key - The environment variable key to check.\n * @returns {string} The value of the environment variable.\n * @throws {EnvironmentNotFoundError} If the environment variable is not defined.\n *\n * @example\n * ```typescript\n * import { checkAndGetEnvValue } from '@kikiutils/shared/env';\n *\n * // When the environment variable 'API_KEY' is set:\n * console.log(checkAndGetEnvValue('API_KEY')); // value of API_KEY\n *\n * // When the environment variable 'API_KEY' is not set:\n * try {\n *   const apiKey = checkAndGetEnvValue('API_KEY');\n * } catch (error) {\n *   console.error(error); // Missing environment variable: API_KEY\n * }\n * ```\n */\nexport function checkAndGetEnvValue(key: string): string {\n    if (!process.env[key]) throw new EnvironmentNotFoundError(key);\n    return process.env[key];\n}\n"],"names":[],"mappings":";;AAAA;;;;;;AAMG;AACG,MAAO,wBAAyB,SAAQ,KAAK,CAAA;AACtC,IAAA,GAAG;AAEZ;;;;AAIG;AACH,IAAA,WAAA,CAAY,GAAW,EAAA;AACnB,QAAA,KAAK,CAAC,CAAA,8BAAA,EAAiC,GAAG,CAAA,CAAE,CAAC;AAC7C,QAAA,IAAI,CAAC,GAAG,GAAG,GAAG;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI;QACjC,KAAK,CAAC,iBAAiB,GAAG,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC;;AAExD;AAED;;;;;;;;;;;;;;;;;;;;;AAqBG;AACG,SAAU,mBAAmB,CAAC,GAAW,EAAA;AAC3C,IAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;AAAE,QAAA,MAAM,IAAI,wBAAwB,CAAC,GAAG,CAAC;AAC9D,IAAA,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;AAC3B;;;;;"}

package/dist/env.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Custom error class for handling missing environment variables.
+ *
+ * Extends the built-in `Error` class and includes the missing key.
+ *
+ * @extends {Error}
+ */
+export declare class EnvironmentNotFoundError extends Error {
+    readonly key: string;
+    /**
+     * Creates a new EnvironmentNotFoundError.
+     *
+     * @param {string} key - The missing environment variable key.
+     */
+    constructor(key: string);
+}
+/**
+ * Retrieves the value of an environment variable, or throws an error if not set.
+ *
+ * @param {string} key - The environment variable key to check.
+ * @returns {string} The value of the environment variable.
+ * @throws {EnvironmentNotFoundError} If the environment variable is not defined.
+ *
+ * @example
+ * ```typescript
+ * import { checkAndGetEnvValue } from '@kikiutils/shared/env';
+ *
+ * // When the environment variable 'API_KEY' is set:
+ * console.log(checkAndGetEnvValue('API_KEY')); // value of API_KEY
+ *
+ * // When the environment variable 'API_KEY' is not set:
+ * try {
+ *   const apiKey = checkAndGetEnvValue('API_KEY');
+ * } catch (error) {
+ *   console.error(error); // Missing environment variable: API_KEY
+ * }
+ * ```
+ */
+export declare function checkAndGetEnvValue(key: string): string;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB;;;;OAIG;gBACS,GAAG,EAAE,MAAM;CAM1B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGvD"}

package/dist/env.mjs

@@ -0,0 +1,51 @@
+/**
+ * Custom error class for handling missing environment variables.
+ *
+ * Extends the built-in `Error` class and includes the missing key.
+ *
+ * @extends {Error}
+ */
+class EnvironmentNotFoundError extends Error {
+    key;
+    /**
+     * Creates a new EnvironmentNotFoundError.
+     *
+     * @param {string} key - The missing environment variable key.
+     */
+    constructor(key) {
+        super(`Missing environment variable: ${key}`);
+        this.key = key;
+        this.name = this.constructor.name;
+        Error.captureStackTrace?.(this, this.constructor);
+    }
+}
+/**
+ * Retrieves the value of an environment variable, or throws an error if not set.
+ *
+ * @param {string} key - The environment variable key to check.
+ * @returns {string} The value of the environment variable.
+ * @throws {EnvironmentNotFoundError} If the environment variable is not defined.
+ *
+ * @example
+ * ```typescript
+ * import { checkAndGetEnvValue } from '@kikiutils/shared/env';
+ *
+ * // When the environment variable 'API_KEY' is set:
+ * console.log(checkAndGetEnvValue('API_KEY')); // value of API_KEY
+ *
+ * // When the environment variable 'API_KEY' is not set:
+ * try {
+ *   const apiKey = checkAndGetEnvValue('API_KEY');
+ * } catch (error) {
+ *   console.error(error); // Missing environment variable: API_KEY
+ * }
+ * ```
+ */
+function checkAndGetEnvValue(key) {
+    if (!process.env[key])
+        throw new EnvironmentNotFoundError(key);
+    return process.env[key];
+}
+
+export { EnvironmentNotFoundError, checkAndGetEnvValue };
+//# sourceMappingURL=env.mjs.map

package/dist/env.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.mjs","sources":["../src/env.ts"],"sourcesContent":["/**\n * Custom error class for handling missing environment variables.\n *\n * Extends the built-in `Error` class and includes the missing key.\n *\n * @extends {Error}\n */\nexport class EnvironmentNotFoundError extends Error {\n    readonly key: string;\n\n    /**\n     * Creates a new EnvironmentNotFoundError.\n     *\n     * @param {string} key - The missing environment variable key.\n     */\n    constructor(key: string) {\n        super(`Missing environment variable: ${key}`);\n        this.key = key;\n        this.name = this.constructor.name;\n        Error.captureStackTrace?.(this, this.constructor);\n    }\n}\n\n/**\n * Retrieves the value of an environment variable, or throws an error if not set.\n *\n * @param {string} key - The environment variable key to check.\n * @returns {string} The value of the environment variable.\n * @throws {EnvironmentNotFoundError} If the environment variable is not defined.\n *\n * @example\n * ```typescript\n * import { checkAndGetEnvValue } from '@kikiutils/shared/env';\n *\n * // When the environment variable 'API_KEY' is set:\n * console.log(checkAndGetEnvValue('API_KEY')); // value of API_KEY\n *\n * // When the environment variable 'API_KEY' is not set:\n * try {\n *   const apiKey = checkAndGetEnvValue('API_KEY');\n * } catch (error) {\n *   console.error(error); // Missing environment variable: API_KEY\n * }\n * ```\n */\nexport function checkAndGetEnvValue(key: string): string {\n    if (!process.env[key]) throw new EnvironmentNotFoundError(key);\n    return process.env[key];\n}\n"],"names":[],"mappings":"AAAA;;;;;;AAMG;AACG,MAAO,wBAAyB,SAAQ,KAAK,CAAA;AACtC,IAAA,GAAG;AAEZ;;;;AAIG;AACH,IAAA,WAAA,CAAY,GAAW,EAAA;AACnB,QAAA,KAAK,CAAC,CAAA,8BAAA,EAAiC,GAAG,CAAA,CAAE,CAAC;AAC7C,QAAA,IAAI,CAAC,GAAG,GAAG,GAAG;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI;QACjC,KAAK,CAAC,iBAAiB,GAAG,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC;;AAExD;AAED;;;;;;;;;;;;;;;;;;;;;AAqBG;AACG,SAAU,mBAAmB,CAAC,GAAW,EAAA;AAC3C,IAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;AAAE,QAAA,MAAM,IAAI,wBAAwB,CAAC,GAAG,CAAC;AAC9D,IAAA,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;AAC3B;;;;"}

package/dist/general.cjs

@@ -0,0 +1,8 @@
+'use strict';
+
+function extractFirstValue(value, defaultValue) {
+    return (Array.isArray(value) ? value[0] : value) ?? defaultValue;
+}
+
+exports.extractFirstValue = extractFirstValue;
+//# sourceMappingURL=general.cjs.map

package/dist/general.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"general.cjs","sources":["../src/general.ts"],"sourcesContent":["/**\n * Extracts the first value from an array or returns the value itself if it's not an array.\n *\n * - If `value` is an array, returns the first element.\n * - If `value` is not an array, returns `value` directly.\n * - If the result is `null` or `undefined`, and `defaultValue` is provided, returns `defaultValue` instead.\n *\n * @template T - The type of the input value(s).\n * @template D - The type of the default value (if provided).\n *\n * @param {T | T[]} value - A single value or an array of values.\n * @param {D} [defaultValue] - A fallback value if the result is `null` or `undefined`.\n * @returns {T | D | undefined} The first value or the fallback.\n *\n * @example\n * ```typescript\n * import { extractFirstValue } from '@kikiutils/shared/general';\n *\n * console.log(extractFirstValue([1, 2, 3])); // 1\n * console.log(extractFirstValue('hello'));  // hello\n * console.log(extractFirstValue([], 'default')); // default\n * console.log(extractFirstValue(undefined, 'fallback')); // fallback\n * ```\n */\nexport function extractFirstValue<T>(value: T | T[]): T | undefined;\nexport function extractFirstValue<T, D>(value: T | T[], defaultValue: D): D | NonNullable<T>;\nexport function extractFirstValue<T, D>(value: T | T[], defaultValue?: D) {\n    return (Array.isArray(value) ? value[0] : value) ?? defaultValue;\n}\n"],"names":[],"mappings":";;AA0BgB,SAAA,iBAAiB,CAAO,KAAc,EAAE,YAAgB,EAAA;IACpE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,YAAY;AACpE;;;;"}

package/dist/general.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Extracts the first value from an array or returns the value itself if it's not an array.
+ *
+ * - If `value` is an array, returns the first element.
+ * - If `value` is not an array, returns `value` directly.
+ * - If the result is `null` or `undefined`, and `defaultValue` is provided, returns `defaultValue` instead.
+ *
+ * @template T - The type of the input value(s).
+ * @template D - The type of the default value (if provided).
+ *
+ * @param {T | T[]} value - A single value or an array of values.
+ * @param {D} [defaultValue] - A fallback value if the result is `null` or `undefined`.
+ * @returns {T | D | undefined} The first value or the fallback.
+ *
+ * @example
+ * ```typescript
+ * import { extractFirstValue } from '@kikiutils/shared/general';
+ *
+ * console.log(extractFirstValue([1, 2, 3])); // 1
+ * console.log(extractFirstValue('hello'));  // hello
+ * console.log(extractFirstValue([], 'default')); // default
+ * console.log(extractFirstValue(undefined, 'fallback')); // fallback
+ * ```
+ */
+export declare function extractFirstValue<T>(value: T | T[]): T | undefined;
+export declare function extractFirstValue<T, D>(value: T | T[], defaultValue: D): D | NonNullable<T>;
+//# sourceMappingURL=general.d.ts.map

package/dist/general.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"general.d.ts","sourceRoot":"","sources":["../src/general.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC;AACpE,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC"}

package/dist/general.mjs

@@ -0,0 +1,6 @@
+function extractFirstValue(value, defaultValue) {
+    return (Array.isArray(value) ? value[0] : value) ?? defaultValue;
+}
+
+export { extractFirstValue };
+//# sourceMappingURL=general.mjs.map

package/dist/general.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"general.mjs","sources":["../src/general.ts"],"sourcesContent":["/**\n * Extracts the first value from an array or returns the value itself if it's not an array.\n *\n * - If `value` is an array, returns the first element.\n * - If `value` is not an array, returns `value` directly.\n * - If the result is `null` or `undefined`, and `defaultValue` is provided, returns `defaultValue` instead.\n *\n * @template T - The type of the input value(s).\n * @template D - The type of the default value (if provided).\n *\n * @param {T | T[]} value - A single value or an array of values.\n * @param {D} [defaultValue] - A fallback value if the result is `null` or `undefined`.\n * @returns {T | D | undefined} The first value or the fallback.\n *\n * @example\n * ```typescript\n * import { extractFirstValue } from '@kikiutils/shared/general';\n *\n * console.log(extractFirstValue([1, 2, 3])); // 1\n * console.log(extractFirstValue('hello'));  // hello\n * console.log(extractFirstValue([], 'default')); // default\n * console.log(extractFirstValue(undefined, 'fallback')); // fallback\n * ```\n */\nexport function extractFirstValue<T>(value: T | T[]): T | undefined;\nexport function extractFirstValue<T, D>(value: T | T[], defaultValue: D): D | NonNullable<T>;\nexport function extractFirstValue<T, D>(value: T | T[], defaultValue?: D) {\n    return (Array.isArray(value) ? value[0] : value) ?? defaultValue;\n}\n"],"names":[],"mappings":"AA0BgB,SAAA,iBAAiB,CAAO,KAAc,EAAE,YAAgB,EAAA;IACpE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,YAAY;AACpE;;;;"}