grm-shared-library 1.1.181 → 1.1.183

package/README.md

@@ -1,2 +1,72 @@
-# grm-shared-library
-Common code for GRM
+# grm-shared-library
+
+Common code for GRM — shared types, enums, interfaces, DTOs and constants for the
+Clarion / Upesy backend NestJS microservices.
+
+## Country & Currency (multi-country foundation)
+
+Platform-level primitives for country-aware emergency response, newsfeed,
+notifications, billing, maps and admin. This is the shared source of truth so
+services stop hard-coding Kenya-specific values.
+
+**Supported countries** (ISO 3166-1 alpha-2):
+
+| Code | Country  | Calling code | Currency | Symbol | Decimals | Timezone               | Locale  |
+|------|----------|--------------|----------|--------|----------|------------------------|---------|
+| `KE` | Kenya    | `+254`       | `KES`    | `KSh`  | 2        | `Africa/Nairobi`       | `en-KE` |
+| `UG` | Uganda   | `+256`       | `UGX`    | `USh`  | 0        | `Africa/Kampala`       | `en-UG` |
+| `TZ` | Tanzania | `+255`       | `TZS`    | `TSh`  | 0        | `Africa/Dar_es_Salaam` | `en-TZ` |
+
+**Supported currencies** (ISO 4217): `KES`, `UGX`, `TZS`.
+
+### Importing
+
+Everything is re-exported from the package root:
+
+```ts
+import {
+  CountryCode,
+  CurrencyCode,
+  CallingCode,
+  SupportedCountryConfig,
+  SupportedCurrencyConfig,
+  SUPPORTED_COUNTRIES,          // readonly SupportedCountryConfig[]
+  SUPPORTED_COUNTRIES_BY_CODE,  // Record<CountryCode, SupportedCountryConfig>
+  SUPPORTED_CURRENCIES,
+  SUPPORTED_CURRENCIES_BY_CODE,
+  DEFAULT_COUNTRY_CODE,         // CountryCode.KE
+  DEFAULT_CURRENCY_CODE,        // CurrencyCode.KES
+  CountryScopeDto,              // optional { countryCode?, currencyCode? } request scope
+  getSupportedCountryConfig,
+  getSupportedCurrencyConfig,
+  getCurrencyForCountry,
+  getCallingCodeForCountry,
+  getCountryByCallingCode,
+  isSupportedCountryCode,
+  isSupportedCurrencyCode,
+} from 'grm-shared-library';
+
+getCurrencyForCountry(CountryCode.UG);    // CurrencyCode.UGX
+getCallingCodeForCountry(CountryCode.TZ); // '+255'
+isSupportedCountryCode('US');             // false
+```
+
+### Backward compatibility
+
+**Kenya (`KE` / `KES`) is the default market.** Wherever a country or currency is
+not explicit, fall back to `DEFAULT_COUNTRY_CODE` / `DEFAULT_CURRENCY_CODE` /
+`DEFAULT_TIMEZONE` / `DEFAULT_LOCALE`. Existing Kenyan users, packages, posts,
+incidents, OTPs, notifications and billing flows are unaffected.
+
+### Scope
+
+This package provides the country/currency **primitives only**. Country
+detection (GPS / IP / phone-number inference) and country-aware business logic
+(phone login, newsfeed filtering, multi-currency billing, SMS routing, map
+filtering) are delivered in later phases and should build on top of these types.
+
+### Tests
+
+```bash
+npm test   # compiles src/modules/country and runs the country/currency suite
+```

package/dist/cjs/index.js

@@ -31,7 +31,9 @@ __exportStar(require("./modules/sms/index"), exports);
 __exportStar(require("./modules/gis/index"), exports);
 __exportStar(require("./modules/socket/index"), exports);
 __exportStar(require("./modules/web-notification/index"), exports);
+__exportStar(require("./modules/notification/index"), exports);
 __exportStar(require("./modules/chat/index"), exports);
