@fintekkers/ledger-models 0.1.133 → 0.1.134

package/node/fintekkers/models/security/asset_class_grpc_pb.js

@@ -0,0 +1 @@
+// GENERATED CODE -- NO SERVICES IN PROTO

package/node/fintekkers/models/security/asset_class_pb.d.ts

@@ -0,0 +1,15 @@
+// package: fintekkers.models.security
+// file: fintekkers/models/security/asset_class.proto
+
+/* tslint:disable */
+/* eslint-disable */
+
+import * as jspb from "google-protobuf";
+
+export enum AssetClassProto {
+    UNKNOWN_ASSET_CLASS = 0,
+    FIXED_INCOME = 1,
+    EQUITY = 2,
+    CASH_ASSET_CLASS = 3,
+    INDEX = 4,
+}

package/node/fintekkers/models/security/asset_class_pb.js

@@ -0,0 +1,36 @@
+// source: fintekkers/models/security/asset_class.proto
+/**
+ * @fileoverview
+ * @enhanceable
+ * @suppress {missingRequire} reports error on implicit type usages.
+ * @suppress {messageConventions} JS Compiler reports an error if a variable or
+ *     field starts with 'MSG_' and isn't a translatable message.
+ * @public
+ */
+// GENERATED CODE -- DO NOT EDIT!
+/* eslint-disable */
+// @ts-nocheck
+
+var jspb = require('google-protobuf');
+var goog = jspb;
+var global = (function() {
+  if (this) { return this; }
+  if (typeof window !== 'undefined') { return window; }
+  if (typeof global !== 'undefined') { return global; }
+  if (typeof self !== 'undefined') { return self; }
+  return Function('return this')();
+}.call(null));
+
+goog.exportSymbol('proto.fintekkers.models.security.AssetClassProto', null, global);
+/**
+ * @enum {number}
+ */
+proto.fintekkers.models.security.AssetClassProto = {
+  UNKNOWN_ASSET_CLASS: 0,
+  FIXED_INCOME: 1,
+  EQUITY: 2,
+  CASH_ASSET_CLASS: 3,
+  INDEX: 4
+};
+
+goog.object.extend(exports, proto.fintekkers.models.security);

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

