@planning-inspectorate/data-model 2.4.1 → 2.6.0

package/docs/nsip-meeting.md

@@ -192,6 +192,16 @@ Type of Meeting
 
 `string`
 
+### meetingType Constraints
+
+**enum**: the value of this property must be equal to one of the following values:
+
+| Value             | Explanation |
+| :---------------- | :---------- |
+| `"evidence_plan"` |             |
+| `"project"`       |             |
+| `null`            |             |
+
 ## Additional Properties
 
 Additional properties are allowed and do not have to follow a specific schema

package/docs/nsip-project-defs-meeting.md

@@ -142,6 +142,16 @@ Type of Meeting
 
 `string`
 
+### meetingType Constraints
+
+**enum**: the value of this property must be equal to one of the following values:
+
+| Value             | Explanation |
+| :---------------- | :---------- |
+| `"evidence_plan"` |             |
+| `"project"`       |             |
+| `null`            |             |
+
 ## Additional Properties
 
 Additional properties are allowed and do not have to follow a specific schema

package/docs/nsip-project.md

@@ -3730,6 +3730,16 @@ Type of Meeting
 
 `string`
 
+#### meetingType Constraints
+
+**enum**: the value of this property must be equal to one of the following values:
+
+| Value             | Explanation |
+| :---------------- | :---------- |
+| `"evidence_plan"` |             |
+| `"project"`       |             |
+| `null`            |             |
+
 ### Additional Properties
 
 Additional properties are allowed and do not have to follow a specific schema

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planning-inspectorate/data-model",
-  "version": "2.4.1",
+  "version": "2.6.0",
   "description": "JSON Schemas for the Planning Inspectorate's Data Model",
   "main": "src/index.js",
   "type": "module",

package/pins_data_model/models/model_appeal_document.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-document.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:16+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_appeal_event.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-event.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:16+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_appeal_event_estimate.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-event-estimate.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:16+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_appeal_has.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-has.schema.json
-#   timestamp: 2025-12-15T10:41:08+00:00
+#   timestamp: 2026-01-06T14:32:17+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_appeal_representation.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-representation.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:17+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_appeal_s78.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-s78.schema.json
-#   timestamp: 2025-12-15T10:41:08+00:00
+#   timestamp: 2026-01-06T14:32:18+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_dart_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  dart-response.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:18+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_entraid.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  entraid.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:18+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_folder.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  folder.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:18+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_gettimesheets_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  gettimesheets-response.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:18+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_listed_building.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  listed-building.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:18+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_listed_buildings.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  listed-buildings.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:18+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_nsip_document.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-document.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:18+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_nsip_exam_timetable.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-exam-timetable.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:18+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_nsip_invoice.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-invoice.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:18+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_nsip_meeting.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-meeting.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:18+00:00
 
 from __future__ import annotations
 
@@ -20,6 +20,16 @@ class PlanningInspectorateRole(Enum):
     NoneType_None = None
 
 
+class MeetingType(Enum):
+    """
+    Type of Meeting
+    """
+
+    evidence_plan = "evidence_plan"
+    project = "project"
+    NoneType_None = None
+
+
 class NsipMeeting(BaseModel):
     """
     NSIP Standalone Meeting Schema for ODW Curated layer
@@ -53,7 +63,7 @@ class NsipMeeting(BaseModel):
     """
     Meeting date
     """
-    meetingType: str | None = None
+    meetingType: MeetingType
     """
     Type of Meeting
     """

package/pins_data_model/models/model_nsip_project.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-project.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:19+00:00
 
 from __future__ import annotations
 
@@ -292,6 +292,16 @@ class PlanningInspectorateRole(Enum):
     NoneType_None = None
 
 
+class MeetingType(Enum):
+    """
+    Type of Meeting
+    """
+
+    evidence_plan = "evidence_plan"
+    project = "project"
+    NoneType_None = None
+
+
 class Meeting(BaseModel):
     """
     A meeting related to the project
@@ -320,7 +330,7 @@ class Meeting(BaseModel):
     """
     Meeting date
     """
-    meetingType: str | None = None
+    meetingType: MeetingType | None = None
     """
     Type of Meeting
     """

package/pins_data_model/models/model_nsip_project_update.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-project-update.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:18+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_nsip_representation.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-representation.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:19+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_nsip_subscription.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-subscription.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:19+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_pins_inspector.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  pins-inspector.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:19+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_pins_lpa.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  pins-lpa.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:19+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_s51_advice.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  s51-advice.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:19+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_service_user.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  service-user.schema.json
-#   timestamp: 2025-12-02T17:41:26+00:00
+#   timestamp: 2026-01-06T14:32:19+00:00
 
 from __future__ import annotations
 

package/schemas/commands/appeals-components/appeal-enforcement-submission.schema.json