+__exportStar(require("./modules/country/index"), exports);
 // Interfaces
 __exportStar(require("./interfaces/server-message"), exports);
 __exportStar(require("./interfaces/i-request-with-user"), exports);

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,UAAU;AACV,uDAAqC;AACrC,+DAA6C;AAC7C,yDAAuC;AACvC,6DAA2C;AAC3C,uDAAqC;AACrC,uDAAqC;AACrC,iEAA+C;AAC/C,wDAAsC;AACtC,gEAA8C;AAC9C,2DAAyC;AACzC,2DAAyC;AACzC,sDAAoC;AACpC,sDAAoC;AACpC,sDAAoC;AACpC,yDAAuC;AACvC,mEAAiD;AACjD,uDAAqC;AAErC,aAAa;AACb,8DAA4C;AAC5C,mEAAiD;AACjD,8DAA4C;AAC5C,2DAAyC;AACzC,0DAAwC;AAExC,YAAY;AACZ,2DAAyC;AAEzC,QAAQ;AACR,gDAA8B;AAE9B,YAAY;AACZ,+DAA6C;AAC7C,wFAAsE;AAEtE,aAAa;AACb,qDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,UAAU;AACV,uDAAqC;AACrC,+DAA6C;AAC7C,yDAAuC;AACvC,6DAA2C;AAC3C,uDAAqC;AACrC,uDAAqC;AACrC,iEAA+C;AAC/C,wDAAsC;AACtC,gEAA8C;AAC9C,2DAAyC;AACzC,2DAAyC;AACzC,sDAAoC;AACpC,sDAAoC;AACpC,sDAAoC;AACpC,yDAAuC;AACvC,mEAAiD;AACjD,+DAA6C;AAC7C,uDAAqC;AACrC,0DAAwC;AAExC,aAAa;AACb,8DAA4C;AAC5C,mEAAiD;AACjD,8DAA4C;AAC5C,2DAAyC;AACzC,0DAAwC;AAExC,YAAY;AACZ,2DAAyC;AAEzC,QAAQ;AACR,gDAA8B;AAE9B,YAAY;AACZ,+DAA6C;AAC7C,wFAAsE;AAEtE,aAAa;AACb,qDAAmC"}

package/dist/cjs/modules/country/constants/country-defaults.const.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_LOCALE = exports.DEFAULT_TIMEZONE = exports.DEFAULT_CALLING_CODE = exports.DEFAULT_CURRENCY_CODE = exports.DEFAULT_COUNTRY_CODE = void 0;
+const calling_code_enum_1 = require("../enums/calling-code.enum");
+const country_code_enum_1 = require("../enums/country-code.enum");
+const currency_code_enum_1 = require("../enums/currency-code.enum");
+/**
+ * Platform defaults.
+ *
+ * Kenya remains the default / backward-compatible market: existing users,
+ * packages, posts, incidents, OTPs, notifications and billing flows continue
+ * to behave exactly as they did before multi-country support was introduced.
+ * Use these constants wherever a country/currency is not (yet) explicit.
+ */
+exports.DEFAULT_COUNTRY_CODE = country_code_enum_1.CountryCode.KE;
+exports.DEFAULT_CURRENCY_CODE = currency_code_enum_1.CurrencyCode.KES;
+exports.DEFAULT_CALLING_CODE = calling_code_enum_1.CallingCode.KE;
+exports.DEFAULT_TIMEZONE = 'Africa/Nairobi';
+exports.DEFAULT_LOCALE = 'en-KE';
+//# sourceMappingURL=country-defaults.const.js.map

package/dist/cjs/modules/country/constants/country-defaults.const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"country-defaults.const.js","sourceRoot":"","sources":["../../../../../src/modules/country/constants/country-defaults.const.ts"],"names":[],"mappings":";;;AAAA,kEAAyD;AACzD,kEAAyD;AACzD,oEAA2D;AAE3D;;;;;;;GAOG;AACU,QAAA,oBAAoB,GAAgB,+BAAW,CAAC,EAAE,CAAC;AACnD,QAAA,qBAAqB,GAAiB,iCAAY,CAAC,GAAG,CAAC;AACvD,QAAA,oBAAoB,GAAW,+BAAW,CAAC,EAAE,CAAC;AAC9C,QAAA,gBAAgB,GAAG,gBAAgB,CAAC;AACpC,QAAA,cAAc,GAAG,OAAO,CAAC"}

