automas added

Author: anisafifi

readme.md

@@ -91,6 +91,10 @@ SMSNETBD_CONTENT_ID=
 
 BULKSMSBD_API_KEY=your_bulksmsbd_key
 BULKSMSBD_SENDER_ID=MyBrand
+
+AUTOMAS_API_KEY=your_automas_key
+AUTOMAS_SENDER_ID=AUTOMAS
+AUTOMAS_API_BASE_URL=https://api.automas.sms.com
 ```
 
 ## Error Handling
@@ -100,7 +104,7 @@ The `sendSms` function will return an object with the following structure:
 ```typescript
 {
   success: boolean;
-  provider: "twilio" | "messagebird" | "smsto" | "textlocal" | "bulksms" | "mimsms" | "smsnetbd" | "bulksmsbd" | "unknown";
+  provider: "twilio" | "messagebird" | "smsto" | "textlocal" | "bulksms" | "mimsms" | "smsnetbd" | "bulksmsbd" | "automas" | "unknown";
   data?: unknown;
   error?: string;
   statusCode?: number;
@@ -131,6 +135,7 @@ Current provider ids:
 - `mimsms`
 - `smsnetbd`
 - `bulksmsbd`
+- `automas`
 
 ## Provider Examples
 
@@ -275,6 +280,23 @@ await sendSms({
 });
 ```
 
+```typescript
+import { sendSms } from "sms-kit";
+
+// Automas
+await sendSms({
+  provider: "automas",
+  message: {
+    to: ["8801700000000", "8801800000000"],
+    message: "Hello from Automas",
+    senderId: "AUTOMAS",
+  },
+  config: {
+    apiKey: "your_automas_key",
+  },
+});
+```
+
 ## License
 
 This package is open-source and available under the MIT License.

src/providers/automas.ts

@@ -0,0 +1,90 @@
+import {
+  ProviderAdapter,
+  ProviderSendOptions,
+  SmsResponse,
+  AutomasConfig,
+} from "../type";
+import { readEnv } from "../utils/env";
+
+const DEFAULT_API_BASE_URL = "https://api.automas.sms.com";
+
+function resolveConfig(config?: AutomasConfig): AutomasConfig {
+  return {
+    apiKey: config?.apiKey ?? readEnv("AUTOMAS_API_KEY"),
+    senderId: config?.senderId ?? readEnv("AUTOMAS_SENDER_ID"),
+    apiBaseUrl: config?.apiBaseUrl ?? readEnv("AUTOMAS_API_BASE_URL") ?? DEFAULT_API_BASE_URL,
+  };
+}
+
+export const automasAdapter: ProviderAdapter<AutomasConfig> = {
+  id: "automas",
+  async send(options: ProviderSendOptions<AutomasConfig>): Promise<SmsResponse> {
+    const config = resolveConfig(options.config);
+
+    if (!config.apiKey) {
+      return {
+        success: false,
+        provider: "automas",
+        error: "Automas apiKey is missing. Provide apiKey or set AUTOMAS_API_KEY.",
+      };
+    }
+
+    const recipients = options.message.to;
+    if (!recipients || recipients.length === 0) {
+      return {
+        success: false,
+        provider: "automas",
+        error: "At least one recipient is required.",
+      };
+    }
+
+    // Automas accepts multiple recipients as comma-separated
+    const toParam = recipients.join(",");
+
+    const params = new URLSearchParams({
+      api_key: config.apiKey,
+      to: toParam,
+      message: options.message.message,
+    } as Record<string, string>);
+
+    if (options.message.senderId || config.senderId) {
+      params.set("sender_id", options.message.senderId ?? config.senderId ?? "");
+    }
+
+    // If message may include scheduling or campaign tracking, allow passing via message object extras
+    // The library doesn't define extras on SmsMessage; users can pass schedule via message.senderId pattern or config.
+
+    const baseUrl = config.apiBaseUrl ?? DEFAULT_API_BASE_URL;
+    const url = `${baseUrl.replace(/\/$/, "")}/sms/send?${params.toString()}`;
+
+    let res: Response;
+    try {
+      res = await fetch(url, { method: "GET" });
+    } catch (err) {
+      return {
+        success: false,
+        provider: "automas",
+        error: "Network error when contacting Automas.",
+        data: err instanceof Error ? err.message : String(err),
+      };
+    }
+
+    let data: unknown;
+    try {
+      data = await res.json();
+    } catch {
+      data = await res.text();
+    }
+
+    // Automas example response contains `error: 0` when accepted
+    const accepted = typeof data === "object" && data !== null && (data as any).error === 0;
+
+    return {
+      success: !!accepted && res.ok,
+      provider: "automas",
+      statusCode: res.status,
+      data,
+      error: accepted || res.ok ? undefined : "Automas request failed.",
+    };
+  },
+};

src/providers/index.ts

@@ -11,6 +11,7 @@ import { smsNetBdAdapter } from "./smsnetbd";
 import { smsToAdapter } from "./smsto";
 import { textlocalAdapter } from "./textlocal";
 import { twilioAdapter } from "./twilio";
+import { automasAdapter } from "./automas";
 
 const providers: {
   [K in SmsProviderId]: ProviderAdapter<ProviderConfigMap[K]>;
@@ -23,6 +24,7 @@ const providers: {
   mimsms: mimSmsAdapter,
   smsnetbd: smsNetBdAdapter,
   bulksmsbd: bulksmsbdAdapter,
+  automas: automasAdapter,
 };
 
 export function getProviderAdapter<TProvider extends SmsProviderId>(

src/type.ts

@@ -6,7 +6,8 @@ export type SmsProviderId =
   | "bulksms"
   | "mimsms"
   | "smsnetbd"
-  | "bulksmsbd";
+  | "bulksmsbd"
+  | "automas";
 
 export type SmsResponseProvider = SmsProviderId | "unknown";
 
@@ -73,6 +74,12 @@ export type BulkSmsBdConfig = {
   apiBaseUrl?: string;
 };
 
+export type AutomasConfig = {
+  apiKey?: string;
+  senderId?: string;
+  apiBaseUrl?: string;
+};
+
 export type ProviderConfigMap = {
   twilio: TwilioConfig;
   messagebird: MessageBirdConfig;
@@ -82,6 +89,7 @@ export type ProviderConfigMap = {
   mimsms: MimSmsConfig;
   smsnetbd: SmsNetBdConfig;
   bulksmsbd: BulkSmsBdConfig;
+  automas: AutomasConfig;
 };
 
 export type SendSmsOptions<TProvider extends SmsProviderId = SmsProviderId> = {