@planning-inspectorate/data-model 2.52.0 → 2.54.0

package/.azure/ci.yml

@@ -35,7 +35,7 @@ extends:
             displayName: Cache NPM
           - template: ../steps/node_script.yml
             parameters:
-              nodeVersion: 22
+              nodeVersion: 24
               script: npm ci
               environmentVariables:
                 npm_config_cache: $(pipeline.workspace)/.npm
@@ -43,23 +43,23 @@ extends:
             parameters:
               # only run commitlint on branches, not main
               condition: ne(variables['Build.SourceBranchName'], 'main')
-              nodeVersion: 22
+              nodeVersion: 24
               script: npm run commitlint
           - template: ../steps/node_script.yml
             parameters:
-              nodeVersion: 22
+              nodeVersion: 24
               script: npm run lint
           - template: ../steps/node_script.yml
             parameters:
-              nodeVersion: 22
+              nodeVersion: 24
               script: npm run format-check
           - template: ../steps/node_script.yml
             parameters:
-              nodeVersion: 22
+              nodeVersion: 24
               script: npm run gen
           - template: ../steps/node_script.yml
             parameters:
-              nodeVersion: 22
+              nodeVersion: 24
               script: node --test
           - script: |
               set -e

package/.azure/release.yml

@@ -44,11 +44,11 @@ jobs:
             - checkout: self
             - template: steps/node_script.yml@templates
               parameters:
-                nodeVersion: 22
+                nodeVersion: 24
                 script: npm ci
             - template: steps/node_script.yml@templates
               parameters:
-                nodeVersion: 22
+                nodeVersion: 24
                 script: npx semantic-release --branches main --tag-format '${version}' ${{ variables.dryRunFlag }}
                 environmentVariables:
                   GH_TOKEN: $(GITHUB_TOKEN)

package/docs/README.md

@@ -18,7 +18,7 @@
 
 * [Casework Representation Schema](./applications-representation.md "Representations and related document metadata for Casework Projects") – `applications-representation.schema.json`
 
-* [Crown Development Application](./applications-application.md "Main application details for Crown Development Project") – `applications-application.schema.json`
+* [Crown Development Application](./applications-crowndev-application.md "Main application details for Crown Development Project") – `applications-crowndev-application.schema.json`
 
 * [DaRT API response](./dart-response.md "Schema defining the data returned by the DaRT API") – `dart-response.schema.json`
 
@@ -80,6 +80,10 @@
 
 * [Untitled object in Appeal S78 Case](./appeal-s78-properties-applicationelbappealgroundsdetails-items.md) – `appeal-s78.schema.json#/properties/applicationElbAppealGroundsDetails/items`
 
+* [Untitled object in Appeal S78 Case](./appeal-s78-properties-enforcementcasegroundsofappeal-items.md) – `appeal-s78.schema.json#/properties/enforcementCaseGroundsOfAppeal/items`
+
+* [Untitled object in Appeal S78 Case](./appeal-s78-properties-elbcasegroundsofappeal-items.md) – `appeal-s78.schema.json#/properties/elbCaseGroundsOfAppeal/items`
+
 * [Untitled object in Appeal S78 Case](./appeal-s78-properties-significantchangesaffectingapplicationappellant-items.md) – `appeal-s78.schema.json#/properties/significantChangesAffectingApplicationAppellant/items`
 
 * [Untitled object in Appeal S78 Case](./appeal-s78-properties-significantchangesaffectingapplicationlpa-items.md) – `appeal-s78.schema.json#/properties/significantChangesAffectingApplicationLpa/items`
@@ -88,11 +92,11 @@
 
 * [Untitled object in Casework Representation Schema](./applications-representation-defs-representationdocument.md) – `applications-representation.schema.json#/$defs/representationDocument`
 
-* [Untitled object in Crown Development Application](./applications-application-defs-organisation.md) – `applications-application.schema.json#/$defs/organisation`
+* [Untitled object in Crown Development Application](./applications-crowndev-application-defs-organisation.md) – `applications-crowndev-application.schema.json#/$defs/organisation`
 
