service-creator 0.1.3 → 0.3.0

package/README.md

@@ -1,6 +1,12 @@
+
+[![NPM Version](https://img.shields.io/npm/v/service-creator.svg)](https://www.npmjs.com/package/service-creator)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI](https://github.com/royriojas/create-service/actions/workflows/ci.yml/badge.svg)](https://github.com/royriojas/create-service/actions/workflows/ci.yml)
+
+
 # service-creator
 
-A simple abstraction to create "services", plain objects that can be used to perform fetch calls in a convention over configuration fashion.
+A simple abstraction to create "services" — plain objects with typed async methods that perform fetch calls, using convention over configuration.
 
 ## Installation
 
@@ -10,9 +16,15 @@ npm install service-creator
 
 ## Usage
 
-```js
-import { createService } from 'service-creator';
-import { v4 as uuid } from 'uuid';
+Define your service endpoints with `createEndpoint<TResponse, TArgs?>()` for full type safety:
+
+```ts
+import { createService, createEndpoint } from 'service-creator';
+
+interface User {
+  id: string;
+  name: string;
+}
 
 const fetcher = {
   fetch: async (url, opts) => {
@@ -21,47 +33,109 @@ const fetcher = {
   },
 };
 
-// defining the interface of the service is helpful to have good typings
-// service methods are async functions that return a promise that resolves to the response
-// expected to be received from the fetch/xhr calls
-export interface PPService {
-  getSomeData: (prompt: string) => Promise<SomeData[]>;
-  getDataById: (id: string) => Promise<SomeData>; 
+const userService = createService({
+  endpoints: {
+    // No args — just one generic for the response type
+    listUsers: createEndpoint<User[]>({
+      url: '/v1/users',
+    }),
+
+    // With args — response type first, then args type
+    getUser: createEndpoint<User, { id: string }>({
+      url: ({ id }) => `/v1/users/${id}`,
+    }),
+
+    // POST with body
+    createUser: createEndpoint<User, { name: string }>({
+      url: '/v1/users',
+      method: 'POST',
+      body: (args) => args, // args is typed as { name: string }
+    }),
+
+    // Response transformation
+    getUserName: createEndpoint<string, { id: string }>({
+      url: ({ id }) => `/v1/users/${id}`,
+      transform: (data) => data.name, // raw response → typed return value
+    }),
+  },
+  basePath: 'https://api.example.com',
+  fetcher,
+});
+
+// All types are fully inferred:
+const users = await userService.listUsers();                  // User[]
+const user = await userService.getUser({ id: '123' });        // User
+const created = await userService.createUser({ name: 'Ali' });// User
+const name = await userService.getUserName({ id: '123' });    // string
+```
+
+### `createEndpoint<TResponse, TArgs?, TError?>`
+
+| Generic | Description | Default |
+|---|---|---|
+| `TResponse` | Return type (`Promise<TResponse>`) | `any` |
+| `TArgs` | Input parameter type. Omit for no-arg endpoints. | `void` |
+| `TError` | Error type (available via `InferError`) | `Error` |
+
+### Descriptor options
+
+| Option | Type | Description |
+|---|---|---|
+| `url` | `string \| (args: TArgs) => string` | Endpoint URL — static or dynamic |
+| `method` | `HttpMethod` | HTTP method (`GET`, `POST`, `PUT`, `DELETE`, etc.) |
+| `body` | `object \| (args: TArgs) => any` | Request body — static or computed from args |
+| `headers` | `object \| (args: TArgs) => any` | Request headers — static or computed from args |
+| `params` | `object \| (args: TArgs) => any` | Query string params — static or computed from args |
+| `fetchOpts` | `FetchOptions` | Additional fetch options (credentials, mode, etc.) |
+| `transform` | `(data: any) => TResponse` | Transform the raw response before returning |
+
+### Custom error types
+
+```ts
+interface ApiError {
+  code: number;
+  message: string;
 }
 
-const commonHeadersFn = () => {
-  const appCtx = getCtx();
+const service = createService({
+  endpoints: {
+    riskyCall: createEndpoint<Data, { id: string }, ApiError>({
+      url: ({ id }) => `/v1/data/${id}`,
+    }),
+  },
+  fetcher,
+});
+```
 
-  return {
-    'x-req-id': uuid(),
-  };
-};
+## Alternative styles
+
+Plain descriptors (types inferred from function signatures):
 
+```ts
 const service = createService({
   endpoints: {
-    getSomeData: {
-      method: 'GET',
-      url: '/v1/get-some-data',
-      body: ({ prompt }) => ({ prompt }),
-      headers: commonHeadersFn,
-    },
-    getDataById: {
-      method: 'GET',
-      headers: commonHeadersFn,
-      url: ({ id }) => `/v1/get-some-data-by-id/${id}`, 
+    getUser: {
+      url: (id: string) => `/v1/users/${id}`,
+      transform: (data: any): User => data,
     },
   },
-  basePath: api,  
   fetcher,
 });
+```
 
-const data = await service.getSomeData({ prompt: 'hello world' });
-
-console.log(data); // expected an array of SomeData
+Legacy explicit interface:
 
-const dataById = await service.getDataById({ id: '1' });
+```ts
+interface MyService {
+  getUser: (id: string) => Promise<User>;
+}
 
-console.log(dataById); // expected a single SomeData
+const service = createService<MyService>({
+  endpoints: {
+    getUser: { url: (id: string) => `/v1/users/${id}` },
+  },
+  fetcher,
+});
 ```
 
 ## License

package/dist/__tests__/create-service.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/create-service.d.ts

@@ -1,4 +1,5 @@
 import { Fetcher, FetchOptions } from './fetch-types';
+
 export interface Fn<T extends Array<any>> {
     (...args: T): string;
 }
@@ -7,18 +8,102 @@ export type StringOrFn<T extends ServiceFn> = string | Fn<Parameters<T>>;
 export type ObjectOrFn<T extends ServiceFn> = object | Fn<Parameters<T>>;
 export interface Descriptor<K extends ServiceFn> {
     url: StringOrFn<K>;
-    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS' | 'TRACE' | 'CONNECT';
+    method?: HttpMethod;
     body?: ObjectOrFn<K>;
     headers?: ObjectOrFn<K>;
     params?: ObjectOrFn<K>;
     fetchOpts?: FetchOptions;
+    transform?: (data: any) => any;
 }
 export type ServiceDescriptor<T> = {
     [K in keyof T]: Descriptor<T[K] extends ServiceFn ? T[K] : never>;
 };
 export interface CreateServiceArgs<T> {
     endpoints: ServiceDescriptor<T>;
-    basePath: string | undefined;
+    basePath?: string;
     fetcher: Fetcher;
 }
-export declare const createService: <T>({ endpoints, basePath, fetcher }: CreateServiceArgs<T>) => T;
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS' | 'TRACE' | 'CONNECT';
+export interface DescriptorBase {
+    url: string | ((...args: any[]) => string);
+    method?: HttpMethod;
+    body?: object | ((...args: any[]) => any);
+    headers?: object | ((...args: any[]) => any);
+    params?: object | ((...args: any[]) => any);
+    fetchOpts?: FetchOptions;
+    transform?: (data: any) => any;
+}
+/** A descriptor branded with explicit TResponse, TArgs, TError types */
+export interface TypedEndpoint<TResponse = any, TArgs = void, TError = Error> extends DescriptorBase {
+    readonly [ENDPOINT_TYPES]: {
+        args: TArgs;
+        response: TResponse;
+        error: TError;
+    };
+}
+/** Configuration accepted by createEndpoint */
+export interface EndpointConfig<TResponse, TArgs> {
+    url: string | ((args: TArgs) => string);
+    method?: HttpMethod;
+    body?: object | ((args: TArgs) => any);
+    headers?: object | ((args: TArgs) => any);
+    params?: object | ((args: TArgs) => any);
+    fetchOpts?: FetchOptions;
+    transform?: (data: any) => TResponse;
+}
+/**
+ * Define a typed endpoint with explicit response/input/error types.
+ *
+ * @example
+ * ```ts
+ * // No args:
+ * createEndpoint<User[]>({ url: '/users' })
+ * // service method: () => Promise<User[]>
+ *
+ * // With args:
+ * createEndpoint<User, { id: string }>({
+ *   url: ({ id }) => `/users/${id}`,
+ * })
+ * // service method: (args: { id: string }) => Promise<User>
+ * ```
+ */
+export declare function createEndpoint<TResponse = any, TArgs = void, TError = Error>(config: EndpointConfig<TResponse, TArgs>): TypedEndpoint<TResponse, TArgs, TError>;
+/** Infer the service method args from a descriptor */
+export type InferArgs<D> = D extends {
+    readonly [ENDPOINT_TYPES]: {
+        args: infer A;
+    };
+} ? [A] extends [void] ? [] : [args: A] : D extends {
+    url: (...args: infer P) => any;
+} ? P : D extends {
+    body: (...args: infer P) => any;
+} ? P : D extends {
+    params: (...args: infer P) => any;
+} ? P : D extends {
+    headers: (...args: infer P) => any;
+} ? P : any[];
+/** Infer the service method return type from a descriptor */
+export type InferReturn<D> = D extends {
+    readonly [ENDPOINT_TYPES]: {
+        response: infer R;
+    };
+} ? R : D extends {
+    transform: (data: any) => infer R;
+} ? R : any;
+/** Infer the error type from a branded descriptor */
+export type InferError<D> = D extends {
+    readonly [ENDPOINT_TYPES]: {
+        error: infer E;
+    };
+} ? E : Error;
+export type InferService<T extends Record<string, DescriptorBase>> = {
+    [K in keyof T]: (...args: InferArgs<T[K]>) => Promise<InferReturn<T[K]>>;
+};
+/** Create a service with types inferred from the endpoint descriptors */
+export declare function createService<const T extends Record<string, DescriptorBase>>(args: {
+    endpoints: T;
+    basePath?: string;
+    fetcher: Fetcher;
+}): InferService<T>;
+/** @deprecated Use the inferred API (call without explicit generic) */
+export declare function createService<T>(args: CreateServiceArgs<T>): T;

package/dist/fetch-types.d.ts

@@ -1,4 +1,5 @@
 import { FetchFn } from './fetchJSON';
+
 export type FetchJSONArgs = Parameters<typeof fetch>;
 export type FetchURL = FetchJSONArgs[0];
 export type FetchOptions = Exclude<FetchJSONArgs[1], null | undefined>;

package/dist/fetchJSON.d.ts

@@ -1,4 +1,5 @@
 import { FetchURL, SerializeBodyProps } from './fetch-types';
+
 export interface ErrorData {
     error: string;
 }

package/dist/index.js

@@ -1,110 +1,131 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-
-var _createService = require("./create-service");
-
-Object.keys(_createService).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (key in exports && exports[key] === _createService[key]) return;
-  Object.defineProperty(exports, key, {
-    enumerable: true,
-    get: function get() {
-      return _createService[key];
-    }
-  });
-});
-
-var _fetchTypes = require("./fetch-types");
-
-Object.keys(_fetchTypes).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (key in exports && exports[key] === _fetchTypes[key]) return;
-  Object.defineProperty(exports, key, {
-    enumerable: true,
-    get: function get() {
-      return _fetchTypes[key];
-    }
+var b = Object.defineProperty;
+var R = (e, t, r) => t in e ? b(e, t, { enumerable: !0, configurable: !0, writable: !0, value: r }) : e[t] = r;
+var y = (e, t, r) => (R(e, typeof t != "symbol" ? t + "" : t, r), r);
+const P = (e, t) => (e = e.replace(/\/$/, ""), t = t.replace(/^\//, ""), `${e}/${t}`), O = (e, t) => {
+  const r = t ?? new URLSearchParams();
+  return Object.keys(e).forEach((a) => {
+    const n = e[a];
+    typeof n < "u" && (Array.isArray(n) ? n.forEach((s) => {
+      r.append(a, s);
+    }) : r.set(a, `${n}`));
+  }), r;
+}, U = (e, t) => {
+  const [r, c] = e.split(/\?/), a = new URLSearchParams(c), n = O(t, a), s = [r], o = n.toString();
+  return o.length > 0 && s.push(`?${o}`), s.join("");
+}, L = (e, t) => {
+  const [r, c] = e.split(/\?/), a = new URLSearchParams(c);
+  t.forEach((o) => {
+    a.delete(o);
   });
-});
-
-var _fetchJSON = require("./fetchJSON");
-
-Object.keys(_fetchJSON).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (key in exports && exports[key] === _fetchJSON[key]) return;
-  Object.defineProperty(exports, key, {
-    enumerable: true,
-    get: function get() {
-      return _fetchJSON[key];
+  const n = [r], s = a.toString();
+  return s.length > 0 && n.push(`?${s}`), n.join("");
+}, v = (e = []) => e.length > 0 ? e[0] : void 0, d = async (e, ...t) => {
+  try {
+    return await e(...t);
+  } catch {
+    const c = e ? e.name : "anonymous";
+    console.warn(`[CreateService Error] ${c} failed with args:`, t);
+    return;
+  }
+};
+function C(e) {
+  return e;
+}
+function D({ endpoints: e, basePath: t, fetcher: r }) {
+  return Object.keys(e).reduce((c, a) => (c[a] = async (...n) => {
+    const { url: s, body: o, headers: i, method: u, params: f, fetchOpts: l, transform: w } = e[a];
+    let h = typeof s == "function" ? await d(s, ...n) : s;
+    if (typeof h != "string")
+      throw console.error(
+        "[Create Service Error]: URL must be a string or a function returning a string",
+        h
+      ), new Error(
+        `URL must be a string or a function returning a string for method ${a}.`
+      );
+    t && (h = P(t, h));
+    const S = typeof o == "function" ? await d(o, ...n) : u !== "GET" ? v(n) : void 0, g = typeof i == "function" ? await d(i, ...n) : i, m = typeof f == "function" ? await d(f, ...n) : f, E = { ...l || {}, body: S, headers: g, method: u };
+    m && (h = U(h, m));
+    const p = await r.fetch(h, E);
+    return w ? w(p) : p;
+  }, c), {});
+}
+class I extends Error {
+  constructor() {
+    super(...arguments);
+    y(this, "response");
+    y(this, "data");
+  }
+}
+async function J(e, t) {
+  const { serializeBody: r = !0, method: c, ...a } = t || {}, n = c ?? "GET", s = {
+    ...a,
+    method: n,
+    headers: {
+      "Content-type": "application/json",
+      ...a.headers
+    },
+    body: n === "GET" ? void 0 : r ? JSON.stringify(t == null ? void 0 : t.body) : t == null ? void 0 : t.body
+  };
+  try {
+    const o = await fetch(e, s);
+    if (o.status < 200 || o.status > 300) {
+      let u;
+      try {
+        u = await o.json();
+      } catch {
+        u = { error: "JSON_ERROR_NOT_RECEIVED" };
+      }
+      const f = new I(u.error);
+      throw f.response = o, f.data = u, f;
     }
-  });
-});
-
-var _withRetries = require("./withRetries");
-
-Object.keys(_withRetries).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (key in exports && exports[key] === _withRetries[key]) return;
-  Object.defineProperty(exports, key, {
-    enumerable: true,
-    get: function get() {
-      return _withRetries[key];
+    return await o.json();
+  } catch (o) {
+    throw console.error(">>> err", o), o;
+  }
+}
+const N = (e, { retries: t = 2, onTryError: r, onFail: c } = {}) => async (...n) => {
+  let s = 0;
+  for (; s < t; )
+    try {
+      return await e(...n);
+    } catch (o) {
+      if (s < t)
+        try {
+          await (r == null ? void 0 : r(o, n, s));
+        } catch (i) {
+          throw await (c == null ? void 0 : c(i, n)), i;
+        }
+      if (s += 1, s >= t)
+        throw await (c == null ? void 0 : c(o, n)), o;
     }
-  });
-});
-
-var _combinePathWithBase = require("./combinePathWithBase");
-
-Object.keys(_combinePathWithBase).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (key in exports && exports[key] === _combinePathWithBase[key]) return;
-  Object.defineProperty(exports, key, {
-    enumerable: true,
-    get: function get() {
-      return _combinePathWithBase[key];
-    }
-  });
-});
-
-var _urlHelpers = require("./url-helpers");
-
-Object.keys(_urlHelpers).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (key in exports && exports[key] === _urlHelpers[key]) return;
-  Object.defineProperty(exports, key, {
-    enumerable: true,
-    get: function get() {
-      return _urlHelpers[key];
-    }
-  });
-});
-
-var _tryParse = require("./try-parse");
-
-Object.keys(_tryParse).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (key in exports && exports[key] === _tryParse[key]) return;
-  Object.defineProperty(exports, key, {
-    enumerable: true,
-    get: function get() {
-      return _tryParse[key];
-    }
-  });
-});
-
-var _ls = require("./ls");
-
-Object.keys(_ls).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (key in exports && exports[key] === _ls[key]) return;
-  Object.defineProperty(exports, key, {
-    enumerable: true,
-    get: function get() {
-      return _ls[key];
-    }
-  });
-});
-//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7QUFBQTs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTs7QUFDQTs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTs7QUFDQTs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTs7QUFDQTs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTs7QUFDQTs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTs7QUFDQTs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTs7QUFDQTs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTs7QUFDQTs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSIsInNvdXJjZXNDb250ZW50IjpbImV4cG9ydCAqIGZyb20gJy4vY3JlYXRlLXNlcnZpY2UnO1xuZXhwb3J0ICogZnJvbSAnLi9mZXRjaC10eXBlcyc7XG5leHBvcnQgKiBmcm9tICcuL2ZldGNoSlNPTic7XG5leHBvcnQgKiBmcm9tICcuL3dpdGhSZXRyaWVzJztcbmV4cG9ydCAqIGZyb20gJy4vY29tYmluZVBhdGhXaXRoQmFzZSc7XG5leHBvcnQgKiBmcm9tICcuL3VybC1oZWxwZXJzJztcbmV4cG9ydCAqIGZyb20gJy4vdHJ5LXBhcnNlJztcbmV4cG9ydCAqIGZyb20gJy4vbHMnO1xuIl19
+}, $ = (e, t) => {
+  try {
+    return JSON.parse(e);
+  } catch {
+    return t;
+  }
+}, A = (e, t) => {
+  const r = localStorage.getItem(e);
+  return $(r) ?? t;
+}, x = (e, t) => {
+  const r = JSON.stringify(t);
+  localStorage.setItem(e, r);
+}, G = (e) => {
+  localStorage.removeItem(e);
+};
+export {
+  I as ResponseError,
+  P as combinePathWithBase,
+  C as createEndpoint,
+  D as createService,
+  J as fetchJSON,
+  A as getItem,
+  O as paramsToURLSearchParams,
+  G as removeItem,
+  L as removeQueryParam,
+  x as setItem,
+  U as setQueryParams,
+  $ as tryParse,
+  N as withRetries
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/combinePathWithBase.ts","../src/url-helpers.ts","../src/create-service.ts","../src/fetchJSON.ts","../src/withRetries.ts","../src/try-parse.ts","../src/ls.ts"],"sourcesContent":["export const combinePathWithBase = (host: string, path: string) => {\n  host = host.replace(/\\/$/, '');\n  path = path.replace(/^\\//, '');\n  return `${host}/${path}`;\n};\n","export const paramsToURLSearchParams = <T extends object>(\n  params: T,\n  urlParams?: URLSearchParams,\n) => {\n  const urlSearchParams = urlParams ?? new URLSearchParams();\n\n  const keys = Object.keys(params);\n  keys.forEach((key) => {\n    const val = params[key as keyof T];\n    if (typeof val !== 'undefined') {\n      if (Array.isArray(val)) {\n        val.forEach((v) => {\n          urlSearchParams.append(key, v);\n        });\n      } else {\n        urlSearchParams.set(key, `${val}`);\n      }\n    }\n  });\n\n  return urlSearchParams;\n};\n\nexport const setQueryParams = <T extends object>(url: string, params: T) => {\n  const [baseString, searchString] = url.split(/\\?/);\n\n  const urlParams = new URLSearchParams(searchString);\n  const mergeParams = paramsToURLSearchParams(params, urlParams);\n\n  const parts = [baseString];\n\n  const paramsToAdd = mergeParams.toString();\n\n  if (paramsToAdd.length > 0) {\n    parts.push(`?${paramsToAdd}`);\n  }\n\n  return parts.join('');\n};\n\nexport const removeQueryParam = (url: string, params: string[]) => {\n  const [baseString, searchString] = url.split(/\\?/);\n\n  const urlParams = new URLSearchParams(searchString);\n\n  params.forEach((param) => {\n    urlParams.delete(param);\n  });\n\n  const parts = [baseString];\n\n  const paramsToAdd = urlParams.toString();\n\n  if (paramsToAdd.length > 0) {\n    parts.push(`?${paramsToAdd}`);\n  }\n\n  return parts.join('');\n};\n","import { combinePathWithBase } from './combinePathWithBase';\nimport { Fetcher, FetchOptions } from './fetch-types';\nimport { setQueryParams } from './url-helpers';\n\nconst getDefaultData = (args: any[] = []) => (args.length > 0 ? args[0] : undefined);\n\nconst tryCall = async (fn: Function, ...args: any[]) => {\n  try {\n    return await fn(...args);\n  } catch (err) {\n    const fnName = fn ? fn.name : 'anonymous';\n    console.warn(`[CreateService Error] ${fnName} failed with args:`, args);\n    return undefined;\n  }\n};\n\n// ─── Legacy types (kept for backward compat with createService<T>) ───\n\nexport interface Fn<T extends Array<any>> {\n  (...args: T): string;\n}\n\nexport type ServiceFn = (...args: any[]) => Promise<any>;\n\nexport type StringOrFn<T extends ServiceFn> = string | Fn<Parameters<T>>;\nexport type ObjectOrFn<T extends ServiceFn> = object | Fn<Parameters<T>>;\n\nexport interface Descriptor<K extends ServiceFn> {\n  url: StringOrFn<K>;\n  method?: HttpMethod;\n  body?: ObjectOrFn<K>;\n  headers?: ObjectOrFn<K>;\n  params?: ObjectOrFn<K>;\n  fetchOpts?: FetchOptions;\n  transform?: (data: any) => any;\n}\n\nexport type ServiceDescriptor<T> = {\n  [K in keyof T]: Descriptor<T[K] extends ServiceFn ? T[K] : never>;\n};\n\nexport interface CreateServiceArgs<T> {\n  endpoints: ServiceDescriptor<T>;\n  basePath?: string;\n  fetcher: Fetcher;\n}\n\n// ─── New inferred API types ───\n\nexport type HttpMethod =\n  | 'GET'\n  | 'POST'\n  | 'PUT'\n  | 'DELETE'\n  | 'PATCH'\n  | 'HEAD'\n  | 'OPTIONS'\n  | 'TRACE'\n  | 'CONNECT';\n\nexport interface DescriptorBase {\n  url: string | ((...args: any[]) => string);\n  method?: HttpMethod;\n  body?: object | ((...args: any[]) => any);\n  headers?: object | ((...args: any[]) => any);\n  params?: object | ((...args: any[]) => any);\n  fetchOpts?: FetchOptions;\n  transform?: (data: any) => any;\n}\n\n// ─── createEndpoint helper ───\n\n/** @internal Type brand symbol — not present at runtime */\ndeclare const ENDPOINT_TYPES: unique symbol;\n\n/** A descriptor branded with explicit TResponse, TArgs, TError types */\nexport interface TypedEndpoint<\n  TResponse = any,\n  TArgs = void,\n  TError = Error,\n> extends DescriptorBase {\n  readonly [ENDPOINT_TYPES]: { args: TArgs; response: TResponse; error: TError };\n}\n\n/** Configuration accepted by createEndpoint */\nexport interface EndpointConfig<TResponse, TArgs> {\n  url: string | ((args: TArgs) => string);\n  method?: HttpMethod;\n  body?: object | ((args: TArgs) => any);\n  headers?: object | ((args: TArgs) => any);\n  params?: object | ((args: TArgs) => any);\n  fetchOpts?: FetchOptions;\n  transform?: (data: any) => TResponse;\n}\n\n/**\n * Define a typed endpoint with explicit response/input/error types.\n *\n * @example\n * ```ts\n * // No args:\n * createEndpoint<User[]>({ url: '/users' })\n * // service method: () => Promise<User[]>\n *\n * // With args:\n * createEndpoint<User, { id: string }>({\n *   url: ({ id }) => `/users/${id}`,\n * })\n * // service method: (args: { id: string }) => Promise<User>\n * ```\n */\nexport function createEndpoint<TResponse = any, TArgs = void, TError = Error>(\n  config: EndpointConfig<TResponse, TArgs>,\n): TypedEndpoint<TResponse, TArgs, TError> {\n  return config as any;\n}\n\n// ─── Type inference ───\n\n/** Infer the service method args from a descriptor */\nexport type InferArgs<D> =\n  // 1. Branded endpoint — use the explicit TArgs\n  D extends { readonly [ENDPOINT_TYPES]: { args: infer A } }\n    ? [A] extends [void]\n      ? []\n      : [args: A]\n    : // 2. Infer from descriptor functions (url → body → params → headers)\n      D extends { url: (...args: infer P) => any }\n      ? P\n      : D extends { body: (...args: infer P) => any }\n        ? P\n        : D extends { params: (...args: infer P) => any }\n          ? P\n          : D extends { headers: (...args: infer P) => any }\n            ? P\n            : any[];\n\n/** Infer the service method return type from a descriptor */\nexport type InferReturn<D> =\n  // 1. Branded endpoint — use the explicit TResponse\n  D extends { readonly [ENDPOINT_TYPES]: { response: infer R } }\n    ? R\n    : // 2. Infer from transform return type\n      D extends { transform: (data: any) => infer R }\n      ? R\n      : any;\n\n/** Infer the error type from a branded descriptor */\nexport type InferError<D> = D extends {\n  readonly [ENDPOINT_TYPES]: { error: infer E };\n}\n  ? E\n  : Error;\n\nexport type InferService<T extends Record<string, DescriptorBase>> = {\n  [K in keyof T]: (...args: InferArgs<T[K]>) => Promise<InferReturn<T[K]>>;\n};\n\n// ─── Overloads ───\n\n/** Create a service with types inferred from the endpoint descriptors */\nexport function createService<const T extends Record<string, DescriptorBase>>(args: {\n  endpoints: T;\n  basePath?: string;\n  fetcher: Fetcher;\n}): InferService<T>;\n\n/** @deprecated Use the inferred API (call without explicit generic) */\nexport function createService<T>(args: CreateServiceArgs<T>): T;\n\n// ─── Implementation ───\n\nexport function createService({ endpoints, basePath, fetcher }: any): any {\n  return Object.keys(endpoints).reduce((service: any, serviceName: string) => {\n    service[serviceName] = async (...args: any[]) => {\n      const { url, body, headers, method, params, fetchOpts, transform } = endpoints[serviceName];\n\n      let urlToUse: string = typeof url === 'function' ? await tryCall(url, ...args) : url;\n      if (typeof urlToUse !== 'string') {\n        console.error(\n          '[Create Service Error]: URL must be a string or a function returning a string',\n          urlToUse,\n        );\n        throw new Error(\n          `URL must be a string or a function returning a string for method ${serviceName}.`,\n        );\n      }\n\n      // TODO: detect absolute urlToUse and prevent adding the base path\n      if (basePath) {\n        urlToUse = combinePathWithBase(basePath, urlToUse);\n      }\n\n      const getDefault = () => (method !== 'GET' ? getDefaultData(args) : undefined);\n\n      // if data is a function we pass all the arguments to the function so it creates\n      // the payload with all the provided arguments, expecting it to return a single object\n      // if the data is not a function then we get the first argument passed to the function as the\n      // data payload. If this is an object it will be serialized using json stringify before sending it\n      const bodyToUse = typeof body === 'function' ? await tryCall(body, ...args) : getDefault();\n      const headersToUse =\n        typeof headers === 'function' ? await tryCall(headers, ...args) : headers;\n\n      const paramsToUse = typeof params === 'function' ? await tryCall(params, ...args) : params;\n      const opts = { ...(fetchOpts || {}), body: bodyToUse, headers: headersToUse, method };\n\n      if (paramsToUse) {\n        urlToUse = setQueryParams(urlToUse, paramsToUse);\n      }\n\n      const result = await fetcher.fetch(urlToUse, opts);\n      return transform ? transform(result) : result;\n    };\n\n    return service;\n  }, {} as any);\n}\n","import { FetchOptions, FetchURL, SerializeBodyProps } from './fetch-types';\n\nexport interface ErrorData {\n  error: string;\n}\nexport class ResponseError extends Error {\n  response?: Response;\n\n  data?: ErrorData;\n}\n\nexport async function fetchJSON<T, K>(url: FetchURL, params?: SerializeBodyProps<K>): Promise<T> {\n  const { serializeBody = true, method, ...rest } = params || {};\n  const fetchMethod = method ?? 'GET';\n\n  const props: FetchOptions = {\n    ...rest,\n    method: fetchMethod,\n    headers: {\n      'Content-type': 'application/json',\n      ...rest.headers,\n    },\n    body:\n      fetchMethod === 'GET'\n        ? undefined\n        : ((serializeBody ? JSON.stringify(params?.body) : params?.body) as FetchOptions['body']),\n  };\n\n  try {\n    const resp = await fetch(url, props);\n    if (resp.status < 200 || resp.status > 300) {\n      let data: ErrorData;\n      try {\n        data = await resp.json();\n      } catch (parseError) {\n        data = { error: 'JSON_ERROR_NOT_RECEIVED' };\n      }\n      const error = new ResponseError(data.error);\n      error.response = resp;\n      error.data = data;\n\n      throw error;\n    }\n    const data = await resp.json();\n    return data;\n  } catch (err) {\n    console.error('>>> err', err);\n    throw err;\n  }\n}\n\nexport type FetchFn = typeof fetchJSON;\n","export interface WithRetriesOpts<K> {\n  retries?: number;\n  onFail?: (error: Error, args: K) => Promise<void> | void;\n  onTryError?: (error: Error, args: K, attemptIndex: number) => Promise<void> | void;\n}\n\nexport const withRetries = <K extends any[], T>(\n  fn: (...args: K) => Promise<T>,\n  { retries = 2, onTryError, onFail }: WithRetriesOpts<K> = {},\n) => {\n  const retFn = async (...args: K) => {\n    let attemptIndex = 0;\n\n    while (attemptIndex < retries) {\n      try {\n        const ret = await fn(...args); // eslint-disable-line no-await-in-loop\n\n        return ret as T;\n      } catch (err) {\n        if (attemptIndex < retries) {\n          try {\n            await onTryError?.(err as Error, args, attemptIndex); // eslint-disable-line no-await-in-loop\n          } catch (error) {\n            await onFail?.(error as Error, args); // eslint-disable-line no-await-in-loop\n            throw error;\n          }\n        }\n        attemptIndex += 1;\n        if (attemptIndex >= retries) {\n          await onFail?.(err as Error, args); // eslint-disable-line no-await-in-loop\n          throw err;\n        }\n      }\n    }\n  };\n\n  return retFn as (...args: K) => Promise<T>;\n};\n","export const tryParse = <T>(val: string | null, def?: T) => {\n  try {\n    return JSON.parse(val!) as T;\n  } catch (err) {\n    return def;\n  }\n};\n","import { tryParse } from './try-parse';\n\nexport const getItem = <T>(key: string, defaultValue: T) => {\n  const entity = localStorage.getItem(key);\n\n  return tryParse(entity) ?? defaultValue;\n};\n\nexport const setItem = <T>(key: string, entity: T) => {\n  const str = JSON.stringify(entity);\n\n  localStorage.setItem(key, str);\n};\n\nexport const removeItem = (key: string) => {\n  localStorage.removeItem(key);\n};\n"],"names":["combinePathWithBase","host","path","paramsToURLSearchParams","params","urlParams","urlSearchParams","key","val","v","setQueryParams","url","baseString","searchString","mergeParams","parts","paramsToAdd","removeQueryParam","param","getDefaultData","args","tryCall","fn","fnName","createEndpoint","config","createService","endpoints","basePath","fetcher","service","serviceName","body","headers","method","fetchOpts","transform","urlToUse","bodyToUse","headersToUse","paramsToUse","opts","result","ResponseError","__publicField","fetchJSON","serializeBody","rest","fetchMethod","props","resp","data","error","err","withRetries","retries","onTryError","onFail","attemptIndex","tryParse","def","getItem","defaultValue","entity","setItem","str","removeItem"],"mappings":"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"}

package/dist/index.umd.cjs

@@ -0,0 +1,2 @@
+(function(r,u){typeof exports=="object"&&typeof module<"u"?u(exports):typeof define=="function"&&define.amd?define(["exports"],u):(r=typeof globalThis<"u"?globalThis:r||self,u(r.serviceCreator={}))})(this,function(r){"use strict";var A=Object.defineProperty;var Q=(r,u,f)=>u in r?A(r,u,{enumerable:!0,configurable:!0,writable:!0,value:f}):r[u]=f;var w=(r,u,f)=>(Q(r,typeof u!="symbol"?u+"":u,f),f);const u=(t,e)=>(t=t.replace(/\/$/,""),e=e.replace(/^\//,""),`${t}/${e}`),f=(t,e)=>{const o=e??new URLSearchParams;return Object.keys(t).forEach(i=>{const n=t[i];typeof n<"u"&&(Array.isArray(n)?n.forEach(s=>{o.append(i,s)}):o.set(i,`${n}`))}),o},S=(t,e)=>{const[o,c]=t.split(/\?/),i=new URLSearchParams(c),n=f(e,i),s=[o],a=n.toString();return a.length>0&&s.push(`?${a}`),s.join("")},v=(t,e)=>{const[o,c]=t.split(/\?/),i=new URLSearchParams(c);e.forEach(a=>{i.delete(a)});const n=[o],s=i.toString();return s.length>0&&n.push(`?${s}`),n.join("")},O=(t=[])=>t.length>0?t[0]:void 0,l=async(t,...e)=>{try{return await t(...e)}catch{const c=t?t.name:"anonymous";console.warn(`[CreateService Error] ${c} failed with args:`,e);return}};function I(t){return t}function T({endpoints:t,basePath:e,fetcher:o}){return Object.keys(t).reduce((c,i)=>(c[i]=async(...n)=>{const{url:s,body:a,headers:d,method:h,params:y,fetchOpts:P,transform:b}=t[i];let m=typeof s=="function"?await l(s,...n):s;if(typeof m!="string")throw console.error("[Create Service Error]: URL must be a string or a function returning a string",m),new Error(`URL must be a string or a function returning a string for method ${i}.`);e&&(m=u(e,m));const J=typeof a=="function"?await l(a,...n):h!=="GET"?O(n):void 0,N=typeof d=="function"?await l(d,...n):d,E=typeof y=="function"?await l(y,...n):y,D={...P||{},body:J,headers:N,method:h};E&&(m=S(m,E));const R=await o.fetch(m,D);return b?b(R):R},c),{})}class g extends Error{constructor(){super(...arguments);w(this,"response");w(this,"data")}}async function U(t,e){const{serializeBody:o=!0,method:c,...i}=e||{},n=c??"GET",s={...i,method:n,headers:{"Content-type":"application/json",...i.headers},body:n==="GET"?void 0:o?JSON.stringify(e==null?void 0:e.body):e==null?void 0:e.body};try{const a=await fetch(t,s);if(a.status<200||a.status>300){let h;try{h=await a.json()}catch{h={error:"JSON_ERROR_NOT_RECEIVED"}}const y=new g(h.error);throw y.response=a,y.data=h,y}return await a.json()}catch(a){throw console.error(">>> err",a),a}}const j=(t,{retries:e=2,onTryError:o,onFail:c}={})=>async(...n)=>{let s=0;for(;s<e;)try{return await t(...n)}catch(a){if(s<e)try{await(o==null?void 0:o(a,n,s))}catch(d){throw await(c==null?void 0:c(d,n)),d}if(s+=1,s>=e)throw await(c==null?void 0:c(a,n)),a}},p=(t,e)=>{try{return JSON.parse(t)}catch{return e}},$=(t,e)=>{const o=localStorage.getItem(t);return p(o)??e},L=(t,e)=>{const o=JSON.stringify(e);localStorage.setItem(t,o)},C=t=>{localStorage.removeItem(t)};r.ResponseError=g,r.combinePathWithBase=u,r.createEndpoint=I,r.createService=T,r.fetchJSON=U,r.getItem=$,r.paramsToURLSearchParams=f,r.removeItem=C,r.removeQueryParam=v,r.setItem=L,r.setQueryParams=S,r.tryParse=p,r.withRetries=j,Object.defineProperty(r,Symbol.toStringTag,{value:"Module"})});
+//# sourceMappingURL=index.umd.cjs.map

package/dist/index.umd.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.umd.cjs","sources":["../src/combinePathWithBase.ts","../src/url-helpers.ts","../src/create-service.ts","../src/fetchJSON.ts","../src/withRetries.ts","../src/try-parse.ts","../src/ls.ts"],"sourcesContent":["export const combinePathWithBase = (host: string, path: string) => {\n  host = host.replace(/\\/$/, '');\n  path = path.replace(/^\\//, '');\n  return `${host}/${path}`;\n};\n","export const paramsToURLSearchParams = <T extends object>(\n  params: T,\n  urlParams?: URLSearchParams,\n) => {\n  const urlSearchParams = urlParams ?? new URLSearchParams();\n\n  const keys = Object.keys(params);\n  keys.forEach((key) => {\n    const val = params[key as keyof T];\n    if (typeof val !== 'undefined') {\n      if (Array.isArray(val)) {\n        val.forEach((v) => {\n          urlSearchParams.append(key, v);\n        });\n      } else {\n        urlSearchParams.set(key, `${val}`);\n      }\n    }\n  });\n\n  return urlSearchParams;\n};\n\nexport const setQueryParams = <T extends object>(url: string, params: T) => {\n  const [baseString, searchString] = url.split(/\\?/);\n\n  const urlParams = new URLSearchParams(searchString);\n  const mergeParams = paramsToURLSearchParams(params, urlParams);\n\n  const parts = [baseString];\n\n  const paramsToAdd = mergeParams.toString();\n\n  if (paramsToAdd.length > 0) {\n    parts.push(`?${paramsToAdd}`);\n  }\n\n  return parts.join('');\n};\n\nexport const removeQueryParam = (url: string, params: string[]) => {\n  const [baseString, searchString] = url.split(/\\?/);\n\n  const urlParams = new URLSearchParams(searchString);\n\n  params.forEach((param) => {\n    urlParams.delete(param);\n  });\n\n  const parts = [baseString];\n\n  const paramsToAdd = urlParams.toString();\n\n  if (paramsToAdd.length > 0) {\n    parts.push(`?${paramsToAdd}`);\n  }\n\n  return parts.join('');\n};\n","import { combinePathWithBase } from './combinePathWithBase';\nimport { Fetcher, FetchOptions } from './fetch-types';\nimport { setQueryParams } from './url-helpers';\n\nconst getDefaultData = (args: any[] = []) => (args.length > 0 ? args[0] : undefined);\n\nconst tryCall = async (fn: Function, ...args: any[]) => {\n  try {\n    return await fn(...args);\n  } catch (err) {\n    const fnName = fn ? fn.name : 'anonymous';\n    console.warn(`[CreateService Error] ${fnName} failed with args:`, args);\n    return undefined;\n  }\n};\n\n// ─── Legacy types (kept for backward compat with createService<T>) ───\n\nexport interface Fn<T extends Array<any>> {\n  (...args: T): string;\n}\n\nexport type ServiceFn = (...args: any[]) => Promise<any>;\n\nexport type StringOrFn<T extends ServiceFn> = string | Fn<Parameters<T>>;\nexport type ObjectOrFn<T extends ServiceFn> = object | Fn<Parameters<T>>;\n\nexport interface Descriptor<K extends ServiceFn> {\n  url: StringOrFn<K>;\n  method?: HttpMethod;\n  body?: ObjectOrFn<K>;\n  headers?: ObjectOrFn<K>;\n  params?: ObjectOrFn<K>;\n  fetchOpts?: FetchOptions;\n  transform?: (data: any) => any;\n}\n\nexport type ServiceDescriptor<T> = {\n  [K in keyof T]: Descriptor<T[K] extends ServiceFn ? T[K] : never>;\n};\n\nexport interface CreateServiceArgs<T> {\n  endpoints: ServiceDescriptor<T>;\n  basePath?: string;\n  fetcher: Fetcher;\n}\n\n// ─── New inferred API types ───\n\nexport type HttpMethod =\n  | 'GET'\n  | 'POST'\n  | 'PUT'\n  | 'DELETE'\n  | 'PATCH'\n  | 'HEAD'\n  | 'OPTIONS'\n  | 'TRACE'\n  | 'CONNECT';\n\nexport interface DescriptorBase {\n  url: string | ((...args: any[]) => string);\n  method?: HttpMethod;\n  body?: object | ((...args: any[]) => any);\n  headers?: object | ((...args: any[]) => any);\n  params?: object | ((...args: any[]) => any);\n  fetchOpts?: FetchOptions;\n  transform?: (data: any) => any;\n}\n\n// ─── createEndpoint helper ───\n\n/** @internal Type brand symbol — not present at runtime */\ndeclare const ENDPOINT_TYPES: unique symbol;\n\n/** A descriptor branded with explicit TResponse, TArgs, TError types */\nexport interface TypedEndpoint<\n  TResponse = any,\n  TArgs = void,\n  TError = Error,\n> extends DescriptorBase {\n  readonly [ENDPOINT_TYPES]: { args: TArgs; response: TResponse; error: TError };\n}\n\n/** Configuration accepted by createEndpoint */\nexport interface EndpointConfig<TResponse, TArgs> {\n  url: string | ((args: TArgs) => string);\n  method?: HttpMethod;\n  body?: object | ((args: TArgs) => any);\n  headers?: object | ((args: TArgs) => any);\n  params?: object | ((args: TArgs) => any);\n  fetchOpts?: FetchOptions;\n  transform?: (data: any) => TResponse;\n}\n\n/**\n * Define a typed endpoint with explicit response/input/error types.\n *\n * @example\n * ```ts\n * // No args:\n * createEndpoint<User[]>({ url: '/users' })\n * // service method: () => Promise<User[]>\n *\n * // With args:\n * createEndpoint<User, { id: string }>({\n *   url: ({ id }) => `/users/${id}`,\n * })\n * // service method: (args: { id: string }) => Promise<User>\n * ```\n */\nexport function createEndpoint<TResponse = any, TArgs = void, TError = Error>(\n  config: EndpointConfig<TResponse, TArgs>,\n): TypedEndpoint<TResponse, TArgs, TError> {\n  return config as any;\n}\n\n// ─── Type inference ───\n\n/** Infer the service method args from a descriptor */\nexport type InferArgs<D> =\n  // 1. Branded endpoint — use the explicit TArgs\n  D extends { readonly [ENDPOINT_TYPES]: { args: infer A } }\n    ? [A] extends [void]\n      ? []\n      : [args: A]\n    : // 2. Infer from descriptor functions (url → body → params → headers)\n      D extends { url: (...args: infer P) => any }\n      ? P\n      : D extends { body: (...args: infer P) => any }\n        ? P\n        : D extends { params: (...args: infer P) => any }\n          ? P\n          : D extends { headers: (...args: infer P) => any }\n            ? P\n            : any[];\n\n/** Infer the service method return type from a descriptor */\nexport type InferReturn<D> =\n  // 1. Branded endpoint — use the explicit TResponse\n  D extends { readonly [ENDPOINT_TYPES]: { response: infer R } }\n    ? R\n    : // 2. Infer from transform return type\n      D extends { transform: (data: any) => infer R }\n      ? R\n      : any;\n\n/** Infer the error type from a branded descriptor */\nexport type InferError<D> = D extends {\n  readonly [ENDPOINT_TYPES]: { error: infer E };\n}\n  ? E\n  : Error;\n\nexport type InferService<T extends Record<string, DescriptorBase>> = {\n  [K in keyof T]: (...args: InferArgs<T[K]>) => Promise<InferReturn<T[K]>>;\n};\n\n// ─── Overloads ───\n\n/** Create a service with types inferred from the endpoint descriptors */\nexport function createService<const T extends Record<string, DescriptorBase>>(args: {\n  endpoints: T;\n  basePath?: string;\n  fetcher: Fetcher;\n}): InferService<T>;\n\n/** @deprecated Use the inferred API (call without explicit generic) */\nexport function createService<T>(args: CreateServiceArgs<T>): T;\n\n// ─── Implementation ───\n\nexport function createService({ endpoints, basePath, fetcher }: any): any {\n  return Object.keys(endpoints).reduce((service: any, serviceName: string) => {\n    service[serviceName] = async (...args: any[]) => {\n      const { url, body, headers, method, params, fetchOpts, transform } = endpoints[serviceName];\n\n      let urlToUse: string = typeof url === 'function' ? await tryCall(url, ...args) : url;\n      if (typeof urlToUse !== 'string') {\n        console.error(\n          '[Create Service Error]: URL must be a string or a function returning a string',\n          urlToUse,\n        );\n        throw new Error(\n          `URL must be a string or a function returning a string for method ${serviceName}.`,\n        );\n      }\n\n      // TODO: detect absolute urlToUse and prevent adding the base path\n      if (basePath) {\n        urlToUse = combinePathWithBase(basePath, urlToUse);\n      }\n\n      const getDefault = () => (method !== 'GET' ? getDefaultData(args) : undefined);\n\n      // if data is a function we pass all the arguments to the function so it creates\n      // the payload with all the provided arguments, expecting it to return a single object\n      // if the data is not a function then we get the first argument passed to the function as the\n      // data payload. If this is an object it will be serialized using json stringify before sending it\n      const bodyToUse = typeof body === 'function' ? await tryCall(body, ...args) : getDefault();\n      const headersToUse =\n        typeof headers === 'function' ? await tryCall(headers, ...args) : headers;\n\n      const paramsToUse = typeof params === 'function' ? await tryCall(params, ...args) : params;\n      const opts = { ...(fetchOpts || {}), body: bodyToUse, headers: headersToUse, method };\n\n      if (paramsToUse) {\n        urlToUse = setQueryParams(urlToUse, paramsToUse);\n      }\n\n      const result = await fetcher.fetch(urlToUse, opts);\n      return transform ? transform(result) : result;\n    };\n\n    return service;\n  }, {} as any);\n}\n","import { FetchOptions, FetchURL, SerializeBodyProps } from './fetch-types';\n\nexport interface ErrorData {\n  error: string;\n}\nexport class ResponseError extends Error {\n  response?: Response;\n\n  data?: ErrorData;\n}\n\nexport async function fetchJSON<T, K>(url: FetchURL, params?: SerializeBodyProps<K>): Promise<T> {\n  const { serializeBody = true, method, ...rest } = params || {};\n  const fetchMethod = method ?? 'GET';\n\n  const props: FetchOptions = {\n    ...rest,\n    method: fetchMethod,\n    headers: {\n      'Content-type': 'application/json',\n      ...rest.headers,\n    },\n    body:\n      fetchMethod === 'GET'\n        ? undefined\n        : ((serializeBody ? JSON.stringify(params?.body) : params?.body) as FetchOptions['body']),\n  };\n\n  try {\n    const resp = await fetch(url, props);\n    if (resp.status < 200 || resp.status > 300) {\n      let data: ErrorData;\n      try {\n        data = await resp.json();\n      } catch (parseError) {\n        data = { error: 'JSON_ERROR_NOT_RECEIVED' };\n      }\n      const error = new ResponseError(data.error);\n      error.response = resp;\n      error.data = data;\n\n      throw error;\n    }\n    const data = await resp.json();\n    return data;\n  } catch (err) {\n    console.error('>>> err', err);\n    throw err;\n  }\n}\n\nexport type FetchFn = typeof fetchJSON;\n","export interface WithRetriesOpts<K> {\n  retries?: number;\n  onFail?: (error: Error, args: K) => Promise<void> | void;\n  onTryError?: (error: Error, args: K, attemptIndex: number) => Promise<void> | void;\n}\n\nexport const withRetries = <K extends any[], T>(\n  fn: (...args: K) => Promise<T>,\n  { retries = 2, onTryError, onFail }: WithRetriesOpts<K> = {},\n) => {\n  const retFn = async (...args: K) => {\n    let attemptIndex = 0;\n\n    while (attemptIndex < retries) {\n      try {\n        const ret = await fn(...args); // eslint-disable-line no-await-in-loop\n\n        return ret as T;\n      } catch (err) {\n        if (attemptIndex < retries) {\n          try {\n            await onTryError?.(err as Error, args, attemptIndex); // eslint-disable-line no-await-in-loop\n          } catch (error) {\n            await onFail?.(error as Error, args); // eslint-disable-line no-await-in-loop\n            throw error;\n          }\n        }\n        attemptIndex += 1;\n        if (attemptIndex >= retries) {\n          await onFail?.(err as Error, args); // eslint-disable-line no-await-in-loop\n          throw err;\n        }\n      }\n    }\n  };\n\n  return retFn as (...args: K) => Promise<T>;\n};\n","export const tryParse = <T>(val: string | null, def?: T) => {\n  try {\n    return JSON.parse(val!) as T;\n  } catch (err) {\n    return def;\n  }\n};\n","import { tryParse } from './try-parse';\n\nexport const getItem = <T>(key: string, defaultValue: T) => {\n  const entity = localStorage.getItem(key);\n\n  return tryParse(entity) ?? defaultValue;\n};\n\nexport const setItem = <T>(key: string, entity: T) => {\n  const str = JSON.stringify(entity);\n\n  localStorage.setItem(key, str);\n};\n\nexport const removeItem = (key: string) => {\n  localStorage.removeItem(key);\n};\n"],"names":["combinePathWithBase","host","path","paramsToURLSearchParams","params","urlParams","urlSearchParams","key","val","v","setQueryParams","url","baseString","searchString","mergeParams","parts","paramsToAdd","removeQueryParam","param","getDefaultData","args","tryCall","fn","fnName","createEndpoint","config","createService","endpoints","basePath","fetcher","service","serviceName","body","headers","method","fetchOpts","transform","urlToUse","bodyToUse","headersToUse","paramsToUse","opts","result","ResponseError","__publicField","fetchJSON","serializeBody","rest","fetchMethod","props","resp","data","error","err","withRetries","retries","onTryError","onFail","attemptIndex","tryParse","def","getItem","defaultValue","entity","setItem","str","removeItem"],"mappings":"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"}