@fintekkers/ledger-models 0.4.36 → 0.4.38

package/node/wrappers/util/object-types.test.js

@@ -0,0 +1,311 @@
+"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 });
+// Compact object type and version (LM-297): writers set both forms, readers
+// translate the strings-only form. Rows come from the shared fixture
+// test-fixtures/object-type-legacy.json, which Java, Python and Rust also load.
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const decimal_js_1 = require("decimal.js");
+const object_type_pb_1 = require("../../fintekkers/models/util/object_type_pb");
+const security_pb_1 = require("../../fintekkers/models/security/security_pb");
+const price_pb_1 = require("../../fintekkers/models/price/price_pb");
+const transaction_pb_1 = require("../../fintekkers/models/transaction/transaction_pb");
+const portfolio_pb_1 = require("../../fintekkers/models/portfolio/portfolio_pb");
+const transaction_type_pb_1 = require("../../fintekkers/models/transaction/transaction_type_pb");
+const position_pb_1 = require("../../fintekkers/models/position/position_pb");
+const query_security_response_pb_1 = require("../../fintekkers/requests/security/query_security_response_pb");
+const query_portfolio_response_pb_1 = require("../../fintekkers/requests/portfolio/query_portfolio_response_pb");
+const query_transaction_response_pb_1 = require("../../fintekkers/requests/transaction/query_transaction_response_pb");
+const summary_pb_1 = require("../../fintekkers/requests/util/errors/summary_pb");
+const objectTypes = __importStar(require("./object-types"));
+const link_resolver_1 = __importDefault(require("./link-resolver"));
+const Price_1 = __importDefault(require("../models/price/Price"));
+const security_1 = __importDefault(require("../models/security/security"));
+const portfolio_1 = __importDefault(require("../models/portfolio/portfolio"));
+const transaction_1 = __importDefault(require("../models/transaction/transaction"));
+const transaction_type_1 = require("../models/transaction/transaction_type");
+const positionfilter_1 = require("../models/position/positionfilter");
+const QueryPositionRequest_1 = require("../requests/position/QueryPositionRequest");
+const uuid_1 = require("../models/utils/uuid");
+const datetime_1 = require("../models/utils/datetime");
+const PriceService_1 = require("../services/price-service/PriceService");
+const SecurityService_1 = require("../services/security-service/SecurityService");
+const TransactionService_1 = require("../services/transaction-service/TransactionService");
+const PortfolioService_1 = require("../services/portfolio-service/PortfolioService");
+const REPO_ROOT = path.resolve(__dirname, '../../../..');
+const CASES = JSON.parse(fs.readFileSync(path.join(REPO_ROOT, 'test-fixtures', 'object-type-legacy.json'), 'utf8')).cases;
+const COMPACT_NUMBERS = {
+    object_type: 1001, version_major: 1002, version_minor: 1003, version_patch: 1004,
+};
+/** Generated message classes by proto full name: the package is the directory under node/. */
+function messageClasses() {
+    const root = path.resolve(__dirname, '../../fintekkers');
+    const classes = new Map();
+    const walk = (dir) => {
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walk(full);
+            }
+            else if (entry.name.endsWith('_pb.js')) {
+                const pkg = path.relative(path.dirname(root), dir).split(path.sep).join('.');
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                for (const [name, cls] of Object.entries(require(full))) {
+                    classes.set(`${pkg}.${name}`, cls);
+                }
+            }
+        }
+    };
+    walk(root);
+    return classes;
+}
+const CLASSES = messageClasses();
+function decode(c) {
+    const cls = CLASSES.get(c.message);
+    if (!cls)
+        throw new Error(`no generated class for ${c.message}`);
+    return cls.deserializeBinary(Buffer.from(c.bytes, 'base64'));
+}
+/** Field numbers present at the top level of an encoded message. */
+function topLevelFieldNumbers(data) {
+    const numbers = [];
+    let i = 0;
+    const varint = () => {
+        let result = 0;
+        let scale = 1;
+        for (;;) {
+            const b = data[i++];
+            result += (b & 0x7f) * scale;
+            scale *= 128;
+            if (!(b & 0x80))
+                return result;
+        }
+    };
+    while (i < data.length) {
+        const key = varint();
+        numbers.push(Math.floor(key / 8));
+        const wireType = key % 8;
+        if (wireType === 0)
+            varint();
+        else if (wireType === 1)
+            i += 8;
+        else if (wireType === 2) {
+            const length = varint();
+            i += length;
+        }
+        else if (wireType === 5)
+            i += 4;
+        else
+            throw new Error(`unexpected wire type ${wireType}`);
+    }
+    return numbers;
+}
+let warn;
+beforeEach(() => {
+    objectTypes.resetWarningsForTests();
+    warn = jest.spyOn(console, 'warn').mockImplementation(() => undefined);
+});
+afterEach(() => {
+    warn.mockRestore();
+    objectTypes.resetWarningsForTests();
+});
+const fallbackWarnings = () => warn.mock.calls.filter((args) => String(args[0]).includes('(LM-297)')).length;
+// ---- Loading the old form translates it (metric 3) ----
+describe.each(CASES.map((c) => [c.name, c]))('fixture row %s', (_name, c) => {
+    test('decodes to the expected type and version', () => {
+        const message = decode(c);
+        expect(objectTypes.readType(message)).toBe(object_type_pb_1.ObjectTypeProto[c.expect.object_type]);
+        expect(objectTypes.readVersion(message)).toEqual(c.expect.version);
+        expect(fallbackWarnings()).toBe(c.expect.warns ? 1 : 0);
+    });
+    test('re-serialises with the compact fields once upgraded', () => {
+        const data = objectTypes.upgrade(decode(c)).serializeBinary();
+        const expected = {
+            object_type: object_type_pb_1.ObjectTypeProto[c.expect.object_type],
+            version_major: c.expect.version[0],
+            version_minor: c.expect.version[1],
+            version_patch: c.expect.version[2],
+        };
+        const present = topLevelFieldNumbers(data);
+        for (const [name, number] of Object.entries(COMPACT_NUMBERS)) {
+            expect([name, present.includes(number)]).toEqual([name, expected[name] !== 0]);
+        }
+        const reread = CLASSES.get(c.message).deserializeBinary(data);
+        expect([reread.getObjectType(), reread.getVersionMajor(), reread.getVersionMinor(), reread.getVersionPatch()])
+            .toEqual([expected.object_type, expected.version_major, expected.version_minor, expected.version_patch]);
+        expect([reread.getObjectClass(), reread.getVersion()]).toEqual([c.object_class, c.version]);
+    });
+});
+// ---- Reading the strings is deprecated (metric 4) ----
+test('three strings-only decodes of one type warn once', () => {
+    const c = CASES.find((row) => row.name === 'js-PositionFilterProto');
+    for (let i = 0; i < 3; i++) {
+        objectTypes.upgrade(decode(c));
+    }
+    expect(fallbackWarnings()).toBe(1);
+});
+test('the new form does not warn', () => {
+    const message = objectTypes.stamp(new price_pb_1.PriceProto(), object_type_pb_1.ObjectTypeProto.OBJECT_TYPE_PRICE, 'Price', '0.0.1');
+    objectTypes.readType(message);
+    objectTypes.readVersion(message);
+    expect(fallbackWarnings()).toBe(0);
+});
+// ---- Writers set both forms (metric 2) ----
+/** A service with its gRPC client swapped for one that records each request. */
+function capturingService(cls, response) {
+    const requests = [];
+    const unary = (request, callback) => {
+        requests.push(request);
+        callback(null, response());
+    };
+    const stream = (request) => {
+        requests.push(request);
+        const handlers = {};
+        setImmediate(() => { var _a; return (_a = handlers.end) === null || _a === void 0 ? void 0 : _a.call(handlers); });
+        return { on(event, handler) { handlers[event] = handler; return this; } };
+    };
+    const service = Object.create(cls.prototype);
+    service.client = {
+        validateCreateOrUpdate: unary, search: stream,
+    };
+    return { service, requests };
+}
+const asOf = datetime_1.ZonedDateTime.now().toProto();
+const filter = () => new positionfilter_1.PositionFilter();
+function security() {
+    return security_1.default.create(new security_pb_1.SecurityProto().setUuid(uuid_1.UUID.random().toUUIDProto()).setAssetClass('Equity'));
+}
+function portfolio() {
+    return new portfolio_1.default(new portfolio_pb_1.PortfolioProto().setUuid(uuid_1.UUID.random().toUUIDProto()).setPortfolioName('P').setAsOf(asOf));
+}
+function linkResolverRequests() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const requests = [];
+        const client = (response) => ({
+            getByIds: (request, callback) => {
+                requests.push(request);
+                callback(null, response());
+            },
+        });
+        const resolver = new link_resolver_1.default({
+            securityClient: client(() => new query_security_response_pb_1.QuerySecurityResponseProto()),
+            portfolioClient: client(() => new query_portfolio_response_pb_1.QueryPortfolioResponseProto()),
+            transactionClient: client(() => new query_transaction_response_pb_1.QueryTransactionResponseProto()),
+        });
+        // Nothing comes back, so each lookup rejects as not found.
+        yield expect(resolver.getSecurity(uuid_1.UUID.random())).rejects.toThrow();
+        yield expect(resolver.getPortfolio(uuid_1.UUID.random())).rejects.toThrow();
+        yield expect(resolver.getTransaction(uuid_1.UUID.random())).rejects.toThrow();
+        return requests;
+    });
+}
+function lastRequest(cls, call) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { service, requests } = capturingService(cls, () => new summary_pb_1.SummaryProto());
+        yield call(service);
+        return requests[requests.length - 1];
+    });
+}
+const LIBRARY_WRITERS = [
+    ['Price.fromSimple', () => __awaiter(void 0, void 0, void 0, function* () { return Price_1.default.fromSimple(uuid_1.UUID.random().toString(), 1, new Date()).proto; }),
+        object_type_pb_1.ObjectTypeProto.OBJECT_TYPE_PRICE, 'Price', '0.0.1'],
+    ['Price.create', () => __awaiter(void 0, void 0, void 0, function* () { return Price_1.default.create(new decimal_js_1.Decimal(1), security(), datetime_1.ZonedDateTime.now()).proto; }),
+        object_type_pb_1.ObjectTypeProto.OBJECT_TYPE_PRICE, 'Price', '0.0.1'],
+    ['PositionFilter.toProto', () => __awaiter(void 0, void 0, void 0, function* () { return filter().toProto(); }),
+        object_type_pb_1.ObjectTypeProto.OBJECT_TYPE_POSITION_FILTER, 'PositionFilter', '0.0.1'],
+    ['QueryPositionRequest.toProto', () => __awaiter(void 0, void 0, void 0, function* () {
+            return new QueryPositionRequest_1.QueryPositionRequest(filter(), position_pb_1.PositionTypeProto.TRANSACTION, position_pb_1.PositionViewProto.DEFAULT_VIEW, [], [], datetime_1.ZonedDateTime.now()).toProto();
+        }),
+        object_type_pb_1.ObjectTypeProto.OBJECT_TYPE_QUERY_POSITION_REQUEST, '', '1.0.0'],
+    ['Transaction', () => __awaiter(void 0, void 0, void 0, function* () { return transaction().proto; }),
+        object_type_pb_1.ObjectTypeProto.OBJECT_TYPE_TRANSACTION, 'Transaction', '0.0.1'],
+    ['Transaction strategy allocation', () => __awaiter(void 0, void 0, void 0, function* () { return transaction().proto.getStrategyAllocation(); }),
+        object_type_pb_1.ObjectTypeProto.OBJECT_TYPE_STRATEGY_ALLOCATION, 'StrategyAllocation', '0.0.1'],
+    ['PriceService.validateCreateOrUpdate', () => lastRequest(PriceService_1.PriceService, (s) => s.validateCreateOrUpdate(new price_pb_1.PriceProto())),
+        object_type_pb_1.ObjectTypeProto.OBJECT_TYPE_CREATE_PRICE_REQUEST, 'PriceRequest', '0.0.1'],
+    ['PriceService.search', () => lastRequest(PriceService_1.PriceService, (s) => s.search(asOf, filter())),
+        object_type_pb_1.ObjectTypeProto.OBJECT_TYPE_QUERY_PRICE_REQUEST, 'PriceRequest', '0.0.1'],
+    ['SecurityService.validateCreateSecurity', () => lastRequest(SecurityService_1.SecurityService, (s) => s.validateCreateSecurity(new security_pb_1.SecurityProto())),
+        object_type_pb_1.ObjectTypeProto.OBJECT_TYPE_CREATE_SECURITY_REQUEST, 'SecurityRequest', '0.0.1'],
+    ['SecurityService.searchSecurity', () => lastRequest(SecurityService_1.SecurityService, (s) => s.searchSecurity(asOf, filter())),
+        object_type_pb_1.ObjectTypeProto.OBJECT_TYPE_QUERY_SECURITY_REQUEST, 'SecurityRequest', '0.0.1'],
+    ['TransactionService.validateCreateTransaction', () => lastRequest(TransactionService_1.TransactionService, (s) => s.validateCreateTransaction({ proto: new transaction_pb_1.TransactionProto() })),
+        object_type_pb_1.ObjectTypeProto.OBJECT_TYPE_CREATE_TRANSACTION_REQUEST, 'TransactionRequest', '0.0.1'],
+    ['TransactionService.searchTransaction', () => lastRequest(TransactionService_1.TransactionService, (s) => s.searchTransaction(asOf, filter())),
+        object_type_pb_1.ObjectTypeProto.OBJECT_TYPE_QUERY_TRANSACTION_REQUEST, 'SecurityRequest', '0.0.1'],
+    ['PortfolioService.validateCreatePortfolio', () => lastRequest(PortfolioService_1.PortfolioService, (s) => s.validateCreatePortfolio(new portfolio_pb_1.PortfolioProto())),
+        object_type_pb_1.ObjectTypeProto.OBJECT_TYPE_CREATE_PORTFOLIO_REQUEST, 'PortfolioRequest', '0.0.1'],
+    ['PortfolioService.searchPortfolio', () => lastRequest(PortfolioService_1.PortfolioService, (s) => s.searchPortfolio(asOf, filter())),
+        object_type_pb_1.ObjectTypeProto.OBJECT_TYPE_QUERY_PORTFOLIO_REQUEST, 'PortfolioRequest', '0.0.1'],
+    ['LinkResolver securities', () => __awaiter(void 0, void 0, void 0, function* () { return (yield linkResolverRequests())[0]; }),
+        object_type_pb_1.ObjectTypeProto.OBJECT_TYPE_QUERY_SECURITY_REQUEST, 'SecurityRequest', '0.0.1'],
+    ['LinkResolver portfolios', () => __awaiter(void 0, void 0, void 0, function* () { return (yield linkResolverRequests())[1]; }),
+        object_type_pb_1.ObjectTypeProto.OBJECT_TYPE_QUERY_PORTFOLIO_REQUEST, 'PortfolioRequest', '0.0.1'],
+    ['LinkResolver transactions', () => __awaiter(void 0, void 0, void 0, function* () { return (yield linkResolverRequests())[2]; }),
+        object_type_pb_1.ObjectTypeProto.OBJECT_TYPE_QUERY_TRANSACTION_REQUEST, 'TransactionRequest', '0.0.1'],
+];
+function transaction() {
+    return new transaction_1.default({
+        tradeDate: new Date(2024, 0, 15),
+        settlementDate: new Date(2024, 0, 17),
+        asOfDate: new Date(2024, 0, 15, 10, 30, 0),
+        price: new decimal_js_1.Decimal('100.50'),
+        security: security(),
+        transactionType: new transaction_type_1.TransactionType(transaction_type_pb_1.TransactionTypeProto.BUY),
+        portfolio: portfolio(),
+        quantity: new decimal_js_1.Decimal('10'),
+    });
+}
+test.each(LIBRARY_WRITERS)('%s sets strings and compact fields that agree', (_name, build, type, objectClass, version) => __awaiter(void 0, void 0, void 0, function* () {
+    const message = yield build();
+    expect([message.getObjectClass(), message.getVersion()]).toEqual([objectClass, version]);
+    // The message's own type. Some JS writers put a query request's string on the
+    // create request too; the string still sits on one enum value.
+    expect(message.getObjectType()).toBe(type);
+    if (objectClass) {
+        expect(objectTypes.fromLegacy(objectClass)).not.toBe(object_type_pb_1.ObjectTypeProto.OBJECT_TYPE_UNKNOWN);
+    }
+    expect([message.getVersionMajor(), message.getVersionMinor(), message.getVersionPatch()])
+        .toEqual(objectTypes.parseVersion(version));
+    expect(objectTypes.readVersion(message)).toEqual(objectTypes.parseVersion(version));
+    expect(fallbackWarnings()).toBe(0);
+}));
+test('stamp rejects a malformed version', () => {
+    expect(() => objectTypes.stamp(new price_pb_1.PriceProto(), object_type_pb_1.ObjectTypeProto.OBJECT_TYPE_PRICE, 'Price', '1.2')).toThrow();
+});
+//# sourceMappingURL=object-types.test.js.map

