size analysis project - phase 2 (#3610)

* size analysis project phase 2

* point to prod version

* addressed PR comments

* addressed PR comments

* removed try catch block

* consolidate common methods

* addressed PR comments

* changed method signature

* fixed lint errors

* fixed lint errors

Author: XuechunHou

.github/workflows/health-metrics-test.yml

@@ -22,8 +22,9 @@ jobs:
       - run: cp config/ci.config.json config/project.json
       - run: yarn install
       - run: yarn build
-
       - name: Run health-metrics/binary-size test
         run: yarn size-report
+      - name: Run health-metrics/modular-exports-binary-size test
+        run: yarn modular-export-size-report
 
   # TODO(yifany): Enable startup times testing on CI.

package.json

@@ -46,7 +46,8 @@
     "docgen": "yarn docgen:js; yarn docgen:node",
     "prettier": "prettier --config .prettierrc --write '**/*.{ts,js}'",
     "lint": "lerna run --scope @firebase/* --scope rxfire lint",
-    "size-report": "node scripts/report_binary_size.js",
+    "size-report": "ts-node-script scripts/size_report/report_binary_size.ts",
+    "modular-export-size-report": "ts-node-script scripts/size_report/report_modular_export_binary_size.ts",
     "api-report": "lerna run --scope @firebase/*-exp api-report",
     "docgen:exp": "ts-node-script scripts/exp/docgen.ts",
     "postinstall": "yarn --cwd repo-scripts/changelog-generator build",

repo-scripts/size-analysis/README.md

@@ -11,7 +11,7 @@
 
 
 
-## Commands To Run The Tool 
+## Command Line Interface
 
 ### Adhoc Support 
 
@@ -26,3 +26,68 @@ $firebase-js-sdk/repo-scripts/size-analysis  `ts-node-script analysis.ts --im "@
 $firebase-js-sdk/repo-scripts/size-analysis  `ts-node-script analysis.ts  -o <path to output DIRECTORY>`
 
 
+## Use the Tool Programatically 
+### `async generateReportForModule(moduleLocation: string): Promise<Report>`
+#### This function generates size analysis report for the given module specified by the `moduleLocation` argument.
+#### `@param moduleLocation: an absolute path to location of a firebase module`
+```
+try {
+  const moduleLocation: string = "absoulte/path/to/firebase/module";
+  const report: Report = await generateReportForModule(moduleLocation);
+  console.log(report);
+
+
+}catch (error) {
+
+
+  console.log(error);
+}
+
+
+```
+
+### `async generateReportForModules(moduleLocations: string[]): Promise<Report[]>`
+#### This function recursively generates a size analysis report for every module (and its submodules) listed in moduleLocations array 
+#### `@param moduleLocations: an array of strings where each is a path to location of a firebase module`
+
+```
+try {
+  const moduleLocations: string[] = ['...module1', '...module2'];
+  const reports: Report[] = await generateReportForModules(moduleLocations);
+  console.log(reports);
+
+
+}catch (error) {
+
+
+  console.log(error);
+}
+
+
+```
+
+### `async generateReport(name: string, dtsFile: string, bundleFile: string): Promise<Report>`
+#### Use this function for adhoc analysis. This function generates a size analysis report from the given definition file. 
+#### `@param name: name to be displayed on the report`
+#### `@param: dtsFile: absolute path to a definition file of interest.`
+#### `@param bundleFile: absolute path to the bundle file of given definition file`
+
+
+```
+try {
+  const name: string = "adhoc";
+  const dtsFile: string = '.../index.d.ts';
+  const bundleFile: string = '.../index.esm2017.js';
+  const report: Report = await generateReport(name, dtsFile, bundleFile);
+  console.log(report);
+
+
+}catch (error) {
+
+
+  console.log(error);
+}
+
+
+```
+