@nodibyte/bd-utils 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nodibyte
+
+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

@@ -1,3 +1,42 @@
-# Temporary Holding Version
+# @nodibyte/bd-utils
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Bangladeshi mobile number validation and Bangla digit parsing. Zero dependencies, ~30 lines.
+
+Users on Bangla keyboards type `০১৭১২৩৪৫৬৭৮`. Most BD phone regexes reject that. This doesn't.
+
+```bash
+npm install @nodibyte/bd-utils
+```
+
+```js
+import { normalizeMobile, isMobile, toE164, operator, toAsciiDigits } from '@nodibyte/bd-utils'
+
+normalizeMobile('+880 1712-345678')  // '01712345678'
+normalizeMobile('০১৭১২৩৪৫৬৭৮')       // '01712345678'
+normalizeMobile('01212345678')       // null
+isMobile('01912345678')              // true
+toE164('01812345678')                // '+8801812345678'
+operator('01612345678')              // 'Robi'
+toAsciiDigits('৳১,২৩৪')              // '৳1,234'
+```
+
+| Function | Returns |
+|---|---|
+| `normalizeMobile(s)` | `01XXXXXXXXX`, or `null` if not a valid BD mobile. Accepts `+88`/`88` prefix, spaces, dashes, dots, brackets, Bangla digits. |
+| `isMobile(s)` | `boolean` |
+| `toE164(s)` | `+8801XXXXXXXXX` or `null` (for SMS gateways, WhatsApp links) |
+| `operator(s)` | `'Grameenphone'` (013, 017), `'Banglalink'` (014, 019), `'Teletalk'` (015), `'Robi'` (016, 018), or `null`. By prefix, so a ported number shows its original operator. |
+| `toAsciiDigits(s)` | Same string with ০–৯ replaced by 0–9. Run before `Number()` or `parseFloat()` on user input. |
+
+## Formatting? Use the platform
+
+Showing numbers in Bangla or with lakh/crore grouping needs no library:
+
+```js
+(1234567).toLocaleString('bn-BD')  // '১২,৩৪,৫৬৭'
+(1234567).toLocaleString('en-IN')  // '12,34,567'
+```
+
+## License
+
+MIT © [Nodibyte](https://www.nodibyte.com). Used in Nodibyte's store, pharmacy and restaurant software.

package/index.d.ts

@@ -0,0 +1,6 @@
+export type Operator = 'Grameenphone' | 'Banglalink' | 'Teletalk' | 'Robi'
+export function toAsciiDigits(text: string | number): string
+export function normalizeMobile(input: string): string | null
+export function isMobile(input: string): boolean
+export function toE164(input: string): string | null
+export function operator(input: string): Operator | null

package/index.js

@@ -0,0 +1,27 @@
+const BN_ZERO = 0x09e6
+
+export function toAsciiDigits(text) {
+  return String(text).replace(/[০-৯]/g, (d) => String(d.charCodeAt(0) - BN_ZERO))
+}
+
+export function normalizeMobile(input) {
+  const digits = toAsciiDigits(input).replace(/[\s\-().]/g, '').replace(/^(?:\+?88)/, '')
+  return /^01[3-9]\d{8}$/.test(digits) ? digits : null
+}
+
+export function isMobile(input) {
+  return normalizeMobile(input) !== null
+}
+
+export function toE164(input) {
+  const n = normalizeMobile(input)
+  return n && `+88${n}`
+}
+
+const OPERATORS = { 3: 'Grameenphone', 7: 'Grameenphone', 4: 'Banglalink', 9: 'Banglalink', 5: 'Teletalk', 6: 'Robi', 8: 'Robi' }
+
+// Prefix only: numbers ported between operators keep their old prefix.
+export function operator(input) {
+  const n = normalizeMobile(input)
+  return n && OPERATORS[n[2]]
+}

package/package.json

@@ -1,6 +1,18 @@
 {
   "name": "@nodibyte/bd-utils",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Bangladeshi mobile number validation and Bangla digit parsing. Zero dependencies.",
+  "type": "module",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "exports": { ".": { "types": "./index.d.ts", "default": "./index.js" } },
+  "files": ["index.js", "index.d.ts"],
+  "scripts": { "test": "node test.js" },
+  "keywords": ["bangladesh", "bangla", "bengali", "mobile", "phone", "validation", "bkash", "digits"],
+  "author": "Nodibyte <hello@nodibyte.com> (https://www.nodibyte.com)",
+  "license": "MIT",
+  "repository": { "type": "git", "url": "git+https://github.com/nodibyte/bd-utils.git" },
+  "homepage": "https://github.com/nodibyte/bd-utils#readme",
+  "bugs": "https://github.com/nodibyte/bd-utils/issues",
+  "sideEffects": false
+}