package/node/wrappers/util/object-types.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-types.test.js","sourceRoot":"","sources":["object-types.test.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4EAA4E;AAC5E,qEAAqE;AACrE,gFAAgF;AAChF,uCAAyB;AACzB,2CAA6B;AAC7B,2CAAqC;AAErC,gFAA8E;AAC9E,8EAA6E;AAC7E,qEAAoE;AACpE,uFAAsF;AACtF,iFAAgF;AAChF,iGAA+F;AAC/F,8EAAoG;AACpG,8GAA2G;AAC3G,iHAA8G;AAC9G,uHAAoH;AACpH,iFAAgF;AAEhF,4DAA8C;AAE9C,oEAA2C;AAC3C,kEAA0C;AAC1C,2EAAmD;AACnD,8EAAsD;AACtD,oFAA4D;AAC5D,6EAAyE;AACzE,sEAAmE;AACnE,oFAAiF;AACjF,+CAA4C;AAC5C,uDAAyD;AACzD,yEAAsE;AACtE,kFAA+E;AAC/E,2FAAwF;AACxF,qFAAkF;AAYlF,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AACzD,MAAM,KAAK,GAAkB,IAAI,CAAC,KAAK,CACrC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,EAAE,yBAAyB,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;AACnG,MAAM,eAAe,GAA2B;IAC9C,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI;CACjF,CAAC;AAIF,8FAA8F;AAC9F,SAAS,cAAc;IACrB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAChD,MAAM,IAAI,GAAG,CAAC,GAAW,EAAQ,EAAE;QACjC,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE;YAChE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE;gBACvB,IAAI,CAAC,IAAI,CAAC,CAAC;aACZ;iBAAM,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;gBACxC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC7E,8DAA8D;gBAC9D,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE;oBACvD,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,IAAI,EAAE,EAAE,GAAmB,CAAC,CAAC;iBACpD;aACF;SACF;IACH,CAAC,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,CAAC;IACX,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;AAEjC,SAAS,MAAM,CAAC,CAAc;IAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACjE,OAAO,GAAG,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,oEAAoE;AACpE,SAAS,oBAAoB,CAAC,IAAgB;IAC5C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,MAAM,MAAM,GAAG,GAAW,EAAE;QAC1B,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,SAAS;YACP,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;YACpB,MAAM,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC;YAC7B,KAAK,IAAI,GAAG,CAAC;YACb,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;gBAAE,OAAO,MAAM,CAAC;SAChC;IACH,CAAC,CAAC;IACF,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE;QACtB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,GAAG,GAAG,CAAC,CAAC;QACzB,IAAI,QAAQ,KAAK,CAAC;YAAE,MAAM,EAAE,CAAC;aACxB,IAAI,QAAQ,KAAK,CAAC;YAAE,CAAC,IAAI,CAAC,CAAC;aAC3B,IAAI,QAAQ,KAAK,CAAC,EAAE;YACvB,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;YACxB,CAAC,IAAI,MAAM,CAAC;SACb;aACI,IAAI,QAAQ,KAAK,CAAC;YAAE,CAAC,IAAI,CAAC,CAAC;;YAC3B,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,EAAE,CAAC,CAAC;KAC1D;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,IAAI,IAAsB,CAAC;AAE3B,UAAU,CAAC,GAAG,EAAE;IACd,WAAW,CAAC,qBAAqB,EAAE,CAAC;IACpC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AACzE,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACb,IAAI,CAAC,WAAW,EAAE,CAAC;IACnB,WAAW,CAAC,qBAAqB,EAAE,CAAC;AACtC,CAAC,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC;AAErH,0DAA0D;AAE1D,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAU,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;IACnF,IAAI,CAAC,0CAA0C,EAAE,GAAG,EAAE;QACpD,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,gCAAe,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;QAClF,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACnE,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC/D,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC;QAC9D,MAAM,QAAQ,GAA2B;YACvC,WAAW,EAAE,gCAAe,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;YAClD,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;YAClC,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;YAClC,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;SACnC,CAAC;QACF,MAAM,OAAO,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE;YAC5D,MAAM,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAChF;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC/D,MAAM,CAAC,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,MAAM,CAAC,eAAe,EAAE,EAAE,MAAM,CAAC,eAAe,EAAE,EAAE,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;aAC3G,OAAO,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;QAC3G,MAAM,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,yDAAyD;AAEzD,IAAI,CAAC,kDAAkD,EAAE,GAAG,EAAE;IAC5D,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,wBAAwB,CAAE,CAAC;IACtE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE;QAC1B,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;KAChC;IACD,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACrC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,4BAA4B,EAAE,GAAG,EAAE;IACtC,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,qBAAU,EAAE,EAAE,gCAAe,CAAC,iBAAiB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACzG,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9B,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACrC,CAAC,CAAC,CAAC;AAEH,8CAA8C;AAE9C,gFAAgF;AAChF,SAAS,gBAAgB,CAAmB,GAAqB,EAAE,QAAuB;IACxF,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,CAAC,OAAoB,EAAE,QAA8C,EAAE,EAAE;QACrF,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC7B,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,OAAoB,EAAE,EAAE;QACtC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,MAAM,QAAQ,GAA+B,EAAE,CAAC;QAChD,YAAY,CAAC,GAAG,EAAE,WAAC,OAAA,MAAA,QAAQ,CAAC,GAAG,wDAAI,CAAA,EAAA,CAAC,CAAC;QACrC,OAAO,EAAE,EAAE,CAAC,KAAa,EAAE,OAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAChG,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAM,CAAC;IACjD,OAA0C,CAAC,MAAM,GAAG;QACnD,sBAAsB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM;KAC9C,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,IAAI,GAAG,wBAAa,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;AAC3C,MAAM,MAAM,GAAG,GAAmB,EAAE,CAAC,IAAI,+BAAc,EAAE,CAAC;AAE1D,SAAS,QAAQ;IACf,OAAO,kBAAQ,CAAC,MAAM,CAAC,IAAI,2BAAa,EAAE,CAAC,OAAO,CAAC,WAAI,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC3G,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,IAAI,mBAAS,CAAC,IAAI,6BAAc,EAAE,CAAC,OAAO,CAAC,WAAI,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AACtH,CAAC;AAED,SAAe,oBAAoB;;QACjC,MAAM,QAAQ,GAAkB,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,CAAC,QAAuB,EAAE,EAAE,CAAC,CAAC;YAC3C,QAAQ,EAAE,CAAC,OAAoB,EAAE,QAA8C,EAAE,EAAE;gBACjF,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACvB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC7B,CAAC;SACF,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,uBAAY,CAAC;YAChC,cAAc,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,uDAA0B,EAAE,CAAU;YACvE,eAAe,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,yDAA2B,EAAE,CAAU;YACzE,iBAAiB,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,6DAA6B,EAAE,CAAU;SAC9E,CAAC,CAAC;QACH,2DAA2D;QAC3D,MAAM,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,WAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACpE,MAAM,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,WAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrE,MAAM,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,WAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACvE,OAAO,QAAQ,CAAC;IAClB,CAAC;CAAA;AAID,SAAe,WAAW,CAAmB,GAAqB,EAAE,IAAsC;;QACxG,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,yBAAY,EAAE,CAAC,CAAC;QAC9E,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvC,CAAC;CAAA;AAED,MAAM,eAAe,GAAa;IAChC,CAAC,kBAAkB,EAAE,GAAS,EAAE,kDAAC,OAAA,eAAK,CAAC,UAAU,CAAC,WAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAA,GAAA;QAC9F,gCAAe,CAAC,iBAAiB,EAAE,OAAO,EAAE,OAAO,CAAC;IACtD,CAAC,cAAc,EAAE,GAAS,EAAE,kDAAC,OAAA,eAAK,CAAC,MAAM,CAAC,IAAI,oBAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,wBAAa,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAA,GAAA;QAC9F,gCAAe,CAAC,iBAAiB,EAAE,OAAO,EAAE,OAAO,CAAC;IACtD,CAAC,wBAAwB,EAAE,GAAS,EAAE,kDAAC,OAAA,MAAM,EAAE,CAAC,OAAO,EAAE,CAAA,GAAA;QACvD,gCAAe,CAAC,2BAA2B,EAAE,gBAAgB,EAAE,OAAO,CAAC;IACzE,CAAC,8BAA8B,EAAE,GAAS,EAAE;YAAC,OAAA,IAAI,2CAAoB,CACnE,MAAM,EAAE,EAAE,+BAAiB,CAAC,WAAW,EAAE,+BAAiB,CAAC,YAAY,EAAE,EAAE,EAAE,EAAE,EAAE,wBAAa,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAA;UAAA;QACjH,gCAAe,CAAC,kCAAkC,EAAE,EAAE,EAAE,OAAO,CAAC;IAChE,CAAC,aAAa,EAAE,GAAS,EAAE,kDAAC,OAAA,WAAW,EAAE,CAAC,KAAK,CAAA,GAAA;QAC7C,gCAAe,CAAC,uBAAuB,EAAE,aAAa,EAAE,OAAO,CAAC;IAClE,CAAC,iCAAiC,EAAE,GAAS,EAAE,kDAAC,OAAA,WAAW,EAAE,CAAC,KAAK,CAAC,qBAAqB,EAAG,CAAA,GAAA;QAC1F,gCAAe,CAAC,+BAA+B,EAAE,oBAAoB,EAAE,OAAO,CAAC;IACjF,CAAC,qCAAqC,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,2BAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,sBAAsB,CAAC,IAAI,qBAAU,EAAE,CAAC,CAAC;QACxH,gCAAe,CAAC,gCAAgC,EAAE,cAAc,EAAE,OAAO,CAAC;IAC5E,CAAC,qBAAqB,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,2BAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACtF,gCAAe,CAAC,+BAA+B,EAAE,cAAc,EAAE,OAAO,CAAC;IAC3E,CAAC,wCAAwC,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,iCAAe,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,sBAAsB,CAAC,IAAI,2BAAa,EAAE,CAAC,CAAC;QACjI,gCAAe,CAAC,mCAAmC,EAAE,iBAAiB,EAAE,OAAO,CAAC;IAClF,CAAC,gCAAgC,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,iCAAe,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5G,gCAAe,CAAC,kCAAkC,EAAE,iBAAiB,EAAE,OAAO,CAAC;IACjF,CAAC,8CAA8C,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,uCAAkB,EACnF,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,yBAAyB,CAAC,EAAE,KAAK,EAAE,IAAI,iCAAgB,EAAE,EAAiB,CAAC,CAAC;QACvF,gCAAe,CAAC,sCAAsC,EAAE,oBAAoB,EAAE,OAAO,CAAC;IACtF,CAAC,sCAAsC,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,uCAAkB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACxH,gCAAe,CAAC,qCAAqC,EAAE,iBAAiB,EAAE,OAAO,CAAC;IACpF,CAAC,0CAA0C,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,mCAAgB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,uBAAuB,CAAC,IAAI,6BAAc,EAAE,CAAC,CAAC;QACtI,gCAAe,CAAC,oCAAoC,EAAE,kBAAkB,EAAE,OAAO,CAAC;IACpF,CAAC,kCAAkC,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,mCAAgB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAChH,gCAAe,CAAC,mCAAmC,EAAE,kBAAkB,EAAE,OAAO,CAAC;IACnF,CAAC,yBAAyB,EAAE,GAAS,EAAE,kDAAC,OAAA,CAAC,MAAM,oBAAoB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA,GAAA;QACvE,gCAAe,CAAC,kCAAkC,EAAE,iBAAiB,EAAE,OAAO,CAAC;IACjF,CAAC,yBAAyB,EAAE,GAAS,EAAE,kDAAC,OAAA,CAAC,MAAM,oBAAoB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA,GAAA;QACvE,gCAAe,CAAC,mCAAmC,EAAE,kBAAkB,EAAE,OAAO,CAAC;IACnF,CAAC,2BAA2B,EAAE,GAAS,EAAE,kDAAC,OAAA,CAAC,MAAM,oBAAoB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA,GAAA;QACzE,gCAAe,CAAC,qCAAqC,EAAE,oBAAoB,EAAE,OAAO,CAAC;CACxF,CAAC;AAEF,SAAS,WAAW;IAClB,OAAO,IAAI,qBAAW,CAAC;QACrB,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,cAAc,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,QAAQ,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1C,KAAK,EAAE,IAAI,oBAAO,CAAC,QAAQ,CAAC;QAC5B,QAAQ,EAAE,QAAQ,EAAE;QACpB,eAAe,EAAE,IAAI,kCAAe,CAAC,0CAAoB,CAAC,GAAG,CAAC;QAC9D,SAAS,EAAE,SAAS,EAAE;QACtB,QAAQ,EAAE,IAAI,oBAAO,CAAC,IAAI,CAAC;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,+CAA+C,EAAE,CAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE;IAC7H,MAAM,OAAO,GAAG,MAAM,KAAK,EAAE,CAAC;IAE9B,MAAM,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IACzF,8EAA8E;IAC9E,+DAA+D;IAC/D,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,WAAW,EAAE;QACf,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,gCAAe,CAAC,mBAAmB,CAAC,CAAC;KAC3F;IACD,MAAM,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,OAAO,CAAC,eAAe,EAAE,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;SACtF,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9C,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACpF,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACrC,CAAC,CAAA,CAAC,CAAC;AAEH,IAAI,CAAC,mCAAmC,EAAE,GAAG,EAAE;IAC7C,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,qBAAU,EAAE,EAAE,gCAAe,CAAC,iBAAiB,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AACjH,CAAC,CAAC,CAAC"}

