conversão para typescript 7

This commit is contained in:
Luiz Silva 2026-08-03 20:56:42 -03:00
parent a3738c5e3f
commit 32df6cab5f
16 changed files with 1976 additions and 475 deletions

View file

@ -1,63 +1,65 @@
"use strict";
var __defProp = Object.defineProperty;
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
var __getOwnPropNames = Object.getOwnPropertyNames;
var __hasOwnProp = Object.prototype.hasOwnProperty;
var __export = (target, all) => {
for (var name in all)
__defProp(target, name, { get: all[name], enumerable: true });
};
var __copyProps = (to, from, except, desc) => {
if (from && typeof from === "object" || typeof from === "function") {
for (let key of __getOwnPropNames(from))
if (!__hasOwnProp.call(to, key) && key !== except)
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
}
return to;
};
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
var converter_resposta_e_licencie_para_p_resposta_exports = {};
__export(converter_resposta_e_licencie_para_p_resposta_exports, {
codigosErros: () => codigosErros,
converterRespostaELicencieParaPResposta: () => converterRespostaELicencieParaPResposta
});
module.exports = __toCommonJS(converter_resposta_e_licencie_para_p_resposta_exports);
var import_respostas = require("./respostas");
const codigosErros = {
400: "Erro de requisi\xE7\xE3o",
403: "N\xE3o autenticado",
Object.defineProperty(exports, "__esModule", { value: true });
exports.converterRespostaELicencieParaPResposta = exports.codigosErros = void 0;
const respostas_1 = require("./respostas");
// ─── Tipagem ELicencie ──────────────────────────────────────────────
/**
* Mapa de códigos HTTP de erro usados pelo sistema ELicencie.
*
* Single source of truth para derivar `codigoErroELicencie`.
*/
exports.codigosErros = {
400: "Erro de requisição",
403: "Não autenticado",
500: "Erro interno",
504: "Tempo de resposta excedido"
504: "Tempo de resposta excedido",
};
// ─── Mapeamento bidirecional de códigos ─────────────────────────────
/** ELicencie → P-Resposta (403 → 401) */
const mapaCodigoELicencieParaPResposta = {
400: import_respostas.codigosResposta.erroConhecido,
403: import_respostas.codigosResposta.erroPermissao,
500: import_respostas.codigosResposta.erroDesconhecido,
504: import_respostas.codigosResposta.tempoEsgotado
400: respostas_1.codigosResposta.erroConhecido,
403: respostas_1.codigosResposta.erroPermissao,
500: respostas_1.codigosResposta.erroDesconhecido,
504: respostas_1.codigosResposta.tempoEsgotado,
};
/** P-Resposta → ELicencie (401 → 403, 404 → 400) */
const mapaCodigoPRespostaParaELicencie = {
[import_respostas.codigosResposta.erroConhecido]: 400,
[import_respostas.codigosResposta.erroPermissao]: 403,
[import_respostas.codigosResposta.erroDesconhecido]: 500,
[import_respostas.codigosResposta.erroNaoEncontrado]: 400,
[import_respostas.codigosResposta.tempoEsgotado]: 504
[respostas_1.codigosResposta.erroConhecido]: 400,
[respostas_1.codigosResposta.erroPermissao]: 403,
[respostas_1.codigosResposta.erroDesconhecido]: 500,
[respostas_1.codigosResposta.erroNaoEncontrado]: 400,
[respostas_1.codigosResposta.tempoEsgotado]: 504,
};
// ─── Type guard ─────────────────────────────────────────────────────
/** Detecta se a entrada já está no formato P-Resposta (possui campo `cod`). */
function eRespostaPadrao(entrada) {
return "cod" in entrada;
}
// ─── Conversores de detalhes ────────────────────────────────────────
/** `Record<string, any>` → `string[]` (passthrough se já for array). */
function detalhesParaArray(detalhes) {
if (!detalhes) return void 0;
if (Array.isArray(detalhes)) return detalhes;
if (!detalhes)
return undefined;
if (Array.isArray(detalhes))
return detalhes;
const entries = Object.entries(detalhes);
if (entries.length === 0) return void 0;
if (entries.length === 0)
return undefined;
return entries.map(([chave, valor]) => {
const valorStr = typeof valor === "string" ? valor : JSON.stringify(valor);
return `${chave}: ${valorStr}`;
});
}
// ─── Builder de resposta dual ───────────────────────────────────────
/**
* Monta um objeto compatível com **ambos** os formatos em runtime.
*
* Tipado como `tipoResposta<T>`, mas em runtime também contém
* `codigo`, `erro` e `detalhes` (Record) do formato ELicencie.
*/
function montarRespostaDual(op) {
const detalhesArray = detalhesParaArray(op.detalhesOriginal);
const detalhesRecord = op.detalhesOriginal && !Array.isArray(op.detalhesOriginal) ? op.detalhesOriginal : void 0;
const detalhesRecord = op.detalhesOriginal && !Array.isArray(op.detalhesOriginal) ? op.detalhesOriginal : undefined;
return {
// P-Resposta
cod: op.cod,
@ -69,55 +71,84 @@ function montarRespostaDual(op) {
// ELicencie (runtime)
codigo: op.codigoELicencie,
erro: op.erroELicencie,
...detalhesRecord ? { detalhes: detalhesRecord } : {}
...(detalhesRecord ? { detalhes: detalhesRecord } : {}),
};
}
// ─── Conversor principal ────────────────────────────────────────────
/**
* Converte uma resposta para o formato **P-Resposta** (padrão do pacote),
* mantendo em runtime os campos de **ambos** os formatos para
* compatibilidade durante a transição de sistema.
*
* **Tipo de retorno:** `tipoResposta<T>`
*
* **Conteúdo em runtime:** campos P-Resposta + campos ELicencie
*
* | P-Resposta | ELicencie | Relação |
* |-------------|-------------|----------------------|
* | `cod` | `codigo` | mapeamento de código |
* | `mensagem` | `erro` | mesmo conteúdo |
* | `valor` | `valor` | direto |
* | `eErro` | `eErro` | direto |
* | `eCerto` | — | derivado |
* | `detalhes` | `detalhes` | string[] / Record |
*
* @example
* ```ts
* const res = converterRespostaELicencieParaPResposta(respostaQualquer)
*
* // Consumidor P-Resposta
* if (res.eCerto) console.log(res.valor)
*
* // Consumidor ELicencie (lê campo extra em runtime)
* const resAny = res as any
* if (!resAny.eErro) console.log(resAny.valor)
* ```
*/
const converterRespostaELicencieParaPResposta = (entrada) => {
// ── Entrada já é P-Resposta: enriquecer com campos ELicencie ──
if (eRespostaPadrao(entrada)) {
if (!entrada.eErro) {
return montarRespostaDual({
cod: import_respostas.codigosResposta.sucesso,
cod: respostas_1.codigosResposta.sucesso,
valor: entrada.valor,
mensagem: void 0,
mensagem: undefined,
eErro: false,
codigoELicencie: 200,
erroELicencie: void 0,
detalhesOriginal: entrada.detalhes
erroELicencie: undefined,
detalhesOriginal: entrada.detalhes,
});
}
return montarRespostaDual({
cod: entrada.cod,
valor: void 0,
valor: undefined,
mensagem: entrada.mensagem,
eErro: true,
codigoELicencie: mapaCodigoPRespostaParaELicencie[entrada.cod],
erroELicencie: entrada.mensagem,
detalhesOriginal: entrada.detalhes
detalhesOriginal: entrada.detalhes,
});
}
// ── Entrada é ELicencie: construir P-Resposta + preservar campos ──
if (!entrada.eErro) {
return montarRespostaDual({
cod: import_respostas.codigosResposta.sucesso,
cod: respostas_1.codigosResposta.sucesso,
valor: entrada.valor,
mensagem: void 0,
mensagem: undefined,
eErro: false,
codigoELicencie: entrada.codigo,
erroELicencie: void 0,
detalhesOriginal: entrada.detalhes
erroELicencie: undefined,
detalhesOriginal: entrada.detalhes,
});
}
return montarRespostaDual({
cod: mapaCodigoELicencieParaPResposta[entrada.codigo],
valor: void 0,
valor: undefined,
mensagem: entrada.erro,
eErro: true,
codigoELicencie: entrada.codigo,
erroELicencie: entrada.erro,
detalhesOriginal: entrada.detalhes
detalhesOriginal: entrada.detalhes,
});
};
// Annotate the CommonJS export names for ESM import in node:
0 && (module.exports = {
codigosErros,
converterRespostaELicencieParaPResposta
});
exports.converterRespostaELicencieParaPResposta = converterRespostaELicencieParaPResposta;

View file

@ -1,24 +1,19 @@
"use strict";
var __defProp = Object.defineProperty;
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
var __getOwnPropNames = Object.getOwnPropertyNames;
var __hasOwnProp = Object.prototype.hasOwnProperty;
var __copyProps = (to, from, except, desc) => {
if (from && typeof from === "object" || typeof from === "function") {
for (let key of __getOwnPropNames(from))
if (!__hasOwnProp.call(to, key) && key !== except)
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
// Re-export da API pública do pacote.
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
if (k2 === undefined) k2 = k;
var desc = Object.getOwnPropertyDescriptor(m, k);
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
desc = { enumerable: true, get: function() { return m[k]; } };
}
return to;
Object.defineProperty(o, k2, desc);
}) : (function(o, m, k, k2) {
if (k2 === undefined) k2 = k;
o[k2] = m[k];
}));
var __exportStar = (this && this.__exportStar) || function(m, exports) {
for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
};
var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
var index_exports = {};
module.exports = __toCommonJS(index_exports);
__reExport(index_exports, require("./converter-resposta-e-licencie-para-p-resposta"), module.exports);
__reExport(index_exports, require("./respostas"), module.exports);
// Annotate the CommonJS export names for ESM import in node:
0 && (module.exports = {
...require("./converter-resposta-e-licencie-para-p-resposta"),
...require("./respostas")
});
Object.defineProperty(exports, "__esModule", { value: true });
__exportStar(require("./converter-resposta-e-licencie-para-p-resposta"), exports);
__exportStar(require("./respostas"), exports);

View file

@ -1,117 +1,111 @@
"use strict";
var __defProp = Object.defineProperty;
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
var __getOwnPropNames = Object.getOwnPropertyNames;
var __hasOwnProp = Object.prototype.hasOwnProperty;
var __export = (target, all) => {
for (var name in all)
__defProp(target, name, { get: all[name], enumerable: true });
};
var __copyProps = (to, from, except, desc) => {
if (from && typeof from === "object" || typeof from === "function") {
for (let key of __getOwnPropNames(from))
if (!__hasOwnProp.call(to, key) && key !== except)
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
}
return to;
};
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
var respostas_exports = {};
__export(respostas_exports, {
IniciarRespostas: () => IniciarRespostas,
codigosResposta: () => codigosResposta,
gerarRespostas: () => gerarRespostas,
respostaComuns: () => respostaComuns
});
module.exports = __toCommonJS(respostas_exports);
var codigosResposta = /* @__PURE__ */ ((codigosResposta2) => {
codigosResposta2[codigosResposta2["sucesso"] = 200] = "sucesso";
codigosResposta2[codigosResposta2["erroConhecido"] = 400] = "erroConhecido";
codigosResposta2[codigosResposta2["erroPermissao"] = 401] = "erroPermissao";
codigosResposta2[codigosResposta2["erroNaoEncontrado"] = 404] = "erroNaoEncontrado";
codigosResposta2[codigosResposta2["erroDesconhecido"] = 500] = "erroDesconhecido";
codigosResposta2[codigosResposta2["tempoEsgotado"] = 504] = "tempoEsgotado";
return codigosResposta2;
})(codigosResposta || {});
Object.defineProperty(exports, "__esModule", { value: true });
exports.respostaComuns = exports.gerarRespostas = exports.IniciarRespostas = exports.codigosResposta = void 0;
/**
* Códigos padrão usados pelo contrato de respostas.
*
* Observação: este enum é parte da API pública do pacote.
*/
var codigosResposta;
(function (codigosResposta) {
codigosResposta[codigosResposta["sucesso"] = 200] = "sucesso";
codigosResposta[codigosResposta["erroConhecido"] = 400] = "erroConhecido";
codigosResposta[codigosResposta["erroPermissao"] = 401] = "erroPermissao";
codigosResposta[codigosResposta["erroNaoEncontrado"] = 404] = "erroNaoEncontrado";
codigosResposta[codigosResposta["erroDesconhecido"] = 500] = "erroDesconhecido";
codigosResposta[codigosResposta["tempoEsgotado"] = 504] = "tempoEsgotado";
})(codigosResposta || (exports.codigosResposta = codigosResposta = {}));
// ─── Helper interno ─────────────────────────────────────────────────
/**
* Aplica o callback de interceptação quando fornecido.
* Retorno com cast seguro: o callback preserva a forma da resposta,
* mas o TypeScript não consegue estreitar o genérico <X> ao subtipo
* concreto (ex.: tipoRespostaSucesso<T>), então o cast é inevitável
* e está isolado neste único ponto.
*/
function aplicarCallback(resposta, callback) {
if (!callback) return resposta;
if (!callback)
return resposta;
return callback(resposta);
}
const IniciarRespostas = (callback) => {
const valor = (valor2, detalhes) => {
const IniciarRespostas = (
/** Callback opcional de interceptação — invocado após a construção de cada resposta */
callback) => {
const valor = (valor, detalhes) => {
const resposta = {
cod: 200 /* sucesso */,
valor: valor2,
mensagem: void 0,
cod: codigosResposta.sucesso,
valor,
mensagem: undefined,
eErro: false,
eCerto: true,
detalhes
detalhes,
};
return aplicarCallback(resposta, callback);
};
const valorTrue = (detalhes) => {
const resposta = {
cod: 200 /* sucesso */,
cod: codigosResposta.sucesso,
valor: true,
mensagem: void 0,
mensagem: undefined,
eErro: false,
eCerto: true,
detalhes
detalhes,
};
return aplicarCallback(resposta, callback);
};
const erro = (mensagem, detalhes) => {
const resposta = {
cod: 400 /* erroConhecido */,
valor: void 0,
cod: codigosResposta.erroConhecido,
valor: undefined,
mensagem,
eErro: true,
eCerto: false,
detalhes
detalhes,
};
return aplicarCallback(resposta, callback);
};
const erroPermissao = (mensagem, detalhes) => {
const resposta = {
cod: 401 /* erroPermissao */,
valor: void 0,
mensagem: mensagem || "Sem permiss\xE3o para esse recurso.",
cod: codigosResposta.erroPermissao,
valor: undefined,
mensagem: mensagem || "Sem permissão para esse recurso.",
eErro: true,
eCerto: false,
detalhes
detalhes,
};
return aplicarCallback(resposta, callback);
};
const naoEncontrado = (mensagem, detalhes) => {
const resposta = {
cod: 404 /* erroNaoEncontrado */,
valor: void 0,
mensagem: mensagem || "Registro n\xE3o encontrado ou a execu\xE7\xE3o dessa a\xE7\xE3o depende de um registro existente.",
cod: codigosResposta.erroNaoEncontrado,
valor: undefined,
mensagem: mensagem ||
"Registro não encontrado ou a execução dessa ação depende de um registro existente.",
eErro: true,
eCerto: false,
detalhes
detalhes,
};
return aplicarCallback(resposta, callback);
};
const erroInterno = (op) => {
const mensagemFim = `${op.mensagem || "Erro interno"}`;
const resposta = {
cod: 500 /* erroDesconhecido */,
valor: void 0,
cod: codigosResposta.erroDesconhecido,
valor: undefined,
mensagem: mensagemFim,
eErro: true,
eCerto: false
eCerto: false,
};
return aplicarCallback(resposta, callback);
};
const tempoEsgotado = (mensagem, detalhes) => {
const resposta = {
cod: 504 /* tempoEsgotado */,
valor: void 0,
cod: codigosResposta.tempoEsgotado,
valor: undefined,
mensagem: mensagem || "Tempo de resposta esgotado ao tentar acessar o recurso.",
eErro: true,
eCerto: false,
detalhes
detalhes,
};
return aplicarCallback(resposta, callback);
};
@ -148,15 +142,15 @@ const IniciarRespostas = (callback) => {
/**
* Gera uma resposta de erro quando o tempo de resposta é esgotado
*/
erroEspera
erroEspera,
};
};
const gerarRespostas = IniciarRespostas;
const respostaComuns = IniciarRespostas();
// Annotate the CommonJS export names for ESM import in node:
0 && (module.exports = {
IniciarRespostas,
codigosResposta,
gerarRespostas,
respostaComuns
});
exports.IniciarRespostas = IniciarRespostas;
/**
* @deprecated Use IniciarRespostas em seu lugar
*/
exports.gerarRespostas = exports.IniciarRespostas;
/**
* Instância default (sem handler de interceptação).
*/
exports.respostaComuns = (0, exports.IniciarRespostas)();

View file

@ -0,0 +1,150 @@
import { codigosResposta } from "./respostas";
// ─── Tipagem ELicencie ──────────────────────────────────────────────
/**
* Mapa de códigos HTTP de erro usados pelo sistema ELicencie.
*
* Single source of truth para derivar `codigoErroELicencie`.
*/
export const codigosErros = {
400: "Erro de requisição",
403: "Não autenticado",
500: "Erro interno",
504: "Tempo de resposta excedido",
};
// ─── Mapeamento bidirecional de códigos ─────────────────────────────
/** ELicencie → P-Resposta (403 → 401) */
const mapaCodigoELicencieParaPResposta = {
400: codigosResposta.erroConhecido,
403: codigosResposta.erroPermissao,
500: codigosResposta.erroDesconhecido,
504: codigosResposta.tempoEsgotado,
};
/** P-Resposta → ELicencie (401 → 403, 404 → 400) */
const mapaCodigoPRespostaParaELicencie = {
[codigosResposta.erroConhecido]: 400,
[codigosResposta.erroPermissao]: 403,
[codigosResposta.erroDesconhecido]: 500,
[codigosResposta.erroNaoEncontrado]: 400,
[codigosResposta.tempoEsgotado]: 504,
};
// ─── Type guard ─────────────────────────────────────────────────────
/** Detecta se a entrada já está no formato P-Resposta (possui campo `cod`). */
function eRespostaPadrao(entrada) {
return "cod" in entrada;
}
// ─── Conversores de detalhes ────────────────────────────────────────
/** `Record<string, any>` → `string[]` (passthrough se já for array). */
function detalhesParaArray(detalhes) {
if (!detalhes)
return undefined;
if (Array.isArray(detalhes))
return detalhes;
const entries = Object.entries(detalhes);
if (entries.length === 0)
return undefined;
return entries.map(([chave, valor]) => {
const valorStr = typeof valor === "string" ? valor : JSON.stringify(valor);
return `${chave}: ${valorStr}`;
});
}
// ─── Builder de resposta dual ───────────────────────────────────────
/**
* Monta um objeto compatível com **ambos** os formatos em runtime.
*
* Tipado como `tipoResposta<T>`, mas em runtime também contém
* `codigo`, `erro` e `detalhes` (Record) do formato ELicencie.
*/
function montarRespostaDual(op) {
const detalhesArray = detalhesParaArray(op.detalhesOriginal);
const detalhesRecord = op.detalhesOriginal && !Array.isArray(op.detalhesOriginal) ? op.detalhesOriginal : undefined;
return {
// P-Resposta
cod: op.cod,
valor: op.valor,
mensagem: op.mensagem,
eErro: op.eErro,
eCerto: !op.eErro,
detalhes: detalhesArray,
// ELicencie (runtime)
codigo: op.codigoELicencie,
erro: op.erroELicencie,
...(detalhesRecord ? { detalhes: detalhesRecord } : {}),
};
}
// ─── Conversor principal ────────────────────────────────────────────
/**
* Converte uma resposta para o formato **P-Resposta** (padrão do pacote),
* mantendo em runtime os campos de **ambos** os formatos para
* compatibilidade durante a transição de sistema.
*
* **Tipo de retorno:** `tipoResposta<T>`
*
* **Conteúdo em runtime:** campos P-Resposta + campos ELicencie
*
* | P-Resposta | ELicencie | Relação |
* |-------------|-------------|----------------------|
* | `cod` | `codigo` | mapeamento de código |
* | `mensagem` | `erro` | mesmo conteúdo |
* | `valor` | `valor` | direto |
* | `eErro` | `eErro` | direto |
* | `eCerto` | — | derivado |
* | `detalhes` | `detalhes` | string[] / Record |
*
* @example
* ```ts
* const res = converterRespostaELicencieParaPResposta(respostaQualquer)
*
* // Consumidor P-Resposta
* if (res.eCerto) console.log(res.valor)
*
* // Consumidor ELicencie (lê campo extra em runtime)
* const resAny = res as any
* if (!resAny.eErro) console.log(resAny.valor)
* ```
*/
export const converterRespostaELicencieParaPResposta = (entrada) => {
// ── Entrada já é P-Resposta: enriquecer com campos ELicencie ──
if (eRespostaPadrao(entrada)) {
if (!entrada.eErro) {
return montarRespostaDual({
cod: codigosResposta.sucesso,
valor: entrada.valor,
mensagem: undefined,
eErro: false,
codigoELicencie: 200,
erroELicencie: undefined,
detalhesOriginal: entrada.detalhes,
});
}
return montarRespostaDual({
cod: entrada.cod,
valor: undefined,
mensagem: entrada.mensagem,
eErro: true,
codigoELicencie: mapaCodigoPRespostaParaELicencie[entrada.cod],
erroELicencie: entrada.mensagem,
detalhesOriginal: entrada.detalhes,
});
}
// ── Entrada é ELicencie: construir P-Resposta + preservar campos ──
if (!entrada.eErro) {
return montarRespostaDual({
cod: codigosResposta.sucesso,
valor: entrada.valor,
mensagem: undefined,
eErro: false,
codigoELicencie: entrada.codigo,
erroELicencie: undefined,
detalhesOriginal: entrada.detalhes,
});
}
return montarRespostaDual({
cod: mapaCodigoELicencieParaPResposta[entrada.codigo],
valor: undefined,
mensagem: entrada.erro,
eErro: true,
codigoELicencie: entrada.codigo,
erroELicencie: entrada.erro,
detalhesOriginal: entrada.detalhes,
});
};

View file

@ -1,136 +0,0 @@
/**
* Códigos padrão usados pelo contrato de respostas.
*
* Observação: este enum é parte da API pública do pacote.
*/
declare enum codigosResposta {
sucesso = 200,
erroConhecido = 400,
erroPermissao = 401,
erroNaoEncontrado = 404,
erroDesconhecido = 500,
tempoEsgotado = 504
}
type tipoRespostaSucesso<T> = {
cod: codigosResposta.sucesso;
valor: T;
mensagem: undefined;
eErro: false;
eCerto: true;
detalhes?: string[];
};
type tipoRespostaErro = {
cod: codigosResposta.erroConhecido | codigosResposta.erroDesconhecido | codigosResposta.erroPermissao | codigosResposta.erroNaoEncontrado | codigosResposta.tempoEsgotado;
valor: undefined;
mensagem: string;
eErro: true;
eCerto: false;
detalhes?: string[];
};
type tipoResposta<T> = tipoRespostaSucesso<T> | tipoRespostaErro;
type tipoPrErroInterno = {
erro: any;
mensagem?: string;
local: string;
__filename?: string;
};
/**
* Tipo do callback opcional de interceptação de respostas.
*
* Quando fornecido, é invocado após a construção de toda resposta,
* permitindo side-effects (ex.: logging, telemetria) sem alterar o tipo.
*/
type tipoCallbackResposta = <X>(resposta: tipoResposta<X>) => tipoResposta<X>;
/**
* Cria um conjunto de geradores de respostas.
*
* @param registrarErroInterno callback para registrar/normalizar erros internos.
*/
interface InterfaceRespostas {
valor: <T>(valor: T, detalhes?: string[]) => tipoRespostaSucesso<T>;
valorTrue: (detalhes?: string[]) => tipoRespostaSucesso<true>;
erro: (mensagem: string, detalhes?: string[]) => tipoRespostaErro;
erroPermissao: (mensagem?: string | undefined | null, detalhes?: string[]) => tipoRespostaErro;
erroInterno: (op: tipoPrErroInterno) => tipoRespostaErro;
naoEncontrado: (mensagem?: string | undefined | null, detalhes?: string[]) => tipoRespostaErro;
tempoEsgotado: (mensagem?: string | undefined | null, detalhes?: string[]) => tipoRespostaErro;
erroEspera: (mensagem?: string | undefined | null, detalhes?: string[]) => tipoRespostaErro;
}
declare const IniciarRespostas: (
/** Callback opcional de interceptação — invocado após a construção de cada resposta */
callback?: tipoCallbackResposta) => InterfaceRespostas;
/**
* @deprecated Use IniciarRespostas em seu lugar
*/
declare const gerarRespostas: (callback?: tipoCallbackResposta) => InterfaceRespostas;
/**
* Instância default (sem handler de interceptação).
*/
declare const respostaComuns: InterfaceRespostas;
/**
* Mapa de códigos HTTP de erro usados pelo sistema ELicencie.
*
* Single source of truth para derivar `codigoErroELicencie`.
*/
declare const codigosErros: {
readonly 400: "Erro de requisição";
readonly 403: "Não autenticado";
readonly 500: "Erro interno";
readonly 504: "Tempo de resposta excedido";
};
/** Códigos HTTP de erro reconhecidos pelo ELicencie. */
type codigoErroELicencie = keyof typeof codigosErros;
interface tipoRespostaSucessoELicencie<T> {
codigo: 200;
eErro: false;
valor: T;
erro: undefined;
detalhes?: Record<string, any>;
}
interface tipoRespostaErroELicencie {
codigo: codigoErroELicencie;
eErro: true;
erro: string;
valor: undefined;
detalhes?: Record<string, any>;
}
type tipoRespostaELicencie<T> = tipoRespostaSucessoELicencie<T> | tipoRespostaErroELicencie;
/**
* Durante a transição de sistema, a entrada pode chegar em qualquer um
* dos dois formatos. O conversor detecta e normaliza para P-Resposta.
*/
type tipoEntradaTransicao<T> = tipoRespostaELicencie<T> | tipoResposta<T>;
/**
* Converte uma resposta para o formato **P-Resposta** (padrão do pacote),
* mantendo em runtime os campos de **ambos** os formatos para
* compatibilidade durante a transição de sistema.
*
* **Tipo de retorno:** `tipoResposta<T>`
*
* **Conteúdo em runtime:** campos P-Resposta + campos ELicencie
*
* | P-Resposta | ELicencie | Relação |
* |-------------|-------------|----------------------|
* | `cod` | `codigo` | mapeamento de código |
* | `mensagem` | `erro` | mesmo conteúdo |
* | `valor` | `valor` | direto |
* | `eErro` | `eErro` | direto |
* | `eCerto` | — | derivado |
* | `detalhes` | `detalhes` | string[] / Record |
*
* @example
* ```ts
* const res = converterRespostaELicencieParaPResposta(respostaQualquer)
*
* // Consumidor P-Resposta
* if (res.eCerto) console.log(res.valor)
*
* // Consumidor ELicencie (lê campo extra em runtime)
* const resAny = res as any
* if (!resAny.eErro) console.log(resAny.valor)
* ```
*/
declare const converterRespostaELicencieParaPResposta: <T>(entrada: tipoEntradaTransicao<T>) => tipoResposta<T>;
export { IniciarRespostas, type InterfaceRespostas, type codigoErroELicencie, codigosErros, codigosResposta, converterRespostaELicencieParaPResposta, gerarRespostas, respostaComuns, type tipoCallbackResposta, type tipoEntradaTransicao, type tipoPrErroInterno, type tipoResposta, type tipoRespostaELicencie, type tipoRespostaErro, type tipoRespostaErroELicencie, type tipoRespostaSucesso, type tipoRespostaSucessoELicencie };

3
dist-front/index.js Normal file
View file

@ -0,0 +1,3 @@
// Re-export da API pública do pacote.
export * from "./converter-resposta-e-licencie-para-p-resposta";
export * from "./respostas";

View file

@ -1 +0,0 @@
var l=(o=>(o[o.sucesso=200]="sucesso",o[o.erroConhecido=400]="erroConhecido",o[o.erroPermissao=401]="erroPermissao",o[o.erroNaoEncontrado=404]="erroNaoEncontrado",o[o.erroDesconhecido=500]="erroDesconhecido",o[o.tempoEsgotado=504]="tempoEsgotado",o))(l||{});function n(e,t){return t?t(e):e}var u=e=>{let t=(r,s)=>n({cod:200,valor:r,mensagem:void 0,eErro:!1,eCerto:!0,detalhes:s},e),i=r=>n({cod:200,valor:!0,mensagem:void 0,eErro:!1,eCerto:!0,detalhes:r},e),c=(r,s)=>n({cod:400,valor:void 0,mensagem:r,eErro:!0,eCerto:!1,detalhes:s},e),d=(r,s)=>n({cod:401,valor:void 0,mensagem:r||"Sem permiss\xE3o para esse recurso.",eErro:!0,eCerto:!1,detalhes:s},e),E=(r,s)=>n({cod:404,valor:void 0,mensagem:r||"Registro n\xE3o encontrado ou a execu\xE7\xE3o dessa a\xE7\xE3o depende de um registro existente.",eErro:!0,eCerto:!1,detalhes:s},e),o=r=>{let a={cod:500,valor:void 0,mensagem:`${r.mensagem||"Erro interno"}`,eErro:!0,eCerto:!1};return n(a,e)},g=(r,s)=>n({cod:504,valor:void 0,mensagem:r||"Tempo de resposta esgotado ao tentar acessar o recurso.",eErro:!0,eCerto:!1,detalhes:s},e);return{valor:t,valorTrue:i,erro:c,erroPermissao:d,erroInterno:o,naoEncontrado:E,tempoEsgotado:g,erroEspera:g}},L=u,y=u();var x={400:"Erro de requisi\xE7\xE3o",403:"N\xE3o autenticado",500:"Erro interno",504:"Tempo de resposta excedido"},m={400:400,403:401,500:500,504:504},R={400:400,401:403,500:500,404:400,504:504};function f(e){return"cod"in e}function T(e){if(!e)return;if(Array.isArray(e))return e;let t=Object.entries(e);if(t.length!==0)return t.map(([i,c])=>{let d=typeof c=="string"?c:JSON.stringify(c);return`${i}: ${d}`})}function p(e){let t=T(e.detalhesOriginal),i=e.detalhesOriginal&&!Array.isArray(e.detalhesOriginal)?e.detalhesOriginal:void 0;return{cod:e.cod,valor:e.valor,mensagem:e.mensagem,eErro:e.eErro,eCerto:!e.eErro,detalhes:t,codigo:e.codigoELicencie,erro:e.erroELicencie,...i?{detalhes:i}:{}}}var C=e=>f(e)?e.eErro?p({cod:e.cod,valor:void 0,mensagem:e.mensagem,eErro:!0,codigoELicencie:R[e.cod],erroELicencie:e.mensagem,detalhesOriginal:e.detalhes}):p({cod:200,valor:e.valor,mensagem:void 0,eErro:!1,codigoELicencie:200,erroELicencie:void 0,detalhesOriginal:e.detalhes}):e.eErro?p({cod:m[e.codigo],valor:void 0,mensagem:e.erro,eErro:!0,codigoELicencie:e.codigo,erroELicencie:e.erro,detalhesOriginal:e.detalhes}):p({cod:200,valor:e.valor,mensagem:void 0,eErro:!1,codigoELicencie:e.codigo,erroELicencie:void 0,detalhesOriginal:e.detalhes});export{u as IniciarRespostas,x as codigosErros,l as codigosResposta,C as converterRespostaELicencieParaPResposta,L as gerarRespostas,y as respostaComuns};

152
dist-front/respostas.js Normal file
View file

@ -0,0 +1,152 @@
/**
* Códigos padrão usados pelo contrato de respostas.
*
* Observação: este enum é parte da API pública do pacote.
*/
export var codigosResposta;
(function (codigosResposta) {
codigosResposta[codigosResposta["sucesso"] = 200] = "sucesso";
codigosResposta[codigosResposta["erroConhecido"] = 400] = "erroConhecido";
codigosResposta[codigosResposta["erroPermissao"] = 401] = "erroPermissao";
codigosResposta[codigosResposta["erroNaoEncontrado"] = 404] = "erroNaoEncontrado";
codigosResposta[codigosResposta["erroDesconhecido"] = 500] = "erroDesconhecido";
codigosResposta[codigosResposta["tempoEsgotado"] = 504] = "tempoEsgotado";
})(codigosResposta || (codigosResposta = {}));
// ─── Helper interno ─────────────────────────────────────────────────
/**
* Aplica o callback de interceptação quando fornecido.
* Retorno com cast seguro: o callback preserva a forma da resposta,
* mas o TypeScript não consegue estreitar o genérico <X> ao subtipo
* concreto (ex.: tipoRespostaSucesso<T>), então o cast é inevitável
* e está isolado neste único ponto.
*/
function aplicarCallback(resposta, callback) {
if (!callback)
return resposta;
return callback(resposta);
}
export const IniciarRespostas = (
/** Callback opcional de interceptação — invocado após a construção de cada resposta */
callback) => {
const valor = (valor, detalhes) => {
const resposta = {
cod: codigosResposta.sucesso,
valor,
mensagem: undefined,
eErro: false,
eCerto: true,
detalhes,
};
return aplicarCallback(resposta, callback);
};
const valorTrue = (detalhes) => {
const resposta = {
cod: codigosResposta.sucesso,
valor: true,
mensagem: undefined,
eErro: false,
eCerto: true,
detalhes,
};
return aplicarCallback(resposta, callback);
};
const erro = (mensagem, detalhes) => {
const resposta = {
cod: codigosResposta.erroConhecido,
valor: undefined,
mensagem,
eErro: true,
eCerto: false,
detalhes,
};
return aplicarCallback(resposta, callback);
};
const erroPermissao = (mensagem, detalhes) => {
const resposta = {
cod: codigosResposta.erroPermissao,
valor: undefined,
mensagem: mensagem || "Sem permissão para esse recurso.",
eErro: true,
eCerto: false,
detalhes,
};
return aplicarCallback(resposta, callback);
};
const naoEncontrado = (mensagem, detalhes) => {
const resposta = {
cod: codigosResposta.erroNaoEncontrado,
valor: undefined,
mensagem: mensagem ||
"Registro não encontrado ou a execução dessa ação depende de um registro existente.",
eErro: true,
eCerto: false,
detalhes,
};
return aplicarCallback(resposta, callback);
};
const erroInterno = (op) => {
const mensagemFim = `${op.mensagem || "Erro interno"}`;
const resposta = {
cod: codigosResposta.erroDesconhecido,
valor: undefined,
mensagem: mensagemFim,
eErro: true,
eCerto: false,
};
return aplicarCallback(resposta, callback);
};
const tempoEsgotado = (mensagem, detalhes) => {
const resposta = {
cod: codigosResposta.tempoEsgotado,
valor: undefined,
mensagem: mensagem || "Tempo de resposta esgotado ao tentar acessar o recurso.",
eErro: true,
eCerto: false,
detalhes,
};
return aplicarCallback(resposta, callback);
};
const erroEspera = tempoEsgotado;
return {
/**
* Gera uma resposta de sucesso
*/
valor,
/**
* Gera uma resposta de sucesso com valor true
*/
valorTrue,
/**
* Gera uma resposta de erro conhecido
*/
erro,
/**
* Gera uma resposta de erro de permissão,será necessário fazer o login novamente
*/
erroPermissao,
/**
* Gera uma resposta de erro desconhecido, geralmente tem origem de um exception
*/
erroInterno,
/**
* Gera uma resposta de erro quando um registro não é encontrado ou sua execução depende de um registro existente
*/
naoEncontrado,
/**
* Gera uma resposta de erro quando o tempo de resposta é esgotado
*/
tempoEsgotado,
/**
* Gera uma resposta de erro quando o tempo de resposta é esgotado
*/
erroEspera,
};
};
/**
* @deprecated Use IniciarRespostas em seu lugar
*/
export const gerarRespostas = IniciarRespostas;
/**
* Instância default (sem handler de interceptação).
*/
export const respostaComuns = IniciarRespostas();

View file

@ -1,26 +1,26 @@
{
"name": "p-respostas",
"version": "0.69.0",
"version": "0.70.0",
"description": "Contrato simples de respostas (sucesso/erro) para APIs e serviços.",
"main": "./dist-back/index.js",
"module": "./dist-front/index.mjs",
"module": "./dist-front/index.js",
"exports": {
".": {
"types": "./dist-front/index.d.mts",
"import": "./dist-front/index.mjs",
"types": "./src/index.ts",
"import": "./dist-front/index.js",
"require": "./dist-back/index.js"
}
},
"types": "./dist-front/index.d.mts",
"types": "./src/index.ts",
"engines": {
"node": ">=20"
},
"sideEffects": false,
"scripts": {
"biome": "npx @biomejs/biome check --write ./src",
"build": "npm --no-git-tag-version version minor && pnpm run biome && tsup --config ./node_modules/p-comuns/tsup/tsup.config.ts && pnpm run pacote",
"nodev": "check-node-version --node '= 22'",
"pacote": "npm pack && npm pack && mv $(npm pack --silent) pacote.tgz"
"build": "npm --no-git-tag-version version minor && pnpm run biome && tsc -p tsconfig-back.json && tsc -p tsconfig-front.json",
"check": "pnpm run biome && npx tsc --noEmit",
"nodev": "check-node-version --node '= 22'"
},
"peerDependencies": {
"p-comuns": "git+https://git2.idz.one/publico/_comuns.git#bun",
@ -31,8 +31,7 @@
"@types/node": "^22.19.15",
"check-node-version": "^4.2.1",
"p-comuns": "git+https://git2.idz.one/publico/_comuns.git#bun",
"tsup": "^8.5.1",
"typescript": "^6",
"typescript": "^7",
"zod": "4.4.3"
},
"keywords": [],

Binary file not shown.

1344
pnpm-lock.yaml generated Normal file

File diff suppressed because it is too large Load diff

View file

@ -1,8 +1,4 @@
import {
codigosResposta,
type tipoResposta,
type tipoRespostaErro,
} from "./respostas"
import { codigosResposta, type tipoResposta, type tipoRespostaErro } from "./respostas"
// ─── Tipagem ELicencie ──────────────────────────────────────────────
@ -37,9 +33,7 @@ export interface tipoRespostaErroELicencie {
detalhes?: Record<string, any>
}
export type tipoRespostaELicencie<T> =
| tipoRespostaSucessoELicencie<T>
| tipoRespostaErroELicencie
export type tipoRespostaELicencie<T> = tipoRespostaSucessoELicencie<T> | tipoRespostaErroELicencie
// ─── Tipo de entrada (transição) ────────────────────────────────────
@ -52,10 +46,7 @@ export type tipoEntradaTransicao<T> = tipoRespostaELicencie<T> | tipoResposta<T>
// ─── Mapeamento bidirecional de códigos ─────────────────────────────
/** ELicencie → P-Resposta (403 → 401) */
const mapaCodigoELicencieParaPResposta: Record<
codigoErroELicencie,
tipoRespostaErro["cod"]
> = {
const mapaCodigoELicencieParaPResposta: Record<codigoErroELicencie, tipoRespostaErro["cod"]> = {
400: codigosResposta.erroConhecido,
403: codigosResposta.erroPermissao,
500: codigosResposta.erroDesconhecido,
@ -63,10 +54,7 @@ const mapaCodigoELicencieParaPResposta: Record<
}
/** P-Resposta → ELicencie (401 → 403, 404 → 400) */
const mapaCodigoPRespostaParaELicencie: Record<
tipoRespostaErro["cod"],
codigoErroELicencie
> = {
const mapaCodigoPRespostaParaELicencie: Record<tipoRespostaErro["cod"], codigoErroELicencie> = {
[codigosResposta.erroConhecido]: 400,
[codigosResposta.erroPermissao]: 403,
[codigosResposta.erroDesconhecido]: 500,
@ -77,18 +65,14 @@ const mapaCodigoPRespostaParaELicencie: Record<
// ─── Type guard ─────────────────────────────────────────────────────
/** Detecta se a entrada já está no formato P-Resposta (possui campo `cod`). */
function eRespostaPadrao<T>(
entrada: tipoEntradaTransicao<T>,
): entrada is tipoResposta<T> {
function eRespostaPadrao<T>(entrada: tipoEntradaTransicao<T>): entrada is tipoResposta<T> {
return "cod" in entrada
}
// ─── Conversores de detalhes ────────────────────────────────────────
/** `Record<string, any>` → `string[]` (passthrough se já for array). */
function detalhesParaArray(
detalhes?: Record<string, any> | string[],
): string[] | undefined {
function detalhesParaArray(detalhes?: Record<string, any> | string[]): string[] | undefined {
if (!detalhes) return undefined
if (Array.isArray(detalhes)) return detalhes
@ -120,9 +104,7 @@ function montarRespostaDual<T>(op: {
}): tipoResposta<T> {
const detalhesArray = detalhesParaArray(op.detalhesOriginal)
const detalhesRecord =
op.detalhesOriginal && !Array.isArray(op.detalhesOriginal)
? op.detalhesOriginal
: undefined
op.detalhesOriginal && !Array.isArray(op.detalhesOriginal) ? op.detalhesOriginal : undefined
return {
// P-Resposta

View file

@ -50,9 +50,7 @@ export type tipoPrErroInterno = {
* Quando fornecido, é invocado após a construção de toda resposta,
* permitindo side-effects (ex.: logging, telemetria) sem alterar o tipo.
*/
export type tipoCallbackResposta = <X>(
resposta: tipoResposta<X>,
) => tipoResposta<X>
export type tipoCallbackResposta = <X>(resposta: tipoResposta<X>) => tipoResposta<X>
/**
* Cria um conjunto de geradores de respostas.
@ -63,23 +61,11 @@ export interface InterfaceRespostas {
valor: <T>(valor: T, detalhes?: string[]) => tipoRespostaSucesso<T>
valorTrue: (detalhes?: string[]) => tipoRespostaSucesso<true>
erro: (mensagem: string, detalhes?: string[]) => tipoRespostaErro
erroPermissao: (
mensagem?: string | undefined | null,
detalhes?: string[],
) => tipoRespostaErro
erroPermissao: (mensagem?: string | undefined | null, detalhes?: string[]) => tipoRespostaErro
erroInterno: (op: tipoPrErroInterno) => tipoRespostaErro
naoEncontrado: (
mensagem?: string | undefined | null,
detalhes?: string[],
) => tipoRespostaErro
tempoEsgotado: (
mensagem?: string | undefined | null,
detalhes?: string[],
) => tipoRespostaErro
erroEspera: (
mensagem?: string | undefined | null,
detalhes?: string[],
) => tipoRespostaErro
naoEncontrado: (mensagem?: string | undefined | null, detalhes?: string[]) => tipoRespostaErro
tempoEsgotado: (mensagem?: string | undefined | null, detalhes?: string[]) => tipoRespostaErro
erroEspera: (mensagem?: string | undefined | null, detalhes?: string[]) => tipoRespostaErro
}
// ─── Helper interno ─────────────────────────────────────────────────
@ -190,8 +176,7 @@ export const IniciarRespostas = (
const resposta: tipoRespostaErro = {
cod: codigosResposta.tempoEsgotado,
valor: undefined,
mensagem:
mensagem || "Tempo de resposta esgotado ao tentar acessar o recurso.",
mensagem: mensagem || "Tempo de resposta esgotado ao tentar acessar o recurso.",
eErro: true,
eCerto: false,
detalhes,

View file

@ -1,7 +1,8 @@
{
"extends": "./tsconfig",
"compilerOptions": {
"outDir": "./dist-require",
"outDir": "./dist-back",
"module": "commonjs"
}
}

View file

@ -1,7 +1,9 @@
{
"extends": "./tsconfig",
"compilerOptions": {
"outDir": "./dist-import",
"module": "ES6"
"outDir": "./dist-front",
"module": "ESNext",
"moduleResolution": "bundler"
}
}

View file

@ -13,7 +13,7 @@
"rootDir": "./src", /* Define a pasta raiz para os arquivos de origem. */
/* Emissão */
"declaration": true, /* Gera arquivos .d.ts para os arquivos TypeScript. */
"declaration": false, /* Não gera arquivos .d.ts. */
/* Interoperabilidade de Módulos */
"esModuleInterop": true, /* Habilita a compatibilidade com módulos CommonJS ao importar. */