@rodrigobeber/patoai-dtos 4.7.71 → 4.7.73

package/dist/uh/index.d.ts

@@ -14,3 +14,5 @@ export * from './sent-template.dto';
 export * from './send-text.dto';
 export * from './send-buttons.dto';
 export * from './message-status.dto';
+export * from './telegram.dto';
+export * from './uh-public-url';

package/dist/uh/index.js

@@ -30,3 +30,5 @@ __exportStar(require("./sent-template.dto"), exports);
 __exportStar(require("./send-text.dto"), exports);
 __exportStar(require("./send-buttons.dto"), exports);
 __exportStar(require("./message-status.dto"), exports);
+__exportStar(require("./telegram.dto"), exports);
+__exportStar(require("./uh-public-url"), exports);

package/dist/uh/telegram.dto.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Contrato RPC crew -> uh para o ciclo de vida do webhook do Telegram.
+ *
+ * O onboarding e feito no crew, mas quem fala com a Bot API e o uh: o `secret_token`
+ * do webhook e o APP_SECRET do uh e a URL registrada e a rota do proprio uh
+ * (POST /telegram/:botId). Por isso getMe/setWebhook/deleteWebhook rodam la.
+ */
+export interface TelegramSetupDto {
+    /** Token do bot no formato `<botId>:<hash>`, obtido no @BotFather. */
+    token: string;
+}
+export interface TelegramSetupResultDto {
+    /** Id numerico do bot (prefixo do token). Vira o `channelId` do canal. */
+    botId: string;
+    username: string;
+    firstName: string;
+    /** URL registrada no setWebhook (sem o secret da query). */
+    webhookUrl: string;
+}
+export interface TelegramWebhookInfoDto {
+    botId: string;
+    username: string;
+    /** URL atualmente registrada no Telegram. Vazia quando nao ha webhook. */
+    url: string;
+    pendingUpdateCount: number;
+    lastErrorMessage?: string;
+    /** Unix timestamp (segundos) do ultimo erro de entrega. */
+    lastErrorDate?: number;
+}

package/dist/uh/telegram.dto.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/uh/uh-public-url.d.ts

@@ -0,0 +1,23 @@
+/**
+ * URL publica do patoai-uh — o endereco onde os canais registram seus webhooks
+ * (Telegram `setWebhook`, Evolution). FONTE UNICA: o uh e o crew derivam daqui.
+ */
+/** Tunel que expoe o Traefik local em dev (o uh precisa ser alcancavel pela internet). */
+export declare const UH_DEV_PUBLIC_URL = "https://f20bzrdj-8090.brs.devtunnels.ms/uh";
+/**
+ * Deriva a URL publica do uh a partir da URL do painel (`FRONTEND_URL`), que ja chega em todos
+ * os pods pelo `env-configmap`:
+ *
+ *   chat.upflows.com.br      -> uh.upflows.com.br       (prod)
+ *   chat-hml.upflows.com.br  -> uh-hml.upflows.com.br   (hml)
+ *   chat-tst.upflows.com.br  -> uh-tst.upflows.com.br   (tst)
+ *
+ * Sem match (dev, onde `FRONTEND_URL` e localhost), cai no tunel de desenvolvimento.
+ *
+ * NAO derivar isso de `NODE_ENV`: HML e TST usam AMBOS `staging`, entao o TST acabaria
+ * apontando para o host do HML — bug silencioso que o `evolution.webhookUrl` do crew carregava.
+ *
+ * Premissa: a convencao de dominio `<servico>[-ambiente].upflows.com.br`, valida hoje para todos
+ * os servicos. Se o painel ganhar dominio proprio (white-label), esta derivacao para de valer.
+ */
+export declare function buildUhPublicUrl(frontendUrl?: string): string;

package/dist/uh/uh-public-url.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * URL publica do patoai-uh — o endereco onde os canais registram seus webhooks
+ * (Telegram `setWebhook`, Evolution). FONTE UNICA: o uh e o crew derivam daqui.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UH_DEV_PUBLIC_URL = void 0;
+exports.buildUhPublicUrl = buildUhPublicUrl;
+/** Tunel que expoe o Traefik local em dev (o uh precisa ser alcancavel pela internet). */
+exports.UH_DEV_PUBLIC_URL = 'https://f20bzrdj-8090.brs.devtunnels.ms/uh';
+/** `https://chat-hml.upflows.com.br` -> captura `-hml`. Em producao o sufixo e vazio. */
+const PANEL_URL_REGEX = /^https:\/\/chat(-[a-z]+)?\.upflows\.com\.br\/?$/i;
+/**
+ * Deriva a URL publica do uh a partir da URL do painel (`FRONTEND_URL`), que ja chega em todos
+ * os pods pelo `env-configmap`:
+ *
+ *   chat.upflows.com.br      -> uh.upflows.com.br       (prod)
+ *   chat-hml.upflows.com.br  -> uh-hml.upflows.com.br   (hml)
+ *   chat-tst.upflows.com.br  -> uh-tst.upflows.com.br   (tst)
+ *
+ * Sem match (dev, onde `FRONTEND_URL` e localhost), cai no tunel de desenvolvimento.
+ *
+ * NAO derivar isso de `NODE_ENV`: HML e TST usam AMBOS `staging`, entao o TST acabaria
+ * apontando para o host do HML — bug silencioso que o `evolution.webhookUrl` do crew carregava.
+ *
+ * Premissa: a convencao de dominio `<servico>[-ambiente].upflows.com.br`, valida hoje para todos
+ * os servicos. Se o painel ganhar dominio proprio (white-label), esta derivacao para de valer.
+ */
+function buildUhPublicUrl(frontendUrl) {
+    const match = PANEL_URL_REGEX.exec((frontendUrl === null || frontendUrl === void 0 ? void 0 : frontendUrl.trim()) || '');
+    return match ? `https://uh${match[1] || ''}.upflows.com.br` : exports.UH_DEV_PUBLIC_URL;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rodrigobeber/patoai-dtos",
-  "version": "4.7.71",
+  "version": "4.7.73",
   "description": "Data Transfer Objects for PatoAI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",