@fintekkers/ledger-models 0.4.24 → 0.4.25

package/hierarchy.json

@@ -1,6 +1,6 @@
 {
-  "schema_version": "1.0",
-  "_doc": "Single source of truth for the FinTekkers product hierarchy. See ../docs/product-hierarchy.md for narrative description, hierarchy-examples.md for worked examples, and registry-versioning.md for compatibility rules. Each leaf product_type carries (asset_class, instrument_type). Abstract nodes carry only hierarchy. status=active entries must have a matching ProductTypeProto enum value (CI-enforced). status=planned entries are aspirational and not yet wired into the proto enum. NOTE: M1 ships a 3-dimensional registry (productType + asset_class + instrument_type). The 4th dimension (index_type — single_name vs index) is intentionally deferred and will be added in a future milestone. Option strategy leaves (butterfly, vertical spread, calendar spread, condor, straddle, ...) are also intentionally absent — strategies are derived from the legs field on SecurityProto, not from a productType enum value.",
+  "schema_version": "1.1",
+  "_doc": "Single source of truth for the FinTekkers product hierarchy. See ../docs/product-hierarchy.md for narrative description, hierarchy-examples.md for worked examples, and registry-versioning.md for compatibility rules. Each leaf product_type carries (asset_class, instrument_type). Abstract nodes carry only hierarchy. status=active entries must have a matching ProductTypeProto enum value (CI-enforced). status=planned entries are aspirational and not yet wired into the proto enum. NOTE: M1 ships a 3-dimensional registry (productType + asset_class + instrument_type). The 4th dimension (index_type — single_name vs index) is intentionally deferred and will be added in a future milestone. Option strategy leaves (butterfly, vertical spread, calendar spread, condor, straddle, ...) are also intentionally absent — strategies are derived from the legs field on SecurityProto, not from a productType enum value. asset_classes is the one canonical asset-class vocabulary (codes and tree); an entry's optional aliases list names legacy values that resolve to it. enum_labels holds display labels (and identifier-type input placeholders) for proto enum values with no entry elsewhere, keyed by proto enum name then value name. See ../docs/adr/asset_class_vocabulary.md.",
 
   "product_types": {
     "BOND": { "parent": null, "abstract": true, "label": "Bond" },
@@ -116,7 +116,7 @@
     "CREDIT":       { "parent": "FIXED_INCOME", "label": "Credit" },
     "EQUITY":       { "parent": null,           "label": "Equity" },
     "VOLATILITY":   { "parent": null,           "label": "Volatility" },
-    "CASH":         { "parent": null,           "label": "Cash" },
+    "CASH":         { "parent": null,           "label": "Cash", "aliases": ["CASH_ASSET_CLASS"] },
     "FX":           { "parent": null,           "label": "Foreign Exchange" },
     "CRYPTO":       { "parent": null,           "label": "Crypto" },
     "COMMODITY":    { "parent": null,           "label": "Commodity" },
@@ -127,5 +127,32 @@
     "ALTERNATIVE":  { "parent": null,           "label": "Alternative" }
   },
 
-  "instrument_types": ["CASH", "DERIVATIVE", "REFERENCE_INDEX"]
+  "instrument_types": ["CASH", "DERIVATIVE", "REFERENCE_INDEX"],
+
+  "enum_labels": {
+    "IdentifierTypeProto": {
+      "UNKNOWN_IDENTIFIER_TYPE": { "label": "Unknown",           "placeholder": "Identifier" },
+      "EXCH_TICKER":             { "label": "Exchange Ticker",   "placeholder": "e.g. AAPL" },
+      "ISIN":                    { "label": "ISIN",              "placeholder": "e.g. US0378331005" },
+      "CUSIP":                   { "label": "CUSIP",             "placeholder": "e.g. 037833100" },
+      "OSI":                     { "label": "OSI Option Symbol", "placeholder": "e.g. AAPL  250117C00150000" },
+      "FIGI":                    { "label": "FIGI",              "placeholder": "e.g. BBG000B9XRY4" },
+      "SERIES_ID":               { "label": "Series ID",         "placeholder": "e.g. CPIAUCSL" },
+      "INDEX_NAME":              { "label": "Index Name",        "placeholder": "e.g. SPX" },
+      "CASH":                    { "label": "Currency Code",     "placeholder": "e.g. USD" }
+    },
+    "InstrumentTypeProto": {
+      "INSTRUMENT_TYPE_UNKNOWN":         { "label": "Unknown" },
+      "INSTRUMENT_TYPE_CASH":            { "label": "Cash" },
+      "INSTRUMENT_TYPE_DERIVATIVE":      { "label": "Derivative" },
+      "INSTRUMENT_TYPE_REFERENCE_INDEX": { "label": "Reference Index" }
+    },
+    "ProductTypeProto": {
+      "PRODUCT_TYPE_UNKNOWN": { "label": "Unknown" }
+    },
+    "AssetClassProto": {
+      "UNKNOWN_ASSET_CLASS": { "label": "Unknown" },
+      "INDEX":               { "label": "Index" }
+    }
+  }
 }

package/node/wrappers/models/security/asset_class_vocabulary.test.d.ts

@@ -0,0 +1 @@
+export {};

package/node/wrappers/models/security/asset_class_vocabulary.test.js

