@fintekkers/ledger-models 0.4.8 → 0.4.10

package/node/wrappers/services/service-client-writethrough.test.js

@@ -0,0 +1,147 @@
+"use strict";
+// Verifies SecurityService / PortfolioService / PriceService / TransactionService
+// each populate LinkCache on a successful createOrUpdate. Pure unit tests —
+// the gRPC client is replaced via Object.assign on the service instance so we
+// never hit the wire.
+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 __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());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const uuid_1 = require("../models/utils/uuid");
+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");
+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 create_security_response_pb_1 = require("../../fintekkers/requests/security/create_security_response_pb");
+const create_portfolio_response_pb_1 = require("../../fintekkers/requests/portfolio/create_portfolio_response_pb");
+const create_price_response_pb_1 = require("../../fintekkers/requests/price/create_price_response_pb");
+const create_transaction_response_pb_1 = require("../../fintekkers/requests/transaction/create_transaction_response_pb");
+const SecurityService_1 = require("./security-service/SecurityService");
+const PortfolioService_1 = require("./portfolio-service/PortfolioService");
+const PriceService_1 = require("./price-service/PriceService");
+const TransactionService_1 = require("./transaction-service/TransactionService");
+const transaction_1 = __importDefault(require("../models/transaction/transaction"));
+const LinkCacheModule = __importStar(require("../util/link-cache"));
+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 proto;
+}
+/**
+ * Build a fake gRPC client that returns a pre-canned response on
+ * createOrUpdate. Mimics the callback shape the real grpc-js client uses,
+ * since the service wraps it with `promisify`.
+ */
+function fakeClient(response) {
+    return {
+        createOrUpdate(_req, cb) {
+            cb(null, response);
+        },
+    };
+}
+beforeEach(() => {
+    LinkCacheModule.SECURITY.clear();
+    LinkCacheModule.PORTFOLIO.clear();
+    LinkCacheModule.PRICE.clear();
+    LinkCacheModule.TRANSACTION.clear();
+});
+test('SecurityService.createSecurity populates LinkCache.SECURITY', () => __awaiter(void 0, void 0, void 0, function* () {
+    const uuid = uuid_1.UUID.random();
+    const asOf = makeAsOf(0);
+    const persisted = new security_pb_1.SecurityProto();
+    persisted.setUuid(uuid.toUUIDProto());
+    persisted.setAsOf(asOf);
+    persisted.setIssuerName('ACME');
+    const response = new create_security_response_pb_1.CreateSecurityResponseProto();
+    response.setSecurityResponse(persisted);
+    const svc = new SecurityService_1.SecurityService();
+    svc.client = fakeClient(response);
+    yield svc.createSecurity(new security_pb_1.SecurityProto());
+    const cached = LinkCacheModule.SECURITY.get(uuid.toString(), new datetime_1.ZonedDateTime(asOf));
+    expect(cached).toBeDefined();
+    expect(cached.getIssuerName()).toBe('ACME');
+}));
+test('PortfolioService.createPortfolio populates LinkCache.PORTFOLIO', () => __awaiter(void 0, void 0, void 0, function* () {
+    const uuid = uuid_1.UUID.random();
+    const asOf = makeAsOf(1);
+    const persisted = new portfolio_pb_1.PortfolioProto();
+    persisted.setUuid(uuid.toUUIDProto());
+    persisted.setAsOf(asOf);
+    persisted.setPortfolioName('Strategy Z');
+    const response = new create_portfolio_response_pb_1.CreatePortfolioResponseProto();
+    response.addPortfolioResponse(persisted);
+    const svc = new PortfolioService_1.PortfolioService();
+    svc.client = fakeClient(response);
+    yield svc.createPortfolio(new portfolio_pb_1.PortfolioProto());
+    const cached = LinkCacheModule.PORTFOLIO.get(uuid.toString(), new datetime_1.ZonedDateTime(asOf));
+    expect(cached).toBeDefined();
+    expect(cached.getPortfolioName()).toBe('Strategy Z');
+}));
+test('PriceService.createOrUpdate populates LinkCache.PRICE', () => __awaiter(void 0, void 0, void 0, function* () {
+    const uuid = uuid_1.UUID.random();
+    const asOf = makeAsOf(2);
+    const persisted = new price_pb_1.PriceProto();
+    persisted.setUuid(uuid.toUUIDProto());
+    persisted.setAsOf(asOf);
+    const response = new create_price_response_pb_1.CreatePriceResponseProto();
+    response.addPriceResponse(persisted);
+    const svc = new PriceService_1.PriceService();
+    svc.client = fakeClient(response);
+    yield svc.createOrUpdate(new price_pb_1.PriceProto());
+    const cached = LinkCacheModule.PRICE.get(uuid.toString(), new datetime_1.ZonedDateTime(asOf));
+    expect(cached).toBeDefined();
+}));
+test('TransactionService.createTransaction populates LinkCache.TRANSACTION', () => __awaiter(void 0, void 0, void 0, function* () {
+    const uuid = uuid_1.UUID.random();
+    const asOf = makeAsOf(3);
+    const persisted = new transaction_pb_1.TransactionProto();
+    persisted.setUuid(uuid.toUUIDProto());
+    persisted.setAsOf(asOf);
+    const response = new create_transaction_response_pb_1.CreateTransactionResponseProto();
+    response.setTransactionResponse(persisted);
+    const svc = new TransactionService_1.TransactionService();
+    svc.client = fakeClient(response);
+    yield svc.createTransaction(new transaction_1.default(new transaction_pb_1.TransactionProto()));
+    const cached = LinkCacheModule.TRANSACTION.get(uuid.toString(), new datetime_1.ZonedDateTime(asOf));
+    expect(cached).toBeDefined();
+}));
+//# sourceMappingURL=service-client-writethrough.test.js.map

