grm-shared-library 1.1.182 → 1.1.184

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,8 @@ __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);
+__exportStar(require("./modules/phone/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;AACxC,wDAAsC;AAEtC,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/auth/dtos/login-mobile-user.dto.js

@@ -12,19 +12,31 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LoginMobileUserDto = void 0;
 const class_validator_1 = require("class-validator");
 const swagger_1 = require("@nestjs/swagger");
+const country_code_enum_1 = require("../../country/enums/country-code.enum");
+const is_supported_phone_number_decorator_1 = require("../../phone/validators/is-supported-phone-number.decorator");
 class LoginMobileUserDto {
 }
 exports.LoginMobileUserDto = LoginMobileUserDto;
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Mobile phone number with country code',
-        example: '+1234567890',
+        description: 'Mobile phone number in E.164 format (e.g. +254712345678), or national format when countryCode is provided',
+        example: '+254712345678',
         format: 'phone'
     }),
-    (0, class_validator_1.IsPhoneNumber)(),
+    (0, is_supported_phone_number_decorator_1.IsSupportedPhoneNumber)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], LoginMobileUserDto.prototype, "phoneNumber", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'ISO 3166-1 alpha-2 country code for the phone number (KE, UG, TZ). Required when phoneNumber is in national format; defaults to KE.',
+        enum: country_code_enum_1.CountryCode,
+        example: country_code_enum_1.CountryCode.KE
+    }),
+    (0, class_validator_1.IsEnum)(country_code_enum_1.CountryCode),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], LoginMobileUserDto.prototype, "countryCode", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'Verification token received',

package/dist/cjs/modules/auth/dtos/login-mobile-user.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"login-mobile-user.dto.js","sourceRoot":"","sources":["../../../../../src/modules/auth/dtos/login-mobile-user.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAsE;AACtE,6CAA8C;AAE9C,MAAa,kBAAkB;CAiB9B;AAjBD,gDAiBC;AATG;IAPC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,uCAAuC;QACpD,OAAO,EAAE,aAAa;QACtB,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,IAAA,+BAAa,GAAE;IACf,IAAA,4BAAU,GAAE;;uDACQ;AAQrB;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,6BAA6B;QAC1C,OAAO,EAAE,cAAc;KAC1B,CAAC;IACD,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;6DACc"}
+{"version":3,"file":"login-mobile-user.dto.js","sourceRoot":"","sources":["../../../../../src/modules/auth/dtos/login-mobile-user.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAA2E;AAC3E,6CAAmE;AACnE,6EAAoE;AACpE,oHAAoG;AAEpG,MAAa,kBAAkB;CA0B9B;AA1BD,gDA0BC;AAlBG;IAPC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,2GAA2G;QACxH,OAAO,EAAE,eAAe;QACxB,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,IAAA,4DAAsB,GAAE;IACxB,IAAA,4BAAU,GAAE;;uDACQ;AASrB;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,qIAAqI;QAClJ,IAAI,EAAE,+BAAW;QACjB,OAAO,EAAE,+BAAW,CAAC,EAAE;KAC1B,CAAC;IACD,IAAA,wBAAM,EAAC,+BAAW,CAAC;IACnB,IAAA,4BAAU,GAAE;;uDACa;AAQ1B;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,6BAA6B;QAC1C,OAAO,EAAE,cAAc;KAC1B,CAAC;IACD,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;6DACc"}

package/dist/cjs/modules/auth/dtos/register-mobile-user.dto.js

@@ -13,6 +13,8 @@ exports.RegisterMobileUserDto = void 0;
 const class_validator_1 = require("class-validator");
 const swagger_1 = require("@nestjs/swagger");
 const incident_1 = require("../../incident");
+const country_code_enum_1 = require("../../country/enums/country-code.enum");
+const is_supported_phone_number_decorator_1 = require("../../phone/validators/is-supported-phone-number.decorator");
 class RegisterMobileUserDto {
 }
 exports.RegisterMobileUserDto = RegisterMobileUserDto;
@@ -47,14 +49,24 @@ __decorate([
 ], RegisterMobileUserDto.prototype, "email", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Phone number with country code',
-        example: '+1234567890',
+        description: 'Phone number in E.164 format (e.g. +254712345678), or national format when countryCode is provided',
+        example: '+254712345678',
         format: 'phone'
     }),
