@next-feature/client 0.1.1-beta.2 → 0.1.1-beta.5

package/lib/client.d.ts

@@ -0,0 +1,94 @@
+import { AxiosInstance, AxiosRequestConfig, InternalAxiosRequestConfig } from 'axios';
+/**
+ * Configuration options for the API client
+ */
+export interface ApiClientConfig {
+    baseURL: string;
+    timeout?: number;
+    enableRefreshToken?: boolean;
+    maxRetries?: number;
+    retryDelay?: number;
+    onAuthenticated?: (config: InternalAxiosRequestConfig) => void | Promise<void>;
+    onUnauthorized?: () => void | Promise<void>;
+    onRefreshTokenExpired?: () => void | Promise<void>;
+    onRefreshToken?: () => string | Promise<string>;
+}
+/**
+ * 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;
+    /**
+     * 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;
+    /**
+     * Update session with new token
+     * Implement this based on your Next.js auth setup
+     */
+    private updateSession;
+    /**
+     * 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;
+    /**
+     * Create ApiError from AxiosError
+     */
+    private createApiError;
+    /**
+     * Extract ProblemDetail from error response
+     */
+    private extractProblemDetail;
+    /**
+     * 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/error.d.ts

@@ -0,0 +1,53 @@
+import { HttpStatusCode } from 'axios';
+import { ZodError } from 'zod';
+/**
+ * Spring Boot ProblemDetail structure
+ */
+export interface ProblemDetail {
+    type: string;
+    title: string;
+    status: HttpStatusCode;
+    detail?: string;
+    instance?: string;
+    errors?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Custom error class for API errors
+ */
+export declare class ApiError extends Error {
+    status: HttpStatusCode;
+    problemDetail: ProblemDetail | null;
+    originalError?: Error;
+    constructor(status: HttpStatusCode, problemDetail: ProblemDetail | null, originalError?: Error, message?: string);
+    get isClientError(): boolean;
+    get isServerError(): boolean;
+    get isUnauthorized(): boolean;
+    get isForbidden(): boolean;
+    get isNotFound(): boolean;
+    static builder<T>(): ApiErrorBuilder;
+    static of(error: Error | unknown): ApiError;
+    /**
+     * Create ApiError from Zod validation error
+     */
+    static fromZodError(zodError: ZodError): ApiError;
+}
+export declare class ApiErrorBuilder<AdditionalProblemDetails = Record<string, unknown>> {
+    private _problemDetail;
+    private _status;
+    private _originalError;
+    private _message;
+    constructor();
+    /**
+     * Set standard ProblemDetail fields
+     */
+    detail<K extends keyof (ProblemDetail & AdditionalProblemDetails)>(key: K, value: K extends keyof ProblemDetail ? ProblemDetail[K] : K extends keyof AdditionalProblemDetails ? AdditionalProblemDetails[K] : unknown): ApiErrorBuilder<AdditionalProblemDetails>;
+    /**
+     * Set standard ProblemDetail fields
+     */
+    problemDetail(problemDetail: ProblemDetail): ApiErrorBuilder<AdditionalProblemDetails>;
+    originalError(error: Error): ApiErrorBuilder<AdditionalProblemDetails>;
+    status(status: HttpStatusCode): ApiErrorBuilder<AdditionalProblemDetails>;
+    message(msg: string): ApiErrorBuilder<AdditionalProblemDetails>;
+    build(): ApiError;
+}

package/{src/lib/types/index.ts → lib/types/index.d.ts}

@@ -1,13 +1,12 @@
 import { ProblemDetail } from '../error';
-
 /**
  * [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;
+    success?: boolean;
+    message?: string;
+    error?: ProblemDetail | null;
+    data: Response;
 }

package/lib/utils/error.d.ts

@@ -0,0 +1,26 @@
+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;
+/**
+ * Format ProblemDetail for display
+ */
+export declare function formatProblemDetail(error: ApiError): string;
+/**
+ * Check if error is a specific HTTP status
+ */
+export declare function isHttpStatus(error: unknown, status: number): boolean;
+/**
+ * Handle common API errors
+ */
+export declare function handleApiError(error: unknown): void;
+/**
+ * Validation error extractor for Spring Boot validation errors
+ */
+export declare function extractValidationErrors(error: ApiError): Record<string, string[]> | null;

package/lib/utils/helper.d.ts

@@ -0,0 +1,8 @@
+import { ProblemDetail } from '../error';
+/**
+ * [show-error-toast]
+ * next-feature@0.0.11-beta
+ * November 4th 2025, 11:58:52 am
+ */
+export declare function showErrorToast(data: any): any;
+export declare function getFieldError(error: ProblemDetail | undefined, fieldName: string): string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@next-feature/client",
-  "version": "0.1.1-beta.2",
+  "version": "0.1.1-beta.5",
   "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,
-  };
-}