@heavybit/pendoadmin-shared-lib 1.1.9 → 1.2.0

package/dist/common/phone.utils.d.ts

@@ -1,4 +1,25 @@
 export declare function normalizePhoneNumber(phone: string, defaultCountry?: string): string;
 export declare function isValidPhoneNumber(phone: string, defaultCountry?: string): boolean;
 export declare function formatPhoneNumber(phone: string, format?: 'e164' | 'international' | 'national', defaultCountry?: string): string;
+/**
+ * WhatsApp Cloud API format: E.164 without leading '+'.
+ * E.g. '+254712345678' -> '254712345678'.
+ */
+export declare function toWhatsAppFormat(phone: string, defaultCountry?: string): string;
+/**
+ * Normalise a phone number to a plain MSISDN (no '+'), suitable for DB storage.
+ * E.g. '+254712345678' | '0712345678' | '254712345678' → '254712345678'.
+ *
+ * Uses libphonenumber to extract the numeric country code and national number,
+ * then concatenates them — no manual string slicing.
+ * Falls back to stripping non-digits if parsing fails.
+ */
+export declare function toMsisdn(phone: string, defaultCountry?: string): string;
+/**
+ * Return the ISO 3166-1 alpha-2 region code for a phone number.
+ * E.g. '0712345678' → 'KE', '+447911123456' → 'GB'.
+ *
+ * Falls back to `defaultCountry` if parsing fails.
+ */
+export declare function extractPhoneRegion(phone: string, defaultCountry?: string): string;
 //# sourceMappingURL=phone.utils.d.ts.map

package/dist/common/phone.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"phone.utils.d.ts","sourceRoot":"","sources":["../../src/common/phone.utils.ts"],"names":[],"mappings":"AAKA,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,GAAE,MAAa,GAAG,MAAM,CAOzF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,GAAE,MAAa,GAAG,OAAO,CAOxF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,GAAG,eAAe,GAAG,UAAmB,EAAE,cAAc,GAAE,MAAa,GAAG,MAAM,CAY9I"}
+{"version":3,"file":"phone.utils.d.ts","sourceRoot":"","sources":["../../src/common/phone.utils.ts"],"names":[],"mappings":"AAKA,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,GAAE,MAAa,GAAG,MAAM,CAOzF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,GAAE,MAAa,GAAG,OAAO,CAOxF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,GAAG,eAAe,GAAG,UAAmB,EAAE,cAAc,GAAE,MAAa,GAAG,MAAM,CAY9I;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,GAAE,MAAa,GAAG,MAAM,CAGrF;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,GAAE,MAAa,GAAG,MAAM,CAO7E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,GAAE,MAAa,GAAG,MAAM,CAOvF"}

package/dist/common/phone.utils.js

@@ -33,4 +33,44 @@ export function formatPhoneNumber(phone, format = 'e164', defaultCountry = 'KE')
         return phone;
     }
 }
+/**
+ * WhatsApp Cloud API format: E.164 without leading '+'.
+ * E.g. '+254712345678' -> '254712345678'.
+ */
+export function toWhatsAppFormat(phone, defaultCountry = 'KE') {
+    const e164 = normalizePhoneNumber(phone, defaultCountry);
+    return e164.startsWith('+') ? e164.slice(1) : e164;
+}
+/**
+ * Normalise a phone number to a plain MSISDN (no '+'), suitable for DB storage.
+ * E.g. '+254712345678' | '0712345678' | '254712345678' → '254712345678'.
+ *
+ * Uses libphonenumber to extract the numeric country code and national number,
+ * then concatenates them — no manual string slicing.
+ * Falls back to stripping non-digits if parsing fails.
+ */
+export function toMsisdn(phone, defaultCountry = 'KE') {
+    try {
+        const parsed = phoneUtil.parse(phone, defaultCountry);
+        return `${parsed.getCountryCode()}${parsed.getNationalNumber()}`;
+    }
+    catch {
+        return String(phone).replace(/\D/g, '');
+    }
+}
+/**
+ * Return the ISO 3166-1 alpha-2 region code for a phone number.
+ * E.g. '0712345678' → 'KE', '+447911123456' → 'GB'.
+ *
+ * Falls back to `defaultCountry` if parsing fails.
+ */
+export function extractPhoneRegion(phone, defaultCountry = 'KE') {
+    try {
+        const parsed = phoneUtil.parse(phone, defaultCountry);
+        return phoneUtil.getRegionCodeForNumber(parsed) ?? defaultCountry;
+    }
+    catch {
+        return defaultCountry;
+    }
+}
 //# sourceMappingURL=phone.utils.js.map

