typetify 2.4.0 → 4.0.2

package/dist/datetime/index.d.ts

@@ -0,0 +1,320 @@
+/**
+ * Date input type - accepts Date, timestamp, or ISO string.
+ */
+type DateInput = Date | number | string;
+/**
+ * Converts any date input to a Date object.
+ *
+ * @example
+ * toDate('2024-01-15');
+ * // => Date object
+ *
+ * @example
+ * toDate(1705276800000);
+ * // => Date object
+ */
+declare function toDate(input: DateInput): Date;
+/**
+ * Formats a date using a format string.
+ *
+ * Tokens:
+ * - YYYY: 4-digit year
+ * - YY: 2-digit year
+ * - MM: 2-digit month
+ * - M: month
+ * - DD: 2-digit day
+ * - D: day
+ * - HH: 2-digit hour (24h)
+ * - H: hour (24h)
+ * - hh: 2-digit hour (12h)
+ * - h: hour (12h)
+ * - mm: 2-digit minutes
+ * - m: minutes
+ * - ss: 2-digit seconds
+ * - s: seconds
+ * - SSS: milliseconds
+ * - A: AM/PM
+ * - a: am/pm
+ *
+ * @example
+ * formatDate(new Date('2024-01-15T14:30:00'), 'YYYY-MM-DD');
+ * // => '2024-01-15'
+ *
+ * @example
+ * formatDate(new Date('2024-01-15T14:30:00'), 'DD/MM/YYYY HH:mm');
+ * // => '15/01/2024 14:30'
+ *
+ * @example
+ * formatDate(new Date('2024-01-15T14:30:00'), 'hh:mm A');
+ * // => '02:30 PM'
+ */
+declare function formatDate(input: DateInput, format: string): string;
+/**
+ * Formats a date as ISO string (YYYY-MM-DD).
+ *
+ * @example
+ * toISODateString(new Date('2024-01-15T14:30:00'));
+ * // => '2024-01-15'
+ */
+declare function toISODateString(input: DateInput): string;
+/**
+ * Formats a date as ISO datetime string.
+ *
+ * @example
+ * toISOString(new Date('2024-01-15T14:30:00'));
+ * // => '2024-01-15T14:30:00.000Z'
+ */
+declare function toISOString(input: DateInput): string;
+/**
+ * Formats a date as Unix timestamp (seconds).
+ *
+ * @example
+ * toUnixTimestamp(new Date('2024-01-15T00:00:00Z'));
+ * // => 1705276800
+ */
+declare function toUnixTimestamp(input: DateInput): number;
+/**
+ * Creates a Date from Unix timestamp (seconds).
+ *
+ * @example
+ * fromUnixTimestamp(1705276800);
+ * // => Date('2024-01-15T00:00:00Z')
+ */
+declare function fromUnixTimestamp(timestamp: number): Date;
+
+/**
+ * Duration unit type.
+ */
+type DurationUnit = 'milliseconds' | 'seconds' | 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years';
+/**
+ * Adds time to a date.
+ *
+ * @example
+ * addTime(new Date('2024-01-15'), 1, 'days');
+ * // => Date('2024-01-16')
+ *
+ * @example
+ * addTime(new Date('2024-01-15'), 2, 'weeks');
+ * // => Date('2024-01-29')
+ *
+ * @example
+ * addTime(new Date('2024-01-15T10:00:00'), 30, 'minutes');
+ * // => Date('2024-01-15T10:30:00')
+ */
+declare function addTime(input: DateInput, value: number, unit: DurationUnit): Date;
+/**
+ * Subtracts time from a date.
+ *
+ * @example
+ * subtractTime(new Date('2024-01-15'), 1, 'days');
+ * // => Date('2024-01-14')
+ */
+declare function subtractTime(input: DateInput, value: number, unit: DurationUnit): Date;
+/**
+ * Gets the start of a time unit.
+ *
+ * @example
+ * startOf(new Date('2024-01-15T14:30:45'), 'day');
+ * // => Date('2024-01-15T00:00:00')
+ *
+ * @example
+ * startOf(new Date('2024-01-15T14:30:45'), 'month');
+ * // => Date('2024-01-01T00:00:00')
+ *
+ * @example
+ * startOf(new Date('2024-01-15T14:30:45'), 'hour');
+ * // => Date('2024-01-15T14:00:00')
+ */
+declare function startOf(input: DateInput, unit: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year'): Date;
+/**
+ * Gets the end of a time unit.
+ *
+ * @example
+ * endOf(new Date('2024-01-15T14:30:45'), 'day');
+ * // => Date('2024-01-15T23:59:59.999')
+ *
+ * @example
+ * endOf(new Date('2024-01-15'), 'month');
+ * // => Date('2024-01-31T23:59:59.999')
+ */
+declare function endOf(input: DateInput, unit: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year'): Date;
+/**
+ * Gets the difference between two dates.
+ *
+ * @example
+ * diff(new Date('2024-01-15'), new Date('2024-01-10'), 'days');
+ * // => 5
+ *
+ * @example
+ * diff(new Date('2024-03-01'), new Date('2024-01-01'), 'months');
+ * // => 2
+ */
+declare function diff(date1: DateInput, date2: DateInput, unit: DurationUnit): number;
+
+/**
+ * Checks if a date is before another date.
+ *
+ * @example
+ * isBefore(new Date('2024-01-10'), new Date('2024-01-15'));
+ * // => true
+ */
+declare function isBefore(date1: DateInput, date2: DateInput): boolean;
+/**
+ * Checks if a date is after another date.
+ *
+ * @example
+ * isAfter(new Date('2024-01-15'), new Date('2024-01-10'));
+ * // => true
+ */
+declare function isAfter(date1: DateInput, date2: DateInput): boolean;
+/**
+ * Checks if two dates are the same.
+ *
+ * @example
+ * isSameDate(new Date('2024-01-15'), new Date('2024-01-15'));
+ * // => true
+ */
+declare function isSameDate(date1: DateInput, date2: DateInput): boolean;
+/**
+ * Checks if two dates are on the same day.
+ *
+ * @example
+ * isSameDay(new Date('2024-01-15T10:00'), new Date('2024-01-15T20:00'));
+ * // => true
+ */
+declare function isSameDay(date1: DateInput, date2: DateInput): boolean;
+/**
+ * Checks if a date is between two dates.
+ *
+ * @example
+ * isBetween(new Date('2024-01-15'), new Date('2024-01-10'), new Date('2024-01-20'));
+ * // => true
+ */
+declare function isBetween(date: DateInput, start: DateInput, end: DateInput): boolean;
+/**
+ * Checks if a date is today.
+ *
+ * @example
+ * isToday(new Date());
+ * // => true
+ */
+declare function isToday(input: DateInput): boolean;
+/**
+ * Checks if a date is yesterday.
+ *
+ * @example
+ * isYesterday(new Date(Date.now() - 86400000));
+ * // => true
+ */
+declare function isYesterday(input: DateInput): boolean;
+/**
+ * Checks if a date is tomorrow.
+ *
+ * @example
+ * isTomorrow(new Date(Date.now() + 86400000));
+ * // => true
+ */
+declare function isTomorrow(input: DateInput): boolean;
+/**
+ * Checks if a date is in the past.
+ *
+ * @example
+ * isPast(new Date('2020-01-01'));
+ * // => true
+ */
+declare function isPast(input: DateInput): boolean;
+/**
+ * Checks if a date is in the future.
+ *
+ * @example
+ * isFuture(new Date('2030-01-01'));
+ * // => true
+ */
+declare function isFuture(input: DateInput): boolean;
+/**
+ * Checks if a year is a leap year.
+ *
+ * @example
+ * isLeapYear(2024);
+ * // => true
+ *
+ * @example
+ * isLeapYear(2023);
+ * // => false
+ */
+declare function isLeapYear(year: number): boolean;
+/**
+ * Checks if a date is a weekend (Saturday or Sunday).
+ *
+ * @example
+ * isWeekend(new Date('2024-01-13')); // Saturday
+ * // => true
+ */
+declare function isWeekend(input: DateInput): boolean;
+/**
+ * Checks if a date is a weekday (Monday to Friday).
+ *
+ * @example
+ * isWeekday(new Date('2024-01-15')); // Monday
+ * // => true
+ */
+declare function isWeekday(input: DateInput): boolean;
+
+/**
+ * Relative time options.
+ */
+interface RelativeTimeOptions {
+    locale?: string;
+    style?: 'long' | 'short' | 'narrow';
+}
+/**
+ * Gets relative time string (e.g., "2 days ago", "in 3 hours").
+ *
+ * @example
+ * timeAgo(new Date(Date.now() - 60000));
+ * // => '1 minute ago'
+ *
+ * @example
+ * timeAgo(new Date(Date.now() - 3600000));
+ * // => '1 hour ago'
+ *
+ * @example
+ * timeAgo(new Date(Date.now() + 86400000));
+ * // => 'in 1 day'
+ *
+ * @example
+ * // With French locale
+ * timeAgo(new Date(Date.now() - 86400000), { locale: 'fr' });
+ * // => 'il y a 1 jour'
+ */
+declare function timeAgo(input: DateInput, options?: RelativeTimeOptions): string;
+/**
+ * Gets a human-readable duration string.
+ *
+ * @example
+ * formatDuration(3661000);
+ * // => '1h 1m 1s'
+ *
+ * @example
+ * formatDuration(86400000);
+ * // => '1d'
+ *
+ * @example
+ * formatDuration(90061000);
+ * // => '1d 1h 1m 1s'
+ */
+declare function formatDuration(ms: number): string;
+/**
+ * Parses a duration string to milliseconds.
+ *
+ * @example
+ * parseDuration('1h 30m');
+ * // => 5400000
+ *
+ * @example
+ * parseDuration('2d 12h');
+ * // => 216000000
+ */
+declare function parseDuration(duration: string): number;
+
+export { type DateInput, type DurationUnit, type RelativeTimeOptions, addTime, diff, endOf, formatDate, formatDuration, fromUnixTimestamp, isAfter, isBefore, isBetween, isFuture, isLeapYear, isPast, isSameDate, isSameDay, isToday, isTomorrow, isWeekday, isWeekend, isYesterday, parseDuration, startOf, subtractTime, timeAgo, toDate, toISODateString, toISOString, toUnixTimestamp };

package/dist/datetime/index.js

@@ -0,0 +1 @@
+'use strict';var chunkCX7GJR55_js=require('../chunk-CX7GJR55.js');require('../chunk-WOT6VMZA.js');Object.defineProperty(exports,"addTime",{enumerable:true,get:function(){return chunkCX7GJR55_js.g}});Object.defineProperty(exports,"diff",{enumerable:true,get:function(){return chunkCX7GJR55_js.k}});Object.defineProperty(exports,"endOf",{enumerable:true,get:function(){return chunkCX7GJR55_js.j}});Object.defineProperty(exports,"formatDate",{enumerable:true,get:function(){return chunkCX7GJR55_js.b}});Object.defineProperty(exports,"formatDuration",{enumerable:true,get:function(){return chunkCX7GJR55_js.z}});Object.defineProperty(exports,"fromUnixTimestamp",{enumerable:true,get:function(){return chunkCX7GJR55_js.f}});Object.defineProperty(exports,"isAfter",{enumerable:true,get:function(){return chunkCX7GJR55_js.m}});Object.defineProperty(exports,"isBefore",{enumerable:true,get:function(){return chunkCX7GJR55_js.l}});Object.defineProperty(exports,"isBetween",{enumerable:true,get:function(){return chunkCX7GJR55_js.p}});Object.defineProperty(exports,"isFuture",{enumerable:true,get:function(){return chunkCX7GJR55_js.u}});Object.defineProperty(exports,"isLeapYear",{enumerable:true,get:function(){return chunkCX7GJR55_js.v}});Object.defineProperty(exports,"isPast",{enumerable:true,get:function(){return chunkCX7GJR55_js.t}});Object.defineProperty(exports,"isSameDate",{enumerable:true,get:function(){return chunkCX7GJR55_js.n}});Object.defineProperty(exports,"isSameDay",{enumerable:true,get:function(){return chunkCX7GJR55_js.o}});Object.defineProperty(exports,"isToday",{enumerable:true,get:function(){return chunkCX7GJR55_js.q}});Object.defineProperty(exports,"isTomorrow",{enumerable:true,get:function(){return chunkCX7GJR55_js.s}});Object.defineProperty(exports,"isWeekday",{enumerable:true,get:function(){return chunkCX7GJR55_js.x}});Object.defineProperty(exports,"isWeekend",{enumerable:true,get:function(){return chunkCX7GJR55_js.w}});Object.defineProperty(exports,"isYesterday",{enumerable:true,get:function(){return chunkCX7GJR55_js.r}});Object.defineProperty(exports,"parseDuration",{enumerable:true,get:function(){return chunkCX7GJR55_js.A}});Object.defineProperty(exports,"startOf",{enumerable:true,get:function(){return chunkCX7GJR55_js.i}});Object.defineProperty(exports,"subtractTime",{enumerable:true,get:function(){return chunkCX7GJR55_js.h}});Object.defineProperty(exports,"timeAgo",{enumerable:true,get:function(){return chunkCX7GJR55_js.y}});Object.defineProperty(exports,"toDate",{enumerable:true,get:function(){return chunkCX7GJR55_js.a}});Object.defineProperty(exports,"toISODateString",{enumerable:true,get:function(){return chunkCX7GJR55_js.c}});Object.defineProperty(exports,"toISOString",{enumerable:true,get:function(){return chunkCX7GJR55_js.d}});Object.defineProperty(exports,"toUnixTimestamp",{enumerable:true,get:function(){return chunkCX7GJR55_js.e}});

package/dist/datetime/index.mjs

@@ -0,0 +1 @@
+export{g as addTime,k as diff,j as endOf,b as formatDate,z as formatDuration,f as fromUnixTimestamp,m as isAfter,l as isBefore,p as isBetween,u as isFuture,v as isLeapYear,t as isPast,n as isSameDate,o as isSameDay,q as isToday,s as isTomorrow,x as isWeekday,w as isWeekend,r as isYesterday,A as parseDuration,i as startOf,h as subtractTime,y as timeAgo,a as toDate,c as toISODateString,d as toISOString,e as toUnixTimestamp}from'../chunk-X6JSYVIW.mjs';import'../chunk-JZXLCA2E.mjs';

package/dist/encrypt/index.d.mts

@@ -0,0 +1,208 @@
+/**
+ * Hash algorithm type.
+ */
+type HashAlgorithm = 'SHA-1' | 'SHA-256' | 'SHA-384' | 'SHA-512';
+/**
+ * Hashes a string using the specified algorithm.
+ *
+ * @example
+ * await hash('hello world', 'SHA-256');
+ * // => 'b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9'
+ *
+ * @example
+ * await hash('password123', 'SHA-512');
+ * // => '...' (128 character hex string)
+ */
+declare function hash(data: string, algorithm?: HashAlgorithm): Promise<string>;
+/**
+ * Hashes a string using SHA-256.
+ *
+ * @example
+ * await sha256('hello world');
+ * // => 'b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9'
+ */
+declare function sha256(data: string): Promise<string>;
+/**
+ * Hashes a string using SHA-512.
+ *
+ * @example
+ * await sha512('hello world');
+ * // => '...' (128 character hex string)
+ */
+declare function sha512(data: string): Promise<string>;
+/**
+ * Creates an HMAC signature.
+ *
+ * @example
+ * await hmac('message', 'secret-key', 'SHA-256');
+ * // => '...' (hex string)
+ *
+ * @example
+ * // Verify webhook signature
+ * const signature = await hmac(payload, webhookSecret);
+ * if (signature === receivedSignature) {
+ *   // Valid signature
+ * }
+ */
+declare function hmac(data: string, key: string, algorithm?: HashAlgorithm): Promise<string>;
+/**
+ * Compares two strings in constant time to prevent timing attacks.
+ *
+ * @example
+ * const isValid = timingSafeEqual(providedHash, expectedHash);
+ */
+declare function timingSafeEqual(a: string, b: string): boolean;
+
+/**
+ * Generates a random UUID (v4).
+ *
+ * @example
+ * uuid();
+ * // => 'f47ac10b-58cc-4372-a567-0e02b2c3d479'
+ */
+declare function uuid(): string;
+/**
+ * Generates random bytes as a hex string.
+ *
+ * @example
+ * randomBytes(16);
+ * // => '1a2b3c4d5e6f7890abcdef1234567890'
+ *
+ * @example
+ * // Generate a secure token
+ * const token = randomBytes(32);
+ */
+declare function randomBytes(length: number): string;
+/**
+ * Generates a random string with specified characters.
+ *
+ * @example
+ * randomString(16);
+ * // => 'aB3xY9kLmN2pQrSt'
+ *
+ * @example
+ * // Custom alphabet
+ * randomString(8, '0123456789');
+ * // => '48291037'
+ *
+ * @example
+ * // Generate a password
+ * randomString(16, 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!@#$%');
+ */
+declare function randomString(length: number, alphabet?: string): string;
+/**
+ * Generates a random integer between min and max (inclusive).
+ *
+ * @example
+ * randomInt(1, 100);
+ * // => 42
+ *
+ * @example
+ * // Generate a random dice roll
+ * randomInt(1, 6);
+ * // => 4
+ */
+declare function randomInt(min: number, max: number): number;
+/**
+ * Generates a secure token suitable for authentication.
+ *
+ * @example
+ * generateToken();
+ * // => 'a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6'
+ *
+ * @example
+ * generateToken(64);
+ * // => '...' (64 character token)
+ */
+declare function generateToken(length?: number): string;
+/**
+ * Generates a URL-safe random string (base64url).
+ *
+ * @example
+ * urlSafeToken(32);
+ * // => 'xY9kLmN2pQrSt_aB3-Y9kLmN2pQrSt'
+ */
+declare function urlSafeToken(length: number): string;
+
+/**
+ * Encodes a string to base64.
+ *
+ * @example
+ * base64Encode('Hello, World!');
+ * // => 'SGVsbG8sIFdvcmxkIQ=='
+ */
+declare function base64Encode(data: string): string;
+/**
+ * Decodes a base64 string.
+ *
+ * @example
+ * base64Decode('SGVsbG8sIFdvcmxkIQ==');
+ * // => 'Hello, World!'
+ */
+declare function base64Decode(data: string): string;
+/**
+ * Encodes a string to URL-safe base64.
+ *
+ * @example
+ * base64UrlEncode('Hello, World!');
+ * // => 'SGVsbG8sIFdvcmxkIQ'
+ */
+declare function base64UrlEncode(data: string): string;
+/**
+ * Decodes a URL-safe base64 string.
+ *
+ * @example
+ * base64UrlDecode('SGVsbG8sIFdvcmxkIQ');
+ * // => 'Hello, World!'
+ */
+declare function base64UrlDecode(data: string): string;
+/**
+ * Converts a string to hex.
+ *
+ * @example
+ * stringToHex('Hello');
+ * // => '48656c6c6f'
+ */
+declare function stringToHex(str: string): string;
+/**
+ * Converts hex to a string.
+ *
+ * @example
+ * hexToString('48656c6c6f');
+ * // => 'Hello'
+ */
+declare function hexToString(hex: string): string;
+/**
+ * Converts a Uint8Array to hex string.
+ *
+ * @example
+ * bytesToHex(new Uint8Array([72, 101, 108, 108, 111]));
+ * // => '48656c6c6f'
+ */
+declare function bytesToHex(bytes: Uint8Array): string;
+/**
+ * Converts a hex string to Uint8Array.
+ *
+ * @example
+ * hexToBytes('48656c6c6f');
+ * // => Uint8Array([72, 101, 108, 108, 111])
+ */
+declare function hexToBytes(hex: string): Uint8Array;
+/**
+ * Encodes a string to UTF-8 bytes.
+ *
+ * @example
+ * utf8Encode('Hello');
+ * // => Uint8Array([72, 101, 108, 108, 111])
+ */
+declare function utf8Encode(str: string): Uint8Array;
+/**
+ * Decodes UTF-8 bytes to a string.
+ *
+ * @example
+ * utf8Decode(new Uint8Array([72, 101, 108, 108, 111]));
+ * // => 'Hello'
+ */
+declare function utf8Decode(bytes: Uint8Array): string;
+
+export { type HashAlgorithm, base64Decode, base64Encode, base64UrlDecode, base64UrlEncode, bytesToHex, generateToken, hash, hexToBytes, hexToString, hmac, randomBytes, randomInt, randomString, sha256, sha512, stringToHex, timingSafeEqual, urlSafeToken, utf8Decode, utf8Encode, uuid };