Add ref doc generation to telemetry package

Author: tonybaroneee

common/api-review/telemetry.api.md

@@ -0,0 +1,16 @@
+## API Report File for "@firebase/telemetry"
+
+> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
+
+```ts
+
+// @public
+export function testFxn(): number;
+
+// @public (undocumented)
+export function tonyFn(): void;
+
+
+// (No @packageDocumentation comment for this package)
+
+```

docs-devsite/_toc.yaml

@@ -648,3 +648,6 @@ toc:
     path: /docs/reference/js/storage.uploadtask.md
   - title: UploadTaskSnapshot
     path: /docs/reference/js/storage.uploadtasksnapshot.md
+- title: telemetry
+  path: /docs/reference/js/telemetry.md
+  section: []

docs-devsite/index.md

@@ -28,4 +28,5 @@ https://github.com/firebase/firebase-js-sdk
 |  [@firebase/performance](./performance.md#performance_package) | The Firebase Performance Monitoring Web SDK. This SDK does not work in a Node.js environment. |
 |  [@firebase/remote-config](./remote-config.md#remote-config_package) | The Firebase Remote Config Web SDK. This SDK does not work in a Node.js environment. |
 |  [@firebase/storage](./storage.md#storage_package) | Cloud Storage for Firebase |
+|  [@firebase/telemetry](./telemetry.md#telemetry_package) |  |
 

docs-devsite/telemetry.md

@@ -0,0 +1,52 @@
+Project: /docs/reference/js/_project.yaml
+Book: /docs/reference/_book.yaml
+page_type: reference
+
+{% comment %}
+DO NOT EDIT THIS FILE!
+This is generated by the JS SDK team, and any local changes will be
+overwritten. Changes should be made in the source code at
+https://github.com/firebase/firebase-js-sdk
+{% endcomment %}
+
+# telemetry package
+
+## Functions
+
+|  Function | Description |
+|  --- | --- |
+|  [testFxn()](./telemetry.md#testfxn) |  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. |
+|  [tonyFn()](./telemetry.md#tonyfn) |  |
+
+## function()
+
+### testFxn() {:#testfxn}
+
+ 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.
+
+<b>Signature:</b>
+
+```typescript
+export declare function testFxn(): number;
+```
+<b>Returns:</b>
+
+number
+
+### tonyFn() {:#tonyfn}
+
+<b>Signature:</b>
+
+```typescript
+export declare function tonyFn(): void;
+```
+<b>Returns:</b>
+
+void
+

packages/telemetry/api-extractor.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../config/api-extractor.json",
+  // Point it to your entry point d.ts file.
+  "mainEntryPointFilePath": "<projectFolder>/dist/src/index.d.ts",
+  "dtsRollup": {
+    "enabled": true,
+    "untrimmedFilePath": "<projectFolder>/dist/<unscopedPackageName>.d.ts",
+    "betaTrimmedFilePath": "<projectFolder>/dist/<unscopedPackageName>-public.d.ts"
+  }
+}

packages/telemetry/package.json

@@ -35,7 +35,9 @@
     "test:all": "run-p --npm-path npm test:browser test:node",
     "test:browser": "karma start",
     "test:node": "TS_NODE_COMPILER_OPTIONS='{\"module\":\"commonjs\"}' nyc --reporter lcovonly -- mocha src/**/*.test.* --config ../../config/mocharc.node.js",
-    "trusted-type-check": "tsec -p tsconfig.json --noEmit"
+    "api-report": "api-extractor run --local --verbose",
+    "trusted-type-check": "tsec -p tsconfig.json --noEmit",
+    "typings:public": "node ../../scripts/build/use_typings.js ./dist/telemetry-public.d.ts"
   },
   "peerDependencies": {
     "@firebase/app": "0.x",
@@ -62,7 +64,7 @@
   "bugs": {
     "url": "https://github.com/firebase/firebase-js-sdk/issues"
   },
-  "typings": "dist/index.d.ts",
+  "typings": "./dist/telemetry-public.d.ts",
   "nyc": {
     "extension": [
       ".ts"

scripts/docgen/docgen.ts

@@ -60,7 +60,8 @@ const PREFERRED_PARAMS = [
   'performance',
   'remoteConfig',
   'storage',
-  'ai'
+  'ai',
+  'telemetry'
 ];
 
 let authApiReportOriginal: string;