@@ -0,0 +1,146 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * LM-275: one asset-class vocabulary (hierarchy.json), a shared match helper
+ * and labels for every enum the UI shows.
+ *
+ * The match cases live in ledger-models-protos/fixtures/asset_class_matches.json,
+ * shared with the Java and Python tests.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const product_hierarchy_1 = require("./product_hierarchy");
+const asset_class_pb_1 = require("../../../fintekkers/models/security/asset_class_pb");
+const identifier_type_pb_1 = require("../../../fintekkers/models/security/identifier/identifier_type_pb");
+const instrument_type_pb_1 = require("../../../fintekkers/models/security/instrument_type_pb");
+const product_type_pb_1 = require("../../../fintekkers/models/security/product_type_pb");
+const PROTOS = path.resolve(__dirname, '../../../../../ledger-models-protos');
+const rows = JSON.parse(fs.readFileSync(path.join(PROTOS, 'fixtures/asset_class_matches.json'), 'utf-8')).cases;
+const hierarchy = JSON.parse(fs.readFileSync(path.join(PROTOS, 'hierarchy.json'), 'utf-8'));
+describe('assetClassMatches shared fixture', () => {
+    test.each(rows)('assetClassMatches($filter, $stored) === $expected', ({ filter, stored, expected }) => {
+        expect((0, product_hierarchy_1.assetClassMatches)(filter, stored)).toBe(expected);
+    });
+    test('fixture has the required rows', () => {
+        expect(rows.length).toBeGreaterThanOrEqual(7);
+        const found = new Map(rows.map((r) => [`${r.filter}|${r.stored}`, r.expected]));
+        const required = [
+            ['FIXED_INCOME|RATES', true],
+            ['FIXED_INCOME|CREDIT', true],
+            ['FIXED_INCOME|Fixed Income', true],
+            ['EQUITY|Equity', true],
+            ['CASH|Cash', true],
+            ['EQUITY|RATES', false],
+            ['EQUITY|NOT_AN_ASSET_CLASS', false],
+        ];
+        for (const [key, expected] of required) {
+            expect([key, found.get(key)]).toEqual([key, expected]);
+        }
+    });
+});
+describe('the tree comes from hierarchy.json', () => {
+    test('every asset_classes entry matches its parent, label and aliases', () => {
+        var _a;
+        const entries = Object.entries(hierarchy.asset_classes);
+        expect(entries.length).toBeGreaterThan(0);
+        for (const [code, entry] of entries) {
+            if (entry.parent)
+                expect([entry.parent, code, (0, product_hierarchy_1.assetClassMatches)(entry.parent, code)]).toEqual([entry.parent, code, true]);
+            expect([code, entry.label, (0, product_hierarchy_1.assetClassMatches)(code, entry.label)]).toEqual([code, entry.label, true]);
+            for (const alias of (_a = entry.aliases) !== null && _a !== void 0 ? _a : []) {
+                expect([code, alias, (0, product_hierarchy_1.assetClassMatches)(code, alias)]).toEqual([code, alias, true]);
+            }
+        }
+    });
+    test('an ambiguous label fails at load', () => {
+        expect(() => (0, product_hierarchy_1.buildAssetClassLookup)({ A: { parent: null, label: 'Shared' }, B: { parent: null, label: 'shared' } })).toThrow();
+    });
+});
+describe('labels for every enum value', () => {
+    const enums = [
+        ['IdentifierTypeProto', identifier_type_pb_1.IdentifierTypeProto, product_hierarchy_1.identifierTypeLabelOf],
+        ['InstrumentTypeProto', instrument_type_pb_1.InstrumentTypeProto, product_hierarchy_1.instrumentTypeLabelOf],
+        ['ProductTypeProto', product_type_pb_1.ProductTypeProto, product_hierarchy_1.productTypeLabelOf],
+        ['AssetClassProto', asset_class_pb_1.AssetClassProto, product_hierarchy_1.assetClassProtoLabelOf],
+    ];
+    test.each(enums)('every %s value has a non-empty label', (name, enumObj, labelOf) => {
+        var _a;
+        const values = Object.entries(enumObj);
+        expect(values.length).toBeGreaterThan(0);
+        let checked = 0;
+        for (const [valueName, v] of values) {
+            expect([`${name}.${valueName}`, ((_a = labelOf(v)) !== null && _a !== void 0 ? _a : '').trim() !== '']).toEqual([`${name}.${valueName}`, true]);
+            checked++;
+        }
+        expect(checked).toBe(values.length);
+    });
+    test('every IdentifierTypeProto value has a non-empty placeholder', () => {
+        var _a;
+        const values = Object.entries(identifier_type_pb_1.IdentifierTypeProto);
+        for (const [valueName, v] of values) {
+            expect([valueName, ((_a = (0, product_hierarchy_1.identifierTypePlaceholderOf)(v)) !== null && _a !== void 0 ? _a : '').trim() !== '']).toEqual([valueName, true]);
+        }
+        expect(values.length).toBeGreaterThan(0);
+    });
+    test('CASH_ASSET_CLASS is labelled Cash', () => {
+        expect((0, product_hierarchy_1.assetClassProtoLabelOf)(asset_class_pb_1.AssetClassProto.CASH_ASSET_CLASS)).toBe('Cash');
+    });
+    test('out-of-range numbers return null', () => {
+        expect((0, product_hierarchy_1.identifierTypeLabelOf)(9999)).toBeNull();
+        expect((0, product_hierarchy_1.identifierTypePlaceholderOf)(9999)).toBeNull();
+        expect((0, product_hierarchy_1.instrumentTypeLabelOf)(9999)).toBeNull();
+        expect((0, product_hierarchy_1.productTypeLabelOf)(9999)).toBeNull();
+        expect((0, product_hierarchy_1.assetClassProtoLabelOf)(9999)).toBeNull();
+    });
+});
+describe('the published (compiled) product_hierarchy.js', () => {
+    // npm publish runs no tsc: the tracked .js is what consumers get.
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const compiled = require('./product_hierarchy.js');
+    test('exports the asset-class match helper', () => {
+        expect(typeof compiled.assetClassMatches).toBe('function');
+        expect(typeof compiled.resolveAssetClass).toBe('function');
+        expect(compiled.assetClassMatches('FIXED_INCOME', 'RATES')).toBe(true);
+        expect(compiled.assetClassMatches('EQUITY', 'RATES')).toBe(false);
+    });
+    test('exports the label and placeholder helpers', () => {
+        for (const fn of [
+            'identifierTypeLabelOf',
+            'identifierTypePlaceholderOf',
+            'instrumentTypeLabelOf',
+            'productTypeLabelOf',
+            'assetClassProtoLabelOf',
+        ]) {
+            expect([fn, typeof compiled[fn]]).toEqual([fn, 'function']);
+        }
+        expect(compiled.identifierTypeLabelOf(identifier_type_pb_1.IdentifierTypeProto.ISIN)).toBe('ISIN');
+        expect(compiled.identifierTypePlaceholderOf(identifier_type_pb_1.IdentifierTypeProto.ISIN)).toBeTruthy();
+        expect(compiled.instrumentTypeLabelOf(instrument_type_pb_1.InstrumentTypeProto.INSTRUMENT_TYPE_CASH)).toBeTruthy();
+        expect(compiled.productTypeLabelOf(product_type_pb_1.ProductTypeProto.TBILL)).toBe('Treasury Bill');
+        expect(compiled.assetClassProtoLabelOf(asset_class_pb_1.AssetClassProto.CASH_ASSET_CLASS)).toBe('Cash');
+    });
+});
+//# sourceMappingURL=asset_class_vocabulary.test.js.map

