grm-shared-library 1.1.182 → 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

@@ -33,6 +33,7 @@ __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,+DAA6C;AAC7C,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/esm/index.js

@@ -17,6 +17,7 @@ export * from './modules/socket/index';
 export * from './modules/web-notification/index';
 export * from './modules/notification/index';
 export * from './modules/chat/index';
+export * from './modules/country/index';
 // Interfaces
 export * from './interfaces/server-message';
 export * from './interfaces/i-request-with-user';

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AAErC,aAAa;AACb,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AAExC,YAAY;AACZ,cAAc,0BAA0B,CAAC;AAEzC,QAAQ;AACR,cAAc,eAAe,CAAC;AAE9B,YAAY;AACZ,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uDAAuD,CAAC;AAEtE,aAAa;AACb,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AAExC,aAAa;AACb,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AAExC,YAAY;AACZ,cAAc,0BAA0B,CAAC;AAEzC,QAAQ;AACR,cAAc,eAAe,CAAC;AAE9B,YAAY;AACZ,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uDAAuD,CAAC;AAEtE,aAAa;AACb,cAAc,oBAAoB,CAAC"}

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

@@ -0,0 +1,17 @@
+import { CallingCode } from '../enums/calling-code.enum';
+import { CountryCode } from '../enums/country-code.enum';
+import { CurrencyCode } from '../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.
+ */
+export const DEFAULT_COUNTRY_CODE = CountryCode.KE;
+export const DEFAULT_CURRENCY_CODE = CurrencyCode.KES;
+export const DEFAULT_CALLING_CODE = CallingCode.KE;
+export const DEFAULT_TIMEZONE = 'Africa/Nairobi';
+export const DEFAULT_LOCALE = 'en-KE';
+//# sourceMappingURL=country-defaults.const.js.map

package/dist/esm/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,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAgB,WAAW,CAAC,EAAE,CAAC;AAChE,MAAM,CAAC,MAAM,qBAAqB,GAAiB,YAAY,CAAC,GAAG,CAAC;AACpE,MAAM,CAAC,MAAM,oBAAoB,GAAW,WAAW,CAAC,EAAE,CAAC;AAC3D,MAAM,CAAC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AACjD,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC"}

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

