@navegarti/rn-design-system 0.2.0

package/lib/typescript/src/utils.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Utils module entry point.
+ * Exports all utility functions from the design system.
+ */
+export { camelCase } from './utils/camelCase';
+export { camelCaseJSONKeys } from './utils/camelCaseJSONKeys';
+export { capitalizeWord } from './utils/capitalizeWord';
+export { createLinkingPhoneNumberString } from './utils/createLinkingPhoneNumberString';
+export * from './utils/dateFormatters';
+export { debounce } from './utils/debounce';
+export { deepLinkParser } from './utils/deepLinkParser';
+export { getAge } from './utils/getAge';
+export { getOnlyNumbers } from './utils/getOnlyNumbers';
+export { isArray } from './utils/isArray';
+export { isObject } from './utils/isObject';
+export { Masks } from './utils/masks';
+export { priceFormatter } from './utils/priceFormatter';
+export { removeTextAccents } from './utils/removeTextAccents';
+export { shadowStyledIos } from './utils/shadowStyledIos';
+export { sortBy } from './utils/sortBy';
+export { uniqBy } from './utils/uniqBy';
+export { userFullnameInitialsExtractor } from './utils/userFullnameInitialsExtractor';
+//# sourceMappingURL=utils.d.ts.map

package/lib/typescript/src/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/utils.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AACxF,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC"}

package/package.json

@@ -0,0 +1,234 @@
+{
+  "name": "@navegarti/rn-design-system",
+  "version": "0.2.0",
+  "description": "Components and functions to help navegar projects",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "private": false,
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./components": {
+      "source": "./src/components.tsx",
+      "types": "./lib/typescript/src/components.d.ts",
+      "default": "./lib/module/components.js"
+    },
+    "./utils": {
+      "source": "./src/utils.tsx",
+      "types": "./lib/typescript/src/utils.d.ts",
+      "default": "./lib/module/utils.js"
+    },
+    "./form": {
+      "source": "./src/form.tsx",
+      "types": "./lib/typescript/src/form.d.ts",
+      "default": "./lib/module/form.js"
+    },
+    "./hooks": {
+      "source": "./src/hooks.tsx",
+      "types": "./lib/typescript/src/hooks.d.ts",
+      "default": "./lib/module/hooks.js"
+    },
+    "./api": {
+      "source": "./src/api.tsx",
+      "types": "./lib/typescript/src/api.d.ts",
+      "default": "./lib/module/api.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace @navegarti/rn-design-system-example",
+    "clean": "del-cli lib",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "biome check --write --unsafe; biome format --write",
+    "test": "jest",
+    "release": "release-it --only-version"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://bitbucket.org/navegar/navegar-design-system/.git"
+  },
+  "author": "Lucas Rodrigues Paixão <lucas.paixao@navegarti.com.br> (https://bitbucket.org/navegar/navegar-design-system/)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://bitbucket.org/navegar/navegar-design-system//issues"
+  },
+  "homepage": "https://bitbucket.org/navegar/navegar-design-system/#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.14",
+    "@commitlint/config-conventional": "^20.4.1",
+    "@react-native-community/netinfo": "^11.5.2",
+    "@react-native-picker/picker": "^2.11.4",
+    "@react-native/babel-preset": "0.83.1",
+    "@release-it/conventional-changelog": "^10.0.5",
+    "@types/jest": "^30.0.0",
+    "@types/prop-types": "^15",
+    "@types/react": "^19.2.13",
+    "commitlint": "^20.4.1",
+    "del-cli": "^7.0.0",
+    "expo-checkbox": "^5.0.8",
+    "jail-monkey": "^2.8.4",
+    "jest": "^30.2.0",
+    "lefthook": "^2.1.0",
+    "prettier": "^3.8.1",
+    "prop-types": "^15.8.1",
+    "react": "19.2.4",
+    "react-native": "0.83.1",
+    "react-native-builder-bob": "^0.40.17",
+    "react-native-nitro-modules": "^0.33.7",
+    "react-native-permissions": "^5.4.4",
+    "release-it": "^19.2.4",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "@react-native-community/netinfo": ">=11.0.0",
+    "@react-native-picker/picker": ">=2.0.0",
+    "expo-checkbox": ">=3.0.0",
+    "jail-monkey": ">=2.0.0",
+    "react": "*",
+    "react-native": "*",
+    "react-native-nitro-modules": "^0.33.7",
+    "react-native-permissions": ">=4.0.0",
+    "react-native-svg": ">=15.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@react-native-community/netinfo": {
+      "optional": true
+    },
+    "@react-native-picker/picker": {
+      "optional": true
+    },
+    "expo-checkbox": {
+      "optional": true
+    },
+    "jail-monkey": {
+      "optional": true
+    },
+    "react-native-permissions": {
+      "optional": true
+    }
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ],
+    "rules": {
+      "body-max-line-length": [
+        0,
+        "always"
+      ]
+    }
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "library",
+    "languages": "js",
+    "tools": [
+      "jest",
+      "lefthook",
+      "release-it"
+    ],
+    "version": "0.57.0"
+  },
+  "dependencies": {
+    "@emotion/native": "^11.11.0",
+    "@emotion/react": "^11.14.0",
+    "@fnando/cnpj": "^2.0.0",
+    "@fnando/cpf": "^1.0.2",
+    "@tanstack/react-form": "^1.28.0",
+    "@tanstack/react-query": "^5.90.20",
+    "axios": "^1.13.5",
+    "date-fns": "^4.1.0",
+    "libphonenumber-js": "^1.12.36",
+    "lucide-react-native": "^0.563.0",
+    "react-native-mask-input": "^1.2.3",
+    "react-native-picker-select": "^9.3.1",
+    "zod": "^4.3.6",
+    "zustand": "^5.0.11"
+  }
+}