@@ -0,0 +1,37 @@
+import { AssetClassProto } from '../../../fintekkers/models/security/asset_class_pb';
+/**
+ * Static helpers around the AssetClass proto enum, mirroring the
+ * Identifier wrapper pattern shipped in v0.1.133 (PR #188) and the
+ * SecurityType wrapper alongside this file.
+ *
+ * Note: SecurityProto.asset_class is currently a `string` field
+ * (security.proto field 11). This enum defines the canonical vocabulary;
+ * the field type stays string in this release to avoid coordinating a
+ * breaking change with downstream services. A follow-up will flip the
+ * field type after a data-normalization audit.
+ *
+ * Until then: producers SHOULD use `AssetClass.getAllTypeNames()` as
+ * the source of truth for the legal string values; consumers SHOULD
+ * use `AssetClass.fromName(name)` to validate a string against the
+ * canonical vocabulary.
+ */
+export declare class AssetClass {
+    /**
+     * Returns the names of all known AssetClassProto values, EXCLUDING
+     * the sentinel `UNKNOWN_ASSET_CLASS`. Drives UI dropdowns / pickers
+     * so adding a new proto enum variant auto-propagates to consumers.
+     *
+     * Order matches proto declaration order.
+     */
+    static getAllTypeNames(): string[];
+    /**
+     * Resolve a proto enum NAME (e.g., "FIXED_INCOME", "EQUITY") to its
+     * numeric AssetClassProto value. Throws on unknown name; the error
+     * lists the valid names so typos are fixable without grepping the
+     * proto.
+     *
+     * @param name proto enum key (e.g., "FIXED_INCOME")
+     * @returns the numeric AssetClassProto value
+     */
+    static fromName(name: string): AssetClassProto;
+}

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

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssetClass = void 0;
+const asset_class_pb_1 = require("../../../fintekkers/models/security/asset_class_pb");
+/**
+ * Static helpers around the AssetClass proto enum, mirroring the
+ * Identifier wrapper pattern shipped in v0.1.133 (PR #188) and the
+ * SecurityType wrapper alongside this file.
+ *
+ * Note: SecurityProto.asset_class is currently a `string` field
+ * (security.proto field 11). This enum defines the canonical vocabulary;
+ * the field type stays string in this release to avoid coordinating a
+ * breaking change with downstream services. A follow-up will flip the
+ * field type after a data-normalization audit.
+ *
+ * Until then: producers SHOULD use `AssetClass.getAllTypeNames()` as
+ * the source of truth for the legal string values; consumers SHOULD
+ * use `AssetClass.fromName(name)` to validate a string against the
+ * canonical vocabulary.
+ */
+class AssetClass {
+    /**
+     * Returns the names of all known AssetClassProto values, EXCLUDING
+     * the sentinel `UNKNOWN_ASSET_CLASS`. Drives UI dropdowns / pickers
+     * so adding a new proto enum variant auto-propagates to consumers.
+     *
+     * Order matches proto declaration order.
+     */
+    static getAllTypeNames() {
+        return Object.keys(asset_class_pb_1.AssetClassProto).filter(k => k !== 'UNKNOWN_ASSET_CLASS');
+    }
+    /**
+     * Resolve a proto enum NAME (e.g., "FIXED_INCOME", "EQUITY") to its
+     * numeric AssetClassProto value. Throws on unknown name; the error
+     * lists the valid names so typos are fixable without grepping the
+     * proto.
+     *
+     * @param name proto enum key (e.g., "FIXED_INCOME")
+     * @returns the numeric AssetClassProto value
+     */
+    static fromName(name) {
+        const enumObj = asset_class_pb_1.AssetClassProto;
+        const enumValue = enumObj[name];
+        if (enumValue === undefined) {
+            throw new Error(`Unknown AssetClass name: '${name}'. Valid names: ${AssetClass.getAllTypeNames().join(', ')}`);
+        }
+        return enumValue;
+    }
+}
+exports.AssetClass = AssetClass;
+//# sourceMappingURL=asset_class.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"asset_class.js","sourceRoot":"","sources":["asset_class.ts"],"names":[],"mappings":";;;AAAA,uFAAqF;AAErF;;;;;;;;;;;;;;;GAeG;AACH,MAAa,UAAU;IAEnB;;;;;;OAMG;IACH,MAAM,CAAC,eAAe;QAClB,OAAO,MAAM,CAAC,IAAI,CAAC,gCAAe,CAAC,CAAC,MAAM,CACtC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,qBAAqB,CACnC,CAAC;IACN,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAY;QACxB,MAAM,OAAO,GAAG,gCAAoD,CAAC;QACrE,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,SAAS,KAAK,SAAS,EAAE;YACzB,MAAM,IAAI,KAAK,CACX,6BAA6B,IAAI,mBAAmB,UAAU,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChG,CAAC;SACL;QACD,OAAO,SAA4B,CAAC;IACxC,CAAC;CACJ;AAlCD,gCAkCC"}

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

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

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

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const asset_class_1 = require("./asset_class");
+const asset_class_pb_1 = require("../../../fintekkers/models/security/asset_class_pb");
+describe('AssetClass.fromName', () => {
+    test.each(asset_class_1.AssetClass.getAllTypeNames())('fromName("%s") returns the matching numeric enum value', (name) => {
+        const value = asset_class_1.AssetClass.fromName(name);
+        const expected = asset_class_pb_1.AssetClassProto[name];
+        expect(value).toBe(expected);
+    });
+    test('throws on unknown name and lists valid names in the error', () => {
+        let err;
+        try {
+            asset_class_1.AssetClass.fromName('COMMODITY');
+        }
+        catch (e) {
+            err = e;
+        }
+        expect(err).toBeDefined();
+        expect(err.message).toContain('COMMODITY');
+        // Hint with valid entries
+        expect(err.message).toContain('FIXED_INCOME');
+        expect(err.message).toContain('EQUITY');
+    });
+    test('accepts UNKNOWN_ASSET_CLASS — sentinel is a valid enum key', () => {
+        // Same pin as SecurityType / Identifier: excluded from getAllTypeNames
+        // (no dropdown surface), but valid via fromName.
+        expect(asset_class_1.AssetClass.fromName('UNKNOWN_ASSET_CLASS')).toBe(asset_class_pb_1.AssetClassProto.UNKNOWN_ASSET_CLASS);
+    });
+});
+describe('AssetClass.getAllTypeNames', () => {
+    test('returns the expected set in proto-declaration order, excluding UNKNOWN', () => {
+        // Proto-declared order in asset_class.proto:
+        //   UNKNOWN_ASSET_CLASS = 0;     (excluded)
+        //   FIXED_INCOME = 1;
+        //   EQUITY = 2;
+        //   CASH_ASSET_CLASS = 3;        (suffixed to avoid name collision
+        //                                 with IdentifierTypeProto.CASH per
+        //                                 proto3 package-wide uniqueness)
+        //   INDEX = 4;
+        expect(asset_class_1.AssetClass.getAllTypeNames()).toEqual([
+            'FIXED_INCOME',
+            'EQUITY',
+            'CASH_ASSET_CLASS',
+            'INDEX',
+        ]);
+    });
+    test('excludes the UNKNOWN_ASSET_CLASS sentinel', () => {
+        expect(asset_class_1.AssetClass.getAllTypeNames()).not.toContain('UNKNOWN_ASSET_CLASS');
+    });
+});
+//# sourceMappingURL=asset_class.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"asset_class.test.js","sourceRoot":"","sources":["asset_class.test.ts"],"names":[],"mappings":";;AAAA,+CAA2C;AAC3C,uFAAqF;AAErF,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACjC,IAAI,CAAC,IAAI,CAAC,wBAAU,CAAC,eAAe,EAAE,CAAC,CACnC,wDAAwD,EACxD,CAAC,IAAY,EAAE,EAAE;QACb,MAAM,KAAK,GAAG,wBAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAI,gCAAqD,CAAC,IAAI,CAAC,CAAC;QAC9E,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC,CACJ,CAAC;IAEF,IAAI,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,IAAI,GAAsB,CAAC;QAC3B,IAAI;YACA,wBAAU,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;SACpC;QAAC,OAAO,CAAC,EAAE;YACR,GAAG,GAAG,CAAU,CAAC;SACpB;QACD,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAI,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC5C,0BAA0B;QAC1B,MAAM,CAAC,GAAI,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAC/C,MAAM,CAAC,GAAI,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,uEAAuE;QACvE,iDAAiD;QACjD,MAAM,CAAC,wBAAU,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CACnD,gCAAe,CAAC,mBAAmB,CACtC,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IACxC,IAAI,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,6CAA6C;QAC7C,4CAA4C;QAC5C,sBAAsB;QACtB,gBAAgB;QAChB,mEAAmE;QACnE,oEAAoE;QACpE,kEAAkE;QAClE,eAAe;QACf,MAAM,CAAC,wBAAU,CAAC,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC;YACzC,cAAc;YACd,QAAQ;YACR,kBAAkB;YAClB,OAAO;SACV,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,wBAAU,CAAC,eAAe,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,58 @@
+import { AssetClass } from './asset_class';
+import { AssetClassProto } from '../../../fintekkers/models/security/asset_class_pb';
+
+describe('AssetClass.fromName', () => {
+    test.each(AssetClass.getAllTypeNames())(
+        'fromName("%s") returns the matching numeric enum value',
+        (name: string) => {
+            const value = AssetClass.fromName(name);
+            const expected = (AssetClassProto as unknown as Record<string, number>)[name];
+            expect(value).toBe(expected);
+        }
+    );
+
+    test('throws on unknown name and lists valid names in the error', () => {
+        let err: Error | undefined;
+        try {
+            AssetClass.fromName('COMMODITY');
+        } catch (e) {
+            err = e as Error;
+        }
+        expect(err).toBeDefined();
+        expect(err!.message).toContain('COMMODITY');
+        // Hint with valid entries
+        expect(err!.message).toContain('FIXED_INCOME');
+        expect(err!.message).toContain('EQUITY');
+    });
+
+    test('accepts UNKNOWN_ASSET_CLASS — sentinel is a valid enum key', () => {
+        // Same pin as SecurityType / Identifier: excluded from getAllTypeNames
+        // (no dropdown surface), but valid via fromName.
+        expect(AssetClass.fromName('UNKNOWN_ASSET_CLASS')).toBe(
+            AssetClassProto.UNKNOWN_ASSET_CLASS
+        );
+    });
+});
+
+describe('AssetClass.getAllTypeNames', () => {
+    test('returns the expected set in proto-declaration order, excluding UNKNOWN', () => {
+        // Proto-declared order in asset_class.proto:
+        //   UNKNOWN_ASSET_CLASS = 0;     (excluded)
+        //   FIXED_INCOME = 1;
+        //   EQUITY = 2;
+        //   CASH_ASSET_CLASS = 3;        (suffixed to avoid name collision
+        //                                 with IdentifierTypeProto.CASH per
+        //                                 proto3 package-wide uniqueness)
+        //   INDEX = 4;
+        expect(AssetClass.getAllTypeNames()).toEqual([
+            'FIXED_INCOME',
+            'EQUITY',
+            'CASH_ASSET_CLASS',
+            'INDEX',
+        ]);
+    });
+
+    test('excludes the UNKNOWN_ASSET_CLASS sentinel', () => {
+        expect(AssetClass.getAllTypeNames()).not.toContain('UNKNOWN_ASSET_CLASS');
+    });
+});

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

