@govish/shared-services 1.0.0

package/dist/services/officerCacheService.js

@@ -0,0 +1,434 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OfficerCacheService = void 0;
+class OfficerCacheService {
+    constructor(deps) {
+        this.redisClient = deps.redisClient;
+        this.logger = deps.logger;
+    }
+    /**
+     * Store individual officer as hash with indexes
+     */
+    storeOfficer(officer) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            try {
+                const key = `officer:${officer.id}`;
+                // Store as hash with JSON-stringified complex fields
+                yield this.redisClient.hSet(key, {
+                    id: officer.id.toString(),
+                    name: officer.name || '',
+                    service_number: officer.service_number || '',
+                    email: officer.email || '',
+                    badge_number: officer.badge_number || '',
+                    phone_number: officer.phone_number || '',
+                    stationId: ((_a = officer.stationId) === null || _a === void 0 ? void 0 : _a.toString()) || '',
+                    rankId: ((_b = officer.rankId) === null || _b === void 0 ? void 0 : _b.toString()) || '',
+                    roleId: ((_c = officer.roleId) === null || _c === void 0 ? void 0 : _c.toString()) || '',
+                    subCountyId: ((_d = officer.subCountyId) === null || _d === void 0 ? void 0 : _d.toString()) || '',
+                    countyId: ((_e = officer.countyId) === null || _e === void 0 ? void 0 : _e.toString()) || '',
+                    regionId: ((_f = officer.regionId) === null || _f === void 0 ? void 0 : _f.toString()) || '',
+                    iPRS_PersonId: ((_g = officer.iPRS_PersonId) === null || _g === void 0 ? void 0 : _g.toString()) || '',
+                    is_temporary_password: ((_h = officer.is_temporary_password) === null || _h === void 0 ? void 0 : _h.toString()) || 'false',
+                    created_at: ((_j = officer.created_at) === null || _j === void 0 ? void 0 : _j.toISOString()) || '',
+                    updated_at: ((_k = officer.updated_at) === null || _k === void 0 ? void 0 : _k.toISOString()) || '',
+                    // Stringify nested objects
+                    iprs: JSON.stringify(officer.iprs || null),
+                    station: JSON.stringify(officer.station || null),
+                    subCounty: JSON.stringify(officer.subCounty || null),
+                    county: JSON.stringify(officer.county || null),
+                    region: JSON.stringify(officer.region || null),
+                    rank: JSON.stringify(officer.rank || null),
+                    role: JSON.stringify(officer.role || null),
+                    Next_Of_Kin: JSON.stringify(officer.Next_Of_Kin || null)
+                });
+                // Create indexes for common queries
+                if (officer.stationId) {
+                    yield this.redisClient.sAdd(`officers:station:${officer.stationId}`, officer.id.toString());
+                }
+                if (officer.rankId) {
+                    yield this.redisClient.sAdd(`officers:rank:${officer.rankId}`, officer.id.toString());
+                }
+                if (officer.roleId) {
+                    yield this.redisClient.sAdd(`officers:role:${officer.roleId}`, officer.id.toString());
+                }
+                if (officer.subCountyId) {
+                    yield this.redisClient.sAdd(`officers:subCounty:${officer.subCountyId}`, officer.id.toString());
+                }
+                if (officer.countyId) {
+                    yield this.redisClient.sAdd(`officers:county:${officer.countyId}`, officer.id.toString());
+                }
+                if (officer.regionId) {
+                    yield this.redisClient.sAdd(`officers:region:${officer.regionId}`, officer.id.toString());
+                }
+                // Maintain list of all officer IDs
+                yield this.redisClient.sAdd('officers:all', officer.id.toString());
+            }
+            catch (error) {
+                this.logger.error('Error storing officer in cache', {
+                    error: error instanceof Error ? error.message : String(error),
+                    officerId: officer.id
+                });
+                throw error;
+            }
+        });
+    }
+    /**
+     * Get officer by ID - O(1) lookup
+     */
+    getOfficerById(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const rawData = yield this.redisClient.hGetAll(`officer:${id}`);
+                // Convert Map to Record if needed, or use as-is if already Record
+                let data;
+                if (rawData instanceof Map) {
+                    data = Object.fromEntries(rawData);
+                }
+                else if (Array.isArray(rawData)) {
+                    // Handle array case (shouldn't happen with hGetAll, but TypeScript sees it as possible)
+                    return null;
+                }
+                else {
+                    data = rawData;
+                }
+                if (!data || !data.id)
+                    return null;
+                // Parse JSON fields
+                return Object.assign(Object.assign({}, data), { id: parseInt(data.id), stationId: data.stationId ? parseInt(data.stationId) : null, rankId: data.rankId ? parseInt(data.rankId) : null, roleId: data.roleId ? parseInt(data.roleId) : null, subCountyId: data.subCountyId ? parseInt(data.subCountyId) : null, countyId: data.countyId ? parseInt(data.countyId) : null, regionId: data.regionId ? parseInt(data.regionId) : null, iPRS_PersonId: data.iPRS_PersonId ? parseInt(data.iPRS_PersonId) : null, is_temporary_password: data.is_temporary_password === 'true', created_at: data.created_at ? new Date(data.created_at) : null, updated_at: data.updated_at ? new Date(data.updated_at) : null, iprs: data.iprs && data.iprs !== 'null' && data.iprs !== '"null"' ? JSON.parse(data.iprs) : null, station: data.station && data.station !== 'null' && data.station !== '"null"' ? JSON.parse(data.station) : null, subCounty: data.subCounty && data.subCounty !== 'null' && data.subCounty !== '"null"' ? JSON.parse(data.subCounty) : null, county: data.county && data.county !== 'null' && data.county !== '"null"' ? JSON.parse(data.county) : null, region: data.region && data.region !== 'null' && data.region !== '"null"' ? JSON.parse(data.region) : null, rank: data.rank && data.rank !== 'null' && data.rank !== '"null"' ? JSON.parse(data.rank) : null, role: data.role && data.role !== 'null' && data.role !== '"null"' ? JSON.parse(data.role) : null, Next_Of_Kin: data.Next_Of_Kin && data.Next_Of_Kin !== 'null' && data.Next_Of_Kin !== '"null"' ? JSON.parse(data.Next_Of_Kin) : null });
+            }
+            catch (error) {
+                this.logger.error('Error getting officer from cache', {
+                    error: error instanceof Error ? error.message : String(error),
+                    officerId: id
+                });
+                return null;
+            }
+        });
+    }
+    /**
+     * Get multiple officers efficiently using pipeline
+     */
+    getOfficersByIds(ids) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (ids.length === 0)
+                return [];
+            try {
+                const pipeline = this.redisClient.multi();
+                ids.forEach(id => pipeline.hGetAll(`officer:${id}`));
+                const results = yield pipeline.exec();
+                if (!results) {
+                    this.logger.warn('Pipeline exec returned null/undefined', { idsCount: ids.length, ids });
+                    return [];
+                }
+                if (results.length === 0) {
+                    this.logger.warn('Pipeline exec returned empty results array', { idsCount: ids.length, ids });
+                    return [];
+                }
+                if (results.length !== ids.length) {
+                    this.logger.warn('Pipeline results count mismatch', {
+                        expectedCount: ids.length,
+                        actualCount: results.length,
+                        ids
+                    });
+                }
+                return results
+                    .map((result, index) => {
+                    let rawData;
+                    // In Redis v4, pipeline.exec() returns results as [error, result] tuples
+                    // Check if result is an error tuple
+                    if (Array.isArray(result) && result.length === 2) {
+                        const [error, data] = result;
+                        if (error) {
+                            this.logger.warn('Pipeline command error', {
+                                error,
+                                index,
+                                officerId: ids[index],
+                                key: `officer:${ids[index]}`
+                            });
+                            return null; // Skip errors
+                        }
+                        rawData = data;
+                    }
+                    else if (result && typeof result === 'object') {
+                        // Handle case where result might be returned directly (some Redis client versions)
+                        rawData = result;
+                    }
+                    else {
+                        this.logger.warn('Unexpected pipeline result format', {
+                            result,
+                            index,
+                            officerId: ids[index],
+                            resultType: typeof result
+                        });
+                        return null;
+                    }
+                    // Process the rawData
+                    let data;
+                    if (rawData instanceof Map) {
+                        data = Object.fromEntries(rawData);
+                    }
+                    else if (Array.isArray(rawData)) {
+                        // Handle array case (shouldn't happen with hGetAll)
+                        this.logger.warn('Unexpected array result from hGetAll', { index, officerId: ids[index] });
+                        return null;
+                    }
+                    else if (rawData && typeof rawData === 'object') {
+                        data = rawData;
+                    }
+                    else {
+                        this.logger.warn('Invalid rawData type', {
+                            index,
+                            officerId: ids[index],
+                            rawDataType: typeof rawData
+                        });
+                        return null;
+                    }
+                    // Check if data is empty or missing id
+                    if (!data || Object.keys(data).length === 0 || !data.id) {
+                        this.logger.debug('Empty or invalid officer data from cache', {
+                            index,
+                            officerId: ids[index],
+                            hasData: !!data,
+                            dataKeys: data ? Object.keys(data) : []
+                        });
+                        return null;
+                    }
+                    try {
+                        return Object.assign(Object.assign({}, data), { id: parseInt(data.id), stationId: data.stationId ? parseInt(data.stationId) : null, rankId: data.rankId ? parseInt(data.rankId) : null, roleId: data.roleId ? parseInt(data.roleId) : null, subCountyId: data.subCountyId ? parseInt(data.subCountyId) : null, countyId: data.countyId ? parseInt(data.countyId) : null, regionId: data.regionId ? parseInt(data.regionId) : null, iPRS_PersonId: data.iPRS_PersonId ? parseInt(data.iPRS_PersonId) : null, is_temporary_password: data.is_temporary_password === 'true', created_at: data.created_at ? new Date(data.created_at) : null, updated_at: data.updated_at ? new Date(data.updated_at) : null, iprs: data.iprs && data.iprs !== 'null' && data.iprs !== '"null"' ? JSON.parse(data.iprs) : null, station: data.station && data.station !== 'null' && data.station !== '"null"' ? JSON.parse(data.station) : null, subCounty: data.subCounty && data.subCounty !== 'null' && data.subCounty !== '"null"' ? JSON.parse(data.subCounty) : null, county: data.county && data.county !== 'null' && data.county !== '"null"' ? JSON.parse(data.county) : null, region: data.region && data.region !== 'null' && data.region !== '"null"' ? JSON.parse(data.region) : null, rank: data.rank && data.rank !== 'null' && data.rank !== '"null"' ? JSON.parse(data.rank) : null, role: data.role && data.role !== 'null' && data.role !== '"null"' ? JSON.parse(data.role) : null, Next_Of_Kin: data.Next_Of_Kin && data.Next_Of_Kin !== 'null' && data.Next_Of_Kin !== '"null"' ? JSON.parse(data.Next_Of_Kin) : null });
+                    }
+                    catch (parseError) {
+                        this.logger.warn('Error parsing officer data from cache', {
+                            error: parseError instanceof Error ? parseError.message : String(parseError),
+                            officerId: data.id,
+                            index
+                        });
+                        return null;
+                    }
+                })
+                    .filter(Boolean);
+            }
+            catch (error) {
+                this.logger.error('Error getting officers from cache', {
+                    error: error instanceof Error ? error.message : String(error),
+                    idsCount: ids.length
+                });
+                return [];
+            }
+        });
+    }
+    /**
+     * Query by station
+     */
+    getOfficersByStation(stationId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const officerIds = yield this.redisClient.sMembers(`officers:station:${stationId}`);
+                this.logger.debug('Getting officers by station from cache', {
+                    stationId,
+                    officerIdsCount: officerIds.length
+                });
+                return this.getOfficersByIds(officerIds.map(id => parseInt(id)));
+            }
+            catch (error) {
+                this.logger.error('Error getting officers by station from cache', {
+                    error: error instanceof Error ? error.message : String(error),
+                    stationId
+                });
+                return [];
+            }
+        });
+    }
+    /**
+     * Query by rank
+     */
+    getOfficersByRank(rankId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const officerIds = yield this.redisClient.sMembers(`officers:rank:${rankId}`);
+                return this.getOfficersByIds(officerIds.map(id => parseInt(id)));
+            }
+            catch (error) {
+                this.logger.error('Error getting officers by rank from cache', {
+                    error: error instanceof Error ? error.message : String(error),
+                    rankId
+                });
+                return [];
+            }
+        });
+    }
+    /**
+     * Query by role
+     */
+    getOfficersByRole(roleId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const officerIds = yield this.redisClient.sMembers(`officers:role:${roleId}`);
+                return this.getOfficersByIds(officerIds.map(id => parseInt(id)));
+            }
+            catch (error) {
+                this.logger.error('Error getting officers by role from cache', {
+                    error: error instanceof Error ? error.message : String(error),
+                    roleId
+                });
+                return [];
+            }
+        });
+    }
+    /**
+     * Get all officers from cache
+     */
+    getAllOfficers() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const officerIds = yield this.redisClient.sMembers('officers:all');
+                if (officerIds.length === 0)
+                    return [];
+                const ids = officerIds.map(id => parseInt(id));
+                const officers = yield this.getOfficersByIds(ids);
+                // Sort by ID descending to match original behavior
+                return officers.sort((a, b) => b.id - a.id);
+            }
+            catch (error) {
+                this.logger.error('Error getting all officers from cache', {
+                    error: error instanceof Error ? error.message : String(error)
+                });
+                return [];
+            }
+        });
+    }
+    /**
+     * Get officer by service_number
+     */
+    getOfficerByServiceNumber(service_number) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                // Get all officers and filter by service_number
+                // This is not ideal but we don't have a service_number index in the updated implementation
+                const allOfficers = yield this.getAllOfficers();
+                const officer = allOfficers.find((o) => o.service_number === service_number);
+                return officer || null;
+            }
+            catch (error) {
+                this.logger.error('Error getting officer by service_number from cache', {
+                    error: error instanceof Error ? error.message : String(error),
+                    service_number
+                });
+                return null;
+            }
+        });
+    }
+    /**
+     * Cache all officers from auth service
+     */
+    cacheAllOfficers() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                // Fetch officers from auth microservice
+                const authUrl = process.env.AUTH_PORT
+                    ? `http://${process.env.AUTH_HOST}:${process.env.AUTH_PORT}/api/v1/officer`
+                    : `http://${process.env.AUTH_HOST}/api/v1/officer`;
+                const response = yield fetch(authUrl);
+                if (!response.ok) {
+                    throw new Error(`Failed to fetch officers from auth service: ${response.statusText}`);
+                }
+                const result = yield response.json();
+                const officers = result.data || result;
+                if (!Array.isArray(officers)) {
+                    throw new Error('Invalid response format from auth service');
+                }
+                // Clear existing cache and store all officers
+                yield this.clearCache();
+                for (const officer of officers) {
+                    yield this.storeOfficer(officer);
+                }
+                this.logger.info('Officers cached successfully', {
+                    officerCount: officers.length
+                });
+                return officers;
+            }
+            catch (error) {
+                this.logger.error('Error caching officers', {
+                    error: error instanceof Error ? error.message : String(error)
+                });
+                throw error;
+            }
+        });
+    }
+    /**
+     * Clear all officer cache
+     */
+    clearCache() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const officerIds = yield this.redisClient.sMembers('officers:all');
+                if (officerIds.length > 0) {
+                    const pipeline = this.redisClient.multi();
+                    officerIds.forEach(id => pipeline.del(`officer:${id}`));
+                    yield pipeline.exec();
+                }
+                // Clear indexes
+                const keys = yield this.redisClient.keys('officers:*');
+                if (keys.length > 0) {
+                    yield this.redisClient.del(keys);
+                }
+            }
+            catch (error) {
+                this.logger.error('Error clearing officer cache', {
+                    error: error instanceof Error ? error.message : String(error)
+                });
+            }
+        });
+    }
+    /**
+     * Remove single officer from cache
+     */
+    removeOfficer(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const officer = yield this.getOfficerById(id);
+                if (officer) {
+                    // Remove from indexes
+                    if (officer.stationId) {
+                        yield this.redisClient.sRem(`officers:station:${officer.stationId}`, id.toString());
+                    }
+                    if (officer.rankId) {
+                        yield this.redisClient.sRem(`officers:rank:${officer.rankId}`, id.toString());
+                    }
+                    if (officer.roleId) {
+                        yield this.redisClient.sRem(`officers:role:${officer.roleId}`, id.toString());
+                    }
+                    if (officer.subCountyId) {
+                        yield this.redisClient.sRem(`officers:subCounty:${officer.subCountyId}`, id.toString());
+                    }
+                    if (officer.countyId) {
+                        yield this.redisClient.sRem(`officers:county:${officer.countyId}`, id.toString());
+                    }
+                    if (officer.regionId) {
+                        yield this.redisClient.sRem(`officers:region:${officer.regionId}`, id.toString());
+                    }
+                    // Remove from all list
+                    yield this.redisClient.sRem('officers:all', id.toString());
+                    // Remove hash
+                    yield this.redisClient.del(`officer:${id}`);
+                }
+            }
+            catch (error) {
+                this.logger.error('Error removing officer from cache', {
+                    error: error instanceof Error ? error.message : String(error),
+                    officerId: id
+                });
+            }
+        });
+    }
+}
+exports.OfficerCacheService = OfficerCacheService;

