Add and configure TypeScript, migrate .d.ts files for metro-cache

Summary:
Configures repository to support TypeScript definitions inside each package directory under `types/`.

This is an interim structure which preserves the current types and paths from DefinitelyTyped. In future, we may shift to inline definitions, or (more likely) auto-translated types when the [flow-api-translator](https://www.npmjs.com/package/flow-api-translator) tool is more mature.

- Add `[email protected]` and configure project file.
- Add step to `scripts/build.js` to copy TypeScript definitions (`.d.ts`) across to distributed code.
- Add `yarn typecheck-ts` script and add to CircleCI.
- Add and configure `typescript-eslint` against `types/` directories.
- Migrates TypeScript definitions for `metro-cache` (self-contained package types), from DefinitelyTyped, used to validate all changes.

Changelog: **[Types]** Add bundled TypeScript definitions (partial) for metro-cache

Reviewed By: motiz88

Differential Revision: D44133264

fbshipit-source-id: b9b56cd751670964b57400bd9c63155349f78e81

Author: huntie

.circleci/config.yml

@@ -57,6 +57,7 @@ jobs:
       - checkout
       - yarn_install
       - run: yarn typecheck
+      - run: yarn typecheck-ts
       - run: yarn lint
       - run: yarn test-smoke
 

.eslintignore

@@ -7,6 +7,5 @@ docs/
 examples/react-native
 flow-typed/**
 packages/*/build/**
-types/**
 website/
 **/third-party/**

.eslintrc.js

@@ -10,7 +10,6 @@
 
 'use strict';
 
-/** @type {import('eslint').Linter.Config} */
 module.exports = {
   extends: './scripts/eslint/base',
   overrides: [
@@ -21,6 +20,10 @@ module.exports = {
         'lint/flow-function-shape': 'off',
       },
     },
+    {
+      files: ['packages/*/types/**/*.d.ts'],
+      extends: './scripts/eslint/typescript',
+    },
     {
       files: ['packages/metro-source-map/**/*.js'],
       rules: {

package.json

@@ -5,6 +5,9 @@
     "@babel/plugin-syntax-class-properties": "^7.0.0",
     "@babel/plugin-transform-flow-strip-types": "^7.0.0",
     "@babel/plugin-transform-modules-commonjs": "^7.0.0",
+    "@tsconfig/node16": "1.0.1",
+    "@typescript-eslint/eslint-plugin": "^5.30.5",
+    "@typescript-eslint/parser": "^5.30.5",
     "acorn": "^8.7.1",
     "babel-jest": "^29.2.1",
     "chalk": "^4.0.0",
@@ -34,7 +37,8 @@
     "micromatch": "^4.0.4",
     "prettier": "2.7.1",
     "progress": "^2.0.0",
-    "promise": "^8.3.0"
+    "promise": "^8.3.0",
+    "typescript": "4.1.3"
   },
   "scripts": {
     "build-clean": "rm -rf ./packages/*/build",
@@ -46,10 +50,11 @@
     "postpublish": "yarn workspaces run cleanup-release",
     "publish": "yarn run build-clean && yarn run build && yarn workspaces run prepare-release && npm publish --workspaces",
     "start": "node packages/metro/src/cli",
+    "test": "yarn run typecheck && yarn run lint && yarn run build && yarn run jest",
     "test-coverage": "yarn run build && yarn run jest --coverage -i && node scripts/mapCoverage.js",
     "test-smoke": "yarn start build --config packages/metro/src/integration_tests/metro.config.js TestBundle.js --out /tmp/TestBundle",
-    "test": "yarn run typecheck && yarn run lint && yarn run build && yarn run jest",
     "typecheck": "flow check",
+    "typecheck-ts": "tsc --project tsconfig.json",
     "update-version": "node ./scripts/updateVersion"
   },
   "workspaces": [

packages/metro-cache/types/Cache.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall react_native
+ */
+
+import {CacheStore} from './types';
+
+/**
+ * Main cache class. Receives an array of cache instances, and sequentially
+ * traverses them to return a previously stored value. It also ensures setting
+ * the value in all instances.
+ *
+ * All get/set operations are logged via Metro's logger.
+ */
+export default class Cache<T> {
+  constructor(stores: ReadonlyArray<CacheStore<T>>);
+  get(key: Buffer): Promise<T | null>;
+  set(key: Buffer, value: T): void;
+  get isDisabled(): boolean;
+}

packages/metro-cache/types/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall react_native
+ */
+
+// <reference types="node" />
+
+import AutoCleanFileStore from './stores/AutoCleanFileStore';
+import FileStore from './stores/FileStore';
+import HttpGetStore from './stores/HttpGetStore';
+import HttpStore from './stores/HttpStore';
+import Cache from './Cache';
+import stableHash from './stableHash';
+
+export type {Options as FileOptions} from './stores/FileStore';
+export type {Options as HttpOptions} from './stores/HttpStore';
+export type {CacheStore} from './types';
+
+export interface MetroCache {
+  AutoCleanFileStore: typeof AutoCleanFileStore;
+  Cache: typeof Cache;
+  FileStore: typeof FileStore;
+  HttpGetStore: typeof HttpGetStore;
+  HttpStore: typeof HttpStore;
+  stableHash: typeof stableHash;
+}
+
+export {
+  AutoCleanFileStore,
+  Cache,
+  FileStore,
+  HttpGetStore,
+  HttpStore,
+  stableHash,
+};

packages/metro-cache/types/stableHash.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall react_native
+ */
+
+export default function stableHash(value: unknown): Buffer;

packages/metro-cache/types/stores/AutoCleanFileStore.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall react_native
+ */
+
+import type FileStore from './FileStore';
+
+export default class AutoCleanFileStore<T> extends FileStore<T> {}

packages/metro-cache/types/stores/FileStore.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall react_native
+ */
+
+export interface Options {
+  root: string;
+}
+
+export default class FileStore<T> {
+  constructor(options: Options);
+  get(key: Buffer): Promise<T | null>;
+  set(key: Buffer, value: T): Promise<void>;
+  clear(): void;
+}

packages/metro-cache/types/stores/HttpGetStore.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall react_native
+ */
+
+import type {Options} from './HttpStore';
+
+export default class HttpGetStore<T> {
+  constructor(options: Options);
+  get(key: Buffer): Promise<T | null>;
+  set(key: Buffer, value: T): Promise<void>;
+  clear(): void;
+}