package/node/wrappers/models/security/asset_class_vocabulary.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset_class_vocabulary.test.js","sourceRoot":"","sources":["asset_class_vocabulary.test.ts"],"names":[],"mappings":"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"}

package/node/wrappers/models/security/asset_class_vocabulary.test.ts

@@ -0,0 +1,152 @@
+/**
+ * LM-275: one asset-class vocabulary (hierarchy.json), a shared match helper
+ * and labels for every enum the UI shows.
+ *
+ * The match cases live in ledger-models-protos/fixtures/asset_class_matches.json,
+ * shared with the Java and Python tests.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+
+import {
+  assetClassMatches,
+  assetClassProtoLabelOf,
+  buildAssetClassLookup,
+  identifierTypeLabelOf,
+  identifierTypePlaceholderOf,
+  instrumentTypeLabelOf,
+  productTypeLabelOf,
+} from './product_hierarchy';
+import { AssetClassProto } from '../../../fintekkers/models/security/asset_class_pb';
+import { IdentifierTypeProto } from '../../../fintekkers/models/security/identifier/identifier_type_pb';
+import { InstrumentTypeProto } from '../../../fintekkers/models/security/instrument_type_pb';
+import { ProductTypeProto } from '../../../fintekkers/models/security/product_type_pb';
+
+const PROTOS = path.resolve(__dirname, '../../../../../ledger-models-protos');
+
+interface FixtureRow {
+  filter: string | null;
+  stored: string | null;
+  expected: boolean;
+}
+
+const rows: FixtureRow[] = JSON.parse(
+  fs.readFileSync(path.join(PROTOS, 'fixtures/asset_class_matches.json'), 'utf-8'),
+).cases;
+
+const hierarchy = JSON.parse(fs.readFileSync(path.join(PROTOS, 'hierarchy.json'), 'utf-8'));
+
+describe('assetClassMatches shared fixture', () => {
+  test.each(rows)('assetClassMatches($filter, $stored) === $expected', ({ filter, stored, expected }) => {
+    expect(assetClassMatches(filter, stored)).toBe(expected);
+  });
+
+  test('fixture has the required rows', () => {
+    expect(rows.length).toBeGreaterThanOrEqual(7);
+    const found = new Map(rows.map((r) => [`${r.filter}|${r.stored}`, r.expected]));
+    const required: Array<[string, boolean]> = [
+      ['FIXED_INCOME|RATES', true],
+      ['FIXED_INCOME|CREDIT', true],
+      ['FIXED_INCOME|Fixed Income', true],
+      ['EQUITY|Equity', true],
+      ['CASH|Cash', true],
+      ['EQUITY|RATES', false],
+      ['EQUITY|NOT_AN_ASSET_CLASS', false],
+    ];
+    for (const [key, expected] of required) {
+      expect([key, found.get(key)]).toEqual([key, expected]);
+    }
+  });
+});
+
+describe('the tree comes from hierarchy.json', () => {
+  test('every asset_classes entry matches its parent, label and aliases', () => {
+    const entries = Object.entries<{ parent: string | null; label: string; aliases?: string[] }>(
+      hierarchy.asset_classes,
+    );
+    expect(entries.length).toBeGreaterThan(0);
+    for (const [code, entry] of entries) {
+      if (entry.parent) expect([entry.parent, code, assetClassMatches(entry.parent, code)]).toEqual([entry.parent, code, true]);
+      expect([code, entry.label, assetClassMatches(code, entry.label)]).toEqual([code, entry.label, true]);
+      for (const alias of entry.aliases ?? []) {
+        expect([code, alias, assetClassMatches(code, alias)]).toEqual([code, alias, true]);
+      }
+    }
+  });
+
+  test('an ambiguous label fails at load', () => {
+    expect(() =>
+      buildAssetClassLookup({ A: { parent: null, label: 'Shared' }, B: { parent: null, label: 'shared' } }),
+    ).toThrow();
+  });
+});
+
+describe('labels for every enum value', () => {
+  const enums: Array<[string, object, (v: number) => string | null]> = [
+    ['IdentifierTypeProto', IdentifierTypeProto, identifierTypeLabelOf],
+    ['InstrumentTypeProto', InstrumentTypeProto, instrumentTypeLabelOf],
+    ['ProductTypeProto', ProductTypeProto, productTypeLabelOf],
+    ['AssetClassProto', AssetClassProto, assetClassProtoLabelOf],
+  ];
+
+  test.each(enums)('every %s value has a non-empty label', (name, enumObj, labelOf) => {
+    const values = Object.entries(enumObj);
+    expect(values.length).toBeGreaterThan(0);
+    let checked = 0;
+    for (const [valueName, v] of values) {
+      expect([`${name}.${valueName}`, (labelOf(v) ?? '').trim() !== '']).toEqual([`${name}.${valueName}`, true]);
+      checked++;
+    }
+    expect(checked).toBe(values.length);
+  });
+
+  test('every IdentifierTypeProto value has a non-empty placeholder', () => {
+    const values = Object.entries(IdentifierTypeProto);
+    for (const [valueName, v] of values) {
+      expect([valueName, (identifierTypePlaceholderOf(v as IdentifierTypeProto) ?? '').trim() !== '']).toEqual([valueName, true]);
+    }
+    expect(values.length).toBeGreaterThan(0);
+  });
+
+  test('CASH_ASSET_CLASS is labelled Cash', () => {
+    expect(assetClassProtoLabelOf(AssetClassProto.CASH_ASSET_CLASS)).toBe('Cash');
+  });
+
+  test('out-of-range numbers return null', () => {
+    expect(identifierTypeLabelOf(9999 as IdentifierTypeProto)).toBeNull();
+    expect(identifierTypePlaceholderOf(9999 as IdentifierTypeProto)).toBeNull();
+    expect(instrumentTypeLabelOf(9999 as InstrumentTypeProto)).toBeNull();
+    expect(productTypeLabelOf(9999 as ProductTypeProto)).toBeNull();
+    expect(assetClassProtoLabelOf(9999 as AssetClassProto)).toBeNull();
+  });
+});
+
+describe('the published (compiled) product_hierarchy.js', () => {
+  // npm publish runs no tsc: the tracked .js is what consumers get.
+  // eslint-disable-next-line @typescript-eslint/no-var-requires
+  const compiled = require('./product_hierarchy.js');
+
+  test('exports the asset-class match helper', () => {
+    expect(typeof compiled.assetClassMatches).toBe('function');
+    expect(typeof compiled.resolveAssetClass).toBe('function');
+    expect(compiled.assetClassMatches('FIXED_INCOME', 'RATES')).toBe(true);
+    expect(compiled.assetClassMatches('EQUITY', 'RATES')).toBe(false);
+  });
+
+  test('exports the label and placeholder helpers', () => {
+    for (const fn of [
+      'identifierTypeLabelOf',
+      'identifierTypePlaceholderOf',
+      'instrumentTypeLabelOf',
+      'productTypeLabelOf',
+      'assetClassProtoLabelOf',
+    ]) {
+      expect([fn, typeof compiled[fn]]).toEqual([fn, 'function']);
+    }
+    expect(compiled.identifierTypeLabelOf(IdentifierTypeProto.ISIN)).toBe('ISIN');
+    expect(compiled.identifierTypePlaceholderOf(IdentifierTypeProto.ISIN)).toBeTruthy();
+    expect(compiled.instrumentTypeLabelOf(InstrumentTypeProto.INSTRUMENT_TYPE_CASH)).toBeTruthy();
+    expect(compiled.productTypeLabelOf(ProductTypeProto.TBILL)).toBe('Treasury Bill');
+    expect(compiled.assetClassProtoLabelOf(AssetClassProto.CASH_ASSET_CLASS)).toBe('Cash');
+  });
+});

package/node/wrappers/models/security/product_hierarchy.d.ts

@@ -13,9 +13,25 @@
  * Plus per-leaf classification lookups: assetClassOf, instrumentTypeOf,
  * labelOf.
  *
+ * asset_classes is the one canonical asset-class vocabulary.
+ * assetClassMatches filters stored asset-class values (codes, labels such as
+ * "Fixed Income", or aliases such as "CASH_ASSET_CLASS") against a code,
+ * walking the tree. The *LabelOf / identifierTypePlaceholderOf helpers give
+ * display strings for every value of the enums the UI shows. See
+ * docs/adr/asset_class_vocabulary.md.
+ *
  * `indexTypeOf` is intentionally absent — that dimension is deferred per
  * the M1 descope.
  */
