@fintekkers/ledger-models 0.1.130 → 0.1.132

package/node/wrappers/services/searchWithSecurities.test.js

@@ -0,0 +1,125 @@
+"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) {
+        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 PriceService_1 = require("./price-service/PriceService");
+const link_resolver_1 = __importDefault(require("../util/link-resolver"));
+const Price_1 = __importDefault(require("../models/price/Price"));
+const uuid_1 = require("../models/utils/uuid");
+const positionfilter_1 = require("../models/position/positionfilter");
+const dt = __importStar(require("../models/utils/datetime"));
+const security_pb_1 = require("../../fintekkers/models/security/security_pb");
+const price_pb_1 = require("../../fintekkers/models/price/price_pb");
+const decimal_value_pb_1 = require("../../fintekkers/models/util/decimal_value_pb");
+const identifier_pb_1 = require("../../fintekkers/models/security/identifier/identifier_pb");
+const query_security_response_pb_1 = require("../../fintekkers/requests/security/query_security_response_pb");
+/**
+ * End-to-end test: priceService.searchWithSecurities resolves all link
+ * securities embedded in the returned Prices via a single batched
+ * GetByIds RPC.
+ */
+function fullSecurity(uuid, issuerName) {
+    const proto = new security_pb_1.SecurityProto();
+    proto.setObjectClass('Security');
+    proto.setVersion('0.0.1');
+    proto.setUuid(uuid.toUUIDProto());
+    proto.setIsLink(false);
+    proto.setIssuerName(issuerName);
+    const ident = new identifier_pb_1.IdentifierProto();
+    ident.setIdentifierValue(`TICKER-${issuerName}`);
+    proto.setIdentifier(ident);
+    return proto;
+}
+function linkPriceProto(securityUuid, priceValue) {
+    const linkSec = new security_pb_1.SecurityProto();
+    linkSec.setUuid(securityUuid.toUUIDProto());
+    linkSec.setIsLink(true);
+    const priceProto = new price_pb_1.PriceProto();
+    priceProto.setObjectClass('Price');
+    priceProto.setVersion('0.0.1');
+    priceProto.setUuid(uuid_1.UUID.random().toUUIDProto());
+    priceProto.setSecurity(linkSec);
+    const dv = new decimal_value_pb_1.DecimalValueProto();
+    dv.setArbitraryPrecisionValue(priceValue);
+    priceProto.setPrice(dv);
+    return priceProto;
+}
+test('PriceService.searchWithSecurities returns hydrated Prices end-to-end', () => __awaiter(void 0, void 0, void 0, function* () {
+    const uuidA = uuid_1.UUID.random();
+    const uuidB = uuid_1.UUID.random();
+    const store = new Map([
+        [uuidA.toString(), fullSecurity(uuidA, 'AAPL')],
+        [uuidB.toString(), fullSecurity(uuidB, 'MSFT')],
+    ]);
+    const callLog = { count: 0 };
+    // Stub LinkResolver with a mock SecurityClient.
+    const mockSecurityClient = {
+        getByIds: (request, callback) => {
+            callLog.count += 1;
+            const requested = request.getUuidsList().map((u) => uuid_1.UUID.fromU8Array(u.getRawUuid_asU8()).toString());
+            const response = new query_security_response_pb_1.QuerySecurityResponseProto();
+            response.setSecurityResponseList(requested.map((u) => store.get(u)).filter(Boolean));
+            setImmediate(() => callback(null, response));
+        },
+    };
+    const linkResolver = new link_resolver_1.default({
+        securityClient: mockSecurityClient,
+        portfolioClient: {},
+    });
+    // Stub PriceService.search to skip the gRPC stream and return canned Prices.
+    const priceService = new PriceService_1.PriceService();
+    jest
+        .spyOn(priceService, 'search')
+        .mockResolvedValue([
+        new Price_1.default(linkPriceProto(uuidA, '100')),
+        new Price_1.default(linkPriceProto(uuidA, '101')),
+        new Price_1.default(linkPriceProto(uuidB, '200')),
+    ]);
+    const asOf = dt.ZonedDateTime.now().toProto();
+    const filter = new positionfilter_1.PositionFilter();
+    const prices = yield priceService.searchWithSecurities(asOf, filter, linkResolver);
+    expect(prices).toHaveLength(3);
+    // 1 batched RPC for 2 unique security UUIDs.
+    expect(callLog.count).toBe(1);
+    // Every Price now has a hydrated full Security embedded.
+    for (const p of prices) {
+        const sec = p.proto.getSecurity();
+        expect(sec.getIsLink()).toBe(false);
+        expect(['AAPL', 'MSFT']).toContain(sec.getIssuerName());
+        expect(sec.getIdentifier().getIdentifierValue()).toMatch(/^TICKER-/);
+    }
+}));
+//# sourceMappingURL=searchWithSecurities.test.js.map

