@greatapps/common 1.1.790 → 1.1.792

package/src/modules/subscriptions/utils/is-boleto-payer.ts

@@ -0,0 +1,21 @@
+export const PAYMENT_METHOD_BOLETO = 2;
+
+/** A assinatura já é paga por boleto — só nesse caso o boleto aparece como opção. */
+export function isBoletoPayer(paymentMethod: number | null | undefined): boolean {
+  return paymentMethod === PAYMENT_METHOD_BOLETO;
+}
+
+type BoletoAvailabilityInput = {
+  isBoletoPayer: boolean;
+  allowedPaymentMethod: 'card' | 'boleto' | 'pix' | null;
+  unlocksAllPaymentMethods: boolean;
+};
+
+/** Boleto liberado: já é pagante por boleto, ou o cupom aplicado libera o método. */
+export function isBoletoAvailable({
+  isBoletoPayer: payerByBoleto,
+  allowedPaymentMethod,
+  unlocksAllPaymentMethods,
+}: BoletoAvailabilityInput): boolean {
+  return payerByBoleto || allowedPaymentMethod === 'boleto' || unlocksAllPaymentMethods;
+}

package/src/modules/subscriptions/utils/is-free-subscription.ts

@@ -0,0 +1,6 @@
+import type { Subscription } from '../types/subscription.type';
+import { FREE_PLAN_ID } from '../constants/subscription.constants';
+
+export function isFreeSubscription(subscription: Subscription | null | undefined): boolean {
+  return !!subscription && (subscription.type === 'free' || subscription.id_plan === FREE_PLAN_ID);
+}

package/src/modules/subscriptions/utils/periodicity.ts

@@ -1,5 +1,6 @@
 import type { BillingPeriod } from '../types/billing-period.type';
 import type { CalculateSubscriptionResponse } from '../types/calculate-subscription.type';
+import type { UiPlan } from '../../plans/types/plan.type';
 
 type TranslateFn = (key: any, values?: Record<string, string | number>) => string;
 
@@ -77,3 +78,103 @@ export function getOriginalPriceFromCalculatedData(
   if (period === 'semiannual') return data.semmester_original;
   return data.month_original;
 }
