grm-shared-library 1.1.183 → 1.1.185

package/dist/esm/modules/auth/dtos/register-mobile-user.dto.js

@@ -7,9 +7,11 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { IsEmail, IsEnum, IsNotEmpty, IsNumber, IsPhoneNumber, IsString } from "class-validator";
-import { ApiProperty } from "@nestjs/swagger";
+import { IsEmail, IsEnum, IsNotEmpty, IsNumber, IsOptional, IsString } from "class-validator";
+import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
 import { IncidentAppId } from "../../incident";
+import { CountryCode } from "../../country/enums/country-code.enum";
+import { IsSupportedPhoneNumber } from "../../phone/validators/is-supported-phone-number.decorator";
 export class RegisterMobileUserDto {
 }
 __decorate([
@@ -43,14 +45,24 @@ __decorate([
 ], RegisterMobileUserDto.prototype, "email", void 0);
 __decorate([
     ApiProperty({
-        description: 'Phone number with country code',
-        example: '+1234567890',
+        description: 'Phone number in E.164 format (e.g. +254712345678), or national format when countryCode is provided',
+        example: '+254712345678',
         format: 'phone'
     }),
-    IsPhoneNumber(),
+    IsSupportedPhoneNumber(),
     IsNotEmpty(),
     __metadata("design:type", String)
 ], RegisterMobileUserDto.prototype, "phoneNumber", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'ISO 3166-1 alpha-2 country code for the phone number (KE, UG, TZ). Required when phoneNumber is in national format; defaults to KE.',
+        enum: CountryCode,
+        example: CountryCode.KE
+    }),
+    IsEnum(CountryCode),
+    IsOptional(),
+    __metadata("design:type", String)
+], RegisterMobileUserDto.prototype, "countryCode", void 0);
 __decorate([
     ApiProperty({
         description: 'ID of the control centre the user belongs to',

package/dist/esm/modules/auth/dtos/register-mobile-user.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"register-mobile-user.dto.js","sourceRoot":"","sources":["../../../../../src/modules/auth/dtos/register-mobile-user.dto.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACjG,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,OAAO,qBAAqB;CAmDjC;AA3CG;IAPC,WAAW,CAAC;QACT,WAAW,EAAE,mDAAmD;QAChE,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,aAAa,CAAC,KAAK;KAC/B,CAAC;IACD,MAAM,CAAC,aAAa,CAAC;IACrB,UAAU,EAAE;;oDACS;AAQtB;IANC,WAAW,CAAC;QACT,WAAW,EAAE,8BAA8B;QAC3C,OAAO,EAAE,UAAU;KACtB,CAAC;IACD,QAAQ,EAAE;IACV,UAAU,EAAE;;mDACC;AASd;IAPC,WAAW,CAAC;QACT,WAAW,EAAE,kCAAkC;QAC/C,OAAO,EAAE,sBAAsB;QAC/B,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,OAAO,EAAE;IACT,UAAU,EAAE;;oDACE;AASf;IAPC,WAAW,CAAC;QACT,WAAW,EAAE,gCAAgC;QAC7C,OAAO,EAAE,aAAa;QACtB,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,aAAa,EAAE;IACf,UAAU,EAAE;;0DACQ;AAQrB;IANC,WAAW,CAAC;QACT,WAAW,EAAE,8CAA8C;QAC3D,OAAO,EAAE,GAAG;KACf,CAAC;IACD,QAAQ,EAAE;IACV,UAAU,EAAE;;8DACY;AAQzB;IANC,WAAW,CAAC;QACT,WAAW,EAAE,4CAA4C;QACzD,OAAO,EAAE,GAAG;KACf,CAAC;IACD,QAAQ,EAAE;IACV,UAAU,EAAE;;6DACW"}
+{"version":3,"file":"register-mobile-user.dto.js","sourceRoot":"","sources":["../../../../../src/modules/auth/dtos/register-mobile-user.dto.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC9F,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4DAA4D,CAAC;AAEpG,MAAM,OAAO,qBAAqB;CA4DjC;AApDG;IAPC,WAAW,CAAC;QACT,WAAW,EAAE,mDAAmD;QAChE,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,aAAa,CAAC,KAAK;KAC/B,CAAC;IACD,MAAM,CAAC,aAAa,CAAC;IACrB,UAAU,EAAE;;oDACS;AAQtB;IANC,WAAW,CAAC;QACT,WAAW,EAAE,8BAA8B;QAC3C,OAAO,EAAE,UAAU;KACtB,CAAC;IACD,QAAQ,EAAE;IACV,UAAU,EAAE;;mDACC;AASd;IAPC,WAAW,CAAC;QACT,WAAW,EAAE,kCAAkC;QAC/C,OAAO,EAAE,sBAAsB;QAC/B,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,OAAO,EAAE;IACT,UAAU,EAAE;;oDACE;AASf;IAPC,WAAW,CAAC;QACT,WAAW,EAAE,oGAAoG;QACjH,OAAO,EAAE,eAAe;QACxB,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,sBAAsB,EAAE;IACxB,UAAU,EAAE;;0DACQ;AASrB;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,qIAAqI;QAClJ,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,WAAW,CAAC,EAAE;KAC1B,CAAC;IACD,MAAM,CAAC,WAAW,CAAC;IACnB,UAAU,EAAE;;0DACa;AAQ1B;IANC,WAAW,CAAC;QACT,WAAW,EAAE,8CAA8C;QAC3D,OAAO,EAAE,GAAG;KACf,CAAC;IACD,QAAQ,EAAE;IACV,UAAU,EAAE;;8DACY;AAQzB;IANC,WAAW,CAAC;QACT,WAAW,EAAE,4CAA4C;QACzD,OAAO,EAAE,GAAG;KACf,CAAC;IACD,QAAQ,EAAE;IACV,UAAU,EAAE;;6DACW"}

package/dist/esm/modules/auth/dtos/register.dto.js

@@ -7,7 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { IsArray, IsEmail, IsEnum, IsNotEmpty, IsOptional, IsPhoneNumber, IsString, IsUrl, Matches, MaxLength, MinLength, ValidateNested } from "class-validator";
+import { IsArray, IsEmail, IsEnum, IsNotEmpty, IsOptional, IsString, IsUrl, Matches, MaxLength, MinLength, ValidateNested } from "class-validator";
 import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
 import { MapAddressDto } from "../../common";
 import { Roles } from "../../role";
@@ -16,6 +16,8 @@ import { PASSWORD_ERROR_MESSAGE, PASSWORD_REGEX } from "../../common/constants/p
 import { Type } from "class-transformer";
 import { OrganizationType } from "../../organization/enums/org-type.enum";
 import { IncidentAppId, IncidentClass } from "../../incident";
+import { CountryCode } from "../../country/enums/country-code.enum";
+import { IsSupportedPhoneNumber } from "../../phone/validators/is-supported-phone-number.decorator";
 export class RegisterDto {
 }
 __decorate([
@@ -66,16 +68,26 @@ __decorate([
 ], RegisterDto.prototype, "email", void 0);
 __decorate([
     ApiProperty({
-        description: 'Phone number with country code',
-        example: '+1234567890',
+        description: 'Phone number in E.164 format (e.g. +254712345678), or national format when countryCode is provided',
+        example: '+254712345678',
         format: 'phone',
         maxLength: 20
     }),
-    IsPhoneNumber(),
+    IsSupportedPhoneNumber(),
     MaxLength(20),
     IsNotEmpty(),
     __metadata("design:type", String)
 ], RegisterDto.prototype, "phoneNumber", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'ISO 3166-1 alpha-2 country code for the phone number (KE, UG, TZ). Required when phoneNumber is in national format; defaults to KE.',
+        enum: CountryCode,
+        example: CountryCode.KE
+    }),
+    IsEnum(CountryCode),
+    IsOptional(),
+    __metadata("design:type", String)
+], RegisterDto.prototype, "countryCode", void 0);
 __decorate([
     ApiPropertyOptional({
         description: 'User roles (optional)',

package/dist/esm/modules/auth/dtos/register.dto.js.map

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

package/dist/esm/modules/auth/dtos/resend-otp.dto.js

@@ -7,9 +7,11 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { IsEmail, IsEnum, IsNotEmpty, IsOptional, IsPhoneNumber, IsString } from "class-validator";
+import { IsEmail, IsEnum, IsNotEmpty, IsOptional, IsString } from "class-validator";
 import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
 import { OtpAction } from "../enums/otp-action";
+import { CountryCode } from "../../country/enums/country-code.enum";
+import { IsSupportedPhoneNumber } from "../../phone/validators/is-supported-phone-number.decorator";
 export class ResendOTPDto {
 }
 __decorate([
@@ -45,12 +47,22 @@ __decorate([
 ], ResendOTPDto.prototype, "email", void 0);
 __decorate([
     ApiPropertyOptional({
-        description: 'Phone number of the user requesting OTP',
-        example: '+1234567890',
+        description: 'Phone number of the user requesting OTP, in E.164 format (e.g. +254712345678) or national format when countryCode is provided',
+        example: '+254712345678',
         format: 'phone'
     }),
-    IsPhoneNumber(),
+    IsSupportedPhoneNumber(),
     IsOptional(),
     __metadata("design:type", String)
 ], ResendOTPDto.prototype, "phoneNumber", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'ISO 3166-1 alpha-2 country code for the phone number (KE, UG, TZ). Required when phoneNumber is in national format; defaults to KE.',
+        enum: CountryCode,
+        example: CountryCode.KE
+    }),
+    IsEnum(CountryCode),
+    IsOptional(),
+    __metadata("design:type", String)
+], ResendOTPDto.prototype, "countryCode", void 0);
 //# sourceMappingURL=resend-otp.dto.js.map

package/dist/esm/modules/auth/dtos/resend-otp.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"resend-otp.dto.js","sourceRoot":"","sources":["../../../../../src/modules/auth/dtos/resend-otp.dto.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACnG,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,OAAO,YAAY;CAqCxB;AA5BG;IARC,WAAW,CAAC;QACT,WAAW,EAAE,yCAAyC;QACtD,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,SAAS,CAAC,KAAK;QACxB,MAAM,EAAE,QAAQ;KACnB,CAAC;IACD,MAAM,CAAC,SAAS,CAAC;IACjB,UAAU,EAAE;;4CACM;AASnB;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,0CAA0C;QACvD,OAAO,EAAE,cAAc;QACvB,MAAM,EAAE,QAAQ;KACnB,CAAC;IACD,QAAQ,EAAE;IACV,UAAU,EAAE;;uDACc;AAS3B;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,kCAAkC;QAC/C,OAAO,EAAE,kBAAkB;QAC3B,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,OAAO,EAAE;IACT,UAAU,EAAE;;2CACE;AASf;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,yCAAyC;QACtD,OAAO,EAAE,aAAa;QACtB,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,aAAa,EAAE;IACf,UAAU,EAAE;;iDACQ"}
+{"version":3,"file":"resend-otp.dto.js","sourceRoot":"","sources":["../../../../../src/modules/auth/dtos/resend-otp.dto.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4DAA4D,CAAC;AAEpG,MAAM,OAAO,YAAY;CA8CxB;AArCG;IARC,WAAW,CAAC;QACT,WAAW,EAAE,yCAAyC;QACtD,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,SAAS,CAAC,KAAK;QACxB,MAAM,EAAE,QAAQ;KACnB,CAAC;IACD,MAAM,CAAC,SAAS,CAAC;IACjB,UAAU,EAAE;;4CACM;AASnB;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,0CAA0C;QACvD,OAAO,EAAE,cAAc;QACvB,MAAM,EAAE,QAAQ;KACnB,CAAC;IACD,QAAQ,EAAE;IACV,UAAU,EAAE;;uDACc;AAS3B;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,kCAAkC;QAC/C,OAAO,EAAE,kBAAkB;QAC3B,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,OAAO,EAAE;IACT,UAAU,EAAE;;2CACE;AASf;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,+HAA+H;QAC5I,OAAO,EAAE,eAAe;QACxB,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,sBAAsB,EAAE;IACxB,UAAU,EAAE;;iDACQ;AASrB;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,qIAAqI;QAClJ,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,WAAW,CAAC,EAAE;KAC1B,CAAC;IACD,MAAM,CAAC,WAAW,CAAC;IACnB,UAAU,EAAE;;iDACa"}

package/dist/esm/modules/auth/dtos/send-otp.dto.js

@@ -8,20 +8,32 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
-import { IsEmail, IsEnum, IsNotEmpty, IsOptional, IsPhoneNumber } from "class-validator";
+import { IsEmail, IsEnum, IsNotEmpty, IsOptional } from "class-validator";
 import { OtpAction } from "../enums/otp-action";
+import { CountryCode } from "../../country/enums/country-code.enum";
+import { IsSupportedPhoneNumber } from "../../phone/validators/is-supported-phone-number.decorator";
 export class SendOTPDto {
 }
 __decorate([
     ApiPropertyOptional({
-        description: 'The phone number to send the OTP to (If email is not provided)',
-        example: '+1234567890',
+        description: 'The phone number to send the OTP to, in E.164 format (e.g. +254712345678) or national format when countryCode is provided (If email is not provided)',
+        example: '+254712345678',
         format: 'phone'
     }),
-    IsPhoneNumber(),
+    IsSupportedPhoneNumber(),
     IsOptional(),
     __metadata("design:type", String)
 ], SendOTPDto.prototype, "phoneNumber", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'ISO 3166-1 alpha-2 country code for the phone number (KE, UG, TZ). Required when phoneNumber is in national format; defaults to KE.',
+        enum: CountryCode,
+        example: CountryCode.KE
+    }),
+    IsEnum(CountryCode),
+    IsOptional(),
+    __metadata("design:type", String)
+], SendOTPDto.prototype, "countryCode", void 0);
 __decorate([
     ApiPropertyOptional({
         description: 'The email address to send the OTP to (If phone number is not provided)',

package/dist/esm/modules/auth/dtos/send-otp.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"send-otp.dto.js","sourceRoot":"","sources":["../../../../../src/modules/auth/dtos/send-otp.dto.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAY,MAAM,iBAAiB,CAAC;AACnG,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,OAAO,UAAU;CA2BtB;AAnBG;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,gEAAgE;QAC7E,OAAO,EAAE,aAAa;QACtB,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,aAAa,EAAE;IACf,UAAU,EAAE;;+CACQ;AASrB;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,wEAAwE;QACrF,OAAO,EAAE,kBAAkB;QAC3B,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,OAAO,EAAE;IACT,UAAU,EAAE;;yCACE;AASf;IAPC,WAAW,CAAC;QACT,WAAW,EAAE,yCAAyC;QACtD,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,SAAS,CAAC,YAAY;KAClC,CAAC;IACD,MAAM,CAAC,SAAS,CAAC;IACjB,UAAU,EAAE;;0CACM"}
+{"version":3,"file":"send-otp.dto.js","sourceRoot":"","sources":["../../../../../src/modules/auth/dtos/send-otp.dto.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAY,MAAM,iBAAiB,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4DAA4D,CAAC;AAEpG,MAAM,OAAO,UAAU;CAoCtB;AA5BG;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,sJAAsJ;QACnK,OAAO,EAAE,eAAe;QACxB,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,sBAAsB,EAAE;IACxB,UAAU,EAAE;;+CACQ;AASrB;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,qIAAqI;QAClJ,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,WAAW,CAAC,EAAE;KAC1B,CAAC;IACD,MAAM,CAAC,WAAW,CAAC;IACnB,UAAU,EAAE;;+CACa;AAS1B;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,wEAAwE;QACrF,OAAO,EAAE,kBAAkB;QAC3B,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,OAAO,EAAE;IACT,UAAU,EAAE;;yCACE;AASf;IAPC,WAAW,CAAC;QACT,WAAW,EAAE,yCAAyC;QACtD,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,SAAS,CAAC,YAAY;KAClC,CAAC;IACD,MAAM,CAAC,SAAS,CAAC;IACjB,UAAU,EAAE;;0CACM"}

package/dist/esm/modules/phone/index.js

@@ -0,0 +1,7 @@
+// Interfaces
+export * from './interfaces/normalized-phone';
+// Utilities
+export * from './phone.util';
+// Validators
+export * from './validators/is-supported-phone-number.decorator';
+//# sourceMappingURL=index.js.map

package/dist/esm/modules/phone/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/phone/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,cAAc,+BAA+B,CAAC;AAE9C,YAAY;AACZ,cAAc,cAAc,CAAC;AAE7B,aAAa;AACb,cAAc,kDAAkD,CAAC"}

package/dist/esm/modules/phone/interfaces/normalized-phone.js

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

package/dist/esm/modules/phone/interfaces/normalized-phone.js.map

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

package/dist/esm/modules/phone/phone.util.js

@@ -0,0 +1,86 @@
+import { parsePhoneNumberFromString } from 'libphonenumber-js';
+import { DEFAULT_COUNTRY_CODE } from '../country/constants/country-defaults.const';
+import { isSupportedCountryCode } from '../country/utils/country.util';
+/**
+ * Phone-number normalization for the platform's supported countries (KE/UG/TZ).
+ *
+ * Built on `libphonenumber-js` (robust parsing/validation — no bespoke regex)
+ * and the Phase 1 country primitives. The canonical stored/queried form is
+ * always E.164 (e.g. '+254712345678').
+ */
+/** Digit strings of the supported E.164 calling codes, for the "code-without-plus" case. */
+const SUPPORTED_CALLING_CODE_DIGITS = ['254', '256', '255'];
+function toResult(phone) {
+    if (!phone || !phone.isValid()) {
+        return {
+            ok: false,
+            error: 'INVALID_PHONE_NUMBER',
+            message: 'The phone number is not a valid number.',
+        };
+    }
+    const country = phone.country;
+    if (!country || !isSupportedCountryCode(country)) {
+        return {
+            ok: false,
+            error: 'UNSUPPORTED_COUNTRY',
+            message: `Phone numbers from ${country !== null && country !== void 0 ? country : 'this country'} are not supported. Supported countries are Kenya (KE), Uganda (UG) and Tanzania (TZ).`,
+        };
+    }
+    return {
+        ok: true,
+        value: {
+            e164: phone.number,
+            countryCode: country,
+            nationalNumber: phone.nationalNumber,
+        },
+    };
+}
+/**
+ * Normalize a phone number to canonical E.164 for a supported country.
+ *
+ * Resolution order for a raw (non-`+`) input:
+ *  1. already international (`+254…`) — parsed as-is;
+ *  2. calling code without `+` (`254…`/`256…`/`255…`) — treated as international;
+ *  3. national/local (`0712…`, `712…`) — parsed using `defaultCountry`
+ *     (the caller-supplied country, else Kenya for backward compatibility).
+ *
+ * @returns a discriminated result: `{ ok: true, value }` or `{ ok: false, error, message }`.
+ */
+export function normalizeSupportedPhoneNumber(input, defaultCountry) {
+    if (input == null || String(input).trim() === '') {
+        return { ok: false, error: 'INVALID_PHONE_NUMBER', message: 'A phone number is required.' };
+    }
+    const raw = String(input).trim();
+    const region = isSupportedCountryCode(defaultCountry)
+        ? defaultCountry
+        : DEFAULT_COUNTRY_CODE;
+    // 1. Already international.
+    if (raw.startsWith('+')) {
+        return toResult(parsePhoneNumberFromString(raw));
+    }
+    const digits = raw.replace(/[^\d]/g, '');
+    // 2. Calling code supplied without the leading '+', e.g. '254712345678'.
+    if (SUPPORTED_CALLING_CODE_DIGITS.some((code) => digits.startsWith(code))) {
+        const international = parsePhoneNumberFromString('+' + digits);
+        if (international && international.isValid()) {
+            return toResult(international);
+        }
+    }
+    // 3. National/local format — resolve using the selected/default country.
+    return toResult(parsePhoneNumberFromString(raw, region));
+}
+/** Convenience: `true` if the input can be normalized to a supported-country E.164 number. */
+export function isSupportedPhoneNumber(input, defaultCountry) {
+    return normalizeSupportedPhoneNumber(input, defaultCountry).ok;
+}
+/** Convenience: the canonical E.164 string, or `undefined` if the input cannot be normalized. */
+export function toSupportedE164(input, defaultCountry) {
+    var _a;
+    return (_a = normalizeSupportedPhoneNumber(input, defaultCountry).value) === null || _a === void 0 ? void 0 : _a.e164;
+}
+/** Resolve the supported country a (normalizable) phone number belongs to, or `undefined`. */
+export function getCountryForPhoneNumber(input, defaultCountry) {
+    var _a;
+    return (_a = normalizeSupportedPhoneNumber(input, defaultCountry).value) === null || _a === void 0 ? void 0 : _a.countryCode;
+}
+//# sourceMappingURL=phone.util.js.map

package/dist/esm/modules/phone/phone.util.js.map

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

package/dist/esm/modules/phone/validators/is-supported-phone-number.decorator.js

@@ -0,0 +1,36 @@
+import { registerDecorator } from 'class-validator';
+import { isSupportedCountryCode } from '../../country/utils/country.util';
+import { isSupportedPhoneNumber } from '../phone.util';
+/**
+ * Validates that a property is a phone number for a supported country (KE/UG/TZ).
+ *
+ * Accepts either a full E.164 number (e.g. '+254712345678') OR a national/local
+ * number (e.g. '0712345678') when a sibling `countryCode` field is present. When
+ * no `countryCode` sibling is provided, Kenya is used as the default region for
+ * backward compatibility.
+ *
+ * Pairs with an optional `countryCode?: CountryCode` field on the same DTO.
+ */
+export function IsSupportedPhoneNumber(validationOptions) {
+    return function (object, propertyName) {
+        registerDecorator({
+            name: 'isSupportedPhoneNumber',
+            target: object.constructor,
+            propertyName,
+            options: validationOptions,
+            validator: {
+                validate(value, args) {
+                    if (typeof value !== 'string') {
+                        return false;
+                    }
+                    const country = args.object['countryCode'];
+                    return isSupportedPhoneNumber(value, isSupportedCountryCode(country) ? country : undefined);
+                },
+                defaultMessage(args) {
+                    return `${args.property} must be a valid phone number for a supported country (KE, UG, TZ) — provide it in E.164 format (e.g. +254712345678), or in national format together with a countryCode.`;
+                },
+            },
+        });
+    };
+}
+//# sourceMappingURL=is-supported-phone-number.decorator.js.map

package/dist/esm/modules/phone/validators/is-supported-phone-number.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-supported-phone-number.decorator.js","sourceRoot":"","sources":["../../../../../src/modules/phone/validators/is-supported-phone-number.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA0C,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,iBAAqC;IACxE,OAAO,UAAU,MAAc,EAAE,YAAoB;QACjD,iBAAiB,CAAC;YACd,IAAI,EAAE,wBAAwB;YAC9B,MAAM,EAAE,MAAM,CAAC,WAAW;YAC1B,YAAY;YACZ,OAAO,EAAE,iBAAiB;YAC1B,SAAS,EAAE;gBACP,QAAQ,CAAC,KAAc,EAAE,IAAyB;oBAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;wBAC5B,OAAO,KAAK,CAAC;oBACjB,CAAC;oBACD,MAAM,OAAO,GAAI,IAAI,CAAC,MAAkC,CAAC,aAAa,CAAC,CAAC;oBACxE,OAAO,sBAAsB,CACzB,KAAK,EACL,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CACxD,CAAC;gBACN,CAAC;gBACD,cAAc,CAAC,IAAyB;oBACpC,OAAO,GAAG,IAAI,CAAC,QAAQ,0KAA0K,CAAC;gBACtM,CAAC;aACJ;SACJ,CAAC,CAAC;IACP,CAAC,CAAC;AACN,CAAC"}

package/dist/esm/modules/user/dtos/create-user.dto.js

@@ -7,7 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { ArrayNotEmpty, IsArray, IsBoolean, IsDate, IsEmail, IsEnum, IsNotEmpty, IsNumber, IsOptional, IsPhoneNumber, IsString, Matches, MaxLength, MinLength, ValidateNested, } from 'class-validator';
+import { ArrayNotEmpty, IsArray, IsBoolean, IsDate, IsEmail, IsEnum, IsNotEmpty, IsNumber, IsOptional, IsString, Matches, MaxLength, MinLength, ValidateNested, } from 'class-validator';
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import { SentenceCase } from '../../../decorators/case-decorators';
 import { UserStatus } from '../enums/user-status.enum';
@@ -16,6 +16,8 @@ import { Roles } from '../../role';
 import { Type } from 'class-transformer';
 import { GuardianDto } from './guardian.dto';
 import { IncidentAppId } from '../../incident';
+import { CountryCode } from '../../country/enums/country-code.enum';
+import { IsSupportedPhoneNumber } from '../../phone/validators/is-supported-phone-number.decorator';
 export class CreateUserDto {
 }
 __decorate([
@@ -56,16 +58,26 @@ __decorate([
 ], CreateUserDto.prototype, "email", void 0);
 __decorate([
     ApiPropertyOptional({
-        description: 'Phone number with country code',
-        example: '+1234567890',
+        description: 'Phone number in E.164 format (e.g. +254712345678), or national format when countryCode is provided',
+        example: '+254712345678',
         format: 'phone',
         maxLength: 20
     }),
-    IsPhoneNumber(),
+    IsSupportedPhoneNumber(),
     MaxLength(20),
     IsOptional(),
     __metadata("design:type", String)
 ], CreateUserDto.prototype, "phoneNumber", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'ISO 3166-1 alpha-2 country code for the phone number (KE, UG, TZ). Required when phoneNumber is in national format; defaults to KE.',
+        enum: CountryCode,
+        example: CountryCode.KE
+    }),
+    IsEnum(CountryCode),
+    IsOptional(),
+    __metadata("design:type", String)
+], CreateUserDto.prototype, "countryCode", void 0);
 __decorate([
     ApiProperty({
         description: 'User roles',

package/dist/esm/modules/user/dtos/create-user.dto.js.map

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

package/dist/esm/modules/user/dtos/guardian.dto.js

@@ -7,9 +7,11 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { IsBoolean, IsEmail, IsEnum, IsNotEmpty, IsNumber, IsOptional, IsPhoneNumber, IsString } from "class-validator";
+import { IsBoolean, IsEmail, IsEnum, IsNotEmpty, IsNumber, IsOptional, IsString } from "class-validator";
 import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
 import { GuardianRelationship } from "../enums/guardian-relationship.enum";
+import { CountryCode } from "../../country/enums/country-code.enum";
+import { IsSupportedPhoneNumber } from "../../phone/validators/is-supported-phone-number.decorator";
 export class GuardianDto {
 }
 __decorate([
@@ -32,14 +34,24 @@ __decorate([
 ], GuardianDto.prototype, "name", void 0);
 __decorate([
     ApiProperty({
-        description: 'Guardian phone number with country code',
-        example: '+1234567890',
+        description: 'Guardian phone number in E.164 format (e.g. +254712345678), or national format when countryCode is provided',
+        example: '+254712345678',
         format: 'phone'
     }),
-    IsPhoneNumber(),
+    IsSupportedPhoneNumber(),
     IsNotEmpty(),
     __metadata("design:type", String)
 ], GuardianDto.prototype, "phoneNumber", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'ISO 3166-1 alpha-2 country code for the guardian phone number (KE, UG, TZ). Required when phoneNumber is in national format; defaults to KE.',
+        enum: CountryCode,
+        example: CountryCode.KE
+    }),
+    IsEnum(CountryCode),
+    IsOptional(),
+    __metadata("design:type", String)
+], GuardianDto.prototype, "countryCode", void 0);
 __decorate([
     ApiPropertyOptional({
         description: 'Whether this is the primary guardian',

package/dist/esm/modules/user/dtos/guardian.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"guardian.dto.js","sourceRoot":"","sources":["../../../../../src/modules/user/dtos/guardian.dto.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACxH,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAE3E,MAAM,OAAO,WAAW;CAoDvB;AA7CG;IANC,mBAAmB,CAAC;QACjB,WAAW,EAAE,wCAAwC;QACrD,OAAO,EAAE,GAAG;KACf,CAAC;IACD,QAAQ,EAAE;IACV,UAAU,EAAE;;2CACG;AAQhB;IANC,WAAW,CAAC;QACT,WAAW,EAAE,oBAAoB;QACjC,OAAO,EAAE,YAAY;KACxB,CAAC;IACD,QAAQ,EAAE;IACV,UAAU,EAAE;;yCACC;AASd;IAPC,WAAW,CAAC;QACT,WAAW,EAAE,yCAAyC;QACtD,OAAO,EAAE,aAAa;QACtB,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,aAAa,EAAE;IACf,UAAU,EAAE;;gDACQ;AASrB;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,sCAAsC;QACnD,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,KAAK;KACjB,CAAC;IACD,SAAS,EAAE;IACX,UAAU,EAAE;;8CACO;AASpB;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,+BAA+B;QAC5C,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,oBAAoB,CAAC,MAAM;KACvC,CAAC;IACD,MAAM,CAAC,oBAAoB,CAAC;IAC5B,UAAU,EAAE;;iDACuB;AASpC;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,wBAAwB;QACrC,OAAO,EAAE,wBAAwB;QACjC,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,OAAO,EAAE;IACT,UAAU,EAAE;;0CACE"}
+{"version":3,"file":"guardian.dto.js","sourceRoot":"","sources":["../../../../../src/modules/user/dtos/guardian.dto.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACzG,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4DAA4D,CAAC;AAEpG,MAAM,OAAO,WAAW;CA6DvB;AAtDG;IANC,mBAAmB,CAAC;QACjB,WAAW,EAAE,wCAAwC;QACrD,OAAO,EAAE,GAAG;KACf,CAAC;IACD,QAAQ,EAAE;IACV,UAAU,EAAE;;2CACG;AAQhB;IANC,WAAW,CAAC;QACT,WAAW,EAAE,oBAAoB;QACjC,OAAO,EAAE,YAAY;KACxB,CAAC;IACD,QAAQ,EAAE;IACV,UAAU,EAAE;;yCACC;AASd;IAPC,WAAW,CAAC;QACT,WAAW,EAAE,6GAA6G;QAC1H,OAAO,EAAE,eAAe;QACxB,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,sBAAsB,EAAE;IACxB,UAAU,EAAE;;gDACQ;AASrB;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,8IAA8I;QAC3J,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,WAAW,CAAC,EAAE;KAC1B,CAAC;IACD,MAAM,CAAC,WAAW,CAAC;IACnB,UAAU,EAAE;;gDACa;AAS1B;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,sCAAsC;QACnD,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,KAAK;KACjB,CAAC;IACD,SAAS,EAAE;IACX,UAAU,EAAE;;8CACO;AASpB;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,+BAA+B;QAC5C,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,oBAAoB,CAAC,MAAM;KACvC,CAAC;IACD,MAAM,CAAC,oBAAoB,CAAC;IAC5B,UAAU,EAAE;;iDACuB;AASpC;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,wBAAwB;QACrC,OAAO,EAAE,wBAAwB;QACjC,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,OAAO,EAAE;IACT,UAAU,EAAE;;0CACE"}

package/dist/types/index.d.ts

@@ -17,6 +17,7 @@ export * from './modules/web-notification/index';
 export * from './modules/notification/index';
 export * from './modules/chat/index';
 export * from './modules/country/index';
+export * from './modules/phone/index';
 export * from './interfaces/server-message';
 export * from './interfaces/i-request-with-user';
 export * from './interfaces/validated-user';

package/dist/types/modules/auth/dtos/login-mobile-user.dto.d.ts

@@ -1,4 +1,6 @@
+import { CountryCode } from "../../country/enums/country-code.enum";
 export declare class LoginMobileUserDto {
     phoneNumber: string;
+    countryCode?: CountryCode;
     verificationToken: string;
 }

package/dist/types/modules/auth/dtos/register-mobile-user.dto.d.ts

@@ -1,9 +1,11 @@
 import { IncidentAppId } from "../../incident";
+import { CountryCode } from "../../country/enums/country-code.enum";
 export declare class RegisterMobileUserDto {
     appId: IncidentAppId;
     name: string;
     email: string;
     phoneNumber: string;
+    countryCode?: CountryCode;
     controlCentreId: number;
     organizationId: number;
 }

package/dist/types/modules/auth/dtos/register.dto.d.ts

@@ -2,12 +2,14 @@ import { MapAddressDto } from "../../common";
 import { Roles } from "../../role";
 import { OrganizationType } from "../../organization/enums/org-type.enum";
 import { IncidentAppId, IncidentClass } from "../../incident";
+import { CountryCode } from "../../country/enums/country-code.enum";
 export declare class RegisterDto {
     appId: IncidentAppId;
     incidentClass: IncidentClass;
     name: string;
     email: string;
     phoneNumber: string;
+    countryCode?: CountryCode;
     roles?: Roles[];
     designation: string;
     password: string;

package/dist/types/modules/auth/dtos/resend-otp.dto.d.ts

@@ -1,7 +1,9 @@
 import { OtpAction } from "../enums/otp-action";
+import { CountryCode } from "../../country/enums/country-code.enum";
 export declare class ResendOTPDto {
     action: OtpAction;
     verificationToken?: string;
     email?: string;
     phoneNumber?: string;
+    countryCode?: CountryCode;
 }

package/dist/types/modules/auth/dtos/send-otp.dto.d.ts

@@ -1,6 +1,8 @@
 import { OtpAction } from "../enums/otp-action";
+import { CountryCode } from "../../country/enums/country-code.enum";
 export declare class SendOTPDto {
     phoneNumber?: string;
+    countryCode?: CountryCode;
     email?: string;
     action: OtpAction;
 }

package/dist/types/modules/phone/index.d.ts

@@ -0,0 +1,3 @@
+export * from './interfaces/normalized-phone';
+export * from './phone.util';
+export * from './validators/is-supported-phone-number.decorator';

package/dist/types/modules/phone/interfaces/normalized-phone.d.ts

@@ -0,0 +1,22 @@
+import { CountryCode } from '../../country/enums/country-code.enum';
+/** A phone number successfully normalized to canonical E.164 for a supported country. */
+export interface NormalizedPhoneNumber {
+    /** Canonical E.164 representation, e.g. '+254712345678'. This is the value to store/query. */
+    e164: string;
+    /** ISO 3166-1 alpha-2 country the number belongs to (KE/UG/TZ). */
+    countryCode: CountryCode;
+    /** National (significant) number without the calling code, e.g. '712345678'. */
+    nationalNumber: string;
+}
+/** Machine-readable reason a phone number could not be normalized. */
+export type PhoneNormalizationErrorCode = 'INVALID_PHONE_NUMBER' | 'UNSUPPORTED_COUNTRY';
+/**
+ * Result of attempting to normalize a phone number to a supported-country E.164 value.
+ * Discriminated by `ok` — on success `value` is present, on failure `error`/`message` are.
+ */
+export interface PhoneNormalizationResult {
+    ok: boolean;
+    value?: NormalizedPhoneNumber;
+    error?: PhoneNormalizationErrorCode;
+    message?: string;
+}

package/dist/types/modules/phone/phone.util.d.ts

@@ -0,0 +1,20 @@
+import { CountryCode } from '../country/enums/country-code.enum';
+import { PhoneNormalizationResult } from './interfaces/normalized-phone';
+/**
+ * Normalize a phone number to canonical E.164 for a supported country.
+ *
+ * Resolution order for a raw (non-`+`) input:
+ *  1. already international (`+254…`) — parsed as-is;
+ *  2. calling code without `+` (`254…`/`256…`/`255…`) — treated as international;
+ *  3. national/local (`0712…`, `712…`) — parsed using `defaultCountry`
+ *     (the caller-supplied country, else Kenya for backward compatibility).
+ *
+ * @returns a discriminated result: `{ ok: true, value }` or `{ ok: false, error, message }`.
+ */
+export declare function normalizeSupportedPhoneNumber(input: string | null | undefined, defaultCountry?: CountryCode | string | null): PhoneNormalizationResult;
+/** Convenience: `true` if the input can be normalized to a supported-country E.164 number. */
+export declare function isSupportedPhoneNumber(input: string | null | undefined, defaultCountry?: CountryCode | string | null): boolean;
+/** Convenience: the canonical E.164 string, or `undefined` if the input cannot be normalized. */
+export declare function toSupportedE164(input: string | null | undefined, defaultCountry?: CountryCode | string | null): string | undefined;
+/** Resolve the supported country a (normalizable) phone number belongs to, or `undefined`. */
+export declare function getCountryForPhoneNumber(input: string | null | undefined, defaultCountry?: CountryCode | string | null): CountryCode | undefined;

package/dist/types/modules/phone/validators/is-supported-phone-number.decorator.d.ts

@@ -0,0 +1,12 @@
+import { ValidationOptions } from 'class-validator';
+/**
+ * Validates that a property is a phone number for a supported country (KE/UG/TZ).
+ *
+ * Accepts either a full E.164 number (e.g. '+254712345678') OR a national/local
+ * number (e.g. '0712345678') when a sibling `countryCode` field is present. When
+ * no `countryCode` sibling is provided, Kenya is used as the default region for
+ * backward compatibility.
+ *
+ * Pairs with an optional `countryCode?: CountryCode` field on the same DTO.
+ */
+export declare function IsSupportedPhoneNumber(validationOptions?: ValidationOptions): (object: object, propertyName: string) => void;