@next-feature/client 0.1.1 → 0.1.2-2

package/lib/client.d.ts

@@ -0,0 +1,72 @@
+import { AxiosInstance, AxiosRequestConfig } from 'axios';
+import { ApiClientConfig } from './types/client';
+/**
+ * Axios wrapper with JWT/Refresh token handling
+ */
+export declare class ApiClient {
+    private readonly instance;
+    private isRefreshing;
+    private pendingRequests;
+    private config;
+    constructor(config: ApiClientConfig);
+    /**
+     * Setup request and response interceptors
+     */
+    private setupInterceptors;
+    /**
+     * Attach JWT token to request headers
+     */
+    private handleRequestFulfilled;
+    /**
+     * Handle request errors
+     */
+    private handleRequestRejected;
+    /**
+     * Pass through successful responses
+     */
+    private handleResponseFulfilled;
+    /**
+     * Check if a path should skip the refresh token logic
+     */
+    private shouldSkipRefresh;
+    /**
+     * Handle response errors with retry logic and token refresh
+     */
+    private handleResponseRejected;
+    /**
+     * Handle 401 errors with token refresh
+     */
+    private handleUnauthorizedError;
+    /**
+     * Refresh the JWT token using the refresh token
+     */
+    private refreshToken;
+    /**
+     * Process all pending requests after token refresh
+     */
+    private processPendingRequests;
+    /**
+     * Determine if request should be retried
+     */
+    private shouldRetry;
+    /**
+     * Retry failed request with exponential backoff
+     */
+    private retryRequest;
+    /**
+     * Sleep helper for retry delays
+     */
+    private sleep;
+    /**
+     * HTTP Methods with proper typing
+     */
+    get<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    post<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    put<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    patch<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    delete<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    /**
+     * Get the underlying Axios instance for advanced usage
+     */
+    getAxiosInstance(): AxiosInstance;
+}

package/lib/config/index.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+declare const envSchema: z.ZodObject<{
+    NODE_ENV: z.ZodEnum<["development", "production"]>;
+    CLIENT_API_URL: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    NODE_ENV?: "development" | "production";
+    CLIENT_API_URL?: string;
+}, {
+    NODE_ENV?: "development" | "production";
+    CLIENT_API_URL?: string;
+}>;
+declare global {
+    namespace NodeJS {
+        interface ProcessEnv extends z.infer<typeof envSchema> {
+        }
+    }
+}
+export declare const NODE_ENV: "development" | "production" | "test";
+export declare const BACKEND_API_URL: string;
+export {};

package/lib/error.d.ts

@@ -0,0 +1,35 @@
+import { HttpStatusCode } from 'axios';
+import { ProblemDetail } from './types';
+/**
+ * Custom error class for API errors
+ */
+export declare class ApiError extends Error {
+    problemDetail: ProblemDetail;
+    originalError?: Error;
+    constructor(problemDetail: ProblemDetail, originalError?: Error);
+    get status(): HttpStatusCode;
+    get body(): ProblemDetail;
+    get isClientError(): boolean;
+    get isServerError(): boolean;
+    get isUnauthorized(): boolean;
+    get isForbidden(): boolean;
+    get isNotFound(): boolean;
+    static builder(): ApiErrorBuilder;
+    static of(error: Error | unknown): ApiError;
+}
+export declare class ApiErrorBuilder {
+    private _originalError;
+    private _problemDetail;
+    constructor(_originalError: Error | null);
+    /**
+     * Set standard ProblemDetail
+     */
+    problemDetail(problemDetail: ProblemDetail): ApiErrorBuilder;
+    originalError(error: Error): ApiErrorBuilder;
+    message(msg: string): ApiErrorBuilder;
+    status(status: HttpStatusCode): ApiErrorBuilder;
+    errors(errors: Record<string, string>): ApiErrorBuilder;
+    title(title: string): ApiErrorBuilder;
+    instance(instance: string): ApiErrorBuilder;
+    build(): ApiError;
+}

package/lib/types/client.d.ts

