@opensanctions/followthemoney 4.6.2 → 4.7.0

package/dist/followthemoney.es.js

@@ -239,71 +239,13 @@ typeof SuppressedError === "function" ? SuppressedError : function (error, suppr
     return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
 };
 
-const byteToHex = [];
-for (let i = 0; i < 256; ++i) {
-    byteToHex.push((i + 0x100).toString(16).slice(1));
-}
-function unsafeStringify(arr, offset = 0) {
-    return (byteToHex[arr[offset + 0]] +
-        byteToHex[arr[offset + 1]] +
-        byteToHex[arr[offset + 2]] +
-        byteToHex[arr[offset + 3]] +
-        '-' +
-        byteToHex[arr[offset + 4]] +
-        byteToHex[arr[offset + 5]] +
-        '-' +
-        byteToHex[arr[offset + 6]] +
-        byteToHex[arr[offset + 7]] +
-        '-' +
-        byteToHex[arr[offset + 8]] +
-        byteToHex[arr[offset + 9]] +
-        '-' +
-        byteToHex[arr[offset + 10]] +
-        byteToHex[arr[offset + 11]] +
-        byteToHex[arr[offset + 12]] +
-        byteToHex[arr[offset + 13]] +
-        byteToHex[arr[offset + 14]] +
-        byteToHex[arr[offset + 15]]).toLowerCase();
-}
-
-let getRandomValues;
-const rnds8 = new Uint8Array(16);
-function rng() {
-    if (!getRandomValues) {
-        if (typeof crypto === 'undefined' || !crypto.getRandomValues) {
-            throw new Error('crypto.getRandomValues() not supported. See https://github.com/uuidjs/uuid#getrandomvalues-not-supported');
-        }
-        getRandomValues = crypto.getRandomValues.bind(crypto);
-    }
-    return getRandomValues(rnds8);
-}
-
-const randomUUID = typeof crypto !== 'undefined' && crypto.randomUUID && crypto.randomUUID.bind(crypto);
-var native = { randomUUID };
-
-function _v4(options, buf, offset) {
-    options = options || {};
-    const rnds = options.random ?? options.rng?.() ?? rng();
-    if (rnds.length < 16) {
-        throw new Error('Random bytes length must be >= 16');
-    }
-    rnds[6] = (rnds[6] & 0x0f) | 0x40;
-    rnds[8] = (rnds[8] & 0x3f) | 0x80;
-    return unsafeStringify(rnds);
-}
-function v4(options, buf, offset) {
-    if (native.randomUUID && true && !options) {
-        return native.randomUUID();
-    }
-    return _v4(options);
-}
-
 /**
  * Definition of a property, with relevant metadata for type,
  * labels and other useful criteria.
  */
 class Property {
     constructor(schema, property) {
+        this.examples = null;
         this.schema = schema;
         this.name = property.name;
         this.qname = property.qname;
@@ -320,6 +262,7 @@ class Property {
         this.type = schema.model.getType(property.type);
         this.hasRange = this.range !== null;
         this.hasReverse = this.range !== null && this.reverse !== null;
+        this.examples = property.examples || null;
     }
     getRange() {
         return this.schema.model.getSchema(this.range);
@@ -586,6 +529,14 @@ class Model {
             return new Entity(this, raw);
         }
     }
+    /**
+     * Generate a new random UUID.
+     *
+     * @returns a new UUID.
+     */
+    generateRandomId() {
+        return crypto.randomUUID();
+    }
     /**
      * Make a new object with the given schema, and generate a random ID for
      * it.
@@ -594,7 +545,7 @@ class Model {
      */
     createEntity(schema, namespace) {
         return __awaiter(this, void 0, void 0, function* () {
-            const rawId = v4();
+            const rawId = this.generateRandomId();
             const id = namespace ? yield namespace.sign(rawId) : rawId;
             return this.getEntity({
                 id,
@@ -1315,14 +1266,6 @@ var schemata = {
 				qname: "Address:city",
 				type: "string"
 			},
-			country: {
-				label: "Country",
-				matchable: true,
-				maxLength: 16,
-				name: "country",
-				qname: "Address:country",
-				type: "country"
-			},
 			full: {
 				label: "Full address",
 				matchable: true,
@@ -1370,7 +1313,7 @@ var schemata = {
 				type: "string"
 			},
 			postalCode: {
-				description: "Zip code or postcode.",
+				description: "Zip code or postcode",
 				label: "Postal code",
 				maxLength: 16,
 				name: "postalCode",
@@ -1378,7 +1321,7 @@ var schemata = {
 				type: "string"
 			},
 			region: {
-				description: "Also province or area.",
+				description: "Also province or area",
 				label: "Region",
 				maxLength: 1024,
 				name: "region",
@@ -1386,7 +1329,7 @@ var schemata = {
 				type: "string"
 			},
 			remarks: {
-				description: "Handling instructions, like 'care of'.",
+				description: "Handling instructions, like 'care of'",
 				label: "Remarks",
 				maxLength: 1024,
 				name: "remarks",
@@ -1394,7 +1337,7 @@ var schemata = {
 				type: "string"
 			},
 			state: {
-				description: "State or federal unit.",
+				description: "State or federal unit",
 				label: "State",
 				maxLength: 1024,
 				name: "state",
@@ -1687,7 +1630,7 @@ var schemata = {
 		]
 	},
 	Associate: {
-		description: "Non-family association between two people",
+		description: "Non-family association between two people.",
 		edge: {
 			caption: [
 				"relationship"
@@ -1709,7 +1652,7 @@ var schemata = {
 		plural: "Associates",
 		properties: {
 			associate: {
-				description: "An associate of the subject person.",
+				description: "An associate of the subject person",
 				label: "Associate",
 				matchable: true,
 				maxLength: 200,
@@ -1720,7 +1663,7 @@ var schemata = {
 				type: "entity"
 			},
 			person: {
-				description: "The subject of the association.",
+				description: "The subject of the association",
 				label: "Person",
 				matchable: true,
 				maxLength: 200,
@@ -2081,7 +2024,7 @@ var schemata = {
 		caption: [
 			"title"
 		],
-		description: "A public appeal issued by an authority, possibly on behalf of another, for buying a specific work, supply or service\n",
+		description: "A public appeal issued by an authority, possibly on behalf of another, for buying a specific work, supply or service.\n",
 		"extends": [
 			"Interval",
 			"Thing"
@@ -2207,7 +2150,7 @@ var schemata = {
 				type: "string"
 			},
 			fallsUnderGPPScope: {
-				description: "European Green Public Procurement (GPP) or green purchasing.",
+				description: "European Green Public Procurement (GPP) or green purchasing",
 				label: "Does this call fall under the scope of GPP?",
 				maxLength: 1024,
 				name: "fallsUnderGPPScope",
@@ -2374,7 +2317,12 @@ var schemata = {
 	},
 	Company: {
 		caption: [
-			"name"
+			"name",
+			"alias",
+			"abbreviation",
+			"weakAlias",
+			"previousName",
+			"registrationNumber"
 		],
 		description: "A corporation, usually for profit. Does not distinguish between private and public companies, and can also be used to model more specific constructs like trusts and funds. Companies are assets, so they can be owned by other legal entities.\n",
 		"extends": [
@@ -2410,13 +2358,13 @@ var schemata = {
 			},
 			capital: {
 				label: "Capital",
-				maxLength: 1024,
+				maxLength: 250,
 				name: "capital",
 				qname: "Company:capital",
-				type: "string"
+				type: "number"
 			},
 			cikCode: {
-				description: "US SEC Central Index Key",
+				description: "US SEC Central Index Key for listed companies",
 				label: "SEC Central Index Key",
 				matchable: true,
 				maxLength: 64,
@@ -2425,7 +2373,7 @@ var schemata = {
 				type: "identifier"
 			},
 			coatoCode: {
-				description: "Soviet classifier for territories, regions, districts, villages. Aka. SOATO and same as OKATO",
+				description: "Soviet classifier for territories, regions, districts, villages. Aka. SOATO and same as OKATO.",
 				label: "COATO / SOATO / OKATO",
 				maxLength: 64,
 				name: "coatoCode",
@@ -2465,6 +2413,7 @@ var schemata = {
 				type: "identifier"
 			},
 			isinCode: {
+				deprecated: true,
 				description: "International Securities Identification Number",
 				label: "ISIN",
 				matchable: true,
@@ -2482,16 +2431,8 @@ var schemata = {
 				qname: "Company:jibCode",
 				type: "identifier"
 			},
-			jurisdiction: {
-				label: "Jurisdiction",
-				matchable: true,
-				maxLength: 16,
-				name: "jurisdiction",
-				qname: "Company:jurisdiction",
-				type: "country"
-			},
 			kppCode: {
-				description: "Russian code issued by the tax authority, identifies the reason for registration at the Federal Tax Service (Russian: КПП). A company may have multiple KPP codes (e.g. for different branches), and the codes are not unique across companies.",
+				description: "(RU, КПП) Russian code issued by the tax authority, identifies the reason for registration at the Federal Tax Service. A company may have multiple KPP codes (e.g. for different branches), and the codes are not unique across companies.",
 				label: "KPP",
 				maxLength: 64,
 				name: "kppCode",
@@ -2507,7 +2448,7 @@ var schemata = {
 				type: "identifier"
 			},
 			okopfCode: {
-				description: "Russian classifier that that categorizes different types of legal entities in Russia based on their organizational and legal structure (Russian: ОКОПФ)",
+				description: "(RU, ОКОПФ) Russian classifier that categorizes different types of legal entities in Russia based on their organizational and legal structure",
 				label: "OKOPF",
 				maxLength: 1024,
 				name: "okopfCode",
@@ -2515,7 +2456,7 @@ var schemata = {
 				type: "string"
 			},
 			oksmCode: {
-				description: "Russian (ОКСМ) countries classifier",
+				description: "(RU, ОКСМ) Russian countries classifier",
 				label: "OKSM",
 				maxLength: 1024,
 				name: "oksmCode",
@@ -2523,7 +2464,7 @@ var schemata = {
 				type: "string"
 			},
 			okvedCode: {
-				description: "Russian classifier that that categorizes businesses by their (primary and secondary) economic activities (Russian: ОКВЭД)",
+				description: "(RU, ОКВЭД) Russian classifier that categorizes businesses by their (primary and secondary) economic activities",
 				label: "OKVED(2) Classifier",
 				maxLength: 1024,
 				name: "okvedCode",
@@ -2531,7 +2472,7 @@ var schemata = {
 				type: "string"
 			},
 			pfrNumber: {
-				description: "(RU, ПФР) Pension Fund Registration number. AAA-BBB-CCCCCC, where AAA is organisation region, BBB is district, CCCCCC number at a specific branch",
+				description: "(RU, ПФР) Pension Fund Registration number. AAA-BBB-CCCCCC, where AAA is organisation region, BBB is district, and CCCCCC is the number at a specific branch.",
 				label: "PFR Number",
 				matchable: true,
 				maxLength: 64,
@@ -2539,14 +2480,6 @@ var schemata = {
 				qname: "Company:pfrNumber",
 				type: "identifier"
 			},
-			registrationNumber: {
-				label: "Registration number",
-				matchable: true,
-				maxLength: 64,
-				name: "registrationNumber",
-				qname: "Company:registrationNumber",
-				type: "identifier"
-			},
 			ricCode: {
 				label: "Reuters Instrument Code",
 				matchable: true,
@@ -2599,7 +2532,7 @@ var schemata = {
 			"name",
 			"procedureNumber"
 		],
-		description: "An contract or contract lot issued by an authority. Multiple lots may be awarded to different suppliers (see ContractAward).\n",
+		description: "A contract or contract lot issued by an authority. Multiple lots may be awarded to different suppliers (see `ContractAward`).\n",
 		"extends": [
 			"Asset"
 		],
@@ -2737,6 +2670,10 @@ var schemata = {
 				type: "entity"
 			},
 			status: {
+				examples: [
+					"In force",
+					"Annulled"
+				],
 				label: "Status",
 				maxLength: 1024,
 				name: "status",
@@ -2751,7 +2688,12 @@ var schemata = {
 				type: "string"
 			},
 			type: {
-				description: "Type of contract. Potentially W (Works), U (Supplies), S (Services).\n",
+				description: "Type of contract",
+				examples: [
+					"W (Works)",
+					"U (Supplies)",
+					"S (Services)"
+				],
 				label: "Type",
 				maxLength: 1024,
 				name: "type",
@@ -3083,6 +3025,15 @@ var schemata = {
 		matchable: true,
 		plural: "Cryptocurrency wallets",
 		properties: {
+			accountId: {
+				description: "Platform-specific user/account identifier",
+				label: "Account ID",
+				matchable: true,
+				maxLength: 64,
+				name: "accountId",
+				qname: "CryptoWallet:accountId",
+				type: "identifier"
+			},
 			balance: {
 				label: "Balance",
 				maxLength: 250,
@@ -3098,6 +3049,14 @@ var schemata = {
 				qname: "CryptoWallet:balanceDate",
 				type: "date"
 			},
+			blockchain: {
+				description: "The blockchain or distributed ledger system on which the wallet operates",
+				label: "Blockchain",
+				maxLength: 1024,
+				name: "blockchain",
+				qname: "CryptoWallet:blockchain",
+				type: "string"
+			},
 			creationDate: {
 				label: "Creation date",
 				matchable: true,
@@ -3106,6 +3065,15 @@ var schemata = {
 				qname: "CryptoWallet:creationDate",
 				type: "date"
 			},
+			cryptoAddress: {
+				description: "The crypto address of the wallet",
+				label: "Crypto address",
+				matchable: true,
+				maxLength: 512,
+				name: "cryptoAddress",
+				qname: "CryptoWallet:cryptoAddress",
+				type: "identifier"
+			},
 			currencySymbol: {
 				label: "Currency short code",
 				maxLength: 1024,
@@ -3113,6 +3081,14 @@ var schemata = {
 				qname: "CryptoWallet:currencySymbol",
 				type: "string"
 			},
+			custodyType: {
+				description: "Type of custody arrangement for the wallet (e.g., self-custody, custodial service)",
+				label: "Custody type",
+				maxLength: 1024,
+				name: "custodyType",
+				qname: "CryptoWallet:custodyType",
+				type: "string"
+			},
 			holder: {
 				label: "Wallet holder",
 				matchable: true,
@@ -3141,7 +3117,7 @@ var schemata = {
 				description: "Public key used to identify the wallet",
 				label: "Address",
 				matchable: true,
-				maxLength: 128,
+				maxLength: 512,
 				name: "publicKey",
 				qname: "CryptoWallet:publicKey",
 				type: "identifier"
@@ -3250,6 +3226,7 @@ var schemata = {
 		plural: "Directorships",
 		properties: {
 			director: {
+				description: "The entity exercising control over another",
 				label: "Director",
 				matchable: true,
 				maxLength: 200,
@@ -3638,7 +3615,7 @@ var schemata = {
 			"goodsDescription",
 			"ccdNumber"
 		],
-		description: "A foreign economic activity",
+		description: "A foreign economic activity.",
 		"extends": [
 			"Interval"
 		],
@@ -4120,14 +4097,6 @@ var schemata = {
 		label: "Event",
 		plural: "Events",
 		properties: {
-			country: {
-				label: "Country",
-				matchable: true,
-				maxLength: 16,
-				name: "country",
-				qname: "Event:country",
-				type: "country"
-			},
 			important: {
 				label: "Important",
 				maxLength: 1024,
@@ -4184,7 +4153,7 @@ var schemata = {
 		}
 	},
 	Family: {
-		description: "Family relationship between two people",
+		description: "Family relationship between two people.",
 		edge: {
 			caption: [
 				"relationship"
@@ -4206,7 +4175,7 @@ var schemata = {
 		plural: "Family members",
 		properties: {
 			person: {
-				description: "The subject of the familial relation.",
+				description: "The subject of the familial relation",
 				label: "Person",
 				matchable: true,
 				maxLength: 200,
@@ -4217,7 +4186,11 @@ var schemata = {
 				type: "entity"
 			},
 			relationship: {
-				description: "Nature of the relationship, from the person's perspective eg. 'mother', where 'relative' is mother of 'person'.",
+				description: "Nature of the relationship from the `person`'s perspective, e.g. 'mother', where `relative` is the mother of `person`",
+				examples: [
+					"mother",
+					"sibling"
+				],
 				label: "Relationship",
 				maxLength: 1024,
 				name: "relationship",
@@ -4225,7 +4198,7 @@ var schemata = {
 				type: "string"
 			},
 			relative: {
-				description: "The relative of the subject person.",
+				description: "The relative of the subject person",
 				label: "Relative",
 				matchable: true,
 				maxLength: 200,
@@ -4358,7 +4331,7 @@ var schemata = {
 		caption: [
 			"number"
 		],
-		description: "An form of identification associated with its holder and some issuing country. This can be used for national ID cards, voter enrollments and similar instruments.\n",
+		description: "A form of identification associated with its holder and some issuing country. This can be used for national ID cards, voter enrollments, and similar instruments.\n",
 		"extends": [
 			"Interval"
 		],
@@ -4374,6 +4347,7 @@ var schemata = {
 		plural: "Identifications",
 		properties: {
 			authority: {
+				description: "Government body issuing the identification document",
 				label: "Authority",
 				maxLength: 1024,
 				name: "authority",
@@ -4407,6 +4381,10 @@ var schemata = {
 				type: "identifier"
 			},
 			type: {
+				examples: [
+					"Passport",
+					"Driving license"
+				],
 				label: "Type",
 				maxLength: 1024,
 				name: "type",
@@ -4451,6 +4429,14 @@ var schemata = {
 		label: "Image",
 		plural: "Images",
 		properties: {
+			credit: {
+				description: "The credit or attribution for the image",
+				label: "Credit",
+				maxLength: 1024,
+				name: "credit",
+				qname: "Image:credit",
+				type: "string"
+			},
 			pictured: {
 				label: "Pictured",
 				matchable: true,
@@ -4532,6 +4518,7 @@ var schemata = {
 				type: "url"
 			},
 			date: {
+				description: "Date associated with an Interval that isn't explicitly its `startDate` or `endDate` (prefer those when available)",
 				label: "Date",
 				matchable: true,
 				maxLength: 32,
@@ -4547,6 +4534,7 @@ var schemata = {
 				type: "text"
 			},
 			endDate: {
+				description: "The date of expiry of a document, or on which a relationship, sanctioned status, occupation, etc. ended",
 				label: "End date",
 				matchable: true,
 				maxLength: 32,
@@ -4563,6 +4551,7 @@ var schemata = {
 				type: "text"
 			},
 			modifiedAt: {
+				description: "The date on which the entity (like the ID document) was modified, not to be confused with an internal 'last updated'-style metadata field",
 				label: "Modified on",
 				matchable: true,
 				maxLength: 32,
@@ -4604,6 +4593,7 @@ var schemata = {
 				type: "url"
 			},
 			recordId: {
+				description: "Identifier of a record upon which this link is based",
 				label: "Record ID",
 				maxLength: 1024,
 				name: "recordId",
@@ -4611,6 +4601,7 @@ var schemata = {
 				type: "string"
 			},
 			retrievedAt: {
+				description: "Retrieval date generated by a data gathering system, not to be confused with an internal 'first found'-style metadata field",
 				label: "Retrieved on",
 				maxLength: 32,
 				name: "retrievedAt",
@@ -4618,6 +4609,7 @@ var schemata = {
 				type: "date"
 			},
 			sourceUrl: {
+				description: "A deep link to a source website for the profile",
 				label: "Source link",
 				maxLength: 4096,
 				name: "sourceUrl",
@@ -4625,6 +4617,7 @@ var schemata = {
 				type: "url"
 			},
 			startDate: {
+				description: "The date of issue of a document, or on which a relationship, sanctioned status, occupation, etc. started",
 				label: "Start date",
 				matchable: true,
 				maxLength: 32,
@@ -4656,11 +4649,15 @@ var schemata = {
 	LegalEntity: {
 		caption: [
 			"name",
+			"alias",
+			"abbreviation",
+			"weakAlias",
+			"previousName",
 			"email",
 			"phone",
 			"registrationNumber"
 		],
-		description: "Any party to legal proceedings, such as asset ownership, corporate governance or social interactions. Often used when raw data does not specify if something is a person or company.\n",
+		description: "Any party to legal proceedings, such as asset ownership, corporate governance or social interactions. Often used when raw data does not specify if something is a person, organization or company.\n",
 		"extends": [
 			"Thing"
 		],
@@ -4674,6 +4671,14 @@ var schemata = {
 		matchable: true,
 		plural: "Legal entities",
 		properties: {
+			abbreviation: {
+				description: "Abbreviated name or acronym",
+				label: "Abbreviation",
+				maxLength: 384,
+				name: "abbreviation",
+				qname: "LegalEntity:abbreviation",
+				type: "name"
+			},
 			agencyClient: {
 				label: "Clients",
 				matchable: true,
@@ -4754,6 +4759,13 @@ var schemata = {
 				type: "entity"
 			},
 			classification: {
+				description: "Classification as provided by the data source or inferred based on other provided data; prefer `sector` if relevant",
+				examples: [
+					"Local government (current)",
+					"Banking operations license",
+					"4. Priority Sector Apparel",
+					"Entities Directly Serving the Defense and Security Sectors"
+				],
 				label: "Classification",
 				maxLength: 1024,
 				name: "classification",
@@ -4901,7 +4913,7 @@ var schemata = {
 			},
 			email: {
 				description: "Email address",
-				label: "E-Mail",
+				label: "Email",
 				matchable: true,
 				maxLength: 250,
 				name: "email",
@@ -4990,7 +5002,7 @@ var schemata = {
 				type: "date"
 			},
 			innCode: {
-				description: "Russian tax identification number (Russian: ИНН). Issued to businesses and individuals in Russia",
+				description: "(RU, ИНН) Russian tax identification number. Issued to businesses and individuals in Russia.",
 				format: "inn",
 				label: "INN",
 				matchable: true,
@@ -5000,7 +5012,7 @@ var schemata = {
 				type: "identifier"
 			},
 			jurisdiction: {
-				description: "Country or region in which this entity operates",
+				description: "Country or region in which this entity operates; prefer over broader `country` when relevant",
 				label: "Jurisdiction",
 				matchable: true,
 				maxLength: 16,
@@ -5009,6 +5021,10 @@ var schemata = {
 				type: "country"
 			},
 			legalForm: {
+				description: "Company or organization type",
+				examples: [
+					"Joint Stock Company"
+				],
 				label: "Legal form",
 				maxLength: 1024,
 				name: "legalForm",
@@ -5035,7 +5051,7 @@ var schemata = {
 				type: "identifier"
 			},
 			mainCountry: {
-				description: "Primary country of this entity",
+				description: "Primary country of this entity; prefer over broader `country` when relevant",
 				label: "Country of origin",
 				matchable: true,
 				maxLength: 16,
@@ -5098,7 +5114,7 @@ var schemata = {
 				type: "identifier"
 			},
 			ogrnCode: {
-				description: "Identification number used in Russia's Unified State Register of Legal Entities (EGRUL) (Russian: ОГРН)",
+				description: "(RU, ОГРН) Registration number used in Russia's Unified State Register of Legal Entities (EGRUL)",
 				format: "ogrn",
 				label: "OGRN",
 				matchable: true,
@@ -5158,7 +5174,7 @@ var schemata = {
 			},
 			parent: {
 				deprecated: true,
-				description: "If this entity is a subsidiary, another entity (company or organisation) is its parent",
+				description: "Deprecated, use `Ownership` link instead",
 				label: "Parent company",
 				matchable: true,
 				maxLength: 200,
@@ -5239,6 +5255,12 @@ var schemata = {
 				type: "identifier"
 			},
 			sector: {
+				description: "Industrial or trade sector as provided by the data source",
+				examples: [
+					"Registered Nurse",
+					"Retail and wholesale",
+					"Sea and coastal freight water transport"
+				],
 				label: "Sector",
 				maxLength: 1024,
 				name: "sector",
@@ -5257,6 +5279,13 @@ var schemata = {
 				type: "entity"
 			},
 			status: {
+				description: "A short string describing how 'active' (broadly defined) an entity is",
+				examples: [
+					"Current / Former / Sitting / Retired",
+					"Active / Inactive",
+					"Dissolved (last known activity October 2024)",
+					"Liquidated on 12 November 2022"
+				],
 				label: "Status",
 				maxLength: 1024,
 				name: "status",
@@ -5286,7 +5315,7 @@ var schemata = {
 				type: "entity"
 			},
 			swiftBic: {
-				description: "Bank identifier code",
+				description: "SWIFT Bank identifier code from ISO9362",
 				format: "bic",
 				label: "SWIFT/BIC",
 				matchable: true,
@@ -5316,6 +5345,10 @@ var schemata = {
 				type: "entity"
 			},
 			taxStatus: {
+				examples: [
+					"Non-Habitual Resident",
+					"Compliant as at March 2022"
+				],
 				label: "Tax status",
 				maxLength: 1024,
 				name: "taxStatus",
@@ -5333,7 +5366,7 @@ var schemata = {
 				type: "identifier"
 			},
 			uscCode: {
-				description: "Unified Social Credit Identifier",
+				description: "Chinese Unified Social Credit Identifier",
 				format: "uscc",
 				label: "USCC",
 				matchable: true,
@@ -5392,7 +5425,7 @@ var schemata = {
 		caption: [
 			"name"
 		],
-		description: "A grant of land, rights or property. A type of Contract",
+		description: "A grant of land, rights or property. A type of `Contract`.",
 		"extends": [
 			"Contract"
 		],
@@ -5795,13 +5828,31 @@ var schemata = {
 		label: "Occupancy",
 		plural: "Occupancies",
 		properties: {
+			constituency: {
+				description: "The geographic area/distict represented by the holder",
+				label: "Constituency",
+				maxLength: 1024,
+				name: "constituency",
+				qname: "Occupancy:constituency",
+				type: "string"
+			},
 			declarationDate: {
+				description: "If established by an asset declaration",
 				label: "Declaration date",
 				maxLength: 32,
 				name: "declarationDate",
 				qname: "Occupancy:declarationDate",
 				type: "date"
 			},
+			electionDate: {
+				description: "Election date for the position, if applicable",
+				label: "Election date",
+				matchable: true,
+				maxLength: 32,
+				name: "electionDate",
+				qname: "Occupancy:electionDate",
+				type: "date"
+			},
 			holder: {
 				label: "Holder",
 				matchable: true,
@@ -5812,6 +5863,32 @@ var schemata = {
 				reverse: "positionOccupancies",
 				type: "entity"
 			},
+			periodEnd: {
+				description: "End date of the period for which the position is occupied",
+				label: "Period end",
+				matchable: true,
+				maxLength: 32,
+				name: "periodEnd",
+				qname: "Occupancy:periodEnd",
+				type: "date"
+			},
+			periodStart: {
+				description: "Start date of the period for which the position is occupied",
+				label: "Period start",
+				matchable: true,
+				maxLength: 32,
+				name: "periodStart",
+				qname: "Occupancy:periodStart",
+				type: "date"
+			},
+			politicalGroup: {
+				description: "Caucus, faction or parliamentary group of the holder",
+				label: "Political group",
+				maxLength: 1024,
+				name: "politicalGroup",
+				qname: "Occupancy:politicalGroup",
+				type: "string"
+			},
 			post: {
 				label: "Position occupied",
 				matchable: true,
@@ -5823,6 +5900,10 @@ var schemata = {
 				type: "entity"
 			},
 			status: {
+				examples: [
+					"current",
+					"ended"
+				],
 				label: "Status",
 				maxLength: 1024,
 				name: "status",
@@ -5851,9 +5932,14 @@ var schemata = {
 	},
 	Organization: {
 		caption: [
-			"name"
+			"name",
+			"alias",
+			"abbreviation",
+			"weakAlias",
+			"previousName",
+			"registrationNumber"
 		],
-		description: "Any type of incorporated entity that cannot be owned by another (see Company). This might include charities, foundations or state-owned enterprises, depending on their jurisdiction.\n",
+		description: "Any type of incorporated entity that cannot be owned by another (see `Company`). This might include charities, foundations or state-owned enterprises, depending on their jurisdiction.\n",
 		"extends": [
 			"LegalEntity"
 		],
@@ -6027,6 +6113,12 @@ var schemata = {
 				type: "entity"
 			},
 			ownershipType: {
+				examples: [
+					"beneficial",
+					"direct",
+					"indirect",
+					"ultimate"
+				],
 				label: "Type of ownership",
 				maxLength: 1024,
 				name: "ownershipType",
@@ -6256,7 +6348,7 @@ var schemata = {
 			"passportNumber",
 			"number"
 		],
-		description: "An passport held by a person.\n",
+		description: "A passport held by a person.\n",
 		"extends": [
 			"Identification"
 		],
@@ -6294,6 +6386,8 @@ var schemata = {
 				type: "gender"
 			},
 			givenName: {
+				deprecated: true,
+				description: "Deprecated, use `Identification:holder` link's `firstName` / `middleName` instead",
 				label: "Given name",
 				maxLength: 1024,
 				name: "givenName",
@@ -6301,6 +6395,8 @@ var schemata = {
 				type: "string"
 			},
 			passportNumber: {
+				deprecated: true,
+				description: "Deprecated, use `Identification:number` instead",
 				hidden: true,
 				label: "Passport number",
 				matchable: true,
@@ -6318,6 +6414,8 @@ var schemata = {
 				type: "identifier"
 			},
 			surname: {
+				deprecated: true,
+				description: "Deprecated, use `Identification:holder` link's `lastName` instead",
 				label: "Surname",
 				maxLength: 1024,
 				name: "surname",
@@ -6487,7 +6585,9 @@ var schemata = {
 		caption: [
 			"name",
 			"alias",
+			"previousName",
 			"weakAlias",
+			"abbreviation",
 			"lastName",
 			"email",
 			"phone"
@@ -6566,6 +6666,7 @@ var schemata = {
 				type: "country"
 			},
 			deathDate: {
+				description: "Joined the choir invisible.",
 				label: "Death date",
 				matchable: true,
 				maxLength: 32,
@@ -6700,6 +6801,9 @@ var schemata = {
 				type: "string"
 			},
 			nameSuffix: {
+				examples: [
+					"OBE"
+				],
 				label: "Name suffix",
 				maxLength: 1024,
 				name: "nameSuffix",
@@ -6763,7 +6867,7 @@ var schemata = {
 			},
 			secondName: {
 				deprecated: true,
-				description: "Deprecated, use one of the other more specific name properties instead.",
+				description: "Deprecated, use one of the other more specific name properties instead",
 				label: "Second name",
 				maxLength: 1024,
 				name: "secondName",
@@ -6858,7 +6962,7 @@ var schemata = {
 		caption: [
 			"name"
 		],
-		description: "A post, role or position within an organization or body. This describes a position one or more people may occupy and not the occupation of the post by a specific individual at a specific point in time.\n'subnationalArea' should be used to further restrict the scope of the position. It should not simply represent some regional aspect of the role - e.g. the constituency of a national member of parliament - when their legislative jurisdiction is nationwide.\n",
+		description: "A post, role or position within an organization or body. This describes a position one or more people may occupy and not the occupation of the post by a specific individual at a specific point in time (see `Occupancy`).\n",
 		"extends": [
 			"Thing"
 		],
@@ -6916,7 +7020,8 @@ var schemata = {
 				type: "entity"
 			},
 			subnationalArea: {
-				label: "Subnational jurisdiction name or code",
+				description: "The name or code of a subnational jurisdiction, only when the position is geographically limited. Prefer `Occupancy:constituency` where relevant.",
+				label: "Subnational area",
 				maxLength: 1024,
 				name: "subnationalArea",
 				qname: "Position:subnationalArea",
@@ -6944,7 +7049,7 @@ var schemata = {
 			"name",
 			"projectId"
 		],
-		description: "An activity carried out by a group of participants.\n",
+		description: "An activity carried out by a group of `participants`.\n",
 		"extends": [
 			"Interval",
 			"Thing",
@@ -7041,7 +7146,7 @@ var schemata = {
 		caption: [
 			"role"
 		],
-		description: "An activity carried out by a group of participants.\n",
+		description: "A participant in a `Project`.\n",
 		edge: {
 			caption: [
 				"role"
@@ -7100,7 +7205,11 @@ var schemata = {
 	},
 	PublicBody: {
 		caption: [
-			"name"
+			"name",
+			"alias",
+			"abbreviation",
+			"weakAlias",
+			"previousName"
 		],
 		description: "A public body, such as a ministry, department or state company.\n",
 		"extends": [
@@ -7339,7 +7448,7 @@ var schemata = {
 			"reason",
 			"status"
 		],
-		description: "A risk associated with an entity",
+		description: "A risk associated with an entity.",
 		"extends": [
 			"Interval"
 		],
@@ -7429,7 +7538,7 @@ var schemata = {
 		caption: [
 			"program"
 		],
-		description: "A sanction designation",
+		description: "A sanction designation.",
 		"extends": [
 			"Interval"
 		],
@@ -7484,6 +7593,7 @@ var schemata = {
 				type: "entity"
 			},
 			listingDate: {
+				description: "The date on which the designation is listed; distinct from the `startDate`, which is the date on which the designation goes into effect",
 				label: "Listing date",
 				matchable: true,
 				maxLength: 32,
@@ -7522,6 +7632,7 @@ var schemata = {
 				type: "string"
 			},
 			reason: {
+				description: "An explanation of the designation's justification.",
 				label: "Reason",
 				maxLength: 65000,
 				name: "reason",
@@ -7529,6 +7640,12 @@ var schemata = {
 				type: "text"
 			},
 			status: {
+				examples: [
+					"Active",
+					"Inactive",
+					"Expired",
+					"Suspended"
+				],
 				label: "Status",
 				maxLength: 1024,
 				name: "status",
@@ -7536,6 +7653,7 @@ var schemata = {
 				type: "string"
 			},
 			unscId: {
+				description: "Identifier issued by the UN Security Council for sanctions designations",
 				label: "UN SC identifier",
 				matchable: true,
 				maxLength: 16,
@@ -7865,7 +7983,7 @@ var schemata = {
 		}
 	},
 	TaxRoll: {
-		description: "A tax declaration of an individual",
+		description: "A tax declaration of an individual.",
 		"extends": [
 			"Interval"
 		],
@@ -7973,6 +8091,7 @@ var schemata = {
 		plural: "Thing",
 		properties: {
 			address: {
+				description: "A textual description of an address linked to the entity",
 				label: "Address",
 				matchable: true,
 				maxLength: 250,
@@ -7981,6 +8100,7 @@ var schemata = {
 				type: "address"
 			},
 			addressEntity: {
+				description: "A reference to an `Address` entity with structured place information",
 				label: "Address",
 				matchable: true,
 				maxLength: 200,
@@ -7999,6 +8119,7 @@ var schemata = {
 				type: "url"
 			},
 			alias: {
+				description: "An alternative or secondary name",
 				label: "Alias",
 				matchable: true,
 				maxLength: 384,
@@ -8018,6 +8139,7 @@ var schemata = {
 				type: "entity"
 			},
 			country: {
+				description: "An association between the entity and a country that is not covered by a more specific property (e.g. `jurisdiction`, `birthCountry`, `mainCountry`)",
 				label: "Country",
 				matchable: true,
 				maxLength: 16,
@@ -8037,6 +8159,7 @@ var schemata = {
 				type: "entity"
 			},
 			createdAt: {
+				description: "The date on which the entity was created, not to be confused with an internal 'first saved'-style metadata field",
 				label: "Created at",
 				maxLength: 32,
 				name: "createdAt",
@@ -8044,6 +8167,7 @@ var schemata = {
 				type: "date"
 			},
 			description: {
+				description: "A longer description; see also `notes`, `summary`",
 				label: "Description",
 				maxLength: 65000,
 				name: "description",
@@ -8070,6 +8194,7 @@ var schemata = {
 				type: "text"
 			},
 			keywords: {
+				description: "Plain text keywords provided for the entity; prefer more specific `type`, `status`, etc. as appropriate",
 				label: "Keywords",
 				maxLength: 1024,
 				name: "keywords",
@@ -8088,6 +8213,7 @@ var schemata = {
 				type: "entity"
 			},
 			modifiedAt: {
+				description: "The date on which the entity was modified, not to be confused with an internal 'last updated'-style metadata field",
 				label: "Modified on",
 				maxLength: 32,
 				name: "modifiedAt",
@@ -8095,6 +8221,7 @@ var schemata = {
 				type: "date"
 			},
 			name: {
+				description: "The primary name of the entity",
 				label: "Name",
 				matchable: true,
 				maxLength: 384,
@@ -8114,6 +8241,7 @@ var schemata = {
 				type: "entity"
 			},
 			notes: {
+				description: "Narrative description of the entity; see also `description`, `summary`",
 				label: "Notes",
 				maxLength: 65000,
 				name: "notes",
@@ -8121,6 +8249,7 @@ var schemata = {
 				type: "text"
 			},
 			previousName: {
+				description: "A former name of the entity",
 				label: "Previous name",
 				matchable: true,
 				maxLength: 384,
@@ -8129,7 +8258,7 @@ var schemata = {
 				type: "name"
 			},
 			program: {
-				description: "Regulatory program or sanctions list on which an entity is listed.",
+				description: "Regulatory program or sanctions list on which an entity is listed",
 				label: "Program",
 				maxLength: 1024,
 				name: "program",
@@ -8169,6 +8298,7 @@ var schemata = {
 				type: "url"
 			},
 			retrievedAt: {
+				description: "Retrieval date generated by a data gathering system, not to be confused with an internal 'first found'-style metadata field",
 				label: "Retrieved on",
 				maxLength: 32,
 				name: "retrievedAt",
@@ -8198,6 +8328,7 @@ var schemata = {
 				type: "entity"
 			},
 			sourceUrl: {
+				description: "A deep link to a source website for the profile",
 				label: "Source link",
 				maxLength: 4096,
 				name: "sourceUrl",
@@ -8205,6 +8336,7 @@ var schemata = {
 				type: "url"
 			},
 			summary: {
+				description: "A short one-liner description; see also `description`, `notes`",
 				label: "Summary",
 				maxLength: 65000,
 				name: "summary",
@@ -8212,6 +8344,12 @@ var schemata = {
 				type: "text"
 			},
 			topics: {
+				description: "Controlled tags used to qualify the entity and associate it with a risk category",
+				examples: [
+					"sanction",
+					"debarment",
+					"role.pep"
+				],
 				label: "Topics",
 				maxLength: 64,
 				name: "topics",
@@ -8249,6 +8387,9 @@ var schemata = {
 				type: "name"
 			},
 			wikidataId: {
+				examples: [
+					"Q7747"
+				],
 				format: "wikidata",
 				label: "Wikidata ID",
 				matchable: true,
@@ -8428,7 +8569,7 @@ var schemata = {
 		properties: {
 			email: {
 				description: "Email address",
-				label: "E-Mail",
+				label: "Email",
 				matchable: true,
 				maxLength: 250,
 				name: "email",
@@ -8618,6 +8759,7 @@ var schemata = {
 			},
 			owner: {
 				deprecated: true,
+				description: "Deprecated, use `Ownership` link instead",
 				label: "Owner",
 				matchable: true,
 				maxLength: 200,
@@ -8655,6 +8797,9 @@ var schemata = {
 				type: "entity"
 			},
 			type: {
+				examples: [
+					"Bulk carrier"
+				],
 				label: "Type",
 				maxLength: 1024,
 				name: "type",
@@ -8714,6 +8859,7 @@ var schemata = {
 				type: "identifier"
 			},
 			deadweightTonnage: {
+				description: "Weight of the vessel when not carrying freight",
 				label: "Deadweight Tonnage",
 				maxLength: 250,
 				name: "deadweightTonnage",
@@ -9438,6 +9584,7 @@ var types = {
 			"gov.security": "Security services",
 			"gov.soe": "State-owned enterprise",
 			"gov.state": "State government",
+			"invest.risk": "Investment risk",
 			"mare.detained": "Maritime detention",
 			"mare.shadow": "Shadow fleet",
 			"mare.sts": "Ship-to-ship transfer",
@@ -9457,8 +9604,11 @@ var types = {
 			"role.lawyer": "Lawyer",
 			"role.lobby": "Lobbyist",
 			"role.oligarch": "Oligarch",
-			"role.pep": "Politician",
-			"role.pol": "Non-PEP",
+			"role.pep": "PEP",
+			"role.pep.frmr": "Former PEP",
+			"role.pep.intl": "International PEP",
+			"role.pep.natl": "National PEP",
+			"role.pol": "Politician",
 			"role.rca": "Close Associate",
 			"role.spy": "Spy",
 			sanction: "Sanctioned entity",