@fintekkers/ledger-models 0.4.30 → 0.4.31

package/node/wrappers/util/serviceaddress.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Finds the address of a FinTekkers service from the environment, the same
+ * way as Java `ServiceAddress` and Rust `service_address.rs` (LM-278). Every
+ * default client resolves through here, in this order:
+ *
+ *  1. `BROKER_HOST` (`host[:port]`, port defaults to {@link BROKER_PORT}):
+ *     all calls go through the broker.
+ *  2. Only if that is unset, `<SERVICE>_SERVICE_HOST` with
+ *     `<SERVICE>_SERVICE_PORT` (or the service's standard port). `_PORT`
+ *     without `_HOST` is ignored.
+ *  3. `API_URL`, with the service's standard port unless it carries one.
+ *  4. `localhost` on the service's standard port.
+ *
+ * An empty value counts as unset. A leading `http://` or `https://` is
+ * ignored. Loopback hosts (`localhost`, `127.0.0.1`) are plaintext; any other
+ * host uses TLS. A port that is not a number throws an Error naming the
+ * variable.
+ *
+ * The same cases are checked in every language against
+ * `test-fixtures/service-address-cases.json`.
+ */
+export declare const BROKER_PORT = 8085;
+export declare const LEDGER_PORT = 8082;
+export declare const VALUATION_PORT = 8080;
+export declare const PRICE_PORT = 8083;
+export declare enum Service {
+    BROKER = "BROKER",
+    SECURITY = "SECURITY",
+    TRANSACTION = "TRANSACTION",
+    PORTFOLIO = "PORTFOLIO",
+    VALUATION = "VALUATION",
+    PRICE = "PRICE",
+    /** JS only: the position client talks to ledger-service. */
+    POSITION = "POSITION"
+}
+export interface Endpoint {
+    host: string;
+    port: number;
+    plaintext: boolean;
+}
+export type Env = Record<string, string | undefined>;
+export declare function envPrefix(service: Service): string;
+export declare function standardPort(service: Service): number;
+/** Resolves `service` against `env` (defaults to `process.env`). */
+export declare function resolve(service: Service, env?: Env): Endpoint;
+/** The `host:port` string a gRPC client connects to. */
+export declare function target(endpoint: Endpoint): string;

package/node/wrappers/util/serviceaddress.js

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * Finds the address of a FinTekkers service from the environment, the same
+ * way as Java `ServiceAddress` and Rust `service_address.rs` (LM-278). Every
+ * default client resolves through here, in this order:
+ *
+ *  1. `BROKER_HOST` (`host[:port]`, port defaults to {@link BROKER_PORT}):
+ *     all calls go through the broker.
+ *  2. Only if that is unset, `<SERVICE>_SERVICE_HOST` with
+ *     `<SERVICE>_SERVICE_PORT` (or the service's standard port). `_PORT`
+ *     without `_HOST` is ignored.
+ *  3. `API_URL`, with the service's standard port unless it carries one.
+ *  4. `localhost` on the service's standard port.
+ *
+ * An empty value counts as unset. A leading `http://` or `https://` is
+ * ignored. Loopback hosts (`localhost`, `127.0.0.1`) are plaintext; any other
+ * host uses TLS. A port that is not a number throws an Error naming the
+ * variable.
+ *
+ * The same cases are checked in every language against
+ * `test-fixtures/service-address-cases.json`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.target = exports.resolve = exports.standardPort = exports.envPrefix = exports.Service = exports.PRICE_PORT = exports.VALUATION_PORT = exports.LEDGER_PORT = exports.BROKER_PORT = void 0;
+exports.BROKER_PORT = 8085;
+exports.LEDGER_PORT = 8082;
+exports.VALUATION_PORT = 8080;
+exports.PRICE_PORT = 8083;
+var Service;
+(function (Service) {
+    Service["BROKER"] = "BROKER";
+    Service["SECURITY"] = "SECURITY";
+    Service["TRANSACTION"] = "TRANSACTION";
+    Service["PORTFOLIO"] = "PORTFOLIO";
+    Service["VALUATION"] = "VALUATION";
+    Service["PRICE"] = "PRICE";
+    /** JS only: the position client talks to ledger-service. */
+    Service["POSITION"] = "POSITION";
+})(Service || (exports.Service = Service = {}));
+/** Prefix of each service's `<SERVICE>_SERVICE_HOST/_PORT` variables, and its standard port. */
+const SERVICE_ENV = {
+    [Service.BROKER]: { envPrefix: 'BROKER', standardPort: exports.BROKER_PORT },
+    [Service.SECURITY]: { envPrefix: 'LEDGER', standardPort: exports.LEDGER_PORT },
+    [Service.TRANSACTION]: { envPrefix: 'LEDGER', standardPort: exports.LEDGER_PORT },
+    [Service.PORTFOLIO]: { envPrefix: 'LEDGER', standardPort: exports.LEDGER_PORT },
+    [Service.VALUATION]: { envPrefix: 'VALUATION', standardPort: exports.VALUATION_PORT },
+    [Service.PRICE]: { envPrefix: 'PRICE', standardPort: exports.PRICE_PORT },
+    [Service.POSITION]: { envPrefix: 'LEDGER', standardPort: exports.LEDGER_PORT },
+};
+function envPrefix(service) {
+    return SERVICE_ENV[service].envPrefix;
+}
+exports.envPrefix = envPrefix;
+function standardPort(service) {
+    return SERVICE_ENV[service].standardPort;
+}
+exports.standardPort = standardPort;
+/** Resolves `service` against `env` (defaults to `process.env`). */
+function resolve(service, env = process.env) {
+    const broker = read(env, 'BROKER_HOST');
+    if (broker !== undefined) {
+        return parse(broker, 'BROKER_HOST', exports.BROKER_PORT);
+    }
+    const { envPrefix, standardPort } = SERVICE_ENV[service];
+    const hostVar = envPrefix + '_SERVICE_HOST';
+    const host = read(env, hostVar);
+    if (host !== undefined) {
+        const portVar = envPrefix + '_SERVICE_PORT';
+        const port = read(env, portVar);
+        const endpoint = parse(host, hostVar, standardPort);
+        return port === undefined
+            ? endpoint
+            : makeEndpoint(endpoint.host, parsePort(port, portVar));
+    }
+    const apiUrl = read(env, 'API_URL');
+    if (apiUrl !== undefined) {
+        return parse(apiUrl, 'API_URL', standardPort);
+    }
+    return makeEndpoint('localhost', standardPort);
+}
+exports.resolve = resolve;
+/** The `host:port` string a gRPC client connects to. */
+function target(endpoint) {
+    return `${endpoint.host}:${endpoint.port}`;
+}
+exports.target = target;
+function read(env, name) {
+    if (!Object.prototype.hasOwnProperty.call(env, name))
+        return undefined;
+    const value = env[name];
+    if (value === undefined || value === null)
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed === '' ? undefined : trimmed;
+}
+function parse(value, variable, defaultPort) {
+    let address = value;
+    const scheme = address.indexOf('://');
+    if (scheme >= 0)
+        address = address.substring(scheme + 3);
+    while (address.endsWith('/'))
+        address = address.substring(0, address.length - 1);
+    let host = address;
+    let port = defaultPort;
+    const colon = address.lastIndexOf(':');
+    if (colon >= 0) {
+        host = address.substring(0, colon);
+        port = parsePort(address.substring(colon + 1), variable);
+    }
+    if (host === '') {
+        throw new Error(`${variable} has no host: '${value}'`);
+    }
+    return makeEndpoint(host, port);
+}
+function parsePort(value, variable) {
+    const trimmed = value.trim();
+    // Java's Integer.parseInt accepts an optional sign; the range check below rejects negatives.
+    if (!/^[+-]?\d+$/.test(trimmed))
+        throw invalidPort(value, variable);
+    const port = Number(trimmed);
+    if (port < 1 || port > 65535)
+        throw invalidPort(value, variable);
+    return port;
+}
+function invalidPort(value, variable) {
+    return new Error(`${variable} has an invalid port: '${value}'`);
+}
+function makeEndpoint(host, port) {
+    const plaintext = host === 'localhost' || host === '127.0.0.1';
+    return { host, port, plaintext };
+}
+//# sourceMappingURL=serviceaddress.js.map

package/node/wrappers/util/serviceaddress.js.map

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

package/node/wrappers/util/serviceaddress.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * LM-287: the JS service-address lookup resolves every case in the shared
+ * fixture exactly as Java `ServiceAddress` and Rust `service_address.rs` do.
+ * No cases are written here; they all come from the fixture.
+ */
+export {};

package/node/wrappers/util/serviceaddress.test.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * LM-287: the JS service-address lookup resolves every case in the shared
+ * fixture exactly as Java `ServiceAddress` and Rust `service_address.rs` do.
+ * No cases are written here; they all come from the fixture.
+ */
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const serviceaddress_1 = require("./serviceaddress");
+const fixturePath = path.resolve(__dirname, '../../../../test-fixtures/service-address-cases.json');
+const fixture = JSON.parse(fs.readFileSync(fixturePath, 'utf8'));
+const rows = fixture.cases.flatMap((c) => c.services.map((s) => [c.name, s, c]));
+function serviceNamed(name) {
+    if (!Object.prototype.hasOwnProperty.call(serviceaddress_1.Service, name)) {
+        throw new Error(`fixture names an unknown service: ${name}`);
+    }
+    return serviceaddress_1.Service[name];
+}
+describe('service-address-cases.json', () => {
+    test('has cases covering every step, so an emptied fixture cannot pass', () => {
+        // 30 cases expanding to 55 (case, service) checks.
+        expect(fixture.cases.length).toBeGreaterThanOrEqual(30);
+        expect(rows.length).toBeGreaterThanOrEqual(55);
+        expect(new Set(fixture.cases.map((c) => c.step))).toEqual(new Set(['a', 'b', 'c', 'd']));
+        for (const c of fixture.cases) {
+            expect(c.services.length).toBeGreaterThan(0);
+            expect((c.expected === undefined) !== (c.error === undefined)).toBe(true);
+        }
+    });
+    test('standard_ports match the resolver', () => {
+        expect(fixture.standard_ports).toEqual({
+            BROKER: serviceaddress_1.BROKER_PORT,
+            LEDGER: serviceaddress_1.LEDGER_PORT,
+            VALUATION: serviceaddress_1.VALUATION_PORT,
+            PRICE: serviceaddress_1.PRICE_PORT,
+        });
+        for (const s of Object.values(serviceaddress_1.Service)) {
+            expect((0, serviceaddress_1.standardPort)(s)).toBe(fixture.standard_ports[(0, serviceaddress_1.envPrefix)(s)]);
+        }
+    });
+    test.each(rows)('%s [%s]', (_name, serviceName, c) => {
+        const service = serviceNamed(serviceName);
+        if (c.error !== undefined) {
+            expect(() => (0, serviceaddress_1.resolve)(service, c.env)).toThrow(c.error);
+            return;
+        }
+        const endpoint = (0, serviceaddress_1.resolve)(service, c.env);
+        expect(endpoint).toEqual(c.expected);
+        expect((0, serviceaddress_1.target)(endpoint)).toBe(`${c.expected.host}:${c.expected.port}`);
+    });
+});
+//# sourceMappingURL=serviceaddress.test.js.map

package/node/wrappers/util/serviceaddress.test.js.map

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

package/node/wrappers/util/serviceaddress.test.ts

@@ -0,0 +1,83 @@
+/**
+ * LM-287: the JS service-address lookup resolves every case in the shared
+ * fixture exactly as Java `ServiceAddress` and Rust `service_address.rs` do.
+ * No cases are written here; they all come from the fixture.
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import {
+  Service,
+  resolve,
+  target,
+  envPrefix,
+  standardPort,
+  BROKER_PORT,
+  LEDGER_PORT,
+  VALUATION_PORT,
+  PRICE_PORT,
+} from './serviceaddress';
+
+interface FixtureCase {
+  name: string;
+  step: string;
+  env: Record<string, string>;
+  services: string[];
+  expected?: { host: string; port: number; plaintext: boolean };
+  error?: string;
+}
+
+interface Fixture {
+  standard_ports: Record<string, number>;
+  cases: FixtureCase[];
+}
+
+const fixturePath = path.resolve(__dirname, '../../../../test-fixtures/service-address-cases.json');
+const fixture: Fixture = JSON.parse(fs.readFileSync(fixturePath, 'utf8'));
+
+const rows: Array<[string, string, FixtureCase]> = fixture.cases.flatMap(
+  (c) => c.services.map((s): [string, string, FixtureCase] => [c.name, s, c])
+);
+
+function serviceNamed(name: string): Service {
+  if (!Object.prototype.hasOwnProperty.call(Service, name)) {
+    throw new Error(`fixture names an unknown service: ${name}`);
+  }
+  return Service[name as keyof typeof Service];
+}
+
+describe('service-address-cases.json', () => {
+  test('has cases covering every step, so an emptied fixture cannot pass', () => {
+    // 30 cases expanding to 55 (case, service) checks.
+    expect(fixture.cases.length).toBeGreaterThanOrEqual(30);
+    expect(rows.length).toBeGreaterThanOrEqual(55);
+    expect(new Set(fixture.cases.map((c) => c.step))).toEqual(new Set(['a', 'b', 'c', 'd']));
+    for (const c of fixture.cases) {
+      expect(c.services.length).toBeGreaterThan(0);
+      expect((c.expected === undefined) !== (c.error === undefined)).toBe(true);
+    }
+  });
+
+  test('standard_ports match the resolver', () => {
+    expect(fixture.standard_ports).toEqual({
+      BROKER: BROKER_PORT,
+      LEDGER: LEDGER_PORT,
+      VALUATION: VALUATION_PORT,
+      PRICE: PRICE_PORT,
+    });
+    for (const s of Object.values(Service)) {
+      expect(standardPort(s)).toBe(fixture.standard_ports[envPrefix(s)]);
+    }
+  });
+
+  test.each(rows)('%s [%s]', (_name, serviceName, c) => {
+    const service = serviceNamed(serviceName);
+    if (c.error !== undefined) {
+      expect(() => resolve(service, c.env)).toThrow(c.error);
+      return;
+    }
+    const endpoint = resolve(service, c.env);
+    expect(endpoint).toEqual(c.expected);
+    expect(target(endpoint)).toBe(`${c.expected!.host}:${c.expected!.port}`);
+  });
+});

package/node/wrappers/util/serviceaddress.ts

@@ -0,0 +1,141 @@
+/**
+ * Finds the address of a FinTekkers service from the environment, the same
+ * way as Java `ServiceAddress` and Rust `service_address.rs` (LM-278). Every
+ * default client resolves through here, in this order:
+ *
+ *  1. `BROKER_HOST` (`host[:port]`, port defaults to {@link BROKER_PORT}):
+ *     all calls go through the broker.
+ *  2. Only if that is unset, `<SERVICE>_SERVICE_HOST` with
+ *     `<SERVICE>_SERVICE_PORT` (or the service's standard port). `_PORT`
+ *     without `_HOST` is ignored.
+ *  3. `API_URL`, with the service's standard port unless it carries one.
+ *  4. `localhost` on the service's standard port.
+ *
+ * An empty value counts as unset. A leading `http://` or `https://` is
+ * ignored. Loopback hosts (`localhost`, `127.0.0.1`) are plaintext; any other
+ * host uses TLS. A port that is not a number throws an Error naming the
+ * variable.
+ *
+ * The same cases are checked in every language against
+ * `test-fixtures/service-address-cases.json`.
+ */
+
+export const BROKER_PORT = 8085;
+export const LEDGER_PORT = 8082;
+export const VALUATION_PORT = 8080;
+export const PRICE_PORT = 8083;
+
+export enum Service {
+  BROKER = 'BROKER',
+  SECURITY = 'SECURITY',
+  TRANSACTION = 'TRANSACTION',
+  PORTFOLIO = 'PORTFOLIO',
+  VALUATION = 'VALUATION',
+  PRICE = 'PRICE',
+  /** JS only: the position client talks to ledger-service. */
+  POSITION = 'POSITION',
+}
+
+/** Prefix of each service's `<SERVICE>_SERVICE_HOST/_PORT` variables, and its standard port. */
+const SERVICE_ENV: Record<Service, { envPrefix: string; standardPort: number }> = {
+  [Service.BROKER]: { envPrefix: 'BROKER', standardPort: BROKER_PORT },
+  [Service.SECURITY]: { envPrefix: 'LEDGER', standardPort: LEDGER_PORT },
+  [Service.TRANSACTION]: { envPrefix: 'LEDGER', standardPort: LEDGER_PORT },
+  [Service.PORTFOLIO]: { envPrefix: 'LEDGER', standardPort: LEDGER_PORT },
+  [Service.VALUATION]: { envPrefix: 'VALUATION', standardPort: VALUATION_PORT },
+  [Service.PRICE]: { envPrefix: 'PRICE', standardPort: PRICE_PORT },
+  [Service.POSITION]: { envPrefix: 'LEDGER', standardPort: LEDGER_PORT },
+};
+
+export interface Endpoint {
+  host: string;
+  port: number;
+  plaintext: boolean;
+}
+
+export type Env = Record<string, string | undefined>;
+
+export function envPrefix(service: Service): string {
+  return SERVICE_ENV[service].envPrefix;
+}
+
+export function standardPort(service: Service): number {
+  return SERVICE_ENV[service].standardPort;
+}
+
+/** Resolves `service` against `env` (defaults to `process.env`). */
+export function resolve(service: Service, env: Env = process.env): Endpoint {
+  const broker = read(env, 'BROKER_HOST');
+  if (broker !== undefined) {
+    return parse(broker, 'BROKER_HOST', BROKER_PORT);
+  }
+
+  const { envPrefix, standardPort } = SERVICE_ENV[service];
+  const hostVar = envPrefix + '_SERVICE_HOST';
+  const host = read(env, hostVar);
+  if (host !== undefined) {
+    const portVar = envPrefix + '_SERVICE_PORT';
+    const port = read(env, portVar);
+    const endpoint = parse(host, hostVar, standardPort);
+    return port === undefined
+      ? endpoint
+      : makeEndpoint(endpoint.host, parsePort(port, portVar));
+  }
+
+  const apiUrl = read(env, 'API_URL');
+  if (apiUrl !== undefined) {
+    return parse(apiUrl, 'API_URL', standardPort);
+  }
+
+  return makeEndpoint('localhost', standardPort);
+}
+
+/** The `host:port` string a gRPC client connects to. */
+export function target(endpoint: Endpoint): string {
+  return `${endpoint.host}:${endpoint.port}`;
+}
+
+function read(env: Env, name: string): string | undefined {
+  if (!Object.prototype.hasOwnProperty.call(env, name)) return undefined;
+  const value = env[name];
+  if (value === undefined || value === null) return undefined;
+  const trimmed = value.trim();
+  return trimmed === '' ? undefined : trimmed;
+}
+
+function parse(value: string, variable: string, defaultPort: number): Endpoint {
+  let address = value;
+  const scheme = address.indexOf('://');
+  if (scheme >= 0) address = address.substring(scheme + 3);
+  while (address.endsWith('/')) address = address.substring(0, address.length - 1);
+
+  let host = address;
+  let port = defaultPort;
+  const colon = address.lastIndexOf(':');
+  if (colon >= 0) {
+    host = address.substring(0, colon);
+    port = parsePort(address.substring(colon + 1), variable);
+  }
+  if (host === '') {
+    throw new Error(`${variable} has no host: '${value}'`);
+  }
+  return makeEndpoint(host, port);
+}
+
+function parsePort(value: string, variable: string): number {
+  const trimmed = value.trim();
+  // Java's Integer.parseInt accepts an optional sign; the range check below rejects negatives.
+  if (!/^[+-]?\d+$/.test(trimmed)) throw invalidPort(value, variable);
+  const port = Number(trimmed);
+  if (port < 1 || port > 65535) throw invalidPort(value, variable);
+  return port;
+}
+
+function invalidPort(value: string, variable: string): Error {
+  return new Error(`${variable} has an invalid port: '${value}'`);
+}
+
+function makeEndpoint(host: string, port: number): Endpoint {
+  const plaintext = host === 'localhost' || host === '127.0.0.1';
+  return { host, port, plaintext };
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fintekkers/ledger-models",
   "todo": "Replace the version with build script version number",
-  "version": "0.4.30",
+  "version": "0.4.31",
   "description": "ledger model protos ",
   "authors": [
     "David Doherty",