@tahanabavi/typefetch 1.0.3 → 1.1.0

package/README.md

@@ -1,6 +1,6 @@
 # TypeFetch
 
-TypeFetch is a type-safe client for working with APIs, built with TypeScript and Zod. This project allows you to define API contracts and safely use types, while also supporting middlewares, error handling, and response transformation.
+TypeFetch is a type-safe client for working with APIs, built with TypeScript and Zod. This project allows you to define API contracts and safely use types, while also supporting middlewares, error handling, response transformation, mock data, and response wrappers.
 
 ---
 
@@ -12,6 +12,8 @@ TypeFetch is a type-safe client for working with APIs, built with TypeScript and
 - Error handling with the `RichError` class
 - Ability to transform responses using a response transformer
 - Authentication support via token
+- Mock data support for development and testing
+- Response wrapper for consistent API response formats
 
 ---
 
@@ -25,9 +27,32 @@ yarn add @tahanabavi/typefetch
 
 ---
 
+## What's New in v1.1.0
+
+### 🎯 Mock Data Support
+
+- Add mock data to endpoints for development and testing
+- Configurable random delays to simulate network latency
+- Support for both static data and dynamic functions
+- Runtime toggle between mock and real API modes
+
+### 🔄 Response Wrapper
+
+- Consistent API response format handling
+- Automatic validation of wrapped responses
+- Support for success/error response patterns
+- Seamless integration with existing contracts
+
+### 🚀 Enhanced Error Handling
+
+- Better Zod error wrapping and reporting
+- Improved type safety for response wrappers
+
+---
+
 ## Defining Contracts
 
-Contracts are defined using the `Contracts` and `EndpointDef` types
+Contracts are defined using the `Contracts` and `EndpointDef` types.
 
 ```ts
 import { z } from "zod";
@@ -40,12 +65,16 @@ const contracts = {
       auth: true,
       request: z.object({ id: z.string() }),
       response: z.object({ id: z.string(), name: z.string() }),
+      // Optional mock data
+      mockData: { id: "1", name: "John Doe" },
     },
     createUser: {
       method: "POST",
       path: "/user",
       request: z.object({ name: z.string() }),
       response: z.object({ id: z.string(), name: z.string() }),
+      // Dynamic mock data function
+      mockData: () => ({ id: Math.random().toString(), name: "Dynamic User" }),
     },
   },
 } as const;
@@ -62,6 +91,8 @@ const client = new ApiClient(
   {
     baseUrl: "https://api.example.com",
     token: "your-auth-token",
+    useMockData: true,
+    mockDelay: { min: 100, max: 1000 },
   },
   contracts
 );
@@ -82,7 +113,7 @@ All errors are provided via the `RichError` class. You can define a custom error
 
 ```ts
 client.onError((error: RichError) => {
-  console.error("API Error:", error.message, error.status);
+  console.error("API Error:", error.message, error.status, error.code);
 });
 ```
 
@@ -140,11 +171,61 @@ client.useResponseTransform((data) => {
 
 ---
 
+## Mock Data Features
+
+Static Mock Data:
+
+```ts
+mockData: { id: "1", name: "Static User" }
+```
+
+Dynamic Mock Data:
+
+```ts
+mockData: () => ({ id: Math.random().toString(), name: `User-${Date.now()}` });
+```
+
+Runtime Control:
+
+```ts
+client.setMockMode(true, { min: 100, max: 2000 });
+client.setMockMode(false);
+```
+
+---
+
+## Response Wrapper Features
+
+```ts
+const apiResponseWrapper = (successResponse: z.ZodTypeAny) =>
+  z.union([
+    z.object({
+      success: z.literal(true),
+      data: successResponse,
+      timestamp: z.string(),
+      requestId: z.string(),
+    }),
+    z.object({
+      success: z.literal(false),
+      message: z.string(),
+      code: z.number(),
+      timestamp: z.string(),
+      requestId: z.string(),
+    }),
+  ]);
+
+client.setResponseWrapper(apiResponseWrapper);
+```
+
+---
+
 ## Important Notes
 
 - Always call `client.init()` before using endpoints.
 - Types are automatically inferred from Zod, making inputs and outputs type-safe.
 - Middleware execution order: first added middleware runs last, last added middleware runs first.
+- Mock data is used only when `useMockData` is true and mock data is defined.
+- Response wrapper automatically handles success/error patterns.
 
 ---
 
@@ -156,23 +237,50 @@ import { ApiClient, RichError } from "typefetch";
 import { LoggingMiddleware, RetryMiddleware } from "typefetch/middlewares";
 
 const contracts = {
-  post: {
-    getPost: {
+  user: {
+    getUser: {
       method: "GET",
-      path: "/posts/:id",
+      path: "/users/:id",
       auth: true,
       request: z.object({ id: z.string() }),
-      response: z.object({ id: z.string(), title: z.string() }),
+      response: z.object({
+        id: z.string(),
+        name: z.string(),
+        email: z.string(),
+      }),
+      mockData: { id: "1", name: "John Doe", email: "john@example.com" },
     },
   },
 } as const;
 
+const apiResponseWrapper = (successResponse: z.ZodTypeAny) =>
+  z.union([
+    z.object({
+      success: z.literal(true),
+      data: successResponse,
+      timestamp: z.string(),
+      requestId: z.string(),
+    }),
+    z.object({
+      success: z.literal(false),
+      message: z.string(),
+      code: z.number(),
+      timestamp: z.string(),
+      requestId: z.string(),
+    }),
+  ]);
+
 const client = new ApiClient(
-  { baseUrl: "https://api.example.com", token: "abc123" },
+  {
+    baseUrl: "https://api.example.com",
+    token: "abc123",
+    useMockData: process.env.NODE_ENV === "development",
+  },
   contracts
 );
 
 client.init();
+client.setResponseWrapper(apiResponseWrapper);
 client.use(LoggingMiddleware);
 client.use(RetryMiddleware, { maxRetries: 2 });
 
@@ -183,7 +291,13 @@ client.onError((err: RichError) => {
 const { modules: api } = client;
 
 (async () => {
-  const post = await api.post.getPost({ id: "1" });
-  console.log(post);
+  const user = await api.user.getUser({ id: "1" });
+  console.log(user);
 })();
 ```
