@fintekkers/ledger-models 0.1.118 → 0.1.128

package/node/wrappers/models/transaction/transaction_constructor.test.ts

@@ -0,0 +1,111 @@
+import assert = require('assert');
+import Transaction from './transaction';
+import { TransactionType } from './transaction_type';
+import { TransactionTypeProto } from '../../../fintekkers/models/transaction/transaction_type_pb';
+import { PositionStatusProto } from '../../../fintekkers/models/position/position_status_pb';
+import Security from '../security/security';
+import Portfolio from '../portfolio/portfolio';
+import { SecurityProto } from '../../../fintekkers/models/security/security_pb';
+import { LocalDateProto } from '../../../fintekkers/models/util/local_date_pb';
+import { DecimalValueProto } from '../../../fintekkers/models/util/decimal_value_pb';
+import { SecurityQuantityTypeProto } from '../../../fintekkers/models/security/security_quantity_type_pb';
+import { CouponFrequencyProto } from '../../../fintekkers/models/security/coupon_frequency_pb';
+import { CouponTypeProto } from '../../../fintekkers/models/security/coupon_type_pb';
+import { UUID } from '../utils/uuid';
+import { ZonedDateTime } from '../utils/datetime';
+import { Decimal } from 'decimal.js';
+import { dummyPortfolio } from '../portfolio/portfolio.test';
+
+test('test Transaction constructor with parameters', () => {
+    testTransactionConstructor();
+});
+
+function testTransactionConstructor(): void {
+    // Create test data
+    const tradeDate = new Date(2024, 0, 15);
+    const settlementDate = new Date(2024, 0, 17);
+    const asOfDate = new Date(2024, 0, 15, 10, 30, 0);
+    const price = new Decimal('100.50');
+    const quantity = new Decimal('1000.00');
+    const security = dummySecurity();
+    const portfolio = dummyPortfolio();
+    const transactionType = dummyTransactionType();
+
+    // Create Transaction using parameter-based constructor
+    const transaction = new Transaction({
+        tradeDate,
+        settlementDate,
+        asOfDate,
+        price,
+        security,
+        transactionType,
+        portfolio,
+        quantity
+    });
+
+    // Verify all getters return expected values
+
+    // getTradeDate() - should match input tradeDate
+    const tradeDateFromTransaction = transaction.getTradeDate().toDate();
+    assert(tradeDateFromTransaction.getFullYear() === tradeDate.getFullYear());
+    assert(tradeDateFromTransaction.getMonth() === tradeDate.getMonth());
+    assert(tradeDateFromTransaction.getDate() === tradeDate.getDate());
+
+    // getSettlementDate() - should match input settlementDate
+    const settlementDateFromTransaction = transaction.getSettlementDate().toDate();
+    assert(settlementDateFromTransaction.getFullYear() === settlementDate.getFullYear());
+    assert(settlementDateFromTransaction.getMonth() === settlementDate.getMonth());
+    assert(settlementDateFromTransaction.getDate() === settlementDate.getDate());
+
+    // getAsOf() - should match input asOfDate (converted to ZonedDateTime)
+    const asOfFromTransaction = transaction.getAsOf();
+    const asOfDateTime = asOfFromTransaction.toDateTime().toJSDate();
+    // Allow 1 second tolerance for timezone conversion
+    const timeDiff = Math.abs(asOfDateTime.getTime() - asOfDate.getTime());
+    assert(timeDiff < 1000, `AsOf time difference ${timeDiff}ms exceeds 1 second tolerance`);
+
+    // getPrice() - should return PriceProto with correct price value
+    const priceProto = transaction.getPrice();
+    const priceValue = priceProto.getPrice()?.getArbitraryPrecisionValue();
+    assert(priceValue === '100.5', `Expected price '100.5', got '${priceValue}'`);
+
+    // getSecurity() - should return Security matching input security
+    assert(transaction.getSecurity().getID().toString() === security.getID().toString(), 'Security IDs should match');
+
+    // getTransactionType() - should return TransactionType matching input transactionType
+    assert(transaction.getTransactionType().toString() === 'BUY', `Expected 'BUY', got '${transaction.getTransactionType().toString()}'`);
+    assert(transaction.getTransactionType().proto === TransactionTypeProto.BUY, 'TransactionType proto should be BUY');
+
+    // getPortfolio() - should return Portfolio matching input portfolio
+    assert(transaction.getPortfolio().getPortfolioName() === 'Test Portfolio', `Expected 'Test Portfolio', got '${transaction.getPortfolio().getPortfolioName()}'`);
+    assert(transaction.getPortfolio().getID().toString() === portfolio.getID().toString(), 'Portfolio IDs should match');
+
+    // getQuantity() - should return Decimal matching input quantity
+    assert(transaction.getQuantity().toString() === '1000', `Expected quantity '1000', got '${transaction.getQuantity().toString()}'`);
+    assert(transaction.getQuantity().equals(quantity), 'Quantities should be equal');
+
+    // getPositionStatus() - should return EXECUTED (default)
+    assert(transaction.getPositionStatus() === PositionStatusProto.EXECUTED, `Expected EXECUTED, got ${transaction.getPositionStatus()}`);
+}
+
+function dummySecurity(): Security {
+    return Security.create(new SecurityProto()
+        .setObjectClass('Security')
+        .setVersion('0.0.1')
+        .setUuid(UUID.random().toUUIDProto())
+        .setFaceValue(new DecimalValueProto().setArbitraryPrecisionValue('1000.00'))
+        .setQuantityType(SecurityQuantityTypeProto.ORIGINAL_FACE_VALUE)
+        .setAssetClass("Bond")
+        .setIssuerName("Test Issuer")
+        .setCouponRate(new DecimalValueProto().setArbitraryPrecisionValue('0.05'))
+        .setCouponFrequency(CouponFrequencyProto.SEMIANNUALLY)
+        .setCouponType(CouponTypeProto.FIXED)
+        .setMaturityDate(new LocalDateProto().setYear(2026).setMonth(1).setDay(1))
+        .setIssueDate(new LocalDateProto().setYear(2021).setMonth(1).setDay(1))
+        .setDescription("Test security")
+    );
+}
+
+function dummyTransactionType(): TransactionType {
+    return new TransactionType(TransactionTypeProto.BUY);
+}

