@miguelmorales13/nestkit 0.1.1 → 0.4.0

package/dist/stripe/index.cjs

@@ -0,0 +1,78 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+var _chunkFDNGAYTZcjs = require('../chunk-FDNGAYTZ.cjs');
+require('../chunk-R7BVS6CI.cjs');
+
+
+
+var _chunk2REOCMUDcjs = require('../chunk-2REOCMUD.cjs');
+
+// src/stripe/stripe.module.ts
+var _common = require('@nestjs/common');
+var _stripe = require('stripe'); var _stripe2 = _interopRequireDefault(_stripe);
+var STRIPE_CLIENT = /* @__PURE__ */ Symbol("STRIPE_CLIENT");
+var StripeModule = class {
+};
+StripeModule = exports.StripeModule = _chunk2REOCMUDcjs.__decorateClass.call(void 0, [
+  _common.Module.call(void 0, {
+    providers: [
+      {
+        provide: STRIPE_CLIENT,
+        useFactory: () => {
+          const secretKey = process.env.STRIPE_SECRET_KEY;
+          if (!secretKey) {
+            throw new Error("StripeModule: STRIPE_SECRET_KEY environment variable is not set");
+          }
+          const apiVersion = process.env.STRIPE_API_VERSION;
+          return apiVersion ? new (0, _stripe2.default)(secretKey, { apiVersion }) : new (0, _stripe2.default)(secretKey);
+        }
+      }
+    ],
+    exports: [STRIPE_CLIENT]
+  })
+], StripeModule);
+
+// src/stripe/stripe-webhook.controller.ts
+
+function createStripeWebhookController(options) {
+  let StripeWebhookControllerHost = class {
+    constructor(stripe) {
+      this.stripe = stripe;
+    }
+    async handleWebhook(req, signature) {
+      const webhookSecret = process.env.STRIPE_WEBHOOK_SECRET;
+      if (!webhookSecret) {
+        throw new Error("StripeWebhookController: STRIPE_WEBHOOK_SECRET environment variable is not set");
+      }
+      const rawBody = req.rawBody;
+      if (!rawBody) {
+        throw new Error(
+          "StripeWebhookController: request.rawBody is undefined \u2014 create the Nest app with `NestFactory.create(AppModule, { rawBody: true })` (see README)."
+        );
+      }
+      let event;
+      try {
+        event = this.stripe.webhooks.constructEvent(rawBody, signature, webhookSecret);
+      } catch (e) {
+        throw new (0, _chunkFDNGAYTZcjs.UnauthorizedAppException)("Invalid Stripe webhook signature", void 0, "INVALID_STRIPE_SIGNATURE");
+      }
+      await _optionalChain([options, 'access', _ => _.handlers, 'access', _2 => _2[event.type], 'optionalCall', _3 => _3(event)]);
+      return { received: true };
+    }
+  };
+  _chunk2REOCMUDcjs.__decorateClass.call(void 0, [
+    _common.Post.call(void 0, ),
+    _chunk2REOCMUDcjs.__decorateParam.call(void 0, 0, _common.Req.call(void 0, )),
+    _chunk2REOCMUDcjs.__decorateParam.call(void 0, 1, _common.Headers.call(void 0, "stripe-signature"))
+  ], StripeWebhookControllerHost.prototype, "handleWebhook", 1);
+  StripeWebhookControllerHost = _chunk2REOCMUDcjs.__decorateClass.call(void 0, [
+    _common.Controller.call(void 0, _nullishCoalesce(options.path, () => ( "stripe/webhook"))),
+    _chunk2REOCMUDcjs.__decorateParam.call(void 0, 0, _common.Inject.call(void 0, STRIPE_CLIENT))
+  ], StripeWebhookControllerHost);
+  return StripeWebhookControllerHost;
+}
+
+
+
+
+exports.STRIPE_CLIENT = STRIPE_CLIENT; exports.StripeModule = StripeModule; exports.createStripeWebhookController = createStripeWebhookController;

package/dist/stripe/index.d.ts

@@ -0,0 +1,3 @@
+export { StripeModule, STRIPE_CLIENT } from './stripe.module.js';
+export { createStripeWebhookController } from './stripe-webhook.controller.js';
+export type { CreateStripeWebhookControllerOptions } from './stripe-webhook.controller.js';

package/dist/stripe/index.js

