npm - @fintekkers/ledger-models - Versions diffs - 0.4.5 → 0.4.9 - Mend

@fintekkers/ledger-models 0.4.5 → 0.4.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (22) hide show

package/node/fintekkers/models/transaction/transaction_type_pb.d.ts CHANGED Viewed

@@ -14,4 +14,6 @@ export enum TransactionTypeProto {
     WITHDRAWAL = 4,
     MATURATION = 5,
     MATURATION_OFFSET = 6,
+    PRINCIPAL_PAYDOWN = 7,
+    PRINCIPAL_PAYDOWN_OFFSET = 8,
 }

package/node/fintekkers/models/transaction/transaction_type_pb.js CHANGED Viewed

@@ -32,7 +32,9 @@ proto.fintekkers.models.transaction.TransactionTypeProto = {
   DEPOSIT: 3,
   WITHDRAWAL: 4,
   MATURATION: 5,
-  MATURATION_OFFSET: 6
+  MATURATION_OFFSET: 6,
+  PRINCIPAL_PAYDOWN: 7,
+  PRINCIPAL_PAYDOWN_OFFSET: 8
 };
 goog.object.extend(exports, proto.fintekkers.models.transaction);

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

@@ -28,10 +28,16 @@ declare class Security {
     private static _uuidToProto;
     private static _zonedDateTimeToProto;
     /**
-     * Throws if this Security is in link mode. Use to guard accessors that
-     * would otherwise return proto3 default values on a link reference.
+     * Lazy hydration. If this Security is in link mode, swap in the resolved
+     * proto from LinkCache. On cache miss, throws — caller must pre-warm via
+     * LinkResolver. See docs/adr/lazy-link-hydration.md.
+     *
+     * TS variant is cache-only (no fetcher hook) because the gRPC stubs are
+     * async and chaining the resolver into every getter would force every
+     * accessor to become async. Pre-warming through LinkResolver keeps the
+     * sync getter API.
      */
-    private assertNotLink;
+    private ensureHydrated;
     /**
      * Factory method to create the appropriate Security subclass based on
      * the proto's product_type. Dispatch rules:

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

@@ -1,4 +1,27 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 const field_pb_1 = require("../../../fintekkers/models/position/field_pb");
 const security_pb_1 = require("../../../fintekkers/models/security/security_pb");
@@ -8,6 +31,7 @@ const date_1 = require("../utils/date");
 const product_type_pb_1 = require("../../../fintekkers/models/security/product_type_pb");
 const identifier_1 = require("./identifier");
 const product_hierarchy_1 = require("./product_hierarchy");
+const LinkCacheModule = __importStar(require("../../util/link-cache"));
 class Security {
     constructor(proto) {
         this.proto = proto;
@@ -54,15 +78,33 @@ class Security {
         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.
+     * Lazy hydration. If this Security is in link mode, swap in the resolved
+     * proto from LinkCache. On cache miss, throws — caller must pre-warm via
+     * LinkResolver. See docs/adr/lazy-link-hydration.md.
+     *
+     * TS variant is cache-only (no fetcher hook) because the gRPC stubs are
+     * async and chaining the resolver into every getter would force every
+     * accessor to become async. Pre-warming through LinkResolver keeps the
+     * sync getter API.
      */
-    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.`);
+    ensureHydrated() {
+        if (!this.proto.getIsLink())
+            return;
+        const uuidProto = this.proto.getUuid();
+        if (!uuidProto) {
+            throw new Error("Cannot read fields on link-mode Security with no UUID set.");
+        }
+        const uuidKey = uuid_1.UUID.fromU8Array(uuidProto.getRawUuid_asU8()).toString();
+        const asOfProto = this.proto.getAsOf();
+        const asOf = asOfProto ? new datetime_1.ZonedDateTime(asOfProto) : null;
+        const cached = LinkCacheModule.SECURITY.get(uuidKey, asOf);
+        if (cached) {
+            this.proto = cached;
+            return;
         }
+        throw new Error(`Cannot read fields on link-mode Security uuid=${uuidKey} `
+            + `— LinkCache miss. Pre-warm via LinkResolver. `
+            + `See docs/adr/lazy-link-hydration.md.`);
     }
     /**
      * Factory method to create the appropriate Security subclass based on
@@ -236,15 +278,15 @@ class Security {
         return new datetime_1.ZonedDateTime(asOf);
     }
     getAssetClass() {
-        this.assertNotLink('assetClass');
+        this.ensureHydrated();
         return this.proto.getAssetClass();
     }
     getProductClass() {
-        this.assertNotLink('productClass');
+        this.ensureHydrated();
         throw new Error('Not implemented yet. See Java implementation for reference');
     }
     getProductType() {
-        this.assertNotLink('productType');
+        this.ensureHydrated();
         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';
@@ -254,7 +296,7 @@ class Security {
      * Empty list if none are set. Throws on a link-mode Security.
      */
     getIdentifiers() {
-        this.assertNotLink('identifiers');
+        this.ensureHydrated();
         const list = this.proto.getIdentifiersList();
         if (!list)
             return [];
@@ -265,7 +307,7 @@ class Security {
      * or undefined if none is present. Throws on a link-mode Security.
      */
     getIdentifierByType(type) {
-        this.assertNotLink('identifierByType');
+        this.ensureHydrated();
         const list = this.proto.getIdentifiersList();
         if (!list)
             return undefined;
@@ -286,7 +328,7 @@ class Security {
      * properly-formed bond).
      */
     getIssueDate() {
-        this.assertNotLink('issueDate');
+        this.ensureHydrated();
         const bond = this.getBondLikeDetails();
         const date = bond ? bond.getIssueDate() : undefined;
         return (0, date_1.localDateProtoToDate)(date);
@@ -298,7 +340,7 @@ class Security {
      * code paths.
      */
     getMaturityDate() {
-        this.assertNotLink('maturityDate');
+        this.ensureHydrated();
         const bond = this.getBondLikeDetails();
         const date = bond ? bond.getMaturityDate() : undefined;
         return (0, date_1.localDateProtoToDate)(date);
@@ -315,7 +357,7 @@ class Security {
         return (_a = this.proto.getBondDetails()) !== null && _a !== void 0 ? _a : undefined;
     }
     getIssuerName() {
-        this.assertNotLink('issuerName');
+        this.ensureHydrated();
         return this.proto.getIssuerName();
     }
     /**

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

	@@ -1 +1 @@
1	- {"version":3,"file":"security.js","sourceRoot":"","sources":["security.ts"],"names":[],"mappings":";;AAAA,2EAA0E;AAC1E,iFAAgF;AAGhF,gDAAkD;AAClD,wCAAqC;AACrC,wCAAqD;AACrD,yFAAuF;AAEvF,6CAA0C;AAC1C,2DAAqD;~~AAErD~~,MAAM,QAAQ;IAGZ,YAAY,KAAoB;QAC9B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAM,CAAC,IAAU,EAAE,IAAmB;QAC3C,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;QAC/G,MAAM,KAAK,GAAG,IAAI,2BAAa,EAAE,CAAC;QAClC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtB,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;QACpD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,IAAU;QAC5B,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,IAAI,2BAAa,EAAE,CAAC;QAClC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtB,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,MAAM,CAAC,YAAY,CAAC,IAAU;QACpC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;IAEO,MAAM,CAAC,qBAAqB,CAAC,IAAmB;QACtD,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;IAED~~;;;OAGG~~;IACK,~~aAAa~~,CAAC,~~QAAgB~~;QACpC,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE;~~YAC1B~~,MAAM,IAAI,KAAK,~~CACb~~,eAAe,QAAQ,~~2CAA2C~~;~~kBAChE~~,~~8CAA8C~~;~~kBAC9C~~,~~kCAAkC~~,~~CACrC~~,CAAC;~~SACH~~;~~IACH~~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~~aAAa~~,~~CAAC~~,~~YAAY,~~CAAC~~,CAAC~~;~~QACjC~~,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;IACpC,CAAC;IAED,eAAe;QACb,IAAI,CAAC,~~aAAa,CAAC,~~cAAc,~~CAAC~~,CAAC;~~QACnC~~,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,~~aAAa~~,~~CAAC~~,~~aAAa,~~CAAC~~,CAAC~~;~~QAClC~~,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QACjD,MAAM,kBAAkB,GAAI,MAAM,CAAC,IAAI,CAAC,kCAAgB,CAA0C,CAAC,IAAI,CACrG,GAAG,CAAC,EAAE,CAAC,kCAAgB,CAAC,GAAG,CAAC,KAAK,YAAY,CAC9C,CAAC;QAEF,OAAO,kBAAkB,IAAI,uBAAuB,CAAC;IACvD,CAAC;IAED;;;OAGG;IACH,cAAc;QACZ,IAAI,CAAC,~~aAAa~~,~~CAAC~~,~~aAAa,~~CAAC~~,CAAC~~;~~QAClC~~,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC;QAC7C,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,uBAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,mBAAmB,CAAC,IAAyB;QAC3C,IAAI,CAAC,~~aAAa~~,~~CAAC~~,~~kBAAkB,~~CAAC~~,CAAC~~;~~QACvC~~,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC;QAC7C,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,EAAE,KAAK,IAAI,CAAC,CAAC;QAC7D,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,uBAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACnD,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,YAAY;QACV,IAAI,CAAC,~~aAAa~~,~~CAAC~~,~~WAAW,~~CAAC~~,CAAC~~;~~QAChC~~,MAAM,IAAI,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACpD,OAAO,IAAA,2BAAoB,EAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACH,eAAe;QACb,IAAI,CAAC,~~aAAa,CAAC,~~cAAc,~~CAAC~~,CAAC;~~QACnC~~,MAAM,IAAI,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACvD,OAAO,IAAA,2BAAoB,EAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACO,kBAAkB;;QAC1B,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,KAAK,UAAU;YAAE,OAAO,SAAS,CAAC;QACtE,OAAO,MAAA,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,mCAAI,SAAS,CAAC;IAClD,CAAC;IAED,aAAa;QACX,IAAI,CAAC,~~aAAa~~,~~CAAC~~,~~YAAY,~~CAAC~~,CAAC~~;~~QACjC~~,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;IACpC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,OAAa,IAAI,IAAI,EAAE;QAC/B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE;YAAE,OAAO,KAAK,CAAC;QAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QAC7C,IAAI,CAAC,YAAY;YAAE,OAAO,KAAK,CAAC;QAChC,MAAM,EAAE,GAAG,YAAY,CAAC,YAAY,EAAE,CAAC;QACvC,IAAI,CAAC,EAAE;YAAE,OAAO,KAAK,CAAC;QACtB,MAAM,SAAS,GAAG,EAAE,CAAC,UAAU,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,GAAG,CAAC,CAAC;QAC3E,OAAO,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,KAAe;QACpB,IAAI,KAAK,YAAY,QAAQ,EAAE;YAC7B,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;SAC3C;aAAM;YACL,OAAO,KAAK,CAAC;SACd;IACH,CAAC;CACF;AAED,kBAAe,QAAQ,CAAC"}
1	+ {"version":3,"file":"security.js","sourceRoot":"","sources":["security.ts"],"names":[],"mappings":"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"}

package/node/wrappers/models/security/security.lazy-hydrate.test.d.ts ADDED Viewed

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

package/node/wrappers/models/security/security.lazy-hydrate.test.js ADDED Viewed

@@ -0,0 +1,127 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const security_1 = __importDefault(require("./security"));
+const uuid_1 = require("../utils/uuid");
+const datetime_1 = require("../utils/datetime");
+const LinkCache = __importStar(require("../../util/link-cache"));
+const security_pb_1 = require("../../../fintekkers/models/security/security_pb");
+const local_timestamp_pb_1 = require("../../../fintekkers/models/util/local_timestamp_pb");
+const timestamp_pb_1 = require("google-protobuf/google/protobuf/timestamp_pb");
+function makeAsOf(epochSecondsOffset = 0) {
+    const ts = new timestamp_pb_1.Timestamp();
+    ts.setSeconds(1700000000 + epochSecondsOffset);
+    ts.setNanos(0);
+    const proto = new local_timestamp_pb_1.LocalTimestampProto();
+    proto.setTimestamp(ts);
+    proto.setTimeZone('UTC');
+    return new datetime_1.ZonedDateTime(proto);
+}
+function makeFullProto(uuid, asOf, issuer = 'ACME') {
+    const p = new security_pb_1.SecurityProto();
+    p.setUuid(uuid.toUUIDProto());
+    p.setAsOf(asOf.toProto());
+    p.setIssuerName(issuer);
+    p.setAssetClass('Equity');
+    return p;
+}
+describe('Security lazy hydrate', () => {
+    beforeEach(() => {
+        LinkCache.SECURITY.clear();
+    });
+    // ---- A. Hydration on accessors ----
+    test('A — getAssetClass on link-mode wrapper hydrates from cache', () => {
+        const uuid = uuid_1.UUID.fromU8Array(new Uint8Array(16).fill(0x42));
+        const asOf = makeAsOf();
+        const resolved = makeFullProto(uuid, asOf, 'ACME-resolved');
+        LinkCache.SECURITY.put(uuid.toString(), resolved, asOf);
+        const wrapper = new security_1.default(security_1.default.linkOf(uuid, asOf));
+        expect(wrapper.isLink()).toBe(true);
+        expect(wrapper.getAssetClass()).toBe('Equity');
+        // After first accessor, wrapper has swapped in the resolved proto.
+        expect(wrapper.proto.getIsLink()).toBe(false);
+    });
+    test('A — link-safe accessors do not require hydration', () => {
+        const uuid = uuid_1.UUID.fromU8Array(new Uint8Array(16).fill(0x07));
+        const asOf = makeAsOf();
+        // Cache is empty — link-safe accessors must still work.
+        const wrapper = new security_1.default(security_1.default.linkOf(uuid, asOf));
+        expect(wrapper.isLink()).toBe(true);
+        expect(wrapper.getID().toString()).toBe(uuid.toString());
+        expect(wrapper.getAsOf().getSeconds()).toBe(asOf.getSeconds());
+    });
+    // ---- B. Cache behavior ----
+    test('B.i — first accessor call hydrates from a pre-populated cache', () => {
+        const uuid = uuid_1.UUID.fromU8Array(new Uint8Array(16).fill(0x01));
+        const asOf = makeAsOf();
+        const resolved = makeFullProto(uuid, asOf, 'hydrated');
+        LinkCache.SECURITY.put(uuid.toString(), resolved, asOf);
+        const wrapper = new security_1.default(security_1.default.linkOf(uuid, asOf));
+        expect(wrapper.getIssuerName()).toBe('hydrated');
+    });
+    test('B.ii — second accessor call hits the swapped proto, not the cache', () => {
+        const uuid = uuid_1.UUID.fromU8Array(new Uint8Array(16).fill(0x02));
+        const asOf = makeAsOf();
+        const resolved = makeFullProto(uuid, asOf, 'firstRead');
+        LinkCache.SECURITY.put(uuid.toString(), resolved, asOf);
+        const wrapper = new security_1.default(security_1.default.linkOf(uuid, asOf));
+        expect(wrapper.getAssetClass()).toBe('Equity');
+        // Evict the cache; wrapper has already swapped in the proto so the
+        // second read must succeed without touching the cache.
+        LinkCache.SECURITY.evict(uuid.toString());
+        expect(wrapper.getIssuerName()).toBe('firstRead');
+    });
+    test('B.iii — fresh wrapper for same (uuid, asOf) reads cache populated by prior wrapper', () => {
+        const uuid = uuid_1.UUID.fromU8Array(new Uint8Array(16).fill(0x03));
+        const asOf = makeAsOf();
+        const resolved = makeFullProto(uuid, asOf, 'shared');
+        LinkCache.SECURITY.put(uuid.toString(), resolved, asOf);
+        // Two independent wrappers share the cache entry.
+        const wrapperA = new security_1.default(security_1.default.linkOf(uuid, asOf));
+        const wrapperB = new security_1.default(security_1.default.linkOf(uuid, asOf));
+        expect(wrapperA.getIssuerName()).toBe('shared');
+        expect(wrapperB.getIssuerName()).toBe('shared');
+    });
+    // ---- C. asOf semantics ----
+    test('C — link asOf differing from cached asOf is a miss', () => {
+        const uuid = uuid_1.UUID.fromU8Array(new Uint8Array(16).fill(0x04));
+        const asOfT1 = makeAsOf(0);
+        const asOfT2 = makeAsOf(86400);
+        LinkCache.SECURITY.put(uuid.toString(), makeFullProto(uuid, asOfT2, 'T2'), asOfT2);
+        const wrapper = new security_1.default(security_1.default.linkOf(uuid, asOfT1));
+        expect(() => wrapper.getIssuerName()).toThrow(/LinkCache miss/);
+    });
+    // ---- D. Resolve failure ----
+    test('D — cache miss throws with uuid in message', () => {
+        const uuid = uuid_1.UUID.fromU8Array(new Uint8Array(16).fill(0x05));
+        const asOf = makeAsOf();
+        const wrapper = new security_1.default(security_1.default.linkOf(uuid, asOf));
+        expect(() => wrapper.getAssetClass()).toThrow(new RegExp(uuid.toString()));
+    });
+});
+//# sourceMappingURL=security.lazy-hydrate.test.js.map

package/node/wrappers/models/security/security.lazy-hydrate.test.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"security.lazy-hydrate.test.js","sourceRoot":"","sources":["security.lazy-hydrate.test.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,0DAAkC;AAClC,wCAAqC;AACrC,gDAAkD;AAElD,iEAAmD;AAEnD,iFAAgF;AAChF,2FAAyF;AACzF,+EAAyE;AAEzE,SAAS,QAAQ,CAAC,qBAA6B,CAAC;IAC9C,MAAM,EAAE,GAAG,IAAI,wBAAS,EAAE,CAAC;IAC3B,EAAE,CAAC,UAAU,CAAC,UAAU,GAAG,kBAAkB,CAAC,CAAC;IAC/C,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACf,MAAM,KAAK,GAAG,IAAI,wCAAmB,EAAE,CAAC;IACxC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACvB,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACzB,OAAO,IAAI,wBAAa,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,aAAa,CAAC,IAAU,EAAE,IAAmB,EAAE,MAAM,GAAG,MAAM;IACrE,MAAM,CAAC,GAAG,IAAI,2BAAa,EAAE,CAAC;IAC9B,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9B,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1B,OAAO,CAAC,CAAC;AACX,CAAC;AAED,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,UAAU,CAAC,GAAG,EAAE;QACd,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,sCAAsC;IAEtC,IAAI,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACtE,MAAM,IAAI,GAAG,WAAI,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;QAC5D,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAExD,MAAM,OAAO,GAAG,IAAI,kBAAQ,CAAC,kBAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEpC,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/C,mEAAmE;QACnE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC5D,MAAM,IAAI,GAAG,WAAI,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;QACxB,wDAAwD;QACxD,MAAM,OAAO,GAAG,IAAI,kBAAQ,CAAC,kBAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAE1D,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACzD,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,8BAA8B;IAE9B,IAAI,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACzE,MAAM,IAAI,GAAG,WAAI,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACvD,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAExD,MAAM,OAAO,GAAG,IAAI,kBAAQ,CAAC,kBAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC7E,MAAM,IAAI,GAAG,WAAI,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QACxD,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAExD,MAAM,OAAO,GAAG,IAAI,kBAAQ,CAAC,kBAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE/C,mEAAmE;QACnE,uDAAuD;QACvD,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,oFAAoF,EAAE,GAAG,EAAE;QAC9F,MAAM,IAAI,GAAG,WAAI,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACrD,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAExD,kDAAkD;QAClD,MAAM,QAAQ,GAAG,IAAI,kBAAQ,CAAC,kBAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,IAAI,kBAAQ,CAAC,kBAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC3D,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,8BAA8B;IAE9B,IAAI,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC9D,MAAM,IAAI,GAAG,WAAI,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QAEnF,MAAM,OAAO,GAAG,IAAI,kBAAQ,CAAC,kBAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5D,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,+BAA+B;IAE/B,IAAI,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACtD,MAAM,IAAI,GAAG,WAAI,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,IAAI,kBAAQ,CAAC,kBAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAE1D,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/node/wrappers/models/security/security.lazy-hydrate.test.ts ADDED Viewed

@@ -0,0 +1,123 @@
+import Security from './security';
+import { UUID } from '../utils/uuid';
+import { ZonedDateTime } from '../utils/datetime';
+import * as LinkCache from '../../util/link-cache';
+import { SecurityProto } from '../../../fintekkers/models/security/security_pb';
+import { LocalTimestampProto } from '../../../fintekkers/models/util/local_timestamp_pb';
+import { Timestamp } from 'google-protobuf/google/protobuf/timestamp_pb';
+function makeAsOf(epochSecondsOffset: number = 0): ZonedDateTime {
+  const ts = new Timestamp();
+  ts.setSeconds(1700000000 + epochSecondsOffset);
+  ts.setNanos(0);
+  const proto = new LocalTimestampProto();
+  proto.setTimestamp(ts);
+  proto.setTimeZone('UTC');
+  return new ZonedDateTime(proto);
+}
+function makeFullProto(uuid: UUID, asOf: ZonedDateTime, issuer = 'ACME'): SecurityProto {
+  const p = new SecurityProto();
+  p.setUuid(uuid.toUUIDProto());
+  p.setAsOf(asOf.toProto());
+  p.setIssuerName(issuer);
+  p.setAssetClass('Equity');
+  return p;
+}
+describe('Security lazy hydrate', () => {
+  beforeEach(() => {
+    LinkCache.SECURITY.clear();
+  });
+  // ---- A. Hydration on accessors ----
+  test('A — getAssetClass on link-mode wrapper hydrates from cache', () => {
+    const uuid = UUID.fromU8Array(new Uint8Array(16).fill(0x42));
+    const asOf = makeAsOf();
+    const resolved = makeFullProto(uuid, asOf, 'ACME-resolved');
+    LinkCache.SECURITY.put(uuid.toString(), resolved, asOf);
+    const wrapper = new Security(Security.linkOf(uuid, asOf));
+    expect(wrapper.isLink()).toBe(true);
+    expect(wrapper.getAssetClass()).toBe('Equity');
+    // After first accessor, wrapper has swapped in the resolved proto.
+    expect(wrapper.proto.getIsLink()).toBe(false);
+  });
+  test('A — link-safe accessors do not require hydration', () => {
+    const uuid = UUID.fromU8Array(new Uint8Array(16).fill(0x07));
+    const asOf = makeAsOf();
+    // Cache is empty — link-safe accessors must still work.
+    const wrapper = new Security(Security.linkOf(uuid, asOf));
+    expect(wrapper.isLink()).toBe(true);
+    expect(wrapper.getID().toString()).toBe(uuid.toString());
+    expect(wrapper.getAsOf().getSeconds()).toBe(asOf.getSeconds());
+  });
+  // ---- B. Cache behavior ----
+  test('B.i — first accessor call hydrates from a pre-populated cache', () => {
+    const uuid = UUID.fromU8Array(new Uint8Array(16).fill(0x01));
+    const asOf = makeAsOf();
+    const resolved = makeFullProto(uuid, asOf, 'hydrated');
+    LinkCache.SECURITY.put(uuid.toString(), resolved, asOf);
+    const wrapper = new Security(Security.linkOf(uuid, asOf));
+    expect(wrapper.getIssuerName()).toBe('hydrated');
+  });
+  test('B.ii — second accessor call hits the swapped proto, not the cache', () => {
+    const uuid = UUID.fromU8Array(new Uint8Array(16).fill(0x02));
+    const asOf = makeAsOf();
+    const resolved = makeFullProto(uuid, asOf, 'firstRead');
+    LinkCache.SECURITY.put(uuid.toString(), resolved, asOf);
+    const wrapper = new Security(Security.linkOf(uuid, asOf));
+    expect(wrapper.getAssetClass()).toBe('Equity');
+    // Evict the cache; wrapper has already swapped in the proto so the
+    // second read must succeed without touching the cache.
+    LinkCache.SECURITY.evict(uuid.toString());
+    expect(wrapper.getIssuerName()).toBe('firstRead');
+  });
+  test('B.iii — fresh wrapper for same (uuid, asOf) reads cache populated by prior wrapper', () => {
+    const uuid = UUID.fromU8Array(new Uint8Array(16).fill(0x03));
+    const asOf = makeAsOf();
+    const resolved = makeFullProto(uuid, asOf, 'shared');
+    LinkCache.SECURITY.put(uuid.toString(), resolved, asOf);
+    // Two independent wrappers share the cache entry.
+    const wrapperA = new Security(Security.linkOf(uuid, asOf));
+    const wrapperB = new Security(Security.linkOf(uuid, asOf));
+    expect(wrapperA.getIssuerName()).toBe('shared');
+    expect(wrapperB.getIssuerName()).toBe('shared');
+  });
+  // ---- C. asOf semantics ----
+  test('C — link asOf differing from cached asOf is a miss', () => {
+    const uuid = UUID.fromU8Array(new Uint8Array(16).fill(0x04));
+    const asOfT1 = makeAsOf(0);
+    const asOfT2 = makeAsOf(86400);
+    LinkCache.SECURITY.put(uuid.toString(), makeFullProto(uuid, asOfT2, 'T2'), asOfT2);
+    const wrapper = new Security(Security.linkOf(uuid, asOfT1));
+    expect(() => wrapper.getIssuerName()).toThrow(/LinkCache miss/);
+  });
+  // ---- D. Resolve failure ----
+  test('D — cache miss throws with uuid in message', () => {
+    const uuid = UUID.fromU8Array(new Uint8Array(16).fill(0x05));
+    const asOf = makeAsOf();
+    const wrapper = new Security(Security.linkOf(uuid, asOf));
+    expect(() => wrapper.getAssetClass()).toThrow(new RegExp(uuid.toString()));
+  });
+});

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

@@ -9,6 +9,7 @@ import { ProductTypeProto } from "../../../fintekkers/models/security/product_ty
 import { IdentifierTypeProto } from "../../../fintekkers/models/security/identifier/identifier_type_pb";
 import { Identifier } from "./identifier";
 import { isDescendantOf } from "./product_hierarchy";
+import * as LinkCacheModule from "../../util/link-cache";
 class Security {
   proto: SecurityProto;
@@ -60,17 +61,34 @@ class Security {
   }
   /**
-   * Throws if this Security is in link mode. Use to guard accessors that
-   * would otherwise return proto3 default values on a link reference.
+   * Lazy hydration. If this Security is in link mode, swap in the resolved
+   * proto from LinkCache. On cache miss, throws — caller must pre-warm via
+   * LinkResolver. See docs/adr/lazy-link-hydration.md.
+   *
+   * TS variant is cache-only (no fetcher hook) because the gRPC stubs are
+   * async and chaining the resolver into every getter would force every
+   * accessor to become async. Pre-warming through LinkResolver keeps the
+   * sync getter API.
    */
-  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.`
-      );
+  private ensureHydrated(): void {
+    if (!this.proto.getIsLink()) return;
+    const uuidProto = this.proto.getUuid();
+    if (!uuidProto) {
+      throw new Error("Cannot read fields on link-mode Security with no UUID set.");
+    }
+    const uuidKey = UUID.fromU8Array(uuidProto.getRawUuid_asU8()).toString();
+    const asOfProto = this.proto.getAsOf();
+    const asOf = asOfProto ? new ZonedDateTime(asOfProto) : null;
+    const cached = LinkCacheModule.SECURITY.get(uuidKey, asOf);
+    if (cached) {
+      this.proto = cached;
+      return;
     }
+    throw new Error(
+      `Cannot read fields on link-mode Security uuid=${uuidKey} `
+      + `— LinkCache miss. Pre-warm via LinkResolver. `
+      + `See docs/adr/lazy-link-hydration.md.`
+    );
   }
   /**
@@ -258,17 +276,17 @@ class Security {
   }
   getAssetClass(): string {
-    this.assertNotLink('assetClass');
+    this.ensureHydrated();
     return this.proto.getAssetClass();
   }
   getProductClass(): string {
-    this.assertNotLink('productClass');
+    this.ensureHydrated();
     throw new Error('Not implemented yet. See Java implementation for reference');
   }
   getProductType(): string {
-    this.assertNotLink('productType');
+    this.ensureHydrated();
     const securityType = this.proto.getProductType();
     const securityTypeString = (Object.keys(ProductTypeProto) as Array<keyof typeof ProductTypeProto>).find(
       key => ProductTypeProto[key] === securityType
@@ -282,7 +300,7 @@ class Security {
    * Empty list if none are set. Throws on a link-mode Security.
    */
   getIdentifiers(): Identifier[] {
-    this.assertNotLink('identifiers');
+    this.ensureHydrated();
     const list = this.proto.getIdentifiersList();
     if (!list) return [];
     return list.map(p => new Identifier(p));
@@ -293,7 +311,7 @@ class Security {
    * or undefined if none is present. Throws on a link-mode Security.
    */
   getIdentifierByType(type: IdentifierTypeProto): Identifier | undefined {
-    this.assertNotLink('identifierByType');
+    this.ensureHydrated();
     const list = this.proto.getIdentifiersList();
     if (!list) return undefined;
     const found = list.find(p => p.getIdentifierType() === type);
@@ -314,7 +332,7 @@ class Security {
    * properly-formed bond).
    */
   getIssueDate(): Date | null {
-    this.assertNotLink('issueDate');
+    this.ensureHydrated();
     const bond = this.getBondLikeDetails();
     const date = bond ? bond.getIssueDate() : undefined;
     return localDateProtoToDate(date);
@@ -327,7 +345,7 @@ class Security {
    * code paths.
    */
   getMaturityDate(): Date | null {
-    this.assertNotLink('maturityDate');
+    this.ensureHydrated();
     const bond = this.getBondLikeDetails();
     const date = bond ? bond.getMaturityDate() : undefined;
     return localDateProtoToDate(date);
@@ -344,7 +362,7 @@ class Security {
   }
   getIssuerName(): string {
-    this.assertNotLink('issuerName');
+    this.ensureHydrated();
     return this.proto.getIssuerName();
   }

package/node/wrappers/models/transaction/transaction_type.js CHANGED Viewed

@@ -11,10 +11,12 @@ class TransactionType {
             case transaction_type_pb_1.TransactionTypeProto.BUY:
             case transaction_type_pb_1.TransactionTypeProto.DEPOSIT:
             case transaction_type_pb_1.TransactionTypeProto.MATURATION_OFFSET:
+            case transaction_type_pb_1.TransactionTypeProto.PRINCIPAL_PAYDOWN_OFFSET:
                 return 1;
             case transaction_type_pb_1.TransactionTypeProto.SELL:
             case transaction_type_pb_1.TransactionTypeProto.WITHDRAWAL:
             case transaction_type_pb_1.TransactionTypeProto.MATURATION:
+            case transaction_type_pb_1.TransactionTypeProto.PRINCIPAL_PAYDOWN:
                 return -1;
             case transaction_type_pb_1.TransactionTypeProto.UNKNOWN:
                 throw new Error('Unknown transaction type: ' + this.toString());

package/node/wrappers/models/transaction/transaction_type.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"transaction_type.js","sourceRoot":"","sources":["transaction_type.ts"],"names":[],"mappings":";;;AAAA,oGAAkG;AAElG,MAAa,eAAe;IAGxB,YAAY,KAA2B;QACnC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAYD,sBAAsB;QAClB,QAAQ,IAAI,CAAC,KAAK,EAAE;YAChB,KAAK,0CAAoB,CAAC,GAAG,CAAC;YAC9B,KAAK,0CAAoB,CAAC,OAAO,CAAC;YAClC,KAAK,0CAAoB,CAAC,iBAAiB;~~gBACvC~~,OAAO,CAAC,CAAC;YACb,KAAK,0CAAoB,CAAC,IAAI,CAAC;YAC/B,KAAK,0CAAoB,CAAC,UAAU,CAAC;YACrC,KAAK,0CAAoB,CAAC,UAAU;~~gBAChC~~,OAAO,CAAC,CAAC,CAAC;YACd,KAAK,0CAAoB,CAAC,OAAO;gBAC7B,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;SACvE;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ;;QACJ,OAAO,MAAA,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,mCAAI,SAAS,CAAC;IAClE,CAAC;CACJ;~~AA5CD~~,~~0CA4CC~~;~~AAnCG~~;IACI,eAAe,CAAC,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEtD,MAAM,CAAC,IAAI,CAAC,0CAAoB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QAC5C,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,0CAAoB,CAAC,GAAwC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;AACP,CAAC,GAAA,CAAA"}
1	+ {"version":3,"file":"transaction_type.js","sourceRoot":"","sources":["transaction_type.ts"],"names":[],"mappings":";;;AAAA,oGAAkG;AAElG,MAAa,eAAe;IAGxB,YAAY,KAA2B;QACnC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAYD,sBAAsB;QAClB,QAAQ,IAAI,CAAC,KAAK,EAAE;YAChB,KAAK,0CAAoB,CAAC,GAAG,CAAC;YAC9B,KAAK,0CAAoB,CAAC,OAAO,CAAC;YAClC,KAAK,0CAAoB,CAAC,iBAAiB,CAAC;YAC5C,KAAK,0CAAoB,CAAC,wBAAwB;gBAC9C,OAAO,CAAC,CAAC;YACb,KAAK,0CAAoB,CAAC,IAAI,CAAC;YAC/B,KAAK,0CAAoB,CAAC,UAAU,CAAC;YACrC,KAAK,0CAAoB,CAAC,UAAU,CAAC;YACrC,KAAK,0CAAoB,CAAC,iBAAiB;gBACvC,OAAO,CAAC,CAAC,CAAC;YACd,KAAK,0CAAoB,CAAC,OAAO;gBAC7B,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;SACvE;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ;;QACJ,OAAO,MAAA,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,mCAAI,SAAS,CAAC;IAClE,CAAC;CACJ;AA9CD,0CA8CC;AArCG;IACI,eAAe,CAAC,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEtD,MAAM,CAAC,IAAI,CAAC,0CAAoB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QAC5C,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,0CAAoB,CAAC,GAAwC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;AACP,CAAC,GAAA,CAAA"}

package/node/wrappers/models/transaction/transaction_type.ts CHANGED Viewed

@@ -22,10 +22,12 @@ export class TransactionType {
             case TransactionTypeProto.BUY:
             case TransactionTypeProto.DEPOSIT:
             case TransactionTypeProto.MATURATION_OFFSET:
+            case TransactionTypeProto.PRINCIPAL_PAYDOWN_OFFSET:
                 return 1;
             case TransactionTypeProto.SELL:
             case TransactionTypeProto.WITHDRAWAL:
             case TransactionTypeProto.MATURATION:
+            case TransactionTypeProto.PRINCIPAL_PAYDOWN:
                 return -1;
             case TransactionTypeProto.UNKNOWN:
                 throw new Error('Unknown transaction type: ' + this.toString());

package/node/wrappers/util/link-cache.d.ts ADDED Viewed

@@ -0,0 +1,56 @@
+import { SecurityProto } from '../../fintekkers/models/security/security_pb';
+import { PortfolioProto } from '../../fintekkers/models/portfolio/portfolio_pb';
+import { PriceProto } from '../../fintekkers/models/price/price_pb';
+import { TransactionProto } from '../../fintekkers/models/transaction/transaction_pb';
+import { ZonedDateTime } from '../models/utils/datetime';
+/**
+ * LinkCache — process-wide cache of resolved proto bodies backing link-mode
+ * wrappers. TypeScript mirror of `common.util.LinkCache` (Java) and
+ * `fintekkers.wrappers.util.link_cache` (Python). See
+ * `docs/adr/lazy-link-hydration.md`.
+ *
+ * Read semantics (`get`):
+ *   - `requestedAsOf == null` ("latest acceptable") — cache hit allowed;
+ *     subject to `ttlForLatestMs` to bound cross-process staleness this
+ *     process can't observe. Past TTL ⇒ miss.
+ *   - `requestedAsOf != null` (bitemporal-precise) — cache hit only when the
+ *     cached entry's asOf equals the requested. No TTL — history doesn't
+ *     change, so a past vintage cached arbitrarily long is fine.
+ *
+ * Write semantics (`put`): newest-vintage wins. An older-vintage put does
+ * not evict a newer cached entry.
+ *
+ * Later Portfolio can likely be 1 day, security 1 day, transaction 1 minute,
+ * price 30 seconds — once per-entity TTLs are wired up, the shared singletons
+ * below should be constructed with those values.
+ */
+export declare const DEFAULT_TTL_FOR_LATEST_MS = 600000;
+export declare class LinkCache<V> {
+    private ttlForLatestMs;
+    private map;
+    constructor(ttlForLatestMs?: number);
+    /**
+     * @param uuidKey         the entity uuid rendered as a stable string key
+     *                        (use uuid.toString())
+     * @param requestedAsOf   null = "latest acceptable" (TTL-bounded);
+     *                        non-null = exact-vintage match required (no TTL)
+     * @returns the cached value if the lookup is a hit; otherwise undefined
+     *          (caller must refetch)
+     */
+    get(uuidKey: string, requestedAsOf: ZonedDateTime | null): V | undefined;
+    /**
+     * Newest-wins write: if a cached entry for `uuidKey` already exists with
+     * an asOf strictly after the incoming asOf, the write is ignored.
+     */
+    put(uuidKey: string, value: V, asOf: ZonedDateTime): void;
+    evict(uuidKey: string): void;
+    clear(): void;
+    /** Test helper. */
+    size(): number;
+    private _sameAsOf;
+    private _isStrictlyAfter;
+}
+export declare const SECURITY: LinkCache<SecurityProto>;
+export declare const PORTFOLIO: LinkCache<PortfolioProto>;
+export declare const PRICE: LinkCache<PriceProto>;
+export declare const TRANSACTION: LinkCache<TransactionProto>;

package/node/wrappers/util/link-cache.js ADDED Viewed

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRANSACTION = exports.PRICE = exports.PORTFOLIO = exports.SECURITY = exports.LinkCache = exports.DEFAULT_TTL_FOR_LATEST_MS = void 0;
+/**
+ * LinkCache — process-wide cache of resolved proto bodies backing link-mode
+ * wrappers. TypeScript mirror of `common.util.LinkCache` (Java) and
+ * `fintekkers.wrappers.util.link_cache` (Python). See
+ * `docs/adr/lazy-link-hydration.md`.
+ *
+ * Read semantics (`get`):
+ *   - `requestedAsOf == null` ("latest acceptable") — cache hit allowed;
+ *     subject to `ttlForLatestMs` to bound cross-process staleness this
+ *     process can't observe. Past TTL ⇒ miss.
+ *   - `requestedAsOf != null` (bitemporal-precise) — cache hit only when the
+ *     cached entry's asOf equals the requested. No TTL — history doesn't
+ *     change, so a past vintage cached arbitrarily long is fine.
+ *
+ * Write semantics (`put`): newest-vintage wins. An older-vintage put does
+ * not evict a newer cached entry.
+ *
+ * Later Portfolio can likely be 1 day, security 1 day, transaction 1 minute,
+ * price 30 seconds — once per-entity TTLs are wired up, the shared singletons
+ * below should be constructed with those values.
+ */
+exports.DEFAULT_TTL_FOR_LATEST_MS = 600000;
+class LinkCache {
+    constructor(ttlForLatestMs = exports.DEFAULT_TTL_FOR_LATEST_MS) {
+        this.ttlForLatestMs = ttlForLatestMs;
+        this.map = new Map();
+        if (ttlForLatestMs < 0) {
+            throw new Error(`ttlForLatestMs must be non-negative; got ${ttlForLatestMs}`);
+        }
+    }
+    /**
+     * @param uuidKey         the entity uuid rendered as a stable string key
+     *                        (use uuid.toString())
+     * @param requestedAsOf   null = "latest acceptable" (TTL-bounded);
+     *                        non-null = exact-vintage match required (no TTL)
+     * @returns the cached value if the lookup is a hit; otherwise undefined
+     *          (caller must refetch)
+     */
+    get(uuidKey, requestedAsOf) {
+        const entry = this.map.get(uuidKey);
+        if (!entry)
+            return undefined;
+        if (requestedAsOf == null) {
+            if (Date.now() - entry.cachedAtMs > this.ttlForLatestMs) {
+                return undefined;
+            }
+            return entry.value;
+        }
+        return this._sameAsOf(entry.asOf, requestedAsOf) ? entry.value : undefined;
+    }
+    /**
+     * Newest-wins write: if a cached entry for `uuidKey` already exists with
+     * an asOf strictly after the incoming asOf, the write is ignored.
+     */
+    put(uuidKey, value, asOf) {
+        if (!uuidKey || !value || !asOf) {
+            throw new Error(`uuidKey / value / asOf must all be set; got uuidKey=${uuidKey} value=${value ? '<non-null>' : 'null'} asOf=${asOf}`);
+        }
+        const existing = this.map.get(uuidKey);
+        if (existing && this._isStrictlyAfter(existing.asOf, asOf)) {
+            return;
+        }
+        this.map.set(uuidKey, { value, asOf, cachedAtMs: Date.now() });
+    }
+    evict(uuidKey) {
+        this.map.delete(uuidKey);
+    }
+    clear() {
+        this.map.clear();
+    }
+    /** Test helper. */
+    size() {
+        return this.map.size;
+    }
+    _sameAsOf(a, b) {
+        return a.getSeconds() === b.getSeconds() && a.getNanoSeconds() === b.getNanoSeconds();
+    }
+    _isStrictlyAfter(a, b) {
+        if (a.getSeconds() !== b.getSeconds())
+            return a.getSeconds() > b.getSeconds();
+        return a.getNanoSeconds() > b.getNanoSeconds();
+    }
+}
+exports.LinkCache = LinkCache;
+exports.SECURITY = new LinkCache();
+exports.PORTFOLIO = new LinkCache();
+exports.PRICE = new LinkCache();
+exports.TRANSACTION = new LinkCache();
+//# sourceMappingURL=link-cache.js.map

package/node/wrappers/util/link-cache.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/node/wrappers/util/link-cache.test.d.ts ADDED Viewed

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

package/node/wrappers/util/link-cache.test.js ADDED Viewed

@@ -0,0 +1,107 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const link_cache_1 = require("./link-cache");
+const datetime_1 = require("../models/utils/datetime");
+const local_timestamp_pb_1 = require("../../fintekkers/models/util/local_timestamp_pb");
+const timestamp_pb_1 = require("google-protobuf/google/protobuf/timestamp_pb");
+const security_pb_1 = require("../../fintekkers/models/security/security_pb");
+function makeAsOf(epochSecondsOffset = 0) {
+    const ts = new timestamp_pb_1.Timestamp();
+    ts.setSeconds(1700000000 + epochSecondsOffset);
+    ts.setNanos(0);
+    const proto = new local_timestamp_pb_1.LocalTimestampProto();
+    proto.setTimestamp(ts);
+    proto.setTimeZone('UTC');
+    return new datetime_1.ZonedDateTime(proto);
+}
+function makeSecurityProto(name) {
+    const p = new security_pb_1.SecurityProto();
+    p.setIssuerName(name);
+    return p;
+}
+describe('LinkCache', () => {
+    beforeEach(() => {
+        link_cache_1.SECURITY.clear();
+        link_cache_1.PORTFOLIO.clear();
+        link_cache_1.PRICE.clear();
+        link_cache_1.TRANSACTION.clear();
+    });
+    // ---- A. Basic get/put ----
+    test('get on empty cache returns undefined', () => {
+        expect(link_cache_1.SECURITY.get('uuid-1', makeAsOf())).toBeUndefined();
+    });
+    test('put then get with matching asOf returns value', () => {
+        const asOf = makeAsOf();
+        const val = makeSecurityProto('ACME');
+        link_cache_1.SECURITY.put('uuid-1', val, asOf);
+        expect(link_cache_1.SECURITY.get('uuid-1', asOf)).toBe(val);
+    });
+    test('get with different asOf returns undefined', () => {
+        link_cache_1.SECURITY.put('uuid-1', makeSecurityProto('v1'), makeAsOf(0));
+        expect(link_cache_1.SECURITY.get('uuid-1', makeAsOf(10))).toBeUndefined();
+    });
+    // ---- B. Null asOf semantics ----
+    test('null asOf within TTL returns value', () => {
+        const cache = new link_cache_1.LinkCache(60000);
+        cache.put('uuid-1', makeSecurityProto('v1'), makeAsOf());
+        expect(cache.get('uuid-1', null)).toBeDefined();
+    });
+    test('null asOf past TTL returns undefined', () => __awaiter(void 0, void 0, void 0, function* () {
+        const cache = new link_cache_1.LinkCache(50);
+        cache.put('uuid-1', makeSecurityProto('v1'), makeAsOf());
+        yield new Promise((resolve) => setTimeout(resolve, 100));
+        expect(cache.get('uuid-1', null)).toBeUndefined();
+    }));
+    test('non-null asOf is not subject to TTL', () => __awaiter(void 0, void 0, void 0, function* () {
+        const cache = new link_cache_1.LinkCache(50);
+        const asOf = makeAsOf();
+        const val = makeSecurityProto('v1');
+        cache.put('uuid-1', val, asOf);
+        yield new Promise((resolve) => setTimeout(resolve, 100));
+        // Bitemporal: history doesn't change, exact-asOf reads never expire.
+        expect(cache.get('uuid-1', asOf)).toBe(val);
+    }));
+    // ---- C. Newest-wins merge ----
+    test('put with older asOf does not overwrite newer', () => {
+        var _a;
+        link_cache_1.SECURITY.put('uuid-1', makeSecurityProto('newer'), makeAsOf(100));
+        link_cache_1.SECURITY.put('uuid-1', makeSecurityProto('older'), makeAsOf(50));
+        expect((_a = link_cache_1.SECURITY.get('uuid-1', makeAsOf(100))) === null || _a === void 0 ? void 0 : _a.getIssuerName()).toBe('newer');
+        expect(link_cache_1.SECURITY.get('uuid-1', makeAsOf(50))).toBeUndefined();
+    });
+    test('put with newer asOf replaces older', () => {
+        var _a;
+        link_cache_1.SECURITY.put('uuid-1', makeSecurityProto('older'), makeAsOf(50));
+        link_cache_1.SECURITY.put('uuid-1', makeSecurityProto('newer'), makeAsOf(100));
+        expect((_a = link_cache_1.SECURITY.get('uuid-1', makeAsOf(100))) === null || _a === void 0 ? void 0 : _a.getIssuerName()).toBe('newer');
+    });
+    // ---- D. Evict & clear ----
+    test('evict removes entry', () => {
+        link_cache_1.SECURITY.put('uuid-1', makeSecurityProto('v1'), makeAsOf());
+        link_cache_1.SECURITY.evict('uuid-1');
+        expect(link_cache_1.SECURITY.get('uuid-1', makeAsOf())).toBeUndefined();
+    });
+    test('clear empties cache', () => {
+        link_cache_1.SECURITY.put('a', makeSecurityProto('a'), makeAsOf());
+        link_cache_1.SECURITY.put('b', makeSecurityProto('b'), makeAsOf());
+        link_cache_1.SECURITY.clear();
+        expect(link_cache_1.SECURITY.size()).toBe(0);
+    });
+    // ---- E. Singleton isolation ----
+    test('singletons have independent state', () => {
+        link_cache_1.SECURITY.put('uuid-1', makeSecurityProto('sec'), makeAsOf());
+        expect(link_cache_1.PORTFOLIO.get('uuid-1', makeAsOf())).toBeUndefined();
+        expect(link_cache_1.PRICE.get('uuid-1', makeAsOf())).toBeUndefined();
+        expect(link_cache_1.TRANSACTION.get('uuid-1', makeAsOf())).toBeUndefined();
+    });
+});
+//# sourceMappingURL=link-cache.test.js.map

package/node/wrappers/util/link-cache.test.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/node/wrappers/util/link-cache.test.ts ADDED Viewed

@@ -0,0 +1,112 @@
+import { LinkCache, SECURITY, PORTFOLIO, PRICE, TRANSACTION } from './link-cache';
+import { ZonedDateTime } from '../models/utils/datetime';
+import { LocalTimestampProto } from '../../fintekkers/models/util/local_timestamp_pb';
+import { Timestamp } from 'google-protobuf/google/protobuf/timestamp_pb';
+import { SecurityProto } from '../../fintekkers/models/security/security_pb';
+function makeAsOf(epochSecondsOffset: number = 0): ZonedDateTime {
+  const ts = new Timestamp();
+  ts.setSeconds(1700000000 + epochSecondsOffset);
+  ts.setNanos(0);
+  const proto = new LocalTimestampProto();
+  proto.setTimestamp(ts);
+  proto.setTimeZone('UTC');
+  return new ZonedDateTime(proto);
+}
+function makeSecurityProto(name: string): SecurityProto {
+  const p = new SecurityProto();
+  p.setIssuerName(name);
+  return p;
+}
+describe('LinkCache', () => {
+  beforeEach(() => {
+    SECURITY.clear();
+    PORTFOLIO.clear();
+    PRICE.clear();
+    TRANSACTION.clear();
+  });
+  // ---- A. Basic get/put ----
+  test('get on empty cache returns undefined', () => {
+    expect(SECURITY.get('uuid-1', makeAsOf())).toBeUndefined();
+  });
+  test('put then get with matching asOf returns value', () => {
+    const asOf = makeAsOf();
+    const val = makeSecurityProto('ACME');
+    SECURITY.put('uuid-1', val, asOf);
+    expect(SECURITY.get('uuid-1', asOf)).toBe(val);
+  });
+  test('get with different asOf returns undefined', () => {
+    SECURITY.put('uuid-1', makeSecurityProto('v1'), makeAsOf(0));
+    expect(SECURITY.get('uuid-1', makeAsOf(10))).toBeUndefined();
+  });
+  // ---- B. Null asOf semantics ----
+  test('null asOf within TTL returns value', () => {
+    const cache = new LinkCache<SecurityProto>(60_000);
+    cache.put('uuid-1', makeSecurityProto('v1'), makeAsOf());
+    expect(cache.get('uuid-1', null)).toBeDefined();
+  });
+  test('null asOf past TTL returns undefined', async () => {
+    const cache = new LinkCache<SecurityProto>(50);
+    cache.put('uuid-1', makeSecurityProto('v1'), makeAsOf());
+    await new Promise((resolve) => setTimeout(resolve, 100));
+    expect(cache.get('uuid-1', null)).toBeUndefined();
+  });
+  test('non-null asOf is not subject to TTL', async () => {
+    const cache = new LinkCache<SecurityProto>(50);
+    const asOf = makeAsOf();
+    const val = makeSecurityProto('v1');
+    cache.put('uuid-1', val, asOf);
+    await new Promise((resolve) => setTimeout(resolve, 100));
+    // Bitemporal: history doesn't change, exact-asOf reads never expire.
+    expect(cache.get('uuid-1', asOf)).toBe(val);
+  });
+  // ---- C. Newest-wins merge ----
+  test('put with older asOf does not overwrite newer', () => {
+    SECURITY.put('uuid-1', makeSecurityProto('newer'), makeAsOf(100));
+    SECURITY.put('uuid-1', makeSecurityProto('older'), makeAsOf(50));
+    expect(SECURITY.get('uuid-1', makeAsOf(100))?.getIssuerName()).toBe('newer');
+    expect(SECURITY.get('uuid-1', makeAsOf(50))).toBeUndefined();
+  });
+  test('put with newer asOf replaces older', () => {
+    SECURITY.put('uuid-1', makeSecurityProto('older'), makeAsOf(50));
+    SECURITY.put('uuid-1', makeSecurityProto('newer'), makeAsOf(100));
+    expect(SECURITY.get('uuid-1', makeAsOf(100))?.getIssuerName()).toBe('newer');
+  });
+  // ---- D. Evict & clear ----
+  test('evict removes entry', () => {
+    SECURITY.put('uuid-1', makeSecurityProto('v1'), makeAsOf());
+    SECURITY.evict('uuid-1');
+    expect(SECURITY.get('uuid-1', makeAsOf())).toBeUndefined();
+  });
+  test('clear empties cache', () => {
+    SECURITY.put('a', makeSecurityProto('a'), makeAsOf());
+    SECURITY.put('b', makeSecurityProto('b'), makeAsOf());
+    SECURITY.clear();
+    expect(SECURITY.size()).toBe(0);
+  });
+  // ---- E. Singleton isolation ----
+  test('singletons have independent state', () => {
+    SECURITY.put('uuid-1', makeSecurityProto('sec'), makeAsOf());
+    expect(PORTFOLIO.get('uuid-1', makeAsOf())).toBeUndefined();
+    expect(PRICE.get('uuid-1', makeAsOf())).toBeUndefined();
+    expect(TRANSACTION.get('uuid-1', makeAsOf())).toBeUndefined();
+  });
+});

package/node/wrappers/util/link-cache.ts ADDED Viewed

@@ -0,0 +1,110 @@
+import { SecurityProto } from '../../fintekkers/models/security/security_pb';
+import { PortfolioProto } from '../../fintekkers/models/portfolio/portfolio_pb';
+import { PriceProto } from '../../fintekkers/models/price/price_pb';
+import { TransactionProto } from '../../fintekkers/models/transaction/transaction_pb';
+import { ZonedDateTime } from '../models/utils/datetime';
+/**
+ * LinkCache — process-wide cache of resolved proto bodies backing link-mode
+ * wrappers. TypeScript mirror of `common.util.LinkCache` (Java) and
+ * `fintekkers.wrappers.util.link_cache` (Python). See
+ * `docs/adr/lazy-link-hydration.md`.
+ *
+ * Read semantics (`get`):
+ *   - `requestedAsOf == null` ("latest acceptable") — cache hit allowed;
+ *     subject to `ttlForLatestMs` to bound cross-process staleness this
+ *     process can't observe. Past TTL ⇒ miss.
+ *   - `requestedAsOf != null` (bitemporal-precise) — cache hit only when the
+ *     cached entry's asOf equals the requested. No TTL — history doesn't
+ *     change, so a past vintage cached arbitrarily long is fine.
+ *
+ * Write semantics (`put`): newest-vintage wins. An older-vintage put does
+ * not evict a newer cached entry.
+ *
+ * Later Portfolio can likely be 1 day, security 1 day, transaction 1 minute,
+ * price 30 seconds — once per-entity TTLs are wired up, the shared singletons
+ * below should be constructed with those values.
+ */
+export const DEFAULT_TTL_FOR_LATEST_MS = 600_000;
+interface CacheEntry<V> {
+  value: V;
+  /** Bitemporal asOf carried by the cached value. */
+  asOf: ZonedDateTime;
+  /** Wall-clock ms at the moment this entry was cached. */
+  cachedAtMs: number;
+}
+export class LinkCache<V> {
+  private map = new Map<string, CacheEntry<V>>();
+  constructor(private ttlForLatestMs: number = DEFAULT_TTL_FOR_LATEST_MS) {
+    if (ttlForLatestMs < 0) {
+      throw new Error(`ttlForLatestMs must be non-negative; got ${ttlForLatestMs}`);
+    }
+  }
+  /**
+   * @param uuidKey         the entity uuid rendered as a stable string key
+   *                        (use uuid.toString())
+   * @param requestedAsOf   null = "latest acceptable" (TTL-bounded);
+   *                        non-null = exact-vintage match required (no TTL)
+   * @returns the cached value if the lookup is a hit; otherwise undefined
+   *          (caller must refetch)
+   */
+  get(uuidKey: string, requestedAsOf: ZonedDateTime | null): V | undefined {
+    const entry = this.map.get(uuidKey);
+    if (!entry) return undefined;
+    if (requestedAsOf == null) {
+      if (Date.now() - entry.cachedAtMs > this.ttlForLatestMs) {
+        return undefined;
+      }
+      return entry.value;
+    }
+    return this._sameAsOf(entry.asOf, requestedAsOf) ? entry.value : undefined;
+  }
+  /**
+   * Newest-wins write: if a cached entry for `uuidKey` already exists with
+   * an asOf strictly after the incoming asOf, the write is ignored.
+   */
+  put(uuidKey: string, value: V, asOf: ZonedDateTime): void {
+    if (!uuidKey || !value || !asOf) {
+      throw new Error(
+        `uuidKey / value / asOf must all be set; got uuidKey=${uuidKey} value=${value ? '<non-null>' : 'null'} asOf=${asOf}`
+      );
+    }
+    const existing = this.map.get(uuidKey);
+    if (existing && this._isStrictlyAfter(existing.asOf, asOf)) {
+      return;
+    }
+    this.map.set(uuidKey, { value, asOf, cachedAtMs: Date.now() });
+  }
+  evict(uuidKey: string): void {
+    this.map.delete(uuidKey);
+  }
+  clear(): void {
+    this.map.clear();
+  }
+  /** Test helper. */
+  size(): number {
+    return this.map.size;
+  }
+  private _sameAsOf(a: ZonedDateTime, b: ZonedDateTime): boolean {
+    return a.getSeconds() === b.getSeconds() && a.getNanoSeconds() === b.getNanoSeconds();
+  }
+  private _isStrictlyAfter(a: ZonedDateTime, b: ZonedDateTime): boolean {
+    if (a.getSeconds() !== b.getSeconds()) return a.getSeconds() > b.getSeconds();
+    return a.getNanoSeconds() > b.getNanoSeconds();
+  }
+}
+export const SECURITY = new LinkCache<SecurityProto>();
+export const PORTFOLIO = new LinkCache<PortfolioProto>();
+export const PRICE = new LinkCache<PriceProto>();
+export const TRANSACTION = new LinkCache<TransactionProto>();

package/package.json CHANGED Viewed

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