@routar/fetch 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/dist/index.cjs +29 -24
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +29 -24
- package/dist/index.js.map +1 -1
- package/package.json +17 -4
package/README.md
CHANGED
|
@@ -8,4 +8,4 @@ Fetch-based executor for [routar](https://github.com/kbmin1129/routar) — trans
|
|
|
8
8
|
npm install @routar/core @routar/fetch
|
|
9
9
|
```
|
|
10
10
|
|
|
11
|
-
See the [main README](https://github.com/
|
|
11
|
+
See the [documentation](https://routar.vercel.app) or the [main README](https://github.com/minr2kb/routar) for full documentation.
|
package/dist/index.cjs
CHANGED
|
@@ -4,30 +4,35 @@ var core = require('@routar/core');
|
|
|
4
4
|
|
|
5
5
|
// src/create-fetch-executor.ts
|
|
6
6
|
function createFetchExecutor(baseURL, options) {
|
|
7
|
-
return core.createExecutor(
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
7
|
+
return core.createExecutor(
|
|
8
|
+
async ({ method, url, params, body, headers, signal }) => {
|
|
9
|
+
const fullURL = new URL(baseURL.replace(/\/$/, "") + url);
|
|
10
|
+
if (params) {
|
|
11
|
+
core.serializeParams(params).forEach(
|
|
12
|
+
(v, k) => fullURL.searchParams.set(k, v)
|
|
13
|
+
);
|
|
14
|
+
}
|
|
15
|
+
const defaultHeaders = await options?.defaultHeaders?.() ?? {};
|
|
16
|
+
const res = await fetch(fullURL.toString(), {
|
|
17
|
+
method,
|
|
18
|
+
headers: {
|
|
19
|
+
...body != null ? { "Content-Type": "application/json" } : {},
|
|
20
|
+
...defaultHeaders,
|
|
21
|
+
...headers
|
|
22
|
+
},
|
|
23
|
+
body: body != null ? JSON.stringify(body) : void 0,
|
|
24
|
+
signal
|
|
25
|
+
});
|
|
26
|
+
if (!res.ok) {
|
|
27
|
+
throw new HttpError(res.status, res.statusText);
|
|
28
|
+
}
|
|
29
|
+
if (res.status === 204 || res.headers.get("content-length") === "0") {
|
|
30
|
+
return null;
|
|
31
|
+
}
|
|
32
|
+
return res.json();
|
|
33
|
+
},
|
|
34
|
+
options?.middlewares
|
|
35
|
+
);
|
|
31
36
|
}
|
|
32
37
|
var HttpError = class extends Error {
|
|
33
38
|
constructor(status, statusText) {
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/create-fetch-executor.ts"],"names":["createExecutor","serializeParams"],"mappings":";;;;;AA8BO,SAAS,mBAAA,CACd,SACA,OAAA,
|
|
1
|
+
{"version":3,"sources":["../src/create-fetch-executor.ts"],"names":["createExecutor","serializeParams"],"mappings":";;;;;AA8BO,SAAS,mBAAA,CACd,SACA,OAAA,EAMU;AACV,EAAA,OAAOA,mBAAA;AAAA,IACL,OAAO,EAAE,MAAA,EAAQ,GAAA,EAAK,QAAQ,IAAA,EAAM,OAAA,EAAS,QAAO,KAAM;AACxD,MAAA,MAAM,OAAA,GAAU,IAAI,GAAA,CAAI,OAAA,CAAQ,QAAQ,KAAA,EAAO,EAAE,IAAI,GAAG,CAAA;AACxD,MAAA,IAAI,MAAA,EAAQ;AACV,QAAAC,oBAAA,CAAgB,MAAM,CAAA,CAAE,OAAA;AAAA,UAAQ,CAAC,CAAA,EAAG,CAAA,KAClC,QAAQ,YAAA,CAAa,GAAA,CAAI,GAAG,CAAC;AAAA,SAC/B;AAAA,MACF;AAEA,MAAA,MAAM,cAAA,GAAkB,MAAM,OAAA,EAAS,cAAA,QAAuB,EAAC;AAE/D,MAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,OAAA,CAAQ,UAAS,EAAG;AAAA,QAC1C,MAAA;AAAA,QACA,OAAA,EAAS;AAAA,UACP,GAAI,IAAA,IAAQ,IAAA,GAAO,EAAE,cAAA,EAAgB,kBAAA,KAAuB,EAAC;AAAA,UAC7D,GAAG,cAAA;AAAA,UACH,GAAG;AAAA,SACL;AAAA,QACA,MAAM,IAAA,IAAQ,IAAA,GAAO,IAAA,CAAK,SAAA,CAAU,IAAI,CAAA,GAAI,MAAA;AAAA,QAC5C;AAAA,OACD,CAAA;AAED,MAAA,IAAI,CAAC,IAAI,EAAA,EAAI;AACX,QAAA,MAAM,IAAI,SAAA,CAAU,GAAA,CAAI,MAAA,EAAQ,IAAI,UAAU,CAAA;AAAA,MAChD;AACA,MAAA,IAAI,GAAA,CAAI,WAAW,GAAA,IAAO,GAAA,CAAI,QAAQ,GAAA,CAAI,gBAAgB,MAAM,GAAA,EAAK;AACnE,QAAA,OAAO,IAAA;AAAA,MACT;AACA,MAAA,OAAO,IAAI,IAAA,EAAK;AAAA,IAClB,CAAA;AAAA,IACA,OAAA,EAAS;AAAA,GACX;AACF;AAiBO,IAAM,SAAA,GAAN,cAAwB,KAAA,CAAM;AAAA,EACnC,WAAA,CAEkB,QAEA,UAAA,EAChB;AACA,IAAA,KAAA,CAAM,CAAA,KAAA,EAAQ,MAAM,CAAA,EAAA,EAAK,UAAU,CAAA,CAAE,CAAA;AAJrB,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAEA,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AAGhB,IAAA,IAAA,CAAK,IAAA,GAAO,WAAA;AAAA,EACd;AACF","file":"index.cjs","sourcesContent":["import type { Executor, ExecutorMiddleware } from \"@routar/core\";\nimport { createExecutor, serializeParams } from \"@routar/core\";\n\n/**\n * Creates an {@link Executor} backed by the browser / Node.js `fetch` API.\n *\n * Suited for SSR environments where you need per-request dynamic headers\n * (e.g. forwarding auth cookies) without sharing state across requests.\n *\n * - Query params are serialized and appended to the URL.\n * - A `Content-Type: application/json` header is added automatically when\n * a request body is present.\n * - Responses with status 204 or `Content-Length: 0` resolve to `null`.\n * - Non-2xx responses throw an {@link HttpError}.\n *\n * @param baseURL - Absolute base URL prepended to every endpoint path.\n * @param options.defaultHeaders - Async factory called on every request to\n * produce headers (e.g. reading cookies in a Next.js server component).\n * @param options.middlewares - Middleware chain applied before the fetch call.\n *\n * @example\n * ```ts\n * const executor = createFetchExecutor('https://api.example.com', {\n * defaultHeaders: async () => {\n * const token = await getServerToken();\n * return token ? { Authorization: `Bearer ${token}` } : {};\n * },\n * });\n * ```\n */\nexport function createFetchExecutor(\n baseURL: string,\n options?: {\n defaultHeaders?: () =>\n | Record<string, string>\n | Promise<Record<string, string>>;\n middlewares?: ExecutorMiddleware[];\n },\n): Executor {\n return createExecutor(\n async ({ method, url, params, body, headers, signal }) => {\n const fullURL = new URL(baseURL.replace(/\\/$/, '') + url);\n if (params) {\n serializeParams(params).forEach((v, k) =>\n fullURL.searchParams.set(k, v),\n );\n }\n\n const defaultHeaders = (await options?.defaultHeaders?.()) ?? {};\n\n const res = await fetch(fullURL.toString(), {\n method,\n headers: {\n ...(body != null ? { \"Content-Type\": \"application/json\" } : {}),\n ...defaultHeaders,\n ...headers,\n },\n body: body != null ? JSON.stringify(body) : undefined,\n signal,\n });\n\n if (!res.ok) {\n throw new HttpError(res.status, res.statusText);\n }\n if (res.status === 204 || res.headers.get(\"content-length\") === \"0\") {\n return null;\n }\n return res.json();\n },\n options?.middlewares,\n );\n}\n\n/**\n * Thrown by {@link createFetchExecutor} when the server returns a non-2xx\n * status code.\n *\n * @example\n * ```ts\n * try {\n * await api.getDetail({ path: { id: 999 } });\n * } catch (err) {\n * if (err instanceof HttpError && err.status === 404) {\n * // handle not-found\n * }\n * }\n * ```\n */\nexport class HttpError extends Error {\n constructor(\n /** HTTP status code (e.g. 404, 500). */\n public readonly status: number,\n /** HTTP status text (e.g. \"Not Found\"). */\n public readonly statusText: string,\n ) {\n super(`HTTP ${status}: ${statusText}`);\n this.name = \"HttpError\";\n }\n}\n"]}
|
package/dist/index.js
CHANGED
|
@@ -2,30 +2,35 @@ import { createExecutor, serializeParams } from '@routar/core';
|
|
|
2
2
|
|
|
3
3
|
// src/create-fetch-executor.ts
|
|
4
4
|
function createFetchExecutor(baseURL, options) {
|
|
5
|
-
return createExecutor(
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
5
|
+
return createExecutor(
|
|
6
|
+
async ({ method, url, params, body, headers, signal }) => {
|
|
7
|
+
const fullURL = new URL(baseURL.replace(/\/$/, "") + url);
|
|
8
|
+
if (params) {
|
|
9
|
+
serializeParams(params).forEach(
|
|
10
|
+
(v, k) => fullURL.searchParams.set(k, v)
|
|
11
|
+
);
|
|
12
|
+
}
|
|
13
|
+
const defaultHeaders = await options?.defaultHeaders?.() ?? {};
|
|
14
|
+
const res = await fetch(fullURL.toString(), {
|
|
15
|
+
method,
|
|
16
|
+
headers: {
|
|
17
|
+
...body != null ? { "Content-Type": "application/json" } : {},
|
|
18
|
+
...defaultHeaders,
|
|
19
|
+
...headers
|
|
20
|
+
},
|
|
21
|
+
body: body != null ? JSON.stringify(body) : void 0,
|
|
22
|
+
signal
|
|
23
|
+
});
|
|
24
|
+
if (!res.ok) {
|
|
25
|
+
throw new HttpError(res.status, res.statusText);
|
|
26
|
+
}
|
|
27
|
+
if (res.status === 204 || res.headers.get("content-length") === "0") {
|
|
28
|
+
return null;
|
|
29
|
+
}
|
|
30
|
+
return res.json();
|
|
31
|
+
},
|
|
32
|
+
options?.middlewares
|
|
33
|
+
);
|
|
29
34
|
}
|
|
30
35
|
var HttpError = class extends Error {
|
|
31
36
|
constructor(status, statusText) {
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/create-fetch-executor.ts"],"names":[],"mappings":";;;AA8BO,SAAS,mBAAA,CACd,SACA,OAAA,
|
|
1
|
+
{"version":3,"sources":["../src/create-fetch-executor.ts"],"names":[],"mappings":";;;AA8BO,SAAS,mBAAA,CACd,SACA,OAAA,EAMU;AACV,EAAA,OAAO,cAAA;AAAA,IACL,OAAO,EAAE,MAAA,EAAQ,GAAA,EAAK,QAAQ,IAAA,EAAM,OAAA,EAAS,QAAO,KAAM;AACxD,MAAA,MAAM,OAAA,GAAU,IAAI,GAAA,CAAI,OAAA,CAAQ,QAAQ,KAAA,EAAO,EAAE,IAAI,GAAG,CAAA;AACxD,MAAA,IAAI,MAAA,EAAQ;AACV,QAAA,eAAA,CAAgB,MAAM,CAAA,CAAE,OAAA;AAAA,UAAQ,CAAC,CAAA,EAAG,CAAA,KAClC,QAAQ,YAAA,CAAa,GAAA,CAAI,GAAG,CAAC;AAAA,SAC/B;AAAA,MACF;AAEA,MAAA,MAAM,cAAA,GAAkB,MAAM,OAAA,EAAS,cAAA,QAAuB,EAAC;AAE/D,MAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,OAAA,CAAQ,UAAS,EAAG;AAAA,QAC1C,MAAA;AAAA,QACA,OAAA,EAAS;AAAA,UACP,GAAI,IAAA,IAAQ,IAAA,GAAO,EAAE,cAAA,EAAgB,kBAAA,KAAuB,EAAC;AAAA,UAC7D,GAAG,cAAA;AAAA,UACH,GAAG;AAAA,SACL;AAAA,QACA,MAAM,IAAA,IAAQ,IAAA,GAAO,IAAA,CAAK,SAAA,CAAU,IAAI,CAAA,GAAI,MAAA;AAAA,QAC5C;AAAA,OACD,CAAA;AAED,MAAA,IAAI,CAAC,IAAI,EAAA,EAAI;AACX,QAAA,MAAM,IAAI,SAAA,CAAU,GAAA,CAAI,MAAA,EAAQ,IAAI,UAAU,CAAA;AAAA,MAChD;AACA,MAAA,IAAI,GAAA,CAAI,WAAW,GAAA,IAAO,GAAA,CAAI,QAAQ,GAAA,CAAI,gBAAgB,MAAM,GAAA,EAAK;AACnE,QAAA,OAAO,IAAA;AAAA,MACT;AACA,MAAA,OAAO,IAAI,IAAA,EAAK;AAAA,IAClB,CAAA;AAAA,IACA,OAAA,EAAS;AAAA,GACX;AACF;AAiBO,IAAM,SAAA,GAAN,cAAwB,KAAA,CAAM;AAAA,EACnC,WAAA,CAEkB,QAEA,UAAA,EAChB;AACA,IAAA,KAAA,CAAM,CAAA,KAAA,EAAQ,MAAM,CAAA,EAAA,EAAK,UAAU,CAAA,CAAE,CAAA;AAJrB,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAEA,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AAGhB,IAAA,IAAA,CAAK,IAAA,GAAO,WAAA;AAAA,EACd;AACF","file":"index.js","sourcesContent":["import type { Executor, ExecutorMiddleware } from \"@routar/core\";\nimport { createExecutor, serializeParams } from \"@routar/core\";\n\n/**\n * Creates an {@link Executor} backed by the browser / Node.js `fetch` API.\n *\n * Suited for SSR environments where you need per-request dynamic headers\n * (e.g. forwarding auth cookies) without sharing state across requests.\n *\n * - Query params are serialized and appended to the URL.\n * - A `Content-Type: application/json` header is added automatically when\n * a request body is present.\n * - Responses with status 204 or `Content-Length: 0` resolve to `null`.\n * - Non-2xx responses throw an {@link HttpError}.\n *\n * @param baseURL - Absolute base URL prepended to every endpoint path.\n * @param options.defaultHeaders - Async factory called on every request to\n * produce headers (e.g. reading cookies in a Next.js server component).\n * @param options.middlewares - Middleware chain applied before the fetch call.\n *\n * @example\n * ```ts\n * const executor = createFetchExecutor('https://api.example.com', {\n * defaultHeaders: async () => {\n * const token = await getServerToken();\n * return token ? { Authorization: `Bearer ${token}` } : {};\n * },\n * });\n * ```\n */\nexport function createFetchExecutor(\n baseURL: string,\n options?: {\n defaultHeaders?: () =>\n | Record<string, string>\n | Promise<Record<string, string>>;\n middlewares?: ExecutorMiddleware[];\n },\n): Executor {\n return createExecutor(\n async ({ method, url, params, body, headers, signal }) => {\n const fullURL = new URL(baseURL.replace(/\\/$/, '') + url);\n if (params) {\n serializeParams(params).forEach((v, k) =>\n fullURL.searchParams.set(k, v),\n );\n }\n\n const defaultHeaders = (await options?.defaultHeaders?.()) ?? {};\n\n const res = await fetch(fullURL.toString(), {\n method,\n headers: {\n ...(body != null ? { \"Content-Type\": \"application/json\" } : {}),\n ...defaultHeaders,\n ...headers,\n },\n body: body != null ? JSON.stringify(body) : undefined,\n signal,\n });\n\n if (!res.ok) {\n throw new HttpError(res.status, res.statusText);\n }\n if (res.status === 204 || res.headers.get(\"content-length\") === \"0\") {\n return null;\n }\n return res.json();\n },\n options?.middlewares,\n );\n}\n\n/**\n * Thrown by {@link createFetchExecutor} when the server returns a non-2xx\n * status code.\n *\n * @example\n * ```ts\n * try {\n * await api.getDetail({ path: { id: 999 } });\n * } catch (err) {\n * if (err instanceof HttpError && err.status === 404) {\n * // handle not-found\n * }\n * }\n * ```\n */\nexport class HttpError extends Error {\n constructor(\n /** HTTP status code (e.g. 404, 500). */\n public readonly status: number,\n /** HTTP status text (e.g. \"Not Found\"). */\n public readonly statusText: string,\n ) {\n super(`HTTP ${status}: ${statusText}`);\n this.name = \"HttpError\";\n }\n}\n"]}
|
package/package.json
CHANGED
|
@@ -1,8 +1,15 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@routar/fetch",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "Fetch-based executor for routar — transport adapter using the native fetch API",
|
|
5
|
-
"keywords": [
|
|
5
|
+
"keywords": [
|
|
6
|
+
"api",
|
|
7
|
+
"http",
|
|
8
|
+
"typescript",
|
|
9
|
+
"fetch",
|
|
10
|
+
"routar",
|
|
11
|
+
"executor"
|
|
12
|
+
],
|
|
6
13
|
"author": "Kyungbae Min",
|
|
7
14
|
"license": "MIT",
|
|
8
15
|
"repository": {
|
|
@@ -22,7 +29,11 @@
|
|
|
22
29
|
"main": "./dist/index.cjs",
|
|
23
30
|
"module": "./dist/index.js",
|
|
24
31
|
"types": "./dist/index.d.ts",
|
|
25
|
-
"files": [
|
|
32
|
+
"files": [
|
|
33
|
+
"dist",
|
|
34
|
+
"README.md",
|
|
35
|
+
"LICENSE"
|
|
36
|
+
],
|
|
26
37
|
"scripts": {
|
|
27
38
|
"build": "tsup",
|
|
28
39
|
"dev": "tsup --watch"
|
|
@@ -34,5 +45,7 @@
|
|
|
34
45
|
"@routar/core": "workspace:*",
|
|
35
46
|
"tsup": "^8.5.1"
|
|
36
47
|
},
|
|
37
|
-
"publishConfig": {
|
|
48
|
+
"publishConfig": {
|
|
49
|
+
"access": "public"
|
|
50
|
+
}
|
|
38
51
|
}
|