package/node/wrappers/services/searchWithSecurities.test.js.map

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

package/node/wrappers/services/searchWithSecurities.test.ts

@@ -0,0 +1,103 @@
+import { PriceService } from './price-service/PriceService';
+import LinkResolver from '../util/link-resolver';
+import Price from '../models/price/Price';
+import { UUID } from '../models/utils/uuid';
+import { PositionFilter } from '../models/position/positionfilter';
+import * as dt from '../models/utils/datetime';
+
+import { SecurityProto } from '../../fintekkers/models/security/security_pb';
+import { PriceProto } from '../../fintekkers/models/price/price_pb';
+import { DecimalValueProto } from '../../fintekkers/models/util/decimal_value_pb';
+import { IdentifierProto } from '../../fintekkers/models/security/identifier/identifier_pb';
+import { QuerySecurityResponseProto } from '../../fintekkers/requests/security/query_security_response_pb';
+import { QuerySecurityRequestProto } from '../../fintekkers/requests/security/query_security_request_pb';
+
+/**
+ * End-to-end test: priceService.searchWithSecurities resolves all link
+ * securities embedded in the returned Prices via a single batched
+ * GetByIds RPC.
+ */
+
+function fullSecurity(uuid: UUID, issuerName: string): SecurityProto {
+  const proto = new SecurityProto();
+  proto.setObjectClass('Security');
+  proto.setVersion('0.0.1');
+  proto.setUuid(uuid.toUUIDProto());
+  proto.setIsLink(false);
+  proto.setIssuerName(issuerName);
+  const ident = new IdentifierProto();
+  ident.setIdentifierValue(`TICKER-${issuerName}`);
+  proto.setIdentifier(ident);
+  return proto;
+}
+
+function linkPriceProto(securityUuid: UUID, priceValue: string): PriceProto {
+  const linkSec = new SecurityProto();
+  linkSec.setUuid(securityUuid.toUUIDProto());
+  linkSec.setIsLink(true);
+
+  const priceProto = new PriceProto();
+  priceProto.setObjectClass('Price');
+  priceProto.setVersion('0.0.1');
+  priceProto.setUuid(UUID.random().toUUIDProto());
+  priceProto.setSecurity(linkSec);
+  const dv = new DecimalValueProto();
+  dv.setArbitraryPrecisionValue(priceValue);
+  priceProto.setPrice(dv);
+  return priceProto;
+}
+
+test('PriceService.searchWithSecurities returns hydrated Prices end-to-end', async () => {
+  const uuidA = UUID.random();
+  const uuidB = UUID.random();
+  const store = new Map<string, SecurityProto>([
+    [uuidA.toString(), fullSecurity(uuidA, 'AAPL')],
+    [uuidB.toString(), fullSecurity(uuidB, 'MSFT')],
+  ]);
+  const callLog = { count: 0 };
+
+  // Stub LinkResolver with a mock SecurityClient.
+  const mockSecurityClient = {
+    getByIds: (
+      request: QuerySecurityRequestProto,
+      callback: (err: Error | null, response: QuerySecurityResponseProto) => void,
+    ) => {
+      callLog.count += 1;
+      const requested = request.getUuidsList().map((u) => UUID.fromU8Array(u.getRawUuid_asU8()).toString());
+      const response = new QuerySecurityResponseProto();
+      response.setSecurityResponseList(requested.map((u) => store.get(u)!).filter(Boolean));
+      setImmediate(() => callback(null, response));
+    },
+  } as any;
+
+  const linkResolver = new LinkResolver({
+    securityClient: mockSecurityClient,
+    portfolioClient: {} as any,
+  });
+
+  // Stub PriceService.search to skip the gRPC stream and return canned Prices.
+  const priceService = new PriceService();
+  jest
+    .spyOn(priceService, 'search')
+    .mockResolvedValue([
+      new Price(linkPriceProto(uuidA, '100')),
+      new Price(linkPriceProto(uuidA, '101')),
+      new Price(linkPriceProto(uuidB, '200')),
+    ]);
+
+  const asOf = dt.ZonedDateTime.now().toProto();
+  const filter = new PositionFilter();
+
+  const prices = await priceService.searchWithSecurities(asOf, filter, linkResolver);
+
+  expect(prices).toHaveLength(3);
+  // 1 batched RPC for 2 unique security UUIDs.
+  expect(callLog.count).toBe(1);
+  // Every Price now has a hydrated full Security embedded.
+  for (const p of prices) {
+    const sec = p.proto.getSecurity()!;
+    expect(sec.getIsLink()).toBe(false);
+    expect(['AAPL', 'MSFT']).toContain(sec.getIssuerName());
+    expect(sec.getIdentifier()!.getIdentifierValue()).toMatch(/^TICKER-/);
+  }
+});

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

