@ramesesinc/platform-core 0.1.0

package/dist/components/table/ListHandler.js

@@ -0,0 +1,197 @@
+/**
+ * ListHandler - Functional style implementation for managing data fetching,
+ * pagination, filtering, and sorting for DataList, DataTable, or any list-like components.
+ */
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { localAPI } from "@ramesesinc/lib/local-api";
+// FIX: removed the erroneous second parameter `ListHandlerConfig: any`
+export const ListHandler = (config) => {
+    var _a;
+    const api = config.api;
+    const cols = config.cols;
+    const _b = (_a = config.params) !== null && _a !== void 0 ? _a : {}, { filter = {} } = _b, rest = __rest(_b, ["filter"]);
+    const disableTotalCount = config.disableTotalCount || false;
+    const useCursorPagination = config.useCursorPagination || false;
+    let rowsPerPage = config.rowsPerPage || 20;
+    let currentPage = 1;
+    let customFilter = {};
+    let searchText = "";
+    let sortColumn = null;
+    let sortDirection = null;
+    let lastCursor = null;
+    let dataResult = [];
+    let totalRecordCount = 0;
+    let totalPageCount = 0;
+    let hasMorePages = false;
+    const getData = () => dataResult;
+    const load = async () => {
+        var _a, _b;
+        const queryParams = {
+            cols,
+            start: (currentPage - 1) * rowsPerPage,
+            limit: rowsPerPage,
+            filter: Object.assign(Object.assign({}, filter), customFilter),
+        };
+        if (useCursorPagination && lastCursor) {
+            queryParams.cursor = lastCursor;
+        }
+        if (disableTotalCount) {
+            queryParams.skipCount = true;
+        }
+        if (searchText) {
+            queryParams.search = searchText;
+        }
+        if (sortColumn && sortDirection) {
+            queryParams.sort = { column: sortColumn, direction: sortDirection };
+        }
+        try {
+            // console.log("datalist pass 1", { api, query: { ...queryParams, ...rest } });
+            const result = await localAPI.exec(`/services/exec/${config.tenant}/${config.module}/${api}`, Object.assign(Object.assign({}, queryParams), rest));
+            // console.log("datalist pass 2", { result });
+            dataResult = result.data || [];
+            if (useCursorPagination) {
+                lastCursor = (_a = result.nextCursor) !== null && _a !== void 0 ? _a : null;
+                hasMorePages = (_b = result.hasMore) !== null && _b !== void 0 ? _b : false;
+            }
+            if (!disableTotalCount) {
+                totalRecordCount = result.total || 0;
+                totalPageCount = result.totalPages || Math.ceil(totalRecordCount / rowsPerPage);
+            }
+            else {
+                hasMorePages = result.data && result.data.length === rowsPerPage;
+            }
+        }
+        catch (error) {
+            console.error("Error loading data:", error);
+            dataResult = [];
+            totalRecordCount = 0;
+            totalPageCount = 0;
+            hasMorePages = false;
+            throw error;
+        }
+    };
+    const reset = async () => {
+        currentPage = 1;
+        await load();
+    };
+    const moveNextPage = async () => {
+        if (hasNextPage()) {
+            currentPage++;
+            await load();
+        }
+    };
+    const movePrevPage = async () => {
+        if (hasPrevPage()) {
+            currentPage--;
+            await load();
+        }
+    };
+    const moveFirstPage = async () => {
+        currentPage = 1;
+        await load();
+    };
+    const moveLastPage = async () => {
+        if (disableTotalCount) {
+            console.warn("moveLastPage is not available when total count is disabled");
+            return;
+        }
+        if (totalPageCount > 0) {
+            currentPage = totalPageCount;
+            await load();
+        }
+    };
+    const moveToPage = async (page) => {
+        if (page >= 1 && page <= totalPageCount) {
+            currentPage = page;
+            await load();
+        }
+        else {
+            console.warn(`Invalid page number: ${page}. Must be between 1 and ${totalPageCount}`);
+        }
+    };
+    const setFilter = async (filter) => {
+        customFilter = Object.assign({}, filter);
+        currentPage = 1;
+        await load();
+    };
+    const resetFilter = async () => {
+        customFilter = {};
+        currentPage = 1;
+        await load();
+    };
+    const doSearch = async (text) => {
+        searchText = text;
+        currentPage = 1;
+        await load();
+    };
+    const sortAsc = async (column) => {
+        sortColumn = column;
+        sortDirection = "asc";
+        currentPage = 1;
+        await load();
+    };
+    const sortDesc = async (column) => {
+        sortColumn = column;
+        sortDirection = "desc";
+        currentPage = 1;
+        await load();
+    };
+    const setRowsPerPage = async (rows) => {
+        if (rows > 0) {
+            rowsPerPage = rows;
+            currentPage = 1;
+            await load();
+        }
+    };
+    const hasNextPage = () => {
+        if (disableTotalCount || useCursorPagination)
+            return hasMorePages;
+        return currentPage < totalPageCount;
+    };
+    const hasPrevPage = () => currentPage > 1;
+    const getTotalPageCount = () => totalPageCount;
+    const getTotalRecordCount = () => totalRecordCount;
+    const getCurrentPage = () => currentPage;
+    const getCurrentSortedColumn = () => sortColumn;
+    const getCurrentSortDirection = () => sortDirection;
+    const getRowsPerPage = () => rowsPerPage;
+    const getSearchText = () => searchText;
+    const getCustomFilter = () => (Object.assign({}, customFilter));
+    return {
+        getData,
+        load,
+        reset,
+        moveNextPage,
+        movePrevPage,
+        moveFirstPage,
+        moveLastPage,
+        moveToPage,
+        setFilter,
+        resetFilter,
+        doSearch,
+        sortAsc,
+        sortDesc,
+        setRowsPerPage,
+        hasNextPage,
+        hasPrevPage,
+        getTotalPageCount,
+        getTotalRecordCount,
+        getCurrentPage,
+        getCurrentSortedColumn,
+        getCurrentSortDirection,
+        getRowsPerPage,
+        getSearchText,
+        getCustomFilter,
+    };
+};
+export default ListHandler;

