@greatapps/common 1.1.755 → 1.1.757

package/dist/infra/api/client.mjs

@@ -162,6 +162,42 @@ class ApiClient {
   async delete(endpoint, config) {
     return this.request(endpoint, { ...config, method: "DELETE" });
   }
+  /**
+   * Requisição cuja resposta é consumida em stream: devolve a `Response` crua, sem ler o
+   * corpo e sem timeout.
+   *
+   * `request()` não serve para isso por dois motivos. Ele faz `await response.json()`, o
+   * que espera o corpo inteiro e mata o propósito do stream; e aborta em 30s, que é o
+   * tempo que uma operação longa leva justamente por ser longa — gerar o link de uma
+   * página com 132 imagens copia 100 MB e passa disso (ID-5112).
+   *
+   * O corpo é do chamador: quem recebe decide quando ler e quando cancelar.
+   */
+  async stream(endpoint, config = {}) {
+    const { timeout: _timeout, responseType: _responseType, whiteLabelId: overrideWlId, authToken: overrideToken, ...fetchConfig } = config;
+    const resolvido = overrideWlId != null && overrideToken != null ? { id: overrideWlId, token: overrideToken } : await findWhitelabel();
+    const [url, defaultHeaders] = await Promise.all([
+      this.buildUrl(endpoint, overrideWlId ?? resolvido.id),
+      this.getDefaultHeaders(overrideToken ?? resolvido.token)
+    ]);
+    const response = await fetch(url, {
+      ...fetchConfig,
+      headers: { ...defaultHeaders, ...fetchConfig.headers },
+      // Sem isto o fetch do Next segura o corpo inteiro antes de devolver, e o stream chega
+      // completo de uma vez no fim: medido em 32s até o primeiro evento, contra 0,4s com
+      // no-store. O progresso existiria no protocolo e não na tela.
+      cache: "no-store"
+    });
+    if (!response.ok || !response.body) {
+      const detalhe = await response.text().catch(() => "");
+      throw new ApiError(
+        detalhe.trim() || `HTTP error ${response.status} ${response.statusText}`,
+        "HTTP_ERROR",
+        response.status
+      );
+    }
+    return response;
+  }
 }
 const api = {
   apps: new ApiClient(

package/dist/infra/api/client.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/infra/api/client.ts"],"sourcesContent":["import { ApiError } from \"./types\";\r\nimport { findWhitelabel } from \"../../modules/whitelabel/actions/find-whitelabel.action\";\r\n\r\nexport interface ApiClientOptions {\r\n  /**\r\n   * Quando true, monta `{base}/{locale}/{wlId}{endpoint}` (ex.: r2-clone).\r\n   * Padrão false: `{base}/v1/{locale}/{wlId}{endpoint}`.\r\n   */\r\n  omitApiVersion?: boolean;\r\n\r\n  /** Habilita logs detalhados das requisições (útil para desenvolvimento) */\r\n  emitLogs?: boolean;\r\n}\r\n\r\nexport interface RequestConfig extends RequestInit {\r\n  timeout?: number;\r\n  /** Padrão `json`. Use `text` quando a API devolve corpo não-JSON. */\r\n  responseType?: \"json\" | \"text\";\r\n  /** Força um whiteLabelId específico na URL, ignorando o findWhitelabel(). */\r\n  whiteLabelId?: number;\r\n  /** Força um token específico no header Authorization, ignorando o findWhitelabel(). */\r\n  authToken?: string;\r\n}\r\n\r\nclass ApiClient {\r\n  private readonly baseUrl: string;\r\n  private readonly apiVersion = \"v1\";\r\n  private readonly apiLocale = \"pt-br\";\r\n  private readonly omitApiVersion: boolean;\r\n  private readonly emitLogs: boolean = false;\r\n\r\n  constructor(baseUrl: string, options?: ApiClientOptions) {\r\n    this.baseUrl = baseUrl.replace(/\\/$/, \"\");\r\n    this.omitApiVersion = options?.omitApiVersion ?? false;\r\n    this.emitLogs = options?.emitLogs ?? false;\r\n  }\r\n\r\n  private async buildUrl(\r\n    endpoint: string,\r\n    whiteLabelId: number,\r\n  ): Promise<string> {\r\n    const wlPath = this.omitApiVersion\r\n      ? `/${this.apiLocale}/${whiteLabelId}`\r\n      : `/${this.apiVersion}/${this.apiLocale}/${whiteLabelId}`;\r\n    const path = endpoint.startsWith(\"/\") ? endpoint : `/${endpoint}`;\r\n    const url = `${this.baseUrl}${wlPath}${path}`;\r\n    if (this.emitLogs) {\r\n      console.log(\"[ApiClient] buildUrl\", {\r\n        baseURL: this.baseUrl,\r\n        whiteLabelId,\r\n        endpoint,\r\n        fullUrl: url,\r\n      });\r\n    }\r\n    return url;\r\n  }\r\n\r\n  private async getDefaultHeaders(\r\n    token: string,\r\n    isFormData = false,\r\n  ): Promise<HeadersInit> {\r\n    if (this.emitLogs) {\r\n      console.log(\"[ApiClient] getDefaultHeaders\", {\r\n        token: token.substring(0, 20) + \"...\",\r\n      });\r\n    }\r\n\r\n    const headers: HeadersInit = {\r\n      authorization: token,\r\n    };\r\n\r\n    if (!isFormData) {\r\n      headers[\"Content-Type\"] = \"application/json\";\r\n    }\r\n\r\n    return headers;\r\n  }\r\n\r\n  async request<T>(endpoint: string, config: RequestConfig = {}): Promise<T> {\r\n    if (this.emitLogs) {\r\n      console.log(\"[ApiClient] request called\", {\r\n        endpoint,\r\n        method: config.method,\r\n      });\r\n    }\r\n\r\n    const { timeout = 30000, responseType = \"json\", whiteLabelId: overrideWlId, authToken: overrideToken, ...fetchConfig } = config;\r\n\r\n    const controller = new AbortController();\r\n    const timeoutId = setTimeout(() => controller.abort(), timeout);\r\n\r\n    try {\r\n      if (this.emitLogs) {\r\n        console.log(\"[ApiClient] Building URL and headers...\");\r\n      }\r\n\r\n      const { id, token } = await findWhitelabel();\r\n\r\n      const [url, defaultHeaders] = await Promise.all([\r\n        this.buildUrl(endpoint, overrideWlId ?? id),\r\n        this.getDefaultHeaders(overrideToken ?? token, fetchConfig.body instanceof FormData),\r\n      ]);\r\n\r\n      if (this.emitLogs)\r\n        console.log(\"[ApiClient] Fetching\", {\r\n          url,\r\n          method: fetchConfig.method,\r\n          headers: defaultHeaders,\r\n        });\r\n\r\n      const response = await fetch(url, {\r\n        ...fetchConfig,\r\n        headers: {\r\n          ...defaultHeaders,\r\n          ...fetchConfig.headers,\r\n        },\r\n        signal: controller.signal,\r\n      });\r\n\r\n      if (this.emitLogs)\r\n        console.log(\"[ApiClient] Response received\", {\r\n          status: response.status,\r\n          ok: response.ok,\r\n        });\r\n\r\n      if (!response.ok) {\r\n        const errBody = await response.text();\r\n        let message = `HTTP error ${response.status} ${response.statusText} ${errBody}`;\r\n        let code = \"HTTP_ERROR\";\r\n        try {\r\n          const errorData = JSON.parse(errBody) as Record<string, unknown>;\r\n          // @ts-ignore -- msg pode ser string ou objeto com .message\r\n          message = errorData.message?.message ?? errorData.message ?? message;\r\n          if (typeof errorData.code === \"string\") code = errorData.code;\r\n        } catch {\r\n          if (errBody.trim()) message = errBody.trim();\r\n        }\r\n        const method = fetchConfig.method ?? \"GET\";\r\n        let bodyPreview: unknown;\r\n        if (method !== \"GET\" && fetchConfig.body != null) {\r\n          if (typeof fetchConfig.body === \"string\") {\r\n            try {\r\n              bodyPreview = JSON.parse(fetchConfig.body);\r\n            } catch {\r\n              bodyPreview = fetchConfig.body;\r\n            }\r\n          } else if (fetchConfig.body instanceof FormData) {\r\n            bodyPreview = \"[FormData]\";\r\n          } else {\r\n            bodyPreview = fetchConfig.body;\r\n          }\r\n        }\r\n        console.error(\"[ApiClient] Request failed\", {\r\n          from: url,\r\n          method,\r\n          ...(bodyPreview !== undefined ? { body: bodyPreview } : {}),\r\n          status: response.status,\r\n          message,\r\n        });\r\n        throw new ApiError(message, code, response.status);\r\n      }\r\n\r\n      if (responseType === \"text\") {\r\n        return (await response.text()) as T;\r\n      }\r\n\r\n      const data = (await response.json()) as T;\r\n      if (this.emitLogs)\r\n        console.log(\"[ApiClient] Request successful\", { hasData: !!data });\r\n      return data;\r\n    } catch (error) {\r\n      if (this.emitLogs) console.error(\"[ApiClient] Request error\", { error });\r\n\r\n      if (error instanceof ApiError) {\r\n        throw error;\r\n      }\r\n\r\n      if (error instanceof Error) {\r\n        if (error.name === \"AbortError\") {\r\n          throw new ApiError(\"Tempo de requisição excedido\", \"TIMEOUT\", 408);\r\n        }\r\n        throw new ApiError(error.message, \"NETWORK_ERROR\", 0);\r\n      }\r\n\r\n      throw new ApiError(\"Erro desconhecido\", \"UNKNOWN_ERROR\", 500);\r\n    } finally {\r\n      clearTimeout(timeoutId);\r\n    }\r\n  }\r\n\r\n  async get<T>(endpoint: string, config?: RequestConfig): Promise<T> {\r\n    return this.request<T>(endpoint, { ...config, method: \"GET\" });\r\n  }\r\n\r\n  async post<T>(\r\n    endpoint: string,\r\n    data?: unknown,\r\n    config?: RequestConfig,\r\n  ): Promise<T> {\r\n    return this.request<T>(endpoint, {\r\n      ...config,\r\n      method: \"POST\",\r\n      body:\r\n        data instanceof FormData\r\n          ? data\r\n          : data\r\n            ? JSON.stringify(data)\r\n            : undefined,\r\n    });\r\n  }\r\n\r\n  async put<T>(\r\n    endpoint: string,\r\n    data?: unknown,\r\n    config?: RequestConfig,\r\n  ): Promise<T> {\r\n    return this.request<T>(endpoint, {\r\n      ...config,\r\n      method: \"PUT\",\r\n      body:\r\n        data instanceof FormData\r\n          ? data\r\n          : data\r\n            ? JSON.stringify(data)\r\n            : undefined,\r\n    });\r\n  }\r\n\r\n  async patch<T>(\r\n    endpoint: string,\r\n    data?: unknown,\r\n    config?: RequestConfig,\r\n  ): Promise<T> {\r\n    return this.request<T>(endpoint, {\r\n      ...config,\r\n      method: \"PATCH\",\r\n      body:\r\n        data instanceof FormData\r\n          ? data\r\n          : data\r\n            ? JSON.stringify(data)\r\n            : undefined,\r\n    });\r\n  }\r\n\r\n  async delete<T>(endpoint: string, config?: RequestConfig): Promise<T> {\r\n    return this.request<T>(endpoint, { ...config, method: \"DELETE\" });\r\n  }\r\n}\r\n\r\nconst api = {\r\n  apps: new ApiClient(\r\n    process.env.GAPPS_R3_API_URL || \"https://r3-api.greatapps.dev.br\",\r\n  ),\r\n  pages: new ApiClient(\r\n    process.env.GPAGES_R3_API_URL || \"https://r3-api.greatpages.dev.br\",\r\n  ),\r\n};\r\n\r\n/** @deprecated use api.apps */\r\nexport const apiClient = api.apps;\r\n\r\nexport { api, ApiClient };\r\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/infra/api/client.ts"],"sourcesContent":["import { ApiError } from \"./types\";\nimport { findWhitelabel } from \"../../modules/whitelabel/actions/find-whitelabel.action\";\n\nexport interface ApiClientOptions {\n  /**\n   * Quando true, monta `{base}/{locale}/{wlId}{endpoint}` (ex.: r2-clone).\n   * Padrão false: `{base}/v1/{locale}/{wlId}{endpoint}`.\n   */\n  omitApiVersion?: boolean;\n\n  /** Habilita logs detalhados das requisições (útil para desenvolvimento) */\n  emitLogs?: boolean;\n}\n\nexport interface RequestConfig extends RequestInit {\n  timeout?: number;\n  /** Padrão `json`. Use `text` quando a API devolve corpo não-JSON. */\n  responseType?: \"json\" | \"text\";\n  /** Força um whiteLabelId específico na URL, ignorando o findWhitelabel(). */\n  whiteLabelId?: number;\n  /** Força um token específico no header Authorization, ignorando o findWhitelabel(). */\n  authToken?: string;\n}\n\nclass ApiClient {\n  private readonly baseUrl: string;\n  private readonly apiVersion = \"v1\";\n  private readonly apiLocale = \"pt-br\";\n  private readonly omitApiVersion: boolean;\n  private readonly emitLogs: boolean = false;\n\n  constructor(baseUrl: string, options?: ApiClientOptions) {\n    this.baseUrl = baseUrl.replace(/\\/$/, \"\");\n    this.omitApiVersion = options?.omitApiVersion ?? false;\n    this.emitLogs = options?.emitLogs ?? false;\n  }\n\n  private async buildUrl(\n    endpoint: string,\n    whiteLabelId: number,\n  ): Promise<string> {\n    const wlPath = this.omitApiVersion\n      ? `/${this.apiLocale}/${whiteLabelId}`\n      : `/${this.apiVersion}/${this.apiLocale}/${whiteLabelId}`;\n    const path = endpoint.startsWith(\"/\") ? endpoint : `/${endpoint}`;\n    const url = `${this.baseUrl}${wlPath}${path}`;\n    if (this.emitLogs) {\n      console.log(\"[ApiClient] buildUrl\", {\n        baseURL: this.baseUrl,\n        whiteLabelId,\n        endpoint,\n        fullUrl: url,\n      });\n    }\n    return url;\n  }\n\n  private async getDefaultHeaders(\n    token: string,\n    isFormData = false,\n  ): Promise<HeadersInit> {\n    if (this.emitLogs) {\n      console.log(\"[ApiClient] getDefaultHeaders\", {\n        token: token.substring(0, 20) + \"...\",\n      });\n    }\n\n    const headers: HeadersInit = {\n      authorization: token,\n    };\n\n    if (!isFormData) {\n      headers[\"Content-Type\"] = \"application/json\";\n    }\n\n    return headers;\n  }\n\n  async request<T>(endpoint: string, config: RequestConfig = {}): Promise<T> {\n    if (this.emitLogs) {\n      console.log(\"[ApiClient] request called\", {\n        endpoint,\n        method: config.method,\n      });\n    }\n\n    const { timeout = 30000, responseType = \"json\", whiteLabelId: overrideWlId, authToken: overrideToken, ...fetchConfig } = config;\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n    try {\n      if (this.emitLogs) {\n        console.log(\"[ApiClient] Building URL and headers...\");\n      }\n\n      const { id, token } = await findWhitelabel();\n\n      const [url, defaultHeaders] = await Promise.all([\n        this.buildUrl(endpoint, overrideWlId ?? id),\n        this.getDefaultHeaders(overrideToken ?? token, fetchConfig.body instanceof FormData),\n      ]);\n\n      if (this.emitLogs)\n        console.log(\"[ApiClient] Fetching\", {\n          url,\n          method: fetchConfig.method,\n          headers: defaultHeaders,\n        });\n\n      const response = await fetch(url, {\n        ...fetchConfig,\n        headers: {\n          ...defaultHeaders,\n          ...fetchConfig.headers,\n        },\n        signal: controller.signal,\n      });\n\n      if (this.emitLogs)\n        console.log(\"[ApiClient] Response received\", {\n          status: response.status,\n          ok: response.ok,\n        });\n\n      if (!response.ok) {\n        const errBody = await response.text();\n        let message = `HTTP error ${response.status} ${response.statusText} ${errBody}`;\n        let code = \"HTTP_ERROR\";\n        try {\n          const errorData = JSON.parse(errBody) as Record<string, unknown>;\n          // @ts-ignore -- msg pode ser string ou objeto com .message\n          message = errorData.message?.message ?? errorData.message ?? message;\n          if (typeof errorData.code === \"string\") code = errorData.code;\n        } catch {\n          if (errBody.trim()) message = errBody.trim();\n        }\n        const method = fetchConfig.method ?? \"GET\";\n        let bodyPreview: unknown;\n        if (method !== \"GET\" && fetchConfig.body != null) {\n          if (typeof fetchConfig.body === \"string\") {\n            try {\n              bodyPreview = JSON.parse(fetchConfig.body);\n            } catch {\n              bodyPreview = fetchConfig.body;\n            }\n          } else if (fetchConfig.body instanceof FormData) {\n            bodyPreview = \"[FormData]\";\n          } else {\n            bodyPreview = fetchConfig.body;\n          }\n        }\n        console.error(\"[ApiClient] Request failed\", {\n          from: url,\n          method,\n          ...(bodyPreview !== undefined ? { body: bodyPreview } : {}),\n          status: response.status,\n          message,\n        });\n        throw new ApiError(message, code, response.status);\n      }\n\n      if (responseType === \"text\") {\n        return (await response.text()) as T;\n      }\n\n      const data = (await response.json()) as T;\n      if (this.emitLogs)\n        console.log(\"[ApiClient] Request successful\", { hasData: !!data });\n      return data;\n    } catch (error) {\n      if (this.emitLogs) console.error(\"[ApiClient] Request error\", { error });\n\n      if (error instanceof ApiError) {\n        throw error;\n      }\n\n      if (error instanceof Error) {\n        if (error.name === \"AbortError\") {\n          throw new ApiError(\"Tempo de requisição excedido\", \"TIMEOUT\", 408);\n        }\n        throw new ApiError(error.message, \"NETWORK_ERROR\", 0);\n      }\n\n      throw new ApiError(\"Erro desconhecido\", \"UNKNOWN_ERROR\", 500);\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  async get<T>(endpoint: string, config?: RequestConfig): Promise<T> {\n    return this.request<T>(endpoint, { ...config, method: \"GET\" });\n  }\n\n  async post<T>(\n    endpoint: string,\n    data?: unknown,\n    config?: RequestConfig,\n  ): Promise<T> {\n    return this.request<T>(endpoint, {\n      ...config,\n      method: \"POST\",\n      body:\n        data instanceof FormData\n          ? data\n          : data\n            ? JSON.stringify(data)\n            : undefined,\n    });\n  }\n\n  async put<T>(\n    endpoint: string,\n    data?: unknown,\n    config?: RequestConfig,\n  ): Promise<T> {\n    return this.request<T>(endpoint, {\n      ...config,\n      method: \"PUT\",\n      body:\n        data instanceof FormData\n          ? data\n          : data\n            ? JSON.stringify(data)\n            : undefined,\n    });\n  }\n\n  async patch<T>(\n    endpoint: string,\n    data?: unknown,\n    config?: RequestConfig,\n  ): Promise<T> {\n    return this.request<T>(endpoint, {\n      ...config,\n      method: \"PATCH\",\n      body:\n        data instanceof FormData\n          ? data\n          : data\n            ? JSON.stringify(data)\n            : undefined,\n    });\n  }\n\n  async delete<T>(endpoint: string, config?: RequestConfig): Promise<T> {\n    return this.request<T>(endpoint, { ...config, method: \"DELETE\" });\n  }\n\n  /**\n   * Requisição cuja resposta é consumida em stream: devolve a `Response` crua, sem ler o\n   * corpo e sem timeout.\n   *\n   * `request()` não serve para isso por dois motivos. Ele faz `await response.json()`, o\n   * que espera o corpo inteiro e mata o propósito do stream; e aborta em 30s, que é o\n   * tempo que uma operação longa leva justamente por ser longa — gerar o link de uma\n   * página com 132 imagens copia 100 MB e passa disso (ID-5112).\n   *\n   * O corpo é do chamador: quem recebe decide quando ler e quando cancelar.\n   */\n  async stream(endpoint: string, config: RequestConfig = {}): Promise<Response> {\n    const { timeout: _timeout, responseType: _responseType, whiteLabelId: overrideWlId, authToken: overrideToken, ...fetchConfig } = config;\n\n    // Só resolve o whitelabel quando falta algum dos dois: com ambos vindos do chamador, a\n    // consulta seria uma ida à rede para descartar o resultado.\n    const resolvido = overrideWlId != null && overrideToken != null\n      ? { id: overrideWlId, token: overrideToken }\n      : await findWhitelabel();\n\n    const [url, defaultHeaders] = await Promise.all([\n      this.buildUrl(endpoint, overrideWlId ?? resolvido.id),\n      this.getDefaultHeaders(overrideToken ?? resolvido.token),\n    ]);\n\n    const response = await fetch(url, {\n      ...fetchConfig,\n      headers: { ...defaultHeaders, ...fetchConfig.headers },\n      // Sem isto o fetch do Next segura o corpo inteiro antes de devolver, e o stream chega\n      // completo de uma vez no fim: medido em 32s até o primeiro evento, contra 0,4s com\n      // no-store. O progresso existiria no protocolo e não na tela.\n      cache: \"no-store\",\n    });\n\n    if (!response.ok || !response.body) {\n      const detalhe = await response.text().catch(() => \"\");\n      throw new ApiError(\n        detalhe.trim() || `HTTP error ${response.status} ${response.statusText}`,\n        \"HTTP_ERROR\",\n        response.status,\n      );\n    }\n\n    return response;\n  }\n}\n\nconst api = {\n  apps: new ApiClient(\n    process.env.GAPPS_R3_API_URL || \"https://r3-api.greatapps.dev.br\",\n  ),\n  pages: new ApiClient(\n    process.env.GPAGES_R3_API_URL || \"https://r3-api.greatpages.dev.br\",\n  ),\n};\n\n/** @deprecated use api.apps */\nexport const apiClient = api.apps;\n\nexport { api, ApiClient };\n"],"mappings":"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","names":[]}

