@greatapps/common 1.1.700 → 1.1.701

package/src/modules/plans/utils/map-api-plan-to-ui.ts

@@ -1,167 +1,167 @@
-import type {
-  Plan,
-  PlanFeature,
-  PlanMainFeatures,
-  PlanPricingByPeriod,
-  UiPlan,
-} from "../types/plan.type";
-import { ADDON_IDS } from "../../subscriptions/constants/addons.constants";
-import {
-  formatCurrencyNumber,
-  type CurrencyCode,
-} from "../../../utils/format/currency";
-
-export type PlanBillingPeriod = "monthly" | "semiannual" | "annual";
-
-type TranslateFn = (key: any, values?: Record<string, string | number>) => string;
-
-const BASE_FEATURES_KEYS = [
-  { icon: "check", key: "plans.features.unlimitedVisits",  fallback: "Visitas ilimitadas" },
-  { icon: "check", key: "plans.features.unlimitedLeads",   fallback: "Leads ilimitadas" },
-  { icon: "check", key: "plans.features.sharePages",        fallback: "Compartilhar páginas", tooltip: "sharePages" },
-  { icon: "check", key: "plans.features.hosting",           fallback: "Hospedagem inclusa" },
-  // SSL (HTTPS) + CDN — brand/acronym: never translated
-  { icon: "check", key: null,                               fallback: "SSL (HTTPS) + CDN" },
-  { icon: "check", key: "plans.features.freeTemplates",     fallback: "Templates gratuitos" },
-] as const;
-
-function buildBaseFeatures(translate?: TranslateFn): PlanFeature[] {
-  return BASE_FEATURES_KEYS.map(({ icon, key, fallback, ...rest }) => {
-    const text = key && translate ? translate(`common.${key}`) : fallback;
-    const feature: PlanFeature = { icon, text };
-    if ("tooltip" in rest && rest.tooltip) feature.tooltip = rest.tooltip;
-    return feature;
-  });
-}
-
-function buildMainFeaturesFromItems(
-  items: Plan["items"],
-  translate?: TranslateFn
-): PlanMainFeatures {
-  const pagesItem = items.find((i) => i.id_addon === ADDON_IDS.PAGES);
-  const domainsItem = items.find((i) => i.id_addon === ADDON_IDS.DOMAINS);
-
-  const pagesQty = pagesItem?.quantity ?? 0;
-  const domainsQty = domainsItem?.quantity ?? 1;
-
-  let pages: string;
-  if (pagesQty === 0) {
-    pages = translate
-      ? translate("common.plans.mainFeatures.pagesUnlimited")
-      : "Páginas ilimitadas";
-  } else if (pagesQty === 1) {
-    pages = translate
-      ? translate("common.plans.mainFeatures.pageSingular")
-      : "1 página";
-  } else {
-    pages = translate
-      ? translate("common.plans.mainFeatures.pagesPlural", { count: pagesQty })
-      : `${pagesQty} páginas`;
-  }
-
-  let domains: string;
-  if (domainsQty >= 999) {
-    domains = translate
-      ? translate("common.plans.mainFeatures.domainsUnlimited")
-      : "Domínios ilimitados";
-  } else if (domainsQty === 1) {
-    domains = translate
-      ? translate("common.plans.mainFeatures.domainSingular")
-      : "1 domínio externo";
-  } else {
-    domains = translate
-      ? translate("common.plans.mainFeatures.domainsPlural", { count: domainsQty })
-      : `${domainsQty} domínios externos`;
-  }
-
-  const users = translate
-    ? translate("common.plans.mainFeatures.usersUnlimited")
-    : "Usuários ilimitados";
-
-  return { pages, domains, users };
-}
-
-function computePricingByPeriod(apiPlan: Plan, currency: CurrencyCode): PlanPricingByPeriod {
-  // Backend agora resolve value por moeda da conta; mapper apenas lê.
-  // value pode ser null (ex.: conta USD, preço USD não cadastrado).
-  const monthly = apiPlan.value;
-  if (monthly == null) {
-    return { monthly: 0, semiannual: 0, annual: 0 };
-  }
-  const round2 = (n: number) => Math.round(n * 100) / 100;
-  return {
-    monthly,
-    semiannual: round2(monthly * (1 - apiPlan.discount_semester / 100)),
-    annual: round2(monthly * (1 - apiPlan.discount_annual / 100)),
-  };
-}
-
-function buildUiPlan(plan: Plan, currency: CurrencyCode, translate?: TranslateFn): UiPlan {
-  const popular = plan.id === 2 || plan.id_plan === 2;
-  const buttonVariant = popular ? "brand" : "default";
-
-  const pricingByPeriod = computePricingByPeriod(plan, currency);
-  const monthlyFinal = pricingByPeriod.monthly;
-
-  const lowerName = plan.name.toLowerCase();
-  const hasProjectAndOnboarding =
-    lowerName.includes("agência") || lowerName.includes("agencia");
-
-  const onboardingText = translate
-    ? translate("common.plans.features.onboarding")
-    : "Reunião de Onboarding";
-  const projectMgmtText = translate
-    ? translate("common.plans.features.projectManagement")
-    : "Gestão de projetos";
-
-  const features: PlanFeature[] = [
-    ...buildBaseFeatures(translate),
-    hasProjectAndOnboarding
-      ? { icon: "check", text: onboardingText }
-      : { icon: "x", text: onboardingText, disabled: true },
-    hasProjectAndOnboarding
-      ? { icon: "check", text: projectMgmtText, tooltip: "projectManagement" }
-      : { icon: "x",     text: projectMgmtText, disabled: true, tooltip: "projectManagement" },
-  ];
-
-  const currencyAwareItems = plan.items.map((item) => ({
-    ...item,
-    value: item.value ?? 0,
-  }));
-
-  const priceUnavailable = plan.value == null;
-  const unavailableLabel = translate ? translate("common.plans.usdNotConfigured") : "USD não configurado";
-
-  return {
-    planId: plan.id,
-    name: plan.name,
-    isPopular: popular,
-    buttonVariant,
-    mainFeatures: buildMainFeaturesFromItems(plan.items, translate),
-    features,
-    originalPrice: priceUnavailable ? unavailableLabel : formatCurrencyNumber(monthlyFinal, 2, currency),
-    price: priceUnavailable ? unavailableLabel : formatCurrencyNumber(monthlyFinal, 2, currency),
-    pricingByPeriod,
-    priceUnavailable,
-    items: currencyAwareItems,
-  };
-}
-
-/**
- * Mapeia um plano da API para UiPlan em BRL.
- * Assinatura de 1 argumento — seguro em `plans.map(mapApiPlanToUiPlan)`.
- * Passa `translate` opcional para i18n; sem ele cai nos literais pt-br (back-compat).
- */
-export function mapApiPlanToUiPlan(plan: Plan, translate?: TranslateFn): UiPlan {
-  return buildUiPlan(plan, "brl", translate);
-}
-
-/**
- * Variante currency-aware: a moeda vem do gateway da conta (getCurrencyForGateway).
- * Fábrica para uso ergonômico em `.map`: `plans.map(mapApiPlanToUiPlanForCurrency(currency, translate))`.
- * Mantida separada de mapApiPlanToUiPlan para não quebrar callers que passam a fn direto pro `.map`.
- */
-export const mapApiPlanToUiPlanForCurrency =
-  (currency: CurrencyCode, translate?: TranslateFn) =>
-  (plan: Plan): UiPlan =>
-    buildUiPlan(plan, currency, translate);
+import type {
+  Plan,
+  PlanFeature,
+  PlanMainFeatures,
+  PlanPricingByPeriod,
+  UiPlan,
+} from "../types/plan.type";
+import { ADDON_IDS } from "../../subscriptions/constants/addons.constants";
+import {
+  formatCurrencyNumber,
+  type CurrencyCode,
+} from "../../../utils/format/currency";
+
+export type PlanBillingPeriod = "monthly" | "semiannual" | "annual";
+
+type TranslateFn = (key: any, values?: Record<string, string | number>) => string;
+
+const BASE_FEATURES_KEYS = [
+  { icon: "check", key: "plans.features.unlimitedVisits",  fallback: "Visitas ilimitadas" },
+  { icon: "check", key: "plans.features.unlimitedLeads",   fallback: "Leads ilimitadas" },
+  { icon: "check", key: "plans.features.sharePages",        fallback: "Compartilhar páginas", tooltip: "sharePages" },
+  { icon: "check", key: "plans.features.hosting",           fallback: "Hospedagem inclusa" },
+  // SSL (HTTPS) + CDN — brand/acronym: never translated
+  { icon: "check", key: null,                               fallback: "SSL (HTTPS) + CDN" },
+  { icon: "check", key: "plans.features.freeTemplates",     fallback: "Templates gratuitos" },
+] as const;
+
+function buildBaseFeatures(translate?: TranslateFn): PlanFeature[] {
+  return BASE_FEATURES_KEYS.map(({ icon, key, fallback, ...rest }) => {
+    const text = key && translate ? translate(`common.${key}`) : fallback;
+    const feature: PlanFeature = { icon, text };
+    if ("tooltip" in rest && rest.tooltip) feature.tooltip = rest.tooltip;
+    return feature;
+  });
+}
+
+function buildMainFeaturesFromItems(
+  items: Plan["items"],
+  translate?: TranslateFn
+): PlanMainFeatures {
+  const pagesItem = items.find((i) => i.id_addon === ADDON_IDS.PAGES);
+  const domainsItem = items.find((i) => i.id_addon === ADDON_IDS.DOMAINS);
+
+  const pagesQty = pagesItem?.quantity ?? 0;
+  const domainsQty = domainsItem?.quantity ?? 1;
+
+  let pages: string;
+  if (pagesQty === 0) {
+    pages = translate
+      ? translate("common.plans.mainFeatures.pagesUnlimited")
+      : "Páginas ilimitadas";
+  } else if (pagesQty === 1) {
+    pages = translate
+      ? translate("common.plans.mainFeatures.pageSingular")
+      : "1 página";
+  } else {
+    pages = translate
+      ? translate("common.plans.mainFeatures.pagesPlural", { count: pagesQty })
+      : `${pagesQty} páginas`;
+  }
+
+  let domains: string;
+  if (domainsQty >= 999) {
+    domains = translate
+      ? translate("common.plans.mainFeatures.domainsUnlimited")
+      : "Domínios ilimitados";
+  } else if (domainsQty === 1) {
+    domains = translate
+      ? translate("common.plans.mainFeatures.domainSingular")
+      : "1 domínio externo";
+  } else {
+    domains = translate
+      ? translate("common.plans.mainFeatures.domainsPlural", { count: domainsQty })
+      : `${domainsQty} domínios externos`;
+  }
+
+  const users = translate
+    ? translate("common.plans.mainFeatures.usersUnlimited")
+    : "Usuários ilimitados";
+
+  return { pages, domains, users };
+}
+
+function computePricingByPeriod(apiPlan: Plan, currency: CurrencyCode): PlanPricingByPeriod {
+  // Backend agora resolve value por moeda da conta; mapper apenas lê.
+  // value pode ser null (ex.: conta USD, preço USD não cadastrado).
+  const monthly = apiPlan.value;
+  if (monthly == null) {
+    return { monthly: 0, semiannual: 0, annual: 0 };
+  }
+  const round2 = (n: number) => Math.round(n * 100) / 100;
+  return {
+    monthly,
+    semiannual: round2(monthly * (1 - apiPlan.discount_semester / 100)),
+    annual: round2(monthly * (1 - apiPlan.discount_annual / 100)),
+  };
+}
+
+function buildUiPlan(plan: Plan, currency: CurrencyCode, translate?: TranslateFn): UiPlan {
+  const popular = plan.id === 2 || plan.id_plan === 2;
+  const buttonVariant = popular ? "brand" : "default";
+
+  const pricingByPeriod = computePricingByPeriod(plan, currency);
+  const monthlyFinal = pricingByPeriod.monthly;
+
+  const lowerName = plan.name.toLowerCase();
+  const hasProjectAndOnboarding =
+    lowerName.includes("agência") || lowerName.includes("agencia");
+
+  const onboardingText = translate
+    ? translate("common.plans.features.onboarding")
+    : "Reunião de Onboarding";
+  const projectMgmtText = translate
+    ? translate("common.plans.features.projectManagement")
+    : "Gestão de projetos";
+
+  const features: PlanFeature[] = [
+    ...buildBaseFeatures(translate),
+    hasProjectAndOnboarding
+      ? { icon: "check", text: onboardingText }
+      : { icon: "x", text: onboardingText, disabled: true },
+    hasProjectAndOnboarding
+      ? { icon: "check", text: projectMgmtText, tooltip: "projectManagement" }
+      : { icon: "x",     text: projectMgmtText, disabled: true, tooltip: "projectManagement" },
+  ];
+
+  const currencyAwareItems = plan.items.map((item) => ({
+    ...item,
+    value: item.value ?? 0,
+  }));
+
+  const priceUnavailable = plan.value == null;
+  const unavailableLabel = translate ? translate("common.plans.usdNotConfigured") : "USD não configurado";
+
+  return {
+    planId: plan.id,
+    name: plan.name,
+    isPopular: popular,
+    buttonVariant,
+    mainFeatures: buildMainFeaturesFromItems(plan.items, translate),
+    features,
+    originalPrice: priceUnavailable ? unavailableLabel : formatCurrencyNumber(monthlyFinal, 2, currency),
+    price: priceUnavailable ? unavailableLabel : formatCurrencyNumber(monthlyFinal, 2, currency),
+    pricingByPeriod,
+    priceUnavailable,
+    items: currencyAwareItems,
+  };
+}
+
+/**
+ * Mapeia um plano da API para UiPlan em BRL.
+ * Assinatura de 1 argumento — seguro em `plans.map(mapApiPlanToUiPlan)`.
+ * Passa `translate` opcional para i18n; sem ele cai nos literais pt-br (back-compat).
+ */
+export function mapApiPlanToUiPlan(plan: Plan, translate?: TranslateFn): UiPlan {
+  return buildUiPlan(plan, "brl", translate);
+}
+
+/**
+ * Variante currency-aware: a moeda vem do gateway da conta (getCurrencyForGateway).
+ * Fábrica para uso ergonômico em `.map`: `plans.map(mapApiPlanToUiPlanForCurrency(currency, translate))`.
+ * Mantida separada de mapApiPlanToUiPlan para não quebrar callers que passam a fn direto pro `.map`.
+ */
+export const mapApiPlanToUiPlanForCurrency =
+  (currency: CurrencyCode, translate?: TranslateFn) =>
+  (plan: Plan): UiPlan =>
+    buildUiPlan(plan, currency, translate);

