@kikiutils/shared 15.0.1 → 15.0.2

package/README.md

@@ -9,8 +9,6 @@ A lightweight and modular utility library for modern JavaScript and TypeScript
 
 - [✨ Release Notes](./CHANGELOG.md)
 
-TODO: update README
-
 ## Features
 
 - 📋 Clipboard utilities — copy text and blobs using the modern Clipboard API (Browser only)
@@ -47,17 +45,58 @@ You can also use `yarn`, `npm`, or `bun`.
 >
 > If a utility depends on a third-party package (e.g. `date-fns`), you must install it manually.
 
-## Usage
+## Modules
 
-Import the functions or modules you want to use:
+```
+src/
+├── classes/           # Class-based utilities
+│   ├── path.ts        # Path manipulation
+│   ├── precision-number.ts # Decimal.js wrapper
+│   └── ssh-client.ts  # SSH client
+│
+├── storages/
+│   ├── lru/keyed-store.ts    # LRU cache wrapper
+│   └── redis/
+│       ├── keyed-store.ts     # Redis keyed store
+│       ├── msgpack.ts         # Redis + msgpack
+│       └── types.ts           # Storage interfaces
+│
+└── *.ts              # Utility functions (see table)
+```
+
+| File | Description |
+|------|-------------|
+| `buffer.ts` | Binary → Node.js Buffer |
+| `clipboard.ts` | Clipboard API (browser) |
+| `consola.ts` | Consola logger |
+| `crypto-hash.ts` | MD5, SHA3 (Node) |
+| `datetime.ts` | date-fns wrappers |
+| `element-plus.ts` | Element Plus form rules |
+| `enum.ts` | Enum value extractors |
+| `env.ts` | Env var accessor |
+| `event-awaiter.ts` | Async event wait |
+| `general.ts` | extractFirstValue |
+| `hash.ts` | SHA3 (browser) |
+| `math.ts` | toPercentageString |
+| `number.ts` | toCompactNumberString |
+| `object.ts` | deterministic stringify |
+| `pino.ts` | Pino logger |
+| `random.ts` | nested random length |
+| `string.ts` | randomString |
+| `time.ts` | abortableDelay |
+| `url.ts` | redirect param |
+| `vue.ts` | Vue composables |
+| `web.ts` | Web DOM helpers |
+
+## Usage
 
 ```typescript
-import { logger } from '@kikituils/shared/consola';
-import { extractFirstValue } from '@kikituils/shared/general';
+import { logger } from '@kikiutils/shared/consola';
+import { extractFirstValue } from '@kikiutils/shared/general';
 
 const data = [
     0,
-    1
+    1,
 ];
 
 const value = extractFirstValue(data);
@@ -65,118 +104,6 @@ console.log(value); // 0
 logger.info(value);
 ```
 
-## Modules & Functions
-
-Each module file includes function-level comments and usage examples.
-
-### [buffer](./src/buffer.ts)
-
-- `toBuffer`
-
-### [clipboard](./src/clipboard.ts)
-
-- `copyBlobToClipboard`
-- `copyTextToClipboard`
-
-### [consola](./src/consola.ts)
-
-Console logger integration.
-
-### [crypto-hash](./src/crypto-hash.ts)
-
-- `cryptoMd5`, `cryptoMd5ToBuffer`
-- `cryptoSha3224`, `cryptoSha3224ToBuffer`
-- `cryptoSha3256`, `cryptoSha3256ToBuffer`
-- `cryptoSha3384`, `cryptoSha3384ToBuffer`
-- `cryptoSha3512`, `cryptoSha3512ToBuffer`
-
-### [datetime](./src/datetime.ts)
-
-- `formatDate`
-- `getDateRangeFromDate`
-- `getMidnightDateFromToday`
-
-### [element-plus](./src/element-plus.ts)
-
-- `createElFormItemRuleWithDefaults`
-
-### [enum](./src/enum.ts)
-
-- `getEnumStringValues`
-- `getEnumNumberValues`
-- `getEnumValues`
-
-### [env](./src/env.ts)
-
-- `checkAndGetEnvValue`
-
-### [general](./src/general.ts)
-
-- `extractFirstValue`
-
-### [hash](./src/hash.ts)
-
-- `sha3224`
-- `sha3256`
-- `sha3384`
-- `sha3512`
-
-### [math](./src/math.ts)
-
-- `toPercentageString`
-
-### [number](./src/number.ts)
-
-- `toCompactNumberString`
-
-### [object](./src/object.ts)
-
-- `stringifyObjectDeterministically`
-
-### [pino](./src/pino.ts)
-
-Pino logger integration.
-
-### [random](./src/random.ts)
-
-- `generateWithNestedRandomLength`
-
-### storage
-
-#### [enhanced-local](./src/storage/enhanced/local/index.ts)
-
-- `createKeyedEnhancedLocalStore`
-- `enhancedLocalStorage`
-
-#### [enhanced-redis](./src/storage/enhanced/redis/index.ts)
-
-- `createEnhancedRedisStorage`
-- `createKeyedEnhancedRedisStore`
-
-#### [lru/keyed-store](./src/storage/lru/keyed-store.ts)
-
-- `createKeyedLruStore`
-
-### [string](./src/string.ts)
-
-- `randomString`
-
-### [url](./src/url.ts)
-
-- `appendRedirectParamToUrl`
-
-### [vue](./src/vue.ts)
-
-- `appendRedirectParamFromCurrentRouteToUrl`
-- `clearIntervalRef`
-- `clearTimeoutRef`
-- `usePreserveScroll`
-
-### [web](./src/web.ts)
-
-- `appendRedirectParamFromCurrentLocationToUrl`
-- `assignUrlWithRedirectParamFromCurrentLocation`
-
 ## License
 
 [MIT License](./LICENSE)

package/dist/crypto-hash.d.ts

@@ -1,15 +1,160 @@
 import { BinaryLike, BinaryToTextEncoding } from "node:crypto";
 
 //#region src/crypto-hash.d.ts
