@nocios/crudify-ui 1.0.70 → 1.0.71

package/dist/index.d.ts

@@ -1,11 +1,10 @@
-import * as _nocios_crudify_browser from '@nocios/crudify-browser';
 export * from '@nocios/crudify-browser';
 export { default as crudify } from '@nocios/crudify-browser';
 import React from 'react';
 
 type BoxScreenType = "login" | "signUp" | "forgotPassword" | "resetPassword" | "checkCode";
 interface CrudifyLoginConfig {
-    publicApiKey?: string;
+    publicApiKey?: string | null;
     env?: "dev" | "stg" | "api" | "prod";
     appName?: string;
     logo?: string;
@@ -35,13 +34,94 @@ interface CrudifyLoginProps {
 
 declare const CrudifyLogin: React.FC<CrudifyLoginProps>;
 
+interface CrudifyApiResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    errors?: string | Record<string, string[]> | string[];
+    errorCode?: string;
+    fieldsWarning?: Record<string, string[]>;
+}
+interface CrudifyTransactionResponse {
+    success: boolean;
+    data?: TransactionResponseData[];
+    errors?: string | Record<string, string[]>;
+    errorCode?: string;
+}
+interface TransactionResponseData {
+    response?: {
+        status: string;
+        data?: unknown;
+        message?: string;
+    };
+    errors?: string | Record<string, string[]>;
+}
+interface UserProfile {
+    id: string | number;
+    email: string;
+    username?: string;
+    firstName?: string;
+    lastName?: string;
+    fullName?: string;
+    avatar?: string;
+    role?: string;
+    permissions?: string[];
+    lastLogin?: string;
+    isActive?: boolean;
+    createdAt?: string;
+    updatedAt?: string;
+    [key: string]: unknown;
+}
+interface LoginResponse {
+    token: string;
+    user?: UserProfile;
+    expiresIn?: number;
+    refreshToken?: string;
+}
+interface LoginRequest {
+    identifier: string;
+    password: string;
+}
+interface ForgotPasswordRequest {
+    email: string;
+}
+interface ResetPasswordRequest {
+    email: string;
+    code: string;
+    newPassword: string;
+}
+interface ValidateCodeRequest {
+    email: string;
+    codePassword: string;
+}
+interface JwtPayload {
+    sub?: string;
+    email?: string;
+    username?: string;
+    iat?: number;
+    exp?: number;
+    iss?: string;
+    aud?: string;
+    [key: string]: unknown;
+}
+interface ApiError {
+    code: string;
+    message: string;
+    field?: string;
+    details?: Record<string, unknown>;
+}
+interface ValidationError {
+    field: string;
+    message: string;
+    code: string;
+}
+
 interface UseUserProfileOptions {
     autoFetch?: boolean;
     retryOnError?: boolean;
     maxRetries?: number;
 }
 interface UseUserProfileReturn {
-    userProfile: any | null;
+    userProfile: UserProfile | null;
     loading: boolean;
     error: string | null;
     refreshProfile: () => Promise<void>;
@@ -54,21 +134,16 @@ interface UseCrudifyLoginOptions {
     showSuccessNotifications?: boolean;
 }
 declare const useCrudifyLogin: (config: CrudifyLoginConfig, _options?: UseCrudifyLoginOptions) => {
-    crudify: {
-        login: (identifier: string, password: string) => Promise<_nocios_crudify_browser.CrudifyResponse>;
-        transaction: (data: any, options?: any) => Promise<_nocios_crudify_browser.CrudifyResponse>;
-    } | null;
+    config: {
+        publicApiKey: string | null;
+        env: "dev" | "stg" | "prod";
+        appName: string;
+        loginActions: string[];
+    };
 };
 
-interface JWTPayload {
-    email?: string;
+interface JWTPayload extends JwtPayload {
     "cognito:username"?: string;
-    sub?: string;
-    exp?: number;
-    iat?: number;
-    iss?: string;
-    aud?: string;
-    [key: string]: any;
 }
 declare const decodeJwtSafely: (token: string) => JWTPayload | null;
 declare const getCurrentUserEmail: () => string | null;
@@ -90,4 +165,57 @@ declare class SecureStorage {
 declare const secureSessionStorage: SecureStorage;
 declare const secureLocalStorage: SecureStorage;
 
-export { type BoxScreenType, CrudifyLogin, type CrudifyLoginConfig, type CrudifyLoginProps, type CrudifyLoginTranslations, decodeJwtSafely, getCookie, getCurrentUserEmail, isTokenExpired, secureLocalStorage, secureSessionStorage, useCrudifyLogin, useUserProfile };
+declare const ERROR_CODES: {
+    readonly INVALID_CREDENTIALS: "INVALID_CREDENTIALS";
+    readonly UNAUTHORIZED: "UNAUTHORIZED";
+    readonly INVALID_API_KEY: "INVALID_API_KEY";
+    readonly USER_NOT_FOUND: "USER_NOT_FOUND";
+    readonly USER_NOT_ACTIVE: "USER_NOT_ACTIVE";
+    readonly NO_PERMISSION: "NO_PERMISSION";
+    readonly ITEM_NOT_FOUND: "ITEM_NOT_FOUND";
+    readonly NOT_FOUND: "NOT_FOUND";
+    readonly IN_USE: "IN_USE";
+    readonly FIELD_ERROR: "FIELD_ERROR";
+    readonly BAD_REQUEST: "BAD_REQUEST";
+    readonly INVALID_EMAIL: "INVALID_EMAIL";
+    readonly INVALID_CODE: "INVALID_CODE";
+    readonly INTERNAL_SERVER_ERROR: "INTERNAL_SERVER_ERROR";
+    readonly DATABASE_CONNECTION_ERROR: "DATABASE_CONNECTION_ERROR";
+    readonly INVALID_CONFIGURATION: "INVALID_CONFIGURATION";
+    readonly UNKNOWN_OPERATION: "UNKNOWN_OPERATION";
+    readonly TOO_MANY_REQUESTS: "TOO_MANY_REQUESTS";
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+    readonly TIMEOUT_ERROR: "TIMEOUT_ERROR";
+};
+type ErrorCode = typeof ERROR_CODES[keyof typeof ERROR_CODES];
+type ErrorSeverity = 'info' | 'warning' | 'error' | 'critical';
+declare const ERROR_SEVERITY_MAP: Record<ErrorCode, ErrorSeverity>;
+interface ParsedError {
+    code: ErrorCode;
+    message: string;
+    severity: ErrorSeverity;
+    field?: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * Parse a Crudify API response and extract standardized error information
+ */
+declare function parseApiError(response: unknown): ParsedError[];
+/**
+ * Parse transaction response errors
+ */
+declare function parseTransactionError(response: unknown): ParsedError[];
+/**
+ * Get a human-readable error message for an error code
+ */
+declare function getErrorMessage(code: ErrorCode): string;
+/**
+ * Handle JavaScript/Network errors and convert to ParsedError
+ */
+declare function parseJavaScriptError(error: unknown): ParsedError;
+/**
+ * Universal error handler that can process any type of error from Crudify APIs
+ */
+declare function handleCrudifyError(error: unknown): ParsedError[];
+
+export { type ApiError, type BoxScreenType, type CrudifyApiResponse, CrudifyLogin, type CrudifyLoginConfig, type CrudifyLoginProps, type CrudifyLoginTranslations, type CrudifyTransactionResponse, ERROR_CODES, ERROR_SEVERITY_MAP, type ErrorCode, type ErrorSeverity, type ForgotPasswordRequest, type JwtPayload, type LoginRequest, type LoginResponse, type ParsedError, type ResetPasswordRequest, type TransactionResponseData, type UserProfile, type ValidateCodeRequest, type ValidationError, decodeJwtSafely, getCookie, getCurrentUserEmail, getErrorMessage, handleCrudifyError, isTokenExpired, parseApiError, parseJavaScriptError, parseTransactionError, secureLocalStorage, secureSessionStorage, useCrudifyLogin, useUserProfile };