+import { AssetClassProto } from '../../../fintekkers/models/security/asset_class_pb';
+import { IdentifierTypeProto } from '../../../fintekkers/models/security/identifier/identifier_type_pb';
+import { InstrumentTypeProto } from '../../../fintekkers/models/security/instrument_type_pb';
+import { ProductTypeProto } from '../../../fintekkers/models/security/product_type_pb';
+interface AssetClassEntry {
+    parent?: string | null;
+    label?: string;
+    aliases?: string[];
+}
 /** Parent product_type node (abstract or leaf). null for top-level nodes;
  * null for unknown nodes. */
 export declare function parentOf(node: string): string | null;
@@ -36,7 +52,36 @@ export declare function assetClassParentOf(node: string): string | null;
 export declare function assetClassDescendantsOf(ancestor: string): string[];
 export declare function isAssetClassDescendantOf(node: string, ancestor: string): boolean;
 export declare function assetClassLabelOf(node: string): string | null;
+/** Normalised code / label / alias -> code. Throws if two codes claim the
+ * same key, so an ambiguous label or alias fails at load time. Exported for
+ * tests only. */
+export declare function buildAssetClassLookup(classes: Record<string, AssetClassEntry>): Map<string, string>;
+/** Resolve a stored or user-supplied asset-class value to its hierarchy.json
+ * code. An exact code wins; otherwise the value is normalised (trimmed,
+ * upper-cased, runs of whitespace or hyphens turned into `_`) and matched
+ * against every code, label and alias. null for null, blank or unknown. */
+export declare function resolveAssetClass(value: string | null | undefined): string | null;
+/** True iff `storedValue` falls under `filterCode`: both resolve (see
+ * resolveAssetClass) and the stored code equals the filter code or descends
+ * from it. FIXED_INCOME matches RATES, CREDIT and "Fixed Income"; EQUITY
+ * does not match RATES; unknown values match nothing. */
+export declare function assetClassMatches(filterCode: string | null | undefined, storedValue: string | null | undefined): boolean;
+/** Display label for an IdentifierTypeProto value, or null if unknown. */
+export declare function identifierTypeLabelOf(v: IdentifierTypeProto): string | null;
+/** Input placeholder (e.g. "e.g. US0378331005") for an IdentifierTypeProto
+ * value, or null if unknown. */
+export declare function identifierTypePlaceholderOf(v: IdentifierTypeProto): string | null;
+/** Display label for an InstrumentTypeProto value, or null if unknown. */
+export declare function instrumentTypeLabelOf(v: InstrumentTypeProto): string | null;
+/** Display label for a ProductTypeProto value: the product_types label, else
+ * enum_labels (e.g. PRODUCT_TYPE_UNKNOWN). null if unknown. */
+export declare function productTypeLabelOf(v: ProductTypeProto): string | null;
+/** Display label for an AssetClassProto value: the label of the hierarchy.json
+ * code it resolves to (CASH_ASSET_CLASS -> "Cash"), else enum_labels
+ * (e.g. INDEX). null if unknown. */
+export declare function assetClassProtoLabelOf(v: AssetClassProto): string | null;
 export declare function allProductTypes(): string[];
 export declare function activeProductTypes(): string[];
 export declare function allAssetClasses(): string[];
 export declare function allInstrumentTypes(): string[];
