@finsys/core 4.5.0 → 4.7.0

package/dist/index.cjs

@@ -61,11 +61,13 @@ __export(index_exports, {
   buildDocumentRows: () => buildDocumentRows,
   buildFileFieldTables: () => buildFileFieldTables,
   buildFileFieldTablesFromInstances: () => buildFileFieldTablesFromInstances,
+  categoriesAttestingFact: () => categoriesAttestingFact,
   categoryFieldsOf: () => categoryFieldsOf,
   categoryForField: () => categoryForField,
   categorySchemaOf: () => categorySchemaOf,
   evaluateExpression: () => evaluateExpression,
   extractTimePeriods: () => extractTimePeriods,
+  factOf: () => factOf,
   formatDocumentSize: () => formatDocumentSize,
   formatDocumentType: () => formatDocumentType,
   formatDocumentUploaded: () => formatDocumentUploaded,
@@ -10321,7 +10323,7 @@ function applyAggregation(op, instances) {
 
 // src/data/adapter-categories.json
 var adapter_categories_default = {
-  schemaVersion: "1.0.0",
+  schemaVersion: "1.1.0",
   categories: [
     {
       id: "telco-carrier",
@@ -10960,6 +10962,856 @@ var adapter_categories_default = {
           description: "Net pay for the period."
         }
       ]
+    },
+    {
+      id: "finxtract-financial-statement",
+      displayName: "Financial Statement (Document Extraction)",
+      description: "Fields extracted from an uploaded audited financial-statement document by the host's extraction pipeline. One document = one audited financial statement carrying TWO declared periods per the period-axis contract: period1 is its current fiscal year, period2 is its prior comparative year. Metric names are bare in the flat vocabulary, like the bank-statement extraction category's.",
+      canonicalTable: "ihsfinancialstatement",
+      fields: [
+        {
+          name: "localNo",
+          type: "string",
+          description: "Company registration (local) number as stated on the document."
+        },
+        {
+          name: "companyName",
+          type: "string",
+          fact: "companyName",
+          description: "Company name as stated on the document. Attestation of the shared companyName fact \u2014 the SSM Form 9 extraction category attests the same fact from its own document."
+        },
+        {
+          name: "financialYearEnd",
+          type: "string",
+          description: "Financial year end stated by the source document, normalized to ISO YYYY-MM-DD. Shared verbatim by every period the document carries \u2014 period identity comes from declared position, never from this date."
+        },
+        {
+          name: "consolidated",
+          type: "boolean",
+          description: "Whether the statement reports consolidated (group-level) accounts."
+        },
+        {
+          name: "currency",
+          type: "string",
+          description: "Reporting currency stated on the document."
+        },
+        {
+          name: "year",
+          type: "number",
+          description: "1-based ordinal of this document within the applicant's uploaded statement sequence; document 1 covers the most recent fiscal years."
+        },
+        {
+          name: "nonCurrentAssetsSubsidiaryCompanies",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: subsidiary companies."
+        },
+        {
+          name: "nonCurrentAssetsAssociatedCompanies",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: associated companies."
+        },
+        {
+          name: "nonCurrentAssetsDevelopmentPropertiesOrExpenditure",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: development properties or expenditure."
+        },
+        {
+          name: "nonCurrentAssetInvestmentProperties",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: investment properties."
+        },
+        {
+          name: "nonCurrentAssetsInvestments",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: investments."
+        },
+        {
+          name: "nonCurrentAssetInvestmentSecurities",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: investment securities."
+        },
+        {
+          name: "nonCurrentAssetDeferredAssets",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: deferred assets."
+        },
+        {
+          name: "nonCurrentAssetDeposits",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: deposits."
+        },
+        {
+          name: "nonCurrentAssetOwnGoodwill",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: own goodwill."
+        },
+        {
+          name: "nonCurrentAssetGoodwillOnConsolidation",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: goodwill on consolidation."
+        },
+        {
+          name: "nonCurrentAssetSinkingFund",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: sinking fund."
+        },
+        {
+          name: "nonCurrentAssetPropertyPlantEquipment",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: property plant equipment."
+        },
+        {
+          name: "nonCurrentAssetInventories",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: inventories."
+        },
+        {
+          name: "nonCurrentAssetRightOfUseAssets",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: right of use assets."
+        },
+        {
+          name: "nonCurrentAssetIntangibleAssets",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: intangible assets."
+        },
+        {
+          name: "nonCurrentAssetPrepaidLeasePayments",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: prepaid lease payments."
+        },
+        {
+          name: "nonCurrentAssetFinancialAssetAtFairValue",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: financial asset at fair value."
+        },
+        {
+          name: "nonCurrentAssetLandUseRight",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: land use right."
+        },
+        {
+          name: "nonCurrentAssetTradeReceivables",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: trade receivables."
+        },
+        {
+          name: "nonCurrentAssetOtherReceivables",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: other receivables."
+        },
+        {
+          name: "nonCurrentAssetTradeAndOtherReceivables",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: trade and other receivables."
+        },
+        {
+          name: "nonCurrentAssetOtherReceivablesDepositsAndPrepayments",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current assets: other receivables deposits and prepayments."
+        },
+        {
+          name: "totalNonCurrentAssets",
+          type: "number",
+          unit: "MYR",
+          description: "Balance-sheet total: non-current assets."
+        },
+        {
+          name: "currentAssetDevelopmentPropertiesOrExpenditure",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: development properties or expenditure."
+        },
+        {
+          name: "currentAssetShortTermInvestments",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: short term investments."
+        },
+        {
+          name: "currentAssetTradeDebtors",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: trade debtors."
+        },
+        {
+          name: "currentAssetShortTermDeposits",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: short term deposits."
+        },
+        {
+          name: "currentAssetAmountDueFromHoldingCompany",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: amount due from holding company."
+        },
+        {
+          name: "currentAssetAmountDueFromSubsidiaryCompanies",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: amount due from subsidiary companies."
+        },
+        {
+          name: "currentAssetAmountDueFromAssociatedCompanies",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: amount due from associated companies."
+        },
+        {
+          name: "currentAssetAmountDueFromDirector",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: amount due from director."
+        },
+        {
+          name: "currentAssetAmountDueFromCustomer",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: amount due from customer."
+        },
+        {
+          name: "currentAssetAmountOwingByShareholders",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: amount owing by shareholders."
+        },
+        {
+          name: "currentAssetInventories",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: inventories."
+        },
+        {
+          name: "currentAssetFinancialAssetAtFairValue",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: financial asset at fair value."
+        },
+        {
+          name: "currentAssetLandUseRight",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: land use right."
+        },
+        {
+          name: "currentAssetTaxRecoverable",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: tax recoverable."
+        },
+        {
+          name: "currentAssetContractAssets",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: contract assets."
+        },
+        {
+          name: "currentAssetCurrentTaxAssets",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: current tax assets."
+        },
+        {
+          name: "currentAssetPrepayments",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: prepayments."
+        },
+        {
+          name: "currentAssetDerivative",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: derivative."
+        },
+        {
+          name: "currentAssetCashAndBankBalances",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: cash and bank balances."
+        },
+        {
+          name: "currentAssetOtherReceivables",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: other receivables."
+        },
+        {
+          name: "currentAssetRestrictedCash",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: restricted cash."
+        },
+        {
+          name: "currentAssetCashAndCashEquivalents",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: cash and cash equivalents."
+        },
+        {
+          name: "currentAssetDepositsCashAndBankBalances",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: deposits cash and bank balances."
+        },
+        {
+          name: "currentAssetCashAtBanks",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: cash at banks."
+        },
+        {
+          name: "currentAssetCashOnHand",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: cash on hand."
+        },
+        {
+          name: "currentAssetDepositsAndPrepayments",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: deposits and prepayments."
+        },
+        {
+          name: "currentAssetTradeAndOtherReceivables",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: trade and other receivables."
+        },
+        {
+          name: "currentAssetOtherReceivablesDepositsAndPrepayments",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: other receivables deposits and prepayments."
+        },
+        {
+          name: "currentAssetOtherReceivablesAndDeposits",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: other receivables and deposits."
+        },
+        {
+          name: "currentAssetOtherReceivablesAndPrepayments",
+          type: "number",
+          unit: "MYR",
+          description: "Current assets: other receivables and prepayments."
+        },
+        {
+          name: "totalCurrentAssets",
+          type: "number",
+          unit: "MYR",
+          description: "Balance-sheet total: current assets."
+        },
+        {
+          name: "totalAssets",
+          type: "number",
+          unit: "MYR",
+          description: "Balance-sheet total: assets."
+        },
+        {
+          name: "currentLiabilitiesTradeCreditors",
+          type: "number",
+          unit: "MYR",
+          description: "Current liabilities: trade creditors."
+        },
+        {
+          name: "currentLiabilitiesHirePurchasePayables",
+          type: "number",
+          unit: "MYR",
+          description: "Current liabilities: hire purchase payables."
+        },
+        {
+          name: "currentLiabilitiesBankOverdraft",
+          type: "number",
+          unit: "MYR",
+          description: "Current liabilities: bank overdraft."
+        },
+        {
+          name: "currentLiabilitiesBankAcceptance",
+          type: "number",
+          unit: "MYR",
+          description: "Current liabilities: bank acceptance."
+        },
+        {
+          name: "currentLiabilitiesBorrowingsOrTermLoans",
+          type: "number",
+          unit: "MYR",
+          description: "Current liabilities: borrowings or term loans."
+        },
+        {
+          name: "currentLiabilitiesBankborrowings",
+          type: "number",
+          unit: "MYR",
+          description: "Current liabilities: bank borrowings."
+        },
+        {
+          name: "currentLiabilitiesAmountsOwingToHoldingCompany",
+          type: "number",
+          unit: "MYR",
+          description: "Current liabilities: amounts owing to holding company."
+        },
+        {
+          name: "currentLiabilitiesAmountsOwingToSubsidiaryCompanies",
+          type: "number",
+          unit: "MYR",
+          description: "Current liabilities: amounts owing to subsidiary companies."
+        },
+        {
+          name: "currentLiabilitiesAmountOwingToAssociatedCompanies",
+          type: "number",
+          unit: "MYR",
+          description: "Current liabilities: amount owing to associated companies."
+        },
+        {
+          name: "currentLiabilitiesAmountsOwingToDirector",
+          type: "number",
+          unit: "MYR",
+          description: "Current liabilities: amounts owing to director."
+        },
+        {
+          name: "currentLiabilitiesProvisionForTaxation",
+          type: "number",
+          unit: "MYR",
+          description: "Current liabilities: provision for taxation."
+        },
+        {
+          name: "currentLiabilitiesLeasePayables",
+          type: "number",
+          unit: "MYR",
+          description: "Current liabilities: lease payables."
+        },
+        {
+          name: "currentLiabilitiesFinanceLeasePayables",
+          type: "number",
+          unit: "MYR",
+          description: "Current liabilities: finance lease payables."
+        },
+        {
+          name: "currentLiabilitiesOtherPayables",
+          type: "number",
+          unit: "MYR",
+          description: "Current liabilities: other payables."
+        },
+        {
+          name: "currentLiabilitiesDividendPayables",
+          type: "number",
+          unit: "MYR",
+          description: "Current liabilities: dividend payables."
+        },
+        {
+          name: "currentLiabilitiesTradeAndOtherPayables",
+          type: "number",
+          unit: "MYR",
+          description: "Current liabilities: trade and other payables."
+        },
+        {
+          name: "currentLiabilitiesDepositsFromCustomers",
+          type: "number",
+          unit: "MYR",
+          description: "Current liabilities: deposits from customers."
+        },
+        {
+          name: "currentLiabilitiesOtherPayablesAccrualsAndDeposits",
+          type: "number",
+          unit: "MYR",
+          description: "Current liabilities: other payables accruals and deposits."
+        },
+        {
+          name: "currentLiabilitiesOtherPayablesAndAccruals",
+          type: "number",
+          unit: "MYR",
+          description: "Current liabilities: other payables and accruals."
+        },
+        {
+          name: "currentLiabilitiesContractLiabilities",
+          type: "number",
+          unit: "MYR",
+          description: "Current liabilities: contract liabilities."
+        },
+        {
+          name: "currentLiabilitiesDerivative",
+          type: "number",
+          unit: "MYR",
+          description: "Current liabilities: derivative."
+        },
+        {
+          name: "totalCurrentLiabilities",
+          type: "number",
+          unit: "MYR",
+          description: "Balance-sheet total: current liabilities."
+        },
+        {
+          name: "shortTermLiabilities",
+          type: "number",
+          unit: "MYR",
+          description: "Balance-sheet total: short-term liabilities."
+        },
+        {
+          name: "nonCurrentLiabilitiesBorrowingsOrTermLoans",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current liabilities: borrowings or term loans."
+        },
+        {
+          name: "nonCurrentLiabilitiesBankBorrowings",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current liabilities: bank borrowings."
+        },
+        {
+          name: "nonCurrentLiabilitiesLeaseObligations",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current liabilities: lease obligations."
+        },
+        {
+          name: "nonCurrentLiabilitiesFinanceLeaseObligations",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current liabilities: finance lease obligations."
+        },
+        {
+          name: "nonCurrentLiabilitiesDeferredTaxation",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current liabilities: deferred taxation."
+        },
+        {
+          name: "nonCurrentLiabilitiesRetirementBenefits",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current liabilities: retirement benefits."
+        },
+        {
+          name: "nonCurrentLiabilitiesHirePurchasePayables",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current liabilities: hire purchase payables."
+        },
+        {
+          name: "nonCurrentLiabilitiesDepositsFromCustomers",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current liabilities: deposits from customers."
+        },
+        {
+          name: "nonCurrentLiabilitiesContractLiabilities",
+          type: "number",
+          unit: "MYR",
+          description: "Non-current liabilities: contract liabilities."
+        },
+        {
+          name: "totalNonCurrentLiabilities",
+          type: "number",
+          unit: "MYR",
+          description: "Balance-sheet total: non-current liabilities."
+        },
+        {
+          name: "totalLiabilities",
+          type: "number",
+          unit: "MYR",
+          description: "Balance-sheet total: liabilities."
+        },
+        {
+          name: "shareCapital",
+          type: "number",
+          unit: "MYR",
+          description: "Equity: share capital."
+        },
+        {
+          name: "preferenceShareCapital",
+          type: "number",
+          unit: "MYR",
+          description: "Equity: preference share capital."
+        },
+        {
+          name: "sharePremium",
+          type: "number",
+          unit: "MYR",
+          description: "Equity: share premium."
+        },
+        {
+          name: "reserves",
+          type: "number",
+          unit: "MYR",
+          description: "Equity: reserves."
+        },
+        {
+          name: "capitalReserves",
+          type: "number",
+          unit: "MYR",
+          description: "Equity: capital reserves."
+        },
+        {
+          name: "revaluationReserves",
+          type: "number",
+          unit: "MYR",
+          description: "Equity: revaluation reserves."
+        },
+        {
+          name: "exchangeEqualisationOrFluctuationReserves",
+          type: "number",
+          unit: "MYR",
+          description: "Equity: exchange equalisation or fluctuation reserves."
+        },
+        {
+          name: "retainedEarnings",
+          type: "number",
+          unit: "MYR",
+          description: "Equity: retained earnings."
+        },
+        {
+          name: "totalEquity",
+          type: "number",
+          unit: "MYR",
+          description: "Balance-sheet total: equity."
+        },
+        {
+          name: "revenue",
+          type: "number",
+          unit: "MYR",
+          description: "Income statement: revenue."
+        },
+        {
+          name: "costOfGoodsSold",
+          type: "number",
+          unit: "MYR",
+          description: "Income statement: cost of goods sold."
+        },
+        {
+          name: "grossProfit",
+          type: "number",
+          unit: "MYR",
+          description: "Income statement: gross profit."
+        },
+        {
+          name: "otherIncome",
+          type: "number",
+          unit: "MYR",
+          description: "Income statement: other income."
+        },
+        {
+          name: "profitFromOperations",
+          type: "number",
+          unit: "MYR",
+          description: "Income statement: profit from operations."
+        },
+        {
+          name: "financeCost",
+          type: "number",
+          unit: "MYR",
+          description: "Income statement: finance cost."
+        },
+        {
+          name: "ebitda",
+          type: "number",
+          unit: "MYR",
+          description: "Income statement: profit before tax (extracted from the statement's profit-before-tax line; canonical name kept verbatim from the host vocabulary)."
+        },
+        {
+          name: "taxes",
+          type: "number",
+          unit: "MYR",
+          description: "Income statement: taxes."
+        },
+        {
+          name: "zakat",
+          type: "number",
+          unit: "MYR",
+          description: "Income statement: zakat."
+        },
+        {
+          name: "profitAfterTax",
+          type: "number",
+          unit: "MYR",
+          description: "Income statement: profit after tax."
+        },
+        {
+          name: "netProfit",
+          type: "number",
+          unit: "MYR",
+          description: "Income statement: total comprehensive income for the financial year."
+        },
+        {
+          name: "netOperatingCashFlow",
+          type: "number",
+          unit: "MYR",
+          description: "Cash-flow statement: net cash flow used in / generated from operating activities."
+        },
+        {
+          name: "depreciation",
+          type: "number",
+          unit: "MYR",
+          description: "Cash-flow statement: depreciation."
+        },
+        {
+          name: "depreciationOfPropertyPlantEquipment",
+          type: "number",
+          unit: "MYR",
+          description: "Cash-flow statement: depreciation of property plant equipment."
+        },
+        {
+          name: "depreciationRightOfUseAssets",
+          type: "number",
+          unit: "MYR",
+          description: "Cash-flow statement: depreciation right of use assets."
+        },
+        {
+          name: "depreciationOfInvestmentProperties",
+          type: "number",
+          unit: "MYR",
+          description: "Cash-flow statement: depreciation of investment properties."
+        },
+        {
+          name: "depreciationOfInvestmentSecurities",
+          type: "number",
+          unit: "MYR",
+          description: "Cash-flow statement: depreciation of investment securities."
+        },
+        {
+          name: "endOfYearCash",
+          type: "number",
+          unit: "MYR",
+          description: "Cash-flow statement: cash and cash equivalents at the end of the financial year."
+        }
+      ]
+    },
+    {
+      id: "finxtract-form9",
+      displayName: "SSM Form 9 (Document Extraction)",
+      description: "Fields extracted from an uploaded SSM Form 9 (Certificate of Incorporation of Private Company) document by the host's extraction pipeline. One instance per uploaded document. The company name and incorporation date are attestations of shared facts \u2014 the company-profile and financial-statement extraction categories attest the same real-world facts from their own documents.",
+      canonicalTable: "ihs_alt_data_form9",
+      fields: [
+        {
+          name: "companyName",
+          type: "string",
+          fact: "companyName",
+          description: "Company name as printed on the certificate. Attestation of the shared companyName fact."
+        },
+        {
+          name: "companyRegNo",
+          type: "string",
+          description: "Company registration number as printed on the certificate."
+        },
+        {
+          name: "companyIncorporationDate",
+          type: "string",
+          fact: "companyIncorporationDate",
+          description: "Date of incorporation as printed on the certificate, normalized to ISO YYYY-MM-DD. Attestation of the shared companyIncorporationDate fact \u2014 a company has exactly one incorporation date regardless of which document it was extracted from."
+        }
+      ]
+    },
+    {
+      id: "finxtract-ssm",
+      displayName: "SSM Company Profile (Document Extraction)",
+      description: "Fields extracted from an uploaded SSM company-profile document (company or business registration extract) by the host's extraction pipeline. One instance per uploaded document. Covers registration identity, status, key dates, registered address, capital, and the officer/shareholder registers. The incorporation date is an attestation of a shared fact \u2014 the Form 9 extraction category attests the same real-world fact from its own document.",
+      canonicalTable: "ihs_alt_data_ssm",
+      fields: [
+        {
+          name: "ssmCompanyEntityType",
+          type: "string",
+          description: "Entity type stated on the profile (e.g. private limited company, enterprise)."
+        },
+        {
+          name: "ssmCompanyName",
+          type: "string",
+          description: "Business or company name as stated on the profile."
+        },
+        {
+          name: "ssmCompanyRegNo",
+          type: "string",
+          description: "Business or company registration number as stated on the profile."
+        },
+        {
+          name: "companyStatus",
+          type: "string",
+          description: "Registration status as stated on the profile (e.g. existing, dissolved)."
+        },
+        {
+          name: "businessOrigin",
+          type: "string",
+          description: "Business origin as stated on the profile."
+        },
+        {
+          name: "companyIncorporationDate",
+          type: "string",
+          fact: "companyIncorporationDate",
+          description: "Incorporation (or registration) date as stated on the profile, normalized to ISO YYYY-MM-DD. Attestation of the shared companyIncorporationDate fact \u2014 a company has exactly one incorporation date regardless of which document it was extracted from."
+        },
+        {
+          name: "businessCommencementDate",
+          type: "string",
+          description: "Business commencement (or start) date as stated on the profile, normalized to ISO YYYY-MM-DD."
+        },
+        {
+          name: "businessNature",
+          type: "string",
+          description: "Nature of business as stated on the profile."
+        },
+        {
+          name: "registeredAddress",
+          type: "string",
+          description: "Registered business address as stated on the profile."
+        },
+        {
+          name: "totalShareIssued",
+          type: "number",
+          description: "Total shares issued as stated on the profile."
+        },
+        {
+          name: "ssmPaidUpCapital",
+          type: "number",
+          unit: "MYR",
+          description: "Paid-up capital as stated on the profile (falls back to total shares issued when the profile omits an explicit paid-up figure)."
+        },
+        {
+          name: "directors",
+          type: "string",
+          description: "JSON-encoded list of current directors/officers (for enterprises, the business owner normalized into the same shape)."
+        },
+        {
+          name: "shareholders",
+          type: "string",
+          description: "JSON-encoded list of shareholders (for enterprises, the business owner normalized into the same shape)."
+        },
+        {
+          name: "previousDirectors",
+          type: "string",
+          description: "JSON-encoded list of previous directors/officers."
+        },
+        {
+          name: "companyLastOldName",
+          type: "string",
+          description: "The company's most recent former name, when the profile records a name change."
+        },
+        {
+          name: "companyNameDateOfChange",
+          type: "string",
+          description: "Date of the most recent name change, normalized to ISO YYYY-MM-DD."
+        }
+      ]
     }
   ]
 };
@@ -10982,6 +11834,9 @@ function buildCategoryRegistry(raw) {
   }
   const byId = /* @__PURE__ */ new Map();
   const fieldToCategory = /* @__PURE__ */ new Map();
+  const fieldToFact = /* @__PURE__ */ new Map();
+  const factToCategories = /* @__PURE__ */ new Map();
+  const declarations = /* @__PURE__ */ new Map();
   const tables = /* @__PURE__ */ new Set();
   const all = [];
   for (const cat of raw.categories) {
@@ -11016,11 +11871,34 @@ function buildCategoryRegistry(raw) {
       if (typeof f.name !== "string" || f.name.length === 0) {
         throw new Error(`adapter category data: ${where} has a field with no name`);
       }
-      if (fieldToCategory.has(f.name)) {
+      if (f.fact !== void 0 && (typeof f.fact !== "string" || f.fact.length === 0)) {
         throw new Error(
-          `adapter category data: canonical field "${f.name}" declared by more than one category (${fieldToCategory.get(f.name)} + ${cat.id}) \u2014 field names must be globally unique`
+          `adapter category data: field "${f.name}" (${where}) has an invalid fact \u2014 expected a non-empty string`
         );
       }
+      const prior = declarations.get(f.name);
+      if (prior) {
+        if (prior.categories.includes(cat.id)) {
+          throw new Error(
+            `adapter category data: ${where} declares field "${f.name}" more than once`
+          );
+        }
+        if (prior.fact === void 0 || f.fact === void 0 || prior.fact !== f.fact) {
+          const describeFact = (fact) => fact === void 0 ? "no fact" : `fact "${fact}"`;
+          throw new Error(
+            `adapter category data: canonical field "${f.name}" declared by more than one category (${prior.categories.join(" + ")} with ${describeFact(prior.fact)} + ${cat.id} with ${describeFact(f.fact)}) \u2014 field names must be globally unique unless every declaring category attests the same fact`
+          );
+        }
+      }
+      if (f.fact !== void 0) {
+        for (const [otherName, otherFact] of fieldToFact) {
+          if (otherFact === f.fact && otherName !== f.name) {
+            throw new Error(
+              `adapter category data: fact "${f.fact}" is carried by two different field names ("${otherName}" + "${f.name}") \u2014 a fact id must map to exactly one canonical field name`
+            );
+          }
+        }
+      }
       if (!VALID_FIELD_TYPES.includes(f.type)) {
         throw new Error(
           `adapter category data: field "${f.name}" (${where}) has invalid type "${f.type}"`
@@ -11043,10 +11921,26 @@ function buildCategoryRegistry(raw) {
         type: f.type,
         ...f.unit !== void 0 ? { unit: f.unit } : {},
         ...f.range !== void 0 ? { range: Object.freeze([f.range[0], f.range[1]]) } : {},
-        description: f.description
+        description: f.description,
+        ...f.fact !== void 0 ? { fact: f.fact } : {}
       });
       fields.push(spec);
-      fieldToCategory.set(f.name, cat.id);
+      if (prior) {
+        prior.categories.push(cat.id);
+        fieldToCategory.delete(f.name);
+      } else {
+        declarations.set(f.name, { fact: f.fact, categories: [cat.id] });
+        fieldToCategory.set(f.name, cat.id);
+      }
+      if (f.fact !== void 0) {
+        fieldToFact.set(f.name, f.fact);
+        const attesters = factToCategories.get(f.fact);
+        if (attesters) {
+          attesters.push(cat.id);
+        } else {
+          factToCategories.set(f.fact, [cat.id]);
+        }
+      }
     }
     const schema = Object.freeze({
       id: cat.id,
@@ -11063,7 +11957,14 @@ function buildCategoryRegistry(raw) {
     all: Object.freeze(all),
     ids: Object.freeze(all.map((c) => c.id)),
     byId,
-    fieldToCategory
+    fieldToCategory,
+    fieldToFact,
+    factToCategories: new Map(
+      [...factToCategories].map(([fact, cats]) => [
+        fact,
+        Object.freeze(cats)
+      ])
+    )
   });
 }
 var registry = buildCategoryRegistry(adapter_categories_default);
@@ -11086,6 +11987,12 @@ function allCategories() {
 function categoryForField(field) {
   return registry.fieldToCategory.get(field) ?? null;
 }
+function factOf(field) {
+  return registry.fieldToFact.get(field) ?? null;
+}
+function categoriesAttestingFact(factId) {
+  return registry.factToCategories.get(factId) ?? [];
+}
 function isAdapterCategory(id) {
   return registry.byId.has(id);
 }
@@ -11130,11 +12037,13 @@ function assertAdapterCategory(id) {
   buildDocumentRows,
   buildFileFieldTables,
   buildFileFieldTablesFromInstances,
+  categoriesAttestingFact,
   categoryFieldsOf,
   categoryForField,
   categorySchemaOf,
   evaluateExpression,
   extractTimePeriods,
+  factOf,
   formatDocumentSize,
   formatDocumentType,
   formatDocumentUploaded,