grm-shared-library 1.1.182 → 1.1.184

package/dist/esm/modules/user/dtos/guardian.dto.js

@@ -7,9 +7,11 @@ 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 { IsBoolean, IsEmail, IsEnum, IsNotEmpty, IsNumber, IsOptional, IsPhoneNumber, IsString } from "class-validator";
+import { IsBoolean, IsEmail, IsEnum, IsNotEmpty, IsNumber, IsOptional, IsString } from "class-validator";
 import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
 import { GuardianRelationship } from "../enums/guardian-relationship.enum";
+import { CountryCode } from "../../country/enums/country-code.enum";
+import { IsSupportedPhoneNumber } from "../../phone/validators/is-supported-phone-number.decorator";
 export class GuardianDto {
 }
 __decorate([
@@ -32,14 +34,24 @@ __decorate([
 ], GuardianDto.prototype, "name", void 0);
 __decorate([
     ApiProperty({
-        description: 'Guardian phone number with country code',
-        example: '+1234567890',
+        description: 'Guardian phone number in E.164 format (e.g. +254712345678), or national format when countryCode is provided',
+        example: '+254712345678',
         format: 'phone'
     }),
-    IsPhoneNumber(),
+    IsSupportedPhoneNumber(),
     IsNotEmpty(),
     __metadata("design:type", String)
 ], GuardianDto.prototype, "phoneNumber", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'ISO 3166-1 alpha-2 country code for the guardian 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)
+], GuardianDto.prototype, "countryCode", void 0);
 __decorate([
     ApiPropertyOptional({
         description: 'Whether this is the primary guardian',

package/dist/esm/modules/user/dtos/guardian.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"guardian.dto.js","sourceRoot":"","sources":["../../../../../src/modules/user/dtos/guardian.dto.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACxH,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAE3E,MAAM,OAAO,WAAW;CAoDvB;AA7CG;IANC,mBAAmB,CAAC;QACjB,WAAW,EAAE,wCAAwC;QACrD,OAAO,EAAE,GAAG;KACf,CAAC;IACD,QAAQ,EAAE;IACV,UAAU,EAAE;;2CACG;AAQhB;IANC,WAAW,CAAC;QACT,WAAW,EAAE,oBAAoB;QACjC,OAAO,EAAE,YAAY;KACxB,CAAC;IACD,QAAQ,EAAE;IACV,UAAU,EAAE;;yCACC;AASd;IAPC,WAAW,CAAC;QACT,WAAW,EAAE,yCAAyC;QACtD,OAAO,EAAE,aAAa;QACtB,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,aAAa,EAAE;IACf,UAAU,EAAE;;gDACQ;AASrB;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,sCAAsC;QACnD,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,KAAK;KACjB,CAAC;IACD,SAAS,EAAE;IACX,UAAU,EAAE;;8CACO;AASpB;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,+BAA+B;QAC5C,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,oBAAoB,CAAC,MAAM;KACvC,CAAC;IACD,MAAM,CAAC,oBAAoB,CAAC;IAC5B,UAAU,EAAE;;iDACuB;AASpC;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,wBAAwB;QACrC,OAAO,EAAE,wBAAwB;QACjC,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,OAAO,EAAE;IACT,UAAU,EAAE;;0CACE"}
+{"version":3,"file":"guardian.dto.js","sourceRoot":"","sources":["../../../../../src/modules/user/dtos/guardian.dto.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACzG,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4DAA4D,CAAC;AAEpG,MAAM,OAAO,WAAW;CA6DvB;AAtDG;IANC,mBAAmB,CAAC;QACjB,WAAW,EAAE,wCAAwC;QACrD,OAAO,EAAE,GAAG;KACf,CAAC;IACD,QAAQ,EAAE;IACV,UAAU,EAAE;;2CACG;AAQhB;IANC,WAAW,CAAC;QACT,WAAW,EAAE,oBAAoB;QACjC,OAAO,EAAE,YAAY;KACxB,CAAC;IACD,QAAQ,EAAE;IACV,UAAU,EAAE;;yCACC;AASd;IAPC,WAAW,CAAC;QACT,WAAW,EAAE,6GAA6G;QAC1H,OAAO,EAAE,eAAe;QACxB,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,sBAAsB,EAAE;IACxB,UAAU,EAAE;;gDACQ;AASrB;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,8IAA8I;QAC3J,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,WAAW,CAAC,EAAE;KAC1B,CAAC;IACD,MAAM,CAAC,WAAW,CAAC;IACnB,UAAU,EAAE;;gDACa;AAS1B;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,sCAAsC;QACnD,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,KAAK;KACjB,CAAC;IACD,SAAS,EAAE;IACX,UAAU,EAAE;;8CACO;AASpB;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,+BAA+B;QAC5C,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,oBAAoB,CAAC,MAAM;KACvC,CAAC;IACD,MAAM,CAAC,oBAAoB,CAAC;IAC5B,UAAU,EAAE;;iDACuB;AASpC;IAPC,mBAAmB,CAAC;QACjB,WAAW,EAAE,wBAAwB;QACrC,OAAO,EAAE,wBAAwB;QACjC,MAAM,EAAE,OAAO;KAClB,CAAC;IACD,OAAO,EAAE;IACT,UAAU,EAAE;;0CACE"}

package/dist/types/index.d.ts

@@ -16,6 +16,8 @@ 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 './modules/phone/index';
 export * from './interfaces/server-message';
 export * from './interfaces/i-request-with-user';
 export * from './interfaces/validated-user';

package/dist/types/modules/auth/dtos/login-mobile-user.dto.d.ts

@@ -1,4 +1,6 @@
+import { CountryCode } from "../../country/enums/country-code.enum";
 export declare class LoginMobileUserDto {
     phoneNumber: string;
+    countryCode?: CountryCode;
     verificationToken: string;
 }

package/dist/types/modules/auth/dtos/register-mobile-user.dto.d.ts

@@ -1,9 +1,11 @@
 import { IncidentAppId } from "../../incident";
+import { CountryCode } from "../../country/enums/country-code.enum";
 export declare class RegisterMobileUserDto {
     appId: IncidentAppId;
     name: string;
     email: string;
     phoneNumber: string;
+    countryCode?: CountryCode;
     controlCentreId: number;
     organizationId: number;
 }

package/dist/types/modules/auth/dtos/register.dto.d.ts

@@ -2,12 +2,14 @@ import { MapAddressDto } from "../../common";
 import { Roles } from "../../role";
 import { OrganizationType } from "../../organization/enums/org-type.enum";
 import { IncidentAppId, IncidentClass } from "../../incident";
+import { CountryCode } from "../../country/enums/country-code.enum";
 export declare class RegisterDto {
     appId: IncidentAppId;
     incidentClass: IncidentClass;
     name: string;
     email: string;
     phoneNumber: string;
+    countryCode?: CountryCode;
     roles?: Roles[];
     designation: string;
     password: string;

package/dist/types/modules/auth/dtos/resend-otp.dto.d.ts

@@ -1,7 +1,9 @@
 import { OtpAction } from "../enums/otp-action";
+import { CountryCode } from "../../country/enums/country-code.enum";
 export declare class ResendOTPDto {
     action: OtpAction;
     verificationToken?: string;
     email?: string;
     phoneNumber?: string;
+    countryCode?: CountryCode;
 }

package/dist/types/modules/auth/dtos/send-otp.dto.d.ts

@@ -1,6 +1,8 @@
 import { OtpAction } from "../enums/otp-action";
+import { CountryCode } from "../../country/enums/country-code.enum";
 export declare class SendOTPDto {
     phoneNumber?: string;
+    countryCode?: CountryCode;
     email?: string;
     action: OtpAction;
 }

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/dist/types/modules/phone/index.d.ts

@@ -0,0 +1,3 @@
+export * from './interfaces/normalized-phone';
+export * from './phone.util';
+export * from './validators/is-supported-phone-number.decorator';

package/dist/types/modules/phone/interfaces/normalized-phone.d.ts

@@ -0,0 +1,22 @@
+import { CountryCode } from '../../country/enums/country-code.enum';
+/** A phone number successfully normalized to canonical E.164 for a supported country. */
+export interface NormalizedPhoneNumber {
+    /** Canonical E.164 representation, e.g. '+254712345678'. This is the value to store/query. */
+    e164: string;
+    /** ISO 3166-1 alpha-2 country the number belongs to (KE/UG/TZ). */
+    countryCode: CountryCode;
+    /** National (significant) number without the calling code, e.g. '712345678'. */
+    nationalNumber: string;
+}
+/** Machine-readable reason a phone number could not be normalized. */
+export type PhoneNormalizationErrorCode = 'INVALID_PHONE_NUMBER' | 'UNSUPPORTED_COUNTRY';
+/**
+ * Result of attempting to normalize a phone number to a supported-country E.164 value.
+ * Discriminated by `ok` — on success `value` is present, on failure `error`/`message` are.
+ */
+export interface PhoneNormalizationResult {
+    ok: boolean;
+    value?: NormalizedPhoneNumber;
+    error?: PhoneNormalizationErrorCode;
+    message?: string;
+}

package/dist/types/modules/phone/phone.util.d.ts

@@ -0,0 +1,20 @@
+import { CountryCode } from '../country/enums/country-code.enum';
+import { PhoneNormalizationResult } from './interfaces/normalized-phone';
+/**
+ * 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 declare function normalizeSupportedPhoneNumber(input: string | null | undefined, defaultCountry?: CountryCode | string | null): PhoneNormalizationResult;
+/** Convenience: `true` if the input can be normalized to a supported-country E.164 number. */
+export declare function isSupportedPhoneNumber(input: string | null | undefined, defaultCountry?: CountryCode | string | null): boolean;
+/** Convenience: the canonical E.164 string, or `undefined` if the input cannot be normalized. */
+export declare function toSupportedE164(input: string | null | undefined, defaultCountry?: CountryCode | string | null): string | undefined;
+/** Resolve the supported country a (normalizable) phone number belongs to, or `undefined`. */
+export declare function getCountryForPhoneNumber(input: string | null | undefined, defaultCountry?: CountryCode | string | null): CountryCode | undefined;

package/dist/types/modules/phone/validators/is-supported-phone-number.decorator.d.ts

@@ -0,0 +1,12 @@
+import { ValidationOptions } from 'class-validator';
+/**
+ * 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 declare function IsSupportedPhoneNumber(validationOptions?: ValidationOptions): (object: object, propertyName: string) => void;

package/dist/types/modules/user/dtos/create-user.dto.d.ts

@@ -2,11 +2,13 @@ import { UserStatus } from '../enums/user-status.enum';
 import { Roles } from '../../role';
 import { GuardianDto } from './guardian.dto';
 import { IncidentAppId } from '../../incident';
+import { CountryCode } from '../../country/enums/country-code.enum';
 export declare class CreateUserDto {
     appId: IncidentAppId;
     name: string;
     email: string;
     phoneNumber?: string;
+    countryCode?: CountryCode;
     roles: Roles[];
     password?: string;
     avatar?: string;

package/dist/types/modules/user/dtos/guardian.dto.d.ts

@@ -1,8 +1,10 @@
 import { GuardianRelationship } from "../enums/guardian-relationship.enum";
+import { CountryCode } from "../../country/enums/country-code.enum";
 export declare class GuardianDto {
     userId?: number;
     name: string;
     phoneNumber: string;
+    countryCode?: CountryCode;
     isPrimary?: boolean;
     relationship?: GuardianRelationship;
     email?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grm-shared-library",
-  "version": "1.1.182",
+  "version": "1.1.184",
   "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 --test \"dist-test/**/*.spec.js\""
   },
   "keywords": [],
   "author": "",
@@ -54,6 +55,7 @@
     "express": "^5.1.0",
     "geojson": "^0.5.0",
     "grm-shared-library": "^1.1.101",
+    "libphonenumber-js": "^1.13.8",
     "rxjs": "^7.8.2",
     "swagger-ui-express": "^5.0.1"
   },