-    (0, class_validator_1.IsPhoneNumber)(),
+    (0, is_supported_phone_number_decorator_1.IsSupportedPhoneNumber)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], RegisterMobileUserDto.prototype, "phoneNumber", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'ISO 3166-1 alpha-2 country code for the phone number (KE, UG, TZ). Required when phoneNumber is in national format; defaults to KE.',
+        enum: country_code_enum_1.CountryCode,
+        example: country_code_enum_1.CountryCode.KE
+    }),
+    (0, class_validator_1.IsEnum)(country_code_enum_1.CountryCode),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], RegisterMobileUserDto.prototype, "countryCode", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'ID of the control centre the user belongs to',

package/dist/cjs/modules/auth/dtos/register-mobile-user.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"register-mobile-user.dto.js","sourceRoot":"","sources":["../../../../../src/modules/auth/dtos/register-mobile-user.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAiG;AACjG,6CAA8C;AAC9C,6CAA+C;AAE/C,MAAa,qBAAqB;CAmDjC;AAnDD,sDAmDC;AA3CG;IAPC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,mDAAmD;QAChE,IAAI,EAAE,wBAAa;QACnB,OAAO,EAAE,wBAAa,CAAC,KAAK;KAC/B,CAAC;IACD,IAAA,wBAAM,EAAC,wBAAa,CAAC;IACrB,IAAA,4BAAU,GAAE;;oDACS;AAQtB;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,8BAA8B;QAC3C,OAAO,EAAE,UAAU;KACtB,CAAC;IACD,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;mDACC;AASd;IAPC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,kCAAkC;QAC/C,OAAO,EAAE,sBAAsB;QAC/B,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,IAAA,yBAAO,GAAE;IACT,IAAA,4BAAU,GAAE;;oDACE;AASf;IAPC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,gCAAgC;QAC7C,OAAO,EAAE,aAAa;QACtB,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,IAAA,+BAAa,GAAE;IACf,IAAA,4BAAU,GAAE;;0DACQ;AAQrB;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,8CAA8C;QAC3D,OAAO,EAAE,GAAG;KACf,CAAC;IACD,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;8DACY;AAQzB;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,4CAA4C;QACzD,OAAO,EAAE,GAAG;KACf,CAAC;IACD,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;6DACW"}
+{"version":3,"file":"register-mobile-user.dto.js","sourceRoot":"","sources":["../../../../../src/modules/auth/dtos/register-mobile-user.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAA8F;AAC9F,6CAAmE;AACnE,6CAA+C;AAC/C,6EAAoE;AACpE,oHAAoG;AAEpG,MAAa,qBAAqB;CA4DjC;AA5DD,sDA4DC;AApDG;IAPC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,mDAAmD;QAChE,IAAI,EAAE,wBAAa;QACnB,OAAO,EAAE,wBAAa,CAAC,KAAK;KAC/B,CAAC;IACD,IAAA,wBAAM,EAAC,wBAAa,CAAC;IACrB,IAAA,4BAAU,GAAE;;oDACS;AAQtB;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,8BAA8B;QAC3C,OAAO,EAAE,UAAU;KACtB,CAAC;IACD,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;mDACC;AASd;IAPC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,kCAAkC;QAC/C,OAAO,EAAE,sBAAsB;QAC/B,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,IAAA,yBAAO,GAAE;IACT,IAAA,4BAAU,GAAE;;oDACE;AASf;IAPC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,oGAAoG;QACjH,OAAO,EAAE,eAAe;QACxB,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,IAAA,4DAAsB,GAAE;IACxB,IAAA,4BAAU,GAAE;;0DACQ;AASrB;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,qIAAqI;QAClJ,IAAI,EAAE,+BAAW;QACjB,OAAO,EAAE,+BAAW,CAAC,EAAE;KAC1B,CAAC;IACD,IAAA,wBAAM,EAAC,+BAAW,CAAC;IACnB,IAAA,4BAAU,GAAE;;0DACa;AAQ1B;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,8CAA8C;QAC3D,OAAO,EAAE,GAAG;KACf,CAAC;IACD,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;8DACY;AAQzB;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,4CAA4C;QACzD,OAAO,EAAE,GAAG;KACf,CAAC;IACD,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;6DACW"}

package/dist/cjs/modules/auth/dtos/register.dto.js

@@ -19,6 +19,8 @@ const password_regex_const_1 = require("../../common/constants/password-regex.co
 const class_transformer_1 = require("class-transformer");
 const org_type_enum_1 = require("../../organization/enums/org-type.enum");
 const incident_1 = require("../../incident");
+const country_code_enum_1 = require("../../country/enums/country-code.enum");
+const is_supported_phone_number_decorator_1 = require("../../phone/validators/is-supported-phone-number.decorator");
 class RegisterDto {
 }
 exports.RegisterDto = RegisterDto;
@@ -70,16 +72,26 @@ __decorate([
 ], RegisterDto.prototype, "email", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Phone number with country code',
-        example: '+1234567890',
+        description: 'Phone number in E.164 format (e.g. +254712345678), or national format when countryCode is provided',
+        example: '+254712345678',
         format: 'phone',
         maxLength: 20
     }),
-    (0, class_validator_1.IsPhoneNumber)(),
+    (0, is_supported_phone_number_decorator_1.IsSupportedPhoneNumber)(),
     (0, class_validator_1.MaxLength)(20),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], RegisterDto.prototype, "phoneNumber", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'ISO 3166-1 alpha-2 country code for the phone number (KE, UG, TZ). Required when phoneNumber is in national format; defaults to KE.',
