@fintekkers/ledger-models 0.1.134 → 0.1.136

package/node/wrappers/models/position/position_filter_operator.d.ts

@@ -0,0 +1,28 @@
+import { PositionFilterOperator as PositionFilterOperatorEnum } from '../../../fintekkers/models/position/position_util_pb';
+/**
+ * Static helpers around the PositionFilterOperator proto enum, mirroring
+ * the Identifier / SecurityType / AssetClass wrapper pattern shipped in
+ * v0.1.133–v0.1.134 (PRs #188, #189).
+ *
+ * Strict: takes / returns proto enum NAMES ("MORE_THAN", "LESS_THAN_OR_EQUALS",
+ * ...). Consumers (including UI URL conventions) should standardize on
+ * proto names — ledger-models is the source-of-truth vocabulary and
+ * should not absorb consumer-side naming conventions. See
+ * FinTekkers/second-brain#229 for the ui-service migration path.
+ */
+export declare class PositionFilterOperator {
+    /**
+     * Returns the names of all known PositionFilterOperator values, EXCLUDING
+     * the sentinel `UNKNOWN_OPERATOR`. 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., "MORE_THAN", "EQUALS") to its numeric
+     * PositionFilterOperator value. Throws on unknown name; the error lists
+     * the valid names so typos are fixable without grepping the proto.
+     */
+    static fromName(name: string): PositionFilterOperatorEnum;
+}

package/node/wrappers/models/position/position_filter_operator.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PositionFilterOperator = void 0;
+// The proto module exports the enum as `PositionFilterOperator` (no `Proto`
+// suffix, unlike SecurityTypeProto / AssetClassProto / IdentifierTypeProto).
+// Renamed on import to free the natural class name for the wrapper. Consumers
+// who want the enum type for their own annotations can import directly from
+// the proto module:
+//
+//   import { PositionFilterOperator } from '@fintekkers/.../position_util_pb';
+//
+// vs. importing the wrapper helpers from this file:
+//
+//   import { PositionFilterOperator } from '@fintekkers/.../position_filter_operator';
+const position_util_pb_1 = require("../../../fintekkers/models/position/position_util_pb");
+/**
+ * Static helpers around the PositionFilterOperator proto enum, mirroring
+ * the Identifier / SecurityType / AssetClass wrapper pattern shipped in
+ * v0.1.133–v0.1.134 (PRs #188, #189).
+ *
+ * Strict: takes / returns proto enum NAMES ("MORE_THAN", "LESS_THAN_OR_EQUALS",
+ * ...). Consumers (including UI URL conventions) should standardize on
+ * proto names — ledger-models is the source-of-truth vocabulary and
+ * should not absorb consumer-side naming conventions. See
+ * FinTekkers/second-brain#229 for the ui-service migration path.
+ */
+class PositionFilterOperator {
+    /**
+     * Returns the names of all known PositionFilterOperator values, EXCLUDING
+     * the sentinel `UNKNOWN_OPERATOR`. 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(position_util_pb_1.PositionFilterOperator).filter(k => k !== 'UNKNOWN_OPERATOR');
+    }
+    /**
+     * Resolve a proto enum NAME (e.g., "MORE_THAN", "EQUALS") to its numeric
+     * PositionFilterOperator value. Throws on unknown name; the error lists
+     * the valid names so typos are fixable without grepping the proto.
+     */
+    static fromName(name) {
+        const enumObj = position_util_pb_1.PositionFilterOperator;
+        const enumValue = enumObj[name];
+        if (enumValue === undefined) {
+            throw new Error(`Unknown PositionFilterOperator name: '${name}'. Valid names: ${PositionFilterOperator.getAllTypeNames().join(', ')}`);
+        }
+        return enumValue;
+    }
+}
+exports.PositionFilterOperator = PositionFilterOperator;
+//# sourceMappingURL=position_filter_operator.js.map

