tempest-express-sdk 0.3.0 → 0.5.0

package/dist/index.js

@@ -1,4 +1,4 @@
-export { VERSION } from './chunk-6ZKN2ELQ.js';
+export { VERSION } from './chunk-ZU6W433I.js';
 import { AsyncLocalStorage } from 'async_hooks';
 import { extendZodWithOpenApi, OpenAPIRegistry, OpenApiGeneratorV31, OpenApiGeneratorV3 } from '@asteasolutions/zod-to-openapi';
 export { OpenAPIRegistry } from '@asteasolutions/zod-to-openapi';
@@ -8026,6 +8026,278 @@ var WebPushDispatcher = class {
   }
 };
 
+// src/integrations/provider.ts
+var inboundMessageSchema = z.object({
+  /** Conversation JID / sender (e.g. `5511999999999@s.whatsapp.net`). */
+  from: z.string().openapi({ description: "Conversation JID / sender." }),
+  /** Provider message id. */
+  messageId: z.string().openapi({ description: "Provider message id." }),
+  /** Text body, when present. */
+  text: z.string().optional().openapi({ description: "Text body." }),
+  /** Media kind, or `null` for plain text. */
+  mediaType: z.enum(["image", "video", "audio", "document", "sticker"]).nullable().openapi({ description: "Media kind, or null for text." }),
+  /** ISO-8601 timestamp. */
+  timestamp: z.string().openapi({ description: "ISO-8601 timestamp." }),
+  /** Delivery direction. */
+  direction: z.enum(["incoming", "outgoing"]).optional()
+}).openapi("InboundMessage");
+
+// src/integrations/whatsapp.ts
+var MEDIA_ROUTE = {
+  image: "send-image",
+  video: "send-video",
+  audio: "send-audio",
+  document: "send-document"
+};
+function deriveWsUrl(baseUrl) {
+  const trimmed = baseUrl.replace(/\/$/, "");
+  return `${trimmed.replace(/^http/, "ws")}/ws`;
+}
+var WhatsAppProvider = class {
+  http;
+  apiKey;
+  wsUrl;
+  /**
+   * @param options - Base URL, API key and optional WebSocket URL.
+   */
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.wsUrl = options.wsUrl ?? deriveWsUrl(options.baseUrl);
+    this.http = new HTTPClient({
+      baseUrl: options.baseUrl.replace(/\/$/, ""),
+      defaultHeaders: { "x-api-key": options.apiKey, "content-type": "application/json" },
+      timeoutMs: options.timeoutMs ?? 15e3
+    });
+  }
+  /** POST JSON and parse the response, throwing on a non-2xx status. */
+  async postJson(path, body, options) {
+    const headers = options?.idempotencyKey ? { "Idempotency-Key": options.idempotencyKey } : void 0;
+    const res = await this.http.post(path, {
+      body: JSON.stringify(body),
+      ...headers ? { headers } : {}
+    });
+    const data = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      throw new Error(
+        `zap-api ${path} failed (${res.status}): ${String(data.error ?? res.statusText)}`
+      );
+    }
+    return data;
+  }
+  async sendText(to, text, options) {
+    const data = await this.postJson("/message/send-text", { to, text }, options);
+    return {
+      status: String(data.status ?? "queued"),
+      ...typeof data.id === "string" ? { id: data.id } : {},
+      ...typeof data.deduped === "boolean" ? { deduped: data.deduped } : {}
+    };
+  }
+  async sendMedia(to, media, options) {
+    const body = { to, media: media.media };
+    if (media.caption !== void 0) body.caption = media.caption;
+    if (media.fileName !== void 0) body.fileName = media.fileName;
+    const data = await this.postJson(
+      `/message/${MEDIA_ROUTE[media.kind]}`,
+      body,
+      options
+    );
+    return {
+      status: String(data.status ?? "queued"),
+      ...typeof data.id === "string" ? { id: data.id } : {},
+      ...typeof data.deduped === "boolean" ? { deduped: data.deduped } : {}
+    };
+  }
+  async checkNumber(number) {
+    const res = await this.http.get(
+      `/message/check-number/${encodeURIComponent(number)}`
+    );
+    const data = await res.json().catch(() => ({}));
+    return data.exists === true;
+  }
+  async status() {
+    const res = await this.http.get("/session/status");
+    const raw = await res.text();
+    try {
+      const parsed = JSON.parse(raw);
+      return parsed.status ?? raw.trim();
+    } catch {
+      return raw.trim();
+    }
+  }
+  /** Start the WhatsApp session (returns the authenticated QR URL, if any). */
+  async startSession() {
+    return this.postJson("/session/start", {});
+  }
+  async onMessage(handler, room = "*") {
+    let ws;
+    try {
+      ws = await import('ws');
+    } catch (cause) {
+      throw new Error(
+        "WhatsAppProvider.onMessage requires the 'ws' peer dependency. Install with `npm i ws`.",
+        { cause }
+      );
+    }
+    const socket = new ws.WebSocket(this.wsUrl, {
+      headers: { "x-api-key": this.apiKey }
+    });
+    socket.on("open", () => {
+      socket.send(JSON.stringify({ action: "subscribe", room }));
+    });
+    socket.on("message", (raw) => {
+      let frame;
+      try {
+        frame = JSON.parse(String(raw));
+      } catch {
+        return;
+      }
+      if (frame.type === "message" && frame.payload) {
+        const p = frame.payload;
+        void handler({
+          from: String(p.remoteJid ?? ""),
+          messageId: String(p.messageId ?? ""),
+          ...typeof p.text === "string" ? { text: p.text } : {},
+          mediaType: p.mediaType ?? null,
+          timestamp: String(p.timestamp ?? ""),
+          ...p.direction === "incoming" || p.direction === "outgoing" ? { direction: p.direction } : {}
+        });
+      }
+    });
+    return async () => {
+      try {
+        socket.send(JSON.stringify({ action: "unsubscribe", room }));
+      } catch {
+      }
+      socket.close();
+    };
+  }
+};
+function safeEqual(a, b) {
+  const bufA = Buffer.from(a);
+  const bufB = Buffer.from(b);
+  return bufA.length === bufB.length && timingSafeEqual(bufA, bufB);
+}
+function makeWhatsAppWebhookRouter(options) {
+  const path = options.path ?? "/whatsapp/inbound";
+  const router = Router();
+  router.post(path, async (req, res) => {
+    if (options.apiKey) {
+      const provided = req.header("x-api-key") ?? "";
+      if (!safeEqual(provided, options.apiKey)) {
+        throw new UnauthorizedException({ message: "Invalid webhook key" });
+      }
+    }
+    const message = inboundMessageSchema.parse(req.body);
+    await options.onMessage(message);
+    res.status(200).json({ ok: true });
+  });
+  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)." }),
@@ -8537,6 +8809,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, 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, isValidCep, isValidCity, isValidCnpj, isValidCpf, isValidCpfCnpj, isValidPhoneBr, isValidUf, listStates, loadSettings, loginSchema, makeAppExceptionHandler, makeAuthRouter, makeFlagGuard, makeHealthRouter, makeJwtAuthMiddleware, makeSessionMiddleware, makeUnhandledExceptionHandler, 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, 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, makeAdminRouter, 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 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map