package/dist/components/table/ListHandler.ts

@@ -0,0 +1,276 @@
+/**
+ * ListHandler - Functional style implementation for managing data fetching,
+ * pagination, filtering, and sorting for DataList, DataTable, or any list-like components.
+ */
+
+import { localAPI } from "@ramesesinc/lib/local-api";
+
+export interface ListHandlerConfig {
+  tenant: string;
+  module: string;
+  api: string;
+  params?: Record<string, any>;
+  cols: string[];
+  rowsPerPage?: number;
+  disableTotalCount?: boolean;
+  useCursorPagination?: boolean;
+}
+
+interface QueryParams {
+  cols: string[];
+  start: number;
+  limit: number;
+  sort?: {
+    column: string;
+    direction: "asc" | "desc";
+  };
+  search?: string;
+  skipCount?: boolean;
+  cursor?: string;
+  [key: string]: any;
+}
+
+interface DataResult {
+  data: any[];
+  total?: number;
+  page: number;
+  totalPages?: number;
+  hasMore?: boolean;
+  nextCursor?: string;
+}
+
+export type ListActionHandler = {
+  getData: () => any[];
+  load: () => Promise<void>;
+  reset: () => Promise<void>;
+  moveNextPage: () => Promise<void>;
+  movePrevPage: () => Promise<void>;
+  moveFirstPage: () => Promise<void>;
+  moveLastPage: () => Promise<void>;
+  moveToPage: (page: number) => Promise<void>;
+  setFilter: (filter: Record<string, any>) => Promise<void>;
+  resetFilter: () => Promise<void>;
+  doSearch: (text: string) => Promise<void>;
+  sortAsc: (column: string) => Promise<void>;
+  sortDesc: (column: string) => Promise<void>;
+  setRowsPerPage: (rows: number) => Promise<void>;
+  hasNextPage: () => boolean;
+  hasPrevPage: () => boolean;
+  getTotalPageCount: () => number;
+  getTotalRecordCount: () => number;
+  getCurrentPage: () => number;
+  getCurrentSortedColumn: () => string | null;
+  getCurrentSortDirection: () => "asc" | "desc" | null;
+  getRowsPerPage: () => number;
+  getSearchText: () => string;
+  getCustomFilter: () => Record<string, any>;
+};
+
+// FIX: removed the erroneous second parameter `ListHandlerConfig: any`
+export const ListHandler = (config: ListHandlerConfig): ListActionHandler => {
+  const api = config.api;
+  const cols = config.cols;
+
+  const { filter = {}, ...rest } = config.params ?? {};
+
+  const disableTotalCount = config.disableTotalCount || false;
+  const useCursorPagination = config.useCursorPagination || false;
+
+  let rowsPerPage = config.rowsPerPage || 20;
+  let currentPage = 1;
+  let customFilter: Record<string, any> = {};
+  let searchText = "";
+  let sortColumn: string | null = null;
+  let sortDirection: "asc" | "desc" | null = null;
+  let lastCursor: string | null = null;
+
+  let dataResult: any[] = [];
+  let totalRecordCount = 0;
+  let totalPageCount = 0;
+  let hasMorePages = false;
+
+  const getData = (): any[] => dataResult;
+
+  const load = async (): Promise<void> => {
+    const queryParams: QueryParams = {
+      cols,
+      start: (currentPage - 1) * rowsPerPage,
+      limit: rowsPerPage,
+      filter: {
+        ...filter,
+        ...customFilter,
+      },
+    };
+
+    if (useCursorPagination && lastCursor) {
+      queryParams.cursor = lastCursor;
+    }
+
+    if (disableTotalCount) {
+      queryParams.skipCount = true;
+    }
+
+    if (searchText) {
+      queryParams.search = searchText;
+    }
+
+    if (sortColumn && sortDirection) {
+      queryParams.sort = { column: sortColumn, direction: sortDirection };
+    }
+
+    try {
+      // console.log("datalist pass 1", { api, query: { ...queryParams, ...rest } });
+      const result = await localAPI.exec(`/services/exec/${config.tenant}/${config.module}/${api}`, { ...queryParams, ...rest });
+      // console.log("datalist pass 2", { result });
+      dataResult = result.data || [];
+
+      if (useCursorPagination) {
+        lastCursor = result.nextCursor ?? null;
+        hasMorePages = result.hasMore ?? false;
+      }
+
+      if (!disableTotalCount) {
+        totalRecordCount = result.total || 0;
+        totalPageCount = result.totalPages || Math.ceil(totalRecordCount / rowsPerPage);
+      } else {
+        hasMorePages = result.data && result.data.length === rowsPerPage;
+      }
+    } catch (error) {
+      console.error("Error loading data:", error);
+      dataResult = [];
+      totalRecordCount = 0;
+      totalPageCount = 0;
+      hasMorePages = false;
+      throw error;
+    }
+  };
+
+  const reset = async (): Promise<void> => {
+    currentPage = 1;
+    await load();
+  };
+
+  const moveNextPage = async (): Promise<void> => {
+    if (hasNextPage()) {
+      currentPage++;
+      await load();
+    }
+  };
+
+  const movePrevPage = async (): Promise<void> => {
+    if (hasPrevPage()) {
+      currentPage--;
+      await load();
+    }
+  };
+
+  const moveFirstPage = async (): Promise<void> => {
+    currentPage = 1;
+    await load();
+  };
+
+  const moveLastPage = async (): Promise<void> => {
+    if (disableTotalCount) {
+      console.warn("moveLastPage is not available when total count is disabled");
+      return;
+    }
+    if (totalPageCount > 0) {
+      currentPage = totalPageCount;
+      await load();
+    }
+  };
+
+  const moveToPage = async (page: number): Promise<void> => {
+    if (page >= 1 && page <= totalPageCount) {
+      currentPage = page;
+      await load();
+    } else {
+      console.warn(`Invalid page number: ${page}. Must be between 1 and ${totalPageCount}`);
+    }
+  };
+
+  const setFilter = async (filter: Record<string, any>): Promise<void> => {
+    customFilter = { ...filter };
+    currentPage = 1;
+    await load();
+  };
+
+  const resetFilter = async (): Promise<void> => {
+    customFilter = {};
+    currentPage = 1;
+    await load();
+  };
+
+  const doSearch = async (text: string): Promise<void> => {
+    searchText = text;
+    currentPage = 1;
+    await load();
+  };
+
+  const sortAsc = async (column: string): Promise<void> => {
+    sortColumn = column;
+    sortDirection = "asc";
+    currentPage = 1;
+    await load();
+  };
+
+  const sortDesc = async (column: string): Promise<void> => {
+    sortColumn = column;
+    sortDirection = "desc";
+    currentPage = 1;
+    await load();
+  };
+
+  const setRowsPerPage = async (rows: number): Promise<void> => {
+    if (rows > 0) {
+      rowsPerPage = rows;
+      currentPage = 1;
+      await load();
+    }
+  };
+
+  const hasNextPage = (): boolean => {
+    if (disableTotalCount || useCursorPagination) return hasMorePages;
+    return currentPage < totalPageCount;
+  };
+
+  const hasPrevPage = (): boolean => currentPage > 1;
+
+  const getTotalPageCount = (): number => totalPageCount;
+  const getTotalRecordCount = (): number => totalRecordCount;
+  const getCurrentPage = (): number => currentPage;
+  const getCurrentSortedColumn = (): string | null => sortColumn;
+  const getCurrentSortDirection = (): "asc" | "desc" | null => sortDirection;
+  const getRowsPerPage = (): number => rowsPerPage;
+  const getSearchText = (): string => searchText;
+  const getCustomFilter = (): Record<string, any> => ({ ...customFilter });
+
+  return {
+    getData,
+    load,
+    reset,
+    moveNextPage,
+    movePrevPage,
+    moveFirstPage,
+    moveLastPage,
+    moveToPage,
+    setFilter,
+    resetFilter,
+    doSearch,
+    sortAsc,
+    sortDesc,
+    setRowsPerPage,
+    hasNextPage,
+    hasPrevPage,
+    getTotalPageCount,
+    getTotalRecordCount,
+    getCurrentPage,
+    getCurrentSortedColumn,
+    getCurrentSortDirection,
+    getRowsPerPage,
+    getSearchText,
+    getCustomFilter,
+  };
+};
+
+export default ListHandler;

