mn-sms 0.0.0-stage → 0.1.0

package/dist/index.cjs

@@ -0,0 +1,566 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DEFAULT_TIMEOUT_MS: () => DEFAULT_TIMEOUT_MS,
+  GMOBILE_ERRORS: () => GMOBILE_ERRORS,
+  SKYTEL_ERRORS: () => SKYTEL_ERRORS,
+  configFromEnv: () => configFromEnv,
+  countSegments: () => countSegments,
+  createGmobileGateway: () => createGmobileGateway,
+  createMobicomGateway: () => createMobicomGateway,
+  createSkytelGateway: () => createSkytelGateway,
+  createSmsClient: () => createSmsClient,
+  createUnitelGateway: () => createUnitelGateway,
+  gatewayFor: () => gatewayFor,
+  normalizePhone: () => normalizePhone,
+  operatorFor: () => operatorFor,
+  resolveTransport: () => resolveTransport,
+  toLatin: () => toLatin
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/numbering.ts
+var RANGES = [
+  [99e6, 99999999, "mobicom"],
+  [95e6, 95999999, "mobicom"],
+  [94e6, 94999999, "mobicom"],
+  [85e6, 85999999, "mobicom"],
+  [505e5, 50999999, "mobicom"],
+  [555e5, 55999999, "mobicom"],
+  [91e6, 91999999, "skytel"],
+  [9e7, 90999999, "skytel"],
+  [96e6, 96999999, "skytel"],
+  [69e6, 69099999, "skytel"],
+  [696e5, 69699999, "skytel"],
+  [699e5, 69999999, "skytel"],
+  [88e6, 88999999, "unitel"],
+  [86e6, 86999999, "unitel"],
+  [8e7, 80999999, "unitel"],
+  [89e6, 89999999, "unitel"],
+  [5e7, 50499999, "unitel"],
+  [55e6, 55499999, "unitel"],
+  [98e6, 98199999, "gmobile"],
+  [988e5, 98999999, "gmobile"],
+  [93e6, 93199999, "gmobile"],
+  [97e6, 97199999, "gmobile"],
+  [83e6, 83199999, "gmobile"],
+  [87e6, 87099999, "gmobile"],
+  [871e5, 87119999, "gmobile"],
+  [6e7, 60499999, "ondo"],
+  [605e5, 60509999, "ondo"],
+  [606e5, 60699999, "ondo"],
+  [607e5, 60709999, "ondo"],
+  [66e6, 66099999, "ondo"],
+  [661e5, 66199999, "ondo"],
+  [666e5, 66699999, "ondo"],
+  [669e5, 66999999, "ondo"],
+  [8181e4, 81819999, "ondo"]
+];
+var GATEWAYS = {
+  unitel: "unitel",
+  skytel: "skytel",
+  mobicom: "mobicom",
+  gmobile: "gmobile",
+  ondo: null
+};
+function normalizePhone(input) {
+  const digits = input.replace(/[\s\-().]/g, "").replace(/^(\+|00)976/, "");
+  const local = digits.length === 11 && digits.startsWith("976") ? digits.slice(3) : digits;
+  return /^\d{8}$/.test(local) ? local : null;
+}
+function operatorFor(phone) {
+  const local = normalizePhone(phone);
+  if (!local) return null;
+  const msisdn = Number(local);
+  return RANGES.find(([first, last]) => msisdn >= first && msisdn <= last)?.[2] ?? null;
+}
+function gatewayFor(phone) {
+  const operator = operatorFor(phone);
+  return operator ? GATEWAYS[operator] : null;
+}
+
+// src/transport.ts
+var DEFAULT_TIMEOUT_MS = 2e4;
+function resolveTransport(options = {}) {
+  return {
+    fetch: options.fetch ?? globalThis.fetch,
+    timeoutMs: options.timeoutMs ?? DEFAULT_TIMEOUT_MS
+  };
+}
+function trimBase(baseUrl) {
+  return baseUrl.replace(/\/+$/, "");
+}
+function withQuery(base, fields) {
+  const url = new URL(base);
+  url.search = fields.map(([key, value]) => `${key}=${encodeURIComponent(value)}`).join("&");
+  return url.toString();
+}
+function failure(cause, request, secrets, timeoutMs) {
+  const raw = cause instanceof Error ? cause.message : String(cause);
+  const message = secrets.filter(Boolean).reduce((text, secret) => text.split(secret).join("[redacted]"), raw);
+  const timedOut = cause instanceof Error && (cause.name === "TimeoutError" || cause.name === "AbortError");
+  return {
+    ok: false,
+    statusCode: null,
+    request,
+    response: null,
+    error: timedOut ? {
+      code: "timeout",
+      // The gateway said nothing, so the message may well be on its way.
+      message: `no answer within ${timeoutMs}ms \u2014 delivery state is unknown`
+    } : { code: "network", message }
+  };
+}
+
+// src/operators/gmobile.ts
+var DEFAULT_BASE_URL = "http://sms-special.gmobile.mn";
+var GMOBILE_ERRORS = {
+  error1: "a required parameter was not sent",
+  error2: "the special (sender) number does not exist",
+  error3: "the request came from an IP address that is not allowed",
+  error4: "this account's right to send has been closed",
+  error5: "the recipient's number is invalid",
+  error6: "the text is longer than 160 characters"
+};
+function createGmobileGateway(config, transport) {
+  const url = `${trimBase(config.baseUrl ?? DEFAULT_BASE_URL)}/cgi-bin/sendsms`;
+  return {
+    name: "gmobile",
+    maxLength: 160,
+    async send(to, message) {
+      const request = {
+        method: "GET",
+        url,
+        params: { from: config.from, to, text: message }
+      };
+      try {
+        const response = await transport.fetch(
+          withQuery(url, [
+            ["username", config.username],
+            ["password", config.password],
+            ["from", config.from],
+            ["to", to],
+            ["text", message]
+          ]),
+          { method: "GET", signal: AbortSignal.timeout(transport.timeoutMs) }
+        );
+        const body = (await response.text()).trim();
+        const ok = response.ok && /^0:\s*accepted\b/i.test(body);
+        const gatewayCode = /^error\d+$/i.exec(body)?.[0].toLowerCase();
+        return {
+          ok,
+          statusCode: response.status,
+          request,
+          response: body,
+          error: ok ? null : {
+            code: "rejected",
+            message: gatewayCode && GMOBILE_ERRORS[gatewayCode] || body || `G-Mobile answered HTTP ${response.status} with an empty body`,
+            ...gatewayCode ? { gatewayCode } : {}
+          }
+        };
+      } catch (cause) {
+        return failure(
+          cause,
+          request,
+          [config.username, config.password],
+          transport.timeoutMs
+        );
+      }
+    }
+  };
+}
+
+// src/operators/mobicom.ts
+function createMobicomGateway(config, transport) {
+  const url = `${trimBase(config.baseUrl)}/smsmt/mt`;
+  return {
+    name: "mobicom",
+    async send(to, message) {
+      const request = {
+        method: "GET",
+        url,
+        params: {
+          servicename: config.serviceName,
+          from: config.from,
+          to,
+          msg: message
+        }
+      };
+      try {
+        const response = await transport.fetch(
+          withQuery(url, [
+            ["servicename", config.serviceName],
+            ["username", config.username],
+            ["from", config.from],
+            ["to", to],
+            ["msg", message]
+          ]),
+          { method: "GET", signal: AbortSignal.timeout(transport.timeoutMs) }
+        );
+        const body = (await response.text()).trim();
+        const ok = response.ok && /^sent\b/i.test(body);
+        return {
+          ok,
+          statusCode: response.status,
+          request,
+          response: body,
+          error: ok ? null : {
+            code: "rejected",
+            message: body || `Mobicom answered HTTP ${response.status} with an empty body`
+          }
+        };
+      } catch (cause) {
+        return failure(cause, request, [config.username], transport.timeoutMs);
+      }
+    }
+  };
+}
+
+// src/operators/skytel.ts
+var DEFAULT_BASE_URL2 = "https://smsgw.skytel.mn";
+var SKYTEL_ERRORS = {
+  "101": "a required parameter is missing",
+  "102": "invalid src (sender) number",
+  "103": "invalid dest (recipient) number",
+  "201": "invalid parameter(s)",
+  "202": "not authenticated \u2014 wrong id, or the calling IP is not on the Allowed IP List",
+  "203": "account disabled",
+  "206": "recipient is on another network \u2014 this gateway only delivers to Skytel numbers",
+  "207": "src is not the sender number registered to this account"
+};
+function endpointFor(text) {
+  const latinOnly = [...text].every((ch) => (ch.codePointAt(0) ?? 0) < 128);
+  return latinOnly ? "pushsms" : "unicode";
+}
+function createSkytelGateway(config, transport) {
+  const base = `${trimBase(config.baseUrl ?? DEFAULT_BASE_URL2)}/SMSGW-war`;
+  return {
+    name: "skytel",
+    maxLength: 160,
+    async send(to, message) {
+      const url = `${base}/${endpointFor(message)}`;
+      const request = {
+        method: "GET",
+        url,
+        params: { src: config.src, dest: to, text: message }
+      };
+      try {
+        const response = await transport.fetch(
+          withQuery(url, [
+            ["id", config.id],
+            ["src", config.src],
+            ["dest", to],
+            ["text", message]
+          ]),
+          { method: "GET", signal: AbortSignal.timeout(transport.timeoutMs) }
+        );
+        const body = (await response.text()).trim();
+        const ok = response.ok && /^ok\b/i.test(body);
+        const gatewayCode = /^ERROR:\s*(\d+)/i.exec(body)?.[1];
+        return {
+          ok,
+          statusCode: response.status,
+          request,
+          response: body,
+          error: ok ? null : {
+            code: "rejected",
+            message: gatewayCode && SKYTEL_ERRORS[gatewayCode] || body || `Skytel answered HTTP ${response.status} with an empty body`,
+            ...gatewayCode ? { gatewayCode } : {}
+          }
+        };
+      } catch (cause) {
+        return failure(cause, request, [config.id], transport.timeoutMs);
+      }
+    }
+  };
+}
+
+// src/operators/unitel.ts
+var DEFAULT_BASE_URL3 = "https://pn.unitel.mn";
+function createUnitelGateway(config, transport) {
+  const endpoint = `${trimBase(config.baseUrl ?? DEFAULT_BASE_URL3)}/api/message/send/sms`;
+  return {
+    name: "unitel",
+    async send(to, message) {
+      const request = {
+        method: "POST",
+        url: endpoint,
+        params: { to, message }
+      };
+      try {
+        const url = new URL(endpoint);
+        url.searchParams.set("enc", config.apiKey);
+        const response = await transport.fetch(url.toString(), {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify({ to, message }),
+          signal: AbortSignal.timeout(transport.timeoutMs)
+        });
+        const text = await response.text();
+        let body = text;
+        try {
+          body = JSON.parse(text);
+        } catch {
+        }
+        const ok = response.ok;
+        return {
+          ok,
+          statusCode: response.status,
+          request,
+          response: body,
+          error: ok ? null : {
+            code: "rejected",
+            message: `Unitel answered HTTP ${response.status}`,
+            gatewayCode: String(response.status)
+          }
+        };
+      } catch (cause) {
+        return failure(cause, request, [config.apiKey], transport.timeoutMs);
+      }
+    }
+  };
+}
+
+// src/client.ts
+function createSmsClient(config, options) {
+  const transport = resolveTransport(options);
+  const gateways = {};
+  if (config.unitel)
+    gateways.unitel = createUnitelGateway(config.unitel, transport);
+  if (config.skytel)
+    gateways.skytel = createSkytelGateway(config.skytel, transport);
+  if (config.mobicom)
+    gateways.mobicom = createMobicomGateway(config.mobicom, transport);
+  if (config.gmobile)
+    gateways.gmobile = createGmobileGateway(config.gmobile, transport);
+  function plan(input) {
+    const to = normalizePhone(input.to);
+    const operator = to ? operatorFor(to) : null;
+    const gatewayName = input.operator ?? (to ? gatewayFor(to) : null);
+    const gateway = gatewayName ? gateways[gatewayName] : void 0;
+    return { to, operator, gatewayName, gateway, error: refusal() };
+    function refusal() {
+      if (!to)
+        return {
+          code: "invalid_number",
+          message: "must be an 8-digit Mongolian subscriber number"
+        };
+      if (!gatewayName)
+        return operator ? {
+          code: "unsupported_operator",
+          message: `operator "${operator}" has no gateway in this package`
+        } : {
+          code: "unallocated_number",
+          message: `${to} is not in any Mongolian mobile number range`
+        };
+      if (!gateway)
+        return {
+          code: "not_configured",
+          message: `${to} routes to ${gatewayName}, which this client has no config for`
+        };
+      if (input.message.length === 0)
+        return { code: "empty_message", message: "message is empty" };
+      if (gateway.maxLength !== void 0 && input.message.length > gateway.maxLength)
+        return {
+          code: "message_too_long",
+          message: `${gatewayName} accepts at most ${gateway.maxLength} characters`
+        };
+      return null;
+    }
+  }
+  return {
+    gateways: Object.keys(gateways),
+    check(input) {
+      return plan(input).error;
+    },
+    async send(input) {
+      const { to, operator, gatewayName, gateway, error } = plan(input);
+      const head = {
+        to: to ?? input.to,
+        operator,
+        gateway: gatewayName
+      };
+      if (error || !gateway || !to)
+        return {
+          ...head,
+          ok: false,
+          statusCode: null,
+          request: null,
+          response: null,
+          error
+        };
+      return { ...head, ...await gateway.send(to, input.message) };
+    }
+  };
+}
+
+// src/env.ts
+function configFromEnv(env = globalThis.process?.env ?? {}) {
+  const config = {};
+  const get = (name) => env[name] || void 0;
+  const unitelKey = get("UNITEL_API_KEY");
+  if (unitelKey)
+    config.unitel = { apiKey: unitelKey, baseUrl: get("UNITEL_BASE_URL") };
+  const skytelId = get("SKYTEL_ID");
+  const skytelSrc = get("SKYTEL_SRC");
+  if (skytelId && skytelSrc)
+    config.skytel = {
+      id: skytelId,
+      src: skytelSrc,
+      baseUrl: get("SKYTEL_BASE_URL")
+    };
+  const mobicomBase = get("MOBICOM_BASE_URL");
+  const mobicomService = get("MOBICOM_SERVICE_NAME");
+  const mobicomUser = get("MOBICOM_USERNAME");
+  const mobicomFrom = get("MOBICOM_FROM");
+  if (mobicomBase && mobicomService && mobicomUser && mobicomFrom)
+    config.mobicom = {
+      baseUrl: mobicomBase,
+      serviceName: mobicomService,
+      username: mobicomUser,
+      from: mobicomFrom
+    };
+  const gmobileUser = get("GMOBILE_USERNAME");
+  const gmobilePass = get("GMOBILE_PASSWORD");
+  const gmobileFrom = get("GMOBILE_FROM");
+  if (gmobileUser && gmobilePass && gmobileFrom)
+    config.gmobile = {
+      username: gmobileUser,
+      password: gmobilePass,
+      from: gmobileFrom,
+      baseUrl: get("GMOBILE_BASE_URL")
+    };
+  return config;
+}
+
+// src/text.ts
+var GSM_BASIC = `@\xA3$\xA5\xE8\xE9\xF9\xEC\xF2\xC7
+\xD8\xF8\r\xC5\xE5\u0394_\u03A6\u0393\u039B\u03A9\u03A0\u03A8\u03A3\u0398\u039E\xC6\xE6\xDF\xC9 !"#\xA4%&'()*+,-./0123456789:;<=>?\xA1ABCDEFGHIJKLMNOPQRSTUVWXYZ\xC4\xD6\xD1\xDC\xA7\xBFabcdefghijklmnopqrstuvwxyz\xE4\xF6\xF1\xFC\xE0`;
+var GSM_EXTENDED = "\f^{}\\[~]|\u20AC";
+function countSegments(message) {
+  const chars = [...message];
+  const gsm = chars.every(
+    (ch) => GSM_BASIC.includes(ch) || GSM_EXTENDED.includes(ch)
+  );
+  const units = chars.map(
+    (ch) => gsm ? GSM_EXTENDED.includes(ch) ? 2 : 1 : ch.length
+  );
+  const length = units.reduce((sum, n) => sum + n, 0);
+  const [single, multi] = gsm ? [160, 153] : [70, 67];
+  const encoding = gsm ? "GSM-7" : "UCS-2";
+  if (length <= single)
+    return { encoding, length, segments: length ? 1 : 0, perSegment: single };
+  let segments = 1;
+  let used = 0;
+  for (const n of units) {
+    if (used + n > multi) {
+      segments += 1;
+      used = 0;
+    }
+    used += n;
+  }
+  return { encoding, length, segments, perSegment: multi };
+}
+var CYRILLIC = {
+  \u0430: "a",
+  \u0431: "b",
+  \u0432: "v",
+  \u0433: "g",
+  \u0434: "d",
+  \u0435: "ye",
+  \u0451: "yo",
+  \u0436: "j",
+  \u0437: "z",
+  \u0438: "i",
+  \u0439: "i",
+  \u043A: "k",
+  \u043B: "l",
+  \u043C: "m",
+  \u043D: "n",
+  \u043E: "o",
+  \u04E9: "u",
+  \u043F: "p",
+  \u0440: "r",
+  \u0441: "s",
+  \u0442: "t",
+  \u0443: "u",
+  \u04AF: "u",
+  \u0444: "f",
+  \u0445: "h",
+  \u0446: "ts",
+  \u0447: "ch",
+  \u0448: "sh",
+  \u0449: "sh",
+  \u044A: "",
+  \u044B: "ii",
+  \u044C: "i",
+  \u044D: "e",
+  \u044E: "yu",
+  \u044F: "ya"
+};
+var PUNCTUATION = {
+  "\u201C": '"',
+  "\u201D": '"',
+  "\u201E": '"',
+  "\xAB": '"',
+  "\xBB": '"',
+  "\u2018": "'",
+  "\u2019": "'",
+  "\u2013": "-",
+  "\u2014": "-",
+  "\u2026": "...",
+  "\u2116": "No",
+  "\u20AE": "MNT",
+  "\xA0": " "
+};
+var isUpper = (ch) => ch !== void 0 && ch !== ch.toLowerCase();
+var isLetter = (ch) => ch !== void 0 && ch.toLowerCase() !== ch.toUpperCase();
+function toLatin(text, options = {}) {
+  const map = { ...CYRILLIC, ...PUNCTUATION, ...options.map };
+  const chars = [...text];
+  return chars.map((ch, i) => {
+    const latin = map[ch.toLowerCase()];
+    if (latin === void 0) return ch;
+    if (!isUpper(ch) || latin === "") return latin;
+    const next = chars[i + 1];
+    const shouting = isUpper(next) || !isLetter(next) && isUpper(chars[i - 1]);
+    return shouting ? latin.toUpperCase() : latin.charAt(0).toUpperCase() + latin.slice(1);
+  }).join("");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_TIMEOUT_MS,
+  GMOBILE_ERRORS,
+  SKYTEL_ERRORS,
+  configFromEnv,
+  countSegments,
+  createGmobileGateway,
+  createMobicomGateway,
+  createSkytelGateway,
+  createSmsClient,
+  createUnitelGateway,
+  gatewayFor,
+  normalizePhone,
+  operatorFor,
+  resolveTransport,
+  toLatin
+});