@@ -0,0 +1,325 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "commands/appeals-components/appeal-enforcement-submission.schema.json",
+  "title": "Appellant enforcement submission properties",
+  "description": "Schema defining any properties for enforcement appeals",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "submissionId",
+    "caseProcedure",
+    "lpaCode",
+    "caseSubmittedDate",
+    "enforcementNotice",
+    "enforcementReference",
+    "caseSubmissionDueDate",
+    "enforcementIssueDate",
+    "enforcementEffectiveDate"
+  ],
+  "anyOf": [
+    {
+      "required": ["siteGridReferenceEasting", "siteGridReferenceNorthing"],
+      "properties": {
+        "siteGridReferenceEasting": { "type": "string" },
+        "siteGridReferenceNorthing": { "type": "string" }
+      }
+    },
+    {
+      "required": ["siteAddressLine1", "siteAddressTown", "siteAddressPostcode"],
+      "properties": {
+        "siteAddressLine1": { "type": "string" },
+        "siteAddressTown": { "type": "string" },
+        "siteAddressPostcode": { "type": "string" }
+      }
+    }
+  ],
+  "properties": {
+    "submissionId": {
+      "type": "string",
+      "format": "uuid",
+      "examples": ["7f45748c-2342-4b59-b934-ad6183e8d834"],
+      "description": "Case submission id - link to draft submission created by appellant"
+    },
+    "caseProcedure": {
+      "type": "string",
+      "enum": ["written", "hearing", "inquiry"],
+      "description": "The type of procedure for the appeal"
+    },
+    "lpaCode": {
+      "type": "string",
+      "examples": ["Q9999"],
+      "description": "A unique identifier for the Local Planning Authority",
+      "$comment": "Uses the internal PINS code identifying LPAs"
+    },
+    "caseSubmittedDate": {
+      "type": "string",
+      "format": "date-time",
+      "examples": ["2023-07-27T20:30:00.000Z"],
+      "description": "The date the appeal was submitted by the appellant"
+    },
+    "enforcementNotice": {
+      "type": ["boolean", "null"],
+      "description": "Indicates if an enforcement notice is the reason for the appeal"
+    },
+    "enforcementReference": {
+      "type": "string",
+      "examples": ["123456"],
+      "description": "The unique identifier of the enforcement notice"
+    },
+    "enforcementIssueDate": {
+      "type": "string",
+      "format": "date-time",
+      "examples": ["2023-07-27T20:30:00.000Z"],
+      "description": "The date the enforcement notice was issued"
+    },
+    "enforcementEffectiveDate": {
+      "type": "string",
+      "format": "date-time",
+      "examples": ["2023-07-27T20:30:00.000Z"],
+      "description": "The date the enforcement notice took effect"
+    },
+    "contactPlanningInspectorateDate": {
+      "type": ["string", "null"],
+      "format": "date-time",
+      "examples": ["2023-07-27T20:30:00.000Z"],
+      "description": "The date the enforcement notice took effect"
+    },
+    "interestInLand": {
+      "type": ["string", "null"],
+      "examples": ["owner, tenant, mortgage holder, other"],
+      "description": "The individual's interest in the appeal land"
+    },
+    "writtenOrVerbalPermission": {
+      "type": ["string", "null"],
+      "examples": ["yes, no"],
+      "description": "If required, whether the individual has permission to use the appeal land"
+    },
+    "descriptionOfAllegedBreach": {
+      "type": ["string", "null"],
+      "description": "A description of the alleged breach"
+    },
+    "applicationMadeAndFeePaid": {
+      "type": ["boolean", "null"],
+      "description": "Whether a planning application was made"
+    },
+    "applicationDevelopmentAllOrPart": {
+      "type": ["string", "null"],
+      "enum": ["all-of-the-development", "part-of-the-development", null],
+      "description": "Did the application relate to all or part of the development"
+    },
+    "originalDevelopmentDescription": {
+      "type": ["string", "null"],
+      "description": "A description of the proposed development"
+    },
+    "changedDevelopmentDescription": {
+      "type": ["boolean", "null"],
+      "description": "An updated description of the proposed development"
+    },
+    "applicationReference": {
+      "type": ["string", "null"],
+      "examples": ["43010/APP/1/290572"],
+      "description": "The unique identifier of the LPA application"
+    },
+    "applicationDate": {
+      "type": ["string", "null"],
+      "format": "date-time",
+      "examples": ["2023-07-27T20:30:00.000Z"],
+      "description": "The date of the original LPA application"
+    },
+    "applicationDecision": {
+      "type": ["string", "null"],
+      "enum": ["granted", "refused", "not_received", null],
+      "description": "The outcome of the original LPA decision"
+    },
+    "applicationDecisionDate": {
+      "type": ["string", "null"],
+      "format": "date-time",
+      "examples": ["2023-07-27T20:30:00.000Z"],
+      "description": "The date of the original LPA decision"
+    },
+    "applicationDecisionAppealed": {
+      "type": ["boolean", "null"],
+      "description": "Whether an appeal was made against the original LPA decision"
+    },
+    "appealDecisionDate": {
+      "type": ["string", "null"],
+      "format": "date-time",
+      "examples": ["2023-07-27T20:30:00.000Z"],
+      "description": "The date of the appeal against the original LPA decision"
+    },
+    "caseSubmissionDueDate": {
+      "type": ["string", "null"],
+      "format": "date-time",
+      "examples": ["2023-07-27T20:30:00.000Z"],
+      "description": "The statutory deadline for submitting an appeal from the original LPA decision date",
+      "$comment": "Calculated from the applicationDecisionDate"
+    },
+    "siteAddressLine1": {
+      "type": ["string", "null"],
+      "examples": ["96 The Avenue"],
+      "description": "First line of address for the appeal site"
+    },
+    "siteAddressLine2": {
+      "type": ["string", "null"],
+      "description": "Second line of address for the appeal site"
+    },
+    "siteAddressTown": {
+      "type": ["string", "null"],
+      "examples": ["Maidstone"],
+      "description": "Town / City of the site address"
+    },
+    "siteAddressCounty": {
+      "type": ["string", "null"],
+      "examples": ["Kent"],
+      "description": "County of the site address"
+    },
+    "siteAddressPostcode": {
+      "type": ["string", "null"],
+      "examples": ["MD21 5XY"],
+      "description": "Postal code of the site address"
+    },
+    "siteGridReferenceEasting": {
+      "type": ["string", "null"],
+      "pattern": "^\\d{6,7}$",
+      "examples": ["357144"]
+    },
+    "siteGridReferenceNorthing": {
+      "type": ["string", "null"],
+      "pattern": "^\\d{6,7}$",
+      "examples": ["400534"]
+    },
+    "contactAddressLine1": {
+      "type": ["string", "null"],
+      "examples": ["96 The Avenue"],
+      "description": "First line of address for the appeal site"
+    },
+    "contactAddressLine2": {
+      "type": ["string", "null"],
+      "description": "Second line of address for the appeal site"
+    },
+    "contactAddressTown": {
+      "type": ["string", "null"],
+      "examples": ["Maidstone"],
+      "description": "Town / City of the site address"
+    },
+    "contactAddressCounty": {
+      "type": ["string", "null"],
+      "examples": ["Kent"],
+      "description": "County of the site address"
+    },
+    "contactAddressPostcode": {
+      "type": ["string", "null"],
+      "examples": ["MD21 5XY"],
+      "description": "Postal code of the site address"
+    },
+    "contactGridReferenceEasting": {
+      "type": ["string", "null"],
+      "pattern": "^\\d{6,7}$",
+      "examples": ["357144"]
+    },
+    "contactGridReferenceNorthing": {
+      "type": ["string", "null"],
+      "pattern": "^\\d{6,7}$",
+      "examples": ["400534"]
+    },
+    "siteAccessDetails": {
+      "type": ["array", "null"],
+      "items": {
+        "type": "string",
+        "examples": ["The site is accessible through the small gate on the left of the property"]
+      },
+      "description": "Provided information on site accessibility"
+    },
+    "siteSafetyDetails": {
+      "type": ["array", "null"],
+      "items": {
+        "type": "string",
+        "examples": ["There is an aggressive dog in the property"]
+      },
+      "description": "Provided information on site health and safety"
+    },
+    "appellantCostsAppliedFor": {
+      "type": ["boolean", "null"],
+      "description": "Indicates if the appellant has applied for costs",
+      "$comment": "Also available on HAS cases"
+    },
+    "appellantProcedurePreference": {
+      "type": ["string", "null"],
+      "enum": ["written", "hearing", "inquiry", null],
+      "description": "The procedure preference indicated by the appellant"
+    },
+    "appellantProcedurePreferenceDetails": {
+      "type": ["string", "null"],
+      "description": "The procedure details preference indicated by the appellant"
+    },
+    "appellantProcedurePreferenceDuration": {
+      "type": ["number", "null"],
+      "description": "The duration of the procedure indicated by the appellant"
+    },
+    "appellantProcedurePreferenceWitnessCount": {
+      "type": ["number", "null"],
+      "description": "The number of witnesses appellant has suggested for inquiries preference"
+    },
+    "statusPlanningObligation": {
+      "type": ["string", "null"],
+      "description": "The planning obligation information, if available"
+    },
+    "nearbyCaseReferences": {
+      "type": ["array", "null"],
+      "items": {
+        "type": "string",
+        "examples": ["6000456", "8004567"]
+      },
+      "description": "A list of related case references known to the appellant and the LPA"
+    },
+    "namedIndividuals": {
+      "type": ["array", "null"],
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "properties": {
+          "firstName": {
+            "type": "string",
+            "description": "First name of the individual"
+          },
+          "lastName": {
+            "type": "string",
+            "description": "Last name of the individual"
+          },
+          "interestInLand": {
+            "type": "string",
+            "examples": ["owner, tenant, mortgage holder, other"],
+            "description": "Individual's interest in the appeal land"
+          },
+          "writtenOrVerbalPermission": {
+            "type": ["string", "null"],
+            "examples": ["yes"],
+            "description": "Whether the individual has permission to use the land"
+          }
+        },
+        "required": ["firstName", "lastName", "interestInLand", "writtenOrVerbalPermission"]
+      },
+      "description": "A list of individuals named on the enforcement notice"
+    },
+    "appealGrounds": {
+      "type": ["array", "null"],
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "properties": {
+          "groundRef": {
+            "type": "string",
+            "enum": ["a", "b", "c", "d", "e", "f", "g"],
+            "description": "Name of the appeal ground"
+          },
+          "factsForGround": {
+            "type": "string",
+            "description": "Facts supporting the appeal ground"
+          }
+        },
+        "required": ["groundRef", "factsForGround"]
+      },
+      "description": "A list of appeal grounds being pleaded"
+    }
+  }
+}

