@next-feature/client 0.0.1

package/lib/client.d.ts

@@ -0,0 +1,68 @@
+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;
+    /**
+     * 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/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,19 @@
+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;
+    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

@@ -0,0 +1,17 @@
+{
+  "name": "@next-feature/client",
+  "version": "0.0.1",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./index.mjs",
+      "require": "./index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "default": "./dist/server.js"
+    }
+  }
+}

package/server.js

@@ -0,0 +1 @@
+