@juv/codego-react-ui 3.5.4 → 3.5.6

package/README.md

@@ -739,6 +739,53 @@ function AnnouncementsPage() {
 
 ---
 
+## Laravel Response Decryption
+
+Use `decryptResponse` to decrypt Laravel-encrypted API responses (AES-256-CBC).
+
+### Setup
+
+Add your Laravel `APP_KEY` to `.env`:
+
+```env
+VITE_LARAVEL_KEY=base64:your_laravel_app_key_here
+```
+
+### Usage
+
+```tsx
+import { api, decryptResponse } from "@juv/codego-react-ui"
+
+type Certificate = { id: number; name: string }
+
+const fetchCertificates = async () => {
+  const data = await api.get<string>('/certificate')
+  const decoded = decryptResponse<Certificate[]>(data)
+  console.log(decoded)
+}
+```
+
+> `api.get` should be typed as `string` since the raw response is an encrypted payload. `decryptResponse` reads `VITE_LARAVEL_KEY` automatically.
+
+You can also pass the key explicitly:
+
+```tsx
+const decoded = decryptResponse<Certificate[]>(data, "base64:your_key_here")
+```
+
+### API
+
+| Export | Description |
+|---|---|
+| `decryptResponse(response, key?)` | Decrypts a Laravel-encrypted string or `{ data: string }` object. |
+| `decryptLaravelPayload(payload, key?)` | Low-level decryption of a raw encrypted payload string. |
+| `getLaravelSecretKey()` | Reads the key from `VITE_LARAVEL_KEY`, `REACT_APP_LARAVEL_KEY`, or `window.__LARAVEL_KEY__`. |
+| `parseLaravelKey(secretKey)` | Parses a `base64:...` or raw key string into a `CryptoJS.WordArray`. |
+| `parseLaravelEncryptedPayload(payload)` | Parses a base64-encoded Laravel encrypted payload into `{ iv, value, mac }`. |
+| `LaravelEncryptedPayload` | Type for the parsed payload object. |
+
+---
+
 ## Run Locally
 
 **Prerequisites:** Node.js

package/dist/index.cjs

@@ -127,6 +127,11 @@ __export(index_exports, {
   Wizard: () => Wizard,
   api: () => api,
   createStore: () => createStore,
+  decryptLaravelPayload: () => decryptLaravelPayload,
+  decryptResponse: () => decryptResponse,
+  getLaravelSecretKey: () => getLaravelSecretKey,
+  parseLaravelEncryptedPayload: () => parseLaravelEncryptedPayload,
+  parseLaravelKey: () => parseLaravelKey,
   useServerBulletin: () => useServerBulletin,
   useServerDataGrid: () => useServerDataGrid,
   useServerTable: () => useServerTable,
@@ -2155,7 +2160,7 @@ function useServerBulletin({
     reload: () => setTick((t) => t + 1)
   };
 }
-function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customActions }) {
+function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customActions, headerAction, footerAction }) {
   const priority = item.priority ? PRIORITY_CONFIG[item.priority] : null;
   return (0, import_react_dom.createPortal)(
     /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
@@ -2174,7 +2179,8 @@ function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customAction
                 " Pinned"
               ] }),
               priority && /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(Badge, { variant: priority.badge, size: "sm", icon: priority.icon ?? void 0, children: priority.label }),
-              item.category && /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(Badge, { variant: "outline", size: "sm", children: item.category })
+              item.category && /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(Badge, { variant: "outline", size: "sm", children: item.category }),
+              headerAction
             ] }),
             /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)("div", { className: "flex items-center gap-1 shrink-0", children: [
               onEdit && /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
@@ -2273,6 +2279,7 @@ function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customAction
               ] })
             ] }) }),
             /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)("div", { className: "flex items-center gap-2", children: [
+              footerAction,
               onEdit && /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)(
                 "button",
                 {
@@ -2667,6 +2674,9 @@ function BulletinBoard({
   deleteBaseUrl,
   deleteIdKey = "id",
   serverPagination,
+  footerAction,
+  headerPreviewAction,
+  footerPreviewAction,
   className
 }) {
   const [previewItem, setPreviewItem] = React10.useState(null);
@@ -2751,6 +2761,7 @@ function BulletinBoard({
       /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(import_lucide_react5.Pin, { className: "h-8 w-8 opacity-20" }),
       emptyMessage
     ] }) : layout === "list" ? /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("div", { className: "flex flex-col gap-3", children: filtered.map((item) => /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(BulletinCard, { item, variant, layout: "list", onClick: handleCardClick }, item.id)) }) : layout === "masonry" ? /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("div", { className: cn("gap-4", COLS_CLASS[columns]), style: { display: "grid", gridTemplateRows: "masonry" }, children: filtered.map((item) => /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(BulletinCard, { item, variant, layout: "masonry", onClick: handleCardClick }, item.id)) }) : /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("div", { className: cn("grid gap-4", COLS_CLASS[columns]), children: filtered.map((item) => /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(BulletinCard, { item, variant, layout: "grid", onClick: handleCardClick }, item.id)) }),
+    footerAction && /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("div", { children: footerAction }),
     serverPagination && (() => {
       const { pagination, currentPage: cp, goToPage } = serverPagination;
       const totalPages = pagination.last_page ?? Math.ceil(pagination.total / pagination.per_page);
@@ -2827,7 +2838,9 @@ function BulletinBoard({
           setDeleteItem(item);
         } : onDelete ? (item) => {
           onDelete(item);
-        } : void 0
+        } : void 0,
+        footerAction: footerPreviewAction,
+        headerAction: headerPreviewAction
       }
     ),
     editItem && editBaseUrl && editFields && /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
@@ -13821,6 +13834,12 @@ function createStore(initialValue, sessionName, expireInterval) {
   };
   return { store, getStore };
 }
+
+// src/core/decryption/decode.ts
+function decryptResponse(response, key) {
+  const payload = typeof response === "string" ? response : response.data;
+  return decryptLaravelPayload(payload, key);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Accordion,
@@ -13921,6 +13940,11 @@ function createStore(initialValue, sessionName, expireInterval) {
   Wizard,
   api,
   createStore,
+  decryptLaravelPayload,
+  decryptResponse,
+  getLaravelSecretKey,
+  parseLaravelEncryptedPayload,
+  parseLaravelKey,
   useServerBulletin,
   useServerDataGrid,
   useServerTable,

package/dist/index.d.cts

@@ -3,6 +3,7 @@ import * as React from 'react';
 import React__default from 'react';
 import { AxiosRequestConfig } from 'axios';
 import { UseBoundStore, StoreApi } from 'zustand';
+import CryptoJS from 'crypto-js';
 
 type AuthView = "login" | "register" | "resetPassword";
 interface AuthField {
@@ -838,8 +839,12 @@ interface BulletinPreviewProps {
     onView?: (item: BulletinItem) => void;
     /** Custom actions to add to the preview header */
     customActions?: BulletinAction[];
+    /** Extra React elements rendered in the preview modal header's left area */
+    headerAction?: React.ReactNode;
+    /** Extra React elements rendered in the preview modal footer's action area */
+    footerAction?: React.ReactNode;
 }
-declare function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customActions }: BulletinPreviewProps): React.ReactPortal;
+declare function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customActions, headerAction, footerAction }: BulletinPreviewProps): React.ReactPortal;
 interface BulletinEditField {
     key: keyof BulletinItem | string;
     label: string;
@@ -898,10 +903,16 @@ interface BulletinBoardProps {
     serverPagination?: BulletinServerPaginationProp | null;
     /** Fired when a post card is clicked (ignored when preview=true). */
     onItemClick?: (item: BulletinItem) => void;
+    /** Extra React elements rendered below the board content (above pagination). */
+    footerAction?: React.ReactNode;
+    /** Extra React elements rendered in the preview modal header's left area. */
+    headerPreviewAction?: React.ReactNode;
+    /** Extra React elements rendered in the preview modal footer's action area. */
+    footerPreviewAction?: React.ReactNode;
     /** Additional CSS classes on the outer wrapper. */
     className?: string;
 }
-declare function BulletinBoard({ items, layout, columns, variant, searchable, filterable, categories: categoriesProp, title, headerAction, showHeader, emptyMessage, loading, loadingCount, onItemClick, onView, onEdit, onDelete, preview, editBaseUrl, editMethod, editIdKey, editFields, deleteBaseUrl, deleteIdKey, serverPagination, className, }: BulletinBoardProps): react_jsx_runtime.JSX.Element;
+declare function BulletinBoard({ items, layout, columns, variant, searchable, filterable, categories: categoriesProp, title, headerAction, showHeader, emptyMessage, loading, loadingCount, onItemClick, onView, onEdit, onDelete, preview, editBaseUrl, editMethod, editIdKey, editFields, deleteBaseUrl, deleteIdKey, serverPagination, footerAction, headerPreviewAction, footerPreviewAction, className, }: BulletinBoardProps): react_jsx_runtime.JSX.Element;
 
 interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     variant?: "primary" | "secondary" | "outline" | "ghost" | "link" | "danger" | "success" | "destructive";
@@ -2561,4 +2572,29 @@ type StoreWrapper<T extends object> = {
  */
 declare function createStore<T extends object>(initialValue: T, sessionName: string, expireInterval?: number): StoreWrapper<T>;
 
-export { Accordion, type AccordionItem, type AccordionProps, type AccordionVariant, type ActionField, type ActionFieldType, type AuthField, type AuthVariant, type AuthView, Authentication, type AuthenticationProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, type BadgeSize, type BadgeVariant, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, type BulletinAction, BulletinBoard, type BulletinBoardProps, type BulletinColumns, type BulletinEditField, type BulletinItem, type BulletinLayout, BulletinPreview, type BulletinPreviewProps, type BulletinPriority, type BulletinServerPaginationProp, type BulletinVariant, Button, type ButtonProps, COLOR_PALETTE, Calendar, CalendarDateRangePicker, type CalendarDateRangePickerProps, type CalendarDateRangeVariant, type CalendarEvent, type CalendarProps, type CalendarView, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type ChartDataPoint, ChartWidget, type ChartWidgetProps, Checkbox, type CheckboxProps, CircularProgress, type CircularProgressProps, type ClusterVariant, CodegoApiProvider, ColorPicker, type ColorPickerProps, type Column, Combobox, type ComboboxOption, type ComboboxProps, type CommandItem, CommandPalette, type CommandPaletteProps, ComposableWidget, type ComposableWidgetProps, type ConfirmVariant, ContextMenu, type ContextMenuItem, type ContextMenuProps, DataGrid, type DataGridColumn, type DataGridProps, DatePickerPopup, type DateRange, DateRangePicker, type DateRangePickerProps, type DefaultActionsConfig, DocsLayout, Drawer, type DrawerProps, type DrawerSide, Dropdown, DropdownItem, DropdownLabel, type DropdownProps, DropdownSeparator, EVENT_COLORS, type FileTypeValidation, FileUpload, type FileUploadProps, type FlexAlign, type FlexDirection, type FlexGap, FlexItem, type FlexItemProps, type FlexJustify, FlexLayout, type FlexLayoutProps, type FlexWrap, type FlyToOptions, type FormField, type FormFieldType, type GridAlign, type GridCols, type GridGap, GridItem, type GridItemProps, GridLayout, type GridLayoutProps, GroupNavigation, type GroupNavigationProps, type ImageEditorMode, type ImageEditorOptions, Input, type InputProps, KanbanBoard, type KanbanBoardProps, type KanbanCard, type KanbanColumn, Label, LeafletMap, type LeafletMapProps, LeftSidebar, type LeftSidebarProps, type MapLibreClusterVariant, MapLibreMap, type MapLibreMarker, type MapLibreProps, type MapLibreRoute, type MapLibreRouteType, type MapLibreStyle, type MapMarker, type MapRoute, type MarkerColor, type MetricItem, MetricRow, type MetricRowProps, Modal, ModalConfirmation, type ModalConfirmationProps, type ModalProps, ModalUnchange, type ModalUnchangeProps, ModalWithForms, type ModalWithFormsProps, type NavGroup, type NavItem, Navigation, type NavigationProps, NotificationBanner, type NotificationBannerProps, type NotificationItem, NotificationPanel, type NotificationPanelProps, type NotificationVariant, OtpInput, type OtpInputProps, Pagination, type PaginationProps, Panel, type PanelProps, PanelSettings, type PanelSettingsProps, type PanelSettingsTab, PanelSidebarGroup, PanelSidebarItem, Popover, type PopoverPlacement, type PopoverProps, Progress, type ProgressProps, type ProgressSize, type ProgressVariant, type PropRow, PropsTable, RadioGroup, type RadioGroupProps, type RadioOption, type RadioSize, type RadioVariant, RangeSlider, type RangeSliderProps, Repeater, type RepeaterProps, type RequestConfig, ResizablePanels, type ResizablePanelsProps, RichTextEditor, type RichTextEditorProps, RightSidebar, type RightSidebarProps, type RouteType, ScrollArea, type ScrollAreaProps, Section, SectionBlock, type SectionProps, type SectionVariant, Select, type SelectOption, type SelectProps, type SemanticColor, type ServerDataGridProp, type ServerPagination, type ServerPaginationLink, type ServerPaginationProp, type ServerTableResponse, Skeleton, Slider, type SliderProps, type SortDir, StatCard, type StatCardProps, type StatTrend, StatsWidget, type StatsWidgetProps, type Step, type StepStatus, Stepper, type StepperProps, type TabItem, type TabSize, type TabVariant, Table, TableOfContents, type TableProps, TableWidget, type TableWidgetProps, Tabs, type TabsProps, TagInput, type TagInputProps, Textarea, type TextareaProps, type ThemeColors, ThemeProvider, type ThemeSettings, Timeline, type TimelineItem, type TimelineProps, type TimelineVariant, type ToastItem, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, type TocItem, TocProvider, ToggleSwitch, type ToggleSwitchProps, Tooltip, type TooltipProps, Topbar, type TopbarProps, type TreeNode, TreeView, type TreeViewProps, type TrendDir, type UseServerBulletinOptions, type UseServerBulletinReturn, type UseServerDataGridOptions, type UseServerDataGridReturn, type UseServerTableOptions, type UseServerTableReturn, Widget, type WidgetProps, Wizard, type WizardActionProps, type WizardLayout, type WizardProps, type WizardSize, type WizardStep, type WizardVariant, api, createStore, useServerBulletin, useServerDataGrid, useServerTable, useTheme, useToast, useToc };
+type LaravelEncryptedPayload = {
+    iv: string;
+    value: string;
+    mac: string;
+    tag?: string;
+};
+declare function getLaravelSecretKey(): string;
+declare function parseLaravelKey(secretKey: string): CryptoJS.lib.WordArray;
+declare function parseLaravelEncryptedPayload(payload: string): LaravelEncryptedPayload;
+declare function decryptLaravelPayload<T>(payload: string, secretKey?: string): T;
+
+/**
+ * Decrypt a Laravel-encrypted API response.
+ *
+ * Accepts either:
+ *  - a raw encrypted string (the full response body)
+ *  - an object with an `data` key holding the encrypted string
+ *
+ * @param response  Raw encrypted string or `{ data: string }` object
+ * @param key       Optional Laravel APP_KEY (base64:… or raw). Falls back to VITE_LARAVEL_KEY.
+ */
+declare function decryptResponse<T = unknown>(response: string | {
+    data: string;
+}, key?: string): T;
+
+export { Accordion, type AccordionItem, type AccordionProps, type AccordionVariant, type ActionField, type ActionFieldType, type AuthField, type AuthVariant, type AuthView, Authentication, type AuthenticationProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, type BadgeSize, type BadgeVariant, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, type BulletinAction, BulletinBoard, type BulletinBoardProps, type BulletinColumns, type BulletinEditField, type BulletinItem, type BulletinLayout, BulletinPreview, type BulletinPreviewProps, type BulletinPriority, type BulletinServerPaginationProp, type BulletinVariant, Button, type ButtonProps, COLOR_PALETTE, Calendar, CalendarDateRangePicker, type CalendarDateRangePickerProps, type CalendarDateRangeVariant, type CalendarEvent, type CalendarProps, type CalendarView, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type ChartDataPoint, ChartWidget, type ChartWidgetProps, Checkbox, type CheckboxProps, CircularProgress, type CircularProgressProps, type ClusterVariant, CodegoApiProvider, ColorPicker, type ColorPickerProps, type Column, Combobox, type ComboboxOption, type ComboboxProps, type CommandItem, CommandPalette, type CommandPaletteProps, ComposableWidget, type ComposableWidgetProps, type ConfirmVariant, ContextMenu, type ContextMenuItem, type ContextMenuProps, DataGrid, type DataGridColumn, type DataGridProps, DatePickerPopup, type DateRange, DateRangePicker, type DateRangePickerProps, type DefaultActionsConfig, DocsLayout, Drawer, type DrawerProps, type DrawerSide, Dropdown, DropdownItem, DropdownLabel, type DropdownProps, DropdownSeparator, EVENT_COLORS, type FileTypeValidation, FileUpload, type FileUploadProps, type FlexAlign, type FlexDirection, type FlexGap, FlexItem, type FlexItemProps, type FlexJustify, FlexLayout, type FlexLayoutProps, type FlexWrap, type FlyToOptions, type FormField, type FormFieldType, type GridAlign, type GridCols, type GridGap, GridItem, type GridItemProps, GridLayout, type GridLayoutProps, GroupNavigation, type GroupNavigationProps, type ImageEditorMode, type ImageEditorOptions, Input, type InputProps, KanbanBoard, type KanbanBoardProps, type KanbanCard, type KanbanColumn, Label, type LaravelEncryptedPayload, LeafletMap, type LeafletMapProps, LeftSidebar, type LeftSidebarProps, type MapLibreClusterVariant, MapLibreMap, type MapLibreMarker, type MapLibreProps, type MapLibreRoute, type MapLibreRouteType, type MapLibreStyle, type MapMarker, type MapRoute, type MarkerColor, type MetricItem, MetricRow, type MetricRowProps, Modal, ModalConfirmation, type ModalConfirmationProps, type ModalProps, ModalUnchange, type ModalUnchangeProps, ModalWithForms, type ModalWithFormsProps, type NavGroup, type NavItem, Navigation, type NavigationProps, NotificationBanner, type NotificationBannerProps, type NotificationItem, NotificationPanel, type NotificationPanelProps, type NotificationVariant, OtpInput, type OtpInputProps, Pagination, type PaginationProps, Panel, type PanelProps, PanelSettings, type PanelSettingsProps, type PanelSettingsTab, PanelSidebarGroup, PanelSidebarItem, Popover, type PopoverPlacement, type PopoverProps, Progress, type ProgressProps, type ProgressSize, type ProgressVariant, type PropRow, PropsTable, RadioGroup, type RadioGroupProps, type RadioOption, type RadioSize, type RadioVariant, RangeSlider, type RangeSliderProps, Repeater, type RepeaterProps, type RequestConfig, ResizablePanels, type ResizablePanelsProps, RichTextEditor, type RichTextEditorProps, RightSidebar, type RightSidebarProps, type RouteType, ScrollArea, type ScrollAreaProps, Section, SectionBlock, type SectionProps, type SectionVariant, Select, type SelectOption, type SelectProps, type SemanticColor, type ServerDataGridProp, type ServerPagination, type ServerPaginationLink, type ServerPaginationProp, type ServerTableResponse, Skeleton, Slider, type SliderProps, type SortDir, StatCard, type StatCardProps, type StatTrend, StatsWidget, type StatsWidgetProps, type Step, type StepStatus, Stepper, type StepperProps, type TabItem, type TabSize, type TabVariant, Table, TableOfContents, type TableProps, TableWidget, type TableWidgetProps, Tabs, type TabsProps, TagInput, type TagInputProps, Textarea, type TextareaProps, type ThemeColors, ThemeProvider, type ThemeSettings, Timeline, type TimelineItem, type TimelineProps, type TimelineVariant, type ToastItem, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, type TocItem, TocProvider, ToggleSwitch, type ToggleSwitchProps, Tooltip, type TooltipProps, Topbar, type TopbarProps, type TreeNode, TreeView, type TreeViewProps, type TrendDir, type UseServerBulletinOptions, type UseServerBulletinReturn, type UseServerDataGridOptions, type UseServerDataGridReturn, type UseServerTableOptions, type UseServerTableReturn, Widget, type WidgetProps, Wizard, type WizardActionProps, type WizardLayout, type WizardProps, type WizardSize, type WizardStep, type WizardVariant, api, createStore, decryptLaravelPayload, decryptResponse, getLaravelSecretKey, parseLaravelEncryptedPayload, parseLaravelKey, useServerBulletin, useServerDataGrid, useServerTable, useTheme, useToast, useToc };

package/dist/index.d.ts

@@ -3,6 +3,7 @@ import * as React from 'react';
 import React__default from 'react';
 import { AxiosRequestConfig } from 'axios';
 import { UseBoundStore, StoreApi } from 'zustand';
+import CryptoJS from 'crypto-js';
 
 type AuthView = "login" | "register" | "resetPassword";
 interface AuthField {
@@ -838,8 +839,12 @@ interface BulletinPreviewProps {
     onView?: (item: BulletinItem) => void;
     /** Custom actions to add to the preview header */
     customActions?: BulletinAction[];
+    /** Extra React elements rendered in the preview modal header's left area */
+    headerAction?: React.ReactNode;
+    /** Extra React elements rendered in the preview modal footer's action area */
+    footerAction?: React.ReactNode;
 }
-declare function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customActions }: BulletinPreviewProps): React.ReactPortal;
+declare function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customActions, headerAction, footerAction }: BulletinPreviewProps): React.ReactPortal;
 interface BulletinEditField {
     key: keyof BulletinItem | string;
     label: string;
@@ -898,10 +903,16 @@ interface BulletinBoardProps {
     serverPagination?: BulletinServerPaginationProp | null;
     /** Fired when a post card is clicked (ignored when preview=true). */
     onItemClick?: (item: BulletinItem) => void;
+    /** Extra React elements rendered below the board content (above pagination). */
+    footerAction?: React.ReactNode;
+    /** Extra React elements rendered in the preview modal header's left area. */
+    headerPreviewAction?: React.ReactNode;
+    /** Extra React elements rendered in the preview modal footer's action area. */
+    footerPreviewAction?: React.ReactNode;
     /** Additional CSS classes on the outer wrapper. */
     className?: string;
 }
-declare function BulletinBoard({ items, layout, columns, variant, searchable, filterable, categories: categoriesProp, title, headerAction, showHeader, emptyMessage, loading, loadingCount, onItemClick, onView, onEdit, onDelete, preview, editBaseUrl, editMethod, editIdKey, editFields, deleteBaseUrl, deleteIdKey, serverPagination, className, }: BulletinBoardProps): react_jsx_runtime.JSX.Element;
+declare function BulletinBoard({ items, layout, columns, variant, searchable, filterable, categories: categoriesProp, title, headerAction, showHeader, emptyMessage, loading, loadingCount, onItemClick, onView, onEdit, onDelete, preview, editBaseUrl, editMethod, editIdKey, editFields, deleteBaseUrl, deleteIdKey, serverPagination, footerAction, headerPreviewAction, footerPreviewAction, className, }: BulletinBoardProps): react_jsx_runtime.JSX.Element;
 
 interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     variant?: "primary" | "secondary" | "outline" | "ghost" | "link" | "danger" | "success" | "destructive";
@@ -2561,4 +2572,29 @@ type StoreWrapper<T extends object> = {
  */
 declare function createStore<T extends object>(initialValue: T, sessionName: string, expireInterval?: number): StoreWrapper<T>;
 
-export { Accordion, type AccordionItem, type AccordionProps, type AccordionVariant, type ActionField, type ActionFieldType, type AuthField, type AuthVariant, type AuthView, Authentication, type AuthenticationProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, type BadgeSize, type BadgeVariant, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, type BulletinAction, BulletinBoard, type BulletinBoardProps, type BulletinColumns, type BulletinEditField, type BulletinItem, type BulletinLayout, BulletinPreview, type BulletinPreviewProps, type BulletinPriority, type BulletinServerPaginationProp, type BulletinVariant, Button, type ButtonProps, COLOR_PALETTE, Calendar, CalendarDateRangePicker, type CalendarDateRangePickerProps, type CalendarDateRangeVariant, type CalendarEvent, type CalendarProps, type CalendarView, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type ChartDataPoint, ChartWidget, type ChartWidgetProps, Checkbox, type CheckboxProps, CircularProgress, type CircularProgressProps, type ClusterVariant, CodegoApiProvider, ColorPicker, type ColorPickerProps, type Column, Combobox, type ComboboxOption, type ComboboxProps, type CommandItem, CommandPalette, type CommandPaletteProps, ComposableWidget, type ComposableWidgetProps, type ConfirmVariant, ContextMenu, type ContextMenuItem, type ContextMenuProps, DataGrid, type DataGridColumn, type DataGridProps, DatePickerPopup, type DateRange, DateRangePicker, type DateRangePickerProps, type DefaultActionsConfig, DocsLayout, Drawer, type DrawerProps, type DrawerSide, Dropdown, DropdownItem, DropdownLabel, type DropdownProps, DropdownSeparator, EVENT_COLORS, type FileTypeValidation, FileUpload, type FileUploadProps, type FlexAlign, type FlexDirection, type FlexGap, FlexItem, type FlexItemProps, type FlexJustify, FlexLayout, type FlexLayoutProps, type FlexWrap, type FlyToOptions, type FormField, type FormFieldType, type GridAlign, type GridCols, type GridGap, GridItem, type GridItemProps, GridLayout, type GridLayoutProps, GroupNavigation, type GroupNavigationProps, type ImageEditorMode, type ImageEditorOptions, Input, type InputProps, KanbanBoard, type KanbanBoardProps, type KanbanCard, type KanbanColumn, Label, LeafletMap, type LeafletMapProps, LeftSidebar, type LeftSidebarProps, type MapLibreClusterVariant, MapLibreMap, type MapLibreMarker, type MapLibreProps, type MapLibreRoute, type MapLibreRouteType, type MapLibreStyle, type MapMarker, type MapRoute, type MarkerColor, type MetricItem, MetricRow, type MetricRowProps, Modal, ModalConfirmation, type ModalConfirmationProps, type ModalProps, ModalUnchange, type ModalUnchangeProps, ModalWithForms, type ModalWithFormsProps, type NavGroup, type NavItem, Navigation, type NavigationProps, NotificationBanner, type NotificationBannerProps, type NotificationItem, NotificationPanel, type NotificationPanelProps, type NotificationVariant, OtpInput, type OtpInputProps, Pagination, type PaginationProps, Panel, type PanelProps, PanelSettings, type PanelSettingsProps, type PanelSettingsTab, PanelSidebarGroup, PanelSidebarItem, Popover, type PopoverPlacement, type PopoverProps, Progress, type ProgressProps, type ProgressSize, type ProgressVariant, type PropRow, PropsTable, RadioGroup, type RadioGroupProps, type RadioOption, type RadioSize, type RadioVariant, RangeSlider, type RangeSliderProps, Repeater, type RepeaterProps, type RequestConfig, ResizablePanels, type ResizablePanelsProps, RichTextEditor, type RichTextEditorProps, RightSidebar, type RightSidebarProps, type RouteType, ScrollArea, type ScrollAreaProps, Section, SectionBlock, type SectionProps, type SectionVariant, Select, type SelectOption, type SelectProps, type SemanticColor, type ServerDataGridProp, type ServerPagination, type ServerPaginationLink, type ServerPaginationProp, type ServerTableResponse, Skeleton, Slider, type SliderProps, type SortDir, StatCard, type StatCardProps, type StatTrend, StatsWidget, type StatsWidgetProps, type Step, type StepStatus, Stepper, type StepperProps, type TabItem, type TabSize, type TabVariant, Table, TableOfContents, type TableProps, TableWidget, type TableWidgetProps, Tabs, type TabsProps, TagInput, type TagInputProps, Textarea, type TextareaProps, type ThemeColors, ThemeProvider, type ThemeSettings, Timeline, type TimelineItem, type TimelineProps, type TimelineVariant, type ToastItem, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, type TocItem, TocProvider, ToggleSwitch, type ToggleSwitchProps, Tooltip, type TooltipProps, Topbar, type TopbarProps, type TreeNode, TreeView, type TreeViewProps, type TrendDir, type UseServerBulletinOptions, type UseServerBulletinReturn, type UseServerDataGridOptions, type UseServerDataGridReturn, type UseServerTableOptions, type UseServerTableReturn, Widget, type WidgetProps, Wizard, type WizardActionProps, type WizardLayout, type WizardProps, type WizardSize, type WizardStep, type WizardVariant, api, createStore, useServerBulletin, useServerDataGrid, useServerTable, useTheme, useToast, useToc };
+type LaravelEncryptedPayload = {
+    iv: string;
+    value: string;
+    mac: string;
+    tag?: string;
+};
+declare function getLaravelSecretKey(): string;
+declare function parseLaravelKey(secretKey: string): CryptoJS.lib.WordArray;
+declare function parseLaravelEncryptedPayload(payload: string): LaravelEncryptedPayload;
+declare function decryptLaravelPayload<T>(payload: string, secretKey?: string): T;
+
+/**
+ * Decrypt a Laravel-encrypted API response.
+ *
+ * Accepts either:
+ *  - a raw encrypted string (the full response body)
+ *  - an object with an `data` key holding the encrypted string
+ *
+ * @param response  Raw encrypted string or `{ data: string }` object
+ * @param key       Optional Laravel APP_KEY (base64:… or raw). Falls back to VITE_LARAVEL_KEY.
+ */
+declare function decryptResponse<T = unknown>(response: string | {
+    data: string;
+}, key?: string): T;
+
+export { Accordion, type AccordionItem, type AccordionProps, type AccordionVariant, type ActionField, type ActionFieldType, type AuthField, type AuthVariant, type AuthView, Authentication, type AuthenticationProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, type BadgeSize, type BadgeVariant, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, type BulletinAction, BulletinBoard, type BulletinBoardProps, type BulletinColumns, type BulletinEditField, type BulletinItem, type BulletinLayout, BulletinPreview, type BulletinPreviewProps, type BulletinPriority, type BulletinServerPaginationProp, type BulletinVariant, Button, type ButtonProps, COLOR_PALETTE, Calendar, CalendarDateRangePicker, type CalendarDateRangePickerProps, type CalendarDateRangeVariant, type CalendarEvent, type CalendarProps, type CalendarView, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type ChartDataPoint, ChartWidget, type ChartWidgetProps, Checkbox, type CheckboxProps, CircularProgress, type CircularProgressProps, type ClusterVariant, CodegoApiProvider, ColorPicker, type ColorPickerProps, type Column, Combobox, type ComboboxOption, type ComboboxProps, type CommandItem, CommandPalette, type CommandPaletteProps, ComposableWidget, type ComposableWidgetProps, type ConfirmVariant, ContextMenu, type ContextMenuItem, type ContextMenuProps, DataGrid, type DataGridColumn, type DataGridProps, DatePickerPopup, type DateRange, DateRangePicker, type DateRangePickerProps, type DefaultActionsConfig, DocsLayout, Drawer, type DrawerProps, type DrawerSide, Dropdown, DropdownItem, DropdownLabel, type DropdownProps, DropdownSeparator, EVENT_COLORS, type FileTypeValidation, FileUpload, type FileUploadProps, type FlexAlign, type FlexDirection, type FlexGap, FlexItem, type FlexItemProps, type FlexJustify, FlexLayout, type FlexLayoutProps, type FlexWrap, type FlyToOptions, type FormField, type FormFieldType, type GridAlign, type GridCols, type GridGap, GridItem, type GridItemProps, GridLayout, type GridLayoutProps, GroupNavigation, type GroupNavigationProps, type ImageEditorMode, type ImageEditorOptions, Input, type InputProps, KanbanBoard, type KanbanBoardProps, type KanbanCard, type KanbanColumn, Label, type LaravelEncryptedPayload, LeafletMap, type LeafletMapProps, LeftSidebar, type LeftSidebarProps, type MapLibreClusterVariant, MapLibreMap, type MapLibreMarker, type MapLibreProps, type MapLibreRoute, type MapLibreRouteType, type MapLibreStyle, type MapMarker, type MapRoute, type MarkerColor, type MetricItem, MetricRow, type MetricRowProps, Modal, ModalConfirmation, type ModalConfirmationProps, type ModalProps, ModalUnchange, type ModalUnchangeProps, ModalWithForms, type ModalWithFormsProps, type NavGroup, type NavItem, Navigation, type NavigationProps, NotificationBanner, type NotificationBannerProps, type NotificationItem, NotificationPanel, type NotificationPanelProps, type NotificationVariant, OtpInput, type OtpInputProps, Pagination, type PaginationProps, Panel, type PanelProps, PanelSettings, type PanelSettingsProps, type PanelSettingsTab, PanelSidebarGroup, PanelSidebarItem, Popover, type PopoverPlacement, type PopoverProps, Progress, type ProgressProps, type ProgressSize, type ProgressVariant, type PropRow, PropsTable, RadioGroup, type RadioGroupProps, type RadioOption, type RadioSize, type RadioVariant, RangeSlider, type RangeSliderProps, Repeater, type RepeaterProps, type RequestConfig, ResizablePanels, type ResizablePanelsProps, RichTextEditor, type RichTextEditorProps, RightSidebar, type RightSidebarProps, type RouteType, ScrollArea, type ScrollAreaProps, Section, SectionBlock, type SectionProps, type SectionVariant, Select, type SelectOption, type SelectProps, type SemanticColor, type ServerDataGridProp, type ServerPagination, type ServerPaginationLink, type ServerPaginationProp, type ServerTableResponse, Skeleton, Slider, type SliderProps, type SortDir, StatCard, type StatCardProps, type StatTrend, StatsWidget, type StatsWidgetProps, type Step, type StepStatus, Stepper, type StepperProps, type TabItem, type TabSize, type TabVariant, Table, TableOfContents, type TableProps, TableWidget, type TableWidgetProps, Tabs, type TabsProps, TagInput, type TagInputProps, Textarea, type TextareaProps, type ThemeColors, ThemeProvider, type ThemeSettings, Timeline, type TimelineItem, type TimelineProps, type TimelineVariant, type ToastItem, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, type TocItem, TocProvider, ToggleSwitch, type ToggleSwitchProps, Tooltip, type TooltipProps, Topbar, type TopbarProps, type TreeNode, TreeView, type TreeViewProps, type TrendDir, type UseServerBulletinOptions, type UseServerBulletinReturn, type UseServerDataGridOptions, type UseServerDataGridReturn, type UseServerTableOptions, type UseServerTableReturn, Widget, type WidgetProps, Wizard, type WizardActionProps, type WizardLayout, type WizardProps, type WizardSize, type WizardStep, type WizardVariant, api, createStore, decryptLaravelPayload, decryptResponse, getLaravelSecretKey, parseLaravelEncryptedPayload, parseLaravelKey, useServerBulletin, useServerDataGrid, useServerTable, useTheme, useToast, useToc };

package/dist/index.global.js

@@ -53730,6 +53730,11 @@ ${n2.shaderPreludeCode.vertexSource}`, define: n2.shaderDefine }, defaultProject
     Wizard: () => Wizard,
     api: () => api,
     createStore: () => createStore2,
+    decryptLaravelPayload: () => decryptLaravelPayload,
+    decryptResponse: () => decryptResponse,
+    getLaravelSecretKey: () => getLaravelSecretKey,
+    parseLaravelEncryptedPayload: () => parseLaravelEncryptedPayload,
+    parseLaravelKey: () => parseLaravelKey,
     useServerBulletin: () => useServerBulletin,
     useServerDataGrid: () => useServerDataGrid,
     useServerTable: () => useServerTable,
@@ -65325,7 +65330,7 @@ ${n2.shaderPreludeCode.vertexSource}`, define: n2.shaderDefine }, defaultProject
       reload: () => setTick((t) => t + 1)
     };
   }