@@ -0,0 +1,61 @@
+import { CallingCode } from '../enums/calling-code.enum';
+import { CountryCode } from '../enums/country-code.enum';
+import { CurrencyCode } from '../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.
+ */
+export const SUPPORTED_COUNTRIES_BY_CODE = {
+    [CountryCode.KE]: {
+        code: CountryCode.KE,
+        name: 'Kenya',
+        callingCode: CallingCode.KE,
+        currencyCode: 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,
+    },
+    [CountryCode.UG]: {
+        code: CountryCode.UG,
+        name: 'Uganda',
+        callingCode: CallingCode.UG,
+        currencyCode: 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,
+    },
+    [CountryCode.TZ]: {
+        code: CountryCode.TZ,
+        name: 'Tanzania',
+        callingCode: CallingCode.TZ,
+        currencyCode: 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). */
+export const SUPPORTED_COUNTRIES = Object.values(SUPPORTED_COUNTRIES_BY_CODE);
+//# sourceMappingURL=supported-countries.const.js.map

package/dist/esm/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,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAG3D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAA0D;IAC9F,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE;QACd,IAAI,EAAE,WAAW,CAAC,EAAE;QACpB,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,WAAW,CAAC,EAAE;QAC3B,YAAY,EAAE,YAAY,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,WAAW,CAAC,EAAE,CAAC,EAAE;QACd,IAAI,EAAE,WAAW,CAAC,EAAE;QACpB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,WAAW,CAAC,EAAE;QAC3B,YAAY,EAAE,YAAY,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,WAAW,CAAC,EAAE,CAAC,EAAE;QACd,IAAI,EAAE,WAAW,CAAC,EAAE;QACpB,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,WAAW,CAAC,EAAE;QAC3B,YAAY,EAAE,YAAY,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;AAC5E,MAAM,CAAC,MAAM,mBAAmB,GAC5B,MAAM,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAC"}

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

@@ -0,0 +1,33 @@
+import { CurrencyCode } from '../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.
+ */
+export const SUPPORTED_CURRENCIES_BY_CODE = {
+    [CurrencyCode.KES]: {
+        code: CurrencyCode.KES,
+        name: 'Kenyan Shilling',
+        symbol: 'KSh',
+        decimalPlaces: 2,
+        enabled: true,
+    },
+    [CurrencyCode.UGX]: {
+        code: CurrencyCode.UGX,
+        name: 'Ugandan Shilling',
+        symbol: 'USh',
+        decimalPlaces: 0,
+        enabled: true,
+    },
+    [CurrencyCode.TZS]: {
+        code: CurrencyCode.TZS,
+        name: 'Tanzanian Shilling',
+        symbol: 'TSh',
+        decimalPlaces: 0,
+        enabled: true,
+    },
+};
+/** Supported currencies as an array (convenient for iteration / pickers). */
+export const SUPPORTED_CURRENCIES = Object.values(SUPPORTED_CURRENCIES_BY_CODE);
+//# sourceMappingURL=supported-currencies.const.js.map

package/dist/esm/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,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAG3D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAA4D;IACjG,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE;QAChB,IAAI,EAAE,YAAY,CAAC,GAAG;QACtB,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,KAAK;QACb,aAAa,EAAE,CAAC;QAChB,OAAO,EAAE,IAAI;KAChB;IACD,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE;QAChB,IAAI,EAAE,YAAY,CAAC,GAAG;QACtB,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,KAAK;QACb,aAAa,EAAE,CAAC;QAChB,OAAO,EAAE,IAAI;KAChB;IACD,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE;QAChB,IAAI,EAAE,YAAY,CAAC,GAAG;QACtB,IAAI,EAAE,oBAAoB;QAC1B,MAAM,EAAE,KAAK;QACb,aAAa,EAAE,CAAC;QAChB,OAAO,EAAE,IAAI;KAChB;CACJ,CAAC;AAEF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,oBAAoB,GAC7B,MAAM,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC"}

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

@@ -0,0 +1,43 @@
+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);
+};
+import { ApiPropertyOptional } from '@nestjs/swagger';
+import { IsEnum, IsOptional } from 'class-validator';
+import { CountryCode } from '../enums/country-code.enum';
+import { CurrencyCode } from '../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.
+ */
+export class CountryScopeDto {
+}
+__decorate([
+    ApiPropertyOptional({
+        description: 'ISO 3166-1 alpha-2 country code the request is scoped to',
+        enum: CountryCode,
+        example: CountryCode.KE,
+    }),
+    IsOptional(),
+    IsEnum(CountryCode),
+    __metadata("design:type", String)
+], CountryScopeDto.prototype, "countryCode", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'ISO 4217 currency code the request is scoped to',
+        enum: CurrencyCode,
+        example: CurrencyCode.KES,
+    }),
+    IsOptional(),
+    IsEnum(CurrencyCode),
+    __metadata("design:type", String)
+], CountryScopeDto.prototype, "currencyCode", void 0);
+//# sourceMappingURL=country-scope.dto.js.map

package/dist/esm/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,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;CAkB3B;AAVG;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,0DAA0D;QACvE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,WAAW,CAAC,EAAE;KAC1B,CAAC;IACD,UAAU,EAAE;IACZ,MAAM,CAAC,WAAW,CAAC;;oDACM;AAS1B;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,iDAAiD;QAC9D,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,YAAY,CAAC,GAAG;KAC5B,CAAC;IACD,UAAU,EAAE;IACZ,MAAM,CAAC,YAAY,CAAC;;qDACO"}

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

@@ -0,0 +1,16 @@
+/**
+ * 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}.
+ */
+export var CallingCode;
+(function (CallingCode) {
+    /** Kenya */
+    CallingCode["KE"] = "+254";
+    /** Uganda */
+    CallingCode["UG"] = "+256";
+    /** Tanzania */
+    CallingCode["TZ"] = "+255";
+})(CallingCode || (CallingCode = {}));
+//# sourceMappingURL=calling-code.enum.js.map

package/dist/esm/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,MAAM,CAAN,IAAY,WAOX;AAPD,WAAY,WAAW;IACnB,YAAY;IACZ,0BAAW,CAAA;IACX,aAAa;IACb,0BAAW,CAAA;IACX,eAAe;IACf,0BAAW,CAAA;AACf,CAAC,EAPW,WAAW,KAAX,WAAW,QAOtB"}

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

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+export var CountryCode;
+(function (CountryCode) {
+    /** Kenya */
+    CountryCode["KE"] = "KE";
+    /** Uganda */
+    CountryCode["UG"] = "UG";
+    /** Tanzania */
+    CountryCode["TZ"] = "TZ";
+})(CountryCode || (CountryCode = {}));
+//# sourceMappingURL=country-code.enum.js.map

