@fintekkers/ledger-models 0.1.132 → 0.1.133

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

@@ -46,6 +46,11 @@ export class SecurityProto extends jspb.Message {
     setValidTo(value?: fintekkers_models_util_local_timestamp_pb.LocalTimestampProto): SecurityProto;
     getSecurityType(): fintekkers_models_security_security_type_pb.SecurityTypeProto;
     setSecurityType(value: fintekkers_models_security_security_type_pb.SecurityTypeProto): SecurityProto;
+
+    hasDeletedAt(): boolean;
+    clearDeletedAt(): void;
+    getDeletedAt(): fintekkers_models_util_local_timestamp_pb.LocalTimestampProto | undefined;
+    setDeletedAt(value?: fintekkers_models_util_local_timestamp_pb.LocalTimestampProto): SecurityProto;
     getAssetClass(): string;
     setAssetClass(value: string): SecurityProto;
     getIssuerName(): string;
@@ -184,6 +189,7 @@ export namespace SecurityProto {
         validFrom?: fintekkers_models_util_local_timestamp_pb.LocalTimestampProto.AsObject,
         validTo?: fintekkers_models_util_local_timestamp_pb.LocalTimestampProto.AsObject,
         securityType: fintekkers_models_security_security_type_pb.SecurityTypeProto,
+        deletedAt?: fintekkers_models_util_local_timestamp_pb.LocalTimestampProto.AsObject,
         assetClass: string,
         issuerName: string,
         settlementCurrency?: SecurityProto.AsObject,

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

@@ -298,6 +298,7 @@ proto.fintekkers.models.security.SecurityProto.toObject = function(includeInstan
     validFrom: (f = msg.getValidFrom()) && fintekkers_models_util_local_timestamp_pb.LocalTimestampProto.toObject(includeInstance, f),
     validTo: (f = msg.getValidTo()) && fintekkers_models_util_local_timestamp_pb.LocalTimestampProto.toObject(includeInstance, f),
     securityType: jspb.Message.getFieldWithDefault(msg, 10, 0),
+    deletedAt: (f = msg.getDeletedAt()) && fintekkers_models_util_local_timestamp_pb.LocalTimestampProto.toObject(includeInstance, f),
     assetClass: jspb.Message.getFieldWithDefault(msg, 11, ""),
     issuerName: jspb.Message.getFieldWithDefault(msg, 12, ""),
     settlementCurrency: (f = msg.getSettlementCurrency()) && proto.fintekkers.models.security.SecurityProto.toObject(includeInstance, f),
@@ -402,6 +403,11 @@ proto.fintekkers.models.security.SecurityProto.deserializeBinaryFromReader = fun
       var value = /** @type {!proto.fintekkers.models.security.SecurityTypeProto} */ (reader.readEnum());
       msg.setSecurityType(value);
       break;
+    case 15:
+      var value = new fintekkers_models_util_local_timestamp_pb.LocalTimestampProto;
+      reader.readMessage(value,fintekkers_models_util_local_timestamp_pb.LocalTimestampProto.deserializeBinaryFromReader);
+      msg.setDeletedAt(value);
+      break;
     case 11:
       var value = /** @type {string} */ (reader.readString());
       msg.setAssetClass(value);
@@ -630,6 +636,14 @@ proto.fintekkers.models.security.SecurityProto.serializeBinaryToWriter = functio
       f
     );
   }
+  f = message.getDeletedAt();
+  if (f != null) {
+    writer.writeMessage(
+      15,
+      f,
+      fintekkers_models_util_local_timestamp_pb.LocalTimestampProto.serializeBinaryToWriter
+    );
+  }
   f = message.getAssetClass();
   if (f.length > 0) {
     writer.writeString(
@@ -1082,6 +1096,43 @@ proto.fintekkers.models.security.SecurityProto.prototype.setSecurityType = funct
 };
 
 
+/**
+ * optional fintekkers.models.util.LocalTimestampProto deleted_at = 15;
+ * @return {?proto.fintekkers.models.util.LocalTimestampProto}
+ */
+proto.fintekkers.models.security.SecurityProto.prototype.getDeletedAt = function() {
+  return /** @type{?proto.fintekkers.models.util.LocalTimestampProto} */ (
+    jspb.Message.getWrapperField(this, fintekkers_models_util_local_timestamp_pb.LocalTimestampProto, 15));
+};
+
+
+/**
+ * @param {?proto.fintekkers.models.util.LocalTimestampProto|undefined} value
+ * @return {!proto.fintekkers.models.security.SecurityProto} returns this
+*/
+proto.fintekkers.models.security.SecurityProto.prototype.setDeletedAt = function(value) {
+  return jspb.Message.setWrapperField(this, 15, value);
+};
+
+
+/**
+ * Clears the message field making it undefined.
+ * @return {!proto.fintekkers.models.security.SecurityProto} returns this
+ */
+proto.fintekkers.models.security.SecurityProto.prototype.clearDeletedAt = function() {
+  return this.setDeletedAt(undefined);
+};
+
+
+/**
+ * Returns whether this field is set.
+ * @return {boolean}
+ */
+proto.fintekkers.models.security.SecurityProto.prototype.hasDeletedAt = function() {
+  return jspb.Message.getField(this, 15) != null;
+};
+
+
 /**
  * optional string asset_class = 11;
  * @return {string}

package/node/fintekkers/requests/price/query_price_request_pb.d.ts

@@ -41,6 +41,8 @@ export class QueryPriceRequestProto extends jspb.Message {
     clearDateRange(): void;
     getDateRange(): fintekkers_models_util_date_range_pb.DateRangeProto | undefined;
     setDateRange(value?: fintekkers_models_util_date_range_pb.DateRangeProto): QueryPriceRequestProto;
+    getLimit(): number;
+    setLimit(value: number): QueryPriceRequestProto;
 
     getTimeRangeCase(): QueryPriceRequestProto.TimeRangeCase;
 
@@ -64,6 +66,7 @@ export namespace QueryPriceRequestProto {
         frequency: PriceFrequencyProto,
         horizon: PriceHorizonProto,
         dateRange?: fintekkers_models_util_date_range_pb.DateRangeProto.AsObject,
+        limit: number,
     }
 
     export enum TimeRangeCase {

package/node/fintekkers/requests/price/query_price_request_pb.js

@@ -127,7 +127,8 @@ proto.fintekkers.requests.price.QueryPriceRequestProto.toObject = function(inclu
     asOf: (f = msg.getAsOf()) && fintekkers_models_util_local_timestamp_pb.LocalTimestampProto.toObject(includeInstance, f),
     frequency: jspb.Message.getFieldWithDefault(msg, 24, 0),
     horizon: jspb.Message.getFieldWithDefault(msg, 25, 0),
-    dateRange: (f = msg.getDateRange()) && fintekkers_models_util_date_range_pb.DateRangeProto.toObject(includeInstance, f)
+    dateRange: (f = msg.getDateRange()) && fintekkers_models_util_date_range_pb.DateRangeProto.toObject(includeInstance, f),
+    limit: jspb.Message.getFieldWithDefault(msg, 27, 0)
   };
 
   if (includeInstance) {
@@ -200,6 +201,10 @@ proto.fintekkers.requests.price.QueryPriceRequestProto.deserializeBinaryFromRead
       reader.readMessage(value,fintekkers_models_util_date_range_pb.DateRangeProto.deserializeBinaryFromReader);
       msg.setDateRange(value);
       break;
+    case 27:
+      var value = /** @type {number} */ (reader.readInt32());
+      msg.setLimit(value);
+      break;
     default:
       reader.skipField();
       break;
@@ -289,6 +294,13 @@ proto.fintekkers.requests.price.QueryPriceRequestProto.serializeBinaryToWriter =
       fintekkers_models_util_date_range_pb.DateRangeProto.serializeBinaryToWriter
     );
   }
