@defra/fcp-sfd-frontend-engine 0.19.0 → 0.20.0

package/dist/index.cjs

@@ -793,6 +793,62 @@ var updateCustomerEmailMutation = `
   }
 `;
 
+// src/mutations/personal/update-customer-address.js
+var updateCustomerAddressMutation = `
+  mutation UpdateCustomerAddress($input: UpdateCustomerAddressInput!) {
+    updateCustomerAddress(input: $input) {
+      customer {
+        info {
+          address {
+            line1
+            line2
+            line3
+            line4
+            line5
+            postalCode
+            country
+            city
+            buildingNumberRange
+            buildingName
+            flatName
+            street
+            county
+            uprn
+          }
+        }
+      }
+    }
+  }
+`;
+
+// src/mutations/business/update-business-address.js
+var updateBusinessAddressMutation = `
+  mutation UpdateBusinessAddress($input: UpdateBusinessAddressInput!) {
+    updateBusinessAddress(input: $input) {
+      business {
+        info {
+          address {
+            line1
+            line2
+            line3
+            line4
+            line5
+            postalCode
+            country
+            city
+            buildingNumberRange
+            buildingName
+            flatName
+            street
+            county
+            uprn
+          }
+        }
+      }
+    }
+  }
+`;
+
 // src/mutations/mutations.js
 var mutations = {
   updateBusinessEmail: updateBusinessEmailMutation,
@@ -800,7 +856,9 @@ var mutations = {
   updateCustomerName: updateCustomerNameMutation,
   updateCustomerDob: updateCustomerDobMutation,
   updateCustomerPhone: updateCustomerPhoneMutation,
-  updateCustomerEmail: updateCustomerEmailMutation
+  updateCustomerEmail: updateCustomerEmailMutation,
+  updateCustomerAddress: updateCustomerAddressMutation,
+  updateBusinessAddress: updateBusinessAddressMutation
 };
 
 // src/presenters/base-presenter.js
@@ -1321,9 +1379,64 @@ var isRetryable = (error) => {
   return false;
 };
 
+// src/services/build-address-variables-service.js
+var buildUprnAddress = (change) => {
+  return {
+    pafOrganisationName: nullIfUndefined(change.pafOrganisationName),
+    buildingNumberRange: nullIfUndefined(change.buildingNumberRange),
+    buildingName: nullIfUndefined(change.buildingName),
+    flatName: nullIfUndefined(change.flatName),
+    street: nullIfUndefined(change.street),
+    city: nullIfUndefined(change.city),
+    county: nullIfUndefined(change.county),
+    postalCode: nullIfUndefined(change.postcode),
+    country: nullIfUndefined(change.country),
+    dependentLocality: nullIfUndefined(change.dependentLocality),
+    doubleDependentLocality: nullIfUndefined(change.doubleDependentLocality),
+    line1: null,
+    line2: null,
+    line3: null,
+    line4: null,
+    line5: null,
+    uprn: change.uprn
+    // required for DAL/v1
+  };
+};
+var buildManualAddress = (change) => {
+  return {
+    pafOrganisationName: null,
+    buildingNumberRange: null,
+    buildingName: null,
+    flatName: null,
+    street: null,
+    dependentLocality: null,
+    doubleDependentLocality: null,
+    county: null,
+    uprn: null,
+    line1: change.address1,
+    // required for DAL/v1
+    line2: nullIfUndefined(change.address2),
+    line3: nullIfUndefined(change.address3),
+    line4: nullIfUndefined(change.county),
+    // manual county mapped for validation
+    line5: null,
+    city: change.city,
+    // required for DAL/v1
+    postalCode: change.postcode,
+    // required for DAL/v1
+    country: change.country
+    // required for DAL/v1
+  };
+};
+var nullIfUndefined = (value) => {
+  return value ?? null;
+};
+
 // src/services/services.js
 var services = {
-  addressLookup: addressLookupService
+  addressLookup: addressLookupService,
+  buildUprnAddress,
+  buildManualAddress
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.js

@@ -752,6 +752,62 @@ var updateCustomerEmailMutation = `
   }
 `;
 
+// src/mutations/personal/update-customer-address.js
+var updateCustomerAddressMutation = `
+  mutation UpdateCustomerAddress($input: UpdateCustomerAddressInput!) {
+    updateCustomerAddress(input: $input) {
+      customer {
+        info {
+          address {
+            line1
+            line2
+            line3
+            line4
+            line5
+            postalCode
+            country
+            city
+            buildingNumberRange
+            buildingName
+            flatName
+            street
+            county
+            uprn
+          }
+        }
+      }
+    }
+  }
+`;
+
+// src/mutations/business/update-business-address.js
+var updateBusinessAddressMutation = `
+  mutation UpdateBusinessAddress($input: UpdateBusinessAddressInput!) {
+    updateBusinessAddress(input: $input) {
+      business {
+        info {
+          address {
+            line1
+            line2
+            line3
+            line4
+            line5
+            postalCode
+            country
+            city
+            buildingNumberRange
+            buildingName
+            flatName
+            street
+            county
+            uprn
+          }
+        }
+      }
+    }
+  }
+`;
+
 // src/mutations/mutations.js
 var mutations = {
   updateBusinessEmail: updateBusinessEmailMutation,
@@ -759,7 +815,9 @@ var mutations = {
   updateCustomerName: updateCustomerNameMutation,
   updateCustomerDob: updateCustomerDobMutation,
   updateCustomerPhone: updateCustomerPhoneMutation,
-  updateCustomerEmail: updateCustomerEmailMutation
+  updateCustomerEmail: updateCustomerEmailMutation,
+  updateCustomerAddress: updateCustomerAddressMutation,
+  updateBusinessAddress: updateBusinessAddressMutation
 };
 
 // src/presenters/base-presenter.js
@@ -1280,9 +1338,64 @@ var isRetryable = (error) => {
   return false;
 };
 
+// src/services/build-address-variables-service.js
+var buildUprnAddress = (change) => {
+  return {
+    pafOrganisationName: nullIfUndefined(change.pafOrganisationName),
+    buildingNumberRange: nullIfUndefined(change.buildingNumberRange),
+    buildingName: nullIfUndefined(change.buildingName),
+    flatName: nullIfUndefined(change.flatName),
+    street: nullIfUndefined(change.street),
+    city: nullIfUndefined(change.city),
+    county: nullIfUndefined(change.county),
+    postalCode: nullIfUndefined(change.postcode),
+    country: nullIfUndefined(change.country),
+    dependentLocality: nullIfUndefined(change.dependentLocality),
+    doubleDependentLocality: nullIfUndefined(change.doubleDependentLocality),
+    line1: null,
+    line2: null,
+    line3: null,
+    line4: null,
+    line5: null,
+    uprn: change.uprn
+    // required for DAL/v1
+  };
+};
+var buildManualAddress = (change) => {
+  return {
+    pafOrganisationName: null,
+    buildingNumberRange: null,
+    buildingName: null,
+    flatName: null,
+    street: null,
+    dependentLocality: null,
+    doubleDependentLocality: null,
+    county: null,
+    uprn: null,
+    line1: change.address1,
+    // required for DAL/v1
+    line2: nullIfUndefined(change.address2),
+    line3: nullIfUndefined(change.address3),
+    line4: nullIfUndefined(change.county),
+    // manual county mapped for validation
+    line5: null,
+    city: change.city,
+    // required for DAL/v1
+    postalCode: change.postcode,
+    // required for DAL/v1
+    country: change.country
+    // required for DAL/v1
+  };
+};
+var nullIfUndefined = (value) => {
+  return value ?? null;
+};
+
 // src/services/services.js
 var services = {
-  addressLookup: addressLookupService
+  addressLookup: addressLookupService,
+  buildUprnAddress,
+  buildManualAddress
 };
 export {
   constants,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defra/fcp-sfd-frontend-engine",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "Shared frontend engine used by both the internal and external frontend applications.",
   "main": "./dist/index.cjs",
   "exports": {

package/src/mutations/business/update-business-address.js

@@ -0,0 +1,26 @@
+export const updateBusinessAddressMutation = `
+  mutation UpdateBusinessAddress($input: UpdateBusinessAddressInput!) {
+    updateBusinessAddress(input: $input) {
+      business {
+        info {
+          address {
+            line1
+            line2
+            line3
+            line4
+            line5
+            postalCode
+            country
+            city
+            buildingNumberRange
+            buildingName
+            flatName
+            street
+            county
+            uprn
+          }
+        }
+      }
+    }
+  }
+`

package/src/mutations/mutations.js

@@ -4,6 +4,8 @@ import { updateCustomerNameMutation } from './personal/update-customer-name.js'
 import { updateCustomerDobMutation } from './personal/update-customer-dob.js'
 import { updateCustomerPhoneMutation } from './personal/update-customer-phone.js'
 import { updateCustomerEmailMutation } from './personal/update-customer-email.js'
+import { updateCustomerAddressMutation } from './personal/update-customer-address.js'
+import { updateBusinessAddressMutation } from './business/update-business-address.js'
 
 export const mutations = {
   updateBusinessEmail: updateBusinessEmailMutation,
@@ -11,5 +13,7 @@ export const mutations = {
   updateCustomerName: updateCustomerNameMutation,
   updateCustomerDob: updateCustomerDobMutation,
   updateCustomerPhone: updateCustomerPhoneMutation,
-  updateCustomerEmail: updateCustomerEmailMutation
+  updateCustomerEmail: updateCustomerEmailMutation,
+  updateCustomerAddress: updateCustomerAddressMutation,
+  updateBusinessAddress: updateBusinessAddressMutation,
 }

package/src/mutations/personal/update-customer-address.js

@@ -0,0 +1,26 @@
+export const updateCustomerAddressMutation = `
+  mutation UpdateCustomerAddress($input: UpdateCustomerAddressInput!) {
+    updateCustomerAddress(input: $input) {
+      customer {
+        info {
+          address {
+            line1
+            line2
+            line3
+            line4
+            line5
+            postalCode
+            country
+            city
+            buildingNumberRange
+            buildingName
+            flatName
+            street
+            county
+            uprn
+          }
+        }
+      }
+    }
+  }
+`

package/src/services/build-address-variables-service.js

@@ -0,0 +1,107 @@
+/**
+ * Service to build address variables for DAL mutations
+ *
+ * Supports both postcode lookup (with UPRN) and manually entered addresses.
+ * Handles normalization of optional fields, city, county, PO BOX, dependentLocality,
+ * and doubleDependentLocality. Returns an address object ready for the DAL mutation.
+ *
+ * @module buildAddressVariablesService
+ */
+
+/**
+ * Builds address variables for an address chosen via postcode lookup (with UPRN).
+ * When a UPRN is present, it is the only required field. The rest of the address
+ * data is included but the DAL/v1 does not apply further validation.
+ *
+ * Optional fields are normalized using nullIfUndefined to ensure they are
+ * explicitly set to `null` rather than being left `undefined`.
+ *
+ * @param {Object} change - The address change object containing UPRN and address fields
+ * @returns {Object} Address object formatted for DAL/v1 with UPRN
+ */
+const buildUprnAddress = (change) => {
+  return {
+    pafOrganisationName: nullIfUndefined(change.pafOrganisationName),
+    buildingNumberRange: nullIfUndefined(change.buildingNumberRange),
+    buildingName: nullIfUndefined(change.buildingName),
+    flatName: nullIfUndefined(change.flatName),
+    street: nullIfUndefined(change.street),
+    city: nullIfUndefined(change.city),
+    county: nullIfUndefined(change.county),
+    postalCode: nullIfUndefined(change.postcode),
+    country: nullIfUndefined(change.country),
+    dependentLocality: nullIfUndefined(change.dependentLocality),
+    doubleDependentLocality: nullIfUndefined(change.doubleDependentLocality),
+    line1: null,
+    line2: null,
+    line3: null,
+    line4: null,
+    line5: null,
+    uprn: change.uprn // required for DAL/v1
+  }
+}
+
+/**
+ * Builds address variables for a manually entered address (without UPRN).
+ *
+ * When there is no UPRN, the DAL/v1 applies stricter validation and requires
+ * the following fields:
+ * - `line1`
+ * - `city`
+ * - `postalCode`
+ * - `country`
+ *
+ * The manually entered address fields are mapped into the DAL structure as follows:
+ *
+ * | User input field | DAL field |
+ * |------------------|-----------|
+ * | address1         | line1     |
+ * | address2         | line2     |
+ * | address3         | line3     |
+ * | county           | line4     |
+ * | city             | city      |
+ *
+ * `line5` is not used for manual addresses and is explicitly set to `null`.
+ *
+ * Optional fields are normalized using `nullIfUndefined` so that `undefined`
+ * values are converted to `null`, ensuring consistent data sent to the DAL.
+ *
+ * @param {Object} change - The address change object containing manually entered address fields
+ * @returns {Object} Address object formatted for DAL/v1 without UPRN
+ */
+const buildManualAddress = (change) => {
+  return {
+    pafOrganisationName: null,
+    buildingNumberRange: null,
+    buildingName: null,
+    flatName: null,
+    street: null,
+    dependentLocality: null,
+    doubleDependentLocality: null,
+    county: null,
+    uprn: null,
+    line1: change.address1, // required for DAL/v1
+    line2: nullIfUndefined(change.address2),
+    line3: nullIfUndefined(change.address3),
+    line4: nullIfUndefined(change.county), // manual county mapped for validation
+    line5: null,
+    city: change.city, // required for DAL/v1
+    postalCode: change.postcode, // required for DAL/v1
+    country: change.country // required for DAL/v1
+  }
+}
+
+/**
+ * Normalizes a value to null if it is undefined.
+ * @param {*} value - The value to normalize
+ * @returns {*|null} The value if defined, otherwise null
+ * @private
+ */
+const nullIfUndefined = (value) => {
+  return value ?? null
+}
+
+export {
+  buildUprnAddress,
+  buildManualAddress
+}

package/src/services/services.js

@@ -1,5 +1,8 @@
 import { addressLookupService } from './os-places/address-lookup-service.js'
+import { buildUprnAddress, buildManualAddress } from './build-address-variables-service.js'
 
 export const services = {
-  addressLookup: addressLookupService
+  addressLookup: addressLookupService,
+  buildUprnAddress,
+  buildManualAddress
 }