package/src/modules/projects/actions/add-project-user.action.ts

@@ -1,9 +1,9 @@
-'use server';
-
-import { safeMutationAction } from '../../../utils/safeMutationAction';
-import { projectUsersService } from '../services/project-users.service';
-import type { AddRemoveProjectUsersParams } from '../types';
-
-export async function addProjectUserAction(params: AddRemoveProjectUsersParams) {
-  return safeMutationAction(() => projectUsersService.addToProject(params));
-}
+'use server';
+
+import { safeMutationAction } from '../../../utils/safeMutationAction';
+import { projectUsersService } from '../services/project-users.service';
+import type { AddRemoveProjectUsersParams } from '../types';
+
+export async function addProjectUserAction(params: AddRemoveProjectUsersParams) {
+  return safeMutationAction(() => projectUsersService.addToProject(params));
+}

package/src/modules/projects/actions/create-project.action.ts

@@ -1,9 +1,9 @@
-'use server';
-
-import { safeMutationAction } from '../../../utils/safeMutationAction';
-import { projectsService } from '../services/projects.service';
-import type { CreateProjectRequest } from '../types';
-
-export async function createProjectAction(data: CreateProjectRequest) {
-  return safeMutationAction(() => projectsService.create(data));
-}
+'use server';
+
+import { safeMutationAction } from '../../../utils/safeMutationAction';
+import { projectsService } from '../services/projects.service';
+import type { CreateProjectRequest } from '../types';
+
+export async function createProjectAction(data: CreateProjectRequest) {
+  return safeMutationAction(() => projectsService.create(data));
+}