-* [Untitled object in Crown Development Application](./applications-application-defs-contact.md) – `applications-application.schema.json#/$defs/contact`
+* [Untitled object in Crown Development Application](./applications-crowndev-application-defs-contact.md) – `applications-crowndev-application.schema.json#/$defs/contact`
 
-* [Untitled object in Crown Development Application](./applications-application-defs-address.md) – `applications-application.schema.json#/$defs/address`
+* [Untitled object in Crown Development Application](./applications-crowndev-application-defs-address.md) – `applications-crowndev-application.schema.json#/$defs/address`
 
 * [Untitled object in DaRT API response](./dart-response-properties-neighbouringsiteaddresses-items.md) – `dart-response.schema.json#/properties/neighbouringSiteAddresses/items`
 
@@ -114,7 +118,7 @@
 
 * [Untitled array in Appeal Representation](./appeal-representation-properties-documentids.md "An array of documentIds") – `appeal-representation.schema.json#/properties/documentIds`
 
-* [Untitled array in Crown Development Application](./applications-application-properties-organisations.md "Applications can have one or more organisaitons associated with them") – `applications-application.schema.json#/properties/organisations`
+* [Untitled array in Crown Development Application](./applications-crowndev-application-properties-organisations.md "Applications can have one or more organisaitons associated with them") – `applications-crowndev-application.schema.json#/properties/organisations`
 
 * [Untitled array in Examination Timetable](./nsip-exam-timetable-properties-events.md) – `nsip-exam-timetable.schema.json#/properties/events`
 

package/docs/appeal-document.md

@@ -636,6 +636,7 @@ The type of document, used for exchange, migrations and consumption from the app
 | `"hearingProcess"`                     |             |
 | `"inquiryCore"`                        |             |
 | `"inquiryPostEvent"`                   |             |
+| `"noticeWithdrawal"`                   |             |
 | `null`                                 |             |
 
 ## sourceSystem

package/docs/appeal-has.md

@@ -221,21 +221,23 @@ The processing status for the appeal
 
 **enum**: the value of this property must be equal to one of the following values:
 
-| Value                   | Explanation |
-| :---------------------- | :---------- |
-| `"assign_case_officer"` |             |
-| `"validation"`          |             |
-| `"ready_to_start"`      |             |
-| `"lpa_questionnaire"`   |             |
-| `"issue_determination"` |             |
-| `"complete"`            |             |
-| `"invalid"`             |             |
-| `"closed"`              |             |
-| `"withdrawn"`           |             |
-| `"awaiting_transfer"`   |             |
-| `"transferred"`         |             |
-| `"event"`               |             |
-| `"awaiting_event"`      |             |
+| Value                      | Explanation |
+| :------------------------- | :---------- |
+| `"assign_case_officer"`    |             |
+| `"validation"`             |             |
+| `"ready_to_start"`         |             |
+| `"lpa_questionnaire"`      |             |
+| `"issue_determination"`    |             |
+| `"complete"`               |             |
+| `"invalid"`                |             |
+| `"closed"`                 |             |
+| `"withdrawn"`              |             |
+| `"awaiting_transfer"`      |             |
+| `"transferred"`            |             |
+| `"event"`                  |             |
+| `"awaiting_event"`         |             |
+| `"notice_withdrawn"`       |             |
+| `"closed_opened_in_error"` |             |
 
 ## caseType
 

package/docs/appeal-s78.md

