feat: Add support for CORS requests (#14)

* fix: Ensure response object has non-empty url property

* feat: Add CORS support

* Fix test

* Unformat mdx files

Author: nzakas

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -13,7 +13,7 @@ body:
           value: |
               Node version: 
               npm version: 
-              Mentoss version: 
+              Mentoss version:
       validations:
           required: true
     - type: textarea

.github/ISSUE_TEMPLATE/docs.yml

@@ -22,7 +22,7 @@ body:
       attributes:
           label: What do you think is the correct solution?
           description: |
-              Please explain how you'd like to change the ESLint docs to address the problem.
+              Please explain how you'd like to change the Mentoss docs to address the problem.
       validations:
           required: true
     - type: checkboxes

.github/workflows/release-please.yml

@@ -47,12 +47,12 @@ jobs:
 
             - name: Push to latest and version branches branch
               run: |
-                git config --global user.email "github-actions[bot]@users.noreply.github.com"
-                git config --global user.name "github-actions[bot]"
-                git push -f origin main:v${{ steps.release.outputs.major }}.x
-                git push -f origin main:latest
+                  git config --global user.email "github-actions[bot]@users.noreply.github.com"
+                  git config --global user.name "github-actions[bot]"
+                  git push -f origin main:v${{ steps.release.outputs.major }}.x
+                  git push -f origin main:latest
               if: ${{ steps.release.outputs.release_created }}
-              
+
             # Tweets out release announcement
             - run: 'node dist/esm/bin.js -t -b -m "${{ github.event.repository.full_name }} v${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }}.${{ steps.release.outputs.patch }} has been released!\n\n${{ github.event.repository.html_url }}/releases/tag/${{ steps.release.outputs.tag_name }}"'
               if: ${{ steps.release.outputs.release_created }}

.prettierignore

@@ -2,3 +2,4 @@ dist
 CHANGELOG.md
 jsr.json
 .prettierignore
+**/*.mdx

docs/astro.config.mjs

@@ -1,36 +1,37 @@
 // @ts-check
-import { defineConfig } from 'astro/config';
-import starlight from '@astrojs/starlight';
+import { defineConfig } from "astro/config";
+import starlight from "@astrojs/starlight";
 
 // https://astro.build/config
 export default defineConfig({
 	integrations: [
 		starlight({
-			title: 'Mentoss',
+			title: "Mentoss",
 			social: {
-				github: 'https://github.com/humanwhocodes/mentoss',
+				github: "https://github.com/humanwhocodes/mentoss",
 			},
 			editLink: {
-				baseUrl: 'https://github.com/humanwhocodes/mentoss/edit/main/docs/',
+				baseUrl:
+					"https://github.com/humanwhocodes/mentoss/edit/main/docs/",
 			},
 			lastUpdated: true,
 			sidebar: [
 				{
-					label: 'Getting Started',
-					slug: 'getting-started',
+					label: "Getting Started",
+					slug: "getting-started",
 				},
 				{
-					label: 'Mock Servers',
-					autogenerate: { directory: 'mock-servers' },
+					label: "Mock Servers",
+					autogenerate: { directory: "mock-servers" },
 				},
 				{
-					label: 'Fetch Mockers',
-					autogenerate: { directory: 'fetch-mockers' },
+					label: "Fetch Mockers",
+					autogenerate: { directory: "fetch-mockers" },
 				},
 			],
 			components: {
-				Footer: './src/components/MyFooter.astro',
-			}
+				Footer: "./src/components/MyFooter.astro",
+			},
 		}),
 	],
 });

docs/package.json

@@ -14,4 +14,4 @@
     "astro": "^5.1.5",
     "sharp": "^0.32.5"
   }
-}
+}

docs/src/content.config.ts

@@ -1,6 +1,6 @@
-import { defineCollection } from 'astro:content';
-import { docsLoader } from '@astrojs/starlight/loaders';
-import { docsSchema } from '@astrojs/starlight/schema';
+import { defineCollection } from "astro:content";
+import { docsLoader } from "@astrojs/starlight/loaders";
+import { docsSchema } from "@astrojs/starlight/schema";
 
 export const collections = {
 	docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),

docs/src/content/docs/fetch-mockers/creating-fetch-mocker.mdx

@@ -3,13 +3,13 @@ title: Creating a Fetch Mocker
 description: Learn how to create a fetch mocker to mock the fetch() function
 ---
 
-A *fetch mocker* in Mentoss is how you create a mocked version of a `fetch()` function. Fetch mockers are used to intercept calls to `fetch()` and return responses that you've defined in your mock servers. This allows you to test your code without making real network requests.
+A _fetch mocker_ in Mentoss is how you create a mocked version of a `fetch()` function. Fetch mockers are used to intercept calls to `fetch()` and return responses that you've defined in your mock servers. This allows you to test your code without making real network requests.
 
 ## Create a new `FetchMocker` instance
 
 To get started, import the `FetchMocker` class and create a new instance. The only argument is an object with the following properties:
 
-* `servers` (required) - an array of `MockServer` instances to use for mocking fetch requests
+-   `servers` (required) - an array of `MockServer` instances to use for mocking fetch requests
 
 Here's an example:
 
@@ -19,7 +19,7 @@ import { MockServer, FetchMocker } from "mentoss";
 const server = new MockServer("https://api.example.com");
 
 const mocker = new FetchMocker({
-    servers: [server]
+	servers: [server],
 });
 ```
 
@@ -36,35 +36,34 @@ There are two ways to use a mocked `fetch()` function:
 
 Each `FetchMocker` instance creates a `fetch()` function that can be extracted and used in place of the global `fetch()` function. Here's an example:
 
-```js {10-11, 23-24}
+```js {10-11, 22-23}
 import { MockServer, FetchMocker } from "mentoss";
 import { expect } from "chai";
 
 describe("My API", () => {
-    const server = new MockServer("https://api.example.com");
-    const mocker = new FetchMocker({
-        servers: [server]
-    });
-
-    // extract the fetch function
-    const myFetch = mocker.fetch;
-
-    // reset the server after each test
-    afterEach(() => {
-        server.clear();
-    });
-    
-    it("should return a 200 status code", async () => {
-
-        // set up the route to test
-        server.get("/ping", 200);
-
-        // make the request
-        const response = await myFetch("https://api.example.com/ping");
-        
-        // check the response
-        expect(response.status).to.equal(200);
-    });
+	const server = new MockServer("https://api.example.com");
+	const mocker = new FetchMocker({
+		servers: [server],
+	});
+
+	// extract the fetch function
+	const myFetch = mocker.fetch;
+
+	// reset the server after each test
+	afterEach(() => {
+		mocker.clearAll();
+	});
+
+	it("should return a 200 status code", async () => {
+		// set up the route to test
+		server.get("/ping", 200);
+
+		// make the request
+		const response = await myFetch("https://api.example.com/ping");
+
+		// check the response
+		expect(response.status).to.equal(200);
+	});
 });
 ```
 
@@ -74,44 +73,43 @@ In this example, the `fetch()` function is extracted from the `mocker` instance
 
 If you want to mock the global `fetch()` function, you can use the `mockGlobal()` and `unmockGlobal()` methods provided by the fetch mocker. Here's an example:
 
-```js {12-15, 22-25, 32-33}
+```js {12-15, 22-25, 31-32}
 import { MockServer, FetchMocker } from "mentoss";
 import { expect } from "chai";
 
 describe("My API", () => {
-    let mocker;
-
-    const server = new MockServer("https://api.example.com");
-    mocker = new FetchMocker({
-        servers: [server]
-    });
-    
-    // mock the global fetch function
-    before(() => {
-        mocker.mockGlobal();
-    });
-    
-    // reset the server after each test
-    afterEach(() => {
-        server.clear();
-    });
-    
-    // unmock the global fetch function
-    after(() => {
-        mocker.unmockGlobal();
-    });
-
-    it("should return a 200 status code", async () => {
-
-        // set up the route to test
-        server.get("/ping", 200);
-
-        // make the request
-        const response = await fetch("https://api.example.com/ping");
-        
-        // check the response
-        expect(response.status).to.equal(200);
-    });
+	let mocker;
+
+	const server = new MockServer("https://api.example.com");
+	mocker = new FetchMocker({
+		servers: [server],
+	});
+
+	// mock the global fetch function
+	before(() => {
+		mocker.mockGlobal();
+	});
+
+	// reset the server after each test
+	afterEach(() => {
+		mocker.clearAll();
+	});
+
+	// unmock the global fetch function
+	after(() => {
+		mocker.unmockGlobal();
+	});
+
+	it("should return a 200 status code", async () => {
+		// set up the route to test
+		server.get("/ping", 200);
+
+		// make the request
+		const response = await fetch("https://api.example.com/ping");
+
+		// check the response
+		expect(response.status).to.equal(200);
+	});
 });
 ```