@@ -3,11 +3,25 @@ import { PositionFilter } from '../../models/position/positionfilter';
 import { LocalTimestampProto } from '../../../fintekkers/models/util/local_timestamp_pb';
 import { SummaryProto } from '../../../fintekkers/requests/util/errors/summary_pb';
 import { CreateTransactionResponseProto } from '../../../fintekkers/requests/transaction/create_transaction_response_pb';
+import LinkResolver from '../../util/link-resolver';
 declare class TransactionService {
     private client;
     constructor(apiKey?: string);
     validateCreateTransaction(transaction: Transaction): Promise<SummaryProto>;
     createTransaction(transaction: Transaction): Promise<CreateTransactionResponseProto>;
     searchTransaction(asOf: LocalTimestampProto, positionFilter: PositionFilter, maxResults?: number): Promise<Transaction[]>;
+    /**
+     * Search transactions and hydrate each Transaction's embedded Security
+     * AND Portfolio from link to full entity, with both fetches batched.
+     *
+     * Pass a shared `linkResolver` to share caching across multiple
+     * service-wrapper calls in the same request scope. If omitted, a new
+     * resolver is constructed per call.
+     *
+     * Mutates each returned Transaction.proto's embedded SecurityProto and
+     * PortfolioProto in place (link → full). See LinkResolver for cache +
+     * dedupe semantics.
+     */
+    searchWithSecurityAndPortfolio(asOf: LocalTimestampProto, positionFilter: PositionFilter, maxResults?: number, linkResolver?: LinkResolver): Promise<Transaction[]>;
 }
 export { TransactionService };

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

@@ -22,6 +22,7 @@ const transaction_service_grpc_pb_1 = require("../../../fintekkers/services/tran
 const create_transaction_request_pb_1 = require("../../../fintekkers/requests/transaction/create_transaction_request_pb");
 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"));
 class TransactionService {
     constructor(apiKey) {
         if (apiKey) {
@@ -86,6 +87,30 @@ class TransactionService {
         }
         return processStreamSynchronously();
     }
+    /**
+     * Search transactions and hydrate each Transaction's embedded Security
+     * AND Portfolio from link to full entity, with both fetches batched.
+     *
+     * Pass a shared `linkResolver` to share caching across multiple
+     * service-wrapper calls in the same request scope. If omitted, a new
+     * resolver is constructed per call.
+     *
+     * Mutates each returned Transaction.proto's embedded SecurityProto and
+     * PortfolioProto in place (link → full). See LinkResolver for cache +
+     * dedupe semantics.
+     */
+    searchWithSecurityAndPortfolio(asOf, positionFilter, maxResults = 100, linkResolver) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const txns = yield this.searchTransaction(asOf, positionFilter, maxResults);
+            const resolver = linkResolver !== null && linkResolver !== void 0 ? linkResolver : new link_resolver_1.default();
+            // Run both resolves in parallel — they hit different services.
+            yield Promise.all([
+                resolver.resolveSecurities(txns),
+                resolver.resolvePortfolios(txns),
+            ]);
+            return txns;
+        });
+    }
 }
 exports.TransactionService = TransactionService;
 //# sourceMappingURL=TransactionService.js.map

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