+
+---
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -6,6 +6,7 @@ type EndpointDef<TReq extends z.ZodTypeAny, TRes extends z.ZodTypeAny> = {
     auth?: boolean;
     request: TReq;
     response: TRes;
+    mockData?: (() => z.infer<TRes>) | z.infer<TRes>;
 };
 type Contracts = {
     [ModuleName: string]: {
@@ -45,17 +46,32 @@ declare class ApiClient<C extends Contracts, E extends ErrorLike = RichError> {
     private middlewares;
     private errorHandler?;
     private responseTransform;
+    private useMockData;
+    private mockDelay;
+    private responseWrapper?;
     private _modules;
     constructor(config: {
         baseUrl: string;
         token?: string;
+        useMockData?: boolean;
+        mockDelay?: {
+            min: number;
+            max: number;
+        };
     }, contracts: C);
     init(): void;
     get modules(): { [M in keyof C]: EndpointMethods<C[M]>; };
     use<T>(middleware: Middleware<T>, options?: T): void;
     onError(handler: (error: E) => void): void;
     useResponseTransform(fn: (data: any) => any): void;
+    setMockMode(enabled: boolean, delay?: {
+        min: number;
+        max: number;
+    }): void;
+    setResponseWrapper(wrapper: (successResponse: z.ZodTypeAny) => z.ZodTypeAny): void;
     private request;
+    private handleMockRequest;
+    private getRandomDelay;
     private createError;
     private normalizeError;
 }

package/dist/index.d.ts

@@ -6,6 +6,7 @@ type EndpointDef<TReq extends z.ZodTypeAny, TRes extends z.ZodTypeAny> = {
     auth?: boolean;
     request: TReq;
     response: TRes;
+    mockData?: (() => z.infer<TRes>) | z.infer<TRes>;
 };
 type Contracts = {
     [ModuleName: string]: {
@@ -45,17 +46,32 @@ declare class ApiClient<C extends Contracts, E extends ErrorLike = RichError> {
     private middlewares;
     private errorHandler?;
     private responseTransform;
+    private useMockData;
+    private mockDelay;
+    private responseWrapper?;
     private _modules;
     constructor(config: {
         baseUrl: string;
         token?: string;
+        useMockData?: boolean;
+        mockDelay?: {
+            min: number;
+            max: number;
+        };
     }, contracts: C);
     init(): void;
     get modules(): { [M in keyof C]: EndpointMethods<C[M]>; };
     use<T>(middleware: Middleware<T>, options?: T): void;
     onError(handler: (error: E) => void): void;
     useResponseTransform(fn: (data: any) => any): void;
+    setMockMode(enabled: boolean, delay?: {
+        min: number;
+        max: number;
+    }): void;
+    setResponseWrapper(wrapper: (successResponse: z.ZodTypeAny) => z.ZodTypeAny): void;
     private request;
+    private handleMockRequest;
+    private getRandomDelay;
     private createError;
     private normalizeError;
 }

package/dist/index.js

@@ -79,6 +79,10 @@ var ApiClient = class {
     this.contracts = contracts;
     this.middlewares = [];
     this.responseTransform = (d) => d;
+    this.useMockData = false;
+    this.mockDelay = { min: 100, max: 1e3 };
+    this.useMockData = config.useMockData || false;
+    this.mockDelay = config.mockDelay || { min: 100, max: 1e3 };
   }
   init() {
     const modules = {};
@@ -104,10 +108,22 @@ var ApiClient = class {
   useResponseTransform(fn) {
     this.responseTransform = fn;
   }
+  setMockMode(enabled, delay) {
+    this.useMockData = enabled;
+    if (delay) {
+      this.mockDelay = delay;
+    }
+  }
+  setResponseWrapper(wrapper) {
+    this.responseWrapper = wrapper;
+  }
   request(endpoint, input) {
     return __async(this, null, function* () {
-      var _a, _b, _c;
+      var _a, _b, _c, _d;
       endpoint.request.parse(input);
+      if (this.useMockData && endpoint.mockData) {
+        return this.handleMockRequest(endpoint);
+      }
       if (endpoint.auth && !this.config.token) {
         const error = this.createError({
           message: `Missing token for ${endpoint.path}`,
@@ -134,28 +150,73 @@ var ApiClient = class {
       );
       try {
         const res = yield runner();
+        const json = yield res.json();
+        let responseData = json;
+        if (this.responseWrapper) {
+          const wrappedSchema = this.responseWrapper(endpoint.response);
+          const parsedResponse = wrappedSchema.parse(json);
+          if (parsedResponse.success === false) {
+            const error = this.createError({
+              message: parsedResponse.message || "Request failed",
+              status: parsedResponse.code || res.status,
+              code: `API_ERROR_${parsedResponse.code}`
+            });
+            (_b = this.errorHandler) == null ? void 0 : _b.call(this, error);
+            throw error;
+          }
+          responseData = parsedResponse.data;
+        }
         if (!res.ok) {
-          const errorData = yield res.json().catch(() => ({}));
           const error = this.createError({
-            message: errorData.message || res.statusText,
+            message: json.message || res.statusText,
             status: res.status,
-            code: errorData.code,
-            title: errorData.title,
-            detail: errorData.detail,
-            errors: errorData.errors
+            code: json.code,
+            title: json.title,
+            detail: json.detail,
+            errors: json.errors
           });
-          (_b = this.errorHandler) == null ? void 0 : _b.call(this, error);
+          (_c = this.errorHandler) == null ? void 0 : _c.call(this, error);
           throw error;
         }
-        const json = yield res.json();
-        return this.responseTransform(endpoint.response.parse(json));
+        return this.responseTransform(endpoint.response.parse(responseData));
       } catch (err) {
         const error = this.normalizeError(err);
-        (_c = this.errorHandler) == null ? void 0 : _c.call(this, error);
+        (_d = this.errorHandler) == null ? void 0 : _d.call(this, error);
         throw error;
       }
     });
   }
+  handleMockRequest(endpoint) {
+    return __async(this, null, function* () {
+      const delay = this.getRandomDelay();
+      yield new Promise((resolve) => setTimeout(resolve, delay));
+      let mockData;
+      if (typeof endpoint.mockData === "function") {
+        mockData = endpoint.mockData();
+      } else {
+        mockData = endpoint.mockData;
+      }
+      if (this.responseWrapper) {
+        const wrappedSchema = this.responseWrapper(endpoint.response);
+        const mockWrappedResponse = {
+          success: true,
+          data: mockData,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          requestId: `mock-${Math.random().toString(36).substr(2, 9)}`
+        };
+        const parsedWrappedResponse = wrappedSchema.parse(mockWrappedResponse);
+        return this.responseTransform(
+          endpoint.response.parse(parsedWrappedResponse.data)
+        );
+      }
+      return this.responseTransform(endpoint.response.parse(mockData));
+    });
+  }
+  getRandomDelay() {
+    return Math.floor(
+      Math.random() * (this.mockDelay.max - this.mockDelay.min + 1)
+    ) + this.mockDelay.min;
+  }
   createError(error) {
     return new RichError(error);
   }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/middlewares/logging.ts","../src/middlewares/retry.ts","../src/middlewares/auth.ts","../src/middlewares/cache.ts"],"sourcesContent":["export * from \"./types\";\nexport * from \"./client\";\nexport * from \"./middlewares/logging\";\nexport * from \"./middlewares/retry\";\nexport * from \"./middlewares/auth\";\nexport * from \"./middlewares/cache\";\n","import {\n  Contracts,\n  EndpointDef,\n  EndpointDefZ,\n  Middleware,\n  ErrorLike,\n  EndpointMethods,\n} from \"@/types\";\nimport { z } from \"zod\";\n\nexport class RichError extends Error implements ErrorLike {\n  status?: number;\n  code?: string;\n  title?: string;\n  detail?: string;\n  errors?: Record<string, string[]>;\n\n  constructor(error: Partial<ErrorLike> & { message: string }) {\n    super(error.message);\n    Object.assign(this, error);\n  }\n}\n\nexport class ApiClient<C extends Contracts, E extends ErrorLike = RichError> {\n  private middlewares: Array<{ fn: Middleware; options?: any }> = [];\n  private errorHandler?: (error: E) => void;\n  private responseTransform: (data: any) => any = (d) => d;\n\n  private _modules!: {\n    [M in keyof C]: EndpointMethods<C[M]>;\n  };\n\n  constructor(\n    private config: { baseUrl: string; token?: string },\n    private contracts: C\n  ) {}\n\n  init() {\n    const modules = {} as {\n      [M in keyof C]: EndpointMethods<C[M]>;\n    };\n\n    for (const moduleName in this.contracts) {\n      const module = this.contracts[moduleName];\n      (modules as any)[moduleName] = {} as EndpointMethods<typeof module>;\n\n      for (const endpointName in module) {\n        const endpoint = module[endpointName] as EndpointDefZ;\n\n        (modules as any)[moduleName][endpointName] = (\n          input: z.infer<(typeof endpoint)[\"request\"]>\n        ) => this.request(endpoint, input);\n      }\n    }\n\n    this._modules = modules;\n  }\n\n  get modules() {\n    return this._modules;\n  }\n\n  use<T>(middleware: Middleware<T>, options?: T) {\n    this.middlewares.push({ fn: middleware, options });\n  }\n\n  onError(handler: (error: E) => void) {\n    this.errorHandler = handler;\n  }\n\n  useResponseTransform(fn: (data: any) => any) {\n    this.responseTransform = fn;\n  }\n\n  private async request<TReq extends z.ZodTypeAny, TRes extends z.ZodTypeAny>(\n    endpoint: EndpointDef<TReq, TRes>,\n    input: z.infer<TReq>\n  ): Promise<z.infer<TRes>> {\n    endpoint.request.parse(input);\n\n    if (endpoint.auth && !this.config.token) {\n      const error = this.createError({\n        message: `Missing token for ${endpoint.path}`,\n        status: 401,\n        code: \"NO_TOKEN\",\n      });\n      this.errorHandler?.(error as unknown as E);\n      throw error;\n    }\n\n    const headers: HeadersInit = { \"Content-Type\": \"application/json\" };\n    if (endpoint.auth && this.config.token)\n      headers[\"Authorization\"] = `Bearer ${this.config.token}`;\n\n    const ctx = {\n      url: this.config.baseUrl + endpoint.path,\n      init: {\n        method: endpoint.method,\n        headers,\n        body: endpoint.method !== \"GET\" ? JSON.stringify(input) : undefined,\n      },\n    };\n\n    const runner = this.middlewares.reduceRight(\n      (next, mw) => () => mw.fn(ctx, next, mw.options),\n      () => fetch(ctx.url, ctx.init)\n    );\n\n    try {\n      const res = await runner();\n      if (!res.ok) {\n        const errorData = await res.json().catch(() => ({}));\n        const error = this.createError({\n          message: errorData.message || res.statusText,\n          status: res.status,\n          code: errorData.code,\n          title: errorData.title,\n          detail: errorData.detail,\n          errors: errorData.errors,\n        });\n        this.errorHandler?.(error as unknown as E);\n        throw error;\n      }\n\n      const json = await res.json();\n      return this.responseTransform(endpoint.response.parse(json));\n    } catch (err: any) {\n      const error = this.normalizeError(err);\n      this.errorHandler?.(error as unknown as E);\n      throw error;\n    }\n  }\n\n  private createError(error: Partial<RichError> & { message: string }) {\n    return new RichError(error);\n  }\n\n  private normalizeError(err: any) {\n    if (err instanceof RichError) return err;\n    return this.createError({ message: err.message || \"Unknown error\" });\n  }\n}\n","import { Middleware } from \"@/types\";\n\nexport type LoggingOptions = {\n  logRequest?: boolean;\n  logResponse?: boolean;\n  debug?: boolean;\n};\n\nexport const loggingMiddleware: Middleware<LoggingOptions> = async (\n  ctx,\n  next,\n  options\n) => {\n  const { logRequest = true, logResponse = true, debug = true } = options || {};\n\n  if (debug && logRequest) console.log(\"➡️ Request:\", ctx.url, ctx.init);\n\n  const res = await next();\n\n  if (debug && logResponse) console.log(\"⬅️ Response:\", res.status);\n\n  return res;\n};\n","import { Middleware } from \"@/types\";\n\n\nexport type RetryOptions = {\n  maxRetries?: number;\n  delay?: number; // ms\n};\n\nexport const retryMiddleware = (options?: RetryOptions): Middleware => {\n  const { maxRetries = 3, delay = 500 } = options || {};\n\n  const middleware: Middleware = async (ctx, next) => {\n    let attempt = 0;\n    while (true) {\n      try {\n        return await next();\n      } catch (err) {\n        if (attempt >= maxRetries) throw err;\n        attempt++;\n        await new Promise((r) => setTimeout(r, delay * 2 ** attempt));\n      }\n    }\n  };\n\n  return middleware;\n};\n","import { Middleware } from \"@/types\";\n\nexport type AuthOptions = {\n  refreshToken?: () => Promise<string>;\n};\n\nexport const authMiddleware: Middleware<AuthOptions> = async (\n  ctx,\n  next,\n  options\n) => {\n  if (options?.refreshToken) {\n    try {\n      const newToken = await options.refreshToken();\n      ctx.init.headers = {\n        ...ctx.init.headers,\n        Authorization: `Bearer ${newToken}`,\n      };\n    } catch {}\n  }\n\n  return next();\n};\n","import { MiddlewareContext, MiddlewareNext } from \"@/types\";\n\nexport type CacheOptions = { ttl?: number };\n\nexport const cacheMiddleware = (options: CacheOptions = {}) => {\n  const { ttl = 60000 } = options;\n  const cache = new Map<string, { data: any; expires: number }>();\n\n  return async (ctx: MiddlewareContext, next: MiddlewareNext) => {\n    if (ctx.init.method === \"GET\") {\n      const cached = cache.get(ctx.url);\n      const now = Date.now();\n      if (cached && cached.expires > now)\n        return new Response(JSON.stringify(cached.data));\n\n      const res = await next();\n      const data = await res\n        .clone()\n        .json()\n        .catch(() => null);\n      if (data) cache.set(ctx.url, { data, expires: now + ttl });\n      return res;\n    }\n    return next();\n  };\n};\n"],"mappings":"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","names":["module"]}
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/middlewares/logging.ts","../src/middlewares/retry.ts","../src/middlewares/auth.ts","../src/middlewares/cache.ts"],"sourcesContent":["export * from \"./types\";\nexport * from \"./client\";\nexport * from \"./middlewares/logging\";\nexport * from \"./middlewares/retry\";\nexport * from \"./middlewares/auth\";\nexport * from \"./middlewares/cache\";\n","import {\n  Contracts,\n  EndpointDef,\n  EndpointDefZ,\n  Middleware,\n  ErrorLike,\n  EndpointMethods,\n} from \"@/types\";\nimport { z } from \"zod\";\n\nexport class RichError extends Error implements ErrorLike {\n  status?: number;\n  code?: string;\n  title?: string;\n  detail?: string;\n  errors?: Record<string, string[]>;\n\n  constructor(error: Partial<ErrorLike> & { message: string }) {\n    super(error.message);\n    Object.assign(this, error);\n  }\n}\n\nexport class ApiClient<C extends Contracts, E extends ErrorLike = RichError> {\n  private middlewares: Array<{ fn: Middleware; options?: any }> = [];\n  private errorHandler?: (error: E) => void;\n  private responseTransform: (data: any) => any = (d) => d;\n  private useMockData: boolean = false;\n  private mockDelay: { min: number; max: number } = { min: 100, max: 1000 };\n  private responseWrapper?: (successResponse: z.ZodTypeAny) => z.ZodTypeAny;\n\n  private _modules!: {\n    [M in keyof C]: EndpointMethods<C[M]>;\n  };\n\n  constructor(\n    private config: {\n      baseUrl: string;\n      token?: string;\n      useMockData?: boolean;\n      mockDelay?: { min: number; max: number };\n    },\n    private contracts: C\n  ) {\n    this.useMockData = config.useMockData || false;\n    this.mockDelay = config.mockDelay || { min: 100, max: 1000 };\n  }\n\n  init() {\n    const modules = {} as {\n      [M in keyof C]: EndpointMethods<C[M]>;\n    };\n\n    for (const moduleName in this.contracts) {\n      const module = this.contracts[moduleName];\n      (modules as any)[moduleName] = {} as EndpointMethods<typeof module>;\n\n      for (const endpointName in module) {\n        const endpoint = module[endpointName] as EndpointDefZ;\n\n        (modules as any)[moduleName][endpointName] = (\n          input: z.infer<(typeof endpoint)[\"request\"]>\n        ) => this.request(endpoint, input);\n      }\n    }\n\n    this._modules = modules;\n  }\n\n  get modules() {\n    return this._modules;\n  }\n\n  use<T>(middleware: Middleware<T>, options?: T) {\n    this.middlewares.push({ fn: middleware, options });\n  }\n\n  onError(handler: (error: E) => void) {\n    this.errorHandler = handler;\n  }\n\n  useResponseTransform(fn: (data: any) => any) {\n    this.responseTransform = fn;\n  }\n\n  setMockMode(enabled: boolean, delay?: { min: number; max: number }) {\n    this.useMockData = enabled;\n    if (delay) {\n      this.mockDelay = delay;\n    }\n  }\n\n  setResponseWrapper(wrapper: (successResponse: z.ZodTypeAny) => z.ZodTypeAny) {\n    this.responseWrapper = wrapper;\n  }\n\n  private async request<TReq extends z.ZodTypeAny, TRes extends z.ZodTypeAny>(\n    endpoint: EndpointDef<TReq, TRes>,\n    input: z.infer<TReq>\n  ): Promise<z.infer<TRes>> {\n    endpoint.request.parse(input);\n\n    if (this.useMockData && endpoint.mockData) {\n      return this.handleMockRequest(endpoint);\n    }\n\n    if (endpoint.auth && !this.config.token) {\n      const error = this.createError({\n        message: `Missing token for ${endpoint.path}`,\n        status: 401,\n        code: \"NO_TOKEN\",\n      });\n      this.errorHandler?.(error as unknown as E);\n      throw error;\n    }\n\n    const headers: HeadersInit = { \"Content-Type\": \"application/json\" };\n    if (endpoint.auth && this.config.token)\n      headers[\"Authorization\"] = `Bearer ${this.config.token}`;\n\n    const ctx = {\n      url: this.config.baseUrl + endpoint.path,\n      init: {\n        method: endpoint.method,\n        headers,\n        body: endpoint.method !== \"GET\" ? JSON.stringify(input) : undefined,\n      },\n    };\n\n    const runner = this.middlewares.reduceRight(\n      (next, mw) => () => mw.fn(ctx, next, mw.options),\n      () => fetch(ctx.url, ctx.init)\n    );\n\n    try {\n      const res = await runner();\n      const json = await res.json();\n\n      let responseData = json;\n      if (this.responseWrapper) {\n        const wrappedSchema = this.responseWrapper(endpoint.response);\n        const parsedResponse = wrappedSchema.parse(json);\n\n        if (parsedResponse.success === false) {\n          const error = this.createError({\n            message: parsedResponse.message || \"Request failed\",\n            status: parsedResponse.code || res.status,\n            code: `API_ERROR_${parsedResponse.code}`,\n          });\n          this.errorHandler?.(error as unknown as E);\n          throw error;\n        }\n\n        responseData = parsedResponse.data;\n      }\n\n      if (!res.ok) {\n        const error = this.createError({\n          message: json.message || res.statusText,\n          status: res.status,\n          code: json.code,\n          title: json.title,\n          detail: json.detail,\n          errors: json.errors,\n        });\n        this.errorHandler?.(error as unknown as E);\n        throw error;\n      }\n\n      return this.responseTransform(endpoint.response.parse(responseData));\n    } catch (err: any) {\n      const error = this.normalizeError(err);\n      this.errorHandler?.(error as unknown as E);\n      throw error;\n    }\n  }\n\n  private async handleMockRequest<\n    TReq extends z.ZodTypeAny,\n    TRes extends z.ZodTypeAny\n  >(endpoint: EndpointDef<TReq, TRes>): Promise<z.infer<TRes>> {\n    const delay = this.getRandomDelay();\n    await new Promise((resolve) => setTimeout(resolve, delay));\n\n    let mockData: z.infer<TRes>;\n    if (typeof endpoint.mockData === \"function\") {\n      mockData = (endpoint.mockData as () => z.infer<TRes>)();\n    } else {\n      mockData = endpoint.mockData as z.infer<TRes>;\n    }\n\n    if (this.responseWrapper) {\n      const wrappedSchema = this.responseWrapper(endpoint.response);\n\n      const mockWrappedResponse = {\n        success: true,\n        data: mockData,\n        timestamp: new Date().toISOString(),\n        requestId: `mock-${Math.random().toString(36).substr(2, 9)}`,\n      };\n\n      const parsedWrappedResponse = wrappedSchema.parse(mockWrappedResponse);\n\n      return this.responseTransform(\n        endpoint.response.parse(parsedWrappedResponse.data)\n      );\n    }\n\n    return this.responseTransform(endpoint.response.parse(mockData));\n  }\n\n  private getRandomDelay(): number {\n    return (\n      Math.floor(\n        Math.random() * (this.mockDelay.max - this.mockDelay.min + 1)\n      ) + this.mockDelay.min\n    );\n  }\n\n  private createError(error: Partial<RichError> & { message: string }) {\n    return new RichError(error);\n  }\n\n  private normalizeError(err: any) {\n    if (err instanceof RichError) return err;\n    return this.createError({ message: err.message || \"Unknown error\" });\n  }\n}\n","import { Middleware } from \"@/types\";\n\nexport type LoggingOptions = {\n  logRequest?: boolean;\n  logResponse?: boolean;\n  debug?: boolean;\n};\n\nexport const loggingMiddleware: Middleware<LoggingOptions> = async (\n  ctx,\n  next,\n  options\n) => {\n  const { logRequest = true, logResponse = true, debug = true } = options || {};\n\n  if (debug && logRequest) console.log(\"➡️ Request:\", ctx.url, ctx.init);\n\n  const res = await next();\n\n  if (debug && logResponse) console.log(\"⬅️ Response:\", res.status);\n\n  return res;\n};\n","import { Middleware } from \"@/types\";\n\n\nexport type RetryOptions = {\n  maxRetries?: number;\n  delay?: number; // ms\n};\n\nexport const retryMiddleware = (options?: RetryOptions): Middleware => {\n  const { maxRetries = 3, delay = 500 } = options || {};\n\n  const middleware: Middleware = async (ctx, next) => {\n    let attempt = 0;\n    while (true) {\n      try {\n        return await next();\n      } catch (err) {\n        if (attempt >= maxRetries) throw err;\n        attempt++;\n        await new Promise((r) => setTimeout(r, delay * 2 ** attempt));\n      }\n    }\n  };\n\n  return middleware;\n};\n","import { Middleware } from \"@/types\";\n\nexport type AuthOptions = {\n  refreshToken?: () => Promise<string>;\n};\n\nexport const authMiddleware: Middleware<AuthOptions> = async (\n  ctx,\n  next,\n  options\n) => {\n  if (options?.refreshToken) {\n    try {\n      const newToken = await options.refreshToken();\n      ctx.init.headers = {\n        ...ctx.init.headers,\n        Authorization: `Bearer ${newToken}`,\n      };\n    } catch {}\n  }\n\n  return next();\n};\n","import { MiddlewareContext, MiddlewareNext } from \"@/types\";\n\nexport type CacheOptions = { ttl?: number };\n\nexport const cacheMiddleware = (options: CacheOptions = {}) => {\n  const { ttl = 60000 } = options;\n  const cache = new Map<string, { data: any; expires: number }>();\n\n  return async (ctx: MiddlewareContext, next: MiddlewareNext) => {\n    if (ctx.init.method === \"GET\") {\n      const cached = cache.get(ctx.url);\n      const now = Date.now();\n      if (cached && cached.expires > now)\n        return new Response(JSON.stringify(cached.data));\n\n      const res = await next();\n      const data = await res\n        .clone()\n        .json()\n        .catch(() => null);\n      if (data) cache.set(ctx.url, { data, expires: now + ttl });\n      return res;\n    }\n    return next();\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACUO,IAAM,YAAN,cAAwB,MAA2B;AAAA,EAOxD,YAAY,OAAiD;AAC3D,UAAM,MAAM,OAAO;AACnB,WAAO,OAAO,MAAM,KAAK;AAAA,EAC3B;AACF;AAEO,IAAM,YAAN,MAAsE;AAAA,EAY3E,YACU,QAMA,WACR;AAPQ;AAMA;AAlBV,SAAQ,cAAwD,CAAC;AAEjE,SAAQ,oBAAwC,CAAC,MAAM;AACvD,SAAQ,cAAuB;AAC/B,SAAQ,YAA0C,EAAE,KAAK,KAAK,KAAK,IAAK;AAgBtE,SAAK,cAAc,OAAO,eAAe;AACzC,SAAK,YAAY,OAAO,aAAa,EAAE,KAAK,KAAK,KAAK,IAAK;AAAA,EAC7D;AAAA,EAEA,OAAO;AACL,UAAM,UAAU,CAAC;AAIjB,eAAW,cAAc,KAAK,WAAW;AACvC,YAAMA,UAAS,KAAK,UAAU,UAAU;AACxC,MAAC,QAAgB,UAAU,IAAI,CAAC;AAEhC,iBAAW,gBAAgBA,SAAQ;AACjC,cAAM,WAAWA,QAAO,YAAY;AAEpC,QAAC,QAAgB,UAAU,EAAE,YAAY,IAAI,CAC3C,UACG,KAAK,QAAQ,UAAU,KAAK;AAAA,MACnC;AAAA,IACF;AAEA,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,IAAI,UAAU;AACZ,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAO,YAA2B,SAAa;AAC7C,SAAK,YAAY,KAAK,EAAE,IAAI,YAAY,QAAQ,CAAC;AAAA,EACnD;AAAA,EAEA,QAAQ,SAA6B;AACnC,SAAK,eAAe;AAAA,EACtB;AAAA,EAEA,qBAAqB,IAAwB;AAC3C,SAAK,oBAAoB;AAAA,EAC3B;AAAA,EAEA,YAAY,SAAkB,OAAsC;AAClE,SAAK,cAAc;AACnB,QAAI,OAAO;AACT,WAAK,YAAY;AAAA,IACnB;AAAA,EACF;AAAA,EAEA,mBAAmB,SAA0D;AAC3E,SAAK,kBAAkB;AAAA,EACzB;AAAA,EAEc,QACZ,UACA,OACwB;AAAA;AAnG5B;AAoGI,eAAS,QAAQ,MAAM,KAAK;AAE5B,UAAI,KAAK,eAAe,SAAS,UAAU;AACzC,eAAO,KAAK,kBAAkB,QAAQ;AAAA,MACxC;AAEA,UAAI,SAAS,QAAQ,CAAC,KAAK,OAAO,OAAO;AACvC,cAAM,QAAQ,KAAK,YAAY;AAAA,UAC7B,SAAS,qBAAqB,SAAS,IAAI;AAAA,UAC3C,QAAQ;AAAA,UACR,MAAM;AAAA,QACR,CAAC;AACD,mBAAK,iBAAL,8BAAoB;AACpB,cAAM;AAAA,MACR;AAEA,YAAM,UAAuB,EAAE,gBAAgB,mBAAmB;AAClE,UAAI,SAAS,QAAQ,KAAK,OAAO;AAC/B,gBAAQ,eAAe,IAAI,UAAU,KAAK,OAAO,KAAK;AAExD,YAAM,MAAM;AAAA,QACV,KAAK,KAAK,OAAO,UAAU,SAAS;AAAA,QACpC,MAAM;AAAA,UACJ,QAAQ,SAAS;AAAA,UACjB;AAAA,UACA,MAAM,SAAS,WAAW,QAAQ,KAAK,UAAU,KAAK,IAAI;AAAA,QAC5D;AAAA,MACF;AAEA,YAAM,SAAS,KAAK,YAAY;AAAA,QAC9B,CAAC,MAAM,OAAO,MAAM,GAAG,GAAG,KAAK,MAAM,GAAG,OAAO;AAAA,QAC/C,MAAM,MAAM,IAAI,KAAK,IAAI,IAAI;AAAA,MAC/B;AAEA,UAAI;AACF,cAAM,MAAM,MAAM,OAAO;AACzB,cAAM,OAAO,MAAM,IAAI,KAAK;AAE5B,YAAI,eAAe;AACnB,YAAI,KAAK,iBAAiB;AACxB,gBAAM,gBAAgB,KAAK,gBAAgB,SAAS,QAAQ;AAC5D,gBAAM,iBAAiB,cAAc,MAAM,IAAI;AAE/C,cAAI,eAAe,YAAY,OAAO;AACpC,kBAAM,QAAQ,KAAK,YAAY;AAAA,cAC7B,SAAS,eAAe,WAAW;AAAA,cACnC,QAAQ,eAAe,QAAQ,IAAI;AAAA,cACnC,MAAM,aAAa,eAAe,IAAI;AAAA,YACxC,CAAC;AACD,uBAAK,iBAAL,8BAAoB;AACpB,kBAAM;AAAA,UACR;AAEA,yBAAe,eAAe;AAAA,QAChC;AAEA,YAAI,CAAC,IAAI,IAAI;AACX,gBAAM,QAAQ,KAAK,YAAY;AAAA,YAC7B,SAAS,KAAK,WAAW,IAAI;AAAA,YAC7B,QAAQ,IAAI;AAAA,YACZ,MAAM,KAAK;AAAA,YACX,OAAO,KAAK;AAAA,YACZ,QAAQ,KAAK;AAAA,YACb,QAAQ,KAAK;AAAA,UACf,CAAC;AACD,qBAAK,iBAAL,8BAAoB;AACpB,gBAAM;AAAA,QACR;AAEA,eAAO,KAAK,kBAAkB,SAAS,SAAS,MAAM,YAAY,CAAC;AAAA,MACrE,SAAS,KAAU;AACjB,cAAM,QAAQ,KAAK,eAAe,GAAG;AACrC,mBAAK,iBAAL,8BAAoB;AACpB,cAAM;AAAA,MACR;AAAA,IACF;AAAA;AAAA,EAEc,kBAGZ,UAA2D;AAAA;AAC3D,YAAM,QAAQ,KAAK,eAAe;AAClC,YAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,KAAK,CAAC;AAEzD,UAAI;AACJ,UAAI,OAAO,SAAS,aAAa,YAAY;AAC3C,mBAAY,SAAS,SAAiC;AAAA,MACxD,OAAO;AACL,mBAAW,SAAS;AAAA,MACtB;AAEA,UAAI,KAAK,iBAAiB;AACxB,cAAM,gBAAgB,KAAK,gBAAgB,SAAS,QAAQ;AAE5D,cAAM,sBAAsB;AAAA,UAC1B,SAAS;AAAA,UACT,MAAM;AAAA,UACN,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,UAClC,WAAW,QAAQ,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,GAAG,CAAC,CAAC;AAAA,QAC5D;AAEA,cAAM,wBAAwB,cAAc,MAAM,mBAAmB;AAErE,eAAO,KAAK;AAAA,UACV,SAAS,SAAS,MAAM,sBAAsB,IAAI;AAAA,QACpD;AAAA,MACF;AAEA,aAAO,KAAK,kBAAkB,SAAS,SAAS,MAAM,QAAQ,CAAC;AAAA,IACjE;AAAA;AAAA,EAEQ,iBAAyB;AAC/B,WACE,KAAK;AAAA,MACH,KAAK,OAAO,KAAK,KAAK,UAAU,MAAM,KAAK,UAAU,MAAM;AAAA,IAC7D,IAAI,KAAK,UAAU;AAAA,EAEvB;AAAA,EAEQ,YAAY,OAAiD;AACnE,WAAO,IAAI,UAAU,KAAK;AAAA,EAC5B;AAAA,EAEQ,eAAe,KAAU;AAC/B,QAAI,eAAe,UAAW,QAAO;AACrC,WAAO,KAAK,YAAY,EAAE,SAAS,IAAI,WAAW,gBAAgB,CAAC;AAAA,EACrE;AACF;;;AC3NO,IAAM,oBAAgD,CAC3D,KACA,MACA,YACG;AACH,QAAM,EAAE,aAAa,MAAM,cAAc,MAAM,QAAQ,KAAK,IAAI,WAAW,CAAC;AAE5E,MAAI,SAAS,WAAY,SAAQ,IAAI,yBAAe,IAAI,KAAK,IAAI,IAAI;AAErE,QAAM,MAAM,MAAM,KAAK;AAEvB,MAAI,SAAS,YAAa,SAAQ,IAAI,0BAAgB,IAAI,MAAM;AAEhE,SAAO;AACT;;;ACdO,IAAM,kBAAkB,CAAC,YAAuC;AACrE,QAAM,EAAE,aAAa,GAAG,QAAQ,IAAI,IAAI,WAAW,CAAC;AAEpD,QAAM,aAAyB,CAAO,KAAK,SAAS;AAClD,QAAI,UAAU;AACd,WAAO,MAAM;AACX,UAAI;AACF,eAAO,MAAM,KAAK;AAAA,MACpB,SAAS,KAAK;AACZ,YAAI,WAAW,WAAY,OAAM;AACjC;AACA,cAAM,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,QAAQ,SAAK,QAAO,CAAC;AAAA,MAC9D;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;;;ACnBO,IAAM,iBAA0C,CACrD,KACA,MACA,YACG;AACH,MAAI,mCAAS,cAAc;AACzB,QAAI;AACF,YAAM,WAAW,MAAM,QAAQ,aAAa;AAC5C,UAAI,KAAK,UAAU,iCACd,IAAI,KAAK,UADK;AAAA,QAEjB,eAAe,UAAU,QAAQ;AAAA,MACnC;AAAA,IACF,SAAQ;AAAA,IAAC;AAAA,EACX;AAEA,SAAO,KAAK;AACd;;;AClBO,IAAM,kBAAkB,CAAC,UAAwB,CAAC,MAAM;AAC7D,QAAM,EAAE,MAAM,IAAM,IAAI;AACxB,QAAM,QAAQ,oBAAI,IAA4C;AAE9D,SAAO,CAAO,KAAwB,SAAyB;AAC7D,QAAI,IAAI,KAAK,WAAW,OAAO;AAC7B,YAAM,SAAS,MAAM,IAAI,IAAI,GAAG;AAChC,YAAM,MAAM,KAAK,IAAI;AACrB,UAAI,UAAU,OAAO,UAAU;AAC7B,eAAO,IAAI,SAAS,KAAK,UAAU,OAAO,IAAI,CAAC;AAEjD,YAAM,MAAM,MAAM,KAAK;AACvB,YAAM,OAAO,MAAM,IAChB,MAAM,EACN,KAAK,EACL,MAAM,MAAM,IAAI;AACnB,UAAI,KAAM,OAAM,IAAI,IAAI,KAAK,EAAE,MAAM,SAAS,MAAM,IAAI,CAAC;AACzD,aAAO;AAAA,IACT;AACA,WAAO,KAAK;AAAA,EACd;AACF;","names":["module"]}

package/dist/index.mjs

@@ -52,6 +52,10 @@ var ApiClient = class {
     this.contracts = contracts;
     this.middlewares = [];
     this.responseTransform = (d) => d;
+    this.useMockData = false;
+    this.mockDelay = { min: 100, max: 1e3 };
+    this.useMockData = config.useMockData || false;
+    this.mockDelay = config.mockDelay || { min: 100, max: 1e3 };
   }
   init() {
     const modules = {};
@@ -77,10 +81,22 @@ var ApiClient = class {
   useResponseTransform(fn) {
     this.responseTransform = fn;
   }
+  setMockMode(enabled, delay) {
+    this.useMockData = enabled;
+    if (delay) {
+      this.mockDelay = delay;
+    }
+  }
+  setResponseWrapper(wrapper) {
+    this.responseWrapper = wrapper;
+  }
   request(endpoint, input) {
     return __async(this, null, function* () {
-      var _a, _b, _c;
+      var _a, _b, _c, _d;
       endpoint.request.parse(input);
+      if (this.useMockData && endpoint.mockData) {
+        return this.handleMockRequest(endpoint);
+      }
       if (endpoint.auth && !this.config.token) {
         const error = this.createError({
           message: `Missing token for ${endpoint.path}`,
@@ -107,28 +123,73 @@ var ApiClient = class {
       );
       try {
         const res = yield runner();
+        const json = yield res.json();
+        let responseData = json;
+        if (this.responseWrapper) {
+          const wrappedSchema = this.responseWrapper(endpoint.response);
+          const parsedResponse = wrappedSchema.parse(json);
+          if (parsedResponse.success === false) {
+            const error = this.createError({
+              message: parsedResponse.message || "Request failed",
+              status: parsedResponse.code || res.status,
+              code: `API_ERROR_${parsedResponse.code}`
+            });
+            (_b = this.errorHandler) == null ? void 0 : _b.call(this, error);
+            throw error;
+          }
+          responseData = parsedResponse.data;
+        }
         if (!res.ok) {
-          const errorData = yield res.json().catch(() => ({}));
           const error = this.createError({
-            message: errorData.message || res.statusText,
+            message: json.message || res.statusText,
             status: res.status,
-            code: errorData.code,
-            title: errorData.title,
-            detail: errorData.detail,
-            errors: errorData.errors
+            code: json.code,
+            title: json.title,
+            detail: json.detail,
+            errors: json.errors
           });
-          (_b = this.errorHandler) == null ? void 0 : _b.call(this, error);
+          (_c = this.errorHandler) == null ? void 0 : _c.call(this, error);
           throw error;
         }
-        const json = yield res.json();
-        return this.responseTransform(endpoint.response.parse(json));
+        return this.responseTransform(endpoint.response.parse(responseData));
       } catch (err) {
         const error = this.normalizeError(err);
-        (_c = this.errorHandler) == null ? void 0 : _c.call(this, error);
+        (_d = this.errorHandler) == null ? void 0 : _d.call(this, error);
         throw error;
       }
     });
   }
+  handleMockRequest(endpoint) {
+    return __async(this, null, function* () {
+      const delay = this.getRandomDelay();
+      yield new Promise((resolve) => setTimeout(resolve, delay));
+      let mockData;
+      if (typeof endpoint.mockData === "function") {
+        mockData = endpoint.mockData();
+      } else {
+        mockData = endpoint.mockData;
+      }
+      if (this.responseWrapper) {
+        const wrappedSchema = this.responseWrapper(endpoint.response);
+        const mockWrappedResponse = {
+          success: true,
+          data: mockData,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          requestId: `mock-${Math.random().toString(36).substr(2, 9)}`
+        };
+        const parsedWrappedResponse = wrappedSchema.parse(mockWrappedResponse);
+        return this.responseTransform(
+          endpoint.response.parse(parsedWrappedResponse.data)
+        );
+      }
+      return this.responseTransform(endpoint.response.parse(mockData));
+    });
+  }
+  getRandomDelay() {
+    return Math.floor(
+      Math.random() * (this.mockDelay.max - this.mockDelay.min + 1)
+    ) + this.mockDelay.min;
+  }
   createError(error) {
     return new RichError(error);
   }

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/middlewares/logging.ts","../src/middlewares/retry.ts","../src/middlewares/auth.ts","../src/middlewares/cache.ts"],"sourcesContent":["import {\n  Contracts,\n  EndpointDef,\n  EndpointDefZ,\n  Middleware,\n  ErrorLike,\n  EndpointMethods,\n} from \"@/types\";\nimport { z } from \"zod\";\n\nexport class RichError extends Error implements ErrorLike {\n  status?: number;\n  code?: string;\n  title?: string;\n  detail?: string;\n  errors?: Record<string, string[]>;\n\n  constructor(error: Partial<ErrorLike> & { message: string }) {\n    super(error.message);\n    Object.assign(this, error);\n  }\n}\n\nexport class ApiClient<C extends Contracts, E extends ErrorLike = RichError> {\n  private middlewares: Array<{ fn: Middleware; options?: any }> = [];\n  private errorHandler?: (error: E) => void;\n  private responseTransform: (data: any) => any = (d) => d;\n\n  private _modules!: {\n    [M in keyof C]: EndpointMethods<C[M]>;\n  };\n\n  constructor(\n    private config: { baseUrl: string; token?: string },\n    private contracts: C\n  ) {}\n\n  init() {\n    const modules = {} as {\n      [M in keyof C]: EndpointMethods<C[M]>;\n    };\n\n    for (const moduleName in this.contracts) {\n      const module = this.contracts[moduleName];\n      (modules as any)[moduleName] = {} as EndpointMethods<typeof module>;\n\n      for (const endpointName in module) {\n        const endpoint = module[endpointName] as EndpointDefZ;\n\n        (modules as any)[moduleName][endpointName] = (\n          input: z.infer<(typeof endpoint)[\"request\"]>\n        ) => this.request(endpoint, input);\n      }\n    }\n\n    this._modules = modules;\n  }\n\n  get modules() {\n    return this._modules;\n  }\n\n  use<T>(middleware: Middleware<T>, options?: T) {\n    this.middlewares.push({ fn: middleware, options });\n  }\n\n  onError(handler: (error: E) => void) {\n    this.errorHandler = handler;\n  }\n\n  useResponseTransform(fn: (data: any) => any) {\n    this.responseTransform = fn;\n  }\n\n  private async request<TReq extends z.ZodTypeAny, TRes extends z.ZodTypeAny>(\n    endpoint: EndpointDef<TReq, TRes>,\n    input: z.infer<TReq>\n  ): Promise<z.infer<TRes>> {\n    endpoint.request.parse(input);\n\n    if (endpoint.auth && !this.config.token) {\n      const error = this.createError({\n        message: `Missing token for ${endpoint.path}`,\n        status: 401,\n        code: \"NO_TOKEN\",\n      });\n      this.errorHandler?.(error as unknown as E);\n      throw error;\n    }\n\n    const headers: HeadersInit = { \"Content-Type\": \"application/json\" };\n    if (endpoint.auth && this.config.token)\n      headers[\"Authorization\"] = `Bearer ${this.config.token}`;\n\n    const ctx = {\n      url: this.config.baseUrl + endpoint.path,\n      init: {\n        method: endpoint.method,\n        headers,\n        body: endpoint.method !== \"GET\" ? JSON.stringify(input) : undefined,\n      },\n    };\n\n    const runner = this.middlewares.reduceRight(\n      (next, mw) => () => mw.fn(ctx, next, mw.options),\n      () => fetch(ctx.url, ctx.init)\n    );\n\n    try {\n      const res = await runner();\n      if (!res.ok) {\n        const errorData = await res.json().catch(() => ({}));\n        const error = this.createError({\n          message: errorData.message || res.statusText,\n          status: res.status,\n          code: errorData.code,\n          title: errorData.title,\n          detail: errorData.detail,\n          errors: errorData.errors,\n        });\n        this.errorHandler?.(error as unknown as E);\n        throw error;\n      }\n\n      const json = await res.json();\n      return this.responseTransform(endpoint.response.parse(json));\n    } catch (err: any) {\n      const error = this.normalizeError(err);\n      this.errorHandler?.(error as unknown as E);\n      throw error;\n    }\n  }\n\n  private createError(error: Partial<RichError> & { message: string }) {\n    return new RichError(error);\n  }\n\n  private normalizeError(err: any) {\n    if (err instanceof RichError) return err;\n    return this.createError({ message: err.message || \"Unknown error\" });\n  }\n}\n","import { Middleware } from \"@/types\";\n\nexport type LoggingOptions = {\n  logRequest?: boolean;\n  logResponse?: boolean;\n  debug?: boolean;\n};\n\nexport const loggingMiddleware: Middleware<LoggingOptions> = async (\n  ctx,\n  next,\n  options\n) => {\n  const { logRequest = true, logResponse = true, debug = true } = options || {};\n\n  if (debug && logRequest) console.log(\"➡️ Request:\", ctx.url, ctx.init);\n\n  const res = await next();\n\n  if (debug && logResponse) console.log(\"⬅️ Response:\", res.status);\n\n  return res;\n};\n","import { Middleware } from \"@/types\";\n\n\nexport type RetryOptions = {\n  maxRetries?: number;\n  delay?: number; // ms\n};\n\nexport const retryMiddleware = (options?: RetryOptions): Middleware => {\n  const { maxRetries = 3, delay = 500 } = options || {};\n\n  const middleware: Middleware = async (ctx, next) => {\n    let attempt = 0;\n    while (true) {\n      try {\n        return await next();\n      } catch (err) {\n        if (attempt >= maxRetries) throw err;\n        attempt++;\n        await new Promise((r) => setTimeout(r, delay * 2 ** attempt));\n      }\n    }\n  };\n\n  return middleware;\n};\n","import { Middleware } from \"@/types\";\n\nexport type AuthOptions = {\n  refreshToken?: () => Promise<string>;\n};\n\nexport const authMiddleware: Middleware<AuthOptions> = async (\n  ctx,\n  next,\n  options\n) => {\n  if (options?.refreshToken) {\n    try {\n      const newToken = await options.refreshToken();\n      ctx.init.headers = {\n        ...ctx.init.headers,\n        Authorization: `Bearer ${newToken}`,\n      };\n    } catch {}\n  }\n\n  return next();\n};\n","import { MiddlewareContext, MiddlewareNext } from \"@/types\";\n\nexport type CacheOptions = { ttl?: number };\n\nexport const cacheMiddleware = (options: CacheOptions = {}) => {\n  const { ttl = 60000 } = options;\n  const cache = new Map<string, { data: any; expires: number }>();\n\n  return async (ctx: MiddlewareContext, next: MiddlewareNext) => {\n    if (ctx.init.method === \"GET\") {\n      const cached = cache.get(ctx.url);\n      const now = Date.now();\n      if (cached && cached.expires > now)\n        return new Response(JSON.stringify(cached.data));\n\n      const res = await next();\n      const data = await res\n        .clone()\n        .json()\n        .catch(() => null);\n      if (data) cache.set(ctx.url, { data, expires: now + ttl });\n      return res;\n    }\n    return next();\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUO,IAAM,YAAN,cAAwB,MAA2B;AAAA,EAOxD,YAAY,OAAiD;AAC3D,UAAM,MAAM,OAAO;AACnB,WAAO,OAAO,MAAM,KAAK;AAAA,EAC3B;AACF;AAEO,IAAM,YAAN,MAAsE;AAAA,EAS3E,YACU,QACA,WACR;AAFQ;AACA;AAVV,SAAQ,cAAwD,CAAC;AAEjE,SAAQ,oBAAwC,CAAC,MAAM;AAAA,EASpD;AAAA,EAEH,OAAO;AACL,UAAM,UAAU,CAAC;AAIjB,eAAW,cAAc,KAAK,WAAW;AACvC,YAAM,SAAS,KAAK,UAAU,UAAU;AACxC,MAAC,QAAgB,UAAU,IAAI,CAAC;AAEhC,iBAAW,gBAAgB,QAAQ;AACjC,cAAM,WAAW,OAAO,YAAY;AAEpC,QAAC,QAAgB,UAAU,EAAE,YAAY,IAAI,CAC3C,UACG,KAAK,QAAQ,UAAU,KAAK;AAAA,MACnC;AAAA,IACF;AAEA,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,IAAI,UAAU;AACZ,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAO,YAA2B,SAAa;AAC7C,SAAK,YAAY,KAAK,EAAE,IAAI,YAAY,QAAQ,CAAC;AAAA,EACnD;AAAA,EAEA,QAAQ,SAA6B;AACnC,SAAK,eAAe;AAAA,EACtB;AAAA,EAEA,qBAAqB,IAAwB;AAC3C,SAAK,oBAAoB;AAAA,EAC3B;AAAA,EAEc,QACZ,UACA,OACwB;AAAA;AA7E5B;AA8EI,eAAS,QAAQ,MAAM,KAAK;AAE5B,UAAI,SAAS,QAAQ,CAAC,KAAK,OAAO,OAAO;AACvC,cAAM,QAAQ,KAAK,YAAY;AAAA,UAC7B,SAAS,qBAAqB,SAAS,IAAI;AAAA,UAC3C,QAAQ;AAAA,UACR,MAAM;AAAA,QACR,CAAC;AACD,mBAAK,iBAAL,8BAAoB;AACpB,cAAM;AAAA,MACR;AAEA,YAAM,UAAuB,EAAE,gBAAgB,mBAAmB;AAClE,UAAI,SAAS,QAAQ,KAAK,OAAO;AAC/B,gBAAQ,eAAe,IAAI,UAAU,KAAK,OAAO,KAAK;AAExD,YAAM,MAAM;AAAA,QACV,KAAK,KAAK,OAAO,UAAU,SAAS;AAAA,QACpC,MAAM;AAAA,UACJ,QAAQ,SAAS;AAAA,UACjB;AAAA,UACA,MAAM,SAAS,WAAW,QAAQ,KAAK,UAAU,KAAK,IAAI;AAAA,QAC5D;AAAA,MACF;AAEA,YAAM,SAAS,KAAK,YAAY;AAAA,QAC9B,CAAC,MAAM,OAAO,MAAM,GAAG,GAAG,KAAK,MAAM,GAAG,OAAO;AAAA,QAC/C,MAAM,MAAM,IAAI,KAAK,IAAI,IAAI;AAAA,MAC/B;AAEA,UAAI;AACF,cAAM,MAAM,MAAM,OAAO;AACzB,YAAI,CAAC,IAAI,IAAI;AACX,gBAAM,YAAY,MAAM,IAAI,KAAK,EAAE,MAAM,OAAO,CAAC,EAAE;AACnD,gBAAM,QAAQ,KAAK,YAAY;AAAA,YAC7B,SAAS,UAAU,WAAW,IAAI;AAAA,YAClC,QAAQ,IAAI;AAAA,YACZ,MAAM,UAAU;AAAA,YAChB,OAAO,UAAU;AAAA,YACjB,QAAQ,UAAU;AAAA,YAClB,QAAQ,UAAU;AAAA,UACpB,CAAC;AACD,qBAAK,iBAAL,8BAAoB;AACpB,gBAAM;AAAA,QACR;AAEA,cAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,eAAO,KAAK,kBAAkB,SAAS,SAAS,MAAM,IAAI,CAAC;AAAA,MAC7D,SAAS,KAAU;AACjB,cAAM,QAAQ,KAAK,eAAe,GAAG;AACrC,mBAAK,iBAAL,8BAAoB;AACpB,cAAM;AAAA,MACR;AAAA,IACF;AAAA;AAAA,EAEQ,YAAY,OAAiD;AACnE,WAAO,IAAI,UAAU,KAAK;AAAA,EAC5B;AAAA,EAEQ,eAAe,KAAU;AAC/B,QAAI,eAAe,UAAW,QAAO;AACrC,WAAO,KAAK,YAAY,EAAE,SAAS,IAAI,WAAW,gBAAgB,CAAC;AAAA,EACrE;AACF;;;ACrIO,IAAM,oBAAgD,CAC3D,KACA,MACA,YACG;AACH,QAAM,EAAE,aAAa,MAAM,cAAc,MAAM,QAAQ,KAAK,IAAI,WAAW,CAAC;AAE5E,MAAI,SAAS,WAAY,SAAQ,IAAI,yBAAe,IAAI,KAAK,IAAI,IAAI;AAErE,QAAM,MAAM,MAAM,KAAK;AAEvB,MAAI,SAAS,YAAa,SAAQ,IAAI,0BAAgB,IAAI,MAAM;AAEhE,SAAO;AACT;;;ACdO,IAAM,kBAAkB,CAAC,YAAuC;AACrE,QAAM,EAAE,aAAa,GAAG,QAAQ,IAAI,IAAI,WAAW,CAAC;AAEpD,QAAM,aAAyB,CAAO,KAAK,SAAS;AAClD,QAAI,UAAU;AACd,WAAO,MAAM;AACX,UAAI;AACF,eAAO,MAAM,KAAK;AAAA,MACpB,SAAS,KAAK;AACZ,YAAI,WAAW,WAAY,OAAM;AACjC;AACA,cAAM,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,QAAQ,SAAK,QAAO,CAAC;AAAA,MAC9D;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;;;ACnBO,IAAM,iBAA0C,CACrD,KACA,MACA,YACG;AACH,MAAI,mCAAS,cAAc;AACzB,QAAI;AACF,YAAM,WAAW,MAAM,QAAQ,aAAa;AAC5C,UAAI,KAAK,UAAU,iCACd,IAAI,KAAK,UADK;AAAA,QAEjB,eAAe,UAAU,QAAQ;AAAA,MACnC;AAAA,IACF,SAAQ;AAAA,IAAC;AAAA,EACX;AAEA,SAAO,KAAK;AACd;;;AClBO,IAAM,kBAAkB,CAAC,UAAwB,CAAC,MAAM;AAC7D,QAAM,EAAE,MAAM,IAAM,IAAI;AACxB,QAAM,QAAQ,oBAAI,IAA4C;AAE9D,SAAO,CAAO,KAAwB,SAAyB;AAC7D,QAAI,IAAI,KAAK,WAAW,OAAO;AAC7B,YAAM,SAAS,MAAM,IAAI,IAAI,GAAG;AAChC,YAAM,MAAM,KAAK,IAAI;AACrB,UAAI,UAAU,OAAO,UAAU;AAC7B,eAAO,IAAI,SAAS,KAAK,UAAU,OAAO,IAAI,CAAC;AAEjD,YAAM,MAAM,MAAM,KAAK;AACvB,YAAM,OAAO,MAAM,IAChB,MAAM,EACN,KAAK,EACL,MAAM,MAAM,IAAI;AACnB,UAAI,KAAM,OAAM,IAAI,IAAI,KAAK,EAAE,MAAM,SAAS,MAAM,IAAI,CAAC;AACzD,aAAO;AAAA,IACT;AACA,WAAO,KAAK;AAAA,EACd;AACF;","names":[]}
+{"version":3,"sources":["../src/client.ts","../src/middlewares/logging.ts","../src/middlewares/retry.ts","../src/middlewares/auth.ts","../src/middlewares/cache.ts"],"sourcesContent":["import {\n  Contracts,\n  EndpointDef,\n  EndpointDefZ,\n  Middleware,\n  ErrorLike,\n  EndpointMethods,\n} from \"@/types\";\nimport { z } from \"zod\";\n\nexport class RichError extends Error implements ErrorLike {\n  status?: number;\n  code?: string;\n  title?: string;\n  detail?: string;\n  errors?: Record<string, string[]>;\n\n  constructor(error: Partial<ErrorLike> & { message: string }) {\n    super(error.message);\n    Object.assign(this, error);\n  }\n}\n\nexport class ApiClient<C extends Contracts, E extends ErrorLike = RichError> {\n  private middlewares: Array<{ fn: Middleware; options?: any }> = [];\n  private errorHandler?: (error: E) => void;\n  private responseTransform: (data: any) => any = (d) => d;\n  private useMockData: boolean = false;\n  private mockDelay: { min: number; max: number } = { min: 100, max: 1000 };\n  private responseWrapper?: (successResponse: z.ZodTypeAny) => z.ZodTypeAny;\n\n  private _modules!: {\n    [M in keyof C]: EndpointMethods<C[M]>;\n  };\n\n  constructor(\n    private config: {\n      baseUrl: string;\n      token?: string;\n      useMockData?: boolean;\n      mockDelay?: { min: number; max: number };\n    },\n    private contracts: C\n  ) {\n    this.useMockData = config.useMockData || false;\n    this.mockDelay = config.mockDelay || { min: 100, max: 1000 };\n  }\n\n  init() {\n    const modules = {} as {\n      [M in keyof C]: EndpointMethods<C[M]>;\n    };\n\n    for (const moduleName in this.contracts) {\n      const module = this.contracts[moduleName];\n      (modules as any)[moduleName] = {} as EndpointMethods<typeof module>;\n\n      for (const endpointName in module) {\n        const endpoint = module[endpointName] as EndpointDefZ;\n\n        (modules as any)[moduleName][endpointName] = (\n          input: z.infer<(typeof endpoint)[\"request\"]>\n        ) => this.request(endpoint, input);\n      }\n    }\n\n    this._modules = modules;\n  }\n\n  get modules() {\n    return this._modules;\n  }\n\n  use<T>(middleware: Middleware<T>, options?: T) {\n    this.middlewares.push({ fn: middleware, options });\n  }\n\n  onError(handler: (error: E) => void) {\n    this.errorHandler = handler;\n  }\n\n  useResponseTransform(fn: (data: any) => any) {\n    this.responseTransform = fn;\n  }\n\n  setMockMode(enabled: boolean, delay?: { min: number; max: number }) {\n    this.useMockData = enabled;\n    if (delay) {\n      this.mockDelay = delay;\n    }\n  }\n\n  setResponseWrapper(wrapper: (successResponse: z.ZodTypeAny) => z.ZodTypeAny) {\n    this.responseWrapper = wrapper;\n  }\n\n  private async request<TReq extends z.ZodTypeAny, TRes extends z.ZodTypeAny>(\n    endpoint: EndpointDef<TReq, TRes>,\n    input: z.infer<TReq>\n  ): Promise<z.infer<TRes>> {\n    endpoint.request.parse(input);\n\n    if (this.useMockData && endpoint.mockData) {\n      return this.handleMockRequest(endpoint);\n    }\n\n    if (endpoint.auth && !this.config.token) {\n      const error = this.createError({\n        message: `Missing token for ${endpoint.path}`,\n        status: 401,\n        code: \"NO_TOKEN\",\n      });\n      this.errorHandler?.(error as unknown as E);\n      throw error;\n    }\n\n    const headers: HeadersInit = { \"Content-Type\": \"application/json\" };\n    if (endpoint.auth && this.config.token)\n      headers[\"Authorization\"] = `Bearer ${this.config.token}`;\n\n    const ctx = {\n      url: this.config.baseUrl + endpoint.path,\n      init: {\n        method: endpoint.method,\n        headers,\n        body: endpoint.method !== \"GET\" ? JSON.stringify(input) : undefined,\n      },\n    };\n\n    const runner = this.middlewares.reduceRight(\n      (next, mw) => () => mw.fn(ctx, next, mw.options),\n      () => fetch(ctx.url, ctx.init)\n    );\n\n    try {\n      const res = await runner();\n      const json = await res.json();\n\n      let responseData = json;\n      if (this.responseWrapper) {\n        const wrappedSchema = this.responseWrapper(endpoint.response);\n        const parsedResponse = wrappedSchema.parse(json);\n\n        if (parsedResponse.success === false) {\n          const error = this.createError({\n            message: parsedResponse.message || \"Request failed\",\n            status: parsedResponse.code || res.status,\n            code: `API_ERROR_${parsedResponse.code}`,\n          });\n          this.errorHandler?.(error as unknown as E);\n          throw error;\n        }\n\n        responseData = parsedResponse.data;\n      }\n\n      if (!res.ok) {\n        const error = this.createError({\n          message: json.message || res.statusText,\n          status: res.status,\n          code: json.code,\n          title: json.title,\n          detail: json.detail,\n          errors: json.errors,\n        });\n        this.errorHandler?.(error as unknown as E);\n        throw error;\n      }\n\n      return this.responseTransform(endpoint.response.parse(responseData));\n    } catch (err: any) {\n      const error = this.normalizeError(err);\n      this.errorHandler?.(error as unknown as E);\n      throw error;\n    }\n  }\n\n  private async handleMockRequest<\n    TReq extends z.ZodTypeAny,\n    TRes extends z.ZodTypeAny\n  >(endpoint: EndpointDef<TReq, TRes>): Promise<z.infer<TRes>> {\n    const delay = this.getRandomDelay();\n    await new Promise((resolve) => setTimeout(resolve, delay));\n\n    let mockData: z.infer<TRes>;\n    if (typeof endpoint.mockData === \"function\") {\n      mockData = (endpoint.mockData as () => z.infer<TRes>)();\n    } else {\n      mockData = endpoint.mockData as z.infer<TRes>;\n    }\n\n    if (this.responseWrapper) {\n      const wrappedSchema = this.responseWrapper(endpoint.response);\n\n      const mockWrappedResponse = {\n        success: true,\n        data: mockData,\n        timestamp: new Date().toISOString(),\n        requestId: `mock-${Math.random().toString(36).substr(2, 9)}`,\n      };\n\n      const parsedWrappedResponse = wrappedSchema.parse(mockWrappedResponse);\n\n      return this.responseTransform(\n        endpoint.response.parse(parsedWrappedResponse.data)\n      );\n    }\n\n    return this.responseTransform(endpoint.response.parse(mockData));\n  }\n\n  private getRandomDelay(): number {\n    return (\n      Math.floor(\n        Math.random() * (this.mockDelay.max - this.mockDelay.min + 1)\n      ) + this.mockDelay.min\n    );\n  }\n\n  private createError(error: Partial<RichError> & { message: string }) {\n    return new RichError(error);\n  }\n\n  private normalizeError(err: any) {\n    if (err instanceof RichError) return err;\n    return this.createError({ message: err.message || \"Unknown error\" });\n  }\n}\n","import { Middleware } from \"@/types\";\n\nexport type LoggingOptions = {\n  logRequest?: boolean;\n  logResponse?: boolean;\n  debug?: boolean;\n};\n\nexport const loggingMiddleware: Middleware<LoggingOptions> = async (\n  ctx,\n  next,\n  options\n) => {\n  const { logRequest = true, logResponse = true, debug = true } = options || {};\n\n  if (debug && logRequest) console.log(\"➡️ Request:\", ctx.url, ctx.init);\n\n  const res = await next();\n\n  if (debug && logResponse) console.log(\"⬅️ Response:\", res.status);\n\n  return res;\n};\n","import { Middleware } from \"@/types\";\n\n\nexport type RetryOptions = {\n  maxRetries?: number;\n  delay?: number; // ms\n};\n\nexport const retryMiddleware = (options?: RetryOptions): Middleware => {\n  const { maxRetries = 3, delay = 500 } = options || {};\n\n  const middleware: Middleware = async (ctx, next) => {\n    let attempt = 0;\n    while (true) {\n      try {\n        return await next();\n      } catch (err) {\n        if (attempt >= maxRetries) throw err;\n        attempt++;\n        await new Promise((r) => setTimeout(r, delay * 2 ** attempt));\n      }\n    }\n  };\n\n  return middleware;\n};\n","import { Middleware } from \"@/types\";\n\nexport type AuthOptions = {\n  refreshToken?: () => Promise<string>;\n};\n\nexport const authMiddleware: Middleware<AuthOptions> = async (\n  ctx,\n  next,\n  options\n) => {\n  if (options?.refreshToken) {\n    try {\n      const newToken = await options.refreshToken();\n      ctx.init.headers = {\n        ...ctx.init.headers,\n        Authorization: `Bearer ${newToken}`,\n      };\n    } catch {}\n  }\n\n  return next();\n};\n","import { MiddlewareContext, MiddlewareNext } from \"@/types\";\n\nexport type CacheOptions = { ttl?: number };\n\nexport const cacheMiddleware = (options: CacheOptions = {}) => {\n  const { ttl = 60000 } = options;\n  const cache = new Map<string, { data: any; expires: number }>();\n\n  return async (ctx: MiddlewareContext, next: MiddlewareNext) => {\n    if (ctx.init.method === \"GET\") {\n      const cached = cache.get(ctx.url);\n      const now = Date.now();\n      if (cached && cached.expires > now)\n        return new Response(JSON.stringify(cached.data));\n\n      const res = await next();\n      const data = await res\n        .clone()\n        .json()\n        .catch(() => null);\n      if (data) cache.set(ctx.url, { data, expires: now + ttl });\n      return res;\n    }\n    return next();\n  };\n};\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tahanabavi/typefetch",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "A fully type-safe, extensible API client for TypeScript projects, featuring global error handling, configurable middleware, automatic retries, auth refresh, response transforms, and seamless contract integration. Designed for large-scale applications and developer-friendly API interactions.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",