@fintekkers/ledger-models 0.4.9 → 0.4.11

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/identifier-validation.test.d.ts

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

package/node/wrappers/models/security/identifier-validation.test.js

@@ -0,0 +1,104 @@
+"use strict";
+// Client-side identifier guard tests (FinTekkers/second-brain#347).
+// Pins behaviour of the consumer-side reject so callers fail fast on the
+// client before the gRPC round-trip, mirroring the server's
+// SecurityAPIGRPCImpl.validateCreateRequest UNKNOWN_IDENTIFIER_TYPE check.
+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("./identifier");
+function makeIdentifier(type, value) {
+    const p = new identifier_pb_1.IdentifierProto();
+    p.setIdentifierType(type);
+    p.setIdentifierValue(value);
+    return p;
+}
+// ---------- validateIdentifierProto ----------
+describe('validateIdentifierProto', () => {
+    test('rejects UNKNOWN_IDENTIFIER_TYPE with a helpful message', () => {
+        const bad = makeIdentifier(identifier_type_pb_1.IdentifierTypeProto.UNKNOWN_IDENTIFIER_TYPE, 'some-uuid-hex');
+        let err;
+        try {
+            (0, identifier_1.validateIdentifierProto)(bad);
+        }
+        catch (e) {
+            err = e;
+        }
+        expect(err).toBeInstanceOf(identifier_1.IdentifierValidationError);
+        expect(err.message).toMatch(/UNKNOWN_IDENTIFIER_TYPE/);
+        // Surfaces the valid alternatives so the caller can fix the typo
+        expect(err.message).toMatch(/EXCH_TICKER/);
+        expect(err.message).toMatch(/#347/);
+    });
+    test('rejects a default-constructed identifier (type=0, empty value)', () => {
+        const bad = new identifier_pb_1.IdentifierProto();
+        expect(() => (0, identifier_1.validateIdentifierProto)(bad)).toThrow(identifier_1.IdentifierValidationError);
+    });
+    test('rejects empty identifier_value with the type name in the message', () => {
+        const bad = makeIdentifier(identifier_type_pb_1.IdentifierTypeProto.EXCH_TICKER, '');
+        let err;
+        try {
+            (0, identifier_1.validateIdentifierProto)(bad);
+        }
+        catch (e) {
+            err = e;
+        }
+        expect(err).toBeInstanceOf(identifier_1.IdentifierValidationError);
+        expect(err.message).toMatch(/empty/);
+        expect(err.message).toMatch(/EXCH_TICKER/);
+    });
+    test('rejects whitespace-only identifier_value', () => {
+        const bad = makeIdentifier(identifier_type_pb_1.IdentifierTypeProto.CUSIP, '   ');
+        expect(() => (0, identifier_1.validateIdentifierProto)(bad)).toThrow(identifier_1.IdentifierValidationError);
+    });
+    test.each([
+        ['EXCH_TICKER', identifier_type_pb_1.IdentifierTypeProto.EXCH_TICKER, 'AAPL'],
+        ['ISIN', identifier_type_pb_1.IdentifierTypeProto.ISIN, 'US0378331005'],
+        ['CUSIP', identifier_type_pb_1.IdentifierTypeProto.CUSIP, '037833100'],
+        ['FIGI', identifier_type_pb_1.IdentifierTypeProto.FIGI, 'BBG000B9XRY4'],
+        ['OSI', identifier_type_pb_1.IdentifierTypeProto.OSI, 'AAPL 250620C00150000'],
+        ['SERIES_ID', identifier_type_pb_1.IdentifierTypeProto.SERIES_ID, 'GS10'],
+        ['INDEX_NAME', identifier_type_pb_1.IdentifierTypeProto.INDEX_NAME, 'SPX'],
+        ['CASH', identifier_type_pb_1.IdentifierTypeProto.CASH, 'USD'],
+    ])('accepts every real identifier type (%s)', (_name, type, value) => {
+        const good = makeIdentifier(type, value);
+        expect(() => (0, identifier_1.validateIdentifierProto)(good)).not.toThrow();
+    });
+    test('IdentifierValidationError is an Error', () => {
+        // Catch-by-Error still works for callers that don't import the
+        // specific subclass.
+        const err = new identifier_1.IdentifierValidationError('x');
+        expect(err).toBeInstanceOf(Error);
+        expect(err.name).toBe('IdentifierValidationError');
+    });
+});
+// ---------- validateIdentifiersForCreate ----------
+describe('validateIdentifiersForCreate', () => {
+    test('passes when every identifier on the SecurityProto is well-typed', () => {
+        const security = new security_pb_1.SecurityProto();
+        security.addIdentifiers(makeIdentifier(identifier_type_pb_1.IdentifierTypeProto.EXCH_TICKER, 'AAPL'));
+        security.addIdentifiers(makeIdentifier(identifier_type_pb_1.IdentifierTypeProto.ISIN, 'US0378331005'));
+        expect(() => (0, identifier_1.validateIdentifiersForCreate)(security)).not.toThrow();
+    });
+    test('rejects when any identifier in the list is UNKNOWN_IDENTIFIER_TYPE', () => {
+        const security = new security_pb_1.SecurityProto();
+        security.addIdentifiers(makeIdentifier(identifier_type_pb_1.IdentifierTypeProto.EXCH_TICKER, 'AAPL'));
+        security.addIdentifiers(makeIdentifier(identifier_type_pb_1.IdentifierTypeProto.UNKNOWN_IDENTIFIER_TYPE, 'stale-uuid'));
+        expect(() => (0, identifier_1.validateIdentifiersForCreate)(security)).toThrow(identifier_1.IdentifierValidationError);
+    });
+    test('skips link-mode securities (is_link=true)', () => {
+        // Link-mode = reference handle (uuid + as_of only); no identifiers
+        // attached. The guard must skip rather than over-trigger.
+        const link = new security_pb_1.SecurityProto();
+        link.setIsLink(true);
+        expect(() => (0, identifier_1.validateIdentifiersForCreate)(link)).not.toThrow();
+    });
+    test('passes on empty identifiers list (server enforces "at least one")', () => {
+        // Our consumer-side check polices the *type* of every attached
+        // identifier; the "must have ≥1 identifier" rule lives server-side.
+        const security = new security_pb_1.SecurityProto();
+        expect(() => (0, identifier_1.validateIdentifiersForCreate)(security)).not.toThrow();
+    });
+});
+//# sourceMappingURL=identifier-validation.test.js.map

package/node/wrappers/models/security/identifier-validation.test.js.map

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