evo360-types 1.3.809 → 1.3.814

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -11,11 +11,49 @@ export interface SearchThreadsParams {
11
11
  closed_by_user_id?: string;
12
12
  close_codes?: string[];
13
13
  tag_ids?: string[];
14
- /** Free-text contains-match against contact_name (case-insensitive) OR contact_address (digits/email/etc). */
14
+ /**
15
+ * Free-text contains-match. Com `search_scope` ausente ou 'contact': contact_name
16
+ * (case-insensitive) OR contact_address (digits/email/etc). Com 'message': o texto
17
+ * das mensagens da conversa (ver `SearchScope`).
18
+ */
15
19
  search?: string;
20
+ /** feat-350 — onde o `search` procura. Ausente = 'contact' (comportamento anterior). */
21
+ search_scope?: SearchScope;
16
22
  cursor?: string;
17
23
  limit?: number;
18
24
  }
25
+ /**
26
+ * feat-350 — escopo do campo de busca.
27
+ *
28
+ * - 'contact': nome e endereço do contato (padrão).
29
+ * - 'message' (BETA): texto das mensagens do tenant na janela — texto, nota interna,
30
+ * legenda de mídia e transcrição de áudio. Template HSM fica fora (o mesmo texto vai
31
+ * para centenas de pacientes). Exige `MESSAGE_SEARCH_MIN_CHARS` caracteres.
32
+ */
33
+ export type SearchScope = 'contact' | 'message';
34
+ /** feat-350 — mínimo de caracteres (depois de aparar) para buscar no texto das mensagens. */
35
+ export declare const MESSAGE_SEARCH_MIN_CHARS = 3;
36
+ /** feat-350 — de onde veio o texto que casou. */
37
+ export type MatchedMessageSource = 'text' | 'note' | 'caption' | 'transcript';
38
+ /**
39
+ * feat-350 — a mensagem MAIS RECENTE da conversa que casou com a busca no modo
40
+ * 'message', já recortada em volta do termo para caber na linha da lista.
41
+ */
42
+ export interface ThreadMatchedMessage {
43
+ firestore_message_id: string;
44
+ /** ISO. */
45
+ occurred_at: string;
46
+ direction: 'in' | 'out' | 'internal';
47
+ source: MatchedMessageSource;
48
+ /** ~140 caracteres em volta do termo, com "…" onde o texto foi cortado. */
49
+ snippet: string;
50
+ /** Posição do termo dentro de `snippet` (para destacar). */
51
+ match_start: number;
52
+ /** Comprimento do termo dentro de `snippet`; 0 = não localizado no recorte. */
53
+ match_length: number;
54
+ /** Mensagens da conversa que casaram, na janela. */
55
+ match_count: number;
56
+ }
19
57
  /**
20
58
  * Janela de datas efetivamente usada na consulta.
21
59
  *
@@ -78,6 +116,8 @@ export interface ThreadAggregate {
78
116
  contact?: ThreadAggregateContact;
79
117
  tags?: ThreadAggregateTag[];
80
118
  current_open_ticket?: ThreadAggregateCurrentOpenTicket | null;
119
+ /** feat-350 — só no modo `search_scope: 'message'`. */
120
+ matched_message?: ThreadMatchedMessage | null;
81
121
  }