+
+/** Desconto do período (semestral/anual) a partir do cálculo da API. */
+export function getDiscount(
+  data: CalculateSubscriptionResponse | null,
+  period: BillingPeriod
+): number {
+  if (!data) return 0;
+  if (period === 'annual') return data.year_discount ?? 0;
+  if (period === 'semiannual') return data.semmester_discount ?? 0;
+  return 0;
+}
+
+/** Desconto de cupom a partir do cálculo da API. */
+export function getCouponDiscount(
+  data: CalculateSubscriptionResponse | null,
+  period: BillingPeriod
+): number {
+  if (!data) return 0;
+  if (period === 'annual') return data.year_discount_coupom ?? 0;
+  if (period === 'semiannual') return data.semmester_discount_coupom ?? 0;
+  return data.month_discount_coupom ?? 0;
+}
+
+/**
+ * Ponto ÚNICO de arredondamento do percentual exibido no badge "X% OFF", espelhando o backend.
+ * Clamp [0, 100]: cupom de valor fixo maior que a base reporta desconto acima do preço.
+ */
+export function roundDiscountPercent(value: number): number {
+  return Math.min(100, Math.max(0, Math.round(value)));
+}
+
+/**
+ * Percentual de desconto EFETIVO do período (periodicidade + cupom, já compostos pelo backend),
+ * derivado do calculate. Usa o `*_badge_percent` quando o backend manda; sem ele, deriva do preço
+ * final. `null` só quando não há dados — com dados, carrinho zerado é 0 mesmo.
+ */
+export function getEffectiveDiscountPercent(
+  data: CalculateSubscriptionResponse | null,
+  period: BillingPeriod
+): number | null {
+  if (!data) return null;
+
+  const declaredBadgePercent =
+    period === 'annual'
+      ? data.year_badge_percent
+      : period === 'semiannual'
+        ? data.semmester_badge_percent
+        : data.month_badge_percent;
+  if (declaredBadgePercent != null) return roundDiscountPercent(declaredBadgePercent);
+
+  const price = period === 'annual' ? data.year : period === 'semiannual' ? data.semmester : data.month;
+  const discount = getDiscount(data, period) + getCouponDiscount(data, period);
+  const base = price + discount;
+  if (base <= 0 || discount <= 0) return 0;
+
+  return roundDiscountPercent((discount / base) * 100);
+}
+
+/**
+ * Chave de pricing do período (contrato `pricing.{monthly,semester,annual}` do /plans). A âncora
+ * anual não deriva da mensal — cada período tem calibração própria.
+ */
+export function getPeriodPricingKey(
+  billingPeriod: BillingPeriod
+): 'monthly' | 'semester' | 'annual' {
+  if (billingPeriod === 'annual') return 'annual';
+  if (billingPeriod === 'semiannual') return 'semester';
+  return 'monthly';
+}
+
+/**
+ * Teto do badge anual em contas USD: o catálogo em dólar não expõe `discount_percent` por plano,
+ * então a vitrine anuncia o desconto máximo da tabela em vez de derivar plano a plano.
+ */
+export const USD_CATALOG_MAX_ANNUAL_DISCOUNT_PERCENT = 40;
+
+type BadgePercents = { monthly: number; annual: number };
+
+/** Percentuais de desconto declarados pelo /plans para um plano (null quando não vieram). */
+export function getPlanBadgePercents(
+  pricing: UiPlan['pricing'] | null | undefined
+): BadgePercents | null {
+  if (!pricing) return null;
+
+  return {
+    monthly: roundDiscountPercent(pricing.monthly.discount_percent),
+    annual: roundDiscountPercent(pricing.annual.discount_percent),
+  };
+}
+
+/** Maior desconto do catálogo por período — é o que o badge "até X% off" da vitrine anuncia. */
+export function getCatalogBadgePercents(plans: UiPlan[]): BadgePercents | null {
+  const percents = plans.flatMap((plan) => getPlanBadgePercents(plan.pricing) ?? []);
+  if (!percents.length) return null;
+
+  return {
+    monthly: Math.max(...percents.map((percent) => percent.monthly)),
+    annual: Math.max(...percents.map((percent) => percent.annual)),
+  };
+}

package/src/modules/subscriptions/utils/resolve-subscription-plan-name.ts

@@ -0,0 +1,44 @@
+import type { Subscription } from '../types/subscription.type';
+
+type TranslateFn = (key: any, values?: Record<string, string | number>) => string;
+
+/**
+ * Nome do plano para exibição. O nome vindo do backend está sempre em português, então a
+ * tradução sai do id (`common.plans.names.<id>`) e o valor do backend fica como fallback —
+ * plano sem chave (whitelabel, trial nomeado, plano novo) continua aparecendo com o nome que veio.
+ */
+export function resolveSubscriptionPlanName(
+  subscription: Pick<Subscription, 'id_plan' | 'plan_name'> | null | undefined,
+  translate: TranslateFn,
+  fallback = ''
+): string {
+  if (subscription?.id_plan != null) {
+    const key = `common.plans.names.${subscription.id_plan}`;
+    try {
+      const translated = translate(key);
+      if (translated && translated !== key) return translated;
+    } catch {
+      /* chave ausente: cai no nome do backend */
+    }
+  }
+  return subscription?.plan_name || fallback;
+}
+
+/** Mesmo mapeamento por id, para quando só se tem o plano (não a assinatura). */
+export function resolvePlanNameById(
+  idPlan: number | null | undefined,
+  backendName: string | null | undefined,
+  translate: TranslateFn,
+  fallback = ''
+): string {
+  if (idPlan != null) {
+    const key = `common.plans.names.${idPlan}`;
+    try {
+      const translated = translate(key);
+      if (translated && translated !== key) return translated;
+    } catch {
+      /* chave ausente: cai no nome do backend */
+    }
+  }
+  return backendName || fallback;
+}

package/src/modules/users/hooks/messages.hook.ts

