refactor!: remove deprecated namespace APIs

.agents/skills/ts-js-validation/SKILL.md

@@ -48,18 +48,20 @@ Set one clear default path so the agent does not choose randomly between options
 
 ## Command sequence
 
-Run these root `package.json` scripts in order. **Canonical checklist with pipeline/e2e context:** `okf-bundle/testing/validation-checklist.md` (OKF bundle wins if this skill disagrees).
+Run these root `package.json` scripts in order. **Canonical checklist:** [validation-checklist.md](../../../okf-bundle/testing/validation-checklist.md). **Agent allowlist (no improvisation):** [agent-command-policy.md](../../../okf-bundle/testing/agent-command-policy.md). OKF bundle wins if this skill disagrees.
 
 1. `yarn lerna:prepare`
 2. `yarn tsc:compile`
 3. `yarn tsc:compile:consumer`
 4. `yarn reference:api`
-5. `yarn tests:jest`
-6. `yarn format:js`
-7. `yarn compare:types`
+5. `yarn lint:js` (use `yarn lint:js --fix` then re-run until clean)
+6. `yarn tests:jest`
+7. `yarn format:js`
+8. `yarn compare:types`
 
 ## Gotchas
 
+- **Forbidden:** `yarn workspace … prepare`, `cd packages/<pkg> && yarn prepare/build`, `yarn jet`, `npx jet` — see [agent command policy](../../../okf-bundle/testing/agent-command-policy.md). On failure, fix product code and re-run the **same** canonical command.
 - `yarn format:js` writes changes across `packages/**/*.{js,ts,tsx}`. Check the diff after formatting and do not revert user changes.
 - Run commands from the repository root so workspace resolution, root `tsconfig.json`, and Jest configuration are consistent.
 - `yarn lerna:prepare` may rebuild or refresh package artifacts needed before TypeScript or tests run.
@@ -106,6 +108,7 @@ Use this template:
 - `yarn tsc:compile`: passed | failed | not run
 - `yarn tsc:compile:consumer`: passed | failed | not run
 - `yarn reference:api`: passed | failed | not run
+- `yarn lint:js`: passed | failed | not run
 - `yarn tests:jest`: passed | failed | not run
 - `yarn format:js`: passed | failed | changed files
 - `yarn compare:types`: passed | failed | not run

.github/scripts/compare-types/configs/app-check.ts

@@ -39,6 +39,11 @@ const config: PackageConfig = {
     },
   ],
   extraInRN: [
+    {
+      name: 'SDK_VERSION',
+      reason:
+        'RN Firebase package version string exported from the modular entry point. The firebase-js-sdk does not export SDK_VERSION from @firebase/app-check.',
+    },
     {
       name: 'AppCheckProvider',
       reason:

.github/scripts/compare-types/configs/auth.ts

@@ -161,6 +161,31 @@ const config: PackageConfig = {
       reason:
         'RN Firebase extension type: firebase-js-sdk AdditionalUserInfo core fields plus index signature for extra native bridge keys. Use when typing values from getAdditionalUserInfo or UserCredential.additionalUserInfo that may include provider-specific native fields.',
     },
+    {
+      name: 'SDK_VERSION',
+      reason:
+        'RN Firebase package version string exported from the modular entry point. The firebase-js-sdk does not export SDK_VERSION from @firebase/auth.',
+    },
+    {
+      name: 'AuthListenerCallback',
+      reason:
+        'RN Firebase exported auth state listener callback type. firebase-js-sdk uses inline callback types on onAuthStateChanged / onIdTokenChanged rather than exporting this alias.',
+    },
+    {
+      name: 'CallbackOrObserver',
+      reason:
+        'RN Firebase exported union type for auth listener callbacks and observers. firebase-js-sdk uses inline overloads rather than exporting this helper type.',
+    },
+    {
+      name: 'UpdateProfile',
+      reason:
+        'RN Firebase exported profile update options type for updateProfile(). firebase-js-sdk declares the shape inline on updateProfile rather than exporting this alias.',
+    },
+    {
+      name: 'MultiFactor',
+      reason:
+        'RN Firebase exported MultiFactor interface type. firebase-js-sdk exposes multi-factor enrollment through the multiFactor() helper without exporting this interface at the package root.',
+    },
   ],
 
   differentShape: [
@@ -219,6 +244,11 @@ const config: PackageConfig = {
       reason:
         'iOS/Android: generateQrCodeUrl is Promise<string> via native bridge; openInOtpApp is an RN-only helper. Other/All: js-sdk synchronous generateQrCodeUrl is possible when MFA is supported on Other.',
     },
+    {
+      name: 'User',
+      reason:
+        'RN Firebase User optionally exposes multiFactor for native MFA bridge convenience. firebase-js-sdk keeps multi-factor access on the multiFactor(user) helper only.',
+    },
   ],
 };
 

