phoneoperator 0.1.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.
@@ -0,0 +1,45 @@
1
+ import { type Brand } from './brands.js';
2
+ export type PhoneType = 'mobile' | 'landline';
3
+ export interface Operator {
4
+ readonly name: string;
5
+ readonly inn: string;
6
+ readonly brand: Brand | null;
7
+ }
8
+ export interface PhoneInfo {
9
+ readonly number: string;
10
+ readonly national: string;
11
+ readonly code: string;
12
+ readonly type: PhoneType;
13
+ readonly operator: Operator;
14
+ readonly region: string;
15
+ readonly locality: string | null;
16
+ }
17
+ export interface Dataset {
18
+ readonly type: PhoneType;
19
+ readonly operators: readonly (readonly [inn: string, name: string])[];
20
+ readonly places: readonly string[];
21
+ readonly ranges: string;
22
+ }
23
+ /**
24
+ * Normalizes a Russian phone number to its 10 national digits.
25
+ *
26
+ * Accepts `+7`, `7` and `8` prefixes and the usual separators: spaces, dashes, dots and parentheses.
27
+ *
28
+ * @example
29
+ * ```ts
30
+ * parsePhone('8 (912) 345-67-89'); // '9123456789'
31
+ * parsePhone('+1 212 555 0100'); // null
32
+ * ```
33
+ */
34
+ export declare const parsePhone: (input: string) => string | null;
35
+ /**
36
+ * Formats a Russian phone number as `+7 912 345-67-89`, or returns `null` if it is not one.
37
+ *
38
+ * @example
39
+ * ```ts
40
+ * formatPhone('89123456789'); // '+7 912 345-67-89'
41
+ * ```
42
+ */
43
+ export declare const formatPhone: (input: string) => string | null;
44
+ export declare const createLookup: (datasets: readonly Dataset[]) => ((input: string) => PhoneInfo | null);
45
+ //# sourceMappingURL=lookup.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../src/lookup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE9C,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;IACtE,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAsDD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,MAAM,GAAG,IAKnD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,MAAM,GAAG,IAGpD,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,UAAU,SAAS,OAAO,EAAE,KAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,GAAG,IAAI,CAyB/F,CAAC"}
package/dist/lookup.js ADDED
@@ -0,0 +1,103 @@
1
+ import { BRANDS } from './brands.js';
2
+ const decode = (dataset) => {
3
+ const entries = dataset.ranges.split(';');
4
+ const starts = new Float64Array(entries.length);
5
+ const ends = new Float64Array(entries.length);
6
+ const operators = new Uint16Array(entries.length);
7
+ const places = new Uint16Array(entries.length);
8
+ let previous = -1;
9
+ entries.forEach((entry, index) => {
10
+ const [gap = 0, length = 0, operator = 0, place = 0] = entry.split(',').map((value) => parseInt(value, 36));
11
+ starts[index] = previous + 1 + gap;
12
+ ends[index] = previous = previous + 1 + gap + length;
13
+ operators[index] = operator;
14
+ places[index] = place;
15
+ });
16
+ return {
17
+ type: dataset.type,
18
+ starts,
19
+ ends,
20
+ operators,
21
+ places,
22
+ operatorList: dataset.operators.map(([inn, name]) => ({ name, inn, brand: BRANDS[inn] ?? null })),
23
+ placeList: dataset.places.map((value) => {
24
+ const [first = '', second] = value.split('|');
25
+ return second === undefined ? [first, null] : [second, first];
26
+ }),
27
+ };
28
+ };
29
+ const find = (table, value) => {
30
+ let low = 0;
31
+ let high = table.starts.length - 1;
32
+ while (low <= high) {
33
+ const middle = (low + high) >> 1;
34
+ if ((table.ends[middle] ?? 0) < value)
35
+ low = middle + 1;
36
+ else if ((table.starts[middle] ?? 0) > value)
37
+ high = middle - 1;
38
+ else
39
+ return middle;
40
+ }
41
+ return -1;
42
+ };
43
+ const SEPARATORS = /[\s()\-. ]/g;
44
+ /**
45
+ * Normalizes a Russian phone number to its 10 national digits.
46
+ *
47
+ * Accepts `+7`, `7` and `8` prefixes and the usual separators: spaces, dashes, dots and parentheses.
48
+ *
49
+ * @example
50
+ * ```ts
51
+ * parsePhone('8 (912) 345-67-89'); // '9123456789'
52
+ * parsePhone('+1 212 555 0100'); // null
53
+ * ```
54
+ */
55
+ export const parsePhone = (input) => {
56
+ const compact = input.trim().replace(SEPARATORS, '');
57
+ const match = /^(?:\+7|7|8)?(\d{10})$/.exec(compact);
58
+ if (!match?.[1] || (compact.startsWith('+') && !compact.startsWith('+7')))
59
+ return null;
60
+ return /^[3489]/.test(match[1]) ? match[1] : null;
61
+ };
62
+ /**
63
+ * Formats a Russian phone number as `+7 912 345-67-89`, or returns `null` if it is not one.
64
+ *
65
+ * @example
66
+ * ```ts
67
+ * formatPhone('89123456789'); // '+7 912 345-67-89'
68
+ * ```
69
+ */
70
+ export const formatPhone = (input) => {
71
+ const national = parsePhone(input);
72
+ return national && `+7 ${national.slice(0, 3)} ${national.slice(3, 6)}-${national.slice(6, 8)}-${national.slice(8)}`;
73
+ };
74
+ export const createLookup = (datasets) => {
75
+ let tables = null;
76
+ return (input) => {
77
+ const national = parsePhone(input);
78
+ if (!national)
79
+ return null;
80
+ tables ??= datasets.map(decode);
81
+ const value = Number(national);
82
+ for (const table of tables) {
83
+ const index = find(table, value);
84
+ if (index < 0)
85
+ continue;
86
+ const operator = table.operatorList[table.operators[index] ?? 0];
87
+ const place = table.placeList[table.places[index] ?? 0];
88
+ if (!operator || !place)
89
+ return null;
90
+ return {
91
+ number: `+7${national}`,
92
+ national,
93
+ code: national.slice(0, 3),
94
+ type: table.type,
95
+ operator,
96
+ region: place[0],
97
+ locality: place[1],
98
+ };
99
+ }
100
+ return null;
101
+ };
102
+ };
103
+ //# sourceMappingURL=lookup.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lookup.js","sourceRoot":"","sources":["../src/lookup.ts"],"names":[],"mappings":"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"}
package/package.json ADDED
@@ -0,0 +1,63 @@
1
+ {
2
+ "name": "phoneoperator",
3
+ "version": "0.1.0",
4
+ "description": "Operator and region of a Russian phone number, offline, from the official numbering registry",
5
+ "keywords": [
6
+ "phone",
7
+ "russia",
8
+ "mobile-operator",
9
+ "carrier",
10
+ "region",
11
+ "rossvyaz",
12
+ "def-code",
13
+ "оператор",
14
+ "typescript"
15
+ ],
16
+ "license": "MIT",
17
+ "author": "MrProLopstar",
18
+ "type": "module",
19
+ "sideEffects": false,
20
+ "engines": {
21
+ "node": ">=18"
22
+ },
23
+ "exports": {
24
+ ".": {
25
+ "types": "./dist/index.d.ts",
26
+ "import": "./dist/index.js"
27
+ },
28
+ "./full": {
29
+ "types": "./dist/full.d.ts",
30
+ "import": "./dist/full.js"
31
+ },
32
+ "./package.json": "./package.json"
33
+ },
34
+ "main": "./dist/index.js",
35
+ "types": "./dist/index.d.ts",
36
+ "files": [
37
+ "dist",
38
+ "README.md",
39
+ "LICENSE",
40
+ "CHANGELOG.md",
41
+ "README.ru.md"
42
+ ],
43
+ "repository": {
44
+ "type": "git",
45
+ "url": "git+https://github.com/MrProLopstar/phoneoperator.git"
46
+ },
47
+ "homepage": "https://github.com/MrProLopstar/phoneoperator#readme",
48
+ "bugs": {
49
+ "url": "https://github.com/MrProLopstar/phoneoperator/issues"
50
+ },
51
+ "scripts": {
52
+ "build": "tsc -p tsconfig.build.json",
53
+ "typecheck": "tsc --noEmit",
54
+ "test": "vitest run",
55
+ "data": "node --use-system-ca scripts/fetch-data.ts",
56
+ "prepare": "npm run build"
57
+ },
58
+ "devDependencies": {
59
+ "@types/node": "^22.10.0",
60
+ "typescript": "^5.7.0",
61
+ "vitest": "^3.0.0"
62
+ }
63
+ }