package/schemas/commands/appellant-submission.schema.json

@@ -49,6 +49,14 @@
             { "$ref": "appeals-components/appeal-advert.submission.schema.json" },
             { "$ref": "appeals-components/appellant-procedure-preference.schema.json" }
           ]
+        },
+        {
+          "$comment": "Enforcement notice",
+          "allOf": [
+            { "properties": { "caseType": { "enum": ["C"] } } },
+            { "$ref": "appeals-components/appeal-enforcement-submission.schema.json" },
+            { "$ref": "appeals-components/appellant-procedure-preference.schema.json" }
+          ]
         }
       ]
     },
@@ -116,6 +124,16 @@
               "plansDrawings",
               "newPlansDrawings",
               "otherNewDocuments",
+              "priorCorrespondenceWithPINS",
+              "enforcementNotice",
+              "enforcementNoticePlan",
+              "groundASupporting",
+              "groundBSupporting",
+              "groundCSupporting",
+              "groundDSupporting",
+              "groundESupporting",
+              "groundFSupporting",
+              "groundGSupporting",
               null,
               "environmentalAssessment"
             ],

package/schemas/nsip-meeting.schema.json

@@ -49,7 +49,8 @@
     },
     "meetingType": {
       "type": ["string", "null"],
-      "description": "Type of Meeting"
+      "description": "Type of Meeting",
+      "enum": ["evidence_plan", "project", null]
     }
   }
 }

