@fintekkers/ledger-models 0.4.8 → 0.4.10

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

@@ -6,6 +6,14 @@ declare class Portfolio {
     proto: PortfolioProto;
     constructor(proto: PortfolioProto);
     toString(): string;
+    isLink(): boolean;
+    /**
+     * Lazy hydration. On a link-mode proto, swap in the resolved proto from
+     * LinkCache. On cache miss, throws — caller must pre-warm via
+     * LinkResolver. Cache-only by design (same rationale as Security wrapper:
+     * keeps the sync getter API). See docs/adr/lazy-link-hydration.md.
+     */
+    private ensureHydrated;
     getID(): UUID;
     getAsOf(): ZonedDateTime;
     getPortfolioName(): string;

package/node/wrappers/models/portfolio/portfolio.js

@@ -1,14 +1,66 @@
 "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 datetime_1 = require("../utils/datetime");
 const uuid_1 = require("../utils/uuid");
+const LinkCacheModule = __importStar(require("../../util/link-cache"));
 class Portfolio {
     constructor(proto) {
         this.proto = proto;
     }
     toString() {
-        return this.getPortfolioName();
+        return this.isLink() ? `<link ${this.getID().toString()}>` : this.getPortfolioName();
+    }
+    isLink() {
+        return this.proto.getIsLink();
+    }
+    /**
+     * Lazy hydration. On a link-mode proto, swap in the resolved proto from
+     * LinkCache. On cache miss, throws — caller must pre-warm via
+     * LinkResolver. Cache-only by design (same rationale as Security wrapper:
+     * keeps the sync getter API). See docs/adr/lazy-link-hydration.md.
+     */
+    ensureHydrated() {
+        if (!this.proto.getIsLink())
+            return;
+        const uuidProto = this.proto.getUuid();
+        if (!uuidProto) {
+            throw new Error("Cannot read fields on link-mode Portfolio 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.PORTFOLIO.get(uuidKey, asOf);
+        if (cached) {
+            this.proto = cached;
+            return;
+        }
+        throw new Error(`Cannot read fields on link-mode Portfolio uuid=${uuidKey} `
+            + `— LinkCache miss. Pre-warm via LinkResolver. `
+            + `See docs/adr/lazy-link-hydration.md.`);
     }
     getID() {
         const uuid = this.proto.getUuid();
@@ -23,6 +75,7 @@ class Portfolio {
         return new datetime_1.ZonedDateTime(asOf);
     }
     getPortfolioName() {
+        this.ensureHydrated();
         return this.proto.getPortfolioName();
     }
     getFields() {

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

@@ -1 +1 @@
-{"version":3,"file":"portfolio.js","sourceRoot":"","sources":["portfolio.ts"],"names":[],"mappings":";;AACA,2EAA0E;AAC1E,gDAAkD;AAClD,wCAAqC;AAErC,MAAM,SAAS;IAGX,YAAY,KAAqB;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACnC,CAAC;IAED,KAAK;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC1D,OAAO,WAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAG,CAAC,eAAe,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,OAAO;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC1D,OAAO,IAAI,wBAAa,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,gBAAgB;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC;IACzC,CAAC;IAED,SAAS;QACL,OAAO,CAAC,qBAAU,CAAC,EAAE,EAAE,qBAAU,CAAC,SAAS,EAAE,qBAAU,CAAC,YAAY,EAAE,qBAAU,CAAC,cAAc,CAAC,CAAC;IACrG,CAAC;IAED,QAAQ,CAAC,KAAiB;QACtB,QAAQ,KAAK,EAAE;YACX,KAAK,qBAAU,CAAC,EAAE,CAAC;YACnB,KAAK,qBAAU,CAAC,YAAY;gBACxB,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;YACxB,KAAK,qBAAU,CAAC,KAAK;gBACjB,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;YAC1B,KAAK,qBAAU,CAAC,cAAc;gBAC1B,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACnC;gBACI,MAAM,IAAI,KAAK,CAAC,0CAA0C,KAAK,EAAE,CAAC,CAAC;SAC1E;IACL,CAAC;CACJ;AAGD,kBAAe,SAAS,CAAC"}
+{"version":3,"file":"portfolio.js","sourceRoot":"","sources":["portfolio.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AACA,2EAA0E;AAC1E,gDAAkD;AAClD,wCAAqC;AACrC,uEAAyD;AAEzD,MAAM,SAAS;IAGX,YAAY,KAAqB;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACzF,CAAC;IAED,MAAM;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACK,cAAc;QAClB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE;YAAE,OAAO;QACpC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACvC,IAAI,CAAC,SAAS,EAAE;YACZ,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;SAClF;QACD,MAAM,OAAO,GAAG,WAAI,CAAC,WAAW,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;QACzE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,wBAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7D,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC5D,IAAI,MAAM,EAAE;YACR,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;YACpB,OAAO;SACV;QACD,MAAM,IAAI,KAAK,CACX,kDAAkD,OAAO,GAAG;cAC1D,+CAA+C;cAC/C,sCAAsC,CAC3C,CAAC;IACN,CAAC;IAED,KAAK;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC1D,OAAO,WAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAG,CAAC,eAAe,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,OAAO;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC1D,OAAO,IAAI,wBAAa,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,gBAAgB;QACZ,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC;IACzC,CAAC;IAED,SAAS;QACL,OAAO,CAAC,qBAAU,CAAC,EAAE,EAAE,qBAAU,CAAC,SAAS,EAAE,qBAAU,CAAC,YAAY,EAAE,qBAAU,CAAC,cAAc,CAAC,CAAC;IACrG,CAAC;IAED,QAAQ,CAAC,KAAiB;QACtB,QAAQ,KAAK,EAAE;YACX,KAAK,qBAAU,CAAC,EAAE,CAAC;YACnB,KAAK,qBAAU,CAAC,YAAY;gBACxB,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;YACxB,KAAK,qBAAU,CAAC,KAAK;gBACjB,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;YAC1B,KAAK,qBAAU,CAAC,cAAc;gBAC1B,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACnC;gBACI,MAAM,IAAI,KAAK,CAAC,0CAA0C,KAAK,EAAE,CAAC,CAAC;SAC1E;IACL,CAAC;CACJ;AAGD,kBAAe,SAAS,CAAC"}

package/node/wrappers/models/portfolio/portfolio.ts

@@ -2,6 +2,7 @@ import { PortfolioProto } from "../../../fintekkers/models/portfolio/portfolio_p
 import { FieldProto } from "../../../fintekkers/models/position/field_pb";
 import { ZonedDateTime } from "../utils/datetime";
 import { UUID } from "../utils/uuid";
+import * as LinkCacheModule from "../../util/link-cache";
 
 class Portfolio {
     proto: PortfolioProto;
@@ -11,7 +12,38 @@ class Portfolio {
     }
 
     toString(): string {
-        return this.getPortfolioName();
+        return this.isLink() ? `<link ${this.getID().toString()}>` : this.getPortfolioName();
+    }
+
+    isLink(): boolean {
+        return this.proto.getIsLink();
+    }
+
+    /**
+     * Lazy hydration. On a link-mode proto, swap in the resolved proto from
+     * LinkCache. On cache miss, throws — caller must pre-warm via
+     * LinkResolver. Cache-only by design (same rationale as Security wrapper:
+     * keeps the sync getter API). See docs/adr/lazy-link-hydration.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 Portfolio 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.PORTFOLIO.get(uuidKey, asOf);
+        if (cached) {
+            this.proto = cached;
+            return;
+        }
+        throw new Error(
+            `Cannot read fields on link-mode Portfolio uuid=${uuidKey} `
+            + `— LinkCache miss. Pre-warm via LinkResolver. `
+            + `See docs/adr/lazy-link-hydration.md.`
+        );
     }
 
     getID(): UUID {
@@ -27,6 +59,7 @@ class Portfolio {
     }
 
     getPortfolioName(): string {
+        this.ensureHydrated();
         return this.proto.getPortfolioName();
     }
 

package/node/wrappers/models/portfolio-price-transaction.lazy-hydrate.test.d.ts

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

package/node/wrappers/models/portfolio-price-transaction.lazy-hydrate.test.js

@@ -0,0 +1,158 @@
+"use strict";
+// Lazy-hydrate tests for Portfolio / Price / Transaction wrappers.
+// Mirror of security.lazy-hydrate.test.ts — cache-only design, throws on miss.
+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 portfolio_1 = __importDefault(require("./portfolio/portfolio"));
+const Price_1 = __importDefault(require("./price/Price"));
+const transaction_1 = __importDefault(require("./transaction/transaction"));
+const uuid_1 = require("./utils/uuid");
+const datetime_1 = require("./utils/datetime");
+const portfolio_pb_1 = require("../../fintekkers/models/portfolio/portfolio_pb");
+const price_pb_1 = require("../../fintekkers/models/price/price_pb");
+const transaction_pb_1 = require("../../fintekkers/models/transaction/transaction_pb");
+const decimal_value_pb_1 = require("../../fintekkers/models/util/decimal_value_pb");
+const local_timestamp_pb_1 = require("../../fintekkers/models/util/local_timestamp_pb");
+const timestamp_pb_1 = require("google-protobuf/google/protobuf/timestamp_pb");
+const LinkCache = __importStar(require("../util/link-cache"));
+function makeAsOf(epochSeconds = 1700000000) {
+    const ts = new timestamp_pb_1.Timestamp();
+    ts.setSeconds(epochSeconds);
+    ts.setNanos(0);
+    const proto = new local_timestamp_pb_1.LocalTimestampProto();
+    proto.setTimestamp(ts);
+    proto.setTimeZone('UTC');
+    return new datetime_1.ZonedDateTime(proto);
+}
+function linkPortfolio(uuid, asOf) {
+    const p = new portfolio_pb_1.PortfolioProto();
+    p.setUuid(uuid.toUUIDProto());
+    p.setAsOf(asOf.toProto());
+    p.setIsLink(true);
+    return p;
+}
+function fullPortfolio(uuid, asOf, name) {
+    const p = new portfolio_pb_1.PortfolioProto();
+    p.setUuid(uuid.toUUIDProto());
+    p.setAsOf(asOf.toProto());
+    p.setIsLink(false);
+    p.setPortfolioName(name);
+    return p;
+}
+function linkPriceProto(uuid, asOf) {
+    const p = new price_pb_1.PriceProto();
+    p.setUuid(uuid.toUUIDProto());
+    p.setAsOf(asOf.toProto());
+    p.setIsLink(true);
+    return p;
+}
+function fullPriceProto(uuid, asOf, value) {
+    const p = new price_pb_1.PriceProto();
+    p.setUuid(uuid.toUUIDProto());
+    p.setAsOf(asOf.toProto());
+    p.setIsLink(false);
+    const dv = new decimal_value_pb_1.DecimalValueProto();
+    dv.setArbitraryPrecisionValue(value);
+    p.setPrice(dv);
+    return p;
+}
+function linkTxnProto(uuid, asOf) {
+    const p = new transaction_pb_1.TransactionProto();
+    p.setUuid(uuid.toUUIDProto());
+    p.setAsOf(asOf.toProto());
+    p.setIsLink(true);
+    return p;
+}
+function fullTxnProto(uuid, asOf) {
+    const p = new transaction_pb_1.TransactionProto();
+    p.setUuid(uuid.toUUIDProto());
+    p.setAsOf(asOf.toProto());
+    p.setIsLink(false);
+    p.setTradeName('TXN');
+    return p;
+}
+beforeEach(() => {
+    LinkCache.PORTFOLIO.clear();
+    LinkCache.PRICE.clear();
+    LinkCache.TRANSACTION.clear();
+});
+// ---- Portfolio ----
+test('Portfolio getPortfolioName on link wrapper hydrates from cache', () => {
+    const uuid = uuid_1.UUID.random();
+    const asOf = makeAsOf(1);
+    LinkCache.PORTFOLIO.put(uuid.toString(), fullPortfolio(uuid, asOf, 'Strategy Z'), asOf);
+    const p = new portfolio_1.default(linkPortfolio(uuid, asOf));
+    expect(p.isLink()).toBe(true);
+    expect(p.getPortfolioName()).toBe('Strategy Z');
+    expect(p.proto.getIsLink()).toBe(false);
+});
+test('Portfolio cache miss throws with uuid in message', () => {
+    const uuid = uuid_1.UUID.random();
+    const asOf = makeAsOf(2);
+    const p = new portfolio_1.default(linkPortfolio(uuid, asOf));
+    expect(() => p.getPortfolioName()).toThrow(new RegExp(uuid.toString()));
+});
+// ---- Price ----
+test('Price getPrice on link wrapper hydrates from cache', () => {
+    const uuid = uuid_1.UUID.random();
+    const asOf = makeAsOf(3);
+    LinkCache.PRICE.put(uuid.toString(), fullPriceProto(uuid, asOf, '123.45'), asOf);
+    const pr = new Price_1.default(linkPriceProto(uuid, asOf));
+    expect(pr.isLink()).toBe(true);
+    expect(pr.getPrice().toString()).toBe('123.45');
+});
+test('Price cache miss throws with uuid in message', () => {
+    const uuid = uuid_1.UUID.random();
+    const asOf = makeAsOf(4);
+    const pr = new Price_1.default(linkPriceProto(uuid, asOf));
+    expect(() => pr.getPrice()).toThrow(new RegExp(uuid.toString()));
+});
+// ---- Transaction ----
+test('Transaction getTradeName on link wrapper hydrates from cache', () => {
+    const uuid = uuid_1.UUID.random();
+    const asOf = makeAsOf(5);
+    LinkCache.TRANSACTION.put(uuid.toString(), fullTxnProto(uuid, asOf), asOf);
+    const t = new transaction_1.default(linkTxnProto(uuid, asOf));
+    expect(t.isLink()).toBe(true);
+    expect(t.getTradeName()).toBe('TXN');
+});
+test('Transaction cache miss throws with uuid in message', () => {
+    const uuid = uuid_1.UUID.random();
+    const asOf = makeAsOf(6);
+    const t = new transaction_1.default(linkTxnProto(uuid, asOf));
+    expect(() => t.getTradeName()).toThrow(new RegExp(uuid.toString()));
+});
+test('Transaction link-safe accessors do not hydrate', () => {
+    const uuid = uuid_1.UUID.random();
+    const asOf = makeAsOf(7);
+    // No cache entry, no fetcher — link-safe accessors must still work.
+    const t = new transaction_1.default(linkTxnProto(uuid, asOf));
+    expect(t.isLink()).toBe(true);
+    expect(t.getID().toString()).toBe(uuid.toString());
+});
+//# sourceMappingURL=portfolio-price-transaction.lazy-hydrate.test.js.map

package/node/wrappers/models/portfolio-price-transaction.lazy-hydrate.test.js.map

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

package/node/wrappers/models/portfolio-price-transaction.lazy-hydrate.test.ts

@@ -0,0 +1,153 @@
+// Lazy-hydrate tests for Portfolio / Price / Transaction wrappers.
+// Mirror of security.lazy-hydrate.test.ts — cache-only design, throws on miss.
+
+import Portfolio from './portfolio/portfolio';
+import Price from './price/Price';
+import Transaction from './transaction/transaction';
+import { UUID } from './utils/uuid';
+import { ZonedDateTime } from './utils/datetime';
+
+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 { DecimalValueProto } from '../../fintekkers/models/util/decimal_value_pb';
+import { LocalTimestampProto } from '../../fintekkers/models/util/local_timestamp_pb';
+import { Timestamp } from 'google-protobuf/google/protobuf/timestamp_pb';
+
+import * as LinkCache from '../util/link-cache';
+
+function makeAsOf(epochSeconds = 1_700_000_000): ZonedDateTime {
+  const ts = new Timestamp();
+  ts.setSeconds(epochSeconds);
+  ts.setNanos(0);
+  const proto = new LocalTimestampProto();
+  proto.setTimestamp(ts);
+  proto.setTimeZone('UTC');
+  return new ZonedDateTime(proto);
+}
+
+function linkPortfolio(uuid: UUID, asOf: ZonedDateTime): PortfolioProto {
+  const p = new PortfolioProto();
+  p.setUuid(uuid.toUUIDProto());
+  p.setAsOf(asOf.toProto());
+  p.setIsLink(true);
+  return p;
+}
+
+function fullPortfolio(uuid: UUID, asOf: ZonedDateTime, name: string): PortfolioProto {
+  const p = new PortfolioProto();
+  p.setUuid(uuid.toUUIDProto());
+  p.setAsOf(asOf.toProto());
+  p.setIsLink(false);
+  p.setPortfolioName(name);
+  return p;
+}
+
+function linkPriceProto(uuid: UUID, asOf: ZonedDateTime): PriceProto {
+  const p = new PriceProto();
+  p.setUuid(uuid.toUUIDProto());
+  p.setAsOf(asOf.toProto());
+  p.setIsLink(true);
+  return p;
+}
+
+function fullPriceProto(uuid: UUID, asOf: ZonedDateTime, value: string): PriceProto {
+  const p = new PriceProto();
+  p.setUuid(uuid.toUUIDProto());
+  p.setAsOf(asOf.toProto());
+  p.setIsLink(false);
+  const dv = new DecimalValueProto();
+  dv.setArbitraryPrecisionValue(value);
+  p.setPrice(dv);
+  return p;
+}
+
+function linkTxnProto(uuid: UUID, asOf: ZonedDateTime): TransactionProto {
+  const p = new TransactionProto();
+  p.setUuid(uuid.toUUIDProto());
+  p.setAsOf(asOf.toProto());
+  p.setIsLink(true);
+  return p;
+}
+
+function fullTxnProto(uuid: UUID, asOf: ZonedDateTime): TransactionProto {
+  const p = new TransactionProto();
+  p.setUuid(uuid.toUUIDProto());
+  p.setAsOf(asOf.toProto());
+  p.setIsLink(false);
+  p.setTradeName('TXN');
+  return p;
+}
+
+beforeEach(() => {
+  LinkCache.PORTFOLIO.clear();
+  LinkCache.PRICE.clear();
+  LinkCache.TRANSACTION.clear();
+});
+
+// ---- Portfolio ----
+
+test('Portfolio getPortfolioName on link wrapper hydrates from cache', () => {
+  const uuid = UUID.random();
+  const asOf = makeAsOf(1);
+  LinkCache.PORTFOLIO.put(uuid.toString(), fullPortfolio(uuid, asOf, 'Strategy Z'), asOf);
+
+  const p = new Portfolio(linkPortfolio(uuid, asOf));
+  expect(p.isLink()).toBe(true);
+  expect(p.getPortfolioName()).toBe('Strategy Z');
+  expect(p.proto.getIsLink()).toBe(false);
+});
+
+test('Portfolio cache miss throws with uuid in message', () => {
+  const uuid = UUID.random();
+  const asOf = makeAsOf(2);
+  const p = new Portfolio(linkPortfolio(uuid, asOf));
+  expect(() => p.getPortfolioName()).toThrow(new RegExp(uuid.toString()));
+});
+
+// ---- Price ----
+
+test('Price getPrice on link wrapper hydrates from cache', () => {
+  const uuid = UUID.random();
+  const asOf = makeAsOf(3);
+  LinkCache.PRICE.put(uuid.toString(), fullPriceProto(uuid, asOf, '123.45'), asOf);
+
+  const pr = new Price(linkPriceProto(uuid, asOf));
+  expect(pr.isLink()).toBe(true);
+  expect(pr.getPrice().toString()).toBe('123.45');
+});
+
+test('Price cache miss throws with uuid in message', () => {
+  const uuid = UUID.random();
+  const asOf = makeAsOf(4);
+  const pr = new Price(linkPriceProto(uuid, asOf));
+  expect(() => pr.getPrice()).toThrow(new RegExp(uuid.toString()));
+});
+
+// ---- Transaction ----
+
+test('Transaction getTradeName on link wrapper hydrates from cache', () => {
+  const uuid = UUID.random();
+  const asOf = makeAsOf(5);
+  LinkCache.TRANSACTION.put(uuid.toString(), fullTxnProto(uuid, asOf), asOf);
+
+  const t = new Transaction(linkTxnProto(uuid, asOf));
+  expect(t.isLink()).toBe(true);
+  expect(t.getTradeName()).toBe('TXN');
+});
+
+test('Transaction cache miss throws with uuid in message', () => {
+  const uuid = UUID.random();
+  const asOf = makeAsOf(6);
+  const t = new Transaction(linkTxnProto(uuid, asOf));
+  expect(() => t.getTradeName()).toThrow(new RegExp(uuid.toString()));
+});
+
+test('Transaction link-safe accessors do not hydrate', () => {
+  const uuid = UUID.random();
+  const asOf = makeAsOf(7);
+  // No cache entry, no fetcher — link-safe accessors must still work.
+  const t = new Transaction(linkTxnProto(uuid, asOf));
+  expect(t.isLink()).toBe(true);
+  expect(t.getID().toString()).toBe(uuid.toString());
+});

package/node/wrappers/models/price/Price.d.ts

@@ -32,6 +32,11 @@ declare class Price {
      * See docs/adr/is_link_pattern.md. Pair with LinkResolver to hydrate.
      */
     isLink(): boolean;
+    /**
+     * Lazy hydration. Cache-only — caller must pre-warm via LinkResolver.
+     * See docs/adr/lazy-link-hydration.md.
+     */
+    private ensureHydrated;
     getPrice(): Decimal;
     getPriceType(): PriceTypeProto;
     getSecurity(): Security;

package/node/wrappers/models/price/Price.js

@@ -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;
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -11,6 +34,7 @@ const security_1 = __importDefault(require("../security/security"));
 const datetime_1 = require("../utils/datetime");
 const uuid_1 = require("../utils/uuid");
 const decimal_js_1 = require("decimal.js");
+const LinkCacheModule = __importStar(require("../../util/link-cache"));
 class Price {
     constructor(proto) {
         this.proto = proto;
@@ -75,13 +99,37 @@ class Price {
     isLink() {
         return this.proto.getIsLink();
     }
+    /**
+     * Lazy hydration. Cache-only — caller must pre-warm via LinkResolver.
+     * See docs/adr/lazy-link-hydration.md.
+     */
+    ensureHydrated() {
+        if (!this.proto.getIsLink())
+            return;
+        const uuidProto = this.proto.getUuid();
+        if (!uuidProto)
+            throw new Error("Cannot read fields on link-mode Price 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.PRICE.get(uuidKey, asOf);
+        if (cached) {
+            this.proto = cached;
+            return;
+        }
+        throw new Error(`Cannot read fields on link-mode Price uuid=${uuidKey} `
+            + `— LinkCache miss. Pre-warm via LinkResolver. `
+            + `See docs/adr/lazy-link-hydration.md.`);
+    }
     getPrice() {
+        this.ensureHydrated();
         const priceValue = this.proto.getPrice();
         if (!priceValue)
             throw new Error("Price value is required");
         return new decimal_js_1.Decimal(priceValue.getArbitraryPrecisionValue());
     }
     getPriceType() {
+        this.ensureHydrated();
         return this.proto.getPriceType();
     }
     getSecurity() {

package/node/wrappers/models/price/Price.js.map

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

package/node/wrappers/models/price/Price.ts

@@ -6,6 +6,7 @@ import Security from "../security/security";
 import { ZonedDateTime } from "../utils/datetime";
 import { UUID } from "../utils/uuid";
 import { Decimal } from "decimal.js";
+import * as LinkCacheModule from "../../util/link-cache";
 
 class Price {
     proto: PriceProto;
@@ -88,13 +89,38 @@ class Price {
         return this.proto.getIsLink();
     }
 
+    /**
+     * Lazy hydration. Cache-only — caller must pre-warm via LinkResolver.
+     * See docs/adr/lazy-link-hydration.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 Price 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.PRICE.get(uuidKey, asOf);
+        if (cached) {
+            this.proto = cached;
+            return;
+        }
+        throw new Error(
+            `Cannot read fields on link-mode Price uuid=${uuidKey} `
+            + `— LinkCache miss. Pre-warm via LinkResolver. `
+            + `See docs/adr/lazy-link-hydration.md.`
+        );
+    }
+
     getPrice(): Decimal {
+        this.ensureHydrated();
         const priceValue = this.proto.getPrice();
         if (!priceValue) throw new Error("Price value is required");
         return new Decimal(priceValue.getArbitraryPrecisionValue());
     }
 
     getPriceType(): PriceTypeProto {
+        this.ensureHydrated();
         return this.proto.getPriceType();
     }
 

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

@@ -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: