@greatapps/common 1.1.786 → 1.1.787

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 {

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 });

package/src/modules/auth/utils/assert-account-not-frozen.ts

@@ -1,22 +1,23 @@
 import "server-only";
 
 import { ApiError } from "../../../infra/api/types";
-import { listSubscriptionsAction } from "../../subscriptions/actions/list-subscriptions.action";
+import { readCurrentSubscription } from "../../subscriptions/utils/read-current-subscription";
 import { getAccountFreezeState } from "../../subscriptions/utils/get-account-freeze-state";
+import type { Subscription } from "../../subscriptions/types/subscription.type";
 
 export async function assertAccountNotFrozen(): Promise<void> {
-  const result = await listSubscriptionsAction({ active: true });
+  let subscription: Subscription | null;
 
-  if (!result.success) {
+  try {
+    subscription = await readCurrentSubscription();
+  } catch (error) {
     console.error(
       "[assertAccountNotFrozen] failed to read subscription context:",
-      result.error,
+      error,
     );
     return;
   }
 
-  const subscription = result.data?.data?.[0];
-
   if (!subscription) return;
 
   if (getAccountFreezeState(subscription) !== "frozen") return;

package/src/modules/auth/utils/assert-management-subscription.ts

@@ -1,32 +1,23 @@
 import "server-only";
 
-import { cache } from "react";
-
 import { ApiError } from "../../../infra/api/types";
-import { listSubscriptionsAction } from "../../subscriptions/actions/list-subscriptions.action";
+import { readCurrentSubscription } from "../../subscriptions/utils/read-current-subscription";
+import { getSubscriptionCancellationState } from "../../subscriptions/utils/get-subscription-cancellation-state";
 import { getSubscriptionExpiryDate } from "../../subscriptions/utils/get-subscription-expiry-date";
 
 /**
- * Deduplicado por request via React.cache, como `getCurrentUserProfile` e `requireValidSession`.
+ * A leitura por trás (`readCurrentSubscription`) já é deduplicada por request via
+ * React.cache, então não precisa de outra camada aqui: em produção (26/08) o mesmo
+ * carregamento disparava até quatro cópias da mesma pergunta em paralelo, com 727 ms,
+ * 4,2 s, 5,0 s e 7,0 s, contra um p50 de 528 ms; agora é uma leitura só,
+ * compartilhada pelos quatro gates.
  *
- * A leitura por trás é `/accounts/{id}/subscriptions?limit=1`, e ela é MAIS cara que o gate de
- * perfil: para conta Stripe a listagem consulta a API do gateway ao vivo. Em produção (26/08) o
- * mesmo carregamento disparou quatro dessas em paralelo — 727 ms, 4,2 s, 5,0 s e 7,0 s, contra um
- * p50 de 528 ms para o endpoint. Elas se atrasam entre si: são cópias da mesma pergunta disputando
- * a mesma fila.
+ * A checagem de cancelamento é obrigatória além da de vencimento: a corrente pode
+ * vir com `active: false` (baixa por falha de pagamento) com `date_due` ainda no
+ * futuro, caso que só `getSubscriptionExpiryDate` não cobre.
  */
-export const assertManagementSubscription = cache(async () => {
-  const result = await listSubscriptionsAction({ active: true });
-
-  if (!result.success) {
-    throw new ApiError(
-      result.error || "Não foi possível validar a assinatura atual",
-      "SUBSCRIPTION_CONTEXT_FAILED",
-      403,
-    );
-  }
-
-  const subscription = result.data?.data?.[0];
+export async function assertManagementSubscription(): Promise<void> {
+  const subscription = await readCurrentSubscription();
 
   if (!subscription) {
     throw new ApiError(
@@ -36,14 +27,15 @@ export const assertManagementSubscription = cache(async () => {
     );
   }
 
+  const isCancelled = getSubscriptionCancellationState(subscription) === "cancelled";
   const expiryDate = getSubscriptionExpiryDate(subscription);
   const isExpired = !!expiryDate && Date.now() >= expiryDate.getTime();
 
-  if (isExpired) {
+  if (isCancelled || isExpired) {
     throw new ApiError(
       "Sua assinatura está vencida. Assine um novo plano para continuar.",
       "SUBSCRIPTION_EXPIRED",
       403,
     );
   }
-});
+}

package/src/modules/auth/utils/assert-paid-subscription.ts

@@ -1,21 +1,13 @@
 import "server-only";
 
 import { ApiError } from "../../../infra/api/types";
-import { listSubscriptionsAction } from "../../subscriptions/actions/list-subscriptions.action";
+import { readCurrentSubscription } from "../../subscriptions/utils/read-current-subscription";
+import { getSubscriptionCancellationState } from "../../subscriptions/utils/get-subscription-cancellation-state";
 import { getSubscriptionExpiryDate } from "../../subscriptions/utils/get-subscription-expiry-date";
+import { FREE_PLAN_ID } from "../../subscriptions/constants/subscription.constants";
 
 export async function assertPaidSubscription() {
-  const result = await listSubscriptionsAction({ active: true });
-
-  if (!result.success) {
-    throw new ApiError(
-      result.error || "Não foi possível validar a assinatura atual",
-      "SUBSCRIPTION_CONTEXT_FAILED",
-      403,
-    );
-  }
-
-  const subscription = result.data?.data?.[0];
+  const subscription = await readCurrentSubscription();
 
   if (!subscription) {
     throw new ApiError(
@@ -25,10 +17,11 @@ export async function assertPaidSubscription() {
     );
   }
 
+  const isCancelled = getSubscriptionCancellationState(subscription) === "cancelled";
   const expiryDate = getSubscriptionExpiryDate(subscription);
   const isExpired = !!expiryDate && Date.now() >= expiryDate.getTime();
 
-  if (isExpired) {
+  if (isCancelled || isExpired) {
     throw new ApiError(
       "Sua assinatura está vencida. Assine um novo plano para continuar.",
       "SUBSCRIPTION_EXPIRED",
@@ -36,8 +29,7 @@ export async function assertPaidSubscription() {
     );
   }
 
-  
-  if (subscription.type === 'free' || subscription.id_plan === 5) {
+  if (subscription.type === 'free' || subscription.id_plan === FREE_PLAN_ID) {
     throw new ApiError(
       "Este recurso está disponível apenas para planos pagos. Faça upgrade do seu plano para continuar.",
       "PAID_SUBSCRIPTION_REQUIRED",

package/src/modules/auth/utils/assert-subscription-addon.ts

@@ -1,24 +1,14 @@
 import "server-only";
 
 import { ApiError } from "../../../infra/api/types";
-import { listSubscriptionsAction } from "../../subscriptions/actions/list-subscriptions.action";
+import { readCurrentSubscription } from "../../subscriptions/utils/read-current-subscription";
 import type { AddonKindEnum } from "../../subscriptions/constants/addons.constants";
 
 export async function assertSubscriptionAddon(
   addonId: AddonKindEnum,
   addonLabel: string,
 ) {
-  const result = await listSubscriptionsAction({ active: true });
-
-  if (!result.success) {
-    throw new ApiError(
-      result.error || "Não foi possível validar a assinatura atual",
-      "SUBSCRIPTION_CONTEXT_FAILED",
-      403,
-    );
-  }
-
-  const subscription = result.data?.data?.[0];
+  const subscription = await readCurrentSubscription();
 
   if (!subscription) {
     throw new ApiError(

package/src/modules/plans/hooks/use-plan-by-id.hook.ts

@@ -11,7 +11,7 @@ export function usePlanById(idPlan?: number | string | null) {
   const queryClient = useQueryClient();
   const plansKey = useAuthQueryKey([...PLANS_QUERY_KEY]);
 
-  return useQuery({
+  return useQuery<SuccessResult<Plan>>({
     queryKey: [...plansKey, idPlan],
     queryFn: ({ signal }) =>
       apiFetch<SuccessResult<Plan>>(`/api/plans/${idPlan}`, { signal }),

package/src/modules/subscriptions/actions/get-current-subscription.action.ts

@@ -0,0 +1,8 @@
+'use server';
+
+import { safeServerAction } from '../../../utils/safeServerAction';
+import { subscriptionsService } from '../services/subscriptions.service';
+
+export async function getCurrentSubscriptionAction(params?: { id_product?: number }) {
+  return safeServerAction(() => subscriptionsService.getCurrentSubscription(params));
+}

package/src/modules/subscriptions/constants/subscription.constants.ts

@@ -6,3 +6,6 @@ export const FREEZE_WARNING_DAYS_BEFORE = 1;
 export const FREEZE_ELIGIBLE_WHITELABEL_ID = 1;
 
 export const MAX_PAYMENT_ATTEMPTS = 8;
+
+/** Plano legado "FREE" identificado por `id_plan`, fora do `type: 'free'` moderno. */
+export const FREE_PLAN_ID = 5;

package/src/modules/subscriptions/handlers/current-subscription.handler.ts

@@ -0,0 +1,16 @@
+import 'server-only';
+
+import type { NextRequest } from 'next/server';
+import { safeRouteHandler } from '../../../infra/route/safe-route-handler';
+import { searchParamsToParams } from '../../../infra/route/search-params';
+import { subscriptionsService } from '../services/subscriptions.service';
+
+export function createCurrentSubscriptionHandler() {
+  return async function GET(req: NextRequest) {
+    return safeRouteHandler(() =>
+      subscriptionsService.getCurrentSubscription(
+        searchParamsToParams<{ id_product?: number }>(req.nextUrl.searchParams),
+      ),
+    );
+  };
+}