+  f = message.getLimit();
+  if (f !== 0) {
+    writer.writeInt32(
+      27,
+      f
+    );
+  }
 };
 
 
@@ -531,6 +543,24 @@ proto.fintekkers.requests.price.QueryPriceRequestProto.prototype.hasDateRange =
 };
 
 
+/**
+ * optional int32 limit = 27;
+ * @return {number}
+ */
+proto.fintekkers.requests.price.QueryPriceRequestProto.prototype.getLimit = function() {
+  return /** @type {number} */ (jspb.Message.getFieldWithDefault(this, 27, 0));
+};
+
+
+/**
+ * @param {number} value
+ * @return {!proto.fintekkers.requests.price.QueryPriceRequestProto} returns this
+ */
+proto.fintekkers.requests.price.QueryPriceRequestProto.prototype.setLimit = function(value) {
+  return jspb.Message.setProto3IntField(this, 27, value);
+};
+
+
 /**
  * @enum {number}
  */

package/node/fintekkers/requests/price/query_price_response_pb.d.ts

@@ -7,6 +7,7 @@
 import * as jspb from "google-protobuf";
 import * as fintekkers_models_price_price_pb from "../../../fintekkers/models/price/price_pb";
 import * as fintekkers_requests_price_query_price_request_pb from "../../../fintekkers/requests/price/query_price_request_pb";