-  function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customActions }) {
+  function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customActions, headerAction, footerAction }) {
     const priority = item.priority ? PRIORITY_CONFIG[item.priority] : null;
     return (0, import_react_dom.createPortal)(
       /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
@@ -65344,7 +65349,8 @@ ${n2.shaderPreludeCode.vertexSource}`, define: n2.shaderDefine }, defaultProject
                   " Pinned"
                 ] }),
                 priority && /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(Badge, { variant: priority.badge, size: "sm", icon: priority.icon ?? void 0, children: priority.label }),
-                item.category && /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(Badge, { variant: "outline", size: "sm", children: item.category })
+                item.category && /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(Badge, { variant: "outline", size: "sm", children: item.category }),
+                headerAction
               ] }),
               /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)("div", { className: "flex items-center gap-1 shrink-0", children: [
                 onEdit && /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
@@ -65443,6 +65449,7 @@ ${n2.shaderPreludeCode.vertexSource}`, define: n2.shaderDefine }, defaultProject
                 ] })
               ] }) }),
               /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)("div", { className: "flex items-center gap-2", children: [
+                footerAction,
                 onEdit && /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)(
                   "button",
                   {
@@ -65837,6 +65844,9 @@ ${n2.shaderPreludeCode.vertexSource}`, define: n2.shaderDefine }, defaultProject
     deleteBaseUrl,
     deleteIdKey = "id",
     serverPagination,
+    footerAction,
+    headerPreviewAction,
+    footerPreviewAction,
     className
   }) {
     const [previewItem, setPreviewItem] = React10.useState(null);
@@ -65921,6 +65931,7 @@ ${n2.shaderPreludeCode.vertexSource}`, define: n2.shaderDefine }, defaultProject
         /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(Pin, { className: "h-8 w-8 opacity-20" }),
         emptyMessage
       ] }) : layout === "list" ? /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("div", { className: "flex flex-col gap-3", children: filtered.map((item) => /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(BulletinCard, { item, variant, layout: "list", onClick: handleCardClick }, item.id)) }) : layout === "masonry" ? /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("div", { className: cn("gap-4", COLS_CLASS[columns]), style: { display: "grid", gridTemplateRows: "masonry" }, children: filtered.map((item) => /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(BulletinCard, { item, variant, layout: "masonry", onClick: handleCardClick }, item.id)) }) : /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("div", { className: cn("grid gap-4", COLS_CLASS[columns]), children: filtered.map((item) => /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(BulletinCard, { item, variant, layout: "grid", onClick: handleCardClick }, item.id)) }),
