@solidxai/core 0.1.10-beta.9 → 0.1.10

package/src/services/selection-providers/mq-dashboard-message-broker-variable-options-provider.service.ts

@@ -0,0 +1,52 @@
+import { Injectable } from "@nestjs/common";
+import { SelectionProvider } from "src/decorators/selection-provider.decorator";
+import { MqMessageRepository } from "src/repository/mq-message.repository";
+import { ISelectionProvider, ISelectionProviderContext, ISelectionProviderValues } from "src/interfaces";
+
+@SelectionProvider()
+@Injectable()
+export class MqDashboardMessageBrokerVariableOptionsProvider implements ISelectionProvider<ISelectionProviderContext> {
+    constructor(
+        private readonly mqMessageRepository: MqMessageRepository,
+    ) { }
+
+    name(): string {
+        return "MqDashboardMessageBrokerVariableOptionsProvider";
+    }
+
+    help(): string {
+        return "Dynamic options provider for dashboard messageBroker variable.";
+    }
+
+    async value(optionValue: string): Promise<ISelectionProviderValues | null> {
+        if (!optionValue) return null;
+        return { label: optionValue, value: optionValue };
+    }
+
+    async values(query: string, ctxt: ISelectionProviderContext): Promise<readonly ISelectionProviderValues[]> {
+        const qb = await this.mqMessageRepository.createSecurityRuleAwareQueryBuilder("mqMessage");
+        const limit = Math.min(Math.max(ctxt?.limit ?? 25, 1), 200);
+        const offset = Math.max(ctxt?.offset ?? 0, 0);
+
+        qb.select("DISTINCT mqMessage.messageBroker", "value")
+            .where("mqMessage.messageBroker IS NOT NULL");
+
+        if (query) {
+            qb.andWhere("mqMessage.messageBroker ILIKE :query", { query: `%${query}%` });
+        }
+
+        const rows = await qb
+            .orderBy("value", "ASC")
+            .take(limit)
+            .skip(offset)
+            .getRawMany<{ value: string }>();
+
+        return rows
+            .filter((r) => !!r?.value)
+            .map((r) => ({
+                label: r.value,
+                value: r.value,
+            }));
+    }
+}
+

package/src/services/selection-providers/mq-dashboard-queue-name-variable-options-provider.service.ts

@@ -0,0 +1,51 @@
+import { Injectable } from "@nestjs/common";
+import { SelectionProvider } from "src/decorators/selection-provider.decorator";
+import { MqMessageQueueRepository } from "src/repository/mq-message-queue.repository";
+import { ISelectionProvider, ISelectionProviderContext, ISelectionProviderValues } from "src/interfaces";
+
+@SelectionProvider()
+@Injectable()
+export class MqDashboardQueueNameVariableOptionsProvider implements ISelectionProvider<ISelectionProviderContext> {
+    constructor(
+        private readonly mqMessageQueueRepository: MqMessageQueueRepository,
+    ) { }
+
+    name(): string {
+        return "MqDashboardQueueNameVariableOptionsProvider";
+    }
+
+    help(): string {
+        return "Dynamic options provider for dashboard queueName variable.";
+    }
+
+    async value(optionValue: string): Promise<ISelectionProviderValues | null> {
+        if (!optionValue) return null;
+        const queue = await this.mqMessageQueueRepository.findOne({
+            where: { name: optionValue },
+        });
+        if (!queue?.name) return null;
+        return { label: queue.name, value: queue.name };
+    }
+
+    async values(query: string, ctxt: ISelectionProviderContext): Promise<readonly ISelectionProviderValues[]> {
+        const qb = await this.mqMessageQueueRepository.createSecurityRuleAwareQueryBuilder("mqMessageQueue");
+        const limit = Math.min(Math.max(ctxt?.limit ?? 25, 1), 200);
+        const offset = Math.max(ctxt?.offset ?? 0, 0);
+
+        if (query) {
+            qb.andWhere("mqMessageQueue.name ILIKE :query", { query: `%${query}%` });
+        }
+
+        const records = await qb
+            .select(["mqMessageQueue.name"])
+            .orderBy("mqMessageQueue.name", "ASC")
+            .take(limit)
+            .skip(offset)
+            .getMany();
+
+        return records
+            .filter((r) => !!r?.name)
+            .map((r) => ({ label: r.name, value: r.name }));
+    }
+}
+