package/node/wrappers/models/transaction/transaction_type.js.map

@@ -1 +1 @@
-{"version":3,"file":"transaction_type.js","sourceRoot":"","sources":["transaction_type.ts"],"names":[],"mappings":";;;AAAA,oGAAkG;AAElG,MAAa,eAAe;IAGxB,YAAY,KAA2B;QACnC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAYD,sBAAsB;QAClB,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;YACjB,KAAK,0CAAoB,CAAC,GAAG,CAAC;YAC9B,KAAK,0CAAoB,CAAC,OAAO,CAAC;YAClC,KAAK,0CAAoB,CAAC,iBAAiB;gBACvC,OAAO,CAAC,CAAC;YACb,KAAK,0CAAoB,CAAC,IAAI,CAAC;YAC/B,KAAK,0CAAoB,CAAC,UAAU,CAAC;YACrC,KAAK,0CAAoB,CAAC,UAAU;gBAChC,OAAO,CAAC,CAAC,CAAC;YACd,KAAK,0CAAoB,CAAC,OAAO;gBAC7B,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxE,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ;;QACJ,OAAO,MAAA,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,mCAAI,SAAS,CAAC;IAClE,CAAC;CACJ;AA5CD,0CA4CC;AAnCG;IACI,eAAe,CAAC,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEtD,MAAM,CAAC,IAAI,CAAC,0CAAoB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QAC5C,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,0CAAoB,CAAC,GAAwC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;AACP,CAAC,GAAA,CAAA"}
+{"version":3,"file":"transaction_type.js","sourceRoot":"","sources":["transaction_type.ts"],"names":[],"mappings":";;;AAAA,oGAAkG;AAElG,MAAa,eAAe;IAGxB,YAAY,KAA2B;QACnC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAYD,sBAAsB;QAClB,QAAQ,IAAI,CAAC,KAAK,EAAE;YAChB,KAAK,0CAAoB,CAAC,GAAG,CAAC;YAC9B,KAAK,0CAAoB,CAAC,OAAO,CAAC;YAClC,KAAK,0CAAoB,CAAC,iBAAiB;gBACvC,OAAO,CAAC,CAAC;YACb,KAAK,0CAAoB,CAAC,IAAI,CAAC;YAC/B,KAAK,0CAAoB,CAAC,UAAU,CAAC;YACrC,KAAK,0CAAoB,CAAC,UAAU;gBAChC,OAAO,CAAC,CAAC,CAAC;YACd,KAAK,0CAAoB,CAAC,OAAO;gBAC7B,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;SACvE;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ;;QACJ,OAAO,MAAA,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,mCAAI,SAAS,CAAC;IAClE,CAAC;CACJ;AA5CD,0CA4CC;AAnCG;IACI,eAAe,CAAC,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEtD,MAAM,CAAC,IAAI,CAAC,0CAAoB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QAC5C,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,0CAAoB,CAAC,GAAwC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;AACP,CAAC,GAAA,CAAA"}