@@ -0,0 +1,78 @@
+import {
+  UnauthorizedAppException
+} from "../chunk-ORWJ7LES.js";
+import "../chunk-YFYHLYHN.js";
+import {
+  __decorateClass,
+  __decorateParam
+} from "../chunk-4MGIQFAJ.js";
+
+// src/stripe/stripe.module.ts
+import { Module } from "@nestjs/common";
+import Stripe from "stripe";
+var STRIPE_CLIENT = /* @__PURE__ */ Symbol("STRIPE_CLIENT");
+var StripeModule = class {
+};
+StripeModule = __decorateClass([
+  Module({
+    providers: [
+      {
+        provide: STRIPE_CLIENT,
+        useFactory: () => {
+          const secretKey = process.env.STRIPE_SECRET_KEY;
+          if (!secretKey) {
+            throw new Error("StripeModule: STRIPE_SECRET_KEY environment variable is not set");
+          }
+          const apiVersion = process.env.STRIPE_API_VERSION;
+          return apiVersion ? new Stripe(secretKey, { apiVersion }) : new Stripe(secretKey);
+        }
+      }
+    ],
+    exports: [STRIPE_CLIENT]
+  })
+], StripeModule);
+
+// src/stripe/stripe-webhook.controller.ts
+import { Controller, Headers, Inject, Post, Req } from "@nestjs/common";
+function createStripeWebhookController(options) {
+  let StripeWebhookControllerHost = class {
+    constructor(stripe) {
+      this.stripe = stripe;
+    }
+    async handleWebhook(req, signature) {
+      const webhookSecret = process.env.STRIPE_WEBHOOK_SECRET;
+      if (!webhookSecret) {
+        throw new Error("StripeWebhookController: STRIPE_WEBHOOK_SECRET environment variable is not set");
+      }
+      const rawBody = req.rawBody;
+      if (!rawBody) {
+        throw new Error(
+          "StripeWebhookController: request.rawBody is undefined \u2014 create the Nest app with `NestFactory.create(AppModule, { rawBody: true })` (see README)."
+        );
+      }
+      let event;
+      try {
+        event = this.stripe.webhooks.constructEvent(rawBody, signature, webhookSecret);
+      } catch {
+        throw new UnauthorizedAppException("Invalid Stripe webhook signature", void 0, "INVALID_STRIPE_SIGNATURE");
+      }
+      await options.handlers[event.type]?.(event);
+      return { received: true };
+    }
+  };
+  __decorateClass([
+    Post(),
+    __decorateParam(0, Req()),
+    __decorateParam(1, Headers("stripe-signature"))
+  ], StripeWebhookControllerHost.prototype, "handleWebhook", 1);
+  StripeWebhookControllerHost = __decorateClass([
+    Controller(options.path ?? "stripe/webhook"),
+    __decorateParam(0, Inject(STRIPE_CLIENT))
+  ], StripeWebhookControllerHost);
+  return StripeWebhookControllerHost;
+}
+export {
+  STRIPE_CLIENT,
+  StripeModule,
+  createStripeWebhookController
+};

package/dist/stripe/stripe-webhook.controller.d.ts

@@ -0,0 +1,20 @@
+import { type Type } from '@nestjs/common';
+import type Stripe from 'stripe';
+export interface CreateStripeWebhookControllerOptions {
+    /** Route prefix for the generated controller. Defaults to 'stripe/webhook'. */
+    path?: string;
+    /** Keyed by Stripe event type, e.g. 'checkout.session.completed'. Unhandled types are acked and ignored. */
+    handlers: Record<string, (event: Stripe.Event) => Promise<void> | void>;
+}
+/**
+ * Requires the Nest app to be created with
+ * `NestFactory.create(AppModule, { rawBody: true })` — Stripe signature
+ * verification needs the exact raw request bytes, which nestkit's
+ * `applyNestKitDefaults` (applied after app creation) cannot retroactively
+ * enable. See README.
+ */
+export declare function createStripeWebhookController(options: CreateStripeWebhookControllerOptions): Type<{
+    handleWebhook(req: unknown, signature: string): Promise<{
+        received: true;
+    }>;
+}>;

package/dist/stripe/stripe.module.d.ts

@@ -0,0 +1,4 @@
+/** DI token for the Stripe client. Inject with `@Inject(STRIPE_CLIENT)`. */
+export declare const STRIPE_CLIENT: unique symbol;
+export declare class StripeModule {
+}

package/dist/telegram/index.cjs