@@ -0,0 +1,53 @@
+import { AssetClassProto } from '../../../fintekkers/models/security/asset_class_pb';
+
+/**
+ * Static helpers around the AssetClass proto enum, mirroring the
+ * Identifier wrapper pattern shipped in v0.1.133 (PR #188) and the
+ * SecurityType wrapper alongside this file.
+ *
+ * Note: SecurityProto.asset_class is currently a `string` field
+ * (security.proto field 11). This enum defines the canonical vocabulary;
+ * the field type stays string in this release to avoid coordinating a
+ * breaking change with downstream services. A follow-up will flip the
+ * field type after a data-normalization audit.
+ *
+ * Until then: producers SHOULD use `AssetClass.getAllTypeNames()` as
+ * the source of truth for the legal string values; consumers SHOULD
+ * use `AssetClass.fromName(name)` to validate a string against the
+ * canonical vocabulary.
+ */
+export class AssetClass {
+
+    /**
+     * Returns the names of all known AssetClassProto values, EXCLUDING
+     * the sentinel `UNKNOWN_ASSET_CLASS`. Drives UI dropdowns / pickers
+     * so adding a new proto enum variant auto-propagates to consumers.
+     *
+     * Order matches proto declaration order.
+     */
+    static getAllTypeNames(): string[] {
+        return Object.keys(AssetClassProto).filter(
+            k => k !== 'UNKNOWN_ASSET_CLASS'
+        );
+    }
+
+    /**
+     * Resolve a proto enum NAME (e.g., "FIXED_INCOME", "EQUITY") to its
+     * numeric AssetClassProto value. Throws on unknown name; the error
+     * lists the valid names so typos are fixable without grepping the
+     * proto.
+     *
+     * @param name proto enum key (e.g., "FIXED_INCOME")
+     * @returns the numeric AssetClassProto value
+     */
+    static fromName(name: string): AssetClassProto {
+        const enumObj = AssetClassProto as unknown as Record<string, number>;
+        const enumValue = enumObj[name];
+        if (enumValue === undefined) {
+            throw new Error(
+                `Unknown AssetClass name: '${name}'. Valid names: ${AssetClass.getAllTypeNames().join(', ')}`
+            );
+        }
+        return enumValue as AssetClassProto;
+    }
+}

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

