@apiverve/worldholidays 1.2.4 → 1.2.5

package/README.md

@@ -1,6 +1,6 @@
 # World Holidays API
 
-World Holidays lists public holidays and observances for any two-letter country code. It returns holiday dates, official names, and event types across the year.
+World Holidays lists public holidays and observances for any two-letter country code, optionally for a state or region. It returns holiday dates, local and English names, day of week, event types and substitute-day flags, and can check whether a single date is a holiday.
 
 [![npm version](https://img.shields.io/npm/v/@apiverve/worldholidays.svg)](https://www.npmjs.com/package/@apiverve/worldholidays)
 
@@ -58,7 +58,10 @@ Using the API is simple. All you have to do is make a request. The API will retu
 ```javascript
 var query = {
   country: "US",
-  year: 2026
+  year: 2026,
+  region: "CA",
+  type: "public",
+  date: "2026-07-03"
 };
 
 api.execute(query, function (error, data) {
@@ -79,7 +82,10 @@ You can also use promises to make requests. The API returns a promise that you c
 ```javascript
 var query = {
   country: "US",
-  year: 2026
+  year: 2026,
+  region: "CA",
+  type: "public",
+  date: "2026-07-03"
 };
 
 api.execute(query)
@@ -101,7 +107,10 @@ You can also use async/await to make requests. The API returns a promise that yo
 async function makeRequest() {
     var query = {
   country: "US",
-  year: 2026
+  year: 2026,
+  region: "CA",
+  type: "public",
+  date: "2026-07-03"
 };
 
     try {
@@ -123,161 +132,215 @@ async function makeRequest() {
   "error": null,
   "data": {
     "country": "US",
-    "year": "2025",
+    "year": 2026,
     "holidays": [
       {
-        "date": "2025-01-01 00:00:00",
-        "start": "2025-01-01T05:00:00Z",
-        "end": "2025-01-02T05:00:00Z",
+        "date": "2026-01-01 00:00:00",
+        "start": "2026-01-01T05:00:00.000Z",
+        "end": "2026-01-02T05:00:00.000Z",
         "name": "New Year's Day",
-        "type": "public"
+        "type": "public",
+        "dayOfWeek": "Thursday",
+        "englishName": "New Year's Day"
       },
       {
-        "date": "2025-01-20 00:00:00",
-        "start": "2025-01-20T05:00:00Z",
-        "end": "2025-01-21T05:00:00Z",
+        "date": "2026-01-19 00:00:00",
+        "start": "2026-01-19T05:00:00.000Z",
+        "end": "2026-01-20T05:00:00.000Z",
         "name": "Martin Luther King Jr. Day",
-        "type": "public"
+        "type": "public",
+        "dayOfWeek": "Monday",
+        "englishName": "Martin Luther King Jr. Day"
       },
       {
-        "date": "2025-02-14 00:00:00",
-        "start": "2025-02-14T05:00:00Z",
-        "end": "2025-02-15T05:00:00Z",
+        "date": "2026-02-14 00:00:00",
+        "start": "2026-02-14T05:00:00.000Z",
+        "end": "2026-02-15T05:00:00.000Z",
         "name": "Valentine's Day",
-        "type": "observance"
+        "type": "observance",
+        "dayOfWeek": "Saturday",
+        "englishName": "Valentine's Day"
       },
       {
-        "date": "2025-02-17 00:00:00",
-        "start": "2025-02-17T05:00:00Z",
-        "end": "2025-02-18T05:00:00Z",
+        "date": "2026-02-16 00:00:00",
+        "start": "2026-02-16T05:00:00.000Z",
+        "end": "2026-02-17T05:00:00.000Z",
         "name": "Washington's Birthday",
-        "type": "public"
+        "type": "public",
+        "dayOfWeek": "Monday",
+        "englishName": "Washington's Birthday"
       },
       {
-        "date": "2025-03-17 00:00:00",
-        "start": "2025-03-17T04:00:00Z",
-        "end": "2025-03-18T04:00:00Z",
+        "date": "2026-03-17 00:00:00",
+        "start": "2026-03-17T04:00:00.000Z",
+        "end": "2026-03-18T04:00:00.000Z",
         "name": "St. Patrick's Day",
-        "type": "observance"
+        "type": "observance",
+        "dayOfWeek": "Tuesday",
+        "englishName": "St. Patrick's Day"
       },
       {
-        "date": "2025-04-15 00:00:00",
-        "start": "2025-04-15T04:00:00Z",
-        "end": "2025-04-16T04:00:00Z",
-        "name": "Tax Day",
-        "type": "observance"
+        "date": "2026-04-05 00:00:00",
+        "start": "2026-04-05T04:00:00.000Z",
+        "end": "2026-04-06T04:00:00.000Z",
+        "name": "Easter Sunday",
+        "type": "observance",
+        "dayOfWeek": "Sunday",
+        "englishName": "Easter Sunday"
       },
       {
-        "date": "2025-04-20 00:00:00",
-        "start": "2025-04-20T04:00:00Z",
-        "end": "2025-04-21T04:00:00Z",
-        "name": "Easter Sunday",
-        "type": "observance"
+        "date": "2026-04-15 00:00:00",
+        "start": "2026-04-15T04:00:00.000Z",
+        "end": "2026-04-16T04:00:00.000Z",
+        "name": "Tax Day",
+        "type": "observance",
+        "dayOfWeek": "Wednesday",
+        "englishName": "Tax Day"
       },
       {
-        "date": "2025-04-23 00:00:00",
-        "start": "2025-04-23T04:00:00Z",
-        "end": "2025-04-24T04:00:00Z",
+        "date": "2026-04-22 00:00:00",
+        "start": "2026-04-22T04:00:00.000Z",
+        "end": "2026-04-23T04:00:00.000Z",
         "name": "Administrative Professionals Day",
-        "type": "observance"
+        "type": "observance",
+        "dayOfWeek": "Wednesday",
+        "englishName": "Administrative Professionals Day"
       },
       {
-        "date": "2025-05-11 00:00:00",
-        "start": "2025-05-11T04:00:00Z",
-        "end": "2025-05-12T04:00:00Z",
+        "date": "2026-05-10 00:00:00",
+        "start": "2026-05-10T04:00:00.000Z",
+        "end": "2026-05-11T04:00:00.000Z",
         "name": "Mother's Day",
-        "type": "observance"
+        "type": "observance",
+        "dayOfWeek": "Sunday",
+        "englishName": "Mother's Day"
       },
       {
-        "date": "2025-05-26 00:00:00",
-        "start": "2025-05-26T04:00:00Z",
-        "end": "2025-05-27T04:00:00Z",
+        "date": "2026-05-25 00:00:00",
+        "start": "2026-05-25T04:00:00.000Z",
+        "end": "2026-05-26T04:00:00.000Z",
         "name": "Memorial Day",
-        "type": "public"
+        "type": "public",
+        "dayOfWeek": "Monday",
+        "englishName": "Memorial Day"
       },
       {
-        "date": "2025-06-15 00:00:00",
-        "start": "2025-06-15T04:00:00Z",
-        "end": "2025-06-16T04:00:00Z",
+        "date": "2026-06-19 00:00:00",
+        "start": "2026-06-19T04:00:00.000Z",
+        "end": "2026-06-20T04:00:00.000Z",
+        "name": "Juneteenth",
+        "type": "public",
+        "dayOfWeek": "Friday",
+        "englishName": "Juneteenth"
+      },
+      {
+        "date": "2026-06-21 00:00:00",
+        "start": "2026-06-21T04:00:00.000Z",
+        "end": "2026-06-22T04:00:00.000Z",
         "name": "Father's Day",
-        "type": "observance"
+        "type": "observance",
+        "dayOfWeek": "Sunday",
+        "englishName": "Father's Day"
       },
       {
-        "date": "2025-06-19 00:00:00",
-        "start": "2025-06-19T04:00:00Z",
-        "end": "2025-06-20T04:00:00Z",
-        "name": "Juneteenth",
-        "type": "public"
+        "date": "2026-07-03 00:00:00",
+        "start": "2026-07-03T04:00:00.000Z",
+        "end": "2026-07-04T04:00:00.000Z",
+        "name": "Independence Day (substitute day)",
+        "type": "public",
+        "substitute": true,
+        "dayOfWeek": "Friday",
+        "englishName": "Independence Day (substitute day)"
       },
       {
-        "date": "2025-07-04 00:00:00",
-        "start": "2025-07-04T04:00:00Z",
-        "end": "2025-07-05T04:00:00Z",
+        "date": "2026-07-04 00:00:00",
+        "start": "2026-07-04T04:00:00.000Z",
+        "end": "2026-07-05T04:00:00.000Z",
         "name": "Independence Day",
-        "type": "public"
+        "type": "public",
+        "dayOfWeek": "Saturday",
+        "englishName": "Independence Day"
       },
       {
-        "date": "2025-09-01 00:00:00",
-        "start": "2025-09-01T04:00:00Z",
-        "end": "2025-09-02T04:00:00Z",
+        "date": "2026-09-07 00:00:00",
+        "start": "2026-09-07T04:00:00.000Z",
+        "end": "2026-09-08T04:00:00.000Z",
         "name": "Labor Day",
-        "type": "public"
+        "type": "public",
+        "dayOfWeek": "Monday",
+        "englishName": "Labour Day"
       },
       {
-        "date": "2025-10-13 00:00:00",
-        "start": "2025-10-13T04:00:00Z",
-        "end": "2025-10-14T04:00:00Z",
+        "date": "2026-10-12 00:00:00",
+        "start": "2026-10-12T04:00:00.000Z",
+        "end": "2026-10-13T04:00:00.000Z",
         "name": "Columbus Day",
-        "type": "public"
+        "type": "public",
+        "dayOfWeek": "Monday",
+        "englishName": "Columbus Day"
       },
       {
-        "date": "2025-10-31 18:00:00",
-        "start": "2025-10-31T22:00:00Z",
-        "end": "2025-11-01T04:00:00Z",
+        "date": "2026-10-31 18:00:00",
+        "start": "2026-10-31T22:00:00.000Z",
+        "end": "2026-11-01T04:00:00.000Z",
         "name": "Halloween",
-        "type": "observance"
+        "type": "observance",
+        "dayOfWeek": "Saturday",
+        "englishName": "Halloween"
       },
       {
-        "date": "2025-11-11 00:00:00",
-        "start": "2025-11-11T05:00:00Z",
-        "end": "2025-11-12T05:00:00Z",
+        "date": "2026-11-11 00:00:00",
+        "start": "2026-11-11T05:00:00.000Z",
+        "end": "2026-11-12T05:00:00.000Z",
         "name": "Veterans Day",
-        "type": "public"
+        "type": "public",
+        "dayOfWeek": "Wednesday",
+        "englishName": "Veterans Day"
       },
       {
-        "date": "2025-11-27 00:00:00",
-        "start": "2025-11-27T05:00:00Z",
-        "end": "2025-11-28T05:00:00Z",
+        "date": "2026-11-26 00:00:00",
+        "start": "2026-11-26T05:00:00.000Z",
+        "end": "2026-11-27T05:00:00.000Z",
         "name": "Thanksgiving Day",
-        "type": "public"
+        "type": "public",
+        "dayOfWeek": "Thursday",
+        "englishName": "Thanksgiving Day"
       },
       {
-        "date": "2025-11-28 00:00:00",
-        "start": "2025-11-28T05:00:00Z",
-        "end": "2025-11-29T05:00:00Z",
+        "date": "2026-11-27 00:00:00",
+        "start": "2026-11-27T05:00:00.000Z",
+        "end": "2026-11-28T05:00:00.000Z",
         "name": "Day after Thanksgiving Day",
-        "type": "observance"
+        "type": "observance",
+        "dayOfWeek": "Friday",
+        "englishName": "Day after Thanksgiving Day"
       },
       {
-        "date": "2025-12-24 00:00:00",
-        "start": "2025-12-24T05:00:00Z",
-        "end": "2025-12-25T05:00:00Z",
+        "date": "2026-12-24 00:00:00",
+        "start": "2026-12-24T05:00:00.000Z",
+        "end": "2026-12-25T05:00:00.000Z",
         "name": "Christmas Eve",
-        "type": "optional"
+        "type": "optional",
+        "dayOfWeek": "Thursday",
+        "englishName": "Christmas Eve"
       },
       {
-        "date": "2025-12-25 00:00:00",
-        "start": "2025-12-25T05:00:00Z",
-        "end": "2025-12-26T05:00:00Z",
+        "date": "2026-12-25 00:00:00",
+        "start": "2026-12-25T05:00:00.000Z",
+        "end": "2026-12-26T05:00:00.000Z",
         "name": "Christmas Day",
-        "type": "public"
+        "type": "public",
+        "dayOfWeek": "Friday",
+        "englishName": "Christmas Day"
       },
       {
-        "date": "2025-12-31 00:00:00",
-        "start": "2025-12-31T05:00:00Z",
-        "end": "2026-01-01T05:00:00Z",
+        "date": "2026-12-31 00:00:00",
+        "start": "2026-12-31T05:00:00.000Z",
+        "end": "2027-01-01T05:00:00.000Z",
         "name": "New Year's Eve",
-        "type": "observance"
+        "type": "observance",
+        "dayOfWeek": "Thursday",
+        "englishName": "New Year's Eve"
       }
     ]
   }

package/index.d.ts

@@ -26,16 +26,19 @@ declare module '@apiverve/worldholidays' {
 
   interface WorldHolidaysData {
       country:  null | string;
-      year:     null | string;
+      year:     number | null;
       holidays: Holiday[];
   }
   
   interface Holiday {
-      date:  Date | null;
-      start: Date | null;
-      end:   Date | null;
-      name:  null | string;
-      type:  Type | null;
+      date:        Date | null;
+      start:       Date | null;
+      end:         Date | null;
+      name:        null | string;
+      type:        Type | null;
+      dayOfWeek:   null | string;
+      englishName: null | string;
+      substitute?: boolean | null;
   }
   
   enum Type {

package/index.js

@@ -30,7 +30,7 @@ class worldholidaysWrapper {
         this.baseURL = 'https://api.apiverve.com/v1/worldholidays';
 
         // Validation rules for parameters (generated from schema)
-        this.validationRules = {"country":{"type":"string","required":true,"minLength":2,"maxLength":2},"year":{"type":"integer","required":false,"min":2000,"max":2050,"default":2026}};
+        this.validationRules = {"country":{"type":"string","required":true,"minLength":2,"maxLength":2},"year":{"type":"integer","required":false,"min":2000,"max":2050,"default":2026},"region":{"type":"string","required":false},"type":{"type":"string","required":false},"date":{"type":"string","required":false,"format":"date"}};
     }
 
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apiverve/worldholidays",
-  "version": "1.2.4",
-  "description": "World Holidays lists public holidays and observances for any two-letter country code. It returns holiday dates, official names, and event types across the year.",
+  "version": "1.2.5",
+  "description": "World Holidays lists public holidays and observances for any two-letter country code, optionally for a state or region. It returns holiday dates, local and English names, day of week, event types and substitute-day flags, and can check whether a single date is a holiday.",
   "main": "index.js",
   "types": "index.d.ts",
   "sideEffects": false,