feat: extracted to standalone project

Author: coderbyheart

.github/workflows/test-and-release.yaml

@@ -0,0 +1,34 @@
+name: Test and Release
+
+on: push
+
+env:
+  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+permissions:
+  contents: write
+  issues: write
+  id-token: write
+
+jobs:
+  tests:
+    runs-on: ubuntu-24.04
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "22.x"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci --no-audit
+
+      - run: npm test
+
+      - name: Semantic release
+        continue-on-error: true
+        run: |
+          npm install -D @sebbo2002/semantic-release-jsr
+          npx semantic-release

.gitignore

@@ -0,0 +1 @@
+node_modules/

FetchImplementation.ts

@@ -0,0 +1,6 @@
+export type FetchImplementation = (
+	url: URL,
+	options?: Omit<RequestInit, 'headers'> & {
+		headers?: Record<string, string>
+	},
+) => Promise<Response>

LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, Nordic Semiconductor ASA | nordicsemi.no
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

README.md

@@ -0,0 +1,25 @@
+# `@nrfcloud/fetch-with-debug`
+
+<https://jsr.io/@nrfcloud/fetch-with-debug>
+
+Simple wrapper around fetch that logs request and response.
+
+## Install with NPM
+
+```bash
+npx jsr add --save-dev @nrfcloud/fetch-with-debug
+```
+
+## Usage
+
+```typescript
+import { fetchWithDebug } from "@bifravst/fetch-with-debug";
+
+const fetch = fetchWithDebug(
+  (type, details) => console.log("[My Service]", type, JSON.stringify(details)),
+  (args) => console.error("[My Service]", JSON.stringify(args)),
+  (args) => console.debug("[My Service]", JSON.stringify(args)),
+);
+
+const res = await fetch(new URL("https://example.com"));
+```

export.ts

@@ -0,0 +1,2 @@
+export * from './FetchImplementation.ts'
+export * from './fetchWithDebug.ts'

fetchWithDebug.spec.ts

@@ -0,0 +1,65 @@
+import nock from 'nock'
+import assert from 'node:assert'
+import { describe, it, mock } from 'node:test'
+import { fetchWithDebug } from './fetchWithDebug.ts'
+
+void describe('fetchWithDebug', (): void => {
+	void it('should debug a request', async () => {
+		const scope = nock('https://example.com').post('/foo').reply(
+			200,
+			{ foo: 'bar' },
+			{
+				'Content-Type': 'application/json',
+			},
+		)
+
+		const mockLog = mock.fn()
+		const mockError = mock.fn()
+		const mockBody = mock.fn()
+
+		const res = await fetchWithDebug(
+			mockLog,
+			mockError,
+			mockBody,
+		)(new URL('https://example.com/foo'), {
+			method: 'POST',
+			body: JSON.stringify({ bar: 'baz' }),
+			headers: {
+				'Content-Type': 'application/json',
+			},
+		})
+
+		assert.equal(res.status, 200)
+		assert.deepEqual(await res.json(), { foo: 'bar' })
+
+		const requestLog = mockLog.mock.calls.find(
+			(call) => call.arguments[0] === 'request',
+		)
+		const responseLog = mockLog.mock.calls.find(
+			(call) => call.arguments[0] === 'response',
+		)
+
+		assert.ok(requestLog)
+		assert.ok(responseLog)
+
+		assert.deepEqual(requestLog?.arguments[1], {
+			url: 'https://example.com/foo',
+			method: 'POST',
+			headers: {
+				'Content-Type': 'application/json',
+			},
+			body: JSON.stringify({ bar: 'baz' }),
+		})
+
+		assert.partialDeepStrictEqual(responseLog?.arguments[1], {
+			url: 'https://example.com/foo',
+			status: 200,
+			ok: true,
+			headers: {},
+		})
+
+		assert.deepEqual(mockBody.mock.calls[0]?.arguments[0], { foo: 'bar' })
+
+		assert.ok(scope.isDone())
+	})
+})

fetchWithDebug.ts

@@ -0,0 +1,99 @@
+import type { FetchImplementation } from './FetchImplementation.ts'
+
+export const fetchWithDebug: (
+	log?: (type: 'request' | 'response', details: any) => void,
+	error?: (details: any) => void,
+	body?: (body: any) => void,
+) => FetchImplementation =
+	(log = console.log, logError = console.error, body = console.debug) =>
+	async (url, options) => {
+		// Log request details
+		log('request', {
+			url: url.toString(),
+			method: options?.method ?? 'GET',
+			headers: options?.headers,
+			body: options?.body,
+			...(options?.signal !== undefined && { signal: 'AbortSignal provided' }),
+			...(options?.credentials !== undefined && {
+				credentials: options.credentials,
+			}),
+			...(options?.cache !== undefined && { cache: options.cache }),
+			...(options?.redirect !== undefined && { redirect: options.redirect }),
+			...(options?.referrer !== undefined && { referrer: options.referrer }),
+			...(options?.referrerPolicy !== undefined && {
+				referrerPolicy: options.referrerPolicy,
+			}),
+			...(options?.integrity !== undefined && { integrity: options.integrity }),
+			...(options?.keepalive !== undefined && { keepalive: options.keepalive }),
+			...(options?.mode !== undefined && { mode: options.mode }),
+		})
+
+		const startTime = Date.now()
+
+		try {
+			const response = await fetch(url, options)
+			const duration = Date.now() - startTime
+
+			// Log response details
+			log('response', {
+				url: url.toString(),
+				status: response.status,
+				statusText: response.statusText,
+				ok: response.ok,
+				headers: Object.fromEntries(response.headers.entries()),
+				duration: `${duration}ms`,
+				type: response.type,
+				redirected: response.redirected,
+				...(response.url !== url.toString() && { finalUrl: response.url }),
+			})
+
+			// eslint-disable-next-line @typescript-eslint/unbound-method
+			const originalTextBody = response.text
+			// eslint-disable-next-line @typescript-eslint/unbound-method
+			const originalJSONBody = response.json
+			// eslint-disable-next-line @typescript-eslint/unbound-method
+			const originalArrayBufferBody = response.arrayBuffer
+
+			response.text = async () => {
+				const textBody = await originalTextBody.call(response)
+				body(textBody)
+				return textBody
+			}
+
+			response.json = async () => {
+				const jsonBody = await originalJSONBody.call(response)
+				body(jsonBody)
+				return jsonBody
+			}
+
+			response.arrayBuffer = async () => {
+				const arrayBufferBody = await originalArrayBufferBody.call(response)
+				body(arrayBufferBody)
+				return arrayBufferBody
+			}
+
+			return response
+		} catch (error) {
+			const duration = Date.now() - startTime
+
+			// Log error details
+			logError({
+				url: url.toString(),
+				duration: `${duration}ms`,
+				error:
+					error instanceof Error
+						? {
+								name: error.name,
+								message: error.message,
+								...(error.cause !== undefined &&
+								typeof error.cause === 'object' &&
+								error.cause !== null
+									? { cause: error.cause }
+									: {}),
+							}
+						: error,
+			})
+
+			throw error
+		}
+	}

jsr.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://jsr.io/schema/config-file.v1.json",
+  "name": "@nrfcloud/fetch-with-debug",
+  "version": "0.0.0-development",
+  "license": "BSD-3-Clause",
+  "exports": "./export.ts"
+}