package/schemas/nsip-project.schema.json

@@ -896,7 +896,8 @@
         },
         "meetingType": {
           "type": ["string", "null"],
-          "description": "Type of Meeting"
+          "description": "Type of Meeting",
+          "enum": ["evidence_plan", "project", null]
         }
       }
     },

package/src/enums.cjs

@@ -446,6 +446,11 @@ const NSIP_MATURE_OUTLINE_CONTROL_DOCUMENT = Object.freeze({
   SUBMITTED_BY_APPLICANT: 'submitted_by_applicant',
 });
 
+const NSIP_MEETING_TYPE = Object.freeze({
+  EVIDENCE_PLAN: 'evidence_plan',
+  PROJECT: 'project',
+});
+
 const NSIP_MULTIPARTY_APPLICATION_CHECK_DOCUMENT = Object.freeze({
   AWAITING_SUBMISSION: 'awaiting_submission',
   NOT_APPLICABLE: 'not_applicable',
@@ -735,6 +740,7 @@ exports.NSIP_INVOICE_STAGE = NSIP_INVOICE_STAGE;
 exports.NSIP_LANGUAGE = NSIP_LANGUAGE;
 exports.NSIP_MAP_ZOOM_LEVEL = NSIP_MAP_ZOOM_LEVEL;
 exports.NSIP_MATURE_OUTLINE_CONTROL_DOCUMENT = NSIP_MATURE_OUTLINE_CONTROL_DOCUMENT;
+exports.NSIP_MEETING_TYPE = NSIP_MEETING_TYPE;
 exports.NSIP_MULTIPARTY_APPLICATION_CHECK_DOCUMENT = NSIP_MULTIPARTY_APPLICATION_CHECK_DOCUMENT;
 exports.NSIP_NEW_MATURITY = NSIP_NEW_MATURITY;
 exports.NSIP_ORIGIN = NSIP_ORIGIN;

package/src/enums.d.ts

@@ -444,6 +444,11 @@ export const NSIP_MATURE_OUTLINE_CONTROL_DOCUMENT = {
   SUBMITTED_BY_APPLICANT: 'submitted_by_applicant',
 } as const;
 
+export const NSIP_MEETING_TYPE = {
+  EVIDENCE_PLAN: 'evidence_plan',
+  PROJECT: 'project',
+} as const;
+
 export const NSIP_MULTIPARTY_APPLICATION_CHECK_DOCUMENT = {
   AWAITING_SUBMISSION: 'awaiting_submission',
   NOT_APPLICABLE: 'not_applicable',

package/src/enums.js

@@ -444,6 +444,11 @@ export const NSIP_MATURE_OUTLINE_CONTROL_DOCUMENT = Object.freeze({
   SUBMITTED_BY_APPLICANT: 'submitted_by_applicant',
 });
 
+export const NSIP_MEETING_TYPE = Object.freeze({
+  EVIDENCE_PLAN: 'evidence_plan',
+  PROJECT: 'project',
+});
+
 export const NSIP_MULTIPARTY_APPLICATION_CHECK_DOCUMENT = Object.freeze({
   AWAITING_SUBMISSION: 'awaiting_submission',
   NOT_APPLICABLE: 'not_applicable',

package/src/index.cjs

@@ -527,6 +527,11 @@ const NSIP_MATURE_OUTLINE_CONTROL_DOCUMENT = Object.freeze({
   SUBMITTED_BY_APPLICANT: 'submitted_by_applicant',
 });
 
+const NSIP_MEETING_TYPE = Object.freeze({
+  EVIDENCE_PLAN: 'evidence_plan',
+  PROJECT: 'project',
+});
+
 const NSIP_MULTIPARTY_APPLICATION_CHECK_DOCUMENT = Object.freeze({
   AWAITING_SUBMISSION: 'awaiting_submission',
   NOT_APPLICABLE: 'not_applicable',
@@ -848,6 +853,7 @@ exports.NSIP_INVOICE_STAGE = NSIP_INVOICE_STAGE;
 exports.NSIP_LANGUAGE = NSIP_LANGUAGE;
 exports.NSIP_MAP_ZOOM_LEVEL = NSIP_MAP_ZOOM_LEVEL;
 exports.NSIP_MATURE_OUTLINE_CONTROL_DOCUMENT = NSIP_MATURE_OUTLINE_CONTROL_DOCUMENT;
+exports.NSIP_MEETING_TYPE = NSIP_MEETING_TYPE;
 exports.NSIP_MULTIPARTY_APPLICATION_CHECK_DOCUMENT = NSIP_MULTIPARTY_APPLICATION_CHECK_DOCUMENT;
 exports.NSIP_NEW_MATURITY = NSIP_NEW_MATURITY;
 exports.NSIP_ORIGIN = NSIP_ORIGIN;

package/src/schemas.d.ts

@@ -2272,7 +2272,7 @@ export interface NSIPMeeting {
   /**
    * Type of Meeting
    */
-  meetingType: string | null;
+  meetingType: 'evidence_plan' | 'project' | null;
   [k: string]: unknown;
 }
 
@@ -2865,7 +2865,7 @@ export interface Meeting {
   /**
    * Type of Meeting
    */
-  meetingType?: string | null;
+  meetingType?: 'evidence_plan' | 'project' | null;
   [k: string]: unknown;
 }
 /**
@@ -3728,6 +3728,234 @@ export type AppellantProcedurePreferenceProperties = {
    */
   appellantProcedurePreferenceWitnessCount?: number | null;
 };
+/**
+ * Schema defining any properties for enforcement appeals
+ */
+export type AppellantEnforcementSubmissionProperties = (
+  | {
+      siteGridReferenceEasting: string;
+      siteGridReferenceNorthing: string;
+    }
+  | {
+      siteAddressLine1: string;
+      siteAddressTown: string;
+      siteAddressPostcode: string;
+    }
+) & {
+  /**
+   * Case submission id - link to draft submission created by appellant
+   */
+  submissionId: string;
+  /**
+   * The type of procedure for the appeal
+   */
+  caseProcedure: 'written' | 'hearing' | 'inquiry';
+  /**
+   * A unique identifier for the Local Planning Authority
+   */
+  lpaCode: string;
+  /**
+   * The date the appeal was submitted by the appellant
+   */
+  caseSubmittedDate: string;
+  /**
+   * Indicates if an enforcement notice is the reason for the appeal
+   */
+  enforcementNotice: boolean | null;
+  /**
+   * The unique identifier of the enforcement notice
+   */
+  enforcementReference: string;
+  /**
+   * The date the enforcement notice was issued
+   */
+  enforcementIssueDate: string;
+  /**
+   * The date the enforcement notice took effect
+   */
+  enforcementEffectiveDate: string;
+  /**
+   * The date the enforcement notice took effect
+   */
+  contactPlanningInspectorateDate?: string | null;
+  /**
+   * The individual's interest in the appeal land
+   */
+  interestInLand?: string | null;
+  /**
+   * If required, whether the individual has permission to use the appeal land
+   */
+  writtenOrVerbalPermission?: string | null;
+  /**
+   * A description of the alleged breach
+   */
+  descriptionOfAllegedBreach?: string | null;
+  /**
+   * Whether a planning application was made
+   */
+  applicationMadeAndFeePaid?: boolean | null;
+  /**
+   * Did the application relate to all or part of the development
+   */
+  applicationDevelopmentAllOrPart?: 'all-of-the-development' | 'part-of-the-development' | null;
+  /**
+   * A description of the proposed development
+   */
+  originalDevelopmentDescription?: string | null;
+  /**
+   * An updated description of the proposed development
+   */
+  changedDevelopmentDescription?: boolean | null;
+  /**
+   * The unique identifier of the LPA application
+   */
+  applicationReference?: string | null;
+  /**
+   * The date of the original LPA application
+   */
+  applicationDate?: string | null;
+  /**
+   * The outcome of the original LPA decision
+   */
+  applicationDecision?: 'granted' | 'refused' | 'not_received' | null;
+  /**
+   * The date of the original LPA decision
+   */
+  applicationDecisionDate?: string | null;
+  /**
+   * Whether an appeal was made against the original LPA decision
+   */
+  applicationDecisionAppealed?: boolean | null;
+  /**
+   * The date of the appeal against the original LPA decision
+   */
+  appealDecisionDate?: string | null;
+  /**
+   * The statutory deadline for submitting an appeal from the original LPA decision date
+   */
+  caseSubmissionDueDate: string | null;
+  /**
+   * First line of address for the appeal site
+   */
+  siteAddressLine1?: string | null;
+  /**
+   * Second line of address for the appeal site
+   */
+  siteAddressLine2?: string | null;
+  /**
+   * Town / City of the site address
+   */
+  siteAddressTown?: string | null;
+  /**
+   * County of the site address
+   */
+  siteAddressCounty?: string | null;
+  /**
+   * Postal code of the site address
+   */
+  siteAddressPostcode?: string | null;
+  siteGridReferenceEasting?: string | null;
+  siteGridReferenceNorthing?: string | null;
+  /**
+   * First line of address for the appeal site
+   */
+  contactAddressLine1?: string | null;
+  /**
+   * Second line of address for the appeal site
+   */
+  contactAddressLine2?: string | null;
+  /**
+   * Town / City of the site address
+   */
+  contactAddressTown?: string | null;
+  /**
+   * County of the site address
+   */
+  contactAddressCounty?: string | null;
+  /**
+   * Postal code of the site address
+   */
+  contactAddressPostcode?: string | null;
+  contactGridReferenceEasting?: string | null;
+  contactGridReferenceNorthing?: string | null;
+  /**
+   * Provided information on site accessibility
+   */
+  siteAccessDetails?: string[] | null;
+  /**
+   * Provided information on site health and safety
+   */
+  siteSafetyDetails?: string[] | null;
+  /**
+   * Indicates if the appellant has applied for costs
+   */
+  appellantCostsAppliedFor?: boolean | null;
+  /**
+   * The procedure preference indicated by the appellant
+   */
+  appellantProcedurePreference?: 'written' | 'hearing' | 'inquiry' | null;
+  /**
+   * The procedure details preference indicated by the appellant
+   */
+  appellantProcedurePreferenceDetails?: string | null;
+  /**
+   * The duration of the procedure indicated by the appellant
+   */
+  appellantProcedurePreferenceDuration?: number | null;
+  /**
+   * The number of witnesses appellant has suggested for inquiries preference
+   */
+  appellantProcedurePreferenceWitnessCount?: number | null;
+  /**
+   * The planning obligation information, if available
+   */
+  statusPlanningObligation?: string | null;
+  /**
+   * A list of related case references known to the appellant and the LPA
+   */
+  nearbyCaseReferences?: string[] | null;
+  /**
+   * A list of individuals named on the enforcement notice
+   */
+  namedIndividuals?:
+    | {
+        /**
+         * First name of the individual
+         */
+        firstName: string;
+        /**
+         * Last name of the individual
+         */
+        lastName: string;
+        /**
+         * Individual's interest in the appeal land
+         */
+        interestInLand: string;
+        /**
+         * Whether the individual has permission to use the land
+         */
+        writtenOrVerbalPermission: string | null;
+        [k: string]: unknown;
+      }[]
+    | null;
+  /**
+   * A list of appeal grounds being pleaded
+   */
+  appealGrounds?:
+    | {
+        /**
+         * Name of the appeal ground
+         */
+        groundRef: 'a' | 'b' | 'c' | 'd' | 'e' | 'f' | 'g';
+        /**
+         * Facts supporting the appeal ground
+         */
+        factsForGround: string;
+        [k: string]: unknown;
+      }[]
+    | null;
+  [k: string]: unknown;
+};
 
 /**
  * Schema defining the data produced by the Front-Office when an appeal is requested
@@ -3754,6 +3982,10 @@ export interface AppellantSubmissionCommand {
       } & AppellantCommonSubmissionProperties &
         AppellantHASSubmissionProperties &
         AdvertSpecificProperties &
+        AppellantProcedurePreferenceProperties)
+    | ({
+        caseType?: 'C';
+      } & AppellantEnforcementSubmissionProperties &
         AppellantProcedurePreferenceProperties);
   documents: {
     /**
@@ -3804,6 +4036,16 @@ export interface AppellantSubmissionCommand {
       | 'plansDrawings'
       | 'newPlansDrawings'
       | 'otherNewDocuments'
+      | 'priorCorrespondenceWithPINS'
+      | 'enforcementNotice'
+      | 'enforcementNoticePlan'
+      | 'groundASupporting'
+      | 'groundBSupporting'
+      | 'groundCSupporting'
+      | 'groundDSupporting'
+      | 'groundESupporting'
+      | 'groundFSupporting'
+      | 'groundGSupporting'
       | null
       | 'environmentalAssessment';
     [k: string]: unknown;

package/tests/appeals/commands/enforcement-submission.test.js

@@ -0,0 +1,187 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import Ajv from 'ajv';
+import addFormats from 'ajv-formats';
+import { loadAllSchemasSync } from '../../../src/index.js';
+
+const schema = 'appellant-submission.schema.json';
+
+const user = {
+	salutation: 'nisi aute tempor Ut',
+	firstName: null,
+	lastName: null,
+	emailAddress: null,
+	telephoneNumber: 'irure',
+	organisation: null,
+	serviceUserType: 'Appellant'
+};
+
+const document = {
+	documentId: 'Lorem',
+	filename: 'sunt',
+	originalFilename: 'dolore fugiat',
+	size: 663667,
+	mime: 'consequat veniam ipsum ullamco sint',
+	documentURI: 'reprehenderit',
+	dateCreated: '1904-04-10T14:53:32.0Z',
+	documentType: 'priorCorrespondenceWithPINS'
+};
+
+const exampleEnforcementSubmissionSchema = {
+	casedata: {
+		caseType: 'C',
+		submissionId: '4b78fc58-fcb0-70d6-5dea-b9b774f802d6',
+		caseProcedure: 'written',
+		lpaCode: 'cupidatat',
+		caseSubmittedDate: '1890-12-28T22:49:47.0Z',
+		enforcementNotice: true,
+		enforcementReference: '12345',
+		enforcementIssueDate: '1890-12-28T22:49:47.0Z',
+		enforcementEffectiveDate: '1890-12-28T22:49:47.0Z',
+		contactPlanningInspectorateDate: null,
+		interestInLand: 'owner',
+		writtenOrVerbalPermission: null,
+		descriptionOfAllegedBreach: 'a new chimney',
+		applicationMadeAndFeePaid: true,
+		applicationDevelopmentAllOrPart: 'all-of-the-development',
+		originalDevelopmentDescription: 'in amet',
+		changedDevelopmentDescription: true,
+		applicationReference: '43010/APP/1/290572',
+		applicationDate: '1890-12-28T22:49:47.0Z',
+		applicationDecision: 'granted',
+		applicationDecisionAppealed: false,
+		applicationDecisionDate: '1890-12-28T22:49:47.0Z',
+		appealDecisionDate: null,
+		caseSubmissionDueDate: null,
+		siteAddressLine1: 'occaecat aliquip non pariatur consequat',
+		siteAddressLine2: null,
+		siteAddressTown: 'et',
+		siteAddressCounty: 'velit',
+		siteAddressPostcode: 'nisi minim laboris sed',
+		siteGridReferenceEasting: '357144',
+		siteGridReferenceNorthing: '400534',
+		contactAddressLine1: null,
+		contactAddressLine2: null,
+		contactAddressTown: null,
+		contactAddressCounty: null,
+		contactAddressPostcode: null,
+		contactGridReferenceEasting: null,
+		contactGridReferenceNorthing: null,
+		siteAccessDetails: ['laborum', 'aute velit quis', 'dolor'],
+		siteSafetyDetails: ['velit aliqua', 'qui', 'tempor Duis ut dolore', 'anim Ut in ea', 'eiusmod laborum'],
+		appellantCostsAppliedFor: false,
+		appellantProcedurePreference: null,
+		appellantProcedurePreferenceDetails: 'eiusmod ex exercitation',
+		appellantProcedurePreferenceDuration: 10816414.941069126,
+		appellantProcedurePreferenceWitnessCount: -91300569.36444478,
+		statusPlanningObligation: 'proident aute',
+		nearbyCaseReferences: ['incididunt'],
+		namedIndividuals: [
+			{
+				firstName: 'Bob',
+				lastName: 'Bobberson',
+				interestInLand: 'owner',
+				writtenOrVerbalPermission: 'yes'
+			}
+		],
+		appealGrounds: [
+			{
+				groundRef: 'a',
+				factsForGround: 'I like Christmas'
+			}
+		]
+	},
+	documents: [document],
+	users: [user]
+};
+
+describe('enforcement submission command schema', () => {
+	const schemas = loadAllSchemasSync();
+	const flatSchemas = Object.values(schemas).reduce((a, c) => ({ ...a, ...c }), {});
+	const ajv = new Ajv({ schemas: flatSchemas, allErrors: true });
+	addFormats(ajv);
+
+	it('should allow valid schema for enforcement', () => {
+		const validationResult = ajv.validate(schema, exampleEnforcementSubmissionSchema);
+		assert.strictEqual(validationResult, true);
+	});
+
+	it('should enforce eastings-northings pattern', () => {
+		const invalidPatterns = [
+			{ easting: 'abc123', northing: '400534', description: 'easting with letters' },
+			{ easting: '1234567*', northing: '400534', description: 'easting too long' },
+			{ easting: '12345', northing: '400534', description: 'easting too short' },
+			{ easting: '357144', northing: 'xyz123', description: 'northing with letters' },
+			{ easting: '357144', northing: '12345678', description: 'northing too long' },
+			{ easting: '357144', northing: '12345', description: 'northing too short' },
+			{ easting: '', northing: '400534', description: 'empty easting' },
+			{ easting: '357144', northing: '', description: 'empty northing' }
+		];
+
+		for (const pattern of invalidPatterns) {
+			const test = structuredClone(exampleEnforcementSubmissionSchema);
+			test.casedata.siteGridReferenceEasting = pattern.easting;
+			test.casedata.siteGridReferenceNorthing = pattern.northing;
+
+			const validationResult = ajv.validate(schema, test);
+			assert.strictEqual(validationResult, false, `Expected validation to fail for ${pattern.description}`);
+		}
+	});
+
+	it('should allow only eastings-northings', () => {
+		const test = structuredClone(exampleEnforcementSubmissionSchema);
+		test.casedata.siteAddressPostcode = undefined;
+		test.casedata.siteAddressLine1 = null;
+		test.casedata.siteAddressTown = null;
+		const validationResult = ajv.validate(schema, test);
+		assert.strictEqual(validationResult, true);
+	});
+
+	it('should allow only site address', () => {
+		const test = structuredClone(exampleEnforcementSubmissionSchema);
+		test.casedata.siteGridReferenceEasting = undefined;
+		test.casedata.siteGridReferenceNorthing = null;
+		const validationResult = ajv.validate(schema, test);
+		assert.strictEqual(validationResult, true);
+	});
+
+	it('should enforce either site address or easting-northing', () => {
+		const test = structuredClone(exampleEnforcementSubmissionSchema);
+		test.casedata.siteAddressPostcode = undefined;
+		test.casedata.siteAddressLine1 = null;
+		test.casedata.siteAddressTown = null;
+		test.casedata.siteGridReferenceEasting = undefined;
+		test.casedata.siteGridReferenceNorthing = null;
+		const validationResult = ajv.validate(schema, test);
+		assert.strictEqual(validationResult, false);
+	});
+
+	it('should reject missing root property', () => {
+		const test = structuredClone(exampleEnforcementSubmissionSchema);
+		delete test.casedata.caseType;
+		const validationResult = ajv.validate(schema, test);
+		assert.strictEqual(validationResult, false);
+		assert.strictEqual(
+			ajv.errors.some((x) => x.message === "must have required property 'caseType'"),
+			true
+		);
+	});
+
+	it('should reject missing nested property', () => {
+		const test = structuredClone(exampleEnforcementSubmissionSchema);
+		delete test.casedata.caseProcedure;
+		const validationResult = ajv.validate(schema, test);
+		assert.strictEqual(validationResult, false);
+		assert.strictEqual(
+			ajv.errors.some((x) => x.message === "must have required property 'caseProcedure'"),
+			true
+		);
+	});
+
+	it('should allow additional props', () => {
+		const test = structuredClone(exampleEnforcementSubmissionSchema);
+		test.test = 1;
+		const validationResult = ajv.validate(schema, test);
+		assert.strictEqual(validationResult, true);
+	});
+});