@greatapps/common 1.1.789 → 1.1.791

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

@@ -36,3 +36,53 @@ export function buildAiCreditOptions(planItems: AiCreditPlanItem[]): AiCreditOpt
 }
 
 export const AI_CREDIT_VALUES: ReadonlySet<number> = new Set(AI_CREDIT_SIZES);
+
+export const ESSENTIAL_PLAN_ID = 1;
+export const STARTER_PLAN_ID = 415;
+const AGENCY_PLAN_ID = 3;
+const API_PLAN_ID = 411;
+const REDUCED_DOMAIN_PRICE = 9.9;
+const DEFAULT_DOMAIN_EXTRA_PRICE = 14.9;
+
+const PLANS_WITHOUT_EXTRA_DOMAINS: ReadonlySet<number> = new Set([ESSENTIAL_PLAN_ID, STARTER_PLAN_ID]);
+
+/** Planos Essencial e Iniciante não contratam domínios extras. */
+export function canBuyExtraDomains(planId: number | undefined): boolean {
+  return planId !== undefined && !PLANS_WITHOUT_EXTRA_DOMAINS.has(planId);
+}
+
+/** Preço unitário do domínio extra: Agência e API pagam menos que os demais planos. */
+export function getDomainExtraPrice(planId: number | undefined): number {
+  if (planId === AGENCY_PLAN_ID || planId === API_PLAN_ID) return REDUCED_DOMAIN_PRICE;
+  return DEFAULT_DOMAIN_EXTRA_PRICE;
+}
+
+// `key: any`: os apps tipam `useTranslations()` contra o catálogo deles, e uma chave literal
+// mais estreita não é atribuível a `string` (contravariância) — mesmo padrão dos demais helpers.
+type TranslateFn = (key: any, values?: Record<string, string | number>) => string;
+
+export type AddonDefinition = {
+  id: number;
+  name: string;
+  shortName?: string;
+  description?: string;
+  detailsUrl?: string;
+};
+
+/** Rótulos dos adicionais, já traduzidos. */
+export function getAddonLabels(translate: TranslateFn): Record<number, AddonDefinition> {
+  return {
+    [ADDON_IDS.DOMAINS]: { id: ADDON_IDS.DOMAINS, name: translate('common.addons.domains') },
+    [ADDON_IDS.PAGES]: { id: ADDON_IDS.PAGES, name: translate('common.addons.pages') },
+    [ADDON_IDS.PROJECTS]: { id: ADDON_IDS.PROJECTS, name: translate('common.addons.projects') },
+    [ADDON_IDS.AB_TEST]: {
+      id: ADDON_IDS.AB_TEST,
+      name: translate('common.addons.abTestName'),
+      shortName: translate('common.addons.abTestShortName'),
+      description: translate('common.addons.abTestDescription'),
+      detailsUrl: 'https://www.greatpages.com.br/teste-ab',
+    },
+    [ADDON_IDS.HEATMAP]: { id: ADDON_IDS.HEATMAP, name: translate('common.addons.heatmap') },
+    [ADDON_IDS.AI]: { id: ADDON_IDS.AI, name: translate('common.addons.aiCredits') },
+  };
+}

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

@@ -0,0 +1,30 @@
+/** Motivo aberto: exige o texto livre antes de continuar. */
+export const DOWNGRADE_REASON_OTHER = 'outro';
+
+/** Motivos oferecidos no downgrade — o rótulo sai do i18n pela própria chave. */
+export const DOWNGRADE_REASONS = [
+  'problemas-tecnicos',
+  'preco',
+  'pouco-uso',
+  'falta-recursos',
+  DOWNGRADE_REASON_OTHER,
+] as const;
+
+export type DowngradeReason = (typeof DOWNGRADE_REASONS)[number];
+
+// `key: any`: os apps tipam `useTranslations()` contra o catálogo deles e a chave dinâmica não é
+// atribuível ao literal esperado — mesmo padrão dos demais helpers que recebem o translate.
+type TranslateFn = (key: any, values?: Record<string, string | number>) => string;
+
+/** Rótulos dos motivos, já traduzidos, na ordem em que aparecem. */
+export function getDowngradeReasonLabels(translate: TranslateFn): Record<DowngradeReason, string> {
+  return DOWNGRADE_REASONS.reduce(
+    (labels, reason) => ({
+      ...labels,
+      [reason]: translate(
+        `common.account.workspace.subscription.changePlan.downgradeReasons.${reason}`
+      ),
+    }),
+    {} as Record<DowngradeReason, string>
+  );
+}

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

@@ -9,3 +9,6 @@ export const MAX_PAYMENT_ATTEMPTS = 8;
 
 /** Plano legado "FREE" identificado por `id_plan`, fora do `type: 'free'` moderno. */
 export const FREE_PLAN_ID = 5;
+
+/** Plano de acesso à API: sem créditos de IA. */
+export const API_PLAN_ID = 411;

package/src/modules/subscriptions/handlers/pending-pix-status.handler.ts

@@ -0,0 +1,17 @@
+import 'server-only';
+
+import type { NextRequest } from 'next/server';
+import { safeRouteHandler } from '../../../infra/route/safe-route-handler';
+import { subscriptionsService } from '../services/subscriptions.service';
+
+export function createPendingPixStatusHandler() {
+  return async function GET(
+    _req: NextRequest,
+    { params }: { params: Promise<{ correlationId: string }> }
+  ) {
+    return safeRouteHandler(async () => {
+      const { correlationId } = await params;
+      return subscriptionsService.findPendingPixStatus(correlationId);
+    });
+  };
+}

package/src/modules/subscriptions/hooks/cancel-subscription.hook.ts