+/**
+ * Computes the MD5 hash of the given data.
+ *
+ * @param {BinaryLike} data - The input data to hash
+ * @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
+ *
+ * @returns {string | Buffer} The hash digest in the specified encoding
+ *
+ * @example
+ * ```typescript
+ * import { cryptoMd5 } from '@kikiutils/shared/crypto-hash';
+ *
+ * console.log(cryptoMd5('test')); // 33ed9a05a10b21f0...
+ * ```
+ */
 declare function cryptoMd5(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
+/**
+ * Computes the MD5 hash of the given data and returns the raw buffer.
+ *
+ * @param {BinaryLike} data - The input data to hash
+ *
+ * @returns {Buffer} The raw hash digest as a Buffer
+ *
+ * @example
+ * ```typescript
+ * import { cryptoMd5ToBuffer } from '@kikiutils/shared/crypto-hash';
+ *
+ * console.log(cryptoMd5ToBuffer('test')); // <Buffer 33 ed 9a ...>
+ * ```
+ */
 declare function cryptoMd5ToBuffer(data: BinaryLike): NonSharedBuffer;
+/**
+ * Computes the SHA-3 hash of the given data using the 224-bit digest.
+ *
+ * @param {BinaryLike} data - The input data to hash
+ * @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
+ *
+ * @returns {string | Buffer} The hash digest in the specified encoding
+ *
+ * @example
+ * ```typescript
+ * import { cryptoSha3224 } from '@kikiutils/shared/crypto-hash';
+ *
+ * console.log(cryptoSha3224('test')); // 0qW8FoqDcFmkpuqR9J3uT8YX...
+ * ```
+ */
 declare function cryptoSha3224(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
+/**
+ * Computes the SHA-3 hash of the given data using the 224-bit digest and returns the raw buffer.
+ *
+ * @param {BinaryLike} data - The input data to hash
+ *
+ * @returns {Buffer} The raw hash digest as a Buffer
+ *
+ * @example
+ * ```typescript
+ * import { cryptoSha3224ToBuffer } from '@kikiutils/shared/crypto-hash';
+ *
+ * console.log(cryptoSha3224ToBuffer('test')); // <Buffer 0q W8 Fo ...>
+ * ```
+ */
 declare function cryptoSha3224ToBuffer(data: BinaryLike): NonSharedBuffer;
+/**
+ * Computes the SHA-3 hash of the given data using the 256-bit digest.
+ *
+ * @param {BinaryLike} data - The input data to hash
+ * @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
+ *
+ * @returns {string | Buffer} The hash digest in the specified encoding
+ *
+ * @example
+ * ```typescript
+ * import { cryptoSha3256 } from '@kikiutils/shared/crypto-hash';
+ *
+ * console.log(cryptoSha3256('test')); // 36f028580bb02cc8272a9a020f4200e346e276ae664e45ee80745574e2f5ab80
+ * ```
+ */
 declare function cryptoSha3256(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
+/**
+ * Computes the SHA-3 hash of the given data using the 256-bit digest and returns the raw buffer.
+ *
+ * @param {BinaryLike} data - The input data to hash
+ *
+ * @returns {Buffer} The raw hash digest as a Buffer
+ *
+ * @example
+ * ```typescript
+ * import { cryptoSha3256ToBuffer } from '@kikiutils/shared/crypto-hash';
+ *
+ * console.log(cryptoSha3256ToBuffer('test')); // <Buffer 36 f0 28 ...>
+ * ```
+ */
 declare function cryptoSha3256ToBuffer(data: BinaryLike): NonSharedBuffer;
+/**
+ * Computes the SHA-3 hash of the given data using the 384-bit digest.
+ *
+ * @param {BinaryLike} data - The input data to hash
+ * @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
+ *
+ * @returns {string | Buffer} The hash digest in the specified encoding
+ *
+ * @example
+ * ```typescript
+ * import { cryptoSha3384 } from '@kikiutils/shared/crypto-hash';
+ *
+ * console.log(cryptoSha3384('test')); // 1Q2wQAYaZ4o8vWX5bEB2n3Y...
+ * ```
+ */
 declare function cryptoSha3384(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
+/**
+ * Computes the SHA-3 hash of the given data using the 384-bit digest and returns the raw buffer.
+ *
+ * @param {BinaryLike} data - The input data to hash
+ *
+ * @returns {Buffer} The raw hash digest as a Buffer
+ *
+ * @example
+ * ```typescript
+ * import { cryptoSha3384ToBuffer } from '@kikiutils/shared/crypto-hash';
+ *
+ * console.log(cryptoSha3384ToBuffer('test')); // <Buffer 1Q 2w QZ ...>
+ * ```
+ */
 declare function cryptoSha3384ToBuffer(data: BinaryLike): NonSharedBuffer;
+/**
+ * Computes the SHA-3 hash of the given data using the 512-bit digest.
+ *
+ * @param {BinaryLike} data - The input data to hash
+ * @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
+ *
+ * @returns {string | Buffer} The hash digest in the specified encoding
+ *
+ * @example
+ * ```typescript
+ * import { cryptoSha3512 } from '@kikiutils/shared/crypto-hash';
+ *
+ * console.log(cryptoSha3512('test')); // b_NQJ8FJBY9dIjm1q7...
+ * ```
+ */
 declare function cryptoSha3512(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
+/**
+ * Computes the SHA-3 hash of the given data using the 512-bit digest and returns the raw buffer.
+ *
+ * @param {BinaryLike} data - The input data to hash
+ *
+ * @returns {Buffer} The raw hash digest as a Buffer
+ *
+ * @example
+ * ```typescript
+ * import { cryptoSha3512ToBuffer } from '@kikiutils/shared/crypto-hash';
+ *
+ * console.log(cryptoSha3512ToBuffer('test')); // <Buffer b_ NQ ...>
+ * ```
+ */
 declare function cryptoSha3512ToBuffer(data: BinaryLike): NonSharedBuffer;
 //#endregion
 export { cryptoMd5, cryptoMd5ToBuffer, cryptoSha3224, cryptoSha3224ToBuffer, cryptoSha3256, cryptoSha3256ToBuffer, cryptoSha3384, cryptoSha3384ToBuffer, cryptoSha3512, cryptoSha3512ToBuffer };

package/dist/crypto-hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crypto-hash.d.ts","names":[],"sources":["../src/crypto-hash.ts"],"mappings":";;;iBAsBgB,SAAA,CAAU,IAAA,EAAM,UAAA,EAAY,cAAA,GAAgB,oBAAA;AAAA,iBAI5C,iBAAA,CAAkB,IAAA,EAAM,UAAA,GAAU,eAAA;AAAA,iBAIlC,aAAA,CAAc,IAAA,EAAM,UAAA,EAAY,cAAA,GAAgB,oBAAA;AAAA,iBAIhD,qBAAA,CAAsB,IAAA,EAAM,UAAA,GAAU,eAAA;AAAA,iBAItC,aAAA,CAAc,IAAA,EAAM,UAAA,EAAY,cAAA,GAAgB,oBAAA;AAAA,iBAIhD,qBAAA,CAAsB,IAAA,EAAM,UAAA,GAAU,eAAA;AAAA,iBAItC,aAAA,CAAc,IAAA,EAAM,UAAA,EAAY,cAAA,GAAgB,oBAAA;AAAA,iBAIhD,qBAAA,CAAsB,IAAA,EAAM,UAAA,GAAU,eAAA;AAAA,iBAItC,aAAA,CAAc,IAAA,EAAM,UAAA,EAAY,cAAA,GAAgB,oBAAA;AAAA,iBAIhD,qBAAA,CAAsB,IAAA,EAAM,UAAA,GAAU,eAAA"}
+{"version":3,"file":"crypto-hash.d.ts","names":[],"sources":["../src/crypto-hash.ts"],"mappings":";;;;;AAqBA;;;;;;;;;;AAkBA;;;iBAlBgB,SAAA,CAAU,IAAA,EAAM,UAAA,EAAY,cAAA,GAAgB,oBAAA;;;;;;AAqC5D;;;;;;;;;iBAnBgB,iBAAA,CAAkB,IAAA,EAAM,UAAA,GAAU,eAAA;AAqClD;;;;;;;;;AAmBA;;;;;;AAnBA,iBAlBgB,aAAA,CAAc,IAAA,EAAM,UAAA,EAAY,cAAA,GAAgB,oBAAA;;;;AAuDhE;;;;;;;;;AAmBA;;iBAxDgB,qBAAA,CAAsB,IAAA,EAAM,UAAA,GAAU,eAAA;;;;;;;;AA0EtD;;;;;;;;iBAvDgB,aAAA,CAAc,IAAA,EAAM,UAAA,EAAY,cAAA,GAAgB,oBAAA;AA0EhE;;;;;;;;;;AAkBA;;;;AAlBA,iBAxDgB,qBAAA,CAAsB,IAAA,EAAM,UAAA,GAAU,eAAA;;;;;;;;;;;;;;;;iBAmBtC,aAAA,CAAc,IAAA,EAAM,UAAA,EAAY,cAAA,GAAgB,oBAAA;;;;;;;;;;;;;;;iBAkBhD,qBAAA,CAAsB,IAAA,EAAM,UAAA,GAAU,eAAA;;;;;;;;;;;;;;;;iBAmBtC,aAAA,CAAc,IAAA,EAAM,UAAA,EAAY,cAAA,GAAgB,oBAAA;;;;;;;;;;;;;;;iBAkBhD,qBAAA,CAAsB,IAAA,EAAM,UAAA,GAAU,eAAA"}

package/dist/crypto-hash.js

@@ -1,47 +1,177 @@
 import { createHash } from "node:crypto";
 //#region src/crypto-hash.ts
 /**
-* This file provides a set of functions for creating hash digests using different algorithms and bit lengths.
-* It includes functions for generating SHA-3 hash digests with bit lengths of 224, 256, 384, and 512,
-* as well as a function for generating MD5 hash digests.
+* Computes the MD5 hash of the given data.
 *
-* These functions use the Node.js crypto module to generate the hashes.
-* Can only be used in Node.js/Deno/Bun runtimes.
+* @param {BinaryLike} data - The input data to hash
+* @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
+*
+* @returns {string | Buffer} The hash digest in the specified encoding
 *
 * @example
 * ```typescript
-* import { cryptoSha3256 } from '@kikiutils/shared/crypto-hash';
+* import { cryptoMd5 } from '@kikiutils/shared/crypto-hash';
 *
-* console.log(cryptoSha3256('test')); // 36f028580bb02cc8272a9a020f4200e346e276ae664e45ee80745574e2f5ab80
+* console.log(cryptoMd5('test')); // 33ed9a05a10b21f0...
 * ```
 */
 function cryptoMd5(data, outputEncoding = "hex") {
 	return createHash("md5").update(data).digest(outputEncoding);
 }
+/**
+* Computes the MD5 hash of the given data and returns the raw buffer.
+*
+* @param {BinaryLike} data - The input data to hash
+*
+* @returns {Buffer} The raw hash digest as a Buffer
+*
+* @example
+* ```typescript
+* import { cryptoMd5ToBuffer } from '@kikiutils/shared/crypto-hash';
+*
+* console.log(cryptoMd5ToBuffer('test')); // <Buffer 33 ed 9a ...>
+* ```
+*/
 function cryptoMd5ToBuffer(data) {
 	return createHash("md5").update(data).digest();
 }
+/**
+* Computes the SHA-3 hash of the given data using the 224-bit digest.
+*
+* @param {BinaryLike} data - The input data to hash
+* @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
+*
+* @returns {string | Buffer} The hash digest in the specified encoding
+*
+* @example
+* ```typescript
+* import { cryptoSha3224 } from '@kikiutils/shared/crypto-hash';
+*
+* console.log(cryptoSha3224('test')); // 0qW8FoqDcFmkpuqR9J3uT8YX...
+* ```
+*/
 function cryptoSha3224(data, outputEncoding = "hex") {
 	return createHash("sha3-224").update(data).digest(outputEncoding);
 }
+/**
+* Computes the SHA-3 hash of the given data using the 224-bit digest and returns the raw buffer.
+*
+* @param {BinaryLike} data - The input data to hash
+*
+* @returns {Buffer} The raw hash digest as a Buffer
+*
+* @example
+* ```typescript
+* import { cryptoSha3224ToBuffer } from '@kikiutils/shared/crypto-hash';
+*
+* console.log(cryptoSha3224ToBuffer('test')); // <Buffer 0q W8 Fo ...>
+* ```
+*/
 function cryptoSha3224ToBuffer(data) {
 	return createHash("sha3-224").update(data).digest();
 }
+/**
+* Computes the SHA-3 hash of the given data using the 256-bit digest.
+*
+* @param {BinaryLike} data - The input data to hash
+* @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
+*
+* @returns {string | Buffer} The hash digest in the specified encoding
+*
+* @example
+* ```typescript
+* import { cryptoSha3256 } from '@kikiutils/shared/crypto-hash';
+*
+* console.log(cryptoSha3256('test')); // 36f028580bb02cc8272a9a020f4200e346e276ae664e45ee80745574e2f5ab80
+* ```
+*/
 function cryptoSha3256(data, outputEncoding = "hex") {
 	return createHash("sha3-256").update(data).digest(outputEncoding);
 }
+/**
+* Computes the SHA-3 hash of the given data using the 256-bit digest and returns the raw buffer.
+*
+* @param {BinaryLike} data - The input data to hash
+*
+* @returns {Buffer} The raw hash digest as a Buffer
+*
+* @example
+* ```typescript
+* import { cryptoSha3256ToBuffer } from '@kikiutils/shared/crypto-hash';
+*
+* console.log(cryptoSha3256ToBuffer('test')); // <Buffer 36 f0 28 ...>
+* ```
+*/
 function cryptoSha3256ToBuffer(data) {
 	return createHash("sha3-256").update(data).digest();
 }
+/**
+* Computes the SHA-3 hash of the given data using the 384-bit digest.
+*
+* @param {BinaryLike} data - The input data to hash
+* @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
+*
+* @returns {string | Buffer} The hash digest in the specified encoding
+*
+* @example
+* ```typescript
+* import { cryptoSha3384 } from '@kikiutils/shared/crypto-hash';
+*
+* console.log(cryptoSha3384('test')); // 1Q2wQAYaZ4o8vWX5bEB2n3Y...
+* ```
+*/
 function cryptoSha3384(data, outputEncoding = "hex") {
 	return createHash("sha3-384").update(data).digest(outputEncoding);
 }
+/**
+* Computes the SHA-3 hash of the given data using the 384-bit digest and returns the raw buffer.
+*
+* @param {BinaryLike} data - The input data to hash
+*
+* @returns {Buffer} The raw hash digest as a Buffer
+*
+* @example
+* ```typescript
+* import { cryptoSha3384ToBuffer } from '@kikiutils/shared/crypto-hash';
+*
+* console.log(cryptoSha3384ToBuffer('test')); // <Buffer 1Q 2w QZ ...>
+* ```
+*/
 function cryptoSha3384ToBuffer(data) {
 	return createHash("sha3-384").update(data).digest();
 }
+/**
+* Computes the SHA-3 hash of the given data using the 512-bit digest.
+*
+* @param {BinaryLike} data - The input data to hash
+* @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)
+*
+* @returns {string | Buffer} The hash digest in the specified encoding
+*
+* @example
+* ```typescript
+* import { cryptoSha3512 } from '@kikiutils/shared/crypto-hash';
+*
+* console.log(cryptoSha3512('test')); // b_NQJ8FJBY9dIjm1q7...
+* ```
+*/
 function cryptoSha3512(data, outputEncoding = "hex") {
 	return createHash("sha3-512").update(data).digest(outputEncoding);
 }
+/**
+* Computes the SHA-3 hash of the given data using the 512-bit digest and returns the raw buffer.
+*
+* @param {BinaryLike} data - The input data to hash
+*
+* @returns {Buffer} The raw hash digest as a Buffer
+*
+* @example
+* ```typescript
+* import { cryptoSha3512ToBuffer } from '@kikiutils/shared/crypto-hash';
+*
+* console.log(cryptoSha3512ToBuffer('test')); // <Buffer b_ NQ ...>
+* ```
+*/
 function cryptoSha3512ToBuffer(data) {
 	return createHash("sha3-512").update(data).digest();
 }

package/dist/crypto-hash.js.map

@@ -1 +1 @@
-{"version":3,"file":"crypto-hash.js","names":[],"sources":["../src/crypto-hash.ts"],"sourcesContent":["/**\n * This file provides a set of functions for creating hash digests using different algorithms and bit lengths.\n * It includes functions for generating SHA-3 hash digests with bit lengths of 224, 256, 384, and 512,\n * as well as a function for generating MD5 hash digests.\n *\n * These functions use the Node.js crypto module to generate the hashes.\n * Can only be used in Node.js/Deno/Bun runtimes.\n *\n * @example\n * ```typescript\n * import { cryptoSha3256 } from '@kikiutils/shared/crypto-hash';\n *\n * console.log(cryptoSha3256('test')); // 36f028580bb02cc8272a9a020f4200e346e276ae664e45ee80745574e2f5ab80\n * ```\n */\n\nimport { createHash } from 'node:crypto';\nimport type {\n    BinaryLike,\n    BinaryToTextEncoding,\n} from 'node:crypto';\n\nexport function cryptoMd5(data: BinaryLike, outputEncoding: BinaryToTextEncoding = 'hex') {\n    return createHash('md5').update(data).digest(outputEncoding);\n}\n\nexport function cryptoMd5ToBuffer(data: BinaryLike) {\n    return createHash('md5').update(data).digest();\n}\n\nexport function cryptoSha3224(data: BinaryLike, outputEncoding: BinaryToTextEncoding = 'hex') {\n    return createHash('sha3-224').update(data).digest(outputEncoding);\n}\n\nexport function cryptoSha3224ToBuffer(data: BinaryLike) {\n    return createHash('sha3-224').update(data).digest();\n}\n\nexport function cryptoSha3256(data: BinaryLike, outputEncoding: BinaryToTextEncoding = 'hex') {\n    return createHash('sha3-256').update(data).digest(outputEncoding);\n}\n\nexport function cryptoSha3256ToBuffer(data: BinaryLike) {\n    return createHash('sha3-256').update(data).digest();\n}\n\nexport function cryptoSha3384(data: BinaryLike, outputEncoding: BinaryToTextEncoding = 'hex') {\n    return createHash('sha3-384').update(data).digest(outputEncoding);\n}\n\nexport function cryptoSha3384ToBuffer(data: BinaryLike) {\n    return createHash('sha3-384').update(data).digest();\n}\n\nexport function cryptoSha3512(data: BinaryLike, outputEncoding: BinaryToTextEncoding = 'hex') {\n    return createHash('sha3-512').update(data).digest(outputEncoding);\n}\n\nexport function cryptoSha3512ToBuffer(data: BinaryLike) {\n    return createHash('sha3-512').update(data).digest();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAsBA,SAAgB,UAAU,MAAkB,iBAAuC,OAAO;AACtF,QAAO,WAAW,MAAM,CAAC,OAAO,KAAK,CAAC,OAAO,eAAe;;AAGhE,SAAgB,kBAAkB,MAAkB;AAChD,QAAO,WAAW,MAAM,CAAC,OAAO,KAAK,CAAC,QAAQ;;AAGlD,SAAgB,cAAc,MAAkB,iBAAuC,OAAO;AAC1F,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,OAAO,eAAe;;AAGrE,SAAgB,sBAAsB,MAAkB;AACpD,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,QAAQ;;AAGvD,SAAgB,cAAc,MAAkB,iBAAuC,OAAO;AAC1F,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,OAAO,eAAe;;AAGrE,SAAgB,sBAAsB,MAAkB;AACpD,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,QAAQ;;AAGvD,SAAgB,cAAc,MAAkB,iBAAuC,OAAO;AAC1F,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,OAAO,eAAe;;AAGrE,SAAgB,sBAAsB,MAAkB;AACpD,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,QAAQ;;AAGvD,SAAgB,cAAc,MAAkB,iBAAuC,OAAO;AAC1F,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,OAAO,eAAe;;AAGrE,SAAgB,sBAAsB,MAAkB;AACpD,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,QAAQ"}
+{"version":3,"file":"crypto-hash.js","names":[],"sources":["../src/crypto-hash.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport type {\n    BinaryLike,\n    BinaryToTextEncoding,\n} from 'node:crypto';\n\n/**\n * Computes the MD5 hash of the given data.\n *\n * @param {BinaryLike} data - The input data to hash\n * @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)\n *\n * @returns {string | Buffer} The hash digest in the specified encoding\n *\n * @example\n * ```typescript\n * import { cryptoMd5 } from '@kikiutils/shared/crypto-hash';\n *\n * console.log(cryptoMd5('test')); // 33ed9a05a10b21f0...\n * ```\n */\nexport function cryptoMd5(data: BinaryLike, outputEncoding: BinaryToTextEncoding = 'hex') {\n    return createHash('md5').update(data).digest(outputEncoding);\n}\n\n/**\n * Computes the MD5 hash of the given data and returns the raw buffer.\n *\n * @param {BinaryLike} data - The input data to hash\n *\n * @returns {Buffer} The raw hash digest as a Buffer\n *\n * @example\n * ```typescript\n * import { cryptoMd5ToBuffer } from '@kikiutils/shared/crypto-hash';\n *\n * console.log(cryptoMd5ToBuffer('test')); // <Buffer 33 ed 9a ...>\n * ```\n */\nexport function cryptoMd5ToBuffer(data: BinaryLike) {\n    return createHash('md5').update(data).digest();\n}\n\n/**\n * Computes the SHA-3 hash of the given data using the 224-bit digest.\n *\n * @param {BinaryLike} data - The input data to hash\n * @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)\n *\n * @returns {string | Buffer} The hash digest in the specified encoding\n *\n * @example\n * ```typescript\n * import { cryptoSha3224 } from '@kikiutils/shared/crypto-hash';\n *\n * console.log(cryptoSha3224('test')); // 0qW8FoqDcFmkpuqR9J3uT8YX...\n * ```\n */\nexport function cryptoSha3224(data: BinaryLike, outputEncoding: BinaryToTextEncoding = 'hex') {\n    return createHash('sha3-224').update(data).digest(outputEncoding);\n}\n\n/**\n * Computes the SHA-3 hash of the given data using the 224-bit digest and returns the raw buffer.\n *\n * @param {BinaryLike} data - The input data to hash\n *\n * @returns {Buffer} The raw hash digest as a Buffer\n *\n * @example\n * ```typescript\n * import { cryptoSha3224ToBuffer } from '@kikiutils/shared/crypto-hash';\n *\n * console.log(cryptoSha3224ToBuffer('test')); // <Buffer 0q W8 Fo ...>\n * ```\n */\nexport function cryptoSha3224ToBuffer(data: BinaryLike) {\n    return createHash('sha3-224').update(data).digest();\n}\n\n/**\n * Computes the SHA-3 hash of the given data using the 256-bit digest.\n *\n * @param {BinaryLike} data - The input data to hash\n * @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)\n *\n * @returns {string | Buffer} The hash digest in the specified encoding\n *\n * @example\n * ```typescript\n * import { cryptoSha3256 } from '@kikiutils/shared/crypto-hash';\n *\n * console.log(cryptoSha3256('test')); // 36f028580bb02cc8272a9a020f4200e346e276ae664e45ee80745574e2f5ab80\n * ```\n */\nexport function cryptoSha3256(data: BinaryLike, outputEncoding: BinaryToTextEncoding = 'hex') {\n    return createHash('sha3-256').update(data).digest(outputEncoding);\n}\n\n/**\n * Computes the SHA-3 hash of the given data using the 256-bit digest and returns the raw buffer.\n *\n * @param {BinaryLike} data - The input data to hash\n *\n * @returns {Buffer} The raw hash digest as a Buffer\n *\n * @example\n * ```typescript\n * import { cryptoSha3256ToBuffer } from '@kikiutils/shared/crypto-hash';\n *\n * console.log(cryptoSha3256ToBuffer('test')); // <Buffer 36 f0 28 ...>\n * ```\n */\nexport function cryptoSha3256ToBuffer(data: BinaryLike) {\n    return createHash('sha3-256').update(data).digest();\n}\n\n/**\n * Computes the SHA-3 hash of the given data using the 384-bit digest.\n *\n * @param {BinaryLike} data - The input data to hash\n * @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)\n *\n * @returns {string | Buffer} The hash digest in the specified encoding\n *\n * @example\n * ```typescript\n * import { cryptoSha3384 } from '@kikiutils/shared/crypto-hash';\n *\n * console.log(cryptoSha3384('test')); // 1Q2wQAYaZ4o8vWX5bEB2n3Y...\n * ```\n */\nexport function cryptoSha3384(data: BinaryLike, outputEncoding: BinaryToTextEncoding = 'hex') {\n    return createHash('sha3-384').update(data).digest(outputEncoding);\n}\n\n/**\n * Computes the SHA-3 hash of the given data using the 384-bit digest and returns the raw buffer.\n *\n * @param {BinaryLike} data - The input data to hash\n *\n * @returns {Buffer} The raw hash digest as a Buffer\n *\n * @example\n * ```typescript\n * import { cryptoSha3384ToBuffer } from '@kikiutils/shared/crypto-hash';\n *\n * console.log(cryptoSha3384ToBuffer('test')); // <Buffer 1Q 2w QZ ...>\n * ```\n */\nexport function cryptoSha3384ToBuffer(data: BinaryLike) {\n    return createHash('sha3-384').update(data).digest();\n}\n\n/**\n * Computes the SHA-3 hash of the given data using the 512-bit digest.\n *\n * @param {BinaryLike} data - The input data to hash\n * @param {BinaryToTextEncoding} [outputEncoding] - The output encoding (default: `'hex'`)\n *\n * @returns {string | Buffer} The hash digest in the specified encoding\n *\n * @example\n * ```typescript\n * import { cryptoSha3512 } from '@kikiutils/shared/crypto-hash';\n *\n * console.log(cryptoSha3512('test')); // b_NQJ8FJBY9dIjm1q7...\n * ```\n */\nexport function cryptoSha3512(data: BinaryLike, outputEncoding: BinaryToTextEncoding = 'hex') {\n    return createHash('sha3-512').update(data).digest(outputEncoding);\n}\n\n/**\n * Computes the SHA-3 hash of the given data using the 512-bit digest and returns the raw buffer.\n *\n * @param {BinaryLike} data - The input data to hash\n *\n * @returns {Buffer} The raw hash digest as a Buffer\n *\n * @example\n * ```typescript\n * import { cryptoSha3512ToBuffer } from '@kikiutils/shared/crypto-hash';\n *\n * console.log(cryptoSha3512ToBuffer('test')); // <Buffer b_ NQ ...>\n * ```\n */\nexport function cryptoSha3512ToBuffer(data: BinaryLike) {\n    return createHash('sha3-512').update(data).digest();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAqBA,SAAgB,UAAU,MAAkB,iBAAuC,OAAO;AACtF,QAAO,WAAW,MAAM,CAAC,OAAO,KAAK,CAAC,OAAO,eAAe;;;;;;;;;;;;;;;;AAiBhE,SAAgB,kBAAkB,MAAkB;AAChD,QAAO,WAAW,MAAM,CAAC,OAAO,KAAK,CAAC,QAAQ;;;;;;;;;;;;;;;;;AAkBlD,SAAgB,cAAc,MAAkB,iBAAuC,OAAO;AAC1F,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,OAAO,eAAe;;;;;;;;;;;;;;;;AAiBrE,SAAgB,sBAAsB,MAAkB;AACpD,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,QAAQ;;;;;;;;;;;;;;;;;AAkBvD,SAAgB,cAAc,MAAkB,iBAAuC,OAAO;AAC1F,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,OAAO,eAAe;;;;;;;;;;;;;;;;AAiBrE,SAAgB,sBAAsB,MAAkB;AACpD,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,QAAQ;;;;;;;;;;;;;;;;;AAkBvD,SAAgB,cAAc,MAAkB,iBAAuC,OAAO;AAC1F,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,OAAO,eAAe;;;;;;;;;;;;;;;;AAiBrE,SAAgB,sBAAsB,MAAkB;AACpD,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,QAAQ;;;;;;;;;;;;;;;;;AAkBvD,SAAgB,cAAc,MAAkB,iBAAuC,OAAO;AAC1F,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,OAAO,eAAe;;;;;;;;;;;;;;;;AAiBrE,SAAgB,sBAAsB,MAAkB;AACpD,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,QAAQ"}

package/dist/datetime.d.ts

@@ -26,8 +26,6 @@ type DateRangeType = 'lastMonth' | 'lastWeek' | 'thisMonth' | 'thisWeek' | 'toda
  * // 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
  */
 declare function formatDate(date: DateArg<Date> & {}, format?: string, options?: FormatOptions): string;
 /**

package/dist/datetime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"datetime.d.ts","names":[],"sources":["../src/datetime.ts"],"mappings":";;;KAkBY,aAAA;;AAAZ;;;;;AA6BA;;;;;;;;;;;;;;;;AA+BA;;;;;iBA/BgB,UAAA,CAAW,IAAA,EAAM,OAAA,CAAQ,IAAA,QAAY,MAAA,WAAwC,OAAA,GAAU,aAAA;;;;;;;;;;;;;;;;;;;AAwGvG;;;;;;;;;iBAzEgB,oBAAA,CACZ,IAAA,EAAM,IAAA,EACN,IAAA,EAAM,aAAA,EACN,OAAA;EACI,wBAAA;EACA,YAAA,GAAe,GAAA;AAAA;;;;;;;;;;;;;;;;;;;;iBAoEP,wBAAA,CAAyB,UAAA,YAAsB,IAAA"}
+{"version":3,"file":"datetime.d.ts","names":[],"sources":["../src/datetime.ts"],"mappings":";;;KAkBY,aAAA;;AAAZ;;;;;AA2BA;;;;;;;;;;;;;;;;AA+BA;;;iBA/BgB,UAAA,CAAW,IAAA,EAAM,OAAA,CAAQ,IAAA,QAAY,MAAA,WAAwC,OAAA,GAAU,aAAA;;;;;;;;;;;;;;;;;;;;;AAwGvG;;;;;;;iBAzEgB,oBAAA,CACZ,IAAA,EAAM,IAAA,EACN,IAAA,EAAM,aAAA,EACN,OAAA;EACI,wBAAA;EACA,YAAA,GAAe,GAAA;AAAA;;;;;;;;;;;;;;;;;;;;iBAoEP,wBAAA,CAAyB,UAAA,YAAsB,IAAA"}

package/dist/datetime.js

@@ -24,8 +24,6 @@ import { endOfDay, endOfMonth, endOfWeek, format, startOfDay, startOfMonth, star
 * // 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);

package/dist/datetime.js.map

@@ -1 +1 @@
-{"version":3,"file":"datetime.js","names":["dateFnsFormat","format"],"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 *\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 *\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 *\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"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,SAAgB,WAAW,MAA0B,WAAiB,uBAAuB,SAAyB;AAClH,QAAOA,OAAc,MAAMC,UAAQ,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8B/C,SAAgB,qBACZ,MACA,MACA,SAIF;CACE,IAAI;CACJ,IAAI;AACJ,SAAQ,MAAR;EACI,KAAK;GACD;IACI,MAAM,YAAY,UAAU,MAAM,EAAE;AACpC,cAAU,WAAW,UAAU;AAC/B,gBAAY,aAAa,UAAU;;AAGvC;EACJ,KAAK;GACD;IACI,MAAM,WAAW,SAAS,MAAM,EAAE;AAClC,cAAU,UAAU,UAAU,EAAE,cAAc,SAAS,gBAAgB,GAAG,CAAC;AAC3E,gBAAY,YAAY,UAAU,EAAE,cAAc,SAAS,gBAAgB,GAAG,CAAC;;AAGnF;EACJ,KAAK;AACD,aAAU,WAAW,KAAK;AAC1B,eAAY,aAAa,KAAK;AAC9B;EACJ,KAAK;AACD,aAAU,UAAU,MAAM,EAAE,cAAc,SAAS,gBAAgB,GAAG,CAAC;AACvE,eAAY,YAAY,MAAM,EAAE,cAAc,SAAS,gBAAgB,GAAG,CAAC;AAC3E;EACJ,KAAK;AACD,aAAU,SAAS,KAAK;AACxB,eAAY,WAAW,KAAK;AAC5B;EACJ,KAAK;GACD;IACI,MAAM,YAAY,QAAQ,MAAM,EAAE;AAClC,cAAU,SAAS,UAAU;AAC7B,gBAAY,WAAW,UAAU;;AAGrC;EACJ,QAAS,OAAM,IAAI,MAAM,gCAAgC,OAAO;;AAGpE,KAAI,SAAS,yBAA0B,SAAQ,SAAS,IAAI,GAAG,GAAG,EAAE;AACpE,QAAO;EACH;EACA;EACH;;;;;;;;;;;;;;;;;;AAmBL,SAAgB,yBAAyB,aAAqB,GAAG;CAC7D,MAAM,uBAAO,IAAI,MAAM;AACvB,MAAK,QAAQ,KAAK,SAAS,GAAG,WAAW;AACzC,MAAK,SAAS,GAAG,GAAG,GAAG,EAAE;AACzB,QAAO"}
+{"version":3,"file":"datetime.js","names":["dateFnsFormat","format"],"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 *\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 */\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 *\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 *\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"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,SAAgB,WAAW,MAA0B,WAAiB,uBAAuB,SAAyB;AAClH,QAAOA,OAAc,MAAMC,UAAQ,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8B/C,SAAgB,qBACZ,MACA,MACA,SAIF;CACE,IAAI;CACJ,IAAI;AACJ,SAAQ,MAAR;EACI,KAAK;GACD;IACI,MAAM,YAAY,UAAU,MAAM,EAAE;AACpC,cAAU,WAAW,UAAU;AAC/B,gBAAY,aAAa,UAAU;;AAGvC;EACJ,KAAK;GACD;IACI,MAAM,WAAW,SAAS,MAAM,EAAE;AAClC,cAAU,UAAU,UAAU,EAAE,cAAc,SAAS,gBAAgB,GAAG,CAAC;AAC3E,gBAAY,YAAY,UAAU,EAAE,cAAc,SAAS,gBAAgB,GAAG,CAAC;;AAGnF;EACJ,KAAK;AACD,aAAU,WAAW,KAAK;AAC1B,eAAY,aAAa,KAAK;AAC9B;EACJ,KAAK;AACD,aAAU,UAAU,MAAM,EAAE,cAAc,SAAS,gBAAgB,GAAG,CAAC;AACvE,eAAY,YAAY,MAAM,EAAE,cAAc,SAAS,gBAAgB,GAAG,CAAC;AAC3E;EACJ,KAAK;AACD,aAAU,SAAS,KAAK;AACxB,eAAY,WAAW,KAAK;AAC5B;EACJ,KAAK;GACD;IACI,MAAM,YAAY,QAAQ,MAAM,EAAE;AAClC,cAAU,SAAS,UAAU;AAC7B,gBAAY,WAAW,UAAU;;AAGrC;EACJ,QAAS,OAAM,IAAI,MAAM,gCAAgC,OAAO;;AAGpE,KAAI,SAAS,yBAA0B,SAAQ,SAAS,IAAI,GAAG,GAAG,EAAE;AACpE,QAAO;EACH;EACA;EACH;;;;;;;;;;;;;;;;;;AAmBL,SAAgB,yBAAyB,aAAqB,GAAG;CAC7D,MAAM,uBAAO,IAAI,MAAM;AACvB,MAAK,QAAQ,KAAK,SAAS,GAAG,WAAW;AACzC,MAAK,SAAS,GAAG,GAAG,GAAG,EAAE;AACzB,QAAO"}

package/dist/env.d.ts

@@ -29,6 +29,8 @@ declare class EnvironmentNotFoundError extends Error {
  *
  * @example
  * ```typescript
+ * import { checkAndGetEnvValue } from '@kikiutils/shared/env';
+ *
  * process.env.API_KEY = '';
  * checkAndGetEnvValue('API_KEY'); // ✅ Returns '' (still considered "defined")
  *

package/dist/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","names":[],"sources":["../src/env.ts"],"mappings":";;AAOA;;;;;;cAAa,wBAAA,SAAiC,KAAA;EAAA,SACjC,GAAA;EAOc;;AA6B3B;;;cA7BgB,GAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;iBA6BA,mBAAA,CAAoB,GAAA"}
+{"version":3,"file":"env.d.ts","names":[],"sources":["../src/env.ts"],"mappings":";;AAOA;;;;;;cAAa,wBAAA,SAAiC,KAAA;EAAA,SACjC,GAAA;EAOc;;AA+B3B;;;cA/BgB,GAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;iBA+BA,mBAAA,CAAoB,GAAA"}

package/dist/env.js

@@ -34,6 +34,8 @@ var EnvironmentNotFoundError = class extends Error {
 *
 * @example
 * ```typescript
+* import { checkAndGetEnvValue } from '@kikiutils/shared/env';
+*
 * process.env.API_KEY = '';
 * checkAndGetEnvValue('API_KEY'); // ✅ Returns '' (still considered "defined")
 *

package/dist/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","names":[],"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 it is not defined.\n *\n * Only checks for `process.env[key] === undefined`. An empty string (e.g. '') or any falsy string\n * value like `'0'` or `'false'` is considered a valid (defined) value.\n *\n * @param {string} key - The environment variable key to retrieve\n *\n * @returns {string} The value of the environment variable\n *\n * @throws {EnvironmentNotFoundError} If the environment variable is not defined\n *\n * @example\n * ```typescript\n * process.env.API_KEY = '';\n * checkAndGetEnvValue('API_KEY'); // ✅ Returns '' (still considered \"defined\")\n *\n * delete process.env.API_KEY;\n * checkAndGetEnvValue('API_KEY'); // ❌ Throws EnvironmentNotFoundError\n * ```\n */\nexport function checkAndGetEnvValue(key: string) {\n    if (process.env[key] === undefined) throw new EnvironmentNotFoundError(key);\n    return process.env[key];\n}\n"],"mappings":";;;;;;;;AAOA,IAAa,2BAAb,cAA8C,MAAM;CAChD;;;;;;CAOA,YAAY,KAAa;AACrB,QAAM,iCAAiC,MAAM;AAC7C,OAAK,MAAM;AACX,OAAK,OAAO,KAAK,YAAY;AAC7B,QAAM,oBAAoB,MAAM,KAAK,YAAY;;;;;;;;;;;;;;;;;;;;;;;;AAyBzD,SAAgB,oBAAoB,KAAa;AAC7C,KAAI,QAAQ,IAAI,SAAS,KAAA,EAAW,OAAM,IAAI,yBAAyB,IAAI;AAC3E,QAAO,QAAQ,IAAI"}
+{"version":3,"file":"env.js","names":[],"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 it is not defined.\n *\n * Only checks for `process.env[key] === undefined`. An empty string (e.g. '') or any falsy string\n * value like `'0'` or `'false'` is considered a valid (defined) value.\n *\n * @param {string} key - The environment variable key to retrieve\n *\n * @returns {string} The value of the environment variable\n *\n * @throws {EnvironmentNotFoundError} If the environment variable is not defined\n *\n * @example\n * ```typescript\n * import { checkAndGetEnvValue } from '@kikiutils/shared/env';\n *\n * process.env.API_KEY = '';\n * checkAndGetEnvValue('API_KEY'); // ✅ Returns '' (still considered \"defined\")\n *\n * delete process.env.API_KEY;\n * checkAndGetEnvValue('API_KEY'); // ❌ Throws EnvironmentNotFoundError\n * ```\n */\nexport function checkAndGetEnvValue(key: string) {\n    if (process.env[key] === undefined) throw new EnvironmentNotFoundError(key);\n    return process.env[key];\n}\n"],"mappings":";;;;;;;;AAOA,IAAa,2BAAb,cAA8C,MAAM;CAChD;;;;;;CAOA,YAAY,KAAa;AACrB,QAAM,iCAAiC,MAAM;AAC7C,OAAK,MAAM;AACX,OAAK,OAAO,KAAK,YAAY;AAC7B,QAAM,oBAAoB,MAAM,KAAK,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BzD,SAAgB,oBAAoB,KAAa;AAC7C,KAAI,QAAQ,IAAI,SAAS,KAAA,EAAW,OAAM,IAAI,yBAAyB,IAAI;AAC3E,QAAO,QAAQ,IAAI"}