feat!: update the build to use api-extractor types (GoogleCloudPlatform#383)

This commit updates our build config to use the types generated by the
API extractor. This prevents us exposing private implementation details
in our type declarations that are not marked `@public`

Author: matthewrobertson

.github/workflows/docs.yml

@@ -16,6 +16,6 @@ jobs:
     - name: Install dependencies
       run: npm install
     - name: Build TypeScript project
-      run: npm run docs
+      run: npm run build
     - name: Ensure there are no changes in docs
       run: git diff --exit-code docs/

.github/workflows/publish.yml

@@ -16,5 +16,5 @@ jobs:
           NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}
         run: |
           npm install
-          npm run compile
+          npm run build
           npm publish

api-extractor.json

@@ -19,7 +19,7 @@
 
   "dtsRollup": {
     "enabled": true,
-    "untrimmedFilePath": "docs/generated/api.d.ts",
+    "untrimmedFilePath": "build/src/index.d.ts",
     "omitTrimmingComments": true
   },
 

docs/generated/api.d.ts

@@ -18,15 +18,15 @@
   },
   "scripts": {
     "test": "mocha build/test --recursive",
+    "build": "npm run clean && npm run compile && npm run docs",
     "conformance": "./run_conformance_tests.sh",
     "check": "gts check",
     "clean": "gts clean",
-    "compile": "rm -rf ./build && tsc -p .",
+    "compile": "tsc -p .",
     "fix": "gts fix",
-    "predocs": "npm run compile",
     "docs": "api-extractor run --local --verbose",
     "watch": "npm run compile -- --watch",
-    "prepare": "npm run compile",
+    "prepare": "npm run build",
     "pretest": "npm run compile"
   },
   "files": [

package.json

@@ -1,5 +1,5 @@
 {
-  "extends": "gts/tsconfig-google.json",
+  "extends": "./node_modules/gts/tsconfig-google.json",
   "compilerOptions": {
     "rootDir": ".",
     "outDir": "build",