package/src/services/settings/default-settings-provider.service.ts

@@ -43,6 +43,16 @@ const getSolidCoreSettings = (isProd: boolean) =>
       sortOrder: 50,
       controlType: "boolean",
     },
+    {
+      moduleName: "solid-core",
+      key: "iamMicrosoftActiveDirectoryOAuthEnabled",
+      value: false,
+      level: SettingLevel.SystemAdminEditable,
+      label: "Allow Login / Signup With Microsoft Active Directory",
+      group: "authentication-settings",
+      sortOrder: 50,
+      controlType: "boolean",
+    },
     {
       moduleName: "solid-core",
       key: "authPagesLayout",
@@ -363,6 +373,16 @@ const getSolidCoreSettings = (isProd: boolean) =>
       group: "system-settings",
       sortOrder: 30,
       controlType: "shortText",
+    }, 
+    {
+      moduleName: "solid-core",
+      key: "frontendAdminBaseUrl",
+      value: process.env.FRONTEND_BASE_URL,
+      level: SettingLevel.SystemAdminReadonly,
+      label: "Frontend Admin Base URL",
+      group: "system-settings",
+      sortOrder: 35,
+      controlType: "shortText",
     },
     {
       moduleName: "solid-core",
@@ -693,6 +713,55 @@ const getSolidCoreSettings = (isProd: boolean) =>
       level: SettingLevel.SystemAdminReadonly,
     },
 
+    // microsoft-active-directory-oauth-settings-provider.service.ts
+    {
+      moduleName: "solid-core",
+      key: "MICROSOFT_ACTIVE_DIRECTORY_CLIENT_ID",
+      value: process.env.IAM_MICROSOFT_ACTIVE_DIRECTORY_OAUTH_CLIENT_ID,
+      level: SettingLevel.SystemAdminReadonly,
+      label: "Microsoft Active Directory OAuth Client ID",
+      group: "oauth-settings",
+      sortOrder: 70,
+      controlType: "shortText",
+    },
+    {
+      moduleName: "solid-core",
+      key: "MICROSOFT_ACTIVE_DIRECTORY_CLIENT_SECRET",
+      value: process.env.IAM_MICROSOFT_ACTIVE_DIRECTORY_OAUTH_CLIENT_SECRET,
+      level: SettingLevel.SystemEnv,
+    },
+    {
+      moduleName: "solid-core",
+      key: "MICROSOFT_ACTIVE_DIRECTORY_TENANT_ID",
+      value:
+        process.env.IAM_MICROSOFT_ACTIVE_DIRECTORY_OAUTH_TENANT_ID || "common",
+      level: SettingLevel.SystemAdminReadonly,
+      label: "Microsoft Active Directory OAuth Tenant ID",
+      group: "oauth-settings",
+      sortOrder: 80,
+      controlType: "shortText",
+    },
+    {
+      moduleName: "solid-core",
+      key: "MICROSOFT_ACTIVE_DIRECTORY_CALLBACK_URL",
+      value: process.env.IAM_MICROSOFT_ACTIVE_DIRECTORY_OAUTH_CALLBACK_URL,
+      level: SettingLevel.SystemAdminReadonly,
+      label: "Microsoft Active Directory OAuth Callback URL",
+      group: "oauth-settings",
+      sortOrder: 90,
+      controlType: "shortText",
+    },
+    {
+      moduleName: "solid-core",
+      key: "MICROSOFT_ACTIVE_DIRECTORY_REDIRECT_URL",
+      value: process.env.IAM_MICROSOFT_ACTIVE_DIRECTORY_OAUTH_REDIRECT_URL,
+      level: SettingLevel.SystemAdminReadonly,
+      label: "Microsoft Active Directory OAuth Redirect URL",
+      group: "oauth-settings",
+      sortOrder: 100,
+      controlType: "shortText",
+    },
+
     // iam-settings-provider.service.ts
     {
       moduleName: "solid-core",
@@ -779,6 +848,46 @@ const getSolidCoreSettings = (isProd: boolean) =>
       value: parseInt(process.env.IAM_OTP_EXPIRY ?? "10"),
       level: SettingLevel.SystemEnv,
     },