@@ -167,6 +167,8 @@ any of
 | [occupancyConditionsMet](#occupancyconditionsmet)                                                   | `boolean` | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-occupancyconditionsmet.md "appeal-s78.schema.json#/properties/occupancyConditionsMet")                                                   |
 | [enforcementAppealGroundsDetails](#enforcementappealgroundsdetails)                                 | `array`   | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-enforcementappealgroundsdetails.md "appeal-s78.schema.json#/properties/enforcementAppealGroundsDetails")                                 |
 | [applicationElbAppealGroundsDetails](#applicationelbappealgroundsdetails)                           | `array`   | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-applicationelbappealgroundsdetails.md "appeal-s78.schema.json#/properties/applicationElbAppealGroundsDetails")                           |
+| [enforcementCaseGroundsOfAppeal](#enforcementcasegroundsofappeal)                                   | `array`   | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-enforcementcasegroundsofappeal.md "appeal-s78.schema.json#/properties/enforcementCaseGroundsOfAppeal")                                   |
+| [elbCaseGroundsOfAppeal](#elbcasegroundsofappeal)                                                   | `array`   | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-elbcasegroundsofappeal.md "appeal-s78.schema.json#/properties/elbCaseGroundsOfAppeal")                                                   |
 | [applicationMadeAndFeePaid](#applicationmadeandfeepaid)                                             | `boolean` | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-applicationmadeandfeepaid.md "appeal-s78.schema.json#/properties/applicationMadeAndFeePaid")                                             |
 | [noticeRelatesToBuildingEngineeringMiningOther](#noticerelatestobuildingengineeringminingother)     | `boolean` | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-noticerelatestobuildingengineeringminingother.md "appeal-s78.schema.json#/properties/noticeRelatesToBuildingEngineeringMiningOther")     |
 | [changeOfUseRefuseOrWaste](#changeofuserefuseorwaste)                                               | `boolean` | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-changeofuserefuseorwaste.md "appeal-s78.schema.json#/properties/changeOfUseRefuseOrWaste")                                               |
@@ -316,25 +318,27 @@ The processing status for the appeal
 
 **enum**: the value of this property must be equal to one of the following values:
 
-| Value                   | Explanation |
-| :---------------------- | :---------- |
-| `"assign_case_officer"` |             |
-| `"validation"`          |             |
-| `"ready_to_start"`      |             |
-| `"lpa_questionnaire"`   |             |
-| `"issue_determination"` |             |
-| `"statements"`          |             |
-| `"evidence"`            |             |
-| `"witnesses"`           |             |
-| `"final_comments"`      |             |
-| `"complete"`            |             |
-| `"invalid"`             |             |
-| `"closed"`              |             |
-| `"withdrawn"`           |             |
-| `"awaiting_transfer"`   |             |
-| `"transferred"`         |             |
-| `"event"`               |             |
-| `"awaiting_event"`      |             |
+| Value                      | Explanation |
+| :------------------------- | :---------- |
+| `"assign_case_officer"`    |             |
+| `"validation"`             |             |
+| `"ready_to_start"`         |             |
+| `"lpa_questionnaire"`      |             |
+| `"issue_determination"`    |             |
+| `"statements"`             |             |
+| `"evidence"`               |             |
+| `"witnesses"`              |             |
+| `"final_comments"`         |             |
+| `"complete"`               |             |
+| `"invalid"`                |             |
+| `"closed"`                 |             |
+| `"withdrawn"`              |             |
+| `"awaiting_transfer"`      |             |
+| `"transferred"`            |             |
+| `"event"`                  |             |
+| `"awaiting_event"`         |             |
+| `"notice_withdrawn"`       |             |
+| `"closed_opened_in_error"` |             |
 
 ## caseType
 
@@ -4070,6 +4074,46 @@ A list of grounds for the appeal, supporting facts & start dates. Enforcement ca
 
 `object[]` ([Details](appeal-s78-properties-applicationelbappealgroundsdetails-items.md))
 
+## enforcementCaseGroundsOfAppeal
+
+Case Officer list of grounds for the appeal & start dates. Enforcement cases (C) can have grounds (a) to (g)
+
+> Enforcement Listed Building cases (F) have a separate list of grounds (a) to (k)
+
+`enforcementCaseGroundsOfAppeal`
+
+* is optional
+
+* Type: `object[]` ([Details](appeal-s78-properties-enforcementcasegroundsofappeal-items.md))
+
+* can be null
+
+* defined in: [Appeal S78 Case](appeal-s78-properties-enforcementcasegroundsofappeal.md "appeal-s78.schema.json#/properties/enforcementCaseGroundsOfAppeal")
+
+### enforcementCaseGroundsOfAppeal Type
+
+`object[]` ([Details](appeal-s78-properties-enforcementcasegroundsofappeal-items.md))
+
+## elbCaseGroundsOfAppeal
+
+Case Officer list of grounds for the appeal & start dates. Enforcement cases (C) can have grounds (a) to (g)
+
+> Enforcement Listed Building cases (F) have a separate list of grounds (a) to (k)
+
+`elbCaseGroundsOfAppeal`
+
+* is optional
+
+* Type: `object[]` ([Details](appeal-s78-properties-elbcasegroundsofappeal-items.md))
+
+* can be null
+
+* defined in: [Appeal S78 Case](appeal-s78-properties-elbcasegroundsofappeal.md "appeal-s78.schema.json#/properties/elbCaseGroundsOfAppeal")
+
+### elbCaseGroundsOfAppeal Type
+
+`object[]` ([Details](appeal-s78-properties-elbcasegroundsofappeal-items.md))
+
 ## applicationMadeAndFeePaid
 
 Was an application made and paid for

package/docs/applications-crowndev-application-defs-address.md

@@ -0,0 +1,108 @@
+## address Type
+
+`object` ([Details](applications-crowndev-application-defs-address.md))
+
+# address Properties
+
+| Property              | Type     | Required | Nullable       | Defined by                                                                                                                                                                                |
+| :-------------------- | :------- | :------- | :------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [line1](#line1)       | `string` | Optional | can be null    | [Crown Development Application](applications-crowndev-application-defs-address-properties-line1.md "applications-crowndev-application.schema.json#/$defs/address/properties/line1")       |
+| [line2](#line2)       | `string` | Optional | can be null    | [Crown Development Application](applications-crowndev-application-defs-address-properties-line2.md "applications-crowndev-application.schema.json#/$defs/address/properties/line2")       |
+| [townCity](#towncity) | `string` | Optional | can be null    | [Crown Development Application](applications-crowndev-application-defs-address-properties-towncity.md "applications-crowndev-application.schema.json#/$defs/address/properties/townCity") |
+| [county](#county)     | `string` | Optional | can be null    | [Crown Development Application](applications-crowndev-application-defs-address-properties-county.md "applications-crowndev-application.schema.json#/$defs/address/properties/county")     |
+| [postcode](#postcode) | `string` | Required | cannot be null | [Crown Development Application](applications-crowndev-application-defs-address-properties-postcode.md "applications-crowndev-application.schema.json#/$defs/address/properties/postcode") |
+| Additional Properties | Any      | Optional | can be null    |                                                                                                                                                                                           |
+
+## line1
+
+
+
+`line1`
+
+* is optional
+
+* Type: `string`
+
+* can be null
+
+* defined in: [Crown Development Application](applications-crowndev-application-defs-address-properties-line1.md "applications-crowndev-application.schema.json#/$defs/address/properties/line1")
+
+### line1 Type
+
+`string`
+
+## line2
+
+
+
+`line2`
+
+* is optional
+
+* Type: `string`
+
+* can be null
+
+* defined in: [Crown Development Application](applications-crowndev-application-defs-address-properties-line2.md "applications-crowndev-application.schema.json#/$defs/address/properties/line2")
+
+### line2 Type
+
+`string`
+
+## townCity
+
+
+
+`townCity`
+
+* is optional
+
+* Type: `string`
+
+* can be null
+
+* defined in: [Crown Development Application](applications-crowndev-application-defs-address-properties-towncity.md "applications-crowndev-application.schema.json#/$defs/address/properties/townCity")
+
+### townCity Type
+
+`string`
+
+## county
+
+
+
+`county`
+
+* is optional
+
+* Type: `string`
+
+* can be null
+
+* defined in: [Crown Development Application](applications-crowndev-application-defs-address-properties-county.md "applications-crowndev-application.schema.json#/$defs/address/properties/county")
+
+### county Type
+
+`string`
+
+## postcode
+
+
+
+`postcode`
+
+* is required
+
+* Type: `string`
+
+* cannot be null
+
+* defined in: [Crown Development Application](applications-crowndev-application-defs-address-properties-postcode.md "applications-crowndev-application.schema.json#/$defs/address/properties/postcode")
+
+### postcode Type
+
+`string`
+
+## Additional Properties
+
+Additional properties are allowed and do not have to follow a specific schema

package/docs/applications-crowndev-application-defs-contact.md

@@ -0,0 +1,99 @@
+## contact Type
+
+`object` ([Details](applications-crowndev-application-defs-contact.md))
+
+# contact Properties
+
+| Property                                              | Type     | Required | Nullable       | Defined by                                                                                                                                                                                                                |
+| :---------------------------------------------------- | :------- | :------- | :------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| [contactId](#contactid)                               | `string` | Required | cannot be null | [Crown Development Application](applications-crowndev-application-defs-contact-properties-contactid.md "applications-crowndev-application.schema.json#/$defs/contact/properties/contactId")                               |
+| [contactPreference](#contactpreference)               | `string` | Optional | can be null    | [Crown Development Application](applications-crowndev-application-defs-contact-properties-contactpreference.md "applications-crowndev-application.schema.json#/$defs/contact/properties/contactPreference")               |
+| [writtenRepOrgName](#writtenreporgname)               | `string` | Optional | can be null    | [Crown Development Application](applications-crowndev-application-defs-contact-properties-writtenreporgname.md "applications-crowndev-application.schema.json#/$defs/contact/properties/writtenRepOrgName")               |
+| [writtenRepJobTitleorRole](#writtenrepjobtitleorrole) | `string` | Optional | can be null    | [Crown Development Application](applications-crowndev-application-defs-contact-properties-writtenrepjobtitleorrole.md "applications-crowndev-application.schema.json#/$defs/contact/properties/writtenRepJobTitleorRole") |
+| Additional Properties                                 | Any      | Optional | can be null    |                                                                                                                                                                                                                           |
+
+## contactId
+
+Source PK for Contact
+
+`contactId`
+
+* is required
+
+* Type: `string`
+
+* cannot be null
+
+* defined in: [Crown Development Application](applications-crowndev-application-defs-contact-properties-contactid.md "applications-crowndev-application.schema.json#/$defs/contact/properties/contactId")
+
+### contactId Type
+
+`string`
+
+## contactPreference
+
+
+
+`contactPreference`
+
+* is optional
+
+* Type: `string`
+
+* can be null
+
+* defined in: [Crown Development Application](applications-crowndev-application-defs-contact-properties-contactpreference.md "applications-crowndev-application.schema.json#/$defs/contact/properties/contactPreference")
+
+### contactPreference Type
+
+`string`
+
+### contactPreference Constraints
+
+**enum**: the value of this property must be equal to one of the following values:
+
+| Value     | Explanation |
+| :-------- | :---------- |
+| `"email"` |             |
+| `"post"`  |             |
+| `null`    |             |
+
+## writtenRepOrgName
+
+Organisation Name used for written-representation on behalf of an organisation
+
+`writtenRepOrgName`
+
+* is optional
+
+* Type: `string`
+
+* can be null
+
+* defined in: [Crown Development Application](applications-crowndev-application-defs-contact-properties-writtenreporgname.md "applications-crowndev-application.schema.json#/$defs/contact/properties/writtenRepOrgName")
+
+### writtenRepOrgName Type
+
+`string`
+
+## writtenRepJobTitleorRole
+
+Job Title or Role used for written-representation on behalf of an organisation
+
+`writtenRepJobTitleorRole`
+
+* is optional
+
+* Type: `string`
+
+* can be null
+
+* defined in: [Crown Development Application](applications-crowndev-application-defs-contact-properties-writtenrepjobtitleorrole.md "applications-crowndev-application.schema.json#/$defs/contact/properties/writtenRepJobTitleorRole")
+
+### writtenRepJobTitleorRole Type
+
+`string`
+
+## Additional Properties
+
+Additional properties are allowed and do not have to follow a specific schema

package/docs/applications-crowndev-application-defs-organisation.md

@@ -0,0 +1,117 @@
+## organisation Type
+
+`object` ([Details](applications-crowndev-application-defs-organisation.md))
+
+# organisation Properties
+
+| Property                                    | Type     | Required | Nullable       | Defined by                                                                                                                                                                                                                |
+| :------------------------------------------ | :------- | :------- | :------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| [contactRoleType](#contactroletype)         | `string` | Required | cannot be null | [Crown Development Application](applications-crowndev-application-defs-organisation-properties-contactroletype.md "applications-crowndev-application.schema.json#/$defs/organisation/properties/contactRoleType")         |
+| [organisationId](#organisationid)           | `string` | Required | cannot be null | [Crown Development Application](applications-crowndev-application-defs-organisation-properties-organisationid.md "applications-crowndev-application.schema.json#/$defs/organisation/properties/organisationId")           |
+| [organisationName](#organisationname)       | `string` | Optional | can be null    | [Crown Development Application](applications-crowndev-application-defs-organisation-properties-organisationname.md "applications-crowndev-application.schema.json#/$defs/organisation/properties/organisationName")       |
+| [organisationAddress](#organisationaddress) | `array`  | Optional | can be null    | [Crown Development Application](applications-crowndev-application-defs-organisation-properties-organisationaddress.md "applications-crowndev-application.schema.json#/$defs/organisation/properties/organisationAddress") |
+| [contacts](#contacts)                       | `array`  | Optional | can be null    | [Crown Development Application](applications-crowndev-application-defs-organisation-properties-contacts.md "applications-crowndev-application.schema.json#/$defs/organisation/properties/contacts")                       |
+| Additional Properties                       | Any      | Optional | can be null    |                                                                                                                                                                                                                           |
+
+## contactRoleType
+
+Agent or Applicant details
+
+`contactRoleType`
+
+* is required
+
+* Type: `string`
+
+* cannot be null
+
+* defined in: [Crown Development Application](applications-crowndev-application-defs-organisation-properties-contactroletype.md "applications-crowndev-application.schema.json#/$defs/organisation/properties/contactRoleType")
+
+### contactRoleType Type
+
+`string`
+
+### contactRoleType Constraints
+
+**enum**: the value of this property must be equal to one of the following values:
+
+| Value         | Explanation |
+| :------------ | :---------- |
+| `"agent"`     |             |
+| `"applicant"` |             |
+
+## organisationId
+
+Source PK for Organisation
+
+`organisationId`
+
+* is required
+
+* Type: `string`
+
+* cannot be null
+
+* defined in: [Crown Development Application](applications-crowndev-application-defs-organisation-properties-organisationid.md "applications-crowndev-application.schema.json#/$defs/organisation/properties/organisationId")
+
+### organisationId Type
+
+`string`
+
+## organisationName
+
+
+
+`organisationName`
+
+* is optional
+
+* Type: `string`
+
+* can be null
+
+* defined in: [Crown Development Application](applications-crowndev-application-defs-organisation-properties-organisationname.md "applications-crowndev-application.schema.json#/$defs/organisation/properties/organisationName")
+
+### organisationName Type
+
+`string`
+
+## organisationAddress
+
+
+
+`organisationAddress`
+
+* is optional
+
+* Type: `object[]` ([Details](applications-crowndev-application-defs-address.md))
+
+* can be null
+
+* defined in: [Crown Development Application](applications-crowndev-application-defs-organisation-properties-organisationaddress.md "applications-crowndev-application.schema.json#/$defs/organisation/properties/organisationAddress")
+
+### organisationAddress Type
+
+`object[]` ([Details](applications-crowndev-application-defs-address.md))
+
+## contacts
+
+An Organisation may be linked to one or more Contacts
+
+`contacts`
+
+* is optional
+
+* Type: `object[]` ([Details](applications-crowndev-application-defs-contact.md))
+
+* can be null
+
+* defined in: [Crown Development Application](applications-crowndev-application-defs-organisation-properties-contacts.md "applications-crowndev-application.schema.json#/$defs/organisation/properties/contacts")
+
+### contacts Type
+
+`object[]` ([Details](applications-crowndev-application-defs-contact.md))
+
+## Additional Properties
+
+Additional properties are allowed and do not have to follow a specific schema

package/docs/applications-crowndev-application-defs.md

@@ -0,0 +1,3 @@
+## $defs Type
+
+unknown