@juv/codego-react-ui 3.5.21 → 3.6.1

package/README.md

@@ -619,6 +619,14 @@ function AnnouncementsPage() {
 }
 ```
 
+> **Note:** `useServerBulletin` uses the internal `codego` api client which automatically attaches the Bearer token from `localStorage.getItem("token")`. For encrypted Laravel responses, pass `encrypt: true` and set `VITE_LARAVEL_KEY` in your `.env`:
+>
+> ```
+> VITE_LARAVEL_KEY=base64:your_app_key_here
+> ```
+>
+> Or pass the key directly: `key: "base64:..."`. The response can be a plain array `[...]` or a paginated object `{ data: [...], total, per_page, ... }` — both are handled automatically.
+
 ---
 
 ## LeafletMap Props
@@ -731,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,7 +127,11 @@ __export(index_exports, {
   Wizard: () => Wizard,
   api: () => api,
   createStore: () => createStore,
-  useServerBulletin: () => useServerBulletin,
+  decryptLaravelPayload: () => decryptLaravelPayload,
+  decryptResponse: () => decryptResponse,
+  getLaravelSecretKey: () => getLaravelSecretKey,
+  parseLaravelEncryptedPayload: () => parseLaravelEncryptedPayload,
+  parseLaravelKey: () => parseLaravelKey,
   useServerDataGrid: () => useServerDataGrid,
   useServerTable: () => useServerTable,
   useTheme: () => useTheme,
@@ -165,6 +169,7 @@ function FloatingPortal({ children }) {
 
 // src/components/ui/button.tsx
 var React = __toESM(require("react"), 1);
+var ReactDOM2 = __toESM(require("react-dom"), 1);
 var import_jsx_runtime = require("react/jsx-runtime");
 var Button = React.forwardRef(
   ({
@@ -243,6 +248,8 @@ var Button = React.forwardRef(
     confirmBeforeClickModalTitle,
     confirmBeforeClickModalContent,
     confirmBeforeClickFooterAction,
+    onConfirm,
+    onCancel,
     href,
     target,
     as = "button",
@@ -338,11 +345,13 @@ var Button = React.forwardRef(
     };
     function handleConfirmProceed() {
       setConfirmOpen(false);
+      onConfirm?.();
       onClick?.(pendingEvent.current ?? void 0);
       pendingEvent.current = null;
     }
     function handleConfirmCancel() {
       setConfirmOpen(false);
+      onCancel?.();
       pendingEvent.current = null;
     }
     const buttonContent = /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [
@@ -370,46 +379,49 @@ var Button = React.forwardRef(
       tabIndex,
       "data-testid": testID
     };
-    const confirmModal = confirmBeforeClick && confirmOpen ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
-      "div",
-      {
-        className: "fixed inset-0 z-50 flex items-center justify-center",
-        onClick: handleConfirmCancel,
-        children: [
-          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "absolute inset-0 bg-black/50 backdrop-blur-sm" }),
-          /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
-            "div",
-            {
-              className: "relative z-10 w-full max-w-sm rounded-2xl border border-border bg-card p-6 shadow-2xl",
-              onClick: (e) => e.stopPropagation(),
-              children: [
-                /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { className: "text-base font-semibold text-foreground mb-2", children: confirmBeforeClickModalTitle ?? "Are you sure?" }),
-                confirmBeforeClickModalContent && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "text-sm text-muted-foreground mb-5", children: confirmBeforeClickModalContent }),
-                /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "flex justify-end gap-2 mt-4", children: confirmBeforeClickFooterAction ?? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [
-                  /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-                    "button",
-                    {
-                      type: "button",
-                      onClick: handleConfirmCancel,
-                      className: "inline-flex items-center justify-center rounded-md border border-border bg-background px-4 py-2 text-sm font-medium text-foreground hover:bg-accent transition-colors",
-                      children: "Cancel"
-                    }
-                  ),
-                  /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-                    "button",
-                    {
-                      type: "button",
-                      onClick: handleConfirmProceed,
-                      className: "inline-flex items-center justify-center rounded-md bg-primary px-4 py-2 text-sm font-medium text-primary-foreground hover:bg-primary-hover transition-colors",
-                      children: "Proceed"
-                    }
-                  )
-                ] }) })
-              ]
-            }
-          )
-        ]
-      }
+    const confirmModal = confirmBeforeClick && confirmOpen ? ReactDOM2.createPortal(
+      /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+        "div",
+        {
+          className: "fixed inset-0 z-[9999] flex items-center justify-center",
+          onClick: handleConfirmCancel,
+          children: [
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "absolute inset-0 bg-black/50 backdrop-blur-sm" }),
+            /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+              "div",
+              {
+                className: "relative z-10 w-full max-w-sm rounded-2xl border border-border bg-card p-6 shadow-2xl",
+                onClick: (e) => e.stopPropagation(),
+                children: [
+                  /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { className: "text-base font-semibold text-foreground mb-2", children: confirmBeforeClickModalTitle ?? "Are you sure?" }),
+                  confirmBeforeClickModalContent && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "text-sm text-muted-foreground mb-5", children: confirmBeforeClickModalContent }),
+                  /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "flex justify-end gap-2 mt-4", children: confirmBeforeClickFooterAction ?? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [
+                    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                      "button",
+                      {
+                        type: "button",
+                        onClick: handleConfirmCancel,
+                        className: "inline-flex items-center justify-center rounded-md border border-border bg-background px-4 py-2 text-sm font-medium text-foreground hover:bg-accent transition-colors",
+                        children: "Cancel"
+                      }
+                    ),
+                    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                      "button",
+                      {
+                        type: "button",
+                        onClick: handleConfirmProceed,
+                        className: "inline-flex items-center justify-center rounded-md bg-primary px-4 py-2 text-sm font-medium text-primary-foreground hover:bg-primary-hover transition-colors",
+                        children: "Proceed"
+                      }
+                    )
+                  ] }) })
+                ]
+              }
+            )
+          ]
+        }
+      ),
+      document.body
     ) : null;
     if (Element === "a") {
       return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [
@@ -1559,66 +1571,6 @@ var React8 = __toESM(require("react"), 1);
 var import_react_dom = require("react-dom");
 var import_axios2 = __toESM(require("axios"), 1);
 var import_lucide_react4 = require("lucide-react");
-
-// src/components/tools/decryptPayload.ts
-var import_crypto_js = __toESM(require("crypto-js"), 1);
-function getLaravelSecretKey() {
-  const viteKey = (() => {
-    try {
-      return new Function("return import.meta.env")();
-    } catch {
-      return void 0;
-    }
-  })()?.VITE_LARAVEL_KEY;
-  const legacyKey = globalThis?.process?.env?.REACT_APP_LARAVEL_KEY;
-  const windowKey = globalThis?.__LARAVEL_KEY__;
-  const key = viteKey || legacyKey || windowKey;
-  if (!key) {
-    throw new Error("Missing Laravel decryption key. Set VITE_LARAVEL_KEY in your .env or inject window.__LARAVEL_KEY__ via Blade.");
-  }
-  return key;
-}
-function parseLaravelKey(secretKey) {
-  if (secretKey.startsWith("base64:")) {
-    return import_crypto_js.default.enc.Base64.parse(secretKey.slice("base64:".length));
-  }
-  return import_crypto_js.default.enc.Utf8.parse(secretKey);
-}
-function parseLaravelEncryptedPayload(payload) {
-  let jsonStr = payload;
-  try {
-    jsonStr = atob(payload);
-  } catch {
-  }
-  return JSON.parse(jsonStr);
-}
-function decryptLaravelPayload(payload, secretKey) {
-  const resolvedKey = secretKey ?? getLaravelSecretKey();
-  const parsed = parseLaravelEncryptedPayload(payload);
-  if (parsed.tag) {
-    throw new Error("Unsupported Laravel cipher (AEAD tag present). Expected AES-*-CBC payload.");
-  }
-  const key = parseLaravelKey(resolvedKey);
-  const expectedMac = import_crypto_js.default.HmacSHA256(parsed.iv + parsed.value, key).toString(import_crypto_js.default.enc.Hex);
-  if (expectedMac !== parsed.mac) {
-    throw new Error("Invalid payload MAC (wrong key or tampered payload).");
-  }
-  const iv = import_crypto_js.default.enc.Base64.parse(parsed.iv);
-  const ciphertext = import_crypto_js.default.enc.Base64.parse(parsed.value);
-  const cipherParams = import_crypto_js.default.lib.CipherParams.create({ ciphertext });
-  const decrypted = import_crypto_js.default.AES.decrypt(cipherParams, key, {
-    iv,
-    mode: import_crypto_js.default.mode.CBC,
-    padding: import_crypto_js.default.pad.Pkcs7
-  });
-  const plaintext = decrypted.toString(import_crypto_js.default.enc.Utf8);
-  if (!plaintext) {
-    throw new Error("Decryption produced empty plaintext (wrong key/cipher).");
-  }
-  return JSON.parse(plaintext);
-}
-
-// src/components/ui/bulletin-board.tsx
 var import_jsx_runtime10 = require("react/jsx-runtime");
 var PRIORITY_CONFIG = {
   urgent: { label: "Urgent", icon: /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(import_lucide_react4.AlertCircle, { className: "h-3 w-3" }), badge: "error" },
@@ -1648,82 +1600,13 @@ function AuthorAvatar({ item }) {
   }
   return null;
 }
-function useServerBulletin({
-  url,
-  params,
-  encrypt,
-  key,
-  decryptPayloadLog,
-  transform
-}) {
-  const [items, setItems] = React8.useState([]);
-  const [currentPage, setCurrentPage] = React8.useState(1);
-  const [pagination, setPagination] = React8.useState(null);
-  const [loading, setLoading] = React8.useState(false);
-  const [error, setError] = React8.useState(null);
-  const [tick, setTick] = React8.useState(0);
-  React8.useEffect(() => {
-    let cancelled = false;
-    setLoading(true);
-    setError(null);
-    import_axios2.default.get(url, { params: { ...params, page: currentPage } }).then(({ data: res }) => {
-      if (cancelled) return;
-      let payload;
-      try {
-        payload = encrypt ? decryptLaravelPayload(res, key) : res;
-      } catch (decryptErr) {
-        console.error("[useServerBulletin] decryption failed:", decryptErr?.message ?? decryptErr);
-        if (!cancelled) setError(decryptErr?.message ?? "Decryption failed");
-        return;
-      }
-      if (encrypt && decryptPayloadLog) console.log("[useServerBulletin] decrypted:", payload);
-      const rows = Array.isArray(payload) ? payload : payload.data ?? [];
-      setItems(transform ? rows.map(transform) : rows);
-      if (!Array.isArray(payload)) {
-        const rawTotal = payload.total;
-        const rawPerPage = payload.per_page;
-        const rawLastPage = payload.last_page;
-        const lastPage = rawLastPage ?? Math.ceil(rawTotal / rawPerPage);
-        const pg = payload.pagination ?? {
-          first_page_url: payload.first_page_url ?? `${url}?page=1`,
-          last_page_url: payload.last_page_url ?? `${url}?page=${lastPage}`,
-          last_page: lastPage,
-          next_page_url: payload.next_page_url !== void 0 ? payload.next_page_url : currentPage < lastPage ? `${url}?page=${currentPage + 1}` : null,
-          prev_page_url: payload.prev_page_url !== void 0 ? payload.prev_page_url : currentPage > 1 ? `${url}?page=${currentPage - 1}` : null,
-          per_page: rawPerPage,
-          total: rawTotal,
-          links: payload.links ?? []
-        };
-        setPagination(pg);
-      }
-    }).catch((err) => {
-      if (cancelled) return;
-      setError(err?.response?.data?.message ?? err.message ?? "Request failed");
-    }).finally(() => {
-      if (!cancelled) setLoading(false);
-    });
-    return () => {
-      cancelled = true;
-    };
-  }, [url, currentPage, tick, JSON.stringify(params), encrypt, decryptPayloadLog]);
-  return {
-    items,
-    currentPage,
-    pagination,
-    serverPagination: pagination ? { pagination, currentPage, goToPage: (p) => setCurrentPage(p) } : null,
-    loading,
-    error,
-    goToPage: (p) => setCurrentPage(p),
-    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_runtime10.jsx)(
       "div",
       {
-        className: "fixed inset-0 z-50 flex items-center justify-center p-4",
+        className: "fixed inset-0 z-50 flex glass items-center justify-center p-4",
         style: { background: "rgba(0,0,0,0.55)" },
         onMouseDown: (e) => {
           if (e.target === e.currentTarget) onClose();
@@ -1736,7 +1619,8 @@ function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customAction
                 " Pinned"
               ] }),
               priority && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(Badge, { variant: priority.badge, size: "sm", icon: priority.icon ?? void 0, children: priority.label }),
-              item.category && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(Badge, { variant: "outline", size: "sm", children: item.category })
+              item.category && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(Badge, { variant: "outline", size: "sm", children: item.category }),
+              headerAction
             ] }),
             /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { className: "flex items-center gap-1 shrink-0", children: [
               onEdit && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
@@ -1835,6 +1719,7 @@ function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customAction
               ] })
             ] }) }),
             /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { className: "flex items-center gap-2", children: [
+              footerAction,
               onEdit && /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)(
                 "button",
                 {
@@ -2229,6 +2114,9 @@ function BulletinBoard({
   deleteBaseUrl,
   deleteIdKey = "id",
   serverPagination,
+  footerAction,
+  headerPreviewAction,
+  footerPreviewAction,
   className
 }) {
   const [previewItem, setPreviewItem] = React8.useState(null);
@@ -2313,6 +2201,7 @@ function BulletinBoard({
       /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(import_lucide_react4.Pin, { className: "h-8 w-8 opacity-20" }),
       emptyMessage
     ] }) : layout === "list" ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { className: "flex flex-col gap-3", children: filtered.map((item) => /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(BulletinCard, { item, variant, layout: "list", onClick: handleCardClick }, item.id)) }) : layout === "masonry" ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { className: cn("gap-4", COLS_CLASS[columns]), style: { display: "grid", gridTemplateRows: "masonry" }, children: filtered.map((item) => /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(BulletinCard, { item, variant, layout: "masonry", onClick: handleCardClick }, item.id)) }) : /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { className: cn("grid gap-4", COLS_CLASS[columns]), children: filtered.map((item) => /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(BulletinCard, { item, variant, layout: "grid", onClick: handleCardClick }, item.id)) }),
+    footerAction && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { children: footerAction }),
     serverPagination && (() => {
       const { pagination, currentPage: cp, goToPage } = serverPagination;
       const totalPages = pagination.last_page ?? Math.ceil(pagination.total / pagination.per_page);
@@ -2389,7 +2278,9 @@ function BulletinBoard({
           setDeleteItem(item);
         } : onDelete ? (item) => {
           onDelete(item);
-        } : void 0
+        } : void 0,
+        footerAction: footerPreviewAction ? footerPreviewAction(previewItem) : void 0,
+        headerAction: headerPreviewAction
       }
     ),
     editItem && editBaseUrl && editFields && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
@@ -3863,6 +3754,66 @@ function MetricRow({ items, divided = true, className }) {
 // src/components/ui/data-grid.tsx
 var React29 = __toESM(require("react"), 1);
 var import_react_dom3 = require("react-dom");
+
+// src/components/tools/decryptPayload.ts
+var import_crypto_js = __toESM(require("crypto-js"), 1);
+function getLaravelSecretKey() {
+  const viteKey = (() => {
+    try {
+      return new Function("return import.meta.env")();
+    } catch {
+      return void 0;
+    }
+  })()?.VITE_LARAVEL_KEY;
+  const legacyKey = globalThis?.process?.env?.REACT_APP_LARAVEL_KEY;
+  const windowKey = globalThis?.__LARAVEL_KEY__;
+  const key = viteKey || legacyKey || windowKey;
+  if (!key) {
+    throw new Error("Missing Laravel decryption key. Set VITE_LARAVEL_KEY in your .env or inject window.__LARAVEL_KEY__ via Blade.");
+  }
+  return key;
+}
+function parseLaravelKey(secretKey) {
+  if (secretKey.startsWith("base64:")) {
+    return import_crypto_js.default.enc.Base64.parse(secretKey.slice("base64:".length));
+  }
+  return import_crypto_js.default.enc.Utf8.parse(secretKey);
+}
+function parseLaravelEncryptedPayload(payload) {
+  let jsonStr = payload;
+  try {
+    jsonStr = atob(payload);
+  } catch {
+  }
+  return JSON.parse(jsonStr);
+}
+function decryptLaravelPayload(payload, secretKey) {
+  const resolvedKey = secretKey ?? getLaravelSecretKey();
+  const parsed = parseLaravelEncryptedPayload(payload);
+  if (parsed.tag) {
+    throw new Error("Unsupported Laravel cipher (AEAD tag present). Expected AES-*-CBC payload.");
+  }
+  const key = parseLaravelKey(resolvedKey);
+  const expectedMac = import_crypto_js.default.HmacSHA256(parsed.iv + parsed.value, key).toString(import_crypto_js.default.enc.Hex);
+  if (expectedMac !== parsed.mac) {
+    throw new Error("Invalid payload MAC (wrong key or tampered payload).");
+  }
+  const iv = import_crypto_js.default.enc.Base64.parse(parsed.iv);
+  const ciphertext = import_crypto_js.default.enc.Base64.parse(parsed.value);
+  const cipherParams = import_crypto_js.default.lib.CipherParams.create({ ciphertext });
+  const decrypted = import_crypto_js.default.AES.decrypt(cipherParams, key, {
+    iv,
+    mode: import_crypto_js.default.mode.CBC,
+    padding: import_crypto_js.default.pad.Pkcs7
+  });
+  const plaintext = decrypted.toString(import_crypto_js.default.enc.Utf8);
+  if (!plaintext) {
+    throw new Error("Decryption produced empty plaintext (wrong key/cipher).");
+  }
+  return JSON.parse(plaintext);
+}
+
+// src/components/ui/data-grid.tsx
 var import_axios4 = __toESM(require("axios"), 1);
 var import_lucide_react18 = require("lucide-react");
 
@@ -6806,7 +6757,7 @@ function ModalShell({ title, onClose, children, footer, width = "lg" }) {
     /* @__PURE__ */ (0, import_jsx_runtime32.jsx)(
       "div",
       {
-        className: "fixed inset-0 z-50 flex items-center justify-center p-4",
+        className: "fixed inset-0 z-50 flex glass items-center justify-center p-4",
         style: { background: "rgba(0,0,0,0.5)" },
         onMouseDown: (e) => {
           if (e.target === e.currentTarget) onClose();
@@ -11163,7 +11114,7 @@ var import_lucide_react25 = require("lucide-react");
 
 // src/components/ui/tooltip.tsx
 var React38 = __toESM(require("react"), 1);
-var ReactDOM2 = __toESM(require("react-dom"), 1);
+var ReactDOM3 = __toESM(require("react-dom"), 1);
 var import_jsx_runtime44 = require("react/jsx-runtime");
 function Tooltip({
   content,
@@ -11218,7 +11169,7 @@ function Tooltip({
       onBlur: () => setVisible(false),
       children: [
         children,
-        visible && ReactDOM2.createPortal(
+        visible && ReactDOM3.createPortal(
           /* @__PURE__ */ (0, import_jsx_runtime44.jsx)(
             "div",
             {
@@ -13817,6 +13768,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,
@@ -13917,7 +13874,11 @@ function createStore(initialValue, sessionName, expireInterval) {
   Wizard,
   api,
   createStore,
-  useServerBulletin,
+  decryptLaravelPayload,
+  decryptResponse,
+  getLaravelSecretKey,
+  parseLaravelEncryptedPayload,
+  parseLaravelKey,
   useServerDataGrid,
   useServerTable,
   useTheme,

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 {
@@ -810,26 +811,6 @@ interface BulletinServerPaginationProp {
     currentPage: number;
     goToPage: (page: number) => void;
 }
-interface UseServerBulletinOptions {
-    url: string;
-    params?: Record<string, string | number>;
-    encrypt?: boolean;
-    key?: string;
-    decryptPayloadLog?: boolean;
-    /** Map raw API row → BulletinItem */
-    transform?: (row: any) => BulletinItem;
-}
-interface UseServerBulletinReturn {
-    items: BulletinItem[];
-    currentPage: number;
-    pagination: ServerPagination | null;
-    serverPagination: BulletinServerPaginationProp | null;
-    loading: boolean;
-    error: string | null;
-    goToPage: (page: number) => void;
-    reload: () => void;
-}
-declare function useServerBulletin({ url, params, encrypt, key, decryptPayloadLog, transform, }: UseServerBulletinOptions): UseServerBulletinReturn;
 interface BulletinPreviewProps {
     item: BulletinItem;
     onClose: () => void;
@@ -838,8 +819,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 +883,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?: (item: BulletinItem) => 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";
@@ -978,6 +969,8 @@ interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     confirmBeforeClickModalTitle?: string;
     confirmBeforeClickModalContent?: React.ReactNode;
     confirmBeforeClickFooterAction?: React.ReactNode;
+    onConfirm?: () => void;
+    onCancel?: () => void;
     href?: string;
     target?: "_blank" | "_self";
     as?: "button" | "a" | "div";
@@ -2561,4 +2554,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 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, useServerDataGrid, useServerTable, useTheme, useToast, useToc };