feat(cdsl): parse NPS holdings (holdings-only)

[codereverser]

Adds support for NPS holdings (CDSL only)

  nps: {                                 // National Pension System, if present (CDSL)
    pran: string | null,                 // PRAN (as printed; often masked)
    nps_sp: string | null,               // NPS service provider / CRA, e.g. "PROT"
    value: decimal,                      // reported NPS portfolio value
    schemes: {
      scheme: string, fund_manager: string | null,
      tier: string | null,               // "I" | "II"
      asset_class: string | null,        // "E" | "C" | "G" | "A"
      units: decimal, nav: decimal, value: decimal,
    }[],
  } | null,

[codecov]

Codecov Report

❌ Patch coverage is 93.38843% with 8 lines in your changes missing coverage. Please review.
✅ Project coverage is 94.97%. Comparing base (b5273fd) to head (dd0ad0f).

Files with missing lines	Patch %	Lines
casparser/parsers/cdsl.py	94.85%	5 Missing ⚠️
casparser/types.py	87.50%	3 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #143      +/-   ##
==========================================
- Coverage   95.04%   94.97%   -0.06%     
==========================================
  Files          19       19              
  Lines        2858     2979     +121     
==========================================
+ Hits         2716     2829     +113     
- Misses        142      150       +8     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[codereverser]

@mvineetmenon I've pushed a first draft of CDSL NPS support in this branch (feat/nps-cdsl). Can you please test and provide feedback?

If you have uv installed, you could test it via

uvx --from git+https://github.com/codereverser/casparser@feat/nps-cdsl casparser your_cdsl.pdf

# OR

uvx --from git+https://github.com/codereverser/casparser@feat/nps-cdsl casparser your_cdsl.pdf -o /tmp/cdsl_nps.json

Can you please confirm if the numbers match your statement?

[mvineetmenon]

@codereverser Congratuations and thanks for implementing this feature.
The numbers are getting parsed correct. I checked this branch with three CASes. But in the latest MAY2026 CAS there was a problem with the fund name.

[mvineetmenon]

Yes, the issue is fixed. Everything is getting parsed correctly.

Thanks @codereverser

[codereverser]

Many thanks for testing. Merging this.

NPS is CDSL holdings only now. Transaction support and NSDL NPS would be done separately.