@appcorp/stellar-solutions-modules 0.1.56 → 0.1.59

package/global-modules/currency/actions.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * Currency Actions
+ *
+ * This module defines all action types and interfaces for the Currency state management.
+ * Actions are organized by functionality and follow consistent naming patterns.
+ *
+ * Organization:
+ * - Action Types Enum (grouped by functionality)
+ * - Reset Actions (form/error reset)
+ * - Form Data Actions (input fields, form state)
+ * - UI State Actions (drawers, buttons)
+ * - List Management Actions (currencies, pagination)
+ * - Search Actions (queries)
+ * - Union Type Export
+ * - Action Creators (helper functions)
+ * - Type Utilities (guards and helpers)
+ *
+ * Naming Convention: Currency{Operation}{Target}Action
+ * Examples: CurrencySetInputFieldAction, CurrencyResetFormAction
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isCurrencyAction = exports.createSetSearchQueryAction = exports.createSetPageLimitAction = exports.createSetCurrentPageAction = exports.createSetCountAction = exports.createSetCurrenciesAction = exports.createSetDrawerAction = exports.createSetDisableSaveButtonAction = exports.createSetErrorsAction = exports.createSetFormAction = exports.createSetInputFieldAction = exports.createResetFormAction = exports.createResetErrorsAction = exports.CURRENCY_ACTION_TYPES = void 0;
+// ============================================================================
+// ACTION TYPES ENUM
+// ============================================================================
+var CURRENCY_ACTION_TYPES;
+(function (CURRENCY_ACTION_TYPES) {
+    // Reset Actions
+    CURRENCY_ACTION_TYPES["RESET_ERRORS"] = "RESET_ERRORS";
+    CURRENCY_ACTION_TYPES["RESET_FORM"] = "RESET_FORM";
+    // Form Data Actions
+    CURRENCY_ACTION_TYPES["SET_INPUT_FIELD"] = "SET_INPUT_FIELD";
+    CURRENCY_ACTION_TYPES["SET_FORM"] = "SET_FORM";
+    CURRENCY_ACTION_TYPES["SET_ERRORS"] = "SET_ERRORS";
+    // UI State Actions
+    CURRENCY_ACTION_TYPES["SET_DISABLE_SAVE_BUTTON"] = "SET_DISABLE_SAVE_BUTTON";
+    CURRENCY_ACTION_TYPES["SET_DRAWER"] = "SET_DRAWER";
+    // List Management Actions
+    CURRENCY_ACTION_TYPES["SET_CURRENCIES"] = "SET_CURRENCIES";
+    CURRENCY_ACTION_TYPES["SET_COUNT"] = "SET_COUNT";
+    CURRENCY_ACTION_TYPES["SET_CURRENT_PAGE"] = "SET_CURRENT_PAGE";
+    CURRENCY_ACTION_TYPES["SET_PAGE_LIMIT"] = "SET_PAGE_LIMIT";
+    // Search Actions
+    CURRENCY_ACTION_TYPES["SET_SEARCH_QUERY"] = "SET_SEARCH_QUERY";
+})(CURRENCY_ACTION_TYPES || (exports.CURRENCY_ACTION_TYPES = CURRENCY_ACTION_TYPES = {}));
+// ============================================================================
+// ACTION CREATORS (Helper Functions)
+// ============================================================================
+/**
+ * Create a reset errors action
+ */
+var createResetErrorsAction = function () { return ({
+    type: CURRENCY_ACTION_TYPES.RESET_ERRORS,
+}); };
+exports.createResetErrorsAction = createResetErrorsAction;
+/**
+ * Create a reset form action
+ */
+var createResetFormAction = function () { return ({
+    type: CURRENCY_ACTION_TYPES.RESET_FORM,
+}); };
+exports.createResetFormAction = createResetFormAction;
+/**
+ * Create a set input field action
+ */
+var createSetInputFieldAction = function (key, value) { return ({
+    type: CURRENCY_ACTION_TYPES.SET_INPUT_FIELD,
+    payload: { key: key, value: value },
+}); };
+exports.createSetInputFieldAction = createSetInputFieldAction;
+/**
+ * Create a set form action
+ */
+var createSetFormAction = function (form) { return ({
+    type: CURRENCY_ACTION_TYPES.SET_FORM,
+    payload: { form: form },
+}); };
+exports.createSetFormAction = createSetFormAction;
+/**
+ * Create a set errors action
+ */
+var createSetErrorsAction = function (errors) { return ({
+    type: CURRENCY_ACTION_TYPES.SET_ERRORS,
+    payload: { errors: errors },
+}); };
+exports.createSetErrorsAction = createSetErrorsAction;
+/**
+ * Create a set disable save button action
+ */
+var createSetDisableSaveButtonAction = function (disableSaveButton) { return ({
+    type: CURRENCY_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
+    payload: { disableSaveButton: disableSaveButton },
+}); };
+exports.createSetDisableSaveButtonAction = createSetDisableSaveButtonAction;
+/**
+ * Create a set drawer action
+ */
+var createSetDrawerAction = function (drawer) { return ({
+    type: CURRENCY_ACTION_TYPES.SET_DRAWER,
+    payload: { drawer: drawer },
+}); };
+exports.createSetDrawerAction = createSetDrawerAction;
+/**
+ * Create a set currencies action
+ */
+var createSetCurrenciesAction = function (currencies) { return ({
+    type: CURRENCY_ACTION_TYPES.SET_CURRENCIES,
+    payload: { currencies: currencies },
+}); };
+exports.createSetCurrenciesAction = createSetCurrenciesAction;
+/**
+ * Create a set count action
+ */
+var createSetCountAction = function (count) { return ({
+    type: CURRENCY_ACTION_TYPES.SET_COUNT,
+    payload: { count: count },
+}); };
+exports.createSetCountAction = createSetCountAction;
+/**
+ * Create a set current page action
+ */
+var createSetCurrentPageAction = function (currentPage) { return ({
+    type: CURRENCY_ACTION_TYPES.SET_CURRENT_PAGE,
+    payload: { currentPage: currentPage },
+}); };
+exports.createSetCurrentPageAction = createSetCurrentPageAction;
+/**
+ * Create a set page limit action
+ */
+var createSetPageLimitAction = function (pageLimit) { return ({
+    type: CURRENCY_ACTION_TYPES.SET_PAGE_LIMIT,
+    payload: { pageLimit: pageLimit },
+}); };
+exports.createSetPageLimitAction = createSetPageLimitAction;
+/**
+ * Create a set search query action
+ */
+var createSetSearchQueryAction = function (searchQuery) { return ({
+    type: CURRENCY_ACTION_TYPES.SET_SEARCH_QUERY,
+    payload: { searchQuery: searchQuery },
+}); };
+exports.createSetSearchQueryAction = createSetSearchQueryAction;
+// ============================================================================
+// TYPE UTILITIES (Guards and Helpers)
+// ============================================================================
+/**
+ * Type guard to check if an action is a Currency action
+ */
+var isCurrencyAction = function (action) {
+    return Object.values(CURRENCY_ACTION_TYPES).includes(action === null || action === void 0 ? void 0 : action.type);
+};
+exports.isCurrencyAction = isCurrencyAction;