package/dist/components/table/TableContext.d.ts

@@ -0,0 +1,33 @@
+import React, { ReactNode } from "react";
+import { ColumnDefinition } from "./DataTable";
+import { ListHandlerConfig, ListActionHandler } from "./ListHandler";
+export interface DataConfig {
+    api: string;
+    params?: Record<string, any>;
+}
+export interface TableContextValue {
+    listHandler: ListActionHandler | null;
+    columns: ColumnDefinition[];
+    setColumns: React.Dispatch<React.SetStateAction<ColumnDefinition[]>>;
+    rows: any[];
+    setRows: React.Dispatch<React.SetStateAction<any[]>>;
+    loading: boolean;
+    setLoading: React.Dispatch<React.SetStateAction<boolean>>;
+}
+declare const TableContext: React.Context<TableContextValue | null>;
+export declare const useTableContext: () => TableContextValue;
+export interface TableProviderProps {
+    data: DataConfig;
+    columns?: ColumnDefinition[];
+    rowsPerPage?: number;
+    disableTotalCount?: boolean;
+    useCursorPagination?: boolean;
+    children: ReactNode;
+    listHandlerFactory: (config: ListHandlerConfig) => ListActionHandler;
+    tenant: string;
+    module: string;
+    resolvedParams: Record<string, any> | undefined;
+}
+export declare const TableProvider: React.FC<TableProviderProps>;
+export type { ListHandlerConfig };
+export default TableContext;

