unismsgateway 1.4.0 → 1.5.1

package/README.md

@@ -306,7 +306,7 @@ const gateway = unisms.init({
 | `protocol` | `'https'`             |
 
 
-Requests use `POST` to path `**/v5/<endpoint>`** (e.g. send: `message/sms/send`, balance: `account/balance`). Authorization header: `Authorization: key <apiKey>`.
+Requests use `POST` to path `**/v5/<endpoint>`** (e.g. send: `message/sms/send`, balance: `account/balance`). Authorization header: `Authorization: key <apiKey>`. Each request opens a fresh connection (keep-alive pooling is disabled) to prevent stale-socket errors in long-running processes.
 
 ```javascript
 const gateway = unisms.init({
@@ -337,18 +337,18 @@ console.log(balance.balance, balance.model);
 
 ### `QuickSendParams`
 
-
 | Field     | Type     | Required | Description                                                            |
 | --------- | -------- | -------- | ---------------------------------------------------------------------- |
 | `From`    | `string` | yes      | Sender ID or label.                                                    |
-| `To`      | `string \| number` | yes                                                                    |
+| `To`      | `string \| number` | yes      | Recipient MSISDN or number.                                            |
 | `Content` | `string` | yes      | Message body.                                                          |
 | `Type`    | `number` | no       | Message type; **nest** maps this to request body `type` (default `0`). |
 
+**camelCase:** You may pass **`from`**, **`to`**, **`content`**, and **`type`** instead of the PascalCase names above. Many JavaScript projects use camelCase; if you pass only `content` and `Content` is missing, the SMSOnlineGH (`nest`) API receives no message body and may return handshake **1305** (`MV_ERR_MESSAGE` — missing or invalid message body). The library normalizes both conventions before calling the gateway.
 
 ### `quickSend(params, callback?)`
 
-Returns `Promise<SendResult>`. Optional `callback` is invoked with the same result when the promise completes.
+Returns `Promise<SendResult>`. Optional `callback` is invoked with the same result when the promise completes. The `params` argument accepts **`QuickSendParams`** (PascalCase) or **`QuickSendParamsCamel`** (`{ from, to, content, type? }`). See **`normalizeQuickSendParams`** in the public API if you need the same mapping outside `quickSend`.
 
 `**SendResult`:**
 
@@ -438,12 +438,15 @@ Full variable reference (selection, per-gateway credentials, live send): [Live i
 ## API reference
 
 
-| Export             | Description                                                          |
-| ------------------ | -------------------------------------------------------------------- |
-| `init(settings)`   | Create and register the singleton `smsPlatform`, return it.          |
-| `getSmsPlatform()` | Current `smsPlatform` or `null` after `reset()` and before `init()`. |
-| `reset()`          | Clear the singleton.                                                 |
-| `smsPlatform`      | Class type for typing/advanced use.                                  |
+| Export                     | Description                                                          |
+| -------------------------- | -------------------------------------------------------------------- |
+| `init(settings)`           | Create and register the singleton `smsPlatform`, return it.          |
+| `getSmsPlatform()`         | Current `smsPlatform` or `null` after `reset()` and before `init()`. |
+| `reset()`                  | Clear the singleton.                                                 |
+| `smsPlatform`              | Class type for typing/advanced use.                                  |
+| `QuickSendParamsInput`     | Union: PascalCase `QuickSendParams` or camelCase `QuickSendParamsCamel`. |
+| `QuickSendParamsCamel`     | `{ from, to, content, type? }` for `quickSend`.                      |
+| `normalizeQuickSendParams` | Maps input to canonical `QuickSendParams` (throws if body/sender missing). |
 
 
 `**smsPlatform` instance methods**
@@ -452,10 +455,20 @@ Full variable reference (selection, per-gateway credentials, live send): [Live i
 | Method                         | Returns               | Description                                    |
 | ------------------------------ | --------------------- | ---------------------------------------------- |
 | `init()`                       | `ISmsGateway`         | Returns `this` (facade).                       |
-| `quickSend(params, callback?)` | `Promise<SendResult>` | Delegates to the active gateway.               |
+| `quickSend(params, callback?)` | `Promise<SendResult>` | Normalizes PascalCase or camelCase params, then delegates to the active gateway. |
 | `getGateway()`                 | `ISmsGateway`         | Underlying adapter (for nest: `getBalance()`). |
 
 
+---
+
+## Changelog
+
+### 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.
+
+### 1.5.0
+- **Fix (`nest`):** `quickSend` now reliably works in long-running processes (servers, workers). Node's global HTTP agent reuses keep-alive sockets across calls; when the provider closes an idle socket server-side, the next `quickSend` that writes a request body received `write ECONNABORTED` while `getBalance` (no body) appeared to work fine. Fixed by setting `agent: false` on each request so every call opens a fresh connection rather than reusing a potentially stale one from the pool.
+
 ---
 
 ## License

package/dist/src/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/src/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/src/lib/nest-gateway.js

@@ -67,6 +67,11 @@ class NestSmsGateway {
                     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',

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

@@ -1,4 +1,4 @@
-import { IgatewaySettings, IgatewayParam, ISmsGateway, ISmsGatewayDelegate, 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>;
+    quickSend(param: QuickSendParamsInput, callback?: Function): Promise<SendResult>;
     getGateway(): ISmsGatewayDelegate;
 }
 export { IgatewaySettings, IgatewayParam };

package/dist/src/lib/platform.js

@@ -14,6 +14,7 @@ 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 },
@@ -79,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/src/lib/types.d.ts

@@ -5,6 +5,23 @@ export interface QuickSendParams {
     Content: string;
     Type?: number;
 }
+/**
+ * camelCase variant of {@link QuickSendParams}. Plain JS consumers often pass
+ * `{ from, to, content }`; without normalization those would not read `Content`
+ * and the nest API would receive no message body (e.g. handshake 1305).
+ */
+export interface QuickSendParamsCamel {
+    from: string;
+    to: string | number;
+    content: string;
+    type?: number;
+}
+export declare type QuickSendParamsInput = QuickSendParams | QuickSendParamsCamel;
+/**
+ * Maps PascalCase or camelCase quick-send fields to {@link QuickSendParams}.
+ * PascalCase wins when both are present.
+ */
+export declare function normalizeQuickSendParams(params: QuickSendParamsInput): QuickSendParams;
 export interface SendResult {
     success: boolean;
     messageId?: string;

package/dist/src/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.4.0",
+  "version": "1.5.1",
   "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",