package/dist/cjs/modules/country/constants/supported-countries.const.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUPPORTED_COUNTRIES = exports.SUPPORTED_COUNTRIES_BY_CODE = void 0;
+const calling_code_enum_1 = require("../enums/calling-code.enum");
+const country_code_enum_1 = require("../enums/country-code.enum");
+const currency_code_enum_1 = require("../enums/currency-code.enum");
+/**
+ * Supported countries keyed by ISO 3166-1 alpha-2 code (source of truth,
+ * O(1) lookup).
+ *
+ * The `Record<CountryCode, ...>` typing enforces at compile time that every
+ * country code has a configuration entry. Map centers are the capital cities;
+ * bounds are approximate country bounding boxes and can be refined later.
+ */
+exports.SUPPORTED_COUNTRIES_BY_CODE = {
+    [country_code_enum_1.CountryCode.KE]: {
+        code: country_code_enum_1.CountryCode.KE,
+        name: 'Kenya',
+        callingCode: calling_code_enum_1.CallingCode.KE,
+        currencyCode: currency_code_enum_1.CurrencyCode.KES,
+        currencySymbol: 'KSh',
+        currencyDecimalPlaces: 2,
+        timezone: 'Africa/Nairobi',
+        defaultLocale: 'en-KE',
+        googleMapsRegion: 'KE',
+        defaultMapCenter: { lat: -1.2921, lng: 36.8219 }, // Nairobi
+        defaultMapZoom: 6,
+        mapBounds: { north: 5.019, south: -4.72, east: 41.899, west: 33.909 },
+        enabled: true,
+    },
+    [country_code_enum_1.CountryCode.UG]: {
+        code: country_code_enum_1.CountryCode.UG,
+        name: 'Uganda',
+        callingCode: calling_code_enum_1.CallingCode.UG,
+        currencyCode: currency_code_enum_1.CurrencyCode.UGX,
+        currencySymbol: 'USh',
+        currencyDecimalPlaces: 0,
+        timezone: 'Africa/Kampala',
+        defaultLocale: 'en-UG',
+        googleMapsRegion: 'UG',
+        defaultMapCenter: { lat: 0.3476, lng: 32.5825 }, // Kampala
+        defaultMapZoom: 6,
+        mapBounds: { north: 4.234, south: -1.482, east: 35.036, west: 29.573 },
+        enabled: true,
+    },
+    [country_code_enum_1.CountryCode.TZ]: {
+        code: country_code_enum_1.CountryCode.TZ,
+        name: 'Tanzania',
+        callingCode: calling_code_enum_1.CallingCode.TZ,
+        currencyCode: currency_code_enum_1.CurrencyCode.TZS,
+        currencySymbol: 'TSh',
+        currencyDecimalPlaces: 0,
+        timezone: 'Africa/Dar_es_Salaam',
+        defaultLocale: 'en-TZ',
+        googleMapsRegion: 'TZ',
+        defaultMapCenter: { lat: -6.7924, lng: 39.2083 }, // Dar es Salaam
+        defaultMapZoom: 6,
+        mapBounds: { north: -0.984, south: -11.761, east: 40.444, west: 29.327 },
+        enabled: true,
+    },
+};
+/** Supported countries as an array (convenient for iteration / pickers). */
+exports.SUPPORTED_COUNTRIES = Object.values(exports.SUPPORTED_COUNTRIES_BY_CODE);
+//# sourceMappingURL=supported-countries.const.js.map

package/dist/cjs/modules/country/constants/supported-countries.const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supported-countries.const.js","sourceRoot":"","sources":["../../../../../src/modules/country/constants/supported-countries.const.ts"],"names":[],"mappings":";;;AAAA,kEAAyD;AACzD,kEAAyD;AACzD,oEAA2D;AAG3D;;;;;;;GAOG;AACU,QAAA,2BAA2B,GAA0D;IAC9F,CAAC,+BAAW,CAAC,EAAE,CAAC,EAAE;QACd,IAAI,EAAE,+BAAW,CAAC,EAAE;QACpB,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,+BAAW,CAAC,EAAE;QAC3B,YAAY,EAAE,iCAAY,CAAC,GAAG;QAC9B,cAAc,EAAE,KAAK;QACrB,qBAAqB,EAAE,CAAC;QACxB,QAAQ,EAAE,gBAAgB;QAC1B,aAAa,EAAE,OAAO;QACtB,gBAAgB,EAAE,IAAI;QACtB,gBAAgB,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,UAAU;QAC5D,cAAc,EAAE,CAAC;QACjB,SAAS,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;QACrE,OAAO,EAAE,IAAI;KAChB;IACD,CAAC,+BAAW,CAAC,EAAE,CAAC,EAAE;QACd,IAAI,EAAE,+BAAW,CAAC,EAAE;QACpB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,+BAAW,CAAC,EAAE;QAC3B,YAAY,EAAE,iCAAY,CAAC,GAAG;QAC9B,cAAc,EAAE,KAAK;QACrB,qBAAqB,EAAE,CAAC;QACxB,QAAQ,EAAE,gBAAgB;QAC1B,aAAa,EAAE,OAAO;QACtB,gBAAgB,EAAE,IAAI;QACtB,gBAAgB,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,UAAU;QAC3D,cAAc,EAAE,CAAC;QACjB,SAAS,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;QACtE,OAAO,EAAE,IAAI;KAChB;IACD,CAAC,+BAAW,CAAC,EAAE,CAAC,EAAE;QACd,IAAI,EAAE,+BAAW,CAAC,EAAE;QACpB,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,+BAAW,CAAC,EAAE;QAC3B,YAAY,EAAE,iCAAY,CAAC,GAAG;QAC9B,cAAc,EAAE,KAAK;QACrB,qBAAqB,EAAE,CAAC;QACxB,QAAQ,EAAE,sBAAsB;QAChC,aAAa,EAAE,OAAO;QACtB,gBAAgB,EAAE,IAAI;QACtB,gBAAgB,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,gBAAgB;QAClE,cAAc,EAAE,CAAC;QACjB,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;QACxE,OAAO,EAAE,IAAI;KAChB;CACJ,CAAC;AAEF,4EAA4E;AAC/D,QAAA,mBAAmB,GAC5B,MAAM,CAAC,MAAM,CAAC,mCAA2B,CAAC,CAAC"}

