@routar/axios 0.1.0 → 1.0.0

package/README.md

@@ -8,4 +8,4 @@ Axios-based executor for [routar](https://github.com/kbmin1129/routar) — trans
 npm install @routar/core @routar/axios axios
 ```
 
-See the [main README](https://github.com/kbmin1129/routar) for full documentation.
+See the [documentation](https://routar.vercel.app) or the [main README](https://github.com/minr2kb/routar) for full documentation.

package/dist/index.cjs

@@ -10,18 +10,23 @@ function resolveInstance(input) {
   return input();
 }
 function createAxiosExecutor(instanceOrFactory, options) {
-  return core.createExecutor(async ({ method, url, params, body, headers, signal }) => {
-    const instance = await resolveInstance(instanceOrFactory);
-    const { data } = await instance.request({
-      method,
-      url,
-      params,
-      data: body,
-      headers,
-      signal
-    });
-    return data;
-  }, options?.middlewares);
+  return core.createExecutor(
+    async ({ method, url, params, body, headers, signal }) => {
+      const instance = await resolveInstance(instanceOrFactory);
+      const base = (instance.defaults.baseURL ?? "").replace(/\/$/, "");
+      const { data } = await instance.request({
+        method,
+        url: base + url,
+        baseURL: "",
+        params,
+        data: body,
+        headers,
+        signal
+      });
+      return data;
+    },
+    options?.middlewares
+  );
 }
 
 exports.createAxiosExecutor = createAxiosExecutor;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/create-axios-executor.ts"],"names":["createExecutor"],"mappings":";;;;;AAwBA,SAAS,gBAAgB,KAAA,EAAkE;AAEzF,EAAA,IAAI,kBAAmB,KAAA,EAAkB;AACvC,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAQ,KAAA,EAA0B;AACpC;AA6BO,SAAS,mBAAA,CACd,mBACA,OAAA,EAGU;AACV,EAAA,OAAOA,mBAAA,CAAe,OAAO,EAAE,MAAA,EAAQ,KAAK,MAAA,EAAQ,IAAA,EAAM,OAAA,EAAS,MAAA,EAAO,KAAM;AAC9E,IAAA,MAAM,QAAA,GAAW,MAAM,eAAA,CAAgB,iBAAiB,CAAA;AACxD,IAAA,MAAM,EAAE,IAAA,EAAK,GAAI,MAAM,SAAS,OAAA,CAAQ;AAAA,MACtC,MAAA;AAAA,MACA,GAAA;AAAA,MACA,MAAA;AAAA,MACA,IAAA,EAAM,IAAA;AAAA,MACN,OAAA;AAAA,MACA;AAAA,KACD,CAAA;AACD,IAAA,OAAO,IAAA;AAAA,EACT,CAAA,EAAG,SAAS,WAAW,CAAA;AACzB","file":"index.cjs","sourcesContent":["import type { Executor, ExecutorMiddleware } from '@routar/core';\nimport { createExecutor } from '@routar/core';\nimport type { AxiosInstance } from 'axios';\n\n/** Zero-argument factory that returns an Axios instance (optionally async). */\ntype InstanceFactory = () => AxiosInstance | Promise<AxiosInstance>;\n\n/**\n * Accepted input for {@link createAxiosExecutor}.\n *\n * Pass a pre-configured `AxiosInstance` for CSR (the same instance is reused\n * across requests, which preserves interceptors and connection pooling).\n * Pass a factory function for SSR so a fresh instance — with per-request\n * headers or tokens — can be created on each call.\n */\nexport type InstanceOrFactory = AxiosInstance | InstanceFactory;\n\n/**\n * Discriminates between an `AxiosInstance` and a plain factory function.\n *\n * `AxiosInstance` is itself callable, so `typeof input === 'function'` cannot\n * distinguish the two. Duck-typing via `interceptors` works because Axios\n * always attaches it to instances, while user-supplied factories do not.\n */\nfunction resolveInstance(input: InstanceOrFactory): AxiosInstance | Promise<AxiosInstance> {\n  // AxiosInstance is callable but always has `interceptors`; plain factory functions do not.\n  if ('interceptors' in (input as object)) {\n    return input as AxiosInstance;\n  }\n  return (input as InstanceFactory)();\n}\n\n/**\n * Creates an {@link Executor} backed by Axios.\n *\n * Suited for CSR where a single shared `AxiosInstance` is preferred (fast,\n * interceptor-friendly). Also supports SSR via a factory that produces a\n * fresh instance per request, allowing dynamic per-request auth headers.\n *\n * Axios error objects (`AxiosError`) propagate unchanged through the executor\n * so you can inspect `err.response`, `err.code`, etc. in middleware or\n * callers — use `withRetry`'s `shouldRetry` option to skip retries on 4xx.\n *\n * @param instanceOrFactory - A pre-built `AxiosInstance` (CSR) or a factory\n *   function that returns one (SSR / per-request config).\n * @param options.middlewares - Middleware chain applied before the Axios call.\n *\n * @example\n * ```ts\n * // CSR — shared instance\n * const executor = createAxiosExecutor(axios.create({ baseURL: 'https://api.example.com' }));\n *\n * // SSR — factory\n * const executor = createAxiosExecutor(async () => {\n *   const token = await getServerToken();\n *   return axios.create({ baseURL: 'https://api.example.com', headers: { Authorization: `Bearer ${token}` } });\n * });\n * ```\n */\nexport function createAxiosExecutor(\n  instanceOrFactory: InstanceOrFactory,\n  options?: {\n    middlewares?: ExecutorMiddleware[];\n  },\n): Executor {\n  return createExecutor(async ({ method, url, params, body, headers, signal }) => {\n    const instance = await resolveInstance(instanceOrFactory);\n    const { data } = await instance.request({\n      method,\n      url,\n      params,\n      data: body,\n      headers,\n      signal,\n    });\n    return data;\n  }, options?.middlewares);\n}\n"]}
+{"version":3,"sources":["../src/create-axios-executor.ts"],"names":["createExecutor"],"mappings":";;;;;AAwBA,SAAS,gBACP,KAAA,EACwC;AAExC,EAAA,IAAI,kBAAmB,KAAA,EAAkB;AACvC,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAQ,KAAA,EAA0B;AACpC;AA6BO,SAAS,mBAAA,CACd,mBACA,OAAA,EAGU;AACV,EAAA,OAAOA,mBAAA;AAAA,IACL,OAAO,EAAE,MAAA,EAAQ,GAAA,EAAK,QAAQ,IAAA,EAAM,OAAA,EAAS,QAAO,KAAM;AACxD,MAAA,MAAM,QAAA,GAAW,MAAM,eAAA,CAAgB,iBAAiB,CAAA;AACxD,MAAA,MAAM,QAAQ,QAAA,CAAS,QAAA,CAAS,WAAW,EAAA,EAAI,OAAA,CAAQ,OAAO,EAAE,CAAA;AAChE,MAAA,MAAM,EAAE,IAAA,EAAK,GAAI,MAAM,SAAS,OAAA,CAAQ;AAAA,QACtC,MAAA;AAAA,QACA,KAAK,IAAA,GAAO,GAAA;AAAA,QACZ,OAAA,EAAS,EAAA;AAAA,QACT,MAAA;AAAA,QACA,IAAA,EAAM,IAAA;AAAA,QACN,OAAA;AAAA,QACA;AAAA,OACD,CAAA;AACD,MAAA,OAAO,IAAA;AAAA,IACT,CAAA;AAAA,IACA,OAAA,EAAS;AAAA,GACX;AACF","file":"index.cjs","sourcesContent":["import type { Executor, ExecutorMiddleware } from \"@routar/core\";\nimport { createExecutor } from \"@routar/core\";\nimport type { AxiosInstance } from \"axios\";\n\n/** Zero-argument factory that returns an Axios instance (optionally async). */\ntype InstanceFactory = () => AxiosInstance | Promise<AxiosInstance>;\n\n/**\n * Accepted input for {@link createAxiosExecutor}.\n *\n * Pass a pre-configured `AxiosInstance` for CSR (the same instance is reused\n * across requests, which preserves interceptors and connection pooling).\n * Pass a factory function for SSR so a fresh instance — with per-request\n * headers or tokens — can be created on each call.\n */\nexport type InstanceOrFactory = AxiosInstance | InstanceFactory;\n\n/**\n * Discriminates between an `AxiosInstance` and a plain factory function.\n *\n * `AxiosInstance` is itself callable, so `typeof input === 'function'` cannot\n * distinguish the two. Duck-typing via `interceptors` works because Axios\n * always attaches it to instances, while user-supplied factories do not.\n */\nfunction resolveInstance(\n  input: InstanceOrFactory,\n): AxiosInstance | Promise<AxiosInstance> {\n  // AxiosInstance is callable but always has `interceptors`; plain factory functions do not.\n  if (\"interceptors\" in (input as object)) {\n    return input as AxiosInstance;\n  }\n  return (input as InstanceFactory)();\n}\n\n/**\n * Creates an {@link Executor} backed by Axios.\n *\n * Suited for CSR where a single shared `AxiosInstance` is preferred (fast,\n * interceptor-friendly). Also supports SSR via a factory that produces a\n * fresh instance per request, allowing dynamic per-request auth headers.\n *\n * Axios error objects (`AxiosError`) propagate unchanged through the executor\n * so you can inspect `err.response`, `err.code`, etc. in middleware or\n * callers — use `withRetry`'s `shouldRetry` option to skip retries on 4xx.\n *\n * @param instanceOrFactory - A pre-built `AxiosInstance` (CSR) or a factory\n *   function that returns one (SSR / per-request config).\n * @param options.middlewares - Middleware chain applied before the Axios call.\n *\n * @example\n * ```ts\n * // CSR — shared instance\n * const executor = createAxiosExecutor(axios.create({ baseURL: 'https://api.example.com' }));\n *\n * // SSR — factory\n * const executor = createAxiosExecutor(async () => {\n *   const token = await getServerToken();\n *   return axios.create({ baseURL: 'https://api.example.com', headers: { Authorization: `Bearer ${token}` } });\n * });\n * ```\n */\nexport function createAxiosExecutor(\n  instanceOrFactory: InstanceOrFactory,\n  options?: {\n    middlewares?: ExecutorMiddleware[];\n  },\n): Executor {\n  return createExecutor(\n    async ({ method, url, params, body, headers, signal }) => {\n      const instance = await resolveInstance(instanceOrFactory);\n      const base = (instance.defaults.baseURL ?? \"\").replace(/\\/$/, \"\");\n      const { data } = await instance.request({\n        method,\n        url: base + url,\n        baseURL: \"\",\n        params,\n        data: body,\n        headers,\n        signal,\n      });\n      return data;\n    },\n    options?.middlewares,\n  );\n}\n"]}

package/dist/index.js

@@ -8,18 +8,23 @@ function resolveInstance(input) {
   return input();
 }
 function createAxiosExecutor(instanceOrFactory, options) {
-  return createExecutor(async ({ method, url, params, body, headers, signal }) => {
-    const instance = await resolveInstance(instanceOrFactory);
-    const { data } = await instance.request({
-      method,
-      url,
-      params,
-      data: body,
-      headers,
-      signal
-    });
-    return data;
-  }, options?.middlewares);
+  return createExecutor(
+    async ({ method, url, params, body, headers, signal }) => {
+      const instance = await resolveInstance(instanceOrFactory);
+      const base = (instance.defaults.baseURL ?? "").replace(/\/$/, "");
+      const { data } = await instance.request({
+        method,
+        url: base + url,
+        baseURL: "",
+        params,
+        data: body,
+        headers,
+        signal
+      });
+      return data;
+    },
+    options?.middlewares
+  );
 }
 
 export { createAxiosExecutor };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/create-axios-executor.ts"],"names":[],"mappings":";;;AAwBA,SAAS,gBAAgB,KAAA,EAAkE;AAEzF,EAAA,IAAI,kBAAmB,KAAA,EAAkB;AACvC,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAQ,KAAA,EAA0B;AACpC;AA6BO,SAAS,mBAAA,CACd,mBACA,OAAA,EAGU;AACV,EAAA,OAAO,cAAA,CAAe,OAAO,EAAE,MAAA,EAAQ,KAAK,MAAA,EAAQ,IAAA,EAAM,OAAA,EAAS,MAAA,EAAO,KAAM;AAC9E,IAAA,MAAM,QAAA,GAAW,MAAM,eAAA,CAAgB,iBAAiB,CAAA;AACxD,IAAA,MAAM,EAAE,IAAA,EAAK,GAAI,MAAM,SAAS,OAAA,CAAQ;AAAA,MACtC,MAAA;AAAA,MACA,GAAA;AAAA,MACA,MAAA;AAAA,MACA,IAAA,EAAM,IAAA;AAAA,MACN,OAAA;AAAA,MACA;AAAA,KACD,CAAA;AACD,IAAA,OAAO,IAAA;AAAA,EACT,CAAA,EAAG,SAAS,WAAW,CAAA;AACzB","file":"index.js","sourcesContent":["import type { Executor, ExecutorMiddleware } from '@routar/core';\nimport { createExecutor } from '@routar/core';\nimport type { AxiosInstance } from 'axios';\n\n/** Zero-argument factory that returns an Axios instance (optionally async). */\ntype InstanceFactory = () => AxiosInstance | Promise<AxiosInstance>;\n\n/**\n * Accepted input for {@link createAxiosExecutor}.\n *\n * Pass a pre-configured `AxiosInstance` for CSR (the same instance is reused\n * across requests, which preserves interceptors and connection pooling).\n * Pass a factory function for SSR so a fresh instance — with per-request\n * headers or tokens — can be created on each call.\n */\nexport type InstanceOrFactory = AxiosInstance | InstanceFactory;\n\n/**\n * Discriminates between an `AxiosInstance` and a plain factory function.\n *\n * `AxiosInstance` is itself callable, so `typeof input === 'function'` cannot\n * distinguish the two. Duck-typing via `interceptors` works because Axios\n * always attaches it to instances, while user-supplied factories do not.\n */\nfunction resolveInstance(input: InstanceOrFactory): AxiosInstance | Promise<AxiosInstance> {\n  // AxiosInstance is callable but always has `interceptors`; plain factory functions do not.\n  if ('interceptors' in (input as object)) {\n    return input as AxiosInstance;\n  }\n  return (input as InstanceFactory)();\n}\n\n/**\n * Creates an {@link Executor} backed by Axios.\n *\n * Suited for CSR where a single shared `AxiosInstance` is preferred (fast,\n * interceptor-friendly). Also supports SSR via a factory that produces a\n * fresh instance per request, allowing dynamic per-request auth headers.\n *\n * Axios error objects (`AxiosError`) propagate unchanged through the executor\n * so you can inspect `err.response`, `err.code`, etc. in middleware or\n * callers — use `withRetry`'s `shouldRetry` option to skip retries on 4xx.\n *\n * @param instanceOrFactory - A pre-built `AxiosInstance` (CSR) or a factory\n *   function that returns one (SSR / per-request config).\n * @param options.middlewares - Middleware chain applied before the Axios call.\n *\n * @example\n * ```ts\n * // CSR — shared instance\n * const executor = createAxiosExecutor(axios.create({ baseURL: 'https://api.example.com' }));\n *\n * // SSR — factory\n * const executor = createAxiosExecutor(async () => {\n *   const token = await getServerToken();\n *   return axios.create({ baseURL: 'https://api.example.com', headers: { Authorization: `Bearer ${token}` } });\n * });\n * ```\n */\nexport function createAxiosExecutor(\n  instanceOrFactory: InstanceOrFactory,\n  options?: {\n    middlewares?: ExecutorMiddleware[];\n  },\n): Executor {\n  return createExecutor(async ({ method, url, params, body, headers, signal }) => {\n    const instance = await resolveInstance(instanceOrFactory);\n    const { data } = await instance.request({\n      method,\n      url,\n      params,\n      data: body,\n      headers,\n      signal,\n    });\n    return data;\n  }, options?.middlewares);\n}\n"]}
+{"version":3,"sources":["../src/create-axios-executor.ts"],"names":[],"mappings":";;;AAwBA,SAAS,gBACP,KAAA,EACwC;AAExC,EAAA,IAAI,kBAAmB,KAAA,EAAkB;AACvC,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAQ,KAAA,EAA0B;AACpC;AA6BO,SAAS,mBAAA,CACd,mBACA,OAAA,EAGU;AACV,EAAA,OAAO,cAAA;AAAA,IACL,OAAO,EAAE,MAAA,EAAQ,GAAA,EAAK,QAAQ,IAAA,EAAM,OAAA,EAAS,QAAO,KAAM;AACxD,MAAA,MAAM,QAAA,GAAW,MAAM,eAAA,CAAgB,iBAAiB,CAAA;AACxD,MAAA,MAAM,QAAQ,QAAA,CAAS,QAAA,CAAS,WAAW,EAAA,EAAI,OAAA,CAAQ,OAAO,EAAE,CAAA;AAChE,MAAA,MAAM,EAAE,IAAA,EAAK,GAAI,MAAM,SAAS,OAAA,CAAQ;AAAA,QACtC,MAAA;AAAA,QACA,KAAK,IAAA,GAAO,GAAA;AAAA,QACZ,OAAA,EAAS,EAAA;AAAA,QACT,MAAA;AAAA,QACA,IAAA,EAAM,IAAA;AAAA,QACN,OAAA;AAAA,QACA;AAAA,OACD,CAAA;AACD,MAAA,OAAO,IAAA;AAAA,IACT,CAAA;AAAA,IACA,OAAA,EAAS;AAAA,GACX;AACF","file":"index.js","sourcesContent":["import type { Executor, ExecutorMiddleware } from \"@routar/core\";\nimport { createExecutor } from \"@routar/core\";\nimport type { AxiosInstance } from \"axios\";\n\n/** Zero-argument factory that returns an Axios instance (optionally async). */\ntype InstanceFactory = () => AxiosInstance | Promise<AxiosInstance>;\n\n/**\n * Accepted input for {@link createAxiosExecutor}.\n *\n * Pass a pre-configured `AxiosInstance` for CSR (the same instance is reused\n * across requests, which preserves interceptors and connection pooling).\n * Pass a factory function for SSR so a fresh instance — with per-request\n * headers or tokens — can be created on each call.\n */\nexport type InstanceOrFactory = AxiosInstance | InstanceFactory;\n\n/**\n * Discriminates between an `AxiosInstance` and a plain factory function.\n *\n * `AxiosInstance` is itself callable, so `typeof input === 'function'` cannot\n * distinguish the two. Duck-typing via `interceptors` works because Axios\n * always attaches it to instances, while user-supplied factories do not.\n */\nfunction resolveInstance(\n  input: InstanceOrFactory,\n): AxiosInstance | Promise<AxiosInstance> {\n  // AxiosInstance is callable but always has `interceptors`; plain factory functions do not.\n  if (\"interceptors\" in (input as object)) {\n    return input as AxiosInstance;\n  }\n  return (input as InstanceFactory)();\n}\n\n/**\n * Creates an {@link Executor} backed by Axios.\n *\n * Suited for CSR where a single shared `AxiosInstance` is preferred (fast,\n * interceptor-friendly). Also supports SSR via a factory that produces a\n * fresh instance per request, allowing dynamic per-request auth headers.\n *\n * Axios error objects (`AxiosError`) propagate unchanged through the executor\n * so you can inspect `err.response`, `err.code`, etc. in middleware or\n * callers — use `withRetry`'s `shouldRetry` option to skip retries on 4xx.\n *\n * @param instanceOrFactory - A pre-built `AxiosInstance` (CSR) or a factory\n *   function that returns one (SSR / per-request config).\n * @param options.middlewares - Middleware chain applied before the Axios call.\n *\n * @example\n * ```ts\n * // CSR — shared instance\n * const executor = createAxiosExecutor(axios.create({ baseURL: 'https://api.example.com' }));\n *\n * // SSR — factory\n * const executor = createAxiosExecutor(async () => {\n *   const token = await getServerToken();\n *   return axios.create({ baseURL: 'https://api.example.com', headers: { Authorization: `Bearer ${token}` } });\n * });\n * ```\n */\nexport function createAxiosExecutor(\n  instanceOrFactory: InstanceOrFactory,\n  options?: {\n    middlewares?: ExecutorMiddleware[];\n  },\n): Executor {\n  return createExecutor(\n    async ({ method, url, params, body, headers, signal }) => {\n      const instance = await resolveInstance(instanceOrFactory);\n      const base = (instance.defaults.baseURL ?? \"\").replace(/\\/$/, \"\");\n      const { data } = await instance.request({\n        method,\n        url: base + url,\n        baseURL: \"\",\n        params,\n        data: body,\n        headers,\n        signal,\n      });\n      return data;\n    },\n    options?.middlewares,\n  );\n}\n"]}

package/package.json

@@ -1,8 +1,15 @@
 {
   "name": "@routar/axios",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "Axios-based executor for routar — transport adapter using Axios",
-  "keywords": ["api", "http", "typescript", "axios", "routar", "executor"],
+  "keywords": [
+    "api",
+    "http",
+    "typescript",
+    "axios",
+    "routar",
+    "executor"
+  ],
   "author": "Kyungbae Min",
   "license": "MIT",
   "repository": {
@@ -22,14 +29,18 @@
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "files": ["dist", "README.md", "LICENSE"],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch"
   },
   "peerDependencies": {
     "axios": ">=1.0.0",
-    "@routar/core": "^0.1.0"
+    "@routar/core": "^1.0.0"
   },
   "devDependencies": {
     "@routar/core": "workspace:*",
@@ -37,5 +48,7 @@
     "tsup": "^8.0.0",
     "typescript": "^6.0.0"
   },
-  "publishConfig": { "access": "public" }
+  "publishConfig": {
+    "access": "public"
+  }
 }