evo360-types 1.3.811 → 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.
@@ -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;
@@ -0,0 +1,255 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.NEX_VENDAS_PACKAGE_METRIC_MODULE = exports.NEX_VENDAS_PACKAGE_ALLOWANCE_TEXT = exports.NEX_VENDAS_PACKAGE_CAPABILITY_LABELS = exports.NEX_VENDAS_PACKAGE_MODULE_LABELS = exports.NEX_VENDAS_PACKAGE_FORBIDDEN_FIXED_SERVICE_CATEGORIES = exports.NEX_VENDAS_PACKAGE_DEFAULT_FIXED_SERVICE_CATEGORY = void 0;
4
+ exports.getPackageMetricModule = getPackageMetricModule;
5
+ exports.getPackageModuleLabel = getPackageModuleLabel;
6
+ exports.formatPackageBRL = formatPackageBRL;
7
+ exports.formatPackageAllowanceText = formatPackageAllowanceText;
8
+ exports.buildPackageDisplay = buildPackageDisplay;
9
+ const contract_1 = require("../evo-finops/common/contract");
10
+ const catalog_1 = require("../evo-modules/catalog");
11
+ // ── Constantes ──
12
+ /** Item fixo do contrato quando o pacote não informa: "Acesso a plataforma de atendimento". */
13
+ exports.NEX_VENDAS_PACKAGE_DEFAULT_FIXED_SERVICE_CATEGORY = 'APPHM';
14
+ /**
15
+ * Categorias proibidas no item fixo do pacote. `SSR` vira `ssr_base` no extrato e
16
+ * liga a regra regressiva de atendimentos (`billing-statement-compute.ts`).
17
+ */
18
+ exports.NEX_VENDAS_PACKAGE_FORBIDDEN_FIXED_SERVICE_CATEGORIES = ['SSR'];
19
+ /**
20
+ * Rótulos para o CLIENTE (glossário da fix-352), separados dos rótulos de
21
+ * catálogo/Nexus (`PLATFORM_MODULE_CATALOG[k].label`). Módulo sem rótulo aqui
22
+ * cai no rótulo do catálogo.
23
+ */
24
+ exports.NEX_VENDAS_PACKAGE_MODULE_LABELS = {
25
+ telemedicine: 'Virtual Care (teleconsulta)',
26
+ campaigns: 'Campanhas',
27
+ automation: 'Automação',
28
+ nfse: 'Notas fiscais',
29
+ csq: 'CSQ — qualidade do atendimento',
30
+ emr: 'Prontuário eletrônico',
31
+ };
32
+ /**
33
+ * Sub-opções exibidas ao cliente quando LIGADAS. Capability fora deste mapa não
34
+ * aparece (ex.: `auto_admit`, detalhe operacional).
35
+ */
36
+ exports.NEX_VENDAS_PACKAGE_CAPABILITY_LABELS = {
37
+ telemedicine: { recording: 'gravação', transcription: 'transcrição' },
38
+ };
39
+ /**
40
+ * Texto por extenso das franquias (`{n}` = quantidade). A ORDEM de declaração é
41
+ * a ordem fixa de exibição. Métrica fora daqui vai para o fim, na ordem do
42
+ * `NexFinopsMetricCatalog`, com texto genérico ("Rótulo: n").
43
+ *
44
+ * O texto do excedente reaproveita `one` sem o `{n}`: "R$ 1,45 por atendimento com a HubIA".
45
+ */
46
+ exports.NEX_VENDAS_PACKAGE_ALLOWANCE_TEXT = {
47
+ attendances_ai: { one: '{n} atendimento com a HubIA', other: '{n} atendimentos com a HubIA' },
48
+ attendances_human: {
49
+ one: '{n} atendimento pela equipe da clínica',
50
+ other: '{n} atendimentos pela equipe da clínica',
51
+ },
52
+ attendances: { one: '{n} atendimento', other: '{n} atendimentos' },
53
+ teleconsultations_unrecorded: { one: '{n} teleconsulta sem gravação', other: '{n} teleconsultas sem gravação' },
54
+ teleconsultations_recorded: { one: '{n} teleconsulta com gravação', other: '{n} teleconsultas com gravação' },
55
+ campaigns_executed: { one: '{n} campanha', other: '{n} campanhas' },
56
+ automation_routines: {
57
+ one: '{n} rotina de automação ativa ao mesmo tempo',
58
+ other: '{n} rotinas de automação ativas ao mesmo tempo',
59
+ },
60
+ sms: { one: '{n} SMS', other: '{n} SMS' },
61
+ email: { one: '{n} e-mail', other: '{n} e-mails' },
62
+ nfse_issued: { one: '{n} nota fiscal', other: '{n} notas fiscais' },
63
+ };
64
+ /**
65
+ * Mapa métrica → módulo para as métricas SEM `allowance_metrics` no catálogo
66
+ * (o catálogo só declara `teleconsultations_unrecorded` na telemedicina). Use
67
+ * `getPackageMetricModule`, que consulta o catálogo primeiro.
68
+ * Métrica sem módulo (atendimentos, SMS, e-mail) não aparece aqui.
69
+ */
70
+ exports.NEX_VENDAS_PACKAGE_METRIC_MODULE = {
71
+ teleconsultations_recorded: 'telemedicine',
72
+ campaigns_executed: 'campaigns',
73
+ automation_routines: 'automation',
74
+ nfse_issued: 'nfse',
75
+ };
76
+ // ── Funções puras ──
77
+ const hasOwn = (obj, key) => Object.prototype.hasOwnProperty.call(obj, key);
78
+ /**
79
+ * Módulo do catálogo do qual a métrica depende (`allowance_metrics` do catálogo,
80
+ * depois `NEX_VENDAS_PACKAGE_METRIC_MODULE`). null = métrica sem módulo.
81
+ * Usado pelo backend na regra `package_allowance_module_off`.
82
+ */
83
+ function getPackageMetricModule(metric) {
84
+ for (const key of (0, catalog_1.listModuleKeys)()) {
85
+ const def = catalog_1.PLATFORM_MODULE_CATALOG[key];
86
+ for (const m of def.allowance_metrics) {
87
+ if (m.metric === metric)
88
+ return key;
89
+ }
90
+ }
91
+ return hasOwn(exports.NEX_VENDAS_PACKAGE_METRIC_MODULE, metric) ? exports.NEX_VENDAS_PACKAGE_METRIC_MODULE[metric] : null;
92
+ }
93
+ /** Rótulo do módulo para o cliente (mapa do cliente → catálogo → chave). */
94
+ function getPackageModuleLabel(key) {
95
+ if (hasOwn(exports.NEX_VENDAS_PACKAGE_MODULE_LABELS, key))
96
+ return exports.NEX_VENDAS_PACKAGE_MODULE_LABELS[key];
97
+ const def = (0, catalog_1.getModuleDefinition)(key);
98
+ return def ? def.label : key;
99
+ }
100
+ /** Inteiro com separador de milhar pt-BR ("1.000"). */
101
+ function formatInt(n) {
102
+ const neg = n < 0;
103
+ const digits = String(Math.abs(Math.trunc(n)));
104
+ let out = '';
105
+ for (let i = 0; i < digits.length; i++) {
106
+ if (i > 0 && (digits.length - i) % 3 === 0)
107
+ out += '.';
108
+ out += digits[i];
109
+ }
110
+ return neg ? `-${out}` : out;
111
+ }
112
+ /** "R$ 1,45" / "R$ 1.234,50" — determinístico, sem depender do ICU do runtime. */
113
+ function formatPackageBRL(amount) {
114
+ const cents = Math.round(Math.abs(amount) * 100);
115
+ const reais = Math.floor(cents / 100);
116
+ const rest = cents % 100;
117
+ const sign = amount < 0 && cents > 0 ? '-' : '';
118
+ return `${sign}R$ ${formatInt(reais)},${rest < 10 ? `0${rest}` : String(rest)}`;
119
+ }
120
+ /** Texto por extenso da franquia ("100 atendimentos com a HubIA"). */
121
+ function formatPackageAllowanceText(metric, included) {
122
+ if (hasOwn(exports.NEX_VENDAS_PACKAGE_ALLOWANCE_TEXT, metric)) {
123
+ const t = exports.NEX_VENDAS_PACKAGE_ALLOWANCE_TEXT[metric];
124
+ return (included === 1 ? t.one : t.other).replace('{n}', formatInt(included));
125
+ }
126
+ const cat = contract_1.NexFinopsMetricCatalog[metric];
127
+ return `${cat ? cat.label : metric}: ${formatInt(included)}`;
128
+ }
129
+ /** Unidade no singular para o texto do excedente ("atendimento com a HubIA"). */
130
+ function excessUnit(metric) {
131
+ if (hasOwn(exports.NEX_VENDAS_PACKAGE_ALLOWANCE_TEXT, metric)) {
132
+ return exports.NEX_VENDAS_PACKAGE_ALLOWANCE_TEXT[metric].one.replace('{n}', '').trim();
133
+ }
134
+ const cat = contract_1.NexFinopsMetricCatalog[metric];
135
+ return cat ? cat.label : metric;
136
+ }
137
+ /** Posição de exibição da métrica: texto do pacote, depois catálogo, depois resto. */
138
+ function metricOrder(metric) {
139
+ const textKeys = Object.keys(exports.NEX_VENDAS_PACKAGE_ALLOWANCE_TEXT);
140
+ const i = textKeys.indexOf(metric);
141
+ if (i !== -1)
142
+ return i;
143
+ const j = Object.keys(contract_1.NexFinopsMetricCatalog).indexOf(metric);
144
+ return j !== -1 ? textKeys.length + j : Number.MAX_SAFE_INTEGER;
145
+ }
146
+ /** Chaves dos módulos do pacote: catálogo em ordem, depois chaves fora do catálogo. */
147
+ function orderedModuleKeys(modules) {
148
+ const catalogKeys = (0, catalog_1.listModuleKeys)();
149
+ const out = catalogKeys.filter((k) => hasOwn(modules, k));
150
+ for (const k of Object.keys(modules)) {
151
+ if (out.indexOf(k) === -1)
152
+ out.push(k);
153
+ }
154
+ return out;
155
+ }
156
+ /**
157
+ * Projeção do pacote para exibir. Função PURA (sem Firestore): o backend resolve
158
+ * a tabela (`resolvePriceTableLines(tables, pkg.price_table_id)`) e chama; o
159
+ * shop/Nexus só exibem o resultado (`package_display`).
160
+ *
161
+ * - `resolved: null` (tabela não resolveu) ⇒ `excess` e `addons` vazios; o resto sai igual.
162
+ * - Excedente: só métrica com franquia APLICADA e linha `usage` resolvida
163
+ * (`disabled`/ausente não aparece). Teto por faixas (`cap`) não é exibido.
164
+ * - Adicionais: só módulo declarado `enabled: false` com linha `recurring` resolvida.
165
+ * - Sub-opções: capabilities efetivas (default do catálogo + override do pacote)
166
+ * que estão `true` e têm rótulo em `NEX_VENDAS_PACKAGE_CAPABILITY_LABELS`.
167
+ */
168
+ function buildPackageDisplay(input) {
169
+ const { pkg, base_amount, resolved } = input;
170
+ const modules = pkg.modules ?? {};
171
+ const list = typeof pkg.list_amount === 'number' && isFinite(pkg.list_amount) ? pkg.list_amount : null;
172
+ const discount = list !== null && list > 0 && list > base_amount ? Math.round(((list - base_amount) / list) * 100) : null;
173
+ const modules_included = [];
174
+ const modules_excluded = [];
175
+ const addons = [];
176
+ for (const key of orderedModuleKeys(modules)) {
177
+ const mod = modules[key];
178
+ if (!mod)
179
+ continue;
180
+ const label = getPackageModuleLabel(key);
181
+ if (mod.enabled) {
182
+ const def = (0, catalog_1.getModuleDefinition)(key);
183
+ const effective = {};
184
+ if (def) {
185
+ for (const cap of Object.keys(def.capabilities))
186
+ effective[cap] = def.capabilities[cap].default;
187
+ }
188
+ const overrides = mod.capabilities ?? {};
189
+ for (const cap of Object.keys(overrides))
190
+ effective[cap] = overrides[cap];
191
+ const capLabels = hasOwn(exports.NEX_VENDAS_PACKAGE_CAPABILITY_LABELS, key) ? exports.NEX_VENDAS_PACKAGE_CAPABILITY_LABELS[key] : {};
192
+ const details = [];
193
+ for (const cap of Object.keys(capLabels)) {
194
+ if (effective[cap] === true)
195
+ details.push(capLabels[cap]);
196
+ }
197
+ modules_included.push({ key, label, details });
198
+ }
199
+ else {
200
+ modules_excluded.push({ key, label });
201
+ const line = resolved && hasOwn(resolved.lines, key) ? resolved.lines[key].line : null;
202
+ if (line && line.kind === 'recurring')
203
+ addons.push({ key, label, amount: line.amount });
204
+ }
205
+ }
206
+ const applied = pkg.allowances ?? {};
207
+ const allowances = [];
208
+ for (const metric of Object.keys(applied)) {
209
+ const a = applied[metric];
210
+ if (!a)
211
+ continue;
212
+ allowances.push({ metric, included: a.included, text: formatPackageAllowanceText(metric, a.included), applied: true });
213
+ }
214
+ for (const d of pkg.display_allowances ?? []) {
215
+ // Defesa: chave repetida com a aplicada é erro de escrita (backend); a aplicada vence.
216
+ if (hasOwn(applied, d.metric))
217
+ continue;
218
+ allowances.push({
219
+ metric: d.metric,
220
+ included: d.included,
221
+ text: formatPackageAllowanceText(d.metric, d.included),
222
+ applied: false,
223
+ });
224
+ }
225
+ // Ordenação estável por posição fixa (empate mantém a ordem de inserção).
226
+ const indexed = allowances.map((item, i) => ({ item, i }));
227
+ indexed.sort((x, y) => metricOrder(x.item.metric) - metricOrder(y.item.metric) || x.i - y.i);
228
+ const sortedAllowances = indexed.map((x) => x.item);
229
+ const excess = [];
230
+ if (resolved) {
231
+ for (const item of sortedAllowances) {
232
+ if (!item.applied || !hasOwn(resolved.lines, item.metric))
233
+ continue;
234
+ const line = resolved.lines[item.metric].line;
235
+ if (line.kind !== 'usage')
236
+ continue;
237
+ excess.push({
238
+ metric: item.metric,
239
+ unit_price: line.unit_price,
240
+ text: `${formatPackageBRL(line.unit_price)} por ${excessUnit(item.metric)}`,
241
+ });
242
+ }
243
+ }
244
+ return {
245
+ list_amount: list,
246
+ discount_percent: discount,
247
+ modules_included,
248
+ modules_excluded,
249
+ allowances: sortedAllowances,
250
+ excess,
251
+ addons,
252
+ not_included: (pkg.not_included ?? []).slice(),
253
+ highlights: (pkg.highlights ?? []).slice(),
254
+ };
255
+ }