+export {};

package/node/wrappers/models/security/product_hierarchy.js

@@ -14,6 +14,13 @@
  * Plus per-leaf classification lookups: assetClassOf, instrumentTypeOf,
  * labelOf.
  *
+ * asset_classes is the one canonical asset-class vocabulary.
+ * assetClassMatches filters stored asset-class values (codes, labels such as
+ * "Fixed Income", or aliases such as "CASH_ASSET_CLASS") against a code,
+ * walking the tree. The *LabelOf / identifierTypePlaceholderOf helpers give
+ * display strings for every value of the enums the UI shows. See
+ * docs/adr/asset_class_vocabulary.md.
+ *
  * `indexTypeOf` is intentionally absent — that dimension is deferred per
  * the M1 descope.
  */
@@ -21,12 +28,19 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.allInstrumentTypes = exports.allAssetClasses = exports.activeProductTypes = exports.allProductTypes = exports.assetClassLabelOf = exports.isAssetClassDescendantOf = exports.assetClassDescendantsOf = exports.assetClassParentOf = exports.instrumentTypeOf = exports.assetClassOf = exports.labelOf = exports.isDescendantOf = exports.descendantsOf = exports.parentOf = void 0;
+exports.allInstrumentTypes = exports.allAssetClasses = exports.activeProductTypes = exports.allProductTypes = exports.assetClassProtoLabelOf = exports.productTypeLabelOf = exports.instrumentTypeLabelOf = exports.identifierTypePlaceholderOf = exports.identifierTypeLabelOf = exports.assetClassMatches = exports.resolveAssetClass = exports.buildAssetClassLookup = exports.assetClassLabelOf = exports.isAssetClassDescendantOf = exports.assetClassDescendantsOf = exports.assetClassParentOf = exports.instrumentTypeOf = exports.assetClassOf = exports.labelOf = exports.isDescendantOf = exports.descendantsOf = exports.parentOf = void 0;
 // hierarchy.json is bundled into the npm package via the package's `files`
 // list (see package.json). Bundlers handle this `import` at build time
 // (TypeScript's resolveJsonModule is enabled).
 const hierarchy_json_1 = __importDefault(require("../../../../hierarchy.json"));