package/dist/cjs/modules/country/constants/supported-currencies.const.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUPPORTED_CURRENCIES = exports.SUPPORTED_CURRENCIES_BY_CODE = void 0;
+const currency_code_enum_1 = require("../enums/currency-code.enum");
+/**
+ * Supported currencies keyed by ISO 4217 code (source of truth, O(1) lookup).
+ *
+ * The `Record<CurrencyCode, ...>` typing enforces at compile time that every
+ * currency code has a configuration entry.
+ */
+exports.SUPPORTED_CURRENCIES_BY_CODE = {
+    [currency_code_enum_1.CurrencyCode.KES]: {
+        code: currency_code_enum_1.CurrencyCode.KES,
+        name: 'Kenyan Shilling',
+        symbol: 'KSh',
+        decimalPlaces: 2,
+        enabled: true,
+    },
+    [currency_code_enum_1.CurrencyCode.UGX]: {
+        code: currency_code_enum_1.CurrencyCode.UGX,
+        name: 'Ugandan Shilling',
+        symbol: 'USh',
+        decimalPlaces: 0,
+        enabled: true,
+    },
+    [currency_code_enum_1.CurrencyCode.TZS]: {
+        code: currency_code_enum_1.CurrencyCode.TZS,
+        name: 'Tanzanian Shilling',
+        symbol: 'TSh',
+        decimalPlaces: 0,
+        enabled: true,
+    },
+};
+/** Supported currencies as an array (convenient for iteration / pickers). */
+exports.SUPPORTED_CURRENCIES = Object.values(exports.SUPPORTED_CURRENCIES_BY_CODE);
+//# sourceMappingURL=supported-currencies.const.js.map

package/dist/cjs/modules/country/constants/supported-currencies.const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supported-currencies.const.js","sourceRoot":"","sources":["../../../../../src/modules/country/constants/supported-currencies.const.ts"],"names":[],"mappings":";;;AAAA,oEAA2D;AAG3D;;;;;GAKG;AACU,QAAA,4BAA4B,GAA4D;IACjG,CAAC,iCAAY,CAAC,GAAG,CAAC,EAAE;QAChB,IAAI,EAAE,iCAAY,CAAC,GAAG;QACtB,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,KAAK;QACb,aAAa,EAAE,CAAC;QAChB,OAAO,EAAE,IAAI;KAChB;IACD,CAAC,iCAAY,CAAC,GAAG,CAAC,EAAE;QAChB,IAAI,EAAE,iCAAY,CAAC,GAAG;QACtB,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,KAAK;QACb,aAAa,EAAE,CAAC;QAChB,OAAO,EAAE,IAAI;KAChB;IACD,CAAC,iCAAY,CAAC,GAAG,CAAC,EAAE;QAChB,IAAI,EAAE,iCAAY,CAAC,GAAG;QACtB,IAAI,EAAE,oBAAoB;QAC1B,MAAM,EAAE,KAAK;QACb,aAAa,EAAE,CAAC;QAChB,OAAO,EAAE,IAAI;KAChB;CACJ,CAAC;AAEF,6EAA6E;AAChE,QAAA,oBAAoB,GAC7B,MAAM,CAAC,MAAM,CAAC,oCAA4B,CAAC,CAAC"}

package/dist/cjs/modules/country/dtos/country-scope.dto.js

@@ -0,0 +1,47 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CountryScopeDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+const country_code_enum_1 = require("../enums/country-code.enum");
+const currency_code_enum_1 = require("../enums/currency-code.enum");
+/**
+ * Reusable, optional country/currency scope for requests and queries.
+ *
+ * Compose or extend this into country-aware DTOs (newsfeed posts, service
+ * packages, billing queries, ...). Both fields are optional so existing
+ * single-country (Kenya) requests remain valid without any change.
+ */
+class CountryScopeDto {
+}
+exports.CountryScopeDto = CountryScopeDto;
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'ISO 3166-1 alpha-2 country code the request is scoped to',
+        enum: country_code_enum_1.CountryCode,
+        example: country_code_enum_1.CountryCode.KE,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(country_code_enum_1.CountryCode),
+    __metadata("design:type", String)
+], CountryScopeDto.prototype, "countryCode", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'ISO 4217 currency code the request is scoped to',
+        enum: currency_code_enum_1.CurrencyCode,
+        example: currency_code_enum_1.CurrencyCode.KES,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(currency_code_enum_1.CurrencyCode),
+    __metadata("design:type", String)
+], CountryScopeDto.prototype, "currencyCode", void 0);
+//# sourceMappingURL=country-scope.dto.js.map

package/dist/cjs/modules/country/dtos/country-scope.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"country-scope.dto.js","sourceRoot":"","sources":["../../../../../src/modules/country/dtos/country-scope.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAsD;AACtD,qDAAqD;AACrD,kEAAyD;AACzD,oEAA2D;AAE3D;;;;;;GAMG;AACH,MAAa,eAAe;CAkB3B;AAlBD,0CAkBC;AAVG;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,0DAA0D;QACvE,IAAI,EAAE,+BAAW;QACjB,OAAO,EAAE,+BAAW,CAAC,EAAE;KAC1B,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAM,EAAC,+BAAW,CAAC;;oDACM;AAS1B;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,iDAAiD;QAC9D,IAAI,EAAE,iCAAY;QAClB,OAAO,EAAE,iCAAY,CAAC,GAAG;KAC5B,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAM,EAAC,iCAAY,CAAC;;qDACO"}