package/dist/modules/plans/types/plan.type.mjs

@@ -7,7 +7,11 @@ const PlanItemSchema = z.object({
   // Maior valor positivo por addon = preço base/original (demais linhas são promos).
   // Derivado por heurística no backend (não há coluna no banco). Ausente em payloads
   // de cache antigos → optional.
-  base: z.boolean().optional()
+  base: z.boolean().optional(),
+  // Faixa por volume: a quantidade EXATA para a qual este `value` unitário vale
+  // (créditos de IA em 2.500/5.000/10.000 saem mais baratos por unidade). Ausente/null
+  // = unitário padrão, válido para qualquer quantidade.
+  tier_quantity: z.number().nullish()
 });
 const PlanPeriodPricingSchema = z.object({
   charged: z.number(),

package/dist/modules/plans/types/plan.type.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/modules/plans/types/plan.type.ts"],"sourcesContent":["import z from 'zod';\nimport type { BillingPeriod } from '../../subscriptions/types/billing-period.type';\n\nexport const PlanItemSchema = z.object({\n  id_addon: z.number(),\n  quantity: z.number(),\n  value: z.number(),\n  value_usd: z.number().nullish(),\n  // Maior valor positivo por addon = preço base/original (demais linhas são promos).\n  // Derivado por heurística no backend (não há coluna no banco). Ausente em payloads\n  // de cache antigos → optional.\n  base: z.boolean().optional(),\n});\n\nexport type PlanItem = z.infer<typeof PlanItemSchema>;\n\nexport const PlanPeriodPricingSchema = z.object({\n  charged: z.number(),\n  list: z.number(),\n  discount: z.number(),\n  discount_percent: z.number(),\n});\n\nexport const PlanApiPricingSchema = z.object({\n  currency: z.enum(['brl', 'usd']),\n  monthly: PlanPeriodPricingSchema,\n  semester: PlanPeriodPricingSchema,\n  annual: PlanPeriodPricingSchema,\n});\n\nexport type PlanApiPricing = z.infer<typeof PlanApiPricingSchema>;\n\nexport const PlanSchema = z.object({\n  id: z.number(),\n  id_plan: z.number().optional(),\n  name: z.string(),\n  value: z.number().nullable().default(0),\n  // Preço em USD (conta stripe_usd). Operador cadastra no backend; ausente em planos\n  // sem suporte internacional. Backend agora resolve por moeda da conta (customer),\n  // omitindo value_usd para customer requests e adicionando currency. Admin paths\n  // ainda recebem value_usd como número (sem .coerce — backend joga agora como Number).\n  value_usd: z.number().nullish(),\n  currency: z.enum(['brl', 'usd']).optional(),\n  type: z.string().optional(),\n  discount_semester: z.number().default(0),\n  discount_annual: z.number().default(0),\n  pricing: PlanApiPricingSchema.optional(),\n  items: z.array(PlanItemSchema).optional().default([]),\n});\n\nexport type Plan = z.infer<typeof PlanSchema>;\n\n// ── UI Plan types (used by list-plans action and consumers) ──\n\nexport type PlanFeature = {\n  icon: 'check' | 'x';\n  text: string;\n  disabled?: boolean;\n  tooltip?: keyof PlanTooltips;\n};\n\nexport type PlanMainFeatures = {\n  pages: string;\n  domains: string;\n  users: string;\n};\n\n/** Preços mensais equivalentes por período de cobrança (já com desconto aplicado). */\nexport type PlanPricingByPeriod = {\n  monthly: number;\n  semiannual: number;\n  annual: number;\n};\n\nexport type UiPlan = {\n  planId: number;\n  name: string;\n  isPopular?: boolean;\n  isCurrentPlan?: boolean;\n  currentPeriodicity?: BillingPeriod | null;\n  mainFeatures: PlanMainFeatures;\n  features: PlanFeature[];\n  originalPrice: string;\n  price: string;\n  pricingByPeriod?: PlanPricingByPeriod;\n  pricing?: PlanApiPricing;\n  buttonVariant?: 'brand' | 'default';\n  priceUnavailable?: boolean;\n  items: PlanItem[];\n};\n\nexport type PlanTooltips = {\n  domains: string;\n  users: string;\n  sharePages: string;\n  projectManagement: string;\n};\n"],"mappings":"AAAA,OAAO,OAAO;AAGP,MAAM,iBAAiB,EAAE,OAAO;AAAA,EACrC,UAAU,EAAE,OAAO;AAAA,EACnB,UAAU,EAAE,OAAO;AAAA,EACnB,OAAO,EAAE,OAAO;AAAA,EAChB,WAAW,EAAE,OAAO,EAAE,QAAQ;AAAA;AAAA;AAAA;AAAA,EAI9B,MAAM,EAAE,QAAQ,EAAE,SAAS;AAC7B,CAAC;AAIM,MAAM,0BAA0B,EAAE,OAAO;AAAA,EAC9C,SAAS,EAAE,OAAO;AAAA,EAClB,MAAM,EAAE,OAAO;AAAA,EACf,UAAU,EAAE,OAAO;AAAA,EACnB,kBAAkB,EAAE,OAAO;AAC7B,CAAC;AAEM,MAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,UAAU,EAAE,KAAK,CAAC,OAAO,KAAK,CAAC;AAAA,EAC/B,SAAS;AAAA,EACT,UAAU;AAAA,EACV,QAAQ;AACV,CAAC;AAIM,MAAM,aAAa,EAAE,OAAO;AAAA,EACjC,IAAI,EAAE,OAAO;AAAA,EACb,SAAS,EAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,MAAM,EAAE,OAAO;AAAA,EACf,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAKtC,WAAW,EAAE,OAAO,EAAE,QAAQ;AAAA,EAC9B,UAAU,EAAE,KAAK,CAAC,OAAO,KAAK,CAAC,EAAE,SAAS;AAAA,EAC1C,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,mBAAmB,EAAE,OAAO,EAAE,QAAQ,CAAC;AAAA,EACvC,iBAAiB,EAAE,OAAO,EAAE,QAAQ,CAAC;AAAA,EACrC,SAAS,qBAAqB,SAAS;AAAA,EACvC,OAAO,EAAE,MAAM,cAAc,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC;","names":[]}
+{"version":3,"sources":["../../../../src/modules/plans/types/plan.type.ts"],"sourcesContent":["import z from 'zod';\nimport type { BillingPeriod } from '../../subscriptions/types/billing-period.type';\n\nexport const PlanItemSchema = z.object({\n  id_addon: z.number(),\n  quantity: z.number(),\n  value: z.number(),\n  value_usd: z.number().nullish(),\n  // Maior valor positivo por addon = preço base/original (demais linhas são promos).\n  // Derivado por heurística no backend (não há coluna no banco). Ausente em payloads\n  // de cache antigos → optional.\n  base: z.boolean().optional(),\n  // Faixa por volume: a quantidade EXATA para a qual este `value` unitário vale\n  // (créditos de IA em 2.500/5.000/10.000 saem mais baratos por unidade). Ausente/null\n  // = unitário padrão, válido para qualquer quantidade.\n  tier_quantity: z.number().nullish(),\n});\n\nexport type PlanItem = z.infer<typeof PlanItemSchema>;\n\nexport const PlanPeriodPricingSchema = z.object({\n  charged: z.number(),\n  list: z.number(),\n  discount: z.number(),\n  discount_percent: z.number(),\n});\n\nexport const PlanApiPricingSchema = z.object({\n  currency: z.enum(['brl', 'usd']),\n  monthly: PlanPeriodPricingSchema,\n  semester: PlanPeriodPricingSchema,\n  annual: PlanPeriodPricingSchema,\n});\n\nexport type PlanApiPricing = z.infer<typeof PlanApiPricingSchema>;\n\nexport const PlanSchema = z.object({\n  id: z.number(),\n  id_plan: z.number().optional(),\n  name: z.string(),\n  value: z.number().nullable().default(0),\n  // Preço em USD (conta stripe_usd). Operador cadastra no backend; ausente em planos\n  // sem suporte internacional. Backend agora resolve por moeda da conta (customer),\n  // omitindo value_usd para customer requests e adicionando currency. Admin paths\n  // ainda recebem value_usd como número (sem .coerce — backend joga agora como Number).\n  value_usd: z.number().nullish(),\n  currency: z.enum(['brl', 'usd']).optional(),\n  type: z.string().optional(),\n  discount_semester: z.number().default(0),\n  discount_annual: z.number().default(0),\n  pricing: PlanApiPricingSchema.optional(),\n  items: z.array(PlanItemSchema).optional().default([]),\n});\n\nexport type Plan = z.infer<typeof PlanSchema>;\n\n// ── UI Plan types (used by list-plans action and consumers) ──\n\nexport type PlanFeature = {\n  icon: 'check' | 'x';\n  text: string;\n  disabled?: boolean;\n  tooltip?: keyof PlanTooltips;\n};\n\nexport type PlanMainFeatures = {\n  pages: string;\n  domains: string;\n  users: string;\n};\n\n/** Preços mensais equivalentes por período de cobrança (já com desconto aplicado). */\nexport type PlanPricingByPeriod = {\n  monthly: number;\n  semiannual: number;\n  annual: number;\n};\n\nexport type UiPlan = {\n  planId: number;\n  name: string;\n  isPopular?: boolean;\n  isCurrentPlan?: boolean;\n  currentPeriodicity?: BillingPeriod | null;\n  mainFeatures: PlanMainFeatures;\n  features: PlanFeature[];\n  originalPrice: string;\n  price: string;\n  pricingByPeriod?: PlanPricingByPeriod;\n  pricing?: PlanApiPricing;\n  buttonVariant?: 'brand' | 'default';\n  priceUnavailable?: boolean;\n  items: PlanItem[];\n};\n\nexport type PlanTooltips = {\n  domains: string;\n  users: string;\n  sharePages: string;\n  projectManagement: string;\n};\n"],"mappings":"AAAA,OAAO,OAAO;AAGP,MAAM,iBAAiB,EAAE,OAAO;AAAA,EACrC,UAAU,EAAE,OAAO;AAAA,EACnB,UAAU,EAAE,OAAO;AAAA,EACnB,OAAO,EAAE,OAAO;AAAA,EAChB,WAAW,EAAE,OAAO,EAAE,QAAQ;AAAA;AAAA;AAAA;AAAA,EAI9B,MAAM,EAAE,QAAQ,EAAE,SAAS;AAAA;AAAA;AAAA;AAAA,EAI3B,eAAe,EAAE,OAAO,EAAE,QAAQ;AACpC,CAAC;AAIM,MAAM,0BAA0B,EAAE,OAAO;AAAA,EAC9C,SAAS,EAAE,OAAO;AAAA,EAClB,MAAM,EAAE,OAAO;AAAA,EACf,UAAU,EAAE,OAAO;AAAA,EACnB,kBAAkB,EAAE,OAAO;AAC7B,CAAC;AAEM,MAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,UAAU,EAAE,KAAK,CAAC,OAAO,KAAK,CAAC;AAAA,EAC/B,SAAS;AAAA,EACT,UAAU;AAAA,EACV,QAAQ;AACV,CAAC;AAIM,MAAM,aAAa,EAAE,OAAO;AAAA,EACjC,IAAI,EAAE,OAAO;AAAA,EACb,SAAS,EAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,MAAM,EAAE,OAAO;AAAA,EACf,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAKtC,WAAW,EAAE,OAAO,EAAE,QAAQ;AAAA,EAC9B,UAAU,EAAE,KAAK,CAAC,OAAO,KAAK,CAAC,EAAE,SAAS;AAAA,EAC1C,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,mBAAmB,EAAE,OAAO,EAAE,QAAQ,CAAC;AAAA,EACvC,iBAAiB,EAAE,OAAO,EAAE,QAAQ,CAAC;AAAA,EACrC,SAAS,qBAAqB,SAAS;AAAA,EACvC,OAAO,EAAE,MAAM,cAAc,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@greatapps/common",
-  "version": "1.1.755",
+  "version": "1.1.757",
   "description": "Shared library for GreatApps frontend applications",
   "main": "./dist/index.mjs",
   "types": "./src/index.ts",

package/src/infra/api/client.ts

@@ -1,263 +1,309 @@
-import { ApiError } from "./types";
-import { findWhitelabel } from "../../modules/whitelabel/actions/find-whitelabel.action";
-
-export interface ApiClientOptions {
-  /**
-   * Quando true, monta `{base}/{locale}/{wlId}{endpoint}` (ex.: r2-clone).
-   * Padrão false: `{base}/v1/{locale}/{wlId}{endpoint}`.
-   */
-  omitApiVersion?: boolean;
-
-  /** Habilita logs detalhados das requisições (útil para desenvolvimento) */
-  emitLogs?: boolean;
-}
-
-export interface RequestConfig extends RequestInit {
-  timeout?: number;
-  /** Padrão `json`. Use `text` quando a API devolve corpo não-JSON. */
-  responseType?: "json" | "text";
-  /** Força um whiteLabelId específico na URL, ignorando o findWhitelabel(). */
-  whiteLabelId?: number;
-  /** Força um token específico no header Authorization, ignorando o findWhitelabel(). */
-  authToken?: string;
-}
-
-class ApiClient {
-  private readonly baseUrl: string;
-  private readonly apiVersion = "v1";
-  private readonly apiLocale = "pt-br";
-  private readonly omitApiVersion: boolean;
-  private readonly emitLogs: boolean = false;
-
-  constructor(baseUrl: string, options?: ApiClientOptions) {
-    this.baseUrl = baseUrl.replace(/\/$/, "");
-    this.omitApiVersion = options?.omitApiVersion ?? false;
-    this.emitLogs = options?.emitLogs ?? false;
-  }
-
-  private async buildUrl(
-    endpoint: string,
-    whiteLabelId: number,
-  ): Promise<string> {
-    const wlPath = this.omitApiVersion
-      ? `/${this.apiLocale}/${whiteLabelId}`
-      : `/${this.apiVersion}/${this.apiLocale}/${whiteLabelId}`;
-    const path = endpoint.startsWith("/") ? endpoint : `/${endpoint}`;
-    const url = `${this.baseUrl}${wlPath}${path}`;
-    if (this.emitLogs) {
-      console.log("[ApiClient] buildUrl", {
-        baseURL: this.baseUrl,
-        whiteLabelId,
-        endpoint,
-        fullUrl: url,
-      });
-    }
-    return url;
-  }
-
-  private async getDefaultHeaders(
-    token: string,
-    isFormData = false,
-  ): Promise<HeadersInit> {
-    if (this.emitLogs) {
-      console.log("[ApiClient] getDefaultHeaders", {
-        token: token.substring(0, 20) + "...",
-      });
-    }
-
-    const headers: HeadersInit = {
-      authorization: token,
-    };
-
-    if (!isFormData) {
-      headers["Content-Type"] = "application/json";
-    }
-
-    return headers;
-  }
-
-  async request<T>(endpoint: string, config: RequestConfig = {}): Promise<T> {
-    if (this.emitLogs) {
-      console.log("[ApiClient] request called", {
-        endpoint,
-        method: config.method,
-      });
-    }
-
-    const { timeout = 30000, responseType = "json", whiteLabelId: overrideWlId, authToken: overrideToken, ...fetchConfig } = config;
-
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), timeout);
-
-    try {
-      if (this.emitLogs) {
-        console.log("[ApiClient] Building URL and headers...");
-      }
-
-      const { id, token } = await findWhitelabel();
-
-      const [url, defaultHeaders] = await Promise.all([
-        this.buildUrl(endpoint, overrideWlId ?? id),
-        this.getDefaultHeaders(overrideToken ?? token, fetchConfig.body instanceof FormData),
-      ]);
-
-      if (this.emitLogs)
-        console.log("[ApiClient] Fetching", {
-          url,
-          method: fetchConfig.method,
-          headers: defaultHeaders,
-        });
-
-      const response = await fetch(url, {
-        ...fetchConfig,
-        headers: {
-          ...defaultHeaders,
-          ...fetchConfig.headers,
-        },
-        signal: controller.signal,
-      });
-
-      if (this.emitLogs)
-        console.log("[ApiClient] Response received", {
-          status: response.status,
-          ok: response.ok,
-        });
-
-      if (!response.ok) {
-        const errBody = await response.text();
-        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;
-          if (typeof errorData.code === "string") code = errorData.code;
-        } catch {
-          if (errBody.trim()) message = errBody.trim();
-        }
-        const method = fetchConfig.method ?? "GET";
-        let bodyPreview: unknown;
-        if (method !== "GET" && fetchConfig.body != null) {
-          if (typeof fetchConfig.body === "string") {
-            try {
-              bodyPreview = JSON.parse(fetchConfig.body);
-            } catch {
-              bodyPreview = fetchConfig.body;
-            }
-          } else if (fetchConfig.body instanceof FormData) {
-            bodyPreview = "[FormData]";
-          } else {
-            bodyPreview = fetchConfig.body;
-          }
-        }
-        console.error("[ApiClient] Request failed", {
-          from: url,
-          method,
-          ...(bodyPreview !== undefined ? { body: bodyPreview } : {}),
-          status: response.status,
-          message,
-        });
-        throw new ApiError(message, code, response.status);
-      }
-
-      if (responseType === "text") {
-        return (await response.text()) as T;
-      }
-
-      const data = (await response.json()) as T;
-      if (this.emitLogs)
-        console.log("[ApiClient] Request successful", { hasData: !!data });
-      return data;
-    } catch (error) {
-      if (this.emitLogs) console.error("[ApiClient] Request error", { error });
-
-      if (error instanceof ApiError) {
-        throw error;
-      }
-
-      if (error instanceof Error) {
-        if (error.name === "AbortError") {
-          throw new ApiError("Tempo de requisição excedido", "TIMEOUT", 408);
-        }
-        throw new ApiError(error.message, "NETWORK_ERROR", 0);
-      }
-
-      throw new ApiError("Erro desconhecido", "UNKNOWN_ERROR", 500);
-    } finally {
-      clearTimeout(timeoutId);
-    }
-  }
-
-  async get<T>(endpoint: string, config?: RequestConfig): Promise<T> {
-    return this.request<T>(endpoint, { ...config, method: "GET" });
-  }
-
-  async post<T>(
-    endpoint: string,
-    data?: unknown,
-    config?: RequestConfig,
-  ): Promise<T> {
-    return this.request<T>(endpoint, {
-      ...config,
-      method: "POST",
-      body:
-        data instanceof FormData
-          ? data
-          : data
-            ? JSON.stringify(data)
-            : undefined,
-    });
-  }
-
-  async put<T>(
-    endpoint: string,
-    data?: unknown,
-    config?: RequestConfig,
-  ): Promise<T> {
-    return this.request<T>(endpoint, {
-      ...config,
-      method: "PUT",
-      body:
-        data instanceof FormData
-          ? data
-          : data
-            ? JSON.stringify(data)
-            : undefined,
-    });
-  }
-
-  async patch<T>(
-    endpoint: string,
-    data?: unknown,
-    config?: RequestConfig,
-  ): Promise<T> {
-    return this.request<T>(endpoint, {
-      ...config,
-      method: "PATCH",
-      body:
-        data instanceof FormData
-          ? data
-          : data
-            ? JSON.stringify(data)
-            : undefined,
-    });
-  }
-
-  async delete<T>(endpoint: string, config?: RequestConfig): Promise<T> {
-    return this.request<T>(endpoint, { ...config, method: "DELETE" });
-  }
-}
-
-const api = {
-  apps: new ApiClient(
-    process.env.GAPPS_R3_API_URL || "https://r3-api.greatapps.dev.br",
-  ),
-  pages: new ApiClient(
-    process.env.GPAGES_R3_API_URL || "https://r3-api.greatpages.dev.br",
-  ),
-};
-
-/** @deprecated use api.apps */
-export const apiClient = api.apps;
-
-export { api, ApiClient };
+import { ApiError } from "./types";
+import { findWhitelabel } from "../../modules/whitelabel/actions/find-whitelabel.action";
+
+export interface ApiClientOptions {
+  /**
+   * Quando true, monta `{base}/{locale}/{wlId}{endpoint}` (ex.: r2-clone).
+   * Padrão false: `{base}/v1/{locale}/{wlId}{endpoint}`.
+   */
+  omitApiVersion?: boolean;
+
+  /** Habilita logs detalhados das requisições (útil para desenvolvimento) */
+  emitLogs?: boolean;
+}
+
+export interface RequestConfig extends RequestInit {
+  timeout?: number;
+  /** Padrão `json`. Use `text` quando a API devolve corpo não-JSON. */
+  responseType?: "json" | "text";
+  /** Força um whiteLabelId específico na URL, ignorando o findWhitelabel(). */
+  whiteLabelId?: number;
+  /** Força um token específico no header Authorization, ignorando o findWhitelabel(). */
+  authToken?: string;
+}
+
+class ApiClient {
+  private readonly baseUrl: string;
+  private readonly apiVersion = "v1";
+  private readonly apiLocale = "pt-br";
+  private readonly omitApiVersion: boolean;
+  private readonly emitLogs: boolean = false;
+
+  constructor(baseUrl: string, options?: ApiClientOptions) {
+    this.baseUrl = baseUrl.replace(/\/$/, "");
+    this.omitApiVersion = options?.omitApiVersion ?? false;
+    this.emitLogs = options?.emitLogs ?? false;
+  }
+
+  private async buildUrl(
+    endpoint: string,
+    whiteLabelId: number,
+  ): Promise<string> {
+    const wlPath = this.omitApiVersion
+      ? `/${this.apiLocale}/${whiteLabelId}`
+      : `/${this.apiVersion}/${this.apiLocale}/${whiteLabelId}`;
+    const path = endpoint.startsWith("/") ? endpoint : `/${endpoint}`;
+    const url = `${this.baseUrl}${wlPath}${path}`;
+    if (this.emitLogs) {
+      console.log("[ApiClient] buildUrl", {
+        baseURL: this.baseUrl,
+        whiteLabelId,
+        endpoint,
+        fullUrl: url,
+      });
+    }
+    return url;
+  }
+
+  private async getDefaultHeaders(
+    token: string,
+    isFormData = false,
+  ): Promise<HeadersInit> {
+    if (this.emitLogs) {
+      console.log("[ApiClient] getDefaultHeaders", {
+        token: token.substring(0, 20) + "...",
+      });
+    }
+
+    const headers: HeadersInit = {
+      authorization: token,
+    };
+
+    if (!isFormData) {
+      headers["Content-Type"] = "application/json";
+    }
+
+    return headers;
+  }
+
+  async request<T>(endpoint: string, config: RequestConfig = {}): Promise<T> {
+    if (this.emitLogs) {
+      console.log("[ApiClient] request called", {
+        endpoint,
+        method: config.method,
+      });
+    }
+
+    const { timeout = 30000, responseType = "json", whiteLabelId: overrideWlId, authToken: overrideToken, ...fetchConfig } = config;
+
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+
+    try {
+      if (this.emitLogs) {
+        console.log("[ApiClient] Building URL and headers...");
+      }
+
+      const { id, token } = await findWhitelabel();
+
+      const [url, defaultHeaders] = await Promise.all([
+        this.buildUrl(endpoint, overrideWlId ?? id),
+        this.getDefaultHeaders(overrideToken ?? token, fetchConfig.body instanceof FormData),
+      ]);
+
+      if (this.emitLogs)
+        console.log("[ApiClient] Fetching", {
+          url,
+          method: fetchConfig.method,
+          headers: defaultHeaders,
+        });
+
+      const response = await fetch(url, {
+        ...fetchConfig,
+        headers: {
+          ...defaultHeaders,
+          ...fetchConfig.headers,
+        },
+        signal: controller.signal,
+      });
+
+      if (this.emitLogs)
+        console.log("[ApiClient] Response received", {
+          status: response.status,
+          ok: response.ok,
+        });
+
+      if (!response.ok) {
+        const errBody = await response.text();
+        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;
+          if (typeof errorData.code === "string") code = errorData.code;
+        } catch {
+          if (errBody.trim()) message = errBody.trim();
+        }
+        const method = fetchConfig.method ?? "GET";
+        let bodyPreview: unknown;
+        if (method !== "GET" && fetchConfig.body != null) {
+          if (typeof fetchConfig.body === "string") {
+            try {
+              bodyPreview = JSON.parse(fetchConfig.body);
+            } catch {
+              bodyPreview = fetchConfig.body;
+            }
+          } else if (fetchConfig.body instanceof FormData) {
+            bodyPreview = "[FormData]";
+          } else {
+            bodyPreview = fetchConfig.body;
+          }
+        }
+        console.error("[ApiClient] Request failed", {
+          from: url,
+          method,
+          ...(bodyPreview !== undefined ? { body: bodyPreview } : {}),
+          status: response.status,
+          message,
+        });
+        throw new ApiError(message, code, response.status);
+      }
+
+      if (responseType === "text") {
+        return (await response.text()) as T;
+      }
+
+      const data = (await response.json()) as T;
+      if (this.emitLogs)
+        console.log("[ApiClient] Request successful", { hasData: !!data });
+      return data;
+    } catch (error) {
+      if (this.emitLogs) console.error("[ApiClient] Request error", { error });
+
+      if (error instanceof ApiError) {
+        throw error;
+      }
+
+      if (error instanceof Error) {
+        if (error.name === "AbortError") {
+          throw new ApiError("Tempo de requisição excedido", "TIMEOUT", 408);
+        }
+        throw new ApiError(error.message, "NETWORK_ERROR", 0);
+      }
+
+      throw new ApiError("Erro desconhecido", "UNKNOWN_ERROR", 500);
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+
+  async get<T>(endpoint: string, config?: RequestConfig): Promise<T> {
+    return this.request<T>(endpoint, { ...config, method: "GET" });
+  }
+
+  async post<T>(
+    endpoint: string,
+    data?: unknown,
+    config?: RequestConfig,
+  ): Promise<T> {
+    return this.request<T>(endpoint, {
+      ...config,
+      method: "POST",
+      body:
+        data instanceof FormData
+          ? data
+          : data
+            ? JSON.stringify(data)
+            : undefined,
+    });
+  }
+
+  async put<T>(
+    endpoint: string,
+    data?: unknown,
+    config?: RequestConfig,
+  ): Promise<T> {
+    return this.request<T>(endpoint, {
+      ...config,
+      method: "PUT",
+      body:
+        data instanceof FormData
+          ? data
+          : data
+            ? JSON.stringify(data)
+            : undefined,
+    });
+  }
+
+  async patch<T>(
+    endpoint: string,
+    data?: unknown,
+    config?: RequestConfig,
+  ): Promise<T> {
+    return this.request<T>(endpoint, {
+      ...config,
+      method: "PATCH",
+      body:
+        data instanceof FormData
+          ? data
+          : data
+            ? JSON.stringify(data)
+            : undefined,
+    });
+  }
+
+  async delete<T>(endpoint: string, config?: RequestConfig): Promise<T> {
+    return this.request<T>(endpoint, { ...config, method: "DELETE" });
+  }
+
+  /**
+   * Requisição cuja resposta é consumida em stream: devolve a `Response` crua, sem ler o
+   * corpo e sem timeout.
+   *
+   * `request()` não serve para isso por dois motivos. Ele faz `await response.json()`, o
+   * que espera o corpo inteiro e mata o propósito do stream; e aborta em 30s, que é o
+   * tempo que uma operação longa leva justamente por ser longa — gerar o link de uma
+   * página com 132 imagens copia 100 MB e passa disso (ID-5112).
+   *
+   * O corpo é do chamador: quem recebe decide quando ler e quando cancelar.
+   */
+  async stream(endpoint: string, config: RequestConfig = {}): Promise<Response> {
+    const { timeout: _timeout, responseType: _responseType, whiteLabelId: overrideWlId, authToken: overrideToken, ...fetchConfig } = config;
+
+    // Só resolve o whitelabel quando falta algum dos dois: com ambos vindos do chamador, a
+    // consulta seria uma ida à rede para descartar o resultado.
+    const resolvido = overrideWlId != null && overrideToken != null
+      ? { id: overrideWlId, token: overrideToken }
+      : await findWhitelabel();
+
+    const [url, defaultHeaders] = await Promise.all([
+      this.buildUrl(endpoint, overrideWlId ?? resolvido.id),
+      this.getDefaultHeaders(overrideToken ?? resolvido.token),
+    ]);
+
+    const response = await fetch(url, {
+      ...fetchConfig,
+      headers: { ...defaultHeaders, ...fetchConfig.headers },
+      // Sem isto o fetch do Next segura o corpo inteiro antes de devolver, e o stream chega
+      // completo de uma vez no fim: medido em 32s até o primeiro evento, contra 0,4s com
+      // no-store. O progresso existiria no protocolo e não na tela.
+      cache: "no-store",
+    });
+
+    if (!response.ok || !response.body) {
+      const detalhe = await response.text().catch(() => "");
+      throw new ApiError(
+        detalhe.trim() || `HTTP error ${response.status} ${response.statusText}`,
+        "HTTP_ERROR",
+        response.status,
+      );
+    }
+
+    return response;
+  }
+}
+
+const api = {
+  apps: new ApiClient(
+    process.env.GAPPS_R3_API_URL || "https://r3-api.greatapps.dev.br",
+  ),
+  pages: new ApiClient(
+    process.env.GPAGES_R3_API_URL || "https://r3-api.greatpages.dev.br",
+  ),
+};
+
+/** @deprecated use api.apps */
+export const apiClient = api.apps;
+
+export { api, ApiClient };

package/src/modules/plans/types/plan.type.ts

@@ -10,6 +10,10 @@ export const PlanItemSchema = z.object({
   // Derivado por heurística no backend (não há coluna no banco). Ausente em payloads
   // de cache antigos → optional.
   base: z.boolean().optional(),
+  // Faixa por volume: a quantidade EXATA para a qual este `value` unitário vale
+  // (créditos de IA em 2.500/5.000/10.000 saem mais baratos por unidade). Ausente/null
+  // = unitário padrão, válido para qualquer quantidade.
+  tier_quantity: z.number().nullish(),
 });
 
 export type PlanItem = z.infer<typeof PlanItemSchema>;