package/src/api/axios-adapter.ts

@@ -0,0 +1,272 @@
+import axios, {
+  type AxiosError,
+  type AxiosInstance,
+  type AxiosRequestConfig,
+  type AxiosResponse,
+} from 'axios';
+import {
+  AuthError,
+  NetworkError,
+  NotFoundError,
+  RateLimitError,
+  ServerError,
+  TimeoutError,
+  ValidationError,
+} from './errors';
+import { executeWithRetry } from './retry-strategy';
+import { useAuthStore } from './stores/auth-store';
+import type {
+  ApiConfig,
+  ApiResponse,
+  IHttpAdapter,
+  RetryConfig,
+} from './types';
+
+/**
+ * Axios-based HTTP adapter implementation
+ * Implements retry logic, error handling, and token management
+ */
+export class AxiosAdapter implements IHttpAdapter {
+  private readonly axiosInstance: AxiosInstance;
+  private readonly retryConfig: RetryConfig;
+
+  constructor(config: ApiConfig) {
+    // Initialize axios instance with configuration
+    this.axiosInstance = axios.create({
+      baseURL: config.baseURL,
+      timeout: config.timeout ?? 30000, // 30 seconds default
+      headers: {
+        'Content-Type': 'application/json',
+        ...config.headers,
+      },
+    });
+
+    // Configure retry behavior
+    this.retryConfig = {
+      maxAttempts: config.retryAttempts ?? 3,
+      baseDelay: 1000, // 1 second
+      maxDelay: 10000, // 10 seconds
+      retryableStatusCodes: [408, 429, 500, 502, 503, 504],
+    };
+
+    // Setup request interceptor to inject auth token
+    this.setupRequestInterceptor();
+  }
+
+  /**
+   * Sets up request interceptor to automatically add auth token
+   */
+  private setupRequestInterceptor(): void {
+    this.axiosInstance.interceptors.request.use(
+      (config) => {
+        const token = useAuthStore.getState().token;
+
+        if (token && config.headers) {
+          config.headers.Authorization = `Bearer ${token}`;
+        }
+
+        return config;
+      },
+      (error) => Promise.reject(error),
+    );
+  }
+
+  /**
+   * Maps axios error to appropriate custom error type
+   */
+  private mapError(error: AxiosError, url?: string, method?: string): Error {
+    // Network errors (no response received)
+    if (!error.response) {
+      if (error.code === 'ECONNABORTED' || error.message.includes('timeout')) {
+        return new TimeoutError(
+          'Request timeout - server took too long to respond',
+          url,
+          method,
+        );
+      }
+      return new NetworkError(
+        error.message || 'Network error - please check your connection',
+        url,
+        method,
+      );
+    }
+
+    const statusCode = error.response.status;
+    const responseData = error.response.data as {
+      message?: string;
+      errors?: Record<string, string[]>;
+    };
+    const message =
+      responseData?.message || error.message || 'An error occurred';
+
+    // Map status codes to error types
+    switch (true) {
+      case statusCode === 401 || statusCode === 403:
+        return new AuthError(message, statusCode, url, method);
+
+      case statusCode === 404:
+        return new NotFoundError(message, url, method);
+
+      case statusCode === 429:
+        return new RateLimitError(
+          message,
+          url,
+          method,
+          Number(error.response.headers['retry-after']),
+        );
+
+      case statusCode === 400 || statusCode === 422:
+        return new ValidationError(
+          message,
+          statusCode,
+          url,
+          method,
+          responseData?.errors,
+        );
+
+      case statusCode >= 500:
+        return new ServerError(message, statusCode, url, method);
+
+      default:
+        return new NetworkError(message, url, method);
+    }
+  }
+
+  /**
+   * Transforms axios response to standardized ApiResponse format
+   */
+  private transformResponse<T>(response: AxiosResponse<T>): ApiResponse<T> {
+    return {
+      success: true,
+      data: response.data,
+      statusCode: response.status,
+      error: '',
+    };
+  }
+
+  /**
+   * Transforms error to standardized ApiResponse format
+   */
+  private transformError<T>(error: Error, statusCode = 0): ApiResponse<T> {
+    return {
+      success: false,
+      data: null,
+      statusCode,
+      error: error.message,
+    } as ApiResponse<T>;
+  }
+
+  /**
+   * Executes HTTP request with retry logic and error handling
+   */
+  private async executeRequest<T>(
+    requestFn: () => Promise<AxiosResponse<T>>,
+    url?: string,
+    method?: string,
+  ): Promise<ApiResponse<T>> {
+    try {
+      const response = await executeWithRetry(
+        requestFn,
+        this.retryConfig,
+        (attempt, delay, error) => {
+          console.log(
+            `[API Retry] Attempt ${attempt} failed, retrying in ${delay}ms...`,
+            error.message,
+          );
+        },
+      );
+
+      return this.transformResponse(response);
+    } catch (error) {
+      const mappedError = this.mapError(error as AxiosError, url, method);
+      const statusCode =
+        mappedError instanceof NetworkError
+          ? 0
+          : ((mappedError as { statusCode?: number }).statusCode ?? 0);
+
+      console.error('[API Error]', mappedError);
+
+      return this.transformError(mappedError, statusCode);
+    }
+  }
+
+  /**
+   * Performs GET request
+   */
+  async get<T = unknown>(
+    url: string,
+    config?: AxiosRequestConfig,
+  ): Promise<ApiResponse<T>> {
+    return this.executeRequest(
+      () => this.axiosInstance.get<T>(url, config),
+      url,
+      'GET',
+    );
+  }
+
+  /**
+   * Performs POST request
+   */
+  async post<T = unknown>(
+    url: string,
+    data?: unknown,
+    config?: AxiosRequestConfig,
+  ): Promise<ApiResponse<T>> {
+    return this.executeRequest(
+      () => this.axiosInstance.post<T>(url, data, config),
+      url,
+      'POST',
+    );
+  }
+
+  /**
+   * Performs PUT request
+   */
+  async put<T = unknown>(
+    url: string,
+    data?: unknown,
+    config?: AxiosRequestConfig,
+  ): Promise<ApiResponse<T>> {
+    return this.executeRequest(
+      () => this.axiosInstance.put<T>(url, data, config),
+      url,
+      'PUT',
+    );
+  }
+
+  /**
+   * Performs DELETE request
+   */
+  async delete<T = unknown>(
+    url: string,
+    config?: AxiosRequestConfig,
+  ): Promise<ApiResponse<T>> {
+    return this.executeRequest(
+      () => this.axiosInstance.delete<T>(url, config),
+      url,
+      'DELETE',
+    );
+  }
+
+  /**
+   * Adds authentication token to store
+   * Token will be automatically included in all subsequent requests
+   */
+  addToken(token: string): void {
+    useAuthStore.getState().setToken(token);
+  }
+
+  /**
+   * Removes authentication token from store
+   */
+  removeToken(): void {
+    useAuthStore.getState().clearToken();
+  }
+
+  /**
+   * Get token from store
+   */
+  getToken(): string | null {
+    return useAuthStore.getState().token;
+  }
+}

package/src/api/errors.ts

@@ -0,0 +1,113 @@
+/**
+ * Base class for all API errors
+ * Provides common structure and debugging information
+ */
+export class ApiError extends Error {
+  public readonly statusCode: number;
+  public readonly url?: string;
+  public readonly method?: string;
+  public readonly timestamp: Date;
+
+  constructor(
+    message: string,
+    statusCode: number,
+    url?: string,
+    method?: string,
+  ) {
+    super(message);
+    this.name = this.constructor.name;
+    this.statusCode = statusCode;
+    this.url = url;
+    this.method = method;
+    this.timestamp = new Date();
+
+    // Maintains proper stack trace for where our error was thrown (only available on V8)
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, this.constructor);
+    }
+  }
+
+  /**
+   * Returns a formatted error message for debugging
+   */
+  toDebugString(): string {
+    return `[${this.name}] ${this.message}\nStatus: ${this.statusCode}\nURL: ${this.url}\nMethod: ${this.method}\nTime: ${this.timestamp.toISOString()}`;
+  }
+}
+
+/**
+ * Network-related errors (no internet, DNS failure, timeout)
+ * HTTP Status: N/A (network layer)
+ */
+export class NetworkError extends ApiError {
+  constructor(message: string, url?: string, method?: string) {
+    super(message, 0, url, method);
+  }
+}
+
+/**
+ * Authentication errors (401, 403)
+ * Client lacks valid credentials or permissions
+ */
+export class AuthError extends ApiError {}
+
+/**
+ * Client validation errors (400, 422)
+ * Request malformed or validation failed
+ */
+export class ValidationError extends ApiError {
+  public readonly validationErrors?: Record<string, string[]>;
+
+  constructor(
+    message: string,
+    statusCode: number,
+    url?: string,
+    method?: string,
+    validationErrors?: Record<string, string[]>,
+  ) {
+    super(message, statusCode, url, method);
+    this.validationErrors = validationErrors;
+  }
+}
+
+/**
+ * Server errors (500, 502, 503, 504)
+ * Something went wrong on the server
+ */
+export class ServerError extends ApiError {}
+
+/**
+ * Request timeout errors
+ * Request took too long to complete
+ */
+export class TimeoutError extends ApiError {
+  constructor(message: string, url?: string, method?: string) {
+    super(message, 408, url, method);
+  }
+}
+
+/**
+ * Resource not found errors (404)
+ */
+export class NotFoundError extends ApiError {
+  constructor(message: string, url?: string, method?: string) {
+    super(message, 404, url, method);
+  }
+}
+
+/**
+ * Rate limit errors (429)
+ */
+export class RateLimitError extends ApiError {
+  public readonly retryAfter?: number;
+
+  constructor(
+    message: string,
+    url?: string,
+    method?: string,
+    retryAfter?: number,
+  ) {
+    super(message, 429, url, method);
+    this.retryAfter = retryAfter;
+  }
+}

package/src/api/index.ts

@@ -0,0 +1,27 @@
+import { AxiosAdapter } from './axios-adapter';
+
+/**
+ * Default API request instance
+ * Pre-configured with default settings
+ *
+ * Usage:
+ * ```typescript
+ * import { apiRequest } from '@navegarti/rn-design-system/api';
+ *
+ * const response = await apiRequest.get<User>('/users/123');
+ * if (response.success) {
+ *   console.log(response.data);
+ * }
+ * ```
+ */
+export const apiRequest = new AxiosAdapter({
+  baseURL: 'https://api.example.com', // Will be overridden by consumers
+  timeout: 30000,
+  retryAttempts: 3,
+});
+
+export { AxiosAdapter } from './axios-adapter';
+export * from './errors';
+export { useAuthStore } from './stores/auth-store';
+// Re-export types and classes for consumer use
+export * from './types';