@juv/codego-react-ui 3.5.5 → 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

@@ -2160,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)(
@@ -2179,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)(
@@ -2278,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",
                 {
@@ -2672,6 +2674,9 @@ function BulletinBoard({
   deleteBaseUrl,
   deleteIdKey = "id",
   serverPagination,
+  footerAction,
+  headerPreviewAction,
+  footerPreviewAction,
   className
 }) {
   const [previewItem, setPreviewItem] = React10.useState(null);
@@ -2756,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);
@@ -2832,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)(

package/dist/index.d.cts

@@ -839,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;
@@ -899,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";

package/dist/index.d.ts

@@ -839,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;
@@ -899,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";

package/dist/index.global.js

@@ -65330,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)(
@@ -65349,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)(
@@ -65448,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",
                   {
@@ -65842,6 +65844,9 @@ ${n2.shaderPreludeCode.vertexSource}`, define: n2.shaderDefine }, defaultProject
     deleteBaseUrl,
     deleteIdKey = "id",
     serverPagination,
+    footerAction,
+    headerPreviewAction,
+    footerPreviewAction,
     className
   }) {
     const [previewItem, setPreviewItem] = React10.useState(null);
@@ -65926,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);
@@ -66002,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)(

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(

package/package.json

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