package/node/wrappers/util/object-types.test.ts

@@ -0,0 +1,307 @@
+// Compact object type and version (LM-297): writers set both forms, readers
+// translate the strings-only form. Rows come from the shared fixture
+// test-fixtures/object-type-legacy.json, which Java, Python and Rust also load.
+import * as fs from 'fs';
+import * as path from 'path';
+import { Decimal } from 'decimal.js';
+
+import { ObjectTypeProto } from '../../fintekkers/models/util/object_type_pb';
+import { SecurityProto } from '../../fintekkers/models/security/security_pb';
+import { PriceProto } from '../../fintekkers/models/price/price_pb';
+import { TransactionProto } from '../../fintekkers/models/transaction/transaction_pb';
+import { PortfolioProto } from '../../fintekkers/models/portfolio/portfolio_pb';
+import { TransactionTypeProto } from '../../fintekkers/models/transaction/transaction_type_pb';
+import { PositionTypeProto, PositionViewProto } from '../../fintekkers/models/position/position_pb';
+import { QuerySecurityResponseProto } from '../../fintekkers/requests/security/query_security_response_pb';
+import { QueryPortfolioResponseProto } from '../../fintekkers/requests/portfolio/query_portfolio_response_pb';
+import { QueryTransactionResponseProto } from '../../fintekkers/requests/transaction/query_transaction_response_pb';
+import { SummaryProto } from '../../fintekkers/requests/util/errors/summary_pb';
+
+import * as objectTypes from './object-types';
+import { ObjectTyped } from './object-types';
+import LinkResolver from './link-resolver';
+import Price from '../models/price/Price';
+import Security from '../models/security/security';
+import Portfolio from '../models/portfolio/portfolio';
+import Transaction from '../models/transaction/transaction';
+import { TransactionType } from '../models/transaction/transaction_type';
+import { PositionFilter } from '../models/position/positionfilter';
+import { QueryPositionRequest } from '../requests/position/QueryPositionRequest';
+import { UUID } from '../models/utils/uuid';
+import { ZonedDateTime } from '../models/utils/datetime';
+import { PriceService } from '../services/price-service/PriceService';
+import { SecurityService } from '../services/security-service/SecurityService';
+import { TransactionService } from '../services/transaction-service/TransactionService';
+import { PortfolioService } from '../services/portfolio-service/PortfolioService';
+
+interface FixtureCase {
+  name: string;
+  source: string;
+  message: string;
+  object_class: string;
+  version: string;
+  bytes: string;
+  expect: { object_type: keyof typeof ObjectTypeProto; version: number[]; warns: boolean };
+}
+
+const REPO_ROOT = path.resolve(__dirname, '../../../..');
+const CASES: FixtureCase[] = JSON.parse(
+  fs.readFileSync(path.join(REPO_ROOT, 'test-fixtures', 'object-type-legacy.json'), 'utf8')).cases;
+const COMPACT_NUMBERS: Record<string, number> = {
+  object_type: 1001, version_major: 1002, version_minor: 1003, version_patch: 1004,
+};
+
+type MessageClass = { deserializeBinary(bytes: Uint8Array): ObjectTyped & { serializeBinary(): Uint8Array } };
+
+/** Generated message classes by proto full name: the package is the directory under node/. */
+function messageClasses(): Map<string, MessageClass> {
+  const root = path.resolve(__dirname, '../../fintekkers');
+  const classes = new Map<string, MessageClass>();
+  const walk = (dir: string): void => {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      const full = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        walk(full);
+      } else if (entry.name.endsWith('_pb.js')) {
+        const pkg = path.relative(path.dirname(root), dir).split(path.sep).join('.');
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        for (const [name, cls] of Object.entries(require(full))) {
+          classes.set(`${pkg}.${name}`, cls as MessageClass);
+        }
+      }
+    }
+  };
+  walk(root);
+  return classes;
+}
+
+const CLASSES = messageClasses();
+
+function decode(c: FixtureCase) {
+  const cls = CLASSES.get(c.message);
+  if (!cls) throw new Error(`no generated class for ${c.message}`);
+  return cls.deserializeBinary(Buffer.from(c.bytes, 'base64'));
+}
+
+/** Field numbers present at the top level of an encoded message. */
+function topLevelFieldNumbers(data: Uint8Array): number[] {
+  const numbers: number[] = [];
+  let i = 0;
+  const varint = (): number => {
+    let result = 0;
+    let scale = 1;
+    for (;;) {
+      const b = data[i++];
+      result += (b & 0x7f) * scale;
+      scale *= 128;
+      if (!(b & 0x80)) return result;
+    }
+  };
+  while (i < data.length) {
+    const key = varint();
+    numbers.push(Math.floor(key / 8));
+    const wireType = key % 8;
+    if (wireType === 0) varint();
+    else if (wireType === 1) i += 8;
+    else if (wireType === 2) {
+      const length = varint();
+      i += length;
+    }
+    else if (wireType === 5) i += 4;
+    else throw new Error(`unexpected wire type ${wireType}`);
+  }
+  return numbers;
+}
+
+let warn: jest.SpyInstance;
+
+beforeEach(() => {
+  objectTypes.resetWarningsForTests();
+  warn = jest.spyOn(console, 'warn').mockImplementation(() => undefined);
+});
+
+afterEach(() => {
+  warn.mockRestore();
+  objectTypes.resetWarningsForTests();
+});
+
+const fallbackWarnings = (): number => warn.mock.calls.filter((args) => String(args[0]).includes('(LM-297)')).length;
+
+// ---- Loading the old form translates it (metric 3) ----
+
+describe.each(CASES.map((c) => [c.name, c] as const))('fixture row %s', (_name, c) => {
+  test('decodes to the expected type and version', () => {
+    const message = decode(c);
+    expect(objectTypes.readType(message)).toBe(ObjectTypeProto[c.expect.object_type]);
+    expect(objectTypes.readVersion(message)).toEqual(c.expect.version);
+    expect(fallbackWarnings()).toBe(c.expect.warns ? 1 : 0);
+  });
+
+  test('re-serialises with the compact fields once upgraded', () => {
+    const data = objectTypes.upgrade(decode(c)).serializeBinary();
+    const expected: Record<string, number> = {
+      object_type: ObjectTypeProto[c.expect.object_type],
+      version_major: c.expect.version[0],
+      version_minor: c.expect.version[1],
+      version_patch: c.expect.version[2],
+    };
+    const present = topLevelFieldNumbers(data);
+    for (const [name, number] of Object.entries(COMPACT_NUMBERS)) {
+      expect([name, present.includes(number)]).toEqual([name, expected[name] !== 0]);
+    }
+    const reread = CLASSES.get(c.message)!.deserializeBinary(data);
+    expect([reread.getObjectType(), reread.getVersionMajor(), reread.getVersionMinor(), reread.getVersionPatch()])
+      .toEqual([expected.object_type, expected.version_major, expected.version_minor, expected.version_patch]);
+    expect([reread.getObjectClass(), reread.getVersion()]).toEqual([c.object_class, c.version]);
+  });
+});
+
+// ---- Reading the strings is deprecated (metric 4) ----
+
+test('three strings-only decodes of one type warn once', () => {
+  const c = CASES.find((row) => row.name === 'js-PositionFilterProto')!;
+  for (let i = 0; i < 3; i++) {
+    objectTypes.upgrade(decode(c));
+  }
+  expect(fallbackWarnings()).toBe(1);
+});
+
+test('the new form does not warn', () => {
+  const message = objectTypes.stamp(new PriceProto(), ObjectTypeProto.OBJECT_TYPE_PRICE, 'Price', '0.0.1');
+  objectTypes.readType(message);
+  objectTypes.readVersion(message);
+  expect(fallbackWarnings()).toBe(0);
+});
+
+// ---- Writers set both forms (metric 2) ----
+
+/** A service with its gRPC client swapped for one that records each request. */
+function capturingService<S extends object>(cls: { prototype: S }, response: () => unknown): { service: S; requests: ObjectTyped[] } {
+  const requests: ObjectTyped[] = [];
+  const unary = (request: ObjectTyped, callback: (err: unknown, res: unknown) => void) => {
+    requests.push(request);
+    callback(null, response());
+  };
+  const stream = (request: ObjectTyped) => {
+    requests.push(request);
+    const handlers: Record<string, () => void> = {};
+    setImmediate(() => handlers.end?.());
+    return { on(event: string, handler: () => void) { handlers[event] = handler; return this; } };
+  };
+  const service = Object.create(cls.prototype) as S;
+  (service as unknown as { client: unknown }).client = {
+    validateCreateOrUpdate: unary, search: stream,
+  };
+  return { service, requests };
+}
+
+const asOf = ZonedDateTime.now().toProto();
+const filter = (): PositionFilter => new PositionFilter();
+
+function security(): Security {
+  return Security.create(new SecurityProto().setUuid(UUID.random().toUUIDProto()).setAssetClass('Equity'));
+}
+
+function portfolio(): Portfolio {
+  return new Portfolio(new PortfolioProto().setUuid(UUID.random().toUUIDProto()).setPortfolioName('P').setAsOf(asOf));
+}
+
+async function linkResolverRequests(): Promise<ObjectTyped[]> {
+  const requests: ObjectTyped[] = [];
+  const client = (response: () => unknown) => ({
+    getByIds: (request: ObjectTyped, callback: (err: unknown, res: unknown) => void) => {
+      requests.push(request);
+      callback(null, response());
+    },
+  });
+  const resolver = new LinkResolver({
+    securityClient: client(() => new QuerySecurityResponseProto()) as never,
+    portfolioClient: client(() => new QueryPortfolioResponseProto()) as never,
+    transactionClient: client(() => new QueryTransactionResponseProto()) as never,
+  });
+  // Nothing comes back, so each lookup rejects as not found.
+  await expect(resolver.getSecurity(UUID.random())).rejects.toThrow();
+  await expect(resolver.getPortfolio(UUID.random())).rejects.toThrow();
+  await expect(resolver.getTransaction(UUID.random())).rejects.toThrow();
+  return requests;
+}
+
+type Writer = [string, () => Promise<ObjectTyped>, ObjectTypeProto, string, string];
+
+async function lastRequest<S extends object>(cls: { prototype: S }, call: (service: S) => Promise<unknown>): Promise<ObjectTyped> {
+  const { service, requests } = capturingService(cls, () => new SummaryProto());
+  await call(service);
+  return requests[requests.length - 1];
+}
+
+const LIBRARY_WRITERS: Writer[] = [
+  ['Price.fromSimple', async () => Price.fromSimple(UUID.random().toString(), 1, new Date()).proto,
+    ObjectTypeProto.OBJECT_TYPE_PRICE, 'Price', '0.0.1'],
+  ['Price.create', async () => Price.create(new Decimal(1), security(), ZonedDateTime.now()).proto,
+    ObjectTypeProto.OBJECT_TYPE_PRICE, 'Price', '0.0.1'],
+  ['PositionFilter.toProto', async () => filter().toProto(),
+    ObjectTypeProto.OBJECT_TYPE_POSITION_FILTER, 'PositionFilter', '0.0.1'],
+  ['QueryPositionRequest.toProto', async () => new QueryPositionRequest(
+    filter(), PositionTypeProto.TRANSACTION, PositionViewProto.DEFAULT_VIEW, [], [], ZonedDateTime.now()).toProto(),
+  ObjectTypeProto.OBJECT_TYPE_QUERY_POSITION_REQUEST, '', '1.0.0'],
+  ['Transaction', async () => transaction().proto,
+    ObjectTypeProto.OBJECT_TYPE_TRANSACTION, 'Transaction', '0.0.1'],
+  ['Transaction strategy allocation', async () => transaction().proto.getStrategyAllocation()!,
+    ObjectTypeProto.OBJECT_TYPE_STRATEGY_ALLOCATION, 'StrategyAllocation', '0.0.1'],
+  ['PriceService.validateCreateOrUpdate', () => lastRequest(PriceService, (s) => s.validateCreateOrUpdate(new PriceProto())),
+    ObjectTypeProto.OBJECT_TYPE_CREATE_PRICE_REQUEST, 'PriceRequest', '0.0.1'],
+  ['PriceService.search', () => lastRequest(PriceService, (s) => s.search(asOf, filter())),
+    ObjectTypeProto.OBJECT_TYPE_QUERY_PRICE_REQUEST, 'PriceRequest', '0.0.1'],
+  ['SecurityService.validateCreateSecurity', () => lastRequest(SecurityService, (s) => s.validateCreateSecurity(new SecurityProto())),
+    ObjectTypeProto.OBJECT_TYPE_CREATE_SECURITY_REQUEST, 'SecurityRequest', '0.0.1'],
+  ['SecurityService.searchSecurity', () => lastRequest(SecurityService, (s) => s.searchSecurity(asOf, filter())),
+    ObjectTypeProto.OBJECT_TYPE_QUERY_SECURITY_REQUEST, 'SecurityRequest', '0.0.1'],
+  ['TransactionService.validateCreateTransaction', () => lastRequest(TransactionService,
+    (s) => s.validateCreateTransaction({ proto: new TransactionProto() } as Transaction)),
+  ObjectTypeProto.OBJECT_TYPE_CREATE_TRANSACTION_REQUEST, 'TransactionRequest', '0.0.1'],
+  ['TransactionService.searchTransaction', () => lastRequest(TransactionService, (s) => s.searchTransaction(asOf, filter())),
+    ObjectTypeProto.OBJECT_TYPE_QUERY_TRANSACTION_REQUEST, 'SecurityRequest', '0.0.1'],
+  ['PortfolioService.validateCreatePortfolio', () => lastRequest(PortfolioService, (s) => s.validateCreatePortfolio(new PortfolioProto())),
+    ObjectTypeProto.OBJECT_TYPE_CREATE_PORTFOLIO_REQUEST, 'PortfolioRequest', '0.0.1'],
+  ['PortfolioService.searchPortfolio', () => lastRequest(PortfolioService, (s) => s.searchPortfolio(asOf, filter())),
+    ObjectTypeProto.OBJECT_TYPE_QUERY_PORTFOLIO_REQUEST, 'PortfolioRequest', '0.0.1'],
+  ['LinkResolver securities', async () => (await linkResolverRequests())[0],
+    ObjectTypeProto.OBJECT_TYPE_QUERY_SECURITY_REQUEST, 'SecurityRequest', '0.0.1'],
+  ['LinkResolver portfolios', async () => (await linkResolverRequests())[1],
+    ObjectTypeProto.OBJECT_TYPE_QUERY_PORTFOLIO_REQUEST, 'PortfolioRequest', '0.0.1'],
+  ['LinkResolver transactions', async () => (await linkResolverRequests())[2],
+    ObjectTypeProto.OBJECT_TYPE_QUERY_TRANSACTION_REQUEST, 'TransactionRequest', '0.0.1'],
+];
+
+function transaction(): Transaction {
+  return new Transaction({
+    tradeDate: new Date(2024, 0, 15),
+    settlementDate: new Date(2024, 0, 17),
+    asOfDate: new Date(2024, 0, 15, 10, 30, 0),
+    price: new Decimal('100.50'),
+    security: security(),
+    transactionType: new TransactionType(TransactionTypeProto.BUY),
+    portfolio: portfolio(),
+    quantity: new Decimal('10'),
+  });
+}
+
+test.each(LIBRARY_WRITERS)('%s sets strings and compact fields that agree', async (_name, build, type, objectClass, version) => {
+  const message = await build();
+
+  expect([message.getObjectClass(), message.getVersion()]).toEqual([objectClass, version]);
+  // The message's own type. Some JS writers put a query request's string on the
+  // create request too; the string still sits on one enum value.
+  expect(message.getObjectType()).toBe(type);
+  if (objectClass) {
+    expect(objectTypes.fromLegacy(objectClass)).not.toBe(ObjectTypeProto.OBJECT_TYPE_UNKNOWN);
+  }
+  expect([message.getVersionMajor(), message.getVersionMinor(), message.getVersionPatch()])
+    .toEqual(objectTypes.parseVersion(version));
+  expect(objectTypes.readVersion(message)).toEqual(objectTypes.parseVersion(version));
+  expect(fallbackWarnings()).toBe(0);
+});
+
+test('stamp rejects a malformed version', () => {
+  expect(() => objectTypes.stamp(new PriceProto(), ObjectTypeProto.OBJECT_TYPE_PRICE, 'Price', '1.2')).toThrow();
+});