chrono-age 1.0.0

package/README.md

@@ -0,0 +1,99 @@
+# age-calc
+
+**"Bulletproof" Age Calculation for High-Scale Backend & Frontend**
+
+`age-calc` is a zero-dependency, environment-agnostic TypeScript library designed for precision age calculation. It is optimized for correctness, memory safety, and performance.
+
+## Features
+
+- **Environment Agnostic**: Works perfectly in Node.js, Bun, Deno, and Browsers.
+- **Zero Dependencies**: Lightweight and secure.
+- **Type-Safe**: Written in TypeScript with strict types and `Readonly` interfaces.
+- **Defensive**: Validates inputs rigorously to prevent runtime crashes (no `undefined` errors).
+- **Correctness**: Handles leap years and edge cases accurately.
+
+## Installation
+
+```bash
+npm install age-calc
+# or
+bun add age-calc
+# or
+yarn add age-calc
+```
+
+## Usage
+
+### Basic Usage
+
+```typescript
+import { calculateAge, calculateAgeDetail } from 'age-calc';
+
+const birthDate = new Date('1990-01-01');
+const age = calculateAge({ birthDate });
+
+console.log(age); // e.g., 33 (depending on today's date)
+
+// Get detailed breakdown
+const detail = calculateAgeDetail({ 
+    birthDate, 
+    targetDate: new Date('2023-05-20') 
+});
+console.log(detail); // { years: 33, months: 4, days: 19 }
+```
+
+### Backend Integration (Express / ElysiaJS)
+
+`age-calc` throws typed errors (`InvalidDateError`, `FutureDateError`) allowing you to return proper HTTP 400 responses.
+
+**Express & TypeScript Example:**
+
+```typescript
+import express from 'express';
+import { calculateAge, InvalidDateError, FutureDateError } from 'age-calc';
+
+const app = express();
+app.use(express.json());
+
+app.post('/check-age', (req, res) => {
+  try {
+    const { birthDateStr } = req.body;
+    const birthDate = new Date(birthDateStr);
+    
+    // Calculate age (defaults targetDate to now)
+    const age = calculateAge({ birthDate });
+    
+    res.json({ age });
+  } catch (error) {
+    if (error instanceof InvalidDateError || error instanceof FutureDateError) {
+      // 400 Bad Request
+      res.status(400).json({ error: error.message });
+    } else {
+      // 500 Internal Server Error
+      res.status(500).json({ error: 'Internal Server Error' });
+    }
+  }
+});
+```
+
+## API Reference
+
+### `calculateAge(input: AgeInput): number`
+Calculates the age in full years.
+
+### `calculateAgeDetail(input: AgeInput): AgeDetail`
+Calculates age in years, months, and days.
+
+### `validateInput(input: AgeInput): void`
+Runs validation logic explicitly. Throws errors if invalid.
+
+### Types
+- `AgeInput`: `{ readonly birthDate: Date; readonly targetDate?: Date; }`
+- `AgeDetail`: `{ years: number; months: number; days: number; }`
+
+## Benchmarks
+Designed for low memory footprint. Allocates minimal objects.
+Zero external dependencies ensures fast install and startup.
+
+## License
+MIT

package/dist/index.js

@@ -0,0 +1 @@
+var{defineProperty:L,getOwnPropertyNames:S,getOwnPropertyDescriptor:U}=Object,V=Object.prototype.hasOwnProperty;var O=new WeakMap,W=(x)=>{var A=O.get(x),j;if(A)return A;if(A=L({},"__esModule",{value:!0}),x&&typeof x==="object"||typeof x==="function")S(x).map((q)=>!V.call(A,q)&&L(A,q,{get:()=>x[q],enumerable:!(j=U(x,q))||j.enumerable}));return O.set(x,A),A};var X=(x,A)=>{for(var j in A)L(x,j,{get:A[j],enumerable:!0,configurable:!0,set:(q)=>A[j]=()=>q})};var Y={};X(Y,{validateInput:()=>J,calculateAgeDetail:()=>Q,calculateAge:()=>P,InvalidDateError:()=>B,FutureDateError:()=>H,AgeCalcError:()=>F});module.exports=W(Y);class F extends Error{constructor(x){super(x);this.name="AgeCalcError"}}class B extends F{constructor(x="Invalid date provided"){super(x);this.name="InvalidDateError"}}class H extends F{constructor(x="Birth date cannot be in the future"){super(x);this.name="FutureDateError"}}function J(x){if(!x)throw new B("Input object is required");let{birthDate:A,targetDate:j=new Date}=x;if(!(A instanceof Date)||isNaN(A.getTime()))throw new B("Invalid birth date");if(!(j instanceof Date)||isNaN(j.getTime()))throw new B("Invalid target date");if(A.getTime()>j.getTime())throw new H(`Birth date ${A.toISOString()} is after target date ${j.toISOString()}`)}function P(x){J(x);let{birthDate:A,targetDate:j=new Date}=x,q=j.getFullYear()-A.getFullYear(),z=j.getMonth()-A.getMonth();if(z<0||z===0&&j.getDate()<A.getDate())q--;return q}function Q(x){J(x);let{birthDate:A,targetDate:j=new Date}=x,q=j.getFullYear()-A.getFullYear(),z=j.getMonth()-A.getMonth(),K=j.getDate()-A.getDate();if(K<0){z--;let R=new Date(j.getFullYear(),j.getMonth(),0);K+=R.getDate()}if(z<0)q--,z+=12;return{years:q,months:z,days:K}}

