@pdtf/schemas 3.6.0-dev.3 → 3.6.0-dev.30

package/src/schemas/v4/mapping.json

@@ -0,0 +1,1161 @@
+{
+  "mappingVersion": 1,
+  "$id": "https://trust.propdata.org.uk/schemas/v4/mapping.json",
+  "description": "Generated mapping between PDTF V3 JSON Pointers and V4 entity documents. Do not edit by hand — regenerate with `npm run generate:v4`.",
+  "generator": "src/utils/generateV4Schemas.js",
+  "source": {
+    "packageName": "@pdtf/schemas",
+    "packageVersion": "3.6.0-dev.30",
+    "v3SchemaId": "https://trust.propdata.org.uk/schemas/v3/pdtf-transaction.json",
+    "combinedPath": "src/schemas/v3/combined.json",
+    "combinedSha256": "4e95946a946b37088b153052034fd0584cc27a6eb53f78ede52cd0ab1fde669f"
+  },
+  "entities": {
+    "Property": {
+      "$id": "https://trust.propdata.org.uk/schemas/v4/entities/property.json",
+      "kind": "derived",
+      "idScheme": "urn"
+    },
+    "Title": {
+      "$id": "https://trust.propdata.org.uk/schemas/v4/entities/title.json",
+      "kind": "derived",
+      "idScheme": "urn"
+    },
+    "Transaction": {
+      "$id": "https://trust.propdata.org.uk/schemas/v4/entities/transaction.json",
+      "kind": "derived",
+      "idScheme": "did"
+    },
+    "Person": {
+      "$id": "https://trust.propdata.org.uk/schemas/v4/entities/person.json",
+      "kind": "derived",
+      "idScheme": "did"
+    },
+    "Organisation": {
+      "$id": "https://trust.propdata.org.uk/schemas/v4/entities/organisation.json",
+      "kind": "standalone",
+      "idScheme": "did"
+    },
+    "Representation": {
+      "$id": "https://trust.propdata.org.uk/schemas/v4/entities/representation.json",
+      "kind": "credential",
+      "idScheme": "did"
+    },
+    "TransactionRole": {
+      "$id": "https://trust.propdata.org.uk/schemas/v4/entities/transactionRole.json",
+      "kind": "credential",
+      "idScheme": "did"
+    },
+    "Gift": {
+      "$id": "https://trust.propdata.org.uk/schemas/v4/entities/gift.json",
+      "kind": "credential",
+      "idScheme": "did"
+    },
+    "SellerCapacity": {
+      "$id": "https://trust.propdata.org.uk/schemas/v4/entities/sellerCapacity.json",
+      "kind": "credential",
+      "idScheme": "did"
+    },
+    "Offer": {
+      "$id": "https://trust.propdata.org.uk/schemas/v4/entities/offer.json",
+      "kind": "credential",
+      "idScheme": "did"
+    }
+  },
+  "roundTrip": {
+    "entities": [
+      "Property",
+      "Title",
+      "Transaction",
+      "Person",
+      "Representation",
+      "SellerCapacity",
+      "Offer",
+      "Gift",
+      "TransactionRole"
+    ],
+    "note": "All of these are required to reconstruct a V3 instance. The credentials are not redundant copies: role and every relationship live only on them, so that revoking a credential removes what it asserts rather than leaving a second copy on the transaction. Organisation is the one entity outside the round trip.",
+    "roleImpliedByCredential": {
+      "SellerCapacity": "Seller",
+      "Offer": "Buyer",
+      "Gift": "Giftor"
+    },
+    "strippedKeySuffixes": [
+      "Ref",
+      "Required"
+    ],
+    "knownExceptions": [
+      "Overlay metadata keys (*Ref, *Required) are schema-level only and are stripped from V4; they never appear in instance data.",
+      "A Title carrying only keys shared by both source arrays recomposes into propertyPack.titlesToBeSold only (primarySource), not into ownershipsToBeTransferred.",
+      "propertyPack.ownership.ownershipsToBeTransferred is canonicalised on recomposition: entries are emitted in propertyPack.titlesToBeSold order rather than their original order. The array is correlated by titleNumber and its order carries no meaning in V3, so this is a deliberate normalisation — it removes the index-divergence class of bug rather than reproducing it. Entry CONTENT is preserved exactly.",
+      "An explicitly empty container recomposes as absent: propertyPack {}, propertyPack.ownership {} and propertyPack.titlesToBeSold [] are all valid V3 but carry no data, and the entity model has no place to record 'present but empty'. (participants [] is invalid V3 — minItems 1 — so it does not arise.)",
+      "recompose always emits $schema, set to source.v3SchemaId. An instance that omitted it gains one; this is a normalisation, since a V3 instance is expected to declare its schema.",
+      "The round trip restores deep equality, NOT byte equality: object key order is not preserved, because keys are regrouped by entity and reassembled. JSON attaches no meaning to key order, but do not compare a recomposed instance to the original by hashing or string equality — compare structurally, or canonicalise first (e.g. JCS) if you need a stable digest."
+    ]
+  },
+  "extensionPolicy": {
+    "description": "What each rule does with instance keys the V3 schema does not define — platform extensions such as an externalIds namespace or a vendor's own block. `passthrough` carries them into the entity and back out again on recomposition; `drop` discards them. Exactly one rule per V3 node is the sink, so an unknown key has a single, predictable home. verifyCoverage() guarantees every V3 SCHEMA key has a V4 home; this is the answer for everything outside the schema.",
+    "values": [
+      "passthrough",
+      "drop"
+    ]
+  },
+  "arrayKeys": [
+    {
+      "pointer": "/participants",
+      "keys": [
+        {
+          "pointer": "/participantId",
+          "scope": "canonical"
+        },
+        {
+          "pointer": "/externalIds/{source}",
+          "scope": "vendor"
+        }
+      ]
+    },
+    {
+      "pointer": "/participants/{index}/verification/identity/reports",
+      "keys": [
+        {
+          "pointer": "/reportName",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/participants/{index}/verification/antiMoneyLaundering/reports",
+      "keys": [
+        {
+          "pointer": "/reportName",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/participants/{index}/verification/sourceOfFunds/reports",
+      "keys": [
+        {
+          "pointer": "/reportName",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/media",
+      "keys": [
+        {
+          "pointer": "/mediaId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/buildInformation/roomDimensions/rooms",
+      "keys": [
+        {
+          "pointer": "/roomName",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/nearbyFacilities/healthCare/{index}/openingHours",
+      "keys": [
+        {
+          "pointer": "/day",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/ownership/ownershipsToBeTransferred",
+      "keys": [
+        {
+          "pointer": "/titleNumber",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/energyEfficiency/recommendations",
+      "keys": [
+        {
+          "pointer": "/lmkKey",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/fixturesAndFittings/basicFittings/otherItems",
+      "keys": [
+        {
+          "pointer": "/itemName",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/fixturesAndFittings/kitchen/otherItems",
+      "keys": [
+        {
+          "pointer": "/itemName",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/fixturesAndFittings/carpets/otherRooms",
+      "keys": [
+        {
+          "pointer": "/itemName",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/fixturesAndFittings/curtainsAndCurtainRails/curtainRailsPolesPelmets/otherRooms",
+      "keys": [
+        {
+          "pointer": "/itemName",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/fixturesAndFittings/curtainsAndCurtainRails/curtainsBlinds/otherRooms",
+      "keys": [
+        {
+          "pointer": "/itemName",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/fixturesAndFittings/lightFittings/otherRooms",
+      "keys": [
+        {
+          "pointer": "/itemName",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/fixturesAndFittings/fittedUnits/otherRooms",
+      "keys": [
+        {
+          "pointer": "/itemName",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/fixturesAndFittings/outdoorArea/otherItems",
+      "keys": [
+        {
+          "pointer": "/itemName",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/fixturesAndFittings/otherItems/otherItems",
+      "keys": [
+        {
+          "pointer": "/itemName",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/environmentalIssues/flooding/floodRisk/riskSubcategories",
+      "keys": [
+        {
+          "pointer": "/subCategory",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/environmentalIssues/radon/radonRisk/riskSubcategories",
+      "keys": [
+        {
+          "pointer": "/subCategory",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/environmentalIssues/contaminatedLand/contaminatedLandRisk/riskSubcategories",
+      "keys": [
+        {
+          "pointer": "/subCategory",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/environmentalIssues/groundStability/groundStabilityRisk/riskSubcategories",
+      "keys": [
+        {
+          "pointer": "/subCategory",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/environmentalIssues/infrastructure/infrastructureRisk/riskSubcategories",
+      "keys": [
+        {
+          "pointer": "/subCategory",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/environmentalIssues/energy/energyRisk/riskSubcategories",
+      "keys": [
+        {
+          "pointer": "/subCategory",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/environmentalIssues/transportation/transportationRisk/riskSubcategories",
+      "keys": [
+        {
+          "pointer": "/subCategory",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/environmentalIssues/planning/planningRisk/riskSubcategories",
+      "keys": [
+        {
+          "pointer": "/subCategory",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/environmentalIssues/climate/climateRisk/riskSubcategories",
+      "keys": [
+        {
+          "pointer": "/subCategory",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/environmentalIssues/coalMining/riskSubcategories",
+      "keys": [
+        {
+          "pointer": "/subCategory",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/environmentalIssues/nonCoalMining/riskSubcategories",
+      "keys": [
+        {
+          "pointer": "/subCategory",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/environmentalIssues/coastalErosion/riskSubcategories",
+      "keys": [
+        {
+          "pointer": "/subCategory",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/guaranteesWarrantiesAndIndemnityInsurances/doubleGlazing/fensaCertificates/certificates",
+      "keys": [
+        {
+          "pointer": "/certificateId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/saleReadyDeclarations/sellerSignatures",
+      "keys": [
+        {
+          "pointer": "/signatureId",
+          "scope": "canonical"
+        },
+        {
+          "pointer": "/externalIds/{source}",
+          "scope": "vendor"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/localSearches/localLandCharges",
+      "keys": [
+        {
+          "pointer": "/hmlrReference",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/localSearches/localLandCharges/{index}/otherData",
+      "keys": [
+        {
+          "pointer": "/dataLabel",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/localSearches/localAuthoritySearches/planningAndBuildingRegulations/decisionsAndPendingApplications/planningPermission",
+      "keys": [
+        {
+          "pointer": "/refNumber",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/localSearches/localAuthoritySearches/planningAndBuildingRegulations/decisionsAndPendingApplications/listedBuildingConsent",
+      "keys": [
+        {
+          "pointer": "/refNumber",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/localSearches/localAuthoritySearches/planningAndBuildingRegulations/decisionsAndPendingApplications/conservationAreaConsent",
+      "keys": [
+        {
+          "pointer": "/refNumber",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/localSearches/localAuthoritySearches/planningAndBuildingRegulations/decisionsAndPendingApplications/lawfulnessOfExistingUse",
+      "keys": [
+        {
+          "pointer": "/refNumber",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/localSearches/localAuthoritySearches/planningAndBuildingRegulations/decisionsAndPendingApplications/certificateOfLawfulnessOfProposedUse",
+      "keys": [
+        {
+          "pointer": "/refNumber",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/localSearches/localAuthoritySearches/planningAndBuildingRegulations/decisionsAndPendingApplications/lawfulnessOfProposedListedWorks",
+      "keys": [
+        {
+          "pointer": "/refNumber",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/localSearches/localAuthoritySearches/planningAndBuildingRegulations/decisionsAndPendingApplications/heritagePartnershipAgreement",
+      "keys": [
+        {
+          "pointer": "/refNumber",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/localSearches/localAuthoritySearches/planningAndBuildingRegulations/decisionsAndPendingApplications/listedBuildingConsentOrder",
+      "keys": [
+        {
+          "pointer": "/refNumber",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/localSearches/localAuthoritySearches/planningAndBuildingRegulations/decisionsAndPendingApplications/localListedBuildingConsentOrder",
+      "keys": [
+        {
+          "pointer": "/refNumber",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/localSearches/localAuthoritySearches/planningAndBuildingRegulations/decisionsAndPendingApplications/buildingRegulationsApproval",
+      "keys": [
+        {
+          "pointer": "/refNumber",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/localSearches/localAuthoritySearches/planningAndBuildingRegulations/decisionsAndPendingApplications/buildingRegulationsCompletion",
+      "keys": [
+        {
+          "pointer": "/refNumber",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/localSearches/localAuthoritySearches/planningAndBuildingRegulations/decisionsAndPendingApplications/buildingRegulationsSelfCertification",
+      "keys": [
+        {
+          "pointer": "/refNumber",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/titlesToBeSold",
+      "keys": [
+        {
+          "pointer": "/titleNumber",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/titlesToBeSold/{index}/registerExtract/ocSummaryData/lease/leaseEntry/{index}/leaseParty",
+      "keys": [
+        {
+          "pointer": "/partyNumber",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/searches",
+      "keys": [
+        {
+          "pointer": "/searchId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/documents",
+      "keys": [
+        {
+          "pointer": "/documentId",
+          "scope": "canonical"
+        },
+        {
+          "pointer": "/externalIds/{source}",
+          "scope": "vendor"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/surveys",
+      "keys": [
+        {
+          "pointer": "/surveyId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/surveys/{index}/outside/chimneyStacks/photos",
+      "keys": [
+        {
+          "pointer": "/photoId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/surveys/{index}/outside/roofCoverings/photos",
+      "keys": [
+        {
+          "pointer": "/photoId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/surveys/{index}/outside/rainwaterPipesGutters/photos",
+      "keys": [
+        {
+          "pointer": "/photoId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/surveys/{index}/outside/mainWalls/photos",
+      "keys": [
+        {
+          "pointer": "/photoId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/surveys/{index}/outside/windows/photos",
+      "keys": [
+        {
+          "pointer": "/photoId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/surveys/{index}/outside/outsideDoors/photos",
+      "keys": [
+        {
+          "pointer": "/photoId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/surveys/{index}/outside/conservatoryPorches/photos",
+      "keys": [
+        {
+          "pointer": "/photoId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/surveys/{index}/outside/otherJoinery/photos",
+      "keys": [
+        {
+          "pointer": "/photoId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/surveys/{index}/outside/other/photos",
+      "keys": [
+        {
+          "pointer": "/photoId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/surveys/{index}/services/electricity/photos",
+      "keys": [
+        {
+          "pointer": "/photoId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/surveys/{index}/services/gasOil/photos",
+      "keys": [
+        {
+          "pointer": "/photoId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/surveys/{index}/services/water/photos",
+      "keys": [
+        {
+          "pointer": "/photoId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/surveys/{index}/services/heating/photos",
+      "keys": [
+        {
+          "pointer": "/photoId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/surveys/{index}/services/waterHeating/photos",
+      "keys": [
+        {
+          "pointer": "/photoId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/surveys/{index}/services/drainage/photos",
+      "keys": [
+        {
+          "pointer": "/photoId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/surveys/{index}/services/commonServices/photos",
+      "keys": [
+        {
+          "pointer": "/photoId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/propertyPack/valuations",
+      "keys": [
+        {
+          "pointer": "/valuationId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/valuationComparisonData/propertyDetails",
+      "keys": [
+        {
+          "pointer": "/uprn",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/contracts",
+      "keys": [
+        {
+          "pointer": "/contractId",
+          "scope": "canonical"
+        }
+      ]
+    },
+    {
+      "pointer": "/contracts/{index}/signatures",
+      "keys": [
+        {
+          "pointer": "/signatureId",
+          "scope": "canonical"
+        },
+        {
+          "pointer": "/externalIds/{source}",
+          "scope": "vendor"
+        }
+      ]
+    },
+    {
+      "pointer": "/chain/onwardPurchase",
+      "keys": [
+        {
+          "pointer": "/transactionId",
+          "scope": "canonical"
+        },
+        {
+          "pointer": "/externalIds/{source}",
+          "scope": "vendor"
+        }
+      ]
+    },
+    {
+      "pointer": "/chain/buyersSale",
+      "keys": [
+        {
+          "pointer": "/transactionId",
+          "scope": "canonical"
+        },
+        {
+          "pointer": "/externalIds/{source}",
+          "scope": "vendor"
+        }
+      ]
+    }
+  ],
+  "arrayKeyScopes": {
+    "canonical": "Lives in the shared payload, so any party holding the transaction can resolve it. This is what claims and credentials should address.",
+    "vendor": "A per-source back-reference under externalIds. Resolvable only by a party that knows that source's namespace, and absent entirely on items that source did not write. Use as a fallback, never as the identifier in a credential presented to a third party."
+  },
+  "unkeyedArrays": {
+    "description": "Arrays of objects with no candidate key at all — neither a canonical identifier nor externalIds — so their items can only be addressed by position. Listed so the gap is visible rather than silent. Most are single-source provider payloads replaced wholesale, where position is stable in practice.",
+    "pointers": [
+      "/propertyPack/buildInformation/higherRiskBuildingRegistration/accountablePersons",
+      "/propertyPack/buildInformation/higherRiskBuildingRegistration/accountablePersons/{index}/accountability",
+      "/propertyPack/nearbyFacilities/schools",
+      "/propertyPack/nearbyFacilities/transport",
+      "/propertyPack/nearbyFacilities/healthCare",
+      "/propertyPack/legalOwners/namesOfLegalOwners",
+      "/propertyPack/localSearches/localLandCharges/{index}/availableDocument",
+      "/propertyPack/localSearches/localAuthoritySearches/planningAndBuildingRegulations/designationsAndProposals/plans",
+      "/propertyPack/localSearches/localAuthoritySearches/planningAndBuildingRegulations/designationsAndProposals/plans/{index}/designations",
+      "/propertyPack/localSearches/localAuthoritySearches/roadsAndPublicRightsOfWay/roadsFootwaysAndFootpaths/highwaysMaintainableAtPublicExpense",
+      "/propertyPack/localSearches/localAuthoritySearches/roadsAndPublicRightsOfWay/roadsFootwaysAndFootpaths/subjectToAdoption",
+      "/propertyPack/localSearches/localAuthoritySearches/roadsAndPublicRightsOfWay/roadsFootwaysAndFootpaths/toBeMadeUpWithReclaim",
+      "/propertyPack/localSearches/localAuthoritySearches/roadsAndPublicRightsOfWay/roadsFootwaysAndFootpaths/toBeMadeUpWithoutReclaim",
+      "/propertyPack/titlesToBeSold/{index}/registerExtract/ocSummaryData/lease/leaseEntry",
+      "/propertyPack/titlesToBeSold/{index}/additionalDocuments",
+      "/valuationComparisonData/propertyDetails/{index}/media",
+      "/contracts/{index}/contract/template/requiredSignatories"
+    ]
+  },
+  "projections": {
+    "Representation": {
+      "description": "A professional representation relationship. Emitted once per (representative, represented party) pair, so a conveyancer instructed jointly by two sellers yields two, and sellers who instruct separate conveyancers yield one each.",
+      "source": {
+        "entity": "Transaction",
+        "pointer": "/participants/{index}"
+      },
+      "emitWhen": "/actingFor is present and non-empty",
+      "fanOut": "/actingFor",
+      "resolveBy": "participantId",
+      "fields": {
+        "representative": "/participants/{index}/participant",
+        "representedParty": "/participants/{index}/actingFor/{n} resolved against /participants/*/participantId",
+        "role": "/participants/{index}/role",
+        "organisation": "/participants/{index}/organisation",
+        "organisationReference": "/participants/{index}/organisationReference",
+        "transaction": "/id"
+      }
+    },
+    "SellerCapacity": {
+      "description": "The capacity in which a seller sells — the relationship that embodies the Seller role. Emitted once per participant whose role is Seller, whether or not a capacity has been declared yet.",
+      "source": {
+        "entity": "Transaction",
+        "pointer": "/participants/{index}"
+      },
+      "emitWhen": "/role is \"Seller\", or /sellersCapacity is present",
+      "fields": {
+        "seller": "/participants/{index}/participant",
+        "sellersCapacity": "/participants/{index}/sellersCapacity",
+        "dateBecameOwnerOrAuthority": "/participants/{index}/dateBecameOwnerOrAuthority",
+        "transaction": "/id"
+      },
+      "notes": "V3 does not tie a seller's capacity to a particular title, so the optional `title` reference is left unset. A transaction selling more than one title therefore yields a capacity scoped to the transaction, not to a title."
+    },
+    "TransactionRole": {
+      "description": "A party's role where no more specific relationship credential applies — Lender, Landlord, Tenant, Giftor, Platform Support — or where the specific relationship is not yet established. Emitted so that every participant carrying a role has exactly one credential embodying it.",
+      "source": {
+        "entity": "Transaction",
+        "pointer": "/participants/{index}"
+      },
+      "emitWhen": "/role is present and no other credential names this participant as its role-bearer",
+      "fields": {
+        "participant": "/participants/{index}/participant",
+        "role": "/participants/{index}/role",
+        "organisation": "/participants/{index}/organisation",
+        "organisationReference": "/participants/{index}/organisationReference",
+        "transaction": "/id"
+      }
+    },
+    "Offer": {
+      "description": "An offer made by a prospective buyer — the relationship that embodies the Buyer role. Emitted once per participant carrying an offerId, merged with that offer's data from Transaction.offers.",
+      "source": {
+        "entity": "Transaction",
+        "pointer": "/participants/{index}"
+      },
+      "emitWhen": "/offerId is present",
+      "fields": {
+        "offerId": "/participants/{index}/offerId",
+        "buyer": "/participants/{index}/participant",
+        "…": "the remaining fields from /offers/{offerId}",
+        "transaction": "/id"
+      },
+      "notes": "An offer in Transaction.offers that no participant references stays transaction data and yields no credential, since Offer requires a buyer."
+    }
+  },
+  "collisions": [
+    {
+      "key": "titleNumber",
+      "entity": "Title",
+      "sources": [
+        "/propertyPack/titlesToBeSold/{index}/titleNumber",
+        "/propertyPack/ownership/ownershipsToBeTransferred/{index}/titleNumber"
+      ],
+      "rule": "same-fact",
+      "resolution": "Identical fact in both sources and the key that correlates them. Decomposition takes either; recomposition writes the value back to every source array it emits an entry for."
+    }
+  ],
+  "rules": [
+    {
+      "id": "title.titlesToBeSold",
+      "v3Pointer": "/propertyPack/titlesToBeSold/{index}",
+      "entity": "Title",
+      "entityPointer": "",
+      "keys": {
+        "mode": "include",
+        "values": [
+          "titleNumber",
+          "titleExtents",
+          "registerExtract",
+          "additionalDocuments",
+          "keyFacts",
+          "covenantAnalysis"
+        ]
+      },
+      "extensions": "passthrough",
+      "instance": {
+        "cardinality": "many",
+        "orderedBy": {
+          "entity": "Transaction",
+          "pointer": "/titlesToBeSold"
+        },
+        "correlateBy": "titleNumber",
+        "primarySource": true
+      },
+      "notes": "Primary source: it takes any key the V3 schema does not define, and recomposition emits one entry per id in Transaction.titlesToBeSold."
+    },
+    {
+      "id": "title.ownershipsToBeTransferred",
+      "v3Pointer": "/propertyPack/ownership/ownershipsToBeTransferred/{index}",
+      "entity": "Title",
+      "entityPointer": "",
+      "keys": {
+        "mode": "include",
+        "values": [
+          "titleNumber",
+          "titlePropertyDescription",
+          "ownershipType",
+          "estateRentcharges",
+          "titleRestrictions",
+          "wholeFreeholdForSale",
+          "managedFreeholdOrCommonholdInformation",
+          "leaseholdInformation",
+          "otherOwnershipDetails"
+        ]
+      },
+      "extensions": "drop",
+      "instance": {
+        "cardinality": "many",
+        "orderedBy": {
+          "entity": "Transaction",
+          "pointer": "/titlesToBeSold"
+        },
+        "correlateBy": "titleNumber",
+        "primarySource": false
+      },
+      "notes": "Indices of the two source arrays are NOT assumed to correspond; they are correlated by titleNumber value."
+    },
+    {
+      "id": "transaction.saleContext.legalOwners",
+      "v3Pointer": "/propertyPack/legalOwners",
+      "entity": "Transaction",
+      "entityPointer": "/saleContext/legalOwners",
+      "instance": {
+        "cardinality": "single"
+      }
+    },
+    {
+      "id": "transaction.saleContext",
+      "v3Pointer": "/propertyPack/ownership",
+      "entity": "Transaction",
+      "entityPointer": "/saleContext",
+      "keys": {
+        "mode": "exclude",
+        "values": [
+          "ownershipsToBeTransferred"
+        ]
+      },
+      "extensions": "passthrough",
+      "instance": {
+        "cardinality": "single"
+      }
+    },
+    {
+      "id": "property",
+      "v3Pointer": "/propertyPack",
+      "entity": "Property",
+      "entityPointer": "",
+      "keys": {
+        "mode": "exclude",
+        "values": [
+          "titlesToBeSold",
+          "ownership",
+          "legalOwners"
+        ]
+      },
+      "extensions": "passthrough",
+      "instance": {
+        "cardinality": "single"
+      }
+    },
+    {
+      "id": "transaction.participants",
+      "v3Pointer": "/participants/{index}",
+      "entity": "Transaction",
+      "entityPointer": "/participants/{index}",
+      "keys": {
+        "mode": "include",
+        "values": [
+          "did",
+          "participantId",
+          "organisation",
+          "organisationReference"
+        ]
+      },
+      "extensions": "drop",
+      "instance": {
+        "cardinality": "many",
+        "orderedBy": {
+          "entity": "Transaction",
+          "pointer": "/participants"
+        }
+      },
+      "notes": "The roster only: transaction-scoped identity and firm. The entity reference itself is at /participants/{index}/participant."
+    },
+    {
+      "id": "credential.sellerCapacity",
+      "extensions": "drop",
+      "v3Pointer": "/participants/{index}",
+      "entity": "SellerCapacity",
+      "entityPointer": "",
+      "keys": {
+        "mode": "include",
+        "values": [
+          "sellersCapacity",
+          "dateBecameOwnerOrAuthority"
+        ]
+      },
+      "instance": {
+        "cardinality": "many",
+        "matchOn": "/seller"
+      },
+      "impliesRole": "Seller"
+    },
+    {
+      "id": "credential.offer",
+      "extensions": "drop",
+      "v3Pointer": "/participants/{index}",
+      "entity": "Offer",
+      "entityPointer": "",
+      "keys": {
+        "mode": "include",
+        "values": [
+          "offerId"
+        ]
+      },
+      "instance": {
+        "cardinality": "many",
+        "matchOn": "/buyer"
+      },
+      "impliesRole": "Buyer"
+    },
+    {
+      "id": "credential.gift",
+      "extensions": "drop",
+      "v3Pointer": "/participants/{index}",
+      "entity": "Gift",
+      "entityPointer": "",
+      "keys": {
+        "mode": "include",
+        "values": [
+          "giftDetails",
+          "offerId"
+        ]
+      },
+      "instance": {
+        "cardinality": "many",
+        "matchOn": "/donor"
+      },
+      "impliesRole": "Giftor"
+    },
+    {
+      "id": "credential.representation",
+      "extensions": "drop",
+      "v3Pointer": "/participants/{index}",
+      "entity": "Representation",
+      "entityPointer": "",
+      "keys": {
+        "mode": "include",
+        "values": [
+          "role",
+          "actingFor"
+        ]
+      },
+      "fieldMap": {
+        "role": "/role",
+        "actingFor": "/representedParty"
+      },
+      "instance": {
+        "cardinality": "many",
+        "matchOn": "/representative"
+      },
+      "notes": "actingFor becomes one Representation per represented party; its role is the credential's own discriminator."
+    },
+    {
+      "id": "credential.transactionRole",
+      "extensions": "drop",
+      "v3Pointer": "/participants/{index}",
+      "entity": "TransactionRole",
+      "entityPointer": "",
+      "keys": {
+        "mode": "include",
+        "values": [
+          "role"
+        ]
+      },
+      "instance": {
+        "cardinality": "many",
+        "matchOn": "/participant"
+      },
+      "notes": "Carries role for the roles no specific credential covers, and for a party whose specific relationship is not yet established."
+    },
+    {
+      "id": "person",
+      "v3Pointer": "/participants/{index}",
+      "entity": "Person",
+      "entityPointer": "",
+      "keys": {
+        "mode": "include",
+        "values": [
+          "name",
+          "dateOfBirth",
+          "phone",
+          "email",
+          "address",
+          "did",
+          "externalIds",
+          "participantStatus",
+          "verification"
+        ]
+      },
+      "extensions": "passthrough",
+      "instance": {
+        "cardinality": "many",
+        "orderedBy": {
+          "entity": "Transaction",
+          "pointer": "/participants",
+          "idField": "participant"
+        }
+      }
+    },
+    {
+      "id": "transaction",
+      "v3Pointer": "",
+      "entity": "Transaction",
+      "entityPointer": "",
+      "keys": {
+        "mode": "exclude",
+        "values": [
+          "propertyPack",
+          "participants",
+          "$schema"
+        ]
+      },
+      "extensions": "passthrough",
+      "instance": {
+        "cardinality": "single"
+      }
+    }
+  ]
+}