provider based doc added

Author: anisafifi

readme.md

@@ -132,6 +132,149 @@ Current provider ids:
 - `smsnetbd`
 - `bulksmsbd`
 
+## Provider Examples
+
+```typescript
+import { sendSms } from "sms-kit";
+
+// Twilio
+await sendSms({
+  provider: "twilio",
+  message: {
+    to: ["+15005550006"],
+    message: "Twilio test message",
+  },
+  config: {
+    accountSid: "your_twilio_sid",
+    authToken: "your_twilio_token",
+    from: "+15005550006",
+  },
+});
+```
+
+```typescript
+import { sendSms } from "sms-kit";
+
+// MessageBird
+await sendSms({
+  provider: "messagebird",
+  message: {
+    to: ["+8801712345678"],
+    message: "MessageBird test message",
+  },
+  config: {
+    accessKey: "your_messagebird_key",
+    originator: "MyBrand",
+  },
+});
+```
+
+```typescript
+import { sendSms } from "sms-kit";
+
+// SMS.to
+await sendSms({
+  provider: "smsto",
+  message: {
+    to: ["+8801712345678"],
+    message: "SMS.to test message",
+  },
+  config: {
+    apiKey: "your_smsto_key",
+    senderId: "MyBrand",
+  },
+});
+```
+
+```typescript
+import { sendSms } from "sms-kit";
+
+// Textlocal
+await sendSms({
+  provider: "textlocal",
+  message: {
+    to: ["+447000000000"],
+    message: "Textlocal test message",
+  },
+  config: {
+    apiKey: "your_textlocal_key",
+    sender: "MyBrand",
+  },
+});
+```
+
+```typescript
+import { sendSms } from "sms-kit";
+
+// BulkSMS
+await sendSms({
+  provider: "bulksms",
+  message: {
+    to: ["+447000000000"],
+    message: "BulkSMS test message",
+  },
+  config: {
+    tokenId: "your_bulksms_token_id",
+    tokenSecret: "your_bulksms_token_secret",
+  },
+});
+```
+
+```typescript
+import { sendSms } from "sms-kit";
+
+// MiMSMS
+await sendSms({
+  provider: "mimsms",
+  message: {
+    to: ["88018XXXXXXXX"],
+    message: "MiMSMS test message",
+    senderId: "MiM SMS",
+  },
+  config: {
+    username: "you@example.com",
+    apiKey: "your_mimsms_key",
+    transactionType: "T",
+    campaignId: null,
+  },
+});
+```
+
+```typescript
+import { sendSms } from "sms-kit";
+
+// sms.net.bd (Alpha SMS)
+await sendSms({
+  provider: "smsnetbd",
+  message: {
+    to: ["8801800000000", "8801700000000"],
+    message: "sms.net.bd test message",
+    senderId: "MyBrand",
+  },
+  config: {
+    apiKey: "your_smsnetbd_key",
+    schedule: "2021-10-13 16:00:52",
+  },
+});
+```
+
+```typescript
+import { sendSms } from "sms-kit";
+
+// BulkSMSBD
+await sendSms({
+  provider: "bulksmsbd",
+  message: {
+    to: ["88017XXXXXXXX"],
+    message: "BulkSMSBD test message",
+    senderId: "8809617626719",
+  },
+  config: {
+    apiKey: "your_bulksmsbd_key",
+  },
+});
+```
+
 ## License
 
 This package is open-source and available under the MIT License.

src/providers/twilio.ts

@@ -6,15 +6,58 @@ import {
 } from "../type";
 import { readEnv } from "../utils/env";
 
