pakdatakit 2.2.1 → 2.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/DATA.md +302 -33
- package/README.md +172 -27
- package/dist/address.cjs +5 -5
- package/dist/address.js +3 -3
- package/dist/{chunk-4VSGCQ6K.cjs → chunk-2OBKPYJZ.cjs} +3 -3
- package/dist/chunk-33QMFE2Z.js +21244 -0
- package/dist/chunk-7E7L3NYS.cjs +11 -0
- package/dist/{chunk-TTARJWGT.js → chunk-A3HBEBXY.js} +2 -2
- package/dist/{chunk-3ZA265SK.cjs → chunk-AUQFA7EE.cjs} +172 -4
- package/dist/{chunk-HBOZIITD.js → chunk-CADQM4ZN.js} +14 -14
- package/dist/{chunk-3IARSCO6.cjs → chunk-DHOP7LQX.cjs} +25 -14
- package/dist/chunk-E6HSKRAE.js +9 -0
- package/dist/{chunk-33FXHM2E.cjs → chunk-ESKXG7Y6.cjs} +5 -5
- package/dist/{chunk-U7MWHXMF.cjs → chunk-FRBPAGEJ.cjs} +4 -4
- package/dist/chunk-I7UUPD3G.cjs +21252 -0
- package/dist/{chunk-YPPKY5XZ.js → chunk-IBZPJS4H.js} +26 -15
- package/dist/{chunk-47P7HILD.cjs → chunk-J5ARB4TE.cjs} +8 -8
- package/dist/{chunk-XCXFGTHW.cjs → chunk-J5ZF46NZ.cjs} +14 -14
- package/dist/{chunk-NZQ47NWD.js → chunk-KRYHLYN2.js} +1 -1
- package/dist/{chunk-RXNYY5K5.js → chunk-LQHM3ADX.js} +172 -4
- package/dist/{chunk-HTERSQGF.cjs → chunk-MTS6SVNP.cjs} +4 -4
- package/dist/chunk-N4S22XX3.js +6208 -0
- package/dist/chunk-OKMBYX3F.cjs +6220 -0
- package/dist/{chunk-6IPPANNX.js → chunk-P7LVE2TF.js} +2 -2
- package/dist/chunk-RZQJAZKC.js +22 -0
- package/dist/{chunk-PLDVGOKZ.js → chunk-S274QFFB.js} +2 -2
- package/dist/chunk-SQIHFEXI.cjs +25 -0
- package/dist/chunk-TBTWZC74.cjs +32 -0
- package/dist/{chunk-NAJGGUAM.cjs → chunk-TC3VRWZV.cjs} +2 -2
- package/dist/{chunk-QKH7W2CC.js → chunk-TQP2T33V.js} +5 -5
- package/dist/{chunk-AZV45DMG.js → chunk-V2XE3NCG.js} +2 -2
- package/dist/{chunk-NTD4JLDW.cjs → chunk-YTLE5K7G.cjs} +1 -1
- package/dist/{chunk-HUQY2WR5.js → chunk-YTSMFGTW.js} +13 -3
- package/dist/{chunk-EMH4IP2U.js → chunk-ZRONAQBV.js} +1 -1
- package/dist/class-validator.cjs +57 -0
- package/dist/class-validator.d.cts +57 -0
- package/dist/class-validator.d.ts +57 -0
- package/dist/class-validator.js +47 -0
- package/dist/cli.js +1 -1
- package/dist/geo.cjs +22 -6
- package/dist/geo.d.cts +56 -1
- package/dist/geo.d.ts +56 -1
- package/dist/geo.js +1 -1
- package/dist/holidays.cjs +4 -4
- package/dist/holidays.js +1 -1
- package/dist/iban.cjs +5 -5
- package/dist/iban.d.cts +8 -6
- package/dist/iban.d.ts +8 -6
- package/dist/iban.js +1 -1
- package/dist/index.cjs +106 -68
- package/dist/index.d.cts +5 -3
- package/dist/index.d.ts +5 -3
- package/dist/index.js +16 -14
- package/dist/input.cjs +9 -9
- package/dist/input.js +3 -3
- package/dist/joi.cjs +37 -0
- package/dist/joi.d.cts +24 -0
- package/dist/joi.d.ts +24 -0
- package/dist/joi.js +31 -0
- package/dist/networks.cjs +3 -3
- package/dist/networks.js +2 -2
- package/dist/numbers.cjs +6 -6
- package/dist/numbers.js +2 -2
- package/dist/passport.cjs +11 -0
- package/dist/passport.d.cts +27 -0
- package/dist/passport.d.ts +27 -0
- package/dist/passport.js +2 -0
- package/dist/phone.cjs +8 -8
- package/dist/phone.js +3 -3
- package/dist/postal.cjs +14 -6
- package/dist/postal.d.cts +54 -2
- package/dist/postal.d.ts +54 -2
- package/dist/postal.js +1 -1
- package/dist/raast.cjs +6 -6
- package/dist/raast.js +2 -2
- package/dist/superstruct.cjs +35 -0
- package/dist/superstruct.d.cts +24 -0
- package/dist/superstruct.d.ts +24 -0
- package/dist/superstruct.js +33 -0
- package/dist/valibot.cjs +12 -8
- package/dist/valibot.d.cts +2 -0
- package/dist/valibot.d.ts +2 -0
- package/dist/valibot.js +11 -7
- package/dist/vehicle.cjs +15 -0
- package/dist/vehicle.d.cts +43 -0
- package/dist/vehicle.d.ts +43 -0
- package/dist/vehicle.js +2 -0
- package/dist/whatsapp.cjs +3 -3
- package/dist/whatsapp.js +2 -2
- package/dist/yup.cjs +12 -8
- package/dist/yup.d.cts +2 -0
- package/dist/yup.d.ts +2 -0
- package/dist/yup.js +11 -7
- package/dist/zod.cjs +12 -8
- package/dist/zod.d.cts +2 -0
- package/dist/zod.d.ts +2 -0
- package/dist/zod.js +11 -7
- package/package.json +101 -3
- package/dist/chunk-34CJGJ67.cjs +0 -1697
- package/dist/chunk-4VVFS6FN.cjs +0 -715
- package/dist/chunk-E6DT2DWQ.js +0 -1689
- package/dist/chunk-GJENL6VK.cjs +0 -22
- package/dist/chunk-LIYNKIKS.js +0 -709
package/README.md
CHANGED
|
@@ -43,16 +43,20 @@ Validate CNICs, analyze phone numbers, detect networks, build WhatsApp links, ch
|
|
|
43
43
|
|
|
44
44
|
## 📦 Packages
|
|
45
45
|
|
|
46
|
-
| Package
|
|
47
|
-
|
|
|
48
|
-
| [`pakdatakit`](https://www.npmjs.com/package/pakdatakit)
|
|
49
|
-
| [`pakdatakit` (Python)](https://github.com/chmuzamil/pakdatakit/tree/main/python)
|
|
50
|
-
| [`pakdatakit-react`](https://github.com/chmuzamil/pakdatakit/tree/main/react)
|
|
51
|
-
| [`pakdatakit-faker`](https://github.com/chmuzamil/pakdatakit/tree/main/faker)
|
|
52
|
-
| [`pakdatakit` (Dart)](https://github.com/chmuzamil/pakdatakit/tree/main/dart)
|
|
53
|
-
| [`pakdatakit_flutter`](https://github.com/chmuzamil/pakdatakit/tree/main/flutter)
|
|
54
|
-
|
|
55
|
-
|
|
46
|
+
| Package | Install | For |
|
|
47
|
+
| ------------------------------------------------------------------------------------- | ---------------------------------------- | ---------------------------------------------------------------------------------------------- |
|
|
48
|
+
| [`pakdatakit`](https://www.npmjs.com/package/pakdatakit) | `npm install pakdatakit` | JavaScript and TypeScript (Node, browsers, Bun, Deno) |
|
|
49
|
+
| [`pakdatakit` (Python)](https://github.com/chmuzamil/pakdatakit/tree/main/python) | `pip install pakdatakit` | Python 3.9+, same functions in snake_case, same data |
|
|
50
|
+
| [`pakdatakit-react`](https://github.com/chmuzamil/pakdatakit/tree/main/react) | `npm install pakdatakit-react` | React inputs that format as you type, and a Raast QR component |
|
|
51
|
+
| [`pakdatakit-faker`](https://github.com/chmuzamil/pakdatakit/tree/main/faker) | `npm install -D pakdatakit-faker` | Seeded mock data: CNICs, phones, IBANs, addresses and whole personas that pass every validator |
|
|
52
|
+
| [`pakdatakit` (Dart)](https://github.com/chmuzamil/pakdatakit/tree/main/dart) | `dart pub add pakdatakit` | Dart and Flutter (including web), same functions and data |
|
|
53
|
+
| [`pakdatakit_flutter`](https://github.com/chmuzamil/pakdatakit/tree/main/flutter) | `flutter pub add pakdatakit_flutter` | Flutter input formatters, form fields and a Raast QR widget |
|
|
54
|
+
| [`PakDataKit` (.NET)](https://github.com/chmuzamil/pakdatakit/tree/main/dotnet) | Build from `dotnet/` (not on NuGet yet) | .NET 8, same functions and data, with DataAnnotations and FluentValidation packages |
|
|
55
|
+
| [`chmuzamil/pakdatakit` (PHP)](https://github.com/chmuzamil/pakdatakit/tree/main/php) | Build from `php/` (not on Packagist yet) | PHP 8.2+, same functions and data, with Laravel rules, rule objects and Eloquent casts |
|
|
56
|
+
| [`pakdatakit-vue`](https://github.com/chmuzamil/pakdatakit/tree/main/vue) | Build from `vue/` (not on npm yet) | Vue 3 composables and a `v-pak-input` directive that format as you type |
|
|
57
|
+
| [`pakdatakit-angular`](https://github.com/chmuzamil/pakdatakit/tree/main/angular) | Build from `angular/` (not on npm yet) | Angular directives, pipes and form validators |
|
|
58
|
+
|
|
59
|
+
The Python, Dart, .NET and PHP packages are checked against the TypeScript library with over 12,000 shared test cases, so all five give the same results.
|
|
56
60
|
|
|
57
61
|
---
|
|
58
62
|
|
|
@@ -66,20 +70,22 @@ The Python and Dart packages are checked against the TypeScript library with ove
|
|
|
66
70
|
|
|
67
71
|
## Why PakDataKit?
|
|
68
72
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
- Validate CNIC numbers
|
|
72
|
-
- Normalize mobile numbers
|
|
73
|
-
- Detect mobile networks
|
|
74
|
-
- Generate WhatsApp click-to-chat links
|
|
75
|
-
- Validate Pakistani IBANs and detect banks
|
|
76
|
-
- Look up postal codes and cities
|
|
77
|
-
- Map cities to provinces
|
|
78
|
-
- Format PKR values in Lakh and Crore conventions
|
|
73
|
+
Most Pakistani apps validate CNICs, mobile numbers and IBANs with a regex copied from somewhere. A regex checks the shape. PakDataKit checks what the shape can't show:
|
|
79
74
|
|
|
80
|
-
|
|
75
|
+
| Task | Typical regex | PakDataKit |
|
|
76
|
+
| ----------------- | ---------------------------- | ----------------------------------------------------------------------------------------------- |
|
|
77
|
+
| CNIC | 13 digits, maybe with dashes | Province code, province and gender decoding, Urdu digits |
|
|
78
|
+
| Mobile number | `03` + 9 digits | Allocated `03XX` prefixes only, `+92` / `0092` / `0` forms, original network |
|
|
79
|
+
| IBAN | `PK` + 22 characters | Mod-97 checksum, bank name and type from the bank code |
|
|
80
|
+
| NTN / STRN | Digit count | CNIC-based and business NTNs, display formats |
|
|
81
|
+
| Passport, plates | Usually not handled | Common-shape checks, with sources and limits in [DATA.md](./DATA.md) |
|
|
82
|
+
| Raast QR | Not possible | Create, parse and check payment QR codes (CRC, IBAN, amount, expiry) |
|
|
83
|
+
| Holidays, Hijri | Not possible | Observed Eid/Ashura/Milad dates from official notifications, Hijri conversion |
|
|
84
|
+
| Amounts, currency | Not possible | Lakh/crore formatting, amounts in words in English and Urdu |
|
|
85
|
+
| Forms | Write each rule per library | Ready rules for Zod, Valibot, Yup, Joi, Superstruct and class-validator (NestJS) |
|
|
86
|
+
| Other languages | Rewrite it | Python and Dart packages with the core functions, checked against over 12,000 shared test cases |
|
|
81
87
|
|
|
82
|
-
|
|
88
|
+
The npm package has no runtime dependencies, ships ESM and CommonJS with TypeScript types, and works offline: all data is bundled. Every dataset lists its sources in [DATA.md](./DATA.md).
|
|
83
89
|
|
|
84
90
|
---
|
|
85
91
|
|
|
@@ -139,7 +145,7 @@ import { validateCNIC } from 'pakdatakit/cnic';
|
|
|
139
145
|
const { analyzePhone } = require('pakdatakit/phone');
|
|
140
146
|
```
|
|
141
147
|
|
|
142
|
-
Subpaths: `address`, `cnic`, `format`, `geo`, `hijri`, `holidays`, `iban`, `input`, `networks`, `numbers`, `phone`, `postal`, `raast`, `tax`, `text`, `whatsapp`, `words`, plus the form adapters `zod`, `valibot` and `
|
|
148
|
+
Subpaths: `address`, `cnic`, `format`, `geo`, `hijri`, `holidays`, `iban`, `input`, `networks`, `numbers`, `passport`, `phone`, `postal`, `raast`, `tax`, `text`, `vehicle`, `whatsapp`, `words`, plus the form adapters `zod`, `valibot`, `yup`, `joi`, `superstruct` and `class-validator`.
|
|
143
149
|
|
|
144
150
|
---
|
|
145
151
|
|
|
@@ -396,7 +402,7 @@ getBankFromIBAN('invalid');
|
|
|
396
402
|
// null
|
|
397
403
|
```
|
|
398
404
|
|
|
399
|
-
Supported bank codes include HABB, MEZN, SCBL, UNIL, BAHL, NBPA, MUCB, JSBL, SADA (SadaPay), NAYA (NayaPay), RQMI (Raqami), MSHQ (Mashreq), and
|
|
405
|
+
Supported bank codes include HABB, MEZN, SCBL, UNIL, BAHL, NBPA, MUCB, JSBL, SADA (SadaPay), NAYA (NayaPay), RQMI (Raqami), MSHQ (Mashreq), and 50 total entries in the dataset, checked against real IBANs (see [DATA.md](./DATA.md)). Merged or renamed banks are labelled with their current name, e.g. `SAUD` → "Silkbank Limited (merged into United Bank Limited)".
|
|
400
406
|
|
|
401
407
|
---
|
|
402
408
|
|
|
@@ -404,7 +410,7 @@ Supported bank codes include HABB, MEZN, SCBL, UNIL, BAHL, NBPA, MUCB, JSBL, SAD
|
|
|
404
410
|
|
|
405
411
|
### getCityByPostalCode()
|
|
406
412
|
|
|
407
|
-
Returns the city for a Pakistani postal code.
|
|
413
|
+
Returns the city for a Pakistani postal code. Only codes of post offices in a city on pakdatakit's city list return a city; codes of offices in other towns and villages return `null` (use `getPostOffice()` for those).
|
|
408
414
|
|
|
409
415
|
```ts
|
|
410
416
|
getCityByPostalCode(postalCode: string): string | null
|
|
@@ -416,6 +422,12 @@ Examples:
|
|
|
416
422
|
getCityByPostalCode('60000');
|
|
417
423
|
// "Multan"
|
|
418
424
|
|
|
425
|
+
getCityByPostalCode('54660');
|
|
426
|
+
// "Lahore"
|
|
427
|
+
|
|
428
|
+
getCityByPostalCode('48330');
|
|
429
|
+
// null (a village post office; see getPostOffice)
|
|
430
|
+
|
|
419
431
|
getCityByPostalCode('99999');
|
|
420
432
|
// null
|
|
421
433
|
```
|
|
@@ -442,6 +454,30 @@ getPostalCode('karachi');
|
|
|
442
454
|
|
|
443
455
|
---
|
|
444
456
|
|
|
457
|
+
### getPostOffice() / searchPostOffices()
|
|
458
|
+
|
|
459
|
+
Every delivery post office in Pakistan Post's directory (about 2,560), including those in towns and villages.
|
|
460
|
+
|
|
461
|
+
```ts
|
|
462
|
+
getPostOffice(code: string): PostOffice | null
|
|
463
|
+
searchPostOffices(query: string): PostOffice[] // by office name, town or code prefix
|
|
464
|
+
```
|
|
465
|
+
|
|
466
|
+
```ts
|
|
467
|
+
getPostOffice('48330');
|
|
468
|
+
// { code: "48330", office: "Dulmial", town: "Dulmial", district: null, province: "Punjab" }
|
|
469
|
+
|
|
470
|
+
getPostOffice('54660');
|
|
471
|
+
// { code: "54660", office: "Lahore Gulberg Colony", town: "Lahore", district: "Lahore", province: "Punjab" }
|
|
472
|
+
|
|
473
|
+
searchPostOffices('dulmial');
|
|
474
|
+
// [{ code: "48330", office: "Dulmial", ... }]
|
|
475
|
+
```
|
|
476
|
+
|
|
477
|
+
`town` is the city the office belongs to when that is known, and otherwise the office's own name, which is usually its town or village. `district` is only given for offices in a district's headquarters town; the directory has no district column. The directory is a separate data file (about 32 kB gzipped), so it is only bundled when you call these functions.
|
|
478
|
+
|
|
479
|
+
---
|
|
480
|
+
|
|
445
481
|
## Mobile Networks
|
|
446
482
|
|
|
447
483
|
### getNetwork()
|
|
@@ -557,6 +593,43 @@ searchDistricts('karachi'); // ["Karachi Central", "Karachi East", ...]
|
|
|
557
593
|
|
|
558
594
|
---
|
|
559
595
|
|
|
596
|
+
### getDivisions() / getDivisionOfDistrict()
|
|
597
|
+
|
|
598
|
+
The 30 administrative divisions of the 2023 census (Punjab 9, Sindh 6, Khyber Pakhtunkhwa 7, Balochistan 8).
|
|
599
|
+
|
|
600
|
+
```ts
|
|
601
|
+
getDivisions('Sindh');
|
|
602
|
+
// ["Hyderabad", "Karachi", "Larkana", "Mirpur Khas", "Shaheed Benazirabad", "Sukkur"]
|
|
603
|
+
|
|
604
|
+
getDivisionOfDistrict('Attock'); // "Rawalpindi"
|
|
605
|
+
getDivisionOfDistrict('Quetta East'); // null (created after the census)
|
|
606
|
+
```
|
|
607
|
+
|
|
608
|
+
---
|
|
609
|
+
|
|
610
|
+
### getTehsils() / getTehsilDistrict()
|
|
611
|
+
|
|
612
|
+
The 591 tehsils, talukas and sub-divisions of the 2023 census.
|
|
613
|
+
|
|
614
|
+
```ts
|
|
615
|
+
getTehsils('Toba Tek Singh');
|
|
616
|
+
// ["Gojra", "Kamalia", "Pirmahal", "Toba Tek Singh"]
|
|
617
|
+
|
|
618
|
+
getTehsilDistrict('Gojra'); // "Toba Tek Singh"
|
|
619
|
+
getTehsilDistrict('Khanpur'); // null (three districts have a Khanpur)
|
|
620
|
+
getTehsilDistrict('Khanpur', 'Sindh'); // "Shikarpur"
|
|
621
|
+
```
|
|
622
|
+
|
|
623
|
+
**Census districts.** Every tehsil is recorded under the district it was in at the 2023 census, which had 136 districts. Districts created or split since then (Murree, Talagang, Quetta East and West, and others) are handled like this:
|
|
624
|
+
|
|
625
|
+
- `getTehsils('Rawalpindi')` still lists Murree, as the census did.
|
|
626
|
+
- `getTehsils('Murree')` lists only the tehsils an official source places in the new district (Kotli Sattian and Murree). Where no official list could be found, as for `Quetta East`, it is empty.
|
|
627
|
+
- `getTehsilDistrict()` and `getDivisionOfDistrict()` answer with census names: `Quetta`, not Quetta East or Quetta West.
|
|
628
|
+
|
|
629
|
+
Azad Jammu and Kashmir and Gilgit-Baltistan are not in the census tables, so they have no divisions or tehsils here. See [DATA.md](./DATA.md).
|
|
630
|
+
|
|
631
|
+
---
|
|
632
|
+
|
|
560
633
|
## Address Utilities
|
|
561
634
|
|
|
562
635
|
### parseAddress()
|
|
@@ -710,6 +783,38 @@ FBR does not publish its check-digit algorithms, so these check the format only.
|
|
|
710
783
|
|
|
711
784
|
---
|
|
712
785
|
|
|
786
|
+
## Passports & Vehicle Plates
|
|
787
|
+
|
|
788
|
+
### validatePassport()
|
|
789
|
+
|
|
790
|
+
Checks the format of a Pakistani passport number: two letters and seven digits.
|
|
791
|
+
|
|
792
|
+
```ts
|
|
793
|
+
validatePassport('AB1234567'); // true
|
|
794
|
+
validatePassport('ab 1234567'); // true
|
|
795
|
+
validatePassport('A12345678'); // false
|
|
796
|
+
```
|
|
797
|
+
|
|
798
|
+
DGIP does not publish the format, so this checks the common shape only. Other passport types may differ; see [DATA.md](./DATA.md#passport-numbers).
|
|
799
|
+
|
|
800
|
+
### parseVehiclePlate() / validateVehiclePlate()
|
|
801
|
+
|
|
802
|
+
Splits a vehicle registration number into its series letters, number and the optional year that older Punjab plates carry.
|
|
803
|
+
|
|
804
|
+
```ts
|
|
805
|
+
parseVehiclePlate('lea 1234');
|
|
806
|
+
// { series: 'LEA', number: '1234', year: null, formatted: 'LEA-1234' }
|
|
807
|
+
|
|
808
|
+
parseVehiclePlate('LEA-1234-19');
|
|
809
|
+
// { series: 'LEA', number: '1234', year: '19', formatted: 'LEA-1234' }
|
|
810
|
+
|
|
811
|
+
validateVehiclePlate('ABC-123'); // true
|
|
812
|
+
```
|
|
813
|
+
|
|
814
|
+
Each province sets its own format and several changed in 2024–2026, so this accepts the shape they share (1–4 letters, then 1–4 digits) and does not check series letters against districts. See [DATA.md](./DATA.md#vehicle-registration-plates).
|
|
815
|
+
|
|
816
|
+
---
|
|
817
|
+
|
|
713
818
|
## Raast QR Codes
|
|
714
819
|
|
|
715
820
|
### createRaastP2PQr() / createMerchantQr() / parseRaastQr()
|
|
@@ -802,7 +907,7 @@ Fixed holidays follow the year they applied in: Iqbal Day was restored in 2022 a
|
|
|
802
907
|
|
|
803
908
|
## Form Validation
|
|
804
909
|
|
|
805
|
-
Ready-made schemas for [Zod](https://zod.dev), [Valibot](https://valibot.dev)
|
|
910
|
+
Ready-made schemas for [Zod](https://zod.dev), [Valibot](https://valibot.dev), [Yup](https://github.com/jquense/yup), [Joi](https://joi.dev) and [Superstruct](https://docs.superstructjs.org), and decorators for [class-validator](https://github.com/typestack/class-validator) (and so NestJS). Install the library you use; PakDataKit does not depend on any of them.
|
|
806
911
|
|
|
807
912
|
```ts
|
|
808
913
|
import { z } from 'zod';
|
|
@@ -829,7 +934,47 @@ import { pk } from 'pakdatakit/yup';
|
|
|
829
934
|
const CheckoutForm = object({ cnic: pk.cnic().required(), phone: pk.phone() });
|
|
830
935
|
```
|
|
831
936
|
|
|
832
|
-
|
|
937
|
+
```ts
|
|
938
|
+
import Joi from 'joi';
|
|
939
|
+
import { pk } from 'pakdatakit/joi';
|
|
940
|
+
|
|
941
|
+
const CheckoutForm = Joi.object({
|
|
942
|
+
cnic: pk.cnic().required(),
|
|
943
|
+
phone: pk.phone(),
|
|
944
|
+
});
|
|
945
|
+
```
|
|
946
|
+
|
|
947
|
+
```ts
|
|
948
|
+
import { object, optional } from 'superstruct';
|
|
949
|
+
import { pk } from 'pakdatakit/superstruct';
|
|
950
|
+
|
|
951
|
+
const CheckoutForm = object({ cnic: pk.cnic(), phone: optional(pk.phone()) });
|
|
952
|
+
```
|
|
953
|
+
|
|
954
|
+
Available schemas: `pk.cnic()`, `pk.phone()`, `pk.iban()`, `pk.ntn()`, `pk.strn()`, `pk.landline()`, `pk.passport()` and `pk.vehiclePlate()`. Every factory accepts `{ message }` to replace the default error. The Yup schemas let empty values pass so `.required()` decides whether a field is mandatory.
|
|
955
|
+
|
|
956
|
+
### class-validator and NestJS
|
|
957
|
+
|
|
958
|
+
Decorators for DTOs, checked by NestJS's `ValidationPipe` like any other class-validator rule. No NestJS package is needed.
|
|
959
|
+
|
|
960
|
+
```ts
|
|
961
|
+
import { IsOptional } from 'class-validator';
|
|
962
|
+
import { IsCNIC, IsPakIBAN, IsPakPhone } from 'pakdatakit/class-validator';
|
|
963
|
+
|
|
964
|
+
export class CreateCustomerDto {
|
|
965
|
+
@IsCNIC()
|
|
966
|
+
cnic!: string;
|
|
967
|
+
|
|
968
|
+
@IsOptional()
|
|
969
|
+
@IsPakPhone({ message: 'Enter a Pakistani mobile number' })
|
|
970
|
+
phone?: string;
|
|
971
|
+
|
|
972
|
+
@IsPakIBAN()
|
|
973
|
+
iban!: string;
|
|
974
|
+
}
|
|
975
|
+
```
|
|
976
|
+
|
|
977
|
+
Decorators: `IsCNIC`, `IsPakPhone`, `IsPakIBAN` (named so it doesn't clash with class-validator's own `IsIBAN`), `IsNTN`, `IsSTRN`, `IsPakLandline`, `IsPakPassport` and `IsVehiclePlate`, also available as `pk.cnic()` and so on. They accept class-validator's options (`message`, `groups`, `each`, `always`); use `@IsOptional()` for optional fields. Values that are not strings fail.
|
|
833
978
|
|
|
834
979
|
### As-you-type helpers
|
|
835
980
|
|
package/dist/address.cjs
CHANGED
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
|
|
3
|
-
var
|
|
4
|
-
require('./chunk-
|
|
5
|
-
require('./chunk-
|
|
3
|
+
var chunkJ5ARB4TE_cjs = require('./chunk-J5ARB4TE.cjs');
|
|
4
|
+
require('./chunk-I7UUPD3G.cjs');
|
|
5
|
+
require('./chunk-OKMBYX3F.cjs');
|
|
6
6
|
require('./chunk-VPBMIYO2.cjs');
|
|
7
7
|
|
|
8
8
|
|
|
9
9
|
|
|
10
10
|
Object.defineProperty(exports, "formatAddress", {
|
|
11
11
|
enumerable: true,
|
|
12
|
-
get: function () { return
|
|
12
|
+
get: function () { return chunkJ5ARB4TE_cjs.formatAddress; }
|
|
13
13
|
});
|
|
14
14
|
Object.defineProperty(exports, "parseAddress", {
|
|
15
15
|
enumerable: true,
|
|
16
|
-
get: function () { return
|
|
16
|
+
get: function () { return chunkJ5ARB4TE_cjs.parseAddress; }
|
|
17
17
|
});
|
package/dist/address.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export { formatAddress, parseAddress } from './chunk-
|
|
2
|
-
import './chunk-
|
|
3
|
-
import './chunk-
|
|
1
|
+
export { formatAddress, parseAddress } from './chunk-TQP2T33V.js';
|
|
2
|
+
import './chunk-33QMFE2Z.js';
|
|
3
|
+
import './chunk-N4S22XX3.js';
|
|
4
4
|
import './chunk-ENQ7O7VW.js';
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
|
|
3
|
-
var
|
|
3
|
+
var chunkDHOP7LQX_cjs = require('./chunk-DHOP7LQX.cjs');
|
|
4
4
|
var chunkVPBMIYO2_cjs = require('./chunk-VPBMIYO2.cjs');
|
|
5
5
|
|
|
6
6
|
// src/internal/emv.ts
|
|
@@ -115,7 +115,7 @@ function checkLength(value, max, label) {
|
|
|
115
115
|
}
|
|
116
116
|
function normalizeIban(iban) {
|
|
117
117
|
const normalized = chunkVPBMIYO2_cjs.stripSeparators(iban).toUpperCase();
|
|
118
|
-
if (!
|
|
118
|
+
if (!chunkDHOP7LQX_cjs.validateIBAN(normalized)) {
|
|
119
119
|
throw new RangeError(`Invalid Pakistani IBAN: ${iban}`);
|
|
120
120
|
}
|
|
121
121
|
return normalized;
|
|
@@ -279,7 +279,7 @@ function parseRaastQr(payload) {
|
|
|
279
279
|
dynamic: fieldValue(fields, "01") === "12",
|
|
280
280
|
crcValid,
|
|
281
281
|
iban,
|
|
282
|
-
ibanValid: iban !== null &&
|
|
282
|
+
ibanValid: iban !== null && chunkDHOP7LQX_cjs.validateIBAN(iban),
|
|
283
283
|
amount: toAmount(fieldValue(fields, kind === "p2p" ? "05" : "54")),
|
|
284
284
|
expiresAt: parseExpiry(expiry),
|
|
285
285
|
bankName: kind === "p2p" ? fieldValue(fields, "03") : null,
|