@fintekkers/ledger-models 0.4.9 → 0.4.11

package/node/wrappers/services/security-service/SecurityService.ts

@@ -9,6 +9,7 @@ import Security from '../../models/security/security';
 // Model Utils
 import { PositionFilter } from '../../models/position/positionfilter';
 import * as dt from '../../models/utils/datetime';
+import { validateIdentifiersForCreate } from '../../models/security/identifier';
 
 // Requests & Services
 import { SecurityClient } from '../../../fintekkers/services/security-service/security_service_grpc_pb';
@@ -18,6 +19,9 @@ import { CreateSecurityRequestProto } from '../../../fintekkers/requests/securit
 import { CreateSecurityResponseProto } from '../../../fintekkers/requests/security/create_security_response_pb';
 
 import EnvConfig from '../../models/utils/requestcontext';
+import { UUID } from '../../models/utils/uuid';
+import { ZonedDateTime } from '../../models/utils/datetime';
+import * as LinkCacheModule from '../../util/link-cache';
 
 class SecurityService {
   private client: SecurityClient;
@@ -32,6 +36,12 @@ class SecurityService {
   }
 
   async validateCreateSecurity(security: SecurityProto): Promise<SummaryProto> {
+    // Client-side guard (#347): reject UNKNOWN_IDENTIFIER_TYPE and empty
+    // identifier values before the gRPC round-trip. Mirrors the server's
+    // validateCreateRequest reject so the dry-run RPC can't mask a request
+    // that the real createOrUpdate would also fail on.
+    validateIdentifiersForCreate(security);
+
     const createRequest = new CreateSecurityRequestProto();
     createRequest.setObjectClass('SecurityRequest');
     createRequest.setVersion('0.0.1');
@@ -43,14 +53,29 @@ class SecurityService {
   }
 
   async createSecurity(security: SecurityProto): Promise<CreateSecurityResponseProto> {
+    // Client-side guard (#347): see validateCreateSecurity above.
+    validateIdentifiersForCreate(security);
+
     const createRequest = new CreateSecurityRequestProto();
     createRequest.setObjectClass('SecurityRequest');
     createRequest.setVersion('0.0.1');
     createRequest.setSecurityInput(security);
 
     const createSecurityAsync = promisify(this.client.createOrUpdate.bind(this.client));
-    const response = await createSecurityAsync(createRequest);
-    return response as CreateSecurityResponseProto;
+    const response = await createSecurityAsync(createRequest) as CreateSecurityResponseProto;
+    // Write-through to the process-wide LinkCache. Lazy-hydrate wrappers
+    // read from this cache, so a fresh persist becomes visible to subsequent
+    // accessor reads with no second RPC. See docs/adr/lazy-link-hydration.md.
+    const persisted = response.getSecurityResponse();
+    if (persisted) {
+      const uuidProto = persisted.getUuid();
+      const asOfProto = persisted.getAsOf();
+      if (uuidProto && asOfProto) {
+        const uuidKey = UUID.fromU8Array(uuidProto.getRawUuid_asU8()).toString();
+        LinkCacheModule.SECURITY.put(uuidKey, persisted, new ZonedDateTime(asOfProto));
+      }
+    }
+    return response;
   }
 
   async searchSecurityAsOfNow(positionFilter: PositionFilter): Promise<Security[]> {

package/node/wrappers/services/security.identifier-guard.test.d.ts

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

package/node/wrappers/services/security.identifier-guard.test.js

@@ -0,0 +1,63 @@
+"use strict";
+// SecurityService client-side identifier guard (#347).
+// Pins that createSecurity / validateCreateSecurity raise the guard BEFORE
+// invoking the gRPC client when the request carries an UNKNOWN-typed or
+// empty identifier. Pure unit test — never touches the wire; the client is
+// replaced with a sentinel that fails the test if hit.
+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 identifier_pb_1 = require("../../fintekkers/models/security/identifier/identifier_pb");
+const identifier_type_pb_1 = require("../../fintekkers/models/security/identifier/identifier_type_pb");
+const security_pb_1 = require("../../fintekkers/models/security/security_pb");
+const identifier_1 = require("../models/security/identifier");
+const SecurityService_1 = require("./security-service/SecurityService");
+function makeIdentifier(type, value) {
+    const p = new identifier_pb_1.IdentifierProto();
+    p.setIdentifierType(type);
+    p.setIdentifierValue(value);
+    return p;
+}
+function securityWith(identifier) {
+    const s = new security_pb_1.SecurityProto();
+    s.addIdentifiers(identifier);
+    return s;
+}
+function failingClient() {
+    // Any RPC hit means the guard didn't fire — the test should fail loud.
+    const explode = () => {
+        throw new Error('client-side guard must reject before invoking the stub');
+    };
+    return {
+        createOrUpdate: explode,
+        validateCreateOrUpdate: explode,
+    };
+}
+describe('SecurityService client-side identifier guard', () => {
+    test('createSecurity rejects UNKNOWN_IDENTIFIER_TYPE before RPC', () => __awaiter(void 0, void 0, void 0, function* () {
+        const svc = new SecurityService_1.SecurityService();
+        svc.client = failingClient();
+        const bad = securityWith(makeIdentifier(identifier_type_pb_1.IdentifierTypeProto.UNKNOWN_IDENTIFIER_TYPE, 'stale-uuid'));
+        yield expect(svc.createSecurity(bad)).rejects.toBeInstanceOf(identifier_1.IdentifierValidationError);
+    }));
+    test('validateCreateSecurity rejects UNKNOWN_IDENTIFIER_TYPE before RPC', () => __awaiter(void 0, void 0, void 0, function* () {
+        const svc = new SecurityService_1.SecurityService();
+        svc.client = failingClient();
+        const bad = securityWith(makeIdentifier(identifier_type_pb_1.IdentifierTypeProto.UNKNOWN_IDENTIFIER_TYPE, 'stale-uuid'));
+        yield expect(svc.validateCreateSecurity(bad)).rejects.toBeInstanceOf(identifier_1.IdentifierValidationError);
+    }));
+    test('createSecurity rejects empty identifier_value before RPC', () => __awaiter(void 0, void 0, void 0, function* () {
+        const svc = new SecurityService_1.SecurityService();
+        svc.client = failingClient();
+        const bad = securityWith(makeIdentifier(identifier_type_pb_1.IdentifierTypeProto.EXCH_TICKER, ''));
+        yield expect(svc.createSecurity(bad)).rejects.toBeInstanceOf(identifier_1.IdentifierValidationError);
+    }));
+});
+//# sourceMappingURL=security.identifier-guard.test.js.map

package/node/wrappers/services/security.identifier-guard.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.identifier-guard.test.js","sourceRoot":"","sources":["security.identifier-guard.test.ts"],"names":[],"mappings":";AAAA,uDAAuD;AACvD,2EAA2E;AAC3E,wEAAwE;AACxE,2EAA2E;AAC3E,uDAAuD;;;;;;;;;;;AAEvD,6FAA4F;AAC5F,uGAAqG;AACrG,8EAA6E;AAC7E,8DAA0E;AAC1E,wEAAqE;AAErE,SAAS,cAAc,CAAC,IAAyB,EAAE,KAAa;IAC5D,MAAM,CAAC,GAAG,IAAI,+BAAe,EAAE,CAAC;IAChC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,CAAC,CAAC;AACb,CAAC;AAED,SAAS,YAAY,CAAC,UAA2B;IAC7C,MAAM,CAAC,GAAG,IAAI,2BAAa,EAAE,CAAC;IAC9B,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAC7B,OAAO,CAAC,CAAC;AACb,CAAC;AAED,SAAS,aAAa;IAClB,uEAAuE;IACvE,MAAM,OAAO,GAAG,GAAG,EAAE;QACjB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC9E,CAAC,CAAC;IACF,OAAO;QACH,cAAc,EAAE,OAAO;QACvB,sBAAsB,EAAE,OAAO;KAClC,CAAC;AACN,CAAC;AAED,QAAQ,CAAC,8CAA8C,EAAE,GAAG,EAAE;IAC1D,IAAI,CAAC,2DAA2D,EAAE,GAAS,EAAE;QACzE,MAAM,GAAG,GAAG,IAAI,iCAAe,EAAE,CAAC;QACjC,GAAW,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,YAAY,CACpB,cAAc,CAAC,wCAAmB,CAAC,uBAAuB,EAAE,YAAY,CAAC,CAC5E,CAAC;QACF,MAAM,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CACxD,sCAAyB,CAC5B,CAAC;IACN,CAAC,CAAA,CAAC,CAAC;IAEH,IAAI,CAAC,mEAAmE,EAAE,GAAS,EAAE;QACjF,MAAM,GAAG,GAAG,IAAI,iCAAe,EAAE,CAAC;QACjC,GAAW,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,YAAY,CACpB,cAAc,CAAC,wCAAmB,CAAC,uBAAuB,EAAE,YAAY,CAAC,CAC5E,CAAC;QACF,MAAM,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAChE,sCAAyB,CAC5B,CAAC;IACN,CAAC,CAAA,CAAC,CAAC;IAEH,IAAI,CAAC,0DAA0D,EAAE,GAAS,EAAE;QACxE,MAAM,GAAG,GAAG,IAAI,iCAAe,EAAE,CAAC;QACjC,GAAW,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,YAAY,CACpB,cAAc,CAAC,wCAAmB,CAAC,WAAW,EAAE,EAAE,CAAC,CACtD,CAAC;QACF,MAAM,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CACxD,sCAAyB,CAC5B,CAAC;IACN,CAAC,CAAA,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/node/wrappers/services/security.identifier-guard.test.ts

@@ -0,0 +1,70 @@
+// SecurityService client-side identifier guard (#347).
+// Pins that createSecurity / validateCreateSecurity raise the guard BEFORE
+// invoking the gRPC client when the request carries an UNKNOWN-typed or
+// empty identifier. Pure unit test — never touches the wire; the client is
+// replaced with a sentinel that fails the test if hit.
+
+import { IdentifierProto } from '../../fintekkers/models/security/identifier/identifier_pb';
+import { IdentifierTypeProto } from '../../fintekkers/models/security/identifier/identifier_type_pb';
+import { SecurityProto } from '../../fintekkers/models/security/security_pb';
+import { IdentifierValidationError } from '../models/security/identifier';
+import { SecurityService } from './security-service/SecurityService';
+
+function makeIdentifier(type: IdentifierTypeProto, value: string): IdentifierProto {
+    const p = new IdentifierProto();
+    p.setIdentifierType(type);
+    p.setIdentifierValue(value);
+    return p;
+}
+
+function securityWith(identifier: IdentifierProto): SecurityProto {
+    const s = new SecurityProto();
+    s.addIdentifiers(identifier);
+    return s;
+}
+
+function failingClient(): any {
+    // Any RPC hit means the guard didn't fire — the test should fail loud.
+    const explode = () => {
+        throw new Error('client-side guard must reject before invoking the stub');
+    };
+    return {
+        createOrUpdate: explode,
+        validateCreateOrUpdate: explode,
+    };
+}
+
+describe('SecurityService client-side identifier guard', () => {
+    test('createSecurity rejects UNKNOWN_IDENTIFIER_TYPE before RPC', async () => {
+        const svc = new SecurityService();
+        (svc as any).client = failingClient();
+        const bad = securityWith(
+            makeIdentifier(IdentifierTypeProto.UNKNOWN_IDENTIFIER_TYPE, 'stale-uuid')
+        );
+        await expect(svc.createSecurity(bad)).rejects.toBeInstanceOf(
+            IdentifierValidationError
+        );
+    });
+
+    test('validateCreateSecurity rejects UNKNOWN_IDENTIFIER_TYPE before RPC', async () => {
+        const svc = new SecurityService();
+        (svc as any).client = failingClient();
+        const bad = securityWith(
+            makeIdentifier(IdentifierTypeProto.UNKNOWN_IDENTIFIER_TYPE, 'stale-uuid')
+        );
+        await expect(svc.validateCreateSecurity(bad)).rejects.toBeInstanceOf(
+            IdentifierValidationError
+        );
+    });
+
+    test('createSecurity rejects empty identifier_value before RPC', async () => {
+        const svc = new SecurityService();
+        (svc as any).client = failingClient();
+        const bad = securityWith(
+            makeIdentifier(IdentifierTypeProto.EXCH_TICKER, '')
+        );
+        await expect(svc.createSecurity(bad)).rejects.toBeInstanceOf(
+            IdentifierValidationError
+        );
+    });
+});

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

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

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

@@ -20,15 +20,21 @@ import { ZonedDateTime } from '../models/utils/datetime';
  * 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.
+ * Eviction: bounded LRU. When `put` causes the map to exceed `maxEntries`,
+ * the least-recently-used entry is removed. `get` bumps recency.
+ *
+ * Per-entity singletons SECURITY/PORTFOLIO/PRICE/TRANSACTION are tuned
+ * for the typical access pattern of each entity (Portfolio + Security
+ * change slowly so TTL is 1 day; Price + Transaction change quickly so
+ * TTL is short).
  */
 export declare const DEFAULT_TTL_FOR_LATEST_MS = 600000;
+export declare const DEFAULT_MAX_ENTRIES = 10000;
 export declare class LinkCache<V> {
     private ttlForLatestMs;
+    private maxEntries;
     private map;
-    constructor(ttlForLatestMs?: number);
+    constructor(ttlForLatestMs?: number, maxEntries?: number);
     /**
      * @param uuidKey         the entity uuid rendered as a stable string key
      *                        (use uuid.toString())
@@ -40,9 +46,10 @@ export declare class LinkCache<V> {
     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.
+     * an asOf strictly after the incoming asOf, the write is ignored (but
+     * recency is still bumped — the caller saw a fresh reference).
      */
-    put(uuidKey: string, value: V, asOf: ZonedDateTime): void;
+    put(uuidKey: string, value: V, asOf: ZonedDateTime | null): void;
     evict(uuidKey: string): void;
     clear(): void;
     /** Test helper. */