+    {
+      moduleName: "solid-core",
+      key: "otpWhatsappFallbackEnabled",
+      value: (process.env.IAM_OTP_WHATSAPP_FALLBACK_ENABLED ?? "true") === "true",
+      level: SettingLevel.SystemAdminEditable,
+      label: "OTP WhatsApp Fallback Enabled",
+      group: "authentication-settings",
+      sortOrder: 85,
+      controlType: "boolean",
+    },
+    {
+      moduleName: "solid-core",
+      key: "otpWhatsappTemplateId",
+      value: process.env.IAM_OTP_WHATSAPP_TEMPLATE_ID ?? "common_otp",
+      level: SettingLevel.SystemAdminEditable,
+      label: "OTP WhatsApp Template ID",
+      group: "authentication-settings",
+      sortOrder: 86,
+      controlType: "shortText",
+    },
+    {
+      moduleName: "solid-core",
+      key: "otpWhatsappIndependentEnabled",
+      value: (process.env.IAM_OTP_WHATSAPP_INDEPENDENT_ENABLED ?? "true") === "true",
+      level: SettingLevel.SystemAdminEditable,
+      label: "OTP WhatsApp Independent Enabled",
+      group: "authentication-settings",
+      sortOrder: 87,
+      controlType: "boolean",
+    },
+    {
+      moduleName: "solid-core",
+      key: "otpDefaultCountryDialCode",
+      value: process.env.IAM_OTP_DEFAULT_COUNTRY_DIAL_CODE ?? "",
+      level: SettingLevel.SystemAdminEditable,
+      label: "OTP Default Country Dial Code",
+      group: "authentication-settings",
+      sortOrder: 88,
+      controlType: "shortText",
+    },
     {
       moduleName: "solid-core",
       key: "forgotPasswordVerificationTokenExpiry",
@@ -1178,6 +1287,64 @@ const getSolidCoreSettings = (isProd: boolean) =>
       sortOrder: 30,
       controlType: "shortText",
     },
+    {
+      moduleName: "solid-core",
+      key: "metaWhatsappApiUrl",
+      value: process.env.COMMON_META_WHATSAPP_API_URL || "https://graph.facebook.com",
+      level: SettingLevel.SystemAdminReadonly,
+      label: "Meta WhatsApp API URL",
+      group: "whatsapp-settings",
+      sortOrder: 40,
+      controlType: "shortText",
+    },
+    {
+      moduleName: "solid-core",
+      key: "metaWhatsappApiVersion",
+      value: process.env.COMMON_META_WHATSAPP_API_VERSION || "v23.0",
+      level: SettingLevel.SystemAdminReadonly,
+      label: "Meta WhatsApp API Version",
+      group: "whatsapp-settings",
+      sortOrder: 50,
+      controlType: "shortText",
+    },
+    {
+      moduleName: "solid-core",
+      key: "metaWhatsappPhoneNumberId",
+      value: process.env.COMMON_META_WHATSAPP_PHONE_NUMBER_ID,
+      level: SettingLevel.SystemAdminReadonly,
+      label: "Meta WhatsApp Phone Number ID",
+      group: "whatsapp-settings",
+      sortOrder: 60,
+      controlType: "shortText",
+    },
+    {
+      moduleName: "solid-core",
+      key: "metaWhatsappBusinessAccountId",
+      value: process.env.COMMON_META_WHATSAPP_BUSINESS_ACCOUNT_ID,
+      level: SettingLevel.SystemAdminReadonly,
+      label: "Meta WhatsApp Business Account ID",
+      group: "whatsapp-settings",
+      sortOrder: 70,
+      controlType: "shortText",
+    },
+    {
+      moduleName: "solid-core",
+      key: "metaWhatsappAccessToken",
+      value: process.env.COMMON_META_WHATSAPP_ACCESS_TOKEN,
+      level: SettingLevel.SystemEnv,
+    },
+    {
+      moduleName: "solid-core",
+      key: "metaWhatsappWebhookVerifyToken",
+      value: process.env.COMMON_META_WHATSAPP_WEBHOOK_VERIFY_TOKEN,
+      level: SettingLevel.SystemEnv,
+    },
+    {
+      moduleName: "solid-core",
+      key: "metaWhatsappAppSecret",
+      value: process.env.COMMON_META_WHATSAPP_APP_SECRET,
+      level: SettingLevel.SystemEnv,
+    },
   ] as const satisfies SettingDefinition[];
 
 // 2.