@@ -0,0 +1,28 @@
+'use client';
+
+import { useMutation, useQueryClient } from '@tanstack/react-query';
+import { withAction } from '../../../utils/withAction';
+import { useAuthQueryKey } from '../../../hooks/useAuthQueryKey';
+import { cancelSubscriptionAction } from '../actions/cancel-subscription.action';
+import { SUBSCRIPTIONS_QUERY_KEY, CHARGES_QUERY_KEY } from '../constants/query-keys.constants';
+import type { CancelSubscriptionRequest } from '../types/cancel-subscription.type';
+
+export function useCancelSubscription() {
+  const queryClient = useQueryClient();
+  const subscriptionsKey = useAuthQueryKey([...SUBSCRIPTIONS_QUERY_KEY]);
+  const chargesKey = useAuthQueryKey([...CHARGES_QUERY_KEY]);
+
+  return useMutation({
+    mutationFn: ({
+      subscriptionId,
+      data,
+    }: {
+      subscriptionId: number | string;
+      data: CancelSubscriptionRequest;
+    }) => withAction(cancelSubscriptionAction)(subscriptionId, data),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: subscriptionsKey });
+      queryClient.invalidateQueries({ queryKey: chargesKey });
+    },
+  });
+}

package/src/modules/subscriptions/hooks/create-subscription.hook.ts

@@ -0,0 +1,34 @@
+'use client';
+
+import { useMutation, useQueryClient } from '@tanstack/react-query';
+import { useStripe } from '@stripe/react-stripe-js';
+import { useTranslations } from 'next-intl';
+import { withAction } from '../../../utils/withAction';
+import { useAuthQueryKey } from '../../../hooks/useAuthQueryKey';
+import { createSubscriptionAction } from '../actions/create-subscription.action';
+import { SUBSCRIPTIONS_QUERY_KEY, CHARGES_QUERY_KEY } from '../constants/query-keys.constants';
+import { confirmPaymentIfRequired } from '../utils/confirm-payment-if-required';
+import type { CreateSubscriptionRequest } from '../types/create-subscription.type';
+
+export function useCreateSubscription() {
+  const queryClient = useQueryClient();
+  const stripe = useStripe();
+  const translate = useTranslations();
+  const subscriptionsKey = useAuthQueryKey([...SUBSCRIPTIONS_QUERY_KEY]);
+  const chargesKey = useAuthQueryKey([...CHARGES_QUERY_KEY]);
+  const iaCreditsKey = useAuthQueryKey(['ia-credits']);
+
+  return useMutation({
+    mutationFn: async (data: CreateSubscriptionRequest) => {
+      const result = await withAction(createSubscriptionAction)(data);
+      // Cobrança que exige 3DS volta com client_secret e só completa depois do desafio.
+      await confirmPaymentIfRequired(stripe, result, translate('common.payment.authFailed'));
+      return result;
+    },
+    onSettled: () => {
+      queryClient.invalidateQueries({ queryKey: subscriptionsKey });
+      queryClient.invalidateQueries({ queryKey: chargesKey });
+      queryClient.invalidateQueries({ queryKey: iaCreditsKey });
+    },
+  });
+}

package/src/modules/subscriptions/hooks/find-subscription-by-id.hook.ts

@@ -0,0 +1,17 @@
+'use client';
+
+import { useQuery } from '@tanstack/react-query';
+import { withAction } from '../../../utils/withAction';
+import { useAuthQueryKey } from '../../../hooks/useAuthQueryKey';
+import { findSubscriptionByIdAction } from '../actions/find-subscription-by-id.action';
+import { SUBSCRIPTIONS_QUERY_KEY } from '../constants/query-keys.constants';
+
+export function useSubscriptionById(subscriptionId: string | number | undefined) {
+  const queryKey = useAuthQueryKey([...SUBSCRIPTIONS_QUERY_KEY, 'by-id', subscriptionId]);
+
+  return useQuery({
+    queryKey,
+    queryFn: () => withAction(findSubscriptionByIdAction)(subscriptionId!),
+    enabled: subscriptionId != null && subscriptionId !== '',
+  });
+}

package/src/modules/subscriptions/hooks/pending-pix-status.hook.ts

@@ -0,0 +1,30 @@
+'use client';
+
+import { useQuery } from '@tanstack/react-query';
+import { apiFetch } from '../../../infra/http/api-fetch';
+import { useAuthQueryKey } from '../../../hooks/useAuthQueryKey';
+import type { SuccessResult } from '../../../infra/api/types';
+import type { PendingPixStatusData } from '../types/pending-pix-status.type';
+
+const TERMINAL_PHASES = ['completed', 'rejected', 'expired'];
+
+const isTerminal = (phase?: string) => !!phase && TERMINAL_PHASES.includes(phase);
+
+/** Status do pix pendente, em polling de 15s até chegar numa fase terminal. */
+export function usePendingPixStatus(correlationId?: string | null) {
+  const queryKey = useAuthQueryKey(['pending-pix-status', correlationId]);
+
+  return useQuery({
+    queryKey,
+    queryFn: ({ signal }) =>
+      apiFetch<SuccessResult<PendingPixStatusData>>(
+        `/api/subscriptions/pending-pix/${correlationId}`,
+        { signal }
+      ),
+    enabled: Boolean(correlationId),
+    refetchInterval: (query) => (isTerminal(query.state.data?.data?.phase) ? false : 15_000),
+    refetchOnWindowFocus: (query) => !isTerminal(query.state.data?.data?.phase),
+    refetchOnReconnect: (query) => !isTerminal(query.state.data?.data?.phase),
+    refetchOnMount: (query) => (isTerminal(query.state.data?.data?.phase) ? false : 'always'),
+  });
+}