Release: 2024-01-23

backend/core/package.json

@@ -39,7 +39,7 @@
   },
   "dependencies": {
     "@anchan828/nest-sendgrid": "^0.3.25",
-    "@google-cloud/translate": "^6.2.6",
+    "@google-cloud/translate": "^7.2.1",
     "@nestjs/axios": "1.0.1",
     "@nestjs/cli": "^9.5.0",
     "@nestjs/common": "^9.4.2",
@@ -52,9 +52,13 @@
     "@nestjs/swagger": "^6.3.0",
     "@nestjs/throttler": "^4.0.0",
     "@nestjs/typeorm": "^9.0.1",
+    "@turf/buffer": "6.5.0",
+    "@turf/helpers": "6.5.0",
+    "@turf/boolean-point-in-polygon": "6.5.0",
+    "@turf/points-within-polygon": "6.5.0",
     "@types/cache-manager": "^3.4.0",
     "async-retry": "^1.3.1",
-    "axios": "0.21.2",
+    "axios": "0.21.3",
     "cache-manager": "^3.4.0",
     "casbin": "5.13.0",
     "class-transformer": "0.3.1",
@@ -72,17 +76,17 @@
     "nanoid": "^3.1.12",
     "nestjs-twilio": "^4.1.1",
     "nestjs-typeorm-paginate": "^4.0.3",
-    "newrelic": "7.5.1",
+    "newrelic": "11.4.0",
     "node-polyglot": "^2.4.0",
     "passport": "^0.6.0",
     "passport-custom": "^1.1.1",
-    "passport-jwt": "^4.0.0",
+    "passport-jwt": "^4.0.1",
     "passport-local": "^1.0.0",
-    "pg": "^8.4.1",
+    "pg": "^8.11.3",
     "reflect-metadata": "^0.1.13",
     "rimraf": "^3.0.2",
     "rxjs": "^7.5.4",
-    "swagger-ui-express": "^4.1.4",
+    "swagger-ui-express": "^4.2.0",
     "ts-node": "10.8.0",
     "twilio": "^3.71.3",
     "typeorm": "0.3.12",

backend/core/src/app.module.ts

@@ -37,6 +37,7 @@ import { PaperApplicationsModule } from "./paper-applications/paper-applications
 import { ActivityLogModule } from "./activity-log/activity-log.module"
 import { logger } from "./shared/middlewares/logger.middleware"
 import { CatchAllFilter } from "./shared/filters/catch-all-filter"
+import { MapLayersModule } from "./map-layers/map-layers.module"
 
 export function applicationSetup(app: INestApplication) {
   const { httpAdapter } = app.get(HttpAdapterHost)
@@ -106,6 +107,7 @@ export class AppModule {
         UnitTypesModule,
         UnitRentTypesModule,
         UnitAccessibilityPriorityTypesModule,
+        MapLayersModule,
       ],
     }
   }

backend/core/src/applications/applications.module.ts

@@ -7,6 +7,7 @@ import { SharedModule } from "../shared/shared.module"
 import { ListingsModule } from "../listings/listings.module"
 import { Address } from "../shared/entities/address.entity"
 import { Applicant } from "./entities/applicant.entity"
+import { MapLayer } from "../map-layers/entities/map-layer.entity"
 import { ApplicationsSubmissionController } from "./applications-submission.controller"
 import { TranslationsModule } from "../translations/translations.module"
 import { Listing } from "../listings/entities/listing.entity"
@@ -16,10 +17,11 @@ import { CsvBuilder } from "./services/csv-builder.service"
 import { ApplicationCsvExporterService } from "./services/application-csv-exporter.service"
 import { EmailModule } from "../email/email.module"
 import { ActivityLogModule } from "../activity-log/activity-log.module"
+import { GeocodingService } from "./services/geocoding.service"
 
 @Module({
   imports: [
-    TypeOrmModule.forFeature([Application, Applicant, Address, Listing]),
+    TypeOrmModule.forFeature([Application, Applicant, Address, Listing, MapLayer]),
     AuthModule,
     ActivityLogModule,
     SharedModule,
@@ -28,7 +30,7 @@ import { ActivityLogModule } from "../activity-log/activity-log.module"
     EmailModule,
     ScheduleModule.forRoot(),
   ],
-  providers: [ApplicationsService, CsvBuilder, ApplicationCsvExporterService],
+  providers: [ApplicationsService, CsvBuilder, ApplicationCsvExporterService, GeocodingService],
   exports: [ApplicationsService],
   controllers: [ApplicationsController, ApplicationsSubmissionController],
 })

backend/core/src/applications/helpers.ts

@@ -1,6 +1,6 @@
 import dayjs from "dayjs"
 import { formatLocalDate } from "../shared/utils/format-local-date"
-import { ApplicationSubmissionType } from "../../types"
+import { ApplicationSubmissionType, GeocodingValues } from "../../types"
 import { isEmpty } from "class-validator"
 
 export const formatApplicationDate = (
@@ -14,3 +14,15 @@ export const formatApplicationDate = (
   }
   return dayjs(dateString).format("MM-DD-YYYY hh:mm:ssA")
 }