package/node/wrappers/services/service-client-writethrough.test.js.map

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

package/node/wrappers/services/service-client-writethrough.test.ts

@@ -0,0 +1,141 @@
+// Verifies SecurityService / PortfolioService / PriceService / TransactionService
+// each populate LinkCache on a successful createOrUpdate. Pure unit tests —
+// the gRPC client is replaced via Object.assign on the service instance so we
+// never hit the wire.
+
+import { UUID } from '../models/utils/uuid';
+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';
+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 { CreateSecurityResponseProto } from '../../fintekkers/requests/security/create_security_response_pb';
+import { CreatePortfolioResponseProto } from '../../fintekkers/requests/portfolio/create_portfolio_response_pb';
+import { CreatePriceResponseProto } from '../../fintekkers/requests/price/create_price_response_pb';
+import { CreateTransactionResponseProto } from '../../fintekkers/requests/transaction/create_transaction_response_pb';
+
+import { SecurityService } from './security-service/SecurityService';
+import { PortfolioService } from './portfolio-service/PortfolioService';
+import { PriceService } from './price-service/PriceService';
+import { TransactionService } from './transaction-service/TransactionService';
+import Transaction from '../models/transaction/transaction';
+
+import * as LinkCacheModule from '../util/link-cache';
+
+function makeAsOf(epochSecondsOffset = 0): LocalTimestampProto {
+  const ts = new Timestamp();
+  ts.setSeconds(1_700_000_000 + epochSecondsOffset);
+  ts.setNanos(0);
+  const proto = new LocalTimestampProto();
+  proto.setTimestamp(ts);
+  proto.setTimeZone('UTC');
+  return proto;
+}
+
+/**
+ * Build a fake gRPC client that returns a pre-canned response on
+ * createOrUpdate. Mimics the callback shape the real grpc-js client uses,
+ * since the service wraps it with `promisify`.
+ */
+function fakeClient<TRes>(response: TRes): any {
+  return {
+    createOrUpdate(_req: unknown, cb: (err: unknown, res: TRes) => void) {
+      cb(null, response);
+    },
+  };
+}
+
+beforeEach(() => {
+  LinkCacheModule.SECURITY.clear();
+  LinkCacheModule.PORTFOLIO.clear();
+  LinkCacheModule.PRICE.clear();
+  LinkCacheModule.TRANSACTION.clear();
+});
+
+test('SecurityService.createSecurity populates LinkCache.SECURITY', async () => {
+  const uuid = UUID.random();
+  const asOf = makeAsOf(0);
+
+  const persisted = new SecurityProto();
+  persisted.setUuid(uuid.toUUIDProto());
+  persisted.setAsOf(asOf);
+  persisted.setIssuerName('ACME');
+
+  const response = new CreateSecurityResponseProto();
+  response.setSecurityResponse(persisted);
+
+  const svc = new SecurityService();
+  (svc as any).client = fakeClient(response);
+
+  await svc.createSecurity(new SecurityProto());
+
+  const cached = LinkCacheModule.SECURITY.get(uuid.toString(), new ZonedDateTime(asOf));
+  expect(cached).toBeDefined();
+  expect(cached!.getIssuerName()).toBe('ACME');
+});
+
+test('PortfolioService.createPortfolio populates LinkCache.PORTFOLIO', async () => {
+  const uuid = UUID.random();
+  const asOf = makeAsOf(1);
+
+  const persisted = new PortfolioProto();
+  persisted.setUuid(uuid.toUUIDProto());
+  persisted.setAsOf(asOf);
+  persisted.setPortfolioName('Strategy Z');
+
+  const response = new CreatePortfolioResponseProto();
+  response.addPortfolioResponse(persisted);
+
+  const svc = new PortfolioService();
+  (svc as any).client = fakeClient(response);
+
+  await svc.createPortfolio(new PortfolioProto());
+
+  const cached = LinkCacheModule.PORTFOLIO.get(uuid.toString(), new ZonedDateTime(asOf));
+  expect(cached).toBeDefined();
+  expect(cached!.getPortfolioName()).toBe('Strategy Z');
+});
+
+test('PriceService.createOrUpdate populates LinkCache.PRICE', async () => {
+  const uuid = UUID.random();
+  const asOf = makeAsOf(2);
+
+  const persisted = new PriceProto();
+  persisted.setUuid(uuid.toUUIDProto());
+  persisted.setAsOf(asOf);
+
+  const response = new CreatePriceResponseProto();
+  response.addPriceResponse(persisted);
+
+  const svc = new PriceService();
+  (svc as any).client = fakeClient(response);
+
+  await svc.createOrUpdate(new PriceProto());
+
+  const cached = LinkCacheModule.PRICE.get(uuid.toString(), new ZonedDateTime(asOf));
+  expect(cached).toBeDefined();
+});
+
+test('TransactionService.createTransaction populates LinkCache.TRANSACTION', async () => {
+  const uuid = UUID.random();
+  const asOf = makeAsOf(3);
+
+  const persisted = new TransactionProto();
+  persisted.setUuid(uuid.toUUIDProto());
+  persisted.setAsOf(asOf);
+
+  const response = new CreateTransactionResponseProto();
+  response.setTransactionResponse(persisted);
+
+  const svc = new TransactionService();
+  (svc as any).client = fakeClient(response);
+
+  await svc.createTransaction(new Transaction(new TransactionProto()));
+
+  const cached = LinkCacheModule.TRANSACTION.get(uuid.toString(), new ZonedDateTime(asOf));
+  expect(cached).toBeDefined();
+});