package/global-modules/currency/constants.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Currency Constants
+ *
+ * This module defines all constants used throughout the Currency module.
+ * Constants are organized by functionality and follow consistent naming patterns.
+ *
+ * Organization:
+ * - Page Configuration (pagination, limits)
+ * - API Routes (backend endpoints)
+ * - Table Configuration (column definitions)
+ *
+ * Naming Convention: Descriptive names with clear purpose
+ */
+import { COMPONENT_TYPE } from "@appcorp/shadcn/components/enhanced-table";
+/**
+ * Default page limit for pagination
+ */
+export declare const pageLimit: number;
+/**
+ * API endpoints for currency operations
+ */
+export declare const CURRENCY_API_ROUTES: {
+    readonly CURRENCIES: "/api/currencies";
+    readonly CURRENCY: "/api/currency";
+    readonly CURRENCY_BY_ID: "/api/currency/currency-by-id";
+};
+/**
+ * Table column definitions for currency listing
+ */
+export declare const tableBodyCols: {
+    componentType: COMPONENT_TYPE;
+    key: string;
+}[];

package/global-modules/currency/constants.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Currency Constants
+ *
+ * This module defines all constants used throughout the Currency module.
+ * Constants are organized by functionality and follow consistent naming patterns.
+ *
+ * Organization:
+ * - Page Configuration (pagination, limits)
+ * - API Routes (backend endpoints)
+ * - Table Configuration (column definitions)
+ *
+ * Naming Convention: Descriptive names with clear purpose
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tableBodyCols = exports.CURRENCY_API_ROUTES = exports.pageLimit = void 0;
+var enhanced_table_1 = require("@appcorp/shadcn/components/enhanced-table");
+// ============================================================================
+// PAGE CONFIGURATION
+// ============================================================================
+/**
+ * Default page limit for pagination
+ */
+exports.pageLimit = Number(process.env.NEXT_PUBLIC_PAGE_LIMIT);
+// ============================================================================
+// API ROUTES
+// ============================================================================
+/**
+ * API endpoints for currency operations
+ */
+exports.CURRENCY_API_ROUTES = {
+    CURRENCIES: "/api/currencies",
+    CURRENCY: "/api/currency",
+    CURRENCY_BY_ID: "/api/currency/currency-by-id",
+};
+// ============================================================================
+// TABLE CONFIGURATION
+// ============================================================================
+/**
+ * Table column definitions for currency listing
+ */
+exports.tableBodyCols = [
+    {
+        componentType: enhanced_table_1.COMPONENT_TYPE.ID,
+        key: "id",
+    },
+    {
+        componentType: enhanced_table_1.COMPONENT_TYPE.BOLD_TEXT,
+        key: "label",
+    },
+    {
+        componentType: enhanced_table_1.COMPONENT_TYPE.TEXT,
+        key: "code",
+    },
+    {
+        componentType: enhanced_table_1.COMPONENT_TYPE.BOOLEAN,
+        key: "enabled",
+    },
+    {
+        componentType: enhanced_table_1.COMPONENT_TYPE.BOOLEAN,
+        key: "isDefault",
+    },
+    {
+        componentType: enhanced_table_1.COMPONENT_TYPE.CREATED_UPDATED_AT,
+        key: "createdAt",
+    },
+    {
+        componentType: enhanced_table_1.COMPONENT_TYPE.ACTIONS,
+        key: "action",
+    },
+];