@@ -0,0 +1,31 @@
+import { SecurityTypeProto } from '../../../fintekkers/models/security/security_type_pb';
+/**
+ * Static helpers around the SecurityType proto enum, mirroring the
+ * Identifier wrapper pattern shipped in v0.1.133 (PR #188).
+ *
+ * Lets TS/JS consumers stop hand-typing literal unions and switch
+ * statements over `'BOND_SECURITY' | 'TIPS' | 'FRN' | ...` — adding a
+ * new variant on the proto side propagates automatically.
+ */
+export declare class SecurityType {
+    /**
+     * Returns the names of all known SecurityTypeProto values, EXCLUDING
+     * the sentinel `UNKNOWN_SECURITY_TYPE`. Drives UI dropdowns / pickers
+     * so a new proto enum variant auto-propagates to consumers without
+     * any UI-side code change.
+     *
+     * Order matches proto declaration order (Object.keys preserves
+     * insertion order on the generated JS enum object).
+     */
+    static getAllTypeNames(): string[];
+    /**
+     * Resolve a proto enum NAME (e.g., "BOND_SECURITY", "EQUITY_SECURITY")
+     * to its numeric SecurityTypeProto value. Throws on unknown name; the
+     * error lists the valid names so typos are fixable without grepping
+     * the proto.
+     *
+     * @param name proto enum key (e.g., "BOND_SECURITY")
+     * @returns the numeric SecurityTypeProto value
+     */
+    static fromName(name: string): SecurityTypeProto;
+}

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

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SecurityType = void 0;
+const security_type_pb_1 = require("../../../fintekkers/models/security/security_type_pb");
+/**
+ * Static helpers around the SecurityType proto enum, mirroring the
+ * Identifier wrapper pattern shipped in v0.1.133 (PR #188).
+ *
+ * Lets TS/JS consumers stop hand-typing literal unions and switch
+ * statements over `'BOND_SECURITY' | 'TIPS' | 'FRN' | ...` — adding a
+ * new variant on the proto side propagates automatically.
+ */
+class SecurityType {
+    /**
+     * Returns the names of all known SecurityTypeProto values, EXCLUDING
+     * the sentinel `UNKNOWN_SECURITY_TYPE`. Drives UI dropdowns / pickers
+     * so a new proto enum variant auto-propagates to consumers without
+     * any UI-side code change.
+     *
+     * Order matches proto declaration order (Object.keys preserves
+     * insertion order on the generated JS enum object).
+     */
+    static getAllTypeNames() {
+        return Object.keys(security_type_pb_1.SecurityTypeProto).filter(k => k !== 'UNKNOWN_SECURITY_TYPE');
+    }
+    /**
+     * Resolve a proto enum NAME (e.g., "BOND_SECURITY", "EQUITY_SECURITY")
+     * to its numeric SecurityTypeProto value. Throws on unknown name; the
+     * error lists the valid names so typos are fixable without grepping
+     * the proto.
+     *
+     * @param name proto enum key (e.g., "BOND_SECURITY")
+     * @returns the numeric SecurityTypeProto value
+     */
+    static fromName(name) {
+        const enumObj = security_type_pb_1.SecurityTypeProto;
+        const enumValue = enumObj[name];
+        if (enumValue === undefined) {
+            throw new Error(`Unknown SecurityType name: '${name}'. Valid names: ${SecurityType.getAllTypeNames().join(', ')}`);
+        }
+        return enumValue;
+    }
+}
+exports.SecurityType = SecurityType;
+//# sourceMappingURL=security_type.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"security_type.js","sourceRoot":"","sources":["security_type.ts"],"names":[],"mappings":";;;AAAA,2FAAyF;AAEzF;;;;;;;GAOG;AACH,MAAa,YAAY;IAErB;;;;;;;;OAQG;IACH,MAAM,CAAC,eAAe;QAClB,OAAO,MAAM,CAAC,IAAI,CAAC,oCAAiB,CAAC,CAAC,MAAM,CACxC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,uBAAuB,CACrC,CAAC;IACN,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAY;QACxB,MAAM,OAAO,GAAG,oCAAsD,CAAC;QACvE,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,SAAS,KAAK,SAAS,EAAE;YACzB,MAAM,IAAI,KAAK,CACX,+BAA+B,IAAI,mBAAmB,YAAY,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACpG,CAAC;SACL;QACD,OAAO,SAA8B,CAAC;IAC1C,CAAC;CACJ;AApCD,oCAoCC"}

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

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

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

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const security_type_1 = require("./security_type");
+const security_type_pb_1 = require("../../../fintekkers/models/security/security_type_pb");
+describe('SecurityType.fromName', () => {
+    // Round-trip: every name returned by getAllTypeNames must resolve to
+    // a numeric enum value that maps back to the same name.
+    test.each(security_type_1.SecurityType.getAllTypeNames())('fromName("%s") returns the matching numeric enum value', (name) => {
+        const value = security_type_1.SecurityType.fromName(name);
+        // The proto-generated enum is bidirectionally indexable
+        // (Object.keys / numeric-key lookups both work in google-protobuf JS).
+        const expected = security_type_pb_1.SecurityTypeProto[name];
+        expect(value).toBe(expected);
+    });
+    test('throws on unknown name and lists valid names in the error', () => {
+        let err;
+        try {
+            security_type_1.SecurityType.fromName('NOT_A_REAL_TYPE');
+        }
+        catch (e) {
+            err = e;
+        }
+        expect(err).toBeDefined();
+        expect(err.message).toContain('NOT_A_REAL_TYPE');
+        // Error message should hint with known valid entries.
+        expect(err.message).toContain('BOND_SECURITY');
+        expect(err.message).toContain('EQUITY_SECURITY');
+    });
+    test('accepts UNKNOWN_SECURITY_TYPE — sentinel is a valid enum key', () => {
+        // It's excluded from getAllTypeNames (so it doesn't appear in
+        // dropdowns), but it IS a valid proto enum value, so fromName
+        // accepts it. Pinning the existing behavior — flip if policy
+        // ever tightens.
+        expect(security_type_1.SecurityType.fromName('UNKNOWN_SECURITY_TYPE')).toBe(security_type_pb_1.SecurityTypeProto.UNKNOWN_SECURITY_TYPE);
+    });
+});
+describe('SecurityType.getAllTypeNames', () => {
+    test('returns the expected set in proto-declaration order, excluding UNKNOWN', () => {
+        // Proto-declared order in security_type.proto:
+        //   UNKNOWN_SECURITY_TYPE = 0;  (excluded)
+        //   CASH_SECURITY = 1;
+        //   EQUITY_SECURITY = 2;
+        //   BOND_SECURITY = 3;
+        //   TIPS = 4;
+        //   FRN = 5;
+        //   INDEX_SECURITY = 6;
+        //   FX_SPOT = 7;
+        //   EQUITY_INDEX_SECURITY = 8;
+        expect(security_type_1.SecurityType.getAllTypeNames()).toEqual([
+            'CASH_SECURITY',
+            'EQUITY_SECURITY',
+            'BOND_SECURITY',
+            'TIPS',
+            'FRN',
+            'INDEX_SECURITY',
+            'FX_SPOT',
+            'EQUITY_INDEX_SECURITY',
+        ]);
+    });
+    test('excludes the UNKNOWN_SECURITY_TYPE sentinel', () => {
+        expect(security_type_1.SecurityType.getAllTypeNames()).not.toContain('UNKNOWN_SECURITY_TYPE');
+    });
+});
+//# sourceMappingURL=security_type.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"security_type.test.js","sourceRoot":"","sources":["security_type.test.ts"],"names":[],"mappings":";;AAAA,mDAA+C;AAC/C,2FAAyF;AAEzF,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACnC,qEAAqE;IACrE,wDAAwD;IACxD,IAAI,CAAC,IAAI,CAAC,4BAAY,CAAC,eAAe,EAAE,CAAC,CACrC,wDAAwD,EACxD,CAAC,IAAY,EAAE,EAAE;QACb,MAAM,KAAK,GAAG,4BAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1C,wDAAwD;QACxD,uEAAuE;QACvE,MAAM,QAAQ,GAAI,oCAAuD,CAAC,IAAI,CAAC,CAAC;QAChF,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC,CACJ,CAAC;IAEF,IAAI,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,IAAI,GAAsB,CAAC;QAC3B,IAAI;YACA,4BAAY,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;SAC5C;QAAC,OAAO,CAAC,EAAE;YACR,GAAG,GAAG,CAAU,CAAC;SACpB;QACD,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAI,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAClD,sDAAsD;QACtD,MAAM,CAAC,GAAI,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAChD,MAAM,CAAC,GAAI,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,8DAA8D;QAC9D,8DAA8D;QAC9D,6DAA6D;QAC7D,iBAAiB;QACjB,MAAM,CAAC,4BAAY,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAAC,IAAI,CACvD,oCAAiB,CAAC,qBAAqB,CAC1C,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC1C,IAAI,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,+CAA+C;QAC/C,2CAA2C;QAC3C,uBAAuB;QACvB,yBAAyB;QACzB,uBAAuB;QACvB,cAAc;QACd,aAAa;QACb,wBAAwB;QACxB,iBAAiB;QACjB,+BAA+B;QAC/B,MAAM,CAAC,4BAAY,CAAC,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC;YAC3C,eAAe;YACf,iBAAiB;YACjB,eAAe;YACf,MAAM;YACN,KAAK;YACL,gBAAgB;YAChB,SAAS;YACT,uBAAuB;SAC1B,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,4BAAY,CAAC,eAAe,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,70 @@
+import { SecurityType } from './security_type';
+import { SecurityTypeProto } from '../../../fintekkers/models/security/security_type_pb';
+
+describe('SecurityType.fromName', () => {
+    // Round-trip: every name returned by getAllTypeNames must resolve to
+    // a numeric enum value that maps back to the same name.
+    test.each(SecurityType.getAllTypeNames())(
+        'fromName("%s") returns the matching numeric enum value',
+        (name: string) => {
+            const value = SecurityType.fromName(name);
+            // The proto-generated enum is bidirectionally indexable
+            // (Object.keys / numeric-key lookups both work in google-protobuf JS).
+            const expected = (SecurityTypeProto as unknown as Record<string, number>)[name];
+            expect(value).toBe(expected);
+        }
+    );
+
+    test('throws on unknown name and lists valid names in the error', () => {
+        let err: Error | undefined;
+        try {
+            SecurityType.fromName('NOT_A_REAL_TYPE');
+        } catch (e) {
+            err = e as Error;
+        }
+        expect(err).toBeDefined();
+        expect(err!.message).toContain('NOT_A_REAL_TYPE');
+        // Error message should hint with known valid entries.
+        expect(err!.message).toContain('BOND_SECURITY');
+        expect(err!.message).toContain('EQUITY_SECURITY');
+    });
+
+    test('accepts UNKNOWN_SECURITY_TYPE — sentinel is a valid enum key', () => {
+        // It's excluded from getAllTypeNames (so it doesn't appear in
+        // dropdowns), but it IS a valid proto enum value, so fromName
+        // accepts it. Pinning the existing behavior — flip if policy
+        // ever tightens.
+        expect(SecurityType.fromName('UNKNOWN_SECURITY_TYPE')).toBe(
+            SecurityTypeProto.UNKNOWN_SECURITY_TYPE
+        );
+    });
+});
+
+describe('SecurityType.getAllTypeNames', () => {
+    test('returns the expected set in proto-declaration order, excluding UNKNOWN', () => {
+        // Proto-declared order in security_type.proto:
+        //   UNKNOWN_SECURITY_TYPE = 0;  (excluded)
+        //   CASH_SECURITY = 1;
+        //   EQUITY_SECURITY = 2;
+        //   BOND_SECURITY = 3;
+        //   TIPS = 4;
+        //   FRN = 5;
+        //   INDEX_SECURITY = 6;
+        //   FX_SPOT = 7;
+        //   EQUITY_INDEX_SECURITY = 8;
+        expect(SecurityType.getAllTypeNames()).toEqual([
+            'CASH_SECURITY',
+            'EQUITY_SECURITY',
+            'BOND_SECURITY',
+            'TIPS',
+            'FRN',
+            'INDEX_SECURITY',
+            'FX_SPOT',
+            'EQUITY_INDEX_SECURITY',
+        ]);
+    });
+
+    test('excludes the UNKNOWN_SECURITY_TYPE sentinel', () => {
+        expect(SecurityType.getAllTypeNames()).not.toContain('UNKNOWN_SECURITY_TYPE');
+    });
+});

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

