docs: specify import usage with TypeScript

README.md

@@ -16,6 +16,38 @@ A collection of Firestore utilities.
 npm install @merlinnot/firestore-extensions
 ```
 
+### TypeScript
+
+This library defines
+[multiple entry points](https://nodejs.org/api/packages.html#packages_package_entry_points),
+which is
+[not yet supported](https://github.com/microsoft/TypeScript/issues/33079) by
+TypeScript. To work around this limitation, either:
+
+1. Manually specify import paths (choose `cjs` or `mjs` in your path depending
+   on which flavor you use).
+
+   ```json
+   {
+     "compilerOptions": {
+       "paths": {
+         "@merlinnot/firestore-extensions/ids": [
+           "./node_modules/@merlinnot/firestore-extensions/lib/cjs/ids/index.js"
+         ],
+         "@merlinnot/firestore-extensions/subscriptions": [
+           "./node_modules/@merlinnot/firestore-extensions/lib/cjs/subscriptions/index.js"
+         ]
+       }
+     }
+   }
+   ```
+
+2. Use only the main entry point.
+
+   ```typescript
+   import { ids, subscriptions } from '@merlinnot/firestore-extensions'`
+   ```
+
 ### Usage
 
 #### Firestore ID to UUID converter

__mocks__/@google-cloud/firestore/index.ts

@@ -1,6 +1,6 @@
 /* eslint-disable immutable/no-mutation, max-classes-per-file */
 
-import * as firestore from '@google-cloud/firestore';
+import firestore from '@google-cloud/firestore';
 import { credentials } from '@grpc/grpc-js';
 
 import {

babel.config.cjs

@@ -0,0 +1,6 @@
+module.exports = {
+  presets: [
+    ['@babel/preset-env', { targets: { node: 'current' } }],
+    '@babel/preset-typescript',
+  ],
+};

jest.config.ts

@@ -17,20 +17,11 @@ const configuration: Config.InitialOptions = {
     },
   },
   forceExit: true,
-  globals: {
-    'ts-jest': {
-      diagnostics: false,
-      isolatedModules: true,
-      tsconfig: 'tsconfig.json',
-    },
-  },
   logHeapUsage: true,
-  preset: 'ts-jest',
   restoreMocks: true,
   roots: ['<rootDir>/__mocks__', '<rootDir>/src'],
   setupFilesAfterEnv: ['<rootDir>/test/setup.ts'],
   testEnvironment: 'node',
-  testRunner: 'jest-circus/runner',
 };
 
 export default configuration;