+
+export const formatGeocodingValues = (key: GeocodingValues) => {
+  switch (key) {
+    case GeocodingValues.true:
+      return "Yes"
+    case GeocodingValues.false:
+      return "No"
+    case GeocodingValues.unknown:
+    default:
+      return "Needs Manual Verification"
+  }
+}

backend/core/src/applications/services/application-csv-exporter.service.ts

@@ -5,7 +5,8 @@ import { formatBoolean } from "../../shared/utils/format-boolean"
 import { ApplicationMultiselectQuestion } from "../entities/application-multiselect-question.entity"
 import { AddressCreateDto } from "../../shared/dto/address.dto"
 import { ApplicationReviewStatus } from "../types/application-review-status-enum"
-import { formatApplicationDate } from "../helpers"
+import { formatApplicationDate, formatGeocodingValues } from "../helpers"
+import { GeocodingValues } from "../../shared/types/geocoding-values"
 
 @Injectable({ scope: Scope.REQUEST })
 export class ApplicationCsvExporterService {
@@ -88,20 +89,44 @@ export class ApplicationCsvExporterService {
           claimedString = claimedString.concat(`${option.key}, `)
         }
         if (option.extraData?.length) {
-          const extraKey = `${root}: ${option.key} - Address`
+          let extraKey
           let extraString = ""
-          option.extraData.forEach((extra) => {
-            if (extra.type === "address") {
-              extraString += `${(extra.value as AddressCreateDto).street}, ${
-                (extra.value as AddressCreateDto).street2
-                  ? `${(extra.value as AddressCreateDto).street2},`
-                  : ""
-              } ${(extra.value as AddressCreateDto).city}, ${
-                (extra.value as AddressCreateDto).state
-              }, ${(extra.value as AddressCreateDto).zipCode}`
-            }
-          })
-          extraData[extraKey] = extraString
+          const order = [
+            "address",
+            "geocodingVerified",
+            "addressHolderName",
+            "addressHolderRelationship",
+          ]
+
+          option.extraData
+            .sort((a, b) => order.indexOf(a.key) - order.indexOf(b.key))
+            .forEach((extra) => {
+              if (extra.type === "address") {
+                extraKey = `${root}: ${option.key} - Provided Address`
+                extraString += `${(extra.value as AddressCreateDto).street}, ${
+                  (extra.value as AddressCreateDto).street2
+                    ? `${(extra.value as AddressCreateDto).street2},`
+                    : ""
+                } ${(extra.value as AddressCreateDto).city}, ${
+                  (extra.value as AddressCreateDto).state
+                }, ${(extra.value as AddressCreateDto).zipCode}`
+              }
+              if (extra.type === "text") {
+                if (extra.key === "geocodingVerified") {
+                  extraKey = `${root}: ${option.key} - Passed Address Check`
+                  extraString = formatGeocodingValues(extra.value as GeocodingValues)
+                }
+                if (extra.key === "addressHolderName") {
+                  extraKey = `${root}: ${option.key} - Name of Address Holder`
+                  extraString = extra.value as string
+                }
+                if (extra.key === "addressHolderRelationship") {
+                  extraKey = `${root}: ${option.key} - Relationship to Address Holder`
+                  extraString = extra.value as string
+                }
+              }
+              extraData[extraKey] = extraString
+            })
         }
       })
       preferenceKeys[root] = 1

backend/core/src/applications/services/applications.service.ts

@@ -29,6 +29,7 @@ import { Listing } from "../../listings/entities/listing.entity"
 import { ApplicationCsvExporterService } from "./application-csv-exporter.service"
 import { User } from "../../auth/entities/user.entity"
 import { StatusDto } from "../../shared/dto/status.dto"
+import { GeocodingService } from "./geocoding.service"
 
 @Injectable({ scope: Scope.REQUEST })
 export class ApplicationsService {
@@ -38,6 +39,7 @@ export class ApplicationsService {
     private readonly listingsService: ListingsService,
     private readonly emailService: EmailService,
     private readonly applicationCsvExporter: ApplicationCsvExporterService,
+    private readonly geocodingService: GeocodingService,
     @InjectRepository(Application) private readonly repository: Repository<Application>,
     @InjectRepository(Listing) private readonly listingsRepository: Repository<Listing>
   ) {}
@@ -423,6 +425,15 @@ export class ApplicationsService {
     if (application.applicant.emailAddress && shouldSendConfirmation) {
       await this.emailService.confirmation(listing, application, applicationCreateDto.appUrl)
     }
+
+    // Calculate geocoding preferences after save and email sent
+    if (listing.jurisdiction?.enableGeocodingPreferences) {
+      try {
+        void this.geocodingService.validateGeocodingPreferences(application, listing)
+      } catch (e) {
+        console.warn("error while validating geocoding preferences")
+      }
+    }
     return application
   }