package/dist/services/officerService.d.ts

@@ -0,0 +1,25 @@
+import { SharedServicesDependencies } from '../types/dependencies';
+/**
+ * Officer Service - Handles officer retrieval with cache and auth service fallback
+ *
+ * This service:
+ * 1. First tries Redis cache (via OfficerCacheService)
+ * 2. Falls back to auth service API if cache miss
+ * 3. Stores fetched officers in cache for future use
+ */
+export declare class OfficerService {
+    private officerCacheService;
+    private logger;
+    private authHost?;
+    private authPort?;
+    constructor(deps: SharedServicesDependencies);
+    /**
+     * Get officer by ID from Redis cache, fallback to auth service
+     * First tries Redis cache, then falls back to auth service API
+     */
+    getOfficerById(officerId: string | number): Promise<any | null>;
+    /**
+     * Get officer by service number from Redis cache, fallback to auth service
+     */
+    getOfficerByServiceNumber(serviceNumber: string): Promise<any | null>;
+}

package/dist/services/officerService.js

@@ -0,0 +1,177 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OfficerService = void 0;
+const officerCacheService_1 = require("./officerCacheService");
+/**
+ * Officer Service - Handles officer retrieval with cache and auth service fallback
+ *
+ * This service:
+ * 1. First tries Redis cache (via OfficerCacheService)
+ * 2. Falls back to auth service API if cache miss
+ * 3. Stores fetched officers in cache for future use
+ */
+class OfficerService {
+    constructor(deps) {
+        this.officerCacheService = new officerCacheService_1.OfficerCacheService(deps);
+        this.logger = deps.logger;
+        this.authHost = deps.authHost || process.env.AUTH_HOST;
+        this.authPort = deps.authPort || process.env.AUTH_PORT;
+    }
+    /**
+     * Get officer by ID from Redis cache, fallback to auth service
+     * First tries Redis cache, then falls back to auth service API
+     */
+    getOfficerById(officerId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const officerIdNum = typeof officerId === 'string' ? Number(officerId) : officerId;
+                if (isNaN(officerIdNum)) {
+                    this.logger.warn('Invalid officer ID', { officerId });
+                    return null;
+                }
+                // Try cache first
+                try {
+                    const cachedOfficer = yield this.officerCacheService.getOfficerById(officerIdNum);
+                    if (cachedOfficer) {
+                        this.logger.debug(`Officer ${officerIdNum} retrieved from Redis cache`);
+                        return cachedOfficer;
+                    }
+                }
+                catch (cacheError) {
+                    this.logger.warn('Cache read error, falling back to auth service', {
+                        error: cacheError instanceof Error ? cacheError.message : String(cacheError),
+                        officerId: officerIdNum
+                    });
+                }
+                // Fallback to auth service if host is configured
+                if (!this.authHost) {
+                    this.logger.warn('Auth host not configured, cannot fetch officer from auth service', {
+                        officerId: officerIdNum
+                    });
+                    return null;
+                }
+                const authUrl = this.authPort
+                    ? `http://${this.authHost}:${this.authPort}/api/v1/officer/${officerIdNum}`
+                    : `http://${this.authHost}/api/v1/officer/${officerIdNum}`;
+                this.logger.debug(`Cache miss for officer ${officerIdNum}, fetching from auth service`);
+                const response = yield fetch(authUrl);
+                if (!response.ok) {
+                    if (response.status === 404) {
+                        this.logger.warn(`Officer ${officerIdNum} not found in auth service`);
+                        return null;
+                    }
+                    throw new Error(`Failed to fetch officer: ${response.status} ${response.statusText}`);
+                }
+                const result = yield response.json();
+                const officer = result.data || result;
+                // Store in cache for future use
+                if (officer && officer.id) {
+                    try {
+                        yield this.officerCacheService.storeOfficer(officer);
+                        this.logger.debug(`Officer ${officerIdNum} stored in cache after fetch from auth service`);
+                    }
+                    catch (cacheStoreError) {
+                        // Don't fail if cache store fails, just log
+                        this.logger.warn('Failed to store officer in cache after fetch', {
+                            error: cacheStoreError instanceof Error ? cacheStoreError.message : String(cacheStoreError),
+                            officerId: officerIdNum
+                        });
+                    }
+                }
+                this.logger.debug(`Officer ${officerIdNum} fetched from auth service`);
+                return officer;
+            }
+            catch (error) {
+                this.logger.error('Error fetching officer by ID', {
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                    officerId: officerId.toString()
+                });
+                return null;
+            }
+        });
+    }
+    /**
+     * Get officer by service number from Redis cache, fallback to auth service
+     */
+    getOfficerByServiceNumber(serviceNumber) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                if (!serviceNumber) {
+                    return null;
+                }
+                // Try cache first
+                try {
+                    const cachedOfficer = yield this.officerCacheService.getOfficerByServiceNumber(serviceNumber);
+                    if (cachedOfficer) {
+                        this.logger.debug(`Officer with service number ${serviceNumber} retrieved from Redis cache`);
+                        return cachedOfficer;
+                    }
+                }
+                catch (cacheError) {
+                    this.logger.warn('Cache read error for service number lookup, falling back to API', {
+                        error: cacheError instanceof Error ? cacheError.message : String(cacheError),
+                        serviceNumber
+                    });
+                }
+                // Fallback to auth service if host is configured
+                if (!this.authHost) {
+                    this.logger.warn('Auth host not configured, cannot fetch officer from auth service', {
+                        serviceNumber
+                    });
+                    return null;
+                }
+                const authUrl = this.authPort
+                    ? `http://${this.authHost}:${this.authPort}/api/v1/officer?service_number=${serviceNumber}`
+                    : `http://${this.authHost}/api/v1/officer?service_number=${serviceNumber}`;
+                this.logger.debug(`Cache miss for officer with service number ${serviceNumber}, fetching from auth service`);
+                const response = yield fetch(authUrl);
+                if (!response.ok) {
+                    if (response.status === 404) {
+                        this.logger.warn(`Officer with service number ${serviceNumber} not found in auth service`);
+                        return null;
+                    }
+                    throw new Error(`Failed to fetch officer: ${response.statusText}`);
+                }
+                const result = yield response.json();
+                const officers = result.data || result;
+                const officer = Array.isArray(officers) ? officers[0] : officers;
+                if (!officer) {
+                    return null;
+                }
+                // Store in cache for future use
+                if (officer && officer.id) {
+                    try {
+                        yield this.officerCacheService.storeOfficer(officer);
+                        this.logger.debug(`Officer with service number ${serviceNumber} stored in cache after fetch from auth service`);
+                    }
+                    catch (cacheStoreError) {
+                        // Don't fail if cache store fails, just log
+                        this.logger.warn('Failed to store officer in cache after fetch', {
+                            error: cacheStoreError instanceof Error ? cacheStoreError.message : String(cacheStoreError),
+                            serviceNumber
+                        });
+                    }
+                }
+                this.logger.debug(`Officer with service number ${serviceNumber} fetched from auth service`);
+                return officer;
+            }
+            catch (error) {
+                this.logger.error('Error fetching officer by service number', {
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                    serviceNumber
+                });
+                return null;
+            }
+        });
+    }
+}
+exports.OfficerService = OfficerService;

package/dist/services/penalCodeCacheService.d.ts

@@ -0,0 +1,20 @@
+import { SharedServicesDependencies } from '../types/dependencies';
+export declare class PenalCodeCacheService {
+    private redisClient;
+    private logger;
+    constructor(deps: SharedServicesDependencies);
+    /**
+     * Get penal codes from Redis cache
+     * @returns Array of penal codes or null if not found/error
+     */
+    getPenalCodes(): Promise<any[] | null>;
+    /**
+     * Store penal codes in Redis cache
+     * @param penalCodes - Array of penal codes to store
+     */
+    storePenalCodes(penalCodes: any[]): Promise<void>;
+    /**
+     * Clear penal codes from cache
+     */
+    clearCache(): Promise<void>;
+}