package/node/wrappers/services/transaction-service/TransactionService.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 __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) {
@@ -23,6 +46,9 @@ const create_transaction_request_pb_1 = require("../../../fintekkers/requests/tr
 const query_transaction_request_pb_1 = require("../../../fintekkers/requests/transaction/query_transaction_request_pb");
 const requestcontext_1 = __importDefault(require("../../models/utils/requestcontext"));
 const link_resolver_1 = __importDefault(require("../../util/link-resolver"));
+const LinkCacheModule = __importStar(require("../../util/link-cache"));
+const uuid_1 = require("../../models/utils/uuid");
+const datetime_1 = require("../../models/utils/datetime");
 class TransactionService {
     constructor(apiKey) {
         if (apiKey) {
@@ -52,6 +78,16 @@ class TransactionService {
             createRequest.setCreateTransactionInput(transaction.proto);
             const createTransactionAsync = (0, util_1.promisify)(this.client.createOrUpdate.bind(this.client));
             const response = yield createTransactionAsync(createRequest);
+            // Write-through to LinkCache. transactionResponse is a singular field.
+            const persisted = response.getTransactionResponse();
+            if (persisted) {
+                const uuidProto = persisted.getUuid();
+                const asOfProto = persisted.getAsOf();
+                if (uuidProto && asOfProto) {
+                    const uuidKey = uuid_1.UUID.fromU8Array(uuidProto.getRawUuid_asU8()).toString();
+                    LinkCacheModule.TRANSACTION.put(uuidKey, persisted, new datetime_1.ZonedDateTime(asOfProto));
+                }
+            }
             return response;
         });
     }

package/node/wrappers/services/transaction-service/TransactionService.js.map

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

package/node/wrappers/services/transaction-service/TransactionService.ts

@@ -16,6 +16,9 @@ import { QueryTransactionRequestProto } from '../../../fintekkers/requests/trans
 import { QueryTransactionResponseProto } from '../../../fintekkers/requests/transaction/query_transaction_response_pb';
 import EnvConfig from '../../models/utils/requestcontext';
 import LinkResolver from '../../util/link-resolver';
+import * as LinkCacheModule from '../../util/link-cache';
+import { UUID } from '../../models/utils/uuid';
+import { ZonedDateTime } from '../../models/utils/datetime';
 
 
 class TransactionService {
@@ -49,6 +52,16 @@ class TransactionService {
 
     const createTransactionAsync = promisify(this.client.createOrUpdate.bind(this.client));
     const response = await createTransactionAsync(createRequest) as CreateTransactionResponseProto;
+    // Write-through to LinkCache. transactionResponse is a singular field.
+    const persisted = response.getTransactionResponse();
+    if (persisted) {
+      const uuidProto = persisted.getUuid();
+      const asOfProto = persisted.getAsOf();
+      if (uuidProto && asOfProto) {
+        const uuidKey = UUID.fromU8Array(uuidProto.getRawUuid_asU8()).toString();
+        LinkCacheModule.TRANSACTION.put(uuidKey, persisted, new ZonedDateTime(asOfProto));
+      }
+    }
     return response;
   }
 

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

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

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

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

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