package/dist/common/phone.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"phone.utils.js","sourceRoot":"","sources":["../../src/common/phone.utils.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,uBAAuB,CAAC;AACxC,MAAM,EAAE,eAAe,EAAE,iBAAiB,EAAE,GAAG,GAAG,CAAC;AAEnD,MAAM,SAAS,GAAG,eAAe,CAAC,WAAW,EAAE,CAAC;AAEhD,MAAM,UAAU,oBAAoB,CAAC,KAAa,EAAE,iBAAyB,IAAI;IAC/E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;QACtD,OAAO,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,iBAAyB,IAAI;IAC7E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;QACtD,OAAO,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,SAAgD,MAAM,EAAE,iBAAyB,IAAI;IACpI,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG;YAChB,IAAI,EAAE,iBAAiB,CAAC,IAAI;YAC5B,aAAa,EAAE,iBAAiB,CAAC,aAAa;YAC9C,QAAQ,EAAE,iBAAiB,CAAC,QAAQ;SACrC,CAAC;QACF,OAAO,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"phone.utils.js","sourceRoot":"","sources":["../../src/common/phone.utils.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,uBAAuB,CAAC;AACxC,MAAM,EAAE,eAAe,EAAE,iBAAiB,EAAE,GAAG,GAAG,CAAC;AAEnD,MAAM,SAAS,GAAG,eAAe,CAAC,WAAW,EAAE,CAAC;AAEhD,MAAM,UAAU,oBAAoB,CAAC,KAAa,EAAE,iBAAyB,IAAI;IAC/E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;QACtD,OAAO,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,iBAAyB,IAAI;IAC7E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;QACtD,OAAO,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,SAAgD,MAAM,EAAE,iBAAyB,IAAI;IACpI,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG;YAChB,IAAI,EAAE,iBAAiB,CAAC,IAAI;YAC5B,aAAa,EAAE,iBAAiB,CAAC,aAAa;YAC9C,QAAQ,EAAE,iBAAiB,CAAC,QAAQ;SACrC,CAAC;QACF,OAAO,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,iBAAyB,IAAI;IAC3E,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IACzD,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACrD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,iBAAyB,IAAI;IACnE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;QACtD,OAAO,GAAG,MAAM,CAAC,cAAc,EAAE,GAAG,MAAM,CAAC,iBAAiB,EAAE,EAAE,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,iBAAyB,IAAI;IAC7E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;QACtD,OAAO,SAAS,CAAC,sBAAsB,CAAC,MAAM,CAAC,IAAI,cAAc,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,cAAc,CAAC;IACxB,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heavybit/pendoadmin-shared-lib",
-  "version": "1.1.9",
+  "version": "1.2.0",
   "description": "Shared library for PendoAdmin microservices",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/common/phone.utils.ts

@@ -34,3 +34,44 @@ export function formatPhoneNumber(phone: string, format: 'e164' | 'international
     return phone;
   }
 }
+
+/**
+ * WhatsApp Cloud API format: E.164 without leading '+'.
+ * E.g. '+254712345678' -> '254712345678'.
+ */
+export function toWhatsAppFormat(phone: string, defaultCountry: string = 'KE'): string {
+  const e164 = normalizePhoneNumber(phone, defaultCountry);
+  return e164.startsWith('+') ? e164.slice(1) : e164;
+}
+
+/**
+ * Normalise a phone number to a plain MSISDN (no '+'), suitable for DB storage.
+ * E.g. '+254712345678' | '0712345678' | '254712345678' → '254712345678'.
+ *
+ * Uses libphonenumber to extract the numeric country code and national number,
+ * then concatenates them — no manual string slicing.
+ * Falls back to stripping non-digits if parsing fails.
+ */
+export function toMsisdn(phone: string, defaultCountry: string = 'KE'): string {
+  try {
+    const parsed = phoneUtil.parse(phone, defaultCountry);
+    return `${parsed.getCountryCode()}${parsed.getNationalNumber()}`;
+  } catch {
+    return String(phone).replace(/\D/g, '');
+  }
+}
+
+/**
+ * Return the ISO 3166-1 alpha-2 region code for a phone number.
+ * E.g. '0712345678' → 'KE', '+447911123456' → 'GB'.
+ *
+ * Falls back to `defaultCountry` if parsing fails.
+ */
+export function extractPhoneRegion(phone: string, defaultCountry: string = 'KE'): string {
+  try {
+    const parsed = phoneUtil.parse(phone, defaultCountry);
+    return phoneUtil.getRegionCodeForNumber(parsed) ?? defaultCountry;
+  } catch {
+    return defaultCountry;
+  }
+}

package/tsconfig.json

@@ -2,7 +2,7 @@
   "compilerOptions": {
     "target": "ES2022",
     "module": "ES2022",
-    "moduleResolution": "node",
+    "moduleResolution": "bundler",
     "lib": ["ES2022"],
     "outDir": "./dist",
     "rootDir": "./src",