package/dist/components/table/TableContext.js

@@ -0,0 +1,57 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useState, useEffect, useRef } from "react";
+// ============================================================================
+// CONTEXT
+// ============================================================================
+const TableContext = createContext(null);
+export const useTableContext = () => {
+    const ctx = useContext(TableContext);
+    if (!ctx)
+        throw new Error("useTableContext must be used inside <TableProvider>");
+    return ctx;
+};
+// ============================================================================
+// PROVIDER
+// ============================================================================
+export const TableProvider = ({ data, columns: initialColumns = [], rowsPerPage = 20, disableTotalCount = true, useCursorPagination = false, children, listHandlerFactory, tenant, module, resolvedParams, }) => {
+    const colIds = initialColumns.map((c) => { var _a, _b; return (_b = (_a = c.id) !== null && _a !== void 0 ? _a : c.expr) !== null && _b !== void 0 ? _b : ""; }).filter(Boolean);
+    // ListHandler created ONCE via ref.
+    // resolvedParams already has all placeholders replaced — passed in from DataList.
+    const listHandlerRef = useRef(null);
+    if (listHandlerRef.current === null) {
+        listHandlerRef.current = listHandlerFactory({
+            tenant,
+            module,
+            api: data.api,
+            params: resolvedParams,
+            cols: colIds,
+            rowsPerPage,
+            disableTotalCount,
+            useCursorPagination,
+        });
+    }
+    const [columns, setColumns] = useState(initialColumns);
+    const [rows, setRows] = useState([]);
+    const [loading, setLoading] = useState(false);
+    // Initial data load on mount
+    useEffect(() => {
+        const lh = listHandlerRef.current;
+        if (!lh)
+            return;
+        setLoading(true);
+        lh.load()
+            .then(() => setRows([...lh.getData()]))
+            .catch((err) => console.error("TableProvider initial load failed:", err))
+            .finally(() => setLoading(false));
+    }, []);
+    return (_jsx(TableContext.Provider, { value: {
+            listHandler: listHandlerRef.current,
+            columns,
+            setColumns,
+            rows,
+            setRows,
+            loading,
+            setLoading,
+        }, children: children }));
+};
+export default TableContext;