@@ -0,0 +1,47 @@
+import { SecurityTypeProto } from '../../../fintekkers/models/security/security_type_pb';
+
+/**
+ * Static helpers around the SecurityType proto enum, mirroring the
+ * Identifier wrapper pattern shipped in v0.1.133 (PR #188).
+ *
+ * Lets TS/JS consumers stop hand-typing literal unions and switch
+ * statements over `'BOND_SECURITY' | 'TIPS' | 'FRN' | ...` — adding a
+ * new variant on the proto side propagates automatically.
+ */
+export class SecurityType {
+
+    /**
+     * Returns the names of all known SecurityTypeProto values, EXCLUDING
+     * the sentinel `UNKNOWN_SECURITY_TYPE`. Drives UI dropdowns / pickers
+     * so a new proto enum variant auto-propagates to consumers without
+     * any UI-side code change.
+     *
+     * Order matches proto declaration order (Object.keys preserves
+     * insertion order on the generated JS enum object).
+     */
+    static getAllTypeNames(): string[] {
+        return Object.keys(SecurityTypeProto).filter(
+            k => k !== 'UNKNOWN_SECURITY_TYPE'
+        );
+    }
+
+    /**
+     * Resolve a proto enum NAME (e.g., "BOND_SECURITY", "EQUITY_SECURITY")
+     * to its numeric SecurityTypeProto value. Throws on unknown name; the
+     * error lists the valid names so typos are fixable without grepping
+     * the proto.
+     *
+     * @param name proto enum key (e.g., "BOND_SECURITY")
+     * @returns the numeric SecurityTypeProto value
+     */
+    static fromName(name: string): SecurityTypeProto {
+        const enumObj = SecurityTypeProto as unknown as Record<string, number>;
+        const enumValue = enumObj[name];
+        if (enumValue === undefined) {
+            throw new Error(
+                `Unknown SecurityType name: '${name}'. Valid names: ${SecurityType.getAllTypeNames().join(', ')}`
+            );
+        }
+        return enumValue as SecurityTypeProto;
+    }
+}

package/package.json

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