conversão para typescript 7
This commit is contained in:
parent
a3738c5e3f
commit
32df6cab5f
16 changed files with 1976 additions and 475 deletions
|
|
@ -1,123 +1,154 @@
|
||||||
"use strict";
|
"use strict";
|
||||||
var __defProp = Object.defineProperty;
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
exports.converterRespostaELicencieParaPResposta = exports.codigosErros = void 0;
|
||||||
var __getOwnPropNames = Object.getOwnPropertyNames;
|
const respostas_1 = require("./respostas");
|
||||||
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
// ─── Tipagem ELicencie ──────────────────────────────────────────────
|
||||||
var __export = (target, all) => {
|
/**
|
||||||
for (var name in all)
|
* Mapa de códigos HTTP de erro usados pelo sistema ELicencie.
|
||||||
__defProp(target, name, { get: all[name], enumerable: true });
|
*
|
||||||
};
|
* Single source of truth para derivar `codigoErroELicencie`.
|
||||||
var __copyProps = (to, from, except, desc) => {
|
*/
|
||||||
if (from && typeof from === "object" || typeof from === "function") {
|
exports.codigosErros = {
|
||||||
for (let key of __getOwnPropNames(from))
|
400: "Erro de requisição",
|
||||||
if (!__hasOwnProp.call(to, key) && key !== except)
|
403: "Não autenticado",
|
||||||
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
500: "Erro interno",
|
||||||
}
|
504: "Tempo de resposta excedido",
|
||||||
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",
|
|
||||||
500: "Erro interno",
|
|
||||||
504: "Tempo de resposta excedido"
|
|
||||||
};
|
};
|
||||||
|
// ─── Mapeamento bidirecional de códigos ─────────────────────────────
|
||||||
|
/** ELicencie → P-Resposta (403 → 401) */
|
||||||
const mapaCodigoELicencieParaPResposta = {
|
const mapaCodigoELicencieParaPResposta = {
|
||||||
400: import_respostas.codigosResposta.erroConhecido,
|
400: respostas_1.codigosResposta.erroConhecido,
|
||||||
403: import_respostas.codigosResposta.erroPermissao,
|
403: respostas_1.codigosResposta.erroPermissao,
|
||||||
500: import_respostas.codigosResposta.erroDesconhecido,
|
500: respostas_1.codigosResposta.erroDesconhecido,
|
||||||
504: import_respostas.codigosResposta.tempoEsgotado
|
504: respostas_1.codigosResposta.tempoEsgotado,
|
||||||
};
|
};
|
||||||
|
/** P-Resposta → ELicencie (401 → 403, 404 → 400) */
|
||||||
const mapaCodigoPRespostaParaELicencie = {
|
const mapaCodigoPRespostaParaELicencie = {
|
||||||
[import_respostas.codigosResposta.erroConhecido]: 400,
|
[respostas_1.codigosResposta.erroConhecido]: 400,
|
||||||
[import_respostas.codigosResposta.erroPermissao]: 403,
|
[respostas_1.codigosResposta.erroPermissao]: 403,
|
||||||
[import_respostas.codigosResposta.erroDesconhecido]: 500,
|
[respostas_1.codigosResposta.erroDesconhecido]: 500,
|
||||||
[import_respostas.codigosResposta.erroNaoEncontrado]: 400,
|
[respostas_1.codigosResposta.erroNaoEncontrado]: 400,
|
||||||
[import_respostas.codigosResposta.tempoEsgotado]: 504
|
[respostas_1.codigosResposta.tempoEsgotado]: 504,
|
||||||
};
|
};
|
||||||
|
// ─── Type guard ─────────────────────────────────────────────────────
|
||||||
|
/** Detecta se a entrada já está no formato P-Resposta (possui campo `cod`). */
|
||||||
function eRespostaPadrao(entrada) {
|
function eRespostaPadrao(entrada) {
|
||||||
return "cod" in entrada;
|
return "cod" in entrada;
|
||||||
}
|
}
|
||||||
|
// ─── Conversores de detalhes ────────────────────────────────────────
|
||||||
|
/** `Record<string, any>` → `string[]` (passthrough se já for array). */
|
||||||
function detalhesParaArray(detalhes) {
|
function detalhesParaArray(detalhes) {
|
||||||
if (!detalhes) return void 0;
|
if (!detalhes)
|
||||||
if (Array.isArray(detalhes)) return detalhes;
|
return undefined;
|
||||||
const entries = Object.entries(detalhes);
|
if (Array.isArray(detalhes))
|
||||||
if (entries.length === 0) return void 0;
|
return detalhes;
|
||||||
return entries.map(([chave, valor]) => {
|
const entries = Object.entries(detalhes);
|
||||||
const valorStr = typeof valor === "string" ? valor : JSON.stringify(valor);
|
if (entries.length === 0)
|
||||||
return `${chave}: ${valorStr}`;
|
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) {
|
function montarRespostaDual(op) {
|
||||||
const detalhesArray = detalhesParaArray(op.detalhesOriginal);
|
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 {
|
return {
|
||||||
// P-Resposta
|
// P-Resposta
|
||||||
cod: op.cod,
|
cod: op.cod,
|
||||||
valor: op.valor,
|
valor: op.valor,
|
||||||
mensagem: op.mensagem,
|
mensagem: op.mensagem,
|
||||||
eErro: op.eErro,
|
eErro: op.eErro,
|
||||||
eCerto: !op.eErro,
|
eCerto: !op.eErro,
|
||||||
detalhes: detalhesArray,
|
detalhes: detalhesArray,
|
||||||
// ELicencie (runtime)
|
// ELicencie (runtime)
|
||||||
codigo: op.codigoELicencie,
|
codigo: op.codigoELicencie,
|
||||||
erro: op.erroELicencie,
|
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) => {
|
const converterRespostaELicencieParaPResposta = (entrada) => {
|
||||||
if (eRespostaPadrao(entrada)) {
|
// ── Entrada já é P-Resposta: enriquecer com campos ELicencie ──
|
||||||
|
if (eRespostaPadrao(entrada)) {
|
||||||
|
if (!entrada.eErro) {
|
||||||
|
return montarRespostaDual({
|
||||||
|
cod: respostas_1.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) {
|
if (!entrada.eErro) {
|
||||||
return montarRespostaDual({
|
return montarRespostaDual({
|
||||||
cod: import_respostas.codigosResposta.sucesso,
|
cod: respostas_1.codigosResposta.sucesso,
|
||||||
valor: entrada.valor,
|
valor: entrada.valor,
|
||||||
mensagem: void 0,
|
mensagem: undefined,
|
||||||
eErro: false,
|
eErro: false,
|
||||||
codigoELicencie: 200,
|
codigoELicencie: entrada.codigo,
|
||||||
erroELicencie: void 0,
|
erroELicencie: undefined,
|
||||||
detalhesOriginal: entrada.detalhes
|
detalhesOriginal: entrada.detalhes,
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
return montarRespostaDual({
|
return montarRespostaDual({
|
||||||
cod: entrada.cod,
|
cod: mapaCodigoELicencieParaPResposta[entrada.codigo],
|
||||||
valor: void 0,
|
valor: undefined,
|
||||||
mensagem: entrada.mensagem,
|
mensagem: entrada.erro,
|
||||||
eErro: true,
|
eErro: true,
|
||||||
codigoELicencie: mapaCodigoPRespostaParaELicencie[entrada.cod],
|
codigoELicencie: entrada.codigo,
|
||||||
erroELicencie: entrada.mensagem,
|
erroELicencie: entrada.erro,
|
||||||
detalhesOriginal: entrada.detalhes
|
detalhesOriginal: entrada.detalhes,
|
||||||
});
|
});
|
||||||
}
|
|
||||||
if (!entrada.eErro) {
|
|
||||||
return montarRespostaDual({
|
|
||||||
cod: import_respostas.codigosResposta.sucesso,
|
|
||||||
valor: entrada.valor,
|
|
||||||
mensagem: void 0,
|
|
||||||
eErro: false,
|
|
||||||
codigoELicencie: entrada.codigo,
|
|
||||||
erroELicencie: void 0,
|
|
||||||
detalhesOriginal: entrada.detalhes
|
|
||||||
});
|
|
||||||
}
|
|
||||||
return montarRespostaDual({
|
|
||||||
cod: mapaCodigoELicencieParaPResposta[entrada.codigo],
|
|
||||||
valor: void 0,
|
|
||||||
mensagem: entrada.erro,
|
|
||||||
eErro: true,
|
|
||||||
codigoELicencie: entrada.codigo,
|
|
||||||
erroELicencie: entrada.erro,
|
|
||||||
detalhesOriginal: entrada.detalhes
|
|
||||||
});
|
|
||||||
};
|
};
|
||||||
// Annotate the CommonJS export names for ESM import in node:
|
exports.converterRespostaELicencieParaPResposta = converterRespostaELicencieParaPResposta;
|
||||||
0 && (module.exports = {
|
|
||||||
codigosErros,
|
|
||||||
converterRespostaELicencieParaPResposta
|
|
||||||
});
|
|
||||||
|
|
|
||||||
|
|
@ -1,24 +1,19 @@
|
||||||
"use strict";
|
"use strict";
|
||||||
var __defProp = Object.defineProperty;
|
// Re-export da API pública do pacote.
|
||||||
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
||||||
var __getOwnPropNames = Object.getOwnPropertyNames;
|
if (k2 === undefined) k2 = k;
|
||||||
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
var desc = Object.getOwnPropertyDescriptor(m, k);
|
||||||
var __copyProps = (to, from, except, desc) => {
|
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
||||||
if (from && typeof from === "object" || typeof from === "function") {
|
desc = { enumerable: true, get: function() { return m[k]; } };
|
||||||
for (let key of __getOwnPropNames(from))
|
}
|
||||||
if (!__hasOwnProp.call(to, key) && key !== except)
|
Object.defineProperty(o, k2, desc);
|
||||||
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
}) : (function(o, m, k, k2) {
|
||||||
}
|
if (k2 === undefined) k2 = k;
|
||||||
return to;
|
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"));
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
__exportStar(require("./converter-resposta-e-licencie-para-p-resposta"), exports);
|
||||||
var index_exports = {};
|
__exportStar(require("./respostas"), 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")
|
|
||||||
});
|
|
||||||
|
|
|
||||||
|
|
@ -1,162 +1,156 @@
|
||||||
"use strict";
|
"use strict";
|
||||||
var __defProp = Object.defineProperty;
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
exports.respostaComuns = exports.gerarRespostas = exports.IniciarRespostas = exports.codigosResposta = void 0;
|
||||||
var __getOwnPropNames = Object.getOwnPropertyNames;
|
/**
|
||||||
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
* Códigos padrão usados pelo contrato de respostas.
|
||||||
var __export = (target, all) => {
|
*
|
||||||
for (var name in all)
|
* Observação: este enum é parte da API pública do pacote.
|
||||||
__defProp(target, name, { get: all[name], enumerable: true });
|
*/
|
||||||
};
|
var codigosResposta;
|
||||||
var __copyProps = (to, from, except, desc) => {
|
(function (codigosResposta) {
|
||||||
if (from && typeof from === "object" || typeof from === "function") {
|
codigosResposta[codigosResposta["sucesso"] = 200] = "sucesso";
|
||||||
for (let key of __getOwnPropNames(from))
|
codigosResposta[codigosResposta["erroConhecido"] = 400] = "erroConhecido";
|
||||||
if (!__hasOwnProp.call(to, key) && key !== except)
|
codigosResposta[codigosResposta["erroPermissao"] = 401] = "erroPermissao";
|
||||||
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
codigosResposta[codigosResposta["erroNaoEncontrado"] = 404] = "erroNaoEncontrado";
|
||||||
}
|
codigosResposta[codigosResposta["erroDesconhecido"] = 500] = "erroDesconhecido";
|
||||||
return to;
|
codigosResposta[codigosResposta["tempoEsgotado"] = 504] = "tempoEsgotado";
|
||||||
};
|
})(codigosResposta || (exports.codigosResposta = codigosResposta = {}));
|
||||||
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
// ─── Helper interno ─────────────────────────────────────────────────
|
||||||
var respostas_exports = {};
|
/**
|
||||||
__export(respostas_exports, {
|
* Aplica o callback de interceptação quando fornecido.
|
||||||
IniciarRespostas: () => IniciarRespostas,
|
* Retorno com cast seguro: o callback preserva a forma da resposta,
|
||||||
codigosResposta: () => codigosResposta,
|
* mas o TypeScript não consegue estreitar o genérico <X> ao subtipo
|
||||||
gerarRespostas: () => gerarRespostas,
|
* concreto (ex.: tipoRespostaSucesso<T>), então o cast é inevitável
|
||||||
respostaComuns: () => respostaComuns
|
* e está isolado neste único ponto.
|
||||||
});
|
*/
|
||||||
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 || {});
|
|
||||||
function aplicarCallback(resposta, callback) {
|
function aplicarCallback(resposta, callback) {
|
||||||
if (!callback) return resposta;
|
if (!callback)
|
||||||
return callback(resposta);
|
return resposta;
|
||||||
|
return callback(resposta);
|
||||||
}
|
}
|
||||||
const IniciarRespostas = (callback) => {
|
const IniciarRespostas = (
|
||||||
const valor = (valor2, detalhes) => {
|
/** Callback opcional de interceptação — invocado após a construção de cada resposta */
|
||||||
const resposta = {
|
callback) => {
|
||||||
cod: 200 /* sucesso */,
|
const valor = (valor, detalhes) => {
|
||||||
valor: valor2,
|
const resposta = {
|
||||||
mensagem: void 0,
|
cod: codigosResposta.sucesso,
|
||||||
eErro: false,
|
valor,
|
||||||
eCerto: true,
|
mensagem: undefined,
|
||||||
detalhes
|
eErro: false,
|
||||||
|
eCerto: true,
|
||||||
|
detalhes,
|
||||||
|
};
|
||||||
|
return aplicarCallback(resposta, callback);
|
||||||
};
|
};
|
||||||
return aplicarCallback(resposta, callback);
|
const valorTrue = (detalhes) => {
|
||||||
};
|
const resposta = {
|
||||||
const valorTrue = (detalhes) => {
|
cod: codigosResposta.sucesso,
|
||||||
const resposta = {
|
valor: true,
|
||||||
cod: 200 /* sucesso */,
|
mensagem: undefined,
|
||||||
valor: true,
|
eErro: false,
|
||||||
mensagem: void 0,
|
eCerto: true,
|
||||||
eErro: false,
|
detalhes,
|
||||||
eCerto: true,
|
};
|
||||||
detalhes
|
return aplicarCallback(resposta, callback);
|
||||||
};
|
};
|
||||||
return aplicarCallback(resposta, callback);
|
const erro = (mensagem, detalhes) => {
|
||||||
};
|
const resposta = {
|
||||||
const erro = (mensagem, detalhes) => {
|
cod: codigosResposta.erroConhecido,
|
||||||
const resposta = {
|
valor: undefined,
|
||||||
cod: 400 /* erroConhecido */,
|
mensagem,
|
||||||
valor: void 0,
|
eErro: true,
|
||||||
mensagem,
|
eCerto: false,
|
||||||
eErro: true,
|
detalhes,
|
||||||
eCerto: false,
|
};
|
||||||
detalhes
|
return aplicarCallback(resposta, callback);
|
||||||
};
|
};
|
||||||
return aplicarCallback(resposta, callback);
|
const erroPermissao = (mensagem, detalhes) => {
|
||||||
};
|
const resposta = {
|
||||||
const erroPermissao = (mensagem, detalhes) => {
|
cod: codigosResposta.erroPermissao,
|
||||||
const resposta = {
|
valor: undefined,
|
||||||
cod: 401 /* erroPermissao */,
|
mensagem: mensagem || "Sem permissão para esse recurso.",
|
||||||
valor: void 0,
|
eErro: true,
|
||||||
mensagem: mensagem || "Sem permiss\xE3o para esse recurso.",
|
eCerto: false,
|
||||||
eErro: true,
|
detalhes,
|
||||||
eCerto: false,
|
};
|
||||||
detalhes
|
return aplicarCallback(resposta, callback);
|
||||||
};
|
};
|
||||||
return aplicarCallback(resposta, callback);
|
const naoEncontrado = (mensagem, detalhes) => {
|
||||||
};
|
const resposta = {
|
||||||
const naoEncontrado = (mensagem, detalhes) => {
|
cod: codigosResposta.erroNaoEncontrado,
|
||||||
const resposta = {
|
valor: undefined,
|
||||||
cod: 404 /* erroNaoEncontrado */,
|
mensagem: mensagem ||
|
||||||
valor: void 0,
|
"Registro não encontrado ou a execução dessa ação depende de um registro existente.",
|
||||||
mensagem: mensagem || "Registro n\xE3o encontrado ou a execu\xE7\xE3o dessa a\xE7\xE3o depende de um registro existente.",
|
eErro: true,
|
||||||
eErro: true,
|
eCerto: false,
|
||||||
eCerto: false,
|
detalhes,
|
||||||
detalhes
|
};
|
||||||
|
return aplicarCallback(resposta, callback);
|
||||||
};
|
};
|
||||||
return aplicarCallback(resposta, callback);
|
const erroInterno = (op) => {
|
||||||
};
|
const mensagemFim = `${op.mensagem || "Erro interno"}`;
|
||||||
const erroInterno = (op) => {
|
const resposta = {
|
||||||
const mensagemFim = `${op.mensagem || "Erro interno"}`;
|
cod: codigosResposta.erroDesconhecido,
|
||||||
const resposta = {
|
valor: undefined,
|
||||||
cod: 500 /* erroDesconhecido */,
|
mensagem: mensagemFim,
|
||||||
valor: void 0,
|
eErro: true,
|
||||||
mensagem: mensagemFim,
|
eCerto: false,
|
||||||
eErro: true,
|
};
|
||||||
eCerto: false
|
return aplicarCallback(resposta, callback);
|
||||||
};
|
};
|
||||||
return aplicarCallback(resposta, callback);
|
const tempoEsgotado = (mensagem, detalhes) => {
|
||||||
};
|
const resposta = {
|
||||||
const tempoEsgotado = (mensagem, detalhes) => {
|
cod: codigosResposta.tempoEsgotado,
|
||||||
const resposta = {
|
valor: undefined,
|
||||||
cod: 504 /* tempoEsgotado */,
|
mensagem: mensagem || "Tempo de resposta esgotado ao tentar acessar o recurso.",
|
||||||
valor: void 0,
|
eErro: true,
|
||||||
mensagem: mensagem || "Tempo de resposta esgotado ao tentar acessar o recurso.",
|
eCerto: false,
|
||||||
eErro: true,
|
detalhes,
|
||||||
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,
|
||||||
};
|
};
|
||||||
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
|
|
||||||
};
|
|
||||||
};
|
};
|
||||||
const gerarRespostas = IniciarRespostas;
|
exports.IniciarRespostas = IniciarRespostas;
|
||||||
const respostaComuns = IniciarRespostas();
|
/**
|
||||||
// Annotate the CommonJS export names for ESM import in node:
|
* @deprecated Use IniciarRespostas em seu lugar
|
||||||
0 && (module.exports = {
|
*/
|
||||||
IniciarRespostas,
|
exports.gerarRespostas = exports.IniciarRespostas;
|
||||||
codigosResposta,
|
/**
|
||||||
gerarRespostas,
|
* Instância default (sem handler de interceptação).
|
||||||
respostaComuns
|
*/
|
||||||
});
|
exports.respostaComuns = (0, exports.IniciarRespostas)();
|
||||||
|
|
|
||||||
150
dist-front/converter-resposta-e-licencie-para-p-resposta.js
Normal file
150
dist-front/converter-resposta-e-licencie-para-p-resposta.js
Normal 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,
|
||||||
|
});
|
||||||
|
};
|
||||||
|
|
@ -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
3
dist-front/index.js
Normal 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";
|
||||||
|
|
@ -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
152
dist-front/respostas.js
Normal 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();
|
||||||
19
package.json
19
package.json
|
|
@ -1,26 +1,26 @@
|
||||||
{
|
{
|
||||||
"name": "p-respostas",
|
"name": "p-respostas",
|
||||||
"version": "0.69.0",
|
"version": "0.70.0",
|
||||||
"description": "Contrato simples de respostas (sucesso/erro) para APIs e serviços.",
|
"description": "Contrato simples de respostas (sucesso/erro) para APIs e serviços.",
|
||||||
"main": "./dist-back/index.js",
|
"main": "./dist-back/index.js",
|
||||||
"module": "./dist-front/index.mjs",
|
"module": "./dist-front/index.js",
|
||||||
"exports": {
|
"exports": {
|
||||||
".": {
|
".": {
|
||||||
"types": "./dist-front/index.d.mts",
|
"types": "./src/index.ts",
|
||||||
"import": "./dist-front/index.mjs",
|
"import": "./dist-front/index.js",
|
||||||
"require": "./dist-back/index.js"
|
"require": "./dist-back/index.js"
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"types": "./dist-front/index.d.mts",
|
"types": "./src/index.ts",
|
||||||
"engines": {
|
"engines": {
|
||||||
"node": ">=20"
|
"node": ">=20"
|
||||||
},
|
},
|
||||||
"sideEffects": false,
|
"sideEffects": false,
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"biome": "npx @biomejs/biome check --write ./src",
|
"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",
|
"build": "npm --no-git-tag-version version minor && pnpm run biome && tsc -p tsconfig-back.json && tsc -p tsconfig-front.json",
|
||||||
"nodev": "check-node-version --node '= 22'",
|
"check": "pnpm run biome && npx tsc --noEmit",
|
||||||
"pacote": "npm pack && npm pack && mv $(npm pack --silent) pacote.tgz"
|
"nodev": "check-node-version --node '= 22'"
|
||||||
},
|
},
|
||||||
"peerDependencies": {
|
"peerDependencies": {
|
||||||
"p-comuns": "git+https://git2.idz.one/publico/_comuns.git#bun",
|
"p-comuns": "git+https://git2.idz.one/publico/_comuns.git#bun",
|
||||||
|
|
@ -31,8 +31,7 @@
|
||||||
"@types/node": "^22.19.15",
|
"@types/node": "^22.19.15",
|
||||||
"check-node-version": "^4.2.1",
|
"check-node-version": "^4.2.1",
|
||||||
"p-comuns": "git+https://git2.idz.one/publico/_comuns.git#bun",
|
"p-comuns": "git+https://git2.idz.one/publico/_comuns.git#bun",
|
||||||
"tsup": "^8.5.1",
|
"typescript": "^7",
|
||||||
"typescript": "^6",
|
|
||||||
"zod": "4.4.3"
|
"zod": "4.4.3"
|
||||||
},
|
},
|
||||||
"keywords": [],
|
"keywords": [],
|
||||||
|
|
|
||||||
BIN
pacote.tgz
BIN
pacote.tgz
Binary file not shown.
1344
pnpm-lock.yaml
generated
Normal file
1344
pnpm-lock.yaml
generated
Normal file
File diff suppressed because it is too large
Load diff
|
|
@ -1,8 +1,4 @@
|
||||||
import {
|
import { codigosResposta, type tipoResposta, type tipoRespostaErro } from "./respostas"
|
||||||
codigosResposta,
|
|
||||||
type tipoResposta,
|
|
||||||
type tipoRespostaErro,
|
|
||||||
} from "./respostas"
|
|
||||||
|
|
||||||
// ─── Tipagem ELicencie ──────────────────────────────────────────────
|
// ─── Tipagem ELicencie ──────────────────────────────────────────────
|
||||||
|
|
||||||
|
|
@ -37,9 +33,7 @@ export interface tipoRespostaErroELicencie {
|
||||||
detalhes?: Record<string, any>
|
detalhes?: Record<string, any>
|
||||||
}
|
}
|
||||||
|
|
||||||
export type tipoRespostaELicencie<T> =
|
export type tipoRespostaELicencie<T> = tipoRespostaSucessoELicencie<T> | tipoRespostaErroELicencie
|
||||||
| tipoRespostaSucessoELicencie<T>
|
|
||||||
| tipoRespostaErroELicencie
|
|
||||||
|
|
||||||
// ─── Tipo de entrada (transição) ────────────────────────────────────
|
// ─── Tipo de entrada (transição) ────────────────────────────────────
|
||||||
|
|
||||||
|
|
@ -52,10 +46,7 @@ export type tipoEntradaTransicao<T> = tipoRespostaELicencie<T> | tipoResposta<T>
|
||||||
// ─── Mapeamento bidirecional de códigos ─────────────────────────────
|
// ─── Mapeamento bidirecional de códigos ─────────────────────────────
|
||||||
|
|
||||||
/** ELicencie → P-Resposta (403 → 401) */
|
/** ELicencie → P-Resposta (403 → 401) */
|
||||||
const mapaCodigoELicencieParaPResposta: Record<
|
const mapaCodigoELicencieParaPResposta: Record<codigoErroELicencie, tipoRespostaErro["cod"]> = {
|
||||||
codigoErroELicencie,
|
|
||||||
tipoRespostaErro["cod"]
|
|
||||||
> = {
|
|
||||||
400: codigosResposta.erroConhecido,
|
400: codigosResposta.erroConhecido,
|
||||||
403: codigosResposta.erroPermissao,
|
403: codigosResposta.erroPermissao,
|
||||||
500: codigosResposta.erroDesconhecido,
|
500: codigosResposta.erroDesconhecido,
|
||||||
|
|
@ -63,10 +54,7 @@ const mapaCodigoELicencieParaPResposta: Record<
|
||||||
}
|
}
|
||||||
|
|
||||||
/** P-Resposta → ELicencie (401 → 403, 404 → 400) */
|
/** P-Resposta → ELicencie (401 → 403, 404 → 400) */
|
||||||
const mapaCodigoPRespostaParaELicencie: Record<
|
const mapaCodigoPRespostaParaELicencie: Record<tipoRespostaErro["cod"], codigoErroELicencie> = {
|
||||||
tipoRespostaErro["cod"],
|
|
||||||
codigoErroELicencie
|
|
||||||
> = {
|
|
||||||
[codigosResposta.erroConhecido]: 400,
|
[codigosResposta.erroConhecido]: 400,
|
||||||
[codigosResposta.erroPermissao]: 403,
|
[codigosResposta.erroPermissao]: 403,
|
||||||
[codigosResposta.erroDesconhecido]: 500,
|
[codigosResposta.erroDesconhecido]: 500,
|
||||||
|
|
@ -77,18 +65,14 @@ const mapaCodigoPRespostaParaELicencie: Record<
|
||||||
// ─── Type guard ─────────────────────────────────────────────────────
|
// ─── Type guard ─────────────────────────────────────────────────────
|
||||||
|
|
||||||
/** Detecta se a entrada já está no formato P-Resposta (possui campo `cod`). */
|
/** Detecta se a entrada já está no formato P-Resposta (possui campo `cod`). */
|
||||||
function eRespostaPadrao<T>(
|
function eRespostaPadrao<T>(entrada: tipoEntradaTransicao<T>): entrada is tipoResposta<T> {
|
||||||
entrada: tipoEntradaTransicao<T>,
|
|
||||||
): entrada is tipoResposta<T> {
|
|
||||||
return "cod" in entrada
|
return "cod" in entrada
|
||||||
}
|
}
|
||||||
|
|
||||||
// ─── Conversores de detalhes ────────────────────────────────────────
|
// ─── Conversores de detalhes ────────────────────────────────────────
|
||||||
|
|
||||||
/** `Record<string, any>` → `string[]` (passthrough se já for array). */
|
/** `Record<string, any>` → `string[]` (passthrough se já for array). */
|
||||||
function detalhesParaArray(
|
function detalhesParaArray(detalhes?: Record<string, any> | string[]): string[] | undefined {
|
||||||
detalhes?: Record<string, any> | string[],
|
|
||||||
): string[] | undefined {
|
|
||||||
if (!detalhes) return undefined
|
if (!detalhes) return undefined
|
||||||
if (Array.isArray(detalhes)) return detalhes
|
if (Array.isArray(detalhes)) return detalhes
|
||||||
|
|
||||||
|
|
@ -120,9 +104,7 @@ function montarRespostaDual<T>(op: {
|
||||||
}): tipoResposta<T> {
|
}): tipoResposta<T> {
|
||||||
const detalhesArray = detalhesParaArray(op.detalhesOriginal)
|
const detalhesArray = detalhesParaArray(op.detalhesOriginal)
|
||||||
const detalhesRecord =
|
const detalhesRecord =
|
||||||
op.detalhesOriginal && !Array.isArray(op.detalhesOriginal)
|
op.detalhesOriginal && !Array.isArray(op.detalhesOriginal) ? op.detalhesOriginal : undefined
|
||||||
? op.detalhesOriginal
|
|
||||||
: undefined
|
|
||||||
|
|
||||||
return {
|
return {
|
||||||
// P-Resposta
|
// P-Resposta
|
||||||
|
|
|
||||||
|
|
@ -50,9 +50,7 @@ export type tipoPrErroInterno = {
|
||||||
* Quando fornecido, é invocado após a construção de toda resposta,
|
* Quando fornecido, é invocado após a construção de toda resposta,
|
||||||
* permitindo side-effects (ex.: logging, telemetria) sem alterar o tipo.
|
* permitindo side-effects (ex.: logging, telemetria) sem alterar o tipo.
|
||||||
*/
|
*/
|
||||||
export type tipoCallbackResposta = <X>(
|
export type tipoCallbackResposta = <X>(resposta: tipoResposta<X>) => tipoResposta<X>
|
||||||
resposta: tipoResposta<X>,
|
|
||||||
) => tipoResposta<X>
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Cria um conjunto de geradores de respostas.
|
* Cria um conjunto de geradores de respostas.
|
||||||
|
|
@ -63,23 +61,11 @@ export interface InterfaceRespostas {
|
||||||
valor: <T>(valor: T, detalhes?: string[]) => tipoRespostaSucesso<T>
|
valor: <T>(valor: T, detalhes?: string[]) => tipoRespostaSucesso<T>
|
||||||
valorTrue: (detalhes?: string[]) => tipoRespostaSucesso<true>
|
valorTrue: (detalhes?: string[]) => tipoRespostaSucesso<true>
|
||||||
erro: (mensagem: string, detalhes?: string[]) => tipoRespostaErro
|
erro: (mensagem: string, detalhes?: string[]) => tipoRespostaErro
|
||||||
erroPermissao: (
|
erroPermissao: (mensagem?: string | undefined | null, detalhes?: string[]) => tipoRespostaErro
|
||||||
mensagem?: string | undefined | null,
|
|
||||||
detalhes?: string[],
|
|
||||||
) => tipoRespostaErro
|
|
||||||
erroInterno: (op: tipoPrErroInterno) => tipoRespostaErro
|
erroInterno: (op: tipoPrErroInterno) => tipoRespostaErro
|
||||||
naoEncontrado: (
|
naoEncontrado: (mensagem?: string | undefined | null, detalhes?: string[]) => tipoRespostaErro
|
||||||
mensagem?: string | undefined | null,
|
tempoEsgotado: (mensagem?: string | undefined | null, detalhes?: string[]) => tipoRespostaErro
|
||||||
detalhes?: string[],
|
erroEspera: (mensagem?: string | undefined | null, detalhes?: string[]) => tipoRespostaErro
|
||||||
) => tipoRespostaErro
|
|
||||||
tempoEsgotado: (
|
|
||||||
mensagem?: string | undefined | null,
|
|
||||||
detalhes?: string[],
|
|
||||||
) => tipoRespostaErro
|
|
||||||
erroEspera: (
|
|
||||||
mensagem?: string | undefined | null,
|
|
||||||
detalhes?: string[],
|
|
||||||
) => tipoRespostaErro
|
|
||||||
}
|
}
|
||||||
|
|
||||||
// ─── Helper interno ─────────────────────────────────────────────────
|
// ─── Helper interno ─────────────────────────────────────────────────
|
||||||
|
|
@ -190,8 +176,7 @@ export const IniciarRespostas = (
|
||||||
const resposta: tipoRespostaErro = {
|
const resposta: tipoRespostaErro = {
|
||||||
cod: codigosResposta.tempoEsgotado,
|
cod: codigosResposta.tempoEsgotado,
|
||||||
valor: undefined,
|
valor: undefined,
|
||||||
mensagem:
|
mensagem: mensagem || "Tempo de resposta esgotado ao tentar acessar o recurso.",
|
||||||
mensagem || "Tempo de resposta esgotado ao tentar acessar o recurso.",
|
|
||||||
eErro: true,
|
eErro: true,
|
||||||
eCerto: false,
|
eCerto: false,
|
||||||
detalhes,
|
detalhes,
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,8 @@
|
||||||
{
|
{
|
||||||
"extends": "./tsconfig",
|
"extends": "./tsconfig",
|
||||||
"compilerOptions": {
|
"compilerOptions": {
|
||||||
"outDir": "./dist-require",
|
"outDir": "./dist-back",
|
||||||
"module": "commonjs"
|
"module": "commonjs"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,9 @@
|
||||||
{
|
{
|
||||||
"extends": "./tsconfig",
|
"extends": "./tsconfig",
|
||||||
"compilerOptions": {
|
"compilerOptions": {
|
||||||
"outDir": "./dist-import",
|
"outDir": "./dist-front",
|
||||||
"module": "ES6"
|
"module": "ESNext",
|
||||||
|
"moduleResolution": "bundler"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -13,7 +13,7 @@
|
||||||
"rootDir": "./src", /* Define a pasta raiz para os arquivos de origem. */
|
"rootDir": "./src", /* Define a pasta raiz para os arquivos de origem. */
|
||||||
|
|
||||||
/* Emissão */
|
/* Emissão */
|
||||||
"declaration": true, /* Gera arquivos .d.ts para os arquivos TypeScript. */
|
"declaration": false, /* Não gera arquivos .d.ts. */
|
||||||
|
|
||||||
/* Interoperabilidade de Módulos */
|
/* Interoperabilidade de Módulos */
|
||||||
"esModuleInterop": true, /* Habilita a compatibilidade com módulos CommonJS ao importar. */
|
"esModuleInterop": true, /* Habilita a compatibilidade com módulos CommonJS ao importar. */
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue