tempest-express-sdk 0.4.0 → 0.6.0

package/dist/index.js

@@ -1,4 +1,4 @@
-export { VERSION } from './chunk-US2RDLUY.js';
+export { VERSION } from './chunk-3IDD2UXU.js';
 import { AsyncLocalStorage } from 'async_hooks';
 import { extendZodWithOpenApi, OpenAPIRegistry, OpenApiGeneratorV31, OpenApiGeneratorV3 } from '@asteasolutions/zod-to-openapi';
 export { OpenAPIRegistry } from '@asteasolutions/zod-to-openapi';
@@ -8194,6 +8194,294 @@ function makeWhatsAppWebhookRouter(options) {
   return router;
 }
 
+// src/integrations/telegram.ts
+var MEDIA_METHOD = {
+  image: { method: "sendPhoto", field: "photo" },
+  video: { method: "sendVideo", field: "video" },
+  audio: { method: "sendAudio", field: "audio" },
+  document: { method: "sendDocument", field: "document" }
+};
+var TelegramProvider = class {
+  http;
+  pollTimeout;
+  /**
+   * @param options - Bot token and API options.
+   */
+  constructor(options) {
+    const base = `${options.apiBase ?? "https://api.telegram.org"}/bot${options.token}`;
+    this.pollTimeout = options.pollTimeoutSeconds ?? 30;
+    this.http = new HTTPClient({
+      baseUrl: base,
+      defaultHeaders: { "content-type": "application/json" },
+      // Timeout must exceed the long-poll window.
+      timeoutMs: (this.pollTimeout + 10) * 1e3
+    });
+  }
+  /** Call a Bot API method, returning the `result`, throwing on `ok: false`. */
+  async call(method, body) {
+    const res = await this.http.post(`/${method}`, { body: JSON.stringify(body) });
+    const data = await res.json().catch(() => ({}));
+    if (!res.ok || !data.ok) {
+      throw new Error(`Telegram ${method} failed: ${data.description ?? res.statusText}`);
+    }
+    return data.result;
+  }
+  async sendText(to, text) {
+    const result = await this.call("sendMessage", {
+      chat_id: to,
+      text
+    });
+    return { id: String(result.message_id), status: "sent" };
+  }
+  async sendMedia(to, media) {
+    const { method, field } = MEDIA_METHOD[media.kind];
+    const body = { chat_id: to, [field]: media.media };
+    if (media.caption !== void 0) body.caption = media.caption;
+    const result = await this.call(method, body);
+    return { id: String(result.message_id), status: "sent" };
+  }
+  async status() {
+    try {
+      await this.call("getMe", {});
+      return "connected";
+    } catch {
+      return "disconnected";
+    }
+  }
+  /**
+   * Subscribe to inbound messages via `getUpdates` long-polling.
+   *
+   * @param handler - Invoked for each inbound text message.
+   * @returns A stop function that ends the polling loop.
+   */
+  async onMessage(handler) {
+    let running = true;
+    let offset = 0;
+    const loop = async () => {
+      while (running) {
+        let updates = [];
+        try {
+          updates = await this.call("getUpdates", {
+            offset,
+            timeout: this.pollTimeout
+          });
+        } catch {
+          if (running) await new Promise((r) => setTimeout(r, 1e3));
+          continue;
+        }
+        for (const update2 of updates) {
+          offset = update2.update_id + 1;
+          const message = update2.message;
+          if (!message) continue;
+          await handler({
+            from: String(message.chat.id),
+            messageId: String(message.message_id),
+            ...typeof message.text === "string" ? { text: message.text } : {},
+            mediaType: null,
+            timestamp: new Date(message.date * 1e3).toISOString(),
+            direction: "incoming"
+          });
+        }
+      }
+    };
+    void loop();
+    return async () => {
+      running = false;
+    };
+  }
+};
+var TwilioSmsProvider = class {
+  http;
+  from;
+  messagesPath;
+  accountPath;
+  /**
+   * @param options - Account SID, auth token and default sender.
+   */
+  constructor(options) {
+    this.from = options.from;
+    this.messagesPath = `/2010-04-01/Accounts/${options.accountSid}/Messages.json`;
+    this.accountPath = `/2010-04-01/Accounts/${options.accountSid}.json`;
+    const basic = Buffer.from(`${options.accountSid}:${options.authToken}`).toString(
+      "base64"
+    );
+    this.http = new HTTPClient({
+      baseUrl: options.apiBase ?? "https://api.twilio.com",
+      defaultHeaders: {
+        Authorization: `Basic ${basic}`,
+        "content-type": "application/x-www-form-urlencoded"
+      }
+    });
+  }
+  /** POST a form body to Twilio and parse the JSON, throwing on non-2xx. */
+  async postForm(params) {
+    const res = await this.http.post(this.messagesPath, {
+      body: new URLSearchParams(params).toString()
+    });
+    const data = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      throw new Error(
+        `Twilio send failed (${res.status}): ${data.message ?? res.statusText}`
+      );
+    }
+    return {
+      status: data.status ?? "queued",
+      ...data.sid ? { id: data.sid } : {}
+    };
+  }
+  async sendText(to, text) {
+    return this.postForm({ To: to, From: this.from, Body: text });
+  }
+  async sendMedia(to, media) {
+    return this.postForm({
+      To: to,
+      From: this.from,
+      MediaUrl: media.media,
+      ...media.caption !== void 0 ? { Body: media.caption } : {}
+    });
+  }
+  async status() {
+    const res = await this.http.get(this.accountPath);
+    const data = await res.json().catch(() => ({}));
+    return data.status ?? (res.ok ? "connected" : "disconnected");
+  }
+};
+function validateTwilioSignature(authToken, url, params, signature) {
+  const data = url + Object.keys(params).sort().map((key) => key + params[key]).join("");
+  const expected = createHmac("sha1", authToken).update(data, "utf8").digest("base64");
+  const a = Buffer.from(expected);
+  const b = Buffer.from(signature);
+  return a.length === b.length && timingSafeEqual(a, b);
+}
+function makeTwilioWebhookRouter(options) {
+  const path = options.path ?? "/sms/inbound";
+  const router = Router();
+  router.post(path, async (req, res) => {
+    const body = req.body ?? {};
+    if (options.authToken) {
+      const url = options.publicUrl ?? `${req.protocol}://${req.get("host")}${req.originalUrl}`;
+      const signature = req.header("x-twilio-signature") ?? "";
+      if (!validateTwilioSignature(options.authToken, url, body, signature)) {
+        throw new UnauthorizedException({ message: "Invalid Twilio signature" });
+      }
+    }
+    await options.onMessage({
+      from: String(body.From ?? ""),
+      messageId: String(body.MessageSid ?? ""),
+      ...body.Body ? { text: body.Body } : {},
+      mediaType: null,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      direction: "incoming"
+    });
+    res.type("text/xml").send("<Response></Response>");
+  });
+  return router;
+}
+
+// src/admin/site.ts
+var AdminSite = class {
+  /**
+   * @param brand - Display name surfaced under `GET {prefix}/`.
+   */
+  constructor(brand = "Admin") {
+    this.brand = brand;
+  }
+  brand;
+  resources = /* @__PURE__ */ new Map();
+  /**
+   * Register a resource.
+   *
+   * @param resource - The resource config.
+   * @returns The same resource (for chaining).
+   */
+  register(resource) {
+    this.resources.set(resource.name, resource);
+    return resource;
+  }
+  /** Look up a resource by slug, or `null`. */
+  get(name) {
+    return this.resources.get(name) ?? null;
+  }
+  /** Every registered resource. */
+  list() {
+    return [...this.resources.values()];
+  }
+};
+var PAGINATION_KEYS2 = /* @__PURE__ */ new Set(["page", "pageSize"]);
+function methodNotAllowed(operation) {
+  return new AppException({
+    message: `Operation not allowed: ${operation}`,
+    code: "METHOD_NOT_ALLOWED",
+    statusCode: 405
+  });
+}
+function requireResource(site, name) {
+  const resource = site.get(name);
+  if (!resource) throw new NotFoundException({ message: `Unknown resource: ${name}` });
+  return resource;
+}
+function makeAdminRouter(site, options = {}) {
+  const prefix = (options.prefix ?? "/admin").replace(/\/$/, "");
+  const router = Router();
+  if (options.guard) router.use(prefix, options.guard);
+  router.get(prefix, (_req, res) => {
+    res.json({
+      brand: site.brand,
+      resources: site.list().map((r) => ({ name: r.name, fields: r.fields }))
+    });
+  });
+  router.get(`${prefix}/:resource/_meta`, (req, res) => {
+    const resource = requireResource(site, req.params.resource);
+    res.json({
+      name: resource.name,
+      fields: resource.fields,
+      operations: {
+        create: Boolean(resource.create),
+        update: Boolean(resource.update),
+        remove: Boolean(resource.remove)
+      }
+    });
+  });
+  router.get(`${prefix}/:resource`, async (req, res) => {
+    const resource = requireResource(site, req.params.resource);
+    const filters = {};
+    for (const [key, value] of Object.entries(req.query)) {
+      if (!PAGINATION_KEYS2.has(key) && typeof value === "string") filters[key] = value;
+    }
+    const page = Math.max(1, Number.parseInt(String(req.query.page ?? "1"), 10) || 1);
+    const pageSize = Math.max(
+      1,
+      Number.parseInt(String(req.query.pageSize ?? "20"), 10) || 20
+    );
+    res.json(await resource.list({ page, pageSize, filters }));
+  });
+  router.get(`${prefix}/:resource/:id`, async (req, res) => {
+    const resource = requireResource(site, req.params.resource);
+    const record = await resource.get(req.params.id);
+    if (record === null) throw new NotFoundException({ message: "Record not found" });
+    res.json(record);
+  });
+  router.post(`${prefix}/:resource`, async (req, res) => {
+    const resource = requireResource(site, req.params.resource);
+    if (!resource.create) throw methodNotAllowed("create");
+    const data = resource.createSchema ? resource.createSchema.parse(req.body) : req.body;
+    res.status(201).json(await resource.create(data));
+  });
+  router.patch(`${prefix}/:resource/:id`, async (req, res) => {
+    const resource = requireResource(site, req.params.resource);
+    if (!resource.update) throw methodNotAllowed("update");
+    const data = resource.updateSchema ? resource.updateSchema.parse(req.body) : req.body;
+    res.json(await resource.update(req.params.id, data));
+  });
+  router.delete(`${prefix}/:resource/:id`, async (req, res) => {
+    const resource = requireResource(site, req.params.resource);
+    if (!resource.remove) throw methodNotAllowed("remove");
+    await resource.remove(req.params.id);
+    res.status(204).end();
+  });
+  return router;
+}
+
 // src/auth/schemas.ts
 var signupSchema = z.object({
   email: z.string().email().openapi({ description: "Login identifier (email)." }),
@@ -8705,6 +8993,6 @@ function runServer(app, options = {}) {
   });
 }
 
-export { AppException, AttemptThrottle, BaseController, BaseModel, BaseService, CEP_PATTERN, CNPJ_PATTERN, CPF_PATTERN, CircuitOpenError, CompositeFeatureFlagBackend, ConflictException, DEFAULT_LOCALE, EmailUtils, EnvFeatureFlagBackend, EventStream, ExpiredTokenException, FeatureFlags, ForbiddenException, HTTPClient, HTTP_500_MARKER, InvalidTokenException, JSONLogger, JWTUtils, LocalUploadStorage, MemoryBroker, MemoryCacheManager, MemoryFeatureFlagBackend, MemorySessionStore, MemoryThrottleBackend, MessageCatalog, MetricsUtils, NotFoundException, PHONE_BR_PATTERN, PasswordUtils, REQUEST_ID_HEADER, RabbitBroker, RedisCacheManager, Region, RetryPolicy, SSEBroker, ServerSentEvent, SessionService, TOTPHelper, TaskManager, TooManyRequestsException, UF, UnauthorizedException, UserAuthService, ValidationException, WebPushDispatcher, WebPushError, WebPushGoneError, WebSocketHub, WhatsAppProvider, attachWebSocketHub, authResponseSchema, baseAppSettingsSchema, baseAppSettingsShape, baseResponseSchema, bearerToken, buildContentDisposition, cached3 as cached, cepField, citiesByUf, cnpjField, coerceFlag, configureLogging, corsSettingsShape, cpfField, cpfOrCnpjField, createApp, createOpenApiRegistry, createdByColumn, cursorPaginationFilterSchema, cursorPaginationSchema, databaseSettingsShape, decodeCursor, defaultMessageCatalog, defineEnum, deletedAtColumn, encodeCursor, generateOpaqueToken, generateOpenApiDocument, getAuth, getClientIp, getConditions, getPaginationConditions, getRequestId, getState, hashOpaqueToken, inboundMessageSchema, isValidCep, isValidCity, isValidCnpj, isValidCpf, isValidCpfCnpj, isValidPhoneBr, isValidUf, listStates, loadSettings, loginSchema, makeAppExceptionHandler, makeAuthRouter, makeFlagGuard, makeHealthRouter, makeJwtAuthMiddleware, makeSessionMiddleware, makeUnhandledExceptionHandler, makeWhatsAppWebhookRouter, modifyDict, mountOpenApiJson, mountRedoc, mountSwaggerUi, normalizeCep, normalizeCnpj, normalizeCpf, normalizeCpfCnpj, normalizePhoneBr, normalizeUf, notFoundHandler, onlyDigits, paginationFilterSchema, paginationSchema, parseAcceptLanguage, parseCookies, phoneBrField, refreshSchema, registerExceptionHandlers, requestIdMiddleware, requireRoles, runServer, runWithRequestContext, serverSettingsShape, sessionCookie, setRequestId, signupSchema, sseResponse, statesByRegion, tableNameFor, toDict, toUtc, tokenFromUrl, tokenPairSchema, ufField, updatedByColumn, userPublicSchema, utcnow, verifyOpaqueToken, webPushKeysSchema, webPushPayloadSchema, webPushSubscriptionSchema, wsEnvelopeSchema };
+export { AdminSite, AppException, AttemptThrottle, BaseController, BaseModel, BaseService, CEP_PATTERN, CNPJ_PATTERN, CPF_PATTERN, CircuitOpenError, CompositeFeatureFlagBackend, ConflictException, DEFAULT_LOCALE, EmailUtils, EnvFeatureFlagBackend, EventStream, ExpiredTokenException, FeatureFlags, ForbiddenException, HTTPClient, HTTP_500_MARKER, InvalidTokenException, JSONLogger, JWTUtils, LocalUploadStorage, MemoryBroker, MemoryCacheManager, MemoryFeatureFlagBackend, MemorySessionStore, MemoryThrottleBackend, MessageCatalog, MetricsUtils, NotFoundException, PHONE_BR_PATTERN, PasswordUtils, REQUEST_ID_HEADER, RabbitBroker, RedisCacheManager, Region, RetryPolicy, SSEBroker, ServerSentEvent, SessionService, TOTPHelper, TaskManager, TelegramProvider, TooManyRequestsException, TwilioSmsProvider, UF, UnauthorizedException, UserAuthService, ValidationException, WebPushDispatcher, WebPushError, WebPushGoneError, WebSocketHub, WhatsAppProvider, attachWebSocketHub, authResponseSchema, baseAppSettingsSchema, baseAppSettingsShape, baseResponseSchema, bearerToken, buildContentDisposition, cached3 as cached, cepField, citiesByUf, cnpjField, coerceFlag, configureLogging, corsSettingsShape, cpfField, cpfOrCnpjField, createApp, createOpenApiRegistry, createdByColumn, cursorPaginationFilterSchema, cursorPaginationSchema, databaseSettingsShape, decodeCursor, defaultMessageCatalog, defineEnum, deletedAtColumn, encodeCursor, generateOpaqueToken, generateOpenApiDocument, getAuth, getClientIp, getConditions, getPaginationConditions, getRequestId, getState, hashOpaqueToken, inboundMessageSchema, isValidCep, isValidCity, isValidCnpj, isValidCpf, isValidCpfCnpj, isValidPhoneBr, isValidUf, listStates, loadSettings, loginSchema, makeAdminRouter, makeAppExceptionHandler, makeAuthRouter, makeFlagGuard, makeHealthRouter, makeJwtAuthMiddleware, makeSessionMiddleware, makeTwilioWebhookRouter, makeUnhandledExceptionHandler, makeWhatsAppWebhookRouter, modifyDict, mountOpenApiJson, mountRedoc, mountSwaggerUi, normalizeCep, normalizeCnpj, normalizeCpf, normalizeCpfCnpj, normalizePhoneBr, normalizeUf, notFoundHandler, onlyDigits, paginationFilterSchema, paginationSchema, parseAcceptLanguage, parseCookies, phoneBrField, refreshSchema, registerExceptionHandlers, requestIdMiddleware, requireRoles, runServer, runWithRequestContext, serverSettingsShape, sessionCookie, setRequestId, signupSchema, sseResponse, statesByRegion, tableNameFor, toDict, toUtc, tokenFromUrl, tokenPairSchema, ufField, updatedByColumn, userPublicSchema, utcnow, validateTwilioSignature, verifyOpaqueToken, webPushKeysSchema, webPushPayloadSchema, webPushSubscriptionSchema, wsEnvelopeSchema };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map