conversão para typescript 7

dist-front/converter-resposta-e-licencie-para-p-resposta.js

@@ -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,
+    });
+};

dist-front/index.d.mts

@@ -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 };

dist-front/index.js

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

dist-front/index.mjs

@@ -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};

dist-front/respostas.js

@@ -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();