package/global-modules/currency/context.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Currency State Context
+ *
+ * This module provides comprehensive state management for the Currency feature including:
+ * - CRUD operations (create, read, update, delete)
+ * - Form validation and error handling
+ * - Search and filtering functionality
+ * - Pagination controls
+ * - Internationalization support
+ * - Theme-aware toast notifications
+ *
+ * Organization:
+ * - Types & Interfaces
+ * - Main Hook (useCurrencyState)
+ *   - State & Core Hooks
+ *   - Debounced Values
+ *   - API Parameters (memoized)
+ *   - API Callbacks (with error handling)
+ *   - Module Entity Hook
+ *   - Effects (list refresh)
+ *   - Drawer & Modal Handlers
+ *   - CRUD Operation Handlers
+ *   - Form Handlers
+ *   - Pagination Handlers
+ *   - Search Handlers
+ *   - Table Actions (memoized)
+ *   - Return State
+ * - Context Setup
+ * - Provider Component
+ * - Custom Hook
+ */
+import React, { FC, ReactNode } from "react";
+import { CurrencyContextType, CurrencyState } from "./types";
+type State = CurrencyContextType & CurrencyState;
+interface StateProviderProps {
+    children: ReactNode;
+}
+export declare const CurrencyStateContext: React.Context<State>;
+export declare const CurrencyStateContextProvider: FC<StateProviderProps>;
+export declare const useCurrencyStateContext: () => State;
+export {};