Allow auth to use a separate d.ts file for docgen

Author: hsubox76

packages/auth/api-extractor.json

@@ -1,7 +1,8 @@
 {
     "extends": "../../config/api-extractor.json",
-    // Point it to your entry point d.ts file. 
-    "mainEntryPointFilePath": "<projectFolder>/dist/esm5/index.doc.d.ts",
+    // If this path ever changes, make sure to change scripts/exp/docgen.ts
+    // accordingly.
+    "mainEntryPointFilePath": "<projectFolder>/dist/esm5/index.d.ts",
     "dtsRollup": {
         "enabled": true,
         "untrimmedFilePath": "<projectFolder>/dist/<unscopedPackageName>.d.ts",

scripts/exp/docgen.ts

@@ -38,6 +38,20 @@ async function generateDocs(forDevsite: boolean = false) {
   const outputFolder = forDevsite ? 'docs-devsite' : 'docs-exp';
   const command = forDevsite ? 'api-documenter-devsite' : 'api-documenter';
 
+  // Use a special d.ts file for auth for doc gen only.
+  const authApiConfigOriginal = fs.readFileSync(
+    `${projectRoot}/packages/auth/api-extractor.json`,
+    'utf8'
+  );
+  const authApiConfigModified = authApiConfigOriginal.replace(
+    `"mainEntryPointFilePath": "<projectFolder>/dist/esm5/index.d.ts"`,
+    `"mainEntryPointFilePath": "<projectFolder>/dist/esm5/index.doc.d.ts"`
+  );
+  fs.writeFileSync(
+    `${projectRoot}/packages/auth/api-extractor.json`,
+    authApiConfigModified
+  );
+
   await spawn('yarn', ['build'], {
     stdio: 'inherit'
   });
@@ -46,15 +60,19 @@ async function generateDocs(forDevsite: boolean = false) {
     stdio: 'inherit'
   });
 
+  // Restore original auth api-extractor.json contents.
+  fs.writeFileSync(
+    `${projectRoot}/packages/auth/api-extractor.json`,
+    authApiConfigOriginal
+  );
+
   if (!fs.existsSync(tmpDir)) {
     fs.mkdirSync(tmpDir);
   }
 
   // TODO: Throw error if path doesn't exist once all packages add markdown support.
   const apiJsonDirectories = (
-    await mapWorkspaceToPackages([
-      `${projectRoot}/packages/*`
-    ])
+    await mapWorkspaceToPackages([`${projectRoot}/packages/*`])
   )
     .map(path => `${path}/temp`)
     .filter(path => fs.existsSync(path));