package/src/services/solid-introspect.service.ts

@@ -6,13 +6,12 @@ import { ModelMetadataRepository } from 'src/repository/model-metadata.repositor
 import { InstanceWrapper } from '@nestjs/core/injector/instance-wrapper';
 import { getDataSourceToken } from '@nestjs/typeorm';
 import { IS_COMPUTED_FIELD_PROVIDER } from 'src/decorators/computed-field-provider.decorator';
-import { IS_DASHBOARD_QUESTION_DATA_PROVIDER } from 'src/decorators/dashboard-question-data-provider.decorator';
-import { IS_DASHBOARD_VARIABLE_SELECTION_PROVIDER } from 'src/decorators/dashboard-selection-provider.decorator';
 import { IS_ERROR_CODE_PROVIDER } from 'src/decorators/error-codes-provider.decorator';
 import { IS_MAIL_PROVIDER } from 'src/decorators/mail-provider.decorator';
 import { IS_SCHEDULED_JOB_PROVIDER } from 'src/decorators/scheduled-job-provider.decorator';
 import { IS_SECURITY_RULE_CONFIG_PROVIDER } from 'src/decorators/security-rule-config-provider.decorator';
 import { IS_SELECTION_PROVIDER } from 'src/decorators/selection-provider.decorator';
+import { IS_DASHBOARD_WIDGET_DATA_PROVIDER } from 'src/decorators/dashboard-widget-data-provider.decorator';
 import { IS_EXTENSION_USER_CREATION_PROVIDER } from 'src/decorators/extension-user-creation-provider.decorator';
 import { IS_SOLID_DATABASE_MODULE } from 'src/decorators/solid-database-module.decorator';
 import { IS_WA_PROVIDER } from 'src/decorators/whatsapp-provider.decorator';
@@ -70,24 +69,18 @@ export class SolidIntrospectService implements OnApplicationBootstrap {
       this.solidRegistry.registerSelectionProvider(selectionProvider);
     });
 
+    // Register all IDashboardWidgetDataProvider implementations
+    const dashboardWidgetDataProviders = this.discoveryService.getProviders().filter((provider) => this.isDashboardWidgetDataProvider(provider));
+    dashboardWidgetDataProviders.forEach((provider) => {
+      this.solidRegistry.registerDashboardWidgetDataProvider(provider);
+    });
+
     // Register all ISettingsProvider implementations
     const settingsProviders = this.discoveryService.getProviders().filter((provider) => this.isSettingsProvider(provider));
     settingsProviders.forEach((settingsProvider) => {
       this.solidRegistry.registerSettingsProvider(settingsProvider);
     });
 
