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

package/index.js

@@ -4,41 +4,74 @@ var zod = require('zod');
 
 // src/shared/fields/primitives.ts
 var REQUIRED_MESSAGE = "Campo obrigat\xF3rio";
-var REQUIRED_STRING_PARAMS = {
-  required_error: REQUIRED_MESSAGE,
-  invalid_type_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`);
 }
-var numberField = zod.z.number({ required_error: REQUIRED_MESSAGE, invalid_type_error: "Valor num\xE9rico inv\xE1lido" }).nonnegative("Valor n\xE3o pode ser negativo");
-var integerField = zod.z.number({ required_error: REQUIRED_MESSAGE, invalid_type_error: "Valor num\xE9rico inv\xE1lido" }).int("Deve ser um n\xFAmero inteiro").nonnegative("Valor n\xE3o pode ser negativo");
-function enumField(values) {
-  return zod.z.enum(values, {
-    errorMap: (issue, ctx) => {
-      if (issue.code === zod.z.ZodIssueCode.invalid_type || issue.code === zod.z.ZodIssueCode.invalid_enum_value && issue.received === "") {
-        return { message: REQUIRED_MESSAGE };
+function requiredNumber(invalidTypeMessage) {
+  return zod.z.number({
+    error: (issue) => issue.input === void 0 ? REQUIRED_MESSAGE : invalidTypeMessage
+  });
+}
+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 { message: ctx.defaultError };
+      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
+    // issue `invalid_value`. Tratamos ausência, tipo inválido e string vazia
+    // (select não preenchido) como "obrigatório"; um valor de fato inválido cai
+    // na mensagem padrão do zod (retornar undefined delega ao error map default).
+    error: (issue) => typeof issue.input !== "string" || issue.input === "" ? REQUIRED_MESSAGE : void 0
+  });
+}
 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.string().url().optional(),
-    mime: zod.z.enum(ACCEPTED_UPLOAD_MIME, {
-      errorMap: () => ({ message: "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([
@@ -75,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
@@ -304,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) {
@@ -421,19 +462,19 @@ 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,
-  zod.z.number({ required_error: REQUIRED_MESSAGE, invalid_type_error: "Valor monet\xE1rio inv\xE1lido" }).positive("Valor deve ser positivo")
-);
-zod.z.number({ required_error: REQUIRED_MESSAGE, invalid_type_error: "Valor num\xE9rico inv\xE1lido" }).int("Deve ser um n\xFAmero inteiro").min(1, "M\xEDnimo 1").max(28, "M\xE1ximo 28");
+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
 var RG_MAX_EMISSION_YEARS = 10;
@@ -448,7 +489,7 @@ function applyPartnerRefinement(data, ctx) {
     const isEmpty = value === void 0 || value === null || typeof value === "string" && value.trim().length === 0;
     if (isEmpty) {
       ctx.addIssue({
-        code: zod.z.ZodIssueCode.custom,
+        code: "custom",
         path: [field],
         message: "Campo obrigat\xF3rio para o estado civil informado"
       });
@@ -462,25 +503,54 @@ function applyCommonRefinements(data, ctx) {
   }
   if (!data.proof_kinship_type) {
     ctx.addIssue({
-      code: zod.z.ZodIssueCode.custom,
+      code: "custom",
       path: ["proof_kinship_type"],
       message: "Tipo de comprovante \xE9 obrigat\xF3rio quando a conta est\xE1 em nome de terceiro"
     });
   }
   if (!data.proof_kinship) {
     ctx.addIssue({
-      code: zod.z.ZodIssueCode.custom,
+      code: "custom",
       path: ["proof_kinship"],
       message: "Documento de v\xEDnculo \xE9 obrigat\xF3rio quando a conta est\xE1 em nome de terceiro"
     });
   }
 }
+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) {
     ctx.addIssue({
-      code: zod.z.ZodIssueCode.custom,
+      code: "custom",
       path: ["cnpj_proprietary"],
       message: "CNPJ do propriet\xE1rio \xE9 obrigat\xF3rio para esta ocupa\xE7\xE3o"
     });
@@ -489,19 +559,32 @@ function applyPfRefinements(data, ctx) {
     const years = yearsSinceDMY(data.doc_issue_date);
     if (years !== null && years > RG_MAX_EMISSION_YEARS) {
       ctx.addIssue({
-        code: zod.z.ZodIssueCode.custom,
+        code: "custom",
         path: ["doc_issue_date"],
         message: `RG deve ter no m\xE1ximo ${RG_MAX_EMISSION_YEARS} anos de emiss\xE3o`
       });
     }
   }
+  applyForeignDocumentRefinement(data, ctx);
 }
 function applyPjRefinements(data, ctx) {
+  if (!isRecord(data)) {
+    return;
+  }
   applyCommonRefinements(data, ctx);
 }
+function onlyUnknownKeysAborted(payload) {
+  return payload.aborted !== true && !payload.issues.some((issue) => issue.continue !== true && issue.code !== "unrecognized_keys");
+}
+var pfRefinement = zod.z.superRefine(applyPfRefinements, {
+  when: onlyUnknownKeysAborted
+});
+var pjRefinement = zod.z.superRefine(applyPjRefinements, {
+  when: onlyUnknownKeysAborted
+});
 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,
@@ -509,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,
@@ -518,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,
@@ -535,10 +618,12 @@ var alfaPfObject = zod.z.object({
   issuing_body: textField(6),
   doc_issue_date: issueDateSchema
 });
-var alfaPfSchema = alfaPfObject.strict().superRefine(applyPfRefinements);
-var alfaPjObject = zod.z.object({
+var alfaPfSchema = alfaPfObject.strict().check(pfRefinement);
+
+// 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(),
@@ -546,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(),
@@ -556,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(),
@@ -577,8 +662,10 @@ var alfaPjObject = zod.z.object({
     }).strict()
   )
 });
-var alfaPjSchema = alfaPjObject.strict().superRefine(applyPjRefinements);
-var bancoDoBrasilPfObject = zod.z.object({
+var alfaPjSchema = alfaPjObject.strict().check(pjRefinement);
+
+// src/domains/financing/formalization/schemas/BancoDoBrasilPFSchema.ts
+var bancoDoBrasilPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -587,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,
@@ -604,10 +691,12 @@ var bancoDoBrasilPfObject = zod.z.object({
   issuing_body: textField(6),
   doc_issue_date: issueDateSchema
 });
-var bancoDoBrasilPfSchema = bancoDoBrasilPfObject.strict().superRefine(applyPfRefinements);
-var bancoDoBrasilPjObject = zod.z.object({
+var bancoDoBrasilPfSchema = bancoDoBrasilPfObject.strict().check(pfRefinement);
+
+// 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(),
@@ -615,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(),
@@ -625,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(),
@@ -646,8 +735,10 @@ var bancoDoBrasilPjObject = zod.z.object({
     }).strict()
   )
 });
-var bancoDoBrasilPjSchema = bancoDoBrasilPjObject.strict().superRefine(applyPjRefinements);
-var btgPfObject = zod.z.object({
+var bancoDoBrasilPjSchema = bancoDoBrasilPjObject.strict().check(pjRefinement);
+
+// src/domains/financing/formalization/schemas/BtgPFSchema.ts
+var btgPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -656,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,
@@ -673,10 +764,12 @@ var btgPfObject = zod.z.object({
   issuing_body: textField(6),
   doc_issue_date: issueDateSchema
 });
-var btgPfSchema = btgPfObject.strict().superRefine(applyPfRefinements);
-var btgPjObject = zod.z.object({
+var btgPfSchema = btgPfObject.strict().check(pfRefinement);
+
+// 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(),
@@ -684,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(),
@@ -694,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,
@@ -726,8 +819,10 @@ var btgPjObject = zod.z.object({
     }).strict()
   )
 });
-var btgPjSchema = btgPjObject.strict().superRefine(applyPjRefinements);
-var bvPfObject = zod.z.object({
+var btgPjSchema = btgPjObject.strict().check(pjRefinement);
+
+// src/domains/financing/formalization/schemas/BvPFSchema.ts
+var bvPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -738,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),
@@ -756,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().superRefine(applyPfRefinements);
-var bvPjObject = zod.z.object({
+var bvPfSchema = bvPfObject.strict().check(pfRefinement);
+
+// 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(),
@@ -778,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(),
@@ -789,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,
@@ -825,8 +922,10 @@ var bvPjObject = zod.z.object({
     }).strict()
   )
 });
-var bvPjSchema = bvPjObject.strict().superRefine(applyPjRefinements);
-var caixaEconomicaFederalPfObject = zod.z.object({
+var bvPjSchema = bvPjObject.strict().check(pjRefinement);
+
+// src/domains/financing/formalization/schemas/CaixaEconomicaFederalPFSchema.ts
+var caixaEconomicaFederalPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -835,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,
@@ -852,10 +951,12 @@ var caixaEconomicaFederalPfObject = zod.z.object({
   issuing_body: textField(6),
   doc_issue_date: issueDateSchema
 });
-var caixaEconomicaFederalPfSchema = caixaEconomicaFederalPfObject.strict().superRefine(applyPfRefinements);
-var caixaEconomicaFederalPjObject = zod.z.object({
+var caixaEconomicaFederalPfSchema = caixaEconomicaFederalPfObject.strict().check(pfRefinement);
+
+// 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(),
@@ -863,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(),
@@ -873,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(),
@@ -894,8 +995,10 @@ var caixaEconomicaFederalPjObject = zod.z.object({
     }).strict()
   )
 });
-var caixaEconomicaFederalPjSchema = caixaEconomicaFederalPjObject.strict().superRefine(applyPjRefinements);
-var cashMePfObject = zod.z.object({
+var caixaEconomicaFederalPjSchema = caixaEconomicaFederalPjObject.strict().check(pjRefinement);
+
+// src/domains/financing/formalization/schemas/CashMePFSchema.ts
+var cashMePfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -904,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,
@@ -921,10 +1024,12 @@ var cashMePfObject = zod.z.object({
   issuing_body: textField(6),
   doc_issue_date: issueDateSchema
 });
-var cashMePfSchema = cashMePfObject.strict().superRefine(applyPfRefinements);
-var cashMePjObject = zod.z.object({
+var cashMePfSchema = cashMePfObject.strict().check(pfRefinement);
+
+// 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(),
@@ -932,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(),
@@ -942,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(),
@@ -963,8 +1068,10 @@ var cashMePjObject = zod.z.object({
     }).strict()
   )
 });
-var cashMePjSchema = cashMePjObject.strict().superRefine(applyPjRefinements);
-var credito77PfObject = zod.z.object({
+var cashMePjSchema = cashMePjObject.strict().check(pjRefinement);
+
+// src/domains/financing/formalization/schemas/Credito77PFSchema.ts
+var credito77PfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -973,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,
@@ -990,10 +1097,12 @@ var credito77PfObject = zod.z.object({
   issuing_body: textField(6),
   doc_issue_date: issueDateSchema
 });
-var credito77PfSchema = credito77PfObject.strict().superRefine(applyPfRefinements);
-var credito77PjObject = zod.z.object({
+var credito77PfSchema = credito77PfObject.strict().check(pfRefinement);
+
+// 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(),
@@ -1001,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(),
@@ -1011,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(),
@@ -1032,8 +1141,10 @@ var credito77PjObject = zod.z.object({
     }).strict()
   )
 });
-var credito77PjSchema = credito77PjObject.strict().superRefine(applyPjRefinements);
-var eosPfObject = zod.z.object({
+var credito77PjSchema = credito77PjObject.strict().check(pjRefinement);
+
+// src/domains/financing/formalization/schemas/EosPFSchema.ts
+var eosPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -1042,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,
@@ -1059,10 +1170,12 @@ var eosPfObject = zod.z.object({
   issuing_body: textField(6),
   doc_issue_date: issueDateSchema
 });
-var eosPfSchema = eosPfObject.strict().superRefine(applyPfRefinements);
-var eosPjObject = zod.z.object({
+var eosPfSchema = eosPfObject.strict().check(pfRefinement);
+
+// 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(),
@@ -1070,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(),
@@ -1080,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(),
@@ -1101,8 +1214,10 @@ var eosPjObject = zod.z.object({
     }).strict()
   )
 });
-var eosPjSchema = eosPjObject.strict().superRefine(applyPjRefinements);
-var hdtEnergyPfObject = zod.z.object({
+var eosPjSchema = eosPjObject.strict().check(pjRefinement);
+
+// src/domains/financing/formalization/schemas/HdtEnergyPFSchema.ts
+var hdtEnergyPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -1111,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,
@@ -1128,10 +1243,12 @@ var hdtEnergyPfObject = zod.z.object({
   issuing_body: textField(6),
   doc_issue_date: issueDateSchema
 });
-var hdtEnergyPfSchema = hdtEnergyPfObject.strict().superRefine(applyPfRefinements);
-var hdtEnergyPjObject = zod.z.object({
+var hdtEnergyPfSchema = hdtEnergyPfObject.strict().check(pfRefinement);
+
+// 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(),
@@ -1139,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(),
@@ -1149,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(),
@@ -1170,8 +1287,10 @@ var hdtEnergyPjObject = zod.z.object({
     }).strict()
   )
 });
-var hdtEnergyPjSchema = hdtEnergyPjObject.strict().superRefine(applyPjRefinements);
-var losangoPfObject = zod.z.object({
+var hdtEnergyPjSchema = hdtEnergyPjObject.strict().check(pjRefinement);
+
+// src/domains/financing/formalization/schemas/LosangoPFSchema.ts
+var losangoPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -1180,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,
@@ -1197,10 +1316,12 @@ var losangoPfObject = zod.z.object({
   issuing_body: textField(6),
   doc_issue_date: issueDateSchema
 });
-var losangoPfSchema = losangoPfObject.strict().superRefine(applyPfRefinements);
-var losangoPjObject = zod.z.object({
+var losangoPfSchema = losangoPfObject.strict().check(pfRefinement);
+
+// 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(),
@@ -1208,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(),
@@ -1218,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(),
@@ -1239,8 +1360,10 @@ var losangoPjObject = zod.z.object({
     }).strict()
   )
 });
-var losangoPjSchema = losangoPjObject.strict().superRefine(applyPjRefinements);
-var safraPfObject = zod.z.object({
+var losangoPjSchema = losangoPjObject.strict().check(pjRefinement);
+
+// src/domains/financing/formalization/schemas/SafraPFSchema.ts
+var safraPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -1249,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,
@@ -1266,10 +1389,12 @@ var safraPfObject = zod.z.object({
   issuing_body: textField(6),
   doc_issue_date: issueDateSchema
 });
-var safraPfSchema = safraPfObject.strict().superRefine(applyPfRefinements);
-var safraPjObject = zod.z.object({
+var safraPfSchema = safraPfObject.strict().check(pfRefinement);
+
+// 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(),
@@ -1277,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(),
@@ -1287,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(),
@@ -1308,8 +1433,10 @@ var safraPjObject = zod.z.object({
     }).strict()
   )
 });
-var safraPjSchema = safraPjObject.strict().superRefine(applyPjRefinements);
-var santanderPfObject = zod.z.object({
+var safraPjSchema = safraPjObject.strict().check(pjRefinement);
+
+// src/domains/financing/formalization/schemas/SantanderPFSchema.ts
+var santanderPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -1318,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,
@@ -1335,10 +1462,12 @@ var santanderPfObject = zod.z.object({
   issuing_body: textField(6),
   doc_issue_date: issueDateSchema
 });
-var santanderPfSchema = santanderPfObject.strict().superRefine(applyPfRefinements);
-var santanderPjObject = zod.z.object({
+var santanderPfSchema = santanderPfObject.strict().check(pfRefinement);
+
+// 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(),
@@ -1346,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(),
@@ -1356,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(),
@@ -1377,8 +1506,10 @@ var santanderPjObject = zod.z.object({
     }).strict()
   )
 });
-var santanderPjSchema = santanderPjObject.strict().superRefine(applyPjRefinements);
-var solAgoraPfObject = zod.z.object({
+var santanderPjSchema = santanderPjObject.strict().check(pjRefinement);
+
+// src/domains/financing/formalization/schemas/SolAgoraPFSchema.ts
+var solAgoraPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -1387,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,
@@ -1404,10 +1535,12 @@ var solAgoraPfObject = zod.z.object({
   issuing_body: textField(6),
   doc_issue_date: issueDateSchema
 });
-var solAgoraPfSchema = solAgoraPfObject.strict().superRefine(applyPfRefinements);
-var solAgoraPjObject = zod.z.object({
+var solAgoraPfSchema = solAgoraPfObject.strict().check(pfRefinement);
+
+// 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(),
@@ -1415,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(),
@@ -1425,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,
@@ -1455,8 +1588,10 @@ var solAgoraPjObject = zod.z.object({
     }).strict()
   )
 });
-var solAgoraPjSchema = solAgoraPjObject.strict().superRefine(applyPjRefinements);
-var solfacilPfObject = zod.z.object({
+var solAgoraPjSchema = solAgoraPjObject.strict().check(pjRefinement);
+
+// src/domains/financing/formalization/schemas/SolfacilPFSchema.ts
+var solfacilPfObject = requiredObject({
   ...formalizationExtras,
   name: textField(),
   cep: cepSchema,
@@ -1465,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,
@@ -1482,10 +1617,12 @@ var solfacilPfObject = zod.z.object({
   issuing_body: textField(6),
   doc_issue_date: issueDateSchema
 });
-var solfacilPfSchema = solfacilPfObject.strict().superRefine(applyPfRefinements);
-var solfacilPjObject = zod.z.object({
+var solfacilPfSchema = solfacilPfObject.strict().check(pfRefinement);
+
+// 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(),
@@ -1493,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,
@@ -1529,8 +1666,10 @@ var solfacilPjObject = zod.z.object({
     }).strict()
   )
 });
-var solfacilPjSchema = solfacilPjObject.strict().superRefine(applyPjRefinements);
-var unifiedPfObject = zod.z.object({
+var solfacilPjSchema = solfacilPjObject.strict().check(pjRefinement);
+
+// src/domains/financing/formalization/schemas/UnifiedPFSchema.ts
+var unifiedPfObject = requiredObject({
   name: textField(),
   cep: cepSchema,
   cpf: cpfSchema,
@@ -1538,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,
@@ -1555,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().superRefine(applyPfRefinements);
-var unifiedPjObject = zod.z.object({
+var unifiedPfSchema = unifiedPfObject.strict().check(pfRefinement);
+
+// 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(),
@@ -1617,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(),
@@ -1654,28 +1795,28 @@ 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()
 });
-var unifiedPjSchema = unifiedPjObject.strict().superRefine(applyPjRefinements);
+var unifiedPjSchema = unifiedPjObject.strict().check(pjRefinement);
 
 // src/domains/financing/formalization/registry.ts
 var UNIFIED_SLUG = "unified";
@@ -1760,16 +1901,29 @@ 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];
   }
   if (isCredito77WithoutPrestamista(bank, person, options)) {
-    return credito77PfObject.omit(CREDITO77_PRESTAMISTA_FIELDS).strict().superRefine(applyPfRefinements);
+    return credito77PfObject.omit(CREDITO77_PRESTAMISTA_FIELDS).strict().check(pfRefinement);
   }
   return person === "pf" ? pfSchemaRegistry[bank] : pjSchemaRegistry[bank];
 }
 function getFormalizationBaseSchema(bank, person, options = {}) {
+  assertValidTarget(bank, person);
   if (bank === UNIFIED_SLUG) {
     return unifiedBaseSchemaByPerson[person];
   }
@@ -1803,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",
@@ -1885,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",
@@ -1990,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",
@@ -1997,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: {
@@ -2053,14 +2291,14 @@ exports.NationalityLabels = NationalityLabels;
 exports.OCCUPATIONS_REQUIRING_CNPJ = OCCUPATIONS_REQUIRING_CNPJ;
 exports.PARTNER_FIELDS = PARTNER_FIELDS;
 exports.UNIFIED_SLUG = UNIFIED_SLUG;
-exports.applyPfRefinements = applyPfRefinements;
-exports.applyPjRefinements = applyPjRefinements;
 exports.getFieldOptions = getFieldOptions;
 exports.getFormalizationBaseSchema = getFormalizationBaseSchema;
 exports.getFormalizationSchema = getFormalizationSchema;
 exports.pfBaseSchemaRegistry = pfBaseSchemaRegistry;
+exports.pfRefinement = pfRefinement;
 exports.pfSchemaRegistry = pfSchemaRegistry;
 exports.pjBaseSchemaRegistry = pjBaseSchemaRegistry;
+exports.pjRefinement = pjRefinement;
 exports.pjSchemaRegistry = pjSchemaRegistry;
 exports.unifiedPfObject = unifiedPfObject;
 exports.unifiedPfSchema = unifiedPfSchema;