@@ -0,0 +1,31 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunk2REOCMUDcjs = require('../chunk-2REOCMUD.cjs');
+
+// src/telegram/telegram.module.ts
+var _common = require('@nestjs/common');
+var _telegraf = require('telegraf');
+var TELEGRAM_BOT = /* @__PURE__ */ Symbol("TELEGRAM_BOT");
+var TelegramModule = class {
+};
+TelegramModule = exports.TelegramModule = _chunk2REOCMUDcjs.__decorateClass.call(void 0, [
+  _common.Module.call(void 0, {
+    providers: [
+      {
+        provide: TELEGRAM_BOT,
+        useFactory: () => {
+          const token = process.env.TELEGRAM_BOT_TOKEN;
+          if (!token) {
+            throw new Error("TelegramModule: TELEGRAM_BOT_TOKEN environment variable is not set");
+          }
+          return new (0, _telegraf.Telegram)(token);
+        }
+      }
+    ],
+    exports: [TELEGRAM_BOT]
+  })
+], TelegramModule);
+
+
+
+exports.TELEGRAM_BOT = TELEGRAM_BOT; exports.TelegramModule = TelegramModule;

package/dist/telegram/index.d.ts

@@ -0,0 +1 @@
+export { TelegramModule, TELEGRAM_BOT } from './telegram.module.js';

package/dist/telegram/index.js

@@ -0,0 +1,31 @@
+import {
+  __decorateClass
+} from "../chunk-4MGIQFAJ.js";
+
+// src/telegram/telegram.module.ts
+import { Module } from "@nestjs/common";
+import { Telegram as TelegrafClient } from "telegraf";
+var TELEGRAM_BOT = /* @__PURE__ */ Symbol("TELEGRAM_BOT");
+var TelegramModule = class {
+};
+TelegramModule = __decorateClass([
+  Module({
+    providers: [
+      {
+        provide: TELEGRAM_BOT,
+        useFactory: () => {
+          const token = process.env.TELEGRAM_BOT_TOKEN;
+          if (!token) {
+            throw new Error("TelegramModule: TELEGRAM_BOT_TOKEN environment variable is not set");
+          }
+          return new TelegrafClient(token);
+        }
+      }
+    ],
+    exports: [TELEGRAM_BOT]
+  })
+], TelegramModule);
+export {
+  TELEGRAM_BOT,
+  TelegramModule
+};

package/dist/telegram/telegram.module.d.ts

@@ -0,0 +1,8 @@
+/**
+ * DI token for the outbound Telegram Bot API client. Inject with
+ * `@Inject(TELEGRAM_BOT)`. Send-only — no polling, no webhook, no update
+ * handling, no full `Telegraf` bot instance.
+ */
+export declare const TELEGRAM_BOT: unique symbol;
+export declare class TelegramModule {
+}

package/dist/whatsapp/index.cjs

@@ -0,0 +1,68 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+var _chunk2REOCMUDcjs = require('../chunk-2REOCMUD.cjs');
+
+// src/whatsapp/whatsapp.module.ts
+var _common = require('@nestjs/common');
+
+// src/whatsapp/whatsapp-client.ts
+var DEFAULT_API_VERSION = "v21.0";
+var WhatsAppClient = class {
+  constructor(options) {
+    this.options = options;
+    const version = _nullishCoalesce(options.apiVersion, () => ( DEFAULT_API_VERSION));
+    this.baseUrl = `https://graph.facebook.com/${version}/${options.phoneNumberId}/messages`;
+  }
+  async sendTextMessage(to, body) {
+    const response = await fetch(this.baseUrl, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.options.accessToken}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        messaging_product: "whatsapp",
+        to,
+        type: "text",
+        text: { body }
+      })
+    });
+    if (!response.ok) {
+      const errorBody = await response.text();
+      throw new Error(`WhatsAppClient: send failed (${response.status}): ${errorBody}`);
+    }
+    return await response.json();
+  }
+};
+
+// src/whatsapp/whatsapp.module.ts
+var WHATSAPP_CLIENT = /* @__PURE__ */ Symbol("WHATSAPP_CLIENT");
+function requireEnv(name) {
+  const value = process.env[name];
+  if (!value) {
+    throw new Error(`WhatsAppModule: ${name} environment variable is not set`);
+  }
+  return value;
+}
+var WhatsAppModule = class {
+};
+WhatsAppModule = exports.WhatsAppModule = _chunk2REOCMUDcjs.__decorateClass.call(void 0, [
+  _common.Module.call(void 0, {
+    providers: [
+      {
+        provide: WHATSAPP_CLIENT,
+        useFactory: () => new WhatsAppClient({
+          accessToken: requireEnv("WHATSAPP_ACCESS_TOKEN"),
+          phoneNumberId: requireEnv("WHATSAPP_PHONE_NUMBER_ID"),
+          apiVersion: process.env.WHATSAPP_API_VERSION
+        })
+      }
+    ],
+    exports: [WHATSAPP_CLIENT]
+  })
+], WhatsAppModule);
+
+
+
+
+exports.WHATSAPP_CLIENT = WHATSAPP_CLIENT; exports.WhatsAppClient = WhatsAppClient; exports.WhatsAppModule = WhatsAppModule;