-    // Register all IDashboardSelectionProvider implementations
-    const dashboardVariableSelectionProviders = this.discoveryService.getProviders().filter((provider) => this.isDashboardVariableSelectionProvider(provider));
-    dashboardVariableSelectionProviders.forEach((dashboardSelectionProvider) => {
-      this.solidRegistry.registerDashboardVariableSelectionProvider(dashboardSelectionProvider);
-    });
-
-    // Register all IDashboardSelectionProvider implementations
-    const dashboardQuestionDataProviders = this.discoveryService.getProviders().filter((provider) => this.isDashboardQuestionDataProvider(provider));
-    dashboardQuestionDataProviders.forEach((provider) => {
-      this.solidRegistry.registerDashboardQuestionDataProvider(provider);
-    });
-
     // Register all IComputedProvider implementations
     const computedFieldProviders = this.discoveryService.getProviders().filter((provider) => this.isComputedFieldProvider(provider));
     computedFieldProviders.forEach((computedFieldProvider) => {
@@ -250,16 +243,6 @@ export class SolidIntrospectService implements OnApplicationBootstrap {
     }
   }
 
-  isDashboardQuestionDataProvider(providerWrapper: InstanceWrapper<any>) {
-    const { instance } = providerWrapper;
-    if (!instance) return false;
-    const provider = this.reflector.get<boolean>(
-      IS_DASHBOARD_QUESTION_DATA_PROVIDER,
-      instance.constructor,
-    );
-    return !!provider;
-  }
-
   // This method identifies a provider as a seeder if it has a seed method i.e duck typing
   private isSeeder(provider: InstanceWrapper) {
     const { instance } = provider;
@@ -294,6 +277,18 @@ export class SolidIntrospectService implements OnApplicationBootstrap {
     return !!isSelectionProvider;
   }
 
+  private isDashboardWidgetDataProvider(provider: InstanceWrapper) {
+    const { instance } = provider;
+    if (!instance) return false;
+
+    const isDashboardWidgetDataProvider = this.reflector.get<boolean>(
+      IS_DASHBOARD_WIDGET_DATA_PROVIDER,
+      instance.constructor,
+    );
+
+    return !!isDashboardWidgetDataProvider;
+  }
+
   private isExtensionUserCreationProvider(provider: InstanceWrapper): boolean {
     const { instance } = provider;
     if (!instance) return false;
@@ -312,16 +307,6 @@ export class SolidIntrospectService implements OnApplicationBootstrap {
     return !!isSettingsProvider;
   }
 
-  private isDashboardVariableSelectionProvider(provider: InstanceWrapper) {
-    const { instance } = provider;
-    if (!instance) return false;
-    const isDashboardSelectionProvider = this.reflector.get<boolean>(
-      IS_DASHBOARD_VARIABLE_SELECTION_PROVIDER,
-      instance.constructor,
-    );
-    return !!isDashboardSelectionProvider;
-  }
-
   private isComputedFieldProvider(provider: InstanceWrapper) {
     const { instance } = provider;
     if (!instance) return false;

package/src/services/user.service.ts

@@ -30,6 +30,23 @@ export class UserService extends CRUDService<User> {
     return normalized || "facebook_user";
   }
 
+  private buildMicrosoftActiveDirectoryUsernameBase(
+    email?: string,
+    providerId?: string,
+    name?: string,
+  ): string {
+    const source =
+      email ||
+      name ||
+      (providerId ? `microsoft_active_directory_${providerId}` : "");
+    const normalized = source
+      .trim()
+      .toLowerCase()
+      .replace(/[^a-z0-9@._-]+/g, "_")
+      .replace(/^_+|_+$/g, "");
+    return normalized || "microsoft_active_directory_user";
+  }
+
   private async resolveUniqueUsername(
     preferredUsername: string,
     // fallbackUsername: string,
@@ -285,7 +302,7 @@ export class UserService extends CRUDService<User> {
   }
 
   async resolveUserOnOauthFacebook(oauthUserDto: OauthUserDto): Promise<User> {
-    const normalizedEmail = oauthUserDto.email?.trim().toLowerCase() || null;
+    const normalizedEmail = oauthUserDto.email?.trim().toLowerCase();
     let user: User | null = null;
 
     if (oauthUserDto.providerId) {
@@ -397,6 +414,50 @@ export class UserService extends CRUDService<User> {
     return user;
   }
 
+  async resolveUserOnOauthMicrosoftActiveDirectory(
+    oauthUserDto: OauthUserDto,
+  ): Promise<User> {
+    const user = await this.repo.findOne({
+      where: {
+        email: oauthUserDto.email,
+      },
+      relations: {
+        roles: true,
+      },
+    });
+
+    if (!user) {
+      const newUser = new User();
+      newUser.username = oauthUserDto.email;
+      newUser.email = oauthUserDto.email;
+      newUser.fullName = oauthUserDto.name;
+      newUser.lastLoginProvider = oauthUserDto.provider;
+      newUser.accessCode = oauthUserDto.accessCode;
+      newUser.microsoftActiveDirectoryAccessToken = oauthUserDto.accessToken;
+      newUser.microsoftActiveDirectoryId = oauthUserDto.providerId;
+      newUser.microsoftActiveDirectoryProfilePicture = oauthUserDto.picture;
+
+      const savedUser = await this.repo.save(newUser);
+
+      await this.initializeRolesForNewUser(
+        [this.settingService.getConfigValue<SolidCoreSetting>("defaultRole")],
+        savedUser,
+      );
+    } else {
+      const entity = await this.repo.preload({
+        id: user.id,
+        lastLoginProvider: oauthUserDto.provider,
+        accessCode: oauthUserDto.accessCode,
+        microsoftActiveDirectoryAccessToken: oauthUserDto.accessToken,
+        microsoftActiveDirectoryId: oauthUserDto.providerId,
+        microsoftActiveDirectoryProfilePicture: oauthUserDto.picture,
+      });
+
+      await this.repo.save(entity);
+    }
+    return user;
+  }
+
   async findUsersByRole(
     roleName: string,
     relations: any = {},

package/src/services/whatsapp/GupshupOtpWhatsappService.ts

@@ -0,0 +1,174 @@
+import { HttpService } from "@nestjs/axios";
+import { Injectable, Logger } from "@nestjs/common";
+import { AxiosError } from "axios";
+import { WhatsAppProvider } from "src/decorators/whatsapp-provider.decorator";
+import { IWhatsAppTransport } from "src/interfaces";
+
+@Injectable()
+@WhatsAppProvider()
+export class GupshupOtpWhatsappService implements IWhatsAppTransport {
+  private readonly logger = new Logger(GupshupOtpWhatsappService.name);
+
+  constructor(private readonly httpService: HttpService) {}
+
+  async sendWhatsAppMessage(
+    to: string,
+    templateId: string,
+    parameters: any,
+    parentEntity?: any,
+    parentEntityId?: any,
+  ): Promise<any> {
+    if (!to) {
+      throw new Error("WhatsApp destination number is required");
+    }
+
+    const payload = parameters?.payload;
+    if (payload?.message?.type === "text" && payload?.message?.text) {
+      await this.sendTextMessage(
+        payload.destination || to,
+        payload.message.text,
+        payload.source,
+        payload["src.name"],
+      );
+      return { to, templateId, parameters, parentEntity, parentEntityId };
+    }
+
+    if (parameters?.type === "text" && parameters?.text) {
+      await this.sendTextMessage(to, parameters.text);
+      return { to, templateId, parameters, parentEntity, parentEntityId };
+    }
+
+    if (!templateId) {
+      throw new Error("WhatsApp templateId is required for template message");
+    }
+
+    const bodyParams = Array.isArray(parameters)
+      ? parameters
+      : Array.isArray(parameters?.body)
+        ? parameters.body
+        : [];
+
+    await this.sendOtpTemplate(to, templateId, bodyParams.map((x) => String(x)));
+    return { to, templateId, parameters, parentEntity, parentEntityId };
+  }
+
+  private async sendTextMessage(
+    destination: string,
+    text: string,
+    sourceOverride?: string,
+    appNameOverride?: string,
+  ): Promise<void> {
+    const apiKey =
+      process.env.COMMON_GUPSHUP_WHATSAPP_API_KEY ||
+      process.env.GUPSHUP_API_KEY;
+    const msgUrl =
+      process.env.COMMON_GUPSHUP_WHATSAPP_API_URL ||
+      process.env.GUPSHUP_API_URL ||
+      "https://api.gupshup.io/wa/api/v1/msg";
+    const source =
+      sourceOverride ||
+      process.env.COMMON_GUPSHUP_WHATSAPP_SOURCE ||
+      process.env.GUPSHUP_SOURCE_NUMBER;
+    const appName =
+      appNameOverride || process.env.COMMON_GUPSHUP_APP_NAME || "solidx";
+
+    if (!apiKey || !msgUrl || !source) {
+      throw new Error("Missing Gupshup WhatsApp configuration for text message");
+    }
+
+    const rawDestination = destination.replace(/\D/g, "");
+    const params = new URLSearchParams();
+    params.append("channel", "whatsapp");
+    params.append("source", source);
+    params.append("destination", rawDestination);
+    params.append("src.name", appName);
+    params.append("message", JSON.stringify({ type: "text", text }));
+
+    await this.httpService.axiosRef.post(msgUrl, params.toString(), {
+      headers: {
+        apikey: apiKey,
+        "Content-Type": "application/x-www-form-urlencoded",
+      },
+    });
+  }
+
+  async sendOtpTemplate(
+    destination: string,
+    templateId: string,
+    bodyParams: string[],
+  ): Promise<void> {
+    const apiKey =
+      process.env.COMMON_GUPSHUP_WHATSAPP_API_KEY ||
+      process.env.GUPSHUP_API_KEY;
+    const baseUrl =
+      process.env.COMMON_GUPSHUP_WHATSAPP_API_URL ||
+      process.env.GUPSHUP_API_URL ||
+      "https://api.gupshup.io/wa/api/v1/msg";
+    const templateUrl =
+      process.env.COMMON_GUPSHUP_WHATSAPP_TEMPLATE_API_URL ||
+      baseUrl.replace(/\/msg$/, "/template/msg");
+    const source =
+      process.env.COMMON_GUPSHUP_WHATSAPP_SOURCE ||
+      process.env.GUPSHUP_SOURCE_NUMBER;
+    const appName = process.env.COMMON_GUPSHUP_APP_NAME || "solidx";
+
+    if (!apiKey || !templateUrl || !source) {
+      throw new Error("Missing Gupshup OTP WhatsApp configuration");
+    }
+
+    if (!destination || !String(destination).trim()) {
+      throw new Error("WhatsApp destination is empty");
+    }
+
+    try {
+      const rawDestination = destination.replace(/\D/g, "");
+      const params = new URLSearchParams();
+      params.append("channel", "whatsapp");
+      params.append("source", source);
+      params.append("destination", rawDestination);
+      params.append(
+        "to",
+        rawDestination.startsWith("+")
+          ? rawDestination
+          : `+${rawDestination}`,
+      );
+      params.append("src.name", appName);
+      params.append(
+        "template",
+        JSON.stringify({
+          id: templateId,
+          params: bodyParams,
+        }),
+      );
+
+      this.logger.debug(
+        `Gupshup OTP outbound (template): endpoint=${templateUrl}, source=${source}, destination=${rawDestination}, to=${rawDestination.startsWith("+") ? rawDestination : `+${rawDestination}`}, templateId=${templateId}, params=${JSON.stringify(bodyParams)}`,
+      );
+
+      const response = await this.httpService.axiosRef.post(
+        templateUrl,
+        params.toString(),
+        {
+          headers: {
+            apikey: apiKey,
+            "Content-Type": "application/x-www-form-urlencoded",
+          },
+        },
+      );
+
+      this.logger.debug(
+        `Gupshup response: ${response.status}, data=${JSON.stringify(response.data)}`,
+      );
+
+      this.logger.debug(
+        `Independent OTP WhatsApp sent to ${rawDestination} template=${templateId} via template endpoint`,
+      );
+    } catch (error) {
+      const axiosError = error as AxiosError;
+      this.logger.error(
+        `Independent OTP WhatsApp failed: destination=${destination}, templateId=${templateId}, status=${axiosError.response?.status ?? "unknown"}, response=${typeof axiosError.response?.data === "object" ? JSON.stringify(axiosError.response?.data) : axiosError.response?.data}, url=${templateUrl}`,
+      );
+      throw error;
+    }
+  }
+}