+        enum: country_code_enum_1.CountryCode,
+        example: country_code_enum_1.CountryCode.KE
+    }),
+    (0, class_validator_1.IsEnum)(country_code_enum_1.CountryCode),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], RegisterDto.prototype, "countryCode", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
         description: 'User roles (optional)',

package/dist/cjs/modules/auth/dtos/register.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"register.dto.js","sourceRoot":"","sources":["../../../../../src/modules/auth/dtos/register.dto.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"register.dto.js","sourceRoot":"","sources":["../../../../../src/modules/auth/dtos/register.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAmJ;AACnJ,6CAAmE;AACnE,yCAA6C;AAC7C,qCAAmC;AACnC,yEAAmE;AACnE,sFAAqG;AACrG,yDAAyC;AACzC,0EAA0E;AAC1E,6CAA8D;AAC9D,6EAAoE;AACpE,oHAAoG;AAEpG,MAAa,WAAW;CAoIvB;AApID,kCAoIC;AA5HG;IAPC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,4CAA4C;QACzD,IAAI,EAAE,wBAAa;QACnB,OAAO,EAAE,wBAAa,CAAC,GAAG;KAC7B,CAAC;IACD,IAAA,wBAAM,EAAC,wBAAa,CAAC;IACrB,IAAA,4BAAU,GAAE;;0CACS;AAStB;IAPC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,4CAA4C;QACzD,IAAI,EAAE,wBAAa;QACnB,OAAO,EAAE,wBAAa,CAAC,QAAQ;KAClC,CAAC;IACD,IAAA,wBAAM,EAAC,wBAAa,CAAC;IACrB,IAAA,4BAAU,GAAE;;kDACiB;AAa9B;IAXC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,uBAAuB;QACpC,OAAO,EAAE,UAAU;QACnB,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,EAAE;KAChB,CAAC;IACD,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,EAAC,CAAC,CAAC;IACZ,IAAA,2BAAS,EAAC,EAAE,CAAC;IACb,IAAA,8BAAY,GAAE;;yCACD;AAWd;IATC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,2BAA2B;QACxC,OAAO,EAAE,sBAAsB;QAC/B,MAAM,EAAE,OAAO;QACf,SAAS,EAAE,EAAE;KAChB,CAAC;IACD,IAAA,yBAAO,GAAE;IACT,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,EAAC,EAAE,CAAC;;0CACC;AAWf;IATC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,oGAAoG;QACjH,OAAO,EAAE,eAAe;QACxB,MAAM,EAAE,OAAO;QACf,SAAS,EAAE,EAAE;KAChB,CAAC;IACD,IAAA,4DAAsB,GAAE;IACxB,IAAA,2BAAS,EAAC,EAAE,CAAC;IACb,IAAA,4BAAU,GAAE;;gDACQ;AASrB;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,qIAAqI;QAClJ,IAAI,EAAE,+BAAW;QACjB,OAAO,EAAE,+BAAW,CAAC,EAAE;KAC1B,CAAC;IACD,IAAA,wBAAM,EAAC,+BAAW,CAAC;IACnB,IAAA,4BAAU,GAAE;;gDACa;AAW1B;IATC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,uBAAuB;QACpC,IAAI,EAAE,YAAK;QACX,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,CAAC,YAAK,CAAC,kBAAkB,CAAC;KACtC,CAAC;IACD,IAAA,yBAAO,GAAE;IACT,IAAA,wBAAM,EAAC,YAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC7B,IAAA,4BAAU,GAAE;;0CACG;AAUhB;IARC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,4BAA4B;QACzC,OAAO,EAAE,mBAAmB;QAC5B,SAAS,EAAE,EAAE;KAChB,CAAC;IACD,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,EAAC,EAAE,CAAC;;gDACO;AAYrB;IAVC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,0BAA0B;QACvC,OAAO,EAAE,gBAAgB;QACzB,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,qCAAc,CAAC,MAAM;KACjC,CAAC;IACD,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,CAAC,CAAC;IACZ,IAAA,yBAAO,EAAC,qCAAc,EAAE,EAAE,OAAO,EAAE,6CAAsB,EAAE,CAAC;IAC5D,IAAA,4BAAU,GAAE;;6CACK;AAUlB;IARC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,mBAAmB;QAChC,OAAO,EAAE,kCAAkC;QAC3C,SAAS,EAAE,EAAE;KAChB,CAAC;IACD,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,EAAC,EAAE,CAAC;;4CACG;AASjB;IAPC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,sBAAsB;QACnC,IAAI,EAAE,sBAAa;KACtB,CAAC;IACD,IAAA,gCAAc,GAAE;IAChB,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,sBAAa,CAAC;IACzB,IAAA,4BAAU,GAAE;8BACA,sBAAa;+CAAC;AAS3B;IAPC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,0BAA0B;QACvC,OAAO,EAAE,mCAAmC;QAC5C,MAAM,EAAE,KAAK;KAChB,CAAC;IACD,IAAA,uBAAK,EAAC,EAAE,EAAE,EAAE,OAAO,EAAE,sDAAsD,EAAE,CAAC;IAC9E,IAAA,4BAAU,GAAE;;+CACO;AASpB;IAPC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,sBAAsB;QACnC,IAAI,EAAE,gCAAgB;QACtB,OAAO,EAAE,gCAAgB,CAAC,MAAM;KACnC,CAAC;IACD,IAAA,wBAAM,EAAC,gCAAgB,CAAC;IACxB,IAAA,4BAAU,GAAE;;4CACc"}

package/dist/cjs/modules/auth/dtos/resend-otp.dto.js

@@ -13,6 +13,8 @@ exports.ResendOTPDto = void 0;
 const class_validator_1 = require("class-validator");
 const swagger_1 = require("@nestjs/swagger");
 const otp_action_1 = require("../enums/otp-action");
+const country_code_enum_1 = require("../../country/enums/country-code.enum");
+const is_supported_phone_number_decorator_1 = require("../../phone/validators/is-supported-phone-number.decorator");
 class ResendOTPDto {
 }
 exports.ResendOTPDto = ResendOTPDto;
@@ -49,12 +51,22 @@ __decorate([
 ], ResendOTPDto.prototype, "email", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
-        description: 'Phone number of the user requesting OTP',
-        example: '+1234567890',
+        description: 'Phone number of the user requesting OTP, in E.164 format (e.g. +254712345678) or national format when countryCode is provided',
+        example: '+254712345678',
         format: 'phone'
     }),
