@skalfa/skalfa-app-core 1.0.7 → 1.0.9

package/dist/api/api.d.ts

@@ -1,9 +1,6 @@
 import { AxiosResponse } from "axios";
-export declare const authBearer: (bearer?: string) => string | null;
 export type ApiFilterType = {
-    /** Use filter logic with: "and" / "or". */
     logic?: "and" | "or";
-    /** Use filter type with: "eq" = Equal, "ne" = Not Equal, "in" = In, "ni" = Not In, "bw" = Between. */
     type?: "eq" | "ne" | "in" | "ni" | "bw" | "";
     column?: string;
     value?: string | number | number[] | string[] | null;
@@ -36,7 +33,7 @@ export declare const ApiFilterValue: {
     ni: string;
     bw: string;
 };
-export declare const api: ({ path, url, method, params, payload, includeParams, headers, bearer, }: ApiType) => Promise<AxiosResponse<any, any, {}>>;
+export declare const api: ({ path, url, method, params, payload, includeParams, headers, bearer }: ApiType) => Promise<AxiosResponse<any, any, {}>>;
 export declare const useGetApi: (props: ApiType & {
     method?: "GET";
     cacheName?: string;
@@ -47,3 +44,4 @@ export declare const useGetApi: (props: ApiType & {
     data: any;
     reset: () => Promise<"" | undefined>;
 };
+export declare const authBearer: (bearer?: string) => string | null;

package/dist/api/api.js

@@ -4,26 +4,6 @@ import axios from "axios";
 import { redirect } from "next/navigation";
 import { auth } from "../auth";
 import { cavity } from "../cavity";
-// =========================>
-// ## Build auth bearer
-// =========================>
-export const authBearer = (bearer) => {
-    const token = bearer || auth.getAccessToken() || null;
-    return token ? `Bearer ${token}` : null;
-};
-// =========================>
-// ## Api error handler
-// =========================>
-const handleErrors = (fetch) => {
-    if (fetch?.status === 401)
-        redirect(auth.PATH_LOGIN);
-    if (fetch?.status === 403)
-        redirect(auth.PATH_BASE);
-    return fetch;
-};
-// =========================>
-// ## Api filter value
-// =========================>
 export const ApiFilterValue = {
     eq: "eq",
     ne: "ne",
@@ -34,10 +14,16 @@ export const ApiFilterValue = {
 // =========================>
 // ## Api fetching handler
 // =========================>
-export const api = async ({ path, url, method, params, payload, includeParams, headers, bearer, }) => {
+export const api = async ({ path, url, method, params, payload, includeParams, headers, bearer }) => {
     const fetchUrl = url || `${process.env.NEXT_PUBLIC_API_HOST}/${path || ""}`;
+    // =========================>
+    // ## Build headers 
+    // =========================>
     const buildHeaders = { Authorization: authBearer(bearer) || "", ...headers };
     buildHeaders["Content-Type"] = buildHeaders["Content-Type"] || "multipart/form-data";
+    // =========================>
+    // ## Build params
+    // =========================>
     const filter = {};
     const jsonParams = {};
     if (params?.filter) {
@@ -54,6 +40,9 @@ export const api = async ({ path, url, method, params, payload, includeParams, h
             }
         });
     }
+    // =========================>
+    // ## Axios handler
+    // =========================>
     return await axios(fetchUrl, {
         method: method || "GET",
         headers: buildHeaders,
@@ -123,3 +112,20 @@ export const useGetApi = (props, sleep) => {
     const reset = () => fetch(true);
     return { loading, code, data, reset };
 };
+// =========================>
+// ## Build auth bearer
+// =========================>
+export const authBearer = (bearer) => {
+    const token = bearer || auth.getAccessToken() || null;
+    return token ? `Bearer ${token}` : null;
+};
+// =========================>
+// ## Api error handler
+// =========================>
+const handleErrors = (fetch) => {
+    if (fetch?.status === 401)
+        redirect(auth.PATH_LOGIN);
+    if (fetch?.status === 403)
+        redirect(auth.PATH_BASE);
+    return fetch;
+};

package/dist/auth/auth.js

@@ -5,15 +5,15 @@ export const auth = {
     // ==============================>
     // ## Path of login page
     // ==============================>
-    PATH_LOGIN: '/auth/login',
+    PATH_LOGIN: process.env.NEXT_PUBLIC_LOGIN_PATH || '/auth/login',
     // ==============================>
     // ## Path of home page
     // ==============================>
-    PATH_BASE: '/',
+    PATH_BASE: process.env.NEXT_PUBLIC_BASE_PATH || '/',
     // ==============================>
     // ## Access token expired (days)
     // ==============================>
-    ACCESS_TOKEN_EXPIRED: 7,
+    ACCESS_TOKEN_EXPIRED: Number(process.env.NEXT_PUBLIC_ACCESS_TOKEN_EXPIRED) || 7,
     // ==============================>
     // ## Name of cookie access token
     // ==============================>

package/dist/cavity/cavity.js

@@ -79,6 +79,9 @@ export const cavity = {
         store.delete(key);
         return tx.commit;
     },
+    // ==============================>
+    // ## Cavity socket handler
+    // ==============================>
     socket: {
         register: () => {
             const socket = getSocket();

package/dist/conversion/conversion.js

@@ -42,6 +42,9 @@ export const conversion = {
     // ==============================> 
     date: (date, format = "DD MMM YYYY") => moment(date).format(format),
 };
+// ==============================> 
+// ## normalize string to words
+// ==============================>
 function toWords(value) {
     return value
         .replace(/([a-z0-9])([A-Z])/g, "$1 $2")

package/dist/form/form.d.ts

@@ -1,19 +1,19 @@
 import { ValidationRules } from "../validation";
 import { ApiType } from "../api";
 type DBSchema = any;
-export interface FormRegisterType {
+export type FormRegisterType = {
     name: string;
     status?: boolean;
     validations?: ValidationRules;
-}
-export interface FormValueType {
+};
+export type FormValueType = {
     name: string;
     value?: any;
-}
-export interface FormErrorType {
+};
+export type FormErrorType = {
     name: string;
     error?: string | null;
-}
+};
 export interface FormStateType {
     formRegisters: FormRegisterType[];
     formValues: FormValueType[];

package/dist/form/form.js

@@ -1,7 +1,7 @@
 "use client";
 import { useReducer, useEffect, useState } from "react";
-import { registry } from "../registry";
 import { validation } from "../validation";
+import { registry } from "../registry";
 import { api } from "../api";
 const initialState = {
     formRegisters: [],
@@ -111,6 +111,9 @@ export const useForm = (submitControl) => {
         value: state.formValues.find((val) => val.name === name)?.value || undefined,
         invalid: state.formErrors.find((err) => err.name === name)?.error || undefined,
     });
+    // ==============================>
+    // ## Object values handler
+    // ==============================>
     const getObjectValues = () => {
         const registeredNames = new Set(state.formRegisters.map(r => r.name));
         return state.formValues.reduce((acc, val) => {
@@ -119,6 +122,9 @@ export const useForm = (submitControl) => {
             return acc;
         }, {});
     };
+    // ==============================>
+    // ## Submit idb handler
+    // ==============================>
     const submitIdb = async () => {
         const values = payload ? await payload(getObjectValues()) : getObjectValues();
         const idb = registry.get("idb");
@@ -129,6 +135,9 @@ export const useForm = (submitControl) => {
         await client.put(submitControl?.idb?.store || "", values);
         return { status: 200, data: values };
     };
+    // ==============================>
+    // ## Submit api handler
+    // ==============================>
     const submitApi = async () => {
         const formData = new FormData();
         const values = payload ? await payload(getObjectValues()) : getObjectValues();
@@ -144,9 +153,6 @@ export const useForm = (submitControl) => {
             payload: formData,
         });
     };
-    // ==============================>
-    // ## Fetch to api
-    // ==============================>
     const fetch = async () => {
         dispatch({ type: "SET_LOADING", payload: true });
         let execute;
@@ -160,17 +166,11 @@ export const useForm = (submitControl) => {
             throw new Error("Invalid submitControl");
         }
         if (execute?.status === 200 || execute?.status === 201) {
-            // ==============================>
-            // ## When success
-            // ==============================>
             dispatch({ type: "SET_LOADING", payload: false });
             onSuccess?.(execute.data);
             dispatch({ type: "RESET" });
         }
         else if (isApiSubmit && execute?.status === 422) {
-            // ==============================>
-            // ## When error invalid
-            // ==============================>
             const errors = Object.keys(execute.data.errors).map((key) => ({
                 name: key,
                 error: execute.data.errors[key][0],
@@ -181,9 +181,6 @@ export const useForm = (submitControl) => {
             dispatch({ type: "SET_CONFIRM", payload: false });
         }
         else {
-            // ==============================>
-            // ## When error server
-            // ==============================>
             onFailed?.(execute?.status || 500);
             dispatch({ type: "SET_CONFIRM", payload: false });
             dispatch({ type: "SET_LOADING", payload: false });
@@ -196,9 +193,6 @@ export const useForm = (submitControl) => {
         e?.preventDefault();
         dispatch({ type: "SET_ERRORS", payload: [] });
         const newErrors = [];
-        // ==============================>
-        // ## Check register validation
-        // ==============================>
         state.formRegisters.forEach((form) => {
             const { valid, message } = validation.check({
                 value: state.formValues.find((val) => val.name === form.name)?.value,
@@ -212,9 +206,6 @@ export const useForm = (submitControl) => {
             dispatch({ type: "SET_ERRORS", payload: newErrors });
             return;
         }
-        // ==============================>
-        // ## Execute handler
-        // ==============================>
         if (confirmation) {
             dispatch({ type: "SET_CONFIRM", payload: true });
         }
@@ -227,7 +218,7 @@ export const useForm = (submitControl) => {
     // ==============================>
     const onConfirm = () => fetch();
     // ==============================>
-    // ## Set default value
+    // ## Set default value handler
     // ==============================>
     const setDefaultValues = (values) => {
         const newValues = values ? Object.keys(values).map((keyName) => ({
@@ -259,7 +250,7 @@ export const useForm = (submitControl) => {
     };
 };
 // ==============================>
-// ## Generate random id
+// ## Generate input random id hook
 // ==============================>
 export const useInputRandomId = () => {
     const [randomId, setRandomId] = useState("");
@@ -269,7 +260,7 @@ export const useInputRandomId = () => {
     return randomId;
 };
 // ==============================>
-// ## Input handle
+// ## Input handler
 // ==============================>
 export const useInputHandler = (name, value, validations, register, unregister, isFile) => {
     const [inputValue, setInputValue] = useState("");

package/dist/resource/resource.js

@@ -3,11 +3,14 @@ import { useEffect, useState } from "react";
 import { useGetApi } from "../api";
 import { registry } from "../registry";
 export function useResource(props) {
+    // ========================>
+    // ## API resource handler
+    // ========================>
     const isApi = "path" in props || "url" in props;
     const apiResult = useGetApi(isApi ? props : {}, !isApi);
-    // =====================
-    // IDB MODE
-    // =====================
+    // ========================>
+    // ## IDB resource handler
+    // ========================>
     const [loading, setLoading] = useState(false);
     const [data, setData] = useState(null);
     const idbParams = props.params || {};
@@ -17,12 +20,9 @@ export function useResource(props) {
         setLoading(true);
         try {
             const idb = registry.get("idb");
-            if (!idb) {
+            if (!idb)
                 throw new Error("IndexedDB (IDB) extension is not installed or registered.");
-            }
-            const idbClient = props.idb.schema
-                ? idb.useSchema(props.idb.schema)
-                : idb;
+            const idbClient = props.idb.schema ? idb.useSchema(props.idb.schema) : idb;
             let q = await idbClient.query(props.idb.store);
             if (idbParams.search) {
                 const keyword = idbParams.search.toLowerCase();
@@ -41,11 +41,7 @@ export function useResource(props) {
             if (idbParams.paginate) {
                 q = q.paginate(idbParams.page || 0, idbParams.paginate);
             }
-            const [rows, total] = await Promise.all([
-                q.get(),
-                q.count(),
-            ]);
-            // const rows = await q.get()
+            const [rows, total] = await Promise.all([q.get(), q.count()]);
             setData({ data: rows, total_row: total });
         }
         finally {
@@ -63,9 +59,9 @@ export function useResource(props) {
         idbParams.paginate,
         idbParams.page,
     ]);
-    // =====================
-    // Unified return
-    // =====================
+    // =======================>
+    // ## Unified return
+    // =======================>
     if (isApi) {
         return {
             loading: apiResult.loading,

package/dist/shortcut/shortcut.js

@@ -1,10 +1,22 @@
 const handlers = new Map();
 export const shortcut = {
+    // ==============================>
+    // ## Shortcut register handler
+    // ==============================>
     register: (key, handler, description) => {
         handlers.set(key, { key, handler, description });
     },
+    // ==============================>
+    // ## Shortcut unregister handler
+    // ==============================>
     unregister: (key) => handlers.delete(key),
+    // ==============================>
+    // ## Shortcut list handler
+    // ==============================>
     list: () => Array.from(handlers.values()),
+    // ==============================>
+    // ## Shortcut init handler
+    // ==============================>
     init: () => {
         window.addEventListener("keydown", (e) => {
             const target = e.target;

package/dist/table/table.d.ts

@@ -28,10 +28,6 @@ export declare const useTable: (fetchControl: UseResourceProps & {
     setParam: <K extends keyof ApiParamsType>(key: K, value: ApiParamsType[K]) => void;
     focus: number | null | undefined;
     setFocus: (focus: number | null) => void;
-    selected: Record<string, any> | null | undefined;
-    setSelected: (selected: Record<string, any> | null) => void;
-    checks: (string | number)[] | null | undefined;
-    setChecks: (checks: (string | number)[] | null) => void;
     tableControl: {
         loading: boolean;
         sortBy: string[] | undefined;
@@ -48,4 +44,8 @@ export declare const useTable: (fetchControl: UseResourceProps & {
             onChange: (_: number, paginate: number, page: number) => void;
         };
     };
+    selected: Record<string, any> | null | undefined;
+    setSelected: (selected: Record<string, any> | null) => void;
+    checks: (string | number)[] | null | undefined;
+    setChecks: (checks: (string | number)[] | null) => void;
 };

package/dist/table/table.js

@@ -68,9 +68,7 @@ export const useTable = (fetchControl, id = "", title = "", urlParam) => {
             });
         }
         const newSearch = url.searchParams.toString();
-        const currentSearch = typeof window !== "undefined"
-            ? (window.location.search.startsWith("?") ? window.location.search.slice(1) : window.location.search)
-            : "";
+        const currentSearch = typeof window !== "undefined" ? (window.location.search.startsWith("?") ? window.location.search.slice(1) : window.location.search) : "";
         if (newSearch !== currentSearch) {
             router.replace(url.pathname + "?" + newSearch, { scroll: false });
         }
@@ -137,10 +135,10 @@ export const useTable = (fetchControl, id = "", title = "", urlParam) => {
         setParam,
         focus: state.focus,
         setFocus,
+        tableControl,
         selected: state.selected,
         setSelected: setSelected,
         checks: state.checks,
         setChecks: setChecks,
-        tableControl,
     };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skalfa/skalfa-app-core",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Core framework engine and foundational utility hook library for the Skalfa Next.js frontend.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -16,7 +16,7 @@
     "core"
   ],
   "author": "",
-  "license": "UNLICENSED",
+  "license": "MIT",
   "dependencies": {
     "axios": "^1.12.0",
     "clsx": "^2.1.1",