Migrate workbox-build to TypeScript

.gitignore

@@ -21,7 +21,7 @@ firebase-debug.log
 # Generated TypeScript files and build data
 tsconfig.tsbuildinfo
 packages/workbox-*/**/*.d.ts
-!packages/workbox-cli/src/index.d.ts
+!packages/workbox-*/src/**/*.d.ts
 packages/workbox-*/**/*.js
 !packages/workbox-build/**/*.js
 !packages/workbox-webpack-plugin/**/*.js

gulp-tasks/build-node-packages.js

@@ -8,6 +8,8 @@
 
 const {parallel} = require('gulp');
 const execa = require('execa');
+const fse = require('fs-extra');
+const TJS = require('typescript-json-schema');
 const upath = require('upath');
 
 const constants = require('./utils/constants');
@@ -28,7 +30,59 @@ async function buildNodePackage(packagePath) {
   ], {preferLocal: true});
 }
 
+async function generateWorkboxBuildJSONSchema(packagePath) {
+  const program = TJS.programFromConfig(upath.join(packagePath,
+      'tsconfig.json'));
+  const generator = TJS.buildGenerator(program, {
+    noExtraProps: true,
+    required: true,
+  });
+  const optionTypes = [
+    'GenerateSWOptions',
+    'GetManifestOptions',
+    'InjectManifestOptions',
+    'WebpackGenerateSWOptions',
+    'WebpackInjectManifestOptions',
+  ];
+  for (const optionType of optionTypes) {
+    const schema = generator.getSchemaForSymbol(optionType);
+    // Ideally, we'd set typeOfKeyword so that functions could be represented.
+    // Instead, we need to hardcode a few overrides to deal with functions.
+    // See https://github.com/YousefED/typescript-json-schema/issues/424
+    if (schema.properties.manifestTransforms) {
+      schema.properties.manifestTransforms.items = {typeof: 'function'};
+    }
+    if (schema.properties.exclude) {
+      schema.properties.exclude.items.anyOf = [
+        {'$ref': '#/definitions/RegExp'},
+        {type: 'string'},
+        {typeof: 'function'},
+      ];
+    }
+    if (schema.properties.include) {
+      schema.properties.include.items.anyOf = [
+        {'$ref': '#/definitions/RegExp'},
+        {type: 'string'},
+        {typeof: 'function'},
+      ];
+    }
+    if (schema.definitions.RouteMatchCallback) {
+      delete schema.definitions.RouteMatchCallback.type;
+      delete schema.definitions.RouteMatchCallback.additionalProperties;
+      schema.definitions.RouteMatchCallback.typeof = 'function';
+    }
+    await fse.writeJSON(upath.join(packagePath, 'src', 'schema',
+        `${optionType}.json`), schema);
+  }
+}
+
 async function buildNodeTSPackage(packagePath) {
+  // Hardcode special logic for workbox-build, as it's the only package
+  // that requires JSON schema generation.
+  if (packagePath.endsWith('workbox-build')) {
+    await generateWorkboxBuildJSONSchema(packagePath);
+  }
+
   await execa('tsc', ['-b', packagePath], {preferLocal: true});
 }
 

gulp-tasks/build-packages.js

@@ -23,9 +23,11 @@ async function cleanPackage(packagePath) {
   if (await fse.pathExists(upath.join(packagePath, 'src', 'index.ts'))) {
     // Store the list of deleted files, so we can delete directories after.
     const deletedPaths = await del([
-      upath.join(packagePath, '**/*.+(js|mjs|d.ts)'),
+      `${packagePath}/**/*.+(js|mjs|d.ts)`,
       // Don't delete files in node_modules.
-      '!**/node_modules', '!**/node_modules/**/*',
+      '!**/node_modules/**/*',
+      // Don't delete anything under src.
+      `!${packagePath}/src/**/*`,
     ]);
 
     // Any directories in `deletedPaths` that are top-level directories to the
@@ -57,12 +59,12 @@ module.exports = {
   build_packages_clean: cleanSequence(),
   build_packages: series(
       cleanSequence(),
+      // This needs to be a series, not in parallel, so that there isn't a
+      // race condition with the terser nameCache.
+      series(build_sw_packages, build_window_packages),
       parallel(
           build_node_packages,
           build_node_ts_packages,
-          // This needs to be a series, not in parallel, so that there isn't a
-          // race condition with the terser nameCache.
-          series(build_sw_packages, build_window_packages),
       ),
   ),
 };

gulp-tasks/utils/versioned-cdn-url.js

@@ -6,8 +6,8 @@
   https://opensource.org/licenses/MIT.
 */
 
-const {getCDNOrigin} = require(
-    '../../packages/workbox-build/src/lib/cdn-utils');
+const cdn = require('../../packages/workbox-build/src/cdn-details.json');
 const lernaPkg = require('../../lerna.json');
 
-module.exports = () => `${getCDNOrigin()}/${lernaPkg.version}`;
+module.exports = () => `${cdn.origin}/${cdn.bucketName}/${cdn.releasesDir}` +
+    `/${lernaPkg.version}`;

infra/testing/webpack-build-check.js

@@ -7,7 +7,7 @@
 */
 
 function joinMessages(errorsOrWarnings) {
-  if ('message' in errorsOrWarnings[0]) {
+  if (errorsOrWarnings[0].message) {
     return errorsOrWarnings.map((item) => item.message).join('\n');
   } else {
     return errorsOrWarnings.join('\n');