@fintekkers/ledger-models 0.4.8 → 0.4.10

package/node/wrappers/util/link-resolver.test.ts

@@ -400,3 +400,65 @@ describe('LinkResolver', () => {
     expect(callLog.count).toBe(2);
   });
 });
+
+import * as LinkCacheModule from './link-cache';
+import { ZonedDateTime } from '../models/utils/datetime';
+
+describe('LinkResolver write-through to LinkCache', () => {
+  beforeEach(() => {
+    LinkCacheModule.SECURITY.clear();
+    LinkCacheModule.PORTFOLIO.clear();
+  });
+
+  function fullSecurityWithAsOf(uuid: UUID, issuer: string, asOf: LocalTimestampProto): SecurityProto {
+    const proto = fullSecurity(uuid, issuer);
+    proto.setAsOf(asOf);
+    return proto;
+  }
+
+  test('getSecurity populates LinkCache.SECURITY', async () => {
+    const uuid = UUID.random();
+    const asOf = makeAsOf(1_700_000_010);
+    const store = new Map<string, SecurityProto>([
+      [uuid.toString(), fullSecurityWithAsOf(uuid, 'ACME', asOf)],
+    ]);
+    const resolver = new LinkResolver({
+      securityClient: mockSecurityClient(store, newCallLog()),
+      portfolioClient: mockPortfolioClient(new Map(), newCallLog()),
+    });
+
+    const out = await resolver.getSecurity(uuid, asOf);
+    expect(out.getIssuerName()).toBe('ACME');
+
+    const cached = LinkCacheModule.SECURITY.get(uuid.toString(), new ZonedDateTime(asOf));
+    expect(cached).toBeDefined();
+    expect(cached!.getIssuerName()).toBe('ACME');
+  });
+
+  test('resolveSecurities populates LinkCache.SECURITY', async () => {
+    const uuid = UUID.random();
+    const asOf = makeAsOf(1_700_000_011);
+    const store = new Map<string, SecurityProto>([
+      [uuid.toString(), fullSecurityWithAsOf(uuid, 'BULK', asOf)],
+    ]);
+    const resolver = new LinkResolver({
+      securityClient: mockSecurityClient(store, newCallLog()),
+      portfolioClient: mockPortfolioClient(new Map(), newCallLog()),
+    });
+
+    const linkSec = new SecurityProto();
+    linkSec.setUuid(uuid.toUUIDProto());
+    linkSec.setIsLink(true);
+    linkSec.setAsOf(asOf);
+    const priceProto = new PriceProto();
+    priceProto.setUuid(UUID.random().toUUIDProto());
+    priceProto.setSecurity(linkSec);
+    const price = new Price(priceProto);
+
+    await resolver.resolveSecurities([price]);
+
+    const cached = LinkCacheModule.SECURITY.get(uuid.toString(), new ZonedDateTime(asOf));
+    expect(cached).toBeDefined();
+    expect(cached!.getIssuerName()).toBe('BULK');
+  });
+});

package/node/wrappers/util/link-resolver.ts

@@ -16,6 +16,31 @@ import Security from '../models/security/security';
 import Portfolio from '../models/portfolio/portfolio';
 import { UUID } from '../models/utils/uuid';
 import EnvConfig from '../models/utils/requestcontext';
+import { ZonedDateTime } from '../models/utils/datetime';
+import * as LinkCacheModule from './link-cache';
+
+/**
+ * Mirror a freshly-fetched SecurityProto into the process-wide
+ * `LinkCache.SECURITY`. The lazy-hydrate `SecurityWrapper.ensureHydrated()`
+ * reads from this cache, so pre-warming via LinkResolver immediately
+ * benefits accessor reads. Skips silently when the resolved proto lacks
+ * uuid or as_of — `LinkCache.put` requires both.
+ */
+function populateSecurityLinkCache(proto: SecurityProto): void {
+  const uuidProto = proto.getUuid();
+  const asOfProto = proto.getAsOf();
+  if (!uuidProto || !asOfProto) return;
+  const uuidKey = UUID.fromU8Array(uuidProto.getRawUuid_asU8()).toString();
+  LinkCacheModule.SECURITY.put(uuidKey, proto, new ZonedDateTime(asOfProto));
+}
+
+function populatePortfolioLinkCache(proto: PortfolioProto): void {
+  const uuidProto = proto.getUuid();
+  const asOfProto = proto.getAsOf();
+  if (!uuidProto || !asOfProto) return;
+  const uuidKey = UUID.fromU8Array(uuidProto.getRawUuid_asU8()).toString();
+  LinkCacheModule.PORTFOLIO.put(uuidKey, proto, new ZonedDateTime(asOfProto));
+}
 
 /**
  * LinkResolver — bulk hydration of `is_link=true` entity references into
@@ -249,6 +274,7 @@ class LinkResolver {
           if (!uuidProto) continue;
           const uuidStr = UUID.fromU8Array(uuidProto.getRawUuid_asU8()).toString();
           this.securityCache.set(`${uuidStr}@${bucketKey}`, proto);
+          populateSecurityLinkCache(proto);
         }
       }),
     );
@@ -303,6 +329,7 @@ class LinkResolver {
           if (!uuidProto) continue;
           const uuidStr = UUID.fromU8Array(uuidProto.getRawUuid_asU8()).toString();
           this.portfolioCache.set(`${uuidStr}@${bucketKey}`, proto);
+          populatePortfolioLinkCache(proto);
         }
       }),
     );
@@ -346,6 +373,7 @@ class LinkResolver {
       }
       const proto = protos[0];
       this.securityCache.set(key, proto);
+      populateSecurityLinkCache(proto);
       return proto;
     }).finally(() => {
       this.securityInFlight.delete(key);
@@ -370,6 +398,7 @@ class LinkResolver {
       }
       const proto = protos[0];
       this.portfolioCache.set(key, proto);
+      populatePortfolioLinkCache(proto);
       return proto;
     }).finally(() => {
       this.portfolioInFlight.delete(key);

package/package.json

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