package/dist/components/table/TableContext.tsx

@@ -0,0 +1,122 @@
+import React, { createContext, useContext, useState, useEffect, useRef, ReactNode } from "react";
+import { ColumnDefinition } from "./DataTable";
+import { ListHandlerConfig, ListActionHandler } from "./ListHandler";
+
+// ============================================================================
+// INTERFACES
+// ============================================================================
+
+export interface DataConfig {
+  api: string;
+  params?: Record<string, any>;
+}
+
+export interface TableContextValue {
+  listHandler: ListActionHandler | null;
+  columns: ColumnDefinition[];
+  setColumns: React.Dispatch<React.SetStateAction<ColumnDefinition[]>>;
+  rows: any[];
+  setRows: React.Dispatch<React.SetStateAction<any[]>>;
+  loading: boolean;
+  setLoading: React.Dispatch<React.SetStateAction<boolean>>;
+}
+
+// ============================================================================
+// CONTEXT
+// ============================================================================
+
+const TableContext = createContext<TableContextValue | null>(null);
+
+export const useTableContext = (): TableContextValue => {
+  const ctx = useContext(TableContext);
+  if (!ctx) throw new Error("useTableContext must be used inside <TableProvider>");
+  return ctx;
+};
+
+// ============================================================================
+// PROVIDER PROPS
+// ============================================================================
+
+export interface TableProviderProps {
+  data: DataConfig;
+  columns?: ColumnDefinition[];
+  rowsPerPage?: number;
+  disableTotalCount?: boolean;
+  useCursorPagination?: boolean;
+  children: ReactNode;
+  listHandlerFactory: (config: ListHandlerConfig) => ListActionHandler;
+  // Resolved by DataList before being passed here — no hooks needed inside Provider
+  tenant: string;
+  module: string;
+  resolvedParams: Record<string, any> | undefined;
+}
+
+// ============================================================================
+// PROVIDER
+// ============================================================================
+
+export const TableProvider: React.FC<TableProviderProps> = ({
+  data,
+  columns: initialColumns = [],
+  rowsPerPage = 20,
+  disableTotalCount = true,
+  useCursorPagination = false,
+  children,
+  listHandlerFactory,
+  tenant,
+  module,
+  resolvedParams,
+}) => {
+  const colIds = initialColumns.map((c) => c.id ?? c.expr ?? "").filter(Boolean);
+
+  // ListHandler created ONCE via ref.
+  // resolvedParams already has all placeholders replaced — passed in from DataList.
+  const listHandlerRef = useRef<ListActionHandler | null>(null);
+  if (listHandlerRef.current === null) {
+    listHandlerRef.current = listHandlerFactory({
+      tenant,
+      module,
+      api: data.api,
+      params: resolvedParams,
+      cols: colIds,
+      rowsPerPage,
+      disableTotalCount,
+      useCursorPagination,
+    });
+  }
+
+  const [columns, setColumns] = useState<ColumnDefinition[]>(initialColumns);
+  const [rows, setRows] = useState<any[]>([]);
+  const [loading, setLoading] = useState(false);
+
+  // Initial data load on mount
+  useEffect(() => {
+    const lh = listHandlerRef.current;
+    if (!lh) return;
+
+    setLoading(true);
+    lh.load()
+      .then(() => setRows([...lh.getData()]))
+      .catch((err) => console.error("TableProvider initial load failed:", err))
+      .finally(() => setLoading(false));
+  }, []);
+
+  return (
+    <TableContext.Provider
+      value={{
+        listHandler: listHandlerRef.current,
+        columns,
+        setColumns,
+        rows,
+        setRows,
+        loading,
+        setLoading,
+      }}
+    >
+      {children}
+    </TableContext.Provider>
+  );
+};
+
+export type { ListHandlerConfig };
+export default TableContext;

package/dist/components/view/ComponentView.d.ts

@@ -0,0 +1,8 @@
+import { UIComponentProps } from "../common/UIComponent";
+interface ComponentViewProps extends UIComponentProps {
+    id?: string;
+    depends?: string;
+    component?: React.ReactNode;
+}
+declare const ComponentView: (props: ComponentViewProps) => import("react/jsx-runtime").JSX.Element;
+export default ComponentView;