Bump versions to 2.0.0, update CHANGELOG.md and docs 🎉

Author: mrbbot

docs/CHANGELOG.md

@@ -35,6 +35,6 @@ module.exports = {
       "Fun, full-featured, fully-local simulator for Cloudflare Workers",
     author: "@cloudflare",
     url: "https://miniflare.dev",
-    // image: "http://developers.cloudflare.com/workers/og-image.png",
+    image: "https://blog.cloudflare.com/content/images/2022/01/image1-5.png",
   },
 };

docs/docs-config.js

@@ -99,3 +99,90 @@ const mf = new Miniflare({
 KV namespaces and caches returned from `Miniflare#getKVNamespace()` and
 `Miniflare#getCaches()` are unaffected by this limit, so they can still be used
 in tests without setting any additional options.
+
+## `instanceof`, `constructor` and `prototype` Checks
+
+Miniflare overrides `instanceof` checks for primitive classes like `Object` so
+they succeed for values created both inside and outside the Miniflare sandbox
+(in a different JavaScript realm). This ensures dynamic type checking often
+performed by WebAssembly glue code (e.g. `wasm-bindgen`) always succeeds. Note
+that values returned by Workers runtime APIs are created outside the Miniflare
+sandbox. See
+[this file](https://github.com/cloudflare/miniflare/blob/v2/packages/runner-vm/src/instanceof.ts)
+for more details.
+
+Primitive classes in this case are defined as JavaScript built-ins that can be
+instantiated by something other than their constructor (e.g. literals,
+`function`s, runtime errors):
+
+- `Object`
+- `Function`
+- `Array`
+- `Promise`
+- `RegExp`
+- `Error`, `EvalError`, `RangeError`, `ReferenceError`, `SyntaxError`,
+  `TypeError`, `URIError`
+
+Primitive `constructor` and `prototype` checks cannot be trapped easily and so
+will fail for values created outside the Miniflare sandbox.
+
+```js
+import { Miniflare } from "miniflare";
+
+const mf = new Miniflare({
+  bindings: {
+    OBJECT: { a: 1 },
+    ARRAY: new Uint8Array([1, 2, 3]),
+  },
+  modules: true,
+  script: `
+    export default {
+      async fetch(request, env, ctx) {
+        console.log({ a: 1 } instanceof Object); // ✅ true
+        console.log(new Uint8Array([1, 2, 3]) instanceof Object); // ✅ true
+        console.log({ a: 1 }.constructor === Object); // ✅ true
+        console.log(Object.getPrototypeOf({ a: 1 }) === Object.prototype); // ✅ true
+        
+        console.log(env.OBJECT instanceof Object); // ✅ true
+        console.log(env.ARRAY instanceof Object); // ✅ true
+        console.log(env.OBJECT.constructor === Object); // ❌ false
+        console.log(Object.getPrototypeOf(env.OBJECT) === Object.prototype); // ❌ false
+        
+        throw new Error("oops!");
+      }
+    }
+  `,
+});
+
+try {
+  await mf.dispatchFetch("http://localhost");
+} catch (e) {
+  console.log(e instanceof Error); // ❌ false
+}
+```
+
+By default, primitive `instanceof` checks outside the Miniflare sandbox will
+fail for values created inside the sandbox (e.g. checking types of thrown
+exceptions in tests). To fix this, pass the primitive class in from Node.js as a
+custom global. Note this will cause primitive `instanceof` checks to fail for
+values created without the constructor inside the sandbox.
+
+```js
+const mf = new Miniflare({
+  globals: { Error },
+  modules: true,
+  script: `
+    export default {
+      async fetch(request, env, ctx) {
+        throw new Error("oops!");
+      }
+    }
+  `,
+});
+
+try {
+  await mf.dispatchFetch("http://localhost");
+} catch (e) {
+  console.log(e instanceof Error); // ✅ true
+}
+```

docs/src/content/core/standards.md

@@ -84,57 +84,6 @@ export default {
 };
 ```
 
-## `instanceof` Checks
-
-When accessing JavaScript objects from WebAssembly, glue code (what
-`wasm-bingen` generates) often needs to check values' types using `instanceof`.
-Due to how Miniflare works, these checks will fail for primitive classes like
-`Object` if values are created outside the Miniflare sandbox (in a different
-JavaScript realm). For example,
-`caches.default.match("https://miniflare.dev") instanceof Object` will always be
-`false` even if the request is cached, since the returned `Response` object is
-created outside the sandbox. To fix this, enable the `proxyPrimitiveInstanceOf`
-option:
-
-<ConfigTabs>
-
-```sh
-$ miniflare --proxy-primitive
-```
-
-```toml
----
-filename: wrangler.toml
----
-[miniflare]
-proxy_primitive_instanceof = true
-```
-
-```js
-const mf = new Miniflare({
-  proxyPrimitiveInstanceOf: true,
-});
-```
-
-</ConfigTabs>
-
-This proxies `instanceof` checks for primitive classes, so they succeed
-regardless of the realm the object is created in. See
-[this comment](https://github.com/cloudflare/miniflare/blob/720794accee7582b01e849182244a65ce60c9d60/packages/core/src/plugins/core.ts#L487-L555)
-for more details.
-
-<Aside type="warning" header="Warning">
-
-Enabling this option will cause primitive class `constructor` and `prototype`
-checks to fail:
-
-```js
-{}.constructor === Object; // false
-Object.getPrototypeOf({}) === Object.prototype; // false
-```
-
-</Aside>
-
 ## Rust Wrangler Builds
 
 When using [Rust Wrangler Builds](/developing/builds#rust), `wasm` is

docs/src/content/core/web-assembly.md

@@ -8,13 +8,6 @@ type: overview
 
 # 🔥 Miniflare
 
-<Aside type="warning" header="Warning">
-
-⚠️ These docs are for the next major version of Miniflare, which is under
-development.
-
-</Aside>
-
 **Miniflare** is a simulator for developing and testing
 [**Cloudflare Workers**](https://workers.cloudflare.com/). It's written in
 TypeScript, and runs your code in a sandbox implementing Workers' runtime APIs.
@@ -28,8 +21,8 @@ TypeScript, and runs your code in a sandbox implementing Workers' runtime APIs.
 
 <ButtonGroup>
   <Button type="primary" href="/get-started/cli">Get Started</Button>
-  <Button type="secondary" href="https://github.com/cloudflare/miniflare/tree/v2">GitHub</Button>
-  <Button type="secondary" href="https://npmjs.com/package/miniflare/v/next">npm</Button>
+  <Button type="secondary" href="https://github.com/cloudflare/miniflare">GitHub</Button>
+  <Button type="secondary" href="https://npmjs.com/package/miniflare">npm</Button>
 </ButtonGroup>
 
 ---

docs/src/content/index.md

@@ -14,7 +14,7 @@ for an example using TypeScript.
 The Miniflare environment isn't installed by default, install it and Jest with:
 
 ```sh
-$ npm install -D jest-environment-miniflare@next jest
+$ npm install -D jest-environment-miniflare jest
 ```
 
 In the following examples, we'll assume your `package.json` contains