package/dist/cjs/modules/country/enums/calling-code.enum.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CallingCode = void 0;
+/**
+ * E.164 country calling codes, keyed by ISO 3166-1 alpha-2 country code.
+ *
+ * Kept as a string enum so the value (e.g. '+254') can be used directly when
+ * composing phone numbers, and the key (e.g. KE) aligns with {@link CountryCode}.
+ */
+var CallingCode;
+(function (CallingCode) {
+    /** Kenya */
+    CallingCode["KE"] = "+254";
+    /** Uganda */
+    CallingCode["UG"] = "+256";
+    /** Tanzania */
+    CallingCode["TZ"] = "+255";
+})(CallingCode || (exports.CallingCode = CallingCode = {}));
+//# sourceMappingURL=calling-code.enum.js.map

package/dist/cjs/modules/country/enums/calling-code.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calling-code.enum.js","sourceRoot":"","sources":["../../../../../src/modules/country/enums/calling-code.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,IAAY,WAOX;AAPD,WAAY,WAAW;IACnB,YAAY;IACZ,0BAAW,CAAA;IACX,aAAa;IACb,0BAAW,CAAA;IACX,eAAe;IACf,0BAAW,CAAA;AACf,CAAC,EAPW,WAAW,2BAAX,WAAW,QAOtB"}

package/dist/cjs/modules/country/enums/country-code.enum.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CountryCode = void 0;
+/**
+ * Supported country codes.
+ *
+ * ISO 3166-1 alpha-2 country codes. These are the platform-level identifiers
+ * for every country the Clarion / Upesy platform operates in.
+ *
+ * Kenya (KE) is the default/backward-compatible market.
+ */
+var CountryCode;
+(function (CountryCode) {
+    /** Kenya */
+    CountryCode["KE"] = "KE";
+    /** Uganda */
+    CountryCode["UG"] = "UG";
+    /** Tanzania */
+    CountryCode["TZ"] = "TZ";
+})(CountryCode || (exports.CountryCode = CountryCode = {}));
+//# sourceMappingURL=country-code.enum.js.map

package/dist/cjs/modules/country/enums/country-code.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"country-code.enum.js","sourceRoot":"","sources":["../../../../../src/modules/country/enums/country-code.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,IAAY,WAOX;AAPD,WAAY,WAAW;IACnB,YAAY;IACZ,wBAAS,CAAA;IACT,aAAa;IACb,wBAAS,CAAA;IACT,eAAe;IACf,wBAAS,CAAA;AACb,CAAC,EAPW,WAAW,2BAAX,WAAW,QAOtB"}

package/dist/cjs/modules/country/enums/currency-code.enum.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CurrencyCode = void 0;
+/**
+ * Supported currency codes.
+ *
+ * ISO 4217 currency codes for the markets the platform operates in.
+ *
+ * KES (Kenyan Shilling) is the default/backward-compatible currency.
+ */
+var CurrencyCode;
+(function (CurrencyCode) {
+    /** Kenyan Shilling */
+    CurrencyCode["KES"] = "KES";
+    /** Ugandan Shilling */
+    CurrencyCode["UGX"] = "UGX";
+    /** Tanzanian Shilling */
+    CurrencyCode["TZS"] = "TZS";
+})(CurrencyCode || (exports.CurrencyCode = CurrencyCode = {}));
+//# sourceMappingURL=currency-code.enum.js.map

package/dist/cjs/modules/country/enums/currency-code.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency-code.enum.js","sourceRoot":"","sources":["../../../../../src/modules/country/enums/currency-code.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,IAAY,YAOX;AAPD,WAAY,YAAY;IACpB,sBAAsB;IACtB,2BAAW,CAAA;IACX,uBAAuB;IACvB,2BAAW,CAAA;IACX,yBAAyB;IACzB,2BAAW,CAAA;AACf,CAAC,EAPW,YAAY,4BAAZ,YAAY,QAOvB"}

package/dist/cjs/modules/country/index.js