+const DEFAULT_API_BASE_URL = "https://api.twilio.com";
+
 function resolveConfig(config?: TwilioConfig): TwilioConfig {
   return {
     accountSid: config?.accountSid ?? readEnv("TWILIO_ACCOUNT_SID"),
     authToken: config?.authToken ?? readEnv("TWILIO_AUTH_TOKEN"),
     from: config?.from ?? readEnv("TWILIO_FROM"),
-    apiBaseUrl: config?.apiBaseUrl ?? readEnv("TWILIO_API_BASE_URL"),
+    apiBaseUrl:
+      config?.apiBaseUrl ?? readEnv("TWILIO_API_BASE_URL") ?? DEFAULT_API_BASE_URL,
   };
 }
 
+function buildAuthHeader(accountSid: string, authToken: string): string {
+  return `Basic ${Buffer.from(`${accountSid}:${authToken}`).toString("base64")}`;
+}
+
+async function sendSingleMessage(
+  config: Required<Pick<TwilioConfig, "accountSid" | "authToken" | "from" | "apiBaseUrl">>,
+  to: string,
+  body: string
+): Promise<{ ok: boolean; status: number; data: unknown }>
+{
+  const url = new URL(
+    `/2010-04-01/Accounts/${config.accountSid}/Messages.json`,
+    config.apiBaseUrl
+  );
+
+  const form = new URLSearchParams({
+    To: to,
+    From: config.from,
+    Body: body,
+  });
+
+  const response = await fetch(url.toString(), {
+    method: "POST",
+    headers: {
+      Authorization: buildAuthHeader(config.accountSid, config.authToken),
+      "Content-Type": "application/x-www-form-urlencoded",
+    },
+    body: form.toString(),
+  });
+
+  let data: unknown;
+  try {
+    data = await response.json();
+  } catch {
+    data = await response.text();
+  }
+
+  return { ok: response.ok, status: response.status, data };
+}
+
 export const twilioAdapter: ProviderAdapter<TwilioConfig> = {
   id: "twilio",
   async send(options: ProviderSendOptions<TwilioConfig>): Promise<SmsResponse> {
@@ -29,11 +72,78 @@ export const twilioAdapter: ProviderAdapter<TwilioConfig> = {
       };
     }
 
+    if (!config.from) {
+      return {
+        success: false,
+        provider: "twilio",
+        error:
+          "Twilio sender is missing. Provide from or set TWILIO_FROM.",
+      };
+    }
+
+    const recipients = options.message.to;
+    if (recipients.length === 0) {
+      return {
+        success: false,
+        provider: "twilio",
+        error: "At least one recipient is required.",
+      };
+    }
+
+    const resolvedConfig = {
+      accountSid: config.accountSid,
+      authToken: config.authToken,
+      from: config.from,
+      apiBaseUrl: config.apiBaseUrl ?? DEFAULT_API_BASE_URL,
+    };
+
+    if (recipients.length === 1) {
+      const result = await sendSingleMessage(
+        resolvedConfig,
+        recipients[0],
+        options.message.message
+      );
+
+      if (!result.ok) {
+        return {
+          success: false,
+          provider: "twilio",
+          statusCode: result.status,
+          error: "Twilio request failed.",
+          data: result.data,
+        };
+      }
+
+      return {
+        success: true,
+        provider: "twilio",
+        statusCode: result.status,
+        data: result.data,
+      };
+    }
+
+    const results = [] as Array<{ to: string; ok: boolean; status: number; data: unknown }>;
+    let hasFailure = false;
+
+    for (const to of recipients) {
+      const result = await sendSingleMessage(
+        resolvedConfig,
+        to,
+        options.message.message
+      );
+      results.push({ to, ok: result.ok, status: result.status, data: result.data });
+      if (!result.ok) {
+        hasFailure = true;
+      }
+    }
+
     return {
-      success: false,
+      success: !hasFailure,
       provider: "twilio",
-      error:
-        "Twilio adapter is scaffolded. Add request details in src/providers/twilio.ts.",
+      statusCode: hasFailure ? 207 : 200,
+      data: results,
+      error: hasFailure ? "One or more Twilio requests failed." : undefined,
     };
+
   },
 };