evo360-types 1.3.814 → 1.3.818

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.
@@ -17178,27 +17178,48 @@ export declare const zNfseFeeReimbursementExecuteSchema: z.ZodObject<{
17178
17178
  competencia: string;
17179
17179
  }>;
17180
17180
  /**
17181
- * Corpo de `POST /journeys/:short_code/contract/accept` (público). IP, user-agent,
17181
+ * Corpo de `POST /journeys/:short_code/acceptance` (público). IP, user-agent,
17182
17182
  * idioma e trace vêm da requisição, nunca do corpo.
17183
+ *
17184
+ * feat-353: `contract_sha256` (contrato consolidado) OU o par legado
17185
+ * `cg_sha256` + `summary_sha256` — qual deles vale é decidido pelo documento da
17186
+ * jornada no backend.
17183
17187
  */
17184
- export declare const zNexVendasAcceptanceRequestSchema: z.ZodObject<{
17185
- cg_sha256: z.ZodString;
17186
- summary_sha256: z.ZodString;
17188
+ export declare const zNexVendasAcceptanceRequestSchema: z.ZodEffects<z.ZodObject<{
17189
+ contract_sha256: z.ZodOptional<z.ZodString>;
17190
+ cg_sha256: z.ZodOptional<z.ZodString>;
17191
+ summary_sha256: z.ZodOptional<z.ZodString>;
17187
17192
  declaration_version: z.ZodString;
17188
17193
  viewed_to_end: z.ZodBoolean;
17189
17194
  client_request_id: z.ZodString;
17190
17195
  }, "strip", z.ZodTypeAny, {
17191
17196
  client_request_id: string;
17192
- cg_sha256: string;
17193
- summary_sha256: string;
17194
17197
  declaration_version: string;
17195
17198
  viewed_to_end: boolean;
17199
+ contract_sha256?: string | undefined;
17200
+ cg_sha256?: string | undefined;
17201
+ summary_sha256?: string | undefined;
17202
+ }, {
17203
+ client_request_id: string;
17204
+ declaration_version: string;
17205
+ viewed_to_end: boolean;
17206
+ contract_sha256?: string | undefined;
17207
+ cg_sha256?: string | undefined;
17208
+ summary_sha256?: string | undefined;
17209
+ }>, {
17210
+ client_request_id: string;
17211
+ declaration_version: string;
17212
+ viewed_to_end: boolean;
17213
+ contract_sha256?: string | undefined;
17214
+ cg_sha256?: string | undefined;
17215
+ summary_sha256?: string | undefined;
17196
17216
  }, {
17197
17217
  client_request_id: string;
17198
- cg_sha256: string;
17199
- summary_sha256: string;
17200
17218
  declaration_version: string;
17201
17219
  viewed_to_end: boolean;
17220
+ contract_sha256?: string | undefined;
17221
+ cg_sha256?: string | undefined;
17222
+ summary_sha256?: string | undefined;
17202
17223
  }>;
17203
17224
  /** Bloco `adhesion` do modelo de contrato (metadados das CG gravados pelo backend no upload). */
17204
17225
  export declare const zNexVendasContractTemplateAdhesionSchema: z.ZodObject<{
@@ -1298,18 +1298,26 @@ exports.zNfseFeeReimbursementExecuteSchema = zod_1.z
1298
1298
  // ---- Nexus Vendas — contrato por adesão (feat-325) ----
1299
1299
  const zSha256HexSchema = zod_1.z.string().regex(/^[a-f0-9]{64}$/, "sha256 must be 64 lowercase hex chars");
1300
1300
  /**
1301
- * Corpo de `POST /journeys/:short_code/contract/accept` (público). IP, user-agent,
1301
+ * Corpo de `POST /journeys/:short_code/acceptance` (público). IP, user-agent,
1302
1302
  * idioma e trace vêm da requisição, nunca do corpo.
1303
+ *
1304
+ * feat-353: `contract_sha256` (contrato consolidado) OU o par legado
1305
+ * `cg_sha256` + `summary_sha256` — qual deles vale é decidido pelo documento da
1306
+ * jornada no backend.
1303
1307
  */
1304
1308
  exports.zNexVendasAcceptanceRequestSchema = zod_1.z
1305
1309
  .object({
1306
- cg_sha256: zSha256HexSchema,
1307
- summary_sha256: zSha256HexSchema,
1310
+ contract_sha256: zSha256HexSchema.optional(),
1311
+ cg_sha256: zSha256HexSchema.optional(),
1312
+ summary_sha256: zSha256HexSchema.optional(),
1308
1313
  declaration_version: zod_1.z.string().min(1).max(64),
1309
1314
  viewed_to_end: zod_1.z.boolean(),
1310
1315
  client_request_id: zod_1.z.string().min(8).max(64),
1311
1316
  })
1312
- .strip();
1317
+ .strip()
1318
+ .refine((body) => Boolean(body.contract_sha256) || (Boolean(body.cg_sha256) && Boolean(body.summary_sha256)), {
1319
+ message: "contract_sha256 (or cg_sha256 + summary_sha256) is required",
1320
+ });
1313
1321
  /** Bloco `adhesion` do modelo de contrato (metadados das CG gravados pelo backend no upload). */
1314
1322
  exports.zNexVendasContractTemplateAdhesionSchema = zod_1.z
1315
1323
  .object({
@@ -1431,18 +1431,26 @@ export const zNfseFeeReimbursementExecuteSchema = z
1431
1431
  const zSha256HexSchema = z.string().regex(/^[a-f0-9]{64}$/, "sha256 must be 64 lowercase hex chars");
1432
1432
 
1433
1433
  /**
1434
- * Corpo de `POST /journeys/:short_code/contract/accept` (público). IP, user-agent,
1434
+ * Corpo de `POST /journeys/:short_code/acceptance` (público). IP, user-agent,
1435
1435
  * idioma e trace vêm da requisição, nunca do corpo.
1436
+ *
1437
+ * feat-353: `contract_sha256` (contrato consolidado) OU o par legado
1438
+ * `cg_sha256` + `summary_sha256` — qual deles vale é decidido pelo documento da
1439
+ * jornada no backend.
1436
1440
  */
1437
1441
  export const zNexVendasAcceptanceRequestSchema = z
1438
1442
  .object({
1439
- cg_sha256: zSha256HexSchema,
1440
- summary_sha256: zSha256HexSchema,
1443
+ contract_sha256: zSha256HexSchema.optional(),
1444
+ cg_sha256: zSha256HexSchema.optional(),
1445
+ summary_sha256: zSha256HexSchema.optional(),
1441
1446
  declaration_version: z.string().min(1).max(64),
1442
1447
  viewed_to_end: z.boolean(),
1443
1448
  client_request_id: z.string().min(8).max(64),
1444
1449
  })
1445
- .strip();
1450
+ .strip()
1451
+ .refine((body) => Boolean(body.contract_sha256) || (Boolean(body.cg_sha256) && Boolean(body.summary_sha256)), {
1452
+ message: "contract_sha256 (or cg_sha256 + summary_sha256) is required",
1453
+ });
1446
1454
 
1447
1455
  /** Bloco `adhesion` do modelo de contrato (metadados das CG gravados pelo backend no upload). */
1448
1456
  export const zNexVendasContractTemplateAdhesionSchema = z
@@ -139,6 +139,8 @@ export interface INexFinopsUsageAlertDefaults {
139
139
  */
140
140
  thresholds: number[];
141
141
  }
142
+ /** feat-360 — momento da cobrança do contrato (ver `INexFinopsContract.billing_timing`). */
143
+ export type NexFinopsBillingTiming = 'postpaid' | 'prepaid';
142
144
  export interface INexFinopsContract extends IFireGlobalDoc {
143
145
  customer_id: string;
144
146
  customer_ref?: string | null;
@@ -229,6 +231,15 @@ export interface INexFinopsContract extends IFireGlobalDoc {
229
231
  * (validação de escrita entra na F5; até lá o campo só é lido).
230
232
  */
231
233
  billing_mode?: NexFinopsBillingMode;
234
+ /**
235
+ * feat-360 Q1 — quando o contrato é cobrado. ⚠️ Ausente = `postpaid`.
236
+ * - `postpaid`: a cobrança de competência M liquida o consumo de M (fecha o mês, cobra depois).
237
+ * - `prepaid`: a cobrança de competência M traz o fixo de M (adiantado) e o consumo de M−1.
238
+ * É o caso do checkout de vendas, que cobra o 1º mês na adesão.
239
+ * Mês do consumo de uma cobrança = `usage_snapshot.competency` (se congelada) ??
240
+ * `competency.key − 1` (prepaid) ?? `competency.key` (postpaid).
241
+ */
242
+ billing_timing?: NexFinopsBillingTiming | null;
232
243
  /**
233
244
  * Snapshot dos módulos vendidos (cópia de `proposal.package.modules`).
234
245
  * Presente ⇒ o runner da feat-297 trata como AUTORITATIVO (liga só os
@@ -144,6 +144,9 @@ export interface INexFinopsUsageAlertDefaults {
144
144
 
145
145
  // ── Main Document ──
146
146
 
147
+ /** feat-360 — momento da cobrança do contrato (ver `INexFinopsContract.billing_timing`). */
148
+ export type NexFinopsBillingTiming = 'postpaid' | 'prepaid';
149
+
147
150
  export interface INexFinopsContract extends IFireGlobalDoc {
148
151
  // Vínculos
149
152
  customer_id: string;
@@ -271,6 +274,16 @@ export interface INexFinopsContract extends IFireGlobalDoc {
271
274
  */
272
275
  billing_mode?: NexFinopsBillingMode;
273
276
 
277
+ /**
278
+ * feat-360 Q1 — quando o contrato é cobrado. ⚠️ Ausente = `postpaid`.
279
+ * - `postpaid`: a cobrança de competência M liquida o consumo de M (fecha o mês, cobra depois).
280
+ * - `prepaid`: a cobrança de competência M traz o fixo de M (adiantado) e o consumo de M−1.
281
+ * É o caso do checkout de vendas, que cobra o 1º mês na adesão.
282
+ * Mês do consumo de uma cobrança = `usage_snapshot.competency` (se congelada) ??
283
+ * `competency.key − 1` (prepaid) ?? `competency.key` (postpaid).
284
+ */
285
+ billing_timing?: NexFinopsBillingTiming | null;
286
+
274
287
  // ── Pacote da oferta (feat-353) ──
275
288
 
276
289
  /**
@@ -77,6 +77,16 @@ export interface INexVendasJourneyAdhesionDocument {
77
77
  rendered_at: Date;
78
78
  /** Quantas vezes o quadro foi regerado por correção de dados (teto D10). */
79
79
  corrections_count: number;
80
+ /**
81
+ * feat-353 — CONTRATO CONSOLIDADO: um PDF só, com as páginas do quadro-resumo
82
+ * preenchido seguidas das páginas das CG (`cg_sha256`). É o documento que o shop
83
+ * oferece, que o aceite amarra (hash dos BYTES) e que vai no e-mail.
84
+ * Ausente em documento anterior à feat-353 (quadro e CG separados): a jornada em
85
+ * `dados_coletados` sem ele regera o documento (motivo `missing`).
86
+ */
87
+ contract_sha256?: string | null;
88
+ /** feat-353 — caminho do contrato consolidado pendente no bucket de evidências. */
89
+ contract_storage_path?: string | null;
80
90
  }
81
91
  /**
82
92
  * Resumo do aceite gravado na jornada (o registro completo é `INexVendasAcceptance`).
@@ -105,6 +115,8 @@ export interface INexVendasJourneyContractAcceptedEventData {
105
115
  cg_sha256: string;
106
116
  cg_version: string;
107
117
  declaration_version: string;
118
+ /** feat-353 — hash do contrato consolidado aceito. Ausente em aceite anterior à feat-353. */
119
+ contract_sha256?: string | null;
108
120
  }
109
121
  /** Collection `core/nexus/apps/nex-vendas/acceptances/{acceptance_id}` (append-only). */
110
122
  export declare const NEX_VENDAS_ACCEPTANCES_COLLECTION = "acceptances";
@@ -122,6 +134,15 @@ export interface INexVendasAcceptanceSummary {
122
134
  storage_path: string;
123
135
  issued_on?: string | null;
124
136
  }
137
+ /**
138
+ * feat-353 — contrato consolidado aceito (quadro-resumo preenchido + CG num PDF só).
139
+ * `sha256` dos BYTES; é o hash que o shop devolveu no aceite.
140
+ */
141
+ export interface INexVendasAcceptanceContract {
142
+ sha256: string;
143
+ /** Caminho da cópia no bucket de evidências (`{short_code}/{acceptance_id}/contract.pdf`). */
144
+ storage_path: string;
145
+ }
125
146
  /** Declaração exibida ao lado do checkbox, como estava no momento do aceite. */
126
147
  export interface INexVendasAcceptanceDeclaration {
127
148
  version: string;
@@ -196,8 +217,14 @@ export interface INexVendasAcceptance {
196
217
  contract_type: 'adesao';
197
218
  template_key: string;
198
219
  template_revision: number;
220
+ /** CG ORIGINAIS (versão do modelo): o `sha256` é o do PDF das CG, não o do consolidado. */
199
221
  cg: INexVendasAcceptanceCg;
200
222
  summary: INexVendasAcceptanceSummary;
223
+ /**
224
+ * feat-353 — contrato consolidado aceito. Ausente/null em aceite anterior à
225
+ * feat-353 (o cliente recebeu quadro e CG separados).
226
+ */
227
+ contract?: INexVendasAcceptanceContract | null;
201
228
  declaration: INexVendasAcceptanceDeclaration;
202
229
  identity: INexVendasAcceptanceIdentity;
203
230
  client: INexVendasAcceptanceClient;
@@ -213,15 +240,21 @@ export interface INexVendasAcceptance {
213
240
  created_at: Date;
214
241
  }
215
242
  /**
216
- * Corpo de `POST /journeys/:short_code/contract/accept` (público, `short_code`).
243
+ * Corpo de `POST /journeys/:short_code/acceptance` (público, `short_code`).
217
244
  *
218
- * Os hashes são dos BYTES que o shop exibiu; divergência do documento atual ⇒ 409
245
+ * Os hashes são dos BYTES que o shop baixou; divergência do documento atual ⇒ 409
219
246
  * `document_changed` e nada é gravado. IP, user-agent, idioma e trace o servidor lê
220
247
  * da requisição — nunca do corpo.
248
+ *
249
+ * feat-353: documento com contrato consolidado exige `contract_sha256`
250
+ * (`cg_sha256`/`summary_sha256` opcionais; se vierem, também são conferidos).
251
+ * Documento anterior (sem consolidado) exige `cg_sha256` + `summary_sha256`.
221
252
  */
222
253
  export interface INexVendasAcceptanceRequest {
223
- cg_sha256: string;
224
- summary_sha256: string;
254
+ /** feat-353 — SHA-256 dos bytes do contrato consolidado. */
255
+ contract_sha256?: string | null;
256
+ cg_sha256?: string | null;
257
+ summary_sha256?: string | null;
225
258
  declaration_version: string;
226
259
  viewed_to_end: boolean;
227
260
  /** UUID gerado pelo navegador por tentativa de aceite. */
@@ -90,6 +90,16 @@ export interface INexVendasJourneyAdhesionDocument {
90
90
  rendered_at: Date;
91
91
  /** Quantas vezes o quadro foi regerado por correção de dados (teto D10). */
92
92
  corrections_count: number;
93
+ /**
94
+ * feat-353 — CONTRATO CONSOLIDADO: um PDF só, com as páginas do quadro-resumo
95
+ * preenchido seguidas das páginas das CG (`cg_sha256`). É o documento que o shop
96
+ * oferece, que o aceite amarra (hash dos BYTES) e que vai no e-mail.
97
+ * Ausente em documento anterior à feat-353 (quadro e CG separados): a jornada em
98
+ * `dados_coletados` sem ele regera o documento (motivo `missing`).
99
+ */
100
+ contract_sha256?: string | null;
101
+ /** feat-353 — caminho do contrato consolidado pendente no bucket de evidências. */
102
+ contract_storage_path?: string | null;
93
103
  }
94
104
 
95
105
  /**
@@ -120,6 +130,8 @@ export interface INexVendasJourneyContractAcceptedEventData {
120
130
  cg_sha256: string;
121
131
  cg_version: string;
122
132
  declaration_version: string;
133
+ /** feat-353 — hash do contrato consolidado aceito. Ausente em aceite anterior à feat-353. */
134
+ contract_sha256?: string | null;
123
135
  }
124
136
 
125
137
  // ── Registro imutável do aceite ──
@@ -143,6 +155,16 @@ export interface INexVendasAcceptanceSummary {
143
155
  issued_on?: string | null;
144
156
  }
145
157
 
158
+ /**
159
+ * feat-353 — contrato consolidado aceito (quadro-resumo preenchido + CG num PDF só).
160
+ * `sha256` dos BYTES; é o hash que o shop devolveu no aceite.
161
+ */
162
+ export interface INexVendasAcceptanceContract {
163
+ sha256: string;
164
+ /** Caminho da cópia no bucket de evidências (`{short_code}/{acceptance_id}/contract.pdf`). */
165
+ storage_path: string;
166
+ }
167
+
146
168
  /** Declaração exibida ao lado do checkbox, como estava no momento do aceite. */
147
169
  export interface INexVendasAcceptanceDeclaration {
148
170
  version: string;
@@ -219,8 +241,14 @@ export interface INexVendasAcceptance {
219
241
  contract_type: 'adesao';
220
242
  template_key: string;
221
243
  template_revision: number;
244
+ /** CG ORIGINAIS (versão do modelo): o `sha256` é o do PDF das CG, não o do consolidado. */
222
245
  cg: INexVendasAcceptanceCg;
223
246
  summary: INexVendasAcceptanceSummary;
247
+ /**
248
+ * feat-353 — contrato consolidado aceito. Ausente/null em aceite anterior à
249
+ * feat-353 (o cliente recebeu quadro e CG separados).
250
+ */
251
+ contract?: INexVendasAcceptanceContract | null;
224
252
  declaration: INexVendasAcceptanceDeclaration;
225
253
  identity: INexVendasAcceptanceIdentity;
226
254
  client: INexVendasAcceptanceClient;
@@ -237,15 +265,21 @@ export interface INexVendasAcceptance {
237
265
  }
238
266
 
239
267
  /**
240
- * Corpo de `POST /journeys/:short_code/contract/accept` (público, `short_code`).
268
+ * Corpo de `POST /journeys/:short_code/acceptance` (público, `short_code`).
241
269
  *
242
- * Os hashes são dos BYTES que o shop exibiu; divergência do documento atual ⇒ 409
270
+ * Os hashes são dos BYTES que o shop baixou; divergência do documento atual ⇒ 409
243
271
  * `document_changed` e nada é gravado. IP, user-agent, idioma e trace o servidor lê
244
272
  * da requisição — nunca do corpo.
273
+ *
274
+ * feat-353: documento com contrato consolidado exige `contract_sha256`
275
+ * (`cg_sha256`/`summary_sha256` opcionais; se vierem, também são conferidos).
276
+ * Documento anterior (sem consolidado) exige `cg_sha256` + `summary_sha256`.
245
277
  */
246
278
  export interface INexVendasAcceptanceRequest {
247
- cg_sha256: string;
248
- summary_sha256: string;
279
+ /** feat-353 — SHA-256 dos bytes do contrato consolidado. */
280
+ contract_sha256?: string | null;
281
+ cg_sha256?: string | null;
282
+ summary_sha256?: string | null;
249
283
  declaration_version: string;
250
284
  viewed_to_end: boolean;
251
285
  /** UUID gerado pelo navegador por tentativa de aceite. */
@@ -496,6 +496,14 @@ export interface INexVendasJourneyAdhesionDocumentsPublic {
496
496
  summary: INexVendasJourneyDocumentPublic & {
497
497
  issued_on: string | null;
498
498
  };
499
+ /**
500
+ * feat-353 — contrato consolidado (quadro-resumo preenchido + CG num PDF só). É o
501
+ * documento que o shop oferece e cujo hash devolve no aceite. null/ausente em
502
+ * documento anterior à feat-353 (aí valem `cg` + `summary`).
503
+ */
504
+ contract?: (INexVendasJourneyDocumentPublic & {
505
+ filename: string;
506
+ }) | null;
499
507
  /** Comprovante do aceite; null antes do aceite ou enquanto não gerado. */
500
508
  receipt: INexVendasJourneyDocumentPublic | null;
501
509
  /** Quando as URLs assinadas expiram (o shop refaz o GET depois disso). */
@@ -628,6 +628,12 @@ export interface INexVendasJourneyAdhesionDocumentsPublic {
628
628
  cg: INexVendasJourneyDocumentPublic & { version: string; filename: string | null };
629
629
  /** Quadro-resumo da jornada. */
630
630
  summary: INexVendasJourneyDocumentPublic & { issued_on: string | null };
631
+ /**
632
+ * feat-353 — contrato consolidado (quadro-resumo preenchido + CG num PDF só). É o
633
+ * documento que o shop oferece e cujo hash devolve no aceite. null/ausente em
634
+ * documento anterior à feat-353 (aí valem `cg` + `summary`).
635
+ */
636
+ contract?: (INexVendasJourneyDocumentPublic & { filename: string }) | null;
631
637
  /** Comprovante do aceite; null antes do aceite ou enquanto não gerado. */
632
638
  receipt: INexVendasJourneyDocumentPublic | null;
633
639
  /** Quando as URLs assinadas expiram (o shop refaz o GET depois disso). */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "evo360-types",
3
- "version": "1.3.814",
3
+ "version": "1.3.818",
4
4
  "description": "HREVO360 Shared Types",
5
5
  "main": "./dist/index.js",
6
6
  "types": "./dist/index.d.ts",