package/dist/whatsapp/index.d.ts

@@ -0,0 +1,3 @@
+export { WhatsAppModule, WHATSAPP_CLIENT } from './whatsapp.module.js';
+export { WhatsAppClient } from './whatsapp-client.js';
+export type { WhatsAppClientOptions, WhatsAppSendResult } from './whatsapp-client.js';

package/dist/whatsapp/index.js

@@ -0,0 +1,68 @@
+import {
+  __decorateClass
+} from "../chunk-4MGIQFAJ.js";
+
+// src/whatsapp/whatsapp.module.ts
+import { Module } from "@nestjs/common";
+
+// src/whatsapp/whatsapp-client.ts
+var DEFAULT_API_VERSION = "v21.0";
+var WhatsAppClient = class {
+  constructor(options) {
+    this.options = options;
+    const version = options.apiVersion ?? DEFAULT_API_VERSION;
+    this.baseUrl = `https://graph.facebook.com/${version}/${options.phoneNumberId}/messages`;
+  }
+  async sendTextMessage(to, body) {
+    const response = await fetch(this.baseUrl, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.options.accessToken}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        messaging_product: "whatsapp",
+        to,
+        type: "text",
+        text: { body }
+      })
+    });
+    if (!response.ok) {
+      const errorBody = await response.text();
+      throw new Error(`WhatsAppClient: send failed (${response.status}): ${errorBody}`);
+    }
+    return await response.json();
+  }
+};
+
+// src/whatsapp/whatsapp.module.ts
+var WHATSAPP_CLIENT = /* @__PURE__ */ Symbol("WHATSAPP_CLIENT");
+function requireEnv(name) {
+  const value = process.env[name];
+  if (!value) {
+    throw new Error(`WhatsAppModule: ${name} environment variable is not set`);
+  }
+  return value;
+}
+var WhatsAppModule = class {
+};
+WhatsAppModule = __decorateClass([
+  Module({
+    providers: [
+      {
+        provide: WHATSAPP_CLIENT,
+        useFactory: () => new WhatsAppClient({
+          accessToken: requireEnv("WHATSAPP_ACCESS_TOKEN"),
+          phoneNumberId: requireEnv("WHATSAPP_PHONE_NUMBER_ID"),
+          apiVersion: process.env.WHATSAPP_API_VERSION
+        })
+      }
+    ],
+    exports: [WHATSAPP_CLIENT]
+  })
+], WhatsAppModule);
+export {
+  WHATSAPP_CLIENT,
+  WhatsAppClient,
+  WhatsAppModule
+};

package/dist/whatsapp/whatsapp-client.d.ts

@@ -0,0 +1,21 @@
+export interface WhatsAppClientOptions {
+    accessToken: string;
+    phoneNumberId: string;
+    apiVersion?: string;
+}
+export interface WhatsAppSendResult {
+    messagingProduct: 'whatsapp';
+    messages: Array<{
+        id: string;
+    }>;
+}
+/**
+ * Minimal outbound client for the WhatsApp Cloud API (Meta Graph API).
+ * No SDK dependency — built on Node's global `fetch` (18+).
+ */
+export declare class WhatsAppClient {
+    private readonly options;
+    private readonly baseUrl;
+    constructor(options: WhatsAppClientOptions);
+    sendTextMessage(to: string, body: string): Promise<WhatsAppSendResult>;
+}

package/dist/whatsapp/whatsapp.module.d.ts

@@ -0,0 +1,4 @@
+/** DI token for the WhatsApp Cloud API client. Inject with `@Inject(WHATSAPP_CLIENT)`. */
+export declare const WHATSAPP_CLIENT: unique symbol;
+export declare class WhatsAppModule {
+}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@miguelmorales13/nestkit",
-  "version": "0.1.1",
+  "version": "0.4.0",
   "private": false,
   "license": "MIT",
   "type": "module",
-  "description": "Reusable NestJS building blocks: i18n, error handling, standardized responses, request tracking, base entities, generic CRUD, and Postgres/Supabase connection helpers.",
+  "description": "Reusable NestJS building blocks: i18n, error handling, standardized responses, request tracking, base entities, generic CRUD, Postgres/Supabase connection helpers, outbound Telegram/WhatsApp/Stripe/Meta clients, short-lived media hosting, batteries-included auth, Stripe webhooks, and Resend/Nodemailer email.",
   "publishConfig": {
     "access": "public"
   },
