feat(pnv): Add support for Phone Number Verification (#3101)

* feat(auth): Add support for FPNV (#3030)

* feat: add basic fpnv

* chore: resolve comments

* fix: remove unused interface

* chore: update export

* chore: linting

* chore: update export

* feat: add apidocs

* chore: resolve commnets

* chore: linting

* chore: add unit test

* chore: change test description

* chore: remove extra line

* chore: add unit test

* chore: add unit test

* chore: fix minor comments

* chore: add unit test

* chore: add unot test

* chore: update api.md

* chore: update sdk

* feat: update fpnv

* chore: update jwt spec

* chore: resolve comments

* chore: test cover Fpnv index

* chore: update test coverage

* feat: add namespace support

* fix(fpnv): validate JWT audience using project ID and improve safety checks

* rename FPNV to PhoneNumberVerification and replace getPhoneNumber() with property

* remove namspaces and ensure naming consistency

* fix api extractor

* fix tests

* address PR feedback

* PR comments

PR comments

---------

Co-authored-by: boikoa-gl <boikoa@google.com>

Author: lahirumaramba

entrypoints.json

@@ -16,6 +16,10 @@
     "typings": "./lib/auth/index.d.ts",
     "dist": "./lib/auth/index.js"
   },
+  "firebase-admin/phone-number-verification": {
+    "typings": "./lib/phone-number-verification/index.d.ts",
+    "dist": "./lib/phone-number-verification/index.js"
+  },
   "firebase-admin/database": {
     "typings": "./lib/database/index.d.ts",
     "dist": "./lib/database/index.js"

etc/firebase-admin.phone-number-verification.api.md

@@ -0,0 +1,33 @@
+## API Report File for "firebase-admin.phone-number-verification"
+
+> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
+
+```ts
+
+import { Agent } from 'http';
+
+// Warning: (ae-forgotten-export) The symbol "App" needs to be exported by the entry point index.d.ts
+//
+// @public
+export function getPhoneNumberVerification(app?: App): PhoneNumberVerification;
+
+// @public
+export class PhoneNumberVerification {
+    get app(): App;
+    verifyToken(jwt: string): Promise<PhoneNumberVerificationToken>;
+}
+
+// @public
+export interface PhoneNumberVerificationToken {
+    [key: string]: any;
+    aud: string[];
+    exp: number;
+    iat: number;
+    iss: string;
+    jti: string;
+    nonce: string;
+    phoneNumber: string;
+    sub: string;
+}
+
+```