townkrier-termii 1.0.0-alpha.6

package/CHANGELOG.md

@@ -0,0 +1,44 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+# 1.0.0-alpha.5 (2026-02-02)
+
+### Bug Fixes
+
+- Update publish workflow to enforce frozen lockfile and adjust publish commands ([ae73a10](https://github.com/jeremiah-olisa/townkrier/commit/ae73a10c7629f54b0e2de4b1f648e6e721125dbc))
+
+### Features
+
+- add bulk SMS support to Termii channel by enabling multiple recipients and dynamic endpoint selection, with improved error handling. ([d45121a](https://github.com/jeremiah-olisa/townkrier/commit/d45121a3857f93170c1566910eb3ab30e70f2583))
+- Add Firebase-backed push notification handling to the Expo example and improve Termii channel error message parsing. ([6959e52](https://github.com/jeremiah-olisa/townkrier/commit/6959e5258109c6812532b3ee1f0aa979583f000e))
+- Implement a new logger system and refactor the Resend email channel with a dedicated mapper and enhanced response handling. ([4517e6e](https://github.com/jeremiah-olisa/townkrier/commit/4517e6e76bd07cf381ad1c1b35ada4b0ab829a9e))
+- Introduce FCM and Termii channels, refactor FCM with mappers, and update playground usage. ([cb5b556](https://github.com/jeremiah-olisa/townkrier/commit/cb5b556ee8d7e70f9c4587eaac24f6f67e3fcad4))
+
+# 1.0.0-alpha.4 (2026-01-28)
+
+### Features
+
+- add bulk SMS support to Termii channel by enabling multiple recipients and dynamic endpoint selection, with improved error handling. ([d45121a](https://github.com/jeremiah-olisa/townkrier/commit/d45121a3857f93170c1566910eb3ab30e70f2583))
+- Add Firebase-backed push notification handling to the Expo example and improve Termii channel error message parsing. ([6959e52](https://github.com/jeremiah-olisa/townkrier/commit/6959e5258109c6812532b3ee1f0aa979583f000e))
+- Implement a new logger system and refactor the Resend email channel with a dedicated mapper and enhanced response handling. ([4517e6e](https://github.com/jeremiah-olisa/townkrier/commit/4517e6e76bd07cf381ad1c1b35ada4b0ab829a9e))
+- Introduce FCM and Termii channels, refactor FCM with mappers, and update playground usage. ([cb5b556](https://github.com/jeremiah-olisa/townkrier/commit/cb5b556ee8d7e70f9c4587eaac24f6f67e3fcad4))
+
+# 1.0.0-alpha.3 (2026-01-28)
+
+### Features
+
+- add bulk SMS support to Termii channel by enabling multiple recipients and dynamic endpoint selection, with improved error handling. ([d45121a](https://github.com/jeremiah-olisa/townkrier/commit/d45121a3857f93170c1566910eb3ab30e70f2583))
+- Add Firebase-backed push notification handling to the Expo example and improve Termii channel error message parsing. ([6959e52](https://github.com/jeremiah-olisa/townkrier/commit/6959e5258109c6812532b3ee1f0aa979583f000e))
+- Implement a new logger system and refactor the Resend email channel with a dedicated mapper and enhanced response handling. ([4517e6e](https://github.com/jeremiah-olisa/townkrier/commit/4517e6e76bd07cf381ad1c1b35ada4b0ab829a9e))
+- Introduce FCM and Termii channels, refactor FCM with mappers, and update playground usage. ([cb5b556](https://github.com/jeremiah-olisa/townkrier/commit/cb5b556ee8d7e70f9c4587eaac24f6f67e3fcad4))
+
+# 1.0.0-alpha.2 (2026-01-28)
+
+### Features
+
+- add bulk SMS support to Termii channel by enabling multiple recipients and dynamic endpoint selection, with improved error handling. ([d45121a](https://github.com/jeremiah-olisa/townkrier/commit/d45121a3857f93170c1566910eb3ab30e70f2583))
+- Add Firebase-backed push notification handling to the Expo example and improve Termii channel error message parsing. ([6959e52](https://github.com/jeremiah-olisa/townkrier/commit/6959e5258109c6812532b3ee1f0aa979583f000e))
+- Implement a new logger system and refactor the Resend email channel with a dedicated mapper and enhanced response handling. ([4517e6e](https://github.com/jeremiah-olisa/townkrier/commit/4517e6e76bd07cf381ad1c1b35ada4b0ab829a9e))
+- Introduce FCM and Termii channels, refactor FCM with mappers, and update playground usage. ([cb5b556](https://github.com/jeremiah-olisa/townkrier/commit/cb5b556ee8d7e70f9c4587eaac24f6f67e3fcad4))

package/README.md

@@ -0,0 +1,296 @@
+# townkrier-termii
+
+Termii SMS adapter for the TownKrier notification system.
+
+## Features
+
+- 📱 SMS notifications via Termii API
+- 🌍 Support for multiple countries and regions
+- 🔄 Automatic retry with exponential backoff
+- 📝 Message templates and personalization
+- 🔍 Delivery status tracking
+- 🛡️ Error handling and validation
+
+## Installation
+
+```bash
+npm install townkrier-termii townkrier-core
+# or
+pnpm add townkrier-termii townkrier-core
+```
+
+## Quick Start
+
+```typescript
+import { NotificationManager, NotificationChannel } from 'townkrier-core';
+import { createTermiiChannel } from 'townkrier-termii';
+
+// Configure the manager with Termii channel
+const manager = new NotificationManager({
+  defaultChannel: 'sms-termii',
+  channels: [
+    {
+      name: 'sms-termii',
+      enabled: true,
+      config: {
+        apiKey: process.env.TERMII_API_KEY,
+        senderId: 'YourApp', // Your registered sender ID
+        channel: 'generic', // or 'dnd', 'whatsapp'
+      },
+    },
+  ],
+});
+
+// Register the Termii channel factory
+manager.registerFactory('sms-termii', createTermiiChannel);
+
+// Create a notification
+class WelcomeSmsNotification extends Notification {
+  constructor(private userName: string) {
+    super();
+  }
+
+  via() {
+    return [NotificationChannel.SMS];
+  }
+
+  toSms() {
+    return {
+      to: '+1234567890',
+      message: `Welcome ${this.userName}! Thank you for joining our service.`,
+    };
+  }
+}
+
+// Send the notification
+const notification = new WelcomeSmsNotification('John');
+const recipient = {
+  [NotificationChannel.SMS]: {
+    phone: '+1234567890',
+  },
+};
+
+await manager.send(notification, recipient);
+```
+
+## Configuration
+
+### TermiiConfig
+
+```typescript
+interface TermiiConfig {
+  apiKey: string; // Required: Your Termii API key
+  senderId: string; // Required: Your registered sender ID (max 11 chars)
+  channel?: string; // Optional: Message channel (default: 'generic')
+  timeout?: number; // Optional: Request timeout in ms (default: 30000)
+  debug?: boolean; // Optional: Enable debug logging (default: false)
+}
+```
+
+### Channel Types
+
+Termii supports different message channels:
+
+- `generic` - Standard SMS (default, most reliable)
+- `dnd` - For numbers on DND (Do Not Disturb)
+- `whatsapp` - For WhatsApp Business messages
+
+```typescript
+{
+  channel: 'generic', // Change based on your needs
+}
+```
+
+## Advanced Usage
+
+### With Personalization
+
+```typescript
+class OrderConfirmationNotification extends Notification {
+  constructor(
+    private orderNumber: string,
+    private totalAmount: string,
+    private estimatedDelivery: string,
+  ) {
+    super();
+  }
+
+  via() {
+    return [NotificationChannel.SMS];
+  }
+
+  toSms() {
+    return {
+      to: '+1234567890',
+      message: `Order #${this.orderNumber} confirmed! Total: ${this.totalAmount}. Estimated delivery: ${this.estimatedDelivery}`,
+    };
+  }
+}
+```
+
+### Multi-Channel with Fallback
+
+```typescript
+class CriticalAlertNotification extends Notification {
+  via() {
+    // Try SMS first, fallback to email if SMS fails
+    return [NotificationChannel.SMS, NotificationChannel.EMAIL];
+  }
+
+  toSms() {
+    return {
+      to: '+1234567890',
+      message: 'Critical Alert: Your account requires immediate attention.',
+    };
+  }
+
+  toEmail() {
+    return {
+      subject: 'Critical Alert',
+      html: '<h1>Critical Alert</h1><p>Your account requires immediate attention.</p>',
+    };
+  }
+}
+```
+
+### International Numbers
+
+```typescript
+// Always use E.164 format for international numbers
+{
+  to: '+44712345678',  // UK
+  to: '+12125551234',  // USA
+  to: '+234812345678', // Nigeria
+  message: 'Your message here',
+}
+```
+
+## Getting Your API Key
+
+1. Sign up at [termii.com](https://termii.com)
+2. Navigate to your Dashboard
+3. Go to API Settings
+4. Copy your API Key
+5. Register a Sender ID (this may require verification)
+
+### Sender ID Requirements
+
+- Maximum 11 characters
+- Alphanumeric only
+- Must be approved by Termii
+- Some countries require pre-registration
+
+## Error Handling
+
+The adapter includes comprehensive error handling:
+
+```typescript
+import { NotificationFailed } from 'townkrier-core';
+
+// Listen for failures
+eventDispatcher.on(NotificationFailed, async (event) => {
+  console.error('SMS failed:', event.error.message);
+  console.error('Failed channel:', event.failedChannel);
+
+  // Implement custom retry logic or alerts
+  if (event.error.message.includes('Invalid number')) {
+    // Handle invalid phone numbers
+  }
+});
+```
+
+## Message Length
+
+- Standard SMS: 160 characters
+- Unicode messages (emojis, etc.): 70 characters
+- Messages longer than these limits are split into multiple parts
+
+## Testing
+
+### Development Mode
+
+```typescript
+{
+  apiKey: process.env.TERMII_API_KEY,
+  senderId: 'Test',
+  debug: true, // Enable detailed logging
+}
+```
+
+### Test Numbers
+
+Termii provides test numbers for development. Check their documentation for current test numbers.
+
+## Pricing
+
+Termii charges per SMS sent. Pricing varies by:
+
+- Destination country
+- Message type (SMS vs WhatsApp)
+- Volume discounts
+
+Check [Termii Pricing](https://termii.com/pricing) for current rates.
+
+## Best Practices
+
+1. **Validate Phone Numbers**: Always validate numbers before sending
+2. **Keep Messages Concise**: Stay under 160 characters when possible
+3. **Use Sender ID Wisely**: Choose a recognizable sender ID
+4. **Handle Errors**: Implement proper error handling and logging
+5. **Respect Regulations**: Follow SMS marketing regulations (TCPA, etc.)
+6. **Rate Limiting**: Be mindful of rate limits
+7. **Store Preferences**: Track user SMS preferences and opt-outs
+
+## Troubleshooting
+
+### "Invalid API Key"
+
+- Verify your API key is correct
+- Check if the key has necessary permissions
+- Ensure the key hasn't expired
+
+### "Invalid Sender ID"
+
+- Verify sender ID is registered with Termii
+- Check sender ID is maximum 11 characters
+- Ensure sender ID is approved for your account
+
+### "Insufficient Balance"
+
+- Check your Termii account balance
+- Add credits to your account
+
+### "Invalid Phone Number"
+
+- Use E.164 format (+countrycode + number)
+- Remove spaces, dashes, or special characters
+- Verify the number is valid for the destination country
+
+## Related Packages
+
+- [townkrier-core](../../core) - Core notification system
+- [townkrier-resend](../../resend) - Email provider
+- [townkrier-fcm](../push/fcm) - Push notifications provider
+- [townkrier-queue](../../queue) - Queue system for background processing
+- [townkrier-dashboard](../../dashboard) - Monitoring dashboard
+
+## Examples
+
+See the [examples directory](../../../../examples) for complete working examples:
+
+- [Complete Example](../../../../examples/complete-example.ts) - Full multi-channel setup
+- [SMS Specific Examples](../../../../examples/notifications) - SMS notification examples
+
+## License
+
+MIT
+
+## Support
+
+- [Termii Documentation](https://developers.termii.com)
+- [TownKrier Documentation](../../../../README.md)
+- [Report Issues](https://github.com/jeremiah-olisa/townkrier/issues)
+
+## Author
+
+Jeremiah Olisa

package/__tests__/termii.channel.spec.ts

@@ -0,0 +1,64 @@
+import { TermiiChannel, createTermiiChannel } from '../src/core';
+import { TermiiConfig } from '../src/types';
+import axios from 'axios';
+
+// Mock axios
+jest.mock('axios');
+const mockedAxios = axios as jest.Mocked<typeof axios>;
+
+describe('TermiiChannel', () => {
+  const config: TermiiConfig = {
+    apiKey: 'test-api-key',
+    from: 'TestSender',
+  };
+
+  let channel: TermiiChannel;
+
+  beforeEach(() => {
+    jest.clearAllMocks();
+    // Mock axios.create to return the mocked axios instance so we can spy on post
+    (mockedAxios.create as jest.Mock).mockReturnValue(mockedAxios);
+    channel = new TermiiChannel(config);
+  });
+
+  it('should be defined', () => {
+    expect(channel).toBeDefined();
+  });
+
+  it('should send sms successfully', async () => {
+    mockedAxios.post.mockResolvedValue({
+      data: {
+        message_id: '12345',
+        message: 'Successfully Sent',
+        balance: 10,
+        user: 'test-user',
+      },
+    });
+
+    const result = await channel.sendSms({
+      to: { phone: '2348012345678' },
+      message: 'Hello World',
+      text: 'Hello World',
+    });
+
+    expect(mockedAxios.post).toHaveBeenCalledWith(
+      '/api/sms/send', // Method uses relative path on client
+      expect.objectContaining({
+        api_key: 'test-api-key',
+        to: '2348012345678',
+        from: 'TestSender',
+        sms: 'Hello World',
+        type: 'plain',
+        channel: 'generic',
+      }),
+    );
+
+    expect(result.status).toBe('sent');
+    expect(result.messageId).toBe('12345');
+  });
+
+  it('should create channel using factory', () => {
+    const channelFromFactory = createTermiiChannel(config);
+    expect(channelFromFactory).toBeInstanceOf(TermiiChannel);
+  });
+});

package/dist/core/index.d.ts

@@ -0,0 +1,2 @@
+export * from './termii-channel';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./termii-channel"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC"}

package/dist/core/termii-channel.d.ts

@@ -0,0 +1,13 @@
+import { SmsChannel, SendSmsRequest, SendSmsResponse } from 'townkrier-core';
+import { TermiiConfig } from '../types';
+export declare class TermiiChannel extends SmsChannel {
+    private readonly client;
+    private readonly termiiConfig;
+    private readonly baseUrl;
+    constructor(config: TermiiConfig);
+    sendSms(request: SendSmsRequest): Promise<SendSmsResponse>;
+    protected isValidNotificationRequest(request: any): request is SendSmsRequest;
+    private handleError;
+}
+export declare function createTermiiChannel(config: TermiiConfig): TermiiChannel;
+//# sourceMappingURL=termii-channel.d.ts.map

package/dist/core/termii-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"termii-channel.d.ts","sourceRoot":"","sources":["../../src/core/termii-channel.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,cAAc,EACd,eAAe,EAGhB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAQxC,qBAAa,aAAc,SAAQ,UAAU;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,YAAY;IAoD1B,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAoDhE,SAAS,CAAC,0BAA0B,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,IAAI,cAAc;IAU7E,OAAO,CAAC,WAAW;CAGpB;AAKD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAEvE"}

package/dist/core/termii-channel.js

@@ -0,0 +1,94 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TermiiChannel = void 0;
+exports.createTermiiChannel = createTermiiChannel;
+const townkrier_core_1 = require("townkrier-core");
+const termii_mapper_1 = require("./termii.mapper");
+const axios_1 = __importDefault(require("axios"));
+class TermiiChannel extends townkrier_core_1.SmsChannel {
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new townkrier_core_1.NotificationConfigurationException('API key is required for Termii', {
+                channel: 'Termii',
+            });
+        }
+        super(config, 'Termii');
+        this.termiiConfig = config;
+        this.baseUrl = config.baseUrl || 'https://api.ng.termii.com';
+        this.client = axios_1.default.create({
+            baseURL: this.baseUrl,
+            timeout: config.timeout || 30000,
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+        if (config.debug) {
+            this.client.interceptors.request.use((request) => {
+                townkrier_core_1.Logger.debug('[Termii Request]', {
+                    url: request.url,
+                    method: request.method,
+                    data: request.data,
+                });
+                return request;
+            });
+            this.client.interceptors.response.use((response) => {
+                townkrier_core_1.Logger.debug('[Termii Response]', {
+                    status: response.status,
+                    data: response.data,
+                });
+                return response;
+            }, (error) => {
+                townkrier_core_1.Logger.error('[Termii Error]', {
+                    message: error.message,
+                    response: error.response?.data,
+                });
+                return Promise.reject(error);
+            });
+        }
+    }
+    async sendSms(request) {
+        try {
+            const recipients = Array.isArray(request.to) ? request.to : [request.to];
+            if (recipients.length === 0) {
+                throw new townkrier_core_1.NotificationConfigurationException('No recipients provided', {
+                    recipients,
+                });
+            }
+            const data = termii_mapper_1.TermiiMapper.toTermiiData(request, this.termiiConfig);
+            const endpoint = Array.isArray(data.to) ? '/api/sms/send/bulk' : '/api/sms/send';
+            const response = await this.client.post(endpoint, data);
+            if (!response.data || !response.data.message_id) {
+                if (response.data && response.data.message && !response.data.message_id) {
+                    throw new Error(response.data.message);
+                }
+            }
+            return termii_mapper_1.TermiiMapper.toSuccessResponse(response.data, request);
+        }
+        catch (error) {
+            let finalError = error;
+            if (axios_1.default.isAxiosError(error) && error.response) {
+                const errorData = error.response.data;
+                let message = errorData?.message || errorData?.error || error.message;
+                if (typeof message === 'object') {
+                    message = JSON.stringify(message);
+                }
+                finalError = new Error(message);
+            }
+            return termii_mapper_1.TermiiMapper.toErrorResponse(finalError, 'Failed to send SMS');
+        }
+    }
+    isValidNotificationRequest(request) {
+        return request && request.message && (request.to || Array.isArray(request.to));
+    }
+    handleError(error, defaultMessage) {
+        return termii_mapper_1.TermiiMapper.toErrorResponse(error, defaultMessage);
+    }
+}
+exports.TermiiChannel = TermiiChannel;
+function createTermiiChannel(config) {
+    return new TermiiChannel(config);
+}
+//# sourceMappingURL=termii-channel.js.map

package/dist/core/termii-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"termii-channel.js","sourceRoot":"","sources":["../../src/core/termii-channel.ts"],"names":[],"mappings":"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"}

package/dist/core/termii-channel.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=termii-channel.spec.d.ts.map

package/dist/core/termii-channel.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"termii-channel.spec.d.ts","sourceRoot":"","sources":["../../src/core/termii-channel.spec.ts"],"names":[],"mappings":""}

package/dist/core/termii-channel.spec.js

@@ -0,0 +1,65 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const termii_channel_1 = require("./termii-channel");
+const axios_1 = __importDefault(require("axios"));
+jest.mock('axios');
+const mockedAxios = axios_1.default;
+describe('TermiiChannel', () => {
+    let channel;
+    const config = {
+        apiKey: 'test-api-key',
+        from: 'Townkrier',
+    };
+    beforeEach(() => {
+        jest.clearAllMocks();
+        mockedAxios.create.mockReturnThis();
+        mockedAxios.post.mockResolvedValue({
+            data: { message_id: '12345', message: 'Successfully Sent' },
+        });
+        channel = new termii_channel_1.TermiiChannel(config);
+    });
+    it('should send single SMS via standard endpoint', async () => {
+        const request = {
+            to: { phone: '2341234567890' },
+            message: 'Hello World',
+            text: 'Hello World',
+        };
+        await channel.sendSms(request);
+        expect(mockedAxios.post).toHaveBeenCalledWith('/api/sms/send', expect.objectContaining({
+            to: '2341234567890',
+        }));
+    });
+    it('should send bulk SMS via bulk endpoint', async () => {
+        const request = {
+            to: [{ phone: '2341234567890' }, { phone: '2341234567891' }],
+            message: 'Hello World Bulk',
+            text: 'Hello World Bulk',
+        };
+        await channel.sendSms(request);
+        expect(mockedAxios.post).toHaveBeenCalledWith('/api/sms/send/bulk', expect.objectContaining({
+            to: ['2341234567890', '2341234567891'],
+        }));
+    });
+    it('should throw error if API returns error message with 200 OK', async () => {
+        mockedAxios.post.mockResolvedValue({
+            data: {
+                message: 'Invalid API Key',
+            },
+        });
+        const request = {
+            to: { phone: '2341234567890' },
+            message: 'Hello World',
+            text: 'Hello World',
+        };
+        await expect(channel.sendSms(request)).resolves.toEqual(expect.objectContaining({
+            status: 'failed',
+            error: expect.objectContaining({
+                message: 'Invalid API Key',
+            }),
+        }));
+    });
+});
+//# sourceMappingURL=termii-channel.spec.js.map

package/dist/core/termii-channel.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"termii-channel.spec.js","sourceRoot":"","sources":["../../src/core/termii-channel.spec.ts"],"names":[],"mappings":";;;;;AAAA,qDAAiD;AACjD,kDAA0B;AAG1B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACnB,MAAM,WAAW,GAAG,eAAkC,CAAC;AAEvD,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,IAAI,OAAsB,CAAC;IAC3B,MAAM,MAAM,GAAG;QACb,MAAM,EAAE,cAAc;QACtB,IAAI,EAAE,WAAW;KAClB,CAAC;IAEF,UAAU,CAAC,GAAG,EAAE;QACd,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,WAAW,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QACpC,WAAW,CAAC,IAAI,CAAC,iBAAiB,CAAC;YACjC,IAAI,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE;SAC5D,CAAC,CAAC;QACH,OAAO,GAAG,IAAI,8BAAa,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,OAAO,GAAmB;YAC9B,EAAE,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;YAC9B,OAAO,EAAE,aAAa;YACtB,IAAI,EAAE,aAAa;SACpB,CAAC;QAEF,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE/B,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,oBAAoB,CAC3C,eAAe,EACf,MAAM,CAAC,gBAAgB,CAAC;YACtB,EAAE,EAAE,eAAe;SACpB,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,OAAO,GAAmB;YAC9B,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;YAC5D,OAAO,EAAE,kBAAkB;YAC3B,IAAI,EAAE,kBAAkB;SACzB,CAAC;QAEF,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE/B,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,oBAAoB,CAC3C,oBAAoB,EACpB,MAAM,CAAC,gBAAgB,CAAC;YACtB,EAAE,EAAE,CAAC,eAAe,EAAE,eAAe,CAAC;SACvC,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,WAAW,CAAC,IAAI,CAAC,iBAAiB,CAAC;YACjC,IAAI,EAAE;gBACJ,OAAO,EAAE,iBAAiB;aAC3B;SACF,CAAC,CAAC;QAEH,MAAM,OAAO,GAAmB;YAC9B,EAAE,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;YAC9B,OAAO,EAAE,aAAa;YACtB,IAAI,EAAE,aAAa;SACpB,CAAC;QAEF,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CACrD,MAAM,CAAC,gBAAgB,CAAC;YACtB,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,MAAM,CAAC,gBAAgB,CAAC;gBAC7B,OAAO,EAAE,iBAAiB;aAC3B,CAAC;SACH,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/termii.mapper.d.ts

@@ -0,0 +1,9 @@
+import { SendSmsRequest, SendSmsResponse } from 'townkrier-core';
+import { TermiiSmsData, TermiiApiResponse } from '../interfaces';
+import { TermiiConfig } from '../types';
+export declare class TermiiMapper {
+    static toTermiiData(request: SendSmsRequest, config: TermiiConfig): TermiiSmsData;
+    static toSuccessResponse(data: TermiiApiResponse, request: SendSmsRequest): SendSmsResponse;
+    static toErrorResponse(error: unknown, defaultMessage: string): SendSmsResponse;
+}
+//# sourceMappingURL=termii.mapper.d.ts.map

package/dist/core/termii.mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"termii.mapper.d.ts","sourceRoot":"","sources":["../../src/core/termii.mapper.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,eAAe,EAIhB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,qBAAa,YAAY;IACvB,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,GAAG,aAAa;IA0BjF,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,cAAc,GAAG,eAAe;IAgB3F,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,eAAe;CAuBhF"}