@@ -61,6 +61,36 @@
       "import": "./dist/database/mongo/index.js",
       "require": "./dist/database/mongo/index.cjs"
     },
+    "./telegram": {
+      "types": "./dist/telegram/index.d.ts",
+      "import": "./dist/telegram/index.js",
+      "require": "./dist/telegram/index.cjs"
+    },
+    "./whatsapp": {
+      "types": "./dist/whatsapp/index.d.ts",
+      "import": "./dist/whatsapp/index.js",
+      "require": "./dist/whatsapp/index.cjs"
+    },
+    "./stripe": {
+      "types": "./dist/stripe/index.d.ts",
+      "import": "./dist/stripe/index.js",
+      "require": "./dist/stripe/index.cjs"
+    },
+    "./auth": {
+      "types": "./dist/auth/index.d.ts",
+      "import": "./dist/auth/index.js",
+      "require": "./dist/auth/index.cjs"
+    },
+    "./email/resend": {
+      "types": "./dist/email/resend/index.d.ts",
+      "import": "./dist/email/resend/index.js",
+      "require": "./dist/email/resend/index.cjs"
+    },
+    "./email/nodemailer": {
+      "types": "./dist/email/nodemailer/index.d.ts",
+      "import": "./dist/email/nodemailer/index.js",
+      "require": "./dist/email/nodemailer/index.cjs"
+    },
     "./i18n": {
       "types": "./dist/i18n/index.d.ts",
       "import": "./dist/i18n/index.js",
@@ -70,6 +100,16 @@
       "types": "./dist/bootstrap/index.d.ts",
       "import": "./dist/bootstrap/index.js",
       "require": "./dist/bootstrap/index.cjs"
+    },
+    "./meta": {
+      "types": "./dist/meta/index.d.ts",
+      "import": "./dist/meta/index.js",
+      "require": "./dist/meta/index.cjs"
+    },
+    "./media": {
+      "types": "./dist/media/index.d.ts",
+      "import": "./dist/media/index.js",
+      "require": "./dist/media/index.cjs"
     }
   },
   "scripts": {
@@ -85,7 +125,13 @@
     "helmet": "^8.0.0",
     "pg": "^8.11.0",
     "reflect-metadata": "^0.2.0",
-    "rxjs": "^7.8.0"
+    "rxjs": "^7.8.0",
+    "telegraf": "^4.16.0",
+    "stripe": "^22.0.0",
+    "class-validator": "^0.15.0",
+    "class-transformer": "^0.5.1",
+    "resend": "^6.20.0",
+    "nodemailer": "^9.0.5"
   },
   "peerDependenciesMeta": {
     "pg": {
@@ -99,25 +145,53 @@
     },
     "helmet": {
       "optional": true
+    },
+    "telegraf": {
+      "optional": true
+    },
+    "stripe": {
+      "optional": true
+    },
+    "class-validator": {
+      "optional": true
+    },
+    "class-transformer": {
+      "optional": true
+    },
+    "resend": {
+      "optional": true
+    },
+    "nodemailer": {
+      "optional": true
     }
   },
   "dependencies": {
-    "nestjs-i18n": "^10.4.5"
+    "nestjs-i18n": "^10.4.5",
+    "bcryptjs": "^3.0.3",
+    "jsonwebtoken": "^9.0.3"
   },
   "devDependencies": {
-    "typescript": "^5.6.0",
-    "tsup": "^8.5.1",
-    "@types/node": "^22.0.0",
     "@nestjs/common": "^11.0.0",
     "@nestjs/core": "^11.0.0",
     "@nestjs/swagger": "^11.0.0",
     "@supabase/supabase-js": "^2.45.0",
-    "pg": "^8.11.0",
+    "@types/jsonwebtoken": "^9.0.10",
+    "@types/node": "^22.0.0",
+    "@types/nodemailer": "^8.0.1",
     "@types/pg": "^8.11.0",
+    "bcryptjs": "^3.0.3",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.15.1",
     "helmet": "^8.0.0",
+    "jsonwebtoken": "^9.0.3",
+    "nodemailer": "^9.0.5",
+    "pg": "^8.11.0",
     "reflect-metadata": "^0.2.0",
+    "resend": "^6.20.0",
     "rxjs": "^7.8.0",
-    "class-validator": "^0.14.0",
-    "class-transformer": "^0.5.1"
+    "stripe": "^22.5.0",
+    "telegraf": "^4.16.3",
+    "tsup": "^8.5.1",
+    "typescript": "^5.6.0"
   }
 }