saudi-utils 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Saudi Utils contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,220 @@
+# Saudi Utils
+
+`saudi-utils` is a small, strict TypeScript library for offline validation and explicit
+normalization of common Saudi identity, banking, business, telecom, and National Address data.
+It provides deterministic errors, evidence-labelled rules, and no runtime dependencies.
+
+> [!IMPORTANT]
+> A successful result proves only the documented offline structure and, where stated, checksum.
+> It does **not** prove issuance, ownership, existence, activity, registration, account status,
+> address existence, phone reachability, or any current authoritative status.
+
+## Installation
+
+```bash
+npm install saudi-utils
+```
+
+## Quick start
+
+`saudi-utils` is ESM-only, supports Node.js 22 and newer, and includes TypeScript declarations.
+There is no default export.
+
+```ts
+import { formatIban, getSaudiIdType, normalizeIban, validateSaudiIban } from "saudi-utils";
+
+getSaudiIdType("1000000008"); // "national-id" (synthetic checksum-valid example)
+
+const iban = normalizeIban("sa03 8000 0000 6080 1016 7519");
+// "SA0380000000608010167519"
+
+validateSaudiIban(iban);
+// { valid: true, value: "SA0380000000608010167519" }
+
+formatIban(iban);
+// "SA03 8000 0000 6080 1016 7519"
+```
+
+The package exposes one side-effect-free ESM root. Pure named exports and
+`"sideEffects": false` support tree shaking. Runtime code uses standard JavaScript and has zero
+runtime dependencies.
+
+## Validation and normalization
+
+Validators are deliberately strict. They accept `unknown`, but only primitive strings can be
+valid identifiers. They do not trim, coerce, remove punctuation, change case, or translate
+Unicode numerals. Canonical numeric values use ASCII digits and preserve leading zeroes.
+
+Explicit normalizers accept only their documented variants:
+
+- `normalizeIban` removes ASCII spaces, uppercases ASCII letters, then validates the result.
+- `normalizePhoneNumber` accepts specific unseparated Saudi national and country-code forms.
+- `normalizeShortAddress` uppercases ASCII letters and removes at most one permitted ASCII space.
+
+All return `null` for unsupported or invalid input and are idempotent after success.
+`formatIban` is only a formatter: it accepts a valid, canonical Saudi IBAN and returns `null` for
+lowercase, spaced, invalid, or non-Saudi input. Call `normalizeIban` first when normalization is
+required.
+
+Detailed validators return the shared result:
+
+```ts
+type ValidationResult =
+  { valid: true; value: string } | { valid: false; code: ValidationErrorCode };
+```
+
+Errors use deterministic precedence:
+
+1. `REQUIRED`
+2. `INVALID_TYPE`
+3. `INVALID_LENGTH`
+4. `INVALID_FORMAT`
+5. `INVALID_PREFIX`
+6. `INVALID_CHECKSUM`
+
+`undefined`, `null`, and `""` are required failures. Whitespace is not silently treated as empty.
+Boolean `is*` helpers are thin wrappers around their detailed validators.
+
+## API reference
+
+Every public value is a named root export. See
+[the detailed API reference](https://github.com/alialaraby/saudi-utils/blob/main/docs/api.md) for
+exact signatures, accepted representations, normalization rules, and return behavior.
+
+| Domain           | Public exports                                                                                                                                                                                                                     |
+| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Identity         | `isNationalId`, `validateNationalId`, `isIqama`, `validateIqama`, `isSaudiId`, `validateSaudiId`, `getSaudiIdType`, `isBorderId`, `validateBorderId`                                                                               |
+| Banking          | `isSaudiIban`, `validateSaudiIban`, `normalizeIban`, `formatIban`                                                                                                                                                                  |
+| Business and tax | `isVatNumber`, `validateVatNumber`, `isTin`, `validateTin`, `isUnifiedNationalNumber`, `validateUnifiedNationalNumber`, `isCommercialRegistration`, `validateCommercialRegistration`                                               |
+| Telecom          | `isMobileNumber`, `validateMobileNumber`, `isLandlineNumber`, `validateLandlineNumber`, `isTollFreeNumber`, `validateTollFreeNumber`, `normalizePhoneNumber`                                                                       |
+| National Address | `isPostalCode`, `validatePostalCode`, `isBuildingNumber`, `validateBuildingNumber`, `isAdditionalNumber`, `validateAdditionalNumber`, `isShortAddress`, `validateShortAddress`, `normalizeShortAddress`, `validateNationalAddress` |
+| Types            | `ValidationErrorCode`, `ValidationResult`, `ValidationEvidence`, `NormalizedSaudiPhone`, `NationalAddress`, `NationalAddressValidationResult`                                                                                      |
+
+### Canonical representations
+
+| Value                          | Accepted canonical representation                                                        | Checksum                    |
+| ------------------------------ | ---------------------------------------------------------------------------------------- | --------------------------- |
+| National ID                    | 10 ASCII digits beginning with `1`                                                       | Alternating-double checksum |
+| Iqama                          | 10 ASCII digits beginning with `2`                                                       | Alternating-double checksum |
+| Border ID                      | 10 ASCII digits beginning with `3` or `4`                                                | None                        |
+| Saudi IBAN                     | 24 uppercase ASCII alphanumeric characters beginning with `SA`; positions 3–6 are digits | ISO 13616 MOD-97-10         |
+| VAT Registration Number        | 15 ASCII digits beginning and ending with `3`                                            | None                        |
+| TIN                            | 10 ASCII digits                                                                          | None                        |
+| Unified National Number        | 10 ASCII digits beginning with `7`                                                       | None                        |
+| Legacy Commercial Registration | 10 ASCII digits                                                                          | None                        |
+| Mobile                         | `05XXXXXXXX` or `+9665XXXXXXXX`                                                          | None                        |
+| Landline                       | National or `+966` form using `011`, `012`, `013`, `014`, `016`, or `017`                | None                        |
+| Toll-free                      | National `800XXXXXXX` only                                                               | None                        |
+| Postal code                    | 5 ASCII digits                                                                           | None                        |
+| Building/additional number     | 4 ASCII digits                                                                           | None                        |
+| Short Address                  | 4 uppercase ASCII letters followed by 4 ASCII digits                                     | None                        |
+
+### Evidence levels and important limitations
+
+Rules are classified as `official-checksum`, `official-structural`,
+`official-structural-community-checksum`, or `best-known-structural`. The complete source and
+limitation register is in the
+[validation evidence document](https://github.com/alialaraby/saudi-utils/blob/main/docs/evidence.md).
+
+- **Border ID is provisional:** only the best-known 10-digit structure and `3`/`4` prefixes are
+  checked. No checksum or complete public normative schema is claimed.
+- **TIN is structural only:** any 10 ASCII digits pass. No checksum or richer authoritative offline
+  grammar is claimed.
+- **Commercial Registration means the legacy structural format:** the API checks only a 10-digit
+  legacy representation. It is not current registry verification and is not an alias for the
+  Unified National Number.
+- Phone prefixes describe numbering structure, not the subscriber's current carrier. Number
+  portability makes current-carrier inference invalid.
+
+## Examples
+
+The values labelled synthetic below demonstrate offline rules only; they are not presented as
+issued identifiers. The repository's
+[typechecked quick-start fixture](https://github.com/alialaraby/saudi-utils/blob/main/examples/quick-start.ts)
+also executes its expected results.
+
+### Identity
+
+```ts
+import { getSaudiIdType, validateBorderId, validateNationalId } from "saudi-utils";
+
+validateNationalId("1000000008"); // { valid: true, value: "1000000008" } (synthetic)
+getSaudiIdType("1000000008"); // "national-id"
+validateBorderId("3000000000"); // structural success only (synthetic)
+```
+
+### IBAN
+
+```ts
+import { formatIban, normalizeIban } from "saudi-utils";
+
+const iban = normalizeIban("sa03 8000 0000 6080 1016 7519");
+formatIban(iban); // "SA03 8000 0000 6080 1016 7519"
+formatIban("sa03 8000 0000 6080 1016 7519"); // null: formatting does not normalize
+```
+
+### Business and tax
+
+```ts
+import { validateTin, validateUnifiedNationalNumber, validateVatNumber } from "saudi-utils";
+
+validateVatNumber("300000000000003").valid; // true: structural result
+validateTin("0123456789").valid; // true: best-known structural result
+validateUnifiedNationalNumber("7123456789").valid; // true: structural result
+```
+
+### Telecom
+
+```ts
+import { normalizePhoneNumber, validateMobileNumber } from "saudi-utils";
+
+validateMobileNumber("0501234567").valid; // true: no reachability or carrier claim
+normalizePhoneNumber("0501234567");
+// { kind: "mobile", value: "+966501234567" }
+```
+
+### National Address
+
+```ts
+import { normalizeShortAddress, validateNationalAddress } from "saudi-utils";
+
+normalizeShortAddress("abcd 0123"); // "ABCD0123"
+
+validateNationalAddress({
+  buildingNumber: "0123",
+  street: "King Fahd Road",
+  district: "Al Olaya",
+  city: "Riyadh",
+  postalCode: "01234",
+  additionalNumber: "0000",
+  applicationField: "ignored",
+});
+// Success returns a fresh object containing only the six required fields.
+```
+
+`validateNationalAddress` requires those six own data properties, ignores extra properties, does
+not invoke accessors, and returns a fresh object containing only required fields. Its specialized
+`NationalAddressValidationResult` returns a `NationalAddress` object on success. Text fields must
+be non-empty primitive strings but are not trimmed or linguistically restricted; cross-field and
+address-existence checks are outside the contract.
+
+## Development
+
+```bash
+npm ci
+npm run docs:check
+npm run check
+```
+
+Available focused commands are `npm test`, `npm run test:coverage`, `npm run typecheck`,
+`npm run lint`, `npm run format:check`, and `npm run build`. Node.js 22 or newer is required.
+
+## Project policies
+
+- [Validation evidence](https://github.com/alialaraby/saudi-utils/blob/main/docs/evidence.md)
+- [API reference](https://github.com/alialaraby/saudi-utils/blob/main/docs/api.md)
+- [Contributing](https://github.com/alialaraby/saudi-utils/blob/main/CONTRIBUTING.md)
+- [Security policy](https://github.com/alialaraby/saudi-utils/blob/main/SECURITY.md)
+- [Changelog](https://github.com/alialaraby/saudi-utils/blob/main/CHANGELOG.md)
+- [Release process](https://github.com/alialaraby/saudi-utils/blob/main/docs/releasing.md)
+- [MIT License](https://github.com/alialaraby/saudi-utils/blob/main/LICENSE)

package/dist/address.d.ts

@@ -0,0 +1,12 @@
+import type { NationalAddressValidationResult, ValidationResult } from "./types.js";
+export declare function validatePostalCode(value: unknown): ValidationResult;
+export declare function isPostalCode(value: unknown): value is string;
+export declare function validateBuildingNumber(value: unknown): ValidationResult;
+export declare function isBuildingNumber(value: unknown): value is string;
+export declare function validateAdditionalNumber(value: unknown): ValidationResult;
+export declare function isAdditionalNumber(value: unknown): value is string;
+export declare function validateShortAddress(value: unknown): ValidationResult;
+export declare function isShortAddress(value: unknown): value is string;
+export declare function normalizeShortAddress(value: unknown): string | null;
+export declare function validateNationalAddress(value: unknown): NationalAddressValidationResult;
+//# sourceMappingURL=address.d.ts.map

package/dist/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,+BAA+B,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA6BpF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAEnE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE5D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAEvE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAEzE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAElE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAgBrE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE9D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAUnE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,+BAA+B,CA8DvF"}

package/dist/address.js

@@ -0,0 +1,118 @@
+import { isAsciiDigits } from "./internal/ascii.js";
+import { checkStringInput } from "./internal/input.js";
+const ADDRESS_FIELDS = [
+    "buildingNumber",
+    "street",
+    "district",
+    "city",
+    "postalCode",
+    "additionalNumber",
+];
+function validateFixedLengthDigits(value, length) {
+    const input = checkStringInput(value);
+    if (!input.valid) {
+        return input;
+    }
+    if (input.value.length !== length) {
+        return { valid: false, code: "INVALID_LENGTH" };
+    }
+    if (!isAsciiDigits(input.value)) {
+        return { valid: false, code: "INVALID_FORMAT" };
+    }
+    return { valid: true, value: input.value };
+}
+export function validatePostalCode(value) {
+    return validateFixedLengthDigits(value, 5);
+}
+export function isPostalCode(value) {
+    return validatePostalCode(value).valid;
+}
+export function validateBuildingNumber(value) {
+    return validateFixedLengthDigits(value, 4);
+}
+export function isBuildingNumber(value) {
+    return validateBuildingNumber(value).valid;
+}
+export function validateAdditionalNumber(value) {
+    return validateFixedLengthDigits(value, 4);
+}
+export function isAdditionalNumber(value) {
+    return validateAdditionalNumber(value).valid;
+}
+export function validateShortAddress(value) {
+    const input = checkStringInput(value);
+    if (!input.valid) {
+        return input;
+    }
+    if (input.value.length !== 8) {
+        return { valid: false, code: "INVALID_LENGTH" };
+    }
+    if (!/^[A-Z]{4}[0-9]{4}$/.test(input.value)) {
+        return { valid: false, code: "INVALID_FORMAT" };
+    }
+    return { valid: true, value: input.value };
+}
+export function isShortAddress(value) {
+    return validateShortAddress(value).valid;
+}
+export function normalizeShortAddress(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    if (!/^[A-Za-z]{4} ?[0-9]{4}$/.test(value)) {
+        return null;
+    }
+    return `${value.slice(0, 4).toUpperCase()}${value.slice(-4)}`;
+}
+export function validateNationalAddress(value) {
+    if (value === undefined || value === null || value === "") {
+        return { valid: false, code: "REQUIRED" };
+    }
+    if (typeof value !== "object" || Array.isArray(value)) {
+        return { valid: false, code: "INVALID_TYPE" };
+    }
+    const fields = {};
+    for (const field of ADDRESS_FIELDS) {
+        const descriptor = Object.getOwnPropertyDescriptor(value, field);
+        if (descriptor === undefined || !("value" in descriptor) || descriptor.value === "") {
+            return { valid: false, code: "REQUIRED" };
+        }
+        fields[field] = descriptor.value;
+    }
+    const buildingNumber = fields.buildingNumber;
+    const street = fields.street;
+    const district = fields.district;
+    const city = fields.city;
+    const postalCode = fields.postalCode;
+    const additionalNumber = fields.additionalNumber;
+    if (typeof buildingNumber !== "string" ||
+        typeof street !== "string" ||
+        typeof district !== "string" ||
+        typeof city !== "string" ||
+        typeof postalCode !== "string" ||
+        typeof additionalNumber !== "string") {
+        return { valid: false, code: "INVALID_TYPE" };
+    }
+    const componentResults = [
+        validateBuildingNumber(buildingNumber),
+        validatePostalCode(postalCode),
+        validateAdditionalNumber(additionalNumber),
+    ];
+    for (const result of componentResults) {
+        if (!result.valid) {
+            return result;
+        }
+    }
+    return {
+        valid: true,
+        value: {
+            buildingNumber,
+            street,
+            district,
+            city,
+            postalCode,
+            additionalNumber,
+        },
+    };
+}
+//# sourceMappingURL=address.js.map

package/dist/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":"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"}

package/dist/banking.d.ts

@@ -0,0 +1,6 @@
+import type { ValidationResult } from "./types.js";
+export declare function validateSaudiIban(value: unknown): ValidationResult;
+export declare function isSaudiIban(value: unknown): value is string;
+export declare function normalizeIban(value: unknown): string | null;
+export declare function formatIban(value: unknown): string | null;
+//# sourceMappingURL=banking.d.ts.map

package/dist/banking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banking.d.ts","sourceRoot":"","sources":["../src/banking.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAgBnD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CA4BlE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE3D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAwB3D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAMxD"}

package/dist/banking.js

@@ -0,0 +1,66 @@
+import { isAsciiDigits, isUppercaseAsciiAlphanumeric } from "./internal/ascii.js";
+import { checkStringInput } from "./internal/input.js";
+import { mod97 } from "./internal/mod97.js";
+const UPPERCASE_ASCII_LETTERS = /^[A-Z]{2}$/;
+function hasValidIbanChecksum(value) {
+    const rearranged = `${value.slice(4)}${value.slice(0, 4)}`;
+    let expanded = "";
+    for (const character of rearranged) {
+        const code = character.charCodeAt(0);
+        expanded += code >= 65 && code <= 90 ? String(code - 55) : character;
+    }
+    return mod97(expanded) === 1;
+}
+export function validateSaudiIban(value) {
+    const input = checkStringInput(value);
+    if (!input.valid) {
+        return input;
+    }
+    if (input.value.length !== 24) {
+        return { valid: false, code: "INVALID_LENGTH" };
+    }
+    if (!isUppercaseAsciiAlphanumeric(input.value) ||
+        !UPPERCASE_ASCII_LETTERS.test(input.value.slice(0, 2)) ||
+        !isAsciiDigits(input.value.slice(2, 6))) {
+        return { valid: false, code: "INVALID_FORMAT" };
+    }
+    if (!input.value.startsWith("SA")) {
+        return { valid: false, code: "INVALID_PREFIX" };
+    }
+    if (!hasValidIbanChecksum(input.value)) {
+        return { valid: false, code: "INVALID_CHECKSUM" };
+    }
+    return { valid: true, value: input.value };
+}
+export function isSaudiIban(value) {
+    return validateSaudiIban(value).valid;
+}
+export function normalizeIban(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    let normalized = "";
+    for (const character of value) {
+        if (character === " ") {
+            continue;
+        }
+        const code = character.charCodeAt(0);
+        if (code >= 97 && code <= 122) {
+            normalized += String.fromCharCode(code - 32);
+        }
+        else if ((code >= 65 && code <= 90) || (code >= 48 && code <= 57)) {
+            normalized += character;
+        }
+        else {
+            return null;
+        }
+    }
+    return isSaudiIban(normalized) ? normalized : null;
+}
+export function formatIban(value) {
+    if (!isSaudiIban(value)) {
+        return null;
+    }
+    return `${value.slice(0, 4)} ${value.slice(4, 8)} ${value.slice(8, 12)} ${value.slice(12, 16)} ${value.slice(16, 20)} ${value.slice(20, 24)}`;
+}
+//# sourceMappingURL=banking.js.map

package/dist/banking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banking.js","sourceRoot":"","sources":["../src/banking.ts"],"names":[],"mappings":"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"}

package/dist/business.d.ts

@@ -0,0 +1,10 @@
+import type { ValidationResult } from "./types.js";
+export declare function validateVatNumber(value: unknown): ValidationResult;
+export declare function isVatNumber(value: unknown): value is string;
+export declare function validateTin(value: unknown): ValidationResult;
+export declare function isTin(value: unknown): value is string;
+export declare function validateUnifiedNationalNumber(value: unknown): ValidationResult;
+export declare function isUnifiedNationalNumber(value: unknown): value is string;
+export declare function validateCommercialRegistration(value: unknown): ValidationResult;
+export declare function isCommercialRegistration(value: unknown): value is string;
+//# sourceMappingURL=business.d.ts.map

package/dist/business.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"business.d.ts","sourceRoot":"","sources":["../src/business.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAoBlE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE3D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAgB5D;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAErD;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAoB9E;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEvE;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAgB/E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExE"}

package/dist/business.js

@@ -0,0 +1,73 @@
+import { isAsciiDigits } from "./internal/ascii.js";
+import { checkStringInput } from "./internal/input.js";
+export function validateVatNumber(value) {
+    const input = checkStringInput(value);
+    if (!input.valid) {
+        return input;
+    }
+    if (input.value.length !== 15) {
+        return { valid: false, code: "INVALID_LENGTH" };
+    }
+    if (!isAsciiDigits(input.value)) {
+        return { valid: false, code: "INVALID_FORMAT" };
+    }
+    if (!input.value.startsWith("3") || !input.value.endsWith("3")) {
+        return { valid: false, code: "INVALID_PREFIX" };
+    }
+    return { valid: true, value: input.value };
+}
+export function isVatNumber(value) {
+    return validateVatNumber(value).valid;
+}
+export function validateTin(value) {
+    const input = checkStringInput(value);
+    if (!input.valid) {
+        return input;
+    }
+    if (input.value.length !== 10) {
+        return { valid: false, code: "INVALID_LENGTH" };
+    }
+    if (!isAsciiDigits(input.value)) {
+        return { valid: false, code: "INVALID_FORMAT" };
+    }
+    return { valid: true, value: input.value };
+}
+export function isTin(value) {
+    return validateTin(value).valid;
+}
+export function validateUnifiedNationalNumber(value) {
+    const input = checkStringInput(value);
+    if (!input.valid) {
+        return input;
+    }
+    if (input.value.length !== 10) {
+        return { valid: false, code: "INVALID_LENGTH" };
+    }
+    if (!isAsciiDigits(input.value)) {
+        return { valid: false, code: "INVALID_FORMAT" };
+    }
+    if (!input.value.startsWith("7")) {
+        return { valid: false, code: "INVALID_PREFIX" };
+    }
+    return { valid: true, value: input.value };
+}
+export function isUnifiedNationalNumber(value) {
+    return validateUnifiedNationalNumber(value).valid;
+}
+export function validateCommercialRegistration(value) {
+    const input = checkStringInput(value);
+    if (!input.valid) {
+        return input;
+    }
+    if (input.value.length !== 10) {
+        return { valid: false, code: "INVALID_LENGTH" };
+    }
+    if (!isAsciiDigits(input.value)) {
+        return { valid: false, code: "INVALID_FORMAT" };
+    }
+    return { valid: true, value: input.value };
+}
+export function isCommercialRegistration(value) {
+    return validateCommercialRegistration(value).valid;
+}
+//# sourceMappingURL=business.js.map

package/dist/business.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"business.js","sourceRoot":"","sources":["../src/business.ts"],"names":[],"mappings":"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"}

package/dist/identity.d.ts

@@ -0,0 +1,11 @@
+import type { ValidationResult } from "./types.js";
+export declare function validateNationalId(value: unknown): ValidationResult;
+export declare function isNationalId(value: unknown): boolean;
+export declare function validateIqama(value: unknown): ValidationResult;
+export declare function isIqama(value: unknown): boolean;
+export declare function validateSaudiId(value: unknown): ValidationResult;
+export declare function isSaudiId(value: unknown): boolean;
+export declare function getSaudiIdType(value: unknown): "national-id" | "iqama" | null;
+export declare function validateBorderId(value: unknown): ValidationResult;
+export declare function isBorderId(value: unknown): boolean;
+//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAwBnE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEpD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAwB9D;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE/C;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAQhE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEjD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,OAAO,GAAG,IAAI,CAQ7E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAoBjE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAElD"}

package/dist/identity.js

@@ -0,0 +1,84 @@
+import { isAsciiDigits } from "./internal/ascii.js";
+import { hasValidSaudiIdentityChecksum } from "./internal/identity-checksum.js";
+import { checkStringInput } from "./internal/input.js";
+export function validateNationalId(value) {
+    const input = checkStringInput(value);
+    if (!input.valid) {
+        return input;
+    }
+    if (input.value.length !== 10) {
+        return { valid: false, code: "INVALID_LENGTH" };
+    }
+    if (!isAsciiDigits(input.value)) {
+        return { valid: false, code: "INVALID_FORMAT" };
+    }
+    if (!input.value.startsWith("1")) {
+        return { valid: false, code: "INVALID_PREFIX" };
+    }
+    if (!hasValidSaudiIdentityChecksum(input.value)) {
+        return { valid: false, code: "INVALID_CHECKSUM" };
+    }
+    return { valid: true, value: input.value };
+}
+export function isNationalId(value) {
+    return validateNationalId(value).valid;
+}
+export function validateIqama(value) {
+    const input = checkStringInput(value);
+    if (!input.valid) {
+        return input;
+    }
+    if (input.value.length !== 10) {
+        return { valid: false, code: "INVALID_LENGTH" };
+    }
+    if (!isAsciiDigits(input.value)) {
+        return { valid: false, code: "INVALID_FORMAT" };
+    }
+    if (!input.value.startsWith("2")) {
+        return { valid: false, code: "INVALID_PREFIX" };
+    }
+    if (!hasValidSaudiIdentityChecksum(input.value)) {
+        return { valid: false, code: "INVALID_CHECKSUM" };
+    }
+    return { valid: true, value: input.value };
+}
+export function isIqama(value) {
+    return validateIqama(value).valid;
+}
+export function validateSaudiId(value) {
+    const nationalId = validateNationalId(value);
+    if (nationalId.valid || nationalId.code !== "INVALID_PREFIX") {
+        return nationalId;
+    }
+    return validateIqama(value);
+}
+export function isSaudiId(value) {
+    return validateSaudiId(value).valid;
+}
+export function getSaudiIdType(value) {
+    const result = validateSaudiId(value);
+    if (!result.valid) {
+        return null;
+    }
+    return result.value.startsWith("1") ? "national-id" : "iqama";
+}
+export function validateBorderId(value) {
+    const input = checkStringInput(value);
+    if (!input.valid) {
+        return input;
+    }
+    if (input.value.length !== 10) {
+        return { valid: false, code: "INVALID_LENGTH" };
+    }
+    if (!isAsciiDigits(input.value)) {
+        return { valid: false, code: "INVALID_FORMAT" };
+    }
+    if (!input.value.startsWith("3") && !input.value.startsWith("4")) {
+        return { valid: false, code: "INVALID_PREFIX" };
+    }
+    return { valid: true, value: input.value };
+}
+export function isBorderId(value) {
+    return validateBorderId(value).valid;
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { formatIban, isSaudiIban, normalizeIban, validateSaudiIban } from "./banking.js";
+export { isAdditionalNumber, isBuildingNumber, isPostalCode, isShortAddress, normalizeShortAddress, validateAdditionalNumber, validateBuildingNumber, validateNationalAddress, validatePostalCode, validateShortAddress, } from "./address.js";
+export { isCommercialRegistration, isTin, isUnifiedNationalNumber, isVatNumber, validateCommercialRegistration, validateTin, validateUnifiedNationalNumber, validateVatNumber, } from "./business.js";
+export { getSaudiIdType, isBorderId, isIqama, isNationalId, isSaudiId, validateBorderId, validateIqama, validateNationalId, validateSaudiId, } from "./identity.js";
+export { isLandlineNumber, isMobileNumber, isTollFreeNumber, normalizePhoneNumber, validateLandlineNumber, validateMobileNumber, validateTollFreeNumber, } from "./telecom.js";
+export type { NationalAddress, NationalAddressValidationResult, NormalizedSaudiPhone, ValidationErrorCode, ValidationEvidence, ValidationResult, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEzF,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,wBAAwB,EACxB,KAAK,EACL,uBAAuB,EACvB,WAAW,EACX,8BAA8B,EAC9B,WAAW,EACX,6BAA6B,EAC7B,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,cAAc,EACd,UAAU,EACV,OAAO,EACP,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,eAAe,EACf,+BAA+B,EAC/B,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { formatIban, isSaudiIban, normalizeIban, validateSaudiIban } from "./banking.js";
+export { isAdditionalNumber, isBuildingNumber, isPostalCode, isShortAddress, normalizeShortAddress, validateAdditionalNumber, validateBuildingNumber, validateNationalAddress, validatePostalCode, validateShortAddress, } from "./address.js";
+export { isCommercialRegistration, isTin, isUnifiedNationalNumber, isVatNumber, validateCommercialRegistration, validateTin, validateUnifiedNationalNumber, validateVatNumber, } from "./business.js";
+export { getSaudiIdType, isBorderId, isIqama, isNationalId, isSaudiId, validateBorderId, validateIqama, validateNationalId, validateSaudiId, } from "./identity.js";
+export { isLandlineNumber, isMobileNumber, isTollFreeNumber, normalizePhoneNumber, validateLandlineNumber, validateMobileNumber, validateTollFreeNumber, } from "./telecom.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEzF,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,wBAAwB,EACxB,KAAK,EACL,uBAAuB,EACvB,WAAW,EACX,8BAA8B,EAC9B,WAAW,EACX,6BAA6B,EAC7B,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,cAAc,EACd,UAAU,EACV,OAAO,EACP,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,cAAc,CAAC"}

package/dist/internal/ascii.d.ts

@@ -0,0 +1,3 @@
+export declare function isAsciiDigits(value: string): boolean;
+export declare function isUppercaseAsciiAlphanumeric(value: string): boolean;
+//# sourceMappingURL=ascii.d.ts.map

package/dist/internal/ascii.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ascii.d.ts","sourceRoot":"","sources":["../../src/internal/ascii.ts"],"names":[],"mappings":"AAGA,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnE"}

package/dist/internal/ascii.js

@@ -0,0 +1,9 @@
+const ASCII_DIGITS = /^[0-9]+$/;
+const UPPERCASE_ASCII_ALPHANUMERIC = /^[A-Z0-9]+$/;
+export function isAsciiDigits(value) {
+    return ASCII_DIGITS.test(value);
+}
+export function isUppercaseAsciiAlphanumeric(value) {
+    return UPPERCASE_ASCII_ALPHANUMERIC.test(value);
+}
+//# sourceMappingURL=ascii.js.map

package/dist/internal/ascii.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ascii.js","sourceRoot":"","sources":["../../src/internal/ascii.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,UAAU,CAAC;AAChC,MAAM,4BAA4B,GAAG,aAAa,CAAC;AAEnD,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,KAAa;IACxD,OAAO,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC"}

package/dist/internal/identity-checksum.d.ts

@@ -0,0 +1,3 @@
+/** Precondition: value is an already structurally validated 10-digit ASCII string. */
+export declare function hasValidSaudiIdentityChecksum(value: string): boolean;
+//# sourceMappingURL=identity-checksum.d.ts.map

package/dist/internal/identity-checksum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-checksum.d.ts","sourceRoot":"","sources":["../../src/internal/identity-checksum.ts"],"names":[],"mappings":"AAEA,sFAAsF;AACtF,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAmBpE"}

package/dist/internal/identity-checksum.js

@@ -0,0 +1,20 @@
+import { isAsciiDigits } from "./ascii.js";
+/** Precondition: value is an already structurally validated 10-digit ASCII string. */
+export function hasValidSaudiIdentityChecksum(value) {
+    if (typeof value !== "string" || value.length !== 10 || !isAsciiDigits(value)) {
+        throw new TypeError("Saudi identity checksum requires exactly 10 ASCII digits");
+    }
+    let total = 0;
+    for (let index = 0; index < value.length; index += 1) {
+        const digit = value.charCodeAt(index) - 48;
+        if (index % 2 === 0) {
+            const doubled = digit * 2;
+            total += doubled > 9 ? doubled - 9 : doubled;
+        }
+        else {
+            total += digit;
+        }
+    }
+    return total % 10 === 0;
+}
+//# sourceMappingURL=identity-checksum.js.map

package/dist/internal/identity-checksum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-checksum.js","sourceRoot":"","sources":["../../src/internal/identity-checksum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,sFAAsF;AACtF,MAAM,UAAU,6BAA6B,CAAC,KAAa;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9E,MAAM,IAAI,SAAS,CAAC,0DAA0D,CAAC,CAAC;IAClF,CAAC;IAED,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAE3C,IAAI,KAAK,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC;YAC1B,KAAK,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,KAAK,IAAI,KAAK,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,GAAG,EAAE,KAAK,CAAC,CAAC;AAC1B,CAAC"}

package/dist/internal/input.d.ts

@@ -0,0 +1,10 @@
+type InitialInputResult = {
+    valid: true;
+    value: string;
+} | {
+    valid: false;
+    code: "REQUIRED" | "INVALID_TYPE";
+};
+export declare function checkStringInput(input: unknown): InitialInputResult;
+export {};
+//# sourceMappingURL=input.d.ts.map

package/dist/internal/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/internal/input.ts"],"names":[],"mappings":"AAAA,KAAK,kBAAkB,GACnB;IACE,KAAK,EAAE,IAAI,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,cAAc,CAAC;CACnC,CAAC;AAEN,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAUnE"}

package/dist/internal/input.js

@@ -0,0 +1,10 @@
+export function checkStringInput(input) {
+    if (input === undefined || input === null || input === "") {
+        return { valid: false, code: "REQUIRED" };
+    }
+    if (typeof input !== "string") {
+        return { valid: false, code: "INVALID_TYPE" };
+    }
+    return { valid: true, value: input };
+}
+//# sourceMappingURL=input.js.map

package/dist/internal/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../src/internal/input.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QAC1D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC5C,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;IAChD,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACvC,CAAC"}

package/dist/internal/mod97.d.ts

@@ -0,0 +1,3 @@
+/** Precondition: value is a non-empty string containing only ASCII digits. */
+export declare function mod97(value: string): number;
+//# sourceMappingURL=mod97.d.ts.map

package/dist/internal/mod97.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod97.d.ts","sourceRoot":"","sources":["../../src/internal/mod97.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAa3C"}

package/dist/internal/mod97.js

@@ -0,0 +1,14 @@
+import { isAsciiDigits } from "./ascii.js";
+/** Precondition: value is a non-empty string containing only ASCII digits. */
+export function mod97(value) {
+    if (typeof value !== "string" || !isAsciiDigits(value)) {
+        throw new TypeError("mod97 requires a non-empty ASCII numeric string");
+    }
+    let remainder = 0;
+    for (let index = 0; index < value.length; index += 1) {
+        const digit = value.charCodeAt(index) - 48;
+        remainder = (remainder * 10 + digit) % 97;
+    }
+    return remainder;
+}
+//# sourceMappingURL=mod97.js.map

package/dist/internal/mod97.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod97.js","sourceRoot":"","sources":["../../src/internal/mod97.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,8EAA8E;AAC9E,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,SAAS,CAAC,iDAAiD,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC3C,SAAS,GAAG,CAAC,SAAS,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;IAC5C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/telecom.d.ts

@@ -0,0 +1,9 @@
+import type { NormalizedSaudiPhone, ValidationResult } from "./types.js";
+export declare function validateMobileNumber(value: unknown): ValidationResult;
+export declare function isMobileNumber(value: unknown): value is string;
+export declare function validateLandlineNumber(value: unknown): ValidationResult;
+export declare function isLandlineNumber(value: unknown): value is string;
+export declare function validateTollFreeNumber(value: unknown): ValidationResult;
+export declare function isTollFreeNumber(value: unknown): value is string;
+export declare function normalizePhoneNumber(value: unknown): NormalizedSaudiPhone | null;
+//# sourceMappingURL=telecom.d.ts.map

package/dist/telecom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telecom.d.ts","sourceRoot":"","sources":["../src/telecom.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAiBzE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAuBrE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE9D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAuBvE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAoBvE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI,CAgChF"}

package/dist/telecom.js

@@ -0,0 +1,104 @@
+import { isAsciiDigits } from "./internal/ascii.js";
+import { checkStringInput } from "./internal/input.js";
+const NATIONAL_PHONE_LENGTH = 10;
+const E164_PHONE_LENGTH = 13;
+function validateNationalOrE164Format(value) {
+    if (value.length === NATIONAL_PHONE_LENGTH) {
+        return isAsciiDigits(value);
+    }
+    return value.startsWith("+") && isAsciiDigits(value.slice(1));
+}
+function hasE164SaudiPrefix(value) {
+    return value.startsWith("+966");
+}
+export function validateMobileNumber(value) {
+    const input = checkStringInput(value);
+    if (!input.valid) {
+        return input;
+    }
+    if (input.value.length !== NATIONAL_PHONE_LENGTH && input.value.length !== E164_PHONE_LENGTH) {
+        return { valid: false, code: "INVALID_LENGTH" };
+    }
+    if (!validateNationalOrE164Format(input.value)) {
+        return { valid: false, code: "INVALID_FORMAT" };
+    }
+    if ((input.value.length === NATIONAL_PHONE_LENGTH && !input.value.startsWith("05")) ||
+        (input.value.length === E164_PHONE_LENGTH && !input.value.startsWith("+9665"))) {
+        return { valid: false, code: "INVALID_PREFIX" };
+    }
+    return { valid: true, value: input.value };
+}
+export function isMobileNumber(value) {
+    return validateMobileNumber(value).valid;
+}
+export function validateLandlineNumber(value) {
+    const input = checkStringInput(value);
+    if (!input.valid) {
+        return input;
+    }
+    if (input.value.length !== NATIONAL_PHONE_LENGTH && input.value.length !== E164_PHONE_LENGTH) {
+        return { valid: false, code: "INVALID_LENGTH" };
+    }
+    if (!validateNationalOrE164Format(input.value)) {
+        return { valid: false, code: "INVALID_FORMAT" };
+    }
+    const nationalNumber = input.value.length === NATIONAL_PHONE_LENGTH ? input.value : `0${input.value.slice(4)}`;
+    if (!/^01[123467]/.test(nationalNumber)) {
+        return { valid: false, code: "INVALID_PREFIX" };
+    }
+    return { valid: true, value: input.value };
+}
+export function isLandlineNumber(value) {
+    return validateLandlineNumber(value).valid;
+}
+export function validateTollFreeNumber(value) {
+    const input = checkStringInput(value);
+    if (!input.valid) {
+        return input;
+    }
+    if (input.value.length !== NATIONAL_PHONE_LENGTH) {
+        return { valid: false, code: "INVALID_LENGTH" };
+    }
+    if (!isAsciiDigits(input.value)) {
+        return { valid: false, code: "INVALID_FORMAT" };
+    }
+    if (!input.value.startsWith("800")) {
+        return { valid: false, code: "INVALID_PREFIX" };
+    }
+    return { valid: true, value: input.value };
+}
+export function isTollFreeNumber(value) {
+    return validateTollFreeNumber(value).valid;
+}
+export function normalizePhoneNumber(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    if (validateTollFreeNumber(value).valid) {
+        return { kind: "toll-free", value: `800${value.slice(3)}` };
+    }
+    let canonical;
+    if (hasE164SaudiPrefix(value)) {
+        canonical = value;
+    }
+    else if (value.startsWith("00966")) {
+        canonical = `+966${value.slice(5)}`;
+    }
+    else if (value.startsWith("966")) {
+        canonical = `+966${value.slice(3)}`;
+    }
+    else if (value.startsWith("0")) {
+        canonical = `+966${value.slice(1)}`;
+    }
+    else {
+        return null;
+    }
+    if (validateMobileNumber(canonical).valid) {
+        return { kind: "mobile", value: canonical };
+    }
+    if (validateLandlineNumber(canonical).valid) {
+        return { kind: "landline", value: canonical };
+    }
+    return null;
+}
+//# sourceMappingURL=telecom.js.map

package/dist/telecom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telecom.js","sourceRoot":"","sources":["../src/telecom.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,32 @@
+export type ValidationErrorCode = "REQUIRED" | "INVALID_TYPE" | "INVALID_LENGTH" | "INVALID_FORMAT" | "INVALID_PREFIX" | "INVALID_CHECKSUM";
+export type ValidationResult = {
+    valid: true;
+    value: string;
+} | {
+    valid: false;
+    code: ValidationErrorCode;
+};
+export type ValidationEvidence = "official-checksum" | "official-structural" | "official-structural-community-checksum" | "best-known-structural";
+export type NormalizedSaudiPhone = {
+    kind: "mobile" | "landline";
+    value: `+966${string}`;
+} | {
+    kind: "toll-free";
+    value: `800${string}`;
+};
+export type NationalAddress = {
+    buildingNumber: string;
+    street: string;
+    district: string;
+    city: string;
+    postalCode: string;
+    additionalNumber: string;
+};
+export type NationalAddressValidationResult = {
+    valid: true;
+    value: NationalAddress;
+} | {
+    valid: false;
+    code: ValidationErrorCode;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAC3B,UAAU,GACV,cAAc,GACd,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,GAChB,kBAAkB,CAAC;AAEvB,MAAM,MAAM,gBAAgB,GACxB;IACE,KAAK,EAAE,IAAI,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,mBAAmB,CAAC;CAC3B,CAAC;AAEN,MAAM,MAAM,kBAAkB,GAC1B,mBAAmB,GACnB,qBAAqB,GACrB,wCAAwC,GACxC,uBAAuB,CAAC;AAE5B,MAAM,MAAM,oBAAoB,GAC5B;IACE,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC5B,KAAK,EAAE,OAAO,MAAM,EAAE,CAAC;CACxB,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,MAAM,EAAE,CAAC;CACvB,CAAC;AAEN,MAAM,MAAM,eAAe,GAAG;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,+BAA+B,GACvC;IACE,KAAK,EAAE,IAAI,CAAC;IACZ,KAAK,EAAE,eAAe,CAAC;CACxB,GACD;IACE,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,mBAAmB,CAAC;CAC3B,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "saudi-utils",
+  "version": "0.1.0",
+  "description": "Strict Saudi identity, IBAN, business, telecom, and address validation utilities",
+  "keywords": [
+    "saudi",
+    "saudi-arabia",
+    "ksa",
+    "validation",
+    "national-id",
+    "iqama",
+    "iban",
+    "zatca",
+    "national-address",
+    "typescript"
+  ],
+  "author": "Ali Alaraby",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alialaraby/saudi-utils.git"
+  },
+  "bugs": {
+    "url": "https://github.com/alialaraby/saudi-utils/issues"
+  },
+  "homepage": "https://github.com/alialaraby/saudi-utils#readme",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {},
+  "scripts": {
+    "clean": "node --eval \"import { rmSync } from 'node:fs'; for (const path of ['dist', 'coverage']) rmSync(path, { recursive: true, force: true });\"",
+    "build": "npm run clean && tsc --project tsconfig.json",
+    "typecheck": "tsc --project tsconfig.json --noEmit && tsc --project tsconfig.test.json --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "docs:check": "npm run build && tsc --project tsconfig.examples.json --noEmit && node examples/quick-start.ts && node scripts/check-doc-links.mjs",
+    "publint": "publint --strict",
+    "attw": "attw --pack . --profile esm-only",
+    "pack:dry-run": "npm pack --dry-run --json",
+    "pack:check": "node scripts/check-package-contents.mjs",
+    "pack:consumers": "node scripts/check-packed-consumers.mjs",
+    "package:check": "npm run build && npm run publint && npm run attw && npm run pack:check && npm run pack:consumers",
+    "check": "npm run format:check && npm run lint && npm run typecheck && npm run test:coverage && npm run build"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.5",
+    "@vitest/coverage-v8": "^5.0.1",
+    "eslint": "^10.10.0",
+    "prettier": "^3.9.6",
+    "publint": "^0.3.24",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.70.0",
+    "vitest": "^5.0.1"
+  }
+}