@@ -0,0 +1,24 @@
+import { InternalAxiosRequestConfig } from 'axios';
+/**
+ * Configuration options for the API client
+ *
+ * [api-client-config]
+ * next-feature@0.1.1-beta.5
+ * January 11th 2026, 9:00:22 pm
+ */
+export interface ApiClientConfig {
+    baseURL: string;
+    timeout?: number;
+    enableRefreshToken?: boolean;
+    maxRetries?: number;
+    retryDelay?: number;
+    /**
+     * Paths that should skip the refresh token logic on 401.
+     * Useful for login/register endpoints that expect 401 as a valid response.
+     */
+    skipRefreshPaths?: RegExp[];
+    onAuthenticated?: (config: InternalAxiosRequestConfig) => void | Promise<void>;
+    onUnauthorized?: () => void | Promise<void>;
+    onRefreshTokenExpired?: () => void | Promise<void>;
+    onRefreshToken?: () => string | Promise<string>;
+}

package/lib/types/index.d.ts

@@ -0,0 +1,27 @@
+import { HttpStatusCode } from 'axios';
+/**
+ * [api-response]
+ * next-feature@0.0.11-beta
+ * November 4th 2025, 6:37:27 pm
+ */
+export interface ApiResponse<Response> {
+    success?: boolean;
+    message?: string;
+    error?: ProblemDetail;
+    data: Response;
+}
+/**
+ * Spring Boot ProblemDetail structure
+ *
+ * [problem-detail]
+ * next-feature@0.1.1-beta.5
+ * January 11th 2026, 8:55:50 pm
+ */
+export interface ProblemDetail {
+    type: string;
+    title: string;
+    status: HttpStatusCode;
+    detail: string;
+    instance?: string;
+    errors?: Record<string, string>;
+}

package/lib/utils/axios.d.ts

@@ -0,0 +1,7 @@
+import { AxiosError } from 'axios';
+/**
+ * [handle-axios-error]
+ * next-feature@0.1.1-beta.5
+ * January 11th 2026, 9:37:55 pm
+ */
+export declare function handleAxiosError(e: AxiosError): import('../error').ApiError;

package/lib/utils/error.d.ts

@@ -0,0 +1,19 @@
+import { ApiError } from '../error';
+/**
+ * Extract user-friendly error message from ApiError
+ *
+ * [get-error-message]
+ * next-feature@0.0.11-beta
+ * November 4th 2025, 11:47:45 am
+ *
+ */
+export declare function getErrorMessage(error: unknown): string;
+/**
+ * Check if error is a specific HTTP status
+ */
+export declare function isHttpStatus(error: unknown, status: number): boolean;
+/**
+ * Handle common API errors
+ */
+declare function handleApiError(error: unknown): ApiError;
+export default handleApiError;

package/lib/utils/zod.d.ts

