# pakdatakit 2.2.0

> Release notes for pakdatakit 2.2.0 (TypeScript, Python, Dart): what changed, what was fixed and how to upgrade.

Source: https://pakdatakit.dev/releases/2.2.0/

## TypeScript (npm)

[pakdatakit 2.2.0](https://www.npmjs.com/package/pakdatakit/v/2.2.0)

### Added

- `getBankInfo(ibanOrCode)` and `getBanks()`: bank name, type (commercial,
  Islamic, microfinance, digital, EMI, foreign, specialized, central), whether
  it still exists, and its current code.
- API reference and `llms.txt` / `llms-full.txt` at
  https://chmuzamil.github.io/pakdatakit/.
- New packages from this repository: `pakdatakit` for Python (PyPI) and
  `pakdatakit-react` (React inputs and a Raast QR component).
- `pakdatakit/input`: as-you-type formatters (`formatCNICInput`,
  `formatPhoneInput`, `formatIBANInput`) and checkers (`checkCNICInput`,
  `checkPhoneInput`, `checkIBANInput`) that return `empty`, `incomplete`,
  `valid` or `invalid`.
- `createRaastP2PQr` accepts `expiresIn` (`30m`, `12h`, `7d` or
  milliseconds) instead of `expiresAt`.
- `validateRaastQr()`: checks a scanned QR for a bad checksum, missing or
  invalid IBAN, expiry and other problems before payment.
- `dataVersion` export and `DATA.md` documenting each dataset's sources.
- Banks: `NAYA` (NayaPay), `BKCH` (Bank of China), `SMES` (SME Bank),
  `WMBL` (Mobilink Bank's older code), and the digital banks `RQMI` (Raqami)
  and `MSHQ` (Mashreq Bank Pakistan).
- Districts: Allai, Central Dir, Paharpur and Upper Swat (Khyber
  Pakhtunkhwa); Quetta East, Quetta West, North and South Dera Bugti,
  Barshore, Tump and Wadh (Balochistan, July 2026). 177 districts in total.

### Fixed

- `createRaastP2PQr` / `createMerchantQr` reject amounts that would be
  written in exponent form (e.g. `1e21`).
- `parseRaastQr` reads only plain numeric amounts and rejects impossible
  expiry dates; `createMerchantQr` writes account sub-fields in ID order.
- `numberToWords` / `amountInWords` reject unknown languages.
- `getDistrictProvince` no longer returns built-in object properties.
- Khushhali Microfinance Bank's IBAN code is `KHBL`, not `KMBL`.
- Removed `PAKB` (Pak Oman), which no real IBAN supports.
- `getDistrictProvince` still resolves districts that were split or renamed
  (Quetta, Dera Bugti, Upper Dera Bugti, South Waziristan).

## Python (PyPI)

[pakdatakit 2.2.0](https://pypi.org/project/pakdatakit/2.2.0/)

First release of the Python package.

- Pure Python 3.9+, no dependencies: the same functions as the npm package in
  snake_case, with the same datasets.
- Checked against the TypeScript library with over 12,000 shared test cases,
  so both give the same results.
- See the main [CHANGELOG](https://github.com/chmuzamil/pakdatakit/blob/main/CHANGELOG.md)
  for what 2.2.0 includes.

## Dart (pub.dev)

[pakdatakit 2.2.0](https://pub.dev/packages/pakdatakit/versions/2.2.0)

Initial Dart release, matching version 2.2.0 of the
[`pakdatakit` npm package](https://github.com/chmuzamil/pakdatakit) (datasets
checked 2026-10-14).

- Every function of the npm package, with the same names: CNIC, mobile
  numbers and networks, WhatsApp links, IBAN and banks, postal codes, cities
  and districts, address parsing, text and Roman Urdu, Hijri dates, public
  holidays, PKR formatting, amounts in words, NTN/STRN, landlines and other
  numbers, Raast QR codes, and form-input helpers.
- Pure Dart with no dependencies; the datasets are embedded, so it works on
  every platform, including Flutter web.
- Per-module libraries mirroring the npm entry points
  (`package:pakdatakit/cnic.dart`, …).
- Tested against the 12,080 shared test vectors generated from the
  TypeScript library, on the Dart VM and compiled to JavaScript.