@@ -15,6 +15,7 @@ import { CreateTransactionResponseProto } from '../../../fintekkers/requests/tra
 import { QueryTransactionRequestProto } from '../../../fintekkers/requests/transaction/query_transaction_request_pb';
 import { QueryTransactionResponseProto } from '../../../fintekkers/requests/transaction/query_transaction_response_pb';
 import EnvConfig from '../../models/utils/requestcontext';
+import LinkResolver from '../../util/link-resolver';
 
 
 class TransactionService {
@@ -89,6 +90,34 @@ class TransactionService {
 
     return processStreamSynchronously();
   }
+
+  /**
+   * Search transactions and hydrate each Transaction's embedded Security
+   * AND Portfolio from link to full entity, with both fetches batched.
+   *
+   * Pass a shared `linkResolver` to share caching across multiple
+   * service-wrapper calls in the same request scope. If omitted, a new
+   * resolver is constructed per call.
+   *
+   * Mutates each returned Transaction.proto's embedded SecurityProto and
+   * PortfolioProto in place (link → full). See LinkResolver for cache +
+   * dedupe semantics.
+   */
+  async searchWithSecurityAndPortfolio(
+    asOf: LocalTimestampProto,
+    positionFilter: PositionFilter,
+    maxResults: number = 100,
+    linkResolver?: LinkResolver,
+  ): Promise<Transaction[]> {
+    const txns = await this.searchTransaction(asOf, positionFilter, maxResults);
+    const resolver = linkResolver ?? new LinkResolver();
+    // Run both resolves in parallel — they hit different services.
+    await Promise.all([
+      resolver.resolveSecurities(txns),
+      resolver.resolvePortfolios(txns),
+    ]);
+    return txns;
+  }
 }
 
 export { TransactionService };

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