+      footerAction && /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("div", { children: footerAction }),
       serverPagination && (() => {
         const { pagination, currentPage: cp, goToPage } = serverPagination;
         const totalPages = pagination.last_page ?? Math.ceil(pagination.total / pagination.per_page);
@@ -65997,7 +66008,9 @@ ${n2.shaderPreludeCode.vertexSource}`, define: n2.shaderDefine }, defaultProject
             setDeleteItem(item);
           } : onDelete ? (item) => {
             onDelete(item);
-          } : void 0
+          } : void 0,
+          footerAction: footerPreviewAction,
+          headerAction: headerPreviewAction
         }
       ),
       editItem && editBaseUrl && editFields && /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
@@ -77628,6 +77641,12 @@ ${n2.shaderPreludeCode.vertexSource}`, define: n2.shaderDefine }, defaultProject
     };
     return { store, getStore };
   }
+
+  // src/core/decryption/decode.ts
+  function decryptResponse(response, key) {
+    const payload = typeof response === "string" ? response : response.data;
+    return decryptLaravelPayload(payload, key);
+  }
   return __toCommonJS(index_exports);
 })();
 /*! Bundled license information:

package/dist/index.js

@@ -2034,7 +2034,7 @@ function useServerBulletin({
     reload: () => setTick((t) => t + 1)
   };
 }
-function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customActions }) {
+function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customActions, headerAction, footerAction }) {
   const priority = item.priority ? PRIORITY_CONFIG[item.priority] : null;
   return createPortal2(
     /* @__PURE__ */ jsx12(
@@ -2053,7 +2053,8 @@ function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customAction
                 " Pinned"
               ] }),
               priority && /* @__PURE__ */ jsx12(Badge, { variant: priority.badge, size: "sm", icon: priority.icon ?? void 0, children: priority.label }),
