@77sol-lab/form-schemas 2.0.0 → 3.0.0

package/financing/formalization/index.js

@@ -4,13 +4,12 @@ var zod = require('zod');
 
 // src/shared/fields/primitives.ts
 var REQUIRED_MESSAGE = "Campo obrigat\xF3rio";
-var REQUIRED_STRING_PARAMS = { error: REQUIRED_MESSAGE };
 function requiredString() {
-  return zod.z.string(REQUIRED_STRING_PARAMS);
+  return zod.z.string({ error: REQUIRED_MESSAGE });
 }
-function textField(maxLength) {
-  const base = requiredString().trim().min(1, REQUIRED_MESSAGE);
-  return maxLength === void 0 ? base : base.max(maxLength, `M\xE1ximo ${maxLength} caracteres`);
+var DEFAULT_TEXT_MAX_LENGTH = 255;
+function textField(maxLength = DEFAULT_TEXT_MAX_LENGTH) {
+  return requiredString().trim().min(1, REQUIRED_MESSAGE).max(maxLength, `M\xE1ximo ${maxLength} caracteres`);
 }
 function requiredNumber(invalidTypeMessage) {
   return zod.z.number({
@@ -21,6 +20,34 @@ var numberField = requiredNumber("Valor num\xE9rico inv\xE1lido").nonnegative(
   "Valor n\xE3o pode ser negativo"
 );
 var integerField = requiredNumber("Valor num\xE9rico inv\xE1lido").int("Deve ser um n\xFAmero inteiro").nonnegative("Valor n\xE3o pode ser negativo");
+function optionalField(schema) {
+  return zod.z.preprocess(
+    (value) => typeof value === "string" && value.trim() === "" ? void 0 : value,
+    schema.optional()
+  );
+}
+function unrecognizedKeysMessage(keys) {
+  const list = keys.map((key) => `"${key}"`).join(", ");
+  return keys.length === 1 ? `Campo n\xE3o reconhecido: ${list}` : `Campos n\xE3o reconhecidos: ${list}`;
+}
+function requiredObject(shape) {
+  return zod.z.object(shape, {
+    error: (issue) => {
+      if (issue.code === "invalid_type") {
+        return REQUIRED_MESSAGE;
+      }
+      if (issue.code === "unrecognized_keys") {
+        return unrecognizedKeysMessage(issue.keys);
+      }
+      return void 0;
+    }
+  });
+}
+function requiredArray(element) {
+  return zod.z.array(element, {
+    error: (issue) => issue.code === "invalid_type" ? REQUIRED_MESSAGE : void 0
+  });
+}
 function enumField(values) {
   return zod.z.enum(values, {
     // No zod 4 todo input fora da lista (inclusive undefined/null) gera um único
@@ -32,14 +59,19 @@ function enumField(values) {
 }
 var MAX_UPLOAD_BYTES = 5 * 1024 * 1024;
 var ACCEPTED_UPLOAD_MIME = ["image/jpeg", "image/png", "application/pdf"];
-var fileUploadField = zod.z.object(
-  {
-    url: zod.z.url().optional(),
-    mime: zod.z.enum(ACCEPTED_UPLOAD_MIME, { error: "Formato deve ser JPEG, PNG ou PDF" }),
-    sizeBytes: zod.z.number().max(MAX_UPLOAD_BYTES, "Arquivo deve ter no m\xE1ximo 5MB")
-  },
-  REQUIRED_STRING_PARAMS
-);
+var UPLOAD_URL_PROTOCOL = /^https$/;
+var UPLOAD_URL_HOSTNAME = /^(?!localhost$)(?!(\d{1,3}\.){3}\d{1,3}$)[a-z0-9.-]+$/i;
+var fileUploadField = requiredObject({
+  url: optionalField(
+    zod.z.url({
+      protocol: UPLOAD_URL_PROTOCOL,
+      hostname: UPLOAD_URL_HOSTNAME,
+      error: "URL do arquivo inv\xE1lida"
+    })
+  ),
+  mime: zod.z.enum(ACCEPTED_UPLOAD_MIME, { error: "Formato deve ser JPEG, PNG ou PDF" }),
+  sizeBytes: requiredNumber("Tamanho do arquivo inv\xE1lido").int("Tamanho do arquivo deve ser um n\xFAmero inteiro").positive("Tamanho do arquivo deve ser positivo").max(MAX_UPLOAD_BYTES, "Arquivo deve ter no m\xE1ximo 5MB")
+});
 
 // src/shared/enums/civil-status.ts
 var CivilStatusEnum = enumField([
@@ -76,11 +108,16 @@ var CommunionRegimeLabels = {
 // src/shared/enums/document-type.ts
 var DocumentTypeEnum = enumField([
   "documento_de_identidade",
-  "carteira_nacional_de_habilita\xE7\xE3o"
+  "carteira_nacional_de_habilita\xE7\xE3o",
+  // Exigido pela RN-015 para nacionalidade estrangeira. Sem este membro a
+  // regra seria insatisfazível: todo schema é .strict() com type_doc
+  // restrito a este enum.
+  "registro_de_estrangeiro"
 ]);
 var DocumentTypeLabels = {
   documento_de_identidade: "Documento de identidade (RG)",
-  carteira_nacional_de_habilita\u00E7\u00E3o: "Carteira Nacional de Habilita\xE7\xE3o (CNH)"
+  carteira_nacional_de_habilita\u00E7\u00E3o: "Carteira Nacional de Habilita\xE7\xE3o (CNH)",
+  registro_de_estrangeiro: "Registro Nacional de Estrangeiro (RNE)"
 };
 
 // src/shared/enums/nationality.ts
@@ -305,7 +342,10 @@ var PATTERNS = {
   cep: /^\d{8}$/,
   phoneBR: /^\d{11}$/,
   email: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
-  dateDMY: /^\d{2}\/\d{2}\/\d{4}$/};
+  dateDMY: /^\d{2}\/\d{2}\/\d{4}$/,
+  // Formato do RNE, exigido pela RN-015 para nacionalidade estrangeira.
+  rneNumber: /^[A-Za-z0-9]+$/
+};
 
 // src/shared/regex/validators.ts
 function onlyDigits(value) {
@@ -422,18 +462,18 @@ function parseBRLCurrency(value) {
   if (typeof value !== "string") {
     return value;
   }
-  const trimmed = value.trim();
-  if (trimmed === "") {
+  const normalized = value.replace(/R\$/gi, "").replace(/\s/g, "").replace(/\./g, "").replace(",", ".");
+  if (normalized === "") {
     return void 0;
   }
-  const normalized = trimmed.replace(/R\$/gi, "").replace(/\s/g, "").replace(/\./g, "").replace(",", ".");
   const parsed = Number(normalized);
   return Number.isNaN(parsed) ? value : parsed;
 }
-var currencySchema = zod.z.preprocess(
-  parseBRLCurrency,
-  requiredNumber("Valor monet\xE1rio inv\xE1lido").positive("Valor deve ser positivo")
-);
+function brlAmount() {
+  return requiredNumber("Valor monet\xE1rio inv\xE1lido").positive("Valor deve ser positivo");
+}
+var currencySchema = zod.z.preprocess(parseBRLCurrency, brlAmount());
+var optionalCurrencySchema = zod.z.preprocess(parseBRLCurrency, brlAmount().optional());
 requiredNumber("Valor num\xE9rico inv\xE1lido").int("Deve ser um n\xFAmero inteiro").min(1, "M\xEDnimo 1").max(28, "M\xE1ximo 28");
 
 // src/domains/financing/formalization/refinements.ts
@@ -476,7 +516,36 @@ function applyCommonRefinements(data, ctx) {
     });
   }
 }
+var FOREIGN_DOCUMENT_TYPE = "registro_de_estrangeiro";
+function applyForeignDocumentRefinement(data, ctx) {
+  const nationality = data.nationality;
+  const isForeign = typeof nationality === "string" && nationality.toLowerCase() !== NATIONALITY_BRAZIL;
+  if (!isForeign || !("type_doc" in data)) {
+    return;
+  }
+  if (data.type_doc !== FOREIGN_DOCUMENT_TYPE) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["type_doc"],
+      message: "Para nacionalidade estrangeira, o documento deve ser Registro de Estrangeiro (RNE)"
+    });
+    return;
+  }
+  if (typeof data.doc === "string" && !PATTERNS.rneNumber.test(data.doc)) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["doc"],
+      message: "RNE deve conter apenas letras e n\xFAmeros"
+    });
+  }
+}
+function isRecord(data) {
+  return typeof data === "object" && data !== null;
+}
 function applyPfRefinements(data, ctx) {
+  if (!isRecord(data)) {
+    return;
+  }
   applyCommonRefinements(data, ctx);
   applyPartnerRefinement(data, ctx);
   if ("nature_of_occupation" in data && typeof data.nature_of_occupation === "string" && OCCUPATIONS_REQUIRING_CNPJ.includes(data.nature_of_occupation) && !data.cnpj_proprietary) {
@@ -496,8 +565,12 @@ function applyPfRefinements(data, ctx) {
       });
     }
   }
+  applyForeignDocumentRefinement(data, ctx);
 }
 function applyPjRefinements(data, ctx) {
+  if (!isRecord(data)) {
+    return;
+  }
   applyCommonRefinements(data, ctx);
 }
 function onlyUnknownKeysAborted(payload) {
@@ -511,7 +584,7 @@ var pjRefinement = zod.z.superRefine(applyPjRefinements, {
 });
 var formalizationExtras = {
   voucher_local_installation_address: fileUploadField,
-  proof_kinship_type: ProofKinshipTypeEnum.optional(),
+  proof_kinship_type: optionalField(ProofKinshipTypeEnum),
   proof_kinship: fileUploadField.optional(),
   document_front_upload: fileUploadField,
   document_back_upload: fileUploadField,
@@ -519,7 +592,7 @@ var formalizationExtras = {
 };
 
 // src/domains/financing/formalization/schemas/AlfaPFSchema.ts
-var alfaPfObject = zod.z.object({
+var alfaPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -528,12 +601,12 @@ var alfaPfObject = zod.z.object({
   birth_date: birthDateSchema,
   number: textField(),
   sex: SexEnum,
-  complement: textField(15).optional(),
+  complement: optionalField(textField(15)),
   mother_name: textField(),
   district: textField(),
   energy_account_in_requester_name: textField(),
   city: textField(),
-  energy_bill_owner_document: cpfCnpjSchema.optional(),
+  energy_bill_owner_document: optionalField(cpfCnpjSchema),
   state: UfEnum,
   nationality: NationalityEnum.default(NATIONALITY_BRAZIL),
   cellphone: phoneBRSchema,
@@ -546,9 +619,11 @@ var alfaPfObject = zod.z.object({
   doc_issue_date: issueDateSchema
 });
 var alfaPfSchema = alfaPfObject.strict().check(pfRefinement);
-var alfaPjObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/AlfaPJSchema.ts
+var alfaPjObject = requiredObject({
   ...formalizationExtras,
-  financing_company: zod.z.object({
+  financing_company: requiredObject({
     corporate_name: textField(),
     cep: cepSchema,
     address: textField(),
@@ -556,7 +631,7 @@ var alfaPjObject = zod.z.object({
     number: textField(),
     cnpj: cnpjSchema,
     email: emailSchema,
-    complement: textField(15).optional(),
+    complement: optionalField(textField(15)),
     phone: phoneBRSchema,
     district: textField(),
     legal_nature: textField(),
@@ -566,15 +641,15 @@ var alfaPjObject = zod.z.object({
     economic_activity: textField(),
     monthly_income: currencySchema
   }).strict(),
-  financing_company_guarantor: zod.z.array(
-    zod.z.object({
+  financing_company_guarantor: requiredArray(
+    requiredObject({
       name: textField(),
       cep: cepSchema,
       cpf: cpfSchema,
       address: textField(),
       birth_date: birthDateSchema,
       number: textField(),
-      complement: textField(15).optional(),
+      complement: optionalField(textField(15)),
       cellphone: phoneBRSchema,
       email: emailSchema,
       district: textField(),
@@ -588,7 +663,9 @@ var alfaPjObject = zod.z.object({
   )
 });
 var alfaPjSchema = alfaPjObject.strict().check(pjRefinement);
-var bancoDoBrasilPfObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/BancoDoBrasilPFSchema.ts
+var bancoDoBrasilPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -597,12 +674,12 @@ var bancoDoBrasilPfObject = zod.z.object({
   birth_date: birthDateSchema,
   number: textField(),
   sex: SexEnum,
-  complement: textField(15).optional(),
+  complement: optionalField(textField(15)),
   mother_name: textField(),
   district: textField(),
   energy_account_in_requester_name: textField(),
   city: textField(),
-  energy_bill_owner_document: cpfCnpjSchema.optional(),
+  energy_bill_owner_document: optionalField(cpfCnpjSchema),
   state: UfEnum,
   nationality: NationalityEnum.default(NATIONALITY_BRAZIL),
   cellphone: phoneBRSchema,
@@ -615,9 +692,11 @@ var bancoDoBrasilPfObject = zod.z.object({
   doc_issue_date: issueDateSchema
 });
 var bancoDoBrasilPfSchema = bancoDoBrasilPfObject.strict().check(pfRefinement);
-var bancoDoBrasilPjObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/BancoDoBrasilPJSchema.ts
+var bancoDoBrasilPjObject = requiredObject({
   ...formalizationExtras,
-  financing_company: zod.z.object({
+  financing_company: requiredObject({
     corporate_name: textField(),
     cep: cepSchema,
     address: textField(),
@@ -625,7 +704,7 @@ var bancoDoBrasilPjObject = zod.z.object({
     number: textField(),
     cnpj: cnpjSchema,
     email: emailSchema,
-    complement: textField(15).optional(),
+    complement: optionalField(textField(15)),
     phone: phoneBRSchema,
     district: textField(),
     legal_nature: textField(),
@@ -635,15 +714,15 @@ var bancoDoBrasilPjObject = zod.z.object({
     economic_activity: textField(),
     monthly_income: currencySchema
   }).strict(),
-  financing_company_guarantor: zod.z.array(
-    zod.z.object({
+  financing_company_guarantor: requiredArray(
+    requiredObject({
       name: textField(),
       cep: cepSchema,
       cpf: cpfSchema,
       address: textField(),
       birth_date: birthDateSchema,
       number: textField(),
-      complement: textField(15).optional(),
+      complement: optionalField(textField(15)),
       cellphone: phoneBRSchema,
       email: emailSchema,
       district: textField(),
@@ -657,7 +736,9 @@ var bancoDoBrasilPjObject = zod.z.object({
   )
 });
 var bancoDoBrasilPjSchema = bancoDoBrasilPjObject.strict().check(pjRefinement);
-var btgPfObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/BtgPFSchema.ts
+var btgPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -666,12 +747,12 @@ var btgPfObject = zod.z.object({
   birth_date: birthDateSchema,
   number: textField(),
   sex: SexEnum,
-  complement: textField(15).optional(),
+  complement: optionalField(textField(15)),
   mother_name: textField(),
   district: textField(),
   energy_account_in_requester_name: textField(),
   city: textField(),
-  energy_bill_owner_document: cpfCnpjSchema.optional(),
+  energy_bill_owner_document: optionalField(cpfCnpjSchema),
   state: UfEnum,
   nationality: NationalityEnum.default(NATIONALITY_BRAZIL),
   cellphone: phoneBRSchema,
@@ -684,9 +765,11 @@ var btgPfObject = zod.z.object({
   doc_issue_date: issueDateSchema
 });
 var btgPfSchema = btgPfObject.strict().check(pfRefinement);
-var btgPjObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/BtgPJSchema.ts
+var btgPjObject = requiredObject({
   ...formalizationExtras,
-  financing_company: zod.z.object({
+  financing_company: requiredObject({
     corporate_name: textField(),
     cep: cepSchema,
     address: textField(),
@@ -694,7 +777,7 @@ var btgPjObject = zod.z.object({
     number: textField(),
     cnpj: cnpjSchema,
     email: emailSchema,
-    complement: textField(15).optional(),
+    complement: optionalField(textField(15)),
     phone: phoneBRSchema,
     district: textField(),
     legal_nature: textField(),
@@ -704,15 +787,15 @@ var btgPjObject = zod.z.object({
     economic_activity: textField(),
     monthly_income: currencySchema
   }).strict(),
-  financing_company_guarantor: zod.z.array(
-    zod.z.object({
+  financing_company_guarantor: requiredArray(
+    requiredObject({
       name: textField(),
       cep: cepSchema,
       cpf: cpfSchema,
       address: textField(),
       birth_date: birthDateSchema,
       number: textField(),
-      complement: textField(15).optional(),
+      complement: optionalField(textField(15)),
       cellphone: phoneBRSchema,
       phone: phoneBRSchema,
       email: emailSchema,
@@ -737,7 +820,9 @@ var btgPjObject = zod.z.object({
   )
 });
 var btgPjSchema = btgPjObject.strict().check(pjRefinement);
-var bvPfObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/BvPFSchema.ts
+var bvPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -748,13 +833,13 @@ var bvPfObject = zod.z.object({
   birth_date: birthDateSchema,
   number: textField(),
   sex: SexEnum,
-  complement: textField(15).optional(),
+  complement: optionalField(textField(15)),
   is_installation_at_requester: textField(),
   mother_name: textField(),
   district: textField(),
   energy_account_in_requester_name: textField(),
   city: textField(),
-  energy_bill_owner_document: cpfCnpjSchema.optional(),
+  energy_bill_owner_document: optionalField(cpfCnpjSchema),
   civil_status: textField(),
   state: UfEnum,
   nationality: NationalityEnum.default(NATIONALITY_BRAZIL),
@@ -766,19 +851,21 @@ var bvPfObject = zod.z.object({
   profession: textField(),
   nature_of_occupation: textField(),
   company_time: numberField,
-  cnpj_proprietary: cnpjSchema.optional(),
+  cnpj_proprietary: optionalField(cnpjSchema),
   equity_value: currencySchema,
   type_doc: DocumentTypeEnum,
   doc: textField(15),
   issuing_body: textField(6),
   emitting_state: UfEnum,
   doc_issue_date: issueDateSchema,
-  pep_relationship: textField().optional()
+  pep_relationship: optionalField(textField())
 });
 var bvPfSchema = bvPfObject.strict().check(pfRefinement);
-var bvPjObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/BvPJSchema.ts
+var bvPjObject = requiredObject({
   ...formalizationExtras,
-  financing_company: zod.z.object({
+  financing_company: requiredObject({
     corporate_name: textField(),
     cep: cepSchema,
     residence_situation: textField(),
@@ -788,7 +875,7 @@ var bvPjObject = zod.z.object({
     number: textField(),
     cnpj: cnpjSchema,
     email: emailSchema,
-    complement: textField(15).optional(),
+    complement: optionalField(textField(15)),
     phone: phoneBRSchema,
     district: textField(),
     legal_nature: textField(),
@@ -799,15 +886,15 @@ var bvPjObject = zod.z.object({
     monthly_income: currencySchema,
     capital_social: currencySchema
   }).strict(),
-  financing_company_guarantor: zod.z.array(
-    zod.z.object({
+  financing_company_guarantor: requiredArray(
+    requiredObject({
       name: textField(),
       cep: cepSchema,
       cpf: cpfSchema,
       address: textField(),
       birth_date: birthDateSchema,
       number: textField(),
-      complement: textField(15).optional(),
+      complement: optionalField(textField(15)),
       cellphone: phoneBRSchema,
       phone: phoneBRSchema,
       email: emailSchema,
@@ -836,7 +923,9 @@ var bvPjObject = zod.z.object({
   )
 });
 var bvPjSchema = bvPjObject.strict().check(pjRefinement);
-var caixaEconomicaFederalPfObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/CaixaEconomicaFederalPFSchema.ts
+var caixaEconomicaFederalPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -845,12 +934,12 @@ var caixaEconomicaFederalPfObject = zod.z.object({
   birth_date: birthDateSchema,
   number: textField(),
   sex: SexEnum,
-  complement: textField(15).optional(),
+  complement: optionalField(textField(15)),
   mother_name: textField(),
   district: textField(),
   energy_account_in_requester_name: textField(),
   city: textField(),
-  energy_bill_owner_document: cpfCnpjSchema.optional(),
+  energy_bill_owner_document: optionalField(cpfCnpjSchema),
   state: UfEnum,
   nationality: NationalityEnum.default(NATIONALITY_BRAZIL),
   cellphone: phoneBRSchema,
@@ -863,9 +952,11 @@ var caixaEconomicaFederalPfObject = zod.z.object({
   doc_issue_date: issueDateSchema
 });
 var caixaEconomicaFederalPfSchema = caixaEconomicaFederalPfObject.strict().check(pfRefinement);
-var caixaEconomicaFederalPjObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/CaixaEconomicaFederalPJSchema.ts
+var caixaEconomicaFederalPjObject = requiredObject({
   ...formalizationExtras,
-  financing_company: zod.z.object({
+  financing_company: requiredObject({
     corporate_name: textField(),
     cep: cepSchema,
     address: textField(),
@@ -873,7 +964,7 @@ var caixaEconomicaFederalPjObject = zod.z.object({
     number: textField(),
     cnpj: cnpjSchema,
     email: emailSchema,
-    complement: textField(15).optional(),
+    complement: optionalField(textField(15)),
     phone: phoneBRSchema,
     district: textField(),
     legal_nature: textField(),
@@ -883,15 +974,15 @@ var caixaEconomicaFederalPjObject = zod.z.object({
     economic_activity: textField(),
     monthly_income: currencySchema
   }).strict(),
-  financing_company_guarantor: zod.z.array(
-    zod.z.object({
+  financing_company_guarantor: requiredArray(
+    requiredObject({
       name: textField(),
       cep: cepSchema,
       cpf: cpfSchema,
       address: textField(),
       birth_date: birthDateSchema,
       number: textField(),
-      complement: textField(15).optional(),
+      complement: optionalField(textField(15)),
       cellphone: phoneBRSchema,
       email: emailSchema,
       district: textField(),
@@ -905,7 +996,9 @@ var caixaEconomicaFederalPjObject = zod.z.object({
   )
 });
 var caixaEconomicaFederalPjSchema = caixaEconomicaFederalPjObject.strict().check(pjRefinement);
-var cashMePfObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/CashMePFSchema.ts
+var cashMePfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -914,12 +1007,12 @@ var cashMePfObject = zod.z.object({
   birth_date: birthDateSchema,
   number: textField(),
   sex: SexEnum,
-  complement: textField(15).optional(),
+  complement: optionalField(textField(15)),
   mother_name: textField(),
   district: textField(),
   energy_account_in_requester_name: textField(),
   city: textField(),
-  energy_bill_owner_document: cpfCnpjSchema.optional(),
+  energy_bill_owner_document: optionalField(cpfCnpjSchema),
   state: UfEnum,
   nationality: NationalityEnum.default(NATIONALITY_BRAZIL),
   cellphone: phoneBRSchema,
@@ -932,9 +1025,11 @@ var cashMePfObject = zod.z.object({
   doc_issue_date: issueDateSchema
 });
 var cashMePfSchema = cashMePfObject.strict().check(pfRefinement);
-var cashMePjObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/CashMePJSchema.ts
+var cashMePjObject = requiredObject({
   ...formalizationExtras,
-  financing_company: zod.z.object({
+  financing_company: requiredObject({
     corporate_name: textField(),
     cep: cepSchema,
     address: textField(),
@@ -942,7 +1037,7 @@ var cashMePjObject = zod.z.object({
     number: textField(),
     cnpj: cnpjSchema,
     email: emailSchema,
-    complement: textField(15).optional(),
+    complement: optionalField(textField(15)),
     phone: phoneBRSchema,
     district: textField(),
     legal_nature: textField(),
@@ -952,15 +1047,15 @@ var cashMePjObject = zod.z.object({
     economic_activity: textField(),
     monthly_income: currencySchema
   }).strict(),
-  financing_company_guarantor: zod.z.array(
-    zod.z.object({
+  financing_company_guarantor: requiredArray(
+    requiredObject({
       name: textField(),
       cep: cepSchema,
       cpf: cpfSchema,
       address: textField(),
       birth_date: birthDateSchema,
       number: textField(),
-      complement: textField(15).optional(),
+      complement: optionalField(textField(15)),
       cellphone: phoneBRSchema,
       email: emailSchema,
       district: textField(),
@@ -974,7 +1069,9 @@ var cashMePjObject = zod.z.object({
   )
 });
 var cashMePjSchema = cashMePjObject.strict().check(pjRefinement);
-var credito77PfObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/Credito77PFSchema.ts
+var credito77PfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -983,12 +1080,12 @@ var credito77PfObject = zod.z.object({
   birth_date: birthDateSchema,
   number: textField(),
   sex: SexEnum,
-  complement: textField(15).optional(),
+  complement: optionalField(textField(15)),
   mother_name: textField(),
   district: textField(),
   energy_account_in_requester_name: textField(),
   city: textField(),
-  energy_bill_owner_document: cpfCnpjSchema.optional(),
+  energy_bill_owner_document: optionalField(cpfCnpjSchema),
   state: UfEnum,
   nationality: NationalityEnum.default(NATIONALITY_BRAZIL),
   cellphone: phoneBRSchema,
@@ -1001,9 +1098,11 @@ var credito77PfObject = zod.z.object({
   doc_issue_date: issueDateSchema
 });
 var credito77PfSchema = credito77PfObject.strict().check(pfRefinement);
-var credito77PjObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/Credito77PJSchema.ts
+var credito77PjObject = requiredObject({
   ...formalizationExtras,
-  financing_company: zod.z.object({
+  financing_company: requiredObject({
     corporate_name: textField(),
     cep: cepSchema,
     address: textField(),
@@ -1011,7 +1110,7 @@ var credito77PjObject = zod.z.object({
     number: textField(),
     cnpj: cnpjSchema,
     email: emailSchema,
-    complement: textField(15).optional(),
+    complement: optionalField(textField(15)),
     phone: phoneBRSchema,
     district: textField(),
     legal_nature: textField(),
@@ -1021,15 +1120,15 @@ var credito77PjObject = zod.z.object({
     economic_activity: textField(),
     monthly_income: currencySchema
   }).strict(),
-  financing_company_guarantor: zod.z.array(
-    zod.z.object({
+  financing_company_guarantor: requiredArray(
+    requiredObject({
       name: textField(),
       cep: cepSchema,
       cpf: cpfSchema,
       address: textField(),
       birth_date: birthDateSchema,
       number: textField(),
-      complement: textField(15).optional(),
+      complement: optionalField(textField(15)),
       cellphone: phoneBRSchema,
       email: emailSchema,
       district: textField(),
@@ -1043,7 +1142,9 @@ var credito77PjObject = zod.z.object({
   )
 });
 var credito77PjSchema = credito77PjObject.strict().check(pjRefinement);
-var eosPfObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/EosPFSchema.ts
+var eosPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -1052,12 +1153,12 @@ var eosPfObject = zod.z.object({
   birth_date: birthDateSchema,
   number: textField(),
   sex: SexEnum,
-  complement: textField(15).optional(),
+  complement: optionalField(textField(15)),
   mother_name: textField(),
   district: textField(),
   energy_account_in_requester_name: textField(),
   city: textField(),
-  energy_bill_owner_document: cpfCnpjSchema.optional(),
+  energy_bill_owner_document: optionalField(cpfCnpjSchema),
   state: UfEnum,
   nationality: NationalityEnum.default(NATIONALITY_BRAZIL),
   cellphone: phoneBRSchema,
@@ -1070,9 +1171,11 @@ var eosPfObject = zod.z.object({
   doc_issue_date: issueDateSchema
 });
 var eosPfSchema = eosPfObject.strict().check(pfRefinement);
-var eosPjObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/EosPJSchema.ts
+var eosPjObject = requiredObject({
   ...formalizationExtras,
-  financing_company: zod.z.object({
+  financing_company: requiredObject({
     corporate_name: textField(),
     cep: cepSchema,
     address: textField(),
@@ -1080,7 +1183,7 @@ var eosPjObject = zod.z.object({
     number: textField(),
     cnpj: cnpjSchema,
     email: emailSchema,
-    complement: textField(15).optional(),
+    complement: optionalField(textField(15)),
     phone: phoneBRSchema,
     district: textField(),
     legal_nature: textField(),
@@ -1090,15 +1193,15 @@ var eosPjObject = zod.z.object({
     economic_activity: textField(),
     monthly_income: currencySchema
   }).strict(),
-  financing_company_guarantor: zod.z.array(
-    zod.z.object({
+  financing_company_guarantor: requiredArray(
+    requiredObject({
       name: textField(),
       cep: cepSchema,
       cpf: cpfSchema,
       address: textField(),
       birth_date: birthDateSchema,
       number: textField(),
-      complement: textField(15).optional(),
+      complement: optionalField(textField(15)),
       cellphone: phoneBRSchema,
       email: emailSchema,
       district: textField(),
@@ -1112,7 +1215,9 @@ var eosPjObject = zod.z.object({
   )
 });
 var eosPjSchema = eosPjObject.strict().check(pjRefinement);
-var hdtEnergyPfObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/HdtEnergyPFSchema.ts
+var hdtEnergyPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -1121,12 +1226,12 @@ var hdtEnergyPfObject = zod.z.object({
   birth_date: birthDateSchema,
   number: textField(),
   sex: SexEnum,
-  complement: textField(15).optional(),
+  complement: optionalField(textField(15)),
   mother_name: textField(),
   district: textField(),
   energy_account_in_requester_name: textField(),
   city: textField(),
-  energy_bill_owner_document: cpfCnpjSchema.optional(),
+  energy_bill_owner_document: optionalField(cpfCnpjSchema),
   state: UfEnum,
   nationality: NationalityEnum.default(NATIONALITY_BRAZIL),
   cellphone: phoneBRSchema,
@@ -1139,9 +1244,11 @@ var hdtEnergyPfObject = zod.z.object({
   doc_issue_date: issueDateSchema
 });
 var hdtEnergyPfSchema = hdtEnergyPfObject.strict().check(pfRefinement);
-var hdtEnergyPjObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/HdtEnergyPJSchema.ts
+var hdtEnergyPjObject = requiredObject({
   ...formalizationExtras,
-  financing_company: zod.z.object({
+  financing_company: requiredObject({
     corporate_name: textField(),
     cep: cepSchema,
     address: textField(),
@@ -1149,7 +1256,7 @@ var hdtEnergyPjObject = zod.z.object({
     number: textField(),
     cnpj: cnpjSchema,
     email: emailSchema,
-    complement: textField(15).optional(),
+    complement: optionalField(textField(15)),
     phone: phoneBRSchema,
     district: textField(),
     legal_nature: textField(),
@@ -1159,15 +1266,15 @@ var hdtEnergyPjObject = zod.z.object({
     economic_activity: textField(),
     monthly_income: currencySchema
   }).strict(),
-  financing_company_guarantor: zod.z.array(
-    zod.z.object({
+  financing_company_guarantor: requiredArray(
+    requiredObject({
       name: textField(),
       cep: cepSchema,
       cpf: cpfSchema,
       address: textField(),
       birth_date: birthDateSchema,
       number: textField(),
-      complement: textField(15).optional(),
+      complement: optionalField(textField(15)),
       cellphone: phoneBRSchema,
       email: emailSchema,
       district: textField(),
@@ -1181,7 +1288,9 @@ var hdtEnergyPjObject = zod.z.object({
   )
 });
 var hdtEnergyPjSchema = hdtEnergyPjObject.strict().check(pjRefinement);
-var losangoPfObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/LosangoPFSchema.ts
+var losangoPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -1190,12 +1299,12 @@ var losangoPfObject = zod.z.object({
   birth_date: birthDateSchema,
   number: textField(),
   sex: SexEnum,
-  complement: textField(15).optional(),
+  complement: optionalField(textField(15)),
   mother_name: textField(),
   district: textField(),
   energy_account_in_requester_name: textField(),
   city: textField(),
-  energy_bill_owner_document: cpfCnpjSchema.optional(),
+  energy_bill_owner_document: optionalField(cpfCnpjSchema),
   state: UfEnum,
   nationality: NationalityEnum.default(NATIONALITY_BRAZIL),
   cellphone: phoneBRSchema,
@@ -1208,9 +1317,11 @@ var losangoPfObject = zod.z.object({
   doc_issue_date: issueDateSchema
 });
 var losangoPfSchema = losangoPfObject.strict().check(pfRefinement);
-var losangoPjObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/LosangoPJSchema.ts
+var losangoPjObject = requiredObject({
   ...formalizationExtras,
-  financing_company: zod.z.object({
+  financing_company: requiredObject({
     corporate_name: textField(),
     cep: cepSchema,
     address: textField(),
@@ -1218,7 +1329,7 @@ var losangoPjObject = zod.z.object({
     number: textField(),
     cnpj: cnpjSchema,
     email: emailSchema,
-    complement: textField(15).optional(),
+    complement: optionalField(textField(15)),
     phone: phoneBRSchema,
     district: textField(),
     legal_nature: textField(),
@@ -1228,15 +1339,15 @@ var losangoPjObject = zod.z.object({
     economic_activity: textField(),
     monthly_income: currencySchema
   }).strict(),
-  financing_company_guarantor: zod.z.array(
-    zod.z.object({
+  financing_company_guarantor: requiredArray(
+    requiredObject({
       name: textField(),
       cep: cepSchema,
       cpf: cpfSchema,
       address: textField(),
       birth_date: birthDateSchema,
       number: textField(),
-      complement: textField(15).optional(),
+      complement: optionalField(textField(15)),
       cellphone: phoneBRSchema,
       email: emailSchema,
       district: textField(),
@@ -1250,7 +1361,9 @@ var losangoPjObject = zod.z.object({
   )
 });
 var losangoPjSchema = losangoPjObject.strict().check(pjRefinement);
-var safraPfObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/SafraPFSchema.ts
+var safraPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -1259,12 +1372,12 @@ var safraPfObject = zod.z.object({
   birth_date: birthDateSchema,
   number: textField(),
   sex: SexEnum,
-  complement: textField(15).optional(),
+  complement: optionalField(textField(15)),
   mother_name: textField(),
   district: textField(),
   energy_account_in_requester_name: textField(),
   city: textField(),
-  energy_bill_owner_document: cpfCnpjSchema.optional(),
+  energy_bill_owner_document: optionalField(cpfCnpjSchema),
   state: UfEnum,
   nationality: NationalityEnum.default(NATIONALITY_BRAZIL),
   cellphone: phoneBRSchema,
@@ -1277,9 +1390,11 @@ var safraPfObject = zod.z.object({
   doc_issue_date: issueDateSchema
 });
 var safraPfSchema = safraPfObject.strict().check(pfRefinement);
-var safraPjObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/SafraPJSchema.ts
+var safraPjObject = requiredObject({
   ...formalizationExtras,
-  financing_company: zod.z.object({
+  financing_company: requiredObject({
     corporate_name: textField(),
     cep: cepSchema,
     address: textField(),
@@ -1287,7 +1402,7 @@ var safraPjObject = zod.z.object({
     number: textField(),
     cnpj: cnpjSchema,
     email: emailSchema,
-    complement: textField(15).optional(),
+    complement: optionalField(textField(15)),
     phone: phoneBRSchema,
     district: textField(),
     legal_nature: textField(),
@@ -1297,15 +1412,15 @@ var safraPjObject = zod.z.object({
     economic_activity: textField(),
     monthly_income: currencySchema
   }).strict(),
-  financing_company_guarantor: zod.z.array(
-    zod.z.object({
+  financing_company_guarantor: requiredArray(
+    requiredObject({
       name: textField(),
       cep: cepSchema,
       cpf: cpfSchema,
       address: textField(),
       birth_date: birthDateSchema,
       number: textField(),
-      complement: textField(15).optional(),
+      complement: optionalField(textField(15)),
       cellphone: phoneBRSchema,
       email: emailSchema,
       district: textField(),
@@ -1319,7 +1434,9 @@ var safraPjObject = zod.z.object({
   )
 });
 var safraPjSchema = safraPjObject.strict().check(pjRefinement);
-var santanderPfObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/SantanderPFSchema.ts
+var santanderPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -1328,12 +1445,12 @@ var santanderPfObject = zod.z.object({
   birth_date: birthDateSchema,
   number: textField(),
   sex: SexEnum,
-  complement: textField(15).optional(),
+  complement: optionalField(textField(15)),
   mother_name: textField(),
   district: textField(),
   energy_account_in_requester_name: textField(),
   city: textField(),
-  energy_bill_owner_document: cpfCnpjSchema.optional(),
+  energy_bill_owner_document: optionalField(cpfCnpjSchema),
   state: UfEnum,
   nationality: NationalityEnum.default(NATIONALITY_BRAZIL),
   cellphone: phoneBRSchema,
@@ -1346,9 +1463,11 @@ var santanderPfObject = zod.z.object({
   doc_issue_date: issueDateSchema
 });
 var santanderPfSchema = santanderPfObject.strict().check(pfRefinement);
-var santanderPjObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/SantanderPJSchema.ts
+var santanderPjObject = requiredObject({
   ...formalizationExtras,
-  financing_company: zod.z.object({
+  financing_company: requiredObject({
     corporate_name: textField(),
     cep: cepSchema,
     address: textField(),
@@ -1356,7 +1475,7 @@ var santanderPjObject = zod.z.object({
     number: textField(),
     cnpj: cnpjSchema,
     email: emailSchema,
-    complement: textField(15).optional(),
+    complement: optionalField(textField(15)),
     phone: phoneBRSchema,
     district: textField(),
     legal_nature: textField(),
@@ -1366,15 +1485,15 @@ var santanderPjObject = zod.z.object({
     economic_activity: textField(),
     monthly_income: currencySchema
   }).strict(),
-  financing_company_guarantor: zod.z.array(
-    zod.z.object({
+  financing_company_guarantor: requiredArray(
+    requiredObject({
       name: textField(),
       cep: cepSchema,
       cpf: cpfSchema,
       address: textField(),
       birth_date: birthDateSchema,
       number: textField(),
-      complement: textField(15).optional(),
+      complement: optionalField(textField(15)),
       cellphone: phoneBRSchema,
       email: emailSchema,
       district: textField(),
@@ -1388,7 +1507,9 @@ var santanderPjObject = zod.z.object({
   )
 });
 var santanderPjSchema = santanderPjObject.strict().check(pjRefinement);
-var solAgoraPfObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/SolAgoraPFSchema.ts
+var solAgoraPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -1397,12 +1518,12 @@ var solAgoraPfObject = zod.z.object({
   birth_date: birthDateSchema,
   number: textField(),
   sex: SexEnum,
-  complement: textField(15).optional(),
+  complement: optionalField(textField(15)),
   mother_name: textField(),
   district: textField(),
   energy_account_in_requester_name: textField(),
   city: textField(),
-  energy_bill_owner_document: cpfCnpjSchema.optional(),
+  energy_bill_owner_document: optionalField(cpfCnpjSchema),
   state: UfEnum,
   nationality: NationalityEnum.default(NATIONALITY_BRAZIL),
   cellphone: phoneBRSchema,
@@ -1415,9 +1536,11 @@ var solAgoraPfObject = zod.z.object({
   doc_issue_date: issueDateSchema
 });
 var solAgoraPfSchema = solAgoraPfObject.strict().check(pfRefinement);
-var solAgoraPjObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/SolAgoraPJSchema.ts
+var solAgoraPjObject = requiredObject({
   ...formalizationExtras,
-  financing_company: zod.z.object({
+  financing_company: requiredObject({
     corporate_name: textField(),
     cep: cepSchema,
     address: textField(),
@@ -1425,7 +1548,7 @@ var solAgoraPjObject = zod.z.object({
     number: textField(),
     cnpj: cnpjSchema,
     email: emailSchema,
-    complement: textField(15).optional(),
+    complement: optionalField(textField(15)),
     phone: phoneBRSchema,
     district: textField(),
     legal_nature: textField(),
@@ -1435,15 +1558,15 @@ var solAgoraPjObject = zod.z.object({
     economic_activity: textField(),
     monthly_income: currencySchema
   }).strict(),
-  financing_company_qsa: zod.z.array(
-    zod.z.object({
+  financing_company_qsa: requiredArray(
+    requiredObject({
       cep: cepSchema,
       name: textField(),
       address: textField(),
       cpf: cpfSchema,
       number: textField(),
       entry_date: issueDateSchema,
-      complement: textField(15).optional(),
+      complement: optionalField(textField(15)),
       phone: phoneBRSchema,
       district: textField(),
       cellphone: phoneBRSchema,
@@ -1466,7 +1589,9 @@ var solAgoraPjObject = zod.z.object({
   )
 });
 var solAgoraPjSchema = solAgoraPjObject.strict().check(pjRefinement);
-var solfacilPfObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/SolfacilPFSchema.ts
+var solfacilPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -1475,12 +1600,12 @@ var solfacilPfObject = zod.z.object({
   birth_date: birthDateSchema,
   number: textField(),
   sex: SexEnum,
-  complement: textField(15).optional(),
+  complement: optionalField(textField(15)),
   mother_name: textField(),
   district: textField(),
   energy_account_in_requester_name: textField(),
   city: textField(),
-  energy_bill_owner_document: cpfCnpjSchema.optional(),
+  energy_bill_owner_document: optionalField(cpfCnpjSchema),
   state: UfEnum,
   nationality: NationalityEnum.default(NATIONALITY_BRAZIL),
   cellphone: phoneBRSchema,
@@ -1493,9 +1618,11 @@ var solfacilPfObject = zod.z.object({
   doc_issue_date: issueDateSchema
 });
 var solfacilPfSchema = solfacilPfObject.strict().check(pfRefinement);
-var solfacilPjObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/SolfacilPJSchema.ts
+var solfacilPjObject = requiredObject({
   ...formalizationExtras,
-  financing_company: zod.z.object({
+  financing_company: requiredObject({
     corporate_name: textField(),
     cep: cepSchema,
     address: textField(),
@@ -1503,22 +1630,22 @@ var solfacilPjObject = zod.z.object({
     number: textField(),
     cnpj: cnpjSchema,
     email: emailSchema,
-    complement: textField(15).optional(),
+    complement: optionalField(textField(15)),
     phone: phoneBRSchema,
     district: textField(),
     legal_nature: textField(),
     city: textField(),
     state: UfEnum
   }).strict(),
-  financing_company_guarantor: zod.z.array(
-    zod.z.object({
+  financing_company_guarantor: requiredArray(
+    requiredObject({
       name: textField(),
       cep: cepSchema,
       cpf: cpfSchema,
       address: textField(),
       birth_date: birthDateSchema,
       number: textField(),
-      complement: textField(15).optional(),
+      complement: optionalField(textField(15)),
       cellphone: phoneBRSchema,
       phone: phoneBRSchema,
       email: emailSchema,
@@ -1540,7 +1667,9 @@ var solfacilPjObject = zod.z.object({
   )
 });
 var solfacilPjSchema = solfacilPjObject.strict().check(pjRefinement);
-var unifiedPfObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/UnifiedPFSchema.ts
+var unifiedPfObject = requiredObject({
   name: textField(),
   cep: cepSchema,
   cpf: cpfSchema,
@@ -1548,12 +1677,12 @@ var unifiedPfObject = zod.z.object({
   birth_date: birthDateSchema,
   number: textField(),
   sex: SexEnum,
-  complement: textField(15).optional(),
+  complement: optionalField(textField(15)),
   mother_name: textField(),
   district: textField(),
   energy_account_in_requester_name: YesOrNoEnum,
   city: textField(),
-  energy_bill_owner_document: cpfCnpjSchema.optional(),
+  energy_bill_owner_document: optionalField(cpfCnpjSchema),
   state: UfEnum,
   nationality: NationalityEnum.default(NATIONALITY_BRAZIL),
   cellphone: phoneBRSchema,
@@ -1565,60 +1694,62 @@ var unifiedPfObject = zod.z.object({
   issuing_body: textField(6),
   doc_issue_date: issueDateSchema,
   residence_situation: ResidenceTypeEnum,
-  months_in_residence: integerField.optional(),
+  months_in_residence: optionalField(integerField),
   civil_status: CivilStatusEnum,
   uf_naturalness: UfEnum,
-  naturalness: textField().optional(),
+  naturalness: optionalField(textField()),
   nature_of_occupation: NatureOfOccupationTypeEnum,
-  company_time: numberField.optional(),
-  cnpj_proprietary: cnpjSchema.optional(),
-  equity_value: currencySchema.optional(),
+  company_time: optionalField(numberField),
+  cnpj_proprietary: optionalField(cnpjSchema),
+  equity_value: optionalCurrencySchema,
   emitting_state: UfEnum,
   pep_relationship: YesOrNoEnum,
-  social_name: textField().optional(),
-  partner_name: textField().optional(),
-  partner_birth: dateDMYSchema.optional(),
-  partner_type_doc: DocumentTypeEnum.optional(),
-  partner_doc: textField().optional(),
-  partner_cpf: cpfSchema.optional(),
-  partner_city: textField().optional(),
-  communion_regime: CommunionRegimeEnum.optional(),
-  rural_area: textField(3).optional(),
+  social_name: optionalField(textField()),
+  partner_name: optionalField(textField()),
+  partner_birth: optionalField(dateDMYSchema),
+  partner_type_doc: optionalField(DocumentTypeEnum),
+  partner_doc: optionalField(textField()),
+  partner_cpf: optionalField(cpfSchema),
+  partner_city: optionalField(textField()),
+  communion_regime: optionalField(CommunionRegimeEnum),
+  rural_area: optionalField(textField(3)),
   ...formalizationExtras
 });
 var unifiedPfSchema = unifiedPfObject.strict().check(pfRefinement);
-var unifiedPjObject = zod.z.object({
+
+// src/domains/financing/formalization/schemas/UnifiedPJSchema.ts
+var unifiedPjObject = requiredObject({
   ...formalizationExtras,
-  financing_company: zod.z.object({
+  financing_company: requiredObject({
     corporate_name: textField(),
     cnpj: cnpjSchema,
     foundation_date: issueDateSchema,
     address: textField(),
     number: textField(),
     email: emailSchema,
-    complement: textField(15).optional(),
+    complement: optionalField(textField(15)),
     phone: phoneBRSchema,
     district: textField(),
     legal_nature: textField(),
     city: textField(),
     state: UfEnum,
     cep: cepSchema,
-    economic_activity: textField().optional(),
-    economic_activity_group: textField().optional(),
-    monthly_income: currencySchema.optional(),
-    residence_situation: textField().optional(),
-    months_in_residence: integerField.optional(),
-    capital_social: currencySchema.optional()
+    economic_activity: optionalField(textField()),
+    economic_activity_group: optionalField(textField()),
+    monthly_income: optionalCurrencySchema,
+    residence_situation: optionalField(textField()),
+    months_in_residence: optionalField(integerField),
+    capital_social: optionalCurrencySchema
   }).strict(),
-  financing_company_guarantor: zod.z.array(
-    zod.z.object({
+  financing_company_guarantor: requiredArray(
+    requiredObject({
       name: textField(),
       cpf: cpfSchema,
       birth_date: birthDateSchema,
       address: textField(),
       number: textField(),
       cep: cepSchema,
-      complement: textField(15).optional(),
+      complement: optionalField(textField(15)),
       cellphone: phoneBRSchema,
       email: emailSchema,
       district: textField(),
@@ -1627,35 +1758,35 @@ var unifiedPjObject = zod.z.object({
       state: UfEnum,
       mother_name: textField(),
       nationality: NationalityEnum.default(NATIONALITY_BRAZIL),
-      office: textField().optional(),
-      phone: phoneBRSchema.optional(),
-      civil_status: textField().optional(),
-      residence_situation: textField().optional(),
-      months_in_residence: integerField.optional(),
-      type_doc: DocumentTypeEnum.optional(),
-      doc: textField().optional(),
-      issuing_body: textField().optional(),
-      uf_issuing_body: UfEnum.optional(),
-      doc_issue_date: issueDateSchema.optional(),
-      doc_expiration_date: dateDMYSchema.optional(),
-      monthly_income: currencySchema.optional(),
-      patrimony: currencySchema.optional(),
-      naturalness: textField().optional(),
-      uf_naturalness: UfEnum.optional(),
-      pep_relationship: textField().optional(),
-      entry_date: issueDateSchema.optional(),
-      doc_issuance_uf: UfEnum.optional()
+      office: optionalField(textField()),
+      phone: optionalField(phoneBRSchema),
+      civil_status: optionalField(textField()),
+      residence_situation: optionalField(textField()),
+      months_in_residence: optionalField(integerField),
+      type_doc: optionalField(DocumentTypeEnum),
+      doc: optionalField(textField()),
+      issuing_body: optionalField(textField()),
+      uf_issuing_body: optionalField(UfEnum),
+      doc_issue_date: optionalField(issueDateSchema),
+      doc_expiration_date: optionalField(dateDMYSchema),
+      monthly_income: optionalCurrencySchema,
+      patrimony: optionalCurrencySchema,
+      naturalness: optionalField(textField()),
+      uf_naturalness: optionalField(UfEnum),
+      pep_relationship: optionalField(textField()),
+      entry_date: optionalField(issueDateSchema),
+      doc_issuance_uf: optionalField(UfEnum)
     }).strict()
   ).optional(),
-  financing_company_qsa: zod.z.array(
-    zod.z.object({
+  financing_company_qsa: requiredArray(
+    requiredObject({
       name: textField(),
       cpf: cpfSchema,
       birth_date: birthDateSchema,
       address: textField(),
       number: textField(),
       cep: cepSchema,
-      complement: textField(15).optional(),
+      complement: optionalField(textField(15)),
       cellphone: phoneBRSchema,
       email: emailSchema,
       district: textField(),
@@ -1664,24 +1795,24 @@ var unifiedPjObject = zod.z.object({
       state: UfEnum,
       mother_name: textField(),
       nationality: NationalityEnum.default(NATIONALITY_BRAZIL),
-      office: textField().optional(),
-      phone: phoneBRSchema.optional(),
-      civil_status: textField().optional(),
-      residence_situation: textField().optional(),
-      months_in_residence: integerField.optional(),
-      type_doc: DocumentTypeEnum.optional(),
-      doc: textField().optional(),
-      issuing_body: textField().optional(),
-      uf_issuing_body: UfEnum.optional(),
-      doc_issue_date: issueDateSchema.optional(),
-      doc_expiration_date: dateDMYSchema.optional(),
-      monthly_income: currencySchema.optional(),
-      patrimony: currencySchema.optional(),
-      naturalness: textField().optional(),
-      uf_naturalness: UfEnum.optional(),
-      pep_relationship: textField().optional(),
-      entry_date: issueDateSchema.optional(),
-      doc_issuance_uf: UfEnum.optional()
+      office: optionalField(textField()),
+      phone: optionalField(phoneBRSchema),
+      civil_status: optionalField(textField()),
+      residence_situation: optionalField(textField()),
+      months_in_residence: optionalField(integerField),
+      type_doc: optionalField(DocumentTypeEnum),
+      doc: optionalField(textField()),
+      issuing_body: optionalField(textField()),
+      uf_issuing_body: optionalField(UfEnum),
+      doc_issue_date: optionalField(issueDateSchema),
+      doc_expiration_date: optionalField(dateDMYSchema),
+      monthly_income: optionalCurrencySchema,
+      patrimony: optionalCurrencySchema,
+      naturalness: optionalField(textField()),
+      uf_naturalness: optionalField(UfEnum),
+      pep_relationship: optionalField(textField()),
+      entry_date: optionalField(issueDateSchema),
+      doc_issuance_uf: optionalField(UfEnum)
     }).strict()
   ).optional()
 });
@@ -1770,7 +1901,19 @@ var CREDITO77_PRESTAMISTA_FIELDS = {
 function isCredito77WithoutPrestamista(bank, person, options) {
   return bank === "credito77" && person === "pf" && !options.prestamistaIncluso;
 }
+var VALID_BANK_SLUGS = new Set(BANK_SLUGS);
+function assertValidTarget(bank, person) {
+  if (bank !== UNIFIED_SLUG && !VALID_BANK_SLUGS.has(bank)) {
+    throw new TypeError(
+      `Banco desconhecido: ${JSON.stringify(bank)}. Use '${UNIFIED_SLUG}' ou um de: ${BANK_SLUGS.join(", ")}.`
+    );
+  }
+  if (person !== "pf" && person !== "pj") {
+    throw new TypeError(`Tipo de pessoa desconhecido: ${JSON.stringify(person)}. Use 'pf' ou 'pj'.`);
+  }
+}
 function getFormalizationSchema(bank, person, options = {}) {
+  assertValidTarget(bank, person);
   if (bank === UNIFIED_SLUG) {
     return unifiedSchemaByPerson[person];
   }
@@ -1780,6 +1923,7 @@ function getFormalizationSchema(bank, person, options = {}) {
   return person === "pf" ? pfSchemaRegistry[bank] : pjSchemaRegistry[bank];
 }
 function getFormalizationBaseSchema(bank, person, options = {}) {
+  assertValidTarget(bank, person);
   if (bank === UNIFIED_SLUG) {
     return unifiedBaseSchemaByPerson[person];
   }
@@ -1813,6 +1957,24 @@ var FORMALIZATION_FIELD_META = {
     label: "Documento de v\xEDnculo com o titular",
     step: 1
   },
+  energy_bill_owner_document: {
+    kind: "cpfCnpj",
+    label: "Documento do titular da conta",
+    step: 1,
+    placeholder: "Digite o CPF ou CNPJ do titular"
+  },
+  // `text`, e não `select`, porque o schema declara textField(): não há
+  // entrada em FORMALIZATION_OPTION_LABELS para renderizar options.
+  is_installation_at_requester: {
+    kind: "text",
+    label: "Instala\xE7\xE3o no endere\xE7o do solicitante",
+    step: 1
+  },
+  rural_area: {
+    kind: "text",
+    label: "\xC1rea rural",
+    step: 1
+  },
   type_doc: {
     kind: "select",
     label: "Tipo de documento",
@@ -1895,12 +2057,14 @@ var FORMALIZATION_FIELD_META = {
     step: 3,
     placeholder: "Digite o nome da m\xE3e"
   },
-  // naturalness: {
-  //   kind: 'text',
-  //   label: 'Naturalidade',
-  //   step: 3,
-  //   placeholder: 'Selecione uma opção',
-  // },
+  naturalness: {
+    kind: "text",
+    label: "Naturalidade",
+    step: 3,
+    // O bloco comentado trazia 'Selecione uma opção', que é o placeholder do
+    // uf_naturalness logo abaixo — o campo é textField(), não select.
+    placeholder: "Digite a naturalidade"
+  },
   uf_naturalness: {
     kind: "select",
     label: "UF de naturalidade",
@@ -2000,6 +2164,42 @@ var FORMALIZATION_FIELD_META = {
     placeholder: "Digite o tempo de resid\xEAncia em meses"
   },
   financing_company: { kind: "group", label: "Dados da empresa", step: 4 },
+  // Campos de dentro do grupo `financing_company`, que é step 4. O mapa é
+  // plano por nome de campo, então `phone` e `monthly_income` são
+  // compartilhados com o lado PF.
+  corporate_name: {
+    kind: "text",
+    label: "Raz\xE3o social",
+    step: 4,
+    placeholder: "Digite a raz\xE3o social"
+  },
+  cnpj: { kind: "cnpj", label: "CNPJ", step: 4, placeholder: "Digite o CNPJ" },
+  foundation_date: {
+    kind: "date",
+    label: "Data de funda\xE7\xE3o",
+    step: 4,
+    placeholder: "Digite a data de funda\xE7\xE3o"
+  },
+  legal_nature: {
+    kind: "text",
+    label: "Natureza jur\xEDdica",
+    step: 4,
+    placeholder: "Digite a natureza jur\xEDdica"
+  },
+  economic_activity: {
+    kind: "text",
+    label: "Atividade econ\xF4mica",
+    step: 4,
+    placeholder: "Digite a atividade econ\xF4mica"
+  },
+  economic_activity_group: {
+    kind: "text",
+    label: "Grupo de atividade econ\xF4mica",
+    step: 4,
+    placeholder: "Digite o grupo de atividade econ\xF4mica"
+  },
+  capital_social: { kind: "currency", label: "Capital social", step: 4 },
+  phone: { kind: "phone", label: "Telefone", step: 4, placeholder: "Digite o telefone" },
   financing_company_guarantor: { kind: "array", label: "Avalistas", step: 4 },
   financing_company_qsa: {
     kind: "array",
@@ -2007,6 +2207,34 @@ var FORMALIZATION_FIELD_META = {
     step: 4,
     placeholder: "Selecione uma op\xE7\xE3o"
   },
+  // Campos de dentro de `financing_company_guarantor` / `financing_company_qsa`,
+  // ambos step 4.
+  office: { kind: "text", label: "Cargo", step: 4, placeholder: "Digite o cargo" },
+  patrimony: { kind: "currency", label: "Patrim\xF4nio", step: 4 },
+  uf_issuing_body: {
+    kind: "select",
+    label: "UF do \xF3rg\xE3o emissor",
+    step: 4,
+    placeholder: "Selecione uma op\xE7\xE3o"
+  },
+  doc_issuance_uf: {
+    kind: "select",
+    label: "UF de emiss\xE3o do documento",
+    step: 4,
+    placeholder: "Selecione uma op\xE7\xE3o"
+  },
+  doc_expiration_date: {
+    kind: "date",
+    label: "Data de validade do documento",
+    step: 4,
+    placeholder: "Digite a data de validade do documento"
+  },
+  entry_date: {
+    kind: "date",
+    label: "Data de entrada na sociedade",
+    step: 4,
+    placeholder: "Digite a data de entrada na sociedade"
+  },
   social_name: { kind: "text", label: "Nome social", step: 4 },
   partner_name: { kind: "text", label: "Nome do c\xF4njuge", step: 4 },
   partner_birth: {