@fintekkers/ledger-models 0.2.4 → 0.3.0

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const field_pb_1 = require("../../../fintekkers/models/position/field_pb");
+const security_pb_1 = require("../../../fintekkers/models/security/security_pb");
 const datetime_1 = require("../utils/datetime");
 const uuid_1 = require("../utils/uuid");
 const date_1 = require("../utils/date");
@@ -9,6 +10,58 @@ class Security {
     constructor(proto) {
         this.proto = proto;
     }
+    /**
+     * Build a SecurityProto link reference (is_link=true) with uuid and as_of
+     * populated. Use this whenever you embed a Security inside another message
+     * that itself carries an as_of (Position, Transaction, Price, etc.) — the
+     * link MUST carry the same as_of as the parent so the resolver hydrates
+     * the correct point-in-time vintage. See docs/adr/is_link_pattern.md.
+     *
+     * @param uuid The Security UUID to reference.
+     * @param asOf The as-of timestamp; required. For "always latest" semantics
+     *             use linkOfLatest(uuid) instead.
+     */
+    static linkOf(uuid, asOf) {
+        if (!uuid)
+            throw new Error("uuid is required for linkOf");
+        if (!asOf)
+            throw new Error("asOf is required for linkOf; use linkOfLatest(uuid) for latest-version semantics");
+        const proto = new security_pb_1.SecurityProto();
+        proto.setIsLink(true);
+        proto.setUuid(Security._uuidToProto(uuid));
+        proto.setAsOf(Security._zonedDateTimeToProto(asOf));
+        return proto;
+    }
+    /**
+     * Build a SecurityProto link reference (is_link=true) with only uuid set.
+     * Resolution returns the latest version. Explicit escape hatch — most
+     * callers should prefer linkOf(uuid, asOf).
+     */
+    static linkOfLatest(uuid) {
+        if (!uuid)
+            throw new Error("uuid is required for linkOfLatest");
+        const proto = new security_pb_1.SecurityProto();
+        proto.setIsLink(true);
+        proto.setUuid(Security._uuidToProto(uuid));
+        return proto;
+    }
+    static _uuidToProto(uuid) {
+        return uuid.toUUIDProto();
+    }
+    static _zonedDateTimeToProto(asOf) {
+        return asOf.toProto();
+    }
+    /**
+     * Throws if this Security is in link mode. Use to guard accessors that
+     * would otherwise return proto3 default values on a link reference.
+     */
+    assertNotLink(accessor) {
+        if (this.proto.getIsLink()) {
+            throw new Error(`Cannot read ${accessor} on a link-mode Security (is_link=true). `
+                + `Resolve via SecurityService.GetByIds first. `
+                + `See docs/adr/is_link_pattern.md.`);
+        }
+    }
     /**
      * Factory method to create the appropriate Security subclass based on security type
      */
@@ -98,17 +151,21 @@ class Security {
         return new datetime_1.ZonedDateTime(asOf);
     }
     getAssetClass() {
+        this.assertNotLink('assetClass');
         return this.proto.getAssetClass();
     }
     getProductClass() {
+        this.assertNotLink('productClass');
         throw new Error('Not implemented yet. See Java implementation for reference');
     }
     getProductType() {
+        this.assertNotLink('productType');
         const securityType = this.proto.getProductType();
         const securityTypeString = Object.keys(product_type_pb_1.ProductTypeProto).find(key => product_type_pb_1.ProductTypeProto[key] === securityType);
         return securityTypeString || 'UNKNOWN_SECURITY_TYPE';
     }
     getSecurityID() {
+        this.assertNotLink('securityId');
         const identifier = this.proto.getIdentifier();
         if (!identifier)
             throw new Error("Identifier is required");
@@ -127,6 +184,7 @@ class Security {
      * calling BondSecurity.getIssueDate() (which returns LocalDate, not null).
      */
     getIssueDate() {
+        this.assertNotLink('issueDate');
         // Prefer oneof bond sub-message if available, fall back to flat fields
         const bond = this.getBondLikeDetails();
         const date = bond ? bond.getIssueDate() : this.proto.getIssueDate();
@@ -145,6 +203,7 @@ class Security {
      * and TS will catch the misuse at compile time.
      */
     getMaturityDate() {
+        this.assertNotLink('maturityDate');
         // Prefer oneof bond sub-message if available, fall back to flat fields
         const bond = this.getBondLikeDetails();
         const date = bond ? bond.getMaturityDate() : this.proto.getMaturityDate();
@@ -153,22 +212,19 @@ class Security {
         return new date_1.LocalDate(date);
     }
     /**
-     * Returns the bond-like details sub-message from the oneof, if set.
-     * Works for BondDetails, TipsDetails, and FrnDetails (all share the same
-     * base bond fields: coupon_rate, maturity_date, etc.).
-     * Returns undefined if the oneof is not set or the proto doesn't support it
-     * (e.g. when JS codegen hasn't been updated).
+     * Returns the canonical bond_details sub-message if set, else undefined.
+     * v0.3.0 collapsed the prior 3-arm bond/tips/frn oneof into a single
+     * top-level bond_details — TIPS and FRN extras now live in their own
+     * tips_extension / frn_extension fields.
      */
     getBondLikeDetails() {
-        // Guard: check if the oneof accessor exists (JS codegen may be stale)
+        var _a;
         if (typeof this.proto.getBondDetails !== 'function')
             return undefined;
-        return this.proto.getBondDetails() ||
-            this.proto.getTipsDetails() ||
-            this.proto.getFrnDetails() ||
-            undefined;
+        return (_a = this.proto.getBondDetails()) !== null && _a !== void 0 ? _a : undefined;
     }
     getIssuerName() {
+        this.assertNotLink('issuerName');
         return this.proto.getIssuerName();
     }
     equals(other) {

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.ts

@@ -1,6 +1,8 @@
 import { FieldProto } from "../../../fintekkers/models/position/field_pb";
 import { IdentifierProto } from "../../../fintekkers/models/security/identifier/identifier_pb";
 import { SecurityProto } from "../../../fintekkers/models/security/security_pb";
+import { UUIDProto } from "../../../fintekkers/models/util/uuid_pb";
+import { LocalTimestampProto } from "../../../fintekkers/models/util/local_timestamp_pb";
 import { ZonedDateTime } from "../utils/datetime";
 import { UUID } from "../utils/uuid";
 import { LocalDate } from "../utils/date";
@@ -13,6 +15,62 @@ class Security {
     this.proto = proto;
   }
 
+  /**
+   * Build a SecurityProto link reference (is_link=true) with uuid and as_of
+   * populated. Use this whenever you embed a Security inside another message
+   * that itself carries an as_of (Position, Transaction, Price, etc.) — the
+   * link MUST carry the same as_of as the parent so the resolver hydrates
+   * the correct point-in-time vintage. See docs/adr/is_link_pattern.md.
+   *
+   * @param uuid The Security UUID to reference.
+   * @param asOf The as-of timestamp; required. For "always latest" semantics
+   *             use linkOfLatest(uuid) instead.
+   */
+  static linkOf(uuid: UUID, asOf: ZonedDateTime): SecurityProto {
+    if (!uuid) throw new Error("uuid is required for linkOf");
+    if (!asOf) throw new Error("asOf is required for linkOf; use linkOfLatest(uuid) for latest-version semantics");
+    const proto = new SecurityProto();
+    proto.setIsLink(true);
+    proto.setUuid(Security._uuidToProto(uuid));
+    proto.setAsOf(Security._zonedDateTimeToProto(asOf));
+    return proto;
+  }
+
+  /**
+   * Build a SecurityProto link reference (is_link=true) with only uuid set.
+   * Resolution returns the latest version. Explicit escape hatch — most
+   * callers should prefer linkOf(uuid, asOf).
+   */
+  static linkOfLatest(uuid: UUID): SecurityProto {
+    if (!uuid) throw new Error("uuid is required for linkOfLatest");
+    const proto = new SecurityProto();
+    proto.setIsLink(true);
+    proto.setUuid(Security._uuidToProto(uuid));
+    return proto;
+  }
+
+  private static _uuidToProto(uuid: UUID): UUIDProto {
+    return uuid.toUUIDProto();
+  }
+
+  private static _zonedDateTimeToProto(asOf: ZonedDateTime): LocalTimestampProto {
+    return asOf.toProto();
+  }
+
+  /**
+   * Throws if this Security is in link mode. Use to guard accessors that
+   * would otherwise return proto3 default values on a link reference.
+   */
+  private assertNotLink(accessor: string): void {
+    if (this.proto.getIsLink()) {
+      throw new Error(
+        `Cannot read ${accessor} on a link-mode Security (is_link=true). `
+        + `Resolve via SecurityService.GetByIds first. `
+        + `See docs/adr/is_link_pattern.md.`
+      );
+    }
+  }
+
   /**
    * Factory method to create the appropriate Security subclass based on security type
    */
@@ -109,14 +167,17 @@ class Security {
   }
 
   getAssetClass(): string {
+    this.assertNotLink('assetClass');
     return this.proto.getAssetClass();
   }
 
   getProductClass(): string {
+    this.assertNotLink('productClass');
     throw new Error('Not implemented yet. See Java implementation for reference');
   }
 
   getProductType(): string {
+    this.assertNotLink('productType');
     const securityType = this.proto.getProductType();
     const securityTypeString = (Object.keys(ProductTypeProto) as Array<keyof typeof ProductTypeProto>).find(
       key => ProductTypeProto[key] === securityType
@@ -126,6 +187,7 @@ class Security {
   }
 
   getSecurityID(): IdentifierProto {
+    this.assertNotLink('securityId');
     const identifier = this.proto.getIdentifier();
     if (!identifier) throw new Error("Identifier is required");
     return identifier;
@@ -144,6 +206,7 @@ class Security {
    * calling BondSecurity.getIssueDate() (which returns LocalDate, not null).
    */
   getIssueDate(): LocalDate | null {
+    this.assertNotLink('issueDate');
     // Prefer oneof bond sub-message if available, fall back to flat fields
     const bond = this.getBondLikeDetails();
     const date = bond ? bond.getIssueDate() : this.proto.getIssueDate();
@@ -162,6 +225,7 @@ class Security {
    * and TS will catch the misuse at compile time.
    */
   getMaturityDate(): LocalDate {
+    this.assertNotLink('maturityDate');
     // Prefer oneof bond sub-message if available, fall back to flat fields
     const bond = this.getBondLikeDetails();
     const date = bond ? bond.getMaturityDate() : this.proto.getMaturityDate();
@@ -170,23 +234,18 @@ class Security {
   }
 
   /**
-   * Returns the bond-like details sub-message from the oneof, if set.
-   * Works for BondDetails, TipsDetails, and FrnDetails (all share the same
-   * base bond fields: coupon_rate, maturity_date, etc.).
-   * Returns undefined if the oneof is not set or the proto doesn't support it
-   * (e.g. when JS codegen hasn't been updated).
+   * Returns the canonical bond_details sub-message if set, else undefined.
+   * v0.3.0 collapsed the prior 3-arm bond/tips/frn oneof into a single
+   * top-level bond_details — TIPS and FRN extras now live in their own
+   * tips_extension / frn_extension fields.
    */
   protected getBondLikeDetails(): any | undefined {
-    // Guard: check if the oneof accessor exists (JS codegen may be stale)
     if (typeof this.proto.getBondDetails !== 'function') return undefined;
-
-    return this.proto.getBondDetails() ||
-           this.proto.getTipsDetails() ||
-           this.proto.getFrnDetails() ||
-           undefined;
+    return this.proto.getBondDetails() ?? undefined;
   }
 
   getIssuerName(): string {
+    this.assertNotLink('issuerName');
     return this.proto.getIssuerName();
   }
 

package/package.json

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

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

@@ -1,31 +0,0 @@
-// package: fintekkers.models.security
-// file: fintekkers/models/security/security_id.proto
-
-/* tslint:disable */
-/* eslint-disable */
-
-import * as jspb from "google-protobuf";
-import * as fintekkers_models_util_uuid_pb from "../../../fintekkers/models/util/uuid_pb";
-
-export class SecurityIdProto extends jspb.Message { 
-
-    hasUuid(): boolean;
-    clearUuid(): void;
-    getUuid(): fintekkers_models_util_uuid_pb.UUIDProto | undefined;
-    setUuid(value?: fintekkers_models_util_uuid_pb.UUIDProto): SecurityIdProto;
-
-    serializeBinary(): Uint8Array;
-    toObject(includeInstance?: boolean): SecurityIdProto.AsObject;
-    static toObject(includeInstance: boolean, msg: SecurityIdProto): SecurityIdProto.AsObject;
-    static extensions: {[key: number]: jspb.ExtensionFieldInfo<jspb.Message>};
-    static extensionsBinary: {[key: number]: jspb.ExtensionFieldBinaryInfo<jspb.Message>};
-    static serializeBinaryToWriter(message: SecurityIdProto, writer: jspb.BinaryWriter): void;
-    static deserializeBinary(bytes: Uint8Array): SecurityIdProto;
-    static deserializeBinaryFromReader(message: SecurityIdProto, reader: jspb.BinaryReader): SecurityIdProto;
-}
-
-export namespace SecurityIdProto {
-    export type AsObject = {
-        uuid?: fintekkers_models_util_uuid_pb.UUIDProto.AsObject,
-    }
-}

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

@@ -1,199 +0,0 @@
-// source: fintekkers/models/security/security_id.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));
-
-var fintekkers_models_util_uuid_pb = require('../../../fintekkers/models/util/uuid_pb.js');
-goog.object.extend(proto, fintekkers_models_util_uuid_pb);
-goog.exportSymbol('proto.fintekkers.models.security.SecurityIdProto', null, global);
-/**
- * Generated by JsPbCodeGenerator.
- * @param {Array=} opt_data Optional initial data array, typically from a
- * server response, or constructed directly in Javascript. The array is used
- * in place and becomes part of the constructed object. It is not cloned.
- * If no data is provided, the constructed object will be empty, but still
- * valid.
- * @extends {jspb.Message}
- * @constructor
- */
-proto.fintekkers.models.security.SecurityIdProto = function(opt_data) {
-  jspb.Message.initialize(this, opt_data, 0, -1, null, null);
-};
-goog.inherits(proto.fintekkers.models.security.SecurityIdProto, jspb.Message);
-if (goog.DEBUG && !COMPILED) {
-  /**
-   * @public
-   * @override
-   */
-  proto.fintekkers.models.security.SecurityIdProto.displayName = 'proto.fintekkers.models.security.SecurityIdProto';
-}
-
-
-
-if (jspb.Message.GENERATE_TO_OBJECT) {
-/**
- * Creates an object representation of this proto.
- * Field names that are reserved in JavaScript and will be renamed to pb_name.
- * Optional fields that are not set will be set to undefined.
- * To access a reserved field use, foo.pb_<name>, eg, foo.pb_default.
- * For the list of reserved names please see:
- *     net/proto2/compiler/js/internal/generator.cc#kKeyword.
- * @param {boolean=} opt_includeInstance Deprecated. whether to include the
- *     JSPB instance for transitional soy proto support:
- *     http://goto/soy-param-migration
- * @return {!Object}
- */
-proto.fintekkers.models.security.SecurityIdProto.prototype.toObject = function(opt_includeInstance) {
-  return proto.fintekkers.models.security.SecurityIdProto.toObject(opt_includeInstance, this);
-};
-
-
-/**
- * Static version of the {@see toObject} method.
- * @param {boolean|undefined} includeInstance Deprecated. Whether to include
- *     the JSPB instance for transitional soy proto support:
- *     http://goto/soy-param-migration
- * @param {!proto.fintekkers.models.security.SecurityIdProto} msg The msg instance to transform.
- * @return {!Object}
- * @suppress {unusedLocalVariables} f is only used for nested messages
- */
-proto.fintekkers.models.security.SecurityIdProto.toObject = function(includeInstance, msg) {
-  var f, obj = {
-    uuid: (f = msg.getUuid()) && fintekkers_models_util_uuid_pb.UUIDProto.toObject(includeInstance, f)
-  };
-
-  if (includeInstance) {
-    obj.$jspbMessageInstance = msg;
-  }
-  return obj;
-};
-}
-
-
-/**
- * Deserializes binary data (in protobuf wire format).
- * @param {jspb.ByteSource} bytes The bytes to deserialize.
- * @return {!proto.fintekkers.models.security.SecurityIdProto}
- */
-proto.fintekkers.models.security.SecurityIdProto.deserializeBinary = function(bytes) {
-  var reader = new jspb.BinaryReader(bytes);
-  var msg = new proto.fintekkers.models.security.SecurityIdProto;
-  return proto.fintekkers.models.security.SecurityIdProto.deserializeBinaryFromReader(msg, reader);
-};
-
-
-/**
- * Deserializes binary data (in protobuf wire format) from the
- * given reader into the given message object.
- * @param {!proto.fintekkers.models.security.SecurityIdProto} msg The message object to deserialize into.
- * @param {!jspb.BinaryReader} reader The BinaryReader to use.
- * @return {!proto.fintekkers.models.security.SecurityIdProto}
- */
-proto.fintekkers.models.security.SecurityIdProto.deserializeBinaryFromReader = function(msg, reader) {
-  while (reader.nextField()) {
-    if (reader.isEndGroup()) {
-      break;
-    }
-    var field = reader.getFieldNumber();
-    switch (field) {
-    case 1:
-      var value = new fintekkers_models_util_uuid_pb.UUIDProto;
-      reader.readMessage(value,fintekkers_models_util_uuid_pb.UUIDProto.deserializeBinaryFromReader);
-      msg.setUuid(value);
-      break;
-    default:
-      reader.skipField();
-      break;
-    }
-  }
-  return msg;
-};
-
-
-/**
- * Serializes the message to binary data (in protobuf wire format).
- * @return {!Uint8Array}
- */
-proto.fintekkers.models.security.SecurityIdProto.prototype.serializeBinary = function() {
-  var writer = new jspb.BinaryWriter();
-  proto.fintekkers.models.security.SecurityIdProto.serializeBinaryToWriter(this, writer);
-  return writer.getResultBuffer();
-};
-
-
-/**
- * Serializes the given message to binary data (in protobuf wire
- * format), writing to the given BinaryWriter.
- * @param {!proto.fintekkers.models.security.SecurityIdProto} message
- * @param {!jspb.BinaryWriter} writer
- * @suppress {unusedLocalVariables} f is only used for nested messages
- */
-proto.fintekkers.models.security.SecurityIdProto.serializeBinaryToWriter = function(message, writer) {
-  var f = undefined;
-  f = message.getUuid();
-  if (f != null) {
-    writer.writeMessage(
-      1,
-      f,
-      fintekkers_models_util_uuid_pb.UUIDProto.serializeBinaryToWriter
-    );
-  }
-};
-
-
-/**
- * optional fintekkers.models.util.UUIDProto uuid = 1;
- * @return {?proto.fintekkers.models.util.UUIDProto}
- */
-proto.fintekkers.models.security.SecurityIdProto.prototype.getUuid = function() {
-  return /** @type{?proto.fintekkers.models.util.UUIDProto} */ (
-    jspb.Message.getWrapperField(this, fintekkers_models_util_uuid_pb.UUIDProto, 1));
-};
-
-
-/**
- * @param {?proto.fintekkers.models.util.UUIDProto|undefined} value
- * @return {!proto.fintekkers.models.security.SecurityIdProto} returns this
-*/
-proto.fintekkers.models.security.SecurityIdProto.prototype.setUuid = function(value) {
-  return jspb.Message.setWrapperField(this, 1, value);
-};
-
-
-/**
- * Clears the message field making it undefined.
- * @return {!proto.fintekkers.models.security.SecurityIdProto} returns this
- */
-proto.fintekkers.models.security.SecurityIdProto.prototype.clearUuid = function() {
-  return this.setUuid(undefined);
-};
-
-
-/**
- * Returns whether this field is set.
- * @return {boolean}
- */
-proto.fintekkers.models.security.SecurityIdProto.prototype.hasUuid = function() {
-  return jspb.Message.getField(this, 1) != null;
-};
-
-
-goog.object.extend(exports, proto.fintekkers.models.security);