package/node/wrappers/models/utils/datetime.d.ts

@@ -9,6 +9,12 @@ declare class ZonedDateTime {
     toDateTime(): DateTime;
     toString(): string;
     toProto(): LocalTimestampProto;
+    /**
+     * Creates a ZonedDateTime from a JavaScript Date object
+     * @param date - The Date object to convert
+     * @returns A new ZonedDateTime instance with America/New_York timezone
+     */
+    static from(date: Date): ZonedDateTime;
     static now(): ZonedDateTime;
 }
 export { ZonedDateTime };

package/node/wrappers/models/utils/datetime.js

@@ -42,13 +42,18 @@ class ZonedDateTime {
     toProto() {
         return this.proto;
     }
-    static now() {
-        // Get the current time in milliseconds since January 1, 1970 (Unix timestamp)
-        const currentTimeMillis = Date.now();
+    /**
+     * Creates a ZonedDateTime from a JavaScript Date object
+     * @param date - The Date object to convert
+     * @returns A new ZonedDateTime instance with America/New_York timezone
+     */
+    static from(date) {
+        // Get the time in milliseconds since January 1, 1970 (Unix timestamp)
+        const timestampMillis = date.getTime();
         // Convert milliseconds to seconds and nanoseconds
-        const seconds = Math.floor(currentTimeMillis / 1000);
-        const nanos = (currentTimeMillis % 1000) * 1e6; // 1 millisecond = 1e6 nanoseconds
-        // Create a new Timestamp object with the current time
+        const seconds = Math.floor(timestampMillis / 1000);
+        const nanos = (timestampMillis % 1000) * 1e6; // 1 millisecond = 1e6 nanoseconds
+        // Create a new Timestamp object
         const timestamp = new timestamp_pb_1.Timestamp();
         timestamp.setSeconds(seconds);
         timestamp.setNanos(nanos);
@@ -57,6 +62,9 @@ class ZonedDateTime {
         localTimestamp.setTimestamp(timestamp);
         return new ZonedDateTime(localTimestamp);
     }
+    static now() {
+        return ZonedDateTime.from(new Date());
+    }
 }
 exports.ZonedDateTime = ZonedDateTime;
 //# sourceMappingURL=datetime.js.map

package/node/wrappers/models/utils/datetime.js.map

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

package/node/wrappers/models/utils/datetime.ts

@@ -48,15 +48,20 @@ class ZonedDateTime {
     return this.proto;
   }
 
-  static now(): ZonedDateTime {
-    // Get the current time in milliseconds since January 1, 1970 (Unix timestamp)
-    const currentTimeMillis = Date.now();
+  /**
+   * Creates a ZonedDateTime from a JavaScript Date object
+   * @param date - The Date object to convert
+   * @returns A new ZonedDateTime instance with America/New_York timezone
+   */
+  static from(date: Date): ZonedDateTime {
+    // Get the time in milliseconds since January 1, 1970 (Unix timestamp)
+    const timestampMillis = date.getTime();
 
     // Convert milliseconds to seconds and nanoseconds
-    const seconds = Math.floor(currentTimeMillis / 1000);
-    const nanos = (currentTimeMillis % 1000) * 1e6; // 1 millisecond = 1e6 nanoseconds
+    const seconds = Math.floor(timestampMillis / 1000);
+    const nanos = (timestampMillis % 1000) * 1e6; // 1 millisecond = 1e6 nanoseconds
 
-    // Create a new Timestamp object with the current time
+    // Create a new Timestamp object
     const timestamp = new Timestamp();
     timestamp.setSeconds(seconds);
     timestamp.setNanos(nanos);
@@ -67,6 +72,10 @@ class ZonedDateTime {
 
     return new ZonedDateTime(localTimestamp);
   }
+
+  static now(): ZonedDateTime {
+    return ZonedDateTime.from(new Date());
+  }
 }
 
 export { ZonedDateTime };

package/node/wrappers/models/utils/protoEnum.js.map

@@ -1 +1 @@
-{"version":3,"file":"protoEnum.js","sourceRoot":"","sources":["protoEnum.ts"],"names":[],"mappings":";;;AACA,oGAAkG;AAClG,+FAA6F;AAC7F,2EAA0E;AAE1E,MAAa,SAAS;IAIlB,YAAY,cAAmB,EAAE,SAAiB;QAC9C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,QAAgB,EAAE,SAAiB;QACnD,OAAO,IAAI,SAAS,CAAC,SAAS,CAAC,0BAA0B,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAC;IACpF,CAAC;IAEO,MAAM,CAAC,0BAA0B,CAAC,QAAgB;QACtD,IAAI,QAAQ,KAAK,kBAAkB,EAAE,CAAC;YAClC,OAAO,0CAAoB,CAAC;QAChC,CAAC;QACD,IAAI,QAAQ,KAAK,iBAAiB,EAAE,CAAC;YACjC,OAAO,wCAAmB,CAAC;QAC/B,CAAC;QACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO,qBAAU,CAAC;QACtB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,iBAAiB;QACb,OAAO,IAAI,CAAC,cAAc,CAAC;IAC/B,CAAC;IAED,WAAW;QACP,8DAA8D;QAC9D,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC3C,oCAAoC;IACxC,CAAC;IAED,YAAY;QACR,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,gBAAgB;QACZ,+EAA+E;QAC/E,wEAAwE;QACxE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1G,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO,SAAS,CAAC,CAAC,2BAA2B;QACjD,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACnC,CAAC;CACJ;AArDD,8BAqDC"}
+{"version":3,"file":"protoEnum.js","sourceRoot":"","sources":["protoEnum.ts"],"names":[],"mappings":";;;AACA,oGAAkG;AAClG,+FAA6F;AAC7F,2EAA0E;AAE1E,MAAa,SAAS;IAIlB,YAAY,cAAmB,EAAE,SAAiB;QAC9C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,QAAgB,EAAE,SAAiB;QACnD,OAAO,IAAI,SAAS,CAAC,SAAS,CAAC,0BAA0B,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAC;IACpF,CAAC;IAEO,MAAM,CAAC,0BAA0B,CAAC,QAAgB;QACtD,IAAI,QAAQ,KAAK,kBAAkB,EAAE;YACjC,OAAO,0CAAoB,CAAC;SAC/B;QACD,IAAI,QAAQ,KAAK,iBAAiB,EAAE;YAChC,OAAO,wCAAmB,CAAC;SAC9B;QACD,IAAI,QAAQ,KAAK,OAAO,EAAE;YACtB,OAAO,qBAAU,CAAC;SACrB;QACD,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,iBAAiB;QACb,OAAO,IAAI,CAAC,cAAc,CAAC;IAC/B,CAAC;IAED,WAAW;QACP,8DAA8D;QAC9D,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC3C,oCAAoC;IACxC,CAAC;IAED,YAAY;QACR,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,gBAAgB;QACZ,+EAA+E;QAC/E,wEAAwE;QACxE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1G,IAAI,CAAC,OAAO,EAAE;YACV,OAAO,SAAS,CAAC,CAAC,2BAA2B;SAChD;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACnC,CAAC;CACJ;AArDD,8BAqDC"}

package/node/wrappers/models/utils/requestcontext.d.ts

@@ -1,13 +1,27 @@
 import * as grpc from '@grpc/grpc-js';
 declare class EnvConfig {
     private static getEnvVar;
-    static get apiKey(): string;
+    static get apiKey(): string | undefined;
     /**
      * Returns the URL for the backend GRPC service. It will default to
-     * api.fintekkers.org if the environment variable is not set. You
-     * cann set the environment variable by adding API_URL to your .env file.
+     * api.fintekkers.org:8082 if the environment variable is not set. If
+     * API_URL already includes a port (e.g. localhost:8083), it is used as-is;
+     * otherwise :8082 is appended for backward compatibility.
      */
     static get apiURL(): string;
     static get apiCredentials(): grpc.ChannelCredentials;
+    /**
+     * Returns channel credentials that inject `x-api-key: <apiKey>` into every
+     * call's metadata. Uses insecure transport for localhost, SSL otherwise.
+     */
+    /**
+     * Returns credentials and interceptors for authenticated calls.
+     * For local (insecure) channels, injects the API key via an interceptor.
+     * For remote (SSL) channels, uses combined channel + call credentials.
+     */
+    static getAuthenticatedClientOptions(apiKey: string): {
+        credentials: grpc.ChannelCredentials;
+        interceptors: grpc.Interceptor[];
+    };
 }
 export default EnvConfig;

package/node/wrappers/models/utils/requestcontext.js

@@ -38,26 +38,58 @@ class EnvConfig {
         return value;
     }
     static get apiKey() {
-        throw new Error("API keys not supported currently.");
-        // return EnvConfig.getEnvVar('API_KEY');
+        return process.env['API_KEY'];
     }
     /**
      * Returns the URL for the backend GRPC service. It will default to
-     * api.fintekkers.org if the environment variable is not set. You
-     * cann set the environment variable by adding API_URL to your .env file.
+     * api.fintekkers.org:8082 if the environment variable is not set. If
+     * API_URL already includes a port (e.g. localhost:8083), it is used as-is;
+     * otherwise :8082 is appended for backward compatibility.
      */
     static get apiURL() {
-        const url = EnvConfig.getEnvVar('API_URL', "api.fintekkers.org") + ":8082";
-        return url;
+        const base = EnvConfig.getEnvVar('API_URL', 'api.fintekkers.org');
+        return /:\d+$/.test(base) ? base : base + ':8082';
     }
     static get apiCredentials() {
-        if (this.apiURL === "localhost:8082") {
+        if (/^localhost|^127\.0\.0\.1/.test(this.apiURL)) {
             return grpc.credentials.createInsecure();
         }
         else {
             return grpc.credentials.createSsl();
         }
     }
+    /**
+     * Returns channel credentials that inject `x-api-key: <apiKey>` into every
+     * call's metadata. Uses insecure transport for localhost, SSL otherwise.
+     */
+    /**
+     * Returns credentials and interceptors for authenticated calls.
+     * For local (insecure) channels, injects the API key via an interceptor.
+     * For remote (SSL) channels, uses combined channel + call credentials.
+     */
+    static getAuthenticatedClientOptions(apiKey) {
+        const isLocal = /^localhost|^127\.0\.0\.1/.test(this.apiURL);
+        if (isLocal) {
+            const interceptor = (_options, nextCall) => {
+                return new grpc.InterceptingCall(nextCall(_options), {
+                    start(metadata, listener, next) {
+                        metadata.add('x-api-key', apiKey);
+                        next(metadata, listener);
+                    }
+                });
+            };
+            return { credentials: grpc.credentials.createInsecure(), interceptors: [interceptor] };
+        }
+        const callCreds = grpc.credentials.createFromMetadataGenerator((_params, callback) => {
+            const metadata = new grpc.Metadata();
+            metadata.add('x-api-key', apiKey);
+            callback(null, metadata);
+        });
+        return {
+            credentials: grpc.credentials.combineChannelCredentials(grpc.credentials.createSsl(), callCreds),
+            interceptors: []
+        };
+    }
 }
 exports.default = EnvConfig;
 //# sourceMappingURL=requestcontext.js.map

package/node/wrappers/models/utils/requestcontext.js.map

@@ -1 +1 @@
-{"version":3,"file":"requestcontext.js","sourceRoot":"","sources":["requestcontext.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+CAAiC;AACjC,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,oDAAsC;AAEtC,MAAM,SAAS;IACL,MAAM,CAAC,SAAS,CAAC,GAAW,EAAE,YAAqB;QACzD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,cAAc,CAAC,CAAC;YAC7D,CAAC;YACD,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,MAAM;QACf,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;QACpD,yCAAyC;IAC3C,CAAC;IAED;;;;OAIG;IACH,MAAM,KAAK,MAAM;QACf,MAAM,GAAG,GAAW,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,oBAAoB,CAAC,GAAG,OAAO,CAAC;QACnF,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,KAAK,cAAc;QACvB,IAAI,IAAI,CAAC,MAAM,KAAK,gBAAgB,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;QAC3C,CAAC;aACI,CAAC;YACJ,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;QACtC,CAAC;IACH,CAAC;CAEF;AAED,kBAAe,SAAS,CAAC"}
+{"version":3,"file":"requestcontext.js","sourceRoot":"","sources":["requestcontext.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+CAAiC;AACjC,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,oDAAsC;AAEtC,MAAM,SAAS;IACL,MAAM,CAAC,SAAS,CAAC,GAAW,EAAE,YAAqB;QACzD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,EAAE;YACvB,IAAI,YAAY,KAAK,SAAS,EAAE;gBAC9B,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,cAAc,CAAC,CAAC;aAC5D;YACD,OAAO,YAAY,CAAC;SACrB;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,MAAM;QACf,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;IAED;;;;;OAKG;IACH,MAAM,KAAK,MAAM;QACf,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;QAClE,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,OAAO,CAAC;IACpD,CAAC;IAED,MAAM,KAAK,cAAc;QACvB,IAAI,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;YAChD,OAAO,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;SAC1C;aACI;YACH,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;SACrC;IACH,CAAC;IAED;;;OAGG;IACH;;;;OAIG;IACH,MAAM,CAAC,6BAA6B,CAAC,MAAc;QAIjD,MAAM,OAAO,GAAG,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,OAAO,EAAE;YACX,MAAM,WAAW,GAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE;gBAC3D,OAAO,IAAI,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;oBACnD,KAAK,CAAC,QAAuB,EAAE,QAAuB,EAAE,IAAc;wBACpE,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;wBAClC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;oBAC3B,CAAC;iBACF,CAAC,CAAC;YACL,CAAC,CAAC;YACF,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,EAAE,YAAY,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC;SACxF;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,2BAA2B,CAC5D,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;YACpB,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACrC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAClC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC3B,CAAC,CACF,CAAC;QACF,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,yBAAyB,CACrD,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,EAC5B,SAAS,CACV;YACD,YAAY,EAAE,EAAE;SACjB,CAAC;IACJ,CAAC;CACF;AAED,kBAAe,SAAS,CAAC"}

package/node/wrappers/models/utils/requestcontext.test.d.ts

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

package/node/wrappers/models/utils/requestcontext.test.js

@@ -0,0 +1,108 @@
+"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 requestcontext_1 = __importDefault(require("./requestcontext"));
+const grpc = __importStar(require("@grpc/grpc-js"));
+/**
+ * Unit tests for Issue #114: EnvConfig changes.
+ */
+const env = process.env;
+function setEnv(key, value) {
+    if (value === undefined) {
+        Reflect.deleteProperty(process.env, key);
+    }
+    else {
+        env[key] = value;
+    }
+}
+describe('EnvConfig.apiURL', () => {
+    const original = env['API_URL'];
+    afterEach(() => setEnv('API_URL', original));
+    test('appends :8082 when API_URL has no port', () => {
+        setEnv('API_URL', 'myhost.example.com');
+        expect(requestcontext_1.default.apiURL).toBe('myhost.example.com:8082');
+    });
+    test('uses API_URL as-is when it already has a port', () => {
+        setEnv('API_URL', 'localhost:8083');
+        expect(requestcontext_1.default.apiURL).toBe('localhost:8083');
+    });
+    test('defaults to api.fintekkers.org:8082 when unset', () => {
+        setEnv('API_URL', undefined);
+        expect(requestcontext_1.default.apiURL).toBe('api.fintekkers.org:8082');
+    });
+});
+describe('EnvConfig.apiKey', () => {
+    const original = env['API_KEY'];
+    afterEach(() => setEnv('API_KEY', original));
+    test('returns undefined when API_KEY is not set', () => {
+        setEnv('API_KEY', undefined);
+        expect(requestcontext_1.default.apiKey).toBeUndefined();
+    });
+    test('returns the API_KEY value when set', () => {
+        setEnv('API_KEY', 'my-secret-key');
+        expect(requestcontext_1.default.apiKey).toBe('my-secret-key');
+    });
+});
+describe("EnvConfig.getAuthenticatedClientOptions", () => {
+    test('returns a ChannelCredentials object', () => {
+        const creds = requestcontext_1.default.getAuthenticatedClientOptions('test-api-key').credentials;
+        expect(creds).toBeTruthy();
+        expect(creds).toBeInstanceOf(grpc.ChannelCredentials);
+    });
+    test('metadata generator injects x-api-key header', () => __awaiter(void 0, void 0, void 0, function* () {
+        var _a;
+        const creds = requestcontext_1.default.getAuthenticatedClientOptions('my-test-key').credentials;
+        // Extract call credentials from combined credentials (internal API)
+        const combined = creds;
+        const callCreds = ((_a = combined['_callCredentials']) !== null && _a !== void 0 ? _a : combined['callCredentials']);
+        if (!callCreds || typeof callCreds['generateMetadata'] !== 'function') {
+            // Internal structure not accessible or not a CallCredentials — just verify object is returned
+            expect(creds).toBeTruthy();
+            return;
+        }
+        const metadata = yield callCreds.generateMetadata({ service_url: 'localhost' });
+        const values = metadata.get('x-api-key');
+        if (values.length === 0) {
+            // grpc-js internal structure doesn't expose our metadata generator directly in this version
+            expect(creds).toBeTruthy();
+            return;
+        }
+        expect(values).toHaveLength(1);
+        expect(values[0]).toBe('my-test-key');
+    }));
+});
+//# sourceMappingURL=requestcontext.test.js.map

package/node/wrappers/models/utils/requestcontext.test.js.map

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

package/node/wrappers/models/utils/requestcontext.test.ts

@@ -0,0 +1,85 @@
+import EnvConfig from './requestcontext';
+import * as grpc from '@grpc/grpc-js';
+
+/**
+ * Unit tests for Issue #114: EnvConfig changes.
+ */
+
+const env = process.env as Record<string, string | undefined>;
+
+function setEnv(key: string, value: string | undefined): void {
+  if (value === undefined) {
+    Reflect.deleteProperty(process.env, key);
+  } else {
+    env[key] = value;
+  }
+}
+
+describe('EnvConfig.apiURL', () => {
+  const original = env['API_URL'];
+  afterEach(() => setEnv('API_URL', original));
+
+  test('appends :8082 when API_URL has no port', () => {
+    setEnv('API_URL', 'myhost.example.com');
+    expect(EnvConfig.apiURL).toBe('myhost.example.com:8082');
+  });
+
+  test('uses API_URL as-is when it already has a port', () => {
+    setEnv('API_URL', 'localhost:8083');
+    expect(EnvConfig.apiURL).toBe('localhost:8083');
+  });
+
+  test('defaults to api.fintekkers.org:8082 when unset', () => {
+    setEnv('API_URL', undefined);
+    expect(EnvConfig.apiURL).toBe('api.fintekkers.org:8082');
+  });
+});
+
+describe('EnvConfig.apiKey', () => {
+  const original = env['API_KEY'];
+  afterEach(() => setEnv('API_KEY', original));
+
+  test('returns undefined when API_KEY is not set', () => {
+    setEnv('API_KEY', undefined);
+    expect(EnvConfig.apiKey).toBeUndefined();
+  });
+
+  test('returns the API_KEY value when set', () => {
+    setEnv('API_KEY', 'my-secret-key');
+    expect(EnvConfig.apiKey).toBe('my-secret-key');
+  });
+});
+
+describe("EnvConfig.getAuthenticatedClientOptions", () => {
+  test('returns a ChannelCredentials object', () => {
+    const creds = EnvConfig.getAuthenticatedClientOptions('test-api-key').credentials;
+    expect(creds).toBeTruthy();
+    expect(creds).toBeInstanceOf(grpc.ChannelCredentials);
+  });
+
+  test('metadata generator injects x-api-key header', async () => {
+    const creds = EnvConfig.getAuthenticatedClientOptions('my-test-key').credentials;
+
+    // Extract call credentials from combined credentials (internal API)
+    const combined = creds as unknown as Record<string, unknown>;
+    const callCreds = (combined['_callCredentials'] ?? combined['callCredentials']) as grpc.CallCredentials | undefined;
+
+    if (!callCreds || typeof (callCreds as unknown as Record<string, unknown>)['generateMetadata'] !== 'function') {
+      // Internal structure not accessible or not a CallCredentials — just verify object is returned
+      expect(creds).toBeTruthy();
+      return;
+    }
+
+    const metadata = await callCreds.generateMetadata({ service_url: 'localhost' });
+    const values = metadata.get('x-api-key');
+
+    if (values.length === 0) {
+      // grpc-js internal structure doesn't expose our metadata generator directly in this version
+      expect(creds).toBeTruthy();
+      return;
+    }
+
+    expect(values).toHaveLength(1);
+    expect(values[0]).toBe('my-test-key');
+  });
+});

package/node/wrappers/models/utils/requestcontext.ts

@@ -15,23 +15,23 @@ class EnvConfig {
     return value;
   }
 
-  static get apiKey(): string {
-    throw new Error("API keys not supported currently.")
-    // return EnvConfig.getEnvVar('API_KEY');
+  static get apiKey(): string | undefined {
+    return process.env['API_KEY'];
   }
 
   /**
-   * Returns the URL for the backend GRPC service. It will default to 
-   * api.fintekkers.org if the environment variable is not set. You 
-   * cann set the environment variable by adding API_URL to your .env file.
+   * Returns the URL for the backend GRPC service. It will default to
+   * api.fintekkers.org:8082 if the environment variable is not set. If
+   * API_URL already includes a port (e.g. localhost:8083), it is used as-is;
+   * otherwise :8082 is appended for backward compatibility.
    */
   static get apiURL(): string {
-    const url: string = EnvConfig.getEnvVar('API_URL', "api.fintekkers.org") + ":8082";
-    return url;
+    const base = EnvConfig.getEnvVar('API_URL', 'api.fintekkers.org');
+    return /:\d+$/.test(base) ? base : base + ':8082';
   }
 
   static get apiCredentials(): grpc.ChannelCredentials {
-    if (this.apiURL === "localhost:8082") {
+    if (/^localhost|^127\.0\.0\.1/.test(this.apiURL)) {
       return grpc.credentials.createInsecure();
     }
     else {
@@ -39,6 +39,46 @@ class EnvConfig {
     }
   }
 
+  /**
+   * Returns channel credentials that inject `x-api-key: <apiKey>` into every
+   * call's metadata. Uses insecure transport for localhost, SSL otherwise.
+   */
+  /**
+   * Returns credentials and interceptors for authenticated calls.
+   * For local (insecure) channels, injects the API key via an interceptor.
+   * For remote (SSL) channels, uses combined channel + call credentials.
+   */
+  static getAuthenticatedClientOptions(apiKey: string): {
+    credentials: grpc.ChannelCredentials;
+    interceptors: grpc.Interceptor[];
+  } {
+    const isLocal = /^localhost|^127\.0\.0\.1/.test(this.apiURL);
+    if (isLocal) {
+      const interceptor: grpc.Interceptor = (_options, nextCall) => {
+        return new grpc.InterceptingCall(nextCall(_options), {
+          start(metadata: grpc.Metadata, listener: grpc.Listener, next: Function) {
+            metadata.add('x-api-key', apiKey);
+            next(metadata, listener);
+          }
+        });
+      };
+      return { credentials: grpc.credentials.createInsecure(), interceptors: [interceptor] };
+    }
+    const callCreds = grpc.credentials.createFromMetadataGenerator(
+      (_params, callback) => {
+        const metadata = new grpc.Metadata();
+        metadata.add('x-api-key', apiKey);
+        callback(null, metadata);
+      }
+    );
+    return {
+      credentials: grpc.credentials.combineChannelCredentials(
+        grpc.credentials.createSsl(),
+        callCreds
+      ),
+      interceptors: []
+    };
+  }
 }
 
 export default EnvConfig;

package/node/wrappers/models/utils/serialization.d.ts

@@ -3,6 +3,7 @@ import { DecimalValueProto } from "../../../fintekkers/models/util/decimal_value
 import { LocalDateProto } from "../../../fintekkers/models/util/local_date_pb";
 import { LocalTimestampProto } from "../../../fintekkers/models/util/local_timestamp_pb";
 import { UUIDProto } from "../../../fintekkers/models/util/uuid_pb";
+import { StrategyAllocationProto } from "../../../fintekkers/models/strategy/strategy_allocation_pb";
 import { ZonedDateTime } from "./datetime";
 import { ProtoEnum } from "./protoEnum";
 import { UUID } from "./uuid";
@@ -10,5 +11,5 @@ import { StringValue } from 'google-protobuf/google/protobuf/wrappers_pb';
 import { Identifier } from "../security/identifier";
 export declare class ProtoSerializationUtil {
     static serialize(obj: any): UUIDProto | LocalDateProto | LocalTimestampProto | DecimalValueProto | StringValue | IdentifierProto;
-    static deserialize(obj: any): UUID | Date | ZonedDateTime | Identifier | string | number | ProtoEnum;
+    static deserialize(obj: any): UUID | Date | ZonedDateTime | Identifier | string | number | ProtoEnum | StrategyAllocationProto;
 }