• Project:Sri Lanka Holidays SDK is a completed software engineering solution.
• Status:Completed & Published (v1.1.2)
• Total Downloads:675+ (Live sum across all 7 platforms)

Sri Lanka Holidays SDK – Multi-Language Open-Source Holiday & Payroll Compliance Ecosystem

Sri Lanka Holidays (sri-lanka-holidays) is a lightweight, zero-dependency, multi-language open-source SDK ecosystem engineered to provide official Sri Lanka Public, Bank, and Mercantile Holidays (including Full Moon Poya Days) for 2026 and 2027, powered by a canonical JSON architecture for effortless future updates. Designed specifically for HR, payroll, leave management, banking, fintech, and enterprise scheduling systems operating in Sri Lanka, the ecosystem bridges a critical compliance gap under the Holidays Act, No. 29 of 1971, Central Bank of Sri Lanka (CBSL) guidelines, and the Shop and Office Employees Act. Published natively across 7 major global package registries—npm, Packagist, NuGet, Crates.io, pkg.go.dev, PyPI, and pub.dev—it empowers engineering teams to query, filter, and validate statutory holidays seamlessly in any backend, web, or mobile technology stack.

🌐 Multi-Language & Framework Packages

All libraries in this repository share the same canonical JSON dataset (data/2026.json, data/2027.json) via npm run sync.

Total Verified Downloads: 675+ (Live combined sum across 7 official platforms):

• Node.js / TypeScript: npmjs.com/package/sri-lanka-holidays — npm install sri-lanka-holidays — packages/npm (659 downloads)
• PHP & Laravel: packagist.org/packages/sahanranasingha/sri-lanka-holidays — composer require sahanranasingha/sri-lanka-holidays — packages/laravel (9 downloads)
• .NET / C#: nuget.org/packages/SriLankaHolidays — dotnet add package SriLankaHolidays — packages/dotnet (Official NuGet)
• Rust: crates.io/crates/sri-lanka-holidays — cargo add sri-lanka-holidays — packages/rust (7 downloads)
• Go: pkg.go.dev/github.com/sahanRanasingha/sri-lanka-holidays/packages/go — go get github.com/sahanRanasingha/sri-lanka-holidays/packages/go — packages/go (Go Proxy)
• Python (Django/FastAPI): pypi.org/project/sri-lanka-holidays/ — pip install sri-lanka-holidays — packages/python (Official PyPI)
• Flutter / Dart: pub.dev/packages/sri_lanka_holidays — flutter pub add sri_lanka_holidays — packages/dart (Official pub.dev)
• GitHub Monorepo: https://github.com/sahanRanasingha/sri-lanka-holidays

🌟 Key Features:

• 7-Ecosystem Multi-Language Parity: Native idiomatic SDK implementations across JavaScript/TypeScript, PHP/Laravel (with Service Provider & Facade), .NET 8+, Rust, Go, Python, and Flutter/Dart (with DateTime extensions)—all exposing a consistent, ergonomic API.
• Statutory Sector-Specific Filtering (Public, Bank, Mercantile & Poya): Accurately distinguishes between government Public holidays, CBSL Bank holidays, and private-sector Mercantile holidays under the Shop and Office Employees Act (e.g., identifying that Good Friday, Maha Sivarathri, Id-Ul-Fitr, Id-Ul-Alha, and Deepavali are Public & Bank holidays only, not Mercantile).
• Canonical JSON-First Data Synchronization: Powered by a single source of truth (data/2026.json and data/2027.json) and an automated synchronization pipeline (scripts/sync-data.js) that propagates verified holiday datasets and generates embedded assets across all 7 language packages in a single command.
• Runtime Extensibility for 2028+ Calendars: Supports dynamic runtime ingestion via addHolidaysForYear() and loadHolidaysFromJson(), allowing enterprise applications to load newly gazetted future holiday JSON datasets without requiring code changes or redeployment.
• Coinciding Multi-Holiday Resolution: Intelligently resolves dates where multiple holidays overlap on the same calendar day, ensuring zero false negatives when evaluating combined Public, Bank, Mercantile, and Full Moon Poya Day statuses.
• Hardened Security & Calendar Validation: Engineered with strict defense-in-depth protections against prototype pollution (__proto__, constructor, prototype), JSON recursion depth abuse, leap-year calendar rollover bugs (e.g., rejecting 2026-02-29), and weekday spoofing (utilizing Sakamoto's algorithm and UTC calendar verification).
• Immutable In-Memory Store & Zero Runtime Dependencies: Returns deeply cloned or read-only holiday records across all languages to prevent accidental cache mutation, with zero external runtime dependencies for maximum supply-chain security and sub-millisecond lookups.
• Automated OIDC Trusted Publishing & CI/CD: Backed by multi-runtime GitHub Actions workflows that execute unit test suites across all 7 languages and automate cryptographic package publishing with digital provenance attestations.

🛠️ Technologies Used:

• Node.js (Dual CommonJS & ES Modules) & TypeScript (.d.ts Type Definitions) for Sri Lanka Holidays SDK.
• PHP 8.1+ & Laravel 10/11/12 (Auto-Discovered Service Provider & Facade)
• .NET 8.0 / C# 12 (Embedded Manifest Resources & System.Text.Json)
• Rust (2021 Edition, Serde JSON & Compile-Time Embedded Datasets)
• Go 1.21+ (//go:embed Virtual Filesystem & Thread-Safe sync.RWMutex Store)
• Python 3.8+ (Frozen Dataclasses, pyproject.toml & PEP 561 py.typed)
• Dart 3.0+ & Flutter (Unmodifiable Collections & Native DateTime Extensions)
• GitHub Actions CI/CD & OpenID Connect (OIDC) Trusted Publishing
• Sigstore Digital Attestations & Cross-Ecosystem Automated Testing

📦 Highlights:

• Sri Lanka's First 7-Language Open-Source Holiday & Payroll Compliance SDK Ecosystem
• Published Live on npm, Packagist, NuGet, Crates.io, pkg.go.dev, PyPI & pub.dev
• Exact Statutory Distinction Between Public, Bank, Mercantile & Full Moon Poya Holidays
• Single Canonical JSON Dataset Synchronized Automatically Across All 7 Language Runtimes
• Hardened Against Prototype Pollution, Weekday Spoofing & Invalid Leap-Year Rollovers
• Zero External Runtime Dependencies with Sub-Millisecond In-Memory Lookups
• Idiomatic Framework Integrations Including Laravel Facades & Flutter DateTime Extensions
• Automated Multi-Registry CI/CD with OIDC Trusted Publishing & Provenance Attestations

🔖 Skills:

• Multi-Language SDK Architecture & Cross-Ecosystem API Design
• Open-Source Package Engineering & Registry Governance (npm, Packagist, NuGet, Crates, Go, PyPI, pub.dev)
• Polyglot Software Development (TypeScript, PHP/Laravel, C#/.NET, Rust, Go, Python, Dart/Flutter)
• Application Security Auditing, Input Validation & Prototype Pollution Prevention
• Monorepo Build Tooling & Automated Code/Data Synchronization Pipelines
• DevSecOps, GitHub Actions CI/CD & OIDC Trusted Publishing Automation
• HRTech, FinTech & Statutory Payroll Compliance Domain Modeling
• Technical Documentation, Semantic Versioning & Community Open-Source Maintenance

🏗️ Sri Lanka Holidays SDK Architecture & Engineering Impact:

This solution delivers a reliable, high-performance user experience through modular software architecture and structured design patterns. Specifically, the system separates presentation components from core business logic to maximize execution speed. Therefore, developers can maintain and extend the application without introducing regressions. Additionally, automated validation checks verify every user input before processing data. Consequently, the application maintains strong security and consistent responsiveness across both desktop and mobile environments.

In addition, the underlying codebase emphasizes clean modularity and long-term maintainability across every deployment environment. Specifically, each functional layer operates independently with clear data contracts and predictable state management. Therefore, future feature expansions require minimal refactoring or operational downtime. As a result, Sri Lanka Holidays SDK serves as a dependable blueprint for modern production software.

Moreover, the platform incorporates clean design principles to simplify complex workflows for end users. For instance, interactive visual feedback guides users smoothly through every step of the process. Meanwhile, optimized asset loading minimizes latency during peak traffic periods. Furthermore, the complete technical implementation follows modern open-source standards and industry best practices. Finally, to discuss custom full-stack software solutions or explore similar builds, visit the contact page or browse the complete engineering portfolio.