package/dist/esm/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,MAAM,CAAN,IAAY,WAOX;AAPD,WAAY,WAAW;IACnB,YAAY;IACZ,wBAAS,CAAA;IACT,aAAa;IACb,wBAAS,CAAA;IACT,eAAe;IACf,wBAAS,CAAA;AACb,CAAC,EAPW,WAAW,KAAX,WAAW,QAOtB"}

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

@@ -0,0 +1,17 @@
+/**
+ * Supported currency codes.
+ *
+ * ISO 4217 currency codes for the markets the platform operates in.
+ *
+ * KES (Kenyan Shilling) is the default/backward-compatible currency.
+ */
+export var CurrencyCode;
+(function (CurrencyCode) {
+    /** Kenyan Shilling */
+    CurrencyCode["KES"] = "KES";
+    /** Ugandan Shilling */
+    CurrencyCode["UGX"] = "UGX";
+    /** Tanzanian Shilling */
+    CurrencyCode["TZS"] = "TZS";
+})(CurrencyCode || (CurrencyCode = {}));
+//# sourceMappingURL=currency-code.enum.js.map

package/dist/esm/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,MAAM,CAAN,IAAY,YAOX;AAPD,WAAY,YAAY;IACpB,sBAAsB;IACtB,2BAAW,CAAA;IACX,uBAAuB;IACvB,2BAAW,CAAA;IACX,yBAAyB;IACzB,2BAAW,CAAA;AACf,CAAC,EAPW,YAAY,KAAZ,YAAY,QAOvB"}

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

@@ -0,0 +1,18 @@
+// Enums
+export * from './enums/country-code.enum';
+export * from './enums/currency-code.enum';
+export * from './enums/calling-code.enum';
+// Interfaces
+export * from './interfaces/geo-coordinates';
+export * from './interfaces/map-bounds';
+export * from './interfaces/supported-currency-config';
+export * from './interfaces/supported-country-config';
+// Constants
+export * from './constants/supported-currencies.const';
+export * from './constants/supported-countries.const';
+export * from './constants/country-defaults.const';
+// DTOs
+export * from './dtos/country-scope.dto';
+// Utilities
+export * from './utils/country.util';
+//# sourceMappingURL=index.js.map

package/dist/esm/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,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAE1C,aAAa;AACb,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AAEtD,YAAY;AACZ,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AACtD,cAAc,oCAAoC,CAAC;AAEnD,OAAO;AACP,cAAc,0BAA0B,CAAC;AAEzC,YAAY;AACZ,cAAc,sBAAsB,CAAC"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=geo-coordinates.js.map

package/dist/esm/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/esm/modules/country/interfaces/map-bounds.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=map-bounds.js.map

package/dist/esm/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/esm/modules/country/interfaces/supported-country-config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=supported-country-config.js.map

package/dist/esm/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/esm/modules/country/interfaces/supported-currency-config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=supported-currency-config.js.map

package/dist/esm/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/esm/modules/country/utils/country.util.js

