typetify 2.4.0 → 4.0.2

package/CHANGELOG.md

@@ -5,6 +5,47 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.0.0] - 2026-02-07
+
+### Added
+- **HTTP Module** (Backend Focus): 18 functions for type-safe HTTP requests
+  - `request`, `get`, `post`, `put`, `patch`, `del` - HTTP methods with typed responses
+  - `buildUrl` - URL construction with query parameters
+  - `createHttpClient` - Configurable HTTP client with interceptors
+  - `requestWithRetry`, `withRetry` - Automatic retry with exponential backoff
+  - `HttpHeaders`, `ContentTypes` - Common HTTP constants
+  - `parseAuthHeader`, `bearerAuth`, `basicAuth` - Authentication helpers
+  - `parseCookieHeader`, `buildCookieHeader`, `mergeHeaders` - Header utilities
+
+- **DateTime Module** (Backend Focus): 26 functions for date manipulation
+  - `toDate`, `formatDate`, `toISODateString`, `toISOString` - Date formatting
+  - `toUnixTimestamp`, `fromUnixTimestamp` - Unix timestamp conversion
+  - `addTime`, `subtractTime`, `startOf`, `endOf`, `diff` - Date manipulation
+  - `isBefore`, `isAfter`, `isSameDate`, `isSameDay`, `isBetween` - Date comparison
+  - `isToday`, `isYesterday`, `isTomorrow`, `isPast`, `isFuture` - Relative checks
+  - `isLeapYear`, `isWeekend`, `isWeekday` - Date utilities
+  - `timeAgo`, `formatDuration`, `parseDuration` - Human-readable durations
+
+- **Path Module** (Backend Focus): 14 functions for path manipulation
+  - `parsePath`, `dirname`, `basename`, `extname` - Path parsing
+  - `joinPath`, `resolvePath`, `relativePath` - Path joining
+  - `normalizePath`, `isAbsolute`, `toPosix`, `toWindows` - Path normalization
+  - `removeTrailingSlash`, `ensureTrailingSlash`, `commonPath` - Path utilities
+
+- **Crypto Module** (Backend Focus): 20 functions for cryptography
+  - `hash`, `sha256`, `sha512`, `hmac` - Hashing functions
+  - `timingSafeEqual` - Timing-safe string comparison
+  - `uuid`, `randomBytes`, `randomString`, `randomInt` - Random generation
+  - `generateToken`, `urlSafeToken` - Token generation
+  - `base64Encode`, `base64Decode`, `base64UrlEncode`, `base64UrlDecode` - Base64 encoding
+  - `stringToHex`, `hexToString`, `bytesToHex`, `hexToBytes` - Hex encoding
+  - `utf8Encode`, `utf8Decode` - UTF-8 encoding
+
+### Changed
+- Added HTTP, DateTime, Path, and Crypto modules to namespace `_`
+- Updated documentation with all new backend-focused utilities
+- **BREAKING**: Major version bump to 3.0.0
+
 ## [2.4.0] - 2026-02-07
 
 ### Added

package/README.md

@@ -61,8 +61,9 @@ Boring, predictable API. No config, no setup, just functions that work.
 | Type narrowing | ❌ | ❌ | ✅ |
 | Zero dependencies | ❌ | ✅ | ✅ |
 | Tree-shakable | ⚠️ | ✅ | ✅ |
-| Bundle size | 72KB | 51KB | **~15KB** |
 | Modern syntax | ❌ | ⚠️ | ✅ |
+| Frontend utilities | ❌ | ❌ | ✅ |
+| Backend utilities | ❌ | ❌ | ✅ |
 
 ## Installation
 
@@ -404,6 +405,125 @@ type MergedConfig = Merge<DefaultConfig, UserConfig>
 
 ## Real-World Examples
 
+### 🎨 Frontend Focus
+
+```typescript
+import { 
+  // DOM
+  querySelector, classNames, addEventListener, isInViewport,
+  // Storage
+  localStorageTyped, withExpiry, getCookie,
+  // Color
+  lighten, darken, getContrastColor, opacity
+} from 'typetify'
+
+// Type-safe DOM manipulation
+const button = querySelector<HTMLButtonElement>('#submit')
+if (button) {
+  button.className = classNames('btn', { 'btn-primary': isPrimary, 'btn-disabled': disabled })
+}
+
+// Event handling with automatic cleanup
+const cleanup = addEventListener(button, 'click', () => {
+  console.log('Clicked!')
+})
+// Later: cleanup()
+
+// Lazy loading with viewport detection
+const images = querySelectorAll<HTMLImageElement>('img[data-src]')
+images.forEach(img => {
+  if (isInViewport(img)) {
+    img.src = img.dataset.src!
+  }
+})
+
+// Type-safe localStorage
+interface UserPrefs {
+  theme: 'light' | 'dark'
+  language: string
+}
+const prefs = localStorageTyped<UserPrefs>('user-prefs')
+prefs.set({ theme: 'dark', language: 'en' })
+const theme = prefs.get()?.theme // 'dark' | 'light' | undefined
+
+// Storage with expiration
+const cache = withExpiry<ApiResponse>('api-cache', {
+  storage: sessionStorage,
+  ttl: 5 * 60 * 1000 // 5 minutes
+})
+
+// Dynamic theming with color utilities
+const primaryColor = '#3b82f6'
+const hoverColor = lighten(primaryColor, 10)
+const activeColor = darken(primaryColor, 10)
+const textColor = getContrastColor(primaryColor) // '#ffffff' or '#000000'
+const overlay = opacity('#000000', 0.5) // 'rgba(0, 0, 0, 0.5)'
+```
+
+### 🔧 Backend Focus
+
+```typescript
+import {
+  // HTTP
+  createHttpClient, requestWithRetry, bearerAuth, buildUrl,
+  // DateTime
+  formatDate, addTime, timeAgo, isBetween, parseDuration,
+  // Path
+  joinPath, parsePath, normalizePath, relativePath,
+  // Crypto
+  sha256, hmac, uuid, generateToken, base64Encode
+} from 'typetify'
+
+// Type-safe HTTP client with interceptors
+const api = createHttpClient({
+  baseUrl: 'https://api.example.com',
+  timeout: 5000,
+  headers: { Authorization: bearerAuth(token) },
+  interceptors: {
+    request: (opts) => {
+      opts.headers = { ...opts.headers, 'X-Request-Id': uuid() }
+      return opts
+    }
+  }
+})
+
+const users = await api.get<User[]>('/users')
+const user = await api.post<User>('/users', { body: { name: 'John' } })
+
+// Retry with exponential backoff
+const data = await requestWithRetry<Data>('/api/data', {
+  maxRetries: 3,
+  delay: 1000,
+  backoff: 'exponential'
+})
+
+// Date manipulation
+const now = new Date()
+const nextWeek = addTime(now, 7, 'days')
+const formatted = formatDate(now, 'YYYY-MM-DD HH:mm')
+console.log(timeAgo(lastLogin)) // '2 hours ago'
+
+// Check booking availability
+if (isBetween(requestedDate, bookingStart, bookingEnd)) {
+  allowBooking()
+}
+
+// Parse duration strings
+const ttl = parseDuration('2h 30m') // 9000000 (ms)
+
+// Cross-platform path handling
+const configPath = joinPath('/etc', 'app', 'config.json')
+const { name, ext } = parsePath('/var/log/app.log') // { name: 'app', ext: '.log' }
+const normalized = normalizePath('/home/user/../admin/./file.txt') // '/home/admin/file.txt'
+
+// Cryptographic utilities
+const hashedPassword = await sha256(password + salt)
+const signature = await hmac(payload, webhookSecret)
+const sessionId = uuid()
+const apiKey = generateToken(32)
+const encoded = base64Encode(JSON.stringify(data))
+```
+
 ### API Response Validation
 
 ```typescript

package/dist/chunk-C5X2N4X4.js

@@ -0,0 +1,2 @@
+'use strict';var chunkWOT6VMZA_js=require('./chunk-WOT6VMZA.js');var j={};chunkWOT6VMZA_js.a(j,{basename:()=>p,commonPath:()=>w,dirname:()=>f,ensureTrailingSlash:()=>v,extname:()=>d,isAbsolute:()=>W,joinPath:()=>h,normalizePath:()=>x,parsePath:()=>g,relativePath:()=>P,removeTrailingSlash:()=>b,resolvePath:()=>m,toPosix:()=>z,toWindows:()=>A});function g(t){let a=t.includes("\\")||/^[A-Za-z]:/.test(t),e=a?"\\":"/",s=t.replace(/\\/g,e).replace(/\//g,e),o="";a&&/^[A-Za-z]:/.test(s)?o=s.slice(0,3):s.startsWith(e)&&(o=e);let r=s.lastIndexOf(e),n=r===-1?s:s.slice(r+1),i=r===-1?"":s.slice(0,r)||o,l=n.lastIndexOf("."),u=l>0?n.slice(l):"",c=l>0?n.slice(0,l):n;return {root:o,dir:i,base:n,ext:u,name:c}}function f(t){return g(t).dir||"."}function p(t,a){let e=g(t);return a&&e.base.endsWith(a)?e.base.slice(0,-a.length):e.base}function d(t){return g(t).ext}function h(...t){if(t.length===0)return ".";let e=t.some(l=>l.includes("\\")||/^[A-Za-z]:/.test(l))?"\\":"/",s=[];for(let l of t){if(!l)continue;let c=l.replace(/[\\/]+/g,e).split(e).filter(Boolean);s.push(...c);}let o=t[0]??"",r=o.startsWith("/")||o.startsWith("\\"),n=/^[A-Za-z]:/.test(o),i=s.join(e);return n?i=o.slice(0,2)+e+i.slice(i.indexOf(e)+1||i.length):r&&(i=e+i),i||"."}function m(...t){let e=t.some(n=>n.includes("\\")||/^[A-Za-z]:/.test(n))?"\\":"/",s=[],o=false;for(let n of t){if(!n)continue;let i=n.replace(/[\\/]+/g,e),l=i.split(e);(i.startsWith(e)||/^[A-Za-z]:/.test(i))&&(s.length=0,o=true);for(let c of l)c===""||c==="."||(c===".."?s.pop():s.push(c));}let r=s.join(e);return o?e+r:r||"."}function P(t,a){let e=t.includes("\\")||a.includes("\\")?"\\":"/",s=t.replace(/[\\/]+/g,e).split(e).filter(Boolean),o=a.replace(/[\\/]+/g,e).split(e).filter(Boolean),r=0,n=Math.min(s.length,o.length);for(let c=0;c<n&&s[c]===o[c];c++)r++;let i=s.length-r,l=o.slice(r);return [...Array(i).fill(".."),...l].join(e)||"."}function x(t){if(!t)return ".";let a=t.includes("\\")||/^[A-Za-z]:/.test(t),e=a?"\\":"/",s=t.replace(/[\\/]+/g,e),o=s.startsWith(e)||/^[A-Za-z]:/.test(s),r=s.split(e),n=[];for(let l of r)l===""||l==="."||(l===".."?n.length>0&&n[n.length-1]!==".."?n.pop():o||n.push(".."):n.push(l));let i=n.join(e);return o&&(a&&/^[A-Za-z]:/.test(t)?i=t.slice(0,2)+e+i:i=e+i),i||"."}function W(t){return t.startsWith("/")||t.startsWith("\\")||/^[A-Za-z]:/.test(t)}function z(t){return t.replace(/\\/g,"/")}function A(t){return t.replace(/\//g,"\\")}function b(t){return t==="/"||t==="\\"?t:t.replace(/[\\/]+$/,"")}function v(t){let a=t.includes("\\")?"\\":"/";return t.endsWith("/")||t.endsWith("\\")?t:t+a}function w(t){if(t.length===0)return "";if(t.length===1)return t[0];let a=t[0].includes("\\")?"\\":"/",e=t.map(r=>r.replace(/[\\/]+/g,a).split(a)),s=Math.min(...e.map(r=>r.length)),o=[];for(let r=0;r<s;r++){let n=e[0][r];if(e.every(i=>i[r]===n))o.push(n);else break}return o.join(a)||""}
+exports.a=g;exports.b=f;exports.c=p;exports.d=d;exports.e=h;exports.f=m;exports.g=P;exports.h=x;exports.i=W;exports.j=z;exports.k=A;exports.l=b;exports.m=v;exports.n=w;exports.o=j;

package/dist/chunk-CX7GJR55.js

@@ -0,0 +1 @@
+'use strict';var chunkWOT6VMZA_js=require('./chunk-WOT6VMZA.js');var z={};chunkWOT6VMZA_js.a(z,{addTime:()=>h,diff:()=>Y,endOf:()=>k,formatDate:()=>d,formatDuration:()=>j,fromUnixTimestamp:()=>I,isAfter:()=>O,isBefore:()=>F,isBetween:()=>U,isFuture:()=>P,isLeapYear:()=>W,isPast:()=>B,isSameDate:()=>H,isSameDay:()=>D,isToday:()=>R,isTomorrow:()=>v,isWeekday:()=>$,isWeekend:()=>b,isYesterday:()=>A,parseDuration:()=>C,startOf:()=>S,subtractTime:()=>T,timeAgo:()=>L,toDate:()=>o,toISODateString:()=>M,toISOString:()=>x,toUnixTimestamp:()=>y});function o(t){return t instanceof Date?t:typeof t=="number"?new Date(t):new Date(t)}function d(t,n){let r=o(t),e=(m,p=2)=>String(m).padStart(p,"0"),a=r.getHours(),s=a%12||12,i=a>=12,f={YYYY:String(r.getFullYear()),YY:String(r.getFullYear()).slice(-2),MM:e(r.getMonth()+1),M:String(r.getMonth()+1),DD:e(r.getDate()),D:String(r.getDate()),HH:e(a),H:String(a),hh:e(s),h:String(s),mm:e(r.getMinutes()),m:String(r.getMinutes()),ss:e(r.getSeconds()),s:String(r.getSeconds()),SSS:e(r.getMilliseconds(),3),A:i?"PM":"AM",a:i?"pm":"am"},c=n;for(let[m,p]of Object.entries(f).sort((g,l)=>l[0].length-g[0].length))c=c.replace(new RegExp(m,"g"),p);return c}function M(t){return d(t,"YYYY-MM-DD")}function x(t){return o(t).toISOString()}function y(t){return Math.floor(o(t).getTime()/1e3)}function I(t){return new Date(t*1e3)}function w(t,n){return t*{milliseconds:1,seconds:1e3,minutes:6e4,hours:36e5,days:864e5,weeks:6048e5,months:2592e6,years:31536e6}[n]}function h(t,n,r){let e=o(t);if(r==="months"){let a=new Date(e);return a.setMonth(a.getMonth()+n),a}if(r==="years"){let a=new Date(e);return a.setFullYear(a.getFullYear()+n),a}return new Date(e.getTime()+w(n,r))}function T(t,n,r){return h(t,-n,r)}function S(t,n){let r=o(t),e=new Date(r);switch(n){case "second":e.setMilliseconds(0);break;case "minute":e.setSeconds(0,0);break;case "hour":e.setMinutes(0,0,0);break;case "day":e.setHours(0,0,0,0);break;case "week":e.setHours(0,0,0,0),e.setDate(e.getDate()-e.getDay());break;case "month":e.setHours(0,0,0,0),e.setDate(1);break;case "year":e.setHours(0,0,0,0),e.setMonth(0,1);break}return e}function k(t,n){let r=o(t),e=new Date(r);switch(n){case "second":e.setMilliseconds(999);break;case "minute":e.setSeconds(59,999);break;case "hour":e.setMinutes(59,59,999);break;case "day":e.setHours(23,59,59,999);break;case "week":e.setHours(23,59,59,999),e.setDate(e.getDate()+(6-e.getDay()));break;case "month":e.setMonth(e.getMonth()+1,0),e.setHours(23,59,59,999);break;case "year":e.setMonth(11,31),e.setHours(23,59,59,999);break}return e}function Y(t,n,r){let e=o(t),a=o(n);if(r==="months")return (e.getFullYear()-a.getFullYear())*12+(e.getMonth()-a.getMonth());if(r==="years")return e.getFullYear()-a.getFullYear();let s=e.getTime()-a.getTime();return Math.floor(s/w(1,r))}function F(t,n){return o(t).getTime()<o(n).getTime()}function O(t,n){return o(t).getTime()>o(n).getTime()}function H(t,n){return o(t).getTime()===o(n).getTime()}function D(t,n){let r=o(t),e=o(n);return r.getFullYear()===e.getFullYear()&&r.getMonth()===e.getMonth()&&r.getDate()===e.getDate()}function U(t,n,r){let e=o(t).getTime();return e>=o(n).getTime()&&e<=o(r).getTime()}function R(t){return D(t,new Date)}function A(t){let n=new Date;return n.setDate(n.getDate()-1),D(t,n)}function v(t){let n=new Date;return n.setDate(n.getDate()+1),D(t,n)}function B(t){return o(t).getTime()<Date.now()}function P(t){return o(t).getTime()>Date.now()}function W(t){return t%4===0&&t%100!==0||t%400===0}function b(t){let n=o(t).getDay();return n===0||n===6}function $(t){return !b(t)}function L(t,n={}){let{locale:r="en",style:e="long"}=n,a=o(t),s=Date.now(),i=a.getTime()-s,f=Math.round(i/1e3),c=Math.round(i/6e4),m=Math.round(i/36e5),p=Math.round(i/864e5),g=Math.round(i/6048e5),l=Math.round(i/2592e6),E=Math.round(i/31536e6),u=new Intl.RelativeTimeFormat(r,{style:e});return Math.abs(f)<60?u.format(f,"second"):Math.abs(c)<60?u.format(c,"minute"):Math.abs(m)<24?u.format(m,"hour"):Math.abs(p)<7?u.format(p,"day"):Math.abs(g)<4?u.format(g,"week"):Math.abs(l)<12?u.format(l,"month"):u.format(E,"year")}function j(t){let n=Math.floor(t/1e3),r=Math.floor(n/60),e=Math.floor(r/60),a=Math.floor(e/24),s=[];return a>0&&s.push(`${a}d`),e%24>0&&s.push(`${e%24}h`),r%60>0&&s.push(`${r%60}m`),(n%60>0||s.length===0)&&s.push(`${n%60}s`),s.join(" ")}function C(t){let n={ms:1,s:1e3,m:6e4,h:36e5,d:864e5,w:6048e5},r=0,e=/(\d+)\s*(ms|s|m|h|d|w)/gi,a;for(;(a=e.exec(t))!==null;){let s=parseInt(a[1],10),i=a[2].toLowerCase();r+=s*(n[i]??0);}return r}exports.A=C;exports.B=z;exports.a=o;exports.b=d;exports.c=M;exports.d=x;exports.e=y;exports.f=I;exports.g=h;exports.h=T;exports.i=S;exports.j=k;exports.k=Y;exports.l=F;exports.m=O;exports.n=H;exports.o=D;exports.p=U;exports.q=R;exports.r=A;exports.s=v;exports.t=B;exports.u=P;exports.v=W;exports.w=b;exports.x=$;exports.y=L;exports.z=j;

package/dist/chunk-H7MLD632.mjs

@@ -0,0 +1,2 @@
+import {a}from'./chunk-JZXLCA2E.mjs';var j={};a(j,{basename:()=>p,commonPath:()=>w,dirname:()=>f,ensureTrailingSlash:()=>v,extname:()=>d,isAbsolute:()=>W,joinPath:()=>h,normalizePath:()=>x,parsePath:()=>g,relativePath:()=>P,removeTrailingSlash:()=>b,resolvePath:()=>m,toPosix:()=>z,toWindows:()=>A});function g(t){let a=t.includes("\\")||/^[A-Za-z]:/.test(t),e=a?"\\":"/",s=t.replace(/\\/g,e).replace(/\//g,e),o="";a&&/^[A-Za-z]:/.test(s)?o=s.slice(0,3):s.startsWith(e)&&(o=e);let r=s.lastIndexOf(e),n=r===-1?s:s.slice(r+1),i=r===-1?"":s.slice(0,r)||o,l=n.lastIndexOf("."),u=l>0?n.slice(l):"",c=l>0?n.slice(0,l):n;return {root:o,dir:i,base:n,ext:u,name:c}}function f(t){return g(t).dir||"."}function p(t,a){let e=g(t);return a&&e.base.endsWith(a)?e.base.slice(0,-a.length):e.base}function d(t){return g(t).ext}function h(...t){if(t.length===0)return ".";let e=t.some(l=>l.includes("\\")||/^[A-Za-z]:/.test(l))?"\\":"/",s=[];for(let l of t){if(!l)continue;let c=l.replace(/[\\/]+/g,e).split(e).filter(Boolean);s.push(...c);}let o=t[0]??"",r=o.startsWith("/")||o.startsWith("\\"),n=/^[A-Za-z]:/.test(o),i=s.join(e);return n?i=o.slice(0,2)+e+i.slice(i.indexOf(e)+1||i.length):r&&(i=e+i),i||"."}function m(...t){let e=t.some(n=>n.includes("\\")||/^[A-Za-z]:/.test(n))?"\\":"/",s=[],o=false;for(let n of t){if(!n)continue;let i=n.replace(/[\\/]+/g,e),l=i.split(e);(i.startsWith(e)||/^[A-Za-z]:/.test(i))&&(s.length=0,o=true);for(let c of l)c===""||c==="."||(c===".."?s.pop():s.push(c));}let r=s.join(e);return o?e+r:r||"."}function P(t,a){let e=t.includes("\\")||a.includes("\\")?"\\":"/",s=t.replace(/[\\/]+/g,e).split(e).filter(Boolean),o=a.replace(/[\\/]+/g,e).split(e).filter(Boolean),r=0,n=Math.min(s.length,o.length);for(let c=0;c<n&&s[c]===o[c];c++)r++;let i=s.length-r,l=o.slice(r);return [...Array(i).fill(".."),...l].join(e)||"."}function x(t){if(!t)return ".";let a=t.includes("\\")||/^[A-Za-z]:/.test(t),e=a?"\\":"/",s=t.replace(/[\\/]+/g,e),o=s.startsWith(e)||/^[A-Za-z]:/.test(s),r=s.split(e),n=[];for(let l of r)l===""||l==="."||(l===".."?n.length>0&&n[n.length-1]!==".."?n.pop():o||n.push(".."):n.push(l));let i=n.join(e);return o&&(a&&/^[A-Za-z]:/.test(t)?i=t.slice(0,2)+e+i:i=e+i),i||"."}function W(t){return t.startsWith("/")||t.startsWith("\\")||/^[A-Za-z]:/.test(t)}function z(t){return t.replace(/\\/g,"/")}function A(t){return t.replace(/\//g,"\\")}function b(t){return t==="/"||t==="\\"?t:t.replace(/[\\/]+$/,"")}function v(t){let a=t.includes("\\")?"\\":"/";return t.endsWith("/")||t.endsWith("\\")?t:t+a}function w(t){if(t.length===0)return "";if(t.length===1)return t[0];let a=t[0].includes("\\")?"\\":"/",e=t.map(r=>r.replace(/[\\/]+/g,a).split(a)),s=Math.min(...e.map(r=>r.length)),o=[];for(let r=0;r<s;r++){let n=e[0][r];if(e.every(i=>i[r]===n))o.push(n);else break}return o.join(a)||""}
+export{g as a,f as b,p as c,d,h as e,m as f,P as g,x as h,W as i,z as j,A as k,b as l,v as m,w as n,j as o};

package/dist/chunk-MCQFAXUX.mjs

@@ -0,0 +1 @@
+import {a}from'./chunk-JZXLCA2E.mjs';var L={};a(L,{ContentTypes:()=>E,HttpError:()=>l,HttpHeaders:()=>w,basicAuth:()=>A,bearerAuth:()=>C,buildCookieHeader:()=>U,buildUrl:()=>d,createHttpClient:()=>O,del:()=>y,get:()=>f,mergeHeaders:()=>$,parseAuthHeader:()=>P,parseCookieHeader:()=>k,patch:()=>h,post:()=>g,put:()=>R,request:()=>T,requestWithRetry:()=>H,withRetry:()=>q});var l=class extends Error{constructor(r,u,a,p){super(r);this.status=u;this.statusText=a;this.response=p;this.name="HttpError";}};function d(t,e){if(!e)return t;let r=new URLSearchParams;for(let[a,p]of Object.entries(e))p!==void 0&&r.append(a,String(p));let u=r.toString();return u?t.includes("?")?`${t}&${u}`:`${t}?${u}`:t}async function T(t,e={}){let{baseUrl:r,timeout:u=3e4,params:a,body:p,...o}=e,n=d(r?`${r}${t}`:t,a),i=new AbortController,m=setTimeout(()=>i.abort(),u);try{let s=await fetch(n,{...o,signal:i.signal,headers:{"Content-Type":"application/json",...o.headers},body:p?JSON.stringify(p):null});clearTimeout(m);let c=await s.json().catch(()=>null);if(!s.ok)throw new l(`HTTP ${s.status}: ${s.statusText}`,s.status,s.statusText,c);return {data:c,status:s.status,statusText:s.statusText,headers:s.headers,ok:s.ok}}catch(s){throw clearTimeout(m),s instanceof l?s:s instanceof Error&&s.name==="AbortError"?new l("Request timeout",408,"Request Timeout"):s}}async function f(t,e){return T(t,{...e,method:"GET"})}async function g(t,e){return T(t,{...e,method:"POST"})}async function R(t,e){return T(t,{...e,method:"PUT"})}async function h(t,e){return T(t,{...e,method:"PATCH"})}async function y(t,e){return T(t,{...e,method:"DELETE"})}function O(t){let{baseUrl:e,timeout:r,headers:u,interceptors:a}=t;async function p(o,n,i={}){let m=i.timeout??r,s={...i,baseUrl:e,...m!==void 0&&{timeout:m},method:o,headers:{...u,...i.headers}};a?.request&&(s=await a.request(s));try{let c=await T(n,s);return a?.response&&(c=await a.response(c)),c}catch(c){throw a?.error&&c instanceof Error?await a.error(c):c}}return {get:(o,n)=>p("GET",o,n),post:(o,n)=>p("POST",o,n),put:(o,n)=>p("PUT",o,n),patch:(o,n)=>p("PATCH",o,n),delete:(o,n)=>p("DELETE",o,n),request:(o,n)=>p(n?.method??"GET",o,n)}}function x(t){return t instanceof l?t.status>=500&&t.status<600:t.name==="TypeError"||t.name==="AbortError"}function b(t,e,r){return r==="exponential"?e*Math.pow(2,t-1):e*t}async function H(t,e={}){let{maxRetries:r=3,delay:u=1e3,backoff:a="exponential",retryOn:p=x,...o}=e,n;for(let i=1;i<=r+1;i++)try{return await T(t,o)}catch(m){if(n=m instanceof Error?m:new Error(String(m)),i<=r&&p(n,i)){let s=b(i,u,a);await new Promise(c=>setTimeout(c,s));continue}throw n}throw n}function q(t,e={}){let{maxRetries:r=3,delay:u=1e3,backoff:a="exponential",retryOn:p=x}=e;return(async(...o)=>{let n;for(let i=1;i<=r+1;i++)try{return await t(...o)}catch(m){if(n=m instanceof Error?m:new Error(String(m)),i<=r&&p(n,i)){let s=b(i,u,a);await new Promise(c=>setTimeout(c,s));continue}throw n}throw n})}var w={ContentType:"Content-Type",Accept:"Accept",Authorization:"Authorization",CacheControl:"Cache-Control",UserAgent:"User-Agent",AcceptLanguage:"Accept-Language",ContentLength:"Content-Length",XRequestId:"X-Request-Id",XForwardedFor:"X-Forwarded-For",XRealIp:"X-Real-IP"},E={JSON:"application/json",FormData:"multipart/form-data",FormUrlEncoded:"application/x-www-form-urlencoded",Text:"text/plain",HTML:"text/html",XML:"application/xml",Binary:"application/octet-stream"};function P(t){if(!t)return null;let[e,r]=t.split(" ");return !e||!r?null:{type:e,credentials:r}}function C(t){return `Bearer ${t}`}function A(t,e){return `Basic ${btoa(`${t}:${e}`)}`}function k(t){let e={};return t&&t.split(";").forEach(r=>{let[u,...a]=r.trim().split("=");u&&(e[u]=a.join("="));}),e}function U(t){return Object.entries(t).map(([e,r])=>`${e}=${r}`).join("; ")}function $(...t){let e={};for(let r of t)r&&Object.assign(e,r);return e}export{l as a,d as b,T as c,f as d,g as e,R as f,h as g,y as h,O as i,H as j,q as k,w as l,E as m,P as n,C as o,A as p,k as q,U as r,$ as s,L as t};

package/dist/chunk-RCSO5S56.js

@@ -0,0 +1,2 @@
+'use strict';var chunkWOT6VMZA_js=require('./chunk-WOT6VMZA.js');var k={};chunkWOT6VMZA_js.a(k,{base64Decode:()=>x,base64Encode:()=>A,base64UrlDecode:()=>S,base64UrlEncode:()=>b,bytesToHex:()=>U,generateToken:()=>m,hash:()=>a,hexToBytes:()=>w,hexToString:()=>T,hmac:()=>f,randomBytes:()=>i,randomInt:()=>y,randomString:()=>c,sha256:()=>g,sha512:()=>p,stringToHex:()=>H,timingSafeEqual:()=>d,urlSafeToken:()=>h,utf8Decode:()=>D,utf8Encode:()=>E,uuid:()=>l});async function a(r,t="SHA-256"){let n=new TextEncoder().encode(r),o=await crypto.subtle.digest(t,n);return Array.from(new Uint8Array(o)).map(s=>s.toString(16).padStart(2,"0")).join("")}async function g(r){return a(r,"SHA-256")}async function p(r){return a(r,"SHA-512")}async function f(r,t,e="SHA-256"){let n=new TextEncoder,o=n.encode(t),u=n.encode(r),s=await crypto.subtle.importKey("raw",o,{name:"HMAC",hash:e},false,["sign"]),B=await crypto.subtle.sign("HMAC",s,u);return Array.from(new Uint8Array(B)).map(C=>C.toString(16).padStart(2,"0")).join("")}function d(r,t){if(r.length!==t.length)return  false;let e=0;for(let n=0;n<r.length;n++)e|=r.charCodeAt(n)^t.charCodeAt(n);return e===0}function l(){return crypto.randomUUID()}function i(r){let t=new Uint8Array(r);return crypto.getRandomValues(t),Array.from(t).map(e=>e.toString(16).padStart(2,"0")).join("")}function c(r,t="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789"){let e=new Uint8Array(r);crypto.getRandomValues(e);let n="";for(let o=0;o<r;o++)n+=t[e[o]%t.length];return n}function y(r,t){let e=t-r+1,n=new Uint32Array(1);return crypto.getRandomValues(n),r+n[0]%e}function m(r=32){return i(Math.ceil(r/2)).slice(0,r)}function h(r){return c(r,"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_")}function A(r){return btoa(r)}function x(r){return atob(r)}function b(r){return btoa(r).replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/,"")}function S(r){let t=r.replace(/-/g,"+").replace(/_/g,"/"),e=t.length%4;return e&&(t+="=".repeat(4-e)),atob(t)}function H(r){return Array.from(r).map(t=>t.charCodeAt(0).toString(16).padStart(2,"0")).join("")}function T(r){let t="";for(let e=0;e<r.length;e+=2)t+=String.fromCharCode(parseInt(r.slice(e,e+2),16));return t}function U(r){return Array.from(r).map(t=>t.toString(16).padStart(2,"0")).join("")}function w(r){let t=new Uint8Array(r.length/2);for(let e=0;e<r.length;e+=2)t[e/2]=parseInt(r.slice(e,e+2),16);return t}function E(r){return new TextEncoder().encode(r)}function D(r){return new TextDecoder().decode(r)}
+exports.a=a;exports.b=g;exports.c=p;exports.d=f;exports.e=d;exports.f=l;exports.g=i;exports.h=c;exports.i=y;exports.j=m;exports.k=h;exports.l=A;exports.m=x;exports.n=b;exports.o=S;exports.p=H;exports.q=T;exports.r=U;exports.s=w;exports.t=E;exports.u=D;exports.v=k;

package/dist/chunk-U6XM3X5N.mjs

@@ -0,0 +1,2 @@
+import {a as a$1}from'./chunk-JZXLCA2E.mjs';var k={};a$1(k,{base64Decode:()=>x,base64Encode:()=>A,base64UrlDecode:()=>S,base64UrlEncode:()=>b,bytesToHex:()=>U,generateToken:()=>m,hash:()=>a,hexToBytes:()=>w,hexToString:()=>T,hmac:()=>f,randomBytes:()=>i,randomInt:()=>y,randomString:()=>c,sha256:()=>g,sha512:()=>p,stringToHex:()=>H,timingSafeEqual:()=>d,urlSafeToken:()=>h,utf8Decode:()=>D,utf8Encode:()=>E,uuid:()=>l});async function a(r,t="SHA-256"){let n=new TextEncoder().encode(r),o=await crypto.subtle.digest(t,n);return Array.from(new Uint8Array(o)).map(s=>s.toString(16).padStart(2,"0")).join("")}async function g(r){return a(r,"SHA-256")}async function p(r){return a(r,"SHA-512")}async function f(r,t,e="SHA-256"){let n=new TextEncoder,o=n.encode(t),u=n.encode(r),s=await crypto.subtle.importKey("raw",o,{name:"HMAC",hash:e},false,["sign"]),B=await crypto.subtle.sign("HMAC",s,u);return Array.from(new Uint8Array(B)).map(C=>C.toString(16).padStart(2,"0")).join("")}function d(r,t){if(r.length!==t.length)return  false;let e=0;for(let n=0;n<r.length;n++)e|=r.charCodeAt(n)^t.charCodeAt(n);return e===0}function l(){return crypto.randomUUID()}function i(r){let t=new Uint8Array(r);return crypto.getRandomValues(t),Array.from(t).map(e=>e.toString(16).padStart(2,"0")).join("")}function c(r,t="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789"){let e=new Uint8Array(r);crypto.getRandomValues(e);let n="";for(let o=0;o<r;o++)n+=t[e[o]%t.length];return n}function y(r,t){let e=t-r+1,n=new Uint32Array(1);return crypto.getRandomValues(n),r+n[0]%e}function m(r=32){return i(Math.ceil(r/2)).slice(0,r)}function h(r){return c(r,"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_")}function A(r){return btoa(r)}function x(r){return atob(r)}function b(r){return btoa(r).replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/,"")}function S(r){let t=r.replace(/-/g,"+").replace(/_/g,"/"),e=t.length%4;return e&&(t+="=".repeat(4-e)),atob(t)}function H(r){return Array.from(r).map(t=>t.charCodeAt(0).toString(16).padStart(2,"0")).join("")}function T(r){let t="";for(let e=0;e<r.length;e+=2)t+=String.fromCharCode(parseInt(r.slice(e,e+2),16));return t}function U(r){return Array.from(r).map(t=>t.toString(16).padStart(2,"0")).join("")}function w(r){let t=new Uint8Array(r.length/2);for(let e=0;e<r.length;e+=2)t[e/2]=parseInt(r.slice(e,e+2),16);return t}function E(r){return new TextEncoder().encode(r)}function D(r){return new TextDecoder().decode(r)}
+export{a,g as b,p as c,f as d,d as e,l as f,i as g,c as h,y as i,m as j,h as k,A as l,x as m,b as n,S as o,H as p,T as q,U as r,w as s,E as t,D as u,k as v};

package/dist/chunk-X6JSYVIW.mjs

@@ -0,0 +1 @@
+import {a}from'./chunk-JZXLCA2E.mjs';var z={};a(z,{addTime:()=>h,diff:()=>Y,endOf:()=>k,formatDate:()=>d,formatDuration:()=>j,fromUnixTimestamp:()=>I,isAfter:()=>O,isBefore:()=>F,isBetween:()=>U,isFuture:()=>P,isLeapYear:()=>W,isPast:()=>B,isSameDate:()=>H,isSameDay:()=>D,isToday:()=>R,isTomorrow:()=>v,isWeekday:()=>$,isWeekend:()=>b,isYesterday:()=>A,parseDuration:()=>C,startOf:()=>S,subtractTime:()=>T,timeAgo:()=>L,toDate:()=>o,toISODateString:()=>M,toISOString:()=>x,toUnixTimestamp:()=>y});function o(t){return t instanceof Date?t:typeof t=="number"?new Date(t):new Date(t)}function d(t,n){let r=o(t),e=(m,p=2)=>String(m).padStart(p,"0"),a=r.getHours(),s=a%12||12,i=a>=12,f={YYYY:String(r.getFullYear()),YY:String(r.getFullYear()).slice(-2),MM:e(r.getMonth()+1),M:String(r.getMonth()+1),DD:e(r.getDate()),D:String(r.getDate()),HH:e(a),H:String(a),hh:e(s),h:String(s),mm:e(r.getMinutes()),m:String(r.getMinutes()),ss:e(r.getSeconds()),s:String(r.getSeconds()),SSS:e(r.getMilliseconds(),3),A:i?"PM":"AM",a:i?"pm":"am"},c=n;for(let[m,p]of Object.entries(f).sort((g,l)=>l[0].length-g[0].length))c=c.replace(new RegExp(m,"g"),p);return c}function M(t){return d(t,"YYYY-MM-DD")}function x(t){return o(t).toISOString()}function y(t){return Math.floor(o(t).getTime()/1e3)}function I(t){return new Date(t*1e3)}function w(t,n){return t*{milliseconds:1,seconds:1e3,minutes:6e4,hours:36e5,days:864e5,weeks:6048e5,months:2592e6,years:31536e6}[n]}function h(t,n,r){let e=o(t);if(r==="months"){let a=new Date(e);return a.setMonth(a.getMonth()+n),a}if(r==="years"){let a=new Date(e);return a.setFullYear(a.getFullYear()+n),a}return new Date(e.getTime()+w(n,r))}function T(t,n,r){return h(t,-n,r)}function S(t,n){let r=o(t),e=new Date(r);switch(n){case "second":e.setMilliseconds(0);break;case "minute":e.setSeconds(0,0);break;case "hour":e.setMinutes(0,0,0);break;case "day":e.setHours(0,0,0,0);break;case "week":e.setHours(0,0,0,0),e.setDate(e.getDate()-e.getDay());break;case "month":e.setHours(0,0,0,0),e.setDate(1);break;case "year":e.setHours(0,0,0,0),e.setMonth(0,1);break}return e}function k(t,n){let r=o(t),e=new Date(r);switch(n){case "second":e.setMilliseconds(999);break;case "minute":e.setSeconds(59,999);break;case "hour":e.setMinutes(59,59,999);break;case "day":e.setHours(23,59,59,999);break;case "week":e.setHours(23,59,59,999),e.setDate(e.getDate()+(6-e.getDay()));break;case "month":e.setMonth(e.getMonth()+1,0),e.setHours(23,59,59,999);break;case "year":e.setMonth(11,31),e.setHours(23,59,59,999);break}return e}function Y(t,n,r){let e=o(t),a=o(n);if(r==="months")return (e.getFullYear()-a.getFullYear())*12+(e.getMonth()-a.getMonth());if(r==="years")return e.getFullYear()-a.getFullYear();let s=e.getTime()-a.getTime();return Math.floor(s/w(1,r))}function F(t,n){return o(t).getTime()<o(n).getTime()}function O(t,n){return o(t).getTime()>o(n).getTime()}function H(t,n){return o(t).getTime()===o(n).getTime()}function D(t,n){let r=o(t),e=o(n);return r.getFullYear()===e.getFullYear()&&r.getMonth()===e.getMonth()&&r.getDate()===e.getDate()}function U(t,n,r){let e=o(t).getTime();return e>=o(n).getTime()&&e<=o(r).getTime()}function R(t){return D(t,new Date)}function A(t){let n=new Date;return n.setDate(n.getDate()-1),D(t,n)}function v(t){let n=new Date;return n.setDate(n.getDate()+1),D(t,n)}function B(t){return o(t).getTime()<Date.now()}function P(t){return o(t).getTime()>Date.now()}function W(t){return t%4===0&&t%100!==0||t%400===0}function b(t){let n=o(t).getDay();return n===0||n===6}function $(t){return !b(t)}function L(t,n={}){let{locale:r="en",style:e="long"}=n,a=o(t),s=Date.now(),i=a.getTime()-s,f=Math.round(i/1e3),c=Math.round(i/6e4),m=Math.round(i/36e5),p=Math.round(i/864e5),g=Math.round(i/6048e5),l=Math.round(i/2592e6),E=Math.round(i/31536e6),u=new Intl.RelativeTimeFormat(r,{style:e});return Math.abs(f)<60?u.format(f,"second"):Math.abs(c)<60?u.format(c,"minute"):Math.abs(m)<24?u.format(m,"hour"):Math.abs(p)<7?u.format(p,"day"):Math.abs(g)<4?u.format(g,"week"):Math.abs(l)<12?u.format(l,"month"):u.format(E,"year")}function j(t){let n=Math.floor(t/1e3),r=Math.floor(n/60),e=Math.floor(r/60),a=Math.floor(e/24),s=[];return a>0&&s.push(`${a}d`),e%24>0&&s.push(`${e%24}h`),r%60>0&&s.push(`${r%60}m`),(n%60>0||s.length===0)&&s.push(`${n%60}s`),s.join(" ")}function C(t){let n={ms:1,s:1e3,m:6e4,h:36e5,d:864e5,w:6048e5},r=0,e=/(\d+)\s*(ms|s|m|h|d|w)/gi,a;for(;(a=e.exec(t))!==null;){let s=parseInt(a[1],10),i=a[2].toLowerCase();r+=s*(n[i]??0);}return r}export{C as A,z as B,o as a,d as b,M as c,x as d,y as e,I as f,h as g,T as h,S as i,k as j,Y as k,F as l,O as m,H as n,D as o,U as p,R as q,A as r,v as s,B as t,P as u,W as v,b as w,$ as x,L as y,j as z};

package/dist/chunk-XKTDG6LH.js

@@ -0,0 +1 @@
+'use strict';var chunkWOT6VMZA_js=require('./chunk-WOT6VMZA.js');var L={};chunkWOT6VMZA_js.a(L,{ContentTypes:()=>E,HttpError:()=>l,HttpHeaders:()=>w,basicAuth:()=>A,bearerAuth:()=>C,buildCookieHeader:()=>U,buildUrl:()=>d,createHttpClient:()=>O,del:()=>y,get:()=>f,mergeHeaders:()=>$,parseAuthHeader:()=>P,parseCookieHeader:()=>k,patch:()=>h,post:()=>g,put:()=>R,request:()=>T,requestWithRetry:()=>H,withRetry:()=>q});var l=class extends Error{constructor(r,u,a,p){super(r);this.status=u;this.statusText=a;this.response=p;this.name="HttpError";}};function d(t,e){if(!e)return t;let r=new URLSearchParams;for(let[a,p]of Object.entries(e))p!==void 0&&r.append(a,String(p));let u=r.toString();return u?t.includes("?")?`${t}&${u}`:`${t}?${u}`:t}async function T(t,e={}){let{baseUrl:r,timeout:u=3e4,params:a,body:p,...o}=e,n=d(r?`${r}${t}`:t,a),i=new AbortController,m=setTimeout(()=>i.abort(),u);try{let s=await fetch(n,{...o,signal:i.signal,headers:{"Content-Type":"application/json",...o.headers},body:p?JSON.stringify(p):null});clearTimeout(m);let c=await s.json().catch(()=>null);if(!s.ok)throw new l(`HTTP ${s.status}: ${s.statusText}`,s.status,s.statusText,c);return {data:c,status:s.status,statusText:s.statusText,headers:s.headers,ok:s.ok}}catch(s){throw clearTimeout(m),s instanceof l?s:s instanceof Error&&s.name==="AbortError"?new l("Request timeout",408,"Request Timeout"):s}}async function f(t,e){return T(t,{...e,method:"GET"})}async function g(t,e){return T(t,{...e,method:"POST"})}async function R(t,e){return T(t,{...e,method:"PUT"})}async function h(t,e){return T(t,{...e,method:"PATCH"})}async function y(t,e){return T(t,{...e,method:"DELETE"})}function O(t){let{baseUrl:e,timeout:r,headers:u,interceptors:a}=t;async function p(o,n,i={}){let m=i.timeout??r,s={...i,baseUrl:e,...m!==void 0&&{timeout:m},method:o,headers:{...u,...i.headers}};a?.request&&(s=await a.request(s));try{let c=await T(n,s);return a?.response&&(c=await a.response(c)),c}catch(c){throw a?.error&&c instanceof Error?await a.error(c):c}}return {get:(o,n)=>p("GET",o,n),post:(o,n)=>p("POST",o,n),put:(o,n)=>p("PUT",o,n),patch:(o,n)=>p("PATCH",o,n),delete:(o,n)=>p("DELETE",o,n),request:(o,n)=>p(n?.method??"GET",o,n)}}function x(t){return t instanceof l?t.status>=500&&t.status<600:t.name==="TypeError"||t.name==="AbortError"}function b(t,e,r){return r==="exponential"?e*Math.pow(2,t-1):e*t}async function H(t,e={}){let{maxRetries:r=3,delay:u=1e3,backoff:a="exponential",retryOn:p=x,...o}=e,n;for(let i=1;i<=r+1;i++)try{return await T(t,o)}catch(m){if(n=m instanceof Error?m:new Error(String(m)),i<=r&&p(n,i)){let s=b(i,u,a);await new Promise(c=>setTimeout(c,s));continue}throw n}throw n}function q(t,e={}){let{maxRetries:r=3,delay:u=1e3,backoff:a="exponential",retryOn:p=x}=e;return(async(...o)=>{let n;for(let i=1;i<=r+1;i++)try{return await t(...o)}catch(m){if(n=m instanceof Error?m:new Error(String(m)),i<=r&&p(n,i)){let s=b(i,u,a);await new Promise(c=>setTimeout(c,s));continue}throw n}throw n})}var w={ContentType:"Content-Type",Accept:"Accept",Authorization:"Authorization",CacheControl:"Cache-Control",UserAgent:"User-Agent",AcceptLanguage:"Accept-Language",ContentLength:"Content-Length",XRequestId:"X-Request-Id",XForwardedFor:"X-Forwarded-For",XRealIp:"X-Real-IP"},E={JSON:"application/json",FormData:"multipart/form-data",FormUrlEncoded:"application/x-www-form-urlencoded",Text:"text/plain",HTML:"text/html",XML:"application/xml",Binary:"application/octet-stream"};function P(t){if(!t)return null;let[e,r]=t.split(" ");return !e||!r?null:{type:e,credentials:r}}function C(t){return `Bearer ${t}`}function A(t,e){return `Basic ${btoa(`${t}:${e}`)}`}function k(t){let e={};return t&&t.split(";").forEach(r=>{let[u,...a]=r.trim().split("=");u&&(e[u]=a.join("="));}),e}function U(t){return Object.entries(t).map(([e,r])=>`${e}=${r}`).join("; ")}function $(...t){let e={};for(let r of t)r&&Object.assign(e,r);return e}exports.a=l;exports.b=d;exports.c=T;exports.d=f;exports.e=g;exports.f=R;exports.g=h;exports.h=y;exports.i=O;exports.j=H;exports.k=q;exports.l=w;exports.m=E;exports.n=P;exports.o=C;exports.p=A;exports.q=k;exports.r=U;exports.s=$;exports.t=L;

package/dist/datetime/index.d.mts

@@ -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 };