@greatapps/common 1.1.785 → 1.1.787

package/src/components/layouts/AppMobileNavBar.tsx

@@ -2,8 +2,10 @@
 
 import { ReactNode } from "react";
 import Image from "next/image";
+import { useTranslations } from "next-intl";
 import { IconMenu2, IconX } from "@tabler/icons-react";
 import { ProfilePopover } from "./ProfilePopover";
+import { GreatDomainIcon } from "./GreatDomainIcon";
 import { Tooltip, TooltipContent, TooltipTrigger } from "../ui/overlay/Tooltip";
 import { useMobileNavbarSheet } from "../../store/useMobileNavbarSheet";
 import {
@@ -15,11 +17,13 @@ import type { ProfileMenuItem } from "./ProfilePopover";
 
 export interface AppMobileNavBarProps {
   /** Which app is currently active — controls which icon gets the indicator */
-  activeApp?: "gapps" | "gpages";
+  activeApp?: "gapps" | "gpages" | "gdomain";
   /** Called when the GreatApps logo is clicked */
   onLogoClick?: () => void;
   /** Called when the app icon (e.g. GreatPages) is clicked */
   onAppIconClick?: () => void;
+  /** Called when the GreatDomain icon is clicked; without it the icon is not rendered (app flag) */
+  onDomainIconClick?: () => void;
   /** Extra slot rendered after the app icon (e.g. project selector) */
   extraLeftSlot?: ReactNode;
   menuItems?: ProfileMenuItem[];
@@ -30,10 +34,12 @@ export function AppMobileNavBar({
   activeApp,
   onLogoClick,
   onAppIconClick,
+  onDomainIconClick,
   extraLeftSlot,
   menuItems = [],
   showMenuToggle = true,
 }: AppMobileNavBarProps) {
+  const translate = useTranslations();
   const { isOpen, toggle } = useMobileNavbarSheet();
   const { whitelabel } = useWhitelabel();
   const isDefaultWl = useIsDefaultWhitelabel();
@@ -42,6 +48,7 @@ export function AppMobileNavBar({
 
   const isGappsActive = activeApp === "gapps";
   const isGpagesActive = activeApp === "gpages";
+  const isGdomainActive = activeApp === "gdomain";
 
   const wlIcon = whitelabel?.secondary_logo ? (
     <Image
@@ -80,9 +87,9 @@ export function AppMobileNavBar({
 
   return (
     <div className="fixed top-0 left-0 right-0 flex md:hidden items-center justify-between p-4 bg-white z-50 border-b border-gray-200">
-      <div className="flex items-center gap-1.5">
+      <div className="flex items-center gap-1.5 min-w-0">
         {/* GreatApps logo */}
-        <div className="relative">
+        <div className="relative shrink-0">
           <Tooltip>
             <TooltipTrigger asChild>
               <div
@@ -119,7 +126,7 @@ export function AppMobileNavBar({
         </div>
 
         {/* GreatPages icon */}
-        <div className="relative">
+        <div className="relative shrink-0">
           <Tooltip>
             <TooltipTrigger asChild>
               <div
@@ -187,9 +194,86 @@ export function AppMobileNavBar({
           />
         </div>
 
-        {extraLeftSlot}
+        {/* GreatDomain icon */}
+        {onDomainIconClick ? (
+          <div className="relative shrink-0">
+            <Tooltip>
+              <TooltipTrigger asChild>
+                <div
+                  aria-label={
+                    isDefaultWl
+                      ? translate("common.layout.navbar.greatDomain")
+                      : translate("common.layout.navbar.domains")
+                  }
+                  className={cn(
+                    "size-10 rounded-[10px] flex items-center justify-center border-2 ring-2 transition-colors duration-300",
+                    isGdomainActive
+                      ? isDefaultWl
+                        ? "bg-[#EDE9FE] border-white ring-[#C092FF]"
+                        : "border-white ring-transparent"
+                      : isDefaultWl
+                        ? "hover:bg-gray-100 border-transparent ring-transparent"
+                        : "border-transparent ring-transparent",
+                    "cursor-pointer",
+                  )}
+                  style={
+                    !isDefaultWl
+                      ? {
+                          backgroundColor: primaryColor,
+                          boxShadow: isGdomainActive
+                            ? `0 0 0 2px ${primaryColor}40`
+                            : undefined,
+                          opacity: !isGdomainActive ? 0.2 : undefined,
+                        }
+                      : undefined
+                  }
+                  onClick={onDomainIconClick}
+                >
+                  {isDefaultWl ? (
+                    <GreatDomainIcon active={isGdomainActive} />
+                  ) : (
+                    <svg
+                      xmlns="http://www.w3.org/2000/svg"
+                      width="24"
+                      height="24"
+                      viewBox="0 0 24 24"
+                      fill="none"
+                      stroke="white"
+                      strokeWidth="2"
+                      strokeLinecap="round"
+                      strokeLinejoin="round"
+                    >
+                      <path d="M3 12a9 9 0 1 0 18 0a9 9 0 0 0 -18 0" />
+                      <path d="M3.6 9h16.8" />
+                      <path d="M3.6 15h16.8" />
+                      <path d="M11.5 3a17 17 0 0 0 0 18" />
+                      <path d="M12.5 3a17 17 0 0 1 0 18" />
+                    </svg>
+                  )}
+                </div>
+              </TooltipTrigger>
+              <TooltipContent side="bottom">
+                {isDefaultWl
+                  ? translate("common.layout.navbar.greatDomain")
+                  : translate("common.layout.navbar.domains")}
+              </TooltipContent>
+            </Tooltip>
+            <div
+              className={cn(
+                "absolute -bottom-[17px] left-1/2 -translate-x-1/2 w-5 h-[3px] rounded-t-xl transition-opacity duration-300",
+                isDefaultWl ? "bg-[#984DFF]" : "",
+                isGdomainActive ? "opacity-100" : "opacity-0",
+              )}
+              style={!isDefaultWl ? { backgroundColor: primaryColor } : undefined}
+            />
+          </div>
+        ) : null}
+
+        {extraLeftSlot ? (
+          <div className="min-w-0 shrink [&>*]:max-w-full">{extraLeftSlot}</div>
+        ) : null}
       </div>
-      <div className="flex items-center gap-1.5">
+      <div className="flex items-center gap-1.5 shrink-0">
         <ProfilePopover
           side="bottom"
           align="end"

package/src/components/layouts/AppNavBar.tsx

@@ -8,8 +8,10 @@ import type { ProfileMenuItem } from "./ProfilePopover";
 export interface AppNavBarProps {
   logoHref: string;
   appIconHref: string;
+  /** Sem href o ícone do GreatDomain não é renderizado: é a flag do app. */
+  domainIconHref?: string;
   /** Which app is currently active — controls which icon gets the indicator */
-  activeApp?: "gapps" | "gpages";
+  activeApp?: "gapps" | "gpages" | "gdomain";
   showExpandButton?: boolean;
   onExpandClick?: () => void;
   menuItems?: ProfileMenuItem[];
@@ -19,6 +21,7 @@ export interface AppNavBarProps {
 export function AppNavBar({
   logoHref,
   appIconHref,
+  domainIconHref,
   activeApp,
   showExpandButton = false,
   onExpandClick,
@@ -29,6 +32,7 @@ export function AppNavBar({
     <NavBar
       logoHref={logoHref}
       appIconHref={appIconHref}
+      domainIconHref={domainIconHref}
       activeApp={activeApp}
       showExpandButton={showExpandButton}
       onExpandClick={onExpandClick}

package/src/components/layouts/GreatDomainIcon.tsx

@@ -0,0 +1,43 @@
+"use client";
+
+import { cn } from "../../infra/utils/clsx";
+
+type GreatDomainIconProps = {
+  /** Em repouso o círculo é #650CE4; só no estado ativo vira #984DFF. */
+  active?: boolean;
+  className?: string;
+};
+
+/**
+ * Glifo do GreatDomain — geometria exportada do Figma (node 5929:2700), 23×23.
+ * O círculo só troca de cor quando ativo. No hover o container ganha fundo cinza
+ * (igual ao GreatPages) e o glifo fica como está.
+ */
+function GreatDomainIcon({ active, className }: GreatDomainIconProps) {
+  return (
+    <svg
+      width="23"
+      height="23"
+      viewBox="0 0 23 23"
+      fill="none"
+      xmlns="http://www.w3.org/2000/svg"
+      className={className}
+      aria-hidden="true"
+    >
+      <path
+        d="M11.8444 17.0777C11.8444 20.3487 9.19292 23.0003 5.92218 23.0003C2.65145 23.0003 0 20.3487 0 17.0777C0 13.8068 2.65145 11.1551 5.92218 11.1551C9.19292 11.1551 11.8444 13.8068 11.8444 17.0777Z"
+        className={cn(
+          "transition-colors duration-300",
+          active ? "fill-[#984DFF]" : "fill-[#650CE4]",
+        )}
+      />
+      <path
+        d="M11.8436 3.06666C11.8436 1.37299 13.2166 0 14.9103 0H19.9331C21.6267 0 22.9997 1.37299 22.9997 3.06666V19.9333C22.9997 21.6269 21.6267 22.9999 19.9331 22.9999H14.9103C13.2166 22.9999 11.8436 21.6269 11.8436 19.9333V3.06666Z"
+        fill="#C9B2FF"
+      />
+    </svg>
+  );
+}
+
+export { GreatDomainIcon };
+export type { GreatDomainIconProps };

package/src/components/layouts/NavBar.tsx

@@ -6,11 +6,13 @@ import Link from "next/link";
 import { useTranslations } from "next-intl";
 import { IconChevronRight } from "@tabler/icons-react";
 import { Separator } from "../ui/data-display/Separator";
+import { GreatDomainIcon } from "./GreatDomainIcon";
 import { Tooltip, TooltipContent, TooltipTrigger } from "../ui/overlay/Tooltip";
 import {
   useDesktopSidebarStore,
   useDesktopSidebarHydration,
 } from "../../store/useDesktopSidebarStore";
+import { useMdSidebarHydration } from "../../store/useMdSidebarStore";
 import {
   useWhitelabel,
   useIsDefaultWhitelabel,
@@ -20,7 +22,9 @@ import { cn } from "../../infra/utils/clsx";
 type NavBarProps = {
   logoHref: string;
   appIconHref: string;
-  activeApp?: "gapps" | "gpages";
+  /** Sem href o ícone do GreatDomain não é renderizado: é a flag do app. */
+  domainIconHref?: string;
+  activeApp?: "gapps" | "gpages" | "gdomain";
   showExpandButton?: boolean;
   onExpandClick?: () => void;
   children?: React.ReactNode;
@@ -30,6 +34,7 @@ type NavBarProps = {
 function NavBar({
   logoHref,
   appIconHref,
+  domainIconHref,
   activeApp,
   showExpandButton = false,
   onExpandClick,
@@ -40,6 +45,7 @@ function NavBar({
   const { isExpanded: isDesktopExpanded, toggle: toggleDesktop } =
     useDesktopSidebarStore();
   useDesktopSidebarHydration();
+  useMdSidebarHydration();
   const { whitelabel } = useWhitelabel();
   const isDefaultWl = useIsDefaultWhitelabel();
   const primaryColor = whitelabel?.general?.primary_color;
@@ -130,7 +136,9 @@ function NavBar({
                   <IconChevronRight size={16} className="text-gray-500" />
                 </button>
               </TooltipTrigger>
-              <TooltipContent side="right">{translate('common.layout.navbar.expandMenu')}</TooltipContent>
+              <TooltipContent side="right">
+                {translate("common.layout.navbar.expandMenu")}
+              </TooltipContent>
             </Tooltip>
           )}
           {/* Desktop expand button */}
@@ -144,78 +152,164 @@ function NavBar({
                   <IconChevronRight size={16} className="text-gray-500" />
                 </button>
               </TooltipTrigger>
-              <TooltipContent side="right">{translate('common.layout.navbar.expandMenu')}</TooltipContent>
+              <TooltipContent side="right">
+                {translate("common.layout.navbar.expandMenu")}
+              </TooltipContent>
             </Tooltip>
           )}
         </div>
 
-        {/* GreatPages icon */}
-        <div className="relative">
-          <Tooltip>
-            <TooltipTrigger asChild>
-              <Link
-                href={appIconHref}
+        {/* Ícones de app — 8px entre eles (Figma 5929:2676) */}
+        <div className="flex flex-col gap-2 items-center">
+          {/* GreatPages icon */}
+          <div className="relative">
+            <Tooltip>
+              <TooltipTrigger asChild>
+                <Link
+                  href={appIconHref}
+                  className={cn(
+                    "size-10 rounded-lg cursor-pointer flex items-center justify-center border-2 ring-2 transition-colors duration-300",
+                    activeApp === "gpages"
+                      ? isDefaultWl
+                        ? "bg-cyan-100 border-white ring-cyan-300"
+                        : "border-white ring-transparent"
+                      : isDefaultWl
+                        ? "hover:bg-gray-100 border-transparent ring-transparent"
+                        : "border-transparent ring-transparent",
+                  )}
+                  style={
+                    !isDefaultWl
+                      ? {
+                          backgroundColor: primaryColor,
+                          boxShadow:
+                            activeApp === "gpages"
+                              ? `0 0 0 2px ${primaryColor}40`
+                              : undefined,
+                          opacity: activeApp !== "gpages" ? 0.2 : undefined,
+                        }
+                      : undefined
+                  }
+                >
+                  {isDefaultWl ? (
+                    <Image
+                      src="/icons/icon-navbar.svg"
+                      alt="GreatPages"
+                      width={24}
+                      height={24}
+                    />
+                  ) : (
+                    <svg
+                      xmlns="http://www.w3.org/2000/svg"
+                      width="24"
+                      height="24"
+                      viewBox="0 0 24 24"
+                      fill="none"
+                      stroke="white"
+                      strokeWidth="2"
+                      strokeLinecap="round"
+                      strokeLinejoin="round"
+                    >
+                      <path d="M4 8h16" />
+                      <path d="M4 6a2 2 0 0 1 2 -2h12a2 2 0 0 1 2 2v12a2 2 0 0 1 -2 2h-12a2 2 0 0 1 -2 -2l0 -12" />
+                      <path d="M8 4v4" />
+                    </svg>
+                  )}
+                </Link>
+              </TooltipTrigger>
+              <TooltipContent side="right">
+                {isDefaultWl
+                  ? translate("common.layout.navbar.greatPages")
+                  : translate("common.layout.navbar.pages")}
+              </TooltipContent>
+            </Tooltip>
+            <div
+              className={cn(
+                "absolute -left-4 top-1/2 -translate-y-1/2 z-10 w-[3px] h-5 rounded-r-xl transition-opacity duration-300",
+                isDefaultWl ? "bg-cyan-300" : "",
+                activeApp === "gpages" ? "opacity-100" : "opacity-0",
+              )}
+              style={
+                !isDefaultWl ? { backgroundColor: primaryColor } : undefined
+              }
+            />
+          </div>
+
+          {/* GreatDomain icon */}
+          {domainIconHref ? (
+            <div className="relative">
+              <Tooltip>
+                <TooltipTrigger asChild>
+                  <Link
+                    href={domainIconHref}
+                    aria-label={
+                      isDefaultWl
+                        ? translate("common.layout.navbar.greatDomain")
+                        : translate("common.layout.navbar.domains")
+                    }
+                    className={cn(
+                      "size-10 rounded-[10px] cursor-pointer flex items-center justify-center border-2 ring-2 transition-colors duration-300",
+                      activeApp === "gdomain"
+                        ? isDefaultWl
+                          ? "bg-[#EDE9FE] border-white ring-[#C092FF]"
+                          : "border-white ring-transparent"
+                        : isDefaultWl
+                          ? "hover:bg-gray-100 border-transparent ring-transparent"
+                          : "border-transparent ring-transparent",
+                    )}
+                    style={
+                      !isDefaultWl
+                        ? {
+                            backgroundColor: primaryColor,
+                            boxShadow:
+                              activeApp === "gdomain"
+                                ? `0 0 0 2px ${primaryColor}40`
+                                : undefined,
+                            opacity: activeApp !== "gdomain" ? 0.2 : undefined,
+                          }
+                        : undefined
+                    }
+                  >
+                    {isDefaultWl ? (
+                      <GreatDomainIcon active={activeApp === "gdomain"} />
+                    ) : (
+                      <svg
+                        xmlns="http://www.w3.org/2000/svg"
+                        width="24"
+                        height="24"
+                        viewBox="0 0 24 24"
+                        fill="none"
+                        stroke="white"
+                        strokeWidth="2"
+                        strokeLinecap="round"
+                        strokeLinejoin="round"
+                      >
+                        <path d="M3 12a9 9 0 1 0 18 0a9 9 0 0 0 -18 0" />
+                        <path d="M3.6 9h16.8" />
+                        <path d="M3.6 15h16.8" />
+                        <path d="M11.5 3a17 17 0 0 0 0 18" />
+                        <path d="M12.5 3a17 17 0 0 1 0 18" />
+                      </svg>
+                    )}
+                  </Link>
+                </TooltipTrigger>
+                <TooltipContent side="right">
+                  {isDefaultWl
+                    ? translate("common.layout.navbar.greatDomain")
+                    : translate("common.layout.navbar.domains")}
+                </TooltipContent>
+              </Tooltip>
+              <div
                 className={cn(
-                  "size-10 rounded-lg cursor-pointer flex items-center justify-center border-2 ring-2 transition-colors duration-300",
-                  activeApp === "gpages"
-                    ? isDefaultWl
-                      ? "bg-cyan-100 border-white ring-cyan-300"
-                      : "border-white ring-transparent"
-                    : isDefaultWl
-                      ? "hover:bg-gray-100 border-transparent ring-transparent"
-                      : "border-transparent ring-transparent",
+                  "absolute -left-4 top-1/2 -translate-y-1/2 z-10 w-[3px] h-5 rounded-r-xl transition-opacity duration-300",
+                  isDefaultWl ? "bg-[#984DFF]" : "",
+                  activeApp === "gdomain" ? "opacity-100" : "opacity-0",
                 )}
                 style={
-                  !isDefaultWl
-                    ? {
-                        backgroundColor: primaryColor,
-                        boxShadow:
-                          activeApp === "gpages"
-                            ? `0 0 0 2px ${primaryColor}40`
-                            : undefined,
-                        opacity: activeApp !== "gpages" ? 0.2 : undefined,
-                      }
-                    : undefined
+                  !isDefaultWl ? { backgroundColor: primaryColor } : undefined
                 }
-              >
-                {isDefaultWl ? (
-                  <Image
-                    src="/icons/icon-navbar.svg"
-                    alt="GreatPages"
-                    width={24}
-                    height={24}
-                  />
-                ) : (
-                  <svg
-                    xmlns="http://www.w3.org/2000/svg"
-                    width="24"
-                    height="24"
-                    viewBox="0 0 24 24"
-                    fill="none"
-                    stroke="white"
-                    strokeWidth="2"
-                    strokeLinecap="round"
-                    strokeLinejoin="round"
-                  >
-                    <path d="M4 8h16" />
-                    <path d="M4 6a2 2 0 0 1 2 -2h12a2 2 0 0 1 2 2v12a2 2 0 0 1 -2 2h-12a2 2 0 0 1 -2 -2l0 -12" />
-                    <path d="M8 4v4" />
-                  </svg>
-                )}
-              </Link>
-            </TooltipTrigger>
-            <TooltipContent side="right">
-              {isDefaultWl ? translate('common.layout.navbar.greatPages') : translate('common.layout.navbar.pages')}
-            </TooltipContent>
-          </Tooltip>
-          <div
-            className={cn(
-              "absolute -left-4 top-1/2 -translate-y-1/2 z-10 w-[3px] h-5 rounded-r-xl transition-opacity duration-300",
-              isDefaultWl ? "bg-cyan-300" : "",
-              activeApp === "gpages" ? "opacity-100" : "opacity-0",
-            )}
-            style={!isDefaultWl ? { backgroundColor: primaryColor } : undefined}
-          />
+              />
+            </div>
+          ) : null}
         </div>
       </div>
 

package/src/components/ui/form/PhoneInput.tsx

@@ -45,7 +45,7 @@ export default function PhoneInput({
   const translate = useTranslations();
   const parsed = parsePhoneValue(value ?? '');
   const [selectedCountry, setSelectedCountry] = useState<Country>(parsed.country);
-  const [phoneNumber, setPhoneNumber] = useState(parsed.number);
+  const [phoneNumber, setPhoneNumber] = useState(formatNational(parsed.number, parsed.country.iso));
   const [search, setSearch] = useState('');
   const [open, setOpen] = useState(false);
   const prevValueRef = useRef(value);

package/src/handlers.ts

@@ -20,6 +20,7 @@ export { createListAvailableUsersHandler } from './modules/projects/handlers/lis
 export { createListAllAccountUsersHandler } from './modules/projects/handlers/list-all-account-users.handler';
 
 export { createListSubscriptionsHandler } from './modules/subscriptions/handlers/list-subscriptions.handler';
+export { createCurrentSubscriptionHandler } from './modules/subscriptions/handlers/current-subscription.handler';
 export { createFreezeNoticeHandler } from './modules/subscriptions/handlers/freeze-notice.handler';
 
 export { createListMessagesHandler } from './modules/users/handlers/list-messages.handler';

package/src/i18n/messages/en-us.ts

@@ -540,6 +540,8 @@ const messages = {
       expandMenu: 'Expand menu',
       greatPages: 'GreatPages',
       pages: 'Pages',
+      greatDomain: 'GreatDomain',
+      domains: 'Domains',
     },
     profile: {
       usedCredits: 'Credits used',

package/src/i18n/messages/es-es.ts

@@ -541,6 +541,8 @@ const messages = {
       expandMenu: 'Expandir menú',
       greatPages: 'GreatPages',
       pages: 'Páginas',
+      greatDomain: 'GreatDomain',
+      domains: 'Dominios',
     },
     profile: {
       usedCredits: 'Créditos utilizados',

package/src/i18n/messages/pt-br.ts

@@ -620,6 +620,8 @@ const messages = {
       expandMenu: 'Expandir menu',
       greatPages: 'GreatPages',
       pages: 'Páginas',
+      greatDomain: 'GreatDomain',
+      domains: 'Domínios',
     },
     profile: {
       usedCredits: 'Créditos usados',

package/src/index.ts

@@ -86,6 +86,8 @@ export {
   CHARGES_QUERY_KEY,
   FREEZE_NOTICE_QUERY_KEY,
 } from "./modules/subscriptions/constants/query-keys.constants";
+export { useCurrentSubscription } from "./modules/subscriptions/hooks/use-current-subscription.hook";
+/** @deprecated Use `useCurrentSubscription`. Sai na 1.1.784. */
 export { useActiveSubscription } from "./modules/subscriptions/hooks/find-active-subscription.hook";
 export { useCancelledSubscriptionGuard } from "./modules/subscriptions/hooks/use-cancelled-subscription-guard";
 export { useAccountFreeze } from "./modules/subscriptions/hooks/use-account-freeze.hook";
@@ -222,7 +224,11 @@ export {
   confirmPaymentIfRequired,
   PaymentAuthenticationError,
 } from "./modules/subscriptions/utils/confirm-payment-if-required";
-export { SUBSCRIPTION_GRACE_PERIOD_DAYS } from "./modules/subscriptions/constants/subscription.constants";
+export {
+  SUBSCRIPTION_GRACE_PERIOD_DAYS,
+  FREE_PLAN_ID,
+} from "./modules/subscriptions/constants/subscription.constants";
+export { groupSubscriptionsByProduct } from "./modules/subscriptions/utils/group-subscriptions-by-product";
 export { getSubscriptionCancellationState } from "./modules/subscriptions/utils/get-subscription-cancellation-state";
 export type { SubscriptionCancellationState } from "./modules/subscriptions/utils/get-subscription-cancellation-state";
 export {
@@ -291,7 +297,7 @@ export { formatShortDate, formatDateTime, calendarDateSchema, toCalendarDate, da
 export { buildQueryParams } from "./infra/utils/params";
 export { parseSchema, parseResult } from "./infra/utils/parser";
 export { withAction } from "./utils/withAction";
-export { resolveSafeRedirect, sameHostOr } from "./utils/redirect";
+export { resolveSafeRedirect, sameHostOr, isSameSiteUrl } from "./utils/redirect";
 export { COUNTRIES, flagUrl } from "./utils/countries";
 export type { Country } from "./utils/countries";
 

package/src/infra/api/client.ts

@@ -31,6 +31,11 @@ export interface ApiClientOptions {
   emitLogs?: boolean;
 }
 
+interface ApiErrorResponseBody {
+  message?: string | { message?: string };
+  code?: string;
+}
+
 export interface RequestConfig extends RequestInit {
   timeout?: number;
   /** Padrão `json`. Use `text` quando a API devolve corpo não-JSON. */
@@ -169,9 +174,12 @@ class ApiClient {
         let message = `HTTP error ${response.status} ${response.statusText} ${errBody}`;
         let code = "HTTP_ERROR";
         try {
-          const errorData = JSON.parse(errBody) as Record<string, unknown>;
-          // @ts-ignore -- msg pode ser string ou objeto com .message
-          message = errorData.message?.message ?? errorData.message ?? message;
+          const errorData: ApiErrorResponseBody = JSON.parse(errBody);
+          if (typeof errorData.message === "string") {
+            message = errorData.message;
+          } else if (errorData.message?.message) {
+            message = errorData.message.message;
+          }
           if (typeof errorData.code === "string") code = errorData.code;
         } catch {
           if (errBody.trim()) message = errBody.trim();

package/src/infra/api/types.ts

@@ -1,9 +1,9 @@
 import z from 'zod';
 
-export const PaginationParamsSchema = z.object({
-  page: z.number().min(1).optional().default(1),
-  limit: z.number().optional().default(20),
-});
+export const PaginationParamsSchema = z.object({
+  page: z.number().min(1).optional().default(1),
+  limit: z.number().optional().default(20),
+});
 
 export interface PaginationParams extends z.infer<typeof PaginationParamsSchema> {}
 
@@ -51,6 +51,8 @@ export interface PaginatedSuccessResult<T> extends Omit<SuccessResult<T>, 'data'
 export interface ErrorResult {
   success: false;
   error?: string;
+  code?: string;
+  statusCode?: number;
 }
 
 export type ActionResult<T> = SuccessResult<T> | ErrorResult;
@@ -60,7 +62,7 @@ export class ApiError extends Error {
   public readonly code: string;
   public readonly statusCode: number;
 
-  constructor(message: string, code: string = 'UNKNOWN_ERROR', statusCode: number = 500) {
+  constructor(message: string = 'Erro desconhecido', code: string = 'UNKNOWN_ERROR', statusCode: number = 500) {
     super(message);
     this.name = 'ApiError';
     this.code = code;

package/src/infra/route/safe-route-handler.ts

@@ -8,7 +8,10 @@ export async function safeRouteHandler<T>(fn: () => Promise<T>): Promise<Respons
     return Response.json({ success: true, data });
   } catch (error) {
     if (error instanceof ApiError) {
-      return Response.json({ success: false, error: error.message }, { status: error.statusCode });
+      return Response.json(
+        { success: false, error: error.message, code: error.code },
+        { status: error.statusCode },
+      );
     }
     console.error('[safeRouteHandler] erro inesperado', error);
     return Response.json({ success: false, error: 'Erro interno do servidor' }, { status: 500 });