@@ -0,0 +1,10 @@
+import { ZodError } from 'zod';
+import { ApiError } from '../error';
+/**
+ * Create ApiError from Zod validation error
+ *
+ * [handle-zod-error]
+ * next-feature@0.1.1-beta.5
+ * January 11th 2026, 9:40:46 pm
+ */
+export declare function handleZodError(zodError: ZodError): ApiError;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@next-feature/client",
-  "version": "0.1.1",
+  "version": "0.1.2-2",
   "main": "./index.js",
   "types": "./index.d.ts",
   "exports": {

package/server.js

@@ -0,0 +1 @@
+

package/.babelrc

@@ -1,12 +0,0 @@
-{
-  "presets": [
-    [
-      "@nx/react/babel",
-      {
-        "runtime": "automatic",
-        "useBuiltIns": "usage"
-      }
-    ]
-  ],
-  "plugins": []
-}

package/eslint.config.mjs

@@ -1,12 +0,0 @@
-import nx from '@nx/eslint-plugin';
-import baseConfig from '../../eslint.config.mjs';
-
-export default [
-  ...baseConfig,
-  ...nx.configs['flat/react'],
-  {
-    files: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx'],
-    // Override or add rules here
-    rules: {},
-  },
-];

package/jest.config.cts

@@ -1,10 +0,0 @@
-module.exports = {
-  displayName: 'client',
-  preset: '../../jest.preset.js',
-  transform: {
-    '^(?!.*\\.(js|jsx|ts|tsx|css|json)$)': '@nx/react/plugins/jest',
-    '^.+\\.[tj]sx?$': ['babel-jest', { presets: ['@nx/react/babel'] }],
-  },
-  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx'],
-  coverageDirectory: '../../coverage/clients/client',
-};

package/project.json

@@ -1,32 +0,0 @@
-{
-  "name": "client",
-  "$schema": "../../node_modules/nx/schemas/project-schema.json",
-  "sourceRoot": "clients/client/src",
-  "projectType": "library",
-  "tags": [],
-  "targets": {
-    "build": {
-      "executor": "@nx/vite:build",
-      "outputs": ["{options.outputPath}"],
-      "defaultConfiguration": "production",
-      "options": {
-        "outputPath": "dist/clients/client"
-      },
-      "configurations": {
-        "development": {
-          "mode": "development"
-        },
-        "production": {
-          "mode": "production"
-        }
-      }
-    },
-    "test": {
-      "executor": "@nx/jest:jest",
-      "outputs": ["{workspaceRoot}/coverage/{projectRoot}"],
-      "options": {
-        "jestConfig": "clients/client/jest.config.cts"
-      }
-    }
-  }
-}

package/src/components/api-error-boundary.tsx

@@ -1,58 +0,0 @@
-'use client';
-
-import React, { Component, ErrorInfo, ReactNode } from 'react';
-import { ApiError } from '../lib/error';
-import { getErrorMessage } from '../lib/utils/error';
-
-interface Props {
-  children: ReactNode;
-  fallback?: (error: ApiError) => ReactNode;
-  onError?: (error: Error, errorInfo: ErrorInfo) => void;
-}
-
-interface State {
-  hasError: boolean;
-  error: Error | null;
-}
-
-export class ApiErrorBoundary extends Component<Props, State> {
-  constructor(props: Props) {
-    super(props);
-    this.state = { hasError: false, error: null };
-  }
-
-  static getDerivedStateFromError(error: Error): State {
-    return { hasError: true, error };
-  }
-
-  componentDidCatch(error: Error, errorInfo: ErrorInfo) {
-    console.error('ApiErrorBoundary caught error:', error, errorInfo);
-
-    if (this.props.onError) {
-      this.props.onError(error, errorInfo);
-    }
-  }
-
-  render() {
-    if (this.state.hasError && this.state.error) {
-      if (this.state.error instanceof ApiError && this.props.fallback) {
-        return this.props.fallback(this.state.error);
-      }
-
-      // Default error UI
-      return (
-        <div className="error-container">
-          <h2>Something went wrong</h2>
-          <p>{getErrorMessage(this.state.error)}</p>
-          <button
-            onClick={() => this.setState({ hasError: false, error: null })}
-          >
-            Try again
-          </button>
-        </div>
-      );
-    }
-
-    return this.props.children;
-  }
-}

package/src/hooks/use-api-error.tsx

@@ -1,39 +0,0 @@
-'use client';
-
-import { useState, useCallback } from 'react';
-import { ApiError } from '../lib/error';
-import { getErrorMessage } from '../lib/utils/error';
-
-interface UseApiErrorResult {
-  error: ApiError | null;
-  setError: (error: ApiError | null) => void;
-  clearError: () => void;
-  handleError: (error: unknown) => void;
-  errorMessage: string | null;
-}
-
-export function useApiError(): UseApiErrorResult {
-  const [error, setError] = useState<ApiError | null>(null);
-
-  const clearError = useCallback(() => {
-    setError(null);
-  }, []);
-
-  const handleError = useCallback((err: unknown) => {
-    if (err instanceof ApiError) {
-      setError(err);
-    } else {
-      console.error('Non-API error:', err);
-    }
-  }, []);
-
-  const errorMessage = error ? getErrorMessage(error) : null;
-
-  return {
-    error,
-    setError,
-    clearError,
-    handleError,
-    errorMessage,
-  };
-}