package/node/wrappers/models/position/position_filter_operator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"position_filter_operator.js","sourceRoot":"","sources":["position_filter_operator.ts"],"names":[],"mappings":";;;AAAA,4EAA4E;AAC5E,6EAA6E;AAC7E,8EAA8E;AAC9E,4EAA4E;AAC5E,oBAAoB;AACpB,EAAE;AACF,+EAA+E;AAC/E,EAAE;AACF,oDAAoD;AACpD,EAAE;AACF,uFAAuF;AACvF,2FAA4H;AAE5H;;;;;;;;;;GAUG;AACH,MAAa,sBAAsB;IAE/B;;;;;;OAMG;IACH,MAAM,CAAC,eAAe;QAClB,OAAO,MAAM,CAAC,IAAI,CAAC,yCAA0B,CAAC,CAAC,MAAM,CACjD,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,kBAAkB,CAChC,CAAC;IACN,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAY;QACxB,MAAM,OAAO,GAAG,yCAA+D,CAAC;QAChF,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,SAAS,KAAK,SAAS,EAAE;YACzB,MAAM,IAAI,KAAK,CACX,yCAAyC,IAAI,mBAAmB,sBAAsB,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxH,CAAC;SACL;QACD,OAAO,SAAuC,CAAC;IACnD,CAAC;CACJ;AA9BD,wDA8BC"}

package/node/wrappers/models/position/position_filter_operator.test.d.ts

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

package/node/wrappers/models/position/position_filter_operator.test.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const position_filter_operator_1 = require("./position_filter_operator");
+const position_util_pb_1 = require("../../../fintekkers/models/position/position_util_pb");
+describe('PositionFilterOperator.fromName', () => {
+    test.each(position_filter_operator_1.PositionFilterOperator.getAllTypeNames())('fromName("%s") returns the matching numeric enum value', (name) => {
+        const value = position_filter_operator_1.PositionFilterOperator.fromName(name);
+        const expected = position_util_pb_1.PositionFilterOperator[name];
+        expect(value).toBe(expected);
+    });
+    test('throws on unknown name and lists valid names in the error', () => {
+        let err;
+        try {
+            position_filter_operator_1.PositionFilterOperator.fromName('NOT_A_REAL_OPERATOR');
+        }
+        catch (e) {
+            err = e;
+        }
+        expect(err).toBeDefined();
+        expect(err.message).toContain('NOT_A_REAL_OPERATOR');
+        expect(err.message).toContain('EQUALS');
+        expect(err.message).toContain('MORE_THAN');
+    });
+    test('throws on lowercase URL-style input (fromName takes proto enum names)', () => {
+        // ledger-models is the source-of-truth vocabulary; consumers
+        // (including URL conventions in UI) standardize on proto names.
+        // Pin the strict behavior so this contract is loudly tested.
+        expect(() => position_filter_operator_1.PositionFilterOperator.fromName('greater_than')).toThrow();
+        expect(() => position_filter_operator_1.PositionFilterOperator.fromName('more_than')).toThrow();
+    });
+    test('accepts UNKNOWN_OPERATOR — sentinel is a valid enum key', () => {
+        // Excluded from getAllTypeNames (no dropdown surface) but still a
+        // valid proto enum value. Mirrors Identifier / SecurityType /
+        // AssetClass behavior.
+        expect(position_filter_operator_1.PositionFilterOperator.fromName('UNKNOWN_OPERATOR')).toBe(position_util_pb_1.PositionFilterOperator.UNKNOWN_OPERATOR);
+    });
+});
+describe('PositionFilterOperator.getAllTypeNames', () => {
+    test('returns the expected set in proto-declaration order, excluding UNKNOWN_OPERATOR', () => {
+        // Proto-declared order in position_util.proto:
+        //   UNKNOWN_OPERATOR = 0;        (excluded)
+        //   EQUALS = 1;
+        //   NOT_EQUALS = 2;
+        //   LESS_THAN = 3;
+        //   LESS_THAN_OR_EQUALS = 4;
+        //   MORE_THAN = 5;
+        //   MORE_THAN_OR_EQUALS = 6;
+        expect(position_filter_operator_1.PositionFilterOperator.getAllTypeNames()).toEqual([
+            'EQUALS',
+            'NOT_EQUALS',
+            'LESS_THAN',
+            'LESS_THAN_OR_EQUALS',
+            'MORE_THAN',
+            'MORE_THAN_OR_EQUALS',
+        ]);
+    });
+    test('excludes the UNKNOWN_OPERATOR sentinel', () => {
+        expect(position_filter_operator_1.PositionFilterOperator.getAllTypeNames()).not.toContain('UNKNOWN_OPERATOR');
+    });
+});
+//# sourceMappingURL=position_filter_operator.test.js.map