package/src/modules/projects/actions/delete-project.action.ts

@@ -1,8 +1,8 @@
-'use server';
-
-import { safeMutationAction } from '../../../utils/safeMutationAction';
-import { projectsService } from '../services/projects.service';
-
-export async function deleteProjectAction(projectId: number, moveToProjectId: number) {
-  return safeMutationAction(() => projectsService.delete(projectId, moveToProjectId));
-}
+'use server';
+
+import { safeMutationAction } from '../../../utils/safeMutationAction';
+import { projectsService } from '../services/projects.service';
+
+export async function deleteProjectAction(projectId: number, moveToProjectId: number) {
+  return safeMutationAction(() => projectsService.delete(projectId, moveToProjectId));
+}

package/src/modules/projects/actions/find-project.action.ts

@@ -1,8 +1,8 @@
-'use server';
-
-import { safeServerAction } from '../../../utils/safeServerAction';
-import { projectsService } from '../services/projects.service';
-
-export async function findProjectAction(projectId: number) {
-  return safeServerAction(() => projectsService.findById(projectId));
-}
+'use server';
+
+import { safeServerAction } from '../../../utils/safeServerAction';
+import { projectsService } from '../services/projects.service';
+
+export async function findProjectAction(projectId: number) {
+  return safeServerAction(() => projectsService.findById(projectId));
+}