.github/scripts/compare-types/configs/database.ts

@@ -4,6 +4,11 @@ const config: PackageConfig = {
   nameMapping: {},
   missingInRN: [],
   extraInRN: [
+    {
+      name: 'SDK_VERSION',
+      reason:
+        'RN Firebase package version string exported from the modular entry point. The firebase-js-sdk does not export SDK_VERSION from @firebase/database.',
+    },
     {
       name: 'setPersistenceEnabled',
       reason:
@@ -39,23 +44,7 @@ const config: PackageConfig = {
         'a standalone `keepSynced()` function.',
     },
   ],
-  differentShape: [
-    {
-      name: 'Database',
-      reason:
-        'RN Firebase narrows the public `type` member to the concrete `database` literal, while the firebase-js-sdk declaration leaves it less specific.',
-    },
-    {
-      name: 'DataSnapshot',
-      reason:
-        'RN Firebase exposes native snapshot metadata helpers such as `key`, `priority`, and `size` on the public snapshot type.',
-    },
-    {
-      name: 'OnDisconnect',
-      reason:
-        'The public method signatures are equivalent, but the generated declaration text differs in union ordering for the priority parameter.',
-    },
-  ],
+  differentShape: [],
 };
 
 export default config;

.github/scripts/compare-types/configs/firestore.ts

@@ -222,6 +222,11 @@ const config: PackageConfig = {
   // Extra in RN Firebase
   // ---------------------------------------------------------------------------
   extraInRN: [
+    {
+      name: 'SDK_VERSION',
+      reason:
+        'RN Firebase package version string exported from the modular entry point. The firebase-js-sdk does not export SDK_VERSION from @firebase/firestore.',
+    },
     {
       name: 'FirebaseApp',
       reason:

.github/scripts/compare-types/configs/installations.ts

@@ -12,7 +12,13 @@ import type { PackageConfig } from '../src/types';
 const config: PackageConfig = {
   nameMapping: {},
   missingInRN: [],
-  extraInRN: [],
+  extraInRN: [
+    {
+      name: 'SDK_VERSION',
+      reason:
+        'RN Firebase package version string exported from the modular entry point. The firebase-js-sdk does not export SDK_VERSION from @firebase/installations.',
+    },
+  ],
   differentShape: [],
 };
 

.github/scripts/compare-types/configs/perf-config.ts

@@ -8,6 +8,11 @@ import type { PackageConfig } from '../../src/types';
 const config: PackageConfig = {
   missingInRN: [],
   extraInRN: [
+    {
+      name: 'SDK_VERSION',
+      reason:
+        'RN Firebase package version string exported from the modular entry point. The firebase-js-sdk does not export SDK_VERSION from @firebase/performance.',
+    },
     {
       name: 'HttpMethod',
       reason:

.github/scripts/compare-types/configs/remote-config.ts

@@ -66,6 +66,19 @@ const config: PackageConfig = {
         'platform resource file (iOS .plist / Android XML). No equivalent ' +
         'exists in the firebase-js-sdk web API.',
     },
+    {
+      name: 'LastFetchStatus',
+      reason:
+        'RN Firebase exports fetch-status string literals as a named const object ' +
+        '(`SUCCESS`, `FAILURE`, etc.) for modular callers. The firebase-js-sdk does ' +
+        'not export this helper; web callers compare against string literals directly.',
+    },
+    {
+      name: 'SDK_VERSION',
+      reason:
+        'RN Firebase package version string exported from the modular entry point. ' +
+        'The firebase-js-sdk does not export `SDK_VERSION` from `@firebase/remote-config`.',
+    },
   ],
   differentShape: [
     {
@@ -89,6 +102,13 @@ const config: PackageConfig = {
         'RN Firebase only accepts the optional app instance and does not expose the ' +
         'initialization-options surface.',
     },
+    {
+      name: 'ValueSource',
+      reason:
+        'RN Firebase exports value-source string literals as a named const object ' +
+        '(`REMOTE`, `DEFAULT`, `STATIC`). The firebase-js-sdk exposes `ValueSource` as ' +
+        'a string-literal type alias instead of a runtime constants object.',
+    },
   ],
 };
 

.github/scripts/compare-types/configs/storage.ts

@@ -44,6 +44,11 @@ const config: PackageConfig = {
   // Extra in RN Firebase
   // ---------------------------------------------------------------------------
   extraInRN: [
+    {
+      name: 'SDK_VERSION',
+      reason:
+        'RN Firebase package version string exported from the modular entry point. The firebase-js-sdk does not export SDK_VERSION from @firebase/storage.',
+    },
     {
       name: 'setMaxOperationRetryTime',
       reason:

.github/scripts/compare-types/src/registry.ts

@@ -107,14 +107,11 @@ export const packages: PackageEntry[] = [
     name: 'auth',
     firebaseSdkTypesPaths: [requiredFirebaseTypes('auth')],
     rnFirebaseModularFiles: [
+      path.join(rnDist('auth'), 'index.d.ts'),
       path.join(rnDist('auth'), 'types', 'auth.d.ts'),
-      path.join(rnDist('auth'), 'modular.d.ts'),
     ],
     rnFirebaseSupportFiles: [
-      path.join(rnDist('auth'), 'index.d.ts'),
       path.join(rnDist('auth'), 'constants.d.ts'),
-      path.join(rnDist('auth'), 'namespaced.d.ts'),
-      path.join(rnDist('auth'), 'types', 'namespaced.d.ts'),
       path.join(rnDist('auth'), 'types', 'internal.d.ts'),
       path.join(rnDist('auth'), 'ConfirmationResult.d.ts'),
       path.join(rnDist('auth'), 'MultiFactorResolver.d.ts'),
@@ -142,12 +139,11 @@ export const packages: PackageEntry[] = [
     name: 'storage',
     firebaseSdkTypesPaths: [requiredFirebaseTypes('storage')],
     rnFirebaseModularFiles: [
+      path.join(rnDist('storage'), 'index.d.ts'),
       path.join(rnDist('storage'), 'types', 'storage.d.ts'),
-      path.join(rnDist('storage'), 'modular.d.ts'),
     ],
     rnFirebaseSupportFiles: [
       path.join(rnDist('storage'), 'StorageStatics.d.ts'),
-      path.join(rnDist('storage'), 'types', 'namespaced.d.ts'),
       path.join(rnDist('storage'), 'types', 'internal.d.ts'),
     ],
     config: storageConfig,
@@ -156,12 +152,12 @@ export const packages: PackageEntry[] = [
     name: 'remote-config',
     firebaseSdkTypesPaths: [requiredFirebaseTypes('remote-config')],
     rnFirebaseModularFiles: [
+      path.join(rnDist('remote-config'), 'index.d.ts'),
       path.join(rnDist('remote-config'), 'types', 'remote-config.d.ts'),
-      path.join(rnDist('remote-config'), 'modular.d.ts'),
     ],
     rnFirebaseSupportFiles: [
       path.join(rnDist('remote-config'), 'statics.d.ts'),
-      path.join(rnDist('remote-config'), 'types', 'namespaced.d.ts'),
+      path.join(rnDist('remote-config'), 'types', 'internal.d.ts'),
     ],
     config: remoteConfigConfig,
   },
@@ -203,13 +199,12 @@ export const packages: PackageEntry[] = [
     name: 'database',
     firebaseSdkTypesPaths: [requiredFirebaseTypes('database')],
     rnFirebaseModularFiles: [
+      path.join(rnDist('database'), 'index.d.ts'),
       path.join(rnDist('database'), 'types', 'database.d.ts'),
-      path.join(rnDist('database'), 'modular.d.ts'),
       path.join(rnDist('database'), 'modular', 'query.d.ts'),
       path.join(rnDist('database'), 'modular', 'transaction.d.ts'),
     ],
     rnFirebaseSupportFiles: [
-      path.join(rnDist('database'), 'types', 'namespaced.d.ts'),
       path.join(rnDist('database'), 'types', 'internal.d.ts'),
       path.join(rnDist('database'), 'DatabaseDataSnapshot.d.ts'),
       path.join(rnDist('database'), 'DatabaseOnDisconnect.d.ts'),
@@ -224,8 +219,8 @@ export const packages: PackageEntry[] = [
     name: 'app-check',
     firebaseSdkTypesPaths: [requiredFirebaseTypes('app-check')],
     rnFirebaseModularFiles: [
+      path.join(rnDist('app-check'), 'index.d.ts'),
       path.join(rnDist('app-check'), 'types', 'appcheck.d.ts'),
-      path.join(rnDist('app-check'), 'modular.d.ts'),
     ],
     rnFirebaseSupportFiles: [
       path.join(rnDist('app-check'), 'providers.d.ts'),
@@ -239,8 +234,8 @@ export const packages: PackageEntry[] = [
       requiredFirebaseTypes('installations'),
     ],
     rnFirebaseModularFiles: [
+      path.join(rnDist('installations'), 'index.d.ts'),
       path.join(rnDist('installations'), 'types', 'installations.d.ts'),
-      path.join(rnDist('installations'), 'modular.d.ts'),
     ],
     rnFirebaseSupportFiles: [path.join(rnDist('installations'), 'types', 'internal.d.ts')],
     config: installationsConfig,
@@ -250,19 +245,16 @@ export const packages: PackageEntry[] = [
     firebaseSdkTypesPaths: [requiredFirebaseTypes('firestore')],
     rnFirebaseModularFiles: [
       path.join(rnDist('firestore'), 'types', 'firestore.d.ts'),
-      path.join(rnDist('firestore'), 'modular.d.ts'),
+      path.join(rnDist('firestore'), 'index.d.ts'),
       path.join(rnDist('firestore'), 'modular', 'query.d.ts'),
       path.join(rnDist('firestore'), 'modular', 'snapshot.d.ts'),
       path.join(rnDist('firestore'), 'modular', 'Bytes.d.ts'),
       path.join(rnDist('firestore'), 'modular', 'FieldPath.d.ts'),
       path.join(rnDist('firestore'), 'modular', 'FieldValue.d.ts'),
-      path.join(rnDist('firestore'), 'modular', 'GeoPoint.d.ts'),
-      path.join(rnDist('firestore'), 'modular', 'Timestamp.d.ts'),
       path.join(rnDist('firestore'), 'modular', 'VectorValue.d.ts'),
     ],
     rnFirebaseSupportFiles: [
-      path.join(rnDist('firestore'), 'types', 'namespaced.d.ts'),
-      path.join(rnDist('firestore'), 'types', 'internal.d.ts'),
+            path.join(rnDist('firestore'), 'types', 'internal.d.ts'),
       path.join(rnDist('firestore'), 'FirestoreAggregate.d.ts'),
       path.join(rnDist('firestore'), 'FirestoreFilter.d.ts'),
       path.join(rnDist('firestore'), 'FirestoreBlob.d.ts'),
@@ -300,8 +292,8 @@ export const packages: PackageEntry[] = [
     name: 'perf',
     firebaseSdkTypesPaths: [requiredFirebaseTypes('performance')],
     rnFirebaseModularFiles: [
+      path.join(rnDist('perf'), 'index.d.ts'),
       path.join(rnDist('perf'), 'types', 'perf.d.ts'),
-      path.join(rnDist('perf'), 'modular.d.ts'),
     ],
     rnFirebaseSupportFiles: [],
     config: perfConfig,

.spellcheck.dict.txt

@@ -8,6 +8,7 @@ Analytics
 ANR
 APIs
 APIs.
+accessors
 APNs
 AppAttest
 AppCheck
@@ -221,6 +222,7 @@ src
 SSV
 stacktrace
 substring
+subpath
 switchOn
 SVG
 TestLab
@@ -258,6 +260,7 @@ v22
 v23
 v24
 v25
+v26
 Ventura
 VertexAI
 VPN

AGENTS.md

@@ -9,12 +9,14 @@
 ## Working
 
 - Run from repo root; install once with `yarn`.
+- **Agent shell commands:** [agent-command-policy.md](okf-bundle/testing/agent-command-policy.md) only (allowlist). E2e additionally [running-e2e.md § agent rule](okf-bundle/testing/running-e2e.md#agent-rule-read-first).
 - Follow local package patterns; check `type-test.ts`, `__tests__/`, and plugin dirs before public API/platform changes.
 - Start with `okf-bundle/index.md` for repo-specific implementation/testing/maintenance knowledge.
+- **Change authoring:** [change-authoring-workflow.md](okf-bundle/testing/change-authoring-workflow.md) — baseline → unit-focused implementation → area-focused review → commit.
 - Use package indexes under `okf-bundle/packages/` for package-specific workflows and active work queues.
 - Follow `okf-bundle/documentation-policy.md`: durable knowledge in reference docs; ephemeral state only in explicit work queues; commits are documentation; single-commit PR titles must match the commit subject exactly.
 - Testing entry points: `okf-bundle/testing/index.md`; validation requirements: `okf-bundle/testing/validation-checklist.md`.
-- Match validation to the **work type** and **validation tier** in OKF ([iteration vocabulary](okf-bundle/testing/iteration-vocabulary.md), package workflows, active work queue gates).
+- Match validation to the **work type** and **validation tier** in OKF ([change authoring workflow](okf-bundle/testing/change-authoring-workflow.md); term ids in [iteration vocabulary](okf-bundle/testing/iteration-vocabulary.md)).
 
 ## PR instructions
 

docs.json

@@ -44,6 +44,7 @@
         { "title": "Migration Guide to v23", "href": "/migrating-to-v23" },
         { "title": "Migration Guide to v24", "href": "/migrating-to-v24" },
         { "title": "Migration Guide to v25", "href": "/migrating-to-v25" },
+        { "title": "Migration Guide to v26", "href": "/migrating-to-v26" },
         { "title": "TypeScript", "href": "/typescript" },
         { "title": "Platforms", "href": "/platforms" },
         { "title": "FAQs and Tips", "href": "/faqs-and-tips" },

docs/migrating-to-v25.mdx

@@ -2,7 +2,7 @@
 title: Migrating to v25
 description: Migrate to React Native Firebase v25.
 previous: /migrating-to-v24
-next: /typescript
+next: /migrating-to-v26
 ---
 
 Version 25 completes the TypeScript alignment started in v24. Modular types across multiple packages now match the [firebase-js-sdk](https://firebase.google.com/docs/web/modular-upgrade) modular API as closely as possible. Runtime behavior is largely unchanged; **TypeScript consumers** and apps using the **modular API** are most affected.