package/node/wrappers/models/position/position_filter_operator.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"position_filter_operator.test.js","sourceRoot":"","sources":["position_filter_operator.test.ts"],"names":[],"mappings":";;AAAA,yEAAoE;AACpE,2FAA4H;AAE5H,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC7C,IAAI,CAAC,IAAI,CAAC,iDAAsB,CAAC,eAAe,EAAE,CAAC,CAC/C,wDAAwD,EACxD,CAAC,IAAY,EAAE,EAAE;QACb,MAAM,KAAK,GAAG,iDAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAI,yCAAgE,CAAC,IAAI,CAAC,CAAC;QACzF,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,iDAAsB,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;SAC1D;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,qBAAqB,CAAC,CAAC;QACtD,MAAM,CAAC,GAAI,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,CAAC,GAAI,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,6DAA6D;QAC7D,gEAAgE;QAChE,6DAA6D;QAC7D,MAAM,CAAC,GAAG,EAAE,CAAC,iDAAsB,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACxE,MAAM,CAAC,GAAG,EAAE,CAAC,iDAAsB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,kEAAkE;QAClE,8DAA8D;QAC9D,uBAAuB;QACvB,MAAM,CAAC,iDAAsB,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAC5D,yCAA0B,CAAC,gBAAgB,CAC9C,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACpD,IAAI,CAAC,iFAAiF,EAAE,GAAG,EAAE;QACzF,+CAA+C;QAC/C,4CAA4C;QAC5C,gBAAgB;QAChB,oBAAoB;QACpB,mBAAmB;QACnB,6BAA6B;QAC7B,mBAAmB;QACnB,6BAA6B;QAC7B,MAAM,CAAC,iDAAsB,CAAC,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC;YACrD,QAAQ;YACR,YAAY;YACZ,WAAW;YACX,qBAAqB;YACrB,WAAW;YACX,qBAAqB;SACxB,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,iDAAsB,CAAC,eAAe,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/node/wrappers/models/position/position_filter_operator.test.ts