package/src/modules/projects/actions/list-project-users.action.ts

@@ -1,9 +1,9 @@
-'use server';
-
-import { safeServerAction } from '../../../utils/safeServerAction';
-import { projectUsersService } from '../services/project-users.service';
-import type { ListUsersParams } from '../types';
-
-export async function listProjectUsersAction(projectId: number, params: ListUsersParams = {}) {
-  return safeServerAction(() => projectUsersService.listInProject(projectId, params));
-}
+'use server';
+
+import { safeServerAction } from '../../../utils/safeServerAction';
+import { projectUsersService } from '../services/project-users.service';
+import type { ListUsersParams } from '../types';
+
+export async function listProjectUsersAction(projectId: number, params: ListUsersParams = {}) {
+  return safeServerAction(() => projectUsersService.listInProject(projectId, params));
+}

package/src/modules/projects/actions/list-projects.action.ts

@@ -1,16 +1,16 @@
-'use server';
-
-import { safeServerAction } from '../../../utils/safeServerAction';
-import { projectsService } from '../services/projects.service';
-
-export interface ListProjectsActionParams {
-  page?: number;
-  limit?: number;
-  sort?: string;
-  search?: string;
-  deleted?: number;
-}
-
-export async function listProjectsAction(params?: ListProjectsActionParams) {
-  return safeServerAction(() => projectsService.list(params));
-}
+'use server';
+
+import { safeServerAction } from '../../../utils/safeServerAction';
+import { projectsService } from '../services/projects.service';
+
+export interface ListProjectsActionParams {
+  page?: number;
+  limit?: number;
+  sort?: string;
+  search?: string;
+  deleted?: number;
+}
+
+export async function listProjectsAction(params?: ListProjectsActionParams) {
+  return safeServerAction(() => projectsService.list(params));
+}

