API Release Changelog
Track features, dataset updates, security enhancements, and version releases for the Sri Lankan Holiday API.
Major feature release introducing multi-language localization (Sinhala & Tamil), custom timezone queries, and Date Intelligence range analysis (GET /api/v3/date/range) for HR leave management, payroll, and invoice delivery estimates.
Features
- Multi-Language Localization: Full Sinhala (si / si-LK), Tamil (ta / ta-LK), and English (en / en-LK) support for holiday names, descriptions, day of week names, and categories.
- Date Intelligence Range Analysis: New endpoint GET /api/v3/date/range?from=2026-08-01&to=2026-08-31 returning totalDays, weekends, holidays, and businessDays.
- Timezone Support: Query API and SDK in custom IANA timezones via ?timezone=... (e.g., Asia/Colombo, UTC, America/New_York).
- Node SDK v3.2.1: Exported analyzeDateRange(), getLocalizedHoliday(), and updated SriLankanHolidayAPI client methods.
Documentation
- Updated Swagger OpenAPI 3.0 specs with GET /api/v3/date/range and localization parameter schemas.
- Updated README.md and root CHANGELOG.md.
Stabilized release of the /api/v3 REST API and v3.2.0 Node.js SDK (sri-lankan-holiday-api) on NPM featuring 100% real-time Live System Status telemetry, advanced working days calculator, weekend helpers, AI SEO (AEO/GEO) optimizations, and expanded OpenAPI 3.0 specs.
Features
- Stabilized REST API /v3 endpoints (/api/v3, /api/v3/holidays, /api/v3/holidays/today, /api/v3/holidays/upcoming, /api/v3/holidays/poya, /api/v3/holidays/search, /api/v3/holidays/working-days, /api/v3/holidays/range, /api/v3/holidays/stats, /api/v3/status, /api/v3/health).
- Upgraded Node.js SDK (sri-lankan-holiday-api) to v3.2.0 with new functions: getVersion(), isWeekend(), getWorkableDaysInRange(), getHolidaySummary(), and filterHolidays().
- 100% Dynamic Live System Status widget with real-time active user session tracking, server uptime, request counters, and memory diagnostics.
- Enhanced SriLankanHolidayAPI client class to automatically target /api/v3 endpoints with offline dataset fallbacks.
Security
- Full AI search bot crawling permissions in robots.txt for GPTBot, ChatGPT-User, PerplexityBot, ClaudeBot, anthropic-ai, Google-Extended, and Bingbot.
- Comprehensive JSON-LD structured schema markup (SoftwareApplication v3.2.0, Dataset, FAQPage, BreadcrumbList, Organization).
Documentation
- Updated Swagger OpenAPI 3.0 documentation playground with all /api/v3 paths and response models.
- Updated NPM Module documentation page at /npm-module with v3.2.0 code examples and interactive sandbox.
Official release of the zero-dependency, 100% offline-ready sri-lankan-holiday-api Node.js module on NPM with TypeScript typings, CJS/ESM dual builds, Vercel build pipeline integration, and dedicated /npm-module interactive documentation route.
Features
- Published official Node.js SDK (sri-lankan-holiday-api) supporting zero-network offline query execution.
- Bundled complete 858+ hand-verified Sri Lanka public, bank & Poya holiday dataset (2024–2045) inside the package.
- Added dual CommonJS (require) and ES Module (import) exports with full TypeScript declaration types.
- Added SriLankanHolidayAPI hybrid client class supporting live remote REST API calls with automatic offline fallback.
- Created interactive web documentation route at /npm-module featuring live in-browser method sandbox tester.
Documentation
- Launched dedicated NPM Package documentation page at /npm-module with copyable install scripts (npm, yarn, pnpm, bun) & code snippets.
- Added NPM Package navigation links across main header navbar, mobile menu drawer, and footer.
Major release featuring 100% hand-researched Sri Lankan Government Gazette dataset, new API v2 endpoint suite with full-text search, pagination, multi-upcoming limit support, and dataset analytics.
Dataset
- Replaced procedural formula calculations with 100% hand-researched official Sri Lankan Government Gazette holiday dates (2024–2030).
- Verified exact August 27, 2026 Nikini Full Moon Poya Day date and Adhi Nikini Poya alignment.
- Validated all Buddhist Poya days, Hindu Tamil festivals, Islamic lunar observances, and Christian holidays.
Features
- Added GET /api/v2/holidays with search, multi-field filtering, sorting (date_asc, date_desc), and page-based pagination.
- Added GET /api/v2/holidays/poya dedicated endpoint returning official Sri Lanka Full Moon Poya days.
- Added GET /api/v2/holidays/next-poya endpoint returning the immediate next Poya day with live daysUntil countdown.
- Added GET /api/v2/holidays/religion/[religion] filtering holidays by tradition (buddhist, hindu, islamic, christian, national).
- Added GET /api/v2/holidays/upcoming with ?limit=N parameter supporting multi-upcoming holiday queries.
- Added GET /api/v2/holidays/search for full-text keyword queries.
- Added GET /api/v2/holidays/stats for dataset breakdown analytics and real-time telemetry.
Documentation
- Updated /docs portal with v1 vs v2 API version tabs and live endpoint execution test buttons.
- Created dedicated API Changelog page (/changelog) tracking version history.
Security hardening, Edge DDoS sliding-window rate limiting, custom Next.js docs portal, diagnostic health endpoint, and AI Vibe Coder system prompt.
Security
- Implemented Edge Sliding-Window Rate Limiting (60 requests / min per IP) in middleware.ts.
- Added strict HTTP security headers: HSTS, X-Frame-Options, X-Content-Type-Options, XSS-Protection, and CORS.
Features
- Built native Next.js documentation portal at /docs replacing external swagger bundles.
- Upgraded GET /api/v1/health returning detailed system uptime, memory usage, dataset metrics, and rate limit status.
- Added Master AI System Prompt tab for developers using Cursor, ChatGPT, Claude, or Copilot.
Extended multi-year dataset coverage to 2045 and added full dataset export tools in JSON and CSV formats.
Features
- Added GET /api/v1/holidays/export endpoint supporting ?format=json and ?format=csv downloads.
- Expanded holiday catalog from 2024 to 2045 (22 years coverage).
Initial public launch of Sri Lankan Holiday REST API.
Features
- Launched REST API endpoints for Sri Lankan public, bank, and Poya holidays.
- Added filters by year, month, date, and holiday type.