-              item.category && /* @__PURE__ */ jsx12(Badge, { variant: "outline", size: "sm", children: item.category })
+              item.category && /* @__PURE__ */ jsx12(Badge, { variant: "outline", size: "sm", children: item.category }),
+              headerAction
             ] }),
             /* @__PURE__ */ jsxs10("div", { className: "flex items-center gap-1 shrink-0", children: [
               onEdit && /* @__PURE__ */ jsx12(
@@ -2152,6 +2153,7 @@ function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customAction
               ] })
             ] }) }),
             /* @__PURE__ */ jsxs10("div", { className: "flex items-center gap-2", children: [
+              footerAction,
               onEdit && /* @__PURE__ */ jsxs10(
                 "button",
                 {
@@ -2546,6 +2548,9 @@ function BulletinBoard({
   deleteBaseUrl,
   deleteIdKey = "id",
   serverPagination,
+  footerAction,
+  headerPreviewAction,
+  footerPreviewAction,
   className
 }) {
   const [previewItem, setPreviewItem] = React10.useState(null);
@@ -2630,6 +2635,7 @@ function BulletinBoard({
       /* @__PURE__ */ jsx12(Pin, { className: "h-8 w-8 opacity-20" }),
       emptyMessage
     ] }) : layout === "list" ? /* @__PURE__ */ jsx12("div", { className: "flex flex-col gap-3", children: filtered.map((item) => /* @__PURE__ */ jsx12(BulletinCard, { item, variant, layout: "list", onClick: handleCardClick }, item.id)) }) : layout === "masonry" ? /* @__PURE__ */ jsx12("div", { className: cn("gap-4", COLS_CLASS[columns]), style: { display: "grid", gridTemplateRows: "masonry" }, children: filtered.map((item) => /* @__PURE__ */ jsx12(BulletinCard, { item, variant, layout: "masonry", onClick: handleCardClick }, item.id)) }) : /* @__PURE__ */ jsx12("div", { className: cn("grid gap-4", COLS_CLASS[columns]), children: filtered.map((item) => /* @__PURE__ */ jsx12(BulletinCard, { item, variant, layout: "grid", onClick: handleCardClick }, item.id)) }),
+    footerAction && /* @__PURE__ */ jsx12("div", { children: footerAction }),
     serverPagination && (() => {
       const { pagination, currentPage: cp, goToPage } = serverPagination;
       const totalPages = pagination.last_page ?? Math.ceil(pagination.total / pagination.per_page);
@@ -2706,7 +2712,9 @@ function BulletinBoard({
           setDeleteItem(item);
         } : onDelete ? (item) => {
           onDelete(item);
-        } : void 0
+        } : void 0,
+        footerAction: footerPreviewAction,
+        headerAction: headerPreviewAction
       }
     ),
     editItem && editBaseUrl && editFields && /* @__PURE__ */ jsx12(
@@ -13700,6 +13708,12 @@ function createStore(initialValue, sessionName, expireInterval) {
   };
   return { store, getStore };
 }
+
+// src/core/decryption/decode.ts
+function decryptResponse(response, key) {
+  const payload = typeof response === "string" ? response : response.data;
+  return decryptLaravelPayload(payload, key);
+}
 export {
   Accordion,
   Authentication,
@@ -13799,6 +13813,11 @@ export {
   Wizard,
   api,
   createStore,
+  decryptLaravelPayload,
+  decryptResponse,
+  getLaravelSecretKey,
+  parseLaravelEncryptedPayload,
+  parseLaravelKey,
   useServerBulletin,
   useServerDataGrid,
   useServerTable,

package/package.json

@@ -4,7 +4,7 @@
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
-  "version": "3.5.4",
+  "version": "3.5.6",
   "description": "Reusable React UI components",
   "license": "MIT",
   "main": "dist/index.js",