package/src/modules/projects/actions/remove-project-user.action.ts

@@ -1,9 +1,9 @@
-'use server';
-
-import { safeMutationAction } from '../../../utils/safeMutationAction';
-import { projectUsersService } from '../services/project-users.service';
-import type { AddRemoveProjectUsersParams } from '../types';
-
-export async function removeProjectUserAction(params: AddRemoveProjectUsersParams) {
-  return safeMutationAction(() => projectUsersService.removeFromProject(params));
-}
+'use server';
+
+import { safeMutationAction } from '../../../utils/safeMutationAction';
+import { projectUsersService } from '../services/project-users.service';
+import type { AddRemoveProjectUsersParams } from '../types';
+
+export async function removeProjectUserAction(params: AddRemoveProjectUsersParams) {
+  return safeMutationAction(() => projectUsersService.removeFromProject(params));
+}

package/src/modules/projects/actions/update-project.action.ts

@@ -1,9 +1,9 @@
-'use server';
-
-import { safeMutationAction } from '../../../utils/safeMutationAction';
-import { projectsService } from '../services/projects.service';
-import type { UpdateProjectRequest } from '../types';
-
-export async function updateProjectAction(projectId: number, data: UpdateProjectRequest) {
-  return safeMutationAction(() => projectsService.update(projectId, data));
-}
+'use server';
+
+import { safeMutationAction } from '../../../utils/safeMutationAction';
+import { projectsService } from '../services/projects.service';
+import type { UpdateProjectRequest } from '../types';
+
+export async function updateProjectAction(projectId: number, data: UpdateProjectRequest) {
+  return safeMutationAction(() => projectsService.update(projectId, data));
+}

package/src/modules/projects/handlers/find-project.handler.ts

@@ -1,15 +1,15 @@
-import 'server-only';
-
-import type { NextRequest } from 'next/server';
-import { parseId } from '../../../infra/route/parse-id';
-import { safeRouteHandler } from '../../../infra/route/safe-route-handler';
-import { projectsService } from '../services/projects.service';
-
-export function createFindProjectHandler() {
-  return async function GET(_req: NextRequest, { params }: { params: Promise<{ id: string }> }) {
-    return safeRouteHandler(async () => {
-      const { id } = await params;
-      return projectsService.findById(parseId(id));
-    });
-  };
-}
+import 'server-only';
+
+import type { NextRequest } from 'next/server';
+import { parseId } from '../../../infra/route/parse-id';
+import { safeRouteHandler } from '../../../infra/route/safe-route-handler';
+import { projectsService } from '../services/projects.service';
+
+export function createFindProjectHandler() {
+  return async function GET(_req: NextRequest, { params }: { params: Promise<{ id: string }> }) {
+    return safeRouteHandler(async () => {
+      const { id } = await params;
+      return projectsService.findById(parseId(id));
+    });
+  };
+}