-    (0, class_validator_1.IsPhoneNumber)(),
+    (0, is_supported_phone_number_decorator_1.IsSupportedPhoneNumber)(),
     (0, class_validator_1.IsOptional)(),
     __metadata("design:type", String)
 ], ResendOTPDto.prototype, "phoneNumber", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'ISO 3166-1 alpha-2 country code for the phone number (KE, UG, TZ). Required when phoneNumber is in national format; defaults to KE.',
+        enum: country_code_enum_1.CountryCode,
+        example: country_code_enum_1.CountryCode.KE
+    }),
+    (0, class_validator_1.IsEnum)(country_code_enum_1.CountryCode),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], ResendOTPDto.prototype, "countryCode", void 0);
 //# sourceMappingURL=resend-otp.dto.js.map

package/dist/cjs/modules/auth/dtos/resend-otp.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"resend-otp.dto.js","sourceRoot":"","sources":["../../../../../src/modules/auth/dtos/resend-otp.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAmG;AACnG,6CAAmE;AACnE,oDAAgD;AAEhD,MAAa,YAAY;CAqCxB;AArCD,oCAqCC;AA5BG;IARC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,yCAAyC;QACtD,IAAI,EAAE,sBAAS;QACf,OAAO,EAAE,sBAAS,CAAC,KAAK;QACxB,MAAM,EAAE,QAAQ;KACnB,CAAC;IACD,IAAA,wBAAM,EAAC,sBAAS,CAAC;IACjB,IAAA,4BAAU,GAAE;;4CACM;AASnB;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,0CAA0C;QACvD,OAAO,EAAE,cAAc;QACvB,MAAM,EAAE,QAAQ;KACnB,CAAC;IACD,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;uDACc;AAS3B;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,kCAAkC;QAC/C,OAAO,EAAE,kBAAkB;QAC3B,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,IAAA,yBAAO,GAAE;IACT,IAAA,4BAAU,GAAE;;2CACE;AASf;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,yCAAyC;QACtD,OAAO,EAAE,aAAa;QACtB,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,IAAA,+BAAa,GAAE;IACf,IAAA,4BAAU,GAAE;;iDACQ"}
+{"version":3,"file":"resend-otp.dto.js","sourceRoot":"","sources":["../../../../../src/modules/auth/dtos/resend-otp.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAoF;AACpF,6CAAmE;AACnE,oDAAgD;AAChD,6EAAoE;AACpE,oHAAoG;AAEpG,MAAa,YAAY;CA8CxB;AA9CD,oCA8CC;AArCG;IARC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,yCAAyC;QACtD,IAAI,EAAE,sBAAS;QACf,OAAO,EAAE,sBAAS,CAAC,KAAK;QACxB,MAAM,EAAE,QAAQ;KACnB,CAAC;IACD,IAAA,wBAAM,EAAC,sBAAS,CAAC;IACjB,IAAA,4BAAU,GAAE;;4CACM;AASnB;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,0CAA0C;QACvD,OAAO,EAAE,cAAc;QACvB,MAAM,EAAE,QAAQ;KACnB,CAAC;IACD,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;uDACc;AAS3B;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,kCAAkC;QAC/C,OAAO,EAAE,kBAAkB;QAC3B,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,IAAA,yBAAO,GAAE;IACT,IAAA,4BAAU,GAAE;;2CACE;AASf;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,+HAA+H;QAC5I,OAAO,EAAE,eAAe;QACxB,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,IAAA,4DAAsB,GAAE;IACxB,IAAA,4BAAU,GAAE;;iDACQ;AASrB;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,qIAAqI;QAClJ,IAAI,EAAE,+BAAW;QACjB,OAAO,EAAE,+BAAW,CAAC,EAAE;KAC1B,CAAC;IACD,IAAA,wBAAM,EAAC,+BAAW,CAAC;IACnB,IAAA,4BAAU,GAAE;;iDACa"}

package/dist/cjs/modules/auth/dtos/send-otp.dto.js

@@ -13,19 +13,31 @@ exports.SendOTPDto = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
 const otp_action_1 = require("../enums/otp-action");
+const country_code_enum_1 = require("../../country/enums/country-code.enum");
+const is_supported_phone_number_decorator_1 = require("../../phone/validators/is-supported-phone-number.decorator");
 class SendOTPDto {
 }
 exports.SendOTPDto = SendOTPDto;
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
-        description: 'The phone number to send the OTP to (If email is not provided)',
-        example: '+1234567890',
+        description: 'The phone number to send the OTP to, in E.164 format (e.g. +254712345678) or national format when countryCode is provided (If email is not provided)',
+        example: '+254712345678',
         format: 'phone'
     }),