@@ -0,0 +1,51 @@
+import { SUPPORTED_COUNTRIES, SUPPORTED_COUNTRIES_BY_CODE } from '../constants/supported-countries.const';
+import { SUPPORTED_CURRENCIES_BY_CODE } from '../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? */
+export function isSupportedCountryCode(value) {
+    return (typeof value === 'string' &&
+        Object.prototype.hasOwnProperty.call(SUPPORTED_COUNTRIES_BY_CODE, value));
+}
+/** Type guard: is `value` a supported ISO 4217 currency code? */
+export function isSupportedCurrencyCode(value) {
+    return (typeof value === 'string' &&
+        Object.prototype.hasOwnProperty.call(SUPPORTED_CURRENCIES_BY_CODE, value));
+}
+/** Get the full config for a supported country, or `undefined` if unsupported. */
+export function getSupportedCountryConfig(countryCode) {
+    return isSupportedCountryCode(countryCode)
+        ? SUPPORTED_COUNTRIES_BY_CODE[countryCode]
+        : undefined;
+}
+/** Get the full config for a supported currency, or `undefined` if unsupported. */
+export function getSupportedCurrencyConfig(currencyCode) {
+    return isSupportedCurrencyCode(currencyCode)
+        ? SUPPORTED_CURRENCIES_BY_CODE[currencyCode]
+        : undefined;
+}
+/** Resolve the currency used by a supported country, or `undefined`. */
+export 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`. */
+export 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.
+ */
+export function getCountryByCallingCode(callingCode) {
+    if (!callingCode) {
+        return undefined;
+    }
+    return SUPPORTED_COUNTRIES.find((country) => country.callingCode === callingCode);
+}
+//# sourceMappingURL=country.util.js.map

package/dist/esm/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":"AAAA,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AAC1G,OAAO,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AAMvF;;;;;GAKG;AAEH,0EAA0E;AAC1E,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACjD,OAAO,CACH,OAAO,KAAK,KAAK,QAAQ;QACzB,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAC3E,CAAC;AACN,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,uBAAuB,CAAC,KAAc;IAClD,OAAO,CACH,OAAO,KAAK,KAAK,QAAQ;QACzB,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAC5E,CAAC;AACN,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,yBAAyB,CACrC,WAAsC;IAEtC,OAAO,sBAAsB,CAAC,WAAW,CAAC;QACtC,CAAC,CAAC,2BAA2B,CAAC,WAAW,CAAC;QAC1C,CAAC,CAAC,SAAS,CAAC;AACpB,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,0BAA0B,CACtC,YAAuC;IAEvC,OAAO,uBAAuB,CAAC,YAAY,CAAC;QACxC,CAAC,CAAC,4BAA4B,CAAC,YAAY,CAAC;QAC5C,CAAC,CAAC,SAAS,CAAC;AACpB,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,qBAAqB,CACjC,WAAsC;;IAEtC,OAAO,MAAA,yBAAyB,CAAC,WAAW,CAAC,0CAAE,YAAY,CAAC;AAChE,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,wBAAwB,CACpC,WAAsC;;IAEtC,OAAO,MAAA,yBAAyB,CAAC,WAAW,CAAC,0CAAE,WAAW,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACnC,WAAsC;IAEtC,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC;AACtF,CAAC"}

package/dist/types/index.d.ts

@@ -16,6 +16,7 @@ export * from './modules/socket/index';
 export * from './modules/web-notification/index';
 export * from './modules/notification/index';
 export * from './modules/chat/index';
+export * from './modules/country/index';
 export * from './interfaces/server-message';
 export * from './interfaces/i-request-with-user';
 export * from './interfaces/validated-user';

package/dist/types/modules/country/constants/country-defaults.const.d.ts

@@ -0,0 +1,15 @@
+import { CountryCode } from '../enums/country-code.enum';
+import { CurrencyCode } from '../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.
+ */
+export declare const DEFAULT_COUNTRY_CODE: CountryCode;
+export declare const DEFAULT_CURRENCY_CODE: CurrencyCode;
+export declare const DEFAULT_CALLING_CODE: string;
+export declare const DEFAULT_TIMEZONE = "Africa/Nairobi";
+export declare const DEFAULT_LOCALE = "en-KE";

package/dist/types/modules/country/constants/supported-countries.const.d.ts

@@ -0,0 +1,13 @@
+import { CountryCode } from '../enums/country-code.enum';
+import { SupportedCountryConfig } from '../interfaces/supported-country-config';
+/**
+ * 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.
+ */
+export declare const SUPPORTED_COUNTRIES_BY_CODE: Readonly<Record<CountryCode, SupportedCountryConfig>>;
+/** Supported countries as an array (convenient for iteration / pickers). */
+export declare const SUPPORTED_COUNTRIES: readonly SupportedCountryConfig[];

package/dist/types/modules/country/constants/supported-currencies.const.d.ts

@@ -0,0 +1,11 @@
+import { CurrencyCode } from '../enums/currency-code.enum';
+import { SupportedCurrencyConfig } from '../interfaces/supported-currency-config';
+/**
+ * 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.
+ */
+export declare const SUPPORTED_CURRENCIES_BY_CODE: Readonly<Record<CurrencyCode, SupportedCurrencyConfig>>;
+/** Supported currencies as an array (convenient for iteration / pickers). */
+export declare const SUPPORTED_CURRENCIES: readonly SupportedCurrencyConfig[];

package/dist/types/modules/country/dtos/country-scope.dto.d.ts

@@ -0,0 +1,13 @@
+import { CountryCode } from '../enums/country-code.enum';
+import { CurrencyCode } from '../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.
+ */
+export declare class CountryScopeDto {
+    countryCode?: CountryCode;
+    currencyCode?: CurrencyCode;
+}

package/dist/types/modules/country/enums/calling-code.enum.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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}.
+ */
+export declare enum CallingCode {
+    /** Kenya */
+    KE = "+254",
+    /** Uganda */
+    UG = "+256",
+    /** Tanzania */
+    TZ = "+255"
+}

package/dist/types/modules/country/enums/country-code.enum.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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.
+ */
+export declare enum CountryCode {
+    /** Kenya */
+    KE = "KE",
+    /** Uganda */
+    UG = "UG",
+    /** Tanzania */
+    TZ = "TZ"
+}

package/dist/types/modules/country/enums/currency-code.enum.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Supported currency codes.
+ *
+ * ISO 4217 currency codes for the markets the platform operates in.
+ *
+ * KES (Kenyan Shilling) is the default/backward-compatible currency.
+ */
+export declare enum CurrencyCode {
+    /** Kenyan Shilling */
+    KES = "KES",
+    /** Ugandan Shilling */
+    UGX = "UGX",
+    /** Tanzanian Shilling */
+    TZS = "TZS"
+}

package/dist/types/modules/country/index.d.ts

@@ -0,0 +1,12 @@
+export * from './enums/country-code.enum';
+export * from './enums/currency-code.enum';
+export * from './enums/calling-code.enum';
+export * from './interfaces/geo-coordinates';
+export * from './interfaces/map-bounds';
+export * from './interfaces/supported-currency-config';
+export * from './interfaces/supported-country-config';
+export * from './constants/supported-currencies.const';
+export * from './constants/supported-countries.const';
+export * from './constants/country-defaults.const';
+export * from './dtos/country-scope.dto';
+export * from './utils/country.util';

package/dist/types/modules/country/interfaces/geo-coordinates.d.ts

@@ -0,0 +1,12 @@
+/**
+ * A simple latitude/longitude pair (WGS84 decimal degrees).
+ *
+ * Used for country-level map defaults (e.g. the default map center). Kept
+ * dependency-free so it is reusable across backend, admin and mobile.
+ */
+export interface GeoCoordinates {
+    /** Latitude in decimal degrees, range -90..90. */
+    lat: number;
+    /** Longitude in decimal degrees, range -180..180. */
+    lng: number;
+}

package/dist/types/modules/country/interfaces/map-bounds.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A rectangular geographic bounding box.
+ *
+ * Field names match the Google Maps `LatLngBoundsLiteral` shape so the value
+ * can be passed straight to the Maps JS SDK / Flutter map bounds restriction.
+ */
+export interface MapBounds {
+    /** Northernmost latitude (max lat). */
+    north: number;
+    /** Southernmost latitude (min lat). */
+    south: number;
+    /** Easternmost longitude (max lng). */
+    east: number;
+    /** Westernmost longitude (min lng). */
+    west: number;
+}

package/dist/types/modules/country/interfaces/supported-country-config.d.ts

@@ -0,0 +1,39 @@
+import { CountryCode } from '../enums/country-code.enum';
+import { CurrencyCode } from '../enums/currency-code.enum';
+import { GeoCoordinates } from './geo-coordinates';
+import { MapBounds } from './map-bounds';
+/**
+ * Full platform configuration for a supported country/market.
+ *
+ * This is the single source of truth that country-aware features (billing,
+ * newsfeed, notifications, maps, admin, mobile) should read from instead of
+ * hard-coding Kenya-specific values.
+ */
+export interface SupportedCountryConfig {
+    /** ISO 3166-1 alpha-2 country code, e.g. 'KE'. */
+    code: CountryCode;
+    /** Human-readable country name, e.g. 'Kenya'. */
+    name: string;
+    /** E.164 calling code, e.g. '+254'. */
+    callingCode: string;
+    /** ISO 4217 currency code used in this country. */
+    currencyCode: CurrencyCode;
+    /** Currency display symbol, e.g. 'KSh'. */
+    currencySymbol: string;
+    /** Number of minor-unit decimal digits for the currency. */
+    currencyDecimalPlaces: number;
+    /** IANA timezone identifier, e.g. 'Africa/Nairobi'. */
+    timezone: string;
+    /** BCP-47 default locale, e.g. 'en-KE'. */
+    defaultLocale: string;
+    /** Google Maps region bias (ccTLD), e.g. 'KE'. */
+    googleMapsRegion: string;
+    /** Default map center (typically the capital city). */
+    defaultMapCenter: GeoCoordinates;
+    /** Default map zoom level for a country-wide view. */
+    defaultMapZoom: number;
+    /** Approximate geographic bounding box for the country. */
+    mapBounds: MapBounds;
+    /** Whether the country is currently enabled for use. */
+    enabled: boolean;
+}

package/dist/types/modules/country/interfaces/supported-currency-config.d.ts

@@ -0,0 +1,19 @@
+import { CurrencyCode } from '../enums/currency-code.enum';
+/**
+ * Configuration describing a currency the platform supports.
+ *
+ * `decimalPlaces` is the number of minor-unit digits (e.g. KES has 2, UGX/TZS
+ * have 0) and should drive money formatting and minor-unit conversions.
+ */
+export interface SupportedCurrencyConfig {
+    /** ISO 4217 currency code. */
+    code: CurrencyCode;
+    /** Human-readable currency name, e.g. 'Kenyan Shilling'. */
+    name: string;
+    /** Display symbol, e.g. 'KSh'. */
+    symbol: string;
+    /** Number of minor-unit decimal digits, e.g. 2 for KES, 0 for UGX/TZS. */
+    decimalPlaces: number;
+    /** Whether the currency is currently enabled for use. */
+    enabled: boolean;
+}

package/dist/types/modules/country/utils/country.util.d.ts

@@ -0,0 +1,27 @@
+import { CountryCode } from '../enums/country-code.enum';
+import { CurrencyCode } from '../enums/currency-code.enum';
+import { SupportedCountryConfig } from '../interfaces/supported-country-config';
+import { SupportedCurrencyConfig } from '../interfaces/supported-currency-config';
+/**
+ * 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? */
+export declare function isSupportedCountryCode(value: unknown): value is CountryCode;
+/** Type guard: is `value` a supported ISO 4217 currency code? */
+export declare function isSupportedCurrencyCode(value: unknown): value is CurrencyCode;
+/** Get the full config for a supported country, or `undefined` if unsupported. */
+export declare function getSupportedCountryConfig(countryCode: string | null | undefined): SupportedCountryConfig | undefined;
+/** Get the full config for a supported currency, or `undefined` if unsupported. */
+export declare function getSupportedCurrencyConfig(currencyCode: string | null | undefined): SupportedCurrencyConfig | undefined;
+/** Resolve the currency used by a supported country, or `undefined`. */
+export declare function getCurrencyForCountry(countryCode: string | null | undefined): CurrencyCode | undefined;
+/** Resolve the E.164 calling code (e.g. '+254') for a supported country, or `undefined`. */
+export declare function getCallingCodeForCountry(countryCode: string | null | undefined): string | undefined;
+/**
+ * Reverse lookup: find the supported country whose E.164 calling code matches
+ * `callingCode` (e.g. '+254' -> Kenya), or `undefined` if none match.
+ */
+export declare function getCountryByCallingCode(callingCode: string | null | undefined): SupportedCountryConfig | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grm-shared-library",
-  "version": "1.1.182",
+  "version": "1.1.183",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",
@@ -20,13 +20,14 @@
     "dist/**/*"
   ],
   "scripts": {
-    "clean": "rimraf dist",
+    "clean": "rimraf dist dist-test",
     "build:cjs": "tsc -p tsconfig.cjs.json",
     "build:esm": "tsc -p tsconfig.esm.json",
     "build:types": "tsc -p tsconfig.types.json",
     "build": "npm run clean && npm run build:types && npm run build:cjs && npm run build:esm",
     "prepublishOnly": "npm run build",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "pretest": "rimraf dist-test",
+    "test": "tsc -p tsconfig.spec.json && node dist-test/modules/country/__tests__/country.spec.js"
   },
   "keywords": [],
   "author": "",