+const asset_class_pb_1 = require("../../../fintekkers/models/security/asset_class_pb");
+const identifier_type_pb_1 = require("../../../fintekkers/models/security/identifier/identifier_type_pb");
+const instrument_type_pb_1 = require("../../../fintekkers/models/security/instrument_type_pb");
+const product_type_pb_1 = require("../../../fintekkers/models/security/product_type_pb");
 const registry = hierarchy_json_1.default;
+function hasOwn(o, key) {
+    return o !== undefined && Object.prototype.hasOwnProperty.call(o, key);
+}
 // ---------- product_type tree ----------
 /** Parent product_type node (abstract or leaf). null for top-level nodes;
  * null for unknown nodes. */
@@ -134,6 +148,117 @@ function assetClassLabelOf(node) {
     return (_b = (_a = registry.asset_classes[node]) === null || _a === void 0 ? void 0 : _a.label) !== null && _b !== void 0 ? _b : null;
 }
 exports.assetClassLabelOf = assetClassLabelOf;
+function normaliseAssetClass(value) {
+    return value.trim().toUpperCase().replace(/[\s-]+/g, '_');
+}
+/** Normalised code / label / alias -> code. Throws if two codes claim the
+ * same key, so an ambiguous label or alias fails at load time. Exported for
+ * tests only. */
+function buildAssetClassLookup(classes) {
+    var _a;
+    const lookup = new Map();
+    for (const [code, entry] of Object.entries(classes)) {
+        const keys = [code, ...(entry.label ? [entry.label] : []), ...((_a = entry.aliases) !== null && _a !== void 0 ? _a : [])];
+        for (const key of keys) {
+            const n = normaliseAssetClass(key);
+            if (!n)
+                continue;
+            const prev = lookup.get(n);
+            if (prev !== undefined && prev !== code) {
+                throw new Error(`hierarchy.json asset_classes: '${key}' resolves to both ${prev} and ${code}`);
+            }
+            lookup.set(n, code);
+        }
+    }
+    return lookup;
+}
+exports.buildAssetClassLookup = buildAssetClassLookup;
+const assetClassLookup = buildAssetClassLookup(registry.asset_classes);
+/** Resolve a stored or user-supplied asset-class value to its hierarchy.json
+ * code. An exact code wins; otherwise the value is normalised (trimmed,
+ * upper-cased, runs of whitespace or hyphens turned into `_`) and matched
+ * against every code, label and alias. null for null, blank or unknown. */
+function resolveAssetClass(value) {
+    var _a;
+    if (value === null || value === undefined)
+        return null;
+    if (hasOwn(registry.asset_classes, value))
+        return value;
+    return (_a = assetClassLookup.get(normaliseAssetClass(value))) !== null && _a !== void 0 ? _a : null;
+}
+exports.resolveAssetClass = resolveAssetClass;
+/** True iff `storedValue` falls under `filterCode`: both resolve (see
+ * resolveAssetClass) and the stored code equals the filter code or descends
+ * from it. FIXED_INCOME matches RATES, CREDIT and "Fixed Income"; EQUITY
+ * does not match RATES; unknown values match nothing. */
+function assetClassMatches(filterCode, storedValue) {
+    const f = resolveAssetClass(filterCode);
+    const s = resolveAssetClass(storedValue);
+    if (f === null || s === null)
+        return false;
+    return f === s || isAssetClassDescendantOf(s, f);
+}
+exports.assetClassMatches = assetClassMatches;
+// ---------- enum labels ----------
+/** Name of numeric enum value `v` in a generated *_pb enum object, or null. */
+function enumValueName(enumObj, v) {
+    for (const [name, n] of Object.entries(enumObj)) {
+        if (n === v)
+            return name;
+    }
+    return null;
+}
+function enumEntry(enumName, valueName) {
+    var _a;
+    if (valueName === null)
+        return null;
+    const values = (_a = registry.enum_labels) === null || _a === void 0 ? void 0 : _a[enumName];
+    return values && hasOwn(values, valueName) ? values[valueName] : null;
+}
+/** Display label for an IdentifierTypeProto value, or null if unknown. */
+function identifierTypeLabelOf(v) {
+    var _a, _b;
+    return (_b = (_a = enumEntry('IdentifierTypeProto', enumValueName(identifier_type_pb_1.IdentifierTypeProto, v))) === null || _a === void 0 ? void 0 : _a.label) !== null && _b !== void 0 ? _b : null;
+}
+exports.identifierTypeLabelOf = identifierTypeLabelOf;
+/** Input placeholder (e.g. "e.g. US0378331005") for an IdentifierTypeProto
+ * value, or null if unknown. */
+function identifierTypePlaceholderOf(v) {
+    var _a, _b;
+    return (_b = (_a = enumEntry('IdentifierTypeProto', enumValueName(identifier_type_pb_1.IdentifierTypeProto, v))) === null || _a === void 0 ? void 0 : _a.placeholder) !== null && _b !== void 0 ? _b : null;
+}
+exports.identifierTypePlaceholderOf = identifierTypePlaceholderOf;
+/** Display label for an InstrumentTypeProto value, or null if unknown. */
+function instrumentTypeLabelOf(v) {
+    var _a, _b;
+    return (_b = (_a = enumEntry('InstrumentTypeProto', enumValueName(instrument_type_pb_1.InstrumentTypeProto, v))) === null || _a === void 0 ? void 0 : _a.label) !== null && _b !== void 0 ? _b : null;
+}
+exports.instrumentTypeLabelOf = instrumentTypeLabelOf;
+/** Display label for a ProductTypeProto value: the product_types label, else
+ * enum_labels (e.g. PRODUCT_TYPE_UNKNOWN). null if unknown. */
+function productTypeLabelOf(v) {
+    var _a, _b, _c;
+    const name = enumValueName(product_type_pb_1.ProductTypeProto, v);
+    if (name === null)
+        return null;
+    const entry = hasOwn(registry.product_types, name) ? registry.product_types[name] : undefined;
+    return (_c = (_a = entry === null || entry === void 0 ? void 0 : entry.label) !== null && _a !== void 0 ? _a : (_b = enumEntry('ProductTypeProto', name)) === null || _b === void 0 ? void 0 : _b.label) !== null && _c !== void 0 ? _c : null;
+}
+exports.productTypeLabelOf = productTypeLabelOf;
+/** Display label for an AssetClassProto value: the label of the hierarchy.json
+ * code it resolves to (CASH_ASSET_CLASS -> "Cash"), else enum_labels
+ * (e.g. INDEX). null if unknown. */
+function assetClassProtoLabelOf(v) {
+    var _a, _b;
+    const name = enumValueName(asset_class_pb_1.AssetClassProto, v);
+    if (name === null)
+        return null;
+    const code = resolveAssetClass(name);
+    if (code !== null)
+        return assetClassLabelOf(code);
+    return (_b = (_a = enumEntry('AssetClassProto', name)) === null || _a === void 0 ? void 0 : _a.label) !== null && _b !== void 0 ? _b : null;
+}
+exports.assetClassProtoLabelOf = assetClassProtoLabelOf;
 // ---------- introspection ----------
 function allProductTypes() {
     return Object.keys(registry.product_types).sort();

package/node/wrappers/models/security/product_hierarchy.js.map

@@ -1 +1 @@
-{"version":3,"file":"product_hierarchy.js","sourceRoot":"","sources":["product_hierarchy.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"product_hierarchy.js","sourceRoot":"","sources":["product_hierarchy.ts"],"names":[],"mappings":"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"}

package/node/wrappers/models/security/product_hierarchy.ts

@@ -13,6 +13,13 @@
  * Plus per-leaf classification lookups: assetClassOf, instrumentTypeOf,
  * labelOf.
  *
+ * asset_classes is the one canonical asset-class vocabulary.
+ * assetClassMatches filters stored asset-class values (codes, labels such as
+ * "Fixed Income", or aliases such as "CASH_ASSET_CLASS") against a code,
+ * walking the tree. The *LabelOf / identifierTypePlaceholderOf helpers give
+ * display strings for every value of the enums the UI shows. See
+ * docs/adr/asset_class_vocabulary.md.
+ *
  * `indexTypeOf` is intentionally absent — that dimension is deferred per
  * the M1 descope.
  */
@@ -21,6 +28,10 @@
 // list (see package.json). Bundlers handle this `import` at build time
 // (TypeScript's resolveJsonModule is enabled).
 import hierarchy from '../../../../hierarchy.json';
+import { AssetClassProto } from '../../../fintekkers/models/security/asset_class_pb';
+import { IdentifierTypeProto } from '../../../fintekkers/models/security/identifier/identifier_type_pb';
+import { InstrumentTypeProto } from '../../../fintekkers/models/security/instrument_type_pb';
+import { ProductTypeProto } from '../../../fintekkers/models/security/product_type_pb';
 
 interface ProductTypeEntry {
   parent?: string | null;
@@ -34,16 +45,27 @@ interface ProductTypeEntry {
 interface AssetClassEntry {
   parent?: string | null;
   label?: string;
+  aliases?: string[];
+}
+
+interface EnumLabelEntry {
+  label?: string;
+  placeholder?: string;
 }
 
 interface Registry {
   product_types: Record<string, ProductTypeEntry>;
   asset_classes: Record<string, AssetClassEntry>;
   instrument_types: string[];
+  enum_labels?: Record<string, Record<string, EnumLabelEntry>>;
 }
 
 const registry: Registry = hierarchy as Registry;
 
+function hasOwn(o: object | undefined, key: string): boolean {
+  return o !== undefined && Object.prototype.hasOwnProperty.call(o, key);
+}
+
 // ---------- product_type tree ----------
 
 /** Parent product_type node (abstract or leaf). null for top-level nodes;
@@ -137,6 +159,112 @@ export function assetClassLabelOf(node: string): string | null {
   return registry.asset_classes[node]?.label ?? null;
 }
 
+function normaliseAssetClass(value: string): string {
+  return value.trim().toUpperCase().replace(/[\s-]+/g, '_');
+}
+
+/** Normalised code / label / alias -> code. Throws if two codes claim the
+ * same key, so an ambiguous label or alias fails at load time. Exported for
+ * tests only. */
+export function buildAssetClassLookup(
+  classes: Record<string, AssetClassEntry>,
+): Map<string, string> {
+  const lookup = new Map<string, string>();
+  for (const [code, entry] of Object.entries(classes)) {
+    const keys = [code, ...(entry.label ? [entry.label] : []), ...(entry.aliases ?? [])];
+    for (const key of keys) {
+      const n = normaliseAssetClass(key);
+      if (!n) continue;
+      const prev = lookup.get(n);
+      if (prev !== undefined && prev !== code) {
+        throw new Error(
+          `hierarchy.json asset_classes: '${key}' resolves to both ${prev} and ${code}`,
+        );
+      }
+      lookup.set(n, code);
+    }
+  }
+  return lookup;
+}
+
+const assetClassLookup = buildAssetClassLookup(registry.asset_classes);
+
+/** Resolve a stored or user-supplied asset-class value to its hierarchy.json
+ * code. An exact code wins; otherwise the value is normalised (trimmed,
+ * upper-cased, runs of whitespace or hyphens turned into `_`) and matched
+ * against every code, label and alias. null for null, blank or unknown. */
+export function resolveAssetClass(value: string | null | undefined): string | null {
+  if (value === null || value === undefined) return null;
+  if (hasOwn(registry.asset_classes, value)) return value;
+  return assetClassLookup.get(normaliseAssetClass(value)) ?? null;
+}
+
+/** True iff `storedValue` falls under `filterCode`: both resolve (see
+ * resolveAssetClass) and the stored code equals the filter code or descends
+ * from it. FIXED_INCOME matches RATES, CREDIT and "Fixed Income"; EQUITY
+ * does not match RATES; unknown values match nothing. */
+export function assetClassMatches(
+  filterCode: string | null | undefined,
+  storedValue: string | null | undefined,
+): boolean {
+  const f = resolveAssetClass(filterCode);
+  const s = resolveAssetClass(storedValue);
+  if (f === null || s === null) return false;
+  return f === s || isAssetClassDescendantOf(s, f);
+}
+
+// ---------- enum labels ----------
+
+/** Name of numeric enum value `v` in a generated *_pb enum object, or null. */
+function enumValueName(enumObj: object, v: number): string | null {
+  for (const [name, n] of Object.entries(enumObj)) {
+    if (n === v) return name;
+  }
+  return null;
+}
+
+function enumEntry(enumName: string, valueName: string | null): EnumLabelEntry | null {
+  if (valueName === null) return null;
+  const values = registry.enum_labels?.[enumName];
+  return values && hasOwn(values, valueName) ? values[valueName] : null;
+}
+
+/** Display label for an IdentifierTypeProto value, or null if unknown. */
+export function identifierTypeLabelOf(v: IdentifierTypeProto): string | null {
+  return enumEntry('IdentifierTypeProto', enumValueName(IdentifierTypeProto, v))?.label ?? null;
+}
+
+/** Input placeholder (e.g. "e.g. US0378331005") for an IdentifierTypeProto
+ * value, or null if unknown. */
+export function identifierTypePlaceholderOf(v: IdentifierTypeProto): string | null {
+  return enumEntry('IdentifierTypeProto', enumValueName(IdentifierTypeProto, v))?.placeholder ?? null;
+}
+
+/** Display label for an InstrumentTypeProto value, or null if unknown. */
+export function instrumentTypeLabelOf(v: InstrumentTypeProto): string | null {
+  return enumEntry('InstrumentTypeProto', enumValueName(InstrumentTypeProto, v))?.label ?? null;
+}
+
+/** Display label for a ProductTypeProto value: the product_types label, else
+ * enum_labels (e.g. PRODUCT_TYPE_UNKNOWN). null if unknown. */
+export function productTypeLabelOf(v: ProductTypeProto): string | null {
+  const name = enumValueName(ProductTypeProto, v);
+  if (name === null) return null;
+  const entry = hasOwn(registry.product_types, name) ? registry.product_types[name] : undefined;
+  return entry?.label ?? enumEntry('ProductTypeProto', name)?.label ?? null;
+}
+
+/** Display label for an AssetClassProto value: the label of the hierarchy.json
+ * code it resolves to (CASH_ASSET_CLASS -> "Cash"), else enum_labels
+ * (e.g. INDEX). null if unknown. */
+export function assetClassProtoLabelOf(v: AssetClassProto): string | null {
+  const name = enumValueName(AssetClassProto, v);
+  if (name === null) return null;
+  const code = resolveAssetClass(name);
+  if (code !== null) return assetClassLabelOf(code);
+  return enumEntry('AssetClassProto', name)?.label ?? null;
+}
+
 // ---------- introspection ----------
 
 export function allProductTypes(): string[] {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fintekkers/ledger-models",
   "todo": "Replace the version with build script version number",
-  "version": "0.4.24",
+  "version": "0.4.25",
   "description": "ledger model protos ",
   "authors": [
     "David Doherty",