@@ -0,0 +1,127 @@
+import { SecurityProto } from '../../fintekkers/models/security/security_pb';
+import { PortfolioProto } from '../../fintekkers/models/portfolio/portfolio_pb';
+import { LocalTimestampProto } from '../../fintekkers/models/util/local_timestamp_pb';
+import { SecurityClient } from '../../fintekkers/services/security-service/security_service_grpc_pb';
+import { PortfolioClient } from '../../fintekkers/services/portfolio-service/portfolio_service_grpc_pb';
+import Security from '../models/security/security';
+import Portfolio from '../models/portfolio/portfolio';
+import { UUID } from '../models/utils/uuid';
+/**
+ * LinkResolver — bulk hydration of `is_link=true` entity references into
+ * full entities. Implements the consumer side of the `is_link` pattern
+ * documented in `docs/adr/is_link_pattern.md`.
+ *
+ * Two surface methods:
+ *   - getSecurity(uuid) / getPortfolio(uuid): single-UUID resolution. Cached
+ *     and concurrent-deduped.
+ *   - resolveSecurities(items) / resolvePortfolios(items): bulk in-place
+ *     mutation across a heterogeneous list of items that each have a
+ *     proto-style getter+setter for the embedded entity. Collects unique
+ *     link UUIDs, fires one batched GetByIds RPC, mutates each item's proto
+ *     to swap the link sub-message for the resolved full entity (with
+ *     is_link=false on the embedded copy).
+ *
+ * Caching:
+ *   - Process-level LRU keyed on UUID string. Default 1000 entries, no TTL
+ *     (entries live until evicted by LRU). Long-running services that need
+ *     freshness should pass `{ ttlMs: <ms> }`. Tests can disable with
+ *     `{ cacheSize: 0 }`.
+ *   - Concurrent same-UUID requests are deduped via an in-flight promise
+ *     map — N parallel callers for the same UUID share one RPC.
+ *
+ * RPC choice: uses `GetByIds` (unary, UUID-keyed bulk) per the ADR. The
+ * existing `SecurityService.search` (streaming) would also work but
+ * requires more wrapper plumbing for batched-by-UUID semantics.
+ *
+ * Mutation semantic: when bulk-resolving, the embedded sub-message is
+ * replaced (not the outer entity). Outer Price.proto.is_link is unchanged;
+ * only the inner SecurityProto is swapped from link-stub to full entity.
+ * Wrapper objects that read through the proto (`price.getSecurity()`)
+ * automatically see the resolved data.
+ *
+ * Time-travel (`as_of`) semantic: per is_link_pattern.md addendum, when
+ * a link sub-message has only `uuid` set the resolver fetches the latest
+ * version. When the link sub-message ALSO has `as_of` set, the resolver
+ * fetches the version of the entity as of that timestamp. The cache is
+ * keyed on (uuid, as_of) so the same UUID at different timestamps does
+ * not collide. Bulk lookups group by `as_of` (one GetByIds RPC per unique
+ * timestamp bucket, since the request proto carries a single as_of).
+ */
+export interface LinkResolverOptions {
+    /** Optional API key. If omitted, EnvConfig.apiCredentials is used. */
+    apiKey?: string;
+    /** LRU max entries. Default 1000. Set to 0 to disable caching. */
+    cacheSize?: number;
+    /** Per-entry TTL in ms. Default undefined (no expiry). */
+    ttlMs?: number;
+    /**
+     * Test injection: clients to use instead of constructing real ones.
+     * Production callers should not set these.
+     */
+    securityClient?: SecurityClient;
+    portfolioClient?: PortfolioClient;
+}
+declare class LinkResolver {
+    private securityClient;
+    private portfolioClient;
+    private securityCache;
+    private portfolioCache;
+    private securityInFlight;
+    private portfolioInFlight;
+    constructor(opts?: LinkResolverOptions);
+    /**
+     * Resolve a single SecurityProto by UUID. If `asOf` is supplied, fetch
+     * the version of the entity as of that timestamp; otherwise fetch the
+     * latest. Cached + concurrent-deduped on the (uuid, asOf) pair.
+     * Throws if the server doesn't return the UUID (no silent null).
+     */
+    getSecurity(uuid: UUID, asOf?: LocalTimestampProto): Promise<Security>;
+    /**
+     * Resolve a single PortfolioProto by UUID, optionally as of `asOf`.
+     * Cached + concurrent-deduped on (uuid, asOf).
+     */
+    getPortfolio(uuid: UUID, asOf?: LocalTimestampProto): Promise<Portfolio>;
+    /**
+     * Walk `items`, find the ones whose embedded security is `is_link=true`,
+     * batch-fetch the unique (uuid, as_of) pairs (grouped by as_of so each
+     * GetByIds RPC carries one timestamp), and mutate each item's proto in
+     * place so subsequent `item.getSecurity()` calls return the full entity.
+     * Returns the same array for chaining.
+     *
+     * Honors per-link `as_of`: if the embedded sub-message has `as_of` set,
+     * the resolver fetches the version of the entity at that timestamp,
+     * not the latest.
+     *
+     * `T` is structural: anything with a `proto` field that exposes
+     * `getSecurity()` / `setSecurity()` works (Price, Transaction, etc).
+     */
+    resolveSecurities<T extends ResolvableSecurity>(items: T[]): Promise<T[]>;
+    /**
+     * Same shape as resolveSecurities, but for embedded PortfolioProto.
+     * Honors per-link `as_of` the same way.
+     */
+    resolvePortfolios<T extends ResolvablePortfolio>(items: T[]): Promise<T[]>;
+    /** Test/debug helper. Not part of the stable API. */
+    clearCache(): void;
+    private fetchSecurityProto;
+    private fetchPortfolioProto;
+    private batchFetchSecurities;
+    private batchFetchPortfolios;
+}
+/**
+ * Structural type — anything with a proto that has getSecurity/setSecurity
+ * (Price, Transaction, etc.) is resolvable.
+ */
+export interface ResolvableSecurity {
+    proto: {
+        getSecurity(): SecurityProto | undefined;
+        setSecurity(s: SecurityProto): unknown;
+    };
+}
+export interface ResolvablePortfolio {
+    proto: {
+        getPortfolio(): PortfolioProto | undefined;
+        setPortfolio(p: PortfolioProto): unknown;
+    };
+}
+export default LinkResolver;