nucleus-core-ts 0.8.0

package/dist/fe/types/index.d.ts

@@ -0,0 +1,233 @@
+import type { ReactNode } from "react";
+export type SortDirection = "asc" | "desc" | null;
+export interface QueryParams {
+    page?: number;
+    limit?: number;
+    offset?: number;
+    search?: string;
+    searchFields?: string;
+    sort?: string;
+    filters?: string;
+    with?: string;
+}
+export interface FilterCondition {
+    field: string;
+    operator: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "like" | "ilike" | "in" | "notIn" | "isNull" | "isNotNull";
+    value: unknown;
+}
+export interface SortCondition {
+    field: string;
+    direction: "asc" | "desc";
+}
+export interface PaginationMeta {
+    page: number;
+    limit: number;
+    offset: number;
+    totalItems: number;
+    totalPages: number;
+    hasNextPage: boolean;
+    hasPrevPage: boolean;
+}
+export interface ListResponse<T> {
+    success: boolean;
+    data: {
+        items: T[];
+        meta: PaginationMeta;
+    };
+}
+export interface SingleResponse<T> {
+    success: boolean;
+    data: T | null;
+}
+export interface MutationResponse<T> {
+    success: boolean;
+    data: T;
+}
+export interface DeleteResponse {
+    success: boolean;
+    data: {
+        deleted: boolean;
+    };
+}
+export interface BulkDeleteResponse {
+    success: boolean;
+    data: {
+        deleted: number;
+    };
+}
+export type ColumnType = "integer" | "smallint" | "bigint" | "serial" | "smallserial" | "bigserial" | "real" | "doublePrecision" | "numeric" | "decimal" | "text" | "varchar" | "char" | "uuid" | "boolean" | "date" | "time" | "timestamp" | "timestamptz" | "interval" | "json" | "jsonb" | "bytea" | "inet" | "cidr" | "macaddr" | "macaddr8" | "bit" | "bitVarying" | "point" | "line" | "lseg" | "box" | "path" | "polygon" | "circle" | "tsvector" | "tsquery" | "xml" | "money" | "vector" | "geometry" | "geography" | "customType";
+export interface ColumnValidation {
+    minLength?: number;
+    maxLength?: number;
+    min?: number;
+    max?: number;
+    pattern?: string;
+    format?: "email" | "url" | "uuid" | "date" | "datetime" | "time" | "uri" | "ipv4" | "ipv6";
+    customMessage?: string;
+}
+export interface ColumnReference {
+    table: string;
+    column?: string;
+    foreignKey?: string;
+    type?: "belongsTo" | "hasMany" | "hasOne";
+    onDelete?: "cascade" | "restrict" | "no action" | "set null" | "set default";
+    onUpdate?: "cascade" | "restrict" | "no action" | "set null" | "set default";
+}
+export interface ColumnEnum {
+    name: string;
+    values: string[];
+}
+export interface NucleusColumn {
+    name: string;
+    type: ColumnType;
+    length?: number;
+    precision?: number;
+    scale?: number;
+    nullable?: boolean;
+    notNull?: boolean;
+    unique?: boolean;
+    primaryKey?: boolean;
+    default?: unknown;
+    defaultRaw?: string;
+    references?: ColumnReference;
+    enumValues?: string[];
+    enum?: ColumnEnum;
+    validation?: ColumnValidation;
+    comment?: string;
+    generatedAlwaysAs?: string;
+    generatedAlwaysAsIdentity?: boolean;
+    generatedByDefaultAsIdentity?: boolean;
+    array?: boolean;
+}
+export interface NucleusEntity {
+    table_name: string;
+    group_name?: string;
+    columns?: readonly NucleusColumn[] | NucleusColumn[];
+    excluded_methods?: readonly ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[] | ("GET" | "POST" | "PUT" | "PATCH" | "DELETE")[];
+    bulk_endpoints_enabled?: boolean;
+    is_public?: {
+        GET?: boolean;
+        POST?: boolean;
+        PUT?: boolean;
+        PATCH?: boolean;
+        DELETE?: boolean;
+    };
+    is_form_data?: boolean;
+    available_app_ids?: readonly string[] | string[];
+    add_base_columns?: boolean;
+}
+export interface FieldConfig {
+    label?: string;
+    placeholder?: string;
+    helperText?: string;
+    hidden?: boolean;
+    disabled?: boolean;
+    readOnly?: boolean;
+    order?: number;
+    span?: 1 | 2 | 3 | 4 | 6 | 12;
+    render?: (props: {
+        value: unknown;
+        onChange: (v: unknown) => void;
+    }) => ReactNode;
+}
+export interface ColumnConfig {
+    key: string;
+    header?: string;
+    width?: number;
+    sortable?: boolean;
+    hidden?: boolean;
+    cellRenderer?: (props: {
+        value: unknown;
+        row: Record<string, unknown>;
+    }) => ReactNode;
+}
+interface ApiActionLike {
+    start(options: {
+        payload: unknown;
+        onAfterHandle?: (data: unknown) => void;
+        onErrorHandle?: (error: unknown) => void;
+    }): void;
+    state: {
+        isPending: boolean;
+        data: unknown;
+        error: unknown;
+        code?: number | null;
+    };
+}
+export interface NucleusEntityShowcaseProps<T extends Record<string, unknown> = Record<string, unknown>> {
+    entity: NucleusEntity;
+    apiActions: Record<string, ApiActionLike>;
+    title?: string;
+    description?: string;
+    pageSize?: number;
+    searchable?: boolean;
+    searchFields?: string[];
+    filterable?: boolean;
+    sortable?: boolean;
+    selectable?: boolean;
+    showAdd?: boolean;
+    showEdit?: boolean;
+    showDelete?: boolean;
+    showBulkAdd?: boolean;
+    showBulkDelete?: boolean;
+    columnConfigs?: Partial<Record<keyof T, ColumnConfig>>;
+    fieldConfigs?: Partial<Record<keyof T, FieldConfig>>;
+    excludeColumns?: (keyof T)[];
+    excludeFields?: (keyof T)[];
+    onRowClick?: (row: T) => void;
+    renderHeader?: () => ReactNode;
+    renderToolbar?: (props: {
+        selectedRows: T[];
+        onClearSelection: () => void;
+    }) => ReactNode;
+    className?: string;
+}
+export interface UseNucleusEntityOptions {
+    entity: NucleusEntity;
+    apiActions: Record<string, {
+        start: (options: {
+            payload?: unknown;
+            onAfterHandle?: (data: unknown) => void;
+            onErrorHandle?: (error: unknown) => void;
+        }) => void;
+        state: {
+            isPending: boolean;
+            data: unknown;
+            error: unknown;
+        };
+    }>;
+    pageSize?: number;
+    initialSort?: SortCondition[];
+    initialFilters?: FilterCondition[];
+}
+export interface UseNucleusEntityReturn<T extends Record<string, unknown>> {
+    items: T[];
+    meta: PaginationMeta | null;
+    isLoading: boolean;
+    isLoadingMore: boolean;
+    error: unknown;
+    loadData: (options?: {
+        page?: number;
+        search?: string;
+        sort?: SortCondition[];
+        filters?: FilterCondition[];
+    }) => void;
+    loadMore: () => void;
+    hasMore: boolean;
+    addItem: (data: Partial<T>) => Promise<void>;
+    updateItem: (id: string, data: Partial<T>) => Promise<void>;
+    deleteItem: (id: string) => Promise<void>;
+    bulkAdd: (items: Partial<T>[]) => Promise<void>;
+    bulkDelete: (ids: string[]) => Promise<void>;
+    search: string;
+    setSearch: (query: string) => void;
+    sort: SortCondition[];
+    setSort: (sort: SortCondition[]) => void;
+    filters: FilterCondition[];
+    setFilters: (filters: FilterCondition[]) => void;
+    currentPage: number;
+    setCurrentPage: (page: number) => void;
+    refetch: () => void;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/fe/utils/cn.d.ts

@@ -0,0 +1,3 @@
+import { type ClassValue } from "clsx";
+export declare function cn(...inputs: ClassValue[]): string;
+//# sourceMappingURL=cn.d.ts.map

package/dist/fe/utils/columnUtils.d.ts

@@ -0,0 +1,63 @@
+import type { NucleusColumn } from "../types";
+export declare function formatLabel(name: string): string;
+export declare function shouldExcludeColumn(column: NucleusColumn): boolean;
+export declare function shouldExcludeFromForm(column: NucleusColumn, mode: "add" | "edit"): boolean;
+export declare function isReferenceColumn(column: NucleusColumn): boolean;
+export declare function isJsonColumn(column: NucleusColumn): boolean;
+export declare function isArrayColumn(column: NucleusColumn): boolean;
+export declare function getColumnType(column: NucleusColumn): "text" | "number" | "boolean" | "date" | "select" | "json" | "hidden";
+export declare function getDefaultValue(column: NucleusColumn): unknown;
+declare const TEXT_COLUMN_TYPES: readonly ["text", "varchar", "char"];
+declare const NUMERIC_COLUMN_TYPES: readonly ["integer", "smallint", "bigint", "serial", "smallserial", "bigserial", "real", "doublePrecision", "numeric", "decimal", "money"];
+declare const DATE_COLUMN_TYPES: readonly ["date", "time", "timestamp", "timestamptz"];
+export type TextColumnType = (typeof TEXT_COLUMN_TYPES)[number];
+export type NumericColumnType = (typeof NUMERIC_COLUMN_TYPES)[number];
+export type DateColumnType = (typeof DATE_COLUMN_TYPES)[number];
+/**
+ * Check if column is searchable (text-based)
+ */
+export declare function isSearchableColumn(column: NucleusColumn): boolean;
+/**
+ * Check if column has enum values (for SelectBox filter)
+ * Handles both enumValues array and enum.values from customType columns
+ */
+export declare function isEnumColumn(column: NucleusColumn): boolean;
+/**
+ * Check if column is boolean (for SelectBox filter with Yes/No)
+ */
+export declare function isBooleanColumn(column: NucleusColumn): boolean;
+/**
+ * Check if column is numeric (for RangePicker filter)
+ */
+export declare function isNumericColumn(column: NucleusColumn): boolean;
+/**
+ * Check if column is date/time (for DatePicker filter)
+ */
+export declare function isDateColumn(column: NucleusColumn): boolean;
+/**
+ * Check if column is a decimal type (for formatting)
+ */
+export declare function isDecimalColumn(column: NucleusColumn): boolean;
+/**
+ * Get enum values from column
+ */
+export declare function getEnumValues(column: NucleusColumn): string[];
+/**
+ * Filter columns that can be searched (text-type columns)
+ */
+export declare function getSearchableColumns(columns: readonly NucleusColumn[]): NucleusColumn[];
+/**
+ * Filter columns that can be filtered with enum/boolean SelectBox
+ */
+export declare function getEnumFilterColumns(columns: readonly NucleusColumn[]): NucleusColumn[];
+/**
+ * Filter columns that can be filtered with RangePicker (numeric)
+ */
+export declare function getNumericFilterColumns(columns: readonly NucleusColumn[]): NucleusColumn[];
+/**
+ * Filter columns that can be filtered with DatePicker
+ * Includes base date columns (created_at, updated_at)
+ */
+export declare function getDateFilterColumns(columns: readonly NucleusColumn[]): NucleusColumn[];
+export {};
+//# sourceMappingURL=columnUtils.d.ts.map

package/dist/fe/utils/endpointKeys.d.ts

@@ -0,0 +1,9 @@
+export declare function toUpperSnakeCase(str: string): string;
+export declare function singularize(str: string): string;
+type GenericMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+export declare function generateEntityEndpointKey(tableName: string, method: GenericMethod): string;
+export declare function generateBulkEndpointKey(tableName: string, method: "POST" | "PUT" | "DELETE"): string;
+export declare function generateGetByIdEndpointKey(tableName: string): string;
+export declare function generateDistinctEndpointKey(tableName: string): string;
+export {};
+//# sourceMappingURL=endpointKeys.d.ts.map

package/dist/index-0yyw12k6.js

@@ -0,0 +1 @@
+var _0x2f31fc=_0x33f0;function _0x1db6(){var _0x151f3c=['mJy3nfHXs0zwvq','mta0ndrYB0TttKu','x19LC01VzhvSzq','zxHWB3j0CW','EMTgBei','odm2mJeWt1fAwNH2','mtC4mdjJswrtuLq','mJuWmdm5ovvny0XdAG','BwfW','uuL6AxC','s1DSB3u','z2v0','zxvrsgm','mJe0Aw5LAwXs','mJa0BNnNrg5l','mJe0ndqWyNHvrwrg','mJbrr3PlDvG','nduYotK2n2rlAgLHwq','DMfSDwu','B2jQzwn0','mZaZmdy5nMfrDgD3qG','y2fSBa','y3jLyxrL','zNvUy3rPB24','y0XdwgK','mtHnAKHzweu'];_0x1db6=function(){return _0x151f3c;};return _0x1db6();}function _0x33f0(_0x398205,_0x2eaab9){_0x398205=_0x398205-0x1ea;var _0x1db6be=_0x1db6();var _0x33f0c3=_0x1db6be[_0x398205];if(_0x33f0['ypWfwj']===undefined){var _0x24f6f1=function(_0x4e8eff){var _0x3259d6='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';var _0x414f01='',_0x3c49d7='';for(var _0x2f9ff=0x0,_0x2d5c90,_0x5e7ef5,_0x5900ac=0x0;_0x5e7ef5=_0x4e8eff['charAt'](_0x5900ac++);~_0x5e7ef5&&(_0x2d5c90=_0x2f9ff%0x4?_0x2d5c90*0x40+_0x5e7ef5:_0x5e7ef5,_0x2f9ff++%0x4)?_0x414f01+=String['fromCharCode'](0xff&_0x2d5c90>>(-0x2*_0x2f9ff&0x6)):0x0){_0x5e7ef5=_0x3259d6['indexOf'](_0x5e7ef5);}for(var _0x371592=0x0,_0x4c8ae0=_0x414f01['length'];_0x371592<_0x4c8ae0;_0x371592++){_0x3c49d7+='%'+('00'+_0x414f01['charCodeAt'](_0x371592)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x3c49d7);};_0x33f0['cHmMEC']=_0x24f6f1,_0x33f0['LvRJaM']={},_0x33f0['ypWfwj']=!![];}var _0x4aa5cb=_0x1db6be[0x0],_0x528b94=_0x398205+_0x4aa5cb,_0x51eba6=_0x33f0['LvRJaM'][_0x528b94];return!_0x51eba6?(_0x33f0c3=_0x33f0['cHmMEC'](_0x33f0c3),_0x33f0['LvRJaM'][_0x528b94]=_0x33f0c3):_0x33f0c3=_0x51eba6,_0x33f0c3;}(function(_0x233be0,_0x40bf8d){var _0x4eb222=_0x33f0,_0x449630=_0x233be0();while(!![]){try{var _0x389d3c=-parseInt(_0x4eb222(0x1eb))/0x1*(-parseInt(_0x4eb222(0x1f9))/0x2)+-parseInt(_0x4eb222(0x1ef))/0x3+-parseInt(_0x4eb222(0x1ee))/0x4*(parseInt(_0x4eb222(0x1fd))/0x5)+-parseInt(_0x4eb222(0x1fe))/0x6*(parseInt(_0x4eb222(0x1f8))/0x7)+parseInt(_0x4eb222(0x1f2))/0x8*(-parseInt(_0x4eb222(0x1f7))/0x9)+parseInt(_0x4eb222(0x1ed))/0xa+-parseInt(_0x4eb222(0x1ff))/0xb*(-parseInt(_0x4eb222(0x1ec))/0xc);if(_0x389d3c===_0x40bf8d)break;else _0x449630['push'](_0x449630['shift']());}catch(_0x1354ab){_0x449630['push'](_0x449630['shift']());}}}(_0x1db6,0xbaff2));var j=Object[_0x2f31fc(0x1f4)],{getPrototypeOf:k,defineProperty:e,getOwnPropertyNames:h,getOwnPropertyDescriptor:l}=Object,i=Object['prototype']['hasOwnProperty'],_0x5f27ac={};_0x5f27ac[_0x2f31fc(0x1fb)]={};var m=(_0x53ca23,_0xdf4c7c,_0x199308)=>{var _0x5db0c9=_0x2f31fc,_0x34df15={'QFvqk':function(_0xcd1663,_0xfcce79){return _0xcd1663(_0xfcce79);},'WuVNa':function(_0x3c6a45,_0xcf387c,_0x300f2a,_0x4affd3){return _0x3c6a45(_0xcf387c,_0x300f2a,_0x4affd3);},'cLCXi':'default'};_0x199308=_0x53ca23!=null?j(_0x34df15['QFvqk'](k,_0x53ca23)):{};let _0x4b69bf=_0xdf4c7c||!_0x53ca23||!_0x53ca23['__esModule']?_0x34df15['WuVNa'](e,_0x199308,_0x34df15[_0x5db0c9(0x1f6)],{'value':_0x53ca23,'enumerable':!0x0}):_0x199308;for(let _0x405608 of h(_0x53ca23))if(!i[_0x5db0c9(0x1f3)](_0x4b69bf,_0x405608))e(_0x4b69bf,_0x405608,{'get':()=>_0x53ca23[_0x405608],'enumerable':!0x0});return _0x4b69bf;},g=new WeakMap(),n=_0xcabee0=>{var _0x3d53bc=_0x2f31fc,_0x13d372={};_0x13d372[_0x3d53bc(0x201)]=_0x3d53bc(0x1fa),_0x13d372[_0x3d53bc(0x1ea)]=function(_0x26709e,_0x42825a){return _0x26709e===_0x42825a;},_0x13d372['zkFlB']=_0x3d53bc(0x1f1),_0x13d372[_0x3d53bc(0x202)]=function(_0x5b71ec,_0x4ee259){return _0x5b71ec===_0x4ee259;},_0x13d372['Iuirc']=_0x3d53bc(0x1f5);var _0x4d85e5=_0x13d372,_0x59ac0f=g[_0x3d53bc(0x203)](_0xcabee0),_0x5d981a;if(_0x59ac0f)return _0x59ac0f;var _0x340532={};_0x340532[_0x3d53bc(0x1f0)]=!0x0;if(_0x59ac0f=e({},_0x4d85e5[_0x3d53bc(0x201)],_0x340532),_0xcabee0&&_0x4d85e5[_0x3d53bc(0x1ea)](typeof _0xcabee0,_0x4d85e5[_0x3d53bc(0x1fc)])||_0x4d85e5['KWlou'](typeof _0xcabee0,_0x4d85e5['Iuirc']))h(_0xcabee0)[_0x3d53bc(0x200)](_0x315f2e=>!i[_0x3d53bc(0x1f3)](_0x59ac0f,_0x315f2e)&&e(_0x59ac0f,_0x315f2e,{'get':()=>_0xcabee0[_0x315f2e],'enumerable':!(_0x5d981a=l(_0xcabee0,_0x315f2e))||_0x5d981a['enumerable']}));return g['set'](_0xcabee0,_0x59ac0f),_0x59ac0f;},o=(_0x363898,_0x247cdb)=>()=>(_0x247cdb||_0x363898((_0x247cdb=_0x5f27ac)['exports'],_0x247cdb),_0x247cdb[_0x2f31fc(0x1fb)]),p=(_0x5b6b03,_0x21d0af)=>{for(var _0x3c1f2f in _0x21d0af)e(_0x5b6b03,_0x3c1f2f,{'get':_0x21d0af[_0x3c1f2f],'enumerable':!0x0,'configurable':!0x0,'set':_0x50519d=>_0x21d0af[_0x3c1f2f]=()=>_0x50519d});},q=(_0x33c7a6,_0x5cae09)=>()=>(_0x33c7a6&&(_0x5cae09=_0x33c7a6(_0x33c7a6=0x0)),_0x5cae09),r=import.meta.require;export{m as o,n as p,o as q,p as r,q as s,r as t};