feat: custom fetch

.changeset/warm-needles-ring.md

@@ -0,0 +1,6 @@
+---
+'@just-web/browser': minor
+---
+
+Supports getting `fetch` from optional `FetchGizmo`.
+Supports using custom `fetch` from options.

plugins/browser/ts/browser_gizmo.spec.ts

@@ -3,8 +3,8 @@ import { AssertOrder, a, some, startsWith } from 'assertron'
 import { logLevels } from 'standard-log'
 import { stub, testType } from 'type-plus'
 import { ctx } from './browser_gizmo.ctx.js'
-import { throwBrowserError } from './testing/index.js'
 import { browserGizmoFn } from './index.js'
+import { throwBrowserError } from './testing/index.js'
 
 afterEach(() => {
 	ctx.addEventListener = addEventListener.bind(window)
@@ -84,3 +84,25 @@ it('provides location', async () => {
 	testType.equal<typeof app.browser.location, Location>(true)
 	expect(app.browser.location).toBeDefined()
 })
+
+it('uses fetch from FetchGizmo if provided', async () => {
+	const app = await justTestApp()
+		.merge({ fetch: async () => new Response('{}') })
+		.with(browserGizmoFn())
+		.create()
+	const r = await app.fetch('abc')
+	expect(await r.json()).toEqual({})
+})
+
+it('uses fetch from options if provided, over from FetchGizmo', async () => {
+	const app = await justTestApp()
+		.merge({
+			fetch: async () => {
+				throw 'should not reach'
+			}
+		})
+		.with(browserGizmoFn({ fetch: async () => new Response('{}') }))
+		.create()
+	const r = await app.fetch('abc')
+	expect(await r.json()).toEqual({})
+})

plugins/browser/ts/browser_gizmo.ts

@@ -1,18 +1,22 @@
 import { define, type DepBuilder, type GizmoStatic, type LogGizmo } from '@just-web/app'
-import type { Fetch } from '@just-web/fetch'
+import { type Fetch, type FetchGizmo } from '@just-web/fetch'
 import { ctx } from './browser_gizmo.ctx.js'
 import { createErrorStore, toReadonlyErrorStore } from './error_store.js'
 import type { ReadonlyErrorStore } from './error_store.types.js'
 import { BrowserError } from './errors.js'
 
-export type { Fetch }
+export type { Fetch, FetchGizmo }
 
 export interface BrowserGizmoOptions {
 	/**
 	 * Prevents the default event handler of `onerror` to be fired.
 	 * @see https://developer.mozilla.org/en-US/docs/Web/API/GlobalEventHandlers/onerror
 	 */
 	preventDefault?: boolean
+	/**
+	 * Custom fetch instance
+	 */
+	fetch?: Fetch
 }
 
 export const browserGizmoFn: (options?: BrowserGizmoOptions) => GizmoStatic<
@@ -31,10 +35,10 @@ export const browserGizmoFn: (options?: BrowserGizmoOptions) => GizmoStatic<
 		() => () => void
 	]
 > = define((options?: BrowserGizmoOptions) => ({
-	static: define.require<LogGizmo>(),
-	async create({ log }) {
+	static: define.require<LogGizmo>().optional<FetchGizmo>(),
+	async create(gizmoCtx) {
 		const errors = createErrorStore()
-		const logger = log.getLogger(`@just-web/browser`)
+		const logger = gizmoCtx.log.getLogger(`@just-web/browser`)
 		const preventDefault = options?.preventDefault ?? false
 
 		// Normally, gizmo should not do work during create.
@@ -60,7 +64,7 @@ export const browserGizmoFn: (options?: BrowserGizmoOptions) => GizmoStatic<
 					navigator,
 					location
 				},
-				fetch
+				fetch: options?.fetch ?? gizmoCtx.fetch ?? fetch
 			},
 			// This is no effect right now as `just-web` does not yet support clean up
 			() => () => ctx.removeEventListener('error', listener)