+import * as fintekkers_requests_util_errors_summary_pb from "../../../fintekkers/requests/util/errors/summary_pb";
 
 export class QueryPriceResponseProto extends jspb.Message { 
     getObjectClass(): string;
@@ -23,6 +24,11 @@ export class QueryPriceResponseProto extends jspb.Message {
     setPriceResponseList(value: Array<fintekkers_models_price_price_pb.PriceProto>): QueryPriceResponseProto;
     addPriceResponse(value?: fintekkers_models_price_price_pb.PriceProto, index?: number): fintekkers_models_price_price_pb.PriceProto;
 
+    hasErrorsOrWarnings(): boolean;
+    clearErrorsOrWarnings(): void;
+    getErrorsOrWarnings(): fintekkers_requests_util_errors_summary_pb.SummaryProto | undefined;
+    setErrorsOrWarnings(value?: fintekkers_requests_util_errors_summary_pb.SummaryProto): QueryPriceResponseProto;
+
     serializeBinary(): Uint8Array;
     toObject(includeInstance?: boolean): QueryPriceResponseProto.AsObject;
     static toObject(includeInstance: boolean, msg: QueryPriceResponseProto): QueryPriceResponseProto.AsObject;
@@ -39,5 +45,6 @@ export namespace QueryPriceResponseProto {
         version: string,
         queryPriceRequest?: fintekkers_requests_price_query_price_request_pb.QueryPriceRequestProto.AsObject,
         priceResponseList: Array<fintekkers_models_price_price_pb.PriceProto.AsObject>,
+        errorsOrWarnings?: fintekkers_requests_util_errors_summary_pb.SummaryProto.AsObject,
     }
 }

package/node/fintekkers/requests/price/query_price_response_pb.js

@@ -25,6 +25,8 @@ var fintekkers_models_price_price_pb = require('../../../fintekkers/models/price
 goog.object.extend(proto, fintekkers_models_price_price_pb);
 var fintekkers_requests_price_query_price_request_pb = require('../../../fintekkers/requests/price/query_price_request_pb.js');
 goog.object.extend(proto, fintekkers_requests_price_query_price_request_pb);
+var fintekkers_requests_util_errors_summary_pb = require('../../../fintekkers/requests/util/errors/summary_pb.js');
+goog.object.extend(proto, fintekkers_requests_util_errors_summary_pb);
 goog.exportSymbol('proto.fintekkers.requests.price.QueryPriceResponseProto', null, global);
 /**
  * Generated by JsPbCodeGenerator.
@@ -90,7 +92,8 @@ proto.fintekkers.requests.price.QueryPriceResponseProto.toObject = function(incl
     version: jspb.Message.getFieldWithDefault(msg, 2, ""),
     queryPriceRequest: (f = msg.getQueryPriceRequest()) && fintekkers_requests_price_query_price_request_pb.QueryPriceRequestProto.toObject(includeInstance, f),
     priceResponseList: jspb.Message.toObjectList(msg.getPriceResponseList(),
-    fintekkers_models_price_price_pb.PriceProto.toObject, includeInstance)
+    fintekkers_models_price_price_pb.PriceProto.toObject, includeInstance),
+    errorsOrWarnings: (f = msg.getErrorsOrWarnings()) && fintekkers_requests_util_errors_summary_pb.SummaryProto.toObject(includeInstance, f)
   };
 
   if (includeInstance) {
@@ -145,6 +148,11 @@ proto.fintekkers.requests.price.QueryPriceResponseProto.deserializeBinaryFromRea
       reader.readMessage(value,fintekkers_models_price_price_pb.PriceProto.deserializeBinaryFromReader);
       msg.addPriceResponse(value);
       break;
+    case 40:
+      var value = new fintekkers_requests_util_errors_summary_pb.SummaryProto;
+      reader.readMessage(value,fintekkers_requests_util_errors_summary_pb.SummaryProto.deserializeBinaryFromReader);
+      msg.setErrorsOrWarnings(value);
+      break;
     default:
       reader.skipField();
       break;
@@ -204,6 +212,14 @@ proto.fintekkers.requests.price.QueryPriceResponseProto.serializeBinaryToWriter
       fintekkers_models_price_price_pb.PriceProto.serializeBinaryToWriter
     );
   }
+  f = message.getErrorsOrWarnings();
+  if (f != null) {
+    writer.writeMessage(
+      40,
+      f,
+      fintekkers_requests_util_errors_summary_pb.SummaryProto.serializeBinaryToWriter
+    );
+  }
 };
 
 
@@ -318,4 +334,41 @@ proto.fintekkers.requests.price.QueryPriceResponseProto.prototype.clearPriceResp
 };
 
 
+/**
+ * optional fintekkers.requests.util.errors.SummaryProto errors_or_warnings = 40;
+ * @return {?proto.fintekkers.requests.util.errors.SummaryProto}
+ */
+proto.fintekkers.requests.price.QueryPriceResponseProto.prototype.getErrorsOrWarnings = function() {
+  return /** @type{?proto.fintekkers.requests.util.errors.SummaryProto} */ (
+    jspb.Message.getWrapperField(this, fintekkers_requests_util_errors_summary_pb.SummaryProto, 40));
+};
+
+
+/**
+ * @param {?proto.fintekkers.requests.util.errors.SummaryProto|undefined} value
+ * @return {!proto.fintekkers.requests.price.QueryPriceResponseProto} returns this
+*/
+proto.fintekkers.requests.price.QueryPriceResponseProto.prototype.setErrorsOrWarnings = function(value) {
+  return jspb.Message.setWrapperField(this, 40, value);
+};
+
+
+/**
+ * Clears the message field making it undefined.
+ * @return {!proto.fintekkers.requests.price.QueryPriceResponseProto} returns this
+ */
+proto.fintekkers.requests.price.QueryPriceResponseProto.prototype.clearErrorsOrWarnings = function() {
+  return this.setErrorsOrWarnings(undefined);
+};
+
+
+/**
+ * Returns whether this field is set.
+ * @return {boolean}
+ */
+proto.fintekkers.requests.price.QueryPriceResponseProto.prototype.hasErrorsOrWarnings = function() {
+  return jspb.Message.getField(this, 40) != null;
+};
+
+
 goog.object.extend(exports, proto.fintekkers.requests.price);

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

@@ -35,6 +35,14 @@ declare class BondSecurity extends Security {
      * @returns The price scale factor as a Decimal (0.01)
      */
     getPriceScaleFactor(): Decimal;
+    /**
+     * Bond issue date is the auction date and is required for bonds.
+     * Overrides Security.getIssueDate (which returns LocalDate | null on the
+     * base) with a non-nullable return type — for a properly-formed bond,
+     * issue date is always present, and TS callers narrowed via isBond()
+     * shouldn't have to null-check.
+     */
+    getIssueDate(): LocalDate;
     getProductType(): string;
 }
 export default BondSecurity;

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

@@ -104,6 +104,19 @@ class BondSecurity extends security_1.default {
     getPriceScaleFactor() {
         return new decimal_js_1.Decimal('0.01');
     }
+    /**
+     * Bond issue date is the auction date and is required for bonds.
+     * Overrides Security.getIssueDate (which returns LocalDate | null on the
+     * base) with a non-nullable return type — for a properly-formed bond,
+     * issue date is always present, and TS callers narrowed via isBond()
+     * shouldn't have to null-check.
+     */
+    getIssueDate() {
+        const date = super.getIssueDate();
+        if (!date)
+            throw new Error("Issue date is required for bonds");
+        return date;
+    }
     getProductType() {
         // Only BondSecurity has getTenor implemented
         // Check if getTenor method exists (it's only in BondSecurity)

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

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

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

@@ -116,6 +116,19 @@ class BondSecurity extends Security {
     return new Decimal('0.01');
   }
 
+  /**
+   * Bond issue date is the auction date and is required for bonds.
+   * Overrides Security.getIssueDate (which returns LocalDate | null on the
+   * base) with a non-nullable return type — for a properly-formed bond,
+   * issue date is always present, and TS callers narrowed via isBond()
+   * shouldn't have to null-check.
+   */
+  getIssueDate(): LocalDate {
+    const date = super.getIssueDate();
+    if (!date) throw new Error("Issue date is required for bonds");
+    return date;
+  }
+
   getProductType(): string {
     // Only BondSecurity has getTenor implemented
     // Check if getTenor method exists (it's only in BondSecurity)

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

@@ -26,4 +26,30 @@ export declare class Identifier {
      * Example: "ISIN:US0378331005" or "CUSIP:037833100"
      */
     toString(): string;
+    /**
+     * Build an Identifier from the proto enum's NAME (e.g., "ISIN", "CUSIP",
+     * "EXCH_TICKER") plus the identifier value. Saves callers from rolling
+     * their own name->enum switch — adding a new enum variant on the proto
+     * side propagates automatically.
+     *
+     * Throws if `name` isn't a known IdentifierTypeProto key. The error
+     * lists the valid names so the caller can fix the typo without grepping.
+     *
+     * @param name proto enum key (e.g., "ISIN")
+     * @param value the identifier value (e.g., "US0378331005")
+     */
+    static fromName(name: string, value: string): Identifier;
+    /**
+     * Returns the names of all known IdentifierType enum values, EXCLUDING
+     * the sentinel `UNKNOWN_IDENTIFIER_TYPE`. Drives UI dropdowns / pickers
+     * so adding 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).
+     *
+     * @returns string[] of identifier type names, e.g.
+     *   ["EXCH_TICKER", "ISIN", "CUSIP", "OSI", "FIGI", "SERIES_ID", "CASH"]
+     */
+    static getAllTypeNames(): string[];
 }

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Identifier = void 0;
+const identifier_pb_1 = require("../../../fintekkers/models/security/identifier/identifier_pb");
 const identifier_type_pb_1 = require("../../../fintekkers/models/security/identifier/identifier_type_pb");
 class Identifier {
     constructor(proto) {
@@ -40,6 +41,44 @@ class Identifier {
         const value = this.getIdentifierValue();
         return `${typeName}:${value}`;
     }
+    /**
+     * Build an Identifier from the proto enum's NAME (e.g., "ISIN", "CUSIP",
+     * "EXCH_TICKER") plus the identifier value. Saves callers from rolling
+     * their own name->enum switch — adding a new enum variant on the proto
+     * side propagates automatically.
+     *
+     * Throws if `name` isn't a known IdentifierTypeProto key. The error
+     * lists the valid names so the caller can fix the typo without grepping.
+     *
+     * @param name proto enum key (e.g., "ISIN")
+     * @param value the identifier value (e.g., "US0378331005")
+     */
+    static fromName(name, value) {
+        const enumObj = identifier_type_pb_1.IdentifierTypeProto;
+        const enumValue = enumObj[name];
+        if (enumValue === undefined) {
+            throw new Error(`Unknown IdentifierType name: '${name}'. Valid names: ${Identifier.getAllTypeNames().join(', ')}`);
+        }
+        const proto = new identifier_pb_1.IdentifierProto();
+        proto.setIdentifierType(enumValue);
+        proto.setIdentifierValue(value);
+        return new Identifier(proto);
+    }
+    /**
+     * Returns the names of all known IdentifierType enum values, EXCLUDING
+     * the sentinel `UNKNOWN_IDENTIFIER_TYPE`. Drives UI dropdowns / pickers
+     * so adding 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).
+     *
+     * @returns string[] of identifier type names, e.g.
+     *   ["EXCH_TICKER", "ISIN", "CUSIP", "OSI", "FIGI", "SERIES_ID", "CASH"]
+     */
+    static getAllTypeNames() {
+        return Object.keys(identifier_type_pb_1.IdentifierTypeProto).filter(k => k !== 'UNKNOWN_IDENTIFIER_TYPE');
+    }
 }
 exports.Identifier = Identifier;
 (() => {

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

@@ -1 +1 @@
-{"version":3,"file":"identifier.js","sourceRoot":"","sources":["identifier.ts"],"names":[],"mappings":";;;AACA,0GAAwG;AAExG,MAAa,UAAU;IAGnB,YAAY,KAAsB;QAC9B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAYD;;;;;;;OAOG;IACH,qBAAqB;;QACjB,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC;QACtD,OAAO,MAAA,UAAU,CAAC,qBAAqB,CAAC,GAAG,CAAC,cAAc,CAAC,mCAAI,yBAAyB,CAAC;IAC7F,CAAC;IAED;;OAEG;IACH,kBAAkB;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,iBAAiB;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,QAAQ;QACJ,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxC,OAAO,GAAG,QAAQ,IAAI,KAAK,EAAE,CAAC;IAClC,CAAC;CACJ;AArDD,gCAqDC;AA5CG;IACI,UAAU,CAAC,qBAAqB,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE7D,MAAM,CAAC,IAAI,CAAC,wCAAmB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QAC3C,UAAU,CAAC,qBAAqB,CAAC,GAAG,CAAC,wCAAmB,CAAC,GAAuC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5G,CAAC,CAAC,CAAC;AACP,CAAC,GAAA,CAAA"}
+{"version":3,"file":"identifier.js","sourceRoot":"","sources":["identifier.ts"],"names":[],"mappings":";;;AAAA,gGAA+F;AAC/F,0GAAwG;AAExG,MAAa,UAAU;IAGnB,YAAY,KAAsB;QAC9B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAYD;;;;;;;OAOG;IACH,qBAAqB;;QACjB,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC;QACtD,OAAO,MAAA,UAAU,CAAC,qBAAqB,CAAC,GAAG,CAAC,cAAc,CAAC,mCAAI,yBAAyB,CAAC;IAC7F,CAAC;IAED;;OAEG;IACH,kBAAkB;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,iBAAiB;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,QAAQ;QACJ,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxC,OAAO,GAAG,QAAQ,IAAI,KAAK,EAAE,CAAC;IAClC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAY,EAAE,KAAa;QACvC,MAAM,OAAO,GAAG,wCAAwD,CAAC;QACzE,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,SAAS,KAAK,SAAS,EAAE;YACzB,MAAM,IAAI,KAAK,CACX,iCAAiC,IAAI,mBAAmB,UAAU,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACpG,CAAC;SACL;QACD,MAAM,KAAK,GAAG,IAAI,+BAAe,EAAE,CAAC;QACpC,KAAK,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACnC,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAChC,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,eAAe;QAClB,OAAO,MAAM,CAAC,IAAI,CAAC,wCAAmB,CAAC,CAAC,MAAM,CAC1C,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,yBAAyB,CACvC,CAAC;IACN,CAAC;CACJ;AAjGD,gCAiGC;AAxFG;IACI,UAAU,CAAC,qBAAqB,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE7D,MAAM,CAAC,IAAI,CAAC,wCAAmB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QAC3C,UAAU,CAAC,qBAAqB,CAAC,GAAG,CAAC,wCAAmB,CAAC,GAAuC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5G,CAAC,CAAC,CAAC;AACP,CAAC,GAAA,CAAA"}

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

@@ -52,4 +52,66 @@ function testUnknownIdentifier() {
     assert(identifier.getIdentifierValue() === 'UNKNOWN123', 'Should return the identifier value');
     assert(identifier.toString() === 'UNKNOWN_IDENTIFIER_TYPE:UNKNOWN123', 'Should return "UNKNOWN_IDENTIFIER_TYPE:UNKNOWN123"');
 }
+// ---------- fromName / getAllTypeNames ----------
+describe('Identifier.fromName', () => {
+    // Round-trip: every name returned by getAllTypeNames must construct a
+    // wrapper whose getIdentifierTypeName echoes the same name back.
+    test.each(identifier_1.Identifier.getAllTypeNames())('fromName("%s") round-trips through getIdentifierTypeName', (name) => {
+        const id = identifier_1.Identifier.fromName(name, 'value-for-' + name);
+        expect(id.getIdentifierTypeName()).toBe(name);
+        expect(id.getIdentifierValue()).toBe('value-for-' + name);
+        expect(id.toString()).toBe(`${name}:value-for-${name}`);
+    });
+    test('throws on unknown name and lists valid names in the error', () => {
+        let err;
+        try {
+            identifier_1.Identifier.fromName('NOT_A_REAL_TYPE', 'x');
+        }
+        catch (e) {
+            err = e;
+        }
+        expect(err).toBeDefined();
+        expect(err.message).toContain('NOT_A_REAL_TYPE');
+        // Error message names a few known valid entries so a typo is fixable
+        // without grepping for the proto.
+        expect(err.message).toContain('ISIN');
+        expect(err.message).toContain('CUSIP');
+    });
+    test('throws on UNKNOWN_IDENTIFIER_TYPE — sentinel is not a public name', () => {
+        // It IS a valid proto enum value, but getAllTypeNames excludes it,
+        // so fromName accepting it would be inconsistent with the dropdown
+        // contract. Guard explicitly.
+        // (Currently fromName allows it because it IS a key on
+        // IdentifierTypeProto. This test pins the EXISTING behavior so a
+        // future tightening is a deliberate choice. If the policy changes,
+        // flip this assertion.)
+        const id = identifier_1.Identifier.fromName('UNKNOWN_IDENTIFIER_TYPE', 'whatever');
+        expect(id.getIdentifierType()).toBe(identifier_type_pb_1.IdentifierTypeProto.UNKNOWN_IDENTIFIER_TYPE);
+    });
+});
+describe('Identifier.getAllTypeNames', () => {
+    test('returns the expected set in proto-declaration order, excluding UNKNOWN', () => {
+        // Proto-declared order in identifier_type.proto:
+        //   UNKNOWN_IDENTIFIER_TYPE = 0;  (excluded)
+        //   EXCH_TICKER = 1;
+        //   ISIN = 2;
+        //   CUSIP = 3;
+        //   OSI = 4;
+        //   FIGI = 5;
+        //   SERIES_ID = 6;
+        //   CASH = 50;
+        expect(identifier_1.Identifier.getAllTypeNames()).toEqual([
+            'EXCH_TICKER',
+            'ISIN',
+            'CUSIP',
+            'OSI',
+            'FIGI',
+            'SERIES_ID',
+            'CASH',
+        ]);
+    });
+    test('excludes the UNKNOWN_IDENTIFIER_TYPE sentinel', () => {
+        expect(identifier_1.Identifier.getAllTypeNames()).not.toContain('UNKNOWN_IDENTIFIER_TYPE');
+    });
+});
 //# sourceMappingURL=identifier.test.js.map

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

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

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

@@ -63,3 +63,73 @@ function testUnknownIdentifier(): void {
     assert(identifier.toString() === 'UNKNOWN_IDENTIFIER_TYPE:UNKNOWN123', 'Should return "UNKNOWN_IDENTIFIER_TYPE:UNKNOWN123"');
 }
 
+// ---------- fromName / getAllTypeNames ----------
+
+describe('Identifier.fromName', () => {
+    // Round-trip: every name returned by getAllTypeNames must construct a
+    // wrapper whose getIdentifierTypeName echoes the same name back.
+    test.each(Identifier.getAllTypeNames())(
+        'fromName("%s") round-trips through getIdentifierTypeName',
+        (name: string) => {
+            const id = Identifier.fromName(name, 'value-for-' + name);
+            expect(id.getIdentifierTypeName()).toBe(name);
+            expect(id.getIdentifierValue()).toBe('value-for-' + name);
+            expect(id.toString()).toBe(`${name}:value-for-${name}`);
+        }
+    );
+
+    test('throws on unknown name and lists valid names in the error', () => {
+        let err: Error | undefined;
+        try {
+            Identifier.fromName('NOT_A_REAL_TYPE', 'x');
+        } catch (e) {
+            err = e as Error;
+        }
+        expect(err).toBeDefined();
+        expect(err!.message).toContain('NOT_A_REAL_TYPE');
+        // Error message names a few known valid entries so a typo is fixable
+        // without grepping for the proto.
+        expect(err!.message).toContain('ISIN');
+        expect(err!.message).toContain('CUSIP');
+    });
+
+    test('throws on UNKNOWN_IDENTIFIER_TYPE — sentinel is not a public name', () => {
+        // It IS a valid proto enum value, but getAllTypeNames excludes it,
+        // so fromName accepting it would be inconsistent with the dropdown
+        // contract. Guard explicitly.
+        // (Currently fromName allows it because it IS a key on
+        // IdentifierTypeProto. This test pins the EXISTING behavior so a
+        // future tightening is a deliberate choice. If the policy changes,
+        // flip this assertion.)
+        const id = Identifier.fromName('UNKNOWN_IDENTIFIER_TYPE', 'whatever');
+        expect(id.getIdentifierType()).toBe(IdentifierTypeProto.UNKNOWN_IDENTIFIER_TYPE);
+    });
+});
+
+describe('Identifier.getAllTypeNames', () => {
+    test('returns the expected set in proto-declaration order, excluding UNKNOWN', () => {
+        // Proto-declared order in identifier_type.proto:
+        //   UNKNOWN_IDENTIFIER_TYPE = 0;  (excluded)
+        //   EXCH_TICKER = 1;
+        //   ISIN = 2;
+        //   CUSIP = 3;
+        //   OSI = 4;
+        //   FIGI = 5;
+        //   SERIES_ID = 6;
+        //   CASH = 50;
+        expect(Identifier.getAllTypeNames()).toEqual([
+            'EXCH_TICKER',
+            'ISIN',
+            'CUSIP',
+            'OSI',
+            'FIGI',
+            'SERIES_ID',
+            'CASH',
+        ]);
+    });
+
+    test('excludes the UNKNOWN_IDENTIFIER_TYPE sentinel', () => {
+        expect(Identifier.getAllTypeNames()).not.toContain('UNKNOWN_IDENTIFIER_TYPE');
+    });
+});
+

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

@@ -54,5 +54,49 @@ export class Identifier {
         const value = this.getIdentifierValue();
         return `${typeName}:${value}`;
     }
+
+    /**
+     * Build an Identifier from the proto enum's NAME (e.g., "ISIN", "CUSIP",
+     * "EXCH_TICKER") plus the identifier value. Saves callers from rolling
+     * their own name->enum switch — adding a new enum variant on the proto
+     * side propagates automatically.
+     *
+     * Throws if `name` isn't a known IdentifierTypeProto key. The error
+     * lists the valid names so the caller can fix the typo without grepping.
+     *
+     * @param name proto enum key (e.g., "ISIN")
+     * @param value the identifier value (e.g., "US0378331005")
+     */
+    static fromName(name: string, value: string): Identifier {
+        const enumObj = IdentifierTypeProto as unknown as Record<string, number>;
+        const enumValue = enumObj[name];
+        if (enumValue === undefined) {
+            throw new Error(
+                `Unknown IdentifierType name: '${name}'. Valid names: ${Identifier.getAllTypeNames().join(', ')}`
+            );
+        }
+        const proto = new IdentifierProto();
+        proto.setIdentifierType(enumValue);
+        proto.setIdentifierValue(value);
+        return new Identifier(proto);
+    }
+
+    /**
+     * Returns the names of all known IdentifierType enum values, EXCLUDING
+     * the sentinel `UNKNOWN_IDENTIFIER_TYPE`. Drives UI dropdowns / pickers
+     * so adding 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).
+     *
+     * @returns string[] of identifier type names, e.g.
+     *   ["EXCH_TICKER", "ISIN", "CUSIP", "OSI", "FIGI", "SERIES_ID", "CASH"]
+     */
+    static getAllTypeNames(): string[] {
+        return Object.keys(IdentifierTypeProto).filter(
+            k => k !== 'UNKNOWN_IDENTIFIER_TYPE'
+        );
+    }
 }
 

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

@@ -11,6 +11,19 @@ declare class Security {
      * Factory method to create the appropriate Security subclass based on security type
      */
     static create(proto: SecurityProto): Security;
+    /**
+     * Type guard: true iff this Security is a BondSecurity (BOND_SECURITY,
+     * TIPS, or FRN). Use to narrow before calling bond-specific getters:
+     *
+     *   if (sec.isBond()) {
+     *     // sec: BondSecurity here — TS knows about getCouponRate(), etc.
+     *     console.log(sec.getMaturityDate());
+     *   }
+     *
+     * Implemented as a runtime check on the proto's securityType so it
+     * works regardless of how the wrapper was constructed.
+     */
+    isBond(): this is import('./BondSecurity').default;
     toString(): string;
     getFields(): FieldProto[];
     getField(field: FieldProto): any;
@@ -26,7 +39,29 @@ declare class Security {
     getProductClass(): string;
     getProductType(): string;
     getSecurityID(): IdentifierProto;
-    getIssueDate(): LocalDate;
+    /**
+     * Returns the issue date if set, else null. Per-type semantic:
+     *   - Bond / TIPS / FRN: auction date.
+     *   - Equity: IPO listing date (when present in source data).
+     *   - CPI series: first observation date.
+     *   - Cash / FX: typically null.
+     *
+     * Returns null on equities/cash/etc. that don't have an issue date set,
+     * rather than throwing — issue date is optional on the base Security.
+     * For bond-specific code paths, prefer narrowing first via isBond() and
+     * calling BondSecurity.getIssueDate() (which returns LocalDate, not null).
+     */
+    getIssueDate(): LocalDate | null;
+    /**
+     * @deprecated Maturity date is a bond-only concept. On the base Security
+     * this still throws when unset for backwards compatibility. Prefer
+     * narrowing first:
+     *
+     *   if (sec.isBond()) sec.getMaturityDate();   // BondSecurity, returns LocalDate
+     *
+     * In a future major version this method will move to BondSecurity only
+     * and TS will catch the misuse at compile time.
+     */
     getMaturityDate(): LocalDate;
     /**
      * Returns the bond-like details sub-message from the oneof, if set.

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

@@ -24,6 +24,24 @@ class Security {
                 return new Security(proto);
         }
     }
+    /**
+     * Type guard: true iff this Security is a BondSecurity (BOND_SECURITY,
+     * TIPS, or FRN). Use to narrow before calling bond-specific getters:
+     *
+     *   if (sec.isBond()) {
+     *     // sec: BondSecurity here — TS knows about getCouponRate(), etc.
+     *     console.log(sec.getMaturityDate());
+     *   }
+     *
+     * Implemented as a runtime check on the proto's securityType so it
+     * works regardless of how the wrapper was constructed.
+     */
+    isBond() {
+        const t = this.proto.getSecurityType();
+        return t === security_type_pb_1.SecurityTypeProto.BOND_SECURITY
+            || t === security_type_pb_1.SecurityTypeProto.TIPS
+            || t === security_type_pb_1.SecurityTypeProto.FRN;
+    }
     toString() {
         return `ID[${this.getID().toString()}], ${this.getSecurityID()}[${this.getIssuerName()}]`;
     }
@@ -49,8 +67,11 @@ class Security {
             case field_pb_1.FieldProto.ADJUSTED_TENOR:
                 throw new Error('Not implemented yet');
             case field_pb_1.FieldProto.MATURITY_DATE:
-                return this.getMaturityDate();
+                // Maturity date is bond-only. Mirror Java's Security.getField:
+                // delegate to BondSecurity, return null for non-bonds.
+                return this.isBond() ? this.getMaturityDate() : null;
             case field_pb_1.FieldProto.ISSUE_DATE:
+                // getIssueDate already returns null on non-bonds; just forward.
                 return this.getIssueDate();
             default:
                 throw new Error(`Field not mapped in Security wrapper: ${field}`);
@@ -93,14 +114,36 @@ class Security {
             throw new Error("Identifier is required");
         return identifier;
     }
+    /**
+     * Returns the issue date if set, else null. Per-type semantic:
+     *   - Bond / TIPS / FRN: auction date.
+     *   - Equity: IPO listing date (when present in source data).
+     *   - CPI series: first observation date.
+     *   - Cash / FX: typically null.
+     *
+     * Returns null on equities/cash/etc. that don't have an issue date set,
+     * rather than throwing — issue date is optional on the base Security.
+     * For bond-specific code paths, prefer narrowing first via isBond() and
+     * calling BondSecurity.getIssueDate() (which returns LocalDate, not null).
+     */
     getIssueDate() {
         // Prefer oneof bond sub-message if available, fall back to flat fields
         const bond = this.getBondLikeDetails();
         const date = bond ? bond.getIssueDate() : this.proto.getIssueDate();
         if (!date)
-            throw new Error("Issue date is required");
+            return null;
         return new date_1.LocalDate(date);
     }
+    /**
+     * @deprecated Maturity date is a bond-only concept. On the base Security
+     * this still throws when unset for backwards compatibility. Prefer
+     * narrowing first:
+     *
+     *   if (sec.isBond()) sec.getMaturityDate();   // BondSecurity, returns LocalDate
+     *
+     * In a future major version this method will move to BondSecurity only
+     * and TS will catch the misuse at compile time.
+     */
     getMaturityDate() {
         // Prefer oneof bond sub-message if available, fall back to flat fields
         const bond = this.getBondLikeDetails();

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

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

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

@@ -7,8 +7,10 @@ const local_date_pb_1 = require("../../../fintekkers/models/util/local_date_pb")
 const uuid_1 = require("../utils/uuid");
 const assert = require("assert");
 const security_1 = __importDefault(require("./security"));
+const BondSecurity_1 = __importDefault(require("./BondSecurity"));
 const decimal_value_pb_1 = require("../../../fintekkers/models/util/decimal_value_pb");
 const security_pb_1 = require("../../../fintekkers/models/security/security_pb");
+const security_type_pb_1 = require("../../../fintekkers/models/security/security_type_pb");
 const coupon_frequency_pb_1 = require("../../../fintekkers/models/security/coupon_frequency_pb");
 const coupon_type_pb_1 = require("../../../fintekkers/models/security/coupon_type_pb");
 const security_quantity_type_pb_1 = require("../../../fintekkers/models/security/security_quantity_type_pb");
@@ -19,6 +21,48 @@ function testSerialization() {
     const security = dummySecurity();
     assert(security.getMaturityDate().toDate().getFullYear() == 2026);
 }
+test('equity routes to base Security and isBond() returns false', () => {
+    const equity = dummyEquity();
+    expect(equity).toBeInstanceOf(security_1.default);
+    expect(equity).not.toBeInstanceOf(BondSecurity_1.default);
+    expect(equity.isBond()).toBe(false);
+});
+test('bond routes to BondSecurity and isBond() returns true (narrows type)', () => {
+    const bond = dummyBondSecurity();
+    expect(bond.isBond()).toBe(true);
+    if (bond.isBond()) {
+        // Inside the narrowed branch TS knows bond: BondSecurity.
+        // Calling a BondSecurity-only method here proves the narrowing works.
+        expect(bond.getCouponRate()).toBeDefined();
+    }
+});
+test('Security.getIssueDate returns null on equity (no throw)', () => {
+    const equity = dummyEquity();
+    // Phase 1 behavior change: was throw "Issue date is required", now returns null.
+    // This is the symptom fix that motivated #205 — equity wrappers no longer
+    // explode on per-record post-processing in ui-service.
+    expect(equity.getIssueDate()).toBeNull();
+});
+test('BondSecurity.getIssueDate returns LocalDate (non-nullable) on bond', () => {
+    const bond = dummyBondSecurity();
+    if (!bond.isBond())
+        throw new Error('test setup: expected bond');
+    const issueDate = bond.getIssueDate();
+    expect(issueDate).not.toBeNull();
+    expect(issueDate.toDate().getFullYear()).toBe(2021);
+});
+test('Security.getMaturityDate still throws on equity (Phase 1 deprecation, not removal)', () => {
+    const equity = dummyEquity();
+    // Behavior preserved deliberately for Phase 1 — callers still get a
+    // loud error if they don't narrow first. Removal happens in Phase 2.
+    expect(() => equity.getMaturityDate()).toThrow('Maturity date is required');
+});
+test('BondSecurity.getMaturityDate works on bond (inherited from Security)', () => {
+    const bond = dummyBondSecurity();
+    if (!bond.isBond())
+        throw new Error('test setup: expected bond');
+    expect(bond.getMaturityDate().toDate().getFullYear()).toBe(2026);
+});
 function dummySecurity() {
     return security_1.default.create(new security_pb_1.SecurityProto()
         .setObjectClass('Transaction').setVersion('0.0.1').setUuid(uuid_1.UUID.random().toUUIDProto())
@@ -33,4 +77,32 @@ function dummySecurity() {
         .setIssueDate(new local_date_pb_1.LocalDateProto().setYear(2021).setMonth(1).setDay(1))
         .setDescription("Dummy security"));
 }
+function dummyBondSecurity() {
+    // Same dummy security but with securityType set so the factory routes
+    // to BondSecurity.
+    return security_1.default.create(new security_pb_1.SecurityProto()
+        .setObjectClass('Security').setVersion('0.0.1').setUuid(uuid_1.UUID.random().toUUIDProto())
+        .setSecurityType(security_type_pb_1.SecurityTypeProto.BOND_SECURITY)
+        .setFaceValue(new decimal_value_pb_1.DecimalValueProto().setArbitraryPrecisionValue('1000.00'))
+        .setQuantityType(security_quantity_type_pb_1.SecurityQuantityTypeProto.ORIGINAL_FACE_VALUE)
+        .setAssetClass("Bond")
+        .setIssuerName("Dummy issuer")
+        .setCouponRate(new decimal_value_pb_1.DecimalValueProto().setArbitraryPrecisionValue('0.05'))
+        .setCouponFrequency(coupon_frequency_pb_1.CouponFrequencyProto.SEMIANNUALLY)
+        .setCouponType(coupon_type_pb_1.CouponTypeProto.FIXED)
+        .setMaturityDate(new local_date_pb_1.LocalDateProto().setYear(2026).setMonth(1).setDay(1))
+        .setIssueDate(new local_date_pb_1.LocalDateProto().setYear(2021).setMonth(1).setDay(1))
+        .setDescription("Dummy bond"));
+}
+function dummyEquity() {
+    // Equity has no maturity / issue date in the proto, exercising the
+    // null-return behavior on getIssueDate and the throw-on-missing
+    // behavior on getMaturityDate.
+    return security_1.default.create(new security_pb_1.SecurityProto()
+        .setObjectClass('Security').setVersion('0.0.1').setUuid(uuid_1.UUID.random().toUUIDProto())
+        .setSecurityType(security_type_pb_1.SecurityTypeProto.EQUITY_SECURITY)
+        .setAssetClass("Equity")
+        .setIssuerName("Dummy issuer Inc.")
+        .setDescription("Dummy equity"));
+}
 //# sourceMappingURL=security.test.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"security.test.js","sourceRoot":"","sources":["security.test.ts"],"names":[],"mappings":";;;;;AAAA,iFAA+E;AAC/E,wCAAqC;AAErC,iCAAkC;AAClC,0DAAkC;AAElC,uFAAqF;AACrF,iFAAgF;AAChF,iGAA+F;AAC/F,uFAAqF;AACrF,6GAA0G;AAG1G,IAAI,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACnC,iBAAiB,EAAE,CAAC;AACxB,CAAC,CAAC,CAAC;AAEH,SAAS,iBAAiB;IACtB,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IAEjC,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,aAAa;IAClB,OAAO,kBAAQ,CAAC,MAAM,CAAC,IAAI,2BAAa,EAAE;SACrC,cAAc,CAAC,aAAa,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,WAAI,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC;SACtF,YAAY,CAAC,IAAI,oCAAiB,EAAE,CAAC,0BAA0B,CAAC,SAAS,CAAC,CAAC;SAC3E,eAAe,CAAC,qDAAyB,CAAC,mBAAmB,CAAC;SAC9D,aAAa,CAAC,MAAM,CAAC;SACrB,aAAa,CAAC,cAAc,CAAC;SAE7B,aAAa,CAAC,IAAI,oCAAiB,EAAE,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC;SACzE,kBAAkB,CAAC,0CAAoB,CAAC,YAAY,CAAC;SACrD,aAAa,CAAC,gCAAe,CAAC,KAAK,CAAC;SAEpC,eAAe,CAAC,IAAI,8BAAc,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;SACzE,YAAY,CAAC,IAAI,8BAAc,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;SACtE,cAAc,CAAC,gBAAgB,CAAC,CACpC,CAAC;AACN,CAAC"}
+{"version":3,"file":"security.test.js","sourceRoot":"","sources":["security.test.ts"],"names":[],"mappings":"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"}

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

@@ -3,9 +3,11 @@ import { UUID } from '../utils/uuid';
 
 import assert = require('assert');
 import Security from './security';
+import BondSecurity from './BondSecurity';
 
 import { DecimalValueProto } from '../../../fintekkers/models/util/decimal_value_pb';
 import { SecurityProto } from '../../../fintekkers/models/security/security_pb';
+import { SecurityTypeProto } from '../../../fintekkers/models/security/security_type_pb';
 import { CouponFrequencyProto } from '../../../fintekkers/models/security/coupon_frequency_pb';
 import { CouponTypeProto } from '../../../fintekkers/models/security/coupon_type_pb';
 import { SecurityQuantityTypeProto } from '../../../fintekkers/models/security/security_quantity_type_pb';
@@ -21,6 +23,52 @@ function testSerialization(): void {
     assert(security.getMaturityDate().toDate().getFullYear() == 2026);
 }
 
+test('equity routes to base Security and isBond() returns false', () => {
+    const equity = dummyEquity();
+    expect(equity).toBeInstanceOf(Security);
+    expect(equity).not.toBeInstanceOf(BondSecurity);
+    expect(equity.isBond()).toBe(false);
+});
+
+test('bond routes to BondSecurity and isBond() returns true (narrows type)', () => {
+    const bond = dummyBondSecurity();
+    expect(bond.isBond()).toBe(true);
+    if (bond.isBond()) {
+        // Inside the narrowed branch TS knows bond: BondSecurity.
+        // Calling a BondSecurity-only method here proves the narrowing works.
+        expect(bond.getCouponRate()).toBeDefined();
+    }
+});
+
+test('Security.getIssueDate returns null on equity (no throw)', () => {
+    const equity = dummyEquity();
+    // Phase 1 behavior change: was throw "Issue date is required", now returns null.
+    // This is the symptom fix that motivated #205 — equity wrappers no longer
+    // explode on per-record post-processing in ui-service.
+    expect(equity.getIssueDate()).toBeNull();
+});
+
+test('BondSecurity.getIssueDate returns LocalDate (non-nullable) on bond', () => {
+    const bond = dummyBondSecurity();
+    if (!bond.isBond()) throw new Error('test setup: expected bond');
+    const issueDate = bond.getIssueDate();
+    expect(issueDate).not.toBeNull();
+    expect(issueDate.toDate().getFullYear()).toBe(2021);
+});
+
+test('Security.getMaturityDate still throws on equity (Phase 1 deprecation, not removal)', () => {
+    const equity = dummyEquity();
+    // Behavior preserved deliberately for Phase 1 — callers still get a
+    // loud error if they don't narrow first. Removal happens in Phase 2.
+    expect(() => equity.getMaturityDate()).toThrow('Maturity date is required');
+});
+
+test('BondSecurity.getMaturityDate works on bond (inherited from Security)', () => {
+    const bond = dummyBondSecurity();
+    if (!bond.isBond()) throw new Error('test setup: expected bond');
+    expect(bond.getMaturityDate().toDate().getFullYear()).toBe(2026);
+});
+
 function dummySecurity() {
     return Security.create(new SecurityProto()
         .setObjectClass('Transaction').setVersion('0.0.1').setUuid(UUID.random().toUUIDProto())
@@ -39,3 +87,35 @@ function dummySecurity() {
     );
 }
 
+function dummyBondSecurity() {
+    // Same dummy security but with securityType set so the factory routes
+    // to BondSecurity.
+    return Security.create(new SecurityProto()
+        .setObjectClass('Security').setVersion('0.0.1').setUuid(UUID.random().toUUIDProto())
+        .setSecurityType(SecurityTypeProto.BOND_SECURITY)
+        .setFaceValue(new DecimalValueProto().setArbitraryPrecisionValue('1000.00'))
+        .setQuantityType(SecurityQuantityTypeProto.ORIGINAL_FACE_VALUE)
+        .setAssetClass("Bond")
+        .setIssuerName("Dummy issuer")
+        .setCouponRate(new DecimalValueProto().setArbitraryPrecisionValue('0.05'))
+        .setCouponFrequency(CouponFrequencyProto.SEMIANNUALLY)
+        .setCouponType(CouponTypeProto.FIXED)
+        .setMaturityDate(new LocalDateProto().setYear(2026).setMonth(1).setDay(1))
+        .setIssueDate(new LocalDateProto().setYear(2021).setMonth(1).setDay(1))
+        .setDescription("Dummy bond")
+    );
+}
+
+function dummyEquity() {
+    // Equity has no maturity / issue date in the proto, exercising the
+    // null-return behavior on getIssueDate and the throw-on-missing
+    // behavior on getMaturityDate.
+    return Security.create(new SecurityProto()
+        .setObjectClass('Security').setVersion('0.0.1').setUuid(UUID.random().toUUIDProto())
+        .setSecurityType(SecurityTypeProto.EQUITY_SECURITY)
+        .setAssetClass("Equity")
+        .setIssuerName("Dummy issuer Inc.")
+        .setDescription("Dummy equity")
+    );
+}
+

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

@@ -29,6 +29,25 @@ class Security {
     }
   }
 
+  /**
+   * Type guard: true iff this Security is a BondSecurity (BOND_SECURITY,
+   * TIPS, or FRN). Use to narrow before calling bond-specific getters:
+   *
+   *   if (sec.isBond()) {
+   *     // sec: BondSecurity here — TS knows about getCouponRate(), etc.
+   *     console.log(sec.getMaturityDate());
+   *   }
+   *
+   * Implemented as a runtime check on the proto's securityType so it
+   * works regardless of how the wrapper was constructed.
+   */
+  isBond(): this is import('./BondSecurity').default {
+    const t = this.proto.getSecurityType();
+    return t === SecurityTypeProto.BOND_SECURITY
+        || t === SecurityTypeProto.TIPS
+        || t === SecurityTypeProto.FRN;
+  }
+
 
   toString(): string {
     return `ID[${this.getID().toString()}], ${this.getSecurityID()}[${this.getIssuerName()}]`;
@@ -57,8 +76,11 @@ class Security {
       case FieldProto.ADJUSTED_TENOR:
         throw new Error('Not implemented yet');
       case FieldProto.MATURITY_DATE:
-        return this.getMaturityDate();
+        // Maturity date is bond-only. Mirror Java's Security.getField:
+        // delegate to BondSecurity, return null for non-bonds.
+        return this.isBond() ? this.getMaturityDate() : null;
       case FieldProto.ISSUE_DATE:
+        // getIssueDate already returns null on non-bonds; just forward.
         return this.getIssueDate();
       default:
         throw new Error(`Field not mapped in Security wrapper: ${field}`);
@@ -109,14 +131,36 @@ class Security {
     return identifier;
   }
 
-  getIssueDate(): LocalDate {
+  /**
+   * Returns the issue date if set, else null. Per-type semantic:
+   *   - Bond / TIPS / FRN: auction date.
+   *   - Equity: IPO listing date (when present in source data).
+   *   - CPI series: first observation date.
+   *   - Cash / FX: typically null.
+   *
+   * Returns null on equities/cash/etc. that don't have an issue date set,
+   * rather than throwing — issue date is optional on the base Security.
+   * For bond-specific code paths, prefer narrowing first via isBond() and
+   * calling BondSecurity.getIssueDate() (which returns LocalDate, not null).
+   */
+  getIssueDate(): LocalDate | null {
     // Prefer oneof bond sub-message if available, fall back to flat fields
     const bond = this.getBondLikeDetails();
     const date = bond ? bond.getIssueDate() : this.proto.getIssueDate();
-    if (!date) throw new Error("Issue date is required");
+    if (!date) return null;
     return new LocalDate(date);
   }
 
+  /**
+   * @deprecated Maturity date is a bond-only concept. On the base Security
+   * this still throws when unset for backwards compatibility. Prefer
+   * narrowing first:
+   *
+   *   if (sec.isBond()) sec.getMaturityDate();   // BondSecurity, returns LocalDate
+   *
+   * In a future major version this method will move to BondSecurity only
+   * and TS will catch the misuse at compile time.
+   */
   getMaturityDate(): LocalDate {
     // Prefer oneof bond sub-message if available, fall back to flat fields
     const bond = this.getBondLikeDetails();

package/package.json

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