rename FPNV to PhoneNumberVerification and replace getPhoneNumber() with property

Author: lahirumaramba

entrypoints.json

@@ -16,9 +16,9 @@
     "typings": "./lib/auth/index.d.ts",
     "dist": "./lib/auth/index.js"
   },
-  "firebase-admin/fpnv": {
-    "typings": "./lib/fpnv/index.d.ts",
-    "dist": "./lib/fpnv/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",

package-lock.json

@@ -73,8 +73,8 @@
       "auth": [
         "lib/auth"
       ],
-      "fpnv": [
-        "lib/fpnv"
+      "phone-number-verification": [
+        "lib/phone-number-verification"
       ],
       "eventarc": [
         "lib/eventarc"
@@ -137,10 +137,10 @@
       "require": "./lib/auth/index.js",
       "import": "./lib/esm/auth/index.js"
     },
-    "./fpnv": {
-      "types": "./lib/fpnv/index.d.ts",
-      "require": "./lib/fpnv/index.js",
-      "import": "./lib/esm/fpnv/index.js"
+    "./phone-number-verification": {
+      "types": "./lib/phone-number-verification/index.d.ts",
+      "require": "./lib/phone-number-verification/index.js",
+      "import": "./lib/esm/phone-number-verification/index.js"
     },
     "./database": {
       "types": "./lib/database/index.d.ts",

package.json

@@ -19,7 +19,7 @@ import { App as AppCore } from './core';
 import { AppStore, defaultAppStore } from './lifecycle';
 import {
   app, appCheck, auth, messaging, machineLearning, storage, firestore, database,
-  instanceId, installations, projectManagement, securityRules , remoteConfig, fpnv, AppOptions,
+  instanceId, installations, projectManagement, securityRules , remoteConfig, phoneNumberVerification, AppOptions,
 } from '../firebase-namespace-api';
 import { cert, refreshToken, applicationDefault } from './credential-factory';
 import { getSdkVersion } from '../utils/index';
@@ -37,7 +37,7 @@ import ProjectManagement = projectManagement.ProjectManagement;
 import RemoteConfig = remoteConfig.RemoteConfig;
 import SecurityRules = securityRules.SecurityRules;
 import Storage = storage.Storage;
-import Fpnv = fpnv.Fpnv;
+import PhoneNumberVerification = phoneNumberVerification.PhoneNumberVerification;
 
 export interface FirebaseServiceNamespace <T> {
   (app?: App): T;
@@ -281,17 +281,19 @@ export class FirebaseNamespace {
   }
 
   /**
-   * Gets the `Fpnv` service namespace. The returned namespace can be used to get the
-   * `Fpnv` service for the default app or an explicitly specified app.
+   * Gets the `PhoneNumberVerification` service namespace. The returned namespace can be used to get the
+   * `PhoneNumberVerification` service for the default app or an explicitly specified app.
    */
-  get fpnv(): FirebaseServiceNamespace<Fpnv> {
-    const fn: FirebaseServiceNamespace<Fpnv> = (app?: App) => {
-      return this.ensureApp(app).fpnv();
+  get phoneNumberVerification(): FirebaseServiceNamespace<PhoneNumberVerification> {
+    const fn: FirebaseServiceNamespace<PhoneNumberVerification> = (app?: App) => {
+      return this.ensureApp(app).phoneNumberVerification();
     };
-    const fpnv = require('../fpnv/fpnv').Fpnv;
-    return Object.assign(fn, { Fpnv: fpnv });
+    const phoneNumberVerification = require(
+      '../phone-number-verification/phone-number-verification').PhoneNumberVerification;
+    return Object.assign(fn, { PhoneNumberVerification: phoneNumberVerification });
   }
 
+
   // TODO: Change the return types to app.App in the following methods.
 
   /**
@@ -410,11 +412,12 @@ function extendApp(app: AppCore): App {
     return fn(app);
   };
 
-  result.fpnv = () => {
-    const fn = require('../fpnv/index').getFirebasePnv;
+  result.phoneNumberVerification = () => {
+    const fn = require('../phone-number-verification/index').getPhoneNumberVerification;
     return fn(app);
   };
 
+
   (result as any).__extended = true;
   return result;
 }

src/app/firebase-namespace.ts

@@ -26,7 +26,7 @@ import { projectManagement } from './project-management/project-management-names
 import { remoteConfig } from './remote-config/remote-config-namespace';
 import { securityRules } from './security-rules/security-rules-namespace';
 import { storage } from './storage/storage-namespace';
-import { fpnv } from './fpnv/fpnv-namespace';
+import { phoneNumberVerification } from './phone-number-verification/phone-number-verification-namespace';
 
 import { App as AppCore, AppOptions } from './app/index';
 
@@ -57,7 +57,7 @@ export namespace app {
     remoteConfig(): remoteConfig.RemoteConfig;
     securityRules(): securityRules.SecurityRules;
     storage(): storage.Storage;
-    fpnv(): fpnv.Fpnv;
+    phoneNumberVerification(): phoneNumberVerification.PhoneNumberVerification;
 
     /**
      * Renders this local `FirebaseApp` unusable and frees the resources of
@@ -93,7 +93,7 @@ export { projectManagement } from './project-management/project-management-names
 export { remoteConfig } from './remote-config/remote-config-namespace';
 export { securityRules } from './security-rules/security-rules-namespace';
 export { storage } from './storage/storage-namespace';
-export { fpnv } from './fpnv/fpnv-namespace';
+export { phoneNumberVerification } from './phone-number-verification/phone-number-verification-namespace';
 
 // Declare other top-level members of the admin namespace below. Unfortunately, there's no
 // compile-time mechanism to ensure that the FirebaseNamespace class actually provides these

src/firebase-namespace-api.ts

@@ -0,0 +1,66 @@
+/**
+ * Firebase Phone Number Verification.
+ *
+ * @packageDocumentation
+ */
+
+/*!
+ * @license
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { App, getApp } from '../app';
+import { FirebaseApp } from '../app/firebase-app';
+import { PhoneNumberVerification } from './phone-number-verification';
+
+export {
+  PhoneNumberVerification
+} from './phone-number-verification';
+
+export {
+  PhoneNumberVerificationToken,
+} from './phone-number-verification-api'
+
+/**
+ * Gets the {@link PhoneNumberVerification} service for the default app or a
+ * given app.
+ *
+ * `getPhoneNumberVerification()` can be called with no arguments to access the default app's
+ * {@link PhoneNumberVerification} service or as `getPhoneNumberVerification(app)` to access the
+ * {@link PhoneNumberVerification} service associated with a specific app.
+ *
+ * @example
+ * ```javascript
+ * // Get the PhoneNumberVerification service for the default app
+ * const defaultPnv = getPhoneNumberVerification();
+ * ```
+ *
+ * @example
+ * ```javascript
+ * // Get the PhoneNumberVerification service for a given app
+ * const otherPnv = getPhoneNumberVerification(otherApp);
+ * ```
+ *
+ * @returns The {@link PhoneNumberVerification} service associated with the provided app.
+ *
+ */
+export function getPhoneNumberVerification(app?: App): PhoneNumberVerification {
+  if (typeof app === 'undefined') {
+    app = getApp();
+  }
+
+  const firebaseApp: FirebaseApp = app as FirebaseApp;
+  return firebaseApp.getOrInitService('phone-number-verification', (app) => new PhoneNumberVerification(app));
+}

src/fpnv/fpnv-namespace.ts

@@ -44,9 +44,9 @@ export const FPNV_ERROR_CODE_MAPPING = {
   INVALID_ARGUMENT: 'invalid-argument',
   INVALID_TOKEN: 'invalid-token',
   EXPIRED_TOKEN: 'expired-token',
-} satisfies Record<string, FpnvErrorCode>;
+} satisfies Record<string, PhoneNumberVerificationErrorCode>;
 
-export type FpnvErrorCode =
+export type PhoneNumberVerificationErrorCode =
   | 'invalid-argument'
   | 'invalid-token'
   | 'expired-token'
@@ -58,14 +58,15 @@ export type FpnvErrorCode =
  * @param message - The error message.
  * @constructor
  */
-export class FirebaseFpnvError extends PrefixedFirebaseError {
-  constructor(code: FpnvErrorCode, message: string) {
-    super('fpnv', code, message);
+export class FirebasePhoneNumberVerificationError extends PrefixedFirebaseError {
+  constructor(code: PhoneNumberVerificationErrorCode, message: string) {
+    super('phone-number-verification', code, message);
 
     /* tslint:disable:max-line-length */
     // Set the prototype explicitly. See the following link for more details:
     // https://github.com/Microsoft/TypeScript/wiki/Breaking-Changes#extending-built-ins-like-error-array-and-map-may-no-longer-work
     /* tslint:enable:max-line-length */
-    (this as any).__proto__ = FirebaseFpnvError.prototype;
+    (this as any).__proto__ = FirebasePhoneNumberVerificationError.prototype;
   }
 }
+