unismsgateway 1.5.1 → 1.5.2

package/README.md

@@ -463,6 +463,9 @@ Full variable reference (selection, per-gateway credentials, live send): [Live i
 
 ## Changelog
 
+### 1.5.2
+- **Build:** TypeScript `rootDir` is now `./src` with `include: ["src/**/*.ts"]` (scripts stay `ts-node`-only). Previously the compiler also picked up `scripts/test-live.ts`, inferred a project root above `src/`, and emitted library code under `dist/src/lib/…` while published entrypoints load `dist/lib/…` — leaving **stale or missing** `dist/lib/nest-gateway.js` (wrong `requestBody` shape). The published `dist/` layout now matches `package.json` `main` and always rebuilds gateway files from current sources.
+
 ### 1.5.1
 - **Fix (`nest` / all gateways):** `quickSend` now accepts **camelCase** (`from`, `to`, `content`, `type`) as well as PascalCase (`From`, `To`, `Content`, `Type`). Passing only camelCase previously left `Content` undefined, so the nest JSON body omitted `text` and the API returned handshake **1305** (missing or invalid message body). Validation errors throw clear messages when body or sender is empty after trim.
 

package/dist/lib/lib.d.ts

@@ -1,5 +1,5 @@
-import { smsPlatform, IgatewaySettings, IgatewayParam, PlatformId, QuickSendParams, SendResult, ISmsGateway } from './platform';
+import { smsPlatform, IgatewaySettings, IgatewayParam, PlatformId, QuickSendParams, QuickSendParamsInput, QuickSendParamsCamel, normalizeQuickSendParams, SendResult, ISmsGateway } from './platform';
 export declare function init(settings: IgatewaySettings): smsPlatform;
 export declare function getSmsPlatform(): smsPlatform | null;
 export declare function reset(): void;
-export { smsPlatform, IgatewaySettings, IgatewayParam, PlatformId, QuickSendParams, SendResult, ISmsGateway };
+export { smsPlatform, IgatewaySettings, IgatewayParam, PlatformId, QuickSendParams, QuickSendParamsInput, QuickSendParamsCamel, normalizeQuickSendParams, SendResult, ISmsGateway };

package/dist/lib/lib.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.smsPlatform = exports.reset = exports.getSmsPlatform = exports.init = void 0;
+exports.normalizeQuickSendParams = exports.smsPlatform = exports.reset = exports.getSmsPlatform = exports.init = void 0;
 const platform_1 = require("./platform");
 Object.defineProperty(exports, "smsPlatform", { enumerable: true, get: function () { return platform_1.smsPlatform; } });
+Object.defineProperty(exports, "normalizeQuickSendParams", { enumerable: true, get: function () { return platform_1.normalizeQuickSendParams; } });
 let smsPlatformInstance = null;
 function init(settings) {
     smsPlatformInstance = new platform_1.smsPlatform(settings);

package/dist/lib/nest-gateway.d.ts

@@ -3,6 +3,7 @@ export declare class NestSmsGateway implements ISmsGateway {
     private config;
     constructor(config: NestSmsConfig);
     init(): ISmsGateway;
+    private log;
     private makeRequest;
     quickSend(params: QuickSendParams, callback?: Function): Promise<SendResult>;
     getBalance(): Promise<{

package/dist/lib/nest-gateway.js

@@ -38,106 +38,159 @@ class NestSmsGateway {
         this.config = {
             host: config.host || DEFAULT_HOST,
             protocol: config.protocol || DEFAULT_PROTOCOL,
-            apiKey: config.apiKey
+            apiKey: config.apiKey,
+            debug: config.debug || false
         };
     }
     init() {
         return this;
     }
+    log(...args) {
+        if (this.config.debug) {
+            console.log('[unismsgateway:nest]', ...args);
+        }
+    }
     makeRequest(endpoint, data) {
         return __awaiter(this, void 0, void 0, function* () {
             return new Promise((resolve, reject) => {
-                var _a;
                 const postData = data ? JSON.stringify(data) : '';
                 const protocol = this.config.protocol || DEFAULT_PROTOCOL;
                 const httpModule = protocol === 'https' ? https : http;
                 const defaultPort = protocol === 'https' ? 443 : 80;
+                const host = this.config.host || DEFAULT_HOST;
+                const hostname = host.includes(':') ? host.split(':')[0] : host;
+                const port = host.includes(':')
+                    ? parseInt(host.split(':')[1], 10)
+                    : defaultPort;
                 const options = {
-                    hostname: this.config.host || DEFAULT_HOST,
-                    port: ((_a = this.config.host) === null || _a === void 0 ? void 0 : _a.includes(':'))
-                        ? parseInt(this.config.host.split(':')[1])
-                        : defaultPort,
+                    hostname,
+                    port,
                     path: `/v5/${endpoint}`,
                     method: 'POST',
+                    // Disable keep-alive connection pooling. Node's global agent reuses
+                    // sockets across calls; when the server closes an idle socket server-side
+                    // the next write (i.e. the request body in quickSend) gets ECONNABORTED.
+                    // agent:false forces a fresh connection for every request.
+                    agent: false,
                     headers: {
-                        'Host': this.config.host || DEFAULT_HOST,
+                        'Host': hostname,
                         'Content-Type': 'application/json',
                         'Accept': 'application/json',
                         'Authorization': `key ${this.config.apiKey}`,
                         'Content-Length': Buffer.byteLength(postData)
                     }
                 };
+                this.log(`POST /v5/${endpoint}`, data ? JSON.stringify(data) : '(no body)');
                 const req = httpModule.request(options, (res) => {
                     let responseBody = '';
                     res.on('data', (chunk) => {
                         responseBody += chunk;
                     });
                     res.on('end', () => {
+                        var _a;
+                        const statusCode = (_a = res.statusCode) !== null && _a !== void 0 ? _a : 0;
+                        this.log(`HTTP ${statusCode} response:`, responseBody);
                         try {
-                            if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
-                                const parsed = JSON.parse(responseBody);
-                                resolve(parsed);
+                            const parsed = JSON.parse(responseBody);
+                            if (statusCode >= 200 && statusCode < 300) {
+                                resolve({ statusCode, body: parsed });
                             }
                             else {
-                                reject(new Error(`HTTP ${res.statusCode}: ${responseBody}`));
+                                const err = new Error(`HTTP ${statusCode}: ${responseBody}`);
+                                err.statusCode = statusCode;
+                                err.rawBody = responseBody;
+                                reject(err);
                             }
                         }
-                        catch (error) {
-                            reject(new Error(`Failed to parse response: ${responseBody}`));
+                        catch (_b) {
+                            const err = new Error(`Failed to parse gateway response (HTTP ${statusCode}): ${responseBody}`);
+                            err.statusCode = statusCode;
+                            err.rawBody = responseBody;
+                            reject(err);
                         }
                     });
                 });
                 req.on('error', (error) => {
+                    this.log('Network error:', error.message);
                     reject(error);
                 });
-                req.write(postData);
+                if (postData) {
+                    req.write(postData);
+                }
                 req.end();
             });
         });
     }
     quickSend(params, callback) {
-        var _a, _b;
+        var _a, _b, _c, _d, _e;
         return __awaiter(this, void 0, void 0, function* () {
-            const endpoint = 'message/sms/send';
             const requestBody = {
-                from: params.From,
-                to: String(params.To),
-                content: params.Content,
-                type: params.Type || 0
+                text: params.Content,
+                type: (_a = params.Type) !== null && _a !== void 0 ? _a : 0,
+                sender: params.From,
+                destinations: [String(params.To)]
             };
+            this.log('quickSend params:', JSON.stringify(params));
+            let result;
             try {
-                const response = yield this.makeRequest(endpoint, requestBody);
-                const result = {
-                    success: ((_a = response.handshake) === null || _a === void 0 ? void 0 : _a.id) === 0,
-                    data: response.data,
-                    messageId: (_b = response.data) === null || _b === void 0 ? void 0 : _b.messageId
-                };
-                if (callback) {
-                    callback(result);
+                const { statusCode, body: response } = yield this.makeRequest('message/sms/send', requestBody);
+                const handshakeId = (_b = response.handshake) === null || _b === void 0 ? void 0 : _b.id;
+                const handshakeLabel = (_c = response.handshake) === null || _c === void 0 ? void 0 : _c.label;
+                const handshakeOk = Number(handshakeId) === 0;
+                const responseData = (_d = response.data) !== null && _d !== void 0 ? _d : null;
+                const batchId = responseData && typeof responseData === 'object'
+                    ? responseData.batch
+                    : undefined;
+                const firstDest = responseData && typeof responseData === 'object'
+                    ? (_e = responseData.destinations) === null || _e === void 0 ? void 0 : _e[0]
+                    : undefined;
+                let errorMsg;
+                if (!handshakeOk) {
+                    if (handshakeLabel) {
+                        errorMsg = `API Error [code ${handshakeId}]: ${handshakeLabel}`;
+                    }
+                    else if (handshakeId !== undefined && handshakeId !== null) {
+                        errorMsg = `API Error: handshake code=${handshakeId}`;
+                    }
+                    else {
+                        errorMsg = `Unexpected API response: ${JSON.stringify(response)}`;
+                    }
                 }
-                return result;
+                result = {
+                    success: handshakeOk,
+                    messageId: batchId || (firstDest === null || firstDest === void 0 ? void 0 : firstDest.id),
+                    // On failure, expose the full raw response so callers can inspect it.
+                    data: handshakeOk ? responseData : response,
+                    error: errorMsg,
+                    statusCode
+                };
             }
             catch (error) {
+                const httpErr = error;
                 const errorMessage = error instanceof Error ? error.message : String(error);
-                const result = {
+                result = {
                     success: false,
-                    error: errorMessage
+                    error: errorMessage,
+                    statusCode: httpErr.statusCode,
+                    // Preserve whatever raw body we got for inspection.
+                    data: httpErr.rawBody !== undefined ? httpErr.rawBody : null
                 };
-                if (callback) {
-                    callback(result);
-                }
-                return result;
             }
+            this.log('quickSend result:', JSON.stringify(result));
+            if (callback) {
+                callback(result);
+            }
+            return result;
         });
     }
     getBalance() {
-        var _a, _b;
+        var _a, _b, _c, _d;
         return __awaiter(this, void 0, void 0, function* () {
-            const endpoint = 'account/balance';
-            const response = yield this.makeRequest(endpoint);
+            this.log('getBalance called');
+            const { body: response } = yield this.makeRequest('account/balance');
             return {
-                balance: ((_a = response.data) === null || _a === void 0 ? void 0 : _a.balance) || 0,
-                model: ((_b = response.data) === null || _b === void 0 ? void 0 : _b.model) || 'quantity'
+                balance: (_b = (_a = response.data) === null || _a === void 0 ? void 0 : _a.balance) !== null && _b !== void 0 ? _b : 0,
+                model: (_d = (_c = response.data) === null || _c === void 0 ? void 0 : _c.model) !== null && _d !== void 0 ? _d : 'quantity'
             };
         });
     }

package/dist/lib/platform.d.ts

@@ -1,4 +1,4 @@
-import { IgatewaySettings, IgatewayParam, ISmsGateway, QuickSendParams, SendResult } from './types';
+import { IgatewaySettings, IgatewayParam, ISmsGateway, ISmsGatewayDelegate, QuickSendParamsInput, SendResult } from './types';
 export * from './types';
 export declare class smsPlatform implements ISmsGateway {
     private _settings;
@@ -7,7 +7,7 @@ export declare class smsPlatform implements ISmsGateway {
     private validateSettings;
     private createGateway;
     init(): ISmsGateway;
-    quickSend(param: QuickSendParams, callback?: Function): Promise<SendResult>;
-    getGateway(): ISmsGateway;
+    quickSend(param: QuickSendParamsInput, callback?: Function): Promise<SendResult>;
+    getGateway(): ISmsGatewayDelegate;
 }
 export { IgatewaySettings, IgatewayParam };

package/dist/lib/platform.js

@@ -11,9 +11,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.smsPlatform = void 0;
-const hubtel_sms_extended_1 = require("hubtel-sms-extended");
-const routemobilesms_1 = require("routemobilesms");
 const nest_gateway_1 = require("./nest-gateway");
+const hubtel_gateway_1 = require("./hubtel-gateway");
+const route_gateway_1 = require("./route-gateway");
+const types_1 = require("./types");
 __exportStar(require("./types"), exports);
 const GATEWAY_CONFIGS = {
     route: { requiresUsernamePassword: true },
@@ -47,23 +48,26 @@ class smsPlatform {
         const { platformId, param } = this._settings;
         switch (platformId) {
             case 'route':
-                return new routemobilesms_1.routeSms({
+                return new route_gateway_1.RouteSmsGateway({
                     host: param.host || 'rslr.connectbind.com',
                     username: param.username,
                     password: param.password,
                     protocol: param.protocol || 'http',
-                    port: param.port || 8080
+                    port: param.port || 8080,
+                    debug: param.debug
                 });
             case 'hubtel':
-                return new hubtel_sms_extended_1.HubtelSms({
+                return new hubtel_gateway_1.HubtelSmsGateway({
                     clientId: param.clientId,
-                    clientSecret: param.clientSecret
+                    clientSecret: param.clientSecret,
+                    debug: param.debug
                 });
             case 'nest':
                 return new nest_gateway_1.NestSmsGateway({
                     apiKey: param.apiKey,
                     host: param.host,
-                    protocol: param.protocol
+                    protocol: param.protocol,
+                    debug: param.debug
                 });
             default:
                 throw new Error(`Unsupported platform: ${platformId}`);
@@ -76,7 +80,8 @@ class smsPlatform {
         if (!this._gateway) {
             throw new Error('Gateway not initialized. Call init() first.');
         }
-        return this._gateway.quickSend(param, callback);
+        const normalized = (0, types_1.normalizeQuickSendParams)(param);
+        return this._gateway.quickSend(normalized, callback);
     }
     getGateway() {
         return this._gateway;

package/dist/lib/types.js

@@ -1,2 +1,42 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeQuickSendParams = void 0;
+/**
+ * Maps PascalCase or camelCase quick-send fields to {@link QuickSendParams}.
+ * PascalCase wins when both are present.
+ */
+function normalizeQuickSendParams(params) {
+    var _a, _b, _c, _d;
+    const p = params;
+    const from = (_a = p.From) !== null && _a !== void 0 ? _a : p.from;
+    const to = (_b = p.To) !== null && _b !== void 0 ? _b : p.to;
+    const content = (_c = p.Content) !== null && _c !== void 0 ? _c : p.content;
+    const type = (_d = p.Type) !== null && _d !== void 0 ? _d : p.type;
+    const contentStr = content == null ? '' : String(content);
+    const trimmedBody = contentStr.trim();
+    if (trimmedBody === '') {
+        throw new Error('quickSend: message body is missing. Pass Content or content with a non-empty string.');
+    }
+    const fromStr = from == null ? '' : String(from).trim();
+    if (fromStr === '') {
+        throw new Error('quickSend: sender is missing. Pass From or from with a non-empty string.');
+    }
+    if (to === null || to === undefined) {
+        throw new Error('quickSend: recipient is missing. Pass To or to.');
+    }
+    const toVal = typeof to === 'number' ? to : String(to).trim();
+    let typeNum;
+    if (type !== undefined && type !== null) {
+        const n = Number(type);
+        if (!Number.isNaN(n)) {
+            typeNum = n;
+        }
+    }
+    return {
+        From: fromStr,
+        To: toVal,
+        Content: trimmedBody,
+        Type: typeNum
+    };
+}
+exports.normalizeQuickSendParams = normalizeQuickSendParams;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unismsgateway",
-  "version": "1.5.1",
+  "version": "1.5.2",
   "description": "A unified SMS gateway library that brings access to multiple SMS gateways under a single API",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/dist/lib/j;[ ]p;;;j]/ts

@@ -1,44 +0,0 @@
-export declare type PlatformId = 'route' | 'hubtel' | 'nest';
-export interface QuickSendParams {
-    From: string;
-    To: string | number;
-    Content: string;
-    Type?: number;
-}
-export interface SendResult {
-    success: boolean;
-    messageId?: string;
-    data?: any;
-    error?: string;
-}
-export interface IgatewayParam {
-    host?: string;
-    port?: number;
-    username?: string;
-    password?: string;
-    clientId?: string;
-    clientSecret?: string;
-    apiKey?: string;
-    protocol?: 'http' | 'https';
-}
-export interface IgatewaySettings {
-    platformId: PlatformId;
-    param: IgatewayParam;
-}
-export interface ISmsGateway {
-    init(): ISmsGateway;
-    quickSend(params: QuickSendParams, callback?: Function): Promise<SendResult>;
-    getBalance?(): Promise<any>;
-}
-export interface NestSmsConfig {
-    apiKey: string;
-    host?: string;
-    protocol?: 'http' | 'https';
-}
-export interface NestSendResponse {
-    handshake: {
-        id: number;
-        label: string;
-    };
-    data?: any;
-}

package/dist/scripts/test-live.d.ts

@@ -1,11 +0,0 @@
-/**
- * Live integration test script for unismsgateway.
- *
- * Usage:
- *   1. Copy .env.example to .env and fill in your credentials.
- *   2. npm run test:live
- *
- * Set TEST_SEND=true in .env (or inline) to actually send an SMS.
- * Without it, only init and balance checks run.
- */
-export {};

package/dist/scripts/test-live.js

@@ -1,191 +0,0 @@
-"use strict";
-/**
- * Live integration test script for unismsgateway.
- *
- * Usage:
- *   1. Copy .env.example to .env and fill in your credentials.
- *   2. npm run test:live
- *
- * Set TEST_SEND=true in .env (or inline) to actually send an SMS.
- * Without it, only init and balance checks run.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const dotenv = __importStar(require("dotenv"));
-dotenv.config();
-const lib_1 = require("../src/lib/lib");
-// ─── Colour helpers ──────────────────────────────────────────────────────────
-const GREEN = '\x1b[32m';
-const RED = '\x1b[31m';
-const YELLOW = '\x1b[33m';
-const CYAN = '\x1b[36m';
-const BOLD = '\x1b[1m';
-const RESET = '\x1b[0m';
-const pass = (msg) => console.log(`  ${GREEN}✔${RESET}  ${msg}`);
-const fail = (msg) => console.log(`  ${RED}✖${RESET}  ${msg}`);
-const info = (msg) => console.log(`  ${CYAN}ℹ${RESET}  ${msg}`);
-const warn = (msg) => console.log(`  ${YELLOW}⚠${RESET}  ${msg}`);
-const title = (msg) => console.log(`\n${BOLD}${msg}${RESET}`);
-// ─── Env helpers ─────────────────────────────────────────────────────────────
-function env(key) {
-    return process.env[key] || undefined;
-}
-function requireEnv(key) {
-    const val = process.env[key];
-    if (!val)
-        throw new Error(`Missing required env var: ${key}`);
-    return val;
-}
-// ─── Test counters ───────────────────────────────────────────────────────────
-let passed = 0;
-let failed = 0;
-function runTest(label, fn) {
-    return __awaiter(this, void 0, void 0, function* () {
-        try {
-            yield fn();
-            passed++;
-        }
-        catch (err) {
-            failed++;
-            fail(`${label}: ${err instanceof Error ? err.message : String(err)}`);
-        }
-    });
-}
-// ─── Per-platform tests ───────────────────────────────────────────────────────
-function testPlatform(platformId) {
-    return __awaiter(this, void 0, void 0, function* () {
-        title(`Platform: ${platformId.toUpperCase()}`);
-        let platform;
-        // 1. Initialisation
-        yield runTest('Init / config validation', () => __awaiter(this, void 0, void 0, function* () {
-            const param = {};
-            switch (platformId) {
-                case 'nest':
-                    param.apiKey = requireEnv('NEST_API_KEY');
-                    if (env('NEST_HOST'))
-                        param.host = env('NEST_HOST');
-                    if (env('NEST_PROTOCOL')) {
-                        param.protocol = env('NEST_PROTOCOL');
-                    }
-                    param.debug = true;
-                    break;
-                case 'hubtel':
-                    param.clientId = requireEnv('HUBTEL_CLIENT_ID');
-                    param.clientSecret = requireEnv('HUBTEL_CLIENT_SECRET');
-                    break;
-                case 'route':
-                    param.username = requireEnv('ROUTE_USERNAME');
-                    param.password = requireEnv('ROUTE_PASSWORD');
-                    if (env('ROUTE_HOST'))
-                        param.host = env('ROUTE_HOST');
-                    if (env('ROUTE_PORT'))
-                        param.port = Number(env('ROUTE_PORT'));
-                    if (env('ROUTE_PROTOCOL')) {
-                        param.protocol = env('ROUTE_PROTOCOL');
-                    }
-                    break;
-            }
-            platform = (0, lib_1.init)({ platformId, param });
-            pass(`Initialized ${platformId} platform`);
-        }));
-        // 2. Balance check (only nest and hubtel expose getBalance)
-        if (platformId === 'nest' || platformId === 'hubtel') {
-            yield runTest('getBalance()', () => __awaiter(this, void 0, void 0, function* () {
-                const gateway = platform.getGateway();
-                if (!gateway.getBalance) {
-                    warn('getBalance not implemented — skipped');
-                    return;
-                }
-                const balance = yield gateway.getBalance();
-                pass(`Balance retrieved: ${JSON.stringify(balance)}`);
-            }));
-        }
-        else {
-            warn(`getBalance not supported by '${platformId}' — skipped`);
-        }
-        // 3. Send SMS (opt-in via TEST_SEND=true)
-        const shouldSend = env('TEST_SEND') === 'true';
-        if (!shouldSend) {
-            warn('TEST_SEND is not set to true — skipping live send');
-            return;
-        }
-        yield runTest('quickSend()', () => __awaiter(this, void 0, void 0, function* () {
-            const sendParams = {
-                From: requireEnv('TEST_FROM'),
-                To: requireEnv('TEST_TO'),
-                Content: env('TEST_CONTENT') || 'unismsgateway live test — please ignore.'
-            };
-            info(`Sending from "${sendParams.From}" to "${sendParams.To}"...`);
-            const result = yield platform.quickSend(sendParams);
-            if (!result.success) {
-                throw new Error(result.error || `Send failed: ${JSON.stringify(result)}`);
-            }
-            pass(`Message sent. Result: ${JSON.stringify(result)}`);
-        }));
-    });
-}
-// ─── Entry point ─────────────────────────────────────────────────────────────
-function main() {
-    return __awaiter(this, void 0, void 0, function* () {
-        console.log(`\n${BOLD}═══════════════════════════════════════${RESET}`);
-        console.log(`${BOLD}   unismsgateway  —  live test runner   ${RESET}`);
-        console.log(`${BOLD}═══════════════════════════════════════${RESET}`);
-        const platformArg = env('GATEWAY_PLATFORM');
-        const platforms = platformArg
-            ? [platformArg]
-            : (env('TEST_ALL') === 'true' ? ['nest', 'hubtel', 'route'] : []);
-        if (platforms.length === 0) {
-            console.log(`\n${YELLOW}No platform selected.${RESET}`);
-            console.log('Set GATEWAY_PLATFORM=nest|hubtel|route in your .env file,');
-            console.log('or set TEST_ALL=true to test all configured platforms.\n');
-            process.exit(1);
-        }
-        for (const p of platforms) {
-            try {
-                yield testPlatform(p);
-            }
-            catch (_a) {
-                // individual test errors already captured above
-            }
-        }
-        // ─── Summary ────────────────────────────────────────────────────────────
-        title('Summary');
-        if (passed > 0)
-            pass(`${passed} check(s) passed`);
-        if (failed > 0)
-            fail(`${failed} check(s) failed`);
-        console.log();
-        process.exit(failed > 0 ? 1 : 0);
-    });
-}
-main().catch((err) => {
-    console.error(`\n${RED}Unexpected error:${RESET}`, err);
-    process.exit(1);
-});

package/dist/src/index.d.ts

@@ -1 +0,0 @@
-export * from './lib/lib';

package/dist/src/index.js

@@ -1,13 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
-}) : (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("./lib/lib"), exports);

package/dist/src/lib/lib.d.ts

@@ -1,5 +0,0 @@
-import { smsPlatform, IgatewaySettings, IgatewayParam, PlatformId, QuickSendParams, QuickSendParamsInput, QuickSendParamsCamel, normalizeQuickSendParams, SendResult, ISmsGateway } from './platform';
-export declare function init(settings: IgatewaySettings): smsPlatform;
-export declare function getSmsPlatform(): smsPlatform | null;
-export declare function reset(): void;
-export { smsPlatform, IgatewaySettings, IgatewayParam, PlatformId, QuickSendParams, QuickSendParamsInput, QuickSendParamsCamel, normalizeQuickSendParams, SendResult, ISmsGateway };

package/dist/src/lib/lib.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizeQuickSendParams = exports.smsPlatform = exports.reset = exports.getSmsPlatform = exports.init = void 0;
-const platform_1 = require("./platform");
-Object.defineProperty(exports, "smsPlatform", { enumerable: true, get: function () { return platform_1.smsPlatform; } });
-Object.defineProperty(exports, "normalizeQuickSendParams", { enumerable: true, get: function () { return platform_1.normalizeQuickSendParams; } });
-let smsPlatformInstance = null;
-function init(settings) {
-    smsPlatformInstance = new platform_1.smsPlatform(settings);
-    smsPlatformInstance.init();
-    return smsPlatformInstance;
-}
-exports.init = init;
-function getSmsPlatform() {
-    return smsPlatformInstance;
-}
-exports.getSmsPlatform = getSmsPlatform;
-function reset() {
-    smsPlatformInstance = null;
-}
-exports.reset = reset;

package/dist/src/lib/nest-gateway.d.ts

@@ -1,13 +0,0 @@
-import { ISmsGateway, QuickSendParams, SendResult, NestSmsConfig } from './types';
-export declare class NestSmsGateway implements ISmsGateway {
-    private config;
-    constructor(config: NestSmsConfig);
-    init(): ISmsGateway;
-    private log;
-    private makeRequest;
-    quickSend(params: QuickSendParams, callback?: Function): Promise<SendResult>;
-    getBalance(): Promise<{
-        balance: number;
-        model: string;
-    }>;
-}

package/dist/src/lib/nest-gateway.js

@@ -1,198 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NestSmsGateway = void 0;
-const https = __importStar(require("https"));
-const http = __importStar(require("http"));
-const DEFAULT_HOST = 'api.smsonlinegh.com';
-const DEFAULT_PROTOCOL = 'https';
-class NestSmsGateway {
-    constructor(config) {
-        this.config = {
-            host: config.host || DEFAULT_HOST,
-            protocol: config.protocol || DEFAULT_PROTOCOL,
-            apiKey: config.apiKey,
-            debug: config.debug || false
-        };
-    }
-    init() {
-        return this;
-    }
-    log(...args) {
-        if (this.config.debug) {
-            console.log('[unismsgateway:nest]', ...args);
-        }
-    }
-    makeRequest(endpoint, data) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return new Promise((resolve, reject) => {
-                const postData = data ? JSON.stringify(data) : '';
-                const protocol = this.config.protocol || DEFAULT_PROTOCOL;
-                const httpModule = protocol === 'https' ? https : http;
-                const defaultPort = protocol === 'https' ? 443 : 80;
-                const host = this.config.host || DEFAULT_HOST;
-                const hostname = host.includes(':') ? host.split(':')[0] : host;
-                const port = host.includes(':')
-                    ? parseInt(host.split(':')[1], 10)
-                    : defaultPort;
-                const options = {
-                    hostname,
-                    port,
-                    path: `/v5/${endpoint}`,
-                    method: 'POST',
-                    // Disable keep-alive connection pooling. Node's global agent reuses
-                    // sockets across calls; when the server closes an idle socket server-side
-                    // the next write (i.e. the request body in quickSend) gets ECONNABORTED.
-                    // agent:false forces a fresh connection for every request.
-                    agent: false,
-                    headers: {
-                        'Host': hostname,
-                        'Content-Type': 'application/json',
-                        'Accept': 'application/json',
-                        'Authorization': `key ${this.config.apiKey}`,
-                        'Content-Length': Buffer.byteLength(postData)
-                    }
-                };
-                this.log(`POST /v5/${endpoint}`, data ? JSON.stringify(data) : '(no body)');
-                const req = httpModule.request(options, (res) => {
-                    let responseBody = '';
-                    res.on('data', (chunk) => {
-                        responseBody += chunk;
-                    });
-                    res.on('end', () => {
-                        var _a;
-                        const statusCode = (_a = res.statusCode) !== null && _a !== void 0 ? _a : 0;
-                        this.log(`HTTP ${statusCode} response:`, responseBody);
-                        try {
-                            const parsed = JSON.parse(responseBody);
-                            if (statusCode >= 200 && statusCode < 300) {
-                                resolve({ statusCode, body: parsed });
-                            }
-                            else {
-                                const err = new Error(`HTTP ${statusCode}: ${responseBody}`);
-                                err.statusCode = statusCode;
-                                err.rawBody = responseBody;
-                                reject(err);
-                            }
-                        }
-                        catch (_b) {
-                            const err = new Error(`Failed to parse gateway response (HTTP ${statusCode}): ${responseBody}`);
-                            err.statusCode = statusCode;
-                            err.rawBody = responseBody;
-                            reject(err);
-                        }
-                    });
-                });
-                req.on('error', (error) => {
-                    this.log('Network error:', error.message);
-                    reject(error);
-                });
-                if (postData) {
-                    req.write(postData);
-                }
-                req.end();
-            });
-        });
-    }
-    quickSend(params, callback) {
-        var _a, _b, _c, _d, _e;
-        return __awaiter(this, void 0, void 0, function* () {
-            const requestBody = {
-                text: params.Content,
-                type: (_a = params.Type) !== null && _a !== void 0 ? _a : 0,
-                sender: params.From,
-                destinations: [String(params.To)]
-            };
-            this.log('quickSend params:', JSON.stringify(params));
-            let result;
-            try {
-                const { statusCode, body: response } = yield this.makeRequest('message/sms/send', requestBody);
-                const handshakeId = (_b = response.handshake) === null || _b === void 0 ? void 0 : _b.id;
-                const handshakeLabel = (_c = response.handshake) === null || _c === void 0 ? void 0 : _c.label;
-                const handshakeOk = Number(handshakeId) === 0;
-                const responseData = (_d = response.data) !== null && _d !== void 0 ? _d : null;
-                const batchId = responseData && typeof responseData === 'object'
-                    ? responseData.batch
-                    : undefined;
-                const firstDest = responseData && typeof responseData === 'object'
-                    ? (_e = responseData.destinations) === null || _e === void 0 ? void 0 : _e[0]
-                    : undefined;
-                let errorMsg;
-                if (!handshakeOk) {
-                    if (handshakeLabel) {
-                        errorMsg = `API Error [code ${handshakeId}]: ${handshakeLabel}`;
-                    }
-                    else if (handshakeId !== undefined && handshakeId !== null) {
-                        errorMsg = `API Error: handshake code=${handshakeId}`;
-                    }
-                    else {
-                        errorMsg = `Unexpected API response: ${JSON.stringify(response)}`;
-                    }
-                }
-                result = {
-                    success: handshakeOk,
-                    messageId: batchId || (firstDest === null || firstDest === void 0 ? void 0 : firstDest.id),
-                    // On failure, expose the full raw response so callers can inspect it.
-                    data: handshakeOk ? responseData : response,
-                    error: errorMsg,
-                    statusCode
-                };
-            }
-            catch (error) {
-                const httpErr = error;
-                const errorMessage = error instanceof Error ? error.message : String(error);
-                result = {
-                    success: false,
-                    error: errorMessage,
-                    statusCode: httpErr.statusCode,
-                    // Preserve whatever raw body we got for inspection.
-                    data: httpErr.rawBody !== undefined ? httpErr.rawBody : null
-                };
-            }
-            this.log('quickSend result:', JSON.stringify(result));
-            if (callback) {
-                callback(result);
-            }
-            return result;
-        });
-    }
-    getBalance() {
-        var _a, _b, _c, _d;
-        return __awaiter(this, void 0, void 0, function* () {
-            this.log('getBalance called');
-            const { body: response } = yield this.makeRequest('account/balance');
-            return {
-                balance: (_b = (_a = response.data) === null || _a === void 0 ? void 0 : _a.balance) !== null && _b !== void 0 ? _b : 0,
-                model: (_d = (_c = response.data) === null || _c === void 0 ? void 0 : _c.model) !== null && _d !== void 0 ? _d : 'quantity'
-            };
-        });
-    }
-}
-exports.NestSmsGateway = NestSmsGateway;

package/dist/src/lib/platform.d.ts

@@ -1,13 +0,0 @@
-import { IgatewaySettings, IgatewayParam, ISmsGateway, ISmsGatewayDelegate, QuickSendParamsInput, SendResult } from './types';
-export * from './types';
-export declare class smsPlatform implements ISmsGateway {
-    private _settings;
-    private _gateway;
-    constructor(settings: IgatewaySettings);
-    private validateSettings;
-    private createGateway;
-    init(): ISmsGateway;
-    quickSend(param: QuickSendParamsInput, callback?: Function): Promise<SendResult>;
-    getGateway(): ISmsGatewayDelegate;
-}
-export { IgatewaySettings, IgatewayParam };

package/dist/src/lib/platform.js

@@ -1,90 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
-}) : (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 });
-exports.smsPlatform = void 0;
-const nest_gateway_1 = require("./nest-gateway");
-const hubtel_gateway_1 = require("./hubtel-gateway");
-const route_gateway_1 = require("./route-gateway");
-const types_1 = require("./types");
-__exportStar(require("./types"), exports);
-const GATEWAY_CONFIGS = {
-    route: { requiresUsernamePassword: true },
-    hubtel: { requiresClientCredentials: true },
-    nest: { requiresApiKey: true }
-};
-class smsPlatform {
-    constructor(settings) {
-        this.validateSettings(settings);
-        this._settings = settings;
-        this._gateway = this.createGateway();
-    }
-    validateSettings(settings) {
-        const validPlatforms = ['route', 'hubtel', 'nest'];
-        if (!validPlatforms.includes(settings.platformId)) {
-            throw new Error(`Invalid platform ID. Supported platforms: ${validPlatforms.join(', ')}`);
-        }
-        const config = GATEWAY_CONFIGS[settings.platformId];
-        const param = settings.param;
-        if (config.requiresApiKey && !param.apiKey) {
-            throw new Error(`Platform '${settings.platformId}' requires 'apiKey' in param`);
-        }
-        if (config.requiresClientCredentials && (!param.clientId || !param.clientSecret)) {
-            throw new Error(`Platform '${settings.platformId}' requires 'clientId' and 'clientSecret' in param`);
-        }
-        if (config.requiresUsernamePassword && (!param.username || !param.password)) {
-            throw new Error(`Platform '${settings.platformId}' requires 'username' and 'password' in param`);
-        }
-    }
-    createGateway() {
-        const { platformId, param } = this._settings;
-        switch (platformId) {
-            case 'route':
-                return new route_gateway_1.RouteSmsGateway({
-                    host: param.host || 'rslr.connectbind.com',
-                    username: param.username,
-                    password: param.password,
-                    protocol: param.protocol || 'http',
-                    port: param.port || 8080,
-                    debug: param.debug
-                });
-            case 'hubtel':
-                return new hubtel_gateway_1.HubtelSmsGateway({
-                    clientId: param.clientId,
-                    clientSecret: param.clientSecret,
-                    debug: param.debug
-                });
-            case 'nest':
-                return new nest_gateway_1.NestSmsGateway({
-                    apiKey: param.apiKey,
-                    host: param.host,
-                    protocol: param.protocol,
-                    debug: param.debug
-                });
-            default:
-                throw new Error(`Unsupported platform: ${platformId}`);
-        }
-    }
-    init() {
-        return this;
-    }
-    quickSend(param, callback) {
-        if (!this._gateway) {
-            throw new Error('Gateway not initialized. Call init() first.');
-        }
-        const normalized = (0, types_1.normalizeQuickSendParams)(param);
-        return this._gateway.quickSend(normalized, callback);
-    }
-    getGateway() {
-        return this._gateway;
-    }
-}
-exports.smsPlatform = smsPlatform;

package/dist/src/lib/types.js

@@ -1,42 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizeQuickSendParams = void 0;
-/**
- * Maps PascalCase or camelCase quick-send fields to {@link QuickSendParams}.
- * PascalCase wins when both are present.
- */
-function normalizeQuickSendParams(params) {
-    var _a, _b, _c, _d;
-    const p = params;
-    const from = (_a = p.From) !== null && _a !== void 0 ? _a : p.from;
-    const to = (_b = p.To) !== null && _b !== void 0 ? _b : p.to;
-    const content = (_c = p.Content) !== null && _c !== void 0 ? _c : p.content;
-    const type = (_d = p.Type) !== null && _d !== void 0 ? _d : p.type;
-    const contentStr = content == null ? '' : String(content);
-    const trimmedBody = contentStr.trim();
-    if (trimmedBody === '') {
-        throw new Error('quickSend: message body is missing. Pass Content or content with a non-empty string.');
-    }
-    const fromStr = from == null ? '' : String(from).trim();
-    if (fromStr === '') {
-        throw new Error('quickSend: sender is missing. Pass From or from with a non-empty string.');
-    }
-    if (to === null || to === undefined) {
-        throw new Error('quickSend: recipient is missing. Pass To or to.');
-    }
-    const toVal = typeof to === 'number' ? to : String(to).trim();
-    let typeNum;
-    if (type !== undefined && type !== null) {
-        const n = Number(type);
-        if (!Number.isNaN(n)) {
-            typeNum = n;
-        }
-    }
-    return {
-        From: fromStr,
-        To: toVal,
-        Content: trimmedBody,
-        Type: typeNum
-    };
-}
-exports.normalizeQuickSendParams = normalizeQuickSendParams;