@govish/shared-services 1.2.0 → 1.4.0

package/CHANGELOG.md

@@ -1,11 +1,25 @@
 # Changelog
 
+## Version 1.4.0
+
+### Changed
+- **StationDutyBlockCacheService**: Fetching data only (read-only). Get methods: `getBlocks`, `getBlocksByStationId`, `getBlock`, `getSectors`, `getSector`. App remains responsible for storing and invalidating cache.
+
+---
+
+## Version 1.3.0
+
+### Added
+- **StationDutyBlockCacheService**: `getBlocksByStationId(stationId)` — get blocks by station ID from cache (key `station_blocks:${stationId}`; app populates)
+
+---
+
 ## Version 1.2.0
 
 ### Added
 - **StationDutyBlockCacheService**: Read-only cache for station-duty blocks and sectors
-  - Keys: `station_duty_blocks:${stationDutyId}`, `station_duty_block:${blockId}`, `block_sectors:${blockId}`, `block_sector:${sectorId}`
-  - `getBlocks(stationDutyId)`, `getBlock(blockId, stationDutyId?)`, `getSectors(blockId)`, `getSector(sectorId, blockId?)`
+  - Keys: `station_duty_blocks:${stationDutyId}`, `station_duty_block:${blockId}`, `block_sectors:${blockId}`, `block_sector:${sectorId}`, `station_blocks:${stationId}`
+  - `getBlocks(stationDutyId)`, `getBlocksByStationId(stationId)`, `getBlock(blockId, stationDutyId?)`, `getSectors(blockId)`, `getSector(sectorId, blockId?)`
 - **RankLeaveDaysCacheService**: Read-only cache for rank leave days
   - Keys: `rank_leave_days:${rankId}`, `rank_leave_day:${leaveDayId}`
   - `getLeaveDays(rankId)`, `getLeaveDay(leaveDayId, rankId?)`

package/README.md

@@ -29,7 +29,7 @@ const authenticateDeviceOrOfficer = createAuthenticateDeviceOrOfficer(dependenci
 - **PenalCodeCacheService**: Redis-based caching service for penal codes
 - **DeviceCacheService**: Redis-based caching service for devices with indexing
 - **StationCacheService**: Redis-based caching service for police stations (JSON list, set of IDs, and per-station hashes)
-- **StationDutyBlockCacheService**: Read-only cache for station-duty blocks and sectors (`getBlocks`, `getBlock`, `getSectors`, `getSector`)
+- **StationDutyBlockCacheService**: Read-only cache for station-duty blocks and sectors — fetch only (`getBlocks`, `getBlocksByStationId`, `getBlock`, `getSectors`, `getSector`)
 - **RankLeaveDaysCacheService**: Read-only cache for rank leave days (`getLeaveDays`, `getLeaveDay`)
 - **ApiKeyService**: Service for managing and validating API keys with Redis caching
 - **AuditService**: Service for logging audit events to Kafka with comprehensive event tracking

package/dist/services/stationDutyBlockCacheService.d.ts

@@ -11,6 +11,11 @@ export declare class StationDutyBlockCacheService {
      * Get blocks for a station-duty from cache. Returns null on miss.
      */
     getBlocks(stationDutyId: number): Promise<Array<Record<string, unknown>> | null>;
+    /**
+     * Get blocks for a station by station ID from cache. Returns null on miss.
+     * App must populate key `station_blocks:${stationId}` with a JSON array of blocks for this to hit.
+     */
+    getBlocksByStationId(stationId: number): Promise<Array<Record<string, unknown>> | null>;
     /**
      * Get one block by ID from cache. Returns null on miss.
      * If stationDutyId is provided, returns null when cached block's station_duty_id does not match.

package/dist/services/stationDutyBlockCacheService.js

@@ -10,8 +10,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StationDutyBlockCacheService = void 0;
-/** Redis keys (must match app that writes: station_duty_blocks, station_duty_block, block_sectors, block_sector) */
+/** Redis keys (must match app that writes: station_duty_blocks, station_duty_block, block_sectors, block_sector, station_blocks) */
 const BLOCKS_KEY = (stationDutyId) => `station_duty_blocks:${stationDutyId}`;
+const BLOCKS_BY_STATION_KEY = (stationId) => `station_blocks:${stationId}`;
 const BLOCK_KEY = (blockId) => `station_duty_block:${blockId}`;
 const SECTORS_KEY = (blockId) => `block_sectors:${blockId}`;
 const SECTOR_KEY = (sectorId) => `block_sector:${sectorId}`;
@@ -56,6 +57,28 @@ class StationDutyBlockCacheService {
             }
         });
     }
+    /**
+     * Get blocks for a station by station ID from cache. Returns null on miss.
+     * App must populate key `station_blocks:${stationId}` with a JSON array of blocks for this to hit.
+     */
+    getBlocksByStationId(stationId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const key = BLOCKS_BY_STATION_KEY(stationId);
+                const cached = yield this.redisClient.get(key);
+                if (!cached)
+                    return null;
+                return safeJsonParse(cached, null, this.logger);
+            }
+            catch (error) {
+                this.logger.error('Error getting blocks by station from cache', {
+                    error: error instanceof Error ? error.message : String(error),
+                    stationId,
+                });
+                return null;
+            }
+        });
+    }
     /**
      * Get one block by ID from cache. Returns null on miss.
      * If stationDutyId is provided, returns null when cached block's station_duty_id does not match.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@govish/shared-services",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Govish shared services package - officer, device, station, penal code, station-duty block, and rank leave days cache services; API key service; audit logging; authentication middleware",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",