82
122
  export interface SearchThreadsStats {
83
123
  bq_query_id?: string;
@@ -141,7 +181,9 @@ export interface SearchFacetsResponse {
141
181
  applied_window: AppliedWindow;
142
182
  stats: SearchFacetsStats;
143
183
  }
144
- export type SearchThreadsErrorCode = 'invalid_filter' | 'tag_filter_too_broad' | 'forbidden' | 'bq_error' | 'fs_error';
184
+ export type SearchThreadsErrorCode = 'invalid_filter' | 'tag_filter_too_broad'
185
+ /** feat-350 — modo 'message' com menos de MESSAGE_SEARCH_MIN_CHARS caracteres. */
186
+ | 'search_too_short' | 'forbidden' | 'bq_error' | 'fs_error';
145
187
  export interface SearchThreadsErrorResponse {
146
188
  ok: false;
147
189
  error: string;
@@ -4,3 +4,6 @@
4
4
  // for top-N. Timeline endpoint UNION-ALLs events + messages_raw +
5
5
  // message_statuses + message_reactions for a single contact (archive use case).
6
6
  Object.defineProperty(exports, "__esModule", { value: true });
7
+ exports.MESSAGE_SEARCH_MIN_CHARS = void 0;
8
+ /** feat-350 — mínimo de caracteres (depois de aparar) para buscar no texto das mensagens. */
9
+ exports.MESSAGE_SEARCH_MIN_CHARS = 3;
@@ -18,12 +18,54 @@ export interface SearchThreadsParams {
18
18
  closed_by_user_id?: string;
19
19
  close_codes?: string[];
20
20
  tag_ids?: string[];
21
- /** Free-text contains-match against contact_name (case-insensitive) OR contact_address (digits/email/etc). */
21
+ /**
22
+ * Free-text contains-match. Com `search_scope` ausente ou 'contact': contact_name
23
+ * (case-insensitive) OR contact_address (digits/email/etc). Com 'message': o texto
24
+ * das mensagens da conversa (ver `SearchScope`).
25
+ */
22
26
  search?: string;
27
+ /** feat-350 — onde o `search` procura. Ausente = 'contact' (comportamento anterior). */
28
+ search_scope?: SearchScope;
23
29
  cursor?: string;
24
30
  limit?: number;
25
31
  }
26
32
 
33
+ /**
34
+ * feat-350 — escopo do campo de busca.
35
+ *
36
+ * - 'contact': nome e endereço do contato (padrão).
37
+ * - 'message' (BETA): texto das mensagens do tenant na janela — texto, nota interna,
38
+ * legenda de mídia e transcrição de áudio. Template HSM fica fora (o mesmo texto vai
39
+ * para centenas de pacientes). Exige `MESSAGE_SEARCH_MIN_CHARS` caracteres.
40
+ */
41
+ export type SearchScope = 'contact' | 'message';
42
+
43
+ /** feat-350 — mínimo de caracteres (depois de aparar) para buscar no texto das mensagens. */
44
+ export const MESSAGE_SEARCH_MIN_CHARS = 3;
45
+
46
+ /** feat-350 — de onde veio o texto que casou. */
47
+ export type MatchedMessageSource = 'text' | 'note' | 'caption' | 'transcript';
48
+
49
+ /**
50
+ * feat-350 — a mensagem MAIS RECENTE da conversa que casou com a busca no modo
51
+ * 'message', já recortada em volta do termo para caber na linha da lista.
52
+ */
53
+ export interface ThreadMatchedMessage {
54
+ firestore_message_id: string;
55
+ /** ISO. */
56
+ occurred_at: string;
57
+ direction: 'in' | 'out' | 'internal';
58
+ source: MatchedMessageSource;
59
+ /** ~140 caracteres em volta do termo, com "…" onde o texto foi cortado. */
60
+ snippet: string;
61
+ /** Posição do termo dentro de `snippet` (para destacar). */
62
+ match_start: number;
63
+ /** Comprimento do termo dentro de `snippet`; 0 = não localizado no recorte. */
64
+ match_length: number;
65
+ /** Mensagens da conversa que casaram, na janela. */
66
+ match_count: number;
67
+ }
68
+
27
69
  /**
28
70
  * Janela de datas efetivamente usada na consulta.
29
71
  *
@@ -91,6 +133,8 @@ export interface ThreadAggregate {
91
133
  contact?: ThreadAggregateContact;
92
134
  tags?: ThreadAggregateTag[];
93
135
  current_open_ticket?: ThreadAggregateCurrentOpenTicket | null;
136
+ /** feat-350 — só no modo `search_scope: 'message'`. */
137
+ matched_message?: ThreadMatchedMessage | null;
94
138
  }
95
139
 
96
140
  export interface SearchThreadsStats {
@@ -172,6 +216,8 @@ export interface SearchFacetsResponse {
172
216
  export type SearchThreadsErrorCode =
173
217
  | 'invalid_filter'
174
218
  | 'tag_filter_too_broad'
219
+ /** feat-350 — modo 'message' com menos de MESSAGE_SEARCH_MIN_CHARS caracteres. */
220
+ | 'search_too_short'
175
221
  | 'forbidden'
176
222
  | 'bq_error'
177
223
  | 'fs_error';
@@ -1,6 +1,7 @@
1
1
  import type { NexFinopsBillingMode } from './billing-statement';
2
2
  import type { IFireGlobalDoc } from '../../shared';
3
3
  import type { NexVendasContractType } from '../../nex-vendas/adhesion';
4
+ import type { INexVendasPackageModule } from '../../nex-vendas/offer-package';
4
5
  /**
5
6
  * `cancellation_requested`: o cliente pediu o cancelamento e o contrato está em
6
7
  * processo de encerramento — mas **continua em vigência** e continua faturando
@@ -228,6 +229,15 @@ export interface INexFinopsContract extends IFireGlobalDoc {
228
229
  * (validação de escrita entra na F5; até lá o campo só é lido).
229
230
  */
230
231
  billing_mode?: NexFinopsBillingMode;
232
+ /**
233
+ * Snapshot dos módulos vendidos (cópia de `proposal.package.modules`).
234
+ * Presente ⇒ o runner da feat-297 trata como AUTORITATIVO (liga só os
235
+ * `enabled`, exclui defaults desligados, aplica `capabilities`). Ausente =
236
+ * defaults do catálogo (comportamento anterior). Mudar não re-provisiona.
237
+ */
238
+ package_modules?: Record<string, INexVendasPackageModule> | null;
239
+ /** Slug da oferta de origem (auditoria/relatório). Ausente = contrato sem oferta. */
240
+ offer_slug?: string | null;
231
241
  }
232
242
  export declare const NEX_FINOPS_CONTRACT_STATUS_TRANSITIONS: Record<NexFinopsContractStatus, NexFinopsContractStatus[]>;
233
243
  /**
@@ -1,6 +1,7 @@
1
1
  import type { NexFinopsBillingMode } from './billing-statement';
2
2
  import type { IFireGlobalDoc } from '../../shared';
3
3
  import type { NexVendasContractType } from '../../nex-vendas/adhesion';
4
+ import type { INexVendasPackageModule } from '../../nex-vendas/offer-package';
4
5
 
5
6
  // ── Status & Recurrence ──
6
7
 
@@ -269,6 +270,18 @@ export interface INexFinopsContract extends IFireGlobalDoc {
269
270
  * (validação de escrita entra na F5; até lá o campo só é lido).
270
271
  */
271
272
  billing_mode?: NexFinopsBillingMode;
273
+
274
+ // ── Pacote da oferta (feat-353) ──
275
+
276
+ /**
277
+ * Snapshot dos módulos vendidos (cópia de `proposal.package.modules`).
278
+ * Presente ⇒ o runner da feat-297 trata como AUTORITATIVO (liga só os
279
+ * `enabled`, exclui defaults desligados, aplica `capabilities`). Ausente =
280
+ * defaults do catálogo (comportamento anterior). Mudar não re-provisiona.
281
+ */
282
+ package_modules?: Record<string, INexVendasPackageModule> | null;
283
+ /** Slug da oferta de origem (auditoria/relatório). Ausente = contrato sem oferta. */
284
+ offer_slug?: string | null;
272
285
  }
273
286
 
274
287
  // ── Status transitions ──
@@ -1,6 +1,7 @@
1
1
  import type { IFireGlobalDoc } from '../../shared';
2
2
  import type { NexVendasContractType } from '../../nex-vendas/adhesion';
3
3
  import type { INexVendasAttribution } from '../../nex-vendas/offer';
4
+ import type { INexVendasOfferPackage, INexVendasPackageDisplay } from '../../nex-vendas/offer-package';
4
5
  /**
5
6
  * `viewed` é carimbado pelo endpoint público no primeiro acesso ao `short_code`.
6
7
  * `expired` é **derivado** de `valid_until` na leitura (não há cron): o documento
@@ -111,6 +112,12 @@ export interface INexFinopsProposal extends IFireGlobalDoc {
111
112
  * para a proposta gerada por oferta. Ausente em propostas anteriores à feat-326.
112
113
  */
113
114
  created_by?: string | null;
115
+ /**
116
+ * Cópia CONGELADA de `offer.package` no `start`. Só o backend grava (como
117
+ * `offer_slug`): NÃO entra no `zNexFinopsProposalWriteSchema`. Ausente =
118
+ * proposta sem pacote (vendedor ou oferta v1).
119
+ */
120
+ package?: INexVendasOfferPackage | null;
114
121
  }