@@ -2,6 +2,7 @@
 
 import { useInfiniteQuery, useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
 import { apiFetch } from '../../../infra/http/api-fetch';
+import { apiFetchPaged, nextPageParam } from '../../../infra/http/paged';
 import { markMessageAsReadAction } from '../action/mark-message-as-read.action';
 import { markAllMessagesAsReadAction } from '../action/mark-all-messages-as-read.action';
 import { withAction } from '../../../utils/withAction';
@@ -28,7 +29,7 @@ export function useInfiniteMessages(params?: Partial<Omit<FindMessagesParams, 'p
   return useInfiniteQuery({
     queryKey,
     queryFn: ({ pageParam, signal }) =>
-      apiFetch<ListMessagesResult>('/api/messages', {
+      apiFetchPaged<ListMessagesResult>('/api/messages', {
         params: {
           ...params,
           page: pageParam as number,
@@ -36,10 +37,7 @@ export function useInfiniteMessages(params?: Partial<Omit<FindMessagesParams, 'p
         },
         signal,
       }),
-    getNextPageParam: (lastPage, allPages) => {
-      const loaded = allPages.reduce((sum, p) => sum + p.data.length, 0);
-      return loaded < lastPage.total ? allPages.length + 1 : undefined;
-    },
+    getNextPageParam: nextPageParam,
     initialPageParam: 1,
   });
 }

package/src/server.ts

@@ -1,99 +1,102 @@
-import 'server-only';
-
-// API Client
-export { ApiClient, api, apiClient } from './infra/api/client';
-
-// Services
-export { authService } from './modules/auth/services/auth.service';
-export { whitelabelService } from './modules/whitelabel/services/whitelabel.service';
-export { revalidateWhitelabelAction } from './modules/whitelabel/actions/revalidate-whitelabel.action';
-export { assertManagementPermission } from './modules/auth/utils/assert-management-permission';
-export { assertManagementSubscription } from './modules/auth/utils/assert-management-subscription';
-export { assertSubscriptionAddon } from './modules/auth/utils/assert-subscription-addon';
-export { assertPaidSubscription } from './modules/auth/utils/assert-paid-subscription';
-export { assertAccountNotFrozen } from './modules/auth/utils/assert-account-not-frozen';
-export { subscriptionsService } from './modules/subscriptions/services/subscriptions.service';
-export { plansService } from './modules/plans/services/plans.service';
-export { cardsService } from './modules/cards/services/cards.service';
-export { chargesService } from './modules/charges/services/charges.service';
-export { iaCreditsService } from './modules/ia-credits/services/ia-credits.service';
-
-// Actions
-export { findWhitelabel } from './modules/whitelabel/actions/find-whitelabel.action';
-export { validateSessionAction } from './modules/auth/actions/validate-session.action';
-export { socialGoogleLoginAction } from './modules/auth/actions/social-google-login.action';
-export { socialGoogleOnboardingAction } from './modules/auth/actions/social-google-onboarding.action';
-export { unlinkGoogleAction } from './modules/auth/actions/unlink-google.action';
-export { findUserById } from './modules/users/action/find-user-by-id.action';
-export { findCurrentAccount } from './modules/accounts/actions/find-current-account.action';
-export { getAccountTokenAction } from './modules/accounts/actions/get-account-token.action';
-export { listSubscriptionsAction } from './modules/subscriptions/actions/list-subscriptions.action';
-export { getCurrentSubscriptionAction } from './modules/subscriptions/actions/get-current-subscription.action';
-export { readCurrentSubscription } from './modules/subscriptions/utils/read-current-subscription';
-export { ackFreezeNoticeAction } from './modules/subscriptions/actions/ack-freeze-notice.action';
-export { calculateSubscriptionAction } from './modules/subscriptions/actions/calculate-subscription.action';
-export { updateSubscriptionPlanAction } from './modules/subscriptions/actions/update-subscription-plan.action';
-export { updateSubscriptionPaymentAction } from './modules/subscriptions/actions/update-subscription-payment.action';
-export { createCardAction } from './modules/cards/actions/create-card.action';
-export { createSetupIntentAction } from './modules/cards/actions/create-setup-intent.action';
-export { chargeActionAction } from './modules/charges/actions/charge-action.action';
-export { resolvePlanExtrasPrices } from './modules/subscriptions/utils/resolve-plan-extras-prices';
-export { hasSubscriptionExpired } from './modules/subscriptions/utils/has-subscription-expired';
-export { hasActivePaidSubscription } from './modules/subscriptions/utils/has-active-paid-subscription';
-
-// Project Services & Actions (server-only)
-export { projectsService } from './modules/projects/services/projects.service';
-export { listProjectsAction } from './modules/projects/actions/list-projects.action';
-export { findProjectAction } from './modules/projects/actions/find-project.action';
-export { createProjectAction } from './modules/projects/actions/create-project.action';
-export { updateProjectAction } from './modules/projects/actions/update-project.action';
-export { deleteProjectAction } from './modules/projects/actions/delete-project.action';
-
-// Project Users Services & Actions (server-only)
-export { projectUsersService } from './modules/projects/services/project-users.service';
-export { listProjectUsersAction } from './modules/projects/actions/list-project-users.action';
-export { addProjectUserAction } from './modules/projects/actions/add-project-user.action';
-export { removeProjectUserAction } from './modules/projects/actions/remove-project-user.action';
-
-// Account Services & Actions (server-only)
-export { accountService } from './modules/accounts/services/account.service';
-export { twoFactorService } from './modules/accounts/services/two-factor.service';
-export {
-  listAccountUsersAction,
-  updateUserAction,
-  updateAccountAction,
-  updateAccountUserByIdAction,
-  updateBillingDataAction,
-  deleteAccountUserAction,
-  deleteAccountAction,
-  createAccountUserAction,
-  changePasswordAction,
-  requestEmailChangeAction,
-  confirmEmailChangeAction,
-  requestPhoneChangeAction,
-  confirmPhoneChangeAction,
-  generateTwoFactorAction,
-  confirmTwoFactorAction,
-  disableTwoFactorAction,
-} from './modules/accounts/actions/account-management.action';
-
-// Server Utils
-export { getClientInfoFromRequest } from './infra/utils/client-info';
-export { getUserContext } from './modules/auth/utils/get-user-context';
-export { resolveLocale } from './i18n/resolve-locale';
-export type { ResolveLocaleOptions } from './i18n/resolve-locale';
-export { requireValidSession } from './modules/auth/utils/require-valid-session';
-export { requireTokenNotExpired } from './modules/auth/utils/require-token-not-expired';
-export { buildWlOverride, buildWlOverrideFromJwt } from './modules/auth/utils/build-wl-override';
-export { safeServerAction } from './utils/safeServerAction';
-export { safeMutationAction } from './utils/safeMutationAction';
-
-// Image Processing (server-side)
-export { processImageAction } from './modules/images/actions/process-image.action';
-export { processImage } from './modules/images/services/image-processing.service';
-export type {
-  ProcessImageInput,
-  ProcessImageOutput,
-  ProcessImageActionInput,
-  ProcessImageActionOutput,
-} from './modules/images/types/image.type';
+import 'server-only';
+
+// API Client
+export { ApiClient, api, apiClient } from './infra/api/client';
+
+// Services
+export { authService } from './modules/auth/services/auth.service';
+export { whitelabelService } from './modules/whitelabel/services/whitelabel.service';
+export { revalidateWhitelabelAction } from './modules/whitelabel/actions/revalidate-whitelabel.action';
+export { assertManagementPermission } from './modules/auth/utils/assert-management-permission';
+export { assertManagementSubscription } from './modules/auth/utils/assert-management-subscription';
+export { assertSubscriptionAddon } from './modules/auth/utils/assert-subscription-addon';
+export { assertPaidSubscription } from './modules/auth/utils/assert-paid-subscription';
+export { assertAccountNotFrozen } from './modules/auth/utils/assert-account-not-frozen';
+export { subscriptionsService } from './modules/subscriptions/services/subscriptions.service';
+export { plansService } from './modules/plans/services/plans.service';
+export { cardsService } from './modules/cards/services/cards.service';
+export { chargesService } from './modules/charges/services/charges.service';
+export { iaCreditsService } from './modules/ia-credits/services/ia-credits.service';
+
+// Actions
+export { findWhitelabel } from './modules/whitelabel/actions/find-whitelabel.action';
+export { validateSessionAction } from './modules/auth/actions/validate-session.action';
+export { socialGoogleLoginAction } from './modules/auth/actions/social-google-login.action';
+export { socialGoogleOnboardingAction } from './modules/auth/actions/social-google-onboarding.action';
+export { unlinkGoogleAction } from './modules/auth/actions/unlink-google.action';
+export { findUserById } from './modules/users/action/find-user-by-id.action';
+export { findCurrentAccount } from './modules/accounts/actions/find-current-account.action';
+export { getAccountTokenAction } from './modules/accounts/actions/get-account-token.action';
+export { listSubscriptionsAction } from './modules/subscriptions/actions/list-subscriptions.action';
+export { getCurrentSubscriptionAction } from './modules/subscriptions/actions/get-current-subscription.action';
+export { readCurrentSubscription } from './modules/subscriptions/utils/read-current-subscription';
+export { ackFreezeNoticeAction } from './modules/subscriptions/actions/ack-freeze-notice.action';
+export { calculateSubscriptionAction } from './modules/subscriptions/actions/calculate-subscription.action';
+export { updateSubscriptionPlanAction } from './modules/subscriptions/actions/update-subscription-plan.action';
+export { updateSubscriptionPaymentAction } from './modules/subscriptions/actions/update-subscription-payment.action';
+export { createCardAction } from './modules/cards/actions/create-card.action';
+export { createSetupIntentAction } from './modules/cards/actions/create-setup-intent.action';
+export { chargeActionAction } from './modules/charges/actions/charge-action.action';
+export { resolvePlanExtrasPrices } from './modules/subscriptions/utils/resolve-plan-extras-prices';
+export { hasSubscriptionExpired } from './modules/subscriptions/utils/has-subscription-expired';
+export { hasActivePaidSubscription } from './modules/subscriptions/utils/has-active-paid-subscription';
+
+// Project Services & Actions (server-only)
+export { projectsService } from './modules/projects/services/projects.service';
+export { listProjectsAction } from './modules/projects/actions/list-projects.action';
+export { findProjectAction } from './modules/projects/actions/find-project.action';
+export { createProjectAction } from './modules/projects/actions/create-project.action';
+export { updateProjectAction } from './modules/projects/actions/update-project.action';
+export { deleteProjectAction } from './modules/projects/actions/delete-project.action';
+
+// Project Users Services & Actions (server-only)
+export { projectUsersService } from './modules/projects/services/project-users.service';
+export { listProjectUsersAction } from './modules/projects/actions/list-project-users.action';
+export { addProjectUserAction } from './modules/projects/actions/add-project-user.action';
+export { removeProjectUserAction } from './modules/projects/actions/remove-project-user.action';
+
+// Account Services & Actions (server-only)
+export { accountService } from './modules/accounts/services/account.service';
+export { twoFactorService } from './modules/accounts/services/two-factor.service';
+export {
+  listAccountUsersAction,
+  updateUserAction,
+  updateAccountAction,
+  updateAccountUserByIdAction,
+  updateBillingDataAction,
+  deleteAccountUserAction,
+  deleteAccountAction,
+  createAccountUserAction,
+  checkUserExistsAction,
+  addUserProjectsAction,
+  removeUserProjectsAction,
+  changePasswordAction,
+  requestEmailChangeAction,
+  confirmEmailChangeAction,
+  requestPhoneChangeAction,
+  confirmPhoneChangeAction,
+  generateTwoFactorAction,
+  confirmTwoFactorAction,
+  disableTwoFactorAction,
+} from './modules/accounts/actions/account-management.action';
+
+// Server Utils
+export { getClientInfoFromRequest } from './infra/utils/client-info';
+export { getUserContext } from './modules/auth/utils/get-user-context';
+export { resolveLocale } from './i18n/resolve-locale';
+export type { ResolveLocaleOptions } from './i18n/resolve-locale';
+export { requireValidSession } from './modules/auth/utils/require-valid-session';
+export { requireTokenNotExpired } from './modules/auth/utils/require-token-not-expired';
+export { buildWlOverride, buildWlOverrideFromJwt } from './modules/auth/utils/build-wl-override';
+export { safeServerAction } from './utils/safeServerAction';
+export { safeMutationAction } from './utils/safeMutationAction';
+
+// Image Processing (server-side)
+export { processImageAction } from './modules/images/actions/process-image.action';
+export { processImage } from './modules/images/services/image-processing.service';
+export type {
+  ProcessImageInput,
+  ProcessImageOutput,
+  ProcessImageActionInput,
+  ProcessImageActionOutput,
+} from './modules/images/types/image.type';

package/src/store/useAccountModals.ts

@@ -1,18 +1,24 @@
 'use client';
 
 import { create } from 'zustand';
-import type { AccountSectionType } from '../enums/AccountSectionType';
+import { AccountSectionType } from '../enums/AccountSectionType';
+import type { WorkspaceSectionType } from '../enums/WorkspaceSectionType';
+import type { WorkspaceActions } from '../components/account/types/workspace-actions.type';
 
 type AccountModalType =
-  | 'configurations'
+  | 'account'
   | 'deleteAccount'
   | 'isntPossibleDelete'
   | 'confirmDelete';
 
 export interface AccountModalsConfig {
   onGoToSubscription?: () => void;
+  workspaceActions?: WorkspaceActions;
 }
 
+/** Aba do modal Minha conta: seções da conta (preferências, token, segurança) ou do workspace. */
+export type MyAccountSection = AccountSectionType | WorkspaceSectionType;
+
 interface DeleteAccountPayload {
   password: string;
 }
@@ -20,7 +26,7 @@ interface DeleteAccountPayload {
 interface AccountModalsState {
   activeModal: AccountModalType | null;
   config: AccountModalsConfig;
-  initialSection?: AccountSectionType;
+  initialSection?: MyAccountSection;
 
   /** Payload coletado no DeleteAccountModal, consumido pelo ConfirmDeleteAccountModal. */
   deleteAccountPayload: DeleteAccountPayload | null;
@@ -31,7 +37,10 @@ interface AccountModalsState {
   /** Called by <AccountModals> to keep app-level config in sync */
   updateConfig: (config: AccountModalsConfig) => void;
 
+  /** Abre o modal Minha conta numa seção da conta (padrão: Preferências). */
   openConfigurations: (initialSection?: AccountSectionType) => void;
+  /** Abre o modal Minha conta numa seção do workspace (padrão: primeira aba visível). */
+  openWorkspace: (section?: WorkspaceSectionType) => void;
   openDeleteAccount: (error?: string) => void;
   openIsntPossibleDelete: () => void;
   openConfirmDelete: (payload: DeleteAccountPayload) => void;
@@ -48,14 +57,22 @@ export const useAccountModals = create<AccountModalsState>((set) => ({
 
   updateConfig: (config) => set({ config }),
 
-  openConfigurations: (initialSection) =>
+  openConfigurations: (initialSection = AccountSectionType.PREFERENCES) =>
     set({
-      activeModal: 'configurations',
+      activeModal: 'account',
       initialSection,
       deleteAccountPayload: null,
       deleteAccountError: null,
     }),
 
+  openWorkspace: (section) =>
+    set({
+      activeModal: 'account',
+      initialSection: section,
+      deleteAccountPayload: null,
+      deleteAccountError: null,
+    }),
+
   openDeleteAccount: (error) =>
     set({
       activeModal: 'deleteAccount',

package/src/store/useAccountUnsavedChanges.ts

@@ -0,0 +1,52 @@
+'use client';
+
+import { create } from 'zustand';
+
+interface DirtyAccountForm {
+  submit: () => void;
+  discard: () => void;
+}
+
+interface AccountUnsavedChangesState {
+  dirtyForm: DirtyAccountForm | null;
+  pendingAction: (() => void) | null;
+
+  setDirtyForm: (form: DirtyAccountForm | null) => void;
+  guard: (action: () => void) => void;
+  save: () => void;
+  completeSave: () => void;
+  discard: () => void;
+  dismiss: () => void;
+}
+
+export const useAccountUnsavedChanges = create<AccountUnsavedChangesState>((set, get) => ({
+  dirtyForm: null,
+  pendingAction: null,
+
+  setDirtyForm: (dirtyForm) => set({ dirtyForm }),
+
+  guard: (action) => {
+    if (get().dirtyForm) {
+      set({ pendingAction: action });
+      return;
+    }
+    action();
+  },
+
+  save: () => get().dirtyForm?.submit(),
+
+  completeSave: () => {
+    const { pendingAction } = get();
+    set({ pendingAction: null });
+    pendingAction?.();
+  },
+
+  discard: () => {
+    const { dirtyForm, pendingAction } = get();
+    dirtyForm?.discard();
+    set({ dirtyForm: null, pendingAction: null });
+    pendingAction?.();
+  },
+
+  dismiss: () => set({ pendingAction: null }),
+}));

package/src/store/useAffiliateFlows.ts

@@ -0,0 +1,46 @@
+'use client';
+
+import { create } from 'zustand';
+
+interface AffiliateFlowsState {
+  isWithdrawalOpen: boolean;
+  isReceivingAccountOpen: boolean;
+  isMissingReceivingAccountOpen: boolean;
+  isLeadsOpen: boolean;
+  /** Caminho do anexo (nota fiscal) aberto no visualizador. */
+  attachment: string | null;
+
+  openWithdrawal: () => void;
+  closeWithdrawal: () => void;
+  openReceivingAccount: () => void;
+  closeReceivingAccount: () => void;
+  openMissingReceivingAccount: () => void;
+  closeMissingReceivingAccount: () => void;
+  openLeads: () => void;
+  closeLeads: () => void;
+  openAttachment: (attachment: string) => void;
+  closeAttachment: () => void;
+}
+
+/**
+ * Fluxos da aba Afiliados do modal Minha conta (saque, conta de recebimento, leads e anexo).
+ * Ficam em store porque quem dispara são a lista e o cabeçalho, e quem renderiza é `AffiliateFlows`.
+ */
+export const useAffiliateFlows = create<AffiliateFlowsState>((set) => ({
+  isWithdrawalOpen: false,
+  isReceivingAccountOpen: false,
+  isMissingReceivingAccountOpen: false,
+  isLeadsOpen: false,
+  attachment: null,
+
+  openWithdrawal: () => set({ isWithdrawalOpen: true }),
+  closeWithdrawal: () => set({ isWithdrawalOpen: false }),
+  openReceivingAccount: () => set({ isReceivingAccountOpen: true }),
+  closeReceivingAccount: () => set({ isReceivingAccountOpen: false }),
+  openMissingReceivingAccount: () => set({ isMissingReceivingAccountOpen: true }),
+  closeMissingReceivingAccount: () => set({ isMissingReceivingAccountOpen: false }),
+  openLeads: () => set({ isLeadsOpen: true }),
+  closeLeads: () => set({ isLeadsOpen: false }),
+  openAttachment: (attachment) => set({ attachment }),
+  closeAttachment: () => set({ attachment: null }),
+}));

package/src/store/useProjectFlows.ts

@@ -0,0 +1,42 @@
+'use client';
+
+import { create } from 'zustand';
+import type { Project } from '../modules/projects/types';
+
+/** Sheet de projeto: criação, ou detalhes/edição de um projeto já existente. */
+export type ProjectSheetState = { mode: 'create' } | { mode: 'details'; project: Project } | null;
+
+interface ProjectFlowsState {
+  sheet: ProjectSheetState;
+  projectToDelete: Project | null;
+  isProjectsDisabledOpen: boolean;
+
+  openCreateProject: () => void;
+  openProjectDetails: (project: Project) => void;
+  closeProjectSheet: () => void;
+  openDeleteProject: (project: Project) => void;
+  closeDeleteProject: () => void;
+  openProjectsDisabled: () => void;
+  closeProjectsDisabled: () => void;
+}
+
+/**
+ * Fluxos da aba Projetos do modal Minha conta (sheet de projeto, exclusão e aviso de plano sem
+ * gestão de projetos). Ficam em store porque quem dispara é a lista e quem renderiza é
+ * `ProjectFlows`, montado uma única vez na seção.
+ */
+export const useProjectFlows = create<ProjectFlowsState>((set) => ({
+  sheet: null,
+  projectToDelete: null,
+  isProjectsDisabledOpen: false,
+
+  openCreateProject: () => set({ sheet: { mode: 'create' } }),
+  openProjectDetails: (project) => set({ sheet: { mode: 'details', project } }),
+  closeProjectSheet: () => set({ sheet: null }),
+
+  openDeleteProject: (project) => set({ projectToDelete: project }),
+  closeDeleteProject: () => set({ projectToDelete: null }),
+
+  openProjectsDisabled: () => set({ isProjectsDisabledOpen: true }),
+  closeProjectsDisabled: () => set({ isProjectsDisabledOpen: false }),
+}));