zatca-qr 1.0.0 → 1.0.1
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/CHANGELOG.md +14 -6
- package/README.en.md +4 -2
- package/README.md +4 -2
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,16 +1,24 @@
|
|
|
1
1
|
# سجل التغييرات
|
|
2
2
|
|
|
3
|
-
## 1.0.
|
|
3
|
+
## 1.0.1: 2026-09-30
|
|
4
|
+
|
|
5
|
+
تحسين في الواجهة فقط، بلا تغيير في الكود.
|
|
6
|
+
|
|
7
|
+
- شارة إصدار npm في أعلى الواجهة.
|
|
8
|
+
- أمر التثبيت صار `npm install zatca-qr` أولاً، والمستودع بديلاً.
|
|
9
|
+
- وصف الحزمة وكلماتها المفتاحية تُبرز الفرق: توليد وقراءة وفحص، مع دعم العربية.
|
|
10
|
+
|
|
11
|
+
## 1.0.0: 2026-09-29
|
|
4
12
|
|
|
5
13
|
الإصدار الأول.
|
|
6
14
|
|
|
7
|
-
- `encodeZatcaTlv(data, { strict })
|
|
8
|
-
- `buildTlvBytes(data)
|
|
9
|
-
- `decodeZatcaTlv(base64)
|
|
15
|
+
- `encodeZatcaTlv(data, { strict })`: ترميز TLV ثم Base64، مع ترتيب العلامات تصاعدياً.
|
|
16
|
+
- `buildTlvBytes(data)`: الوصول إلى البايتات الخام للفحص والاختبار.
|
|
17
|
+
- `decodeZatcaTlv(base64)`: فك الترميز إلى حقول مقروءة، مع تنبيهات للعلامات المكرّرة
|
|
10
18
|
والناقصة والخارجة عن المواصفة، وتسامح مع Base64 الآمن للروابط.
|
|
11
|
-
- `validateZatcaInvoice(data)
|
|
19
|
+
- `validateZatcaInvoice(data)`: فحص المواصفة: الرقم الضريبي، الطابع الزمني، المبالغ،
|
|
12
20
|
حدود البايتات، واكتمال حقول مرحلة الربط.
|
|
13
|
-
- `toZatcaAmount(value)
|
|
21
|
+
- `toZatcaAmount(value)`: تنسيق المبلغ بفاصلة نقطية وبمنزلتين.
|
|
14
22
|
- دعم علامات مرحلة الربط 6 و7 و8 و9.
|
|
15
23
|
- 38 اختباراً بلا أي تبعية، منها فيكتور مرجعي بفاتورة مبسّطة.
|
|
16
24
|
- صفحة تجريبية عربية تعمل في المتصفح بلا خادم.
|
package/README.en.md
CHANGED
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
**ZATCA (Saudi FATOORA) e-invoice QR payloads — zero dependencies, no server, tested against the specification.**
|
|
4
4
|
|
|
5
|
+
[](https://www.npmjs.com/package/zatca-qr)
|
|
5
6
|
[](https://github.com/Exeerkit/zatca-qr/actions/workflows/ci.yml)
|
|
6
7
|
[](LICENSE)
|
|
7
8
|
[](https://github.com/exeerkit/zatca-qr/releases)
|
|
@@ -26,8 +27,9 @@ before you issue it.
|
|
|
26
27
|
## Install
|
|
27
28
|
|
|
28
29
|
```bash
|
|
29
|
-
npm install
|
|
30
|
-
|
|
30
|
+
npm install zatca-qr
|
|
31
|
+
# or straight from the repository
|
|
32
|
+
npm install github:exeerkit/zatca-qr
|
|
31
33
|
```
|
|
32
34
|
|
|
33
35
|
Zero dependencies. ESM only. Runs in Node 18+, browsers, Cloudflare Workers, Deno and Bun.
|
package/README.md
CHANGED
|
@@ -4,6 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
**تولّد رمز QR لفواتير زاتكا السعودية وتقرأه. بدون مكتبات خارجية وبدون خادم.**
|
|
6
6
|
|
|
7
|
+
[](https://www.npmjs.com/package/zatca-qr)
|
|
7
8
|
[](https://github.com/Exeerkit/zatca-qr/actions/workflows/ci.yml)
|
|
8
9
|
|
|
9
10
|
[](LICENSE)
|
|
@@ -32,8 +33,9 @@
|
|
|
32
33
|
## التثبيت
|
|
33
34
|
|
|
34
35
|
```bash
|
|
35
|
-
npm install
|
|
36
|
-
|
|
36
|
+
npm install zatca-qr
|
|
37
|
+
# أو مباشرة من المستودع
|
|
38
|
+
npm install github:exeerkit/zatca-qr
|
|
37
39
|
```
|
|
38
40
|
|
|
39
41
|
بدون أي مكتبة خارجية. تعمل في Node 18 وأحدث، وفي المتصفح، وفي Cloudflare Workers وDeno وBun.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "zatca-qr",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1",
|
|
4
4
|
"description": "ZATCA (Saudi FATOORA) e-invoice QR: encode, decode and validate in TLV + Base64. Byte-accurate Arabic text, zero dependencies. مولّد وقارئ رمز فاتورة زاتكا.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./src/index.js",
|