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

package/src/schemas/v4/mapping.json

@@ -0,0 +1,1188 @@
+{
+  "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.32",
+    "v3SchemaId": "https://trust.propdata.org.uk/schemas/v3/pdtf-transaction.json",
+    "combinedPath": "src/schemas/v3/combined.json",
+    "combinedSha256": "83f31fddf82e57e67f2bc92844459095041b254b970d8881dd4318248c188f67"
+  },
+  "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",
+      "scope": "transaction",
+      "idScheme": "urn"
+    },
+    "TransactionRole": {
+      "$id": "https://trust.propdata.org.uk/schemas/v4/entities/transactionRole.json",
+      "kind": "credential",
+      "scope": "transaction",
+      "idScheme": "urn"
+    },
+    "Gift": {
+      "$id": "https://trust.propdata.org.uk/schemas/v4/entities/gift.json",
+      "kind": "credential",
+      "scope": "transaction",
+      "idScheme": "urn"
+    },
+    "SellerCapacity": {
+      "$id": "https://trust.propdata.org.uk/schemas/v4/entities/sellerCapacity.json",
+      "kind": "credential",
+      "scope": "transaction",
+      "idScheme": "urn"
+    },
+    "Offer": {
+      "$id": "https://trust.propdata.org.uk/schemas/v4/entities/offer.json",
+      "kind": "credential",
+      "scope": "transaction",
+      "idScheme": "urn"
+    },
+    "PropertyTitleLink": {
+      "$id": "https://trust.propdata.org.uk/schemas/v4/entities/propertyTitleLink.json",
+      "kind": "credential",
+      "scope": "standing",
+      "idScheme": "urn"
+    }
+  },
+  "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 and PropertyTitleLink are outside the round trip: V3 records a participant's firm only as free text, and records no UPRN-to-title link at all, so decompose does not invent either and recompose does not need them.",
+    "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."
+    }
+  },
+  "standingCredentials": {
+    "PropertyTitleLink": {
+      "description": "A standing UPRN-to-title link. Not projected from V3. A Transaction's titlesToBeSold selects the titles being sold from the titles linked to its property; see linkedTitles() in src/utils/v4.js.",
+      "issuerByTitleScheme": {
+        "urn:pdtf:titleNumber:": {
+          "issuer": "HM Land Registry",
+          "basis": "Register Dataset"
+        },
+        "urn:pdtf:unregisteredTitle:": {
+          "issuer": "Seller's conveyancer",
+          "basis": "Epitome of Title"
+        }
+      },
+      "supersession": "On first registration the Title for the new title number lists the unregistered URN in alsoKnownAs. An HMLR link from the same UPRN to that title supersedes the conveyancer's link to the unregistered URN; the conveyancer's link stays in force until one exists."
+    }
+  },
+  "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"
+      }
+    }
+  ]
+}