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 (undocumented)
+export function registerTelemetry(): void;
+
+// @public (undocumented)
+export function testFxn(): number;
+
+
+// (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,44 @@
+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 |
+|  --- | --- |
+|  [registerTelemetry()](./telemetry.md#registertelemetry) |  |
+|  [testFxn()](./telemetry.md#testfxn) |  |
+
+## function()
+
+### registerTelemetry() {:#registertelemetry}
+
+<b>Signature:</b>
+
+```typescript
+export declare function registerTelemetry(): void;
+```
+<b>Returns:</b>
+
+void
+
+### testFxn() {:#testfxn}
+
+<b>Signature:</b>
+
+```typescript
+export declare function testFxn(): number;
+```
+<b>Returns:</b>
+
+number
+

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"
+    "trusted-type-check": "tsec -p tsconfig.json --noEmit",
+    "api-report": "api-extractor run --local --verbose && ts-node-script ../../repo-scripts/prune-dts/prune-dts.ts --input dist/telemetry-public.d.ts --output dist/telemetry-public.d.ts",
+    "typings:public": "node ../../scripts/build/use_typings.js ./dist/telemetry-public.d.ts"
   },
   "peerDependencies": {
     "@firebase/app": "0.x",
@@ -67,7 +69,7 @@
   "bugs": {
     "url": "https://github.com/firebase/firebase-js-sdk/issues"
   },
-  "typings": "dist/index.d.ts",
+  "typings": "dist/src/index.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;