@@ -0,0 +1,68 @@
+import { PositionFilterOperator } from './position_filter_operator';
+import { PositionFilterOperator as PositionFilterOperatorEnum } from '../../../fintekkers/models/position/position_util_pb';
+
+describe('PositionFilterOperator.fromName', () => {
+    test.each(PositionFilterOperator.getAllTypeNames())(
+        'fromName("%s") returns the matching numeric enum value',
+        (name: string) => {
+            const value = PositionFilterOperator.fromName(name);
+            const expected = (PositionFilterOperatorEnum 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 {
+            PositionFilterOperator.fromName('NOT_A_REAL_OPERATOR');
+        } catch (e) {
+            err = e as Error;
+        }
+        expect(err).toBeDefined();
+        expect(err!.message).toContain('NOT_A_REAL_OPERATOR');
+        expect(err!.message).toContain('EQUALS');
+        expect(err!.message).toContain('MORE_THAN');
+    });
+
+    test('throws on lowercase URL-style input (fromName takes proto enum names)', () => {
+        // ledger-models is the source-of-truth vocabulary; consumers
+        // (including URL conventions in UI) standardize on proto names.
+        // Pin the strict behavior so this contract is loudly tested.
+        expect(() => PositionFilterOperator.fromName('greater_than')).toThrow();
+        expect(() => PositionFilterOperator.fromName('more_than')).toThrow();
+    });
+
+    test('accepts UNKNOWN_OPERATOR — sentinel is a valid enum key', () => {
+        // Excluded from getAllTypeNames (no dropdown surface) but still a
+        // valid proto enum value. Mirrors Identifier / SecurityType /
+        // AssetClass behavior.
+        expect(PositionFilterOperator.fromName('UNKNOWN_OPERATOR')).toBe(
+            PositionFilterOperatorEnum.UNKNOWN_OPERATOR
+        );
+    });
+});
+
+describe('PositionFilterOperator.getAllTypeNames', () => {
+    test('returns the expected set in proto-declaration order, excluding UNKNOWN_OPERATOR', () => {
+        // Proto-declared order in position_util.proto:
+        //   UNKNOWN_OPERATOR = 0;        (excluded)
+        //   EQUALS = 1;
+        //   NOT_EQUALS = 2;
+        //   LESS_THAN = 3;
+        //   LESS_THAN_OR_EQUALS = 4;
+        //   MORE_THAN = 5;
+        //   MORE_THAN_OR_EQUALS = 6;
+        expect(PositionFilterOperator.getAllTypeNames()).toEqual([
+            'EQUALS',
+            'NOT_EQUALS',
+            'LESS_THAN',
+            'LESS_THAN_OR_EQUALS',
+            'MORE_THAN',
+            'MORE_THAN_OR_EQUALS',
+        ]);
+    });
+
+    test('excludes the UNKNOWN_OPERATOR sentinel', () => {
+        expect(PositionFilterOperator.getAllTypeNames()).not.toContain('UNKNOWN_OPERATOR');
+    });
+});

package/node/wrappers/models/position/position_filter_operator.ts

@@ -0,0 +1,55 @@
+// The proto module exports the enum as `PositionFilterOperator` (no `Proto`
+// suffix, unlike SecurityTypeProto / AssetClassProto / IdentifierTypeProto).
+// Renamed on import to free the natural class name for the wrapper. Consumers
+// who want the enum type for their own annotations can import directly from
+// the proto module:
+//
+//   import { PositionFilterOperator } from '@fintekkers/.../position_util_pb';
+//
+// vs. importing the wrapper helpers from this file:
+//
+//   import { PositionFilterOperator } from '@fintekkers/.../position_filter_operator';
+import { PositionFilterOperator as PositionFilterOperatorEnum } from '../../../fintekkers/models/position/position_util_pb';
+
+/**
+ * Static helpers around the PositionFilterOperator proto enum, mirroring
+ * the Identifier / SecurityType / AssetClass wrapper pattern shipped in
+ * v0.1.133–v0.1.134 (PRs #188, #189).
+ *
+ * Strict: takes / returns proto enum NAMES ("MORE_THAN", "LESS_THAN_OR_EQUALS",
+ * ...). Consumers (including UI URL conventions) should standardize on
+ * proto names — ledger-models is the source-of-truth vocabulary and
+ * should not absorb consumer-side naming conventions. See
+ * FinTekkers/second-brain#229 for the ui-service migration path.
+ */
+export class PositionFilterOperator {
+
+    /**
+     * Returns the names of all known PositionFilterOperator values, EXCLUDING
+     * the sentinel `UNKNOWN_OPERATOR`. 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(PositionFilterOperatorEnum).filter(
+            k => k !== 'UNKNOWN_OPERATOR'
+        );
+    }
+
+    /**
+     * Resolve a proto enum NAME (e.g., "MORE_THAN", "EQUALS") to its numeric
+     * PositionFilterOperator value. Throws on unknown name; the error lists
+     * the valid names so typos are fixable without grepping the proto.
+     */
+    static fromName(name: string): PositionFilterOperatorEnum {
+        const enumObj = PositionFilterOperatorEnum as unknown as Record<string, number>;
+        const enumValue = enumObj[name];
+        if (enumValue === undefined) {
+            throw new Error(
+                `Unknown PositionFilterOperator name: '${name}'. Valid names: ${PositionFilterOperator.getAllTypeNames().join(', ')}`
+            );
+        }
+        return enumValue as PositionFilterOperatorEnum;
+    }
+}

package/package.json

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