Docs: update docs to represent v3 (#733)

* docs: remove cli config. remove refs to mf cli. remove pages related to wrangler 1. other cleanup.

* remove options not in v3. add initial queues page commit.

* update cron, queues, fetch docs. remove docs for other methods not in v3.

* update examples

* remove references to redis package. update fetch mock imports.

* cleanup scheduled example and queues example.

* update get started examples. update fetcher const to worker.

* remove cli option from config tabs. update fetch doc.

* update line mubers for highlighting. update queues consumer doc.

* update docs per github comments

* Update docs/src/content/core/queues.md

Co-authored-by: MrBBot <[email protected]>

* Update docs/src/content/core/queues.md

Co-authored-by: MrBBot <[email protected]>

* Update docs/src/content/core/queues.md

Co-authored-by: MrBBot <[email protected]>

* Update docs/src/content/core/queues.md

Co-authored-by: MrBBot <[email protected]>

* update etWorker to dispatchFetch where appropriate. update config tabs usage.

* add d1 doc to storage. remove persistence mentions.

* Update docs/src/content/core/multiple-workers.md

Co-authored-by: MrBBot <[email protected]>

* Update docs/src/content/core/scheduled.md

Co-authored-by: MrBBot <[email protected]>

* Update docs/src/content/get-started/index.md

Co-authored-by: MrBBot <[email protected]>

* Update docs/src/content/get-started/index.md

Co-authored-by: MrBBot <[email protected]>

* Update docs/src/content/get-started/index.md

Co-authored-by: MrBBot <[email protected]>

* Update docs/src/content/get-started/index.md

Co-authored-by: MrBBot <[email protected]>

* Update docs/src/content/get-started/index.md

Co-authored-by: MrBBot <[email protected]>

* Update docs/src/content/get-started/index.md

Co-authored-by: MrBBot <[email protected]>

* Update docs/src/content/get-started/index.md

Co-authored-by: MrBBot <[email protected]>

* Update docs/src/content/get-started/index.md

Co-authored-by: MrBBot <[email protected]>

* Update docs/src/content/get-started/index.md

Co-authored-by: MrBBot <[email protected]>

* Update docs/src/content/get-started/index.md

Co-authored-by: MrBBot <[email protected]>

* Update docs/src/content/get-started/index.md

Co-authored-by: MrBBot <[email protected]>

* remove extra options from cert options

---------

Co-authored-by: MrBBot <[email protected]>

Author: admah

docs/index.md

@@ -4,13 +4,6 @@ title: Home
 
 # 🔥 Miniflare
 
-<!--prettier-ignore-start-->
-:::warning
-⚠️ These docs are for the next major version of Miniflare, which is
-under development. They're very likely incorrect and incomplete.
-:::
-<!--prettier-ignore-end-->
-
 **Miniflare** is a simulator for developing and testing
 [**Cloudflare Workers**](https://workers.cloudflare.com/).
 
@@ -21,7 +14,7 @@ under development. They're very likely incorrect and incomplete.
 - ⚡ **Fully-local:** test and develop Workers without an internet connection.
   Reload code on change quickly.
 
-It's an alternative to `wrangler dev`, written in TypeScript, that runs your
+It's written in TypeScript, and runs your
 workers in a sandbox implementing Workers' runtime APIs.
 
 These docs primarily cover Miniflare specific things. For more information on
@@ -31,4 +24,4 @@ runtime APIs, refer to the
 If you find something that doesn't behave as it does in the real Workers
 environment (and this difference isn't documented), or something's wrong in
 these docs, please
-[open a GitHub issue](https://github.com/cloudflare/miniflare/issues/new/choose).
+[open a GitHub issue](https://github.com/cloudflare/workers-sdk/issues/new/choose).

docs/package.json

@@ -9,11 +9,9 @@
     "ghactionsbootstrap": "node_modules/cloudflare-docs-engine/bin/commands.sh ghactionsbootstrap",
     "savechanges": "node_modules/cloudflare-docs-engine/bin/commands.sh savechanges",
     "serve": "node_modules/cloudflare-docs-engine/bin/commands.sh serve",
-
     "docs:reset": "rimraf ./.docs/src/content && node ./changelog.mjs",
     "docs:build": "npm run docs:reset && npm run build && cp ./_redirects ./.docs/public/",
     "docs:dev": "npm run docs:reset && concurrently \"npm:develop\" \"node watch.mjs\" -n dev,wat -c magenta,gray -k",
-
     "pages:build": "npm run ghactionsbootstrap && npm run docs:build"
   },
   "devDependencies": {

docs/src/content/components/mdx/config-tabs.js

@@ -5,13 +5,11 @@ import Helmet from "react-helmet";
 
 import getUniqueReadableID from "../../../utils/get-unique-readable-id";
 import IconAPI from "../icons/api";
-import IconCLI from "../icons/cli";
 import IconWrangler from "../icons/wrangler";
 
 // Page/storage synchronisation adapted from components/theme-toggle.js
 
 const TABS = [
-  { id: "cli", name: "CLI", Icon: IconCLI },
   { id: "wrangler", name: "wrangler.toml", Icon: IconWrangler, mono: true },
   { id: "api", name: "JavaScript API", Icon: IconAPI },
 ];

docs/src/content/core/compatibility.md

@@ -14,48 +14,17 @@ default to some time far in the past.
 
 import ConfigTabs from "../components/mdx/config-tabs";
 
-<ConfigTabs>
-
-```sh
-$ miniflare --compat-date 2021-11-12
-```
-
-```toml
----
-filename: wrangler.toml
----
-compatibility_date = "2021-11-12"
-```
-
 ```js
 const mf = new Miniflare({
   compatibilityDate: "2021-11-12",
 });
 ```
 
-</ConfigTabs>
-
 ## Compatibility Flags
 
 Miniflare also lets you opt-in/out of specific changes using compatibility
 flags:
 
-<ConfigTabs>
-
-```sh
-$ miniflare --compat-flag formdata_parser_supports_files --compat-flag durable_object_fetch_allows_relative_url
-```
-
-```toml
----
-filename: wrangler.toml
----
-compatibility_flags = [
-  "formdata_parser_supports_files",
-  "durable_object_fetch_allows_relative_url"
-]
-```
-
 ```js
 const mf = new Miniflare({
   compatibilityFlags: [
@@ -65,8 +34,6 @@ const mf = new Miniflare({
 });
 ```
 
-</ConfigTabs>
-
 Specifically Miniflare supports the following flags:
 
 - `nodejs_compat` (specifically the `node:assert`, `node:async_hooks`,

docs/src/content/core/fetch.md

@@ -10,15 +10,10 @@ order: 0
 
 ## HTTP Requests
 
-When using the CLI, an HTTP server is automatically started. Whenever an HTTP
-request is made, it is converted to a workers-compatible `Request` object,
-dispatched to your worker, then the generated `Response` is returned. The
-`Request` object will include
-[`CF-*` headers](https://support.cloudflare.com/hc/en-us/articles/200170986-How-does-Cloudflare-handle-HTTP-Request-headers-)
-and a
+Whenever an HTTP request is made, a `Request` object is dispatched to your worker, then the generated `Response` is returned. The
+`Request` object will include a
 [`cf` object](https://developers.cloudflare.com/workers/runtime-apis/request#incomingrequestcfproperties).
-Miniflare will log the method, path, status, the time it took to respond, and
-the time taken for all `waitUntil` promises to resolve.
+Miniflare will log the method, path, status, and the time it took to respond.
 
 If the worker throws an error whilst generating a response, an error page
 containing the stack trace is returned instead. You can use
@@ -36,16 +31,19 @@ object, or a URL and optional `RequestInit` object:
 import { Miniflare, Request } from "miniflare";
 
 const mf = new Miniflare({
+  modules: true,
   script: `
-  addEventListener("fetch", (event) => {
-    const body = JSON.stringify({
-      url: event.request.url,
-      header: event.request.headers.get("X-Message"),
-    });
-    event.respondWith(new Response(body, {
-      headers: { "Content-Type": "application/json" },
-    }));
-  });
+  export default {
+    async fetch(request, env, ctx) {
+      const body = JSON.stringify({
+        url: event.request.url,
+        header: event.request.headers.get("X-Message"),
+      });
+      return new Response(body, {
+        headers: { "Content-Type": "application/json" },
+      });
+    })
+  }
   `,
 });
 
@@ -65,28 +63,7 @@ res = await mf.dispatchFetch(
 console.log(await res.json()); // { url: "http://localhost:8787/2", header: "2" }
 ```
 
-You can use the `waitUntil` method of `Response` to get the data returned by all
-waited promises:
-
-```js
-import { Miniflare } from "miniflare";
-
-const mf = new Miniflare({
-  script: `
-  addEventListener("fetch", (event) => {
-    event.waitUntil(Promise.resolve(1));
-    event.waitUntil(Promise.resolve("2"));
-    event.respondWith(new Response());
-  });
-  `,
-});
-const res = await mf.dispatchFetch("http://localhost:8787/");
-const waitUntil = await res.waitUntil();
-console.log(waitUntil[0]); // 1
-console.log(waitUntil[1]); // "2"
-```
-
-When using the API to dispatch events, you are responsible for adding
+When dispatching events, you are responsible for adding
 [`CF-*` headers](https://support.cloudflare.com/hc/en-us/articles/200170986-How-does-Cloudflare-handle-HTTP-Request-headers-)
 and the
 [`cf` object](https://developers.cloudflare.com/workers/runtime-apis/request#incomingrequestcfproperties).
@@ -110,22 +87,6 @@ response is returned, or an exception is thrown and `passThroughOnException()`
 has been called, the response will be fetched from the specified upstream
 instead:
 
-import ConfigTabs from "../components/mdx/config-tabs";
-
-<ConfigTabs>
-
-```sh
-$ miniflare --upstream https://miniflare.dev # or -u
-```
-
-```toml
----
-filename: wrangler.toml
----
-[miniflare]
-upstream = "https://miniflare.dev"
-```
-
 ```js
 import { Miniflare } from "miniflare";
 
@@ -143,5 +104,3 @@ const mf = new Miniflare({
 const res = await mf.dispatchFetch("https://miniflare.dev/core/fetch");
 console.log(await res.text()); // Source code of this page
 ```
-
-</ConfigTabs>

docs/src/content/core/modules.md

@@ -11,33 +11,12 @@ order: 3
 Miniflare supports both the traditional `service-worker` and newer `modules`
 formats for writing workers. To use the `modules` format, enable it with:
 
-import ConfigTabs from "../components/mdx/config-tabs";
-
-<ConfigTabs>
-
-```sh
-$ miniflare --modules # or -m
-```
-
-```toml
----
-filename: wrangler.toml
----
-[build.upload]
-format = "modules"
-```
-
 ```js
 const mf = new Miniflare({
   modules: true,
 });
 ```
 
-</ConfigTabs>
-
-When using the API you must also pass the **`--experimental-vm-modules`** flag
-to Node.js. This is added automatically when using the CLI.
-
 You can now use `modules` worker scripts like the following:
 
 ```js
@@ -59,7 +38,7 @@ export default {
 
 <Aside type="warning" header="Warning">
 
-When using the API, string scripts via the `script` option are supported using
+String scripts via the `script` option are supported using
 the `modules` format, but you cannot import other modules using them. You must
 use a script file via the `scriptPath` option for this.
 
@@ -70,25 +49,6 @@ use a script file via the `scriptPath` option for this.
 Miniflare supports all module types: `ESModule`, `CommonJS`, `Text`, `Data` and
 `CompiledWasm`. You can specify additional module resolution rules as follows:
 
-<ConfigTabs>
-
-```sh
-# Note all rules implicitly have the `fallthrough` option set to true
-$ miniflare --modules-rule "ESModule=**/*.js" --modules-rule "Text=**/*.txt"
-```
-
-```toml
----
-filename: wrangler.toml
----
-[[build.upload.rules]]
-type = "ESModule"
-globs = ["**/*.js"]
-[[build.upload.rules]]
-type = "Text"
-globs = ["**/*.txt"]
-```
-
 ```js
 const mf = new Miniflare({
   modulesRules: [
@@ -98,8 +58,6 @@ const mf = new Miniflare({
 });
 ```
 
-</ConfigTabs>
-
 ### Default Rules
 
 The following rules are automatically added to the end of your modules rules