@apiverve/agecalculator 1.1.13 → 1.2.0

package/README.md

@@ -123,14 +123,44 @@ async function makeRequest() {
   "error": null,
   "data": {
     "dob": "1990-01-01",
-    "age_years": 35,
-    "age_months": 421,
-    "age_weeks": 1833,
-    "age_days": 12834,
+    "age_breakdown": {
+      "years": 35,
+      "months": 431,
+      "weeks": 1876,
+      "days": 13133,
+      "hours": 315208,
+      "minutes": 18912499,
+      "seconds": 1134749976
+    },
     "age_words": {
       "years": "thirty-five",
       "ordinal": "thirty-fifth",
-      "full": "thirty-five years old"
+      "full": "thirty-five years old",
+      "locale": "en-US"
+    },
+    "timezone": "America/Chicago",
+    "locale": "en-US",
+    "next_birthday": {
+      "months": 0,
+      "weeks": 2,
+      "days": 15,
+      "hours": 367,
+      "minutes": 22060,
+      "seconds": 1323623
+    },
+    "insights": {
+      "generation": "Millennial",
+      "zodiacSign": "Capricorn",
+      "chineseZodiac": "Horse",
+      "birthstone": "Garnet",
+      "dayOfWeekBorn": "Monday",
+      "isLeapYearBirth": false,
+      "milestones": {
+        "canVoteUS": true,
+        "canDrinkUS": true,
+        "canRentCarUS": true,
+        "seniorDiscount": false
+      }
     }
   }
 }

package/index.d.ts

@@ -4,27 +4,68 @@ declare module '@apiverve/agecalculator' {
     secure?: boolean;
   }
 
+  /**
+   * Describes fields the current plan does not unlock. Locked fields arrive as null
+   * in `data`; `locked_fields` names them, using dot paths for nested fields.
+   * Absent when the plan unlocks everything.
+   */
+  export interface PremiumInfo {
+    message: string;
+    upgrade_url: string;
+    locked_fields: string[];
+  }
+
   export interface agecalculatorResponse {
     status: string;
     error: string | null;
     data: AgeCalculatorData;
     code?: number;
+    premium?: PremiumInfo;
   }
 
 
   interface AgeCalculatorData {
-      dob:       Date;
-      ageYears:  number;
-      ageMonths: number;
-      ageWeeks:  number;
-      ageDays:   number;
-      ageWords:  AgeWords;
+      dob:          Date | null;
+      ageBreakdown: AgeBreakdown;
+      ageWords:     AgeWords;
+      timezone:     null | string;
+      locale:       null | string;
+      nextBirthday: AgeBreakdown;
+      insights:     Insights;
+  }
+  
+  interface AgeBreakdown {
+      years?:  number | null;
+      months:  number | null;
+      weeks:   number | null;
+      days:    number | null;
+      hours:   number | null;
+      minutes: number | null;
+      seconds: number | null;
   }
   
   interface AgeWords {
-      years:   string;
-      ordinal: string;
-      full:    string;
+      years:   null | string;
+      ordinal: null | string;
+      full:    null | string;
+      locale:  null | string;
+  }
+  
+  interface Insights {
+      generation:      null | string;
+      zodiacSign:      null | string;
+      chineseZodiac:   null | string;
+      birthstone:      null | string;
+      dayOfWeekBorn:   null | string;
+      isLeapYearBirth: boolean | null;
+      milestones:      Milestones;
+  }
+  
+  interface Milestones {
+      canVoteUS:      boolean | null;
+      canDrinkUS:     boolean | null;
+      canRentCarUS:   boolean | null;
+      seniorDiscount: boolean | null;
   }
 
   export default class agecalculatorWrapper {

package/index.js

@@ -13,16 +13,10 @@ class agecalculatorWrapper {
             throw new Error('API key must be provided as a non-empty string. Get your API key at: https://apiverve.com');
         }
 
-        // Validate API key format (GUID or alphanumeric with hyphens)
-        const apiKeyPattern = /^[a-zA-Z0-9-]+$/;
+        // Validate API key format (GUID, prefixed keys like apv_xxx, or alphanumeric)
+        const apiKeyPattern = /^[a-zA-Z0-9_-]+$/;
         if (!apiKeyPattern.test(api_key)) {
-            throw new Error('Invalid API key format. API key must be alphanumeric and may contain hyphens. Get your API key at: https://apiverve.com');
-        }
-
-        // Check minimum length (GUIDs are typically 36 chars with hyphens, or 32 without)
-        const trimmedKey = api_key.replace(/-/g, '');
-        if (trimmedKey.length < 32) {
-            throw new Error('Invalid API key. API key appears to be too short. Get your API key at: https://apiverve.com');
+            throw new Error('Invalid API key format. API key must be alphanumeric and may contain hyphens and underscores. Get your API key at: https://apiverve.com');
         }
 
         if (typeof secure !== 'boolean') {

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@apiverve/agecalculator",
-  "version": "1.1.13",
+  "version": "1.2.0",
   "description": "Age Calculator is a simple tool for calculating age from the date of birth. It returns the calculated age based on the date of birth provided.",
   "main": "index.js",
   "types": "index.d.ts",
   "sideEffects": false,
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=18.0.0"
   },
   "files": [
     "index.js",
@@ -41,8 +41,7 @@
     "dotenv": "^16.4.7"
   },
   "dependencies": {
-    "node-fetch": "^3.3.2",
-    "promise": "^8.3.0",
-    "axios": "1.13.2"
+    "axios": "1.13.2",
+    "form-data": "^4.0.1"
   }
 }