update separate-snippets to replace ref docs urls

Author: thatfiredev

scripts/separate-snippets.ts

@@ -18,6 +18,15 @@ const RE_END_SNIPPET = /\[END\s+([A-Za-z_]+)\s*\]/;
 // TODO: Handle multiline imports?
 const RE_REQUIRE = /const {(.+?)} = require\((.+?)\)/;
 
+// Regex for ref docs URLs
+// eg. "https://firebase.google.com/docs/reference/js/v8/firebase.User"
+const RE_REF_DOCS = /https:\/\/firebase\.google\.com\/docs\/reference\/js\/(.*)/;
+
+// Maps v8 ref docs URLs to their v9 counterpart
+const REF_DOCS_MAPPINGS: { [key: string]: string } = {
+  "v8/firebase.User" : "auth.user"
+};
+
 type SnippetsConfig = {
   enabled: boolean;
   suffix: string;
@@ -30,6 +39,26 @@ function isBlank(line: string) {
   return line.trim().length === 0;
 }
 
+/**
+ * Replace all v8 ref doc urls with their v9 counterpart.
+ */
+function replaceRefDocsUrls(lines: string[]) {
+  const outputLines = [];
+  for (const line of lines) {
+    if (line.match(RE_REF_DOCS)) {
+      outputLines.push(line.replace(RE_REF_DOCS, (match: string, p1?: string) => {
+        if (p1) {
+          return `https://firebase.google.com/docs/reference/js/${REF_DOCS_MAPPINGS[p1]}`;
+        }
+        return match;
+      }));
+    } else {
+      outputLines.push(line);
+    }
+  }
+  return outputLines;
+}
+
 /**
  * Replace all const { foo } = require('bar') with import { foo } from 'bar';
  */
@@ -119,6 +148,7 @@ function processSnippet(
   outputLines = addSuffixToSnippetNames(outputLines, snippetSuffix);
   outputLines = adjustIndentation(outputLines);
   outputLines = removeFirstLineAfterComments(outputLines);
+  outputLines = replaceRefDocsUrls(outputLines);
 
   // Add a preamble to every snippet
   const preambleLines = [

snippets/auth-next/index/auth_current_user.js

@@ -12,7 +12,7 @@ const user = auth.currentUser;
 
 if (user) {
   // User is signed in, see docs for a list of available properties
-  // https://firebase.google.com/docs/reference/js/v8/firebase.User
+  // https://firebase.google.com/docs/reference/js/auth.user
   // ...
 } else {
   // No user is signed in.

snippets/auth-next/index/auth_state_listener.js

@@ -11,7 +11,7 @@ const auth = getAuth();
 onAuthStateChanged(auth, (user) => {
   if (user) {
     // User is signed in, see docs for a list of available properties
-    // https://firebase.google.com/docs/reference/js/v8/firebase.User
+    // https://firebase.google.com/docs/reference/js/auth.user
     const uid = user.uid;
     // ...
   } else {