@dereekb/nestjs 13.11.18 → 13.12.0

package/twilio/src/lib/webhook/webhook.twilio.module.d.ts

@@ -0,0 +1,22 @@
+import { ConfigService } from '@nestjs/config';
+import { TwilioWebhookServiceConfig } from './webhook.twilio.config';
+/**
+ * Factory that creates a {@link TwilioWebhookServiceConfig} from environment variables.
+ *
+ * @param configService - NestJS config service for reading environment variables.
+ * @returns A populated {@link TwilioWebhookServiceConfig}.
+ */
+export declare function twilioWebhookServiceConfigFactory(configService: ConfigService): TwilioWebhookServiceConfig;
+/**
+ * NestJS module that handles incoming Twilio webhook requests at:
+ *   - `POST /webhook/twilio/status` (Message status callbacks)
+ *   - `POST /webhook/twilio/incoming` (Incoming SMS / MMS messages)
+ *
+ * Webhook bodies are verified against the X-Twilio-Signature header before dispatch.
+ *
+ * Requires the consuming application to register the raw-body middleware from
+ * `@dereekb/nestjs` for the `/webhook/twilio` path so that signature verification can read
+ * the unparsed form body.
+ */
+export declare class TwilioWebhookModule {
+}

package/twilio/src/lib/webhook/webhook.twilio.service.d.ts

@@ -0,0 +1,21 @@
+import { type Handler } from '@dereekb/util';
+import { type Request } from 'express';
+import { TwilioApi } from '../twilio.api';
+import { type TwilioWebhookEvent, type TwilioWebhookEventType } from './webhook.twilio';
+import { TwilioWebhookServiceConfig } from './webhook.twilio.config';
+export declare class TwilioWebhookService {
+    private readonly logger;
+    private readonly _verifier;
+    readonly handler: Handler<TwilioWebhookEvent, TwilioWebhookEventType>;
+    readonly configure: import("@dereekb/util").HandlerConfigurer<import("./webhook.twilio").TwilioWebhookEventHandlerConfigurer, TwilioWebhookEvent, TwilioWebhookEventType, boolean>;
+    constructor(twilioApi: TwilioApi, webhookConfig: TwilioWebhookServiceConfig);
+    handleStatusCallback(req: Request, rawBody: Buffer): Promise<void>;
+    handleIncomingMessage(req: Request, rawBody: Buffer): Promise<void>;
+    private dispatchEvent;
+}
+/**
+ * Provides a reference to a TwilioWebhookService instance.
+ */
+export interface TwilioWebhookServiceRef {
+    readonly twilioWebhookService: TwilioWebhookService;
+}

package/twilio/src/lib/webhook/webhook.twilio.verify.d.ts

@@ -0,0 +1,53 @@
+import { type Maybe } from '@dereekb/util';
+import { type Request } from 'express';
+export interface TwilioWebhookVerificationConfig {
+    /**
+     * Twilio auth token used for HMAC-SHA1 signature verification.
+     */
+    readonly authToken: string;
+    /**
+     * Override base URL Twilio used when calculating the signature. Required when the
+     * service is behind a proxy and the request's `Host` header does not match the public URL.
+     */
+    readonly baseUrl?: Maybe<string>;
+    /**
+     * When true, skip verification and always return valid. Intended for local development.
+     */
+    readonly skip?: Maybe<boolean>;
+}
+export interface TwilioWebhookVerificationResult {
+    readonly valid: boolean;
+    /**
+     * Parsed form params from the request body. Always present even when verification fails.
+     */
+    readonly params: Record<string, string>;
+}
+export type TwilioWebhookVerifier = (req: Request, rawBody: Buffer) => TwilioWebhookVerificationResult;
+/**
+ * Parses a `application/x-www-form-urlencoded` raw body into a plain `Record<string, string>`.
+ *
+ * Twilio's status callback and incoming-message webhooks use this content type by default.
+ *
+ * @param rawBody - The unparsed request body bytes.
+ * @returns Form parameters as a flat string-keyed object.
+ */
+export declare function parseTwilioFormBody(rawBody: Buffer): Record<string, string>;
+/**
+ * Builds the full URL Twilio used when computing the request signature. Twilio computes
+ * the signature over the URL it called (including query string).
+ *
+ * @param req - Incoming Express request.
+ * @param baseUrl - Optional explicit base URL (used when the server sits behind a proxy
+ *   and the request's `Host` header does not match the public URL).
+ * @returns The full URL string Twilio would have signed.
+ */
+export declare function twilioWebhookRequestUrl(req: Request, baseUrl?: Maybe<string>): string;
+/**
+ * Creates a verifier that validates the `X-Twilio-Signature` header against the request body
+ * using Twilio's HMAC-SHA1 signature scheme.
+ *
+ * @param config - Verification config (auth token, optional baseUrl, optional skip flag).
+ * @returns A verifier function that, given a request and raw body, returns the validity
+ *   and parsed form params.
+ */
+export declare function twilioWebhookVerifier(config: TwilioWebhookVerificationConfig): TwilioWebhookVerifier;

package/typeform/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@dereekb/nestjs/typeform",
-  "version": "13.11.18",
+  "version": "13.12.0",
   "peerDependencies": {
-    "@dereekb/date": "13.11.18",
-    "@dereekb/model": "13.11.18",
-    "@dereekb/nestjs": "13.11.18",
-    "@dereekb/rxjs": "13.11.18",
-    "@dereekb/util": "13.11.18",
+    "@dereekb/date": "13.12.0",
+    "@dereekb/model": "13.12.0",
+    "@dereekb/nestjs": "13.12.0",
+    "@dereekb/rxjs": "13.12.0",
+    "@dereekb/util": "13.12.0",
     "@nestjs/common": "^11.1.19",
     "@nestjs/config": "^4.0.4",
     "@typeform/api-client": "^2.10.2",

package/vapiai/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@dereekb/nestjs/vapiai",
-  "version": "13.11.18",
+  "version": "13.12.0",
   "peerDependencies": {
-    "@dereekb/date": "13.11.18",
-    "@dereekb/model": "13.11.18",
-    "@dereekb/nestjs": "13.11.18",
-    "@dereekb/rxjs": "13.11.18",
-    "@dereekb/util": "13.11.18",
+    "@dereekb/date": "13.12.0",
+    "@dereekb/model": "13.12.0",
+    "@dereekb/nestjs": "13.12.0",
+    "@dereekb/rxjs": "13.12.0",
+    "@dereekb/util": "13.12.0",
     "@nestjs/common": "^11.1.19",
     "@nestjs/config": "^4.0.4",
     "@vapi-ai/server-sdk": "^0.11.0",