package/dist/index.mjs

@@ -0,0 +1 @@
+class F extends Error{constructor(x){super(x);this.name="AgeCalcError"}}class z extends F{constructor(x="Invalid date provided"){super(x);this.name="InvalidDateError"}}class H extends F{constructor(x="Birth date cannot be in the future"){super(x);this.name="FutureDateError"}}function J(x){if(!x)throw new z("Input object is required");let{birthDate:j,targetDate:A=new Date}=x;if(!(j instanceof Date)||isNaN(j.getTime()))throw new z("Invalid birth date");if(!(A instanceof Date)||isNaN(A.getTime()))throw new z("Invalid target date");if(j.getTime()>A.getTime())throw new H(`Birth date ${j.toISOString()} is after target date ${A.toISOString()}`)}function O(x){J(x);let{birthDate:j,targetDate:A=new Date}=x,B=A.getFullYear()-j.getFullYear(),q=A.getMonth()-j.getMonth();if(q<0||q===0&&A.getDate()<j.getDate())B--;return B}function P(x){J(x);let{birthDate:j,targetDate:A=new Date}=x,B=A.getFullYear()-j.getFullYear(),q=A.getMonth()-j.getMonth(),K=A.getDate()-j.getDate();if(K<0){q--;let L=new Date(A.getFullYear(),A.getMonth(),0);K+=L.getDate()}if(q<0)B--,q+=12;return{years:B,months:q,days:K}}export{J as validateInput,P as calculateAgeDetail,O as calculateAge,z as InvalidDateError,H as FutureDateError,F as AgeCalcError};

package/package.json

@@ -0,0 +1,38 @@
+{
+    "name": "chrono-age",
+    "version": "1.0.0",
+    "description": "A bulletproof, environment-agnostic age calculator for high-scale backends and frontends.",
+    "main": "./dist/index.js",
+    "module": "./dist/index.mjs",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/index.mjs",
+            "require": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "scripts": {
+        "build": "bun build ./src/index.ts --outfile ./dist/index.js --target node --format cjs --minify && bun build ./src/index.ts --outfile ./dist/index.mjs --target node --format esm --minify",
+        "test": "bun test",
+        "lint": "bun x eslint src/**/*.ts",
+        "prepublishOnly": "bun run build"
+    },
+    "keywords": [
+        "age",
+        "calculator",
+        "date",
+        "validator",
+        "typescript",
+        "zero-dependency"
+    ],
+    "author": "",
+    "license": "MIT",
+    "devDependencies": {
+        "bun-types": "latest",
+        "typescript": "^5.0.0"
+    },
+    "peerDependencies": {
+        "typescript": "^5.0.0"
+    }
+}

package/verify.ts

@@ -0,0 +1,41 @@
+import { calculateAge, calculateAgeDetail, validateInput, InvalidDateError } from "./dist/index";
+
+console.log("Starting verification...");
+
+try {
+    // Test 1: Basic Age
+    const age = calculateAge({ birthDate: new Date("1990-01-01"), targetDate: new Date("2023-01-01") });
+    if (age !== 33) throw new Error(`Test 1 Failed: Expected 33, got ${age}`);
+    console.log("Test 1 Passed: Basic Age");
+
+    // Test 2: Leap Year
+    const ageLeap = calculateAge({ birthDate: new Date("2000-02-29"), targetDate: new Date("2001-02-28") });
+    if (ageLeap !== 0) throw new Error(`Test 2 Failed: Expected 0, got ${ageLeap}`);
+    console.log("Test 2 Passed: Leap Year boundary");
+
+    // Test 3: Validation
+    try {
+        // @ts-ignore
+        validateInput(null);
+        throw new Error("Test 3 Failed: Should have thrown validation error");
+    } catch (e) {
+        if (e instanceof InvalidDateError) {
+            console.log("Test 3 Passed: Validation caught null");
+        } else {
+            throw e;
+        }
+    }
+
+    // Test 4: Details
+    const details = calculateAgeDetail({ birthDate: new Date("1990-01-01"), targetDate: new Date("1991-02-05") });
+    if (details.years !== 1 || details.months !== 1 || details.days !== 4) {
+        throw new Error(`Test 4 Failed: Details mismatch ${JSON.stringify(details)}`);
+    }
+    console.log("Test 4 Passed: details");
+
+    console.log("ALL TESTS PASSED MANUALLY");
+
+} catch (e) {
+    console.error(e);
+    process.exit(1);
+}