package/src/modules/projects/handlers/list-all-account-users.handler.ts

@@ -1,23 +1,23 @@
-import 'server-only';
-
-import type { NextRequest } from 'next/server';
-import { parseNumericFields } from '../../../infra/route/parse-numeric';
-import { safeRouteHandler } from '../../../infra/route/safe-route-handler';
-import { searchParamsToParams } from '../../../infra/route/search-params';
-import { projectUsersService } from '../services/project-users.service';
-import type { ListUsersParams } from '../types';
-
-const NUMERIC_FIELDS = ['page', 'limit'] as const;
-
-export function createListAllAccountUsersHandler() {
-  return async function GET(req: NextRequest) {
-    return safeRouteHandler(() =>
-      projectUsersService.listAllAccountUsers(
-        parseNumericFields<ListUsersParams>(
-          searchParamsToParams<ListUsersParams>(req.nextUrl.searchParams),
-          NUMERIC_FIELDS
-        )
-      )
-    );
-  };
-}
+import 'server-only';
+
+import type { NextRequest } from 'next/server';
+import { parseNumericFields } from '../../../infra/route/parse-numeric';
+import { safeRouteHandler } from '../../../infra/route/safe-route-handler';
+import { searchParamsToParams } from '../../../infra/route/search-params';
+import { projectUsersService } from '../services/project-users.service';
+import type { ListUsersParams } from '../types';
+
+const NUMERIC_FIELDS = ['page', 'limit'] as const;
+
+export function createListAllAccountUsersHandler() {
+  return async function GET(req: NextRequest) {
+    return safeRouteHandler(() =>
+      projectUsersService.listAllAccountUsers(
+        parseNumericFields<ListUsersParams>(
+          searchParamsToParams<ListUsersParams>(req.nextUrl.searchParams),
+          NUMERIC_FIELDS
+        )
+      )
+    );
+  };
+}

package/src/modules/projects/handlers/list-available-users.handler.ts

@@ -1,26 +1,26 @@
-import 'server-only';
-
-import type { NextRequest } from 'next/server';
-import { parseId } from '../../../infra/route/parse-id';
-import { parseNumericFields } from '../../../infra/route/parse-numeric';
-import { safeRouteHandler } from '../../../infra/route/safe-route-handler';
-import { searchParamsToParams } from '../../../infra/route/search-params';
-import { projectUsersService } from '../services/project-users.service';
-import type { ListUsersParams } from '../types';
-
-const NUMERIC_FIELDS = ['page', 'limit'] as const;
-
-export function createListAvailableUsersHandler() {
-  return async function GET(req: NextRequest, { params }: { params: Promise<{ id: string }> }) {
-    return safeRouteHandler(async () => {
-      const { id } = await params;
-      return projectUsersService.listNotInProject(
-        parseId(id),
-        parseNumericFields<ListUsersParams>(
-          searchParamsToParams<ListUsersParams>(req.nextUrl.searchParams),
-          NUMERIC_FIELDS
-        )
-      );
-    });
-  };
-}
+import 'server-only';
+
+import type { NextRequest } from 'next/server';
+import { parseId } from '../../../infra/route/parse-id';
+import { parseNumericFields } from '../../../infra/route/parse-numeric';
+import { safeRouteHandler } from '../../../infra/route/safe-route-handler';
+import { searchParamsToParams } from '../../../infra/route/search-params';
+import { projectUsersService } from '../services/project-users.service';
+import type { ListUsersParams } from '../types';
+
+const NUMERIC_FIELDS = ['page', 'limit'] as const;
+
+export function createListAvailableUsersHandler() {
+  return async function GET(req: NextRequest, { params }: { params: Promise<{ id: string }> }) {
+    return safeRouteHandler(async () => {
+      const { id } = await params;
+      return projectUsersService.listNotInProject(
+        parseId(id),
+        parseNumericFields<ListUsersParams>(
+          searchParamsToParams<ListUsersParams>(req.nextUrl.searchParams),
+          NUMERIC_FIELDS
+        )
+      );
+    });
+  };
+}