115
122
  /** O que o endpoint sem auth expõe. Sem ids internos, sem dado sensível. */
116
123
  export interface INexFinopsProposalPublic {
@@ -160,6 +167,12 @@ export interface INexFinopsProposalPublic {
160
167
  prefill_masked: {
161
168
  name: string | null;
162
169
  };
170
+ /**
171
+ * feat-353 — pacote pronto para exibir, do snapshot da proposta + tabela de preço
172
+ * resolvida NA LEITURA (o contrato é atrelado à tabela, não congela). Ausente/null =
173
+ * proposta sem pacote ou backend anterior à feat-353.
174
+ */
175
+ package_display?: INexVendasPackageDisplay | null;
163
176
  }
164
177
  /** Mesmos campos de `INexFinopsProposalPrefill`, cada um `null` quando ausente. */
165
178
  export interface INexFinopsProposalPublicPrefill {
@@ -1,6 +1,7 @@
1
1
  import type { IFireGlobalDoc } from '../../shared';
2
2
  import type { NexVendasContractType } from '../../nex-vendas/adhesion';
3
3
  import type { INexVendasAttribution } from '../../nex-vendas/offer';
4
+ import type { INexVendasOfferPackage, INexVendasPackageDisplay } from '../../nex-vendas/offer-package';
4
5
 
5
6
  // ── Status, origem e formas de pagamento ──
6
7
 
@@ -147,6 +148,15 @@ export interface INexFinopsProposal extends IFireGlobalDoc {
147
148
  * para a proposta gerada por oferta. Ausente em propostas anteriores à feat-326.
148
149
  */
149
150
  created_by?: string | null;
151
+
152
+ // ── Pacote (feat-353) ──
153
+
154
+ /**
155
+ * Cópia CONGELADA de `offer.package` no `start`. Só o backend grava (como
156
+ * `offer_slug`): NÃO entra no `zNexFinopsProposalWriteSchema`. Ausente =
157
+ * proposta sem pacote (vendedor ou oferta v1).
158
+ */
159
+ package?: INexVendasOfferPackage | null;
150
160
  }
151
161
 
152
162
  // ── Projeção pública ──
@@ -197,6 +207,12 @@ export interface INexFinopsProposalPublic {
197
207
  * ainda não lê `prefill`.
198
208
  */
199
209
  prefill_masked: { name: string | null };
210
+ /**
211
+ * feat-353 — pacote pronto para exibir, do snapshot da proposta + tabela de preço
212
+ * resolvida NA LEITURA (o contrato é atrelado à tabela, não congela). Ausente/null =
213
+ * proposta sem pacote ou backend anterior à feat-353.
214
+ */
215
+ package_display?: INexVendasPackageDisplay | null;
200
216
  }
201
217
 
202
218
  /** Mesmos campos de `INexFinopsProposalPrefill`, cada um `null` quando ausente. */
@@ -2,3 +2,4 @@ export * from './journey';
2
2
  export * from './adhesion';
3
3
  export * from './notifications';
4
4
  export * from './offer';
5
+ export * from './offer-package';
@@ -18,3 +18,4 @@ __exportStar(require("./journey"), exports);
18
18
  __exportStar(require("./adhesion"), exports);
19
19
  __exportStar(require("./notifications"), exports);
20
20
  __exportStar(require("./offer"), exports);
21
+ __exportStar(require("./offer-package"), exports);
@@ -2,3 +2,4 @@ export * from './journey';
2
2
  export * from './adhesion';
3
3
  export * from './notifications';
4
4
  export * from './offer';
5
+ export * from './offer-package';
@@ -0,0 +1,165 @@
1
+ import type { INexFinopsContractAllowance } from '../evo-finops/common/contract';
2
+ import type { ResolvedPriceTable } from '../evo-finops/common/price-table';
3
+ /** Estado de um módulo do catálogo (`PLATFORM_MODULE_CATALOG`) no pacote. */
4
+ export interface INexVendasPackageModule {
5
+ enabled: boolean;
6
+ /**
7
+ * Só chaves de `def.capabilities`, com o tipo do default (validado no backend).
8
+ * Ausente/null = defaults do catálogo. Merge raso sobre os defaults.
9
+ */
10
+ capabilities?: Record<string, boolean | number | string> | null;
11
+ }
12
+ /** Franquia só de apresentação (NÃO vai ao contrato). Ex.: atendimentos humanos 500. */
13
+ export interface INexVendasPackageDisplayAllowance {
14
+ /** Chave do `NexFinopsMetricCatalog`. Não pode repetir chave de `allowances` (backend). */
15
+ metric: string;
16
+ included: number;
17
+ }
18
+ /**
19
+ * Pacote comercial da oferta (feat-328 Q1 "oferta = pacote"). A proposta guarda
20
+ * cópia congelada; o contrato recebe só parâmetros comerciais (allowances,
21
+ * price_table_id, item fixo, package_modules).
22
+ *
23
+ * Regras de negócio (todos os módulos do catálogo declarados, capability válida,
24
+ * franquia de módulo desligado, `list_amount > base_amount`, categoria ≠ `SSR`…)
25
+ * ficam no backend (`validateOfferPackage`); o zod só confere a forma.
26
+ */
27
+ export interface INexVendasOfferPackage {
28
+ /** Tabela que precifica excedente e adicionais. Contrato ATRELADO (não congela). */
29
+ price_table_id: string;
30
+ /** Preço "de" — SÓ apresentação (shop, quadro). Contrato/Asaas usam `base_amount`. Deve ser > base_amount. */
31
+ list_amount?: number | null;
32
+ /**
33
+ * Categoria `billing_services` do item fixo (`services[0]` do contrato).
34
+ * Nunca `SSR` (viraria base de atendimentos no extrato). Ausente = `APPHM`
35
+ * (`NEX_VENDAS_PACKAGE_DEFAULT_FIXED_SERVICE_CATEGORY`).
36
+ */
37
+ fixed_service_category?: string | null;
38
+ /** Descrição do item fixo (linha da cobrança/NFS-e). Ausente = `offer.name`. */
39
+ fixed_service_description?: string | null;
40
+ /** TODO módulo do catálogo declarado (ligado ou desligado) — validação D13 no backend. */
41
+ modules: Record<string, INexVendasPackageModule>;
42
+ /** Franquias APLICADAS — mesmo formato/zod do contrato; vão para `contract.allowances`. */
43
+ allowances: Record<string, INexFinopsContractAllowance>;
44
+ /** Franquias EXIBIDAS — só apresentação (o contrato não recebe). */
45
+ display_allowances?: INexVendasPackageDisplayAllowance[] | null;
46
+ /** Itens fora do pacote que não são módulo (ex.: "Secretárias Hub Médica"). */
47
+ not_included?: string[] | null;
48
+ /** Destaques curtos do card (opcional). */
49
+ highlights?: string[] | null;
50
+ }
51
+ /** Módulo incluído no pacote, pronto para exibir. */
52
+ export interface INexVendasPackageDisplayModule {
53
+ key: string;
54
+ label: string;
55
+ /** Sub-opções LIGADAS, em texto do cliente ("gravação", "transcrição"). */
56
+ details: string[];
57
+ }
58
+ /** Módulo fora do pacote. */
59
+ export interface INexVendasPackageDisplayExcludedModule {
60
+ key: string;
61
+ label: string;
62
+ }
63
+ /** Franquia por extenso. `applied: false` = só exibida (não vai ao contrato, sem excedente). */
64
+ export interface INexVendasPackageDisplayAllowanceItem {
65
+ metric: string;
66
+ included: number;
67
+ /** "100 atendimentos com a HubIA". */
68
+ text: string;
69
+ applied: boolean;
70
+ }
71
+ /** Preço do excedente de uma métrica com franquia APLICADA. */
72
+ export interface INexVendasPackageDisplayExcess {
73
+ metric: string;
74
+ unit_price: number;
75
+ /** "R$ 1,45 por atendimento com a HubIA". */
76
+ text: string;
77
+ }
78
+ /** Adicional opcional (upsell): módulo DESLIGADO no pacote com linha `recurring` na tabela. */
79
+ export interface INexVendasPackageDisplayAddon {
80
+ key: string;
81
+ label: string;
82
+ /** Valor mensal (BRL). */
83
+ amount: number;
84
+ }
85
+ /** Projeção pronta para exibir — mesma função para shop, proposta pública e quadro. */
86
+ export interface INexVendasPackageDisplay {
87
+ list_amount: number | null;
88
+ /** Inteiro, derivado: round((list - base) / list × 100). null sem `list_amount` (ou list ≤ base). */
89
+ discount_percent: number | null;
90
+ modules_included: INexVendasPackageDisplayModule[];
91
+ modules_excluded: INexVendasPackageDisplayExcludedModule[];
92
+ /** Aplicadas + exibidas, na ordem fixa de `NEX_VENDAS_PACKAGE_ALLOWANCE_TEXT`. */
93
+ allowances: INexVendasPackageDisplayAllowanceItem[];
94
+ /** Excedente das métricas com franquia APLICADA, da tabela resolvida. Vazio sem tabela. */
95
+ excess: INexVendasPackageDisplayExcess[];
96
+ /** Adicionais opcionais (NFS-e 55, Prontuário 175 na `calFvw`). Vazio sem tabela. */
97
+ addons: INexVendasPackageDisplayAddon[];
98
+ not_included: string[];
99
+ highlights: string[];
100
+ }
101
+ /** Item fixo do contrato quando o pacote não informa: "Acesso a plataforma de atendimento". */
102
+ export declare const NEX_VENDAS_PACKAGE_DEFAULT_FIXED_SERVICE_CATEGORY = "APPHM";
103
+ /**
104
+ * Categorias proibidas no item fixo do pacote. `SSR` vira `ssr_base` no extrato e
105
+ * liga a regra regressiva de atendimentos (`billing-statement-compute.ts`).
106
+ */
107
+ export declare const NEX_VENDAS_PACKAGE_FORBIDDEN_FIXED_SERVICE_CATEGORIES: readonly string[];
108
+ /**
109
+ * Rótulos para o CLIENTE (glossário da fix-352), separados dos rótulos de
110
+ * catálogo/Nexus (`PLATFORM_MODULE_CATALOG[k].label`). Módulo sem rótulo aqui
111
+ * cai no rótulo do catálogo.
112
+ */
113
+ export declare const NEX_VENDAS_PACKAGE_MODULE_LABELS: Readonly<Record<string, string>>;
114
+ /**
115
+ * Sub-opções exibidas ao cliente quando LIGADAS. Capability fora deste mapa não
116
+ * aparece (ex.: `auto_admit`, detalhe operacional).
117
+ */
118
+ export declare const NEX_VENDAS_PACKAGE_CAPABILITY_LABELS: Readonly<Record<string, Readonly<Record<string, string>>>>;
119
+ /**
120
+ * Texto por extenso das franquias (`{n}` = quantidade). A ORDEM de declaração é
121
+ * a ordem fixa de exibição. Métrica fora daqui vai para o fim, na ordem do
122
+ * `NexFinopsMetricCatalog`, com texto genérico ("Rótulo: n").
123
+ *
124
+ * O texto do excedente reaproveita `one` sem o `{n}`: "R$ 1,45 por atendimento com a HubIA".
125
+ */
126
+ export declare const NEX_VENDAS_PACKAGE_ALLOWANCE_TEXT: Readonly<Record<string, {
127
+ one: string;
128
+ other: string;
129
+ }>>;
130
+ /**
131
+ * Mapa métrica → módulo para as métricas SEM `allowance_metrics` no catálogo
132
+ * (o catálogo só declara `teleconsultations_unrecorded` na telemedicina). Use
133
+ * `getPackageMetricModule`, que consulta o catálogo primeiro.
134
+ * Métrica sem módulo (atendimentos, SMS, e-mail) não aparece aqui.
135
+ */
136
+ export declare const NEX_VENDAS_PACKAGE_METRIC_MODULE: Readonly<Record<string, string>>;
137
+ /**
138
+ * Módulo do catálogo do qual a métrica depende (`allowance_metrics` do catálogo,
139
+ * depois `NEX_VENDAS_PACKAGE_METRIC_MODULE`). null = métrica sem módulo.
140
+ * Usado pelo backend na regra `package_allowance_module_off`.
141
+ */
142
+ export declare function getPackageMetricModule(metric: string): string | null;
143
+ /** Rótulo do módulo para o cliente (mapa do cliente → catálogo → chave). */
144
+ export declare function getPackageModuleLabel(key: string): string;
145
+ /** "R$ 1,45" / "R$ 1.234,50" — determinístico, sem depender do ICU do runtime. */
146
+ export declare function formatPackageBRL(amount: number): string;
147
+ /** Texto por extenso da franquia ("100 atendimentos com a HubIA"). */
148
+ export declare function formatPackageAllowanceText(metric: string, included: number): string;
149
+ /**
150
+ * Projeção do pacote para exibir. Função PURA (sem Firestore): o backend resolve
151
+ * a tabela (`resolvePriceTableLines(tables, pkg.price_table_id)`) e chama; o
152
+ * shop/Nexus só exibem o resultado (`package_display`).
153
+ *
154
+ * - `resolved: null` (tabela não resolveu) ⇒ `excess` e `addons` vazios; o resto sai igual.
155
+ * - Excedente: só métrica com franquia APLICADA e linha `usage` resolvida
156
+ * (`disabled`/ausente não aparece). Teto por faixas (`cap`) não é exibido.
157
+ * - Adicionais: só módulo declarado `enabled: false` com linha `recurring` resolvida.
158
+ * - Sub-opções: capabilities efetivas (default do catálogo + override do pacote)
159
+ * que estão `true` e têm rótulo em `NEX_VENDAS_PACKAGE_CAPABILITY_LABELS`.
160
+ */
161
+ export declare function buildPackageDisplay(input: {
162
+ pkg: INexVendasOfferPackage;
163
+ base_amount: number;
164
+ resolved: ResolvedPriceTable | null;
165
+ }): INexVendasPackageDisplay;