@@ -0,0 +1,34 @@
+"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 });
+// Enums
+__exportStar(require("./enums/country-code.enum"), exports);
+__exportStar(require("./enums/currency-code.enum"), exports);
+__exportStar(require("./enums/calling-code.enum"), exports);
+// Interfaces
+__exportStar(require("./interfaces/geo-coordinates"), exports);
+__exportStar(require("./interfaces/map-bounds"), exports);
+__exportStar(require("./interfaces/supported-currency-config"), exports);
+__exportStar(require("./interfaces/supported-country-config"), exports);
+// Constants
+__exportStar(require("./constants/supported-currencies.const"), exports);
+__exportStar(require("./constants/supported-countries.const"), exports);
+__exportStar(require("./constants/country-defaults.const"), exports);
+// DTOs
+__exportStar(require("./dtos/country-scope.dto"), exports);
+// Utilities
+__exportStar(require("./utils/country.util"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/modules/country/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/country/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,QAAQ;AACR,4DAA0C;AAC1C,6DAA2C;AAC3C,4DAA0C;AAE1C,aAAa;AACb,+DAA6C;AAC7C,0DAAwC;AACxC,yEAAuD;AACvD,wEAAsD;AAEtD,YAAY;AACZ,yEAAuD;AACvD,wEAAsD;AACtD,qEAAmD;AAEnD,OAAO;AACP,2DAAyC;AAEzC,YAAY;AACZ,uDAAqC"}

package/dist/cjs/modules/country/interfaces/geo-coordinates.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=geo-coordinates.js.map

package/dist/cjs/modules/country/interfaces/geo-coordinates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo-coordinates.js","sourceRoot":"","sources":["../../../../../src/modules/country/interfaces/geo-coordinates.ts"],"names":[],"mappings":""}

package/dist/cjs/modules/country/interfaces/map-bounds.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=map-bounds.js.map

package/dist/cjs/modules/country/interfaces/map-bounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-bounds.js","sourceRoot":"","sources":["../../../../../src/modules/country/interfaces/map-bounds.ts"],"names":[],"mappings":""}

package/dist/cjs/modules/country/interfaces/supported-country-config.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=supported-country-config.js.map

package/dist/cjs/modules/country/interfaces/supported-country-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supported-country-config.js","sourceRoot":"","sources":["../../../../../src/modules/country/interfaces/supported-country-config.ts"],"names":[],"mappings":""}

package/dist/cjs/modules/country/interfaces/supported-currency-config.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=supported-currency-config.js.map

package/dist/cjs/modules/country/interfaces/supported-currency-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supported-currency-config.js","sourceRoot":"","sources":["../../../../../src/modules/country/interfaces/supported-currency-config.ts"],"names":[],"mappings":""}

package/dist/cjs/modules/country/utils/country.util.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSupportedCountryCode = isSupportedCountryCode;
+exports.isSupportedCurrencyCode = isSupportedCurrencyCode;
+exports.getSupportedCountryConfig = getSupportedCountryConfig;
+exports.getSupportedCurrencyConfig = getSupportedCurrencyConfig;
+exports.getCurrencyForCountry = getCurrencyForCountry;
+exports.getCallingCodeForCountry = getCallingCodeForCountry;
+exports.getCountryByCallingCode = getCountryByCallingCode;
+const supported_countries_const_1 = require("../constants/supported-countries.const");
+const supported_currencies_const_1 = require("../constants/supported-currencies.const");
+/**
+ * Country / currency helper utilities.
+ *
+ * These are intentionally simple, synchronous and dependency-free so they can
+ * be reused across every backend microservice without pulling in extra deps.
+ */
+/** Type guard: is `value` a supported ISO 3166-1 alpha-2 country code? */
+function isSupportedCountryCode(value) {
+    return (typeof value === 'string' &&
+        Object.prototype.hasOwnProperty.call(supported_countries_const_1.SUPPORTED_COUNTRIES_BY_CODE, value));
+}
+/** Type guard: is `value` a supported ISO 4217 currency code? */
+function isSupportedCurrencyCode(value) {
+    return (typeof value === 'string' &&
+        Object.prototype.hasOwnProperty.call(supported_currencies_const_1.SUPPORTED_CURRENCIES_BY_CODE, value));
+}
+/** Get the full config for a supported country, or `undefined` if unsupported. */
+function getSupportedCountryConfig(countryCode) {
+    return isSupportedCountryCode(countryCode)
+        ? supported_countries_const_1.SUPPORTED_COUNTRIES_BY_CODE[countryCode]
+        : undefined;
+}
+/** Get the full config for a supported currency, or `undefined` if unsupported. */
+function getSupportedCurrencyConfig(currencyCode) {
+    return isSupportedCurrencyCode(currencyCode)
+        ? supported_currencies_const_1.SUPPORTED_CURRENCIES_BY_CODE[currencyCode]
+        : undefined;
+}
+/** Resolve the currency used by a supported country, or `undefined`. */
+function getCurrencyForCountry(countryCode) {
+    var _a;
+    return (_a = getSupportedCountryConfig(countryCode)) === null || _a === void 0 ? void 0 : _a.currencyCode;
+}
+/** Resolve the E.164 calling code (e.g. '+254') for a supported country, or `undefined`. */
+function getCallingCodeForCountry(countryCode) {
+    var _a;
+    return (_a = getSupportedCountryConfig(countryCode)) === null || _a === void 0 ? void 0 : _a.callingCode;
+}
+/**
+ * Reverse lookup: find the supported country whose E.164 calling code matches
+ * `callingCode` (e.g. '+254' -> Kenya), or `undefined` if none match.
+ */
+function getCountryByCallingCode(callingCode) {
+    if (!callingCode) {
+        return undefined;
+    }
+    return supported_countries_const_1.SUPPORTED_COUNTRIES.find((country) => country.callingCode === callingCode);
+}
+//# sourceMappingURL=country.util.js.map

package/dist/cjs/modules/country/utils/country.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"country.util.js","sourceRoot":"","sources":["../../../../../src/modules/country/utils/country.util.ts"],"names":[],"mappings":";;AAeA,wDAKC;AAGD,0DAKC;AAGD,8DAMC;AAGD,gEAMC;AAGD,sDAIC;AAGD,4DAIC;AAMD,0DAOC;AAzED,sFAA0G;AAC1G,wFAAuF;AAMvF;;;;;GAKG;AAEH,0EAA0E;AAC1E,SAAgB,sBAAsB,CAAC,KAAc;IACjD,OAAO,CACH,OAAO,KAAK,KAAK,QAAQ;QACzB,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,uDAA2B,EAAE,KAAK,CAAC,CAC3E,CAAC;AACN,CAAC;AAED,iEAAiE;AACjE,SAAgB,uBAAuB,CAAC,KAAc;IAClD,OAAO,CACH,OAAO,KAAK,KAAK,QAAQ;QACzB,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,yDAA4B,EAAE,KAAK,CAAC,CAC5E,CAAC;AACN,CAAC;AAED,kFAAkF;AAClF,SAAgB,yBAAyB,CACrC,WAAsC;IAEtC,OAAO,sBAAsB,CAAC,WAAW,CAAC;QACtC,CAAC,CAAC,uDAA2B,CAAC,WAAW,CAAC;QAC1C,CAAC,CAAC,SAAS,CAAC;AACpB,CAAC;AAED,mFAAmF;AACnF,SAAgB,0BAA0B,CACtC,YAAuC;IAEvC,OAAO,uBAAuB,CAAC,YAAY,CAAC;QACxC,CAAC,CAAC,yDAA4B,CAAC,YAAY,CAAC;QAC5C,CAAC,CAAC,SAAS,CAAC;AACpB,CAAC;AAED,wEAAwE;AACxE,SAAgB,qBAAqB,CACjC,WAAsC;;IAEtC,OAAO,MAAA,yBAAyB,CAAC,WAAW,CAAC,0CAAE,YAAY,CAAC;AAChE,CAAC;AAED,4FAA4F;AAC5F,SAAgB,wBAAwB,CACpC,WAAsC;;IAEtC,OAAO,MAAA,yBAAyB,CAAC,WAAW,CAAC,0CAAE,WAAW,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,SAAgB,uBAAuB,CACnC,WAAsC;IAEtC,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,OAAO,+CAAmB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC;AACtF,CAAC"}

package/dist/cjs/modules/notification/enums/email-provider-name.enum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailProviderName = void 0;
+/**
+ * Identifiers for the email providers the notification service can dispatch through.
+ * TWILIO_SENDGRID is the Twilio email provider (SendGrid API).
+ * Provider order/fallback is configuration-driven; new providers can be appended.
+ */
+var EmailProviderName;
+(function (EmailProviderName) {
+    EmailProviderName["TWILIO_SENDGRID"] = "twilio_sendgrid";
+    EmailProviderName["MAILGUN"] = "mailgun";
+    EmailProviderName["SES"] = "ses";
+})(EmailProviderName || (exports.EmailProviderName = EmailProviderName = {}));
+//# sourceMappingURL=email-provider-name.enum.js.map

package/dist/cjs/modules/notification/enums/email-provider-name.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-provider-name.enum.js","sourceRoot":"","sources":["../../../../../src/modules/notification/enums/email-provider-name.enum.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IACzB,wDAAmC,CAAA;IACnC,wCAAmB,CAAA;IACnB,gCAAW,CAAA;AACf,CAAC,EAJW,iBAAiB,iCAAjB,iBAAiB,QAI5B"}

package/dist/cjs/modules/notification/enums/notification-channel.enum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationChannel = void 0;
+/**
+ * Delivery channels supported by the clarion-notification service.
+ * Used to key per-channel dispatch results.
+ */
+var NotificationChannel;
+(function (NotificationChannel) {
+    NotificationChannel["SMS"] = "SMS";
+    NotificationChannel["EMAIL"] = "EMAIL";
+    NotificationChannel["PUSH"] = "PUSH";
+    NotificationChannel["WEB"] = "WEB";
+})(NotificationChannel || (exports.NotificationChannel = NotificationChannel = {}));
+//# sourceMappingURL=notification-channel.enum.js.map

package/dist/cjs/modules/notification/enums/notification-channel.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-channel.enum.js","sourceRoot":"","sources":["../../../../../src/modules/notification/enums/notification-channel.enum.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC3B,kCAAW,CAAA;IACX,sCAAe,CAAA;IACf,oCAAa,CAAA;IACb,kCAAW,CAAA;AACf,CAAC,EALW,mBAAmB,mCAAnB,mBAAmB,QAK9B"}

package/dist/cjs/modules/notification/enums/notification-overall-status.enum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationOverallStatus = void 0;
+/**
+ * Aggregate status for a multi-channel notification dispatch.
+ * - SUCCESS: every attempted channel succeeded.
+ * - PARTIAL_SUCCESS: at least one channel succeeded and at least one failed.
+ * - FAILED: no attempted channel succeeded.
+ */
+var NotificationOverallStatus;
+(function (NotificationOverallStatus) {
+    NotificationOverallStatus["SUCCESS"] = "SUCCESS";
+    NotificationOverallStatus["PARTIAL_SUCCESS"] = "PARTIAL_SUCCESS";
+    NotificationOverallStatus["FAILED"] = "FAILED";
+})(NotificationOverallStatus || (exports.NotificationOverallStatus = NotificationOverallStatus = {}));
+//# sourceMappingURL=notification-overall-status.enum.js.map

package/dist/cjs/modules/notification/enums/notification-overall-status.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-overall-status.enum.js","sourceRoot":"","sources":["../../../../../src/modules/notification/enums/notification-overall-status.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,IAAY,yBAIX;AAJD,WAAY,yBAAyB;IACjC,gDAAmB,CAAA;IACnB,gEAAmC,CAAA;IACnC,8CAAiB,CAAA;AACrB,CAAC,EAJW,yBAAyB,yCAAzB,yBAAyB,QAIpC"}

package/dist/cjs/modules/notification/enums/provider-failure-reason.enum.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderFailureReason = void 0;
+/**
+ * Normalized classification of why a provider attempt failed.
+ * Drives fallback behaviour: VALIDATION / CONFIG_MISSING are non-retryable
+ * (no fallback), the remainder are provider-level failures that trigger fallback.
+ */
+var ProviderFailureReason;
+(function (ProviderFailureReason) {
+    /** Malformed/invalid request (bad recipient, missing body/subject). Do not fall back. */
+    ProviderFailureReason["VALIDATION"] = "VALIDATION";
+    /** Provider is not configured/enabled. Skip provider (try next), not a send failure. */
+    ProviderFailureReason["CONFIG_MISSING"] = "CONFIG_MISSING";
+    /** Authentication/authorization failure with the provider. */
+    ProviderFailureReason["AUTH"] = "AUTH";
+    /** Provider rate limited the request. */
+    ProviderFailureReason["RATE_LIMIT"] = "RATE_LIMIT";
+    /** Request timed out. */
+    ProviderFailureReason["TIMEOUT"] = "TIMEOUT";
+    /** Network/connection error reaching the provider. */
+    ProviderFailureReason["NETWORK"] = "NETWORK";
+    /** Provider returned a server-side/processing error. */
+    ProviderFailureReason["PROVIDER_ERROR"] = "PROVIDER_ERROR";
+    /** Unclassified failure. */
+    ProviderFailureReason["UNKNOWN"] = "UNKNOWN";
+})(ProviderFailureReason || (exports.ProviderFailureReason = ProviderFailureReason = {}));
+//# sourceMappingURL=provider-failure-reason.enum.js.map

package/dist/cjs/modules/notification/enums/provider-failure-reason.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-failure-reason.enum.js","sourceRoot":"","sources":["../../../../../src/modules/notification/enums/provider-failure-reason.enum.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,IAAY,qBAiBX;AAjBD,WAAY,qBAAqB;IAC7B,yFAAyF;IACzF,kDAAyB,CAAA;IACzB,wFAAwF;IACxF,0DAAiC,CAAA;IACjC,8DAA8D;IAC9D,sCAAa,CAAA;IACb,yCAAyC;IACzC,kDAAyB,CAAA;IACzB,yBAAyB;IACzB,4CAAmB,CAAA;IACnB,sDAAsD;IACtD,4CAAmB,CAAA;IACnB,wDAAwD;IACxD,0DAAiC,CAAA;IACjC,4BAA4B;IAC5B,4CAAmB,CAAA;AACvB,CAAC,EAjBW,qBAAqB,qCAArB,qBAAqB,QAiBhC"}

package/dist/cjs/modules/notification/enums/sms-provider-name.enum.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SmsProviderName = void 0;
+/**
+ * Identifiers for the SMS providers the notification service can dispatch through.
+ * Provider order/fallback is configuration-driven; new providers can be appended.
+ */
+var SmsProviderName;
+(function (SmsProviderName) {
+    SmsProviderName["TWILIO"] = "twilio";
+    SmsProviderName["UWAZII"] = "uwazii";
+    SmsProviderName["AFRICASTALKING"] = "africastalking";
+})(SmsProviderName || (exports.SmsProviderName = SmsProviderName = {}));
+//# sourceMappingURL=sms-provider-name.enum.js.map

package/dist/cjs/modules/notification/enums/sms-provider-name.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sms-provider-name.enum.js","sourceRoot":"","sources":["../../../../../src/modules/notification/enums/sms-provider-name.enum.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,eAIX;AAJD,WAAY,eAAe;IACvB,oCAAiB,CAAA;IACjB,oCAAiB,CAAA;IACjB,oDAAiC,CAAA;AACrC,CAAC,EAJW,eAAe,+BAAf,eAAe,QAI1B"}