grm-shared-library 1.1.182 → 1.1.184

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

@@ -8,20 +8,32 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
-import { IsEmail, IsEnum, IsNotEmpty, IsOptional, IsPhoneNumber } from "class-validator";
+import { IsEmail, IsEnum, IsNotEmpty, IsOptional } from "class-validator";
 import { OtpAction } from "../enums/otp-action";
+import { CountryCode } from "../../country/enums/country-code.enum";
+import { IsSupportedPhoneNumber } from "../../phone/validators/is-supported-phone-number.decorator";
 export class SendOTPDto {
 }
 __decorate([
     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'
     }),
-    IsPhoneNumber(),
+    IsSupportedPhoneNumber(),
     IsOptional(),
     __metadata("design:type", String)
 ], SendOTPDto.prototype, "phoneNumber", void 0);
+__decorate([
+    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: CountryCode,
+        example: CountryCode.KE
+    }),
+    IsEnum(CountryCode),
+    IsOptional(),
+    __metadata("design:type", String)
+], SendOTPDto.prototype, "countryCode", void 0);
 __decorate([
     ApiPropertyOptional({
         description: 'The email address to send the OTP to (If phone number is not provided)',

package/dist/esm/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,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAY,MAAM,iBAAiB,CAAC;AACnG,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,OAAO,UAAU;CA2BtB;AAnBG;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,gEAAgE;QAC7E,OAAO,EAAE,aAAa;QACtB,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,aAAa,EAAE;IACf,UAAU,EAAE;;+CACQ;AASrB;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,wEAAwE;QACrF,OAAO,EAAE,kBAAkB;QAC3B,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,OAAO,EAAE;IACT,UAAU,EAAE;;yCACE;AASf;IAPC,WAAW,CAAC;QACT,WAAW,EAAE,yCAAyC;QACtD,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,SAAS,CAAC,YAAY;KAClC,CAAC;IACD,MAAM,CAAC,SAAS,CAAC;IACjB,UAAU,EAAE;;0CACM"}
+{"version":3,"file":"send-otp.dto.js","sourceRoot":"","sources":["../../../../../src/modules/auth/dtos/send-otp.dto.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAY,MAAM,iBAAiB,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4DAA4D,CAAC;AAEpG,MAAM,OAAO,UAAU;CAoCtB;AA5BG;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,sJAAsJ;QACnK,OAAO,EAAE,eAAe;QACxB,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,sBAAsB,EAAE;IACxB,UAAU,EAAE;;+CACQ;AASrB;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,qIAAqI;QAClJ,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,WAAW,CAAC,EAAE;KAC1B,CAAC;IACD,MAAM,CAAC,WAAW,CAAC;IACnB,UAAU,EAAE;;+CACa;AAS1B;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,wEAAwE;QACrF,OAAO,EAAE,kBAAkB;QAC3B,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,OAAO,EAAE;IACT,UAAU,EAAE;;yCACE;AASf;IAPC,WAAW,CAAC;QACT,WAAW,EAAE,yCAAyC;QACtD,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,SAAS,CAAC,YAAY;KAClC,CAAC;IACD,MAAM,CAAC,SAAS,CAAC;IACjB,UAAU,EAAE;;0CACM"}

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/esm/modules/phone/index.js

@@ -0,0 +1,7 @@
+// Interfaces
+export * from './interfaces/normalized-phone';
+// Utilities
+export * from './phone.util';
+// Validators
+export * from './validators/is-supported-phone-number.decorator';
+//# sourceMappingURL=index.js.map

package/dist/esm/modules/phone/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/phone/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,cAAc,+BAA+B,CAAC;AAE9C,YAAY;AACZ,cAAc,cAAc,CAAC;AAE7B,aAAa;AACb,cAAc,kDAAkD,CAAC"}

package/dist/esm/modules/phone/interfaces/normalized-phone.js

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

package/dist/esm/modules/phone/interfaces/normalized-phone.js.map

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

package/dist/esm/modules/phone/phone.util.js

@@ -0,0 +1,86 @@
+import { parsePhoneNumberFromString } from 'libphonenumber-js';
+import { DEFAULT_COUNTRY_CODE } from '../country/constants/country-defaults.const';
+import { isSupportedCountryCode } from '../country/utils/country.util';
+/**
+ * Phone-number normalization for the platform's supported countries (KE/UG/TZ).
+ *
+ * Built on `libphonenumber-js` (robust parsing/validation — no bespoke regex)
+ * and the Phase 1 country primitives. The canonical stored/queried form is
+ * always E.164 (e.g. '+254712345678').
+ */
+/** Digit strings of the supported E.164 calling codes, for the "code-without-plus" case. */
+const SUPPORTED_CALLING_CODE_DIGITS = ['254', '256', '255'];
+function toResult(phone) {
+    if (!phone || !phone.isValid()) {
+        return {
+            ok: false,
+            error: 'INVALID_PHONE_NUMBER',
+            message: 'The phone number is not a valid number.',
+        };
+    }
+    const country = phone.country;
+    if (!country || !isSupportedCountryCode(country)) {
+        return {
+            ok: false,
+            error: 'UNSUPPORTED_COUNTRY',
+            message: `Phone numbers from ${country !== null && country !== void 0 ? country : 'this country'} are not supported. Supported countries are Kenya (KE), Uganda (UG) and Tanzania (TZ).`,
+        };
+    }
+    return {
+        ok: true,
+        value: {
+            e164: phone.number,
+            countryCode: country,
+            nationalNumber: phone.nationalNumber,
+        },
+    };
+}
+/**
+ * Normalize a phone number to canonical E.164 for a supported country.
+ *
+ * Resolution order for a raw (non-`+`) input:
+ *  1. already international (`+254…`) — parsed as-is;
+ *  2. calling code without `+` (`254…`/`256…`/`255…`) — treated as international;
+ *  3. national/local (`0712…`, `712…`) — parsed using `defaultCountry`
+ *     (the caller-supplied country, else Kenya for backward compatibility).
+ *
+ * @returns a discriminated result: `{ ok: true, value }` or `{ ok: false, error, message }`.
+ */
+export function normalizeSupportedPhoneNumber(input, defaultCountry) {
+    if (input == null || String(input).trim() === '') {
+        return { ok: false, error: 'INVALID_PHONE_NUMBER', message: 'A phone number is required.' };
+    }
+    const raw = String(input).trim();
+    const region = isSupportedCountryCode(defaultCountry)
+        ? defaultCountry
+        : DEFAULT_COUNTRY_CODE;
+    // 1. Already international.
+    if (raw.startsWith('+')) {
+        return toResult(parsePhoneNumberFromString(raw));
+    }
+    const digits = raw.replace(/[^\d]/g, '');
+    // 2. Calling code supplied without the leading '+', e.g. '254712345678'.
+    if (SUPPORTED_CALLING_CODE_DIGITS.some((code) => digits.startsWith(code))) {
+        const international = parsePhoneNumberFromString('+' + digits);
+        if (international && international.isValid()) {
+            return toResult(international);
+        }
+    }
+    // 3. National/local format — resolve using the selected/default country.
+    return toResult(parsePhoneNumberFromString(raw, region));
+}
+/** Convenience: `true` if the input can be normalized to a supported-country E.164 number. */
+export function isSupportedPhoneNumber(input, defaultCountry) {
+    return normalizeSupportedPhoneNumber(input, defaultCountry).ok;
+}
+/** Convenience: the canonical E.164 string, or `undefined` if the input cannot be normalized. */
+export function toSupportedE164(input, defaultCountry) {
+    var _a;
+    return (_a = normalizeSupportedPhoneNumber(input, defaultCountry).value) === null || _a === void 0 ? void 0 : _a.e164;
+}
+/** Resolve the supported country a (normalizable) phone number belongs to, or `undefined`. */
+export function getCountryForPhoneNumber(input, defaultCountry) {
+    var _a;
+    return (_a = normalizeSupportedPhoneNumber(input, defaultCountry).value) === null || _a === void 0 ? void 0 : _a.countryCode;
+}
+//# sourceMappingURL=phone.util.js.map

package/dist/esm/modules/phone/phone.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone.util.js","sourceRoot":"","sources":["../../../../src/modules/phone/phone.util.ts"],"names":[],"mappings":"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"}

package/dist/esm/modules/phone/validators/is-supported-phone-number.decorator.js

@@ -0,0 +1,36 @@
+import { registerDecorator } from 'class-validator';
+import { isSupportedCountryCode } from '../../country/utils/country.util';
+import { isSupportedPhoneNumber } from '../phone.util';
+/**
+ * Validates that a property is a phone number for a supported country (KE/UG/TZ).
+ *
+ * Accepts either a full E.164 number (e.g. '+254712345678') OR a national/local
+ * number (e.g. '0712345678') when a sibling `countryCode` field is present. When
+ * no `countryCode` sibling is provided, Kenya is used as the default region for
+ * backward compatibility.
+ *
+ * Pairs with an optional `countryCode?: CountryCode` field on the same DTO.
+ */
+export function IsSupportedPhoneNumber(validationOptions) {
+    return function (object, propertyName) {
+        registerDecorator({
+            name: 'isSupportedPhoneNumber',
+            target: object.constructor,
+            propertyName,
+            options: validationOptions,
+            validator: {
+                validate(value, args) {
+                    if (typeof value !== 'string') {
+                        return false;
+                    }
+                    const country = args.object['countryCode'];
+                    return isSupportedPhoneNumber(value, isSupportedCountryCode(country) ? country : undefined);
+                },
+                defaultMessage(args) {
+                    return `${args.property} must be a valid phone number for a supported country (KE, UG, TZ) — provide it in E.164 format (e.g. +254712345678), or in national format together with a countryCode.`;
+                },
+            },
+        });
+    };
+}
+//# sourceMappingURL=is-supported-phone-number.decorator.js.map

package/dist/esm/modules/phone/validators/is-supported-phone-number.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-supported-phone-number.decorator.js","sourceRoot":"","sources":["../../../../../src/modules/phone/validators/is-supported-phone-number.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA0C,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,iBAAqC;IACxE,OAAO,UAAU,MAAc,EAAE,YAAoB;QACjD,iBAAiB,CAAC;YACd,IAAI,EAAE,wBAAwB;YAC9B,MAAM,EAAE,MAAM,CAAC,WAAW;YAC1B,YAAY;YACZ,OAAO,EAAE,iBAAiB;YAC1B,SAAS,EAAE;gBACP,QAAQ,CAAC,KAAc,EAAE,IAAyB;oBAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;wBAC5B,OAAO,KAAK,CAAC;oBACjB,CAAC;oBACD,MAAM,OAAO,GAAI,IAAI,CAAC,MAAkC,CAAC,aAAa,CAAC,CAAC;oBACxE,OAAO,sBAAsB,CACzB,KAAK,EACL,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CACxD,CAAC;gBACN,CAAC;gBACD,cAAc,CAAC,IAAyB;oBACpC,OAAO,GAAG,IAAI,CAAC,QAAQ,0KAA0K,CAAC;gBACtM,CAAC;aACJ;SACJ,CAAC,CAAC;IACP,CAAC,CAAC;AACN,CAAC"}

package/dist/esm/modules/user/dtos/create-user.dto.js

@@ -7,7 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { ArrayNotEmpty, IsArray, IsBoolean, IsDate, IsEmail, IsEnum, IsNotEmpty, IsNumber, IsOptional, IsPhoneNumber, IsString, Matches, MaxLength, MinLength, ValidateNested, } from 'class-validator';
+import { ArrayNotEmpty, IsArray, IsBoolean, IsDate, IsEmail, IsEnum, IsNotEmpty, IsNumber, IsOptional, IsString, Matches, MaxLength, MinLength, ValidateNested, } from 'class-validator';
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import { SentenceCase } from '../../../decorators/case-decorators';
 import { UserStatus } from '../enums/user-status.enum';
@@ -16,6 +16,8 @@ import { Roles } from '../../role';
 import { Type } from 'class-transformer';
 import { GuardianDto } from './guardian.dto';
 import { IncidentAppId } from '../../incident';
+import { CountryCode } from '../../country/enums/country-code.enum';
+import { IsSupportedPhoneNumber } from '../../phone/validators/is-supported-phone-number.decorator';
 export class CreateUserDto {
 }
 __decorate([
@@ -56,16 +58,26 @@ __decorate([
 ], CreateUserDto.prototype, "email", void 0);
 __decorate([
     ApiPropertyOptional({
-        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
     }),
-    IsPhoneNumber(),
+    IsSupportedPhoneNumber(),
     MaxLength(20),
     IsOptional(),
     __metadata("design:type", String)
 ], CreateUserDto.prototype, "phoneNumber", void 0);
+__decorate([
+    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: CountryCode,
+        example: CountryCode.KE
+    }),
+    IsEnum(CountryCode),
+    IsOptional(),
+    __metadata("design:type", String)
+], CreateUserDto.prototype, "countryCode", void 0);
 __decorate([
     ApiProperty({
         description: 'User roles',

package/dist/esm/modules/user/dtos/create-user.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-user.dto.js","sourceRoot":"","sources":["../../../../../src/modules/user/dtos/create-user.dto.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"create-user.dto.js","sourceRoot":"","sources":["../../../../../src/modules/user/dtos/create-user.dto.ts"],"names":[],"mappings":"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"}