-    (0, class_validator_1.IsPhoneNumber)(),
+    (0, is_supported_phone_number_decorator_1.IsSupportedPhoneNumber)(),
     (0, class_validator_1.IsOptional)(),
     __metadata("design:type", String)
 ], SendOTPDto.prototype, "phoneNumber", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'ISO 3166-1 alpha-2 country code for the phone number (KE, UG, TZ). Required when phoneNumber is in national format; defaults to KE.',
+        enum: country_code_enum_1.CountryCode,
+        example: country_code_enum_1.CountryCode.KE
+    }),
+    (0, class_validator_1.IsEnum)(country_code_enum_1.CountryCode),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], SendOTPDto.prototype, "countryCode", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
         description: 'The email address to send the OTP to (If phone number is not provided)',

package/dist/cjs/modules/auth/dtos/send-otp.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"send-otp.dto.js","sourceRoot":"","sources":["../../../../../src/modules/auth/dtos/send-otp.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AACnE,qDAAmG;AACnG,oDAAgD;AAEhD,MAAa,UAAU;CA2BtB;AA3BD,gCA2BC;AAnBG;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,gEAAgE;QAC7E,OAAO,EAAE,aAAa;QACtB,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,IAAA,+BAAa,GAAE;IACf,IAAA,4BAAU,GAAE;;+CACQ;AASrB;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,wEAAwE;QACrF,OAAO,EAAE,kBAAkB;QAC3B,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,IAAA,yBAAO,GAAE;IACT,IAAA,4BAAU,GAAE;;yCACE;AASf;IAPC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,yCAAyC;QACtD,IAAI,EAAE,sBAAS;QACf,OAAO,EAAE,sBAAS,CAAC,YAAY;KAClC,CAAC;IACD,IAAA,wBAAM,EAAC,sBAAS,CAAC;IACjB,IAAA,4BAAU,GAAE;;0CACM"}
+{"version":3,"file":"send-otp.dto.js","sourceRoot":"","sources":["../../../../../src/modules/auth/dtos/send-otp.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AACnE,qDAAoF;AACpF,oDAAgD;AAChD,6EAAoE;AACpE,oHAAoG;AAEpG,MAAa,UAAU;CAoCtB;AApCD,gCAoCC;AA5BG;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,sJAAsJ;QACnK,OAAO,EAAE,eAAe;QACxB,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,IAAA,4DAAsB,GAAE;IACxB,IAAA,4BAAU,GAAE;;+CACQ;AASrB;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,qIAAqI;QAClJ,IAAI,EAAE,+BAAW;QACjB,OAAO,EAAE,+BAAW,CAAC,EAAE;KAC1B,CAAC;IACD,IAAA,wBAAM,EAAC,+BAAW,CAAC;IACnB,IAAA,4BAAU,GAAE;;+CACa;AAS1B;IAPC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,wEAAwE;QACrF,OAAO,EAAE,kBAAkB;QAC3B,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,IAAA,yBAAO,GAAE;IACT,IAAA,4BAAU,GAAE;;yCACE;AASf;IAPC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,yCAAyC;QACtD,IAAI,EAAE,sBAAS;QACf,OAAO,EAAE,sBAAS,CAAC,YAAY;KAClC,CAAC;IACD,IAAA,wBAAM,EAAC,sBAAS,CAAC;IACjB,IAAA,4BAAU,GAAE;;0CACM"}

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"}